codex 实际读取的配置目录是固定位置且受 codex_home 环境变量影响:linux/macos 为 ~/.codex,windows 为 %userprofile%.codex;必须在此目录下创建并编辑 utf-8 编码的 config.toml,其他路径(如插件目录)无效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

国内用户配置 Codex 第三方 API 时,最常卡在第一步:根本找不到真正生效的 config.toml 文件,结果改了假路径、配了无效字段,终端报错却查不出原因。
确认 Codex 实际读取的配置目录
不要凭直觉搜索“codex config”或翻遍安装目录——Codex 只认一个固定位置,且受环境变量影响。
在你准备运行 codex 命令的同一终端中,执行:
Linux/macOS:echo ~/.codex
Windows PowerShell:$env:USERPROFILE + "\.codex"
如果设置了 【CODEX_HOME 环境变量】,则配置目录会变成该变量指向的路径,而不是默认路径。这一步跳过,后面所有配置都会失效。
打开或创建 config.toml 文件
进入上一步确认的真实目录,检查是否存在 config.toml。
若不存在,直接新建:
Linux/macOS:touch ~/.codex/config.toml
Windows(PowerShell):New-Item -Path "$env:USERPROFILE\.codex\config.toml" -ItemType File
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
用任意文本编辑器打开它。注意:不能用 Word 或记事本(编码可能出错),推荐 VS Code、Notepad++ 或系统自带的 nano/vim/记事本(Windows)。
config.toml 的标准存放路径对照表
不同系统下,Codex CLI 和桌面 App 共享同一配置目录:
macOS / Linux: ~/.codex/config.toml
Windows: %USERPROFILE%\.codex\config.toml(即 C:\Users\用户名\.codex\config.toml)
⚠️ 注意:某些教程提到的 “插件安装目录下的 config.toml” 是错误路径,Codex CLI 完全不读取那里。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










