CC Switch 绑定 · Claude Code / Codex / Gemini CLI 配置

① 三个接入地址 ② 安装 CC Switch ③ 密钥与分组 ④ 一键导入 ⑤ 手动配置 ⑥ 切换与生效 ⑦ 验证与排错 ⑧ 安全提醒

一、先分清三个接入地址

三个客户端协议不同，地址写法也不同。路径填错一般表现为 404 或一直连不上，而不是「密钥无效」。

客户端	协议	填这个地址	不要写成
Claude Code	Anthropic Messages	`https://api.tutujing.com`	`https://api.tutujing.com/v1`
Codex	OpenAI Responses	`https://api.tutujing.com/v1`	`https://api.tutujing.com`
Gemini CLI	Gemini Native	`https://api.tutujing.com`	`https://api.tutujing.com/v1beta`

三个地址是同一个站点，密钥都是 sk- 开头；差别只在客户端自己拼接的路径：Claude Code 接 /v1/messages，Codex 接 /responses，Gemini CLI 接 /v1beta/...。

二、安装 CC Switch

官网：ccswitch.io；Windows / macOS / Linux 都有安装包，也可以从 GitHub Releases 下载。
建议用 v4 最新版：导入按钮走 ccswitch:// 深度链接，老版本对部分字段处理不同。
CC Switch 只改配置、不替代客户端本身。先装好 Claude Code、Codex CLI、Gemini CLI，命令行工具也可以在 CC Switch 侧栏的 Apps 页安装。
没有图形界面的服务器环境，可用社区版 CC Switch CLI，它和桌面版共用 ~/.cc-switch 数据。

三、准备密钥和分组

登录控制台，进入「API 密钥」

地址：api.tutujing.com/dashboard

新建密钥，分组选对

分组决定这把密钥能用哪些模型，必须包含你要用的模型。常见对应关系：

客户端	本站可用分组（以控制台实际可选为准）	示例模型
Claude Code	`Claude 官转满血`、`Claude 满血稳定一哥`、`Claude Max满血贵族全穿透`、`CCMax 特价（可蒸馏）`、`Claude kiro 专用`	`claude-sonnet-4-6`、`claude-sonnet-5`、`claude-opus-5`
Codex	`GPT官Key`、`GPT Pro专用`、`GPT 企业级`、`GPT不降智`、`GPT(no Pro)专用`	`gpt-5.6-sol`、`gpt-5.6-terra`、`gpt-6-astra`、`gpt-6-sol`
Gemini CLI	`Gemini 反重力`、`Gemini 满血分组`	`gemini-4-argon`、`gemini-3.8-flash`

分组和模型对不上会报 503 / model_not_found这不是扣费后返回空结果。分组名和模型名都以「模型广场」里你当前账号能看到的为准。

复制密钥

用密钥行末的「复制密钥」复制完整 sk- 串。页面关闭后只是不再明文展示，之后仍可重新复制。建议**每个客户端单独一把密钥**，日志里好区分来源，泄露也能单独禁用。

四、一键导入（推荐）

控制台的 API 密钥列表内置了 CC Switch 导入入口，不用手抄地址和密钥。

打开密钥的 CC Switch 入口

在「API 密钥」找到要用的密钥，点行末的更多操作，选「CC Switch」。

选择应用

在弹窗里选 Claude、Codex 或 Gemini。应用不同生成的地址也不同：Claude 和 Gemini 用站点根地址，Codex 自动带 /v1。

确认名称和主模型

名称保持默认或改成你能认出的；主模型从下拉框选，模型名必须和模型广场一致。Claude 还能额外指定 Haiku、Sonnet、Opus 三个映射，不填就沿用默认。

在 CC Switch 里确认

点「打开 CC Switch」，浏览器询问是否打开外部应用时选「打开」。CC Switch 会弹导入确认框，核对地址、密钥（已打码）和模型，确认「导入后切换」处于打开状态，再点「导入」。

等待生效

导入后供应商卡片出现在对应应用列表。Claude Code 直接生效；Codex 和 Gemini CLI 按下文第六节重启后生效。

链接里带着你的密钥链接是在点击时按当前密钥现场生成的，不会预置在页面源码里。不要把它复制到聊天、文档、截图或公开网页；同一个链接点两次会导入两份同名供应商。

五、手动配置

没有导入入口、或想自己控制配置时，用各应用的「自定义配置」逐项填，保存后在供应商卡片上切到它。

Claude Code

侧栏选 Claude Code → 添加供应商 → 自定义配置 → 填这段 JSON：

JSON · Claude Code

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tutujing.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

ANTHROPIC_BASE_URL 不要再加 /v1；ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_API_KEY 二选一。Claude Code 的后台小任务会用 Haiku 档模型，分组里没有对应模型时，在导入弹窗或供应商表单里补 Haiku/Sonnet/Opus 映射，避免小请求 404。

Codex

Codex 供应商编辑器分两块：一块填 API Key，一块是 config.toml。CC Switch 切到这个供应商时会把 Key 写进 config.toml 的 experimental_bearer_token，不会写 ~/.codex/auth.json（auth.json 只给 OpenAI 官方登录用）。

TOML · config.toml

model_provider = "custom"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.custom]
name = "custom"
base_url = "https://api.tutujing.com/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "sk-你的密钥"

API Key / auth.json 那一栏填 sk-你的密钥（如果显示的是 JSON 编辑器，就填 {"OPENAI_API_KEY": "sk-你的密钥"}）。base_url 必须带 /v1，wire_api 固定 responses。只通过 CC Switch 表单添加时，密钥按表单字段填即可；手工改 config.toml 才需要自己写 experimental_bearer_token。

Gemini CLI

JSON · Gemini CLI

{
  "env": {
    "GEMINI_API_KEY": "sk-你的密钥",
    "GOOGLE_GEMINI_BASE_URL": "https://api.tutujing.com",
    "GEMINI_MODEL": "gemini-4-argon"
  }
}

GOOGLE_GEMINI_BASE_URL 不要带 /v1beta，Gemini CLI 会自己拼。保存后重启。

六、切换与生效

客户端	切换后怎么生效
Claude Code	立即生效，不用重启，新开会话即可。
Codex	重启终端或桌面应用；模型列表没刷新时，用 CC Switch 提示里的「重启 Codex 守护进程」，或完全退出桌面应用再打开。
Gemini CLI	重启终端。

要回到官方登录，在 CC Switch 里切到内置的 Claude Official / OpenAI Official / Google Official 供应商，再按客户端自己的流程登录。CC Switch 切换时只改端点、密钥、模型等关键字段，插件、hooks、MCP 和你自己加的设置会保留；第一次改写配置文件前会把原文件备份到 ~/.cc-switch/backups/live-first-write/。

七、验证与排错

在客户端发一条最小请求，比如让它只回复一个词。
回到控制台「日志」，确认这条记录里的模型、令牌和分组都对。
额度变化应与模型广场的计价一致；对不上时先核对模型名，不要先怀疑余额。

现象	常见原因	处理
`401` 无效的令牌	密钥错误、已禁用，或复制时末尾带空格	重新复制；到密钥列表确认状态
`404`	地址路径错：Claude 多写 `/v1`、Codex 少写 `/v1`、Gemini 写了 `/v1beta`	按第一节地址表改回
`503` / `model_not_found`	分组不包含该模型，或该分组暂无可用渠道	换分组，或换成该分组里有的模型
`400`	参数不合法、上下文超限，或模型不支持该请求	换模型或减少输入，以日志里的原始报错为准
一直超时	本机网络、代理或防火墙	先在本机直接请求地址确认可达

连通性检查不等于能调用CC Switch 卡片上的「连通性检查」只测地址是否可达，不发真实模型请求，所以查不出密钥错误、模型名错误或分组不对。最终以客户端真实请求 + 控制台日志为准。

手动填模型时最容易错的是名字：大小写、连字符、日期后缀都要和模型广场一致。不确定时先在模型输入框旁点「获取模型列表」，从接口返回的列表里选。

八、安全提醒

密钥等同账号余额：不要写进截图、公开仓库、聊天记录或网页源码。
CC Switch 的深度链接里带密钥，只在登录状态下现场生成、现场使用。
不同客户端、不同项目用不同密钥；发现泄露立即禁用并重建。
本页只覆盖接入地址和配置字段；CC Switch 的账号登录、路由、聚合、MCP 等能力以它自己的文档为准。

可以继续看：Codex++ 设置（另一套界面） · API 填写与模型/分组对照 · 模型广场（实时价格） · 官方文档版 CCSwitch 配置