Codex 好用，但用多了总觉得钱包不够！

我发现了一个免费的方法：Codex 还是照常用，模型请求走第三方免费API，中间用CC Switch接一下。

实测跑通了。大致是这个关系：

. . . text

Agnes API -> CC Switch 本地路由 -> Codex

下面按小白步骤来。

01 START

第一步，去 Agnes 创建 API Key

先打开 Agnes 官网：

. . . text

https://agnes-ai.com/

点页面里的“API 平台”。也可以直接打开：

. . . text

https://platform.agnes-ai.com/

登录后进这个页面：

. . . text

https://platform.agnes-ai.com/settings/apiKeys

这里能看到“创建新的密钥”。

点“创建新的密钥”，给它起个名字，列如 codex-cc-switch-test 。

保存后，把 API Key 复制下来。后面要填进 CC Switch。

02 METHOD

第二步，把 Agnes 导入 CC Switch

打开 CC Switch，进入 Codex 标签，添加 Agnes 供应商。

这几个地方要填：

• 应用类型：Codex

• 供应商名称：Agnes AI

• API 地址：Agnes 的 OpenAI 兼容地址

• API 密钥：刚刚复制的 Key

• 模型：这里用 agnes-2.0-flash

导入后，Codex 标签页里能看到 Agnes AI。

到这里先别急着以为好了。CC Switch 里显示供应商可用，不等于 Codex 已经能正常跑。

我第一次就是卡在这里。

03 TEST

第三步，先跑一个最小测试

我先用 Codex CLI 跑了一句最小测试：

. . . bash

codex exec –skip-git-repo-check -C “/path/to/your/project” -s read-only –ephemeral “Reply exactly: OK”

第一次没通，报错里有这一句：

. . . text

Unexpected message role

这个报错多半不是 Key 或网络导致的。Codex 发的是 Responses API 风格，请求到 Agnes 那边，角色字段没有对上。

中间还有一个小插曲。CC Switch 里升级 Codex CLI 时，我遇到了 npm: command not found 。

这是 macOS 常见问题。终端里能找到 npm，不代表图形界面 App 也能找到同一套 PATH。

我把环境路径处理好，升级到 codex-cli 0.143.0 ，再测还是没通。

卡点不在版本。

04 SUMMARY

第四步，改上游格式

回到 Agnes AI 供应商配置，进入高级选项。

把“上游格式”改成：

. . . text

Chat Completions（需开启路由）

这里别选错。Codex 这边还是 Responses，Agnes 这边按 Chat Completions 接，中间需要 CC Switch 做一次转换。

改完后，供应商卡片上会出现“需要路由”。继续去打开本地路由。

05 SUMMARY

第五步，打开本地路由

进入 设置 -> 路由 ，打开路由总开关。

然后在“路由启用”里打开 Codex。

我这里只开 Codex，Claude 和 Gemini 先不动。

. . . text

路由生效后，~/.codex/config.toml 会变成类似这样：

model_provider = “agnes_ai”

model=”agnes-2.0-flash”

[model_providers.agnes_ai]

base_url=”http://127.0.0.1:****/v1″

wire_api=”responses”

requires_openai_auth=true

看 base_url 就行。它变成本地地址后，Codex 会先请求 CC Switch，再由 CC Switch 转到 Agnes。

06 CODEFIX

第六步，再测 Codex

重新跑刚才那句：

. . . bash

codex exec –skip-git-repo-check -C “/path/to/your/project” -s read-only –ephemeral “Reply exactly: OK”

再跑，终端返回：

. . . text

OK

再回 CC Switch 的路由页，能看到 Codex 的请求记录。

到这一步，链路就通了。

07 SUMMARY

平时怎么用？

上面的 OK 只是测试，不是日常用法。

平时直接进项目目录启动 Codex：

. . . bash

cd “/path/to/your/project” codex

然后像平时一样用。可以先让它读项目，找一下启动方式。改文件也照常说。

也可以用一次性命令：

. . . bash

codex exec -C “/path/to/your/project” “帮我看一下这个项目怎么启动”

CC Switch 不要退出，本地路由保持开启。后来想换模型，就回 CC Switch 的 Codex 标签页里切。

08 SUMMARY

总结一下流程

1. 打开 https://agnes-ai.com/ ，进入 API 平台。

2. 在
https://platform.agnes-ai.com/settings/apiKeys 创建 API Key。

3. 回到 CC Switch，在 Codex 标签里添加 Agnes。

4. 填 API Key、API 地址和模型名。

5. 高级选项里把上游格式改成 Chat Completions（需开启路由） 。

6. 到 设置 -> 路由 ，打开路由总开关。

7. 在“路由启用”里打开 Codex。

8. 用 codex exec 做一次 OK 测试。

9. 测试通过后，回到项目里正常用 Codex。

如果卡住，先回到供应商页确认上游格式；再进路由页确认 Codex 开关是开的。