2026年Mac mini安装ECC（Everything Claude Code）完整教程

为何在 Mac mini 上安装 ECC？

Claude Code 在 macOS 上体验最佳：稳定 SSH、高速 NVMe、常开在线。许多团队选择租用专用 Mac Mini M4，而不是把 ECC 绑在会休眠的笔记本上：

• 持久的 ~/.claude 状态 — 当 harness 运行在服务器上时，技能、钩子与规则不会因你本地机器重启而丢失
• 更低的 Anthropic API 延迟 — 日本节点 RTT 约 24 ms，对比错区可达 180+ ms（见区域矩阵）
• 16 GB 足够 跑 ECC + Claude Code CLI；若同时运行 OpenClaw 或重型 Docker 侧车，建议 24 GB

ECC 不能替代 Claude Code——它是其上的配置与工作流层。若你只需要裸终端 Agent、不需要 246 项技能，请先阅读Claude Code 免费替代方案。

国内团队常见痛点：Claude Code 访问与 API Key 需在合规前提下自行配置（Anthropic 控制台或企业网关）；克隆 ECC 时若 GitHub 不稳定，可使用镜像或离线包（与 HuggingFace 权重下载策略类似）。租用预算请对照 定价页（按小时/天计费，典型验证窗口 ¥约数百元起，视节点规格与时长而定）。

ECC 架构：安装后会得到什么

ECC（仓库 affaan-m/ECC，npm 包 ecc-universal）会写入各 harness 专用目录。在 macOS 上的 Claude Code：

三个公开标识（勿混淆）：

• GitHub：affaan-m/ECC
• Claude marketplace 插件：ecc@ecc
• npm CLI：ecc-universal / npx ecc-install

上游明确警告：/plugin install + ./install.sh --profile full = 重复技能与损坏的钩子。下文只选一条路。

外部参考：Anthropic Claude Code 文档。

Mac mini 前置条件

安装前请确认：

# macOS 14+ 推荐（M4 上 Sequoia 已测）
sw_vers

# Node.js 20 LTS（ECC 脚本最低 18+）
node -v    # 期望 v20.x 或 v22.x
npm -v

git --version

claude --version

全新 KuzCloud 节点可用 Homebrew 安装 Node：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node git

请预留约 2 GB 磁盘（ECC 克隆 + node_modules）、空闲约 500 MB 内存（钩子）以及 Claude Code 自身占用。首次评估可配合3–7 天突发租用完成安装与试用。

API Key：在远程 Mac 的 ~/.zshrc 或 Claude Code 配置中设置 ANTHROPIC_API_KEY（勿提交到 git）。国内网络若直连 Anthropic 不稳定，请结合企业代理或合规网关，并选择低 RTT 区域节点。

在 Mac mini 上安装 ECC：八步清单

步骤 1 — SSH 登录 Mac mini 并创建工作区

ssh -i ~/.ssh/kuzcloud.pem user@YOUR_NODE_IP
mkdir -p ~/ecc-lab && cd ~/ecc-lab

下单后凭证通常 约 5 分钟 内到达，流程与OpenClaw 远程 M4 部署相同。

步骤 2 — 克隆 ECC 仓库

git clone https://github.com/affaan-m/ECC.git
cd ECC
git checkout main   # 或固定 release 标签，如 v2.0.0-rc.1

若 git clone 超时，可换镜像 URL 或先在本地打包上传——与拉取大型 HuggingFace 模型同理。

步骤 3 — 安装 Node 依赖

npm install
# 亦可：pnpm install | yarn install | bun install

此步下载钩子适配器与安装脚本。首次运行视带宽约需 3–8 分钟。

步骤 4 — 只选一条安装路径

路径 A — Claude Code 插件（多数用户推荐）

在 Mac mini 上的交互式 Claude Code 会话中：

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

插件无法自动分发全部 rules，请仅复制需要的规则包：

mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/   # 不用 TS 可省略

路径 A 之后切勿再运行 ./install.sh --profile full。

路径 B — 手动 minimal（无钩子、开销最低）

./install.sh --profile minimal --target claude
# 等价：npx ecc-install --profile minimal --target claude

适合16 GB 节点或仅需 rules + agents、钩子过于激进的环境。

路径 C — 完整手动安装（高级用户）

./install.sh --profile full --target claude

若选路径 C，不要再执行 /plugin install ecc@ecc。

步骤 5 — 可选：安装额外模块前先 consult

npx ecc consult "security reviews typescript" --target claude
npx ecc install --profile minimal --target claude --with capability:machine-learning

先预览计划，再安装 scoped 能力，避免一次性拉满 246 项技能。

步骤 6 — 验证安装健康度

node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair

期望：doctor 报告已安装 profile，且无重复钩子注册。若出现 duplicate，请回到故障排除中的「勿重复安装」一节。

步骤 7 — 配置钩子 profile（路径 A 或 full 安装）

export ECC_HOOK_PROFILE=standard   # 或 minimal | strict
export ECC_DISABLED_HOOKS=
# 写入 ~/.zshrc 以跨 SSH 会话持久化

步骤 8 — 与 Claude Code 做冒烟测试

cd ~/ecc-lab/your-repo
claude

在会话中可运行打包命令，例如 /harness-audit，或提问：「用 ECC 技能检查 README 中 token 过重的段落。」

安装路径对比表

建议：若你租用 KuzCloud Mac mini 专跑 ECC + Claude Code，采用路径 A + 仅 rules/common，再按需增加语言包。钩子先用 ECC_HOOK_PROFILE=minimal，稳定一周后再升到 standard。

故障排除

错误：技能/命令重复执行

现象：同一斜杠命令出现两次；钩子日志显示双重 SessionStart。

原因：插件安装与 install.sh --profile full 叠加——这是最常见的「勿重复安装」违规。

修复：

node scripts/ecc.js doctor
# 按 ECC README「Reset / Uninstall ECC」清理后，仅用一条路重装

错误：远程 Mac 上找不到 claude 命令

现象：插件命令失败；claude --version 无输出。

修复：

npm install -g @anthropic-ai/claude-code
export ANTHROPIC_API_KEY=sk-ant-...
# 重新 SSH 登录后重复步骤 4

配置说明见 Claude Code 安装文档。国内请确保 API 出站与 Key 权限符合团队合规要求。

错误：marketplace 找不到 ecc@ecc

现象：/plugin install ecc@ecc 解析 marketplace 失败。

修复：跳过路径 A，改用路径 B：

cd ~/ecc-lab/ECC && ./install.sh --profile minimal --target claude

错误：npm install 时 Node OOM

现象：16 GB Mac mini 上出现 Killed: 9。

修复：临时增加 swap，或升级到24 GB 节点；若上游支持，可尝试 npm install --omit=dev。

Mac mini 租用 ECC vs 自购硬件

ECC 不依赖 Apple Silicon GPU——任意带 Node 20 与约 10 GB 可用磁盘的 M4 Mac mini 即可。若每月全勤使用 ECC 不足 22 天，租用通常优于 ¥4,000+ 级别的自购（详见Mac mini 买还是租）。下单前请在 定价页 对照小时价与 3–7 天突发窗口。

常见问题

ECC 和 Claude Code 是一回事吗？

不是。Claude Code 是 Anthropic 的 Agent 编码 CLI。ECC 是社区维护的 harness 增强包（技能、规则、钩子），仓库在 github.com/affaan-m/ECC。你需要先安装 Claude Code（或其他受支持的 harness）。

没有 Claude Code，能在 Cursor 上装 ECC 吗？

可以。ECC 支持 Cursor、Codex、OpenCode 等，通过 --target cursor 或对应安装器。本文聚焦 Mac mini 上的 Claude Code，因为这是 KuzCloud 上最常见的 workload。Cursor 用户可参考OpenClaw vs Claude Code 对比选型。

ECC 会把代码发到额外的第三方吗？

ECC 在本地增加规则、钩子与技能；LLM 调用仍走你 harness 配置的模型提供商（Anthropic、OpenAI 等）。生产仓库前请阅读 ECC Security Guide 并运行 /security-scan（AgentShield）。

如何彻底卸载 ECC？

按上游 Reset / Uninstall ECC：运行 node scripts/ecc.js 的 list/repair，删除 ~/.claude/rules/ecc/，在 Claude Code 中卸载插件，并删除 doctor 标出的重复 skill 目录。

能通过笔记本 SSH 使用远程 Mac 上的 ECC 吗？

可以。在远程 Mac mini 上安装 ECC，在 tmux 或 screen 中运行 claude；笔记本仅 SSH 接入。只有需要本地 GUI 看 ECC Tk 仪表盘（npm run dashboard）时才配置端口转发。长时间会话可参考远程 Mac 测试手册中的 SSH 隧道习惯。