通过 OpenAI Compatible provider 把 Cline 接到 Router One

安装 Cline，并创建专用 Key

扩展可从 VS Code Marketplace（扩展 ID saoudrizwan.claude-dev）安装，Windsurf 和 VSCodium 从 Open VSX 安装，JetBrains IDE 从 JetBrains Marketplace 安装；2026-10-09 时 VS Code Marketplace 上的版本是 4.1.23（2026 年 10 月 7 日发布）。CLI 是一个 npm 包，需要 Node.js 20 或更高版本（推荐 22）：npm install -g cline 即可安装，cline version 会输出已安装的版本（截至 2026-10-09，npm 上为 3.0.70）。然后为 Cline 单独创建一把 Router One Key，并设置 maxSpend 消费上限。Agent 任务每一轮模型调用都是一次请求，包括只把工具结果交回模型的那些轮次，所以一个长任务可能在你不再输入的情况下产生几十次计费请求。这个上限就是硬性止损；专用 Key 还能让你在控制台 → 日志里只筛出 Cline 的请求。

把 Cline 配置到 Router One base URL

打开 Cline 面板，点齿轮图标，在 API Provider 中选择 OpenAI Compatible。Base URL 填 https://api.router.one/v1：Cline 会去掉末尾的斜杠，并自己拼上 /chat/completions 和 /models，所以不要填完整的端点地址。把 Key 粘贴到 API Key。Model ID 是一个下拉框，Cline 会带着你的 Key 请求 GET {Base URL}/models 来填充它；Router One 只在带 Key 时才响应这个请求，所以要先保存 Key，列表才会出现。列表包含目录中的全部 ID，也包括图像生成模型，请选择聊天模型，最好选详情页标明支持工具调用的，因为 Cline 的 Agent 依靠工具调用工作。如果列表一直为空，选择 Use custom model ID…，手动填入 /models 上的精确 ID，例如 anthropic/claude-sonnet-5、openai/gpt-5.5、deepseek-v4-flash 或 grok-4.7。随后打开 Model Configuration，见下一节：

Base URL

https://api.router.one/v1

# Cline panel → gear icon → API Provider: OpenAI Compatible
Base URL:             https://api.router.one/v1
API Key:              sk-your-router-one-key
Model ID:             anthropic/claude-sonnet-5   (or Use custom model ID… + a chat ID from /models)
# Model Configuration
Context Window Size:  1000000   (the model page's window as a whole number; default 128000)
Supports Images:      only if the model page lists image input

设置 Model Configuration：上下文窗口与图像支持

对于自定义模型，Cline 只知道你填进去的信息；OpenAI Compatible 模型的默认值是 128,000 tokens 的上下文窗口，并开启图像支持。Cline 会按这个窗口安排上下文压缩，所以用 1M 窗口的模型时，它会远早于必要的时候就开始压缩对话。请按 /models 上该模型详情页的窗口填写 Context Window Size；详情页显示的是取整后的缩写（1.05M、200K），请换算成整数并往小取：anthropic/claude-sonnet-5、openai/gpt-5.5 与 deepseek-v4-flash 填 1000000，anthropic/claude-haiku-4.5 填 200000。只有详情页标明支持图像输入时才勾选 Supports Images。以 deepseek-v4-flash 为例，它只支持文本：勾选时，粘贴的截图会被发出去，网关返回 HTTP 400，错误信息为 "model 'deepseek-v4-flash' has no chat candidate that supports requested capabilities: vision"；不勾选时，Cline 4.1.19 及以后的版本会在输入框里把图片标为已忽略，而不是发送它。Max Output Tokens 和 Temperature 没有特别理由就留空；花费上限由 Key 的 maxSpend 控制。Input Price / 1M tokens 与 Output Price / 1M tokens 只用于 Cline 自己的费用估算，实际扣费以控制台 → 日志为准。接 Router One 不需要填 Custom Headers。

在 Cline CLI 里使用同一把 Key

一条命令就能配置 CLI：cline auth 加上 --provider openai-compatible、--apikey、--modelid 和 --baseurl，见下方代码块。CLI 只对 OpenAI Compatible 和 OpenAI 两种供应商接受 --baseurl，而 openai 是 openai-compatible 的别名。Cline 的配置文档把 ~/.cline/data/settings/providers.json 列为扩展、CLI 与 SDK 共用的 API Key 与供应商配置文件；CLINE_DATA_DIR 可以迁移整个目录，cline config 会显示当前生效的配置。用 cline "你的提示词" 启动一个任务。CLI 参考文档把 cline（Cline 自家的供应商）列为默认 provider ID，所以当某次运行必须走 Router One 时，请显式传 -P openai-compatible 和 -m 加目录 ID，不受上次选择的影响；-k 可以只为这一次运行替换 Key。CLI 默认自动批准工具调用（--auto-approve true），也就是说任务会不经询问就改文件、执行命令。传 --auto-approve false 可以逐步确认；无论哪种方式，都请保留 Key 上的 maxSpend 上限。

npm install -g cline            # Node.js 20+，推荐 22
cline auth --provider openai-compatible \
  --apikey sk-your-router-one-key \
  --modelid anthropic/claude-sonnet-5 \
  --baseurl https://api.router.one/v1
cline config                    # 查看当前生效的配置
cline -P openai-compatible -m anthropic/claude-sonnet-5 "Reply with OK"

给 Plan 和 Act 配不同的模型

Cline 有两种模式：Plan 模式读代码、提出方案；Act 模式改文件、执行命令。在 Cline 设置中勾选 Use different models for Plan and Act，两种模式就各自保留一个模型：切换模式时模型随之切换，Cline 会记住各自的选择。Cline 文档建议规划用推理更强的模型、实现用更快的模型，例如 Plan 用 openai/gpt-5.5、Act 用 anthropic/claude-sonnet-5，两者走同一把 Router One Key。两种模式的请求在控制台 → 日志里按各自的模型 ID 列出，按模型筛选就能看出规划和实现各花了多少。

Cline 的请求在网关侧是什么样子

每一轮模型调用都是一次 POST /v1/chat/completions，使用 Bearer 认证、流式返回，并附带 Cline 的工具定义。控制台 → 日志会记录网关发往模型的每一轮（在输出任何内容之前就失败的流式请求可能没有记录）：模型、tokens、费用和状态、总耗时，以及产生过输出的流式请求的首字延迟（TTFT）。Cline 4.1.19 及以后的版本遇到输出前的临时错误（包括限流响应）时，最多带退避重试三次，已经流式输出过内容的轮次不会重试，因此一步操作最多可能向 Router One 发出四次请求。4.1.23 起，回复没有以可识别的结束原因收尾时，还会再发一次请求让模型继续。供应商设置里的推理强度（reasoning effort）选择器默认是 none；选择某个级别后，每次请求都会带上 reasoning_effort。对 Claude 系列 ID，Router One 不会把它转换为 thinking 设置；Claude Opus 5.5 例外，会映射到 output_config.effort（none 与 minimal 记为 low）。其他模型可能忽略它，或以 400 拒绝请求，所以改完之后请到日志里看下一轮的状态。Router One 在这一个端点上提供 GPT、Claude、Gemini、Grok 和 DeepSeek 聊天模型，所以 OpenAI Compatible provider 就能覆盖所有系列。Cline 的其他供应商选项不适合这里：Anthropic provider 只能从固定的模型列表里选，填不了目录 ID；OpenAI provider 使用 Responses API 和内置模型列表，在 VS Code 设置里也没有 Base URL 字段。

Cline 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 Cline 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个客户端或应用单独建 API Key，并设置 maxSpend 消费上限。

Cline 用的是哪种 API 协议？

OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。

在请求日志里核对 Cline 的调用

先在 Cline 发出一次简单文本请求，再到控制台 → 日志按时间、模型和 request_id 找到这条记录，核对 Token、花费、总耗时和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，要么请求没到达网关（客户端配置或网络问题），要么网关在调用模型之前就拒绝了它——Key 问题的 401、余额不足或 Key 达到 maxSpend 上限的 402、Key 或账户自身限额触发的 429，或模型 ID、端点不对的 400 / 404；在输出任何内容之前就失败的流式请求也可能没有日志。看客户端收到的状态码和错误消息就能区分是哪一种；先确认这一点，再判断是不是网关或上游故障。

常见问题