Claude-Codex-coop Skill 技能

技能简介

Claude-Codex-coop 让 Claude 与 Codex 在同一个对话里替你互相把关。你可能会遇到这些情况：一个 AI 说得头头是道，你却拿不准它是不是在"一本正经地胡说"；想让 Claude 和 Codex 互相审查，只能在两个窗口之间来回复制粘贴，两边说法不同时也不知道该信谁。这个技能把这件事自动化：无论你在 Claude 桌面版还是 Codex 桌面版里聊天，当前 AI 就是主协调——它先形成自己的判断，需要时自动调用另一边的 AI 做审查、找反例或实现，逐项核对对方的依据，最后给出综合回答，并说清哪些已证实、哪些仍存疑。适用于代码，也适用于写作、分析等任何需要"防胡说"的场景。

核心能力

• 双向协作：同时装进 Claude 与 Codex 桌面版，在哪边聊天，哪边就能调用另一边；Claude 侧主协调时 Codex 执行，反之亦然。
• 自动协作机制：开启后，值得协作的任务会自动调用另一方；问候、状态查询等日常对话不会触发，避免无谓消耗。
• 协作协议保障质量：主协调先独立判断，再把目标、已知、初判、具体问题与验收标准结构化交接给对方；对方按分析、决策、审查、实施四种模式交付；每个任务最多两轮，分歧会转成可执行的检验。
• 可视化侧边面板：实时显示对方的模型、推理强度、调用进度、账号额度与本轮 token；完整回复（含思考过程与命令步骤，默认折叠）可展开查看；可手动指定下一次调用的模型与推理强度。
• 外观与语言自适应：背景可跟随 App 浅色/深色，或选择极光、星河、地平线动态背景；界面中英文随系统语言，也可在菜单里切换。
• 按任务授权：分析、决策、审查类任务只读；只有"实施"任务会在你给出的授权范围内修改文件，两边规则一致。

安装配置

• 前提条件：Windows 10/11（已实测）；Python 3.10+ 且能在 PowerShell 中运行 python --version（Codex 只从 PATH 启动插件）；已登录的 Claude 桌面版与 Codex 桌面版。macOS 为实验性支持（仅脚本安装，尚未在真机验证）。
• 方式一：插件市场（推荐），在 PowerShell 中为 Claude 安装：

claude plugin marketplace add youagainchen/claude-codex-coop
claude plugin install ai-coop@claude-codex-coop

• 为 Codex 安装（只装了 Codex 桌面版时，先定位 App 自带的可执行文件）：

$codex = (Get-ChildItem "$env:LOCALAPPDATAOpenAICodexbin*codex.exe" | Sort-Object LastWriteTime | Select-Object -Last 1).FullName
& $codex plugin marketplace add youagainchen/claude-codex-coop
& $codex plugin add ai-coop@claude-codex-coop

• 方式二：安装脚本：

git clone https://github.com/youagainchen/claude-codex-coop.git
cd claude-codex-coop
.scriptsinstall.ps1 -Target Both

可用 -Target Claude 或 -Target Codex 只装一边，加 -ReadOnly 禁止协作方修改工作区文件；升级只需 git pull 后重新运行脚本。macOS 用 sh scripts/install.sh --target both。

• 安装后务必完全退出并重新打开两个 App。

使用步骤

1. 在两个 App 中任意一边的对话里说 "打开 AI Coop"，面板出现在右侧，自动协作开启。
2. 首次使用时若面板提示 Claude CLI 未登录，点"登录 Claude CLI"，在浏览器里用与 Claude 桌面版相同的账号授权一次即可。
3. 正常描述任务即可，可以先试一句："帮我审查这个项目的 README，请另一边找出遗漏，并核对你们的分歧"；面板里出现调用记录就说明协作已生效。
4. 需要指定对方的模型或推理强度时，在面板"下一次调用"里选"手动指定"，或直接在对话里说，例如"让 Codex 用 gpt-6-sol、high 审查这个方案"。
5. 关闭协作：点面板右上角开关，或说"关闭 AI Coop"。
6. 出现问题时运行 .scriptsdoctor.ps1，确认输出中的 codex_exe 与 claude_exe 都有路径；任一为 null 表示没找到对应 CLI，可用环境变量 AI_COOP_CODEX_EXE / AI_COOP_CLAUDE_EXE 指定。

适用场景

• 代码交叉审查：让两个模型各自审查同一份补丁或方案，找出单模型容易漏掉的真问题（演示中 Codex 曾审查 macOS 安装脚本并找出一处真实缺陷）。
• 防止"一本正经地胡说"：对结论、研究报告、数据分析结果做第二方核验，逐条标注已证实与存疑。
• 重要方案决策：在技术选型、架构取舍等高风险判断上引入独立第二意见。
• 写作与内容校对：对文案、文档、论文式内容做事实与逻辑的双重检查。
• 多模型能力对比：同一任务分别由 Claude 与 Codex 处理，直观比较双方表现。

适用人群

• 同时使用 Claude 与 Codex 桌面版的开发者、工程师与 AI 重度用户。
• 对结论准确性要求高、需要交叉验证的研究、分析、写作人员。
• 希望把多模型协作纳入日常工作流的团队（尤其 Windows 环境）。
• 想观察不同模型在同一任务上差异的模型评测爱好者。

工作原理

插件的核心是一个本地 MCP 服务（server/mcp_server.py，仅依赖 Python 标准库）：主协调调用 start_workflow 后，服务在后台启动另一边的 CLI（codex exec --json 或 claude -p --output-format stream-json），把事件实时写入侧边面板，结束后将结果交回主协调。调用 Claude 时固定使用 Claude CLI 已登录的账号。面板（server/sidebar.py）只监听 127.0.0.1、端口随机，且每次启动生成访问令牌。隐私方面：发给协作 AI 的是任务包与当前工作区的只读快照（最多 400 项文件清单与常见说明文件），会自动跳过大量疑似密钥文件（.env*、*.pem、*.key、id_rsa*、*credentials*、*secret* 等）与 .git、.ssh、node_modules 等目录；每次调用的请求、回复与事件流保存在本地 ~/.ai-coop/runs/。

官方链接

• GitHub 仓库：https://github.com/youagainchen/claude-codex-coop
• 对照项目（OpenAI 官方 codex-plugin-cc）：https://github.com/openai/codex-plugin-cc