CODEXGUIDE / 进阶专题

config.toml 配置指南

从默认配置到项目级覆盖,理解 Codex 的 config.toml 如何影响模型、沙箱与审批策略。

先从最小配置开始

配置文件应只保留团队确实需要固定的选项。先完成一次可回滚的任务,再根据重复出现的偏好补充配置。

把个人偏好放在用户级配置,把仓库协作约定放在项目说明文件中,避免把机器路径和密钥提交到 Git。

  • 修改前保留原文件并查看 diff。
  • 敏感值使用环境变量或凭据管理器。
  • 每次改动后用一个小任务验证实际生效。

与快速上手衔接

如果还没有稳定的本地工作流,先完成首次安装、登录并打开项目,再逐项调整配置。