Cline
- 官方主页：cline.bot
- 安装文档：docs.cline.bot/getting-started/installing-cline
- 网关配置：Anthropic provider / OpenAI Compatible provider
- 协议类型：OpenAI 兼容（推荐，直接填写国内模型 ID）/ Anthropic Messages（仅在网关明确支持时使用）
安装
Cline 是 IDE 扩展，官方支持 VS Code、Cursor、Windsurf、VSCodium、Antigravity 以及 JetBrains 系列 IDE。其余写法以官方安装文档为准。
VS Code / Cursor / Windsurf / VSCodium / Antigravity
按 Ctrl/Cmd + Shift + X 打开扩展面板，搜索 Cline 并安装。也可直接按 Marketplace ID 安装（Cline 早期名为 Claude Dev，扩展 ID 仍为 saoudrizwan.claude-dev）：
code --install-extension saoudrizwan.claude-devJetBrains（IDEA / PyCharm / GoLand 等）
进入 Settings → Plugins → Marketplace，搜索 Cline 安装后重启 IDE；也可从 JetBrains Marketplace 页面安装。
安装完成后，VS Code 左侧活动栏会出现 Cline 图标；在扩展面板中可查看当前已安装的 Cline 版本号，遇到问题时建议先更新到最新版。
对接 TokenBay
对接机制
Cline 不通过环境变量配置网关，而是在扩展的设置面板里选择 provider 并填写端点与凭证。国内版推荐优先使用 OpenAI Compatible provider：
- OpenAI Compatible provider（推荐）：可直接填写
qwen3.7-max、deepseek-v4-pro、qwen3.5-flash等国内模型 ID。它走标准的/chat/completions，Base URL 需带/v1。 - Anthropic provider（兼容性选项）：仅在当前网关和目标模型明确支持 Anthropic Messages 协议时使用。勾选 Use custom base URL 后，Cline 会在 base URL 后自动追加
/v1/messages，因此 Custom Base URL 只填裸网关地址，不要带路径。
Base URL 不要带错路径：
- Anthropic provider 的 Custom Base URL 填
https://api.tokenbay.me（裸地址，无/v1、无结尾斜杠）。- OpenAI Compatible provider 的 Base URL 填
https://api.tokenbay.me/v1（带/v1）。
1. 获取 API Key
登录 TokenBay 控制台 → API 密钥 → 创建密钥。复制以 sk- 开头的完整字符串。明文仅显示一次，离开页面后无法再查看。
2. 配置 OpenAI Compatible Provider（推荐）
点击左侧 Cline 图标 → 设置图标（⚙️），按下表填写：
| 字段 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.tokenbay.me/v1 |
| API Key | 你的 TokenBay API Key（sk-...） |
| Model ID | qwen3.7-max（或其它可用模型） |
保存后立即生效，无需重启。
3. 兼容性选项：配置 Anthropic Provider
只有在当前网关和目标模型明确支持 Anthropic Messages 协议时，再新增 Anthropic provider：
| 字段 | 值 |
|---|---|
| API Provider | Anthropic |
| Anthropic API Key | 你的 TokenBay API Key（sk-...） |
| Use custom base URL | 勾选 |
| Custom Base URL | https://api.tokenbay.me |
| Model | 使用控制台确认支持 Anthropic 协议的模型 ID |
填好后点 Verify 校验连通性，通过即可使用。
4. 推荐模型
| 用途 | 模型 ID | Provider |
|---|---|---|
| 主力编码 | qwen3.7-max | OpenAI Compatible |
| 复杂重构 / 长上下文 | deepseek-v4-pro | OpenAI Compatible |
| 长文本 / 资料处理 | kimi-k2.6 | OpenAI Compatible |
| 轻量 / 快速响应 | qwen3.5-flash | OpenAI Compatible |
| 通用旗舰 | glm-5.2 | OpenAI Compatible |
模型 ID 直接透传上游，无前缀。完整可用列表见 模型清单。
模型名格式：TokenBay 的模型名称中版本号仅接受小数点形式（如
qwen3.7-max、glm-5.2），不要写成连字符形式（如qwen3-7-max）。上表为示例，准确的 Model ID 与端点以 控制台 Models 页面（或 模型清单）为准；接入前请核对，并确认 API Key 所属分组已授权该模型。
5. 进阶配置（长任务 / 代理）
- 自动批准上限：Cline 的工具调用默认有自动批准轮数上限。复杂任务可在设置面板里调高 Max Requests，减少频繁人工确认。
- 网络与超时：VS Code 版 Cline 复用 VS Code 自身的网络/代理设置。处于公司网络或防火墙后时，在 VS Code 设置中配置
http.proxy（参考官方网络与代理文档）。长上下文任务耗时较长，若出现请求中断，先排查代理与防火墙是否拦截api.tokenbay.me。 - 多套配置切换：Cline 支持保存多个 API 配置（API Configuration Profiles），可把
qwen3.7-max、deepseek-v4-pro、qwen3.5-flash分别存为不同配置，按任务复杂度切换。