agent_interrupt — субагент для Claude Code
Субагент agent_interrupt для Claude Code останавливает другого агента и может сразу передать ему новую задачу. Запускайте его, когда агент зациклился, повторяет ошибочный шаг или работает не в ту сторону.
MIT ★ 395 обновлён 2026-11-16
.claude/agents/agent_interrupt.mdЧто делает agent_interrupt
agent_interrupt прерывает текущий ход выбранного агента и при желании сразу отправляет ему новую инструкцию. Для выбора нужны идентификатор или имя машины из agents_list и ID сессии агента либо его первые восемь символов. Пустое поле then останавливает агента без нового сообщения.
Сессия и сам агент остаются активны, а уже выполненные действия не отменяются: изменения файлов и запущенные команды придётся отменить отдельной инструкцией. Субагент не работает с диалогами ассистента и агентами, доступными только для чтения. Команда then из одного /exit или /quit не остановит агента на задаче под надзором другого диалога.
Какие задачи решает
- остановить агента, который повторяет неудачный шаг
- прервать цикл ожидания или опроса
- сменить направление работы агента без завершения его сессии
- передать агенту новую инструкцию сразу после остановки
Примеры запросов агенту
- Останови агента на машине
devbox, сессияa1b2c3d4, и попроси его отменить последние изменения вsrc/app.ts. - Прерви агента сессии
a1b2c3d4на машинеdevbox, он зациклился на проверке. - Останови агента
a1b2c3d4наdevboxбез нового сообщения.
Как установить agent_interrupt
Вручную: положить файлы
.claude/agents/agent_interrupt.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/agent_interrupt.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/agent_interrupt.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы об agent_interrupt
Как установить agent_interrupt в Claude Code?
Скопируйте файл субагента в .claude/agents/agent_interrupt.md.
Что делает agent_interrupt?
Он прерывает текущую работу выбранного агента и может сразу передать ему новую инструкцию. Агент и его сессия при этом сохраняются.
Что нужно указать, чтобы остановить агента?
Нужны имя или ID машины из agents_list и ID сессии либо первые восемь символов ID. Уже внесённые изменения и выполненные команды автоматически не отменяются.
Исходный текст
agent_interrupt.md · MIT
Stop what an agent (from agents_list) is doing right now, and optionally redirect it: its current turn is cut off (Esc in its terminal, or its runtime's cancel), the agent and its session stay, and `then` is sent to it at once as the user would type it. Use it when waiting is worse than stopping: it works in the wrong direction, waits in a loop (sleep, polling), repeats a failing step, collides with another agent, or the user said stop. To add a word to an agent that works fine, use agent_send instead (queued behind its turn). What it did already is not undone (files it changed, commands it ran): tell it in `then` what to put back. Not for assistant conversations, and not for agents that can only be read. A `then` of only /exit or /quit to an agent on a task another conversation supervises is refused, as agent_send refuses it: nothing is stopped or sent.
```json
{
"type": "object",
"required": ["machine", "session_id"],
"properties": {
"machine": {
"type": "string",
"description": "the machine's id or name, as agents_list shows it"
},
"session_id": {
"type": "string",
"description": "the agent's session id, or its first 8 characters"
},
"then": {
"type": "string",
"description": "the new instruction, sent right after it stopped; empty: just stop it"
}
}
}
```
© nwverse · MIT · nwverse/persona