主题
CC Switch 统一配置
本站默认通过 CC Switch 统一管理 Claude Code、Codex、OpenClaw 等环境的 API 配置。除非需要手动排障或高级自定义,否则不再建议分别编辑各工具配置文件。
安装
项目地址:https://github.com/farion1231/cc-switch
Windows
前往 Releases 下载安装版或便携版。
macOS
bash
brew tap farion1231/ccswitch && brew install --cask cc-switch1
Linux
Linux 下需要装 Linuxbrew,然后用与 macOS 相同的命令:
bash
brew tap farion1231/ccswitch && brew install cc-switch1
如果 Linuxbrew 装不上或不想装,可以直接从 Releases 下载对应架构的二进制(AppImage / deb / rpm,按发行版选)。
通用配置流程
下面以 CC Switch 的自定义配置为例,演示如何接入 Entropic Echo。这是本文档站推荐的统一配置流程,Claude Code、Codex 与 OpenClaw 指南不再重复展开相同步骤。
先确认配置格式
CC Switch 也要按请求格式填写地址:
| 配置格式 | Base URL | 适用 |
|---|---|---|
| Claude / Anthropic 格式 | https://api.entropicecho.com | Claude Code、Anthropic Messages |
| Codex / OpenAI 格式 | https://api.entropicecho.com/v1 | Codex、OpenAI Responses |
不要把其中一种格式的地址复制到另一种格式里。
开启本地路由(必做)
使用 CC Switch 配置 Coding Agent 前,先打开左上角 设置,再进入 路由:
- 开启 路由总开关。
- 在 路由启用 中,开启当前要使用的 Coding Agent:
- 使用 Claude Code 时开启 Claude。
- 使用 Codex 时开启 Codex。
- 只开启当前实际使用的 Agent 即可;切换工具时,再启用对应项。

按下面步骤填写:
先创建密钥并选择分组(必做):登录控制台创建
sk-密钥,在 分组 中按目标模型、计费倍率和可用能力选择合适的分组。已有密钥也可编辑后更换分组;完整说明见 创建密钥并选择分组。打开 CC Switch,点「添加配置」,选对应框架(Claude Code / Codex / 其它外接客户端)。

选 自定义配置,进入供应商编辑页面后填写:
- 供应商名称:
EntropicEcho - 官方链接:
https://api.entropicecho.com - Base URL / API 请求地址:按上方格式表填写;Claude / Anthropic 不带
/v1,Codex / OpenAI 带/v1 - API Key:填入控制台创建的密钥(
sk-xxx) - 默认模型:
gpt-5.6-sol
- 供应商名称:
确认 Base URL 只填写到格式表中的完整地址;Claude / Anthropic 不追加
/v1,Codex / OpenAI 不追加/v1/responses或其他接口路径。点「添加」或「保存」→ 重启终端或客户端。

Codex 的模型分流规则
CC Switch 与 Codex++ 是独立软件。Codex 只使用 GPT 官方模型(gpt-*)时,可按本页配置 CC Switch;如需 DeepSeek、Claude、Gemini 等第三方模型,或任何非 GPT 官方模型,不要在 CC Switch 中配置 Codex,请改用 Codex++ 配置 Entropic Echo 并从 Codex++ 启动应用。
高级选项
点击「高级选项」可以展开更多设置:
- 模型映射:手动修改模型名称映射,让客户端请求的模型名自动转发到中转站对应模型
- 1M 上下文:勾选后启用长上下文支持,适用于支持 1M 上下文的模型
如果默认配置满足需求则无需展开;仅在需要自定义模型映射或启用长上下文时才使用。
提示
日常使用到这里就够了。CC Switch 无法使用或需要排查环境变量覆盖时,再看 Claude Code 手动配置与排错 或 Codex CLI 手动配置与排错。
需要查看余额和消耗明细时,按 CC Switch 额度查询 配置 NewAPI。
相关页面
| 页面 | 说明 |
|---|---|
| Claude Code 使用指南 | 安装、配置、启动与常用命令 |
| Codex CLI 与 App 使用指南 | CLI、Windows App、模型与推理深度 |
| Codex++ 配置 Entropic Echo | Codex App 使用第三方模型的独立配置方案 |
| OpenClaw 配置 | OpenClaw 初始化和接入 |