设置与 config.toml：
把常用选择写成默认值

文件放在哪

最常用的是前两份：你自己的一份，项目里的一份。第三种 profile 文件是命令行用的。

~ 是你的用户主目录。Windows 上的桌面 App 用的是 %USERPROFILE%\.codex。CLI 和 IDE 扩展会跟着环境变量 CODEX_HOME 走（第 8 节）；桌面 App 以你的 App 为准。

TOML 只要会三样

config.toml 用的是 TOML 格式，比 JSON 好写。看懂下面这几行就够用了：

# 井号开头是注释
model_reasoning_effort = "high"   # 键 = 值；文字要加双引号
web_search = "cached"

[sandbox_workspace_write]         # 方括号是"表"，下面的键都属于它
network_access = true             # true / false 不加引号

1. 键 = 值：文字值加双引号；true / false 和数字不加。
2. [表名]：它下面的键都归这个表，一直到下一个 [...] 为止。所以上面那个 network_access，完整的名字是 sandbox_workspace_write.network_access。
3. 不属于任何表的键，要写在所有 [表] 前面。官方的示例文件开头就这么提醒。写到某个表下面，它就被算成那个表里的键了（第 10 节有这个坑）。

设置面板用 Cmd+,（Windows 上 Ctrl+,）打开，也可以从 App 菜单进。下面按"写在 config.toml 里的"和"App 自己的偏好"分开列。

"Follow-up behavior"是 Codex 工作时你再发消息，是插话还是排队（第 2 课）。IDE 扩展里对应的是编辑器设置 chatgpt.followUpQueueMode，它也不写进 config.toml。

六个键一览

第 1 层和第 3 层都要在命令行里启动时带上（第 7 节）。第 5 层要你登录的工作区下发了才有，第 6 层要电脑上有这个文件才有，个人电脑上这两层通常是空的。

项目配置的三条规矩

1. 只在信任的项目里加载。没信任的项目，整个项目的 .codex/ 层都跳过：项目配置、项目里的 hooks、rules 一起不加载；你的用户配置和系统配置照常加载。
2. 可以有好几份，越近越优先。Codex 从项目根目录一路找到当前目录，每个 .codex/config.toml 都读；同一个键写了好几次，离当前目录最近的那份赢。里面写的相对路径，按它所在的那个 .codex/ 文件夹来算。
3. 有些键写在项目里不算数。会改变"请求发到哪、用哪个模型提供方、凭据怎么给、通知和遥测跑什么命令、选哪个 profile"的键，项目配置改不了。Codex 会忽略它们，启动时给出警告：openai_base_url、chatgpt_base_url、apps_mcp_product_sku、model_provider、model_providers、notify、profile、profiles、experimental_realtime_ws_base_url、otel。这些写在用户配置里。

[projects."/Users/you/order-admin"]
trust_level = "trusted"   # 或 "untrusted"

画面为教学示意：对话内容、路径和提交号是虚构的，"要信任 order-admin 吗？"卡片也是示意；配置键、加载规则、.codex 文件夹存在后才受保护，与官方文档一致。

profile：存一组设置，要用时再选

比如你想要一个"深度审查"档：推理强度高、只读、有事就问。把和平时不一样的几项单独存成一个文件：

model_reasoning_effort = "high"
sandbox_mode = "read-only"
approval_policy = "on-request"

codex --profile deep-review
codex exec --profile deep-review "审一下这次改动"

• 它是第 3 层：盖在用户配置上面、项目配置下面。所以只写和平时不一样的几项就行，其他的照用户配置。
• 文件名就是 profile 的名字，只能用字母、数字、- 和 _。
• 文件里直接写顶层的键，不要再套一层 [profiles.deep-review]。

-c：只改这一次

codex -c model_reasoning_effort='"high"'
codex -c sandbox_workspace_write.network_access=true
codex --enable memories      # 等于 -c features.memories=true

• -c 和 --config 是一回事，是第 1 层，优先级最高，只管这一次运行。
• 值按 TOML 解析，所以文字值写成 '"high"'：里面的双引号是给 TOML 的，外面的单引号防止 shell 把它拆开。解析不了的，Codex 就当成一段文字。
• 表里的键用点号连起来写，比如 sandbox_workspace_write.network_access。
• 有专门参数的优先用专门参数：--model、--sandbox、--profile、--search。

[features] 与成熟度

[features]
memories = true    # 打开实验功能 Memories
hooks = false      # 关掉钩子

不写的键就是默认值。命令行里 codex --enable 名字 临时打开；终端界面里的 /experimental 可以勾选实验功能，选择会存进配置，重启后生效。

环境变量

分工很简单：长期的设置写 config.toml；只在某个终端、某次自动化里用的，或者密钥、诊断开关，用环境变量。

官方列出读取 CODEX_HOME 的是 CLI、IDE 扩展、app-server 和安装脚本。在 WSL 里用 CLI 时，它默认用 Linux 的家目录，不和 Windows 上的 App 共享配置；想共享，把 CODEX_HOME 指到 Windows 那边的 .codex（专题 B）。

openai_base_url = "https://us.api.openai.com/v1"

管理员的 requirements.toml

公司电脑上，管理员可以放一份 requirements.toml。它不在那 7 层里：7 层给的是"默认值"，它给的是"不准"。比如不许 approval_policy = "never"、不许 danger-full-access、限定网页搜索的模式、限定能开哪些 MCP 服务器。不管你在哪一层写了被禁止的值，客户端都会换成一个允许的值，并提醒你。权限菜单里不可选的档位，也可能是它限制的。

进阶：只放行 npm 的域名

第 6 节给 order-admin 打开了联网，但那是"想连哪就连哪"。想只放行 npm 的仓库，可以再加实验功能 network_proxy：

[sandbox_workspace_write]
network_access = true

[features.network_proxy]
enabled = true
domains = { "registry.npmjs.org" = "allow" }

两个开关缺一不可：network_access 决定能不能联网，network_proxy 决定按名单过滤。只开后者，网络还是关的。它只管命令发出的请求，不过滤网页搜索、MCP 这些工具。

改了没生效？