Claude Code Harness 进阶配置：HARNESS_AUTO_APPROVE 与编排账本的终极手册

Claude Code Harness 进阶配置HARNESS_AUTO_APPROVE 与编排账本的终极手册【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harnessClaude Code Harness是一个为 Claude Code 打造的专业开发工具链Harness通过自主的「计划→执行→审查」闭环实现高质量开发。本文将带你配置两个进阶能力HARNESS_AUTO_APPROVE 自动审批与编排账本Orchestration Ledger——让 AI 在安全边界内放心放手同时留下完整的工作痕迹。 先搞懂自动审批为什么默认关闭Claude Code Harness 的自动审批采用故障安全fail-safe设计默认关闭且任何一个前置条件不满足都会自动回退到人工审批。源码逻辑在 go/internal/autoapprove/autoapprove.go 中定义AutoApproveEnabled函数要求四个条件同时成立#条件说明1环境变量HARNESS_AUTO_APPROVEon严格匹配只接受小写on2前置阶段92.1.1已完成在Plans.md或阶段门文件中确认3前置阶段92.2.3已完成同上4前置阶段96.1.2已完成同上这意味着光设环境变量是不够的。阶段完成状态由 go/internal/plans/ 解析Plans.md或检查.claude/state/phase-gates/phase.done门文件见defaultPrereqChecker函数。 新手建议先完成上述三个阶段门再开启自动审批——这是项目团队刻意设计的渐进信任路径。️ Worktree 作用域审批边界的隐形护栏即使自动审批已启用它也只对worktree 内部的路径生效。AppliesTo函数会把目标路径解析为绝对路径并判断是否位于 worktree 根目录下✅ worktree 内的路径 → 自动审批生效❌ 越界路径 → 升级为人工审批配合runtimefloor/wtfingerprint做硬停止相关护栏实现位于 go/internal/guardrail/ 与 go/internal/scopeleash/你可以在 go/internal/autoapprove/autoapprove_test.go 中查看边界测试用例。 编排账本这次活儿到底是谁干的当你把任务委派给 Codex / Cursor 等外部后端时编排账本回答一个关键问题这个会话中实际干活的到底是哪个后端见spec.md中的 Orchestration Visibility Contract。账本核心实现在 scripts/lib/orchestration-ledger.sh由codex-companion.sh和cursor-companion.sh每次委派时调用orch_emit_ledger写入一条记录。八条字段一次说清每条账本记录只包含固定标量字段绝不记录提示词、文件内容或密钥字段含义ts时间戳backend实际执行的后端subcommand子命令类型write是否发生写入exit_code退出码可为 nullduration_ms耗时毫秒可为 nullsession_id会话 IDcounts是否为真实委派task/review/adversarial-review为 true两个值得注意的设计防刷分机制status、setup等轮询类命令记录为countsfalse避免虚增分数orch_counts_for函数。Fail-open 原则账本写入失败绝不影响委派本身的退出码调用方必须用orch_emit_ledger ... || true形式调用。 查看账本路径、汇总与记分卡账本文件默认写入项目根目录.claude/state/orchestration-ledger.jsonl可用环境变量HARNESS_ORCHESTRATION_LEDGER覆盖累计统计.claude/state/orchestration-totals.json可用HARNESS_ORCHESTRATION_TOTALS覆盖汇总脚本scripts/orchestration-rollup.sh记分卡脚本scripts/orchestration-scorecard.shGo 实现go/internal/orchestrationledger/⚙️ 配套配置把安全开关调到合适档位自动审批不是孤立的开关它与 claude-code-harness.config.example.json 中的多组配置协同工作safety.modedry-run等安全模式git.allow_auto_commit/allow_auto_pushGit 自动操作开关paths.allowed_modify/paths.protected可修改路径白名单与保护路径字段语义详见 claude-code-harness.config.schema.json。建议新手先保持allow_auto_commit: false跑通整个流程后再逐项放开。❓ 常见问题Q1设置了HARNESS_AUTO_APPROVEon但审批没生效检查三个前置阶段是否完成。任一缺失系统会返回auto-approve:disabled (prereq-missing:...)并写入账本方便你排查。Q2账本会泄露敏感信息吗不会。orch_emit_ledger在接口设计上就没有 prompt 参数只记录八个标量字段这是硬性契约。Q3账本写入失败会中断任务吗不会。Fail-open 设计确保账本是观察层永不改变业务行为。✅ 写在最后Claude Code Harness 的进阶哲学可以概括为一句话信任是挣来的痕迹是省掉的。HARNESS_AUTO_APPROVE 用阶段门把自动关进笼子编排账本则让每一次委派都有据可查。从 docs/CLAUDE.md 了解整体约定再配合本文的两个进阶能力你就可以把 AI 开发闭环真正跑起来了。【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考