配合 CC Switch 使用

CC Switch 是本地配置管理工具。把万川保存为供应商后，可以在 Claude Code 与 Codex 之间切换。

CC Switch 只保存和切换本地配置，不会替你创建万川账户或 API Key。请从控制台复制密钥；文档里的 YOUR_API_KEY 只是占位符。

开始前准备

安装 CC Switch，并至少启动一次 Claude Code 或 Codex。
在控制台创建 API Key。
从模型目录复制真实 model id。

添加万川供应商

打开 CC Switch，进入 Claude Code 或 Codex 标签页，点击新增供应商。
选择自定义配置；名称可以填写 WanChuan。
按工具填写地址：Claude Code 使用 https://chuanapi.com，Codex 使用 https://chuanapi.com/v1。
填写 API Key 和模型映射，保存后启用该供应商。

Claude Code 字段示例：

供应商名称：WanChuan
API Endpoint：https://chuanapi.com
API Key：YOUR_API_KEY
模型：MODEL_ID

Codex 配置示例：

[model_providers.wanchuan]
name = "WanChuan"
base_url = "https://chuanapi.com/v1"
env_key = "WANCHUAN_API_KEY"
wire_api = "responses"

验证是否生效

切换供应商后，新开一个终端窗口，再发送一条简短请求。看到模型返回内容并在控制台用量日志中出现记录，就说明配置生效。

curl https://chuanapi.com/v1/chat/completions \
  -H "Authorization: Bearer $WANCHUAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID","messages":[{"role":"user","content":"你好"}]}'

常见问题

404：Claude Code 地址不要加 /v1；Codex 地址需要包含 /v1。
401：检查当前工具使用的供应商是否真的启用，以及 Key 是否包含多余空格或前缀。
403：当前分组不包含该模型，换用模型目录中可用的 id。
切换后没有变化：关闭已经运行的终端和工具，再新开会话；CC Switch 的本地路由状态也要保持启用。

恢复原配置

在 CC Switch 中切回原供应商并重新启动工具即可。删除供应商前先确认其他项目没有依赖它；需要进一步定位时，记录错误码、model id 和请求时间，再查看错误码文档。