Documentation 2026-07-02 23:59 UTC to 2026-07-03 23:00 UTC

90| [Version floor](/ru/settings) | Предотвратить автоматическое обновление от установки ниже минимума на уровне организации | `minimumVersion` |90| [Version floor](/ru/settings) | Предотвратить автоматическое обновление от установки ниже минимума на уровне организации | `minimumVersion` |

91| [Required version range](/ru/settings) | Отказать в запуске полностью, когда запущенная версия находится вне одобренного организацией диапазона. Более строгий, чем `minimumVersion`, который только блокирует понижение версии | `requiredMinimumVersion`, `requiredMaximumVersion` |91| [Required version range](/ru/settings) | Отказать в запуске полностью, когда запущенная версия находится вне одобренного организацией диапазона. Более строгий, чем `minimumVersion`, который только блокирует понижение версии | `requiredMinimumVersion`, `requiredMaximumVersion` |

92 92 

93Организации, члены которых проходят аутентификацию через claude.ai или Anthropic API, также могут управлять моделями без развертывания параметров: [ограничения модели организации](/ru/model-config#organization-model-restrictions) отключают отдельные модели, [модель по умолчанию организации](/ru/model-config#organization-default-model) устанавливает, на какой модели начинаются новые сеансы, и [ограничения усилий организации](/ru/model-config#organization-effort-limits) ограничивают уровни усилий по ролям. Все три элемента управления требуют плана Claude Enterprise. Ограничения модели и ограничения усилий применяются на стороне сервера; модель по умолчанию — это отправная точка, которую пользователи могут изменить, если только организация не применяет ее принудительно. Принудительное применение доступно для ограниченного набора организаций; обратитесь к команде вашего аккаунта Anthropic о доступности. Ни один из этих элементов управления не достигает сеансов на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или [Claude Platform on AWS](/ru/claude-platform-on-aws); на этих поставщиках используйте `availableModels` выше для ограничений и ключ `model` в управляемых параметрах для значения по умолчанию.

94 

93Правила разрешений и песочница охватывают разные слои. Запрет WebFetch блокирует инструмент fetch Claude, но если Bash разрешен, `curl` и `wget` все еще могут достичь любого URL-адреса. Песочница закрывает этот пробел с разрешенным списком сетевых доменов, принудительно применяемым на уровне ОС.95Правила разрешений и песочница охватывают разные слои. Запрет WebFetch блокирует инструмент fetch Claude, но если Bash разрешен, `curl` и `wget` все еще могут достичь любого URL-адреса. Песочница закрывает этот пробел с разрешенным списком сетевых доменов, принудительно применяемым на уровне ОС.

94 96 

95Для модели угроз, которую защищают эти элементы управления, см. [Security](/ru/security).97Для модели угроз, которую защищают эти элементы управления, см. [Security](/ru/security).

85Советник должен быть по крайней мере такой же способной, как основная модель. Принятые советники для каждой основной модели:85Советник должен быть по крайней мере такой же способной, как основная модель. Принятые советники для каждой основной модели:

86 86 

87| Основная модель | Принятые советники | Примечания |87| Основная модель | Принятые советники | Примечания |

88| ----------------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |88| ----------------------------------------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

89| Haiku 4.5 | Fable, Opus, Sonnet | Haiku может вызывать советника, но не может быть им |89| Haiku 4.5 | Fable, Opus, Sonnet | Haiku может вызывать советника, но не может быть им |

90| Sonnet 4.6 | Fable, Opus, Sonnet | |90| Sonnet 4.6 | Fable, Opus, Sonnet | |

91| Sonnet 5 | Fable, Opus, Sonnet 5 | Советник Sonnet 4.6 отклоняется |91| Sonnet 5 | Fable, Opus, Sonnet 5 | Советник Sonnet 4.6 отклоняется |

92| Opus 4.6 или позже | Fable, Opus на версии основной модели или выше | Opus 4.7 в качестве основной с советником Opus 4.6 отклоняется. Основная модель Opus 4.6 также принимает советника Sonnet 5 |92| Opus 4.6 | Fable, Opus, Sonnet 5 | Sonnet 5 и Opus 4.6 ранжируются как одинаково способные, поэтому основная модель Opus 4.6 принимает советника Sonnet 5 |

93| Opus 4.7 или позже | Fable, Opus 4.7, Opus 4.8 | Opus 4.7 и Opus 4.8 ранжируются как одинаково способные, поэтому каждый принимает другого в качестве советника. Основная модель Opus 4.7 с советником Opus 4.6 или Sonnet 5 отклоняется |

93| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Советник Opus или Sonnet отклоняется |94| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Советник Opus или Sonnet отклоняется |

94 95 

95Fable 5 требует Claude Code v2.1.170 или более поздней версии и доступ к Fable 5, независимо от того, действует ли она в качестве основной модели или советника.96Fable 5 требует Claude Code v2.1.170 или более поздней версии и доступ к Fable 5, независимо от того, действует ли она в качестве основной модели или советника.

174/advisor off175/advisor off

175```176```

176 177 

177Чтобы полностью отключить инструмент advisor, включая команду `/advisor` и флаг `--advisor`, установите `CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`. См. [Environment variables](/ru/env-vars).178Чтобы полностью отключить инструмент advisor, установите `CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`. Команда `/advisor` становится недоступной и любой настроенный `advisorModel` игнорируется. Флаг `--advisor` принимается, но не имеет эффекта; существующие скрипты, которые его передают, продолжают работать без ошибок. См. [Environment variables](/ru/env-vars).

178 179 

179<h2 id="compare-with-related-features">180<h2 id="compare-with-related-features">

180 Сравнение со связанными функциями181 Сравнение со связанными функциями

86<Accordion title="Пример: Проверить типы сообщений и обработать результаты">86<Accordion title="Пример: Проверить типы сообщений и обработать результаты">

87 <CodeGroup>87 <CodeGroup>

88 ```python Python theme={null}88 ```python Python theme={null}

89 import asyncio

89 from claude_agent_sdk import query, AssistantMessage, ResultMessage90 from claude_agent_sdk import query, AssistantMessage, ResultMessage

90 91 

92 

93 async def main():

94 try:

91 async for message in query(prompt="Summarize this project"):95 async for message in query(prompt="Summarize this project"):

92 if isinstance(message, AssistantMessage):96 if isinstance(message, AssistantMessage):

93 print(f"Turn completed: {len(message.content)} content blocks")97 print(f"Turn completed: {len(message.content)} content blocks")

96 print(message.result)100 print(message.result)

97 else:101 else:

98 print(f"Stopped: {message.subtype}")102 print(f"Stopped: {message.subtype}")

103 except Exception as error:

104 # A single-shot query() raises after yielding an error result. If the

105 # failure was an error result, the error subtype branches above have

106 # already run; connection or process failures yield no result message.

107 print(f"Session ended with an error: {error}")

108 

109 

110 asyncio.run(main())

99 ```111 ```

100 112 

101 ```typescript TypeScript theme={null}113 ```typescript TypeScript theme={null}

102 import { query } from "@anthropic-ai/claude-agent-sdk";114 import { query } from "@anthropic-ai/claude-agent-sdk";

103 115 

116 try {

104 for await (const message of query({ prompt: "Summarize this project" })) {117 for await (const message of query({ prompt: "Summarize this project" })) {

105 if (message.type === "assistant") {118 if (message.type === "assistant") {

106 console.log(`Turn completed: ${message.message.content.length} content blocks`);119 console.log(`Turn completed: ${message.message.content.length} content blocks`);

113 }126 }

114 }127 }

115 }128 }

129 } catch (error) {

130 // A single-shot query() throws after yielding an error result. If the

131 // failure was an error result, the error subtype branches above have

132 // already run; connection or process failures yield no result message.

133 console.log(`Session ended with an error: ${error}`);

134 }

116 ```135 ```

117 </CodeGroup>136 </CodeGroup>

118</Accordion>137</Accordion>

321 340 

322Поле `result` (финальный текстовый выход) присутствует только в варианте `success`, поэтому всегда проверяйте подтип перед его чтением. Все подтипы результатов содержат `total_cost_usd`, `usage`, `num_turns` и `session_id`, поэтому вы можете отслеживать стоимость и возобновлять даже после ошибок. В Python `total_cost_usd` и `usage` типизированы как опциональные и могут быть `None` на некоторых путях ошибок, поэтому охраняйте перед форматированием. См. [Отслеживание стоимости и использования](/ru/agent-sdk/cost-tracking) для деталей по интерпретации полей `usage`.341Поле `result` (финальный текстовый выход) присутствует только в варианте `success`, поэтому всегда проверяйте подтип перед его чтением. Все подтипы результатов содержат `total_cost_usd`, `usage`, `num_turns` и `session_id`, поэтому вы можете отслеживать стоимость и возобновлять даже после ошибок. В Python `total_cost_usd` и `usage` типизированы как опциональные и могут быть `None` на некоторых путях ошибок, поэтому охраняйте перед форматированием. См. [Отслеживание стоимости и использования](/ru/agent-sdk/cost-tracking) для деталей по интерпретации полей `usage`.

323 342 

343<Note>

344 Когда запрос заканчивается на результате ошибки:

345 

346 * Одиночный вызов `query()` выдает финальное сообщение результата, затем вызывает ошибку, которая включает текст отказа, такой как `Reached maximum number of turns`. Вызов ошибки намеренный — оберните цикл в блок try, если вашему коду нужно продолжить работу после него. Базовый процесс Claude Code также завершается с ненулевым кодом.

347 * Сеанс потоковой передачи входных данных остается активным, и вы можете продолжать отправлять сообщения.

348</Note>

349 

324Результат также включает поле `stop_reason` (`string | null` в TypeScript, `str | None` в Python), указывающее, почему модель остановила генерацию на своем финальном ходе. Общие значения — `end_turn` (модель закончила нормально), `max_tokens` (достигнут лимит выходных токенов) и `refusal` (модель отклонила запрос). На подтипах результатов ошибок `stop_reason` содержит значение из последнего ответа помощника перед завершением цикла. Для обнаружения отклонений проверьте `stop_reason === "refusal"` (TypeScript) или `stop_reason == "refusal"` (Python). См. [`SDKResultMessage`](/ru/agent-sdk/typescript#sdkresultmessage) (TypeScript) или [`ResultMessage`](/ru/agent-sdk/python#resultmessage) (Python) для полного типа.350Результат также включает поле `stop_reason` (`string | null` в TypeScript, `str | None` в Python), указывающее, почему модель остановила генерацию на своем финальном ходе. Общие значения — `end_turn` (модель закончила нормально), `max_tokens` (достигнут лимит выходных токенов) и `refusal` (модель отклонила запрос). На подтипах результатов ошибок `stop_reason` содержит значение из последнего ответа помощника перед завершением цикла. Для обнаружения отклонений проверьте `stop_reason === "refusal"` (TypeScript) или `stop_reason == "refusal"` (Python). См. [`SDKResultMessage`](/ru/agent-sdk/typescript#sdkresultmessage) (TypeScript) или [`ResultMessage`](/ru/agent-sdk/python#resultmessage) (Python) для полного типа.

325 351 

326<h2 id="hooks">352<h2 id="hooks">

348 374 

349Этот пример объединяет ключевые концепции с этой страницы в одного агента, который исправляет неудачные тесты. Он конфигурирует агента с разрешенными инструментами (автоматически одобренными, поэтому агент работает автономно), настройками проекта и ограничениями безопасности на ходы и усилия рассуждения. По мере выполнения цикла он захватывает ID сессии для потенциального возобновления, обрабатывает финальный результат и выводит общую стоимость.375Этот пример объединяет ключевые концепции с этой страницы в одного агента, который исправляет неудачные тесты. Он конфигурирует агента с разрешенными инструментами (автоматически одобренными, поэтому агент работает автономно), настройками проекта и ограничениями безопасности на ходы и усилия рассуждения. По мере выполнения цикла он захватывает ID сессии для потенциального возобновления, обрабатывает финальный результат и выводит общую стоимость.

350 376 

377Поскольку один вызов `query()` вызывает исключение после выдачи результата ошибки, цикл обернут в блок try, чтобы скрипт корректно завершился при достижении лимита.

378 

351<CodeGroup>379<CodeGroup>

352 ```python Python theme={null}380 ```python Python theme={null}

353 import asyncio381 import asyncio

357 async def run_agent():385 async def run_agent():

358 session_id = None386 session_id = None

359 387 

388 try:

360 async for message in query(389 async for message in query(

361 prompt="Find and fix the bug causing test failures in the auth module",390 prompt="Find and fix the bug causing test failures in the auth module",

362 options=ClaudeAgentOptions(391 options=ClaudeAgentOptions(

389 print(f"Stopped: {message.subtype}")418 print(f"Stopped: {message.subtype}")

390 if message.total_cost_usd is not None:419 if message.total_cost_usd is not None:

391 print(f"Cost: ${message.total_cost_usd:.4f}")420 print(f"Cost: ${message.total_cost_usd:.4f}")

421 except Exception as error:

422 # A single-shot query() raises after yielding an error result. If the

423 # failure was an error result, the error subtype branches above have

424 # already run; connection or process failures yield no result message.

425 print(f"Session ended with an error: {error}")

392 426 

393 427 

394 asyncio.run(run_agent())428 asyncio.run(run_agent())

399 433 

400 let sessionId: string | undefined;434 let sessionId: string | undefined;

401 435 

436 try {

402 for await (const message of query({437 for await (const message of query({

403 prompt: "Find and fix the bug causing test failures in the auth module",438 prompt: "Find and fix the bug causing test failures in the auth module",

404 options: {439 options: {

428 console.log(`Cost: $${message.total_cost_usd.toFixed(4)}`);463 console.log(`Cost: $${message.total_cost_usd.toFixed(4)}`);

429 }464 }

430 }465 }

466 } catch (error) {

467 // A single-shot query() throws after yielding an error result. If the

468 // failure was an error result, the error subtype branches above have

469 // already run; connection or process failures yield no result message.

470 console.log(`Session ended with an error: ${error}`);

471 }

431 ```472 ```

432</CodeGroup>473</CodeGroup>

433 474 

63 ```typescript TypeScript theme={null}63 ```typescript TypeScript theme={null}

64 import { query } from "@anthropic-ai/claude-agent-sdk";64 import { query } from "@anthropic-ai/claude-agent-sdk";

65 65 

66 try {

66 for await (const message of query({ prompt: "Summarize this project" })) {67 for await (const message of query({ prompt: "Summarize this project" })) {

67 if (message.type === "result") {68 if (message.type === "result") {

68 console.log(`Total cost: $${message.total_cost_usd}`);69 console.log(`Total cost: $${message.total_cost_usd}`);

69 }70 }

70 }71 }

72 } catch (error) {

73 // A single-shot query() throws after yielding an error result. If the

74 // failure was an error result, it still carried total_cost_usd and the

75 // branch above has already run; connection or process failures yield

76 // no result message.

77 console.error(`Session ended with an error: ${error}`);

78 }

71 ```79 ```

72 80 

73 ```python Python theme={null}81 ```python Python theme={null}

76 84 

77 85 

78 async def main():86 async def main():

87 try:

79 async for message in query(prompt="Summarize this project"):88 async for message in query(prompt="Summarize this project"):

80 if isinstance(message, ResultMessage):89 if isinstance(message, ResultMessage):

81 print(f"Total cost: ${message.total_cost_usd or 0}")90 print(f"Total cost: ${message.total_cost_usd or 0}")

91 except Exception as error:

92 # A single-shot query() raises after yielding an error result. If the

93 # failure was an error result, it still carried total_cost_usd and the

94 # branch above has already run; connection or process failures yield

95 # no result message.

96 print(f"Session ended with an error: {error}")

82 97 

83 98 

84 asyncio.run(main())99 asyncio.run(main())

110let totalInputTokens = 0;125let totalInputTokens = 0;

111let totalOutputTokens = 0;126let totalOutputTokens = 0;

112 127 

113for await (const message of query({ prompt: "Summarize this project" })) {128try {

129 for await (const message of query({ prompt: "Summarize this project" })) {

114 if (message.type === "assistant") {130 if (message.type === "assistant") {

115 const msgId = message.message.id;131 const msgId = message.message.id;

116 132 

121 totalOutputTokens += message.message.usage.output_tokens;137 totalOutputTokens += message.message.usage.output_tokens;

122 }138 }

123 }139 }

140 }

141} catch (error) {

142 // A single-shot query() throws after yielding an error result, so the

143 // totals below still reflect the steps that ran before the failure.

144 console.error(`Session ended with an error: ${error}`);

124}145}

125 146 

126console.log(`Steps: ${seenIds.size}`);147console.log(`Steps: ${seenIds.size}`);

139```typescript theme={null}160```typescript theme={null}

140import { query } from "@anthropic-ai/claude-agent-sdk";161import { query } from "@anthropic-ai/claude-agent-sdk";

141 162 

142for await (const message of query({ prompt: "Summarize this project" })) {163try {

164 for await (const message of query({ prompt: "Summarize this project" })) {

143 if (message.type !== "result") continue;165 if (message.type !== "result") continue;

144 166 

145 for (const [modelName, usage] of Object.entries(message.modelUsage)) {167 for (const [modelName, usage] of Object.entries(message.modelUsage)) {

149 console.log(` Cache read: ${usage.cacheReadInputTokens}`);171 console.log(` Cache read: ${usage.cacheReadInputTokens}`);

150 console.log(` Cache creation: ${usage.cacheCreationInputTokens}`);172 console.log(` Cache creation: ${usage.cacheCreationInputTokens}`);

151 }173 }

174 }

175} catch (error) {

176 // A single-shot query() throws after yielding an error result. If the

177 // failure was an error result, the per-model breakdown above has already

178 // printed; connection or process failures yield no result message.

179 console.error(`Session ended with an error: ${error}`);

152}180}

153```181```

154 182 

173 ];201 ];

174 202 

175 for (const prompt of prompts) {203 for (const prompt of prompts) {

204 try {

176 for await (const message of query({ prompt })) {205 for await (const message of query({ prompt })) {

177 if (message.type === "result") {206 if (message.type === "result") {

178 totalSpend += message.total_cost_usd;207 totalSpend += message.total_cost_usd;

179 console.log(`This call: $${message.total_cost_usd}`);208 console.log(`This call: $${message.total_cost_usd}`);

180 }209 }

181 }210 }

211 } catch (error) {

212 // A single-shot query() throws after yielding an error result. If the

213 // failure was an error result, this call's cost was already counted;

214 // connection or process failures yield no result message. Continue

215 // with the next prompt.

216 console.error(`Call failed: ${error}`);

217 }

182 }218 }

183 219 

184 console.log(`Total spend: $${totalSpend.toFixed(4)}`);220 console.log(`Total spend: $${totalSpend.toFixed(4)}`);

199 ]235 ]

200 236 

201 for prompt in prompts:237 for prompt in prompts:

238 try:

202 async for message in query(prompt=prompt):239 async for message in query(prompt=prompt):

203 if isinstance(message, ResultMessage):240 if isinstance(message, ResultMessage):

204 cost = message.total_cost_usd or 0241 cost = message.total_cost_usd or 0

205 total_spend += cost242 total_spend += cost

206 print(f"This call: ${cost}")243 print(f"This call: ${cost}")

244 except Exception as error:

245 # A single-shot query() raises after yielding an error result. If

246 # the failure was an error result, this call's cost was already

247 # counted; connection or process failures yield no result message.

248 # Continue with the next prompt.

249 print(f"Call failed: {error}")

207 250 

208 print(f"Total spend: ${total_spend:.4f}")251 print(f"Total spend: ${total_spend:.4f}")

209 252 

50 50 

51Чтобы использовать file checkpointing, включите его в ваших параметрах, захватите UUID checkpoint из потока ответов, затем вызовите `rewindFiles()` (TypeScript) или `rewind_files()` (Python) когда вам нужно восстановить.51Чтобы использовать file checkpointing, включите его в ваших параметрах, захватите UUID checkpoint из потока ответов, затем вызовите `rewindFiles()` (TypeScript) или `rewind_files()` (Python) когда вам нужно восстановить.

52 52 

53Следующий пример показывает полный процесс: включение checkpointing, захват UUID checkpoint и ID сеанса из потока ответов, затем возобновление сеанса позже для отмотки файлов. Каждый шаг подробно объясняется ниже.53Следующий пример показывает полный процесс: включение checkpointing, захват UUID checkpoint и ID сеанса из потока ответов, затем возобновление сеанса позже для отмотки файлов. Каждый шаг подробно объясняется ниже. Примеры в этом разделе используют приглашение "Refactor the authentication module". Запустите их в проекте, который содержит модуль аутентификации, или измените приглашение на имена файлов, которые существуют в вашем проекте, чтобы вы могли наблюдать изменения файлов и видеть, как отмотка восстанавливает их.

54 54 

55<CodeGroup>55<CodeGroup>

56 ```python Python theme={null}56 ```python Python theme={null}

197 session_id = None197 session_id = None

198 198 

199 async for message in client.receive_response():199 async for message in client.receive_response():

200 # Update checkpoint on each user message (keeps the latest)200 # Capture the first user message UUID as the checkpoint

201 if isinstance(message, UserMessage) and message.uuid:201 if isinstance(message, UserMessage) and message.uuid and checkpoint_id is None:

202 checkpoint_id = message.uuid202 checkpoint_id = message.uuid

203 # Capture session ID from the result message203 # Capture session ID from the result message

204 if isinstance(message, ResultMessage):204 if isinstance(message, ResultMessage):

210 let sessionId: string | undefined;210 let sessionId: string | undefined;

211 211 

212 for await (const message of response) {212 for await (const message of response) {

213 // Update checkpoint on each user message (keeps the latest)213 // Capture the first user message UUID as the checkpoint

214 if (message.type === "user" && message.uuid) {214 if (message.type === "user" && message.uuid && !checkpointId) {

215 checkpointId = message.uuid;215 checkpointId = message.uuid;

216 }216 }

217 // Capture session ID from any message that has it217 // Capture session ID from any message that has it

250 ```250 ```

251 </CodeGroup>251 </CodeGroup>

252 252 

253 Если вы захватили ID сеанса и UUID checkpoint, вы также можете отмотать из CLI:253 Если вы захватили ID сеанса и UUID checkpoint, вы также можете отмотать из CLI. Эта команда требует исполняемого файла `claude`, который поставляется с [установкой Claude Code](/ru/setup) и не устанавливается пакетом SDK. SDK включает checkpointing для вас, но когда вы запускаете `claude -p` напрямую, вы должны установить переменную окружения `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING`:

254 254 

255 ```bash theme={null}255 ```bash theme={null}

256 claude -p --resume <session-id> --rewind-files <checkpoint-uuid>256 CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true claude -p --resume <session-id> --rewind-files <checkpoint-uuid>

257 ```257 ```

258 

259 Флаг `--rewind-files` не отображается в выводе `claude --help`, но CLI принимает его, как показано.

258 </Step>260 </Step>

259</Steps>261</Steps>

260 262 

270 272 

271Этот паттерн сохраняет только самый последний UUID checkpoint, обновляя его перед каждым ходом агента. Если что-то пойдёт не так во время обработки, вы можете немедленно отмотать к последнему безопасному состоянию и выйти из цикла.273Этот паттерн сохраняет только самый последний UUID checkpoint, обновляя его перед каждым ходом агента. Если что-то пойдёт не так во время обработки, вы можете немедленно отмотать к последнему безопасному состоянию и выйти из цикла.

272 274 

275Перед запуском этого примера замените `your_revert_condition` (Python) или `yourRevertCondition` (TypeScript) на вашу собственную проверку, такую как обнаружение ошибок или сбой валидации; заполнитель не определён в примере.

276 

273<CodeGroup>277<CodeGroup>

274 ```python Python theme={null}278 ```python Python theme={null}

275 import asyncio279 import asyncio

752 756 

753**Решение**: Убедитесь, что `enable_file_checkpointing=True` (Python) или `enableFileCheckpointing: true` (TypeScript) был установлен в исходном сеансе, затем используйте паттерн, показанный в примерах: захватите UUID первого пользовательского сообщения, полностью завершите сеанс, затем возобновите с пустым приглашением и вызовите `rewindFiles()` один раз.757**Решение**: Убедитесь, что `enable_file_checkpointing=True` (Python) или `enableFileCheckpointing: true` (TypeScript) был установлен в исходном сеансе, затем используйте паттерн, показанный в примерах: захватите UUID первого пользовательского сообщения, полностью завершите сеанс, затем возобновите с пустым приглашением и вызовите `rewindFiles()` один раз.

754 758 

759<h3 id="file-rewinding-is-not-enabled-error">

760 Ошибка "File rewinding is not enabled"

761</h3>

762 

763Эта ошибка возникает, когда вы пытаетесь выполнить неинтерактивную отмотку без включённого checkpointing: запуск простой команды `claude -p` с `--rewind-files`, или запуск сеанса SDK, включая возобновленный, чьи параметры не включают checkpointing. SDK устанавливает переменную окружения `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING` внутренне только когда `enable_file_checkpointing` (Python) или `enableFileCheckpointing` (TypeScript) включены в сеансе, выполняющем отмотку; простой CLI никогда её не устанавливает.

764 

765**Решение**: Для простого CLI установите переменную окружения при запуске команды:

766 

767```bash theme={null}

768CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true claude -p --resume <session-id> --rewind-files <checkpoint-uuid>

769```

770 

771Для SDK установите `enable_file_checkpointing=True` (Python) или `enableFileCheckpointing: true` (TypeScript) в возобновленном сеансе, как это делается в примерах на этой странице.

772 

755<h3 id="processtransport-is-not-ready-for-writing-error">773<h3 id="processtransport-is-not-ready-for-writing-error">

756 Ошибка "ProcessTransport is not ready for writing"774 Ошибка "ProcessTransport is not ready for writing"

757</h3>775</h3>

28 </Step>28 </Step>

29 29 

30 <Step title="Правила ask">30 <Step title="Правила ask">

31 Проверьте правила `ask` из [settings.json](/ru/settings#permission-settings). Если правило ask совпадает, вызов передаётся вашему callback [`canUseTool`](/ru/agent-sdk/user-input) для подтверждения, даже в режиме `bypassPermissions`. В режиме `dontAsk` совпадающее правило ask отклоняется вместо этого, потому что этот режим никогда не запрашивает подтверждение.31 Проверьте правила `ask` из [settings.json](/ru/settings#permission-settings). Если правило ask совпадает, вызов передаётся вашему callback [`canUseTool`](/ru/agent-sdk/user-input) для подтверждения, даже в режиме `bypassPermissions`.

32 

33 Инструменты, которые требуют взаимодействия с пользователем, ведут себя так же: `AskUserQuestion` и MCP инструменты, сервер которых устанавливает [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), всегда передаются callback, даже когда совпадает правило allow. В режиме `dontAsk` оба случая отклоняются вместо этого, потому что этот режим никогда не запрашивает подтверждение. {/* min-version: 2.1.199 */}Аннотация MCP требует Claude Code v2.1.199 или более поздней версии.

32 </Step>34 </Step>

33 35 

34 <Step title="Режим разрешений">36 <Step title="Режим разрешений">

46 48 

47<img src="https://mintcdn.com/claude-code/jYgs7qigNjO1Badj/images/agent-sdk/permissions-flow.svg?fit=max&auto=format&n=jYgs7qigNjO1Badj&q=85&s=c771ad9085b1277d3708027a49c744bc" alt="Диаграмма потока оценки разрешений из шести шагов, соответствующая шагам выше: запрос инструмента проходит через hooks, правила deny, правила ask, режим разрешений, правила allow и canUseTool. Hooks, правила deny и canUseTool могут маршрутизировать вниз к Blocked; обход режима разрешений, правила allow и canUseTool могут маршрутизировать вверх к Execute; правила ask маршрутизируют к canUseTool." width="1180" height="260" data-path="images/agent-sdk/permissions-flow.svg" />49<img src="https://mintcdn.com/claude-code/jYgs7qigNjO1Badj/images/agent-sdk/permissions-flow.svg?fit=max&auto=format&n=jYgs7qigNjO1Badj&q=85&s=c771ad9085b1277d3708027a49c744bc" alt="Диаграмма потока оценки разрешений из шести шагов, соответствующая шагам выше: запрос инструмента проходит через hooks, правила deny, правила ask, режим разрешений, правила allow и canUseTool. Hooks, правила deny и canUseTool могут маршрутизировать вниз к Blocked; обход режима разрешений, правила allow и canUseTool могут маршрутизировать вверх к Execute; правила ask маршрутизируют к canUseTool." width="1180" height="260" data-path="images/agent-sdk/permissions-flow.svg" />

48 50 

51Начиная с версии v2.1.198, если вы передаёте callback `canUseTool`, который эта последовательность оценки никогда не может достичь, TypeScript SDK выдаёт предупреждение процесса Node.js один раз при построении запроса. Код предупреждения — `CLAUDE_SDK_CAN_USE_TOOL_SHADOWED`. Две конфигурации вызывают его:

52 

53* `permissionMode: 'bypassPermissions'`, который автоматически одобряет каждый вызов, достигающий шага режима разрешений

54* Каждая запись `allowedTools` с простым названием, такая как `"Read"`, которая автоматически одобряет весь этот инструмент перед консультацией callback

55 

56Записи со спецификатором, такие как `Bash(ls *)`, и режим `acceptEdits` не вызывают его, и правила allow из файлов настроек не видны для проверки.

57 

58Слушайте с помощью `process.on('warning', ...)` и сопоставьте код для логирования или подавления его. Чтобы контролировать каждый вызов инструмента независимо от режима и правил, используйте вместо этого [hook `PreToolUse`](/ru/agent-sdk/hooks).

59 

49На этой странице основное внимание уделяется **правилам allow и deny** и **режимам разрешений**. Для других шагов:60На этой странице основное внимание уделяется **правилам allow и deny** и **режимам разрешений**. Для других шагов:

50 61 

51* **Hooks:** запустите пользовательский код для разрешения, отклонения или изменения запросов инструментов. См. [Управление выполнением с помощью hooks](/ru/agent-sdk/hooks).62* **Hooks:** запустите пользовательский код для разрешения, отклонения или изменения запросов инструментов. См. [Управление выполнением с помощью hooks](/ru/agent-sdk/hooks).

67Правила allow принимают глобы имён инструментов только после буквального префикса `mcp__<server>__`. Сегмент сервера должен быть свободен от глобов, чтобы правило называло конкретный сервер, который вы настроили: `mcp__puppeteer__*` соответствует каждому инструменту с сервера `puppeteer`, и `mcp__github__get_*` соответствует его инструментам `get_`. Неякорированная запись, такая как `allowed_tools=["*"]` или `allowed_tools=["mcp__*"]`, игнорируется с предупреждением при запуске и не одобряет ничего автоматически.78Правила allow принимают глобы имён инструментов только после буквального префикса `mcp__<server>__`. Сегмент сервера должен быть свободен от глобов, чтобы правило называло конкретный сервер, который вы настроили: `mcp__puppeteer__*` соответствует каждому инструменту с сервера `puppeteer`, и `mcp__github__get_*` соответствует его инструментам `get_`. Неякорированная запись, такая как `allowed_tools=["*"]` или `allowed_tools=["mcp__*"]`, игнорируется с предупреждением при запуске и не одобряет ничего автоматически.

68 79 

69<Warning>80<Warning>

70 **Автоматически одобренные инструменты никогда не достигают `canUseTool`.** Вызов инструмента, одобренный на любом более раннем этапе, с помощью `acceptEdits` или `bypassPermissions`, или по правилу allow, пропускает ваш обратный вызов `canUseTool`, поэтому проверки разрешений, которые вы там поместили, молча обходятся для этого инструмента. Охват зависит от формы записи: простое имя, такое как `Read` или `mcp__github__get_issue`, автоматически одобряет каждый вызов этого инструмента, в то время как правило с областью действия, такое как `Bash(ls *)`, автоматически одобряет только совпадающие вызовы, и другие вызовы `Bash` всё ещё переходят к обратному вызову. Для проверок, которые должны выполняться при каждом вызове инструмента, используйте [`PreToolUse` hook](/ru/agent-sdk/hooks): hooks выполняются перед каждым другим шагом, и отказ hook применяется даже в режиме `bypassPermissions`.81 **Автоматически одобренные инструменты никогда не достигают `canUseTool`.** Вызов инструмента, одобренный на любом более раннем этапе, с помощью `acceptEdits` или `bypassPermissions`, или по правилу allow, пропускает ваш обратный вызов `canUseTool`, поэтому проверки разрешений, которые вы там поместили, молча обходятся для этого инструмента. Исключением являются инструменты, требующие взаимодействия с пользователем, `AskUserQuestion` и инструменты MCP, отмеченные с помощью [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), которые достигают обратного вызова даже при совпадении правила allow. Охват зависит от формы записи: простое имя, такое как `Read` или `mcp__github__get_issue`, автоматически одобряет каждый вызов этого инструмента, в то время как правило с областью действия, такое как `Bash(ls *)`, автоматически одобряет только совпадающие вызовы, и другие вызовы `Bash` всё ещё переходят к обратному вызову. Для проверок, которые должны выполняться при каждом вызове инструмента, используйте [`PreToolUse` hook](/ru/agent-sdk/hooks): hooks выполняются перед каждым другим шагом, и отказ hook применяется даже в режиме `bypassPermissions`.

71</Warning>82</Warning>

72 83 

73Для заблокированного агента объедините `allowedTools` с `permissionMode: "dontAsk"`. Указанные инструменты одобрены; всё остальное отклоняется полностью вместо запроса:84Для заблокированного агента объедините `allowedTools` с `permissionMode: "dontAsk"`. Указанные инструменты одобрены; всё остальное отклоняется полностью вместо запроса:

958```958```

959 959 

960* `API_TIMEOUT_MS`: тайм-аут для каждого запроса на клиенте Anthropic в миллисекундах. По умолчанию `600000`. Применяется к основному циклу и всем подагентам.960* `API_TIMEOUT_MS`: тайм-аут для каждого запроса на клиенте Anthropic в миллисекундах. По умолчанию `600000`. Применяется к основному циклу и всем подагентам.

961* `CLAUDE_CODE_MAX_RETRIES`: максимальное количество повторных попыток API. По умолчанию `10`, ограничено `15`. Каждая повторная попытка получает свое собственное окно `API_TIMEOUT_MS`, поэтому наихудшее время стены примерно `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` плюс отступ. Для автоматических запусков, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG=1` для повторной попытки ошибок емкости бесконечно.961* `CLAUDE_CODE_MAX_RETRIES`: максимальное количество повторных попыток API. По умолчанию `10`, ограничено `15`. Каждая повторная попытка получает свое собственное окно `API_TIMEOUT_MS`, поэтому наихудшее время стены примерно `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` плюс отступ. Для автоматических запусков, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG=1`: он повторяет ошибки емкости бесконечно, и {/* min-version: 2.1.199 */}начиная с Claude Code v2.1.199 повышает значение по умолчанию для других переходных ошибок до `300` и удаляет ограничение на эту переменную.

962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: сторожевой таймер зависания для подагентов, запущенных с `run_in_background`. По умолчанию `600000`. Сбрасывается при каждом событии потока; при зависании он прерывает подагента, отмечает задачу как неудачную и выводит ошибку родителю с любым частичным результатом. Не применяется к синхронным подагентам.962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: сторожевой таймер зависания для подагентов, запущенных с `run_in_background`. По умолчанию `600000`. Сбрасывается при каждом событии потока; при зависании он прерывает подагента, отмечает задачу как неудачную и выводит ошибку родителю с любым частичным результатом. Не применяется к синхронным подагентам.

963* `CLAUDE_ENABLE_STREAM_WATCHDOG` с `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: прерывает запрос, когда заголовки прибыли, но тело ответа перестает потоковать. Сторожевой таймер включен по умолчанию для всех поставщиков; установите `CLAUDE_ENABLE_STREAM_WATCHDOG=0` для отключения. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` по умолчанию `300000` и зажимается до этого минимума. Прерванный запрос проходит через обычный путь повторной попытки.963* `CLAUDE_ENABLE_STREAM_WATCHDOG` с `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: прерывает запрос, когда заголовки прибыли, но тело ответа перестает потоковать. Сторожевой таймер включен по умолчанию для всех поставщиков; установите `CLAUDE_ENABLE_STREAM_WATCHDOG=0` для отключения. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` по умолчанию `300000` и зажимается до этого минимума. Прерванный запрос проходит через обычный путь повторной попытки.

964 964 

7> Определяйте и вызывайте подагентов для изоляции контекста, параллельного выполнения задач и применения специализированных инструкций в приложениях Claude Agent SDK.7> Определяйте и вызывайте подагентов для изоляции контекста, параллельного выполнения задач и применения специализированных инструкций в приложениях Claude Agent SDK.

8 8 

9Подагенты — это отдельные экземпляры агентов, которые ваш основной агент может создавать для обработки сосредоточенных подзадач.9Подагенты — это отдельные экземпляры агентов, которые ваш основной агент может создавать для обработки сосредоточенных подзадач.

10Используйте подагентов для изоляции контекста при выполнении сосредоточенных подзадач, параллельного запуска нескольких анализов и применения специализированных инструкций без перегрузки основного промпта агента.10Используйте подагентов для изоляции контекста, параллельного запуска нескольких анализов и применения специализированных инструкций без перегрузки основного промпта агента.

11 11 

12В этом руководстве объясняется, как определять и использовать подагентов в SDK с помощью параметра `agents`.12В этом руководстве объясняется, как определять и использовать подагентов в SDK с помощью параметра `agents`.

13 13 

17 17 

18Вы можете создавать подагентов тремя способами:18Вы можете создавать подагентов тремя способами:

19 19 

20* **Программно**: используйте параметр `agents` в параметрах `query()` ([TypeScript](/ru/agent-sdk/typescript#agentdefinition), [Python](/ru/agent-sdk/python#agentdefinition))20* **Программно**: используйте параметр `agents` в параметрах `query()`. См. справочники [TypeScript](/ru/agent-sdk/typescript#agentdefinition) и [Python](/ru/agent-sdk/python#agentdefinition)

21* **На основе файловой системы**: определяйте агентов как файлы markdown в директориях `.claude/agents/` (см. [определение подагентов как файлов](/ru/sub-agents))21* **На основе файловой системы**: определяйте агентов как файлы markdown в директориях `.claude/agents/`. См. [определение подагентов как файлов](/ru/sub-agents)

22* **Встроенный универсальный**: Claude может вызывать встроенного подагента `general-purpose` в любое время через инструмент Agent без необходимости что-либо определять22* **Встроенный универсальный**: Claude может вызывать встроенного подагента `general-purpose` в любое время через инструмент Agent без необходимости что-либо определять

23 23 

24Это руководство сосредоточено на программном подходе, который рекомендуется для приложений SDK.24Это руководство сосредоточено на программном подходе, который рекомендуется для приложений SDK.

25 25 

26Когда вы определяете подагентов, Claude определяет, следует ли их вызывать, на основе поля `description` каждого подагента. Напишите четкие описания, которые объясняют, когда следует использовать подагента, и Claude автоматически делегирует соответствующие задачи. Вы также можете явно запросить подагента по имени в своем промпте (например, "Используйте агента code-reviewer для...").26Когда вы определяете подагентов, Claude определяет, следует ли их вызывать, на основе поля `description` каждого подагента. Напишите четкие описания, которые объясняют, когда следует использовать подагента, и Claude автоматически делегирует соответствующие задачи. Вы также можете явно запросить подагента по имени в своем промпте, например "Используйте агента code-reviewer для...".

27 27 

28<h2 id="benefits-of-using-subagents">28<h2 id="benefits-of-using-subagents">

29 Преимущества использования подагентов29 Преимущества использования подагентов

61 61 

62**Пример:** подагент `doc-reviewer` может иметь доступ только к инструментам Read и Grep, обеспечивая анализ, но никогда случайно не модифицируя файлы документации.62**Пример:** подагент `doc-reviewer` может иметь доступ только к инструментам Read и Grep, обеспечивая анализ, но никогда случайно не модифицируя файлы документации.

63 63 

64<h2 id="creating-subagents">64<h2 id="create-subagents">

65 Создание подагентов65 Создание подагентов

66</h2>66</h2>

67 67 

69 Программное определение (рекомендуется)69 Программное определение (рекомендуется)

70</h3>70</h3>

71 71 

72Определяйте подагентов непосредственно в коде, используя параметр `agents`. Этот пример создает двух подагентов: рецензента кода с доступом только для чтения и средство запуска тестов, которое может выполнять команды. Claude вызывает подагентов через инструмент `Agent`, поэтому включите `Agent` в `allowedTools` для автоматического одобрения вызовов подагентов без запроса разрешения.72Определяйте подагентов непосредственно в коде, используя параметр `agents`. Claude вызывает подагентов через инструмент `Agent`, поэтому включите `Agent` в `allowedTools` для автоматического одобрения вызовов подагентов без запроса разрешения.

73 73 

74Большинство примеров на этой странице выводят только окончательный результат. Чтобы подтвердить, что Claude делегировал работу подагенту, а не ответил напрямую, см. раздел [Обнаружение вызова подагента](#detecting-subagent-invocation).74Большинство примеров на этой странице выводят только окончательный результат. Чтобы подтвердить, что Claude делегировал работу подагенту, а не ответил напрямую, см. раздел [Обнаружение вызова подагента](#detect-subagent-invocation).

75 

76Этот пример создает двух подагентов: рецензента кода с доступом только для чтения и средство запуска тестов, которое может выполнять команды.

75 77 

76<CodeGroup>78<CodeGroup>

77 ```python Python theme={null}79 ```python Python theme={null}

197 199 

198В Python SDK многословные имена полей, такие как `disallowedTools` и `mcpServers`, сохраняют написание camelCase для соответствия формату передачи, а не следуют соглашению Python snake\_case. Подробности см. в [справочнике `AgentDefinition`](/ru/agent-sdk/python#agentdefinition).200В Python SDK многословные имена полей, такие как `disallowedTools` и `mcpServers`, сохраняют написание camelCase для соответствия формату передачи, а не следуют соглашению Python snake\_case. Подробности см. в [справочнике `AgentDefinition`](/ru/agent-sdk/python#agentdefinition).

199 201 

202Два поведения подагентов изменились в Claude Code v2.1.198:

203 

204* Подагенты работают в фоновом режиме по умолчанию. Вызов инструмента Agent, который опускает входной параметр [`run_in_background`](/ru/agent-sdk/typescript), запускает фоновый подагент, и Claude устанавливает `run_in_background: false`, когда ему нужен результат перед продолжением. До версии v2.1.198 опускание `run_in_background` запускало подагента синхронно. Установите поле `background` в `true`, чтобы принудительно включить фоновое выполнение для конкретного агента независимо от того, что запрашивает Claude.

205* Подагент наследует конфигурацию расширенного мышления основной сессии. В более ранних версиях расширенное мышление отключено внутри подагентов независимо от параметра основной сессии.

206 

200<Note>207<Note>

201 {/* min-version: 2.1.172 */}Начиная с Claude Code v2.1.172, подагенты могут создавать своих собственных подагентов. Подагент на пять уровней ниже основного агента не может создавать дополнительных подагентов, независимо от того, работает ли он в переднем плане или в фоновом режиме. Чтобы предотвратить создание подагентом других подагентов, опустите `Agent` из его массива `tools` или добавьте его в `disallowedTools`. Полные правила глубины см. в разделе [вложенные подагенты](/ru/sub-agents#spawn-nested-subagents).208 {/* min-version: 2.1.172 */}Начиная с Claude Code v2.1.172, подагенты могут создавать своих собственных подагентов. Подагент на пять уровней ниже основного агента не может создавать дополнительных подагентов, независимо от того, работает ли он в переднем плане или в фоновом режиме. Чтобы предотвратить создание подагентом других подагентов, опустите `Agent` из его массива `tools` или добавьте его в `disallowedTools`. Полные правила глубины см. в разделе [вложенные подагенты](/ru/sub-agents#spawn-nested-subagents).

202</Note>209</Note>

227 Родитель получает финальное сообщение подагента дословно как результат инструмента Agent, но может суммировать его в своем собственном ответе. Чтобы сохранить выходные данные подагента дословно в ответе, обращенном к пользователю, включите инструкцию об этом в промпт или опцию `systemPrompt`, которую вы передаете основному вызову `query()`.234 Родитель получает финальное сообщение подагента дословно как результат инструмента Agent, но может суммировать его в своем собственном ответе. Чтобы сохранить выходные данные подагента дословно в ответе, обращенном к пользователю, включите инструкцию об этом в промпт или опцию `systemPrompt`, которую вы передаете основному вызову `query()`.

228</Note>235</Note>

229 236 

230<h2 id="invoking-subagents">237{/* min-version: 2.1.199 */}Начиная с Claude Code v2.1.199, ошибка API, которая завершает работу подагента раньше времени, такая как ограничение скорости, никогда не доставляется как его результат. Если подагент уже произвел выходные данные, инструмент Agent возвращает эти частичные выходные данные с примечанием о том, что подагент не завершил работу; в противном случае результат инструмента — это сообщение об ошибке, `Agent terminated early due to an API error`, за которым следует деталь ошибки. См. [API errors in subagents](/ru/sub-agents#api-errors-in-subagents) для поведения на переднем плане и в фоновом режиме.

238 

239<h2 id="invoke-subagents">

231 Вызов подагентов240 Вызов подагентов

232</h2>241</h2>

233 242 

329 ```338 ```

330</CodeGroup>339</CodeGroup>

331 340 

332<h2 id="detecting-subagent-invocation">341<h2 id="detect-subagent-invocation">

333 Обнаружение вызова подагента342 Обнаружение вызова подагента

334</h2>343</h2>

335 344 

336Подагенты вызываются через инструмент Agent. Чтобы обнаружить, когда вызывается подагент, проверьте блоки `tool_use`, где `name` — это `"Agent"`. Сообщения из контекста подагента включают поле `parent_tool_use_id`.345Claude вызывает подагентов через инструмент Agent. Чтобы обнаружить, когда вызывается подагент, проверьте блоки `tool_use`, где `name` — это `"Agent"`. Сообщения из контекста подагента включают поле `parent_tool_use_id`.

337 346 

338<Note>347<Note>

339 Имя инструмента было переименовано с `"Task"` на `"Agent"` в Claude Code v2.1.63. Текущие выпуски SDK выдают `"Agent"` в блоках `tool_use`, но все еще используют `"Task"` в списке инструментов `system:init` и в `result.permission_denials[].tool_name`. Проверка обоих значений в `block.name` обеспечивает совместимость между версиями SDK.348 Имя инструмента было переименовано с `"Task"` на `"Agent"` в Claude Code v2.1.63. Текущие выпуски SDK выдают `"Agent"` в блоках `tool_use`, но все еще используют `"Task"` в списке инструментов `system:init` и в `result.permission_denials[].tool_name`. Проверка обоих значений в `block.name` обеспечивает совместимость между версиями SDK.

422 ```431 ```

423</CodeGroup>432</CodeGroup>

424 433 

425<h2 id="resuming-subagents">434<h2 id="resume-subagents">

426 Возобновление подагентов435 Возобновление подагентов

427</h2>436</h2>

428 437 

429Подагенты можно возобновить, чтобы продолжить с того места, где они остановились. Возобновленные подагенты сохраняют полную историю беседы, включая все предыдущие вызовы инструментов, результаты и рассуждения. Подагент продолжает работу ровно с того места, где он остановился, а не начинает заново.438Вы можете возобновить подагента, чтобы продолжить с того места, где он остановился, а не начинать заново. Возобновленный подагент сохраняет полную историю беседы, включая все предыдущие вызовы инструментов, результаты и рассуждения.

430 439 

431Когда подагент завершается, результат инструмента Agent включает текстовый блок, содержащий `agentId: <id>`. Встроенные агенты [`Explore` и `Plan`](/ru/sub-agents#built-in-subagents) работают в один проход и не возвращают `agentId`, поэтому используйте пользовательского агента или `general-purpose`, когда вам нужно возобновить. Чтобы программно возобновить подагента:440Когда подагент завершается, результат инструмента Agent включает текстовый блок, содержащий `agentId: <id>`. Встроенные агенты [`Explore` и `Plan`](/ru/sub-agents#built-in-subagents) работают в один проход и не возвращают `agentId`, поэтому используйте пользовательского агента или `general-purpose`, когда вам нужно возобновить. Чтобы программно возобновить подагента:

432 441 

568 577 

569* **Компактирование основной беседы**: когда основная беседа компактируется, стенограммы подагентов не затрагиваются. Они хранятся в отдельных файлах.578* **Компактирование основной беседы**: когда основная беседа компактируется, стенограммы подагентов не затрагиваются. Они хранятся в отдельных файлах.

570* **Сохранение сессии**: стенограммы подагентов сохраняются в пределах их сессии. Вы можете возобновить подагента после перезагрузки Claude Code, возобновив ту же сессию.579* **Сохранение сессии**: стенограммы подагентов сохраняются в пределах их сессии. Вы можете возобновить подагента после перезагрузки Claude Code, возобновив ту же сессию.

571* **Автоматическая очистка**: стенограммы очищаются на основе параметра `cleanupPeriodDays` (по умолчанию: 30 дней).580* **Автоматическая очистка**: стенограммы очищаются на основе параметра `cleanupPeriodDays`, который по умолчанию составляет 30 дней.

572 581 

573<h2 id="tool-restrictions-1">582<h2 id="tool-restrictions-1">

574 Ограничения инструментов583 Ограничения инструментов

662 671 

663Если Claude выполняет задачи напрямую вместо делегирования вашему подагенту:672Если Claude выполняет задачи напрямую вместо делегирования вашему подагенту:

664 673 

6651. **Проверьте, что вызовы Agent одобрены**: включите `Agent` в `allowedTools` для автоматического одобрения вызовов подагента. Без этого вызовы Agent переходят к вашему обратному вызову `canUseTool` или в режиме `dontAsk` отклоняются674* **Проверьте, что вызовы Agent одобрены**: включите `Agent` в `allowedTools` для автоматического одобрения вызовов подагента. Без этого вызовы Agent переходят к вашему обратному вызову `canUseTool` или в режиме `dontAsk` отклоняются

6662. **Используйте явное указание**: упомяните подагента по имени в своем промпте (например, "Use the code-reviewer agent to...")675* **Используйте явное указание**: упомяните подагента по имени в своем промпте, например "Use the code-reviewer agent to..."

6673. **Напишите четкое описание**: объясните ровно, когда следует использовать подагента, чтобы Claude мог правильно сопоставить задачи676* **Напишите четкое описание**: объясните ровно, когда следует использовать подагента, чтобы Claude мог правильно сопоставить задачи

668 677 

669<h3 id="filesystem-based-agents-not-loading">678<h3 id="filesystem-based-agents-not-loading">

670 Агенты на основе файловой системы не загружаются679 Агенты на основе файловой системы не загружаются

671</h3>680</h3>

672 681 

673Агенты, определенные в `.claude/agents/`, загружаются только при запуске. Если вы создаете новый файл агента во время работы Claude Code, перезагрузите сессию, чтобы загрузить его.682Claude Code отслеживает `~/.claude/agents/` и `.claude/agents/` и подхватывает новый или отредактированный файл агента в течение нескольких секунд без необходимости перезагрузки. Если определение никогда не появляется, проработайте эти причины:

683 

684* **Новая директория `agents`**: наблюдатель охватывает только директории, которые существовали при запуске сессии, поэтому первый файл в новой директории требует перезагрузки сессии. Это наиболее частая причина.

685* **Неверный frontmatter или дублирующееся имя `name`**: проверьте YAML файла и то, использует ли существующий агент уже это имя `name`.

686* **`--disable-slash-commands`**: сессии, запущенные с этим флагом, не отслеживают эти директории и всегда требуют перезагрузки для загрузки новых файлов.

687* **Программный агент с тем же именем**: `agents`, переданные в `query()`, переопределяют агента файловой системы с тем же именем.

688 

689Для формата файла см. [как писать файлы подагентов](/ru/sub-agents#write-subagent-files).

674 690 

675<h3 id="windows-long-prompt-failures">691<h3 id="long-prompt-failures-on-windows">

676 Windows: сбои при длинных промптах692 Сбои при длинных промптах в Windows

677</h3>693</h3>

678 694 

679В Windows подагенты с очень длинными промптами могут не работать из-за ограничений длины командной строки (8191 символов). Держите промпты краткими или используйте агентов на основе файловой системы для сложных инструкций.695В Windows подагенты с очень длинными промптами могут не работать из-за ограничения длины командной строки в 8191 символов. Держите промпты краткими или используйте агентов на основе файловой системы для сложных инструкций.

680 696 

681<h2 id="related-documentation">697<h2 id="related-documentation">

682 Связанная документация698 Связанная документация

9Отслеживание задач предоставляет структурированный способ управления задачами и отображения прогресса пользователям. Claude Agent SDK включает встроенную функциональность задач, которая помогает организовать сложные рабочие процессы и держать пользователей в курсе хода выполнения задач.9Отслеживание задач предоставляет структурированный способ управления задачами и отображения прогресса пользователям. Claude Agent SDK включает встроенную функциональность задач, которая помогает организовать сложные рабочие процессы и держать пользователей в курсе хода выполнения задач.

10 10 

11<Note>11<Note>

12 Начиная с TypeScript Agent SDK 0.3.142 и Claude Code v2.1.142, сеансы используют структурированные инструменты Task `TaskCreate`, `TaskUpdate`, `TaskGet` и `TaskList` вместо `TodoWrite`. Смотрите [Миграция на инструменты Task](#migrate-to-task-tools) для информации о том, как отслеживать изменения кода. Примеры на этой странице устанавливают `CLAUDE_CODE_ENABLE_TASKS=0` для продолжения отображения `TodoWrite` для сеансов, которые еще не перешли на новую версию.12 Начиная с TypeScript Agent SDK 0.3.142 и Claude Code v2.1.142, сеансы используют структурированные инструменты Task `TaskCreate`, `TaskUpdate`, `TaskGet` и `TaskList` вместо `TodoWrite`. Python SDK получает это изменение из Claude Code CLI, который он запускает, а не из версии пакета Python: переключение применяется после того, как этот CLI — копия, включенная в пакет pip, или та, на которую вы указываете с помощью `cli_path` — имеет версию v2.1.142 или позже. Смотрите [Миграция на инструменты Task](#migrate-to-task-tools) для информации о том, как отслеживать изменения кода. Примеры на этой странице устанавливают `CLAUDE_CODE_ENABLE_TASKS=0` для продолжения отображения `TodoWrite` для сеансов, которые еще не перешли на новую версию.

13</Note>13</Note>

14 14 

15<h3 id="todo-lifecycle">15<h3 id="todo-lifecycle">

27 Когда используются задачи27 Когда используются задачи

28</h3>28</h3>

29 29 

30SDK автоматически создает задачи для:30SDK создает задачи для большинства многошаговых работ, таких как:

31 31 

32* **Сложных многошаговых задач**, требующих 3 или более отдельных действий32* **Сложных многошаговых задач**, требующих 3 или более отдельных действий

33* **Списков задач, предоставленных пользователем**, когда упоминаются несколько элементов33* **Списков задач, предоставленных пользователем**, когда упоминаются несколько элементов

34* **Нетривиальных операций**, которые выигрывают от отслеживания прогресса34* **Нетривиальных операций**, которые выигрывают от отслеживания прогресса

35* **Явных запросов**, когда пользователи просят организовать задачи35* **Явных запросов**, когда пользователи просят организовать задачи

36 36 

37Это может пропустить задачи для очень коротких или одношаговых запросов.

38 

37<h2 id="examples">39<h2 id="examples">

38 Примеры40 Примеры

39</h2>41</h2>

40 42 

43Перед запуском этих примеров установите Claude Agent SDK, следуя [краткому руководству](/ru/agent-sdk/quickstart).

44 

45Каждый пример выполняется до завершения агентом и выдачи его финального сообщения результата. Если сеанс сначала достигает лимита ходов, то сообщение результата имеет подтип `error_max_turns`. Проверьте `subtype`, чтобы обнаружить это завершение.

46 

47Эти примеры используют однократные вызовы `query()`. После выдачи результата `error_max_turns`, `query()` выбрасывает ошибку, которая включает `Reached maximum number of turns`. Каждый пример оборачивает свой цикл в блок try для чистого выхода при возникновении этого события.

48 

49См. [Обработка результата](/ru/agent-sdk/agent-loop#handle-the-result) для получения информации о подтипах результатов.

50 

41<h3 id="monitoring-todo-changes">51<h3 id="monitoring-todo-changes">

42 Мониторинг изменений задач52 Мониторинг изменений задач

43</h3>53</h3>

46 ```typescript TypeScript theme={null}56 ```typescript TypeScript theme={null}

47 import { query } from "@anthropic-ai/claude-agent-sdk";57 import { query } from "@anthropic-ai/claude-agent-sdk";

48 58 

59 try {

49 for await (const message of query({60 for await (const message of query({

50 prompt: "Optimize my React app performance and track progress with todos",61 prompt: "Optimize my React app performance and track progress with todos",

51 // Re-enable TodoWrite, which this example monitors. Without it, the SDK uses62 // Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

68 }79 }

69 }80 }

70 }81 }

82 } catch (error) {

83 // A single-shot query() throws after yielding an error result,

84 // such as when the maxTurns limit is hit.

85 console.log(`Session ended with an error: ${error}`);

86 }

71 ```87 ```

72 88 

73 ```python Python theme={null}89 ```python Python theme={null}

90 import asyncio

91 

74 from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ToolUseBlock92 from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ToolUseBlock

75 93 

94 

95 async def main():

96 try:

76 async for message in query(97 async for message in query(

77 prompt="Optimize my React app performance and track progress with todos",98 prompt="Optimize my React app performance and track progress with todos",

78 # Re-enable TodoWrite, which this example monitors. Without it, the SDK uses99 # Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

95 else "❌"116 else "❌"

96 )117 )

97 print(f"{i + 1}. {status} {todo['content']}")118 print(f"{i + 1}. {status} {todo['content']}")

119 except Exception as error:

120 # A single-shot query() raises after yielding an error result,

121 # such as when the max_turns limit is hit.

122 print(f"Session ended with an error: {error}")

123 

124 

125 asyncio.run(main())

98 ```126 ```

99</CodeGroup>127</CodeGroup>

100 128 

128 }156 }

129 157 

130 async trackQuery(prompt: string) {158 async trackQuery(prompt: string) {

159 try {

131 for await (const message of query({160 for await (const message of query({

132 prompt,161 prompt,

133 // Re-enable TodoWrite, which this tracker watches for.162 // Re-enable TodoWrite, which this tracker watches for.

142 }171 }

143 }172 }

144 }173 }

174 } catch (error) {

175 // A single-shot query() throws after yielding an error result,

176 // such as when the maxTurns limit is hit.

177 console.log(`Session ended with an error: ${error}`);

178 }

145 }179 }

146 }180 }

147 181 

151 ```185 ```

152 186 

153 ```python Python theme={null}187 ```python Python theme={null}

188 import asyncio

189 

154 from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ToolUseBlock190 from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ToolUseBlock

155 from typing import List, Dict191 from typing import List, Dict

156 192 

186 print(f"{i + 1}. {icon} {text}")222 print(f"{i + 1}. {icon} {text}")

187 223 

188 async def track_query(self, prompt: str):224 async def track_query(self, prompt: str):

225 try:

189 async for message in query(226 async for message in query(

190 prompt=prompt,227 prompt=prompt,

191 # Re-enable TodoWrite, which this tracker watches for.228 # Re-enable TodoWrite, which this tracker watches for.

196 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":233 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":

197 self.todos = block.input["todos"]234 self.todos = block.input["todos"]

198 self.display_progress()235 self.display_progress()

236 except Exception as error:

237 # A single-shot query() raises after yielding an error result,

238 # such as when the max_turns limit is hit.

239 print(f"Session ended with an error: {error}")

199 240 

200 241 

201 # Usage242 # Usage

243 async def main():

202 tracker = TodoTracker()244 tracker = TodoTracker()

203 await tracker.track_query("Build a complete authentication system with todos")245 await tracker.track_query("Build a complete authentication system with todos")

246 

247 

248 asyncio.run(main())

204 ```249 ```

205</CodeGroup>250</CodeGroup>

206 251 

217| Форма элемента: `{ content, status, activeForm }` | Ввод `TaskCreate`: `{ subject, description, activeForm?, metadata? }`. Ввод `TaskUpdate`: `{ taskId, status?, subject?, description?, activeForm?, addBlocks?, addBlockedBy?, owner?, metadata? }`. `status` это `"pending"`, `"in_progress"` или `"completed"`; установите `status: "deleted"` для удаления |262| Форма элемента: `{ content, status, activeForm }` | Ввод `TaskCreate`: `{ subject, description, activeForm?, metadata? }`. Ввод `TaskUpdate`: `{ taskId, status?, subject?, description?, activeForm?, addBlocks?, addBlockedBy?, owner?, metadata? }`. `status` это `"pending"`, `"in_progress"` или `"completed"`; установите `status: "deleted"` для удаления |

218| Отобразить `block.input.todos` напрямую | Накопить элементы между вызовами или прочитать снимок из результата инструмента `TaskList` |263| Отобразить `block.input.todos` напрямую | Накопить элементы между вызовами или прочитать снимок из результата инструмента `TaskList` |

219 264 

220Назначенный ID задачи отсутствует во вводе `TaskCreate`. Он возвращается в соответствующем `tool_result` как `{ task: { id, subject } }`, поэтому захватите его из блока результата, чтобы индексировать вашу карту. Следующий пример показывает минимальное изменение цикла [Мониторинг изменений задач](#monitoring-todo-changes). Для отображения полного списка смотрите результат инструмента `TaskList` в потоке или накопите результаты `TaskCreate` и вводы `TaskUpdate` в карту.265Назначенный ID задачи отсутствует во вводе `TaskCreate`. Он возвращается в соответствующем `tool_result` как `{ task: { id, subject } }`, поэтому захватите его из блока результата, чтобы индексировать вашу карту. Следующий пример показывает минимальное изменение цикла [Мониторинг изменений задач](#monitoring-todo-changes). Он читает только вводы `tool_use` и пропускает захват ID из блоков `tool_result`. Для отображения полного списка смотрите результат инструмента `TaskList` в потоке или накопите результаты `TaskCreate` и вводы `TaskUpdate` в карту.

221 266 

222Потоковый ввод `tool_use` — это необработанная форма, которую выдала модель. Claude Code исправляет некоторые близкие, но неправильные имена ключей перед выполнением, сопоставляя `id` или `task_id` с `taskId` и `active_form` с `activeForm`, но это исправление не отражается в потоке. Читайте поля ввода `TaskUpdate` защитно, как это делают примеры ниже, а не предполагайте, что каноническое имя всегда присутствует.267Потоковый ввод `tool_use` — это необработанная форма, которую выдала модель. Claude Code исправляет некоторые близкие, но неправильные имена ключей перед выполнением, сопоставляя `id` или `task_id` с `taskId` и `active_form` с `activeForm`, но это исправление не отражается в потоке. Читайте поля ввода `TaskUpdate` защитно, как это делают примеры ниже, а не предполагайте, что каноническое имя всегда присутствует.

223 268 

225 ```typescript TypeScript theme={null}270 ```typescript TypeScript theme={null}

226 import { query } from "@anthropic-ai/claude-agent-sdk";271 import { query } from "@anthropic-ai/claude-agent-sdk";

227 272 

273 try {

228 for await (const message of query({274 for await (const message of query({

229 prompt: "Optimize my React app performance",275 prompt: "Optimize my React app performance and track progress with todos",

276 options: { maxTurns: 15 },

230 })) {277 })) {

231 if (message.type !== "assistant") continue;278 if (message.type !== "assistant") continue;

232 for (const block of message.message.content) {279 for (const block of message.message.content) {

246 }293 }

247 }294 }

248 }295 }

296 } catch (error) {

297 // A single-shot query() throws after yielding an error result.

298 console.log(`Session ended with an error: ${error}`);

299 }

249 ```300 ```

250 301 

251 ```python Python theme={null}302 ```python Python theme={null}

252 from claude_agent_sdk import query, AssistantMessage, ToolUseBlock303 import asyncio

253 304 

305 from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ToolUseBlock

306 

307 async def main():

308 try:

254 async for message in query(309 async for message in query(

255 prompt="Optimize my React app performance",310 prompt="Optimize my React app performance and track progress with todos",

311 options=ClaudeAgentOptions(max_turns=15),

256 ):312 ):

257 if not isinstance(message, AssistantMessage):313 if not isinstance(message, AssistantMessage):

258 continue314 continue

269 )325 )

270 if task_id:326 if task_id:

271 print(f" {task_id} -> {block.input['status']}")327 print(f" {task_id} -> {block.input['status']}")

328 except Exception as error:

329 # A single-shot query() raises after yielding an error result.

330 print(f"Session ended with an error: {error}")

331 

332 

333 asyncio.run(main())

272 ```334 ```

273</CodeGroup>335</CodeGroup>

274 336 

551```551```

552 552 

553* `API_TIMEOUT_MS`: timeout для каждого запроса на клиенте Anthropic, в миллисекундах. По умолчанию `600000`. Применяется к основному циклу и всем подагентам.553* `API_TIMEOUT_MS`: timeout для каждого запроса на клиенте Anthropic, в миллисекундах. По умолчанию `600000`. Применяется к основному циклу и всем подагентам.

554* `CLAUDE_CODE_MAX_RETRIES`: максимальное количество повторных попыток API. По умолчанию `10`, ограничено `15`. Каждая повторная попытка получает своё собственное окно `API_TIMEOUT_MS`, поэтому наихудший случай wall time примерно `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` плюс backoff. Для автоматических запусков, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG=1` для повторной попытки ошибок ёмкости бесконечно.554* `CLAUDE_CODE_MAX_RETRIES`: максимальное количество повторных попыток API. По умолчанию `10`, ограничено `15`. Каждая повторная попытка получает своё собственное окно `API_TIMEOUT_MS`, поэтому наихудший случай wall time примерно `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` плюс backoff. Для автоматических запусков, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG=1`: он повторяет ошибки ёмкости бесконечно, и {/* min-version: 2.1.199 */}начиная с Claude Code v2.1.199 повышает значение по умолчанию для других переходящих ошибок до `300` и удаляет ограничение на эту переменную.

555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog зависания для подагентов, запущенных с `run_in_background`. По умолчанию `600000`. Сбрасывается при каждом событии потока; при зависании прерывает подагента, отмечает задачу как неудачную и выводит ошибку родителю с любым частичным результатом. Не применяется к синхронным подагентам.555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog зависания для подагентов, запущенных с `run_in_background`. По умолчанию `600000`. Сбрасывается при каждом событии потока; при зависании прерывает подагента, отмечает задачу как неудачную и выводит ошибку родителю с любым частичным результатом. Не применяется к синхронным подагентам.

556* `CLAUDE_ENABLE_STREAM_WATCHDOG` с `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: прерывает запрос, когда заголовки получены, но тело ответа перестаёт потоком передаваться. Watchdog включен по умолчанию для всех поставщиков; установите `CLAUDE_ENABLE_STREAM_WATCHDOG=0` для отключения. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` по умолчанию `300000` и зажимается до этого минимума. Прерванный запрос проходит через обычный путь повторной попытки.556* `CLAUDE_ENABLE_STREAM_WATCHDOG` с `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: прерывает запрос, когда заголовки получены, но тело ответа перестаёт потоком передаваться. Watchdog включен по умолчанию для всех поставщиков; установите `CLAUDE_ENABLE_STREAM_WATCHDOG=0` для отключения. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` по умолчанию `300000` и зажимается до этого минимума. Прерванный запрос проходит через обычный путь повторной попытки.

557 557 

901 decisionReason?: string;901 decisionReason?: string;

902 toolUseID: string;902 toolUseID: string;

903 agentID?: string;903 agentID?: string;

904 requestId: string;

904 }905 }

905) => Promise<PermissionResult>;906) => Promise<PermissionResult | null>;

906```907```

907 908 

908| Опция | Тип | Описание |909| Опция | Тип | Описание |

913| `decisionReason` | `string` | Объясняет, почему был вызван этот запрос разрешения |914| `decisionReason` | `string` | Объясняет, почему был вызван этот запрос разрешения |

914| `toolUseID` | `string` | Уникальный идентификатор для этого конкретного вызова инструмента в сообщении ассистента |915| `toolUseID` | `string` | Уникальный идентификатор для этого конкретного вызова инструмента в сообщении ассистента |

915| `agentID` | `string` | Если работает в подагенте, ID подагента |916| `agentID` | `string` | Если работает в подагенте, ID подагента |

917| `requestId` | `string` | `request_id` обёртки `control_request`. `control_response`, которую ваше приложение отправляет вне SDK, такую как подписанный HTTP POST, должна повторить это значение, чтобы процесс Claude Code мог сопоставить ответ с запросом |

918 

919Обратный вызов обычно разрешает запрос, возвращая [`PermissionResult`](#permissionresult), который SDK записывает обратно через свой транспорт как `control_response`. Возвращайте `null` только когда ваше приложение уже отправило `control_response` для этого запроса через свой собственный канал, повторив `requestId`; SDK затем пропускает запись ответа в свой транспорт. Возврат `null` в любом другом случае оставляет вызов инструмента заблокированным бесконечно, потому что `control_response` никогда не отправляется и запросы разрешения не имеют timeout.

920 

921Опция `requestId` и возвращаемое значение `null` требуют Claude Code v2.1.199 или позже.

916 922 

917<h3 id="permissionresult">923<h3 id="permissionresult">

918 `PermissionResult`924 `PermissionResult`

2179};2185};

2180```2186```

2181 2187 

2182Останавливает выполняющуюся фоновую задачу или shell по ID.2188Останавливает выполняющуюся фоновую задачу или shell по ID. {/* min-version: 2.1.198 */}Начиная с v2.1.198, `task_id` также принимает товарища по команде agent-team или именованного фонового агента по ID агента или имени.

2183 2189 

2184<h3 id="notebookedit">2190<h3 id="notebookedit">

2185 NotebookEdit2191 NotebookEdit

3788| `ripgrep` | `{ command: string; args?: string[] }` | `undefined` | Конфигурация пользовательского бинарного файла ripgrep для окружений sandbox |3794| `ripgrep` | `{ command: string; args?: string[] }` | `undefined` | Конфигурация пользовательского бинарного файла ripgrep для окружений sandbox |

3789 3795 

3790<Note>3796<Note>

3791 Sandbox зависит от поддержки платформы и, на Linux, инструментов, таких как `bubblewrap` и `socat`. Когда `enabled` имеет значение `true` и sandbox не может запуститься, `query()` сообщает сообщение `result` с `subtype: "error_during_execution"` и причину в `errors`, затем останавливается. Следите за этим подтипом, а не ожидайте, что `query()` выбросит исключение перед выдачей сообщений.3797 Sandbox зависит от поддержки платформы и, на Linux, инструментов, таких как `bubblewrap` и `socat`. Когда `enabled` имеет значение `true` и sandbox не может запуститься, `query()` сообщает сообщение `result` с `subtype: "error_during_execution"` и причину в `errors`. Для одного вызова сообщения `query()` SDK выбрасывает после выдачи этого результата ошибки, поэтому оберните цикл в блок try для продолжения после него. Смотрите [Handle the result](/ru/agent-sdk/agent-loop#handle-the-result) для контракта ошибки.

3792 3798 

3793 Для выполнения без sandbox вместо этого установите `failIfUnavailable: false`.3799 Для выполнения без sandbox вместо этого установите `failIfUnavailable: false`.

3794</Note>3800</Note>

3800```typescript theme={null}3806```typescript theme={null}

3801import { query } from "@anthropic-ai/claude-agent-sdk";3807import { query } from "@anthropic-ai/claude-agent-sdk";

3802 3808 

3803for await (const message of query({3809try {

3810 for await (const message of query({

3804 prompt: "Build and test my project",3811 prompt: "Build and test my project",

3805 options: {3812 options: {

3806 sandbox: {3813 sandbox: {

3811 }3818 }

3812 }3819 }

3813 }3820 }

3814})) {3821 })) {

3815 if ("result" in message) console.log(message.result);3822 if ("result" in message) console.log(message.result);

3823 }

3824} catch (error) {

3825 // A single-shot query() throws after yielding an error result,

3826 // such as when the sandbox can't start (failIfUnavailable defaults to true).

3827 console.log(`Session ended with an error: ${error}`);

3816}3828}

3817```3829```

3818 3830 

89* **Enter**: открыть стенограмму выбранного товарища по команде и отправить ему сообщение напрямую89* **Enter**: открыть стенограмму выбранного товарища по команде и отправить ему сообщение напрямую

90* **Escape**: прервать текущий ход выбранного товарища по команде90* **Escape**: прервать текущий ход выбранного товарища по команде

91 91 

92{/* min-version: 2.1.181 */}Начиная с версии 2.1.181, строка неактивного товарища по команде скрывается через 30 секунд и снова появляется при его следующем ходе. Товарищ по команде продолжает работать и остается доступным, пока скрыт.92{/* min-version: 2.1.199 */}Начиная с версии 2.1.199, строка неактивного товарища по команде остается на панели, пока работает любой товарищ по команде или подагент, поэтому вы можете выбрать его для просмотра его стенограммы или отправить ему дополнительную работу. Когда каждый агент на панели неактивен, неактивные строки скрываются через 30 секунд и снова появляются при следующем ходе товарища по команде; товарищ по команде продолжает работать и остается доступным, пока скрыт. В версиях 2.1.181–2.1.198 неактивная строка скрывалась через 30 секунд после завершения собственного хода, даже если другие товарищи по команде все еще работали; неактивные строки не скрываются в версиях до 2.1.181.

93 

94Когда более трех товарищей по команде неактивны одновременно, строки, выходящие за пределы первых трех, сворачиваются в одну строку, которая подсчитывает свернутых товарищей по команде, например `2 idle agents` когда пять неактивны. Выберите его и нажмите Enter для развертывания свернутых строк, или нажмите Esc для их свертывания снова. Работающие товарищи по команде, неудачные товарищи по команде и товарищ по команде, который вы просматриваете, всегда сохраняют свои собственные строки.

93 95 

94Если вы хотите, чтобы каждый товарищ по команде находился в отдельной разделенной панели, см. [Выбор режима отображения](#choose-a-display-mode).96Если вы хотите, чтобы каждый товарищ по команде находился в отдельной разделенной панели, см. [Выбор режима отображения](#choose-a-display-mode).

95 97 

174* **Режим in-process**: используйте клавиши со стрелками вверх и вниз в панели агента для выбора товарища по команде, затем нажмите Enter для просмотра его сеанса и введите сообщение для отправки ему. Нажмите `x` на выбранном товарище по команде для его остановки. Нажмите Ctrl+T для переключения списка задач.176* **Режим in-process**: используйте клавиши со стрелками вверх и вниз в панели агента для выбора товарища по команде, затем нажмите Enter для просмотра его сеанса и введите сообщение для отправки ему. Нажмите `x` на выбранном товарище по команде для его остановки. Нажмите Ctrl+T для переключения списка задач.

175* **Режим split-pane**: щелкните в панель товарища по команде для прямого взаимодействия с его сеансом. Каждый товарищ по команде имеет полный вид своего собственного терминала.177* **Режим split-pane**: щелкните в панель товарища по команде для прямого взаимодействия с его сеансом. Каждый товарищ по команде имеет полный вид своего собственного терминала.

176 178 

179Пока вы просматриваете товарища по команде в режиме in-process, простой текст и [skills](/ru/skills) идут этому товарищу по команде, но встроенные команды все еще работают в сеансе лидера.

180 

181Модель товарища по команде и режим быстрого выполнения фиксируются при его порождении, поэтому `/model` и `/fast` изменяют только параметры лидера. {/* min-version: 2.1.199 */}Начиная с версии v2.1.199, ввод любой из этих команд при просмотре товарища по команде показывает уведомление о том, что изменение применяется к лидеру; более ранние версии применяли его к лидеру без указания. `/effort` все еще применяется к последующим ходам просматриваемого товарища по команде, потому что товарищи по команде следуют [уровню усилий](/ru/model-config#adjust-effort-level) лидера.

182 

177<h3 id="assign-and-claim-tasks">183<h3 id="assign-and-claim-tasks">

178 Назначение и взятие задач184 Назначение и взятие задач

179</h3>185</h3>

295**Как товарищи по команде делятся информацией:**301**Как товарищи по команде делятся информацией:**

296 302 

297* **Автоматическая доставка сообщений**: когда товарищи по команде отправляют сообщения, они автоматически доставляются получателям. Лидеру не нужно опрашивать обновления.303* **Автоматическая доставка сообщений**: когда товарищи по команде отправляют сообщения, они автоматически доставляются получателям. Лидеру не нужно опрашивать обновления.

298* **Уведомления о неактивности**: когда товарищ по команде заканчивает и останавливается, он автоматически уведомляет лидера.304* **Уведомления о неактивности**: когда товарищ по команде заканчивает и останавливается, он автоматически уведомляет лидера. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, товарищ по команде, чей ход заканчивается на ошибке API, уведомляет лидера о том, что он не удался, и включает текст ошибки, вместо того чтобы казаться нормально завершившимся.

299* **Общий список задач**: все агенты могут видеть статус задачи и брать доступную работу.305* **Общий список задач**: все агенты могут видеть статус задачи и брать доступную работу.

300* **Обмен сообщениями товарищей по команде**: отправить сообщение одному конкретному товарищу по команде по имени. Чтобы достичь всех, отправьте одно сообщение на получателя.306* **Обмен сообщениями товарищей по команде**: отправить сообщение одному конкретному товарищу по команде по имени. Чтобы достичь всех, отправьте одно сообщение на получателя.

301 307 

430Если товарищи по команде не появляются после того, как вы попросили Claude создать команду:436Если товарищи по команде не появляются после того, как вы попросили Claude создать команду:

431 437 

432* В режиме in-process товарищи по команде появляются на панели агента ниже поля ввода подсказки. Используйте клавиши со стрелками вверх и вниз для выбора одного, затем нажмите Enter для его просмотра.438* В режиме in-process товарищи по команде появляются на панели агента ниже поля ввода подсказки. Используйте клавиши со стрелками вверх и вниз для выбора одного, затем нажмите Enter для его просмотра.

433* Строка товарища по команде, которая исчезла после простоя, была скрыта, а не остановлена. Неактивные строки скрываются через 30 секунд и снова появляются при следующем ходе товарища по команде. Отправьте товарищу по команде сообщение по имени, чтобы вернуть его.439* Строка товарища по команде, которая исчезла после простоя, была скрыта, а не остановлена. Неактивные строки скрываются через 30 секунд после того, как вся панель переходит в режим ожидания, и снова появляются при следующем ходе товарища по команде. Когда более трех товарищей по команде неактивны, их избыточные строки сворачиваются в одну строку `N idle agents`, которую Enter разворачивает. Отправьте товарищу по команде сообщение по имени, чтобы вернуть скрытую строку.

434* Проверьте, что задача, которую вы дали Claude, была достаточно сложной, чтобы оправдать команду. Claude решает, порождать ли товарищей по команде, на основе задачи.440* Проверьте, что задача, которую вы дали Claude, была достаточно сложной, чтобы оправдать команду. Claude решает, порождать ли товарищей по команде, на основе задачи.

435* Если вы явно запросили разделенные панели, убедитесь, что tmux установлен и доступен в вашем PATH:441* Если вы явно запросили разделенные панели, убедитесь, что tmux установлен и доступен в вашем PATH:

436 ```bash theme={null}442 ```bash theme={null}

453* Дайте им дополнительные инструкции напрямую459* Дайте им дополнительные инструкции напрямую

454* Порождите товарища по команде-замену для продолжения работы460* Порождите товарища по команде-замену для продолжения работы

455 461 

462{/* min-version: 2.1.198 */}Начиная с версии 2.1.198, сообщение от лидера или другого товарища по команде пробуждает товарища по команде в режиме in-process, который ожидает повтора неудачного запроса API, поэтому он повторяет попытку немедленно вместо ожидания полной задержки повтора.

463 

456<h3 id="lead-shuts-down-before-work-is-done">464<h3 id="lead-shuts-down-before-work-is-done">

457 Лидер завершает работу до завершения работы465 Лидер завершает работу до завершения работы

458</h3>466</h3>

481* **Завершение может быть медленным**: товарищи по команде завершают свой текущий запрос или вызов инструмента перед завершением, что может занять время.489* **Завершение может быть медленным**: товарищи по команде завершают свой текущий запрос или вызов инструмента перед завершением, что может занять время.

482* **Одна команда на сеанс**: сеанс имеет ровно одну команду, ограниченную этим сеансом. Вы не можете создавать дополнительные именованные команды или делиться командой между сеансами.490* **Одна команда на сеанс**: сеанс имеет ровно одну команду, ограниченную этим сеансом. Вы не можете создавать дополнительные именованные команды или делиться командой между сеансами.

483* **Нет вложенных команд**: товарищи по команде не могут порождать своих собственных товарищей по команде. Только лидер может управлять командой.491* **Нет вложенных команд**: товарищи по команде не могут порождать своих собственных товарищей по команде. Только лидер может управлять командой.

492* **Нет фоновых подагентов от товарищей по команде in-process**: собственные подагенты товарища по команде in-process работают на переднем плане. Запрос фонового подагента, будь то с помощью `run_in_background` или определения подагента, которое устанавливает `background: true`, возвращает ошибку, потому что фоновая работа товарища по команде не может пережить процесс лидера. Подагенты, запущенные из основного разговора, следуют [фоновому значению по умолчанию](/ru/sub-agents#run-subagents-in-foreground-or-background).

484* **Лидер фиксирован**: основной сеанс является лидером на протяжении всей его жизни. Вы не можете повысить товарища по команде до лидера или передать лидерство.493* **Лидер фиксирован**: основной сеанс является лидером на протяжении всей его жизни. Вы не можете повысить товарища по команде до лидера или передать лидерство.

485* **Разрешения установлены при порождении**: все товарищи по команде начинают с режима разрешений лидера. Вы можете изменить отдельные режимы товарищей по команде после порождения, но вы не можете установить режимы для отдельных товарищей по команде во время порождения.494* **Разрешения установлены при порождении**: все товарищи по команде начинают с режима разрешений лидера. Вы можете изменить отдельные режимы товарищей по команде после порождения, но вы не можете установить режимы для отдельных товарищей по команде во время порождения.

486* **Разделенные панели требуют tmux или iTerm2**: режим in-process по умолчанию работает в любом терминале. Режим разделенных панелей не поддерживается в интегрированном терминале VS Code, Windows Terminal или Ghostty.495* **Разделенные панели требуют tmux или iTerm2**: режим in-process по умолчанию работает в любом терминале. Режим разделенных панелей не поддерживается в интегрированном терминале VS Code, Windows Terminal или Ghostty.

27* [Быстрый старт](#quick-start): дайте Claude задачу для работы в фоне, проверьте её и вмешайтесь, когда это необходимо27* [Быстрый старт](#quick-start): дайте Claude задачу для работы в фоне, проверьте её и вмешайтесь, когда это необходимо

28* [Мониторинг сеансов с помощью agent view](#monitor-sessions-with-agent-view), включая значки состояния, просмотр и ответы, подключение, организацию и сочетания клавиш28* [Мониторинг сеансов с помощью agent view](#monitor-sessions-with-agent-view), включая значки состояния, просмотр и ответы, подключение, организацию и сочетания клавиш

29* [Отправка новых агентов](#dispatch-new-agents) из agent view, из внутри сеанса или из вашей оболочки29* [Отправка новых агентов](#dispatch-new-agents) из agent view, из внутри сеанса или из вашей оболочки

30* [Управление сеансами из оболочки](#manage-sessions-from-the-shell)30* [Управление сеансами из оболочки](#manage-sessions-from-the-shell) с помощью `claude agents`, `claude attach` и связанных команд

31* [Как размещаются фоновые сеансы](#how-background-sessions-are-hosted) процессом супервизора31* [Как размещаются фоновые сеансы](#how-background-sessions-are-hosted) процессом супервизора

32 32 

33<h2 id="quick-start">33<h2 id="quick-start">

64 </Step>64 </Step>

65 65 

66 <Step title="Перенести существующий сеанс">66 <Step title="Перенести существующий сеанс">

67 Чтобы переместить сеанс, который у вас уже открыт, в agent view, запустите `/bg` внутри него или нажмите `←` на пустой подсказке, чтобы отправить его в фон и открыть agent view за один шаг. Сеанс продолжает работать и появляется как строка рядом с теми, которые вы отправили.67 Этот шаг требует запущенного сеанса. Если вы следовали предыдущим шагам, у вас нет открытого сеанса в этом терминале, поэтому откройте обычный сеанс `claude` в другом терминале и сначала отправьте ему сообщение. Чтобы переместить сеанс, который у вас уже открыт, в agent view, запустите `/bg` внутри него или нажмите `←` на пустой подсказке, чтобы отправить его в фон и открыть agent view за один шаг. Сеанс продолжает работать и появляется как строка рядом с теми, которые вы отправили.

68 </Step>68 </Step>

69</Steps>69</Steps>

70 70 

76 76 

77Запустите `claude agents` для открытия agent view. Он захватывает весь терминал и перечисляет каждый сеанс, сгруппированный по состоянию, с закреплёнными сеансами и теми, которые требуют вас в верхней части. Каждая строка показывает имя сеанса, текущую активность и как давно он в последний раз изменился.77Запустите `claude agents` для открытия agent view. Он захватывает весь терминал и перечисляет каждый сеанс, сгруппированный по состоянию, с закреплёнными сеансами и теми, которые требуют вас в верхней части. Каждая строка показывает имя сеанса, текущую активность и как давно он в последний раз изменился.

78 78 

79Имя окрашено цветом, установленным с помощью [`/color`](/ru/commands) в этом сеансе. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, цвет сохраняется, когда вы [отправляете сеанс в фон](#from-inside-a-session) с помощью `←` или `/background`.

80 

79По умолчанию список показывает каждый фоновый сеанс, который вы запустили, во всех ваших проектах. Сеанс, работающий в одном репозитории, и другой в другом worktree, оба появляются здесь, независимо от того, из какого каталога вы открыли agent view. Чтобы ограничить список одним проектом, передайте `--cwd`:81По умолчанию список показывает каждый фоновый сеанс, который вы запустили, во всех ваших проектах. Сеанс, работающий в одном репозитории, и другой в другом worktree, оба появляются здесь, независимо от того, из какого каталога вы открыли agent view. Чтобы ограничить список одним проектом, передайте `--cwd`:

80 82 

81```bash theme={null}83```bash theme={null}

91 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m93 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m

92 94 

93Ready for review95Ready for review

94 ∙ jump physics Opened PR with collision fix PR #2048 2h96 ∙ jump physics Opened PR with collision fix #2048 2h

95 97 

96Needs input98Needs input

97 ✻ power-up design needs input: double jump or wall climb? 1m99 ✻ power-up design needs input: double jump or wall climb? 1m

129| `∙` | Процесс завершился. Вы всё ещё можете просмотреть, ответить или подключиться, и Claude перезапускается с того места, где он остановился |131| `∙` | Процесс завершился. Вы всё ещё можете просмотреть, ответить или подключиться, и Claude перезапускается с того места, где он остановился |

130| `✢` | Сеанс [`/loop`](/ru/scheduled-tasks), спящий между итерациями. Строка показывает количество запусков и обратный отсчёт |132| `✢` | Сеанс [`/loop`](/ru/scheduled-tasks), спящий между итерациями. Строка показывает количество запусков и обратный отсчёт |

131 133 

132Метка `PR #N`, которая может появиться в правом краю строки, является [статусом pull request, который открыл сеанс](#pull-request-status), а не частью значка состояния. Когда сеанс открыл более одного pull request, метка показывает количество вместо этого, например `3 PRs`.134Метка `#N`, которая может появиться в правом краю строки, является [pull request, который открыл сеанс](#pull-request-status), а не частью значка состояния.

133 135 

134Заголовок вкладки терминала показывает количество ожидающих ввода, пока agent view открыт: `2 awaiting input · claude agents`, когда сеансы требуют ввода, или `claude agents`, когда они не требуют.136Заголовок вкладки терминала показывает количество ожидающих ввода, пока agent view открыт: `2 awaiting input · claude agents`, когда сеансы требуют ввода, или `claude agents`, когда они не требуют.

135 137 

138Начиная с версии 2.1.198, пока agent view открыт, Claude Code также отправляет уведомление через ваш настроенный [канал уведомлений терминала](/ru/terminal-config#get-a-terminal-bell-or-notification), когда локальный фоновый сеанс начинает требовать вашего ввода, завершается или не работает. Сеансы, которые работают по расписанию, такие как сеансы [`/loop`](/ru/scheduled-tasks), уведомляют только когда они требуют вашего ввода. Уведомления используют тот же параметр [`preferredNotifChannel`](/ru/settings#available-settings), что и остальная часть Claude Code, и запускают hook [`Notification`](/ru/hooks#notification) с типом `agent_needs_input` или `agent_completed`.

139 

136Фоновые сеансы не требуют открытого терминала для продолжения работы. Отдельный [процесс супервизора](#the-supervisor-process) их запускает, поэтому вы можете закрыть agent view, закрыть оболочку или запустить новый интерактивный сеанс, и ваша отправленная работа продолжает выполняться.140Фоновые сеансы не требуют открытого терминала для продолжения работы. Отдельный [процесс супервизора](#the-supervisor-process) их запускает, поэтому вы можете закрыть agent view, закрыть оболочку или запустить новый интерактивный сеанс, и ваша отправленная работа продолжает выполняться.

137 141 

138Состояние сеанса сохраняется на диск через автоматические обновления и перезапуски супервизора. Сеансы также сохраняются, когда ваша машина переходит в спящий режим. Их процессы возобновляются при пробуждении, и супервизор переподключается к ним вместо того, чтобы рассматривать временной разрыв как неактивность. Выключение всё ещё останавливает работающие сеансы; см. [Sessions show as failed after shutdown](#sessions-show-as-failed-after-shutdown) для того, как их восстановить.142Состояние сеанса сохраняется на диск через автоматические обновления и перезапуски супервизора. Сеансы также сохраняются, когда ваша машина переходит в спящий режим. Их процессы возобновляются при пробуждении, и супервизор переподключается к ним вместо того, чтобы рассматривать временной разрыв как неактивность. Выключение всё ещё останавливает работающие сеансы; см. [Sessions show as failed after shutdown](#sessions-show-as-failed-after-shutdown) для того, как их восстановить.

151 Статус pull request155 Статус pull request

152</h3>156</h3>

153 157 

154Когда сеанс открывает pull request, в правом краю строки появляется метка `PR #1234`, связанная с pull request в терминалах, поддерживающих гиперссылки. Метка сохраняется, когда вы отправляете дополнительное сообщение сеансу, поэтому pull request остаётся видимым, пока строка возвращается к живому прогрессу.158Когда сеанс открывает pull request, в правом краю строки появляется метка `#1234`, связанная с pull request в терминалах, поддерживающих гиперссылки. Метка сохраняется, когда вы отправляете дополнительное сообщение сеансу, поэтому pull request остаётся видимым, пока строка возвращается к живому прогрессу. Фоновые сеансы, которые изолировали свои изменения в worktree, открывают эти pull request сами; [How file edits are isolated](#how-file-edits-are-isolated) охватывает, когда это происходит и что сеанс никогда не делает без запроса.

155 159 

156Когда сеанс открыл более одного pull request, метка показывает количество вместо этого, например `3 PRs`, окрашенное по открытому pull request, который больше всего нуждается во внимании. Откройте [панель просмотра](#peek-and-reply), чтобы увидеть их все.160Когда сеанс открыл более одного pull request, метка показывает количество вместо этого, например `3 PRs`, окрашенное по открытому pull request, который больше всего нуждается во внимании. Откройте [панель просмотра](#peek-and-reply), чтобы увидеть их все.

157 161 

190 194 

191Подключённые сеансы всегда отображаются в [полноэкранном режиме](/ru/fullscreen), независимо от вашего параметра `tui`, потому что фоновый сеанс не имеет истории прокрутки терминала для добавления. Прокручивайте с помощью `PgUp`, `PgDn` или колеса мыши, и нажмите `Ctrl+O` для режима стенограммы. Встроенная прокрутка вашего терминала и режим копирования tmux показывают только текущий видимый область, как и при запуске любого полноэкранного приложения.195Подключённые сеансы всегда отображаются в [полноэкранном режиме](/ru/fullscreen), независимо от вашего параметра `tui`, потому что фоновый сеанс не имеет истории прокрутки терминала для добавления. Прокручивайте с помощью `PgUp`, `PgDn` или колеса мыши, и нажмите `Ctrl+O` для режима стенограммы. Встроенная прокрутка вашего терминала и режим копирования tmux показывают только текущий видимый область, как и при запуске любого полноэкранного приложения.

192 196 

193Нажмите `←` на пустой подсказке для отключения и возврата к agent view. Если диалог имеет фокус и не реагирует на `←`, нажмите `Ctrl+Z` для немедленного отключения.197Нажмите `←` на пустой подсказке или запустите `/exit`, чтобы отключиться и вернуться к agent view. Начиная с версии 2.1.198, это работает одинаково, открыли ли вы сеанс из agent view или с помощью `claude attach <id>` из вашей оболочки.

198 

199`Ctrl+Z` также отключает, но возвращается туда, где вы начали: к agent view, если вы подключились оттуда, или к вашей оболочке, если вы запустили `claude attach`. Используйте `Ctrl+Z`, когда диалог имеет фокус и не реагирует на `←`.

194 200 

195`Ctrl+C` сохраняет своё стандартное поведение прерывания при подключении: оно отменяет выполняемый ответ или команду `!` shell вместо отключения. Нажатие `Ctrl+C` дважды на пустой подсказке отключает, как и в любом сеансе.201`Ctrl+C` сохраняет своё стандартное поведение прерывания при подключении: оно отменяет выполняемый ответ или команду `!` shell вместо отключения. Нажатие `Ctrl+C` дважды на пустой подсказке отключает, как и в любом сеансе.

196 202 

289| `#<number>` или URL pull request | Если сеанс уже работает над этим PR, выберите его вместо отправки |295| `#<number>` или URL pull request | Если сеанс уже работает над этим PR, выберите его вместо отправки |

290| `Shift+Enter` | Отправка и немедленное подключение к новому сеансу |296| `Shift+Enter` | Отправка и немедленное подключение к новому сеансу |

291 297 

292Небольшой набор команд запускается в самом agent view вместо отправки: `/exit` и `/quit` закрывают agent view, `/logout` выходит из системы, и `/model` устанавливает [dispatch model](#set-the-model). Skills, ваши собственные команды и расширяющие подсказку встроенные команды, такие как `/init`, отправляются в новый фоновый сеанс как его первая подсказка. Другие встроенные команды показывают подсказку `attach to a session to run it` вместо этого.298Небольшой набор команд запускается в самом agent view вместо отправки:

299 

300* `/exit` и `/quit` закрывают agent view

301* `/logout` выходит из системы

302* `/model` устанавливает [dispatch model](#set-the-model)

303* {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, `/login` открывает диалог входа, чтобы вы могли войти снова без подключения к сеансу

304 

305Skills, ваши собственные команды и расширяющие подсказку встроенные команды, такие как `/init`, отправляются в новый фоновый сеанс как его первая подсказка. Другие встроенные команды показывают подсказку `attach to a session to run it` вместо этого.

293 306 

294Упаковка повторяющейся задачи как [skill](/ru/skills) позволяет вам запускать один и тот же рабочий процесс из agent view многократно без переввода подсказки.307Упаковка повторяющейся задачи как [skill](/ru/skills) позволяет вам запускать один и тот же рабочий процесс из agent view многократно без переввода подсказки.

295 308 

313 326 

314Запустите `/background` или его псевдоним `/bg` для перемещения текущей беседы в фоновый сеанс. Передайте подсказку, такую как `/bg run the test suite and fix any failures`, для отправки одной дополнительной инструкции перед этим. Если Claude отвечает, когда вы запускаете `/bg`, ответ продолжается в фоновом сеансе.327Запустите `/background` или его псевдоним `/bg` для перемещения текущей беседы в фоновый сеанс. Передайте подсказку, такую как `/bg run the test suite and fix any failures`, для отправки одной дополнительной инструкции перед этим. Если Claude отвечает, когда вы запускаете `/bg`, ответ продолжается в фоновом сеансе.

315 328 

329Выход из интерактивного сеанса, который всё ещё имеет выполняемую фоновую работу, такую как subagents, фоновые команды shell, рабочие процессы или [monitors](/ru/tools-reference#monitor-tool), показывает диалог `Background work is running` вместо немедленного выхода. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, диалог предлагает `Move to background and exit` наряду с `Exit anyway` и `Stay`. Выбор этого варианта перемещает сеанс в фон так же, как это делает `/background`, затем возвращает вас в вашу оболочку, поэтому работа, которая может продолжаться, продолжает работать, и сеанс отображается в agent view. Этот вариант не показывается, когда agent view [отключен](#turn-off-agent-view).

330 

316Переведение в фон из интерактивного сеанса запускает свежий процесс, который возобновляется из сохранённой беседы, и выполняемая работа переходит в него: работающие фоновые команды shell, фоновые subagents, динамические рабочие процессы и запланированные задачи, которые вы создали с помощью [`/loop`](/ru/scheduled-tasks), переносятся в фоновый сеанс и продолжают работать там. Subagent переходит вместе со всем, что он запустил, поэтому он переносится только когда вся эта работа может перейти тоже, включая на Windows. Чтобы остановить выполняемую работу вместо её переноса, установите переменную окружения [`CLAUDE_DISABLE_ADOPT=1`](/ru/env-vars#variables); Claude Code затем просит вас подтвердить перед отправкой в фон.331Переведение в фон из интерактивного сеанса запускает свежий процесс, который возобновляется из сохранённой беседы, и выполняемая работа переходит в него: работающие фоновые команды shell, фоновые subagents, динамические рабочие процессы и запланированные задачи, которые вы создали с помощью [`/loop`](/ru/scheduled-tasks), переносятся в фоновый сеанс и продолжают работать там. Subagent переходит вместе со всем, что он запустил, поэтому он переносится только когда вся эта работа может перейти тоже, включая на Windows. Чтобы остановить выполняемую работу вместо её переноса, установите переменную окружения [`CLAUDE_DISABLE_ADOPT=1`](/ru/env-vars#variables); Claude Code затем просит вас подтвердить перед отправкой в фон.

317 332 

318Работа, которая не может перейти, такая как работающий [monitor](/ru/tools-reference#monitor-tool), останавливается. Фоновый subagent, который владеет монитором, останавливается вместе с ним. Когда какая-либо такая работа выполняется, Claude Code показывает диалог `Background this session?` так, чтобы вы могли подтвердить перед её остановкой.333Работа, которая не может перейти, такая как работающий [monitor](/ru/tools-reference#monitor-tool), останавливается. Фоновый subagent, который владеет монитором, останавливается вместе с ним. Когда какая-либо такая работа выполняется, Claude Code показывает диалог `Background this session?` так, чтобы вы могли подтвердить перед её остановкой.

342claude --bg "investigate the flaky SettingsChangeDetector test"357claude --bg "investigate the flaky SettingsChangeDetector test"

343```358```

344 359 

360Подсказка является позиционным аргументом, а не значением `-p`. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, объединение `--bg` с `-p` или `--print` отклоняется с ошибкой перед созданием любого сеанса, потому что `--print` никогда не запускает интерактивный сеанс, к которому подключается `claude agents`.

361 

345Чтобы запустить конкретного subagent как основного агента сеанса, объедините `--bg` с `--agent`:362Чтобы запустить конкретного subagent как основного агента сеанса, объедините `--bg` с `--agent`:

346 363 

347```bash theme={null}364```bash theme={null}

414 431 

415[Subagent](/ru/sub-agents), который запускает фоновый сеанс, наследует рабочий каталог сеанса, поэтому его правки файлов попадают в worktree сеанса, а не в вашу рабочую копию. Чтобы дать subagent его собственный отдельный worktree вместо этого, установите [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields) в его frontmatter или передайте `isolation: "worktree"` при запуске его.432[Subagent](/ru/sub-agents), который запускает фоновый сеанс, наследует рабочий каталог сеанса, поэтому его правки файлов попадают в worktree сеанса, а не в вашу рабочую копию. Чтобы дать subagent его собственный отдельный worktree вместо этого, установите [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields) в его frontmatter или передайте `isolation: "worktree"` при запуске его.

416 433 

434Начиная с версии 2.1.198, фоновый сеанс, который изолировал свои изменения кода в worktree, также фиксирует, отправляет свою собственную ветку и открывает черновик pull request без остановки для вопроса. Метка [`#N`](#pull-request-status) отображается на его строке, когда pull request открывается. Он никогда не отправляет на `main` или `master`, никогда не выполняет force-push или merge, и пропускает pull request, когда вы сказали ему не открывать один или репозиторий не имеет удалённого.

435 

436Сеанс, редактирующий checkout, который он не изолировал сам, всё ещё спрашивает перед фиксацией или переключением ветвей. Это применяется, когда изоляция установлена на `"none"`, когда перемещение worktree не удалось, или когда сеанс запустился внутри worktree, который уже существовал.

437 

417<h3 id="set-the-model">438<h3 id="set-the-model">

418 Установка модели439 Установка модели

419</h3>440</h3>

529 550 

530После завершения сеанса и его неподключённого состояния примерно час супервизор останавливает его процесс для освобождения ресурсов. Сеанс, который вы [закрепили](#organize-the-list) с помощью `Ctrl+T`, освобождается и сохраняет свой процесс работающим в режиме ожидания. Стенограмма и состояние остаются на диске в любом случае, и в следующий раз, когда вы подключитесь, посмотрите или ответите на остановленный сеанс, супервизор запускает свежий процесс с того места, где он остановился. Когда каждый сеанс завершён и ни один терминал не подключён, сам супервизор выходит и запускается снова в следующий раз, когда вам это потребуется.551После завершения сеанса и его неподключённого состояния примерно час супервизор останавливает его процесс для освобождения ресурсов. Сеанс, который вы [закрепили](#organize-the-list) с помощью `Ctrl+T`, освобождается и сохраняет свой процесс работающим в режиме ожидания. Стенограмма и состояние остаются на диске в любом случае, и в следующий раз, когда вы подключитесь, посмотрите или ответите на остановленный сеанс, супервизор запускает свежий процесс с того места, где он остановился. Когда каждый сеанс завершён и ни один терминал не подключён, сам супервизор выходит и запускается снова в следующий раз, когда вам это потребуется.

531 552 

532Фоновые команды shell и динамические рабочие процессы, которые запускает сеанс, продолжают работать, когда его процесс останавливается, перезапускается или обновляется, включая на Windows. Следующий процесс, запущенный для этого сеанса, подхватывает их, команда shell, которая завершилась в то время, сообщается как завершённая с её выводом, и рабочий процесс возобновляется с того места, где он остановился. Команды shell, запущенные subagent, и работающие [monitors](/ru/tools-reference#monitor-tool) по-прежнему останавливаются с процессом, и удаление сеанса останавливает всё, что он передал. Чтобы фоновые команды shell и рабочие процессы также останавливались с процессом, установите переменную окружения [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/ru/env-vars#variables) на `1`.553Фоновая работа, которую сеанс сам запустил на верхнем уровне, передаётся, когда его процесс останавливается, перезапускается или обновляется, включая на Windows. Следующий процесс, запущенный для этого сеанса, подхватывает работу:

554 

555* Фоновая команда оболочки, которая завершилась в то время, сообщается как завершённая с её выводом

556* Динамический рабочий процесс возобновляется с того места, где он остановился

557* [Фоновый подагент](/ru/sub-agents#run-subagents-in-foreground-or-background) возобновляется из его собственной стенограммы

558 

559{/* min-version: 2.1.198 */}Начиная с версии 2.1.198 передача охватывает все три. До версии 2.1.198 она охватывала только команды оболочки и рабочие процессы, поэтому фоновый подагент останавливался с процессом и сообщался как неудачный при следующем пробуждении.

560 

561Работа, состояние которой существует только внутри самого процесса, останавливается вместе с ним вместо передачи. Это команды оболочки, которые запустил подагент, которые возобновлённый подагент может запустить снова, и работающие [мониторы](/ru/tools-reference#monitor-tool), поток событий которых не может быть перемещён в другой процесс.

562 

563Удаление сеанса останавливает всё, что он передал. Чтобы остановить всю фоновую работу сеанса с процессом вместо передачи, установите переменную окружения [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/ru/env-vars#variables) на `1`.

533 564 

534Если перезапущенный сеанс возвращается, показывая только его исходную подсказку, потому что Claude Code неправильно прочитал его стенограмму как пустую, стенограмма разговора переименовывается с суффиксом `.orphaned-` вместо удаления, поэтому она остаётся на вашей машине.565Если перезапущенный сеанс возвращается, показывая только его исходную подсказку, потому что Claude Code неправильно прочитал его стенограмму как пустую, стенограмма разговора переименовывается с суффиксом `.orphaned-` вместо удаления, поэтому она остаётся на вашей машине.

535 566 

606 637 

607Спящий режим сам по себе не вызывает это. Сеансы сохраняются во время спящего режима, и супервизор переподключается к ним при пробуждении.638Спящий режим сам по себе не вызывает это. Сеансы сохраняются во время спящего режима, и супервизор переподключается к ним при пробуждении.

608 639 

640<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

641 Сеанс не запускается с примечанием `possibly low memory`

642</h3>

643 

644Начиная с версии 2.1.199, когда процесс фонового сеанса завершается до завершения запуска и хост имеет низкий объём памяти, статус строки называет выход и добавляет `possibly low memory — free some up and retry`. Более ранние версии показывали только причину выхода для этого сбоя.

645 

646Примечание является гипотезой, а не подтверждённой причиной. Claude Code добавляет его только когда процесс завершился молча, без написания ошибки и без остановки сигналом, и хост сообщил о низком объёме памяти в этот момент. Когда процесс написал ошибку перед выходом, строка показывает эту ошибку вместо этого.

647 

648Освободите память на машине, затем подключитесь, посмотрите или ответьте на строку, и супервизор запустит свежий процесс для сеанса. Когда память остаётся низкой, супервизор также [останавливает неактивные сеансы](#the-supervisor-process) для освобождения ресурсов самостоятельно.

649 

609<h3 id="agent-view-says-the-background-service-did-not-respond">650<h3 id="agent-view-says-the-background-service-did-not-respond">

610 Agent view говорит, что фоновый сервис не ответил651 Agent view говорит, что фоновый сервис не ответил

611</h3>652</h3>

636 677 

637См. [справочник по ошибкам](/ru/errors#could-not-resolve-authentication-method) для полного списка причин и исправлений.678См. [справочник по ошибкам](/ru/errors#could-not-resolve-authentication-method) для полного списка причин и исправлений.

638 679 

639<h3 id="background-sessions-cannot-read-desktop-documents-or-downloads-on-macos">680<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">

640 Фоновые сеансы не могут читать Desktop, Documents или Downloads на macOS681 Фоновые сеансы не могут читать Desktop, Documents или Downloads на macOS

641</h3>682</h3>

642 683 

644 685 

645При использовании встроенного установщика запись отображается как Claude Code и разрешение сохраняется при обновлениях. При других методах установки, таких как Homebrew или npm, запись показывает путь к двоичному файлу и может потребоваться предоставить разрешение снова после обновления.686При использовании встроенного установщика запись отображается как Claude Code и разрешение сохраняется при обновлениях. При других методах установки, таких как Homebrew или npm, запись показывает путь к двоичному файлу и может потребоваться предоставить разрешение снова после обновления.

646 687 

688<h3 id="background-sessions-can’t-reach-local-network-hosts-on-macos">

689 Фоновые сеансы не могут достичь хостов локальной сети на macOS

690</h3>

691 

692На macOS 15 и более поздних версиях система блокирует процесс от доступа к устройствам в вашей локальной сети, пока вы не предоставите разрешение Local Network. До версии 2.1.198 хост фонового сеанса никогда не запрашивал это разрешение, поэтому команды, нацеленные на адрес LAN, завершались с ошибкой `connect: no route to host`, даже если та же команда работала в переднем терминале. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, первая команда в фоновом сеансе, которая подключается к адресу локальной сети, запускает запрос разрешения macOS Local Network для Claude Code. Предоставьте его один раз, и эти команды будут достигать хостов LAN так же, как они это делают в переднем терминале.

693 

647<h3 id="a-session-is-slow-to-respond-after-attaching">694<h3 id="a-session-is-slow-to-respond-after-attaching">

648 Сеанс медленно реагирует после подключения695 Сеанс медленно реагирует после подключения

649</h3>696</h3>

683Agent view быстро развивался во время исследовательского предпросмотра. Если вы находитесь на более старой версии Claude Code, некоторое поведение на этой странице может отличаться; в частности, `claude agents` отклоняет флаги, которые он ещё не поддерживает, с ошибкой `unknown option`. Таблица ниже указывает, когда каждый флаг и поведение были добавлены.730Agent view быстро развивался во время исследовательского предпросмотра. Если вы находитесь на более старой версии Claude Code, некоторое поведение на этой странице может отличаться; в частности, `claude agents` отклоняет флаги, которые он ещё не поддерживает, с ошибкой `unknown option`. Таблица ниже указывает, когда каждый флаг и поведение были добавлены.

684 731 

685| Версия | Изменение |732| Версия | Изменение |

686| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |733| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

734| v2.1.199 | {/* min-version: 2.1.199 */}Фоновый сеанс, процесс которого завершается до завершения запуска на хосте с низкой памятью, показывает `possibly low memory — free some up and retry` в статусе его строки вместо только простой причины выхода. Отправка сеанса в фон с помощью `←` или `/background` переносит его `/color` в новую строку. |

735| v2.1.198 | {/* min-version: 2.1.198 */}Agent view отправляет уведомление через `preferredNotifChannel`, когда фоновому сеансу требуется ввод, он завершается или не удаётся, и запускает hook `Notification` с типом `agent_needs_input` или `agent_completed`. `←` и `/exit` внутри `claude attach <id>` возвращаются к agent view вместо выхода в shell; `Ctrl+Z` возвращается в shell. Фоновый сеанс, который изолировал свою работу в worktree, фиксирует, отправляет свою собственную изолированную ветвь, никогда не `main` или `master`, и открывает черновик pull request при завершении вместо предварительного запроса. `/login` запускается в agent view и открывает диалог входа. Диалог выхода `Background work is running` предлагает `Move to background and exit`. Передача выхода также охватывает фоновые подагенты, которые возобновляются из своей стенограммы при следующем пробуждении вместо того, чтобы быть отмеченными как неудачные. `claude --bg` в сочетании с `-p` или `--print` отклоняется с ошибкой. |

687| v2.1.196 | {/* min-version: 2.1.196 */}Одиночное нажатие `←` отправляет сеанс переднего плана в фон; более ранние версии требовали двух нажатий, с подсказкой в нижнем колонтитуле и подтверждением. `--dangerously-skip-permissions`, переданный в `claude agents`, показывает отказ от ответственности за обход вместо молчаливого отклонения. Интерактивные сеансы, которые вы никогда не называли, имеют стандартное имя, такое как `my-app-3f`, в списках сеансов и `claude agents --json`. Фоновые команды shell и динамические рабочие процессы выживают при остановке, перезапуске или обновлении процесса сеанса, включая на Windows; установите `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1`, чтобы отключить передачу. Стенограмма, неправильно прочитанная как пустая при перезапуске, переименовывается с суффиксом `.orphaned-` вместо удаления. |736| v2.1.196 | {/* min-version: 2.1.196 */}Одиночное нажатие `←` отправляет сеанс переднего плана в фон; более ранние версии требовали двух нажатий, с подсказкой в нижнем колонтитуле и подтверждением. `--dangerously-skip-permissions`, переданный в `claude agents`, показывает отказ от ответственности за обход вместо молчаливого отклонения. Интерактивные сеансы, которые вы никогда не называли, имеют стандартное имя, такое как `my-app-3f`, в списках сеансов и `claude agents --json`. Фоновые команды shell и динамические рабочие процессы выживают при остановке, перезапуске или обновлении процесса сеанса, включая на Windows; установите `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1`, чтобы отключить передачу. Стенограмма, неправильно прочитанная как пустая при перезапуске, переименовывается с суффиксом `.orphaned-` вместо удаления. |

688| v2.1.195 | {/* min-version: 2.1.195 */}Выполняемая работа переносится, когда вы отправляете сеанс в фон на Windows тоже; установите `CLAUDE_DISABLE_ADOPT=1`, чтобы остановить её вместо этого. Группа `Completed` заполняет оставшееся вертикальное пространство и заголовок сжимается на коротких терминалах. Более старая версия Claude Code больше не отклоняет поля `state.json` более новых сеансов и не скрывает эти сеансы из `claude agents`. Подключение к остановленному сеансу переключается немедленно вместо показа пустого экрана до пяти секунд. Супервизор, который не может принять подключения, выходит и освобождает свою блокировку самостоятельно. |737| v2.1.195 | {/* min-version: 2.1.195 */}Выполняемая работа переносится, когда вы отправляете сеанс в фон на Windows тоже; установите `CLAUDE_DISABLE_ADOPT=1`, чтобы остановить её вместо этого. Группа `Completed` заполняет оставшееся вертикальное пространство и заголовок сжимается на коротких терминалах. Более старая версия Claude Code больше не отклоняет поля `state.json` более новых сеансов и не скрывает эти сеансы из `claude agents`. Подключение к остановленному сеансу переключается немедленно вместо показа пустого экрана до пяти секунд. Супервизор, который не может принять подключения, выходит и освобождает свою блокировку самостоятельно. |

689| v2.1.174 | {/* min-version: 2.1.174 */}Фоновые сеансы больше не наследуют переменные конечной точки шлюза, такие как `ANTHROPIC_BASE_URL`, из оболочки запуска супервизора; супервизор предоставляет свежий снимок учётных данных предварительно прогретым рабочим процессам, исправляя ошибки `Could not resolve authentication method`. |738| v2.1.174 | {/* min-version: 2.1.174 */}Фоновые сеансы больше не наследуют переменные конечной точки шлюза, такие как `ANTHROPIC_BASE_URL`, из оболочки запуска супервизора; супервизор предоставляет свежий снимок учётных данных предварительно прогретым рабочим процессам, исправляя ошибки `Could not resolve authentication method`. |

53Команда для проверки выполняемой работы зависит от того, какой подход вы использовали:53Команда для проверки выполняемой работы зависит от того, какой подход вы использовали:

54 54 

55* Для фоновых сеансов `claude agents` открывает [agent view](/ru/agent-view): один экран, показывающий каждый сеанс, его состояние и какие из них нуждаются в вашем вводе.55* Для фоновых сеансов `claude agents` открывает [agent view](/ru/agent-view): один экран, показывающий каждый сеанс, его состояние и какие из них нуждаются в вашем вводе.

56* Для подагентов в текущем сеансе `/agents` открывает панель с вкладкой **Running**, в которой перечислены активные подагенты, и вкладкой **Library**, где вы [создаете и редактируете пользовательские подагенты](/ru/sub-agents#use-the-%2Fagents-command). Несмотря на похожее имя, это отделено от `claude agents`.56* Для подагентов в текущем сеансе именованные фоновые подагенты появляются в typeahead @-упоминания с их статусом. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, `/agents` больше не открывает панель; он выводит уведомление, указывающее на расположение файлов подагентов. Чтобы [создавать и редактировать пользовательские подагенты](/ru/sub-agents#configure-subagents), попросите Claude или отредактируйте файлы напрямую. Несмотря на похожее имя, `/agents` отделен от `claude agents`.

57* Для всего, что работает в фоновом режиме текущего сеанса, `/tasks` перечисляет каждый элемент и позволяет вам проверить, присоединиться или остановить его.57* Для всего, что работает в фоновом режиме текущего сеанса, `/tasks` перечисляет каждый элемент и позволяет вам проверить, присоединиться или остановить его.

58* Для динамических рабочих процессов `/workflows` перечисляет запущенные и завершенные запуски, фазу, в которой находится каждый из них, и сколько агентов завершило работу.58* Для динамических рабочих процессов `/workflows` перечисляет запущенные и завершенные запуски, фазу, в которой находится каждый из них, и сколько агентов завершило работу.

59 59 

184 184 

185Эти два параметра имеют разные условия срабатывания:185Эти два параметра имеют разные условия срабатывания:

186 186 

187* **`awsAuthRefresh`**: запускается только когда Claude Code обнаруживает, что ваши учетные данные AWS истекли, либо локально на основе их временной метки, либо когда Bedrock возвращает ошибку учетных данных, затем повторяет попытку запроса с обновленными учетными данными.187* **`awsAuthRefresh`**: запускается только когда Claude Code обнаруживает, что ваши учетные данные AWS истекли, либо локально на основе их временной метки, либо когда API возвращает ошибку учетных данных, затем повторяет попытку запроса с обновленными учетными данными.

188* **`awsCredentialExport`**: запускается при запуске сеанса и при каждой перезагрузке учетных данных, даже когда учетные данные в цепочке поставщика учетных данных AWS по умолчанию все еще действительны. Используйте это, когда ваша учетная запись Bedrock требует учетные данные между учетными записями, которые отличаются от тех, которые разрешила бы цепочка поставщика по умолчанию.188* **`awsCredentialExport`**: запускается при запуске сеанса и при каждой перезагрузке учетных данных, даже когда учетные данные в цепочке поставщика учетных данных AWS по умолчанию все еще действительны. Используйте это, когда ваша учетная запись Bedrock требует учетные данные между учетными записями, которые отличаются от тех, которые разрешила бы цепочка поставщика по умолчанию.

189 189 

190<h5 id="example-configuration">190<h5 id="example-configuration">

54 54 

55Для большинства организаций `autoMode.environment` — это единственное поле, которое вам нужно установить. Оно сообщает классификатору, какие репозитории, бакеты и домены являются доверенными: классификатор использует его для определения того, что означает "внешний", поэтому любой пункт назначения, не указанный в списке, является потенциальной целью утечки данных.55Для большинства организаций `autoMode.environment` — это единственное поле, которое вам нужно установить. Оно сообщает классификатору, какие репозитории, бакеты и домены являются доверенными: классификатор использует его для определения того, что означает "внешний", поэтому любой пункт назначения, не указанный в списке, является потенциальной целью утечки данных.

56 56 

57Начиная с Claude Code v2.1.195, `claude auto-mode defaults` выводит два вида записей окружения.57Начиная с Claude Code v2.1.198, `claude auto-mode defaults` выводит три вида записей окружения. Версии до v2.1.195 выводят только первые пять слотов доверия.

58 58 

59* **Слоты контекста**: описывают вашу организацию, стек и позицию безопасности, чтобы классификатор читал другие правила в вашем контексте. В отличие от двух других видов, слоты контекста не имеют собственных правил, которые их нацеливают. Каждый по умолчанию имеет значение `None configured` или консервативное предположение, указанное рядом с ним:

60 * **Organization**

61 * **Primary use of Claude Code**: по умолчанию разработка программного обеспечения

62 * **Cloud provider(s)**

63 * **Repository visibility**: репозиторий считается приватным, если его удаленный хост и имя не указывают иное

64 * **Internal sharing / snippet hosting**: публичные сервисы paste и gist рассматриваются как находящиеся вне границы доверия до тех пор, пока вы их не назовете

65 * **Org-specific CLIs**

66 * **Secrets management**

67 * **Default / protected branches**: `main` и `master` рассматриваются как защищенные до тех пор, пока вы не назовете другие

68 * **CI/CD deploy targets**

69 * **Network posture**

70 * **Protected deployment namespaces / environments**: возвращается к эвристике Sensitive remote targets до тех пор, пока вы их не назовете

71 * **Data retention / declassification**

59* **Слоты доверия**: называют то, что классификатор рассматривает как находящееся внутри вашей границы. Слоты — это Trusted repo, Source control, Trusted internal domains, Trusted cloud buckets, Key internal services и Internal package registry. Записи repo и source-control по умолчанию указывают на рабочий репозиторий и его настроенные удаленные репозитории. Все остальные слоты доверия по умолчанию имеют значение `None configured`, поэтому ничего больше не доверяется до тех пор, пока вы это не добавите.72* **Слоты доверия**: называют то, что классификатор рассматривает как находящееся внутри вашей границы. Слоты — это Trusted repo, Source control, Trusted internal domains, Trusted cloud buckets, Key internal services и Internal package registry. Записи repo и source-control по умолчанию указывают на рабочий репозиторий и его настроенные удаленные репозитории. Все остальные слоты доверия по умолчанию имеют значение `None configured`, поэтому ничего больше не доверяется до тех пор, пока вы это не добавите.

60* **Слоты чувствительности**: называют то, что защитные правила рассматривают как высокий риск. Слоты — это PII / regulated-data locations, Sensitive remote targets и Protected IaC scopes. Каждый по умолчанию использует широкую эвристику, например рассматривая любой хост или пространство имен, чье имя содержит `prod` или `production`, как чувствительную удаленную цель, поэтому защитные правила активны до того, как вы что-либо настроите. Указание конкретных целей в слоте чувствительности заставляет эти правила применяться к названным целям вместо эвристики.73* **Слоты чувствительности**: называют то, что защитные правила рассматривают как высокий риск. Слоты — это Sensitive data locations & audiences, Sensitive remote targets и Protected IaC scopes. Каждый по умолчанию использует широкую эвристику, например рассматривая любой хост или пространство имен, чье имя содержит `prod` или `production`, как чувствительную удаленную цель, поэтому защитные правила активны до того, как вы что-либо настроите. Указание конкретных целей в слоте чувствительности заставляет эти правила применяться к названным целям вместо эвристики.

61 

62Версии до v2.1.195 выводят только первые пять слотов доверия.

63 74 

64Чтобы добавить свои собственные записи наряду с значениями по умолчанию, включите буквальную строку `"$defaults"` в массив. Записи по умолчанию вставляются в эту позицию, поэтому ваши пользовательские записи могут идти до или после них.75Чтобы добавить свои собственные записи наряду с значениями по умолчанию, включите буквальную строку `"$defaults"` в массив. Записи по умолчанию вставляются в эту позицию, поэтому ваши пользовательские записи могут идти до или после них.

65 76 

87* **Доверенные внутренние домены**: имена хостов для API, панелей управления и сервисов внутри вашей сети, например `*.internal.example.com`98* **Доверенные внутренние домены**: имена хостов для API, панелей управления и сервисов внутри вашей сети, например `*.internal.example.com`

88* **Ключевые внутренние сервисы**: CI, реестры артефактов, внутренние индексы пакетов, инструменты для инцидентов99* **Ключевые внутренние сервисы**: CI, реестры артефактов, внутренние индексы пакетов, инструменты для инцидентов

89* **Внутренний реестр пакетов**: приватный npm, PyPI или другой реестр, через который должны проходить установки, поэтому установки, которые обходят его для публичного реестра, блокируются100* **Внутренний реестр пакетов**: приватный npm, PyPI или другой реестр, через который должны проходить установки, поэтому установки, которые обходят его для публичного реестра, блокируются

90* **PII / regulated-data locations**: бакеты, базы данных или пути, которые содержат личные или регулируемые данные, поэтому классификатор защищает эти местоположения вместо того, чтобы угадывать из содержимого101* **Sensitive data locations & audiences**: бакеты, базы данных или пути, которые содержат личные данные, конфиденциальные бизнес-данные, учетные данные, регулируемые данные или аналогичный чувствительный материал, и аудитории, с которыми данные в каждом местоположении могут быть общими, поэтому классификатор защищает эти местоположения вместо того, чтобы угадывать из содержимого. {/* min-version: 2.1.195 */}{/* max-version: 2.1.197 */}Claude Code v2.1.195 через v2.1.197 называют эту запись PII / regulated-data locations и охватывают только местоположения, которые содержат личные или регулируемые данные, без измерения аудитории

91* **Sensitive remote targets**: пространства имен, хосты или контейнеры, которые считаются production, поэтому удаленные оболочки и port-forwards в них требуют вашего явного одобрения102* **Sensitive remote targets**: пространства имен, хосты или контейнеры, которые считаются production, поэтому удаленные оболочки и port-forwards в них требуют вашего явного одобрения

92* **Protected IaC scopes**: ресурсы инфраструктуры, чьи apply или destroy всегда должны требовать от вас назвать изменение103* **Protected IaC scopes**: ресурсы инфраструктуры, чьи apply или destroy всегда должны требовать от вас назвать изменение

93* **Дополнительный контекст**: ограничения регулируемой отрасли, многопользовательская инфраструктура или требования соответствия, которые влияют на то, что классификатор должен рассматривать как рискованное104* **Дополнительный контекст**: ограничения регулируемой отрасли, многопользовательская инфраструктура или требования соответствия, которые влияют на то, что классификатор должен рассматривать как рискованное

94 105 

95Записи Internal package registry, PII / regulated-data locations, Sensitive remote targets и Protected IaC scopes требуют Claude Code v2.1.195 или позже. Более ранние версии по-прежнему читают их как простой контекст, но не имеют встроенных правил, которые их нацеливают.106Записи Internal package registry, Sensitive data locations & audiences, Sensitive remote targets и Protected IaC scopes требуют Claude Code v2.1.195 или позже. Более ранние версии по-прежнему читают их как простой контекст, но не имеют встроенных правил, которые их нацеливают.

96 107 

97Полезный начальный шаблон: заполните поля в скобках и удалите все строки, которые не применяются.108Полезный начальный шаблон: заполните поля в скобках и удалите все строки, которые не применяются.

98 109 

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# Использование Claude Code с Chrome (бета)5# Использование Claude Code с Chrome

6 6 

7> Подключите Claude Code к браузеру Chrome для тестирования веб-приложений, отладки с помощью логов консоли, автоматизации заполнения форм и извлечения данных со страниц.7> Подключите Claude Code к браузеру Chrome для тестирования веб-приложений, отладки с помощью логов консоли, автоматизации заполнения форм и извлечения данных со страниц.

8 8 

11Claude открывает новые вкладки для задач браузера и использует состояние входа вашего браузера, поэтому он может получить доступ к любому сайту, на который вы уже вошли. Действия браузера выполняются в видимом окне Chrome в реальном времени. Когда Claude встречает страницу входа или CAPTCHA, он приостанавливается и просит вас обработать это вручную.11Claude открывает новые вкладки для задач браузера и использует состояние входа вашего браузера, поэтому он может получить доступ к любому сайту, на который вы уже вошли. Действия браузера выполняются в видимом окне Chrome в реальном времени. Когда Claude встречает страницу входа или CAPTCHA, он приостанавливается и просит вас обработать это вручную.

12 12 

13<Note>13<Note>

14 Интеграция с Chrome находится в бета-версии и в настоящее время работает с Google Chrome и Microsoft Edge. Она еще не поддерживается на Brave, Arc или других браузерах на основе Chromium. WSL (Windows Subsystem for Linux) также не поддерживается.14 Интеграция с Chrome работает с Google Chrome и Microsoft Edge. Она еще не поддерживается на Brave, Arc или других браузерах на основе Chromium. Она также не поддерживается в Windows Subsystem for Linux (WSL).

15</Note>15</Note>

16 16 

17<h2 id="capabilities">17<h2 id="capabilities">

90 90 

91Разрешения на уровне сайта наследуются из расширения Chrome. Управляйте разрешениями в параметрах расширения Chrome, чтобы контролировать, какие сайты Claude может просматривать, нажимать и вводить текст.91Разрешения на уровне сайта наследуются из расширения Chrome. Управляйте разрешениями в параметрах расширения Chrome, чтобы контролировать, какие сайты Claude может просматривать, нажимать и вводить текст.

92 92 

93<h3 id="browser-tools-in-plan-mode">

94 Инструменты браузера в режиме плана

95</h3>

96 

97В [режиме плана](/ru/permission-modes#analyze-before-you-edit-with-plan-mode) вызовы инструментов браузера, которые только читают страницу или состояние браузера, выполняются без запроса разрешения, а вызовы, которые изменяют состояние, запрашивают одобрение.

98 

99* **Вызовы только для чтения**: `read_page`, `get_page_text`, `find`, чтение сообщений консоли или сетевых запросов и создание снимка экрана

100* **Вызовы, изменяющие состояние**: клики, ввод текста, навигация, управление вкладками и окнами, а также запись GIF

101 

102Начиная с версии 2.1.199, вызов, который в остальном предназначен только для чтения, но устанавливает флаг входа, изменяющий состояние, такой как `createIfEmpty` на `tabs_context_mcp`, `clear` на средствах чтения консоли и сети или `save_to_disk` на снимке экрана, также запрашивает одобрение. Вызов `browser_batch` выполняется без запроса только в том случае, если каждое действие внутри него предназначено только для чтения.

103 

93<h2 id="example-workflows">104<h2 id="example-workflows">

94 Примеры рабочих процессов105 Примеры рабочих процессов

95</h2>106</h2>

208 219 

209При первом включении интеграции с Chrome, Claude Code устанавливает файл конфигурации хоста собственного обмена сообщениями. Chrome читает этот файл при запуске, поэтому если расширение не обнаружено при первой попытке, перезагрузите Chrome, чтобы подобрать новую конфигурацию.220При первом включении интеграции с Chrome, Claude Code устанавливает файл конфигурации хоста собственного обмена сообщениями. Chrome читает этот файл при запуске, поэтому если расширение не обнаружено при первой попытке, перезагрузите Chrome, чтобы подобрать новую конфигурацию.

210 221 

222Начиная с версии 2.1.199, Claude Code открывает вкладку браузера с предложением подключить расширение только при первой установке. Последующие сеансы, которые переписывают файл конфигурации, например после переключения сборок Claude Code или каталогов конфигурации, не открывают его повторно.

223 

211Если соединение по-прежнему не удаётся, убедитесь, что файл конфигурации хоста существует в:224Если соединение по-прежнему не удаётся, убедитесь, что файл конфигурации хоста существует в:

212 225 

213Для Chrome:226Для Chrome:

4 4 

5# Конфигурация Claude apps gateway5# Конфигурация Claude apps gateway

6 6 

7> Справочник по каждому параметру gateway.yaml: listener и TLS, OIDC, session, хранилище Postgres, upstreams Bedrock/Agent Platform/Foundry, маршрутизация моделей, управляемые политики и телеметрия.7> Справочник по каждому параметру gateway.yaml: listener и TLS, OIDC, session, хранилище Postgres, upstreams Bedrock/Claude Platform на AWS/Agent Platform/Foundry, маршрутизация моделей, управляемые политики и телеметрия.

8 8 

9Развёртывание Claude apps gateway настраивается одним файлом YAML, обычно `gateway.yaml`. Файл определяет всё, что делает gateway: где он слушает, как разработчики входят в систему, куда идёт вывод, и какие политики и телеметрия применяются. Эта страница — справочник по каждому параметру в этом файле. Чтобы написать свой первый файл, начните с [quickstart](/ru/claude-apps-gateway#quickstart), который создаёт минимальную рабочую конфигурацию и запускает её; когда у вас будет конфигурация, которой вы довольны, [руководство по развёртыванию](/ru/claude-apps-gateway-deploy) охватывает контейнеризацию и размещение на Kubernetes, Cloud Run или вашей собственной платформе.9Развёртывание Claude apps gateway настраивается одним файлом YAML, обычно `gateway.yaml`. Файл определяет всё, что делает gateway: где он слушает, как разработчики входят в систему, куда идёт вывод, и какие политики и телеметрия применяются. Эта страница — справочник по каждому параметру в этом файле.

10 

11Чтобы написать свой первый файл, начните с [quickstart](/ru/claude-apps-gateway#quickstart), который создаёт минимальную рабочую конфигурацию и запускает её. Когда у вас будет конфигурация, которой вы довольны, [руководство по развёртыванию](/ru/claude-apps-gateway-deploy) охватывает контейнеризацию и размещение на Kubernetes, Cloud Run или вашей собственной платформе.

10 12 

11Gateway читает файл один раз при запуске с помощью `claude gateway --config /path/to/gateway.yaml`. Каждый параметр проверяется по схеме при загрузке, поэтому неправильная конфигурация не запускается с ошибкой на уровне поля, а не при первом использовании.13Gateway читает файл один раз при запуске с помощью `claude gateway --config /path/to/gateway.yaml`. Каждый параметр проверяется по схеме при загрузке, поэтому неправильная конфигурация не запускается с ошибкой на уровне поля, а не при первом использовании.

12 14 

24* [`oidc`](#oidc): ваш поставщик идентификации (IdP), включая издателя, клиента, сопоставление утверждений и кто может входить26* [`oidc`](#oidc): ваш поставщик идентификации (IdP), включая издателя, клиента, сопоставление утверждений и кто может входить

25* [`session`](#session): токены-носители, которые выпускает gateway, с секретом и временем жизни27* [`session`](#session): токены-носители, которые выпускает gateway, с секретом и временем жизни

26* [`store`](#store): PostgreSQL для грантов устройств и счётчиков ограничения скорости28* [`store`](#store): PostgreSQL для грантов устройств и счётчиков ограничения скорости

27* [`upstreams`](#upstreams): куда идёт вывод, будь то Anthropic, Bedrock, Agent Platform или Foundry29* [`upstreams`](#upstreams): куда идёт вывод, будь то Anthropic, Bedrock, Claude Platform на AWS, Agent Platform или Foundry

28 30 

29**Опциональные разделы:**31**Опциональные разделы:**

30 32 

68 `oidc`70 `oidc`

69</h3>71</h3>

70 72 

71OpenID Connect (OIDC) — это протокол SSO, который gateway использует с вашим поставщиком идентификации; см. [Настройка поставщика идентификации](/ru/claude-apps-gateway-deploy#identity-provider-setup) для того, что нужно зарегистрировать на стороне IdP. Блок `oidc` подключает gateway к вашему поставщику идентификации и решает, кто может входить. Он называет издателя и клиента OAuth, сопоставляет утверждения, которые несут электронную почту и группы, и ограничивает вход по домену электронной почты или группе.73Блок `oidc` подключает gateway к вашему поставщику идентификации и решает, кто может входить. Он называет издателя и клиента OAuth, сопоставляет утверждения, которые несут электронную почту и группы, и ограничивает вход по домену электронной почты или группе.

74 

75OpenID Connect (OIDC) — это протокол SSO, который gateway использует с вашим поставщиком идентификации; см. [Настройка поставщика идентификации](/ru/claude-apps-gateway-deploy#identity-provider-setup) для того, что нужно зарегистрировать на стороне IdP.

72 76 

73| Поле | Обязательно | Описание |77| Поле | Обязательно | Описание |

74| ------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |78| ------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

121 `upstreams`125 `upstreams`

122</h3>126</h3>

123 127 

124`upstreams` — это упорядоченный список. Gateway пересылает вывод на первый upstream, который разрешает запрошенную модель. На `5xx`, `429` или timeout он переходит на следующий; другие `4xx` не переходят, потому что эти ошибки относятся к запросу, а не к upstream. Несколько upstream одного поставщика должны установить отличный `name:`.128`upstreams` — это упорядоченный список. Gateway пересылает вывод на первый upstream, который разрешает запрошенную модель. На `5xx`, `429`, `401`, `403`, `404` или timeout он переходит на следующий; другие `4xx` не переходят, потому что эти ошибки относятся к запросу, а не к upstream. `401` или `403` означает, что собственные учётные данные gateway не прошли проверку на этом upstream, а `404` означает, что этот upstream не служит запрошенной модели, поэтому более поздний upstream в списке всё ещё может.

129 

130Переход при `404` требует gateway v2.1.198 или позже. Более ранние выпуски возвращали первый `404` клиенту даже когда более поздний upstream в списке служил модели.

125 131 

126Клиенты Bedrock, Agent Platform и Foundry создаются один раз при запуске, и их SDK обновляют учётные данные внутри, поэтому ротация облачных учётных данных не требует перезагрузки. Статические ключи API Anthropic и носители читаются при запуске; см. [Anthropic API](#anthropic-api).132Несколько upstream одного поставщика должны установить отличный `name:`.

133 

134Клиенты Bedrock, Claude Platform on AWS, Agent Platform и Foundry создаются один раз при запуске, и их SDK обновляют учётные данные внутри, поэтому ротация облачных учётных данных не требует перезагрузки. Статические ключи API Anthropic и носители читаются при запуске; см. [Anthropic API](#anthropic-api).

127 135 

128<h4 id="anthropic-api">136<h4 id="anthropic-api">

129 Anthropic API137 Anthropic API

193| Где-либо ещё | Передайте учётные данные через переменные env `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` и `AWS_SESSION_TOKEN`, или установите их явно в `auth:` с расширением `${VAR}` |201| Где-либо ещё | Передайте учётные данные через переменные env `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` и `AWS_SESSION_TOKEN`, или установите их явно в `auth:` с расширением `${VAR}` |

194| Регион | `region:` — это регион конечной точки API. Профили вывода между регионами маршрутизируют по географии (США, ЕС, APAC) независимо от того, какой вы выберете. Для регионов, не входящих в США, или ARN с выделенной пропускной способностью добавьте блок [`models:`](#models) с правильными ID для каждого upstream. |202| Регион | `region:` — это регион конечной точки API. Профили вывода между регионами маршрутизируют по географии (США, ЕС, APAC) независимо от того, какой вы выберете. Для регионов, не входящих в США, или ARN с выделенной пропускной способностью добавьте блок [`models:`](#models) с правильными ID для каждого upstream. |

195 203 

204<h4 id="claude-platform-on-aws">

205 Claude Platform on AWS

206</h4>

207 

208Claude Platform on AWS служит первоклассный Anthropic API на инфраструктуре AWS в `aws-external-anthropic.<region>.api.aws`. Он использует первоклассные ID моделей, соблюдает заголовки `anthropic-beta` в том виде, в котором они отправлены, и служит `count_tokens`, поэтому никакой перевод, специфичный для Bedrock, не применяется. Поставщик `anthropicAws` требует Claude Code v2.1.198 или позже; более ранние выпуски gateway отклоняют его при загрузке.

209 

210Для развёртывания на стороне клиента той же платформы см. [Claude Code на Claude Platform on AWS](/ru/claude-platform-on-aws). Upstream на стороне gateway:

211 

212```yaml theme={null}

213upstreams:

214 - provider: anthropicAws

215 region: us-east-1

216 workspace_id: wrkspc_...

217 auth:

218 api_key: ${ANTHROPIC_AWS_API_KEY} # отправляется как x-api-key

219 # ИЛИ SigV4 через цепочку учётных данных AWS по умолчанию:

220 # auth: {}

221 # ИЛИ явные учётные данные SigV4:

222 # auth:

223 # aws_access_key_id: ${AWS_ACCESS_KEY_ID}

224 # aws_secret_access_key: ${AWS_SECRET_ACCESS_KEY}

225 # Переопределите полученную конечную точку:

226 # base_url: https://aws-external-anthropic.us-east-1.api.aws

227```

228 

229Платформа работает в отдельной учётной записи AWS от Amazon Bedrock и подписывает запросы SigV4 для собственного имени сервиса, `aws-external-anthropic`, поэтому роль IAM, ограниченная Bedrock, не авторизует её. Ключ API в `auth.api_key` имеет приоритет, когда также установлены учётные данные SigV4. Пустой блок `auth` использует цепочку учётных данных AWS SDK по умолчанию, ту же цепочку, которую использует upstream [Amazon Bedrock](#amazon-bedrock).

230 

231| Поле | Обязательно | Описание |

232| ------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------ |

233| `region` | Да | Регион AWS, строчные буквы, цифры и дефисы. Gateway получает конечную точку из него как `https://aws-external-anthropic.<region>.api.aws`. |

234| `workspace_id` | Да | Отправляется как заголовок на каждый запрос; платформа требует это |

235| `auth.api_key` | Нет | Ключ API для платформы, отправляется как `x-api-key`. Не токен-носитель: два режима аутентификации — это ключ API или SigV4. |

236| `auth.aws_access_key_id` / `auth.aws_secret_access_key` | Нет | Явные учётные данные SigV4. Установка одного без другого не удаётся при загрузке. `auth.aws_session_token` принимается рядом с ними. |

237| `base_url` | Нет | Переопределите полученную конечную точку |

238 

239Поскольку платформа разрешает первоклассные ID моделей, встроенный каталог маршрутизирует на неё без блока [`models:`](#models). Когда вы курируете список `models:`, ключируйте запись `anthropicAws:` с первоклассным ID.

240 

196<h4 id="google-cloud-agent-platform">241<h4 id="google-cloud-agent-platform">

197 Google Cloud Agent Platform242 Google Cloud Agent Platform

198</h4>243</h4>

255 300 

256Один и тот же поставщик может появляться более одного раза с отличным `name:`. Это охватывает разные регионы, разные учётные записи через разные цепочки учётных данных, выделенную пропускную способность в сравнении с по требованию и кросс-провайдерный fallback.301Один и тот же поставщик может появляться более одного раза с отличным `name:`. Это охватывает разные регионы, разные учётные записи через разные цепочки учётных данных, выделенную пропускную способность в сравнении с по требованию и кросс-провайдерный fallback.

257 302 

258Gateway пробует upstream по порядку. `5xx`, `429`, timeout и отсутствие конечной точки (`501`) переходят; другие `4xx` не переходят. `429` — это пропускная способность для каждого upstream, поэтому истощение выделенной пропускной способности (PT) переходит на по требованию. Upstream, который не может разрешить запрошенную модель, пропускается без сетевого раундтрипа.303Gateway пробует upstream по порядку. `5xx`, `429`, `401`, `403`, `404`, timeout и отсутствие конечной точки (`501`) переходят; другие `4xx` не переходят.

304 

305`429` — это пропускная способность для каждого upstream, поэтому истощение выделенной пропускной способности (PT) переходит на по требованию. `404` — это доступность модели для каждого upstream, поэтому upstream, который не включил модель, не блокирует более поздний upstream, который её служит. Upstream, который не может разрешить запрошенную модель, пропускается без сетевого раундтрипа.

259 306 

260Этот пример маршрутизирует выделенное выделение пропускной способности Bedrock в первую очередь, переполнение на по требованию и вторую учётную запись, и переходит на Anthropic API в последнюю очередь:307Этот пример маршрутизирует выделенное выделение пропускной способности Bedrock в первую очередь, переполнение на по требованию и вторую учётную запись, и переходит на Anthropic API в последнюю очередь:

261 308 

513* `sandbox.network.allowManagedDomainsOnly` и `sandbox.filesystem.allowManagedReadPathsOnly`: когда заблокированы, соответствующие списки разрешений объединяются между источниками560* `sandbox.network.allowManagedDomainsOnly` и `sandbox.filesystem.allowManagedReadPathsOnly`: когда заблокированы, соответствующие списки разрешений объединяются между источниками

514* [`allowAllClaudeAiMcps`](/ru/settings#available-settings): переопределение разрешения только для списка разрешений MCP claude.ai561* [`allowAllClaudeAiMcps`](/ru/settings#available-settings): переопределение разрешения только для списка разрешений MCP claude.ai

515* `sandbox.bwrapPath` и `sandbox.socatPath`: пути файловой системы к вспомогательным двоичным файлам [sandbox](/ru/sandboxing)562* `sandbox.bwrapPath` и `sandbox.socatPath`: пути файловой системы к вспомогательным двоичным файлам [sandbox](/ru/sandboxing)

563* [`forceRemoteSettingsRefresh`](/ru/server-managed-settings): блокирует запуск до тех пор, пока удалённые управляемые параметры не будут свежо получены, поэтому политика MDM или файла, которая её устанавливает, соблюдается даже когда кэшированный удалённый payload, в котором отсутствует ключ, является источником с наивысшим приоритетом

516 564 

517Каждый другой ключ, включая `allowManagedPermissionRulesOnly` и `disableBypassPermissionsMode`, поступает только из источника с наивысшим приоритетом. См. [Приоритет параметров](/ru/settings#settings-precedence) для того же правила на странице параметров.565Каждый другой ключ, включая `allowManagedPermissionRulesOnly` и `disableBypassPermissionsMode`, поступает только из источника с наивысшим приоритетом. См. [Приоритет параметров](/ru/settings#settings-precedence) для того же правила на странице параметров.

518 566 

580| `limits` | `max_request_bytes` | 32 MiB | Максимальный входящий размер тела запроса; запросы большего размера получают `413` перед буферизацией тела. Повысьте для больших запросов файлов или изображений. |628| `limits` | `max_request_bytes` | 32 MiB | Максимальный входящий размер тела запроса; запросы большего размера получают `413` перед буферизацией тела. Повысьте для больших запросов файлов или изображений. |

581| `limits` | `max_request_header_bytes` | не установлено | Когда установлено, заголовки большего размера возвращают `431` |629| `limits` | `max_request_header_bytes` | не установлено | Когда установлено, заголовки большего размера возвращают `431` |

582| `limits` | `max_url_length` | не установлено | Когда установлено, слишком длинный URL возвращает `414` |630| `limits` | `max_url_length` | не установлено | Когда установлено, слишком длинный URL возвращает `414` |

583| `timeouts` | `upstream_ttfb_ms` | 120000 | Максимальное ожидание заголовков ответа upstream (время до первого байта). Тело ответа затем потоком без ограничения по стене часов. Применяется к прямому пути upstream Anthropic; Bedrock, Agent Platform и Foundry ограничены собственным timeout SDK поставщика. |631| `timeouts` | `upstream_ttfb_ms` | 120000 | Максимальное ожидание заголовков ответа upstream (время до первого байта). Тело ответа затем потоком без ограничения по стене часов. Применяется к прямому пути upstream Anthropic; каждый другой поставщик ограничен собственным timeout SDK поставщика. |

584| `rate_limits` | `device_authorization.max` / `.window_seconds` | 30 / 600 | Ограничение скорости по IP на неаутентифицированной конечной точке авторизации устройства. Повысьте для большой организации за общим исходящим IP или NAT. Эти ограничения применяются только к потоку входа грантов устройств, а не к выводу `/v1/messages`. См. [Сопротивление перебору пользовательского кода](/ru/claude-apps-gateway-deploy#user-code-brute-force-resistance). |632| `rate_limits` | `device_authorization.max` / `.window_seconds` | 30 / 600 | Ограничение скорости по IP на неаутентифицированной конечной точке авторизации устройства. Повысьте для большой организации за общим исходящим IP или NAT. Эти ограничения применяются только к потоку входа грантов устройств, а не к выводу `/v1/messages`. См. [Сопротивление перебору пользовательского кода](/ru/claude-apps-gateway-deploy#user-code-brute-force-resistance). |

585| `rate_limits` | `device_verify.max` / `.window_seconds` | 10 / 600 | Ограничение скорости по IP на отправки `user_code` в `/device` |633| `rate_limits` | `device_verify.max` / `.window_seconds` | 10 / 600 | Ограничение скорости по IP на отправки `user_code` в `/device` |

586 634 

662 # region: us-east-1710 # region: us-east-1

663 # auth: {}711 # auth: {}

664 712 

713 # - provider: anthropicAws

714 # region: us-east-1

715 # workspace_id: wrkspc_...

716 # auth:

717 # api_key: ${ANTHROPIC_AWS_API_KEY}

718 

665 # - provider: vertex719 # - provider: vertex

666 # region: us-east5720 # region: us-east5

667 # project_id: example-prod721 # project_id: example-prod

678 upstream_model:732 upstream_model:

679 anthropic: claude-opus-4-8733 anthropic: claude-opus-4-8

680 # bedrock: us.anthropic.claude-opus-4-8734 # bedrock: us.anthropic.claude-opus-4-8

735 # anthropicAws: claude-opus-4-8

681 # vertex: claude-opus-4-8736 # vertex: claude-opus-4-8

682 # foundry: <your-opus-deployment-name>737 # foundry: <your-opus-deployment-name>

683 - id: claude-sonnet-4-6738 - id: claude-sonnet-4-6

97<Note>97<Note>

98 **Workload identity**98 **Workload identity**

99 99 

100 Предпочитайте workload identity платформы вместо статических ключей: IRSA на EKS для Bedrock, Workload Identity на GKE для Agent Platform и workload identity на AKS для Foundry. Установите `auth: {}` в блоке upstream или `use_azure_ad: true` для Foundry, и шлюз подхватывает идентификацию pod через цепь учетных данных по умолчанию этого поставщика. Для кросс-облачного сопряжения, такого как upstream Bedrock на GKE, установите явные учетные данные в блоке `auth` upstream вместо этого. [Справочник `upstreams`](/ru/claude-apps-gateway-config#upstreams) имеет детали настройки для каждой платформы.100 Предпочитайте workload identity платформы вместо статических ключей: IRSA на EKS для Bedrock и для Claude Platform на AWS, Workload Identity на GKE для Agent Platform и workload identity на AKS для Foundry. Установите `auth: {}` в блоке upstream или `use_azure_ad: true` для Foundry, и шлюз подхватывает идентификацию pod через цепь учетных данных по умолчанию этого поставщика. Для кросс-облачного сопряжения, такого как upstream Bedrock на GKE, установите явные учетные данные в блоке `auth` upstream вместо этого. [Справочник `upstreams`](/ru/claude-apps-gateway-config#upstreams) имеет детали настройки для каждой платформы.

101</Note>101</Note>

102 102 

103<h3 id="cloud-run">103<h3 id="cloud-run">

723Телепортирование проверяет эти требования перед возобновлением сессии. Если какое-либо требование не выполнено, вы увидите ошибку или будете приглашены разрешить проблему.723Телепортирование проверяет эти требования перед возобновлением сессии. Если какое-либо требование не выполнено, вы увидите ошибку или будете приглашены разрешить проблему.

724 724 

725| Требование | Детали |725| Требование | Детали |

726| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |726| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

727| Чистое состояние git | Ваш рабочий каталог должен не иметь незафиксированных изменений. Телепортирование предложит вам спрятать изменения, если необходимо. |727| Чистое состояние git | Ваш рабочий каталог должен не иметь незафиксированных изменений. Телепортирование предложит вам спрятать изменения, если необходимо. |

728| Правильный репозиторий | Вы должны запустить `--teleport` из проверки того же репозитория, не форка. |728| Правильный репозиторий | Вы должны запустить `--teleport` из проверки того же репозитория, не форка. {/* min-version: 2.1.199 */}Начиная с версии v2.1.199, Claude Code принимает проверку даже когда он не может разобрать удалённый сервер в имя хоста, такое как псевдоним SSH хоста, как `git@work:owner/repo.git` или переписанная форма `insteadOf`. Он показывает подтверждающий запрос сначала, и только когда владелец удалённого сервера и имя репозитория совпадают с репозиторием сессии. |

729| Доступность ветки | Ветка из облачной сессии должна быть отправлена на удалённый сервер. Телепортирование автоматически получает и проверяет её. |729| Доступность ветки | Ветка из облачной сессии должна быть отправлена на удалённый сервер. Телепортирование автоматически получает и проверяет её. |

730| Один и тот же аккаунт | Вы должны быть аутентифицированы на том же аккаунте claude.ai, который использовался в облачной сессии. |730| Один и тот же аккаунт | Вы должны быть аутентифицированы на том же аккаунте claude.ai, который использовался в облачной сессии. |

731 731 

230 230 

231Для CI и автоматизации дайте средству выполнения роль IAM с разрешением на вызов сервиса Anthropic и установите `AWS_REGION`. Цепочка учетных данных автоматически подхватывает роль.231Для CI и автоматизации дайте средству выполнения роль IAM с разрешением на вызов сервиса Anthropic и установите `AWS_REGION`. Цепочка учетных данных автоматически подхватывает роль.

232 232 

233Если ваши учетные данные SSO истекают во время сеанса, настройте [`awsAuthRefresh`](/ru/amazon-bedrock#advanced-credential-configuration), чтобы Claude Code повторно запустил вашу команду входа и повторил попытку вместо сбоя. Добавьте команду в ваш `settings.json`:233Если ваши учетные данные SSO истекают во время сеанса, настройте [`awsAuthRefresh`](/ru/amazon-bedrock#advanced-credential-configuration), чтобы Claude Code повторно запустил вашу команду входа и повторил попытку вместо сбоя. Автоматическое обновление на Claude Platform on AWS требует Claude Code v2.1.198 или более поздней версии; более ранние версии останавливаются с подсказкой запустить `/login`, что не может обновить учетные данные AWS. Добавьте команду в ваш `settings.json`:

234 234 

235```json theme={null}235```json theme={null}

236{236{

47 47 

48Если вы неправильно введете подкоманду, Claude Code предложит ближайшее совпадение и выйдет без запуска сеанса. Например, `claude udpate` выводит `Did you mean claude update?`.48Если вы неправильно введете подкоманду, Claude Code предложит ближайшее совпадение и выйдет без запуска сеанса. Например, `claude udpate` выводит `Did you mean claude update?`.

49 49 

50{/* min-version: 2.1.199 */}Начиная с версии v2.1.199, `claude --dangerously-skip-permissions daemon <subcommand>` запускает подкоманду `daemon`. В более ранних версиях `daemon <subcommand>` рассматривалась как приглашение для нового интерактивного сеанса, поэтому подкоманда никогда не запускалась, когда флаг шел первым, что является распространенной настройкой, когда `claude` имеет псевдоним, включающий флаг. Только ведущий `--dangerously-skip-permissions` или `--allow-dangerously-skip-permissions` маршрутизирует к `daemon` таким образом; любой другой ведущий флаг по-прежнему запускает интерактивный сеанс.

51 

50<h2 id="cli-flags">52<h2 id="cli-flags">

51 Флаги CLI53 Флаги CLI

52</h2>54</h2>

66| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Отрендерить вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Принудительно использует классический рендерер, поэтому параметр [`tui`](/ru/settings#available-settings) не имеет эффекта для сеанса. Имеет приоритет над [`CLAUDE_AX_SCREEN_READER`](/ru/env-vars) и параметром [`axScreenReader`](/ru/settings#available-settings). Требует Claude Code v2.1.181 или позже | `claude --ax-screen-reader` |68| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Отрендерить вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Принудительно использует классический рендерер, поэтому параметр [`tui`](/ru/settings#available-settings) не имеет эффекта для сеанса. Имеет приоритет над [`CLAUDE_AX_SCREEN_READER`](/ru/env-vars) и параметром [`axScreenReader`](/ru/settings#available-settings). Требует Claude Code v2.1.181 или позже | `claude --ax-screen-reader` |

67| `--bare` | Минимальный режим: пропустить автоматическое обнаружение hooks, skills, plugins, MCP серверов, автоматической памяти и CLAUDE.md, чтобы скриптовые вызовы начинались быстрее. Claude имеет доступ к инструментам Bash, чтения файлов и редактирования файлов. Устанавливает [`CLAUDE_CODE_SIMPLE`](/ru/env-vars). См. [bare mode](/ru/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |69| `--bare` | Минимальный режим: пропустить автоматическое обнаружение hooks, skills, plugins, MCP серверов, автоматической памяти и CLAUDE.md, чтобы скриптовые вызовы начинались быстрее. Claude имеет доступ к инструментам Bash, чтения файлов и редактирования файлов. Устанавливает [`CLAUDE_CODE_SIMPLE`](/ru/env-vars). См. [bare mode](/ru/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

68| `--betas` | Заголовки бета-версии для включения в запросы API (только для пользователей API-ключей) | `claude --betas interleaved-thinking` |70| `--betas` | Заголовки бета-версии для включения в запросы API (только для пользователей API-ключей) | `claude --betas interleaved-thinking` |

69| `--bg`, `--background` | Запустить сеанс как [фоновый агент](/ru/agent-view) и вернуться немедленно. Выводит ID сеанса и команды управления. Комбинируйте с `--exec` для запуска команды shell как фонового задания вместо сеанса Claude, или с `--agent` для запуска конкретного subagent | `claude --bg "investigate the flaky test"` |71| `--bg`, `--background` | Запустить сеанс как [фоновый агент](/ru/agent-view) и вернуться немедленно. Выводит ID сеанса и команды управления. Комбинируйте с `--exec` для запуска команды shell как фонового задания вместо сеанса Claude, или с `--agent` для запуска конкретного subagent. {/* min-version: 2.1.198 */}Не может быть скомбинирован с `-p`/`--print`; см. [справочник ошибок](/ru/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |

70| `--channels` | (Исследовательский предпросмотр) MCP серверы, чьи уведомления [channel](/ru/channels) Claude должен слушать в этом сеансе. Разделенный пробелом список записей `plugin:<name>@<marketplace>`. Требует аутентификацию Claude.ai | `claude --channels plugin:my-notifier@my-marketplace` |72| `--channels` | (Исследовательский предпросмотр) MCP серверы, чьи уведомления [channel](/ru/channels) Claude должен слушать в этом сеансе. Разделенный пробелом список записей `plugin:<name>@<marketplace>`. Требует аутентификацию Claude.ai | `claude --channels plugin:my-notifier@my-marketplace` |

71| `--chrome` | Включить [интеграцию браузера Chrome](/ru/chrome) для веб-автоматизации и тестирования | `claude --chrome` |73| `--chrome` | Включить [интеграцию браузера Chrome](/ru/chrome) для веб-автоматизации и тестирования | `claude --chrome` |

72| `--continue`, `-c` | Загрузить самую последнюю беседу в текущем каталоге. Включает сеансы, которые добавили этот каталог с помощью `/add-dir` | `claude --continue` |74| `--continue`, `-c` | Загрузить самую последнюю беседу в текущем каталоге. Включает сеансы, которые добавили этот каталог с помощью `/add-dir` | `claude --continue` |

100| `--no-session-persistence` | Отключить сохранение сеанса, чтобы сеансы не сохранялись на диск и не могли быть возобновлены. Только режим печати. Переменная окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ru/env-vars) делает то же самое в любом режиме | `claude -p --no-session-persistence "query"` |102| `--no-session-persistence` | Отключить сохранение сеанса, чтобы сеансы не сохранялись на диск и не могли быть возобновлены. Только режим печати. Переменная окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ru/env-vars) делает то же самое в любом режиме | `claude -p --no-session-persistence "query"` |

101| `--output-format` | Указать формат вывода для режима печати (опции: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |103| `--output-format` | Указать формат вывода для режима печати (опции: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |

102| `--permission-mode` | Начать в указанном [режиме разрешения](/ru/permission-modes). Принимает `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` или `bypassPermissions`. Переопределяет `defaultMode` из файлов параметров | `claude --permission-mode plan` |104| `--permission-mode` | Начать в указанном [режиме разрешения](/ru/permission-modes). Принимает `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` или `bypassPermissions`. Переопределяет `defaultMode` из файлов параметров | `claude --permission-mode plan` |

103| `--permission-prompt-tool` | Указать инструмент MCP для обработки запросов разрешения в неинтерактивном режиме | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |105| `--permission-prompt-tool` | Указать инструмент MCP для обработки запросов разрешения в неинтерактивном режиме. {/* min-version: 2.1.199 */}Начиная с v2.1.199, инструмент приглашения не может одобрить инструмент MCP, отмеченный как [требующий взаимодействия пользователя](/ru/mcp#require-approval-for-a-specific-tool): результат `allow` для одного преобразуется в отрицание | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

104| `--plugin-dir` | Загрузить plugin из каталога или архива `.zip` только для этого сеанса. Каждый флаг принимает один путь. Повторите флаг для нескольких plugins: `--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |106| `--plugin-dir` | Загрузить plugin из каталога или архива `.zip` только для этого сеанса. Каждый флаг принимает один путь. Повторите флаг для нескольких plugins: `--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |

105| `--plugin-url` | Получить plugin архив `.zip` из URL только для этого сеанса. Повторите флаг для нескольких plugins или передайте разделенные пробелом URL в одном значении в кавычках | `claude --plugin-url https://example.com/plugin.zip` |107| `--plugin-url` | Получить plugin архив `.zip` из URL только для этого сеанса. Повторите флаг для нескольких plugins или передайте разделенные пробелом URL в одном значении в кавычках | `claude --plugin-url https://example.com/plugin.zip` |

106| `--print`, `-p` | Вывести ответ без интерактивного режима (см. [документацию Agent SDK](/ru/agent-sdk/overview) для деталей программного использования) | `claude -p "query"` |108| `--print`, `-p` | Вывести ответ без интерактивного режима (см. [документацию Agent SDK](/ru/agent-sdk/overview) для деталей программного использования) | `claude -p "query"` |

10 10 

11Введите `/` для просмотра всех доступных вам команд или введите `/` с последующими буквами для фильтрации.11Введите `/` для просмотра всех доступных вам команд или введите `/` с последующими буквами для фильтрации.

12 12 

13Команда распознается только в начале вашего сообщения. Текст, который следует за названием команды, передается ей в качестве аргументов.13Команда распознается только в начале вашего сообщения. Текст, который следует за названием команды, передается ей в качестве аргументов. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, [skills](/ru/skills#pass-arguments-to-skills) являются исключением: вызов skill, за которым следуют другие skills, такие как `/skill-a /skill-b do XYZ`, загружает каждый skill, указанный в начале, и передает завершающий текст каждому в качестве аргументов. Можно объединить до шести skills.

14 14 

15<h2 id="commands-across-a-typical-workflow">15<h2 id="commands-across-a-typical-workflow">

16 Команды в типичном рабочем процессе16 Команды в типичном рабочем процессе

18 18 

19Большинство команд полезны в определенной точке сеанса, от настройки проекта до отправки изменения.19Большинство команд полезны в определенной точке сеанса, от настройки проекта до отправки изменения.

20 20 

21**Первый сеанс в репозитории.** Запустите `/init` для создания стартового `CLAUDE.md`, затем `/memory` для его уточнения. Используйте `/mcp` и `/agents` для настройки любых серверов или subagents, которые нужны проекту, и `/permissions` для установки правил одобрения, которые вы хотите.21**Первый сеанс в репозитории.** Запустите `/init` для создания стартового `CLAUDE.md`, затем `/memory` для его уточнения. Используйте `/mcp` для настройки любых серверов, которые нужны проекту, попросите Claude создать любых [subagents](/ru/sub-agents), которые вам нужны, и запустите `/permissions` для установки правил одобрения.