文档

CC Switch

为 Claude Code 和 Codex 配置 TokenPlan 供应商、模型映射与凭证。

本文介绍如何在 CC Switch 中为 Claude Code 和 Codex 配置有道 TokenPlan。CC Switch 是用于管理和切换 AI 编程工具 API 供应商的桌面应用，还支持 Claude Desktop、Gemini CLI、OpenCode、OpenClaw、 Hermes Agent 等。不同工具使用的协议和端点不同，请按对应小节填写。

准备工作

准备 Windows 10 及以上或 macOS 12 (Monterey) 及以上的设备。
已开通有道 TokenPlan 并创建 API Key。还没有 Key？请先前往控制台创建 API Key 。

安装 CC Switch

Windows

从 GitHub Releases 下载以下任一版本，要求 Windows 10 及以上：

CC-Switch-v{版本号}-Windows.msi：安装包
CC-Switch-v{版本号}-Windows-Portable.zip：绿色版

macOS

通过 Homebrew 安装，或从 GitHub Releases 下载 DMG。要求 macOS 12 (Monterey) 及以上。

brew install --cask cc-switch

添加 TokenPlan 供应商

1
打开 CC Switch，在应用列表中选择目标应用，如 Codex 或 Claude Code。
在顶部应用切换器中选择要配置的工具
2
点击右上角 + 按钮，打开添加供应商面板。
点击右上角的 + 按钮
3
在「预设」下拉框中选择「自定义配置」。
选择「自定义配置」
4
填写名称，例如 Youdao Zhiyun TokenPlan。
5
按下方对应小节填写配置，并将 YOUR_API_KEY 替换为有道 TokenPlan API Key。
还没有 Key？请先前往控制台创建 API Key 。
6
点击「添加」。
填写供应商名称和 API Key 后点击「添加」

Auto 模式可将模型配置为 auto，其他模型根据配置选择，例如 deepseek-flash。各应用之间相互独立，只配置实际要使用的应用即可。

Claude Code

Claude Code 走 Anthropic Messages 协议，表单只需填写 API Key 和请求地址。

配置项	填写内容
API Key	有道 TokenPlan API Key
请求地址	`https://openapi.youdao.com/llmgateway/anthropic`
官网链接	可选，留空

「高级选项」全部保持默认：

API 格式：Anthropic Messages（原生）。网关本身提供原生 Anthropic 端点，不需要选择 OpenAI 格式，也不需要开启代理转换。
完整 URL：保持关闭。CC Switch 会自动拼接 /v1/messages。
认证字段：ANTHROPIC_AUTH_TOKEN（默认）。

Claude Code 的 API 格式与认证字段高级选项 — Claude Code 高级选项

模型映射

「默认兜底模型」建议填 auto。使用第三方端点时如果留空，未明确落到 Sonnet / Opus / Fable / Haiku 四档的请求（含 Haiku 的后台任务）会把原始 Claude 模型名透传给上游，网关可能无法识别。下面四个档位是可选项，只填兜底模型即可全部走 Auto 路由。若想在 /model 菜单中手动切换具体模型，再按需填写。

模型角色	显示名称	实际请求模型
Sonnet	DeepSeek Flash	`deepseek-flash`
Opus	DeepSeek Flash	`deepseek-flash`
Fable	DeepSeek Flash	`deepseek-flash`
Haiku	DeepSeek Flash	`deepseek-flash`

「显示名称」只影响 /model 菜单中的文字，「实际请求模型」才是发给网关的模型名。右侧 1M 选项用于向 Claude Code 声明该模型支持 1M 上下文，仅在网关确认支持时勾选，否则请求会被拒绝。

自定义 User-Agent 和 本地代理请求覆盖 仅在开启本地路由或代理接管后生效，走原生 Anthropic 端点时无需填写。

Claude Code 的模型映射与默认兜底模型 — Claude Code 模型映射

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openapi.youdao.com/llmgateway/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "auto"
  }
}

Codex

Codex 走 Responses 协议。网关原生提供 Responses 端点，可以直连，不需要开启本地路由。

配置项	填写内容
API Key	有道 TokenPlan API Key
请求地址	`https://openapi.youdao.com/llmgateway/api/v1`

「高级选项」：

上游格式：选择 Responses（原生）。选择 Chat 会额外要求开启路由接管做协议转换，这里不需要。
自定义 User-Agent、本地代理请求覆盖：仅在开启本地路由接管后生效，直连时留空。
模型映射：可选。填写后 Codex 的 /model 命令会列出这些模型名。「获取模型列表」按钮不可用，因为网关没有 /v1/models 接口，请点击「添加模型」手动填写。

模型 ID	显示名称	上下文窗口
`auto`	auto	留空
`deepseek-flash`	DeepSeek Flash	留空

改完模型映射后需要重启 Codex，模型列表才会刷新。

CC Switch 自动生成的配置分为两个文件。

auth.json

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

config.toml

model_provider = "youdao"
model = "auto"

[model_providers.youdao]
name = "youdao"
base_url = "https://openapi.youdao.com/llmgateway/api/v1"
wire_api = "responses"

启用配置

在主界面选中该供应商并点击「启用」，或直接在系统托盘菜单点击供应商名称。Claude Code 无需重启即可生效；如果已有会话仍在使用旧配置，重开一个终端窗口。

验证配置

新开终端执行 claude 或 codex，发送一句对话确认能正常返回。

常见问题

如果返回 401，检查 API Key 是否填写正确。Claude Code 一侧注意使用 ANTHROPIC_AUTH_TOKEN，而不是 ANTHROPIC_API_KEY。

端点填错也是常见原因：Claude Code 必须使用 /llmgateway/anthropic，Codex 和 OpenCode 使用 /llmgateway/api/v1，两者不能混用。

切回官方登录时，添加对应的官方预设并启用，重启工具后按其登录流程操作。