AI Agent / 系统课时

配置 config.toml

配置 config.toml

每次启动都重复选择模型、权限和搜索方式容易产生不一致。本课将在用户级 ~/.codex/config.toml 中设置安全默认值,并用单次命令覆盖验证配置,而不把敏感凭据写入文件。

学习目标

  • 找到用户级与项目级 Codex 配置文件
  • 设置模型、推理、审批和沙箱默认值
  • 使用命令行覆盖验证某个配置项

选择正确配置位置

用户级配置位于 ~/.codex/config.toml,适合个人默认模型、审批与通用偏好;仓库内 .codex/config.toml 适合可信项目的局部设置。CLI 与 IDE 扩展共享这些配置层。

不要在 config.toml 中直接保存 API 密钥、访问令牌或业务密码。凭据应使用登录存储、环境变量或专门的密钥机制,项目配置也不应尝试覆盖机器本地的认证与提供商设置。

写入安全默认值

下面是一份可直接修改的用户级示例。模型名称应先通过当前 Codex 模型选择器确认。

toml
model = "gpt-5.6-terra"
model_reasoning_effort = "medium"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
web_search = "cached"
personality = "pragmatic"

[sandbox_workspace_write]
network_access = false

[history]
persistence = "save-all"
max_bytes = 104857600

这份配置让 Codex 默认在工作区内写入,网络保持关闭,需要越界操作时请求批准,并限制历史文件最大容量。不同版本支持的键可能变化,修改后应以当前配置参考和启动状态为准。

用单次覆盖验证

不改文件也可以通过 --config 临时覆盖任意键。下面把推理强度改为高,并保持其他默认值不变。

bash
codex --config 'model_reasoning_effort="high"' "显示当前模型、推理强度、沙箱和审批策略,然后退出,不要修改文件。"

预期结果应反映用户配置与本次覆盖,其中推理强度为 high:

text
model: gpt-5.6-terra
reasoning: high
sandbox: workspace-write
approval: on-request

如果启动失败,先检查 TOML 字符串是否使用双引号、表名是否正确,以及同一个键是否被重复定义。排查时可逐项注释新配置,找到最小失败项,再查阅当前版本配置参考。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 config.toml

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通