AI Automation

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

MacLogin AI 自动化团队 2026年5月27日 ~14 min read
Everything Claude Code ECC on cloud Mac mini M4

在 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 工作流以及下线轮换的完整路径。

披露说明：本文涉及的 Mac 租赁服务提供方为 MacLogin。ECC 安装步骤以 affaan-m/ECC 仓库及截至 2026 年 5 月的官方文档为准；上线前请再次核对与您 CLI 版本一致的参数。

建议搭配阅读：Claude Code SSH PTY 手册、首次 SSH 与主机密钥信任、SSH keepalive 与断线排障、Multica 在云 Mac 自托管、Mac mini 租与买对比、租约结束下线与轮换。

可引用结论：先在租赁机上安装 Claude Code；每台主机只选一种 ECC 安装路径（插件 或 手动安装脚本，切勿混用）；按需复制 rules/ 语言包；交互式工作一律通过 ssh -t 与 tmux 承载。

为何在 MacLogin 云 Mac 上跑 ECC，而不是只用笔记本

ECC 把「Claude Code 加载的 harness 表面」与「你仓库里的业务代码」拆开：前者在 ~/.claude、插件缓存与可选的 SQLite 状态中演进，后者仍在 ~/projects/...。团队选择 MacLogin 租赁 Mac mini M4，通常出于三类硬需求：原生 macOS（Keychain、launchd 钩子、Apple 工具链一致）、7×24 SSH（ECC 长循环与 hook 不因合盖而中断）、以及机房出口带宽——从香港、东京、首尔、新加坡或美东访问 api.anthropic.com 与 npm，往往优于大陆家庭宽带的抖动与限速。对大陆团队，东京/新加坡节点常用来改善 TLS 握手与大包下载；若月预算约在 ¥700/月 档位，可先锁定单区域、16GB 统一内存与 ≥20GB 可用磁盘，再按并行会话扩容。

硬件层面，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。

表面租赁机上的位置用途
Claude Code CLI/usr/local/bin/claude 或 npm 全局交互式智能体、OAuth/API 路由
插件 ecc@eccClaude 市场缓存目录技能、命令、钩子，减少全量文件拷贝
手动安装（规则/技能目录）~/.claude/rules/ecc/ 等插件路径不足时的规则与 agent 覆盖
项目仓库~/projects/...Git worktree、/multi-* 多仓编排
状态存储ECC SQLite / ecc status安装体检、会话健康、工作项导出（v2.0+ 支持 --markdown）

可引用规则：不要先执行 /plugin install ecc@ecc 再跑 npx ecc-install --profile full——会重复技能并破坏钩子顺序。每台主机只保留一条安装路径。

MacLogin 租赁机前置检查

在安装 ECC 之前，请确认 Node 为 v20+（安装器依赖 npm），并完成主机密钥信任，再写入任何密钥或 OAuth 会话。

检查项命令通过标准
macOS 版本sw_vers推荐 macOS 14+
Node.jsnode -vv20+
Gitgit --version近期版本即可
磁盘df -h ~家目录可用 ≥20GB
API 可达性curl -s -o /dev/null -w '%{http_code}\n' https://api.anthropic.com返回 200 或 403（能建立 TLS 即视为可达）

九步上线清单（步骤 1–9）

下列 9 个步骤按顺序执行；后文四个专题章节对步骤 2、4–6、5、7 做加深说明。

步骤 1 — 选择区域并以 SSH 登录

按工程师地理分布选择 MacLogin 节点（大陆团队常选东京/新加坡以优化 npm 与 API）。使用密钥登录，并在客户端配置 ServerAliveInterval 60，细节见 keepalive 手册；首次登录务必完成 主机密钥信任。

步骤 2 — 安装 Claude Code CLI

按 Anthropic 当前文档在 macOS 上安装（npm 或原生安装包）。在租赁机上执行 claude --version 校验。订阅工作流请在交互式 TTY 中运行 claude auth login，勿用无伪终端的一行 SSH。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 上的交互式工作流

始终为 Claude Code 分配 PTY，并用 tmux 承载长任务：

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

步骤 8 — 试点 ECC 命令

在租赁机 claude 内试跑打包命令（名称随 profile 可能不同），例如 /harness-audit、/security-scan（若已装 AgentShield）、/sessions。若响应变慢或提示重复，优先怀疑「双路径安装」。

步骤 9 — 租约结束与轮换

退租前吊销 Anthropic 侧密钥与 OAuth 刷新凭据，按策略删除或归档 ~/.claude 中的 ECC 覆盖层及 ~/ECC。流程对齐 下线手册 与 租买决策 中的运维清单。

在租赁机上安装 Claude Code（深化）

在 MacLogin 主机上，建议固定使用 Node v20+ 的全局 npm 前缀，避免多版本 nvm 与 launchd 服务错位。若团队同时运行 API 批任务与交互式订阅，请把 ANTHROPIC_API_KEY 仅注入守护进程环境（launchd），而人类登录 shell 仅走 claude auth login。16GB 统一内存下，避免在同一 zsh 会话并行开三个以上重推理会话；观察 memory_pressure 与 swap。

ECC 插件与安装器跑法（深化）

插件路径适合希望「由市场分发技能与命令」的团队；手动 install.sh / npx ecc-install 适合需要裁剪模块或离线审计脚本的场景。无论哪条路径，安装后都应用 node scripts/ecc.js doctor 对照上游 README 的 Reset / Uninstall 段落处理漂移。若启用 Multica 与 OpenClaw 编排，请参阅 自托管指南 以核对端口与令牌边界。

规则包与 profile 策略（深化）

复制规则时请保留目录边界，例如将 rules/typescript 整个目录同步到 ~/.claude/rules/ecc/，并额外同步 rules/common 作为交叉引用基线。对单体仓库可逐步引入语言包；对多仓 monorepo，优先在根目录统一 .claude 策略，再在子仓用 worktree 隔离实验性规则。

SSH 与 tmux 工作流（深化）

Claude Code 在远程非 TTY 场景会报 Input must be provided… when using --print 类错误；根因是未分配伪终端。请统一使用 ssh -t，或在跳板脚本里强制申请 PTY。长时 ECC 智能体循环务必放入 tmux，并在客户端启用 keepalive，详见 排障文 与 Claude SSH 指南。

故障排查

场景一：技能重复或「所有事跑两遍」

症状：Claude 重复调用同一技能；钩子日志出现成对事件。
原因：插件安装后又执行了 install.sh --profile full 或等价的 full profile。
修复：按 ECC 文档 的 Reset / Uninstall 清理，再仅选一条路径重装；重装前运行 node scripts/ecc.js doctor。

场景二：无 TTY 的 SSH 一行命令启动失败

症状：ssh host claude 立即退出。
原因：未分配 PTY。
修复：改用 ssh -t user@host "claude" 或先入 tmux；对照 PTY 手册。

场景三：租赁机上 npm install 失败

症状：EACCES、注册表超时或 TLS 错误。
原因：Node 版本过低、企业出口拦截、或默认 registry 不可达。
修复：升级到 Node v20+；校验租赁 VLAN 放行 443；大陆环境可临时切换 npm 镜像（例如 npm config set registry https://registry.npmmirror.com 做试用），成功后可用 npm install --prefer-offline 复用缓存。

场景四：导出 API Key 后 OAuth 异常

症状：Remote Control 或 claude auth login 失败，同时 shell 中存在 ANTHROPIC_API_KEY。
原因：环境变量优先级与认证路径冲突。
修复：unset ANTHROPIC_API_KEY 后在交互式 ssh -t 会话重新登录；API Key 仅给守护进程/CI。

常见问题

ECC 是不是 Claude Code？
不是。Claude Code 是 Anthropic 官方 CLI/智能体；ECC 是社区 harness，叠加技能、钩子、规则与流程，源码见 affaan-m/ECC，行为仍以 官方文档为准。
是否必须购买 ECC Pro 或 GitHub App？
不必。本教程覆盖 MIT 开源插件与手动安装器；ECC Pro 仅为可选增值能力。
能否在 Linux 上替代 MacLogin？
ECC 支持多种 harness，但本文针对 macOS 租赁，以匹配 Keychain、Apple 工具链及 OpenClaw/Claude Code 在 Mac 上的运维范式。
ECC + Claude Code 在 M4 上要多少内存？
建议从 16GB 统一内存起步；默认最多两个重会话并行，再视 swap 扩容到 24GB+ 以跑并行 /multi-*。
ECC 状态存在哪里？
近期版本使用本地 SQLite 等状态存储记录安装与会话健康，数据驻留在租赁机磁盘；除非启用 ECC Tools 市场特性，否则不是独立 SaaS。
MacLogin AI 自动化团队
专注 Claude Code、ECC 与 Apple Silicon 云端运行时。

为 ECC + Claude Code 租用云 Mac

港日韩星美区域数分钟部署，约 ¥700/月起。