Быстрый старт

Этот гайд проводит от свежей установки до первой запущенной команды за несколько минут.

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

Перед началом убедитесь, что у вас есть:

• macOS, Windows или Linux машина
• Git-репозиторий в качестве проекта (рекомендуется для diff review и worktree isolation)
• Бесплатная модель без авторизации для первого запуска или доступ к провайдеру, если нужны дополнительные модели: Anthropic (Claude), OpenAI (Codex), OpenRouter (OpenCode) или Google (Gemini)
• Node.js 24.16.0 LTS и pnpm 10+ при запуске из исходников

Подробности и ссылки для скачивания — в разделе Установка.

1. Установите Agent Teams

Скачайте последний релиз под вашу платформу на странице загрузок или в GitHub releases.

TIP

Приложение бесплатное и с открытым кодом. Можно начать с бесплатной модели без авторизации - без регистрации; дополнительные runtime/provider paths могут требовать доступ к провайдеру. Подробности в разделе Установка.

INFO

Desktop-приложение — основной продукт. Agent Teams также работает в браузере для разработки, но браузерный режим не имеет полного desktop IPC, терминала, provider auth и lifecycle. Для обычной разработки используйте pnpm dev (Electron), а не браузерный режим.

2. Откройте проект

Запустите приложение и выберите директорию проекта, где агенты будут работать. Agent Teams читает локальные файлы проекта и runtime/session state, чтобы показывать задачи, логи, diffs и активность команды.

TIP

Выберите проект под Git — так вы получите лучший опыт. Изоляция через worktree и ревью по diff зависят от Git.

Перед запуском команды проверьте базовое состояние проекта:

git status --short

Не обязательно иметь идеально чистое дерево, но важно понимать, какие изменения уже были вашими до старта агентов. Так проще доверять task diffs и hunk-level review.

3. Выберите runtime

Мастер настройки автоматически определит установленные рантаймы на вашей машине. Стандартные варианты:

Runtime	Когда подходит
Claude	Если вы уже используете Claude Code или у вас есть Anthropic access
Codex	Для Codex-native workflows и OpenAI access
OpenCode	Бесплатная модель без авторизации, multi-model команды и много provider backends

INFO

Gemini — поддерживаемый провайдер. Варианты auth смотрите в разделе Провайдеры и рантаймы.

Подробная настройка каждого провайдера — в разделе Настройка рантайма.

Чтобы проверить платный или account-backed runtime вне приложения, запустите соответствующую команду версии:

claude --version
codex --version
opencode --version

Если команда падает в терминале, сначала исправьте runtime installation или PATH. Team prompts не смогут компенсировать отсутствующий binary или provider auth для моделей, которым он нужен.

Также можно проверить, что бинарник доступен в PATH:

command -v claude
command -v codex
command -v opencode

Если command -v ничего не выводит, рантайм не установлен или отсутствует в PATH.

4. Создайте первую команду

Начните с маленькой команды: lead, implementation agent и review-oriented agent. Этого достаточно, чтобы проверить workflow без лишнего шума.

Рекомендованная структура и советы — в разделе Создание команды.

Для первого запуска используйте примерно такую структуру:

Member	Responsibility	Notes
Lead	Делит цель на tasks и координирует status	Держите на самом надёжном provider
Builder	Реализует scoped tasks	Дайте понятные file или feature boundaries
Reviewer	Проверяет завершённую работу	Попросите фокусироваться на regressions и missing tests

Не начинайте сразу с пяти и более teammates. Больше агентов означает больше concurrency, logs, provider usage и риск конфликтов до того, как вы убедились, что setup здоровый.

5. Дайте lead-агенту конкретную цель

Пишите задачу как инженерному лиду:

Улучши onboarding flow. Разбей работу на задачи, держи изменения маленькими и проси review перед широкими рефакторингами.

Хороший первый prompt содержит scope, safety boundaries и verification:

Improve the docs quickstart. Keep edits inside landing/product-docs. Add practical examples, preserve existing VitePress syntax, and run `pnpm --dir landing docs:build` before marking tasks done.

Избегайте размытых prompts вроде "make the app better" для первого запуска. Lead может дробить большие цели, но хороший input даёт более маленькие tasks и чище review.

Lead создаёт задачи, назначает работу и координирует teammates. Вы следите за прогрессом на канбан-доске и вмешиваетесь через комментарии или direct messages в любой момент.

6. Проверьте результат

Откройте задачи в review/done, посмотрите diff, примите или отклоните изменения. Если нужно понять мотивацию агента, откройте task logs.

Полный процесс ревью — в разделе Код-ревью.

Перед approval первой task проверьте три вещи:

1. Task comment объясняет, что изменилось
2. Изменённые файлы совпадают со scope задачи
3. Verification result виден в task comment или logs

Частые проблемы

Симптом	Вероятная причина	Что проверить
Приложение не видит runtime	Бинарник не в PATH или разные окружения у приложения и терминала	Запустите command -v <runtime> в терминале
Запуск команды зависает	Нет provider auth для платной/account модели, неверная модель или runtime не найден	Раздел Диагностика
OpenCode lane в статусе registered	Lane evidence ещё не зафиксирован или несовпадение модели	Проверьте ~/.claude/teams/<team>/.opencode-runtime/lanes/
Ответы агента не приходят	Runtime delivery retry, parsing или task attribution	Откройте task logs и проверьте delivery ledger
Провайдер возвращает 429	Достигнут лимит запросов	Дождитесь сброса или смените модель/провайдера

Дальше

• Создание команды — рекомендованные структуры и написание brief
• Настройка рантайма — авторизация провайдеров и выбор моделей
• Код-ревью — ревью, одобрение и запрос правок

Для разработчиков

• AGENTS.md — навигация по репозиторию
• CLAUDE.md — рабочие конвенции
• AGENT_CRITICAL_GUARDRAILS.md — жёсткие правила
• Feature architecture standard — структура фич
• Runbook отладки — диагностика запуска