一、背景与定位
核心问题: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步流程)
前置条件
- 拥有 Google Cloud 账号并开通 Gemini API 权限。
- 本地已安装 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报错,😳,还要继续看报错信息,关键信息是绿色框框里的信息

修复步骤:
- 访问 API 启用链接(替换 project= 后为你的项目编号):
我们按提示登陆console.developers.google.com/apis/api/cl...
- 点击 启用 按钮
页面会让我们点击启动服务,我们点击启动

启用成功后展示下面样式

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

📌
注意:第二种使用API登陆不行❌
因为中国不支持访问



步骤2:安装shenma插件

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

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

步骤3:验证身份
在终端执行 gemini auth login 完成登录(需浏览器授权)
接下来就可以在图形界面中正常使用gemini啦~~~😄

三、技术亮点与架构设计
核心技术栈

优势解析
- 零中转安全:用户数据仅通过本地 CLI 与 Google 服务器通信,符合企业安全规范。
- 上下文感知:插件自动捕获当前文件、Git 仓库、函数定义,生成精准 prompt。
- 国产化适配:全程 CLI 操作规避谷歌服务中国访问限制,无额外代理需求。