OpenAI Codex CLI 技能

使用 OpenAI Codex CLI (codex) 来处理编码任务，包括代码审查、重构、错误修复、CI 修复和功能实现。Codex CLI 在您的本地机器上运行，拥有完整的文件系统访问权限。

使用时机

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

安装与认证

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

# Install
npm i -g @openai/codex

# Authenticate (opens browser for OAuth)
codex login

# Or use API key
printenv OPENAI_API_KEY | codex login --with-api-key

# Verify auth
codex login status

核心命令

交互模式 (TUI)

codex                           # Launch interactive terminal UI
codex "explain this codebase"   # Start with a prompt
codex --cd ~/projects/myapp     # Set working directory

非交互模式 (脚本)

codex exec "fix the CI failure"                    # Run and exit
codex exec --full-auto "add input validation"      # Auto-approve workspace writes
codex exec --json "list all API endpoints"         # JSON output for parsing
codex exec -i screenshot.png "match this design"   # With image input

会话管理

codex resume               # Pick from recent sessions
codex resume --last        # Continue most recent
codex resume <SESSION_ID>  # Resume specific session

斜杠命令 (在 TUI 中)

审批模式

关键标志

Clawdbot集成模式

模式1：直接执行工具

从Clawdbot的执行工具调用Codex来处理编码任务：

# In Clawdbot session
exec codex exec --full-auto --cd ~/projects/medreport "fix the TypeScript errors in src/components"

模式2：子代理委托

生成一个使用Codex的编码子代理：

// In agents.defaults or per-agent config
{
  agents: {
    list: [
      {
        id: "coder",
        workspace: "~/clawd-coder",
        model: "openai-codex/gpt-5.2",  // Uses Codex auth
        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 manages its own sessions
        }
      }
    }
  }
}

模式4：MCP服务器模式

将Codex作为MCP服务器运行，供其他代理使用：

codex mcp-server  # Exposes Codex tools via stdio MCP

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的认证配置文件中。

代码审查工作流程

# Interactive review
codex
/review  # Choose: branch, uncommitted, or specific commit

# Non-interactive
codex exec "review the changes in this PR against main branch"

多目录项目

# Work across monorepo packages
codex --cd apps/frontend --add-dir ../backend --add-dir ../shared

# Or in TUI
codex --cd ~/projects/myapp --add-dir ~/projects/shared-lib

自定义斜杠命令

在~/.codex/prompts/目录下创建可复用的提示词

<!-- ~/.codex/prompts/pr.md -->
---
description: Prepare and open a draft PR
argument-hint: [BRANCH=<name>] [TITLE="<title>"]
---

Create branch `dev/$BRANCH` if specified.
Stage and commit changes with a clear message.
Open a draft PR with title $TITLE or auto-generate one.

：调用示例：

/prompts:pr BRANCH=feature-auth TITLE="Add OAuth flow"

MCP 集成

# Add stdio server
codex mcp add github -- npx @anthropic/mcp-server-github

# Add HTTP server
codex mcp add docs --url https://mcp.deepwiki.com/mcp

# List configured
codex mcp list

添加 MCP 服务器以扩展 Codex 功能：

网络搜索在~/.codex/config.toml

[features]
web_search_request = true

[sandbox_workspace_write]
network_access = true

中启用：

随后 Codex 即可搜索当前文档、API 等

1. 最佳实践首先使用/init
2. 命令创建包含仓库特定说明的 AGENTS.md 文件提交前使用/review进行 AI 代码审查
3. 合理设置/approvals审批设置— 对可信仓库使用自动模式，对探索性仓库使用只读模式
4. 使用--add-dir处理单体仓库而非danger-full-access
5. 恢复会话以跨编码会话保持上下文
6. 附加图像用于UI工作、设计规范、错误截图

示例工作流

修复CI故障

codex exec --full-auto "The CI is failing on the lint step. Fix all ESLint errors."

重构组件

codex exec --cd src/components "Refactor UserProfile.tsx to use React Query instead of useEffect for data fetching"

根据规范实现功能

codex exec -i spec.png --cd ~/projects/app "Implement this feature based on the design spec"

代码审查PR

codex exec "Review the diff between main and feature/auth branch. Focus on security issues."

故障排除

参考资料

• Codex CLI 概览
• Codex CLI 功能
• Codex CLI 参考
• 斜杠命令指南
• AGENTS.md 规范
• Codex GitHub