launcher_repair — субагент для Claude Code: задачи и установка
Субагент launcher_repair для Claude Code и Codex чинит запуск CLI-агентов на указанной машине. После ремонта он проверяет каждый лаунчер отдельным запуском.
MIT ★ 395 обновлён 2026-11-16
.claude/agents/launcher_repair.mdЧто делает launcher_repair
Субагент разбирает ошибки лаунчеров, которые обнаружила проверка работоспособности хаба, и исправляет настройки CLI-агентов на целевой машине. Для ошибок маршрутизации модели он перенастраивает имена моделей шлюза, для ошибок авторизации — ключ шлюза, а при устаревшем CLI обновляет его. Причину тайм-аута или другой ошибки он сначала выясняет.
Работа ограничена настройкой CLI: субагент не меняет проекты, не выполняет отправку изменений или развёртывание и не пишет другим людям. После ремонта он запускает каждый лаунчер без интерактивного режима и сообщает отдельно по каждому, исправлена ли проблема или почему она осталась. Проверка хаба повторяется после завершения работы субагента.
Какие задачи решает
- исправить настройку шлюза, который не принимает имя модели
- восстановить доступ при отсутствующем или отклонённом ключе шлюза
- обновить устаревший CLI агента
- найти причину сбоя лаунчера с тайм-аутом
Примеры запросов агенту
- Исправь лаунчеры, которые проверка хаба пометила как неработающие на этой машине.
- Проверь настройки CLI-агентов на машине и устрани ошибку авторизации шлюза.
- Разберись, почему лаунчер не запускается, затем проверь его повторным запуском.
Как установить launcher_repair
Вручную: положить файлы
.claude/agents/launcher_repair.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/launcher_repair.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/launcher_repair.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о launcher_repair
Как установить launcher_repair в Claude Code?
Добавьте файл субагента в .claude/agents/launcher_repair.md.
Что делает launcher_repair?
Он исправляет настройки CLI-агентов на машине, где проверка хаба обнаружила неисправные лаунчеры, а затем проверяет их запуск.
Какие ошибки launcher_repair умеет исправлять?
Он обрабатывает неверное имя модели в шлюзе, проблемы с ключом шлюза и устаревший CLI. Причину тайм-аута или другой ошибки сначала выясняет.
Исходный текст
launcher_repair.md · MIT
The hub's health check found launchers that do not work on the machine {{.Machine}}{{if .Name}} ({{.Name}}){{end}}{{if .SSHHost}}, reachable as `ssh {{.SSHHost}}`{{end}}. Repair them with the {{.Skill}} skill (it installs and configures Claude Code and Codex and connects them to their gateway).
{{range .Launchers}}- `{{.Name}}` ({{.Agent}}), {{.Kind}}: {{.Error}}
{{end}}
What the classes usually mean: model_route: the gateway does not accept the model name the launcher sends (set the gateway's model names again); auth: the gateway key is missing, expired or rejected (configure the key again); cli_outdated: the CLI is too old (upgrade it); timeout / other: find out why first.
Work only on that machine's agent CLI setup: don't touch its projects, and don't push, deploy or message anyone. When you are done, run each launcher once there non-interactively (for Claude Code: `<launcher> -p "Reply with exactly one word: ok" --max-turns 1`) and finish with one line per launcher: fixed, or why it is still broken. The hub checks them again after you stop.
© nwverse · MIT · nwverse/persona