Codex 配置文件路径快速对照
前三名页面普遍先回答路径。这里把默认位置、覆盖规则和认证文件一次分清。
%USERPROFILE%\.codex\config.toml。PowerShell 先检查 $env:CODEX_HOME，有值时改看该目录下的 config.toml。~/.codex/config.toml。先检查 $CODEX_HOME；如果没有设置，再检查当前用户的 .codex/config.toml。~/.codex/config.toml；服务器上先确认运行 Codex 的系统用户，再检查 CODEX_HOME。auth.json 是认证存储，不等同于常规配置文件。适合谁，不适合谁
开始前准备
- 当前控制台给出的 Base URL、模型名和 Codex 配置说明。
- Codex CLI 版本与
codex doctor可用。 - 现有配置文件备份；不要覆盖用户其他 provider 设置。
- 一个安全的最小测试目录。
完整步骤
30 秒定位并备份配置文件
先检查 CODEX_HOME，未设置时再用默认用户目录；确认文件路径后复制一份备份，再用纯文本编辑器打开。Windows 可运行 Test-Path $env:USERPROFILE\.codex\config.toml，macOS/Linux 可运行 test -f ~/.codex/config.toml；不要凭资源管理器里看到的同名文件猜测。
确认 provider 名称一致
顶层 model_provider = "api" 必须能找到 [model_providers.api] 区块；名称不同会导致选择错误。
填写当前 Base URL 与协议
不要重复附加路径。本文核验环境使用 wire_api = "responses"，其他服务或版本应按当前说明调整。
填写控制台当前模型名
把占位符替换为当前可用模型标识，不根据品牌名称自行猜测。
诊断并执行最小任务
运行 codex doctor --summary、codex login status，再用一个只读任务确认真实响应。
本机已验证结构的配置示例
MODEL_FROM_CONSOLE 必须替换；不要把 API Key 写入此代码块。
model_provider = "api" model = "MODEL_FROM_CONSOLE" [model_providers.api] name = "api" base_url = "https://api.xiao-he.top" wire_api = "responses" requires_openai_auth = true
model_provider 写成 api，但 provider 区块命名为 third_party。
model_provider 与 [model_providers.api] 使用同一个名称，并从控制台复制其他字段。
怎样判断结果是否可用？
先检查名称映射和 TOML 语法，再检查远端认证；不要同时修改多个 provider。
常见问题与报错
TOML 解析错误
检查引号、区块名、重复键和不可见字符；使用纯文本编辑器保存 UTF-8。
修改后仍使用旧 provider
确认顶层 model_provider，检查是否通过 profile 或命令行 -c 覆盖了配置；重新运行上面的路径检查，确认改的是当前用户实际读取的文件。
Base URL 重复路径
例如控制台已包含版本路径时不要再次附加；以服务提供的完整示例为准。
模型名无效
重新从当前控制台复制可用标识；不要把展示名称、套餐名称或旧文章名称当模型 ID。
完成后的检查方法
- 配置文件修改前已有备份。
- model_provider 与 provider 区块名称一致。
- Base URL、模型名和协议来自当前控制台或文档。
- 配置文件和仓库中没有完整 API Key。
- doctor 和 login status 已通过检查。
- 已运行真实最小任务，而不是只检查语法。
FAQ
config.toml 在 Windows 哪里？
通常位于 %USERPROFILE%\.codex\config.toml；例如 C:\Users\你的用户名\.codex\config.toml。
macOS 和 Linux 的 Codex 配置文件在哪里？
默认都是 ~/.codex/config.toml。如果设置了 CODEX_HOME，实际位置会改为该目录下的配置文件。
API Key 应该写进 config.toml 吗？
本文不建议在公开示例或可同步配置中写入完整 Key，应使用 Codex 认证流程并保护凭证存储。
为什么 provider 名称可以叫 api？
它是本地配置标识，可以自定义，但顶层引用和区块名称必须一致。
Responses 协议永远固定吗？
不能这样假设。本文只记录当前核验环境，其他版本和服务以当前说明为准。
资料来源与版本说明
- OpenAI Codex configuration reference
当前网络无法抓取正文，关键命令和本机 provider 字段另由当前 CLI 与脱敏配置核验。
- OpenAI Codex CLI reference
用于复核配置覆盖和诊断命令的最新说明。
从控制台复制当前字段，再修改配置。
不要照抄旧模型名或猜接口路径；修改后完成登录、doctor 和只读任务三层检查。 模型、价格、额度与规则以对应业务站当前展示为准。
进入小贺API复制配置