CC Switch 是什么？一键配置 Claude Code、Codex 与 DeepSeek Harness

教程2026-11-15

用 AI 编程客户端（Claude Code、Codex、DeepSeek Harness 等）连接第三方 API 或中转站时，最麻烦的是每个客户端的配置方式都不一样。CC Switch 就是用来解决这件事的桌面工具。

CC Switch 做了什么#

CC Switch 把「供应商」（接口地址 + 密钥 + 模型）集中管理，点一下就能切换，并自动把配置写进对应客户端的配置文件。你不用再手动改文件，也不用担心改坏。

它还支持通过 ccswitch:// 链接导入供应商。鹊桥控制台的「一键导入」按钮，就是生成这样的链接，交给 CC Switch 完成导入。

用鹊桥一键导入（推荐）#

到 CC Switch 官网下载并安装。
在鹊桥控制台「API 密钥」页，点令牌右侧的对应按钮（ChatGPT客户端、Claude客户端、Claude插件、DeepSeek Harness）。
浏览器询问是否打开 CC Switch 时选「打开」，在 CC Switch 里点确认。

图文步骤见快速开始。

不用 CC Switch，手动配置也可以#

理解原理有助于排查问题。下面三个例子里，sk-你的令牌 请替换成你在鹊桥创建的令牌。

Claude Code#

Claude Code 通过环境变量读取接口地址和密钥。接口地址填站点根地址，不要带 /v1，客户端会自己补全路径。

export ANTHROPIC_BASE_URL="https://cdn.5202828.xyz"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
export ANTHROPIC_MODEL="你的分组内的模型名"
claude

Windows PowerShell 把 export 换成 $env:ANTHROPIC_BASE_URL = "..." 即可。也可以把这些变量写进用户目录下 .claude/settings.json 的 env 字段，长期生效。

Codex（ChatGPT 客户端）#

Codex 使用 ~/.codex/config.toml 配置自定义供应商，接口地址要带 /v1：

model_provider = "queqiao"
model = "你的分组内的模型名"

[model_providers.queqiao]
name = "queqiao"
base_url = "https://cdn.5202828.xyz/v1"
env_key = "QUEQIAO_API_KEY"
wire_api = "responses"

然后设置环境变量 QUEQIAO_API_KEY 为你的令牌，彻底退出并重新打开客户端后生效。

DeepSeek Harness#

DeepSeek Harness 的供应商是 OpenAI 格式，接口地址同样带 /v1。因为需要同时配置多个模型、图片输入和思考档位，建议用 CC Switch 导入，再按 DeepSeek Harness 教程粘贴完整配置。

常见问题#

Base URL 到底要不要带 /v1？ Claude 系客户端不带，OpenAI 系（Codex、Harness）带。填错最常见的现象是 404。
模型名填什么？ 以令牌所在分组可用的模型为准，在控制台的模型列表里复制，大小写和连字符都要一致。
改了配置没反应？ 多数客户端只在启动时读取配置，需要彻底退出（Windows 注意右下角托盘）再打开。

遇到其他报错，可以参考大模型 API 常见报错怎么排查。