一、背景与定位
核心问题：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 操作规避谷歌服务中国访问限制，无额外代理需求。