如何在 Cursor 上使用 Claude Code Harness安裝、校驗(yàn)、運(yùn)行三步走指南【免費(fèi)下載鏈接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle項(xiàng)目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harnessClaude Code Harness 是一個(gè)為 AI 編程代理打造的計(jì)劃→執(zhí)行→評(píng)審自主交付循環(huán)工具它也能裝進(jìn) Cursor讓 Cursor 成為默認(rèn)實(shí)現(xiàn)后端。本文用安裝、校驗(yàn)、運(yùn)行三步帶你快速上手一條腳本完成安裝三條命令完成校驗(yàn)再在 Cursor 里跑通 plan→work→review 的完整循環(huán)全程不需要手動(dòng)改配置文件。為什么要在 Cursor 上用 Harness一條紀(jì)律化的交付閉環(huán)用 AI 寫(xiě)代碼最常見(jiàn)的坑是計(jì)劃寫(xiě)在聊天記錄里消失了、測(cè)試趕工期被跳過(guò)、評(píng)審在合并之后才發(fā)生。Claude Code Harness 的思路不是讓模型更聰明而是把流程和邊界固定下來(lái)寫(xiě)規(guī)格 → 只實(shí)現(xiàn)已批準(zhǔn)的部分 → 驗(yàn)證 → 獨(dú)立評(píng)審 → 打包證據(jù)。它圍繞 5 個(gè)核心動(dòng)詞組織工作每個(gè)階段都會(huì)留下下一階段需要的材料命令作用/harness-plan把想法變成spec.mdPlans.md范圍、驗(yàn)收標(biāo)準(zhǔn)、停止條件/harness-work只實(shí)現(xiàn)已批準(zhǔn)的任務(wù)需要時(shí)自動(dòng)補(bǔ)測(cè)試/harness-review獨(dú)立于實(shí)現(xiàn)做評(píng)審重大問(wèn)題會(huì)阻斷完成/harness-sync對(duì)比計(jì)劃與實(shí)際實(shí)現(xiàn)報(bào)告偏差/harness-release只把已驗(yàn)證的證據(jù)打包成發(fā)布物更關(guān)鍵的是安全層每一次工具調(diào)用在運(yùn)行前都會(huì)經(jīng)過(guò)一個(gè) Go 引擎裁決賬單、網(wǎng)絡(luò)出站、密鑰讀取、生產(chǎn)部署這類高危操作是硬性拒絕的任何配置都無(wú)法繞過(guò)詳見(jiàn) docs/CURSOR_INTEGRATION.md。第一步·安裝一條命令把 Harness 裝進(jìn) CursorCursor 的安裝通道已經(jīng)通過(guò)官方驗(yàn)證支持等級(jí)為supported。整個(gè)安裝只需兩步克隆倉(cāng)庫(kù)如果還沒(méi)有本地副本git clone https://gitcode.com/GitHub_Trending/cl/claude-code-harness cd claude-code-harness執(zhí)行官方安裝腳本bash scripts/setup-cursor.shscripts/setup-cursor.sh 會(huì)自動(dòng)完成三件事構(gòu)建 Cursor 專用插件包、校驗(yàn)包內(nèi)容清單、技能、運(yùn)行輔助腳本齊全、把插件真實(shí)拷貝到~/.cursor/plugins/local/claude-code-harness。裝完后按提示執(zhí)行Developer: Reload Window重載 Cursor技能和代理就會(huì)生效。兩點(diǎn)說(shuō)明腳本使用真實(shí)目錄拷貝而不是軟鏈接因?yàn)?Cursor 會(huì)拒絕外部符號(hào)鏈接目標(biāo)如果之前裝過(guò)舊版腳本會(huì)自動(dòng)備份到~/.harness-skill-cleanup-archive/。倉(cāng)庫(kù)中的 .cursor-plugin/plugin.json 是插件清單安裝時(shí)版本會(huì)與 VERSION 文件自動(dòng)對(duì)齊無(wú)需手動(dòng)維護(hù)。第二步·校驗(yàn)3 條命令確認(rèn)環(huán)境就緒裝完不要急著開(kāi)跑花 1 分鐘做校驗(yàn)?zāi)鼙苊夂竺?90% 的技能沒(méi)觸發(fā)問(wèn)題2.1 校驗(yàn)安裝包本身bash scripts/setup-cursor.sh --check加--check參數(shù)表示只構(gòu)建并驗(yàn)證 Cursor 包不執(zhí)行安裝。它會(huì)檢查插件清單不含非法路徑、核心技能完整、運(yùn)行時(shí)輔助腳本齊全全部通過(guò)會(huì)輸出setup-cursor --check passed。2.2 校驗(yàn)適配器契約bash tests/test-cursor-adapter-candidate.sh這個(gè)測(cè)試會(huì)逐項(xiàng)斷言 Cursor 集成所需的文件與契約插件清單、.cursor/AGENTS.md 引導(dǎo)路由、worker/reviewer/advisor 三個(gè)代理定義、模型路由腳本可執(zhí)行等源碼見(jiàn) tests/test-cursor-adapter-candidate.sh。2.3 校驗(yàn) cursor-agent 可用性在 Cursor 中調(diào)用cursor:setup --check技能定義見(jiàn) skills/cursor-setup/SKILL.md它會(huì)依次確認(rèn)當(dāng)前解析出的實(shí)現(xiàn)后端、Cursor 包就緒狀態(tài)、以及cursor-agent命令行工具能否找到并打印版本。技能只報(bào)告這三個(gè)事實(shí)不會(huì)擅自改動(dòng)任何設(shè)置——分布默認(rèn)的 fallback 始終是claude只有你明確請(qǐng)求時(shí)才會(huì)改本地環(huán)境。第三步·運(yùn)行設(shè) Cursor 為默認(rèn)后端跑通循環(huán)3.1 設(shè)置默認(rèn)實(shí)現(xiàn)后端確認(rèn)無(wú)誤后二選一僅當(dāng)前項(xiàng)目生效在 Cursor 中調(diào)用cursor:setup --project-default等價(jià)于bash scripts/set-impl-backend.sh cursor寫(xiě)入項(xiàng)目根的env.local全部項(xiàng)目生效調(diào)用cursor:setup --user-default寫(xiě)入~/.config/claude-harness/impl-backend.env設(shè)置是冪等的同值不重復(fù)寫(xiě)換值原地替換。想撤銷時(shí)用cursor:setup --unset。隨時(shí)可以用 scripts/set-impl-backend.sh 的--show參數(shù)查看當(dāng)前生效的后端或用 scripts/resolve-impl-backend.sh 按角色解析最終結(jié)果。3.2 在 Cursor 里驅(qū)動(dòng)計(jì)劃-執(zhí)行-評(píng)審循環(huán)后端就緒后Cursor 就是 Harness 的執(zhí)行側(cè)項(xiàng)目根目錄的 Plans.md 是唯一的共享事實(shí)源。推薦分工Cursor 負(fù)責(zé)計(jì)劃、評(píng)審簽核與發(fā)布判斷PM 側(cè)Harness 負(fù)責(zé)實(shí)現(xiàn)與本地驗(yàn)證。在 Cursor 中按 docs/CURSOR_INTEGRATION.md 的推薦流程操作用 templates/cursor/commands/ 下的命令模板創(chuàng)建和細(xì)化Plans.md再調(diào)用harness-plan、harness-work、harness-review技能推進(jìn)任務(wù)。雙方通過(guò)Plans.md中的狀態(tài)標(biāo)記協(xié)作如pm:依頼中/cc:TODO/cc:WIP/cc:完了/pm:確認(rèn)済Cursor 只擁有 PM 標(biāo)記執(zhí)行側(cè)只擁有 worker 標(biāo)記避免雙方同時(shí)編輯同一個(gè)任務(wù)塊。3.3 開(kāi)工前的 5 項(xiàng)健康檢查文檔要求共享會(huì)話開(kāi)始前確認(rèn)兩個(gè)工具指向同一個(gè) git 分支兩個(gè)工具都能看見(jiàn)同一份Plans.md實(shí)現(xiàn)請(qǐng)求里寫(xiě)明了驗(yàn)收標(biāo)準(zhǔn)和預(yù)期驗(yàn)證命令PM 側(cè)清楚發(fā)布是否在范圍內(nèi)對(duì) Cursor 的支持表述始終包含harness 側(cè)隔離的限定完整清單見(jiàn) docs/CURSOR_INTEGRATION.md 的Minimum Sanity Check一節(jié)。邊界與注意事項(xiàng)讀懂supported的含義隔離在 harness 側(cè)不在 Cursor 沙箱里。cursor-agent沒(méi)有類似--sandbox的文件系統(tǒng)監(jiān)獄文件寫(xiě)入不被硬性限制。真正的邊界由 harness 提供獨(dú)立 worktree 隔離、Lead 差異評(píng)審、R01–R13 策略引擎以及.cursorignore的密鑰讀取屏蔽。不使用繞過(guò)模式。Harness 的 Cursor 工作流從不使用--force/ Run Everything。不要夸大對(duì)齊程度。官方明確不建議聲稱 Cursor 與 Claude 完全一致的沙箱隔離或工具能力對(duì)齊各宿主的能力差異見(jiàn) docs/hardening-parity.md 與 docs/known-limitations.md。執(zhí)行側(cè)同一問(wèn)題失敗 3 次就停下升級(jí)而不是繼續(xù)擴(kuò)大回退邏輯。小結(jié)三步走回顧bash scripts/setup-cursor.sh完成安裝--check與適配器測(cè)試完成校驗(yàn)cursor:setup技能把 Cursor 設(shè)為默認(rèn)后端后即可在 Cursor 內(nèi)跑通計(jì)劃→執(zhí)行→評(píng)審循環(huán)。各工具的安裝路線與支持等級(jí)對(duì)照可查閱 docs/onboarding/install.md 與 README.md 的Install by tool表格?！久赓M(fèi)下載鏈接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle項(xiàng)目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考