Claude Codex Dialog

克劳德法典对话

特性

• 双向主机支持 --Claude可以主持Codex审查，或者Codex可以主持Claude审查
• 常规对话框 --两个代理商之间的开放式技术讨论
• 代码审查 --合作伙伴代理自动从git diff生成初始评论
• 计划审查 --在编写代码之前对实施计划进行对抗性审查
• 规范审查 --在规划或实施之前对产品/功能规格进行对抗性审查
• 代码审计 --对现有文件进行深入审计，以发现错误、架构问题、健壮性和安全性
• UI实施伙伴关系 -Codex可以将前端/UI实现委托给Claude Opus 4.7，而Codex拥有后端/API/数据集成
• 克劳德只执行钩子 --克劳德一侧的可选护栏；未安装等效的Codex挂钩

运作原理

对话模式

1. host agent调用 start_dialog
2. 服务器为配置的伙伴代理生成后台运行程序
3. 主机通过以下方式发送消息 send_message
4. 运行者调用合作伙伴CLI并将回复附加到 conversation.jsonl
5. 对话会一直持续到结束、空闲超时或硬循环上限

代码审查模式

1. host agent调用 start_code_review
2. 服务器生成一个git diff并生成一个review runner
3. 合作伙伴代理根据差异自动生成初始评论
4. 主持人通过以下方式阅读调查结果 check_messages，调查、修复或反驳，并回复 send_message
5. 审查将持续到MCP回复报告为止 review_status.approved: true，达到硬上限，或会话结束

会话数据存储在 ~/.claude/dialogs/.

先决条件

• >= 18
• Claude 代码命令行工具 在你的 PATH 如果你想让Claude主持命令或Claude作为审阅伙伴
• Codex CLI 在你的 PATH 如果你想要Codex主持的技能或Codex作为审查合作伙伴

对于完整的双向安装，两个CLI都应该可用。

支持原生Windows、macOS/Linux和WSL。在Windows上，PowerShell可能会阻止npm .ps1 在当前执行政策下进行调整；服务器和安装程序使用与Windows兼容的命令解析，因此npm .cmd 垫片仍然工作。

安装

macOS、Linux、WSL、Git Bash或Windows PowerShell：

git clone https://github.com/clptvn/claude-codex-dialog.git
cd claude-codex-dialog
npm run setup

默认安装模式为 --both，它执行以下所有操作：

• 为Claude注册MCP服务器
• 安装Claude slash命令：

- /codex-review-code - /codex-review-plan - /codex-review-spec - /codex-audit

• 仅安装Claude调查挂钩
• 为Codex注册MCP服务器
• 安装Codex技能：

- /claude-review-code - /claude-review-plan - /claude-review-spec - /claude-audit - /claude-ui-implementer

您也可以只安装一侧：

npm run setup -- --claude
npm run setup -- --codex
npm run setup -- --both

POSIX shell包装器仍然可用：

./install.sh --claude
./install.sh --codex
./install.sh --both

PowerShell包装器也可用：

.\install.ps1 -Claude
.\install.ps1 -Codex
.\install.ps1 -Both

要卸载，请执行以下操作：

npm run uninstall

或者只移除一侧：

./uninstall.sh --claude
./uninstall.sh --codex
./uninstall.sh --both

或者在PowerShell中：

.\uninstall.ps1 -Claude
.\uninstall.ps1 -Codex
.\uninstall.ps1 -Both

安装或卸载后重新启动相关CLI，以便重新加载MCP配置和命令/技能。

MCP工具

对话

代码审查

共享

review_status 使用封闭枚举值：

• state: approved, changes_requested, needs_discussion, in_progress, hard_cap_reached
• verdict: APPROVE, CHANGES_REQUESTED, NEEDS_DISCUSSION, IN_PROGRESS, HARD_CAP_REACHED，或 null
• source: structured_verdict, legacy_lgtm, legacy_approve, blocking_findings, hard_cap, none
• close_allowed_reason: approved, hard_cap，或 null
• 始终存在的字段： schema_version, state, approved, close_allowed, close_allowed_reason, verdict, source, source_message_id, partner_agent, allows_approve_verdict，以及 hard_cap_reached

用法

克劳德密码

克劳德侧安装后：

/codex-review-code
/codex-review-code staged security
/codex-review-plan path/to/plan.md
/codex-review-spec docs/specs/foo.md
/codex-audit src/

食品法典委员会

Codex侧安装后：

/claude-review-code
/claude-review-code staged security
/claude-review-plan path/to/plan.md
/claude-review-spec docs/specs/foo.md
/claude-audit src/
/claude-ui-implementer implement the settings billing UI

配置

默认值保留原始流：

• host_agent 默认为 claude
• partner_agent 默认为 codex
• partner_command 默认值基于 partner_agent

要反转流量，请设置：

• host_agent: "codex"
• partner_agent: "claude"

两者 start_dialog 和 start_code_review 也接受：

• partner_command
• model
• reasoning_effort
• max_rounds

start_dialog 还接受：

• tool_profile: read 默认情况下。使用 implementation 仅当合作伙伴应该编辑文件时，例如 /claude-ui-implementer 食典技能。
• subject_path：已审阅文档（如计划或规范）的可选路径。对话运行器在每个合作伙伴转身之前重新读取此文件，并将当前内容作为权威上下文包含在内。
• subject_kind：可选标签 subject_path: plan, spec，或 document.

服务器仍然接受 codex_command 为了向后兼容，也接受 claude_command 当Claude是配置的合作伙伴时。

圆形预算

每个会话都有一个软轮预算，默认 5，带着一顶硬帽子 soft + 5.

每 check_messages, send_message，以及 check_partner_alive 响应包括：

{
  "max_rounds": 5,
  "hard_cap": 10,
  "rounds_used": 2,
  "rounds_remaining": 3,
  "hard_rounds_remaining": 8,
  "past_soft_cap": false
}

跑步者明确指示合作伙伴代理在每一轮都提供完整的反馈，而不是滴喂结果。

钩子

调查执行挂钩仅安装在Claude托管的流中。它们不是故意为Codex托管的流安装的。

许可证

麻省理工学院