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・常時稼働と相性が良いです。多くのチームはスリープするノート PCではなく、専用の Mac mini M4 をレンタルして ECC を載せます。
- 永続的な
~/.claude状態 — ハーネスをサーバー側に置けば、スキル・フック・ルールがローカル端末の再起動後も維持されます - Anthropic API への低遅延 — 東京ノードでは RTT 約 24 ms。リージョンが噛み合わないと 180 ms 超になることもあります（リージョンマトリクス）
- 16 GB で十分 — ECC ＋ Claude Code CLI。さらに OpenClaw や重い Docker サイドカーを動かすなら 24 GB を検討してください
ECC は Claude Code の置き換えではなく、その上に載る設定・ワークフロー層です。246 スキルが不要なら、先に Claude Code の無料代替 を確認してください。
ECC アーキテクチャ：何がインストールされるか
ECC（リポジトリ affaan-m/ECC、npm: ecc-universal）はハーネスごとのディレクトリに展開されます。macOS の Claude Code の場合：
| コンポーネント | 役割 | インストール後の典型パス |
|---|---|---|
| プラグインバンドル | マーケットプレイス経由のスキル・コマンド・フック | Claude Code のプラグインホストが読み込み |
| Rules | 言語・フレームワークのコーディング規約 | ~/.claude/rules/ecc/common/、~/.claude/rules/ecc/typescript/ など |
| Agents | 専門サブエージェント定義 | プラグイン管理、または ~/.claude/agents/（プロファイル依存） |
| Hooks ランタイム | SessionStart/Stop の自動化、メモリ | ECC_HOOK_PROFILE=minimal|standard|strict |
| State store | SQLite によるインストール追跡、ecc doctor |
インストーラに応じてプロジェクトまたはユーザー範囲 |
混同しない 3 つの公開識別子：
- GitHub:
affaan-m/ECC - Claude マーケットプレイス・プラグイン:
ecc@ecc - npm CLI:
ecc-universal/npx ecc-install
上流の注意：/plugin install と ./install.sh --profile full を併用すると、スキルが重複しフックが壊れます。 下記の手順から1 経路だけ選んでください。
外部参考：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
git --version
# Claude Code CLI（未導入なら別途インストール）
claude --version
初期状態の KuzCloud ノードでは Homebrew で Node を入れます。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node git
ディスクは ECC のクローンと node_modules で約 2 GB、フック待機時の RAM は約 500 MB、さらに Claude Code 本体の分を見込んでください。レンタル期間の目安は、初回の ECC セットアップと評価なら 3〜7 日のバーストで足りることが多いです。
Mac mini に ECC をインストール：8 ステップの手順書
ステップ 1 — SSH で Mac mini に入りワークスペースを作る
ssh -i ~/.ssh/kuzcloud.pem user@YOUR_NODE_IP
mkdir -p ~/ecc-lab && cd ~/ecc-lab
認証情報は注文から約 5 分で届くことが多いです。他の リモート Mac 向けガイドと同じ流れです。
ステップ 2 — ECC リポジトリをクローンする
git clone https://github.com/affaan-m/ECC.git
cd ECC
git checkout main # または v2.0.0-rc.1 などリリースタグに固定
ステップ 3 — Node 依存関係をインストールする
npm install
# 代替: pnpm install | yarn install | bun install
フック用アダプタとインストーラを取得します。初回は帯域により3〜8 分かかることがあります。
ステップ 4 — インストール経路を 1 つだけ選ぶ
経路 A — Claude Code プラグイン（多くのユーザー向け）
Mac mini 上の対話型 Claude Code セッション内で：
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc
続けて、必要なルールパックだけを手動コピーします（プラグインはルールを自動配布しません）。
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/ # TypeScript を使わないなら省略
経路 A のあとに ./install.sh --profile full は実行しないでください。
経路 B — 手動 minimal プロファイル（フックなし・オーバーヘッド最小）
./install.sh --profile minimal --target claude
同等の方法：
npx ecc-install --profile minimal --target claude
16 GB ノードでフックが強すぎる場合、ルールとエージェントだけ欲しい場合に適します。
経路 C — 手動 full（上級者のみ）
./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
ステップ 6 — インストールの健全性を確認する
node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair # doctor に問題があれば安全な初回修復
doctor が、フックの二重登録なしでプロファイルが報告されることを確認します。
ステップ 7 — フックプロファイルを設定する（経路 A または full のみ）
export ECC_HOOK_PROFILE=standard # または minimal | strict
export ECC_DISABLED_HOOKS= # 無効化するフックをカンマ区切り
Mac mini の ~/.zshrc に追記し、SSH セッションをまたいで維持します。
ステップ 8 — ECC 付き Claude Code をスモークテストする
cd ~/ecc-lab/sample-project # お手持ちのリポジトリ
claude
セッション内でパッケージ済みコマンドの例：
/harness-audit
または「ECC のスキルでこの README のトークン過多な箇所をレビューして」と依頼しても構いません。
経路比較表
| 経路 | コマンド | フック | 向いている用途 |
|---|---|---|---|
| A — プラグイン | /plugin install ecc@ecc |
あり（プラグイン経由） | 毎日 Claude Code を使う方、最短オンボーディング |
| B — Minimal | ./install.sh --profile minimal |
なし | 16 GB RAM、CI 踏み台、ルールのみ |
| C — Full 手動 | ./install.sh --profile full |
あり | エアギャップ、マーケットプレイスが使えない環境 |
| Core（フックなし） | --profile core --without baseline:hooks |
なし | フックを有効化する前の中間案 |
推奨：KuzCloud の Mac mini を ECC ＋ Claude Code 専用にするなら、経路 A ＋ rules/common のみから始め、言語パックは段階的に追加してください。フックはまず ECC_HOOK_PROFILE=minimal で 1 週間安定させ、そのあと必要なら standard に上げます。
トラブルシューティング
エラー：スキルやコマンドが重複する／2 回動く
症状：同じスラッシュコマンドが 2 つ表示される。フックログで SessionStart が二重。
原因：プラグイン導入と full の install.sh を積み重ねた。
対処：
node scripts/ecc.js doctor
# ECC README の「Reset / Uninstall ECC」に従ってリセット
# その後、経路は 1 つだけで再インストール
エラー：リモート Mac で claude: command not found
症状：プラグインのコマンドが失敗する。claude --version が見つからない。
対処：
npm install -g @anthropic-ai/claude-code
# または https://docs.anthropic.com/en/docs/claude-code/setup
export ANTHROPIC_API_KEY=sk-ant-...
再接続したうえでステップ 4 をやり直してください。
エラー：マーケットプレイスで ecc@ecc が見つからない
症状：/plugin install ecc@ecc が名前解決で失敗する。
対処：経路 A を飛ばし経路 B を使います。
cd ~/ecc-lab/ECC && ./install.sh --profile minimal --target claude
エラー：npm install 中に Node が OOM になる
症状：16 GB の Mac mini で Killed: 9。
対処：一時的にスワップを増やすか、24 GB ノードへ切り替える。上流がサポートしていれば npm install --omit=dev も検討できます。
Mac mini での ECC：レンタルと購入
ECC に Apple Silicon の GPU は必須ではありません。Node 20 と空きディスク約 10 GB があれば十分です。月に ECC を使うのが22 日満載未満なら、599 ドル超の購入よりレンタルが有利なことが多いです（レンタルと購入の比較）。
よくある質問
ECC は Claude Code と同じですか？
いいえ。Claude Code は Anthropic のエージェント型コーディング CLI です。ECC は github.com/affaan-m/ECC で保守されているコミュニティ製のハーネス拡張パック（スキル・ルール・フック）です。先に Claude Code（または対応する別ハーネス）が必要です。
Claude Code がなくても Cursor に ECC を入れられますか？
はい。ECC は Cursor、Codex、OpenCode などにも対応しており、--target cursor（またはハーネス別インストーラ）を使います。本稿は KuzCloud で最も多いワークロードである Mac mini 上の Claude Codeに焦点を当てています。
ECC はコードを追加の第三者に送りますか？
ECC はローカルのルール・フック・スキルを追加します。LLM 呼び出しは、お使いのハーネスが選ぶプロバイダ（Anthropic、OpenAI など）を経由します。本番リポジトリの前に ECC の Security Guide を確認し、/security-scan（AgentShield）を実行してください。
ECC を完全にアンインストールするには？
上流のReset / Uninstall ECCの節に従います。node scripts/ecc.js の repair / list コマンドを実行し、~/.claude/rules/ecc/ を削除し、Claude Code からプラグインをアンインストールし、doctor が指摘する重複スキルフォルダを削除します。
ノート PC から SSH 越しに ECC は使えますか？
はい。リモートの Mac mini に ECC をインストールし、tmux または screen 内で claude を実行し、ノート PCから SSH で接続します。ECC の Tk ダッシュボード（npm run dashboard）をローカル GUI で見る場合だけ、ポートフォワードが必要になることがあります。