# Gemini VS Code 配置教程：Cline 自定义 API 与 Base URL

> 在 VS Code 用 Cline 接入 Gemini：选择 OpenAI Compatible，填写 Passion8 /v1 地址、API Key 与模型，验证文件读取、修改和 Plan/Act。

URL: https://docs.passion8.cc/docs/gemini/vscode
Language: zh-CN
Publisher: Passion8
Last updated: 2026-10-11

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

## 1. 安装并打开 Cline

在 VS Code 扩展市场搜索 **Cline**，核对扩展 ID 为 `saoudrizwan.claude-dev`，安装后打开 Cline 侧栏。也可以从 [Cline 官方扩展页](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev) 安装。

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

## 2. 填写三个接入项

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

| 项目 | 值 |
| --- | --- |
| Base URL | `https://passion8.cc/v1` |
| API Key | 你的 Passion8 API Key |
| Model ID | 从控制台复制账号已开放的完整 Gemini 模型 ID |

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

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

## 3. 确认请求走本站

新建任务，输入：

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

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

模型能回答不代表已支持完整编程流程。继续检查它是否能按批准读取一个文件、提出修改并展示 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](https://geminicli.com/docs/ide-integration/) 使用 `/ide install` 和 `/ide enable`，鉴权继续由 CLI 配置负责。

## 排错

| 现象 | 检查 |
| --- | --- |
| 打开 Google 登录 | 当前装的是 Code Assist，或选择了 Google 官方 Provider；本站教程使用 Cline 的 OpenAI Compatible |
| 404 | 检查 `https://passion8.cc/v1`，不要附加 `/chat/completions` 或 Google 的 `/v1beta/openai` |
| 401 / 403 | 确认填入本站 Key、令牌未禁用、账号可访问对应模型 |
| Plan 能用，Act 不能 | 核对两个模式各自的 Provider、模型和 Key |
| 能聊天，无法读取文件或修改 | 核对工具调用能力、模型 ID 和 Cline 工具设置 |
| 请求没有本站记录 | 检查是否仍使用其他供应商配置，再新建任务验证 |

更多跨厂商配置见 [Cline 多模型配置](https://docs.passion8.cc/docs/cline)，项目实践见 [Gemini 编程工作流](https://docs.passion8.cc/docs/gemini/workflow)；需要把模型接入自己的应用时，参考 [Gemini API 与 SDK](https://docs.passion8.cc/docs/gemini/api)。

## 核对来源

核对日期：2026-10-11。

- [Gemini Code Assist 当前状态](https://developers.google.com/gemini-code-assist/docs/set-up-gemini)
- [Gemini CLI 迁移公告](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)
- [Gemini CLI 自定义 Base URL](https://geminicli.com/docs/reference/configuration/)
- [Cline OpenAI Compatible](https://docs.cline.bot/provider-config/openai-compatible)