167 lines
9.9 KiB
Markdown
167 lines
9.9 KiB
Markdown
---
|
||
title: Настройка рантайма – Документация Agent Teams
|
||
description: Конфигурация Claude Code, Codex или OpenCode. Авторизация, провайдеры, multimodel mode и предзапусковые проверки.
|
||
lang: ru-RU
|
||
---
|
||
|
||
# Настройка рантайма
|
||
|
||
Agent Teams - координационный слой. Работа моделей выполняется через локальные рантаймы и провайдеры.
|
||
|
||
## Предварительные требования
|
||
|
||
Перед запуском команды убедитесь, что:
|
||
|
||
- Runtime binary установлен и находится в `PATH`.
|
||
- Ваш аккаунт провайдера имеет доступ к выбранной модели, если вы не начинаете со встроенной OpenCode-модели без авторизации.
|
||
- Путь к проекту существует и доступен для чтения.
|
||
- Приложение и терминал используют одинаковое home/config окружение, когда вы вручную проверяете auth.
|
||
|
||
::: tip
|
||
Начните с одного teammate и одного провайдера. Подтвердите запуск одной команды, прежде чем добавлять multimodel lanes.
|
||
:::
|
||
|
||
Быстрые terminal checks:
|
||
|
||
```bash
|
||
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 в терминале:
|
||
|
||
```bash
|
||
claude login
|
||
```
|
||
|
||
Затем проверьте, что CLI доступен:
|
||
|
||
```bash
|
||
claude --version
|
||
```
|
||
|
||
Если packaged app пишет "not logged in", хотя терминал работает, сравните `$HOME` и `PATH`, которые видит приложение, с терминалом, где вы делали login. Auth diagnostic log из [Диагностики](/ru/guide/troubleshooting#диагностический-лог-авторизации) - лучшая стартовая точка.
|
||
|
||
### Codex
|
||
|
||
Установите и авторизуйтесь через CLI OpenAI:
|
||
|
||
```bash
|
||
codex login
|
||
```
|
||
|
||
Затем проверьте, что runtime доступен:
|
||
|
||
```bash
|
||
codex --version
|
||
```
|
||
|
||
Codex-native launches используют Codex account state и model catalog data, когда они доступны. Если model не видна в UI, обновите provider status до редактирования team prompts.
|
||
|
||
### OpenCode
|
||
|
||
Для встроенной бесплатной модели без авторизации достаточно выбрать её в приложении и запустить без регистрации у провайдера. Для других OpenCode backend создайте или отредактируйте `~/.opencode/config.json` (или эквивалентный путь на вашей платформе):
|
||
|
||
```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. См. [Диагностика](/ru/guide/troubleshooting#opencode-registered-но-bootstrap-не-подтверждён).
|
||
|
||
### 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.
|
||
|
||
::: info 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 или роли команды. После смены проверьте одну маленькую задачу.
|
||
|
||
::: warning Считайте ошибки 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` |
|