先用 CC Switch 跑起来，再处理少数疑难问题

CC Switch — 给 Codex 切换供应商

适合手里有多家 API 的人。它能切换 provider，也能在需要时用本地路由把 Chat Completions 转成 Codex 所需的 Responses。改完必须新开终端 / 重启客户端。

1. 1安装并打开 CC Switch，顶部切到 Codex（不要停在 Claude 面板）。
2. 2如果还想保留官方账号、远程控制或官方插件，先完成官方登录，再到设置 → 通用 → Codex App 增强，开启「切换第三方供应商时保留官方登录」。
3. 3点「+」添加供应商：填写 Base URL、API Key 和模型。原生支持 Responses 的网关可直连；只有 Chat Completions 的供应商需要本地路由。
4. 4需要转换协议时，到设置 → 路由 → 本地路由，打开总开关，并在「路由启用」里打开 Codex。
5. 5回到 Codex 供应商列表点「启用」，再检查 ~/.codex/config.toml 的 model_provider、base_url 和模型是否更新。
6. 6关掉正在跑的 Codex：终端窗口整窗关闭，客户端完全退出。
7. 7新开终端运行 codex（或重开客户端），发一条短消息验证。
8. 8最后看 CC Switch 路由日志或供应商余额，确认请求确实到了目标 API。

CC Switch 适合频繁换供应商或需要协议转换的人。版本更新可能改变写入方式，切换前先用它的备份功能保存 ~/.codex；不要同时用 GUI 和编辑器抢写。

手写 auth.json

不想用 GUI 时，直接管凭据文件。与 CLI login 最终落点类似（file 模式）。

1. 1确认 cli_auth_credentials_store 为 file（或 auto 且回退到 file）。
2. 2写入 OPENAI_API_KEY 字段；chmod 600 更稳妥。
3. 3需要自定义 base_url 时，仍要配合用户级 config.toml 的 model_providers。
4. 4重启 CLI / 客户端。

切勿把 auth.json 提交 Git 或发到聊天软件。

手写 config.toml 模板

固定网关、要进版本说明或团队文档时，手写比 GUI 更透明。完整字段见接入指南。

1. 1只改用户级文件；项目级 provider 会被忽略。
2. 2model_provider 与 [model_providers.xxx] 同名。
3. 3wire_api = "responses"；env_key 只写变量名。
4. 4export 密钥后新开终端验证。

连通性自检

先确认网关与 Key，再开 Codex，少把协议问题误判成「模型坏了」。

1. 1对邮件/控制台给出的 base_url 发一次带 Bearer 的请求（具体路径以发放说明为准，常见为 models 或 responses）。
2. 2401 → Key / 权限；404 → 路径或协议；TLS/超时 → 网络或域名。
3. 3通过后再 login 或在 CC Switch 启用。

shell 多环境切换

官方 Key 与兼容网关并存时，用函数切换 export；长期多套仍更推荐 CC Switch 或 Codex --profile。

1. 1在 ~/.zshrc 为每个 API 写函数：export 不同 KEY（及可选辅助变量）。
2. 2执行函数后新开 Codex 会话。
3. 3若使用自定义 provider，确保 env_key 指向你刚刚 export 的那个名字。