VS Code 中使用 Gemini

在 VS Code 中使用 Gemini，本站推荐 Cline + Passion8：插件管理项目文件和工具调用，Passion8 提供模型请求。准备本站 API Key 和控制台开放的 Gemini 模型 ID 即可。

#1. 安装并打开 Cline

在 VS Code 扩展市场搜索 Cline，核对扩展 ID 为 saoudrizwan.claude-dev，安装后打开 Cline 侧栏。也可以从 Cline 官方扩展页 安装。

打开你实际要修改的项目文件夹。首次运行先保留文件写入、命令执行的人工审批，便于审查修改。

#2. 填写三个接入项

打开 Cline 设置，API Provider 选择 OpenAI Compatible，填写：

保存设置，返回会话。这里用的是 OpenAI 兼容协议，因此地址包含 /v1；Gemini CLI 的原生协议地址是 https://passion8.cc，两者不能照搬。

如果开启 Plan / Act 分别配置模型，在两个模式中都检查供应商、地址、Key 和模型。只配置 Plan 后切换到 Act，可能仍然使用旧供应商。

#3. 确认请求走本站

新建任务，输入：

只回复 OK，不读取文件，不运行命令。

收到回答后，在 Passion8 控制台 找到同时间的用量记录，核对模型。下一步再输入：“只读检查这个项目，说明启动命令和测试入口，先不要修改文件。”

模型能回答不代表已支持完整编程流程。继续检查它是否能按批准读取一个文件、提出修改并展示 diff。工具调用报错时，保留错误信息并核对账号渠道能力。

#4. 配置模型能力

若当前 Cline 版本允许编辑自定义模型能力，按所选模型和本站渠道填写上下文窗口、最大输出和图像支持。不要把其他 Gemini 型号的窗口数值复制过来，也不要只凭型号名称打开图片支持。

先用默认工具格式完成一次文件读取和修改。高级工具格式、图片输入、缓存计费需要单独确认；API 模型列表只说明可选模型，不能证明所有能力都可用。长任务尽量围绕一个目标，完成后另开会话。

#官方 Gemini 插件和 CLI 现在是什么状态

截至 2026-10-11，Google 官方说明个人免费层、Google AI Pro / Ultra 的 Gemini Code Assist IDE 扩展与 Gemini CLI 登录服务已于 2026-06-18 停止，并迁移至 Antigravity。付费 Gemini API Key 路径仍在迁移公告中保留，CLI 的配置参考也仍列出自定义 GOOGLE_GEMINI_BASE_URL。

这意味着“Google 登录入口变更”与“Gemini 模型不能再通过 API 使用”是两件事。本站接入继续使用地址、Key、模型；不把 Code Assist 或 Antigravity 的账户登录作为安装步骤。

Gemini CLI Companion 是编辑器上下文与 diff 集成，需要 Gemini CLI 配合；它不是独立的 Code Assist，也不是直接填写三项信息即可使用的聊天插件。已有 API-key CLI 用户可按官方 IDE integration 使用 /ide install 和 /ide enable，鉴权继续由 CLI 配置负责。

#排错

更多跨厂商配置见 Cline 多模型配置，项目实践见 Gemini 编程工作流；需要把模型接入自己的应用时，参考 Gemini API 与 SDK。

#核对来源

核对日期：2026-10-11。

• Gemini Code Assist 当前状态
• Gemini CLI 迁移公告
• Gemini CLI 自定义 Base URL
• Cline OpenAI Compatible