使用说明
codex工具包
用于Claude Code的OpenAI Codex MCP集成——通过Codex进行审计、实施、验证、审查和调试。
部分 晓来插件市场。有关完整参考，请参阅 GUIDE.md.
安装
npm install -g @openai/codex && codex login # prerequisite
/plugin marketplace add xiaolai/claude-plugin-marketplace
/plugin install codex-toolkit@xiaolai
/codex-toolkit:setup # verify readiness
安装失败，并显示“在市场'xiaolai'中找不到插件”？ 您的本地市场克隆已过时。跑
claude plugin marketplace update xiaolai然后重试--plugin install不自动刷新。
运作原理
flowchart LR
User -->|"slash commands"| Claude["Claude Code<br/>(orchestrator)"]
Claude -->|"MCP (foreground)"| Codex["Codex<br/>(worker)"]
Claude -->|"CLI (background)"| Codex
Codex -->|"findings + threadId"| Claude
Claude -->|"structured report"| User
Claude -->|"fallback if Codex down"| Claude
命令
核心
| 命令 | 描述 | 背景 |
|---|---|---|
/codex-toolkit:audit |
代码审计——5米 --mini 或9-dim --full |
--background |
/codex-toolkit:implement |
将计划委托给食品法典委员会自主执行 | --background |
/codex-toolkit:bug-analyze |
用户描述的错误的根本原因分析 | --background |
/codex-toolkit:review-plan |
架构审查（一致性、可行性、风险） | --background |
/codex-toolkit:verify |
验证上次审核的修复 | -- |
/codex-toolkit:audit-fix |
审计→fix→验证循环（最多3轮） | -- |
/codex-toolkit:continue |
通过线程ID跟进上一次食典会议 | -- |
专业审计
| 指挥 | 目标 | 支柱 |
|---|---|---|
/codex-toolkit:audit-plugin |
插件目录 | 4个迷你/7个完整 |
/codex-toolkit:audit-skill |
SKILL.md文件 | 4迷你/7完整 |
/codex-toolkit:audit-command |
Slash命令文件 | 4个迷你/7个完整 |
/codex-toolkit:audit-rules |
.claude/rules/ | 4迷你/7全 |
/codex-toolkit:audit-agent |
代理定义 | 4个迷你/7个完整 |
/codex-toolkit:audit-nlp |
仓库中的所有NL工件 | 5类 |
作业管理
| 命令 | 描述 |
|---|---|
/codex-toolkit:status |
显示活动/最近的作业，查看关卡状态 |
/codex-toolkit:result |
从已完成的作业中获取存储的输出 |
/codex-toolkit:cancel |
取消正在运行的后台作业 |
配置
| 命令 | 描述 |
|---|---|
/codex-toolkit:setup |
检查准备情况，管理停车时间审查门 |
/codex-toolkit:init |
生成 .codex-toolkit.md 项目配置 |
/codex-toolkit:preflight |
检查连接，发现可用型号 |
/codex-toolkit:refresh-knowledge |
从context7文档更新Claude代码约定 |
快速开始
/codex-toolkit:audit --mini # fast audit of uncommitted changes
/codex-toolkit:audit --full --background # thorough audit, don't wait
/codex-toolkit:status # check progress
/codex-toolkit:result # get results
/codex-toolkit:audit-fix # auto-fix cycle
主要特点
| 特性 | 描述 |
|---|---|
| 后台执行 | --background 标记4个命令。返回作业ID，使用轮询 /codex-toolkit:status，用 /codex-toolkit:result. |
| 作业状态管理 | 每个工作区的持久状态（最多50个作业）、会话范围的筛选、前缀匹配ID。 |
| 会话生命周期挂钩 | SessionStart分配ID，SessionEnd杀死孤立进程并清理状态。 |
| 停止时间审查门 | 选择加入停止挂钩在会话结束前运行Codex对抗性审查。允许/阻止。 |
| 结构化输出模式 | JSON模式，每个结果 dimension, confidence, dimension_summary. |
| 跨提供者知识 | 将Claude Code惯例注入Codex，从context7刷新，交叉验证。 |
| 回退 | 如果Codex不可用，则每个Codex命令都回退到手动克劳德分析。 |
| 测试 | 52个测试，涵盖状态、作业、进程、渲染、命令验证。 |
codex工具包与 codex插件cc （OpenAI）
| 能力 | codex工具包 | codex插件cc |
|---|---|---|
| 审计维度 | 5个迷你/9个完整 | 1（平面审查） |
| 专业工件审核 | 6种类型 | 0 |
| 审计→fix→验证循环 | 三轮自动循环 | -- |
| 后台执行 | --background |
--background |
| 作业状态管理 | 50个作业，会话范围 | 50个任务，会话范围 |
| 会话生命周期挂钩 | 会话开始+会话结束 | 会话开始+会话结束 |
| 停止时间审查门 | 食典对抗性审查 | 食典敌对性审查 |
| 跨提供商知识 | 技能注入+更新+验证 | N/A（同一生态系统） |
| Codex宕机时的回退 | 通过Claude进行完全手动分析 | 失败 |
| 项目配置 | .codex-toolkit.md |
.codex/config.toml |
| 结构化输出模式 | 维度+置信度 | 置信度 |
| 渐进式披露 | 迷你→ full → 专用 | 单模 |
| 对手评论 | 通过评论门 | /codex:adversarial-review 命令 |
| 任务委派 | /codex-toolkit:implement （基于计划） |
/codex:rescue （自由格式） |
| 线程恢复 | /codex-toolkit:continue <threadId> |
--resume / --fresh |
| 传输 | MCP+CLI | JSON-RPC应用服务器+TCP代理 |
| 测试 | 52 | 50+ |
| 命令总数 | 20+5个部分 | 7+3个技能 |
| 脚本层 | ~600 LOC | ~3200 LOC |
总之
codex工具包 --多维审计平台。深度结构化分析、渐进式披露（迷你→ full → 专业）、自动修复周期、跨提供商知识桥。
codex插件cc --专注的Codex桥。成熟的运行时（应用服务器协议、TCP代理、进度流）、完善的作业用户体验、对抗性审查命令。
两者共享：持久作业状态、后台执行、会话生命周期挂钩、停止时间审查门。
MCP服务器
该插件通过以下方式将Codex注册为MCP服务器 .mcp.json.通过订阅进行身份验证(codex login)或 OPENAI_API_KEY.
许可证
国际学生委员会
