CC Switch 是什么，什么时候用它
CC Switch 是一个桌面小工具，专门管理 Claude Code 和 Codex 的「供应商」。你可以把官方、小店、别家中转都存进去，点一下就切换，不用每次手改环境变量或 config.toml。
用它之前要准备两样东西：
密钥创建时选的分组决定它会导成哪一类供应商：选 OpenAI 平台的分组（比如「ChatGPT 【稳定分组 超高缓存 高并发 】」）会导成 Codex 供应商；选 Anthropic 平台的分组（比如「CC MAX正价分组」）会导成 Claude Code 供应商。分组怎么挑见 分组说明。
方法一：控制台一键导入
- 登录控制台，打开 API 密钥 页。
- 找到要用的那把密钥，在它右侧的按钮里点「导入到 CCS」。
- 浏览器会问「是否打开 CC Switch」，点允许。
- CC Switch 弹出导入确认，确认后供应商列表里就多了一条，名字就是小店的站名。
这个按钮替你填好了下面这些内容，不用再手动输入：
- 供应商名称：小店站名。
- 类型：OpenAI 分组的密钥导成 Codex；Anthropic 分组的密钥导成 Claude Code。
- Base URL：https://api.zyuou.com。Codex 类型由 CC Switch 自己补上 /v1，所以控制台传过去的是不带 /v1 的地址。
- API Key：这把密钥的明文。
- 默认模型（只有 Codex 类型有）：gpt-5.5，之后可以在 CC Switch 里改成 gpt-6.1-sol 等。
- 余额查询脚本：CC Switch 会用你的密钥去请求 https://api.zyuou.com/v1/usage，把返回的 remaining（剩余美元额度）显示在供应商卡片上，并且已经打开了自动刷新。
想自己验证余额接口，可以在终端里运行这一句，返回里的 remaining 就是剩余额度（单位 USD）：
curl https://api.zyuou.com/v1/usage \
-H "Authorization: Bearer sk-你的密钥"点了按钮没反应，并且页面提示「CC-Switch 未安装或协议处理程序未注册。请先安装 CC-Switch 或手动复制 API 密钥。」，说明电脑上还没装 CC Switch，或者刚装好还没注册协议。装好、重启一次 CC Switch 再点；还不行就用下面的方法二。如果密钥页根本没有这个按钮，是店主关掉了它，同样用方法二。
方法二：手动添加自定义供应商
CC Switch 里 Claude Code 和 Codex 是两个分开的页签，各自添加各自的供应商。两边要填的内容如下：
| 项目 | Claude Code 供应商 | Codex 供应商 |
|---|---|---|
| 名称 | 章鱼烧的小店 | 章鱼烧的小店 |
| Base URL / API 地址 | https://api.zyuou.com | https://api.zyuou.com/v1 |
| API Key | sk-你的密钥 | sk-你的密钥 |
| 模型 | 不用填 | gpt-6.1-sol（或别的模型名） |
为什么差一个 /v1：Claude Code 的 ANTHROPIC_BASE_URL 填站点根地址，后面的路径由 Claude Code 自己拼；Codex 的 base_url 要带 /v1，并且 wire_api = "responses"，Codex 再自己拼 /responses。这和 Claude Code 教程、Codex CLI 教程 里的手工配置是同一套。
填完以后，CC Switch 替你生成的配置应该和控制台「使用」弹窗给的一致。Codex 这边的核心是：
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.zyuou.com/v1"
wire_api = "responses"
requires_openai_auth = trueClaude Code 这边写进 settings.json 的核心是：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.zyuou.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
}
}核对要点：Codex 那边最终地址里只能有一个 /v1。如果 CC Switch 预览里出现了 /v1/v1，把 Base URL 末尾的 /v1 删掉再保存，否则请求会 404，卡片上的余额也会显示「查询失败」。
导入后怎么确认
- 在 CC Switch 里把「章鱼烧的小店」切成当前供应商。
- 看卡片上的余额，应该和控制台里的余额一致。
- 打开 Claude Code 或 Codex，随便发一句话。然后去控制台 使用记录 页，看到这把密钥多了一条新记录，就说明通了。
一把密钥只属于一个分组。想同时在 Claude Code 和 Codex 里用小店，就在 API 密钥 页分别建一把 Anthropic 分组的密钥和一把 OpenAI 分组的密钥，各导入一次。