优化你的Codex配置，让工作更轻松
最近，Codex的功能更新速度真的是飞快，它的配置文件字段数量也在不断增加。
我粗略统计了一下，已经超过90个字段了。手动管理这些TOML文件可不简单，特别是嵌套结构里藏着的那些小错误，真是让人头疼。而且，原本可以专注于编写代码的时间，却被翻阅文档和调整格式消耗了。
所以，很多人干脆选择了最省事的办法，直接用默认配置。说实话，这样也能用，但你只是在用一个基础版的Codex，而不是一个真正为你的工作量身定制的版本。
那么，合理的配置到底是什么呢？
我给你举几个例子：你可以根据不同的工作流程切换不同的推理模式，或者在规划阶段使用顶级模型来做决策，而在执行阶段切换到更快、更便宜的开源模型，这样不仅能提高效率，还能降低成本，一举两得！
当然，Codex的优化配置远不止这些。我为了能够充分利用Codex的潜力，特别创建了一个可视化的Codex配置网站，让大家更方便地理解每个字段的意义，轻松编辑字段，并同步生成Codex规范和详细的TOML配置文件。
这个网站提供了包括Codex基础配置、高级配置、集成与扩展等全方位的配置字段。
你不需要从头开始，网站上有方便的默认示范可以载入，还支持一键下载和复制标准配置文件，直接用Codex的配置目录就可以搞定。
轻松掌握Codex配置，AI对话不再难
而且呢，这里还提供了一个基于llms.txt标准格式的AI Schema，你只要引用它，就能在AI对话中当作上下文使用，实现自动编辑，真是太方便了。
当然，在你开始对话之前，还是得先搞懂Codex的配置有哪些功能，以及各字段的含义。不然提问的时候可能会遇到困难。建议你先在网站上浏览一下这些字段，然后再结合自己的需求进行配置。
为了解决这个问题，我们每个字段都配上了相应的中文名称，并且后面还加了注解，方便你理解。
你只需点击问号标识，就能查看每个字段的详细解释，简单明了。
对于那些比较复杂的配置字段，我们还准备了相关的文章教程，帮助你更好地理解。
一、全局配置路径
如果你没有这个文件，那就自己动手创建一个吧：
这里是你需要的代码块：
Codex 的本地状态一般是存放在指定的目录下，默认路径是这样的：里面通常会有一些常见的文件，比如日志、缓存等等。
二、项目级配置路径
在项目的根目录下，你可以放置如下文件：
这是你用得着的代码块：
举个例子：
项目级的配置文件只有在 Codex 认可这个项目之后，才会被加载。
Codex 会从项目的根目录开始，逐层向当前目录查找配置文件，越靠近你当前的位置，优先级就越高。
三、配置优先级
从高到低的加载顺序
简单来说，加载的规则是，之前的配置会优先于后面的。
4. 基础配置推荐
你可以先试着这样设置：
# ~/.codex/config.toml
model = "gpt-5.5"
model_reasoning_effort = "high"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
[sandbox_workspace_write]
network_access = true
writable_roots = [
"/Users/x/Desktop"
]想要了解的字段，可以直接在配置网站上查询，这里给你补充一下解释：
model = "gpt-5.5"设置默认模型的时候，这里指的是 gpt-5.5。
approval_policy = "on-request"这表示在进行危险操作或权限升级时，会提示你确认。
目前官方推荐的交互方式是 on-request，而 on-failure 已经不再使用了。
sandbox_mode = "workspace-write"这就意味着 Codex 有权在当前工作区进行操作，但系统权限并不会完全放开。sandbox_mode 支持 read-only、workspace-write、danger-full-access。
5. 如果你想减少确认
最简单的配置如下：
model = "gpt-5.5"
model_reasoning_effort = "high"
approval_policy = "never"
sandbox_mode = "workspace-write"
[sandbox_workspace_write]
network_access = true
writable_roots = [
"/Users/pan/Desktop"
]6. Profile 配置
如果你想要分成不同的模式，比如“日常开发”和“深度审查”，可以按照以下方式设置：
~/.codex/deep-review.config.toml内容：
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
approval_policy = "on-request"
sandbox_mode = "workspace-write"使用：
codex --profile deep-review
codex exec --profile deep-review "review this change"官方现在要求 profile 使用单独的文件，比如 ~/.codex/deep-review.config.toml，别再用老式的 [profiles.xxx] 了。
7. 最实用的目录结构
你可以参考这个结构：
~/.codex/
├── config.toml # 全局默认配置
├── auth.json # 登录/认证状态，可能也走系统钥匙串
├── history.jsonl # 历史记录
├── deep-review.config.toml # 深度审查 profile
└── logs / caches # 日志缓存在项目中：
your-project/
├── .codex/
│ └── config.toml # 项目专用配置
├── AGENTS.md # 项目规则、约定、执行说明
├── package.json
└── src/可视化配置网址：
https://codexapp.cc
榨干GPT！ChatGPT Web变身本地Codex，额度直接翻倍
打脸Claude Code！Codex 全端支持第三方模型接入
把Claude Code的桌子掀翻！Codex现在提供一键搬家的功能！
虽然Fable 5下架了，但它的工作流已经被Codex接手了！
