Cline
把 Cline 配到 RouteMux —— 选哪种供应商类型取决于模型属于哪个家族。
Cline 有两条路能接到 RouteMux,该走哪条取决于模型 —— 因为 RouteMux 只在一个模型 真正支持的协议上开放它。
该选哪种供应商类型
| 你要用的模型 | Cline 供应商类型 | Base URL |
|---|---|---|
anthropic/claude-* | Anthropic + 勾选 Use custom base URL | https://api.routemux.com —— 不带 /v1 |
openai/*、deepseek/*、minimax/minimax-m*、google/gemini-* | OpenAI Compatible | https://api.routemux.com/v1 |
Claude 模型走不了 OpenAI Compatible
所有已发布的 anthropic/claude-* 模型只在 Anthropic Messages 协议上开放。
选 Cline 的 OpenAI Compatible 供应商再填一个 Claude slug,会拿到
400 MODEL_PROTOCOL_UNSUPPORTED ——
key 和 base URL 都没问题,是这个模型压根不在那个端点族上提供。
这是我们见到最多的一种误配。
Anthropic 供应商(给 Claude 模型用)
- 齿轮图标 → API Provider →
Anthropic - Anthropic API Key → 填你的 RouteMux key(
sk-...) - 勾选 Use custom base URL,填
https://api.routemux.com - 从下拉框选模型
这里的 base URL 是裸 origin:Anthropic 客户端会自己追加 /v1/messages。
你再自己加 /v1 会得到 /v1/v1/messages —— 我们确实会把它路由到正确的地方,
但那不是这个字段期待的值。
Cline 的 Anthropic 模型下拉框是一份 Anthropic 官方名字的固定清单。这些方言我们都能解析:
横线与点号可以互换(claude-sonnet-4-6 和 claude-sonnet-4.6 等价)、裸名与带
anthropic/ 前缀的等价、结尾的 -YYYYMMDD 日期快照会被忽略。不宽容的是:
我们没有上架的 Claude 版本仍然会失败。以 GET /v1/models 为准。
OpenAI Compatible 供应商(给其余模型用)
| 字段 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.routemux.com/v1 |
| API Key | 你的 RouteMux key(sk-...) |
| Model ID | GET /v1/models 返回的 slug,如 openai/gpt-5.5 |
注意 google/gemini-* 的文本模型在这里走的是 OpenAI Chat 协议,所以它们属于这一栏,
不要放进 Cline 的 Gemini 供应商。
长任务与流式
Cline 会跑多步 agent 循环、流式响应很长。有两件事要分清:
- 流式请求没有总时长上限。一个合法跑几分钟的回合是正常的。
- 但有空闲看门狗:文本档 180 秒。 上游连续 180 秒没有产出新 chunk,RouteMux 会中止 请求并记为超时。这一道是我们加的、叠在上游之上 —— 长时间沉默思考会撞到它, 长时间持续输出不会。
SSE 转发不做缓冲。
排查
| 现象 | 原因 |
|---|---|
400 MODEL_PROTOCOL_UNSUPPORTED | 在 OpenAI Compatible 供应商上用了 Claude 模型。换成 Anthropic 供应商 —— 见上。 |
立刻 401 | key 没保存,或复制时带了首尾空格。 |
400 AUTH_AMBIGUOUS_API_KEY | 两个 header 字段里发了两个不同的 key 值。把没在用的那个清掉。 |
任务中途出现 422 BILLING_INSUFFICIENT_CREDITS | 运行过程中余额耗尽。充值即可;已完成的步骤已计费,失败的那步没有。 |
| 模型被拒 | 这把 key 没开通 —— 查 GET /v1/models。 |
| 长时间无输出后任务直接断掉 | 180 秒空闲看门狗。重试一次;同一个提示反复如此,说明上游是卡住而不是在思考。 |