个人默认、项目覆盖、一次性 CLI

~/.codex/config.toml 放个人习惯,.codex/config.toml 放仓库行为,CLI 只覆盖这一次。

推荐分工:

  • 个人~/.codex/config.toml(模型、主题、个人 MCP、默认推理强度)
  • 项目.codex/config.toml(仅受信任项目加载)
  • 一次性codex -c key=value--sandbox / --model

优先级从高到低:

  1. CLI 与 --config
  2. 从仓库根走向 cwd 的项目 .codex/config.toml(靠近的赢;只在受信任项目加载)
  3. 选中的 profile 文件(~/.codex/<name>.config.toml
  4. 用户配置 ~/.codex/config.toml
  5. 登录后下发的云托管 config.toml 默认值
  6. 系统 /etc/codex/config.toml(Windows 对应 %ProgramData%\OpenAI\Codex\
  7. 内置默认

把目录标成未信任时,项目层的 .codex/(含 config、hooks、rules)整层跳过,用户和系统配置仍在。企业天花板另走 requirements.toml,不是这一条覆盖链。

CLI、IDE 扩展和桌面 App 共用这些层。

来源