MacLogin 雲 Mac 運行 Everything Claude Code (ECC) 完整指南（2026）

在 MacLogin 雲端 Mac mini（Apple Silicon）上運行 Everything Claude Code（ECC），可以把 61 個代理人、246 項技能、76 個舊版指令 shim、勾子、規則與記憶工具鏈，穩定放在常開、原生 macOS 環境，而不依賴會休眠的筆電。ECC 是社群維護的開源「操作層」affaan-m/ECC（MIT），並不取代 Anthropic 的 Claude Code CLI；需搭配官方 Claude Code 文件。本文說明從 Claude Code 安裝到 ECC 外掛／手動安裝、規則包裁剪、ssh -t 與 tmux 工作流，以及租約結束輪替。

建議搭配閱讀：Claude Code SSH PTY 手冊、首次 SSH 與主機金鑰信任、SSH keepalive 與斷線排錯、Multica 在雲端 Mac 自架、Mac mini 租與買對照、租約結束下線與輪替。

為何在 MacLogin 雲端 Mac 跑 ECC，而非只用筆電

ECC 將「Claude Code 載入的 harness 表面」與「您儲存庫內的業務程式碼」分離：前者在 ~/.claude、外掛快取與選用的 SQLite 狀態演進，後者仍在 ~/projects/...。團隊選擇 MacLogin 租用 Mac mini M4，常見理由包括：原生 macOS（鑰匙圈、launchd 勾子、Apple 工具鏈一致）、7×24 SSH（ECC 長迴圈與 hook 不因闔蓋中斷），以及機房對外頻寬——從香港、東京、首爾、新加坡或美東連到 api.anthropic.com 與 npm，通常優於家用線路抖動。台灣與東北亞團隊可評估東京或首爾節點的延遲與海纜路徑；硬體可先鎖定 16GB 統一記憶體與家目錄 ≥20GB 可用空間，再視平行工作階段擴到 24GB。

記憶體方面，16GB RAM 建議同時不超過兩個重負載代理人工作階段；若常跑 /multi-* 多儲存庫流程，請監看 swap 並規畫 24GB 以上。ECC 儲存庫含大量技能檔，克隆可達數百 MB，應只在租賃機保留主副本，避免每台筆電重複 npm install。

雲端 Mac 上的 ECC 架構分層

下表列出 ECC 與 Claude Code 在租賃磁碟上的主要「表面」與職責邊界（至少五列）。公開識別不可互換：GitHub 為 affaan-m/ECC，市集外掛為 ecc@ecc，npm 常見 ecc-universal / ecc-install。

MacLogin 租賃機前置檢查

安裝 ECC 前，請確認 Node 為 v20+（安裝器依賴 npm），並完成主機金鑰信任後再寫入任何金鑰或 OAuth 工作階段。

九步上線清單（步驟 1–9）

下列 9 個步驟請依序執行；後續四個專題章節加深步驟 2、4–6、5、7。

步驟 1 — 選擇區域並以 SSH 登入

依工程師地理分佈選擇 MacLogin 節點。使用金鑰登入，並在客戶端設定 ServerAliveInterval 60，詳見 keepalive 手冊；首次登入請完成 主機金鑰信任。

步驟 2 — 安裝 Claude Code CLI

依 Anthropic 目前文件在 macOS 安裝。在租賃機執行 claude --version。訂閱流程請在互動式 TTY 執行 claude auth login。API 自動化與 OAuth 勿混在同一 shell，請參 SSH PTY 指南。

npm install -g @anthropic-ai/claude-code
claude --version

步驟 3 — 克隆 ECC 儲存庫

cd ~
git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install

儲存庫體積大；請在租賃機保留單一「黃金」克隆，筆電僅遠端編輯。

步驟 4 — 只選一種 ECC 安裝路徑

路徑 A（多數團隊推薦）— 外掛：

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

路徑 B — 最小手動（無勾子）：

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

路徑 C — core 去勾子後再按需加入：

./install.sh --profile core --without baseline:hooks --target claude
./install.sh --target claude --modules hooks-runtime

npx ecc consult "security reviews" --target claude

步驟 5 — 依需求複製規則目錄（外掛使用者）

外掛無法附帶完整 rules/。請將所需語言包整目錄複製到 ~/.claude/rules/ecc/。

步驟 6 — 校驗安裝健康

cd ~/ECC
node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair

自動化可使用 ecc status --markdown --write status.md（ECC v2.0+）。

步驟 7 — SSH 上的互動式工作流

ssh -t user@your-maclogin-host "cd ~/ECC && claude"
tmux new -As ecc
# 脫離：Ctrl-b d

步驟 8 — 試跑 ECC 指令

在租賃機 claude 內試跑如 /harness-audit、/security-scan（若已裝 AgentShield）、/sessions。若回應變慢，先查是否雙路徑安裝。

步驟 9 — 租約結束與輪替

撤銷金鑰與 OAuth，依政策刪除或歸檔 ~/.claude 覆蓋層與 ~/ECC。流程對齊 下線手冊 與 租買決策。

在租賃機安裝 Claude Code（深化）

建議固定 Node v20+ 全域 npm 前綴，避免 nvm 多版本與 launchd 服務錯位。若同時跑 API 批次與訂閱互動，請將 ANTHROPIC_API_KEY 只注入守護行程環境，人類登入 shell 僅走 claude auth login。16GB 統一記憶體下，避免同時開三個以上重推理工作階段。

ECC 外掛與安裝器跑法（深化）

外掛適合希望由市集分發技能的團隊；install.sh／npx ecc-install 適合需裁剪模組或離線稽核的場景。安裝後務必 node scripts/ecc.js doctor，並參考 Reset／Uninstall。若搭配 Multica，請讀 自架指南。

規則包與 profile 策略（深化）

複製規則時保留目錄邊界，例如同步整個 rules/typescript 與 rules/common 至 ~/.claude/rules/ecc/。monorepo 建議在根目錄統一 .claude 策略。

SSH 與 tmux 工作流（深化）

遠端非 TTY 會觸發 Input must be provided… when using --print 類錯誤。請統一 ssh -t，長時 ECC 迴圈放入 tmux，並啟用 keepalive；詳 排錯文、Claude SSH 指南。

故障排除

情境一：技能重複或事件成對

症狀：同一技能被呼叫兩次；勾子日誌成對。
原因：外掛後又執行 full profile 安裝。
修復：依 ECC 文件 清理後單一路徑重新安裝；重新安裝前執行 doctor。

情境二：單行 SSH 啟動立即結束

症狀：ssh host claude 立刻退出。
原因：未分配 PTY。
修復：改用 ssh -t 或先入 tmux。

情境三：租賃機 npm 安裝失敗

症狀：權限、逾時或 TLS 錯誤。
原因：Node 版本、出口攔截或 registry 不可達。
修復：升級 Node v20+；確認 VLAN 放行 443；必要時切換可信鏡像後再以 --prefer-offline 重試。

情境四：設定 API Key 後 OAuth 失效

症狀：Remote Control 或登入失敗且 shell 內有 ANTHROPIC_API_KEY。
原因：認證路徑衝突。
修復：unset ANTHROPIC_API_KEY 後於互動式 ssh -t 重新登入。

常見問題