Codex CLI 与 CC Switch 接 Ofox:两套协议别配错
CC Switch 能在一个界面里同时配好 Codex CLI 和 Claude Code。两条记录要填不同的 base URL 和 API 格式,配错这一步是最常见的失败原因。
CC Switch 真正有用的地方不是省掉手改 JSON。Codex CLI 和 Claude Code 说的是两套不同的协议,而它能把两条记录并排摆着,还不让你混。配置失败的案例里,最常见的就是把 Claude Code 的 base URL 粘到了 Codex 那一栏,或者反过来。
一切都取决于这一个区别
| Codex CLI | Claude Code | |
|---|---|---|
| 协议 | OpenAI 兼容 | Anthropic 原生 |
| Ofox base URL | https://api.ofox.ai/v1 | https://api.ofox.ai/anthropic |
| CC Switch 里的 API 格式 | OpenAI Compatible | Anthropic Messages (Native) |
| 鉴权字段 | 默认 | ANTHROPIC_AUTH_TOKEN |
| CC Switch 标签页 | Codex | (服务商管理页) |
两个地址末尾都不要加斜杠。一把 Ofox Key 同时管两边。
装 CC Switch
# macOS
brew install --cask cc-switch
# Debian / Ubuntu
sudo dpkg -i CC-Switch-*.deb
# Fedora / RHEL
sudo rpm -i CC-Switch-*.rpm
# AppImage
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage
Windows 有 .msi 安装包;不想走 Homebrew 的话,releases 页上也提供 macOS 的 .dmg。支持的最低系统版本是 macOS 12、Windows 10,以及 Ubuntu 22.04 / Debian 11 / Fedora 34。完整的安装流程与多 CLI 面板见另一篇 CC Switch 指南。
加 Codex CLI 这条
先切到顶部的 Codex 标签页,再点右上角的 +。
| 字段 | 值 |
|---|---|
| Provider Name | ofoxai-codex |
| Website URL | https://ofox.ai |
| API Key | 你的 Ofox Key |
| Request URL | https://api.ofox.ai/v1 |
| API Format | OpenAI Compatible |
| Write to Global Config | 勾上 |
「Write to Global Config」勾上,配置会写进全局,对所有项目生效,而不是只对当前项目生效。添加完之后回到列表里把它激活。
加 Claude Code 这条
同一个工具,换一个页面,值也不一样。
| 字段 | 值 |
|---|---|
| Provider Name | ofoxai-claude |
| Website URL | https://ofox.ai |
| API Key | 你的 Ofox Key |
| Request URL | https://api.ofox.ai/anthropic |
| API Format / 鉴权字段 | Anthropic Messages (Native) / ANTHROPIC_AUTH_TOKEN |
| Model Configuration | 留空 |
| Write to Global Config | 勾上 |
Model Configuration 留空。 留空会走默认的 Claude 模型;除非你有意要钉死某个模型,否则不用填。CC Switch 会把结果写进 ~/.claude/settings.json。
这一页还有两个可选开关,「Hide AI Signature」和「Teammates Mode」,都不影响路由和计费。
打开用量查询
CC Switch 可以定期向 Ofox 拉取用量数据,显示在自己的面板里。有四项要设:
- 把 Enable Usage Query 打开
- 填同一把 Ofox API Key
- 请求端点填
https://api.ofox.ai/v1 - 模板选通用模板(Ofox 文档标注这一项兼容性最好)
有两点要知道:
- 它走的是专门的统计接口,不占 API 额度。
- 用量数字会比实际调用晚几分钟出现。
之后想关掉,直接关开关,不影响正常的 API 调用。
关于 Fable 5.1
这套配置今天跑不了 Fable 5.1。 截至 2026 年 9 月 3 日,Ofox 目录共 138 个模型,Fable 系只有 anthropic/claude-fable-5。改 base URL、改服务商名、改模型字符串,都改不出来。
这套配置真正给你的,是 5.1 到来之前值得先有的东西:一条两协议都通的路,换模型就是换个字符串。目录里现有 anthropic/claude-fable-5、anthropic/claude-opus-5、anthropic/claude-sonnet-5,按 Anthropic 官方定价计费,不加价,三个都能用同一把 Key 走任一协议。
这一点对 Fable 5.1 尤其重要,因为它唯一变的价格就是缓存读取——从 $1 降到 $0.25。这对你值不值钱,完全取决于你的缓存命中率,而唯一的查法是现在拿 Fable 5 跑真实负载,从自己的用量里把这个数读出来。费率表和 TTL 怎么算,在另一篇。
连不上的时候
最常见的是这三种:
- Request URL 末尾多了斜杠。Ofox 文档在两条服务商记录里都专门提醒了这一点。
- 标签页和 API 格式对不上。Codex CLI 选成「Anthropic Messages (Native)」跑不通,反过来也一样。先看格式字段,再看 Key。
- 模型字符串目录里没有。
claude-fable-5-1目前就属于这一类。以线上目录为准——GET /v1/models返回的就是你能调的全部。
CC Switch 支持的安装平台、服务商字段取值、base URL 与用量查询行为,于 2026 年 9 月 3 日核对自 Ofox 集成文档;目录内容同日核对自线上 /v1/models 接口。
常见问题
- CC Switch 是什么?
- 开源的服务商管理工具,带可视化界面。它替你写 Claude Code 和 Codex CLI 的配置文件,不用手改 JSON 或环境变量——Claude Code 那侧写的是 ~/.claude/settings.json。支持 macOS 12+、Windows 10+,以及 Ubuntu 22.04+ / Debian 11+ / Fedora 34+。
- Codex CLI 和 Claude Code 用同一个 Ofox base URL 吗?
- 不用,而且这正是最常见的配置错误。Codex CLI 是 OpenAI 协议客户端,填 https://api.ofox.ai/v1,API 格式选 OpenAI Compatible。Claude Code 是 Anthropic 协议客户端,填 https://api.ofox.ai/anthropic,格式选 Anthropic Messages (Native)。两个地址末尾都不要加斜杠。
- 这套配置能跑 Claude Fable 5.1 吗?
- 还不能。截至 2026 年 9 月 3 日,Ofox 目录里共 138 个模型,没有 Fable 5.1 条目。下面这套配置本身是对的,对目录里已有的模型现在就能用,包括 Fable 5、Opus 5 和 Sonnet 5。等 5.1 上架,配置一个字都不用改,只换模型字符串。
- CC Switch 的用量查询会消耗 API 额度吗?
- 不会。按 Ofox 集成文档的说法,它走的是专门的统计接口,不计入你的 API 调用额度。用量数字一般会在调用发生后几分钟内出现。
- 可以在 CC Switch 里放多个 Ofox 账号吗?
- 可以。用不同的 API Key 添加多条 Ofox 服务商记录,在列表里切换即可。


