claudex-loop可调参数速查表MAX_ROUNDS、research层级与inspect开关如何精细调优【免费下载链接】claudex-loopClaude Code skill: four-phase plan hardening (recon, interrogate, Codex adversarial review, cross-model build inspection) — two AI models harden your plan before a line of code exists, then swap jobs to build it. Whoever built it never grades it.项目地址: https://gitcode.com/gh_mirrors/gr/claudex-loopclaudex-loop 是一款 Claude Code 技能Claude 与 OpenAI Codex 两个 AI 模型在写代码之前用「侦察 → 拷问 → 对抗评审 → 交叉构建」四阶段流程反复打磨你的方案。写代码前两个模型把计划磨到无懈可击写代码后谁写的代码就由另一个模型来检查。本文带你快速看懂MAX_ROUNDS、research 层级、inspect 开关这三个最关键的参数轻松完成精细调优。 30秒看懂claudex-loop 的参数都控制什么整个流程只有 4 个阶段所有参数都服务于「在代码出现前把方案磨好」这一目标阶段干什么由谁控制 0 RECONClaude 先侦察代码库或做调研产出「假设清单」让你一次性确认research层级 1 INTERROGATE逐条拷问真正重要的决策锁定PLAN.md无需参数⚔️ 2 REVIEWCodex 在只读沙箱中逐轮攻击计划直到批准或轮次用尽MAX_ROUNDS 3 BUILD可选双方角色互换谁写码另一个模型就验收inspect开关每次运行会留下两份产物PLAN.md方案本身和PLAN-REVIEW-LOG.md完整评审日志。参数调优的本质就是控制评审多深、调研多重、验收多严。 可调参数总览一张表看懂全部开关以下是 claudex-loop 全家桶的核心参数速查表参数说明详见 skills/claudex-loop/SKILL.md 与 README.md参数默认值作用所属技能MAX_ROUNDS5对抗评审轮次硬上限循环一定在此终止评审类技能researchask调研深度none/web/deepclaudex-loopinspecton构建后交叉审查默认开启claudex-loopMAX_INSPECTION_ROUNDS2构建后交叉审查的轮次上限claudex-loopPLAN_FILEPLAN.md方案文件位置评审类技能LOG_FILEPLAN-REVIEW-LOG.md评审日志全程追加全部技能SPEC_FILEPLAN.mdCodex 实现所依据的冻结规格codex-buildMAX_FIX_ROUNDS2修复轮次上限超过后 Claude 接管codex-buildPROOF_CMD来自规格判定构建成功的测试命令codex-build如何传参调用时直接带上参数即可例如说「claudex this plan,rounds3 researchweb」Claude 会按传入值解析并在开始前回显已解析的数值确认无误再开跑。⚙️ MAX_ROUNDS 调优对抗评审轮次怎么设MAX_ROUNDS是评审循环的安全阀每一轮 Codex 给出一次批评VERDICT: APPROVED或VERDICT: REVISE Claude 仲裁并修订。规则很硬——循环一定在MAX_ROUNDS处终止不会无限纠缠参见 硬规则。默认值 5 是怎么来的官方首次完整运行的真实记录很有参考价值一个全新 CRM 项目的方案在 5 轮评审中累计发现 55 个问题逐轮收敛为26 → 15 → 12 → 2 → 0第 5 轮才拿到APPROVED。其中包含 1 个「照做根本建不出来」的致命架构错误和约 6 个会损坏数据的设计——全部在写代码前被揪出。调优建议调高6~8高 stakes 任务如认证鉴权、支付、数据库迁移、并发设计。这类问题错一个代价极大值得多烧几轮。调低2~3低风险改动、时间紧张或你只想快速过一次「第二模型视角」。⚖️保持默认 5大多数高风险场景的稳妥选择。⚠️触顶未批准的结局若用尽轮次仍未APPROVED流程会如实汇报「死锁」——列出每个分歧点和 Claude 的立场交给你裁决而不是假装收敛。一个被标记的分歧胜过一次虚假的「批准」。参数定义可对照 skills/codex-review/SKILL.md 中的可调变量表。 research 层级none / web / deep 三档怎么选Phase 0 侦察阶段会开一个「调研门槛」让你选择调研深度规则见 SKILL.md 调研门槛。不选也没关系——Claude 会根据风险给出推荐值由你拍板。层级做什么适合场景成本none仅靠 Claude 已有知识 代码库侦察熟悉的领域、中等任务零web几次定向 WebSearch文档、坑、前人方案大部分全新项目默认推荐几分钟deep启动多智能体深度调研工作流多个并行查找 深读 综合简报高 stakes 新项目、陌生技术栈重、费 token选型口诀老项目brownfield代码库本身就是最好的情报源通常none就够。新项目greenfield默认web只有当「技术选型本身就是要回答的问题」时才上deep。deep有前置门槛Claude 会先展示调研问题和框架你批准后才启动工作流产出的简报会存档到docs/research/并与假设清单、PLAN.md互链——不是无脑烧 token。调用时可直接researchweb预选跳过询问环节。✅ inspect 开关构建后的交叉审查怎么调claudex-loop 的核心信条是谁做的东西谁来不得检查它。所以 Phase 3 构建完成后交叉审查默认开启机制见 构建后交叉审查Claude 写的代码→ 一个全新的只读 Codex 会话冷读完整 diff按 PR 风格给出发现Claude 逐条仲裁采纳并修复或写明理由拒绝最多MAX_INSPECTION_ROUNDS2轮。Codex 写的代码→ Claude 通读整个 diff 并亲自跑验证命令。inspect调优要点默认on建议保持一次额外审查只需约 2~5 分钟。忘记要审查正是这个默认值要防的失败模式。inspectoff不是「静默跳过」日志里必须记录这是显式退出否则不算合规。适合极小改动、或你已有其他验收手段时。⚙️MAX_INSPECTION_ROUNDS一般无需改动「首轮审查 修复后一次复审」已覆盖绝大多数情况。 实战搭配3 个典型场景的参数组合场景MAX_ROUNDSresearchinspect理由 老项目高风险重构鉴权/迁移/支付5~6noneon代码库即情报评审留足轮次兜底 全新项目从零搭建5web陌生技术栈用deepon调研补齐先例与避坑知识 低风险快速改动2~3noneon或留痕退出少烧轮次保留第二模型视角⚠️ 提醒claudex-loop 是为高 stakes 工作设计的。琐碎小改动直接改就好不必套完整流程。❓ 常见疑问 FAQQ1能把 MAX_ROUNDS 设得非常大吗可以但意义有限。真实运行显示问题量逐轮快速收敛26→15→12→2→0前 3 轮拿走绝大部分收获且轮次用尽而未批准时流程会以「死锁」方式交还给你人工裁决不会虚假收敛。Q2inspectoff后审查记录会丢失吗不会。跳过操作本身会被显式记录到LOG_FILE日志要么有审查结果、要么有明确的退出声明二者必居其一。Q3PLAN_FILE/LOG_FILE需要改吗绝大多数情况不用。只有你的方案或日志需要放在仓库根目录之外的特定路径时才需要覆盖。 延伸阅读关键文件指路完整参数表与四阶段流程skills/claudex-loop/SKILL.md独立评审循环已有方案、只想跑对抗评审时用skills/codex-review/SKILL.md全部可调变量含 codex-build 参数README.md术语表与 ADR 记录格式CONTEXT-FORMAT.md、ADR-FORMAT.md旧版技能存档已被 claudex-loop 取代legacy/grill-me-codex/SKILL.md、legacy/grill-with-docs-codex/SKILL.md一句话总结MAX_ROUNDS决定评审磨多深research决定情报备多足inspect决定验收多严格。默认值已覆盖大多数场景——高风险时把轮次调高新项目时把调研打开验收环节保持默认开启就是你需要的精细调优。【免费下载链接】claudex-loopClaude Code skill: four-phase plan hardening (recon, interrogate, Codex adversarial review, cross-model build inspection) — two AI models harden your plan before a line of code exists, then swap jobs to build it. Whoever built it never grades it.项目地址: https://gitcode.com/gh_mirrors/gr/claudex-loop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考