2026年Mac mini安裝ECC（Everything Claude Code）完整教學
/plugin install ecc@ecc，或 （B） ./install.sh --profile minimal --target claude 獲得無鉤子基線。切勿兩條路徑疊加——重複安裝是上遊文檔中的頭號支持問題。
為何在 Mac mini 上安裝 ECC？
Claude Code 在 macOS 上體驗最佳：穩定 SSH、高速 NVMe、常開在線。許多團隊選擇租用專用 Mac Mini M4，而不是把 ECC 綁在會休眠的筆記本上：
- 持久的
~/.claude狀態 — 當 harness 運行在伺服器上時，技能、鉤子與規則不會因你本地機器重啟而丟失 - 更低的 Anthropic API 延遲 — 日本節點 RTT 約 24 ms；若在台灣操作 UI，亦可評估新加坡節點（見區域矩陣）
- 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 權重下載策略類似）。租用預算請對照 定價頁（按小時/天計費，典型驗證以 3–7 天突發方案 即可跑完本教學八步）。
ECC 架構：安裝後會得到什麼
ECC（倉庫 affaan-m/ECC，npm 包 ecc-universal）會寫入各 harness 專用目錄。在 macOS 上的 Claude Code：
| 組件 | 作用 | 安裝後典型路徑 |
|---|---|---|
| 插件包 | 經 marketplace 加載技能、命令、鉤子 | 由 Claude Code 插件宿主管理 |
| Rules | 語言/框架編碼規範 | ~/.claude/rules/ecc/common/、typescript/ 等 |
| Agents | 專用子 Agent 定義 | 插件管理或 ~/.claude/agents/（視 profile） |
| Hooks 運行時 | SessionStart/Stop 自動化、記憶 | ECC_HOOK_PROFILE=minimal|standard|strict |
| 狀態存儲 | SQLite 安裝追蹤、ecc doctor | 項目或用戶作用域（依安裝器） |
三個公開標識（勿混淆）：
- 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 過重的段落。」
安裝路徑對比表
| 路徑 | 命令 | 鉤子 | 最適合 |
|---|---|---|---|
| A — 插件 | /plugin install ecc@ecc | 有（經插件） | 日常 Claude Code 用戶，最快上手 |
| B — Minimal | ./install.sh --profile minimal | 無 | 16 GB 內存、CI 堡壘機、僅要 rules |
| C — 完整手動 | ./install.sh --profile full | 有 | 離線或 marketplace 不可用環境 |
| Core 無鉤子 | --profile core --without baseline:hooks | 無 | 啟用鉤子前的折中方案 |
建議：若你租用 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 天，租用通常優於一次 NT$20,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 隧道習慣。
在遠程 M4 上運行 ECC + Claude Code
KuzCloud M4 節點數分鐘即可就緒。SSH 登錄後按本文八步安裝 ECC，按實際使用時長計費——無需購置硬體。