装 Harness 之前先搞清楚定位：它不是给系统全局装的普通命令行工具，而是给 Claude Code 用的一个插件/全局技能，作用是生成 agent 团队和 skill。接下来咱们按最稳妥的步骤来。

准备条件

首先，你得确保机器上能正常用 Claude Code。其次，你的项目最好有明确的任务边界，比如是代码库、产品文档、测试流程或者内容生产流程这类。最后，要是想用 Agent Teams 功能，得先开环境变量的实验开关。

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

这个变量可不是摆样子的。Harness 默认会优先用 Agent Teams 模式，要是任务需要两个以上 agent 互相沟通、审核或者接力干活，没开这个开关大概率跑不起来。

方式一：通过 Marketplace 安装

官方 README 里给的插件安装方法，是先加 marketplace 源，再装 harness。

/plugin marketplace add revfactory/harness
/plugin install harness@harness-marketplace

执行完可以去 Claude Code 里看看插件有没有装上。要是提示找不到 marketplace，先确认你当前的 Claude Code 版本支不支持插件市场，再排查下网络和账号环境有没有问题。

方式二：直接安装全局 Skill

要是你已经把仓库克隆到本地了，也可以直接把 skill 目录复制到全局 skill 的路径下。

git clone https://github.com/revfactory/harness.git
cd harness
cp -r skills/harness ~/.claude/skills/harness

这个方法的好处是路径明明白白，适合想先仔细读 SKILL.md 和 references 内容的朋友。缺点就是后续更新得自己拉取仓库、重新复制文件。

安装后怎么验证

随便进一个测试项目，在 Claude Code 里输入这句话：

Build a harness for this project

想更明确的话也可以这么说：

Design an agent team for this domain
Set up a harness

正常来说，它会先分析你这个项目的领域，再给出团队架构方案，然后自动生成 `.claude/agents/` 和 `.claude/skills/` 目录和文件。要是它只给了一段普通的建议，没生成任何目录和文件，那大概率是触发方式、安装位置或者 Claude Code 的功能权限没对上。

常见排查

找不到 Harness？先检查下 `~/.claude/skills/harness/SKILL.md` 这个文件在不在。

建不了团队？看看 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 这个环境变量在当前终端会话里有没有生效。

生成的文件太笼统？重新描述清楚你的项目领域、现有流程、想拆出来的专家角色，还有想要的交付格式就行。

只是想单次调用专家角色？不一定非要用 Agent Teams，让 Harness 选 subagent 或者混合模式就可以。

安装建议

第一次用的话，建议先拿空白测试项目练手，别直接在生产仓库里生成一整套 agents 和 skills。等确认输出的结构符合你的预期了，再迁到真实项目里调整。这样能把安装问题、设计问题和项目文件变更这几类问题分开排查，不容易乱。