教程

CCSub 多模型路由配置指南：Claude 与 GPT 混用时的模型映射技巧

教程2026-09-20·11 分钟阅读

很多用户一开始只在 CCSub 上接一个模型，用顺手之后才开始混用：写代码时用 GPT-5.6 Sol，长文档改写时切到 Claude Fable 5，做重构讨论时又换成 Claude Opus 4.8。问题也就从这里开始——同一个账号、同一把 API Key，在不同客户端里到底该填什么模型名、填哪个地址？这篇指南只解决这一件事：多模型路由与模型映射。

先理解一件事：一把 Key，两条模型线

CCSub 的接口层同时提供 Anthropic 与 OpenAI 两套调用方式，两者共用同一把 API Key（形如 sk-你的CCSub密钥）。区别只在协议与路径：

  • OpenAI 兼容协议：Base URL 使用 https://ccsub.xyz/v1，对话请求打到 https://ccsub.xyz/v1/chat/completions，模型名用 gpt-5.6-sol、gpt-5.5、deepseek-v4-pro 这类 ID。
  • Anthropic 原生协议：Base URL 使用 https://ccsub.xyz/api，客户端会自动请求 /v1/messages，模型名用 claude-fable-5、claude-opus-4-8、claude-sonnet-5 这类 ID。
  • Codex 原生协议：Base URL 使用 https://ccsub.xyz/openai，并把 wire_api 设为 responses，Codex 会自动请求 /responses。

换句话说，协议由客户端类型决定，模型由你写的模型 ID 决定。混用的关键不是配几条线路，而是把模型名写对。

第一步：查询当前可用的真实模型 ID

不要凭记忆写模型名。CCSub 的可用模型列表以接口返回为准，先用一条命令拉取：

curl https://ccsub.xyz/v1/models \
  -H "Authorization: Bearer sk-你的CCSub密钥"

返回结果里每个条目的 id 就是你应该写进客户端的模型名。Anthropic 线常见的有 claude-fable-5、claude-opus-4-8、claude-opus-4-7、claude-sonnet-5、claude-haiku-4-5；OpenAI 线常见的有 gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.5、deepseek-v4-pro、deepseek-flash。带日期后缀的 ID（如 claude-haiku-4-5-20251001）是快照版本，需要锁定行为时可用。

实践建议：把 /v1/models 的输出存一份到本地，客户端里只从这份清单复制模型名，能省掉大半排障时间。

第二步：按客户端完成模型映射

Claude Code：走 Anthropic 原生协议

在 Claude Code 的环境配置中指定：

ANTHROPIC_BASE_URL=https://ccsub.xyz/api
ANTHROPIC_AUTH_TOKEN=sk-你的CCSub密钥

Claude Code 会自动请求 /v1/messages，你只需要把模型设成 Anthropic 线的 ID，例如 claude-opus-4-8 或 claude-sonnet-5。想同时用 GPT 系列，需要另开一个走 OpenAI 协议的终端会话，而不是改这里的模型名——把 gpt-5.6-sol 填进 Claude Code 的模型位，是新手最常见的错误。

Codex：走 Responses 协议

Codex 的配置文件里应写：

base_url = "https://ccsub.xyz/openai"
wire_api = "responses"

Codex 会自动请求 /responses，对应模型填 OpenAI 线的 ID，例如 gpt-5.6-sol、gpt-5.6-terra。这里不要手动拼 /v1/chat/completions，否则协议不匹配会直接报错。

OpenCode、Cursor、Windsurf、VS Code、CherryStudio 等

这类工具多数把 OpenAI 兼容协议作为默认选项，配置要点一致：

  1. Base URL 填 https://ccsub.xyz/v1；
  2. API Key 填 sk-你的CCSub密钥；
  3. 模型名从 /v1/models 清单中复制，例如 gpt-5.6-luna、deepseek-v4-pro；
  4. 如果工具支持自定义模型列表，可以一次性把多条 ID 都加进去，用下拉框切换。

直接用 HTTP 请求做验证

怀疑是客户端配置问题时，先用命令行确认账号和模型本身可用：

curl https://ccsub.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-你的CCSub密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"ping"}]}'

这条通了，说明 Key、余额、模型 ID 都没问题，剩下的就是客户端侧的写法。

混用时的四类典型配置误区

1. 模型名写错或用了别名

把 claude-opus-4.8（点号）、Claude Opus 4.8（显示名）、claude-3-opus（旧命名）填进配置，都会返回模型不存在的错误。显示名不是模型名，只有 /v1/models 里的 id 有效。

2. 客户端把默认模型写死

不少工具会在配置文件里写一行 model = ...，然后用快捷键静默切换。你在界面上换了模型却没生效，往往是配置文件的默认值优先。排查时先搜一遍配置文件里所有出现模型名的位置。

3. base_url 与环境变量用错协议

把 https://ccsub.xyz/api 填给 OpenAI 兼容工具，或把 https://ccsub.xyz/v1 填给 Claude Code，都会出现 404 或协议错误。记住三条对应关系：Anthropic 原生 /api、OpenAI 兼容 /v1、Codex /openai 加 wire_api = responses。

4. 以为换模型要换 Key

不需要。同一把 Key 可以调用两条模型线下的所有模型，模型切换只改请求里的 model 字段。如果某个模型报错而其他模型正常，优先怀疑模型 ID 或该模型当时的可用性，而不是 Key 的权限。

排障速查表

  • 404 / 路径不存在：base_url 与客户端协议不匹配。核对 /api、/v1、/openai 三选一。
  • 模型不存在：模型 ID 拼错或不在可用清单内。重新执行 /v1/models。
  • 401 / 鉴权失败：Key 复制时带了空格，或用了别家平台的 Key。
  • 连不上 / 超时：先检查本地网络与代理设置，再重试一次确认是否为偶发。
  • 某个模型偶发失败：切换到同系列的其他 ID 继续工作，稍后再试。

成本提醒与行动引导

多模型混用会明显拉高账单方差。以平台公示单价为例，gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna 的输入为 56、输出为 168（单位同站点计价口径），而 deepseek-v4-pro 输入 33.6、输出 134.4，deepseek-flash 输入 11.2、输出 44.8。日常补全、批量改写这类高频低难度任务，用小模型能显著压低消耗；把强模型留给复杂推理和长链路重构。充值前先估一下自己的日均调用量，避免只按单次价格判断。

下一步建议：打开 CCSub 官网，先跑一遍 /v1/models 生成你的模型清单，再按本文的三条协议对应关系，把 Claude Code、Codex 和常用 IDE 插件依次配好。遇到卡住的地方，可对照 故障排查文档 按症状定位。

读完想动手试试？3 分钟接入 CCSub。

立即注册返回博客
← 全部文章