Настройка рантайма

Agent Teams - координационный слой. Работа моделей выполняется через локальные рантаймы и провайдеры.

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

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

• Runtime binary установлен и находится в PATH.
• Ваш аккаунт провайдера имеет доступ к выбранной модели, если вы не начинаете со встроенной OpenCode-модели без авторизации.
• Путь к проекту существует и доступен для чтения.
• Приложение и терминал используют одинаковое home/config окружение, когда вы вручную проверяете auth.

TIP

Начните с одного teammate и одного провайдера. Подтвердите запуск одной команды, прежде чем добавлять multimodel lanes.

Быстрые terminal checks:

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

Запускайте команду для runtime, который планируете использовать. Если вывода нет, установите runtime или исправьте PATH до запуска команды.

Поддерживаемые пути

Путь	CLI по умолчанию	Типичные провайдеры	Когда использовать
Claude	claude	Anthropic	Если вы уже используете Claude Code или Anthropic access
Codex	codex	OpenAI	Для Codex-native workflows и OpenAI access
OpenCode	opencode	OpenRouter и многие другие	Для multimodel routing и широкой provider coverage

Приложение по возможности определяет доступные runtimes и ведёт настройку через UI.

Gemini — поддерживаемый провайдер с Google ADC (gcloud auth), Gemini CLI OAuth и API key аутентификацией. Настройка доступна через UI управления провайдерами, когда Gemini backend обнаружен.

Доступ к провайдеру

У Agent Teams нет своего платного тарифа. Можно начать со встроенной OpenCode-модели без авторизации - без регистрации, API-ключей и карты. Для дополнительных моделей используйте доступ к провайдеру, который у вас уже есть: подписка, локальная авторизация рантайма или API-ключи в зависимости от выбранного пути.

• Для Claude и Codex используется auth соответствующего CLI.
• OpenCode может сначала работать через встроенную бесплатную модель без авторизации. Другие OpenCode-модели могут требовать provider-specific API keys в файле конфигурации (например, openrouter, openai, anthropic).

Настройка авторизации

Claude Code

Запустите стандартный auth flow в терминале:

claude login

Затем проверьте, что CLI доступен:

claude --version

Если packaged app пишет "not logged in", хотя терминал работает, сравните $HOME и PATH, которые видит приложение, с терминалом, где вы делали login. Auth diagnostic log из Диагностики - лучшая стартовая точка.

Codex

Установите и авторизуйтесь через CLI OpenAI:

codex login

Затем проверьте, что runtime доступен:

codex --version

Codex-native launches используют Codex account state и model catalog data, когда они доступны. Если model не видна в UI, обновите provider status до редактирования team prompts.

OpenCode

Для встроенной бесплатной модели без авторизации достаточно выбрать её в приложении и запустить без регистрации у провайдера. Для других OpenCode backend создайте или отредактируйте ~/.opencode/config.json (или эквивалентный путь на вашей платформе):

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-..."
    }
  }
}

Используйте точное имя провайдера, которое ожидает OpenCode. Если вы используете кастомное имя, убедитесь, что оно совпадает с provider ID в строке модели (например, openrouter/moonshotai/kimi-k2.6 использует блок openrouter).

Примеры model strings:

Model string	Provider block, который должен существовать
openrouter/moonshotai/kimi-k2.6	openrouter
openai/gpt-5.4	openai
anthropic/claude-sonnet-4-6	anthropic

Если OpenCode запускается, но teammate не становится deliverable, сначала смотрите lane evidence, а не предполагаете, что model проигнорировала prompt. См. Диагностика.

Gemini

Gemini поддерживает три метода аутентификации:

• Google ADC — запустите gcloud auth application-default login для авторизации через Google Application Default Credentials.
• Gemini CLI — запустите gemini login, если Gemini CLI установлен.
• API key — установите GEMINI_API_KEY в переменные окружения или настройте через UI управления провайдерами.

Приложение автоматически определяет доступный метод auth и показывает провайдера Gemini в UI настройки рантайма и создания команд, когда backend доступен.

Multimodel-режим

Multimodel-режим может направлять работу через разные provider backends в OpenCode-совместимой конфигурации. Используйте его, когда нужна гибкость провайдеров или разные model lanes для teammates.

Model lanes

Каждый teammate может использовать свою пару providerId + model. В UI редактирования команды разверните опции member, чтобы переопределить глобальные значения.

Консервативный multimodel setup:

Role	Provider	Why
Lead	Claude или Codex	Держит coordination на самом надёжном provider
Builder	OpenCode	Даёт broad model routing для implementation work
Reviewer	Claude, Codex или второй OpenCode model	Отделяет review judgment от builder lane

Не смешивайте много незнакомых providers в первом launch. Подтвердите одну маленькую task на каждую lane до broad work.

Чеклист перед запуском

Перед запуском команды:

1. Выбранный runtime установлен
2. Binary runtime находится в environment PATH
3. Auth провайдера настроен для выбранного backend
4. Провайдер имеет доступ к точной строке модели
5. Путь к проекту существует и доступен для чтения

Когда менять runtime path

Меняйте путь, когда текущий упирается в availability модели, rate limits, provider capabilities или роли команды. После смены проверьте одну маленькую задачу.

Считайте ошибки setup setup-проблемами

Если auth падает, имя модели отклонено или binary runtime не найден — сначала исправьте настройку. Не меняйте team prompts или код проекта, чтобы обойти проблему конфигурации рантайма.

Используйте эту таблицу решений:

Symptom	Better first action
Binary not found	Исправить installation или PATH
Login работает в terminal, но не app	Проверить Electron auth diagnostic log и environment
Model rejected	Проверить точный model id в provider runtime
Repeated 429s	Уменьшить concurrency или сменить model/provider
OpenCode lane stuck	Проверить lane manifest и opencode-sessions.json