1. 为什么要在 Claude CoWork 3P 里接 Sub2APIClaude Desktop 官方客户端从某个版本开始内置了开发者模式和第三方推理3P入口。这意味着你不需要去找任何魔改安装包用官方客户端就能把推理请求指向自定义网关。对同时用 Claude 和 GPT 系列模型的人来说这件事的价值在于客户端交互体验不变但后端可以自由路由。Sub2API 在这里扮演的是「协议翻译 模型映射」的中间层。Claude Desktop 发出的请求里模型名是claude-opus-4-6、claude-sonnet-4-6这类 Anthropic 命名而 TaoToken 统一 Key 背后实际调用的可能是gpt-5.6-sol、gpt-5.6-terra这些模型。Sub2API 负责把请求里的模型名替换掉再把 Anthropic Messages 格式和 OpenAI 格式做双向转换最后把结果按 Claude 客户端能识别的结构返回。这套组合适合三类人一是想在 Claude 客户端里体验 GPT-5.6 Sol 内核的二是手里有多个模型渠道、想统一走一个 Key 管理的三是做 Agent 或长期编码任务需要稳定多模型路由的。下面按「前置准备 → 配置文件 → 后台映射 → 验证 → 排障」的顺序走一遍配置片段可以直接复制。2. TaoToken 前置准备统一 Key 与通道在动 Sub2API 之前先把 TaoToken 这边的接入信息拿到手。TaoToken 提供的是统一 API 通道一个 Key 可以覆盖多个模型省去为每个模型单独申请凭证的麻烦。第一步打开控制台创建 API Key。地址是https://taotoken.net/console登录后在 API Keys 页面新建一个 Key复制保存。这个 Key 就是后面 Sub2API 里要填的「上游凭证」。第二步确认你要用的模型名。TaoToken 的模型列表和文档在https://taotoken.net/doc里面会列出当前可用的模型标识。本篇场景里核心要用到的是gpt-5.6-sol另外两个映射目标gpt-5.6-terra、gpt-5.6-luna也一并确认存在。第三步记下 API 基地址。TaoToken 的 API 入口是https://taotoken.net/api注意这个地址不带任何查询参数配置时直接作为 Base URL 填入即可。提示Key 只在创建时完整显示一次建议创建后立刻存进密码管理器。如果泄露在控制台直接吊销重建不要试图「改一改继续用」。到这里前置就完成了一个 Key、一个 Base URL、三个模型名。接下来进入 Sub2API 的配置环节。3. 可复制配置config.toml 与 settings.json 骨架Sub2API 的配置分两块一块是服务本身的config.toml定义上游通道一块是给 Claude Desktop 3P 模式用的settings.json定义客户端往哪发请求。两块都要对上。先看config.toml。下面是一个最小可用骨架把api_key换成你自己的 TaoToken Key# Sub2API 主配置 [server] host 127.0.0.1 port 8080 [upstream] # TaoToken 统一通道 base_url https://taotoken.net/api api_key sk-你的TaoTokenKey # 上游按 OpenAI 兼容格式通信 protocol openai [upstream.models] # 客户端模型名 - 上游实际模型名 claude-haiku-4-5-20251001 gpt-5.6-terra claude-opus-4-6 gpt-5.6-sol claude-sonnet-4-6 gpt-5.6-luna [dispatch] # 开启 Messages 格式转换 openai_messages_dispatch true关键点有三个。base_url必须是https://taotoken.net/api不要多加斜杠或路径。protocol设为openai因为 TaoToken 走 OpenAI 兼容协议Sub2API 会自动做 Anthropic ↔ OpenAI 的转换。[upstream.models]这一段就是模型映射表左边是 Claude 客户端会请求的名字右边是 TaoToken 实际调用的模型。再看 Claude Desktop 侧的settings.json。3P 模式开启后客户端会读取这个文件里的网关配置{ inferenceProvider: custom, customGateway: { baseUrl: http://127.0.0.1:8080, apiKey: sub2api-本地生成的Key }, modelAliases: { claude-opus-4-6: claude-opus-4-6, claude-sonnet-4-6: claude-sonnet-4-6, claude-haiku-4-5-20251001: claude-haiku-4-5-20251001 } }这里的baseUrl指向本机 Sub2API 服务apiKey是 Sub2API 自己生成的本地 Key不是 TaoToken 的 Key两者别混。modelAliases保持原名即可真正的替换发生在 Sub2API 的config.toml里。注意两个文件里的模型名必须严格一致。claude-opus-4-6在config.toml映射到gpt-5.6-sol在settings.json里也要原样出现否则客户端请求的模型名对不上映射表会直接报模型不存在。4. 后台映射与 CC Switch 配置步骤配置文件写好后还要在 Sub2API 管理后台把映射关系和分组补齐否则模型列表同步和格式转换会出问题。4.1 在 Codex 账号里配置模型映射登录 Sub2API 管理后台进入账号管理找到承载 TaoToken 通道的那个账号通常归在 Codex 类型下点编辑。滚动到 Model Restriction 区域切到 Model Mapping 标签页点 Add Mapping按下面三行填客户端请求模型名上游实际模型名claude-haiku-4-5-20251001gpt-5.6-terraclaude-opus-4-6gpt-5.6-solclaude-sonnet-4-6gpt-5.6-luna第二行是核心它把 Claude Opus 4.6 绑定到 GPT-5.6 Sol。填完保存账号设置。4.2 配置 Group 同步模型列表切到 Group 标签页编辑包含上述账号的分组。往下找到Custom /v1/models Model List把刚才映射的三个claude-*模型名勾上或手动添加。这一步决定客户端拉取模型列表时能不能看到这些名字。继续往下找到OpenAI Messages Dispatch把开关打开并把对应的模型 Family 指到已定义的claude-*模型上。这一步负责 Prompt 格式转换不开的话调用时会报格式错误。4.3 CC Switch 配置如果你用 CC Switch 管理多套客户端配置在 CC Switch 里新增一个配置项指向本机 Sub2API 地址# CC Switch 配置示例 name: claude-cowork-3p base_url: http://127.0.0.1:8080 api_key: sub2api-本地生成的Key provider: custom保存后切换到这个配置Claude Desktop 启动时就会读取对应的settings.json。4.4 开启 Claude Desktop 3P 模式打开 Claude Desktop 官方客户端点顶部菜单 Help → Troubleshooting → Enable Developer mode。菜单栏会多出 Developer点它选 Configure third-party inference。Inference provider 选 Custom Gateway URLBase URL 和 API Key 填 Sub2API 的地址和本地 Key点 Apply locally重启客户端。5. 验证请求与成功结果配置完成后先别急着在客户端发消息用命令行验证 Sub2API 到 TaoToken 这一段是否通。下面这条 curl 直接打 Sub2API 的本地端口curl -s http://127.0.0.1:8080/v1/messages \ -H Content-Type: application/json \ -H x-api-key: sub2api-本地生成的Key \ -H anthropic-version: 2023-06-01 \ -d { model: claude-opus-4-6, max_tokens: 128, messages: [ {role: user, content: 用一句话说明你是什么模型} ] }如果映射和转换都正确返回的 JSON 里content字段会有模型回复model字段可能显示为上游的gpt-5.6-sol或映射后的名字取决于 Sub2API 的返回策略。看到正常文本就说明链路通了。再验证模型列表curl -s http://127.0.0.1:8080/v1/models \ -H x-api-key: sub2api-本地生成的Key返回里应该能看到claude-opus-4-6、claude-sonnet-4-6、claude-haiku-4-5-20251001三个名字。如果缺了回第 4.2 步检查 Group 的模型列表。最后回到 Claude Desktop在模型下拉菜单选 Claude Opus 4.6发一条消息。能正常收到回复就说明 Sub2API 已经把它桥接到了 GPT-5.6 Sol 内核上。6. 本篇常见报错排查配置过程中最容易踩的坑集中在下面几类按现象对号入座。报「model not found」或模型不存在九成是模型名不一致。检查config.toml的映射表、settings.json的modelAliases、后台 Model Mapping 三处的claude-*名字是否完全一致大小写和日期后缀都不能差。报格式错误或 400OpenAI Messages Dispatch没开或者模型 Family 没指对。回后台 Group 页面确认开关是开的且 Family 映射到了正确的claude-*模型。报 401 或鉴权失败两个 Key 混了。Sub2API 本地 Key 用于客户端到 Sub2APITaoToken Key 用于 Sub2API 到上游。检查config.toml里api_key是 TaoToken 的settings.json里apiKey是 Sub2API 本地的。连接被拒绝Sub2API 服务没起来或者端口不对。确认config.toml里port 8080和settings.json里baseUrl的端口一致服务进程在跑。客户端看不到模型Group 的Custom /v1/models Model List没勾全或者客户端没重启。补勾后重启 Claude Desktop。上游超时TaoToken 的base_url写错了。确认是https://taotoken.net/api没有多余路径。网络本身的问题不在本篇讨论范围检查本机到该地址的连通性即可。排查时建议按「客户端 → Sub2API → TaoToken」的顺序逐段用 curl 验证哪一段断了就集中看那一段的配置比在客户端里反复试要快得多。如果你在接入或排障过程中需要核对 Key 和通道信息可以直接到 API Keys 页面管理凭证接入细节参考接入文档想先验证模型对话效果用模型对话页面快速试一条如果是长期编码或 Agent 场景建议直接上 Coding Plan 把多模型路由固定下来。