无缝集成 gemini-cli 的 vscode 插件:shenma

一、背景与定位

核心问题:Google Gemini CLI 虽提供顶尖的 Gemini 2.5 Pro 模型能力,但纯命令行操作导致开发体验割裂,无法融入 IDE 工作流。

诸葛神码的突破 :作为 国内首个深度集成 Gemini CLI 的 VS Code 插件,它通过以下设计实现模型能力与开发体验的统一:

维度 原生 Gemini CLI 诸葛神码 (Shenma)
模型能力 ✅ Gemini 2.5 Pro ✅ 同源 Gemini 2.5 Pro (免费)
操作方式 ❌ 命令行手动输入 ✅ VS Code 可视化界面
上下文理解 ❌ 单文件/单指令 ✅ 智能关联 Git/文件/函数语义
开发流程融合 ❌ 需终端切换复制粘贴 ✅ 原位编码,一键生成/优化

国产首发认证:诸葛神码是国内已知首个实现对 Gemini CLI 完整集成的 VS Code 插件。

二、配置指南(3步流程)

前置条件

  1. 拥有 Google Cloud 账号并开通 Gemini API 权限。
  2. 本地已安装 gemini-cli 工具(详细安装流程如下)。

配置步骤

步骤1:安装gemini-cli

做开发不能没有 nodejs,确保 nodejs 版本在18 以上

bash 复制代码
npm install -g @google/gemini-cli

安装之后在终端输入 gemini 回车

选个默认主题

登陆失败: GOOGLE_CLOUD_PROJECT 未设置

📌

失败信息:Failed to login. Message: This account requires setting the GOOGLE_CLOUD_PROJECT env var. See goo.gle/gemini-cli-...

需要设置项目信息

解决方案:在谷歌云设置项目, 基本步骤如下

我们需要打开google cloud。在"概览"中创建最近的项目,如果找不到"概览",可以点击左上角的三个横的图标即可。

ini 复制代码
export GOOGLE_CLOUD_PROJECT=${上一步获取的项目编号}

点右上角三个点-项目设置-设置-项目编号 查看当前项目编号

访问 403 错误(API 未启用)

报错特征

插件返回 403 错误,终端提示启用 cloudaicompanion.googleapis.com

输入gemini后,页面出现403报错,😳,还要继续看报错信息,关键信息是绿色框框里的信息

修复步骤

  1. 访问 API 启用链接(替换 project= 后为你的项目编号):

我们按提示登陆console.developers.google.com/apis/api/cl...

  1. 点击 启用 按钮

页面会让我们点击启动服务,我们点击启动

启用成功后展示下面样式

接着去终端输入gemini,终于成功啦~~~

📌

注意:第二种使用API登陆不行❌

因为中国不支持访问


步骤2:安装shenma插件

API提供商选择 Gemini CLI,项目ID记得按上面👆方法获取后配置,不然会报错

模型选择gemini-2.5-pro,配置完成。

步骤3:验证身份

在终端执行 gemini auth login 完成登录(需浏览器授权)

接下来就可以在图形界面中正常使用gemini啦~~~😄


三、技术亮点与架构设计

核心技术栈

优势解析

  • 零中转安全:用户数据仅通过本地 CLI 与 Google 服务器通信,符合企业安全规范。
  • 上下文感知:插件自动捕获当前文件、Git 仓库、函数定义,生成精准 prompt。
  • 国产化适配:全程 CLI 操作规避谷歌服务中国访问限制,无额外代理需求。
相关推荐
小林学习编程3 分钟前
Springboot + vue + uni-app小程序web端全套家具商场
前端·vue.js·spring boot
柳鲲鹏4 分钟前
WINDOWS最快布署WEB服务器:apache2
服务器·前端·windows
小雷FansUnion1 小时前
深入理解MCP架构:智能服务编排、上下文管理与动态路由实战
人工智能·架构·大模型·mcp
资讯分享周1 小时前
扣子空间PPT生产力升级:AI智能生成与多模态创作新时代
人工智能·powerpoint
weixin-a153003083161 小时前
【playwright篇】教程(十七)[html元素知识]
java·前端·html
ai小鬼头2 小时前
AIStarter最新版怎么卸载AI项目?一键删除操作指南(附路径设置技巧)
前端·后端·github
一只叫煤球的猫2 小时前
普通程序员,从开发到管理岗,为什么我越升职越痛苦?
前端·后端·全栈
叶子爱分享2 小时前
计算机视觉与图像处理的关系
图像处理·人工智能·计算机视觉
鱼摆摆拜拜2 小时前
第 3 章:神经网络如何学习
人工智能·神经网络·学习
一只鹿鹿鹿2 小时前
信息化项目验收,软件工程评审和检查表单
大数据·人工智能·后端·智慧城市·软件工程