RouteMux Docs
IntegrationsDev tool

Cline

把 Cline 配到 RouteMux —— 选哪种供应商类型取决于模型属于哪个家族。

Cline 有两条路能接到 RouteMux,该走哪条取决于模型 —— 因为 RouteMux 只在一个模型 真正支持的协议上开放它。

该选哪种供应商类型

你要用的模型Cline 供应商类型Base URL
anthropic/claude-*Anthropic + 勾选 Use custom base URLhttps://api.routemux.com —— 不带 /v1
openai/*deepseek/*minimax/minimax-m*google/gemini-*OpenAI Compatiblehttps://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 模型用)

  1. 齿轮图标 → API ProviderAnthropic
  2. Anthropic API Key → 填你的 RouteMux key(sk-...
  3. 勾选 Use custom base URL,填 https://api.routemux.com
  4. 从下拉框选模型

这里的 base URL 是裸 origin:Anthropic 客户端会自己追加 /v1/messages。 你再自己加 /v1 会得到 /v1/v1/messages —— 我们确实会把它路由到正确的地方, 但那不是这个字段期待的值。

Cline 的 Anthropic 模型下拉框是一份 Anthropic 官方名字的固定清单。这些方言我们都能解析: 横线与点号可以互换(claude-sonnet-4-6claude-sonnet-4.6 等价)、裸名与带 anthropic/ 前缀的等价、结尾的 -YYYYMMDD 日期快照会被忽略。不宽容的是: 我们没有上架的 Claude 版本仍然会失败。以 GET /v1/models 为准。

OpenAI Compatible 供应商(给其余模型用)

字段
API ProviderOpenAI Compatible
Base URLhttps://api.routemux.com/v1
API Key你的 RouteMux key(sk-...
Model IDGET /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 供应商 —— 见上。
立刻 401key 没保存,或复制时带了首尾空格。
400 AUTH_AMBIGUOUS_API_KEY两个 header 字段里发了两个不同的 key 值。把没在用的那个清掉。
任务中途出现 422 BILLING_INSUFFICIENT_CREDITS运行过程中余额耗尽。充值即可;已完成的步骤已计费,失败的那步没有。
模型被拒这把 key 没开通 —— 查 GET /v1/models
长时间无输出后任务直接断掉180 秒空闲看门狗。重试一次;同一个提示反复如此,说明上游是卡住而不是在思考。

On this page