Диагностика

Большинство проблем команды попадает в четыре группы: runtime setup, launch confirmation, task parsing или provider limits.

Команда не запускается

Проверьте:

Выбранный runtime установлен или авторизован
Runtime доступен в environment PATH
У провайдера есть доступ к нужной модели
Project path существует и читается

::: tip Запустите бинарник рантайма в терминале, чтобы проверить PATH и авторизацию. Например: claude --version или opencode --version. :::

OpenCode: bootstrap не подтверждён

Если OpenCode показывает registered, но bootstrap не подтверждён:

Откройте launch logs в UI.
Проверьте ~/.claude/teams/<team>/launch-state.json — состояние member.
Посмотрите ~/.claude/teams/<team>/.opencode-runtime/lanes/<lane-id>/manifest.json на наличие evidence.
Не меняйте team prompts, пока не убедитесь, что lane стартовал, но не смог закоммитить evidence.

::: warning Отсутствие OpenCode inbox во время primary launch — норма. Secondary lanes стартуют после готовности primary filesystem. Не считайте primary hang багом OpenCode, пока UI явно не показывает, что Y членов ждёт и Y некорректно включает OpenCode lanes. :::

Не видны ответы агента

Откройте task logs и teammate messages. Пропавшие replies часто связаны с:

Runtime delivery gaps
Parsing или task filtering issues
Агент всё ещё обрабатывает (большие задачи могут занимать минуты)

Не считайте, что модель проигнорировала сообщение, пока это не подтверждено логами.

::: tip Для OpenCode teammates проверьте, что вызван agent-teams_message_send с правильными from, to и taskRefs. Ответы OpenCode должны отправляться через MCP tools, а не обычным текстом. :::

Changes не связаны с tasks

Используйте task-specific logs и code review links. Если diff выглядит detached:

Проверьте, был ли task id или task reference в output агента.
Убедитесь, что агент вызвал task_add_comment перед правками.
Убедитесь, что агент вызвал task_start, чтобы доска знала о начале работы.

Rate limits

Если провайдер сообщает reset time, Agent Teams может подтолкнуть lead продолжить после cooldown. Если reset time неизвестен, подождите или смените provider/runtime path.

Распространённые состояния member

Состояние	Значение
`confirmed_alive` + `bootstrapConfirmed`	Здоров и готов к работе
`registered` / `runtime_pending_bootstrap`	Процесс или lane существует, но bootstrap proof ещё не закоммичен
`failed_to_start` + `runtime_process`	Процесс есть, но launch gate не прошёл. Смотрите diagnostics
`failed_to_start` + `stale_metadata`	Сохранённый pid/session устарел или мёртв

::: warning member_briefing сам по себе НЕ является runtime evidence. Для OpenCode авторитетным доказательством служит committed runtime evidence, такая как opencode-sessions.json и запись в manifest. :::

Режим отладки рантайма

Для локальной отладки можно принудительно запускать teammates в tmux-панелях:

# Запуск из терминала
CLAUDE_TEAM_TEAMMATE_MODE=tmux pnpm dev

# Или добавьте в custom CLI args
--teammate-mode tmux

Используйте это для инспекции интерактивного поведения CLI. Не считайте поведение полностью эквивалентным process backend.

CLI auth diagnostic

Каждый запуск CliInstallerService.getStatus() дописывает одну строку в claude-cli-auth-diag.ndjson в папке логов Electron (обычно ~/Library/Logs/<product-name>/ на macOS). Если файл превышает 512 KiB, он обнуляется перед следующей записью.

Проверьте этот файл, если видите «Not logged in» или ошибки авторизации в упакованном приложении.

Безопасная очистка

При очистке stale processes:

Определите pid и убедитесь, что он принадлежит текущей команде/lane.
Останавливайте только процессы, явно принадлежащие smoke test или отлаживаемому launch.
Не убивайте все процессы OpenCode или shared hosts в качестве shortcut.

Какие данные собрать

Соберите:

task id
team name
runtime path
launch log excerpt
provider/model
точный time window

Этого обычно хватает для диагностики launch и task lifecycle issues.

::: tip Если проблема не устраняется, откройте persisted files команды под ~/.claude/teams/<teamName>/ и сопоставьте UI diagnostics с live process state, прежде чем менять код. :::

6.1 KiB Raw Blame History Unescape Escape