777genius 1490da10f9 docs(guide): improve clarity and completeness of Workflows section (EN+RU)

Add task lifecycle diagram, review states, auth configuration blocks,
common member states, CLI auth diagnostic, and safe-cleanup guidance.
Synchronize EN and RU pages for runtime-setup, agent-workflow,
code-review, and troubleshooting.

2026-05-09 11:01:39 +03:00

4.6 KiB

Raw Blame History

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

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.

Provider access

У Agent Teams нет своего платного тарифа. Вы используете доступ к провайдеру, который у вас уже есть: subscription, local runtime auth или API keys в зависимости от выбранного пути.

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

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

Claude Code

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

claude login

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

claude --version

Codex

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

codex login

OpenCode

Создайте или отредактируйте ~/.opencode/config.json (или эквивалентный путь на вашей платформе):

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

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

Multimodel mode

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

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

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

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

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

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

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

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

4.6 KiB Raw Blame History Unescape Escape