CC Switch

CC Switch 是本机「供应商切换器」：不是中转站。它把本站 Key 写进 Claude Code、Codex、OpenCode、OpenClaw、Grok Build、Hermes 等客户端的配置，避免手改 JSON / TOML。

桌面官网	https://ccswitch.io
桌面仓库	https://github.com/farion1231/cc-switch
CLI / TUI	https://github.com/SaladDay/cc-switch-cli （命令名 cc-switch）

本站 API 域名：

https://api.ashpetals.com

协议场景	Base URL
OpenAI Chat / Responses / 通用 SDK	https://api.ashpetals.com/v1
Anthropic Messages（Claude Code）	https://api.ashpetals.com（不要带 /v1）

---

什么时候用

场景	建议
同时用 Claude Code + Codex + OpenCode 等	首选 CC Switch
只跑一款软件	打开对应教程手写配置即可，不必装
无 GUI / 服务器 / 脚本切换	用下方 CC-Switch CLI
协议已匹配（Claude→Claude、GPT→Codex）	直连本站，不必开本地路由
要在 Claude Code 里跑 GPT、在 Codex 里跑 Claude	才开本地路由做格式转换

---

图形界面（桌面版）

1. 从 https://ccswitch.io 安装桌面端并打开。
2. 顶部选目标应用（Claude Code / Codex / OpenCode / OpenClaw / Grok Build / Hermes …）。
3. 添加供应商 → 预设选「自定义」或任意 Anthropic / OpenAI 兼容模板。
4. 按目标应用填字段（见下表），点 启用。
5. 按「生效方式」表重开对应客户端。

按应用填写

A. Claude Code → 本站 Claude

字段	值
API Key	sk-你的APIKey
请求地址	https://api.ashpetals.com
API 格式	Anthropic Messages（原生）
模型	claude-sonnet-5（以 /v1/models 为准）
令牌分组	Claude-Main 或 Claude-Pro

直连 Anthropic 协议时 无需 打开本地路由。新开终端运行 claude，发一句「你好」。

B. Codex / ChatGPT CLI → 本站 GPT

字段	值
API Key	sk-你的APIKey
请求地址	https://api.ashpetals.com 或 https://api.ashpetals.com/v1（看工具是否自动补 /v1）
上游格式	Responses（原生）
默认模型	gpt-5.6-sol

启用后 必须重开 Codex 终端。手写等价配置见 ChatGPT / Codex。

C. OpenCode / OpenClaw / Hermes / Grok Build

应用	要点
OpenCode	OpenAI 兼容：baseURL=https://api.ashpetals.com/v1
OpenClaw	同上；OpenClaw 还要 allowlist，见 OpenClaw
Hermes	可用 CC Switch 同步；也可用原生 hermes model，见 Hermes
Grok Build	按工具预设填 OpenAI 兼容端点；模型用 Grok-Main 分组里的 ID
Claude Desktop	直连 Anthropic 兼容；或模型映射模式（见 CC Switch 手册）
Gemini CLI	仅建议 API Key 路径；勿劫持 Google OAuth

跨协议（可选）

目标	条件	操作
Claude Code 里用 GPT	本站提供 Responses / Chat 模型	Claude 供应商 API 格式改为 OpenAI Responses 或 Chat → 开启本地路由并接管 Claude Code → 配模型映射
Codex 里用 Claude	本站 Claude 走 /v1/messages	Codex 供应商上游格式选 Anthropic Messages → 开启本地路由并接管 Codex

跨协议时客户端指向本机代理，真实 Key 由 CC Switch 注入，不要再把本站 URL 直接写进 live 配置。

本地代理端口（仅开启本地路由时）

工具	默认本地地址
CC Switch	http://127.0.0.1:15721
CCR	http://127.0.0.1:3456
opencodex	仪表盘 http://localhost:10100

协议已匹配 → 直连本站。 只有跨协议、故障转移、统一用量观测时再开本地路由。

切换后如何生效

客户端	切换供应商后
Claude Code	多数情况热重载；首次改 BASE_URL 建议新开终端
Codex	重开终端 / 重启 Codex
Gemini CLI	一般每次请求重读配置
OpenCode / OpenClaw / Hermes / Grok Build	通常需重开会话

---

命令行版本（CC-Switch CLI / TUI）

无 GUI、SSH 服务器、脚本切换时用这个。它是桌面版的 CLI fork，命令名 cc-switch。

仓库：https://github.com/SaladDay/cc-switch-cli

安装

# macOS / Linux 一键
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash

# Homebrew
brew install cc-switch-cli

Windows：从 Releases 下载 cc-switch-cli-windows-x64.zip，把 cc-switch.exe 放到 PATH。

TUI（推荐）

cc-switch

全屏界面里：选应用 → 添加 / 切换供应商 → 保存。Providers 页选中供应商后按 o 可「用该供应商启动一次、不改全局」。

脚本化命令

--app 指定目标应用。支持：claude（默认）、codex、gemini、opencode、hermes、openclaw、pi。

# 列出 / 切换
cc-switch --app claude provider list
cc-switch --app claude provider add          # 交互添加
cc-switch --app claude provider switch <id>
cc-switch use <id>                           # 切换快捷命令
cc-switch provider current

# 只启动一次、不改全局（多终端各用各的供应商）
cc-switch start claude
cc-switch start codex
cc-switch start claude --dry-run             # 只预览

# 探测
cc-switch provider fetch-models
cc-switch provider speedtest
cc-switch provider stream-check

# 导出 Claude 为独立 settings（方便仓库内自动加载）
cc-switch provider export
cc-switch provider export --output ~/.claude/settings-demo.json

交互 provider add 时按目标应用填：

--app	请求地址	协议 / 格式	Key
claude	https://api.ashpetals.com	Anthropic Messages	sk-…
codex	https://api.ashpetals.com/v1	Responses	sk-…
opencode / hermes / openclaw	https://api.ashpetals.com/v1	OpenAI 兼容	sk-…

provider switch / use 改的是全局当前供应商；cc-switch start <app> 只影响这一次启动。

---

其它辅助工具（简表）

CCR（Claude Code Router）

1. 安装桌面版或 npm i -g @musistudio/claude-code-router → ccr ui
2. 添加供应商：Base https://api.ashpetals.com 或 /v1（按协议）+ Key
3. 启动本地服务（默认 :3456）
4. Agent 配置档案选 Claude Code / Codex 等并应用

文档：https://ccrdesk.top

opencodex

npm i -g @bitkyc08/opencodex
ocx start    # http://localhost:10100
ocx init     # 接线 Codex

仪表盘添加 OpenAI 兼容 provider：https://api.ashpetals.com/v1 + Key。Claude 侧用 ocx claude 走代理。文档：https://opencodex.me

不装切换器，手写配置

• ChatGPT / Codex
• Claude Code
• OpenCode
• Grok Build
• Hermes
• OpenClaw
• DeepSeek Harness

---

验证

curl -sS https://api.ashpetals.com/v1/models \
  -H "Authorization: Bearer sk-你的APIKey" | head

curl -sS https://api.ashpetals.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"ping"}]}'

curl -sS https://api.ashpetals.com/v1/messages \
  -H "x-api-key: sk-你的APIKey" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":64,"messages":[{"role":"user","content":"ping"}]}'

客户端内发一句「你好」；若工具有用量 / 日志页，确认请求落到本站供应商。

---

常见问题

Q: 401 / 403
A: Key 错误、过期、或认证头用错（Bearer vs x-api-key）。Claude 侧优先 ANTHROPIC_AUTH_TOKEN。

Q: model_not_found
A: 模型不在当前令牌分组。换分组重建令牌，或改用 /v1/models 里有的 ID。

Q: 404 on /v1/messages 或 /responses
A: Base URL 多/少了 /v1，或协议与客户端不匹配。对照 客户端总览。

Q: 切换了供应商没生效
A: Codex 等需重启终端；检查 shell 里是否残留旧的 ANTHROPIC_* / OPENAI_* 覆盖了配置文件。

Q: 要不要用本地代理？
A: 协议已匹配 → 直连本站。只有跨协议、故障转移、统一用量观测时再开。

Q: CLI 和桌面版配置互通吗？
A: CLI 的 WebDAV 同步与上游桌面项目兼容，但本机配置目录不一定自动共用。换工具后用 provider list / 桌面供应商列表核对，不要假设已写入。

---

相关链接

• 客户端总览
• 快速开始
• 模型列表：GET /v1/models · 模型广场
• 分组与价格
• 错误码