跳到主要内容

Codex 笔记

由旧稿重新整理版本,补全了与 ClaudeCode 的对比。旧稿目录已清理,当前以本文为准。

一、官方文档​

二、记忆文件 AGENTS.md​

Codex 的记忆文件是 AGENTS.md(不是 ClaudeCode 的 CLAUDE.md)。

AGENTS.md 为 Codex 提供持久的项目指南,会随代码库一起传输,在代理开始工作之前应用。请保持其简洁。

文件位置​

级别路径
用户级别~/.codex/AGENTS.md
项目级别./AGENTS.md

三、沙箱模式​

Codex 提供三种沙箱模式,按权限递增:

模式说明适用场景
read-only可以查看文件,但未经批准不能编辑或运行命令只读分析、代码审查
workspace-write(默认)读取文件、在工作区内编辑、运行常规本地命令本地日常工作的低摩擦模式
danger-full-access无沙箱限制,移除文件系统和网络边界仅在希望 Codex 拥有完全访问权限时使用

四、MCP 配置​

级别路径
用户级别~/.codex/config.toml
项目级别.codex/config.toml

详见 MCP笔记。

五、Tools​

Codex 自带原生网络搜索工具。本地任务中默认启用 web 搜索,结果来自 OpenAI 维护的网络搜索缓存(预先索引的结果而非实时获取页面),降低了从任意实时内容中获取提示注入的风险,但仍应将结果视为不可信。

控制方式:

  • 使用 --yolo 或 danger-full-access 沙箱设置时,web 搜索默认使用实时结果
  • 单次运行传 --search 获取最新数据
  • 在配置中设 web_search = "live" 切换到实时
  • 设 web_search = "disabled" 关闭工具

六、与 ClaudeCode 的对比​

维度ClaudeCodeCodex
记忆文件CLAUDE.mdAGENTS.md
默认运行模式基于权限的模式(只读,需授权)workspace-write(工作区内低摩擦)
MCP 客户端命令claude mcp add ...通过 config.toml 配置
沙箱/sandbox 手动开启启动时指定沙箱模式
思维强度支持调节—
Skills 机制原生支持支持

七、相关笔记​