正文预览
最后核对
官方资料最后核对日期：2026-09-02。本文参考 OpenAI Codex 配置参考资料。社区工具资料最后核对日期：2026-09-02，参考 Codex++、CCX 与 CC Switch。
Codex 默认最稳妥的使用方式，是通过官方 ChatGPT / OpenAI 账号登录，并使用官方支持的模型与服务。连接第三方 API 属于进阶配置，适合已经理解 config.toml、API Key、Base URL、模型名和代理网关含义的用户。如果你希望更方便地接入和切换不同模型，也可以通过 packyapi 这类 API 聚合平台进行统一配置。
第三方 API 风险
本文只整理接入思路，文中提到的第三方平台仅作接入示例，不代表对服务质量、安全性或合规性的背书。第三方 API 可能涉及账号安全、API Key 泄露、账单超额、服务稳定性、日志留存、数据跨境、模型能力降级和合规风险。请只使用你信任、能承担责任的服务，并避免把密钥写进截图、仓库和公开文档。
方案
适合谁
优点
需要注意
手动配置
想理解 Codex 底层配置的人
透明、可控、方便排障
要自己维护 config.toml，字段写错就不生效
Codex++
主要使用桌面 App，希望图形化管理中转注入的人
有管理界面，能把配置写成 CodexPlusPlus provider
是第三方 launcher / 注入工具，Codex 更新后可能需要跟进适配
CCX + CC Switch
有多个供应商、需要协议转换和统一切换的人
CCX 负责网关与路由，CC Switch 负责供应商配置管理
组件更多，需要理解本地服务、端口、密钥和代理链路
如果你只是刚开始学习 Codex，可以先知道有这条路线，之后完成 第一个任务 再回来看细节。第三方 API 不是入门必需步骤。
这种是没办法使用 Codex APP 的插件功能的，可以看看方案二可以使用插件功能。
手动配置的核心，是编辑本机的：
~/.codex/config.toml
改之前先备份：
cp ~/.codex/config.toml ~/.codex/config.toml.backup
cp ~/.codex/auth.json ~/.codex/auth.json.backup
思路
怎么理解
适合场景
ChatGPT 登录
Codex 仍使用 ChatGPT / OpenAI 登录态，provider 只改请求入口或中转地址
想保留官方账号能力，同时把请求转到兼容入口
API Key 登录
Codex 使用环境变量里的 API Key，按 provider 配置请求接口
用 OpenAI API Key 或自建兼容 Responses API 的服务
不要同时混着改