如何在 Cursor 上使用 Claude Code Harness安装、校验、运行三步走指南【免费下载链接】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 是一个为 AI 编程代理打造的计划→执行→评审自主交付循环工具它也能装进 Cursor让 Cursor 成为默认实现后端。本文用安装、校验、运行三步带你快速上手一条脚本完成安装三条命令完成校验再在 Cursor 里跑通 plan→work→review 的完整循环全程不需要手动改配置文件。为什么要在 Cursor 上用 Harness一条纪律化的交付闭环用 AI 写代码最常见的坑是计划写在聊天记录里消失了、测试赶工期被跳过、评审在合并之后才发生。Claude Code Harness 的思路不是让模型更聪明而是把流程和边界固定下来写规格 → 只实现已批准的部分 → 验证 → 独立评审 → 打包证据。它围绕 5 个核心动词组织工作每个阶段都会留下下一阶段需要的材料命令作用/harness-plan把想法变成spec.mdPlans.md范围、验收标准、停止条件/harness-work只实现已批准的任务需要时自动补测试/harness-review独立于实现做评审重大问题会阻断完成/harness-sync对比计划与实际实现报告偏差/harness-release只把已验证的证据打包成发布物更关键的是安全层每一次工具调用在运行前都会经过一个 Go 引擎裁决账单、网络出站、密钥读取、生产部署这类高危操作是硬性拒绝的任何配置都无法绕过详见 docs/CURSOR_INTEGRATION.md。第一步·安装一条命令把 Harness 装进 CursorCursor 的安装通道已经通过官方验证支持等级为supported。整个安装只需两步克隆仓库如果还没有本地副本git clone https://gitcode.com/GitHub_Trending/cl/claude-code-harness cd claude-code-harness执行官方安装脚本bash scripts/setup-cursor.shscripts/setup-cursor.sh 会自动完成三件事构建 Cursor 专用插件包、校验包内容清单、技能、运行辅助脚本齐全、把插件真实拷贝到~/.cursor/plugins/local/claude-code-harness。装完后按提示执行Developer: Reload Window重载 Cursor技能和代理就会生效。两点说明脚本使用真实目录拷贝而不是软链接因为 Cursor 会拒绝外部符号链接目标如果之前装过旧版脚本会自动备份到~/.harness-skill-cleanup-archive/。仓库中的 .cursor-plugin/plugin.json 是插件清单安装时版本会与 VERSION 文件自动对齐无需手动维护。第二步·校验3 条命令确认环境就绪装完不要急着开跑花 1 分钟做校验能避免后面 90% 的技能没触发问题2.1 校验安装包本身bash scripts/setup-cursor.sh --check加--check参数表示只构建并验证 Cursor 包不执行安装。它会检查插件清单不含非法路径、核心技能完整、运行时辅助脚本齐全全部通过会输出setup-cursor --check passed。2.2 校验适配器契约bash tests/test-cursor-adapter-candidate.sh这个测试会逐项断言 Cursor 集成所需的文件与契约插件清单、.cursor/AGENTS.md 引导路由、worker/reviewer/advisor 三个代理定义、模型路由脚本可执行等源码见 tests/test-cursor-adapter-candidate.sh。2.3 校验 cursor-agent 可用性在 Cursor 中调用cursor:setup --check技能定义见 skills/cursor-setup/SKILL.md它会依次确认当前解析出的实现后端、Cursor 包就绪状态、以及cursor-agent命令行工具能否找到并打印版本。技能只报告这三个事实不会擅自改动任何设置——分布默认的 fallback 始终是claude只有你明确请求时才会改本地环境。第三步·运行设 Cursor 为默认后端跑通循环3.1 设置默认实现后端确认无误后二选一仅当前项目生效在 Cursor 中调用cursor:setup --project-default等价于bash scripts/set-impl-backend.sh cursor写入项目根的env.local全部项目生效调用cursor:setup --user-default写入~/.config/claude-harness/impl-backend.env设置是幂等的同值不重复写换值原地替换。想撤销时用cursor:setup --unset。随时可以用 scripts/set-impl-backend.sh 的--show参数查看当前生效的后端或用 scripts/resolve-impl-backend.sh 按角色解析最终结果。3.2 在 Cursor 里驱动计划-执行-评审循环后端就绪后Cursor 就是 Harness 的执行侧项目根目录的 Plans.md 是唯一的共享事实源。推荐分工Cursor 负责计划、评审签核与发布判断PM 侧Harness 负责实现与本地验证。在 Cursor 中按 docs/CURSOR_INTEGRATION.md 的推荐流程操作用 templates/cursor/commands/ 下的命令模板创建和细化Plans.md再调用harness-plan、harness-work、harness-review技能推进任务。双方通过Plans.md中的状态标记协作如pm:依頼中/cc:TODO/cc:WIP/cc:完了/pm:確認済Cursor 只拥有 PM 标记执行侧只拥有 worker 标记避免双方同时编辑同一个任务块。3.3 开工前的 5 项健康检查文档要求共享会话开始前确认两个工具指向同一个 git 分支两个工具都能看见同一份Plans.md实现请求里写明了验收标准和预期验证命令PM 侧清楚发布是否在范围内对 Cursor 的支持表述始终包含harness 侧隔离的限定完整清单见 docs/CURSOR_INTEGRATION.md 的Minimum Sanity Check一节。边界与注意事项读懂supported的含义隔离在 harness 侧不在 Cursor 沙箱里。cursor-agent没有类似--sandbox的文件系统监狱文件写入不被硬性限制。真正的边界由 harness 提供独立 worktree 隔离、Lead 差异评审、R01–R13 策略引擎以及.cursorignore的密钥读取屏蔽。不使用绕过模式。Harness 的 Cursor 工作流从不使用--force/ Run Everything。不要夸大对齐程度。官方明确不建议声称 Cursor 与 Claude 完全一致的沙箱隔离或工具能力对齐各宿主的能力差异见 docs/hardening-parity.md 与 docs/known-limitations.md。执行侧同一问题失败 3 次就停下升级而不是继续扩大回退逻辑。小结三步走回顾bash scripts/setup-cursor.sh完成安装--check与适配器测试完成校验cursor:setup技能把 Cursor 设为默认后端后即可在 Cursor 内跑通计划→执行→评审循环。各工具的安装路线与支持等级对照可查阅 docs/onboarding/install.md 与 README.md 的Install by tool表格。【免费下载链接】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），仅供参考 如何在 Cursor 上使用 Claude Code Harness：安装、校验、运行三步走指南
如何在 Cursor 上使用 Claude Code Harness安装、校验、运行三步走指南【免费下载链接】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 是一个为 AI 编程代理打造的计划→执行→评审自主交付循环工具它也能装进 Cursor让 Cursor 成为默认实现后端。本文用安装、校验、运行三步带你快速上手一条脚本完成安装三条命令完成校验再在 Cursor 里跑通 plan→work→review 的完整循环全程不需要手动改配置文件。为什么要在 Cursor 上用 Harness一条纪律化的交付闭环用 AI 写代码最常见的坑是计划写在聊天记录里消失了、测试赶工期被跳过、评审在合并之后才发生。Claude Code Harness 的思路不是让模型更聪明而是把流程和边界固定下来写规格 → 只实现已批准的部分 → 验证 → 独立评审 → 打包证据。它围绕 5 个核心动词组织工作每个阶段都会留下下一阶段需要的材料命令作用/harness-plan把想法变成spec.mdPlans.md范围、验收标准、停止条件/harness-work只实现已批准的任务需要时自动补测试/harness-review独立于实现做评审重大问题会阻断完成/harness-sync对比计划与实际实现报告偏差/harness-release只把已验证的证据打包成发布物更关键的是安全层每一次工具调用在运行前都会经过一个 Go 引擎裁决账单、网络出站、密钥读取、生产部署这类高危操作是硬性拒绝的任何配置都无法绕过详见 docs/CURSOR_INTEGRATION.md。第一步·安装一条命令把 Harness 装进 CursorCursor 的安装通道已经通过官方验证支持等级为supported。整个安装只需两步克隆仓库如果还没有本地副本git clone https://gitcode.com/GitHub_Trending/cl/claude-code-harness cd claude-code-harness执行官方安装脚本bash scripts/setup-cursor.shscripts/setup-cursor.sh 会自动完成三件事构建 Cursor 专用插件包、校验包内容清单、技能、运行辅助脚本齐全、把插件真实拷贝到~/.cursor/plugins/local/claude-code-harness。装完后按提示执行Developer: Reload Window重载 Cursor技能和代理就会生效。两点说明脚本使用真实目录拷贝而不是软链接因为 Cursor 会拒绝外部符号链接目标如果之前装过旧版脚本会自动备份到~/.harness-skill-cleanup-archive/。仓库中的 .cursor-plugin/plugin.json 是插件清单安装时版本会与 VERSION 文件自动对齐无需手动维护。第二步·校验3 条命令确认环境就绪装完不要急着开跑花 1 分钟做校验能避免后面 90% 的技能没触发问题2.1 校验安装包本身bash scripts/setup-cursor.sh --check加--check参数表示只构建并验证 Cursor 包不执行安装。它会检查插件清单不含非法路径、核心技能完整、运行时辅助脚本齐全全部通过会输出setup-cursor --check passed。2.2 校验适配器契约bash tests/test-cursor-adapter-candidate.sh这个测试会逐项断言 Cursor 集成所需的文件与契约插件清单、.cursor/AGENTS.md 引导路由、worker/reviewer/advisor 三个代理定义、模型路由脚本可执行等源码见 tests/test-cursor-adapter-candidate.sh。2.3 校验 cursor-agent 可用性在 Cursor 中调用cursor:setup --check技能定义见 skills/cursor-setup/SKILL.md它会依次确认当前解析出的实现后端、Cursor 包就绪状态、以及cursor-agent命令行工具能否找到并打印版本。技能只报告这三个事实不会擅自改动任何设置——分布默认的 fallback 始终是claude只有你明确请求时才会改本地环境。第三步·运行设 Cursor 为默认后端跑通循环3.1 设置默认实现后端确认无误后二选一仅当前项目生效在 Cursor 中调用cursor:setup --project-default等价于bash scripts/set-impl-backend.sh cursor写入项目根的env.local全部项目生效调用cursor:setup --user-default写入~/.config/claude-harness/impl-backend.env设置是幂等的同值不重复写换值原地替换。想撤销时用cursor:setup --unset。随时可以用 scripts/set-impl-backend.sh 的--show参数查看当前生效的后端或用 scripts/resolve-impl-backend.sh 按角色解析最终结果。3.2 在 Cursor 里驱动计划-执行-评审循环后端就绪后Cursor 就是 Harness 的执行侧项目根目录的 Plans.md 是唯一的共享事实源。推荐分工Cursor 负责计划、评审签核与发布判断PM 侧Harness 负责实现与本地验证。在 Cursor 中按 docs/CURSOR_INTEGRATION.md 的推荐流程操作用 templates/cursor/commands/ 下的命令模板创建和细化Plans.md再调用harness-plan、harness-work、harness-review技能推进任务。双方通过Plans.md中的状态标记协作如pm:依頼中/cc:TODO/cc:WIP/cc:完了/pm:確認済Cursor 只拥有 PM 标记执行侧只拥有 worker 标记避免双方同时编辑同一个任务块。3.3 开工前的 5 项健康检查文档要求共享会话开始前确认两个工具指向同一个 git 分支两个工具都能看见同一份Plans.md实现请求里写明了验收标准和预期验证命令PM 侧清楚发布是否在范围内对 Cursor 的支持表述始终包含harness 侧隔离的限定完整清单见 docs/CURSOR_INTEGRATION.md 的Minimum Sanity Check一节。边界与注意事项读懂supported的含义隔离在 harness 侧不在 Cursor 沙箱里。cursor-agent没有类似--sandbox的文件系统监狱文件写入不被硬性限制。真正的边界由 harness 提供独立 worktree 隔离、Lead 差异评审、R01–R13 策略引擎以及.cursorignore的密钥读取屏蔽。不使用绕过模式。Harness 的 Cursor 工作流从不使用--force/ Run Everything。不要夸大对齐程度。官方明确不建议声称 Cursor 与 Claude 完全一致的沙箱隔离或工具能力对齐各宿主的能力差异见 docs/hardening-parity.md 与 docs/known-limitations.md。执行侧同一问题失败 3 次就停下升级而不是继续扩大回退逻辑。小结三步走回顾bash scripts/setup-cursor.sh完成安装--check与适配器测试完成校验cursor:setup技能把 Cursor 设为默认后端后即可在 Cursor 内跑通计划→执行→评审循环。各工具的安装路线与支持等级对照可查阅 docs/onboarding/install.md 与 README.md 的Install by tool表格。【免费下载链接】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），仅供参考