这页面向正在搜索 Codex config.toml 配置、Codex auth.json 配置、Codex config.toml proxy、Codex 配置不生效 的用户。
如果你使用 Code8 Manager，通常不需要手动编辑这些文件。Manager 会把 API Key 写入本机 Codex 可读取的配置中。
两个文件分别负责什么
config.toml 通常负责模型、服务地址、权限、代理、MCP、项目规则等配置。
auth.json 通常负责认证相关信息，例如 API Key 或登录凭证。不要公开这个文件，也不要把它提交到代码仓库。
有些搜索结果会提到 settings.json。在 Codex 的常见配置里，优先核对 config.toml 和 auth.json；如果你是在 VS Code、其他编辑器或第三方插件里看到 settings.json，那通常是该工具自己的设置文件，不一定等同于 Codex 本机配置。
auth_mode 和 device code auth
auth.json 里可能出现认证方式相关字段。搜索 device code auth 或 login with API Key 时，要先分清你走的是账号登录还是 API Key 调用：
- 账号登录通常依赖浏览器授权或设备码流程
- API Key 调用依赖密钥和兼容 API 地址
- 第三方 API 或中转 API 通常还需要
openai_base_url
不要手动拼接不理解的 refresh token、device code 或 auth 字段。需要 API Key 时，优先从控制台创建并通过 Manager 保存。
Windows 常见位置
Windows 用户通常先检查：
%userprofile%\.codex\config.toml
%userprofile%\.codex\auth.json
如果你在项目目录里也放了 .codex/config.toml，项目级配置可能覆盖用户级配置。
openai_base_url 怎么理解
openai_base_url 是 Codex 连接兼容 API 服务的地址。使用第三方 API 或中转 API 时，API Key 和 openai_base_url 必须匹配同一个服务商。
如果服务商要求 /v1 后缀，就不要漏掉。不同服务商字段格式可能不同，按当前服务商文档为准。
proxy 配置和系统代理
如果你配置了代理，先确认目标是什么：
- 让 Codex 访问外网
- 让浏览器访问外网
- 让本地 Manager 和 Codex 通信
不要把 127.0.0.1、localhost 这类本地地址错误地送进代理。否则可能出现本地页面打不开、Manager 无法连接、配置保存后无效等问题。
配置不生效的常见原因
- 改错了文件路径
- 项目级配置覆盖用户级配置
- TOML 或 JSON 格式错误
- API Key 前后有空格
- 修改后没有重启 Codex App、Codex CLI 或终端
- 使用了不匹配的 Base URL 和 API Key
推荐做法
新用户优先用 Code8 Manager 保存 API Key。只有当你明确需要第三方 API、代理、MCP 或 CLI 高级配置时，再手动编辑 config.toml。