Cline
- 官方主页:cline.bot
- 安装文档:docs.cline.bot/getting-started/installing-cline
- 网关配置:Anthropic provider / OpenAI Compatible provider
- 协议类型:Anthropic Messages(推荐,走 Claude)/ OpenAI 兼容(走 GPT 等其它模型)
安装
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 并填写端点与凭证。接 TokenBay 有两种 provider:
- Anthropic provider(推荐):走 TokenBay 的原生 Anthropic 端点,功能最完整(可用 prompt caching 等特性)。勾选 Use custom base URL 后,Cline 会在 base URL 后自动追加
/v1/messages,因此 Custom Base URL 只填裸网关地址,不要带路径。 - OpenAI Compatible provider(备选):用于 GPT、DeepSeek 等非 Claude 模型。它走标准的
/chat/completions,Base URL 需带/v1。
Base URL 不要带错路径:
- Anthropic provider 的 Custom Base URL 填
https://api.tokenbay.com(裸地址,无/v1、无结尾斜杠)。- OpenAI Compatible provider 的 Base URL 填
https://api.tokenbay.com/v1(带/v1)。
1. 获取 API Key
登录 TokenBay 控制台 → API 密钥 → 创建密钥。复制以 sk- 开头的完整字符串。明文仅显示一次,离开页面后无法再查看。

2. 配置 Anthropic Provider(推荐)
点击左侧 Cline 图标 → 设置图标(⚙️),按下表填写:
| 字段 | 值 |
|---|---|
| API Provider | Anthropic |
| Anthropic API Key | 你的 TokenBay API Key(sk-...) |
| Use custom base URL | 勾选 |
| Custom Base URL | https://api.tokenbay.com |
| Model | claude-sonnet-4.6 |
保存后立即生效,无需重启。
3. 备选:配置 OpenAI Compatible Provider
需要用 GPT / DeepSeek 等非 Claude 模型时,新增一个 provider:
| 字段 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.tokenbay.com/v1 |
| API Key | 你的 TokenBay API Key(sk-...) |
| Model ID | gpt-5.3-codex(或其它可用模型) |
填好后点 Verify 校验连通性,通过即可使用。
4. 推荐模型
| 用途 | 模型 ID | Provider |
|---|---|---|
| 主力编码 | claude-sonnet-4.6 | Anthropic |
| 复杂重构 / 长上下文 | claude-opus-4.8 | Anthropic |
| 轻量 / 快速响应 | claude-haiku-4.5 | Anthropic |
| GPT 编码替代 | gpt-5.3-codex | OpenAI Compatible |
| GPT 通用旗舰 | gpt-5.5 | OpenAI Compatible |
模型 ID 直接透传上游,无前缀。完整可用列表见 模型清单。
模型名格式:TokenBay 的模型名称中版本号仅接受小数点形式(如
claude-sonnet-4.6、gpt-5.4),不要写成连字符形式(claude-sonnet-4-6、gpt-5-4)。上表为示例,准确的 Model ID 与端点以 控制台 Models 页面(或 模型清单)为准;接入前请核对,并确认 API Key 所属分组已授权该模型。
5. 进阶配置(长任务 / 代理)
- 自动批准上限:Cline 的工具调用默认有自动批准轮数上限。复杂任务可在设置面板里调高 Max Requests,减少频繁人工确认。
- 网络与超时:VS Code 版 Cline 复用 VS Code 自身的网络/代理设置。处于公司网络或防火墙后时,在 VS Code 设置中配置
http.proxy(参考官方网络与代理文档)。长上下文任务耗时较长,若出现请求中断,先排查代理与防火墙是否拦截api.tokenbay.com。 - 多套配置切换:Cline 支持保存多个 API 配置(API Configuration Profiles),可把”Anthropic + claude-sonnet-4.6”和”OpenAI Compatible + gpt-5.4”分别存为两份配置,按需切换。
