Codex CLI 与 CC Switch 接 Ofox:两套协议别配错

CC Switch 能在一个界面里同时配好 Codex CLI 和 Claude Code。两条记录要填不同的 base URL 和 API 格式,配错这一步是最常见的失败原因。

Codex CLI 与 CC Switch 接 Ofox:两套协议别配错

CC Switch 真正有用的地方不是省掉手改 JSON。Codex CLI 和 Claude Code 说的是两套不同的协议,而它能把两条记录并排摆着,还不让你混。配置失败的案例里,最常见的就是把 Claude Code 的 base URL 粘到了 Codex 那一栏,或者反过来。

一切都取决于这一个区别

Codex CLIClaude Code
协议OpenAI 兼容Anthropic 原生
Ofox base URLhttps://api.ofox.ai/v1https://api.ofox.ai/anthropic
CC Switch 里的 API 格式OpenAI CompatibleAnthropic 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 Nameofoxai-codex
Website URLhttps://ofox.ai
API Key你的 Ofox Key
Request URLhttps://api.ofox.ai/v1
API FormatOpenAI Compatible
Write to Global Config勾上

「Write to Global Config」勾上,配置会写进全局,对所有项目生效,而不是只对当前项目生效。添加完之后回到列表里把它激活。

加 Claude Code 这条

同一个工具,换一个页面,值也不一样。

字段
Provider Nameofoxai-claude
Website URLhttps://ofox.ai
API Key你的 Ofox Key
Request URLhttps://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-5anthropic/claude-opus-5anthropic/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 服务商记录,在列表里切换即可。