Claude Code Harness 多宿主部署指南：Claude Code、Codex、Cursor、Grok 四端并用完全实战-平芜编程栈

Claude Code Harness 多宿主部署指南：Claude Code、Codex、Cursor、Grok 四端并用完全实战

【免费下载链接】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是一款让 AI 编程助手实现「计划→执行→评审→发布」自动化闭环的开发驾驭框架。本指南带你完成Claude Code Harness 多宿主部署，一次把 Claude Code、Codex CLI、Cursor、Grok 四个宿主全部接上，共享同一套工作流技能与安全护栏，无需为每个工具单独配置。

为什么需要 Claude Code Harness 多宿主部署

很多开发者同时开着 Claude Code 写核心逻辑、Cursor 做 UI 调整、Codex CLI 跑自动化任务。如果每个宿主都"裸奔"，会遇到三个问题：

工作流不统一：这边写计划，那边直接动手，进度互相打架；
安全规则碎片化：每个宿主各写一套拦截规则，容易漏网；
上下文丢失：换工具就要重新交代背景。

Claude Code Harness 的做法是：用一份宿主注册表统一管理四端的安装脚本、引导入口与安全模型，让所有宿主收敛到同一个Plan → Work → Review → Release循环里。核心元数据定义在 hosts/registry.json，钩子能力描述在 hosts.toml。

四端支持状态一览表

部署前先看清每个宿主的支持等级（supported= 正式对应，即 H1–H8 全项验证通过，标准详见 docs/plans/phase-111-multi-host-supported.md）：

宿主	支持等级	安装方式	安全模型	引导入口
Claude Code	✅ supported	插件市场	PreToolUse 前置拦截	SessionStart 钩子
Codex CLI	✅ supported	一键脚本	Bash 拦截 + 后置闸门	AGENTS.md
Cursor	✅ supported	一键脚本	部分拦截（无文件系统围栏）	AGENTS.md + 插件
Grok	✅ supported	一键脚本	Claude 兼容信封拦截	AGENTS.md + 插件

💡 小贴士：四端共用skills/下的 harness-plan、harness-work、harness-review 等技能，装一次仓库、四端全通。

第 0 步：克隆仓库（只需一次）

git clone https://gitcode.com/GitHub_Trending/cl/claude-code-harness.git cd claude-code-harness

第 1 步：最快部署 Claude Code（插件市场方式）

Claude Code 是 Harness 的"主场"，走插件市场，最省事。在 Claude Code 会话内依次输入：

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

验收：运行/harness-sync，能看到Plans.md状态可读、下一步建议是 plan / work / review / release，就说明部署成功。更新只需/plugin update claude-code-harness再跑一次/harness-setup。

第 2 步：一键部署 Codex CLI

确保本机已安装 Codex CLI 后，在仓库根目录运行：

./scripts/setup-codex.sh --user

这个脚本会做三件事：把 harness 系列技能拷入CODEX_HOME（默认~/.codex/skills/）、写入配置、清理旧版遗留技能（脚本源码见 scripts/setup-codex.sh）。

--user：装到用户级，全局可用（默认）；
--project：装到当前项目.codex/目录，配合项目级 AGENTS.md 生效。

验收命令：

test -d "${CODEX_HOME:-$HOME/.codex}/skills/harness-plan" && echo OK

然后在 Codex 里输入Use $harness-plan to create a plan for this change.即可看到计划技能被调用。

第 3 步：部署 Cursor 编辑器

./scripts/setup-cursor.sh

脚本会把 Harness 注册为 Cursor 本地插件（落在~/.cursor/plugins/local/）。两个注意点：

装完后必须重载窗口（Developer: Reload Window），插件和技能才会注册；
不要尝试用符号链接方式指向仓库目录，Cursor 会拒绝目录外的链接目标。

验收：重载后在对话框输入/harness-plan或/breezing，能列出 Harness 技能即成功。也可运行bash scripts/setup-cursor.sh --check做静态自检。

⚠️ 已知限制：Cursor 端没有传统文件系统围栏，隔离由 Harness 侧承担，详见 docs/CURSOR_INTEGRATION.md 与 docs/known-limitations.md。

第 4 步：接入 Grok

./scripts/setup-grok.sh

脚本优先走 Grok CLI 的plugin install通道；如果本机没有 Grok CLI，会自动回退为把插件目录真实拷贝到~/.grok/plugins/claude-code-harness（非符号链接）。装完重启 Grok 或开新会话即可。

验收：Grok 中能看到/harness-plan、/breezing技能列表。Grok 端的安全模型是 Claude 兼容信封（deny 报文与 Claude 逐字节一致），并非完整复刻 Claude 的 SessionStart 能力，边界说明见 hosts.toml 中[grok]段。

统一安全底座：四端为什么同样放心

多宿主部署最大的价值不在"装得上"，而在安全规则的一致性。Harness 用 Go 编写的原生运行时（内部代号 HOKAGE）为四个宿主提供同一套工具调用前置拦截：

四端的钩子最终都收敛到harness hook pre-tool入口，危险命令（如git push --force）会被统一拒绝；
各宿主的拦截差异（exit 码、报文格式）由 hosts.toml 的deny/transport字段声明式配置，新增宿主只需加一个段；
发布前还有 fail-closed 的预检闸门，任何一端不达标都会拦住发布流程。

宿主能力对照矩阵完整收录在 docs/tool-capability-matrix.md，建议部署前通读一遍。

日常运维：更新与卸载

宿主	更新	卸载
Claude Code	`/plugin update claude-code-harness`	`/plugin uninstall claude-code-harness`
Codex CLI	`git pull --ff-only && ./scripts/setup-codex.sh --user`	把`CODEX_HOME/skills/harness-*`移入备份目录
Cursor	`git pull --ff-only && ./scripts/setup-cursor.sh`	移除`~/.cursor/plugins/local/claude-code-harness`
Grok	`git pull --ff-only && ./scripts/setup-grok.sh`	`grok plugin uninstall claude-code-harness --confirm`