结论先说
-c/--config是最高优先级的临时覆盖开关。通过codex -c key=value传入的参数仅对当次进程生效,不会写回磁盘上的config.toml,优先级高于项目级.codex/config.toml、独立--profile与用户默认配置。- 嵌套配置用点号定位,值按 TOML 语法解析。可在一条命令里多次追加
-c;传字符串或数组时需用外层引号包住,防止 Shell 提前吃掉双引号或方括号。 CODEX_HOME决定 Codex 的完整配置根目录。默认读取~/.codex(Windows 为%USERPROFILE%\.codex),指定CODEX_HOME=/自定义路径后,config.toml、<name>.config.toml、auth.json和本地会话数据都会落到新目录,实现零串扰隔离。- 单次覆盖与多目录隔离可组合使用。既可以先用
CODEX_HOME锁定一整套企业或 CI 目录,再叠加-c针对单次任务微调参数;但两者都不可绕过管理员requirements.toml强制策略。 - 多环境并行跑代码代理容易叠加消耗配额。国内若无外币银行卡或支付受阻,可在本站自助开通 ChatGPT Plus 或高额度 ChatGPT Pro,团队多席位管理也可了解 ChatGPT Business 团队定制。

图:本站根据 OpenAI Codex 官方文档:Command line options 整理的示意图
本文根据 OpenAI Codex 官方文档《Command line options》《Advanced Configuration》《Environment Variables》整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 只想在某一次命令里临时切换模型、推理强度或权限策略,不想动主配置文件
~/.codex/config.toml的开发者; - 同时维护个人项目、公司受控仓库和自动化流水线,需要把配置、认证凭据和会话记录彻底分仓隔离的人;
- 在 Bash 或 Windows PowerShell 下传
-c嵌套数组参数老是报 TOML 解析错误的 CLI 用户。
一、-c / --config 临时覆盖语法与跨终端引号避坑
官方命令行选项(完整列表可对照 /guides/codex-cli-commands-cheatsheet)提供了 -c(全称 --config)标志,用于在启动交互式 TUI 或非交互子命令 codex exec 时动态改写任意合法 config.toml 键。新版 Codex CLI(0.164.0 及之后版本)已修复多级子命令下 -c 覆盖参数丢失的问题,可以放心地与 exec、review 等子命令串联使用。
常见覆盖写法如下:
bash
# 1. 临时切换推理强度与审批策略(可重复传多个 -c)
codex -c 'model_reasoning_effort="high"' -c 'approval_policy="on-request"'
# 2. 覆盖嵌套表字段(关闭 TUI 动画)
codex -c 'tui.animations=false'
# 3. 覆盖数组字段(收紧子命令可见的环境变量)
codex -c 'shell_environment_policy.include_only=["PATH","HOME"]'
# 4. 配合非交互管道命令临时改写只读策略
git diff --cached | codex -c 'sandbox_mode="read-only"' exec "审查本次暂存改动"
在终端传参时,跨平台引号转义是最常见的报错来源:
- macOS / Linux(Bash / Zsh):推荐最外层一律用单引号包裹整个
key=value,内部字符串与数组元素使用标准 TOML 双引号,Shell 不会展开$或剥离"。 - Windows PowerShell:单引号同样能阻止变量展开,但在传给外部原生可执行程序时,PowerShell 5.1 对嵌套双引号的处理较容易吞字符。本站建议优先使用 PowerShell 7+,或者对包含双引号的 JSON/TOML 数组使用
--%停止解析符或显式反斜杠转义,也可以直接把复杂结构存进独立 Profile 文件。
如果还不确定某项配置在 config.toml 中的准确键名与层级,可先翻阅 /guides/codex-config-toml-complete-guide。
二、用 CODEX_HOME 实现多账号、多场景彻底隔离
-c 解决的是「单次参数微调」,而如果你在同一台电脑上既要登个人订阅写业余项目,又要登公司账号跑受控仓库,或者在 CI 里希望每次都从空白配置启动,就需要靠 CODEX_HOME 环境变量切换整个主目录。

图:本站根据 OpenAI Codex 官方文档:Environment Variables 整理的示意图
改变 CODEX_HOME 后,以下资产会自动与默认 ~/.codex 物理分开:
- 主配置与独立 Profile:
$CODEX_HOME/config.toml与$CODEX_HOME/<name>.config.toml; - 认证凭据:独立的
auth.json会话登录状态,切换目录即切换对应账号(常规单目录切号流程见 /guides/codex-cli-switch-account-logout); - 全局指令与本地数据:目录内专属的全局
AGENTS.md、技能配置以及会话数据库记录。
实战示例:分离个人环境与工作环境(本站建议)
在 macOS / Linux 下,可以在 ~/.zshrc 或 ~/.bashrc 中定义轻量封装函数,避免全局 export CODEX_HOME 误伤其他终端标签页:
bash
# 首次初始化工作目录并登录公司账号
mkdir -p ~/.codex-work
CODEX_HOME="$HOME/.codex-work" codex login
# 在 ~/.zshrc 中封装一键命令(本站建议)
codex-work() {
CODEX_HOME="$HOME/.codex-work" codex "$@"
}
在 Windows PowerShell 中,同样建议仅在函数作用域内临时设置环境变量,结束后恢复,避免污染当前会话:
powershell
function codex-work {
$prev = $env:CODEX_HOME
try {
$env:CODEX_HOME = "$env:USERPROFILE\.codex-work"
codex @args
} finally {
if ($null -eq $prev) { Remove-Item Env:CODEX_HOME -ErrorAction SilentlyContinue }
else { $env:CODEX_HOME = $prev }
}
}
实战示例:CI / 临时实验用完即焚隔离
bash
TMP_HOME="$(mktemp -d)"
CODEX_HOME="$TMP_HOME" codex -c 'approval_policy="never"' exec "检查构建产物目录结构"
rm -rf "$TMP_HOME"
这种做法确保流水线不读取宿主开发者本地的 MCP 配置和个人指令文件,若在无交互容器里提示缺少密钥,可结合 CODEX_API_KEY 与 /guides/codex-missing-environment-variable 一起排查。
订阅与账号准备提示:若使用多个CODEX_HOME分别承接高频开发与自动化脚本,每个账号的 5 小时滚动限额与周配额独立计算(规则见 /guides/codex-usage-limits)。个人主力号如需更高额度,可在本站升级 ChatGPT Pro 充值 或选择 ChatGPT Pro 5x iOS 可覆盖档;新注册独立工作号在短信核验环节受阻时,可查看 Codex 注册手机验证服务。
三、-c、--profile 与 CODEX_HOME 怎么选不踩坑
三者并非互斥关系,按变化频率分工最清晰:
- 只改一次的参数用
-c:比如临时把推理强度调高一次、单次关闭动画或收紧环境变量白名单。 - 同一账号下高频切换的模式用
--profile:共享同一个登录态与基础 MCP,只切换模型和沙箱档位。 - 不同账号、不同组织合规边界或干净 CI 环境用
CODEX_HOME:彻底隔离auth.json、会话记录和全局AGENTS.md。
另外要留意:在已设置 CODEX_HOME 的终端里直接运行 codex --profile review 时,Codex 会在 $CODEX_HOME/review.config.toml 中查找文件,而不会再去读取默认 ~/.codex/ 下的同名文件。
常见问题
问:运行 codex -c model=gpt-5 报错无法解析值,是什么原因?
答:-c 等号右侧按 TOML 语法解析,字符串值需要带双引号,但直接写 model="gpt-5" 会被 Shell 在传给程序前剥掉双引号。改写成单引号包双引号的 codex -c 'model="gpt-5"' 即可正常解析。
问:设置 CODEX_HOME 之后,为什么以前安装过的 MCP 服务和历史聊天都看不见了?
答:这是目录隔离的正常效果。CODEX_HOME 指向全新文件夹后,Codex 会从新目录读取独立的 config.toml 与会话存储;如需复用原有 MCP 配置,把对应 [mcp_servers.*] 段落复制到新目录的 config.toml 即可。
问:国内没有外币信用卡,或者公司需要开增值税发票报销,怎么开通跑 Codex CLI 的订阅?
答:可在本站 AI 会员充值总览 选购 ChatGPT Plus或高配额 ChatGPT Pro,多成员研发团队可咨询 ChatGPT Business 团队定制。支持支付宝、微信支付及 AlipayHK,自助兑换无需交出账号密码,并支持开具增值税发票;实时价格以页面展示为准,售后执行掉订阅按剩余天数折退、封号不在质保范围的政策。
相关教程
- Codex config.toml 配置文件完整指南
- Codex 命令行常用命令一页看
- Codex CLI 如何切换账号与退出登录
- Codex 报 missing environment variable 怎么办
参考资料
- OpenAI Codex 官方文档:Command line options — https://learn.chatgpt.com/docs/developer-commands
- OpenAI Codex 官方文档:Advanced Configuration — https://learn.chatgpt.com/docs/config-file/config-advanced
- OpenAI Codex 官方文档:Environment Variables — https://learn.chatgpt.com/docs/config-file/environment-variables
- OpenAI Developers 文档:Codex CLI Reference — https://developers.openai.com/codex/cli/reference
0 条评论
还没有评论,来抢沙发~