Создание пользовательских subagents

• Сохранять контекст, отделяя исследование и реализацию от основного разговора
• Применять ограничения, ограничивая доступ subagent к определённым инструментам
• Переиспользовать конфигурации в проектах с помощью subagents уровня пользователя
• Специализировать поведение с помощью сфокусированных системных приглашений для конкретных областей
• Контролировать затраты, маршрутизируя задачи на более быстрые и дешёвые модели, такие как Haiku

​

Встроенные subagents

• Чтобы заблокировать определённый встроенный тип, добавьте его в permissions.deny, как показано в Отключение определённых subagents.
• Чтобы предотвратить делегирование Claude к любому subagent, запретите сам инструмент Agent с помощью permissions.deny.
• Чтобы удалить только встроенные subagents Explore и Plan, установите CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1. Claude читает и исследует файлы напрямую вместо делегирования им. Требуется Claude Code версии 2.1.198 или позже.
• В неинтерактивном режиме и Agent SDK установите CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1 для удаления всех встроенных типов и предоставления только ваших собственных.

​

Быстрый старт: создание вашего первого субагента

Create a personal code-improver subagent in ~/.claude/agents/ that scans
files and suggests improvements for readability, performance, and best
practices. It should explain each issue, show the current code, and
provide an improved version. Make it read-only and have it use Sonnet.

---
name: code-improver
description: Scans files and suggests improvements for readability, performance, and best practices. Use after writing or modifying code.
tools: Read, Grep, Glob
model: sonnet
---

You are a code improvement specialist. For each issue you find, explain
the problem, show the current code, and provide an improved version.

Use the code-improver agent to suggest improvements in this project

​

Настройка subagents

​

Выберите область subagent

claude --agents '{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist for errors and test failures.",
    "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."
  }
}'

claude --agents @'
{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist for errors and test failures.",
    "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."
  }
}
'@

• prompt: системное приглашение агента, эквивалентное телу markdown в файловых subagents. prompt может быть пустым. Если вы выбираете агента с пустым prompt и без поля memory в качестве агента сессии с помощью --agent, системное приглашение сессии остаётся неизменным. Пустой prompt требует Claude Code v2.1.281 или позже.
• Поля Frontmatter: description, tools, disallowedTools, model, permissionMode, mcpServers, hooks, maxTurns, autoCompactWindow, skills, initialPrompt, memory, effort, background, omitClaudeMd и isolation.
• Игнорируемые поля: color и experimental не принимаются здесь и игнорируются, а не отклоняются.

​

Напишите файлы subagent

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

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

​

Справочник Frontmatter

• Чтобы найти поле с опечаткой в subagent, который загрузился, выполните claude --debug в оболочке и найдите в логе отладки ~/.claude/debug/<session-id>.txt строку does not recognize or apply. Лог отладки называет до пяти полей верхнего уровня в файле subagent, которые Claude Code не распознаёт, с вероятным задуманным именем, когда есть похожее поддерживаемое поле. Требует Claude Code v2.1.296 или позже.
• Чтобы узнать, почему файл subagent не загрузился, см. Subagent files Claude Code skips.

---
name: repo-auditor
description: Audits a large repository and reports what it finds
experimental:
  cacheTtl: 1h
---

​

Файлы subagent, которые Claude Code пропускает

• Нет name: Claude Code рассматривает файл как документацию, хранящуюся рядом с вашими агентами.
• Открывающий ---, который не является первой строкой файла: Claude Code читает файл как не имеющий frontmatter и рассматривает его как документацию.
• name начинается с -, содержит : или длиннее 256 символов: Claude Code пропускает файл и записывает ошибку в лог отладки.
• name, но нет description: Claude Code пропускает файл и записывает причину в журнал отладки.
• YAML, который не парсится: Claude Code не читает никакие поля из файла, пропускает его и записывает ошибку парсинга в журнал отладки.

Проверьте директорию agents перед сессией

​

Выберите модель

• Model alias: используйте один из доступных псевдонимов: sonnet, opus, haiku или fable
• Full model ID: используйте полный ID модели, такой как claude-opus-5-5 или claude-sonnet-5. Принимает те же значения, что и флаг --model
• inherit: используйте ту же модель, что и основной разговор

1. Параметр model для конкретного вызова
2. Frontmatter model определения subagent, где inherit выбирает модель основного разговора
3. Переменная окружения CLAUDE_CODE_SUBAGENT_MODEL, когда вы устанавливаете её на псевдоним модели или ID модели
4. Модель основного разговора

• Модель основного разговора принадлежит этому семейству: subagent работает на точной модели основного разговора, включая любой суффикс [1m], поэтому он получает то же extended context окно, что и основной разговор.
• Claude Code не может определить семейство модели основного разговора, на поставщике, отличном от Anthropic API: это может произойти с application inference profile ARN на Amazon Bedrock, который Claude Code не разрешил в резервную модель. Этот случай охватывает только псевдоним opus и не применяется, когда вы устанавливаете ANTHROPIC_DEFAULT_OPUS_MODEL, поскольку opus затем разрешается в модель, которую вы установили.

• Когда заблокированное значение — это семейный псевдоним, такой как opus, Claude Code запускает subagent на самой новой версии этого семейства, которое разрешает список разрешений, следуя тем же правилам подстановки и области поставщика, что и /model. До версии 2.1.222 Claude Code запускал subagent на унаследованной модели для заблокированного семейного псевдонима также.
• Для любого другого заблокированного значения, на поставщиках, где эта подстановка не работает, или когда список разрешений не разрешает никакую версию семейства, Claude Code запускает subagent на унаследованной модели вместо этого. Если вы установили CLAUDE_CODE_SUBAGENT_MODEL, Claude Code сначала пробует эту модель, под этими же правилами.

​

Запустите каждый subagent на одной модели

• Если вы установили обе переменные, subagents работают на модели в CLAUDE_CODE_SUBAGENT_MODEL.
• Если вы задали только CLAUDE_CODE_SUBAGENT_MODEL_FORCE, субагенты работают на модели основного диалога, за исключением встроенного субагента Explore, который работает на модели, указанной для него в разделе «Встроенные субагенты».

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

• Fork
• Skill, который работает в subagent с model: inherit

​

Выбор уровня effort

​

Если у субагента нет поля или параметра effort

​

Контролируйте возможности subagent

​

Доступные инструменты

• Agent, когда subagent находится на depth limit; в fork инструмент остаётся в списке, но возвращает ошибку вместо порождения
• AskUserQuestion
• EndConversation, который может завершить только основной разговор; см. EndConversation tool behavior
• EnterPlanMode
• ExitPlanMode, если только permissionMode subagent не является plan
• ScheduleWakeup
• WaitForMcpServers
• Workflow

​

Ограничение инструментов, доступных субагенту

---
name: safe-researcher
description: Research agent with restricted capabilities
tools: Read, Grep, Glob, Bash
---

---
name: no-writes
description: Inherits the available tools except file writes
disallowedTools: Write, Edit
---

---
name: local-only
description: Inherits every tool except those from the github MCP server
disallowedTools: mcp__github
---

Имена MCP-серверов с двойным подчёркиванием

• В tools: запишите mcp__, затем полное имя сервера и __*, как в mcp__reports__v2__*. Без завершающего __* запись mcp__reports__v2 не соответствует ни одному инструменту этого сервера.
• В disallowedTools: ищите mcp__reports или mcp__reports__* — записи, которые исключают сервер с именем reports. С любой из этих записей субагент теряет и все инструменты reports__v2, потому что имена этих инструментов тоже начинаются с mcp__reports__. Чтобы исключить только инструменты сервера reports, перечислите их по одному, например mcp__reports__run_query.

​

Ограничьте, какие subagents могут быть порождены

---
name: coordinator
description: Coordinates work across specialized agents
tools: Agent(worker, researcher), Read, Bash
---

tools: Agent, Read, Bash

​

Область MCP servers для subagent

---
name: browser-tester
description: Tests features in a real browser using Playwright
mcpServers:
  # Inline definition: scoped to this subagent only
  - playwright:
      type: stdio
      command: npx
      args: ["-y", "@playwright/mcp@latest"]
  # Reference by name: reuses an already-configured server
  - github
---

Use the Playwright tools to navigate, screenshot, and interact with pages.

• --strict-mcp-config и --bare
• Корпоративная управляемая конфигурация MCP
• Политики allowedMcpServers и deniedMcpServers

​

Доверие, необходимое для встроенных MCP-серверов

• Доверие, которое не считается: доверие родительской папки и автоматическое доверие, которое сессия -p или SDK получает для hooks в файлах настроек
• До тех пор: Claude Code пропускает каждый встроенный сервер в этом файле агента и записывает точный ключ projects["<path>"].hasTrustDialogAccepted для ~/.claude.json в журнал отладки
• Директории --add-dir: директория вне репозитория вашего доверенного рабочего пространства нуждается в собственной записи доверия, поскольку её файлы .claude/agents/ не наследуют доверие вашего рабочего пространства

• Имя, которое ссылается на сервер, который вы уже настроили
• Встроенный сервер в файле агента из ~/.claude/agents/, в одном, который вы передаёте с помощью --agents или опции SDK agents, или в одном, который управляемые настройки предоставляют

​

Режимы разрешений

• Когда основной разговор находится в bypassPermissions, acceptEdits или auto mode, subagent работает в этом же режиме и Claude Code игнорирует permissionMode, который вы установили. Под auto mode классификатор оценивает вызовы инструментов subagent с правилами блокировки и разрешения основного разговора. Когда subagent завершается, классификатор также проверяет его работу и его финальный отчёт перед доставкой отчёта, как How auto mode handles subagents описывает.
• Когда основной диалог находится в режиме plan, субагент остаётся в режиме планирования независимо от заданного permissionMode, если только он не работает как участник команды агентов по правилам команд агентов. Если вы задали dontAsk, субагент также не запрашивает у вас подтверждения: действие, для которого режим планирования запросил бы ваше одобрение, вместо этого отклоняется.
• Когда основной диалог находится в режиме default или dontAsk, субагент работает в заданном вами режиме разрешений. В следующих случаях он вместо этого сохраняет режим разрешений основного диалога:
  • Вы задали bypassPermissions. Исключение для bypassPermissions требует Claude Code v2.1.267 или новее.
  • Вы задали auto, а авторежим недоступен субагенту, например когда файл настроек задаёт disableAutoMode или модель субагента не поддерживает авторежим.

​

Предварительная загрузка skills в subagents

---
name: api-developer
description: Implement API endpoints following team conventions
skills:
  - api-conventions
  - error-handling-patterns
---

Implement API endpoints. Follow the conventions and patterns from the preloaded skills.

​

Включите постоянную память

---
name: code-reviewer
description: Reviews code for quality and best practices
memory: user
---

You are a code reviewer. As you review code, update your agent memory with
patterns, conventions, and recurring issues you discover.

• Системное приглашение subagent включает инструкции для чтения и записи в каталог памяти.
• Системное приглашение subagent также включает первые 200 строк или 25KB MEMORY.md в каталоге памяти, в зависимости от того, что меньше, с инструкциями по курированию MEMORY.md, если она превышает этот лимит.
• Инструменты Read, Write и Edit автоматически включаются, чтобы subagent мог управлять своими файлами памяти.

Советы по постоянной памяти

• project — рекомендуемая область по умолчанию. Это делает знания subagent доступными для совместного использования через систему контроля версий.
• Попросите subagent проверить его память перед началом работы: “Review this PR, and check your memory for patterns you’ve seen before.”
• Попросите subagent обновить его память после завершения задачи: “Now that you’re done, save what you learned to your memory.” Со временем это создаёт базу знаний, которая делает subagent более эффективным.
• Включите инструкции по памяти непосредственно в файл markdown subagent, чтобы он активно поддерживал свою собственную базу знаний:
  Update your agent memory as you discover codepaths, patterns, library
  locations, and key architectural decisions. This builds up institutional
  knowledge across conversations. Write concise notes about what you found
  and where.
  

​

Условные правила с hooks

---
name: db-reader
description: Execute read-only database queries
tools: Bash
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate-readonly-query.sh"
---

#!/bin/bash
# ./scripts/validate-readonly-query.sh

INPUT=$(cat)
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')

# Block SQL write operations (case-insensitive)
if echo "$COMMAND" | grep -iE '\b(INSERT|UPDATE|DELETE|DROP|CREATE|ALTER|TRUNCATE)\b' > /dev/null; then
  echo "Blocked: Only SELECT queries are allowed" >&2
  exit 2
fi

exit 0

chmod +x ./scripts/validate-readonly-query.sh

​

Отключите конкретные subagents

{
  "permissions": {
    "deny": ["Agent(Explore)", "Agent(my-custom-agent)"]
  }
}

claude --disallowedTools "Agent(Explore)"

​

Определите hooks для subagents

• В frontmatter subagent: определите hooks, которые запускаются только во время активности этого subagent
• В settings.json: определите hooks уровня сессии, которые также срабатывают внутри subagents. События инструментов, такие как PreToolUse и PostToolUse, срабатывают для вызовов инструментов subagent так же, как они срабатывают в основном разговоре, и SubagentStart и SubagentStop срабатывают, когда subagent начинает или завершает работу

​

Hooks в frontmatter subagent

---
name: code-reviewer
description: Review code changes with automatic linting
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate-command.sh"
  PostToolUse:
    - matcher: "Edit|Write"
      hooks:
        - type: command
          command: "./scripts/run-linter.sh"
---

​

Hooks уровня проекта для событий subagent

{
  "hooks": {
    "SubagentStart": [
      {
        "matcher": "db-agent",
        "hooks": [
          { "type": "command", "command": "./scripts/setup-db-connection.sh" }
        ]
      }
    ],
    "SubagentStop": [
      {
        "hooks": [
          { "type": "command", "command": "./scripts/cleanup-db-connection.sh" }
        ]
      }
    ]
  }
}

​

Работа с субагентами

​

Понимание автоматического делегирования

​

Явный вызов субагентов

• Естественный язык: назовите субагента в своём промпте; Claude решает, делегировать ли задачу
• @-упоминание: гарантирует, что субагент запустится для одной задачи
• На уровне сессии: вся сессия работает как этот субагент благодаря флагу --agent или настройке agent

Use the test-runner subagent to fix failing tests
Have the code-reviewer subagent look at my recent changes

@"code-reviewer (agent)" look at the auth changes

claude --agent code-reviewer

claude --agent security-reviewer

claude --agent my-plugin:security-reviewer

{
  "agent": "code-reviewer"
}

​

Запуск субагентов на переднем плане или в фоне

• Субагенты на переднем плане блокируют основной диалог до своего завершения. Запросы разрешений передаются вам по мере их появления.
• Фоновые субагенты работают параллельно, пока вы продолжаете работу. Когда фоновый субагент доходит до вызова инструмента, требующего разрешения, Claude Code показывает запрос в вашей основной сессии и называет субагента, который его запрашивает. Подтвердите, чтобы субагент продолжил работу, или нажмите Esc, чтобы отклонить этот единственный вызов инструмента, не останавливая субагента.

​

Какие субагенты работают в фоне

• claude -p и Agent SDK: Claude может дождаться субагента — по собственному решению или по вашей просьбе.
• Интерактивная сессия в терминале, VS Code и сессии приложения для компьютера на вашей машине: чтобы Claude мог дождаться субагента, выключите режим fork, который включён по умолчанию.

​

Как позволить Claude дождаться субагента

1. Выключите режим fork, задав CLAUDE_CODE_FORK_SUBAGENT значение 0, например в settings.json:
   {
     "env": {
       "CLAUDE_CODE_FORK_SUBAGENT": "0"
     }
   }
   
2. Снова запустите claude из оболочки или откройте новый диалог в VS Code.
3. Попросите Claude подождать, когда вам сначала нужен результат, например “run the reviewer subagent and wait for its report”.

​

Инструменты, разрешения и результаты фоновых субагентов

​

Завершённые субагенты в панели и списке задач

• Когда субагент завершается успешно, Claude Code сразу удаляет его строку и, кроме режима чтения с экрана, показывает в нижней строке /tasks to see subagents в течение 30 секунд. В течение этих 30 секунд выполните /tasks и нажмите Enter на субагенте, чтобы открыть его транскрипт. До v2.1.232 Claude Code сохранял строку в течение 30 секунд после завершения субагента, так же как для завершившегося с ошибкой, и не показывал подсказку в нижней строке.
• Когда субагент завершается с ошибкой или вы его останавливаете, Claude Code сохраняет его строку в течение 30 секунд. Чтобы убрать строку раньше, выберите её и нажмите x.

​

Имена субагентов

​

Ошибки API в субагентах

• Передний план: если ограничение частоты запросов, перегрузка или ошибка сервера обрывает субагента, который уже выдал текстовый вывод, инструмент Agent возвращает этот частичный вывод с пометкой о том, что субагент был прерван и не завершил задачу. Субагент, который ничего не выдал или весь вывод которого состоял из вызовов инструментов, завершается с ошибкой Agent terminated early due to an API error, за которой следуют подробности ошибки.
• Фон: субагент помечается как завершившийся с ошибкой, а сообщение, которое Claude получает при его завершении, называет ошибку API и включает последний вывод субагента, так что частичная работа не теряется.

⚠ This agent switched to <model> because its earlier model could not be used.

​

Сканирование вывода субагентов

• Вставка обратной косой черты: сканирование вставляет обратную косую черту в текст, имитирующий собственный вывод Claude Code, например тег <system-reminder> или строку, начинающуюся с Human: или Assistant:, чтобы такая имитация читалась как обычный текст, а не принималась по ошибке за часть диалога.
• Строка-маркер: сканирование добавляет в начало строку, начинающуюся с [harness: subagent output matched instruction-shaped pattern(s):, когда отчёт имитирует тег вроде <system-reminder> или упоминает настройки разрешений, такие как bypassPermissions или --dangerously-skip-permissions. Упоминания настроек разрешений получают строку-маркер, но сам текст остаётся без изменений.

​

Распространённые паттерны

​

Изоляция операций с большим объёмом вывода

Use a subagent to run the test suite and report only the failing tests with their error messages

​

Параллельное исследование

Research the authentication, database, and API modules in parallel using separate subagents

​

Цепочки субагентов

Use the code-reviewer subagent to find performance issues, then use the optimizer subagent to fix them

​

Выбор между субагентами и основным диалогом

• Задача требует частого обмена репликами или итеративного уточнения
• Несколько этапов, например планирование, реализация и тестирование, используют значительный общий контекст
• Вы вносите быстрое точечное изменение
• Важна задержка. Субагент, который не является форком, начинает с чистого листа, и ему может потребоваться время на сбор контекста

• Задача производит подробный вывод, который не нужен в основном контексте
• Вы хотите применить определённые ограничения инструментов или разрешений
• Работа самодостаточна и может вернуть сводку

​

Разрешите субагентам порождать собственных субагентов

• Интерактивная сессия в терминале: к вам возвращается только сводка субагента верхнего уровня, поскольку субагент, запускающий фоновых субагентов, дожидается их результатов, прежде чем завершиться.
• claude -p и Agent SDK: запускающий субагент ждёт, пока включён режим fork. Если выключить режим fork, вложенные субагенты вместо этого запускаются в фоне. Запускающий субагент не ждёт фонового вложенного субагента, и тот отчитывается в ваш основной диалог, если завершается позже запускающего.

{
  "env": {
    "CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH": "2"
  }
}

​

Лимит одновременных субагентов

• Форк внутри сессии, который вы запускаете с помощью /subtask, занимает слот, пока работает, и никогда не блокируется лимитом.
• Возобновление субагента, который уже завершился, занимает новый слот без проверки лимита, поэтому возобновления могут вывести число работающих субагентов за пределы лимита.

​

Управление контекстом субагентов

​

Что загружается при запуске

• Системный промпт: собственный промпт агента плюс сведения об окружении, которые добавляет Claude Code, — а не системный промпт Claude Code. Пользовательские субагенты задают свой промпт в теле markdown или в поле prompt. У встроенных агентов промпты заданы заранее.
• Сообщение задачи: промпт делегирования, который Claude пишет, передавая работу.
• Файлы CLAUDE.md: все уровни иерархии CLAUDE.md, которые загружает основной диалог, включая ~/.claude/CLAUDE.md, правила проекта, CLAUDE.local.md, файлы управляемых политик и любые файлы AGENTS.md, загружаемые как инструкции проекта. Встроенные агенты Explore и Plan это пропускают. Субагент, в определении которого задано omitClaudeMd, загружает только файлы управляемых политик, а если определение получено из управляемых настроек — вообще ничего.
• Статус Git: снимок, который Claude Code считывает из вашего репозитория при запуске субагента. Для субагента в собственном worktree этого репозитория снимок показывает ветку, статус и последние коммиты этого worktree. Отсутствует вне Git-репозитория или если снимок отключён; см. includeGitInstructions. Explore и Plan пропускают его в любом случае.
• Предзагруженные скиллы: полное содержимое всех скиллов, перечисленных в поле skills агента. Встроенные агенты не предзагружают скиллы.
• Список соседних агентов: системное напоминание со списком main и всех остальных именованных агентов в сессии; каждый из них — допустимое значение to для SendMessage. Список появляется, только если инструменты субагента включают SendMessage и хотя бы у одного другого агента есть имя — неважно, дал ли его Claude при порождении или агент работает как участник команды агентов. Это снимок на момент запуска субагента, поэтому агенты, получившие имя позже, в нём не отображаются.

• Стиль вывода: субагент работает со своим собственным системным промптом, поэтому ваш стиль вывода не влияет на его ответы, кроме случая форка.
• Автоматическая память: автоматическая память основного диалога не загружается. Чтобы дать субагенту собственную постоянную память, используйте поле memory.
• Размер контекстного окна: размер контекстного окна субагента определяется его собственной моделью, а не родительской. При делегировании модели с меньшим окном этот субагент получает меньшее окно.

​

Возобновление субагентов

• Когда субагент завершается, Claude получает его ID агента.
• Встроенные агенты Explore и Plan одноразовые и не возвращают ID агента, поэтому Claude не может их возобновить. Используйте general-purpose или пользовательского субагента, когда нужно продолжить работу.
• Когда субагент останавливается на своём лимите maxTurns, Claude Code помечает возвращённый вывод как частичный, и Claude может возобновить субагента, чтобы тот продолжил работу.

Use the code-reviewer subagent to review the authentication module
[Agent completes]

Continue that code review and now analyze the authorization logic
[Claude resumes the subagent with full context from previous conversation]

• Сжатие контекста основного диалога: когда выполняется сжатие контекста основного диалога, транскрипты субагентов не затрагиваются. Они хранятся в отдельных файлах.
• Сохранение сессии: транскрипты субагентов сохраняются в пределах своей сессии. Вы можете возобновить субагента после перезапуска Claude Code, возобновив ту же сессию.
• Автоматическая очистка: Claude Code удаляет транскрипты субагентов по истечении срока хранения cleanupPeriodDays, по умолчанию 30 дней, согласно правилам очистки по сроку хранения.

Отправка сообщения субагенту по имени после перезапуска

​

Автосжатие

{
  "type": "system",
  "subtype": "compact_boundary",
  "compactMetadata": {
    "trigger": "auto",
    "preTokens": 167189
  }
}

Задание окна автосжатия для одного субагента

---
name: log-reader
description: Reads long log files and reports the errors it finds
autoCompactWindow: 200000
---

• Значение не ниже окна автосжатия, которое субагент иначе унаследовал бы: чтобы сжатие происходило раньше, задайте значение ниже этого окна.
• Вы запускаете всю сессию как этого субагента с --agent или настройкой agent: в этом случае поле не действует. Чтобы задать окно для сессии, см. Задание окна автосжатия.

​

Разветвление текущего разговора

/subtask draft unit tests for the parser changes so far

​

Наблюдение и управление работающими forks

• /compact, /clear и /rewind действуют на основной диалог, поэтому Claude Code просит вас подтвердить запуск любой из них из этого представления.
• /model и /fast задают модель и быстрый режим основного диалога, а не просматриваемого агента, поэтому из этого представления они не запускаются. Уведомление объясняет причину.

​

Как forks отличаются от других subagents

​

Отключение режима fork

• Остановить только forks: добавьте "Agent(fork)" в permissions.deny в ваших настройках.
• Отключить режим fork: установите CLAUDE_CODE_FORK_SUBAGENT в 0, следуя шагам в разделе Разрешите Claude ждать субагента.

​

Примеры subagents

​

Code reviewer

---
name: code-reviewer
description: Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code.
tools: Read, Grep, Glob, Bash
model: inherit
---

You are a senior code reviewer ensuring high standards of code quality and security.

When invoked:
1. Run git diff to see recent changes
2. Focus on modified files
3. Begin review immediately

Review checklist:
- Code is clear and readable
- Functions and variables are well-named
- No duplicated code
- Proper error handling
- No exposed secrets or API keys
- Input validation implemented
- Good test coverage
- Performance considerations addressed

Provide feedback organized by priority:
- Critical issues (must fix)
- Warnings (should fix)
- Suggestions (consider improving)

Include specific examples of how to fix issues.

​

Debugger

---
name: debugger
description: Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues.
tools: Read, Edit, Bash, Grep, Glob
---

You are an expert debugger specializing in root cause analysis.

When invoked:
1. Capture error message and stack trace
2. Identify reproduction steps
3. Isolate the failure location
4. Implement minimal fix
5. Verify solution works

Debugging process:
- Analyze error messages and logs
- Check recent code changes
- Form and test hypotheses
- Add strategic debug logging
- Inspect variable states

For each issue, provide:
- Root cause explanation
- Evidence supporting the diagnosis
- Specific code fix
- Testing approach
- Prevention recommendations

Focus on fixing the underlying issue, not the symptoms.

​

Data scientist

---
name: data-scientist
description: Data analysis expert for SQL queries, BigQuery operations, and data insights. Use proactively for data analysis tasks and queries.
tools: Bash, Read, Write
model: sonnet
---

You are a data scientist specializing in SQL and BigQuery analysis.

When invoked:
1. Understand the data analysis requirement
2. Write efficient SQL queries
3. Use BigQuery command line tools (bq) when appropriate
4. Analyze and summarize results
5. Present findings clearly

Key practices:
- Write optimized SQL queries with proper filters
- Use appropriate aggregations and joins
- Include comments explaining complex logic
- Format results for readability
- Provide data-driven recommendations

For each analysis:
- Explain the query approach
- Document any assumptions
- Highlight key findings
- Suggest next steps based on data

Always ensure queries are efficient and cost-effective.

​

Database query validator

---
name: db-reader
description: Execute read-only database queries. Use when analyzing data or generating reports.
tools: Bash
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate-readonly-query.sh"
---

You are a database analyst with read-only access. Execute SELECT queries to answer questions about the data.

When asked to analyze data:
1. Identify which tables contain the relevant data
2. Write efficient SELECT queries with appropriate filters
3. Present results clearly with context

You cannot modify data. If asked to INSERT, UPDATE, DELETE, or modify schema, explain that you only have read access.

#!/bin/bash
# Blocks SQL write operations, allows SELECT queries

# Read JSON input from stdin
INPUT=$(cat)

# Extract the command field from tool_input using jq
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')

if [ -z "$COMMAND" ]; then
  exit 0
fi

# Block write operations (case-insensitive)
if echo "$COMMAND" | grep -iE '\b(INSERT|UPDATE|DELETE|DROP|CREATE|ALTER|TRUNCATE|REPLACE|MERGE)\b' > /dev/null; then
  echo "Blocked: Write operations not allowed. Use SELECT queries only." >&2
  exit 2
fi

exit 0

chmod +x ./scripts/validate-readonly-query.sh

​

Следующие шаги

• Распространяйте subagents с помощью plugins для совместного использования subagents в командах или проектах
• Запустите Claude Code программно с помощью Agent SDK для CI/CD и автоматизации
• Используйте MCP servers для предоставления subagents доступа к внешним инструментам и данным