Установка ECC на Mac mini 2026: Everything Claude Code

Зачем ставить ECC на Mac mini

Claude Code лучше всего работает на macOS со стабильным SSH, быстрым NVMe и постоянной доступностью. Многие команды арендуют выделенный Mac mini M4, а не привязывают ECC к ноутбуку в режиме сна.

• Постоянное состояние ~/.claude — навыки, хуки и правила переживают перезагрузки вашей локальной машины, если харнес живёт на сервере
• Низкая задержка до API Anthropic — при правильном регионе порядка ~24 мс RTT против 180+ мс при несоответствии (матрица регионов). Тарифы и справка: tseny и pomoshch.
• 16 ГБ достаточно для ECC + CLI Claude Code; 24 ГБ, если дополнительно OpenClaw или тяжёлые Docker-сайдкары

ECC не заменяет Claude Code — это слой конфигурации и рабочих процессов поверх него. Если нужен только минимальный терминальный агент без 246 навыков, сначала см. бесплатные альтернативы Claude Code.

Архитектура ECC: что устанавливается

ECC (репозиторий affaan-m/ECC, npm: ecc-universal) ставится в каталоги, зависящие от харнеса. Для Claude Code на macOS:

Три публичных идентификатора (не путать):

1. GitHub: affaan-m/ECC
2. Плагин маркетплейса Claude: ecc@ecc
3. npm CLI: ecc-universal / npx ecc-install

Upstream предупреждает: /plugin install + ./install.sh --profile full = дубли навыков и сломанные хуки. Ниже выберите один путь.

Внешняя ссылка: документация Anthropic Claude Code.

Предварительные требования на Mac mini

Перед установкой проверьте:

# macOS 14+ рекомендуется (Sequoia на M4 проверена) sw_vers # Node.js 20 LTS (минимум 18+ для скриптов ECC) node -v # ожидайте v20.x или v22.x npm -v # Git git --version # CLI Claude Code (при отсутствии установите отдельно) claude --version

На новом узле KuzCloud установите Node через Homebrew:

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

Заложите ~2 ГБ диска под клон ECC и node_modules, ~500 МБ ОЗУ в простое на хуки плюс объём самого Claude Code. Для окна аренды первичной настройки часто хватает всплеска 3–7 дней.

Установка ECC на Mac mini: сценарий из 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 — Выбрать один путь установки

Путь A — плагин Claude Code (рекомендуется большинству)

В интерактивной сессии Claude Code на Mac mini:

/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/ # без TS — пропустите

Не запускайте ./install.sh --profile full после пути A.

Путь B — ручной minimal (без хуков, минимальные накладные расходы)

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

Эквивалент:

npx ecc-install --profile minimal --target claude

Путь B на узлах 16 ГБ, если хуки слишком агрессивны или нужны только правила и агенты.

Путь C — полная ручная установка (только для опытных)

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

Не используйте также /plugin install ecc@ecc, если выбран путь C.

Шаг 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 # безопасный первый проход repair при замечаниях doctor

Ожидается: doctor сообщает об установленных профилях без дублирования регистрации хуков.

Шаг 7 — Профиль хуков (только путь A или full)

export ECC_HOOK_PROFILE=standard # или minimal | strict export ECC_DISABLED_HOOKS= # отключить отдельные хуки через запятую

Добавьте в ~/.zshrc на Mac mini для сохранения между SSH-сессиями.

Шаг 8 — Дымовой тест Claude Code с ECC

cd ~/ecc-lab/sample-project # ваш репозиторий claude

В сессии, пример упакованной команды:

/harness-audit

Или запрос: «Проверь README навыками ECC на избыточные по токенам фрагменты».

Сравнительная таблица путей

Рекомендация: если арендуете KuzCloud Mac mini только под ECC + Claude Code, начните с пути A + только rules/common, языковые пакеты добавляйте постепенно. Хуки сначала с ECC_HOOK_PROFILE=minimal; до standard — после недели стабильной работы.

Устранение неполадок

Ошибка: дубли навыков / команды срабатывают дважды

Симптом: одна и та же slash-команда дважды; в логах хуков двойной SessionStart.

Причина: совмещены установка плагина и full install.sh.

Исправление:

node scripts/ecc.js doctor # Следуйте README ECC «Reset / Uninstall ECC» # Затем переустановите только одним путём

Ошибка: claude: command not found на удалённом Mac

Симптом: команды плагина не работают; claude --version не найден.

Исправление:

npm install -g @anthropic-ai/claude-code # Или https://docs.anthropic.com/en/docs/claude-code/setup export ANTHROPIC_API_KEY=sk-ant-...

Переподключитесь по SSH и повторите шаг 4.

Ошибка: плагин ecc@ecc не найден в маркетплейсе

Симптом: сбой /plugin install ecc@ecc при разрешении маркетплейса.

Исправление: пропустите путь A; используйте путь B:

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

Ошибка: OOM Node во время npm install

Симптом: Killed: 9 при установке на Mac mini 16 ГБ.

Исправление: временно добавьте swap или перейдите на узел 24 ГБ; при поддержке upstream — npm install --omit=dev.

ECC на Mac mini: аренда и покупка

ECC не требует GPU Apple Silicon — достаточно любого Mac mini M4 с Node 20 и ~10 ГБ свободного диска. Если ECC нужен реже 22 полных дней в месяц, аренда часто выгоднее покупки от $599 (гайд аренда vs покупка). Страницы tseny и pomoshch KuzCloud.

Частые вопросы

ECC — это то же самое, что Claude Code?

Нет. Claude Code — агентская CLI для кода от Anthropic. ECC — поддерживаемый сообществом пакет расширения харнеса (навыки, правила, хуки) на github.com/affaan-m/ECC. Сначала нужен Claude Code (или другой поддерживаемый харнес).

Можно ли поставить ECC в Cursor без Claude Code?

Да. ECC поддерживает Cursor, Codex, OpenCode и др. через --target cursor или отдельные инсталляторы. Это руководство сфокусировано на Claude Code на Mac mini — самый частый сценарий KuzCloud.

Отправляет ли ECC мой код дополнительным третьим лицам?

ECC добавляет локальные правила, хуки и навыки. Вызовы LLM по-прежнему идут через провайдера модели вашего харнеса (Anthropic, OpenAI и т. д.). Изучите Security Guide ECC и выполните /security-scan (AgentShield) перед продакшен-репозиториями.

Как полностью удалить ECC?

Следуйте разделу upstream Reset / Uninstall ECC: команды repair/list node scripts/ecc.js, удаление ~/.claude/rules/ecc/, удаление плагина в Claude Code и дублирующих папок навыков по указанию doctor.

Работает ли ECC по SSH с ноутбука?

Да. Установите ECC на удалённый Mac mini, запускайте claude в tmux или screen, подключайтесь с ноутбука по SSH. Проброс портов нужен только для локального GUI к Tk-панели ECC (npm run dashboard).