注意：如果您希望为代理工作流搭建更自主的环境，请查看 klaudworks/ralph-meets-rex。

Claude Code 的 Codex 集成

目的

使 Claude Code 能够调用 Codex CLI（codex exec 及会话恢复）来实现自动化代码分析、重构和编辑工作流。

先决条件

• 已安装 codex CLI，并确保其位于系统的 PATH 中。
• Codex 已配置有效的凭据和设置。
• 通过运行 codex --version 确认安装是否成功；如有任何错误，请先解决后再使用此技能。

安装

本仓库以 Claude Code 插件 的形式组织，并提供市场供用户使用。您可以将其作为 插件 安装（推荐），也可以将其提取为 独立技能。

选项 1：插件安装（推荐）

通过 Claude Code 的插件系统进行安装，以便自动更新：

/plugin marketplace add skills-directory/skill-codex
/plugin install skill-codex@skill-codex

选项 2：独立技能安装

手动提取技能文件夹：

git clone --depth 1 git@github.com:skills-directory/skill-codex.git /tmp/skills-temp && \
mkdir -p ~/.claude/skills && \
cp -r /tmp/skills-temp/plugins/skill-codex/skills/codex ~/.claude/skills/codex && \
rm -rf /tmp/skills-temp

使用方法

重要提示：思考标记

默认情况下，此技能会通过 2>/dev/null 来抑制思考标记（stderr 输出），以避免填充 Claude Code 的上下文窗口。如果您希望查看这些思考标记，以便进行调试或了解 Codex 的推理过程，可以明确要求 Claude 显示它们。

示例工作流

用户提示：

使用 Codex 分析这个仓库，并为我的 Claude Code 技能提出改进建议。

Claude Code 的回应： Claude 将激活 Codex 技能，并执行以下步骤：

1. 询问要使用的模型（gpt-5.4、gpt-5.3-codex-spark 或 gpt-5.3-codex），除非您的提示中已明确指定。
2. 询问推理力度级别（low、medium 或 high），除非您的提示中已明确指定。
3. 选择合适的沙盒模式（默认为只读模式用于分析）。
4. 运行类似如下的命令：

codex exec -m gpt-5.3-codex-spark \
  --config model_reasoning_effort="high" \
  --sandbox read-only \
  --full-auto \
  --skip-git-repo-check \
  "全面分析这个 Claude Code 技能仓库..." 2>/dev/null

结果： Claude 将总结 Codex 的分析输出，突出关键建议，并询问您是否希望继续执行后续操作。

详细说明

完整的操作说明、CLI 选项及工作流指南，请参阅 plugins/skill-codex/skills/codex/SKILL.md。

skill-codex 快速上手指南

skill-codex 是一个专为 Claude Code 设计的插件技能，旨在让 Claude Code 能够调用 Codex CLI（执行 codex exec 及会话恢复），从而实现自动化的代码分析、重构和编辑工作流。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 系统要求：支持 Claude Code 的操作系统（Linux/macOS/Windows）。
• 前置依赖：
  • 已安装 codex CLI 工具，并确保其二进制文件位于系统的 PATH 环境变量中。
  • Codex 已配置有效的凭证（Credentials）和相关设置。
• 验证安装： 在终端运行以下命令确认安装成功且无报错：

  codex --version
  

安装步骤

您可以选择通过 Claude Code 插件市场安装（推荐，支持自动更新），或手动提取为独立技能。

方式一：插件安装（推荐）

在 Claude Code 交互界面中依次运行以下命令：

/plugin marketplace add skills-directory/skill-codex
/plugin install skill-codex@skill-codex

方式二：独立技能安装

如果您希望手动部署，可以使用以下脚本将技能文件夹提取到本地配置目录：

git clone --depth 1 git@github.com:skills-directory/skill-codex.git /tmp/skills-temp && \
mkdir -p ~/.claude/skills && \
cp -r /tmp/skills-temp/plugins/skill-codex/skills/codex ~/.claude/skills/codex && \
rm -rf /tmp/skills-temp

注意：国内用户若遇到 GitHub 克隆速度慢的问题，可使用国内镜像源（如 Gitee 镜像或加速代理）替换上述 git clone 地址。

基本使用

安装完成后，直接在 Claude Code 对话中发出指令即可触发该技能。

使用示例

用户输入：

Use codex to analyze this repository and suggest improvements for my claude code skill.

执行流程：

1. 模型选择：Claude 会询问您使用的模型（如 gpt-5.4, gpt-5.3-codex-spark 等），除非您在提示词中已指定。
2. 推理强度：询问推理努力程度（low, medium, high），除非已指定。
3. 沙箱模式：默认选择 read-only（只读）模式进行分析。
4. 自动执行：Claude 将构建并运行类似以下的命令（默认隐藏思考过程令牌以保持上下文简洁）：

   codex exec -m gpt-5.3-codex-spark \
     --config model_reasoning_effort="high" \
     --sandbox read-only \
     --full-auto \
     --skip-git-repo-check \
     "Analyze this Claude Code skill repository comprehensively..." 2>/dev/null
   

结果反馈： Codex 执行完毕后，Claude 会总结分析结果，突出关键改进建议，并询问您是否需要执行后续操作。

提示：默认情况下，为了节省上下文窗口，该技能会屏蔽 Codex 的思考过程输出（stderr）。如果您需要调试或查看推理细节，请在提示词中明确要求“显示思考令牌 (show thinking tokens)"。