98 lines
4.8 KiB
Markdown
98 lines
4.8 KiB
Markdown
# Настройка рантайма
|
||
|
||
Agent Teams — coordination layer. Model work выполняется через локальные runtimes и providers.
|
||
|
||
## Предварительные требования
|
||
|
||
Перед запуском команды убедитесь, что:
|
||
|
||
- Runtime binary установлен и находится в `PATH`.
|
||
- Ваш аккаунт провайдера имеет доступ к выбранной модели.
|
||
- Путь к проекту существует и доступен для чтения.
|
||
|
||
::: tip
|
||
Начните с одного teammate и одного провайдера. Подтвердите запуск одной команды, прежде чем добавлять multimodel lanes.
|
||
:::
|
||
|
||
## Поддерживаемые пути
|
||
|
||
| Путь | 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.
|
||
|
||
## Доступ к провайдеру
|
||
|
||
У Agent Teams нет своего платного тарифа. Вы используете доступ к провайдеру, который у вас уже есть: подписка, локальная авторизация рантайма или API-ключи в зависимости от выбранного пути.
|
||
|
||
- Для **Claude** и **Codex** используется auth соответствующего CLI.
|
||
- Для **OpenCode** требуются provider-specific API keys в файле конфигурации (например, `openrouter`, `openai`, `anthropic`).
|
||
|
||
## Настройка авторизации
|
||
|
||
### Claude Code
|
||
|
||
Запустите стандартный auth flow в терминале:
|
||
|
||
```bash
|
||
claude login
|
||
```
|
||
|
||
Затем проверьте, что CLI доступен:
|
||
|
||
```bash
|
||
claude --version
|
||
```
|
||
|
||
### Codex
|
||
|
||
Установите и авторизуйтесь через CLI OpenAI:
|
||
|
||
```bash
|
||
codex login
|
||
```
|
||
|
||
### OpenCode
|
||
|
||
Создайте или отредактируйте `~/.opencode/config.json` (или эквивалентный путь на вашей платформе):
|
||
|
||
```json
|
||
{
|
||
"providers": {
|
||
"openrouter": {
|
||
"apiKey": "sk-or-..."
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
Используйте точное имя провайдера, которое ожидает OpenCode. Если вы используете кастомное имя, убедитесь, что оно совпадает с provider ID в строке модели (например, `openrouter/moonshotai/kimi-k2.6` использует блок `openrouter`).
|
||
|
||
## Multimodel-режим
|
||
|
||
Multimodel-режим может направлять работу через разные provider backends в OpenCode-совместимой конфигурации. Используйте его, когда нужна гибкость провайдеров или разные model lanes для teammates.
|
||
|
||
::: info Model lanes
|
||
Каждый teammate может использовать свою пару `providerId` + `model`. В UI редактирования команды разверните опции member, чтобы переопределить глобальные значения.
|
||
:::
|
||
|
||
## Чеклист перед запуском
|
||
|
||
Перед запуском команды:
|
||
|
||
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 или код проекта, чтобы обойти проблему конфигурации рантайма.
|
||
:::
|