SpyBara
Go Premium

Documentation 2026-09-18 23:58 UTC to 2026-09-19 23:57 UTC

14 files changed +963 −687. View all changes and history on the product overview
2026
Fri 25 23:58 Thu 24 22:57 Wed 23 23:57 Tue 22 23:59 Mon 21 22:59 Sun 20 23:59 Sat 19 23:57 Fri 18 23:58 Tue 15 23:58 Mon 14 22:58 Sun 13 21:00 Sat 12 03:02 Thu 10 23:00 Wed 9 22:58 Tue 8 20:00 Tue 1 21:02
Details

481Объект конфигурации для функции `query()`.481Объект конфигурации для функции `query()`.

482 482 

483| Свойство | Тип | По умолчанию | Описание |483| Свойство | Тип | По умолчанию | Описание |

484| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |484| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

485| `abortController` | `AbortController` | `new AbortController()` | Контроллер для отмены операций |485| `abortController` | `AbortController` | `new AbortController()` | Контроллер для отмены операций |

486| `additionalDirectories` | `string[]` | `[]` | Дополнительные директории, к которым Claude может получить доступ. SDK передаёт каждую запись в Claude Code как `--add-dir`, поэтому с параметром `project` Claude Code также [загружает skills, команды и подагентов директории](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) |486| `additionalDirectories` | `string[]` | `[]` | Дополнительные каталоги, к которым Claude может получить доступ. SDK передает каждую запись в Claude Code как `--add-dir`, поэтому с параметром `project` source Claude Code также [загружает навыки, команды и подагентов каталога](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) |

487| `agent` | `string` | `undefined` | Имя агента для основного потока. Агент должен быть определён в опции `agents` или в настройках |487| `agent` | `string` | `undefined` | Имя агента для основного потока. Агент должен быть определен в параметре `agents` или в параметрах |

488| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | Программно определите подагентов |488| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | Программно определите подагентов |

489| `agentProgressSummaries` | `boolean` | `false` | Когда `true`, генерируйте однострочные сводки прогресса для подагентов и пересылайте их на события [`task_progress`](#sdktaskprogressmessage) через поле `summary`. Применяется к подагентам переднего плана и фонового режима |489| `agentProgressSummaries` | `boolean` | `false` | Когда `true`, генерирует однострочные сводки прогресса для подагентов и пересылает их на события [`task_progress`](#sdktaskprogressmessage) через поле `summary`. Применяется к подагентам переднего плана и фонового режима |

490| `allowDangerouslySkipPermissions` | `boolean` | `false` | Включите обход разрешений. Требуется при использовании `permissionMode: 'bypassPermissions'` при запуске или позже через `setPermissionMode()`. См. [plan mode](/docs/ru/agent-sdk/permissions#plan-mode-plan) для того, как это взаимодействует с `permissionMode: 'plan'` |490| `allowDangerouslySkipPermissions` | `boolean` | `false` | Включить обход разрешений. Требуется при использовании `permissionMode: 'bypassPermissions'`, при запуске или позже через `setPermissionMode()`. См. [режим плана](/docs/ru/agent-sdk/permissions#plan-mode-plan) для взаимодействия с `permissionMode: 'plan'` |

491| `allowedTools` | `string[]` | `[]` | Инструменты для автоматического одобрения без запроса. Это не ограничивает Claude только этими инструментами. Если вы назовёте один из [инструментов отслеживания задач](/docs/ru/agent-sdk/todo-tracking#model-availability) здесь, Claude Code также выбирает сессию. Другие неперечисленные инструменты переходят к `permissionMode` и `canUseTool`. Используйте `disallowedTools` для блокировки инструментов. См. [Разрешения](/docs/ru/agent-sdk/permissions#allow-and-deny-rules) |491| `allowedTools` | `string[]` | `[]` | Инструменты для автоматического одобрения без запроса. Это не ограничивает Claude только этими инструментами. Если вы назовете один из [инструментов отслеживания задач](/docs/ru/agent-sdk/todo-tracking#model-availability) здесь, Claude Code также включит сеанс. Другие неуказанные инструменты переходят к `permissionMode` и `canUseTool`. Используйте `disallowedTools` для блокировки инструментов. См. [Разрешения](/docs/ru/agent-sdk/permissions#allow-and-deny-rules) |

492| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | Включите бета-функции |492| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | Включить бета-функции |

493| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | Пользовательская функция разрешения, вызываемая только когда [поток разрешения](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) переходит к запросу. Не вызывается для вызовов, автоматически одобренных `allowedTools`, правилами разрешения или `permissionMode`. Правило разрешения не предварительно одобряет [действия, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves). См. [`CanUseTool`](#canusetool) для деталей |493| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | Пользовательская функция разрешений, вызываемая только когда [поток разрешений](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) переходит к запросу. Не вызывается для вызовов, автоматически одобренных `allowedTools`, правилами разрешения или `permissionMode`. Правило разрешения не предварительно одобряет [действия, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves). См. [`CanUseTool`](#canusetool) для деталей |

494| `continue` | `boolean` | `false` | Продолжите самый последний диалог |494| `continue` | `boolean` | `false` | Продолжить самый последний разговор |

495| `cwd` | `string` | `process.cwd()` | Текущая рабочая директория |495| `cwd` | `string` | `process.cwd()` | Текущий рабочий каталог |

496| `debug` | `boolean` | `false` | Включите режим отладки для процесса Claude Code |496| `debug` | `boolean` | `false` | Включить режим отладки для процесса Claude Code |

497| `debugFile` | `string` | `undefined` | Запишите журналы отладки в определённый путь файла. Неявно включает режим отладки |497| `debugFile` | `string` | `undefined` | Записать журналы отладки в определенный путь файла. Неявно включает режим отладки |

498| `disallowedTools` | `string[]` | `[]` | Инструменты для отклонения. Простое имя, такое как `"Bash"`, удаляет инструмент из контекста Claude. Правило с областью видимости, такое как `"Bash(rm *)"`, оставляет инструмент доступным и отклоняет совпадающие вызовы в каждом режиме разрешения, включая `bypassPermissions`, для команды [как написано](/docs/ru/permissions#bash-rule-limits). См. [Разрешения](/docs/ru/agent-sdk/permissions#allow-and-deny-rules) |498| `disallowedTools` | `string[]` | `[]` | Инструменты для отказа. Простое имя, такое как `"Bash"`, удаляет инструмент из контекста Claude. Правило с областью действия, такое как `"Bash(rm *)"`, оставляет инструмент доступным и отклоняет соответствующие вызовы в каждом режиме разрешений, включая `bypassPermissions`, для команды [как написано](/docs/ru/permissions#bash-rule-limits). См. [Разрешения](/docs/ru/agent-sdk/permissions#allow-and-deny-rules) |

499| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | `undefined` | Контролирует, сколько усилий Claude вкладывает в свой ответ. Работает с адаптивным мышлением для направления глубины мышления. См. [adjust the effort level](/docs/ru/model-config#adjust-effort-level) |499| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | `undefined` | Контролирует, сколько усилий Claude вкладывает в свой ответ. Работает с адаптивным мышлением для направления глубины мышления. См. [отрегулировать уровень усилий](/docs/ru/model-config#adjust-effort-level) |

500| `enableFileCheckpointing` | `boolean` | `false` | Включите отслеживание изменений файлов для перемотки. См. [File checkpointing](/docs/ru/agent-sdk/file-checkpointing) |500| `enableFileCheckpointing` | `boolean` | `false` | Включить отслеживание изменений файлов для перемотки. См. [File checkpointing](/docs/ru/agent-sdk/file-checkpointing) |

501| `env` | `Record<string, string \| undefined>` | `process.env` | Переменные окружения. Когда установлено, это заменяет окружение подпроцесса вместо объединения с `process.env`, поэтому передайте `{ ...process.env, YOUR_VAR: 'value' }` для сохранения унаследованных переменных, таких как `PATH`. См. [Handle slow or stalled API responses](#handle-slow-or-stalled-api-responses) для примера этого паттерна и [Environment variables](/docs/ru/env-vars) для переменных, которые читает базовый CLI. Установите `CLAUDE_AGENT_SDK_CLIENT_APP` для идентификации вашего приложения в заголовке User-Agent |501| `env` | `Record<string, string \| undefined>` | `process.env` | Переменные окружения. Когда установлено, это заменяет окружение подпроцесса вместо слияния с `process.env`, поэтому передайте `{ ...process.env, YOUR_VAR: 'value' }` для сохранения унаследованных переменных, таких как `PATH`. См. [Обработка медленных или зависших ответов API](#handle-slow-or-stalled-api-responses) для примера этого паттерна и [Переменные окружения](/docs/ru/env-vars) для переменных, которые читает базовый CLI. Установите `CLAUDE_AGENT_SDK_CLIENT_APP` для идентификации вашего приложения в заголовке User-Agent |

502| `executable` | `'bun' \| 'deno' \| 'node'` | Автоопределение | Среда выполнения JavaScript для использования |502| `executable` | `'bun' \| 'deno' \| 'node'` | Автоопределение | Используемая среда выполнения JavaScript |

503| `executableArgs` | `string[]` | `[]` | Аргументы для передачи исполняемому файлу |503| `executableArgs` | `string[]` | `[]` | Аргументы для передачи исполняемому файлу |

504| `extraArgs` | `Record<string, string \| null>` | `{}` | Дополнительные аргументы |504| `extraArgs` | `Record<string, string \| null>` | `{}` | Дополнительные аргументы |

505| `fallbackModel` | `string` | `undefined` | Модель для использования, если основная не работает |505| `fallbackModel` | `string` | `undefined` | Модель для использования, если основная модель не работает. Принимает список, разделенный запятыми. Для порядка и ограничения см. [Цепочки резервных моделей](/docs/ru/model-config#fallback-model-chains). Для рекомендаций см. [Выберите модель](/docs/ru/agent-sdk/configuration#choose-a-model) |

506| `forkSession` | `boolean` | `false` | При возобновлении с `resume` разветвитесь на новый ID сессии вместо продолжения исходной сессии |506| `forkSession` | `boolean` | `false` | При возобновлении с `resume` разветвить на новый ID сеанса вместо продолжения исходного сеанса |

507| `forwardSubagentText` | `boolean` | `false` | Пересылайте текст подагента и блоки мышления как сообщения ассистента и пользователя с установленным `parent_tool_use_id`, чтобы потребители могли отобразить вложенный транскрипт. Без этой опции Claude Code выдаёт блоки подагента `tool_use` и `tool_result`, но не текст или мышление. Сообщения от подагентов на каждой глубине вложенности пересылаются на Claude Code v2.1.219 и позже; до v2.1.219 появлялись только сообщения от подагентов глубины 1 |507| `forwardSubagentText` | `boolean` | `false` | Пересылать текст подагента и блоки мышления как сообщения помощника и пользователя с установленным `parent_tool_use_id`, чтобы потребители могли отобразить вложенную стенограмму. Без этого параметра Claude Code выдает блоки `tool_use` и `tool_result` подагента, но не текст или мышление. Сообщения от подагентов на каждой глубине вложенности пересылаются на Claude Code v2.1.219 и позже; до v2.1.219 появлялись только сообщения от подагентов глубины 1 |

508| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | Обратные вызовы hooks для событий |508| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | Обратные вызовы hook для событий |

509| `includeHookEvents` | `boolean` | `false` | Включите события жизненного цикла hooks в поток сообщений как [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage) и [`SDKHookResponseMessage`](#sdkhookresponsemessage). События жизненного цикла для hooks `SessionStart` и `Setup` всегда включены и не требуют этой опции. Некоторые события hooks, такие как `Notification`, `SessionEnd`, `PreCompact` и `PostCompact`, никогда не производят `SDKHookStartedMessage`, даже с этой опцией. Для этих событий Claude Code всё ещё выдаёт `SDKHookProgressMessage`, пока hook команды работает более одной секунды, и выдаёт `SDKHookResponseMessage` только когда hook [который работает в фоне](/docs/ru/hooks#run-hooks-in-the-background) завершается |509| `includeHookEvents` | `boolean` | `false` | Включить события жизненного цикла hook в поток сообщений как [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage) и [`SDKHookResponseMessage`](#sdkhookresponsemessage). События жизненного цикла для hook `SessionStart` и `Setup` всегда включены и не требуют этого параметра. Некоторые события hook, такие как `Notification`, `SessionEnd`, `PreCompact` и `PostCompact`, никогда не создают `SDKHookStartedMessage`, даже с этим параметром. Для этих событий Claude Code все еще выдает `SDKHookProgressMessage`, пока hook команды работает более одной секунды, и выдает `SDKHookResponseMessage` только когда hook [работающий в фоновом режиме](/docs/ru/hooks#run-hooks-in-the-background) завершается |

510| `includePartialMessages` | `boolean` | `false` | Включите события частичных сообщений |510| `includePartialMessages` | `boolean` | `false` | Включить события частичных сообщений |

511| `loadTimeoutMs` | `number` | `60000` | *Alpha.* Timeout в миллисекундах для каждого вызова `sessionStore.load()` и `sessionStore.listSubkeys()` во время материализации возобновления. Если адаптер не завершится в этом окне, запрос не удаётся вместо зависания. Игнорируется, когда `sessionStore` не установлен |511| `loadTimeoutMs` | `number` | `60000` | *Alpha.* Тайм-аут в миллисекундах для каждого вызова `sessionStore.load()` и `sessionStore.listSubkeys()` во время материализации возобновления. Если адаптер не разрешится в этом окне, запрос не удается вместо зависания. Игнорируется, когда `sessionStore` не установлен |

512| `managedSettings` | `Settings` | `undefined` | Настройки уровня политики, которые ваш хост-процесс предоставляет порождённой сессии. На машинах с управляемыми настройками, развёрнутыми администратором, Claude Code игнорирует эти, если только источник управляемых настроек администратора с наивысшим приоритетом не установит `parentSettingsBehavior: 'merge'`, и никогда не объединяет их, пока [`policyHelper`](/docs/ru/settings-reference#policyhelper) предоставляет управляемые настройки. Объединённые значения проходят через фильтр только для ограничения; [Restrict parent settings](/docs/ru/claude-apps-gateway#restrict-parent-settings) охватывает то, что фильтр допускает и блокировки `allowManaged*Only`. Хост, который устанавливает [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), имеет три ключа, прочитанные прямо из этой полезной нагрузки вместо этого: его [конфигурация модели](/docs/ru/model-config#restrict-model-selection) на Claude Code v2.1.222 или позже, [`modelPricing`](/docs/ru/settings-reference#modelpricing) когда ни один управляемый источник не устанавливает его на v2.1.246 или позже, и его запись `ENABLE_TOOL_SEARCH` env на v2.1.247 или позже |512| `managedSettings` | `Settings` | `undefined` | Параметры уровня политики, которые ваш хост-процесс предоставляет порожденному сеансу. На машинах с развернутыми администратором управляемыми параметрами Claude Code игнорирует их, если только источник управляемых параметров администратора с наивысшим приоритетом не установит `parentSettingsBehavior: 'merge'`, и никогда не объединяет их, пока [`policyHelper`](/docs/ru/settings-reference#policyhelper) предоставляет управляемые параметры. Объединенные значения проходят через фильтр только для ограничений; [Ограничить параметры родителя](/docs/ru/claude-apps-gateway#restrict-parent-settings) охватывает то, что допускает фильтр и блокировки `allowManaged*Only`. Хост, который устанавливает [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), имеет три ключа, прочитанные прямо из этого полезного груза: его [конфигурация модели](/docs/ru/model-config#restrict-model-selection) на Claude Code v2.1.222 или позже, [`modelPricing`](/docs/ru/settings-reference#modelpricing) когда ни один управляемый источник не устанавливает его на v2.1.246 или позже, и его запись `ENABLE_TOOL_SEARCH` env на v2.1.247 или позже |

513| `maxBudgetUsd` | `number` | `undefined` | Остановите запрос, когда оценка стоимости на стороне клиента достигнет этого значения USD. Сравнивается с той же оценкой, что и `total_cost_usd`; см. [Track cost and usage](/docs/ru/agent-sdk/cost-tracking) для предостережений точности |513| `maxBudgetUsd` | `number` | `undefined` | Остановить запрос, когда оценка стоимости на стороне клиента достигает этого значения в USD. Сравнивается с той же оценкой, что и `total_cost_usd`. Для предостережений точности и поведения сброса см. [Отслеживание стоимости и использования](/docs/ru/agent-sdk/cost-tracking) |

514| `maxThinkingTokens` | `number` | `undefined` | *Устарело:* Используйте вместо этого `thinking`. Максимальные токены для процесса мышления |514| `maxThinkingTokens` | `number` | `undefined` | *Устарело:* Используйте `thinking` вместо этого. Максимальные токены для процесса мышления |

515| `maxTurns` | `number` | `undefined` | Максимальное количество агентских ходов (раунды использования инструмента) |515| `maxTurns` | `number` | `undefined` | Максимальное количество агентивных ходов (раунды использования инструментов) |

516| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | Конфигурации MCP серверов |516| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | Конфигурации MCP сервера |

517| `model` | `string` | По умолчанию из CLI | Псевдоним модели Claude или полное имя модели. См. [accepted values and provider-specific IDs](/docs/ru/model-config#available-models) |517| `model` | `string` | По умолчанию из CLI | Псевдоним модели Claude или полное имя модели. См. [принятые значения и ID, специфичные для поставщика](/docs/ru/model-config#available-models) |

518| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | Обратный вызов для обработки запросов MCP elicitation. Вызывается, когда MCP сервер запрашивает ввод пользователя и ни один hook не обрабатывает его первым. Если не предоставлено, необработанные запросы elicitation автоматически отклоняются |518| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | Обратный вызов для обработки запросов MCP elicitation. Вызывается, когда MCP сервер запрашивает ввод пользователя и ни один hook не обрабатывает его первым. Если не предоставлено, необработанные запросы elicitation автоматически отклоняются |

519| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Определите формат вывода для результатов агента. См. [Structured outputs](/docs/ru/agent-sdk/structured-outputs) для деталей |519| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Определите формат вывода для результатов агента. См. [Структурированные выходы](/docs/ru/agent-sdk/structured-outputs) для деталей |

520| `outputStyle` | `string` | `undefined` | Не поле `Options`. Установите `outputStyle` во встроенном объекте [`settings`](/docs/ru/settings) или файле настроек вместо этого. См. [Activate an output style](/docs/ru/agent-sdk/modifying-system-prompts#activate-an-output-style) |520| `outputStyle` | `string` | `undefined` | Не поле `Options`. Установите `outputStyle` в встроенном объекте [`settings`](/docs/ru/settings) или файле параметров вместо этого. См. [Активировать стиль вывода](/docs/ru/agent-sdk/modifying-system-prompts#activate-an-output-style) |

521| `pathToClaudeCodeExecutable` | `string` | Автоопределение из встроенного нативного бинарного файла | Путь к исполняемому файлу Claude Code. Требуется только если опциональные зависимости были пропущены при установке или ваша платформа не в поддерживаемом наборе |521| `pathToClaudeCodeExecutable` | `string` | Автоматически разрешено из встроенного собственного двоичного файла | Путь к исполняемому файлу Claude Code. Требуется только если дополнительные зависимости были пропущены во время установки или ваша платформа не входит в поддерживаемый набор |

522| `permissionMode` | [`PermissionMode`](#permissionmode) | `'default'` | Режим разрешения для сессии |522| `permissionMode` | [`PermissionMode`](#permissionmode) | `'default'` | Режим разрешений для сеанса |

523| `permissionPromptToolName` | `string` | `undefined` | Имя MCP инструмента для запросов разрешения |523| `permissionPromptToolName` | `string` | `undefined` | Имя инструмента MCP для запросов разрешений |

524| `permissionPrompts` | `'host' \| 'none'` | `'host'` | Кто отвечает на запросы разрешения: `'host'` маршрутизирует их в ваш обратный вызов [`canUseTool`](#canusetool) или инструмент `permissionPromptToolName`, и `'none'` [отклоняет вызовы, которые иначе запросили бы](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated). Требует Claude Code v2.1.259 или позже |524| `permissionPrompts` | `'host' \| 'none'` | `'host'` | Кто отвечает на запросы разрешений: `'host'` маршрутизирует их на ваш обратный вызов [`canUseTool`](#canusetool) или инструмент `permissionPromptToolName`, и `'none'` [отклоняет вызовы, которые иначе запросили бы](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated). Требует Claude Code v2.1.259 или позже |

525| `persistSession` | `boolean` | `true` | Когда `false`, отключает сохранение сессии на диск. Сессии не могут быть возобновлены позже |525| `persistSession` | `boolean` | `true` | Когда `false`, отключает сохранение сеанса на диск. Сеансы не могут быть возобновлены позже |

526| `planModeInstructions` | `string` | `undefined` | Пользовательские инструкции рабочего процесса для Plan Mode. Когда `permissionMode` это `'plan'`, эта строка заменяет тело рабочего процесса режима плана по умолчанию. CLI по-прежнему оборачивает его с преамбулой принудительного соблюдения только для чтения и нижним колонтитулом протокола ExitPlanMode |526| `planModeInstructions` | `string` | `undefined` | Пользовательские инструкции рабочего процесса для режима плана. Когда `permissionMode` имеет значение `'plan'`, эта строка заменяет основной текст рабочего процесса режима плана по умолчанию. CLI по-прежнему оборачивает его с преамбулой принудительного применения только для чтения и нижним колонтитулом протокола ExitPlanMode |

527| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | Загружайте пользовательские plugins из локальных путей. См. [Plugins](/docs/ru/agent-sdk/plugins) для деталей |527| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | Загрузить пользовательские плагины из локальных путей. См. [Плагины](/docs/ru/agent-sdk/plugins) для деталей |

528| `promptSuggestions` | `boolean` | `false` | Включите предложения запросов. После хода Claude Code выдаёт сообщение `prompt_suggestion` с предсказанным следующим пользовательским запросом. Claude Code не генерирует предложение для некоторых ходов, таких как когда ваша учётная запись близка к или находится на пределе использования. См. [When Claude Code skips suggestions](/docs/ru/interactive-mode#when-claude-code-skips-suggestions) |528| `promptSuggestions` | `boolean` | `false` | Включить предложения подсказок. После хода Claude Code выдает сообщение `prompt_suggestion`, содержащее предсказанную следующую подсказку пользователя. Claude Code не генерирует предложение для некоторых ходов, например, когда ваша учетная запись близка к лимиту использования или находится на нем. См. [Когда Claude Code пропускает предложения](/docs/ru/interactive-mode#when-claude-code-skips-suggestions) |

529| `resume` | `string` | `undefined` | ID сессии для возобновления |529| `resume` | `string` | `undefined` | ID сеанса для возобновления |

530| `resumeDropsTurn` | `string` | `undefined` | С `resumeSessionAt`: UUID запроса хода, который усечённое возобновление намеревается отбросить. Claude Code отказывает в возобновлении, когда отброшенный диапазон содержит что-либо, не относящееся к этому ходу, такое как поглощённые поставленные в очередь сообщения или уведомления задач, и называет флаг `--resume-drops-turn` в сообщении отказа. Только Agent SDK и возобновления режима печати читают пару. Требует Claude Code v2.1.223 или позже |530| `resumeDropsTurn` | `string` | `undefined` | С `resumeSessionAt`: UUID подсказки хода, который усеченное возобновление намеревается отбросить. Claude Code отказывает в возобновлении, когда отброшенный диапазон содержит что-либо, не относящееся к этому ходу, такое как поглощенные сообщения в очереди или уведомления о задачах, и называет флаг `--resume-drops-turn` в сообщении об отказе. Только Agent SDK и возобновления в режиме печати читают пару. Требует Claude Code v2.1.223 или позже |

531| `resumeSessionAt` | `string` | `undefined` | Возобновите сессию в определённом UUID сообщения |531| `resumeSessionAt` | `string` | `undefined` | Возобновить сеанс в определенном UUID сообщения |

532| `sandbox` | [`SandboxSettings`](#sandboxsettings) | `undefined` | Программно настройте поведение sandbox. См. [Sandbox settings](#sandboxsettings) для деталей |532| `sandbox` | [`SandboxSettings`](#sandboxsettings) | `undefined` | Программно настройте поведение sandbox. См. [Параметры Sandbox](#sandboxsettings) для деталей |

533| `sessionId` | `string` | Автогенерируемый | Используйте определённый UUID для сессии вместо автогенерирования |533| `sessionId` | `string` | Автогенерируемый | Используйте определенный UUID для сеанса вместо автогенерации |

534| `sessionStore` | [`SessionStore`](/docs/ru/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Зеркалируйте транскрипты сессий на внешний бэкенд, чтобы любой хост мог их возобновить. См. [Persist sessions to external storage](/docs/ru/agent-sdk/session-storage) |534| `sessionStore` | [`SessionStore`](/docs/ru/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Зеркалировать стенограммы сеанса во внешний бэкэнд, чтобы другой хост мог их возобновить. См. [Сохранить сеансы во внешнее хранилище](/docs/ru/agent-sdk/session-storage) |

535| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *Alpha.* Режим flush для `sessionStore`. Игнорируется, когда `sessionStore` не установлен |535| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *Alpha.* Режим сброса для `sessionStore`. Игнорируется, когда `sessionStore` не установлен |

536| `settings` | `string \| Settings` | `undefined` | Встроенный объект [settings](/docs/ru/settings) или путь к файлу настроек. Заполняет слой flag-settings в [порядке приоритета](/docs/ru/settings#settings-precedence). Измените во время выполнения с помощью [`applyFlagSettings()`](#applyflagsettings) |536| `settings` | `string \| Settings` | `undefined` | Встроенный объект [settings](/docs/ru/settings), путь файла параметров или встроенная строка JSON. Заполняет уровень параметров флага в [порядке приоритета](/docs/ru/settings#settings-precedence). Измените во время выполнения с помощью [`applyFlagSettings()`](#applyflagsettings) |

537| `settingSources` | [`SettingSource`](#settingsource)`[]` | Значения по умолчанию CLI (все источники) | Контролируйте, какие настройки файловой системы загружать. Передайте `[]` для отключения пользовательских, проектных и локальных настроек. [Endpoint-managed policy](/docs/ru/managed-settings#delivery-mechanisms) загружается независимо; серверные управляемые настройки загружаются, когда сессия аутентифицируется с учётными данными организации на [подходящей конфигурации](/docs/ru/server-managed-settings#platform-availability). См. [Use Claude Code features](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) |537| `settingSources` | [`SettingSource`](#settingsource)`[]` | Значения по умолчанию CLI (все источники) | Контролируйте, какие параметры файловой системы загружать. Передайте `[]` для отключения параметров пользователя, проекта и локальных параметров. [Управляемая политика конечной точки](/docs/ru/managed-settings#delivery-mechanisms) загружается независимо; параметры, управляемые сервером, извлекаются, когда сеанс аутентифицируется с учетными данными организации на [подходящей конфигурации](/docs/ru/server-managed-settings#platform-availability). См. [Использование функций Claude Code](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

538| `skills` | `string[] \| 'all'` | `undefined` | Skills доступные для сессии. Передайте `'all'` для включения каждого обнаруженного skill, или список имён skills. Передавайте только точные имена. На Agent SDK v0.3.221 или позже SDK отклоняет неправильно сформированные и имена в форме подстановочных знаков с ошибкой перед запуском процесса Claude Code. Когда установлено, SDK автоматически добавляет инструмент Skill в `allowedTools`. Если вы также передаёте `tools`, включите `'Skill'` в этот список. См. [Skills](/docs/ru/agent-sdk/skills) |538| `skills` | `string[] \| 'all'` | `undefined` | Навыки, доступные для сеанса. Передайте `'all'` для включения каждого обнаруженного навыка или список имен навыков. Передавайте только точные имена. На Agent SDK v0.3.221 или позже SDK отклоняет неправильно сформированные и имена в форме подстановочных знаков с ошибкой перед запуском процесса Claude Code. Когда установлено, SDK автоматически добавляет инструмент Skill в `allowedTools`. Если вы также передаете `tools`, включите `'Skill'` в этот список. См. [Навыки](/docs/ru/agent-sdk/skills) |

539| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Пользовательская функция для запуска процесса Claude Code. Используйте для запуска Claude Code на ВМ, контейнерах или удалённых окружениях |539| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Пользовательская функция для порождения процесса Claude Code. Используйте для запуска Claude Code на виртуальных машинах, в контейнерах или удаленных окружениях |

540| `stderr` | `(data: string) => void` | `undefined` | Обратный вызов для вывода stderr |540| `stderr` | `(data: string) => void` | `undefined` | Обратный вызов для вывода stderr |

541| `strictMcpConfig` | `boolean` | `false` | Используйте только серверы, переданные в `mcpServers`, и игнорируйте проект `.mcp.json`, пользовательские настройки, MCP серверы, предоставленные plugins, и [claude.ai connectors](/docs/ru/mcp#use-mcp-servers-from-claude-ai) |541| `strictMcpConfig` | `boolean` | `false` | Используйте только серверы, переданные в `mcpServers`, и игнорируйте проект `.mcp.json`, параметры пользователя, MCP серверы, предоставленные плагинами, и [соединители claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) |

542| `systemPrompt` | `string \| string[] \| { type: 'custom'; prompt: string \| string[]; snapshot?: boolean } \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean; snapshot?: boolean }` | `undefined` (минимальный запрос) | Конфигурация системного запроса. Передайте строку для пользовательского запроса или `{ type: 'preset', preset: 'claude_code' }` для использования системного запроса Claude Code. Передайте массив строк с экспортированной константой `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` между статической и частями для каждого запроса для [кэширования статической части пользовательского запроса](/docs/ru/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt). При использовании формы объекта preset добавьте `append` для расширения его дополнительными инструкциями и установите `excludeDynamicSections: true` для перемещения контекста для каждой сессии в первое пользовательское сообщение для [лучшего переиспользования prompt-cache на разных машинах](/docs/ru/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines). Установите `snapshot: false` для перестроения запроса при каждом запросе вместо [переиспользования запроса, который сессия записала при первом запросе](/docs/ru/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session). Чтобы установить `snapshot` на пользовательском запросе, передайте форму `{ type: 'custom', prompt }`. Форма `{ type: 'custom' }` и поле `snapshot` требуют TypeScript Agent SDK v0.3.257 или позже |542| `systemPrompt` | `string \| string[] \| { type: 'custom'; prompt: string \| string[]; snapshot?: boolean } \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean; snapshot?: boolean }` | `undefined` (минимальная подсказка) | Конфигурация системной подсказки. Передайте строку для пользовательской подсказки или `{ type: 'preset', preset: 'claude_code' }` для использования системной подсказки Claude Code. Передайте массив строк с экспортированной константой `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` между статической и частями для каждого запроса для [кэширования статической части пользовательской подсказки](/docs/ru/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt). При использовании формы объекта preset добавьте `append` для расширения его дополнительными инструкциями и установите `excludeDynamicSections: true` для перемещения контекста для каждого сеанса в первое сообщение пользователя для [лучшего повторного использования кэша подсказок на разных машинах](/docs/ru/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines). Установите `snapshot: false` для перестроения подсказки при каждом запросе вместо [повторного использования подсказки, которую сеанс записал при первом запросе](/docs/ru/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session). Для установки `snapshot` на пользовательской подсказке передайте форму `{ type: 'custom', prompt }`. Форма `{ type: 'custom' }` и поле `snapshot` требуют TypeScript Agent SDK v0.3.257 или позже |

543| `taskBudget` | `{ total: number }` | `undefined` | *Alpha.* Бюджет задачи на стороне API в токенах. Когда установлено, модели сообщается её оставшийся бюджет токенов, чтобы она могла регулировать использование инструмента и завершить работу до лимита |543| `taskBudget` | `{ total: number }` | `undefined` | *Alpha.* Бюджет задач на стороне API в токенах. Когда установлено, модели сообщается оставшийся бюджет токенов, чтобы она могла контролировать использование инструментов и завершить работу перед лимитом |

544| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` для поддерживаемых моделей | Контролирует поведение мышления/рассуждения Claude. См. [`ThinkingConfig`](#thinkingconfig) для опций |544| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` для поддерживаемых моделей | Контролирует поведение мышления/рассуждения Claude. См. [`ThinkingConfig`](#thinkingconfig) для параметров |

545| `title` | `string` | `undefined` | Отображаемое название для сессии. При возобновлении через `resume` или `continue`, сохранённое название возобновляемой сессии имеет приоритет; используйте [`renameSession()`](#renamesession) для переименования существующей сессии |545| `title` | `string` | `undefined` | Отображаемое название для сеанса. При возобновлении через `resume` или `continue` сохраненное название возобновленного сеанса имеет приоритет; используйте [`renameSession()`](#renamesession) для переименования существующего сеанса |

546| `toolAliases` | `Record<string, string>` | `undefined` | Отображайте встроенные имена инструментов на имена MCP инструментов, чтобы Claude вызывал вашу реализацию MCP вместо встроенной. Например, `{ Bash: 'mcp__workspace__bash' }` |546| `toolAliases` | `Record<string, string>` | `undefined` | Сопоставьте встроенные имена инструментов с именами инструментов MCP, чтобы Claude вызывал вашу реализацию MCP вместо встроенной. Например, `{ Bash: 'mcp__workspace__bash' }` |

547| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | Конфигурация для встроенного поведения инструмента. См. [`ToolConfig`](#toolconfig) для деталей |547| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | Конфигурация для поведения встроенного инструмента. См. [`ToolConfig`](#toolconfig) для деталей |

548| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | Конфигурация инструмента. Передайте массив имён инструментов или используйте preset для получения встроенных инструментов Claude Code |548| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | Конфигурация инструмента. Передайте массив имен инструментов или используйте preset для получения инструментов Claude Code по умолчанию |

549 549 

550<h4 id="handle-slow-or-stalled-api-responses">550<h4 id="handle-slow-or-stalled-api-responses">

551 Handle slow or stalled API responses551 Обработка медленных или зависших ответов API

552</h4>552</h4>

553 553 

554Подпроцесс CLI читает несколько переменных окружения, которые контролируют timeout API и обнаружение зависания. Передайте их через опцию `env`:554Подпроцесс CLI читает несколько переменных окружения, которые контролируют тайм-ауты API и обнаружение зависания. Передайте их через параметр `env`:

555 555 

556```typescript theme={null}556```typescript theme={null}

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


569});569});

570```570```

571 571 

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

573* `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`](/docs/ru/errors#tune-retry-behavior): он повторяет ошибки ёмкости бесконечно и, на Claude Code v2.1.199 или позже, повышает значение по умолчанию для других переходящих ошибок до `300` и удаляет ограничение на эту переменную.573* `CLAUDE_CODE_MAX_RETRIES`: максимальное количество повторных попыток API. По умолчанию `10`, ограничено `15`. Каждая повторная попытка получает свое собственное окно `API_TIMEOUT_MS`, поэтому наихудшее время стены примерно `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` плюс backoff. Для автоматических запусков, которым нужно ждать более длительных сбоев, установите [`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ru/errors#tune-retry-behavior): он повторяет переходящие ошибки емкости бесконечно и, на Claude Code v2.1.199 или позже, повышает значение по умолчанию для других переходящих ошибок до `300` и удаляет ограничение на эту переменную.

574* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog зависания для подагентов. Пока watchdog потока включен, значение по умолчанию это `CLAUDE_STREAM_IDLE_TIMEOUT_MS` плюс 5 минут, что составляет `600000`, если вы не повысите эту переменную. С отключённым watchdog потока, значение по умолчанию это `600000`. До v2.1.257 значение по умолчанию всегда было `600000`.574* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: сторож зависания для подагентов. Пока сторож потока включен, значение по умолчанию — `CLAUDE_STREAM_IDLE_TIMEOUT_MS` плюс 5 минут, что составляет `600000`, если вы не повысите эту переменную. Со сторожем потока выключенным, значение по умолчанию — `600000`. До v2.1.257 значение по умолчанию всегда было `600000`.

575 575 

576 Таймер сбрасывается при каждом событии потока. При зависании Claude Code прерывает подагента и сообщает о зависании родителю. Для фонового подагента он также отмечает задачу как неудачную и прикрепляет любой частичный результат.576 Таймер сбрасывается при каждом событии потока. При зависании Claude Code прерывает подагента и сообщает о зависании родителю. Для фонового подагента он также отмечает задачу как неудачную и прикрепляет любой частичный результат.

577* `CLAUDE_ENABLE_STREAM_WATCHDOG` с `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: watchdog потока, который прерывает запрос, когда заголовки получены, но тело ответа перестаёт потоком передаваться. Watchdog включен по умолчанию для всех поставщиков; установите `CLAUDE_ENABLE_STREAM_WATCHDOG=0` для отключения. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` по умолчанию `300000` и зажимается до этого минимума. После прерывания, [Automatic retries](/docs/ru/errors#automatic-retries) охватывает то, что Claude Code делает, на основе того, как далеко прошёл ответ.577* `CLAUDE_ENABLE_STREAM_WATCHDOG` с `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: сторож потока, который прерывает запрос, когда заголовки прибыли, но тело ответа перестает потоковать. Сторож включен по умолчанию для всех поставщиков; установите `CLAUDE_ENABLE_STREAM_WATCHDOG=0` для отключения. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` по умолчанию `300000` и зажимается на этот минимум. После прерывания [Автоматические повторные попытки](/docs/ru/errors#automatic-retries) охватывает то, что Claude Code делает, на основе того, как далеко продвинулся ответ.

578 578 

579 Пока watchdog ждёт ответ, который шлюз позади `ANTHROPIC_BASE_URL` держит открытым с keep-alive пингами, хост, который устанавливает `includePartialMessages`, продолжает получать `ping` [события потока](#sdkpartialassistantmessage), поэтому читайте эти кадры как живость, а не синхронизируйте сессию на молчании. До v2.1.257 кадры останавливались через 5 минут после последнего реального события потока.579 Пока сторож ждет ответа, который шлюз позади `ANTHROPIC_BASE_URL` держит открытым с ping-пингами keep-alive, хост, который устанавливает `includePartialMessages`, продолжает получать `ping` [события потока](#sdkpartialassistantmessage), поэтому читайте эти кадры как живость, а не тайм-аут сеанса на молчании. До v2.1.257 кадры останавливались через 5 минут после последнего реального события потока.

580 580 

581<h3 id="query-object">581<h3 id="query-object">

582 `Query` object582 Объект `Query`

583</h3>583</h3>

584 584 

585Интерфейс, возвращаемый функцией `query()`.585Интерфейс, возвращаемый функцией `query()`.


628```628```

629 629 

630<h4 id="methods">630<h4 id="methods">

631 Methods631 Методы

632</h4>632</h4>

633 633 

634| Метод | Описание |634| Метод | Описание |

635| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |635| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

636| `interrupt()` | Прерывает запрос. Доступно только в режиме потока входных данных. Когда CLI объявляет возможность `interrupt_receipt_v1` в [`SDKSystemMessage.capabilities`](#sdksystemmessage), разрешается с помощью [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse), в котором перечислены сообщения, которые были в ожидании, когда прерывание прибыло. Разрешается `undefined` на CLI до v2.1.205 |636| `interrupt()` | Прерывает запрос. Доступно только в режиме потокового ввода. Когда CLI объявляет возможность `interrupt_receipt_v1` в [`SDKSystemMessage.capabilities`](#sdksystemmessage), разрешается с помощью [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse), перечисляющего сообщения, которые были в ожидании при поступлении прерывания. Разрешается `undefined` на CLI до v2.1.205 |

637| `rewindFiles(userMessageId, options?)` | Восстанавливает файлы в их состояние в указанном пользовательском сообщении. Передайте `{ dryRun: true }` для предпросмотра изменений. Требует `enableFileCheckpointing: true`. См. [File checkpointing](/docs/ru/agent-sdk/file-checkpointing) |637| `rewindFiles(userMessageId, options?)` | Восстанавливает файлы в их состояние в указанном сообщении пользователя. Передайте `{ dryRun: true }` для предварительного просмотра изменений. Требует `enableFileCheckpointing: true`. См. [File checkpointing](/docs/ru/agent-sdk/file-checkpointing) |

638| `setPermissionMode()` | Изменяет режим разрешения (доступно только в режиме потока входных данных) |638| `setPermissionMode()` | Изменяет режим разрешений (доступно только в режиме потокового ввода) |

639| `setModel()` | Изменяет модель (доступно только в режиме потока входных данных). Передача `undefined` или строки `"default"` сбрасывает на модель сессии по умолчанию |639| `setModel()` | Изменяет модель (доступно только в режиме потокового ввода). Передача `undefined` или строки `"default"` сбрасывает на [модель Claude Code по умолчанию](/docs/ru/model-config) |

640| `setMaxThinkingTokens()` | *Устарело:* Используйте вместо этого опцию `thinking`. Изменяет максимальные токены мышления. Передача `null` сбрасывает мышление к значению по умолчанию сессии: переопределение в середине сессии очищается, и мышление остаётся отключённым для сессий, у которых оно отключено |640| `setMaxThinkingTokens()` | *Устарело:* Используйте параметр `thinking` вместо этого. Изменяет максимальные токены мышления. Передача `null` сбрасывает мышление на значение по умолчанию сеанса: переопределение в середине сеанса очищается, и мышление остается отключенным для сеансов, у которых оно отключено |

641| `applyFlagSettings(settings)` | Объединяет настройки в слой flag settings сессии во время выполнения (доступно только в режиме потока входных данных). См. [`applyFlagSettings()`](#applyflagsettings) |641| `applyFlagSettings(settings)` | Объединяет параметры в уровень параметров флага сеанса во время выполнения (доступно только в режиме потокового ввода). См. [`applyFlagSettings()`](#applyflagsettings) |

642| `updateSettings(source, settings)` | Объединяет настройки в файл локальных настроек проекта, `.claude/settings.local.json`; они вступают в силу при следующем запросе. Принимает только `source: 'localSettings'` и список разрешённых ключей, в настоящее время `outputStyle`, со строковыми значениями; удаление ключа не поддерживается. Отклоняет на удалённых транспортах и в сессиях, чьи [`settingSources`](#options) исключают `local`. Требует TypeScript SDK v0.3.257 или позже, который поставляется с Claude Code v2.1.257 |642| `updateSettings(source, settings)` | Объединяет параметры в файл локальных параметров проекта, `.claude/settings.local.json`; они вступают в силу при следующем запросе. Принимает только `source: 'localSettings'` и список разрешенных ключей, в настоящее время `outputStyle`, со строковыми значениями; удаление ключа не поддерживается. Отклоняет удаленные транспорты и сеансы, чьи [`settingSources`](#options) исключают `local`. Требует TypeScript SDK v0.3.257 или позже, который поставляется с Claude Code v2.1.257 |

643| `initializationResult()` | Возвращает полный результат инициализации, включая поддерживаемые команды, модели, информацию об учётной записи и конфигурацию стиля вывода |643| `initializationResult()` | Возвращает полный результат инициализации, включая поддерживаемые команды, модели, информацию об учетной записи и конфигурацию стиля вывода |

644| `reinitialize()` | Повторно отправляет запрос управления `initialize` работающему CLI и возвращает свежий результат вместо кэшированного результата первого подключения. Используйте его после разрыва транспорта, такого как переподключение к сессии после отключения, чтобы ожидающие запросы разрешения снова достигли вашего обратного вызова `canUseTool`. Сделайте обратный вызов идемпотентным для каждого ID запроса, потому что запрос, чей ответ был потерян, отправляется снова. Требует Claude Code v2.1.195 или позже |644| `reinitialize()` | Повторно отправляет запрос управления `initialize` на работающий CLI и возвращает свежий результат вместо кэшированного результата первого подключения. Используйте его после разрыва транспорта, например, переподключение к сеансу после отключения, чтобы ожидающие запросы разрешений снова достигли вашего обратного вызова `canUseTool`. Сделайте обратный вызов идемпотентным для каждого ID запроса, потому что запрос, чей ответ был потерян, отправляется снова. Требует Claude Code v2.1.195 или позже |

645| `supportedCommands()` | Возвращает доступные команды. Начиная с Agent SDK v0.3.216 список отражает изменения команд в середине сессии; см. [`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) |645| `supportedCommands()` | Возвращает доступные команды. Из Agent SDK v0.3.216 список отражает изменения команд в середине сеанса; см. [`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) |

646| `supportedModels()` | Возвращает доступные модели с информацией отображения |646| `supportedModels()` | Возвращает доступные модели с информацией об отображении |

647| `supportedAgents()` | Возвращает доступные подагентов как [`AgentInfo`](#agentinfo)`[]` |647| `supportedAgents()` | Возвращает доступные подагентов как [`AgentInfo`](#agentinfo)`[]` |

648| `mcpServerStatus()` | Возвращает статус подключённых MCP серверов |648| `mcpServerStatus()` | Возвращает статус подключенных MCP серверов |

649| `getContextUsage(opts?)` | Возвращает [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse), разбивая использование контекстного окна сессии по категориям, skills и инструментам. С опцией `detail` по умолчанию, это те же данные, которые `/context` показывает в интерактивной сессии. Опция [`detail`](#sdkcontrolgetcontextusageresponse) требует Agent SDK v0.3.257 или позже |649| `getContextUsage(opts?)` | Возвращает [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse), разбивая использование контекстного окна сеанса по категориям, навыкам и инструментам. С параметром по умолчанию `detail`, это те же данные, которые `/context` показывает в интерактивном сеансе. Параметр [`detail`](#sdkcontrolgetcontextusageresponse) требует Agent SDK v0.3.257 или позже |

650| `readFile(path, options?)` | Читает файл из файловой системы сессии. Claude Code разрешает путь против `cwd`; [What `readFile()` can read](#what-readfile-can-read) перечисляет файлы, которые он служит. Передайте `{ maxBytes }` для изменения лимита чтения (по умолчанию 1 МБ, потолок 10 МБ) и `{ encoding: 'base64' }` для двоичных файлов, таких как изображения. Разрешается с [`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse) или `null` при отказе в разрешении, отсутствующем файле или ошибке транспорта. Требует TypeScript SDK v0.2.121 или позже |650| `readFile(path, options?)` | Читает файл из файловой системы сеанса. Claude Code разрешает путь против `cwd`; [Что `readFile()` может читать](#what-readfile-can-read) перечисляет файлы, которые он обслуживает. Передайте `{ maxBytes }` для изменения ограничения чтения (по умолчанию 1 МБ, потолок 10 МБ) и `{ encoding: 'base64' }` для двоичных файлов, таких как изображения. Разрешается с помощью [`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse) или `null` при отказе в разрешении, отсутствующем файле или ошибке транспорта. Требует TypeScript SDK v0.2.121 или позже |

651| `reloadSkills()` | Перезагружает skills с диска, поэтому skills, которые вы добавляете или редактируете в середине сессии, становятся доступны работающей сессии. Разрешается с [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse), в котором перечислены skills, доступные после перезагрузки. Требует Agent SDK v0.3.163 или позже |651| `reloadSkills()` | Перезагружает навыки с диска, поэтому навыки, которые вы добавляете или редактируете в середине сеанса, становятся доступны для работающего сеанса. Разрешается с помощью [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse), перечисляющего доступные навыки после перезагрузки. Требует Agent SDK v0.3.163 или позже |

652| `accountInfo()` | Возвращает информацию об учётной записи |652| `accountInfo()` | Возвращает информацию об учетной записи |

653| `reconnectMcpServer(serverName)` | Переподключитесь к MCP серверу по имени. Если имя также совпадает с записью в файле настроек, таком как `.mcp.json` или `~/.claude.json`, Claude Code переподключает сервер, который вы настроили через [`mcpServers`](#options) или `setMcpServers()`, а не запись файла настроек. Этот порядок разрешения требует Claude Code v2.1.257 или позже |653| `reconnectMcpServer(serverName)` | Переподключить MCP сервер по имени. Если имя также совпадает с записью в файле параметров, таком как `.mcp.json` или `~/.claude.json`, Claude Code переподключает сервер, который вы настроили через [`mcpServers`](#options) или `setMcpServers()`, а не запись файла параметров. Этот порядок разрешения требует Claude Code v2.1.257 или позже |

654| `toggleMcpServer(serverName, enabled)` | Включите или отключите MCP сервер по имени, с тем же разрешением имён, что и `reconnectMcpServer()`. Отключение отключает сервер |654| `toggleMcpServer(serverName, enabled)` | Включить или отключить MCP сервер по имени с тем же разрешением имени, что и `reconnectMcpServer()`. Отключение отключает сервер |

655| `setMcpServers(servers)` | Динамически замените набор MCP серверов для этой сессии. Разрешается с [`McpSetServersResult`](#mcpsetserversresult), в котором названы серверы, которые были добавлены и удалены, и любые ошибки |655| `setMcpServers(servers)` | Динамически замените набор MCP серверов для этого сеанса. Разрешается с помощью [`McpSetServersResult`](#mcpsetserversresult), называющего, какие серверы были добавлены и удалены, и любые ошибки |

656| `streamInput(stream)` | Потоком передавайте входные сообщения к запросу для многооборотных диалогов |656| `streamInput(stream)` | Потоковые входные сообщения в запрос для многоходовых разговоров |

657| `stopTask(taskId)` | Остановите выполняющуюся фоновую задачу по ID |657| `stopTask(taskId)` | Остановить работающую фоновую задачу по ID |

658| `close()` | Закройте запрос и завершите базовый процесс. Принудительно завершает запрос и очищает все ресурсы |658| `close()` | Закройте запрос и завершите базовый процесс. Принудительно завершает запрос и очищает все ресурсы |

659 659 

660<h4 id="applyflagsettings">660<h4 id="applyflagsettings">

661 `applyFlagSettings()`661 `applyFlagSettings()`

662</h4>662</h4>

663 663 

664Изменяет [настройки](/docs/ru/settings) на работающей сессии без перезагрузки запроса. Используйте её, когда настройка, у которой нет выделенного setter, должна измениться в середине сессии, например, ужесточение `permissions` после того, как агент прочитает ненадёжный ввод. `setModel()` и `setPermissionMode()` являются выделенными setters для этих двух ключей; `applyFlagSettings()` является общей формой, которая принимает любое подмножество ключей настроек, и передача `model` здесь ведёт себя так же, как `setModel()`.664Изменяет [параметры](/docs/ru/settings) на работающем сеансе без перезагрузки запроса. Используйте его, когда параметр, у которого нет выделенного сеттера, должен измениться в середине сеанса, например, ужесточение `permissions` после того, как агент прочитает ненадежный ввод. `setModel()` и `setPermissionMode()` — это выделенные сеттеры для этих двух ключей; `applyFlagSettings()` — это общая форма, которая принимает любое подмножество ключей параметров, и передача `model` здесь ведет себя так же, как `setModel()`.

665 665 

666Только некоторые ключи вступают в силу в середине сессии:666Только некоторые ключи вступают в силу в середине сеанса:

667 667 

668* **Применяется на следующем ходу**: `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `agent`. Переключение `agent` также применяет переопределение модели этого агента и hooks на следующем ходу. Его системный запрос применяется на следующем ходу или, в сессии, которая [переиспользует записанный системный запрос](/docs/ru/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session), один раз сессия компактна.668* **Применяется при следующем ходе**: `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `agent`. Переключение `agent` также применяет переопределение модели и hooks этого агента при следующем ходе. Его системная подсказка применяется при следующем ходе или, в сеансе, который [повторно использует записанную системную подсказку](/docs/ru/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session), после компактирования сеанса.

669* **Применяется во время текущего хода**: `model`. Если вы переключаете `model` пока Claude работает над ходом, ответ, который Claude уже генерирует, завершается на старой модели, и остаток хода, начиная со следующего вызова Claude Code к модели, использует новую. Подагенты сохраняют свою собственную модель. До v2.1.212 переключение в середине хода ждало следующего хода.669* **Применяется во время текущего хода**: `model`. Если вы переключаете `model` пока Claude работает над ходом, ответ, который Claude уже генерирует, завершается на старой модели, и остаток хода, начиная со следующего вызова Claude Code к модели, использует новую. Подагенты сохраняют свою собственную модель. До v2.1.212 переключение в середине хода ждало следующего хода.

670* **Нет эффекта в середине сессии**: опции системного запроса. Они разрешаются один раз при запуске, поэтому работающая сессия сохраняет исходное значение, даже если вызов успешен. Чтобы их изменить, запустите новую сессию.670* **Нет эффекта в середине сеанса**: параметры системной подсказки. Они разрешаются один раз при запуске, поэтому работающий сеанс сохраняет исходное значение, даже если вызов успешен. Чтобы их изменить, запустите новый сеанс.

671 671 

672`effortLevel` принимает имя [уровня усилий](/docs/ru/model-config#adjust-effort-level). Он также принимает `"ultracode"`, который запускает `xhigh` усилия с [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode) на. `applyFlagSettings()` объявляет `effortLevel` без этого значения, поэтому передайте эквивалент `{ ultracode: true }` в TypeScript. Значение `ultracode` требует Claude Code v2.1.203 или позже и принимается только `applyFlagSettings()`, а не ключом `effortLevel` в файле настроек.672`effortLevel` принимает имя [уровня усилий](/docs/ru/model-config#adjust-effort-level). Он также принимает `"ultracode"`, который запрашивает усилие `xhigh` с включенным [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode). `applyFlagSettings()` объявляет `effortLevel` без этого значения, поэтому передайте эквивалент `{ ultracode: true }` в TypeScript. Значение `ultracode` требует Claude Code v2.1.203 или позже и принимается только `applyFlagSettings()`, а не ключом `effortLevel` в файле параметров.

673 673 

674Значения записываются в слой flag-settings, тот же слой, который встроенная опция `settings` функции `query()` заполняет при запуске. Это тот же уровень, который [раздел приоритета на странице](#settings-precedence) называет программными опциями.674Значения записываются в уровень параметров флага, тот же уровень, который встроенный параметр `settings` функции `query()` заполняет при запуске. Это тот же уровень, который раздел [приоритета на странице](#settings-precedence) называет программными параметрами.

675 675 

676Последовательные вызовы выполняют shallow-merge ключей верхнего уровня. Второй вызов с `{ permissions: {...} }` заменяет весь объект `permissions` из предыдущего вызова, а не выполняет deep-merge в него. Чтобы очистить ключ из слоя flag и вернуться к источникам с более низким приоритетом, передайте `null` для этого ключа. Передача `undefined` не имеет эффекта, потому что сериализация JSON её отбрасывает.676Последовательные вызовы выполняют поверхностное слияние ключей верхнего уровня. Второй вызов с `{ permissions: {...} }` заменяет весь объект `permissions` из предыдущего вызова, а не глубоко объединяется в него. Чтобы очистить ключ из уровня флага, передайте `null` для этого ключа. Большинство ключей затем возвращаются к источникам с более низким приоритетом. Очищенный `model` сбрасывается на [модель Claude Code по умолчанию](/docs/ru/model-config), даже когда файл параметров устанавливает `model`. Передача `undefined` не имеет эффекта, потому что сериализация JSON удаляет ее.

677 677 

678Доступно только в режиме потока входных данных, то же ограничение, что и `setModel()` и `setPermissionMode()`.678Доступно только в режиме потокового ввода, то же ограничение, что и `setModel()` и `setPermissionMode()`.

679 679 

680Пример ниже переключает активную модель в середине сессии, а затем очищает переопределение, чтобы модель вернулась к тому, что указывают пользовательские или проектные настройки.680Пример ниже переключает активную модель в середине сеанса, а затем очищает переопределение, чтобы модель сбросилась на [модель Claude Code по умолчанию](/docs/ru/model-config).

681 681 

682```typescript theme={null}682```typescript theme={null}

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

684 684 

685const q = query({ prompt: messageStream });685const q = query({ prompt: messageStream });

686 686 

687// Переопределите модель для остальной части сессии687// Override the model for the rest of the session

688await q.applyFlagSettings({ model: "claude-opus-4-6" });688await q.applyFlagSettings({ model: "claude-opus-4-6" });

689 689 

690// Позже: очистите переопределение и вернитесь к настройкам с более низким приоритетом690// Later: clear the override; the model resets to Claude Code's default

691await q.applyFlagSettings({ model: null });691await q.applyFlagSettings({ model: null });

692```692```

693 693 


699 `WarmQuery`699 `WarmQuery`

700</h3>700</h3>

701 701 

702Дескриптор, возвращаемый [`startup()`](#startup). Подпроцесс уже запущен и инициализирован, поэтому вызов `query()` на этом дескрипторе записывает запрос непосредственно в готовый процесс без задержки запуска.702Дескриптор, возвращаемый [`startup()`](#startup). Подпроцесс уже порожден и инициализирован, поэтому вызов `query()` на этом дескрипторе записывает подсказку непосредственно в готовый процесс без задержки запуска.

703 703 

704```typescript theme={null}704```typescript theme={null}

705interface WarmQuery extends AsyncDisposable {705interface WarmQuery extends AsyncDisposable {


709```709```

710 710 

711<h4 id="methods-2">711<h4 id="methods-2">

712 Methods712 Методы

713</h4>713</h4>

714 714 

715| Метод | Описание |715| Метод | Описание |

716| :-------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- |716| :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- |

717| `query(prompt)` | Отправьте запрос к предварительно разогретому подпроцессу и верните [`Query`](#query-object). Может быть вызван только один раз на `WarmQuery` |717| `query(prompt)` | Отправьте подсказку на предварительно прогретый подпроцесс и верните [`Query`](#query-object). Может быть вызван только один раз для каждого `WarmQuery` |

718| `close()` | Закройте подпроцесс без отправки запроса. Используйте это для отказа от тёплого запроса, который больше не нужен |718| `close()` | Закройте подпроцесс без отправки подсказки. Используйте это для отказа от теплого запроса, который больше не нужен |

719 719 

720`WarmQuery` реализует `AsyncDisposable`, поэтому его можно использовать с `await using` для автоматической очистки.720`WarmQuery` реализует `AsyncDisposable`, поэтому его можно использовать с `await using` для автоматической очистки.

721 721 


723 `SDKControlInitializeResponse`723 `SDKControlInitializeResponse`

724</h3>724</h3>

725 725 

726Тип возврата `initializationResult()`. Содержит данные инициализации сессии.726Тип возврата `initializationResult()`. Содержит данные инициализации сеанса.

727 727 

728```typescript theme={null}728```typescript theme={null}

729type SDKControlInitializeResponse = {729type SDKControlInitializeResponse = {


739};739};

740```740```

741 741 

742`hooks_applied` сообщает, зарегистрировал ли Claude Code `hooks`, которые несёт запрос `initialize`. SDK отправляет этот запрос один раз при запуске сессии и снова при каждом вызове [`reinitialize()`](#query-object). Поле требует Agent SDK v0.3.238 или позже.742`hooks_applied` сообщает, зарегистрировал ли Claude Code `hooks`, которые несла запрос `initialize`. SDK отправляет этот запрос один раз при запуске сеанса и снова при каждом вызове [`reinitialize()`](#query-object). Поле требует Agent SDK v0.3.238 или позже.

743 743 

744Claude Code опускает поле, когда запрос не несёт hooks. Когда запрос несёт hooks, значение зависит от того, является ли запрос первой инициализацией сессии и, для повторного, как он достиг сессии:744Claude Code опускает поле, когда запрос не содержал hooks. Когда запрос содержал hooks, значение зависит от того, является ли запрос первой инициализацией сеанса и, для повторного, как он достиг сеанса:

745 745 

746* `true`: Claude Code зарегистрировал hooks. Первая инициализация сессии возвращает это значение. Так же повторная инициализация, отправленная через stdin CLI. В этом случае hooks в новом запросе заменяют hooks, зарегистрированные ранее.746* `true`: Claude Code зарегистрировал hooks. Первая инициализация сеанса возвращает это значение. Повторная инициализация, отправленная через stdin CLI, также возвращает `true`. В этом случае hooks в новом запросе заменяют hooks, зарегистрированные ранее.

747* `false`: Claude Code игнорировал hooks. Повторная инициализация, отправленная удалённой сессии, возвращает это значение, поэтому второй клиент, который присоединяется к сессии, не может заменить hooks, которые зарегистрировал первый клиент.747* `false`: Claude Code игнорировал hooks. Повторная инициализация, отправленная на удаленный сеанс, возвращает это значение, поэтому второй клиент, присоединяющийся к сеансу, не может заменить hooks, которые зарегистрировал первый клиент.

748 748 

749До Agent SDK v0.3.238 ответ никогда не нёс поле, и Claude Code игнорировал `hooks` при каждой повторной инициализации.749До Agent SDK v0.3.238 ответ никогда не содержал поле, и Claude Code игнорировал `hooks` при каждой повторной инициализации.

750 750 

751Ответ всегда сообщает `fast_mode_state`, и когда что-то блокирует [fast mode](/docs/ru/fast-mode), `fast_mode_disabled_reason` несёт код причины рядом с ним, поэтому вы можете объяснить заблокированное состояние вместо переопределения доступности. Оба поведения требуют Claude Code v2.1.219 или позже. До v2.1.219 ответ опускал `fast_mode_state`, когда fast mode не был доступен, и никогда не нёс причину. Для кодов причин и их значений см. [`fast_mode_disabled_reason`](#sdkresultmessage) на сообщении результата.751Ответ всегда сообщает `fast_mode_state`, и когда что-то блокирует [быстрый режим](/docs/ru/fast-mode), `fast_mode_disabled_reason` несет код причины рядом с ним, поэтому вы можете объяснить заблокированное состояние вместо повторного вывода доступности. Оба поведения требуют Claude Code v2.1.219 или позже. До v2.1.219 ответ опускал `fast_mode_state`, когда быстрый режим был недоступен, и никогда не содержал причину. Для кодов причин и их значений см. [`fast_mode_disabled_reason`](#sdkresultmessage) в сообщении результата.

752 752 

753Обёртка control-response для успешного `initialize` также несёт массив `pending_permission_requests`. Поле находится на самой обёртке response, а не в полезной нагрузке `SDKControlInitializeResponse` выше. Каждая запись является полным сообщением `control_request` с той же формой `{ type: "control_request", request_id, request }`, которую сессия потоком передаёт для запросов разрешения во время работы.753Оболочка управления-ответа для успешного `initialize` также содержит массив `pending_permission_requests`. Поле находится на самой оболочке ответа, а не в полезной нагрузке `SDKControlInitializeResponse` выше. Каждая запись — это полное сообщение `control_request` с той же формой `{ type: "control_request", request_id, request }`, которую сеанс потоком для запросов разрешений во время работы.

754 754 

755Массив перечисляет запросы разрешения, которые этот процесс Claude Code выдал и ещё не разрешил. SDK читает массив для вас и отправляет каждую запись в ваш обратный вызов [`canUseTool`](#canusetool), то же переотправление, которое [`reinitialize()`](#query-object) запускает после разрыва транспорта. Обрабатывайте повторяющиеся ID запросов идемпотентно, потому что запись может повторить запрос, который обратный вызов уже получил до отключения соединения.755Массив перечисляет запросы разрешений, которые этот процесс Claude Code выдал и еще не разрешил. SDK читает массив для вас и отправляет каждую запись на ваш обратный вызов [`canUseTool`](#canusetool), то же переоформление, которое [`reinitialize()`](#query-object) запускает после разрыва транспорта. Обрабатывайте повторяющиеся ID запросов идемпотентно, потому что запись может повторить запрос, который обратный вызов уже получил перед отключением соединения.

756 756 

757Массив всегда присутствует на успешном ответе `initialize` и пуст, когда этот процесс не имеет неразрешённого запроса разрешения. Требует Claude Code v2.1.268 или позже. Более ранние версии могли опустить поле, поэтому если вы анализируете протокол проводов самостоятельно, рассматривайте отсутствующее поле как более старый CLI, а не как доказательство того, что ничего не ожидает.757Массив всегда присутствует в успешном ответе `initialize` и пуст, когда этот процесс не имеет неразрешенного запроса разрешения. Требует Claude Code v2.1.268 или позже. Более ранние версии могли опустить поле, поэтому если вы анализируете протокол проводов самостоятельно, рассматривайте отсутствующее поле как более старый CLI, а не как доказательство того, что ничего не ожидается.

758 758 

759<h3 id="sdkcontrolinterruptresponse">759<h3 id="sdkcontrolinterruptresponse">

760 `SDKControlInterruptResponse`760 `SDKControlInterruptResponse`

761</h3>761</h3>

762 762 

763Квитанция прерывания: значение, которое [`interrupt()`](#query-object) разрешается с помощью на CLI, который объявляет возможность `interrupt_receipt_v1` в [`SDKSystemMessage.capabilities`](#sdksystemmessage). Требует Claude Code v2.1.205 или позже. Более ранние CLI отвечают на прерывание с пустой полезной нагрузкой успеха, поэтому `interrupt()` разрешается `undefined`.763Квитанция прерывания: значение, которое [`interrupt()`](#query-object) разрешает на CLI, который объявляет возможность `interrupt_receipt_v1` в [`SDKSystemMessage.capabilities`](#sdksystemmessage). Требует Claude Code v2.1.205 или позже. Более ранние CLI отвечают на прерывание с пустой полезной нагрузкой успеха, поэтому `interrupt()` разрешается `undefined`.

764 764 

765```typescript theme={null}765```typescript theme={null}

766type SDKControlInterruptResponse = {766type SDKControlInterruptResponse = {


769};769};

770```770```

771 771 

772`still_queued` перечисляет UUID пользовательских сообщений, которые были в ожидании, когда прерывание прибыло: сообщения всё ещё в очереди, плюс любые сообщения Claude Code уже взял из очереди для следующего хода. Один раз первый ход сессии начался, Claude Code обрабатывает перечисленные сообщения после прерывания, если вы их не отмените первым, и может объединить несколько в один ход. Если вы прерываете перед запуском первого хода, Claude Code прерывает этот ход, как только он начинается, и перечисленные сообщения в этом ходе не получают ответ.772`still_queued` перечисляет UUID пользовательских сообщений, которые были в ожидании при поступлении прерывания: сообщения все еще в очереди, плюс любые сообщения, которые Claude Code уже вынул из очереди для следующего хода. После того как первый ход сеанса начался, Claude Code обрабатывает перечисленные сообщения после прерывания, если вы их не отмените первыми, и может объединить несколько в один ход. Если вы прерываете перед началом первого хода, Claude Code прерывает этот ход, как только он начинается, и перечисленные сообщения в этом ходе не получают ответ.

773 773 

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

775 775 

776Интерпретируйте список с этими предостережениями:776Интерпретируйте список с этими предостережениями:

777 777 

778* Только сообщения, которые были поставлены в очередь с UUID, появляются. Пустой массив не означает, что ничего больше не будет работать.778* Появляются только сообщения, которые были поставлены в очередь с UUID. Пустой массив не означает, что ничего больше не будет работать.

779* Только сообщения основного потока указаны. Сообщения, адресованные подагенту, выходят за рамки.779* Перечислены только сообщения основного потока. Сообщения, адресованные подагенту, выходят за рамки.

780* Список может включать UUID, которые ваш клиент никогда не отправлял, такие как триггеры [scheduled task](/docs/ru/scheduled-tasks). Игнорируйте UUID, которые вы не узнаёте, вместо того чтобы рассматривать их как ошибку.780* Список может включать UUID, которые ваш клиент никогда не отправлял, такие как триггеры [запланированной задачи](/docs/ru/scheduled-tasks). Игнорируйте UUID, которые вы не узнаете, вместо того чтобы рассматривать их как ошибку.

781 781 

782Клиент, который управляет протоколом управления CLI напрямую, а не через `interrupt()`, может установить `cancel_queued: true` на запрос управления `interrupt`. Claude Code v2.1.219 и позже объявляет поддержку с возможностью `interrupt_cancel_queued_v1` в [`SDKSystemMessage.capabilities`](#sdksystemmessage); более ранние CLI игнорируют поле и оставляют поставленные в очередь сообщения работать как обычно. Такое прерывание также отменяет каждое сообщение, которое иначе было бы указано под `still_queued`: квитанция перечисляет их под `cancelled` вместо этого, `still_queued` пуст, и ни один из них не работает.782Клиент, который управляет протоколом управления CLI напрямую, а не через `interrupt()`, может установить `cancel_queued: true` на запрос управления `interrupt`. Claude Code v2.1.219 и позже объявляет поддержку с возможностью `interrupt_cancel_queued_v1` в [`SDKSystemMessage.capabilities`](#sdksystemmessage); более старые CLI игнорируют поле и оставляют сообщения в очереди для обычного запуска. Такое прерывание также отменяет каждое сообщение, которое иначе было бы перечислено в `still_queued`: квитанция перечисляет их в `cancelled` вместо этого, `still_queued` пуст, и ни один из них не запускается.

783 783 

784Список `cancelled` несёт те же предостережения, что и `still_queued`. Метод `interrupt()` никогда не отправляет `cancel_queued`, поэтому квитанции, которые он разрешает, не несут `cancelled`.784Список `cancelled` содержит те же предостережения, что и `still_queued`. Метод `interrupt()` никогда не отправляет `cancel_queued`, поэтому квитанции, которые он разрешает, не содержат `cancelled`.

785 785 

786Квитанция — это снимок, сделанный в момент обработки прерывания, и при чистом прерывании она прибывает до [`SDKResultMessage`](#sdkresultmessage) прерванного хода. Прочитайте квитанцию, а не проверяйте очередь после этого результата: цикл немедленно запускает следующий поставленный в очередь ход, поэтому очередь, которую вы проверяете после результата, уже изменилась.786Квитанция — это снимок, сделанный в момент обработки прерывания, и при чистом прерывании она прибывает перед [`SDKResultMessage`](#sdkresultmessage) прерванного хода. Читайте квитанцию, а не проверяйте очередь после этого результата: цикл немедленно запускает следующий ход в очереди, поэтому очередь, которую вы проверяете после результата, уже изменилась.

787 787 

788<h3 id="sdkcontrolgetcontextusageresponse">788<h3 id="sdkcontrolgetcontextusageresponse">

789 `SDKControlGetContextUsageResponse`789 `SDKControlGetContextUsageResponse`

790</h3>790</h3>

791 791 

792Тип возврата [`getContextUsage()`](#query-object). С опцией `detail` по умолчанию, это та же полезная нагрузка, которую Claude Code отображает для команды `/context` в интерактивной сессии, поэтому рядом с подсчётом токенов она несёт поля отображения, такие как `color` и `gridRows`, которые Claude Code использует для рисования сетки использования `/context`.792Тип возврата [`getContextUsage()`](#query-object). С параметром по умолчанию `detail`, это та же полезная нагрузка, которую Claude Code отображает для команды `/context` в интерактивном сеансе, поэтому наряду с подсчетом токенов она содержит поля отображения, такие как `color` и `gridRows`, которые Claude Code использует для рисования сетки использования `/context`.

793 793 

794Аргумент `detail` метода выбирает, как Claude Code подсчитывает каждую категорию. С опцией по умолчанию, `'full'`, Claude Code подсчитывает каждую категорию с запросами API подсчёта токенов. Передайте `{ detail: 'summary' }` для получения ответа из использования последнего ответа и локальных оценок вместо этого. Никакие запросы подсчёта токенов не выходят, и числа для каждой категории приблизительны. Аргумент `detail` требует Agent SDK v0.3.257 или позже.794Аргумент `detail` метода выбирает, как Claude Code подсчитывает каждую категорию. С параметром по умолчанию `'full'`, Claude Code подсчитывает каждую категорию с запросами API подсчета токенов. Передайте `{ detail: 'summary' }` для получения ответа из использования последнего ответа и локальных оценок вместо этого. Никакие запросы подсчета токенов не выходят, и числа для каждой категории приблизительны. Аргумент `detail` требует Agent SDK v0.3.257 или позже.

795 795 

796Когда вы отправляете `/context` как запрос вместо вызова метода, Claude Code прикрепляет полезную нагрузку [`SDKContextUsage`](#sdkcontextusage) к полю `context_usage` сообщения ассистента, которое доставляет результат. Это поле требует Agent SDK v0.3.232 или позже.796Когда вы отправляете `/context` как подсказку вместо вызова метода, Claude Code прикрепляет полезную нагрузку [`SDKContextUsage`](#sdkcontextusage) к полю `context_usage` сообщения помощника, которое доставляет результат. Это поле требует Agent SDK v0.3.232 или позже.

797 797 

798```typescript theme={null}798```typescript theme={null}

799type SDKControlGetContextUsageResponse = {799type SDKControlGetContextUsageResponse = {


892Читайте атрибуцию токенов из полей коллекции:892Читайте атрибуцию токенов из полей коллекции:

893 893 

894* `categories` содержит итоги для каждой категории.894* `categories` содержит итоги для каждой категории.

895* `mcpTools` и `agents` атрибутируют токены отдельным MCP инструментам и подагентам.895* `mcpTools` и `agents` атрибутируют токены отдельным инструментам MCP и подагентам.

896* `memoryFiles` перечисляет каждый загруженный файл памяти с его стоимостью.896* `memoryFiles` перечисляет каждый загруженный файл памяти с его стоимостью.

897* `skills.skillFrontmatter` атрибутирует токены listing skills каждому включённому skill. Подсчёты для каждого skill измеряют запись listing каждого skill, как Claude Code фактически её отправляет, что может быть короче, чем полный frontmatter skill. Сравните `skills.totalSkills` с `skills.includedSkills`, чтобы увидеть, попал ли каждый обнаруженный skill в listing.897* `skills.skillFrontmatter` атрибутирует токены списка навыков каждому включенному навыку. Подсчеты для каждого навыка измеряют запись каждого навыка, как Claude Code фактически отправляет ее, что может быть короче полного frontmatter навыка. Сравните `skills.totalSkills` с `skills.includedSkills`, чтобы увидеть, попал ли каждый обнаруженный навык в список.

898 898 

899`totalTokens` это текущее использование контекста сессии, и `maxTokens` это окно, против которого измеряется использование. Это окно это контекстное окно модели или более низкое окно auto-compaction, когда оно применяется. `rawMaxTokens` несёт то же значение, что и `maxTokens`, и `percentage` это `totalTokens` как округлённый процент этого окна.899`totalTokens` — это текущее использование контекста сеанса, а `maxTokens` — это окно, против которого измеряется использование. Это окно — контекстное окно модели или более низкое окно автокомпактирования, когда оно применяется. `rawMaxTokens` содержит то же значение, что и `maxTokens`, и `percentage` — это `totalTokens` как округленный процент этого окна.

900 900 

901Claude Code оставляет опциональные диагностики `deferredBuiltinTools`, `systemTools` и `systemPromptSections` неустановленными, поэтому ожидайте их отсутствия, даже хотя тип их объявляет.901Claude Code оставляет дополнительные диагностики `deferredBuiltinTools`, `systemTools` и `systemPromptSections` неустановленными, поэтому ожидайте их отсутствия, даже если тип их объявляет.

902 902 

903<h3 id="sdkcontrolreadfileresponse">903<h3 id="sdkcontrolreadfileresponse">

904 `SDKControlReadFileResponse`904 `SDKControlReadFileResponse`


915};915};

916```916```

917 917 

918`contents` содержит текст файла или данные base64, когда вы запросили `encoding: 'base64'`; поле `encoding` ответа установлено на `'base64'` в этом случае. `absPath` это разрешённый абсолютный путь. `truncated` установлено, когда файл был длиннее лимита `maxBytes` и содержимое было обрезано на этом лимите.918`contents` содержит текст файла или данные base64, когда вы запросили `encoding: 'base64'`; поле `encoding` ответа установлено на `'base64'` в этом случае. `absPath` — это разрешенный абсолютный путь. `truncated` установлено, когда файл был длиннее ограничения `maxBytes` и содержимое было обрезано на этом пределе.

919 919 

920<h4 id="what-readfile-can-read">920<h4 id="what-readfile-can-read">

921 What `readFile()` can read921 Что `readFile()` может читать

922</h4>922</h4>

923 923 

924`readFile()` служит более узким набором файлов, чем инструмент Read:924`readFile()` обслуживает более узкий набор файлов, чем инструмент Read:

925 925 

926* Обычный файл внутри одной из рабочих директорий сессии, такой как `cwd` и `additionalDirectories`926* Обычный файл внутри одного из рабочих каталогов сеанса, таких как `cwd` и `additionalDirectories`

927* Несколько собственных файлов Claude Code для сессии, такие как результаты инструментов927* Несколько собственных файлов Claude Code для сеанса, таких как результаты инструментов

928 928 

929Правила отклонения и запроса Read всё ещё блокируют совпадающий путь, и широкое правило разрешения Read не открывает остаток файловой системы для `readFile()`. Для чего-либо ещё вызов разрешается с `null`.929Правила отказа и запроса `Read` по-прежнему блокируют соответствующий путь, и широкое правило разрешения `Read` не открывает остальную часть файловой системы для `readFile()`. Для всего остального вызов разрешается с `null`.

930 930 

931<h3 id="sdkcontrolreloadskillsresponse">931<h3 id="sdkcontrolreloadskillsresponse">

932 `SDKControlReloadSkillsResponse`932 `SDKControlReloadSkillsResponse`


940};940};

941```941```

942 942 

943`skills` перечисляет skills, доступные после перезагрузки, в той же форме [`SlashCommand`](#slashcommand), которую возвращает `supportedCommands()`.943`skills` перечисляет доступные навыки после перезагрузки в той же форме [`SlashCommand`](#slashcommand), которую возвращает `supportedCommands()`.

944 944 

945<h3 id="agentdefinition">945<h3 id="agentdefinition">

946 `AgentDefinition`946 `AgentDefinition`

947</h3>947</h3>

948 948 

949Конфигурация для подагента, определённого программно.949Конфигурация для подагента, определенного программно.

950 950 

951```typescript theme={null}951```typescript theme={null}

952type AgentDefinition = {952type AgentDefinition = {


968};968};

969```969```

970 970 

971| Поле | Обязательно | Описание |971| Поле | Требуется | Описание |

972| :------------------------------------ | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |972| :------------------------------------ | :-------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

973| `description` | Да | Описание на естественном языке, когда использовать этого агента |973| `description` | Да | Описание на естественном языке, когда использовать этого агента |

974| `tools` | Нет | Массив разрешённых имён инструментов. Если опущено, наследует каждый [инструмент, доступный подагентам](/docs/ru/sub-agents#available-tools). Для предварительной загрузки Skills в контекст агента используйте поле `skills` вместо указания `'Skill'` здесь |974| `tools` | Нет | Массив разрешенных имен инструментов. Если опущено, наследует каждый [инструмент, доступный подагентам](/docs/ru/sub-agents#available-tools). Чтобы предварительно загрузить Skills в контекст агента, используйте поле `skills` вместо перечисления `'Skill'` здесь |

975| `disallowedTools` | Нет | Массив имён инструментов для явного запрещения для этого агента. Также принимаются паттерны уровня MCP сервера: `mcp__server` или `mcp__server__*` удаляет каждый инструмент с этого сервера, и `mcp__*` удаляет каждый MCP инструмент с любого сервера |975| `disallowedTools` | Нет | Массив имен инструментов для явного запрета для этого агента. Также принимаются шаблоны уровня MCP сервера: `mcp__server` или `mcp__server__*` удаляет каждый инструмент с этого сервера, и `mcp__*` удаляет каждый инструмент MCP с любого сервера |

976| `prompt` | Да | Системный запрос агента |976| `prompt` | Да | Системная подсказка агента |

977| `model` | Нет | Переопределение модели для этого агента. Принимает псевдоним, такой как `'fable'`, `'opus'`, `'sonnet'`, `'haiku'`, `'inherit'`, или полный ID модели. `'inherit'` использует основную модель. Когда вы опускаете это, Claude Code выбирает модель в [порядке модели подагента](/docs/ru/sub-agents#choose-a-model) |977| `model` | Нет | Переопределение модели для этого агента. Принимает псевдоним, такой как `'fable'`, `'opus'`, `'sonnet'`, `'haiku'`, `'inherit'`, или полный ID модели. `'inherit'` использует основную модель. Когда вы его опускаете, Claude Code выбирает модель в [порядке модели подагента](/docs/ru/sub-agents#choose-a-model) |

978| `mcpServers` | Нет | Спецификации MCP серверов для этого агента |978| `mcpServers` | Нет | Спецификации MCP сервера для этого агента |

979| `skills` | Нет | Массив имён skills для предварительной загрузки в контекст агента |979| `skills` | Нет | Массив имен навыков для предварительной загрузки в контекст агента |

980| `initialPrompt` | Нет | Автоматически отправляется как первый пользовательский ход, когда этот агент работает как агент основного потока |980| `initialPrompt` | Нет | Автоматически отправляется как первый ход пользователя, когда этот агент работает как агент основного потока |

981| `maxTurns` | Нет | Максимальное количество агентских ходов (раунды API) перед остановкой |981| `maxTurns` | Нет | Максимальное количество агентивных ходов (раунды API) перед остановкой |

982| `background` | Нет | Запустите этого агента как неблокирующую фоновую задачу при вызове |982| `background` | Нет | Запустить этого агента как неблокирующую фоновую задачу при вызове |

983| `omitClaudeMd` | Нет | Запустите этого агента без пользовательских, проектных и локальных файлов CLAUDE.md, когда он работает как подагент; управляемые файлы политики всё ещё загружаются. Используйте это для агентов, которые берут всё, что им нужно, из запроса инструмента Agent. Игнорируется, когда этот агент работает как агент основного потока. Требует TypeScript Agent SDK v0.3.271 или позже |983| `omitClaudeMd` | Нет | Запустить этого агента без файлов CLAUDE.md пользователя, проекта и локальных файлов, когда он работает как подагент; управляемые файлы политики по-прежнему загружаются. Используйте его для агентов, которые берут все необходимое из подсказки инструмента Agent. Игнорируется, когда этот агент работает как агент основного потока. Требует TypeScript Agent SDK v0.3.271 или позже |

984| `memory` | Нет | Источник памяти для этого агента: `'user'`, `'project'` или `'local'` |984| `memory` | Нет | Источник памяти для этого агента: `'user'`, `'project'` или `'local'` |

985| `effort` | Нет | Уровень усилий рассуждения для этого агента. Принимает именованный уровень или целое число |985| `effort` | Нет | Уровень усилий рассуждения для этого агента. Принимает названный уровень или целое число |

986| `permissionMode` | Нет | Режим разрешения для выполнения инструмента в этом агенте. [Правила наследования подагента](/docs/ru/agent-sdk/permissions#available-modes) решают, когда оно применяется. См. [`PermissionMode`](#permissionmode) |986| `permissionMode` | Нет | Режим разрешений для выполнения инструментов в этом агенте. [Правила наследования подагента](/docs/ru/agent-sdk/permissions#available-modes) решают, когда он применяется. См. [`PermissionMode`](#permissionmode) |

987| `criticalSystemReminder_EXPERIMENTAL` | Нет | Экспериментально: Критическое напоминание, добавленное в системный запрос |987| `criticalSystemReminder_EXPERIMENTAL` | Нет | Экспериментальный: Критическое напоминание, добавленное в системную подсказку |

988 988 

989<h3 id="agentmcpserverspec">989<h3 id="agentmcpserverspec">

990 `AgentMcpServerSpec`990 `AgentMcpServerSpec`

991</h3>991</h3>

992 992 

993Указывает MCP серверы, доступные подагенту. Может быть именем сервера (строка, ссылающаяся на сервер из конфигурации `mcpServers` родителя) или встроенной конфигурацией сервера, записью, отображающей имена серверов на конфигурации.993Указывает MCP серверы, доступные подагенту. Может быть именем сервера (строка, ссылающаяся на сервер из конфигурации `mcpServers` родителя) или встроенной записью конфигурации сервера, сопоставляющей имена серверов с конфигурациями.

994 994 

995```typescript theme={null}995```typescript theme={null}

996type AgentMcpServerSpec = string | Record<string, McpServerConfigForProcessTransport>;996type AgentMcpServerSpec = string | Record<string, McpServerConfigForProcessTransport>;

997```997```

998 998 

999Где `McpServerConfigForProcessTransport` это `McpStdioServerConfig | McpSSEServerConfig | McpHttpServerConfig | McpSdkServerConfig`.999Где `McpServerConfigForProcessTransport` — это `McpStdioServerConfig | McpSSEServerConfig | McpHttpServerConfig | McpSdkServerConfig`.

1000 1000 

1001<h3 id="settingsource">1001<h3 id="settingsource">

1002 `SettingSource`1002 `SettingSource`

1003</h3>1003</h3>

1004 1004 

1005Контролирует, какие источники конфигурации на основе файловой системы SDK загружает настройки из.1005Контролирует, какие источники конфигурации на основе файловой системы SDK загружает параметры из.

1006 1006 

1007```typescript theme={null}1007```typescript theme={null}

1008type SettingSource = "user" | "project" | "local";1008type SettingSource = "user" | "project" | "local";


1010 1010 

1011| Значение | Описание | Местоположение |1011| Значение | Описание | Местоположение |

1012| :---------- | :---------------------------------------------------------------------------------- | :---------------------------- |1012| :---------- | :---------------------------------------------------------------------------------- | :---------------------------- |

1013| `'user'` | Глобальные пользовательские настройки | `~/.claude/settings.json` |1013| `'user'` | Глобальные параметры пользователя | `~/.claude/settings.json` |

1014| `'project'` | Общие настройки проекта (контролируемые версией) | `.claude/settings.json` |1014| `'project'` | Общие параметры проекта (контролируемые версией) | `.claude/settings.json` |

1015| `'local'` | Локальные настройки проекта, gitignored когда Claude Code сохраняет настройку в неё | `.claude/settings.local.json` |1015| `'local'` | Локальные параметры проекта, gitignored когда Claude Code сохраняет параметр в него | `.claude/settings.local.json` |

1016 1016 

1017<h4 id="default-behavior">1017<h4 id="default-behavior">

1018 Default behavior1018 Поведение по умолчанию

1019</h4>1019</h4>

1020 1020 

1021Когда `settingSources` опущено или `undefined`, `query()` загружает те же настройки файловой системы, что и CLI Claude Code: пользовательские, проектные и локальные. См. [What settingSources does not control](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входных данных, которые читаются независимо от этой опции, и как их отключить.1021Когда `settingSources` опущен или `undefined`, `query()` загружает те же параметры файловой системы, что и CLI Claude Code: пользователя, проекта и локальные. См. [Что settingSources не контролирует](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входов, которые читаются независимо от этого параметра, и как их отключить.

1022 1022 

1023<h4 id="why-use-settingsources">1023<h4 id="why-use-settingsources">

1024 Why use settingSources1024 Почему использовать settingSources

1025</h4>1025</h4>

1026 1026 

1027**Отключите настройки файловой системы:**1027**Отключить параметры файловой системы:**

1028 1028 

1029```typescript theme={null}1029```typescript theme={null}

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

1031 1031 

1032// Не загружайте пользовательские, проектные или локальные настройки с диска1032// Do not load user, project, or local settings from disk

1033const result = query({1033const result = query({

1034 prompt: "Analyze this code",1034 prompt: "Analyze this code",

1035 options: { settingSources: [] }1035 options: { settingSources: [] }

1036});1036});

1037```1037```

1038 1038 

1039**Загружайте только определённые источники настроек:**1039**Загрузить только определенные источники параметров:**

1040 1040 

1041```typescript theme={null}1041```typescript theme={null}

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

1043 1043 

1044// Загружайте только настройки проекта, игнорируйте пользовательские и локальные1044// Load only project settings, ignore user and local

1045const result = query({1045const result = query({

1046 prompt: "Run CI checks",1046 prompt: "Run CI checks",

1047 options: {1047 options: {

1048 settingSources: ["project"] // Только .claude/settings.json1048 settingSources: ["project"] // Only .claude/settings.json

1049 }1049 }

1050});1050});

1051```1051```

1052 1052 

1053Для загрузки инструкций проекта CLAUDE.md включите `"project"` в `settingSources`. См. [Modify system prompts](/docs/ru/agent-sdk/modifying-system-prompts#claude-md-files-for-project-level-instructions) для того, как загрузка CLAUDE.md взаимодействует с опциями системного запроса.1053Чтобы загрузить инструкции проекта CLAUDE.md, включите `"project"` в `settingSources`. См. [Изменить системные подсказки](/docs/ru/agent-sdk/modifying-system-prompts#claude-md-files-for-project-level-instructions) для того, как загрузка CLAUDE.md взаимодействует с параметрами системной подсказки.

1054 1054 

1055<h4 id="settings-precedence">1055<h4 id="settings-precedence">

1056 Settings precedence1056 Приоритет параметров

1057</h4>1057</h4>

1058 1058 

1059Когда загружаются несколько источников, настройки объединяются с этим приоритетом (от высшего к низшему):1059Когда загружаются несколько источников, параметры объединяются с этим приоритетом (от наивысшего к наименьшему):

1060 1060 

10611. Локальные настройки (`.claude/settings.local.json`)10611. Локальные параметры (`.claude/settings.local.json`)

10622. Настройки проекта (`.claude/settings.json`)10622. Параметры проекта (`.claude/settings.json`)

10633. Пользовательские настройки (`~/.claude/settings.json`)10633. Параметры пользователя (`~/.claude/settings.json`)

1064 1064 

1065Программные опции, такие как `agents`, `allowedTools` и `settings`, переопределяют пользовательские, проектные и локальные настройки файловой системы. Управляемые политикой настройки имеют приоритет над программными опциями.1065Программные параметры, такие как `agents`, `allowedTools` и `settings`, переопределяют параметры файловой системы пользователя, проекта и локальные. Параметры управляемой политики имеют приоритет над программными параметрами.

1066 1066 

1067<h3 id="permissionmode">1067<h3 id="permissionmode">

1068 `PermissionMode`1068 `PermissionMode`


1070 1070 

1071```typescript theme={null}1071```typescript theme={null}

1072type PermissionMode =1072type PermissionMode =

1073 | "default" // Стандартное поведение разрешения1073 | "default" // Standard permission behavior

1074 | "acceptEdits" // Автоматически принимайте редактирования файлов1074 | "acceptEdits" // Auto-accept file edits

1075 | "bypassPermissions" // Обойдите проверки разрешения; явные правила запроса всё ещё запрашивают1075 | "bypassPermissions" // Bypass permission checks; explicit ask rules still prompt

1076 | "plan" // Plan Mode - исследуйте без редактирования1076 | "plan" // Planning mode - explore without editing

1077 | "dontAsk" // Не запрашивайте разрешения, отклоняйте, если не предварительно одобрено1077 | "dontAsk" // Don't prompt for permissions, deny if not pre-approved

1078 | "auto"; // Классификатор модели одобряет или отклоняет запросы разрешения1078 | "auto"; // Model classifier approves or denies permission prompts

1079```1079```

1080 1080 

1081<h3 id="canusetool">1081<h3 id="canusetool">

1082 `CanUseTool`1082 `CanUseTool`

1083</h3>1083</h3>

1084 1084 

1085Тип пользовательской функции разрешения для контроля использования инструмента.1085Тип пользовательской функции разрешений для управления использованием инструментов.

1086 1086 

1087Функция является заменой SDK для интерактивного запроса разрешения: она вызывается только когда [поток оценки разрешения](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) разрешается в запрос. Вызовы инструментов, уже одобренные записью `allowedTools`, правилом настроек разрешения или режимом разрешения, такие как `acceptEdits` или `bypassPermissions`, никогда её не вызывают. Чтобы контролировать каждый вызов инструмента, используйте вместо этого [hook `PreToolUse`](/docs/ru/agent-sdk/hooks).1087Функция — это замена SDK для интерактивного запроса разрешений: она вызывается только когда [поток оценки разрешений](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) разрешается в запрос. Вызовы инструментов, уже одобренные записью `allowedTools`, правилом разрешения параметров или режимом разрешений, таким как `acceptEdits` или `bypassPermissions`, никогда не вызывают его. Чтобы контролировать каждый вызов инструмента, используйте hook [`PreToolUse`](/docs/ru/agent-sdk/hooks) вместо этого.

1088 1088 

1089Правило разрешения не предварительно одобряет [действия, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves); см. [How permissions are evaluated](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) для того, какие из них достигают обратного вызова и что происходит в режиме `dontAsk` и `auto`.1089Правило разрешения не предварительно одобряет [действия, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves); см. [Как оцениваются разрешения](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) для того, какие из них достигают обратного вызова и что происходит в режиме `dontAsk` и `auto`.

1090 1090 

1091```typescript theme={null}1091```typescript theme={null}

1092type CanUseTool = (1092type CanUseTool = (


1096 signal: AbortSignal;1096 signal: AbortSignal;

1097 suggestions?: PermissionUpdate[];1097 suggestions?: PermissionUpdate[];

1098 blockedPath?: string;1098 blockedPath?: string;

1099 mcpServer?: { name: string; source: string };

1099 decisionReason?: string;1100 decisionReason?: string;

1100 toolUseID: string;1101 toolUseID: string;

1101 agentID?: string;1102 agentID?: string;


1104) => Promise<PermissionResult | null>;1105) => Promise<PermissionResult | null>;

1105```1106```

1106 1107 

1107| Опция | Тип | Описание |1108| Параметр | Тип | Описание |

1108| :--------------- | :------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1109| :--------------- | :------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1109| `signal` | `AbortSignal` | Сигнализируется, если операция должна быть отменена |1110| `signal` | `AbortSignal` | Сигнализируется, если операция должна быть прервана |

1110| `suggestions` | [`PermissionUpdate`](#permissionupdate)`[]` | Предложенные обновления разрешения, чтобы пользователь не был запрошен снова для этого инструмента. Запросы Bash включают предложение с назначением `localSettings` [destination](#permissionupdatedestination), поэтому возврат его в `updatedPermissions` записывает правило в `.claude/settings.local.json` и сохраняется между сессиями. |1111| `suggestions` | [`PermissionUpdate`](#permissionupdate)`[]` | Предложенные обновления разрешений, чтобы пользователь не был запрошен снова для этого инструмента. Подсказки Bash включают предложение с назначением `localSettings` [destination](#permissionupdatedestination), поэтому возврат его в `updatedPermissions` записывает правило в `.claude/settings.local.json` и сохраняется между сеансами. |

1111| `blockedPath` | `string` | Путь файла, который вызвал запрос разрешения, если применимо |1112| `blockedPath` | `string` | Путь файла, который вызвал запрос разрешения, если применимо |

1113| `mcpServer` | `{ name: string; source: string }` | Для инструмента `mcp__*`, MCP сервер, который его обслуживает, и откуда определение этого сервера пришло, с полями [`McpServerProvenance`](#mcpserverprovenance). Отсутствует для других инструментов. Требует Agent SDK v0.3.274 или позже |

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

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

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

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

1116 1118 

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

1118 1120 

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

1120 1122 

1121<h3 id="permissionresult">1123<h3 id="permissionresult">

1122 `PermissionResult`1124 `PermissionResult`


1144 `ToolConfig`1146 `ToolConfig`

1145</h3>1147</h3>

1146 1148 

1147Конфигурация для встроенного поведения инструмента.1149Конфигурация для поведения встроенного инструмента.

1148 1150 

1149```typescript theme={null}1151```typescript theme={null}

1150type ToolConfig = {1152type ToolConfig = {


1155```1157```

1156 1158 

1157| Поле | Тип | Описание |1159| Поле | Тип | Описание |

1158| :------------------------------ | :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1160| :------------------------------ | :--------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1159| `askUserQuestion.previewFormat` | `'markdown' \| 'html'` | Выбирает поле `preview` на опциях [`AskUserQuestion`](/docs/ru/agent-sdk/user-input#question-format) и устанавливает его формат содержимого. Когда не установлено, Claude не выдаёт предпросмотры |1161| `askUserQuestion.previewFormat` | `'markdown' \| 'html'` | Включает поле `preview` на параметрах [`AskUserQuestion`](/docs/ru/agent-sdk/user-input#question-format) и устанавливает его формат содержимого. Когда не установлено, Claude не выдает предпросмотры |

1160 1162 

1161<h3 id="mcpserverconfig">1163<h3 id="mcpserverconfig">

1162 `McpServerConfig`1164 `McpServerConfig`


1238 `SdkPluginConfig`1240 `SdkPluginConfig`

1239</h3>1241</h3>

1240 1242 

1241Конфигурация для загрузки plugins в SDK.1243Конфигурация для загрузки плагинов в SDK.

1242 1244 

1243```typescript theme={null}1245```typescript theme={null}

1244type SdkPluginConfig = {1246type SdkPluginConfig = {


1249```1251```

1250 1252 

1251| Поле | Тип | Описание |1253| Поле | Тип | Описание |

1252| :----------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1254| :----------------- | :-------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1253| `type` | `'local'` | Должно быть `'local'` (в настоящее время поддерживаются только локальные plugins) |1255| `type` | `'local'` | Должно быть `'local'` (в настоящее время поддерживаются только локальные плагины) |

1254| `path` | `string` | Абсолютный или относительный путь к директории plugin |1256| `path` | `string` | Абсолютный или относительный путь к каталогу плагина |

1255| `skipMcpDiscovery` | `boolean` | Когда `true`, SDK загружает skills, hooks, agents и commands из этого plugin, но не читает его `.mcp.json` или manifest `mcpServers`. Установите это, когда ваше приложение владеет подключениями MCP plugin. |1257| `skipMcpDiscovery` | `boolean` | Когда `true`, SDK загружает навыки, hooks, агентов и команды из этого плагина, но не читает его `.mcp.json` или манифест `mcpServers`. Установите это, когда ваше приложение владеет подключениями MCP плагина. |

1256 1258 

1257**Пример:**1259**Пример:**

1258 1260 


1263];1265];

1264```1266```

1265 1267 

1266Для полной информации о создании и использовании plugins см. [Plugins](/docs/ru/agent-sdk/plugins).1268Для полной информации о создании и использовании плагинов см. [Плагины](/docs/ru/agent-sdk/plugins).

1267 1269 

1268<h2 id="message-types">1270<h2 id="message-types">

1269 Типы сообщений1271 Типы сообщений


1326 type: "assistant";1328 type: "assistant";

1327 uuid: UUID;1329 uuid: UUID;

1328 session_id: string;1330 session_id: string;

1329 message: BetaMessage; // Из Anthropic SDK1331 message: BetaMessage; // From Anthropic SDK

1330 parent_tool_use_id: string | null;1332 parent_tool_use_id: string | null;

1331 error?: SDKAssistantMessageError;1333 error?: SDKAssistantMessageError;

1332 aborted?: true;1334 aborted?: true;


1337};1339};

1338```1340```

1339 1341 

1340Поле `message` это [`BetaMessage`](https://platform.claude.com/docs/ru/api/messages/create) из Anthropic SDK. Оно включает поля, такие как `id`, `content`, `model`, `stop_reason` и `usage`.1342Поле `message` — это [`BetaMessage`](https://platform.claude.com/docs/en/api/messages/create) из Anthropic SDK. Оно включает поля, такие как `id`, `content`, `model`, `stop_reason` и `usage`.

1341 1343 

1342`SDKAssistantMessageError` это один из: `'authentication_failed'`, `'oauth_org_not_allowed'`, `'account_on_hold'`, `'billing_error'`, `'rate_limit'`, `'overloaded'`, `'invalid_request'`, `'model_not_found'`, `'server_error'`, `'max_output_tokens'`, `'cloud_credential_error'` или `'unknown'`. Четыре из этих значений означают больше, чем говорят их названия:1344`SDKAssistantMessageError` — это одно из следующих значений: `'authentication_failed'`, `'oauth_org_not_allowed'`, `'account_on_hold'`, `'billing_error'`, `'rate_limit'`, `'overloaded'`, `'invalid_request'`, `'model_not_found'`, `'server_error'`, `'max_output_tokens'`, `'cloud_credential_error'` или `'unknown'`. Четыре из этих значений означают больше, чем говорят их названия:

1343 1345 

1344* `'model_not_found'`: выбранная модель не существует или недоступна для вашей учётной записи или развёртывания1346* `'model_not_found'`: выбранная модель не существует или недоступна для вашей учётной записи или развёртывания

1345* `'overloaded'`: API вернул 529, потому что сервер работает на полную мощность, в отличие от `'rate_limit'`, который является 429 в отношении вашей квоты1347* `'overloaded'`: API вернул 529, потому что сервер работает на полную мощность, в отличие от `'rate_limit'`, который является 429 в отношении вашей квоты

1346* `'account_on_hold'`: [ваша учётная запись заморожена](/docs/ru/errors#your-account-is-on-hold)1348* `'account_on_hold'`: [ваша учётная запись заморожена](/docs/ru/errors#your-account-is-on-hold)

1347* `'cloud_credential_error'`: Claude Code не смог получить пригодные учётные данные AWS или Google Cloud на машине, на которой он работает, поэтому запрос не достиг поставщика облачных услуг. Обычная причина — вход в облако, который истёк или никогда не был завершён на этой машине, хотя кратковременно недоступный сервис учётных данных сообщает то же значение. Смотрите [Не удалось загрузить учётные данные AWS или Google Cloud](/docs/ru/errors#could-not-load-aws-or-google-cloud-credentials). Требует TypeScript Agent SDK v0.3.267 или позже, который включает Claude Code v2.1.2671349* `'cloud_credential_error'`: Claude Code не смог получить пригодные учётные данные AWS или Google Cloud на машине, на которой он работает, поэтому запрос не достиг поставщика облачных услуг. Обычная причина — истёкший или никогда не завершённый вход в облако на этой машине, хотя временно недоступный сервис учётных данных сообщает то же значение. См. [Could not load AWS or Google Cloud credentials](/docs/ru/errors#could-not-load-aws-or-google-cloud-credentials). Требует TypeScript Agent SDK v0.3.267 или позже, который включает Claude Code v2.1.267

1348 1350 

1349`aborted` имеет значение `true`, когда прерывание или отмена усекли сообщение ассистента перед завершением потока: сообщение не имеет `stop_reason` и содержимое может заканчиваться в середине слова. Поле отсутствует на нормально завершённых сообщениях. Требует Agent SDK v0.3.214 или позже.1351`aborted` имеет значение `true`, когда прерывание или отмена усекли сообщение ассистента до завершения потока: сообщение не имеет `stop_reason` и содержимое может заканчиваться посередине слова. Это поле отсутствует на нормально завершённых сообщениях. Требует Agent SDK v0.3.214 или позже.

1350 1352 

1351Claude Code устанавливает `user_message_uuid` и `user_message_uuids` на первое сообщение ассистента хода при условиях, описанных в [`user_message_uuid`](#user_message_uuid).1353Claude Code устанавливает `user_message_uuid` и `user_message_uuids` на первое сообщение ассистента в этом ходу при условиях, описанных в [`user_message_uuid`](#user_message_uuid).

1352 1354 

1353`timestamp` это время ISO 8601, когда содержимое сообщения закончило генерироваться на процессе, который его создал. Значение поступает с часов этой машины, поэтому используйте его только для отображения и не упорядочивайте сообщения по нему. Один ход API может создать несколько сообщений ассистента, которые совместно используют `message.id`, каждое со своим собственным `timestamp`. Когда поле отсутствует, вернитесь к времени получения сообщения.1355`timestamp` — это время ISO 8601, когда содержимое сообщения закончило генерироваться на процессе, который его создал. Значение поступает с часов этой машины, поэтому используйте его только для отображения и не упорядочивайте сообщения по нему. Один ход API может создать несколько сообщений ассистента, которые имеют одинаковый `message.id`, каждое со своим `timestamp`. Когда это поле отсутствует, используйте время получения сообщения.

1354 1356 

1355`context_usage` это структурированная копия отчёта `/context`, типизированная как [`SDKContextUsage`](#sdkcontextusage), и требует Agent SDK v0.3.232 или позже. Когда вы отправляете `/context` как запрос, Claude Code доставляет отчёт как сообщение ассистента, чьё `message.content` содержит таблицу markdown, и прикрепляет `context_usage` к этому же сообщению. Claude Code не устанавливает поле на любое другое сообщение ассистента, и более ранние версии доставляют таблицу `/context` без него, поэтому читайте разбивку из поля, когда оно присутствует, и вернитесь к тексту markdown, когда его нет.1357`context_usage` — это структурированная копия отчёта `/context`, типизированная как [`SDKContextUsage`](#sdkcontextusage), и требует Agent SDK v0.3.232 или позже. Когда вы отправляете `/context` как подсказку, Claude Code доставляет отчёт как сообщение ассистента, чьё `message.content` содержит таблицу markdown, и прикрепляет `context_usage` к этому же сообщению. Claude Code не устанавливает это поле ни на каком другом сообщении ассистента, и более ранние версии доставляют таблицу `/context` без него, поэтому читайте разбивку из поля, когда оно присутствует, и используйте текст markdown, когда его нет.

1356 1358 

1357<h3 id="sdkusermessage">1359<h3 id="sdkusermessage">

1358 `SDKUserMessage`1360 `SDKUserMessage`


1365 type: "user";1367 type: "user";

1366 uuid?: UUID;1368 uuid?: UUID;

1367 session_id?: string;1369 session_id?: string;

1368 message: MessageParam; // Из Anthropic SDK1370 message: MessageParam; // From Anthropic SDK

1369 parent_tool_use_id: string | null;1371 parent_tool_use_id: string | null;

1370 isSynthetic?: boolean;1372 isSynthetic?: boolean;

1371 shouldQuery?: boolean;1373 shouldQuery?: boolean;


1374};1376};

1375```1377```

1376 1378 

1377Установите `shouldQuery` на `false` для добавления сообщения в транскрипт без запуска хода ассистента. Сообщение удерживается и объединяется в следующее пользовательское сообщение, которое запускает ход. Используйте это для внедрения контекста, такого как вывод команды, которую вы запустили вне полосы, без траты вызова модели на это.1379Установите `shouldQuery` в `false`, чтобы добавить сообщение в стенограмму без запуска хода ассистента. Сообщение удерживается и объединяется со следующим пользовательским сообщением, которое запускает ход. Используйте это для внедрения контекста, такого как вывод команды, которую вы запустили вне полосы, без затрат вызова модели на это.

1378 1380 

1379На сообщении, которое содержит блок `tool_result`, `tool_use_result` это объект структурированного вывода инструмента, а не текст, отправленный модели. Его форма зависит от инструмента, названного соответствующим блоком `tool_use`, поэтому поле типизировано как `unknown`; встроенные формы перечислены в разделе [Типы вывода инструментов](#tool-output-types).1381На сообщении, которое содержит блок `tool_result`, `tool_use_result` — это структурированный объект вывода инструмента, а не текст, отправленный модели. Его форма зависит от инструмента, названного соответствующим блоком `tool_use`, поэтому поле типизировано как `unknown`; встроенные формы перечислены в разделе [Tool Output Types](#tool-output-types).

1380 1382 

1381Для инструмента `Agent`, `tool_use_result` это [`AgentOutput`](#agent-2). На результате `completed`, `content` содержит отчёт подагента без ID агента и трейлера использования, которые Claude Code добавляет к тексту `tool_result`, поэтому отображайте из `tool_use_result` вместо анализа этого текста.1383Для инструмента `Agent` `tool_use_result` — это [`AgentOutput`](#agent-2). На результате `completed` `content` содержит отчёт подагента без ID агента и трейлера использования, который Claude Code добавляет к тексту `tool_result`, поэтому выполняйте рендеринг из `tool_use_result` вместо анализа этого текста.

1382 1384 

1383Для инструмента MCP, чей результат содержит блоки `resource_link`, `tool_use_result` это объект с массивом `resourceLinks` записей [`SDKMcpResourceLink`](#sdkmcpresourcelink). Claude получает каждую ссылку как строку текста в блоке `tool_result`, поэтому читайте `resourceLinks` для отображения файлов, которые вернул сервер, вместо анализа этого текста. Claude Code опускает `resourceLinks`, когда результат не содержит ссылок и на результатах от подагентов, сохраняет максимум 50 ссылок на результат и прекращает добавление ссылок, когда массив достигает 64 КиБ сериализованного JSON. `resourceLinks` требует Agent SDK v0.3.257 или позже.1385Для инструмента MCP, чей результат содержит блоки `resource_link`, `tool_use_result` — это объект с массивом `resourceLinks` записей [`SDKMcpResourceLink`](#sdkmcpresourcelink). Claude получает каждую ссылку как строку текста в блоке `tool_result`, поэтому читайте `resourceLinks`, чтобы выполнить рендеринг файлов, которые вернул сервер, вместо анализа этого текста. Claude Code опускает `resourceLinks`, когда результат не содержит ссылок и на результатах от подагентов, сохраняет максимум 50 ссылок на результат и прекращает добавление ссылок, когда массив достигает 64 КиБ сериализованного JSON. `resourceLinks` требует Agent SDK v0.3.257 или позже.

1384 1386 

1385<h3 id="sdkusermessagereplay">1387<h3 id="sdkusermessagereplay">

1386 `SDKUserMessageReplay`1388 `SDKUserMessageReplay`

1387</h3>1389</h3>

1388 1390 

1389Повторно воспроизведённое пользовательское сообщение с требуемым UUID.1391Воспроизведённое пользовательское сообщение с обязательным UUID.

1390 1392 

1391```typescript theme={null}1393```typescript theme={null}

1392type SDKUserMessageReplay = {1394type SDKUserMessageReplay = {


1402};1404};

1403```1405```

1404 1406 

1405Пользовательский ход, внедрённый извне сеанса, один, чьё [`origin`](#sdkmessageorigin) имеет вид `peer` или `channel`, достигает потока как повтор, был ли он доставлен во время активного хода или запустил новый ход, пока сеанс был неактивен. До v2.1.207 внедрённый ход, доставленный, пока сеанс был неактивен, не производил никакого сообщения в потоке и появлялся только при повторном чтении транскрипта.1407Пользовательский ход, внедрённый извне сеанса, один, чей [`origin`](#sdkmessageorigin) имеет вид `peer` или `channel`, поступает в поток как воспроизведение, был ли он доставлен во время активного хода или запустил новый ход, пока сеанс был неактивен. До v2.1.207 внедрённый ход, доставленный, пока сеанс был неактивен, не создавал сообщение в потоке и появлялся только при повторном чтении стенограммы.

1406 1408 

1407<h3 id="sdkresultmessage">1409<h3 id="sdkresultmessage">

1408 `SDKResultMessage`1410 `SDKResultMessage`


1465 permission_denials: SDKPermissionDenial[];1467 permission_denials: SDKPermissionDenial[];

1466 queued_turn_count?: number;1468 queued_turn_count?: number;

1467 errors: string[];1469 errors: string[];

1470 startup_failure_reason?: SDKStartupFailureReason;

1468 user_message_uuid?: string;1471 user_message_uuid?: string;

1469 user_message_uuids?: string[];1472 user_message_uuids?: string[];

1470 terminal_reason?: TerminalReason;1473 terminal_reason?: TerminalReason;


1474 };1477 };

1475```1478```

1476 1479 

1477Несколько полей в результате содержат диагностические детали помимо `subtype`:1480Несколько полей в результате содержат диагностические детали, выходящие за рамки `subtype`:

1478 1481 

1479* `api_error_status`: HTTP код состояния ошибки API, которая завершила диалог. Отсутствует или имеет значение `null`, когда ход завершился без ошибки API.1482* `api_error_status`: код состояния HTTP ошибки API, которая завершила разговор. Отсутствует или `null`, когда ход завершился без ошибки API.

1480* `ttft_ms`: время до первого токена в миллисекундах, измеренное при поступлении первого полного сообщения ассистента. Присутствует только на успешной ветви.1483* `ttft_ms`: время до первого токена в миллисекундах, измеренное при поступлении первого полного сообщения ассистента. Присутствует только на ветви успеха.

1481* `ttft_stream_ms`: время в миллисекундах до первого события потока `message_start`, когда открывается поток ответа. Ниже, чем `ttft_ms`; разница между ними — это время, потраченное на потоковую передачу первого сообщения. Присутствует только на успешной ветви.1484* `ttft_stream_ms`: время в миллисекундах до первого события потока `message_start`, когда открывается поток ответов. Ниже, чем `ttft_ms`; разница между ними — это время, потраченное на потоковую передачу первого сообщения. Присутствует только на ветви успеха.

1482* `user_message_uuid`: `uuid` сообщения, которое вы отправили и на которое этот ход ответил. Смотрите [`user_message_uuid`](#user_message_uuid) для того, какие результаты его содержат.1485* `user_message_uuid`: `uuid` сообщения, которое вы отправили и на которое этот ход ответил. См. [`user_message_uuid`](#user_message_uuid) для того, какие результаты его содержат.

1483* `user_message_uuids`: `uuid`s каждого сообщения, которое вы отправили и на которое Claude Code ответил в этом ходе. Смотрите [`user_message_uuids`](#user_message_uuids).1486* `user_message_uuids`: `uuid`s каждого сообщения, которое вы отправили и на которое Claude Code ответил в этом ходу. См. [`user_message_uuids`](#user_message_uuids).

1484* `request_sent_wall_ms`: эпоха миллисекунд, в которую Claude Code отправил запрос API, для объединения с серверными временными метками. Присутствует только вместе с [`user_message_uuid`](#user_message_uuid), на успешном результате с `is_error` false, чей ход отправил запрос API.1487* `request_sent_wall_ms`: миллисекунды эпохи, в которые Claude Code отправил запрос API, для объединения с серверными временными метками. Присутствует только вместе с [`user_message_uuid`](#user_message_uuid), на результате успеха с `is_error` false, чей ход отправил запрос API.

1485* `first_content_frame_ms`: время в миллисекундах до первого события потока `content_block_start` или `content_block_delta`, считая блоки размышлений как содержимое. Присутствует на успешной ветви только, когда `is_error` false. Требует Agent SDK v0.3.260 или позже.1488* `first_content_frame_ms`: время в миллисекундах до первого события потока `content_block_start` или `content_block_delta`, считая блоки мышления как содержимое. Присутствует только на ветви успеха, когда `is_error` имеет значение false. Требует Agent SDK v0.3.260 или позже.

1486* `first_stream_post_ms`, `first_stream_post_ack_ms`, `first_stream_post_wall_ms`: сроки загрузки первого события потока хода. Claude Code записывает их только в сеансах, которые он потоком передаёт на claude.ai, такие как [облачные сеансы](/docs/ru/claude-code-on-the-web), и результаты, которые выдаёт `query()`, их не содержат. Требует Agent SDK v0.3.260 или позже.1489* `first_stream_post_ms`, `first_stream_post_ack_ms`, `first_stream_post_wall_ms`: сроки загрузки первого события потока хода. Claude Code записывает их только в сеансах, которые он потоком передаёт на claude.ai, такие как [облачные сеансы](/docs/ru/claude-code-on-the-web), и результаты, которые выдаёт `query()`, их не содержат. Требует Agent SDK v0.3.260 или позже.

1487* `usage`: только основной цикл агента. Исключает вызовы подагента и вспомогательной модели и является за ход в сеансах потокового ввода. Предпочитайте `modelUsage` для учёта токенов/затрат.1490* `usage`: только основной цикл агента. Исключает вызовы подагента и вспомогательной модели и является за ход в сеансах с потоковым вводом. Предпочитайте `modelUsage` для учёта токенов/затрат.

1488* `modelUsage`: итоги по моделям для каждого вызова модели, сделанного через конвейер запросов во время этого вызова `query()`, включая основной цикл, подагентов и внутренние вызовы, такие как компактирование и агенты Workflow. Вспомогательные вызовы вне этого конвейера, такие как классификатор разрешений и запросы подсчёта токенов, исключены. В сеансах потокового ввода итоги кумулятивны по ходам, поэтому читайте последний результат, а не суммируйте по результатам. Смотрите [Отслеживание затрат в режиме потокового ввода](/docs/ru/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) для сбросов и [Восстановление итогов после сбоя сеанса](/docs/ru/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) для обнулённых результатов.1491* `modelUsage`: итоги по моделям для каждого вызова модели, сделанного через конвейер запросов во время этого вызова `query()`, включая основной цикл, подагентов и внутренние вызовы, такие как компактирование и агентов Workflow. Вспомогательные вызовы вне этого конвейера, такие как классификатор разрешений и запросы подсчёта токенов, исключены. В сеансах с потоковым вводом итоги накапливаются по ходам, поэтому читайте последний результат, а не суммируйте по результатам. См. [Track costs in streaming input mode](/docs/ru/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) для сбросов и [Recover totals after a session crash](/docs/ru/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) для обнулённых результатов.

1489* `total_cost_usd`: кумулятивная предполагаемая стоимость в USD для этого вызова `query()`, охватывающая те же вызовы, что и `modelUsage`, и сбрасываемая в тех же точках. Это оценка, а не выписка по счёту. Смотрите [Отслеживание затрат и использования](/docs/ru/agent-sdk/cost-tracking) для оговорок по точности.1492* `total_cost_usd`: кумулятивная предполагаемая стоимость в USD для этого вызова `query()`, охватывающая те же вызовы, что и `modelUsage`, и сбрасываемая в тех же точках. Это оценка, а не выписка по счёту. См. [Track cost and usage](/docs/ru/agent-sdk/cost-tracking) для предостережений по точности.

1490* `queued_turn_count`: количество сообщений, которые вы отправили с `origin: { kind: "human" }`, которые всё ещё ожидают, когда Claude Code создал результат. Смотрите [`queued_turn_count`](#queued_turn_count) для того, что говорят вам `0` и отсутствующее поле.1493* `queued_turn_count`: количество сообщений, которые вы отправили с `origin: { kind: "human" }`, которые всё ещё ожидают, когда Claude Code создал результат. См. [`queued_turn_count`](#queued_turn_count) для того, что говорят вам `0` и отсутствующее поле.

1491* `terminal_reason`: почему цикл завершился. Один из `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"background_requested"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"`, `"model_error"`, `"api_error"`, `"malformed_tool_use_exhausted"`, `"budget_exhausted"`, `"structured_output_retry_exhausted"`, `"tool_deferred_unavailable"` или `"turn_setup_failed"`.1494* `startup_failure_reason`: почему Claude Code отказался запускаться, на результате `error_during_execution`, который он записывает перед выходом при известной ошибке запуска. См. [`startup_failure_reason`](#startup_failure_reason) для значений и того, какие ошибки его содержат. Требует Agent SDK v0.3.274 или позже.

1492* `fast_mode_state`: один из `"on"`, `"off"` или `"cooldown"`.1495* `terminal_reason`: почему цикл завершился. Одно из значений: `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"background_requested"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"`, `"model_error"`, `"api_error"`, `"malformed_tool_use_exhausted"`, `"budget_exhausted"`, `"structured_output_retry_exhausted"`, `"tool_deferred_unavailable"` или `"turn_setup_failed"`.

1493* `fast_mode_disabled_reason`: почему [быстрый режим](/docs/ru/fast-mode) недоступен прямо сейчас. Отсутствует, когда ничто не блокирует быстрый режим, хотя запрос может всё ещё работать на стандартной скорости. Во время охлаждения после ограничения скорости быстрого режима Claude Code сообщает `fast_mode_state: "cooldown"` без кода причины и повторно включает быстрый режим, когда охлаждение истекает. Требует Claude Code v2.1.219 или позже.1496* `fast_mode_state`: одно из значений `"on"`, `"off"` или `"cooldown"`.

1497* `fast_mode_disabled_reason`: почему [fast mode](/docs/ru/fast-mode) недоступен прямо сейчас. Отсутствует, когда ничто не блокирует fast mode, хотя запрос может всё ещё работать на стандартной скорости. Во время охлаждения после ограничения скорости fast mode Claude Code сообщает `fast_mode_state: "cooldown"` без кода причины и повторно включает fast mode, когда охлаждение истекает. Требует Claude Code v2.1.219 или позже.

1494 1498 

1495Используйте код причины, чтобы объяснить, почему быстрый режим отключён в вашем собственном пользовательском интерфейсе, вместо повторного вывода доступности. Каждый код называет проверку, которая заблокировала быстрый режим:1499Используйте код причины, чтобы объяснить, почему fast mode отключён в вашем собственном пользовательском интерфейсе, вместо повторного вывода доступности. Каждый код называет проверку, которая заблокировала fast mode:

1496 1500 

1497| Код причины | Значение |1501| Код причины | Значение |

1498| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |1502| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |

1499| `free` | Учётная запись не имеет платной подписки или кредитов использования, которые требует быстрый режим |1503| `free` | Учётная запись не имеет платной подписки или кредитов использования, которые требует fast mode |

1500| `preference` | Организация отключила быстрый режим |1504| `preference` | Организация отключила fast mode |

1501| `extra_usage_disabled` | Кредиты использования отключены для учётной записи |1505| `extra_usage_disabled` | Кредиты использования отключены для учётной записи |

1502| `network_error` | [Проверка доступности](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) не смогла достичь `api.anthropic.com` |1506| `network_error` | [Проверка доступности](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) не смогла достичь `api.anthropic.com` |

1503| `unknown` | Claude Code не смог определить доступность |1507| `unknown` | Claude Code не смог определить доступность |

1504| `not_first_party` | Сеанс использует поставщика, отличного от Anthropic API |1508| `not_first_party` | Сеанс использует поставщика, отличного от Anthropic API |

1505| `disabled_by_env` | [`CLAUDE_CODE_DISABLE_FAST_MODE`](/docs/ru/env-vars) установлена |1509| `disabled_by_env` | [`CLAUDE_CODE_DISABLE_FAST_MODE`](/docs/ru/env-vars) установлен |

1506| `model_not_allowed` | Модель быстрого режима Opus отсутствует в списке разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) организации |1510| `model_not_allowed` | Модель Opus fast mode отсутствует в списке разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) организации |

1507| `sdk_opt_in_required` | Сеанс не согласился на быстрый режим: передайте `fastMode: true` в опции [`settings`](#options) или через [`applyFlagSettings()`](#applyflagsettings) |1511| `sdk_opt_in_required` | Сеанс не согласился на fast mode: передайте `fastMode: true` в опции [`settings`](#options) или через [`applyFlagSettings()`](#applyflagsettings) |

1508| `pending` | Проверка доступности ещё не завершена |1512| `pending` | Проверка доступности ещё не завершена |

1509 1513 

1510Одна и та же пара полей появляется на [`SDKSystemMessage`](#sdksystemmessage) и на [`SDKControlInitializeResponse`](#sdkcontrolinitializeresponse), поэтому вы можете прочитать состояние быстрого режима перед первым ходом.1514Одна и та же пара полей появляется на [`SDKSystemMessage`](#sdksystemmessage) и на [`SDKControlInitializeResponse`](#sdkcontrolinitializeresponse), поэтому вы можете прочитать состояние fast mode перед первым ходом.

1511 1515 

1512Поле `origin` передаёт [`SDKMessageOrigin`](#sdkmessageorigin) пользовательского сообщения, которое запустило этот результат. Когда SDK внедряет синтетический ход продолжения, такой как для завершённой фоновой задачи, результирующее `SDKResultMessage` содержит `origin: { kind: "task-notification" }`. Подпрограммы, чьи триггеры сработали и сообщения, проверенные сервером, из ваших других сеансов прибывают с этим видом, каждое с `subkind`, описанным в [Подвиды уведомлений о задачах](#task-notification-subkinds). Проверьте `kind`, чтобы различить результаты, которые отвечают на ваш запрос, от внедрённых продолжений перед маршрутизацией или подавлением их.1516Поле `origin` пересылает [`SDKMessageOrigin`](#sdkmessageorigin) пользовательского сообщения, которое запустило этот результат. Когда SDK внедряет синтетический ход продолжения, такой как для завершённой фоновой задачи, результирующее `SDKResultMessage` содержит `origin: { kind: "task-notification" }`. Подпрограммы, чей триггер сработал и проверенные сервером сообщения из ваших других сеансов поступают с этим видом, каждое с `subkind`, описанным в [Task-notification subkinds](#task-notification-subkinds). Проверьте `kind`, чтобы различить результаты, которые отвечают на вашу подсказку, от внедрённых продолжений перед маршрутизацией или подавлением их.

1513 1517 

1514Поле отсутствует для результатов, выданных перед любым пользовательским ходом, таких как ошибки при запуске.1518Это поле отсутствует для результатов, выданных перед любым пользовательским ходом, такие как ошибки запуска.

1515 1519 

1516Когда hook `PreToolUse` возвращает `permissionDecision: "defer"`, результат имеет `stop_reason: "tool_deferred"` и `deferred_tool_use` содержит `id`, `name` и `input` ожидающего инструмента. Прочитайте это поле, чтобы отобразить запрос в вашем собственном пользовательском интерфейсе, затем возобновите с тем же `session_id` для продолжения. Смотрите [Отложить вызов инструмента на потом](/docs/ru/hooks#defer-a-tool-call-for-later) для полного цикла.1520Когда хук `PreToolUse` возвращает `permissionDecision: "defer"`, результат имеет `stop_reason: "tool_deferred"` и `deferred_tool_use` содержит `id`, `name` и `input` ожидающего инструмента. Читайте это поле, чтобы отобразить запрос в вашем собственном пользовательском интерфейсе, затем возобновите с тем же `session_id`, чтобы продолжить. См. [Defer a tool call for later](/docs/ru/hooks#defer-a-tool-call-for-later) для полного цикла.

1517 1521 

1518<h4 id="user_message_uuid">1522<h4 id="user_message_uuid">

1519 `user_message_uuid`1523 `user_message_uuid`

1520</h4>1524</h4>

1521 1525 

1522`uuid` [`SDKUserMessage`](#sdkusermessage), на которое отвечает ход, повторённый, чтобы вы могли сопоставить ответ Claude Code с сообщением, которое вы отправили. Claude Code повторяет `uuid` только если вы установили его на сообщение. Поле опционально на `SDKUserMessage`, и строковый запрос, переданный в `query()`, не содержит ни одного.1526`uuid` [`SDKUserMessage`](#sdkusermessage), на который ход отвечает, повторённый, чтобы вы могли сопоставить ответ Claude Code с сообщением, которое вы отправили. Claude Code повторяет `uuid` только если вы установили его на сообщение. Это поле необязательно на `SDKUserMessage`, и строковая подсказка, переданная в `query()`, не содержит ни одного.

1523 1527 

1524Какое из ваших сообщений отвечает ход, зависит от того, как ход начался:1528Какое из ваших сообщений отвечает ход, зависит от того, как ход начался:

1525 1529 

1526* **Обычное сообщение, которое вы отправили**, то есть без `isSynthetic: true`: ход отвечает на это сообщение на протяжении всего его выполнения. Когда вы отправляете несколько сообщений близко друг к другу, Claude Code может объединить их в один ход, и поле затем содержит только `uuid` последнего сообщения. Чтобы сопоставить ответ с любым из объединённых сообщений, используйте [`user_message_uuids`](#user_message_uuids).1530* **Обычное сообщение, которое вы отправили**, то есть без `isSynthetic: true`: ход отвечает на это сообщение на протяжении всего его выполнения. Когда вы отправляете несколько сообщений близко друг к другу, Claude Code может объединить их в один ход, и поле затем содержит только `uuid` последнего сообщения. Чтобы сопоставить ответ с любым из объединённых сообщений, используйте [`user_message_uuids`](#user_message_uuids).

1527* **Сообщение, которое вы отправили с `isSynthetic: true`**: ход сначала отвечает на это сообщение. Если Claude Code подхватит обычное сообщение вашего между вызовами инструментов, ход отвечает на подхваченное сообщение с этого момента. Повторение `uuid` синтетического сообщения требует Agent SDK v0.3.265 или позже; более ранние версии ничего не повторяют на синтетических ходах.1531* **Сообщение, которое вы отправили с `isSynthetic: true`**: ход сначала отвечает на это сообщение. Если Claude Code подхватит обычное сообщение вашего между вызовами инструментов, ход будет отвечать на подхваченное сообщение с этого момента. Повторение `uuid` синтетического сообщения требует Agent SDK v0.3.265 или позже; более ранние версии ничего не повторяют на синтетических ходах.

1528* **Запрос, который Claude Code сгенерировал сам**, такой как ход, который продолжает прерванную работу после перезагрузки сеанса: ход сначала не отвечает на ваше сообщение и его кадры не содержат повтора. Если Claude Code подхватит обычное сообщение вашего между вызовами инструментов, ход отвечает на это сообщение с этого момента. Повтор подхвата требует Agent SDK v0.3.265 или позже; более ранние версии ничего не повторяют на этих ходах.1532* **Подсказка, которую Claude Code сгенерировал сам**, такая как ход, который продолжает прерванную работу после перезагрузки сеанса: ход сначала не отвечает ни на какое ваше сообщение и его кадры не содержат повторения. Если Claude Code подхватит обычное сообщение вашего между вызовами инструментов, ход будет отвечать на это сообщение с этого момента. Повторение подхвата требует Agent SDK v0.3.265 или позже; более ранние версии ничего не повторяют на этих ходах.

1529 1533 

1530Claude Code повторяет `uuid` отвеченного сообщения на трёх видах кадра:1534Claude Code повторяет `uuid` отвеченного сообщения на трёх видах кадра:

1531 1535 

1532* **Результат**: каждый результат хода, который ответил на сообщение, которое вы отправили. Каждый такой результат содержит его на Agent SDK v0.3.265 или позже. До v0.3.265 успешный результат хода, который запустило обычное сообщение, не содержал его, когда ход не отправил запрос API или завершился отложенным вызовом инструмента. До v0.3.246 результаты ошибок также не содержали его, и до v0.3.216 каждый результат не содержал.1536* **Результат**: каждый результат хода, который ответил на сообщение, которое вы отправили. Каждый такой результат содержит его на Agent SDK v0.3.265 или позже. До v0.3.265 результат успеха хода, который запустило обычное сообщение, не содержал его, когда ход не отправил запрос API или завершился отложенным вызовом инструмента. До v0.3.246 результаты ошибок также не содержали его, и до v0.3.216 каждый результат не содержал его.

1533* **Первый ответ хода**: первое [сообщение ассистента](#sdkassistantmessage), или с `includePartialMessages` первое [событие потока](#sdkpartialassistantmessage), чьё `event.type` не является `ping`, поэтому вы можете привязать ответ перед поступлением результата. Когда ход ничего не потоком передаёт, Claude Code устанавливает его на первое сообщение ассистента вместо этого. Повтор первого ответа требует Agent SDK v0.3.246 или позже. Когда сообщение, на которое отвечает ход, изменяется в середине хода, первый ответ после изменения также содержит поле на Agent SDK v0.3.265 или позже; более ранние версии устанавливают его на один кадр ответа за ход.1537* **Первый ответ хода**: первое [сообщение ассистента](#sdkassistantmessage) или с `includePartialMessages` первое [событие потока](#sdkpartialassistantmessage), чей `event.type` не является `ping`, чтобы вы могли привязать ответ перед поступлением результата. Когда ход ничего не потоком передаёт, Claude Code устанавливает его на первое сообщение ассистента вместо этого. Повторение первого ответа требует Agent SDK v0.3.246 или позже. Когда сообщение, на которое ход отвечает, изменяется в середине хода, первый ответ после изменения также содержит это поле на Agent SDK v0.3.265 или позже; более ранние версии устанавливают его на один кадр ответа за ход.

1534* **Каждый кадр [`thinking_tokens`](#sdkthinkingtokensmessage) хода**: чтобы вы могли приписать прогресс размышления сообщению, которое вы отправили, без ожидания первого ответа хода. Требует Agent SDK v0.3.260 или позже.1538* **Каждый кадр [`thinking_tokens`](#sdkthinkingtokensmessage) хода**: чтобы вы могли отнести прогресс мышления к сообщению, которое вы отправили, без ожидания первого ответа хода. Требует Agent SDK v0.3.260 или позже.

1535 1539 

1536Claude Code опускает поле в этих случаях:1540Claude Code опускает это поле в этих случаях:

1537 1541 

1538* Кадры ответа, отличные от тех первых ответов1542* Кадры ответов, отличные от этих первых ответов

1539* Кадры подагента1543* Кадры подагента

1540* Ходы, которые не отвечают на сообщение с `uuid`: ход ответил на сообщение, которое вы отправили без одного, или Claude Code запустил ход сам и не подхватил обычное сообщение, которое имеет один1544* Ходы, которые не отвечают ни на какое сообщение с `uuid`: ход ответил на сообщение, которое вы отправили без одного, или Claude Code запустил ход сам и не подхватил обычное сообщение, которое имеет один

1541* Результаты, которые не отвечают на сообщение, которое вы отправили, такие как обнулённый результат после сбоя рабочего процесса1545* Результаты, которые не отвечают ни на какое ваше сообщение, такие как обнулённый результат после сбоя рабочего процесса

1542 1546 

1543<h4 id="user_message_uuids">1547<h4 id="user_message_uuids">

1544 `user_message_uuids`1548 `user_message_uuids`

1545</h4>1549</h4>

1546 1550 

1547`uuid`s каждого сообщения, которое вы отправили и на которое Claude Code ответил в этом ходе. Когда вы отправляете несколько сообщений близко друг к другу, Claude Code может объединить их в один ход, и `user_message_uuid` затем называет только последнее из них. Чтобы сопоставить ответ с любым из объединённых сообщений, ищите `uuid` этого сообщения где-нибудь в этом списке. Требует Agent SDK v0.3.259 или позже.1551`uuid`s каждого сообщения, которое вы отправили и на которое Claude Code ответил в этом ходу. Когда вы отправляете несколько сообщений близко друг к другу, Claude Code может объединить их в один ход, и `user_message_uuid` затем называет только последнее из них. Чтобы сопоставить ответ с любым из объединённых сообщений, ищите `uuid` этого сообщения в любом месте этого списка. Требует Agent SDK v0.3.259 или позже.

1548 1552 

1549Claude Code устанавливает список вместе с `user_message_uuid` на каждом кадре ответа, который содержит это поле, и на результате. Для полного набора кадров, которые содержат `user_message_uuid`, и версии, которую требует каждый, смотрите [`user_message_uuid`](#user_message_uuid). Список всегда содержит `user_message_uuid` и содержит максимум 64 записи.1553Claude Code устанавливает список вместе с `user_message_uuid` на каждом кадре ответа, который содержит это поле, и на результате. Для полного набора кадров, которые содержат `user_message_uuid`, и версии, которую требует каждый, см. [`user_message_uuid`](#user_message_uuid). Список всегда содержит `user_message_uuid` и содержит максимум 64 записи.

1550 1554 

1551Когда Claude Code подхватит обычное сообщение, которое вы отправили, пока ход выполнялся, он добавляет `uuid` этого сообщения в список результата.1555Когда Claude Code подхватит обычное сообщение, которое вы отправили, пока ход выполнялся, он добавляет `uuid` этого сообщения в список результата.

1552 1556 

1553Когда первый ответ или результат содержит `user_message_uuid` без списка, он поступил из более ранней версии Claude Code, поэтому вернитесь к одному полю.1557Когда первый ответ или результат содержит `user_message_uuid` без списка, он поступил из более ранней версии Claude Code, поэтому используйте одно поле.

1554 1558 

1555<h4 id="queued_turn_count">1559<h4 id="queued_turn_count">

1556 `queued_turn_count`1560 `queued_turn_count`


1560 1564 

1561Что говорят вам `0` и отсутствующее поле:1565Что говорят вам `0` и отсутствующее поле:

1562 1566 

1563* **`0`**: Claude Code не считает сообщения, которые вы отправили без этого `origin`, и не считает уведомления о задачах, поэтому ход может всё ещё следовать.1567* **`0`**: Claude Code не считает сообщения, которые вы отправили без этого `origin`, и не считает уведомления задач, поэтому ход может всё ещё следовать.

1564* **Отсутствует**: финальный результат, который Claude Code выдаёт после сбоя или фатальной ошибки при запуске, опускает поле и [может содержать обнулённые итоги](/docs/ru/agent-sdk/cost-tracking#recover-totals-after-a-session-crash).1568* **Отсутствует**: финальный результат, который Claude Code выдаёт после сбоя или фатальной ошибки запуска, опускает это поле и [может содержать обнулённые итоги](/docs/ru/agent-sdk/cost-tracking#recover-totals-after-a-session-crash).

1569 

1570<h4 id="startup_failure_reason">

1571 `startup_failure_reason`

1572</h4>

1573 

1574Почему Claude Code отказался запускаться, чтобы ваше приложение могло предложить исправление вместо повтора. Claude Code устанавливает его на результате `error_during_execution`, который он записывает перед выходом при известной ошибке запуска. Этот результат содержит обнулённые итоги, и его массив `errors` содержит тот же текст, что и stderr. Это поле отсутствует на каждом другом результате. Требует Agent SDK v0.3.274 или позже.

1575 

1576Установите `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` в `1` в [`env`](#options), чтобы получить этот результат для каждого значения `SDKStartupFailureReason`. Без этой переменной Claude Code записывает результат только для этих ошибок, а остальные заканчиваются выводом stderr, ненулевым выходом и без сообщения результата:

1577 

1578* Возобновление, которое Claude Code останавливает, потому что оно [не может вернуть сеанс в его worktree](/docs/ru/worktrees#the-session-resumes-outside-its-worktree), с `worktree_unverified` или `worktree_resume_refused`. Этот раздел говорит, какая ошибка содержит какое значение.

1579* Отказанное [`continue`](#options) разговора, который фоновый сеанс удерживает, с `session_held_by_background`. Для отказанного [`resume`](#options) такого разговора Claude Code записывает результат только когда переменная установлена.

1580 

1581```typescript theme={null}

1582type SDKStartupFailureReason =

1583 | "org_pin_api_key_conflict"

1584 | "org_verify_failed"

1585 | "org_pin_mismatch"

1586 | "managed_settings_invalid"

1587 | "remote_settings_required_unavailable"

1588 | "gateway_signin_required"

1589 | "gateway_access_denied"

1590 | "proxy_invalid"

1591 | "temp_dir_unusable"

1592 | "cwd_unavailable"

1593 | "shell_tool_missing"

1594 | "session_held_by_background"

1595 | "worktree_resume_refused"

1596 | "worktree_unverified"

1597 | "cli_version_too_old"

1598 | "bypass_root";

1599```

1600 

1601Каждое значение называет один отказ:

1602 

1603| Значение | Что остановило сеанс |

1604| :------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1605| `org_pin_api_key_conflict` | Управляемые параметры [требуют вход в первую сторону или облачный шлюз](/docs/ru/authentication#restrict-login-to-your-organization), и вместо этого настроены ключ API Anthropic, токен аутентификации или `apiKeyHelper` |

1606| `org_verify_failed` | Организация входа не смогла быть проверена против булавки, например из-за сбоя сети или отозванного токена |

1607| `org_pin_mismatch` | Вход принадлежит организации, которую булавка не разрешает |

1608| `managed_settings_invalid` | Управляемые параметры политики не смогли быть прочитаны, или булавка не называет организацию |

1609| `remote_settings_required_unavailable` | Управляемые параметры, которые требует организация, не смогли быть загружены |

1610| `gateway_signin_required` | [Облачный шлюз](/docs/ru/claude-apps-gateway) завершил этот вход |

1611| `gateway_access_denied` | Запрос управляемых параметров облачному шлюзу вернулся с 403, который [таблица устранения неполадок](/docs/ru/claude-apps-gateway-deploy#troubleshooting) шлюза охватывает |

1612| `proxy_invalid` | Параметр прокси не является полным URL |

1613| `temp_dir_unusable` | Временный каталог для каждого пользователя небезопасен или не смог быть создан |

1614| `cwd_unavailable` | Рабочий каталог был удалён, перемещён или не может быть прочитан |

1615| `shell_tool_missing` | На Windows нет доступного инструмента оболочки: Git Bash отсутствует и PowerShell отсутствует или отключён с `CLAUDE_CODE_USE_POWERSHELL_TOOL` |

1616| `session_held_by_background` | Разговор для возобновления или продолжения работает как [фоновый сеанс](/docs/ru/agent-view) |

1617| `worktree_resume_refused` | Worktree сеанса не прошёл проверки безопасности, или возобновление было запущено изнутри него. `errors` говорит, продолжится ли запуск того же возобновления без worktree |

1618| `worktree_unverified` | Worktree сеанса не смог быть проверен прямо сейчас, и повтор может быть успешным |

1619| `cli_version_too_old` | Эта версия Claude Code ниже минимума, который требует Anthropic |

1620| `bypass_root` | Режим разрешений обхода был запрошен при работе от имени root |

1565 1621 

1566<h3 id="sdksystemmessage">1622<h3 id="sdksystemmessage">

1567 `SDKSystemMessage`1623 `SDKSystemMessage`


1584 mcp_servers: {1640 mcp_servers: {

1585 name: string;1641 name: string;

1586 status: string;1642 status: string;

1643 source?: string;

1587 }[];1644 }[];

1588 model: string;1645 model: string;

1589 permissionMode: PermissionMode;1646 permissionMode: PermissionMode;


1599};1656};

1600```1657```

1601 1658 

1602`fast_mode_state` сообщает состояние [быстрого режима](/docs/ru/fast-mode) сеанса. Когда что-то блокирует быстрый режим, `fast_mode_disabled_reason` называет проверку, которая его заблокировала; поле требует Claude Code v2.1.219 или позже. Для кодов причин и их значений смотрите [`fast_mode_disabled_reason`](#sdkresultmessage) на сообщении результата.1659`fast_mode_state` сообщает состояние [fast mode](/docs/ru/fast-mode) сеанса. Когда что-то блокирует fast mode, `fast_mode_disabled_reason` называет проверку, которая его заблокировала; это поле требует Claude Code v2.1.219 или позже. Для кодов причин и их значений см. [`fast_mode_disabled_reason`](#sdkresultmessage) на сообщении результата.

1603 1660 

1604`terminal_slash_commands` называет записи в `slash_commands`, чей интерфейс привязан к локальному терминалу, такие как `exit`. Вы можете отправлять их как любую другую запись в `slash_commands`; поле существует, чтобы удалённый или мобильный клиент мог скрыть их из своих меню команд. Поле присутствует только, когда не пусто, и требует Agent SDK v0.3.229 или позже.1661`terminal_slash_commands` называет записи в `slash_commands`, чей интерфейс привязан к локальному терминалу, такие как `exit`. Вы можете отправлять их как любую другую запись в `slash_commands`; это поле существует, чтобы удалённый или мобильный клиент мог скрыть их из своих меню команд. Это поле присутствует только когда оно не пусто, и требует Agent SDK v0.3.229 или позже.

1605 1662 

1606*1663*

1607 1664 

1608`effort`: [уровень усилий](/docs/ru/model-config#adjust-effort-level), который Claude Code отправляет на следующий запрос сеанса, или `null`, когда он не отправляет ни один. Claude Code устанавливает поле только на сообщение инициализации, которое отправляет клиентам [Remote Control](/docs/ru/remote-control), и опускает его из сообщения инициализации, которое читает ваше приложение. Требует Agent SDK v0.3.234 или позже.1665`source` на каждой записи `mcp_servers`: откуда поступило определение сервера, с теми же значениями, что и `source` [`McpServerStatus`](#mcpserverstatus). Требует Agent SDK v0.3.274 или позже.

1609 1666 

1610Массив `capabilities` называет поведения протокола, которые реализует этот CLI, поэтому вы можете обнаруживать функции вместо сравнения строк `claude_code_version`. Это открытый набор: игнорируйте значения, которые вы не распознаёте, и проверяйте конкретную возможность, поведение которой вы используете. Поле требует Claude Code v2.1.205 или позже и отсутствует на более ранних CLI.1667*

1668 

1669`effort`: [уровень усилий](/docs/ru/model-config#adjust-effort-level), который Claude Code отправляет на следующий запрос сеанса, или `null`, когда он не отправляет ни один. Claude Code устанавливает это поле только на сообщение инициализации, которое оно отправляет клиентам [Remote Control](/docs/ru/remote-control), и опускает его из сообщения инициализации, которое читает ваше приложение. Требует Agent SDK v0.3.234 или позже.

1670 

1671Массив `capabilities` называет поведения протокола, которые реализует этот CLI, чтобы вы могли обнаруживать функции вместо сравнения строк `claude_code_version`. Это открытый набор: игнорируйте значения, которые вы не узнаёте, и проверяйте конкретную возможность, поведение которой вы используете. Это поле требует Claude Code v2.1.205 или позже и отсутствует на более ранних CLI.

1611 1672 

1612| Возможность | Значение |1673| Возможность | Значение |

1613| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1674| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1614| `interrupt_receipt_v1` | [`interrupt()`](#query-object) разрешается с помощью [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse), квитанции, называющей сообщения, которые были в очереди, когда прерывание прибыло |1675| `interrupt_receipt_v1` | [`interrupt()`](#query-object) разрешается с помощью [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse), квитанции, в которой перечислены сообщения, которые были в ожидании при поступлении прерывания |

1615| `interrupt_cancel_queued_v1` | Запрос управления `interrupt` соблюдает `cancel_queued: true`, отменяя сообщения, которые квитанция иначе перечислила бы под `still_queued`, и перечисляя их под `cancelled` вместо этого. Смотрите [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse). Требует Claude Code v2.1.219 или позже |1676| `interrupt_cancel_queued_v1` | Запрос управления `interrupt` соблюдает `cancel_queued: true`, отменяя сообщения, которые квитанция в противном случае перечислила бы в `still_queued`, и перечисляя их в `cancelled` вместо этого. См. [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse). Требует Claude Code v2.1.219 или позже |

1616 1677 

1617<h3 id="sdkpartialassistantmessage">1678<h3 id="sdkpartialassistantmessage">

1618 `SDKPartialAssistantMessage`1679 `SDKPartialAssistantMessage`

1619</h3>1680</h3>

1620 1681 

1621Потоковое частичное сообщение (только когда `includePartialMessages` равен true). Поле `parent_tool_use_id` всегда имеет значение `null`: события потока выдаются только для основного сеанса. Для атрибуции подагента используйте полные сообщения, которые содержат `parent_tool_use_id`, или включите [`forwardSubagentText`](#options) для получения текста и размышлений подагента в виде полных сообщений.1682Потоковое частичное сообщение (только когда `includePartialMessages` имеет значение true). Поле `parent_tool_use_id` всегда `null`: события потока выдаются только для основного сеанса. Для атрибуции подагента используйте полные сообщения, которые содержат `parent_tool_use_id`, или включите [`forwardSubagentText`](#options), чтобы получать текст и мышление подагента как полные сообщения.

1622 1683 

1623```typescript theme={null}1684```typescript theme={null}

1624type SDKPartialAssistantMessage = {1685type SDKPartialAssistantMessage = {

1625 type: "stream_event";1686 type: "stream_event";

1626 event: BetaRawMessageStreamEvent; // Из Anthropic SDK1687 event: BetaRawMessageStreamEvent; // From Anthropic SDK

1627 parent_tool_use_id: string | null;1688 parent_tool_use_id: string | null;

1628 uuid: UUID;1689 uuid: UUID;

1629 session_id: string;1690 session_id: string;

1630 ttft_ms?: number; // Время до первого токена в мс, присутствует только на событиях message_start1691 ttft_ms?: number; // Time to first token in ms, present only on message_start events

1631 user_message_uuid?: string;1692 user_message_uuid?: string;

1632 user_message_uuids?: string[];1693 user_message_uuids?: string[];

1633};1694};

1634```1695```

1635 1696 

1636Claude Code устанавливает `user_message_uuid` и `user_message_uuids` на первое событие потока хода, не являющееся ping, и снова, когда сообщение, на которое отвечает ход, изменяется, при условиях в [`user_message_uuid`](#user_message_uuid).1697Claude Code устанавливает `user_message_uuid` и `user_message_uuids` на первое событие потока без ping хода и снова, когда сообщение, на которое ход отвечает, изменяется, при условиях в [`user_message_uuid`](#user_message_uuid).

1637 1698 

1638<h3 id="sdkcompactboundarymessage">1699<h3 id="sdkcompactboundarymessage">

1639 `SDKCompactBoundaryMessage`1700 `SDKCompactBoundaryMessage`

1640</h3>1701</h3>

1641 1702 

1642Сообщение, указывающее границу компактирования диалога.1703Сообщение, указывающее границу компактирования разговора.

1643 1704 

1644```typescript theme={null}1705```typescript theme={null}

1645type SDKCompactBoundaryMessage = {1706type SDKCompactBoundaryMessage = {


1658 `SDKInformationalMessage`1719 `SDKInformationalMessage`

1659</h3>1720</h3>

1660 1721 

1661Универсальный текстовый баннер, выданный циклом. Содержит строки статуса без ошибок, обратную связь hook, такую как причина блокировки hook `UserPromptSubmit`, и вывод команды. На Claude Code v2.1.227 или позже, [`systemMessage`](/docs/ru/hooks#json-output) hook может прибыть как это сообщение, с каждой строкой с префиксом имени hook, такой как `PostToolUse:Bash says:`. Прибывает ли `systemMessage` hook как это сообщение, зависит от события. Каждый [раздел события](/docs/ru/hooks#hook-events) на странице hooks говорит, как выводится вывод. Отобразите `content` как простой текст на заданном `level`.1722Общий текстовый баннер, выданный циклом. Содержит строки статуса без ошибок, обратную связь хука, такую как причина блокировки хука `UserPromptSubmit`, и вывод команды. На Claude Code v2.1.227 или позже [`systemMessage`](/docs/ru/hooks#json-output) хука может поступить как это сообщение, с каждой строкой с префиксом имени хука, такой как `PostToolUse:Bash says:`. Поступает ли `systemMessage` хука как это сообщение, зависит от события. Каждый [раздел события](/docs/ru/hooks#hook-events) на странице hooks говорит, как выводится вывод. Выполняйте рендеринг `content` как простого текста на заданном `level`.

1662 1723 

1663```typescript theme={null}1724```typescript theme={null}

1664type SDKInformationalMessage = {1725type SDKInformationalMessage = {


1677 `SDKWorkerShuttingDownMessage`1738 `SDKWorkerShuttingDownMessage`

1678</h3>1739</h3>

1679 1740 

1680Выданное при корректном завершении работника, чтобы удалённые клиенты могли показать, почему работник исчез, вместо ожидания истечения времени ожидания сердцебиения. `reason` это короткая строка в формате snake\_case, установленная хост-CLI, такая как `"host_exit"` или `"remote_control_disabled"`. Действуйте на основе этого только при потоковой передаче в реальном времени. Возобновленный сеанс воспроизводит прошлые экземпляры этого сообщения, поэтому игнорируйте их в этом случае.1741Выданное при корректном завершении рабочего процесса, чтобы удалённые клиенты могли показать, почему рабочий процесс вышел, вместо ожидания истечения времени ожидания сердцебиения. `reason` — это короткая строка snake\_case, установленная хостом CLI, такая как `"host_exit"` или `"remote_control_disabled"`. Действуйте на это только при потоковой передаче в реальном времени. Возобновленный сеанс воспроизводит прошлые экземпляры этого сообщения, поэтому игнорируйте их в этом случае.

1681 1742 

1682```typescript theme={null}1743```typescript theme={null}

1683type SDKWorkerShuttingDownMessage = {1744type SDKWorkerShuttingDownMessage = {


1693 `SDKPluginInstallMessage`1754 `SDKPluginInstallMessage`

1694</h3>1755</h3>

1695 1756 

1696Событие прогресса установки plugin. Выдаётся, когда установлена [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/ru/env-vars), поэтому ваше приложение Agent SDK может отслеживать установку marketplace plugin перед первым ходом. Статусы `started` и `completed` заключают в скобки общую установку. Статусы `installed` и `failed` сообщают об отдельных marketplaces и включают `name`.1757Событие прогресса установки плагина. Выданное когда [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/ru/env-vars) установлен, чтобы ваше приложение Agent SDK могло отслеживать установку плагина marketplace перед первым ходом. Статусы `started` и `completed` заключают общую установку. Статусы `installed` и `failed` сообщают об отдельных marketplaces и включают `name`.

1697 1758 

1698```typescript theme={null}1759```typescript theme={null}

1699type SDKPluginInstallMessage = {1760type SDKPluginInstallMessage = {


1711 `SDKPermissionDeniedMessage`1772 `SDKPermissionDeniedMessage`

1712</h3>1773</h3>

1713 1774 

1714Событие потока, выданное, когда система разрешений отклоняет вызов инструмента без интерактивного запроса. Используйте его для отображения отклонения в вашем пользовательском интерфейсе по мере его возникновения, а не только наблюдая результат инструмента `is_error`, который следует за ним. Какие отклонения оно сообщает, зависит от того, как запуск обрабатывает запросы разрешений:1775Событие потока, выданное когда система разрешений отказывает в вызове инструмента без интерактивного приглашения. Используйте его для отображения отказа в вашем пользовательском интерфейсе по мере его возникновения, а не только наблюдая результат инструмента `is_error`, который следует. Какие отказы оно сообщает, зависит от того, как запуск обрабатывает приглашения разрешений:

1715 1776 

1716* **С callback [`canUseTool`](#canusetool) и по умолчанию [`permissionPrompts: 'host'`](#options)**: запросы разрешений идут в ваш callback, и это событие сообщает об отклонениях, которые Claude Code решает самостоятельно без его вызова.1777* **С обратным вызовом [`canUseTool`](#canusetool) и значением по умолчанию [`permissionPrompts: 'host'`](#options)**: приглашения разрешений идут в ваш обратный вызов, и это событие сообщает об отказах, которые Claude Code решает самостоятельно без его вызова.

1717* **Ни с чем**: голый запуск `-p` или `query()`, который не устанавливает ни `canUseTool`, ни `permissionPromptToolName`, отклоняет любой вызов инструмента, который бы запросил, и это событие сообщает об этих отклонениях, а также об отклонениях, которые Claude Code решает самостоятельно. До v2.1.223 Claude Code не выдавал это событие в запусках без callback.1778*

1718* **С инструментом запроса MCP**, установленным с `permissionPromptToolName` или флагом [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags), и по умолчанию `permissionPrompts: 'host'`: Claude Code вообще не выдаёт это событие, даже для отклонений правил, которые оно решает самостоятельно.

1719* **С [`permissionPrompts: 'none'`](#options)**: Claude Code отклоняет вызовы, которые бы запросили, даже когда также установлены `canUseTool` или инструмент запроса MCP, и это событие сообщает об этих отклонениях, а также об отклонениях, которые Claude Code решает самостоятельно. Требует Claude Code v2.1.259 или позже.

1720 1779 

1721В каждой конфигурации это событие пропускает любое отклонение, решённое на пути hook `PreToolUse`, независимо от того, отклонил ли hook вызов сам или правило отрицания переопределило решение hook разрешить или спросить. Событие также является лучшим усилием: иногда Claude Code записывает отклонение без выдачи этого события, поэтому `permission_denials` на [сообщении результата](#sdkresultmessage) является авторитетным записью.1780**Без ни одного**: голый запуск `-p` или `query()`, который не устанавливает ни `canUseTool`, ни `permissionPromptToolName`, отказывает любому вызову инструмента, который бы подсказал, и это событие сообщает об этих отказах, а также об отказах, которые Claude Code решает самостоятельно. До v2.1.223 Claude Code не выдавал это событие в запусках без обратного вызова.

1781 

1782* **С инструментом приглашения MCP**, установленным с `permissionPromptToolName` или флагом [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags), и значением по умолчанию `permissionPrompts: 'host'`: Claude Code вообще не выдаёт это событие, даже для отказов правила, которые он решает самостоятельно.

1783*

1784 

1785**С [`permissionPrompts: 'none'`](#options)**: Claude Code отказывает вызовам, которые бы подсказали, даже когда также установлены `canUseTool` или инструмент приглашения MCP, и это событие сообщает об этих отказах, а также об отказах, которые Claude Code решает самостоятельно. Требует Claude Code v2.1.259 или позже.

1786 

1787В каждой конфигурации это событие пропускает любой отказ, решённый на пути хука `PreToolUse`, отказал ли сам хук вызову или правило отрицания переопределило решение хука разрешить или спросить. Это событие также является лучшим усилием: иногда Claude Code записывает отказ без выдачи этого события, поэтому `permission_denials` на [сообщении результата](#sdkresultmessage) является авторитетным записью.

1722 1788 

1723```typescript theme={null}1789```typescript theme={null}

1724type SDKPermissionDeniedMessage = {1790type SDKPermissionDeniedMessage = {


1736```1802```

1737 1803 

1738| Поле | Тип | Описание |1804| Поле | Тип | Описание |

1739| ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |1805| ---------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- |

1740| `tool_name` | `string` | Имя инструмента, который был отклонён |1806| `tool_name` | `string` | Имя инструмента, который был отказан |

1741| `tool_use_id` | `string` | ID блока `tool_use`, на который отвечает это отклонение |1807| `tool_use_id` | `string` | ID блока `tool_use`, на который этот отказ отвечает |

1742| `agent_id` | `string` | ID подагента, когда отклонённый вызов возник внутри подагента. Зеркалирует поле на `can_use_tool` для маршрутизации на стороне хоста |1808| `agent_id` | `string` | ID подагента, когда отказанный вызов возник внутри подагента. Зеркалирует поле на `can_use_tool` для маршрутизации на стороне хоста |

1743| `decision_reason_type` | `string` | Дискриминатор для компонента, который принял решение, такой как `"rule"`, `"mode"`, `"classifier"` или `"asyncAgent"` |1809| `decision_reason_type` | `string` | Дискриминатор для компонента, который решил, такой как `"rule"`, `"mode"`, `"classifier"` или `"asyncAgent"` |

1744| `decision_reason` | `string` | Понятная человеку причина от компонента, принявшего решение, если доступна |1810| `decision_reason` | `string` | Понятная причина от решающего компонента, когда доступна |

1745| `message` | `string` | Сообщение об отказе, возвращённое модели в `tool_result` |1811| `message` | `string` | Сообщение об отказе, возвращённое модели в `tool_result` |

1746 1812 

1747<h3 id="sdkpermissiondenial">1813<h3 id="sdkpermissiondenial">

1748 `SDKPermissionDenial`1814 `SDKPermissionDenial`

1749</h3>1815</h3>

1750 1816 

1751Информация об отклонённом использовании tool.1817Информация об отказанном использовании инструмента.

1752 1818 

1753```typescript theme={null}1819```typescript theme={null}

1754type SDKPermissionDenial = {1820type SDKPermissionDenial = {


1802Таблица перечисляет, что Claude Code помещает в каждое поле. Поля от `model` до `over_limit` описывают сеанс в целом, и поля коллекции приписывают токены отдельным элементам.1868Таблица перечисляет, что Claude Code помещает в каждое поле. Поля от `model` до `over_limit` описывают сеанс в целом, и поля коллекции приписывают токены отдельным элементам.

1803 1869 

1804| Поле | Тип | Описание |1870| Поле | Тип | Описание |

1805| ---------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1871| ---------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1806| `model` | `string` | Модель основного цикла, для которой Claude Code вычислил использование, а не подагента |1872| `model` | `string` | Модель основного цикла, для которой Claude Code вычислил использование, а не подагента |

1807| `total_tokens` | `number` | Оценка Claude Code токенов в использовании. Не зажата в окно, поэтому может превышать `raw_max_tokens`, когда сеанс превышает лимит |1873| `total_tokens` | `number` | Оценка Claude Code токенов в использовании. Не зажата в окно, поэтому может превышать `raw_max_tokens`, когда сеанс превышает лимит |

1808| `raw_max_tokens` | `number` | Контекстное окно модели или нижнее [окно автокомпактирования](/docs/ru/model-config#context-window-and-auto-compaction), когда оно применяется, такое как установленное вами или граница 200K, которую Claude Code применяет к некоторым моделям с окном 1M-токена. Claude Code измеряет `total_tokens` против этого окна |1874| `raw_max_tokens` | `number` | Контекстное окно модели или нижнее [окно auto-compact](/docs/ru/model-config#context-window-and-auto-compaction), когда оно применяется, такое как установленное вами или граница 200K, которую Claude Code применяет к некоторым моделям с окном 1M-токена. Claude Code измеряет `total_tokens` против этого окна |

1809| `percentage` | `number` | `total_tokens` как округлённый процент `raw_max_tokens`, поэтому может превышать 100, когда сеанс превышает лимит |1875| `percentage` | `number` | `total_tokens` как округлённый процент `raw_max_tokens`, поэтому может превышать 100, когда сеанс превышает лимит |

1810| `over_limit` | `object` | Присутствует только, когда `total_tokens` превышает `raw_max_tokens`. `tokens_over` это количество превышения, и `kind` говорит, как Claude Code разрешил окно |1876| `over_limit` | `object` | Присутствует только когда `total_tokens` превышает `raw_max_tokens`. `tokens_over` — это количество превышения, и `kind` говорит, как Claude Code разрешил окно |

1811| `categories` | [`SDKContextUsageCategory`](#sdkcontextusagecategory)`[]` | Одна запись на строку разбивки использования по категориям |1877| `categories` | [`SDKContextUsageCategory`](#sdkcontextusagecategory)`[]` | Одна запись на строку разбивки использования по категориям |

1812| `mcp_tools` | `object[]` | Токены, приписанные каждому инструменту MCP, с его проводным именем, таким как `mcp__linear__create_issue`, и его `server_name` |1878| `mcp_tools` | `object[]` | Токены, приписанные каждому инструменту MCP, с его проводным именем, таким как `mcp__linear__create_issue`, и его `server_name` |

1813| `memory_files` | `object[]` | Токены, приписанные каждому загруженному файлу памяти, с его `path` и меткой источника, такой как `Project` или `User`, в `type` |1879| `memory_files` | `object[]` | Токены, приписанные каждому загруженному файлу памяти, с его `path` и меткой источника, такой как `Project` или `User` в `type` |

1814| `agents` | `object[]` | Токены, приписанные каждому определению пользовательского подагента, с идентификатором источника, таким как `projectSettings`, `userSettings` или `plugin`. Встроенные подагенты не перечислены |1880| `agents` | `object[]` | Токены, приписанные каждому определению пользовательского подагента, с идентификатором источника, таким как `projectSettings`, `userSettings` или `plugin`. Встроенные подагенты не перечислены |

1815| `skills` | `object[]` | Токены, приписанные каждому навыку в списке навыков, с идентификатором источника и, для навыков plugin, именем plugin в `plugin_name`. Отсутствует, когда никакие навыки не вносят токены |1881| `skills` | `object[]` | Токены, приписанные каждому навыку в списке навыков, с идентификатором источника и, для навыков плагина, именем плагина в `plugin_name`. Отсутствует, когда никакие навыки не вносят токены |

1816 1882 

1817`over_limit.kind` записывает, как Claude Code разрешил окно, а не принимает ли API следующий запрос:1883`over_limit.kind` записывает, как Claude Code разрешил окно, а не принимает ли API следующий запрос:

1818 1884 

1819* `hard_limit`: окно это то, что Claude Code считает собственным лимитом модели, за которым API отказывает запросы1885* `hard_limit`: окно — это то, что Claude Code считает собственным лимитом модели, за пределами которого API отказывает запросы

1820* `compaction_window`: окно это окно политики компактирования, которое может совпадать или не совпадать с лимитом модели1886* `compaction_window`: окно — это окно политики компактирования, которое может совпадать или не совпадать с лимитом модели

1821 1887 

1822Claude Code развивает тип аддитивно, добавляя новые данные как опциональные поля, а не переформатируя существующие. Читайте поля, которые вы знаете, и игнорируйте любые, которые вы не распознаёте.1888Claude Code развивает тип аддитивно, добавляя новые данные как необязательные поля, а не переформатируя существующие. Читайте поля, которые вы знаете, и игнорируйте те, которые вы не узнаёте.

1823 1889 

1824<h3 id="sdkcontextusagecategory">1890<h3 id="sdkcontextusagecategory">

1825 `SDKContextUsageCategory`1891 `SDKContextUsageCategory`


1838Таблица перечисляет, что Claude Code помещает в каждое поле строки.1904Таблица перечисляет, что Claude Code помещает в каждое поле строки.

1839 1905 

1840| Поле | Тип | Описание |1906| Поле | Тип | Описание |

1841| -------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |1907| -------- | -------- | ---------------------------------------------------------------------------------------------------------------------- |

1842| `name` | `string` | Отображаемое имя строки, как `/context` его печатает, такое как `Messages`. Классифицируйте строки по `kind`, а не по имени |1908| `name` | `string` | Имя отображения строки, как печатает `/context`, такое как `Messages`. Классифицируйте строки по `kind`, а не по имени |

1843| `tokens` | `number` | Количество токенов строки. Строки могут содержать нулевые токены |1909| `tokens` | `number` | Количество токенов строки. Строки могут содержать нулевые токены |

1844| `kind` | `string` | Что представляет строка: `used`, `free`, `buffer` или `deferred` |1910| `kind` | `string` | Что представляет строка: `used`, `free`, `buffer` или `deferred` |

1845 1911 


1848* `used`: содержимое, которое занимает контекстное окно1914* `used`: содержимое, которое занимает контекстное окно

1849* `free`: оставшееся окно1915* `free`: оставшееся окно

1850* `buffer`: резерв компактирования1916* `buffer`: резерв компактирования

1851* `deferred`: схемы инструментов, которые Claude Code держит вне окна и исключает из расчёта использования, перечисленные для осведомления1917* `deferred`: схемы инструментов, которые Claude Code удерживает вне окна и исключает из расчёта использования, перечисленные для осведомления

1852 1918 

1853<h3 id="sdkmessageorigin">1919<h3 id="sdkmessageorigin">

1854 `SDKMessageOrigin`1920 `SDKMessageOrigin`

1855</h3>1921</h3>

1856 1922 

1857Происхождение сообщения с ролью пользователя. Это появляется как `origin` на [`SDKUserMessage`](#sdkusermessage) и передаётся на соответствующее [`SDKResultMessage`](#sdkresultmessage), чтобы вы могли определить, что запустило данный ход.1923Происхождение сообщения с ролью пользователя. Это появляется как `origin` на [`SDKUserMessage`](#sdkusermessage) и пересылается на соответствующее [`SDKResultMessage`](#sdkresultmessage), чтобы вы могли сказать, что запустило данный ход.

1858 1924 

1859```typescript theme={null}1925```typescript theme={null}

1860type SDKMessageOrigin =1926type SDKMessageOrigin =


1880```1946```

1881 1947 

1882| `kind` | Значение |1948| `kind` | Значение |

1883| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1949| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

1884| `human` | Прямой ввод от конечного пользователя. Если ваше приложение передаёт то, что пользователь напечатал, как пользовательское сообщение, установите его `origin` на `{ kind: "human" }` явно: Claude Code рассматривает пользовательское сообщение без `origin` как неатрибутированное и проверяет, которые требуют запроса, напечатанного человеком, такие как [`ultracode` ключевое слово workflow](/docs/ru/workflows#ask-for-a-workflow-in-your-prompt), не принимают его. До v2.1.210 Claude Code рассматривал отсутствующий `origin` на пользовательском сообщении как ввод человека. |1950| `human` | Прямой ввод от конечного пользователя. Если ваше приложение пересылает то, что пользователь напечатал, как пользовательское сообщение, установите его `origin` в `{ kind: "human" }` явно: Claude Code рассматривает пользовательское сообщение без `origin` как неатрибутированное и проверяет, что требуют подсказку, введённую человеком, такие как ключевое слово [`ultracode` workflow](/docs/ru/workflows#ask-for-a-workflow-in-your-prompt), не принимают её. До v2.1.210 Claude Code рассматривал отсутствующий `origin` на пользовательском сообщении как пользовательский ввод. |

1885| `channel` | Сообщение, поступающее на [канал](/docs/ru/channels). `server` это имя исходного MCP сервера. |1951| `channel` | Сообщение, поступающее на [канал](/docs/ru/channels). `server` — это имя исходного сервера MCP. |

1886| `peer` | Сообщение от другого агента: внутрипроцессный [товарищ по команде](/docs/ru/agent-teams) или [кросс-сеансовый пир](/docs/ru/cross-session-messaging), другой из ваших сеансов Claude Code. Смотрите [Поля происхождения пира](#peer-origin-fields) для семантики каждого поля и модели доверия. |1952| `peer` | Сообщение от другого агента: внутрипроцессный [товарищ по команде](/docs/ru/agent-teams) или [кросс-сеансный одноранговый](/docs/ru/cross-session-messaging), другой из ваших сеансов Claude Code. См. [Peer origin fields](#peer-origin-fields) для семантики каждого поля и модели доверия. |

1887| `task-notification` | Синтетический ход, внедрённый для доставки, которая прибывает без свежего запроса пользователя, такой как завершённая фоновая задача; смотрите [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) для этого варианта. Опциональный `subkind` отмечает, что вызвало уведомление. Смотрите [Подвиды уведомлений о задачах](#task-notification-subkinds). |1953| `task-notification` | Синтетический ход, внедрённый для доставки, которая поступает без свежей подсказки пользователя, такой как завершённая фоновая задача; см. [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) для этого варианта. Необязательный `subkind` отмечает, что вызвало уведомление. См. [Task-notification subkinds](#task-notification-subkinds). |

1888| `coordinator` | Сообщение от координатора команды в [команде агентов](/docs/ru/agent-teams). |1954| `coordinator` | Сообщение от координатора команды в [команде агентов](/docs/ru/agent-teams). |

1889| `auto-continuation` | Синтетический ход, внедрённый, когда сеанс продолжается без свежего пользовательского ввода, такой как результат команды, который запускает последующий запрос. |1955| `auto-continuation` | Синтетический ход, внедрённый когда сеанс продолжается без свежего пользовательского ввода, такой как результат команды, который запускает подсказку продолжения. |

1890| `unclassified` | Внедрённый ход, чьё происхождение не удалось определить. Требует Claude Code v2.1.223 или позже. Когда Claude Code получает [`SDKUserMessage`](#sdkusermessage) с `isSynthetic: true` и не может классифицировать его как любой другой `kind`, он устанавливает этот вид по мере поступления сообщения и кадрирует ход модели как источник, не являющийся пользователем, а не рассматривает его как ввод человека. Ваше приложение не должно устанавливать это значение. |1956| `unclassified` | Внедрённый ход, чьё происхождение не смогло быть определено. Требует Claude Code v2.1.223 или позже. Когда Claude Code получает [`SDKUserMessage`](#sdkusermessage) с `isSynthetic: true` и не может классифицировать его как любой другой `kind`, он устанавливает этот вид по мере поступления сообщения и кадрирует ход модели как источник, отличный от пользователя, а не рассматривает его как пользовательский ввод. Ваше приложение не должно устанавливать это значение. |

1891 1957 

1892<h3 id="task-notification-subkinds">1958<h3 id="task-notification-subkinds">

1893 Подвиды уведомлений о задачах1959 Task-notification subkinds

1894</h3>1960</h3>

1895 1961 

1896Когда Claude Code доставляет уведомление о задаче в сеанс, он устанавливает `subkind` на `origin` уведомления только если серверы Anthropic проверили, откуда поступило это уведомление. `subkind` требует Claude Code v2.1.213 или позже и принимает одно из двух значений:1962Когда Claude Code доставляет уведомление задачи в сеанс, он устанавливает `subkind` на `origin` уведомления только если серверы Anthropic проверили, откуда поступило это уведомление. `subkind` требует Claude Code v2.1.213 или позже и принимает одно из двух значений:

1897 1963 

1898* `scheduled-trigger`: уведомление это сохранённый запрос [подпрограммы](/docs/ru/routines), доставленный, потому что один из триггеров подпрограммы сработал: её расписание, её [триггер API](/docs/ru/routines#add-an-api-trigger), её [триггер GitHub](/docs/ru/routines#add-a-github-trigger) или **Запустить сейчас**. Claude Code кадрирует их модели как назначенную задачу сеанса с другим уведомлением от [уведомления, которое несут другие уведомления о задачах](#sdktasknotificationmessage).1964* `scheduled-trigger`: уведомление — это сохранённая подсказка [подпрограммы](/docs/ru/routines), доставленная, потому что один из триггеров подпрограммы сработал: её расписание, её [API триггер](/docs/ru/routines#add-an-api-trigger), её [GitHub триггер](/docs/ru/routines#add-a-github-trigger) или **Run now**. Claude Code кадрирует их модели как назначенную задачу сеанса, с другим уведомлением от [уведомления, которое несут другие уведомления задач](#sdktasknotificationmessage).

1899*1965*

1900 1966 

1901`peer-send-message`: уведомление это сообщение, которое другой из ваших сеансов отправил с инструментом `send_message` на стороне сервера, который используют сеансы [Claude Code на веб-сайте](/docs/ru/claude-code-on-the-web) для обмена сообщениями друг с другом, а не [кросс-сеансовый инструмент `SendMessage`](/docs/ru/cross-session-messaging), и серверы Anthropic проверили, что оба сеанса принадлежат одной и той же приватной группе сеансов. Требует Claude Code v2.1.224 или позже. Доставка `send_message`, которую серверы не проверили таким образом, не получает `subkind`.1967`peer-send-message`: уведомление — это сообщение, которое другой из ваших сеансов отправил с инструментом `send_message` на стороне сервера, который используют [облачные сеансы](/docs/ru/claude-code-on-the-web) для обмена сообщениями друг с другом, а не [кросс-сеансный инструмент `SendMessage`](/docs/ru/cross-session-messaging), и серверы Anthropic проверили, что оба сеанса принадлежат одной и той же приватной группе сеансов. Требует Claude Code v2.1.224 или позже. Доставка `send_message`, которую серверы не проверили таким образом, не получает `subkind`.

1902 1968 

1903Каждое другое уведомление о задаче не имеет `subkind`. Это включает [запланированные задачи](/docs/ru/scheduled-tasks), которые срабатывают на вашей собственной машине, [активность PR](/docs/ru/claude-code-on-the-web#how-claude-responds-to-pr-activity), доставленную в сеанс, и фоновые события, такие как завершённая задача. Сообщения от [кросс-сеансового инструмента `SendMessage`](/docs/ru/cross-session-messaging) вообще не являются уведомлениями о задачах: независимо от того, поступают ли они из сеанса на той же машине или через серверы Anthropic с другой машины, Claude Code даёт им `kind: "peer"` и [поля происхождения пира](#peer-origin-fields).1969Каждое другое уведомление задачи не имеет `subkind`. Это включает [запланированные задачи](/docs/ru/scheduled-tasks), которые срабатывают на вашей собственной машине, [активность PR](/docs/ru/claude-code-on-the-web#how-claude-responds-to-pr-activity), доставленную в сеанс, и фоновые события, такие как завершённая задача. Сообщения от [кросс-сеансного инструмента `SendMessage`](/docs/ru/cross-session-messaging) вообще не являются уведомлениями задач: поступают ли они из сеанса на той же машине или через серверы Anthropic с другой машины, Claude Code даёт им `kind: "peer"` и [поля происхождения одноранговой сети](#peer-origin-fields).

1904 1970 

1905<h3 id="peer-origin-fields">1971<h3 id="peer-origin-fields">

1906 Поля происхождения пира1972 Peer origin fields

1907</h3>1973</h3>

1908 1974 

1909Происхождение `peer` идентифицирует, какой агент отправил сообщение: внутрипроцессный [товарищ по команде](/docs/ru/agent-teams), отправляющий на `main` с `SendMessage`, или [кросс-сеансовый пир](/docs/ru/cross-session-messaging), другой из ваших сеансов Claude Code. Кросс-сеансовые пиры требуют Claude Code v2.1.224 или позже на macOS и Linux; смотрите [доступность кросс-сеансового обмена сообщениями](/docs/ru/cross-session-messaging#availability) для требования собственного Windows. Кросс-сеансовый пир может работать на той же машине или на [другой из ваших машин](/docs/ru/cross-session-messaging#message-sessions-on-other-machines) или [Claude Code на веб-сайте](/docs/ru/claude-code-on-the-web), когда его сообщение прибывает через Remote Control. Два вида отправителя заполняют поля по-разному:1975Происхождение `peer` идентифицирует, какой агент отправил сообщение: внутрипроцессный [товарищ по команде](/docs/ru/agent-teams), отправляющий в `main` с `SendMessage`, или [кросс-сеансный одноранговый](/docs/ru/cross-session-messaging), другой из ваших сеансов Claude Code. Кросс-сеансные одноранговые требуют Claude Code v2.1.224 или позже на macOS и Linux; см. [доступность кросс-сеансного обмена сообщениями](/docs/ru/cross-session-messaging#availability) для требования собственного Windows. Кросс-сеансный одноранговый может работать на той же машине или на [другой из ваших машин](/docs/ru/cross-session-messaging#message-sessions-on-other-machines) или [в облаке](/docs/ru/claude-code-on-the-web), когда его сообщение поступает через Remote Control. Два вида отправителя заполняют поля по-разному:

1910 1976 

1911* `from`: имя товарища по команде или адрес отправителя для кросс-сеансового пира. Для [одностороннего кросс-машинного сообщения](/docs/ru/cross-session-messaging#message-sessions-on-other-machines) отправитель не имеет адреса ответа и `from` это `"unknown"`. Значение создано отправителем; `verifiedPeerPid` это проверенная идентичность.1977* `from`: имя товарища по команде или адрес отправителя для кросс-сеансного одноранговой. Для [одностороннего кросс-машинного сообщения](/docs/ru/cross-session-messaging#message-sessions-on-other-machines) отправитель не имеет адреса ответа и `from` — это `"unknown"`. Значение создано отправителем; `verifiedPeerPid` — это проверенная личность.

1912*1978*

1913 1979 

1914`fromMode`: класс разрешений отправляющего сеанса, `bypass` или `prompting`, объявленный хостом, который передаёт сообщение пира между вашими сеансами, такой как [настольное приложение](/docs/ru/desktop#work-across-sessions). Claude Code читает его в получающем сеансе, когда применяет [входящие элементы управления](/docs/ru/cross-session-messaging#control-inbound-messages). Требует Agent SDK v0.3.234 или позже.1980`fromMode`: класс разрешений отправляющего сеанса, `bypass` или `prompting`, объявленный хостом, который передаёт одноранговое сообщение между вашими сеансами, такой как [настольное приложение](/docs/ru/desktop#work-across-sessions). Claude Code читает его в получающем сеансе, когда применяет [входящие элементы управления](/docs/ru/cross-session-messaging#control-inbound-messages). Требует Agent SDK v0.3.234 или позже.

1915 1981 

1916* `senderTaskId`: ID задачи товарища по команде. Отсутствует для кросс-сеансового пира.1982* `senderTaskId`: ID задачи товарища по команде. Отсутствует для кросс-сеансного одноранговой.

1917*1983*

1918 1984 

1919`name`: отображаемое имя отправителя, нормализованное Claude Code: оно удаляет управляющие символы Unicode, формат, суррогаты и разделители строк или абзацев, затем обрезает результат и ограничивает его 64 кодовыми точками с многоточием. Требует Claude Code v2.1.205 или позже.1985`name`: отображаемое имя отправителя, нормализованное Claude Code: оно удаляет управление Unicode, формат, суррогат и разделители строк или абзацев, затем обрезает результат и ограничивает его 64 кодовыми точками с многоточием. Требует Claude Code v2.1.205 или позже.

1920 1986 

1921*1987*

1922 1988 

1923`body`: декодированное тело сообщения с удалённой оболочкой пира, побайтово совпадающее с тем, что видит модель. Всегда присутствует для сообщения товарища по команде; для кросс-сеансового пира присутствует только, когда ход точно представляет собой одну оболочку пира, сформированную Claude Code. Отобразите `name` и `body` вместо повторного анализа текста сообщения. Требует Claude Code v2.1.205 или позже.1989`body`: декодированное тело сообщения с удалённой оболочкой одноранговой сети, байт-точное с тем, что видит модель. Всегда присутствует для сообщения товарища по команде; для кросс-сеансного одноранговой, присутствует только когда ход — это ровно одна оболочка одноранговой сети, сформированная Claude Code. Выполняйте рендеринг `name` и `body` вместо повторного анализа текста сообщения. Требует Claude Code v2.1.205 или позже.

1924 1990 

1925*1991*

1926 1992 

1927`fromSession`: ID сеанса отправителя, открываемый хостом, установленный хостом отправителя, чтобы ваш пользовательский интерфейс мог ссылаться обратно на отправляющий сеанс. Как `from`, это утверждение отправителя: используйте его только как цель навигации и не рассматривайте его как доказательство идентичности отправителя. Требует Claude Code v2.1.216 или позже.1993`fromSession`: ID сеанса отправителя, открываемый хостом, установленный хостом отправителя, чтобы ваш пользовательский интерфейс мог ссылаться обратно на отправляющий сеанс. Как `from`, это утверждение отправителя: используйте его только как цель навигации и не рассматривайте его как доказательство личности отправителя. Требует Claude Code v2.1.216 или позже.

1928 1994 

1929*1995*

1930 1996 

1931`verifiedPeerPid`: ID процесса процесса, который подключился к сокету кросс-сеансового обмена сообщениями этого сеанса, проверенный ядром и прочитанный из самого соединения, никогда из полезной нагрузки. Используйте его, а не `from`, для идентификации отправителя: `from` может быть подделан любым процессом того же пользователя. Поле отсутствует, когда Claude Code не может его проверить, такой как на Windows или неокончательный ввод, поэтому отсутствующее значение означает, что отправитель не проверен. Для передаваемого трафика он идентифицирует реле, а не автора сообщения, и ID процессов перерабатываются, поэтому рассматривайте его как происхождение, а не как токен аутентификации. Требует Claude Code v2.1.216 или позже.1997`verifiedPeerPid`: ID процесса процесса, который подключился к сокету кросс-сеансного обмена сообщениями этого сеанса, проверенный ядром и прочитанный из самого соединения, никогда из полезной нагрузки. Используйте его, а не `from`, чтобы идентифицировать отправителя: `from` может быть подделан любым процессом того же пользователя. Это поле отсутствует, когда Claude Code не может его проверить, такой как на Windows или неокончательный ввод, поэтому отсутствующее значение означает, что отправитель не проверен. Для передаваемого трафика он идентифицирует реле, а не автора сообщения, и ID процессов перерабатываются, поэтому рассматривайте его как происхождение, а не как токен аутентификации. Требует Claude Code v2.1.216 или позже.

1932 1998 

1933<h2 id="hook-types">1999<h2 id="hook-types">

1934 Типы hooks2000 Типы hooks


2081 tool_name: string;2147 tool_name: string;

2082 tool_input: unknown;2148 tool_input: unknown;

2083 tool_use_id: string;2149 tool_use_id: string;

2150 mcp_server?: McpServerProvenance;

2084};2151};

2085```2152```

2086 2153 

2154`mcp_server` присутствует, когда инструмент поступает с сервера MCP; см. [`McpServerProvenance`](#mcpserverprovenance). Входные данные `PostToolUse`, `PostToolUseFailure`, `PermissionRequest` и `PermissionDenied` содержат то же поле. Это поле требует Agent SDK v0.3.274 или позже.

2155 

2087<h4 id="posttoolusehookinput">2156<h4 id="posttoolusehookinput">

2088 `PostToolUseHookInput`2157 `PostToolUseHookInput`

2089</h4>2158</h4>


2096 tool_response: unknown;2165 tool_response: unknown;

2097 tool_use_id: string;2166 tool_use_id: string;

2098 duration_ms?: number;2167 duration_ms?: number;

2168 mcp_server?: McpServerProvenance;

2099};2169};

2100```2170```

2101 2171 


2112 error: string;2182 error: string;

2113 is_interrupt?: boolean;2183 is_interrupt?: boolean;

2114 duration_ms?: number;2184 duration_ms?: number;

2185 mcp_server?: McpServerProvenance;

2115};2186};

2116```2187```

2117 2188 


2146 tool_input: unknown;2217 tool_input: unknown;

2147 tool_use_id: string;2218 tool_use_id: string;

2148 reason: string;2219 reason: string;

2220 mcp_server?: McpServerProvenance;

2149};2221};

2150```2222```

2151 2223 


2365 tool_name: string;2437 tool_name: string;

2366 tool_input: unknown;2438 tool_input: unknown;

2367 permission_suggestions?: PermissionUpdate[];2439 permission_suggestions?: PermissionUpdate[];

2440 mcp_server?: McpServerProvenance;

2368};2441};

2369```2442```

2370 2443 


3572Аргументы tools MCP — это открытый объект: каждый сервер определяет свои собственные параметры, поэтому тип не накладывает ограничений на имена полей или значения. Обратитесь к собственной схеме tools сервера для полей, которые принимает конкретный tool.3645Аргументы tools MCP — это открытый объект: каждый сервер определяет свои собственные параметры, поэтому тип не накладывает ограничений на имена полей или значения. Обратитесь к собственной схеме tools сервера для полей, которые принимает конкретный tool.

3573 3646 

3574<h2 id="tool-output-types">3647<h2 id="tool-output-types">

3575 Типы выходных данных Tool3648 Типы выходных данных инструментов

3576</h2>3649</h2>

3577 3650 

3578Документация схем выходных данных для всех встроенных tools Claude Code. Эти типы экспортируются из `@anthropic-ai/claude-agent-sdk` и представляют фактические данные ответа, возвращаемые каждым tool.3651Документация схем выходных данных для всех встроенных инструментов Claude Code. Эти типы экспортируются из `@anthropic-ai/claude-agent-sdk` и представляют фактические данные ответа, возвращаемые каждым инструментом.

3579 3652 

3580<h3 id="tooloutputschemas">3653<h3 id="tooloutputschemas">

3581 `ToolOutputSchemas`3654 `ToolOutputSchemas`

3582</h3>3655</h3>

3583 3656 

3584Объединение типов выходных данных tool, экспортируемых из `@anthropic-ai/claude-agent-sdk`; члены включают:3657Объединение типов выходных данных инструментов, экспортируемых из `@anthropic-ai/claude-agent-sdk`; члены включают:

3585 3658 

3586```typescript theme={null}3659```typescript theme={null}

3587type ToolOutputSchemas =3660type ToolOutputSchemas =


3630 Agent3703 Agent

3631</h3>3704</h3>

3632 3705 

3633**Имя tool:** `Agent`. Предыдущее имя `Task` всё ещё принимается как псевдоним, и массив `tools` в инициализирующем сообщении [`SDKSystemMessage`](#sdksystemmessage) в настоящее время перечисляет этот tool как `Task` для обратной совместимости.3706**Имя инструмента:** `Agent`. Предыдущее имя `Task` по-прежнему принимается как псевдоним, и массив `tools` в сообщении инициализации [`SDKSystemMessage`](#sdksystemmessage) в настоящее время перечисляет этот инструмент как `Task` для обратной совместимости.

3634 3707 

3635```typescript theme={null}3708```typescript theme={null}

3636type AgentOutput =3709type AgentOutput =


3700 };3773 };

3701```3774```

3702 3775 

3703Возвращает результат от подагента. Дискриминирован по полю `status`: `"completed"` для завершённых задач, `"async_launched"` для фоновых задач и `"remote_launched"` для задач, которые Claude Code отправил в удалённый облачный сеанс, где `sessionUrl` ссылается на этот сеанс и `taskId` его идентифицирует.3776Возвращает результат от подагента. Различается по полю `status`: `"completed"` для завершённых задач, `"async_launched"` для фоновых задач и `"remote_launched"` для задач, которые Claude Code отправил в облачный сеанс, где `sessionUrl` ссылается на этот сеанс и `taskId` его идентифицирует.

3704 3777 

3705На варианте `completed` `resolvedModel` называет модель, на которой подагент начал работу, которая может отличаться от запрошенного входного параметра `model` когда применяется [`availableModels`](/docs/ru/model-config#restrict-model-selection) или другое переопределение. Это поле требует Claude Code v2.1.174 или позже. На `async_launched` оно называет модель в использовании, когда задача перешла в фоновый режим.3778На варианте `completed` `resolvedModel` называет модель, на которой подагент начал работу, которая может отличаться от запрошенного входного параметра `model`, когда применяется [`availableModels`](/docs/ru/model-config#restrict-model-selection) или другое переопределение. Это поле требует Claude Code v2.1.174 или более поздней версии. На `async_launched` оно называет модель, используемую при переводе задачи в фоновый режим.

3706 3779 

3707`modelsUsed` перечисляет модели, которые использовал подагент, по порядку. Поле присутствует только когда произошла замена модели во время выполнения, и модель появляется снова, когда выполнение вернулось к ней. На `async_launched` список охватывает модели, использованные перед переводом в фоновый режим. Оба `modelsUsed` и поведение фонового режима `resolvedModel` требуют Claude Code v2.1.212 или позже.3780`modelsUsed` перечисляет модели, которые использовал подагент, по порядку. Поле присутствует только при смене модели во время выполнения, и модель появляется снова при возврате к ней. На `async_launched` список охватывает модели, используемые до перевода в фоновый режим. Как `modelsUsed`, так и поведение фонового режима `resolvedModel` требуют Claude Code v2.1.212 или более поздней версии.

3708 3781 

3709Если Claude Code [сохранил изолированный worktree подагента](/docs/ru/worktrees#isolate-subagents-with-worktrees), `worktreePath` в результате `completed` указывает, где его найти. `worktreeBranch` — это его ветка, присутствующая, когда Claude Code создал worktree с git.3782Если Claude Code [сохранил изолированное рабочее дерево подагента](/docs/ru/worktrees#isolate-subagents-with-worktrees), `worktreePath` в результате `completed` указывает, где его найти. `worktreeBranch` — это его ветка, присутствующая, когда Claude Code создал рабочее дерево с git.

3710 3783 

3711Claude Code заполняет `usage` и `totalTokens` из финального запроса API подагента, а не из всего выполнения, поэтому `usage.service_tier` — это строка уровня обслуживания, которую API сообщила в этом запросе. Когда присутствует, `usage.output_tokens_details.thinking_tokens` — это количество токенов вывода этого запроса, которые были токенами мышления. Поле `output_tokens_details` требует TypeScript SDK v0.3.228 или позже, который поставляется с Claude Code v2.1.228.3784Claude Code заполняет `usage` и `totalTokens` из финального запроса API подагента, а не из всего выполнения, поэтому `usage.service_tier` — это строка уровня обслуживания, которую API сообщила в этом запросе. Если присутствует, `usage.output_tokens_details.thinking_tokens` — это количество токенов вывода этого запроса, которые были токенами мышления. Поле `output_tokens_details` требует TypeScript SDK v0.3.228 или более поздней версии, которая поставляется с Claude Code v2.1.228.

3712 3785 

3713`usage.output_tokens_details` соответствует [`Usage.output_tokens_details`](#usage) по смыслу, ограниченному этим финальным запросом, но каждый уровень здесь является необязательным. Защитите как объект, так и поле, например `usage.output_tokens_details?.thinking_tokens ?? 0`, вместо прямого чтения.3786`usage.output_tokens_details` соответствует [`Usage.output_tokens_details`](#usage) по смыслу, ограниченному этим финальным запросом, но каждый уровень здесь является необязательным. Проверьте как объект, так и поле, например `usage.output_tokens_details?.thinking_tokens ?? 0`, вместо прямого чтения.

3714 3787 

3715До v2.1.207 опубликованный тип был более узким. Он опускал `worktreePath`, `worktreeBranch`, `citations`, `toolStats.frameCount` и поля использования `inference_geo`, `speed` и `iterations`, и он типизировал `service_tier` как `"standard" | "priority" | "batch"`. Поля, которые тип отмечает как необязательные, могут отсутствовать в результатах, записанных более ранними версиями.3788До v2.1.207 опубликованный тип был более узким. Он опускал `worktreePath`, `worktreeBranch`, `citations`, `toolStats.frameCount` и поля использования `inference_geo`, `speed` и `iterations`, и он типизировал `service_tier` как `"standard" | "priority" | "batch"`. Поля, которые тип отмечает как необязательные, могут отсутствовать в результатах, записанных более ранними версиями.

3716 3789 


3718 AskUserQuestion3791 AskUserQuestion

3719</h3>3792</h3>

3720 3793 

3721**Имя tool:** `AskUserQuestion`3794**Имя инструмента:** `AskUserQuestion`

3722 3795 

3723```typescript theme={null}3796```typescript theme={null}

3724type AskUserQuestionOutput = {3797type AskUserQuestionOutput = {


3735};3808};

3736```3809```

3737 3810 

3738Возвращает заданные вопросы и ответы пользователя. `response` устанавливается, когда пользователь ввёл свободный ответ вместо ответа на структурированные вопросы; когда присутствует, Claude получает "Пользователь ответил: …" вместо списка ответов по вопросам.3811Возвращает заданные вопросы и ответы пользователя. `response` устанавливается, когда пользователь ввёл свободный ответ вместо ответа на структурированные вопросы; если присутствует, Claude получает «Пользователь ответил: …» вместо списка ответов по вопросам.

3739 3812 

3740<h3 id="bash-2">3813<h3 id="bash-2">

3741 Bash3814 Bash

3742</h3>3815</h3>

3743 3816 

3744**Имя tool:** `Bash`3817**Имя инструмента:** `Bash`

3745 3818 

3746```typescript theme={null}3819```typescript theme={null}

3747type BashOutput = {3820type BashOutput = {


3779Поля `stdout`, `stderr` и `backgroundTaskId` содержат:3852Поля `stdout`, `stderr` и `backgroundTaskId` содержат:

3780 3853 

3781| Поле | Что оно содержит |3854| Поле | Что оно содержит |

3782| ------------------ | ------------------------------------------------------------------------------------------------------ |3855| ------------------ | -------------------------------------------------------------------------------------------------------------- |

3783| `stdout` | Stdout и stderr команды, объединённые в один чередующийся поток |3856| `stdout` | Stdout и stderr команды, объединённые в один чередующийся поток |

3784| `stderr` | Уведомления, которые сам tool добавляет, такие как сброс рабочей директории shell, а не stderr команды |3857| `stderr` | Уведомления, которые добавляет сам инструмент, такие как сброс рабочего каталога оболочки, а не stderr команды |

3785| `backgroundTaskId` | Присутствует для фоновых команд |3858| `backgroundTaskId` | Присутствует для фоновых команд |

3786 3859 

3787`timedOutAfterMs` — это timeout в миллисекундах, установленный, когда команда достигла своего timeout и перешла в фоновый режим вместо явного запуска там. `backgroundCwdHint` устанавливается, когда фоновая команда содержала встроенную команду изменения директории, такую как `cd`, `pushd`, `popd` или `chdir`, и отмечает, что рабочая директория сеанса не изменилась. Оба поля требуют Claude Code v2.1.210 или позже.3860`timedOutAfterMs` — это тайм-аут в миллисекундах, установленный, когда команда достигла своего тайм-аута и перешла в фоновый режим, а не начала там явно. `backgroundCwdHint` устанавливается, когда фоновая команда содержала встроенную команду изменения каталога, такую как `cd`, `pushd`, `popd` или `chdir`, и отмечает, что рабочий каталог сеанса не изменился. Оба поля требуют Claude Code v2.1.210 или более поздней версии.

3788 3861 

3789Когда подагент, работающий на переднем плане, владеет фоновой командой, Claude Code завершает команду, когда этот подагент даёт свой финальный ответ. Claude Code устанавливает `backgroundEndsWithFinalResponse` в `true` на таких командах и опускает поле, когда команда сохраняется в течение хода, как команды, запущенные основным разговором или фоновыми подагентами. Поле требует Claude Code v2.1.227 или позже.3862Когда подагент, работающий на переднем плане, владеет фоновой командой, Claude Code завершает команду, когда этот подагент даёт свой финальный ответ. Claude Code устанавливает `backgroundEndsWithFinalResponse` в `true` для таких команд и опускает поле, когда команда сохраняется после хода, как команды, запущенные основным разговором или фоновыми подагентами. Поле требует Claude Code v2.1.227 или более поздней версии.

3790 3863 

3791Claude Code устанавливает `gitOperation.commit.branch` в ветку, названную в строке сводки коммита git, и опускает её для коммита, сделанного на отсоединённом HEAD. Поле требует Agent SDK v0.3.227 или позже. Claude Code сообщает команду `gh pr reopen` как действие PR `reopened`, что требует Agent SDK v0.3.234 или позже.3864Claude Code устанавливает `gitOperation.commit.branch` в ветку, названную в строке сводки коммита git, и опускает её для коммита, сделанного на отсоединённой HEAD. Поле требует Agent SDK v0.3.227 или более поздней версии. Claude Code сообщает команду `gh pr reopen` как действие PR `reopened`, что требует Agent SDK v0.3.234 или более поздней версии.

3792 3865 

3793<h3 id="monitor-2">3866<h3 id="monitor-2">

3794 Monitor3867 Monitor

3795</h3>3868</h3>

3796 3869 

3797**Имя tool:** `Monitor`3870**Имя инструмента:** `Monitor`

3798 3871 

3799```typescript theme={null}3872```typescript theme={null}

3800type MonitorOutput = {3873type MonitorOutput = {


3804};3877};

3805```3878```

3806 3879 

3807Возвращает ID фоновой задачи для выполняющегося монитора. Используйте этот ID с `TaskStop` для раннего отмены наблюдения.3880Возвращает ID фоновой задачи для работающего монитора. Используйте этот ID с `TaskStop` для отмены наблюдения раньше.

3808 3881 

3809<h3 id="edit-2">3882<h3 id="edit-2">

3810 Edit3883 Edit

3811</h3>3884</h3>

3812 3885 

3813**Имя tool:** `Edit`3886**Имя инструмента:** `Edit`

3814 3887 

3815```typescript theme={null}3888```typescript theme={null}

3816type FileEditOutput = {3889type FileEditOutput = {


3845 Read3918 Read

3846</h3>3919</h3>

3847 3920 

3848**Имя tool:** `Read`3921**Имя инструмента:** `Read`

3849 3922 

3850```typescript theme={null}3923```typescript theme={null}

3851type FileReadOutput =3924type FileReadOutput =


3917 };3990 };

3918```3991```

3919 3992 

3920Возвращает содержимое файла в формате, подходящем для типа файла. Дискриминирован по полю `type`.3993Возвращает содержимое файла в формате, подходящем для типа файла. Различается по полю `type`.

3921 3994 

3922<h3 id="write-2">3995<h3 id="write-2">

3923 Write3996 Write

3924</h3>3997</h3>

3925 3998 

3926**Имя tool:** `Write`3999**Имя инструмента:** `Write`

3927 4000 

3928```typescript theme={null}4001```typescript theme={null}

3929type FileWriteOutput = {4002type FileWriteOutput = {


3961 Glob4034 Glob

3962</h3>4035</h3>

3963 4036 

3964**Имя tool:** `Glob`4037**Имя инструмента:** `Glob`

3965 4038 

3966```typescript theme={null}4039```typescript theme={null}

3967type GlobOutput = {4040type GlobOutput = {


3974};4047};

3975```4048```

3976 4049 

3977Возвращает пути файлов, соответствующие паттерну glob, отсортированные по времени изменения.4050Возвращает пути файлов, соответствующие шаблону glob, отсортированные по времени изменения.

3978 4051 

3979`totalMatches` и `countIsComplete` требуют Claude Code v2.1.191 или позже. `totalMatches` сообщает количество совпадающих файлов перед усечением. Когда `countIsComplete` равен false, `totalMatches` является нижней границей, потому что базовый поиск усёк свой собственный вывод.4052`totalMatches` и `countIsComplete` требуют Claude Code v2.1.191 или более поздней версии. `totalMatches` сообщает количество совпадающих файлов до усечения. Когда `countIsComplete` равен false, `totalMatches` является нижней границей, потому что базовый поиск усёк свой собственный вывод.

3980 4053 

3981<h3 id="grep-2">4054<h3 id="grep-2">

3982 Grep4055 Grep

3983</h3>4056</h3>

3984 4057 

3985**Имя tool:** `Grep`4058**Имя инструмента:** `Grep`

3986 4059 

3987```typescript theme={null}4060```typescript theme={null}

3988type GrepOutput = {4061type GrepOutput = {


3999};4072};

4000```4073```

4001 4074 

4002Возвращает результаты поиска. Форма варьируется по `mode`: список файлов, содержимое с совпадениями или количество совпадений. В режиме `count` `numFiles` и `numMatches` — это итоги по полному набору результатов, а не по разбитому на страницы срезу. До v2.1.208 `head_limit` или `offset`, который усекал перечисленные записи, также усекал эти итоги.4075Возвращает результаты поиска. Форма варьируется в зависимости от `mode`: список файлов, содержимое с совпадениями или подсчёты совпадений. В режиме `count` `numFiles` и `numMatches` — это итоги по полному набору результатов, а не по разбитому на страницы срезу. До v2.1.208 `head_limit` или `offset`, который усекал перечисленные записи, также усекал эти итоги.

4003 4076 

4004`totalFiles` требует Claude Code v2.1.208 или позже и сообщает общее количество результатов перед `head_limit` и `offset` разбиением на страницы в режиме `files_with_matches`. `totalLines` требует Claude Code v2.1.210 или позже и сообщает общее количество строк перед разбиением на страницы в режиме `content`.4077`totalFiles` требует Claude Code v2.1.208 или более поздней версии и сообщает общее количество результатов до разбиения на страницы `head_limit` и `offset` в режиме `files_with_matches`. `totalLines` требует Claude Code v2.1.210 или более поздней версии и сообщает общее количество строк до разбиения на страницы в режиме `content`.

4005 4078 

4006<h3 id="taskstop-2">4079<h3 id="taskstop-2">

4007 TaskStop4080 TaskStop

4008</h3>4081</h3>

4009 4082 

4010**Имя tool:** `TaskStop`4083**Имя инструмента:** `TaskStop`

4011 4084 

4012```typescript theme={null}4085```typescript theme={null}

4013type TaskStopOutput = {4086type TaskStopOutput = {


4024 NotebookEdit4097 NotebookEdit

4025</h3>4098</h3>

4026 4099 

4027**Имя tool:** `NotebookEdit`4100**Имя инструмента:** `NotebookEdit`

4028 4101 

4029```typescript theme={null}4102```typescript theme={null}

4030type NotebookEditOutput = {4103type NotebookEditOutput = {


4041};4114};

4042```4115```

4043 4116 

4044Возвращает результат редактирования notebook с исходным и обновлённым содержимым файла.4117Возвращает результат редактирования ноутбука с исходным и обновлённым содержимым файла.

4045 4118 

4046<h3 id="webfetch-2">4119<h3 id="webfetch-2">

4047 WebFetch4120 WebFetch

4048</h3>4121</h3>

4049 4122 

4050**Имя tool:** `WebFetch`4123**Имя инструмента:** `WebFetch`

4051 4124 

4052```typescript theme={null}4125```typescript theme={null}

4053type WebFetchOutput = {4126type WebFetchOutput = {


4065};4138};

4066```4139```

4067 4140 

4068Возвращает полученное содержимое с HTTP статусом и метаданными.4141Возвращает полученное содержимое со статусом HTTP и метаданными.

4069 4142 

4070`artifactRead` — это собственная запись Claude Code о прочитанном артефакте, присутствующая только когда Claude получил артефакт, который сеанс может опубликовать. Claude Code читает его обратно, когда сеанс возобновляется, чтобы последующая публикация строилась на правильной версии; ваш код не должен действовать на это. `slug` называет артефакт, `ver` — это версия, которую чтение записало, и отсутствует, когда оно ничего не записало, и `seeded: false` отмечает чтение, чей полный источник не достиг Claude. Поле `seeded` требует Agent SDK v0.3.239 или позже.4143`artifactRead` — это собственная запись Claude Code о чтении артефакта, присутствующая только когда Claude получил артефакт, который сеанс может опубликовать. Claude Code читает его обратно, когда сеанс возобновляется, чтобы более поздняя публикация строилась на правильной версии; ваш код не должен действовать на основе этого. `slug` называет артефакт, `ver` — это версия, которую чтение записало, и отсутствует, когда оно ничего не записало, и `seeded: false` отмечает чтение, полный источник которого не достиг Claude. Поле `seeded` требует Agent SDK v0.3.239 или более поздней версии.

4071 4144 

4072<h3 id="websearch-2">4145<h3 id="websearch-2">

4073 WebSearch4146 WebSearch

4074</h3>4147</h3>

4075 4148 

4076**Имя tool:** `WebSearch`4149**Имя инструмента:** `WebSearch`

4077 4150 

4078```typescript theme={null}4151```typescript theme={null}

4079type WebSearchOutput = {4152type WebSearchOutput = {


4090};4163};

4091```4164```

4092 4165 

4093Возвращает результаты поиска из веб.4166Возвращает результаты поиска из веб-сети.

4094 4167 

4095<h3 id="workflow-2">4168<h3 id="workflow-2">

4096 Workflow4169 Workflow

4097</h3>4170</h3>

4098 4171 

4099**Имя tool:** `Workflow`4172**Имя инструмента:** `Workflow`

4100 4173 

4101```typescript theme={null}4174```typescript theme={null}

4102type WorkflowOutput = {4175type WorkflowOutput = {


4108 summary?: string;4181 summary?: string;

4109 transcriptDir?: string;4182 transcriptDir?: string;

4110 scriptPath?: string;4183 scriptPath?: string;

4111 sessionUrl?: string; // set when the workflow launched as a remote session4184 sessionUrl?: string; // set when the workflow launched as a cloud session

4112 warning?: string;4185 warning?: string;

4113 error?: string;4186 error?: string;

4114};4187};

4115```4188```

4116 4189 

4117Возвращает результат сразу после того, как tool принимает вызов. Окончательный результат поступает позже как завершение задачи. Проверьте `error` перед тем, как рассматривать запуск как начатый: скрипт, который не прошёл проверку синтаксиса, возвращает `status: "async_launched"` с установленным `error` и никогда не запускается.4190Возвращается сразу после того, как инструмент принимает вызов. Финальный результат приходит позже как завершение задачи. Проверьте `error` перед тем, как рассматривать выполнение как начатое: скрипт, который не проходит проверку синтаксиса, возвращает `status: "async_launched"` с установленным `error` и никогда не выполняется.

4118 4191 

4119| Поле | Тип | Описание |4192| Поле | Тип | Описание |

4120| --------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |4193| --------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

4121| `status` | `"async_launched" \| "remote_launched"` | Tool принял вызов. `"async_launched"` для выполнений в процессе, `"remote_launched"` для выполнений, отправленных в удалённый сеанс вместо выполнения в процессе |4194| `status` | `"async_launched" \| "remote_launched"` | Инструмент принял вызов. `"async_launched"` для выполнений в процессе, `"remote_launched"` для выполнений, отправленных в облачный сеанс вместо выполнения в процессе |

4122| `taskId` | `string` | Идентификатор фоновой задачи для запуска |4195| `taskId` | `string` | Идентификатор фоновой задачи для выполнения |

4123| `taskType` | `"local_workflow" \| "remote_agent"` | Тип задачи зарегистрированной фоновой задачи, соответствующий ветке `status` |4196| `taskType` | `"local_workflow" \| "remote_agent"` | Тип задачи зарегистрированной фоновой задачи, соответствующий ветке `status` |

4124| `workflowName` | `string` | `meta.name` из скрипта workflow |4197| `workflowName` | `string` | `meta.name` из скрипта workflow |

4125| `runId` | `string` | Идентификатор запуска workflow для передачи как `resumeFromRunId` при последующем вызове. Отсутствует для запусков `remote_launched`, где URL облачного сеанса — это дескриптор возобновления |4198| `runId` | `string` | Идентификатор выполнения workflow для передачи как `resumeFromRunId` при более позднем вызове. Отсутствует для выполнений `remote_launched`, где URL облачного сеанса является дескриптором возобновления |

4126| `summary` | `string` | Однострочное описание того, что делает workflow |4199| `summary` | `string` | Однострочное описание того, что делает workflow |

4127| `transcriptDir` | `string` | Директория, где записываются транскрипты подагента во время выполнения |4200| `transcriptDir` | `string` | Каталог, где записываются стенограммы подагентов во время выполнения |

4128| `scriptPath` | `string` | Путь к сохранённому скрипту workflow для этого запуска. Отредактируйте его и передайте обратно как `scriptPath` для повторного запуска без повторной отправки скрипта |4201| `scriptPath` | `string` | Путь к сохранённому скрипту workflow для этого выполнения. Отредактируйте его и передайте обратно как `scriptPath` для повторного выполнения без повторной отправки скрипта |

4129| `sessionUrl` | `string` | URL облачного сеанса, установленный, когда `status` равен `"remote_launched"` |4202| `sessionUrl` | `string` | URL облачного сеанса, установленный, когда `status` равен `"remote_launched"` |

4130| `warning` | `string` | Неблокирующее предупреждение, такое как локальное состояние git, отличающееся от отправленной ветки, которую клонирует облачный сеанс |4203| `warning` | `string` | Неблокирующее предупреждение, такое как локальное состояние git, отличающееся от отправленной ветки, которую будет клонировать облачный сеанс |

4131| `error` | `string` | Устанавливается, когда скрипт не прошёл проверку синтаксиса. Когда присутствует, запуск не начался несмотря на статус запуска |4204| `error` | `string` | Установлено, когда скрипт не проходит проверку синтаксиса. Если присутствует, выполнение не началось несмотря на статус запуска |

4132 4205 

4133<h3 id="todowrite-2">4206<h3 id="todowrite-2">

4134 TodoWrite4207 TodoWrite

4135</h3>4208</h3>

4136 4209 

4137**Имя tool:** `TodoWrite`4210**Имя инструмента:** `TodoWrite`

4138 4211 

4139```typescript theme={null}4212```typescript theme={null}

4140type TodoWriteOutput = {4213type TodoWriteOutput = {


4173 TaskCreate4246 TaskCreate

4174</h3>4247</h3>

4175 4248 

4176**Имя tool:** `TaskCreate`4249**Имя инструмента:** `TaskCreate`

4177 4250 

4178```typescript theme={null}4251```typescript theme={null}

4179type TaskCreateOutput = {4252type TaskCreateOutput = {


4190 TaskUpdate4263 TaskUpdate

4191</h3>4264</h3>

4192 4265 

4193**Имя tool:** `TaskUpdate`4266**Имя инструмента:** `TaskUpdate`

4194 4267 

4195```typescript theme={null}4268```typescript theme={null}

4196type TaskUpdateOutput = {4269type TaskUpdateOutput = {


4211 TaskGet4284 TaskGet

4212</h3>4285</h3>

4213 4286 

4214**Имя tool:** `TaskGet`4287**Имя инструмента:** `TaskGet`

4215 4288 

4216```typescript theme={null}4289```typescript theme={null}

4217type TaskGetOutput = {4290type TaskGetOutput = {


4226};4299};

4227```4300```

4228 4301 

4229Возвращает полную запись задачи или `null` когда ID не найден.4302Возвращает полную запись задачи или `null`, когда ID не найден.

4230 4303 

4231<h3 id="tasklist-2">4304<h3 id="tasklist-2">

4232 TaskList4305 TaskList

4233</h3>4306</h3>

4234 4307 

4235**Имя tool:** `TaskList`4308**Имя инструмента:** `TaskList`

4236 4309 

4237```typescript theme={null}4310```typescript theme={null}

4238type TaskListOutput = {4311type TaskListOutput = {


4252 ExitPlanMode4325 ExitPlanMode

4253</h3>4326</h3>

4254 4327 

4255**Имя tool:** `ExitPlanMode`4328**Имя инструмента:** `ExitPlanMode`

4256 4329 

4257```typescript theme={null}4330```typescript theme={null}

4258type ExitPlanModeOutput = {4331type ExitPlanModeOutput = {


4266};4339};

4267```4340```

4268 4341 

4269Возвращает состояние плана после выхода из режима планирования.4342Возвращает состояние плана после выхода из режима плана.

4270 4343 

4271<h3 id="listmcpresources-2">4344<h3 id="listmcpresources-2">

4272 ListMcpResources4345 ListMcpResources

4273</h3>4346</h3>

4274 4347 

4275**Имя tool:** `ListMcpResourcesTool`4348**Имя инструмента:** `ListMcpResourcesTool`

4276 4349 

4277```typescript theme={null}4350```typescript theme={null}

4278type ListMcpResourcesOutput = Array<{4351type ListMcpResourcesOutput = Array<{


4284}>;4357}>;

4285```4358```

4286 4359 

4287Возвращает массив доступных MCP ресурсов.4360Возвращает массив доступных ресурсов MCP.

4288 4361 

4289<h3 id="readmcpresource-2">4362<h3 id="readmcpresource-2">

4290 ReadMcpResource4363 ReadMcpResource

4291</h3>4364</h3>

4292 4365 

4293**Имя tool:** `ReadMcpResourceTool`4366**Имя инструмента:** `ReadMcpResourceTool`

4294 4367 

4295```typescript theme={null}4368```typescript theme={null}

4296type ReadMcpResourceOutput = {4369type ReadMcpResourceOutput = {


4304};4377};

4305```4378```

4306 4379 

4307Возвращает содержимое запрошенного MCP ресурса.4380Возвращает содержимое запрошенного ресурса MCP.

4308 4381 

4309<h3 id="enterworktree-2">4382<h3 id="enterworktree-2">

4310 EnterWorktree4383 EnterWorktree

4311</h3>4384</h3>

4312 4385 

4313**Имя tool:** `EnterWorktree`4386**Имя инструмента:** `EnterWorktree`

4314 4387 

4315```typescript theme={null}4388```typescript theme={null}

4316type EnterWorktreeOutput = {4389type EnterWorktreeOutput = {


4320};4393};

4321```4394```

4322 4395 

4323Возвращает информацию о git worktree.4396Возвращает информацию о git рабочем дереве.

4324 4397 

4325<h3 id="exitworktree-2">4398<h3 id="exitworktree-2">

4326 ExitWorktree4399 ExitWorktree

4327</h3>4400</h3>

4328 4401 

4329**Имя tool:** `ExitWorktree`4402**Имя инструмента:** `ExitWorktree`

4330 4403 

4331```typescript theme={null}4404```typescript theme={null}

4332type ExitWorktreeOutput = {4405type ExitWorktreeOutput = {


4341};4414};

4342```4415```

4343 4416 

4344Возвращает действие, которое было предпринято, и детали о worktree, из которого был выход.4417Возвращает выполненное действие и детали о рабочем дереве, из которого был выход.

4345 4418 

4346<h3 id="enterplanmode-2">4419<h3 id="enterplanmode-2">

4347 EnterPlanMode4420 EnterPlanMode

4348</h3>4421</h3>

4349 4422 

4350**Имя tool:** `EnterPlanMode`4423**Имя инструмента:** `EnterPlanMode`

4351 4424 

4352```typescript theme={null}4425```typescript theme={null}

4353type EnterPlanModeOutput = {4426type EnterPlanModeOutput = {


4355};4428};

4356```4429```

4357 4430 

4358Возвращает подтверждение того, что режим планирования был активирован.4431Возвращает подтверждение того, что режим плана был активирован.

4359 4432 

4360<h3 id="croncreate-2">4433<h3 id="croncreate-2">

4361 CronCreate4434 CronCreate

4362</h3>4435</h3>

4363 4436 

4364**Имя tool:** `CronCreate`4437**Имя инструмента:** `CronCreate`

4365 4438 

4366```typescript theme={null}4439```typescript theme={null}

4367type CronCreateOutput = {4440type CronCreateOutput = {


4378 CronDelete4451 CronDelete

4379</h3>4452</h3>

4380 4453 

4381**Имя tool:** `CronDelete`4454**Имя инструмента:** `CronDelete`

4382 4455 

4383```typescript theme={null}4456```typescript theme={null}

4384type CronDeleteOutput = {4457type CronDeleteOutput = {


4392 CronList4465 CronList

4393</h3>4466</h3>

4394 4467 

4395**Имя tool:** `CronList`4468**Имя инструмента:** `CronList`

4396 4469 

4397```typescript theme={null}4470```typescript theme={null}

4398type CronListOutput = {4471type CronListOutput = {


4407};4480};

4408```4481```

4409 4482 

4410Возвращает запланированные cron задачи: долговечные задачи из `.claude/scheduled_tasks.json` и задачи только для сеанса из текущего сеанса. Задача только для сеанса содержит `durable: false`; задачи, прочитанные с диска, опускают поле.4483Возвращает запланированные cron задачи: долговечные задачи из `.claude/scheduled_tasks.json` и задачи только для сеанса из текущего сеанса. Задача только для сеанса содержит `durable: false`; задачи, прочитанные с диска, опускают это поле.

4411 4484 

4412<h3 id="schedulewakeup-2">4485<h3 id="schedulewakeup-2">

4413 ScheduleWakeup4486 ScheduleWakeup

4414</h3>4487</h3>

4415 4488 

4416**Имя tool:** `ScheduleWakeup`4489**Имя инструмента:** `ScheduleWakeup`

4417 4490 

4418```typescript theme={null}4491```typescript theme={null}

4419type ScheduleWakeupOutput = {4492type ScheduleWakeupOutput = {


4425};4498};

4426```4499```

4427 4500 

4428Возвращает, когда пробуждение сработает как временная метка эпохи в миллисекундах, задержку, которая была фактически использована, и была ли запрошенная задержка ограничена. Поле `stopped` равно `true`, когда вызов завершил цикл с `stop: true`. Это требует Claude Code v2.1.202 или позже. Поле `cancelledWakeups` подсчитывает, сколько ожидающих пробуждений отменил вызов `stop: true`. Значение 0 означает, что ничего не было в ожидании, и повторяющийся `/loop` cron не отменяется `stop: true`. Это требует Claude Code v2.1.206 или позже.4501Возвращает, когда пробуждение сработает как временная метка эпохи в миллисекундах, фактически использованную задержку и была ли запрошенная задержка ограничена. Поле `stopped` равно `true`, когда вызов завершил цикл с `stop: true`. Это требует Claude Code v2.1.202 или более поздней версии. Поле `cancelledWakeups` подсчитывает, сколько ожидающих пробуждений отменил вызов `stop: true`. Значение 0 означает, что ничего не было в ожидании, и повторяющийся `/loop` cron не отменяется `stop: true`. Это требует Claude Code v2.1.206 или более поздней версии.

4429 4502 

4430<h3 id="remotetrigger-2">4503<h3 id="remotetrigger-2">

4431 RemoteTrigger4504 RemoteTrigger

4432</h3>4505</h3>

4433 4506 

4434**Имя tool:** `RemoteTrigger`4507**Имя инструмента:** `RemoteTrigger`

4435 4508 

4436```typescript theme={null}4509```typescript theme={null}

4437type RemoteTriggerOutput = {4510type RemoteTriggerOutput = {


4447 PushNotification4520 PushNotification

4448</h3>4521</h3>

4449 4522 

4450**Имя tool:** `PushNotification`4523**Имя инструмента:** `PushNotification`

4451 4524 

4452```typescript theme={null}4525```typescript theme={null}

4453type PushNotificationOutput = {4526type PushNotificationOutput = {


4459};4532};

4460```4533```

4461 4534 

4462Возвращает детали доставки, включая была ли отправлена push или локальное уведомление и почему доставка была пропущена.4535Возвращает детали доставки, включая отправлено ли push или локальное уведомление и почему доставка была пропущена.

4463 4536 

4464<h3 id="repl-2">4537<h3 id="repl-2">

4465 REPL4538 REPL

4466</h3>4539</h3>

4467 4540 

4468**Имя tool:** `REPL`4541**Имя инструмента:** `REPL`

4469 4542 

4470```typescript theme={null}4543```typescript theme={null}

4471type REPLOutput = {4544type REPLOutput = {


4493 ReportFindings4566 ReportFindings

4494</h3>4567</h3>

4495 4568 

4496**Имя tool:** `ReportFindings`4569**Имя инструмента:** `ReportFindings`

4497 4570 

4498```typescript theme={null}4571```typescript theme={null}

4499type ReportFindingsOutput = {4572type ReportFindingsOutput = {


4512};4585};

4513```4586```

4514 4587 

4515Возвращает количество выявленных результатов, уровень усилий, на котором работала проверка, и результаты, повторённые обратно для тела результата. Требует Claude Code v2.1.196 или позже. Повторённое поле `short_summary` требует Claude Code v2.1.212 или позже.4588Возвращает количество сообщённых находок, уровень усилий, на котором выполнялся обзор, и находки, повторённые обратно для тела результата. Требует Claude Code v2.1.196 или более поздней версии. Повторённое поле `short_summary` требует Claude Code v2.1.212 или более поздней версии.

4516 4589 

4517<h3 id="artifact-2">4590<h3 id="artifact-2">

4518 Artifact4591 Artifact

4519</h3>4592</h3>

4520 4593 

4521**Имя tool:** `Artifact`4594**Имя инструмента:** `Artifact`

4522 4595 

4523```typescript theme={null}4596```typescript theme={null}

4524type ArtifactOutput =4597type ArtifactOutput =


4549 };4622 };

4550```4623```

4551 4624 

4552Возвращает `url` опубликованной страницы и локальный `path`, который был опубликован для действия публикации, с `updated`, установленным в true, когда публикация переразвернула существующий артефакт, и `warnings`, содержащие любые рекомендации времени публикации. Действие списка возвращает строки `artifacts` вместо этого, с `truncated`, установленным, когда существует больше артефактов, чем запрошенный лимит. На списках, чья область не `"mine"`, каждая строка содержит `rel`, отмечающий, владеет ли пользователь артефактом или он был с ними поделён, и `scope` вывода записывает, какая область, отличная от по умолчанию, произвела список; оба отсутствуют на списках по умолчанию.4625Возвращает `url` опубликованной страницы и локальный `path`, который был опубликован для действия публикации, с `updated`, установленным в true, когда публикация переразвернула существующий артефакт, и `warnings`, содержащие любые рекомендации времени публикации. Действие списка возвращает строки `artifacts` вместо этого, с `truncated`, установленным, когда существует больше артефактов, чем запрошенный лимит. На списках, область которых не `"mine"`, каждая строка содержит `rel`, отмечающий, владеет ли пользователь артефактом или он был с ними поделён, и `scope` вывода записывает, какая область, отличная от стандартной, произвела список; оба отсутствуют на стандартных списках.

4553 4626 

4554<h3 id="projects-2">4627<h3 id="projects-2">

4555 Projects4628 Projects

4556</h3>4629</h3>

4557 4630 

4558**Имя tool:** `Projects`4631**Имя инструмента:** `Projects`

4559 4632 

4560```typescript theme={null}4633```typescript theme={null}

4561type ProjectsOutput =4634type ProjectsOutput =


4613 };4686 };

4614```4687```

4615 4688 

4616Дискриминирован по полю `method`, отражающему входные данные. `project_read` возвращает небольшие текстовые документы встроенными в `content` и записывает более крупные документы в путь `local_file` вместо этого; `project_search` возвращает RAG `hits` с `rag: true`, когда индекс проекта доступен, и возвращается к списку пути `docs` в противном случае.4689Различается по полю `method`, отражая входные данные. `project_read` возвращает небольшие текстовые документы встроенными в `content` и записывает более крупные документы в путь `local_file` вместо этого; `project_search` возвращает RAG `hits` с `rag: true`, когда индекс проекта доступен, и откатывается на список пути `docs` в противном случае.

4617 4690 

4618<h3 id="readmcpresourcedir-2">4691<h3 id="readmcpresourcedir-2">

4619 ReadMcpResourceDir4692 ReadMcpResourceDir

4620</h3>4693</h3>

4621 4694 

4622**Имя tool:** `ReadMcpResourceDirTool`4695**Имя инструмента:** `ReadMcpResourceDirTool`

4623 4696 

4624```typescript theme={null}4697```typescript theme={null}

4625type ReadMcpResourceDirOutput = {4698type ReadMcpResourceDirOutput = {


4632};4705};

4633```4706```

4634 4707 

4635Возвращает прямых потомков ресурса директории. Поддиректории появляются с mimeType `"inode/directory"`; `error` содержит понятное для человека сообщение, когда сервер не смог перечислить директорию.4708Возвращает прямых потомков ресурса каталога. Подкаталоги появляются с mimeType `"inode/directory"`; `error` содержит понятное для человека сообщение, когда сервер не смог перечислить каталог.

4636 4709 

4637<h3 id="refreshmcptools-2">4710<h3 id="refreshmcptools-2">

4638 RefreshMcpTools4711 RefreshMcpTools

4639</h3>4712</h3>

4640 4713 

4641**Имя tool:** `RefreshMcpTools`4714**Имя инструмента:** `RefreshMcpTools`

4642 4715 

4643```typescript theme={null}4716```typescript theme={null}

4644type RefreshMcpToolsOutput = Array<{4717type RefreshMcpToolsOutput = Array<{


4651}>;4724}>;

4652```4725```

4653 4726 

4654Возвращает одну запись на сервер: `refreshed` означает, что переопрошенный список tools был применён, `error` означает, что переопрос не удался и предыдущий набор tools был сохранён, и `not_connected` означает, что сервер не имеет живого соединения для опроса.4727Возвращает одну запись на сервер: `refreshed` означает, что переопрошенный список инструментов был применён, `error` означает, что переопрос не удался и предыдущий набор инструментов был сохранён, и `not_connected` означает, что сервер не имеет активного соединения для опроса.

4655 4728 

4656<h3 id="showonboardingrolepicker-2">4729<h3 id="showonboardingrolepicker-2">

4657 ShowOnboardingRolePicker4730 ShowOnboardingRolePicker

4658</h3>4731</h3>

4659 4732 

4660**Имя tool:** `ShowOnboardingRolePicker`4733**Имя инструмента:** `ShowOnboardingRolePicker`

4661 4734 

4662```typescript theme={null}4735```typescript theme={null}

4663type ShowOnboardingRolePickerOutput = {4736type ShowOnboardingRolePickerOutput = {


4672 McpOutput4745 McpOutput

4673</h3>4746</h3>

4674 4747 

4675**Имя tool:** динамические имена MCP tools вида `mcp__<server>__<tool>`4748**Имя инструмента:** динамические имена инструментов MCP вида `mcp__<server>__<tool>`

4676 4749 

4677```typescript theme={null}4750```typescript theme={null}

4678type McpOutput =4751type McpOutput =


4686 };4759 };

4687```4760```

4688 4761 

4689Результаты MCP tools возвращаются как строка или массив блоков содержимого, в зависимости от сервера. Конечная ветка простого объекта в экспортируемом типе — это артефакт генерации схемы: SDK не возвращает простой объект, потому что структурированный вывод сервера сериализуется в строку JSON перед возвратом. Во время выполнения значение также может быть `undefined`, хотя экспортируемый тип это не моделирует.4762Результаты инструментов MCP возвращаются как строка или массив блоков содержимого, в зависимости от сервера. Конечная ветка простого объекта в экспортируемом типе — это артефакт генерации схемы: SDK не возвращает голый объект, потому что структурированный вывод сервера сериализуется в строку JSON перед возвратом. Во время выполнения значение также может быть `undefined`, хотя экспортируемый тип это не моделирует.

4690 4763 

4691<h2 id="permission-types">4764<h2 id="permission-types">

4692 Типы разрешений4765 Типы разрешений


4882| `description` | `string` | Описание, когда использовать этого агента |4955| `description` | `string` | Описание, когда использовать этого агента |

4883| `model` | `string \| undefined` | Модель, которую использует этот агент: псевдоним или идентификатор модели, или `'inherit'` для модели родителя. Когда это `undefined`, Claude Code выбирает модель в [порядке выбора модели подагента](/docs/ru/sub-agents#choose-a-model) |4956| `model` | `string \| undefined` | Модель, которую использует этот агент: псевдоним или идентификатор модели, или `'inherit'` для модели родителя. Когда это `undefined`, Claude Code выбирает модель в [порядке выбора модели подагента](/docs/ru/sub-agents#choose-a-model) |

4884 4957 

4958<h3 id="mcpserverprovenance">

4959 `McpServerProvenance`

4960</h3>

4961 

4962MCP сервер, который обслуживает tool `mcp__*`, и источник определения этого сервера. Входные данные hook [`PreToolUse`](#pretoolusehookinput), `PostToolUse`, `PostToolUseFailure`, `PermissionRequest` и `PermissionDenied` несут его как `mcp_server`, а опции [`CanUseTool`](#canusetool) несут его как `mcpServer`. Оба опускают его для tools, которые не поступают от MCP сервера.

4963 

4964```typescript theme={null}

4965type McpServerProvenance = {

4966 name: string;

4967 source: string;

4968};

4969```

4970 

4971| Поле | Тип | Описание |

4972| :------- | :------- | :---------------------------------------------------------------------------------------------------------------------- |

4973| `name` | `string` | Имя, под которым зарегистрирован сервер, то же значение, которое [`mcpServerStatus()`](#query-object) сообщает для него |

4974| `source` | `string` | Источник определения сервера: `sdk`, `plugin` или область конфигурации |

4975 

4976`source` принимает одно из следующих значений. Набор открыт, поэтому рассматривайте значение, которое вы не узнаёте, как настроенный источник, никогда не как `sdk`:

4977 

4978* **`sdk`**: встроенный в процесс сервер, который зарегистрировало ваше приложение. Только приложение-хост SDK может зарегистрировать один, поэтому настроенный сервер никогда не сообщает `sdk`, независимо от его имени.

4979* **`plugin`**: сервер, который предоставляет [plugin](/docs/ru/agent-sdk/plugins). Его `name` это форма с областью видимости `plugin:<plugin-name>:<server-name>`, описанная в разделе [plugin-provided MCP servers](/docs/ru/mcp#plugin-provided-mcp-servers).

4980* **Область конфигурации**: `user`, `project`, `local`, `dynamic`, `managed`, `enterprise`, `claudeai` или `agent`. Сервер `.mcp.json` сообщает `project`, и [MCP installation scopes](/docs/ru/mcp#mcp-installation-scopes) определяет `local`, `project` и `user`. Серверы, которые ваше приложение передаёт в опции [`mcpServers`](#options), кроме встроенных в процесс SDK серверов, сообщают `dynamic`.

4981 

4982Основывайте решения о доверии на `source`, а не на `name` или префиксе имени tool `mcp__<server>__`. Для любого источника, кроме `sdk`, `name` это недоверенный текст: экранируйте его перед отображением.

4983 

4984`McpServerProvenance` и поля, которые его несут, требуют Agent SDK v0.3.274 или позже.

4985 

4885<h3 id="mcpserverstatus">4986<h3 id="mcpserverstatus">

4886 `McpServerStatus`4987 `McpServerStatus`

4887</h3>4988</h3>


4899 error?: string;5000 error?: string;

4900 config?: McpServerStatusConfig;5001 config?: McpServerStatusConfig;

4901 scope?: string;5002 scope?: string;

5003 source?: string;

4902 tools?: {5004 tools?: {

4903 name: string;5005 name: string;

4904 description?: string;5006 description?: string;


4911};5013};

4912```5014```

4913 5015 

5016`source` говорит, откуда поступило определение сервера, с теми же значениями и правилом доверия, что и `source` [`McpServerProvenance`](#mcpserverprovenance). Поле требует Agent SDK v0.3.274 или позже и отсутствует в более ранних версиях.

5017 

4914<h3 id="mcpserverstatusconfig">5018<h3 id="mcpserverstatusconfig">

4915 `McpServerStatusConfig`5019 `McpServerStatusConfig`

4916</h3>5020</h3>

Details

126 126 

127См. [где каждый механизм хранит политику](/docs/ru/managed-settings#where-each-mechanism-stores-the-policy) для путей файлов и [Управляемые параметры на стороне клиента](/docs/ru/claude-apps-gateway-config#client-side-managed-settings) для эквивалента Claude Desktop `bootstrapUrl`.127См. [где каждый механизм хранит политику](/docs/ru/managed-settings#where-each-mechanism-stores-the-policy) для путей файлов и [Управляемые параметры на стороне клиента](/docs/ru/claude-apps-gateway-config#client-side-managed-settings) для эквивалента Claude Desktop `bootstrapUrl`.

128 128 

129<h3 id="large-rollouts">

130 Крупные развертывания

131</h3>

132 

133Вход ограничен по скорости для каждого IP адреса клиента, и значения по умолчанию подходят для небольшой команды. Каждый адрес получает 30 начал входа и 10 отправок кода каждые 10 минут. Развертывание для тысяч разработчиков может достичь этих ограничений в первое утро по одной из двух причин:

134 

135* **Шлюз не может видеть за вашим балансировщиком нагрузки.** Без [`listen.trusted_proxies`](/docs/ru/claude-apps-gateway-config#listen), каждый разработчик выглядит как исходящий с адреса балансировщика нагрузки и делит один лимит. Установите это в первую очередь. Шлюз логирует предупреждение в первый раз, когда он игнорирует заголовок `X-Forwarded-For`.

136* **Много разработчиков делят несколько NAT или VPN адресов выхода.** Они делят лимиты этих адресов даже когда `trusted_proxies` правильно установлен. Поднимите [`rate_limits`](/docs/ru/claude-apps-gateway-config#http-tuning), чтобы соответствовать.

137 

138Чтобы определить размер `max`, разделите разработчиков на адреса выхода, которые они делят. Оцените, сколько из них входят в один период `window_seconds`, который по умолчанию составляет 10 минут. Затем удвойте это, чтобы охватить повторные попытки и разработчиков, которые входят как в Claude Code, так и в Claude Desktop.

139 

140Например, 10 000 разработчиков за 4 адресами выхода входят равномерно в течение часа. Это 2 500 разработчиков на адрес и около 420 из них в каждые 10 минут, которые вы удваиваете и округляете до 1 000. Пример ниже устанавливает оба лимита на 1 000:

141 

142```yaml theme={null}

143rate_limits:

144 device_authorization: { max: 1000, window_seconds: 600 }

145 device_verify: { max: 1000, window_seconds: 600 }

146```

147 

148`device_verify` — это то, что останавливает кого-то от угадывания кода входа другого разработчика, поэтому поднимайте его только настолько, насколько нужна ваша оценка. Даже при этих лимитах код состоит из 8 символов из 20-символного алфавита и истекает через 10 минут, поэтому угадывание остается непрактичным; см. [Устойчивость к перебору кода пользователя](#user-code-brute-force-resistance).

149 

150Когда ваш IdP выдает refresh токены, Claude Code молча обновляет сеансы, поэтому вы можете вернуть лимит после развертывания. Без refresh токенов разработчики входят снова каждые [`session.ttl_hours`](/docs/ru/claude-apps-gateway-config#session). Определите размер обоих лимитов и для этой стабильной скорости и оставьте их повышенными.

151 

152Когда лимит достигнут, Claude Code v2.1.274 или позже показывает `The gateway is limiting sign-in attempts right now`. Шлюз на v2.1.274 или позже показывает `Too many attempts came from your network address` на странице проверки, с параметрами для проверки. Он также записывает строку логирования `sign-in refused`, которая называет параметр для изменения.

153 

129<h2 id="operations">154<h2 id="operations">

130 Операции155 Операции

131</h2>156</h2>


160 185 

161Документ обнаружения OAuth в `/.well-known/oauth-authorization-server` также возвращает `200` только после загрузки конфигурации, обнаружения OIDC, построения клиента upstream и миграции Postgres, поэтому он также служит проверкой загрузки end-to-end.186Документ обнаружения OAuth в `/.well-known/oauth-authorization-server` также возвращает `200` только после загрузки конфигурации, обнаружения OIDC, построения клиента upstream и миграции Postgres, поэтому он также служит проверкой загрузки end-to-end.

162 187 

188<h3 id="concurrent-upstream-requests">

189 Одновременные upstream запросы

190</h3>

191 

192По умолчанию каждая реплика шлюза отправляет не более 256 запросов upstream одновременно. Потоковый ответ учитывается в лимите до завершения потока.

193 

194Запрос, который прибывает, пока реплика находится на лимите, ждет внутри шлюза свободного слота. Разработчик видит ответ, который медленно начинается или кажется зависшим. На upstream `provider: anthropic`, запрос, который ждет дольше, чем [`timeouts.upstream_ttfb_ms`](/docs/ru/claude-apps-gateway-config#http-tuning), отказывается от этого upstream и не удается с 502, когда позже никакой upstream не обслуживает его.

195 

196Строка журнала загрузки, содержащая `upstream requests:`, показывает действующий лимит. Пока реплика имеет больше открытых запросов, чем лимит, она также логирует предупреждение, содержащее `client requests are open`, не более одного раза в минуту.

197 

198Чтобы обслуживать больше запросов одновременно, у вас есть два варианта:

199 

200* Добавьте реплики.

201* Повысьте лимит на каждой реплике. Установите переменную окружения `BUN_CONFIG_MAX_HTTP_REQUESTS` на контейнере шлюза на целое число от 1 до 65535, затем перезагрузите контейнер.

202 

203Реплика заполняет свой лимит при скорости запроса примерно равной лимиту, разделенному на среднее количество секунд, в течение которых запрос остается открытым. Например, если запросы остаются открытыми в среднем 10 секунд, реплика с лимитом по умолчанию 256 заполняет его примерно на 26 запросов в секунду.

204 

205Если вы автомасштабируете на CPU, реплика на лимите ставит запросы в очередь без запуска масштабирования, поэтому установите целевой уровень ниже уровня CPU, который ваши реплики показывают, когда они логируют предупреждение `client requests are open`.

206 

207<Warning>

208 Каждый открытый запрос удерживает память в процессе шлюза, пока он потоковает и пока ждет слота. Если вы сохраняете лимит на 256, память на перегруженной реплике все еще растет, потому что ожидающие запросы сохраняют свои тела запроса. Размер памяти контейнера для количества запросов, открытых на пике, и следите за памятью, когда вы меняете лимит. Реплика, которая исчерпывает память, убивается и отбрасывает каждый поток, который она удерживает.

209</Warning>

210 

163<h3 id="outage-behavior">211<h3 id="outage-behavior">

164 Поведение при сбое212 Поведение при сбое

165</h3>213</h3>


209 257 

210Реплики не имеют состояния, поэтому rolling restart безопасен в любое время. Шлюз запускает миграции схемы при загрузке, что означает, что развертывание нового бинарного файла автоматически мигрирует базу данных. Параллельные реплики сериализуются на advisory lock Postgres, поэтому только одна применяет каждую миграцию.258Реплики не имеют состояния, поэтому rolling restart безопасен в любое время. Шлюз запускает миграции схемы при загрузке, что означает, что развертывание нового бинарного файла автоматически мигрирует базу данных. Параллельные реплики сериализуются на advisory lock Postgres, поэтому только одна применяет каждую миграцию.

211 259 

260Когда ваш оркестратор останавливает реплику с `SIGTERM`, как при rolling restart или масштабировании вниз, шлюз прекращает принимать новые соединения и позволяет запросам и потокам, уже находящимся в полете, завершиться перед выходом. Он ждет до 25 секунд, называемых окном дренажа, затем закрывает все, что все еще открыто. `SIGINT`, такой как Ctrl+C в терминале, запускает тот же дренаж, и второй сигнал во время дренажа закрывает открытые запросы и выходит сразу. Дренаж требует gateway v2.1.274 или позже.

261 

262Длительные генерации могут потоковать в течение минут. На Kubernetes и Amazon ECS, повысьте оба этих параметра вместе, чтобы дать этим потокам больше времени:

263 

264* **Окно дренажа**: установите переменную окружения `CLAUDE_GATEWAY_DRAIN_TIMEOUT_MS` на контейнере шлюза на положительное целое число миллисекунд, такое как `120000`. Шлюз игнорирует значение в любой другой форме, такой как `120s`, и сохраняет 25-секундное значение по умолчанию

265* **Период grace вашего оркестратора**: `terminationGracePeriodSeconds` на Kubernetes или `stopTimeout` на Amazon ECS

266 

267Период grace по умолчанию составляет 30 секунд на обеих платформах. Сохраняйте его по крайней мере на 5 секунд дольше, чем окно дренажа, или оркестратор убьет шлюз до завершения дренажа. На Kubernetes добавьте также продолжительность любого хука `preStop`, потому что период grace начинает отсчет перед запуском хука, а не когда шлюз получает `SIGTERM`.

268 

269Ваша платформа также может ограничить, как долго может работать дренаж:

270 

271* **Amazon ECS on Fargate**: `stopTimeout` позволяет максимум 120 секунд

272* **Cloud Run**: останавливает экземпляр через 10 секунд после `SIGTERM`, поэтому открытые потоки получают максимум 10 секунд там, независимо от того, какое окно дренажа

273 

274Когда окно дренажа заканчивается с открытыми запросами, шлюз логирует предупреждение, содержащее `drain window over after`, подсчитывает запросы, которые он отрезал, и называет оба параметра для повышения.

275 

212Миграции добавляются только, поэтому откат к предыдущему бинарному файлу, который знает меньше миграций, безопасен; он игнорирует дополнительные строки. Откат также переподтверждает YAML против схемы более старого бинарного файла, поэтому конфигурация, которая приняла ключ, введенный более новым выпуском, не удается при загрузке на более старом. Удалите новый ключ перед откатом.276Миграции добавляются только, поэтому откат к предыдущему бинарному файлу, который знает меньше миграций, безопасен; он игнорирует дополнительные строки. Откат также переподтверждает YAML против схемы более старого бинарного файла, поэтому конфигурация, которая приняла ключ, введенный более новым выпуском, не удается при загрузке на более старом. Удалите новый ключ перед откатом.

213 277 

214Потому что вы закрепляете версию шлюза в своем собственном образе, исправления в новых выпусках Claude Code, включая исправления безопасности, достигают вашего развертывания только когда вы обновляете закрепление и переразворачиваете. Включите шлюз в тот же цикл патчей, который вы используете для других сервисов, содержащих production учетные данные.278Потому что вы закрепляете версию шлюза в своем собственном образе, исправления в новых выпусках Claude Code, включая исправления безопасности, достигают вашего развертывания только когда вы обновляете закрепление и переразворачиваете. Включите шлюз в тот же цикл патчей, который вы используете для других сервисов, содержащих production учетные данные.


239 303 

240* Разработчики держат краткосрочные JWT вместо сырых ключей upstream. Ветвь CLI-к-шлюзу использует грант устройства RFC 8628, и обмен авторизацией шлюза с IdP запускает PKCE в конфигурации по умолчанию, поэтому перехваченный код авторизации IdP бесполезен.304* Разработчики держат краткосрочные JWT вместо сырых ключей upstream. Ветвь CLI-к-шлюзу использует грант устройства RFC 8628, и обмен авторизацией шлюза с IdP запускает PKCE в конфигурации по умолчанию, поэтому перехваченный код авторизации IdP бесполезен.

241* Страница проверки устройства применяет same-origin POST и ограничение скорости для каждого IP согласно RFC 8628 §5.1. См. [Сопротивление brute-force пользовательского кода](#user-code-brute-force-resistance).305* Страница проверки устройства применяет same-origin POST и ограничение скорости для каждого IP согласно RFC 8628 §5.1. См. [Сопротивление brute-force пользовательского кода](#user-code-brute-force-resistance).

242* Исходящие запросы проходят через защиту от подделки запроса на стороне сервера (SSRF), которая разрешает DNS, блокирует link-local и адреса облачных метаданных плюс loopback по умолчанию и закрепляет соединение на разрешенный IP, поэтому управляемые оператором URL, такие как IdP и назначения OTLP, не могут быть перенаправлены на конечные точки облачных метаданных. Диапазоны приватных RFC 1918 намеренно разрешены, потому что IdP и сборщики OTLP обычно живут на приватных IP. Установите `CLAUDE_GATEWAY_ALLOW_LOOPBACK=1` в окружении шлюза только когда что-то, что шлюз должен достичь, легитимно живет на loopback, такое как локальная разработка IdP или сборщик OTLP sidecar на `localhost`. Переменная ослабляет блокировку loopback для каждого настроенного оператором URL и также пропускает предупреждение при загрузке, которое проверяет, может ли pod достичь конечной точки облачных метаданных, поэтому предпочитайте давать сборщику его собственный внутренний адрес.306* Исходящие запросы шлюза к вашему IdP, вашим сборщикам OTLP и `provider: anthropic` upstreams проходят через защиту от подделки запроса на стороне сервера (SSRF), которая разрешает DNS, блокирует link-local и адреса облачных метаданных плюс loopback по умолчанию и закрепляет соединение на разрешенный IP, поэтому управляемые оператором URL не могут быть перенаправлены на конечные точки облачных метаданных. Диапазоны приватных RFC 1918 намеренно разрешены, потому что IdP и сборщики OTLP обычно живут на приватных IP. Для других поставщиков шлюз отказывает в `base_url`, который называет один из этих адресов или имя хоста метаданных при загрузке конфигурации, и SDK поставщика затем подключается без проверки DNS.

307 

308 Если вы включите [только прокси выход](/docs/ru/claude-apps-gateway-config#proxy-only-egress), эта проверка адреса переходит к вашему forward proxy: шлюз передает ему имена хостов и список разрешений прокси должен отказать этим назначениям.

309 

310 Установите `CLAUDE_GATEWAY_ALLOW_LOOPBACK=1` в окружении шлюза только когда что-то, что шлюз должен достичь, легитимно живет на loopback, такое как локальная разработка IdP или сборщик OTLP sidecar на `localhost`. Переменная ослабляет блокировку loopback для каждого настроенного оператором URL и также пропускает предупреждение при загрузке, которое проверяет, может ли pod достичь конечной точки облачных метаданных, поэтому предпочитайте давать сборщику его собственный внутренний адрес.

243 311 

244Если вы добавляете свои собственные элементы управления выходом, шлюз должен достичь сервера метаданных всякий раз, когда он использует учетные данные метаданных экземпляра, такие как workload identity.312Если вы добавляете свои собственные элементы управления выходом, шлюз должен достичь сервера метаданных всякий раз, когда он использует учетные данные метаданных экземпляра, такие как workload identity.

245 313 


254 322 

255`user_code`, который разработчик вводит на странице проверки `/device`, — это 8 символов, взятых из алфавита из 20 символов, что дает 20⁸ или около 2,56×10¹⁰ комбинаций, и он истекает через 10 минут.323`user_code`, который разработчик вводит на странице проверки `/device`, — это 8 символов, взятых из алфавита из 20 символов, что дает 20⁸ или около 2,56×10¹⁰ комбинаций, и он истекает через 10 минут.

256 324 

257Шлюз применяет ограничения скорости для каждого IP на конечных точках грантов устройства, настраиваемые через [`rate_limits`](/docs/ru/claude-apps-gateway-config#http-tuning). Поднимите лимиты, если много разработчиков входят с одного общего корпоративного NAT адреса. Лимиты применяются только к потоку входа, а не к inference.325Шлюз применяет ограничения скорости для каждого IP на конечных точках грантов устройства, настраиваемые через [`rate_limits`](/docs/ru/claude-apps-gateway-config#http-tuning). Поднимите лимиты, если много разработчиков входят с одного общего корпоративного NAT адреса. [Крупные развертывания](#large-rollouts) показывает, как их размер. Лимиты применяются только к потоку входа, а не к inference.

258 326 

259<h3 id="compliance-posture">327<h3 id="compliance-posture">

260 Позиция соответствия328 Позиция соответствия


284stderr шлюза включает поток событий аудита, журнал аудита записывает идентификаторы разработчиков, а файл отладки записывает выходные данные hook и MCP сервера с машины разработчика. Проверьте и удалите эту информацию перед публикацией в общедоступную проблему.352stderr шлюза включает поток событий аудита, журнал аудита записывает идентификаторы разработчиков, а файл отладки записывает выходные данные hook и MCP сервера с машины разработчика. Проверьте и удалите эту информацию перед публикацией в общедоступную проблему.

285 353 

286| Симптом | Причина | Исправление |354| Симптом | Причина | Исправление |

287| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |355| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

288| `/login` разработчика показывает стандартный выбор аккаунта вместо экрана **Cloud gateway** | `forceLoginMethod` или `forceLoginGatewayUrl` не установлены в управляемых параметрах на этой машине | Разверните [файл управляемых параметров](/docs/ru/claude-apps-gateway#set-the-gateway-url) на устройство; `/login` читает URL шлюза оттуда |356| `/login` разработчика показывает стандартный выбор аккаунта вместо экрана **Cloud gateway** | `forceLoginMethod` или `forceLoginGatewayUrl` не установлены в управляемых параметрах на этой машине | Разверните [файл управляемых параметров](/docs/ru/claude-apps-gateway#set-the-gateway-url) на устройство; `/login` читает URL шлюза оттуда |

289| Запросы разработчика не удаются с `Not signed in to the Cloud gateway — run /login.` | Управляемые параметры машины устанавливают `forceLoginMethod: "gateway"` или `forceLoginGatewayUrl`, и сеанс не имеет входа в шлюз. Оставшийся вход claude.ai не удовлетворяет требованию. | Попросите разработчика запустить `/login` и завершить вход в шлюз. См. также [Administrator policy requires a Cloud gateway sign-in](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in). |357| Запросы разработчика не удаются с `Not signed in to the Cloud gateway — run /login.` | Управляемые параметры машины устанавливают `forceLoginMethod: "gateway"` или `forceLoginGatewayUrl`, и сеанс не имеет входа в шлюз. Оставшийся вход claude.ai не удовлетворяет требованию. | Попросите разработчика запустить `/login` и завершить вход в шлюз. См. также [Administrator policy requires a Cloud gateway sign-in](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in). |

290| Claude Desktop сообщает, что его конфигурация bootstrap не может быть получена | `/user/bootstrap` вернул 404: политика, соответствующая пользователю, не содержит ключ `desktop`, или политика не совпадает. Журнал аудита шлюза записывает каждое отклонение как `desktop_bootstrap.denied` с причиной. | Добавьте блок `desktop` к политике, которая соответствует пользователю, или к базовому слою `match: {}`; пустого `desktop: {}` достаточно. См. [Claude Desktop overlay](/docs/ru/claude-apps-gateway-config#claude-desktop-overlay). |358| Claude Desktop сообщает, что его конфигурация bootstrap не может быть получена | `/user/bootstrap` вернул 404: политика, соответствующая пользователю, не содержит ключ `desktop`, или политика не совпадает. Журнал аудита шлюза записывает каждое отклонение как `desktop_bootstrap.denied` с причиной. | Добавьте блок `desktop` к политике, которая соответствует пользователю, или к базовому слою `match: {}`; пустого `desktop: {}` достаточно. См. [Claude Desktop overlay](/docs/ru/claude-apps-gateway-config#claude-desktop-overlay). |

291| Запуск показывает `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | Установленная сборка Claude Code предшествует поддержке шлюза | Попросите разработчика обновить Claude Code до выпуска, который включает поддержку Cloud gateway |359| Запуск показывает `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | Установленная сборка Claude Code предшествует поддержке шлюза | Попросите разработчика обновить Claude Code до выпуска, который включает поддержку Cloud gateway |

292| Запуск выходит с `Administrator policy requires a Cloud gateway sign-in on this machine` | Окружение разработчика устанавливает `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN`, их параметры настраивают [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), или API ключ из более раннего входа Claude Console все еще сохранен | Попросите разработчика очистить каждый из применимых: отменить переменную, удалить запись `apiKeyHelper` или запустить `claude auth logout` для удаления сохраненного ключа. Затем попросите его запустить `claude` и войти с помощью `/login`. См. также [Administrator policy requires a Cloud gateway sign-in](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in). |360| Запуск выходит с `Administrator policy requires a Cloud gateway sign-in on this machine` | Окружение разработчика устанавливает `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN`, их параметры настраивают [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), или API ключ из более раннего входа Claude Console все еще сохранен | Попросите разработчика очистить каждый из применимых: отменить переменную, удалить запись `apiKeyHelper` или запустить `claude auth logout` для удаления сохраненного ключа. Затем попросите его запустить `claude` и войти с помощью `/login`. См. также [Administrator policy requires a Cloud gateway sign-in](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in). |

293| Запуск или `/login` сообщает `Claude Code may not be enabled for your organization` после 403 при загрузке управляемых параметров | Шлюз или что-то перед ним ответили на запрос `/managed/settings` с 403. Собственный маршрут параметров шлюза никогда не отвечает 403. Статус поступает из проверок IP [`access_control`](/docs/ru/claude-apps-gateway-config#http-tuning) или из прокси или WAF перед шлюзом. Журнал аудита записывает отклонение проверки IP как `access.denied` с причиной. Разработчик остается вошедшим. | Проверьте журнал аудита на `access.denied` в момент сбоя и исправьте списки `access_control` или фронтенд, затем попросите разработчика запустить `claude` снова |361| Запуск или `/login` сообщает `Claude Code may not be enabled for your organization` после 403 при загрузке управляемых параметров | Шлюз или что-то перед ним ответили на запрос `/managed/settings` с 403. Собственный маршрут параметров шлюза никогда не отвечает 403. Статус поступает из проверок IP [`access_control`](/docs/ru/claude-apps-gateway-config#http-tuning) или из прокси или WAF перед шлюзом. Журнал аудита записывает отклонение проверки IP как `access.denied` с причиной. Разработчик остается вошедшим. | Проверьте журнал аудита на `access.denied` в момент сбоя и исправьте списки `access_control` или фронтенд, затем попросите разработчика запустить `claude` снова |

362| CLI `/login`: `The gateway is limiting sign-in attempts right now`, или `Request failed with status code 429` на более старых версиях. Страница `/device` может показывать `Too many attempts` разработчикам, которые раньше не пробовали | Был достигнут лимит скорости входа на IP. Либо `listen.trusted_proxies` не охватывает балансировщик нагрузки, поэтому каждый разработчик использует его адрес, либо много разработчиков используют один адрес выхода NAT или VPN. События аудита с `result: rate_limited` показывают одно или несколько одинаковых значений `client_ip`. | Сначала установите `listen.trusted_proxies` на диапазоны источников балансировщика нагрузки, затем поднимите `rate_limits`, если разработчики все еще используют общие адреса. См. [Large rollouts](#large-rollouts). |

294| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Имя хоста шлюза разрешается на по крайней мере один публичный IP адрес. Claude Code проверяет каждый разрешенный адрес и требует, чтобы каждый был приватным. Частая причина — dual-stack имя, где одно семейство разрешается на публичный адрес, включая AWS внутренние dual-stack балансировщики нагрузки, которые возвращают публичные AAAA адреса. | Попросите имя шлюза разрешаться только на приватные адреса на машинах разработчиков. Для dual-stack имени удалите публичный диапазон записи или обслуживайте отдельное внутреннее DNS имя. См. [предпосылку приватной сети](/docs/ru/claude-apps-gateway#prerequisites). Если адрес находится в публичном пространстве, которым владеет и использует ваша организация внутри, [объявите этот блок](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) вместо этого. |363| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Имя хоста шлюза разрешается на по крайней мере один публичный IP адрес. Claude Code проверяет каждый разрешенный адрес и требует, чтобы каждый был приватным. Частая причина — dual-stack имя, где одно семейство разрешается на публичный адрес, включая AWS внутренние dual-stack балансировщики нагрузки, которые возвращают публичные AAAA адреса. | Попросите имя шлюза разрешаться только на приватные адреса на машинах разработчиков. Для dual-stack имени удалите публичный диапазон записи или обслуживайте отдельное внутреннее DNS имя. См. [предпосылку приватной сети](/docs/ru/claude-apps-gateway#prerequisites). Если адрес находится в публичном пространстве, которым владеет и использует ваша организация внутри, [объявите этот блок](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) вместо этого. |

295| CLI `/login`: `Gateway login would go through proxy <proxy>, which is not on a private network` | `HTTPS_PROXY` или `HTTP_PROXY` применяется к хосту шлюза и имя хоста прокси разрешается на публичный адрес. Прокси, чье имя хоста разрешается только на приватные адреса, разрешен и не вызывает эту ошибку | Добавьте хост шлюза в `NO_PROXY` на машине разработчика, чтобы соединение было прямым, или используйте прокси, чье имя хоста разрешается на приватные адреса. Сообщение называет точную запись `NO_PROXY` для добавления |364| CLI `/login`: `Gateway login would go through proxy <proxy>, which is not on a private network` | `HTTPS_PROXY` или `HTTP_PROXY` применяется к хосту шлюза и имя хоста прокси разрешается на публичный адрес. Прокси, чье имя хоста разрешается только на приватные адреса, разрешен и не вызывает эту ошибку | Добавьте хост шлюза в `NO_PROXY` на машине разработчика, чтобы соединение было прямым, или используйте прокси, чье имя хоста разрешается на приватные адреса. Сообщение называет точную запись `NO_PROXY` для добавления |

296| CLI `/login`: `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | Шлюз находится на блоке, объявленном в [`gatewayInternalNetworks`](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), и машина разработчика достигла его с адреса вне этого блока: адрес из пула VPN, контейнер или сегмент NAT WSL2, или сеть, которая не ваша | Попросите разработчика запустить `/login` из хост-ОС в вашей сети. Если показанный адрес также является собственным публичным пространством вашей организации, замените запись шлюза на блок, который охватывает оба, вплоть до `/8`; вторая, перекрывающаяся запись отклоняется |365| CLI `/login`: `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | Шлюз находится на блоке, объявленном в [`gatewayInternalNetworks`](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), и машина разработчика достигла его с адреса вне этого блока: адрес из пула VPN, контейнер или сегмент NAT WSL2, или сеть, которая не ваша | Попросите разработчика запустить `/login` из хост-ОС в вашей сети. Если показанный адрес также является собственным публичным пространством вашей организации, замените запись шлюза на блок, который охватывает оба, вплоть до `/8`; вторая, перекрывающаяся запись отклоняется |


301| CLI `/login`: `Could not resolve gateway host <host>` | Машина не может разрешить внутреннее DNS имя шлюза, обычно потому что она не в корпоративной сети | Попросите разработчика подключиться к вашей сети или VPN, затем повторите попытку `/login` |370| CLI `/login`: `Could not resolve gateway host <host>` | Машина не может разрешить внутреннее DNS имя шлюза, обычно потому что она не в корпоративной сети | Попросите разработчика подключиться к вашей сети или VPN, затем повторите попытку `/login` |

302| Загрузка выходит с ошибкой валидации конфигурации, называющей `store.postgres_url` | Postgres не настроен; шлюз требует Postgres | Установите `store.postgres_url`. Для локальной разработки используйте одноразовый контейнер: `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`. |371| Загрузка выходит с ошибкой валидации конфигурации, называющей `store.postgres_url` | Postgres не настроен; шлюз требует Postgres | Установите `store.postgres_url`. Для локальной разработки используйте одноразовый контейнер: `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`. |

303| Загрузка выходит: `requires the native binary` | Запуск под Node вместо нативного бинарного файла | Установите Claude Code с одним из [методов автономной установки](/docs/ru/setup) |372| Загрузка выходит: `requires the native binary` | Запуск под Node вместо нативного бинарного файла | Установите Claude Code с одним из [методов автономной установки](/docs/ru/setup) |

304| Загрузка выходит с ошибкой обнаружения OIDC после `config.load` | `oidc.issuer` недоступен или цепь TLS не доверена | Проверьте, что издатель доступен из pod и обслуживает `/.well-known/openid-configuration`. Установите `ca_cert_pem` для приватной PKI. Если pod достигает IdP только через forward proxy, установите [`oidc.use_proxy: true`](/docs/ru/claude-apps-gateway-config#idp-requests-through-a-forward-proxy); на версиях до v2.1.227 предоставьте pod прямой маршрут к каждой конечной точке IdP вместо этого. |373| Загрузка выходит с ошибкой обнаружения OIDC после `config.load` | `oidc.issuer` недоступен или цепь TLS не доверена | Проверьте, что издатель доступен из pod и обслуживает `/.well-known/openid-configuration`. Установите `ca_cert_pem` для приватной PKI. Если pod достигает IdP только через forward proxy, установите [`oidc.use_proxy: true`](/docs/ru/claude-apps-gateway-config#idp-requests-through-a-forward-proxy); на версиях до v2.1.227 предоставьте pod прямой маршрут к каждой конечной точке IdP вместо этого. Если pod также не может разрешить имя хоста IdP или прокси отказывает `CONNECT` на IP адрес, см. [Proxy-only egress](/docs/ru/claude-apps-gateway-config#proxy-only-egress), что требует v2.1.277 или позже. |

305| Загрузка выходит с ошибкой разрешения Postgres | Роль базы данных не имеет прав DDL на своей схеме | Предоставьте роли `CREATE` на схему шлюза, чтобы она могла создавать и изменять свои таблицы при загрузке |374| Загрузка выходит с ошибкой разрешения Postgres | Роль базы данных не имеет прав DDL на своей схеме | Предоставьте роли `CREATE` на схему шлюза, чтобы она могла создавать и изменять свои таблицы при загрузке |

375| Лог: `could not connect to Postgres at boot, attempt 1 of 3` | База данных не была доступна, когда шлюз запустился, например на холодном экземпляре, чья сеть все еще поднимается | Если шлюз затем завершает загрузку, никаких действий не требуется. Когда база данных недоступна, шлюз пытается подключиться три раза, с интервалом в две секунды, перед выходом. Если он выходит с `could not connect to Postgres`, проверьте `store.postgres_url` и сетевой путь к базе данных. Если попытки истекают по времени, а не отклоняются, поднимите [`store.connect_timeout_seconds`](/docs/ru/claude-apps-gateway-config#store), чтобы дать каждой больше времени. |

306| `/oauth/callback` показывает "Sign-in could not be completed" | Домен email отклонен, валидация id\_token не удалась или `email_verified` явно `false`, что шлюз всегда отклоняет без переопределения | Проверьте `allowed_email_domains` и что IdP возвращает проверенное утверждение `email`. Для `email_verified: false` исправьте проверку на стороне IdP. Если ваш IdP выдает email под другим именем утверждения, установите `oidc.email_claim`. |376| `/oauth/callback` показывает "Sign-in could not be completed" | Домен email отклонен, валидация id\_token не удалась или `email_verified` явно `false`, что шлюз всегда отклоняет без переопределения | Проверьте `allowed_email_domains` и что IdP возвращает проверенное утверждение `email`. Для `email_verified: false` исправьте проверку на стороне IdP. Если ваш IdP выдает email под другим именем утверждения, установите `oidc.email_claim`. |

307| Лог: `token exchange failed request_id=<id>: id_token missing email claim` | IdP не включает `email` в id\_token по умолчанию. Это отклонение срабатывает только когда установлен `allowed_email_domains`; без него отсутствующий email создает сеанс без email | Настройте IdP для выдачи `email` в id\_token. Okta: добавьте `email` к утверждениям ID-token пользовательского сервера авторизации. Entra: добавьте `email` как опциональное утверждение на регистрацию приложения. PingFederate: включите политику OpenID Connect, которая выдает `email`. Если IdP обслуживает `email` из конечной точки userinfo, но не будет включать его в id\_token, такой как сервер авторизации организации Okta, установите `oidc.userinfo_fallback: true`. |377| Лог: `token exchange failed request_id=<id>: id_token missing email claim` | IdP не включает `email` в id\_token по умолчанию. Это отклонение срабатывает только когда установлен `allowed_email_domains`; без него отсутствующий email создает сеанс без email | Настройте IdP для выдачи `email` в id\_token. Okta: добавьте `email` к утверждениям ID-token пользовательского сервера авторизации. Entra: добавьте `email` как опциональное утверждение на регистрацию приложения. PingFederate: включите политику OpenID Connect, которая выдает `email`. Если IdP обслуживает `email` из конечной точки userinfo, но не будет включать его в id\_token, такой как сервер авторизации организации Okta, установите `oidc.userinfo_fallback: true`. |

308| Лог: `refresh failed request_id=<id>: invalid_token (…) (at userinfo_no_id_token, …)`, и разработчики видят `Cloud gateway session expired` каждые `session.ttl_hours` | IdP принял refresh token, но не вернул id\_token с ним, поэтому шлюз попросил конечную точку userinfo IdP для утверждений пользователя. IdP отклонил обновленный access token там. Шлюз отвечает `temporarily_unavailable`, поэтому Claude Code сохраняет refresh token, но не может обновить сеанс. Версии шлюза до v2.1.260 логируют ту же строку без деталей `(at …)`. | Установите [`oidc.scope_on_refresh: true`](/docs/ru/claude-apps-gateway-config#oidc), доступно в шлюзе v2.1.260 или позже, чтобы запрос refresh запрашивал `openid` снова. Некоторые IdP, такие как Okta, возвращают id\_token при refresh только при запросе. На PingFederate включите **Return ID Token On Refresh Grant** под **Applications > OAuth > OpenID Connect Policy Management** вместо этого. Ключ не изменяет поведение PingFederate. Для других IdP, которые все еще его опускают, проверьте, принимает ли конечная точка userinfo access tokens, выданные refresh. Как временное решение, поднимите [`session.ttl_hours`](/docs/ru/claude-apps-gateway-config#session). См. [Identity provider setup](#identity-provider-setup) для компромисса deprovisioning. |378| Лог: `refresh failed request_id=<id>: invalid_token (…) (at userinfo_no_id_token, …)`, и разработчики видят `Cloud gateway session expired` каждые `session.ttl_hours` | IdP принял refresh token, но не вернул id\_token с ним, поэтому шлюз попросил конечную точку userinfo IdP для утверждений пользователя. IdP отклонил обновленный access token там. Шлюз отвечает `temporarily_unavailable`, поэтому Claude Code сохраняет refresh token, но не может обновить сеанс. Версии шлюза до v2.1.260 логируют ту же строку без деталей `(at …)`. | Установите [`oidc.scope_on_refresh: true`](/docs/ru/claude-apps-gateway-config#oidc), доступно в шлюзе v2.1.260 или позже, чтобы запрос refresh запрашивал `openid` снова. Некоторые IdP, такие как Okta, возвращают id\_token при refresh только при запросе. На PingFederate включите **Return ID Token On Refresh Grant** под **Applications > OAuth > OpenID Connect Policy Management** вместо этого. Ключ не изменяет поведение PingFederate. Для других IdP, которые все еще его опускают, проверьте, принимает ли конечная точка userinfo access tokens, выданные refresh. Как временное решение, поднимите [`session.ttl_hours`](/docs/ru/claude-apps-gateway-config#session). См. [Identity provider setup](#identity-provider-setup) для компромисса deprovisioning. |

309| Каждый запрос Amazon Bedrock возвращает 502; лог показывает `Could not load credentials from any providers` | На EC2 hop limit IMDSv2 по умолчанию 1 блокирует запрос метаданных экземпляра изнутри контейнера. Загрузка и `/readyz` проходят в любом случае, потому что AWS SDK разрешает учетные данные экземпляра при первом запросе, а не при построении клиента | Поднимите hop limit с `aws ec2 modify-instance-metadata-options --instance-id <id> --http-put-response-hop-limit 2` или установите его в шаблоне запуска. Изменение применяется к каждому контейнеру на экземпляре. Предпочитайте роли задач ECS, где доступны, которые читают учетные данные из конечной точки учетных данных контейнера ECS и избегают изменения полностью, или применяйте изменение на выделенном экземпляре шлюза, чтобы ограничить воздействие. |379| Каждый запрос Amazon Bedrock возвращает 502; лог показывает `Could not load credentials from any providers` | На EC2 hop limit IMDSv2 по умолчанию 1 блокирует запрос метаданных экземпляра изнутри контейнера. Загрузка и `/readyz` проходят в любом случае, потому что AWS SDK разрешает учетные данные экземпляра при первом запросе, а не при построении клиента | Поднимите hop limit с `aws ec2 modify-instance-metadata-options --instance-id <id> --http-put-response-hop-limit 2` или установите его в шаблоне запуска. Изменение применяется к каждому контейнеру на экземпляре. Предпочитайте роли задач ECS, где доступны, которые читают учетные данные из конечной точки учетных данных контейнера ECS и избегают изменения полностью, или применяйте изменение на выделенном экземпляре шлюза, чтобы ограничить воздействие. |

380| При пиковой нагрузке ответы медленно начинаются или кажутся зависшими, или не удаются с 502 `all upstreams failed`, пока upstream здоров | Реплика имеет больше открытых запросов, чем отправляет upstream одновременно, поэтому дополнительные запросы ждут внутри шлюза. На upstream `provider: anthropic`, запрос, который ждет дольше, чем `timeouts.upstream_ttfb_ms`, отказывается от этого upstream, что производит 502, когда никакой более поздний upstream не обслуживает его. Лог показывает предупреждение, которое содержит `client requests are open`. | Добавьте реплики или поднимите лимит на каждой реплике. См. [Concurrent upstream requests](#concurrent-upstream-requests). |

310| Ошибка IdP: unknown or unsupported scope | IdP отклоняет области, которые он не распознает | Установите `oidc.scopes` на точный список, который принимает ваш IdP; он должен включать `openid`. По умолчанию `openid profile email offline_access`. |381| Ошибка IdP: unknown or unsupported scope | IdP отклоняет области, которые он не распознает | Установите `oidc.scopes` на точный список, который принимает ваш IdP; он должен включать `openid`. По умолчанию `openid profile email offline_access`. |

311| Сеансы не молчаливо обновляются после установки `oidc.scopes` | `offline_access` был удален из переопределения | Добавьте `offline_access` обратно, если ваш IdP его поддерживает. Без refresh token разработчики повторно запускают вход в браузер каждые `session.ttl_hours`. |382| Сеансы не молчаливо обновляются после установки `oidc.scopes` | `offline_access` был удален из переопределения | Добавьте `offline_access` обратно, если ваш IdP его поддерживает. Без refresh token разработчики повторно запускают вход в браузер каждые `session.ttl_hours`. |

312| Браузер показывает "This request came from another site and was blocked" | Cross-site form POST, заблокирован как защита CSRF. Ожидается для встроенных или проксированных страниц | Откройте ссылку проверки напрямую |383| Браузер показывает "This request came from another site and was blocked" | Cross-site form POST, заблокирован как защита CSRF. Ожидается для встроенных или проксированных страниц | Откройте ссылку проверки напрямую |

Details

504| Запросы Bedrock возвращают `403 AccessDeniedException` | Учётная запись не отправила одноразовую форму использования Anthropic, автоматическая подписка AWS Marketplace, которая начинается при первом вызове учётной записи, ещё не завершена, или политика роли задачи отсутствует ARN профиля вывода или модели фундамента | Отправьте форму использования из каталога моделей консоли Bedrock; если она была только что отправлена или это первый вызов учётной записи, повторите попытку через несколько минут. Предоставьте `bedrock:InvokeModel` и `bedrock:InvokeModelWithResponseStream` на обоих семействах ARN. |504| Запросы Bedrock возвращают `403 AccessDeniedException` | Учётная запись не отправила одноразовую форму использования Anthropic, автоматическая подписка AWS Marketplace, которая начинается при первом вызове учётной записи, ещё не завершена, или политика роли задачи отсутствует ARN профиля вывода или модели фундамента | Отправьте форму использования из каталога моделей консоли Bedrock; если она была только что отправлена или это первый вызов учётной записи, повторите попытку через несколько минут. Предоставьте `bedrock:InvokeModel` и `bedrock:InvokeModelWithResponseStream` на обоих семействах ARN. |

505| Bedrock возвращает `ValidationException`, говоря, что пропускная способность по требованию не поддерживается | Пользовательская запись `models:` отображается на голый ID модели фундамента, который регион обслуживает только через профили вывода | Отобразите модель на её ID профиля вывода между регионами (`us.anthropic.*`) вместо этого; встроенный каталог уже это делает |505| Bedrock возвращает `ValidationException`, говоря, что пропускная способность по требованию не поддерживается | Пользовательская запись `models:` отображается на голый ID модели фундамента, который регион обслуживает только через профили вывода | Отобразите модель на её ID профиля вывода между регионами (`us.anthropic.*`) вместо этого; встроенный каталог уже это делает |

506| Задача ECS останавливается с `ResourceInitializationError` перед тем, как gateway что-либо регистрирует | Роль выполнения не может читать секреты Secrets Manager, или приватные подсети не имеют пути к Secrets Manager или ECR | Предоставьте `secretsmanager:GetSecretValue` на ARN трёх секретов `gateway-` роли выполнения и обеспечьте исходящий доступ через NAT gateway, или, без него, интерфейсные конечные точки для Secrets Manager, ECR и CloudWatch Logs, которые драйвер `awslogs` нуждается на той же стадии, плюс конечная точка шлюза S3 |506| Задача ECS останавливается с `ResourceInitializationError` перед тем, как gateway что-либо регистрирует | Роль выполнения не может читать секреты Secrets Manager, или приватные подсети не имеют пути к Secrets Manager или ECR | Предоставьте `secretsmanager:GetSecretValue` на ARN трёх секретов `gateway-` роли выполнения и обеспечьте исходящий доступ через NAT gateway, или, без него, интерфейсные конечные точки для Secrets Manager, ECR и CloudWatch Logs, которые драйвер `awslogs` нуждается на той же стадии, плюс конечная точка шлюза S3 |

507| Загрузка gateway выходит с ошибкой тайм-аута подключения Postgres | Группа безопасности базы данных не допускает группу безопасности gateway на 5432, или сервис работает вне VPC базы данных; хранилище перестаёт ждать после 5 секунд | Разрешите 5432 от группы безопасности gateway на группе безопасности базы данных и запустите сервис в том же VPC, что и группа подсетей БД |507| Загрузка gateway выходит с ошибкой тайм-аута подключения Postgres | Группа безопасности базы данных не допускает группу безопасности gateway на 5432, или сервис работает вне VPC базы данных | Разрешите 5432 от группы безопасности gateway на группе безопасности базы данных и запустите сервис в том же VPC, что и группа подсетей БД |

508| Загрузка gateway выходит с ошибкой проверки сертификата TLS Postgres | Строка подключения устанавливает `sslmode=verify-full`, но образ не доверяет пакету RDS CA: пакет не был скопирован в образ, или `NODE_EXTRA_CA_CERTS` не указывает на него | Добавьте две строки Dockerfile шага сборки, которые копируют пакет и устанавливают `NODE_EXTRA_CA_CERTS`, затем пересоберите, отправьте под новым тегом и переразвёртывайте |508| Загрузка gateway выходит с ошибкой проверки сертификата TLS Postgres | Строка подключения устанавливает `sslmode=verify-full`, но образ не доверяет пакету RDS CA: пакет не был скопирован в образ, или `NODE_EXTRA_CA_CERTS` не указывает на него | Добавьте две строки Dockerfile шага сборки, которые копируют пакет и устанавливают `NODE_EXTRA_CA_CERTS`, затем пересоберите, отправьте под новым тегом и переразвёртывайте |

509| Потоковые ответы прерываются в середине потока после тихого периода | Gateway старше v2.1.229 на upstream Bedrock или Claude Platform on AWS не отправляет ничего, пока upstream молчит, например во время расширенного мышления без потокового вывода. ALB закрывает соединение после 60 секунд без данных по умолчанию, поэтому он отрезает поток в этом разрыве. Gateway v2.1.229 и позже держат молчащий поток под этим временем ожидания: на этих upstream gateway выдаёт событие SSE `ping` примерно один раз через 15 секунд без данных потока, и на upstream Anthropic API он передаёт собственные пинги API | Обновите gateway до v2.1.229 или позже, или установите атрибут `idle_timeout.timeout_seconds` на `3600`, через `modify-load-balancer-attributes` или аннотацию `load-balancer-attributes` Ingress на EKS |509| Потоковые ответы прерываются в середине потока после тихого периода | Gateway старше v2.1.229 на upstream Bedrock или Claude Platform on AWS не отправляет ничего, пока upstream молчит, например во время расширенного мышления без потокового вывода. ALB закрывает соединение после 60 секунд без данных по умолчанию, поэтому он отрезает поток в этом разрыве. Gateway v2.1.229 и позже держат молчащий поток под этим временем ожидания: на этих upstream gateway выдаёт событие SSE `ping` примерно один раз через 15 секунд без данных потока, и на upstream Anthropic API он передаёт собственные пинги API | Обновите gateway до v2.1.229 или позже, или установите атрибут `idle_timeout.timeout_seconds` на `3600`, через `modify-load-balancer-attributes` или аннотацию `load-balancer-attributes` Ingress на EKS |

510 510 

Details

282 282 

283Каждый сеанс показывает индикатор diff с добавленными и удалёнными строками, например `+42 -18`. Выберите его, чтобы открыть представление diff, оставить встроенные комментарии к определённым строкам и отправить их Claude со следующим сообщением.283Каждый сеанс показывает индикатор diff с добавленными и удалёнными строками, например `+42 -18`. Выберите его, чтобы открыть представление diff, оставить встроенные комментарии к определённым строкам и отправить их Claude со следующим сообщением.

284 284 

285Представление diff сравнивает изменения сеанса с его базовой веткой по умолчанию. Чтобы сравнить с любой другой веткой в репозитории, выберите **Compare against** и выберите одну.

286 

285Claude Code вычисляет эти diffs, включая diffs для каждого файла, показанные при редактировании Claude, из необработанного содержимого git blob, поэтому драйверы diff и фильтры `textconv`, настроенные в репозитории, не применяются. Для файла в репозитории, который не является одной из собственных рабочих копий сеанса, например клонированного в рабочее пространство во время сеанса, diff для каждого файла показывает само редактирование Claude, а не сравнение git.287Claude Code вычисляет эти diffs, включая diffs для каждого файла, показанные при редактировании Claude, из необработанного содержимого git blob, поэтому драйверы diff и фильтры `textconv`, настроенные в репозитории, не применяются. Для файла в репозитории, который не является одной из собственных рабочих копий сеанса, например клонированного в рабочее пространство во время сеанса, diff для каждого файла показывает само редактирование Claude, а не сравнение git.

286 288 

287Полное пошаговое руководство, включая создание PR, см. в разделе [Просмотр и итерация](/docs/ru/web-quickstart#review-and-iterate). Чтобы Claude автоматически отслеживал PR на предмет сбоев CI и комментариев рецензии, см. [Автоматическое исправление pull requests](#auto-fix-pull-requests).289Полное пошаговое руководство, включая создание PR, см. в разделе [Просмотр и итерация](/docs/ru/web-quickstart#review-and-iterate). Чтобы Claude автоматически отслеживал PR на предмет сбоев CI и комментариев рецензии, см. [Автоматическое исправление pull requests](#auto-fix-pull-requests).

Details

164 Архивирование среды164 Архивирование среды

165</h3>165</h3>

166 166 

167Чтобы архивировать среду, откройте её для редактирования и выберите **Archive**. Вы не можете удалить среду, только архивировать её.167Чтобы архивировать одну из ваших собственных сред, откройте её для редактирования и выберите **Archive**. Владелец архивирует [общую среду](#organization-shared-environments) со страницы **Cloud environments** в параметрах администратора. Вы не можете удалить среду, только архивировать её.

168 168 

169Архивирование влияет на новые сеансы, а не на работающие:169Архивирование влияет на новые сеансы, а не на работающие:

170 170 


177 Общие среды организации177 Общие среды организации

178</h3>178</h3>

179 179 

180На планах Team и Enterprise владелец может создавать облачные среды, которые совместно используются со всеми членами организации. Та же роль управляет всем остальным на странице администратора **Cloud environments**, включая [самостоятельно размещённые среды](/docs/ru/self-hosted-environments); роль Admin не может открыть страницу. Полный список ролей, которые могут открыть её, — это список для [управления параметрами, управляемыми сервером](/docs/ru/server-managed-settings#access-control). Общие среды появляются в селекторе среды каждого члена рядом с их личными, поэтому команда может стандартизировать одну конфигурацию вместо того, чтобы каждый член пересоздавал её.180На планах Team и Enterprise владелец может создавать облачные среды, которые совместно используются со всеми членами организации. Та же роль управляет всем остальным на странице администратора **Cloud environments**, включая [самостоятельно размещённые среды](/docs/ru/self-hosted-environments); роль Admin не может открыть страницу. Полный список ролей, которые могут открыть её, — это список для [управления параметрами, управляемыми сервером](/docs/ru/server-managed-settings#access-control).

181 181 

182Создавайте, редактируйте и архивируйте общие среды со страницы **Cloud environments** в [параметрах администратора](https://claude.ai/admin-settings). Общая среда также открывается из [селектора среды](#configure-your-environment) на [claude.ai/code](https://claude.ai/code): владелец может редактировать её там. Другие члены видят её только для чтения. Каждая общая среда имеет имя, [уровень доступа в сеть](#access-levels), [переменные окружения](#set-environment-variables) в формате `.env` и [скрипт установки](#setup-scripts). Владельцы выбирают [среду по умолчанию](#the-default-environment) организации отдельно на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).182Общие среды появляются в [селекторе среды](#configure-your-environment) каждого члена под заголовком **Organization**, после личных сред члена под **Personal**, поэтому команда может стандартизировать одну конфигурацию вместо того, чтобы каждый член пересоздавал её. Выбор значка параметров общей среды там открывает сводку её конфигурации только для чтения для каждого члена, включая владельцев.

183 

184Владелец делает среду доступной для организации одним из двух способов:

185 

186* **Создание общей среды**: используйте страницу **Cloud environments** в [параметрах администратора](https://claude.ai/admin-settings), которая также является местом, где владельцы редактируют и архивируют общие среды. Каждая имеет имя, [уровень доступа в сеть](#access-levels), [переменные окружения](#set-environment-variables) в формате `.env` и [скрипт установки](#setup-scripts).

187* **Совместное использование личной среды**: откройте одну из ваших собственных сред для редактирования в селекторе среды, затем поделитесь ею из строки **Who can use it**. Среда сохраняет свой ID, поэтому сеансы и процедуры, которые уже её используют, не затрагиваются, и каждый член может затем её видеть и запускать в ней сеансы.

188 

189Владельцы выбирают [среду по умолчанию](#the-default-environment) организации отдельно на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).

183 190 

184Каждый сеанс члена в общей среде читает её переменные, поэтому не включайте секреты в них. [Учётные данные API](#add-api-credentials), которые дают сеансам ключ, который они не могут читать, недоступны на планах Team или Enterprise пока.191Каждый сеанс члена в общей среде читает её переменные, поэтому не включайте секреты в них. [Учётные данные API](#add-api-credentials), которые дают сеансам ключ, который они не могут читать, недоступны на планах Team или Enterprise пока.

185 192 


198 205 

199Каждая среда устанавливает один уровень доступа в сеть, который контролирует исходящие соединения, которые могут устанавливать её сеансы. Уровень по умолчанию, **Trusted**, разрешает реестры пакетов и другие [разрешённые домены](#default-allowed-domains); **Custom** принимает ваш собственный список доменов.206Каждая среда устанавливает один уровень доступа в сеть, который контролирует исходящие соединения, которые могут устанавливать её сеансы. Уровень по умолчанию, **Trusted**, разрешает реестры пакетов и другие [разрешённые домены](#default-allowed-domains); **Custom** принимает ваш собственный список доменов.

200 207 

201Чтобы изменить доступ в сеть среды, [откройте её для редактирования](#configure-your-environment) и используйте селектор **Network access** в диалоге. Облачный значок, который открывает селектор, появляется на поверхностях приложения, перечисленных в [Среда Default](#the-default-environment) и в [редакторе процедуры](/docs/ru/routines#environments-and-network-access); личные среды не имеют отдельной страницы в параметрах вашей учётной записи claude.ai.208Чтобы изменить доступ в сеть среды, [откройте её для редактирования](#configure-your-environment) и используйте селектор **Network access** в диалоге. [Общая для организации среда](#organization-shared-environments) открывается в режиме только для чтения там, поэтому владелец изменяет её доступ в сеть со страницы **Cloud environments** в [параметрах администратора](https://claude.ai/admin-settings). Облачный значок, который открывает селектор, появляется на поверхностях приложения, перечисленных в [Среда Default](#the-default-environment) и в [редакторе процедуры](/docs/ru/routines#environments-and-network-access); личные среды не имеют отдельной страницы в параметрах вашей учётной записи claude.ai.

202 209 

203<Note>210<Note>

204 Соединители MCP, которые вы включаете в сеансе или процедуре, работают без добавления их хостов в **Allowed domains**, потому что трафик соединителя проходит через серверы Anthropic, а не через сеть сеанса. Это полагается на тот же канал, привязанный к Anthropic, отмеченный в [Безопасность и изоляция](/docs/ru/claude-code-on-the-web#security-and-isolation). Отключите любой соединитель, который вам не нужен, чтобы ограничить, какие инструменты может достичь Claude.211 Соединители MCP, которые вы включаете в сеансе или процедуре, работают без добавления их хостов в **Allowed domains**, потому что трафик соединителя проходит через серверы Anthropic, а не через сеть сеанса. Это полагается на тот же канал, привязанный к Anthropic, отмеченный в [Безопасность и изоляция](/docs/ru/claude-code-on-the-web#security-and-isolation). Отключите любой соединитель, который вам не нужен, чтобы ограничить, какие инструменты может достичь Claude.

env-vars.md +198 −198

Details

142</Note>142</Note>

143 143 

144| Переменная | Назначение |144| Переменная | Назначение |

145| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |145| :------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

146| `ANTHROPIC_API_KEY` | Ключ API отправляется как заголовок `X-Api-Key`. Если установлен, этот ключ используется вместо вашей подписки Claude Pro, Max, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии. В интерактивном режиме вас просят одобрить ключ один раз перед тем, как он переопределит вашу подписку. Чтобы использовать вашу подписку, запустите `unset ANTHROPIC_API_KEY` |146| `ANTHROPIC_API_KEY` | Ключ API отправляется как заголовок `X-Api-Key`. Если установлен, этот ключ используется вместо вашей подписки Claude Pro, Max, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии. В интерактивном режиме вас просят одобрить ключ один раз перед тем, как он переопределит вашу подписку. Чтобы использовать вашу подписку, запустите `unset ANTHROPIC_API_KEY` |

147| `ANTHROPIC_AUTH_TOKEN` | Пользовательское значение для заголовка `Authorization` (значение, которое вы установите здесь, будет дополнено префиксом `Bearer `) |147| `ANTHROPIC_AUTH_TOKEN` | Пользовательское значение для заголовка `Authorization` (значение, которое вы установите здесь, будет дополнено префиксом `Bearer `) |

148| `ANTHROPIC_AWS_API_KEY` | Ключ API рабочей области для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), созданный в консоли AWS. Отправляется как `x-api-key` и имеет приоритет над AWS SigV4 |148| `ANTHROPIC_AWS_API_KEY` | Ключ API рабочей области для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), созданный в консоли AWS. Отправляется как `x-api-key` и имеет приоритет над AWS SigV4 |

149| `ANTHROPIC_AWS_BASE_URL` | Переопределить URL конечной точки [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Используйте для пользовательских регионов или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). По умолчанию `https://aws-external-anthropic.{region}.api.aws`. Claude Code разрешает регион с [тем же приоритетом, что и на Amazon Bedrock](/docs/ru/amazon-bedrock#3-configure-claude-code) |149| `ANTHROPIC_AWS_BASE_URL` | Переопределить URL конечной точки [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Используйте для пользовательских регионов или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). По умолчанию `https://aws-external-anthropic.{region}.api.aws`. Claude Code разрешает регион с [той же приоритетностью, что и на Amazon Bedrock](/docs/ru/amazon-bedrock#3-configure-claude-code) |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | Требуется для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Отправляется при каждом запросе как заголовок `anthropic-workspace-id` |150| `ANTHROPIC_AWS_WORKSPACE_ID` | Требуется для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Отправляется в каждом запросе как заголовок `anthropic-workspace-id` |

151| `ANTHROPIC_BASE_URL` | Переопределить конечную точку API для маршрутизации запросов через прокси или шлюз. Если установлено на хост, не являющийся первой стороной, [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) отключен по умолчанию. Установите `ENABLE_TOOL_SEARCH=true`, если ваш прокси пересылает блоки `tool_reference`. Начиная с версии 2.1.196, [Remote Control](/docs/ru/remote-control#requirements) отключен, когда это указывает на хост, отличный от `api.anthropic.com`, что соответствует его поведению на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry |151| `ANTHROPIC_BASE_URL` | Переопределить конечную точку API для маршрутизации запросов через прокси или шлюз. Если установлено на хост, не являющийся первой стороной, [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) отключен по умолчанию. Установите `ENABLE_TOOL_SEARCH=true`, если ваш прокси пересылает блоки `tool_reference`. Начиная с версии 2.1.196, [Remote Control](/docs/ru/remote-control#requirements) отключен, когда это указывает на хост, отличный от `api.anthropic.com`, что соответствует его поведению на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry |

152| `ANTHROPIC_BEDROCK_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock. Используйте для пользовательских конечных точек Amazon Bedrock или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). См. [Amazon Bedrock](/docs/ru/amazon-bedrock) |152| `ANTHROPIC_BEDROCK_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock. Используйте для пользовательских конечных точек Amazon Bedrock или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). См. [Amazon Bedrock](/docs/ru/amazon-bedrock) |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock Mantle. См. [Конечная точка Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock Mantle. См. [Конечная точка Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) |


157| `ANTHROPIC_CUSTOM_HEADERS` | Пользовательские заголовки для добавления к запросам (формат `Name: Value`, разделенные новой строкой для нескольких заголовков). Если имя или значение содержит символ, который HTTP-заголовок не может нести, например фигурную кавычку или пробел нулевой ширины, запрос завершается с ошибкой, которая определяет пару по позиции. Требует Claude Code версии 2.1.227 или позже. [Invalid request header value](/docs/ru/errors#invalid-request-header-value) перечисляет точный набор символов и где выполняется проверка. Значение, которое устанавливает учетные данные, организацию или тенант, маршрутизацию или заголовок поведения API, такой как `Authorization` или `Host`, считается [параметром, требующим одобрения](/docs/ru/server-managed-settings#environment-variables-and-the-approval-dialog), когда управляемые на сервере параметры доставляют его. Из параметров проекта или локальных параметров такое значение следует [правилам для применения значений `env`](/docs/ru/settings-reference#when-claude-code-applies-env-values) |157| `ANTHROPIC_CUSTOM_HEADERS` | Пользовательские заголовки для добавления к запросам (формат `Name: Value`, разделенные новой строкой для нескольких заголовков). Если имя или значение содержит символ, который HTTP-заголовок не может нести, например фигурную кавычку или пробел нулевой ширины, запрос завершается с ошибкой, которая определяет пару по позиции. Требует Claude Code версии 2.1.227 или позже. [Invalid request header value](/docs/ru/errors#invalid-request-header-value) перечисляет точный набор символов и где выполняется проверка. Значение, которое устанавливает учетные данные, организацию или тенант, маршрутизацию или заголовок поведения API, такой как `Authorization` или `Host`, считается [параметром, требующим одобрения](/docs/ru/server-managed-settings#environment-variables-and-the-approval-dialog), когда управляемые на сервере параметры доставляют его. Из параметров проекта или локальных параметров такое значение следует [правилам для применения значений `env`](/docs/ru/settings-reference#when-claude-code-applies-env-values) |

158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID модели для добавления в качестве пользовательской записи в средство выбора `/model`. Используйте это, чтобы сделать нестандартную или специфичную для шлюза модель выбираемой без замены встроенных псевдонимов. См. [Конфигурация модели](/docs/ru/model-config#add-a-custom-model-option) |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID модели для добавления в качестве пользовательской записи в средство выбора `/model`. Используйте это, чтобы сделать нестандартную или специфичную для шлюза модель выбираемой без замены встроенных псевдонимов. См. [Конфигурация модели](/docs/ru/model-config#add-a-custom-model-option) |

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Описание отображения для пользовательской записи модели в средстве выбора `/model`. По умолчанию `Custom model (<model-id>)`, если не установлено |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Описание отображения для пользовательской записи модели в средстве выбора `/model`. По умолчанию `Custom model (<model-id>)`, если не установлено |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Отображаемое имя для пользовательской записи модели в средстве выбора `/model`. Если не установлено, запись показывает имя модели, если Claude Code [распознает ID](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), и ID модели в противном случае |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Имя отображения для пользовательской записи модели в средстве выбора `/model`. Если не установлено, запись показывает имя модели, если Claude Code [распознает ID](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), и ID модели в противном случае |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает пользовательская модель, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает пользовательская модель, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID модели, на которую разрешается псевдоним `fable`, и ID, который Claude Code распознает как модель Fable для [автоматического переключения модели](/docs/ru/model-config#automatic-model-fallback) на сторонних поставщиков. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID модели, на которую разрешается псевдоним `fable`, и ID, который Claude Code распознает как модель Fable для [автоматического переключения модели](/docs/ru/model-config#automatic-model-fallback) на сторонних поставщиков. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Описание отображения для закрепленной модели Fable в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Fable model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Описание отображения для закрепленной модели Fable в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Fable model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Отображаемое имя для закрепленной модели Fable в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознает закрепленный ID, и закрепленный ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Имя отображения для закрепленной модели Fable в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознает закрепленный ID, и закрепленный ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закрепленная модель Fable, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закрепленная модель Fable, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID модели, на которую разрешается псевдоним `haiku`, также используется для [фоновой функциональности](/docs/ru/costs#background-token-usage). См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID модели, на которую разрешается псевдоним `haiku`, также используется для [фоновой функциональности](/docs/ru/costs#background-token-usage). См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Описание отображения для закрепленной модели Haiku в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Haiku model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Описание отображения для закрепленной модели Haiku в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Haiku model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Отображаемое имя для закрепленной модели Haiku в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознает закрепленный ID, и закрепленный ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Имя отображения для закрепленной модели Haiku в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознает закрепленный ID, и закрепленный ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закрепленная модель Haiku, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закрепленная модель Haiku, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

170| `ANTHROPIC_DEFAULT_MODEL` | Модель, на которой новые сеансы начинаются по умолчанию. Требует Claude Code версии 2.1.236 или позже. См. [Установить модель по умолчанию для новых сеансов](/docs/ru/model-config#set-a-default-model-for-new-sessions) |170| `ANTHROPIC_DEFAULT_MODEL` | Модель, на которой новые сеансы начинаются по умолчанию. Требует Claude Code версии 2.1.236 или позже. См. [Установить модель по умолчанию для новых сеансов](/docs/ru/model-config#set-a-default-model-for-new-sessions) |

171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID модели, на которую разрешается псевдоним `opus`, и которую использует `opusplan` во время активного режима Plan Mode. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID модели, на которую разрешается псевдоним `opus`, и которую использует `opusplan` во время активного режима Plan Mode. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Описание отображения для закрепленной модели Opus в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Opus model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Описание отображения для закрепленной модели Opus в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Opus model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Отображаемое имя для закрепленной модели Opus в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознает закрепленный ID, и закрепленный ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Имя отображения для закрепленной модели Opus в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознает закрепленный ID, и закрепленный ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закрепленная модель Opus, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закрепленная модель Opus, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID модели, на которую разрешается псевдоним `sonnet`, и которую использует `opusplan`, когда режим Plan Mode не активен. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID модели, на которую разрешается псевдоним `sonnet`, и которую использует `opusplan`, когда режим Plan Mode не активен. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Описание отображения для закрепленной модели Sonnet в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Sonnet model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Описание отображения для закрепленной модели Sonnet в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Sonnet model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Отображаемое имя для закрепленной модели Sonnet в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознает закрепленный ID, и закрепленный ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Имя отображения для закрепленной модели Sonnet в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознает закрепленный ID, и закрепленный ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закрепленная модель Sonnet, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закрепленная модель Sonnet, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

179| `ANTHROPIC_FEDERATION_RULE_ID` | ID правила федерации для [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Когда вы устанавливаете его вместе с `ANTHROPIC_ORGANIZATION_ID`, Claude Code выбирает учетные данные федерации, которые имеют приоритет над вашим учетным данным `/login`. См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |179| `ANTHROPIC_FEDERATION_RULE_ID` | ID правила федерации для [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Когда вы устанавливаете его вместе с `ANTHROPIC_ORGANIZATION_ID`, Claude Code выбирает учетные данные федерации, которые имеют приоритет над вашим учетным данным `/login`. См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |

180| `ANTHROPIC_FOUNDRY_API_KEY` | Ключ API для аутентификации Microsoft Foundry (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |180| `ANTHROPIC_FOUNDRY_API_KEY` | Ключ API для аутентификации Microsoft Foundry (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |


183| `ANTHROPIC_FOUNDRY_RESOURCE` | Имя ресурса Microsoft Foundry (например, `my-resource`). Требуется, если `ANTHROPIC_FOUNDRY_BASE_URL` не установлен (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Имя ресурса Microsoft Foundry (например, `my-resource`). Требуется, если `ANTHROPIC_FOUNDRY_BASE_URL` не установлен (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |

184| `ANTHROPIC_MODEL` | Имя параметра модели для использования (см. [Конфигурация модели](/docs/ru/model-config#environment-variables)) |184| `ANTHROPIC_MODEL` | Имя параметра модели для использования (см. [Конфигурация модели](/docs/ru/model-config#environment-variables)) |

185| `ANTHROPIC_ORGANIZATION_ID` | ID организации для [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите его вместе с `ANTHROPIC_FEDERATION_RULE_ID`. См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |185| `ANTHROPIC_ORGANIZATION_ID` | ID организации для [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите его вместе с `ANTHROPIC_FEDERATION_RULE_ID`. См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |

186| `ANTHROPIC_PROFILE` | Имя профиля Anthropic для аутентификации, такого как созданный [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) или [входом в учетную запись Console без ключа API](/docs/ru/authentication#sign-in-without-an-api-key). См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |186| `ANTHROPIC_PROFILE` | Имя профиля Anthropic для аутентификации, такой как созданный [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) или [входом в учетную запись Console без ключа API](/docs/ru/authentication#sign-in-without-an-api-key). См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |

187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Имя [модели класса Haiku для фоновых задач](/docs/ru/costs) |187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Имя [модели класса Haiku для фоновых задач](/docs/ru/costs) |

188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Переопределить регион AWS для модели класса Haiku при использовании Amazon Bedrock или Amazon Bedrock Mantle. На Amazon Bedrock это вступает в силу только при установке `ANTHROPIC_DEFAULT_HAIKU_MODEL` или устаревшего `ANTHROPIC_SMALL_FAST_MODEL`, так как Amazon Bedrock в противном случае запускает фоновые задачи на [модели Sonnet по умолчанию или основной модели](/docs/ru/amazon-bedrock#4-pin-model-versions) в регионе сеанса |188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Переопределить регион AWS для модели класса Haiku при использовании Amazon Bedrock или Amazon Bedrock Mantle. На Amazon Bedrock это вступает в силу только при установке `ANTHROPIC_DEFAULT_HAIKU_MODEL` или устаревшего `ANTHROPIC_SMALL_FAST_MODEL`, так как Amazon Bedrock в противном случае запускает фоновые задачи на [модели Sonnet по умолчанию или основной модели](/docs/ru/amazon-bedrock#4-pin-model-versions) в регионе сеанса |

189| `ANTHROPIC_VERTEX_BASE_URL` | Переопределить URL конечной точки Google Cloud's Agent Platform. Используйте для пользовательских конечных точек Google Cloud's Agent Platform или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). См. [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |189| `ANTHROPIC_VERTEX_BASE_URL` | Переопределить URL конечной точки Google Cloud's Agent Platform. Используйте для пользовательских конечных точек Google Cloud's Agent Platform или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). См. [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID проекта GCP, на который адресованы запросы Google Cloud's Agent Platform. См. [Настройка учетных данных GCP](/docs/ru/google-vertex-ai#3-configure-gcp-credentials) |190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID проекта GCP, на который адресованы запросы Google Cloud's Agent Platform. См. [Настройка учетных данных GCP](/docs/ru/google-vertex-ai#3-configure-gcp-credentials) |

191| `ANTHROPIC_WORKSPACE_ID` | ID рабочей области для [федерации рабочей нагрузки](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите это, когда ваше правило федерации охватывает более одной рабочей области, чтобы обмен токенов знал, на какую рабочую область ориентироваться |191| `ANTHROPIC_WORKSPACE_ID` | ID рабочей области для [федерации рабочей нагрузки](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите это, когда ваше правило федерации охватывает более одной рабочей области, чтобы обмен токенов знал, на какую рабочую область ориентироваться |

192| `API_FORCE_IDLE_TIMEOUT` | Переопределить таймаут простоя тела в 5 минут, который прерывает потоковый ответ модели, когда байты не поступают. Установите `0` для отключения таймаута, например, когда медленный [шлюз](/docs/ru/llm-gateway) или локальная модель делает паузу дольше 5 минут между фрагментами, или `1` для его включения для каждого поставщика. Если не установлено, таймаут активен на поставщиках, отличных от прямого API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). [Потоковые сторожевые таймеры](/docs/ru/network-config#streaming-idle-watchdogs) работают независимо от него и прерывают длительную молчаливую паузу даже при установке `0` здесь |192| `API_FORCE_IDLE_TIMEOUT` | Переопределить таймаут простоя тела в 5 минут, который прерывает потоковый ответ модели, когда байты не поступают. Установите `0` для отключения таймаута, например, когда медленный [шлюз](/docs/ru/llm-gateway) или локальная модель делает паузу дольше 5 минут между фрагментами, или `1` для его включения для каждого поставщика. Если не установлено, таймаут активен на поставщиках, отличных от прямого API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). [Потоковые сторожевые таймеры](/docs/ru/network-config#streaming-idle-watchdogs) работают независимо от него и прерывают длительную молчаливую паузу даже при установке `0` здесь |

193| `API_TIMEOUT_MS` | Таймаут для запросов API в миллисекундах (по умолчанию: 600000 или 10 минут; максимум: 2147483647). Увеличьте это, когда запросы истекают на медленных сетях или при маршрутизации через прокси. Значения выше максимума переполняют базовый таймер и вызывают немедленный отказ запросов |193| `API_TIMEOUT_MS` | Таймаут для запросов API в миллисекундах (по умолчанию: 600000 или 10 минут; максимум: 2147483647). Увеличьте это при истечении времени ожидания запросов в медленных сетях или при маршрутизации через прокси. Значения выше максимума переполняют базовый таймер и вызывают немедленный отказ запросов |

194| `AWS_BEARER_TOKEN_BEDROCK` | Ключ API Amazon Bedrock для аутентификации (см. [Ключи API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |194| `AWS_BEARER_TOKEN_BEDROCK` | Ключ API Amazon Bedrock для аутентификации (см. [Ключи API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

195| `BASH_DEFAULT_TIMEOUT_MS` | Таймаут по умолчанию для долгоживущих команд bash (по умолчанию: 120000 или 2 минуты) |195| `BASH_DEFAULT_TIMEOUT_MS` | Таймаут по умолчанию для долгоживущих команд bash (по умолчанию: 120000 или 2 минуты) |

196| `BASH_MAX_OUTPUT_LENGTH` | Максимальное количество символов вывода bash, которые Claude Code читает обратно в результат команды (по умолчанию: 30000; максимум: 150000). Если вы установите параметр [`bashOutputMaxChars`](/docs/ru/settings-reference#bashoutputmaxchars), Claude Code игнорирует эту переменную. См. [Ограничения вывода](/docs/ru/tools-reference#output-limits) |196| `BASH_MAX_OUTPUT_LENGTH` | Максимальное количество символов вывода bash, которое Claude Code читает обратно в результат команды (по умолчанию: 30000; максимум: 150000). Если вы установите параметр [`bashOutputMaxChars`](/docs/ru/settings-reference#bashoutputmaxchars), Claude Code игнорирует эту переменную. См. [Ограничения вывода](/docs/ru/tools-reference#output-limits) |

197| `BASH_MAX_TIMEOUT_MS` | Максимальный таймаут, который модель может установить для долгоживущих команд bash (по умолчанию: 600000 или 10 минут). Эффективный потолок — это больший из этого и `BASH_DEFAULT_TIMEOUT_MS` |197| `BASH_MAX_TIMEOUT_MS` | Максимальный таймаут, который модель может установить для долгоживущих команд bash (по умолчанию: 600000 или 10 минут). Эффективный потолок — это больший из этого и `BASH_DEFAULT_TIMEOUT_MS` |

198| `BETA_TRACING_ENDPOINT` | Конечная точка OTLP для [детальной бета-трассировки](/docs/ru/monitoring-usage#traces-beta): с `ENABLE_BETA_TRACING_DETAILED=1` логи и трассировки идут туда вместо настроенных экспортеров. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |198| `BETA_TRACING_ENDPOINT` | Конечная точка OTLP для [детального бета-трассирования](/docs/ru/monitoring-usage#traces-beta): с `ENABLE_BETA_TRACING_DETAILED=1` логи и трассировки идут туда вместо настроенных экспортеров. Установите его в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

199| `CCR_FORCE_BUNDLE` | Установите `1` для принудительного [`claude --cloud`](/docs/ru/claude-code-on-the-web#send-local-repositories-without-github) для упаковки и загрузки вашего локального репозитория вместо клонирования из его удаленного источника |199| `CCR_FORCE_BUNDLE` | Установите `1` для принудительного [`claude --cloud`](/docs/ru/claude-code-on-the-web#send-local-repositories-without-github) для упаковки и загрузки вашего локального репозитория вместо клонирования из его удаленного источника |

200| `CLAUDECODE` | Установите `1` в подпроцессах, которые порождает Claude Code (инструменты Bash и PowerShell, сеансы tmux, команды [hook](/docs/ru/hooks), команды [строки состояния](/docs/ru/statusline), подпроцессы [MCP сервера](/docs/ru/mcp) stdio). Расширения IDE также устанавливают это в их интегрированных терминалах. Используйте для обнаружения, когда скрипт работает внутри подпроцесса, порожденного Claude Code. Чтобы проверить, был ли текущий процесс порожден непосредственно вызовом инструмента или hook, а не внутри MCP сервера stdio, который запустил Claude Code, используйте `CLAUDE_CODE_CHILD_SESSION` вместо этого |200| `CLAUDECODE` | Установите `1` в подпроцессах, которые порождает Claude Code (инструменты Bash и PowerShell, сеансы tmux, [hook](/docs/ru/hooks) команды, [строка состояния](/docs/ru/statusline) команды, подпроцессы [MCP server](/docs/ru/mcp) stdio). Расширения IDE также устанавливают это в своих интегрированных терминалах. Используйте для обнаружения, когда скрипт работает внутри подпроцесса, порожденного Claude Code. Чтобы проверить, был ли текущий процесс порожден непосредственно вызовом инструмента или hook, а не внутри сервера MCP stdio, который запустил Claude Code, используйте `CLAUDE_CODE_CHILD_SESSION` вместо этого |

201| `CLAUDE_AFK_COUNTDOWN_MS` | Сколько миллисекунд перед автопродолжением появляется обратный отсчет на экране на диалоге [`AskUserQuestion`](/docs/ru/tools-reference) без ответа. По умолчанию `20000` (20 секунд), ограничено таймаутом автопродолжения. Не имеет эффекта, если автопродолжение отключено; см. параметр [`askUserQuestionTimeout`](/docs/ru/settings-reference#askuserquestiontimeout) и `CLAUDE_AFK_TIMEOUT_MS`. Требует Claude Code версии 2.1.198 или позже |201| `CLAUDE_AFK_COUNTDOWN_MS` | Сколько миллисекунд перед автопродолжением появляется обратный отсчет на экране на диалоговом окне [`AskUserQuestion`](/docs/ru/tools-reference) без ответа. По умолчанию `20000` (20 секунд), ограничено таймаутом автопродолжения. Не имеет эффекта, если автопродолжение отключено; см. параметр [`askUserQuestionTimeout`](/docs/ru/settings-reference#askuserquestiontimeout) и `CLAUDE_AFK_TIMEOUT_MS`. Требует Claude Code версии 2.1.198 или позже |

202| `CLAUDE_AFK_TIMEOUT_MS` | Сколько миллисекунд времени простоя перед диалогом [`AskUserQuestion`](/docs/ru/tools-reference) без ответа автопродолжается без вас. Автопродолжение отключено по умолчанию; включите его с параметром [`askUserQuestionTimeout`](/docs/ru/settings-reference#askuserquestiontimeout). Эта переменная является переопределением для демонстраций и автоматических тестов: при установке она имеет приоритет над этим параметром и включает автопродолжение даже когда параметр не установлен или `never`. Установка `0` не отключает таймаут; она закрывает диалог немедленно. В версиях 2.1.198 и 2.1.199 автопродолжение было включено по умолчанию с таймаутом `60000` (60 секунд). Требует Claude Code версии 2.1.198 или позже |202| `CLAUDE_AFK_TIMEOUT_MS` | Сколько миллисекунд времени простоя перед диалоговым окном [`AskUserQuestion`](/docs/ru/tools-reference) без ответа автопродолжается без вас. Автопродолжение отключено по умолчанию; включите его с помощью параметра [`askUserQuestionTimeout`](/docs/ru/settings-reference#askuserquestiontimeout). Эта переменная является переопределением для демонстраций и автоматических тестов: при установке она имеет приоритет над этим параметром и включает автопродолжение даже при отсутствии параметра или `never`. Установка `0` не отключает таймаут; она закрывает диалоговое окно немедленно. В версиях 2.1.198 и 2.1.199 автопродолжение было включено по умолчанию с таймаутом `60000` (60 секунд). Требует Claude Code версии 2.1.198 или позже |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Установите `1` для отключения всех встроенных типов [подагентов](/docs/ru/sub-agents), таких как Explore и Plan. Применяется только в неинтерактивном режиме (флаг `-p`). Полезно для пользователей SDK, которые хотят чистый лист. Это также удаляет `general-purpose`, подагента, который Claude Code запускает, когда вызов инструмента Agent опускает `subagent_type`. Такой вызов затем завершается с ошибкой [`subagent_type is required`](/docs/ru/errors#subagent-type-is-required) |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Установите `1` для отключения всех встроенных типов [subagent](/docs/ru/sub-agents), таких как Explore и Plan. Применяется только в неинтерактивном режиме (флаг `-p`). Полезно для пользователей SDK, которые хотят чистый лист. Это также удаляет `general-purpose`, subagent, который Claude Code запускает, когда вызов инструмента Agent опускает `subagent_type`. Такой вызов затем завершается с ошибкой [`subagent_type is required`](/docs/ru/errors#subagent-type-is-required) |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Установите `1` для пропуска префикса `mcp__<server>__` на именах инструментов из MCP серверов, созданных SDK. Инструменты используют свои исходные имена. Только использование SDK |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Установите `1` для пропуска префикса `mcp__<server>__` на именах инструментов из серверов MCP, созданных SDK. Инструменты используют свои исходные имена. Только использование SDK |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Таймаут стагнации в миллисекундах для подагентов. По умолчанию `600000` (10 минут); если вы повысите `CLAUDE_STREAM_IDLE_TIMEOUT_MS` при включенном сторожевом таймере потока, по умолчанию он повысится вместе с ним, как описано в [Обработка медленных или застопорившихся ответов API](/docs/ru/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Таймер сбрасывается при каждом событии потока прогресса; если прогресс не поступает в течение окна, Claude Code прерывает подагента и сообщает о стагнации родителю |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Таймаут стагнации в миллисекундах для subagents. По умолчанию `600000` (10 минут); если вы повысите `CLAUDE_STREAM_IDLE_TIMEOUT_MS` при включенном сторожевом таймере потока, значение по умолчанию повысится вместе с ним, как описано в [Обработка медленных или зависших ответов API](/docs/ru/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Таймер сбрасывается при каждом событии потока прогресса; если прогресс не поступает в течение окна, Claude Code прерывает subagent и сообщает о стагнации родителю |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Установите процент (1-100) окна автокомпактирования, при котором срабатывает автокомпактирование. Используйте более низкие значения, такие как `50`, для более раннего компактирования; переменная не может повысить порог, поэтому значения выше процента по умолчанию игнорируются. Применяется только в сеансах, которые [компактируют перед пределом контекста модели](/docs/ru/model-config#context-window-and-auto-compaction). Применяется к основным разговорам и подагентам |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Установите процент (1-100) окна автокомпактирования, при котором срабатывает автокомпактирование. Используйте более низкие значения, такие как `50`, для более раннего компактирования; переменная не может повысить порог, поэтому значения выше процента по умолчанию игнорируются. Применяется только в сеансах, которые [компактируют перед пределом контекста модели](/docs/ru/model-config#context-window-and-auto-compaction). Применяется к основным разговорам и subagents |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Установите `1` для принудительного включения автоматического фонового выполнения долгоживущих задач агента. Если включено, подагенты переводятся в фоновый режим после работы примерно две минуты. Также включает [автоматическое фоновое выполнение долгих вызовов инструментов MCP](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls) в неинтерактивном режиме на Claude Code версии 2.1.212 или позже |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Установите `1` для принудительного включения автоматического фонового выполнения долгоживущих задач агента. Если включено, subagents переводятся в фоновый режим после работы примерно две минуты. Также включает [автоматическое фоновое выполнение долгих вызовов инструментов MCP](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls) в неинтерактивном режиме на Claude Code версии 2.1.212 или позже |

208| `CLAUDE_AX_PREPARK_MS` | В [режиме чтения с экрана](/docs/ru/accessibility#what-your-screen-reader-hears) сколько миллисекунд Claude Code ждет, с курсором в начале строки, перед тем как написать новую или измененную строку. По умолчанию `50`. Установите `0` для немедленной записи. Claude Code ограничивает ожидание `5000`. Требует Claude Code версии 2.1.233 или позже |208| `CLAUDE_AX_PREPARK_MS` | В [режиме чтения с экрана](/docs/ru/accessibility#what-your-screen-reader-hears) сколько миллисекунд Claude Code ждет, с курсором в начале строки, перед тем как написать новую или измененную строку. По умолчанию `50`. Установите `0` для немедленной записи. Claude Code ограничивает ожидание `5000`. Требует Claude Code версии 2.1.233 или позже |

209| `CLAUDE_AX_SCREEN_READER` | Установите `1` для отображения вывода, удобного для чтения с экрана: плоский текст без декоративных границ или анимаций. Установите `0` для принудительного отключения режима чтения с экрана даже когда [`axScreenReader`](/docs/ru/settings-reference#axscreenreader) имеет значение `true`. Флаг [`--ax-screen-reader`](/docs/ru/cli-reference#cli-flags) имеет приоритет. Требует Claude Code версии 2.1.181 или позже |209| `CLAUDE_AX_SCREEN_READER` | Установите `1` для отображения вывода, удобного для чтения с экрана: плоский текст без декоративных границ или анимаций. Установите `0` для принудительного отключения режима чтения с экрана даже при `axScreenReader` [`true`](/docs/ru/settings-reference#axscreenreader). Флаг [`--ax-screen-reader`](/docs/ru/cli-reference#cli-flags) имеет приоритет. Требует Claude Code версии 2.1.181 или позже |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | В [режиме чтения с экрана](/docs/ru/accessibility) сколько миллисекунд Claude Code удерживает первый рендер интерфейса после строки подтверждения запуска, чтобы ваш чтец с экрана мог полностью произнести строку перед тем как новый вывод прерывает его. По умолчанию `3000`. Установите `0` для немедленного рендера. Claude Code ограничивает удержание `600000` (10 минут). Ваше первое нажатие клавиши завершает удержание раньше. Требует Claude Code версии 2.1.217 или позже |210| `CLAUDE_AX_STARTUP_QUIET_MS` | В [режиме чтения с экрана](/docs/ru/accessibility) сколько миллисекунд Claude Code удерживает первый рендер интерфейса после строки подтверждения запуска, чтобы ваш чтец с экрана мог полностью произнести строку перед тем, как новый вывод прервет ее. По умолчанию `3000`. Установите `0` для немедленного рендеринга. Claude Code ограничивает удержание `600000` (10 минут). Ваше первое нажатие клавиши завершает удержание раньше. Требует Claude Code версии 2.1.217 или позже |

211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Вернуться в исходный рабочий каталог после каждой команды Bash или PowerShell в основном сеансе |211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Вернуться в исходный рабочий каталог после каждой команды Bash или PowerShell в основном сеансе |

212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Таймаут в миллисекундах для сторожевого таймера потока на уровне байтов; при установке он имеет приоритет над `CLAUDE_STREAM_IDLE_TIMEOUT_MS` для этого сторожевого таймера и оставляет сторожевой таймер на уровне событий без изменений. Claude Code ограничивает эту переменную между 10 секундами и 30 минутами. Требует Claude Code версии 2.1.210 или позже |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Таймаут в миллисекундах для сторожевого таймера потока на уровне байтов; при установке он имеет приоритет над `CLAUDE_STREAM_IDLE_TIMEOUT_MS` для этого сторожевого таймера и оставляет сторожевой таймер на уровне событий без изменений. Claude Code зажимает эту переменную между 10 секундами и 30 минутами. Требует Claude Code версии 2.1.210 или позже |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | Путь к файлу, который внешний инструмент, такой как слушатель блокировки экрана, создает при разблокировке экрана и удаляет при его блокировке. Пока файл существует, Claude Code пропускает [мобильные push-уведомления Remote Control](/docs/ru/remote-control#mobile-push-notifications), поэтому вы перестаете получать push-уведомления, пока активно используете компьютер. Когда файл отсутствует или нечитаем, уведомления отправляются как обычно. Claude Code проверяет файл один раз за событие, вызывающее push-уведомление, а не опрашивает его. Требует Claude Code версии 2.1.181 или позже |213| `CLAUDE_CLIENT_PRESENCE_FILE` | Путь к файлу, который внешний инструмент, такой как слушатель блокировки экрана, создает при разблокировке экрана и удаляет при его блокировке. Пока файл существует, Claude Code пропускает [мобильные push-уведомления Remote Control](/docs/ru/remote-control#mobile-push-notifications), поэтому вы перестаете получать push-уведомления при активном использовании компьютера. Когда файл отсутствует или нечитаем, уведомления отправляются как обычно. Claude Code проверяет файл один раз за событие, вызывающее push-уведомление, а не опрашивает его. Требует Claude Code версии 2.1.181 или позже |

214| `CLAUDE_CODE_ACCESSIBILITY` | Установите `1` для сохранения видимого курсора собственного терминала и отключения индикатора курсора с инвертированным текстом. Позволяет увеличителям экрана, таким как macOS Zoom, отслеживать положение курсора |214| `CLAUDE_CODE_ACCESSIBILITY` | Установите `1` для сохранения видимого курсора собственного терминала и отключения индикатора курсора с инвертированным текстом. Позволяет увеличителям экрана, таким как macOS Zoom, отслеживать положение курсора |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Установите `1` для загрузки файлов памяти из каталогов, указанных с `--add-dir`. Загружает `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` и `CLAUDE.local.md`. По умолчанию дополнительные каталоги не загружают файлы памяти |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Установите `1` для загрузки файлов памяти из каталогов, указанных с помощью `--add-dir`. Загружает `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` и `CLAUDE.local.md`. По умолчанию дополнительные каталоги не загружают файлы памяти |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Установите `1` для перерисовки всего экрана при каждом кадре в [полноэкранном рендере](/docs/ru/fullscreen) вместо отправки добавочных обновлений. Используйте это, если полноэкранный режим показывает устаревшие или неправильно размещенные фрагменты текста. Claude Code включает это автоматически для фоновых сеансов и [представления агента](/docs/ru/agent-view) на Windows |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Установите `1` для перерисовки всего экрана на каждом кадре в [полноэкранном рендеринге](/docs/ru/fullscreen) вместо отправки добавочных обновлений. Используйте это, если полноэкранный режим показывает устаревшие или неправильно размещенные фрагменты текста. Claude Code включает это автоматически для фоновых сеансов и [представления агента](/docs/ru/agent-view) на Windows |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Установите `1` для отправки параметра [effort](/docs/ru/model-config#adjust-effort-level) при каждом запросе, даже когда Claude Code не распознает ID модели как поддерживающий effort. Используйте это при маршрутизации через [LLM gateway](/docs/ru/llm-gateway) или сторонний поставщик, который обслуживает модели под пользовательскими идентификаторами. Модели, которые отклоняют параметр effort в API, включая модели Claude 3, Sonnet 4.0 и 4.5, Opus 4.0 и 4.1 и Haiku 4.5, по-прежнему исключены, чтобы запросы не завершались с ошибкой |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Установите `1` для отправки параметра [effort](/docs/ru/model-config#adjust-effort-level) с каждым запросом, даже когда Claude Code не распознает ID модели как поддерживающий effort. Используйте это при маршрутизации через [LLM gateway](/docs/ru/llm-gateway) или сторонний поставщик, который обслуживает модели под пользовательскими идентификаторами. Модели, которые отклоняют параметр effort в API, включая модели Claude 3, Sonnet 4.0 и 4.5, Opus 4.0 и 4.1 и Haiku 4.5, по-прежнему исключены, чтобы запросы не завершались с ошибкой |

218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Интервал в миллисекундах, при котором учетные данные должны быть обновлены (при использовании [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper)) |218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Интервал в миллисекундах, при котором учетные данные должны быть обновлены (при использовании [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper)) |

219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Установите `0` для остановки автоматического открытия браузера Claude Code при публикации нового [артефакта](/docs/ru/artifacts#create-an-artifact) |219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Установите `0` для остановки Claude Code от автоматического открытия браузера при публикации нового [artifact](/docs/ru/artifacts#create-an-artifact) |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Установите `0` для остановки чтения Claude и ответа на [комментарии к артефакту](/docs/ru/artifacts#collect-comments-on-an-artifact). Не имеет эффекта, когда `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` [отключил артефакты](/docs/ru/artifacts#availability). Требует Claude Code версии 2.1.221 или позже |220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Установите `0` для остановки чтения Claude и ответа на [комментарии к artifact](/docs/ru/artifacts#collect-comments-on-an-artifact). Не имеет эффекта, когда `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` [отключил artifacts](/docs/ru/artifacts#availability). Требует Claude Code версии 2.1.221 или позже |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Установите `0` для остановки [самостоятельного ответа Claude на комментарии, отправленные ему](/docs/ru/artifacts#let-claude-reply-to-comments-on-its-own). Требует Claude Code версии 2.1.228 или позже |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Установите `0` для остановки Claude [самостоятельного ответа на комментарии, отправленные ему](/docs/ru/artifacts#let-claude-reply-to-comments-on-its-own). Требует Claude Code версии 2.1.228 или позже |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Установите `0` для пропуска [блока атрибуции](/docs/ru/llm-gateway-protocol#system-prompt-attribution-block), который содержит версию клиента и отпечаток подсказки, из начала системной подсказки. Кэширование при прямом подключении к API Anthropic не затронуто в любом случае. В некоторых прямых конфигурациях подключения Claude Code сохраняет блок в запросах классификатора [режима авто](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) даже при установке `0`. В [Блок атрибуции системной подсказки](/docs/ru/llm-gateway-protocol#system-prompt-attribution-block) проверьте, какие подключения и учетные данные это охватывает. До версии 2.1.181 блок включал токен для каждого запроса на пользовательские базовые URL и подключения Microsoft Foundry, поэтому на этих версиях установите его на `0`, когда ваш LLM gateway кэширует на теле запроса или пересылает запросы сторонним поставщикам, или когда вы подключаетесь к Microsoft Foundry напрямую |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Установите `0` для пропуска [блока атрибуции](/docs/ru/llm-gateway-protocol#system-prompt-attribution-block), который содержит версию клиента и отпечаток подсказки, с начала системной подсказки. Кэширование при прямом подключении к API Anthropic не затронуто в любом случае. В некоторых прямых конфигурациях подключения Claude Code сохраняет блок в запросах классификатора [режима auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) даже при установке `0`. В [Блок атрибуции системной подсказки](/docs/ru/llm-gateway-protocol#system-prompt-attribution-block) проверьте, какие подключения и учетные данные это охватывает. До версии 2.1.181 блок включал токен для каждого запроса на пользовательские базовые URL и подключения Microsoft Foundry, поэтому на этих версиях установите его на `0`, когда ваш LLM gateway кэширует на теле запроса или пересылает запросы сторонним поставщикам, или когда вы подключаетесь к Microsoft Foundry напрямую |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Когда `CLAUDE_AUTO_BACKGROUND_TASKS` включен, секунды между напоминаниями Claude проверить [фоновые подагенты](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), которые все еще работают. Принимает простое целое число от `1` до `86400` только; любое другое значение или написание читается как не установленное. Если не установлено, напоминаний о проверке нет. Требует Claude Code версии 2.1.248 или позже |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Когда `CLAUDE_AUTO_BACKGROUND_TASKS` включен, секунды между напоминаниями Claude проверить [фоновые subagents](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), которые все еще работают. Принимает простое целое число от `1` до `86400` только; любое другое значение или написание читается как неустановленное. Если не установлено, напоминаний о проверке нет. Требует Claude Code версии 2.1.248 или позже |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Установить [окно автокомпактирования](/docs/ru/model-config#set-the-auto-compact-window) в токенах, от `100000` до `1000000`. Принимает простое целое число, такое как `500000` только: значение, такое как `500k`, читается как `500` и ограничивается минимумом 100K. Эффективное окно также ограничено окном контекста модели. Имеет приоритет над командой `/autocompact`, флагом `--autocompact` и параметром `autoCompactWindow`. Строка состояния `used_percentage` всегда измеряется против полного окна контекста модели, поэтому после установки этой переменной этот процент больше не указывает, когда будет запущено компактирование |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Установить [окно автокомпактирования](/docs/ru/model-config#set-the-auto-compact-window) в токенах, от `100000` до `1000000`. Принимает простое целое число, такое как `500000` только: значение, такое как `500k`, читается как `500` и зажимается до минимума 100K. Эффективное окно также ограничено окном контекста модели. Имеет приоритет над командой `/autocompact`, флагом `--autocompact` и параметром `autoCompactWindow`. Процент `used_percentage` в строке состояния всегда измеряется относительно полного окна контекста модели, поэтому после установки этой переменной этот процент больше не указывает, когда будет запущено компактирование |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Переопределить автоматическое [подключение IDE](/docs/ru/vs-code). По умолчанию Claude Code подключается автоматически при запуске внутри интегрированного терминала поддерживаемой IDE. Установите `false` для предотвращения этого. Установите `true` для принудительной попытки подключения, когда автоопределение не работает, например когда tmux скрывает родительский терминал. Имеет приоритет над глобальным параметром конфигурации [`autoConnectIde`](/docs/ru/settings-reference#autoconnectide) |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Переопределить автоматическое [подключение IDE](/docs/ru/vs-code). По умолчанию Claude Code подключается автоматически при запуске внутри интегрированного терминала поддерживаемой IDE. Установите `false` для предотвращения этого. Установите `true` для принудительной попытки подключения, когда автоопределение не работает, например, когда tmux скрывает родительский терминал. Имеет приоритет над глобальным параметром конфигурации [`autoConnectIde`](/docs/ru/settings-reference#autoconnectide) |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry установите `1` для того, чтобы классификатор на стороне сервера платформы проверил действия [режима авто](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode); где платформа не запускает классификатор, Claude Code возвращается к своим собственным запросам классификатора. Если не установлено или `0`, классификатор работает через запросы, которые отправляет сам Claude Code. Не имеет эффекта на других поставщиков, включая API Anthropic. Требует Claude Code версии 2.1.271 или позже |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Контролирует, просит ли Claude Code сервер [проверить действия режима auto](/docs/ru/permission-modes#server-side-classifier-review). Если не установлено, Claude Code просит сервер на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform on AWS, и когда вы указываете `ANTHROPIC_BASE_URL` на LLM gateway или прокси. Установите `0` для использования собственных запросов классификатора Claude Code вместо этого. Не читается при прямом подключении к API Anthropic. Требует Claude Code версии 2.1.271 или позже; запрос сервера по умолчанию требует версии 2.1.278 или позже |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Время в миллисекундах, которое Claude Code ждет, пока цепочка поставщика учетных данных AWS по умолчанию выдаст учетные данные перед тем как запрос завершится с [`AWS default-chain credential resolve timed out`](/docs/ru/errors#aws-default-chain-credential-resolve-timed-out) (по умолчанию: `60000`). Повысьте это, когда шаг в вашей цепочке законно нуждается в большем времени, например вход на основе браузера через обертку, такую как `aws-vault`. Применяется везде, где Claude Code подписывает с цепочкой по умолчанию: [Amazon Bedrock](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и [конечная точка Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Требует Claude Code версии 2.1.207 или позже |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Время в миллисекундах, которое Claude Code ждет, пока цепочка поставщика учетных данных AWS по умолчанию выдаст учетные данные, прежде чем запрос завершится с ошибкой [`AWS default-chain credential resolve timed out`](/docs/ru/errors#aws-default-chain-credential-resolve-timed-out) (по умолчанию: `60000`). Повысьте это, когда шаг в вашей цепочке законно требует больше времени, например вход на основе браузера через обертку, такую как `aws-vault`. Применяется везде, где Claude Code подписывает с помощью цепочки по умолчанию: [Amazon Bedrock](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и [конечная точка Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Требует Claude Code версии 2.1.207 или позже |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Установите `0` для отключения [diff файлов, которые изменила команда Bash](/docs/ru/hooks#bash), или `1` для его записи в каждом режиме разрешений. Имеет приоритет над параметром [`bashEditDiffEnabled`](/docs/ru/settings-reference#basheditdiffenabled). Требует Claude Code версии 2.1.269 или позже |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Установите `0` для отключения [diff файлов, которые изменила команда Bash](/docs/ru/hooks#bash), или `1` для его записи в каждом режиме разрешений. Имеет приоритет над параметром [`bashEditDiffEnabled`](/docs/ru/settings-reference#basheditdiffenabled). Требует Claude Code версии 2.1.269 или позже |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Установите `0` для того, чтобы неинтерактивный сеанс сообщал статус простоя своему хосту при каждом завершении хода, даже если фоновая работа все еще выполняется. По умолчанию сеанс продолжает сообщать статус выполнения после завершения хода, пока фоновая работа, такая как фоновый агент или запуск [workflow](/docs/ru/workflows), все еще активна. Это предотвращает объявление хостом, который наблюдает статус, такой как список удаленных сеансов, что Claude ждет вашего ввода во время работы. Фоновые команды оболочки, такие как сервер разработки, не удерживают статус выполнения. Статус выполнения по умолчанию и отказ от `0` требуют Claude Code версии 2.1.269 или позже; на более ранних версиях установите `1` для удержания статуса выполнения |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Установите `0` для того, чтобы неинтерактивный сеанс сообщал статус простоя своему хосту в конце каждого хода, даже если фоновая работа все еще выполняется. По умолчанию сеанс продолжает сообщать статус выполнения после конца хода, пока фоновая работа, такая как фоновый агент или [workflow](/docs/ru/workflows), все еще активна. Это предотвращает объявление хостом, который наблюдает статус, такой как список удаленных сеансов, что Claude ждет вашего ввода во время работы. Фоновые команды оболочки, такие как сервер разработки, не удерживают статус выполнения. Статус выполнения по умолчанию и отказ от `0` требуют Claude Code версии 2.1.269 или позже; на более ранних версиях установите `1` для удержания статуса выполнения |

230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Установите автоматически в подпроцессах инструмента Bash и [команде hook](/docs/ru/hooks) пока сеанс имеет активное подключение [Remote Control](/docs/ru/remote-control), и удалено при завершении подключения. Значение — это ID сеанса в форме `session_`, тот же идентификатор, который появляется в URL `claude.ai/code` сеанса, поэтому скрипт может ссылаться обратно на сеанс, который его запустил. Требует Claude Code версии 2.1.199 или позже. В [облачных сеансах](/docs/ru/claude-code-on-the-web) вместо этого читайте `CLAUDE_CODE_REMOTE_SESSION_ID` |230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Установите автоматически в подпроцессах инструмента Bash и [hook command](/docs/ru/hooks) пока сеанс имеет активное подключение [Remote Control](/docs/ru/remote-control), и удалено при завершении подключения. Значение — это ID сеанса в форме `session_`, тот же идентификатор, который появляется в URL `claude.ai/code` сеанса, поэтому скрипт может ссылаться обратно на сеанс, который его запустил. Требует Claude Code версии 2.1.199 или позже. В [облачных сеансах](/docs/ru/claude-code-on-the-web) читайте `CLAUDE_CODE_REMOTE_SESSION_ID` вместо этого |

231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Установите `0` для чтения Claude Code байта `0x08`, также написанного `^H`, как простой Backspace, или `1` для чтения его как Ctrl+Backspace. Любое значение заменяет платформу по умолчанию. По умолчанию Claude Code читает его как Ctrl+Backspace на Windows, за исключением случаев, когда `TERM_PROGRAM` — это `mintty` или `TERM` — это `cygwin`, и как простой Backspace на macOS и Linux. Установите `0` в терминале Windows, где [Backspace удаляет целое слово](/docs/ru/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Установите `0` для чтения Claude Code байта `0x08`, также написанного `^H`, как простой Backspace, или `1` для чтения его как Ctrl+Backspace. Любое значение заменяет платформу по умолчанию. По умолчанию Claude Code читает его как Ctrl+Backspace на Windows, за исключением случаев, когда `TERM_PROGRAM` — это `mintty` или `TERM` — это `cygwin`, и как простой Backspace на macOS и Linux. Установите `0` в терминале Windows, где [Backspace удаляет целое слово](/docs/ru/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |

232| `CLAUDE_CODE_CERT_STORE` | Разделенный запятыми список источников сертификатов CA для TLS подключений. `bundled` — это набор Mozilla CA, поставляемый с Claude Code. `system` — это хранилище доверия операционной системы, читается только на рантаймах с `tls.getCACertificates`: собственный двоичный файл или Node 22.15 или позже для установок npm. См. [Хранилище сертификатов CA](/docs/ru/network-config#ca-certificate-store). По умолчанию `bundled,system` |232| `CLAUDE_CODE_CERT_STORE` | Разделенный запятыми список источников сертификатов CA для подключений TLS. `bundled` — это набор Mozilla CA, поставляемый с Claude Code. `system` — это хранилище доверия операционной системы, читается только на рунтаймах с `tls.getCACertificates`: собственный двоичный файл или Node 22.15 или позже для установок npm. См. [Хранилище сертификатов CA](/docs/ru/network-config#ca-certificate-store). По умолчанию `bundled,system` |

233| `CLAUDE_CODE_CHILD_SESSION` | Установите `1` в подпроцессах, которые Claude Code порождает через инструменты Bash, PowerShell и Monitor, команды [hook](/docs/ru/hooks) и команды [строки состояния](/docs/ru/statusline). Не установлено для подпроцессов [MCP сервера](/docs/ru/mcp) stdio, которые долгоживущие и пережидают сеанс, который их порождает. В отличие от `CLAUDECODE`, это устанавливается только самим Claude Code при запуске подпроцесса, а не расширениями IDE, поэтому надежно отличает вложенный сеанс от верхнего уровня `claude`, запущенного в интегрированном терминале IDE. Вложенный интерактивный TUI `claude`, запущенный таким образом, автоматически исключается из `--resume`, `--continue`, истории стрелки вверх и списка `claude agents`. Неинтерактивные сеансы `claude -p` по-прежнему сохраняются. Установите `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` для переопределения этого исключения. Требует Claude Code версии 2.1.172 или позже |233| `CLAUDE_CODE_CHILD_SESSION` | Установите `1` в подпроцессах, которые Claude Code порождает через инструменты Bash, PowerShell и Monitor, [hook](/docs/ru/hooks) команды и [status line](/docs/ru/statusline) команды. Не установлено для подпроцессов [MCP server](/docs/ru/mcp) stdio, которые долгоживущие и пережидают сеанс, который их порождает. В отличие от `CLAUDECODE`, это устанавливается только самим Claude Code при запуске подпроцесса, а не расширениями IDE, поэтому надежно отличает вложенный сеанс от верхнего уровня `claude`, запущенного в интегрированном терминале IDE. Вложенный интерактивный `claude` TUI, запущенный таким образом, автоматически исключается из `--resume`, `--continue`, истории стрелок вверх и списка `claude agents`. Неинтерактивные сеансы `claude -p` по-прежнему сохраняются. Установите `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` для переопределения этого исключения. Требует Claude Code версии 2.1.172 или позже |

234| `CLAUDE_CODE_CLIENT_CERT` | Путь к файлу сертификата клиента для аутентификации mTLS |234| `CLAUDE_CODE_CLIENT_CERT` | Путь к файлу сертификата клиента для аутентификации mTLS |

235| `CLAUDE_CODE_CLIENT_KEY` | Путь к файлу приватного ключа клиента для аутентификации mTLS |235| `CLAUDE_CODE_CLIENT_KEY` | Путь к файлу приватного ключа клиента для аутентификации mTLS |

236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Парольная фраза для зашифрованного CLAUDE\_CODE\_CLIENT\_KEY (опционально) |236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Парольная фраза для зашифрованного CLAUDE\_CODE\_CLIENT\_KEY (опционально) |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Удалено в версии 2.1.186 и теперь не работает. Ранее устанавливало отдельный таймаут для фазы подключения, TLS и заголовка ответа потокового запроса API. Используйте `API_TIMEOUT_MS` для таймаута для каждого запроса. Для фазы заголовка ответа потокового запроса см. `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Удалено в версии 2.1.186 и теперь не работает. Ранее устанавливало отдельный таймаут для фазы подключения, TLS и заголовка ответа потокового запроса API. Используйте `API_TIMEOUT_MS` для таймаута для каждого запроса. Для фазы заголовка ответа потокового запроса см. `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Переопределить путь файла журнала отладки. Несмотря на имя, это путь к файлу, а не каталог. Требует отдельного включения режима отладки через `--debug`, `/debug` или переменную окружения `DEBUG`: установка только этой переменной не включает логирование. Флаг [`--debug-file`](/docs/ru/cli-reference#cli-flags) делает оба сразу. По умолчанию `~/.claude/debug/<session-id>.txt` |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Переопределить путь файла журнала отладки. Несмотря на имя, это путь к файлу, а не каталог. Требует отдельного включения режима отладки через `--debug`, `/debug` или переменную окружения `DEBUG`: установка только этой переменной не включает логирование. Флаг [`--debug-file`](/docs/ru/cli-reference#cli-flags) делает оба сразу. По умолчанию `~/.claude/debug/<session-id>.txt` |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Минимальный уровень логирования, записываемый в файл журнала отладки. Значения: `verbose`, `debug` (по умолчанию), `info`, `warn`, `error`. Установите `verbose` для включения высокообъемной диагностики, такой как полный вывод команды строки состояния, или повысьте до `error` для уменьшения шума |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Минимальный уровень логирования, записываемый в файл журнала отладки. Значения: `verbose`, `debug` (по умолчанию), `info`, `warn`, `error`. Установите `verbose` для включения высокообъемной диагностики, такой как полный вывод команды строки состояния, или повысьте до `error` для уменьшения шума |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Установите `1` для отключения поддержки [окна контекста 1M](/docs/ru/model-config#extended-context). Если установлено, варианты модели 1M недоступны в средстве выбора модели, и Claude Code удерживает сеансы на моделях с собственным окном 1M, таких как [Sonnet 5](/docs/ru/model-config#sonnet-5-context-window) и модели Fable, на окне 200K; см. [Расширенный контекст](/docs/ru/model-config#extended-context) для того, как применяется удержание. Полезно для корпоративных сред с требованиями соответствия. Для его роли в исправлении окна для неузнанного ID модели `[1m]` см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Установите `1` для отключения поддержки [окна контекста 1M](/docs/ru/model-config#extended-context). Если установлено, варианты модели 1M недоступны в средстве выбора модели, и Claude Code удерживает сеансы на моделях с собственным окном 1M, таких как [Sonnet 5](/docs/ru/model-config#sonnet-5-context-window) и модели Fable, до окна 200K; см. [Расширенный контекст](/docs/ru/model-config#extended-context) для того, как применяется удержание. Полезно для корпоративных сред с требованиями соответствия. Для его роли в исправлении окна для неузнанного ID модели `[1m]` см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Установите `1` для отключения [адаптивного рассуждения](/docs/ru/model-config#adjust-effort-level) на Opus 4.6 и Sonnet 4.6 и возврата к фиксированному бюджету мышления, контролируемому `MAX_THINKING_TOKENS`. Не имеет эффекта на [модели Fable](/docs/ru/model-config#extended-thinking), Sonnet 5 или Opus 4.7 и позже, которые всегда используют адаптивное рассуждение |241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Установите `1` для отключения [адаптивного рассуждения](/docs/ru/model-config#adjust-effort-level) на Opus 4.6 и Sonnet 4.6 и возврата к фиксированному бюджету мышления, контролируемому `MAX_THINKING_TOKENS`. Не имеет эффекта на [модели Fable](/docs/ru/model-config#extended-thinking), Sonnet 5 или Opus 4.7 и позже, которые всегда используют адаптивное рассуждение |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Установите `1` для остановки Claude Code от объединения [управляемых параметров](/docs/ru/managed-settings#precedence-within-the-managed-tier) блоков `env` для каждого ключа между источниками администратора, поэтому применяется только весь блок `env` источника с наивысшим приоритетом, как до версии 2.1.223. Установите это в окружении, которое запускает Claude Code, так как Claude Code игнорирует копию, доставленную через блок параметров `env`. Требует Claude Code версии 2.1.223 или позже |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Установите `1` для остановки Claude Code от объединения [управляемых параметров](/docs/ru/managed-settings#precedence-within-the-managed-tier) блоков `env` для каждого ключа по источникам администратора, поэтому применяется только весь блок `env` источника с наивысшим приоритетом, как до версии 2.1.223. Установите его в окружении, которое запускает Claude Code, так как Claude Code игнорирует копию, доставленную через блок параметров `env`. Требует Claude Code версии 2.1.223 или позже |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Установите `1` для отключения [инструмента советника](/docs/ru/advisor). Команда `/advisor` становится недоступной, любой настроенный `advisorModel` игнорируется, и флаг `--advisor` принимается, но не имеет эффекта, поэтому существующие скрипты, которые его передают, продолжают работать без ошибок |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Установите `1` для отключения [инструмента advisor](/docs/ru/advisor). Команда `/advisor` становится недоступной, любой настроенный `advisorModel` игнорируется, и флаг `--advisor` принимается, но не имеет эффекта, поэтому существующие скрипты, которые его передают, продолжают работать без ошибок |

244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Установите `1` для отключения [фоновых агентов и представления агента](/docs/ru/agent-view): `claude agents`, `--bg`, `/background` и супервизор по требованию. Эквивалентно параметру [`disableAgentView`](/docs/ru/settings-reference#disableagentview) |244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Установите `1` для отключения [фоновых агентов и представления агента](/docs/ru/agent-view): `claude agents`, `--bg`, `/background` и супервизор по требованию. Эквивалентно параметру [`disableAgentView`](/docs/ru/settings-reference#disableagentview) |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Установите `1` для отключения [полноэкранного рендера](/docs/ru/fullscreen) и использования классического рендера основного экрана. Разговор остается в собственной прокрутке вашего терминала, поэтому `Cmd+f` и режим копирования tmux работают как обычно. Имеет приоритет над `CLAUDE_CODE_NO_FLICKER` и параметром [`tui`](/docs/ru/settings-reference#tui). Вы также можете переключаться с `/tui default`. Не применяется к фоновым сеансам, открытым из [представления агента](/docs/ru/agent-view), которые всегда используют полноэкранный рендер |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Установите `1` для отключения [полноэкранного рендеринга](/docs/ru/fullscreen) и использования классического рендерера основного экрана. Разговор остается в собственной прокрутке терминала, поэтому `Cmd+f` и режим копирования tmux работают как обычно. Имеет приоритет над `CLAUDE_CODE_NO_FLICKER` и параметром [`tui`](/docs/ru/settings-reference#tui). Вы также можете переключаться с помощью `/tui default`. Не применяется к фоновым сеансам, открытым из [представления агента](/docs/ru/agent-view), которые всегда используют полноэкранный рендеринг |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Установите `1` для отключения инструмента [Artifact](/docs/ru/artifacts), который публикует вывод сеанса как приватную веб-страницу на claude.ai. После установки этого параметра ни один файл параметров не включает инструмент обратно. Чтобы отключить инструмент из файла параметров, установите [`enableArtifact`](/docs/ru/settings-reference#enableartifact) на `false`; устаревший ключ [`disableArtifact`](/docs/ru/settings-reference#disableartifact) также отключает его |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Установите `1` для отключения инструмента [Artifact](/docs/ru/artifacts), который публикует вывод сеанса как приватную веб-страницу на claude.ai. После установки этого параметра ни один файл параметров не включает инструмент обратно. Чтобы отключить инструмент из файла параметров, установите [`enableArtifact`](/docs/ru/settings-reference#enableartifact) на `false`; устаревший ключ [`disableArtifact`](/docs/ru/settings-reference#disableartifact) также отключает его |

247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Установите `1` для отключения обработки вложений. Упоминания файлов с синтаксисом `@` отправляются как простой текст вместо расширения в содержимое файла |247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Установите `1` для отключения обработки вложений. Упоминания файлов с синтаксисом `@` отправляются как простой текст вместо расширения в содержимое файла |

248| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Установите `1` для отключения [автоматической памяти](/docs/ru/memory#auto-memory). Установите `0` для принудительного включения автоматической памяти даже когда режим `--bare` или [`autoMemoryEnabled: false`](/docs/ru/settings-reference#automemoryenabled) в противном случае отключили бы его. Если отключено, Claude не создает и не загружает файлы автоматической памяти |248| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Установите `1` для отключения [автоматической памяти](/docs/ru/memory#auto-memory). Установите `0` для принудительного включения автоматической памяти даже при режиме `--bare` или [`autoMemoryEnabled: false`](/docs/ru/settings-reference#automemoryenabled) иначе отключили бы его. Если отключено, Claude не создает и не загружает файлы автоматической памяти |

249| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Установите `1` для отключения всей функциональности фоновых задач, включая параметр `run_in_background` на инструментах Bash и подагента, автоматическое фоновое выполнение и сочетание клавиш Ctrl+B |249| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Установите `1` для отключения всей функциональности фоновых задач, включая параметр `run_in_background` на инструментах Bash и subagent, автоматическое фоновое выполнение и сочетание клавиш Ctrl+B |

250| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Установите `1` для остановки Claude Code от обработки потокового ответа [Amazon Bedrock](/docs/ru/amazon-bedrock) с отсутствующим или пустым заголовком `Content-Type` как двоичного потока событий Amazon Bedrock. По умолчанию Claude Code предполагает, что шлюз удалил заголовок из иначе неизмененного ответа, поэтому он декодирует тело и потоковая передача продолжает работать. Установите это только для шлюза, который также повторно выдает поток как события, отправляемые сервером; Claude Code затем читает тело без заголовка как события, отправляемые сервером, вместо этого. Требует Claude Code версии 2.1.239 или позже |250| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Установите `1` для остановки Claude Code от обработки потокового ответа [Amazon Bedrock](/docs/ru/amazon-bedrock) с отсутствующим или пустым заголовком `Content-Type` как двоичного потока событий Amazon Bedrock. По умолчанию Claude Code предполагает, что шлюз удалил заголовок из иначе неизмененного ответа, поэтому он декодирует тело и потоковая передача продолжает работать. Установите это только для шлюза, который также повторно выдает поток как события, отправляемые сервером; Claude Code затем читает тело без заголовка как события, отправляемые сервером, вместо этого. Требует Claude Code версии 2.1.239 или позже |

251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Установите `1` для пропуска проверки того, что потоковый ответ [Amazon Bedrock](/docs/ru/amazon-bedrock) имеет тип содержимого `application/vnd.amazon.eventstream`. Без этой переменной, когда ответ имеет другой тип содержимого, Claude Code завершает запрос с ошибкой, называя этот тип, что означает [шлюз или прокси преобразует ответ](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Настройте шлюз для пересылки заголовка `Content-Type` и тела без изменений, а не устанавливайте эту переменную. Требует Claude Code версии 2.1.208 или позже |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Установите `1` для пропуска проверки того, что потоковый ответ [Amazon Bedrock](/docs/ru/amazon-bedrock) имеет тип содержимого `application/vnd.amazon.eventstream`. Без этой переменной, когда ответ имеет другой тип содержимого, Claude Code завершает запрос с ошибкой, называя этот тип, что означает [шлюз или прокси преобразует ответ](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Настройте шлюз для пересылки заголовка `Content-Type` и тела без изменений, а не устанавливайте эту переменную. Требует Claude Code версии 2.1.208 или позже |

252| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Установите `1` для остановки выполняющихся фоновых команд оболочки [фонового сеанса](/docs/ru/agent-view), динамических workflows, и, начиная с версии 2.1.198, фоновых подагентов при остановке, перезагрузке или обновлении [супервизором](/docs/ru/agent-view#the-supervisor-process) процесса этого сеанса, вместо передачи их следующему процессу сеанса. Влияет только на эту передачу: фоновое выполнение сеанса с `←` или [`/background`](/docs/ru/agent-view#from-inside-a-session) по-прежнему переносит текущую работу, и `CLAUDE_DISABLE_ADOPT` отключает оба. Требует Claude Code версии 2.1.196 или позже |252| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Установите `1` для остановки [фонового сеанса](/docs/ru/agent-view) запущенных фоновых команд оболочки, динамических workflows, и, начиная с версии 2.1.198, фоновых subagents при остановке, перезагрузке или обновлении [супервизором](/docs/ru/agent-view#the-supervisor-process) процесса этого сеанса, вместо передачи их следующему процессу сеанса. Влияет только на эту передачу: фоновое выполнение сеанса с `←` или [`/background`](/docs/ru/agent-view#from-inside-a-session) по-прежнему переносит текущую работу, и `CLAUDE_DISABLE_ADOPT` отключает оба. Требует Claude Code версии 2.1.196 или позже |

253| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Установите `1` для остановки Claude Code от завершения [фоновых команд оболочки](/docs/ru/interactive-mode#background-bash-commands) при сообщении операционной системой о нехватке памяти. По умолчанию на macOS и Linux Claude Code завершает фоновую оболочку, запущенную в основном сеансе при сигнале нехватки памяти, как только сеанс был неактивен 30 минут и ни один ход или подагент не выполняется. Windows не имеет сигнала нехватки памяти, поэтому эта переменная не имеет эффекта там. Требует Claude Code версии 2.1.193 или позже |253| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Установите `1` для остановки Claude Code от завершения [фоновых команд оболочки](/docs/ru/interactive-mode#background-bash-commands) при сообщении операционной системой о нехватке памяти. По умолчанию на macOS и Linux Claude Code завершает фоновую оболочку, запущенную в основном сеансе при сигнале нехватки памяти, как только сеанс был неактивен в течение 30 минут и ни один ход или subagent не выполняется. Windows не имеет сигнала нехватки памяти, поэтому эта переменная не имеет эффекта там. Требует Claude Code версии 2.1.193 или позже |

254| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Установите `1` для отключения [skills](/docs/ru/skills) и workflows, включенных в Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные команды, такие как `/init`, остаются типируемыми, но скрыты от модели. `/doctor` остается типируемым, как встроенные команды; скройте его с `DISABLE_DOCTOR_COMMAND` вместо этого. Skills из плагинов, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалентно параметру [`disableBundledSkills`](/docs/ru/settings-reference#disablebundledskills) |254| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Установите `1` для отключения [skills](/docs/ru/skills) и workflows, включенных в Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные команды, такие как `/init`, остаются типируемыми, но скрыты от модели. `/doctor` остается типируемым, как встроенные команды; скройте его с помощью `DISABLE_DOCTOR_COMMAND` вместо этого. Skills из плагинов, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалентно параметру [`disableBundledSkills`](/docs/ru/settings-reference#disablebundledskills) |

255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Установите `1` для сохранения доступности инструментов браузера [Claude in Chrome](/docs/ru/chrome) при пропуске раздела Chrome системной подсказки и [встроенного skill](/docs/ru/skills#bundled-skills) `/claude-in-chrome`. Для хостов, которые встраивают Claude Code и предоставляют свое собственное руководство браузера. Требует Claude Code версии 2.1.257 или позже |255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Установите `1` для сохранения доступности инструментов [Claude in Chrome](/docs/ru/chrome) при пропуске раздела Chrome системной подсказки и [bundled skill](/docs/ru/skills#bundled-skills) `/claude-in-chrome`. Для хостов, которые встраивают Claude Code и предоставляют свое собственное руководство браузера. Требует Claude Code версии 2.1.257 или позже |

256| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Установите `1` для предотвращения загрузки любых файлов памяти CLAUDE.md в контекст, включая файлы памяти пользователя, проекта и автоматической памяти |256| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Установите `1` для предотвращения загрузки любых файлов памяти CLAUDE.md в контекст, включая файлы памяти пользователя, проекта и автоматической памяти |

257| `CLAUDE_CODE_DISABLE_CRON` | Установите `1` для отключения [запланированных задач](/docs/ru/scheduled-tasks). Skill `/loop` и инструменты cron становятся недоступными и любые уже запланированные задачи перестают срабатывать, включая задачи, которые уже выполняются в середине сеанса |257| `CLAUDE_CODE_DISABLE_CRON` | Установите `1` для отключения [запланированных задач](/docs/ru/scheduled-tasks). Skill `/loop` и инструменты cron становятся недоступными, и любые уже запланированные задачи перестают срабатывать, включая задачи, которые уже выполняются в середине сеанса |

258| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Установите `1` для удаления заголовков запроса `anthropic-beta`, специфичных для Anthropic, и полей схемы инструмента бета-версии (таких как `defer_loading` и `eager_input_streaming`) из запросов API. Используйте это, когда прокси-шлюз отклоняет запросы с ошибками, такими как "Unexpected value(s) for the `anthropic-beta` header" или "Extra inputs are not permitted". Стандартные поля (`name`, `description`, `input_schema`, `cache_control`) сохраняются. [Поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) отключен и все инструменты MCP загружаются заранее, даже при установке `ENABLE_TOOL_SEARCH`. На Claude Code версии 2.1.227 или позже [управляемые параметры](/docs/ru/managed-settings) могут сохранить поиск инструментов включенным. [Отключить возможности предварительного выпуска](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) охватывает, где применяется переопределение |258| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Установите `1` для удаления заголовков запроса `anthropic-beta`, специфичных для Anthropic, и полей схемы инструмента бета-версии (таких как `defer_loading` и `eager_input_streaming`) из запросов API. Используйте это, когда прокси-шлюз отклоняет запросы с ошибками, такими как "Unexpected value(s) for the `anthropic-beta` header" или "Extra inputs are not permitted". Стандартные поля (`name`, `description`, `input_schema`, `cache_control`) сохраняются. [Поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) отключен и все инструменты MCP загружаются заранее, даже при установке `ENABLE_TOOL_SEARCH`. На Claude Code версии 2.1.227 или позже [управляемые параметры](/docs/ru/managed-settings) могут сохранить поиск инструментов включенным. [Отключить возможности предварительного выпуска](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) охватывает, где применяется переопределение |

259| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Установите `1` для отключения встроенных [подагентов Explore и Plan](/docs/ru/sub-agents#built-in-subagents). Claude исследует с помощью своих инструментов поиска или подагента общего назначения вместо этого, и [режим плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) читает файлы напрямую, а не запускает агентов Explore и Plan. Пользовательские подагенты с именами `Explore` или `Plan` не затронуты. Чтобы удалить каждый встроенный тип подагента в Agent SDK или неинтерактивном режиме, используйте `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` вместо этого. Требует Claude Code версии 2.1.198 или позже |259| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Установите `1` для отключения встроенных [subagents Explore и Plan](/docs/ru/sub-agents#built-in-subagents). Claude исследует с помощью своих инструментов поиска или subagent общего назначения вместо этого, и [режим plan](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) читает файлы напрямую, а не запускает агентов Explore и Plan. Пользовательские subagents с именами `Explore` или `Plan` не затронуты. Чтобы удалить каждый встроенный тип subagent в Agent SDK или неинтерактивном режиме, используйте `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` вместо этого. Требует Claude Code версии 2.1.198 или позже |

260| `CLAUDE_CODE_DISABLE_FAST_MODE` | Установите `1` для отключения [быстрого режима](/docs/ru/fast-mode) |260| `CLAUDE_CODE_DISABLE_FAST_MODE` | Установите `1` для отключения [fast mode](/docs/ru/fast-mode) |

261| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Установите `1` для отключения опросов качества сеанса "How is Claude doing?". Опросы также отключены, когда установлены `DISABLE_TELEMETRY`, `DO_NOT_TRACK` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, если только `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` не включит их обратно. Чтобы установить частоту выборки вместо полного отключения, используйте параметр [`feedbackSurveyRate`](/docs/ru/settings-reference#feedbacksurveyrate). См. [Опросы качества сеанса](/docs/ru/data-usage#session-quality-surveys) |261| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Установите `1` для отключения опросов качества сеанса "How is Claude doing?". Опросы также отключены, когда установлены `DISABLE_TELEMETRY`, `DO_NOT_TRACK` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, если только `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` не включит их обратно. Чтобы установить частоту выборки вместо полного отключения, используйте параметр [`feedbackSurveyRate`](/docs/ru/settings-reference#feedbacksurveyrate). См. [Опросы качества сеанса](/docs/ru/data-usage#session-quality-surveys) |

262| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Установите `1` для отключения файла [checkpointing](/docs/ru/checkpointing). Команда `/rewind` не сможет восстановить изменения кода. Переопределяет параметр [`fileCheckpointingEnabled`](/docs/ru/settings-reference#filecheckpointingenabled) |262| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Установите `1` для отключения файла [checkpointing](/docs/ru/checkpointing). Команда `/rewind` не сможет восстановить изменения кода. Переопределяет параметр [`fileCheckpointingEnabled`](/docs/ru/settings-reference#filecheckpointingenabled) |

263| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Установите `1` для удаления встроенных инструкций рабочего процесса коммита и PR и снимка статуса git из системной подсказки Claude. Полезно при использовании собственных skills рабочего процесса git. Имеет приоритет над параметром [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions) при установке |263| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Установите `1` для удаления встроенных инструкций рабочего процесса commit и PR и снимка статуса git из системной подсказки Claude. Полезно при использовании собственных skills рабочего процесса git. Имеет приоритет над параметром [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions) при установке |

264| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Установите `1` для предотвращения автоматического переназначения Opus 4.0 и 4.1 на текущую версию Opus на API Anthropic. Используйте, когда вы намеренно хотите закрепить более старую модель. Переназначение не выполняется на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry |264| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Установите `1` для предотвращения автоматического переназначения Opus 4.0 и 4.1 на текущую версию Opus на API Anthropic. Используйте, когда вы намеренно хотите закрепить более старую модель. Переназначение не выполняется на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry |

265| `CLAUDE_CODE_DISABLE_MOUSE` | Установите `1` для отключения отслеживания мыши в [полноэкранном рендере](/docs/ru/fullscreen). Прокрутка клавиатуры с `PgUp` и `PgDn` по-прежнему работает. Используйте это для сохранения поведения копирования при выборе вашего терминала |265| `CLAUDE_CODE_DISABLE_MOUSE` | Установите `1` для отключения отслеживания мыши в [полноэкранном рендеринге](/docs/ru/fullscreen). Прокрутка с клавиатуры с помощью `PgUp` и `PgDn` по-прежнему работает. Используйте это для сохранения поведения выделения при копировании собственного терминала |

266| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Установите `1` для отключения обработки щелчков, перетаскивания и наведения в [полноэкранном рендере](/docs/ru/fullscreen) при сохранении прокрутки колеса мыши. Используйте это, когда вы хотите, чтобы прокрутка колеса работала внутри Claude Code, но не хотите, чтобы щелчки позиционировали курсор, расширяли вывод инструмента или открывали ссылки. `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет при установке обоих. Требует Claude Code версии 2.1.195 или позже |266| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Установите `1` для отключения обработки щелчков, перетаскивания и наведения в [полноэкранном рендеринге](/docs/ru/fullscreen) при сохранении прокрутки колеса мыши. Используйте это, когда вы хотите, чтобы прокрутка колеса работала внутри Claude Code, но не хотите, чтобы щелчки позиционировали курсор, расширяли вывод инструмента или открывали ссылки. `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет при установке обоих. Требует Claude Code версии 2.1.195 или позже |

267| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Установите `1` для остановки Claude Code от повторного чтения [сертификата и ключа клиента mTLS](/docs/ru/network-config#mtls-authentication) при отказе запроса API с ошибкой на уровне подключения, такой как сброс подключения или ошибка TLS handshake. С отключенной перезагрузкой Claude Code загружает повернутые файлы только при следующем применении параметров или при следующем запуске. Требует Claude Code версии 2.1.232 или позже |267| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Установите `1` для остановки Claude Code от повторного чтения [сертификата и ключа клиента mTLS](/docs/ru/network-config#mtls-authentication) при завершении запроса API с ошибкой на уровне подключения, такой как сброс подключения или ошибка TLS handshake. С отключенной перезагрузкой Claude Code загружает повернутые файлы только при следующем применении параметров или при следующем запуске. Требует Claude Code версии 2.1.232 или позже |

268| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Установите на любое непустое значение, такое как `1`, для отключения несущественного сетевого трафика: автообновления, телеметрии, отчетов об ошибках, команды `/feedback`, [отзывов, составленных Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), примечаний к выпуску, проверок [значка статуса PR и MR](/docs/ru/interactive-mode#pr-review-status) и проверок доступности, таких как проверка [быстрого режима](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Это также останавливает [фоновые запуски источников команд плагина](/docs/ru/plugin-marketplaces#when-claude-code-re-runs-the-command), которые являются локальными командами, а не сетевым трафиком, потому что они могут вызвать установку зависимостей. **Установка его на `0` или `false` по-прежнему отключает этот трафик**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы разрешить это снова. Также отключает получение флагов функций, что делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, требующие получения флагов функций](#features-that-need-feature-flag-fetching) недоступными. Автоустановка официального рынка плагинов не охватывается; отключите ее с `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Не влияет на [обнаружение модели шлюза](/docs/ru/llm-gateway-connect#add-gateway-models-to-the-model-picker), которое имеет свой собственный opt-in |268| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Установите на любое непустое значение, такое как `1`, для отключения несущественного сетевого трафика: автоматические обновления, телеметрия, отчеты об ошибках, команда `/feedback`, [обратная связь, составленная Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), примечания к выпуску, проверки [значка статуса PR и MR](/docs/ru/interactive-mode#pr-review-status) и проверки доступности, такие как проверка [fast mode](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Это также останавливает [фоновые запуски источников команд плагина](/docs/ru/plugin-marketplaces#when-claude-code-re-runs-the-command), которые являются локальными командами, а не сетевым трафиком, потому что они могут вызвать установку зависимостей. **Установка его на `0` или `false` по-прежнему отключает этот трафик**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы разрешить это снова. Также отключает получение флагов функций, что делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, требующие получения флагов функций](#features-that-need-feature-flag-fetching) недоступными. Автоустановка официального рынка плагинов не охватывается; отключите ее с помощью `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Не влияет на [обнаружение модели шлюза](/docs/ru/llm-gateway-connect#add-gateway-models-to-the-model-picker), которое имеет свой собственный opt-in |

269| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Установите `1` для отключения резервного варианта без потоковой передачи при отказе потокового запроса в середине потока. Ошибки потоковой передачи распространяются на уровень повтора вместо этого. Полезно, когда прокси или шлюз вызывает резервный вариант для создания дублирующегося выполнения инструмента |269| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Установите `1` для отключения резервного варианта без потоковой передачи при сбое потокового запроса в середине потока. Ошибки потоковой передачи распространяются на уровень повтора вместо этого. Полезно, когда прокси или шлюз вызывает резервный вариант для создания дублирующегося выполнения инструмента |

270| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Установите `1` для отправки уведомления рабочего стола инструмента `PushNotification` даже пока вы печатаете в терминале или сосредоточены на нем. По умолчанию инструмент пропускает как уведомление рабочего стола, так и [мобильный push](/docs/ru/remote-control#mobile-push-notifications) при обнаружении недавней активности клавиатуры или фокуса терминала. Эта переменная отключает только эту локальную проверку, поэтому сервер все еще может подавить мобильный push при обнаружении, что вы активны. Требует Claude Code версии 2.1.193 или позже |270| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Установите `1` для отправки уведомления рабочего стола инструмента `PushNotification` даже при вводе текста в терминал или его фокусировке. По умолчанию инструмент пропускает как уведомление рабочего стола, так и [мобильный push](/docs/ru/remote-control#mobile-push-notifications) при обнаружении недавней активности клавиатуры или фокуса терминала. Эта переменная отключает только эту локальную проверку, поэтому сервер все еще может подавить мобильный push при обнаружении вашей активности. Требует Claude Code версии 2.1.193 или позже |

271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Установите `1` для отключения автоматической регистрации официального рынка плагинов. Claude Code читает переменную, когда он собирается зарегистрировать рынок, обычно при первом интерактивном запуске машины. Если переменная установлена в этот момент, Claude Code постоянно пропускает регистрацию. Отмена установки переменной позже не отменяет пропуск. Запустите `claude plugin marketplace add anthropics/claude-plugins-official` для регистрации рынка в любое время |271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Установите `1` для отключения автоматической регистрации официального рынка плагинов. Claude Code читает переменную, когда собирается зарегистрировать рынок, обычно при первом интерактивном запуске машины. Если переменная установлена в этот момент, Claude Code постоянно пропускает регистрацию. Отмена установки переменной позже не отменяет пропуск. Запустите `claude plugin marketplace add anthropics/claude-plugins-official` для регистрации рынка в любое время |

272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Установите `1` для остановки Claude Code от запуска ваших [hooks Notification для неотвеченных запросов разрешений](/docs/ru/hooks#notification) в сеансах, где Claude Code отправляет их обратному вызову `canUseTool` Agent SDK, что является тем, как Claude Desktop и расширение VS Code размещают Claude Code. Не имеет эффекта в сеансах терминала. Требует Claude Code версии 2.1.233 или позже |272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Установите `1` для остановки Claude Code от запуска ваших [`Notification` hooks для неотвеченных запросов разрешений](/docs/ru/hooks#notification) в сеансах, где Claude Code отправляет их обратному вызову `canUseTool` Agent SDK, что является тем, как Claude Desktop и расширение VS Code размещают Claude Code. Не имеет эффекта в сеансах терминала. Требует Claude Code версии 2.1.233 или позже |

273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Установите `1` для пропуска загрузки skills из системного каталога управляемых skills. Полезно для контейнерных или CI сеансов, которые не должны загружать skills, предоставленные оператором |273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Установите `1` для пропуска загрузки skills из системного каталога управляемых skills. Полезно для контейнерных или CI сеансов, которые не должны загружать skills, предоставленные оператором |

274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Установите `1` для отключения автоматических обновлений заголовка терминала на основе контекста разговора. В сеансах Agent SDK и `claude -p` это также пропускает фоновый запрос модели small/fast для создания заголовка сеанса |274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Установите `1` для отключения автоматических обновлений заголовка терминала на основе контекста разговора. В сеансах Agent SDK и `claude -p` это также пропускает фоновый запрос модели small/fast для создания заголовка сеанса |

275| `CLAUDE_CODE_DISABLE_THINKING` | Установите `1` для полного пропуска параметра `thinking` из запросов API. Это опция совместимости для прокси и шлюзов, которые отклоняют параметр. На моделях, которые думают по умолчанию, пропуск параметра означает, что модель все еще может думать. Чтобы явно отключить [расширенное мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) на API Anthropic, используйте `MAX_THINKING_TOKENS=0` вместо этого. Ни одна переменная не отключает мышление на моделях Fable, которые не могут иметь отключенное мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations) `MAX_THINKING_TOKENS=0` аналогично пропускает параметр, поэтому две переменные ведут себя одинаково там |275| `CLAUDE_CODE_DISABLE_THINKING` | Установите `1` для полного пропуска параметра `thinking` из запросов API. Это опция совместимости для прокси и шлюзов, которые отклоняют параметр. На моделях, которые думают по умолчанию, пропуск параметра означает, что модель все еще может думать. Чтобы явно отключить [расширенное мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) на API Anthropic, используйте `MAX_THINKING_TOKENS=0` вместо этого. Ни одна переменная не отключает мышление на моделях Fable, которые не могут иметь отключенное мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations) `MAX_THINKING_TOKENS=0` аналогично пропускает параметр, поэтому две переменные ведут себя одинаково там |

276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Установите `1` для пропуска проактивного [автокомпактирования](/docs/ru/costs#reduce-token-usage) когда Claude Code не распознает ID модели, такой как псевдоним [LLM gateway](/docs/ru/llm-gateway). Без этой переменной Claude Code компактирует при окне контекста, которое он предполагает для ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` может исправить предполагаемое окно вместо этого; см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) для того, когда применяется каждая переменная. Требует Claude Code версии 2.1.223 или позже |276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Установите `1` для пропуска проактивного [автокомпактирования](/docs/ru/costs#reduce-token-usage) когда Claude Code не распознает ID модели, такой как [LLM gateway](/docs/ru/llm-gateway) псевдоним. Без этой переменной Claude Code компактирует в окне контекста, которое он предполагает для ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` может исправить предполагаемое окно вместо этого; см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) для того, когда каждая переменная применяется. Требует Claude Code версии 2.1.223 или позже |

277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Установите `1` для отключения виртуальной прокрутки в [полноэкранном рендере](/docs/ru/fullscreen) и рендера каждого сообщения в стенограмме. Используйте это, если прокрутка в полноэкранном режиме показывает пустые области, где должны появляться сообщения |277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Установите `1` для отключения виртуальной прокрутки в [полноэкранном рендеринге](/docs/ru/fullscreen) и рендеринга каждого сообщения в стенограмме. Используйте это, если прокрутка в полноэкранном режиме показывает пустые области, где должны появляться сообщения |

278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Установите `1` для запуска команд [инструмента PowerShell](/docs/ru/tools-reference#powershell-tool) на Windows напрямую вместо использования средства запуска `cmd.exe`. По умолчанию средство запуска позволяет команде PowerShell [работающей в фоновом режиме](/docs/ru/tools-reference#background-commands) [переносить в процесс следующего сеанса](/docs/ru/agent-view#the-supervisor-process), например при [фоновом выполнении сеанса](/docs/ru/agent-view#from-inside-a-session). Если вы установите переменную, фоновая команда PowerShell останавливается при выходе процесса сеанса. Команды Bash не затронуты. Требует Claude Code версии 2.1.269 или позже |278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Установите `1` для запуска команд [инструмента PowerShell](/docs/ru/tools-reference#powershell-tool) на Windows напрямую вместо использования средства запуска `cmd.exe`. По умолчанию средство запуска позволяет команде PowerShell [работающей в фоновом режиме](/docs/ru/tools-reference#background-commands) [переносить в процесс следующего сеанса](/docs/ru/agent-view#the-supervisor-process), например, когда вы [фоновый сеанс](/docs/ru/agent-view#from-inside-a-session). Если вы установите переменную, фоновая команда PowerShell останавливается при выходе процесса сеанса. Команды Bash не затронуты. Требует Claude Code версии 2.1.269 или позже |

279| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Установите `1` для отключения [workflows](/docs/ru/workflows#turn-workflows-off). Эквивалентно параметру [`disableWorkflows`](/docs/ru/settings-reference#disableworkflows) |279| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Установите `1` для отключения [workflows](/docs/ru/workflows#turn-workflows-off). Эквивалентно параметру [`disableWorkflows`](/docs/ru/settings-reference#disableworkflows) |

280| `CLAUDE_CODE_EFFORT_LEVEL` | Установить уровень усилий для поддерживаемых моделей. Значения: `low`, `medium`, `high`, `xhigh`, `max` или `auto` для использования модели по умолчанию. Доступные уровни зависят от модели. Имеет приоритет над `--effort`, `/effort` и параметрами `modelSettings` и `effortLevel`. Ограничение [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) по-прежнему применяется. См. [Отрегулировать уровень усилий](/docs/ru/model-config#adjust-effort-level) |280| `CLAUDE_CODE_EFFORT_LEVEL` | Установить уровень effort для поддерживаемых моделей. Значения: `low`, `medium`, `high`, `xhigh`, `max` или `auto` для использования значения по умолчанию модели. Доступные уровни зависят от модели. Имеет приоритет над `--effort`, `/effort` и параметрами `modelSettings` и `effortLevel`. Ограничение [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) по-прежнему применяется. См. [Отрегулировать уровень effort](/docs/ru/model-config#adjust-effort-level) |

281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Принято для совместимости со старыми выпусками и не имеет эффекта. Режим авто доступен по умолчанию на каждом поставщике, включая Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансы [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом. В версиях 2.1.158 через 2.1.206 установка этого на `1` была необходима для доступности [режима авто](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) на этих поставщиках |281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Принято для совместимости со старыми выпусками и не имеет эффекта. Режим auto доступен по умолчанию на каждом поставщике, включая Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансы [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом. В версиях 2.1.158 через 2.1.206 установка этого на `1` была необходима для доступности [режима auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) на этих поставщиках |

282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Переопределить доступность [сводки сеанса](/docs/ru/interactive-mode#session-recap). Установите `0` для принудительного отключения сводок независимо от переключателя `/config`. Установите `1` для принудительного включения сводок, когда [`awaySummaryEnabled`](/docs/ru/settings-reference#awaysummaryenabled) имеет значение `false`. Имеет приоритет над параметром и переключателем `/config` |282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Переопределить доступность [сводки сеанса](/docs/ru/interactive-mode#session-recap). Установите `0` для принудительного отключения сводок независимо от переключателя `/config`. Установите `1` для принудительного включения сводок, когда [`awaySummaryEnabled`](/docs/ru/settings-reference#awaysummaryenabled) — это `false`. Имеет приоритет над параметром и переключателем `/config` |

283| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Установите `1` для обновления состояния плагина на границах хода в [неинтерактивном режиме](/docs/ru/headless) после завершения фоновой установки. Отключено по умолчанию, потому что обновление изменяет системную подсказку в середине сеанса, что делает [кэширование подсказок](/docs/ru/prompt-caching) недействительным для этого хода |283| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Установите `1` для обновления состояния плагина на границах хода в [неинтерактивном режиме](/docs/ru/headless) после завершения фоновой установки. Отключено по умолчанию, потому что обновление изменяет системную подсказку в середине сеанса, что делает недействительным [кэширование подсказок](/docs/ru/prompt-caching) для этого хода |

284| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Установите `1` для маршрутизации опроса качества сеанса "How is Claude doing?" на ваш собственный [сборщик OpenTelemetry](/docs/ru/monitoring-usage) когда сетевой трафик, привязанный к Anthropic, заблокирован. Рейтинги опросов выдаются только как события OTEL вашему настроенному сборщику. Данные опроса не отправляются Anthropic в этом режиме. Применяется, когда установлены `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` или `DO_NOT_TRACK`, и не имеет эффекта в противном случае. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` и политика обратной связи организации имеют приоритет |284| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Установите `1` для маршрутизации опроса качества сеанса "How is Claude doing?" на ваш собственный [сборщик OpenTelemetry](/docs/ru/monitoring-usage) когда сетевой трафик, связанный с Anthropic, заблокирован. Рейтинги опроса выдаются только как события OTEL вашему настроенному сборщику. Никакие данные опроса не отправляются Anthropic в этом режиме. Применяется, когда установлены `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` или `DO_NOT_TRACK`, и не имеет эффекта в противном случае. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` и политика обратной связи организации имеют приоритет |

285| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Контролирует, передаются ли входные данные вызова инструмента из API по мере их создания Claude. При отключении большой вход инструмента, такой как длинная запись файла, поступает только после завершения создания Claude, что может выглядеть как зависание. Включено по умолчанию на API Anthropic. На Amazon Bedrock и Google Cloud's Agent Platform включено для каждой модели, где развернутый контейнер это поддерживает. Установите `0` для отказа. Установите `1` для принудительного включения при маршрутизации через прокси через `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_BEDROCK_BASE_URL`. Отключено по умолчанию на Microsoft Foundry и подключениях [шлюза](/docs/ru/llm-gateway) |285| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Контролирует, передаются ли входные данные вызова инструмента из API по мере их создания Claude. При отключении большой вход инструмента, такой как длинная запись файла, поступает только после завершения создания Claude, что может выглядеть как зависание. Включено по умолчанию на API Anthropic. На Amazon Bedrock и Google Cloud's Agent Platform включено для каждой модели, где развернутый контейнер это поддерживает. Установите `0` для отказа. Установите `1` для принудительного включения при маршрутизации через прокси через `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_BEDROCK_BASE_URL`. Отключено по умолчанию на Microsoft Foundry и подключениях [gateway](/docs/ru/gateways) |

286| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Установите `1` для заполнения средства выбора `/model` из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз, такой как LiteLLM, Kong или внутренний прокси. Отключено по умолчанию, потому что шлюзы, поддерживаемые общим ключом API, в противном случае показали бы каждому пользователю каждую модель, к которой может получить доступ ключ. Обнаруженные модели по-прежнему фильтруются списком разрешений [`availableModels`](/docs/ru/settings-reference#availablemodels), который получает сеанс; доставьте список через [MDM или файл управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms), так как [доставка, управляемая сервером, недоступна в конфигурациях шлюза](/docs/ru/server-managed-settings#platform-availability) |286| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Установите `1` для заполнения средства выбора `/model` из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз, такой как LiteLLM, Kong или внутренний прокси. Отключено по умолчанию, потому что шлюзы, поддерживаемые общим ключом API, иначе показали бы каждому пользователю каждую модель, к которой может получить доступ ключ. Обнаруженные модели по-прежнему фильтруются списком разрешений [`availableModels`](/docs/ru/settings-reference#availablemodels), который получает сеанс; доставьте список через [MDM или файл управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms), так как [доставка, управляемая сервером, недоступна в конфигурациях шлюза](/docs/ru/server-managed-settings#platform-availability) |

287| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Удалено в версии 2.1.142, когда [быстрый режим](/docs/ru/fast-mode) по умолчанию переместился с Opus 4.6 на Opus 4.7 |287| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Удалено в версии 2.1.142, когда [fast mode](/docs/ru/fast-mode) по умолчанию переместился с Opus 4.6 на Opus 4.7 |

288| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Установите `false` для отключения предложений подсказок, затемненных предсказаний, которые появляются в вводе подсказки. Имеет приоритет над параметром [`promptSuggestionEnabled`](/docs/ru/settings-reference#promptsuggestionenabled), который записывает переключатель **Prompt suggestions** в `/config`. Claude Code также [приостанавливает предложения, пока ваша учетная запись близка к пределу использования или находится на нем](/docs/ru/interactive-mode#when-claude-code-skips-suggestions). Установите `true` для сохранения их включенными до достижения лимита. Требует Claude Code версии 2.1.238 или позже. См. [Предложения подсказок](/docs/ru/interactive-mode#prompt-suggestions) |288| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Установите `false` для отключения предложений подсказок, затемненных предсказаний, которые появляются в вводе подсказки. Имеет приоритет над параметром [`promptSuggestionEnabled`](/docs/ru/settings-reference#promptsuggestionenabled), который записывает переключатель **Prompt suggestions** в `/config`. Claude Code также [приостанавливает предложения, пока ваша учетная запись близка к пределу использования или находится на нем](/docs/ru/interactive-mode#when-claude-code-skips-suggestions). Установите `true` для сохранения их включенными до достижения лимита. Требует Claude Code версии 2.1.238 или позже. См. [Предложения подсказок](/docs/ru/interactive-mode#prompt-suggestions) |

289| `CLAUDE_CODE_ENABLE_TASKS` | Выбирает, какие инструменты отслеживания задач Claude Code предоставляет в [сеансах, которые их имеют](/docs/ru/tools-reference#task-tool-availability). По умолчанию Claude Code предоставляет инструменты Task `TaskCreate`, `TaskUpdate`, `TaskGet` и `TaskList`. Установите `0` для получения устаревшего инструмента `TodoWrite` вместо этого. См. [Список задач](/docs/ru/interactive-mode#task-list) |289| `CLAUDE_CODE_ENABLE_TASKS` | Выбирает, какие инструменты отслеживания задач Claude Code предоставляет в [сеансах, которые их имеют](/docs/ru/tools-reference#task-tool-availability). По умолчанию Claude Code предоставляет инструменты Task `TaskCreate`, `TaskUpdate`, `TaskGet` и `TaskList`. Установите `0` для получения устаревшего инструмента `TodoWrite` вместо этого. См. [Список задач](/docs/ru/interactive-mode#task-list) |

290| `CLAUDE_CODE_ENABLE_TELEMETRY` | Установите `1` для включения сбора данных OpenTelemetry для метрик и логирования. Требуется перед настройкой экспортеров OTel. См. [Мониторинг](/docs/ru/monitoring-usage) |290| `CLAUDE_CODE_ENABLE_TELEMETRY` | Установите `1` для включения сбора данных OpenTelemetry для метрик и логирования. Требуется перед настройкой экспортеров OTel. См. [Мониторинг](/docs/ru/monitoring-usage) |

291| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Установите `1` для получения инструментов отслеживания задач на каждой модели. Без этого Claude Code предоставляет их по умолчанию только на моделях, перечисленных в [Доступность инструмента Task](/docs/ru/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` по-прежнему выбирает инструменты Task или `TodoWrite`. Требует Claude Code версии 2.1.233 или позже |291| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Установите `1` для получения инструментов отслеживания задач на каждой модели. Без этого Claude Code предоставляет их по умолчанию только на моделях, перечисленных в [Доступность инструмента Task](/docs/ru/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` по-прежнему выбирает инструменты Task или `TodoWrite`. Требует Claude Code версии 2.1.233 или позже |

292| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Время в миллисекундах для ожидания после того как цикл запроса становится неактивным перед автоматическим выходом. Полезно для автоматизированных рабочих процессов и скриптов, использующих режим SDK |292| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Время в миллисекундах для ожидания после того, как цикл запроса становится неактивным, перед автоматическим выходом. Полезно для автоматизированных рабочих процессов и скриптов, использующих режим SDK |

293| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Установите `1` для включения [команд агентов](/docs/ru/agent-teams). Команды агентов являются экспериментальными и отключены по умолчанию |293| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Установите `1` для включения [команд агентов](/docs/ru/agent-teams). Команды агентов являются экспериментальными и отключены по умолчанию |

294| `CLAUDE_CODE_EXTRA_BODY` | JSON объект для объединения на верхний уровень каждого тела запроса API. Полезно для передачи параметров, специфичных для поставщика, которые Claude Code не предоставляет напрямую. Значение, экспортированное в вашей оболочке, также применяется к [фоновым сеансам](/docs/ru/agent-view), которые вы отправляете с `claude agents` или `--bg`. До версии 2.1.206 фоновые сеансы игнорировали экспортированное значение оболочки и использовали любую копию, которую унаследовал процесс супервизора фона |294| `CLAUDE_CODE_EXTRA_BODY` | Объект JSON для объединения на верхний уровень каждого тела запроса API. Полезно для передачи параметров, специфичных для поставщика, которые Claude Code не предоставляет напрямую. Значение, экспортированное в вашей оболочке, также применяется к [фоновым сеансам](/docs/ru/agent-view), которые вы отправляете с помощью `claude agents` или `--bg`. До версии 2.1.206 фоновые сеансы игнорировали экспортированное значение оболочки и использовали любую копию, которую унаследовал процесс супервизора фона |

295| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Переопределить ограничение токенов по умолчанию для чтения файлов. Полезно, когда вам нужно прочитать большие файлы полностью |295| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Переопределить ограничение токенов по умолчанию для чтения файлов. Полезно, когда вам нужно прочитать большие файлы полностью |

296| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Установите `1` для принудительного сохранения стенограммы, истории подсказок и регистрации `claude agents` даже когда этот `claude` был запущен изнутри другого сеанса Claude Code. Используйте, когда унаследованное значение `CLAUDE_CODE_CHILD_SESSION`, например из сеанса `screen` или фонового средства запуска, впервые запущенного инструментом Bash Claude Code, вызывает неправильную классификацию подлинного верхнего сеанса как вложенного. Начиная с версии 2.1.178, Claude Code автоматически обнаруживает случай tmux и игнорирует унаследованный маркер, поэтому tmux больше не нуждается в этой переменной. Также соблюдается на версиях 2.1.169 и ранее; не имеет эффекта на версиях 2.1.170 и 2.1.171, где было удалено обнаружение вложенного сеанса, которое оно переопределяет |296| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Установите `1` для принудительного сохранения стенограммы, истории подсказок и регистрации `claude agents` даже когда этот `claude` был запущен изнутри другого сеанса Claude Code. Используйте, когда унаследованное значение `CLAUDE_CODE_CHILD_SESSION`, например из сеанса `screen` или фонового средства запуска, впервые запущенного инструментом Bash Claude Code, вызывает неправильную классификацию подлинного верхнего сеанса как вложенного. Начиная с версии 2.1.178, Claude Code автоматически обнаруживает случай tmux и игнорирует унаследованный маркер, поэтому tmux больше не нуждается в этой переменной. Также соблюдается на версиях 2.1.169 и ранее; не имеет эффекта на версиях 2.1.170 и 2.1.171, где удалено обнаружение вложенного сеанса, которое оно переопределяет |

297| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Установите `1` для принудительного рендера зачеркивания для `~~text~~` в ответах Claude, когда ваш терминал это поддерживает, но не автоопределяется, например через SSH без пересылки `TERM_PROGRAM`. Без этого необнаруженные терминалы показывают буквальные маркеры `~~` вместо рендера текста как зачеркивания. Требует Claude Code версии 2.1.186 или позже |297| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Установите `1` для принудительного рендеринга зачеркивания для `~~text~~` в ответах Claude, когда ваш терминал это поддерживает, но не автоопределяется, например, через SSH без пересылки `TERM_PROGRAM`. Без этого необнаруженные терминалы показывают буквальные маркеры `~~` вместо рендеринга текста как зачеркивания. Требует Claude Code версии 2.1.186 или позже |

298| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Установите `1` для принудительного включения режима DEC private 2026 [синхронизированного вывода](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) когда ваш терминал это поддерживает, но не автоопределяется. Полезно для эмуляторов, таких как Emacs `eat`, которые реализуют BSU/ESU, но не отвечают на зонд возможностей. Не имеет эффекта под tmux. В отличие от `CLAUDE_CODE_NO_FLICKER`, который переключается на [полноэкранный рендер](/docs/ru/fullscreen), это не изменяет рендер |298| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Установите `1` для принудительного включения режима DEC private 2026 [синхронизированного вывода](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) когда ваш терминал это поддерживает, но не автоопределяется. Полезно для эмуляторов, таких как Emacs `eat`, которые реализуют BSU/ESU, но не отвечают на зонд возможностей. Не имеет эффекта под tmux. В отличие от `CLAUDE_CODE_NO_FLICKER`, который переключается на [полноэкранный рендеринг](/docs/ru/fullscreen), это не изменяет рендерер |

299| `CLAUDE_CODE_FORK_SUBAGENT` | Контролирует [режим fork](/docs/ru/sub-agents#turn-fork-mode-on-or-off), который позволяет Claude порождать [разветвленные подагенты](/docs/ru/sub-agents#fork-the-current-conversation) сам и включен по умолчанию только в интерактивных сеансах. Установите `1` для включения в `claude -p` и Agent SDK также, или `0` для отключения в каждом виде сеанса. Вы можете запустить `/subtask` независимо от того, включен ли режим fork. Интерактивное значение по умолчанию требует Claude Code версии 2.1.232 или позже; на более ранних версиях установите переменную на `1` для включения режима fork |299| `CLAUDE_CODE_FORK_SUBAGENT` | Контролирует [режим fork](/docs/ru/sub-agents#turn-fork-mode-on-or-off), который позволяет Claude порождать [разветвленные subagents](/docs/ru/sub-agents#fork-the-current-conversation) сам и включен по умолчанию только в интерактивных сеансах. Установите `1` для включения в `claude -p` и Agent SDK также, или `0` для отключения в каждом виде сеанса. Вы можете запустить `/subtask` независимо от того, включен ли режим fork. Интерактивное значение по умолчанию требует Claude Code версии 2.1.232 или позже; на более ранних версиях установите переменную на `1` для включения режима fork |

300| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Установите `1` для выдачи [подагента](/docs/ru/sub-agents) текста и блоков мышления в выводе `claude -p --output-format stream-json`, то же поведение, что и флаг [`--forward-subagent-text`](/docs/ru/cli-reference#cli-flags). Используйте переменную, когда обвязка вызывает `claude` и не может передать флаг сам. В отличие от флага, который выходит с ошибкой вне неинтерактивного режима с выводом stream-json, переменная игнорируется там, чтобы вложенные вызовы продолжали работать при установке процесса. Требует Claude Code версии 2.1.211 или позже |300| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Установите `1` для выдачи [subagent](/docs/ru/sub-agents) текста и блоков мышления в выводе `claude -p --output-format stream-json`, то же поведение, что и флаг [`--forward-subagent-text`](/docs/ru/cli-reference#cli-flags). Используйте переменную, когда harness вызывает `claude` и не может передать флаг сам. В отличие от флага, который выходит с ошибкой вне неинтерактивного режима с выводом stream-json, переменная игнорируется там, чтобы вложенные вызовы продолжали работать при установке процесса. Требует Claude Code версии 2.1.211 или позже |

301| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Таймаут в миллисекундах для запроса [обнаружения модели шлюза](/docs/ru/llm-gateway-protocol#model-discovery), который включает `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (по умолчанию: `3000`). Повысьте это, когда вашему шлюзу нужно больше трех секунд для ответа на `/v1/models` при запуске. Принимает только простые цифры; `0`, отрицательные значения и другие написания сохраняют значение по умолчанию. Требует Claude Code версии 2.1.269 или позже |301| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Таймаут в миллисекундах для запроса [обнаружения модели шлюза](/docs/ru/llm-gateway-protocol#model-discovery), который включает `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (по умолчанию: `3000`). Повысьте это, когда вашему шлюзу требуется больше трех секунд для ответа на `/v1/models` при запуске. Принимает только простые цифры; `0`, отрицательные значения и другие написания сохраняют значение по умолчанию. Требует Claude Code версии 2.1.269 или позже |

302| `CLAUDE_CODE_GIT_BASH_PATH` | Только Windows: путь к исполняемому файлу Git Bash (`bash.exe`). Используйте, когда Git Bash установлен, но не в вашем PATH. Если путь не существует или файл не назван `bash.exe`, `sh.exe`, `bash` или `sh`, Claude Code игнорирует переменную и автоопределяет Git Bash, как если бы она была не установлена, логируя предупреждение, видимое с `--debug`. До версии 2.1.219 Claude Code выходил при запуске, когда путь не существовал, и использовал любой существующий файл как оболочку без проверки, что это bash или sh. См. [Настройка Windows](/docs/ru/setup#set-up-on-windows) |302| `CLAUDE_CODE_GIT_BASH_PATH` | Только Windows: путь к исполняемому файлу Git Bash (`bash.exe`). Используйте, когда Git Bash установлен, но не в вашем PATH. Если путь не существует или файл не назван `bash.exe`, `sh.exe`, `bash` или `sh`, Claude Code игнорирует переменную и автоопределяет Git Bash, как если бы она была неустановлена, логируя предупреждение, видимое с `--debug`. До версии 2.1.219 Claude Code выходил при запуске, когда путь не существовал, и использовал любой существующий файл как оболочку без проверки того, что это bash или sh. См. [Настройка Windows](/docs/ru/setup#set-up-on-windows) |

303| `CLAUDE_CODE_GLOB_HIDDEN` | Установите `false` для исключения скрытых файлов из результатов, когда Claude вызывает [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior). Включено по умолчанию. Не влияет на автодополнение файлов `@`, `ls`, Grep или Read |303| `CLAUDE_CODE_GLOB_HIDDEN` | Установите `false` для исключения скрытых файлов из результатов, когда Claude вызывает [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior). Включено по умолчанию. Не влияет на автодополнение файлов `@`, `ls`, Grep или Read |

304| `CLAUDE_CODE_GLOB_NO_IGNORE` | Установите `false` для того, чтобы [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior) соблюдал шаблоны `.gitignore`. По умолчанию Glob возвращает все совпадающие файлы, включая игнорируемые git. Не влияет на автодополнение файлов `@`, которое имеет свой собственный параметр [`respectGitignore`](/docs/ru/settings-reference#respectgitignore) |304| `CLAUDE_CODE_GLOB_NO_IGNORE` | Установите `false` для того, чтобы [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior) соблюдал шаблоны `.gitignore`. По умолчанию Glob возвращает все совпадающие файлы, включая игнорируемые git. Не влияет на автодополнение файлов `@`, которое имеет свой собственный параметр [`respectGitignore`](/docs/ru/settings-reference#respectgitignore) |

305| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Таймаут в секундах для обнаружения файлов инструмента Glob. По умолчанию 20 секунд на большинстве платформ и 60 секунд на WSL |305| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Таймаут в секундах для обнаружения файлов инструмента Glob. По умолчанию 20 секунд на большинстве платформ и 60 секунд на WSL |

306| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Сколько минут фоновая работа может держать активную цель в ожидании перед тем как Claude Code [попросит Claude проверить это](/docs/ru/goal#background-work-defers-evaluation). По умолчанию `30`. Установите `0` для отключения проверок. Дайте целые минуты в простых цифрах, максимум `10080`, что составляет одну неделю. Claude Code обрабатывает любое другое значение как не установленное и использует значение по умолчанию. Требует Claude Code версии 2.1.234 или позже |306| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Сколько минут фоновая работа может держать активную цель в ожидании перед тем, как Claude Code [попросит Claude проверить ее](/docs/ru/goal#background-work-defers-evaluation). По умолчанию `30`. Установите `0` для отключения проверок. Дайте целые минуты в простых цифрах, максимум `10080`, что составляет одну неделю. Claude Code обрабатывает любое другое значение как неустановленное и использует значение по умолчанию. Требует Claude Code версии 2.1.234 или позже |

307| `CLAUDE_CODE_HIDE_CWD` | Установите `1` для скрытия рабочего каталога в логотипе запуска. Полезно для скринширов или записей, где путь раскрывает имя пользователя вашей ОС |307| `CLAUDE_CODE_HIDE_CWD` | Установите `1` для скрытия рабочего каталога в логотипе запуска. Полезно для скринширов или записей, где путь раскрывает имя пользователя вашей ОС |

308| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Переопределить адрес хоста, используемый для подключения к расширению IDE. По умолчанию Claude Code автоопределяет правильный адрес, включая маршрутизацию WSL-to-Windows |308| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Переопределить адрес хоста, используемый для подключения к расширению IDE. По умолчанию Claude Code автоопределяет правильный адрес, включая маршрутизацию WSL-to-Windows |

309| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Установите `1` для пропуска автоустановки расширений IDE. Эквивалентно установке [`autoInstallIdeExtension`](/docs/ru/settings-reference#autoinstallideextension) на `false` |309| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Установите `1` для пропуска автоустановки расширений IDE. Эквивалентно установке [`autoInstallIdeExtension`](/docs/ru/settings-reference#autoinstallideextension) на `false` |

310| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Установите `1` для пропуска проверки записей файла блокировки IDE при подключении. Используйте, когда автоподключение не может найти вашу IDE, несмотря на то что она работает |310| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Установите `1` для пропуска проверки записей файла блокировки IDE при подключении. Используйте, когда автоподключение не может найти вашу IDE, несмотря на то, что она работает |

311| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Сколько [подагентов](/docs/ru/sub-agents#concurrent-subagent-limit) может работать в одном сеансе перед тем как инструмент Agent отказывает в порождении другого (по умолчанию: 20). Принимает положительное целое число в простых цифрах; что-либо еще игнорируется, поэтому переменная может отрегулировать ограничение, но не может его отключить. Требует Claude Code версии 2.1.217 или позже |311| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Сколько [subagents](/docs/ru/sub-agents#concurrent-subagent-limit) может работать в одном сеансе перед тем, как инструмент Agent откажется порождать другой (по умолчанию: 20). Принимает положительное целое число в простых цифрах; что-либо еще игнорируется, поэтому переменная может отрегулировать ограничение, но не может его отключить. Требует Claude Code версии 2.1.217 или позже |

312| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Переопределить размер окна контекста, который Claude Code предполагает для активной модели. Начиная с версии 2.1.193, как это применяется, зависит от того, как Claude Code разрешает ID модели; см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Используйте это при маршрутизации к модели через `ANTHROPIC_BASE_URL`, чье окно контекста не совпадает с встроенным размером для его имени |312| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Переопределить размер окна контекста, который Claude Code предполагает для активной модели. Начиная с версии 2.1.193, как это применяется, зависит от того, как Claude Code разрешает ID модели; см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Используйте это при маршрутизации к модели через `ANTHROPIC_BASE_URL`, чье окно контекста не соответствует встроенному размеру для его имени |

313| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Установить максимальное количество выходных токенов для большинства запросов. Значения по умолчанию и ограничения варьируются по модели; см. [максимальные выходные токены](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code по умолчанию использует 32000 для ID моделей, которые он не распознает, такие как имена, специфичные для шлюза, и понижает значения выше ограничения модели до ограничения. Увеличение этого значения уменьшает эффективное окно контекста, доступное перед [автокомпактированием](/docs/ru/costs#reduce-token-usage) |313| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Установить максимальное количество выходных токенов для большинства запросов. Значения по умолчанию и ограничения варьируются по модели; см. [максимальные выходные токены](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code по умолчанию использует 32000 для ID моделей, которые он не распознает, такие как имена, специфичные для шлюза, и понижает значения выше ограничения модели до ограничения. Увеличение этого значения уменьшает эффективное окно контекста, доступное перед [автокомпактированием](/docs/ru/costs#reduce-token-usage) |

314| `CLAUDE_CODE_MAX_RETRIES` | Переопределить количество раз для повтора неудачных запросов API (по умолчанию: 10). Ограничено 15 начиная с версии 2.1.186; начиная с версии 2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Для неконтролируемых сеансов, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG` вместо этого |314| `CLAUDE_CODE_MAX_RETRIES` | Переопределить количество раз для повтора неудачных запросов API (по умолчанию: 10). Ограничено 15 начиная с версии 2.1.186; начиная с версии 2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Для неконтролируемых сеансов, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG` вместо этого |

315| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Удалено в версии 2.1.224 и теперь не работает. Ранее ограничивало общее количество [подагентов](/docs/ru/sub-agents), которых Claude мог порождать с инструментом Agent в одном сеансе (по умолчанию: 200); порождение сверх ограничения завершалось с `Subagent spawn limit reached`. [Ограничение одновременных подагентов](/docs/ru/sub-agents#concurrent-subagent-limit) и [ограничение глубины](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) по-прежнему применяются |315| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Удалено в версии 2.1.224 и теперь не работает. Ранее ограничивало общее количество [subagents](/docs/ru/sub-agents), которых Claude мог порождать с помощью инструмента Agent в одном сеансе (по умолчанию: 200); порождение сверх ограничения завершалось с ошибкой `Subagent spawn limit reached`. [Ограничение одновременного subagent](/docs/ru/sub-agents#concurrent-subagent-limit) и [ограничение глубины](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) по-прежнему применяются |

316| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Количество [слоев подагентов](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) разрешено ниже основного разговора (по умолчанию: 3). При значении по умолчанию подагенты могут порождать своих собственных подагентов, и подагент на третьем слое не может порождать дальше; установите `1` для отключения вложения. В версиях 2.1.217 через 2.1.218 значение по умолчанию было 1, поэтому подагент не мог порождать своего собственного, если вы не повысили ограничение; версия 2.1.219 повысила значение по умолчанию до 3. Принимает положительное целое число в простых цифрах; что-либо еще игнорируется, поэтому ограничение может быть отрегулировано, но не удалено. Требует Claude Code версии 2.1.217 или позже |316| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Количество [слоев subagent](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) разрешено ниже основного разговора (по умолчанию: 3). При значении по умолчанию subagents могут порождать собственные subagents, и subagent на третьем слое не может порождать дальше; установите `1` для отключения вложения. В версиях 2.1.217 через 2.1.218 значение по умолчанию было 1, поэтому subagent не мог порождать свой собственный, если вы не повысили ограничение; версия 2.1.219 повысила значение по умолчанию до 3. Принимает положительное целое число в простых цифрах; что-либо еще игнорируется, поэтому ограничение может быть отрегулировано, но не удалено. Требует Claude Code версии 2.1.217 или позже |

317| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Максимальное количество инструментов только для чтения и подагентов, которые могут выполняться параллельно (по умолчанию: 10). Более высокие значения увеличивают параллелизм, но потребляют больше ресурсов |317| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Максимальное количество инструментов только для чтения и subagents, которые могут выполняться параллельно (по умолчанию: 10). Более высокие значения увеличивают параллелизм, но потребляют больше ресурсов |

318| `CLAUDE_CODE_MAX_TURNS` | Ограничить количество агентивных ходов, когда явное ограничение не передано. Эквивалентно передаче [`--max-turns`](/docs/ru/cli-reference#cli-flags), которая имеет приоритет при установке обоих. Значение, которое не является положительным целым числом, отклоняется при запуске с ошибкой, а не обрабатывается как отсутствие ограничения |318| `CLAUDE_CODE_MAX_TURNS` | Ограничить количество агентивных ходов, когда явное ограничение не передано. Эквивалентно передаче [`--max-turns`](/docs/ru/cli-reference#cli-flags), которая имеет приоритет при установке обоих. Значение, которое не является положительным целым числом, отклоняется при запуске с ошибкой, а не обрабатывается как отсутствие ограничения |

319| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Ограничение на общее количество вызовов [WebSearch](/docs/ru/tools-reference#websearch-tool-behavior), которые один сеанс может сделать (по умолчанию: 200). Когда Claude достигает ограничения, дальнейшие вызовы WebSearch возвращают уведомление, говорящее ему продолжить с информацией, которую он уже собрал. Принимает положительное целое число без верхнего ограничения. Что-либо еще игнорируется и применяется значение по умолчанию, поэтому ограничение может быть повышено, но не отключено. Требует Claude Code версии 2.1.212 или позже |319| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Ограничение на общее количество вызовов [WebSearch](/docs/ru/tools-reference#websearch-tool-behavior), которые один сеанс может сделать (по умолчанию: 200). Когда Claude достигает ограничения, дальнейшие вызовы WebSearch возвращают уведомление, говорящее ему продолжить с информацией, которую он уже собрал. Принимает положительное целое число без верхнего ограничения. Что-либо еще игнорируется и применяется значение по умолчанию, поэтому ограничение может быть повышено, но не отключено. Требует Claude Code версии 2.1.212 или позже |

320| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Установите `1` для порождения серверов stdio MCP с только безопасной базовой средой плюс настроенная `env` сервера, вместо наследования окружения вашей оболочки |320| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Установите `1` для порождения серверов MCP stdio с только безопасной базовой средой плюс настроенная `env` сервера, вместо наследования окружения вашей оболочки |

321| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Прошедшее время в миллисекундах перед тем как все еще работающий вызов инструмента MCP [переходит в фоновую задачу](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls) (по умолчанию: 120000 или 2 минуты). Установите `0` для отключения автоматического фонового выполнения. Требует Claude Code версии 2.1.212 или позже |321| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Прошедшее время в миллисекундах перед тем, как все еще работающий вызов инструмента MCP [переместится в фоновую задачу](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls) (по умолчанию: 120000 или 2 минуты). Установите `0` для отключения автоматического фонового выполнения. Требует Claude Code версии 2.1.212 или позже |

322| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Как долго в миллисекундах первый ход [неинтерактивного](/docs/ru/headless) сеанса ждет серверов MCP, которые все еще подключаются, вместо [ожидания первого хода](/docs/ru/agent-sdk/mcp#connection-timing) по умолчанию. При установке ожидание охватывает каждый ожидающий сервер. Установите `0` для пропуска ожидания. Сервер [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) сохраняет свое собственное ожидание `MCP_TIMEOUT` независимо от значения. Требует Claude Code версии 2.1.274 или позже |322| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Как долго в миллисекундах первый ход [неинтерактивного](/docs/ru/headless) сеанса ждет серверов MCP, которые все еще подключаются, вместо [ожидания первого хода](/docs/ru/agent-sdk/mcp#connection-timing) по умолчанию. Если установлено, ожидание охватывает каждый ожидающий сервер. Установите `0` для пропуска ожидания. Сервер [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) сохраняет свое собственное ожидание `MCP_TIMEOUT` независимо от значения. Требует Claude Code версии 2.1.274 или позже |

323| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Таймаут простоя в миллисекундах для вызовов инструментов MCP. Когда сервер stdio, HTTP, SSE, WebSocket или [соединитель claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) MCP не отправляет ответ и уведомление о прогрессе в течение этого времени, вызов инструмента прерывается с ошибкой вместо ожидания общего `MCP_TOOL_TIMEOUT`. Переопределяет значения по умолчанию для каждого транспорта 300000 (5 минут) для сетевых серверов и 1800000 (30 минут) для серверов stdio. Установите `0` для отключения проверки простоя. Значения ниже 1000 повышаются до одной секунды, и значение ограничивается эффективным `MCP_TOOL_TIMEOUT`. Сервер `timeout` в `.mcp.json` по крайней мере 1000 повышает окно простоя этого сервера по крайней мере до значения `timeout`. Не применяется к серверам IDE или серверам в процессе SDK. Требует Claude Code версии 2.1.187 или позже. До версии 2.1.203 серверы stdio были освобождены от таймаута простоя |323| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Таймаут простоя в миллисекундах для вызовов инструментов MCP. Когда сервер MCP stdio, HTTP, SSE, WebSocket или [claude.ai connector](/docs/ru/mcp#use-mcp-servers-from-claude-ai) не отправляет ответ и уведомление о прогрессе в течение этого времени, вызов инструмента прерывается с ошибкой вместо ожидания общего `MCP_TOOL_TIMEOUT`. Переопределяет значения по умолчанию для каждого транспорта 300000 (5 минут) для сетевых серверов и 1800000 (30 минут) для серверов stdio. Установите `0` для отключения проверки простоя. Значения ниже 1000 повышаются до одной секунды, и значение ограничено эффективным `MCP_TOOL_TIMEOUT`. Сервер `timeout` в `.mcp.json` по крайней мере 1000 повышает окно простоя этого сервера по крайней мере до значения `timeout`. Не применяется к серверам IDE или серверам в процессе SDK. Требует Claude Code версии 2.1.187 или позже. До версии 2.1.203 серверы stdio были освобождены от таймаута простоя |

324| `CLAUDE_CODE_MESSAGING_SOCKET` | Установлено Claude Code, а не вами: в сеансах, которые привязывают [сокет входящих сообщений](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), Claude Code экспортирует путь этого сокета к hooks и командам Bash при привязке сокета. В сеансе, который начинается с включенной передачей сообщений, Claude Code привязывает сокет перед запуском любого hook. Другие сеансы на машине доставляют сообщения на этот путь. Каждый сеанс экспортирует свой собственный сокет, а не унаследованный от родителя, и сообщения, поступающие на него, проходят через [входящие элементы управления](/docs/ru/cross-session-messaging#control-inbound-messages) сеанса. Блоки параметров `env` не могут его установить. Требует Claude Code версии 2.1.224 или позже |324| `CLAUDE_CODE_MESSAGING_SOCKET` | Установлено Claude Code, а не вами: в сеансах, которые привязывают [сокет входящих сообщений](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), Claude Code экспортирует путь этого сокета к hooks и командам Bash при привязке сокета. В сеансе, который начинается с включенной передачей сообщений, Claude Code привязывает сокет перед запуском любого hook. Другие сеансы на машине доставляют сообщения на этот путь. Каждый сеанс экспортирует свой собственный сокет, а не унаследованный от родителя, и сообщения, поступающие на него, проходят через [входящие элементы управления](/docs/ru/cross-session-messaging#control-inbound-messages) сеанса. Блоки параметров `env` не могут его установить. Требует Claude Code версии 2.1.224 или позже |

325| `CLAUDE_CODE_MESSAGING_TOKEN` | Установлено Claude Code, а не вами: в сеансах, которые привязывают [сокет входящих сообщений](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), Claude Code экспортирует этот токен для каждого сеанса к hooks и командам Bash рядом с `CLAUDE_CODE_MESSAGING_SOCKET`. Скрипт, отправляющий на сокет, может отправить `{"type":"auth","token":"<token>"}` как первую строку для доказательства того, что он принадлежит сеансу. На собственном Windows Claude Code требует эту строку и закрывает любое подключение, которое не открывается с действительной. [Правила собственного дочернего элемента](/docs/ru/cross-session-messaging#the-sessions-inbox-socket) говорят, когда Claude Code консультирует токен. Каждый сеанс экспортирует свой собственный токен, никогда унаследованный от родительского сеанса. Блоки параметров `env` не могут его установить. Требует Claude Code версии 2.1.228 или позже |325| `CLAUDE_CODE_MESSAGING_TOKEN` | Установлено Claude Code, а не вами: в сеансах, которые привязывают [сокет входящих сообщений](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), Claude Code экспортирует этот токен для каждого сеанса к hooks и командам Bash рядом с `CLAUDE_CODE_MESSAGING_SOCKET`. Скрипт, отправляющий на сокет, может отправить `{"type":"auth","token":"<token>"}` как первую строку для доказательства того, что он принадлежит сеансу. На собственном Windows Claude Code требует эту строку и закрывает любое подключение, которое не открывается с действительной. [Правила собственного дочернего элемента](/docs/ru/cross-session-messaging#the-sessions-inbox-socket) говорят, когда Claude Code консультирует токен. Каждый сеанс экспортирует свой собственный токен, никогда не унаследованный от родительского сеанса. Блоки параметров `env` не могут его установить. Требует Claude Code версии 2.1.228 или позже |

326| `CLAUDE_CODE_NATIVE_CURSOR` | Установите `1` для отображения собственного курсора терминала в каретке ввода вместо нарисованного блока. Курсор соблюдает параметры мигания, формы и фокуса терминала |326| `CLAUDE_CODE_NATIVE_CURSOR` | Установите `1` для отображения собственного курсора терминала в каретке ввода вместо нарисованного блока. Курсор соблюдает параметры мигания, формы и фокуса терминала |

327| `CLAUDE_CODE_NEW_INIT` | Установите `1` для запуска `/init` интерактивного потока настройки. Поток спрашивает, какие файлы создавать, включая CLAUDE.md, skills и hooks, перед исследованием кодовой базы и их написанием. Без этой переменной `/init` создает CLAUDE.md автоматически без запроса |327| `CLAUDE_CODE_NEW_INIT` | Установите `1` для запуска `/init` интерактивного потока настройки. Поток спрашивает, какие файлы создавать, включая CLAUDE.md, skills и hooks, перед исследованием кодовой базы и их написанием. Без этой переменной `/init` автоматически создает CLAUDE.md без запроса |

328| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Установите `1` для записи вывода терминала через второй неблокирующий дескриптор файла, поэтому терминал, который перестает читать, такой как приостановленная панель управления tmux или застопорившееся SSH подключение, не может заморозить Claude Code в середине сеанса. Применяется на macOS, Linux и WSL, когда stdout — это терминал. Требует Claude Code версии 2.1.261 или позже |328| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Установите `1` для записи вывода терминала через второй неблокирующий дескриптор файла, поэтому терминал, который перестает читать, такой как приостановленная панель управления tmux или зависшее подключение SSH, не может заморозить Claude Code в середине сеанса. Применяется на macOS, Linux и WSL, когда stdout является терминалом. Требует Claude Code версии 2.1.261 или позже |

329| `CLAUDE_CODE_NO_FLICKER` | Установите `1` для включения [полноэкранного рендера](/docs/ru/fullscreen), исследовательского предпросмотра, который уменьшает мерцание и сохраняет память плоской в длинных разговорах. Переопределяет параметр [`tui`](/docs/ru/settings-reference#tui); вы также можете переключаться с `/tui fullscreen` |329| `CLAUDE_CODE_NO_FLICKER` | Установите `1` для включения [полноэкранного рендеринга](/docs/ru/fullscreen), исследовательского предпросмотра, который уменьшает мерцание и сохраняет память плоской в длинных разговорах. Переопределяет параметр [`tui`](/docs/ru/settings-reference#tui); вы также можете переключаться с помощью `/tui fullscreen` |

330| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | OAuth токен обновления для аутентификации Claude.ai. При установке `claude auth login` обменивает этот токен напрямую вместо открытия браузера. Требует `CLAUDE_CODE_OAUTH_SCOPES`. Полезно для предоставления аутентификации в автоматизированных окружениях |330| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Токен обновления OAuth для аутентификации Claude.ai. Если установлен, `claude auth login` обменивает этот токен напрямую вместо открытия браузера. Требует `CLAUDE_CODE_OAUTH_SCOPES`. Полезно для предоставления аутентификации в автоматизированных окружениях |

331| `CLAUDE_CODE_OAUTH_SCOPES` | Разделенные пробелом области OAuth, с которыми был выдан токен обновления, такие как `"user:profile user:inference user:sessions:claude_code"`. Требуется при установке `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |331| `CLAUDE_CODE_OAUTH_SCOPES` | Разделенные пробелом области OAuth, с которыми был выдан токен обновления, такие как `"user:profile user:inference user:sessions:claude_code"`. Требуется при установке `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |

332| `CLAUDE_CODE_OAUTH_TOKEN` | OAuth токен доступа для аутентификации claude.ai. Альтернатива `/login` для SDK и автоматизированных окружений. Имеет приоритет над учетными данными, хранящимися в связке ключей. Создайте один с [`claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token). Если вы не запустите [`/login`](/docs/ru/authentication#authentication-precedence), Claude Code использует установленный вами токен для всего сеанса. Чтобы заменить истекший токен, создайте новый и перезагрузитесь |332| `CLAUDE_CODE_OAUTH_TOKEN` | Токен доступа OAuth для аутентификации claude.ai. Альтернатива `/login` для SDK и автоматизированных окружений. Имеет приоритет над учетными данными, хранящимися в цепочке ключей. Создайте один с помощью [`claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token). Если вы не запустите [`/login`](/docs/ru/authentication#authentication-precedence), Claude Code использует установленный вами токен для всего сеанса. Чтобы заменить истекший токен, создайте новый и перезагрузитесь |

333| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Удалено в версии 2.1.160 и теперь не работает. Ранее закреплял [быстрый режим](/docs/ru/fast-mode) на Claude Opus 4.6 вместо текущего значения по умолчанию. Opus 4.6 больше не поддерживает быстрый режим |333| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Удалено в версии 2.1.160 и теперь не работает. Ранее закреплял [fast mode](/docs/ru/fast-mode) на Claude Opus 4.6 вместо текущего значения по умолчанию. Opus 4.6 больше не поддерживает fast mode |

334| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Максимальная длина атрибутов OpenTelemetry, содержащих содержимое (ответы модели, содержимое инструмента, системные подсказки, необработанные тела API), маркер усечения включен, в единицах кода UTF-16 (по умолчанию: 61440, т.е. 60 КБ). Повысьте это только если ваш бэкенд телеметрии принимает значения атрибутов больше 64 КБ, или понизьте для уменьшения объема телеметрии. Требует Claude Code версии 2.1.214 или позже. См. [Мониторинг](/docs/ru/monitoring-usage) |334| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Максимальная длина атрибутов OpenTelemetry, содержащих содержимое (ответы модели, содержимое инструмента, системные подсказки, необработанные тела API), маркер усечения включен, в единицах кода UTF-16 (по умолчанию: 61440, т.е. 60 КБ). Повысьте это только, если ваш бэкэнд телеметрии принимает значения атрибутов больше 64 КБ, или понизьте для сокращения объема телеметрии. Требует Claude Code версии 2.1.214 или позже. См. [Мониторинг](/docs/ru/monitoring-usage) |

335| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Установите `1` для записи диагностических ошибок экспортера OpenTelemetry в stderr. По умолчанию эти ошибки появляются только с `--debug`, поэтому неправильно настроенный экспортер, такой как столкновение портов Prometheus, в противном случае завершается молча. Требует Claude Code версии 2.1.179 или позже. См. [Мониторинг](/docs/ru/monitoring-usage) |335| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Установите `1` для записи диагностических ошибок экспортера OpenTelemetry в stderr. По умолчанию эти ошибки появляются только с `--debug`, поэтому неправильно настроенный экспортер, такой как столкновение портов Prometheus, иначе завершается молча. Требует Claude Code версии 2.1.179 или позже. См. [Мониторинг](/docs/ru/monitoring-usage) |

336| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Таймаут в миллисекундах для сброса ожидающих пролетов OpenTelemetry (по умолчанию: 5000). См. [Мониторинг](/docs/ru/monitoring-usage) |336| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Таймаут в миллисекундах для сброса ожидающих spans OpenTelemetry (по умолчанию: 5000). См. [Мониторинг](/docs/ru/monitoring-usage) |

337| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Интервал для обновления динамических заголовков OpenTelemetry в миллисекундах (по умолчанию: 1740000 / 29 минут). См. [Динамические заголовки](/docs/ru/monitoring-usage#dynamic-headers) |337| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Интервал для обновления динамических заголовков OpenTelemetry в миллисекундах (по умолчанию: 1740000 / 29 минут). См. [Динамические заголовки](/docs/ru/monitoring-usage#dynamic-headers) |

338| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Таймаут в миллисекундах для завершения экспортера OpenTelemetry при выключении (по умолчанию: 2000). Увеличьте, если метрики отбрасываются при выходе. См. [Мониторинг](/docs/ru/monitoring-usage) |338| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Таймаут в миллисекундах для завершения экспортера OpenTelemetry при выключении (по умолчанию: 2000). Увеличьте, если метрики отбрасываются при выходе. См. [Мониторинг](/docs/ru/monitoring-usage) |

339| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Установите `1` для разрешения Claude Code запускать команду обновления вашего менеджера пакетов в фоновом режиме, когда доступна новая версия. Применяется к установкам Homebrew и WinGet. Другие менеджеры пакетов продолжают показывать команду обновления без запуска. См. [Автообновления](/docs/ru/setup#auto-updates) |339| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Установите `1` для разрешения Claude Code запускать команду обновления вашего менеджера пакетов в фоновом режиме, когда доступна новая версия. Применяется к установкам Homebrew и WinGet. Другие менеджеры пакетов продолжают показывать команду обновления без запуска. См. [Автоматические обновления](/docs/ru/setup#auto-updates) |

340| `CLAUDE_CODE_PERFORCE_MODE` | Установите `1` для включения защиты от записи с учетом Perforce. При установке Edit, Write и NotebookEdit завершаются с подсказкой `p4 edit <file>`, если целевой файл не имеет бита владельца-записи, который Perforce очищает на синхронизированных файлах до `p4 edit` открывает их. Это предотвращает Claude Code от обхода отслеживания изменений Perforce |340| `CLAUDE_CODE_PERFORCE_MODE` | Установите `1` для включения защиты от записи с учетом Perforce. Если установлено, Edit, Write и NotebookEdit завершаются с подсказкой `p4 edit <file>`, если целевой файл не имеет бита owner-write, который Perforce очищает на синхронизированных файлах до `p4 edit` их открывает. Это предотвращает обход Claude Code отслеживания изменений Perforce |

341| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Переопределить корневой каталог плагинов. Несмотря на имя, это устанавливает родительский каталог, а не сам кэш: рынки и кэш плагинов находятся в подкаталогах под этим путем. По умолчанию `~/.claude/plugins` |341| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Переопределить корневой каталог плагинов. Несмотря на имя, это устанавливает родительский каталог, а не сам кэш: рынки и кэш плагинов находятся в подкаталогах под этим путем. По умолчанию `~/.claude/plugins` |

342| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Таймаут в миллисекундах для операций git при установке или обновлении плагинов (по умолчанию: 120000). Увеличьте это значение для больших репозиториев или медленных сетевых подключений. См. [Операции Git истекают](/docs/ru/plugin-marketplaces#git-operations-time-out) |342| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Таймаут в миллисекундах для операций git при установке или обновлении плагинов (по умолчанию: 120000). Увеличьте это значение для больших репозиториев или медленных сетевых подключений. См. [Операции Git истекают](/docs/ru/plugin-marketplaces#git-operations-time-out) |

343| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Установите `1` для пропуска попытки повторного клонирования и сохранения использования существующей проверки рынка, когда обновление рынка не может достичь или аутентифицироваться на удаленном. Полезно в автономных или изолированных окружениях, где повторное клонирование завершилось бы так же. См. [Обновления рынка завершаются в автономных окружениях](/docs/ru/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |343| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Установите `1` для пропуска попытки повторного клонирования и сохранения использования существующей проверки рынка, когда обновление рынка не может достичь или аутентифицироваться на удаленном. Полезно в автономных или изолированных окружениях, где повторное клонирование завершилось бы так же. См. [Обновления рынка завершаются в автономных окружениях](/docs/ru/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |

344| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Установите `1` для клонирования сокращенных источников GitHub `owner/repo` через HTTPS вместо SSH. Применяется к установке и обновлению плагина, а также к `/plugin marketplace add` и `update`. Полезно в CI бегунах, контейнерах или любом окружении без настроенного ключа SSH для `github.com` |344| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Установите `1` для клонирования сокращенных источников GitHub `owner/repo` через HTTPS вместо SSH. Применяется к установке и обновлению плагина, а также к `/plugin marketplace add` и `update`. Полезно в CI runners, контейнерах или любом окружении без настроенного ключа SSH для `github.com` |

345| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Путь к одному или нескольким каталогам семян плагинов только для чтения, разделенным `:` на Unix или `;` на Windows. Используйте это для упаковки предварительно заполненного каталога плагинов в образ контейнера. Claude Code регистрирует рын из этих каталогов при запуске и использует предварительно кэшированные плагины без повторного клонирования. См. [Предварительное заполнение плагинов для контейнеров](/docs/ru/plugin-marketplaces#pre-populate-plugins-for-containers) |345| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Путь к одному или нескольким каталогам seed плагинов только для чтения, разделенным `:` на Unix или `;` на Windows. Используйте это для объединения предварительно заполненного катал ога плагинов в образ контейнера. Claude Code регистрирует рынки из этих каталогов при запуске и использует предварительно кэшированные плагины без повторного клонирования. См. [Предварительное заполнение плагинов для контейнеров](/docs/ru/plugin-marketplaces#pre-populate-plugins-for-containers) |

346| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Установите `1` для остановки Claude Code от передачи `-ExecutionPolicy Bypass` при порождении PowerShell для вызовов инструментов, hooks и команд строки состояния, и соблюдения политики выполнения машины вместо этого. По умолчанию Claude Code обходит политику выполнения в области процесса, поэтому скрипты `.ps1` и импорты модулей работают на установках Windows с ограничением по умолчанию. Обход области процесса никогда не переопределяет Group Policy `MachinePolicy` или `UserPolicy` независимо от этого параметра |346| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Установите `1` для остановки Claude Code от передачи `-ExecutionPolicy Bypass` при порождении PowerShell для вызовов инструментов, hooks и команд строки состояния, и соблюдения политики выполнения машины вместо этого. По умолчанию Claude Code обходит политику выполнения в области процесса, чтобы скрипты `.ps1` и импорты модулей работали на установках Windows с ограничением по умолчанию. Обход области процесса никогда не переопределяет Group Policy `MachinePolicy` или `UserPolicy` независимо от этого параметра |

347| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Потолок в миллисекундах на ожидание простоя для фоновых подагентов и workflows после финального хода в [неинтерактивном режиме](/docs/ru/headless#background-tasks-at-exit) с флагом `-p`. Ожидание простоя начинается заново каждый раз, когда Claude берет ход для обработки результата фона. По умолчанию: `600000` или 10 минут. Когда ожидание простоя достигает потолка, Claude Code перестает ждать оставшихся фоновых задач и выходит. Установите `0` для неопределенного ожидания. Этот ограничение отделено от пятисекундного периода благодарности, который применяется к простым фоновым оболочкам. Требует Claude Code версии 2.1.182 или позже |347| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Потолок в миллисекундах на ожидание простоя для фоновых subagents и workflows после финального хода в [неинтерактивном режиме](/docs/ru/headless#background-tasks-at-exit) с флагом `-p`. Ожидание простоя начинается заново каждый раз, когда Claude берет ход для обработки результата фона. По умолчанию: `600000` или 10 минут. Когда ожидание простоя достигает потолка, Claude Code перестает ждать оставшихся фоновых задач и выходит. Установите `0` для неопределенного ожидания. Этот ограничение отделено от пятисекундного периода благодарности, который применяется к простым фоновым оболочкам. Требует Claude Code версии 2.1.182 или позже |

348| `CLAUDE_CODE_PROCESS_WRAPPER` | Запустить процессы, которые Claude Code запускает из своего собственного двоичного файла, такие как фоновый сервис, который размещает сеансы [представления агента](/docs/ru/agent-view), через корпоративный средство запуска, заданное как префикс argv, такой как `/opt/corp/launcher`. Установите это в блоке `env` пользовательских или [управляемых параметров](/docs/ru/managed-settings), а не как экспорт оболочки, поэтому отсоединенный фоновый сервис его наследует; параметры проекта и локальные параметры не могут его установить. Эквивалентно параметру [`processWrapper`](/docs/ru/settings-reference#processwrapper), который требует Claude Code версии 2.1.210 или позже; эта переменная имеет приоритет при установке обоих. Расширение VS Code настраивает свой собственный средство запуска отдельно через параметр `claudeProcessWrapper`. Игнорируется на Windows. См. [Запустить Claude Code за корпоративным средством запуска](/docs/ru/corporate-launcher) для формата значения, что охватывает средство запуска и контракт, который должно удовлетворять средство запуска. Требует Claude Code версии 2.1.208 или позже |348| `CLAUDE_CODE_PROCESS_WRAPPER` | Запустить процессы, которые Claude Code запускает из своего собственного двоичного файла, такие как фоновый сервис, который размещает сеансы [представления агента](/docs/ru/agent-view), через корпоративный средство запуска, заданное как префикс argv, такой как `/opt/corp/launcher`. Установите его в блоке `env` пользовательских или [управляемых параметров](/docs/ru/managed-settings), а не как экспорт оболочки, чтобы отделенный фоновый сервис его унаследовал; параметры проекта и локальные параметры не могут его установить. Эквивалентно параметру [`processWrapper`](/docs/ru/settings-reference#processwrapper), который требует Claude Code версии 2.1.210 или позже; эта переменная имеет приоритет при установке обоих. Расширение VS Code настраивает свой собственный средство запуска отдельно через параметр `claudeProcessWrapper`. Игнорируется на Windows. См. [Запустить Claude Code за корпоративным средством запуска](/docs/ru/corporate-launcher) для формата значения, что охватывает средство запуска и контракт, который должно удовлетворять средство запуска. Требует Claude Code версии 2.1.208 или позже |

349| `CLAUDE_CODE_PROJECT_DIR_NAME` | Установите вместе с `CLAUDE_CONFIG_DIR` для выбора имени каталога `projects/`, в котором Claude Code хранит стенограммы этого сеанса и автоматическую память, вместо одного, полученного из пути рабочего каталога. Например, запуск Claude Code с `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` хранит их в `/srv/tenant-a/projects/work/`. Claude Code игнорирует эту переменную, когда `CLAUDE_CONFIG_DIR` не установлен, и читает ее только из окружения, которое вы запускаете `claude` из, никогда из блока параметров `env` [параметров](#in-settings-files). См. [Назовите каталог проекта сами](/docs/ru/sessions#name-the-project-directory-yourself). Требует Claude Code версии 2.1.234 или позже |349| `CLAUDE_CODE_PROJECT_DIR_NAME` | Установите вместе с `CLAUDE_CONFIG_DIR` для выбора имени каталога `projects/`, в котором Claude Code хранит стенограммы этого сеанса и автоматическую память, вместо одного, полученного из пути рабочего каталога. Например, запуск Claude Code с `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` хранит их в `/srv/tenant-a/projects/work/`. Claude Code игнорирует эту переменную, когда `CLAUDE_CONFIG_DIR` не установлен, и читает ее только из окружения, из которого вы запускаете `claude`, никогда из блока параметров `env` [параметров](#in-settings-files). См. [Назовите каталог проекта сами](/docs/ru/sessions#name-the-project-directory-yourself). Требует Claude Code версии 2.1.234 или позже |

350| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Установите `5m` или `1h`, единственные значения, которые Claude Code принимает, для выбора [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) для основного разговора: ваши интерактивные, `-p` и SDK ходы, плюс помощники, которые работают встроенно с ними. Имеет приоритет над параметром `promptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, и `FORCE_PROMPT_CACHING_5M` переопределяет это. API выставляет счета за записи кэша на 1 час по более высокой ставке. Требует Claude Code версии 2.1.242 или позже |350| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Установите `5m` или `1h`, единственные значения, которые Claude Code принимает, для выбора [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) для основного разговора: ваши интерактивные, `-p` и SDK ходы, плюс помощники, которые работают встроенно с ними. Имеет приоритет над параметром `promptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, и `FORCE_PROMPT_CACHING_5M` переопределяет его. API выставляет счета за записи кэша на 1 час по более высокой ставке. Требует Claude Code версии 2.1.242 или позже |

351| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Установите `1` для распространения контекста трассировки W3C, когда `ANTHROPIC_BASE_URL` указывает на пользовательский прокси. Распространение охватывает заголовок `traceparent` на запросах модели и HTTP MCP и переменную окружения `TRACEPARENT` для подпроцессов Bash, PowerShell и hook. По умолчанию распространение включено только при прямом подключении к API Anthropic. Добавлено в версии 2.1.152. См. [Трассировки (бета)](/docs/ru/monitoring-usage#traces-beta) |351| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Установите `1` для распространения контекста трассировки W3C, когда `ANTHROPIC_BASE_URL` указывает на пользовательский прокси. Распространение охватывает заголовок `traceparent` на запросах модели и HTTP MCP и переменную окружения `TRACEPARENT` для подпроцессов Bash, PowerShell и hook. По умолчанию распространение включено только при прямом подключении к API Anthropic. Добавлено в версии 2.1.152. См. [Трассировки (бета)](/docs/ru/monitoring-usage#traces-beta) |

352| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Установлено хост-платформами, которые встраивают Claude Code и управляют маршрутизацией поставщика модели от его имени. При установке Claude Code игнорирует переменные выбора поставщика, конечной точки и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY` в файлах параметров, поэтому пользовательские параметры не могут переопределить маршрутизацию хоста. Claude Code также игнорирует ключи выбора модели, такие как `model`, `fallbackModel` и `modelOverrides` в [управляемых параметрах](/docs/ru/managed-settings), какой бы управляемый источник их не доставлял, поэтому конфигурация модели хоста имеет приоритет над устаревшей закрепленной моделью. Claude Code также игнорирует переменные выбора модели, такие как `ANTHROPIC_MODEL` и семейство `ANTHROPIC_DEFAULT_*_MODEL` в управляемом блоке `env`; список разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) в управляемых параметрах по-прежнему применяется, если только хост не предоставляет свой собственный. Claude Code также пропускает автоматический отказ от телеметрии, который он в противном случае применяет на сторонних поставщиках, таких как Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform и Microsoft Foundry, поэтому телеметрия следует стандартному отказу `DISABLE_TELEMETRY`. См. [Поведение по умолчанию по поставщику API](/docs/ru/data-usage#default-behaviors-by-api-provider) |352| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Установлено хост-платформами, которые встраивают Claude Code и управляют маршрутизацией поставщика модели от его имени. Если установлено, Claude Code игнорирует переменные выбора поставщика, конечной точки и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY` в файлах параметров, поэтому пользовательские параметры не могут переопределить маршрутизацию хоста. Claude Code также игнорирует ключи выбора модели, такие как `model`, `fallbackModel` и `modelOverrides` в [управляемых параметрах](/docs/ru/managed-settings), какой бы управляемый источник их не доставлял, поэтому конфигурация модели хоста имеет приоритет над устаревшей закрепленной моделью. Claude Code также игнорирует переменные выбора модели, такие как `ANTHROPIC_MODEL` и семейство `ANTHROPIC_DEFAULT_*_MODEL` в управляемом блоке `env`; список разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) в управляемых параметрах по-прежнему применяется, если только хост не предоставляет свой собственный. Claude Code также пропускает автоматический отказ от телеметрии, который он иначе применяет на сторонних поставщиках, таких как Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform и Microsoft Foundry, поэтому телеметрия следует стандартному отказу `DISABLE_TELEMETRY`. См. [Поведение по умолчанию по поставщику API](/docs/ru/data-usage#default-behaviors-by-api-provider) |

353| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Установите `1` для разрешения прокси выполнять разрешение DNS вместо вызывающей стороны. Opt-in для окружений, где прокси должен обрабатывать разрешение имен хостов |353| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Установите `1` для разрешения прокси выполнять разрешение DNS вместо вызывающей стороны. Opt-in для окружений, где прокси должен обрабатывать разрешение имен хостов |

354| `CLAUDE_CODE_REMOTE` | Установите автоматически на `true`, когда Claude Code работает как [облачный сеанс](/docs/ru/claude-code-on-the-web). Прочитайте это из hook или скрипта настройки для обнаружения, находитесь ли вы в облачном сеансе |354| `CLAUDE_CODE_REMOTE` | Установите автоматически на `true`, когда Claude Code работает как [облачный сеанс](/docs/ru/claude-code-on-the-web). Прочитайте это из hook или скрипта настройки для обнаружения, находитесь ли вы в облачном сеансе |

355| `CLAUDE_CODE_REMOTE_SESSION_ID` | Установите автоматически в [облачных сеансах](/docs/ru/claude-code-on-the-web) на ID текущего сеанса. Прочитайте это для построения ссылки обратно на стенограмму сеанса. См. [Ссылка вывода обратно на сеанс](/docs/ru/cloud-environments#link-output-back-to-the-session) |355| `CLAUDE_CODE_REMOTE_SESSION_ID` | Установите автоматически в [облачных сеансах](/docs/ru/claude-code-on-the-web) на ID текущего сеанса. Прочитайте это для построения ссылки обратно на стенограмму сеанса. См. [Ссылка вывода обратно на сеанс](/docs/ru/cloud-environments#link-output-back-to-the-session) |

356| `CLAUDE_CODE_RESTRICTED` | Установите `1` для запуска сеанса в ограниченном режиме, то же самое, что передача [`--restricted`](/docs/ru/cli-reference#cli-flags). Claude Code игнорирует эту переменную в блоке `env` файла параметров. Требует Claude Code версии 2.1.248 или позже |356| `CLAUDE_CODE_RESTRICTED` | Установите `1` для запуска сеанса в ограниченном режиме, то же самое, что передача [`--restricted`](/docs/ru/cli-reference#cli-flags). Claude Code игнорирует эту переменную в блоке `env` файла параметров. Требует Claude Code версии 2.1.248 или позже |

357| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Установите `1` для автоматического возобновления, если предыдущий сеанс завершился в середине хода. Используется в режиме SDK, поэтому модель продолжает без требования SDK повторно отправить подсказку. Чтобы отключить это, отмените установку переменной или установите ее на `0`. До версии 2.1.221 Claude Code игнорировал `0` и другие ложные значения, поэтому установка `0` по-прежнему вызывала возобновление в неинтерактивном режиме и отмена установки переменной была единственным способом отключить это |357| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Установите `1` для автоматического возобновления, если предыдущий сеанс завершился в середине хода. Используется в режиме SDK, чтобы модель продолжала без требования SDK повторно отправлять подсказку. Чтобы отключить это, отмените установку переменной или установите ее на `0`. До версии 2.1.221 Claude Code игнорировал `0` и другие ложные значения, поэтому установка `0` по-прежнему вызывала возобновление в неинтерактивном режиме, и отмена установки переменной была единственным способом отключить это |

358| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Максимальный возраст в миллисекундах последнего сообщения стенограммы для сеанса, который завершился в середине хода, для автоматического продолжения при возобновлении. Когда последнее сообщение старше этого ограничения, Claude Code пропускает как автоматическое возобновление `CLAUDE_CODE_RESUME_INTERRUPTED_TURN`, так и введенное сообщение продолжения `CLAUDE_CODE_RESUME_PROMPT`, и сеанс начинается неактивным, чтобы вы продолжили явно. Отмена установки или `0` означает отсутствие ограничения, за исключением того, что ход, чей последний запрос завершился с ошибкой API, возобновляется только пока эта ошибка менее шести часов. Положительное значение ограничивает каждый ход, включая те; отрицательное или нечисловое значение применяет ограничение в один час. Скрипты порождения для долгоживущих агентов могут установить это, чтобы перезагрузка против старой стенограммы не повторно запускала устаревшую подсказку. Claude Code устанавливает ограничение в один час сам при перезагрузке сбойного сеанса [представления агента](/docs/ru/agent-view), который унаследовал свой разговор из интерактивного сеанса. Требует Claude Code версии 2.1.211 или позже |358| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Максимальный возраст в миллисекундах последнего сообщения стенограммы для сеанса, который завершился в середине хода, для автоматического продолжения при возобновлении. Когда последнее сообщение старше этого ограничения, Claude Code пропускает как автоматическое возобновление `CLAUDE_CODE_RESUME_INTERRUPTED_TURN`, так и введенное сообщение продолжения `CLAUDE_CODE_RESUME_PROMPT`, и сеанс начинается неактивным, чтобы вы продолжили явно. Отсутствие или `0` означает отсутствие ограничения, за исключением того, что ход, чей последний запрос завершился с ошибкой API, возобновляется только пока эта ошибка менее шести часов. Положительное значение ограничивает каждый ход, включая те; отрицательное или нечисловое значение применяет ограничение в один час. Скрипты порождения для долгоживущих агентов могут установить это, чтобы перезагрузка против старой стенограммы не повторно запускала устаревшую подсказку. Claude Code устанавливает ограничение в один час сам, когда перезагружает сбойный сеанс [представления агента](/docs/ru/agent-view), который унаследовал свой разговор из интерактивного сеанса. Требует Claude Code версии 2.1.211 или позже |

359| `CLAUDE_CODE_RESUME_PROMPT` | Переопределить сообщение продолжения, введенное при возобновлении сеанса, который завершился в середине хода. По умолчанию `Continue from where you left off.`. Скрипты порождения для долгоживущих агентов могут установить это на более директивное сообщение загрузки. Пустая строка использует значение по умолчанию |359| `CLAUDE_CODE_RESUME_PROMPT` | Переопределить сообщение продолжения, введенное при возобновлении сеанса, который завершился в середине хода. По умолчанию `Continue from where you left off.`. Скрипты порождения для долгоживущих агентов могут установить это на более директивное сообщение загрузки. Пустая строка использует значение по умолчанию |

360| `CLAUDE_CODE_RETRY_WATCHDOG` | Установите `1` для неконтролируемых сеансов, таких как оценочные обвязки, CI задачи или удаленные рабочие. Повторяет ошибки емкости `429` и `529` неопределенно вместо отказа после попыток `CLAUDE_CODE_MAX_RETRIES`. Claude Code завершается сразу, когда запрос стандартной скорости получает `429`, который сообщает о лимите расходов или исчерпанных кредитах использования, даже один из [ограничения расходов шлюза](/docs/ru/errors#spend-limit-reached), который сбрасывается по расписанию. До версии 2.1.239 сторожевой таймер повторял эти неопределенно. Для запросов быстрого режима см. [Обработка ограничений скорости](/docs/ru/fast-mode#handle-rate-limits). Сторожевой таймер отступает до 5 минут между попытками или до сброса лимита, когда ответ несет время сброса ограничения скорости, поэтому сеанс, который попадает на лимит использования, ждет оставшегося окна. На версии 2.1.199 или позже это также повышает количество повторов по умолчанию для других переходных ошибок, таких как ошибки сервера, таймауты и отброшенные подключения, до 300, примерно три часа отступления, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. Требует Claude Code версии 2.1.186 или позже |360| `CLAUDE_CODE_RETRY_WATCHDOG` | Установите `1` для неконтролируемых сеансов, таких как harnesses eval, CI jobs или удаленные рабочие. Повторяет ошибки емкости `429` и `529` неопределенно вместо отказа после попыток `CLAUDE_CODE_MAX_RETRIES`. Claude Code завершается сразу, когда запрос стандартной скорости получает `429`, который сообщает об ограничении расходов или исчерпанных кредитах использования, даже один из [ограничения расходов шлюза](/docs/ru/errors#spend-limit-reached), который сбрасывается по расписанию. До версии 2.1.239 сторожевой таймер повторял эти неопределенно. Для запросов fast mode см. [Обработка ограничений скорости](/docs/ru/fast-mode#handle-rate-limits). Сторожевой таймер отступает до 5 минут между попытками или до сброса ограничения, когда ответ несет время сброса ограничения скорости, поэтому сеанс, который попадает на ограничение использования, ждет оставшегося окна. На версии 2.1.199 или позже он также повышает количество повторов по умолчанию для других переходных ошибок, таких как ошибки сервера, таймауты и отброшенные подключения, до 300, примерно три часа отступления, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. Требует Claude Code версии 2.1.186 или позже |

361| `CLAUDE_CODE_SAFE_MODE` | Установите `1` для запуска в безопасном режиме: CLAUDE.md, skills, плагины, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, workflows, пользовательские темы, пользовательские сочетания клавиш, команды строки состояния и предложения файлов, LSP серверы и автоматическая память не загружаются для устранения неполадок сломанной конфигурации. Политика управляемых параметров по-прежнему применяется, включая hooks, настроенные политикой, строку состояния и команды предложения файлов; управляемые плагины, управляемые skills, управляемые CLAUDE.md и MCP серверы, настроенные политикой, не загружаются. Эквивалентно передаче [`--safe-mode`](/docs/ru/cli-reference#cli-flags). Непосредственно порожденные дочерние процессы наследуют переменную |361| `CLAUDE_CODE_SAFE_MODE` | Установите `1` для запуска в безопасном режиме: CLAUDE.md, skills, плагины, hooks, серверы MCP, пользовательские команды и агенты, стили вывода, workflows, пользовательские темы, пользовательские сочетания клавиш, команды строки состояния и предложения файлов, серверы LSP и автоматическая память не загружаются для устранения неполадок сломанной конфигурации. Политика управляемых параметров по-прежнему применяется, включая hooks, настроенные политикой, строку состояния и команды предложения файлов; управляемые плагины, управляемые skills, управляемые CLAUDE.md и серверы MCP, настроенные политикой, не загружаются. Эквивалентно передаче [`--safe-mode`](/docs/ru/cli-reference#cli-flags). Непосредственно порожденные дочерние процессы наследуют переменную |

362| `CLAUDE_CODE_SCRIPT_CAPS` | JSON объект, ограничивающий, сколько раз конкретные скрипты могут быть вызваны за сеанс, когда установлен `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Ключи — это подстроки, сопоставленные с текстом команды; значения — это ограничения количества вызовов целых чисел. Например, `{"deploy.sh": 2}` позволяет `deploy.sh` быть вызванным максимум дважды. Сопоставление основано на подстроке, поэтому трюки расширения оболочки, такие как `./scripts/deploy.sh $(evil)`, по-прежнему считаются против ограничения. Веерное расширение во время выполнения через `xargs` или `find -exec` не обнаруживается; это контроль защиты в глубину |362| `CLAUDE_CODE_SCRIPT_CAPS` | Объект JSON, ограничивающий, сколько раз конкретные скрипты могут быть вызваны за сеанс, когда установлен `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Ключи — это подстроки, сопоставленные с текстом команды; значения — это ограничения количества вызовов. Например, `{"deploy.sh": 2}` позволяет `deploy.sh` быть вызванным максимум дважды. Сопоставление основано на подстроке, поэтому трюки расширения оболочки, такие как `./scripts/deploy.sh $(evil)`, по-прежнему считаются против ограничения. Разветвление во время выполнения через `xargs` или `find -exec` не обнаруживается; это контроль защиты в глубину |

363| `CLAUDE_CODE_SCROLL_SPEED` | Установить множитель скорости прокрутки колеса мыши в [полноэкранном рендере](/docs/ru/fullscreen#mouse-wheel-scrolling). Принимает любое положительное значение до 20, включая дробные значения ниже 1, такие как `0.5`, для замедления ускоренной прокрутки трекпада и колеса в терминалах, которые уже усиливают события колеса. Установите `3` для соответствия `vim`, если ваш терминал отправляет одно событие колеса за выемку без усиления. Игнорируется в интегрированном терминале JetBrains IDE, где Claude Code использует свою собственную обработку прокрутки |363| `CLAUDE_CODE_SCROLL_SPEED` | Установить множитель скорости прокрутки колеса мыши в [полноэкранном рендеринге](/docs/ru/fullscreen#mouse-wheel-scrolling). Принимает любое положительное значение до 20, включая дробные значения ниже 1, такие как `0.5`, для замедления ускоренной прокрутки трекпада и колеса в терминалах, которые уже усиливают события колеса. Установите `3` для соответствия `vim`, если ваш терминал отправляет одно событие колеса за выемку без усиления. Игнорируется в интегрированном терминале JetBrains IDE, где Claude Code использует свою собственную обработку прокрутки |

364| `CLAUDE_CODE_SEND_FEEDBACK` | Установите `0` для отключения [отзывов, составленных Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior) для сеанса. Установите `1` для включения там, где ваша учетная запись уже имеет доступ; переменная не может предоставить доступ сама, и другие переключатели, которые отключают отзывы, такие как `DISABLE_FEEDBACK_COMMAND` и значение `off` параметра [`feedbackDrafts`](/docs/ru/settings-reference#feedbackdrafts), по-прежнему применяются |364| `CLAUDE_CODE_SEND_FEEDBACK` | Установите `0` для отключения [обратной связи, составленной Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior) для сеанса. Установите `1` для включения там, где ваша учетная запись уже имеет доступ; переменная не может предоставить доступ сама, и другие переключатели, которые отключают обратную связь, такие как `DISABLE_FEEDBACK_COMMAND` и значение `off` параметра [`feedbackDrafts`](/docs/ru/settings-reference#feedbackdrafts), по-прежнему применяются |

365| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Переопределить бюджет времени в миллисекундах для [SessionEnd](/docs/ru/hooks#sessionend) hooks. Значение также является таймаутом для каждого hook, который не устанавливает свой собственный `timeout`. Применяется к выходу сеанса, `/clear` и переключению сеансов через интерактивный `/resume`. По умолчанию бюджет составляет 1.5 секунды, автоматически повышается до наивысшего настроенного `timeout` для каждого hook в файлах параметров, до 60 секунд. Таймауты на hooks, предоставленные плагинами, не повышают бюджет |365| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Переопределить бюджет времени в миллисекундах для [SessionEnd](/docs/ru/hooks#sessionend) hooks. Значение также является таймаутом для каждого hook, который не устанавливает свой собственный `timeout`. Применяется к выходу сеанса, `/clear` и переключению сеансов через интерактивный `/resume`. По умолчанию бюджет составляет 1.5 секунды, автоматически повышается до наивысшего настроенного `timeout` для каждого hook в файлах параметров, до 60 секунд. Таймауты на hooks, предоставленные плагинами, не повышают бюджет |

366| `CLAUDE_CODE_SESSION_ID` | Установите автоматически на текущий ID сеанса в подпроцессах инструментов Bash и PowerShell, подпроцессах [команды hook](/docs/ru/hooks) и подпроцессах [MCP сервера](/docs/ru/mcp) stdio. Для Bash, PowerShell и hooks это совпадает с полем `session_id` в входных данных JSON hook и обновляется на `/clear`. Подпроцесс MCP сервера сохраняет ID, с которым он был порожден. На `--resume <session-id>` он получает возобновленный ID, совпадающий с hooks и Bash. На `--continue` или `--resume` без явного ID он может получить начальный ID запуска вместо этого. Используйте для корреляции скриптов и внешних инструментов с сеансом Claude Code, который их запустил |366| `CLAUDE_CODE_SESSION_ID` | Установите автоматически на текущий ID сеанса в подпроцессах инструментов Bash и PowerShell, подпроцессах [hook command](/docs/ru/hooks) и подпроцессах [MCP server](/docs/ru/mcp) stdio. Для Bash, PowerShell и hooks это соответствует полю `session_id` в входных данных JSON hook и обновляется на `/clear`. Подпроцесс сервера MCP сохраняет ID, с которым он был порожден. На `--resume <session-id>` он получает возобновленный ID, соответствующий hooks и Bash. На `--continue` или `--resume` без явного ID он может получить начальный ID запуска вместо этого. Используйте для корреляции скриптов и внешних инструментов с сеансом Claude Code, который их запустил |

367| `CLAUDE_CODE_SHELL` | Установить оболочку, которую Claude Code использует для запуска команд инструмента Bash. Принимает путь к двоичному файлу `bash` или `zsh`, например `/opt/homebrew/bin/bash`. Другие оболочки, такие как `fish`, не поддерживаются. Если значение не является рабочим путем `bash` или `zsh`, Claude Code игнорирует его и возвращается к автоопределению. Автоопределение использует ваш `$SHELL`, когда он указывает на `bash` или `zsh`, в противном случае он выбирает первый рабочий `zsh`, затем `bash`, найденный на вашем `PATH` и стандартных местах установки |367| `CLAUDE_CODE_SHELL` | Установить оболочку, которую Claude Code использует для запуска команд инструмента Bash. Принимает путь к двоичному файлу `bash` или `zsh`, например `/opt/homebrew/bin/bash`. Другие оболочки, такие как `fish`, не поддерживаются. Если значение не является рабочим путем `bash` или `zsh`, Claude Code игнорирует его и возвращается к автоопределению. Автоопределение использует ваш `$SHELL`, когда он указывает на `bash` или `zsh`, в противном случае он выбирает первый рабочий `zsh`, затем `bash`, найденный на вашем `PATH` и стандартных местах установки |

368| `CLAUDE_CODE_SHELL_PREFIX` | Префикс команды, который оборачивает команды оболочки, которые Claude Code порождает: вызовы инструмента Bash, команды [hook](/docs/ru/hooks), команды [строки состояния](/docs/ru/statusline) и команды запуска [MCP сервера](/docs/ru/mcp) stdio. Hooks PowerShell и hooks в форме exec работают без префикса. Полезно для логирования или аудита. Установка пути к голому исполняемому файлу, такого как `/path/to/logger.sh`, запускает каждую команду как `/path/to/logger.sh '<command>'`. Обертка получает командную строку как один аргумент, заключенный в кавычки оболочки, в `$1`, поэтому обертка должна повторно оценить `$1` с оболочкой, например `exec bash -c "$1"`. Обработка `$1` как пути к голому исполняемому файлу нарушает серверы stdio MCP, которые передают аргументы, такие как `npx -y <package>`. Для вызовов инструмента Bash `$1` содержит полный вызов оболочки, который собирает Claude Code, включая настройку окружения, а не только команду, которую запустил Claude |368| `CLAUDE_CODE_SHELL_PREFIX` | Префикс команды, который оборачивает команды оболочки, которые Claude Code порождает: вызовы инструмента Bash, [hook](/docs/ru/hooks) команды, [status line](/docs/ru/statusline) команды и команды запуска [MCP server](/docs/ru/mcp) stdio. Hooks PowerShell и hooks в форме exec работают без префикса. Полезно для логирования или аудита. Установка пути к простому исполняемому файлу, такого как `/path/to/logger.sh`, запускает каждую команду как `/path/to/logger.sh '<command>'`. Обертка получает командную строку как один аргумент, заключенный в кавычки оболочки, в `$1`, поэтому обертка должна повторно оценить `$1` с помощью оболочки, например `exec bash -c "$1"`. Обработка `$1` как пути к простому исполняемому файлу нарушает серверы MCP stdio, которые передают аргументы, такие как `npx -y <package>`. Для вызовов инструмента Bash `$1` содержит полный вызов оболочки, который Claude Code собирает, включая настройку окружения, а не только команду, которую запустил Claude |

369| `CLAUDE_CODE_SIMPLE` | Установите `1` для запуска с минимальной системной подсказкой и только инструментами Bash, чтения файлов и редактирования файлов. Инструменты MCP из `--mcp-config` по-прежнему доступны. Отключает автоопределение hooks, skills, пользовательских команд, подагентов, плагинов, MCP серверов, автоматической памяти и CLAUDE.md. Skills в каталоге, который вы передаете с `--add-dir`, по-прежнему загружаются. Токены OAuth и учетные данные связки ключей не читаются, поэтому аутентификация Anthropic должна поступать из `ANTHROPIC_API_KEY` или `apiKeyHelper` в `--settings`. Эквивалентно передаче [`--bare`](/docs/ru/headless#start-faster-with-bare-mode) |369| `CLAUDE_CODE_SIMPLE` | Установите `1` для запуска с минимальной системной подсказкой и только инструментами Bash, чтения файлов и редактирования файлов. Инструменты MCP из `--mcp-config` по-прежнему доступны. Отключает автоопределение hooks, skills, пользовательских команд, subagents, плагинов, серверов MCP, автоматической памяти и CLAUDE.md. Skills в каталоге, который вы передаете с помощью `--add-dir`, по-прежнему загружаются. Токены OAuth и учетные данные цепочки ключей не читаются, поэтому аутентификация Anthropic должна поступать из `ANTHROPIC_API_KEY` или `apiKeyHelper` в `--settings`. Эквивалентно передаче [`--bare`](/docs/ru/headless#start-faster-with-bare-mode) |

370| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Установите `1` для использования более короткой системной подсказки и сокращенных описаний инструментов на любой модели. Установите `0`, `false`, `no` или `off` для отказа даже на моделях, где эксперимент или конфигурация сервера в противном случае включили бы это. Полный набор инструментов, hooks, MCP серверы и обнаружение CLAUDE.md остаются включенными |370| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Установите `1` для использования более короткой системной подсказки и сокращенных описаний инструментов на любой модели. Установите `0`, `false`, `no` или `off` для отказа даже на моделях, где эксперимент или конфигурация сервера иначе включили бы это. Полный набор инструментов, обнаружение hooks, серверы MCP и обнаружение CLAUDE.md остаются включенными |

371| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Пропустить аутентификацию на стороне клиента для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), для шлюзов, которые подписывают запросы сами |371| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Пропустить аутентификацию на стороне клиента для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), для шлюзов, которые подписывают запросы сами |

372| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Установите `1` для отключения кэша в процессе учетных данных, разрешенных из цепочки поставщика учетных данных AWS по умолчанию, поэтому Claude Code разрешает цепочку при каждом запросе API. С отключенным кэшем профиль, поддерживаемый SSO, запрашивает учетные данные из IAM Identity Center при каждом запросе. См. [кэширование учетных данных и таймаут разрешения](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout). Требует Claude Code версии 2.1.207 или позже |372| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Установите `1` для отключения кэша в процессе учетных данных, разрешенных из цепочки поставщика учетных данных AWS по умолчанию, поэтому Claude Code разрешает цепочку при каждом запросе API. С отключенным кэшем профиль, поддерживаемый SSO, запрашивает учетные данные из IAM Identity Center при каждом запросе. См. [кэширование учетных данных и таймаут разрешения](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout). Требует Claude Code версии 2.1.207 или позже |

373| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock (например, при использовании LLM gateway) |373| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock (например, при использовании LLM gateway) |

374| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Установите `1` для обработки неудачной проверки доступности [быстрого режима](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) как доступной, для сетей, которые блокируют прямой запрос проверки на `api.anthropic.com`. Claude Code по-прежнему соблюдает ответ "отключено вашей организацией" |374| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Установите `1` для обработки неудачной проверки доступности [fast mode](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) как доступной для сетей, которые блокируют прямой запрос проверки на `api.anthropic.com`. Claude Code по-прежнему соблюдает ответ "отключено вашей организацией" |

375| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Установите `1` для пропуска проверки доступности [быстрого режима](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) на стороне клиента, для прокси, которые перехватывают запрос проверки, а не отказывают в нем. API по-прежнему отклоняет запросы быстрого режима, когда ваша организация отключила быстрый режим |375| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Установите `1` для пропуска проверки доступности [fast mode](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) на стороне клиента для прокси, которые перехватывают запрос проверки, а не отказывают в нем. API по-прежнему отклоняет запросы fast mode, когда ваша организация отключила fast mode |

376| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Пропустить аутентификацию Azure для Microsoft Foundry, для прокси или шлюза, который вводит свой собственный заголовок `Authorization`. Claude Code отправляет запросы без учетных данных Azure и сохраняет заголовок `Authorization`, который вы предоставляете, например через `ANTHROPIC_CUSTOM_HEADERS`. Игнорируется, когда установлены `ANTHROPIC_FOUNDRY_API_KEY` или `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. До версии 2.1.203 эта переменная оставляла клиент Microsoft Foundry неспособным отправлять запросы, если ключ API также не был установлен |376| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Пропустить аутентификацию Azure для Microsoft Foundry для прокси или шлюза, который вводит свой собственный заголовок `Authorization`. Claude Code отправляет запросы без учетных данных Azure и сохраняет заголовок `Authorization`, который вы предоставляете, например через `ANTHROPIC_CUSTOM_HEADERS`. Игнорируется, когда установлены `ANTHROPIC_FOUNDRY_API_KEY` или `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. До версии 2.1.203 эта переменная оставляла клиент Microsoft Foundry неспособным отправлять запросы, если ключ API также не был установлен |

377| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock Mantle (например, при использовании LLM gateway) |377| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock Mantle (например, при использовании LLM gateway) |

378| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Установите `1` для пропуска записи истории подсказок и стенограмм сеансов на диск. Сеансы, запущенные с этой переменной, не появляются в `--resume`, `--continue` или истории стрелки вверх. Полезно для эфемерных скриптовых сеансов |378| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Установите `1` для пропуска записи истории подсказок и стенограмм сеансов на диск. Сеансы, запущенные с этой переменной, не появляются в `--resume`, `--continue` или истории стрелок вверх. Полезно для эфемерных скриптовых сеансов |

379| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Пропустить аутентификацию Google для Google Cloud's Agent Platform (например, при использовании LLM gateway) |379| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Пропустить аутентификацию Google для Google Cloud's Agent Platform (например, при использовании LLM gateway) |

380| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Установите `1` для того, чтобы сеанс, запущенный с `--output-format stream-json`, написал [сообщение результата, называющее причину отказа Claude Code в запуске](/docs/ru/agent-sdk/typescript#startup_failure_reason) для отказов при запуске, которые в противном случае заканчиваются только stderr. Требует Claude Code версии 2.1.274 или позже |380| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Установите `1` для того, чтобы сеанс, запущенный с `--output-format stream-json`, написал [сообщение результата, называющее причину отказа Claude Code в запуске](/docs/ru/agent-sdk/typescript#startup_failure_reason) для сбоев запуска, которые иначе заканчиваются только stderr. Требует Claude Code версии 2.1.274 или позже |

381| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Максимальное количество последовательных раз, когда [Stop](/docs/ru/hooks#stop) или [SubagentStop](/docs/ru/hooks#subagentstop) hook может блокировать завершение хода перед тем как Claude Code переопределяет это и завершает ход в любом случае (по умолчанию: 8). Установите `0` для отключения ограничения. Повысьте это, если ваш hook законно нуждается в большем количестве итераций для разрешения |381| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Максимальное количество последовательных раз, когда [Stop](/docs/ru/hooks#stop) или [SubagentStop](/docs/ru/hooks#subagentstop) hook может блокировать завершение хода перед тем, как Claude Code переопределит его и завершит ход в любом случае (по умолчанию: 8). Установите `0` для отключения ограничения. Повысьте это, если ваш hook законно требует больше итераций для разрешения |

382| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель по умолчанию для [подагентов](/docs/ru/sub-agents#choose-a-model), товарищей [команды агентов](/docs/ru/agent-teams#specify-teammates-and-models) и агентов [workflow](/docs/ru/workflows), которым не назначена модель другим способом. Принимает псевдоним, такой как `haiku`, или полное имя модели. Два источника имеют приоритет над ним: модель, которую Claude передает при порождении агента, и поле `model` в определении агента, включая `inherit`. Чтобы изменить это, установите [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ru/sub-agents#run-every-subagent-on-one-model). См. [Выбрать модель](/docs/ru/sub-agents#choose-a-model) для полного порядка. Установка его на `inherit` — это то же самое, что оставить его не установленным. До версии 2.1.251 эта переменная переопределяла как модель для каждого вызова, так и поле `model` определения |382| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель по умолчанию для [subagents](/docs/ru/sub-agents#choose-a-model), товарищей [команды агентов](/docs/ru/agent-teams#specify-teammates-and-models) и [workflow](/docs/ru/workflows) агентов, которым не назначена модель другим способом. Принимает псевдоним, такой как `haiku`, или полное имя модели. Два источника имеют приоритет над ним: модель, которую Claude передает при порождении агента, и поле `model` в определении агента, включая `inherit`. Чтобы изменить это, установите [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ru/sub-agents#run-every-subagent-on-one-model). См. [Выбрать модель](/docs/ru/sub-agents#choose-a-model) для полного порядка. Установка его на `inherit` — это то же самое, что оставить его неустановленным. До версии 2.1.251 эта переменная переопределяла как модель для каждого вызова, так и поле `model` определения |

383| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Установите `1` для принудительного применения одной модели к подагентам, товарищам и агентам workflow. [Запустить каждый подагент на одной модели](/docs/ru/sub-agents#run-every-subagent-on-one-model) говорит, какая модель это. Требует Claude Code версии 2.1.257 или позже |383| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Установите `1` для принудительного применения одной модели к subagents, товарищам и агентам workflow. [Запустить каждый subagent на одной модели](/docs/ru/sub-agents#run-every-subagent-on-one-model) говорит, какая модель это. Требует Claude Code версии 2.1.257 или позже |

384| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Установите `5m` или `1h`, единственные значения, которые Claude Code принимает, для выбора [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) для запросов вне основного разговора, таких как [подагенты](/docs/ru/sub-agents), workflows и фоновая работа. Имеет приоритет над параметром `subagentPromptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, и `FORCE_PROMPT_CACHING_5M` переопределяет это. API выставляет счета за записи кэша на 1 час по более высокой ставке. Требует Claude Code версии 2.1.242 или позже |384| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Установите `5m` или `1h`, единственные значения, которые Claude Code принимает, для выбора [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) для запросов вне основного разговора, таких как [subagents](/docs/ru/sub-agents), workflows и фоновая работа. Имеет приоритет над параметром `subagentPromptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, и `FORCE_PROMPT_CACHING_5M` переопределяет его. API выставляет счета за записи кэша на 1 час по более высокой ставке. Требует Claude Code версии 2.1.242 или позже |

385| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Установите `1` для удаления учетных данных из окружений подпроцессов (инструмент Bash, hooks, MCP серверы stdio): учетные данные Anthropic и облачного поставщика, любая другая переменная, которую Claude Code распознает как учетные данные, и учетные данные, встроенные в URL реестра пакетов. Родительский процесс Claude сохраняет эти учетные данные для вызовов API, но дочерние процессы не могут их читать, уменьшая воздействие атак внедрения подсказок, которые пытаются экспортировать секреты через расширение оболочки. На версии 2.1.251 или позже скраб также удаляет переменные указателя хранилища конфигурации Claude Code (такие как `CLAUDE_CONFIG_DIR`), поэтому дочерний процесс не может найти переместившийся каталог конфигурации. Оставьте скраб не установленным, если подпроцесс нуждается в этих переменных. На Linux это также запускает подпроцессы Bash в изолированном пространстве имен PID, поэтому они не могут читать окружения процессов хоста через `/proc`; как побочный эффект, `ps`, `pgrep` и `kill` не могут видеть или сигнализировать процессам хоста. `claude-code-action` устанавливает это автоматически, когда настроен `allowed_non_write_users` |385| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Установите `1` для удаления учетных данных из окружений подпроцессов (инструмент Bash, hooks, серверы MCP stdio): учетные данные Anthropic и облачного поставщика, любая другая переменная, которую Claude Code распознает как учетные данные, и учетные данные, встроенные в URL реестра пакетов. Родительский процесс Claude сохраняет эти учетные данные для вызовов API, но дочерние процессы не могут их читать, снижая воздействие атак внедрения подсказок, которые пытаются экспортировать секреты через расширение оболочки. На версии 2.1.251 или позже скраб также удаляет переменные указателя хранилища конфигурации Claude Code (такие как `CLAUDE_CONFIG_DIR`), поэтому дочерний процесс не может найти перемещенный каталог конфигурации. Оставьте скраб неустановленным, если подпроцесс нуждается в этих переменных. На Linux это также запускает подпроцессы Bash в изолированном пространстве имен PID, поэтому они не могут читать окружения хост-процессов через `/proc`; как побочный эффект, `ps`, `pgrep` и `kill` не могут видеть или сигнализировать хост-процессам. `claude-code-action` устанавливает это автоматически, когда настроен `allowed_non_write_users` |

386| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Установите `1` в неинтерактивном режиме (флаг `-p`) для ожидания завершения установки плагина перед первым запросом. Без этого плагины устанавливаются в фоновом режиме и могут быть недоступны на первом ходе. Объедините с `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` для ограничения ожидания |386| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Установите `1` в неинтерактивном режиме (флаг `-p`) для ожидания завершения установки плагина перед первым запросом. Без этого плагины устанавливаются в фоновом режиме и могут быть недоступны на первом ходе. Объедините с `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` для ограничения ожидания |

387| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Таймаут в миллисекундах для синхронной установки плагина. При превышении Claude Code продолжает без плагинов и логирует ошибку. Нет значения по умолчанию: без этой переменной синхронная установка ждет до завершения |387| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Таймаут в миллисекундах для синхронной установки плагина. При превышении Claude Code продолжает без плагинов и логирует ошибку. Нет значения по умолчанию: без этой переменной синхронная установка ждет до завершения |

388| `CLAUDE_CODE_SYNC_SKILLS` | Установите `1` в неинтерактивном режиме с флагом `-p` для того, чтобы Claude Code загрузил skills, включенные для вашей учетной записи claude.ai в этом запуске и ждал список их, до `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, перед запуском первого запроса. Сами загрузки завершаются в фоновом режиме, и Claude ждет загрузки skill, когда его вызывает. Требует аутентификацию claude.ai. Сеансы терминала, где вы входите с вашей учетной записью claude.ai [загружают эти skills](/docs/ru/skills#where-synced-skills-load) в `~/.claude/skills/synced/` и повторно синхронизируют примерно каждые 10 минут без этой переменной, поэтому установите ее только, когда запуск `-p` нуждается в ваших текущих skills на его первом запросе. До версии 2.1.273 сеансы терминала загружали их только в запуске `-p` с этой переменной. Имя папки `synced` [зарезервировано для этой загрузки](/docs/ru/skills#where-skills-live). До версии 2.1.227 skills загружались в `~/.claude/skills/` напрямую. Claude Code применяет [дополнительные правила к загруженным skills](/docs/ru/skills#how-synced-skills-behave), такие как отсутствие запуска их команд `!` на вашей машине |388| `CLAUDE_CODE_SYNC_SKILLS` | Установите `1` в неинтерактивном режиме с флагом `-p` для того, чтобы Claude Code загрузил skills, включенные для вашей учетной записи claude.ai в этом запуске, и ждал список их, до `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, перед запуском первого запроса. Сами загрузки завершаются в фоновом режиме, и Claude ждет загрузки skill, когда он его вызывает. Требует аутентификацию claude.ai. Сеансы терминала, где вы входите с вашей учетной записью claude.ai, [загружают эти skills](/docs/ru/skills#where-synced-skills-load) в `~/.claude/skills/synced/` и повторно синхронизируют примерно каждые 10 минут без этой переменной, поэтому установите ее только, когда запуск `-p` нуждается в ваших текущих skills на его первом запросе. До версии 2.1.273 сеансы терминала загружали их только в запуске `-p` с этой переменной. Имя папки `synced` [зарезервировано для этой загрузки](/docs/ru/skills#where-skills-live). До версии 2.1.227 skills загружались в `~/.claude/skills/` напрямую. Claude Code применяет [дополнительные правила к загруженным skills](/docs/ru/skills#how-synced-skills-behave), такие как отсутствие запуска их команд `!` на вашей машине |

389| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Таймаут в миллисекундах для повторной синхронизации skills, которая работает в середине сеанса, когда приложение, построенное на [Agent SDK](/docs/ru/agent-sdk/typescript#query-object), перезагружает skills (по умолчанию: 30000). При превышении перезагрузка продолжает с какими бы skills ни прибыли, и оставшиеся загрузки завершаются в фоновом режиме |389| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Таймаут в миллисекундах для повторной синхронизации skills, которая работает в середине сеанса, когда приложение, построенное на [Agent SDK](/docs/ru/agent-sdk/typescript#query-object), перезагружает skills (по умолчанию: 30000). При превышении перезагрузка продолжается с какими бы skills ни прибыли, и оставшиеся загрузки завершаются в фоновом режиме |

390| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Таймаут в миллисекундах для первого запроса для ожидания начального списка skills, когда установлен `CLAUDE_CODE_SYNC_SKILLS` (по умолчанию: 5000). При превышении первый запрос работает с какими бы skills ни прибыли. Загрузки завершаются в фоновом режиме в любом случае, и Claude ждет загрузки skill, когда его вызывает |390| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Таймаут в миллисекундах для первого запроса для ожидания начального списка skill, когда установлен `CLAUDE_CODE_SYNC_SKILLS` (по умолчанию: 5000). При превышении первый запрос работает с какими бы skills ни прибыли. Загрузки завершаются в фоновом режиме в любом случае, и Claude ждет загрузки skill, когда он его вызывает |

391| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Установите `false` для отключения подсветки синтаксиса в выводе diff. Полезно, когда цвета мешают вашей настройке терминала. Чтобы также отключить подсветку в блоках кода и предпросмотрах файлов, используйте параметр [`syntaxHighlightingDisabled`](/docs/ru/settings-reference#syntaxhighlightingdisabled) |391| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Установите `false` для отключения подсветки синтаксиса в выводе diff. Полезно, когда цвета мешают вашей настройке терминала. Чтобы также отключить подсветку в блоках кода и предпросмотрах файлов, используйте параметр [`syntaxHighlightingDisabled`](/docs/ru/settings-reference#syntaxhighlightingdisabled) |

392| `CLAUDE_CODE_TASK_LIST_ID` | Поделиться списком задач между сеансами. Установите один и тот же ID в нескольких экземплярах Claude Code для координации на общем списке задач, в [сеансах, которые имеют инструменты Task](/docs/ru/tools-reference#task-tool-availability). См. [Список задач](/docs/ru/interactive-mode#task-list) |392| `CLAUDE_CODE_TASK_LIST_ID` | Поделиться списком задач между сеансами. Установите один и тот же ID в нескольких экземплярах Claude Code для координации на общем списке задач в [сеансах, которые имеют инструменты Task](/docs/ru/tools-reference#task-tool-availability). См. [Список задач](/docs/ru/interactive-mode#task-list) |

393| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Переопределить в миллисекундах, как долго неинтерактивный сеанс ждет при выходе, пока его [команда агентов](/docs/ru/agent-teams) завершит разборку. Принимает 1000 до 60000; значение вне диапазона игнорируется и применяется значение по умолчанию 10000. Требует Claude Code версии 2.1.206 или позже |393| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Переопределить в миллисекундах, как долго неинтерактивный сеанс ждет при выходе, пока его [команда агентов](/docs/ru/agent-teams) завершит разборку. Принимает 1000 до 60000; значение вне диапазона игнорируется и применяется значение по умолчанию 10000. Требует Claude Code версии 2.1.206 или позже |

394| `CLAUDE_CODE_TMPDIR` | Переопределить временный каталог, используемый для внутренних временных файлов. Claude Code добавляет `/claude-{uid}/` на Unix или `/claude/` на Windows к этому пути. По умолчанию: `/tmp` на macOS, `os.tmpdir()` на Linux и Windows. На macOS и Linux [изолированные](/docs/ru/sandboxing) подпроцессы Bash получают короткий резервный `$TMPDIR` под системным значением по умолчанию, когда ваше переопределение — это длинный путь, так как некоторые инструменты завершаются с ошибкой, когда пути временных файлов становятся слишком длинными. Неизолированные команды Bash наследуют `$TMPDIR` вашей оболочки без изменений. Собственные временные файлы Claude Code всегда используют ваше переопределение. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |394| `CLAUDE_CODE_TMPDIR` | Переопределить временный каталог, используемый для внутренних временных файлов. Claude Code добавляет `/claude-{uid}/` на Unix или `/claude/` на Windows к этому пути. По умолчанию: `/tmp` на macOS, `os.tmpdir()` на Linux и Windows. На macOS и Linux [изолированные](/docs/ru/sandboxing) подпроцессы Bash получают короткий резервный `$TMPDIR` под системным значением по умолчанию, когда ваше переопределение — это длинный путь, так как некоторые инструменты завершаются с ошибкой, когда пути временных файлов становятся слишком длинными. Неизолированные команды Bash наследуют `$TMPDIR` вашей оболочки без изменений. Собственные временные файлы Claude Code всегда используют ваше переопределение. Установите его в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

395| `CLAUDE_CODE_TMUX_TRUECOLOR` | Установите на любое непустое значение, такое как `1`, для разрешения вывода 24-битного truecolor внутри tmux. **Установка его на `0` или `false` по-прежнему разрешает truecolor**, в отличие от большинства переменных включения/отключения; отмените установку переменной для восстановления ограничения 256 цветов. По умолчанию Claude Code ограничивает 256 цветами, когда установлен `$TMUX`, потому что tmux не пропускает последовательности выхода truecolor, если не настроен. Установите это после добавления `set -ga terminal-overrides ',*:Tc'` в ваш `~/.tmux.conf`. См. [Конфигурация терминала](/docs/ru/terminal-config) для других параметров tmux |395| `CLAUDE_CODE_TMUX_TRUECOLOR` | Установите на любое непустое значение, такое как `1`, для разрешения вывода 24-битного truecolor внутри tmux. **Установка его на `0` или `false` по-прежнему разрешает truecolor**, в отличие от большинства переменных включения/отключения; отмените установку переменной для восстановления зажима 256 цветов. По умолчанию Claude Code зажимает до 256 цветов, когда установлен `$TMUX`, потому что tmux не пропускает последовательности escape truecolor, если не настроен. Установите это после добавления `set -ga terminal-overrides ',*:Tc'` в ваш `~/.tmux.conf`. См. [Конфигурация терминала](/docs/ru/terminal-config) для других параметров tmux |

396| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | На Linux и WSL установите на разделенный запятыми список видов процессов Claude Code [исключает из ограничения памяти инструмента](/docs/ru/tools-reference#memory-limit-on-linux-and-wsl), такие как `mcp` или `lsp`. Установите `none` для ограничения каждого вида или `all-new` для ограничения только команд инструментов Bash, PowerShell и Monitor. Claude Code сохраняет команды инструментов Bash, PowerShell и Monitor под ограничением, что бы вы ни перечисляли. Требует Claude Code версии 2.1.246 или позже |396| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | На Linux и WSL установите на разделенный запятыми список видов процессов Claude Code [исключает из ограничения памяти инструмента](/docs/ru/tools-reference#memory-limit-on-linux-and-wsl), такие как `mcp` или `lsp`. Установите `none` для ограничения каждого вида или `all-new` для ограничения только команд инструментов Bash, PowerShell и Monitor. Claude Code сохраняет команды инструментов Bash, PowerShell и Monitor под ограничением, что бы вы ни перечислили. Требует Claude Code версии 2.1.246 или позже |

397| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | На Linux и WSL установите на размер, такой как `4G`, для [ограничения памяти, которую могут использовать команды инструментов Bash и PowerShell](/docs/ru/tools-reference#memory-limit-on-linux-and-wsl), и команды инструмента Monitor на версии 2.1.246 или позже. Напишите размер в простых цифрах, одних для количества байтов или с суффиксом `K`, `M`, `G` или `T`. Установите `0` или `off` для отключения ограничения. Как только первый процесс, который Claude Code запускает, включил или отключил ограничение, измененное значение вступает в силу при следующем запуске `claude`. Требует Claude Code версии 2.1.233 или позже |397| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | На Linux и WSL установите на размер, такой как `4G`, для [ограничения памяти, которую могут использовать команды инструментов Bash и PowerShell](/docs/ru/tools-reference#memory-limit-on-linux-and-wsl), и команды инструмента Monitor на версии 2.1.246 или позже. Напишите размер в простых цифрах, отдельно для количества байтов или с суффиксом `K`, `M`, `G` или `T`. Установите `0` или `off` для отключения ограничения. После того, как первый процесс Claude Code запустил ограничение или отключил его, измененное значение вступает в силу при следующем запуске `claude`. Требует Claude Code версии 2.1.233 или позже |

398| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Крайний срок в миллисекундах перед тем как Claude Code отменяет диалог, который он пересылает удаленному клиенту, такому как [Remote Control](/docs/ru/remote-control) или хост SDK, или диалог одобрения для [удерживаемого кросс-сеансового сообщения](/docs/ru/cross-session-messaging#control-inbound-messages); запросы разрешений и вопросы `AskUserQuestion` используют свои собственные потоки и не управляются им. На Claude Code версии 2.1.236 или позже это также ограничивает подсказку согласия на использование кредитов [Fable](/docs/ru/model-config#fable-and-usage-credits) в сеансе, который может работать без присмотра. [Контроль входящих сообщений](/docs/ru/cross-session-messaging#control-inbound-messages) и [неинтерактивные сеансы](/docs/ru/cross-session-messaging#non-interactive-sessions) охватывают полные правила истечения удерживаемого сообщения, включая случаи, когда крайний срок не применяется. Переопределяет параметр [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry). `0` или отрицательное значение отключает крайний срок |398| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Крайний срок в миллисекундах перед тем, как Claude Code отменит диалоговое окно, которое оно пересылает удаленному клиенту, такому как [Remote Control](/docs/ru/remote-control) или хост SDK, или диалоговое окно одобрения для [удерживаемого кросс-сеансового сообщения](/docs/ru/cross-session-messaging#control-inbound-messages); запросы разрешений и вопросы `AskUserQuestion` используют свои собственные потоки и не управляются им. На Claude Code версии 2.1.236 или позже он также ограничивает подсказку согласия на использование кредитов [Fable](/docs/ru/model-config#fable-and-usage-credits) в сеансе, который может работать без присмотра. [Контроль входящих сообщений](/docs/ru/cross-session-messaging#control-inbound-messages) и [неинтерактивные сеансы](/docs/ru/cross-session-messaging#non-interactive-sessions) охватывают полные правила истечения удерживаемого сообщения, включая случаи, когда крайний срок не применяется. Переопределяет параметр [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry). `0` или отрицательное значение отключает крайний срок |

399| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Использовать [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) |399| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Использовать [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) |

400| `CLAUDE_CODE_USE_BEDROCK` | Использовать [Amazon Bedrock](/docs/ru/amazon-bedrock) |400| `CLAUDE_CODE_USE_BEDROCK` | Использовать [Amazon Bedrock](/docs/ru/amazon-bedrock) |

401| `CLAUDE_CODE_USE_FOUNDRY` | Использовать [Microsoft Foundry](/docs/ru/microsoft-foundry) |401| `CLAUDE_CODE_USE_FOUNDRY` | Использовать [Microsoft Foundry](/docs/ru/microsoft-foundry) |

402| `CLAUDE_CODE_USE_MANTLE` | Использовать конечную точку Amazon Bedrock [Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) |402| `CLAUDE_CODE_USE_MANTLE` | Использовать [конечную точку Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) Amazon Bedrock |

403| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Установите `1` для обнаружения пользовательских команд, подагентов и стилей вывода с использованием API файлов Node.js вместо ripgrep. Установите это, если встроенный двоичный файл ripgrep недоступен или заблокирован в вашем окружении. Не влияет на инструменты Grep или поиск файлов |403| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Установите `1` для обнаружения пользовательских команд, subagents и стилей вывода с использованием API файлов Node.js вместо ripgrep. Установите это, если встроенный двоичный файл ripgrep недоступен или заблокирован в вашем окружении. Не влияет на инструменты Grep или поиск файлов |

404| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Контролирует инструмент PowerShell. На Windows без Git Bash инструмент включен автоматически; установите `0` для отключения. На Windows с установленным Git Bash инструмент включен по умолчанию для учетных записей claude.ai и Console; установите `1` для включения в сеансах Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, или `0` для отключения. На Linux, macOS и WSL установите `1` для включения, что требует `pwsh` на вашем `PATH`. Если включено на Windows, Claude может запускать команды PowerShell изначально вместо маршрутизации через Git Bash. См. [Инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) |404| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Контролирует инструмент PowerShell. На Windows без Git Bash инструмент включен автоматически; установите `0` для отключения. На Windows с установленным Git Bash инструмент включен по умолчанию для учетных записей claude.ai и Console; установите `1` для включения в сеансах Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry или `0` для отключения. На Linux, macOS и WSL установите `1` для включения, что требует `pwsh` на вашем `PATH`. Если включено на Windows, Claude может запускать команды PowerShell изначально вместо маршрутизации через Git Bash. См. [Инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) |

405| `CLAUDE_CODE_USE_VERTEX` | Использовать [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |405| `CLAUDE_CODE_USE_VERTEX` | Использовать [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |

406| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Установите на количество миллисекунд [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) сохраняет кэш ответа каждого полученного URL. По умолчанию `900000`, что составляет 15 минут. Принимает только простые цифры; `0`, десятичное число или любое другое написание сохраняет значение по умолчанию. Claude Code читает значение один раз за запуск, поэтому изменение в блоке параметров `env` применяется при следующем запуске `claude`. Требует Claude Code версии 2.1.233 или позже |406| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Установите на количество миллисекунд [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) сохраняет кэш ответа каждого полученного URL. По умолчанию `900000`, что составляет 15 минут. Принимает только простые цифры; `0`, десятичное число или любое другое написание сохраняет значение по умолчанию. Claude Code читает значение один раз за запуск, поэтому изменение в блоке параметров `env` применяется при следующем запуске `claude`. Требует Claude Code версии 2.1.233 или позже |

407| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Верхняя граница в миллисекундах, как долго [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) ждет загрузки страницы, включая любые перенаправления, которые она следует. Загрузка, которая не завершена к этому времени, завершается с ошибкой крайнего срока. По умолчанию `300000`, что составляет пять минут. Установите `0` для удаления ограничения. Принимает только простые цифры; десятичное число или любое другое написание сохраняет значение по умолчанию. Требует Claude Code версии 2.1.268 или позже |407| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Верхняя граница в миллисекундах того, как долго [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) ждет загрузки страницы, включая любые перенаправления, которые она следует. Загрузка, которая не завершена к этому времени, завершается с ошибкой крайнего срока. По умолчанию `300000`, что составляет пять минут. Установите `0` для удаления ограничения. Принимает только простые цифры; десятичное число или любое другое написание сохраняет значение по умолчанию. Требует Claude Code версии 2.1.268 или позже |

408| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Сколько агентов один запуск [workflow](/docs/ru/workflows) выполняет одновременно, от `1` до `256`. По умолчанию запуск выполняет до 16 агентов одновременно, меньше, когда Claude Code имеет меньше доступных CPU; очередные вызовы `agent()` ждут свободного слота. Стенограмма каждого работающего агента остается в памяти Claude Code, поэтому более высокие значения повышают использование памяти. Принимает только простые цифры; значения вне диапазона и другие написания сохраняют значение по умолчанию. Требует Claude Code версии 2.1.269 или позже |408| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Сколько агентов один запуск [workflow](/docs/ru/workflows) выполняет одновременно, от `1` до `256`. По умолчанию запуск выполняет до 16 агентов одновременно, меньше, когда Claude Code имеет меньше доступных CPU; очередные вызовы `agent()` ждут свободного слота. Стенограмма каждого работающего агента остается в памяти Claude Code, поэтому более высокие значения повышают использование памяти. Принимает только простые цифры; значения вне диапазона и другие написания сохраняют значение по умолчанию. Требует Claude Code версии 2.1.269 или позже |

409| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Верхняя граница в миллисекундах, как долго агент [workflow](/docs/ru/workflows) ждет первого ответа товарища с одинаковым префиксом перед отправкой своего собственного первого запроса. Когда веерное расширение запускает несколько агентов, которые делят [префикс кэша подсказок](/docs/ru/workflows#prompt-caching-in-a-fan-out), Claude Code удерживает всех, кроме первого агента, до этого времени, чтобы остальные читали кэшированный префикс вместо каждого обработки его без кэша. По умолчанию `5000`. Установите `0` для отключения ожидания. Когда установлен `DISABLE_PROMPT_CACHING`, агенты никогда не ждут. Требует Claude Code версии 2.1.229 или позже |409| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Верхняя граница в миллисекундах того, как долго агент [workflow](/docs/ru/workflows) ждет, пока сиблинг с одинаковым префиксом начнет свой первый ответ, перед отправкой своего собственного первого запроса. Когда fan-out запускает несколько агентов, которые делят [префикс кэша подсказок](/docs/ru/workflows#prompt-caching-in-a-fan-out), Claude Code удерживает всех, кроме первого агента, до этого времени, чтобы остальные читали кэшированный префикс вместо каждого обработки его без кэша. По умолчанию `5000`. Установите `0` для отключения ожидания. Когда установлен `DISABLE_PROMPT_CACHING`, агенты никогда не ждут. Требует Claude Code версии 2.1.229 или позже |

410| `CLAUDE_CONFIG_DIR` | Переопределить каталог конфигурации (по умолчанию: `~/.claude`). Все параметры, история сеансов и плагины хранятся под этим путем. Для учетных данных см. [где Claude Code хранит учетные данные](/docs/ru/authentication#credential-management). Полезно для запуска нескольких учетных записей рядом: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |410| `CLAUDE_CONFIG_DIR` | Переопределить каталог конфигурации (по умолчанию: `~/.claude`). Все параметры, история сеансов и плагины хранятся под этим путем. Для учетных данных см. [где Claude Code хранит учетные данные](/docs/ru/authentication#credential-management). Полезно для запуска нескольких учетных записей рядом: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Установите его в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

411| `CLAUDE_DISABLE_ADOPT` | Установите `1` для остановки текущей фоновой работы вместо переноса при фоновом выполнении сеанса нажатием `←` или с [`/background`](/docs/ru/agent-view#from-inside-a-session). Claude Code просит вас подтвердить перед фоновым выполнением, затем останавливает задачи, которые в противном случае переносились бы. Требует Claude Code версии 2.1.195 или позже |411| `CLAUDE_DISABLE_ADOPT` | Установите `1` для остановки текущей фоновой работы вместо ее переноса, когда вы фоновый сеанс, нажав `←` или с [`/background`](/docs/ru/agent-view#from-inside-a-session). Claude Code просит вас подтвердить перед фоновым выполнением, затем останавливает задачи, которые иначе переносились бы. Требует Claude Code версии 2.1.195 или позже |

412| `CLAUDE_EFFORT` | Установите автоматически в подпроцессах инструмента Bash и командах hook на [уровень усилий](/docs/ru/model-config#adjust-effort-level), действующий при запуске подпроцесса: `low`, `medium`, `high`, `xhigh` или `max`. Ultracode не является отдельным уровнем и сообщается как `xhigh`. Совпадает с полем `effort.level`, переданным [hooks](/docs/ru/hooks). Установлено только, когда текущая модель поддерживает параметр effort |412| `CLAUDE_EFFORT` | Установите автоматически в подпроцессах инструмента Bash и команды hook на [уровень effort](/docs/ru/model-config#adjust-effort-level) в силе при запуске подпроцесса: `low`, `medium`, `high`, `xhigh` или `max`. Ultracode не является отдельным уровнем и сообщает как `xhigh`. Соответствует полю `effort.level`, переданному [hooks](/docs/ru/hooks). Установлено только, когда текущая модель поддерживает параметр effort |

413| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите `1` для принудительного включения сторожевого таймера потока на уровне байтов, или установите `0` для принудительного отключения. `0` также отключает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на подключениях, где этот крайний срок работает. Если не установлено, сторожевой таймер включен по умолчанию для прямых подключений API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), и для потоковых ответов на подключениях [шлюза](/docs/ru/gateways), достигнутых через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`; до версии 2.1.222 он не работал на этих подключениях шлюза, поэтому сторожевой таймер на уровне событий мог сообщить о стагнации там, даже пока поступали пинги keep-alive. Для таймаутов и того, как таймеры взаимодействуют, см. [Потоковые сторожевые таймеры](/docs/ru/network-config#streaming-idle-watchdogs) |413| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите `1` для принудительного включения сторожевого таймера потока на уровне байтов или установите `0` для принудительного отключения. `0` также отключает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на подключениях, где этот крайний срок работает. Если не установлено, сторожевой таймер включен по умолчанию для прямых подключений API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), и для потоковых ответов на подключениях [gateway](/docs/ru/gateways), достигнутых через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`; до версии 2.1.222 он не работал на этих подключениях шлюза, поэтому сторожевой таймер на уровне событий мог сообщить о стагнации там, даже пока приходили пинги keep-alive. Для таймаутов и того, как таймеры взаимодействуют, см. [Потоковые сторожевые таймеры](/docs/ru/network-config#streaming-idle-watchdogs) |

414| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите `1` для включения сторожевого таймера потока на уровне байтов на ответах Amazon Bedrock `vnd.amazon.eventstream`, что также включает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на потоковых запросах Bedrock. Отключено по умолчанию. Настройте таймаут с `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |414| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите `1` для включения сторожевого таймера потока на уровне байтов на ответах Amazon Bedrock `vnd.amazon.eventstream`, что также включает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на потоковых запросах Bedrock. Отключено по умолчанию. Настройте таймаут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

415| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите `0` для принудительного отключения сторожевого таймера потока на уровне событий, или установите `1` для принудительного включения. Если не установлено, сторожевой таймер включен по умолчанию для всех поставщиков. До версии 2.1.196 значение по умолчанию без установки было управляемо сервером на прямом API Anthropic и отключено на других поставщиках. Настройте таймаут с `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; для других таймаутов стагнации, которые работают рядом с этим, см. [Потоковые сторожевые таймеры](/docs/ru/network-config#streaming-idle-watchdogs) |415| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите `0` для принудительного отключения сторожевого таймера потока на уровне событий или установите `1` для принудительного включения. Если не установлено, сторожевой таймер включен по умолчанию для всех поставщиков. До версии 2.1.196 неустановленное значение по умолчанию было управляемым сервером на прямом API Anthropic и отключено на других поставщиках. Настройте таймаут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; для других таймаутов стагнации, которые работают рядом с этим, см. [Потоковые сторожевые таймеры](/docs/ru/network-config#streaming-idle-watchdogs) |

416| `CLAUDE_ENV_FILE` | Путь к скрипту оболочки, содержимое которого Claude Code запускает перед каждой командой Bash в том же процессе оболочки, поэтому экспорты в файле видны команде. Используйте для сохранения активации virtualenv или conda между командами. Также заполняется динамически [SessionStart](/docs/ru/hooks#persist-environment-variables), [Setup](/docs/ru/hooks#setup), [CwdChanged](/docs/ru/hooks#cwdchanged) и [FileChanged](/docs/ru/hooks#filechanged) hooks |416| `CLAUDE_ENV_FILE` | Путь к скрипту оболочки, содержимое которого Claude Code запускает перед каждой командой Bash в том же процессе оболочки, поэтому экспорты в файле видны команде. Используйте для сохранения активации virtualenv или conda между командами. Также заполняется динамически [SessionStart](/docs/ru/hooks#persist-environment-variables), [Setup](/docs/ru/hooks#setup), [CwdChanged](/docs/ru/hooks#cwdchanged) и [FileChanged](/docs/ru/hooks#filechanged) hooks |

417| `CLAUDE_JOB_DIR` | Установите Claude Code в каждом [фоновом сеансе](/docs/ru/agent-view) на каталог `~/.claude/jobs/<id>` этого сеанса. Команды оболочки, которые запускает сеанс, наследуют это. Напишите временные файлы в [`$CLAUDE_JOB_DIR/tmp`](/docs/ru/agent-view#where-state-is-stored). Вызовы `Write` и `Edit` Claude там не запрашивают разрешение, и каталог удаляется при удалении сеанса |417| `CLAUDE_JOB_DIR` | Установите Claude Code в каждом [фоновом сеансе](/docs/ru/agent-view) на каталог `~/.claude/jobs/<id>` этого сеанса. Команды оболочки, которые сеанс запускает, наследуют его. Напишите временные файлы в [`$CLAUDE_JOB_DIR/tmp`](/docs/ru/agent-view#where-state-is-stored). Вызовы Claude `Write` и `Edit` там не запрашивают разрешение, и каталог удаляется при удалении сеанса |

418| `CLAUDE_PID` | Claude Code устанавливает это на свой собственный ID процесса в подпроцессах, которые он порождает: команды инструментов Bash и PowerShell и команды hook. На Linux интеграция оболочки инструмента Bash использует это для отказа в шаблоне `pkill`, который совпадал бы с самим процессом Claude Code; см. [справку по ошибкам](/docs/ru/errors#pkill-pattern-matches-the-claude-code-process). Прочитайте это из своих собственных скриптов для определения или сигнализации родительскому процессу Claude Code намеренно. Требует Claude Code версии 2.1.214 или позже |418| `CLAUDE_PID` | Claude Code устанавливает это на свой собственный ID процесса в подпроцессах, которые он порождает: команды инструментов Bash и PowerShell и команды hook. На Linux интеграция оболочки инструмента Bash использует его для отказа в шаблоне `pkill`, который соответствовал бы самому процессу Claude Code; см. [справку по ошибкам](/docs/ru/errors#pkill-pattern-matches-the-claude-code-process). Прочитайте его из своих собственных скриптов для определения или сигнализации родительскому процессу Claude Code намеренно. Требует Claude Code версии 2.1.214 или позже |

419| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Префикс для автоматически созданных имен сеансов [Remote Control](/docs/ru/remote-control), когда явное имя не предоставлено. По умолчанию имя хоста вашей машины, создавая имена, такие как `myhost-graceful-unicorn`. Флаг CLI `--remote-control-session-name-prefix` устанавливает то же значение для одного вызова |419| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Префикс для автоматически созданных имен сеансов [Remote Control](/docs/ru/remote-control), когда явное имя не предоставлено. По умолчанию имя хоста вашей машины, создавая имена, такие как `myhost-graceful-unicorn`. Флаг CLI `--remote-control-session-name-prefix` устанавливает то же значение для одного вызова |

420| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Крайний срок в миллисекундах для первого байта ответа потокового запроса, на подключениях, где работает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs). Для того, как Claude Code его ограничивает, дополнительное время, которое он добавляет для больших тел запроса, и как он выбирает крайний срок, когда вы оставляете это не установленным, см. [Нет ответа от API](/docs/ru/errors#no-response-from-api). Требует Claude Code версии 2.1.242 или позже |420| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Крайний срок в миллисекундах для первого байта ответа потокового запроса на подключениях, где работает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs). Для того, как Claude Code его зажимает, дополнительное время, которое он добавляет для больших тел запроса, и как он выбирает крайний срок, когда вы оставляете это неустановленным, см. [Нет ответа от API](/docs/ru/errors#no-response-from-api). Требует Claude Code версии 2.1.242 или позже |

421| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Таймаут в миллисекундах перед тем как сторожевые таймеры потока на уровне событий и байтов закрывают застопорившееся подключение. Когда вы явно устанавливаете эту переменную, минимум составляет `300000` (5 минут); более низкие значения молча ограничиваются для поглощения пауз расширенного мышления и буферизации прокси, и сторожевой таймер на уровне байтов ограничивает значение на 30 минут. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` имеет приоритет над этой переменной для сторожевого таймера на уровне байтов. Для значений по умолчанию без установки для каждого сторожевого таймера см. [Потоковые сторожевые таймеры](/docs/ru/network-config#streaming-idle-watchdogs) |421| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Таймаут в миллисекундах перед тем, как сторожевые таймеры потока на уровне событий и байтов закроют зависшее подключение. Когда вы явно устанавливаете эту переменную, минимум составляет `300000` (5 минут); более низкие значения молча зажимаются для поглощения пауз расширенного мышления и буферизации прокси, и сторожевой таймер на уровне байтов ограничивает значение до 30 минут. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` имеет приоритет над этой переменной для сторожевого таймера на уровне байтов. Для неустановленных значений по умолчанию для каждого сторожевого таймера см. [Потоковые сторожевые таймеры](/docs/ru/network-config#streaming-idle-watchdogs) |

422| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Удалено в версии 2.1.260 и теперь не работает. Ранее ограничивало, как долго [фоновая команда оболочки](/docs/ru/interactive-mode#background-bash-commands), которую запустил [подагент](/docs/ru/sub-agents), могла работать, в миллисекундах, с 60-минутным значением по умолчанию. См. [правила времени жизни фоновой команды](/docs/ru/tools-reference#background-commands) |422| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Удалено в версии 2.1.260 и теперь не работает. Ранее ограничивало, как долго [фоновая команда оболочки](/docs/ru/interactive-mode#background-bash-commands), которую запустил [subagent](/docs/ru/sub-agents), могла работать, в миллисекундах, с 60-минутным значением по умолчанию. См. [правила времени жизни фоновой команды](/docs/ru/tools-reference#background-commands) |

423| `DEBUG` | Установите `1` для включения режима отладки, эквивалентно запуску с [`--debug`](/docs/ru/cli-reference#cli-flags). Журналы отладки записываются в `~/.claude/debug/<session-id>.txt` или в путь, установленный `CLAUDE_CODE_DEBUG_LOGS_DIR`. Только истинные значения `1`, `true`, `yes` и `on` включают режим отладки, поэтому шаблоны пространства имен, такие как `DEBUG=express:*`, установленные для других инструментов, не вызывают это |423| `DEBUG` | Установите `1` для включения режима отладки, эквивалентно запуску с [`--debug`](/docs/ru/cli-reference#cli-flags). Журналы отладки записываются в `~/.claude/debug/<session-id>.txt` или в путь, установленный `CLAUDE_CODE_DEBUG_LOGS_DIR`. Только истинные значения `1`, `true`, `yes` и `on` включают режим отладки, поэтому шаблоны пространства имен, такие как `DEBUG=express:*`, установленные для других инструментов, не вызывают его |

424| `DISABLE_AUTOUPDATER` | Установите `1` для отключения автоматических фоновых обновлений. Ручной `claude update` по-прежнему работает. Используйте `DISABLE_UPDATES` для блокировки обоих |424| `DISABLE_AUTOUPDATER` | Установите `1` для отключения автоматических фоновых обновлений. Ручной `claude update` по-прежнему работает. Используйте `DISABLE_UPDATES` для блокировки обоих |

425| `DISABLE_AUTO_COMPACT` | Установите `1` для отключения автоматического компактирования при приближении к пределу контекста. Ручная команда `/compact` остается доступной. Используйте, когда вы хотите явный контроль над тем, когда происходит компактирование. Переопределяет параметр [`autoCompactEnabled`](/docs/ru/settings-reference#autocompactenabled) |425| `DISABLE_AUTO_COMPACT` | Установите `1` для отключения автоматического компактирования при приближении к пределу контекста. Ручная команда `/compact` остается доступной. Используйте, когда вы хотите явный контроль над тем, когда происходит компактирование. Переопределяет параметр [`autoCompactEnabled`](/docs/ru/settings-reference#autocompactenabled) |

426| `DISABLE_COMPACT` | Установите `1` для отключения всего компактирования: как автоматического компактирования, так и ручной команды `/compact` |426| `DISABLE_COMPACT` | Установите `1` для отключения всего компактирования: как автоматического компактирования, так и ручной команды `/compact` |


428| `DISABLE_DOCTOR_COMMAND` | Установите `1` для скрытия skill [`/doctor`](/docs/ru/commands#all-commands) проверки настройки и его псевдонима `/checkup`. Полезно для управляемых развертываний, где пользователи не должны запускать диагностику настройки из сеанса. Не влияет на команду терминала `claude doctor`. До версии 2.1.205 эта переменная скрывала экран диагностики `/doctor` |428| `DISABLE_DOCTOR_COMMAND` | Установите `1` для скрытия skill [`/doctor`](/docs/ru/commands#all-commands) проверки настройки и его псевдонима `/checkup`. Полезно для управляемых развертываний, где пользователи не должны запускать диагностику настройки из сеанса. Не влияет на команду терминала `claude doctor`. До версии 2.1.205 эта переменная скрывала экран диагностики `/doctor` |

429| `DISABLE_ERROR_REPORTING` | Установите на любое непустое значение, такое как `1`, для отказа от отчетов об ошибках. **Установка его на `0` или `false` по-прежнему отказывает**, в отличие от большинства переменных включения/отключения; отмените установку переменной для повторного включения отчетов об ошибках |429| `DISABLE_ERROR_REPORTING` | Установите на любое непустое значение, такое как `1`, для отказа от отчетов об ошибках. **Установка его на `0` или `false` по-прежнему отказывает**, в отличие от большинства переменных включения/отключения; отмените установку переменной для повторного включения отчетов об ошибках |

430| `DISABLE_EXTRA_USAGE_COMMAND` | Установите `1` для скрытия команды `/usage-credits`, которая позволяет пользователям покупать дополнительное использование сверх ограничений скорости |430| `DISABLE_EXTRA_USAGE_COMMAND` | Установите `1` для скрытия команды `/usage-credits`, которая позволяет пользователям покупать дополнительное использование сверх ограничений скорости |

431| `DISABLE_FEEDBACK_COMMAND` | Установите `1` для отключения команды `/feedback` и [отзывов, составленных Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior). Также отключает `/bug` и `/share`, которые сообщают через тот же путь; до версии 2.1.212 они были псевдонимами `/feedback`, поэтому команда была отключена под каждым именем. Также принимается старое имя `DISABLE_BUG_COMMAND` |431| `DISABLE_FEEDBACK_COMMAND` | Установите `1` для отключения команды `/feedback` и [обратной связи, составленной Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior). Также отключает `/bug` и `/share`, которые сообщают через тот же путь; до версии 2.1.212 они были псевдонимами `/feedback`, поэтому команда была отключена под каждым именем. Также принимается старое имя `DISABLE_BUG_COMMAND` |

432| `DISABLE_GROWTHBOOK` | Установите `1` или `true` для отключения получения флагов функций GrowthBook и использования значений по умолчанию кода для каждого флага. Это делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, требующие получения флагов функций](#features-that-need-feature-flag-fetching) недоступными. Установка его на `0` или `false` оставляет получение включенным. Логирование событий телеметрии остается включенным, если только `DISABLE_TELEMETRY` также не установлен |432| `DISABLE_GROWTHBOOK` | Установите `1` или `true` для отключения получения флагов функций GrowthBook и использования кодовых значений по умолчанию для каждого флага. Это делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, требующие получения флагов функций](#features-that-need-feature-flag-fetching) недоступными. Установка его на `0` или `false` оставляет получение включенным. Логирование событий телеметрии остается включенным, если только `DISABLE_TELEMETRY` также не установлен |

433| `DISABLE_INSTALLATION_CHECKS` | Установите `1` для отключения предупреждений об установке. Используйте только при ручном управлении местоположением установки, так как это может скрыть проблемы со стандартными установками |433| `DISABLE_INSTALLATION_CHECKS` | Установите `1` для отключения предупреждений об установке. Используйте только при ручном управлении местоположением установки, так как это может скрыть проблемы со стандартными установками |

434| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Установите `1` для скрытия команды `/install-github-app`. Уже скрыта при использовании сторонних поставщиков (Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry) |434| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Установите `1` для скрытия команды `/install-github-app`. Уже скрыта при использовании сторонних поставщиков (Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry) |

435| `DISABLE_INTERLEAVED_THINKING` | Установите `1` для предотвращения отправки заголовка бета-версии interleaved-thinking. Полезно, когда ваш LLM gateway или поставщик не поддерживает [interleaved thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |435| `DISABLE_INTERLEAVED_THINKING` | Установите `1` для предотвращения отправки заголовка бета-версии interleaved-thinking. Полезно, когда ваш LLM gateway или поставщик не поддерживает [interleaved thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |


443| `DISABLE_TELEMETRY` | Установите на любое непустое значение, такое как `1`, для отказа от телеметрии. **Установка его на `0` или `false` по-прежнему отказывает**, в отличие от большинства переменных включения/отключения; отмените установку переменной для повторного включения телеметрии. События телеметрии не включают пользовательские данные, такие как код, пути файлов или команды bash. Также отключает получение флагов функций с тем же эффектом, что и `DISABLE_GROWTHBOOK`, что делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, требующие получения флагов функций](#features-that-need-feature-flag-fetching) недоступными. См. [Отключить телеметрию для вашей организации](/docs/ru/managed-settings#turn-telemetry-off-for-your-organization) |443| `DISABLE_TELEMETRY` | Установите на любое непустое значение, такое как `1`, для отказа от телеметрии. **Установка его на `0` или `false` по-прежнему отказывает**, в отличие от большинства переменных включения/отключения; отмените установку переменной для повторного включения телеметрии. События телеметрии не включают пользовательские данные, такие как код, пути файлов или команды bash. Также отключает получение флагов функций с тем же эффектом, что и `DISABLE_GROWTHBOOK`, что делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, требующие получения флагов функций](#features-that-need-feature-flag-fetching) недоступными. См. [Отключить телеметрию для вашей организации](/docs/ru/managed-settings#turn-telemetry-off-for-your-organization) |

444| `DISABLE_UPDATES` | Установите `1` для блокировки всех обновлений, включая ручной `claude update` и `claude install`. Строже, чем `DISABLE_AUTOUPDATER`. Используйте при распределении Claude Code через ваши собственные каналы и пользователи не должны самостоятельно обновляться |444| `DISABLE_UPDATES` | Установите `1` для блокировки всех обновлений, включая ручной `claude update` и `claude install`. Строже, чем `DISABLE_AUTOUPDATER`. Используйте при распределении Claude Code через ваши собственные каналы и пользователи не должны самостоятельно обновляться |

445| `DISABLE_UPGRADE_COMMAND` | Установите `1` для скрытия команды `/upgrade` |445| `DISABLE_UPGRADE_COMMAND` | Установите `1` для скрытия команды `/upgrade` |

446| `DO_NOT_TRACK` | Установите `1` для отказа от телеметрии, с тем же эффектом, что и `DISABLE_TELEMETRY`, включая недоступность [Remote Control](/docs/ru/remote-control#requirements) и других [функций, требующих получения флагов функций](#features-that-need-feature-flag-fetching). Claude Code читает эту переменную как стандартное логическое значение, поэтому `0` оставляет телеметрию включенной и соблюдает это как кросс-инструментальное соглашение, признанное многими CLI разработчиков |446| `DO_NOT_TRACK` | Установите `1` для отказа от телеметрии с тем же эффектом, что и `DISABLE_TELEMETRY`, включая недоступность [Remote Control](/docs/ru/remote-control#requirements) и других [функций, требующих получения флагов функций](#features-that-need-feature-flag-fetching). Claude Code читает эту переменную как стандартный логический, поэтому `0` оставляет телеметрию включенной и соблюдает ее как кросс-инструментальное соглашение, признанное многими CLI разработчиков |

447| `ENABLE_BETA_TRACING_DETAILED` | Установите `1` вместе с `BETA_TRACING_ENDPOINT` для включения [детальной бета-трассировки](/docs/ru/monitoring-usage#traces-beta), которая добавляет атрибуты пролета, содержащие содержимое, и пролет `claude_code.hook`. Интерактивные сеансы CLI также требуют, чтобы ваша организация была в списке разрешений для бета-версии. Обе переменные игнорируются в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |447| `ENABLE_BETA_TRACING_DETAILED` | Установите `1` вместе с `BETA_TRACING_ENDPOINT` для включения [детального бета-трассирования](/docs/ru/monitoring-usage#traces-beta), которое добавляет атрибуты span, содержащие содержимое, и span `claude_code.hook`. Интерактивные сеансы CLI также требуют, чтобы ваша организация была в списке разрешений для бета-версии. Обе переменные игнорируются в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

448| `ENABLE_CLAUDEAI_MCP_SERVERS` | Установите `false` для остановки Claude Code от получения [MCP серверов claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai). Включено по умолчанию для вошедших в систему пользователей. Чтобы отключить для каждого проекта или организации, установите [`disableClaudeAiConnectors`](/docs/ru/settings-reference#disableclaudeaiconnectors) в параметрах вместо этого |448| `ENABLE_CLAUDEAI_MCP_SERVERS` | Установите `false` для остановки Claude Code от получения [серверов MCP claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai). Включено по умолчанию для вошедших в систему пользователей. Чтобы отключить для каждого проекта или организации, установите [`disableClaudeAiConnectors`](/docs/ru/settings-reference#disableclaudeaiconnectors) в параметрах вместо этого |

449| `ENABLE_PROMPT_CACHING_1H` | Установите `1` для запроса [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) в 1 час вместо значения по умолчанию 5 минут. Предназначено для пользователей ключей API, [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Пользователи подписки в рамках включенного использования получают TTL в 1 час автоматически на [основном разговоре](/docs/ru/prompt-caching#which-ttl-each-request-gets). Пользователи подписки, использующие [кредиты использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), могут установить это для сохранения TTL в 1 час. Записи кэша на 1 час выставляются по более высокой ставке. Чтобы выбрать TTL для каждого ведра запроса вместо этого, используйте `CLAUDE_CODE_PROMPT_CACHE_TTL` и `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, которые имеют приоритет над этой переменной |449| `ENABLE_PROMPT_CACHING_1H` | Установите `1` для запроса [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) в 1 час вместо 5 минут по умолчанию. Предназначено для пользователей ключей API, [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Пользователи подписки в рамках включенного использования получают TTL в 1 час автоматически на [основном разговоре](/docs/ru/prompt-caching#which-ttl-each-request-gets). Пользователи подписки, использующие [кредиты использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), могут установить это для сохранения TTL в 1 час. Записи кэша на 1 час выставляются по более высокой ставке. Чтобы выбрать TTL для каждого ведра запроса вместо этого, используйте `CLAUDE_CODE_PROMPT_CACHE_TTL` и `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, которые имеют приоритет над этой переменной |

450| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Устарело. Используйте `ENABLE_PROMPT_CACHING_1H` вместо этого |450| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Устарело. Используйте `ENABLE_PROMPT_CACHING_1H` вместо этого |

451| `ENABLE_TOOL_SEARCH` | Контролирует [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search). Если не установлено, Claude Code откладывает все инструменты MCP по умолчанию. Он по-прежнему загружает их заранее на моделях Google Cloud's Agent Platform ранее поколения Claude 4.5, на развертывании Microsoft Foundry, размещенном на Azure, и когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся первой стороной. `true` всегда откладывает и отправляет заголовок бета-версии, за исключением этих же моделей Agent Platform и развертываний Microsoft Foundry; запросы завершаются на прокси, которые не поддерживают `tool_reference`. `auto` загружает заранее, когда определения инструментов подходят в пределах 10% контекста. `auto:N` устанавливает пользовательский порог, такой как `auto:5` для 5%. `false` загружает все инструменты заранее. Значение, которое вы устанавливаете сами, игнорируется, когда установлен `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`. До версии 2.1.221 Claude Code отключал поиск инструментов для всех моделей на Google Cloud's Agent Platform, если вы не установили эту переменную на `true` |451| `ENABLE_TOOL_SEARCH` | Контролирует [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search). Если не установлено, Claude Code откладывает все инструменты MCP по умолчанию. Он по-прежнему загружает их заранее на моделях Google Cloud's Agent Platform ранее поколения Claude 4.5, на развертывании Microsoft Foundry, размещенном на Azure, и когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся первой стороной. `true` всегда откладывает и отправляет заголовок бета-версии, за исключением этих же моделей Agent Platform и развертываний Microsoft Foundry; запросы завершаются на прокси, которые не поддерживают `tool_reference`. `auto` загружает заранее, когда определения инструментов подходят в пределах 10% контекста. `auto:N` устанавливает пользовательский порог, такой как `auto:5` для 5%. `false` загружает все инструменты заранее. Значение, которое вы устанавливаете сами, игнорируется, когда установлен `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`. До версии 2.1.221 Claude Code отключал поиск инструментов для всех моделей на Google Cloud's Agent Platform, если вы не установили эту переменную на `true` |

452| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Установите на любое непустое значение, такое как `1`, для того, чтобы Claude Code перестал повторять попытки при повторных ошибках перегрузки для каждой модели, когда не настроена модель резервного варианта. **Установка его на `0` или `false` по-прежнему включает это**, в отличие от большинства переменных включения/отключения; отмените установку переменной для восстановления поведения повтора по умолчанию. Без этого Claude Code перестает повторять попытки таким образом на моделях, которые он распознает как модели Opus, Fable или Mythos, когда вы аутентифицируетесь с помощью ключа API или [сторонних поставщиков](/docs/ru/third-party-integrations), а не подписки Claude. На Claude Code версии 2.1.160 или позже Claude Code переключается на вашу настроенную [цепочку модели резервного варианта](/docs/ru/model-config#fallback-model-chains) при повторных ошибках перегрузки для любой основной модели, поэтому эта переменная не влияет на переключение на модель резервного варианта |452| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Установите на любое непустое значение, такое как `1`, для того, чтобы Claude Code перестал повторять попытки при повторных ошибках перегрузки для каждой модели, когда не настроена резервная модель. **Установка его на `0` или `false` по-прежнему включает это**, в отличие от большинства переменных включения/отключения; отмените установку переменной для восстановления поведения повтора по умолчанию. Без этого Claude Code перестает повторять попытки таким образом на моделях, которые он распознает как модели Opus, Fable или Mythos, когда вы аутентифицируетесь с помощью ключа API или [сторонних поставщиков](/docs/ru/third-party-integrations), а не подписки Claude. На Claude Code версии 2.1.160 или позже Claude Code переключается на вашу настроенную [цепочку резервных моделей](/docs/ru/model-config#fallback-model-chains) при повторных ошибках перегрузки для любой основной модели, поэтому эта переменная не влияет на переключение на резервную модель |

453| `FORCE_AUTOUPDATE_PLUGINS` | Установите `1` для принудительного автообновления плагинов даже когда основной автообновитель отключен через `DISABLE_AUTOUPDATER` |453| `FORCE_AUTOUPDATE_PLUGINS` | Установите `1` для принудительного автоматического обновления плагинов даже при отключении основного автоматического обновления через `DISABLE_AUTOUPDATER` |

454| `FORCE_HYPERLINK` | Установите `1` для включения кликабельных гиперссылок OSC 8, когда ваш терминал их поддерживает, но не автоопределяется, или `0` для отключения. Если не установлено, Claude Code включает гиперссылки только когда обнаруживает поддержку терминала. Claude Code анализирует это значение как число, а не логическое значение, поэтому значение, такое как `false`, `no` или `off`, включает гиперссылки, а не отключает их. Значок [статуса PR или merge request](/docs/ru/interactive-mode#pr-review-status) в нижнем колонтитуле отображается как гиперссылка даже когда Claude Code не может обнаружить поддержку терминала, например через SSH. Установите `0` для отображения значка как простого текста |454| `FORCE_HYPERLINK` | Установите `1` для включения кликабельных гиперссылок OSC 8, когда ваш терминал их поддерживает, но не автоопределяется, или `0` для отключения. Если не установлено, Claude Code включает гиперссылки только при обнаружении поддержки терминала. Claude Code анализирует это значение как число, а не логический, поэтому значение, такое как `false`, `no` или `off`, включает гиперссылки, а не отключает их. Значок [статуса PR или merge request](/docs/ru/interactive-mode#pr-review-status) в нижнем колонтитуле отображается как гиперссылка даже при невозможности обнаружения поддержки терминала, например через SSH. Установите `0` для отображения значка как простого текста |

455| `FORCE_PROMPT_CACHING_5M` | Установите `1` для принудительного применения TTL кэша подсказок в 5 минут даже когда TTL в 1 час в противном случае применялся бы. Переопределяет `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` и параметры `promptCacheTtl` и `subagentPromptCacheTtl` |455| `FORCE_PROMPT_CACHING_5M` | Установите `1` для принудительного применения TTL кэша подсказок в 5 минут даже при применении TTL в 1 час. Переопределяет `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` и параметры `promptCacheTtl` и `subagentPromptCacheTtl` |

456| `HTTP_PROXY` | Укажите HTTP прокси-сервер для сетевых подключений |456| `HTTP_PROXY` | Укажите сервер HTTP прокси для сетевых подключений |

457| `HTTPS_PROXY` | Укажите HTTPS прокси-сервер для сетевых подключений |457| `HTTPS_PROXY` | Укажите сервер HTTPS прокси для сетевых подключений |

458| `IS_DEMO` | Установите на любое непустое значение, такое как `1`, для включения режима демонстрации: скрывает ваш адрес электронной почты и имя организации из заголовка и вывода `/status`, и пропускает адаптацию. **Установка его на `0` или `false` по-прежнему включает режим демонстрации**, в отличие от большинства переменных включения/отключения; отмените установку переменной для отключения. Полезно при потоковой передаче или записи сеанса |458| `IS_DEMO` | Установите на любое непустое значение, такое как `1`, для включения режима демонстрации: скрывает ваш адрес электронной почты и имя организации из заголовка и вывода `/status`, и пропускает onboarding. **Установка его на `0` или `false` по-прежнему включает режим демонстрации**, в отличие от большинства переменных включения/отключения; отмените установку переменной для отключения. Полезно при потоковой передаче или записи сеанса |

459| `MAX_MCP_OUTPUT_TOKENS` | Максимальное количество токенов, разрешенных в ответах инструментов MCP. Claude Code отображает предупреждение, когда вывод превышает 10 000 токенов. Инструменты, которые объявляют [`anthropic/maxResultSizeChars`](/docs/ru/mcp#raise-the-limit-for-a-specific-tool), используют это ограничение символов для текстового содержимого вместо этого, но содержимое изображения из этих инструментов по-прежнему подчиняется этой переменной (по умолчанию: 25000) |459| `MAX_MCP_OUTPUT_TOKENS` | Максимальное количество токенов, разрешенных в ответах инструментов MCP. Claude Code отображает предупреждение, когда вывод превышает 10 000 токенов. Инструменты, которые объявляют [`anthropic/maxResultSizeChars`](/docs/ru/mcp#raise-the-limit-for-a-specific-tool), используют это ограничение символов для текстового содержимого вместо этого, но содержимое изображения из этих инструментов по-прежнему подлежит этой переменной (по умолчанию: 25000) |

460| `MAX_STRUCTURED_OUTPUT_RETRIES` | Количество попыток Claude Code разрешает, когда ответ модели не проходит проверку против [`--json-schema`](/docs/ru/cli-reference#cli-flags) в неинтерактивном режиме с флагом `-p`; после такого количества неудачных попыток без действительного вывода запуск завершается. То же ограничение применяется, когда структурированный вывод подагента [workflow](/docs/ru/workflows) не проходит проверку. По умолчанию 5, первая попытка плюс четыре повтора |460| `MAX_STRUCTURED_OUTPUT_RETRIES` | Количество попыток Claude Code разрешает, когда ответ модели не проходит проверку против [`--json-schema`](/docs/ru/cli-reference#cli-flags) в неинтерактивном режиме с флагом `-p`; после такого количества неудачных попыток без действительного вывода запуск завершается. То же ограничение применяется, когда структурированный вывод [subagent workflow](/docs/ru/workflows) не проходит проверку. По умолчанию 5, первая попытка плюс четыре повтора |

461| `MAX_THINKING_TOKENS` | Фиксированный бюджет токенов для [расширенного мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code ограничивает это одним токеном ниже максимального выходного токена запроса и никогда ниже 1,024. См. `CLAUDE_CODE_MAX_OUTPUT_TOKENS` для того, как устанавливается это ограничение. Если не установлено и мышление включено, модели с [адаптивным рассуждением](/docs/ru/model-config#adjust-effort-level) выбирают свою собственную глубину мышления, и другие модели используют ограничение. Установите `0` для отключения мышления на API Anthropic, за исключением моделей Fable, которые не могут иметь отключенное мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations) `0` пропускает параметр `thinking` вместо этого. При отключенном мышлении на API Anthropic Claude Code отправляет effort `high` вместо более высокого уровня на моделях, которые он знает [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5. Claude Code игнорирует ненулевые значения на моделях адаптивного рассуждения, за исключением моделей, где `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` отключает адаптивное рассуждение |461| `MAX_THINKING_TOKENS` | Фиксированный бюджет токенов для [расширенного мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code ограничивает его одним токеном ниже максимального выходного токена запроса и никогда ниже 1,024. См. `CLAUDE_CODE_MAX_OUTPUT_TOKENS` для того, как устанавливается это ограничение. Если не установлено и мышление включено, модели с [адаптивным рассуждением](/docs/ru/model-config#adjust-effort-level) выбирают свою собственную глубину мышления, и другие модели используют ограничение. Установите `0` для отключения мышления на API Anthropic, за исключением моделей Fable, которые не могут иметь отключенное мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations) `0` пропускает параметр `thinking` вместо этого. При отключенном мышлении на API Anthropic Claude Code отправляет effort `high` вместо более высокого уровня на моделях, которые он знает [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5. Claude Code игнорирует ненулевые значения на моделях адаптивного рассуждения, за исключением моделей, где `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` отключает адаптивное рассуждение |

462| `MCP_CLIENT_SECRET` | Секрет клиента OAuth для MCP серверов, которые требуют [предварительно настроенные учетные данные](/docs/ru/mcp#use-pre-configured-oauth-credentials). Избегает интерактивного запроса при добавлении сервера с `--client-secret` |462| `MCP_CLIENT_SECRET` | Секрет клиента OAuth для серверов MCP, которые требуют [предварительно настроенные учетные данные](/docs/ru/mcp#use-pre-configured-oauth-credentials). Избегает интерактивного запроса при добавлении сервера с `--client-secret` |

463| `MCP_CONNECTION_NONBLOCKING` | Контролирует, ждет ли запуск MCP серверов для подключения перед первым запросом. Запуск MCP неблокирующий по умолчанию: серверы подключаются в фоновом режиме и их инструменты становятся доступными по мере завершения. Установите `0` для ожидания Claude Code подключения серверов перед первым запросом. Серверы, настроенные с [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral), по-прежнему заставляют запуск ждать независимо от этого, за исключением случаев, когда они обслуживаются из [кэша обнаружения](/docs/ru/mcp#server-status-detail), так как их инструменты должны присутствовать при построении первой подсказки. В неинтерактивном режиме (`-p`) без `--input-format stream-json` Claude Code также ждет все еще ожидающих серверов перед первым ходом независимо от этой переменной. Когда вы передаете [`--mcp-config`](/docs/ru/cli-reference#cli-flags) явно, ожидание имеет более длительный крайний срок; см. запись этого флага для исключения кэшированного сервера |463| `MCP_CONNECTION_NONBLOCKING` | Контролирует, ждет ли запуск подключения серверов MCP перед первым запросом. Запуск MCP неблокирующий по умолчанию: серверы подключаются в фоновом режиме и их инструменты становятся доступными по мере завершения. Установите `0` для ожидания подключения серверов перед первым запросом. Серверы, настроенные с [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral), по-прежнему заставляют запуск ждать независимо, за исключением случаев, когда они обслуживаются из [кэша обнаружения](/docs/ru/mcp#server-status-detail), так как их инструменты должны присутствовать при построении первой подсказки. В неинтерактивном режиме (`-p`) без `--input-format stream-json` Claude Code также ждет все еще ожидающих серверов перед первым ходом независимо от этой переменной. Когда вы передаете [`--mcp-config`](/docs/ru/cli-reference#cli-flags) явно, ожидание имеет более длительный крайний срок; см. запись этого флага для исключения кэшированного сервера |

464| `MCP_CONNECT_TIMEOUT_MS` | Как долго блокирующий запуск MCP ждет, в миллисекундах, пакета подключения перед снимком списка инструментов (по умолчанию: 5000). Применяется, когда `MCP_CONNECTION_NONBLOCKING=0` или для серверов, отмеченных [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral). Серверы все еще ожидающие на крайнем сроке продолжают подключаться в фоновом режиме. Отличается от `MCP_TIMEOUT`, который ограничивает попытку подключения отдельного сервера |464| `MCP_CONNECT_TIMEOUT_MS` | Как долго блокирующий запуск MCP ждет, в миллисекундах, пакета подключения перед снимком списка инструментов (по умолчанию: 5000). Применяется, когда `MCP_CONNECTION_NONBLOCKING=0` или для серверов, отмеченных [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral). Серверы все еще ожидающие на крайнем сроке продолжают подключаться в фоновом режиме. Отличается от `MCP_TIMEOUT`, который ограничивает попытку подключения отдельного сервера |

465| `MCP_DISCOVERY_CACHE` | Включает или отключает [кэш обнаружения MCP](/docs/ru/mcp#server-status-detail). С включенным кэшем удаленный HTTP или SSE сервер, который вы использовали раньше, может показать [статус `cached`](/docs/ru/mcp#server-status-detail), и Claude Code подключает его при первом вызове инструмента вместо запуска. Кэш отключен по умолчанию, если постепенное развертывание не включило его для вашей учетной записи. Установите `1` для включения или `0` для сохранения отключенным даже когда развертывание включило его. До версии 2.1.238 кэш был включен по умолчанию. Статус `cached` требует Claude Code версии 2.1.221 или позже |465| `MCP_DISCOVERY_CACHE` | Включает или отключает [кэш обнаружения MCP](/docs/ru/mcp#server-status-detail). С включенным кэшем удаленный HTTP или SSE сервер, который вы использовали раньше, может показать [статус `cached`](/docs/ru/mcp#server-status-detail), и Claude Code подключает его при первом вызове инструмента вместо запуска. Кэш отключен по умолчанию, если постепенный rollout не включил его для вашей учетной записи. Установите `1` для включения или `0` для сохранения отключенным даже при включении rollout. До версии 2.1.238 кэш был включен по умолчанию. Статус `cached` требует Claude Code версии 2.1.221 или позже |

466| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Максимальный возраст в секундах записи [кэша обнаружения](/docs/ru/mcp#server-status-detail) (по умолчанию: 14400 или 4 часа). При запуске, где запись старше этого, Claude Code отбрасывает ее и подключает сервер при запуске, как при отключенном кэше. Claude Code ограничивает значение 7 днями. До версии 2.1.238 значение по умолчанию было 86400 или 24 часа, и Claude Code не ограничивал значение |466| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Максимальный возраст в секундах записи [кэша обнаружения](/docs/ru/mcp#server-status-detail) (по умолчанию: 14400 или 4 часа). При запуске, где запись старше этого, Claude Code отбрасывает ее и подключает сервер при запуске, как при отключенном кэше. Claude Code ограничивает значение до 7 дней. До версии 2.1.238 значение по умолчанию было 86400 или 24 часа, и Claude Code не ограничивал значение |

467| `MCP_DISCOVERY_CACHE_STRIKES` | При запуске, где запись [кэша обнаружения](/docs/ru/mcp#server-status-detail) старше `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code обновляет ее в фоновом режиме. Эта переменная устанавливает, сколько обновлений подряд может завершиться с ошибкой перед тем как Claude Code отбросит запись и подключит сервер при следующем запуске вместо этого (по умолчанию: 1). Повысьте это, если ваше сетевое подключение иногда отключается, чтобы одно неудачное обновление не отбросило запись. Требует Claude Code версии 2.1.238 или позже |467| `MCP_DISCOVERY_CACHE_STRIKES` | При запуске, где запись [кэша обнаружения](/docs/ru/mcp#server-status-detail) старше `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code обновляет ее в фоновом режиме. Эта переменная устанавливает, сколько обновлений подряд может завершиться с ошибкой перед тем, как Claude Code отбросит запись и подключит сервер при следующем запуске вместо этого (по умолчанию: 1). Повысьте это, если ваше сетевое подключение иногда отключается, чтобы одно неудачное обновление не отбросило запись. Требует Claude Code версии 2.1.238 или позже |

468| `MCP_DISCOVERY_CACHE_TTL_S` | Секунды, в течение которых Claude Code использует запись [кэша обнаружения](/docs/ru/mcp#server-status-detail) без обновления (по умолчанию: 900). При запуске, где запись старше этого, Claude Code по-прежнему использует ее, но обновляет в фоновом режиме. Как только запись старше `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code отбрасывает ее вместо этого. Claude Code ограничивает значение `MCP_DISCOVERY_CACHE_MAX_STALE_S`, которое по умолчанию составляет 4 часа. До версии 2.1.238 Claude Code не ограничивал значение |468| `MCP_DISCOVERY_CACHE_TTL_S` | Секунды, в течение которых Claude Code использует запись [кэша обнаружения](/docs/ru/mcp#server-status-detail) без обновления (по умолчанию: 900). При запуске, где запись старше этого, Claude Code по-прежнему использует ее, но обновляет ее в фоновом режиме. После того, как запись старше `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code отбрасывает ее вместо этого. Claude Code ограничивает значение до `MCP_DISCOVERY_CACHE_MAX_STALE_S`, что составляет 4 часа по умолчанию. До версии 2.1.238 Claude Code не ограничивал значение |

469| `MCP_OAUTH_CALLBACK_PORT` | Фиксированный порт для обратного вызова перенаправления OAuth, как альтернатива `--callback-port` при добавлении MCP сервера с [предварительно настроенными учетными данными](/docs/ru/mcp#use-pre-configured-oauth-credentials) |469| `MCP_OAUTH_CALLBACK_PORT` | Фиксированный порт для обратного вызова перенаправления OAuth, как альтернатива `--callback-port` при добавлении сервера MCP с [предварительно настроенными учетными данными](/docs/ru/mcp#use-pre-configured-oauth-credentials) |

470| `MCP_PROTOCOL_NEGOTIATION` | На [v2 MCP клиентском рантайме](/docs/ru/mcp#mcp-client-runtimes) только, проверяет ли Claude Code серверы для пересмотра протокола MCP 2026-07-28. Установите `auto` для проверки HTTP, соединителей claude.ai и серверов stdio; сервер, который не отвечает на зонд, подключается на более раннем протоколе вместо этого, как серверы SSE и WebSocket всегда делают. Установите `legacy` для пропуска зонда для каждого сервера. Без переменной Claude Code проверяет HTTP серверы и также проверяет серверы соединителей claude.ai в сеансах, где он [получает флаги функций](#features-that-need-feature-flag-fetching). Любое другое значение игнорируется с предупреждением в журнале отладки. Требует Claude Code версии 2.1.221 или позже |470| `MCP_PROTOCOL_NEGOTIATION` | На [v2 MCP client runtime](/docs/ru/mcp#mcp-client-runtimes) только, проверяет ли Claude Code серверы на ревизию протокола MCP 2026-07-28. Установите `auto` для проверки HTTP, claude.ai connector и серверов stdio; сервер, который не отвечает на зонд, подключается на более ранний протокол вместо этого, как серверы SSE и WebSocket всегда делают. Установите `legacy` для пропуска зонда для каждого сервера. Без переменной Claude Code проверяет HTTP серверы и также проверяет серверы claude.ai connector в сеансах, где он [получает флаги функций](#features-that-need-feature-flag-fetching). Любое другое значение игнорируется с предупреждением в журнале отладки. Требует Claude Code версии 2.1.221 или позже |

471| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество удаленных MCP серверов (HTTP/SSE) для подключения параллельно при запуске (по умолчанию: 20) |471| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество удаленных серверов MCP (HTTP/SSE) для подключения параллельно при запуске (по умолчанию: 20) |

472| `MCP_SDK_GENERATION` | Закрепить, какой [MCP клиентский рантайм](/docs/ru/mcp#mcp-client-runtimes) этот процесс подключает к MCP серверам: `v1`, построенный на MCP TypeScript SDK 1.x, или `v2`, построенный на [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Без переменной Claude Code использует v2, начиная с версий, перечисленных в этом разделе. На Claude Code версии 2.1.221 или позже рантайм v2 проверяет издателя, который MCP OAuth сервер возвращает в своем ответе авторизации, и завершает вход с ошибкой, которая начинается с `Issuer mismatch in authorization response`, когда это не совпадает. Рантайм v1 не выполняет эту проверку. Если вы установите неузнанное значение, Claude Code игнорирует его и записывает предупреждение в журнал отладки. Claude Code читает значение один раз за процесс. Требует Claude Code версии 2.1.218 или позже |472| `MCP_SDK_GENERATION` | Закрепить, какой [MCP client runtime](/docs/ru/mcp#mcp-client-runtimes) этот процесс подключает к серверам MCP: `v1`, построенный на MCP TypeScript SDK 1.x, или `v2`, построенный на [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Без переменной Claude Code использует v2, начиная с версий, перечисленных в этом разделе. На Claude Code версии 2.1.221 или позже v2 runtime проверяет издателя, который сервер OAuth MCP возвращает в своем ответе авторизации, и завершает вход с ошибкой, которая начинается с `Issuer mismatch in authorization response`, когда он не совпадает. V1 runtime не выполняет эту проверку. Если вы установите неузнанное значение, Claude Code игнорирует его и записывает предупреждение в журнал отладки. Claude Code читает значение один раз за процесс. Требует Claude Code версии 2.1.218 или позже |

473| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество локальных MCP серверов (stdio) для подключения параллельно при запуске (по умолчанию: 3) |473| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество локальных серверов MCP (stdio) для подключения параллельно при запуске (по умолчанию: 3) |

474| `MCP_TIMEOUT` | Таймаут в миллисекундах для запуска MCP сервера (по умолчанию: 30000 или 30 секунд) |474| `MCP_TIMEOUT` | Таймаут в миллисекундах для запуска сервера MCP (по умолчанию: 30000 или 30 секунд) |

475| `MCP_TOOL_TIMEOUT` | Таймаут в миллисекундах для выполнения инструмента MCP (по умолчанию: 100000000, примерно 28 часов). Для HTTP, SSE или сервера соединителя claude.ai каждый запрос также истекает через 60 секунд по умолчанию; установите эту переменную или сервер `timeout` выше 60000 для повышения этого ограничения для каждого запроса. Более низкое значение по-прежнему сокращает общий таймаут выполнения инструмента, но оставляет ограничение для каждого запроса на 60 секунд. Серверы stdio и WebSocket не имеют таймера для каждого запроса. Поле `timeout` для каждого сервера в `.mcp.json` переопределяет это для этого сервера. Поле `timeout` для каждого сервера по крайней мере 1000 также устанавливает минимальное окно простоя для вызовов инструментов этого сервера, поэтому `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` никогда не прерывает их раньше; этот пол требует Claude Code версии 2.1.203 или позже. Для переменной окружения значения ниже 1000 ограничиваются одной секундой; для поля для каждого сервера значения ниже 1000 игнорируются |475| `MCP_TOOL_TIMEOUT` | Таймаут в миллисекундах для выполнения инструмента MCP (по умолчанию: 100000000, примерно 28 часов). Для HTTP, SSE или сервера claude.ai connector каждый запрос также истекает через 60 секунд по умолчанию; установите эту переменную или сервер `timeout` выше 60000 для повышения этого ограничения для каждого запроса. Более низкое значение по-прежнему сокращает общий таймаут выполнения инструмента, но оставляет ограничение для каждого запроса на 60 секунд. Серверы Stdio и WebSocket не имеют таймера для каждого запроса. Поле `timeout` для каждого сервера в `.mcp.json` переопределяет это для этого сервера. Поле `timeout` для каждого сервера по крайней мере 1000 также устанавливает минимальное окно простоя для вызовов инструментов этого сервера, поэтому `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` никогда не прерывает их раньше; этот пол требует Claude Code версии 2.1.203 или позже. Для переменной окружения значения ниже 1000 ограничены до одной секунды; для поля для каждого сервера значения ниже 1000 игнорируются |

476| `NO_PROXY` | Список доменов и IP, на которые запросы будут выданы напрямую, обходя прокси |476| `NO_PROXY` | Список доменов и IP-адресов, на которые запросы будут выданы напрямую, обходя прокси |

477| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Стандартное ограничение SDK OpenTelemetry на длину значения атрибута. Claude Code ограничивает атрибуты телеметрии, содержащие содержимое, меньшим из этого и `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, поэтому маркер усечения остается в пределах ограничения SDK. Claude Code читает варианты `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` и `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` так же и применяется наименьшее установленное значение ко всем сигналам. Требует Claude Code версии 2.1.214 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#common-configuration-variables) |477| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Стандартное ограничение SDK OpenTelemetry на длину значения атрибута. Claude Code ограничивает атрибуты телеметрии, содержащие содержимое, меньшим из этого и `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, поэтому маркер усечения остается в пределах ограничения SDK. Claude Code читает варианты `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` и `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` так же, и наименьшее установленное значение применяется ко всем сигналам. Требует Claude Code версии 2.1.214 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#common-configuration-variables) |

478| `OTEL_LOG_ASSISTANT_RESPONSES` | Установите `1` для включения текста ответа модели в события журнала OpenTelemetry `assistant_response`. Если не установлено, используется значение `OTEL_LOG_USER_PROMPTS`. Установите `0` для сохранения ответов отредактированными даже когда установлен `OTEL_LOG_USER_PROMPTS`. Требует Claude Code версии 2.1.193 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#assistant-response-event) |478| `OTEL_LOG_ASSISTANT_RESPONSES` | Установите `1` для включения текста ответа модели в события журнала OpenTelemetry `assistant_response`. Если не установлено, используется значение `OTEL_LOG_USER_PROMPTS`. Установите `0` для сохранения ответов отредактированными даже при установке `OTEL_LOG_USER_PROMPTS`. Требует Claude Code версии 2.1.193 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#assistant-response-event) |

479| `OTEL_LOG_RAW_API_BODIES` | Выдавать JSON запроса и ответа API Anthropic Messages как события журнала `api_request_body` / `api_response_body`. Установите `1` для встроенных тел, усеченных на пределе содержимого, или `file:<dir>` для записи неусеченных тел на диск и выдачи пути `body_ref` вместо этого. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` настраивает предел содержимого, 60 КБ по умолчанию. Отключено по умолчанию; тела включают всю историю разговора. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). См. [Мониторинг](/docs/ru/monitoring-usage#api-request-body-event) |479| `OTEL_LOG_RAW_API_BODIES` | Выдавать JSON запроса и ответа API Anthropic Messages как события журнала `api_request_body` / `api_response_body`. Установите `1` для встроенных тел, усеченных на пределе содержимого, или `file:<dir>` для записи неусеченных тел на диск и выдачи пути `body_ref` вместо этого. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` настраивает предел содержимого, 60 КБ по умолчанию. Отключено по умолчанию; тела включают всю историю разговора. Установите его в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). См. [Мониторинг](/docs/ru/monitoring-usage#api-request-body-event) |

480| `OTEL_LOG_TOOL_CONTENT` | Установите `1` для включения содержимого инструмента в событие пролета OpenTelemetry `tool.output`. Атрибуты пролета несут содержимое инструмента под [своими собственными вратами](/docs/ru/monitoring-usage#new-context-gates). Требует [трассировку](/docs/ru/monitoring-usage#traces-beta). Отключено по умолчанию для защиты конфиденциальных данных. См. [Мониторинг](/docs/ru/monitoring-usage#tool-output-span-event) |480| `OTEL_LOG_TOOL_CONTENT` | Установите `1` для включения содержимого инструмента в событие span OpenTelemetry `tool.output`. Атрибуты span переносят содержимое инструмента в [их собственные ворота](/docs/ru/monitoring-usage#new-context-gates). Требует [трассировку](/docs/ru/monitoring-usage#traces-beta). Отключено по умолчанию для защиты конфиденциальных данных. См. [Мониторинг](/docs/ru/monitoring-usage#tool-output-span-event) |

481| `OTEL_LOG_TOOL_DETAILS` | Установите `1` для включения аргументов входа инструмента, имен MCP серверов, имен workflow, созданных пользователем, необработанных строк ошибок при отказах инструментов, категории отказа `category` на событиях `api_refusal` и других деталей инструмента в трассировках и журналах OpenTelemetry. Отключено по умолчанию для защиты PII. См. [Мониторинг](/docs/ru/monitoring-usage) |481| `OTEL_LOG_TOOL_DETAILS` | Установите `1` для включения аргументов входных данных инструмента, имен серверов MCP, имен workflow, созданных пользователем, необработанных строк ошибок при сбоях инструмента, категории отказа на событиях `api_refusal` и других деталей инструмента в трассировках и журналах OpenTelemetry. Отключено по умолчанию для защиты PII. См. [Мониторинг](/docs/ru/monitoring-usage) |

482| `OTEL_LOG_USER_PROMPTS` | Установите `1` для включения текста подсказки пользователя в трассировки и журналы OpenTelemetry. Отключено по умолчанию (подсказки отредактированы). См. [Мониторинг](/docs/ru/monitoring-usage) |482| `OTEL_LOG_USER_PROMPTS` | Установите `1` для включения текста подсказки пользователя в трассировки и журналы OpenTelemetry. Отключено по умолчанию (подсказки отредактированы). См. [Мониторинг](/docs/ru/monitoring-usage) |

483| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Установите `false` для исключения UUID учетной записи из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage) |483| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Установите `false` для исключения UUID учетной записи из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage) |

484| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Установите `true` для включения точки входа сеанса в атрибуты метрик (по умолчанию: исключено). Добавлено в версии 2.1.152. См. [Мониторинг](/docs/ru/monitoring-usage) |484| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Установите `true` для включения точки входа сеанса в атрибуты метрик (по умолчанию: исключено). Добавлено в версии 2.1.152. См. [Мониторинг](/docs/ru/monitoring-usage) |

485| `OTEL_METRICS_INCLUDE_REPOSITORY` | Установите `true` для тегирования метрик и событий OpenTelemetry с атрибутами `vcs.*`, определяющими репозиторий сеанса (по умолчанию: исключено). Требует Claude Code версии 2.1.269 или позже. См. [Атрибуты репозитория](/docs/ru/monitoring-usage#repository-attributes) |485| `OTEL_METRICS_INCLUDE_REPOSITORY` | Установите `true` для тегирования метрик и событий OpenTelemetry атрибутами `vcs.*`, определяющими репозиторий сеанса (по умолчанию: исключено). Требует Claude Code версии 2.1.269 или позже. См. [Атрибуты репозитория](/docs/ru/monitoring-usage#repository-attributes) |

486| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Начиная с версии 2.1.161, Claude Code присоединяет ключи `OTEL_RESOURCE_ATTRIBUTES` к меткам точек данных метрик. Установите `false` для исключения (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage#multi-team-organization-support) |486| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Начиная с версии 2.1.161, Claude Code прикрепляет ключи `OTEL_RESOURCE_ATTRIBUTES` к меткам точек данных метрик. Установите `false` для исключения их (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage#multi-team-organization-support) |

487| `OTEL_METRICS_INCLUDE_SESSION_ID` | Установите `false` для исключения ID сеанса из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage) |487| `OTEL_METRICS_INCLUDE_SESSION_ID` | Установите `false` для исключения ID сеанса из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage) |

488| `OTEL_METRICS_INCLUDE_VERSION` | Установите `true` для включения версии Claude Code в атрибуты метрик (по умолчанию: исключено). См. [Мониторинг](/docs/ru/monitoring-usage) |488| `OTEL_METRICS_INCLUDE_VERSION` | Установите `true` для включения версии Claude Code в атрибуты метрик (по умолчанию: исключено). См. [Мониторинг](/docs/ru/monitoring-usage) |

489| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Переопределить бюджет символов для метаданных skill, показанных [инструменту Skill](/docs/ru/skills#control-who-invokes-a-skill). Бюджет масштабируется динамически на 1% окна контекста, с резервным значением 8,000 символов. Устаревшее имя сохранено для обратной совместимости |489| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Переопределить бюджет символов для метаданных skill, показанных [инструменту Skill](/docs/ru/skills#control-who-invokes-a-skill). Бюджет масштабируется динамически на 1% окна контекста с резервным значением 8,000 символов. Имя, сохраненное для обратной совместимости |

490| `TASK_MAX_OUTPUT_LENGTH` | Максимальное количество символов вывода [фоновой задачи](/docs/ru/tools-reference#background-commands), которое инструмент `TaskOutput` сохраняет (по умолчанию: 32000; максимум: 160000). Если вы установите параметр [`taskOutputMaxChars`](/docs/ru/settings-reference#taskoutputmaxchars), Claude Code игнорирует эту переменную |490| `TASK_MAX_OUTPUT_LENGTH` | Максимальное количество символов вывода [фоновой задачи](/docs/ru/tools-reference#background-commands), которое инструмент `TaskOutput` сохраняет (по умолчанию: 32000; максимум: 160000). Если вы установите параметр [`taskOutputMaxChars`](/docs/ru/settings-reference#taskoutputmaxchars), Claude Code игнорирует эту переменную |

491| `USE_BUILTIN_RIPGREP` | Установите `0` для использования установленного в системе `rg` вместо `rg`, включенного в Claude Code |491| `USE_BUILTIN_RIPGREP` | Установите `0` для использования установленного в системе `rg` вместо `rg`, включенного в Claude Code |

492| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Переопределить регион для Claude 3.5 Haiku при использовании Google Cloud's Agent Platform |492| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Переопределить регион для Claude 3.5 Haiku при использовании Google Cloud's Agent Platform |

errors.md +2 −0

Details

1740 1740 

1741**Что делать:**1741**Что делать:**

1742 1742 

1743Эти шаги изменяют одну из ваших собственных сред. [Организационная общая среда](/docs/ru/cloud-environments#organization-shared-environments) открывается только для чтения в селекторе, поэтому попросите владельца изменить её сетевой доступ со страницы **Cloud environments** в [admin settings](https://claude.ai/admin-settings).

1744 

1743* Откройте подпрограмму для редактирования или запустите облачный сеанс. Выберите значок облака, показывающий имя вашей среды, такое как **Default**, чтобы открыть селектор. Наведите указатель на вашу среду и нажмите значок параметров.1745* Откройте подпрограмму для редактирования или запустите облачный сеанс. Выберите значок облака, показывающий имя вашей среды, такое как **Default**, чтобы открыть селектор. Наведите указатель на вашу среду и нажмите значок параметров.

1744* В диалоговом окне **Update cloud environment** измените **Network access** с **Trusted** на **Custom**, затем добавьте заблокированный домен в **Allowed domains**. Введите один домен в строку. Установите флажок **Also include default list of common package managers**, чтобы сохранить [default allowlist](/docs/ru/cloud-environments#default-allowed-domains) вместе с вашими пользовательскими доменами. Выберите **Full** вместо этого, если вы хотите неограниченный доступ.1746* В диалоговом окне **Update cloud environment** измените **Network access** с **Trusted** на **Custom**, затем добавьте заблокированный домен в **Allowed domains**. Введите один домен в строку. Установите флажок **Also include default list of common package managers**, чтобы сохранить [default allowlist](/docs/ru/cloud-environments#default-allowed-domains) вместе с вашими пользовательскими доменами. Выберите **Full** вместо этого, если вы хотите неограниченный доступ.

1745* Нажмите **Save changes**. Следующий запуск использует обновленный список разрешений.1747* Нажмите **Save changes**. Следующий запуск использует обновленный список разрешений.

Details

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 gateway5# Руководство совместимости Claude Code gateway

6 6 

7> Поддерживайте LLM gateway совместимым с Claude Code: конечные точки, которые он вызывает, заголовки и поля тела для пересылки, и что ломается при их удалении.7> Поддерживайте совместимость LLM gateway с Claude Code: конечные точки, которые он вызывает, заголовки и поля тела, которые необходимо передавать, и что перестает работать при их удалении.

8 8 

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

10 10 

11[Claude apps gateway](/docs/ru/claude-apps-gateway), самостоятельно размещаемый gateway Anthropic, предоставляет собственный справочник конечных точек по адресу `GET /protocol`, охватывающий конечные точки входа, вывода, управляемых параметров, обнаружения моделей и телеметрии этого gateway. Это отдельный документ от этого справочника.11[Claude apps gateway](/docs/ru/claude-apps-gateway), самостоятельно размещаемый шлюз Anthropic, предоставляет собственную справку по конечным точкам по адресу `GET /protocol`, охватывающую конечные точки входа, вывода, управляемых параметров, обнаружения модели и телеметрии этого шлюза. Это отдельный документ от этого руководства.

12 12 

13<Note>13<Note>

14 * Чтобы развернуть существующий или сторонний gateway для вашей организации, см. [Развертывание LLM gateway](/docs/ru/llm-gateway-rollout)14 * Чтобы развернуть существующий или сторонний шлюз для вашей организации, см. [Развертывание LLM gateway](/docs/ru/llm-gateway-rollout)

15 * Если вы отдельный разработчик, аутентифицирующий Claude Code на gateway с учетными данными, которые вам были предоставлены, см. [Подключение Claude Code к LLM gateway](/docs/ru/llm-gateway-connect)15 * Если вы отдельный разработчик, аутентифицирующий Claude Code на шлюзе с учетными данными, которые вам были предоставлены, см. [Подключение Claude Code к LLM gateway](/docs/ru/llm-gateway-connect)

16</Note>16</Note>

17 17 

18На этой странице рассматриваются:18На этой странице рассматривается:

19 19 

20* [Форматы API](#api-formats) и конечные точки для обслуживания каждого20* [Форматы API](#api-formats) и конечные точки для обслуживания для каждого

21* [Заголовки запроса](#request-headers): какие должны достичь upstream и какие ваш gateway может использовать21* [Поведение клиента по методу подключения](#how-the-connection-method-changes-client-behavior): как идентификаторы моделей, значения `anthropic-beta`, поля запроса и значения по умолчанию отличаются между форматами и входом в Claude apps gateway

22* [Блок атрибуции системного приглашения](#system-prompt-attribution-block) и как он взаимодействует с кешированием приглашений22* [Заголовки запроса](#request-headers): какие должны достичь вышестоящего сервера и какие может использовать ваш шлюз

23* [Сквозная передача функций](#feature-pass-through): что ломается при удалении заголовков или полей тела23* [Заголовки ответа](#response-headers): что возвращать, чтобы обнаружение зависания, повторные попытки и отображение лимита использования работали

24* [Обнаружение моделей](#model-discovery)24* [Блок атрибуции системного приглашения](#system-prompt-attribution-block) и как он взаимодействует с кэшированием приглашений

25* [Сквозная передача функций](#feature-pass-through): что перестает работать при удалении заголовков или полей тела

26* [Обнаружение модели](#model-discovery)

25 27 

26На этой странице используются два термина для описания того, что ваш gateway делает с каждым заголовком и полем тела:28На этой странице используются два термина для описания того, что ваш шлюз делает с каждым заголовком и полем тела:

27 29 

28* **Пересылать без изменений**: передать его upstream побайтово30* **Передавать без изменений**: передать его вышестоящему серверу побайтово

29* **Использовать**: gateway может прочитать его для маршрутизации, атрибуции или трассировки и не обязан пересылать его31* **Использовать**: шлюз может прочитать его для маршрутизации, атрибуции или трассировки и не обязан передавать его

30 32 

31Все, что не отмечено как пересылка без изменений, вы можете использовать или игнорировать.33Все, что не отмечено как передача без изменений, вы можете использовать или игнорировать.

32 34 

33<h2 id="api-formats">35<h2 id="api-formats">

34 API форматы36 Форматы API

35</h2>37</h2>

36 38 

37Gateway должен предоставить клиентам Claude Code по крайней мере один из следующих форматов API. Клиент выбирает формат и указывает Claude Code на ваш gateway с помощью переменных в столбце "Выбрано" таблицы ниже.39Шлюз должен предоставлять клиентам Claude Code по крайней мере один из следующих форматов API. Клиент выбирает формат и указывает Claude Code на ваш шлюз с помощью переменных в столбце "Selected by" таблицы ниже.

38 40 

39Google Cloud's Agent Platform — это конечная точка Claude компании Google Cloud, ранее известная как Vertex AI; названия её переменных сохраняют написание `VERTEX`.41Google Cloud's Agent Platform — это конечная точка Claude в Google Cloud, ранее известная как Vertex AI; названия её переменных сохраняют написание `VERTEX`.

40 42 

41| Формат | Выбрано | Конечные точки | Пересылать без изменений |43| Формат | Selected by | Endpoints | Forward unchanged |

42| :--------------------------------------- | :--------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ |44| :--------------------------------------- | :--------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |

43| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (опционально) | заголовки запроса `anthropic-beta` и `anthropic-version` |45| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (опционально) | `anthropic-beta` и `anthropic-version` заголовки запроса |

44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` с `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream`, `/model/{model}/count-tokens` (опционально) | поля тела запроса `anthropic_beta` и `anthropic_version` |46| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` с `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream`, `/model/{model}/count-tokens` (опционально) | `anthropic_beta` и `anthropic_version` поля тела запроса |

45| Google Cloud's Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` с `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (опционально) | заголовки запроса `anthropic-beta` и `anthropic-version`, и поле тела запроса `anthropic_version` |47| Google Cloud's Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` с `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (опционально) | `anthropic-beta` и `anthropic-version` заголовки запроса, и поле `anthropic_version` в теле запроса |

46 48 

47<h3 id="foundry-and-claude-platform-on-aws">49<h3 id="foundry-and-claude-platform-on-aws">

48 Foundry и Claude Platform on AWS50 Foundry и Claude Platform on AWS

49</h3>51</h3>

50 52 

51Microsoft Foundry и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) реализуют формат Anthropic Messages. Claude Code маршрутизирует их через собственные переменные, `ANTHROPIC_FOUNDRY_BASE_URL` и `ANTHROPIC_AWS_BASE_URL`, но gateway, находящийся перед ними, реализует строку Anthropic Messages выше. Gateway, находящийся перед Claude Platform on AWS, также должен пересылать заголовок `anthropic-workspace-id`, который [эта платформа требует для каждого запроса](/docs/ru/claude-platform-on-aws).53Microsoft Foundry и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) реализуют формат Anthropic Messages. Claude Code маршрутизирует к ним через их собственные переменные, `ANTHROPIC_FOUNDRY_BASE_URL` и `ANTHROPIC_AWS_BASE_URL`, но шлюз, находящийся перед любым из них, реализует строку Anthropic Messages выше. Шлюз, находящийся перед Claude Platform on AWS, должен также пересылать заголовок `anthropic-workspace-id`, который [эта платформа требует для каждого запроса](/docs/ru/claude-platform-on-aws).

52 54 

53<h3 id="optional-endpoints-and-startup-traffic">55<h3 id="optional-endpoints-and-startup-traffic">

54 Опциональные конечные точки и трафик при запуске56 Опциональные endpoints и стартовый трафик

55</h3>57</h3>

56 58 

57Конечные точки подсчета токенов — единственные опциональные: когда их нет, Claude Code использует резервный вариант с оценкой контекста на основе количества символов.59Endpoints подсчёта токенов — единственные опциональные: когда их нет, Claude Code переходит на оценку использования контекста на основе количества символов.

58 60 

59Сопоставляйте по пути, а не по полному URL:61Сопоставляйте по пути, а не по полному URL:

60 62 

61* Запросы вывода отправляются на `/v1/messages?beta=true`63* Запросы вывода отправляются на `/v1/messages?beta=true`

62* Суффиксы метода Google Cloud's Agent Platform присоединяются к пути модели издателя, как в `/projects/{project}/locations/{location}/publishers/anthropic/models/{model}:streamRawPredict`64* Метод Google Cloud's Agent Platform добавляет суффиксы к пути модели издателя, как в `/projects/{project}/locations/{location}/publishers/anthropic/models/{model}:streamRawPredict`

63 65 

64Gateway также видит трафик при запуске, который он может отклонить без нарушения чего-либо. Gateway формата Anthropic Messages получает зонд подогрева соединения `HEAD /api/hello`, который Claude Code пропускает, когда настроен HTTP-прокси или сертификат клиента. Gateway формата Amazon Bedrock получает запрос `GET /inference-profiles?type=SYSTEM_DEFINED` и, когда настроенная модель является профилем вывода, запросы `GET /inference-profiles/{profile}`.66Шлюз также видит лучший трафик при запуске, который он может отклонить без нарушения чего-либо. Шлюз формата Anthropic Messages получает зонд `HEAD /api/hello` для прогрева соединения, который Claude Code пропускает, когда настроен HTTP-прокси или сертификат клиента. Шлюз формата Amazon Bedrock получает запрос `GET /inference-profiles?type=SYSTEM_DEFINED` и, когда настроенная модель является профилем вывода, поиски `GET /inference-profiles/{profile}`.

65 67 

66Проверка доступности [быстрого режима](/docs/ru/fast-mode) никогда не появляется в логах gateway: она вызывает `api.anthropic.com` напрямую, а не следует `ANTHROPIC_BASE_URL`, поэтому в сети, которая блокирует прямой исходящий трафик на `api.anthropic.com`, быстрый режим может сообщить об ошибке подключения, в то время как вывод через gateway продолжает работать. [Проверка безопасности домена WebFetch](/docs/ru/data-usage#webfetch-domain-safety-check) также вызывает `api.anthropic.com` напрямую. [Использование быстрого режима за прокси и LLM gateway](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) охватывает переменные, которые его восстанавливают.68Проверка доступности [fast mode](/docs/ru/fast-mode) никогда не появляется в логах шлюза: она вызывает `api.anthropic.com` напрямую, а не следует `ANTHROPIC_BASE_URL`, поэтому в сети, которая блокирует прямой исходящий трафик на `api.anthropic.com`, fast mode может сообщить об ошибке подключения, в то время как вывод через шлюз продолжает работать. Проверка безопасности домена [WebFetch](/docs/ru/data-usage#webfetch-domain-safety-check) также вызывает `api.anthropic.com` напрямую. [Use fast mode behind proxies and LLM gateways](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) охватывает переменные, которые его восстанавливают.

67 69 

68<h3 id="streaming">70<h3 id="streaming">

69 Потоковая передача71 Потоковая передача

70</h3>72</h3>

71 73 

72Передавайте ответы вывода потоком. Claude Code читает поток по мере его поступления, поэтому если ваш gateway буферизирует полные ответы перед их передачей, Claude Code зависает.74Потоковая передача ответов вывода. Claude Code читает поток по мере его поступления, поэтому если ваш шлюз буферизирует полные ответы перед их передачей, Claude Code зависает.

73 75 

74Когда клиент использует формат Amazon Bedrock, передавайте тело ответа `InvokeModelWithResponseStream` и его заголовок `Content-Type: application/vnd.amazon.eventstream` без изменений, и не преобразуйте поток в события, отправляемые сервером. См. [Ошибки потоковой передачи за gateway или прокси](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).76Когда клиент использует формат Amazon Bedrock, передавайте тело ответа `InvokeModelWithResponseStream` и его заголовок `Content-Type: application/vnd.amazon.eventstream` без изменений, и не преобразуйте поток в server-sent events. См. [Streaming errors behind a gateway or proxy](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).

75 77 

76Пересылайте также пинги keep-alive. На соединениях через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL` Claude Code считает каждый байт, который пересылает ваш gateway, включая события SSE `ping` и строки комментариев, и прерывает поток, который молчит в течение 300 секунд по умолчанию. Пинги upstream — единственный трафик во время длительных пауз размышления, поэтому если ваш gateway удаляет или буферизирует их, Claude Code прерывает поток во время этих пауз; [Автоматические повторы](/docs/ru/errors#automatic-retries) охватывает то, что прерванный поток сообщает в зависимости от того, насколько далеко продвинулся ответ. Upstream, который вообще не отправляет пинги, такой как двоичный event-stream Amazon Bedrock, оставляет эти паузы без чего-либо для пересылки. При переводе с такого upstream отправляйте свои собственные события `ping` во время молчаливых пауз. Gateway, доступные через `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_FOUNDRY_BASE_URL`, не обёрнуты этим байт-уровневым сторожем, даже когда они передают формат Anthropic Messages; там [5-минутный timeout неактивности](/docs/ru/env-vars) прерывает молчаливый поток вместо этого, и на соединениях `ANTHROPIC_BEDROCK_BASE_URL` вы можете добавить байт-уровневый сторож с помощью [`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`](/docs/ru/env-vars).78Пересылайте также keep-alive пинги. На соединениях через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`, Claude Code считает каждый байт, который ваш шлюз передаёт, включая SSE события `ping` и строки комментариев, и прерывает поток, который молчит в течение 300 секунд по умолчанию. Пинги вышестоящего сервера — единственный трафик во время длительных пауз размышления, поэтому если ваш шлюз удаляет или буферизирует их, Claude Code прерывает поток во время этих пауз; [Automatic retries](/docs/ru/errors#automatic-retries) охватывает то, что прерванный поток сообщает в зависимости от того, насколько далеко продвинулся ответ. Вышестоящий сервер, который вообще не отправляет пинги, такой как двоичный event-stream Amazon Bedrock, оставляет эти паузы без чего-либо для передачи. При переводе с такого вышестоящего сервера выдавайте свои собственные события `ping` во время молчаливых пауз. Шлюзы, достигнутые через `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_FOUNDRY_BASE_URL`, не обёрнуты этим байт-уровневым сторожем, даже когда они передают формат Anthropic Messages; там [5-минутный timeout неактивности](/docs/ru/env-vars) прерывает молчаливый поток вместо этого, и на соединениях `ANTHROPIC_BEDROCK_BASE_URL` вы можете добавить байт-уровневый сторож с помощью [`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`](/docs/ru/env-vars).

77 79 

78<h3 id="format-mismatch-with-the-upstream">80<h3 id="format-mismatch-with-the-upstream">

79 Несоответствие формата с upstream81 Несоответствие формата с вышестоящим сервером

80</h3>82</h3>

81 83 

82Какой формат использует клиент, определяет, что получает ваш gateway. Распространенный режим отказа — несоответствие между форматом, который клиент отправляет вашему gateway, и форматом, который принимает поставщик upstream позади него.84Какой формат использует клиент, определяет, что получает ваш шлюз. Распространённый режим отказа — несоответствие между форматом, который клиент отправляет вашему шлюзу, и форматом, который принимает вышестоящий поставщик позади него.

83 85 

84* Когда клиент использует формат Amazon Bedrock или Google Cloud's Agent Platform, Claude Code отправляет только подмножество своего полного набора возможностей, которое эти поставщики принимают86* Когда клиент использует формат Amazon Bedrock или Google Cloud's Agent Platform, Claude Code отправляет только подмножество своего полного набора возможностей, которое эти поставщики принимают

85* Когда клиент использует формат Anthropic Messages, Claude Code отправляет полный набор, даже если ваш gateway пересылает на upstream Amazon Bedrock или Google Cloud's Agent Platform87* Когда клиент использует формат Anthropic Messages, Claude Code отправляет полный набор, даже если ваш шлюз пересылает на вышестоящий сервер Amazon Bedrock или Google Cloud's Agent Platform

86 88 

87Преодоление этого различия — задача вашего gateway. [Сквозная передача функций](#feature-pass-through) описывает, что ломается, когда этого не происходит.89Преодоление этого различия — задача вашего шлюза. [Feature pass-through](#feature-pass-through) описывает, что ломается, когда это не происходит.

90 

91Если ваш вышестоящий сервер — Amazon Bedrock или Google Cloud's Agent Platform, вы можете избежать преодоления, предоставив вместо этого формат этого поставщика. [Route to a cloud provider through a gateway](/docs/ru/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) показывает конфигурацию клиента для этого формата.

92 

93<h2 id="how-the-connection-method-changes-client-behavior">

94 Как метод подключения изменяет поведение клиента

95</h2>

96 

97Способ подключения разработчика к вашему шлюзу определяет, какие ID моделей, значения `anthropic-beta` и поля запроса отправляет Claude Code, а также какие значения по умолчанию он применяет. Ваш шлюз видит одно из трёх поведений клиента:

98 

99* **Формат Amazon Bedrock или Agent Platform**: разработчик устанавливает `CLAUDE_CODE_USE_BEDROCK=1` с `ANTHROPIC_BEDROCK_BASE_URL` или `CLAUDE_CODE_USE_VERTEX=1` с `ANTHROPIC_VERTEX_BASE_URL`, указывающие на ваш шлюз. Claude Code использует ID моделей этого поставщика, поля запроса и значения по умолчанию.

100* **Формат Anthropic Messages**: разработчик устанавливает `ANTHROPIC_BASE_URL` на ваш шлюз. Claude Code рассматривает шлюз как Claude API и не может определить, на какой upstream вы перенаправляете.

101* **Вход в шлюз Claude apps**: разработчик входит в [шлюз Claude apps](/docs/ru/claude-apps-gateway). Этот шлюз использует формат Anthropic Messages, но может маршрутизировать на любой upstream, поэтому Claude Code отправляет только значения `anthropic-beta` и предположения о возможностях модели, которые также принимают Amazon Bedrock и Agent Platform.

102 

103<h3 id="requests-and-defaults-by-connection-method">

104 Запросы и значения по умолчанию по методу подключения

105</h3>

106 

107Таблица ниже сравнивает три метода подключения, по одному поведению в строке. Она исключает Microsoft Foundry и Claude Platform на AWS, которые также используют формат Anthropic Messages, но которые Claude Code достигает через свои собственные переменные. Для них см. страницы [Microsoft Foundry](/docs/ru/microsoft-foundry) и [Claude Platform на AWS](/docs/ru/claude-platform-on-aws).

108 

109| Поведение | Формат Amazon Bedrock или Agent Platform | Формат Anthropic Messages | Вход в шлюз Claude apps |

110| :-------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------- |

111| ID моделей в запросах по умолчанию | Форма поставщика, например `us.anthropic.claude-opus-4-8` на Amazon Bedrock | ID Anthropic, например `claude-opus-4-8` | ID Anthropic |

112| Отправляемые значения `anthropic-beta` | Подмножество, которое принимают Amazon Bedrock и Agent Platform | Полный набор, описанный в разделе [передача функций](#feature-pass-through), если разработчик не устанавливает [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](#disable-pre-release-capabilities) | Подмножество, которое принимают Amazon Bedrock и Agent Platform |

113| Поля запроса для ID модели, которую Claude Code не распознаёт, например alias шлюза | Thinking с фиксированным бюджетом вместо адаптивного рассуждения, и без полей управления усилиями или контекстом | Всё, что принимают текущие модели Claude на Claude API, включая адаптивное рассуждение, усилие и управление контекстом, которые upstream Amazon Bedrock или Agent Platform может отклонить | То же, что формат Amazon Bedrock или Agent Platform |

114| [TTL кэша подсказок](/docs/ru/prompt-caching#choose-the-ttl-yourself) на один час при согласии разработчика | Запрашивается через поле `ttl` в `cache_control`, без значения beta | Запрашивается через поле `ttl` плюс значение `extended-cache-ttl` в `anthropic-beta`, которое вы должны перенаправить | См. таблицу [доступность и ограничения](/docs/ru/claude-apps-gateway#availability-and-limitations) шлюза Claude apps |

115| Модель для [фоновых задач](/docs/ru/costs#background-token-usage), если `ANTHROPIC_DEFAULT_HAIKU_MODEL` не закрепляет одну | Модель Sonnet по умолчанию или основная модель после выбора одной, как описано на страницах [Amazon Bedrock](/docs/ru/amazon-bedrock#4-pin-model-versions) и [Agent Platform](/docs/ru/google-vertex-ai#5-pin-model-versions) | Основная модель или модель Haiku по умолчанию, когда `ANTHROPIC_API_KEY` или `apiKeyHelper` предоставляет ключ Anthropic Console и `ANTHROPIC_AUTH_TOKEN` не установлен | Основная модель |

116 

117Для функций, которые поддерживает каждое подключение, и телеметрии, которую оно отправляет Anthropic по умолчанию, см. [Доступность функций](/docs/ru/feature-availability#availability-by-model-provider) и [Поведение по умолчанию по поставщику API](/docs/ru/data-usage#default-behaviors-by-api-provider).

118 

119<h3 id="settings-for-unrecognized-model-ids">

120 Параметры для нераспознанных ID моделей

121</h3>

122 

123Два параметра на стороне клиента изменяют то, что Claude Code предполагает для ID модели, которую он не распознаёт, независимо от того, какой метод подключения использует разработчик:

124 

125* **Окно контекста**: Claude Code предполагает 200K или 1M, когда ID содержит `[1m]`. Чтобы объявить реальное окно, см. [Исправьте окно для шлюза или пользовательского ID модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id)

126* **Возможности**: чтобы дать alias шлюза возможности модели позади него, сопоставьте ID Anthropic этой модели с вашим alias с помощью записи [`modelOverrides`](/docs/ru/errors#unrecognized-model-id-on-a-request) в параметрах, которые вы распространяете. Для того, где применяются переменные `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES`, см. [передача функций](#feature-pass-through)

88 127 

89<h2 id="request-headers">128<h2 id="request-headers">

90 Заголовки запроса129 Заголовки запроса


115 154 

116Исключением является upstream, не относящийся к Anthropic, такой как Amazon Bedrock или Google Cloud's Agent Platform, где преодоление различия схемы — задача gateway; см. [сквозная передача функций](#feature-pass-through).155Исключением является upstream, не относящийся к Anthropic, такой как Amazon Bedrock или Google Cloud's Agent Platform, где преодоление различия схемы — задача gateway; см. [сквозная передача функций](#feature-pass-through).

117 156 

157<h2 id="response-headers">

158 Заголовки ответов

159</h2>

160 

161Claude Code читает эти заголовки ответов для обнаружения зависших потоков, чтобы решить, следует ли и когда повторить попытку, а также для отображения лимитов использования. В таблице указано, что возвращать для каждого. Также пропускайте тела ответов об ошибках без изменений, чтобы [восстановление при отклонении возможностей](#automatic-retry-and-error-forwarding) Claude Code могло соответствовать формулировке ошибки вышестоящего сервера.

162 

163| Заголовок | Что возвращать и почему |

164| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

165| `content-type` | Возвращайте `text/event-stream` для потоковых ответов в формате Anthropic Messages и `application/vnd.amazon.eventstream` без изменений для ответов в формате Amazon Bedrock, где [другой тип приводит к сбою запроса](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). [Streaming](#streaming) указывает, какие соединения выполняют обнаружение зависания на этих потоках |

166| `retry-after` | Возвращайте целое число секунд вместо даты HTTP. Claude Code ждет по крайней мере столько времени перед следующей [автоматической повторной попыткой](/docs/ru/errors#automatic-retries), и вне сеансов [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ru/env-vars) значение выше 60 останавливает повторные попытки и показывает ошибку сразу же |

167| `x-should-retry` | Пропускайте значение вышестоящего сервера без изменений. Claude Code читает этот заголовок как один из входных данных при решении о повторной попытке неудачного запроса: `true` отмечает ответ как подлежащий повторной попытке, а `false` отмечает его как не подлежащий повторной попытке. Для количества повторных попыток, отката и того, какие сбои Claude Code повторяет, см. [автоматические повторные попытки](/docs/ru/errors#automatic-retries) |

168| `anthropic-ratelimit-unified-*` | Пропускайте значения вышестоящего сервера без изменений при каждом ответе. Claude Code читает их при успешных ответах для отображения использования в соответствии с лимитами плана разработчикам, вошедшим в систему с помощью claude.ai, и при `429` для различения лимита плана или лимита расходов от временного дросселирования; см. [лимиты использования](/docs/ru/errors#usage-limits) |

169 

118<h2 id="system-prompt-attribution-block">170<h2 id="system-prompt-attribution-block">

119 Блок атрибуции системного приглашения171 Блок атрибуции системного приглашения

120</h2>172</h2>


143 Сквозная передача функций195 Сквозная передача функций

144</h2>196</h2>

145 197 

146Claude Code рассматривает gateway `ANTHROPIC_BASE_URL` как конечную точку формата Anthropic и отправляет ему бета-заголовки и поля тела запроса, которые он отправляет на `api.anthropic.com`, за исключением небольшого набора диагностики и значений по умолчанию, зарезервированных для прямых соединений, таких как значение по умолчанию для потоковой передачи инструментов с точной детализацией, описанное ниже. Этот набор варьируется в зависимости от выпуска, поэтому не полагайтесь на его содержимое.198Claude Code рассматривает шлюз `ANTHROPIC_BASE_URL` как конечную точку в формате Anthropic и отправляет ему бета-заголовки и поля тела запроса, которые он отправляет на `api.anthropic.com`, за исключением небольшого набора диагностики и значений по умолчанию, зарезервированных для прямых соединений, таких как значение по умолчанию для потоковой передачи инструментов с точной настройкой, описанное ниже. Этот набор варьируется в зависимости от версии, поэтому не полагайтесь на его содержимое.

147 199 

148Возможности, которые добавляют поля тела, связывают их с бета-заголовком, и пара путешествует вместе. Gateway, который удаляет заголовок при передаче тела или пересылает тело формата Anthropic на upstream с другой схемой, создает жесткие ошибки `400`; только когда обе половины отсутствуют вместе, функция отключается тихо. Gateway, который переписывает или редактирует тела запросов для проверки содержимого, нарушает связь так же, как удаление, поэтому проверяйте без изменения. Таблица отмечает, где функция отклоняется от связи.200Возможности, которые добавляют поля тела, связывают их с бета-заголовком, и эта пара передается вместе. Шлюз, который удаляет заголовок при передаче тела или пересылает тело в формате Anthropic на вышестоящий сервер с другой схемой, создает жесткие ошибки `400`; только когда обе части отсутствуют вместе, функция отключается без ошибок. Шлюз, который переписывает или редактирует тела запросов для проверки содержимого, нарушает связь так же, как это делает удаление, поэтому проверяйте без изменений. В таблице указано, где функция отклоняется от связи.

149 201 

150Потоковая передача инструментов с точной детализацией — одно из значений по умолчанию для прямого соединения: она отключена по умолчанию, когда запросы маршрутизируются через пользовательский базовый URL, и gateway получает ее, когда разработчики установили [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/docs/ru/env-vars).202Потоковая передача инструментов с точной настройкой — это одно из значений по умолчанию для прямого соединения: она отключена по умолчанию всякий раз, когда запросы маршрутизируются через пользовательский базовый URL, и шлюз получает ее, когда разработчики устанавливают [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/docs/ru/env-vars).

151 203 

152| Функция | Заголовок и связь тела | Симптом при нарушении | Исправление |204| Функция | Бета-заголовок и пара тела | Симптом при нарушении | Исправление |

153| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |205| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |

154| [Адаптивное рассуждение](/docs/ru/model-config#adjust-effort-level) | Нет бета-заголовка. Claude Code отправляет `thinking: {"type": "adaptive"}` для Claude 4.6 и позже и рассматривает имена моделей, которые он не распознает, такие как псевдонимы gateway, как текущие модели, которые получают поле | `400` с указанием поля `thinking` или тега `adaptive`, когда сборка модели upstream его не принимает | Обновите upstream. На Opus 4.6 и Sonnet 4.6 разработчики могут вместо этого установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` |206| [Адаптивное рассуждение](/docs/ru/model-config#adjust-effort-level) | Нет бета-заголовка. Claude Code отправляет `thinking: {"type": "adaptive"}` для Claude 4.6 и более поздних версий и рассматривает неизвестные имена моделей, такие как псевдонимы шлюза, как текущие модели, которые получают это поле | Ошибка `400`, указывающая на поле `thinking` или тег `adaptive`, когда сборка вышестоящей модели его не принимает | Обновите вышестоящий сервер. На Opus 4.6 и Sonnet 4.6 разработчики могут вместо этого установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` |

155| [Управление контекстом](https://platform.claude.com/docs/en/build-with-claude/context-editing) | Бета-заголовок управления контекстом связан с полем тела `context_management` | `400` с `Extra inputs are not permitted`. Часто встречается, когда gateway принимает запросы формата Anthropic, но пересылает их на Amazon Bedrock | Пересылайте оба или [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ru/env-vars) |207| [Управление контекстом](https://platform.claude.com/docs/en/build-with-claude/context-editing) | Бета-заголовок управления контекстом связан с полем тела `context_management` | Ошибка `400` с сообщением `Extra inputs are not permitted`. Часто встречается, когда шлюз принимает запросы в формате Anthropic, но пересылает их на Amazon Bedrock | Пересылайте оба, или [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ru/env-vars) |

156| [Расширенный контекст](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) и [чередующееся мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | Только бета-заголовки, нет поля тела | Молча недоступно, когда заголовок удален; upstream никогда не видит запрос возможности | Пересылайте `anthropic-beta` дословно |208| [Расширенный контекст](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) и [чередующееся мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | Только бета-заголовки, нет поля тела | Молча недоступно, когда заголовок удален; вышестоящий сервер никогда не видит запрос возможности | Пересылайте `anthropic-beta` без изменений |

157| Бета [поля инструментов](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Бета-заголовки, связанные с инструментами, связаны с полями схемы инструментов, такими как `strict` и `defer_loading` | `400` с указанием неузнанного поля схемы инструмента, когда тело проходит без его заголовка | Пересылайте оба или [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |209| Бета [поля инструментов](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Связанные с инструментами бета-заголовки связаны с полями схемы инструментов, такими как `strict` и `defer_loading` | Ошибка `400`, указывающая на неизвестное поле схемы инструмента, когда тело проходит без своего заголовка | Пересылайте оба, или [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |

158| [Усилие](https://platform.claude.com/docs/en/build-with-claude/effort) и [структурированные выходы](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | Поле тела `output_config` содержит усилие, формат структурированного вывода и параметры бюджета задачи; каждое связано с собственным бета-заголовком | `400` с указанием `output_config`, часто `Extra inputs are not permitted`, на upstream-ах Amazon Bedrock и Google Cloud's Agent Platform | Пересылайте поле и его заголовки вместе |210| [Усилие](https://platform.claude.com/docs/en/build-with-claude/effort) и [структурированные выходные данные](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | Поле тела `output_config` содержит параметры усилия, формата структурированного выхода и бюджета задачи; каждый связан с собственным бета-заголовком | Ошибка `400`, указывающая на `output_config`, часто `Extra inputs are not permitted`, на вышестоящих серверах Amazon Bedrock и Google Cloud's Agent Platform | Пересылайте поле и его заголовки вместе |

159| [Prompt caching](/docs/ru/prompt-caching) | Нет бета-связи. Claude Code прикрепляет маркеры `cache_control` к блокам `system` и к записям `messages`, включая записи `role: "system"`, добавленные в середину разговора | Нет ошибки: разговор выставляется как некэшированный ввод на каждый ход, видимый как высокие `input_tokens` с небольшой или отсутствующей активностью кэша в `usage` | Пересылайте `cache_control` без изменений везде, где он появляется, и не преобразуйте блочную форму `system` или содержимое сообщения в простые строки |211| [Кэширование подсказок](/docs/ru/prompt-caching) | Нет бета-связи. Claude Code прикрепляет маркеры `cache_control` к блокам `system` и записям `messages`, включая записи `role: "system"`, добавленные в середину разговора | Нет ошибки: разговор выставляется как некэшированный ввод на каждом ходу, видимый как высокие `input_tokens` с небольшой или отсутствующей активностью кэша в `usage` | Пересылайте `cache_control` без изменений везде, где он появляется, и не преобразуйте блочную форму `system` или содержимое сообщения в простые строки |

160| [Подсчет токенов](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Нет бета-связи; использует конечную точку `count_tokens` | Нет ошибки: Claude Code возвращается к оценке на основе символов, поэтому `/context` показывает приблизительные подсчеты | Предоставьте конечную точку для точных подсчетов токенов |212| [Подсчет токенов](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Нет бета-связи; использует конечную точку `count_tokens` | Нет ошибки: Claude Code возвращается к оценке на основе символов, поэтому `/context` показывает приблизительные подсчеты | Предоставьте конечную точку для точного подсчета токенов |

161 213 

162Переменные `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` [объявляют](/docs/ru/model-config) возможности модели только в конфигурациях поставщика: `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY` и [`CLAUDE_CODE_USE_MANTLE`](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Они не имеют эффекта позади gateway `ANTHROPIC_BASE_URL`.214Переменные `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` [объявляют](/docs/ru/model-config) возможности модели только в конфигурациях поставщика: `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY` и [`CLAUDE_CODE_USE_MANTLE`](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Они не имеют никакого эффекта за шлюзом `ANTHROPIC_BASE_URL`.

163 215 

164<h3 id="automatic-retry-and-error-forwarding">216<h3 id="automatic-retry-and-error-forwarding">

165 Автоматический повтор и пересылка ошибок217 Автоматический повтор и пересылка ошибок

166</h3>218</h3>

167 219 

168То, что Claude Code делает после отказа upstream, зависит от того, что было отклонено:220То, что Claude Code делает после отклонения вышестоящим сервером, зависит от того, что было отклонено:

169 221 

170* Когда upstream отклоняет поле `thinking`, системное сообщение в середине разговора или маркер `cache_control` на таком сообщении, Claude Code повторяет запрос и отключает отклоненную возможность на оставшуюся часть разговора222* Когда вышестоящий сервер отклоняет поле `thinking`, системное сообщение в середине разговора или маркер `cache_control` на таком сообщении, Claude Code повторяет запрос и отключает отклоненную возможность для остальной части разговора

171* Когда upstream отклоняет [сигнатуру мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking), Claude Code повторяет запрос без более ранних блоков мышления разговора и исключает их из каждого последующего запроса. Новые ответы по-прежнему включают мышление223* Когда вышестоящий сервер отклоняет [подпись мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking), включая ошибку `400`, сообщение которой говорит, что блок `bound to a different conversation`, Claude Code удаляет более ранние блоки мышления из запроса, повторяет и исключает их из каждого последующего запроса. Новые ответы по-прежнему включают мышление

172* Claude Code не повторяет отказы управления контекстом или полей схемы инструментов, поэтому эти ошибки `400` достигают разработчика224* Claude Code не повторяет отклонения управления контекстом или полей схемы инструментов, поэтому эти ошибки `400` достигают разработчика

173 225 

174Логика повтора соответствует формулировке ошибки upstream, поэтому пересылайте тела ответов об ошибках без изменений. Gateway, который оборачивает ошибки upstream в собственный конверт, нарушает путь восстановления, даже если он сохраняет код состояния, если только сообщение конверта не содержит стабильный токен `capability_rejected:`. [Claude apps gateway подставляет эти токены вместо формулировок ошибок облачных провайдеров](/docs/ru/claude-apps-gateway-config#upstream-error-messages), например `capability_rejected: prompt_too_long`.226Отклонение `bound to a different conversation` поступает из проверки [сохраненного мышления](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking) API, которая не срабатывает, когда содержимое `system`, `tools` или более ранних `messages` отличается от запроса, который создал мышление. Шлюз, который переписывает любое из этого содержимого, может вызвать само отклонение; [Libraries, proxies, and gateways](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways) охватывает то, что нужно пересылать без изменений.

227 

228Логика повтора совпадает с формулировкой ошибки вышестоящего сервера, поэтому пересылайте тела ответов об ошибках без изменений. Шлюз, который оборачивает ошибки вышестоящего сервера в свой собственный конверт, нарушает путь восстановления, даже если он сохраняет код состояния, если только сообщение конверта не содержит стабильный токен `capability_rejected:`. [Claude apps gateway заменяет эти токены на формулировки ошибок облачных поставщиков](/docs/ru/claude-apps-gateway-config#upstream-error-messages), например `capability_rejected: prompt_too_long`.

175 229 

176<h3 id="disable-pre-release-capabilities">230<h3 id="disable-pre-release-capabilities">

177 Отключение возможностей предварительного выпуска231 Отключение предварительных возможностей

178</h3>232</h3>

179 233 

180`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` останавливает Claude Code от отправки возможностей предварительного выпуска и их полей тела на каждого поставщика, включая управление контекстом и бета-поля инструментов. Переменная не влияет на адаптивное рассуждение, которое выбирается по модели, а не по бета. Она никогда не подавляет возможность OAuth, которую требует аутентификация подписки.234`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` останавливает Claude Code от отправки предварительных возможностей и их полей тела на каждого поставщика, включая управление контекстом и бета-поля инструментов. Переменная не влияет на адаптивное рассуждение, которое выбирается по модели, а не по бета. Она никогда не подавляет возможность OAuth, которую требует аутентификация подписки.

181 235 

182На Claude Code v2.1.227 или позже ваша организация может держать [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) включенным под этой переменной через [управляемые параметры](/docs/ru/managed-settings). То, что Claude Code отправляет с этим переопределением на месте, зависит от того, как вы подключаетесь:236На Claude Code v2.1.227 или более поздней версии ваша организация может сохранить [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) в соответствии с этой переменной через [управляемые параметры](/docs/ru/managed-settings). То, что Claude Code отправляет с этим переопределением, зависит от того, как вы подключаетесь:

183 237 

184* На прямом соединении или через gateway, установленный с `ANTHROPIC_BASE_URL`, Claude Code продолжает отправлять бета-заголовок поиска инструментов, поля инструментов `defer_loading` и блоки `tool_reference`, и удаляет остальное238* При прямом соединении или через шлюз, установленный с `ANTHROPIC_BASE_URL`, Claude Code продолжает отправлять бета-заголовок поиска инструментов, поля инструментов `defer_loading` и блоки `tool_reference`, и удаляет остальное

185* На облачном провайдере или при входе через [Claude apps gateway](/docs/ru/claude-apps-gateway), переопределение не имеет эффекта239* На облачном поставщике или при входе через [Claude apps gateway](/docs/ru/claude-apps-gateway), переопределение не имеет никакого эффекта

186 240 

187Набор возможностей, которые отправляет Claude Code, растет в выпусках. Для текущих строк бета-заголовков см. [справочник бета-заголовков](https://platform.claude.com/docs/en/api/beta-headers); тестируйте ваш gateway против новых выпусков Claude Code, а не привязывайтесь к наблюдаемому списку.241Набор возможностей, которые Claude Code отправляет, растет с каждым выпуском. Для текущих строк бета-заголовков см. [справочник бета-заголовков](https://platform.claude.com/docs/en/api/beta-headers); протестируйте свой шлюз против новых выпусков Claude Code, а не закрепляйте наблюдаемый список.

188 242 

189<h2 id="model-discovery">243<h2 id="model-discovery">

190 Обнаружение моделей244 Обнаружение моделей


209 Запрос и ответ263 Запрос и ответ

210</h3>264</h3>

211 265 

212Запрос — это `GET /v1/models?limit=1000` с тайм-аутом 3 секунды, и любое перенаправление рассматривается как отказ, поэтому учетные данные не могут утечь на цель перенаправления. Gateway, который отвечает медленно или перенаправляет `/v1/models`, даже `http` на `https`, молча не выполняет обнаружение; обслуживайте конечную точку непосредственно по настроенному базовому URL.266Запрос — это `GET /v1/models?limit=1000` с тайм-аутом 3 секунды по умолчанию, и любое перенаправление рассматривается как отказ, поэтому учетные данные не могут утечь на цель перенаправления. Gateway, который отвечает медленнее, чем тайм-аут, или тот, который перенаправляет `/v1/models`, даже `http` на `https`, молча не выполняет обнаружение; обслуживайте конечную точку непосредственно по настроенному базовому URL.

267 

268Чтобы дать медленному gateway больше времени, установите [`CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS`](/docs/ru/env-vars#variables). Переменная требует Claude Code v2.1.269 или позже.

213 269 

214Claude Code отправляет запрос обнаружения с обоими заголовками учетных данных ниже и опускает заголовок, значение которого не разрешается. Отправка обоих заголовков требует Claude Code v2.1.248 или позже. Более ранние версии отправляют только `Authorization`, когда установлен `ANTHROPIC_AUTH_TOKEN`, и только `x-api-key` в противном случае.270Claude Code отправляет запрос обнаружения с обоими заголовками учетных данных ниже и опускает заголовок, значение которого не разрешается. Отправка обоих заголовков требует Claude Code v2.1.248 или позже. Более ранние версии отправляют только `Authorization`, когда установлен `ANTHROPIC_AUTH_TOKEN`, и только `x-api-key` в противном случае.

215 271 

Details

328 328 

329В v2.1.158 через v2.1.206 режим auto был отключён на этих поставщиках до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, и Claude Code игнорировал `defaultMode: "auto"` на этих поставщиках, если переменная также не была установлена. Переменная по-прежнему принимается для совместимости и не имеет эффекта с v2.1.207 и далее.329В v2.1.158 через v2.1.206 режим auto был отключён на этих поставщиках до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, и Claude Code игнорировал `defaultMode: "auto"` на этих поставщиках, если переменная также не была установлена. Переменная по-прежнему принимается для совместимости и не имеет эффекта с v2.1.207 и далее.

330 330 

331<h4 id="server-side-classifier-review">331<h3 id="server-side-classifier-review">

332 Проверка классификатора на стороне сервера332 Проверка классификатора на стороне сервера

333</h4>333</h3>

334 

335На планах Enterprise и на учётных записях, которые используют Claude API, на [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, и когда вы указываете `ANTHROPIC_BASE_URL` на [LLM gateway или proxy](/docs/ru/llm-gateway), Claude Code в режиме auto просит сервер проверить [действия, которые идут к классификатору](#how-the-classifier-evaluates-actions) как часть запросов модели сеанса. Где сервер их проверяет, его вердикты решают эти действия. Где он этого не делает, обычно потому что gateway или proxy мешает трафику, или потому что платформа, регион или учётные данные ещё не имеют проверок на стороне сервера, Claude Code откатывается к собственным запросам классификатора, и как только этот откат держится для остальной части сеанса, он показывает [уведомление о расходах на запросы классификатора](/docs/ru/auto-mode-classifier-billing) на учётных записях, где эти запросы выставляются счётом. Чтобы пропустить запрос к серверу и всегда использовать собственные запросы классификатора Claude Code, установите [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ru/env-vars). Переменная не читается при прямом подключении к Anthropic API. Если вы установите `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` и оставите `CLAUDE_CODE_AUTO_MODE_SERVER` неустановленным, Claude Code также перестаёт запрашивать сервер.

334 336 

335На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code проверяет действия режима auto с помощью собственных запросов классификатора по умолчанию. Чтобы иметь классификатор на стороне платформы проверить [действия, которые идут к классификатору](#how-the-classifier-evaluates-actions) как часть запросов модели сеанса вместо этого, установите [`CLAUDE_CODE_AUTO_MODE_SERVER=1`](/docs/ru/env-vars). Где платформа запускает классификатор, его вердикты решают эти действия; где она этого не делает, Claude Code откатывается к собственным запросам классификатора. В v2.1.271 и v2.1.272 запрос платформы был значением по умолчанию на этих поставщиках.337Запрос к серверу по умолчанию требует Claude Code v2.1.278 или позже.

336 338 

337<h3 id="what-the-classifier-blocks-by-default">339<h3 id="what-the-classifier-blocks-by-default">

338 Что классификатор блокирует по умолчанию340 Что классификатор блокирует по умолчанию


515 517 

516 Первый запрос режима auto сеанса проверяет значение по умолчанию Sonnet 5: если запрос успешен, Sonnet 5 остаётся моделью классификатора сеанса, и если он не удаётся, потому что модель недоступна, сеанс использует fallback вместо этого. После того как эта проверка урегулируется, модель классификатора не изменяется для сеанса.518 Первый запрос режима auto сеанса проверяет значение по умолчанию Sonnet 5: если запрос успешен, Sonnet 5 остаётся моделью классификатора сеанса, и если он не удаётся, потому что модель недоступна, сеанс использует fallback вместо этого. После того как эта проверка урегулируется, модель классификатора не изменяется для сеанса.

517 519 

518 На планах Enterprise и на учётных записях, которые используют Claude API, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, вызовы классификатора учитываются в использовании токенов. Каждая проверка отправляет часть стенограммы плюс ожидающее действие, добавляя круговой путь перед выполнением. Чтение и редактирование рабочего каталога вне защищённых путей пропускают классификатор, поэтому накладные расходы поступают в основном от команд оболочки и сетевых операций. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry вы можете переместить проверку в запросы модели сеанса вместо этого; см. [Server-side classifier review](#server-side-classifier-review).520 На планах Enterprise и на учётных записях, которые используют Claude API, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, вызовы классификатора учитываются в использовании токенов. Каждая проверка отправляет часть стенограммы плюс ожидающее действие, добавляя круговой путь перед выполнением. Чтение и редактирование рабочего каталога вне защищённых путей пропускают классификатор, поэтому накладные расходы поступают в основном от команд оболочки и сетевых операций. Где сервер проверяет действия как часть запросов модели сеанса, нет отдельных вызовов классификатора для подсчёта; см. [Server-side classifier review](#server-side-classifier-review).

519 521 

520 Доступ к сети в песочнице не добавляет запросы классификатора для каждого подключения. Классификатор судит [хосты, которые команда называет](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode) вместе с командой в одной проверке, и Claude Code проверяет каждое подключение против одобренного списка без повторного вызова классификатора.522 Доступ к сети в песочнице не добавляет запросы классификатора для каждого подключения. Классификатор судит [хосты, которые команда называет](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode) вместе с командой в одной проверке, и Claude Code проверяет каждое подключение против одобренного списка без повторного вызова классификатора.

521 </Accordion>523 </Accordion>

routines.md +18 −3

Details

52 52 

53Форма создания настраивает подсказку рутины, репозитории, окружение, коннекторы и триггеры.53Форма создания настраивает подсказку рутины, репозитории, окружение, коннекторы и триггеры.

54 54 

55Рутины работают автономно как полные облачные сеансы Claude Code: нет выбора режима разрешений и нет запросов на одобрение во время запуска. Сеанс может запускать команды shell, использовать [skills](/docs/ru/skills), зафиксированные в клонированном репозитории, и вызывать любые коннекторы, которые вы включите. То, что может достичь рутина, определяется выбранными вами репозиториями, [окружением](/docs/ru/cloud-environments) сетевого доступа и переменных, а также включенными коннекторами. Ограничьте каждый из них тем, что рутине действительно нужно.55Рутины работают автономно как полные облачные сеансы Claude Code: нет выбора режима разрешений, и сеанс запускает команды shell, использует [skills](/docs/ru/skills), зафиксированные в клонированном репозитории, и вызывает любые коннекторы, которые вы включите, все без остановки для одобрения, кроме некоторых действий с [artifact](/docs/ru/artifacts).

56 

57То, что может достичь рутина, определяется выбранными вами репозиториями, [окружением](/docs/ru/cloud-environments) сетевого доступа и переменных, а также включенными коннекторами. Ограничьте каждый из них тем, что рутине действительно нужно.

58 

59Когда расписание рутины или **Run now** запускает запуск, Claude переиздает существующий artifact без запроса только когда все это верно:

60 

61* Вы можете редактировать artifact и он принадлежит вашей собственной организации

62* Artifact не является общедоступным и не совместно используется с конкретными людьми или вашей организацией с последней версией, выбранной как версия, которую видят зрители

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

64* Страница не содержит разрешение, которое выходит за пределы страницы, такое как [вызовы коннектора](/docs/ru/artifacts#pull-live-data-with-mcp-connectors)

65 

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

56 67 

57Рутины принадлежат вашему индивидуальному аккаунту claude.ai. Они не совместно используются с товарищами по команде и учитываются в дневном лимите запусков вашего аккаунта. Все, что рутина делает через вашу подключенную идентификацию GitHub или коннекторы, отображается как вы: коммиты и pull request несут вашего пользователя GitHub, а сообщения Slack, задачи Linear или другие действия коннектора используют ваши связанные аккаунты для этих сервисов.68Рутины принадлежат вашему индивидуальному аккаунту claude.ai. Они не совместно используются с товарищами по команде и учитываются в дневном лимите запусков вашего аккаунта. Все, что рутина делает через вашу подключенную идентификацию GitHub или коннекторы, отображается как вы: коммиты и pull request несут вашего пользователя GitHub, а сообщения Slack, задачи Linear или другие действия коннектора используют ваши связанные аккаунты для этих сервисов.

58 69 


349 360 

350Рутинам нужен доступ GitHub для клонирования репозиториев. Когда вы создаете рутину из CLI с `/schedule`, Claude проверяет, имеет ли ваш аккаунт доступ GitHub для репозитория, из которого вы его запустили, и, если это не так, добавляет примечание настройки, указывающее, как предоставить доступ. Смотрите [GitHub authentication options](/docs/ru/claude-code-on-the-web#github-authentication-options) для двух способов предоставления доступа.361Рутинам нужен доступ GitHub для клонирования репозиториев. Когда вы создаете рутину из CLI с `/schedule`, Claude проверяет, имеет ли ваш аккаунт доступ GitHub для репозитория, из которого вы его запустили, и, если это не так, добавляет примечание настройки, указывающее, как предоставить доступ. Смотрите [GitHub authentication options](/docs/ru/claude-code-on-the-web#github-authentication-options) для двух способов предоставления доступа.

351 362 

363Если ваше соединение GitHub отсутствует или истекло, когда запуск должен произойти, рутина пропускает запуски до тех пор, пока вы не переподключитесь, в течение до 72 часов. Переподключитесь GitHub в течение этого окна, и рутина возобновится автоматически. После 72 часов без соединения рутина отключается, и вы включаете ее снова после переподключения GitHub.

364 

352Каждый репозиторий, который вы добавляете, клонируется при каждом запуске. Claude начинает с ветви по умолчанию репозитория, если ваша подсказка не указывает иное.365Каждый репозиторий, который вы добавляете, клонируется при каждом запуске. Claude начинает с ветви по умолчанию репозитория, если ваша подсказка не указывает иное.

353 366 

354Claude отправляет свою работу в ветви с префиксом `claude/`, которые всегда принимаются. Когда ваша подсказка направляет Claude на отправку в другую ветвь, Claude Code сначала проверяет отправку и отклоняет ее, если выполняется любое из следующих условий:367Claude отправляет свою работу в ветви с префиксом `claude/`, которые всегда принимаются. Когда ваша подсказка направляет Claude на отправку в другую ветвь, Claude Code сначала проверяет отправку и отклоняет ее, если выполняется любое из следующих условий:


377 390 

378Окружение **Default** использует **Trusted** сетевой доступ, который позволяет только [список разрешений по умолчанию](/docs/ru/cloud-environments#default-allowed-domains) через сеть сеанса. Запросы на этом пути к хостам вне списка разрешений завершаются с ошибкой `403` и `x-deny-reason: host_not_allowed`. Трафик MCP коннектора маршрутизируется через серверы Anthropic, а не на этом пути, поэтому коннекторы, которые вы добавляете в рутину, работают без добавления их хостов в **Allowed domains**. Удалите все коннекторы, которые вам не нужны, в разделе [Коннекторы](#connectors).391Окружение **Default** использует **Trusted** сетевой доступ, который позволяет только [список разрешений по умолчанию](/docs/ru/cloud-environments#default-allowed-domains) через сеть сеанса. Запросы на этом пути к хостам вне списка разрешений завершаются с ошибкой `403` и `x-deny-reason: host_not_allowed`. Трафик MCP коннектора маршрутизируется через серверы Anthropic, а не на этом пути, поэтому коннекторы, которые вы добавляете в рутину, работают без добавления их хостов в **Allowed domains**. Удалите все коннекторы, которые вам не нужны, в разделе [Коннекторы](#connectors).

379 392 

380Чтобы разрешить дополнительные домены:393Чтобы разрешить дополнительные домены на одном из ваших собственных окружений, выполните следующие шаги. [Организационное общее окружение](/docs/ru/cloud-environments#organization-shared-environments) открывается в режиме только для чтения здесь, поэтому владелец изменяет его сетевой доступ со страницы **Cloud environments** в [параметрах администратора](https://claude.ai/admin-settings) вместо этого.

381 394 

382<Steps>395<Steps>

383 <Step title="Откройте рутину для редактирования">396 <Step title="Откройте рутину для редактирования">


413 426 

414Разовые запуски не учитываются в дневном лимите рутин. Они снижают ваше обычное использование подписки как любой другой сеанс.427Разовые запуски не учитываются в дневном лимите рутин. Они снижают ваше обычное использование подписки как любой другой сеанс.

415 428 

429Пока ваша подписка приостановлена, ваши рутины ставятся на паузу и не запускаются. Как только ваша подписка снова активна, включите их обратно.

430 

416<h2 id="troubleshooting">431<h2 id="troubleshooting">

417 Устранение неполадок432 Устранение неполадок

418</h2>433</h2>


427 442 

428* Вы аутентифицированы с помощью Console API key, [профиля Anthropic или учетных данных федерации](/docs/ru/authentication#anthropic-profiles-and-federation-credentials), или облачного провайдера, такого как Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. `/schedule` требует входа с подпиской claude.ai. С Console API key или профилем и включенной загрузкой флагов функций отправка `/schedule` вместо этого показывает `/schedule is available with Claude for Enterprise — ask your admin about migrating from API-key access`. С входом облачного провайдера вы все еще видите `Unknown command: /schedule`. Если `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN` установлены в вашей оболочке, или `apiKeyHelper` установлен в `settings.json`, удалите их сначала, так как они имеют приоритет над входом claude.ai. Профиль или учетные данные федерации также имеют приоритет, поэтому отключите их тоже443* Вы аутентифицированы с помощью Console API key, [профиля Anthropic или учетных данных федерации](/docs/ru/authentication#anthropic-profiles-and-federation-credentials), или облачного провайдера, такого как Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. `/schedule` требует входа с подпиской claude.ai. С Console API key или профилем и включенной загрузкой флагов функций отправка `/schedule` вместо этого показывает `/schedule is available with Claude for Enterprise — ask your admin about migrating from API-key access`. С входом облачного провайдера вы все еще видите `Unknown command: /schedule`. Если `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN` установлены в вашей оболочке, или `apiKeyHelper` установлен в `settings.json`, удалите их сначала, так как они имеют приоритет над входом claude.ai. Профиль или учетные данные федерации также имеют приоритет, поэтому отключите их тоже

429* Вы полностью вышли из системы, без API key или других учетных данных. С включенной загрузкой флагов функций отправка `/schedule` показывает `/schedule requires a claude.ai subscription. Run /login to sign in with your claude.ai account.` До версии v2.1.268 сеанс без входа показывал то же сообщение Claude for Enterprise, что и Console API key444* Вы полностью вышли из системы, без API key или других учетных данных. С включенной загрузкой флагов функций отправка `/schedule` показывает `/schedule requires a claude.ai subscription. Run /login to sign in with your claude.ai account.` До версии v2.1.268 сеанс без входа показывал то же сообщение Claude for Enterprise, что и Console API key

430* Вы находитесь в облачном сеансе. Управляйте рутинами из [веб-интерфейса](https://claude.ai/code/routines) вместо этого445* Вы находитесь в облачном сеансе, где отправка `/schedule` отвечает, что команда недоступна в этой среде. Управляйте рутинами из [веб-интерфейса](https://claude.ai/code/routines) вместо этого

431* Политика вашей организации отключает [облачные сеансы](/docs/ru/claude-code-on-the-web), на которых работают рутины. В этом случае отправка `/schedule` отвечает [`Cloud sessions are disabled by your organization's policy`](/docs/ru/errors#cloud-sessions-are-disabled-by-your-organizations-policy) вместо этого. До версии v2.1.268 она возвращала `Unknown command: /schedule`446* Политика вашей организации отключает [облачные сеансы](/docs/ru/claude-code-on-the-web), на которых работают рутины. В этом случае отправка `/schedule` отвечает [`Cloud sessions are disabled by your organization's policy`](/docs/ru/errors#cloud-sessions-are-disabled-by-your-organizations-policy) вместо этого. До версии v2.1.268 она возвращала `Unknown command: /schedule`

432* Владелец [отключил рутины](#routines-are-disabled-by-your-organizations-policy) для вашей организации Team или Enterprise. До версии v2.1.227 команда все еще появлялась в этом случае, и claude.ai отклонял рутину, когда Claude пытался создать или запустить ее447* Владелец [отключил рутины](#routines-are-disabled-by-your-organizations-policy) для вашей организации Team или Enterprise. До версии v2.1.227 команда все еще появлялась в этом случае, и claude.ai отклонял рутину, когда Claude пытался создать или запустить ее

433 448 

Details

168* Runner устанавливает `GCM_INTERACTIVE=never`, чтобы Git Credential Manager не открывал диалог входа.168* Runner устанавливает `GCM_INTERACTIVE=never`, чтобы Git Credential Manager не открывал диалог входа.

169* Runner очищает `core.askPass`, поэтому, если вы используете помощника askpass, установите его через переменную окружения `GIT_ASKPASS` вместо этого.169* Runner очищает `core.askPass`, поэтому, если вы используете помощника askpass, установите его через переменную окружения `GIT_ASKPASS` вместо этого.

170 170 

171Если ваш git-хост отклоняет учетные данные или вы не конфигурировали их, runner повторяет попытку несколько раз, а затем не подготавливает репозиторий. Runner не передает эти параметры в окружение сеанса.171Если ваш git-хост отклоняет учетные данные или вы не конфигурировали их, runner повторяет попытку несколько раз, а затем не подготавливает репозиторий, когда репозиторий является тем, в который сеанс отправляет результаты. Для репозитория, из которого сеанс только читает, [Troubleshooting](#troubleshooting) охватывает, когда runner пропускает его вместо этого. Runner не передает эти параметры в окружение сеанса.

172 172 

173Если каталоги checkout принадлежат другому uid, чем процесс runner, git отказывается работать с ними; добавьте `safe.directory`:173Если каталоги checkout принадлежат другому uid, чем процесс runner, git отказывается работать с ними; добавьте `safe.directory`:

174 174 


531* **Сеансы не могут достичь сеть через аутентифицирующий исходящий прокси**: когда источник, который вы установили с помощью [`--proxy-authorization-command` или `--proxy-authorization-file`](#authenticate-to-an-egress-proxy), не удается, истекает по времени после 30 секунд или дает пустое значение, runner отвечает на это соединение `502 Bad Gateway` и регистрирует почему. Runner редактирует stderr команды в этом логе и никогда не регистрирует значение заголовка. С `--proxy-authorization-command`, запустите команду самостоятельно на хосте, чтобы подтвердить, что она печатает все значение заголовка на stdout. Если runner вместо этого выходит при запуске с `could not start the proxy-authorization listener`, он не мог открыть свой слушатель loopback.531* **Сеансы не могут достичь сеть через аутентифицирующий исходящий прокси**: когда источник, который вы установили с помощью [`--proxy-authorization-command` или `--proxy-authorization-file`](#authenticate-to-an-egress-proxy), не удается, истекает по времени после 30 секунд или дает пустое значение, runner отвечает на это соединение `502 Bad Gateway` и регистрирует почему. Runner редактирует stderr команды в этом логе и никогда не регистрирует значение заголовка. С `--proxy-authorization-command`, запустите команду самостоятельно на хосте, чтобы подтвердить, что она печатает все значение заголовка на stdout. Если runner вместо этого выходит при запуске с `could not start the proxy-authorization listener`, он не мог открыть свой слушатель loopback.

532* **Runner регистрирует строки `Poll failed`, содержащие `rejecting the malformed poll response`**: runner получил ответ на опрос работы, чье тело не является ожидаемым JSON очереди, чаще всего потому что что-то между runner и `api.anthropic.com`, такое как перехватывающий прокси или captive portal, ответил своей собственной страницей. Runner отклоняет ответ, считает его под видом `transport` метрики `claude_code_self_hosted_runner_poll_errors_total` [metric](/docs/ru/self-hosted-environments-reference#prometheus-metrics) и повторяет попытку по расписанию отказа опроса, описанному в [Session lifecycle](/docs/ru/self-hosted-environments#session-lifecycle). Runner продолжает обслуживать свои живые сеансы. Конфигурируйте прокси, чтобы пропустить ответы от `api.anthropic.com` без изменений. До v2.1.246, runner читал такой ответ как пустую очередь работы, которая могла закончить его живые сеансы или заставить его выйти.532* **Runner регистрирует строки `Poll failed`, содержащие `rejecting the malformed poll response`**: runner получил ответ на опрос работы, чье тело не является ожидаемым JSON очереди, чаще всего потому что что-то между runner и `api.anthropic.com`, такое как перехватывающий прокси или captive portal, ответил своей собственной страницей. Runner отклоняет ответ, считает его под видом `transport` метрики `claude_code_self_hosted_runner_poll_errors_total` [metric](/docs/ru/self-hosted-environments-reference#prometheus-metrics) и повторяет попытку по расписанию отказа опроса, описанному в [Session lifecycle](/docs/ru/self-hosted-environments#session-lifecycle). Runner продолжает обслуживать свои живые сеансы. Конфигурируйте прокси, чтобы пропустить ответы от `api.anthropic.com` без изменений. До v2.1.246, runner читал такой ответ как пустую очередь работы, которая могла закончить его живые сеансы или заставить его выйти.

533* **Ветка сеанса больше не существует на удаленном**: для источника git, который сеанс только читает, runner пропускает этот источник и продолжает на оставшихся. Для источника, на который сеанс отправляет результаты, удаленная ветка, обычно потому что она была объединена и auto-deleted, не удается сеанс с ошибкой, называющей репозиторий и ветку и просящей вас восстановить ветку и повторить попытку. Runner не удается сеанс с той же ошибкой, когда пропуск оставил бы его без репозитория вообще. До v2.1.228, такой сеанс начинался в пустом каталоге.533* **Ветка сеанса больше не существует на удаленном**: для источника git, который сеанс только читает, runner пропускает этот источник и продолжает на оставшихся. Для источника, на который сеанс отправляет результаты, удаленная ветка, обычно потому что она была объединена и auto-deleted, не удается сеанс с ошибкой, называющей репозиторий и ветку и просящей вас восстановить ветку и повторить попытку. Runner не удается сеанс с той же ошибкой, когда пропуск оставил бы его без репозитория вообще. До v2.1.228, такой сеанс начинался в пустом каталоге.

534* **Сеанс начинается без одного из его репозиториев**: на runner без [`checkout` hook](/docs/ru/self-hosted-environments-configuration#checkout), хост git может отказать в доступе runner для репозитория, который сеанс только читает. Runner затем пропускает этот репозиторий, регистрирует строку `[runner:warn] could not access context source`, называющую отказ, и начинает сеанс на оставшихся.

535 

536 Runner пропускает только явный отказ: хост отвечает, что репозиторий не найден, git не находит учетные данные для хоста или аутентификация не удается. Сбой сети, тайм-аут или HTTP `403` все еще не удается запустить сеанс, как и отказ для репозитория, на который сеанс отправляет результаты. Runner все еще не удается сеанс, который пропуск оставил бы без репозитория вообще. С [`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy), runner пропускает только репозиторий, который сам git proxy отрицает.

537 

538 Проверка доступа запускается снова каждый раз, когда сеанс начинается на runner, поэтому как только git identity runner имеет доступ на чтение, следующий старт клонирует репозиторий. До v2.1.274, каждый из этих отказов не удавался запустить сеанс.

534* **Сеансы занимают минуты для запуска**: начальный клон обычно доминирует. Смотрите метрику `claude_code_self_hosted_runner_session_init_duration_seconds` [metric](/docs/ru/self-hosted-environments-reference#prometheus-metrics), чтобы подтвердить, и сократите клон с помощью [pre-warmed checkout](#reuse-a-pre-warmed-checkout) или меньшего `CLAUDE_RUNNER_FETCH_DEPTH`.539* **Сеансы занимают минуты для запуска**: начальный клон обычно доминирует. Смотрите метрику `claude_code_self_hosted_runner_session_init_duration_seconds` [metric](/docs/ru/self-hosted-environments-reference#prometheus-metrics), чтобы подтвердить, и сократите клон с помощью [pre-warmed checkout](#reuse-a-pre-warmed-checkout) или меньшего `CLAUDE_RUNNER_FETCH_DEPTH`.

540* **Turns не удаются с 401**: каждый сеанс аутентифицирует вызовы модели с помощью краткосрочного [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/self-hosted-environments-configuration#wrapper-scripts), который runner получает от Anthropic и ротирует через stdin сеанса. Когда turn заканчивается с 401 или 403 от API модели, runner получает свежий токен и передает его сеансу. Неудачный turn не повторяется.

541 

542 Когда fetch не удается, runner регистрирует строку `inference_token refresh failed`, которая говорит, когда он будет повторять попытку, и он продолжает повторять попытку столько, сколько работает сеанс.

543 

544 Если каждый вызов начинает не удаваться примерно через 30 минут в сеанс, скрипт-обертка, вероятно, разорвал stdin сеанса, поэтому ротации токенов не могут достичь его; см. [Keep stdin and file descriptor 3 attached](/docs/ru/self-hosted-environments-configuration#keep-stdin-and-file-descriptor-3-attached).

545 

546 До v2.1.274, runner прекратил повторять попытку неудачного fetch после нескольких попыток и ждал следующего запланированного. Неудачный turn не вызвал fetch, поэтому каждый turn не удавался с 401 до следующего запланированного fetch.

535* **Pod убивается в середине осушения**: поднимите `terminationGracePeriodSeconds` по крайней мере на значение, которое runner регистрирует при запуске. См. [Shutdown timing](#shutdown-timing).547* **Pod убивается в середине осушения**: поднимите `terminationGracePeriodSeconds` по крайней мере на значение, которое runner регистрирует при запуске. См. [Shutdown timing](#shutdown-timing).

536 548 

537Как только логирование инициализируется, runner пишет свой лог жизненного цикла, включая строки `[runner:fatal]`, в stdout и отладочный вывод в stderr, все как простые текстовые строки, а не JSON. Отказы при запуске, описанные в записях устранения неполадок выше, печатаются в stderr перед этой точкой. Захватите оба потока с помощью `--log-file`, что также позволяет `self-hosted-runner doctor` их отслеживать, или с помощью сбора логов вашей платформы.549Как только логирование инициализируется, runner пишет свой лог жизненного цикла, включая строки `[runner:fatal]`, в stdout и отладочный вывод в stderr, все как простые текстовые строки, а не JSON. Отказы при запуске, описанные в записях устранения неполадок выше, печатаются в stderr перед этой точкой. Захватите оба потока с помощью `--log-file`, что также позволяет `self-hosted-runner doctor` их отслеживать, или с помощью сбора логов вашей платформы.

Details

103| `SELF_HOSTED_RUNNER_BG_RESULT_GRACE_MS` | `30000` | Как долго runner считает сеанс занятым после завершения фоновой задачи, пока не начнется следующий ход, который читает результат. Строки [`--drain-wait-sec` и `--release-idle-session-min`](#runner-cli-flags) описывают, где применяется удержание при осушении и отпуске при простое, и [Runner lifecycle](/docs/ru/self-hosted-environments#runner-lifecycle) описывает, где оно применяется при выходе на пенсию `--retire-at`. `0` или неиспользуемое значение возвращается к значению по умолчанию, поэтому удержание не может быть отключено. Требует Claude Code v2.1.228 или позже. |103| `SELF_HOSTED_RUNNER_BG_RESULT_GRACE_MS` | `30000` | Как долго runner считает сеанс занятым после завершения фоновой задачи, пока не начнется следующий ход, который читает результат. Строки [`--drain-wait-sec` и `--release-idle-session-min`](#runner-cli-flags) описывают, где применяется удержание при осушении и отпуске при простое, и [Runner lifecycle](/docs/ru/self-hosted-environments#runner-lifecycle) описывает, где оно применяется при выходе на пенсию `--retire-at`. `0` или неиспользуемое значение возвращается к значению по умолчанию, поэтому удержание не может быть отключено. Требует Claude Code v2.1.228 или позже. |

104| `SELF_HOSTED_RUNNER_HOST_CONFIG_DIR` | `~/.claude` | Каталог, захваченный в снимок запуска runner и посеянный в `CLAUDE_CONFIG_DIR` каждого сеанса; изменения на диске применяются после перезагрузки runner. Установка переменной также перемещает, где runner читает `.claude.json` для [MCP seeding](/docs/ru/self-hosted-environments-configuration#mcp-servers), поэтому установка её, включая её собственное значение по умолчанию, перемещает этот поиск; укажите на пустой каталог для полного отключения посева. |104| `SELF_HOSTED_RUNNER_HOST_CONFIG_DIR` | `~/.claude` | Каталог, захваченный в снимок запуска runner и посеянный в `CLAUDE_CONFIG_DIR` каждого сеанса; изменения на диске применяются после перезагрузки runner. Установка переменной также перемещает, где runner читает `.claude.json` для [MCP seeding](/docs/ru/self-hosted-environments-configuration#mcp-servers), поэтому установка её, включая её собственное значение по умолчанию, перемещает этот поиск; укажите на пустой каталог для полного отключения посева. |

105| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | Как долго runner ждет после того, как сеанс достигает своего лимита `--kill-session-after-min`, чтобы текущий ход завершился или отпуск завершился, перед завершением сеанса |105| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | Как долго runner ждет после того, как сеанс достигает своего лимита `--kill-session-after-min`, чтобы текущий ход завершился или отпуск завершился, перед завершением сеанса |

106| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | Ограничение на то, как долго runner считает сеанс занятым для осушения `--drain-wait-sec` после завершения хода, пока процесс сеанса сообщает об окончании хода в Anthropic. `0` или неиспользуемое значение возвращается к значению по умолчанию, поэтому удержание не может быть отключено. Требует Claude Code v2.1.275 или позже. |

106| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | Как долго runner ждет, пока ОС доставит `SIGKILL` дочернему процессу, застрявшему в неперерываемом I/O, перед выходом самого себя. Минимум `--post-session-hook-timeout-sec` плюс 15 секунд, и 30 больше, когда установлен `--push-outcome-on-release`, поэтому эффективный минимум составляет 75 секунд при значениях по умолчанию. |107| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | Как долго runner ждет, пока ОС доставит `SIGKILL` дочернему процессу, застрявшему в неперерываемом I/O, перед выходом самого себя. Минимум `--post-session-hook-timeout-sec` плюс 15 секунд, и 30 больше, когда установлен `--push-outcome-on-release`, поэтому эффективный минимум составляет 75 секунд при значениях по умолчанию. |

107| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | Глубина выборки Git для свежих клонов. Установите положительное целое число или `full` или `0` для полной выборки. Репозитории, уже присутствующие в рабочем пространстве, сохраняют свою существующую глубину. |108| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | Глубина выборки Git для свежих клонов. Установите положительное целое число или `full` или `0` для полной выборки. Репозитории, уже присутствующие в рабочем пространстве, сохраняют свою существующую глубину. |

108| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | unset | Когда `1`, пропустите проверку наличия `.git` после запуска hook `checkout`. Установите это, когда ваш hook материализует источник, не являющийся git. |109| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | unset | Когда `1`, пропустите проверку наличия `.git` после запуска hook `checkout`. Установите это, когда ваш hook материализует источник, не являющийся git. |

slack.md +3 −1

Details

231 231 

232Эта запись применяется к рабочим пространствам, использующим [Claude Tag](https://claude.com/docs/claude-tag/overview), где Claude работает в каналах как общая идентификация вашей организации, а не как учетная запись любого члена. Если вы создали облачную среду канала на [claude.ai/code](https://claude.ai/code), она принадлежит вашей личной учетной записи, и Claude не может запустить сеансы канала в личной среде. Claude Code немедленно завершает сеанс с ошибкой, и повторная попытка не помогает.232Эта запись применяется к рабочим пространствам, использующим [Claude Tag](https://claude.com/docs/claude-tag/overview), где Claude работает в каналах как общая идентификация вашей организации, а не как учетная запись любого члена. Если вы создали облачную среду канала на [claude.ai/code](https://claude.ai/code), она принадлежит вашей личной учетной записи, и Claude не может запустить сеансы канала в личной среде. Claude Code немедленно завершает сеанс с ошибкой, и повторная попытка не помогает.

233 233 

234Если вы являетесь владельцем, пересоздайте среду как [организационно-общую среду](/docs/ru/cloud-environments#organization-shared-environments) со страницы **Cloud environments** в [параметрах администратора](https://claude.ai/admin-settings). Вы можете применить ее двумя способами:234Если вы являетесь владельцем и среда принадлежит вам, [поделитесь ею с организацией](/docs/ru/cloud-environments#organization-shared-environments) из селектора среды. В противном случае владелец пересоздает ее как организационно-общую среду со страницы **Cloud environments** в [параметрах администратора](https://claude.ai/admin-settings).

235 

236Вы можете применить ее двумя способами:

235 237 

236* Установите ее как организационное значение по умолчанию на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).238* Установите ее как организационное значение по умолчанию на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).

237* [Установите ее на канале](https://claude.com/docs/claude-tag/admins/troubleshooting#channel-sessions-use-the-wrong-environment-or-can%E2%80%99t-find-one) в параметрах администратора Claude Tag.239* [Установите ее на канале](https://claude.com/docs/claude-tag/admins/troubleshooting#channel-sessions-use-the-wrong-environment-or-can%E2%80%99t-find-one) в параметрах администратора Claude Tag.

Details

196<Steps>196<Steps>

197 <Step title="Откройте представление diff">197 <Step title="Откройте представление diff">

198 Индикатор diff показывает добавленные и удаленные строки во всем сеансе, например `+42 -18`. Выберите его, чтобы открыть представление diff с списком файлов слева и изменениями справа.198 Индикатор diff показывает добавленные и удаленные строки во всем сеансе, например `+42 -18`. Выберите его, чтобы открыть представление diff с списком файлов слева и изменениями справа.

199 

200 Diff по умолчанию сравнивает изменения сеанса с его базовой веткой. Чтобы сравнить с другой веткой, выберите **Compare against** и выберите одну.

199 </Step>201 </Step>

200 202 

201 <Step title="Оставляйте встроенные комментарии">203 <Step title="Оставляйте встроенные комментарии">