OpenAI Codex CLI 技能

使用 OpenAI Codex CLI（codex）执行编码任务，包括代码审查、重构、缺陷修复、CI 修复以及功能实现。Codex CLI 在本地机器上运行，并具备完整的文件系统访问权限。

适用场景

• 用户请求代码修改、重构或功能实现
• CI/构建失败需修复
• 提交/推送前进行代码审查
• 大规模代码库的探索或解释
• 需结合文件编辑与命令执行的任务
• 需要调用 GPT-5-Codex 模型优势（如代码生成、工具调用）时

安装与认证

Codex CLI 需要 ChatGPT Plus/Pro/Business/Enterprise 订阅权限。

# 安装
npm i -g @openai/codex

# 认证（打开浏览器进行 OAuth）
codex login

# 或使用 API 密钥
printenv OPENAI_API_KEY | codex login --with-api-key

# 验证认证状态
codex login status

核心命令

交互模式（TUI）

codex                           # 启动交互式终端 UI
codex "解释该代码库"           # 使用指定提示启动
codex --cd ~/projects/myapp     # 设置工作目录

非交互模式（脚本化调用）

codex exec "修复 CI 失败问题"                    # 执行后退出
codex exec --full-auto "添加输入校验"          # 自动批准 workspace-write 操作
codex exec --json "列出所有 API 端点"         # 输出 JSON 格式，便于解析
codex exec -i screenshot.png "匹配此设计"   # 带图像输入执行

会话管理

codex resume               # 从最近会话中选择恢复
codex resume --last        # 恢复最新会话
codex resume   # 恢复指定会话

斜杠命令（在 TUI 中使用）

审批模式

关键标志（Flags）

Clawdbot 集成模式

模式 1：直接调用 exec 工具

通过 Clawdbot 的 exec 工具调用 Codex 执行编码任务：

# 在 Clawdbot 会话中
exec codex exec --full-auto --cd ~/projects/medreport "修复 src/components 中的 TypeScript 错误"

模式 2：子代理委托

启动一个使用 Codex 的编码子代理：

// 在 agents.defaults 或单个 agent 配置中
{
  agents: {
    list: [
      {
        id: "coder",
        workspace: "~/clawd-coder",
        model: "openai-codex/gpt-5.2",  // 使用 Codex 认证
        tools: {
          allow: ["exec", "read", "write", "edit", "apply_patch", "process"]
        }
      }
    ]
  }
}

模式 3：CLI 后端降级方案

将 Codex 配置为纯文本降级后端：

{
  agents: {
    defaults: {
      cliBackends: {
        "codex-cli": {
          command: "codex",
          args: ["exec", "--full-auto"],
          output: "text",
          sessionArg: null  // Codex 自行管理会话
        }
      }
    }
  }
}

模式 4：MCP 服务端模式

将 Codex 作为 MCP 服务端供其他 agent 调用：

codex mcp-server  # 通过 stdio MCP 协议暴露 Codex 工具

Clawdbot 配置：OpenAI Codex 提供方

通过 openai-codex 提供方使用您的 ChatGPT Pro 订阅：

{
  agents: {
    defaults: {
      model: { primary: "openai-codex/gpt-5.2" },
      models: {
        "openai-codex/gpt-5.2": { alias: "Codex" },
        "anthropic/claude-opus-4-5": { alias: "Opus" }
      }
    }
  }
}

认证信息会自动从 ~/.codex/auth.json 同步至 Clawdbot 的认证配置文件中。

代码审查工作流

# 交互式审查
codex
/review  # 选择：分支、未提交变更或特定 commit

# 非交互式审查
codex exec "针对 main 分支审查此 PR 中的变更"

多目录项目

# 跨 monorepo 子包操作
codex --cd apps/frontend --add-dir ../backend --add-dir ../shared

# 或在 TUI 中
codex --cd ~/projects/myapp --add-dir ~/projects/shared-lib

自定义斜杠命令

在 ~/.codex/prompts/ 中创建可复用的 prompt：

---
description: 准备并打开草稿 PR
argument-hint: [BRANCH=] [TITLE="