codex

Codex CLI 使用指南

简介

Codex CLI 是 OpenAI 提供的命令行工具，可以在终端中直接调用 AI 能力进行代码分析、debug 和 review。

安装与配置 → references/installation.md

在 Claude Code 中，通过以下方式使用 Codex：

• 自动 debug：描述 bug 时，codex-debugger agent 自动介入
• 手动 review：运行 /codex:review 命令触发代码审查

核心命令

codex exec - 执行任务

非交互式执行任意任务，适合 debug、代码分析和代码审查。

mkdir -p tmp
RESULT="tmp/codex-result-$RANDOM.txt"
codex exec -o "$RESULT" "<prompt>" --full-auto &> /dev/null
cat "$RESULT"

详细用法 → references/exec-usage.md

代码审查（通过 codex exec 实现）

代码审查统一通过 codex exec -o 配合 review prompt 实现，灵活支持各种审查场景。

# 审查未提交变更
mkdir -p tmp
REVIEW="tmp/codex-review-$RANDOM.txt"
codex exec -o "$REVIEW" "Review the uncommitted changes in this repository. Run git diff and git diff --cached to see all changes. Provide a code review covering: code quality, potential bugs, security issues, and improvement suggestions." --full-auto &> /dev/null
cat "$REVIEW"

# 审查特定 commit
mkdir -p tmp
REVIEW="tmp/codex-review-$RANDOM.txt"
codex exec -o "$REVIEW" "Review commit <sha>. Run git show <sha> to see the changes. Provide a code review." --full-auto &> /dev/null
cat "$REVIEW"

# 分支对比审查
mkdir -p tmp
REVIEW="tmp/codex-review-$RANDOM.txt"
codex exec -o "$REVIEW" "Review all changes between the current branch and <base-branch>. Run git diff <base-branch>...HEAD to see the diff. Provide a code review." --full-auto &> /dev/null
cat "$REVIEW"

详细用法 → references/review-usage.md

快速选择指南

场景	使用方式
代码报错、bug 分析	描述问题，codex-debugger 自动触发
审查当前改动	/codex:review uncommitted
审查某个 commit	/codex:review commit <sha>
PR 前代码审查	/codex:review branch <feature> --base main
自定义分析任务	mkdir -p tmp && RESULT="tmp/codex-result-$RANDOM.txt" && codex exec -o "$RESULT" "<描述任务>" --full-auto &> /dev/null

日志与调试

Codex CLI 提供完整的日志和会话管理功能。使用 -o 将结果写入文件后，完整的执行过程仍会被保存在会话中。

详细说明 → references/logging-debug.md

快速参考：

# 查看实时日志
tail -F ~/.codex/log/codex-tui.log

# 恢复上次会话查看完整执行过程
codex resume --last

# 启用详细日志
mkdir -p tmp
RESULT="tmp/codex-result-$RANDOM.txt"
RUST_LOG=debug codex exec -o "$RESULT" "<prompt>" --full-auto &> /dev/null