Codex 使用教程（2）：设置与项目配置详解

Codex 使用教程（2）：设置与项目配置详解

这一篇主要讲 Codex 设置页各个选项的作用，以及项目、环境、Worktree、Browser Use 等能力分别适合什么场景。

设置页面的选项不少，但并不是每一项都需要改。新手最需要先搞明白的，其实只有三类：权限、配置、项目相关能力。

1. 常规设置

1.1 工作模式

工作模式通常分为两种：

1. 用于编程
2. 用于日常工作

两者不是"模型能力不同"，而是界面展示和默认交互侧重点不同。如果你主要拿 Codex 写代码、改项目、查文件，直接用"用于编程"即可。

1.2 权限

这一项和第一节里讲过的权限入口是联动的。你在设置页修改权限，对话框里的权限选项也会同步变化。

常见权限可以这样理解：

1. 默认权限：Codex 可以在当前工作区内读写文件；如果要访问工作区外的内容，或者执行额外命令，通常需要你审批。
2. 自动审核：Codex 会结合当前对话上下文，自动判断某些操作是否适合执行，减少手动点确认的次数。
3. 完全访问：权限最高，风险也最高。开启后，Codex 的可操作范围会非常大，一般不建议随便使用。

如果你只是正常写代码、整理文档，优先用"默认权限"或"自动审核"就够了。

1.3 其他常规选项

这一页剩下的常规选项，可以按下面理解：

• 默认打开位置：决定从 Codex 打开文件或项目时，默认交给哪个本地应用处理。
• 语言：设置 Codex 客户端界面语言。
• 在菜单栏中显示：是否在 macOS 顶部菜单栏右侧显示 Codex 图标。
• 弹出窗口快捷键：设置一个快捷键，用来快速呼出 Codex 的迷你窗口。
• 运行时防止系统休眠：避免任务执行过程中系统自动休眠或锁屏。
• # + Enter 发送长文本：属于输入习惯类选项，用不用都行。
• 跟进行为：决定你在 Codex 回复过程中发送新消息时，是"排队"还是"引导"。

其中"跟进行为"比较实用：

• 排队：等 Codex 当前回复结束后，再处理你后发的那条消息。
• 引导：直接打断当前过程，在当前任务里修正方向。

一般更推荐默认用"排队"。因为排队中的消息通常更容易撤回或修改；如果你确认要中途纠偏，再切成"引导"更稳妥。

1.4 代码审查与建议提示

• 代码审查：决定你触发审查能力时，是在当前会话里进行，还是单独开一个视图处理。
• 建议提示：控制输入框附近那些建议问题、建议操作是否显示。

如果你的项目比较老、上下文复杂，代码审查结果不一定稳定，需要结合实际项目情况判断，不要把它当成绝对正确的结论。

2. 听写与通知

这一块分两部分：听写和通知。

2.1 听写

如果你主要使用中文，Codex 自带语音输入未必是最稳的选择。至少在中文场景下，识别效果可能没有专门的语音输入工具好。

所以这项功能可以了解，但不必强依赖。中文用户更实际的做法，通常还是先用更熟悉的语音转文字工具，再把文本贴进 Codex。

2.2 通知

通知里比较常见的选项有：

1. 轮次完成通知：控制任务完成后什么时候提醒你。
2. 权限通知：Codex 需要额外权限时是否提醒。
3. 问题通知：Codex 需要你补充信息或做选择时是否提醒。

"轮次完成通知"一般有三种思路：

• 从不通知
• 仅在应用未聚焦时通知
• 始终通知

如果你经常同时开多个会话，或者会一边做别的事一边等 Codex 跑任务，直接用"始终通知"通常更省心。

3. 外观

外观主要是主题、视觉风格之类的设置，没有太多使用门槛。按自己的习惯选即可，这一块不会影响 Codex 的核心能力。

4. 配置

配置页是最容易把人看晕的一块，但核心可以拆成四部分：批准策略、沙盒设置、外部智能体配置、工作空间依赖项。

4.1 批准策略

这里通常会看到几种英文策略，例如：

• on-request
• on-failure
• untrusted
• never

不同版本的文案可能略有差异，但你可以先这样理解：

• 更保守的策略：更多操作需要你确认。
• 更激进的策略：尽量先执行，只有特定情况下才打断你。
• never：基本可以理解为不自动放行相关操作。

如果你现在已经在用自动审核，这一块不一定需要折腾得很细。对大多数人来说，先把"权限模式"和"自动审核"用明白，比死磕这里更重要。

4.2 沙盒设置

沙盒设置通常有三类：

1. Read only：工作区只读。
2. Workspace write：允许在工作区内写入。
3. Full access：权限最高。

这里的重点不是死记名字，而是理解"沙盒"这个概念：

Codex 执行命令时，并不等于毫无限制地直接操作你的整台电脑。沙盒的作用，就是给这类执行加一层范围控制和保护机制。

通常来说：

• Read only 适合只看代码、只查资料。
• Workspace write 适合正常开发和文档修改。
• Full access 适合非常明确、并且你能承担风险的场景。

有些配置下，你还会看到是否允许网络访问。这个能力和前面的权限设置有一定关联，但不是一回事。可以简单理解为：

• 权限设置：决定 Codex 能不能做某类动作。
• 沙盒设置：决定这些动作能在多大范围内进行。

如果你没有特别明确的高级需求，保持默认配置通常就够了。

4.3 导入外部智能体配置

这一项的作用，通常是把其他智能体工具里的部分配置导入或合并进来，避免重复维护多套相似配置。

如果你没有同时使用其他智能体工具，这一块可以先不动。

4.4 工作空间依赖项

这一项主要和 Codex 自己内置的一些运行时或工具依赖有关，例如内置的 Node、Python 或其他辅助能力。

需要注意区分两件事：

1. 你项目自身依赖的 Python、Node、包管理器，是你项目自己的环境。
2. Codex 内部某些功能调用的运行时，是 Codex 自带或优先使用的环境。

也就是说，这个选项影响的更多是 Codex 自己的工具链，不是你项目里所有命令的解释器。

如果没有遇到兼容性问题，保持开启通常没问题。

5. 个性化

5.1 回复风格

这里通常可以设置 Codex 默认的表达风格，例如更亲和，或者更务实。

如果你主要拿它做事，通常更推荐"务实"风格。这样输出会更直接，废话更少。

5.2 自定义指令

自定义指令可以理解成"全局长期生效的补充要求"。

适合放进去的内容包括：

• 运行环境
• 输出语言
• 常见禁忌
• 你反复强调的协作规则

比如"始终用中文回复""不要改工作区外文件""优先给结论再解释"，都很适合写在这里。

5.3 记忆

记忆功能是实验性的。它的作用，是根据你过去的对话，提炼出一些长期偏好、常见流程和习惯。

常见选项一般有：

1. 启用记忆
2. 跳过工具辅助对话
3. 重置记忆

"跳过工具辅助对话"比较好理解：如果某些对话里混入了大量工具输出、日志、上下文噪音，那么这些内容不一定适合直接拿去生成用户偏好记忆。

你可以把记忆理解成一个偏本地化的经验库。它不会替你做事，但会影响 Codex 在类似问题里的默认倾向。

6. MCP 服务器

这一页是管理 MCP 服务器的地方，也就是把外部能力接进 Codex 的一种方式。

但要注意，MCP 不是唯一方案。

如果你是本地使用 Codex，很多场景下用 CLI 配合 Skills 反而更轻、更直接，原因通常有两个：

1. 上下文更干净，额外 token 消耗更少。
2. 本地命令链路更短，执行效率通常更高。

如果你是远程 Agent、远程环境，或者没有办法直接使用本地 CLI，那 MCP 就会更重要。

7. Git 设置

Git 相关设置主要包括：

• 分支名前缀：创建分支或 Worktree 时默认带的前缀。
• Pull Request 合并方式：例如普通合并，或压缩后合并。
• 创建草稿 Pull Request：默认是否把新建 PR 标记为 Draft。
• 自动删除旧 Worktree：是否自动清理旧的工作树。
• 自动删除阈值：超过多少个后开始清理。
• 提交命令提示词：生成 commit message 时参考的提示词。
• Pull Request 命令提示词：生成 PR 标题和描述时参考的提示词。

其中"普通合并"和"压缩合并"的区别，新手要先知道：

• 普通合并：保留原始提交历史，更方便后续排查问题。
• 压缩合并：把多个提交合成一个，历史更干净，但排查粒度更粗。

如果你们团队没有特别要求，保留原始提交历史通常更利于定位问题。

8. 环境

"环境"这一块，展示的是你为某个项目单独配置的一组运行能力。

可以把它理解成：给某个项目提前定义好一批常用操作，例如：

• 创建 Worktree 后自动执行什么脚本
• 删除 Worktree 时执行什么清理脚本
• 项目首页快捷显示哪些操作入口
• 是否提供一键安装依赖、运行调试、打包构建等动作

这类配置的意义在于，把"项目启动前后的重复动作"固化下来，减少每次手工输入命令的成本。

尤其是需要频繁新建工作树、安装依赖、跑初始化脚本的项目，这一块会很有价值。

9. 工作树（Worktree）

这里指的是 Codex 内置管理的 Worktree。

Worktree 可以理解为：在同一个 Git 仓库下，为不同任务拉出独立工作目录，避免多个需求混在同一个目录里互相污染。

但要注意两点：

1. 这里展示和管理的，通常是 Codex 自己创建并接管的 Worktree。
2. 如果你平时本来就习惯自己管理多仓、多目录、多项目协作，也可以不依赖这里。

有些人会非常喜欢 Worktree，因为并行开发很方便；有些人则会觉得自己已有一套更顺手的分支管理方式，那就没必要强行切过去。

10. Browser Use

Browser Use 是 Codex 官方提供的浏览器操作能力。你可以把它理解成"内置浏览器自动化"。

它适合做的事情包括：

• 打开本地项目页面
• 检查界面
• 点按钮、填表单
• 做简单回归验证
• 收集页面信息

这类能力和 Playwright 自动化有相似之处，但使用方式更贴近 Codex 的对话工作流。

如果你本地浏览器已经保留了完整登录态，而你又很依赖这些现成会话，那么也可以继续用自己熟悉的浏览器自动化方案，不一定非要切到内置能力上。

11. Computer Use

Computer Use 可以理解成"让 Codex 操作你的桌面软件"。

和 Browser Use 的区别是：

• Browser Use 主要面向浏览器页面。
• Computer Use 面向整个桌面应用环境。

它常见能做的事包括：

• 点击
• 输入
• 拖拽
• 滚动
• 切换窗口
• 操作桌面应用里的按钮和菜单

这类能力通常会结合截图和无障碍树来完成。你可以把无障碍树理解成"界面结构的可读文本化描述"，这样 AI 不只是看图，还能读取界面元素的结构信息。

这对一些图形界面较多、但又存在明确控件结构的软件会很有帮助。

12. 已归档对话

最后这一项是"已归档对话"。

它的作用很简单：你归档过的对话，会集中显示在这里，方便后续恢复、翻找或重新查看。你可以把它理解成一个轻量的归档区。

13. 新手可以怎么设置

如果你是第一次系统使用 Codex，建议先按下面这套思路来：

1. 工作模式选"用于编程"。
2. 权限优先用"默认权限"或"自动审核"。
3. 沙盒优先用 Workspace write，不要一上来就开 Full access。
4. 自定义指令里补上你的输出语言、工作习惯和边界要求。
5. 不急着折腾 MCP、环境脚本、Worktree 自动化，先把基础流程跑顺。

这样配置的好处是：既能正常干活，又不会一开始就把系统搞得太复杂。