Clark Cui

Appearance

Codex 101 ​

一、定位与对比 ​

维度Codex CLIClaude Code CLI
出品方OpenAIAnthropic
核心优势精准代码生成、深度 Bug 定位快速理解、灵活迭代
适用场景复杂 Bug 修复、代码审查、生产级代码日常编码、快速原型、项目理解
响应速度中等（质量换速度）快速

二、安装与启动 ​

bash
npm install -g @openai/codex@latest   # 安装
codex --version                        # 验证

交互模式：

bash
codex                              # TUI 界面
codex "分析方法调用逻辑"            # 带提示启动

非交互模式：

bash
codex exec "任务"                   # 执行完退出
codex exec --full-auto "任务"       # 完全自动化
codex exec --full-auto --json "任务" # JSONL 事件流输出
codex exec --full-auto -o out.txt "任务" # 输出到文件

三、沙箱安全模型 ​

Codex 采用"沙箱 + 审批策略"双层安全机制。

沙箱级别：

模式读写网络命令场景
read-only✅❌❌❌代码审查、安全分析
workspace-write✅仅项目❌受限日常开发（推荐）
danger-full-access✅任意✅✅CI/CD

审批策略：

策略说明
on-request每次需特殊权限时询问（推荐）
on-failure仅操作失败时询问
never全部自动通过
untrusted每次都询问
bash
codex --sandbox read-only --ask-for-approval on-request "审查安全漏洞"

四、会话管理 ​

bash
codex resume                    # 交互式选择历史会话
codex resume <session-id>       # 恢复指定会话
codex resume "继续上次任务"      # 恢复并追加提示

五、模型与 Profile ​

模型选项： gpt-5.3-codex（默认，256K 上下文）、codex-mini-latest（轻量，约 10x 便宜）

Profile 系统（~/.codex/config.toml）：

toml
[profiles.dev]
model = "gpt-5.3-codex"
model_reasoning_effort = "medium"

[profiles.review]
model = "gpt-5.3-codex"
model_reasoning_effort = "high"

[profiles.ci]
model = "codex-mini-latest"
model_reasoning_effort = "low"
bash
codex -p dev "添加参数校验"          # 日常开发
codex -p review "审查并发安全性"     # 深度审查
codex exec -p ci --full-auto "跑测试" # CI 自动化
codex -c model="o3" "临时用 o3"      # 临时覆盖

六、AGENTS.md 项目配置 ​

Codex 的项目级配置文件，告诉 Codex 项目背景和规范：

markdown
# AGENTS.md
## 项目说明
Java Spring Boot 微服务
## 技术栈
Java 17 + MyBatis + Redis + Kafka
## 目录结构
- api: API 模型定义
- provider: 业务实现

AGENTS.md vs CLAUDE.md：

  • AGENTS.md：评分表 + 执行规则（怎么打分、怎么操作）
  • CLAUDE.md：红线 + 背景信息（别越界、知道项目情况）

七、Skill 体系 ​

Codex 的 Skill 使用 SKILL.md 文件定义，放在目录结构中：

~/.agents/skills/<skill-name>/
├── SKILL.md        # 必需：技能描述和指令
├── scripts/        # 可选：可执行脚本
├── references/     # 可选：参考文档
└── assets/         # 可选：模板资源

调用方式：

bash
$skill-name              # 显式调用（$ 前缀）
$skill-creator           # 引导式创建新 Skill
$skill-installer install <name>  # 安装社区 Skill

渐进式加载：启动时只加载元数据（name + description），决定使用时才加载完整内容。50 个 Skill 只占约 5KB 而非 100KB。

Skill 与 Claude Code 对比：

维度CodexClaude Code
定义文件SKILL.md（固定名）任意名.md
结构目录 + 子目录单个 .md 文件
脚本支持scripts/ 子目录无
调用前缀$/
社区仓库github.com/openai/skills无官方仓库

八、MCP 配置 ​

在 ~/.codex/config.toml 中配置：

toml
[mcp_servers.sequential-thinking]
command = "npx @modelcontextprotocol/server-sequential-thinking"
enabled = true

交互模式中 /mcp 查看状态。

九、斜杠命令速查 ​

命令说明
/model切换模型
/approval更改审批策略
/sandbox更改沙箱级别
/mcp查看 MCP 状态
/undo撤销上一次操作
/diff查看当前变更
/clear清除对话

十、与 Claude Code 协作选型 ​

场景首选理由
Bug 修复Codex一次性精准定位
代码审查Codex (read-only)安全隔离、细节精准
测试生成Codex覆盖率更高
安全审计Codex (read-only)沙箱隔离更严格
日常编码Claude Code速度快、交互流畅
项目理解Claude Code解释清晰、交互友好
快速原型Claude Code迭代速度快
文档生成Claude Code自然语言表达更好

分工策略：Claude Code 当大脑（规划、搜索、架构、验收），Codex 当双手（代码生成、重构、修 Bug）。

速查卡 ​

bash
# 基础
codex                              # 交互模式
codex "需求"                        # 带提示
codex exec --full-auto "任务"       # 完全自动
codex resume                       # 恢复会话

# 安全
codex -s read-only "任务"           # 只读
codex -s workspace-write "任务"     # 可写（推荐）
codex -a on-request "任务"          # 每次确认

# 模型
codex -m gpt-5.3-codex "任务"      # 主模型
codex -m codex-mini-latest "任务"   # 轻量模型
codex -p review "任务"              # 使用 Profile

# 管道
cat log.txt | codex "分析日志"