Codex 不好用？那是你没有改这个11个配置！

最近我发现，同样是用 Codex，不同人的体验差距真的很大。

有的人已经让它写功能、修 Bug、补测试，甚至同时跑好几个任务；也有人用了几天后觉得：

Codex 还不如普通聊天机器人好用，离开人盯着就不会干活。

一开始我也觉得奇怪。

明明用的是差不多的模型和套餐，为什么一边已经用得飞起，另一边还在反复确认、任务跑偏、改完代码也不测试？

后来把设置和使用方式对比了一遍，发现很多时候不是 Codex 能力不行，而是默认配置根本没动。

一： 创建 AGENTS.md：让 Codex 读懂项目规则

这是我认为最重要的一项。

很多人每次打开 Codex，都要重复提醒：

• 不要修改无关代码；
• 项目使用 pnpm，不要换成 npm；
• 不要随便增加依赖；
• 修改后要运行测试；
• 不要碰 .env 和密钥文件。

这些要求不应该每次重新输入，而是应该写进项目的 AGENTS.md。

在项目根目录新建：

AGENTS.md

先放入一份基础规则：

# 项目开发规则

- 修改前先阅读相关文件和现有实现。
- 优先采用最小改动，不要重构无关代码。
- 不要随意增加生产依赖。
- 不要修改 `.env`、密钥和证书。
- 不要删除测试来绕过错误。
- 修改后运行测试、Lint 和类型检查。
- 最后总结修改内容、检查结果和剩余风险。

如果项目有固定的目录结构和技术栈，也可以继续补充：

## 项目约定

- 使用 pnpm 管理依赖。
- 接口请求统一放在 `src/api/`。
- 公共组件放在 `src/components/`。
- 公共类型放在 `src/types/`。
- 不要使用 `any`，除非说明原因。

这样 Codex 每次开始任务时，都能先看到项目规范。

简单理解：

• 全局 AGENTS.md：记录你的个人习惯；
• 项目 AGENTS.md：记录当前项目的开发规范；
• 子目录 AGENTS.md：记录某个模块的特殊要求。

某个问题如果已经提醒 Codex 两次，就别再口头重复了，直接写进规则里。

二： 调整权限模式：减少重复确认

打开：

设置 → 常规 → 权限

Codex 默认权限比较保守。

修改文件、运行命令、安装依赖或者访问网络时，可能会频繁弹出确认。如果每一步都需要人工点一下，任务自然很难连续执行。

建议按照项目风险来设置：

• 陌生项目：先使用只读模式；
• 日常开发：允许修改当前工作区；
• 系统级操作：需要时临时开启完全访问。

完全访问确实最省事，但它不只可以修改当前项目，还可能接触项目之外的文件。

所以我不建议所有人长期无脑开启最高权限。

比较稳妥的做法是：日常使用工作区权限，重要项目开始前先提交一次 Git。就算 Codex 改错了，也方便随时恢复。

三：跟进行为改成“引导”

进入：

设置 → 常规 → 跟进行为

这里通常有两种模式：

• 排队；
• 引导。

默认的“排队”模式，会等当前任务全部执行结束后，再处理你新发的消息。

问题是，Codex一旦方向跑偏，你只能等它改完，再重新返工。

改成“引导”以后，任务执行到一半也可以随时插话纠正。

例如它正在重构整个页面，但你只是想修改一个按钮，可以直接说：

停一下，不要重构整个页面。

只修改登录按钮的样式，其他文件保持不变。

或者看到它准备安装新的依赖时，马上补充：

不要新增依赖，先检查项目里有没有可以复用的组件。

这个设置看起来很小，但能明显减少跑偏后的返工。

四： 复杂任务先做计划

Codex 经常不是不会写，而是开始写得太早。

例如你只说：

帮我给项目增加登录功能。

它可能立刻开始创建页面、修改路由、安装依赖。

但登录方式、权限逻辑、状态保存、页面跳转和接口情况都还没确定，越早动手，后面越容易推倒重来。

遇到重构、迁移、复杂 Bug 或者跨模块功能时，建议先让它规划：

先不要修改代码。

请先阅读项目结构、AGENTS.md 和相关文件，然后给出实施计划。

计划需要包括：

1. 当前问题和原因；
2. 需要修改的文件；
3. 具体实施步骤；
4. 可能影响的旧功能；
5. 测试方案和风险。

等计划确认后再开始修改。

简单任务可以直接做，复杂任务最好先计划。

提前花几分钟确认方向，往往能省下后面大量返工时间。

五： 强制测试和自我审查

很多人觉得 Codex 写出来的代码不稳定，是因为任务要求只写了“帮我完成这个功能”。

在 Codex 看来，文件修改完可能就代表任务已经结束。

但真正完整的开发流程，还应该包括：

• 运行相关测试；
• 执行 Lint；
• 执行类型检查；
• 查看 Git 差异；
• 检查是否误改无关文件；
• 判断有没有兼容性和回归风险。

建议把下面这段放进 AGENTS.md，或者在任务结束前发送：

完成修改后，请运行相关测试、Lint 和类型检查。

然后检查 git diff，确认没有修改无关文件。

最后总结：
1. 修改了什么；
2. 涉及哪些文件；
3. 检查结果如何；
4. 还有哪些风险。

如果支持代码审查命令，还可以在修改完成后使用：

/review

让 Codex 从 Bug、兼容性、安全性和回归风险几个角度，再重新检查一次代码。

不要只让 Codex 负责“写”，最好也让它负责“验”。

六： 调整个性化设置

打开：

设置 → 个性化

这里主要调整三项。

语气改成“务实”

默认的亲和语气，解释和客套内容会稍微多一点。

改成“务实”以后，回答通常会更直接，更适合写代码和执行任务。

打开记忆

记忆适合保存长期使用习惯，例如：

• 默认使用中文回答；
• 优先使用 pnpm；
• 修改前先分析；
• 不要随意重构；
• 完成后运行测试。

不过，具体项目规则还是应该写进 AGENTS.md，不要完全依赖记忆。

精简自定义指令

网上有不少现成的 Agent 指令，可以参考，但不建议看到几千字就整段复制。

规则太多、内容冲突，反而可能让 Codex 抓不住重点。

日常保留几条核心要求就够了：

回答直接，不要重复我的问题。

修改前先阅读相关文件。

复杂任务先计划，不要直接开写。

优先采用最小改动。

完成后运行测试并总结风险。

真正重要的是清楚、具体，而不是字数越多越好。

七： 管理好长会话

Codex 会话太长以后，会塞进大量内容：

• 终端日志；
• 报错信息；
• 多轮修改；
• 已经被推翻的方案；
• 过期的项目要求。

上下文一旦混乱，继续在原会话里硬聊，效果通常会越来越差。

遇到这种情况，可以：

• 选择“在新任务中继续”；
• 使用 Fork 开一条新路线；
• 使用 codex resume 恢复旧任务；
• 上下文彻底乱掉时，直接新建会话。

新会话里可以这样交接：

请先阅读 AGENTS.md、当前 Git diff 和相关代码。

之前的目标是修复登录状态丢失问题。

先总结已经完成的修改，再继续处理，不要重复修改。

很多时候，让 Codex 重新读取真实代码，比继续依赖一大段混乱的聊天记录更准确。

八： 开启电脑操控

进入：

设置 → 电脑操控

开启 Computer Use 和 Chrome 权限后，Codex 不只是修改代码，还可以操作本地应用和浏览器。

例如：

打开本地测试网站，完整走一遍注册和登录流程。

记录遇到的问题，再根据测试结果修改代码。

适合的场景包括：

• 测试网页功能；
• 检查页面显示；
• 操作本地开发工具；
• 重现用户反馈的问题；
• 修改代码后继续验证。

不过，电脑操控的权限比普通文件修改更敏感。

建议长期开放编辑器、终端和测试网站，邮件、网盘、支付后台、生产环境等敏感操作，仍然保留人工确认。

尤其是删除、提交、发送和付款这类动作，不要让 Codex 自动完成。

九： 使用任务搜索

Codex 用久以后，左侧任务列表很快就会堆满。

需要查找旧任务时，可以直接点击侧边栏上方的搜索按钮，不要再手动一条条翻。

任务标题也尽量写具体。

不要全部叫：

帮我看看
修复问题
新任务
测试一下

可以改成：

修复登录页面跳转循环
检查支付接口重复回调
解决移动端导航错位
重构用户权限判断

标题写清楚后，后面查历史任务会轻松很多。

十： 开启语音听写

进入：

设置 → 语音

设置好快捷键后，遇到复杂需求可以直接说，不用慢慢打字。

很多人打字时只会输入：

帮我修一下登录。

但真正有用的需求应该是：

登录页面偶尔会跳回首页。

请先检查路由守卫和登录状态初始化，不要修改后端接口。

只修复前端状态同步问题，完成后运行测试并说明原因。

语音听写最大的价值，不只是代替打字，而是让你更愿意把背景、限制和目标一次说完整。

上下文越完整，Codex 猜错需求的概率越低。

不过发送前最好检查一下文件名、变量名和英文框架名称，避免语音识别出错。

十一： 解决反复重新连接

如果 Codex 经常出现：

正在重新连接 1/5
……
正在重新连接 5/5

不一定是服务本身出问题，也可能是本地代理、公司网络或者网络软件不支持 WebSocket。

建议先检查：

1. Codex 是否已经更新；
2. 退出账号后重新登录；
3. 暂时关闭代理；
4. 更换网络测试；
5. 检查代理端口和 WebSocket 支持。

如果确定是 WebSocket 导致的，可以把下面这段交给 Codex：

请帮我修复 Codex 反复“正在重新连接”的问题。

先备份 ~/.codex/config.toml。

如果不存在 openai_http provider，请新增：

wire_api = responses
supports_websockets = false
requires_openai_auth = true

已有同名配置则跳过。

然后把 model_provider 修改为 openai_http。

不要覆盖其他配置，完成后告诉我修改了什么，以及如何恢复。

修改完成后，完全退出并重新启动 Codex。

这一项属于故障排查，不是每个人都需要设置，所以放在最后。

---

我现在常用的 Codex 工作流程

设置完成以后，我一般按照下面这套流程使用。

第一步：先读项目

先阅读 AGENTS.md、README、项目结构和相关代码。

暂时不要修改，先总结项目规则和当前实现。

第二步：复杂任务先规划

先列出修改方案、涉及文件、测试方式和潜在风险。

确认后再开始修改。

第三步：最小化修改

只修改完成任务必需的文件，不要重构无关代码。

第四步：自动检查

运行相关测试、Lint 和类型检查。

如果失败，请继续修复，不要直接跳过。

第五步：总结结果

说明修改内容、涉及文件、检查结果和剩余风险。

这套流程不复杂，但会比只说一句“帮我把这个功能做了”稳定很多。