Установка среды выполнения агента
AACWorkflow управляет любыми AI-инструментами для кодинга, установленными на вашей машине. Эта страница показывает, как установить каждый из 16 поддерживаемых инструментов, чтобы демон мог их обнаружить.
Среда выполнения в AACWorkflow — это демон на вашей машине в паре с одним AI-инструментом для кодинга, который демон нашёл в вашем PATH. Если при подключении среды выполнения отображается сообщение Не обнаружено поддерживаемых инструментов, значит демон просканировал PATH и не нашёл ни одного из 16 инструментов, которыми умеет управлять. Установите один (или несколько) инструментов из списка ниже, затем вернитесь к этому шагу и выполните повторное сканирование — среда выполнения появится в течение нескольких секунд.
Эта страница — установочный компаньон к следующим разделам:
- Демон и среды выполнения — как работает обнаружение
- Матрица AI-инструментов — что каждый инструмент умеет и не умеет (возобновление сессии, MCP, выбор модели)
Сервер AACWorkflow никогда не видит ваши API-ключи или сами инструменты. Всё описанное ниже — установка, аутентификация, доступ к моделям — находится на вашей локальной машине. Если что-то не работает, почти всегда это локальная проблема.
Перед началом
Два обязательных требования для каждого инструмента ниже:
- Демон AACWorkflow должен быть запущен. Выполните
aacworkflow daemon startпосле установки CLI AACWorkflow или используйте десктопное приложение AACWorkflow, которое запускает демон автоматически. Без запущенного демона нечему обнаруживать инструменты. - Бинарный файл инструмента должен быть доступен в
PATH. Демон обращается к каждому инструменту по имени (см. столбец Демон ищет в каждом разделе). Еслиwhich <имя>не находит инструмент в вашем терминале, демон тоже его не найдёт. После установки откройте новый терминал (или перезапустите демон), чтобы новый PATH был подхвачен.
После установки инструмента перезапустите демон:
aacworkflow daemon restartИли в десктопном приложении просто перезапустите приложение. Демон повторно сканирует PATH при каждом запуске.
16 поддерживаемых инструментов
Перечислены примерно от наиболее до наименее распространённых. Выберите те, для которых у вас уже есть учётные данные — все 16 не нужны.
Claude Code (Anthropic)
Самая полная интеграция. Работает возобновление сессий, работает MCP, и используется поле mcp_config у агентов (см. матрицу).
| Демон ищет | claude |
| Установка | Следуйте официальному руководству на claude.com/claude-code. Стандартный способ — npm-пакет @anthropic-ai/claude-code (требуется Node.js 18+). |
| Аутентификация | Запустите claude один раз и выполните вход через CLI, или установите ANTHROPIC_API_KEY. |
| Примечания | Рекомендуемый выбор для новых пользователей. |
Codex (OpenAI)
Транспорт JSON-RPC 2.0 с детальными шлюзами подтверждения. MCP-конфигурация записывается в $CODEX_HOME/config.toml для каждой задачи. Код возобновления сессии существует, но в настоящее время недоступен — выбирайте Claude Code или одно из семейства ACP, если требуется возобновление.
| Демон ищет | codex |
| Установка | Следуйте официальному руководству на github.com/openai/codex. Стандартный способ — npm-пакет @openai/codex. |
| Аутентификация | codex login (через браузер) или OPENAI_API_KEY. |
Cursor (Anysphere)
CLI-аналог редактора Cursor. Возобновление сессии не работает — CLI Cursor не возвращает идентификатор сессии, поэтому передаваемое значение при возобновлении всегда недействительно.
| Демон ищет | cursor-agent |
| Установка | Установите редактор Cursor, затем CLI в соответствии с их документацией на docs.cursor.com. Имя бинарного файла — cursor-agent, а не cursor. |
| Аутентификация | Войдите через редактор Cursor; CLI использует ту же сессию. |
GitHub Copilot
Маршрутизация моделей осуществляется через права вашей учётной записи GitHub — инструмент сам не выбирает модель; GitHub определяет, какая модель вам доступна.
| Демон ищет | copilot |
| Установка | См. документацию GitHub CLI на github.com/github/copilot-cli. |
| Аутентификация | Вход через браузер в учётную запись GitHub через CLI. |
| Примечания | Требуется активная подписка GitHub Copilot на учётной записи, с которой выполнен вход. |
OpenCode (SST)
Commercial CLI-агент. Динамически обнаруживает доступные модели из собственного конфигурационного файла — хороший выбор для пользователей, которые хотят использовать свой каталог моделей. Использует поле mcp_config агента через OPENCODE_CONFIG_CONTENT.
| Демон ищет | opencode |
| Установка | Следуйте официальному руководству на opencode.ai или репозиторию GitHub github.com/sst/opencode. Типичный способ — скрипт установки или npm-пакет. |
| Аутентификация | Настройте поставщика(ов) моделей в соответствии с документацией OpenCode (Anthropic, OpenAI и т.д.). |
DevEco Code (Huawei)
DevEco Code — независимый кодинг-агент Huawei для HarmonyOS, построенный на движке OpenCode. Поставляется с собственным каталогом моделей и авторизацией через аккаунт Huawei. AACWorkflow управляет им через deveco run --format json; модели обнаруживаются динамически через deveco models (встроенная deveco/GLM-5.1). MCP-серверы настраиваются через нативный конфиг DevEco (DEVECO_CONFIG_CONTENT); передача mcp_config со стороны AACWorkflow пока в работе.
| Демон ищет | deveco |
| Установка | npm install -g @deveco/deveco-code. См. официальный README на gitcode.com/openharmony-sig/deveco-code или страницу npm npmjs.com/package/@deveco/deveco-code. |
| Платформы | Только Windows x64 и macOS (arm64/x64) — сборки под Linux не публикуются. |
| Аутентификация | Вход в аккаунт Huawei через DevEco CLI. |
Kiro CLI (Amazon)
ACP-транспорт через stdio. Возобновление сессии работает через ACP session/load; MCP-конфигурация передаётся через ACP mcpServers; навыки копируются в .kiro/skills/.
| Демон ищет | kiro-cli |
| Установка | См. документацию Kiro на kiro.dev. Имя бинарного файла — kiro-cli, а не kiro. |
| Аутентификация | На основе учётной записи AWS; следуйте инструкциям Kiro. |
Kimi (Moonshot)
ACP-протокольный агент, ориентированный прежде всего на китайский рынок. MCP-конфигурация передаётся через ACP mcpServers; навыки находятся в .kimi/skills/ (собственное обнаружение).
| Демон ищет | kimi |
| Установка | Следуйте официальному руководству на github.com/MoonshotAI/kimi-cli. |
| Аутентификация | API-ключ Moonshot, настраивается по документации поставщика. |
Hermes (Nous Research)
ACP-протокольный агент (использует тот же транспорт, что и Kimi). Возобновление сессии работает, MCP-конфигурация передаётся через ACP mcpServers. Путь внедрения навыков использует общий .agent_context/skills/ — проверяйте загрузку навыков, прежде чем полагаться на них.
| Демон ищет | hermes |
| Установка | См. репозиторий Nous Research на github.com/NousResearch для получения последней версии CLI. |
| Аутентификация | По документации поставщика. |
OpenClaw
Commercial оркестратор CLI-агентов. MCP-конфигурация материализуется через обёртку конфигурации AACWorkflow для каждой задачи. Модель привязывается на уровне агента (openclaw agents add --model) — её нельзя переопределить для каждой задачи, и нельзя передать --model или --system-prompt из AACWorkflow.
| Демон ищет | openclaw |
| Установка | См. проект на github.com/openclaw-org/openclaw (поддерживается сообществом). |
| Аутентификация | Настройте поставщика базовой модели в соответствии с документацией OpenClaw. |
Pi (Inflection AI)
Минималистичный. Возобновление сессии нестандартное — идентификатором возобновления является путь к файлу сессии на диске, а не строковый идентификатор.
| Демон ищет | pi |
| Установка | См. документацию CLI Inflection на pi.ai. |
| Аутентификация | По документации поставщика. |
CodeBuddy (Tencent)
CLI-агент, совместимый с Claude Code. AACWorkflow управляет им по тому же stream-json-протоколу, что и Claude Code: возобновление сессии работает через --resume, MCP-конфиг передаётся через --mcp-config. У CodeBuddy собственная директория конфигурации: навыки попадают в .codebuddy/skills/, бриф среды выполнения записывается в CODEBUDDY.md. Модели обнаруживаются динамически.
| Демон ищет | codebuddy |
| Установка | См. официальную документацию CLI на codebuddy.ai/cli. |
| Аутентификация | По документации вендора. |
Qoder (Alibaba)
Агентный кодинг-CLI на протоколе ACP поверх stdio (общий транспорт с Hermes, Kimi и Kiro CLI). Возобновление сессии — через ACP session/resume, MCP-конфиг — через ACP mcpServers, модели обнаруживаются динамически, навыки копируются в .qoder/skills/.
| Демон ищет | qodercli |
| Установка | См. официальную документацию CLI на qoder.com/cli. |
| Аутентификация | По документации вендора. |
Trae CLI (ByteDance)
Официальный TRAE CLI от ByteDance (traecli, продукт в паре с Trae IDE — не open-source bytedance/trae-agent). ACP-нативный: AACWorkflow управляет им поверх stdio через traecli acp serve --yolo, общий транспорт с Hermes, Kimi, Kiro CLI и Qoder. Возобновление сессии — через ACP session/load, MCP-конфиг — через ACP mcpServers, модели обнаруживаются динамически (переключение через session/set_model), навыки копируются в .traecli/skills/.
| Демон ищет | traecli |
| Установка | См. официальную документацию CLI на docs.trae.cn/cli. |
| Аутентификация | Запустите traecli один раз интерактивно и завершите браузерный корпоративный вход (токен сохраняется в ~/.trae и в связке ключей ОС). Вход в Trae IDE не авторизует CLI — это разные логины. |
| Примечания | traecli читает правила проекта из .trae/rules/ и не имеет флага --system-prompt, поэтому AACWorkflow передаёт бриф среды выполнения прямо в промпте. Модель по умолчанию для демона — AACWORKFLOW_TRAECLI_MODEL. |
Antigravity (Google)
CLI Antigravity от Google (agy). Работает с сервисом Google Antigravity и использует модели на базе Gemini. Возобновление сессии работает через --conversation <id>, захваченный демоном из лога CLI. Выбор модели управляется внутри самого CLI Antigravity — AACWorkflow отключает выбор модели для этого поставщика. Навыки записываются в .agents/skills/ (CLI наследует компоновку навыков рабочего пространства от Gemini CLI — см. документацию Antigravity).
| Демон ищет | agy |
| Установка | Следуйте официальному руководству на antigravity.google/docs/cli-overview. CLI поставляется предварительно собранным — запустите agy install один раз для настройки PATH и алиасов оболочки. |
| Аутентификация | Запустите agy один раз в интерактивном режиме и выполните вход в учётную запись Google, или войдите через десктопное приложение Antigravity — CLI использует ту же запись ключей, которую создаёт GUI. |
| Примечания | CLI выводит обычный текст ассистента в stdout, а не структурированный поток событий; промежуточные строки «Я выполню X» и финальный ответ передаются в AACWorkflow как текст. |
Grok (xAI)
Grok Build CLI от xAI (grok). AACWorkflow управляет им по ACP через grok --no-auto-update agent --always-approve stdio — общий транспорт с Hermes, Kimi, Kiro CLI, Qoder и Trae. Возобновление сессии — через ACP session/load, модели обнаруживаются из session/new, MCP-конфиг — через ACP mcpServers. Навыки копируются в .grok/skills/; пользовательские навыки — в $GROK_HOME/skills/ (по умолчанию ~/.grok/skills/) и ~/.agents/skills/.
| Демон ищет | grok |
| Установка | Установите Grok Build CLI и убедитесь, что grok есть в PATH (часто ~/.grok/bin). |
| Аутентификация | Выполните grok login для входа с кешированным токеном или установите XAI_API_KEY. |
| Примечания | Бинарь можно переопределить через AACWORKFLOW_GROK_PATH, модель по умолчанию — через AACWORKFLOW_GROK_MODEL (например, grok-4.5). Минимальная версия CLI: 0.2.89. |
После установки
- Убедитесь, что бинарный файл находится в
PATH. Откройте новый терминал и выполнитеwhich <имя>(напримерwhich claude,which cursor-agent,which kiro-cli,which agy). Если выводится путь — демон найдёт его. Если ничего не выводится — сначала исправьтеPATHвашей оболочки (обычная причина — файл rc оболочки, который не был перезагружен). - Перезапустите демон.
aacworkflow daemon restartили перезапустите десктопное приложение. Демон сканируетPATHтолько при запуске. - Проверьте страницу «Среды выполнения». В интерфейсе AACWorkflow на странице Среды выполнения теперь должна отображаться одна строка для каждой комбинации
(рабочее пространство × инструмент). Если строка показывает «offline», см. Демон и среды выполнения → Когда среда выполнения помечается как offline. - Вернитесь к onboardingu. Шаг «Подключите среду выполнения» опрашивает сервер и обнаружит новую среду в течение нескольких секунд — обновлять страницу не нужно.
Устранение неполадок
whichнаходит бинарный файл, а демон — нет. Демон был запущен со старой версиейPATH. Перезапустите его.- Бинарный файл существует, но запуск не удаётся. Запустите
--versionили--helpинструмента один раз из терминала — большинство проблем здесь связаны с отсутствием аутентификации, истекшими токенами или несовместимостью Node.js / среды выполнения. - Страница «Среды выполнения» показывает строку, но задачи сразу завершаются ошибкой. Проверьте
aacworkflow daemon logs -fпри запуске задачи. Демон отображает вывод ошибок самого инструмента.
При более широких симптомах см. Руководство по устранению неполадок.
Далее
- Демон и среды выполнения — как работают обнаружение, пульс и обработка отключений
- Матрица AI-инструментов — различия в возможностях после подключения инструмента
- Создание и настройка агентов — выбор инструмента для агента и запуск задач