К основному содержанию
субагент CX Codex

agent_start — субагент для Claude Code: запуск и установка

Субагент agent_start для Claude Code запускает отдельного агента в терминале на выбранном компьютере. Он берёт задачу на разработку и возвращает ID новой сессии.

MIT ★ 395 обновлён 2026-11-16

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/agent_start.md
Открыть на GitHub

Что делает agent_start

agent_start запускает агента в проектной папке на одном из компьютеров пользователя и передаёт ему первый запрос. Перед выбором машины он проверяет её ресурсы и доступность через machines_list; после запуска возвращает ID сессии. Если последняя проверка запуска на выбранной машине провалилась, агент стартует на другой рабочей машине, а путь из домашней папки переносится в её домашнюю папку.

Для параллельной работы можно задать ветку: субагент создаст worktree через движок машины, чтобы тот отображался в Orca и приложении. Ветка, уже занятая в другом месте, не подойдёт. Секреты можно передать через ссылки на секрет-хранилище после подтверждения пользователя; значения доступны только окружению агента. Для установки поместите файл по пути .claude/agents/agent_start.md.

Какие задачи решает

  • запустить отдельного агента в папке проекта
  • передать задачу на разработку другой машине
  • создать worktree для параллельной работы над веткой
  • передать агенту секреты через переменные окружения

Примеры запросов агенту

  • Запусти агента в папке проекта /workspace/app и попроси исправить обработку ошибок.
  • Проверь доступные машины и запусти агента для тестов в отдельной ветке fix-tests.
  • Передай агенту переменную API_TOKEN из op://vault/item/field после подтверждения.

Как установить agent_start

Вручную: положить файлы

.claude/agents/agent_start.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы об agent_start

Как установить agent_start в Claude Code?

Добавьте файл субагента по пути .claude/agents/agent_start.md.

Что делает agent_start?

Он запускает агента в терминале на одном из компьютеров пользователя, передаёт ему запрос и возвращает ID сессии. Для параллельной работы агент может стартовать в отдельном worktree.

Как agent_start создаёт worktree?

Он поручает создание движку машины, а затем запускает агента в новом worktree. Ветка, уже открытая в другом месте, отклоняется.

Исходный текст

agent_start.md · MIT
Start a new agent in the terminal engine (herdr or Orca) of one of the user's computers, in a project directory, with a first prompt. Use for real development work instead of doing it here. Check machines_list for current machine resources and availability before choosing a machine. Returns the new session id. When the launcher failed its last health check on that machine, the agent starts on a machine where it works (a directory under the home moves to that home) and the answer says so. Claude-family launchers and Paseo providers with Auto Accept always start in bypassPermissions; traex and omp: no effort.

The launcher decides the agent. A Claude Code launcher starts Claude Code. A launcher named pi, cursor or agy (or one the machine lists as that agent) starts that agent in a herdr pane with the model you give: pi, the Cursor CLI (cursor-agent) or the Antigravity CLI (agy). pi's first message goes through its Persona extension; cursor's and agy's go through herdr once it recognises the agent. Those three take no permission mode and no ultracode, and their effort is their own.

When the work needs a branch and checkout of its own (work in parallel with what is already open in that repository), give `worktree.branch`: Persona makes the worktree through the machine's engine first (herdr's or Orca's own, so it is listed there and in the app, under the workspace `cwd` is in) and starts the agent in it. Do not tell the agent to run `git worktree add` itself: a worktree made that way is invisible to Orca and to the app. An existing local branch is checked out; a new one starts at the HEAD of the workspace `cwd` is in. A branch already checked out elsewhere is refused.

When the agent needs credentials the user keeps in a secret provider (a token in 1Password, say), give `secret_env`: each environment variable it should have, with the reference its value comes from (such as `op://vault/item/field`), never the secret itself. The user approves the hand-off on a card on iPhone or the web before anything starts, and the values reach only that agent's environment, for this run: you never see them, and the answer lists each variable as granted, declined, expired or failed. Only Claude Code agents on a computer this manager connects take them. Tell the agent the variables are there; never ask it to print them.

Give `ultracode: true` for a large task: one that spans many files or needs checking from several angles (design, tests, review). Claude Code then runs every substantial step as a multi-agent workflow: slower and costlier, so leave it off for small or quick work. Do not write the word "ultracode" into the prompt instead. Claude Code agents only (2.1.284 or later): any other agent, an older Claude Code or a node too old for it starts without it, and the answer says so. Whether it is really on shows as `ultracode=on` in agents_list once Claude Code confirms it. An organization policy may keep some conversations read-only: a call from such a conversation is refused with the policy's reason. Do not retry the same call; follow what the refusal says instead.

```json
{
  "type": "object",
  "required": [
    "machine",
    "cwd",
    "prompt"
  ],
  "properties": {
    "machine": {
      "type": "string"
    },
    "cwd": {
      "type": "string",
      "description": "absolute path or ~/…; with worktree, a directory of the repository to branch from"
    },
    "prompt": {
      "type": "string"
    },
    "attachments": {
      "type": "array",
      "maxItems": 8,
      "items": { "type": "string" },
      "description": "pictures and files the user gave you for it, by their absolute paths on your computer: a picture they sent (the path Claude Code gives it), a file the app put in their message. They are copied to the agent's computer and listed at the end of its message, and the text's mentions of them name the copies. Only those the user gave you in this conversation are accepted"
    },
    "launcher": {
      "type": "string",
      "description": "launcher name, one that machine has (a name it lacks is refused, listing the ones it has): a Claude Code launcher, or pi, cursor or agy for those agents; empty: the default, or one the machine has when it lacks the default (claude first; the answer says so)"
    },
    "secret_env": {
      "type": "object",
      "maxProperties": 8,
      "additionalProperties": { "type": "string" },
      "description": "environment variables for this run from the user's secret providers: NAME → reference (op://vault/item/field), never a value; asked on a card first"
    },
    "ultracode": {
      "type": "boolean",
      "description": "turn Claude Code's ultracode on for this agent (multi-agent workflows for every substantial step); default false"
    },
    "worktree": {
      "type": "object",
      "description": "start the agent in a new worktree of cwd's repository, made by the machine's engine",
      "required": [
        "branch"
      ],
      "properties": {
        "branch": {
          "type": "string",
          "description": "the branch to check out (made from the workspace's HEAD when it does not exist)"
        }
      }
    },
    "tier": {
      "type": "string",
      "description": "An Agent preset: one of the tiers the snapshot's 模型档位 line lists for the profile in use, each with what it is for; pick the one whose description fits the work. Resolved before the user is asked, and the card shows it. Explicit launcher/model/effort override its values."
    },
    "effort": {
      "type": "string",
      "description": "Explicit effort override; omit to use the tier or purpose default."
    },
    "model": {
      "type": "string",
      "description": "Explicit model override: a model id the agent takes (an alias such as opus, or a gateway's own id; letters, digits and . _ - / : @ [ ] only, or a leading ~ as in ~vendor/model-latest). Omit to use the tier or purpose default."
    }
  }
}
```

© nwverse · MIT · nwverse/persona

Похожие субагенты

Каталог субагентов →
tanstack-start-best-practices DeckardGer Скилл tanstack-start-best-practices для Claude Code собирает правила и паттерны для full-stack приложений на TanStack Start. Помогает настраивать серверные функции, сессии и потоковый SSR. CX Codex +1 10 000установок start-learning rohitg00 Скилл start-learning проводит вводное интервью, определяет стартовый этап курса по AI Engineering и создаёт план в LEARNING.md. Запускайте его, чтобы начать обучение или настроить план. CX Codex +1 5 600установок start официальный anthropics Скилл start проверяет подключённые MCP-серверы и доступные инструменты биоисследований. Помогает сориентироваться в окружении плагина перед началом проекта. CX Codex +1 5 100установок tanstack-start tanstack-skills Скилл помогает создавать и сопровождать приложения на фреймворке TanStack Start с потоковым SSR, серверными функциями и маршрутизацией. CX Codex +1 4 000установок cold-start-problem wondelai Скилл cold-start-problem для Claude Code, Cursor, Codex и других агентов, обучающий фреймворку Эндрю Чена по сетевым эффектам. CX Codex +1 3 400установок sentry-tanstack-start-sdk getsentry Скилл sentry-tanstack-start-sdk настраивает Sentry в проектах TanStack Start React: проверяет структуру файлов и подключает трейсинг, отслеживание ошибок и запись сессий. CX Codex +1 2 000установок

Из того же набора61

Весь набор →
worker_supervise Субагент worker_supervise для Claude Code управляет запущенными через task_plan воркерами и разбирает их статусы. Он сверяет результаты с критериями готовности и передаёт решения через task_review. CX Codex ★ 395звёзд репо agents_switch Субагент agents_switch для Claude Code переносит запущенных и остановленных агентов на другой лаунчер за один вызов. Срабатывает по запросу пользователя при контроле лимитов подписки. CX Codex ★ 395звёзд репо standing_actions Субагент standing_actions для Claude Code классифицирует действия, которые разрешает карта подтверждения агента. CX Codex ★ 395звёзд репо agent_send Субагент agent_send для Claude Code отправляет сообщения другому агенту и передаёт ему новую задачу под надзором. Для продолжения работы он может возобновить остановленного агента с прежним контекстом. CX Codex ★ 395звёзд репо engine_handoff Субагент engine_handoff для Claude Code, управляющий передачей сессии между движками и синхронизацией контекста. Запускается при переключении контекста между движками в ходе сессии. CX Codex ★ 395звёзд репо frontend-motion Субагент frontend-motion для Claude Code выполняет задачи по интерфейсам и анимации на веб-клиентах, iOS и Android. Запускается при точечных изменениях интерфейса по готовому заданию. CX Codex ★ 395звёзд репо task_review Субагент task_review для Claude Code проверяет результат делегированной задачи и выбирает вердикт. Он принимает выполненную работу, отправляет пробелы на доработку или передаёт решение владельцу. CX Codex ★ 395звёзд репо task_plan Субагент task_plan для Claude Code формирует и передаёт пользователю план независимых задач для запуска агентов на компьютерах. Запускается при постановке работы, требующей агента или больше нескольких вызовов инструментов. CX Codex ★ 395звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой