Claude Code Harness 快速开始：第一次运行 /harness-setup 到 /harness-plan 完整教程-开发者社区

Claude Code Harness 快速开始：第一次运行 /harness-setup 到 /harness-plan 完整教程

【免费下载链接】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

Claude Code Harness 是一个专为 Claude Code 打造的自主开发框架（Development Harness），通过"计划 → 执行 → 审查"的闭环，让 AI 编程稳定产出高质量代码。本文将带你从零开始，完成第一次/harness-setup初始化与/harness-plan计划生成，10 分钟内跑通完整工作流。

它解决什么问题？

用过 AI 编程工具的人都有过这样的体验：需求写在聊天记录里转眼就忘、测试在赶工期时被"省略"、代码合入后才发现没做审查。

Claude Code Harness 把流程固定为一条可重复的交付路径：

写规格 → 只实现已批准的切片 → 验证 → 独立审查 → 打包证据

它的核心理念是：不依赖模型变得更聪明，而是把流程和边界固定下来，模型升级后流程依然可靠。每个阶段都会留下下一阶段需要的产物：

阶段	命令	产出
📋 计划	`/harness-plan`	`spec.md`+`Plans.md`（范围、验收标准、依赖、停止条件）
🔧 执行	`/harness-work`	代码 + 测试（按任务要求自动走 TDD）
🔍 审查	`/harness-review`	独立审查结论，严重问题会阻止完成
🔄 同步	`/harness-sync`	计划与实际实现的漂移报告
🚀 发布	`/harness-release`	CHANGELOG、标签与发布证据包

此外，它内置了双层安全机制：运行时底线（不可关闭，覆盖计费、网络外发、密钥读取等 5 类高危操作）和防护栏 R01–R15（可按项目配置）。所有拦截都会记录到日志，而不是静默放行。

准备工作：安装插件（约 30 秒）

在终端启动 Claude Code 后，依次输入以下命令即可完成安装：

claude /plugin marketplace add Chachamaru127/claude-code-harness /plugin install claude-code-harness@claude-code-harness-marketplace

💡 如果你使用 Codex CLI 或 Cursor，也可以先克隆仓库再执行对应的安装脚本，地址为https://gitcode.com/GitHub_Trending/cl/claude-code-harness，脚本见scripts/setup-codex.sh与scripts/setup-cursor.sh。本文以 Claude Code 为主线。

安装完成后，项目里已经能看到 Harness 的 5 个核心"动词"技能：plan、work、review、sync、release。

第一步：运行 /harness-setup 初始化项目

在项目根目录启动claude，输入：

/harness-setup

它会自动完成：

📄 生成CLAUDE.md（项目规则文件）与Plans.md（任务台账）
🪝 配置 hooks 与工具链
🧠 初始化记忆目录（harness-mem）
🩺 最后运行自检（doctor），确认环境健康

执行/harness-setup时还可以指定子命令，常用的一览：

子命令	作用
`/harness-setup init`	全新项目初始化（CLAUDE.md + Plans.md + hooks）
`/harness-setup codex`	配置 Codex CLI 作为执行后端
`/harness-setup ci`	配置 CI/CD 流水线
`/harness-setup harness-mem`	配置记忆系统
`/harness-setup localize`	本地化 CLAUDE.md 规则

✅成功的标志：会话中能看到 Harness 工作流技能，Plans.md状态可读，下一步建议是 plan / work / review 而不是"自由发挥式"编码。

第二步：运行 /harness-plan 生成你的第一份计划

初始化完成后，交给它一个具体的小任务，例如：

/harness-plan Improve the README onboarding flow

/harness-plan create会执行一套完整的计划质量流程：

最多问 3 个问题，确认你要做什么
联网调研最新信息
从 Product / Architecture / Security / QA / Skeptic 多个视角交叉评审
输出spec.md（产品契约：什么是对的）与Plans.md（任务台账：要做什么）

生成的Plans.md是一张 5 列任务表（任务 / 内容 / DoD / 依赖 / 状态），每个任务带cc:TODO等状态标记，DoD（完成定义）必须是可打勾验证的一行，禁止"写得好看一点"这类模糊描述。

⚠️你的角色不是写计划，而是在执行前批准或修正它。对于影响产品行为的计划，Harness 会输出Spec delta（规格变更）或Spec skip reason（跳过理由），并生成"事前确认"清单，把计划中可能触发的敏感操作一次性前置审批，避免执行途中反复打断你。

常用子命令：

输入	作用
`/harness-plan create`	生成/更新计划（spec.md + Plans.md）
`/harness-plan add 任务名: 描述`	追加新任务（标记为 cc:TODO）
`/harness-plan update 任务号完成`	更新状态标记
`/harness-plan sync`	对照实现情况，同步 Plans.md

计划确认后，如果你不是工程师或想快速核对，可以让它生成一份计划概要（单页 HTML，含理解、选项、风险、验收条件），不用读代码也能做决策。