Cline

安装

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-dev

JetBrains(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- 开头的完整字符串。明文仅显示一次,离开页面后无法再查看。

控制台创建 API Key

2. 配置 Anthropic Provider(推荐)

点击左侧 Cline 图标 → 设置图标(⚙️),按下表填写:

字段
API ProviderAnthropic
Anthropic API Key你的 TokenBay API Key(sk-...
Use custom base URL勾选
Custom Base URLhttps://api.tokenbay.com
Modelclaude-sonnet-4.6

保存后立即生效,无需重启。

3. 备选:配置 OpenAI Compatible Provider

需要用 GPT / DeepSeek 等非 Claude 模型时,新增一个 provider:

字段
API ProviderOpenAI Compatible
Base URLhttps://api.tokenbay.com/v1
API Key你的 TokenBay API Key(sk-...
Model IDgpt-5.3-codex(或其它可用模型)

填好后点 Verify 校验连通性,通过即可使用。

4. 推荐模型

用途模型 IDProvider
主力编码claude-sonnet-4.6Anthropic
复杂重构 / 长上下文claude-opus-4.8Anthropic
轻量 / 快速响应claude-haiku-4.5Anthropic
GPT 编码替代gpt-5.3-codexOpenAI Compatible
GPT 通用旗舰gpt-5.5OpenAI Compatible

模型 ID 直接透传上游,无前缀。完整可用列表见 模型清单

模型名格式:TokenBay 的模型名称中版本号仅接受小数点形式(如 claude-sonnet-4.6gpt-5.4),不要写成连字符形式(claude-sonnet-4-6gpt-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”分别存为两份配置,按需切换。