Codex 配置文件入门：用 config.toml 一次设好模型、搜索和快捷键

Codex 用久了，每次都要手动切模型、调推理强度、改快捷键，会觉得麻烦。其实这些都可以写进配置文件 config.toml，一次设好，以后命令行和编辑器插件都按这个来。本文按 OpenAI 官方文档，讲清楚配置文件放在哪、谁的优先级高，以及最常改的几项怎么写。

配置文件放在哪

Codex 的配置分两类：

• 个人配置：~/.codex/config.toml，对你电脑上的所有项目生效。
• 项目配置：在项目里新建 .codex/config.toml，只对这个项目（或这个子目录）生效。出于安全考虑，只有你标记为「信任」的项目，Codex 才会读取项目里的 .codex/ 配置。

命令行（CLI）和编辑器插件共用同一套配置。在编辑器插件里，点右上角的齿轮图标，选 Codex Settings > Open config.toml 就能直接打开这个文件。

谁说了算：配置的优先级

同一个设置项可以写在好几个地方，Codex 按下面的顺序取值，越靠前越优先：

1. 命令行参数，例如 --model、-c / --config；
2. 项目里的 .codex/config.toml，从项目根目录一路到当前目录，离当前目录最近的那份优先；
3. 用 --profile 名称 选中的配置档；
4. 个人配置 ~/.codex/config.toml；
5. 工作区下发的默认值、系统配置，最后是内置默认值。

如果在公司电脑上用，管理员还可以通过 requirements.toml 设置限制，比如禁止关闭审批。限制比上面这些默认值更硬，个人配置改不了。

最常改的几项

默认模型和推理强度

model = "gpt-6.1-sol"
model_reasoning_effort = "medium"

model 决定默认用哪个模型，model_reasoning_effort 决定模型想得多深（在支持的模型上生效）。官方示例用的是 GPT-6.1 Sol，需要你的账号能用这个模型；用不了的话换成你能选的模型。

审批和沙箱

approval_policy = "on-request"
sandbox_mode = "workspace-write"

这两项决定 Codex 跑命令前要不要问你、能改哪些文件。各个取值的区别，本站之前的《Codex 权限设置教程：沙箱和审批模式怎么选》已经详细讲过，这里不再重复。

联网搜索

Codex 在本地对话里默认开启联网搜索，默认取值是 "cached"：结果来自 OpenAI 维护的搜索缓存，而不是直接抓取实时网页，这样能减少网页里夹带恶意指令的风险。可选的值有：

• "cached"（默认）：用搜索缓存；
• "indexed"：只有搜索索引放行时才访问外部网页；
• "live"：抓取最新网页，和命令行加 --search 一样；
• "disabled"：关掉搜索工具。

web_search = "live"

回答风格

想去掉内置的「性格」说明、让回答更干脆，可以写：

personality = "none"

注意旧的 friendly、pragmatic 已经不再起作用，/personality 命令也已经取消。

快捷键

终端界面的快捷键写在 tui.keymap 下面，例如：

[tui.keymap.global]
open_transcript = "ctrl-t"

[tui.keymap.chat]
interrupt_turn = "f12"

把某个操作设成空列表，就是取消它的快捷键。

快速模式

想让支持的模型回答得更快，可以把快速模式设成默认：

service_tier = "fast"

[features]
fast_mode = true

在命令行里也可以随时用 /fast 开关。快速模式会更快地消耗用量：官方文档写明，用会员自带额度时按标准速度的 2.5 倍计算，具体以官方页面为准。

配置档：一键切换整套设置

经常在「日常写代码」和「仔细审查」两种状态之间切换的话，可以用配置档（profile）。做法是为每种状态单独建一个文件，文件名是 ~/.codex/名称.config.toml，里面只写和个人配置不同的项：

# ~/.codex/deep-review.config.toml
model_reasoning_effort = "high"
approval_policy = "on-request"

用的时候加上 --profile：

codex --profile deep-review
codex exec --profile deep-review "review this change"

配置档名称只能用字母、数字、短横线和下划线。另外，从 0.134.0 起，config.toml 里的 [profiles.名称] 写法和顶层 profile = "名称" 都不再支持，以前这样写的要搬到单独的配置档文件里。

临时改一次：-c 参数

只想这一次换个设置，不用改文件：

codex --model gpt-6.1-sol
codex --config sandbox_workspace_write.network_access=true

能用专门参数（比如 --model）的优先用专门参数；其他项用 -c / --config，值按 TOML 格式解析，含空格的值记得加引号。

功能开关

可选和实验性的功能放在 [features] 表里，例如开启实验性的记忆功能：

[features]
memories = true

也可以在命令行用 codex --enable memories 临时开启。不写的功能保持默认值。

上手建议

先只在 ~/.codex/config.toml 里写两三项最常用的（模型、推理强度、联网搜索），用顺了再按需加快捷键和配置档。团队项目里，把大家都该一致的设置放进项目的 .codex/config.toml，个人习惯留在自己的个人配置里。

快速模式等功能需要用 ChatGPT 账号登录 Codex 才能用。还没有会员的，可以在 BuyBuy代充（buybuytopup.cn） 开通 ChatGPT Plus，开通后就能按本文把 Codex 调成顺手的样子。