Path 02

CodePlan 兼容 Claude Code

客户端仍然是 Claude Code，但网关把 Anthropic 兼容请求继续映射到后端 Coding Plan / 多模型路由层。

Anthropic compatible

routing by gateway

适合 Coding Plan 上游

这条链路和直连的区别

对客户端来说，配置几乎不变。真正变化的是后端：请求进入 convertmodel 后，不是直接固定到单一模型，而是由网关根据路由策略把 Sonnet / Opus / Haiku 这类 Anthropic alias 分配给后端上游。

重点：模型映射发生在网关，不发生在 Claude Code 客户端。客户端只需要发出 Anthropic 风格请求。

客户端最小配置

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://convertmodel.net",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

如果 convertmodel 当前公开了不同 alias 的路由策略，你只需要在客户端切换 alias，而不需要在本地手工切上游模型名。

你真正需要关注的不是“模型品牌”，而是这三件事

Alias 是否正确

先确认客户端发出的到底是 Sonnet、Opus 还是 Haiku 档位。

Key 是否属于正确分组

Anthropic 兼容链路必须使用允许 /v1/messages 调度的 key。

账号容量是否可用

很多 503 来自账号不可用或当前过滤条件无匹配，而不是客户端本身。

映射是否更新

如果站点当前公告调整了 alias 对应关系，以站点当前公开说明为准。

最常见的错误

503 No available accounts 最常见。优先查 alias、key 分组、账号过滤条件和上游容量，而不是先怀疑客户端命令。

使用记录没有落库 请求可能在调度前就失败，所以业务层没有生成完整使用记录。

模型行为不符合预期 先看客户端请求模型名，再核对当前网关映射策略是否已经变化。