SpyBara
Go Premium

Documentation 2026-07-15 22:00 UTC to 2026-07-16 22:59 UTC

97 files changed +1,651 −541. View all changes and history on the product overview
2026
Fri 17 01:01 Thu 16 22:59 Wed 15 22:00 Tue 14 23:01 Mon 13 23:57 Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01
Details

30 30 

31Если вы используете Claude Code через SSH, установите переменную окружения или параметр на удаленной машине, где работает Claude Code.31Если вы используете Claude Code через SSH, установите переменную окружения или параметр на удаленной машине, где работает Claude Code.

32 32 

33Когда режим включен, первое, что выводит Claude Code, это строка подтверждения, называющая метод, который его включил: `[Screen Reader Mode: on via flag]`, `[Screen Reader Mode: on via env]` или `[Screen Reader Mode: on via settings]`; этот формат именования метода требует Claude Code v2.1.206 или более поздней версии.33Когда режим включен, первое, что выводит Claude Code, это строка подтверждения, называющая метод, который его включил: `[Screen Reader Mode: on via flag]`, `[Screen Reader Mode: on via env]` или `[Screen Reader Mode: on via settings]`. Формат именования метода требует Claude Code v2.1.206 или более поздней версии. Когда Claude Code перезапускается, например для завершения установки обновления, новый процесс наследует режим через переменную окружения `CLAUDE_AX_SCREEN_READER`, поэтому его строка подтверждения читается как `[Screen Reader Mode: on via env]` независимо от того, какой метод вы использовали.

34{/* max-version: 2.1.205 */}Более ранние версии выводят `[Accessible screen reader mode: on]`.34{/* max-version: 2.1.205 */}Более ранние версии выводят `[Accessible screen reader mode: on]`.

35 35 

36<h2 id="turn-off-screen-reader-mode">36<h2 id="turn-off-screen-reader-mode">

admin-setup.md +5 −2

Details

95| [Sandboxing](/ru/sandboxing) | Изоляция файловой системы и сети на уровне ОС с разрешенными списками доменов | `sandbox.enabled`, `sandbox.network.allowedDomains` |95| [Sandboxing](/ru/sandboxing) | Изоляция файловой системы и сети на уровне ОС с разрешенными списками доменов | `sandbox.enabled`, `sandbox.network.allowedDomains` |

96| [Managed policy CLAUDE.md](/ru/memory#deploy-organization-wide-claude-md) | Инструкции на уровне организации, загруженные в каждый сеанс, не могут быть исключены | Файл по пути управляемой политики |96| [Managed policy CLAUDE.md](/ru/memory#deploy-organization-wide-claude-md) | Инструкции на уровне организации, загруженные в каждый сеанс, не могут быть исключены | Файл по пути управляемой политики |

97| [MCP server control](/ru/managed-mcp) | Ограничить, какие серверы MCP пользователи могут добавлять или подключать, или развернуть фиксированный набор | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly`, или развернутый файл `managed-mcp.json` |97| [MCP server control](/ru/managed-mcp) | Ограничить, какие серверы MCP пользователи могут добавлять или подключать, или развернуть фиксированный набор | `allowedMcpServers`, `deniedMcpServers`, `allowManagedMcpServersOnly`, или развернутый файл `managed-mcp.json` |

98| [Plugin marketplace control](/ru/plugin-marketplaces#managed-marketplace-restrictions) | Ограничить, какие источники маркетплейса пользователи могут добавлять и устанавливать, а также отклонить флаги CLI, которые загружают плагины, агентов и серверы MCP для одного запуска | `strictKnownMarketplaces`, `blockedMarketplaces`, `disableSideloadFlags` |98| [Plugin marketplace control](/ru/plugin-marketplaces#managed-marketplace-restrictions) | Ограничить, какие источники маркетплейса пользователи могут добавлять и устанавливать, отклонить флаги CLI, которые загружают плагины, агентов и серверы MCP для одного запуска, и разрешить список, какие плагины маркетплейсов могут быть предложены | `strictKnownMarketplaces`, `blockedMarketplaces`, `disableSideloadFlags`, `pluginSuggestionMarketplaces` |

99| [Customization lockdown](/ru/settings#strictpluginonlycustomization) | Заблокировать skills, agents, hooks и серверы MCP из источников пользователя и проекта, чтобы они могли поступать только из плагинов или управляемых параметров | `strictPluginOnlyCustomization` |99| [Customization lockdown](/ru/settings#strictpluginonlycustomization) | Заблокировать skills, agents, hooks и серверы MCP из источников пользователя и проекта, чтобы они могли поступать только из плагинов или управляемых параметров | `strictPluginOnlyCustomization` |

100| [Hook restrictions](/ru/settings#hook-configuration) | Загружаются только управляемые hooks; ограничить URL-адреса HTTP hook | `allowManagedHooksOnly`, `allowedHttpHookUrls` |100| [Hook restrictions](/ru/settings#hook-configuration) | Загружаются только управляемые hooks; ограничить URL-адреса HTTP hook | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

101| [Login enforcement](/ru/settings#available-settings) | Ограничить интерактивный вход на определенный метод или организацию Anthropic. Когда установлено, сеансы, аутентифицированные с помощью `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске; сеансы поставщиков облачных услуг не затрагиваются | `forceLoginMethod`, `forceLoginOrgUUID` |

101| [Disable agent view](/ru/agent-view#how-background-sessions-are-hosted) | Отключить `claude agents`, `--bg`, `/background` и встроенного супервизора по требованию | `disableAgentView` |102| [Disable agent view](/ru/agent-view#how-background-sessions-are-hosted) | Отключить `claude agents`, `--bg`, `/background` и встроенного супервизора по требованию | `disableAgentView` |

102| [Model restrictions](/ru/model-config#restrict-model-selection) | `availableModels` фильтрует, какие модели отображаются в средстве выбора. Добавление `enforceAvailableModels` также ограничивает автоматически выбранную модель по умолчанию. См. [surface coverage](/ru/model-config#surface-coverage) для того, как этот параметр достигает CLI, веб-интерфейса и IDE | `availableModels`, `enforceAvailableModels` |103| [Model restrictions](/ru/model-config#restrict-model-selection) | `availableModels` фильтрует, какие модели отображаются в средстве выбора. Добавление `enforceAvailableModels` также ограничивает автоматически выбранную модель по умолчанию. См. [surface coverage](/ru/model-config#surface-coverage) для того, как этот параметр достигает CLI, веб-интерфейса и IDE | `availableModels`, `enforceAvailableModels` |

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


105 106 

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

107 108 

109[Claude Code on the web](/ru/claude-code-on-the-web) имеет собственную поверхность администратора: на странице облачных сред в параметрах администратора владельцы и администраторы создают [организационные общие среды](/ru/claude-code-on-the-web#organization-shared-environments), которые устанавливают [уровень сетевого доступа](/ru/claude-code-on-the-web#network-access), переменные окружения и скрипт настройки для облачных сеансов членов, а также выбирают среду организации по умолчанию.

110 

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

109 112 

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


119| :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------- |122| :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------- |

120| Usage monitoring | Экспорт OpenTelemetry сеансов, инструментов и токенов | Все поставщики | [Monitoring usage](/ru/monitoring-usage) |123| Usage monitoring | Экспорт OpenTelemetry сеансов, инструментов и токенов | Все поставщики | [Monitoring usage](/ru/monitoring-usage) |

121| Analytics dashboard | Метрики принятия и вклада с таблицей лидеров на Teams / Enterprise; метрики использования и расходов для каждого пользователя на Console | Teams / Enterprise на [claude.ai/analytics](https://claude.ai/analytics/claude-code), Console на [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/ru/analytics) |124| Analytics dashboard | Метрики принятия и вклада с таблицей лидеров на Teams / Enterprise; метрики использования и расходов для каждого пользователя на Console | Teams / Enterprise на [claude.ai/analytics](https://claude.ai/analytics/claude-code), Console на [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/ru/analytics) |

122| Programmatic reporting | Данные об использовании и затратах для каждого пользователя через API | [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) для Enterprise, [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) для Console | [Costs](/ru/costs#manage-costs-for-your-organization) |125| Programmatic reporting | Данные об использовании и затратах для каждого пользователя через API | [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) для Enterprise, [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) для Console | [Costs](/ru/costs#manage-costs-for-your-organization) |

123| Spend controls | Ограничения расходов и ограничения скорости | Параметры администратора для Teams / Enterprise, ограничения рабочей области для Console; на облаках третьих сторон, элементы управления бюджетом облака или [Claude apps gateway](/ru/claude-apps-gateway) с ограничениями расходов для каждого пользователя [spend limits](/ru/claude-apps-gateway-spend-limits) | [Costs](/ru/costs#manage-costs-for-your-organization) |126| Spend controls | Ограничения расходов и ограничения скорости | Параметры администратора для Teams / Enterprise, ограничения рабочей области для Console; на облаках третьих сторон, элементы управления бюджетом облака или [Claude apps gateway](/ru/claude-apps-gateway) с ограничениями расходов для каждого пользователя [spend limits](/ru/claude-apps-gateway-spend-limits) | [Costs](/ru/costs#manage-costs-for-your-organization) |

124 127 

125На Teams и Enterprise данные об использовании и расходах для каждого пользователя поступают из [отчёта о расходах](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) в параметрах аналитики вашей организации, а не из панели аналитики. Облачные поставщики раскрывают расходы через AWS Cost Explorer, GCP Billing или Azure Cost Management. Для планирования корпоративных бюджетов в Claude chat, Claude Code и Cowork см. [руководство по потреблению Claude Enterprise](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide).128На Teams и Enterprise данные об использовании и расходах для каждого пользователя поступают из [отчёта о расходах](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) в параметрах аналитики вашей организации, а не из панели аналитики. Облачные поставщики раскрывают расходы через AWS Cost Explorer, GCP Billing или Azure Cost Management. Для планирования корпоративных бюджетов в Claude chat, Claude Code и Cowork см. [руководство по потреблению Claude Enterprise](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide).

advisor.md +2 −2

Details

7> Объедините вашу основную модель с более мощной моделью-советником, которую Claude консультирует в ключевые моменты выполнения задачи.7> Объедините вашу основную модель с более мощной моделью-советником, которую Claude консультирует в ключевые моменты выполнения задачи.

8 8 

9<Note>9<Note>

10 Инструмент advisor является экспериментальным и требует API Anthropic. Он недоступен на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Поведение, цены и доступность могут измениться.10 Инструмент advisor является экспериментальным и требует API Anthropic. Он недоступен на Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform или Microsoft Foundry. Поведение, цены и доступность могут измениться.

11</Note>11</Note>

12 12 

13Инструмент advisor позволяет Claude консультироваться со второй, обычно более мощной моделью в ключевые моменты выполнения задачи, например перед принятием подхода, когда возникает повторяющаяся ошибка, или перед объявлением задачи завершённой. Советник получает полный диалог, включая каждый вызов инструмента и результат, и возвращает рекомендации, которые Claude применяет перед продолжением.13Инструмент advisor позволяет Claude консультироваться со второй, обычно более мощной моделью в ключевые моменты выполнения задачи, например перед принятием подхода, когда возникает повторяющаяся ошибка, или перед объявлением задачи завершённой. Советник получает полный диалог, включая каждый вызов инструмента и результат, и возвращает рекомендации, которые Claude применяет перед продолжением.


159 159 

160Инструмент advisor требует всё следующее:160Инструмент advisor требует всё следующее:

161 161 

162* **Только API Anthropic**: советник является инструментом, выполняемым на сервере. Он недоступен на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Через [LLM gateway](/ru/llm-gateway), настроенный с `ANTHROPIC_BASE_URL`, доступность зависит от того, пересылает ли шлюз запрос в целости на API Anthropic.162* **Только API Anthropic**: советник является инструментом, выполняемым на сервере. Он недоступен на Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform или Microsoft Foundry. Через [LLM gateway](/ru/llm-gateway), настроенный с `ANTHROPIC_BASE_URL`, доступность зависит от того, пересылает ли шлюз запрос в целости на API Anthropic.

163* **Поддерживаемая основная модель**: Opus 4.6 или позже, Sonnet 4.6 или позже, или Haiku 4.5. {/* min-version: 2.1.170 */}Fable 5 также подходит на Claude Code v2.1.170 или позже.163* **Поддерживаемая основная модель**: Opus 4.6 или позже, Sonnet 4.6 или позже, или Haiku 4.5. {/* min-version: 2.1.170 */}Fable 5 также подходит на Claude Code v2.1.170 или позже.

164 164 

165<h2 id="turn-the-advisor-off">165<h2 id="turn-the-advisor-off">

Details

55 55 

56* **`SystemMessage`:** события жизненного цикла сессии. Поле `subtype` их различает:56* **`SystemMessage`:** события жизненного цикла сессии. Поле `subtype` их различает:

57 57 

58 * `"init"`: первое сообщение с метаданными сессии58 * `"init"`: метаданные сессии для запуска. Когда hook `SessionStart` или `Setup` запускается при инициализации сессии, его [сообщения жизненного цикла hook](/ru/agent-sdk/typescript#sdkhookstartedmessage) прибывают перед сообщением `init`

59 * `"compact_boundary"`: срабатывает после [компактирования](#automatic-compaction)59 * `"compact_boundary"`: срабатывает после [компактирования](#automatic-compaction)

60 * `"informational"`: простые текстовые баннеры статуса из цикла60 * `"informational"`: простые текстовые баннеры статуса из цикла

61 * `"worker_shutting_down"`: цикл завершится после текущего хода, потому что хост выходит или Remote Control отключился61 * `"worker_shutting_down"`: цикл завершится после текущего хода, потому что хост выходит или Remote Control отключился


233Опция режима разрешения (`permission_mode` в Python, `permissionMode` в TypeScript) контролирует, просит ли агент одобрения перед использованием инструментов:233Опция режима разрешения (`permission_mode` в Python, `permissionMode` в TypeScript) контролирует, просит ли агент одобрения перед использованием инструментов:

234 234 

235| Режим | Поведение |235| Режим | Поведение |

236| :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |236| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

237| `"default"` | Инструменты, не охватываемые правилами разрешения, запускают ваш обратный вызов одобрения; отсутствие обратного вызова означает отклонение |237| `"default"` | Инструменты, не охватываемые правилами разрешения, запускают ваш обратный вызов одобрения; отсутствие обратного вызова означает отклонение |

238| `"acceptEdits"` | Автоматически одобряет редактирование файлов и общие команды файловой системы (`mkdir`, `touch`, `mv`, `cp` и т. д.); другие команды Bash следуют правилам по умолчанию |238| `"acceptEdits"` | Автоматически одобряет редактирование файлов и общие команды файловой системы (`mkdir`, `touch`, `mv`, `cp` и т. д.); другие команды Bash следуют правилам по умолчанию |

239| `"plan"` | Claude исследует и планирует без редактирования ваших исходных файлов; редактирование файлов никогда не одобряется автоматически и запрашивается через ваш обратный вызов `canUseTool` |239| `"plan"` | Claude исследует и планирует без редактирования ваших исходных файлов; редактирование файлов никогда не одобряется автоматически и запрашивается через ваш обратный вызов `canUseTool` |

240| `"dontAsk"` | Никогда не подсказывает. Инструменты, предварительно одобренные [правилами разрешения](/ru/settings#permission-settings), работают, все остальное отклоняется |240| `"dontAsk"` | Никогда не подсказывает. Инструменты, предварительно одобренные [правилами разрешения](/ru/settings#permission-settings), работают; все остальное отклоняется. `AskUserQuestion`, инструменты соединителя [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), отклоняются даже если вы их разрешили |

241| `"auto"` | Использует классификатор модели для одобрения или отклонения каждого вызова инструмента. См. [Режим Auto](/ru/permission-modes#eliminate-prompts-with-auto-mode) для доступности и поведения |241| `"auto"` | Использует классификатор модели для одобрения или отклонения каждого вызова инструмента. См. [Режим Auto](/ru/permission-modes#eliminate-prompts-with-auto-mode) для доступности и поведения |

242| `"bypassPermissions"` | Запускает все разрешенные инструменты без запроса, если явное правило [`ask`](/ru/settings#permission-settings) не совпадает; см. [Как оцениваются разрешения](/ru/agent-sdk/permissions#how-permissions-are-evaluated) для того, где правила ask находятся в порядке приоритета. Не может использоваться при запуске от root на Unix. Используйте только в изолированных окружениях, где действия агента не могут повлиять на системы, которые вам важны |242| `"bypassPermissions"` | Запускает все разрешенные инструменты без запроса, кроме инструментов, совпадающих с явным правилом [`ask`](/ru/settings#permission-settings), инструментов соединителя [установленных вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструментов, требующих взаимодействия с пользователем; см. [Как оцениваются разрешения](/ru/agent-sdk/permissions#how-permissions-are-evaluated) для порядка приоритета. Не может использоваться при запуске от root на Unix. Используйте только в изолированных окружениях, где действия агента не могут повлиять на системы, которые вам важны |

243 243 

244Для интерактивных приложений используйте `"default"` с обратным вызовом одобрения инструмента для отображения подсказок одобрения. Для автономных агентов на машине разработки используйте `"acceptEdits"`, чтобы автоматически одобрить редактирование файлов и общие команды файловой системы (`mkdir`, `touch`, `mv`, `cp` и т. д.), при этом все еще ограничивая другие команды `Bash` правилами разрешения. Зарезервируйте `"bypassPermissions"` для CI, контейнеров или других изолированных окружений. См. [Разрешения](/ru/agent-sdk/permissions) для полных деталей.244Для интерактивных приложений используйте `"default"` с обратным вызовом одобрения инструмента для отображения подсказок одобрения. Для автономных агентов на машине разработки используйте `"acceptEdits"`, чтобы автоматически одобрить редактирование файлов и общие команды файловой системы (`mkdir`, `touch`, `mv`, `cp` и т. д.), при этом все еще ограничивая другие команды `Bash` правилами разрешения. Зарезервируйте `"bypassPermissions"` для CI, контейнеров или других изолированных окружений. См. [Разрешения](/ru/agent-sdk/permissions) для полных деталей.

245 245 


486* **Нужен более плотный контроль над тем, что может делать агент?** Заблокируйте доступ к инструментам с помощью [разрешений](/ru/agent-sdk/permissions) и используйте [hooks](/ru/agent-sdk/hooks) для аудита, блокировки или преобразования вызовов инструментов перед их выполнением.486* **Нужен более плотный контроль над тем, что может делать агент?** Заблокируйте доступ к инструментам с помощью [разрешений](/ru/agent-sdk/permissions) и используйте [hooks](/ru/agent-sdk/hooks) для аудита, блокировки или преобразования вызовов инструментов перед их выполнением.

487* **Запускаете долгие или дорогие задачи?** Перенесите изолированную работу на [подагентов](/ru/agent-sdk/subagents), чтобы держать ваш основной контекст стройным.487* **Запускаете долгие или дорогие задачи?** Перенесите изолированную работу на [подагентов](/ru/agent-sdk/subagents), чтобы держать ваш основной контекст стройным.

488 488 

489Для более широкой концептуальной картины цикла агента (не специфичной для SDK) см. [Как работает Claude Code](/ru/how-claude-code-works).489Для более широкой концептуальной картины цикла агента (не специфичной для SDK) см. [Как работает Claude Code](/ru/how-claude-code-works). Для практического руководства по проектированию циклов в Claude Code, от циклов на основе ходов к циклам на основе целей и проактивным циклам, см. [Loop engineering: getting started with loops](https://claude.com/blog/getting-started-with-loops) в блоге.

Details

57 57 

58Результирующее сообщение ([TypeScript](/ru/agent-sdk/typescript#sdkresultmessage), [Python](/ru/agent-sdk/python#resultmessage)) отмечает конец цикла агента для вызова `query()`. Оно включает `total_cost_usd`, совокупную предполагаемую стоимость всех шагов в этом вызове. Это работает как для успешных, так и для ошибочных результатов. Если вы используете сессии для создания нескольких вызовов `query()`, каждый результат отражает только стоимость этого отдельного вызова.58Результирующее сообщение ([TypeScript](/ru/agent-sdk/typescript#sdkresultmessage), [Python](/ru/agent-sdk/python#resultmessage)) отмечает конец цикла агента для вызова `query()`. Оно включает `total_cost_usd`, совокупную предполагаемую стоимость всех шагов в этом вызове. Это работает как для успешных, так и для ошибочных результатов. Если вы используете сессии для создания нескольких вызовов `query()`, каждый результат отражает только стоимость этого отдельного вызова.

59 59 

60Три поля уровня результата отличаются тем, что они считают, когда агент порождает [подагентов](/ru/agent-sdk/subagents). Используйте `modelUsage` или `model_usage` в Python для учета токенов всего дерева; поле `usage` недосчитывает, как только происходит вложение.

61 

62| Field | Subagent activity |

63| ---------------------------- | --------------------------------------------------------------------------------------------------------------------- |

64| `usage` | Исключено. Считает только цикл агента верхнего уровня, поэтому токены, потребленные внутри подагентов, не добавляются |

65| `total_cost_usd` | Включено. Считает запросы подагентов наряду с циклом верхнего уровня |

66| `modelUsage` / `model_usage` | Включено. Считает запросы подагентов наряду с циклом верхнего уровня, разбитые по моделям |

67 

60Следующие примеры перебирают поток сообщений из вызова `query()` и выводят общую стоимость при поступлении сообщения `result`:68Следующие примеры перебирают поток сообщений из вызова `query()` и выводят общую стоимость при поступлении сообщения `result`:

61 69 

62<CodeGroup>70<CodeGroup>

Details

149SDK предоставляет hooks для различных этапов выполнения агента. Некоторые hooks доступны в обоих SDK, в то время как другие доступны только в TypeScript.149SDK предоставляет hooks для различных этапов выполнения агента. Некоторые hooks доступны в обоих SDK, в то время как другие доступны только в TypeScript.

150 150 

151| Hook Event | Python SDK | TypeScript SDK | Что его срабатывает | Пример использования |151| Hook Event | Python SDK | TypeScript SDK | Что его срабатывает | Пример использования |

152| -------------------- | ---------- | -------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |152| ------------------------------------------------------ | ---------- | -------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |

153| `PreToolUse` | Да | Да | Запрос вызова инструмента (может блокировать или изменять) | Блокировать опасные команды shell |153| `PreToolUse` | Да | Да | Запрос вызова инструмента (может блокировать или изменять) | Блокировать опасные команды shell |

154| `PostToolUse` | Да | Да | Результат выполнения инструмента | Логировать все изменения файлов в журнал аудита |154| `PostToolUse` | Да | Да | Результат выполнения инструмента | Логировать все изменения файлов в журнал аудита |

155| `PostToolUseFailure` | Да | Да | Ошибка выполнения инструмента | Обработать или логировать ошибки инструмента |155| `PostToolUseFailure` | Да | Да | Ошибка выполнения инструмента | Обработать или логировать ошибки инструмента |

156| `PostToolBatch` | Нет | Да | Полный пакет вызовов инструментов разрешается, один раз за пакет перед следующим вызовом модели | Внедрить соглашения один раз для всего пакета |156| `PostToolBatch` | Нет | Да | Полный пакет вызовов инструментов разрешается, один раз за пакет перед следующим вызовом модели | Внедрить соглашения один раз для всего пакета |

157| `UserPromptSubmit` | Да | Да | Отправка пользовательского приглашения | Внедрить дополнительный контекст в приглашения |157| `UserPromptSubmit` | Да | Да | Отправка пользовательского приглашения | Внедрить дополнительный контекст в приглашения |

158| [`UserPromptExpansion`](/ru/hooks#userpromptexpansion) | Нет | Да | Команда, введённая пользователем, расширяется в приглашение перед тем, как она достигнет Claude | Заблокировать команду от прямого вызова или добавить контекст при вводе skill |

158| `MessageDisplay` | Нет | Да | Сообщение ассистента с текстом завершается, один раз за сообщение с полным текстом сообщения | Скрыть или переформатировать отображаемый текст без изменения стенограммы |159| `MessageDisplay` | Нет | Да | Сообщение ассистента с текстом завершается, один раз за сообщение с полным текстом сообщения | Скрыть или переформатировать отображаемый текст без изменения стенограммы |

159| `Stop` | Да | Да | Остановка выполнения агента | Сохранить состояние сеанса перед выходом |160| `Stop` | Да | Да | Остановка выполнения агента | Сохранить состояние сеанса перед выходом |

160| `SubagentStart` | Да | Да | Инициализация подагента | Отслеживать порождение параллельных задач |161| `SubagentStart` | Да | Да | Инициализация подагента | Отслеживать порождение параллельных задач |


817* Увеличьте значение `timeout` в конфигурации `HookMatcher`818* Увеличьте значение `timeout` в конфигурации `HookMatcher`

818* Используйте `AbortSignal` из третьего аргумента callback для корректной обработки отмены в TypeScript819* Используйте `AbortSignal` из третьего аргумента callback для корректной обработки отмены в TypeScript

819 820 

821{/* min-version: 2.1.208 */}Callback `UserPromptSubmit` или [`UserPromptExpansion`](/ru/hooks#userpromptexpansion), который превышает свой timeout, блокирует этот запрос с сообщением timeout, и сеанс продолжается. Прерывание запроса во время ожидания callback отменяет ожидающий вызов инструмента. До версии 2.1.208 timeout callback на этих событиях завершал запрос с `error_during_execution`, и прерывание во время ожидания callback `PreToolUse` могло позволить вызову инструмента продолжиться.

822 

820<h3 id="tool-blocked-unexpectedly">823<h3 id="tool-blocked-unexpectedly">

821 Инструмент заблокирован неожиданно824 Инструмент заблокирован неожиданно

822</h3>825</h3>


887 systemMessage не появляется в выводе890 systemMessage не появляется в выводе

888</h3>891</h3>

889 892 

890Поле `systemMessage` показывает сообщение пользователю, а не модели. По умолчанию SDK не выводит выходные данные hook в поток сообщений, поэтому сообщение может не появиться, если вы не установите `includeHookEvents` (`include_hook_events` в Python). Для передачи контекста модели вместо этого верните [`additionalContext`](/ru/hooks#add-context-for-claude).893Поле `systemMessage` показывает сообщение пользователю, а не модели. По умолчанию SDK выводит выходные данные hook в поток сообщений только для hooks `SessionStart` и `Setup`, поэтому сообщение из любого другого события hook не появляется, если вы не установите `includeHookEvents` (`include_hook_events` в Python). Для передачи контекста модели вместо этого верните [`additionalContext`](/ru/hooks#add-context-for-claude).

891 894 

892Если вам нужно надежно вывести решения hook в ваше приложение, логируйте их отдельно или используйте выделенный канал вывода.895Если вам нужно надежно вывести решения hook в ваше приложение, логируйте их отдельно или используйте выделенный канал вывода.

893 896 

Details

188Подстановочные знаки (`*`) позволяют разрешить все инструменты с сервера без перечисления каждого отдельно.188Подстановочные знаки (`*`) позволяют разрешить все инструменты с сервера без перечисления каждого отдельно.

189 189 

190<Note>190<Note>

191 **Предпочитайте `allowedTools` режимам разрешений для доступа MCP.** `permissionMode: "acceptEdits"` не одобряет автоматически MCP инструменты (только редактирование файлов и команды Bash файловой системы). `permissionMode: "bypassPermissions"` одобряет автоматически MCP инструменты, но также отключает все остальные подсказки безопасности, что шире, чем необходимо. Подстановочный знак в `allowedTools` предоставляет доступ ровно к нужному MCP серверу и ничему больше. См. [Режимы разрешений](/ru/agent-sdk/permissions#permission-modes) для полного сравнения.191 **Предпочитайте `allowedTools` режимам разрешений для доступа MCP.** `permissionMode: "acceptEdits"` не одобряет автоматически MCP инструменты (только редактирование файлов и команды Bash файловой системы). `permissionMode: "bypassPermissions"` одобряет автоматически MCP инструменты, но также отключает все остальные подсказки безопасности, что шире, чем необходимо; см. [Как оцениваются разрешения](/ru/agent-sdk/permissions#how-permissions-are-evaluated) для подсказок, которые остаются. Подстановочный знак в `allowedTools` предоставляет доступ ровно к нужному MCP серверу и ничему больше. См. [Режимы разрешений](/ru/agent-sdk/permissions#permission-modes) для полного сравнения.

192</Note>192</Note>

193 193 

194<h3 id="discover-available-tools">194<h3 id="discover-available-tools">


831* Предварительный прогрев сервера перед запуском вашего агента831* Предварительный прогрев сервера перед запуском вашего агента

832* Проверку логов сервера на предмет причин медленной инициализации832* Проверку логов сервера на предмет причин медленной инициализации

833 833 

834<h3 id="tool-output-exceeds-maximum-allowed-tokens">

835 Выходные данные инструмента превышают максимально допустимое количество токенов

836</h3>

837 

838SDK применяет тот же лимит выходных данных MCP, что и Claude Code. Когда результат инструмента больше 25 000 токенов, полный выход сохраняется в файл, а результат инструмента заменяется сообщением об ошибке, которое указывает путь к файлу, чтобы агент мог прочитать выход порциями. Увеличьте лимит с помощью переменной окружения [`MAX_MCP_OUTPUT_TOKENS`](/ru/env-vars). Смотрите [MCP output limits and warnings](/ru/mcp#mcp-output-limits-and-warnings) для полного поведения, включая то, как сервер может объявить более высокий лимит для каждого инструмента.

839 

834<h2 id="related-resources">840<h2 id="related-resources">

835 Связанные ресурсы841 Связанные ресурсы

836</h2>842</h2>

Details

6 6 

7> Создавайте производственные AI-агентов с Claude Code как библиотеку7> Создавайте производственные AI-агентов с Claude Code как библиотеку

8 8 

9Создавайте AI-агентов, которые автономно читают файлы, запускают команды, ищут в интернете, редактируют код и многое другое. Agent SDK предоставляет вам те же инструменты, цикл агента и управление контекстом, которые питают Claude Code, программируемые на Python и TypeScript.9Создавайте AI-агентов, которые автономно читают файлы, запускают команды, ищут в интернете, редактируют код и многое другое. Agent SDK предоставляет вам те же инструменты, цикл агента и управление контекстом, которые питают Claude Code, программируемые на Python и TypeScript. Для получения информации о логике проектирования агентского каркаса см. [A harness for every task: dynamic workflows in Claude Code](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code) в блоге.

10 10 

11<CodeGroup>11<CodeGroup>

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

Details

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

32 32 

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

34 

35 Инструменты [claude.ai connector](/ru/mcp#organization-controls-on-connector-tools), которые ваша организация установила на `ask`, также покидают поток на этом шаге. Каждый вызов передаётся callback, даже в режиме `bypassPermissions` и даже когда совпадает правило allow. Callback получает причину `Your organization requires approval for this tool`. В режиме `dontAsk` вызов отклоняется вместо этого, потому что этот режим никогда не запрашивает подтверждение.

34 </Step>36 </Step>

35 37 

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


77 79 

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

79 81 

82Правила с областью действия для `Read` и `Edit` принимают шаблон пути. Правила `Edit(path)` управляют всеми встроенными инструментами, которые записывают файлы, включая `Write` и `NotebookEdit`; правило `Write(path)` никогда не совпадает с проверками разрешений файлов.

83 

84Используйте `//path` для абсолютного пути файловой системы: правило deny `Edit(//secrets/**)` блокирует записи в любом месте под `/secrets` на диске. С одной ведущей косой чертой `Edit(/secrets/**)` якорируется в источнике правила. Для правил, переданных через `allowed_tools` или `disallowed_tools`, это означает рабочий каталог сеанса, поэтому правило не блокирует `/secrets` на диске. См. [Правила Read и Edit](/ru/permissions#read-and-edit) для четырёх форм якорей и того, как правила из файлов параметров разрешаются.

85 

80<Warning>86<Warning>

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

88 

89 Охват зависит от формы записи: простое имя, такое как `Read` или `mcp__github__get_issue`, автоматически одобряет каждый вызов этого инструмента, в то время как правило с областью действия, такое как `Bash(ls *)`, автоматически одобряет только совпадающие вызовы, и другие вызовы `Bash` всё ещё переходят к обратному вызову. Для проверок, которые должны выполняться при каждом вызове инструмента, используйте [`PreToolUse` hook](/ru/agent-sdk/hooks): hooks выполняются перед каждым другим шагом, и отказ hook применяется даже в режиме `bypassPermissions`.

82</Warning>90</Warning>

83 91 

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

85 93 

86```typescript theme={null}94```typescript theme={null}

87const options = {95const options = {


109SDK поддерживает эти режимы разрешений:117SDK поддерживает эти режимы разрешений:

110 118 

111| Режим | Описание | Поведение инструмента |119| Режим | Описание | Поведение инструмента |

112| :------------------ | :-------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |120| :------------------ | :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

113| `default` | Стандартное поведение разрешений | Без автоматических одобрений; несовпадающие инструменты запускают ваш callback `canUseTool` |121| `default` | Стандартное поведение разрешений | Без автоматических одобрений; несовпадающие инструменты запускают ваш callback `canUseTool` |

114| `dontAsk` | Отклонение вместо запроса | Всё, что не предварительно одобрено `allowed_tools` или правилами, отклоняется; `canUseTool` никогда не вызывается |122| `dontAsk` | Отклонение вместо запроса | Всё, что не предварительно одобрено `allowed_tools` или правилами, отклоняется; инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, отклоняются даже если вы их предварительно одобрили. `canUseTool` никогда не вызывается |

115| `acceptEdits` | Автоматическое принятие редактирования файлов | Редактирование файлов и [операции с файловой системой](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv` и т. д.) автоматически одобрены |123| `acceptEdits` | Автоматическое принятие редактирования файлов | Редактирование файлов и [операции с файловой системой](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv` и т. д.) автоматически одобрены |

116| `bypassPermissions` | Обход всех проверок разрешений | Инструменты работают без запросов разрешений, если только явное правило [`ask`](#how-permissions-are-evaluated) не совпадает (используйте с осторожностью) |124| `bypassPermissions` | Обход всех проверок разрешений | Инструменты работают без запросов разрешений, кроме инструментов, совпадающих с явным правилом [`ask`](#how-permissions-are-evaluated), инструментов соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструментов, требующих взаимодействия с пользователем (используйте с осторожностью) |

117| `plan` | Режим планирования | Claude исследует и планирует без редактирования исходных файлов; редактирование файлов никогда не одобряется автоматически и запрашивается через ваш callback `canUseTool` |125| `plan` | Режим планирования | Claude исследует и планирует без редактирования исходных файлов; редактирование файлов никогда не одобряется автоматически и запрашивается через ваш callback `canUseTool` |

118| `auto` | Одобрения, классифицированные моделью | Классификатор модели одобряет или отклоняет каждый вызов инструмента. См. [Режим Auto](/ru/permission-modes#eliminate-prompts-with-auto-mode) для доступности |126| `auto` | Одобрения, классифицированные моделью | Классификатор модели одобряет или отклоняет каждый вызов инструмента. См. [Режим Auto](/ru/permission-modes#eliminate-prompts-with-auto-mode) для доступности |

119 127 

120<Warning>128<Warning>

121 **Наследование подагентом:** Когда родитель использует `bypassPermissions`, `acceptEdits` или `auto`, все подагенты наследуют этот режим и он не может быть переопределён для каждого подагента. Подагенты могут иметь различные системные подсказки и менее ограниченное поведение, чем ваш основной агент, поэтому наследование `bypassPermissions` предоставляет им полный автономный доступ к системе. Явное правило [`ask`](#how-permissions-are-evaluated) по-прежнему вынуждает запрос.129 **Наследование подагентом:** Когда родитель использует `bypassPermissions`, `acceptEdits` или `auto`, все подагенты наследуют этот режим и он не может быть переопределён для каждого подагента. Подагенты могут иметь различные системные подсказки и менее ограниченное поведение, чем ваш основной агент, поэтому наследование `bypassPermissions` предоставляет им полный автономный доступ к системе. Явные правила [`ask`](#how-permissions-are-evaluated), инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, по-прежнему вынуждают запрос.

122</Warning>130</Warning>

123 131 

124<h3 id="set-permission-mode">132<h3 id="set-permission-mode">


252 Режим без запроса (`dontAsk`)260 Режим без запроса (`dontAsk`)

253</h4>261</h4>

254 262 

255Преобразует любой запрос разрешения в отклонение. Инструменты, предварительно одобренные `allowed_tools`, правилами allow в `settings.json` или hook, работают нормально. Всё остальное отклоняется без вызова `canUseTool`.263Преобразует любой запрос разрешения в отклонение. Инструменты, предварительно одобренные `allowed_tools`, правилами allow в `settings.json` или hook, работают нормально. Инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, отклоняются даже если правило allow совпадает. Всё остальное отклоняется без вызова `canUseTool`.

256 264 

257**Используйте, когда:** вы хотите фиксированную, явную поверхность инструментов для автономного агента и предпочитаете жёсткое отклонение молчаливому полаганию на отсутствие `canUseTool`.265**Используйте, когда:** вы хотите фиксированную, явную поверхность инструментов для автономного агента и предпочитаете жёсткое отклонение молчаливому полаганию на отсутствие `canUseTool`.

258 266 


265<Warning>273<Warning>

266 Используйте с крайней осторожностью. Claude имеет полный доступ к системе в этом режиме. Используйте только в контролируемых средах, где вы доверяете всем возможным операциям.274 Используйте с крайней осторожностью. Claude имеет полный доступ к системе в этом режиме. Используйте только в контролируемых средах, где вы доверяете всем возможным операциям.

267 275 

268 `allowed_tools` не ограничивает этот режим. Каждый инструмент одобрен, а не только те, которые вы указали. Правила deny (`disallowed_tools`), явные правила `ask` и hooks оцениваются перед проверкой режима и всё ещё могут заблокировать инструмент.276 `allowed_tools` не ограничивает этот режим. Каждый инструмент одобрен, а не только те, которые вы указали. Правила deny (`disallowed_tools`), явные правила `ask` и hooks оцениваются перед проверкой режима и всё ещё могут заблокировать инструмент. Инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, по-прежнему переходят к вашему callback `canUseTool`.

269</Warning>277</Warning>

270 278 

271<h4 id="plan-mode-plan">279<h4 id="plan-mode-plan">

Details

138) -> Callable[[Callable[[Any], Awaitable[dict[str, Any]]]], SdkMcpTool[Any]]138) -> Callable[[Callable[[Any], Awaitable[dict[str, Any]]]], SdkMcpTool[Any]]

139```139```

140 140 

141<h4 id="parameters-1">141<h4 id="parameters-2">

142 Параметры142 Параметры

143</h4>143</h4>

144 144 


171 }171 }

172 ```172 ```

173 173 

174<h4 id="returns-1">174<h4 id="returns-2">

175 Возвращаемое значение175 Возвращаемое значение

176</h4>176</h4>

177 177 


234) -> McpSdkServerConfig234) -> McpSdkServerConfig

235```235```

236 236 

237<h4 id="parameters-2">237<h4 id="parameters-3">

238 Параметры238 Параметры

239</h4>239</h4>

240 240 


244| `version` | `str` | `"1.0.0"` | Строка версии сервера |244| `version` | `str` | `"1.0.0"` | Строка версии сервера |

245| `tools` | `list[SdkMcpTool[Any]] \| None` | `None` | Список функций инструментов, созданных с помощью декоратора `@tool` |245| `tools` | `list[SdkMcpTool[Any]] \| None` | `None` | Список функций инструментов, созданных с помощью декоратора `@tool` |

246 246 

247<h4 id="returns-2">247<h4 id="returns-3">

248 Возвращаемое значение248 Возвращаемое значение

249</h4>249</h4>

250 250 

251Возвращает объект `McpSdkServerConfig`, который можно передать в `ClaudeAgentOptions.mcp_servers`.251Возвращает объект `McpSdkServerConfig`, который можно передать в `ClaudeAgentOptions.mcp_servers`.

252 252 

253<h4 id="example-1">253<h4 id="example-2">

254 Пример254 Пример

255</h4>255</h4>

256 256 


291def list_sessions(291def list_sessions(

292 directory: str | None = None,292 directory: str | None = None,

293 limit: int | None = None,293 limit: int | None = None,

294 offset: int = 0,

294 include_worktrees: bool = True295 include_worktrees: bool = True

295) -> list[SDKSessionInfo]296) -> list[SDKSessionInfo]

296```297```

297 298 

298<h4 id="parameters-3">299<h4 id="parameters-4">

299 Параметры300 Параметры

300</h4>301</h4>

301 302 

302| Параметр | Тип | По умолчанию | Описание |303| Параметр | Тип | По умолчанию | Описание |

303| :------------------ | :------------ | :----------- | :------------------------------------------------------------------------------------------- |304| :------------------ | :------------ | :----------- | :-------------------------------------------------------------------------------------------------------------------- |

304| `directory` | `str \| None` | `None` | Каталог для вывода сеансов. Если опущено, возвращает сеансы во всех проектах |305| `directory` | `str \| None` | `None` | Каталог для вывода сеансов. Если опущено, возвращает сеансы во всех проектах |

305| `limit` | `int \| None` | `None` | Максимальное количество возвращаемых сеансов |306| `limit` | `int \| None` | `None` | Максимальное количество возвращаемых сеансов |

307| `offset` | `int` | `0` | Количество сеансов для пропуска с начала отсортированных результатов. Используйте с `limit` для разбиения на страницы |

306| `include_worktrees` | `bool` | `True` | Когда `directory` находится внутри репозитория git, включайте сеансы из всех путей worktrees |308| `include_worktrees` | `bool` | `True` | Когда `directory` находится внутри репозитория git, включайте сеансы из всех путей worktrees |

307 309 

308<h4 id="return-type-sdksessioninfo">310<h4 id="return-type-sdksessioninfo">


322| `tag` | `str \| None` | Тег сеанса, установленный пользователем (см. [`tag_session()`](#tag_session)) |324| `tag` | `str \| None` | Тег сеанса, установленный пользователем (см. [`tag_session()`](#tag_session)) |

323| `created_at` | `int \| None` | Время создания сеанса в миллисекундах с начала эпохи |325| `created_at` | `int \| None` | Время создания сеанса в миллисекундах с начала эпохи |

324 326 

325<h4 id="example-2">327<h4 id="example-3">

326 Пример328 Пример

327</h4>329</h4>

328 330 


350) -> list[SessionMessage]352) -> list[SessionMessage]

351```353```

352 354 

353<h4 id="parameters-4">355<h4 id="parameters-5">

354 Параметры356 Параметры

355</h4>357</h4>

356 358 


373| `message` | `Any` | Необработанное содержимое сообщения |375| `message` | `Any` | Необработанное содержимое сообщения |

374| `parent_tool_use_id` | `None` | Зарезервировано для будущего использования |376| `parent_tool_use_id` | `None` | Зарезервировано для будущего использования |

375 377 

376<h4 id="example-3">378<h4 id="example-4">

377 Пример379 Пример

378</h4>380</h4>

379 381 


400) -> SDKSessionInfo | None402) -> SDKSessionInfo | None

401```403```

402 404 

403<h4 id="parameters-5">405<h4 id="parameters-6">

404 Параметры406 Параметры

405</h4>407</h4>

406 408 


411 413 

412Возвращает [`SDKSessionInfo`](#return-type-sdksessioninfo) или `None`, если сеанс не найден.414Возвращает [`SDKSessionInfo`](#return-type-sdksessioninfo) или `None`, если сеанс не найден.

413 415 

414<h4 id="example-4">416<h4 id="example-5">

415 Пример417 Пример

416</h4>418</h4>

417 419 


439) -> None441) -> None

440```442```

441 443 

442<h4 id="parameters-6">444<h4 id="parameters-7">

443 Параметры445 Параметры

444</h4>446</h4>

445 447 


451 453 

452Вызывает `ValueError`, если `session_id` не является допустимым UUID или `title` пуст; `FileNotFoundError`, если сеанс не найден.454Вызывает `ValueError`, если `session_id` не является допустимым UUID или `title` пуст; `FileNotFoundError`, если сеанс не найден.

453 455 

454<h4 id="example-5">456<h4 id="example-6">

455 Пример457 Пример

456</h4>458</h4>

457 459 


479) -> None481) -> None

480```482```

481 483 

482<h4 id="parameters-7">484<h4 id="parameters-8">

483 Параметры485 Параметры

484</h4>486</h4>

485 487 


491 493 

492Вызывает `ValueError`, если `session_id` не является допустимым UUID или `tag` пуст после очистки; `FileNotFoundError`, если сеанс не найден.494Вызывает `ValueError`, если `session_id` не является допустимым UUID или `tag` пуст после очистки; `FileNotFoundError`, если сеанс не найден.

493 495 

494<h4 id="example-6">496<h4 id="example-7">

495 Пример497 Пример

496</h4>498</h4>

497 499 


903```905```

904 906 

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

906| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |908| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

907| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Конфигурация инструментов. Используйте `{"type": "preset", "preset": "claude_code"}` для инструментов Claude Code по умолчанию |909| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Конфигурация инструментов. Используйте `{"type": "preset", "preset": "claude_code"}` для инструментов Claude Code по умолчанию |

908| `allowed_tools` | `list[str]` | `[]` | Инструменты для автоматического одобрения без запроса. Это не ограничивает Claude только этими инструментами; неуказанные инструменты переходят к `permission_mode` и `can_use_tool`. Используйте `disallowed_tools` для блокировки инструментов. См. [Permissions](/ru/agent-sdk/permissions#allow-and-deny-rules) |910| `allowed_tools` | `list[str]` | `[]` | Инструменты для автоматического одобрения без запроса. Это не ограничивает Claude только этими инструментами; неуказанные инструменты переходят к `permission_mode` и `can_use_tool`. Используйте `disallowed_tools` для блокировки инструментов. См. [Permissions](/ru/agent-sdk/permissions#allow-and-deny-rules) |

909| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptFile \| None` | `None` | Конфигурация системной подсказки. Передайте строку для пользовательской подсказки, `{"type": "preset", "preset": "claude_code"}` для системной подсказки Claude Code с дополнительным `"append"`, или `{"type": "file", "path": "..."}` для загрузки большой подсказки с диска. См. [`SystemPromptPreset`](#systempromptpreset) и [`SystemPromptFile`](#systempromptfile) |911| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptFile \| None` | `None` | Конфигурация системной подсказки. Передайте строку для пользовательской подсказки, `{"type": "preset", "preset": "claude_code"}` для системной подсказки Claude Code с дополнительным `"append"`, или `{"type": "file", "path": "..."}` для загрузки большой подсказки с диска. См. [`SystemPromptPreset`](#systempromptpreset) и [`SystemPromptFile`](#systempromptfile) |


930| `max_buffer_size` | `int \| None` | `None` | Максимальные байты при буферизации stdout CLI |932| `max_buffer_size` | `int \| None` | `None` | Максимальные байты при буферизации stdout CLI |

931| `debug_stderr` | `Any` | `sys.stderr` | *Устарело* - Объект, подобный файлу, для вывода отладки. Вместо этого используйте обратный вызов `stderr` |933| `debug_stderr` | `Any` | `sys.stderr` | *Устарело* - Объект, подобный файлу, для вывода отладки. Вместо этого используйте обратный вызов `stderr` |

932| `stderr` | `Callable[[str], None] \| None` | `None` | Функция обратного вызова для вывода stderr из CLI |934| `stderr` | `Callable[[str], None] \| None` | `None` | Функция обратного вызова для вывода stderr из CLI |

933| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Функция обратного вызова разрешения инструмента, вызываемая только когда [permission flow](/ru/agent-sdk/permissions#how-permissions-are-evaluated) переходит к подсказке. Не вызывается для вызовов, автоматически одобренных `allowed_tools`, правилами разрешения или `permission_mode`. См. [`CanUseTool`](#canusetool) для деталей |935| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Функция обратного вызова разрешения инструмента, вызываемая только когда [permission flow](/ru/agent-sdk/permissions#how-permissions-are-evaluated) переходит к подсказке. Не вызывается для вызовов, автоматически одобренных `allowed_tools`, правилами разрешения или `permission_mode`. `AskUserQuestion`, connector tools [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и MCP tools, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), достигают его даже если вы их разрешили; в режиме `dontAsk` они вместо этого отклоняются. См. [`CanUseTool`](#canusetool) для деталей |

934| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | Конфигурации hooks для перехвата событий |936| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | Конфигурации hooks для перехвата событий |

935| `user` | `str \| None` | `None` | Идентификатор пользователя |937| `user` | `str \| None` | `None` | Идентификатор пользователя |

936| `include_partial_messages` | `bool` | `False` | Включить события потоковой передачи частичных сообщений. Когда включено, выдаются сообщения [`StreamEvent`](#streamevent) |938| `include_partial_messages` | `bool` | `False` | Включить события потоковой передачи частичных сообщений. Когда включено, выдаются сообщения [`StreamEvent`](#streamevent) |


1255 1257 

1256Возвращает `PermissionResult` (либо `PermissionResultAllow`, либо `PermissionResultDeny`).1258Возвращает `PermissionResult` (либо `PermissionResultAllow`, либо `PermissionResultDeny`).

1257 1259 

1258Обратный вызов - это замена SDK для интерактивной подсказки разрешения: он вызывается только когда [permission evaluation flow](/ru/agent-sdk/permissions#how-permissions-are-evaluated) разрешается в подсказку. Вызовы инструментов, уже одобренные записью `allowed_tools`, правилом параметров разрешения или режимом разрешения, таким как `acceptEdits` или `bypassPermissions`, никогда его не вызывают. Чтобы контролировать каждый вызов инструмента, используйте вместо этого [hook `PreToolUse`](/ru/agent-sdk/hooks).1260Обратный вызов - это замена SDK для интерактивной подсказки разрешения: он вызывается только когда [permission evaluation flow](/ru/agent-sdk/permissions#how-permissions-are-evaluated) разрешается в подсказку. Вызовы инструментов, уже одобренные записью `allowed_tools`, правилом параметров разрешения или режимом разрешения, таким как `acceptEdits` или `bypassPermissions`, никогда его не вызывают. `AskUserQuestion`, MCP tools, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), и connector tools [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) достигают обратного вызова даже когда правило разрешения совпадает. В режиме `dontAsk` эти вызовы вместо этого отклоняются, без вызова обратного вызова. Чтобы контролировать каждый вызов инструмента, используйте вместо этого [hook `PreToolUse`](/ru/agent-sdk/hooks).

1259 1261 

1260<h3 id="toolpermissioncontext">1262<h3 id="toolpermissioncontext">

1261 `ToolPermissionContext`1263 `ToolPermissionContext`


1744Словарь `usage` содержит следующие ключи, если они присутствуют:1746Словарь `usage` содержит следующие ключи, если они присутствуют:

1745 1747 

1746| Ключ | Тип | Описание |1748| Ключ | Тип | Описание |

1747| ----------------------------- | ----- | ----------------------------------------------------- |1749| ----------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1748| `input_tokens` | `int` | Всего потреблено входных токенов. |1750| `input_tokens` | `int` | Входные токены, потребленные циклом агента верхнего уровня. [Токены подагента не включены](/ru/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); используйте `model_usage` для учета всего дерева. |

1749| `output_tokens` | `int` | Всего создано выходных токенов. |1751| `output_tokens` | `int` | Выходные токены, созданные циклом агента верхнего уровня. Токены подагента не включены. |

1750| `cache_creation_input_tokens` | `int` | Токены, используемые для создания новых записей кэша. |1752| `cache_creation_input_tokens` | `int` | Токены, используемые для создания новых записей кэша. |

1751| `cache_read_input_tokens` | `int` | Токены, прочитанные из существующих записей кэша. |1753| `cache_read_input_tokens` | `int` | Токены, прочитанные из существующих записей кэша. |

1752 1754 


2688```python theme={null}2690```python theme={null}

2689{2691{

2690 "command": str, # Команда для выполнения2692 "command": str, # Команда для выполнения

2691 "timeout": int | None, # Необязательный тайм-аут в миллисекундах (макс 600000)2693 "timeout": int | None, # Необязательный тайм-аут в миллисекундах (макс 600000; более высокие значения зажимаются до максимума)

2692 "description": str | None, # Четкое, краткое описание (5-10 слов)2694 "description": str | None, # Четкое, краткое описание (5-10 слов)

2693 "run_in_background": bool | None, # Установите значение true для выполнения в фоне2695 "run_in_background": bool | None, # Установите значение true для выполнения в фоне

2694}2696}


3667 Установите `"failIfUnavailable": True` в параметрах sandbox, чтобы остановиться вместо этого. Ключ еще не объявлен на `SandboxSettings`, но SDK передает его в Claude Code, который его соблюдает. `query()` затем сообщает `ResultMessage` с `subtype="error_during_execution"` и причину в `errors`. Следите за этим подтипом, а не ожидайте, что `query()` вызовет исключение перед выдачей сообщений.3669 Установите `"failIfUnavailable": True` в параметрах sandbox, чтобы остановиться вместо этого. Ключ еще не объявлен на `SandboxSettings`, но SDK передает его в Claude Code, который его соблюдает. `query()` затем сообщает `ResultMessage` с `subtype="error_during_execution"` и причину в `errors`. Следите за этим подтипом, а не ожидайте, что `query()` вызовет исключение перед выдачей сообщений.

3668</Note>3670</Note>

3669 3671 

3670<h4 id="example-usage-1">3672<h4 id="example-usage-2">

3671 Пример использования3673 Пример использования

3672</h4>3674</h4>

3673 3675 

Details

368**Режимы разрешений** контролируют, сколько человеческого надзора вы хотите:368**Режимы разрешений** контролируют, сколько человеческого надзора вы хотите:

369 369 

370| Режим | Поведение | Вариант использования |370| Режим | Поведение | Вариант использования |

371| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |371| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------- |

372| `acceptEdits` | Автоматически одобряет редактирование файлов и общие команды файловой системы, запрашивает другие действия | Надёжные рабочие процессы разработки |372| `acceptEdits` | Автоматически одобряет редактирование файлов и общие команды файловой системы, запрашивает другие действия | Надёжные рабочие процессы разработки |

373| `plan` | Запускает инструменты только для чтения; редактирование файлов никогда не одобряется автоматически и достигает вашего обратного вызова `canUseTool` | Определение объёма задачи перед одобрением выполнения |373| `plan` | Запускает инструменты только для чтения; редактирование файлов никогда не одобряется автоматически и достигает вашего обратного вызова `canUseTool` | Определение объёма задачи перед одобрением выполнения |

374| `dontAsk` | Отклоняет всё, что не в `allowedTools` | Заблокированные автономные агенты |374| `dontAsk` | Отклоняет всё, что не в `allowedTools`; инструменты соединителя [ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, отклоняются даже если вы их указали | Заблокированные автономные агенты |

375| `auto` | Классификатор модели одобряет или отклоняет каждый вызов инструмента | Автономные агенты с защитой безопасности |375| `auto` | Классификатор модели одобряет или отклоняет каждый вызов инструмента | Автономные агенты с защитой безопасности |

376| `bypassPermissions` | Запускает каждый инструмент без подсказок, если явное правило [`ask`](/ru/agent-sdk/permissions#how-permissions-are-evaluated) не совпадает | Изолированный CI, полностью доверенные окружения |376| `bypassPermissions` | Запускает каждый инструмент без подсказок, кроме инструментов, соответствующих явному правилу [`ask`](/ru/agent-sdk/permissions#how-permissions-are-evaluated), инструментов соединителя [ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструментов, требующих взаимодействия с пользователем | Изолированный CI, полностью доверенные окружения |

377| `default` | Требует обратного вызова `canUseTool` для обработки одобрения | Пользовательские потоки одобрения |377| `default` | Требует обратного вызова `canUseTool` для обработки одобрения | Пользовательские потоки одобрения |

378 378 

379Приведённый выше пример использует режим `acceptEdits`, который автоматически одобряет файловые операции, чтобы агент мог работать без интерактивных подсказок. Если вы хотите запрашивать у пользователей одобрение, используйте режим `default` и предоставьте обратный вызов [`canUseTool`](/ru/agent-sdk/user-input), который собирает пользовательский ввод. Для большего контроля см. [Разрешения](/ru/agent-sdk/permissions).379Приведённый выше пример использует режим `acceptEdits`, который автоматически одобряет файловые операции, чтобы агент мог работать без интерактивных подсказок. Если вы хотите запрашивать у пользователей одобрение, используйте режим `default` и предоставьте обратный вызов [`canUseTool`](/ru/agent-sdk/user-input), который собирает пользовательский ввод. Для большего контроля см. [Разрешения](/ru/agent-sdk/permissions).

Details

224 224 

225Окно контекста подагента начинается свежим (без истории родительской беседы), но не пусто. Единственный канал от родителя к подагенту — это строка промпта инструмента Agent, поэтому включайте любые пути файлов, сообщения об ошибках или решения, которые нужны подагенту, непосредственно в этот промпт.225Окно контекста подагента начинается свежим (без истории родительской беседы), но не пусто. Единственный канал от родителя к подагенту — это строка промпта инструмента Agent, поэтому включайте любые пути файлов, сообщения об ошибках или решения, которые нужны подагенту, непосредственно в этот промпт.

226 226 

227{/* min-version: 2.1.206 */}Подагент, у которого есть инструмент [`SendMessage`](/ru/tools-reference), начинает с списка других именованных агентов, работающих в сеансе, поэтому он знает, каким именам он может отправлять сообщения. Claude Code автоматически добавляет список в первый ход подагента. [Ветвление](/ru/sub-agents#fork-the-current-conversation) не получает список, потому что оно наследует родительскую беседу вместо этого. Список требует Claude Code v2.1.206 или более поздней версии.

228 

227| Подагент получает | Подагент не получает |229| Подагент получает | Подагент не получает |

228| :------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------- |230| :------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------- |

229| Его собственный системный промпт (`AgentDefinition.prompt`) и промпт инструмента Agent | История беседы родителя или результаты инструментов |231| Его собственный системный промпт (`AgentDefinition.prompt`) и промпт инструмента Agent | История беседы родителя или результаты инструментов |


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

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

583 585 

584<h2 id="tool-restrictions-1">586<h2 id="tool-restrictions-2">

585 Ограничения инструментов587 Ограничения инструментов

586</h2>588</h2>

587 589 

Details

100}): Promise<WarmQuery>;100}): Promise<WarmQuery>;

101```101```

102 102 

103<h4 id="parameters-1">103<h4 id="parameters-2">

104 Параметры104 Параметры

105</h4>105</h4>

106 106 


109| `options` | [`Options`](#options) | Опциональный объект конфигурации. Аналогичен параметру `options` функции `query()` |109| `options` | [`Options`](#options) | Опциональный объект конфигурации. Аналогичен параметру `options` функции `query()` |

110| `initializeTimeoutMs` | `number` | Максимальное время в миллисекундах для ожидания инициализации подпроцесса. По умолчанию `60000`. Если инициализация не завершится вовремя, промис отклонится с ошибкой timeout |110| `initializeTimeoutMs` | `number` | Максимальное время в миллисекундах для ожидания инициализации подпроцесса. По умолчанию `60000`. Если инициализация не завершится вовремя, промис отклонится с ошибкой timeout |

111 111 

112<h4 id="returns-1">112<h4 id="returns-2">

113 Возвращаемое значение113 Возвращаемое значение

114</h4>114</h4>

115 115 


149): SdkMcpToolDefinition<Schema>;149): SdkMcpToolDefinition<Schema>;

150```150```

151 151 

152<h4 id="parameters-2">152<h4 id="parameters-3">

153 Параметры153 Параметры

154</h4>154</h4>

155 155 


204}): McpSdkServerConfigWithInstance;204}): McpSdkServerConfigWithInstance;

205```205```

206 206 

207<h4 id="parameters-3">207<h4 id="parameters-4">

208 Параметры208 Параметры

209</h4>209</h4>

210 210 


224function listSessions(options?: ListSessionsOptions): Promise<SDKSessionInfo[]>;224function listSessions(options?: ListSessionsOptions): Promise<SDKSessionInfo[]>;

225```225```

226 226 

227<h4 id="parameters-4">227<h4 id="parameters-5">

228 Параметры228 Параметры

229</h4>229</h4>

230 230 


251| `tag` | `string \| undefined` | Пользовательский тег сессии (см. [`tagSession()`](#tagsession)) |251| `tag` | `string \| undefined` | Пользовательский тег сессии (см. [`tagSession()`](#tagsession)) |

252| `createdAt` | `number \| undefined` | Время создания в миллисекундах с эпохи, из временной метки первой записи |252| `createdAt` | `number \| undefined` | Время создания в миллисекундах с эпохи, из временной метки первой записи |

253 253 

254<h4 id="example-1">254<h4 id="example-2">

255 Пример255 Пример

256</h4>256</h4>

257 257 


280): Promise<SessionMessage[]>;280): Promise<SessionMessage[]>;

281```281```

282 282 

283<h4 id="parameters-5">283<h4 id="parameters-6">

284 Параметры284 Параметры

285</h4>285</h4>

286 286 


304| `parent_tool_use_id` | `string \| null` | Для сообщений подагента, `tool_use_id` вызова tool `Agent`, который его запустил. `null` для сообщений основной сессии и более старых сессий |304| `parent_tool_use_id` | `string \| null` | Для сообщений подагента, `tool_use_id` вызова tool `Agent`, который его запустил. `null` для сообщений основной сессии и более старых сессий |

305| `parent_agent_id` | `string \| null` | Для сообщений от [вложенного подагента](/ru/sub-agents#spawn-nested-subagents), `agentId` подагента, который его запустил. `null` для сообщений основной сессии, сообщений от подагентов верхнего уровня и более старых сессий. {/* min-version: 2.1.202 */}Требуется Claude Code v2.1.202 или позже |305| `parent_agent_id` | `string \| null` | Для сообщений от [вложенного подагента](/ru/sub-agents#spawn-nested-subagents), `agentId` подагента, который его запустил. `null` для сообщений основной сессии, сообщений от подагентов верхнего уровня и более старых сессий. {/* min-version: 2.1.202 */}Требуется Claude Code v2.1.202 или позже |

306 306 

307<h4 id="example-2">307<h4 id="example-3">

308 Пример308 Пример

309</h4>309</h4>

310 310 


338): Promise<SDKSessionInfo | undefined>;338): Promise<SDKSessionInfo | undefined>;

339```339```

340 340 

341<h4 id="parameters-6">341<h4 id="parameters-7">

342 Параметры342 Параметры

343</h4>343</h4>

344 344 


363): Promise<void>;363): Promise<void>;

364```364```

365 365 

366<h4 id="parameters-7">366<h4 id="parameters-8">

367 Параметры367 Параметры

368</h4>368</h4>

369 369 


387): Promise<void>;387): Promise<void>;

388```388```

389 389 

390<h4 id="parameters-8">390<h4 id="parameters-9">

391 Параметры391 Параметры

392</h4>392</h4>

393 393 


413): Promise<ResolvedSettings>;413): Promise<ResolvedSettings>;

414```414```

415 415 

416<h4 id="parameters-9">416<h4 id="parameters-10">

417 Параметры417 Параметры

418</h4>418</h4>

419 419 


438| `provenance` | `Partial<Record<keyof Settings, ProvenanceEntry>>` | Для каждого ключа верхнего уровня в `effective`, какой источник предоставил значение |438| `provenance` | `Partial<Record<keyof Settings, ProvenanceEntry>>` | Для каждого ключа верхнего уровня в `effective`, какой источник предоставил значение |

439| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | Необработанные параметры для каждого источника, упорядоченные от самого низкого к самому высокому приоритету |439| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | Необработанные параметры для каждого источника, упорядоченные от самого низкого к самому высокому приоритету |

440 440 

441<h4 id="example-3">441<h4 id="example-4">

442 Пример442 Пример

443</h4>443</h4>

444 444 


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

468 468 

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

470| :-------------------------------- | :------------------------------------------------------------------------------------------------------- | :------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |470| :-------------------------------- | :------------------------------------------------------------------------------------------------------- | :------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

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

472| `additionalDirectories` | `string[]` | `[]` | Дополнительные директории, к которым Claude может получить доступ |472| `additionalDirectories` | `string[]` | `[]` | Дополнительные директории, к которым Claude может получить доступ |

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


476| `allowDangerouslySkipPermissions` | `boolean` | `false` | Включите обход разрешений. Требуется при использовании `permissionMode: 'bypassPermissions'` |476| `allowDangerouslySkipPermissions` | `boolean` | `false` | Включите обход разрешений. Требуется при использовании `permissionMode: 'bypassPermissions'` |

477| `allowedTools` | `string[]` | `[]` | Инструменты для автоматического одобрения без запроса. Это не ограничивает Claude только этими инструментами; неперечисленные инструменты переходят к `permissionMode` и `canUseTool`. Используйте `disallowedTools` для блокировки инструментов. См. [Разрешения](/ru/agent-sdk/permissions#allow-and-deny-rules) |477| `allowedTools` | `string[]` | `[]` | Инструменты для автоматического одобрения без запроса. Это не ограничивает Claude только этими инструментами; неперечисленные инструменты переходят к `permissionMode` и `canUseTool`. Используйте `disallowedTools` для блокировки инструментов. См. [Разрешения](/ru/agent-sdk/permissions#allow-and-deny-rules) |

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

479| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | Пользовательская функция разрешения, вызываемая только когда [поток разрешения](/ru/agent-sdk/permissions#how-permissions-are-evaluated) переходит к запросу. Не вызывается для вызовов, автоматически одобренных `allowedTools`, правилами разрешения или `permissionMode`. См. [`CanUseTool`](#canusetool) для деталей |479| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | Пользовательская функция разрешения, вызываемая только когда [поток разрешения](/ru/agent-sdk/permissions#how-permissions-are-evaluated) переходит к запросу. Не вызывается для вызовов, автоматически одобренных `allowedTools`, правилами разрешения или `permissionMode`. `AskUserQuestion`, инструменты соединителя [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), достигают её даже если вы их разрешили; в режиме `dontAsk` они вместо этого отклоняются. См. [`CanUseTool`](#canusetool) для деталей |

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

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

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


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

493| `forwardSubagentText` | `boolean` | `false` | Пересылайте текст подагента и блоки мышления как сообщения ассистента и пользователя с установленным `parent_tool_use_id`, чтобы потребители могли отобразить вложенный транскрипт. По умолчанию только блоки `tool_use` и `tool_result` от подагентов выдаются |493| `forwardSubagentText` | `boolean` | `false` | Пересылайте текст подагента и блоки мышления как сообщения ассистента и пользователя с установленным `parent_tool_use_id`, чтобы потребители могли отобразить вложенный транскрипт. По умолчанию только блоки `tool_use` и `tool_result` от подагентов выдаются |

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

495| `includeHookEvents` | `boolean` | `false` | Включите события жизненного цикла hooks в поток сообщений как [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage) и [`SDKHookResponseMessage`](#sdkhookresponsemessage) |495| `includeHookEvents` | `boolean` | `false` | Включите события жизненного цикла hooks для каждого события hooks в поток сообщений как [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage) и [`SDKHookResponseMessage`](#sdkhookresponsemessage). События жизненного цикла для hooks `SessionStart` и `Setup` всегда включены и не требуют этой опции |

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

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

498| `managedSettings` | `Settings` | `undefined` | Настройки уровня политики, предоставленные порождающим родительским процессом. Отбрасываются, когда уровень управляемых настроек, контролируемый IT, уже существует на машине, если только этот администратор не согласится с `parentSettingsBehavior: 'merge'`. Отфильтрованы только для ключей, ограничивающих доступ, независимо |498| `managedSettings` | `Settings` | `undefined` | Настройки уровня политики, предоставленные порождающим родительским процессом. Отбрасываются, когда уровень управляемых настроек, контролируемый IT, уже существует на машине, если только этот администратор не согласится с `parentSettingsBehavior: 'merge'`. Отфильтрованы только для ключей, ограничивающих доступ, независимо |


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

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

601| `setModel()` | Изменяет модель (доступно только в режиме потока входных данных) |601| `setModel()` | Изменяет модель (доступно только в режиме потока входных данных) |

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

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

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

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


623 623 

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

625 625 

626* **Применяется на следующем ходу**: `model`, `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `awaySummaryEnabled`, `agent`. Переключение `agent` также применяет переопределение модели этого агента, hooks и системный запрос на следующем ходу.626* **Применяется на следующем ходу**: `model`, `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `agent`. Переключение `agent` также применяет переопределение модели этого агента, hooks и системный запрос на следующем ходу.

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

628 628 

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


663}663}

664```664```

665 665 

666<h4 id="methods-1">666<h4 id="methods-2">

667 Methods667 Methods

668</h4>668</h4>

669 669 


915 915 

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

917 917 

918`AskUserQuestion`, инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool) и инструменты соединителя [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) достигают функции даже когда правило разрешения совпадает. В режиме `dontAsk` эти вызовы вместо этого отклоняются, без вызова её.

919 

918```typescript theme={null}920```typescript theme={null}

919type CanUseTool = (921type CanUseTool = (

920 toolName: string,922 toolName: string,


1123 | SDKTaskProgressMessage1125 | SDKTaskProgressMessage

1124 | SDKTaskUpdatedMessage1126 | SDKTaskUpdatedMessage

1125 | SDKBackgroundTasksChangedMessage1127 | SDKBackgroundTasksChangedMessage

1128 | SDKThinkingTokensMessage

1126 | SDKSessionStateChangedMessage1129 | SDKSessionStateChangedMessage

1127 | SDKWorkerShuttingDownMessage1130 | SDKWorkerShuttingDownMessage

1128 | SDKCommandsChangedMessage1131 | SDKCommandsChangedMessage


1183 1186 

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

1185 1188 

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

1190 

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

1192 

1186<h3 id="sdkusermessagereplay">1193<h3 id="sdkusermessagereplay">

1187 `SDKUserMessageReplay`1194 `SDKUserMessageReplay`

1188</h3>1195</h3>


1203};1210};

1204```1211```

1205 1212 

1213Пользовательский ход, внедрённый извне сеанса, один, чьё [`origin`](#sdkmessageorigin) имеет вид `peer` или `channel`, достигает потока как повтор, был ли он доставлен во время активного хода или запустил новый ход, пока сеанс был неактивен. {/* min-version: 2.1.207 */}До v2.1.207 внедрённый ход, доставленный, пока сеанс был неактивен, не производил никакого сообщения в потоке и появлялся только при повторном чтении транскрипта.

1214 

1206<h3 id="sdkresultmessage">1215<h3 id="sdkresultmessage">

1207 `SDKResultMessage`1216 `SDKResultMessage`

1208</h3>1217</h3>


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

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

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

1268* `terminal_reason`: почему цикл завершился. Один из `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"` или `"model_error"`.1277* `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"`.

1269* `fast_mode_state`: один из `"on"`, `"off"` или `"cooldown"`.1278* `fast_mode_state`: один из `"on"`, `"off"` или `"cooldown"`.

1270 1279 

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


2034type AgentInput = {2043type AgentInput = {

2035 description: string;2044 description: string;

2036 prompt: string;2045 prompt: string;

2037 subagent_type: string;2046 subagent_type?: string;

2038 model?: "sonnet" | "opus" | "haiku" | "fable";2047 model?: "sonnet" | "opus" | "haiku" | "fable";

2039 resume?: string;

2040 run_in_background?: boolean;2048 run_in_background?: boolean;

2041 max_turns?: number;

2042 name?: string;2049 name?: string;

2043 mode?: "acceptEdits" | "bypassPermissions" | "default" | "dontAsk" | "plan";2050 mode?: "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan";

2044 isolation?: "worktree";2051 isolation?: "worktree";

2045};2052};

2046```2053```


2075```typescript theme={null}2082```typescript theme={null}

2076type BashInput = {2083type BashInput = {

2077 command: string;2084 command: string;

2078 timeout?: number;2085 timeout?: number; // milliseconds, max 600000; higher values are clamped to the max

2079 description?: string;2086 description?: string;

2080 run_in_background?: boolean;2087 run_in_background?: boolean;

2081 dangerouslyDisableSandbox?: boolean;2088 dangerouslyDisableSandbox?: boolean;


2492 | WorkflowOutput;2499 | WorkflowOutput;

2493```2500```

2494 2501 

2495<h3 id="agent-1">2502<h3 id="agent-2">

2496 Agent2503 Agent

2497</h3>2504</h3>

2498 2505 


2503 | {2510 | {

2504 status: "completed";2511 status: "completed";

2505 agentId: string;2512 agentId: string;

2506 content: Array<{ type: "text"; text: string }>;2513 agentType?: string;

2514 content: Array<{ type: "text"; text: string; citations?: unknown[] | null }>;

2507 resolvedModel?: string;2515 resolvedModel?: string;

2508 totalToolUseCount: number;2516 totalToolUseCount: number;

2509 totalDurationMs: number;2517 totalDurationMs: number;


2517 web_search_requests: number;2525 web_search_requests: number;

2518 web_fetch_requests: number;2526 web_fetch_requests: number;

2519 } | null;2527 } | null;

2520 service_tier: ("standard" | "priority" | "batch") | null;2528 service_tier: string | null;

2521 cache_creation: {2529 cache_creation: {

2522 ephemeral_1h_input_tokens: number;2530 ephemeral_1h_input_tokens: number;

2523 ephemeral_5m_input_tokens: number;2531 ephemeral_5m_input_tokens: number;

2524 } | null;2532 } | null;

2533 inference_geo?: string | null;

2534 speed?: string | null;

2535 iterations?: unknown;

2536 };

2537 toolStats?: {

2538 readCount: number;

2539 searchCount: number;

2540 bashCount: number;

2541 editFileCount: number;

2542 linesAdded: number;

2543 linesRemoved: number;

2544 otherToolCount: number;

2545 frameCount?: number;

2525 };2546 };

2526 prompt: string;2547 prompt: string;

2548 worktreePath?: string;

2549 worktreeBranch?: string;

2527 }2550 }

2528 | {2551 | {

2529 status: "async_launched";2552 status: "async_launched";

2553 isAsync?: true;

2530 agentId: string;2554 agentId: string;

2531 description: string;2555 description: string;

2532 resolvedModel?: string;2556 resolvedModel?: string;


2535 canReadOutputFile?: boolean;2559 canReadOutputFile?: boolean;

2536 }2560 }

2537 | {2561 | {

2538 status: "sub_agent_entered";2562 status: "remote_launched";

2563 taskId: string;

2564 sessionUrl: string;

2539 description: string;2565 description: string;

2540 message: string;2566 prompt: string;

2567 outputFile: string;

2541 };2568 };

2542```2569```

2543 2570 

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

2545 2572 

2546Поле `resolvedModel` на вариантах `completed` и `async_launched` указывает модель, на которой фактически работал подагент, которая может отличаться от запрошенного входного параметра `model` когда применяется [`availableModels`](/ru/model-config#restrict-model-selection) или другое переопределение. {/* min-version: 2.1.174 */}Это поле требует Claude Code v2.1.174 или позже.2573Поле `resolvedModel` на вариантах `completed` и `async_launched` указывает модель, на которой фактически работал подагент, которая может отличаться от запрошенного входного параметра `model` когда применяется [`availableModels`](/ru/model-config#restrict-model-selection) или другое переопределение. {/* min-version: 2.1.174 */}Это поле требует Claude Code v2.1.174 или позже.

2547 2574 

2548<h3 id="askuserquestion-1">2575На варианте `completed` `worktreePath` устанавливается, когда подагент работал в изолированном git worktree, и `worktreeBranch` называет ветку этого worktree, когда Claude Code её создал. `usage.service_tier` содержит строку уровня обслуживания, которую API сообщила для запросов подагента.

2576 

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

2578 

2579<h3 id="askuserquestion-2">

2549 AskUserQuestion2580 AskUserQuestion

2550</h3>2581</h3>

2551 2582 


2566 2597 

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

2568 2599 

2569<h3 id="bash-1">2600<h3 id="bash-2">

2570 Bash2601 Bash

2571</h3>2602</h3>

2572 2603 


2591 2622 

2592Возвращает вывод команды с разделённым stdout/stderr. Фоновые команды включают `backgroundTaskId`.2623Возвращает вывод команды с разделённым stdout/stderr. Фоновые команды включают `backgroundTaskId`.

2593 2624 

2594<h3 id="monitor-1">2625<h3 id="monitor-2">

2595 Monitor2626 Monitor

2596</h3>2627</h3>

2597 2628 


2607 2638 

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

2609 2640 

2610<h3 id="edit-1">2641<h3 id="edit-2">

2611 Edit2642 Edit

2612</h3>2643</h3>

2613 2644 


2641 2672 

2642Возвращает структурированный diff операции редактирования.2673Возвращает структурированный diff операции редактирования.

2643 2674 

2644<h3 id="read-1">2675<h3 id="read-2">

2645 Read2676 Read

2646</h3>2677</h3>

2647 2678 


2701 2732 

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

2703 2734 

2704<h3 id="write-1">2735<h3 id="write-2">

2705 Write2736 Write

2706</h3>2737</h3>

2707 2738 


2733 2764 

2734Возвращает результат записи с информацией структурированного diff.2765Возвращает результат записи с информацией структурированного diff.

2735 2766 

2736<h3 id="glob-1">2767<h3 id="glob-2">

2737 Glob2768 Glob

2738</h3>2769</h3>

2739 2770 


2750 2781 

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

2752 2783 

2753<h3 id="grep-1">2784<h3 id="grep-2">

2754 Grep2785 Grep

2755</h3>2786</h3>

2756 2787 


2771 2802 

2772Возвращает результаты поиска. Форма варьируется по `mode`: список файлов, содержимое с совпадениями или количество совпадений.2803Возвращает результаты поиска. Форма варьируется по `mode`: список файлов, содержимое с совпадениями или количество совпадений.

2773 2804 

2774<h3 id="taskstop-1">2805<h3 id="taskstop-2">

2775 TaskStop2806 TaskStop

2776</h3>2807</h3>

2777 2808 


2788 2819 

2789Возвращает подтверждение после остановки фоновой задачи.2820Возвращает подтверждение после остановки фоновой задачи.

2790 2821 

2791<h3 id="notebookedit-1">2822<h3 id="notebookedit-2">

2792 NotebookEdit2823 NotebookEdit

2793</h3>2824</h3>

2794 2825 


2810 2841 

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

2812 2843 

2813<h3 id="webfetch-1">2844<h3 id="webfetch-2">

2814 WebFetch2845 WebFetch

2815</h3>2846</h3>

2816 2847 


2829 2860 

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

2831 2862 

2832<h3 id="websearch-1">2863<h3 id="websearch-2">

2833 WebSearch2864 WebSearch

2834</h3>2865</h3>

2835 2866 


2851 2882 

2852Возвращает результаты поиска из веб.2883Возвращает результаты поиска из веб.

2853 2884 

2854<h3 id="workflow-1">2885<h3 id="workflow-2">

2855 Workflow2886 Workflow

2856</h3>2887</h3>

2857 2888 


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

2882| `error` | `string` | Устанавливается, когда скрипт не прошёл проверку синтаксиса. Если присутствует, запуск не начался несмотря на статус `async_launched` |2913| `error` | `string` | Устанавливается, когда скрипт не прошёл проверку синтаксиса. Если присутствует, запуск не начался несмотря на статус `async_launched` |

2883 2914 

2884<h3 id="todowrite-1">2915<h3 id="todowrite-2">

2885 TodoWrite2916 TodoWrite

2886</h3>2917</h3>

2887 2918 


2908 Начиная с TypeScript Agent SDK 0.3.142, `TodoWrite` отключён по умолчанию. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. Смотрите [Миграция на Task tools](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для обновления кода мониторинга, или установите `CLAUDE_CODE_ENABLE_TASKS=0` для возврата к `TodoWrite`.2939 Начиная с TypeScript Agent SDK 0.3.142, `TodoWrite` отключён по умолчанию. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. Смотрите [Миграция на Task tools](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для обновления кода мониторинга, или установите `CLAUDE_CODE_ENABLE_TASKS=0` для возврата к `TodoWrite`.

2909</Note>2940</Note>

2910 2941 

2911<h3 id="taskcreate-1">2942<h3 id="taskcreate-2">

2912 TaskCreate2943 TaskCreate

2913</h3>2944</h3>

2914 2945 


2925 2956 

2926Возвращает созданную задачу с назначенным ей ID.2957Возвращает созданную задачу с назначенным ей ID.

2927 2958 

2928<h3 id="taskupdate-1">2959<h3 id="taskupdate-2">

2929 TaskUpdate2960 TaskUpdate

2930</h3>2961</h3>

2931 2962 


2946 2977 

2947Возвращает результат обновления, включая какие поля изменились.2978Возвращает результат обновления, включая какие поля изменились.

2948 2979 

2949<h3 id="taskget-1">2980<h3 id="taskget-2">

2950 TaskGet2981 TaskGet

2951</h3>2982</h3>

2952 2983 


2967 2998 

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

2969 3000 

2970<h3 id="tasklist-1">3001<h3 id="tasklist-2">

2971 TaskList3002 TaskList

2972</h3>3003</h3>

2973 3004 


2987 3018 

2988Возвращает снимок всех задач в текущем списке.3019Возвращает снимок всех задач в текущем списке.

2989 3020 

2990<h3 id="exitplanmode-1">3021<h3 id="exitplanmode-2">

2991 ExitPlanMode3022 ExitPlanMode

2992</h3>3023</h3>

2993 3024 


3006 3037 

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

3008 3039 

3009<h3 id="listmcpresources-1">3040<h3 id="listmcpresources-2">

3010 ListMcpResources3041 ListMcpResources

3011</h3>3042</h3>

3012 3043 


3024 3055 

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

3026 3057 

3027<h3 id="readmcpresource-1">3058<h3 id="readmcpresource-2">

3028 ReadMcpResource3059 ReadMcpResource

3029</h3>3060</h3>

3030 3061 


3042 3073 

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

3044 3075 

3045<h3 id="enterworktree-1">3076<h3 id="enterworktree-2">

3046 EnterWorktree3077 EnterWorktree

3047</h3>3078</h3>

3048 3079 


3538 3569 

3539Выдаётся, когда hook начинает выполняться.3570Выдаётся, когда hook начинает выполняться.

3540 3571 

3572Claude Code доставляет это сообщение, [`SDKHookProgressMessage`](#sdkhookprogressmessage) и [`SDKHookResponseMessage`](#sdkhookresponsemessage) в поток сообщений немедленно, включая во время выполнения hook `SessionStart` или `Setup` во время запуска сессии. Claude Code v2.1.169 через v2.1.203 доставляли эти сообщения в одном пакете после завершения hook `SessionStart` или `Setup`; v2.1.204 восстановил живую доставку.

3573 

3541```typescript theme={null}3574```typescript theme={null}

3542type SDKHookStartedMessage = {3575type SDKHookStartedMessage = {

3543 type: "system";3576 type: "system";


3725};3758};

3726```3759```

3727 3760 

3761<h3 id="sdkthinkingtokensmessage">

3762 `SDKThinkingTokensMessage`

3763</h3>

3764 

3765Выдаётся во время создания Claude блока мышления, включая отредактированный, с текущей оценкой токенов мышления, созданных до сих пор. `estimated_tokens` это текущий итог для текущего блока мышления и `estimated_tokens_delta` это приращение, переносимое этим кадром. Используйте его для отображения прогресса. Окончательный подсчёт для цикла агента верхнего уровня это `usage.output_tokens` сообщения результата, который [не включает токены подагентов](/ru/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); используйте [`modelUsage`](#modelusage) для учёта всего дерева.

3766 

3767{/* min-version: 2.1.153 */}Требуется Claude Code v2.1.153 или позже.

3768 

3769```typescript theme={null}

3770type SDKThinkingTokensMessage = {

3771 type: "system";

3772 subtype: "thinking_tokens";

3773 estimated_tokens: number;

3774 estimated_tokens_delta: number;

3775 uuid: UUID;

3776 session_id: string;

3777};

3778```

3779 

3728<h3 id="sdkfilespersistedevent">3780<h3 id="sdkfilespersistedevent">

3729 `SDKFilesPersistedEvent`3781 `SDKFilesPersistedEvent`

3730</h3>3782</h3>


3976 Fallback разрешений для команд вне Sandbox4028 Fallback разрешений для команд вне Sandbox

3977</h3>4029</h3>

3978 4030 

3979Когда `allowUnsandboxedCommands` включён, модель может запросить выполнение команд вне sandbox, установив `dangerouslyDisableSandbox: true` во входных данных tool. Эти запросы переходят к существующей системе разрешений, что означает, что ваш обработчик `canUseTool` вызывается, позволяя вам реализовать пользовательскую логику авторизации.4031Когда `allowUnsandboxedCommands` включён, модель может запросить выполнение команд вне sandbox, установив `dangerouslyDisableSandbox: true` во входных данных tool. Эти запросы переходят к существующей системе разрешений, что означает, что ваш обработчик `canUseTool` вызывается, позволяя вам реализовать пользовательскую логику авторизации. В примере ниже `isCommandAuthorized` служит заместителем для проверки авторизации, которую вы определяете.

3980 4032 

3981<Note>4033<Note>

3982 **`excludedCommands` vs `allowUnsandboxedCommands`:**4034 **`excludedCommands` vs `allowUnsandboxedCommands`:**

Details

49 49 

50<Warning>50<Warning>

51 **Callback никогда не срабатывает для автоматически одобренных инструментов.** Любое одобрение на более ранних этапах [потока оценки разрешений](/ru/agent-sdk/permissions#how-permissions-are-evaluated), правило разрешения или режим, такой как `acceptEdits` или `bypassPermissions`, разрешает вызов до того, как будет проверен `canUseTool`. Если вы указываете инструмент в `allowed_tools`, проверка `canUseTool` для этого инструмента никогда не выполняется, если только правило ask или режим `plan` не перенаправляют вызов обратно в prompt. Для логики, которая должна применяться к каждому вызову инструмента, используйте [`PreToolUse` hook](/ru/agent-sdk/hooks), который выполняется перед остальной частью потока и может разрешить, отклонить или изменить запросы.51 **Callback никогда не срабатывает для автоматически одобренных инструментов.** Любое одобрение на более ранних этапах [потока оценки разрешений](/ru/agent-sdk/permissions#how-permissions-are-evaluated), правило разрешения или режим, такой как `acceptEdits` или `bypassPermissions`, разрешает вызов до того, как будет проверен `canUseTool`. Если вы указываете инструмент в `allowed_tools`, проверка `canUseTool` для этого инструмента никогда не выполняется, если только правило ask или режим `plan` не перенаправляют вызов обратно в prompt. Для логики, которая должна применяться к каждому вызову инструмента, используйте [`PreToolUse` hook](/ru/agent-sdk/hooks), который выполняется перед остальной частью потока и может разрешить, отклонить или изменить запросы.

52 

53 `AskUserQuestion`, инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), и инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) достигают callback даже когда правило разрешения совпадает. В режиме `dontAsk` эти вызовы вместо этого отклоняются без вызова callback.

52</Warning>54</Warning>

53 55 

54Вы также можете использовать [`PermissionRequest` hook](/ru/agent-sdk/hooks#available-hooks) для отправки внешних уведомлений (Slack, email, push) когда Claude ждёт одобрения.56Вы также можете использовать [`PermissionRequest` hook](/ru/agent-sdk/hooks#available-hooks) для отправки внешних уведомлений (Slack, email, push) когда Claude ждёт одобрения.


214| **Разрешить** | `PermissionResultAllow(updated_input=...)` | `{ behavior: "allow", updatedInput }` |216| **Разрешить** | `PermissionResultAllow(updated_input=...)` | `{ behavior: "allow", updatedInput }` |

215| **Отклонить** | `PermissionResultDeny(message=...)` | `{ behavior: "deny", message }` |217| **Отклонить** | `PermissionResultDeny(message=...)` | `{ behavior: "deny", message }` |

216 218 

217При разрешении передайте ввод инструмента (исходный или изменённый). При отклонении предоставьте сообщение, объясняющее причину. Claude видит это сообщение и может скорректировать свой подход.219При разрешении инструмент выполняется с вводом, который запросил Claude, если вы не вернёте изменённый ввод, `updatedInput` в TypeScript или `updated_input` в Python. {/* min-version: 2.1.207 */}До версии 2.1.207 Claude Code отклонял результат разрешения, который опускал `updatedInput`, и отклонял вызов инструмента с ошибкой валидации.

220 

221При отклонении предоставьте сообщение, объясняющее причину. Claude видит это сообщение и может скорректировать свой подход.

218 222 

219<CodeGroup>223<CodeGroup>

220 ```python Python theme={null}224 ```python Python theme={null}

agent-teams.md +5 −1

Details

249 249 

250См. [Выбор режима отображения](#choose-a-display-mode) для параметров конфигурации отображения. Сообщения товарищей по команде поступают лидеру автоматически.250См. [Выбор режима отображения](#choose-a-display-mode) для параметров конфигурации отображения. Сообщения товарищей по команде поступают лидеру автоматически.

251 251 

252Почтовый ящик каждого агента — это JSON-файл в `~/.claude/teams/{team-name}/inboxes/{agent-name}.json`. Claude Code проверяет каждую запись при чтении файла почтового ящика. Записи, которые не соответствуют формату сообщения, сообщаются как ошибки и удаляются из файла; действительные сообщения все еще доставляются. До версии 2.1.207 одна неправильно сформированная запись почтового ящика вызывала повторяющуюся ошибку каждую секунду и блокировала доставку для этого почтового ящика, пока вы не удалили файл вручную.

253 

252Система автоматически управляет зависимостями задач. Когда товарищ по команде завершает задачу, от которой зависят другие задачи, заблокированные задачи разблокируются без ручного вмешательства.254Система автоматически управляет зависимостями задач. Когда товарищ по команде завершает задачу, от которой зависят другие задачи, заблокированные задачи разблокируются без ручного вмешательства.

253 255 

254Команды и задачи хранятся локально под именем, производным от сеанса. Имя — это `session-` с последующими первыми восемью символами ID сеанса:256Команды и задачи хранятся локально под именем, производным от сеанса. Имя — это `session-` с последующими первыми восемью символами ID сеанса:


290 292 

291Товарищи по команде начинают с параметров разрешений лидера. Если лидер работает с `--dangerously-skip-permissions`, все товарищи по команде тоже. После порождения вы можете изменить отдельные режимы товарищей по команде, но вы не можете установить режимы для отдельных товарищей по команде во время порождения.293Товарищи по команде начинают с параметров разрешений лидера. Если лидер работает с `--dangerously-skip-permissions`, все товарищи по команде тоже. После порождения вы можете изменить отдельные режимы товарищей по команде, но вы не можете установить режимы для отдельных товарищей по команде во время порождения.

292 294 

293Когда один агент отправляет другому сообщение через `SendMessage`, получающему агенту сообщается, что оно пришло от другого сеанса Claude, а не от вас. Товарищ по команде не может одобрить запрос разрешения или дать согласие от вашего имени, и товарищ по команде, которому было отказано в действии, не может передать его другому товарищу по команде, чтобы обойти проверку. В [автоматическом режиме](/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатор рассматривает утверждение об одобрении, переданное от другого агента, как недоверенный ввод, а не подтверждение от вас. Запросы разрешений товарищей по команде всплывают в основной сеанс, поэтому одобрите их там сами.295Когда один агент отправляет другому сообщение через `SendMessage`, получающему агенту сообщается, что оно пришло от другого сеанса Claude, а не от вас. Товарищ по команде не может одобрить запрос разрешения или дать согласие от вашего имени, и товарищ по команде, которому было отказано в действии, не может передать его другому товарищу по команде, чтобы обойти проверку. В [автоматическом режиме](/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатор рассматривает утверждение об одобрении, переданное от другого агента, как недоверенный ввод, а не подтверждение от вас.

296 

297Запросы разрешений товарищей по команде появляются в основном сеансе, поэтому одобрите их там сами. [Требование одобрения плана](#require-plan-approval-for-teammates) — это предусмотренное исключение: основной сеанс предоставляет одобрения плана товарищей по команде без отдельного запроса к вам.

294 298 

295<h3 id="context-and-communication">299<h3 id="context-and-communication">

296 Контекст и коммуникация300 Контекст и коммуникация

agent-view.md +57 −13

Details

70 70 

71Вы можете использовать `claude agents` как основную точку входа вместо `claude`: отправляйте каждую задачу из agent view, подключайтесь, когда вам нужна полная беседа, и нажимайте `←` для возврата к таблице.71Вы можете использовать `claude agents` как основную точку входа вместо `claude`: отправляйте каждую задачу из agent view, подключайтесь, когда вам нужна полная беседа, и нажимайте `←` для возврата к таблице.

72 72 

73{/* min-version: 2.1.205 */}Внутри обычного сеанса `claude` подсказка в нижнем колонтитуле `←` показывает количество фоновых агентов, которые ждут вас, например `← 2 agents`, и возвращается к `← for agents`, когда никто не требует ввода. Количество выше 99 отображается как `99+`. Количество обновляется примерно каждые десять секунд, пока терминал в фокусе, и немедленно, когда фокус возвращается. Оно кратко меняет цвет при изменении и при завершении агента, если только параметр [`prefersReducedMotion`](/ru/settings#available-settings) не включен, и оно скрыто в [режиме чтения с экрана](/ru/accessibility). На [Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry](/ru/third-party-integrations) подсказка остаётся в простой форме `← for agents` без количества. Требуется Claude Code v2.1.205 или позже.

74 

73<h2 id="monitor-sessions-with-agent-view">75<h2 id="monitor-sessions-with-agent-view">

74 Мониторинг сеансов с помощью agent view76 Мониторинг сеансов с помощью agent view

75</h2>77</h2>

76 78 

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

78 80 

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

80 82 


149 151 

150Однострочное резюме в каждой строке генерируется [моделью класса Haiku](/ru/model-config) так, чтобы строка могла сказать вам, что делает сеанс, что ему требуется или что он произвёл, без открытия стенограммы. Пока сеанс активно работает, текст строки обновляется не более одного раза каждые 15 секунд из недавнего вывода самого сеанса без отправки запроса модели, и модель пишет свежее резюме, когда каждый ход заканчивается.152Однострочное резюме в каждой строке генерируется [моделью класса Haiku](/ru/model-config) так, чтобы строка могла сказать вам, что делает сеанс, что ему требуется или что он произвёл, без открытия стенограммы. Пока сеанс активно работает, текст строки обновляется не более одного раза каждые 15 секунд из недавнего вывода самого сеанса без отправки запроса модели, и модель пишет свежее резюме, когда каждый ход заканчивается.

151 153 

152Работающая строка показывает, что говорит сеанс, что он делает, и заблокированная строка показывает вопрос, который он задаёт. Во время длительного хода модель также переписывает резюме примерно раз в минуту, ожидая в два раза дольше после каждой переписи до четырёх минут, поэтому занятая строка не продолжает показывать устаревшее резюме. Текст усекается на 64 столбцах; откройте [панель просмотра](#peek-and-reply) для чтения всего предложения. До версии 2.1.205 работающая строка могла показывать необработанный вызов инструмента вместо отчёта, и сеанс, работающий над параллельными рабочими элементами, показывал счётчик `done/total`, такой как `2/5`, перед текстом.154Работающая строка показывает, что говорит сеанс, что он делает, и заблокированная строка показывает вопрос, который он задаёт. Во время длительного хода модель также переписывает резюме примерно раз в минуту, ожидая в два раза дольше после каждой переписи до четырёх минут, поэтому занятая строка не продолжает показывать устаревшее резюме. До версии 2.1.205 работающая строка могла показывать необработанный вызов инструмента вместо отчёта, и сеанс, работающий над параллельными рабочими элементами, показывал счётчик `done/total`, такой как `2/5`, перед текстом.

155 

156Текст резюме заполняет оставшуюся ширину строки и усекается только на правом краю терминала; откройте [панель просмотра](#peek-and-reply) для чтения предложения, которое край обрезает. До версии 2.1.206 текст был обрезан на 64 столбцах независимо от ширины терминала.

153 157 

154Когда список [сгруппирован по каталогу](#organize-the-list), резюме открывается с состоянием сеанса как цветное слово, такое как `Needs input · double jump or wall climb?`. При группировке состояния по умолчанию заголовок группы уже называет состояние, поэтому строка показывает только резюме. До версии 2.1.205 строки, сгруппированные по каталогу, не содержали слова состояния.158Когда список [сгруппирован по каталогу](#organize-the-list), резюме открывается с состоянием сеанса как цветное слово, такое как `Needs input · double jump or wall climb?`. При группировке состояния по умолчанию заголовок группы уже называет состояние, поэтому строка показывает только резюме. До версии 2.1.205 строки, сгруппированные по каталогу, не содержали слова состояния.

155 159 


184 Просмотр и ответ188 Просмотр и ответ

185</h3>189</h3>

186 190 

187Нажмите `Space` на выбранной строке, чтобы открыть панель просмотра. Она открывается с полным предложением статуса сеанса, которое строка усекает, и как давно оно изменилось, за которым следуют любые pull request, связанные с сеансом. Для сеанса, который ждёт вас, точный вопрос, который он задаёт, также появляется выше ввода ответа. В большинстве случаев панель просмотра достаточна, и вам не нужно открывать полную стенограмму.191Нажмите `Space` на выбранной строке, чтобы открыть панель просмотра. Она открывается с предложением, которое строка усекает на краю терминала, и какое предложение это зависит от состояния сеанса:

192 

193* Сеанс, который ждёт вас: точный вопрос, который он задаёт, выше ввода ответа

194* Завершённый сеанс: его результат

195* Работающий сеанс: его полное предложение статуса

196 

197Любые pull request, связанные с сеансом, указаны далее. Для сеанса, который ждёт вас, строка, такая как `waiting 3m` ниже них, показывает, как долго он ждёт, и это единственное время, показанное на панели. Возраст в правом краю строки — это другое число: он отсчитывается с момента запуска сеанса.

198 

199В большинстве случаев панель просмотра достаточна, и вам не нужно открывать полную стенограмму.

188 200 

189До версии 2.1.205 панель повторяла предложение статуса только когда ей было нечего больше показывать и называла самый долгоживущий параллельный рабочий элемент.201До версии 2.1.207 каждый просмотр открывался с предложением статуса и простой меткой времени, и заблокированный сеанс показывал вопрос ниже них с префиксом той же метки времени второй раз.

190 202 

191Введите ответ в панель просмотра и нажмите `Enter`, чтобы отправить его этому сеансу. Когда сеанс задаёт вопрос с несколькими вариантами ответов, панель просмотра показывает варианты и вы можете нажать цифровую клавишу для выбора одного. Для других заблокированных сеансов нажмите `Tab`, чтобы заполнить ввод предложенным ответом, который вы можете отредактировать перед отправкой. Начните ответ с `!`, чтобы отправить команду Bash вместо этого.203Введите ответ в панель просмотра и нажмите `Enter`, чтобы отправить его этому сеансу. Когда сеанс задаёт вопрос с несколькими вариантами ответов, панель просмотра показывает варианты и вы можете нажать цифровую клавишу для выбора одного. Для других заблокированных сеансов нажмите `Tab`, чтобы заполнить ввод предложенным ответом, который вы можете отредактировать перед отправкой. Начните ответ с `!`, чтобы отправить команду Bash вместо этого.

192 204 

205Ответ, который не может быть доставлен, потому что фоновая служба недоступна или отправка не удалась, сохраняется и отправляется сеансу как его следующий запрос, когда его процесс снова запустится, и сообщение об ошибке говорит, что ответ был сохранён. Ответ с префиксом `!` не сохраняется, потому что сохранённый текст достигнет сеанса как простой запрос, а не запустится как команда Bash.

206 

193С включённой [голосовой диктовкой](/ru/voice-dictation), удерживайте или нажимайте клавишу push-to-talk, пока фокус находится на вводе ответа, чтобы продиктовать ответ вместо его ввода. То же самое работает в поле отправки внизу agent view.207С включённой [голосовой диктовкой](/ru/voice-dictation), удерживайте или нажимайте клавишу push-to-talk, пока фокус находится на вводе ответа, чтобы продиктовать ответ вместо его ввода. То же самое работает в поле отправки внизу agent view.

194 208 

195Используйте `↑` и `↓` для просмотра соседних сеансов без закрытия панели, или `→` для подключения.209Используйте `↑` и `↓` для просмотра соседних сеансов без закрытия панели, или `→` для подключения.


200 214 

201Нажмите `Enter` или `→` на выбранной строке для подключения. Agent view заменяется полным интерактивным сеансом. При подключении Claude публикует краткое резюме того, что произошло, пока вас не было.215Нажмите `Enter` или `→` на выбранной строке для подключения. Agent view заменяется полным интерактивным сеансом. При подключении Claude публикует краткое резюме того, что произошло, пока вас не было.

202 216 

203При подключении сеанс ведёт себя как любой другой сеанс Claude Code: каждая [команда](/ru/commands), сочетание клавиш и функция работают.217При подключении сеанс ведёт себя как любой другой сеанс Claude Code: [команды](/ru/commands), сочетания клавиш и функции все работают, с исключениями ниже.

218 

219Фоновый сеанс отказывает `/install-github-app` и список параметров [`/mcp`](/ru/mcp), включая его действия аутентификации, независимо от того, подключены ли вы или отвечаете из панели просмотра. Сообщение направляет вас к обычному сеансу `claude`, и `/mcp reconnect <server>`, `/mcp enable` и `/mcp disable` всё ещё работают.

204 220 

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

206 222 


241 257 

242Удаление удаляет сеанс из agent view. Если Claude [создал worktree](#how-file-edits-are-isolated) для сеанса, удаление удаляет этот worktree тоже, включая любые незафиксированные изменения в нём, поэтому отправьте или зафиксируйте работу, которую вы хотите сохранить, перед удалением. Worktree, который вы создали сами и запустили сеанс внутри, остаётся на месте. Стенограмма разговора остаётся на вашем локальном компьютере и остаётся доступной через `claude --resume`.258Удаление удаляет сеанс из agent view. Если Claude [создал worktree](#how-file-edits-are-isolated) для сеанса, удаление удаляет этот worktree тоже, включая любые незафиксированные изменения в нём, поэтому отправьте или зафиксируйте работу, которую вы хотите сохранить, перед удалением. Worktree, который вы создали сами и запустили сеанс внутри, остаётся на месте. Стенограмма разговора остаётся на вашем локальном компьютере и остаётся доступной через `claude --resume`.

243 259 

260Удаление никогда не удаляет worktree с коммитами, которые не отправлены никуда, или тот, который другой работающий сеанс требует или заблокировал. Claude Code сохраняет worktree и сеанс, и нижний колонтитул называет сохранённый путь и причину. Отправьте коммиты или закройте другой сеанс, затем удалите снова.

261 

262Удаление также очищает сеанс из [списка сеансов супервизора](#the-supervisor-process), независимо от того, удаляете ли вы с помощью `Ctrl+X` или с помощью [`claude rm`](#manage-sessions-from-the-shell) из оболочки, поэтому удаление сохраняется при перезапусках супервизора. До версии 2.1.206 удаление сеанса, пока супервизор перезапускался или был недоступен, оставляло его в этом списке, и следующий супервизор перезапускал его процесс и показывал строку снова.

263 

244Завершённые сеансы, которые не помещаются на экран, складываются в строку `… N more`. Сбои и сеансы с открытым pull request всегда остаются видимыми. Группа `Completed` заполняет вертикальное пространство, оставшееся после живых групп, и на коротком терминале заголовок сжимается в одну строку резюме, чтобы сеансы, которые работают или требуют ввода, оставались видимыми.264Завершённые сеансы, которые не помещаются на экран, складываются в строку `… N more`. Сбои и сеансы с открытым pull request всегда остаются видимыми. Группа `Completed` заполняет вертикальное пространство, оставшееся после живых групп, и на коротком терминале заголовок сжимается в одну строку резюме, чтобы сеансы, которые работают или требуют ввода, оставались видимыми.

245 265 

246<h3 id="filter-sessions">266<h3 id="filter-sessions">


293 313 

294Введите подсказку в поле ввода внизу agent view и нажмите `Enter` для запуска нового фонового сеанса. Сеанс автоматически называется из подсказки; переименуйте его позже с помощью `Ctrl+R`.314Введите подсказку в поле ввода внизу agent view и нажмите `Enter` для запуска нового фонового сеанса. Сеанс автоматически называется из подсказки; переименуйте его позже с помощью `Ctrl+R`.

295 315 

316Имя, которое сеанс получает позже, также отображается на его строке, включая имя, которое Claude выводит, когда вы [принимаете план](/ru/permission-modes#review-and-approve-a-plan) в этом сеансе. До версии 2.1.207 фоновый сеанс, названный путём принятия плана, показывал это имя в `/status`, но не на строке agent view до тех пор, пока вы не переименовали его сами.

317 

296Вставьте изображение в подсказку, чтобы включить снимок экрана или диаграмму с задачей.318Вставьте изображение в подсказку, чтобы включить снимок экрана или диаграмму с задачей.

297 319 

320Вставленный текст длиннее 800 символов или более двух строк сворачивается в заполнитель `[Pasted text #N]`, чтобы ввод оставался на одной строке; полный текст отправляется при отправке. {/* min-version: 2.1.207 */}Чтобы просмотреть или отредактировать свёрнутый текст перед отправкой, вставьте тот же текст снова, и заполнитель развернётся обратно в ввод. Напоминание `paste again to expand` появляется под вводом на несколько секунд после вставки на терминалах шириной не менее 90 столбцов. До версии 2.1.207 вставка того же текста снова добавляла второй заполнитель вместо развёртывания первого.

321 

298Используйте префиксы или упомяните части подсказки для управления тем, как запускается сеанс:322Используйте префиксы или упомяните части подсказки для управления тем, как запускается сеанс:

299 323 

300| Ввод | Эффект |324| Ввод | Эффект |


445 469 

446Когда hook не удаётся в каталоге, который не является git репозиторием, сеанс пропускает изоляцию для этого каталога и редактирует рабочий каталог на месте. Внутри git репозитория записи остаются заблокированными до тех пор, пока сеанс не изолирует. До версии 2.1.203 фоновый сеанс в этом состоянии не мог редактировать какой-либо файл: каждая запись была отклонена до изоляции, и hook никогда не мог изолировать этот каталог.470Когда hook не удаётся в каталоге, который не является git репозиторием, сеанс пропускает изоляцию для этого каталога и редактирует рабочий каталог на месте. Внутри git репозитория записи остаются заблокированными до тех пор, пока сеанс не изолирует. До версии 2.1.203 фоновый сеанс в этом состоянии не мог редактировать какой-либо файл: каждая запись была отклонена до изоляции, и hook никогда не мог изолировать этот каталог.

447 471 

448Удаление сеанса в agent view с `Ctrl+X` дважды удаляет worktree, созданный Claude для него, включая любые незафиксированные изменения, поэтому объедините или отправьте изменения, которые вы хотите сохранить, перед удалением. Удаление из оболочки с помощью [`claude rm`](#manage-sessions-from-the-shell) сохраняет worktree, который имеет незафиксированные изменения, и выводит его путь, чтобы вы могли очистить его самостоятельно. Worktree, который вы создали сами и запустили сеанс внутри, остаётся на месте в любом случае.472Удаление сеанса удаляет или сохраняет worktree, созданный Claude для него, в зависимости от того, как вы его удаляете и что содержит worktree:

473 

474* Удаление в agent view с `Ctrl+X` дважды удаляет worktree, включая любые незафиксированные изменения, поэтому зафиксируйте изменения, которые вы хотите сохранить, сначала.

475* Удаление из оболочки с помощью [`claude rm`](#manage-sessions-from-the-shell) сохраняет worktree, который имеет незафиксированные изменения, вместе с его строкой сеанса.

476* Ни один путь не удаляет worktree с коммитами, которые не отправлены никуда: worktree [хранится вместе с его сеансом](#organize-the-list) и вывод называет сохранённый путь и причину.

477* Worktree, который вы создали сами и запустили сеанс внутри, остаётся на месте в любом случае.

449 478 

450Чтобы найти путь worktree сеанса, посмотрите сеанс или подключитесь и проверьте его рабочий каталог.479Чтобы найти путь worktree сеанса, посмотрите сеанс или подключитесь и проверьте его рабочий каталог.

451 480 


475Каждый фоновый сеанс может работать на другой модели. Чтобы переопределить его для одного сеанса:504Каждый фоновый сеанс может работать на другой модели. Чтобы переопределить его для одного сеанса:

476 505 

477* Из оболочки передайте `--model` с `claude --bg`.506* Из оболочки передайте `--model` с `claude --bg`.

478* Подключитесь к работающему сеансу, откройте `/model` и нажмите `s` на модель для переключения только для этого сеанса. Изменение сохраняется, если сеанс перезапущен.507* Подключитесь к работающему сеансу и запустите `/model` для переключения: выбор из picker или введённый `/model <name>` сохраняется как ваш стандарт для новых сеансов, если вы не нажмёте `s` в picker для переключения только для этого сеанса. Переключение только для сеанса сохраняется, если сеанс перезапущен.

479* Отправьте [subagent](/ru/sub-agents), чей frontmatter устанавливает поле `model`.508* Отправьте [subagent](/ru/sub-agents), чей frontmatter устанавливает поле `model`.

480 509 

481<h3 id="permission-mode-model-and-effort">510<h3 id="permission-mode-model-and-effort">


484 513 

485Фоновый сеанс читает свои [settings](/ru/settings) из каталога, в котором он запускается, так же как если бы вы запустили `claude` там. Это включает значения [`env`](/ru/settings#available-settings) в settings проекта, поэтому `ANTHROPIC_MODEL` или переменная поставщика, установленная там, применяется к фоновым сеансам в этом каталоге.514Фоновый сеанс читает свои [settings](/ru/settings) из каталога, в котором он запускается, так же как если бы вы запустили `claude` там. Это включает значения [`env`](/ru/settings#available-settings) в settings проекта, поэтому `ANTHROPIC_MODEL` или переменная поставщика, установленная там, применяется к фоновым сеансам в этом каталоге.

486 515 

487Выбор облачного поставщика, такой как `CLAUDE_CODE_USE_BEDROCK` или `CLAUDE_CODE_USE_VERTEX`, и псевдонимы `ANTHROPIC_DEFAULT_*_MODEL` следуют оболочке, которая отправила сеанс. Переменная конечной точки шлюза `ANTHROPIC_BASE_URL`, экспортированная в этой оболочке, следует ей тоже, вместе с `ANTHROPIC_CUSTOM_HEADERS`, когда supervisor работает с той же окружением шлюза и сеанс запускается в каталоге, из которого вы отправляете, или это ваш собственный сеанс, переведённый в фон с помощью `←` или `/background`. Это нормальный случай, когда первая оболочка, открывшая agent view или отправившая фоновый сеанс, является оболочкой шлюза. Отправка в другой каталог с `@repo` или `--cwd` не переносит шлюз оболочки; параметры этого проекта [settings](/ru/settings) предоставляют конечную точку. См. [supervisor process](#the-supervisor-process) для того, как фоновые сеансы получают параметры поставщика и учётные данные.516Выбор облачного поставщика, такой как `CLAUDE_CODE_USE_BEDROCK` или `CLAUDE_CODE_USE_VERTEX`, и псевдонимы `ANTHROPIC_DEFAULT_*_MODEL` следуют оболочке, которая отправила сеанс. {/* min-version: 2.1.206 */}Если вы экспортируете переопределение тела запроса [`CLAUDE_CODE_EXTRA_BODY`](/ru/env-vars) в этой оболочке, оно достигает сеанса так же. До версии 2.1.206 фоновые рабочие процессы игнорировали экспортированный оболочкой `CLAUDE_CODE_EXTRA_BODY`.

517 

518Если вы экспортируете переменную шлюза `ANTHROPIC_BASE_URL` в отправляющей оболочке, она также достигает сеанса, вместе с `ANTHROPIC_CUSTOM_HEADERS`, когда supervisor работает с той же окружением шлюза и сеанс запускается в каталоге, из которого вы отправляете, или это ваш собственный сеанс, переведённый в фон с помощью `←` или `/background`. Это нормальный случай, когда первая оболочка, открывшая agent view или отправившая фоновый сеанс, является оболочкой шлюза. Отправка в другой каталог с `@repo` или `--cwd` не переносит шлюз оболочки; параметры этого проекта [settings](/ru/settings) предоставляют конечную точку. См. [supervisor process](#the-supervisor-process) для того, как фоновые сеансы получают параметры поставщика и учётные данные.

488 519 

489[Permission mode](/ru/permissions) зависит от того, как вы запустили сеанс. Переведение существующего сеанса в фон с помощью `/bg` или `←` сохраняет текущий permission mode, поэтому сеанс, который вы переключили на `acceptEdits` или `auto`, остаётся в этом режиме после отключения. Отправка из входа agent view или запуск `claude --bg` из вашей оболочки использует `defaultMode` из settings этого каталога или `permissionMode` из frontmatter отправленного [subagent](/ru/sub-agents#supported-frontmatter-fields).520[Permission mode](/ru/permissions) зависит от того, как вы запустили сеанс. Переведение существующего сеанса в фон с помощью `/bg` или `←` сохраняет текущий permission mode, поэтому сеанс, который вы переключили на `acceptEdits` или `auto`, остаётся в этом режиме после отключения. Отправка из входа agent view или запуск `claude --bg` из вашей оболочки использует `defaultMode` из settings этого каталога или `permissionMode` из frontmatter отправленного [subagent](/ru/sub-agents#supported-frontmatter-fields).

490 521 


548| `claude stop <id>` | Остановить сеанс. Также принимает `claude kill` |579| `claude stop <id>` | Остановить сеанс. Также принимает `claude kill` |

549| `claude respawn <id>` | Перезапустить сеанс, работающий или остановленный, с его беседой нетронутой, например, чтобы подобрать обновленный бинарный файл Claude Code |580| `claude respawn <id>` | Перезапустить сеанс, работающий или остановленный, с его беседой нетронутой, например, чтобы подобрать обновленный бинарный файл Claude Code |

550| `claude respawn --all` | Перезапустить каждый работающий сеанс, например, чтобы переместить все сеансы на обновленный бинарный файл Claude Code одновременно |581| `claude respawn --all` | Перезапустить каждый работающий сеанс, например, чтобы переместить все сеансы на обновленный бинарный файл Claude Code одновременно |

551| `claude rm <id>` | Удалить сеанс из списка. Удаляет worktree, созданный Claude для сеанса, если в нем нет незафиксированных изменений; в противном случае выводит путь worktree, чтобы вы могли его очистить. Оставляет на месте worktree, созданный вами самостоятельно. Стенограмма беседы остается на вашем локальном компьютере и остается доступной через `claude --resume` |582| `claude rm <id>` | Удалить сеанс из списка. Удаляет worktree, созданный Claude для сеанса, если в нем нет незафиксированных изменений и нет коммитов, которые не были отправлены куда-либо; в противном случае сеанс также сохраняется, и команда выводит путь worktree и причину, чтобы вы могли это разрешить и снова запустить `claude rm`. Оставляет на месте worktree, созданный вами самостоятельно. Стенограмма беседы остается на вашем локальном компьютере и остается доступной через `claude --resume` |

552| `claude daemon status` | Вывести состояние [supervisor](#the-supervisor-process), версию, каталог сокета и количество рабочих процессов |583| `claude daemon status` | Вывести состояние [supervisor](#the-supervisor-process), версию, каталог сокета и количество рабочих процессов |

553| `claude daemon stop --any` | Остановить процесс supervisor и фоновые сеансы, которые он размещает. Передайте `--keep-workers`, чтобы оставить фоновые сеансы работающими, чтобы следующий supervisor переподключился к ним. Следующий `claude agents` или `claude --bg` запускает новый supervisor |584| `claude daemon stop --any` | Остановить процесс supervisor и фоновые сеансы, которые он размещает. Передайте `--keep-workers`, чтобы оставить фоновые сеансы работающими, чтобы следующий supervisor переподключился к ним. Следующий `claude agents` или `claude --bg` запускает новый supervisor |

554 585 


564 595 

565Фоновые сеансы размещаются процессом супервизора для каждого пользователя, отдельным от вашего терминала и от представления агента. Супервизор запускается автоматически в первый раз, когда вы отправляете сеанс в фон или открываете представление агента, и вы не управляете им напрямую.596Фоновые сеансы размещаются процессом супервизора для каждого пользователя, отдельным от вашего терминала и от представления агента. Супервизор запускается автоматически в первый раз, когда вы отправляете сеанс в фон или открываете представление агента, и вы не управляете им напрямую.

566 597 

598Когда обновление заменило или удалило двоичный файл, из которого был запущен работающий процесс Claude Code, этот процесс запускает супервизор из другой установленной копии, такой как установленный запускатель `claude` или самая новая версия на диске.

599 

567Супервизор держит один предварительно прогретый рабочий процесс в готовности, чтобы отправка из представления агента или `claude --bg` начиналась без задержки холодного запуска. Когда вы отправляете, супервизор назначает предварительно прогретого рабочего вашему сеансу, применяет к нему каталог, параметры и учётные данные этого сеанса, а затем запускает замену для следующей отправки. Если здоровый предварительно прогретый рабочий процесс недоступен, супервизор вместо этого запускает свежий процесс.600Супервизор держит один предварительно прогретый рабочий процесс в готовности, чтобы отправка из представления агента или `claude --bg` начиналась без задержки холодного запуска. Когда вы отправляете, супервизор назначает предварительно прогретого рабочего вашему сеансу, применяет к нему каталог, параметры и учётные данные этого сеанса, а затем запускает замену для следующей отправки. Если здоровый предварительно прогретый рабочий процесс недоступен, супервизор вместо этого запускает свежий процесс.

568 601 

569Супервизор и его сеансы аутентифицируются с теми же учётными данными, что и ваши интерактивные сеансы, и не делают дополнительных сетевых подключений за пределами API модели. Переменные выбора поставщика, такие как `CLAUDE_CODE_USE_BEDROCK` и псевдонимы `ANTHROPIC_DEFAULT_*_MODEL`, читаются из оболочки, которая отправила каждый сеанс, и применяются к его рабочему процессу.602Супервизор и его сеансы аутентифицируются с теми же учётными данными, что и ваши интерактивные сеансы, и не делают дополнительных сетевых подключений за пределами API модели. Переменные выбора поставщика, такие как `CLAUDE_CODE_USE_BEDROCK` и псевдонимы `ANTHROPIC_DEFAULT_*_MODEL`, читаются из оболочки, которая отправила каждый сеанс, и применяются к его рабочему процессу.


572 605 

573Фоновый сеанс не наследует переменные конечной точки шлюза, такие как `ANTHROPIC_BASE_URL`, или эквивалентные переменные базового URL Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, из оболочки, которая запустила супервизор. Без шлюза, экспортированного в оболочке, из которой вы отправляете, сеанс использует ваши сохранённые учётные данные и любые значения `env` в [параметрах](/ru/settings) каталога проекта. Чтобы указать каждый сеанс в проекте на [шлюз LLM](/ru/llm-gateway), установите `ANTHROPIC_BASE_URL` в блоке `env` файла `.claude/settings.json` этого проекта.606Фоновый сеанс не наследует переменные конечной точки шлюза, такие как `ANTHROPIC_BASE_URL`, или эквивалентные переменные базового URL Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, из оболочки, которая запустила супервизор. Без шлюза, экспортированного в оболочке, из которой вы отправляете, сеанс использует ваши сохранённые учётные данные и любые значения `env` в [параметрах](/ru/settings) каталога проекта. Чтобы указать каждый сеанс в проекте на [шлюз LLM](/ru/llm-gateway), установите `ANTHROPIC_BASE_URL` в блоке `env` файла `.claude/settings.json` этого проекта.

574 607 

575{/* min-version: 2.1.203 */}Шлюз `ANTHROPIC_BASE_URL`, экспортированный в оболочке, из которой вы отправляете, достигает рабочего процесса этого сеанса вместе с `ANTHROPIC_CUSTOM_HEADERS` и учётными данными, экспортированными рядом с ними, когда супервизор был запущен из окружения с тем же шлюзом. Супервизор захватывает своё окружение из первой оболочки, которая открывает представление агента или отправляет фоновый сеанс, поэтому запуск из оболочки шлюза даёт ему это окружение. Пересылка также применяется только к сеансам, отправленным в каталог, из которого вы отправляете, или отправленным в фон из вашего собственного сеанса с помощью `←` или `/background`: отправка в другой каталог с помощью `@repo` или `--cwd` не переносит шлюз оболочки, и блок `env` файла `settings.json` этого проекта предоставляет конечную точку вместо этого. Когда окружение супервизора несёт другой шлюз или его нет, рабочий процесс сохраняет ваши сохранённые учётные данные против конечной точки по умолчанию вместо смешивания учётных данных одного окружения с конечной точкой другого. До версии 2.1.203 `ANTHROPIC_BASE_URL` отправляющей оболочки был удалён, в то время как `ANTHROPIC_API_KEY`, экспортированный рядом с ним, был сохранён, поэтому ключ шлюза был отправлен на конечную точку по умолчанию и каждый запрос завершился ошибкой 401.608{/* min-version: 2.1.203 */}Если вы экспортируете шлюз `ANTHROPIC_BASE_URL` в оболочке, из которой вы отправляете, он достигает рабочего процесса этого сеанса. `ANTHROPIC_CUSTOM_HEADERS` и учётные данные, экспортированные рядом с ними, пересылаются вместе с ним. Это происходит, когда супервизор был запущен из окружения с тем же шлюзом. Супервизор захватывает своё окружение из первой оболочки, которая открывает представление агента или отправляет фоновый сеанс, поэтому запуск из оболочки шлюза даёт ему это окружение. Пересылка также применяется только к сеансам, отправленным в каталог, из которого вы отправляете, или отправленным в фон из вашего собственного сеанса с помощью `←` или `/background`: отправка в другой каталог с помощью `@repo` или `--cwd` не переносит шлюз оболочки, и блок `env` файла `settings.json` этого проекта предоставляет конечную точку вместо этого. Когда окружение супервизора несёт другой шлюз или его нет, рабочий процесс сохраняет ваши сохранённые учётные данные против конечной точки по умолчанию вместо смешивания учётных данных одного окружения с конечной точкой другого. До версии 2.1.203 `ANTHROPIC_BASE_URL` отправляющей оболочки был удалён, в то время как `ANTHROPIC_API_KEY`, экспортированный рядом с ним, был сохранён, поэтому ключ шлюза был отправлен на конечную точку по умолчанию и каждый запрос завершился ошибкой 401.

576 609 

577Пересылаемая конечная точка применяется только к этому живому процессу и никогда не записывается на диск. Когда супервизор останавливает неактивный сеанс и позже перезапускает его, перезапущенный процесс читает свою конечную точку из ваших параметров снова: с шлюзом `ANTHROPIC_AUTH_TOKEN` он возвращается к вашим сохранённым учётным данным, а с выданным шлюзом `ANTHROPIC_API_KEY` он может не пройти аутентификацию, пока шлюз не будет установлен в параметрах.610Пересылаемая конечная точка применяется только к этому живому процессу и никогда не записывается на диск. Когда супервизор останавливает неактивный сеанс и позже перезапускает его, перезапущенный процесс читает свою конечную точку из ваших параметров снова: с шлюзом `ANTHROPIC_AUTH_TOKEN` он возвращается к вашим сохранённым учётным данным, а с выданным шлюзом `ANTHROPIC_API_KEY` он может не пройти аутентификацию, пока шлюз не будет установлен в параметрах.

578 611 


592 625 

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

594 627 

628Перезапущенный процесс находит разговор сеанса, который [переместился в worktree](#how-file-edits-are-isolated) во время выполнения задачи: когда стенограмма находится не там, где сеанс начался, Claude Code также ищет под зарегистрированными worktrees репозитория. До версии 2.1.207 повторное открытие этого сеанса из представления агента после остановки его процесса могло показать пустой разговор только с его исходной подсказкой, со стенограммой, всё ещё нетронутой на диске; открытие сеанса снова в версии 2.1.207 или позже восстанавливает его.

629 

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

596 631 

597Пустая строка, оставшаяся от нажатия `←`, которой никогда не был задан запрос, удаляется полностью примерно через пять минут, чтобы список очищался самостоятельно. Сеансы, запущенные с помощью `claude --bg`, и сеансы, ожидающие подсказки установки, такие как диалог доверия, не удаляются таким образом.632Пустая строка, оставшаяся от нажатия `←`, которой никогда не был задан запрос, удаляется полностью примерно через пять минут, чтобы список очищался самостоятельно. Сеансы, запущенные с помощью `claude --bg`, и сеансы, ожидающие подсказки установки, такие как диалог доверия, не удаляются таким образом.


600 635 

601Супервизор наблюдает установленный двоичный файл Claude Code на диске и перезапускается в новую версию после того, как обычный [auto-updater](/ru/setup#auto-updates) его заменит. Это локальное наблюдение файла, а не сетевая проверка. Фоновые сеансы — это отсоединённые процессы, поэтому они продолжают работать через перезагрузку и новый супервизор переподключается к ним. Неактивный закреплённый сеанс также перезапускается на месте в новую версию, чтобы он получил обновление без необходимости переподключения.636Супервизор наблюдает установленный двоичный файл Claude Code на диске и перезапускается в новую версию после того, как обычный [auto-updater](/ru/setup#auto-updates) его заменит. Это локальное наблюдение файла, а не сетевая проверка. Фоновые сеансы — это отсоединённые процессы, поэтому они продолжают работать через перезагрузку и новый супервизор переподключается к ним. Неактивный закреплённый сеанс также перезапускается на месте в новую версию, чтобы он получил обновление без необходимости переподключения.

602 637 

638После того как новый супервизор берёт на себя управление, он также перезапускает оставшиеся неактивные сеансы в новую версию, несколько за раз в фоне, после короткой задержки, которая позволяет терминалам, подключённым через перезагрузку, переподключиться в первую очередь. Сеанс, который работает, ждёт вашего ввода или имеет подключённый терминал, не прерывается; он переходит на новую версию в следующий раз, когда его процесс перезапускается. До версии 2.1.206 супервизор перемещал только несколько неактивных сеансов в минуту на новую версию, поэтому сеансы могли продолжать работать на старой версии некоторое время после обновления.

639 

640Эти перезагрузки только когда-либо перемещают сеанс на более новую версию. Супервизор, работающий на более старой версии Claude Code, чем та, с которой был запущен процесс сеанса, оставляет этот процесс в покое; сеанс продолжает работать на более новой версии, пока более новый супервизор не возьмёт на себя управление.

641 

603Запуск `claude attach` во время перезагрузки супервизором сеанса, будь то для обновления, зависания или миграции, ожидает процесса замены вместо того, чтобы завершиться ошибкой. Строка состояния, такая как `Agent is updating to the new Claude Code…`, указывает, что она ожидает, и отсчитывает прошедшие секунды, и команда подключается, как только сеанс готов. Примерно через 60 секунд она перестаёт ждать и сообщает об ошибке. До версии 2.1.205 `claude attach` прекращал повторные попытки через несколько секунд и выводил ошибку, пока сеанс всё ещё перезагружался.642Запуск `claude attach` во время перезагрузки супервизором сеанса, будь то для обновления, зависания или миграции, ожидает процесса замены вместо того, чтобы завершиться ошибкой. Строка состояния, такая как `Agent is updating to the new Claude Code…`, указывает, что она ожидает, и отсчитывает прошедшие секунды, и команда подключается, как только сеанс готов. Примерно через 60 секунд она перестаёт ждать и сообщает об ошибке. До версии 2.1.205 `claude attach` прекращал повторные попытки через несколько секунд и выводил ошибку, пока сеанс всё ещё перезагружался.

604 643 

605<h3 id="where-state-is-stored">644<h3 id="where-state-is-stored">


737 776 

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

739 778 

779Пока процесс запускается, последний экран транскрипта сеанса отображается с примечанием `Session is starting` ниже, и живой сеанс заменяет его, как только он будет готов.

780 

740<h3 id="claude/worktrees/-is-filling-up">781<h3 id="claude/worktrees/-is-filling-up">

741 `.claude/worktrees/` заполняется782 `.claude/worktrees/` заполняется

742</h3>783</h3>

743 784 

744Удаление сеанса в представлении агентов удаляет рабочее дерево, которое Claude создал для него. `claude rm` сохраняет рабочее дерево, которое имеет незафиксированные изменения, и выводит его путь. Перечислите оставшиеся записи с помощью `git worktree list` в каталоге проекта и удалите каждую с помощью `git worktree remove <path>`. См. [Clean up worktrees](/ru/worktrees#clean-up-worktrees).785Удаление сеанса в представлении агентов удаляет рабочее дерево, которое Claude создал для него, и рабочее дерево, которое не может быть удалено безопасно, [сохраняет свою строку сеанса](#organize-the-list), чтобы оно не было потеряно. `claude rm` сохраняет рабочее дерево, которое имеет незафиксированные изменения, и его строку сеанса, и выводит сохранённый путь. Перечислите оставшиеся записи с помощью `git worktree list` в каталоге проекта и удалите каждую с помощью `git worktree remove <path>`. См. [Clean up worktrees](/ru/worktrees#clean-up-worktrees).

745 786 

746<h2 id="limitations">787<h2 id="limitations">

747 Ограничения788 Ограничения


751 792 

752* **Применяются ограничения скорости**: фоновые сеансы потребляют использование вашей подписки так же, как интерактивные сеансы, поэтому запуск десяти агентов параллельно использует квоту примерно в десять раз быстрее, чем запуск одного.793* **Применяются ограничения скорости**: фоновые сеансы потребляют использование вашей подписки так же, как интерактивные сеансы, поэтому запуск десяти агентов параллельно использует квоту примерно в десять раз быстрее, чем запуск одного.

753* **Сеансы локальны**: фоновые сеансы работают на вашей машине. Они сохраняются при переходе в спящий режим, но останавливаются при выключении машины.794* **Сеансы локальны**: фоновые сеансы работают на вашей машине. Они сохраняются при переходе в спящий режим, но останавливаются при выключении машины.

754* **Worktrees, созданные Claude, удаляются с сеансом в agent view**: объедините или отправьте изменения перед удалением сеанса, который редактировал файлы в его собственном worktree. `claude rm` сохраняет worktree, который имеет незафиксированные изменения; worktree, который вы создали сами, остаётся на месте.795* **Worktrees, созданные Claude, удаляются с сеансом в agent view**: зафиксируйте изменения перед удалением сеанса, который редактировал файлы в его собственном worktree. Worktree с коммитами, которые не отправлены никуда, сохраняется вместе с сеансом. `claude rm` также сохраняет worktree, который имеет незафиксированные изменения, вместе с его сеансом, а worktree, который вы создали сами, остаётся на месте.

755 796 

756<h2 id="related-resources">797<h2 id="related-resources">

757 Связанные ресурсы798 Связанные ресурсы


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

771 812 

772| Версия | Изменение |813| Версия | Изменение |

773| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |814| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

815| v2.1.208 | {/* min-version: 2.1.208 */}Подключение к сеансу, процесс которого остановился, показывает последний экран его стенограммы во время запуска процесса вместо только заметки `Session is starting`. Ответ, который не может быть доставлен, потому что фоновый сервис недоступен или отправка не удаётся, сохраняется и отправляется как следующий запрос сеанса при перезапуске его процесса; до этого выпуска ответ, потерянный, когда фоновый сервис был недоступен, был отброшен. Процесс, чей собственный двоичный файл был заменён обновлением, всё ещё может запустить супервизор из установленного средства запуска `claude` или самой новой версии на диске вместо сбоя до перезагрузки Claude Code. Супервизор, работающий на более старой версии, никогда не перезапускает неактивный сеанс, запущенный более новой версией, на его собственный более старый двоичный файл. Удаление сеанса удаляет его worktree даже после того, как сеанс переместил worktree на другую ветвь, и сохраняет worktree вместе со строкой сеанса, когда worktree имеет коммиты, которые не отправлены никуда, или другой сеанс требует его, вместо уничтожения коммитов или оставления worktree без владельца. `/install-github-app` и список параметров `/mcp` и его действия аутентификации отклоняются в фоновом сеансе с сообщением, указывающим альтернативу; только в v2.1.208 средство выбора `/model` было отклонено таким же образом, и введённая команда `/model <name>` переключала только этот сеанс вместо также сохранения вашей модели по умолчанию. |

816| v2.1.207 | {/* min-version: 2.1.207 */}Панель просмотра открывается с предложением, которое строка усекает, например точный вопрос для сеанса, ожидающего вас, и показывает, как долго заблокированный сеанс ждёт, как одна строка `waiting 3m` вместо добавления одного и того же временного штампа к предложению статуса и вопросу. Вставка одного и того же текста снова в поле отправки расширяет свёрнутый заполнитель `[Pasted text #N]` вместо добавления второго. Фоновый сеанс, названный путём принятия плана, показывает это имя на его строке. Фоновый сеанс, который переместился в worktree, сохраняет свой разговор при перезапуске его процесса из agent view. |

817| v2.1.206 | {/* min-version: 2.1.206 */}Резюме строк заполняют оставшуюся ширину строки и усекаются только на правом краю терминала вместо 64 столбцов. После перезапуска супервизора в новую версию Claude Code он перезапускает оставшиеся неактивные фоновые сеансы на эту версию в фоне вместо нескольких в минуту. Удаление сеанса с помощью `Ctrl+X` или `claude rm` также очищает его из списка сеансов супервизора, поэтому строка больше не появляется после перезапуска супервизора. |

774| v2.1.205 | {/* min-version: 2.1.205 */}Резюме строк показывают собственный однострочный отчёт сеанса, усечённый на 64 столбцах, вместо необработанного вызова инструмента или счётчика `done/total`; строки, сгруппированные по каталогам, открываются с цветным словом состояния. Панель просмотра открывается с полным предложением статуса и, для сеанса, ожидающего вас, его точный вопрос выше поля ввода ответа. Сеансы, которые редактируют, комментируют, закрывают или отмечают pull request как готовый с помощью `gh`, связаны с ним, а не только те, которые создают или проверяют pull request; push связывает pull request даже когда имя локальной ветви не совпадает, и pull request, чей вывод команды создания превысил встроенный лимит, также связан. Ход без читаемого текста сохраняет предыдущее состояние сеанса вместо того, чтобы вернуть его обратно в `Working`. `claude attach` ожидает до примерно 60 секунд сеанс, который перезагружается, со строкой статуса, указывающей причину, вместо сбоя. |818| v2.1.205 | {/* min-version: 2.1.205 */}Резюме строк показывают собственный однострочный отчёт сеанса, усечённый на 64 столбцах, вместо необработанного вызова инструмента или счётчика `done/total`; строки, сгруппированные по каталогам, открываются с цветным словом состояния. Панель просмотра открывается с полным предложением статуса и, для сеанса, ожидающего вас, его точный вопрос выше поля ввода ответа. Сеансы, которые редактируют, комментируют, закрывают или отмечают pull request как готовый с помощью `gh`, связаны с ним, а не только те, которые создают или проверяют pull request; push связывает pull request даже когда имя локальной ветви не совпадает, и pull request, чей вывод команды создания превысил встроенный лимит, также связан. Ход без читаемого текста сохраняет предыдущее состояние сеанса вместо того, чтобы вернуть его обратно в `Working`. `claude attach` ожидает до примерно 60 секунд сеанс, который перезагружается, со строкой статуса, указывающей причину, вместо сбоя. |

775| v2.1.203 | {/* min-version: 2.1.203 */}Шлюз `ANTHROPIC_BASE_URL`, экспортированный в оболочке отправки, достигает сеансов, отправленных из неё в тот же каталог, когда супервизор делится этой переменной окружения шлюза, вместо того чтобы быть отброшенным, в то время как экспортированный вместе с ним ключ API был сохранён. `PATH` оболочки отправки применяется к каждому рабочему процессу сеанса. Нажатие `←` во время выполнения подагентов ожидает их вместо перезапуска через десять секунд. Пустой список всегда показывает заголовки разделов с описанием под каждым. Ввод `@` в поле отправки также перечисляет зарегистрированные git worktrees репозитория запуска, которые находятся внутри его дерева каталогов. Усилие, унаследованное от параметра `effortLevel`, следует более поздним редактированиям этого параметра вместо того, чтобы быть зафиксированным при отправке. Открытие остановленного сеанса, чей разговор уже открыт в другом запущенном сеансе, отклоняется с сообщением вместо сбоя строки. Команда, которая недоступна в agent view, оставляет введённый текст в поле ввода. Hook `WorktreeCreate`, который не удаётся вне репозитория git, больше не блокирует сеанс от редактирования файлов. |819| v2.1.203 | {/* min-version: 2.1.203 */}Шлюз `ANTHROPIC_BASE_URL`, экспортированный в оболочке отправки, достигает сеансов, отправленных из неё в тот же каталог, когда супервизор делится этой переменной окружения шлюза, вместо того чтобы быть отброшенным, в то время как экспортированный вместе с ним ключ API был сохранён. `PATH` оболочки отправки применяется к каждому рабочему процессу сеанса. Нажатие `←` во время выполнения подагентов ожидает их вместо перезапуска через десять секунд. Пустой список всегда показывает заголовки разделов с описанием под каждым. Ввод `@` в поле отправки также перечисляет зарегистрированные git worktrees репозитория запуска, которые находятся внутри его дерева каталогов. Усилие, унаследованное от параметра `effortLevel`, следует более поздним редактированиям этого параметра вместо того, чтобы быть зафиксированным при отправке. Открытие остановленного сеанса, чей разговор уже открыт в другом запущенном сеансе, отклоняется с сообщением вместо сбоя строки. Команда, которая недоступна в agent view, оставляет введённый текст в поле ввода. Hook `WorktreeCreate`, который не удаётся вне репозитория git, больше не блокирует сеанс от редактирования файлов. |

776| v2.1.202 | {/* min-version: 2.1.202 */}Имя, установленное с помощью `/rename` или `Ctrl+R` в фоновом сеансе, сохраняется при остановке и перезапуске процесса супервизора вместо возврата к имени, с которым был отправлен сеанс. |820| v2.1.202 | {/* min-version: 2.1.202 */}Имя, установленное с помощью `/rename` или `Ctrl+R` в фоновом сеансе, сохраняется при остановке и перезапуске процесса супервизора вместо возврата к имени, с которым был отправлен сеанс. |

agents.md +1 −1

Details

54 54 

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

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

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

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

59 59 

60Для представления на рабочем столе всех ваших сеансов см. [параллельные сеансы в приложении для рабочего стола](/ru/desktop#work-in-parallel-with-sessions).60Для представления на рабочем столе всех ваших сеансов см. [параллельные сеансы в приложении для рабочего стола](/ru/desktop#work-in-parallel-with-sessions).

Details

111 </Step>111 </Step>

112</Steps>112</Steps>

113 113 

114После входа запустите `/setup-bedrock` в любое время, чтобы снова открыть мастер и изменить ваши учетные данные, регион или закрепления моделей.114После входа запустите `/setup-bedrock` в любое время, чтобы снова открыть мастер и изменить ваши учетные данные, регион или закрепления моделей. Шаг закрепления модели начинается с ваших текущих закрепленных моделей. Мастер записывает в `~/.claude/settings.json`, или в `$CLAUDE_CONFIG_DIR/settings.json` когда установлена [`CLAUDE_CONFIG_DIR`](/ru/env-vars#variables).

115 115 

116<h2 id="set-up-manually">116<h2 id="set-up-manually">

117 Ручная установка117 Ручная установка


154 154 

155**Вариант C: переменные окружения (профиль SSO)**155**Вариант C: переменные окружения (профиль SSO)**

156 156 

157Замените `your-profile-name` на имя вашего профиля AWS перед запуском этих команд.

158 

157```bash theme={null}159```bash theme={null}

158aws sso login --profile=<your-profile-name>160aws sso login --profile=your-profile-name

159 161 

160export AWS_PROFILE=your-profile-name162export AWS_PROFILE=your-profile-name

161```163```

162 164 

165Claude Code запрашивает учетные данные роли из региона IAM Identity Center, названного в `sso_region` профиля, который не должен совпадать с регионом, в котором вы запускаете Amazon Bedrock. {/* min-version: 2.1.208 */}В версии 2.1.207 регион Amazon Bedrock переопределял `sso_region`, поэтому профиль, экземпляр IAM Identity Center которого находится в другом регионе, не прошел аутентификацию с ошибкой `Session token not found or invalid`.

166 

163**Вариант D: учетные данные AWS Management Console**167**Вариант D: учетные данные AWS Management Console**

164 168 

165```bash theme={null}169```bash theme={null}


176 180 

177Ключи API Amazon Bedrock предоставляют более простой метод аутентификации без необходимости полных учетных данных AWS. [Узнайте больше о ключах API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).181Ключи API Amazon Bedrock предоставляют более простой метод аутентификации без необходимости полных учетных данных AWS. [Узнайте больше о ключах API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).

178 182 

183<h4 id="credential-caching-and-resolution-timeout">

184 Кэширование учетных данных и время ожидания разрешения

185</h4>

186 

187Claude Code разрешает цепочку поставщика учетных данных AWS по умолчанию один раз и сохраняет разрешенные учетные данные в памяти. Он повторно использует их до пяти минут до истечения срока действия или в течение одного часа, когда они не имеют срока действия, поэтому профиль на основе SSO запрашивает учетные данные из IAM Identity Center примерно один раз за время жизни учетных данных. Ошибка учетных данных из API очищает кэш, и повторная попытка разрешает свежие учетные данные.

188 

189До версии 2.1.207 Claude Code разрешал цепочку при каждом запросе API, поэтому профиль на основе SSO запрашивал свежие учетные данные из IAM Identity Center каждый раз и мог быть ограничен в больших развертываниях.

190 

191Кэш охватывает все варианты учетных данных выше, кроме ключа API Amazon Bedrock, который не использует цепочку поставщика. Чтобы разрешить цепочку при каждом запросе вместо этого, установите [`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/ru/env-vars).

192 

193Каждое разрешение цепочки истекает через 60 секунд. Если шаг в цепочке зависает, например помощник `credential_process`, который ждет ввода, который он не может получить, запрос завершается с ошибкой [`AWS default-chain credential resolve timed out`](/ru/errors#aws-default-chain-credential-resolve-timed-out). Если ваша цепочка запускает интерактивный вход, который законно требует больше времени, например браузерный SSO с MFA через оболочку, такую как `aws-vault`, повысьте лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/ru/env-vars). До версии 2.1.207 зависшее разрешение учетных данных оставляло запрос в ожидании неопределенно долго.

194 

179<h4 id="advanced-credential-configuration">195<h4 id="advanced-credential-configuration">

180 Расширенная конфигурация учетных данных196 Расширенная конфигурация учетных данных

181</h4>197</h4>


223 239 

224`Expiration` является необязательным. {/* min-version: 2.1.176 */}Начиная с Claude Code v2.1.176, когда команда возвращает действительное значение `Expiration` в формате ISO 8601, Claude Code кэширует учетные данные до пяти минут до этого времени. Без него или в более ранних версиях учетные данные кэшируются в течение одного часа.240`Expiration` является необязательным. {/* min-version: 2.1.176 */}Начиная с Claude Code v2.1.176, когда команда возвращает действительное значение `Expiration` в формате ISO 8601, Claude Code кэширует учетные данные до пяти минут до этого времени. Без него или в более ранних версиях учетные данные кэшируются в течение одного часа.

225 241 

242Когда вы настраиваете `awsCredentialExport` без `awsAuthRefresh`, Claude Code использует экспортированные учетные данные напрямую и не переразрешает цепочку поставщика учетных данных AWS по умолчанию при запуске. До версии 2.1.206 при запуске также переразрешалась цепочка поставщика по умолчанию, что делало живой вызов SSO или STS вне конфигурации вашего прокси и могло заблокировать первый запрос на несколько минут в сетях с ограниченным исходящим трафиком.

243 

226<h3 id="3-configure-claude-code">244<h3 id="3-configure-claude-code">

227 3. Настройте Claude Code245 3. Настройте Claude Code

228</h3>246</h3>


262</h3>280</h3>

263 281 

264<Warning>282<Warning>

265 Закрепите конкретные версии моделей при развертывании для нескольких пользователей. Без закрепления псевдонимы моделей, такие как `sonnet` и `opus`, разрешаются на встроенное значение по умолчанию Claude Code для Amazon Bedrock, которое может отставать от последнего выпуска и может быть еще недоступно в вашей учетной записи. Claude Code [возвращается](#startup-model-checks) к предыдущей версии при запуске, когда значение по умолчанию недоступно, но закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.283 Закрепите конкретные версии моделей при развертывании для нескольких пользователей. Без закрепления псевдонимы моделей, такие как `sonnet` и `opus`, разрешаются на встроенное значение по умолчанию Claude Code для Amazon Bedrock, которое может отставать от последнего выпуска и может быть еще недоступно в вашей учетной записи. Claude Code [возвращается](#startup-model-checks) к более ранней или более низкой модели при запуске, когда значение по умолчанию недоступно, но закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.

266</Warning>284</Warning>

267 285 

268Установите эти переменные окружения на конкретные ID моделей Amazon Bedrock.286Установите эти переменные окружения на конкретные ID моделей Amazon Bedrock.

269 287 

270Без этих переменных псевдоним `opus` на Amazon Bedrock разрешается на Opus 4.8, а псевдоним `sonnet` разрешается на Sonnet 4.5. Установите каждую переменную для закрепления ее псевдонима на конкретную версию:288Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Amazon Bedrock разрешается на Opus 4.8, а без `ANTHROPIC_DEFAULT_SONNET_MODEL` псевдоним `sonnet` разрешается на Sonnet 4.5. Этот пример закрепляет каждый псевдоним на конкретную версию:

271 289 

272```bash theme={null}290```bash theme={null}

273export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'291export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'


280Claude Code использует эти модели по умолчанию, когда переменные закрепления не установлены:298Claude Code использует эти модели по умолчанию, когда переменные закрепления не установлены:

281 299 

282| Тип модели | Значение по умолчанию |300| Тип модели | Значение по умолчанию |

283| :------------------- | :----------------------------- |301| :------------------- | :--------------------------------------------- |

284| Основная модель | `us.anthropic.claude-opus-4-8` |302| Основная модель | `us.anthropic.claude-opus-4-8` |

285| Малая/быстрая модель | То же, что и основная модель |303| Малая/быстрая модель | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |

304 

305Фоновые задачи, такие как генерация заголовка сеанса, используют малую/быструю модель, обычно модель класса Haiku. На Amazon Bedrock Claude Code использует модель Sonnet по умолчанию для фоновых задач, потому что Haiku может быть не включен в каждой учетной записи или регионе. Два выбора изменяют, какая модель их выполняет:

286 306 

287Фоновые задачи, такие как генерация заголовка сеанса, используют малую/быструю модель, обычно модель класса Haiku. На Amazon Bedrock Claude Code по умолчанию использует основную модель, потому что Haiku может быть не включен в каждой учетной записи или регионе. Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на ID модели, который доступен в вашей учетной записи.307* Когда вы выбираете основную модель с `--model`, `ANTHROPIC_MODEL` или параметром `model`, фоновые задачи используют эту модель. Установка `ANTHROPIC_DEFAULT_OPUS_MODEL` без `ANTHROPIC_DEFAULT_SONNET_MODEL` также считается выбором, потому что встроенная модель Sonnet может быть не включена в учетной записи, которая управляет своим собственным Opus.

308* Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на ID модели, который доступен в вашей учетной записи.

309 

310<Warning>

311 Модели Opus имеют более высокую цену за токен, чем модели Sonnet, поэтому развертывание, которое не закрепляет основную модель, выставляется по тарифу Opus после обновления до версии 2.1.207 или позже. Чтобы сохранить Sonnet 4.5 в качестве основной модели, установите `ANTHROPIC_MODEL` на его полный ID модели. Развертывание, которое управляет значением по умолчанию с помощью `ANTHROPIC_DEFAULT_SONNET_MODEL` и не устанавливает `ANTHROPIC_DEFAULT_OPUS_MODEL`, сохраняет свою управляемую модель Sonnet в качестве значения по умолчанию.

312</Warning>

313 

314{/* min-version: 2.1.207 */}До версии 2.1.207 основная модель на Amazon Bedrock по умолчанию была Sonnet 4.5, псевдоним `opus` разрешался на Opus 4.6, и фоновые задачи всегда использовали основную модель.

288 315 

289Для дальнейшей настройки моделей используйте один из этих методов:316Для дальнейшей настройки моделей используйте один из этих методов:

290 317 


336 363 

337Если вы закрепили версию модели, которая старше текущего значения по умолчанию Claude Code, и ваша учетная запись может вызывать более новую версию, Claude Code предлагает вам обновить закрепление. Принятие записывает новый ID модели в ваш [файл параметров пользователя](/ru/settings) и перезапускает Claude Code. Отклонение запоминается до следующего изменения версии по умолчанию. Закрепления, указывающие на [ARN профиля вывода приложения](#map-each-model-version-to-an-inference-profile), пропускаются, так как они управляются вашим администратором.364Если вы закрепили версию модели, которая старше текущего значения по умолчанию Claude Code, и ваша учетная запись может вызывать более новую версию, Claude Code предлагает вам обновить закрепление. Принятие записывает новый ID модели в ваш [файл параметров пользователя](/ru/settings) и перезапускает Claude Code. Отклонение запоминается до следующего изменения версии по умолчанию. Закрепления, указывающие на [ARN профиля вывода приложения](#map-each-model-version-to-an-inference-profile), пропускаются, так как они управляются вашим администратором.

338 365 

339Если вы не закрепили модель и текущее значение по умолчанию недоступно в вашей учетной записи, Claude Code возвращается к предыдущей версии для текущего сеанса и показывает уведомление. Возврат не сохраняется. Включите более новую модель в вашей учетной записи Amazon Bedrock или [закрепите версию](#4-pin-model-versions), чтобы сделать выбор постоянным.366Если вы не закрепили модель и текущее значение по умолчанию недоступно в вашей учетной записи, Claude Code возвращается к предыдущей версии для текущего сеанса и показывает уведомление. Оно сначала пытается использовать более ранние версии модели по умолчанию и, когда модель по умолчанию является моделью Opus и ни одна версия Opus недоступна, возвращается к модели Sonnet по умолчанию. Возврат не сохраняется. Включите более новую модель в вашей учетной записи Amazon Bedrock или [закрепите версию](#4-pin-model-versions), чтобы сделать выбор постоянным.

340 367 

341<h2 id="iam-configuration">368<h2 id="iam-configuration">

342 Конфигурация IAM369 Конфигурация IAM


397 Окно контекста 1M токенов424 Окно контекста 1M токенов

398</h2>425</h2>

399 426 

400Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [окно контекста 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window) на Amazon Bedrock. Sonnet 5 обслуживается через [конечную точку Mantle](#use-the-mantle-endpoint) и всегда работает с окном 1M, без варианта `[1m]` для выбора. Для других моделей Claude Code автоматически включает расширенное окно контекста при выборе варианта модели 1M.427Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [окно контекста 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) на Amazon Bedrock. Sonnet 5 обслуживается через [конечную точку Mantle](#use-the-mantle-endpoint) и всегда работает с окном 1M, без варианта `[1m]` для выбора. Для других моделей Claude Code автоматически включает расширенное окно контекста при выборе варианта модели 1M.

401 428 

402[Мастер установки](#sign-in-with-bedrock) предлагает опцию контекста 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели вместо этого, добавьте `[1m]` к ID модели. См. [Pin models for third-party deployments](/ru/model-config#pin-models-for-third-party-deployments) для получения подробной информации.429[Мастер установки](#sign-in-with-bedrock) предлагает опцию контекста 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели вместо этого, добавьте `[1m]` к ID модели. См. [Pin models for third-party deployments](/ru/model-config#pin-models-for-third-party-deployments) для получения подробной информации.

403 430 


538 565 

539Claude Code использует Amazon Bedrock [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) и не поддерживает Converse API.566Claude Code использует Amazon Bedrock [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) и не поддерживает Converse API.

540 567 

568<h3 id="streaming-errors-behind-a-gateway-or-proxy">

569 Ошибки потоковой передачи за шлюзом или прокси

570</h3>

571 

572Если запросы потоковой передачи завершаются с ошибкой, которая начинается с `Bedrock streaming response has content-type`, шлюз или прокси между Claude Code и Amazon Bedrock преобразует ответ потоковой передачи. Amazon Bedrock передает ответы в двоичном формате event-stream с типом содержимого `application/vnd.amazon.eventstream`, и Claude Code отклоняет успешный ответ потоковой передачи, который сообщает о другом типе содержимого вместо декодирования тела, которое он не может прочитать. Ошибка называет тип содержимого, который она получила, обычно `text/event-stream` из интеграции Amazon API Gateway и Lambda, которая повторно передает поток как события, отправляемые сервером.

573 

574До версии v2.1.208 та же неправильная конфигурация проявлялась как `API Error: Truncated event message received` после того, как весь ответ был буферизирован.

575 

576Чтобы исправить это, настройте шлюз на передачу тела ответа `InvokeModelWithResponseStream` и его заголовка `Content-Type` без изменений. Если шлюз переписывает только заголовок и передает двоичное тело без изменений, установите [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/ru/env-vars), чтобы пропустить проверку до исправления шлюза. С отключенной проверкой тело ответа, которое было преобразовано, снова завершается с ошибкой `Truncated event message received`.

577 

541<h3 id="zero-token-counts-in-/context">578<h3 id="zero-token-counts-in-/context">

542 Нулевые подсчеты токенов в /context579 Нулевые подсчеты токенов в /context

543</h3>580</h3>

analytics.md +1 −1

Details

228 Доступ к данным программным способом228 Доступ к данным программным способом

229</h4>229</h4>

230 230 

231На плане Enterprise [Claude Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) возвращает отчёты об участии, использовании и затратах на пользователя для вашей организации на всех поверхностях Claude, включая Claude Code. Основной владелец создаёт ключ с областью `read:analytics` на [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys). API недоступен на плане Teams.231На плане Enterprise [Claude Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) возвращает отчёты об участии, использовании и затратах на пользователя для вашей организации на всех поверхностях Claude, включая Claude Code. Основной владелец создаёт ключ с областью `read:analytics` на [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys). API недоступен на плане Teams.

232 232 

233Для запроса этих данных через GitHub ищите PR, помеченные как `claude-code-assisted`.233Для запроса этих данных через GitHub ищите PR, помеченные как `claude-code-assisted`.

234 234 

artifacts.md +87 −23

Details

4 4 

5# Поделитесь выходом сеанса как артефактами5# Поделитесь выходом сеанса как артефактами

6 6 

7> Артефакты превращают работу Claude Code в живые интерактивные страницы по приватному URL на claude.ai.7> Артефакты превращают работу Claude Code в живые интерактивные страницы на claude.ai, которые вы можете держать в приватности, делиться с вашей организацией или публиковать по общедоступной ссылке.

8 8 

9{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}9{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}

10 10 


12 Артефакты доступны на планах Pro, Max, Team и Enterprise и требуют сеанс, вошедший с помощью [`/login`](/ru/setup#authenticate). Полный набор требований см. в разделе [Доступность](#availability).12 Артефакты доступны на планах Pro, Max, Team и Enterprise и требуют сеанс, вошедший с помощью [`/login`](/ru/setup#authenticate). Полный набор требований см. в разделе [Доступность](#availability).

13</Note>13</Note>

14 14 

15Артефакт — это живая интерактивная веб-страница, которую Claude Code публикует из вашего сеанса на приватный URL на claude.ai. Вы открываете её в браузере, и она обновляется на месте по мере продолжения сеанса. На планах Team и Enterprise поделитесь ею из заголовка страницы, когда захотите, чтобы коллега её увидел. Например, используйте артефакт, чтобы провести рецензента через pull request с аннотированными diff'ами, создать панель управления из данных сеанса или вести временную шкалу расследования, которая заполняется по мере работы Claude.15Артефакт — это живая интерактивная веб-страница, которую Claude Code публикует из вашего сеанса на приватный URL на claude.ai. Вы открываете её в браузере, и она обновляется на месте по мере продолжения сеанса. Поделитесь ею из заголовка страницы, когда захотите, чтобы кто-то ещё её увидел. Например, используйте артефакт, чтобы провести рецензента через pull request с аннотированными diff'ами, создать панель управления из данных сеанса или вести временную шкалу расследования, которая заполняется по мере работы Claude.

16 16 

17<Frame>17<Frame>

18 <img src="https://mintcdn.com/claude-code/kaHIYYMIYMYPxQg9/images/artifacts-viewer.png?fit=max&auto=format&n=kaHIYYMIYMYPxQg9&q=85&s=dbfd671cdb0d15f49f808b9e89778fe1" alt="Артефакт открыт в браузере на claude.ai/code/artifact. Заголовок средства просмотра показывает название артефакта acme-funnel-fix, кнопку Share и аватар автора. Меню Share открыто с переключателем Always share latest version, средством выбора версии, показывающим Sharing version 2, селектором аудитории Everyone at Acme и кнопкой Copy link. Ниже заголовка страница артефакта показывает два макета мобильных устройств рядом, диаграмму воронки и строку карточек метрик." width="2511" height="1890" data-path="images/artifacts-viewer.png" />18 <img src="https://mintcdn.com/claude-code/kaHIYYMIYMYPxQg9/images/artifacts-viewer.png?fit=max&auto=format&n=kaHIYYMIYMYPxQg9&q=85&s=dbfd671cdb0d15f49f808b9e89778fe1" alt="Артефакт открыт в браузере на claude.ai/code/artifact. Заголовок средства просмотра показывает название артефакта acme-funnel-fix, кнопку Share и аватар автора. Меню Share открыто с переключателем Always share latest version, средством выбора версии, показывающим Sharing version 2, селектором аудитории Everyone at Acme и кнопкой Copy link. Ниже заголовка страница артефакта показывает два макета мобильных устройств рядом, диаграмму воронки и строку карточек метрик." width="2511" height="1890" data-path="images/artifacts-viewer.png" />

19</Frame>19</Frame>

20 20 

21<h2 id="when-to-use-an-artifact">21<h2 id="when-to-use-an-artifact">

22 When to use an artifact22 Когда использовать артефакт

23</h2>23</h2>

24 24 

25Используйте артефакт, когда текст терминала — неправильный способ для того, что создал Claude: вывод, который легче смотреть и с которым взаимодействовать, чем читать строка за строкой. Claude создаёт страницу из всего, что может достичь ваш сеанс, включая вашу кодовую базу и данные, которые он получает через ваши [подключённые инструменты](/ru/mcp), поэтому страница может показывать вещи, которые потребовали бы абзацев для описания. Например, попросите Claude:25Используйте артефакт, когда текст терминала — неправильный способ для того, что создал Claude: вывод, который легче смотреть и с которым взаимодействовать, чем читать строка за строкой. Claude создаёт страницу из всего, что может достичь ваш сеанс, включая вашу кодовую базу и данные, которые он получает через ваши [подключённые инструменты](/ru/mcp), поэтому страница может показывать вещи, которые потребовали бы абзацев для описания. Например, попросите Claude:


29* Расположить несколько вариантов дизайна или реализации рядом29* Расположить несколько вариантов дизайна или реализации рядом

30* Вести временную шкалу расследования, которая заполняется во время выполнения длительной задачи30* Вести временную шкалу расследования, которая заполняется во время выполнения длительной задачи

31* Отправить коллеге ссылку вместо вставки вывода в Slack31* Отправить коллеге ссылку вместо вставки вывода в Slack

32* Опубликовать доску статуса, которая [получает свежие данные через MCP connectors](#pull-live-data-with-mcp-connectors) каждый раз, когда кто-то её открывает

32 33 

33См. [Что вы можете создать](#what-you-can-build) для подсказок, которые соответствуют каждому из этих вариантов.34См. [Что вы можете создать](#what-you-can-build) для подсказок, которые соответствуют этим вариантам, и [Получение живых данных с помощью MCP connectors](#pull-live-data-with-mcp-connectors) для подсказки доски с поддержкой connectors.

34 35 

35<h3 id="what-an-artifact-is-not">36<h3 id="what-an-artifact-is-not">

36 What an artifact is not37 Что артефакт не является

37</h3>38</h3>

38 39 

39Артефакт — это снимок работы, а не приложение. Это одна самодостаточная страница без бэкенда, поэтому она не может сохранять ввод формы, вызывать API во время просмотра или обслуживать несколько маршрутов. Для размещённого внутреннего инструмента с бэкендом разверните его на вашей собственной инфраструктуре. Полный набор ограничений см. в разделе [Ограничения страницы](#page-constraints).40Артефакт — это снимок работы, а не приложение. Это одна самодостаточная страница без бэкенда, поэтому она не может сохранять ввод формы или обслуживать несколько маршрутов, и её единственный путь к внешним данным, когда кто-то её просматривает, — это [вызов MCP connectors](#pull-live-data-with-mcp-connectors). Для размещённого внутреннего инструмента с бэкендом разверните его на вашей собственной инфраструктуре. Полный набор ограничений см. в разделе [Ограничения страницы](#page-constraints).

40 41 

41<h2 id="create-an-artifact">42<h2 id="create-an-artifact">

42 Create an artifact43 Create an artifact


81```82```

82 83 

83<h2 id="share-an-artifact">84<h2 id="share-an-artifact">

84 Share an artifact85 Поделиться артефактом

85</h2>86</h2>

86 87 

87Новый артефакт видим только вам. На планах Pro и Max артефакты остаются приватными для вас. На планах Team и Enterprise откройте артефакт в браузере и используйте элемент управления **Share** в заголовке страницы, чтобы предоставить доступ определённым людям в вашей организации или всем в ней. Заголовок называет вас автором артефакта, поэтому любой, с кем вы поделитесь, может увидеть, кто опубликовал страницу. Он также ссылается на вашу галерею на [claude.ai/code/artifacts](https://claude.ai/code/artifacts), которая перечисляет каждый артефакт, который вы создали.88Новый артефакт видим только вам. Чтобы поделиться им, откройте артефакт в браузере и используйте элемент управления **Share** в заголовке страницы. Заголовок указывает вас как автора артефакта, поэтому любой, с кем вы поделитесь, может увидеть, кто опубликовал страницу. Он также ссылается на вашу галерею на [claude.ai/code/artifacts](https://claude.ai/code/artifacts), которая содержит список всех созданных вами артефактов.

88 89 

89Совместное использование останавливается на вашей организации. Зрители должны войти на claude.ai как члены той же организации, которая опубликовала артефакт, и нет возможности сделать артефакт видимым вне её. Чтобы отправить базовое содержимое кому-то вне вашей организации, попросите Claude файл HTML и поделитесь этим файлом напрямую.90С кем вы можете поделиться, зависит от вашего плана:

90 91 

91Артефакты доступны для просмотра, а не для совместного редактирования. Люди, с которыми вы поделитесь, видят каждую версию, которую вы публикуете, но не могут изменять страницу; вы остаётесь единственным автором.92* **В пределах вашей организации**: в планах Team и Enterprise предоставьте доступ определённым людям в вашей организации или всем в ней. Зрители входят в claude.ai как члены вашей организации, чтобы увидеть страницу.

93* **Публично**: поделитесь ссылкой, которую может открыть любой в интернете, без необходимости входа в claude.ai. В планах Pro и Max публичная ссылка — единственный способ поделиться артефактом. В планах Team и Enterprise публичный доступ отключён до тех пор, пока владелец не [включит его для организации](#control-public-sharing).

94 

95<h3 id="let-someone-edit-with-you">

96 Позвольте кому-то редактировать вместе с вами

97</h3>

98 

99Люди, с которыми вы поделитесь, по умолчанию являются зрителями: они видят каждую опубликованную вами версию, но не могут изменять страницу. В планах Team и Enterprise вы также можете сделать кого-то редактором. В диалоговом окне общего доступа добавьте человека и измените его роль с **viewer** на **editor**.

100 

101Редактор публикует новые версии так же, как вы [обновляете артефакт из другого сеанса](#update-an-artifact): он предоставляет Claude URL артефакта в своём сеансе, и Claude извлекает текущее содержимое и переиздаёт его с его изменениями. Все, у кого открыта страница, видят каждое обновление в реальном времени.

102 

103<h2 id="pull-live-data-with-mcp-connectors">

104 Получение живых данных с помощью MCP connectors

105</h2>

106 

107{/* plan-availability: feature=artifact-mcp plans=pro,max,team,enterprise providers=anthropic */}

108 

109Артефакт может вызывать [MCP connectors](/ru/mcp#use-mcp-servers-from-claude-ai) каждый раз, когда кто-то его просматривает, поэтому страница отображает текущие данные, а не снимок из сеанса, в котором она была создана. Вызовы connectors из артефактов доступны в планах Pro, Max, Team и Enterprise и требуют Claude Code версии 2.1.209 или более поздней. В более ранних версиях Claude публикует страницу с теми данными, которые сеанс собрал во время её создания.

110 

111Чтобы создать страницу с поддержкой connector, назовите connector и данные, которые вам нужны, в вашем запросе:

112 

113```text wrap theme={null}

114Build a dashboard artifact of our open pull requests that pulls the live list through my GitHub connector when the page loads.

115```

116 

117Claude объявляет, какие connectors может вызывать страница, как часть публикации, и страница не может вызывать connectors вне этого объявления. Только connectors из вашей учётной записи claude.ai подходят: Claude называет их в объявлении, и когда кто-то просматривает страницу, каждый вызов [выполняется через собственное подключение учётной записи просмотра](#how-connector-calls-work-for-viewers) к этому connector. Локальные MCP servers, которые вы настраиваете в Claude Code, такие как servers из `.mcp.json`, могут предоставлять данные во время создания страницы Claude, но опубликованная страница не может их вызывать.

118 

119Страница получает данные при загрузке и может обновляться по расписанию или когда зритель использует элемент управления обновлением на странице. Ответы кэшируются в браузере зрителя, поэтому повторно открытая страница отображается из кэшированных ответов немедленно, а затем обновляется с новыми результатами.

120 

121<h3 id="how-connector-calls-work-for-viewers">

122 Как работают вызовы connector для зрителей

123</h3>

124 

125Когда опубликованная страница вызывает connector, вызов использует учётную запись человека, просматривающего страницу, а не учётную запись человека, который её опубликовал:

126 

127* **Каждый зритель использует свои собственные connectors**: вызовы проходят через подключённые инструменты учётной записи просмотра, поэтому два человека, открывающие одну и ту же панель управления, могут видеть разные данные в зависимости от того, к чему имеют доступ их учётные записи. Страница никогда не видит учётные данные кого-либо; claude.ai делает вызовы от имени страницы.

128* **Зрители сначала одобряют доступ**: claude.ai просит разрешение у каждого зрителя перед первым вызовом connector страницы. Зритель, который отказывает, или у которого нет подключённого connector, который использует страница, всё равно видит страницу без её живых разделов.

129* **Действия также используют учётную запись зрителя**: страница может предлагать элементы управления, которые вызывают инструменты connector с побочными эффектами, такие как отправка сообщения или обновление проблемы. Действие выполняется через учётную запись того, кто выбирает элемент управления.

130 

131Когда вы планируете поделиться страницей с поддержкой connector, попросите Claude включить резервное сообщение в каждый живой раздел, который называет connector, который ему нужен. Зритель, у которого отсутствует подключение, затем видит, что нужно подключить, вместо пустого раздела.

132 

133Артефакт, который вызывает connectors, не может быть общим для публичной ссылки ни в одном плане. В планах Team и Enterprise вы можете оставить его приватным или [поделиться им в пределах вашей организации](#share-an-artifact). В планах Pro и Max, где публичная ссылка — единственный способ поделиться, артефакт с поддержкой connector остаётся приватным для вас.

134 

135<h3 id="the-page-shows-no-live-data-for-a-viewer">

136 Страница не показывает живые данные для зрителя

137</h3>

138 

139Когда страница с поддержкой connector отображается, но её живые разделы остаются пустыми для кого-то, с кем вы её поделились, проработайте эти причины:

140 

141* **Зритель не подключил connector**: connectors привязаны к учётной записи, поэтому каждому зрителю нужно своё подключение к каждому connector, который вызывает страница. Они могут добавить его в разделе **Settings > Connectors** на claude.ai, а затем перезагрузить страницу.

142* **Зритель отказал в разрешении**: отказ действует до конца этой загрузки страницы. Перезагрузка страницы возвращает запрос разрешения.

143* **Вызовы connector отключены для организации**: владелец управляет переключателем [**Enable artifact connectors**](#control-connector-calls-from-artifacts) в параметрах администратора.

92 144 

93<h2 id="what-you-can-build">145<h2 id="what-you-can-build">

94 What you can build146 What you can build


147```199```

148 200 

149<h2 id="improve-the-visual-design">201<h2 id="improve-the-visual-design">

150 Improve the visual design202 Улучшение визуального дизайна

151</h2>203</h2>

152 204 

153Claude применяет встроенный навык дизайна при создании артефакта, поэтому страницы получают намеренную палитру, типографику и макет без дополнительных подсказок. Этот навык также ищет существующую систему дизайна в вашем проекте перед выбором своей собственной. Чтобы сохранить артефакты согласованными с брендингом вашего продукта, запишите ваши токены дизайна там, где Claude может их найти, например в [CLAUDE.md](/ru/memory) проекта или в файле темы в вашем репозитории:205Начиная с Claude Code v2.1.183, Claude применяет встроенный навык дизайна при создании артефакта, поэтому страницы получают намеренную палитру, типографику и макет без дополнительных подсказок. Этот навык также ищет существующую систему дизайна в вашем проекте перед выбором своей собственной. Чтобы сохранить артефакты согласованными с брендингом вашего продукта, запишите ваши токены дизайна там, где Claude может их найти, например в [CLAUDE.md](/ru/memory) проекта или в файле темы в вашем репозитории:

154 206 

155```markdown theme={null}207```markdown theme={null}

156## Design system208## Design system


169Каждый артефакт — это одна самодостаточная страница. Claude Code оборачивает файл, который вы публикуете, в оболочку HTML-документа и обслуживает его в соответствии со строгой политикой безопасности контента (CSP), которая формирует то, что может делать страница.221Каждый артефакт — это одна самодостаточная страница. Claude Code оборачивает файл, который вы публикуете, в оболочку HTML-документа и обслуживает его в соответствии со строгой политикой безопасности контента (CSP), которая формирует то, что может делать страница.

170 222 

171| Constraint | Effect |223| Constraint | Effect |

172| :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |224| :------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

173| No external requests | CSP блокирует скрипты, таблицы стилей, шрифты и изображения, загруженные с любого другого хоста, а также вызовы `fetch`, XHR и WebSocket. Claude встраивает CSS и JavaScript и встраивает изображения как data URI, чтобы страница отображалась без каких-либо внешних запросов. |225| No external requests | CSP блокирует скрипты, таблицы стилей, шрифты и изображения, загруженные с любого другого хоста, а также вызовы `fetch`, XHR и WebSocket. Claude встраивает CSS и JavaScript и встраивает изображения как data URI, чтобы страница отображалась без каких-либо внешних запросов. [Вызовы Connector](#pull-live-data-with-mcp-connectors) — исключение: страница передаёт их на claude.ai, который сам выполняет сетевой вызов. |

174| No backend | Артефакт — это статическая страница. Она не может сохранять данные, отправленные через форму, аутентифицировать зрителей самостоятельно или вызывать API во время просмотра. |226| No backend | Артефакт — это статическая страница. Она не может сохранять данные, отправленные через форму, или самостоятельно аутентифицировать зрителей. Её единственный способ получить данные при просмотре — это [вызов MCP connectors](#pull-live-data-with-mcp-connectors), а не собственный API. |

175| Single page | Относительные ссылки не разрешаются, потому что ничего не развёрнуто рядом со страницей. Для многосекционного содержимого Claude использует якоря на странице вместо отдельных файлов. |227| Single page | Относительные ссылки не разрешаются, потому что ничего не развёрнуто рядом со страницей. Для многосекционного содержимого Claude использует якоря на странице вместо отдельных файлов. |

176| Source file types | Опубликованный файл должен быть `.html`, `.htm` или `.md`. Файлы Markdown отображаются как стилизованный HTML. |228| Source file types | Опубликованный файл должен быть `.html`, `.htm` или `.md`. Файлы Markdown отображаются как стилизованный HTML. |

177| Rendered size | Отображаемая страница должна быть размером 16 МиБ или меньше. Большие встроенные изображения — обычная причина, когда публикация не удаётся из-за размера. |229| Rendered size | Отображаемая страница должна быть размером 16 МиБ или меньше. Большие встроенные изображения — обычная причина, когда публикация не удаётся из-за размера. |


186 Availability238 Availability

187</h2>239</h2>

188 240 

189Артефакты требуют каждого условия ниже. Когда одно из них не выполнено, Claude записывает локальный файл HTML или говорит, что не может опубликовать.241Артефакты требуют каждого условия ниже. Когда одно из них не выполнено, Claude записывает локальный файл HTML или говорит, что не может опубликовать вместо этого.

190 242 

191| Requirement | Available when |243| Requirement | Available when |

192| :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |244| :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

193| Plan | Pro, Max, Team или Enterprise. На планах Pro и Max артефакты являются приватными для вас, и управление администратором не применяется. На планах Team артефакты включены по умолчанию. На планах Enterprise администратор [включает их](#manage-artifacts-for-your-organization) в параметрах администратора claude.ai. |245| Plan | Pro, Max, Team или Enterprise. На планах Pro и Max артефакты являются приватными для вас до тех пор, пока вы их не поделитесь, и управление администратором не применяется. На планах Team артефакты включены по умолчанию. На планах Enterprise владелец [включает их](#manage-artifacts-for-your-organization) в параметрах администратора claude.ai. |

194| Authentication | Вошли на claude.ai с помощью `/login`. Сеансы, использующие ключ API, [токен шлюза](/ru/llm-gateway) или учётные данные поставщика облачных услуг, не могут публиковать. |246| Authentication | Сеанс поддерживается учётной записью claude.ai: войдите с помощью `/login` в CLI или приложении для рабочего стола. Сеансы Claude Tag вошли через идентификацию агента, поэтому никаких шагов не требуется. Сеансы, использующие ключ API, [токен шлюза](/ru/llm-gateway) или учётные данные поставщика облачных услуг, не могут публиковать. |

195| Model provider | Anthropic API. Недоступно на [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry). |247| Model provider | Anthropic API. Недоступно на [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry). |

196| Organization policy | Ключи шифрования, управляемые клиентом (CMEK), HIPAA и [Zero Data Retention](/ru/zero-data-retention) не включены для организации. |248| Organization policy | Ключи шифрования, управляемые клиентом (CMEK), HIPAA и [Zero Data Retention](/ru/zero-data-retention) не включены для организации. |

197| Surface | Claude Code CLI или приложение Claude для рабочего стола версии 1.13576.0 или позже. По умолчанию отключено в контекстах [Agent SDK](/ru/agent-sdk/overview), GitHub Action и MCP-server, а также когда установлен [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/ru/env-vars). |249| Surface | Claude Code CLI версии 2.1.183 или позже, или приложение Claude для рабочего стола версии 1.13576.0 или позже. Сеансы [Claude Tag](https://claude.com/docs/claude-tag/overview) также могут публиковать артефакты, когда оба Claude Tag и артефакты включены для организации. По умолчанию отключено в контекстах [Agent SDK](/ru/agent-sdk/overview), GitHub Action и MCP-server, а также когда установлен [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/ru/env-vars). |

198 250 

199<h2 id="disable-artifacts">251<h2 id="disable-artifacts">

200 Отключение артефактов252 Отключение артефактов


212 Управление артефактами для вашей организации264 Управление артефактами для вашей организации

213</h2>265</h2>

214 266 

215Владельцы планов Team и Enterprise управляют артефактами из [параметров администратора claude.ai](https://claude.ai/admin-settings/claude-code). Содержимое артефактов хранится на инфраструктуре, управляемой Anthropic, и видно только аутентифицированным членам организации-издателя.267Владельцы планов Team и Enterprise управляют артефактами из [параметров администратора claude.ai](https://claude.ai/admin-settings/claude-code). Содержимое артефактов хранится на инфраструктуре, управляемой Anthropic, и видно только аутентифицированным членам организации-издателя, если только артефакт не [опубликован публично](#control-public-sharing).

216 268 

217<h3 id="enable-or-disable-artifacts">269<h3 id="enable-or-disable-artifacts">

218 Включение или отключение артефактов270 Включение или отключение артефактов


220 272 

221Чтобы включить или отключить артефакты для всей организации, перейдите в **Параметры > Claude Code > Возможности** и используйте переключатель **Артефакты**. На планах Enterprise с управлением доступом на основе ролей вы можете дополнительно ограничить артефакты определёнными ролями: перейдите в **Параметры > Роли**, отредактируйте роль и установите разрешение **Артефакты** в группе **Claude Code**.273Чтобы включить или отключить артефакты для всей организации, перейдите в **Параметры > Claude Code > Возможности** и используйте переключатель **Артефакты**. На планах Enterprise с управлением доступом на основе ролей вы можете дополнительно ограничить артефакты определёнными ролями: перейдите в **Параметры > Роли**, отредактируйте роль и установите разрешение **Артефакты** в группе **Claude Code**.

222 274 

275<h3 id="control-connector-calls-from-artifacts">

276 Управление вызовами соединителей из артефактов

277</h3>

278 

279[Вызовы соединителей из артефактов](#pull-live-data-with-mcp-connectors) имеют собственный переключатель, отдельный от переключателя **Артефакты**, который включает или отключает артефакты. Перейдите в [**Параметры > Возможности**](https://claude.ai/admin-settings/capabilities) и используйте переключатель **Включить соединители артефактов**. Один и тот же переключатель управляет вызовами соединителей из артефактов, созданных в беседах claude.ai, поэтому он находится в **Параметры > Возможности**, а не в **Параметры > Claude Code**.

280 

281<h3 id="control-public-sharing">

282 Управление публичным совместным использованием

283</h3>

284 

285Публичное совместное использование отключено по умолчанию на планах Team и Enterprise, поэтому члены могут совместно использовать артефакты только внутри организации, пока владелец его не включит. Чтобы позволить членам публиковать артефакты на публичные ссылки, которые может просматривать любой без входа, перейдите в **Параметры > Claude Code > Возможности** и включите **Внешнее совместное использование** под переключателем **Артефакты**. Отключение его обратно блокирует доступ через существующие публичные ссылки без изменения аудитории каждого артефакта; доступ возобновляется, если вы его снова включите.

286 

223<h3 id="set-a-retention-policy">287<h3 id="set-a-retention-policy">

224 Установка политики хранения288 Установка политики хранения

225</h3>289</h3>


253Для схем запроса и ответа см. [справочник API соответствия](https://docs.claude.com/en/api/compliance/code/artifacts).317Для схем запроса и ответа см. [справочник API соответствия](https://docs.claude.com/en/api/compliance/code/artifacts).

254 318 

255<h2 id="related-resources">319<h2 id="related-resources">

256 Related resources320 Связанные ресурсы

257</h2>321</h2>

258 322 

259* Просмотрите [шаблоны подсказок и рабочие процессы](/ru/prompt-library), которые сочетаются с артефактами323* Просмотрите [шаблоны подсказок и рабочие процессы](/ru/prompt-library), которые сочетаются с артефактами

260* Превратите подсказку артефакта, которую вы повторно используете, в [skill](/ru/skills), чтобы вы могли вызвать её как команду324* Превратите подсказку артефакта, которую вы повторно используете, в [skill](/ru/skills), чтобы вы могли вызвать её как команду

261* [Подключите серверы MCP](/ru/mcp), чтобы Claude мог получить живые данные в артефакт325* [Подключите серверы MCP](/ru/mcp), чтобы Claude мог получить данные в артефакт во время его создания

Details

18 18 

19Если ваш браузер показывает код входа вместо перенаправления после входа, вставьте его в терминал в приглашение `Paste code here if prompted`. Это происходит, когда браузер не может достичь локального сервера обратного вызова Claude Code, что часто встречается в WSL2, сеансах SSH и контейнерах.19Если ваш браузер показывает код входа вместо перенаправления после входа, вставьте его в терминал в приглашение `Paste code here if prompted`. Это происходит, когда браузер не может достичь локального сервера обратного вызова Claude Code, что часто встречается в WSL2, сеансах SSH и контейнерах.

20 20 

21Когда вход завершится, терминал отобразит `Login successful` и предложит вам нажать `Enter` для продолжения.

22 

21Вы можете аутентифицироваться с помощью любого из этих типов учетных записей:23Вы можете аутентифицироваться с помощью любого из этих типов учетных записей:

22 24 

23* **Подписка Claude Pro или Max**: войдите с помощью вашей учетной записи Claude.ai. Подпишитесь на [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).25* **Подписка Claude Pro или Max**: войдите с помощью вашей учетной записи Claude.ai. Подпишитесь на [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).

24* **Claude for Teams или Enterprise**: войдите с помощью учетной записи Claude.ai, на которую вас пригласил администратор вашей команды.26* **Claude for Teams или Enterprise**: войдите с помощью учетной записи Claude.ai, на которую вас пригласил администратор вашей команды.

25* **Claude Console**: войдите с помощью ваших учетных данных Console. Ваш администратор должен был [пригласить вас](#claude-console-authentication) предварительно.27* **Claude Console**: войдите с помощью ваших учетных данных Console. Ваш администратор должен был [пригласить вас](#claude-console-authentication) предварительно.

26* **Облачные провайдеры**: если ваша организация использует [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry), установите необходимые переменные окружения перед запуском `claude`. Вход через браузер не требуется.28* **Облачные провайдеры**: если ваша организация использует [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry), установите необходимые переменные окружения перед запуском `claude`, или выберите **3rd-party platform** в приглашении входа, которое запускает интерактивный мастер настройки для Bedrock и Vertex AI. Вход через браузер не требуется.

27* **Облачный шлюз**: если ваша организация запускает самостоятельно размещенный [шлюз приложений Claude](/ru/claude-apps-gateway), войдите с помощью корпоративного SSO через `/login`. Токен, выданный шлюзом, является единственным учетным данием сеанса.29* **Облачный шлюз**: если ваша организация запускает самостоятельно размещенный [шлюз приложений Claude](/ru/claude-apps-gateway), войдите с помощью корпоративного SSO через `/login`. Токен, выданный шлюзом, является единственным учетным данием сеанса.

28 30 

29Чтобы выйти и повторно аутентифицироваться, введите `/logout` в приглашение Claude Code.31Администраторы могут ограничить интерактивный вход с помощью управляемых параметров [`forceLoginMethod` и `forceLoginOrgUUID`](/ru/settings#available-settings). Когда установлен один из них, сеансы, аутентифицированные с помощью `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске; сеансы облачных провайдеров не затрагиваются.

32 

33Чтобы выйти и повторно аутентифицироваться, введите `/logout` в приглашение Claude Code. Выход также сбрасывает состояние первоначальной настройки, поэтому при следующем запуске `claude` вас проведут через вход и настройку снова.

30 34 

31Если у вас возникли проблемы с входом, см. [устранение неполадок аутентификации](/ru/troubleshoot-install#login-and-authentication).35Если у вас возникли проблемы с входом, см. [устранение неполадок аутентификации](/ru/troubleshoot-install#login-and-authentication).

32 36 


133 * На Windows учетные данные хранятся в `%USERPROFILE%\.claude\.credentials.json` и наследуют элементы управления доступом из каталога профиля пользователя, что по умолчанию ограничивает доступ к файлу вашей учетной записью.137 * На Windows учетные данные хранятся в `%USERPROFILE%\.claude\.credentials.json` и наследуют элементы управления доступом из каталога профиля пользователя, что по умолчанию ограничивает доступ к файлу вашей учетной записью.

134 * Если вы установили переменную окружения `CLAUDE_CONFIG_DIR` на Linux или Windows, файл `.credentials.json` находится в этом каталоге.138 * Если вы установили переменную окружения `CLAUDE_CONFIG_DIR` на Linux или Windows, файл `.credentials.json` находится в этом каталоге.

135 * Claude Code управляет `.credentials.json` через `/login` и `/logout`. Чтобы маршрутизировать запросы через пользовательскую конечную точку API, установите переменную окружения [`ANTHROPIC_BASE_URL`](/ru/env-vars).139 * Claude Code управляет `.credentials.json` через `/login` и `/logout`. Чтобы маршрутизировать запросы через пользовательскую конечную точку API, установите переменную окружения [`ANTHROPIC_BASE_URL`](/ru/env-vars).

136* **Поддерживаемые типы аутентификации**: учетные данные Claude.ai, учетные данные API Claude, Azure Auth, Bedrock Auth, Vertex Auth и токены сеанса [Claude apps gateway](/ru/claude-apps-gateway).140* **Поддерживаемые типы аутентификации**: учетные данные Claude.ai, учетные данные API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth и токены сеанса [Claude apps gateway](/ru/claude-apps-gateway).

137* **Пользовательские скрипты учетных данных**: параметр [`apiKeyHelper`](/ru/settings#available-settings) можно настроить для запуска скрипта оболочки, который возвращает ключ API.141* **Пользовательские скрипты учетных данных**: параметр [`apiKeyHelper`](/ru/settings#available-settings) можно настроить для запуска скрипта оболочки, который возвращает ключ API.

138* **Интервалы обновления**: по умолчанию `apiKeyHelper` вызывается через 5 минут или при ответе HTTP 401. Установите переменную окружения `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` для пользовательских интервалов обновления.142* **Интервалы обновления**: по умолчанию `apiKeyHelper` вызывается через 5 минут или при ответе HTTP 401. Установите переменную окружения `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` для пользовательских интервалов обновления.

139* **Уведомление о медленном помощнике**: если `apiKeyHelper` требует более 10 секунд для возврата ключа, Claude Code отображает предупреждающее уведомление в строке приглашения, показывающее прошедшее время. Если вы видите это уведомление регулярно, проверьте, можно ли оптимизировать ваш скрипт учетных данных.143* **Уведомление о медленном помощнике**: если `apiKeyHelper` требует более 10 секунд для возврата ключа, Claude Code отображает предупреждающее уведомление в строке приглашения, показывающее прошедшее время. Если вы видите это уведомление регулярно, проверьте, можно ли оптимизировать ваш скрипт учетных данных.

144* **Сбои помощника**: {/* min-version: 2.1.208 */}когда скрипт завершается с ошибкой, истекает время ожидания или не выводит ничего, запросы завершаются с ошибкой [`Your apiKeyHelper script is failing`](/ru/errors#your-apikeyhelper-script-is-failing) в течение трех попыток. До версии 2.1.208 сбои помощника отображались как общая ошибка 401 после примерно десяти молчаливых повторных попыток.

140 145 

141`apiKeyHelper`, `ANTHROPIC_API_KEY` и `ANTHROPIC_AUTH_TOKEN` применяются к CLI и поверхностям, которые его оборачивают, включая расширение VS Code, Agent SDK и GitHub Actions. Claude Desktop и облачные сеансы не вызывают `apiKeyHelper` и не читают эти переменные окружения: они используют OAuth, за исключением сеансов рабочего стола, работающих с [конфигурацией вывода третьей стороны, распределяемой организацией](/ru/llm-gateway-connect#desktop-app), которые аутентифицируются с помощью учетных данных этой конфигурации.146`apiKeyHelper`, `ANTHROPIC_API_KEY` и `ANTHROPIC_AUTH_TOKEN` применяются к CLI и поверхностям, которые его оборачивают, включая расширение VS Code, Agent SDK и GitHub Actions. Claude Desktop и облачные сеансы не вызывают `apiKeyHelper` и не читают эти переменные окружения: они используют OAuth, за исключением сеансов рабочего стола, работающих с [конфигурацией вывода третьей стороны](/ru/llm-gateway-connect#desktop-app), которые аутентифицируются с помощью учетных данных этой конфигурации.

142 147 

143<h3 id="renew-an-expiring-login">148<h3 id="renew-an-expiring-login">

144 Обновление истекающего входа149 Обновление истекающего входа


148 153 

149Запустите `/login` для обновления. Предупреждение носит информационный характер и никогда не блокирует запрос: аутентификация продолжает работать до фактического истечения срока действия входа. Сам срок действия входа не изменяется; предварительное предупреждение — это то, что добавляет v2.1.203.154Запустите `/login` для обновления. Предупреждение носит информационный характер и никогда не блокирует запрос: аутентификация продолжает работать до фактического истечения срока действия входа. Сам срок действия входа не изменяется; предварительное предупреждение — это то, что добавляет v2.1.203.

150 155 

156{/* min-version: 2.1.206 */}После истечения срока действия сохраненного входа и невозможности его обновления каждый запрос завершается с ошибкой [`Login expired · Please run /login`](/ru/errors#login-expired) до тех пор, пока вы снова не войдете. До версии 2.1.206 истекший вход отображался как ошибка модели.

157 

151Предупреждение появляется только когда вход claude.ai или Claude Console является активным учетным данием, а не когда облачный провайдер, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper` предоставляет учетные данные.158Предупреждение появляется только когда вход claude.ai или Claude Console является активным учетным данием, а не когда облачный провайдер, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper` предоставляет учетные данные.

152 159 

153Раннее обновление наиболее важно для сеансов, которые работают без присмотра. [Фоновый сеанс в представлении агента](/ru/agent-view) или сеанс [Remote Control](/ru/remote-control), который пережил вход, прекращает прогресс после истечения срока действия учетных данных и не может восстановиться, пока вы снова не войдете.160Раннее обновление наиболее важно для сеансов, которые работают без присмотра. [Фоновый сеанс в представлении агента](/ru/agent-view) или сеанс [Remote Control](/ru/remote-control), который пережил вход, прекращает прогресс после истечения срока действия учетных данных и не может восстановиться, пока вы снова не войдете.


160 167 

1611. Учетные данные облачного провайдера, когда установлены `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` или `CLAUDE_CODE_USE_FOUNDRY`. См. [интеграции третьих сторон](/ru/third-party-integrations) для настройки.1681. Учетные данные облачного провайдера, когда установлены `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` или `CLAUDE_CODE_USE_FOUNDRY`. См. [интеграции третьих сторон](/ru/third-party-integrations) для настройки.

1622. Переменная окружения `ANTHROPIC_AUTH_TOKEN`. Отправляется как заголовок `Authorization: Bearer`. Используйте это при маршрутизации через [шлюз LLM или прокси](/ru/llm-gateway), который аутентифицируется с помощью токенов-носителей, а не ключей API Anthropic.1692. Переменная окружения `ANTHROPIC_AUTH_TOKEN`. Отправляется как заголовок `Authorization: Bearer`. Используйте это при маршрутизации через [шлюз LLM или прокси](/ru/llm-gateway), который аутентифицируется с помощью токенов-носителей, а не ключей API Anthropic.

1633. Переменная окружения `ANTHROPIC_API_KEY`. Отправляется как заголовок `X-Api-Key`. Используйте это для прямого доступа к API Anthropic с ключом из [Claude Console](https://platform.claude.com). В интерактивном режиме вам предлагается один раз одобрить или отклонить ключ, и ваш выбор запоминается. Чтобы изменить его позже, используйте переключатель "Use custom API key" в `/config`. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии.1703. Переменная окружения `ANTHROPIC_API_KEY`. Отправляется как заголовок `X-Api-Key`. Используйте это для прямого доступа к API Anthropic с ключом из [Claude Console](https://platform.claude.com). В интерактивном режиме вам предлагается один раз одобрить или отклонить ключ, и ваш выбор запоминается. Чтобы изменить его позже, используйте переключатель "Use custom API key" в `/config`. Переключатель появляется только при установке `ANTHROPIC_API_KEY` в вашей среде. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии.

1644. Выход скрипта [`apiKeyHelper`](/ru/settings#available-settings). Используйте это для динамических или ротирующихся учетных данных, таких как краткосрочные токены, полученные из хранилища.1714. Выход скрипта [`apiKeyHelper`](/ru/settings#available-settings). Используйте это для динамических или ротирующихся учетных данных, таких как краткосрочные токены, полученные из хранилища.

1655. Переменная окружения `CLAUDE_CODE_OAUTH_TOKEN`. Долгоживущий токен OAuth, созданный [`claude setup-token`](#generate-a-long-lived-token). Используйте это для конвейеров CI и скриптов, где вход через браузер недоступен.1725. Переменная окружения `CLAUDE_CODE_OAUTH_TOKEN`. Долгоживущий токен OAuth, созданный [`claude setup-token`](#generate-a-long-lived-token). Используйте это для конвейеров CI и скриптов, где вход через браузер недоступен.

1666. Учетные данные OAuth подписки из `/login`. Это значение по умолчанию для пользователей Claude Pro, Max, Team и Enterprise.1736. Учетные данные OAuth подписки из `/login`. Это значение по умолчанию для пользователей Claude Pro, Max, Team и Enterprise.

167 174 

168Подписанный сеанс [Claude apps gateway](/ru/claude-apps-gateway) находится вне этого списка: это выбор провайдера, как Amazon Bedrock или Google Cloud's Agent Platform, и он имеет приоритет над ними. Когда существует сеанс шлюза, CLI аутентифицируется с помощью токена шлюза, даже если установлены `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` или `CLAUDE_CODE_USE_FOUNDRY`, и записи токена-носителя, ключа API и `apiKeyHelper` выше не используются.175Подписанный сеанс [Claude apps gateway](/ru/claude-apps-gateway) находится вне этого списка: это выбор провайдера, как Amazon Bedrock или Google Cloud's Agent Platform, и он имеет приоритет над ними. Когда существует сеанс шлюза, CLI аутентифицируется с помощью токена шлюза, даже если установлены `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` или `CLAUDE_CODE_USE_FOUNDRY`, и записи токена-носителя, ключа API и `apiKeyHelper` выше не используются.

169 176 

170Если у вас есть активная подписка Claude, но также установлен `ANTHROPIC_API_KEY` в вашей среде, ключ API имеет приоритет после одобрения. Это может привести к сбоям аутентификации, если ключ принадлежит отключенной или истекшей организации. Запустите `unset ANTHROPIC_API_KEY`, чтобы вернуться к вашей подписке, и проверьте `/status`, чтобы подтвердить, какой метод активен.177Если у вас есть активная подписка Claude, но также установлен `ANTHROPIC_API_KEY` в вашей среде, ключ API имеет приоритет после одобрения. Это может привести к сбоям аутентификации, если ключ принадлежит отключенной или истекшей организации. Запустите `unset ANTHROPIC_API_KEY`, чтобы вернуться к вашей подписке, и проверьте `/status`, чтобы подтвердить, какой метод активен. Строка `Login method` показывает вашу учетную запись подписки, и строка `API key` появляется при использовании ключа API.

171 178 

172[Claude Code в веб-версии](/ru/claude-code-on-the-web) всегда использует учетные данные вашей подписки. `ANTHROPIC_API_KEY` и `ANTHROPIC_AUTH_TOKEN` в среде песочницы не переопределяют их.179[Claude Code в веб-версии](/ru/claude-code-on-the-web) всегда использует учетные данные вашей подписки. Если вы установите `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN` в среде песочницы, это не переопределит учетные данные вашей подписки.

173 180 

174<h3 id="generate-a-long-lived-token">181<h3 id="generate-a-long-lived-token">

175 Создание долгоживущего токена182 Создание долгоживущего токена

Details

6 6 

7> Сообщите классификатору режима auto, какие репозитории, бакеты и домены доверяет ваша организация. Установите контекст окружения, переопределите правила блокировки и разрешения по умолчанию и проверьте вашу эффективную конфигурацию с помощью подкоманд CLI auto-mode.7> Сообщите классификатору режима auto, какие репозитории, бакеты и домены доверяет ваша организация. Установите контекст окружения, переопределите правила блокировки и разрешения по умолчанию и проверьте вашу эффективную конфигурацию с помощью подкоманд CLI auto-mode.

8 8 

9[Auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) позволяет Claude Code работать без запросов разрешения, маршрутизируя каждый вызов инструмента через классификатор, который блокирует все необратимое, деструктивное или направленное вне вашего окружения. Правила отказа и явного запроса оцениваются перед классификатором и по-прежнему блокируют или запрашивают разрешение. Используйте блок настроек `autoMode`, чтобы сообщить этому классификатору, какие репозитории, бакеты и домены доверяет ваша организация, чтобы он перестал блокировать обычные внутренние операции.9[Режим auto](/ru/permission-modes#eliminate-prompts-with-auto-mode) позволяет Claude Code работать без обычных запросов разрешений, маршрутизируя вызовы инструментов через классификатор, который блокирует все необратимое, деструктивное или направленное вне вашего окружения. Правила отказа и явного запроса оцениваются перед классификатором и по-прежнему блокируют или запрашивают. Используйте блок настроек `autoMode`, чтобы сообщить этому классификатору, какие репозитории, бакеты и домены доверяет ваша организация, чтобы он перестал блокировать обычные внутренние операции.

10 10 

11<Note>11<Note>

12 Auto mode доступен всем пользователям на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансах [Claude apps gateway](/ru/claude-apps-gateway) с входом вы должны сначала [установить `CLAUDE_CODE_ENABLE_AUTO_MODE`](/ru/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry). Если Claude Code сообщает, что auto mode недоступен для вашей учетной записи, проверьте [полные требования](/ru/permission-modes#eliminate-prompts-with-auto-mode), которые также охватывают поддерживаемые модели и включение администратором на планах Team и Enterprise.12 Режим auto доступен всем пользователям на каждом поставщике, включая Anthropic API, Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и сеансы [шлюза приложений Claude](/ru/claude-apps-gateway). Если Claude Code сообщает, что режим auto недоступен для вашей учетной записи, проверьте [полные требования](/ru/permission-modes#eliminate-prompts-with-auto-mode), которые также охватывают поддерживаемые модели и включение Owner на планах Team и Enterprise. {/* min-version: 2.1.207 */}В версиях с v2.1.158 по v2.1.206 режим auto на Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и сеансах шлюза приложений Claude требовал установки `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 удалил это требование.

13</Note>13</Note>

14 14 

15По умолчанию классификатор доверяет только рабочему каталогу и настроенным удаленным репозиториям текущего репо. Такие действия, как отправка в исходный контроль вашей компании или запись в командный облачный бакет, блокируются до тех пор, пока вы не добавите их в `autoMode.environment`.15По умолчанию классификатор доверяет только рабочему каталогу и настроенным удаленным репозиториям текущего репозитория. Действия, такие как отправка в исходный контроль вашей компании или запись в командный облачный бакет, блокируются до тех пор, пока вы не добавите их в `autoMode.environment`.

16 16 

17Информацию о том, как включить режим auto и что он блокирует по умолчанию, см. в разделе [Permission modes](/ru/permission-modes#eliminate-prompts-with-auto-mode). Эта страница является справочником по конфигурации.17Для информации о том, как включить режим auto и что он блокирует по умолчанию, см. [Режимы разрешений](/ru/permission-modes#eliminate-prompts-with-auto-mode). Эта страница является справочником по конфигурации.

18 18 

19На этой странице рассматривается, как:19На этой странице рассматривается, как:

20 20 

21* [Добавить контрольную точку человека](#common-boundaries) для отправок и запросов на слияние с помощью `permissions.ask`

21* [Выбрать, где устанавливать правила](#where-the-classifier-reads-configuration) в CLAUDE.md, пользовательских настройках и управляемых настройках22* [Выбрать, где устанавливать правила](#where-the-classifier-reads-configuration) в CLAUDE.md, пользовательских настройках и управляемых настройках

22* [Определить доверенную инфраструктуру](#define-trusted-infrastructure) с помощью `autoMode.environment`23* [Определить доверенную инфраструктуру](#define-trusted-infrastructure) с помощью `autoMode.environment`

23* [Переопределить правила блокировки и разрешения](#override-the-block-and-allow-rules), когда значения по умолчанию не подходят для вашего конвейера24* [Переопределить правила блокировки и разрешения](#override-the-block-and-allow-rules) когда значения по умолчанию не подходят для вашего конвейера

24* [Маршрутизировать все команды shell через классификатор](#route-all-shell-commands-through-the-classifier) с помощью `autoMode.classifyAllShell`25* [Маршрутизировать все команды shell через классификатор](#route-all-shell-commands-through-the-classifier) с помощью `autoMode.classifyAllShell`

25* [Проверить вашу эффективную конфигурацию](#inspect-the-defaults-and-your-effective-config) с помощью подкоманд `claude auto-mode`26* [Проверить вашу эффективную конфигурацию](#inspect-the-defaults-and-your-effective-config) с помощью подкоманд `claude auto-mode`

26* [Просмотреть отказы](#review-denials), чтобы знать, что добавить дальше27* [Просмотреть отказы](#review-denials) чтобы знать, что добавить дальше

28 

29<h2 id="common-boundaries">

30 Общие границы

31</h2>

32 

33Автоматический режим позволяет отправлять изменения в вашу рабочую ветку, обычные отправки в ветку по умолчанию репозитория и создание pull request по умолчанию. Классификатор блокирует отправку только когда она несет риск, например при force push или содержимом, которое обходит установленный вами процесс проверки. Если вы хотите контрольную точку человека перед каждой отправкой или pull request, добавьте правила разрешений: рецепты ниже сохраняют автоматический режим включенным для всего остального.

34 

35Наиболее прямой механизм — это [`permissions.ask`](/ru/permissions#permission-rule-syntax). Правила ask с областью действия контента, подобные приведенным ниже, оцениваются перед классификатором и всегда вызывают запрос разрешения, даже в автоматическом режиме, потому что явное правило ask — это ваше заявленное намерение получить запрос для этого действия. Добавьте правила в ваши [параметры](/ru/settings#settings-files):

36 

37```json theme={null}

38{

39 "permissions": {

40 "ask": [

41 "Bash(git push *)",

42 "Bash(gh pr create *)"

43 ]

44 }

45}

46```

47 

48Выберите механизм, который соответствует тому, насколько строгой должна быть граница:

49 

50| Граница | Механизм | Поведение в автоматическом режиме |

51| :----------------------------------- | :------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

52| Запрос перед действием | `permissions.ask` | Всегда запрашивает для правил с областью действия контента, подобных рецепту выше. Классификатор не может автоматически одобрить соответствующее действие. |

53| Никогда не запускать действие | `permissions.deny` | Блокирует перед консультацией классификатора. Ни классификатор, ни намерение пользователя не могут переопределить это. |

54| Одноразовая граница для этого сеанса | Укажите это в разговоре, например "не отправляй, пока я не проверю" | Классификатор блокирует соответствующие действия, но граница может быть потеряна, если [компактирование контекста](/ru/costs#reduce-token-usage) удалит сообщение, в котором она была указана. Используйте правило ask или deny для гарантии долговечности. |

27 55 

28<h2 id="where-the-classifier-reads-configuration">56<h2 id="where-the-classifier-reads-configuration">

29 Where the classifier reads configuration57 Где классификатор читает конфигурацию

30</h2>58</h2>

31 59 

32Классификатор читает то же содержимое [CLAUDE.md](/ru/memory), что загружает сам Claude, поэтому инструкция вроде "никогда не делай force push" в CLAUDE.md вашего проекта управляет как Claude, так и классификатором одновременно. Начните с этого для соглашений проекта и правил поведения.60Классификатор читает то же содержимое [CLAUDE.md](/ru/memory), которое загружает сам Claude, поэтому инструкция вроде "никогда не делайте force push" в файле CLAUDE.md вашего проекта управляет как Claude, так и классификатором одновременно. Начните с этого файла для соглашений проекта и правил поведения.

33 61 

34Для правил, которые применяются ко всем проектам, таких как доверенная инфраструктура или организационные правила отказа, используйте блок настроек `autoMode`. Классификатор читает `autoMode` из следующих областей:62Для правил, которые применяются ко всем проектам, таких как доверенная инфраструктура или организационные правила запрета, используйте блок настроек `autoMode`. Классификатор читает `autoMode` из следующих областей:

35 63 

36| Область | Файл | Используется для |64| Область | Файл | Используется для |

37| :------------------------------ | :---------------------------------------------- | :----------------------------------------------------------- |65| :------------------------------ | :--------------------------------------------------- | :----------------------------------------------------------- |

38| Один разработчик | `~/.claude/settings.json` | Личная доверенная инфраструктура |66| Один разработчик | `~/.claude/settings.json` | Личная доверенная инфраструктура |

39| Один проект, один разработчик | `.claude/settings.local.json` | Доверенные бакеты или сервисы для каждого проекта |67| Организация | [Управляемые настройки](/ru/server-managed-settings) | Доверенная инфраструктура, распределённая всем разработчикам |

40| Организация | [Managed settings](/ru/server-managed-settings) | Доверенная инфраструктура, распределенная всем разработчикам |

41| Флаг `--settings` или Agent SDK | Встроенный JSON | Переопределения для каждого вызова для автоматизации |68| Флаг `--settings` или Agent SDK | Встроенный JSON | Переопределения для каждого вызова для автоматизации |

42 69 

43Классификатор не читает `autoMode` из общих настроек проекта в `.claude/settings.json`, поэтому проверенный репо не может внедрить свои собственные правила разрешения.70Классификатор не читает `autoMode` из настроек проекта в `.claude/settings.json` или `.claude/settings.local.json`. Оба файла находятся в директории репозитория, поэтому проверенный репозиторий или шаг сборки могли бы иначе внедрить свои собственные правила разрешения. До версии 2.1.207 классификатор также читал `.claude/settings.local.json`; переместите любой блок `autoMode` из этого файла в `~/.claude/settings.json`. Исключение `.claude/settings.local.json` также закрывает случай, когда репозиторий фиксирует файл или локальный инструмент или шаг сборки записывает его.

44 71 

45Записи из каждой области объединяются. Разработчик может расширить `environment`, `allow`, `soft_deny` и `hard_deny` личными записями, но не может удалить записи, которые предоставляют управляемые настройки. Поскольку правила разрешения действуют как исключения из правил блокировки внутри классификатора, запись `allow`, добавленная разработчиком, может переопределить запись организационного `soft_deny`: комбинация является аддитивной, а не жесткой границей политики.72Записи из каждой области объединяются. Разработчик может расширить `environment`, `allow`, `soft_deny` и `hard_deny` личными записями, но не может удалить записи, которые предоставляют управляемые настройки. Поскольку правила разрешения действуют как исключения из правил мягкой блокировки внутри классификатора, запись `allow`, добавленная разработчиком, может переопределить запись организационного `soft_deny`: комбинация является аддитивной, а не жёсткой границей политики.

46 73 

47<Note>74<Note>

48 Классификатор — это второй шлюз, который работает после [системы разрешений](/ru/permissions). Для действий, которые никогда не должны выполняться независимо от намерения пользователя или конфигурации классификатора, используйте `permissions.deny` в управляемых настройках, который блокирует действие до того, как классификатор будет проверен, и не может быть переопределен.75 Классификатор — это вторая проверка, которая выполняется после [системы разрешений](/ru/permissions). Для действий, которые никогда не должны выполняться независимо от намерения пользователя или конфигурации классификатора, используйте `permissions.deny` в управляемых настройках, что блокирует действие до того, как классификатор будет проверен, и не может быть переопределено.

49</Note>76</Note>

50 77 

51<h2 id="define-trusted-infrastructure">78<h2 id="define-trusted-infrastructure">


181```208```

182 209 

183<Danger>210<Danger>

184 Установка любого из `environment`, `allow`, `soft_deny` или `hard_deny` без `"$defaults"` заменяет весь список по умолчанию для этого раздела. Массив `soft_deny` без `"$defaults"` отбрасывает каждое встроенное правило мягкой блокировки, включая force push, `curl | bash` и развертывание в production. Массив `hard_deny` без `"$defaults"` отбрасывает встроенные правила утечки данных и обхода режима auto.211 Установка любого из `environment`, `allow`, `soft_deny` или `hard_deny` без `"$defaults"` заменяет весь список по умолчанию для этого раздела. Если вы установите массив без `"$defaults"`, вы отбросите встроенные правила для этого раздела:

212 

213 * `soft_deny`: каждое встроенное правило мягкой блокировки, включая force push, `curl | bash`, развертывание в production и обход режима auto

214 * `hard_deny`: встроенное правило утечки данных

185</Danger>215</Danger>

186 216 

187Каждый раздел оценивается независимо, поэтому установка только `environment` оставляет списки `allow`, `soft_deny` и `hard_deny` по умолчанию нетронутыми.217Каждый раздел оценивается независимо, поэтому установка только `environment` оставляет списки `allow`, `soft_deny` и `hard_deny` по умолчанию нетронутыми.


224claude auto-mode defaults254claude auto-mode defaults

225```255```

226 256 

257{/* min-version: 2.1.208 */}Чтобы прочитать полный текст одного правила без передачи через `jq`, передайте `--label` с началом метки правила, например `claude auto-mode defaults --label 'Git Destructive'`. Сопоставление выполняется без учёта регистра по префиксу метки каждого правила, а разделы без совпадений выводятся как пустые списки. Требуется Claude Code v2.1.208 или более поздняя версия.

258 

227Выведите то, что классификатор фактически использует как JSON, с вашими настройками, применяемыми где установлены, и значениями по умолчанию в противном случае:259Выведите то, что классификатор фактически использует как JSON, с вашими настройками, применяемыми где установлены, и значениями по умолчанию в противном случае:

228 260 

229```bash theme={null}261```bash theme={null}

channels.md +1 −1

Details

261 </Step>261 </Step>

262</Steps>262</Steps>

263 263 

264Если Claude столкнется с запросом разрешения, пока вас нет у терминала, сеанс приостановится до вашего ответа. Серверы каналов, которые объявляют [возможность трансляции разрешений](/ru/channels-reference#relay-permission-prompts), могут перенаправлять эти запросы вам, чтобы вы могли одобрить или отклонить их удаленно. Для автоматического использования [`--dangerously-skip-permissions`](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) обходит запросы полностью, но используйте это только в окружениях, которым вы доверяете.264Если Claude столкнется с запросом разрешения, пока вас нет у терминала, сеанс приостановится до вашего ответа. Серверы каналов, которые объявляют [возможность трансляции разрешений](/ru/channels-reference#relay-permission-prompts), могут перенаправлять эти запросы вам, чтобы вы могли одобрить или отклонить их удаленно. Для автоматического использования [`--dangerously-skip-permissions`](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) обходит большинство запросов, но используйте это только в окружениях, которым вы доверяете. Явные правила запроса, инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные как [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), по-прежнему выдают запросы.

265 265 

266Когда вы запускаете каналы в неинтерактивном режиме с `-p`, инструменты, которые требуют ввода с терминала, такие как вопросы с множественным выбором и одобрение режима плана, отключены, чтобы сеанс никогда не зависал в ожидании ввода.266Когда вы запускаете каналы в неинтерактивном режиме с `-p`, инструменты, которые требуют ввода с терминала, такие как вопросы с множественным выбором и одобрение режима плана, отключены, чтобы сеанс никогда не зависал в ожидании ввода.

267 267 

Details

21Claude Code отслеживает все изменения, внесённые его инструментами редактирования файлов:21Claude Code отслеживает все изменения, внесённые его инструментами редактирования файлов:

22 22 

23* Каждый запрос пользователя создаёт новый checkpoint23* Каждый запрос пользователя создаёт новый checkpoint

24* Claude Code хранит снимки файлов для 100 самых последних checkpoints в сеансе. Удаление старого checkpoint удаляет файлы снимков, на которые не ссылается ни один оставшийся checkpoint, за исключением первого снимка каждого файла, который расширение VS Code использует в качестве базовой линии для различий сеанса. {/* min-version: 2.1.208 */}До версии v2.1.208 эти замещённые файлы снимков оставались на диске до очистки сеанса.

24* Checkpoints сохраняются с беседой, поэтому возобновлённый сеанс всё ещё может использовать `/rewind` для возврата к ним25* Checkpoints сохраняются с беседой, поэтому возобновлённый сеанс всё ещё может использовать `/rewind` для возврата к ним

25* Автоматически очищаются вместе с сеансами через 30 дней (настраивается)26* Автоматически очищаются вместе с сеансами через 30 дней (настраивается)

26 27 

chrome.md +3 −1

Details

65 Go to code.claude.com/docs, click on the search box,65 Go to code.claude.com/docs, click on the search box,

66 type "hooks", and tell me what results appear66 type "hooks", and tell me what results appear

67 ```67 ```

68 

69 Первое действие браузера запрашивает разрешение на использование навыка `claude-in-chrome`. Одобрите его, и Claude откроет новую вкладку и начнёт выполнение задачи.

68 </Step>70 </Step>

69</Steps>71</Steps>

70 72 


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

106</h2>108</h2>

107 109 

108Эти примеры показывают распространённые способы объединения действий браузера с задачами кодирования. Выполните `/mcp` и выберите `claude-in-chrome`, чтобы увидеть полный список доступных инструментов браузера.110Эти примеры показывают распространённые способы объединения действий браузера с задачами кодирования. Выполните `/mcp`, выберите `claude-in-chrome`, затем выберите **View tools**, чтобы увидеть полный список доступных инструментов браузера.

109 111 

110<h3 id="test-a-local-web-application">112<h3 id="test-a-local-web-application">

111 Тестирование локального веб-приложения113 Тестирование локального веб-приложения

Details

192 192 

193Пустой блок `auth` использует цепочку учётных данных AWS SDK по умолчанию: переменные env, `~/.aws/credentials`, роль задачи ECS, метаданные экземпляра EC2 или IRSA на EKS. В production дайте поду gateway роль IAM вместо встраивания статических ключей в образ контейнера.193Пустой блок `auth` использует цепочку учётных данных AWS SDK по умолчанию: переменные env, `~/.aws/credentials`, роль задачи ECS, метаданные экземпляра EC2 или IRSA на EKS. В production дайте поду gateway роль IAM вместо встраивания статических ключей в образ контейнера.

194 194 

195Явные учётные данные должны быть полными: gateway не запускается, когда `aws_access_key_id` и `aws_secret_access_key` не установлены вместе, или когда `aws_session_token` установлен без них. До v2.1.207 частичный блок `auth:` прошёл проверку.

196 

195| Настройка | Как |197| Настройка | Как |

196| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |198| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

197| Разрешения IAM | Предоставьте основному принципалу gateway `bedrock:InvokeModel` и `bedrock:InvokeModelWithResponseStream` как на ARN профилей вывода, так и на ARN базовых моделей фундамента. Для встроенного каталога в регионах США: `arn:aws:bedrock:<region>:<account>:inference-profile/us.anthropic.*` и `arn:aws:bedrock:*::foundation-model/anthropic.*`. |199| Разрешения IAM | Предоставьте основному принципалу gateway `bedrock:InvokeModel` и `bedrock:InvokeModelWithResponseStream` как на ARN профилей вывода, так и на ARN базовых моделей фундамента. Для встроенного каталога в регионах США: `arn:aws:bedrock:<region>:<account>:inference-profile/us.anthropic.*` и `arn:aws:bedrock:*::foundation-model/anthropic.*`. |


515```517```

516 518 

517| Ключ | Применяется | Эффект |519| Ключ | Применяется | Эффект |

518| ------------------------------------------ | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |520| ------------------------------------------ | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

519| `availableModels` | Gateway + CLI | Список разрешений моделей. Также проверяется в `/v1/messages`, поэтому исправленный клиент не может его обойти. |521| `availableModels` | Gateway + CLI | Список разрешений моделей. Также проверяется в `/v1/messages`, поэтому исправленный клиент не может его обойти. |

520| `permissions.allow` / `.deny` | CLI | Правила инструментов и команд. См. [Разрешения](/ru/permissions). |522| `permissions.allow` / `.deny` | CLI | Правила инструментов и команд. См. [Разрешения](/ru/permissions). |

521| `permissions.disableBypassPermissionsMode` | CLI | Установите на `disable` для блокировки [`bypassPermissions`](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode), режима, который автоматически одобряет каждый вызов инструмента, и флага `--dangerously-skip-permissions` |523| `permissions.disableBypassPermissionsMode` | CLI | Установите на `disable` для блокировки [`bypassPermissions`](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode), режима, который пропускает подсказки разрешений, и флага `--dangerously-skip-permissions` |

522| `allowManagedPermissionRulesOnly` | CLI | Когда `true`, правила разрешений пользователя и проекта игнорируются; применяются только правила из этого документа |524| `allowManagedPermissionRulesOnly` | CLI | Когда `true`, правила разрешений пользователя и проекта игнорируются; применяются только правила из этого документа |

523| `env` | CLI | Переменные окружения, объединённые в процесс CLI. Используйте для телеметрии, автообновления и переопределений имён моделей. |525| `env` | CLI | Переменные окружения, объединённые в процесс CLI. Используйте для телеметрии, автообновления и переопределений имён моделей. |

524| `hooks` | CLI | Org-wide [hooks](/ru/hooks) |526| `hooks` | CLI | Org-wide [hooks](/ru/hooks) |


535* **В списке безопасности**: переменные автообновления и имён моделей537* **В списке безопасности**: переменные автообновления и имён моделей

536* **Не в списке безопасности**: переменные прокси, переменные базового URL и `OTEL_EXPORTER_OTLP_ENDPOINT`538* **Не в списке безопасности**: переменные прокси, переменные базового URL и `OTEL_EXPORTER_OTLP_ENDPOINT`

537 539 

538[Телеметрия](#telemetry) gateway отправляет `OTEL_EXPORTER_OTLP_ENDPOINT`, поэтому установка `telemetry.forward_to` запускает диалог на каждом интерактивном клиенте. Неинтерактивные запуски с флагом `-p` пропускают диалог и применяют параметры без одобрения. Диалог защищает машину разработчика от скомпрометированного или враждебного gateway, а не организацию от разработчика, поэтому пропуск `-p` является намеренным, а не пробелом.540[Телеметрия](#telemetry) gateway отправляет `OTEL_EXPORTER_OTLP_ENDPOINT`, поэтому установка `telemetry.forward_to` запускает диалог на каждом интерактивном клиенте. Диалог защищает машину разработчика от скомпрометированного или враждебного gateway, а не организацию от разработчика.

541 

542Неинтерактивный запуск с флагом `-p` не может показать диалог. Он применяет отправленные параметры только для этого запуска и не записывает их как одобренные, поэтому следующий интерактивный сеанс разработчика всё ещё показывает диалог. До версии 2.1.207 неинтерактивный запуск сохранял параметры как одобренные и ни один последующий интерактивный сеанс не показывал диалог для них.

539 543 

540Если разработчик отклоняет, Claude Code выходит, а не применяет политику. Отправка нового hook или переменной `env`, не входящей в список безопасности, в широкую политику означает диалог одобрения при каждом запуске каждого соответствующего разработчика.544Если разработчик отклоняет, Claude Code выходит, а не применяет политику. Отправка нового hook или переменной `env`, не входящей в список безопасности, в широкую политику означает диалог одобрения при каждом запуске каждого соответствующего разработчика.

541 545 

Details

19 19 

20<Note>20<Note>

21 **Развертывайте в вашей частной сети.** Claude Code подключается только к шлюзу, адрес которого является приватным. Это защита безопасности, потому что доверенный шлюз может отправлять параметры, которые запускают команды на машинах разработчиков. Поместите шлюз за внутренним балансировщиком нагрузки или VPN и дайте ему имя хоста, которое разрешается только на приватные IP-адреса.21 **Развертывайте в вашей частной сети.** Claude Code подключается только к шлюзу, адрес которого является приватным. Это защита безопасности, потому что доверенный шлюз может отправлять параметры, которые запускают команды на машинах разработчиков. Поместите шлюз за внутренним балансировщиком нагрузки или VPN и дайте ему имя хоста, которое разрешается только на приватные IP-адреса.

22 

23 Общедоступные конечные точки шлюза, управляемые Anthropic, являются исключением: `/login` принимает их через `https://`. Это небольшой фиксированный набор шлюзов, которыми управляет сама Anthropic; они не являются вариантом развертывания, который вы можете выбрать или настроить. Список скомпилирован в Claude Code, поэтому никакая конфигурация не может добавить имя хоста в него и ни один шлюз, который вы размещаете, не соответствует исключению. {/* min-version: 2.1.206 */}До версии 2.1.206 `/login` отклонял эти конечные точки, как и любой другой общедоступный адрес.

22</Note>24</Note>

23 25 

24<h2 id="identity-provider-setup">26<h2 id="identity-provider-setup">


271* **Проблема inference**: запрошенная модель, настроенные upstreams и журнал аудита шлюза для запроса, который записывает, какой upstream обслужил его и статус ответа273* **Проблема inference**: запрошенная модель, настроенные upstreams и журнал аудита шлюза для запроса, который записывает, какой upstream обслужил его и статус ответа

272 274 

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

274| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |276| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

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

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

277| 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 имя. См. [предпосылку приватной сети](/ru/claude-apps-gateway#prerequisites). |279| 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 адреса. Публичные конечные точки шлюза, управляемые Anthropic, исключены из проверки, и `/login` принимает их через `https://`. До версии v2.1.206 `/login` отклонял их как любой другой публичный адрес | Попросите имя шлюза разрешаться только на приватные адреса на машинах разработчиков. Для dual-stack имени удалите публичный диапазон записи или обслуживайте отдельное внутреннее DNS имя. См. [предпосылку приватной сети](/ru/claude-apps-gateway#prerequisites). |

278| CLI `/login`: `Gateway login requires a direct connection and does not support connecting through an HTTP proxy` | `HTTPS_PROXY` или `HTTP_PROXY` применяется к хосту шлюза и имя хоста прокси разрешается на публичный адрес. Прокси, чье имя хоста разрешается только на приватные адреса, разрешен и не вызывает эту ошибку | Добавьте хост шлюза в `NO_PROXY` на машине разработчика, чтобы соединение было прямым, или используйте прокси, чье имя хоста разрешается на приватные адреса |280| CLI `/login`: `Gateway login requires a direct connection and does not support connecting through an HTTP proxy` | `HTTPS_PROXY` или `HTTP_PROXY` применяется к хосту шлюза и имя хоста прокси разрешается на публичный адрес. Прокси, чье имя хоста разрешается только на приватные адреса, разрешен и не вызывает эту ошибку | Добавьте хост шлюза в `NO_PROXY` на машине разработчика, чтобы соединение было прямым, или используйте прокси, чье имя хоста разрешается на приватные адреса |

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

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


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

284| `/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`. |286| `/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`. |

285| Лог: `token exchange failed: 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`. |287| Лог: `token exchange failed: 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`. |

286| Каждый запрос 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 и избегают изменения полностью, или применяйте изменение на выделенном экземпляре шлюза, чтобы ограничить воздействие. |288| Каждый запрос 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 и избегают изменения полностью, или применяйте изменение на выделенном экземпляре шлюза, чтобы ограничить воздействие. |

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

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

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

Details

115 115 

116Облачные сессии включают встроенные инструменты GitHub, которые позволяют Claude читать проблемы, перечислять pull requests, получать diffs и публиковать комментарии без какой-либо настройки. Эти инструменты аутентифицируются через [GitHub proxy](#github-proxy), используя любой метод, который вы настроили в разделе [Варианты аутентификации GitHub](#github-authentication-options), поэтому ваш токен никогда не входит в контейнер.116Облачные сессии включают встроенные инструменты GitHub, которые позволяют Claude читать проблемы, перечислять pull requests, получать diffs и публиковать комментарии без какой-либо настройки. Эти инструменты аутентифицируются через [GitHub proxy](#github-proxy), используя любой метод, который вы настроили в разделе [Варианты аутентификации GitHub](#github-authentication-options), поэтому ваш токен никогда не входит в контейнер.

117 117 

118Вы можете установить `GH_TOKEN` или `GITHUB_TOKEN` самостоятельно в [параметрах окружения](#configure-your-environment), или оставить оба не установленными и позволить [GitHub proxy](#github-proxy) аутентифицировать вас:

119 

120* Если вы установите токен, он передаётся в контейнер без изменений, поэтому `gh` и ваши скрипты используют его напрямую.

121* Если вы не установите ни один, контейнер установит обе переменные на строку-заполнитель `proxy-injected` и прокси подставит ваши реальные учётные данные на исходящих запросах GitHub. `gh` работает без вашего собственного токена, но скрипт, который читает `GITHUB_TOKEN` напрямую, получает заполнитель, а не используемый токен.

122 

123Чтобы проверить, какой случай применяется к вашей сессии, попросите Claude запустить `echo $GH_TOKEN`.

124 

118CLI `gh` не предустановлен. Если вам нужна команда `gh`, которую встроенные инструменты не охватывают, например `gh release` или `gh workflow run`, установите и аутентифицируйте её самостоятельно:125CLI `gh` не предустановлен. Если вам нужна команда `gh`, которую встроенные инструменты не охватывают, например `gh release` или `gh workflow run`, установите и аутентифицируйте её самостоятельно:

119 126 

120<Steps>127<Steps>


122 Добавьте `apt update && apt install -y gh` в ваш [setup script](#setup-scripts).129 Добавьте `apt update && apt install -y gh` в ваш [setup script](#setup-scripts).

123 </Step>130 </Step>

124 131 

125 <Step title="Предоставьте токен">132 <Step title="Предоставьте токен, если прокси не обрабатывает аутентификацию">

126 Добавьте переменную окружения `GH_TOKEN` в ваши [параметры окружения](#configure-your-environment) с личным токеном доступа GitHub. `gh` автоматически читает `GH_TOKEN`, поэтому шаг `gh auth login` не требуется.133 Если `echo $GH_TOKEN` выводит `proxy-injected`, [GitHub proxy](#github-proxy) аутентифицирует `gh` для вас и этот шаг не требуется. В противном случае добавьте переменную окружения `GH_TOKEN` в ваши [параметры окружения](#configure-your-environment) с личным токеном доступа GitHub. `gh` автоматически читает `GH_TOKEN`, поэтому шаг `gh auth login` не требуется.

127 </Step>134 </Step>

128</Steps>135</Steps>

129 136 


196DATABASE_URL=postgres://localhost:5432/myapp203DATABASE_URL=postgres://localhost:5432/myapp

197```204```

198 205 

206<h3 id="organization-shared-environments">

207 Окружения, общие для организации

208</h3>

209 

210Владельцы и администраторы в планах Team и Enterprise могут создавать облачные окружения, которые общие со всеми членами организации. Общие окружения появляются в селекторе окружения каждого члена рядом с их личными, поэтому команда может стандартизировать одну конфигурацию вместо того, чтобы каждый член пересоздавал её.

211 

212Управляйте общими окружениями со страницы **Cloud environments** в [параметрах администратора](https://claude.ai/admin-settings). Оттуда вы можете:

213 

214* Создавать, редактировать и архивировать общие окружения. Каждое имеет те же поля, что и личное окружение: имя, [уровень сетевого доступа](#access-levels), [переменные окружения](#configure-your-environment) в формате `.env` и [setup script](#setup-scripts).

215* Установить окружение по умолчанию для организации.

216 

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

218 

219Организации в программе самостоятельно размещаемых runners также управляют своими пулами runners со той же страницы.

220 

199<h2 id="setup-scripts">221<h2 id="setup-scripts">

200 Setup scripts222 Setup scripts

201</h2>223</h2>


340 362 

341Используйте `*.` для совпадения поддоменов с подстановочными знаками. Отметьте **Also include default list of common package managers**, чтобы сохранить [Trusted домены](#default-allowed-domains) вместе с вашими пользовательскими записями, или оставьте её без отметки, чтобы разрешить только то, что вы указали.363Используйте `*.` для совпадения поддоменов с подстановочными знаками. Отметьте **Also include default list of common package managers**, чтобы сохранить [Trusted домены](#default-allowed-domains) вместе с вашими пользовательскими записями, или оставьте её без отметки, чтобы разрешить только то, что вы указали.

342 364 

365Разрешённые домены настраиваются для каждого окружения. Нет списка разрешений на уровне организации, который Owners могут применить ко всем окружениям пользователей; [параметры, управляемые сервером](/ru/server-managed-settings), могут ограничивать облачные сессии, но не могут добавлять разрешённые домены.

366 

343<h3 id="github-proxy">367<h3 id="github-proxy">

344 GitHub proxy368 GitHub proxy

345</h3>369</h3>

346 370 

347Для безопасности все операции GitHub проходят через выделённый сервис прокси, который прозрачно обрабатывает все взаимодействия git. Внутри песочницы клиент git аутентифицируется с помощью пользовательского ограниченного учётного данного. Этот прокси:371Для безопасности все операции GitHub проходят через выделённый сервис прокси, который держит ваши реальные учётные данные GitHub вне песочницы. Прокси аутентифицирует два вида трафика:

348 372 

349* Безопасно управляет аутентификацией GitHub: клиент git использует ограниченное учётное данное внутри песочницы, которое прокси проверяет и переводит в ваш фактический токен аутентификации GitHub373* Взаимодействия Git: клиент git внутри песочницы использует пользовательское ограниченное учётное данное, которое прокси проверяет и переводит в ваш фактический токен аутентификации GitHub

350* Ограничивает операции git push к текущей рабочей ветке для безопасности374* Запросы GitHub API: прокси подставляет ваши реальные учётные данные в запросы от встроенных инструментов GitHub и от `gh`, когда ваша сессия устанавливает заполнитель `proxy-injected`, описанный в разделе [Работа с проблемами GitHub и запросами на слияние](#work-with-github-issues-and-pull-requests)

351* Обеспечивает беспрепятственное клонирование, получение и операции PR при сохранении границ безопасности375 

376Прокси также ограничивает операции git push текущей рабочей ветке для безопасности и обеспечивает клонирование, получение и операции PR при сохранении границ безопасности.

377 

378Прокси ограничивает запросы GitHub API и release-asset к репозиториям, прикреплённым к сессии, независимо от [уровня сетевого доступа](#access-levels) окружения. Скрипты установки, которые загружают release assets из неприкреплённых репозиториев, возвращают 403. Зафиксированные файлы из публичных репозиториев получаются через `raw.githubusercontent.com`, который [security proxy](#security-proxy) обрабатывает вместо этого. Этот домен находится в списке по умолчанию [Trusted](#default-allowed-domains), поэтому файлы остаются доступными, если [уровень доступа](#access-levels) окружения его не исключает.

352 379 

353<h3 id="security-proxy">380<h3 id="security-proxy">

354 Security proxy381 Security proxy


745 Управление контекстом772 Управление контекстом

746</h3>773</h3>

747 774 

748Облачные сессии поддерживают [встроенные команды](/ru/commands), которые производят текстовый вывод. Команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, недоступны. {/* min-version: 2.1.205 */}Команды `/model`, `/effort`, `/fast`, `/color` и `/rename` работают со значением в качестве аргумента, например `/model sonnet`, вместо открытия выбора терминала или ползунка; формы аргументов требуют Claude Code v2.1.205 или более поздней версии в окружении сессии и следуют примечаниям доступности каждой команды (/ru/commands#all-commands), поэтому `/effort` сообщает `Not applied`, пока действует [launch-default effort hold](/ru/model-config#adjust-effort-level) модели, и `/fast` работает только в сессии, которая была запущена с включённым режимом fast mode. `/config` устанавливает параметр, когда вы передаёте `key=value`.775Облачные сессии поддерживают [встроенные команды](/ru/commands), которые производят текстовый вывод. Команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, недоступны. Команды, которые открывают выбор или панель в терминале, ведут себя иначе в облачных сессиях:

776 

777* {/* min-version: 2.1.205 */}**`/model`, `/effort`, `/fast`, `/color` и `/rename`**: передайте значение в качестве аргумента, например `/model sonnet`, вместо открытия выбора терминала или ползунка. Формы аргументов требуют Claude Code v2.1.205 или более поздней версии в окружении сессии и следуют примечаниям доступности каждой команды (/ru/commands#all-commands): `/effort` сообщает `Not applied`, пока действует [launch-default effort hold](/ru/model-config#adjust-effort-level) модели, и `/fast` работает только в сессии, которая была запущена с включённым режимом fast mode.

778* **`/config`**: в веб-версии открывает раздел Claude Code ваших параметров вместо установки значения, и текст после команды, включая `key=value`, игнорируется. Чтобы изменить параметры облачной сессии, используйте [переменные окружения](#configure-your-environment) или зафиксируйте [файлы параметров](/ru/settings) в репозитории.

749 779 

750Для управления контекстом конкретно:780Для управления контекстом конкретно:

751 781 

Details

1533Файлы в путях ниже удаляются при запуске, как только им исполняется больше [`cleanupPeriodDays`](/ru/settings#available-settings). По умолчанию это 30 дней.1533Файлы в путях ниже удаляются при запуске, как только им исполняется больше [`cleanupPeriodDays`](/ru/settings#available-settings). По умолчанию это 30 дней.

1534 1534 

1535| Путь под `~/.claude/` | Содержимое |1535| Путь под `~/.claude/` | Содержимое |

1536| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |1536| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1537| `projects/<project>/<session>.jsonl` | Полная стенограмма разговора: каждое сообщение, вызов инструмента и результат инструмента |1537| `projects/<project>/<session>.jsonl` | Полная стенограмма разговора: каждое сообщение, вызов инструмента и результат инструмента |

1538| `projects/<project>/<session>/subagents/` | Стенограммы разговоров [Subagent](/ru/sub-agents), удаляемые вместе со стенограммой родительского сеанса, когда она устаревает |1538| `projects/<project>/<session>/subagents/` | Стенограммы разговоров [Subagent](/ru/sub-agents), удаляемые вместе со стенограммой родительского сеанса, когда она устаревает |

1539| `projects/<project>/<session>/tool-results/` | Большие выходные данные инструмента разлиты в отдельные файлы |1539| `projects/<project>/<session>/tool-results/` | Большие выходные данные инструмента разлиты в отдельные файлы |

1540| `file-history/<session>/` | Снимки файлов перед редактированием, которые Claude изменил, используемые для [восстановления checkpoint](/ru/checkpointing) |1540| `file-history/<session>/` | Снимки файлов перед редактированием, которые Claude изменил, используемые для [восстановления checkpoint](/ru/checkpointing). Содержит снимки для 100 самых последних контрольных точек; файлы снимков, на которые не ссылается ни один сохранённый checkpoint, удаляются, за исключением первого снимка каждого файла |

1541| `plans/` | Файлы плана, написанные во время [plan mode](/ru/permission-modes#analyze-before-you-edit-with-plan-mode) |1541| `plans/` | Файлы плана, написанные во время [plan mode](/ru/permission-modes#analyze-before-you-edit-with-plan-mode) |

1542| `debug/` | Журналы отладки для каждого сеанса, написанные только при запуске с `--debug` или запуске `/debug` |1542| `debug/` | Журналы отладки для каждого сеанса, написанные только при запуске с `--debug` или запуске `/debug` |

1543| `paste-cache/`, `image-cache/` | Содержимое больших вставок и прикреплённых изображений |1543| `paste-cache/`, `image-cache/` | Содержимое больших вставок и прикреплённых изображений |

1544| `session-env/` | Метаданные окружения для каждого сеанса |1544| `session-env/` | Метаданные окружения для каждого сеанса |

1545| `tasks/` | Списки задач для каждого сеанса, написанные инструментами задач |1545| `tasks/` | Списки задач для каждого сеанса, написанные инструментами задач |

1546| `shell-snapshots/` | Захваченное окружение оболочки, используемое инструментом Bash. Удаляется при чистом выходе. Очистка удаляет любые оставшиеся после сбоя. |1546| `shell-snapshots/` | Псевдонимы, функции и параметры оболочки, захваченные при запуске и применяемые инструментом [Bash](/ru/tools-reference#bash-tool-behavior) к каждой команде. Удаляется при чистом выходе. Очистка удаляет любые оставшиеся после сбоя. |

1547| `backups/` | Временные копии `~/.claude.json`, сделанные перед миграциями конфигурации |1547| `backups/` | Временные копии `~/.claude.json`, сделанные перед миграциями конфигурации |

1548| `feedback-bundles/` | Отредактированные архивы стенограмм, написанные `/feedback` на сторонних поставщиков, для отправки команде вашего аккаунта Anthropic |1548| `feedback-bundles/` | Отредактированные архивы стенограмм, написанные `/feedback` на сторонних поставщиков или когда не настроены учётные данные Anthropic, для отправки команде вашего аккаунта Anthropic |

1549| `todos/`, `statsig/`, `logs/` | Устаревшие директории из более старых версий. Больше не записываются. Очистка удаляет их содержимое, а затем пустую директорию. |1549| `todos/`, `statsig/`, `logs/` | Устаревшие директории из более старых версий. Больше не записываются. Очистка удаляет их содержимое, а затем пустую директорию. |

1550 1550 

1551<h3 id="kept-until-you-delete-them">1551<h3 id="kept-until-you-delete-them">

Details

188 188 

189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />

190 190 

191Claude Platform on AWS — это API Claude, управляемый Anthropic, с аутентификацией AWS, контролем доступа IAM и выставлением счетов через AWS Marketplace. Запросы поступают непосредственно в API Anthropic, поэтому вы получаете те же модели и функции, что и в [Claude API](https://platform.claude.com/docs) по тому же графику выпусков. Вы аутентифицируетесь с помощью учетных данных AWS или ключа API рабочей области, и вы платите через AWS Marketplace.191Claude Platform on AWS — это API Claude, управляемый Anthropic, с аутентификацией AWS, контролем доступа IAM и выставлением счетов через AWS Marketplace. Запросы поступают непосредственно в API Anthropic, поэтому вы получаете те же модели и функции API, что и в [Claude API](https://platform.claude.com/docs) по тому же графику выпусков. Функции на стороне клиента, которые Claude Code включает через сервис флагов функций Anthropic, такие как [`/loop` самостоятельное управление темпом](/ru/scheduled-tasks#let-claude-choose-the-interval), отключены по умолчанию, и [инструмент advisor](/ru/advisor) недоступен. Полный список см. в [матрице доступности функций](/ru/feature-availability#summary-by-provider). Вы аутентифицируетесь с помощью учетных данных AWS или ключа API рабочей области, и вы платите через AWS Marketplace.

192 192 

193Используйте это руководство, чтобы направить Claude Code на рабочую область, которую вы уже подготовили через Claude Platform on AWS. Для подписки AWS и настройки рабочей области, которые предшествуют этому, см. [документацию Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws).193Используйте это руководство, чтобы направить Claude Code на рабочую область, которую вы уже подготовили через Claude Platform on AWS. Для подписки AWS и настройки рабочей области, которые предшествуют этому, см. [документацию Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws).

194 194 


276 3. Закрепите версии моделей276 3. Закрепите версии моделей

277</h3>277</h3>

278 278 

279Claude Platform on AWS использует те же идентификаторы моделей, что и прямой API Claude. Псевдонимы по умолчанию `fable`, `opus`, `sonnet` и `haiku` разрешаются в встроенные значения по умолчанию Claude Code для Claude Platform on AWS, которые могут отставать от последнего выпуска. Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` разрешается в Opus 4.8.279Claude Platform on AWS использует те же идентификаторы моделей, что и прямой API Claude.

280 

281Псевдонимы по умолчанию `fable`, `opus`, `sonnet` и `haiku` разрешаются в встроенные значения по умолчанию Claude Code для Claude Platform on AWS, которые могут отставать от последнего выпуска. Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` разрешается в Opus 4.8. {/* min-version: 2.1.207 */}До версии v2.1.207 он разрешался в Opus 4.7.

280 282 

281Если вы развертываете Claude Code для команды, явно закрепите идентификаторы моделей, чтобы новый выпуск не переместил всех сразу:283Если вы развертываете Claude Code для команды, явно закрепите идентификаторы моделей, чтобы новый выпуск не переместил всех сразу:

282 284 

Details

29| `claude auth status` | Показать статус аутентификации в формате JSON. Используйте `--text` для удобочитаемого вывода. Выходит с кодом 0, если вы вошли, 1, если нет | `claude auth status` |29| `claude auth status` | Показать статус аутентификации в формате JSON. Используйте `--text` для удобочитаемого вывода. Выходит с кодом 0, если вы вошли, 1, если нет | `claude auth status` |

30| `claude agents` | Открыть [представление агентов](/ru/agent-view) для мониторинга и отправки параллельных фоновых сеансов. Используйте `--cwd <path>` для отображения только сеансов, запущенных в этом каталоге, или `--json` для вывода активных сеансов в виде массива JSON для написания скриптов (`--json --all` также включает завершенные фоновые сеансы). Передайте `--permission-mode`, `--model`, `--effort` или `--agent` для установки [значений по умолчанию для отправленных сеансов](/ru/agent-view#permission-mode-model-and-effort). Принимает `--settings`, `--add-dir`, `--plugin-dir` и `--mcp-config` как команда верхнего уровня `claude`. Открытие представления агентов требует интерактивный терминал | `claude agents --json` |30| `claude agents` | Открыть [представление агентов](/ru/agent-view) для мониторинга и отправки параллельных фоновых сеансов. Используйте `--cwd <path>` для отображения только сеансов, запущенных в этом каталоге, или `--json` для вывода активных сеансов в виде массива JSON для написания скриптов (`--json --all` также включает завершенные фоновые сеансы). Передайте `--permission-mode`, `--model`, `--effort` или `--agent` для установки [значений по умолчанию для отправленных сеансов](/ru/agent-view#permission-mode-model-and-effort). Принимает `--settings`, `--add-dir`, `--plugin-dir` и `--mcp-config` как команда верхнего уровня `claude`. Открытие представления агентов требует интерактивный терминал | `claude agents --json` |

31| `claude attach <id>` | Подключиться к [фоновому сеансу](/ru/agent-view#manage-sessions-from-the-shell) в этом терминале | `claude attach 7c5dcf5d` |31| `claude attach <id>` | Подключиться к [фоновому сеансу](/ru/agent-view#manage-sessions-from-the-shell) в этом терминале | `claude attach 7c5dcf5d` |

32| `claude auto-mode defaults` | Вывести встроенные правила классификатора [auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) в формате JSON. Используйте `claude auto-mode config` для просмотра вашей эффективной конфигурации с применяемыми параметрами | `claude auto-mode defaults > rules.json` |32| `claude auto-mode defaults` | Вывести встроенные правила классификатора [auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) в формате JSON. Используйте `claude auto-mode config` для просмотра вашей эффективной конфигурации с применяемыми параметрами. {/* min-version: 2.1.208 */}Флаг `--label <prefix>` выводит только правила, метка которых начинается с этого префикса, сопоставляя без учета регистра. Требует Claude Code v2.1.208 или позже | `claude auto-mode defaults --label 'Git Destructive'` |

33| `claude daemon status` | Вывести состояние [супервизора](/ru/agent-view#the-supervisor-process) фонового сеанса, версию, каталог сокета и количество рабочих процессов для диагностики. Выходит с кодом 1, если супервизор не запущен | `claude daemon status` |33| `claude daemon status` | Вывести состояние [супервизора](/ru/agent-view#the-supervisor-process) фонового сеанса, версию, каталог сокета и количество рабочих процессов для диагностики. Выходит с кодом 1, если супервизор не запущен | `claude daemon status` |

34| `claude daemon stop --any` | Остановить [супервизора](/ru/agent-view#the-supervisor-process) фонового сеанса и размещаемые им сеансы. Передайте `--keep-workers` для сохранения работающих фоновых сеансов, чтобы следующий супервизор переподключился к ним. `--any` подтверждает остановку супервизора по требованию, который используется по умолчанию. Используйте это для восстановления после [неответчивого супервизора](/ru/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |34| `claude daemon stop --any` | Остановить [супервизора](/ru/agent-view#the-supervisor-process) фонового сеанса и размещаемые им сеансы. Передайте `--keep-workers` для сохранения работающих фоновых сеансов, чтобы следующий супервизор переподключился к ним. `--any` подтверждает остановку супервизора по требованию, который используется по умолчанию. Используйте это для восстановления после [неответчивого супервизора](/ru/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |

35| `claude doctor` | Вывести диагностику установки и параметров только для чтения из терминала без запуска сеанса, включая проверку здоровья установки, ошибки валидации файла параметров и приемлемость Remote Control. Для проверки настройки в сеансе, которая также может применять исправления, запустите [`/doctor`](/ru/commands#all-commands) | `claude doctor` |35| `claude doctor` | Вывести диагностику установки и параметров только для чтения из терминала без запуска сеанса, включая проверку здоровья установки, ошибки валидации файла параметров и приемлемость Remote Control. Для проверки настройки в сеансе, которая также может применять исправления, запустите [`/doctor`](/ru/commands#all-commands) | `claude doctor` |


76| `--cloud` | Создать новый [веб-сеанс](/ru/claude-code-on-the-web) на claude.ai с предоставленным описанием задачи | `claude --cloud "Fix the login bug"` |76| `--cloud` | Создать новый [веб-сеанс](/ru/claude-code-on-the-web) на claude.ai с предоставленным описанием задачи | `claude --cloud "Fix the login bug"` |

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

78| `--dangerously-load-development-channels` | Включить [channels](/ru/channels-reference#test-during-the-research-preview), которые не находятся в утвержденном списке разрешений, для локальной разработки. Принимает записи `plugin:<name>@<marketplace>` и `server:<name>`. Запрашивает подтверждение | `claude --dangerously-load-development-channels server:webhook` |78| `--dangerously-load-development-channels` | Включить [channels](/ru/channels-reference#test-during-the-research-preview), которые не находятся в утвержденном списке разрешений, для локальной разработки. Принимает записи `plugin:<name>@<marketplace>` и `server:<name>`. Запрашивает подтверждение | `claude --dangerously-load-development-channels server:webhook` |

79| `--dangerously-skip-permissions` | Пропустить запросы разрешения. Эквивалентно `--permission-mode bypassPermissions`. См. [режимы разрешения](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) для информации о том, что это пропускает и что не пропускает | `claude --dangerously-skip-permissions` |79| `--dangerously-skip-permissions` | Пропустить запросы разрешения. Эквивалентно `--permission-mode bypassPermissions`. См. [режимы разрешения](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) для информации о том, что это пропускает и что не пропускает. Для сеансов, запущенных с `--bg`, режим [сохраняется при перезапуске сеанса супервизором](/ru/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

80| `--debug` | Включить режим отладки с дополнительной фильтрацией категорий (например, `"api,hooks"` или `"!statsig,!file"`) | `claude --debug "api,mcp"` |80| `--debug` | Включить режим отладки с дополнительной фильтрацией категорий (например, `"api,hooks"` или `"!statsig,!file"`) | `claude --debug "api,mcp"` |

81| `--debug-file <path>` | Записать журналы отладки в конкретный путь файла. Неявно включает режим отладки. Имеет приоритет над `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |81| `--debug-file <path>` | Записать журналы отладки в конкретный путь файла. Неявно включает режим отладки. Имеет приоритет над `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |

82| `--disable-slash-commands` | Отключить все skills и команды для этого сеанса | `claude --disable-slash-commands` |82| `--disable-slash-commands` | Отключить все skills и команды для этого сеанса | `claude --disable-slash-commands` |


91| `--ide` | Автоматически подключиться к IDE при запуске, если доступна ровно одна действительная IDE | `claude --ide` |91| `--ide` | Автоматически подключиться к IDE при запуске, если доступна ровно одна действительная IDE | `claude --ide` |

92| `--init` | Запустить [Setup hooks](/ru/hooks#setup) с помощью matcher `init` перед сеансом (только режим печати) | `claude -p --init "query"` |92| `--init` | Запустить [Setup hooks](/ru/hooks#setup) с помощью matcher `init` перед сеансом (только режим печати) | `claude -p --init "query"` |

93| `--init-only` | Запустить [Setup](/ru/hooks#setup) и `SessionStart` hooks, затем выйти без запуска беседы | `claude --init-only` |93| `--init-only` | Запустить [Setup](/ru/hooks#setup) и `SessionStart` hooks, затем выйти без запуска беседы | `claude --init-only` |

94| `--include-hook-events` | Включить все события жизненного цикла hook в выходной поток. Требует `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |94| `--include-hook-events` | Включить события жизненного цикла hook из каждого события hook в выходной поток. События `SessionStart` и `Setup` hook всегда включены и не требуют этого флага. Требует `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |

95| `--include-partial-messages` | Включить частичные события потоковой передачи в вывод. Требует `--print` и `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |95| `--include-partial-messages` | Включить частичные события потоковой передачи в вывод. Требует `--print` и `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |

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

97| `--json-schema` | Получить проверенный вывод JSON, соответствующий JSON Schema после завершения рабочего процесса агента (только режим печати). См. [структурированные выходы](/ru/agent-sdk/structured-outputs). {/* min-version: 2.1.205 */}Claude Code выходит с ошибкой при недействительной схеме и принимает ключевое слово `format` как аннотацию без проверки на стороне клиента. До v2.1.205 недействительная схема выдавала неструктурированный вывод без ошибки, и схемы, использующие `format`, рассматривались как недействительные | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |97| `--json-schema` | Получить проверенный вывод JSON, соответствующий JSON Schema после завершения рабочего процесса агента (только режим печати). См. [структурированные выходы](/ru/agent-sdk/structured-outputs). {/* min-version: 2.1.205 */}Claude Code выходит с ошибкой при недействительной схеме и принимает ключевое слово `format` как аннотацию без проверки на стороне клиента. До v2.1.205 недействительная схема выдавала неструктурированный вывод без ошибки, и схемы, использующие `format`, рассматривались как недействительные | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |


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

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

107| `--permission-mode` | Начать в указанном [режиме разрешения](/ru/permission-modes). Принимает `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` или {/* min-version: 2.1.200 */}}`manual` как псевдоним для `default`. Псевдоним `manual` выбирает режим, который UI обозначает как Manual и требует Claude Code v2.1.200 или позже; `claude --help` выводит его вместо `default`, и оба значения работают. Переопределяет `defaultMode` из файлов параметров | `claude --permission-mode plan` |107| `--permission-mode` | Начать в указанном [режиме разрешения](/ru/permission-modes). Принимает `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` или {/* min-version: 2.1.200 */}}`manual` как псевдоним для `default`. Псевдоним `manual` выбирает режим, который UI обозначает как Manual и требует Claude Code v2.1.200 или позже; `claude --help` выводит его вместо `default`, и оба значения работают. Переопределяет `defaultMode` из файлов параметров | `claude --permission-mode plan` |

108| `--permission-prompt-tool` | Указать инструмент MCP для обработки запросов разрешения в неинтерактивном режиме. {/* min-version: 2.1.199 */}Начиная с v2.1.199, инструмент приглашения не может одобрить инструмент MCP, отмеченный как [требующий взаимодействия пользователя](/ru/mcp#require-approval-for-a-specific-tool): результат `allow` для одного преобразуется в отрицание | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |108| `--permission-prompt-tool` | Указать инструмент MCP для обработки запросов разрешения в неинтерактивном режиме. {/* min-version: 2.1.206 */}Claude Code ждет подключения MCP сервера этого инструмента перед запуском первого хода, до [MCP\_TIMEOUT](/ru/env-vars) стартового таймаута в 30 секунд. До v2.1.206 медленно запускающийся сервер мог привести к [выходу с ошибкой, что инструмент MCP не найден](/ru/errors#mcp-permission-prompt-tool-not-found). <br /><br />{/* min-version: 2.1.199 */}Инструмент приглашения не может одобрить инструмент MCP, отмеченный как [требующий взаимодействия пользователя](/ru/mcp#require-approval-for-a-specific-tool): Claude Code преобразует результат `allow` для одного в отрицание. Это ограничение требует Claude Code v2.1.199 или позже | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

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

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

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

costs.md +22 −5

Details

35 35 

36На плане Pro, Max, Team или Enterprise команда `/usage` также показывает разбивку того, что учитывается в пределах вашего плана. Она относит недавнее использование к skills, subagents, plugins и отдельным MCP серверам, каждый из которых показан в процентах от общего объёма. Нажмите `d` или `w` для переключения между последними 24 часами и последними 7 днями. Цифры являются приблизительными и вычисляются из локальной истории сессии на этом устройстве, поэтому использование с других устройств или claude.ai не включено.36На плане Pro, Max, Team или Enterprise команда `/usage` также показывает разбивку того, что учитывается в пределах вашего плана. Она относит недавнее использование к skills, subagents, plugins и отдельным MCP серверам, каждый из которых показан в процентах от общего объёма. Нажмите `d` или `w` для переключения между последними 24 часами и последними 7 днями. Цифры являются приблизительными и вычисляются из локальной истории сессии на этом устройстве, поэтому использование с других устройств или claude.ai не включено.

37 37 

38Когда запрос к пределам вашего плана не удаётся, чаще всего потому, что конечная точка использования имеет ограничение по частоте запросов, `/usage` показывает последние полосы использования, которые она загрузила на этом устройстве в течение последних 60 минут, вместе с примечанием `Showing last-known usage`, указывающим, как давно эти данные были получены. Нажмите `r` для повторной попытки; успешная повторная попытка заменяет последние известные полосы свежими данными. Без снимка из последних 60 минут `/usage` сообщает, что конечная точка использования имеет ограничение по частоте запросов и предлагает тот же ярлык повторной попытки. До версии v2.1.208 ограниченный по частоте запрос в сессии, которая ещё не загружала использование, всегда показывал ошибку без полос.

39 

38В [расширении VS Code](/ru/vs-code#check-account-and-usage) та же разбивка появляется в диалоговом окне Account & usage с переключателем Day и Week. Требуется Claude Code v2.1.174 или более поздняя версия.40В [расширении VS Code](/ru/vs-code#check-account-and-usage) та же разбивка появляется в диалоговом окне Account & usage с переключателем Day и Week. Требуется Claude Code v2.1.174 или более поздняя версия.

39 41 

40<h3 id="set-a-spend-limit-on-pro-and-max">42<h3 id="set-a-spend-limit-on-pro-and-max">

41 Установка лимита расходов на Pro и Max43 Установка лимита расходов на Pro и Max

42</h3>44</h3>

43 45 

44На планах Pro и Max вы можете установить ежемесячный лимит расходов на кредиты использования с помощью команды `/usage-credits`. Если вы достигнете этого лимита, пока у вас всё ещё есть доступные кредиты использования, Claude Code предложит вам увеличить или удалить лимит, чтобы вы могли продолжить работу без выхода из CLI. Изменение лимита требует доступа к выставлению счётов на счёте.46На планах Pro и Max команда `/usage-credits` открывает диалоговое окно в CLI, где вы управляете [кредитами использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans). Из диалогового окна вы можете:

47 

48* Включить кредиты использования для вашего аккаунта

49* Купить больше кредитов использования, либо предложенный пакет, либо пользовательскую сумму

50* Установить, изменить или удалить ежемесячный лимит расходов

51* Настроить автоматическую перезагрузку, которая автоматически покупает больше кредитов использования, когда ваш баланс падает ниже установленного вами порога

52 

53На версиях Claude Code до v2.1.207 и на аккаунтах, где диалоговое окно в CLI недоступно, `/usage-credits` открывает страницу выставления счётов за кредиты использования в вашем браузере. На планах Team и Enterprise члены с доступом к выставлению счётов получают ту же страницу браузера, а члены без доступа к выставлению счётов отправляют запрос из CLI, прося своего администратора включить кредиты использования или увеличить лимит.

54 

55Изменение ежемесячного лимита расходов требует доступа к выставлению счётов на аккаунте. Если вы достигнете лимита, пока у вас всё ещё есть доступные кредиты использования, Claude Code предложит вам увеличить или удалить его, чтобы вы могли продолжить без выхода из CLI.

56 

57Суммы, которые вы вводите в диалоговое окно, такие как пользовательская сумма покупки, ежемесячный лимит расходов или порог и целевое значение автоматической перезагрузки, должны быть цифрами, опционально за которыми следует точка и одна или две десятичные цифры, например `20` или `20.50`. Любой другой ввод, включая запятые, показывает встроенную ошибку и не сохраняется. Версии до v2.1.207 не показывают диалоговое окно и открывают страницу выставления счётов.

58 

59Claude Code просит вас ввести `yes` для подтверждения каждой покупки и каждого изменения автоматической перезагрузки, независимо от суммы, и подтверждение покупки показывает итоговую сумму с налогом, которую вы одобряете. Изменение ежемесячного лимита расходов требует того же введённого подтверждения только выше \$1,000 или выше 1,000 единиц валюты выставления счётов, отличной от доллара США. До версии v2.1.208 покупки и изменения автоматической перезагрузки использовали этот же порог, поэтому меньшие суммы проходили через стандартный поток диалогового окна без дополнительного введённого шага `yes`.

60 

61Поля сумм открываются с предложенным значением, и первая цифра, которую вы вводите, заменяет предложение вместо добавления к нему. Экран, который включает кредиты использования, открывается с выбранной опцией Cancel, поэтому их включение требует намеренного выбора, а не случайного нажатия Enter. Оба требуют Claude Code v2.1.208 или более поздней версии.

45 62 

46<h2 id="manage-costs-for-your-organization">63<h2 id="manage-costs-for-your-organization">

47 Управление затратами для вашей организации64 Управление затратами для вашей организации


52В таблице указано, где вы видите расходы, где их ограничиваете и как получить данные по пользователям для каждой конфигурации.69В таблице указано, где вы видите расходы, где их ограничиваете и как получить данные по пользователям для каждой конфигурации.

53 70 

54| Ваша конфигурация | Просмотр расходов | Ограничение расходов | Отчётность по пользователям |71| Ваша конфигурация | Просмотр расходов | Ограничение расходов | Отчётность по пользователям |

55| :-------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |72| :-------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

56| [Claude for Teams или Enterprise](#claude-for-teams-and-enterprise) | [Отчёт о расходах в аналитике организации](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) | Лимиты расходов в параметрах администратора | [CSV отчёт о расходах](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans); [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) на Enterprise |73| [Claude for Teams или Enterprise](#claude-for-teams-and-enterprise) | [Отчёт о расходах в аналитике организации](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) | Лимиты расходов в параметрах администратора | [CSV отчёт о расходах](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans); [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) на Enterprise |

57| [Claude Console (API)](#claude-console) | [Страница использования Console](https://platform.claude.com/usage) | Лимиты расходов рабочего пространства | [Панель управления Console](https://platform.claude.com/claude-code), [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) |74| [Claude Console (API)](#claude-console) | [Страница использования Console](https://platform.claude.com/usage) | Лимиты расходов рабочего пространства | [Панель управления Console](https://platform.claude.com/claude-code), [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) |

58| [Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](#cloud-providers) | Ваша консоль биллинга облака | Элементы управления бюджетом вашего облака | [OpenTelemetry](/ru/monitoring-usage) или [LLM gateway](/ru/llm-gateway) |75| [Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](#cloud-providers) | Ваша консоль биллинга облака | Элементы управления бюджетом вашего облака | [OpenTelemetry](/ru/monitoring-usage) или [LLM gateway](/ru/llm-gateway) |

59 76 


63 Claude for Teams и Enterprise80 Claude for Teams и Enterprise

64</h3>81</h3>

65 82 

66На планах Claude for Teams и Enterprise использование Claude Code каждого члена команды берётся из лимита на одного пользователя, который сбрасывается в скользящем пятичасовом окне и еженедельном окне. Лимит совместно используется с Claude chat и Cowork, а его размер зависит от [уровня места](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan). Ваши элементы управления находятся в консоли администратора claude.ai, а не в Claude Console.83На планах Claude for Teams и Enterprise использование Claude Code каждого члена команды берётся из лимита на одного пользователя, который сбрасывается в скользящем пятичасовом окне и еженедельном окне. Лимит совместно используется с Claude chat и Cowork, а его размер зависит от [уровня места](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan) (Standard или Premium). Ваши элементы управления находятся в консоли администратора claude.ai, а не в Claude Console.

67 84 

68* **Просмотр расходов**: [отчёт о расходах в аналитике организации](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) показывает предполагаемые расходы по пользователям и по моделям с экспортом CSV, обновляется ежедневно. Отчёт охватывает расходы кредитов использования и появляется после включения кредитов использования. Использование в пределах лимита на одного пользователя не учитывается в долларах.85* **Просмотр расходов**: [отчёт о расходах в аналитике организации](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) показывает предполагаемые расходы по пользователям и по моделям с экспортом CSV, обновляется ежедневно. Отчёт охватывает расходы кредитов использования и появляется после включения кредитов использования. Использование в пределах лимита на одного пользователя не учитывается в долларах.

69* **Просмотр внедрения**: [панель аналитики](https://claude.ai/analytics/claude-code) показывает ежедневно активных пользователей, сеансы и метрики вклада с экспортом CSV данных о вкладе. См. [отслеживание использования команды с помощью аналитики](/ru/analytics).86* **Просмотр внедрения**: [панель аналитики](https://claude.ai/analytics/claude-code) показывает ежедневно активных пользователей, сеансы и метрики вклада с экспортом CSV данных о вкладе. См. [отслеживание использования команды с помощью аналитики](/ru/analytics).

70* **Ограничение расходов**: лимит на одного пользователя является потолком по умолчанию. Чтобы позволить членам продолжить работу после его достижения, включите [кредиты использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) и установите лимиты расходов на уровне организации, группы или отдельного члена команды.87* **Ограничение расходов**: лимит на одного пользователя является потолком по умолчанию. Чтобы позволить членам продолжить работу после его достижения, включите [кредиты использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) и установите лимиты расходов на уровне организации, группы или отдельного члена команды.

71* **Получение данных по пользователям**: на плане Enterprise [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) возвращает отчёты об использовании и затратах по пользователям на всех поверхностях Claude, включая Claude Code. Основной владелец создаёт ключ с областью `read:analytics` на [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys). На плане Teams экспортируйте [CSV отчёт о расходах](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans), который содержит использование токенов и предполагаемые расходы по пользователям и по моделям.88* **Получение данных по пользователям**: на плане Enterprise [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) возвращает отчёты об использовании и затратах по пользователям на всех поверхностях Claude, включая Claude Code. Основной владелец создаёт ключ с областью `read:analytics` на [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys). На плане Teams экспортируйте [CSV отчёт о расходах](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans), который содержит использование токенов и предполагаемые расходы по пользователям и по моделям.

72 89 

73[Руководство по потреблению Claude Enterprise](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide) является справочником по планированию для администраторов. Оно объясняет, как потребление отличается на Claude chat, Claude Code и Cowork, и даёт начальные точки в долларах на пользователя для бюджетирования. Выделите больше средств на место для кодирования, чем на место для чата: каждый ход Claude Code содержит содержимое файлов, вызовы инструментов и многошаговое рассуждение, поэтому один сеанс отладки может потребить больше, чем день чата.90[Руководство по потреблению Claude Enterprise](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide) является справочником по планированию для администраторов. Оно объясняет, как потребление отличается на Claude chat, Claude Code и Cowork, и даёт начальные точки в долларах на пользователя для бюджетирования. Выделите больше средств на место для кодирования, чем на место для чата: каждый ход Claude Code содержит содержимое файлов, вызовы инструментов и многошаговое рассуждение, поэтому один сеанс отладки может потребить больше, чем день чата.

74 91 

data-usage.md +17 −8

Details

75 Доступ к данным75 Доступ к данным

76</h2>76</h2>

77 77 

78Для всех пользователей первой стороны вы можете узнать больше о том, какие данные регистрируются для [локального Claude Code](#local-claude-code-data-flow-and-dependencies) и [удалённого Claude Code](#cloud-execution-data-flow-and-dependencies). Сеансы [Remote Control](/ru/remote-control) следуют локальному потоку данных, поскольку всё выполнение происходит на вашей машине. Обратите внимание, что для удалённого Claude Code Claude получает доступ к репозиторию, в котором вы инициируете сеанс Claude Code. Claude не получает доступ к репозиториям, которые вы подключили, но в которых не начали сеанс.78Для всех пользователей первой стороны вы можете узнать больше о том, какие данные регистрируются для [локального Claude Code](#local-claude-code-data-flow-and-dependencies) и [удалённого Claude Code](#cloud-execution-data-flow-and-dependencies). Сеансы [Remote Control](/ru/remote-control) следуют локальному потоку данных, поскольку всё выполнение происходит на вашей машине; во время подключения транскрипт сеанса также хранится на серверах Anthropic для синхронизации беседы между устройствами, как описано в разделе [Connection and security](/ru/remote-control#connection-and-security). Обратите внимание, что для удалённого Claude Code Claude получает доступ к репозиторию, в котором вы инициируете сеанс Claude Code. Claude не получает доступ к репозиториям, которые вы подключили, но в которых не начали сеанс.

79 79 

80<h2 id="local-claude-code-data-flow-and-dependencies">80<h2 id="local-claude-code-data-flow-and-dependencies">

81 Local Claude Code: поток данных и зависимости81 Local Claude Code: поток данных и зависимости


83 83 

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

85 85 

86<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/claude-code-data-flow.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=5b1131530bdfdd415700a0cb4d4070c4" alt="Диаграмма, показывающая внешние соединения Claude Code: установка/обновление подключается к серверу распределения, а запросы пользователя подключаются к сервисам Anthropic, включая Console auth, public-api, и опционально metrics и Sentry. Отзывы, отправленные с помощью /feedback, идут в Google Cloud Storage и опционально создают проблему GitHub" width="720" height="520" data-path="images/claude-code-data-flow.svg" />86<img src="https://mintcdn.com/claude-code/YR4DRZyI3CdsXkiT/images/claude-code-data-flow.svg?fit=max&auto=format&n=YR4DRZyI3CdsXkiT&q=85&s=2846ea92cfc2297b8620c31c82b482ad" alt="Диаграмма, показывающая внешние соединения Claude Code: установка/обновление подключается к серверу распределения, а запросы пользователя подключаются к Anthropic Console auth и public-api, с дополнительными потоками телеметрии, передающими метрики и отчёты об ошибках в Anthropic и сторонние сервисы. Отзывы, отправленные с помощью /feedback, идут в Google Cloud Storage и опционально создают проблему GitHub" width="720" height="520" data-path="images/claude-code-data-flow.svg" />

87 87 

88Claude Code работает локально. Для взаимодействия с LLM Claude Code отправляет данные по сети. Эти данные включают все подсказки пользователя и выходные данные модели, зашифрованные при передаче через TLS 1.2+. Claude Code совместим с большинством популярных VPN и прокси LLM.88Claude Code работает локально. Для взаимодействия с LLM Claude Code отправляет данные по сети. Эти данные включают все подсказки пользователя и выходные данные модели, зашифрованные при передаче через TLS 1.2+. Claude Code совместим с большинством популярных VPN и прокси LLM.

89 89 


115 Сервисы телеметрии115 Сервисы телеметрии

116</h2>116</h2>

117 117 

118Claude Code подключается с машин пользователей к Anthropic для логирования операционных метрик, таких как задержка, надёжность и паттерны использования. Это логирование не включает никакой код или пути к файлам. Данные зашифрованы при передаче и в покое. Чтобы отказаться от телеметрии, установите переменную окружения `DISABLE_TELEMETRY`.118Claude Code отправляет два вида операционной телеметрии: метрики использования и отчёты об ошибках. Вы можете отключить каждый из них отдельно с помощью переменных окружения ниже, или отключить весь неэссенциальный трафик сразу, установив `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`.

119 119 

120Claude Code подключается с машин пользователей к Sentry для логирования операционных ошибок. Данные зашифрованы при передаче с использованием TLS и в покое с использованием 256-битного шифрования AES. Подробнее см. в [документации по безопасности Sentry](https://sentry.io/security/). Чтобы отказаться от логирования ошибок, установите переменную окружения `DISABLE_ERROR_REPORTING`.120**Метрики**: задержка, надёжность и паттерны использования, отправляются в Anthropic и в инфраструктуру логирования третьих сторон через TLS. Метрики никогда не включают ваш код, подсказки или пути к файлам. Установите `DISABLE_TELEMETRY=1`, чтобы отказаться.

121 

122**Отчёты об ошибках**: сообщения об ошибках и трассировки стека из собственных внутренних компонентов Claude Code, отправляются в сервис отслеживания ошибок третьей стороны через TLS. Claude Code удаляет известные паттерны секретов, путей к файлам, адресов электронной почты и другой личной информации перед тем, как что-либо покидает вашу машину. Установите `DISABLE_ERROR_REPORTING=1`, чтобы отказаться.

123 

124Отчёты об ошибках включены только когда выполняются все эти условия:

125 

126* вы входите с подпиской Claude Pro или Max

127* вы используете Claude Code v2.1.198 или позже

128* вы подключаетесь напрямую к Claude API

129* ваша организация не имеет соглашения о нулевом сохранении данных или HIPAA

121 130 

122Когда вы выполняете команду `/feedback`, копия вашей истории разговора, включая код, отправляется в Anthropic. Перед отправкой вы выбираете, сколько истории включить: только текущую сессию, что является значением по умолчанию, или также другие сессии из того же проекта за последние 24 часа или 7 дней. Данные зашифрованы при передаче через TLS и хранятся в Google Cloud Storage, которая по умолчанию шифрует хранящиеся данные в покое. Опционально создаётся проблема GitHub в публичном репозитории. Чтобы отказаться, установите переменную окружения `DISABLE_FEEDBACK_COMMAND` на `1`.131Когда вы выполняете команду `/feedback`, копия вашей истории разговора, включая код, отправляется в Anthropic. Перед отправкой вы выбираете, сколько истории включить: только текущую сессию, что является значением по умолчанию, или также другие сессии из того же проекта за последние 24 часа или 7 дней. Данные зашифрованы при передаче через TLS и хранятся в Google Cloud Storage, которая по умолчанию шифрует хранящиеся данные в покое. Опционально создаётся проблема GitHub в публичном репозитории. Чтобы отказаться, установите переменную окружения `DISABLE_FEEDBACK_COMMAND` на `1`.

123 132 


130По умолчанию отчёты об ошибках, телеметрия и отчёты об ошибках отключены при использовании Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform on AWS. Опросы о качестве сеанса и проверка безопасности домена WebFetch являются исключениями и выполняются независимо от поставщика. На сеансе с подписью [Claude apps gateway](/ru/claude-apps-gateway) аналитика использования, отчёты об ошибках и оценки опросов для Anthropic отключены самим учётным данным шлюза, без возможности их повторного включения. Вы можете отказаться от всего несущественного трафика, включая опросы, сразу же, установив `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`. Эта переменная не влияет на проверку WebFetch, которая имеет свой собственный отказ. Вот полное поведение по умолчанию:139По умолчанию отчёты об ошибках, телеметрия и отчёты об ошибках отключены при использовании Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform on AWS. Опросы о качестве сеанса и проверка безопасности домена WebFetch являются исключениями и выполняются независимо от поставщика. На сеансе с подписью [Claude apps gateway](/ru/claude-apps-gateway) аналитика использования, отчёты об ошибках и оценки опросов для Anthropic отключены самим учётным данным шлюза, без возможности их повторного включения. Вы можете отказаться от всего несущественного трафика, включая опросы, сразу же, установив `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`. Эта переменная не влияет на проверку WebFetch, которая имеет свой собственный отказ. Вот полное поведение по умолчанию:

131 140 

132| Сервис | Claude API | Google Cloud's Agent Platform API | Amazon Bedrock API | Microsoft Foundry API | Claude Platform on AWS |141| Сервис | Claude API | Google Cloud's Agent Platform API | Amazon Bedrock API | Microsoft Foundry API | Claude Platform on AWS |

133| ------------------------------------ | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |142| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |

134| **Anthropic (Metrics)** | По умолчанию включено.<br />`DISABLE_TELEMETRY=1` для отключения. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_VERTEX` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_BEDROCK` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_FOUNDRY` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` должен быть 1. |143| **Metrics** | По умолчанию включено.<br />`DISABLE_TELEMETRY=1` для отключения. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_VERTEX` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_BEDROCK` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_FOUNDRY` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` должен быть 1. |

135| **Sentry (Errors)** | По умолчанию включено.<br />`DISABLE_ERROR_REPORTING=1` для отключения. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_VERTEX` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_BEDROCK` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_FOUNDRY` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` должен быть 1. |144| **Error reports** | По умолчанию включено для подписок Pro и Max на v2.1.198+, в противном случае отключено.<br />`DISABLE_ERROR_REPORTING=1` для отключения. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_VERTEX` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_BEDROCK` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_FOUNDRY` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` должен быть 1. |

136| **Claude API (`/feedback` reports)** | По умолчанию включено.<br />`DISABLE_FEEDBACK_COMMAND=1` для отключения. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_VERTEX` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_BEDROCK` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_FOUNDRY` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` должен быть 1. |145| **Claude API (`/feedback` reports)** | По умолчанию включено.<br />`DISABLE_FEEDBACK_COMMAND=1` для отключения. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_VERTEX` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_BEDROCK` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_FOUNDRY` должен быть 1. | По умолчанию отключено.<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` должен быть 1. |

137| **Session quality surveys** | По умолчанию включено.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. |146| **Session quality surveys** | По умолчанию включено.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. | По умолчанию включено.<br />`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` для отключения. |

138| **WebFetch domain safety check** | По умолчанию включено.<br />`skipWebFetchPreflight: true` в [settings](/ru/settings) для отключения. | По умолчанию включено.<br />`skipWebFetchPreflight: true` в [settings](/ru/settings) для отключения. | По умолчанию включено.<br />`skipWebFetchPreflight: true` в [settings](/ru/settings) для отключения. | По умолчанию включено.<br />`skipWebFetchPreflight: true` в [settings](/ru/settings) для отключения. | По умолчанию включено.<br />`skipWebFetchPreflight: true` в [settings](/ru/settings) для отключения. |147| **WebFetch domain safety check** | По умолчанию включено.<br />`skipWebFetchPreflight: true` в [settings](/ru/settings) для отключения. | По умолчанию включено.<br />`skipWebFetchPreflight: true` в [settings](/ru/settings) для отключения. | По умолчанию включено.<br />`skipWebFetchPreflight: true` в [settings](/ru/settings) для отключения. | По умолчанию включено.<br />`skipWebFetchPreflight: true` в [settings](/ru/settings) для отключения. | По умолчанию включено.<br />`skipWebFetchPreflight: true` в [settings](/ru/settings) для отключения. |

139 148 

140Все переменные окружения можно проверить в `settings.json` (см. [settings reference](/ru/settings)).149Все переменные окружения можно проверить в `settings.json` (см. [settings reference](/ru/settings)).

141 150 

142Начиная с версии 2.1.126, когда хост-платформа устанавливает `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`, метрики по умолчанию включены для Google Cloud's Agent Platform, Amazon Bedrock и Microsoft Foundry и следуют стандартному отказу `DISABLE_TELEMETRY`. Отчёты об ошибках Sentry и отчёты `/feedback` остаются отключены по умолчанию на этих поставщиках.151Начиная с версии 2.1.126, когда хост-платформа устанавливает `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`, метрики по умолчанию включены для Google Cloud's Agent Platform, Amazon Bedrock и Microsoft Foundry и следуют стандартному отказу `DISABLE_TELEMETRY`. Отчёты об ошибках и отчёты `/feedback` остаются отключены по умолчанию на этих поставщиках.

143 152 

144<h3 id="webfetch-domain-safety-check">153<h3 id="webfetch-domain-safety-check">

145 WebFetch domain safety check154 WebFetch domain safety check

Details

19Для деталей по конкретной категории используйте специализированную команду:19Для деталей по конкретной категории используйте специализированную команду:

20 20 

21| Команда | Показывает |21| Команда | Показывает |

22| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |22| :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

23| `/memory` | Какие файлы `CLAUDE.md` и rules загрузились, плюс записи auto-memory |23| `/memory` | Какие файлы `CLAUDE.md` и rules загрузились, плюс записи auto-memory |

24| `/skills` | Доступные skills из проекта, пользователя и источников плагинов |24| `/skills` | Доступные skills из проекта, пользователя и источников плагинов |

25| `/hooks` | Активные конфигурации hooks |25| `/hooks` | Активные конфигурации hooks |

26| `/mcp` | Подключённые MCP серверы и их статус |26| `/mcp` | Подключённые MCP серверы и их статус |

27| `/permissions` | Разрешённые и запрещённые правила, которые в настоящее время действуют |27| `/permissions` | Разрешённые и запрещённые правила, которые в настоящее время действуют |

28| `/doctor` | Диагностика конфигурации: неверные ключи, ошибки схемы, здоровье установки, неиспользуемые расширения и дублирующиеся имена [subagent](/ru/sub-agents) в одной папке с предложенными исправлениями |28| `/doctor` | Диагностика конфигурации: здоровье установки, неверные файлы параметров, неиспользуемые расширения, дублирующиеся имена [subagent](/ru/sub-agents) в одной папке и проверенное содержимое `CLAUDE.md`, которое Claude может вывести из кодовой базы, с предложенными исправлениями |

29| `/debug [issue]` | Включает логирование отладки для сессии и предлагает Claude диагностировать, используя вывод журнала и пути параметров |29| `/debug [issue]` | Включает логирование отладки для сессии и предлагает Claude диагностировать, используя вывод журнала и пути параметров |

30| `/status` | Активные источники параметров, включая то, действуют ли управляемые параметры |30| `/status` | Активные источники параметров, включая то, действуют ли управляемые параметры |

31 31 


45 45 

46Параметры объединяются в управляемых, пользовательских, проектных и локальных областях. Управляемые параметры всегда выигрывают, когда присутствуют. Среди остальных, более близкая область переопределяет более широкую в порядке локальная, затем проект, затем пользователь. Некоторые параметры также можно устанавливать флагами командной строки или [переменными окружения](/ru/env-vars), которые действуют как ещё один слой переопределения. Когда параметр не кажется применяемым, значение, которое вы установили, обычно переопределяется другой областью или переменной окружения.46Параметры объединяются в управляемых, пользовательских, проектных и локальных областях. Управляемые параметры всегда выигрывают, когда присутствуют. Среди остальных, более близкая область переопределяет более широкую в порядке локальная, затем проект, затем пользователь. Некоторые параметры также можно устанавливать флагами командной строки или [переменными окружения](/ru/env-vars), которые действуют как ещё один слой переопределения. Когда параметр не кажется применяемым, значение, которое вы установили, обычно переопределяется другой областью или переменной окружения.

47 47 

48Запустите `/doctor`, чтобы проверить вашу конфигурацию и установку. Он сообщает о том, что находит, включая неверные файлы параметров, дублирующиеся установки и неиспользуемые расширения, затем предлагает исправления, которые применяет только после вашего подтверждения. До версии 2.1.205 `/doctor` открывал экран диагностики только для чтения, и нажатие `f` отправляло отчёт Claude для исправления.48Запустите `/doctor`, чтобы проверить вашу конфигурацию и установку. Он сообщает о том, что находит, включая неверные файлы параметров, дублирующиеся установки, неиспользуемые расширения и {/* min-version: 2.1.206 */}проверенное содержимое `CLAUDE.md`, которое Claude может вывести из кодовой базы, затем предлагает исправления, которые применяет только после вашего подтверждения. Проверка обрезки `CLAUDE.md` требует Claude Code v2.1.206 или позже. До версии 2.1.205 `/doctor` открывал экран диагностики только для чтения, и нажатие `f` отправляло отчёт Claude для исправления.

49 49 

50Из терминала `claude doctor` выводит диагностику установки и параметров только для чтения без запуска сеанса.50Из терминала `claude doctor` выводит диагностику установки и параметров только для чтения без запуска сеанса.

51 51 

desktop.md +80 −19

Details

80 80 

81Режимы разрешений контролируют, сколько автономности имеет Claude во время сеанса: спрашивает ли он перед редактированием файлов, запуском команд или обоих. Вы можете переключать режимы в любое время, используя селектор режима рядом с кнопкой отправки. Начните с Manual, чтобы увидеть ровно то, что делает Claude, затем переходите к Accept edits или Plan по мере того, как вы становитесь более уверены.81Режимы разрешений контролируют, сколько автономности имеет Claude во время сеанса: спрашивает ли он перед редактированием файлов, запуском команд или обоих. Вы можете переключать режимы в любое время, используя селектор режима рядом с кнопкой отправки. Начните с Manual, чтобы увидеть ровно то, что делает Claude, затем переходите к Accept edits или Plan по мере того, как вы становитесь более уверены.

82 82 

83Чтобы установить режим по умолчанию для новых локальных сеансов, добавьте `permissions.defaultMode` в ваш [файл параметров](/ru/settings#settings-files). Приложение для рабочего стола читает те же файлы параметров, что и CLI. Режим, который вы выбираете в селекторе, запоминается для каждой папки и имеет приоритет над `defaultMode` для этой папки, кроме Plan, который применяется только к текущему сеансу.

84 

83| Режим | Ключ параметров | Поведение |85| Режим | Ключ параметров | Поведение |

84| ---------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |86| ---------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

85| **Manual** | `default` | Claude спрашивает перед редактированием файлов или запуском команд. Вы видите различия и можете принять или отклонить каждое изменение. Рекомендуется для новых пользователей. |87| **Manual** | `default` | Claude спрашивает перед редактированием файлов или запуском команд. Вы видите различия и можете принять или отклонить каждое изменение. Рекомендуется для новых пользователей. |

86| **Accept edits** | `acceptEdits` | Claude автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch` и `mv`, но всё ещё спрашивает перед запуском других команд терминала. Используйте это, когда вы доверяете изменениям файлов и хотите более быструю итерацию. |88| **Accept edits** | `acceptEdits` | Claude автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch` и `mv`, но всё ещё спрашивает перед запуском других команд терминала. Используйте это, когда вы доверяете изменениям файлов и хотите более быструю итерацию. |

87| **Plan** | `plan` | Claude читает файлы и запускает команды для исследования, затем предлагает план без редактирования вашего исходного кода. Хорошо для сложных задач, где вы хотите сначала проверить подход. |89| **Plan** | `plan` | Claude читает файлы и запускает команды для исследования, затем предлагает план без редактирования вашего исходного кода. Хорошо для сложных задач, где вы хотите сначала проверить подход. |

88| **Auto** | `auto` | Claude выполняет все действия с фоновыми проверками безопасности, которые проверяют соответствие вашему запросу. Снижает подсказки разрешений при сохранении надзора. Включите в Settings Claude Code. См. [требования доступности](#auto-mode-availability) ниже. |90| **Auto** | `auto` | Claude выполняет все действия с фоновыми проверками безопасности, которые проверяют соответствие вашему запросу. Снижает подсказки разрешений при сохранении надзора. Появляется, когда ваша учётная запись соответствует [требованиям доступности](#auto-mode-availability) ниже; отдельного переключателя Settings для этого нет. |

89| **Bypass permissions** | `bypassPermissions` | Claude работает без каких-либо подсказок разрешений, кроме тех, которые вынуждены явными [правилами запроса](/ru/permissions#manage-permissions) или классификаторами безопасности, когда Claude [действует на внешних сайтах](#browse-external-sites); эквивалентно `--dangerously-skip-permissions` в CLI. Включите в Settings → Claude Code под "Allow bypass permissions mode". Используйте только в изолированных контейнерах или виртуальных машинах. Администраторы предприятия могут отключить эту опцию. |91| **Bypass permissions** | `bypassPermissions` | Claude работает без подсказок разрешений, кроме тех, которые вынуждены явными [правилами запроса](/ru/permissions#manage-permissions), инструментами коннектора [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools), инструментами MCP, отмеченными [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), или классификаторами безопасности, когда Claude [действует на внешних сайтах](#browse-external-sites); эквивалентно `--dangerously-skip-permissions` в CLI. На планах Pro и Max включите это в Settings → Claude Code под "Allow bypass permissions mode"; на планах Team и Enterprise нет переключателя Settings, и политика организации контролирует это вместо этого. Используйте только в изолированных контейнерах или виртуальных машинах. |

90 92 

91Более ранние версии вкладки Code обозначали эти режимы как Ask permissions, Auto accept edits и Plan mode.93Более ранние версии вкладки Code обозначали эти режимы как Ask permissions, Auto accept edits и Plan mode.

92 94 


94 96 

95<span id="auto-mode-availability" />97<span id="auto-mode-availability" />

96 98 

97Auto mode доступен всем пользователям на Anthropic API и требует Claude Opus 4.6 или позже, или Sonnet 4.6 или позже. В развёртываниях Enterprise, которые маршрутизируют Desktop на Google Cloud's Agent Platform, auto mode отключен до тех пор, пока вы не [установите `CLAUDE_CODE_ENABLE_AUTO_MODE`](/ru/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), и там поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8.99Auto mode доступен всем пользователям на Anthropic API и требует Claude Opus 4.6 или позже, или Sonnet 4.6 или позже. Администраторы организации могут отключить auto mode с помощью ключа `disableAutoMode` в [управляемых параметрах](#managed-settings).

100 

101В развёртываниях Enterprise, которые маршрутизируют Desktop на Google Cloud's Agent Platform, auto mode [доступен по умолчанию](/ru/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), и там поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8. {/* min-version: 2.1.207 */}До Claude Code v2.1.207 развёртывания Enterprise на Google Cloud's Agent Platform должны были установить `CLAUDE_CODE_ENABLE_AUTO_MODE` для включения auto mode.

98 102 

99<Tip title="Best practice">103<Tip title="Best practice">

100 Начните сложные задачи в Plan, чтобы Claude наметил подход перед внесением изменений. После одобрения плана переключитесь на Accept edits или Manual для его выполнения. См. [explore first, then plan, then code](/ru/best-practices#explore-first-then-plan-then-code) для получения дополнительной информации об этом рабочем процессе.104 Начните сложные задачи в Plan, чтобы Claude наметил подход перед внесением изменений. После одобрения плана переключитесь на Accept edits или Manual для его выполнения. См. [explore first, then plan, then code](/ru/best-practices#explore-first-then-plan-then-code) для получения дополнительной информации об этом рабочем процессе.


155 159 

156Browser следует тем же [элементам управления списком разрешённых и заблокированных сайтов](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls), что и Claude in Chrome extension. Если ваша организация уже настроила эти списки для расширения, Browser уважает их автоматически. Администраторы также могут отключить инструменты Claude на внешних страницах с помощью параметра управления [`browserExternalPageTools`](#managed-settings). С отключёнными инструментами пользователи всё ещё могут переходить на внешние сайты; инструменты Claude не могут читать или действовать на них.160Browser следует тем же [элементам управления списком разрешённых и заблокированных сайтов](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls), что и Claude in Chrome extension. Если ваша организация уже настроила эти списки для расширения, Browser уважает их автоматически. Администраторы также могут отключить инструменты Claude на внешних страницах с помощью параметра управления [`browserExternalPageTools`](#managed-settings). С отключёнными инструментами пользователи всё ещё могут переходить на внешние сайты; инструменты Claude не могут читать или действовать на них.

157 161 

162Чтобы полностью отключить внешний просмотр, установите параметр управления [`disableBrowserExternalNavigation`](#managed-settings) на `true`. Это блокирует всю внешнюю навигацию в Browser, включая сайты в списке разрешённых вашей организации; локальные dev-серверы и предпросмотры файлов продолжают работать. Используйте `browserExternalPageTools` для того, чтобы позволить пользователям продолжать просмотр внешних сайтов без инструментов Claude, и `disableBrowserExternalNavigation` для блокирования внешних сайтов как для пользователей, так и для Claude.

163 

158<h3 id="review-changes-with-diff-view">164<h3 id="review-changes-with-diff-view">

159 Просмотр изменений с помощью diff view165 Просмотр изменений с помощью diff view

160</h3>166</h3>


313 319 

314<Steps>320<Steps>

315 <Step title="Обновление приложения desktop">321 <Step title="Обновление приложения desktop">

316 Убедитесь, что у вас есть последняя версия Claude Desktop. Загрузите или обновите на [claude.com/download](https://claude.com/download), затем перезагрузите приложение.322 Убедитесь, что у вас есть последняя версия Claude Desktop. На macOS и Windows загрузите или обновите на [claude.com/download](https://claude.com/download); на Linux обновите через ваш менеджер пакетов ([инструкции](/ru/desktop-linux)). Затем перезагрузите приложение.

317 </Step>323 </Step>

318 324 

319 <Step title="Включение переключателя">325 <Step title="Включение переключателя">


418 Сеансы из Dispatch424 Сеансы из Dispatch

419</h3>425</h3>

420 426 

421[Dispatch](https://support.claude.com/en/articles/13947068) — это постоянный разговор с Claude, который живёт на вкладке [Cowork](https://claude.com/product/cowork#dispatch-and-computer-use). Вы отправляете Dispatch задачу, и он решает, как её обработать.427[Dispatch](https://support.claude.com/en/articles/13947068) — это постоянный разговор с Claude, который живёт на вкладке [Cowork](https://claude.com/product/cowork). Вы отправляете Dispatch задачу, и он решает, как её обработать.

422 428 

423Задача может стать сеансом Code двумя способами: вы просите его напрямую, например "откройте сеанс Claude Code и исправьте ошибку входа", или Dispatch решает, что задача — это работа разработки и порождает один самостоятельно. Задачи, которые обычно маршрутизируются в Code, включают исправление ошибок, обновление зависимостей, запуск тестов или открытие pull requests. Исследование, редактирование документов и работа с электронными таблицами остаются в Cowork.429Задача может стать сеансом Code двумя способами: вы просите его напрямую, например "откройте сеанс Claude Code и исправьте ошибку входа", или Dispatch решает, что задача — это работа разработки и порождает один самостоятельно. Задачи, которые обычно маршрутизируются в Code, включают исправление ошибок, обновление зависимостей, запуск тестов или открытие pull requests. Исследование, редактирование документов и работа с электронными таблицами остаются в Cowork.

424 430 


454 460 

455[Skills](/ru/skills) расширяют возможности Claude. Claude загружает их автоматически, когда они релевантны, или вы можете вызвать один напрямую: введите `/` в поле подсказки или нажмите кнопку **+** и выберите **Slash commands**, чтобы просмотреть доступные. Это включает [встроенные команды](/ru/commands), ваши [пользовательские skills](/ru/skills#create-your-first-skill), skills проекта из вашей кодовой базы и skills из любых [установленных плагинов](/ru/plugins). Выберите один, и он появится выделенным в поле ввода. Введите вашу задачу после него и отправьте как обычно.461[Skills](/ru/skills) расширяют возможности Claude. Claude загружает их автоматически, когда они релевантны, или вы можете вызвать один напрямую: введите `/` в поле подсказки или нажмите кнопку **+** и выберите **Slash commands**, чтобы просмотреть доступные. Это включает [встроенные команды](/ru/commands), ваши [пользовательские skills](/ru/skills#create-your-first-skill), skills проекта из вашей кодовой базы и skills из любых [установленных плагинов](/ru/plugins). Выберите один, и он появится выделенным в поле ввода. Введите вашу задачу после него и отправьте как обычно.

456 462 

463Вы можете отправить команду, пока Claude работает, так же как любое другое сообщение, и сеанс вернётся в режим ожидания после завершения хода. До версии 2.1.206 команда, отправленная во время хода, могла оставить сеанс в состоянии выполнения, и сообщения, которые вы отправили впоследствии, не доставлялись.

464 

457<h3 id="install-plugins">465<h3 id="install-plugins">

458 Установка плагинов466 Установка плагинов

459</h3>467</h3>


737| `disableAutoMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима [Auto](/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет Auto из селектора режима. Также принимается под `permissions`. |745| `disableAutoMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима [Auto](/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет Auto из селектора режима. Также принимается под `permissions`. |

738| `autoMode` | настройте, что классификатор auto mode доверяет и блокирует во всей вашей организации. См. [Configure auto mode](/ru/auto-mode-config). |746| `autoMode` | настройте, что классификатор auto mode доверяет и блокирует во всей вашей организации. См. [Configure auto mode](/ru/auto-mode-config). |

739| `browserExternalPageTools` | установите на `"disabled"`, чтобы предотвратить Claude от использования инструментов для чтения или действия на внешних страницах в [панели браузера](#browse-external-sites). Пользователи по-прежнему могут самостоятельно переходить на внешние сайты, и предпросмотры локального сервера разработки не затронуты. |747| `browserExternalPageTools` | установите на `"disabled"`, чтобы предотвратить Claude от использования инструментов для чтения или действия на внешних страницах в [панели браузера](#browse-external-sites). Пользователи по-прежнему могут самостоятельно переходить на внешние сайты, и предпросмотры локального сервера разработки не затронуты. |

748| `disableBrowserExternalNavigation` | установите на `true`, чтобы полностью отключить внешний просмотр в [панели браузера](#browse-external-sites). Ни пользователи, ни Claude не могут переходить на внешние сайты, и предпросмотры localhost сервера разработки не затронуты. Значение должно быть логическим значением JSON `true`; строка `"true"` игнорируется. |

740| `sshConfigs` | предварительно настройте [SSH-соединения](#pre-configure-ssh-connections-for-your-team), которые появляются в раскрывающемся списке окружения. Пользователи не могут редактировать или удалять управляемые соединения. |749| `sshConfigs` | предварительно настройте [SSH-соединения](#pre-configure-ssh-connections-for-your-team), которые появляются в раскрывающемся списке окружения. Пользователи не могут редактировать или удалять управляемые соединения. |

741| `sshHostAllowlist` | ограничьте [SSH-сеансы](#restrict-which-ssh-hosts-users-can-connect-to) хостами, чьё разрешённое имя хоста совпадает с одним из этих шаблонов. Пустой массив отключает SSH-сеансы. Читается только из управляемых параметров. |750| `sshHostAllowlist` | ограничьте [SSH-сеансы](#restrict-which-ssh-hosts-users-can-connect-to) хостами, чьё разрешённое имя хоста совпадает с одним из этих шаблонов. Пустой массив отключает SSH-сеансы. Читается только из управляемых параметров. |

742| `managedMcpServers` | отправьте конфигурации MCP-сервера всем пользователям в развёртывании третьей стороны. Каждая запись указывает транспорт `"http"`, `"sse"` или `"stdio"`, детали подключения и опционально карту `toolPolicy`, которая ограничивает, какие инструменты на этом сервере пользователи могут вызывать. Доступно только в развёртываниях Desktop третьей стороны (3P). Доставляйте этот ключ через файл управляемых параметров или MDM, так как развёртывания третьей стороны не получают параметры консоли администратора. |751| `managedMcpServers` | отправьте конфигурации MCP-сервера всем пользователям в развёртывании третьей стороны. Каждая запись указывает транспорт `"http"`, `"sse"` или `"stdio"`, детали подключения и опционально карту `toolPolicy`, которая ограничивает, какие инструменты на этом сервере пользователи могут вызывать. Доступно только в развёртываниях Desktop третьей стороны (3P). Доставляйте этот ключ через файл управляемых параметров или MDM, так как развёртывания третьей стороны не получают параметры консоли администратора. |


747* **[Облачные сеансы](#cloud-sessions)**: работают на управляемых Anthropic виртуальных машинах и получают только [параметры, управляемые сервером](/ru/server-managed-settings).756* **[Облачные сеансы](#cloud-sessions)**: работают на управляемых Anthropic виртуальных машинах и получают только [параметры, управляемые сервером](/ru/server-managed-settings).

748* **[SSH-сеансы](#ssh-sessions)**: сеанс читает файл управляемых параметров с удалённого хоста. Desktop сам читает `sshConfigs` и `sshHostAllowlist` из управляемых параметров локальной машины при создании соединения.757* **[SSH-сеансы](#ssh-sessions)**: сеанс читает файл управляемых параметров с удалённого хоста. Desktop сам читает `sshConfigs` и `sshHostAllowlist` из управляемых параметров локальной машины при создании соединения.

749 758 

750`permissions.disableBypassPermissionsMode` и `disableAutoMode` также работают в параметрах пользователя и проекта, но размещение их в управляемых параметрах предотвращает пользователей от их переопределения. `autoMode` читается из параметров пользователя, `.claude/settings.local.json` и управляемых параметров, но не из проверенного `.claude/settings.json`: клонированный репо не может внедрить свои собственные правила классификатора. Для полного списка управляемых параметров, включая `allowManagedPermissionRulesOnly` и `allowManagedHooksOnly`, см. [managed-only settings](/ru/permissions#managed-only-settings).759`permissions.disableBypassPermissionsMode` и `disableAutoMode` также работают в параметрах пользователя и проекта, но размещение их в управляемых параметрах предотвращает пользователей от их переопределения.

760 

761{/* min-version: 2.1.207 */}Claude Code читает `autoMode` из параметров пользователя, флага `--settings` и управляемых параметров, но не из `.claude/settings.json` или `.claude/settings.local.json`: оба файла находятся в директории репозитория, поэтому клонированный репо или этап сборки не может внедрить свои собственные правила классификатора. До версии 2.1.207 Claude Code также читал `.claude/settings.local.json`.

762 

763Для полного списка управляемых параметров, включая `allowManagedPermissionRulesOnly` и `allowManagedHooksOnly`, см. [управляемые параметры только](/ru/permissions#managed-only-settings).

751 764 

752<h3 id="device-management-policies">765<h3 id="device-management-policies">

753 Политики управления устройствами766 Политики управления устройствами


758* **macOS**: настройте через домен предпочтений `com.anthropic.claudefordesktop`, используя инструменты, такие как Jamf или Kandji771* **macOS**: настройте через домен предпочтений `com.anthropic.claudefordesktop`, используя инструменты, такие как Jamf или Kandji

759* **Windows**: настройте через реестр в `SOFTWARE\Policies\Claude`772* **Windows**: настройте через реестр в `SOFTWARE\Policies\Claude`

760 773 

774<h3 id="network-access-requirements">

775 Требования к доступу в сеть

776</h3>

777 

778Desktop загружает код приложения и содержимое пользователя с хостов CDN Anthropic.

779 

780```text theme={null}

781anthropic.com

782*.anthropic.com

783claude.ai

784*.claude.ai

785claude.com

786*.claude.com

787claude.app

788*.claude.app

789*.claudeusercontent.com

790*.claudemcpcontent.com

791```

792 

793Трафик использует HTTPS на порту 443, если вы не настроите пользовательский порт для [OTLP](/ru/monitoring-usage), шлюза LLM или MCP-сервера.

794 

795Для прокси-серверов, пользовательских центров сертификации, mTLS и доменов, которые требуются автономному CLI, см. [конфигурация сети](/ru/network-config).

796 

797Чтобы уменьшить количество подстановочных знаков брандмауэра, разрешите вместо этого эти хосты Anthropic. Некоторые поддомены генерируются динамически и должны оставаться подстановочными знаками.

798 

799```text theme={null}

800anthropic.com

801api.anthropic.com

802a-api.anthropic.com

803a-cdn.anthropic.com

804s-cdn.anthropic.com

805assets-proxy.anthropic.com

806claude.ai

807a.claude.ai

808a-cdn.claude.ai

809assets.claude.ai

810downloads.claude.ai

811*.livepreview.claude.ai

812claude.com

813platform.claude.com

814*.livepreview.claude.app

815*.claudeusercontent.com

816*.claudemcpcontent.com

817```

818 

761<h3 id="authentication-and-sso">819<h3 id="authentication-and-sso">

762 Аутентификация и SSO820 Аутентификация и SSO

763</h3>821</h3>

764 822 

765Организации предприятия могут требовать SSO для всех пользователей. См. [аутентификация](/ru/authentication) для деталей уровня плана и [Настройка SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) для конфигурации SAML и OIDC.823Организации предприятия могут требовать SSO для всех пользователей. См. [аутентификация](/ru/authentication) для деталей уровня плана и [Настройка SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) для конфигурации SAML; настройка OIDC рассматривается в [Руководстве администратора Claude Enterprise](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide).

766 824 

767<h3 id="data-handling">825<h3 id="data-handling">

768 Обработка данных826 Обработка данных


777Desktop можно распространять через инструменты развёртывания предприятия:835Desktop можно распространять через инструменты развёртывания предприятия:

778 836 

779* **macOS**: распространяйте через MDM, такой как Jamf или Kandji, используя установщик `.dmg`837* **macOS**: распространяйте через MDM, такой как Jamf или Kandji, используя установщик `.dmg`

780* **Windows**: развёртывайте через пакет MSIX или установщик `.exe`. См. [Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) для опций развёртывания предприятия, включая автоматическую установку838* **Windows**: развёртывайте через пакет MSIX. См. [Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) для опций развёртывания предприятия, включая автоматическую установку

781 839 

782Для конфигурации сети, такой как параметры прокси, разрешение брандмауэра и шлюзы LLM, см. [конфигурация сети](/ru/network-config).840Для доменов, которые нужно добавить в список разрешений брандмауэра, см. [требования к доступу в сеть](#network-access-requirements) выше. Для параметров прокси, пользовательских центров сертификации и шлюзов LLM см. [конфигурация сети](/ru/network-config).

783 841 

784Для полного справочника конфигурации предприятия см. [руководство конфигурации предприятия](https://support.claude.com/en/articles/12622667-enterprise-configuration).842Для полного справочника конфигурации предприятия см. [руководство конфигурации предприятия](https://support.claude.com/en/articles/12622667-enterprise-configuration).

785 843 


802Эта таблица показывает эквивалент приложения desktop для общих флагов CLI. Флаги, не указанные, не имеют эквивалента desktop, потому что они предназначены для скриптов или автоматизации.860Эта таблица показывает эквивалент приложения desktop для общих флагов CLI. Флаги, не указанные, не имеют эквивалента desktop, потому что они предназначены для скриптов или автоматизации.

803 861 

804| CLI | Эквивалент Desktop |862| CLI | Эквивалент Desktop |

805| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |863| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

806| `--model sonnet` | Раскрывающийся список модели рядом с кнопкой отправки |864| `--model sonnet` | Раскрывающийся список модели рядом с кнопкой отправки |

807| `--resume`, `--continue` | Нажмите на сеанс в боковой панели |865| `--resume`, `--continue` | Нажмите на сеанс в боковой панели |

808| `--permission-mode` | Селектор режима рядом с кнопкой отправки |866| `--permission-mode` | Селектор режима рядом с кнопкой отправки |

809| `--dangerously-skip-permissions` | Режим Bypass permissions. Включите в Settings → Claude Code → "Allow bypass permissions mode". Администраторы предприятия могут отключить этот параметр. |867| `--dangerously-skip-permissions` | Режим Bypass permissions. На планах Pro и Max включите его в Settings → Claude Code → "Allow bypass permissions mode"; на планах Team и Enterprise политика организации контролирует это |

810| `--add-dir` | Добавьте несколько репо с кнопкой **+** в удалённых сеансах |868| `--add-dir` | Добавьте несколько репо с кнопкой **+** в удалённых сеансах |

811| `--allowedTools`, `--disallowedTools` | Нет эквивалента для каждого сеанса. Правила разрешений в [файлах параметров](/ru/settings) по-прежнему применяются. |869| `--allowedTools`, `--disallowedTools` | Нет эквивалента для каждого сеанса. Правила разрешений в [файлах параметров](/ru/settings) по-прежнему применяются. |

812| `--verbose` | [Verbose view mode](#switch-view-modes) в раскрывающемся списке Transcript view |870| `--verbose` | [Verbose view mode](#switch-view-modes) в раскрывающемся списке Transcript view |


839Эта таблица сравнивает основные возможности между CLI и Desktop. Для полного списка флагов CLI см. [справочник CLI](/ru/cli-reference).897Эта таблица сравнивает основные возможности между CLI и Desktop. Для полного списка флагов CLI см. [справочник CLI](/ru/cli-reference).

840 898 

841| Функция | CLI | Desktop |899| Функция | CLI | Desktop |

842| ---------------------------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |900| ---------------------------------------------------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

843| Режимы разрешений | Все режимы, включая `dontAsk` | Manual, Accept edits и Plan. Auto и Bypass permissions появляются в селекторе режима после того, как вы включите их в Settings |901| Режимы разрешений | Все режимы, включая `dontAsk` | Manual, Accept edits, Plan и Auto. Bypass permissions появляется в селекторе режима после того, как вы включите его: через переключатель Settings на планах Pro и Max, или через политику организации на планах Team и Enterprise |

844| `--dangerously-skip-permissions` | Флаг CLI | Режим Bypass permissions. Включите в Settings → Claude Code → "Allow bypass permissions mode" |902| `--dangerously-skip-permissions` | Флаг CLI | Режим Bypass permissions. На планах Pro и Max включите его в Settings → Claude Code → "Allow bypass permissions mode"; на планах Team и Enterprise политика организации контролирует это |

845| [Сторонние провайдеры](/ru/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | Anthropic's API по умолчанию. Развёртывания предприятия могут конфигурировать Google Cloud's Agent Platform и провайдеров шлюза. См. [руководство конфигурации предприятия](https://support.claude.com/en/articles/12622667-enterprise-configuration). Чтобы запустить вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM, см. [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |903| [Сторонние провайдеры](/ru/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | Anthropic's API по умолчанию. Для маршрутизации через шлюз см. [подключение приложения desktop к шлюзу](/ru/llm-gateway-connect#desktop-app). Чтобы запустить вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM, см. [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |

846| [MCP servers](/ru/mcp) | Настройте в файлах параметров | UI Connectors для локальных и SSH-сеансов, или файлы параметров |904| [MCP servers](/ru/mcp) | Настройте в файлах параметров | UI Connectors для локальных и SSH-сеансов, или файлы параметров |

847| [Plugins](/ru/plugins) | Команда `/plugin` | UI менеджера плагинов |905| [Plugins](/ru/plugins) | Команда `/plugin` | UI менеджера плагинов |

848| @mention файлы | Текстовые | С автодополнением; локальные и SSH-сеансы только |906| @mention файлы | Текстовые | С автодополнением; локальные и SSH-сеансы только |


860 918 

861Следующие функции доступны только в CLI или расширении VS Code, кроме случаев, указанных ниже:919Следующие функции доступны только в CLI или расширении VS Code, кроме случаев, указанных ниже:

862 920 

863* **Сторонние провайдеры**: Desktop подключается к API Anthropic по умолчанию. Развёртывания предприятия могут конфигурировать Google Cloud's Agent Platform и провайдеров шлюза через [управляемые параметры](https://support.claude.com/en/articles/12622667-enterprise-configuration). Для Amazon Bedrock или Microsoft Foundry в CLI см. [quickstart](/ru/quickstart). В качестве исключения из раздела выше, [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) запускает вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM.921* **Сторонние провайдеры**: Desktop подключается к API Anthropic по умолчанию. Для маршрутизации Desktop через шлюз см. [подключение приложения desktop к шлюзу](/ru/llm-gateway-connect#desktop-app). Развёртывания предприятия могут конфигурировать Google Cloud's Agent Platform и провайдеров шлюза через [управляемые параметры](https://claude.com/docs/third-party/claude-desktop/configuration). Для Amazon Bedrock или Microsoft Foundry в CLI см. [quickstart](/ru/quickstart). В качестве исключения из раздела выше, [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) запускает вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM.

864* **Linux (бета)**: Computer Use ещё недоступна в приложении desktop Linux. См. [Claude Desktop на Linux](/ru/desktop-linux).922* **Linux (бета)**: Computer Use ещё недоступна в приложении desktop Linux. См. [Claude Desktop на Linux](/ru/desktop-linux).

865* **Встроенные предложения кода**: Desktop не предоставляет предложения в стиле автодополнения. Это работает через разговорные подсказки и явные изменения кода.923* **Встроенные предложения кода**: Desktop не предоставляет предложения в стиле автодополнения. Это работает через разговорные подсказки и явные изменения кода.

866* **Команды агентов**: параллельные сеансы Claude Code, которые обмениваются сообщениями друг с другом, доступны в [CLI](/ru/agent-teams), а не в Desktop. Для многоагентной работы внутри одного сеанса используйте [динамические рабочие процессы](/ru/workflows), которые работают в Desktop.924* **Команды агентов**: параллельные сеансы Claude Code, которые обмениваются сообщениями друг с другом, доступны в [CLI](/ru/agent-teams), а не в Desktop. Для многоагентной работы внутри одного сеанса используйте [динамические рабочие процессы](/ru/workflows), которые работают в Desktop.

867* **Команды диалога терминала**: встроенные команды, которые открывают интерактивную панель в терминале, такие как `/permissions` и `/config`, недоступны на вкладке Code и отвечают сообщением `isn't available in this environment`. `/config` устанавливает параметр, когда вы передаёте `key=value`, например `/config theme=dark`; доступна только его форма выбора. Отредактируйте [файлы параметров](/ru/settings) напрямую, чтобы управлять правилами разрешений и конфигурацией, или запустите команду из автономного CLI.925* **Команды диалога терминала**: встроенные команды, которые открывают интерактивную панель в терминале, ведут себя иначе на вкладке Code. Отредактируйте [файлы параметров](/ru/settings) напрямую, чтобы управлять правилами разрешений и конфигурацией, или запустите команды из автономного CLI.

926 * Команды без формы аргумента, такие как `/permissions`, отвечают с `isn't available in this environment`.

927 * `/config` открывает Settings → Claude Code. Текст после команды игнорируется, поэтому `/config theme=dark` не устанавливает тему.

868 928 

869<h2 id="troubleshooting">929<h2 id="troubleshooting">

870 Устранение неполадок930 Устранение неполадок


902 962 

9031. Перезагрузите приложение.9631. Перезагрузите приложение.

9042. Проверьте наличие ожидающих обновлений. На macOS и Windows приложение автоматически обновляется при запуске; на Linux обновите через apt, как описано в [Claude Desktop на Linux](/ru/desktop-linux).9642. Проверьте наличие ожидающих обновлений. На macOS и Windows приложение автоматически обновляется при запуске; на Linux обновите через apt, как описано в [Claude Desktop на Linux](/ru/desktop-linux).

9053. На Windows проверьте Event Viewer на логи сбоев под **Windows Logs Application**.9653. На управляемой сети убедитесь, что ваш брандмауэр разрешает хосты CDN в [требованиях к сетевому доступу](#network-access-requirements).

9664. На Windows проверьте Event Viewer на логи сбоев под **Windows Logs → Application**.

906 967 

907<h3 id="failed-to-load-session">968<h3 id="failed-to-load-session">

908 "Failed to load session"969 "Failed to load session"

Details

57 <Step title="Запустите и войдите">57 <Step title="Запустите и войдите">

58 Запустите **Claude** из вашего средства запуска приложений или выполните `claude-desktop` из терминала и войдите с помощью вашей учетной записи Anthropic.58 Запустите **Claude** из вашего средства запуска приложений или выполните `claude-desktop` из терминала и войдите с помощью вашей учетной записи Anthropic.

59 59 

60 Приложение Linux входит так же, как на macOS и Windows: с подпиской claude.ai или через SSO вашей организации. Desktop не принимает ключ API Claude Console напрямую; используйте [CLI](/ru/quickstart) для аутентификации по ключу API. Для корпоративных развертываний, которые маршрутизируют Desktop на Agent Platform Google Cloud или шлюз LLM, см. [руководство по конфигурации предприятия](https://support.claude.com/en/articles/12622667-enterprise-configuration) и [конфигурация сети](/ru/network-config).60 Приложение Linux входит так же, как на macOS и Windows: с подпиской claude.ai или через SSO вашей организации. Desktop не принимает ключ API Claude Console напрямую; используйте [CLI](/ru/quickstart) для аутентификации по ключу API. Для корпоративных развертываний, которые маршрутизируют Desktop на Agent Platform Google Cloud или шлюз LLM, см. [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) и [конфигурация сети](/ru/network-config).

61 </Step>61 </Step>

62</Steps>62</Steps>

63 63 

Details

33Настольное приложение имеет три вкладки:33Настольное приложение имеет три вкладки:

34 34 

35* **Chat**: Общее общение без доступа к файлам, аналогично claude.ai.35* **Chat**: Общее общение без доступа к файлам, аналогично claude.ai.

36* **Cowork**: Автономный фоновый агент, который работает над задачами в облачной виртуальной машине с собственной средой. Он может работать независимо, пока вы занимаетесь другой работой.36* **Cowork**: Автономный фоновый агент, который работает над задачами в изолированной виртуальной машине с собственной средой, работая независимо, пока вы занимаетесь другой работой. Локальные сеансы Cowork запускают виртуальную машину на вашем компьютере; удалённые сеансы Cowork запускают её на управляемой Anthropic виртуальной машине вместо этого.

37* **Code**: Интерактивный помощник по кодированию с прямым доступом к вашим локальным файлам. Вы просматриваете и одобряете каждое изменение в реальном времени.37* **Code**: Интерактивный помощник по кодированию с прямым доступом к вашим локальным файлам. Вы просматриваете и одобряете каждое изменение в реальном времени.

38 38 

39Chat и Cowork рассматриваются в [статьях поддержки Claude Desktop](https://support.claude.com/en/collections/16163169-claude-desktop). На этой странице основное внимание уделяется вкладке **Code**.39Chat и Cowork рассматриваются в [Центре справки Claude](https://support.claude.com/); установка и развёртывание настольного приложения рассматриваются в [статьях поддержки Claude Desktop](https://support.claude.com/en/collections/16163169-claude-desktop). На этой странице основное внимание уделяется вкладке **Code**.

40 40 

41<h2 id="install">41<h2 id="install">

42 Установка42 Установка

Details

93 93 

94Чтобы избежать зависания, нажмите **Run now** после создания задачи, следите за запросами разрешений и выберите "always allow" для каждого. Будущие запуски этой задачи автоматически одобряют те же инструменты без запроса. Вы можете просмотреть и отозвать эти одобрения со страницы деталей задачи.94Чтобы избежать зависания, нажмите **Run now** после создания задачи, следите за запросами разрешений и выберите "always allow" для каждого. Будущие запуски этой задачи автоматически одобряют те же инструменты без запроса. Вы можете просмотреть и отозвать эти одобрения со страницы деталей задачи.

95 95 

96Инструменты Connector [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные как [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), запрашивают разрешение при каждом вызове и не предлагают опцию "always allow". Запуски, которые вызывают эти инструменты, зависают каждый раз.

97 

96<h2 id="manage-scheduled-tasks">98<h2 id="manage-scheduled-tasks">

97 Управление запланированными задачами99 Управление запланированными задачами

98</h2>100</h2>

Details

347 347 

348[Language server](/ru/plugins#add-lsp-servers-to-your-plugin) плагина считается использованным, когда он предоставляет диагностику или отвечает на запрос навигации по коду, поэтому плагин LSP, чей сервер активен в ваших сеансах, не отображается как неиспользуемый. До v2.1.203 активность языкового сервера не могла быть учтена как использование, поэтому плагины, которые предоставляют LSP server, были полностью исключены из группы, так же как плагины темы и стиля вывода по-прежнему есть.348[Language server](/ru/plugins#add-lsp-servers-to-your-plugin) плагина считается использованным, когда он предоставляет диагностику или отвечает на запрос навигации по коду, поэтому плагин LSP, чей сервер активен в ваших сеансах, не отображается как неиспользуемый. До v2.1.203 активность языкового сервера не могла быть учтена как использование, поэтому плагины, которые предоставляют LSP server, были полностью исключены из группы, так же как плагины темы и стиля вывода по-прежнему есть.

349 349 

350Первый сеанс в версии, которая считает активность языкового сервера, также сбрасывает запись об использовании каждого плагина LSP, который еще не записал никакого использования, поэтому Claude Code не судит плагин, который вы установили ранее, как неиспользуемый на основе данных, записанных до того, как была отслежена активность его сервера. До v2.1.206 этот первый сеанс мог отобразить активно используемый плагин LSP под заголовком **Not used recently** и предложить его проверить.

351 

350Когда вы устанавливаете плагин, который объявляет зависимости, вывод установки указывает, какие зависимости были автоматически установлены вместе с ним.352Когда вы устанавливаете плагин, который объявляет зависимости, вывод установки указывает, какие зависимости были автоматически установлены вместе с ним.

351 353 

352Вы также можете управлять плагинами с помощью прямых команд.354Вы также можете управлять плагинами с помощью прямых команд.


451 Настройка автоматических обновлений453 Настройка автоматических обновлений

452</h3>454</h3>

453 455 

454Claude Code может автоматически обновлять маркетплейсы и установленные плагины в фоновом режиме после запуска. Когда автоматическое обновление включено для маркетплейса, Claude Code обновляет данные маркетплейса и обновляет установленные плагины до их последних версий. Если какие-либо плагины были обновлены, вы увидите уведомление с предложением запустить `/reload-plugins`.456Claude Code может автоматически обновлять маркетплейсы и установленные плагины в фоновом режиме после запуска. Когда автоматическое обновление включено для маркетплейса, Claude Code обновляет данные маркетплейса и обновляет установленные плагины до их последних версий на диске.

457 

458Claude Code проверяет наличие обновлений маркетплейса и плагинов после запуска вашей сессии со случайной задержкой до десяти минут, поэтому запущенная сессия продолжает использовать версии, загруженные при запуске. Если какие-либо плагины были обновлены, вы увидите уведомление с предложением запустить `/reload-plugins`, или новые версии загружаются при следующем запуске.

455 459 

456Переключайте автоматическое обновление для отдельных маркетплейсов через интерфейс:460Переключайте автоматическое обновление для отдельных маркетплейсов через интерфейс:

457 461 

errors.md +255 −26

Details

21Сопоставьте сообщение, которое вы видите в терминале, с разделом ниже.21Сопоставьте сообщение, которое вы видите в терминале, с разделом ниже.

22 22 

23| Сообщение | Раздел |23| Сообщение | Раздел |

24| :-------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |24| :------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

25| `API Error: 500 Internal server error` | [Server errors](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [Server errors](#api-error-500-internal-server-error) |

26| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |

27| `Request timed out` | [Server errors](#request-timed-out), или [Network](#unable-to-connect-to-api), если сообщение упоминает вашу интернет-соединение |27| `Request timed out` | [Server errors](#request-timed-out), или [Network](#unable-to-connect-to-api), если сообщение упоминает вашу интернет-соединение |


39| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |39| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |

40| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |40| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |

41| `Invalid API key` | [Authentication](#invalid-api-key) |41| `Invalid API key` | [Authentication](#invalid-api-key) |

42| `Your apiKeyHelper script is failing` | [Authentication](#your-apikeyhelper-script-is-failing) |

42| `This organization has been disabled` | [Authentication](#this-organization-has-been-disabled) |43| `This organization has been disabled` | [Authentication](#this-organization-has-been-disabled) |

43| `Your organization has disabled API key authentication` | [Authentication](#your-organization-has-disabled-api-key-authentication) |44| `Your organization has disabled API key authentication` | [Authentication](#your-organization-has-disabled-api-key-authentication) |

44| `Your organization has disabled Claude subscription access` | [Authentication](#your-organization-has-disabled-claude-subscription-access) |45| `Your organization has disabled Claude subscription access` | [Authentication](#your-organization-has-disabled-claude-subscription-access) |

45| `Routines are disabled by your organization's policy` | [Authentication](#routines-are-disabled-by-your-organizations-policy) |46| `Routines are disabled by your organization's policy` | [Authentication](#routines-are-disabled-by-your-organizations-policy) |

46| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentication](#remote-control-requires-the-anthropic-api) |47| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentication](#remote-control-requires-the-anthropic-api) |

47| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |48| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |

49| `Login expired · Please run /login` | [Authentication](#login-expired) |

50| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |

48| `does not meet scope requirement user:profile` | [Authentication](#oauth-scope-requirement) |51| `does not meet scope requirement user:profile` | [Authentication](#oauth-scope-requirement) |

49| `AWS credentials expired or invalid` | [Authentication](#aws-credentials-expired-or-invalid) |52| `AWS credentials expired or invalid` | [Authentication](#aws-credentials-expired-or-invalid) |

50| `AWS authentication failed` | [Authentication](#aws-authentication-failed) |53| `AWS authentication failed` | [Authentication](#aws-authentication-failed) |

54| `AWS default-chain credential resolve timed out` | [Authentication](#aws-default-chain-credential-resolve-timed-out) |

51| `Unable to connect to API` | [Network](#unable-to-connect-to-api) |55| `Unable to connect to API` | [Network](#unable-to-connect-to-api) |

52| `Waiting for API response · will retry in` | [Automatic retries](#automatic-retries), или [Network](#unable-to-connect-to-api), если это продолжается |56| `Waiting for API response · will retry in` | [Automatic retries](#automatic-retries), или [Network](#unable-to-connect-to-api), если это продолжается |

57| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Network](#bedrock-streaming-response-has-an-unexpected-content-type) |

53| `SSL certificate verification failed` | [Network](#ssl-certificate-errors) |58| `SSL certificate verification failed` | [Network](#ssl-certificate-errors) |

54| `SSL certificate error (...)` during login or startup | [Network](#ssl-certificate-errors) |59| `SSL certificate error (...)` during login or startup | [Network](#ssl-certificate-errors) |

55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Network](#host-not-allowed-in-a-cloud-session) |60| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Network](#host-not-allowed-in-a-cloud-session) |


76| `--bg and --print conflict` | [Command-line errors](#command-line-errors) |81| `--bg and --print conflict` | [Command-line errors](#command-line-errors) |

77| `Error: --json-schema is not a valid JSON Schema` | [Command-line errors](#command-line-errors) |82| `Error: --json-schema is not a valid JSON Schema` | [Command-line errors](#command-line-errors) |

78| `Could not import <server>: <reason>` | [Command-line errors](#could-not-import-a-server-from-claude-desktop) |83| `Could not import <server>: <reason>` | [Command-line errors](#could-not-import-a-server-from-claude-desktop) |

84| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Command-line errors](#mcp-permission-prompt-tool-not-found) |

79| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |85| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |

86| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |

87| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin errors](#plugin-command-references-user-config) |

88| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin errors](#plugin-command-references-user-config) |

89| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |

90| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |

91| `Can't open MCP settings in a background session` | [Background session errors](#commands-refused-in-a-background-session) |

92| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Background session errors](#claude_code_process_wrapper-launcher-errors) |

80| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |93| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |

81| Responses seem lower quality than usual | [Response quality](#responses-seem-lower-quality-than-usual) |94| Responses seem lower quality than usual | [Response quality](#responses-seem-lower-quality-than-usual) |

82 95 


86 99 

87Claude Code повторяет попытки при временных сбоях перед отображением ошибки. Ошибки сервера, перегруженные ответы, тайм-ауты запросов, временные дроссели 429 и разорванные соединения повторяются до 10 раз с экспоненциальной задержкой. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, это охватывает соединения, которые разрываются в середине ответа перед любым видимым выводом: Claude Code повторно отправляет запрос с той же задержкой и ход продолжается вместо остановки с ошибкой соединения. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, временные дроссели 429, которые не содержат заголовки квоты вашего плана, также повторяются, когда вы вошли с подписью claude.ai; более ранние версии повторяли их только для входов по ключу API и Enterprise.100Claude Code повторяет попытки при временных сбоях перед отображением ошибки. Ошибки сервера, перегруженные ответы, тайм-ауты запросов, временные дроссели 429 и разорванные соединения повторяются до 10 раз с экспоненциальной задержкой. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, это охватывает соединения, которые разрываются в середине ответа перед любым видимым выводом: Claude Code повторно отправляет запрос с той же задержкой и ход продолжается вместо остановки с ошибкой соединения. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, временные дроссели 429, которые не содержат заголовки квоты вашего плана, также повторяются, когда вы вошли с подписью claude.ai; более ранние версии повторяли их только для входов по ключу API и Enterprise.

88 101 

89Два класса сбоев не повторяются, потому что повторная попытка не может быть успешной:102Некоторые классы сбоев не повторяются, потому что повторная попытка не может быть успешной:

90 103 

91* {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, сбой проверки сертификата TLS, такой как прокси, проверяющий TLS, отсутствующий пакет `NODE_EXTRA_CA_CERTS` или истекший сертификат, завершается ошибкой при первой попытке, поэтому исправление появляется немедленно вместо полного бюджета повторных попыток. См. [SSL certificate errors](#ssl-certificate-errors). Временные условия TLS, такие как тайм-аут рукопожатия, все еще повторяются.104* {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, сбой проверки сертификата TLS, такой как прокси, проверяющий TLS, отсутствующий пакет `NODE_EXTRA_CA_CERTS` или истекший сертификат, завершается ошибкой при первой попытке, поэтому исправление появляется немедленно вместо полного бюджета повторных попыток. См. [SSL certificate errors](#ssl-certificate-errors). Временные условия TLS, такие как тайм-аут рукопожатия, все еще повторяются.

92* {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, ошибка сервера, которая поступает после того, как Claude уже передал видимый вывод, сохраняет частичный ответ и добавляет [incomplete-response notice](#the-response-above-may-be-incomplete) вместо повторной попытки, так как повторный запрос может выполнить те же вызовы инструментов дважды. Более ранние версии отбрасывали частичный вывод и сообщали о ходе как об ошибке.105* {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, ошибка сервера, которая поступает после того, как Claude уже передал видимый вывод, сохраняет частичный ответ и добавляет [incomplete-response notice](#the-response-above-may-be-incomplete) вместо повторной попытки, так как повторный запрос может выполнить те же вызовы инструментов дважды. Более ранние версии отбрасывали частичный вывод и сообщали о ходе как об ошибке.

106* {/* min-version: 2.1.208 */}[Amazon Bedrock streaming response with an unexpected content-type](#bedrock-streaming-response-has-an-unexpected-content-type) завершается ошибкой при первой попытке, потому что шлюз или прокси, переписывающий ответ, переписал бы повторную попытку таким же образом. Требуется Claude Code версии 2.1.208 или позже.

93 107 

94Во время повторных попыток спиннер показывает обратный отсчет `Retrying in Ns · attempt x/y` после метки ошибки. Метка называет конкретную причину первой попытки для сбоев, на которые вы можете действовать немедленно: сеть отключена, рукопожатие TLS не удалось, или вы достигли лимита скорости. Для других ошибок она читается как `API error` вначале. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, она переключается на конкретную причину третьей попытки, или при последней попытке, когда `CLAUDE_CODE_MAX_RETRIES` позволяет менее трёх; более ранние версии переключаются только при последней попытке.108Во время повторных попыток спиннер показывает обратный отсчет `Retrying in Ns · attempt x/y` после метки ошибки. Метка называет конкретную причину первой попытки для сбоев, на которые вы можете действовать немедленно: сеть отключена, рукопожатие TLS не удалось, или вы достигли лимита скорости. Для других ошибок она читается как `API error` вначале. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, она переключается на конкретную причину третьей попытки, или при последней попытке, когда `CLAUDE_CODE_MAX_RETRIES` позволяет менее трёх; более ранние версии переключаются только при последней попытке.

95 109 


285 299 

286Claude Code блокирует дальнейшие запросы до времени сброса, указанного в сообщении. Лимиты сеанса и недельного использования являются общими для всех моделей, поэтому переключение моделей не восстанавливает доступ. Лимит Opus применяется только к запросам Opus, поэтому переключение на другую модель с помощью `/model` позволяет вам продолжить работу.300Claude Code блокирует дальнейшие запросы до времени сброса, указанного в сообщении. Лимиты сеанса и недельного использования являются общими для всех моделей, поэтому переключение моделей не восстанавливает доступ. Лимит Opus применяется только к запросам Opus, поэтому переключение на другую модель с помощью `/model` позволяет вам продолжить работу.

287 301 

302Использование учитывается в отношении лимитов сеанса и недельного использования одновременно. Одиночный всплеск интенсивной активности, такой как крупный fanout рабочего процесса, может исчерпать недельный лимит до того, как окно сеанса сбросится.

303 

288**Что делать:**304**Что делать:**

289 305 

290* Дождитесь времени сброса, указанного в ошибке306* Дождитесь времени сброса, указанного в ошибке


430* Если ключ поступает из скрипта [`apiKeyHelper`](/ru/settings#available-settings), запустите скрипт напрямую, чтобы подтвердить, что он выводит действительный ключ на stdout446* Если ключ поступает из скрипта [`apiKeyHelper`](/ru/settings#available-settings), запустите скрипт напрямую, чтобы подтвердить, что он выводит действительный ключ на stdout

431* Запустите `/status`, чтобы подтвердить, какой источник учетных данных на самом деле использует Claude Code447* Запустите `/status`, чтобы подтвердить, какой источник учетных данных на самом деле использует Claude Code

432 448 

449<h3 id="your-apikeyhelper-script-is-failing">

450 Your apiKeyHelper script is failing

451</h3>

452 

453Команда, настроенная в параметре [`apiKeyHelper`](/ru/settings#available-settings), завершилась с ошибкой, истекла по времени или ничего не вывела на stdout. Без ключа из скрипта запрос достигает API с заполнителем учетных данных, и API отклоняет его с `401`.

454 

455```text theme={null}

456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

457```

458 

459Claude Code повторно запускает скрипт и повторяет попытку запроса до двух раз перед отображением этого сообщения, поэтому сбой проявляется в течение трех попыток. {/* min-version: 2.1.208 */}До версии 2.1.208 Claude Code тратил весь [retry budget](#automatic-retries) на повторную отправку запроса с заполнителем учетных данных, а затем сообщал об общей ошибке аутентификации `401` вместо сбоя скрипта.

460 

461Запуск `/login` здесь не помогает: вывод помощника [имеет приоритет](/ru/authentication#authentication-precedence) над сохраненным входом, пока параметр присутствует.

462 

463**Что делать:**

464 

465* Запустите команду, настроенную в `apiKeyHelper`, непосредственно в вашей оболочке, чтобы воспроизвести сбой

466* Если команда сообщает об истекшей сессии, повторно аутентифицируйтесь у вашего поставщика учетных данных, например, снова войдя в ваш SSO или хранилище секретов

467* Исправьте команду так, чтобы она выводила ключ на stdout и выходила с кодом 0. См. [rotate credentials with apiKeyHelper](/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) для рабочей настройки.

468* Запустите `/status`, чтобы подтвердить, что `apiKeyHelper` является активным источником учетных данных. Каждый раз, когда команда не выполняется, ее код выхода и вывод ошибки появляются в панели `Cloud authentication` в терминале.

469 

433<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">

434 This organization has been disabled471 This organization has been disabled

435</h3>472</h3>


532 569 

533Ваш сохраненный вход больше не действителен. Отозванный токен означает, что вы вышли везде или администратор удалил доступ; истекший токен означает, что автоматическое обновление не удалось в середине сеанса.570Ваш сохраненный вход больше не действителен. Отозванный токен означает, что вы вышли везде или администратор удалил доступ; истекший токен означает, что автоматическое обновление не удалось в середине сеанса.

534 571 

572Оба сообщения сообщают об отклонении, которое API вернул для запроса, отправленного Claude Code. Когда сохраненный вход уже был очищен после неудачного обновления, вы видите [Login expired](#login-expired) вместо этого.

573 

535```text theme={null}574```text theme={null}

536OAuth token revoked · Please run /login575OAuth token revoked · Please run /login

537OAuth token has expired · Please run /login576OAuth token has expired · Please run /login


545* Для повторных запросов на вход при запусках см. проверки системных часов и macOS Keychain в [Troubleshooting](/ru/troubleshoot-install#not-logged-in-or-token-expired)584* Для повторных запросов на вход при запусках см. проверки системных часов и macOS Keychain в [Troubleshooting](/ru/troubleshoot-install#not-logged-in-or-token-expired)

546* Для других сбоев, включая `403 Forbidden` и проблемы с браузером OAuth, см. [Login and authentication](/ru/troubleshoot-install#login-and-authentication)585* Для других сбоев, включая `403 Forbidden` и проблемы с браузером OAuth, см. [Login and authentication](/ru/troubleshoot-install#login-and-authentication)

547 586 

587<h3 id="login-expired">

588 Login expired

589</h3>

590 

591Claude Code попытался обновить ваш сохраненный вход claude.ai или Claude Console, и служба OAuth отклонила сохраненный токен обновления, поэтому Claude Code очистила сохраненные учетные данные. После этого каждый запрос останавливается локально перед тем, как достичь API, потому что только `/login` может создать новые учетные данные. {/* min-version: 2.1.206 */}До версии 2.1.206 Claude Code отправляла запрос в любом случае с любыми учетными данными, оставшимися в окружении, и каждая модель затем не выполнялась с [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) или 401 вместо запроса на вход.

592 

593```text theme={null}

594Login expired · Please run /login

595```

596 

597В [non-interactive mode](/ru/headless) (`-p`) и [Agent SDK](/ru/agent-sdk/overview) сообщение читается следующим образом, и код структурированной ошибки — `authentication_failed`:

598 

599```text theme={null}

600Failed to authenticate: OAuth session expired and could not be refreshed

601```

602 

603Это не то же состояние, что [OAuth token revoked or expired](#oauth-token-revoked-or-expired). Эти сообщения сообщают о 401, который вернул API. Claude Code сама создает `Login expired` для входа, который она уже не смогла обновить, поэтому она не отправляет запрос.

604 

605Сеансы, аутентифицированные с помощью ключа API, [`CLAUDE_CODE_OAUTH_TOKEN`](/ru/env-vars) или поставщика третьей стороны, не используют сохраненный вход и никогда не видят это сообщение.

606 

607**Что делать:**

608 

609* Запустите `/login` для повторного входа. Повторная попытка без входа показывает то же сообщение при каждом запросе.

610* В неинтерактивном режиме запустите `claude` в том же окружении, завершите `/login`, затем повторно запустите вашу команду. Для автоматизации, которая не может войти интерактивно, аутентифицируйтесь с помощью `ANTHROPIC_API_KEY` или [generate a long-lived token with `claude setup-token`](/ru/authentication#generate-a-long-lived-token).

611* Если вход продолжает не выполняться, см. [Login and authentication](/ru/troubleshoot-install#login-and-authentication)

612 

548<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">

549 OAuth scope requirement614 OAuth scope requirement

550</h3>615</h3>


603* Если ваши учетные данные актуальны, подтвердите, что разрешения IAM в [IAM configuration](/ru/amazon-bedrock#iam-configuration) присоединены к идентификатору, который вы используете, и что выбранная модель включена для вашей учетной записи и региона668* Если ваши учетные данные актуальны, подтвердите, что разрешения IAM в [IAM configuration](/ru/amazon-bedrock#iam-configuration) присоединены к идентификатору, который вы используете, и что выбранная модель включена для вашей учетной записи и региона

604* Запустите `aws sts get-caller-identity` для подтверждения того, какой идентификатор используют ваши запросы; устаревший `AWS_PROFILE` или профиль по умолчанию — это частая причина несоответствия разрешений669* Запустите `aws sts get-caller-identity` для подтверждения того, какой идентификатор используют ваши запросы; устаревший `AWS_PROFILE` или профиль по умолчанию — это частая причина несоответствия разрешений

605 670 

671<h3 id="aws-default-chain-credential-resolve-timed-out">

672 AWS default-chain credential resolve timed out

673</h3>

674 

675Цепь поставщика учетных данных AWS по умолчанию не создала учетные данные в течение 60 секунд, поэтому Claude Code остановила разрешение и не выполнила запрос. Сбой — это локальное разрешение учетных данных: запрос никогда не достиг [Amazon Bedrock](/ru/amazon-bedrock), [Claude Platform on AWS](/ru/claude-platform-on-aws) или [Mantle endpoint](/ru/amazon-bedrock#use-the-mantle-endpoint). Claude Code очищает свой [credential cache](/ru/amazon-bedrock#credential-caching-and-resolution-timeout) и повторяет попытку перед тем, как эта ошибка проявляется, поэтому к тому времени, когда вы ее видите, цепь зависла при повторных попытках.

676 

677```text theme={null}

678API Error: AWS default-chain credential resolve timed out

679```

680 

681Частые причины — это команда `credential_process` в вашем профиле AWS, которая ждет входа, который она не может получить, и контейнер или виртуальная машина, служба метаданных экземпляра (IMDS) которых никогда не отвечает на зонд цепи. {/* min-version: 2.1.207 */}До версии 2.1.207 зависшая цепь оставляла запрос ожидающим неопределенно долго вместо того, чтобы не выполняться с этим сообщением.

682 

683**Что делать:**

684 

685* Запустите `aws sts get-caller-identity` в той же оболочке с тем же `AWS_PROFILE`. Если он также зависает, исправьте профиль; команда `credential_process`, которая запрашивает интерактивно, — это частая причина.

686* Завершите шаг входа перед запуском Claude Code, например `aws sso login --profile myprofile`, чтобы цепь разрешилась из локального кэша SSO вместо ожидания потока браузера

687* Если ваша цепь запускает интерактивный вход, который законно требует более 60 секунд, такой как SSO с MFA через оболочку, как `aws-vault`, повысьте лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/ru/env-vars)

688 

606<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">

607 Ошибки сети и подключения690 Ошибки сети и подключения

608</h2>691</h2>

609 692 

610Эти ошибки означают, что сетевой запрос от Claude Code не смог достичь пункта назначения. Обычно они возникают в вашей локальной сети, прокси или брандмауэре, либо в политике сети облачной среды.693Эти ошибки означают, что сетевой запрос от Claude Code не смог достичь пункта назначения, или что-то между Claude Code и API изменило ответ на пути обратно. Обычно они возникают в вашей локальной сети, прокси или брандмауэре, либо в политике сети облачной среды.

611 694 

612<h3 id="unable-to-connect-to-api">695<h3 id="unable-to-connect-to-api">

613 Unable to connect to API696 Unable to connect to API


640* На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте `ifconfig` на наличие устаревших интерфейсов `utun` и удалите сетевое расширение VPN в Параметрах системы.723* На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте `ifconfig` на наличие устаревших интерфейсов `utun` и удалите сетевое расширение VPN в Параметрах системы.

641* Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.724* Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.

642 725 

726<h3 id="bedrock-streaming-response-has-an-unexpected-content-type">

727 Bedrock streaming response has an unexpected content-type

728</h3>

729 

730Шлюз или прокси между Claude Code и [Amazon Bedrock](/ru/amazon-bedrock) преобразует тело потокового ответа или его заголовок `Content-Type`. Amazon Bedrock передаёт ответы потоком как `application/vnd.amazon.eventstream`, и Claude Code отклоняет успешный потоковый ответ, который сообщает о другом типе содержимого вместо декодирования тела, которое он не может прочитать. Запрос не повторяется.

731 

732```text theme={null}

733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.

734```

735 

736{/* min-version: 2.1.208 */}До версии 2.1.208 та же неправильная конфигурация проявлялась как `API Error: Truncated event message received` после того, как весь ответ был буферизирован.

737 

738**Что делать:**

739 

740* Настройте шлюз для передачи тела ответа `InvokeModelWithResponseStream` и его заголовка `Content-Type` без изменений. Промежуточный узел, который повторно отправляет поток как события, отправляемые сервером, является распространённой причиной.

741* Если шлюз переписывает только заголовок и передаёт двоичное тело без изменений, установите [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/ru/env-vars) для пропуска проверки до исправления шлюза. См. [Ошибки потоковой передачи за шлюзом или прокси](/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).

742 

643<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">

644 SSL certificate errors744 SSL certificate errors

645</h3>745</h3>


859* **Agent SDK**: текст ошибки опускает подсказку, потому что модель установлена программно. Установите [`model` на `Options`](/ru/agent-sdk/typescript#options) в TypeScript или [`ClaudeAgentOptions(model=...)`](/ru/agent-sdk/python#claudeagentoptions) в Python, и обработайте структурированную ошибку `model_not_found` для отображения вашего собственного повтора или средства выбора модели.959* **Agent SDK**: текст ошибки опускает подсказку, потому что модель установлена программно. Установите [`model` на `Options`](/ru/agent-sdk/typescript#options) в TypeScript или [`ClaudeAgentOptions(model=...)`](/ru/agent-sdk/python#claudeagentoptions) в Python, и обработайте структурированную ошибку `model_not_found` для отображения вашего собственного повтора или средства выбора модели.

860* Используйте псевдоним, такой как `sonnet` или `opus`, вместо полного версионного ID. Псевдонимы разрешаются в поддерживаемое значение по умолчанию, поэтому они не устаревают. Смотрите [Model configuration](/ru/model-config).960* Используйте псевдоним, такой как `sonnet` или `opus`, вместо полного версионного ID. Псевдонимы разрешаются в поддерживаемое значение по умолчанию, поэтому они не устаревают. Смотрите [Model configuration](/ru/model-config).

861* Если неправильная модель продолжает возвращаться в CLI, где-то установлен устаревший ID. Проверьте в [порядке приоритета](/ru/model-config#setting-your-model): флаг `--model`, переменная окружения `ANTHROPIC_MODEL`, затем поле `model` в `.claude/settings.local.json`, файл вашего проекта `.claude/settings.json` и `~/.claude/settings.json`. Удалите устаревшее значение, и Claude Code вернётся к умолчанию вашей учётной записи.961* Если неправильная модель продолжает возвращаться в CLI, где-то установлен устаревший ID. Проверьте в [порядке приоритета](/ru/model-config#setting-your-model): флаг `--model`, переменная окружения `ANTHROPIC_MODEL`, затем поле `model` в `.claude/settings.local.json`, файл вашего проекта `.claude/settings.json` и `~/.claude/settings.json`. Удалите устаревшее значение, и Claude Code вернётся к умолчанию вашей учётной записи.

962* {/* min-version: 2.1.206 */}Claude Code сообщает об истёкшем входе claude.ai как [Login expired](#login-expired), а не как об этой ошибке. До v2.1.206 истёкший вход, который больше не удалось обновить, не удавался для каждой модели с этой ошибкой; запустите `/login`, если вы видите это в более старой версии.

862* Для развёртываний Google Cloud's Agent Platform смотрите [Google Cloud's Agent Platform troubleshooting](/ru/google-vertex-ai#troubleshooting).963* Для развёртываний Google Cloud's Agent Platform смотрите [Google Cloud's Agent Platform troubleshooting](/ru/google-vertex-ai#troubleshooting).

863 964 

864<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">


1070 Конфликт между --bg и --print1171 Конфликт между --bg и --print

1071</h3>1172</h3>

1072 1173 

1073Это сообщение требует Claude Code v2.1.198 или более поздней версии. Вы объединили `--bg` с `-p` или `--print` в одном вызове `claude`. `--bg` запускает [фоновый сеанс](/ru/agent-view#from-your-shell), к которому вы позже подключаетесь с помощью `claude agents`, а `--print` запускает [неинтерактивно](/ru/headless) и никогда не запускает интерактивный сеанс, к которому подключается `claude agents`. До версии v2.1.198 эта комбинация молча создавала фоновое задание, которое никогда не удавалось подключить.1174Это сообщение требует Claude Code v2.1.198 или позже. Вы объединили `--bg` с `-p` или `--print` в одном вызове `claude`. `--bg` запускает [фоновый сеанс](/ru/agent-view#from-your-shell), к которому вы позже подключаетесь с помощью `claude agents`, а `--print` запускает [неинтерактивно](/ru/headless) и никогда не запускает интерактивный сеанс, к которому подключается `claude agents`. До версии v2.1.198 эта комбинация молча создавала фоновое задание, которое никогда не могло быть подключено.

1074 1175 

1075```text theme={null}1176```text theme={null}

1177--bg и --print конфликтуют: --print никогда не запускает интерактивный сеанс, к которому подключается `claude agents`, поэтому задание было бы недоступным. Запрос — это позиционный аргумент — удалите --print: `claude --bg '<task>'`.

1076```1178```

1077 1179 

1078**Что делать:**1180**Что делать:**

1079 1181 

1080* Удалите `-p` или `--print`. `--bg` принимает запрос в качестве позиционального аргумента, поэтому `claude --bg "<task>"` — это полная команда. См. [Dispatch new agents from your shell](/ru/agent-view#from-your-shell).1182* Удалите `-p` или `--print`. `--bg` принимает запрос в качестве позиционного аргумента, поэтому `claude --bg "<task>"` — это полная команда. См. [Dispatch new agents from your shell](/ru/agent-view#from-your-shell).

1081* Чтобы запустить запрос неинтерактивно и вывести результат вместо создания фонового сеанса, удалите `--bg` и запустите `claude -p "<task>"`1183* Чтобы запустить запрос неинтерактивно и вывести результат вместо создания фонового сеанса, удалите `--bg` и запустите `claude -p "<task>"`

1082 1184 

1083<h3 id="the-json-schema-value-is-not-a-valid-json-schema">1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">


1105 Не удалось импортировать сервер из Claude Desktop1206 Не удалось импортировать сервер из Claude Desktop

1106</h3>1207</h3>

1107 1208 

1108Claude Code не смог добавить один из серверов, которые вы выбрали в `claude mcp add-from-claude-desktop`. Команда по-прежнему импортирует другие выбранные серверы и выводит одну строку для каждого сервера, который не удалось добавить. До версии v2.1.205 первый сервер, который не прошёл проверку, останавливал импорт и ни один из выбранных серверов не был добавлен.1209Claude Code не смог добавить один из серверов, которые вы выбрали в `claude mcp add-from-claude-desktop`. Команда по-прежнему импортирует другие выбранные серверы и выводит одну строку для каждого сервера, который она не смогла добавить. До версии v2.1.205 первый сервер, который не прошёл проверку, останавливал импорт и ни один из выбранных серверов не был добавлен.

1109 1210 

1110```text theme={null}1211```text theme={null}

1111Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

1112```1213```

1113 1214 

1114Текст после имени сервера — это причина. Наиболее распространённая — проверка имени: Claude Desktop допускает символы в именах серверов, такие как пробелы и точки, которые `claude mcp` ограничивает буквами, цифрами, дефисами и подчёркиваниями. Другие причины включают конфигурацию сервера, которая не прошла валидацию, и сервер, заблокированный [политикой MCP](/ru/managed-mcp) вашей организации.1215Текст после имени сервера — это причина. Наиболее распространённая — это проверка имени: Claude Desktop допускает символы в именах серверов, такие как пробелы и точки, которые `claude mcp` ограничивает буквами, цифрами, дефисами и подчёркиваниями. Другие причины включают конфигурацию сервера, которая не прошла валидацию, и сервер, заблокированный [политикой MCP](/ru/managed-mcp) вашей организации.

1115 1216 

1116**Что делать:**1217**Что делать:**

1117 1218 

1118* Переименуйте сервер в `claude_desktop_config.json`, используя только буквы, цифры, дефисы и подчёркивания, затем снова запустите `claude mcp add-from-claude-desktop`1219* Переименуйте сервер в `claude_desktop_config.json`, используя только буквы, цифры, дефисы и подчёркивания, затем снова запустите `claude mcp add-from-claude-desktop`

1119* Добавьте этот сервер напрямую с помощью `claude mcp add` или `claude mcp add-json` под допустимым именем. См. [Import MCP servers from Claude Desktop](/ru/mcp#import-mcp-servers-from-claude-desktop).1220* Добавьте этот сервер напрямую с помощью `claude mcp add` или `claude mcp add-json` под допустимым именем. См. [Import MCP servers from Claude Desktop](/ru/mcp#import-mcp-servers-from-claude-desktop).

1120 1221 

1222<h3 id="mcp-permission-prompt-tool-not-found">

1223 Инструмент запроса разрешения MCP не найден

1224</h3>

1225 

1226Инструмент, который вы передали в [`--permission-prompt-tool`](/ru/cli-reference#cli-flags), не был среди подключённых инструментов MCP, когда запуск впервые нуждался в решении о разрешении, либо потому, что его сервер никогда не подключался, либо потому, что ни один подключённый сервер не предоставляет инструмент с таким именем. Claude Code по-прежнему отправляет ваш запрос: [неинтерактивный](/ru/headless) запуск завершается с этой ошибкой и кодом выхода 1 при первом вызове инструмента, который требует одобрения, поэтому он не выдаёт ответ, хотя запрос был сделан. Перед первым запросом Claude Code ждёт до 30 секунд, установленного [`MCP_TIMEOUT`](/ru/env-vars) для подключения этого сервера. {/* min-version: 2.1.206 */}До версии v2.1.206 запуск не ждал завершения подключения сервера, поэтому медленно запускающийся, но здоровый сервер также выдавал эту ошибку.

1227 

1228```text theme={null}

1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none

1230```

1231 

1232Список после `Available MCP tools:` указывает инструменты MCP, которые были подключены, когда ожидание закончилось.

1233 

1234**Что делать:**

1235 

1236* Проверьте, что сервер запускается и остаётся подключённым: запустите `claude mcp list` в том же каталоге и подтвердите, что сервер указан как подключённый

1237* Подтвердите, что имя инструмента совпадает с именем `mcp__<server>__<tool>`, которое предоставляет сервер

1238* Если серверу требуется более 30 секунд для запуска, увеличьте [`MCP_TIMEOUT`](/ru/env-vars)

1239 

1121<h2 id="plugin-errors">1240<h2 id="plugin-errors">

1122 Ошибки плагинов1241 Ошибки плагинов

1123</h2>1242</h2>

1124 1243 

1125Эти ошибки возникают из конфигурации [плагинов](/ru/plugins) и [маркетплейсов](/ru/plugin-marketplaces). Для проблем с плагинами, которые не производят одно из сообщений на этой странице, таких как URL маркетплейса, который не загружается, или плагин, который устанавливается, но не появляется, см. [Устранение неполадок плагинов](/ru/discover-plugins#troubleshooting).1244Эти ошибки возникают из конфигурации [плагина](/ru/plugins) и [маркетплейса](/ru/plugin-marketplaces). Для проблем с плагинами, которые не выдают одно из сообщений на этой странице, например маркетплейс, который не загружается, или плагин, который устанавливается, но не отображается, см. [Устранение неполадок плагинов](/ru/discover-plugins#troubleshooting).

1126 1245 

1127<h3 id="marketplace-is-registered-from-an-untrusted-source">1246<h3 id="marketplace-is-registered-from-an-untrusted-source">

1128 Marketplace зарегистрирован из ненадежного источника1247 Marketplace is registered from an untrusted source

1129</h3>1248</h3>

1130 1249 

1131Маркетплейс зарегистрирован под именем, которое [зарезервировано для официальных маркетплейсов Anthropic](/ru/plugin-marketplaces#marketplace-schema), но его зарегистрированный источник не является репозиторием GitHub `anthropics`. Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке или обновлении маркетплейса, поэтому маркетплейс и плагины, установленные из него, перестают загружаться. До версии 2.1.205 имя проверялось только при добавлении маркетплейса, поэтому запись, зарегистрированная до того, как ее имя было зарезервировано, продолжала загружаться.1250Маркетплейс зарегистрирован под именем, которое [зарезервировано для официальных маркетплейсов Anthropic](/ru/plugin-marketplaces#marketplace-schema), но его зарегистрированный источник не является репозиторием GitHub `anthropics`. Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке или обновлении маркетплейса, поэтому маркетплейс и плагины, установленные из него, перестают загружаться. До версии 2.1.205 имя проверялось только при добавлении маркетплейса, поэтому запись, зарегистрированная до того, как её имя было зарезервировано, продолжала загружаться.

1132 1251 

1133```text theme={null}1252```text theme={null}

1134Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.1253Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.


1136 1255 

1137**Что делать:**1256**Что делать:**

1138 1257 

1139* Запустите `claude plugin marketplace remove <name>`, затем снова добавьте маркетплейс из официального репозитория `github.com/anthropics`1258* Выполните `claude plugin marketplace remove <name>`, затем снова добавьте маркетплейс из официального репозитория `github.com/anthropics`

1140* Если вы публикуете сторонний маркетплейс, который использовал имя до того, как оно было зарезервировано, переименуйте его и попросите пользователей повторно добавить его из вашего источника1259* Если вы публикуете маркетплейс третьей стороны, который использовал это имя до того, как оно было зарезервировано, переименуйте его и попросите пользователей добавить его из вашего источника

1141* См. список зарезервированных имен в разделе [Marketplace schema](/ru/plugin-marketplaces#marketplace-schema)1260* См. список зарезервированных имён в разделе [Marketplace schema](/ru/plugin-marketplaces#marketplace-schema)

1261 

1262<h3 id="plugin-command-references-user-config">

1263 Plugin command references user\_config in a shell command

1264</h3>

1265 

1266Хук плагина, [monitor](/ru/plugins-reference#monitors), или MCP команда [`headersHelper`](/ru/mcp#use-dynamic-headers-for-custom-authentication) ссылается на [опцию плагина](/ru/plugins-reference#user-configuration) `${user_config.KEY}`, и подставленная строка будет передана в оболочку. Настроенное значение, содержащее `$(...)`, обратные кавычки или `;`, будет выполнено как код там, поэтому Claude Code отказывается запускать компонент вместо подстановки значения. Проверка выполняется на шаблоне команды, поэтому ошибка появляется даже когда значение ещё не настроено. До версии 2.1.207 значение подставлялось в команду оболочки.

1267 

1268Формулировка зависит от того, какая поверхность ссылалась на опцию. Хук в форме оболочки сообщает:

1269 

1270```text theme={null}

1271Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}

1272```

1273 

1274Monitor сообщает:

1275 

1276```text theme={null}

1277Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.

1278```

1279 

1280MCP `headersHelper` сообщает:

1281 

1282```text theme={null}

1283headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).

1284```

1285 

1286**Что делать:**

1287 

1288* Для хука добавьте массив `args`, чтобы он выполнялся в [exec форме](/ru/hooks#exec-form-and-shell-form), где каждый `${user_config.KEY}` становится одним аргументом без оболочки между ними. Или удалите ссылку и прочитайте переменную окружения `$CLAUDE_PLUGIN_OPTION_<KEY>` внутри скрипта

1289* Для monitor удалите ссылку и пусть скрипт monitor прочитает значение из файла конфигурации

1290* Для `headersHelper` переместите `${user_config.KEY}` в поле `headers` сервера, которое не анализируется оболочкой, или прочитайте значение внутри скрипта помощника

1291 

1292<h2 id="tool-errors">

1293 Ошибки инструментов

1294</h2>

1295 

1296Эти ошибки возникают, когда встроенные инструменты Claude отказывают во входных данных. Claude самостоятельно исправляет большинство ошибок инструментов; два приведённых ниже требуют изменений с вашей стороны, так как они происходят из определения подагента или правила разрешений, которыми вы управляете.

1297 

1298<h3 id="agent-would-be-spawned-with-zero-tools">

1299 Agent would be spawned with zero tools

1300</h3>

1301 

1302Ничего в [списке `tools` подагента](/ru/sub-agents#supported-frontmatter-fields) не разрешилось в инструмент, поэтому Claude Code отказывается запускать подагента, а не запускать его без возможности действовать. Сообщение группирует записи по причине, по которой они не разрешились: неизвестный инструмент, инструмент, который недоступен подагентам, или распознанный, но не соответствующий ни одному инструменту в текущей сессии. Пропуск поля `tools` никогда не вызывает этот отказ. Шаблон сервера MCP, такой как `mcp__github__*`, не исключён: когда ни один подключённый инструмент не поступает с этого сервера, запуск отказывается с шаблоном в группе, которая ничего не совпала. До версии 2.1.208 подагент запускался без инструментов и возвращал пустой или запутанный результат.

1303 

1304```text theme={null}

1305Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.

1306```

1307 

1308**Что делать:**

1309 

1310* Исправьте каждую запись, которую ошибка называет, в соответствии с [инструментами, доступными подагентам](/ru/sub-agents#available-tools)

1311* Удалите записи для инструментов, которые сессия не имеет, такие как инструменты MCP с сервера, который не подключён

1312* Чтобы дать подагенту каждый инструмент, который есть у родителя, удалите поле `tools` вместо перечисления инструментов

1313 

1314<h3 id="file-is-covered-by-a-read-deny-rule">

1315 File is covered by a Read deny rule

1316</h3>

1317 

1318Инструмент Edit был вызван на пути, соответствующем [правилу отказа `Read`](/ru/permissions#read-and-edit), включая создание нового файла по этому пути. Редактирование переписывает содержимое, которое Claude должен иметь возможность прочитать обратно, поэтому вызов отказывается до любого доступа к файлу. Правило блокирует только инструмент Edit: Write и NotebookEdit не охватываются правилами отказа `Read`. До версии 2.1.208 только правило отказа `Edit` блокировало редактирование, и правило отказа `Read` само по себе не блокировало.

1319 

1320```text theme={null}

1321File is covered by a Read deny rule in your permission settings and cannot be edited.

1322```

1323 

1324**Что делать:**

1325 

1326* Если Claude должен иметь возможность редактировать файл, удалите или сузьте правило отказа `Read` в `/permissions` или в [параметрах](/ru/settings#permission-settings)

1327* Если файл должен остаться нетронутым, сохраните правило и добавьте правило отказа `Edit` для того же пути, чтобы инструменты Write и NotebookEdit также были заблокированы

1328 

1329<h2 id="background-session-errors">

1330 Ошибки фоновой сессии

1331</h2>

1332 

1333[Фоновые сессии](/ru/agent-view) работают без собственного интерактивного терминала, поэтому команды, которым он требуется, ведут себя там иначе. Эти сообщения появляются в стенограмме фоновой сессии в представлении агента или после присоединения.

1334 

1335<h3 id="commands-refused-in-a-background-session">

1336 Команды, отклоненные в фоновой сессии

1337</h3>

1338 

1339Команды, которые открывают интерактивное диалоговое окно, отклоняются в фоновой сессии с сообщением, в котором указывается форма, которая там работает, или вам предлагается запустить команду из обычного терминала. `/install-github-app`, список параметров `/mcp` и действия аутентификации в меню сервера MCP все отклоняются таким образом. До версии 2.1.208 они открывали свое диалоговое окно внутри фоновой сессии.

1340{/* max-version: 2.1.208 */}В версии 2.1.208 только средство выбора `/model` также было отклонено в фоновой сессии, а `/upgrade` вывел URL обновления вместо открытия браузера.

1341 

1342Формулировка указывает команду, которая была отклонена. Список параметров `/mcp` сообщает:

1343 

1344```text theme={null}

1345Can't open MCP settings in a background session — use `/mcp enable|disable|reconnect <server>` to steer, or run /mcp from an interactive terminal to authenticate.

1346```

1347 

1348**Что делать:**

1349 

1350* Используйте форму, указанную в сообщении, например `/mcp reconnect <server>`, `/mcp enable` или `/mcp disable`

1351* Для потоков входа и авторизации запустите команду из обычной сессии `claude` в терминале

1352 

1353<h3 id="claude_code_process_wrapper-launcher-errors">

1354 Ошибки средства запуска CLAUDE\_CODE\_PROCESS\_WRAPPER

1355</h3>

1356 

1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/ru/corporate-launcher) установлен, и его значение невозможно использовать, поэтому Claude Code отказывается запускать затронутый процесс вместо того, чтобы запустить его без средства запуска. Проблемы конфигурации сообщаются сообщением, которое начинается с имени переменной и указывает причину, например:

1358 

1359```text theme={null}

1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file

1361```

1362 

1363Средство запуска, которое запускается, но завершается без замены себя на Claude Code, приводит к сбою сессии, которую оно запускало, и строка сессии в представлении агента сообщает, что средство запуска `must exec, not daemonize`, за которым следует все, что вывело средство запуска. Сессия, которая не может запуститься или достичь фоновой службы из-за средства запуска, сообщает о проблеме средства запуска как о причине внутри `Couldn't reach the background service (...)`.

1364 

1365**Что делать:**

1366 

1367* Установите переменную на абсолютный путь исполняемого файла, который заканчивается вызовом `exec "$@"`. Полный контракт см. в разделе [контракт средства запуска](/ru/corporate-launcher#the-launcher-contract)

1368* Проверьте `/status`, который показывает разрешенную команду запуска в записи Self-exec и предупреждает, когда работающая фоновая служба не совпадает с ней, или запустите `claude daemon status` из оболочки

1369* После исправления значения в блоке `env` [параметров](/ru/corporate-launcher#set-up-the-launcher) перезагрузите фоновую службу с помощью `claude daemon stop --any`, чтобы следующая отправка запустила завернутую

1142 1370 

1143<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">

1144 Предупреждения о конфигурации1372 Предупреждения о конфигурации


1150 Рабочее пространство не было доверено1378 Рабочее пространство не было доверено

1151</h3>1379</h3>

1152 1380 

1153Claude Code обнаружил правила `permissions.allow` или записи `permissions.additionalDirectories` в файле `.claude/settings.json` или `.claude/settings.local.json` проекта и не применил их, потому что [правила разрешения из параметров проекта требуют доверия рабочему пространству](/ru/permissions#project-allow-rules-and-workspace-trust). Количество, имя параметра и имя файла в сообщении варьируются в зависимости от вашей конфигурации. Правила `deny` и `ask` не затронуты.1381Claude Code обнаружил правила `permissions.allow` или записи `permissions.additionalDirectories` в файле `.claude/settings.json` или `.claude/settings.local.json` проекта и не применил их, потому что [правила разрешения из параметров проекта требуют доверия рабочему пространству](/ru/permissions#project-allow-rules-and-workspace-trust). Количество, имя параметра и имя файла в сообщении варьируются в зависимости от вашей конфигурации. На правила `deny` и `ask` это не влияет.

1154 1382 

1155```text theme={null}1383```text theme={null}

1156Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.1384Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.


1158 1386 

1159**Что делать:**1387**Что делать:**

1160 1388 

1161* Запустите `claude` в каталоге и примите диалоговое окно доверия. {/* min-version: 2.1.200 */}Диалоговое окно появляется даже если родительский каталог уже доверен, отображает удерживаемые правила и позволяет вам отклонить их и продолжить работу без них. До версии 2.1.200 в этой ситуации диалоговое окно не появлялось, поэтому этот шаг не мог быть завершен там.1389* Запустите `claude` в каталоге и примите диалоговое окно доверия. {/* min-version: 2.1.200 */}Диалоговое окно появляется даже если родительский каталог уже доверен, отображает удерживаемые правила и позволяет вам отклонить их и продолжить работу без них. До версии 2.1.200 диалоговое окно не появлялось в этой ситуации, поэтому этот шаг не мог быть завершен там.

1162* В [неинтерактивном режиме](/ru/headless) с флагом `-p` диалоговое окно не показывается. Установите запись `hasTrustDialogAccepted` в `~/.claude.json`, используя точный ключ `projects`, который выводит сообщение.1390* В [неинтерактивном режиме](/ru/headless) с флагом `-p` диалоговое окно не отображается. Установите запись `hasTrustDialogAccepted` в `~/.claude.json`, используя точный ключ `projects`, который выводит сообщение.

1163* {/* min-version: 2.1.200 */}Если сообщение указывает на `.claude/settings.local.json` и вы запустили Claude Code вне репозитория git или в вашем домашнем каталоге, обновитесь до версии 2.1.200 или более поздней. Версии 2.1.196 по 2.1.199 рассматривали ваш собственный `.claude/settings.local.json` как предоставленный репозиторием в этих рабочих пространствах. См. [Правила разрешения проекта и доверие рабочему пространству](/ru/permissions#project-allow-rules-and-workspace-trust).1391* {/* min-version: 2.1.200 */}Если сообщение указывает на `.claude/settings.local.json` и вы запустили Claude Code вне репозитория git или в вашем домашнем каталоге, обновитесь до версии 2.1.200 или более поздней. Версии 2.1.196 по 2.1.199 рассматривали ваш собственный `.claude/settings.local.json` как предоставленный репозиторием в этих рабочих пространствах. {/* min-version: 2.1.207 */}На версии 2.1.207 и более поздних обновление недостаточно вне репозитория git, если вы не доверили папке: определение того, что папка находится вне репозитория, запускает git, и Claude Code запускает эту проверку только после того, как вы примете диалоговое окно доверия, поэтому используйте первый шаг. Ваш домашний каталог и любой другой [домашний каталог конфигурации](/ru/permissions#project-allow-rules-and-workspace-trust) исключены и не ждут диалогового окна. См. [Правила разрешения проекта и доверие рабочему пространству](/ru/permissions#project-allow-rules-and-workspace-trust).

1164 1392 

1165<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">

1166 Ответы кажутся менее качественными, чем обычно1394 Ответы кажутся менее качественными, чем обычно


1170 1398 

1171* Настроенный [`--fallback-model`](/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке1399* Настроенный [`--fallback-model`](/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке

1172* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна1400* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна

1173* [Автоматический откат модели](/ru/model-config#automatic-model-fallback) на Fable 5 переводит сеанс на модель Opus по умолчанию и показывает уведомление в расшифровке1401* [Автоматический fallback модели](/ru/model-config#automatic-model-fallback) на Fable 5 переводит сеанс на модель Opus по умолчанию и показывает уведомление в расшифровке

1174 1402 

1175Проверка выбора модели ниже перехватывает второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/ru/model-config) объясняет, когда применяется каждый откат.1403Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/ru/model-config) объясняет, когда применяется каждый fallback.

1176 1404 

1177Сначала проверьте следующее:1405Сначала проверьте следующее:

1178 1406 

1179* **Выбор модели**: запустите `/model`, чтобы подтвердить, что вы используете ожидаемую модель. Предыдущий выбор `/model` или переменная окружения `ANTHROPIC_MODEL` могут привести вас к меньшей модели, чем вы предполагали.1407* **Выбор модели**: запустите `/model`, чтобы подтвердить, что вы используете ожидаемую модель. Предыдущий выбор `/model` или переменная окружения `ANTHROPIC_MODEL` могут привести вас к меньшей модели, чем вы предполагали.

1180* **Уровень усилий**: запустите `/effort`, чтобы проверить текущий уровень рассуждений и повысить его для сложной отладки или проектной работы. Значения по умолчанию варьируются в зависимости от модели, поэтому проверьте перед тем, как предполагать, что вы ниже максимума. См. [Adjust effort level](/ru/model-config#adjust-effort-level) для значений по умолчанию для каждой модели и сокращение `ultrathink`.1408* **Уровень усилий**: запустите `/effort`, чтобы проверить текущий уровень рассуждений и повысить его для сложной отладки или работы над дизайном. Значения по умолчанию варьируются в зависимости от модели, поэтому проверьте перед тем, как предполагать, что вы ниже максимума. См. [Adjust effort level](/ru/model-config#adjust-effort-level) для значений по умолчанию для каждой модели и сокращение `ultrathink`.

1181* **Давление контекста**: запустите `/context`, чтобы увидеть, насколько заполнено окно. Если оно близко к ёмкости, запустите `/compact` в естественной точке разрыва или `/clear`, чтобы начать заново. См. [Explore the context window](/ru/context-window) для информации о том, как auto-compact влияет на предыдущие ходы.1409* **Давление контекста**: запустите `/context`, чтобы увидеть, насколько заполнено окно. Если оно близко к ёмкости, запустите `/compact` в естественной точке разрыва или `/clear`, чтобы начать заново. См. [Explore the context window](/ru/context-window) для того, как auto-compact влияет на предыдущие ходы.

1182* **Устаревшие инструкции**: большие или устаревшие файлы `CLAUDE.md` и определения инструментов MCP потребляют контекст и могут направлять ответы. {/* min-version: 2.1.205 */}Проверка `/doctor` отмечает файлы памяти большого размера и неиспользуемые расширения, а `/context` показывает использование токенов инструментов MCP. До версии v2.1.205 `/doctor` открывал экран диагностики, который отмечал файлы памяти большого размера и определения подагентов.1410* **Устаревшие инструкции**: большие или устаревшие файлы `CLAUDE.md` и определения инструментов MCP потребляют контекст и могут направлять ответы. {/* min-version: 2.1.205 */}Проверка `/doctor` отмечает файлы памяти большого размера и неиспользуемые расширения, а `/context` показывает использование токенов инструментов MCP. До версии 2.1.205 `/doctor` открывал экран диагностики, который отмечал файлы памяти большого размера и определения подагентов.

1183 1411 

1184Когда ответ идёт неправильно, откат обычно работает лучше, чем ответ с исправлениями. Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к моменту перед неправильным ходом, затем переформулируйте подсказку с большей конкретикой. Исправление в потоке сохраняет неправильную попытку в контексте, что может привязать более поздние ответы к ней. См. [Checkpointing](/ru/checkpointing).1412Когда ответ идёт неправильно, откат обычно работает лучше, чем ответ с исправлениями. Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к моменту перед неправильным ходом, затем переформулируйте подсказку с большей конкретикой. Исправление в потоке сохраняет неправильную попытку в контексте, что может привязать более поздние ответы к ней. См. [Checkpointing](/ru/checkpointing).

1185 1413 

1186Если качество всё ещё кажется неправильным после проверки вышеуказанного, запустите `/feedback` и опишите, что вы ожидали в сравнении с тем, что вы получили. Обратная связь, отправленная таким образом, включает расшифровку разговора, что является самым быстрым способом для Anthropic диагностировать реальную регрессию. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде.1414Если качество всё ещё кажется неправильным после проверки вышеуказанного, запустите `/feedback` и опишите, что вы ожидали в сравнении с тем, что вы получили. Обратная связь, отправленная таким образом, включает расшифровку разговора, что является самым быстрым способом для Anthropic диагностировать реальную регрессию. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде.

1187 1415 

1188{/* min-version: 2.1.201 */}Если Sonnet 5 отклоняет запрос и ссылается на подозреваемую инъекцию подсказки на Claude Code v2.1.200 или более ранней версии, запустите `claude update`, чтобы получить исправление v2.1.201.1416Если Claude предупреждает о подозреваемой инъекции подсказки или отказывает в запросе из-за подозреваемой инъекции, и текст, который называет предупреждение, это контекст, который Claude Code добавляет в разговор автоматически, а не содержимое файла или веб-сайта, запустите `claude update` и повторите попытку. Если предупреждение повторяется после обновления, [сообщите об этом](#report-an-error) вместо того, чтобы вставлять отмеченное содержимое обратно в подсказку. {/* min-version: 2.1.201 */}До версии 2.1.201 Sonnet 5 отказывал в некоторых запросах таким же образом.

1189 1417 

1190<h2 id="report-an-error">1418<h2 id="report-an-error">

1191 Сообщить об ошибке1419 Сообщить об ошибке


1199 1427 

1200Если ошибка не указана здесь или предложенное исправление не помогает:1428Если ошибка не указана здесь или предложенное исправление не помогает:

1201 1429 

1202* Запустите `/feedback` внутри Claude Code, чтобы отправить стенограмму и описание в Anthropic. Команда также предлагает открыть предварительно заполненную проблему GitHub. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и других сторонних поставщиков `/feedback` сохраняет локальный архив, который вы можете отправить представителю вашей учетной записи Anthropic.1430* Запустите `/feedback` внутри Claude Code, чтобы отправить стенограмму и описание в Anthropic. Команда также предлагает открыть предварительно заполненную проблему GitHub. Отправка в Anthropic требует [аутентификации](/ru/authentication). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и других сторонних поставщиков, или когда учетные данные Anthropic не настроены, `/feedback` сохраняет локальный архив, который вы можете отправить представителю вашей учетной записи Anthropic.

1203* Запустите `claude doctor` из вашей оболочки для диагностики только для чтения вашей установки или запустите `/doctor` внутри Claude Code, чтобы найти и исправить проблемы конфигурации1431* Запустите `claude doctor` из вашей оболочки для диагностики только для чтения вашей установки или запустите проверку `/doctor` внутри Claude Code, чтобы найти и исправить проблемы настройки

1204* Проверьте [status.claude.com](https://status.claude.com) на предмет активных инцидентов1432* Проверьте [status.claude.com](https://status.claude.com) на наличие активных инцидентов

1205* Поищите [существующие проблемы](https://github.com/anthropics/claude-code/issues) на GitHub1433* Поищите [существующие проблемы](https://github.com/anthropics/claude-code/issues) на GitHub

fast-mode.md +3 −1

Details

47 47 

48Когда вы отключаете быстрый режим с помощью `/fast` снова, вы остаетесь на Opus. Модель не возвращается к вашей предыдущей модели. Чтобы переключиться на другую модель, используйте `/model`.48Когда вы отключаете быстрый режим с помощью `/fast` снова, вы остаетесь на Opus. Модель не возвращается к вашей предыдущей модели. Чтобы переключиться на другую модель, используйте `/model`.

49 49 

50Переключение на модель, которая не поддерживает быстрый режим, отключает быстрый режим. {/* min-version: 2.1.208 */}Переключение обратно на поддерживаемую модель Opus включает его снова, когда ваше сохраненное предпочтение быстрого режима включено, то же самое предпочтение, с которого новый сеанс начинается по умолчанию. С настроенным [обязательным согласием за сеанс](#require-per-session-opt-in) переключение обратно не включает быстрый режим снова; запустите `/fast` для его повторного включения. Быстрый режим никогда не включается для сеанса, чье сохраненное предпочтение отключено, и значок `↯` и подтверждение "Fast mode ON" появляются всякий раз, когда он активируется. До версии v2.1.208 быстрый режим оставался отключенным после переключения обратно, пока вы снова не запустили `/fast`.

51 

50Opus 4.8 является стандартным режимом быстрого режима в Claude Code v2.1.154 и позже. На версиях v2.1.142 по v2.1.153 быстрый режим по умолчанию использует Opus 4.7.52Opus 4.8 является стандартным режимом быстрого режима в Claude Code v2.1.154 и позже. На версиях v2.1.142 по v2.1.153 быстрый режим по умолчанию использует Opus 4.7.

51 53 

52<h2 id="understand-the-cost-tradeoff">54<h2 id="understand-the-cost-tradeoff">


100Быстрый режим требует всех следующих условий:102Быстрый режим требует всех следующих условий:

101 103 

102* **Только API Anthropic или подписка**: быстрый режим доступен через API Anthropic Console и для планов подписки Claude с использованием дополнительного использования. Он недоступен на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS.104* **Только API Anthropic или подписка**: быстрый режим доступен через API Anthropic Console и для планов подписки Claude с использованием дополнительного использования. Он недоступен на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS.

103* **Включено дополнительное использование**: ваша учетная запись должна иметь включенное дополнительное использование, которое позволяет выставлять счета сверх включенного использования вашего плана. Для индивидуальных учетных записей включите это в [параметрах выставления счетов Console](https://platform.claude.com/settings/organization/billing). Для Team и Enterprise администратор должен включить дополнительное использование для организации.105* **Включено дополнительное использование**: ваша учетная запись должна иметь включенное дополнительное использование, которое позволяет выставлять счета сверх включенного использования вашего плана. Для индивидуальных учетных записей включите это в [параметрах выставления счетов Console](https://platform.claude.com/settings/billing). Для Team и Enterprise администратор должен включить дополнительное использование для организации.

104 106 

105<Note>107<Note>

106 Использование быстрого режима выставляется непосредственно на дополнительное использование, даже если у вас осталось использование в вашем плане. Это означает, что токены быстрого режима не учитываются в отношении включенного использования вашего плана и взимаются по цене быстрого режима с первого токена.108 Использование быстрого режима выставляется непосредственно на дополнительное использование, даже если у вас осталось использование в вашем плане. Это означает, что токены быстрого режима не учитываются в отношении включенного использования вашего плана и взимаются по цене быстрого режима с первого токена.

Details

27 Функции, доступные у каждого поставщика27 Функции, доступные у каждого поставщика

28</h3>28</h3>

29 29 

30Они работают одинаково у каждого поставщика:30Они работают у каждого поставщика:

31 31 

32* [CLI](/ru/quickstart) и [Agent SDK](/ru/agent-sdk/overview)32* [CLI](/ru/quickstart) и [Agent SDK](/ru/agent-sdk/overview)

33* Расширения [VS Code](/ru/vs-code) и [JetBrains](/ru/jetbrains)33* Расширения [VS Code](/ru/vs-code) и [JetBrains](/ru/jetbrains)


36* [Checkpoints](/ru/checkpointing), [sandboxing](/ru/sandboxing) и [Workflows](/ru/workflows)36* [Checkpoints](/ru/checkpointing), [sandboxing](/ru/sandboxing) и [Workflows](/ru/workflows)

37* [Метрики OpenTelemetry](/ru/monitoring-usage) и [управляемый файл параметров](/ru/settings#settings-files)37* [Метрики OpenTelemetry](/ru/monitoring-usage) и [управляемый файл параметров](/ru/settings#settings-files)

38 38 

39Три из них имеют различия, зависящие от поставщика:

40 

41* **MCP servers**: [коннекторы из claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai) загружаются только когда ваша подписка claude.ai является активным методом аутентификации, и [поиск инструментов](/ru/mcp#configure-tool-search) отключён по умолчанию на Google Cloud's Agent Platform и когда `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий первой стороне

42* **Subagents**: встроенный [Explore subagent](/ru/sub-agents#built-in-subagents) ограничивает унаследованную модель до Opus на Claude API и наследует модель основного разговора напрямую у любого другого поставщика, включая Claude Platform на AWS

43* **[Commands](/ru/commands#all-commands)**: `/design-sync` и `/radio` недоступны на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS, а `/voice` требует учётную запись claude.ai

44 

39<h3 id="features-that-require-a-claude-subscription">45<h3 id="features-that-require-a-claude-subscription">

40 Функции, требующие подписку Claude46 Функции, требующие подписку Claude

41</h3>47</h3>


53* [Artifacts](/ru/artifacts): планы Pro, Max, Team и Enterprise59* [Artifacts](/ru/artifacts): планы Pro, Max, Team и Enterprise

54* [Voice dictation](/ru/voice-dictation)60* [Voice dictation](/ru/voice-dictation)

55 61 

56Desktop — частичное исключение: развёртывания Enterprise могут маршрутизировать Desktop на Google Cloud's Agent Platform или поставщика шлюза через [управляемые параметры](https://support.claude.com/en/articles/12622667-enterprise-configuration), а [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview) запускает вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM. Для доступности этих функций по плану см. [Доступность по плану подписки](#availability-by-subscription-plan).62Desktop — частичное исключение: [маршрутизация шлюза может быть настроена в приложении или администратором](/ru/llm-gateway-connect#desktop-app), развёртывания Enterprise могут маршрутизировать Desktop на Google Cloud's Agent Platform или поставщика шлюза через [управляемые параметры](https://claude.com/docs/third-party/claude-desktop/configuration), а [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview) запускает вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM. Для доступности этих функций по плану см. [Доступность по плану подписки](#availability-by-subscription-plan).

57 63 

58<h3 id="cli-capabilities-that-vary-by-provider">64<h3 id="cli-capabilities-that-vary-by-provider">

59 Возможности CLI, которые различаются по поставщикам65 Возможности CLI, которые различаются по поставщикам


81 <td>✓</td>87 <td>✓</td>

82 <td>✗</td>88 <td>✗</td>

83 <td>✓</td>89 <td>✓</td>

84 <td>See note <sup><a href="#fn1">1</a></sup></td>90 <td>См. примечание <sup><a href="#fn1">1</a></sup></td>

85 <td>✓</td>91 <td>✓</td>

86 </tr>92 </tr>

87 93 


99 <td>[Auto mode](/ru/auto-mode-config)</td>105 <td>[Auto mode](/ru/auto-mode-config)</td>

100 <td>✓</td>106 <td>✓</td>

101 <td>✓</td>107 <td>✓</td>

102 <td>See note <sup><a href="#fn2">2</a></sup></td>108 <td>См. примечание <sup><a href="#fn2">2</a></sup></td>

103 <td>✓</td>109 <td>✓</td>

104 <td>See note <sup><a href="#fn2">2</a></sup></td>110 <td>См. примечание <sup><a href="#fn2">2</a></sup></td>

105 <td>See note <sup><a href="#fn2">2</a></sup></td>111 <td>См. примечание <sup><a href="#fn2">2</a></sup></td>

106 </tr>112 </tr>

107 113 

108 <tr>114 <tr>


129 <td>[`/loop` scheduled tasks](/ru/scheduled-tasks)</td>135 <td>[`/loop` scheduled tasks](/ru/scheduled-tasks)</td>

130 <td>✓</td>136 <td>✓</td>

131 <td>✓</td>137 <td>✓</td>

132 <td>See note <sup><a href="#fn3">3</a></sup></td>138 <td>См. примечание <sup><a href="#fn3">3</a></sup></td>

133 <td></td>139 <td>См. примечание <sup><a href="#fn3">3</a></sup></td>

134 <td>See note <sup><a href="#fn3">3</a></sup></td>140 <td>См. примечание <sup><a href="#fn3">3</a></sup></td>

135 <td>See note <sup><a href="#fn3">3</a></sup></td>141 <td>См. примечание <sup><a href="#fn3">3</a></sup></td>

136 </tr>142 </tr>

137 143 

138 <tr>144 <tr>


200</table>206</table>

201 207 

202<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> На Google Cloud's Agent Platform веб-поиск доступен для моделей Claude 4 и более поздних версий.<br />208<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> На Google Cloud's Agent Platform веб-поиск доступен для моделей Claude 4 и более поздних версий.<br />

203<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> Требует `CLAUDE_CODE_ENABLE_AUTO_MODE`. См. [Конфигурация Auto mode](/ru/auto-mode-config).<br />209<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> На этих поставщиках auto mode поддерживает только Claude Sonnet 5, Opus 4.7 и Opus 4.8. См. [Конфигурация Auto mode](/ru/auto-mode-config). {/* min-version: 2.1.207 */}В v2.1.158 через v2.1.206 auto mode на этих поставщиках также требовал установки `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 удалил это требование.<br />

204<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Явные интервалы, такие как `/loop every 2 hours`, работают у каждого поставщика. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry `/loop` не может выбрать свой собственный интервал или предоставить подсказку обслуживания по умолчанию, поэтому подсказка без интервала выполняется каждые 10 минут, а `/loop` без аргументов показывает сообщение об использовании. См. [Scheduled tasks](/ru/scheduled-tasks).<br />210<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Явные интервалы, такие как `/loop every 2 hours`, работают у каждого поставщика. На Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform и Microsoft Foundry `/loop` не может выбрать свой собственный интервал или предоставить подсказку обслуживания по умолчанию, поэтому подсказка без интервала выполняется каждые 10 минут, а `/loop` без аргументов показывает сообщение об использовании. См. [Scheduled tasks](/ru/scheduled-tasks).<br />

205<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> В соответствии с вашим соглашением с поставщиком облачных услуг.<br />211<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> В соответствии с вашим соглашением с поставщиком облачных услуг.<br />

206<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Только панель управления и API. [Contribution metrics](/ru/analytics#enable-contribution-metrics) требует организацию claude.ai Team или Enterprise.212<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Только панель управления и API. [Contribution metrics](/ru/analytics#enable-contribution-metrics) требует организацию claude.ai Team или Enterprise.

207 213 


213 Сводка по поставщикам219 Сводка по поставщикам

214</h3>220</h3>

215 221 

216Каждая вкладка содержит список того, что недоступно или частично поддерживается у этого поставщика, с альтернативами, где они существуют. Всё, что не указано, работает так же, как в подписке Claude. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS отчёты об ошибках и телеметрия для Anthropic отключены по умолчанию. См. [поведение по умолчанию по поставщику API](/ru/data-usage#default-behaviors-by-api-provider) для информации о том, какой трафик всё ещё достигает Anthropic и как отказаться.222Каждая вкладка содержит список того, что недоступно или частично поддерживается у этого поставщика, с альтернативами, где они существуют. Всё, что не указано, работает так же, как в подписке Claude, кроме [различий, зависящих от поставщика](#features-available-on-every-provider), отмеченных выше. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS отчёты об ошибках и телеметрия для Anthropic отключены по умолчанию. См. [поведение по умолчанию по поставщику API](/ru/data-usage#default-behaviors-by-api-provider) для информации о том, какой трафик всё ещё достигает Anthropic и как отказаться.

217 223 

218<Tabs>224<Tabs>

219 <Tab title="Amazon Bedrock">225 <Tab title="Amazon Bedrock">

220 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [веб-поиск](/ru/tools-reference#websearch-tool-behavior), [fast mode](/ru/fast-mode), [Advisor](/ru/advisor), [Channels](/ru/channels), [панель управления аналитики](/ru/analytics) и [server-managed settings](/ru/server-managed-settings).226 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [веб-поиск](/ru/tools-reference#websearch-tool-behavior), [fast mode](/ru/fast-mode), [Advisor](/ru/advisor), [Channels](/ru/channels), [панель управления аналитики](/ru/analytics), [server-managed settings](/ru/server-managed-settings) и [команды `/design-sync` и `/radio`](/ru/commands#all-commands).

221 227 

222 **Частичная поддержка:**228 **Частичная поддержка:**

223 229 

224 * [Desktop](/ru/desktop): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)230 * [Desktop](/ru/desktop): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)

225 * [Auto mode](/ru/auto-mode-config): установите `CLAUDE_CODE_ENABLE_AUTO_MODE`231 * [Auto mode](/ru/auto-mode-config): только Sonnet 5, Opus 4.7 и Opus 4.8

226 * [`/loop`](/ru/scheduled-tasks): только явные интервалы232 * [`/loop`](/ru/scheduled-tasks): только явные интервалы

227 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением AWS233 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением AWS

228 234 


230 </Tab>236 </Tab>

231 237 

232 <Tab title="Claude Platform на AWS">238 <Tab title="Claude Platform на AWS">

233 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](/ru/fast-mode), [Advisor](/ru/advisor), [Channels](/ru/channels), [панель управления аналитики](/ru/analytics) и [server-managed settings](/ru/server-managed-settings).239 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](/ru/fast-mode), [Advisor](/ru/advisor), [Channels](/ru/channels), [панель управления аналитики](/ru/analytics), [server-managed settings](/ru/server-managed-settings) и [команды `/design-sync` и `/radio`](/ru/commands#all-commands).

240 

241 **Доступно** там, где Amazon Bedrock недоступен: [веб-поиск](/ru/tools-reference#websearch-tool-behavior).

234 242 

235 **Доступно** там, где Amazon Bedrock недоступен: [веб-поиск](/ru/tools-reference#websearch-tool-behavior), [auto mode](/ru/auto-mode-config) без флага opt-in и [`/loop` self-pacing](/ru/scheduled-tasks).243 **Частичная поддержка:**

244 

245 * [`/loop`](/ru/scheduled-tasks): только явные интервалы

236 246 

237 **Альтернативы:** для планирования используйте [`/loop`](/ru/scheduled-tasks) вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](/ru/github-actions) или [GitLab CI/CD](/ru/gitlab-ci-cd).247 **Альтернативы:** для планирования используйте [`/loop`](/ru/scheduled-tasks) с явным интервалом вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](/ru/github-actions) или [GitLab CI/CD](/ru/gitlab-ci-cd).

238 </Tab>248 </Tab>

239 249 

240 <Tab title="Google Cloud's Agent Platform">250 <Tab title="Google Cloud's Agent Platform">

241 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](/ru/fast-mode), [Advisor](/ru/advisor), [Channels](/ru/channels), [панель управления аналитики](/ru/analytics) и [server-managed settings](/ru/server-managed-settings).251 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](/ru/fast-mode), [Advisor](/ru/advisor), [Channels](/ru/channels), [панель управления аналитики](/ru/analytics), [server-managed settings](/ru/server-managed-settings) и [команды `/design-sync` и `/radio`](/ru/commands#all-commands).

242 252 

243 **Частичная поддержка:**253 **Частичная поддержка:**

244 254 

245 * [Desktop](/ru/desktop): через [управляемые параметры](https://support.claude.com/en/articles/12622667-enterprise-configuration) или [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)255 * [Desktop](/ru/desktop): через [управляемые параметры](https://claude.com/docs/third-party/claude-desktop/configuration) или [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)

246 * [Web search](/ru/tools-reference#websearch-tool-behavior): модели Claude 4 и более поздние256 * [Web search](/ru/tools-reference#websearch-tool-behavior): модели Claude 4 и более поздние

247 * [Auto mode](/ru/auto-mode-config): установите `CLAUDE_CODE_ENABLE_AUTO_MODE`257 * [Auto mode](/ru/auto-mode-config): только Sonnet 5, Opus 4.7 и Opus 4.8

248 * [`/loop`](/ru/scheduled-tasks): только явные интервалы258 * [`/loop`](/ru/scheduled-tasks): только явные интервалы

249 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением Google Cloud259 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением Google Cloud

250 260 


252 </Tab>262 </Tab>

253 263 

254 <Tab title="Microsoft Foundry">264 <Tab title="Microsoft Foundry">

255 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](/ru/fast-mode), [Advisor](/ru/advisor), [Channels](/ru/channels), [GitHub Actions](/ru/github-actions) и [GitLab CI/CD](/ru/gitlab-ci-cd), [панель управления аналитики](/ru/analytics) и [server-managed settings](/ru/server-managed-settings).265 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](/ru/fast-mode), [Advisor](/ru/advisor), [Channels](/ru/channels), [GitHub Actions](/ru/github-actions) и [GitLab CI/CD](/ru/gitlab-ci-cd), [панель управления аналитики](/ru/analytics), [server-managed settings](/ru/server-managed-settings) и [команды `/design-sync` и `/radio`](/ru/commands#all-commands).

256 266 

257 **Частичная поддержка:**267 **Частичная поддержка:**

258 268 

259 * [Desktop](/ru/desktop): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)269 * [Desktop](/ru/desktop): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)

260 * [Auto mode](/ru/auto-mode-config): установите `CLAUDE_CODE_ENABLE_AUTO_MODE`270 * [Auto mode](/ru/auto-mode-config): только Sonnet 5, Opus 4.7 и Opus 4.8

261 * [`/loop`](/ru/scheduled-tasks): только явные интервалы271 * [`/loop`](/ru/scheduled-tasks): только явные интервалы

262 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением Azure272 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением Azure

263 273 


278Если вы аутентифицируетесь через Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или ключ API Anthropic Console, этот раздел к вам не применяется. Когда вы входите с учётной записью claude.ai, ваш план определяет, какие из приведённых ниже функций доступны.288Если вы аутентифицируетесь через Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или ключ API Anthropic Console, этот раздел к вам не применяется. Когда вы входите с учётной записью claude.ai, ваш план определяет, какие из приведённых ниже функций доступны.

279 289 

280| Функция | Pro | Max | Team | Enterprise |290| Функция | Pro | Max | Team | Enterprise |

281| :-------------------------------------------------------------------------------------- | :-- | :-- | :------------ | :-------------------------------- |291| :-------------------------------------------------------------------------- | :-- | :-- | :------------ | :-------------------------------- |

282| [Claude Code в веб-версии](/ru/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |292| [Claude Code в веб-версии](/ru/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |

283| [Routines](/ru/routines) | ✓ | ✓ | ✓ | ✓ |293| [Routines](/ru/routines) | ✓ | ✓ | ✓ | ✓ |

284| [Remote Control](/ru/remote-control) | ✓ | ✓ | Admin-enabled | Admin-enabled |294| [Remote Control](/ru/remote-control) | ✓ | ✓ | Admin-enabled | Admin-enabled |


292| [Server-managed settings](/ru/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |302| [Server-managed settings](/ru/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |

293| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |303| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |

294| SCIM | ✗ | ✗ | ✗ | ✓ |304| SCIM | ✗ | ✗ | ✗ | ✓ |

295| [Compliance API](https://platform.claude.com/docs/en/api/admin-api/compliance/overview) | ✗ | ✗ | ✗ | ✓ |305| [Compliance API](https://platform.claude.com/docs/en/api/compliance) | ✗ | ✗ | ✗ | ✓ |

296| [Zero Data Retention](/ru/zero-data-retention) | ✗ | ✗ | ✗ | ✓ <sup><a href="#fn7">7</a></sup> |306| [Zero Data Retention](/ru/zero-data-retention) | ✗ | ✗ | ✗ | ✓ <sup><a href="#fn7">7</a></sup> |

297 307 

298<span id="fn6" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>6</sup> На Enterprise требуется премиум-место или место Chat + Claude Code. См. [Claude Code в веб-версии](/ru/claude-code-on-the-web).<br />308<span id="fn6" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>6</sup> На Enterprise требуется премиум-место или место Chat + Claude Code. См. [Claude Code в веб-версии](/ru/claude-code-on-the-web).<br />

Details

73 Сравните похожие функции73 Сравните похожие функции

74</h3>74</h3>

75 75 

76Некоторые функции могут казаться похожими. Вот как их различить.76Некоторые функции могут казаться похожими. Для более глубокого разбора выбора между ними см. [Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more) в блоге. Вот как их различить.

77 77 

78<Tabs>78<Tabs>

79 <Tab title="Skill vs Subagent">79 <Tab title="Skill vs Subagent">

fullscreen.md +16 −3

Details

7> Включите более плавный режим визуализации без мерцания с поддержкой мыши и стабильным использованием памяти в длительных диалогах.7> Включите более плавный режим визуализации без мерцания с поддержкой мыши и стабильным использованием памяти в длительных диалогах.

8 8 

9<Note>9<Note>

10 Полноэкранная визуализация — это добровольный [исследовательский предпросмотр](#research-preview). Запустите `/tui fullscreen` для переключения в текущем диалоге или установите `CLAUDE_CODE_NO_FLICKER=1` в версиях до v2.1.110. Поведение может измениться на основе обратной связи.10 Полноэкранная визуализация — это добровольный [исследовательский предпросмотр](#research-preview). Запустите `/tui fullscreen` для переключения в текущем диалоге. Поведение может измениться на основе обратной связи.

11</Note>11</Note>

12 12 

13Полноэкранная визуализация — это альтернативный путь визуализации для Claude Code CLI, который устраняет мерцание, поддерживает использование памяти на постоянном уровне в длительных диалогах и добавляет поддержку мыши. Она рисует интерфейс на альтернативном буфере экрана терминала, как `vim` или `htop`, и отображает только видимые в данный момент сообщения. Это снижает объём данных, отправляемых на ваш терминал при каждом обновлении.13Полноэкранная визуализация — это альтернативный путь визуализации для Claude Code CLI, который устраняет мерцание, поддерживает использование памяти на постоянном уровне в длительных диалогах и добавляет поддержку мыши. Она рисует интерфейс на альтернативном буфере экрана терминала, как `vim` или `htop`, и отображает только видимые в данный момент сообщения. Это снижает объём данных, отправляемых на ваш терминал при каждом обновлении.


24 24 

25Запустите `/tui fullscreen` в любом диалоге Claude Code. CLI сохраняет параметр [`tui`](/ru/settings#available-settings) и перезагружается в полноэкранный режим с вашим диалогом в целости, поэтому вы можете переключаться в середине сеанса без потери контекста. Запустите `/tui default` для переключения обратно на классический рендерер или `/tui` без аргумента для вывода информации о том, какой рендерер активен.25Запустите `/tui fullscreen` в любом диалоге Claude Code. CLI сохраняет параметр [`tui`](/ru/settings#available-settings) и перезагружается в полноэкранный режим с вашим диалогом в целости, поэтому вы можете переключаться в середине сеанса без потери контекста. Запустите `/tui default` для переключения обратно на классический рендерер или `/tui` без аргумента для вывода информации о том, какой рендерер активен.

26 26 

27Перезагруженный сеанс сохраняет диалог в том виде, в котором он отображается на экране. Если вы ранее запустили [`/rewind`](/ru/checkpointing#rewind-and-summarize) в этом сеансе, перезагрузка возобновляется с точки перемотки, а не с более длинной стенограммы, сохраненной на диске. До версии v2.1.207 переключение рендереров после перемотки восстанавливало диалог, который перемотка удалила.

28 

27Вы также можете установить переменную окружения `CLAUDE_CODE_NO_FLICKER` перед запуском Claude Code:29Вы также можете установить переменную окружения `CLAUDE_CODE_NO_FLICKER` перед запуском Claude Code:

28 30 

29```bash theme={null}31```bash theme={null}


57* **Клик в поле ввода подсказки** для позиционирования курсора в любом месте вводимого вами текста.59* **Клик в поле ввода подсказки** для позиционирования курсора в любом месте вводимого вами текста.

58* **Клик по предложению в команде `/` или списке файлов `@`** для его принятия. Наведение курсора выделяет строку под вашим курсором.60* **Клик по предложению в команде `/` или списке файлов `@`** для его принятия. Наведение курсора выделяет строку под вашим курсором.

59* **Клик по опции в меню выбора** для её выбора. Это охватывает запросы разрешений, `/model`, `/config` и другие диалоги, которые показывают список опций. Наведение курсора показывает указатель на строке под вашим курсором. {/* min-version: 2.1.187 */}Требуется Claude Code v2.1.187 или позже.61* **Клик по опции в меню выбора** для её выбора. Это охватывает запросы разрешений, `/model`, `/config` и другие диалоги, которые показывают список опций. Наведение курсора показывает указатель на строке под вашим курсором. {/* min-version: 2.1.187 */}Требуется Claude Code v2.1.187 или позже.

62* **Клик по опции в меню множественного выбора** для её переключения, и клик по кнопке отправки для подтверждения ваших выборов. Клик по строке свободного текста, такой как строка `Other` в вопросе с множественным выбором, фокусирует её поле ввода, чтобы вы могли ввести ответ. {/* min-version: 2.1.208 */}Требуется Claude Code v2.1.208 или позже.

60* **Клик по свёрнутому результату инструмента** для его развёртывания и просмотра полного выходного сигнала. Клик снова для свёртывания. Вызов инструмента и его результат развёртываются вместе. Кликабельны только сообщения, которые имеют больше для отображения.63* **Клик по свёрнутому результату инструмента** для его развёртывания и просмотра полного выходного сигнала. Клик снова для свёртывания. Вызов инструмента и его результат развёртываются вместе. Кликабельны только сообщения, которые имеют больше для отображения.

61* **Удерживайте `Cmd` на macOS или `Ctrl` на Linux и Windows и клик по URL или пути к файлу** для его открытия. Пути к файлам в выходных данных инструмента, такие как те, которые выводятся после Edit или Write, открываются в вашем приложении по умолчанию. Простые `http://` и `https://` URL открываются в вашем браузере. {/* min-version: 2.1.181 */}Начиная с версии 2.1.181, простой клик без удержания `Cmd` или `Ctrl` больше не открывает ссылки, что соответствует поведению встроенного терминала. Некоторые терминалы macOS перенаправляют `Cmd`+клик запущенному приложению вместо открытия ссылки самостоятельно, и протокол мыши терминала не имеет способа кодировать клавишу `Cmd`, поэтому Claude Code получает это как простой клик. В Ghostty и {/* min-version: 2.1.198 */}начиная с версии 2.1.198 в Warp на macOS, Claude Code это обнаруживает и позволяет простому клику по ссылке открыть её, а удержание `Cmd` всё ещё работает. Во встроенном терминале VS Code и аналогичных терминалах на основе xterm.js Claude Code уступает собственному обработчику ссылок терминала, который использует тот же жест.64* **Удерживайте `Cmd` на macOS или `Ctrl` на Linux и Windows и клик по URL или пути к файлу** для его открытия. Пути к файлам в выходных данных инструмента, такие как те, которые выводятся после Edit или Write, открываются в вашем приложении по умолчанию. Простые `http://` и `https://` URL открываются в вашем браузере. {/* min-version: 2.1.181 */}Начиная с версии 2.1.181, простой клик без удержания `Cmd` или `Ctrl` больше не открывает ссылки, что соответствует поведению встроенного терминала. Некоторые терминалы macOS перенаправляют `Cmd`+клик запущенному приложению вместо открытия ссылки самостоятельно, и протокол мыши терминала не имеет способа кодировать клавишу `Cmd`, поэтому Claude Code получает это как простой клик. В Ghostty и {/* min-version: 2.1.198 */}начиная с версии 2.1.198 в Warp на macOS, Claude Code это обнаруживает и позволяет простому клику по ссылке открыть её, а удержание `Cmd` всё ещё работает. Во встроенном терминале VS Code и аналогичных терминалах на основе xterm.js Claude Code уступает собственному обработчику ссылок терминала, который использует тот же жест.

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


81| `Ctrl+End` | Переход к последнему сообщению и повторное включение автоследования |84| `Ctrl+End` | Переход к последнему сообщению и повторное включение автоследования |

82| Колесо мыши | Прокрутка на несколько строк за раз |85| Колесо мыши | Прокрутка на несколько строк за раз |

83 86 

84На клавиатурах без выделенных клавиш `PgUp`, `PgDn`, `Home` или `End`, таких как клавиатуры MacBook, удерживайте `Fn` с клавишами со стрелками: `Fn+↑` отправляет `PgUp`, `Fn+↓` отправляет `PgDn`, `Fn+←` отправляет `Home`, и `Fn+→` отправляет `End`. Это делает `Ctrl+Fn+→` сочетанием клавиш для перехода в конец. Если это кажется неудобным, прокрутите в конец колесом мыши для возобновления следования, или переназначьте `scroll:bottom` на что-то более доступное.87На клавиатурах без выделенных клавиш `PgUp`, `PgDn`, `Home` или `End`, таких как клавиатуры MacBook, удерживайте `Fn` с клавишами со стрелками: `Fn+↑` отправляет `PgUp`, `Fn+↓` отправляет `PgDn`, `Fn+←` отправляет `Home`, и `Fn+→` отправляет `End`. `Ctrl+Fn+→` не достигает Claude Code на macOS, поэтому клавиатура MacBook по умолчанию не имеет рабочего сочетания клавиш для перехода в конец. Вместо этого используйте один из этих вариантов:

88 

89* Нажмите [кнопку перехода в конец](#auto-follow).

90* Прокрутите в конец колесом мыши для возобновления следования.

91* Переназначьте `scroll:bottom` на сочетание клавиш, которое может отправить ваша клавиатура.

85 92 

86Эти действия переназначаемы. Смотрите [Scroll actions](/ru/keybindings#scroll-actions) для полного списка имён действий, включая варианты с половиной страницы и полной страницей, которые не имеют привязки по умолчанию.93Эти действия переназначаемы. Смотрите [Scroll actions](/ru/keybindings#scroll-actions) для полного списка имён действий, включая варианты с половиной страницы и полной страницей, которые не имеют привязки по умолчанию.

87 94 


89 Автоследование96 Автоследование

90</h3>97</h3>

91 98 

92Прокрутка вверх приостанавливает автоследование, чтобы новый выходной сигнал не тянул вас обратно в конец. Нажмите `Ctrl+End` или прокрутите в конец для возобновления следования.99Прокрутка вверх приостанавливает автоследование, чтобы новый выходной сигнал не тянул вас обратно в конец. Кнопка `Перейти в конец` плавает над нижним краем стенограммы, пока вы прокручиваете вверх, и показывает счётчик, например `3 новых сообщения`, когда поступает новый выходной сигнал. Нажмите её, нажмите `Ctrl+End` или прокрутите в конец для возобновления следования.

100 

101Пока автоследование приостановлено, представление также остаётся там, где вы его прокрутили, когда ответ заканчивает потоковую передачу. До версии 2.1.207 представление могло прыгнуть выше начала ответа, когда длинный ответ заканчивал потоковую передачу.

102 

103Подсказка клавиатуры кнопки отражает то, что может отправить ваша клавиатура. На macOS она предлагает нажать, или `Fn+↓` для прокрутки, потому что `Ctrl+End` не достигает Claude Code с клавиатуры Mac. Переназначьте [`scroll:bottom`](/ru/keybindings#scroll-actions) и кнопка показывает ваше сочетание клавиш на каждой платформе. До версии 2.1.206 кнопка предлагала `Ctrl+End` на macOS.

104 

105На терминале, слишком узком для полной метки, кнопка сокращает подсказку вместо переноса на строку стенограммы ниже. До версии 2.1.206 длинная метка могла переноситься на стенограмму.

93 106 

94Чтобы полностью отключить автоследование, чтобы представление оставалось там, где вы его оставили, откройте `/config` и установите Auto-scroll на off. С отключённой автопрокруткой представление никогда не прыгает в конец самостоятельно. Диалоги запроса разрешения и другие диалоги, требующие ответа, всё ещё прокручиваются в поле зрения независимо от этого параметра.107Чтобы полностью отключить автоследование, чтобы представление оставалось там, где вы его оставили, откройте `/config` и установите Auto-scroll на off. С отключённой автопрокруткой представление никогда не прыгает в конец самостоятельно. Диалоги запроса разрешения и другие диалоги, требующие ответа, всё ещё прокручиваются в поле зрения независимо от этого параметра.

95 108 

gateways.md +1 −1

Details

74 74 

75* **Какая модель отвечает**: выберите модель с помощью команды `/model` или [переменных окружения модели](/ru/model-config#setting-your-model). Шлюз решает, куда идут запросы, а не какую модель выбирает разработчик. Claude apps gateway может ограничить выбор с помощью списка разрешений `availableModels` для каждой группы, но разработчик все равно выбирает в его пределах.75* **Какая модель отвечает**: выберите модель с помощью команды `/model` или [переменных окружения модели](/ru/model-config#setting-your-model). Шлюз решает, куда идут запросы, а не какую модель выбирает разработчик. Claude apps gateway может ограничить выбор с помощью списка разрешений `availableModels` для каждой группы, но разработчик все равно выбирает в его пределах.

76* **Другой сетевой трафик**: Claude Code сам отправляет проверки версий и загрузки непосредственно в Anthropic, отдельно от пути шлюза. Находится ли дополнительный поток телеметрии клиента также зависит от вашего поставщика; [таблица стандартных значений телеметрии](/ru/data-usage#telemetry-services) охватывает каждый случай. В сеансе Claude apps gateway с входом учетные данные шлюза отключают аналитику, связанную с Anthropic, и, когда [перенаправление телеметрии](/ru/claude-apps-gateway-config#telemetry) настроено, закрепляет экспорт OTLP на шлюзе. Вашей сети по-прежнему требуется исходящий трафик на [требуемые домены](/ru/network-config), или установите [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/ru/env-vars) для отключения дополнительных потоков.76* **Другой сетевой трафик**: Claude Code сам отправляет проверки версий и загрузки непосредственно в Anthropic, отдельно от пути шлюза. Находится ли дополнительный поток телеметрии клиента также зависит от вашего поставщика; [таблица стандартных значений телеметрии](/ru/data-usage#telemetry-services) охватывает каждый случай. В сеансе Claude apps gateway с входом учетные данные шлюза отключают аналитику, связанную с Anthropic, и, когда [перенаправление телеметрии](/ru/claude-apps-gateway-config#telemetry) настроено, закрепляет экспорт OTLP на шлюзе. Вашей сети по-прежнему требуется исходящий трафик на [требуемые домены](/ru/network-config), или установите [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/ru/env-vars) для отключения дополнительных потоков.

77* **Корпоративные HTTP прокси**: `HTTPS_PROXY` находится между Claude Code и каждым сервером, с которым он разговаривает, включая шлюз. Если ваша сеть требует его, [настройте прокси](/ru/network-config) в дополнение к шлюзу. Для Claude apps gateway в частности, [вход проверяет, что хост прокси также находится в частной сети](/ru/claude-apps-gateway#prerequisites); если это не так, добавьте хост шлюза в `NO_PROXY`, чтобы CLI подключался к нему напрямую.77* **Корпоративные HTTP прокси**: `HTTPS_PROXY` находится между Claude Code и каждым сервером, с которым он разговаривает, включая шлюз. Если ваша сеть требует его, [настройте прокси](/ru/network-config) в дополнение к шлюзу. Для Claude apps gateway, который вы размещаете, [вход проверяет, что хост прокси также находится в частной сети](/ru/claude-apps-gateway#prerequisites); если это не так, добавьте хост шлюза в `NO_PROXY`, чтобы CLI подключался к нему напрямую.

78 78 

79<h2 id="next-steps">79<h2 id="next-steps">

80 Next steps80 Next steps

glossary.md +1 −1

Details

48 Artifact48 Artifact

49</h3>49</h3>

50 50 

51Живая интерактивная веб-страница, которую Claude Code публикует из вашего сеанса на приватный URL на claude.ai, чтобы вы могли видеть результат визуально или поделиться им внутри вашей организации вместо чтения текста терминала. Страница обновляется на месте, когда сеанс переиздаёт её. Артефакты, которые вы создаёте из Claude Code, появляются в той же галерее, что и артефакты, созданные в разговорах claude.ai, но их совместное использование ограничивается вашей организацией, и они не могут быть сделаны общедоступными.51Живая интерактивная веб-страница, которую Claude Code публикует из вашего сеанса на приватный URL на claude.ai, чтобы вы могли видеть результат визуально или поделиться им вместо чтения текста терминала. Страница обновляется на месте, когда сеанс переиздаёт её. Артефакты, которые вы создаёте из Claude Code, появляются в той же галерее, что и артефакты, созданные в разговорах claude.ai. Совместное использование зависит от вашего плана: на Pro и Max — общедоступная ссылка, которую может открыть кто угодно; на Team и Enterprise — совместное использование в вашей организации, плюс общедоступные ссылки после того, как владелец их включит.

52 52 

53Подробнее: [Share session output as artifacts](/ru/artifacts)53Подробнее: [Share session output as artifacts](/ru/artifacts)

54 54 

goal.md +8 −0

Details

57 57 

58Установка цели немедленно начинает ход с самим условием в качестве директивы. Вам не нужно отправлять отдельную подсказку. Пока цель активна, индикатор `◎ /goal active` показывает, как долго цель работает.58Установка цели немедленно начинает ход с самим условием в качестве директивы. Вам не нужно отправлять отдельную подсказку. Пока цель активна, индикатор `◎ /goal active` показывает, как долго цель работает.

59 59 

60Цель не изменяет разрешения. В режиме разрешений по умолчанию Claude все еще запрашивает разрешение перед вызовами инструментов, которые ваши настройки еще не разрешают, например команда теста выше. Чтобы позволить ходам цели работать без присмотра, объедините `/goal` с [режимом автоматизации](/ru/auto-mode-config).

61 

60После каждого хода оценщик возвращает краткое объяснение того, выполняется ли условие или нет. Самое последнее объяснение появляется в представлении статуса и в стенограмме, чтобы вы могли видеть, над чем Claude будет работать дальше.62После каждого хода оценщик возвращает краткое объяснение того, выполняется ли условие или нет. Самое последнее объяснение появляется в представлении статуса и в стенограмме, чтобы вы могли видеть, над чем Claude будет работать дальше.

61 63 

62<Note>64<Note>


97* Текущие затраты токенов99* Текущие затраты токенов

98* Самое последнее объяснение оценщика100* Самое последнее объяснение оценщика

99 101 

102Количество ходов и самое последнее объяснение появляются после первого запуска оценки.

103 

100Если цель не активна, но одна была достигнута ранее в сеансе, статус показывает достигнутое условие вместе с его продолжительностью, количеством ходов и затратами токенов.104Если цель не активна, но одна была достигнута ранее в сеансе, статус показывает достигнутое условие вместе с его продолжительностью, количеством ходов и затратами токенов.

101 105 

102<h3 id="clear-a-goal">106<h3 id="clear-a-goal">


109/goal clear113/goal clear

110```114```

111 115 

116Claude выводит `Goal cleared:` с последующим условием для подтверждения или `No goal set`, если ничего не было активно.

117 

112`stop`, `off`, `reset`, `none` и `cancel` принимаются как псевдонимы для `clear`. Запуск `/clear` для начала нового разговора также удаляет любую активную цель.118`stop`, `off`, `reset`, `none` и `cancel` принимаются как псевдонимы для `clear`. Запуск `/clear` для начала нового разговора также удаляет любую активную цель.

113 119 

114<h3 id="resume-with-an-active-goal">120<h3 id="resume-with-an-active-goal">


127claude -p "/goal CHANGELOG.md has an entry for every PR merged this week"133claude -p "/goal CHANGELOG.md has an entry for every PR merged this week"

128```134```

129 135 

136При выводе текста по умолчанию ничего не выводится до выполнения условия, поэтому цель, которая работает много ходов, может выглядеть зависшей. Добавьте `--output-format stream-json --verbose`, чтобы выводить каждое сообщение по мере выполнения цикла.

137 

130Прервите процесс с помощью Ctrl+C, чтобы остановить неинтерактивную цель до выполнения условия.138Прервите процесс с помощью Ctrl+C, чтобы остановить неинтерактивную цель до выполнения условия.

131 139 

132<h2 id="how-evaluation-works">140<h2 id="how-evaluation-works">

Details

112 </Step>112 </Step>

113</Steps>113</Steps>

114 114 

115После входа запустите `/setup-vertex` в любое время, чтобы снова открыть мастер и изменить учетные данные, проект, регион или закрепления моделей.115После входа запустите `/setup-vertex` в любое время, чтобы снова открыть мастер и изменить учетные данные, проект, регион или закрепления моделей. Шаг закрепления модели начинается с ваших текущих закрепленных моделей. Мастер записывает данные в `~/.claude/settings.json` или в `$CLAUDE_CONFIG_DIR/settings.json`, когда установлена переменная [`CLAUDE_CONFIG_DIR`](/ru/env-vars#variables).

116 116 

117<h2 id="region-configuration">117<h2 id="region-configuration">

118 Конфигурация региона118 Конфигурация региона


223</h3>223</h3>

224 224 

225<Warning>225<Warning>

226 Закрепите конкретные версии моделей при развертывании для нескольких пользователей. Без закрепления псевдонимы моделей, такие как `sonnet` и `opus`, разрешаются в встроенное значение по умолчанию Claude Code для Google Cloud's Agent Platform, которое может отставать от последнего выпуска и может быть еще не включено в вашем проекте. Claude Code [откатывается](#startup-model-checks) на предыдущую версию при запуске, когда значение по умолчанию недоступно, но закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.226 Закрепите конкретные версии моделей при развертывании для нескольких пользователей. Без закрепления псевдонимы моделей, такие как `sonnet` и `opus`, разрешаются в встроенное значение по умолчанию Claude Code для Google Cloud's Agent Platform, которое может отставать от последнего выпуска и может быть еще не включено в вашем проекте. Claude Code [откатывается](#startup-model-checks) на предыдущую версию или модель более низкого уровня при запуске, когда значение по умолчанию недоступно, но закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.

227</Warning>227</Warning>

228 228 

229Установите эти переменные окружения на конкретные ID моделей Google Cloud's Agent Platform.229Установите эти переменные окружения на конкретные ID моделей Google Cloud's Agent Platform.

230 230 

231Без этих переменных псевдоним `opus` на Google Cloud's Agent Platform разрешается в Opus 4.8, а псевдоним `sonnet` разрешается в Sonnet 4.5. Установите каждую переменную, чтобы закрепить ее псевдоним на конкретную версию:231Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Google Cloud's Agent Platform разрешается в Opus 4.8, а без `ANTHROPIC_DEFAULT_SONNET_MODEL` псевдоним `sonnet` разрешается в Sonnet 4.5. Этот пример закрепляет каждый псевдоним на конкретную версию:

232 232 

233```bash theme={null}233```bash theme={null}

234export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'234export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'


243| Тип модели | Значение по умолчанию |243| Тип модели | Значение по умолчанию |

244| :------------------- | :--------------------------- |244| :------------------- | :--------------------------- |

245| Основная модель | `claude-opus-4-8` |245| Основная модель | `claude-opus-4-8` |

246| Малая/быстрая модель | То же, что и основная модель |246| Малая/быстрая модель | `claude-sonnet-4-5@20250929` |

247 247 

248Фоновые задачи, такие как генерация названия сеанса, используют малую/быструю модель, обычно модель класса Haiku. На Google Cloud's Agent Platform Claude Code по умолчанию использует основную модель, потому что Haiku может быть не включен в каждом проекте или регионе. Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на ID модели, который доступен в вашем проекте.248Фоновые задачи, такие как генерация названия сеанса, используют малую/быструю модель, обычно модель класса Haiku. На Google Cloud's Agent Platform Claude Code использует модель Sonnet по умолчанию для фоновых задач, потому что Haiku может быть не включен в каждом проекте или регионе. Два выбора изменяют, какая модель их выполняет:

249 

250* Когда вы выбираете основную модель с помощью `--model`, `ANTHROPIC_MODEL` или параметра `model`, фоновые задачи используют эту модель. Установка `ANTHROPIC_DEFAULT_OPUS_MODEL` без `ANTHROPIC_DEFAULT_SONNET_MODEL` также считается выбором, потому что встроенная модель Sonnet может быть не включена в проекте, который управляет своим собственным Opus.

251* Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на ID модели, который доступен в вашем проекте.

252 

253<Warning>

254 Модели Opus имеют более высокую цену за токен, чем модели Sonnet, поэтому развертывание, которое не закрепляет основную модель, будет тарифицироваться по тарифу Opus после обновления до версии 2.1.207 или позже. Чтобы сохранить Sonnet 4.5 в качестве основной модели, установите `ANTHROPIC_MODEL` на его полный ID модели. Развертывание, которое управляет значением по умолчанию с помощью `ANTHROPIC_DEFAULT_SONNET_MODEL` и не устанавливает `ANTHROPIC_DEFAULT_OPUS_MODEL`, сохраняет свою управляемую модель Sonnet в качестве значения по умолчанию.

255</Warning>

256 

257{/* min-version: 2.1.207 */}До версии 2.1.207 основная модель на Google Cloud's Agent Platform по умолчанию была Sonnet 4.5, псевдоним `opus` разрешался в Opus 4.6, а фоновые задачи всегда использовали основную модель.

249 258 

250Для дальнейшей настройки моделей:259Для дальнейшей настройки моделей:

251 260 


262 271 

263Если вы закрепили версию модели, которая старше текущего значения по умолчанию Claude Code, и ваш проект может вызывать более новую версию, Claude Code предлагает вам обновить закрепление. Принятие записывает новый ID модели в ваш [файл пользовательских настроек](/ru/settings) и перезапускает Claude Code. Отклонение запоминается до следующего изменения версии по умолчанию.272Если вы закрепили версию модели, которая старше текущего значения по умолчанию Claude Code, и ваш проект может вызывать более новую версию, Claude Code предлагает вам обновить закрепление. Принятие записывает новый ID модели в ваш [файл пользовательских настроек](/ru/settings) и перезапускает Claude Code. Отклонение запоминается до следующего изменения версии по умолчанию.

264 273 

265Если вы не закрепили модель и текущее значение по умолчанию недоступно в вашем проекте, Claude Code откатывается на предыдущую версию для текущего сеанса и показывает уведомление. Откат не сохраняется. Включите более новую модель в [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) или [закрепите версию](#5-pin-model-versions), чтобы сделать выбор постоянным.274Если вы не закрепили модель и текущее значение по умолчанию недоступно в вашем проекте, Claude Code откатывается на предыдущую версию для текущего сеанса и показывает уведомление. Сначала он пытается использовать более ранние версии модели по умолчанию и, когда модель по умолчанию является моделью Opus и ни одна версия Opus недоступна, откатывается на модель Sonnet по умолчанию. Откат не сохраняется. Включите более новую модель в [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) или [закрепите версию](#5-pin-model-versions), чтобы сделать выбор постоянным.

266 275 

267<h2 id="iam-configuration">276<h2 id="iam-configuration">

268 Конфигурация IAM277 Конфигурация IAM


286 Контекстное окно с 1M токенов295 Контекстное окно с 1M токенов

287</h2>296</h2>

288 297 

289Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [контекстное окно с 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window) на платформе Agent Platform Google Cloud. Sonnet 5 всегда работает с окном 1M, без варианта `[1m]` для выбора. Для других моделей Claude Code автоматически включает расширенное контекстное окно при выборе варианта модели с 1M.298Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [контекстное окно с 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) на платформе Agent Platform Google Cloud. Sonnet 5 всегда работает с окном 1M, без варианта `[1m]` для выбора. Для других моделей Claude Code автоматически включает расширенное контекстное окно при выборе варианта модели с 1M.

290 299 

291[Мастер установки](#sign-in-with-agent-platform) предлагает опцию контекстного окна с 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели, добавьте `[1m]` к ID модели. Подробности см. в разделе [Закрепите модели для развертываний третьих сторон](/ru/model-config#pin-models-for-third-party-deployments).300[Мастер установки](#sign-in-with-agent-platform) предлагает опцию контекстного окна с 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели, добавьте `[1m]` к ID модели. Подробности см. в разделе [Закрепите модели для развертываний третьих сторон](/ru/model-config#pin-models-for-third-party-deployments).

292 301 

headless.md +9 −2

Details

163claude -p "Explain recursion" --output-format stream-json --verbose --include-partial-messages163claude -p "Explain recursion" --output-format stream-json --verbose --include-partial-messages

164```164```

165 165 

166Последняя строка потока — это сообщение `result` с финальным текстом ответа, стоимостью и метаданными сессии. {/* min-version: 2.1.208 */}До версии v2.1.208 передача большого ответа могла обрезать финальную строку и опустить сообщение `result`.

167 

166Следующий пример использует [jq](https://jqlang.github.io/jq/) для фильтрации текстовых дельт и отображения только потокового текста. Флаг `-r` выводит необработанные строки (без кавычек), а `-j` объединяет без новых строк, чтобы токены передавались непрерывно:168Следующий пример использует [jq](https://jqlang.github.io/jq/) для фильтрации текстовых дельт и отображения только потокового текста. Флаг `-r` выводит необработанные строки (без кавычек), а `-j` объединяет без новых строк, чтобы токены передавались непрерывно:

167 169 

168```bash theme={null}170```bash theme={null}


184| `uuid` | строка | уникальный идентификатор события |186| `uuid` | строка | уникальный идентификатор события |

185| `session_id` | строка | сессия, к которой принадлежит событие |187| `session_id` | строка | сессия, к которой принадлежит событие |

186 188 

187Событие `system/init` сообщает метаданные сессии, включая модель, инструменты, MCP серверы и загруженные плагины. Это первое событие в потоке, если не установлена [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ru/env-vars), в этом случае события `plugin_install` предшествуют ему.189Событие `system/init` сообщает метаданные сессии, включая модель, инструменты, MCP серверы и загруженные плагины. Это первое событие в потоке, если не установлены события запуска:

190 

191* события `plugin_install`, когда установлена [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ru/env-vars).

192* {/* min-version: 2.1.204 */}[события `hook_started`, `hook_progress` и `hook_response`](/ru/agent-sdk/typescript#sdkhookstartedmessage), пока работает настроенный hook [`SessionStart`](/ru/hooks#sessionstart) или [`Setup`](/ru/hooks#setup). Они передаются потоком по мере их создания. Claude Code v2.1.169 через v2.1.203 доставлял их одной партией после завершения hook, всё ещё впереди `system/init`; v2.1.204 восстановил живую доставку.

188 193 

189Событие также содержит опциональный массив `capabilities` строк, называющих поведения протокола, которые реализует эта версия Claude Code, такие как `interrupt_receipt_v1`. Проверьте его для обнаружения функций вместо сравнения строк версий и игнорируйте значения, которые вы не распознаёте. Поле требует Claude Code v2.1.205 или позже и отсутствует в более ранних версиях. См. [`SDKSystemMessage`](/ru/agent-sdk/typescript#sdksystemmessage) для списка возможностей.194Событие также содержит опциональный массив `capabilities` строк, называющих поведения протокола, которые реализует эта версия Claude Code, такие как `interrupt_receipt_v1`. Проверьте его для обнаружения функций вместо сравнения строк версий и игнорируйте значения, которые вы не распознаёте. Поле требует Claude Code v2.1.205 или позже и отсутствует в более ранних версиях. См. [`SDKSystemMessage`](/ru/agent-sdk/typescript#sdksystemmessage) для списка возможностей.

190 195 


220 --allowedTools "Bash,Read,Edit"225 --allowedTools "Bash,Read,Edit"

221```226```

222 227 

223Чтобы установить базовый уровень для всей сессии вместо перечисления отдельных инструментов, передайте [режим разрешений](/ru/permission-modes). `dontAsk` отклоняет всё, что не входит в ваши правила `permissions.allow` или [набор команд только для чтения](/ru/permissions#read-only-commands), что полезно для заблокированных CI запусков. `acceptEdits` позволяет Claude писать файлы без запроса и также автоматически одобряет общие команды файловой системы, такие как `mkdir`, `touch`, `mv` и `cp`. Другие команды оболочки и сетевые запросы по-прежнему требуют записи `--allowedTools` или правила `permissions.allow`, иначе запуск прерывается при попытке выполнить одну из них:228Чтобы установить базовый уровень для всей сессии вместо перечисления отдельных инструментов, передайте [режим разрешений](/ru/permission-modes). `dontAsk` отклоняет всё, что не входит в ваши правила `permissions.allow` или [набор команд только для чтения](/ru/permissions#read-only-commands), что полезно для заблокированных CI запусков. `AskUserQuestion`, инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и MCP инструменты, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), отклоняются даже когда правило разрешения совпадает.

229 

230`acceptEdits` позволяет Claude писать файлы без запроса и также автоматически одобряет общие команды файловой системы, такие как `mkdir`, `touch`, `mv` и `cp`. Другие команды оболочки и сетевые запросы по-прежнему требуют записи `--allowedTools` или правила `permissions.allow`, иначе запуск прерывается при попытке выполнить одну из них:

224 231 

225```bash theme={null}232```bash theme={null}

226claude -p "Apply the lint fixes" --permission-mode acceptEdits233claude -p "Apply the lint fixes" --permission-mode acceptEdits

hooks.md +25 −13

Details

404}404}

405```405```

406 406 

407Обе формы поддерживают одни и те же [path placeholders](#reference-scripts-by-path), и обе экспортируют их как переменные окружения `CLAUDE_PROJECT_DIR`, `CLAUDE_PLUGIN_ROOT` и `CLAUDE_PLUGIN_DATA` на порождённом процессе, поэтому скрипт может читать `process.env.CLAUDE_PLUGIN_ROOT` независимо от того, как он был запущен. Plugin hooks дополнительно подставляют значения `${user_config.*}`; см. [User configuration](/ru/plugins-reference#user-configuration).407Обе формы поддерживают одни и те же [path placeholders](#reference-scripts-by-path), и обе экспортируют их как переменные окружения `CLAUDE_PROJECT_DIR`, `CLAUDE_PLUGIN_ROOT` и `CLAUDE_PLUGIN_DATA` на порождённом процессе, поэтому скрипт может читать `process.env.CLAUDE_PLUGIN_ROOT` независимо от того, как он был запущен.

408 

409Plugin hooks дополнительно подставляют значения [`${user_config.*}`](/ru/plugins-reference#user-configuration), только в exec form: значение подставляется в `command` и в каждый элемент `args` как простая строка, поэтому оболочка не переанализирует его.

410 

411Shell-form plugin hook, чей `command` ссылается на `${user_config.*}`, завершается с [ошибкой](/ru/errors#plugin-command-references-user-config) вместо запуска. Чтобы использовать значение опции из shell-form hook, прочитайте переменную окружения `$CLAUDE_PLUGIN_OPTION_<KEY>`, такую как `$CLAUDE_PLUGIN_OPTION_WEBHOOK_URL` для опции `webhook_url`, или установите `args` для переключения hook на exec form. До v2.1.207, shell-form plugin hook команды также подставляли `${user_config.*}`.

408 412 

409<Note>413<Note>

410 В exec form, `command` — это только имя исполняемого файла или путь. Если `command` — это голое имя без разделителя пути и содержит пробелы рядом с `args`, Claude Code логирует предупреждение, потому что spawn не удастся: нет исполняемого файла с именем `node script.js`. Переместите дополнительные токены в `args`. Абсолютные пути с пробелами, такие как `C:\Program Files\nodejs\node.exe`, — это один действительный исполняемый файл и не вызывают предупреждение.414 В exec form, `command` — это только имя исполняемого файла или путь. Если `command` — это голое имя без разделителя пути и содержит пробелы рядом с `args`, Claude Code логирует предупреждение, потому что spawn не удастся: нет исполняемого файла с именем `node script.js`. Переместите дополнительные токены в `args`. Абсолютные пути с пробелами, такие как `C:\Program Files\nodejs\node.exe`, — это один действительный исполняемый файл и не вызывают предупреждение.


653| `agent_id` | Уникальный идентификатор для subagent. Присутствует только когда hook срабатывает внутри вызова subagent. Используйте это для различения вызовов hook subagent от вызовов основного потока. |657| `agent_id` | Уникальный идентификатор для subagent. Присутствует только когда hook срабатывает внутри вызова subagent. Используйте это для различения вызовов hook subagent от вызовов основного потока. |

654| `agent_type` | Имя агента (например, `"Explore"` или `"security-reviewer"`). Присутствует когда сеанс использует `--agent` или hook срабатывает внутри subagent. Для subagents тип subagent имеет приоритет над значением `--agent` сеанса. Для [пользовательских subagents](/ru/sub-agents) это поле `name` из frontmatter агента, а не имя файла. Для subagents, поставляемых [plugin](/ru/plugins), это идентификатор с областью видимости плагина, такой как `my-plugin:reviewer`, а не простое имя frontmatter. См. [SubagentStart](#subagentstart) для того, как написать matcher для имени с областью видимости плагина. |658| `agent_type` | Имя агента (например, `"Explore"` или `"security-reviewer"`). Присутствует когда сеанс использует `--agent` или hook срабатывает внутри subagent. Для subagents тип subagent имеет приоритет над значением `--agent` сеанса. Для [пользовательских subagents](/ru/sub-agents) это поле `name` из frontmatter агента, а не имя файла. Для subagents, поставляемых [plugin](/ru/plugins), это идентификатор с областью видимости плагина, такой как `my-plugin:reviewer`, а не простое имя frontmatter. См. [SubagentStart](#subagentstart) для того, как написать matcher для имени с областью видимости плагина. |

655 659 

656Только hooks [`SessionStart`](#sessionstart) могут получать поле `model`, и его присутствие не гарантировано. Нет переменной окружения `$CLAUDE_MODEL`. Процесс hook наследует родительское окружение, поэтому он может читать `$ANTHROPIC_MODEL`, если вы установили её в вашей оболочке, но это значение не меняется при переключении моделей с `/model` во время сеанса.660Только hooks [`SessionStart`](#sessionstart) могут получать поле `model`, и его присутствие не гарантировано. Нет переменной окружения `$CLAUDE_MODEL`. Процесс hook наследует родительское окружение, поэтому он может читать `$ANTHROPIC_MODEL`, если вы установили её в вашей оболочке, но это значение не меняется при переключении моделей с `/model` во время сеанса. Один набор переменных не наследуется: Claude Code [удаляет переменные экспортера `OTEL_*` из каждого подпроцесса, который он порождает](/ru/monitoring-usage#administrator-configuration), включая hooks.

657 661 

658Например, hook `PreToolUse` для команды Bash получает это на stdin:662Например, hook `PreToolUse` для команды Bash получает это на stdin:

659 663 


1182 1186 

1183Hook `UserPromptSubmit`, который достигает своего таймаута, отменяется и его выход, включая любой `additionalContext`, отбрасывается. Подсказка всё ещё достигает Claude без этого контекста. Начиная с v2.1.196, транскрипт показывает уведомление, называющее hook, таймаут, который сработал, и что выход был отброшен. Более ранние версии отменяют hook без уведомления.1187Hook `UserPromptSubmit`, который достигает своего таймаута, отменяется и его выход, включая любой `additionalContext`, отбрасывается. Подсказка всё ещё достигает Claude без этого контекста. Начиная с v2.1.196, транскрипт показывает уведомление, называющее hook, таймаут, который сработал, и что выход был отброшен. Более ранние версии отменяют hook без уведомления.

1184 1188 

1189Hook [Agent SDK callback](/ru/agent-sdk/hooks) на `UserPromptSubmit`, который достигает своего таймаута, блокирует подсказку с сообщением, называющим hook и таймаут, потому что callback там может действовать как политический шлюз, который не должен отказать открыто. Сеанс продолжается. До v2.1.208 таймаут callback на этом событии заканчивал ход с ошибкой выполнения.

1190 

1185<h4 id="userpromptsubmit-input">1191<h4 id="userpromptsubmit-input">

1186 UserPromptSubmit input1192 UserPromptSubmit input

1187</h4>1193</h4>


1453Выполняет команды оболочки.1459Выполняет команды оболочки.

1454 1460 

1455| Поле | Тип | Пример | Описание |1461| Поле | Тип | Пример | Описание |

1456| :------------------ | :------ | :----------------- | :--------------------------------------------- |1462| :------------------ | :------ | :----------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- |

1457| `command` | string | `"npm test"` | Команда оболочки для выполнения |1463| `command` | string | `"npm test"` | Команда оболочки для выполнения |

1458| `description` | string | `"Run test suite"` | Опциональное описание того, что делает команда |1464| `description` | string | `"Run test suite"` | Опциональное описание того, что делает команда |

1459| `timeout` | number | `120000` | Опциональный таймаут в миллисекундах |1465| `timeout` | number | `120000` | Опциональный таймаут в миллисекундах. Значения выше [максимума](/ru/tools-reference#bash-tool-behavior) уменьшаются до максимума, а не отклоняются |

1460| `run_in_background` | boolean | `false` | Запускать ли команду в фоне |1466| `run_in_background` | boolean | `false` | Запускать ли команду в фоне |

1461 1467 

1462<h5 id="write">1468<h5 id="write">


1591 ExitPlanMode1597 ExitPlanMode

1592</h5>1598</h5>

1593 1599 

1594Представляет план и просит пользователя одобрить его перед тем, как Claude покинет [plan mode](/ru/permission-modes#analyze-before-you-edit-with-plan-mode). Claude записывает план в файл на диск перед вызовом инструмента, поэтому буквальный `tool_input` от модели содержит только `allowedPrompts`. Claude Code внедряет содержимое плана и путь файла перед передачей входных данных в hooks.1600Представляет план и просит пользователя одобрить его перед тем, как Claude покинет [plan mode](/ru/permission-modes#analyze-before-you-edit-with-plan-mode). Claude записывает план в файл на диск перед вызовом инструмента, поэтому буквальный `tool_input` от модели обычно пуст. Claude Code внедряет содержимое плана и путь файла перед передачей входных данных в hooks.

1595 1601 

1596| Поле | Тип | Пример | Описание |1602| Поле | Тип | Пример | Описание |

1597| :--------------- | :----- | :------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1603| :--------------- | :----- | :------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |


1608Hooks `PreToolUse` могут управлять тем, продолжается ли вызов инструмента. В отличие от других hooks, которые используют верхнеуровневое поле `decision`, PreToolUse возвращает своё решение внутри объекта `hookSpecificOutput`. Это даёт ему более богатое управление: четыре результата (разрешить, отклонить, спросить или отложить) плюс возможность изменить входные данные инструмента перед выполнением.1614Hooks `PreToolUse` могут управлять тем, продолжается ли вызов инструмента. В отличие от других hooks, которые используют верхнеуровневое поле `decision`, PreToolUse возвращает своё решение внутри объекта `hookSpecificOutput`. Это даёт ему более богатое управление: четыре результата (разрешить, отклонить, спросить или отложить) плюс возможность изменить входные данные инструмента перед выполнением.

1609 1615 

1610| Поле | Описание |1616| Поле | Описание |

1611| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1617| :------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1612| `permissionDecision` | `"allow"` пропускает диалог разрешения, кроме [инструментов, требующих взаимодействия пользователя](#pretooluse-decision-control). `"deny"` предотвращает вызов инструмента. `"ask"` предлагает пользователю подтвердить. `"defer"` выходит корректно, чтобы инструмент мог быть возобновлён позже. [Правила отклонения и запроса](/ru/permissions#manage-permissions) всё ещё применяются независимо от того, что возвращает hook |1618| `permissionDecision` | `"allow"` пропускает диалог разрешения, кроме [инструментов, требующих взаимодействия пользователя](#pretooluse-decision-control) и инструментов соединителя [ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools). `"deny"` предотвращает вызов инструмента. `"ask"` предлагает пользователю подтвердить. `"defer"` выходит корректно, чтобы инструмент мог быть возобновлён позже. [Правила отклонения и запроса](/ru/permissions#manage-permissions) всё ещё применяются независимо от того, что возвращает hook |

1613| `permissionDecisionReason` | Для `"allow"` и `"ask"`, показывается пользователю, но не Claude. Для `"deny"`, показывается Claude. Для `"defer"`, игнорируется |1619| `permissionDecisionReason` | Для `"allow"` и `"ask"`, показывается пользователю, но не Claude. Для `"deny"`, показывается Claude. Для `"defer"`, игнорируется |

1614| `updatedInput` | Изменяет параметры входа инструмента перед выполнением. Заменяет весь объект входа, поэтому включите неизменённые поля наряду с изменёнными. Объедините с `"allow"` для автоматического одобрения или `"ask"` для показа изменённого входа пользователю. Для `"defer"`, игнорируется |1620| `updatedInput` | Изменяет параметры входа инструмента перед выполнением. Заменяет весь объект входа, поэтому включите неизменённые поля наряду с изменёнными. Объедините с `"allow"` для автоматического одобрения или `"ask"` для показа изменённого входа пользователю. Для `"defer"`, игнорируется |

1615| `additionalContext` | Строка, добавленная в контекст Claude наряду с результатом инструмента. Игнорируется при `permissionDecision` равном `"defer"`. См. [Add context for Claude](#add-context-for-claude) |1621| `additionalContext` | Строка, добавленная в контекст Claude наряду с результатом инструмента. Игнорируется при `permissionDecision` равном `"defer"`. См. [Add context for Claude](#add-context-for-claude) |


1634 1640 

1635`AskUserQuestion` и `ExitPlanMode` требуют взаимодействия пользователя и обычно блокируют в [неинтерактивном режиме](/ru/headless) с флагом `-p`. Возврат `permissionDecision: "allow"` вместе с `updatedInput` удовлетворяет этому требованию: hook читает входные данные инструмента из stdin, собирает ответ через ваш собственный UI и возвращает его в `updatedInput`, чтобы инструмент запустился без запроса. Возврат только `"allow"` недостаточен для этих инструментов. Для `AskUserQuestion` повторите исходный массив `questions` и добавьте объект [`answers`](#askuserquestion), соответствующий тексту каждого вопроса выбранному ответу.1641`AskUserQuestion` и `ExitPlanMode` требуют взаимодействия пользователя и обычно блокируют в [неинтерактивном режиме](/ru/headless) с флагом `-p`. Возврат `permissionDecision: "allow"` вместе с `updatedInput` удовлетворяет этому требованию: hook читает входные данные инструмента из stdin, собирает ответ через ваш собственный UI и возвращает его в `updatedInput`, чтобы инструмент запустился без запроса. Возврат только `"allow"` недостаточен для этих инструментов. Для `AskUserQuestion` повторите исходный массив `questions` и добавьте объект [`answers`](#askuserquestion), соответствующий тексту каждого вопроса выбранному ответу.

1636 1642 

1643Инструменты соединителя [ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) запрашивают даже когда hook возвращает `"allow"`.

1644 

1637Начиная с v2.1.199, инструмент MCP, чей сервер помечает его с помощью [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), более строг: hook не может пропустить его диалог одобрения с помощью `"allow"`, с `updatedInput` или без, потому что Claude Code не может подтвердить, что hook собрал взаимодействие, которое нужно инструменту.1645Начиная с v2.1.199, инструмент MCP, чей сервер помечает его с помощью [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), более строг: hook не может пропустить его диалог одобрения с помощью `"allow"`, с `updatedInput` или без, потому что Claude Code не может подтвердить, что hook собрал взаимодействие, которое нужно инструменту.

1638 1646 

1639<Note>1647<Note>


1856 PostToolUseFailure1864 PostToolUseFailure

1857</h3>1865</h3>

1858 1866 

1859Запускается при сбое выполнения инструмента. Это событие срабатывает для вызовов инструментов, которые выбрасывают ошибки или возвращают результаты сбоя. Используйте это для логирования сбоев, отправки оповещений или предоставления исправляющей обратной связи Claude.1867Запускается при сбое выполнения инструмента: инструмент выбросил ошибку или инструмент MCP вернул результат ошибки. Используйте это для логирования сбоев, отправки оповещений или предоставления исправляющей обратной связи Claude.

1860 1868 

1861Совпадает с именем инструмента, те же значения, что и PreToolUse.1869Совпадает с именем инструмента, те же значения, что и PreToolUse.

1862 1870 

1871<Note>

1872 Это событие не срабатывает для вызовов инструментов, отклонённых перед выполнением: неизвестное имя инструмента, входные данные, которые не проходят проверку схемы или инструмента, или отклонение разрешения. Отклонения проверки возвращаются как результаты `tool_use_error` и происходят перед запуском hooks, поэтому они не срабатывают ни `PreToolUse` ни этим событием. Отклонения разрешения срабатывают `PreToolUse`, но не этим событием; см. [PermissionDenied](#permissiondenied).

1873</Note>

1874 

1863<h4 id="posttoolusefailure-input">1875<h4 id="posttoolusefailure-input">

1864 PostToolUseFailure input1876 PostToolUseFailure input

1865</h4>1877</h4>


2305 2317 

2306В дополнение к [общим полям входа](#common-input-fields), Stop hooks получают `stop_hook_active`, `last_assistant_message`, `background_tasks` и `session_crons`. Поле `stop_hook_active` равно `true`, когда Claude Code уже продолжает в результате stop hook. Проверьте это значение или обработайте транскрипт, чтобы предотвратить блокировку на условии, которое никогда не разрешится. Claude Code переопределяет hook и заканчивает ход после 8 последовательных блокировок.2318В дополнение к [общим полям входа](#common-input-fields), Stop hooks получают `stop_hook_active`, `last_assistant_message`, `background_tasks` и `session_crons`. Поле `stop_hook_active` равно `true`, когда Claude Code уже продолжает в результате stop hook. Проверьте это значение или обработайте транскрипт, чтобы предотвратить блокировку на условии, которое никогда не разрешится. Claude Code переопределяет hook и заканчивает ход после 8 последовательных блокировок.

2307 2319 

2308Поле `last_assistant_message` содержит текстовое содержимое финального ответа Claude, поэтому hooks могут получить к нему доступ без анализа файла транскрипта.2320Поле `last_assistant_message` содержит текстовое содержимое финального ответа Claude, поэтому hooks могут получить к нему доступ без анализа файла транскрипта. Для hooks, которые действуют на только что завершённый ход, такие как hooks для чтения вслух или уведомления, используйте это поле, а не читайте `transcript_path`: файл транскрипта не гарантирует включение финального сообщения в момент Stop на всех версиях.

2309 2321 

2310Массивы `background_tasks` и `session_crons`, доступные в Claude Code v2.1.145 или позже, позволяют hooks различать "сеанс завершён" от "сеанс приостановлен в ожидании фоновой работы для его пробуждения". Оба массива присутствуют, когда реестр задач доступен, и пусты, когда ничего не выполняется или не запланировано.2322Массивы `background_tasks` и `session_crons`, доступные в Claude Code v2.1.145 или позже, позволяют hooks различать "сеанс завершён" от "сеанс приостановлен в ожидании фоновой работы для его пробуждения". Оба массива присутствуют, когда реестр задач доступен, и пусты, когда ничего не выполняется или не запланировано.

2311 2323 


2647 2659 

2648Потому что hook заменяет поведение по умолчанию полностью, [`.worktreeinclude`](/ru/worktrees#copy-gitignored-files-into-worktrees) не обрабатывается. Если вам нужно скопировать локальные файлы конфигурации, такие как `.env`, в новый worktree, сделайте это внутри вашего скрипта hook.2660Потому что hook заменяет поведение по умолчанию полностью, [`.worktreeinclude`](/ru/worktrees#copy-gitignored-files-into-worktrees) не обрабатывается. Если вам нужно скопировать локальные файлы конфигурации, такие как `.env`, в новый worktree, сделайте это внутри вашего скрипта hook.

2649 2661 

2650Hook должен вернуть абсолютный путь к созданному каталогу worktree. Claude Code использует этот путь как рабочий каталог для изолированного сеанса. Command hooks выводят его на stdout; HTTP hooks возвращают его через `hookSpecificOutput.worktreePath`.2662Hook должен вернуть путь к созданному worktree каталогу. Claude Code использует этот путь как рабочий каталог для изолированного сеанса. См. [WorktreeCreate output](#worktreecreate-output) для того, как каждый тип hook возвращает путь.

2651 2663 

2652Этот пример создаёт рабочую копию SVN и выводит путь для использования Claude Code. Замените URL репозитория на свой:2664Этот пример создаёт рабочую копию SVN и выводит путь для использования Claude Code. Замените URL репозитория на свой:

2653 2665 


2690 WorktreeCreate output2702 WorktreeCreate output

2691</h4>2703</h4>

2692 2704 

2693WorktreeCreate hooks не используют стандартную модель решения разрешить/заблокировать. Вместо этого успех или сбой hook определяет результат. Hook должен вернуть абсолютный путь к созданному каталогу worktree:2705WorktreeCreate hooks не используют стандартную модель решения разрешить/заблокировать. Вместо этого успех или сбой hook определяет результат. Hook должен вернуть путь к созданному worktree каталогу:

2694 2706 

2695* **Command hooks** (`type: "command"`): выводят путь на stdout.2707* **Command hooks** (`type: "command"`): выводят путь как последнюю непустую строку stdout. Claude Code удаляет коды ANSI перед чтением этой строки, поэтому баннеры запуска оболочки, выведенные перед вашим `echo`, игнорируются. Перенаправьте любой другой выход hook на stderr.

2696* **HTTP hooks** (`type: "http"`): возвращают `{ "hookSpecificOutput": { "hookEventName": "WorktreeCreate", "worktreePath": "/absolute/path" } }` в теле ответа.2708* **HTTP hooks** (`type: "http"`): возвращают `{ "hookSpecificOutput": { "hookEventName": "WorktreeCreate", "worktreePath": "/absolute/path" } }` в теле ответа.

2697 2709 

2698Если hook не удаётся или не производит путь, создание worktree не удаётся с ошибкой.2710Если hook не удаётся или не производит путь, создание worktree не удаётся с ошибкой.


2742}2754}

2743```2755```

2744 2756 

2745WorktreeRemove hooks не имеют управления решением. Они не могут блокировать удаление worktree, но могут выполнять задачи очистки, такие как удаление состояния контроля версий или архивирование изменений. Сбои hook логируются только в режиме отладки.2757WorktreeRemove hooks не имеют управления решением. Они не могут блокировать удаление worktree, но мог выполнять задачи очистки, такие как удаление состояния контроля версий или архивирование изменений. Сбои hook логируются только в режиме отладки.

2746 2758 

2747<h3 id="precompact">2759<h3 id="precompact">

2748 PreCompact2760 PreCompact

hooks-guide.md +16 −5

Details

607 607 

608С `"deny"` Claude Code отменяет вызов инструмента и передаёт `permissionDecisionReason` обратно Claude. Эти значения `permissionDecision` специфичны для `PreToolUse`:608С `"deny"` Claude Code отменяет вызов инструмента и передаёт `permissionDecisionReason` обратно Claude. Эти значения `permissionDecision` специфичны для `PreToolUse`:

609 609 

610* `"allow"`: пропустить интерактивный запрос разрешения. Правила отказа и запроса, включая управляемые списки отказов предприятия, по-прежнему применяются610* `"allow"`: пропустить интерактивный запрос разрешения. Правила отказа и запроса, включая управляемые списки отказов предприятия, по-прежнему применяются, как и запросы для инструментов соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и MCP инструменты, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool)

611* `"deny"`: отменить вызов инструмента и отправить причину Claude611* `"deny"`: отменить вызов инструмента и отправить причину Claude

612* `"ask"`: показать запрос разрешения пользователю как обычно612* `"ask"`: показать запрос разрешения пользователю как обычно

613 613 

614Четвёртое значение, `"defer"`, доступно в [non-interactive mode](/ru/headless) с флагом `-p`. Оно выходит из процесса с сохранённым вызовом инструмента, чтобы обёртка Agent SDK могла собрать ввод и возобновить. См. [Defer a tool call for later](/ru/hooks#defer-a-tool-call-for-later) в справочнике.614Четвёртое значение, `"defer"`, доступно в [non-interactive mode](/ru/headless) с флагом `-p`. Оно выходит из процесса с сохранённым вызовом инструмента, чтобы обёртка Agent SDK могла собрать ввод и возобновить. См. [Defer a tool call for later](/ru/hooks#defer-a-tool-call-for-later) в справочнике.

615 615 

616Возврат `"allow"` пропускает интерактивный запрос, но не переопределяет [permission rules](/ru/permissions#manage-permissions). Если правило отказа соответствует вызову инструмента, вызов блокируется даже когда ваш hook возвращает `"allow"`. Если правило запроса соответствует, пользователь по-прежнему получает запрос. Это означает, что правила отказа из любой области параметров, включая [managed settings](/ru/settings#settings-files), всегда имеют приоритет над одобрениями hook.616Возврат `"allow"` пропускает интерактивный запрос, но не переопределяет [permission rules](/ru/permissions#manage-permissions). Если правило отказа соответствует вызову инструмента, вызов блокируется даже когда ваш hook возвращает `"allow"`. Если правило запроса соответствует, пользователь по-прежнему получает запрос, как и инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и MCP инструменты, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool). Это означает, что правила отказа из любой области параметров, включая [managed settings](/ru/settings#settings-files), всегда имеют приоритет над одобрениями hook.

617 617 

618Другие события используют разные шаблоны решений. Например, hooks `PostToolUse` и `Stop` используют поле `decision: "block"` верхнего уровня, а `PermissionRequest` использует `hookSpecificOutput.decision.behavior`. См. [summary table](/ru/hooks#decision-control) в справочнике для полного разбора по событиям.618Другие события используют разные шаблоны решений. Например, hooks `PostToolUse` и `Stop` используют поле `decision: "block"` верхнего уровня, а `PermissionRequest` использует `hookSpecificOutput.decision.behavior`. См. [summary table](/ru/hooks#decision-control) в справочнике для полного разбора по событиям.

619 619 

620Для hooks `UserPromptSubmit` используйте `additionalContext` вместо этого для внедрения текста в контекст Claude.620Для hooks `UserPromptSubmit` используйте `hookSpecificOutput.additionalContext` вместо этого для внедрения текста в контекст Claude. Вложите `additionalContext` внутри `hookSpecificOutput`; если вы поместите его на верхний уровень JSON, Claude Code молча его игнорирует. Например, этот вывод добавляет текущее состояние ветви к каждому запросу:

621 

622```json theme={null}

623{

624 "hookSpecificOutput": {

625 "hookEventName": "UserPromptSubmit",

626 "additionalContext": "Current branch: release-42. Deploy freeze until Friday."

627 }

628}

629```

630 

631См. [UserPromptSubmit decision control](/ru/hooks#userpromptsubmit-decision-control) для полной формы вывода, включая блокировку запросов и установку заголовка сеанса.

621 632 

622Hooks с `type: "prompt"` обрабатывают вывод иначе: см. [Prompt-based hooks](#prompt-based-hooks).633Hooks с `type: "prompt"` обрабатывают вывод иначе: см. [Prompt-based hooks](#prompt-based-hooks).

623 634 


642}653}

643```654```

644 655 

645Matcher `"Edit|Write"` срабатывает только, когда Claude использует инструмент `Edit` или `Write`, а не когда он использует `Bash`, `Read` или любой другой инструмент. См. [Matcher patterns](/ru/hooks#matcher-patterns) для того, как простые имена и регулярные выражения оцениваются.656Matcher `"Edit|Write"` срабатывает только, когда Claude использует инструмент `Edit` или `Write`, а не когда он использует `Bash`, `Read` или любой другой инструмент. {/* min-version: 2.1.191 */}На Claude Code v2.1.191 или позже запятая разделяет альтернативы так же, поэтому `"Edit, Write"` эквивалентна. См. [Matcher patterns](/ru/hooks#matcher-patterns) для того, как простые имена и регулярные выражения оцениваются.

646 657 

647<Note>658<Note>

648 Claude может также создавать или изменять файлы, запуская команды оболочки через инструмент `Bash`. Если ваш hook должен видеть каждое изменение файла, например для сканирования соответствия или логирования аудита, добавьте hook [`Stop`](/ru/hooks#stop), который сканирует рабочее дерево один раз за ход. Для покрытия за вызов вместо этого также соответствуйте `Bash` и пусть ваш скрипт перечисляет изменённые и неотслеживаемые файлы с помощью `git status --porcelain`.659 Claude может также создавать или изменять файлы, запуская команды оболочки через инструмент `Bash`. Если ваш hook должен видеть каждое изменение файла, например для сканирования соответствия или логирования аудита, добавьте hook [`Stop`](/ru/hooks#stop), который сканирует рабочее дерево один раз за ход. Для покрытия за вызов вместо этого также соответствуйте `Bash` и пусть ваш скрипт перечисляет изменённые и неотслеживаемые файлы с помощью `git status --porcelain`.


941 952 

942Hooks `PreToolUse` срабатывают перед любой проверкой режима разрешений. Hook, возвращающий `permissionDecision: "deny"`, блокирует инструмент даже в режиме `bypassPermissions` или с `--dangerously-skip-permissions`. Это позволяет вам применять политику, которую пользователи не могут обойти, изменив свой режим разрешений.953Hooks `PreToolUse` срабатывают перед любой проверкой режима разрешений. Hook, возвращающий `permissionDecision: "deny"`, блокирует инструмент даже в режиме `bypassPermissions` или с `--dangerously-skip-permissions`. Это позволяет вам применять политику, которую пользователи не могут обойти, изменив свой режим разрешений.

943 954 

944Обратное неверно: hook, возвращающий `"allow"`, не обходит правила отказа из параметров. Hooks могут ужесточить ограничения, но не ослабить их сверх того, что разрешают правила разрешений.955Обратное неверно: hook, возвращающий `"allow"`, не обходит правила отказа из параметров, и он не может подавить запрос для инструментов соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) или инструментов MCP, отмеченных [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool). Hooks могут ужесточить ограничения, но не ослабить их сверх того, что разрешают правила разрешений.

945 956 

946<h3 id="hook-not-firing">957<h3 id="hook-not-firing">

947 Hook не срабатывает958 Hook не срабатывает

Details

33| `Ctrl+D` | Выход из сеанса Claude Code | Сигнал EOF |33| `Ctrl+D` | Выход из сеанса Claude Code | Сигнал EOF |

34| `Ctrl+G` или `Ctrl+X Ctrl+E` | Открыть в текстовом редакторе по умолчанию | Отредактируйте ваш запрос или пользовательский ответ в текстовом редакторе по умолчанию. `Ctrl+X Ctrl+E` — это встроенная привязка readline. Включите Show last response in external editor в `/config` для добавления предыдущего ответа Claude в виде контекста с комментариями `#` выше вашего запроса; блок комментариев удаляется при сохранении |34| `Ctrl+G` или `Ctrl+X Ctrl+E` | Открыть в текстовом редакторе по умолчанию | Отредактируйте ваш запрос или пользовательский ответ в текстовом редакторе по умолчанию. `Ctrl+X Ctrl+E` — это встроенная привязка readline. Включите Show last response in external editor в `/config` для добавления предыдущего ответа Claude в виде контекста с комментариями `#` выше вашего запроса; блок комментариев удаляется при сохранении |

35| `Ctrl+L` | Перерисовать экран | Принудительно выполняет полную перерисовку терминала. Ввод и история разговора сохраняются. Используйте это для восстановления, если дисплей становится искаженным или частично пустым |35| `Ctrl+L` | Перерисовать экран | Принудительно выполняет полную перерисовку терминала. Ввод и история разговора сохраняются. Используйте это для восстановления, если дисплей становится искаженным или частично пустым |

36| `Ctrl+O` | Переключить просмотр транскрипции | Показывает детальное использование инструментов и выполнение. Также расширяет вызовы MCP, которые по умолчанию сворачиваются в одну строку, например "Called slack 3 times" |36| `Ctrl+O` | Переключить просмотр транскрипции | Показывает детальное использование инструментов и выполнение, с временной меткой и используемой моделью на каждом сообщении ассистента. Также расширяет вызовы MCP, которые по умолчанию сворачиваются в одну строку, например "Called slack 3 times" |

37| `Ctrl+R` | Поиск в истории команд в обратном порядке | Интерактивный поиск по предыдущим командам |37| `Ctrl+R` | Поиск в истории команд в обратном порядке | Интерактивный поиск по предыдущим командам |

38| `Ctrl+V` или `Cmd+V` (iTerm2) или `Alt+V` (Windows и WSL) | Вставить изображение из буфера обмена | Вставляет чип `[Image #N]` в позицию курсора, чтобы вы могли ссылаться на него позиционно в вашем запросе. На WSL оба `Ctrl+V` и `Alt+V` привязаны; используйте `Alt+V`, если ваш терминал перехватывает `Ctrl+V` |38| `Ctrl+V` или `Cmd+V` (iTerm2) или `Alt+V` (Windows и WSL) | Вставить изображение из буфера обмена | Вставляет чип `[Image #N]` в позицию курсора, чтобы вы могли ссылаться на него позиционно в вашем запросе. На WSL оба `Ctrl+V` и `Alt+V` привязаны; используйте `Alt+V`, если ваш терминал перехватывает `Ctrl+V` |

39| `Ctrl+B` | Фоновое выполнение задач | Переводит bash команды и агентов в фоновый режим. Пользователи Tmux нажимают дважды |39| `Ctrl+B` | Фоновое выполнение задач | Переводит bash команды и агентов в фоновый режим. Пользователи Tmux нажимают дважды |


126 126 

127Введите `/` в Claude Code, чтобы увидеть все доступные команды, или введите `/` с последующими буквами для фильтрации. Меню `/` показывает все, что вы можете вызвать: встроенные команды, встроенные и созданные пользователем [skills](/ru/skills), и команды, предоставленные [plugins](/ru/plugins) и [MCP servers](/ru/mcp#use-mcp-prompts-as-commands). Не все встроенные команды видны каждому пользователю, так как некоторые зависят от вашей платформы или плана.127Введите `/` в Claude Code, чтобы увидеть все доступные команды, или введите `/` с последующими буквами для фильтрации. Меню `/` показывает все, что вы можете вызвать: встроенные команды, встроенные и созданные пользователем [skills](/ru/skills), и команды, предоставленные [plugins](/ru/plugins) и [MCP servers](/ru/mcp#use-mcp-prompts-as-commands). Не все встроенные команды видны каждому пользователю, так как некоторые зависят от вашей платформы или плана.

128 128 

129В [полноэкранном режиме отображения](/ru/fullscreen#use-the-mouse) меню команд `/` и список предложений файлов `@` также реагируют на мышь: наведение выделяет строку, а щелчок принимает её.

130 

129Полный список команд, включенных в Claude Code, см. в [справочнике команд](/ru/commands).131Полный список команд, включенных в Claude Code, см. в [справочнике команд](/ru/commands).

130 132 

131<h2 id="vim-editor-mode">133<h2 id="vim-editor-mode">


150| `v` | Начать посимвольное визуальное выделение | NORMAL |152| `v` | Начать посимвольное визуальное выделение | NORMAL |

151| `V` | Начать построчное визуальное выделение | NORMAL |153| `V` | Начать построчное визуальное выделение | NORMAL |

152 154 

155<h3 id="remap-insert-mode-key-sequences">

156 Переназначение последовательностей клавиш в режиме INSERT

157</h3>

158 

159Параметр [`vimInsertModeRemaps`](/ru/settings#available-settings) отображает двухклавишную последовательность режима INSERT на Escape, поэтому такое отображение, как `jj`, возвращает вас в режим NORMAL. {/* min-version: 2.1.208 */}Требуется Claude Code v2.1.208 или позже.

160 

161Следующий пример `~/.claude/settings.json` включает режим vim и отображает `jj` на Escape:

162 

163```json theme={null}

164{

165 "editorMode": "vim",

166 "vimInsertModeRemaps": { "jj": "<Esc>" }

167}

168```

169 

170Каждый ключ состоит ровно из двух печатаемых символов, введённых последовательно, и `"<Esc>"` — единственная поддерживаемая цель. Записи с другой длиной или целью игнорируются.

171 

172Ввод первого символа последовательности вставляет его обычным образом. Нажатие второго символа в течение одной секунды удаляет этот ожидающий символ и переключается в режим NORMAL, оставляя оба символа вне вашего ввода. После окна в одну секунду или если следует другая клавиша, оба символа остаются как буквальный текст, поэтому вы всё ещё можете ввести слово, содержащее последовательность, сделав паузу между двумя клавишами.

173 

174Claude Code читает этот параметр из вашего файла пользовательских параметров, флага `--settings` и [управляемых параметров](/ru/permissions#managed-settings) только. Записи в `.claude/settings.json` или `.claude/settings.local.json` проекта игнорируются, поэтому проверенный репозиторий не может переназначить ваши нажатия клавиш.

175 

153<h3 id="navigation-normal-mode">176<h3 id="navigation-normal-mode">

154 Навигация (режим NORMAL)177 Навигация (режим NORMAL)

155</h3>178</h3>

jetbrains.md +26 −0

Details

242* Осведомленность о том, какие файлы Claude Code имеет доступ для изменения242* Осведомленность о том, какие файлы Claude Code имеет доступ для изменения

243 243 

244Для проблем с установкой или входом в Claude Code вне IDE см. [Устранение неполадок установки и входа](/ru/troubleshoot-install).244Для проблем с установкой или входом в Claude Code вне IDE см. [Устранение неполадок установки и входа](/ru/troubleshoot-install).

245 

246<h3 id="the-built-in-ide-mcp-server">

247 Встроенный MCP сервер IDE

248</h3>

249 

250Когда плагин активен, он запускает локальный MCP сервер, к которому CLI подключается автоматически. Это то, как CLI открывает различия в собственном средстве просмотра различий IDE, читает вашу текущую выделенную область для упоминаний `@` и извлекает диагностику проверки в беседу.

251 

252Сервер называется `ide` и скрыт от `/mcp`, потому что нечего конфигурировать. Однако если ваша организация использует [`PreToolUse` hook](/ru/hooks#pretooluse) для создания списка разрешенных MCP инструментов, вам нужно знать, что он существует.

253 

254**Контекст выделения и открытого файла.** При подключении CLI включает вашу текущую выделенную область редактора и путь активного файла в качестве контекста для каждого отправляемого вами запроса. Стенограмма показывает строку `⧉ Selected N lines from <file>` когда это происходит. Чтобы исключить конфиденциальный файл, такой как `.env`, добавьте [`Read` правило отказа](/ru/permissions#read-and-edit) для его пути. Соответствующее правило отказа предотвращает как выделенный текст, так и уведомление об открытом файле для этого файла от достижения Claude.

255 

256**Транспорт и аутентификация.** Сервер прослушивает порт, назначенный ОС, и порт не настраивается. Транспорт — это незашифрованный `ws://`; на loopback любой процесс, который может захватить трафик, также может прочитать токен из файла блокировки, поэтому TLS не добавит защиту от локального злоумышленника. Каждый запуск IDE генерирует свежий случайный токен аутентификации, записывает его в файл блокировки в `~/.claude/ide/<port>.lock`, и CLI должен представить его как заголовок `X-Claude-Code-Ide-Authorization` для подключения. Если установлена переменная `CLAUDE_CONFIG_DIR`, файл блокировки записывается в `$CLAUDE_CONFIG_DIR/ide/` вместо этого.

257 

258**Инструменты, предоставленные модели.** Сервер размещает несколько инструментов, но только один видим модели. Остальные — это внутренний RPC, который CLI использует для своего собственного пользовательского интерфейса, такой как открытие различий и чтение выделений, и они отфильтровываются перед тем, как список инструментов достигает Claude.

259 

260| Имя инструмента (как видно hooks) | Что он делает | Только для чтения |

261| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ----------------- |

262| `mcp__ide__getDiagnostics` | Возвращает диагностику проверки IDE, ошибки и предупреждения, показанные в редакторе. Опционально ограничено одним файлом. | Да |

263 

264Плагин JetBrains не предоставляет инструмент выполнения кода модели.

265 

266**Интерфейс прослушивания.** Какой сетевой интерфейс использует сервер, контролируется параметром **Accept connections from all network interfaces** в разделе **Settings → Tools → Claude Code \[Beta] → Networking (Advanced)**. Если параметр отключен, сервер прослушивает только `127.0.0.1` и недоступен с других хостов. Если он включен, порт доступен из вашей локальной сети. Параметр существует для случаев, когда CLI не может достичь IDE через loopback, например WSL2 с сетью NAT по умолчанию или удаленная установка IDE; см. [Конфигурация WSL](#wsl-configuration) для этого сценария.

267 

268<Warning>

269 Включение **Accept connections from all network interfaces** делает порт MCP IDE доступным из вашей локальной сети. Подключения по-прежнему требуют токен аутентификации из файла блокировки, но поскольку транспорт — это незашифрованный `ws://`, как трафик сеанса, так и этот токен пересекают сеть в открытом виде при включении параметра. Включайте его только когда loopback действительно не может работать. Для WSL2 предпочитайте [зеркальную сеть](#switch-wsl2-to-mirrored-networking), чтобы интерфейс loopback Windows был общим с виртуальной машиной Linux и сокет мог оставаться на loopback.

270</Warning>

keybindings.md +4 −3

Details

283Действия, доступные в контексте `DiffDialog`:283Действия, доступные в контексте `DiffDialog`:

284 284 

285| Действие | По умолчанию | Описание |285| Действие | По умолчанию | Описание |

286| :-------------------- | :--------------------- | :-------------------------------------------------------------------------------------- |286| :-------------------- | :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

287| `diff:dismiss` | Escape | Закрыть средство просмотра diff |287| `diff:dismiss` | Escape | Закрыть средство просмотра diff; из представления деталей возвращает к списку файлов |

288| `diff:previousSource` | Left | Предыдущий источник diff |288| `diff:previousSource` | Left | Предыдущий источник diff |

289| `diff:nextSource` | Right | Следующий источник diff |289| `diff:nextSource` | Right | Следующий источник diff |

290| `diff:previousFile` | Up, K | Предыдущий файл в списке файлов; прокрутка вверх на одну строку в представлении деталей |290| `diff:previousFile` | Up, K | Предыдущий файл в списке файлов; прокрутка вверх на одну строку в представлении деталей |

291| `diff:nextFile` | Down, J | Следующий файл в списке файлов; прокрутка вниз на одну строку в представлении деталей |291| `diff:nextFile` | Down, J | Следующий файл в списке файлов; прокрутка вниз на одну строку в представлении деталей |

292| `diff:viewDetails` | Enter | Просмотреть детали diff |292| `diff:viewDetails` | Enter | Просмотреть детали diff |

293| `diff:back` | (зависит от контекста) | Вернуться в средстве просмотра diff |293| `diff:back` | (не привязано) | Вернуться в средстве просмотра diff. Escape выполняет действие возврата через `diff:dismiss`. Предыдущое значение по умолчанию Left в представлении деталей было удалено в v2.1.203 |

294 294 

295Представление деталей diff также привязывает клавиши в стиле пейджера к стандартным [действиям прокрутки](#scroll-actions). Эти привязки являются частью контекста `DiffDialog` и применяются только в представлении деталей; значения по умолчанию контекста `Scroll`, указанные в разделе [Действия прокрутки](#scroll-actions), остаются неизменными.295Представление деталей diff также привязывает клавиши в стиле пейджера к стандартным [действиям прокрутки](#scroll-actions). Эти привязки являются частью контекста `DiffDialog` и применяются только в представлении деталей; значения по умолчанию контекста `Scroll`, указанные в разделе [Действия прокрутки](#scroll-actions), остаются неизменными.

296 296 


526* **Сочетания клавиш** обрабатывают действия на уровне компонента (переключение задач, отправка и т. д.)526* **Сочетания клавиш** обрабатывают действия на уровне компонента (переключение задач, отправка и т. д.)

527* Клавиша Escape в режиме vim переключает INSERT в NORMAL режим; она не запускает `chat:cancel`527* Клавиша Escape в режиме vim переключает INSERT в NORMAL режим; она не запускает `chat:cancel`

528* Большинство сочетаний Ctrl+клавиша проходят через режим vim в систему сочетаний клавиш528* Большинство сочетаний Ctrl+клавиша проходят через режим vim в систему сочетаний клавиш

529* Клавиши vim не переназначаются через файл сочетаний клавиш. Чтобы сопоставить двухклавишную последовательность в режиме INSERT, такую как `jj`, с клавишей Escape, используйте параметр [`vimInsertModeRemaps`](/ru/interactive-mode#remap-insert-mode-key-sequences)

529* В режиме vim NORMAL `?` показывает меню справки (поведение vim)530* В режиме vim NORMAL `?` показывает меню справки (поведение vim)

530* В режиме vim NORMAL `/` открывает поиск по истории, то же самое, что Ctrl+R в стандартном режиме531* В режиме vim NORMAL `/` открывает поиск по истории, то же самое, что Ctrl+R в стандартном режиме

531 532 

Details

254 254 

255Перечислите каталоги в `sparsePaths`, а не отдельные файлы. Файлы на уровне корня, такие как `package.json`, `tsconfig.base.json` и файлы блокировки, всегда проверяются наряду с каталогами, которые вы перечисляете. Каталоги на уровне корня нет, поэтому включите `.claude` в список, если вы хотите, чтобы `.claude/settings.json`, `.claude/rules/` или `.claude/skills/` корня репозитория были доступны внутри worktree.255Перечислите каталоги в `sparsePaths`, а не отдельные файлы. Файлы на уровне корня, такие как `package.json`, `tsconfig.base.json` и файлы блокировки, всегда проверяются наряду с каталогами, которые вы перечисляете. Каталоги на уровне корня нет, поэтому включите `.claude` в список, если вы хотите, чтобы `.claude/settings.json`, `.claude/rules/` или `.claude/skills/` корня репозитория были доступны внутри worktree.

256 256 

257Разреженный checkout требует, чтобы git включил `extensions.worktreeConfig` в общем файле `.git/config` репозитория, пока существует разреженный worktree. Claude Code удаляет эту запись после удаления последнего worktree, но только если Claude Code её добавил. Он никогда не удаляет значение, которое вы установили сами. До версии 2.1.207 запись оставалась после удаления последнего worktree, и инструменты на основе go-git, такие как `tea`, не могли открыть репозиторий, пока вы не запустили `git config --unset extensions.worktreeConfig`.

258 

257Чтобы избежать дублирования больших каталогов, таких как `node_modules`, в worktrees, объедините `sparsePaths` с `symlinkDirectories` в одном `.claude/settings.json`:259Чтобы избежать дублирования больших каталогов, таких как `node_modules`, в worktrees, объедините `sparsePaths` с `symlinkDirectories` в одном `.claude/settings.json`:

258 260 

259```json .claude/settings.json theme={null}261```json .claude/settings.json theme={null}

Details

4 4 

5# Подключение Claude Code к шлюзу LLM5# Подключение Claude Code к шлюзу LLM

6 6 

7> Направьте Claude Code на шлюз LLM вашей организации. Проверьте, уже ли администратор его настроил, или установите базовый URL и учетные данные самостоятельно для CLI, VS Code, GitHub Actions и Agent SDK, затем проверьте соединение и исправьте ошибки шлюза.7> Направьте Claude Code на шлюз LLM вашей организации. Проверьте, уже ли администратор его настроил, или установите базовый URL и учетные данные самостоятельно, затем проверьте соединение и исправьте ошибки шлюза.

8 8 

9[Шлюз LLM](/ru/llm-gateway) — это прокси, который ваша организация запускает между Claude Code и поставщиком модели. Когда ваша организация использует его, Claude Code аутентифицируется на шлюзе с учетными данными, которые выдает ваша организация, вместо вашего личного входа claude.ai.9[Шлюз LLM](/ru/llm-gateway) — это прокси, который ваша организация запускает между Claude Code и поставщиком модели. Когда ваша организация использует его, Claude Code аутентифицируется на шлюзе с учетными данными, которые выдает ваша организация, вместо вашего личного входа claude.ai.

10 10 


55* [Установка переменной учетных данных](#set-the-credential-variable) и [установка базового URL](#set-the-base-url-and-credential): две переменные, которые нужны каждому соединению с шлюзом55* [Установка переменной учетных данных](#set-the-credential-variable) и [установка базового URL](#set-the-base-url-and-credential): две переменные, которые нужны каждому соединению с шлюзом

56* [Проверка соединения](#verify-the-connection): подтвердите, что оно работает, прежде чем что-либо сохранять56* [Проверка соединения](#verify-the-connection): подтвердите, что оно работает, прежде чем что-либо сохранять

57* [Настройка каждой поверхности](#configure-each-surface): если вы используете поверхность, отличную от CLI Claude Code, такую как VS Code, см., как настроить ее с учетными данными шлюза57* [Настройка каждой поверхности](#configure-each-surface): если вы используете поверхность, отличную от CLI Claude Code, такую как VS Code, см., как настроить ее с учетными данными шлюза

58* [Дополнительная конфигурация](#additional-configuration): переменные, которые некоторым шлюзам нужны помимо базового URL и учетных данных, такие как пользовательский заголовок, помощник учетных данных, обнаружение модели или базовый URL в формате поставщика. Устанавливайте их только если администратор их назвал58* [Дополнительная конфигурация](#additional-configuration): переменные, которые некоторым шлюзам нужны помимо базового URL и учетных данных, такие как пользовательский заголовок, помощник учетных данных, обнаружение модели, базовый URL в формате поставщика или отключение трафика вне пути шлюза. Устанавливайте их только если администратор их назвал или ваша сеть ограничивает исходящий трафик

59 59 

60<h3 id="set-the-credential-variable">60<h3 id="set-the-credential-variable">

61 Установка переменной учетных данных61 Установка переменной учетных данных


209 Настольное приложение209 Настольное приложение

210</h3>210</h3>

211 211 

212Настольное приложение читает маршрутизацию шлюза из [конфигурации, распределяемой администратором](https://claude.com/docs/third-party/claude-desktop/gateway), а не из `ANTHROPIC_BASE_URL` или `settings.json`. Если ваша организация распределила ее, настольное приложение маршрутизирует через шлюз без каких-либо действий с вашей стороны; если нет, используйте терминальный CLI или расширение VS Code для сеансов шлюза. Администраторы распределяют конфигурацию, как описано в [развертывании организации](/ru/llm-gateway-rollout#distribute-through-managed-settings).212Настольное приложение читает маршрутизацию шлюза из [конфигурации сторонних поставщиков](https://claude.com/docs/third-party/claude-desktop/gateway), а не из `ANTHROPIC_BASE_URL` или `settings.json`. Эта конфигурация может поступить от вашей организации или из формы в самом приложении:

213 

214* **Распределено администратором**: если ваша организация [развернула конфигурацию](/ru/llm-gateway-rollout#distribute-through-managed-settings), настольное приложение маршрутизирует через шлюз без каких-либо действий с вашей стороны

215* **Настроено локально**: для устройств без распределенной администратором конфигурации откройте Help → Troubleshooting → Включить режим разработчика, который перезагружает приложение с меню Developer. Затем откройте Developer → Configure Third-Party Inference и введите базовый URL вашего шлюза. Распределенная администратором конфигурация имеет приоритет и делает эту форму доступной только для чтения

216 

217При активной конфигурации шлюза настольное приложение запускает сеансы только на вашем локальном компьютере: средство выбора окружения не предлагает сеансы SSH или размещенные в облаке окружения Anthropic, и [Remote Control](/ru/remote-control) недоступен. Чтобы использовать Claude Code на удаленном хосте через шлюз, запустите CLI на этом хосте с установленными [`ANTHROPIC_BASE_URL` и учетными данными шлюза](#set-the-base-url-and-credential).

213 218 

214Если настольное приложение показывает `Gateway was unreachable`, приложение не смогло достичь настроенный базовый URL при запуске; проверьте URL и сетевой путь с помощью [теста curl выше](#verify-the-connection).219Если настольное приложение показывает `Gateway was unreachable`, приложение не смогло достичь настроенный базовый URL при запуске; проверьте URL и сетевой путь с помощью [теста curl выше](#verify-the-connection).

215 220 


296 Дополнительная конфигурация301 Дополнительная конфигурация

297</h2>302</h2>

298 303 

299Эти параметры охватывают случаи, выходящие за рамки базового URL и учетных данных. Устанавливайте их только если инструкции администратора или [таблица устранения неполадок](#troubleshoot-gateway-errors) требуют одного.304Эти параметры охватывают случаи, выходящие за рамки базового URL и учетных данных. Устанавливайте их только если инструкции администратора, правила исходящего трафика вашей сети или [таблица устранения неполадок](#troubleshoot-gateway-errors) требуют одного.

300 305 

301<h3 id="send-additional-headers">306<h3 id="send-additional-headers">

302 Отправка дополнительных заголовков307 Отправка дополнительных заголовков


389 394 

390Значение помощника отправляется в оба заголовка `Authorization` и `x-api-key`, поэтому оно работает, какой бы заголовок ни читал ваш шлюз.395Значение помощника отправляется в оба заголовка `Authorization` и `x-api-key`, поэтому оно работает, какой бы заголовок ни читал ваш шлюз.

391 396 

397<h3 id="turn-off-traffic-outside-the-gateway-path">

398 Отключение трафика вне пути шлюза

399</h3>

400 

401Шлюз переносит запросы модели, но Claude Code также отправляет несущественный фоновый трафик вне пути шлюза в Anthropic и в сторонние сервисы, такие как GitHub: проверки версий, телеметрия, отчеты об ошибках, примечания к выпуску и аналогичные запросы. В сети, которая разрешает исходящий трафик только на шлюз, эти запросы не выполняются и могут отображаться как заблокированные соединения в вашем мониторинге исходящего трафика.

402 

403Чтобы отключить этот трафик, установите `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` наряду с переменными шлюза, в том же блоке экспорта оболочки или блоке `env` файла параметров:

404 

405<Tabs>

406 <Tab title="Bash или Zsh">

407 ```bash theme={null}

408 export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

409 ```

410 </Tab>

411 

412 <Tab title="PowerShell">

413 ```powershell theme={null}

414 $env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

415 ```

416 </Tab>

417</Tabs>

418 

419Установка переменной имеет эти эффекты и ограничения:

420 

421* Она отключает автоматические обновления, поэтому планируйте другой путь обновления, такой как ваш менеджер пакетов или управляемое распределение.

422* Она подавляет проверку доступности [быстрого режима](/ru/fast-mode). Если предыдущая проверка уже не включила быстрый режим на машине, `/fast` сообщает, что быстрый режим недоступен.

423* Она отключает [обнаружение модели шлюза](#add-gateway-models-to-the-model-picker), хотя обнаружение запрашивает сам шлюз. Ранее обнаруженные модели остаются доступными из локального кэша, но список не обновляется.

424* Проверка безопасности домена инструмента WebFetch не затрагивается и по-прежнему вызывает `api.anthropic.com`. Отключите ее отдельно с помощью `skipWebFetchPreflight: true` в [параметрах](/ru/settings), если ваша сеть блокирует этот хост.

425* Для каждого потока телеметрии и переменной, которая его контролирует, см. [сервисы телеметрии](/ru/data-usage#telemetry-services).

426 

392<h3 id="route-to-a-cloud-provider-through-a-gateway">427<h3 id="route-to-a-cloud-provider-through-a-gateway">

393 Маршрутизация к облачному поставщику через шлюз428 Маршрутизация к облачному поставщику через шлюз

394</h3>429</h3>


509| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |544| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

510| Предупреждение при запуске, называющее два источника учетных данных и заканчивающееся на `auth may not work as expected`. Более старые версии показывают `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` вместо этого. | Учетные данные шлюза и сохраненный вход оба активны; переменная используется для запросов, но устаревший вход может вызвать неожиданное поведение аутентификации | Отмените установку переменной, чтобы использовать сохраненный вход, или запустите `/logout`, чтобы использовать учетные данные шлюза |545| Предупреждение при запуске, называющее два источника учетных данных и заканчивающееся на `auth may not work as expected`. Более старые версии показывают `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` вместо этого. | Учетные данные шлюза и сохраненный вход оба активны; переменная используется для запросов, но устаревший вход может вызвать неожиданное поведение аутентификации | Отмените установку переменной, чтобы использовать сохраненный вход, или запустите `/logout`, чтобы использовать учетные данные шлюза |

511| Ошибки `401`, называющие недействительный или неузнанный токен | Учетные данные не являются теми, которые выдал шлюз, или они находятся в заголовке, который шлюз не читает | Подтвердите, что переменная соответствует вашему типу учетных данных в [таблице учетных данных](#set-the-credential-variable), и переустановите ключ на шлюзе, если он был отозван |546| Ошибки `401`, называющие недействительный или неузнанный токен | Учетные данные не являются теми, которые выдал шлюз, или они находятся в заголовке, который шлюз не читает | Подтвердите, что переменная соответствует вашему типу учетных данных в [таблице учетных данных](#set-the-credential-variable), и переустановите ключ на шлюзе, если он был отозван |

547| `Your apiKeyHelper script is failing` | Команда в параметре [`apiKeyHelper`](/ru/settings#available-settings) завершилась с ошибкой, истекла по времени или не вывела ничего, поэтому запросы содержат заполнитель ключа | Запустите команду напрямую, чтобы увидеть, почему она не работает, и повторно аутентифицируйтесь у поставщика учетных данных, если он сообщает об истекшем сеансе; см. [справочник по ошибкам](/ru/errors#your-apikeyhelper-script-is-failing) |

512| `Unable to connect to API (ConnectionRefused)` или `(ECONNREFUSED)` из установок npm, часто после молчаливой паузы, пока Claude Code [повторяет с отступом](/ru/errors#automatic-retries) | Ничто не ответило на базовый URL: адрес неправильный или VPN или брандмауэр блокирует путь к шлюзу | Запустите [тест curl выше](#verify-the-connection), который немедленно не проходит с той же причиной, и подтвердите URL и сетевой путь с командой шлюза |548| `Unable to connect to API (ConnectionRefused)` или `(ECONNREFUSED)` из установок npm, часто после молчаливой паузы, пока Claude Code [повторяет с отступом](/ru/errors#automatic-retries) | Ничто не ответило на базовый URL: адрес неправильный или VPN или брандмауэр блокирует путь к шлюзу | Запустите [тест curl выше](#verify-the-connection), который немедленно не проходит с той же причиной, и подтвердите URL и сетевой путь с командой шлюза |

513| `API returned an empty or malformed response (HTTP 200)` | Шлюз или промежуточный прокси вернул ответ, отличный от API, часто HTML-ошибку или страницу входа | Протестируйте с [запросом curl выше](#verify-the-connection); исправьте маршрут шлюза, который возвращает не-JSON |549| `API returned an empty or malformed response (HTTP 200)` | Шлюз или промежуточный прокси вернул ответ, отличный от API, часто HTML-ошибку или страницу входа | Протестируйте с [запросом curl выше](#verify-the-connection); исправьте маршрут шлюза, который возвращает не-JSON |

514| Ошибки `400`, называющие `context_management`, `Extra inputs are not permitted` или другие неузнанные поля | Шлюз пересылает запросы на вышестоящий, который отклоняет поля, которые Claude Code отправляет на конечные точки формата Anthropic | Установите `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`, что подавляет большинство полей предварительного выпуска; см. [передача функций](/ru/llm-gateway-protocol#feature-pass-through). Некоторые бета-версии не управляются этим флагом; для них установите соответствующую переменную поставщика `CLAUDE_CODE_USE_*`, чтобы Claude Code отправлял только то, что этот поставщик принимает |550| Ошибки `400`, называющие `context_management`, `Extra inputs are not permitted` или другие неузнанные поля | Шлюз пересылает запросы на вышестоящий, который отклоняет поля, которые Claude Code отправляет на конечные точки формата Anthropic | Установите `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`, что подавляет большинство полей предварительного выпуска; см. [передача функций](/ru/llm-gateway-protocol#feature-pass-through). Некоторые бета-версии не управляются этим флагом; для них установите соответствующую переменную поставщика `CLAUDE_CODE_USE_*`, чтобы Claude Code отправлял только то, что этот поставщик принимает |

Details

129Потоковая передача инструментов с точной детализацией — одно из значений по умолчанию для прямого соединения: она отключена по умолчанию, когда запросы маршрутизируются через пользовательский базовый URL, и gateway получает ее, когда разработчики установили [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/ru/env-vars).129Потоковая передача инструментов с точной детализацией — одно из значений по умолчанию для прямого соединения: она отключена по умолчанию, когда запросы маршрутизируются через пользовательский базовый URL, и gateway получает ее, когда разработчики установили [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/ru/env-vars).

130 130 

131| Функция | Заголовок и связь тела | Симптом при нарушении | Исправление |131| Функция | Заголовок и связь тела | Симптом при нарушении | Исправление |

132| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |132| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

133| [Адаптивное рассуждение](/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` |133| [Адаптивное рассуждение](/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` |

134| [Управление контекстом](https://platform.claude.com/docs/en/build-with-claude/context-management) | Бета-заголовок управления контекстом связан с полем тела `context_management` | `400` с `Extra inputs are not permitted`. Часто встречается, когда gateway принимает запросы формата Anthropic, но пересылает их на Amazon Bedrock | Пересылайте оба или [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ru/env-vars) |134| [Управление контекстом](https://platform.claude.com/docs/en/build-with-claude/context-management) | Бета-заголовок управления контекстом связан с полем тела `context_management` | `400` с `Extra inputs are not permitted`. Часто встречается, когда gateway принимает запросы формата Anthropic, но пересылает их на Amazon Bedrock | Пересылайте оба или [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ru/env-vars) |

135| [Расширенный контекст](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window) и [чередующееся мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | Только бета-заголовки, нет поля тела | Молча недоступно, когда заголовок удален; upstream никогда не видит запрос возможности | Пересылайте `anthropic-beta` дословно |135| [Расширенный контекст](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` дословно |

136| Бета [поля инструментов](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Бета-заголовки, связанные с инструментами, связаны с полями схемы инструментов, такими как `strict` и `defer_loading` | `400` с указанием неузнанного поля схемы инструмента, когда тело проходит без его заголовка | Пересылайте оба или `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |136| Бета [поля инструментов](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Бета-заголовки, связанные с инструментами, связаны с полями схемы инструментов, такими как `strict` и `defer_loading` | `400` с указанием неузнанного поля схемы инструмента, когда тело проходит без его заголовка | Пересылайте оба или `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |

137| [Усилие](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 | Пересылайте поле и его заголовки вместе |137| [Усилие](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 | Пересылайте поле и его заголовки вместе |

138| [Подсчет токенов](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Нет бета-связи; использует конечную точку `count_tokens` | Claude Code возвращается к локальной оценке использования контекста | Предоставьте конечную точку, если вы хотите точные подсчеты |138| [Подсчет токенов](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Нет бета-связи; использует конечную точку `count_tokens` | Claude Code возвращается к локальной оценке использования контекста | Предоставьте конечную точку, если вы хотите точные подсчеты |

managed-mcp.md +7 −2

Details

133 Контроль на основе политики со списками разрешений и запретов133 Контроль на основе политики со списками разрешений и запретов

134</h2>134</h2>

135 135 

136Списки разрешений и запретов фильтруют, какие настроенные серверы разрешены для загрузки. Это не реестр: сервер все еще должен быть добавлен пользователем, плагином или `managed-mcp.json` перед тем, как список разрешений или запретов применится к нему. Чтобы развернуть серверы для пользователей, используйте [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json).136Списки разрешений и запретов фильтруют, какие настроенные серверы разрешены для загрузки. Это не реестр: сервер все еще должен быть добавлен пользователем, плагином или `managed-mcp.json` перед тем, как список разрешений или запретов применится к нему. Чтобы развернуть серверы для пользователей, используйте [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json). Оба списка также фильтруют серверы, переданные с флагом CLI [`--mcp-config`](/ru/cli-reference#cli-flags); `--strict-mcp-config` ограничивает, какие файлы конфигурации загружаются, и не обходит ни один из списков.

137 137 

138Чтобы сделать список разрешений авторитетным, установите `allowedMcpServers` и `allowManagedMcpServersOnly: true` вместе в [источник управляемых настроек](/ru/admin-setup#decide-how-settings-reach-devices), такой как server-managed settings или развернутый файл `managed-settings.json`. [Ограничение списка разрешений только управляемыми настройками](#restrict-the-allowlist-to-managed-settings-only) показывает конфигурацию. Без `allowManagedMcpServersOnly` списки разрешений из каждого источника настроек объединяются, включая собственный `~/.claude/settings.json` пользователя, поэтому пользователь может расширить то, что разрешает ваш список разрешений. Списки запретов объединяются из каждого источника независимо.138Чтобы сделать список разрешений авторитетным, установите `allowedMcpServers` и `allowManagedMcpServersOnly: true` вместе в [источник управляемых настроек](/ru/admin-setup#decide-how-settings-reach-devices), такой как server-managed settings или развернутый файл `managed-settings.json`. [Ограничение списка разрешений только управляемыми настройками](#restrict-the-allowlist-to-managed-settings-only) показывает конфигурацию. Без `allowManagedMcpServersOnly` списки разрешений из каждого источника настроек объединяются, включая собственный `~/.claude/settings.json` пользователя, поэтому пользователь может расширить то, что разрешает ваш список разрешений. Списки запретов объединяются из каждого источника независимо.

139 139 


160| `allowedMcpServers` | Все серверы разрешены | Серверы не разрешены | Разрешены только совпадающие серверы |160| `allowedMcpServers` | Все серверы разрешены | Серверы не разрешены | Разрешены только совпадающие серверы |

161| `deniedMcpServers` | Серверы не блокируются | Серверы не блокируются | Совпадающие серверы блокируются |161| `deniedMcpServers` | Серверы не блокируются | Серверы не блокируются | Совпадающие серверы блокируются |

162 162 

163См. [Недействительные записи в управляемых настройках](/ru/settings#invalid-entries-in-managed-settings) для информации о том, что происходит, когда запись не проходит валидацию схемы.

164 

163<Warning>165<Warning>

164 Запись `serverName`, в любом списке, не является элементом управления безопасностью. Имя — это метка, которую пользователь назначает при запуске `claude mcp add` или редактировании файла конфигурации, а не базовый сервер, поэтому пользователь может назвать любой сервер `github`. Для соединителей claude.ai имя — это отображаемое имя, возвращаемое claude.ai, которое может измениться. Чтобы применить, какие серверы фактически работают, добавьте записи `serverCommand` или `serverUrl`.166 Запись `serverName`, в любом списке, не является элементом управления безопасностью. Имя — это метка, которую пользователь назначает при запуске `claude mcp add` или редактировании файла конфигурации, а не базовый сервер, поэтому пользователь может назвать любой сервер `github`. Для соединителей claude.ai имя — это отображаемое имя, возвращаемое claude.ai, которое может измениться. Чтобы применить, какие серверы фактически работают, добавьте записи `serverCommand` или `serverUrl`.

165</Warning>167</Warning>


186| Удаленный (HTTP или SSE) | Запись `serverUrl`. Совпадение `serverName` считается только когда список разрешений не содержит записей `serverUrl` |188| Удаленный (HTTP или SSE) | Запись `serverUrl`. Совпадение `serverName` считается только когда список разрешений не содержит записей `serverUrl` |

187| Stdio | Запись `serverCommand`. Совпадение `serverName` считается только когда список разрешений не содержит записей `serverCommand` |189| Stdio | Запись `serverCommand`. Совпадение `serverName` считается только когда список разрешений не содержит записей `serverCommand` |

188 190 

189Два правила сопоставления применяются внутри этих проверок:191Три правила сопоставления применяются внутри этих проверок:

190 192 

191* **Команды совпадают точно.** Каждый аргумент по порядку. `["npx", "-y", "server"]` не совпадает с `["npx", "server"]` или `["npx", "-y", "server", "--flag"]`.193* **Команды совпадают точно.** Каждый аргумент по порядку. `["npx", "-y", "server"]` не совпадает с `["npx", "server"]` или `["npx", "-y", "server", "--flag"]`.

194* **`serverCommand` и `serverUrl` значения расширяются перед сопоставлением.** Как запись политики, так и настроенное значение сервера проходят через то же расширение [`${VAR}` и `${VAR:-default}`](/ru/mcp#environment-variable-expansion-in-mcp-json), что и `.mcp.json`, поэтому запись, написанная как `["${HOME}/bin/server"]`, совпадает с конфигурацией сервера, которая использует либо ту же ссылку, либо расширенный путь. На Windows ссылайтесь на переменную окружения, которая установлена там, такую как `${USERPROFILE}` вместо `${HOME}`. `serverName` значения совпадают буквально и никогда не расширяются.

192* **URL поддерживают подстановочные знаки `*`** в любом месте шаблона, включая схему. Сопоставление имени хоста не учитывает регистр и игнорирует конечную точку FQDN, поэтому `https://Mcp.Example.com/*` совпадает с `https://mcp.example.com/api`. Пути остаются чувствительными к регистру.195* **URL поддерживают подстановочные знаки `*`** в любом месте шаблона, включая схему. Сопоставление имени хоста не учитывает регистр и игнорирует конечную точку FQDN, поэтому `https://Mcp.Example.com/*` совпадает с `https://mcp.example.com/api`. Пути остаются чувствительными к регистру.

193 196 

194| Шаблон | Разрешает |197| Шаблон | Разрешает |


199| `http://localhost:*/*` | Любой порт на localhost |202| `http://localhost:*/*` | Любой порт на localhost |

200| `*://mcp.example.com/*` | Любая схема к конкретному домену |203| `*://mcp.example.com/*` | Любая схема к конкретному домену |

201 204 

205Поскольку расширение `${VAR}` читает собственное окружение процесса Claude Code, запись политики `serverCommand` или `serverUrl`, которая ссылается на переменную, расширяется до любого значения, которое устанавливает пользователь. Используйте буквальные URL и команды для записей, на которые вы полагаетесь для применения.

206 

202<h3 id="example-configuration">207<h3 id="example-configuration">

203 Пример конфигурации208 Пример конфигурации

204</h3>209</h3>

mcp.md +32 −12

Details

187* ваш пользовательский `~/.claude/settings.json`187* ваш пользовательский `~/.claude/settings.json`

188* управляемые параметры188* управляемые параметры

189* параметры, переданные с помощью `--settings`189* параметры, переданные с помощью `--settings`

190* `.claude/settings.local.json`, при условии, что git его не отслеживает190 

191Одобрения в неотслеживаемом `.claude/settings.local.json` также применяются, но только после того, как вы примете диалог доверия для этой папки или одной из ее родительских директорий: Claude Code запускает git для проверки того, отслеживается ли файл, и выполняет эту проверку только в доверенной папке. В папке, которой вы никогда не доверяли, одобрения файла ждут диалога доверия, если только папка не является вашей конфигурационной домашней директорией: вашей домашней директорией или директорией, чей `.claude` вы установили как [`CLAUDE_CONFIG_DIR`](/ru/env-vars). До версии 2.1.207 неотслеживаемый `.claude/settings.local.json` одобрял servers в папке, которой вы никогда не доверяли.

191 192 

192Запись `disabledMcpjsonServers` в любом файле параметров все еще отклоняет server.193Запись `disabledMcpjsonServers` в любом файле параметров все еще отклоняет server.

193 194 

194Панель `/mcp` показывает количество инструментов рядом с каждым подключенным server и отмечает servers, которые объявляют возможность tools, но не предоставляют никаких инструментов.195Панель `/mcp` показывает количество инструментов рядом с каждым подключенным server и отмечает servers, которые объявляют возможность tools, но не предоставляют никаких инструментов.

195 196 

197Удаленный server, конфигурация которого имеет пустой `url`, отображается как `not configured` в `/mcp`, в `claude mcp list` и в [менеджере `/plugin`](/ru/plugins), и Claude Code не пытается подключиться к нему. Плагин может включать запись-заполнитель, подобную этой, для коннектора, который вы настроите позже, поэтому Claude Code не сообщает об этом как об ошибке или проблеме настройки. Представление деталей server в `/mcp` читает `No URL configured for this server`; установите `url` записи для подключения. До версии 2.1.208 Claude Code сообщал об пустом `url` как о проблеме конфигурации с подсказкой переподключиться.

198 

196Если ваш запрос требует инструментов от server, который все еще подключается в фоновом режиме, Claude ждет подключения этого server перед продолжением. С включенным [поиском инструментов](#scale-with-mcp-tool-search), который используется по умолчанию, ожидание происходит внутри вызова `ToolSearch`. В конфигурациях без поиска инструментов, таких как Google Cloud's Agent Platform, пользовательский `ANTHROPIC_BASE_URL` или `ENABLE_TOOL_SEARCH=false`, Claude использует инструмент `WaitForMcpServers` вместо этого.199Если ваш запрос требует инструментов от server, который все еще подключается в фоновом режиме, Claude ждет подключения этого server перед продолжением. С включенным [поиском инструментов](#scale-with-mcp-tool-search), который используется по умолчанию, ожидание происходит внутри вызова `ToolSearch`. В конфигурациях без поиска инструментов, таких как Google Cloud's Agent Platform, пользовательский `ANTHROPIC_BASE_URL` или `ENABLE_TOOL_SEARCH=false`, Claude использует инструмент `WaitForMcpServers` вместо этого.

197 200 

198Некоторые имена servers зарезервированы для встроенных servers Claude Code: `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` и `Claude Browser`. Если ваша конфигурация определяет server с зарезервированным именем, Claude Code пропускает его при загрузке и показывает предупреждение с просьбой переименовать его. `claude mcp add` отклоняет зарезервированное имя с ошибкой.201Некоторые имена servers зарезервированы для встроенных servers Claude Code: `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` и `Claude Browser`. Если ваша конфигурация определяет server с зарезервированным именем, Claude Code пропускает его при загрузке и показывает предупреждение с просьбой переименовать его. `claude mcp add` отклоняет зарезервированное имя с ошибкой.


213 216 

214Та же задержка применяется, когда HTTP или SSE server не может подключиться при запуске. Начиная с версии 2.1.121, Claude Code повторяет попытку начального подключения до трех раз при временных ошибках, таких как ответ 5xx, отказ в соединении или timeout, а затем помечает server как неудачный, если он все еще не может подключиться. Ошибки аутентификации и ошибки не найдено не повторяются, так как они требуют изменения конфигурации для разрешения.217Та же задержка применяется, когда HTTP или SSE server не может подключиться при запуске. Начиная с версии 2.1.121, Claude Code повторяет попытку начального подключения до трех раз при временных ошибках, таких как ответ 5xx, отказ в соединении или timeout, а затем помечает server как неудачный, если он все еще не может подключиться. Ошибки аутентификации и ошибки не найдено не повторяются, так как они требуют изменения конфигурации для разрешения.

215 218 

216Когда настроенный server не может подключиться, Claude Code сообщает Claude, какой server не удалось подключить и его ошибку подключения, включая результаты `ToolSearch`, которые не находят соответствующий инструмент, поэтому Claude сообщает об ошибке подключения в своем ответе. Требуется [поиск инструментов](#scale-with-mcp-tool-search), который включен по умолчанию. В конфигурациях без поиска инструментов, таких как пользовательский `ANTHROPIC_BASE_URL`, `ENABLE_TOOL_SEARCH=false` или модель Haiku, а также на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, Claude Code не сообщает Claude об ошибках подключения неудачных servers. До версии 2.1.205 Claude Code не передавал ошибки подключения Claude, и Claude мог ответить так, как будто инструменты неудачного server никогда не были настроены.219Когда настроенный server не может подключиться, Claude Code сообщает Claude, какой server не удалось подключить и его ошибку подключения, включая результаты `ToolSearch`, которые не находят соответствующий инструмент, поэтому Claude сообщает об ошибке подключения в своем ответе. Требуется [поиск инструментов](#scale-with-mcp-tool-search), который включен по умолчанию. В конфигурациях без поиска инструментов, таких как пользовательский `ANTHROPIC_BASE_URL`, `ENABLE_TOOL_SEARCH=false` или модель, которая не поддерживает поиск инструментов, а также на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, Claude Code не сообщает Claude об ошибках подключения неудачных servers. До версии 2.1.205 Claude Code не передавал ошибки подключения Claude, и Claude мог ответить так, как будто инструменты неудачного server никогда не были настроены.

217 220 

218Начиная с версии 2.1.191, запросы обнаружения возможностей, которые выполняются после успешного подключения, такие как `tools/list`, `prompts/list` и `resources/list`, также повторяют временные сетевые и серверные ошибки до трех раз с короткой задержкой. Ошибки аутентификации, ответы 4xx и timeout запросов не повторяются.221Начиная с версии 2.1.191, запросы обнаружения возможностей, которые выполняются после успешного подключения, такие как `tools/list`, `prompts/list` и `resources/list`, также повторяют временные сетевые и серверные ошибки до трех раз с короткой задержкой. Ошибки аутентификации, ответы 4xx и timeout запросов не повторяются.

219 222 


234 * Флаги `--transport` и `--header` также принимают короткие формы `-t` и `-H`237 * Флаги `--transport` и `--header` также принимают короткие формы `-t` и `-H`

235 * Настройте timeout запуска MCP server, используя переменную окружения `MCP_TIMEOUT` (например, `MCP_TIMEOUT=10000 claude` устанавливает timeout в 10 секунд)238 * Настройте timeout запуска MCP server, используя переменную окружения `MCP_TIMEOUT` (например, `MCP_TIMEOUT=10000 claude` устанавливает timeout в 10 секунд)

236 * Установите timeout выполнения инструмента для каждого server, добавив поле `timeout` в миллисекундах в запись этого server в `.mcp.json`, например `"timeout": 600000` для десяти минут. Это переопределяет переменную окружения `MCP_TOOL_TIMEOUT` только для этого server239 * Установите timeout выполнения инструмента для каждого server, добавив поле `timeout` в миллисекундах в запись этого server в `.mcp.json`, например `"timeout": 600000` для десяти минут. Это переопределяет переменную окружения `MCP_TOOL_TIMEOUT` только для этого server

237 * Claude Code отобразит предупреждение, когда выход инструмента MCP превышает 10 000 токенов. Чтобы увеличить этот лимит, установите переменную окружения `MAX_MCP_OUTPUT_TOKENS` (например, `MAX_MCP_OUTPUT_TOKENS=50000`)240 * Claude Code отобразит предупреждение, когда выход инструмента MCP превышает 10 000 токенов и ограничивает выход до 25 000 токенов по умолчанию. Чтобы увеличить этот лимит, установите переменную окружения `MAX_MCP_OUTPUT_TOKENS` (например, `MAX_MCP_OUTPUT_TOKENS=50000`); порог предупреждения фиксирован. См. [Лимиты выхода MCP и предупреждения](#mcp-output-limits-and-warnings)

238 * Используйте `/mcp` для аутентификации с удаленными servers, которые требуют аутентификацию OAuth 2.0241 * Используйте `/mcp` для аутентификации с удаленными servers, которые требуют аутентификацию OAuth 2.0

239</Tip>242</Tip>

240 243 

241Timeout для каждого server — это жесткий лимит реального времени для каждого вызова инструмента, и уведомления о прогрессе от server не продлевают его. Значения ниже 1000 игнорируются и переходят к `MCP_TOOL_TIMEOUT`, или к его значению по умолчанию примерно 28 часов, когда эта переменная не установлена. {/* min-version: 2.1.162 */}До версии 2.1.162 значения ниже 1000 округлялись до одной секунды вместо этого.244Timeout для каждого server — это жесткий лимит реального времени для каждого вызова инструмента, и уведомления о прогрессе от server не продлевают его. Значения ниже 1000 игнорируются и переходят к `MCP_TOOL_TIMEOUT`, или к его значению по умолчанию примерно 28 часов, когда эта переменная не установлена. Для HTTP, SSE или [claude.ai connector](/ru/mcp#use-mcp-servers-from-claude-ai) server существует также второй таймер для каждого запроса, который охватывает каждый запрос до первого байта ответа server. Этот таймер составляет 60 секунд, если вы не установите timeout для каждого server или `MCP_TOOL_TIMEOUT`; установка любого из них на 60 секунд или выше повышает таймер для каждого запроса до этого значения, более низкое значение не сокращает его, и значение по умолчанию 28 часов неустановленного `MCP_TOOL_TIMEOUT` никогда не питает его. Stdio и WebSocket servers не имеют таймера для каждого запроса. {/* min-version: 2.1.162 */}До версии 2.1.162 значения ниже 1000 округлялись до одной секунды вместо этого.

242 245 

243Timeout для каждого server не менее 1000 также действует как нижний предел для timeout неактивности, описанного ниже: Claude Code никогда не прерывает вызовы инструментов этого server из-за неактивности раньше, чем timeout для каждого server. Требуется Claude Code версии 2.1.203 или позже.246Timeout для каждого server не менее 1000 также действует как нижний предел для timeout неактивности, описанного ниже: Claude Code никогда не прерывает вызовы инструментов этого server из-за неактивности раньше, чем timeout для каждого server. Требуется Claude Code версии 2.1.203 или позже.

244 247 

245Для HTTP и SSE servers бюджет первого байта для каждого запроса fetch имеет минимум 60 секунд.

246 

247Вызов инструмента к MCP server, который не отправляет ответ и не отправляет уведомление о прогрессе в течение окна неактивности, прерывается с ошибкой вместо ожидания лимита реального времени. Timeout неактивности требует Claude Code версии 2.1.187 или позже. {/* min-version: 2.1.203 */}Он применяется к каждому типу server, кроме IDE servers и SDK in-process servers. Окно неактивности по умолчанию составляет пять минут для HTTP, SSE, WebSocket и [claude.ai connector](#use-mcp-servers-from-claude-ai) servers, и 30 минут для stdio servers. До версии 2.1.203 stdio servers были освобождены от timeout неактивности.248Вызов инструмента к MCP server, который не отправляет ответ и не отправляет уведомление о прогрессе в течение окна неактивности, прерывается с ошибкой вместо ожидания лимита реального времени. Timeout неактивности требует Claude Code версии 2.1.187 или позже. {/* min-version: 2.1.203 */}Он применяется к каждому типу server, кроме IDE servers и SDK in-process servers. Окно неактивности по умолчанию составляет пять минут для HTTP, SSE, WebSocket и [claude.ai connector](#use-mcp-servers-from-claude-ai) servers, и 30 минут для stdio servers. До версии 2.1.203 stdio servers были освобождены от timeout неактивности.

248 249 

249Установите переменную окружения [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/ru/env-vars) в миллисекундах, чтобы изменить окно неактивности, или установите ее на `0`, чтобы отключить проверку.250Установите переменную окружения [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/ru/env-vars) в миллисекундах, чтобы изменить окно неактивности, или установите ее на `0`, чтобы отключить проверку.


296**Функции plugin MCP**:297**Функции plugin MCP**:

297 298 

298* **Автоматический жизненный цикл**: При запуске сеанса servers для включенных плагинов подключаются автоматически. Если вы включите или отключите плагин во время сеанса, запустите `/reload-plugins` для подключения или отключения его MCP servers299* **Автоматический жизненный цикл**: При запуске сеанса servers для включенных плагинов подключаются автоматически. Если вы включите или отключите плагин во время сеанса, запустите `/reload-plugins` для подключения или отключения его MCP servers

299* **Переменные окружения**: используйте `${CLAUDE_PLUGIN_ROOT}` для файлов плагина, `${CLAUDE_PLUGIN_DATA}` для [постоянного состояния](/ru/plugins-reference#persistent-data-directory), которое сохраняется при обновлении плагина, и `${CLAUDE_PROJECT_DIR}` для стабильного корня проекта300* **Переменные пути**: `${CLAUDE_PLUGIN_ROOT}` разрешается в директорию установки плагина, `${CLAUDE_PLUGIN_DATA}` в его [директорию постоянного состояния](/ru/plugins-reference#persistent-data-directory), и `${CLAUDE_PROJECT_DIR}` в стабильный корень проекта. Подстановка применяется к:

301 * `stdio` servers: `command`, `args`, `env`

302 * `http`, `sse` и `ws` servers: `url`, `headers` и `headersHelper`. {/* min-version: 2.1.195 */}До версии 2.1.195 `headersHelper` передавал заполнитель как буквальную строку

300* **Доступ к переменным окружения пользователя**: доступ к тем же переменным окружения, что и вручную настроенные servers303* **Доступ к переменным окружения пользователя**: доступ к тем же переменным окружения, что и вручную настроенные servers

301* **Несколько типов транспорта**: поддержка stdio, SSE, HTTP и WebSocket транспортов, хотя поддержка транспорта может варьироваться в зависимости от server304* **Несколько типов транспорта**: поддержка stdio, SSE, HTTP и WebSocket транспортов, хотя поддержка транспорта может варьироваться в зависимости от server

302 305 


464}467}

465```468```

466 469 

467Если требуемая переменная окружения не установлена и не имеет значения по умолчанию, Claude Code не сможет разобрать конфигурацию.470Если требуемая переменная окружения не установлена и не имеет значения по умолчанию, Claude Code оставляет буквальный текст `${VAR}` в значении и сообщает предупреждение об отсутствующей переменной для этого server. Конфигурация все еще загружается, поэтому установите переменную или добавьте резервное значение `:-default`, чтобы server запустился с предполагаемым значением.

468 471 

469<h2 id="practical-examples">472<h2 id="practical-examples">

470 Практические примеры473 Практические примеры


552 555 

553Многие облачные MCP servers требуют аутентификации. Claude Code поддерживает OAuth 2.0 для безопасных соединений.556Многие облачные MCP servers требуют аутентификации. Claude Code поддерживает OAuth 2.0 для безопасных соединений.

554 557 

555Claude Code отмечает удаленный server как требующий аутентификации, когда server отвечает с `401 Unauthorized` или `403 Forbidden`. Любой из этих кодов состояния отмечает server в `/mcp`, чтобы вы могли завершить поток OAuth.558Claude Code отмечает удаленный server как требующий аутентификации, когда server отвечает с `401 Unauthorized` или `403 Forbidden`. Для server, на который вы еще не вошли, любой из этих кодов состояния отмечает его в `/mcp`, чтобы вы могли завершить поток OAuth.

559 

560Когда запрос к OAuth server, на который вы уже вошли, возвращает `401 Unauthorized`, Claude Code обновляет сохраненный токен, переподключается и повторяет запрос один раз. Он отмечает server в `/mcp` только если этот повторный запрос также не удается. До v2.1.206 обновление токена, которое не удалось по временной причине, такой как ошибка сети, отмечало OAuth server как требующий аутентификации для остальной части сеанса, даже если его токен обновления был все еще действителен.

556 561 

557Начиная с v2.1.195, когда обновление токена не удается, потому что server отклоняет сохраненный токен обновления, Claude Code немедленно показывает уведомление, указывающее на `/mcp`. Меню подключенного server там предлагает Re-authenticate, чтобы вы могли снова войти перед следующим вызовом инструмента.562Начиная с v2.1.195, когда обновление токена не удается, потому что server отклоняет сохраненный токен обновления, Claude Code немедленно показывает уведомление, указывающее на `/mcp`. Меню подключенного server там предлагает Re-authenticate, чтобы вы могли снова войти перед следующим вызовом инструмента.

558 563 


787**Требования:**792**Требования:**

788 793 

789* Команда должна записать объект JSON пар строк ключ-значение в stdout794* Команда должна записать объект JSON пар строк ключ-значение в stdout

790* Команда запускается в оболочке с timeout в 10 секунд795* Команда запускается в оболочке с timeout в 10 секунд, из текущего рабочего каталога сеанса. Используйте абсолютный путь или команду на `PATH` для скрипта

791* Динамические заголовки переопределяют любые статические `headers` с тем же именем796* Динамические заголовки переопределяют любые статические `headers` с тем же именем

792 797 

793Помощник запускается заново при каждом подключении (при запуске сеанса и при переподключении). Кэширования нет, поэтому ваш скрипт отвечает за любое повторное использование токена.798Помощник запускается заново при каждом подключении (при запуске сеанса и при переподключении). Кэширования нет, поэтому ваш скрипт отвечает за любое повторное использование токена.


806 811 

807Для server, предоставленного плагином, помощник также запускается с его рабочим каталогом, установленным в корень плагина, поэтому относительный путь `headersHelper` разрешается внутри каталога плагина, а не в рабочем каталоге сеанса. Требует Claude Code v2.1.195 или позже.812Для server, предоставленного плагином, помощник также запускается с его рабочим каталогом, установленным в корень плагина, поэтому относительный путь `headersHelper` разрешается внутри каталога плагина, а не в рабочем каталоге сеанса. Требует Claude Code v2.1.195 или позже.

808 813 

814Помощник `headersHelper`, предоставленный плагином, не может ссылаться на значения [`${user_config.*}`](/ru/plugins-reference#user-configuration) плагина, потому что команда запускается через оболочку. Claude Code сообщает о server как о неправильно настроенном с [ошибкой](/ru/errors#plugin-command-references-user-config) и не подставляет значение. Поместите `${user_config.KEY}` в поле `headers` server вместо этого, которое не анализируется оболочкой, или попросите скрипт помощника прочитать значение из своего собственного окружения или файла конфигурации. До v2.1.207 `headersHelper` подставлял значения `${user_config.*}`.

815 

809<Note>816<Note>

810 `headersHelper` выполняет произвольные команды оболочки. Когда определено в области проекта или локальной области, он запускается только после того, как вы примете диалог доверия рабочей области.817 `headersHelper` выполняет произвольные команды оболочки. Когда определено в области проекта или локальной области, он запускается только после того, как вы примете диалог доверия рабочей области.

811</Note>818</Note>


889 Используйте MCP servers из claude.ai896 Используйте MCP servers из claude.ai

890</h2>897</h2>

891 898 

892Если вы вошли в Claude Code с учетной записью [claude.ai](https://claude.ai), MCP servers, которые вы добавили в claude.ai, автоматически доступны в Claude Code:899Если вы вошли в Claude Code с учетной записью [claude.ai](https://claude.ai), MCP servers, которые вы добавили в claude.ai, известные как [connectors](https://claude.com/docs/connectors), автоматически доступны в Claude Code:

893 900 

894<Steps>901<Steps>

895 <Step title="Настройте MCP servers в claude.ai">902 <Step title="Настройте MCP servers в claude.ai">


921 928 

922Некоторые размещенные Anthropic коннекторы, такие как Microsoft 365, Gmail и Google Calendar, не поддерживают локальный OAuth из Claude Code, потому что поставщик идентификации вышестоящего уровня принимает только URL перенаправления, который зарегистрировала claude.ai. Начиная с версии 2.1.162, аутентификация одного из этих хостов в `/mcp` показывает сообщение, направляющее вас подключить его в Settings → Connectors на claude.ai. После подключения там коннектор автоматически появляется в Claude Code.929Некоторые размещенные Anthropic коннекторы, такие как Microsoft 365, Gmail и Google Calendar, не поддерживают локальный OAuth из Claude Code, потому что поставщик идентификации вышестоящего уровня принимает только URL перенаправления, который зарегистрировала claude.ai. Начиная с версии 2.1.162, аутентификация одного из этих хостов в `/mcp` показывает сообщение, направляющее вас подключить его в Settings → Connectors на claude.ai. После подключения там коннектор автоматически появляется в Claude Code.

923 930 

931<h3 id="organization-controls-on-connector-tools">

932 Управление инструментами connector организацией

933</h3>

934 

935Ваша организация может устанавливать управление инструментами для каждого инструмента на [claude.ai connectors](https://claude.com/docs/connectors). Claude Code читает эти параметры при запуске и применяет их локально. Запустите `/mcp`, чтобы увидеть, какой параметр применяется к каждому инструменту на connector.

936 

937* **Инструмент установлен на `ask`**: Claude Code запрашивает при каждом вызове с причиной `Your organization requires approval for this tool`. Запрос появляется даже в режимах `acceptEdits`, `auto` и `bypassPermissions` [permission modes](/ru/permissions#permission-modes), и никогда не предлагает опцию запомнить ваш выбор. [Allow rules](/ru/permissions), которые соответствуют инструменту, также не пропускают запрос. В режиме `dontAsk`, который никогда не запрашивает, Claude Code вместо этого отклоняет вызов.

938* **Инструмент установлен на `blocked`**: Claude Code фильтрует инструмент перед тем, как Claude его увидит, поэтому он никогда не появляется в списке инструментов.

939 

940Применение этих управлений требует Claude Code версии 2.1.129 или позже. Более ранние версии игнорируют параметры и применяют стандартный поток разрешений.

941 

924<h3 id="disable-claude-ai-connectors">942<h3 id="disable-claude-ai-connectors">

925 Отключите коннекторы claude.ai943 Отключите коннекторы claude.ai

926</h3>944</h3>


1193 1211 

1194Tool search включен по умолчанию: инструменты MCP откладываются и обнаруживаются по требованию. Claude Code отключает его по умолчанию на Google Cloud's Agent Platform. Он также отключен, когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся первой стороной, так как большинство прокси не пересылают блоки `tool_reference`. Установите `ENABLE_TOOL_SEARCH` явно, чтобы переопределить любой резервный вариант.1212Tool search включен по умолчанию: инструменты MCP откладываются и обнаруживаются по требованию. Claude Code отключает его по умолчанию на Google Cloud's Agent Platform. Он также отключен, когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся первой стороной, так как большинство прокси не пересылают блоки `tool_reference`. Установите `ENABLE_TOOL_SEARCH` явно, чтобы переопределить любой резервный вариант.

1195 1213 

1196Tool search требует модель, которая поддерживает блоки `tool_reference`. Модели Haiku не поддерживают это. На Google Cloud's Agent Platform tool search поддерживается для Claude Sonnet 4.5 и позже и Claude Opus 4.5 и позже.1214Установка [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/ru/env-vars) сохраняет tool search отключенным, и `ENABLE_TOOL_SEARCH` не может его переопределить. Переменная удаляет заголовок бета-версии, который требуют определения инструментов `defer_loading` и блоки содержимого `tool_reference`.

1215 

1216Tool search требует модель, которая поддерживает блоки `tool_reference`: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 и более поздние модели. См. [совместимость моделей в документации API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool#model-compatibility) для текущего списка. На Google Cloud's Agent Platform tool search поддерживается для Claude Sonnet 4.5 и позже и Claude Opus 4.5 и позже.

1197 1217 

1198Управляйте поведением tool search с помощью переменной окружения `ENABLE_TOOL_SEARCH`:1218Управляйте поведением tool search с помощью переменной окружения `ENABLE_TOOL_SEARCH`:

1199 1219 

memory.md +4 −0

Details

257---257---

258```258```

259 259 

260Синтаксис Glob рассматривает `[` как начало выражения в скобках, такого как `[abc]`. Шаблон с `[`, который не может быть прочитан как выражение в скобках, такой как `photos [2024/**`, является недействительным: он ничему не соответствует, и другие шаблоны правила продолжают работать. Чтобы сопоставить буквальный `[` в имени файла, экранируйте его как `photos \[2024/**`. {/* min-version: 2.1.207 */}До версии 2.1.207 один недействительный шаблон приводил к сбою инструмента Read для каждого файла, для которого оценивалось правило, вместо того чтобы ничему не соответствовать.

261 

260<h4 id="share-rules-across-projects-with-symlinks">262<h4 id="share-rules-across-projects-with-symlinks">

261 Делитесь правилами между проектами с помощью symlinks263 Делитесь правилами между проектами с помощью symlinks

262</h4>264</h4>


474 476 

475Файлы более 200 строк потребляют больше контекста и могут снизить соблюдение. Используйте [правила с областью действия пути](#path-specific-rules) для загрузки инструкций только когда Claude работает с соответствующими файлами, или сократите содержимое, которое не требуется в каждом сеансе. Разделение на [`@path` импорты](#import-additional-files) помогает организации, но не снижает контекст, так как импортированные файлы загружаются при запуске.477Файлы более 200 строк потребляют больше контекста и могут снизить соблюдение. Используйте [правила с областью действия пути](#path-specific-rules) для загрузки инструкций только когда Claude работает с соответствующими файлами, или сократите содержимое, которое не требуется в каждом сеансе. Разделение на [`@path` импорты](#import-additional-files) помогает организации, но не снижает контекст, так как импортированные файлы загружаются при запуске.

476 478 

479{/* min-version: 2.1.206 */}Проверка [`/doctor`](/ru/commands#all-commands) предлагает сокращения для проверенного CLAUDE.md: она удаляет содержимое, которое Claude может вывести из кодовой базы, такое как макеты каталогов, списки зависимостей и обзоры архитектуры, и сохраняет подводные камни, обоснование и соглашения, которые отличаются от стандартных инструментов. Проверка сокращения требует Claude Code v2.1.206 или более поздней версии.

480 

477<h3 id="instructions-seem-lost-after-/compact">481<h3 id="instructions-seem-lost-after-/compact">

478 Инструкции кажутся потерянными после `/compact`482 Инструкции кажутся потерянными после `/compact`

479</h3>483</h3>

Details

104 104 

1051. Перейдите на [портал Microsoft Foundry](https://ai.azure.com/)1051. Перейдите на [портал Microsoft Foundry](https://ai.azure.com/)

1062. Создайте новый ресурс, отметив имя вашего ресурса1062. Создайте новый ресурс, отметив имя вашего ресурса

1073. Создайте развертывания для моделей Claude:1073. Создайте развертывания для моделей Claude, отметив имя развертывания, которое вы даете каждому; вы установите эти имена как переменные модели на шаге 4:

108 * Claude Opus108 * Claude Opus

109 * Claude Sonnet109 * Claude Sonnet

110 * Claude Haiku110 * Claude Haiku


1201. Перейдите к вашему ресурсу на портале Microsoft Foundry1201. Перейдите к вашему ресурсу на портале Microsoft Foundry

1212. Перейдите в раздел **Endpoints and keys**1212. Перейдите в раздел **Endpoints and keys**

1223. Скопируйте **API Key**1223. Скопируйте **API Key**

1234. Установите переменную окружения:1234. Установите переменную окружения, заменив `your-azure-api-key` на скопированный ключ:

124 124 

125```bash theme={null}125```bash theme={null}

126export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key126export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key


209 209 

210Claude Code читает `CLAUDE_CODE_USE_FOUNDRY` и другие переменные Microsoft Foundry из окружения и подключается к вашему ресурсу Azure при первом запросе. В отличие от Amazon Bedrock и Google Cloud's Agent Platform, Microsoft Foundry не имеет интерактивного мастера установки, поэтому переменные окружения на шагах 3 и 4 являются единственным путем конфигурации.210Claude Code читает `CLAUDE_CODE_USE_FOUNDRY` и другие переменные Microsoft Foundry из окружения и подключается к вашему ресурсу Azure при первом запросе. В отличие от Amazon Bedrock и Google Cloud's Agent Platform, Microsoft Foundry не имеет интерактивного мастера установки, поэтому переменные окружения на шагах 3 и 4 являются единственным путем конфигурации.

211 211 

212Чтобы проверить вашу установку, запустите `/status` внутри Claude Code. Строка поставщика API показывает `Microsoft Foundry` вместе с именем ресурса или базовым URL-адресом, который вы настроили.

213 

212<h2 id="azure-rbac-configuration">214<h2 id="azure-rbac-configuration">

213 Конфигурация Azure RBAC215 Конфигурация Azure RBAC

214</h2>216</h2>


239 241 

240* Настройте Entra ID в среде или установите `ANTHROPIC_FOUNDRY_API_KEY`.242* Настройте Entra ID в среде или установите `ANTHROPIC_FOUNDRY_API_KEY`.

241 243 

244Если запросы завершаются с ошибками повторного подключения на первом запросе:

245 

246* Проверьте, что `ANTHROPIC_FOUNDRY_RESOURCE` установлен на ваше фактическое имя ресурса, а не на заполнитель. Claude Code создает URL конечной точки из этого значения, поэтому неправильное имя указывает на хост, который не существует.

247 

242<h2 id="additional-resources">248<h2 id="additional-resources">

243 Дополнительные ресурсы249 Дополнительные ресурсы

244</h2>250</h2>

model-config.md +25 −16

Details

19 * Microsoft Foundry: имя развертывания19 * Microsoft Foundry: имя развертывания

20 * Google Cloud's Agent Platform: имя версии20 * Google Cloud's Agent Platform: имя версии

21 21 

22Рекомендации по выбору модели и уровня усилий, подходящих для различных видов работы, см. в статье [Выбор модели Claude и уровня усилий в Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) в блоге.

23 

22<Note>24<Note>

23 `ANTHROPIC_BASE_URL` изменяет, куда отправляются запросы, а не какая модель на них отвечает. Чтобы маршрутизировать Claude через шлюз LLM, см. [шлюзы LLM](/ru/llm-gateway).25 `ANTHROPIC_BASE_URL` изменяет, куда отправляются запросы, а не какая модель на них отвечает. Чтобы маршрутизировать Claude через шлюз LLM, см. [шлюзы LLM](/ru/llm-gateway).

24</Note>26</Note>


30Псевдонимы моделей предоставляют удобный способ выбора параметров модели без необходимости запоминать точные номера версий:32Псевдонимы моделей предоставляют удобный способ выбора параметров модели без необходимости запоминать точные номера версий:

31 33 

32| Псевдоним модели | Поведение |34| Псевдоним модели | Поведение |

33| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |35| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

34| **`default`** | Специальное значение, которое очищает любое переопределение модели и возвращается к рекомендуемой модели для типа вашей учетной записи, или к [модели по умолчанию организации](#organization-default-model), когда администратор установил её. Сам по себе не является псевдонимом модели |36| **`default`** | Специальное значение, которое очищает любое переопределение модели и возвращается к рекомендуемой модели для типа вашей учетной записи, или к [модели по умолчанию организации](#organization-default-model), когда администратор установил её. Сам по себе не является псевдонимом модели |

35| **`best`** | Использует Fable 5, где ваша организация имеет к нему доступ, в противном случае последнюю модель Opus |37| **`best`** | Использует Fable 5, где ваша организация имеет к нему доступ, в противном случае последнюю модель Opus |

36| **`fable`** | Использует Claude Fable 5 для ваших самых сложных и долгоживущих задач |38| **`fable`** | Использует Claude Fable 5 для ваших самых сложных и долгоживущих задач |

37| **`sonnet`** | Использует последнюю модель Sonnet для ежедневных задач кодирования |39| **`sonnet`** | Использует последнюю модель Sonnet для ежедневных задач кодирования |

38| **`opus`** | Использует последнюю модель Opus для сложных задач рассуждения |40| **`opus`** | Использует последнюю модель Opus для сложных задач рассуждения |

39| **`haiku`** | Использует быструю и эффективную модель Haiku для простых задач |41| **`haiku`** | Использует быструю и эффективную модель Haiku для простых задач |

40| **`sonnet[1m]`** | Использует Sonnet с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/ru/build-with-claude/context-windows#1m-token-context-window) для длительных сеансов. Не имеет эффекта, когда `sonnet` уже разрешается в Sonnet 5 с его собственным окном 1M; за [LLM gateway](/ru/llm-gateway) выбирает окно 1M для Sonnet 5 |42| **`sonnet[1m]`** | Использует Sonnet с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/ru/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов. Не имеет эффекта, когда `sonnet` уже разрешается в Sonnet 5 с его собственным окном 1M; за [LLM gateway](/ru/llm-gateway) выбирает окно 1M для Sonnet 5 |

41| **`opus[1m]`** | Использует Opus с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/ru/build-with-claude/context-windows#1m-token-context-window) для длительных сеансов |43| **`opus[1m]`** | Использует Opus с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/ru/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов |

42| **`opusplan`** | Специальный режим, который использует `opus` во время режима плана, а затем переключается на `sonnet` для выполнения |44| **`opusplan`** | Специальный режим, который использует `opus` во время режима плана, а затем переключается на `sonnet` для выполнения |

43 45 

44На что разрешается каждый псевдоним, зависит от поставщика:46Версия, на которую разрешаются псевдонимы `opus` и `sonnet`, зависит от поставщика:

45 47 

46* **Anthropic API**: `opus` разрешается в Opus 4.8, а `sonnet` разрешается в Sonnet 5.48| Поставщик | `opus` | `sonnet` |

47* **[Claude Platform on AWS](/ru/claude-platform-on-aws)**: `opus` разрешается в Opus 4.8, а `sonnet` разрешается в Sonnet 4.6.49| :--------------------------------------------------- | :------- | :--------- |

48* **Amazon Bedrock и Google Cloud's Agent Platform**: `opus` разрешается в Opus 4.8, а `sonnet` разрешается в Sonnet 4.5.50| Anthropic API | Opus 4.8 | Sonnet 5 |

49* **Microsoft Foundry**: `opus` разрешается в Opus 4.6, а `sonnet` разрешается в Sonnet 4.5.51| [Claude Platform on AWS](/ru/claude-platform-on-aws) | Opus 4.8 | Sonnet 4.6 |

52| Amazon Bedrock, Google Cloud's Agent Platform | Opus 4.8 | Sonnet 4.5 |

53| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 |

50 54 

51Если псевдоним разрешается в более старую модель, более новые модели доступны путем явного выбора полного имени модели или установки `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`.55Если псевдоним разрешается в более старую модель, более новые модели доступны путем явного выбора полного имени модели или установки `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`.

52 56 

57{/* min-version: 2.1.207 */}До версии v2.1.207 `opus` разрешался в Opus 4.7 на Claude Platform on AWS и в Opus 4.6 на Amazon Bedrock и Google Cloud's Agent Platform.

58 

53Псевдонимы указывают на рекомендуемую версию для вашего поставщика и обновляются со временем. Чтобы закрепить определенную версию, используйте полное имя модели, например `claude-opus-4-8`, или установите соответствующую переменную окружения, такую как `ANTHROPIC_DEFAULT_OPUS_MODEL`.59Псевдонимы указывают на рекомендуемую версию для вашего поставщика и обновляются со временем. Чтобы закрепить определенную версию, используйте полное имя модели, например `claude-opus-4-8`, или установите соответствующую переменную окружения, такую как `ANTHROPIC_DEFAULT_OPUS_MODEL`.

54 60 

55<Note>61<Note>


97 103 

98Флаг `--model` и переменная окружения `ANTHROPIC_MODEL` применяются только к сеансу, с которым вы их запускаете. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждый с собственным флагом `--model` вместо переключения с помощью `/model`.104Флаг `--model` и переменная окружения `ANTHROPIC_MODEL` применяются только к сеансу, с которым вы их запускаете. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждый с собственным флагом `--model` вместо переключения с помощью `/model`.

99 105 

106Цены в средстве выбора `/model` отображаются, когда Claude Code взаимодействует с Anthropic API, напрямую или через [шлюз LLM](/ru/llm-gateway), который его проксирует, и цена в строке — это цена модели, которую выбирает эта строка. На [сторонних поставщиках](/ru/third-party-integrations), таких как Amazon Bedrock, и на [шлюзе приложений Claude](/ru/claude-apps-gateway), ваш поставщик или шлюз определяет, что вы платите, поэтому строки средства выбора не показывают цену. Цена — это только метка отображения; она не влияет на то, какую модель выбирает строка, или на то, что ваш поставщик выставляет счет. До версии v2.1.206 [Claude Platform on AWS](/ru/claude-platform-on-aws) и сеансы шлюза показывали цены в списке Anthropic, и строка могла показывать цену другой модели, чем та, которую она выбирала.

107 

100Возобновленные сеансы, запущенные с `claude --resume`, `--continue` или средством выбора `/resume`, сохраняют модель, которую они использовали при сохранении стенограммы, независимо от текущего параметра `model`. Если эта модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сеанс переходит к обычному порядку приоритета. Это предотвращает изменение модели при возобновлении выбором `/model` другого сеанса.108Возобновленные сеансы, запущенные с `claude --resume`, `--continue` или средством выбора `/resume`, сохраняют модель, которую они использовали при сохранении стенограммы, независимо от текущего параметра `model`. Если эта модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сеанс переходит к обычному порядку приоритета. Это предотвращает изменение модели при возобновлении выбором `/model` другого сеанса.

101 109 

102Модель, которую вы выбираете для нового запуска с `--model` или `ANTHROPIC_MODEL`, по-прежнему имеет приоритет над восстановленной моделью. {/* min-version: 2.1.195 */}Начиная с версии v2.1.195, то же самое относится к переменной семейства [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables).110Модель, которую вы выбираете для нового запуска с `--model` или `ANTHROPIC_MODEL`, по-прежнему имеет приоритет над восстановленной моделью. {/* min-version: 2.1.195 */}Начиная с версии v2.1.195, то же самое относится к переменной семейства [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables).


345Поведение `default` зависит от типа вашей учетной записи:353Поведение `default` зависит от типа вашей учетной записи:

346 354 

347* **Max, Team Premium, Enterprise с оплатой по мере использования и Anthropic API**: по умолчанию Opus 4.8355* **Max, Team Premium, Enterprise с оплатой по мере использования и Anthropic API**: по умолчанию Opus 4.8

348* **Claude Platform на AWS**: по умолчанию Opus 4.8356* **Claude Platform на AWS, Amazon Bedrock и Google Cloud's Agent Platform**: по умолчанию Opus 4.8

349* **Pro, Team Standard и места Enterprise подписки**: по умолчанию Sonnet 5357* **Pro, Team Standard и места Enterprise подписки**: по умолчанию Sonnet 5

350* **Amazon Bedrock и Google Cloud's Agent Platform**: по умолчанию Opus 4.8

351* **Microsoft Foundry**: по умолчанию Sonnet 4.5358* **Microsoft Foundry**: по умолчанию Sonnet 4.5

352 359 

353Enterprise с оплатой по мере использования означает организацию Enterprise, выставляемую счет по использованию, а не по месту подписки.360Enterprise с оплатой по мере использования означает организацию Enterprise, выставляемую счет по использованию, а не по месту подписки.

354 361 

362{/* min-version: 2.1.207 */}До v2.1.207 `default` разрешался в Opus 4.7 на Claude Platform на AWS и в Sonnet 4.5 на Amazon Bedrock и Google Cloud's Agent Platform.

363 

355Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается к этой модели вместо значения по умолчанию для типа учётной записи выше. Требует Claude Code v2.1.196 или более поздней версии.364Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается к этой модели вместо значения по умолчанию для типа учётной записи выше. Требует Claude Code v2.1.196 или более поздней версии.

356 365 

357Когда управляемые параметры [применяют список разрешений для модели Default](#enforce-the-allowlist-for-the-default-model) и значение по умолчанию для типа учетной записи отсутствует в `availableModels`, `default` разрешается в применяемый Default вместо значения по умолчанию для типа учетной записи выше. Когда применяются оба, модель по умолчанию организации сначала заменяет значение по умолчанию для типа учётной записи, а затем применяется применение: разрешённое значение по умолчанию организации сохраняется, в то время как значение вне списка разрешается в применяемый Default.366Когда управляемые параметры [применяют список разрешений для модели Default](#enforce-the-allowlist-for-the-default-model) и значение по умолчанию для типа учетной записи отсутствует в `availableModels`, `default` разрешается в применяемый Default вместо значения по умолчанию для типа учетной записи выше. Когда применяются оба, модель по умолчанию организации сначала заменяет значение по умолчанию для типа учётной записи, а затем применяется применение: разрешённое значение по умолчанию организации сохраняется, в то время как значение вне списка разрешается в применяемый Default.


412 421 

413Этот раздел охватывает резервный вариант на основе содержимого из Fable 5. Для резервного варианта на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).422Этот раздел охватывает резервный вариант на основе содержимого из Fable 5. Для резервного варианта на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).

414 423 

415Fable 5 работает с классификаторами безопасности для содержимого кибербезопасности и биологии. Когда классификатор помечает запрос, Claude Code повторно запускает этот запрос на Opus 4.8 и показывает уведомление в стенограмме.424Fable 5 работает с классификаторами безопасности для содержимого кибербезопасности и биологии. Когда классификатор помечает запрос, Claude Code повторно запускает этот запрос на модели Opus вашего поставщика по умолчанию и показывает уведомление в стенограмме. На Anthropic API, развертываниях [LLM gateway](/ru/llm-gateway) и [Claude Platform на AWS](/ru/claude-platform-on-aws) эта модель — Opus 4.8. На [шлюзе приложений Claude](/ru/claude-apps-gateway) это Opus 4.7, если вы не указываете [псевдоним `opus`](#environment-variables) на другую модель.

416 425 

417Сеанс затем продолжается на этой модели Opus. Чтобы вернуться к Fable 5, запустите `/model fable`.426Сеанс затем продолжается на этой модели Opus. Чтобы вернуться к Fable 5, запустите `/model fable`.

418 427 


564 Расширенный контекст573 Расширенный контекст

565</h3>574</h3>

566 575 

567Fable 5, Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6, поддерживают [контекстное окно в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window) для длительных сеансов с большими кодовыми базами.576Fable 5, Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6, поддерживают [контекстное окно в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов с большими кодовыми базами.

568 577 

569Доступность варьируется в зависимости от модели и плана. На Anthropic API Fable 5, Sonnet 5, Opus 4.8 и Opus 4.7 всегда работают с окном 1M. На планах Max, Team и Enterprise Opus автоматически обновляется до контекста 1M без дополнительной конфигурации. Это применяется как к местам Team Standard, так и к Team Premium. Sonnet 4.6 с контекстом 1M не входит в автоматическое обновление и требует [дополнительного использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) на каждом плане подписки, включая Max.578Доступность варьируется в зависимости от модели и плана. На Anthropic API Fable 5, Sonnet 5, Opus 4.8 и Opus 4.7 всегда работают с окном 1M. На планах Max, Team и Enterprise Opus автоматически обновляется до контекста 1M без дополнительной конфигурации. Это применяется как к местам Team Standard, так и к Team Premium. Sonnet 4.6 с контекстом 1M не входит в автоматическое обновление и требует [дополнительного использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) на каждом плане подписки, включая Max.

570 579 


636Вы можете использовать следующие переменные окружения для управления именами моделей, на которые отображаются псевдонимы. Каждое значение должно быть полным именем модели или эквивалентным идентификатором для вашего поставщика API.645Вы можете использовать следующие переменные окружения для управления именами моделей, на которые отображаются псевдонимы. Каждое значение должно быть полным именем модели или эквивалентным идентификатором для вашего поставщика API.

637 646 

638| Переменная окружения | Описание |647| Переменная окружения | Описание |

639| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |648| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

640| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Модель для использования для `fable`, и идентификатор модели, который Claude Code распознает как Fable 5 для [автоматического переключения модели](#automatic-model-fallback) у поставщиков третьих сторон |649| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Модель для использования для `fable`, и идентификатор модели, который Claude Code распознает как Fable 5 для [автоматического переключения модели](#automatic-model-fallback) у поставщиков третьих сторон |

641| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Модель для использования для `opus`, или для `opusplan` при активном Plan Mode. |650| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Модель для использования для `opus`, или для `opusplan` при активном Plan Mode. |

642| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Модель для использования для `sonnet`, или для `opusplan` при неактивном Plan Mode. |651| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Модель для использования для `sonnet`, или для `opusplan` при неактивном Plan Mode. |

643| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Модель для использования для `haiku`, или [фоновой функциональности](/ru/costs#background-token-usage) |652| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Модель для использования для `haiku`, или [фоновой функциональности](/ru/costs#background-token-usage) |

644| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель для использования для всех [subagents](/ru/sub-agents#choose-a-model) и [agent teams](/ru/agent-teams). Переопределяет как параметр `model` для каждого вызова, так и frontmatter `model` определения subagent. Установите на `inherit` для использования обычного разрешения модели вместо этого |653| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель для использования для всех [subagents](/ru/sub-agents#choose-a-model), [agent teams](/ru/agent-teams) и агентов, которые запускает [workflow](/ru/workflows). Принимает псевдоним, такой как `haiku`, или полное имя модели, и переопределяет параметр `model` для каждого вызова и frontmatter `model` определения subagent. Установите на `inherit` для использования обычного разрешения модели вместо этого |

645 654 

646Примечание: `ANTHROPIC_SMALL_FAST_MODEL` устарел в пользу `ANTHROPIC_DEFAULT_HAIKU_MODEL`.655Примечание: `ANTHROPIC_SMALL_FAST_MODEL` устарел в пользу `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

647 656 


651 660 

652При развертывании Claude Code через [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry) или [Claude Platform on AWS](/ru/claude-platform-on-aws) закрепите версии моделей перед развертыванием для пользователей.661При развертывании Claude Code через [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry) или [Claude Platform on AWS](/ru/claude-platform-on-aws) закрепите версии моделей перед развертыванием для пользователей.

653 662 

654Без закрепления Claude Code использует псевдонимы моделей, такие как `fable`, `opus`, `sonnet` и `haiku`, которые разрешаются в встроенный идентификатор модели по умолчанию для каждого поставщика. Это значение по умолчанию может отставать от последнего выпуска Anthropic, и модель, на которую оно указывает, может быть еще не включена в учетную запись пользователя. Когда значение по умолчанию недоступно, пользователи Amazon Bedrock и Google Cloud's Agent Platform видят уведомление и возвращаются к предыдущей версии для этого сеанса, в то время как пользователи Microsoft Foundry видят ошибки, потому что Microsoft Foundry не имеет эквивалентной проверки при запуске.663Без закрепления Claude Code использует псевдонимы моделей, такие как `fable`, `opus`, `sonnet` и `haiku`, которые разрешаются в встроенный идентификатор модели по умолчанию для каждого поставщика. Это значение по умолчанию может отставать от последнего выпуска Anthropic, и модель, на которую оно указывает, может быть еще не включена в учетную запись пользователя. Когда значение по умолчанию недоступно, пользователи Amazon Bedrock и Google Cloud's Agent Platform видят уведомление и сеанс переходит на более раннюю версию модели по умолчанию, или на модель Sonnet по умолчанию, когда значение по умолчанию является моделью Opus и нет доступной версии Opus. Пользователи Microsoft Foundry видят ошибки вместо этого, потому что Microsoft Foundry не имеет эквивалентной проверки при запуске.

655 664 

656<Warning>665<Warning>

657 Установите переменные окружения модели на конкретные идентификаторы версий как часть вашей начальной настройки. Закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.666 Установите переменные окружения модели на конкретные идентификаторы версий как часть вашей начальной настройки. Закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.


676Суффикс `[1m]` применяет контекстное окно 1M ко всему использованию псевдонимов `opus` и `sonnet`, включая фазу Opus в режиме плана [`opusplan`](#opusplan-model-setting).685Суффикс `[1m]` применяет контекстное окно 1M ко всему использованию псевдонимов `opus` и `sonnet`, включая фазу Opus в режиме плана [`opusplan`](#opusplan-model-setting).

677 686 

678* Claude Code удаляет суффикс перед отправкой идентификатора модели вашему поставщику.687* Claude Code удаляет суффикс перед отправкой идентификатора модели вашему поставщику.

679* Добавляйте `[1m]` только когда базовая модель [поддерживает контекст 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window).688* Добавляйте `[1m]` только когда базовая модель [поддерживает контекст 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model).

680* Суффикс читается для каждой переменной, а не для каждой модели. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификатор модели без `[1m]` в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом. Sonnet 5 всегда работает с окном 1M на этих поставщиках и никогда не требует суффикса.689* Суффикс читается для каждой переменной, а не для каждой модели. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификатор модели без `[1m]` в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом. Sonnet 5 всегда работает с окном 1M на этих поставщиках и никогда не требует суффикса.

681 690 

682<Note>691<Note>

Details

119Claude Code требует доступ к следующим URL. Добавьте их в белый список в конфигурации прокси и правилах брандмауэра, особенно в контейнеризованных или ограниченных сетевых средах.119Claude Code требует доступ к следующим URL. Добавьте их в белый список в конфигурации прокси и правилах брандмауэра, особенно в контейнеризованных или ограниченных сетевых средах.

120 120 

121| URL | Требуется для |121| URL | Требуется для |

122| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |122| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

123| `api.anthropic.com` | Запросы Claude API |123| `api.anthropic.com` | Запросы Claude API |

124| `claude.ai` | Аутентификация учетной записи claude.ai |124| `claude.ai` | Аутентификация учетной записи claude.ai |

125| `platform.claude.com` | Аутентификация учетной записи Anthropic Console |125| `platform.claude.com` | Аутентификация учетной записи Anthropic Console |

126| `mcp-proxy.anthropic.com` | [MCP connectors из claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai), включая connectors, которые настраивает администратор организации. Трафик Connector маршрутизируется через этот прокси; connectors включены по умолчанию для пользователей, прошедших аутентификацию через claude.ai. Чтобы отключить, установите [`ENABLE_CLAUDEAI_MCP_SERVERS=false`](/ru/env-vars) или параметр [`disableClaudeAiConnectors`](/ru/settings#available-settings) |

126| `downloads.claude.ai` | Загрузки исполняемых файлов плагинов; встроенный установщик и встроенное автоматическое обновление |127| `downloads.claude.ai` | Загрузки исполняемых файлов плагинов; встроенный установщик и встроенное автоматическое обновление |

128| `storage.googleapis.com` | Счетчики установок и метаданные плагинов, отображаемые в `/plugin`. Подписанные [artifact](/ru/artifacts) загрузки сначала пытаются использовать этот хост; публикация переходит на `api.anthropic.com`, когда он заблокирован |

127| `storage.googleapis.com` | {/* max-version: 2.1.115 */}Встроенный установщик и встроенное автоматическое обновление в версиях до 2.1.116 |129| `storage.googleapis.com` | {/* max-version: 2.1.115 */}Встроенный установщик и встроенное автоматическое обновление в версиях до 2.1.116 |

128| `bridge.claudeusercontent.com` | Мост WebSocket расширения [Claude в Chrome](/ru/chrome) |130| `bridge.claudeusercontent.com` | Мост WebSocket расширения [Claude в Chrome](/ru/chrome) |

129| `*.claudeusercontent.com` | Просмотр [артефактов](/ru/artifacts) на claude.ai. Средство просмотра загружает содержимое каждого артефакта из изолированного поддомена этого источника. Требуется в браузере средства просмотра, а не в самом CLI |131| `*.claudeusercontent.com` | Просмотр [артефактов](/ru/artifacts) на claude.ai. Средство просмотра загружает содержимое каждого артефакта из изолированного поддомена этого источника. Требуется в браузере средства просмотра, а не в самом CLI |

130| `raw.githubusercontent.com` | Лента журнала изменений для [`/release-notes`](/ru/commands) и примечания к выпуску, отображаемые после обновления; счетчики установок в маркетплейсе плагинов |132| `raw.githubusercontent.com` | Лента журнала изменений для [`/release-notes`](/ru/commands) и примечания к выпуску, отображаемые после обновления |

131 133 

132Если вы устанавливаете Claude Code через npm или управляете собственным распределением бинарных файлов, конечным пользователям может не потребоваться доступ к `downloads.claude.ai` или `storage.googleapis.com`.134Если вы устанавливаете Claude Code через npm или управляете собственным распределением бинарных файлов, конечным пользователям не требуется встроенный установщик и встроенное автоматическое обновление из `downloads.claude.ai`. Остальные использования в таблице применяются независимо от метода установки.

133 135 

134Claude Code также отправляет дополнительную операционную телеметрию по умолчанию, которую вы можете отключить с помощью переменных окружения. См. [Услуги телеметрии](/ru/data-usage#telemetry-services), чтобы узнать, как отключить её перед окончательным формированием вашего белого списка.136Claude Code также отправляет дополнительную операционную телеметрию по умолчанию, которую вы можете отключить с помощью переменных окружения. См. [Услуги телеметрии](/ru/data-usage#telemetry-services), чтобы узнать, как отключить её перед окончательным формированием вашего белого списка.

135 137 


139 141 

140Для самостоятельно размещаемых экземпляров [GitHub Enterprise Server](/ru/github-enterprise-server) за брандмауэром добавьте в белый список те же [IP-адреса Anthropic API](https://platform.claude.com/docs/en/api/ip-addresses), чтобы инфраструктура Anthropic могла достичь вашего хоста GHES для клонирования репозиториев и публикации комментариев к рецензиям.142Для самостоятельно размещаемых экземпляров [GitHub Enterprise Server](/ru/github-enterprise-server) за брандмауэром добавьте в белый список те же [IP-адреса Anthropic API](https://platform.claude.com/docs/en/api/ip-addresses), чтобы инфраструктура Anthropic могла достичь вашего хоста GHES для клонирования репозиториев и публикации комментариев к рецензиям.

141 143 

144<h3 id="desktop-and-claude-ai">

145 Desktop и claude.ai

146</h3>

147 

148Предыдущая таблица в основном охватывает автономный CLI. Приложение Claude Desktop и claude.ai в браузере загружают код приложения с дополнительных хостов CDN Anthropic, включая `assets-proxy.anthropic.com`. Разрешение `claude.ai` при блокировке этих хостов приводит к пустой странице, а не к ошибке. См. [требования к доступу в сети](/ru/desktop#network-access-requirements) на странице Desktop.

149 

142<h2 id="additional-resources">150<h2 id="additional-resources">

143 Дополнительные ресурсы151 Дополнительные ресурсы

144</h2>152</h2>

overview.md +1 −0

Details

246* [Quickstart](/ru/quickstart): пройдите через вашу первую реальную задачу, от изучения кодовой базы до коммита исправления246* [Quickstart](/ru/quickstart): пройдите через вашу первую реальную задачу, от изучения кодовой базы до коммита исправления

247* [Сохраняйте инструкции и воспоминания](/ru/memory): дайте Claude постоянные инструкции с файлами CLAUDE.md и auto memory247* [Сохраняйте инструкции и воспоминания](/ru/memory): дайте Claude постоянные инструкции с файлами CLAUDE.md и auto memory

248* [Common workflows](/ru/common-workflows) и [best practices](/ru/best-practices): шаблоны для получения максимума от Claude Code248* [Common workflows](/ru/common-workflows) и [best practices](/ru/best-practices): шаблоны для получения максимума от Claude Code

249* [A harness for every task](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code): как команда Claude Code использует [dynamic workflows](/ru/workflows) для организации подагентов в масштабе

249* [Settings](/ru/settings): настройте Claude Code для вашего рабочего процесса250* [Settings](/ru/settings): настройте Claude Code для вашего рабочего процесса

250* [Troubleshooting](/ru/troubleshooting): решения для распространенных проблем251* [Troubleshooting](/ru/troubleshooting): решения для распространенных проблем

251* [code.claude.com](https://code.claude.com/): демонстрации, цены и детали продукта252* [code.claude.com](https://code.claude.com/): демонстрации, цены и детали продукта

Details

16 16 

17| Режим | Что выполняется без запроса | Лучше всего для |17| Режим | Что выполняется без запроса | Лучше всего для |

18| :------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |18| :------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

19| `default` | Только чтение. Обозначен как **Manual** в CLI и расширениях IDE | Начало работы, чувствительная работа |19| `default` | Только чтение | Начало работы, чувствительная работа |

20| [`acceptEdits`](#auto-approve-file-edits-with-acceptedits-mode) | Чтение, редактирование файлов и распространённые команды файловой системы (`mkdir`, `touch`, `mv`, `cp` и т.д.) | Итерация по коду, который вы проверяете |20| [`acceptEdits`](#auto-approve-file-edits-with-acceptedits-mode) | Чтение, редактирование файлов и распространённые команды файловой системы (`mkdir`, `touch`, `mv`, `cp` и т.д.) | Итерация по коду, который вы проверяете |

21| [`plan`](#analyze-before-you-edit-with-plan-mode) | Только чтение | Изучение кодовой базы перед её изменением |21| [`plan`](#analyze-before-you-edit-with-plan-mode) | Только чтение | Изучение кодовой базы перед её изменением |

22| [`auto`](#eliminate-prompts-with-auto-mode) | Всё, с фоновыми проверками безопасности | Длительные задачи, снижение усталости от запросов |22| [`auto`](#eliminate-prompts-with-auto-mode) | Всё, с фоновыми проверками безопасности | Длительные задачи, снижение усталости от запросов |

23| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | Только предварительно одобренные инструменты | Заблокированные CI и скрипты |23| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | Только предварительно одобренные инструменты | Заблокированные CI и скрипты |

24| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | Всё | Только изолированные контейнеры и виртуальные машины |24| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | Всё | Только изолированные контейнеры и виртуальные машины |

25 25 

26Режим, который проверяет каждое действие, называется **Manual** в CLI, в `claude --help` и в расширениях VS Code и JetBrains. Его значение конфигурации — `default`, которое используют hooks и интеграции SDK. CLI принимает `manual` как псевдоним везде, где вы вводите значение, например `claude --permission-mode manual` или `"defaultMode": "manual"`. Метка Manual и псевдоним `manual` требуют Claude Code v2.1.200 или позже.26Режим, который проверяет каждое действие, называется **Manual** в CLI, в `claude --help`, в расширениях VS Code и JetBrains и в настольном приложении. Его значение конфигурации — `default`, которое используют hooks и интеграции SDK. CLI принимает `manual` как псевдоним везде, где вы вводите значение, например `claude --permission-mode manual` или `"defaultMode": "manual"`. Метка Manual и псевдоним `manual` требуют Claude Code v2.1.200 или позже. Метка настольного приложения не зависит от вашей версии CLI.

27 27 

28Во всех режимах, кроме `bypassPermissions`, записи в [защищённые пути](#protected-paths) никогда не одобряются автоматически, защищая состояние репозитория и собственную конфигурацию Claude от случайного повреждения.28Во всех режимах, кроме `bypassPermissions`, записи в [защищённые пути](#protected-paths) никогда не одобряются автоматически, защищая состояние репозитория и собственную конфигурацию Claude от случайного повреждения.

29 29 

30Режимы устанавливают базовое поведение. Наложите [правила разрешений](/ru/permissions#manage-permissions) сверху, чтобы предварительно одобрить или заблокировать определённые инструменты. Правила отказа и явные правила запроса применяются в каждом режиме, включая `bypassPermissions`. Правила разрешения не имеют эффекта в этом режиме, потому что всё остальное уже одобрено.30Режимы устанавливают базовое поведение. Наложите [правила разрешений](/ru/permissions#manage-permissions) сверху, чтобы предварительно одобрить или заблокировать определённые инструменты. Правила отказа, явные правила запроса, [параметр организации `ask` на инструментах соединителя](/ru/mcp#organization-controls-on-connector-tools) и маркер [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool) применяются в каждом режиме, включая `bypassPermissions`. Правила разрешения не имеют эффекта в этом режиме, потому что всё остальное уже одобрено.

31 31 

32<h2 id="switch-permission-modes">32<h2 id="switch-permission-modes">

33 Переключение режимов разрешений33 Переключение режимов разрешений


95 </Tab>95 </Tab>

96 96 

97 <Tab title="Desktop">97 <Tab title="Desktop">

98 Используйте селектор режима рядом с кнопкой отправки. Auto и Bypass permissions появляются только после того, как вы их включите в настройках Desktop. Подробности см. в [руководстве Desktop](/ru/desktop#choose-a-permission-mode).98 **Во время сеанса**: используйте селектор режима рядом с кнопкой отправки. Не все режимы появляются в селекторе:

99 

100 * **Auto**: появляется, когда ваша учётная запись соответствует [требованиям режима auto](#eliminate-prompts-with-auto-mode)

101 * **Bypass permissions**: требует переключателя **Allow bypass permissions mode** в настройках Desktop на планах Pro и Max; на планах Team и Enterprise это контролируется политикой организации

102 

103 Подробности, специфичные для desktop, см. в [Выбор режима разрешений](/ru/desktop#choose-a-permission-mode) в руководстве Desktop.

104 

105 **По умолчанию**: установите `defaultMode` в [settings](/ru/settings#settings-files). Приложение desktop читает те же файлы настроек, что и CLI, и применяет режим к новым локальным сеансам.

106 

107 Режим, который вы выбираете в селекторе режима, запоминается для каждой папки и имеет приоритет над `defaultMode` для этой папки. Plan является исключением: его выбор применяется только к текущему сеансу.

108 

109 Этот пример устанавливает режим Plan как значение по умолчанию для новых локальных сеансов:

110 

111 ```json theme={null}

112 {

113 "permissions": {

114 "defaultMode": "plan"

115 }

116 }

117 ```

99 </Tab>118 </Tab>

100 119 

101 <Tab title="Web and mobile">120 <Tab title="Web and mobile">


118 137 

119Режим `acceptEdits` позволяет Claude создавать и редактировать файлы в вашем рабочем каталоге без запроса. Строка состояния показывает `⏵⏵ accept edits on` пока этот режим активен.138Режим `acceptEdits` позволяет Claude создавать и редактировать файлы в вашем рабочем каталоге без запроса. Строка состояния показывает `⏵⏵ accept edits on` пока этот режим активен.

120 139 

121В дополнение к редактированию файлов, режим `acceptEdits` автоматически одобряет распространённые команды Bash файловой системы: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` и `sed`. Эти команды также автоматически одобряются при префиксе с безопасными переменными окружения, такими как `LANG=C` или `NO_COLOR=1`, или обёртками процессов, такими как `timeout`, `nice` или `nohup`. Как и редактирование файлов, автоматическое одобрение применяется только к путям внутри вашего рабочего каталога или `additionalDirectories`. Пути вне этой области, записи в [защищённые пути](#protected-paths) и все остальные команды Bash по-прежнему требуют запроса.140В дополнение к редактированию файлов, режим `acceptEdits` автоматически одобряет распространённые команды Bash файловой системы: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` и `sed`. Эти команды также автоматически одобряются при префиксе с безопасными переменными окружения, такими как `LANG=C` или `NO_COLOR=1`, или обёртками процессов, такими как `timeout`, `nice` или `nohup`. Как и редактирование файлов, автоматическое одобрение применяется только к путям внутри вашего рабочего каталога или `additionalDirectories`. Пути вне этой области, записи в [защищённые пути](#protected-paths) и все остальные команды Bash, кроме [встроенного набора только для чтения](/ru/permissions#read-only-commands), по-прежнему требуют запроса.

122 141 

123Когда инструмент [PowerShell](/ru/tools-reference#powershell-tool) включен, режим `acceptEdits` также автоматически одобряет `Set-Content`, `Add-Content`, `Clear-Content` и `Remove-Item` на путях в области действия, вместе с их распространёнными псевдонимами. Применяются те же правила области действия и защищённых путей.142Когда инструмент [PowerShell](/ru/tools-reference#powershell-tool) включен, режим `acceptEdits` также автоматически одобряет `Set-Content`, `Add-Content`, `Clear-Content` и `Remove-Item` на путях в области действия, вместе с их распространёнными псевдонимами. Применяются те же правила области действия и защищённых путей.

124 143 

125Используйте `acceptEdits`, когда вы хотите проверить изменения в вашем редакторе или через `git diff` после того, как они будут сделаны, а не одобрять каждое редактирование в строке. Нажмите `Shift+Tab` один раз из режима по умолчанию, чтобы войти в него, или запустите его напрямую:144Используйте `acceptEdits`, когда вы хотите проверить изменения в вашем редакторе или через `git diff` после того, как они будут сделаны, а не одобрять каждое редактирование в строке.

145 

146Нажмите `Shift+Tab` один раз из режима Manual, чтобы войти в него, или запустите его напрямую:

126 147 

127```bash theme={null}148```bash theme={null}

128claude --permission-mode acceptEdits149claude --permission-mode acceptEdits


180 201 

181Режим auto позволяет Claude выполнять действия без запросов разрешений. Отдельная модель классификатора проверяет действия перед их выполнением, блокируя всё, что выходит за пределы вашего запроса, нацелено на неизвестную инфраструктуру или кажется вызванным враждебным содержимым, которое Claude прочитал. Явные [правила запроса](/ru/permissions#manage-permissions) по-прежнему вызывают запрос.202Режим auto позволяет Claude выполнять действия без запросов разрешений. Отдельная модель классификатора проверяет действия перед их выполнением, блокируя всё, что выходит за пределы вашего запроса, нацелено на неизвестную инфраструктуру или кажется вызванным враждебным содержимым, которое Claude прочитал. Явные [правила запроса](/ru/permissions#manage-permissions) по-прежнему вызывают запрос.

182 203 

204Удаления, нацеленные на корневой каталог файловой системы или домашний каталог, такие как `rm -rf /` и `rm -rf ~`, требуют одобрения вместо отправки классификатору. {/* min-version: 2.1.208 */}Этот запрос также срабатывает, когда команда содержит подстановку команд с `$(...)` или обратными кавычками, или подстановку процесса с `<(...)`, независимо от того, находится ли удаление внутри подстановки, как в `echo "$(rm -rf ~)"`, или в другом месте той же команды. До v2.1.208 команды, содержащие эти формы, отправлялись классификатору вместо запроса.

205 

183Режим auto также побуждает Claude продолжать работу без остановки для уточняющих вопросов, хотя Claude всё ещё спрашивает, когда ваш запрос или навык явно на этом полагается. Для более сильного автономного поведения при сохранении запросов разрешений установите вместо этого [Proactive output style](/ru/output-styles).206Режим auto также побуждает Claude продолжать работу без остановки для уточняющих вопросов, хотя Claude всё ещё спрашивает, когда ваш запрос или навык явно на этом полагается. Для более сильного автономного поведения при сохранении запросов разрешений установите вместо этого [Proactive output style](/ru/output-styles).

184 207 

185<Warning>208<Warning>


189Режим auto доступен только когда ваша учётная запись соответствует всем этим требованиям:212Режим auto доступен только когда ваша учётная запись соответствует всем этим требованиям:

190 213 

191* **План**: Все планы.214* **План**: Все планы.

192* **Администратор**: на Team и Enterprise администратор должен включить его в [настройках администратора Claude Code](https://claude.ai/admin-settings/claude-code) перед тем, как пользователи смогут его включить. Администраторы также могут заблокировать его, установив `permissions.disableAutoMode` на `"disable"` в [управляемых параметрах](/ru/permissions#managed-settings).215* **Владелец**: на Team и Enterprise владелец должен включить его в [настройках администратора Claude Code](https://claude.ai/admin-settings/claude-code) перед тем, как пользователи смогут его включить. Администраторы также могут отключить режим auto, установив `permissions.disableAutoMode` на `"disable"` в [управляемых параметрах](/ru/permissions#managed-settings). Для вкладки Code в приложении для рабочего стола `disableAutoMode` — это элемент управления на уровне организации, и переключатель в параметрах администратора не применяется.

193* **Модель**: на Anthropic API — Claude Opus 4.6 или позже, или Sonnet 4.6 или позже. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и подписанных сеансах [Claude apps gateway](/ru/claude-apps-gateway) поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8. Более старые модели, включая Sonnet 4.5, Opus 4.5, Haiku и модели claude-3, не поддерживаются ни на одном поставщике.216* **Модель**: на Anthropic API — Claude Opus 4.6 или позже, или Sonnet 4.6 или позже. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и подписанных сеансах [Claude apps gateway](/ru/claude-apps-gateway) поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8. Более старые модели, включая Sonnet 4.5, Opus 4.5, Haiku и модели claude-3, не поддерживаются ни на одном поставщике.

194* **Поставщик**: доступен по умолчанию на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и подписанных сеансах Claude apps gateway режим auto отключён до тех пор, пока вы не [установите `CLAUDE_CODE_ENABLE_AUTO_MODE`](#enable-auto-mode-on-bedrock-agent-platform-or-foundry).217* **Поставщик**: доступен по умолчанию на Anthropic API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и подписанных сеансах Claude apps gateway. {/* min-version: 2.1.207 */}В v2.1.158 через v2.1.206 режим auto был отключён на всех этих поставщиках, кроме Anthropic API, до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 удалил это требование.

195 218 

196Если Claude Code сообщает, что режим auto недоступен, одно из этих требований не выполнено; это не временный сбой. Отдельное сообщение, которое называет модель и говорит, что режим auto "не может определить безопасность" действия, является временным сбоем классификатора; см. [справку по ошибкам](/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action).219Если Claude Code сообщает, что режим auto недоступен, одно из этих требований не выполнено; это не временный сбой. Отдельное сообщение, которое называет модель и говорит, что режим auto "не может определить безопасность" действия, является временным сбоем классификатора; см. [справку по ошибкам](/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action).

197 220 

198Если вы установили `defaultMode: "auto"` в [параметрах](/ru/settings#available-settings) и сеанс начинается в режиме `default` без ошибки, параметр, вероятно, находится в `.claude/settings.json` или `.claude/settings.local.json`. Claude Code v2.1.142 и позже игнорируют `auto` из этих файлов, поэтому репозиторий не может предоставить себе режим auto. Переместите его в `~/.claude/settings.json`.221Если вы установили `defaultMode: "auto"` в [параметрах](/ru/settings#available-settings) и сеанс начинается в режиме `default` без ошибки, параметр, вероятно, находится в `.claude/settings.json` или `.claude/settings.local.json`. Claude Code v2.1.142 и позже игнорируют `auto` из этих файлов, поэтому репозиторий не может предоставить себе режим auto. Переместите его в `~/.claude/settings.json`.

199 222 

200<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">223<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">

201 Включите режим auto на Bedrock, Agent Platform или Foundry224 Режим auto на Bedrock, Agent Platform или Foundry

202</h3>225</h3>

203 226 

204На [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry) и подписанных сеансах [Claude apps gateway](/ru/claude-apps-gateway) режим auto не появляется в цикле `Shift+Tab` до тех пор, пока `CLAUDE_CODE_ENABLE_AUTO_MODE` не будет установлен на `1`. Переменная работает в Claude Code v2.1.158 и позже. На этих поставщиках поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8.227На [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry) и подписанных сеансах [Claude apps gateway](/ru/claude-apps-gateway) режим auto появляется в цикле `Shift+Tab` по умолчанию. Появление в цикле не изменяет режим, в котором начинается сеанс: сеансы по-прежнему начинаются в вашем [`defaultMode`](/ru/settings#available-settings), который является Manual, если вы его не измените. На этих поставщиках поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8.

205 228 

206Чтобы включить его для одного разработчика, добавьте переменную в блок `env` в `~/.claude/settings.json`:229Чтобы сделать режим auto режимом запуска по умолчанию, установите `"permissions": {"defaultMode": "auto"}` в пользовательские или управляемые параметры.

207 230 

208```json theme={null}231Чтобы предотвратить использование режима auto разработчиками, установите `disableAutoMode` на `"disable"` в [управляемых параметрах](/ru/permissions#managed-settings). Это удаляет `auto` из цикла `Shift+Tab` и отклоняет `--permission-mode auto` при запуске.

209{

210 "env": {

211 "CLAUDE_CODE_ENABLE_AUTO_MODE": "1"

212 }

213}

214```

215 232 

216Чтобы включить его для вашей организации, добавьте тот же блок `env` в [управляемые параметры](/ru/settings#settings-files).233В v2.1.158 через v2.1.206 режим auto был отключён на этих поставщиках до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, и Claude Code игнорировал `defaultMode: "auto"` на этих поставщиках, если переменная также не была установлена. Переменная по-прежнему принимается для совместимости и не имеет эффекта с v2.1.207 и далее.

217 

218После установки переменной режим auto появляется в цикле `Shift+Tab` для каждого сеанса. Чтобы сделать его режимом запуска по умолчанию, также установите `"permissions": {"defaultMode": "auto"}` в пользовательские или управляемые параметры. На этих поставщиках Claude Code игнорирует `defaultMode: "auto"` если `CLAUDE_CODE_ENABLE_AUTO_MODE` также не установлен.

219 

220Чтобы предотвратить включение режима auto разработчиками, установите `disableAutoMode` на `"disable"` в управляемых параметрах. Это переопределяет переменную включения.

221 

222Если вы подключаетесь через [LLM gateway](/ru/llm-gateway) настроенный с `ANTHROPIC_BASE_URL`, режим auto может быть уже доступен без переменной включения, потому что шлюз маршрутизирует запросы через Anthropic API. Это не применяется к подписанному сеансу [Claude apps gateway](/ru/claude-apps-gateway), который является его собственным классом поставщика и требует переменную включения. Параметр `disableAutoMode` применяется таким же образом в любой конфигурации.

223 234 

224<h3 id="what-the-classifier-blocks-by-default">235<h3 id="what-the-classifier-blocks-by-default">

225 Что классификатор блокирует по умолчанию236 Что классификатор блокирует по умолчанию


292* Чтение `.env` и отправка учётных данных на соответствующий API303* Чтение `.env` и отправка учётных данных на соответствующий API

293* Запросы HTTP только для чтения304* Запросы HTTP только для чтения

294* Отправка на ветвь, с которой вы начали, или на ветвь, созданную Claude305* Отправка на ветвь, с которой вы начали, или на ветвь, созданную Claude

306* {/* min-version: 2.1.203 */}Обычные отправки на ветвь по умолчанию репозитория. До v2.1.203 любая прямая отправка на ветвь по умолчанию была заблокирована

295 307 

296Claude Code v2.1.195 и позже также разрешают эти действия по умолчанию:308Claude Code v2.1.195 и позже также разрешают эти действия по умолчанию:

297 309 


310 322 

311Запустите `claude auto-mode defaults`, чтобы увидеть полные списки правил. Если обычные действия блокируются, администратор может добавить доверенные репозитории, корзины и сервисы через параметр `autoMode.environment`: см. [Настройка режима auto](/ru/auto-mode-config).323Запустите `claude auto-mode defaults`, чтобы увидеть полные списки правил. Если обычные действия блокируются, администратор может добавить доверенные репозитории, корзины и сервисы через параметр `autoMode.environment`: см. [Настройка режима auto](/ru/auto-mode-config).

312 324 

325Отправка на вашу рабочую ветвь, обычная отправка на ветвь по умолчанию репозитория и создание pull request, который соответствует вашему запросу, всё это выполняется без запроса. Классификатор блокирует отправку только когда она несёт риск, такой как force push или содержимое, которое обходит проверку, которую вы установили. Чтобы требовать контрольную точку человека перед этими действиями, оставаясь в режиме auto, добавьте правила `permissions.ask`: см. [Общие границы](/ru/auto-mode-config#common-boundaries).

326 

313<h3 id="boundaries-you-state-in-conversation">327<h3 id="boundaries-you-state-in-conversation">

314 Границы, которые вы указываете в разговоре328 Границы, которые вы указываете в разговоре

315</h3>329</h3>


334 <Accordion title="Как классификатор оценивает действия">348 <Accordion title="Как классификатор оценивает действия">

335 Каждое действие проходит через фиксированный порядок решений. Первый совпадающий шаг побеждает:349 Каждое действие проходит через фиксированный порядок решений. Первый совпадающий шаг побеждает:

336 350 

337 1. Действия, соответствующие вашим [правилам allow или deny](/ru/permissions#manage-permissions), разрешаются немедленно, кроме записей в [защищённые пути](#protected-paths), которые маршрутизируются классификатору даже когда правило allow совпадает351 1. Действия, соответствующие вашим [правилам allow, ask или deny](/ru/permissions#manage-permissions), разрешаются немедленно. Записи в [защищённые пути](#protected-paths) маршрутизируются классификатору даже когда правило allow совпадает. Инструменты Connector [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), запрашивают вас напрямую даже когда правило allow совпадает. Правила ask с областью действия содержимого откатываются к запросу разрешения

338 2. Действия только для чтения и редактирование файлов в вашем рабочем каталоге автоматически одобряются, кроме записей в [защищённые пути](#protected-paths)352 2. Действия только для чтения и редактирование файлов в вашем рабочем каталоге автоматически одобряются, кроме записей в [защищённые пути](#protected-paths)

339 3. Всё остальное идёт классификатору. {/* min-version: 2.1.199 */}Начиная с v2.1.199 инструмент MCP, отмеченный с [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), пропускает классификатор и запрашивает вас напрямую, поэтому шаг согласия никогда не одобряется автоматически от имени автора инструмента353 3. Всё остальное идёт классификатору. Инструмент Connector [установленный вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) пропускает классификатор и запрашивает вас напрямую, поэтому одобрение, требуемое организацией, никогда не одобряется автоматически. {/* min-version: 2.1.199 */}Начиная с v2.1.199 инструмент MCP, отмеченный с [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), также пропускает классификатор и запрашивает вас напрямую, поэтому шаг согласия никогда не одобряется автоматически от имени автора инструмента

340 4. Если классификатор блокирует, Claude получает причину и пытается найти альтернативу354 4. Если классификатор блокирует, Claude получает причину и пытается найти альтернативу

341 355 

342 При входе в режим auto широкие правила allow, которые предоставляют произвольное выполнение кода, отбрасываются:356 При входе в режим auto широкие правила allow, которые предоставляют произвольное выполнение кода, отбрасываются:


370 Разрешить только предварительно одобренные инструменты с режимом dontAsk384 Разрешить только предварительно одобренные инструменты с режимом dontAsk

371</h2>385</h2>

372 386 

373Режим `dontAsk` автоматически отклоняет каждый вызов инструмента, который иначе требовал бы запроса. Строка состояния показывает `⏵⏵ don't ask on`, пока этот режим активен. Только действия, соответствующие вашим правилам `permissions.allow` и [командам Bash только для чтения](/ru/permissions#read-only-commands), могут выполняться; явные правила [`ask`](/ru/permissions#manage-permissions) отклоняются, а не запрашиваются. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, инструмент MCP, отмеченный с помощью [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), также отклоняется в этом режиме даже при совпадении правила разрешения, поскольку его карточка одобрения требует ответа, который этот режим никогда не собирает. Это делает режим полностью неинтерактивным для конвейеров CI или ограниченных сред, где вы предварительно определяете ровно то, что Claude может делать. Облачные сеансы на [Claude Code в веб-версии](/ru/claude-code-on-the-web) игнорируют `defaultMode: "dontAsk"`; см. [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) для получения подробной информации.387Если вы установите режим `dontAsk`, Claude Code автоматически отклоняет каждый вызов инструмента, который иначе требовал бы запроса. Claude выполняет только действия, соответствующие вашим правилам `permissions.allow`, [командам Bash только для чтения](/ru/permissions#read-only-commands) и вызовам, одобренным [hook PreToolUse](/ru/permissions#extend-permissions-with-hooks). Используйте этот режим для конвейеров CI или ограниченных сред, где вы предварительно определяете ровно то, что Claude может делать; сеанс никогда не ждёт ввода. Строка состояния показывает `⏵⏵ don't ask on`, пока этот режим активен.

388 

389Claude Code отклоняет вызовы, соответствующие вашим явным правилам [`ask`](/ru/permissions#manage-permissions), а не запрашивает их. Он также отклоняет встроенный инструмент `AskUserQuestion` и инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools), даже если ваши правила разрешения совпадают. {/* min-version: 2.1.199 */}Он отклоняет инструменты MCP, отмеченные [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool) таким же образом, потому что их карточка одобрения требует ответа, который этот режим никогда не собирает; это требует Claude Code версии 2.1.199 или позже.

390 

391Облачные сеансы на [Claude Code в веб-версии](/ru/claude-code-on-the-web) игнорируют `defaultMode: "dontAsk"`; см. [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) для получения подробной информации.

374 392 

375Установите его при запуске с флагом:393Установите его при запуске с флагом:

376 394 


382 Пропустить все проверки с режимом bypassPermissions400 Пропустить все проверки с режимом bypassPermissions

383</h2>401</h2>

384 402 

385Режим `bypassPermissions` отключает запросы разрешений и проверки безопасности, чтобы вызовы инструментов выполнялись немедленно. Начиная с версии 2.1.126, это включает записи в [защищённые пути](#protected-paths), на которые более ранние версии по-прежнему выдавали запросы. Явные [правила ask](/ru/permissions#manage-permissions) по-прежнему принудительно выдают запрос в этом режиме, а удаления, нацеленные на корневой каталог файловой системы или домашний каталог, такие как `rm -rf /` и `rm -rf ~`, по-прежнему выдают запросы в качестве защиты от ошибок модели. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, инструменты MCP, отмеченные с помощью [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), также по-прежнему выдают запросы. Используйте этот режим только в изолированных средах, таких как контейнеры, виртуальные машины или dev containers без доступа в Интернет, где Claude Code не может повредить вашу хост-систему.403Режим `bypassPermissions` отключает запросы разрешений и проверки безопасности, чтобы вызовы инструментов выполнялись немедленно, включая записи в [защищённые пути](#protected-paths). До версии 2.1.126 записи в защищённые пути по-прежнему выдавали запросы в этом режиме.

404 

405Явные [правила ask](/ru/permissions#manage-permissions) и инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) по-прежнему принудительно выдают запрос в этом режиме. {/* min-version: 2.1.199 */}Инструменты MCP, отмеченные с помощью [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), также по-прежнему выдают запросы; это требует Claude Code версии 2.1.199 или более поздней.

406 

407Удаления, нацеленные на корневой каталог файловой системы или домашний каталог, такие как `rm -rf /` и `rm -rf ~`, по-прежнему выдают запросы в качестве защиты от ошибок модели. {/* min-version: 2.1.208 */}Защита также срабатывает, когда команда содержит подстановку команд с `$(...)` или обратными кавычками, или подстановку процесса с `<(...)`, независимо от того, находится ли удаление внутри подстановки, как в `echo "$(rm -rf ~)"`, или в другом месте той же команды. Простая форма, введённая как отдельная команда, выдавала запросы в этом режиме с момента введения защиты; до версии 2.1.208 команды, содержащие эти формы, не выдавали запросы.

408 

409<Warning>

410 Используйте этот режим только в изолированных средах, таких как контейнеры, виртуальные машины или dev containers без доступа в Интернет, где Claude Code не может повредить вашу хост-систему.

411</Warning>

386 412 

387Вы не можете войти в `bypassPermissions` из сеанса, который был запущен без одного из включающих флагов; перезапустите с одним, чтобы включить его:413Вы не можете войти в `bypassPermissions` из сеанса, который был запущен без одного из включающих флагов; перезапустите с одним, чтобы включить его:

388 414 

permissions.md +26 −6

Details

20| Bash команды | Выполнение оболочки | Да, кроме встроенного набора [команд только для чтения](#read-only-commands) | Постоянно для каждого каталога проекта и команды |20| Bash команды | Выполнение оболочки | Да, кроме встроенного набора [команд только для чтения](#read-only-commands) | Постоянно для каждого каталога проекта и команды |

21| Изменение файлов | Edit/Write файлы | Да | До конца сеанса |21| Изменение файлов | Edit/Write файлы | Да | До конца сеанса |

22 22 

23При появлении запроса разрешения Bash или PowerShell нажмите `Ctrl+E` для отображения объяснения команды: что она делает, почему Claude её выполняет и что может пойти не так, обозначено как **Low risk**, **Med risk** или **High risk**. Claude Code отправляет команду и собственное описание Claude вызова модели для создания объяснения только при нажатии `Ctrl+E`, а не при каждом запросе. Отображение объяснения не выполняет команду; нажмите `Ctrl+E` снова, чтобы скрыть его.

24 

25Чтобы отключить сочетание клавиш, установите [`permissionExplainerEnabled`](/ru/settings#global-config-settings) на `false` в `~/.claude.json`.

26 

23<h2 id="manage-permissions">27<h2 id="manage-permissions">

24 Управление разрешениями28 Управление разрешениями

25</h2>29</h2>


47Claude Code поддерживает несколько режимов разрешений, которые контролируют, как он одобряет вызовы инструментов. См. [Permission modes](/ru/permission-modes) для определения того, когда использовать каждый из них. Установите `defaultMode` в ваших [файлах параметров](/ru/settings#settings-files):51Claude Code поддерживает несколько режимов разрешений, которые контролируют, как он одобряет вызовы инструментов. См. [Permission modes](/ru/permission-modes) для определения того, когда использовать каждый из них. Установите `defaultMode` в ваших [файлах параметров](/ru/settings#settings-files):

48 52 

49| Режим | Описание |53| Режим | Описание |

50| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |54| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

51| `default` | Стандартное поведение: запрашивает разрешение при первом использовании каждого инструмента. {/* min-version: 2.1.200 */}В CLI и расширениях VS Code и JetBrains обозначается как Manual, и Claude Code принимает `manual` как псевдоним. Метка и псевдоним требуют Claude Code v2.1.200 или более поздней версии |55| `default` | Стандартное поведение: запрашивает разрешение при первом использовании каждого инструмента. {/* min-version: 2.1.200 */}В CLI и расширениях VS Code и JetBrains обозначается как Manual, в приложении для рабочего стола, и Claude Code принимает `manual` как псевдоним. Метка и псевдоним требуют Claude Code v2.1.200 или более поздней версии. Метка приложения для рабочего стола не зависит от вашей версии CLI |

52| `acceptEdits` | Автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch`, `mv` и `cp` для путей в рабочем каталоге или `additionalDirectories` |56| `acceptEdits` | Автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch`, `mv` и `cp` для путей в рабочем каталоге или `additionalDirectories` |

53| `plan` | Claude читает файлы и запускает команды оболочки только для чтения для исследования, но не редактирует ваши исходные файлы. Обозначается как Plan в CLI и расширении VS Code |57| `plan` | Claude читает файлы и запускает команды оболочки только для чтения для исследования, но не редактирует ваши исходные файлы. Обозначается как Plan в CLI и расширении VS Code |

54| `auto` | Автоматически одобряет вызовы инструментов с проверками безопасности в фоне, которые проверяют, соответствуют ли действия вашему запросу |58| `auto` | Автоматически одобряет вызовы инструментов с проверками безопасности в фоне, которые проверяют, соответствуют ли действия вашему запросу |

55| `dontAsk` | Автоматически отклоняет инструменты, если они не предварительно одобрены через `/permissions` или правила `permissions.allow` |59| `dontAsk` | Автоматически отклоняет инструменты, если они не предварительно одобрены через `/permissions` или правила `permissions.allow`. `AskUserQuestion`, инструменты соединителя [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), отклоняются даже если вы их разрешили |

56| `bypassPermissions` | Пропускает запросы разрешений, за исключением тех, которые вынуждены явными правилами `ask`. Удаления корневого каталога и домашнего каталога, такие как `rm -rf /`, также по-прежнему запрашивают подтверждение в качестве защиты от ошибок модели |60| `bypassPermissions` | Пропускает запросы разрешений, за исключением тех, которые вынуждены явными правилами `ask`, инструментами соединителя [установленными вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструментами MCP, отмеченными [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool). Удаления корневого каталога и домашнего каталога, такие как `rm -rf /`, также по-прежнему запрашивают подтверждение в качестве защиты от ошибок модели |

57 61 

58<Warning>62<Warning>

59 Режим `bypassPermissions` пропускает запросы разрешений, включая записи в `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` и `.mvn`. Явные правила `ask` по-прежнему вынуждают запрос, и удаления, затрагивающие корневой каталог файловой системы или домашний каталог, такие как `rm -rf /` и `rm -rf ~`, по-прежнему запрашивают подтверждение в качестве защиты от ошибок модели. Используйте этот режим только в изолированных средах, таких как контейнеры или виртуальные машины, где Claude Code не может причинить вред.63 Режим `bypassPermissions` пропускает запросы разрешений, включая записи в `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` и `.mvn`. Используйте этот режим только в изолированных средах, таких как контейнеры или виртуальные машины, где Claude Code не может причинить вред.

64 

65 В этом режиме по-прежнему срабатывают несколько запросов. Явные правила `ask`, инструменты соединителя [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), по-прежнему запрашивают подтверждение. Удаления, затрагивающие корневой каталог файловой системы или домашний каталог, такие как `rm -rf /` и `rm -rf ~`, также запрашивают подтверждение в качестве защиты от ошибок модели, {/* min-version: 2.1.208 */}включая случаи, когда команда содержит подстановку команд с `$(...)` или обратными кавычками, или подстановку процесса с `<(...)`. До версии v2.1.208 запрашивалась только простая форма, такая как `rm -rf ~`, введённая как отдельная команда; команды, которые достигали удаления через подстановку, не запрашивали подтверждение.

60</Warning>66</Warning>

61 67 

62Чтобы предотвратить использование режима `bypassPermissions` или `auto`, установите `permissions.disableBypassPermissionsMode` или `permissions.disableAutoMode` на `"disable"` в любом [файле параметров](/ru/settings#settings-files). Это наиболее полезно в [управляемых параметрах](#managed-settings), где они не могут быть переопределены.68Чтобы предотвратить использование режима `bypassPermissions` или `auto`, установите `permissions.disableBypassPermissionsMode` или `permissions.disableAutoMode` на `"disable"` в любом [файле параметров](/ru/settings#settings-files). Это наиболее полезно в [управляемых параметрах](#managed-settings), где они не могут быть переопределены.


217 223 

218`cd` в путь внутри вашего рабочего каталога или [дополнительного каталога](#working-directories) также только для чтения. Составная команда, такая как `cd packages/api && ls`, запускается без запроса, когда каждая часть квалифицируется самостоятельно. Объединение `cd` с `git` в одну составную команду запрашивает, когда `cd` переходит в другой каталог, так как запуск `git` в новом каталоге может выполнить hooks этого каталога. `cd`, целевой путь которого разрешается в текущий рабочий каталог, является no-op и не вызывает этот запрос.224`cd` в путь внутри вашего рабочего каталога или [дополнительного каталога](#working-directories) также только для чтения. Составная команда, такая как `cd packages/api && ls`, запускается без запроса, когда каждая часть квалифицируется самостоятельно. Объединение `cd` с `git` в одну составную команду запрашивает, когда `cd` переходит в другой каталог, так как запуск `git` в новом каталоге может выполнить hooks этого каталога. `cd`, целевой путь которого разрешается в текущий рабочий каталог, является no-op и не вызывает этот запрос.

219 225 

226Объединение `cd` с перенаправлением вывода в одну составную команду также запрашивает, когда Claude Code не может определить, в какой каталог разрешается целевой путь перенаправления после выполнения `cd`. Команда, единственной целью перенаправления которой является `/dev/null`, такая как `cd app; grep -r pattern . 2>/dev/null`, не вызывает этот запрос, потому что `/dev/null` не зависит от рабочего каталога. {/* min-version: 2.1.207 */}До версии 2.1.207 составная команда, содержащая `cd`, запрашивала для любого перенаправления вывода, включая то, единственной целью которого был `/dev/null`.

227 

220<Warning>228<Warning>

221 Шаблоны разрешений Bash, которые пытаются ограничить аргументы команды, хрупкие. Например, `Bash(curl http://github.com/ *)` предназначен для ограничения curl на URL-адреса GitHub, но не будет совпадать с вариациями, такими как:229 Шаблоны разрешений Bash, которые пытаются ограничить аргументы команды, хрупкие. Например, `Bash(curl http://github.com/ *)` предназначен для ограничения curl на URL-адреса GitHub, но не будет совпадать с вариациями, такими как:

222 230 


265 273 

266Правила `Edit` применяются ко всем встроенным инструментам, которые редактируют файлы. Claude прилагает наилучшие усилия для применения правил `Read` ко всем встроенным инструментам, которые читают файлы, таким как Grep и Glob, к упоминаниям `@file` в ваших подсказках и к выделению и контексту открытого файла, которые подключенный [IDE](/ru/vs-code#the-built-in-ide-mcp-server) делится с Claude.274Правила `Edit` применяются ко всем встроенным инструментам, которые редактируют файлы. Claude прилагает наилучшие усилия для применения правил `Read` ко всем встроенным инструментам, которые читают файлы, таким как Grep и Glob, к упоминаниям `@file` в ваших подсказках и к выделению и контексту открытого файла, которые подключенный [IDE](/ru/vs-code#the-built-in-ide-mcp-server) делится с Claude.

267 275 

276{/* min-version: 2.1.208 */}Правило `Read` deny также блокирует [инструмент Edit](/ru/errors#file-is-covered-by-a-read-deny-rule) на том же пути, включая создание нового файла там. Write и NotebookEdit не охватываются, поэтому добавьте правило `Edit` deny для путей, которые ни один инструмент не может изменять. Требуется Claude Code версии 2.1.208 или позже.

277 

268<Warning>278<Warning>

269 Правила Read и Edit deny применяются к встроенным инструментам файлов Claude и к командам файлов, которые Claude Code распознает в Bash, таким как `cat`, `head`, `tail` и `sed`. Они не применяются к произвольным подпроцессам, которые косвенно читают или записывают файлы, таким как скрипт Python или Node, который открывает файлы самостоятельно. Для принудительного применения на уровне ОС, которое блокирует все процессы от доступа к пути, [включите sandbox](/ru/sandboxing).279 Правила Read и Edit deny применяются к встроенным инструментам файлов Claude и к командам файлов, которые Claude Code распознает в Bash, таким как `cat`, `head`, `tail` и `sed`. Они не применяются к произвольным подпроцессам, которые косвенно читают или записывают файлы, таким как скрипт Python или Node, который открывает файлы самостоятельно. Для принудительного применения на уровне ОС, которое блокирует все процессы от доступа к пути, [включите sandbox](/ru/sandboxing).

270</Warning>280</Warning>


313 В шаблонах gitignore `*` совпадает в одном сегменте пути и может появляться в любой позиции в шаблоне, в то время как `**` совпадает по каталогам. Чтобы разрешить весь доступ к файлам, используйте только имя инструмента без скобок: `Read`, `Edit` или `Write`.323 В шаблонах gitignore `*` совпадает в одном сегменте пути и может появляться в любой позиции в шаблоне, в то время как `**` совпадает по каталогам. Чтобы разрешить весь доступ к файлам, используйте только имя инструмента без скобок: `Read`, `Edit` или `Write`.

314</Note>324</Note>

315 325 

326{/* min-version: 2.1.202 */}Когда вы одобряете путь к файлу с "Да, не спрашивать снова", Claude Code экранирует символы шаблона gitignore в этом пути, такие как `[`, `]` и `*`, поэтому сгенерированное правило совпадает только с буквальным путем, который вы одобрили. Правила, которые вы пишете сами, не экранируются. До версии 2.1.202 Claude Code сохранял путь без экранирования, поэтому сгенерированное правило для каталога с именем `[2024-06] Reports` могло не совпадать с его собственным путем или совпадать с непредусмотренными соседними каталогами.

327 

316Когда Claude получает доступ к символической ссылке, правила разрешений проверяют два пути: саму символическую ссылку и файл, на который она указывает. Правила allow и deny обрабатывают эту пару по-разному: правила allow возвращаются к запросу вас, в то время как правила deny блокируют полностью.328Когда Claude получает доступ к символической ссылке, правила разрешений проверяют два пути: саму символическую ссылку и файл, на который она указывает. Правила allow и deny обрабатывают эту пару по-разному: правила allow возвращаются к запросу вас, в то время как правила deny блокируют полностью.

317 329 

318* **Правила allow**: применяются только когда совпадают как путь символической ссылки, так и его цель. Символическая ссылка внутри разрешенного каталога, которая указывает вне его, по-прежнему запрашивает вас.330* **Правила allow**: применяются только когда совпадают как путь символической ссылки, так и его цель. Символическая ссылка внутри разрешенного каталога, которая указывает вне его, по-прежнему запрашивает вас.


342* `mcp__puppeteer__*` использует синтаксис подстановочных символов и также совпадает со всеми инструментами с сервера `puppeteer`354* `mcp__puppeteer__*` использует синтаксис подстановочных символов и также совпадает со всеми инструментами с сервера `puppeteer`

343* `mcp__puppeteer__puppeteer_navigate` совпадает с инструментом `puppeteer_navigate`, предоставленным сервером `puppeteer`355* `mcp__puppeteer__puppeteer_navigate` совпадает с инструментом `puppeteer_navigate`, предоставленным сервером `puppeteer`

344 356 

357Если ваша организация установила [инструмент соединителя claude.ai](/ru/mcp#organization-controls-on-connector-tools) на `ask`, правила allow для этого инструмента не вступают в силу: Claude Code запрашивает при каждом вызове, даже в режимах `auto` и `bypassPermissions`. В режиме `dontAsk`, который никогда не запрашивает, Claude Code отказывает в вызове вместо этого. Инструменты соединителя отображаются как `mcp__claude_ai_<server>__<tool>`.

358 

345<h3 id="agent-subagents">359<h3 id="agent-subagents">

346 Agent (subagents)360 Agent (subagents)

347</h3>361</h3>


386 400 

387[Claude Code hooks](/ru/hooks-guide) предоставляют способ регистрации пользовательских команд оболочки для выполнения оценки разрешений во время выполнения. Когда Claude Code выполняет вызов инструмента, PreToolUse hooks запускаются перед запросом разрешения. Выход hook может отклонить вызов инструмента, принудить запрос или пропустить запрос, чтобы позволить вызову продолжиться.401[Claude Code hooks](/ru/hooks-guide) предоставляют способ регистрации пользовательских команд оболочки для выполнения оценки разрешений во время выполнения. Когда Claude Code выполняет вызов инструмента, PreToolUse hooks запускаются перед запросом разрешения. Выход hook может отклонить вызов инструмента, принудить запрос или пропустить запрос, чтобы позволить вызову продолжиться.

388 402 

389Решения hook не обходят правила разрешений. Правила deny и ask оцениваются независимо от того, что возвращает PreToolUse hook, поэтому совпадающее правило deny блокирует вызов и совпадающее правило ask по-прежнему запрашивает даже когда hook вернул `"allow"` или `"ask"`. Это сохраняет приоритет deny-first, описанный в [Управление разрешениями](#manage-permissions), включая правила deny, установленные в управляемых параметрах.403Решения hook не обходят правила разрешений. Claude Code оценивает правила deny и ask независимо от того, что возвращает PreToolUse hook: совпадающее правило deny блокирует вызов, и совпадающее правило ask по-прежнему запрашивает даже когда hook вернул `"allow"` или `"ask"`. Это сохраняет приоритет deny-first, описанный в [Управление разрешениями](#manage-permissions), включая правила deny, установленные в управляемых параметрах.

404 

405Инструменты Connector, [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools), и инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), также по-прежнему запрашивают, когда hook возвращает `"allow"`.

390 406 

391Блокирующий hook также имеет приоритет над правилами allow. Hook, который выходит с кодом 2, останавливает вызов инструмента перед оценкой правил разрешений, поэтому блокировка применяется даже когда правило allow иначе позволило бы вызову продолжиться. Чтобы запустить все Bash команды без запросов, кроме нескольких, которые вы хотите заблокировать, добавьте `"Bash"` в список allow и зарегистрируйте PreToolUse hook, который отклоняет эти конкретные команды. См. [Блокировка редактирования защищённых файлов](/ru/hooks-guide#block-edits-to-protected-files) для скрипта hook, который вы можете адаптировать.407Блокирующий hook также имеет приоритет над правилами allow. Hook, который выходит с кодом 2, останавливает вызов инструмента перед оценкой правил разрешений, поэтому блокировка применяется даже когда правило allow иначе позволило бы вызову продолжиться. Чтобы запустить все Bash команды без запросов, кроме нескольких, которые вы хотите заблокировать, добавьте `"Bash"` в список allow и зарегистрируйте PreToolUse hook, который отклоняет эти конкретные команды. См. [Блокировка редактирования защищённых файлов](/ru/hooks-guide#block-edits-to-protected-files) для скрипта hook, который вы можете адаптировать.

392 408 


402 418 

403Файлы в дополнительных каталогах следуют тем же правилам разрешений, что и исходный рабочий каталог: они становятся читаемыми без запросов, и разрешения на редактирование файлов следуют текущему режиму разрешений.419Файлы в дополнительных каталогах следуют тем же правилам разрешений, что и исходный рабочий каталог: они становятся читаемыми без запросов, и разрешения на редактирование файлов следуют текущему режиму разрешений.

404 420 

421В фоновых сеансах на macOS хост сеанса запрашивает доступ к защищённым папкам, таким как `~/Desktop`, `~/Documents` и `~/Downloads`, отдельно от вашего терминала, когда Claude нужно читать или писать файлы там; если чтение там завершается с ошибкой `Operation not permitted`, см. [как предоставить доступ к папкам для фоновых сеансов](/ru/agent-view#background-sessions-can't-read-desktop-documents-or-downloads-on-macos).

422 

405Чтобы изменить основной рабочий каталог сеанса вместо добавления другого, используйте [`/cd`](/ru/commands). Команда `/cd` требует Claude Code версии 2.1.169 или позже. В отличие от `/add-dir`, она перемещает сеанс: загружается `CLAUDE.md` нового каталога и `--resume` находит сеанс оттуда.423Чтобы изменить основной рабочий каталог сеанса вместо добавления другого, используйте [`/cd`](/ru/commands). Команда `/cd` требует Claude Code версии 2.1.169 или позже. В отличие от `/add-dir`, она перемещает сеанс: загружается `CLAUDE.md` нового каталога и `--resume` находит сеанс оттуда.

406 424 

407<h3 id="additional-directories-grant-file-access-not-configuration">425<h3 id="additional-directories-grant-file-access-not-configuration">


515 533 

516`.claude/settings.local.json` — это ваш собственный файл, поэтому проверка доверия рабочей области обычно к нему не применяется. Когда репозиторий мог предоставить файл, например когда он зафиксирован в git или `.claude` является символической ссылкой, его правила разрешений и дополнительные каталоги проходят проверку доверия как параметры проекта.534`.claude/settings.local.json` — это ваш собственный файл, поэтому проверка доверия рабочей области обычно к нему не применяется. Когда репозиторий мог предоставить файл, например когда он зафиксирован в git или `.claude` является символической ссылкой, его правила разрешений и дополнительные каталоги проходят проверку доверия как параметры проекта.

517 535 

536Claude Code запускает git для проверки того, предоставил ли репозиторий файл, и выполняет эту проверку только в папке, охватываемой принятым диалогом доверия, для этой папки или для одного из её родительских каталогов. В интерактивном сеансе в папке, которой вы ещё не доверяете, правила разрешений и дополнительные каталоги в `.claude/settings.local.json` проходят проверку доверия как параметры проекта до тех пор, пока вы не примете диалог, если только сеанс не выполняется в вашем собственном конфигурационном домашнем каталоге, как описано ниже. Из двух исключений ниже только исключение конфигурационного домашнего каталога применяется до диалога, потому что оно не требует запуска git. Определение того, что каталог находится вне репозитория git, использует ту же проверку git, поэтому исключение для каталога вне репозитория вступает в силу после принятия диалога доверия, охватывающего папку. До версии 2.1.207 неотслеживаемый файл `.claude/settings.local.json` применял свои правила разрешений в этой папке до того, как вы приняли диалог.

537 

518Правила разрешений и дополнительные каталоги в `.claude/settings.local.json` также применяются без доверия рабочей области в двух случаях:538Правила разрешений и дополнительные каталоги в `.claude/settings.local.json` также применяются без доверия рабочей области в двух случаях:

519 539 

520* Каталог, из которого вы запустили Claude Code, находится вне репозитория git.540* Каталог, из которого вы запустили Claude Code, находится вне репозитория git.

platforms.md +1 −1

Details

23| [Web](/ru/claude-code-on-the-web) | Долгосрочные задачи, которые не требуют большого управления, или работа, которая должна продолжаться, когда вы в сети | Облако, управляемое Anthropic, продолжается после отключения |23| [Web](/ru/claude-code-on-the-web) | Долгосрочные задачи, которые не требуют большого управления, или работа, которая должна продолжаться, когда вы в сети | Облако, управляемое Anthropic, продолжается после отключения |

24| Mobile | Запуск и мониторинг задач вдали от вашего компьютера | Облачные сеансы из приложения Claude для iOS и Android, [Remote Control](/ru/remote-control) для локальных сеансов, [Dispatch](/ru/desktop#sessions-from-dispatch) на Desktop на Pro и Max |24| Mobile | Запуск и мониторинг задач вдали от вашего компьютера | Облачные сеансы из приложения Claude для iOS и Android, [Remote Control](/ru/remote-control) для локальных сеансов, [Dispatch](/ru/desktop#sessions-from-dispatch) на Desktop на Pro и Max |

25 25 

26CLI — это наиболее полная поверхность для работы, ориентированной на терминал: скриптинг и Agent SDK доступны только в CLI. Сторонние поставщики также работают в [VS Code](/ru/vs-code#use-third-party-providers). Корпоративные развёртывания [Desktop](/ru/desktop) поддерживают Google Cloud's Agent Platform и поставщиков шлюза; для Amazon Bedrock или Microsoft Foundry используйте CLI или VS Code, или [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview), который запускает вкладку Code на этих поставщиках. Desktop и расширения IDE обменивают некоторые функции, доступные только в CLI, на визуальный просмотр и более тесную интеграцию с редактором. Веб работает в облаке Anthropic, поэтому задачи продолжают выполняться после отключения. Mobile — это тонкий клиент для этих же облачных сеансов или для локального сеанса через Remote Control, и может отправлять задачи на Desktop с помощью Dispatch.26CLI — это наиболее полная поверхность для работы, ориентированной на терминал: скриптинг и Agent SDK доступны только в CLI. Сторонние поставщики также работают в [VS Code](/ru/vs-code#use-third-party-providers). Корпоративные развёртывания [Desktop](/ru/desktop) поддерживают Google Cloud's Agent Platform, и Desktop поддерживает [поставщиков шлюза](/ru/llm-gateway-connect#desktop-app); для Amazon Bedrock или Microsoft Foundry используйте CLI или VS Code, или [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview), который запускает вкладку Code на этих поставщиках. Desktop и расширения IDE обменивают некоторые функции, доступные только в CLI, на визуальный просмотр и более тесную интеграцию с редактором. Веб работает в облаке Anthropic, поэтому задачи продолжают выполняться после отключения. Mobile — это тонкий клиент для этих же облачных сеансов или для локального сеанса через Remote Control, и может отправлять задачи на Desktop с помощью Dispatch.

27 27 

28Вы можете смешивать поверхности в одном проекте. Конфигурация, память проекта и MCP серверы совместно используются на локальных поверхностях.28Вы можете смешивать поверхности в одном проекте. Конфигурация, память проекта и MCP серверы совместно используются на локальных поверхностях.

29 29 

Details

4 4 

5# Ограничение версий зависимостей плагина5# Ограничение версий зависимостей плагина

6 6 

7> Объявляйте ограничения версий для зависимостей плагина, чтобы ваш плагин продолжал работать, когда вышестоящий плагин выпускает критическое изменение.7> Объявляйте ограничения версий для зависимостей плагина и объедините подобранный набор плагинов в одну установку.

8 8 

9Плагин может зависеть от других плагинов, указав их в `plugin.json` или в записи на marketplace. По умолчанию зависимость отслеживает последнюю доступную версию, поэтому вышестоящий выпуск может изменить зависимость в вашем плагине без предупреждения. Ограничения версий позволяют удерживать зависимость на протестированном диапазоне версий до тех пор, пока вы не решите перейти на новую версию.9Плагин может зависеть от других плагинов, указав их в `plugin.json` или в записи на marketplace. По умолчанию зависимость отслеживает последнюю доступную версию, поэтому вышестоящий выпуск может изменить зависимость в вашем плагине без предупреждения. Ограничения версий позволяют удерживать зависимость на протестированном диапазоне версий до тех пор, пока вы не решите перейти на новую версию.

10 10 


12 12 

13Это руководство предназначено для авторов плагинов, которые объявляют зависимости в `plugin.json`, и для администраторов marketplace, которые помечают выпуски. Чтобы установить плагины с зависимостями, см. [Обнаружение и установка плагинов](/ru/discover-plugins). Полную схему манифеста см. в [справочнике плагинов](/ru/plugins-reference).13Это руководство предназначено для авторов плагинов, которые объявляют зависимости в `plugin.json`, и для администраторов marketplace, которые помечают выпуски. Чтобы установить плагины с зависимостями, см. [Обнаружение и установка плагинов](/ru/discover-plugins). Полную схему манифеста см. в [справочнике плагинов](/ru/plugins-reference).

14 14 

15<Note>

16 Ограничения версий зависимостей требуют Claude Code v2.1.110 или более поздней версии.

17</Note>

18 

19<h2 id="why-constrain-dependency-versions">15<h2 id="why-constrain-dependency-versions">

20 Почему нужно ограничивать версии зависимостей16 Почему нужно ограничивать версии зависимостей

21</h2>17</h2>


55 51 

56Поле `version` принимает любое выражение, поддерживаемое пакетом `semver` Node, включая диапазоны с каретой, тильдой, дефисом и компаратором. Версии предварительного выпуска, такие как `2.0.0-beta.1`, исключаются, если ваш диапазон не выбирает их с суффиксом предварительного выпуска, например `^2.0.0-0`.52Поле `version` принимает любое выражение, поддерживаемое пакетом `semver` Node, включая диапазоны с каретой, тильдой, дефисом и компаратором. Версии предварительного выпуска, такие как `2.0.0-beta.1`, исключаются, если ваш диапазон не выбирает их с суффиксом предварительного выпуска, например `^2.0.0-0`.

57 53 

54<h2 id="bundle-plugins-for-a-team">

55 Объединение плагинов для команды

56</h2>

57 

58Помимо обязательного поля `name`, манифест плагина может состоять только из массива `dependencies`. Его установка подтягивает все зависимости, что позволяет упаковать тщательно отобранный набор плагинов в один установочный пакет.

59 

60Например, команда платформы может опубликовать специализированные наборы во внутреннем маркетплейсе, чтобы инженеры запустили одну команду `claude plugin install` вместо установки каждого инструмента отдельно:

61 

62```json .claude-plugin/plugin.json theme={null}

63{

64 "name": "backend-standard",

65 "version": "1.0.0",

66 "description": "Standard plugin set for backend engineers",

67 "dependencies": [

68 "secrets-vault",

69 "deploy-kit",

70 { "name": "db-migrate", "version": "^3.0" },

71 "oncall-runbook"

72 ]

73}

74```

75 

76Установка `backend-standard` разрешает и устанавливает все четыре зависимости.

77 

78Чтобы позже добавить инструмент в стандартный набор, опубликуйте новую версию `backend-standard` с дополнительной зависимостью. Автоматическое обновление отключено по умолчанию для маркетплейсов, не принадлежащих Anthropic, поэтому инженеры получают новую версию одним из двух способов:

79 

80* Включите автоматическое обновление для маркетплейса в `/plugin`. Следующее автоматическое обновление переместит пакет на новую версию и установит все добавленные им зависимости.

81* Запустите `claude plugin update backend-standard`, затем `/reload-plugins` для установки вновь добавленных зависимостей.

82 

83Чтобы развернуть пакеты по всей организации, добавьте плагин пакета в `enabledPlugins` в [управляемых параметрах](/ru/settings#enabledplugins).

84 

58<h2 id="depend-on-a-plugin-from-another-marketplace">85<h2 id="depend-on-a-plugin-from-another-marketplace">

59 Зависимость от плагина из другого marketplace86 Зависимость от плагина из другого marketplace

60</h2>87</h2>

plugin-hints.md +2 −0

Details

31 Выведите подсказку31 Выведите подсказку

32</h2>32</h2>

33 33 

34Подсказки срабатывают только для плагинов, указанных в официальном маркетплейсе Anthropic. Смотрите [Добавьте ваш плагин в официальный маркетплейс](#get-your-plugin-into-the-official-marketplace) перед тем, как вы развернёте интеграцию.

35 

34Обусловьте вывод переменной окружения, чтобы маркер был маловероятен при прямом запуске вашего CLI пользователем, затем выведите тег в stderr на отдельной строке. Выберите, какую переменную проверять:36Обусловьте вывод переменной окружения, чтобы маркер был маловероятен при прямом запуске вашего CLI пользователем, затем выведите тег в stderr на отдельной строке. Выберите, какую переменную проверять:

35 37 

36* `CLAUDECODE`: устанавливается в каждой версии Claude Code, поэтому достигает большинства сеансов. Она также устанавливается в tmux сеансах и подпроцессах stdio MCP сервера, которые запускает Claude Code. Расширения IDE также устанавливают её в своих интегрированных терминалах, где пользователь может запускать ваш CLI напрямую.38* `CLAUDECODE`: устанавливается в каждой версии Claude Code, поэтому достигает большинства сеансов. Она также устанавливается в tmux сеансах и подпроцессах stdio MCP сервера, которые запускает Claude Code. Расширения IDE также устанавливают её в своих интегрированных терминалах, где пользователь может запускать ваш CLI напрямую.

Details

205 205 

206Каждая запись плагина в массиве `plugins` описывает плагин и где его найти. Вы можете включить любое поле из [схемы манифеста плагина](/ru/plugins-reference#plugin-manifest-schema), такие как `description`, `version`, `author`, `commands` и `hooks`, плюс эти поля, специфичные для marketplace: `source`, `category`, `tags`, `strict` и `relevance`.206Каждая запись плагина в массиве `plugins` описывает плагин и где его найти. Вы можете включить любое поле из [схемы манифеста плагина](/ru/plugins-reference#plugin-manifest-schema), такие как `description`, `version`, `author`, `commands` и `hooks`, плюс эти поля, специфичные для marketplace: `source`, `category`, `tags`, `strict` и `relevance`.

207 207 

208<h3 id="required-fields-1">208<h3 id="required-fields-2">

209 Обязательные поля209 Обязательные поля

210</h3>210</h3>

211 211 


509Ключевые моменты, на которые следует обратить внимание:509Ключевые моменты, на которые следует обратить внимание:

510 510 

511* **`commands` и `agents`**: вы можете указать несколько каталогов или отдельные файлы. Пути относительны к корню плагина.511* **`commands` и `agents`**: вы можете указать несколько каталогов или отдельные файлы. Пути относительны к корню плагина.

512* **`${CLAUDE_PLUGIN_ROOT}`**: Используйте эту переменную в hooks и конфигурациях MCP server для ссылки на файлы в каталоге установки плагина. Это необходимо, потому что плагины копируются в место кэша при установке. Для зависимостей или состояния, которое должно сохраняться при обновлениях плагина, используйте [`${CLAUDE_PLUGIN_DATA}`](/ru/plugins-reference#persistent-data-directory) вместо этого.512* **`${CLAUDE_PLUGIN_ROOT}`**: используйте эту переменную в командах hooks и конфигурациях MCP server для ссылки на файлы в каталоге установки плагина. Это необходимо, потому что плагины копируются в место кэша при установке.

513 * См. [таблицу подстановки](/ru/plugins-reference#environment-variables) для того, какие поля конфигурации подставляют её для каждого типа сервера

514 * Для зависимостей или состояния, которое должно сохраняться при обновлениях плагина, используйте [`${CLAUDE_PLUGIN_DATA}`](/ru/plugins-reference#persistent-data-directory) вместо этого

513* **`strict: false`**: поскольку это установлено на false, плагину не нужен собственный `plugin.json`. Запись marketplace определяет все. См. [Strict mode](#strict-mode) ниже.515* **`strict: false`**: поскольку это установлено на false, плагину не нужен собственный `plugin.json`. Запись marketplace определяет все. См. [Strict mode](#strict-mode) ниже.

514 516 

515По умолчанию skills плагина загружаются из каталога `skills/` в его `source`. Пути, указанные в поле `skills`, добавляются к этому сканированию:517По умолчанию skills плагина загружаются из каталога `skills/` в его `source`. Пути, указанные в поле `skills`, добавляются к этому сканированию:


573 Частные репозитории575 Частные репозитории

574</h3>576</h3>

575 577 

576Claude Code поддерживает установку плагинов из частных репозиториев. Для ручной установки и обновлений Claude Code использует ваши существующие помощники учетных данных Git, поэтому доступ HTTPS через `gh auth login`, macOS Keychain или `git-credential-store` работает так же, как в вашем терминале. Доступ SSH работает, пока хост уже находится в вашем файле `known_hosts` и ключ загружен в `ssh-agent`, так как Claude Code подавляет интерактивные подсказки SSH для отпечатка хоста и пароля ключа.578Claude Code поддерживает установку плагинов из частных репозиториев. Для ручной установки и обновлений Claude Code использует ваши существующие помощники учетных данных Git, поэтому доступ HTTPS через `gh auth login`, macOS Keychain или `git-credential-store` работает так же, как в вашем терминале. Доступ SSH работает, пока хост уже находится в вашем файле `known_hosts` и ключ загружен в `ssh-agent`, так как Claude Code подавляет интерактивные подсказки SSH для отпечатка хоста и пароля ключа. Сокращение GitHub `owner/repo` по умолчанию клонирует через SSH; установите [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/ru/env-vars#variables), чтобы вместо этого клонировать их через HTTPS.

577 579 

578Фоновые автоматические обновления работают иначе. По умолчанию фоновое обновление отключает помощников учетных данных Git для своего `git pull`, поэтому pull не может аутентифицироваться в частных репозиториях через HTTPS, даже если помощник настроен. Удаленные SSH не затронуты: ключ, загруженный в `ssh-agent`, аутентифицирует фоновые pull так же, как ручные операции. Когда фоновый pull не удается, Claude Code возвращается к повторному клонированию marketplace с нуля. Повторное клонирование использует ваши сохраненные учетные данные Git, но оно может [истечь на больших репозиториях](#git-operations-time-out), поэтому автоматические обновления частного marketplace могут периодически не удаваться.580Фоновые автоматические обновления работают иначе. По умолчанию фоновое обновление отключает помощников учетных данных Git для своего `git pull`, поэтому pull не может аутентифицироваться в частных репозиториях через HTTPS, даже если помощник настроен. Удаленные SSH не затронуты: ключ, загруженный в `ssh-agent`, аутентифицирует фоновые pull так же, как ручные операции. Когда фоновый pull не удается, Claude Code возвращается к повторному клонированию marketplace с нуля. Повторное клонирование использует ваши сохраненные учетные данные Git, но оно может [истечь на больших репозиториях](#git-operations-time-out), поэтому автоматические обновления частного marketplace могут периодически не удаваться.

579 581 


697 Ограничения управляемого marketplace699 Ограничения управляемого marketplace

698</h3>700</h3>

699 701 

700Для организаций, требующих строгого контроля над источниками плагинов, администраторы могут ограничить, какие marketplace плагинов пользователи могут добавлять, используя параметр [`strictKnownMarketplaces`](/ru/settings#strictknownmarketplaces) в управляемых параметрах. Чтобы также отклонить флаги CLI, которые загружают плагины, агентов и MCP серверы для одного запуска, объедините его с [`disableSideloadFlags`](/ru/settings#available-settings).702Для организаций, требующих строгого контроля над источниками плагинов, администраторы могут ограничить, какие marketplace плагинов пользователи могут добавлять, используя параметр [`strictKnownMarketplaces`](/ru/settings#strictknownmarketplaces) в управляемых параметрах. Чтобы также отклонить флаги CLI, которые загружают плагины, агентов и MCP серверы для одного запуска, объедините его с [`disableSideloadFlags`](/ru/settings#available-settings). Чтобы разрешить список, какие marketplace плагинов могут появляться как предложения контекстной установки, установите [`pluginSuggestionMarketplaces`](/ru/settings#available-settings).

701 703 

702Когда `strictKnownMarketplaces` настроен в управляемых параметрах, поведение ограничения зависит от значения:704Когда `strictKnownMarketplaces` настроен в управляемых параметрах, поведение ограничения зависит от значения:

703 705 


1085 Plugin marketplace update1087 Plugin marketplace update

1086</h3>1088</h3>

1087 1089 

1088Обновите marketplace из их источников, чтобы получить новые плагины и изменения версий.1090Обновите marketplace из их источников, чтобы получить новые плагины и изменения версий. Marketplace, добавленный с веткой или тегом `ref`, обновляется до последнего коммита этого ref, а не до ветки по умолчанию репозитория.

1089 1091 

1090```bash theme={null}1092```bash theme={null}

1091claude plugin marketplace update [name]1093claude plugin marketplace update [name]

Details

185 },185 },

186 "plugin-api-client": {186 "plugin-api-client": {

187 "command": "npx",187 "command": "npx",

188 "args": ["@company/mcp-server", "--plugin-mode"],188 "args": ["@company/mcp-server", "--plugin-mode"]

189 "cwd": "${CLAUDE_PLUGIN_ROOT}"

190 }189 }

191 }190 }

192}191}


303 302 

304Плагины monitors используют тот же механизм, что и [инструмент Monitor](/ru/tools-reference#monitor-tool), и разделяют его ограничения доступности. Они работают только в интерактивных сеансах CLI, работают без песочницы на том же уровне доверия, что и [hooks](#hooks), и пропускаются на хостах, где инструмент Monitor недоступен.303Плагины monitors используют тот же механизм, что и [инструмент Monitor](/ru/tools-reference#monitor-tool), и разделяют его ограничения доступности. Они работают только в интерактивных сеансах CLI, работают без песочницы на том же уровне доверия, что и [hooks](#hooks), и пропускаются на хостах, где инструмент Monitor недоступен.

305 304 

306<Note>

307 Плагины monitors требуют Claude Code v2.1.105 или позже.

308</Note>

309 

310**Расположение**: `monitors/monitors.json` в корне плагина или встроенный в `plugin.json`305**Расположение**: `monitors/monitors.json` в корне плагина или встроенный в `plugin.json`

311 306 

312**Формат**: Массив JSON записей monitor307**Формат**: Массив JSON записей monitor


317[312[

318 {313 {

319 "name": "deploy-status",314 "name": "deploy-status",

320 "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/poll-deploy.sh ${user_config.api_endpoint}",315 "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/poll-deploy.sh",

321 "description": "Deployment status changes"316 "description": "Deployment status changes"

322 },317 },

323 {318 {


345| :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |340| :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

346| `when` | Управляет тем, когда запускается monitor. `"always"` запускает его при запуске сеанса и при перезагрузке плагина и является значением по умолчанию. `"on-skill-invoke:<skill-name>"` запускает его в первый раз, когда именованный skill в этом плагине отправляется |341| `when` | Управляет тем, когда запускается monitor. `"always"` запускает его при запуске сеанса и при перезагрузке плагина и является значением по умолчанию. `"on-skill-invoke:<skill-name>"` запускает его в первый раз, когда именованный skill в этом плагине отправляется |

347 342 

348Значение `command` поддерживает те же [подстановки переменных](#environment-variables), что и конфигурации серверов MCP и LSP: `${CLAUDE_PLUGIN_ROOT}`, `${CLAUDE_PLUGIN_DATA}`, `${CLAUDE_PROJECT_DIR}`, `${user_config.*}` и любой `${ENV_VAR}` из окружения. Добавьте префикс команды с `cd "${CLAUDE_PLUGIN_ROOT}" && `, если скрипт должен работать из собственного каталога плагина.343Значение `command` поддерживает [подстановки переменных](#environment-variables) `${CLAUDE_PLUGIN_ROOT}`, `${CLAUDE_PLUGIN_DATA}` и `${CLAUDE_PROJECT_DIR}`, плюс любой `${ENV_VAR}` из окружения. Добавьте префикс команды с `cd "${CLAUDE_PLUGIN_ROOT}" && `, если скрипт должен работать из собственного каталога плагина.

344 

345Команда monitor не может ссылаться на значения [`${user_config.*}`](#user-configuration). Команда работает через оболочку, поэтому Claude Code отклоняет monitor с [ошибкой](/ru/errors#plugin-command-references-user-config) вместо подстановки значения. Процессы monitor не получают переменные окружения `CLAUDE_PLUGIN_OPTION_<KEY>`, поэтому пусть скрипт monitor читает значение из файла конфигурации, который он владеет. До v2.1.207 команды monitor подставляли значения `${user_config.*}`.

349 346 

350Отключение плагина в середине сеанса не останавливает monitors, которые уже работают. Они останавливаются при завершении сеанса.347Отключение плагина в середине сеанса не останавливает monitors, которые уже работают. Они останавливаются при завершении сеанса.

351 348 


602| `multiple` | Нет | Для типа `string`, разрешить массив строк |599| `multiple` | Нет | Для типа `string`, разрешить массив строк |

603| `min` / `max` | Нет | Границы для типа `number` |600| `min` / `max` | Нет | Границы для типа `number` |

604 601 

605Каждое значение доступно для подстановки как `${user_config.KEY}` в конфигурациях серверов MCP и LSP, командах hooks и командах monitors. Нечувствительные значения также могут быть подставлены в содержимое skills и agents. Все значения экспортируются в подпроцессы плагина как переменные окружения `CLAUDE_PLUGIN_OPTION_<KEY>`.602Каждое значение доступно для подстановки как `${user_config.KEY}` в конфигурациях серверов MCP и LSP и командах hooks. Нечувствительные значения также могут быть подставлены в содержимое skills и agents. Все значения экспортируются в процессы hooks как переменные окружения `CLAUDE_PLUGIN_OPTION_<KEY>`, где `<KEY>` — это ключ опции в верхнем регистре.

603 

604Поля, которые работают в shell, отклоняют `${user_config.*}`: подстановка настроенного значения в команду shell позволила бы shell выполнить всё, что содержит это значение, поэтому компонент не работает с [ошибкой](/ru/errors#plugin-command-references-user-config). Каждое отклонённое поле имеет альтернативный способ передачи значения:

605 

606| Отклонённое поле | Как передать значение |

607| :--------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

608| Команды hooks в форме shell | Используйте [форму exec](/ru/hooks#exec-form-and-shell-form) с `args` или читайте `CLAUDE_PLUGIN_OPTION_<KEY>` из окружения hook |

609| Команды [Monitor](#monitors) | Читайте значение из файла конфигурации в скрипте |

610| MCP [`headersHelper`](/ru/mcp#use-dynamic-headers-for-custom-authentication) | Читайте значение из файла конфигурации в скрипте |

611 

612До v2.1.207 эти поля подставляли значения `${user_config.KEY}`; обновите плагины, которые полагались на это.

613 

614Нечувствительные значения хранятся под ключом [`pluginConfigs`](/ru/settings#pluginconfigs) в `settings.json` как `pluginConfigs[<plugin-id>].options`. {/* min-version: 2.1.207 */}Claude Code записывает ключ в параметры пользователя и читает его обратно из параметров пользователя, флага `--settings` и управляемых параметров только; записи в `.claude/settings.json` или `.claude/settings.local.json` проекта игнорируются. До v2.1.207 Claude Code также читал параметры проекта и локальные параметры.

606 615 

607Нечувствительные значения хранятся в `settings.json` под `pluginConfigs[<plugin-id>].options`. Чувствительные значения переходят в системный keychain (или `~/.claude/.credentials.json`, где keychain недоступен). Хранилище keychain общее с OAuth токенами и имеет приблизительный лимит 2 КБ, поэтому держите чувствительные значения небольшими.616Чувствительные значения переходят в macOS Keychain или в `~/.claude/.credentials.json` на платформах, где keychain недоступен. Хранилище Keychain общее с OAuth токенами и имеет приблизительный лимит 2 КБ, поэтому держите чувствительные значения небольшими.

608 617 

609<h3 id="channels">618<h3 id="channels">

610 Каналы619 Каналы


677 Переменные окружения686 Переменные окружения

678</h3>687</h3>

679 688 

680Claude Code предоставляет три переменные для ссылки на пути. Все они подставляются встроенно везде, где они появляются в содержимом skills, содержимом agents, командах hooks, командах monitors и конфигурациях серверов MCP или LSP. Все они также экспортируются как переменные окружения в процессы hooks и подпроцессы серверов MCP или LSP.689Claude Code предоставляет три переменные для ссылки на пути:

681 690 

682**`${CLAUDE_PLUGIN_ROOT}`**: абсолютный путь к каталогу установки вашего плагина. Используйте это для ссылки на скрипты, двоичные файлы и файлы конфигурации, поставляемые с плагином. В командах hooks используйте [форму exec](/ru/hooks#exec-form-and-shell-form) с `args`, чтобы путь передавался как один аргумент без кавычек. В hooks в форме shell и командах monitors оборачивайте его в двойные кавычки, как в `"${CLAUDE_PLUGIN_ROOT}"`. Этот путь изменяется при обновлении плагина. Каталог предыдущей версии остаётся на диске примерно семь дней после обновления перед очисткой, но рассматривайте его как временный и не записывайте состояние здесь.691| Переменная | Разрешается в | Используйте для |

692| :---------------------- | :---------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- |

693| `${CLAUDE_PLUGIN_ROOT}` | Абсолютный путь к каталогу установки плагина | Скрипты, двоичные файлы и файлы конфигурации, поставляемые с плагином |

694| `${CLAUDE_PLUGIN_DATA}` | [Постоянный каталог](#persistent-data-directory), который сохраняется при обновлениях плагина, создаётся при первом обращении | Установленные зависимости, такие как `node_modules` или виртуальные окружения Python, сгенерированный код и кэши |

695| `${CLAUDE_PROJECT_DIR}` | Корень проекта | Скрипты и файлы конфигурации, локальные для проекта |

683 696 

684Когда плагин обновляется во время сеанса, команды hooks, monitors, серверы MCP и серверы LSP продолжают использовать путь предыдущей версии. Запустите `/reload-plugins` для переключения hooks, серверов MCP и серверов LSP на новый путь; monitors требуют перезагрузки сеанса.697Все три экспортируются как переменные окружения в процессы hooks и в подпроцессы серверов MCP и LSP. Какие поля подставляют их встроенно, зависит от компонента плагина:

685 

686**`${CLAUDE_PLUGIN_DATA}`**: постоянный каталог для состояния плагина, который сохраняется при обновлениях. Используйте это для установленных зависимостей, таких как `node_modules` или виртуальные окружения Python, сгенерированный код, кэши и любые другие файлы, которые должны сохраняться между версиями плагина. Каталог создаётся автоматически при первом обращении к этой переменной.

687 698 

688**`${CLAUDE_PROJECT_DIR}`**: корень проекта. Это тот же каталог, который hooks получают в своей переменной `CLAUDE_PROJECT_DIR`. Используйте это для ссылки на скрипты или файлы конфигурации, локальные для проекта. Оборачивайте в кавычки для обработки путей с пробелами, например `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`.699| Компонент плагина | Поля, где разрешаются заполнители |

700| :------------------------------ | :------------------------------------------ |

701| Содержимое skill и agent | Везде, где появляется заполнитель |

702| Команды hook и monitor | Везде, где появляется заполнитель |

703| MCP серверы `stdio` | `command`, `args`, `env` |

704| MCP серверы `http`, `sse`, `ws` | `url`, `headers`, `headersHelper` |

705| Серверы LSP | `command`, `args`, `env`, `workspaceFolder` |

689 706 

690Серверы MCP также могут вызывать запрос `roots/list` для чтения рабочих каталогов сеанса во время выполнения. Смотрите [что возвращает `roots/list` и когда Claude Code уведомляет сервер об изменениях](/ru/mcp#option-3-add-a-local-stdio-server).707В командах hook используйте [форму exec](/ru/hooks#exec-form-and-shell-form) с `args`, чтобы каждый путь передавался как один аргумент без кавычек. В hooks в форме shell и командах monitor оборачивайте переменные в двойные кавычки, как в `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`. Этот hook в форме shell запускает скрипт, поставляемый с плагином:

691 708 

692```json theme={null}709```json theme={null}

693{710{


706}723}

707```724```

708 725 

726`${CLAUDE_PLUGIN_ROOT}` изменяется при обновлении плагина. Каталог предыдущей версии остаётся на диске примерно семь дней после обновления перед очисткой, но рассматривайте его как временный и не записывайте состояние там.

727 

728Когда плагин обновляется во время сеанса, команды hooks, monitors, серверы MCP и серверы LSP продолжают использовать путь предыдущей версии. Запустите `/reload-plugins` для переключения hooks, серверов MCP и серверов LSP на новый путь; monitors требуют перезагрузки сеанса.

729 

730Серверы MCP также могут вызывать запрос `roots/list` для чтения рабочих каталогов сеанса во время выполнения. Смотрите [что возвращает `roots/list` и когда Claude Code уведомляет сервер об изменениях](/ru/mcp#option-3-add-a-local-stdio-server).

731 

709<h4 id="persistent-data-directory">732<h4 id="persistent-data-directory">

710 Каталог постоянных данных733 Каталог постоянных данных

711</h4>734</h4>

Details

102Определения инструментов находятся в слое системного запроса, поэтому кэш инвалидируется, когда набор определений инструментов в запросе изменяется между ходами. Переключение [инструмента advisor](/ru/advisor) является исключением: его определение находится после точки разрыва кэша, поэтому включение или отключение `/advisor` сохраняет кэшированный префикс нетронутым. Зависит ли [изменение MCP сервера](/ru/mcp) от этого, зависит от того, отложены ли его инструменты [поиском инструментов](/ru/mcp#scale-with-mcp-tool-search) или загружены в префикс:102Определения инструментов находятся в слое системного запроса, поэтому кэш инвалидируется, когда набор определений инструментов в запросе изменяется между ходами. Переключение [инструмента advisor](/ru/advisor) является исключением: его определение находится после точки разрыва кэша, поэтому включение или отключение `/advisor` сохраняет кэшированный префикс нетронутым. Зависит ли [изменение MCP сервера](/ru/mcp) от этого, зависит от того, отложены ли его инструменты [поиском инструментов](/ru/mcp#scale-with-mcp-tool-search) или загружены в префикс:

103 103 

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

105* **Инструменты, загруженные в префикс**: любое изменение их инвалидирует кэш. Это происходит, когда [поиск инструментов недоступен или отключен](/ru/mcp#configure-tool-search), например на моделях Haiku, на Google Cloud's Agent Platform или с пользовательским шлюзом `ANTHROPIC_BASE_URL`. Это также происходит для сервера или инструмента, отмеченного [`alwaysLoad`](/ru/mcp#exempt-a-server-from-deferral), и для определений, сохраняемых впереди [загрузкой на основе порога](/ru/mcp#configure-tool-search).105* **Инструменты, загруженные в префикс**: любое изменение их инвалидирует кэш. Это происходит, когда [поиск инструментов недоступен или отключен](/ru/mcp#configure-tool-search), например на Google Cloud's Agent Platform или с пользовательским шлюзом `ANTHROPIC_BASE_URL`. Это также происходит для сервера или инструмента, отмеченного [`alwaysLoad`](/ru/mcp#exempt-a-server-from-deferral), и для определений, сохраняемых впереди [загрузкой на основе порога](/ru/mcp#configure-tool-search).

106 106 

107Когда инструменты загружаются в префикс, наиболее частая причина инвалидации — это подключение или отключение сервера в середине сеанса, что может произойти без каких-либо действий с вашей стороны: процесс stdio сервера выходит, сеанс HTTP истекает, или сервер [автоматически переподключается после временного сбоя](/ru/mcp#automatic-reconnection). Подключённый сервер также может отправить [динамическое обновление инструмента](/ru/mcp#dynamic-tool-updates), которое изменяет его список инструментов.107Когда инструменты загружаются в префикс, наиболее частая причина инвалидации — это подключение или отключение сервера в середине сеанса, что может произойти без каких-либо действий с вашей стороны: процесс stdio сервера выходит, сеанс HTTP истекает, или сервер [автоматически переподключается после временного сбоя](/ru/mcp#automatic-reconnection). Подключённый сервер также может отправить [динамическое обновление инструмента](/ru/mcp#dynamic-tool-updates), которое изменяет его список инструментов.

108 108 

remote-control.md +14 −10

Details

12 12 

13Remote Control подключает [claude.ai/code](https://claude.ai/code) или приложение Claude для [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) и [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) к сеансу Claude Code, работающему на вашем компьютере. Начните задачу за столом, а затем продолжите её со своего телефона на диване или в браузере на другом компьютере.13Remote Control подключает [claude.ai/code](https://claude.ai/code) или приложение Claude для [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) и [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) к сеансу Claude Code, работающему на вашем компьютере. Начните задачу за столом, а затем продолжите её со своего телефона на диване или в браузере на другом компьютере.

14 14 

15Когда вы запускаете сеанс Remote Control на своем компьютере, Claude продолжает работать локально всё время, поэтому ничего не переходит в облако. С помощью Remote Control вы можете:15Когда вы запускаете сеанс Remote Control на своем компьютере, Claude продолжает работать локально всё время, поэтому выполнение кода и доступ к файловой системе остаются на вашем компьютере. С помощью Remote Control вы можете:

16 16 

17* **Использовать полную локальную среду удалённо**: ваша файловая система, [MCP servers](/ru/mcp), инструменты и конфигурация проекта остаются доступными, и ввод `@` автоматически дополняет пути файлов из вашего локального проекта17* **Использовать полную локальную среду удалённо**: ваша файловая система, [MCP servers](/ru/mcp), инструменты и конфигурация проекта остаются доступными, и ввод `@` автоматически дополняет пути файлов из вашего локального проекта

18* **Работать с обеих поверхностей одновременно**: беседа остаётся синхронизированной на всех подключённых устройствах, поэтому вы можете отправлять сообщения из терминала, браузера и телефона взаимозаменяемо18* **Работать с обеих поверхностей одновременно**: беседа и прогресс [subagents](/ru/sub-agents) и [dynamic workflows](/ru/workflows) остаются синхронизированными на всех подключённых устройствах, поэтому вы можете отправлять сообщения из терминала, браузера и телефона взаимозаменяемо. {/* min-version: 2.1.207 */}До версии 2.1.207 сеансы, размещённые на [Desktop app](/ru/desktop), не отправляли прогресс subagents или workflows на подключённые устройства.

19* **Отправлять изображения и файлы со своего телефона или браузера**: когда вы добавляете вложение в приложение Claude или на claude.ai/code, Claude Code загружает его на ваш компьютер и передаёт его Claude как ссылку на файл `@`, с подписью или без неё. {/* min-version: 2.1.202 */}До версии 2.1.202 Claude Code мог удалить вложение, отправленное без подписи, прежде чем оно достигло сеанса.19* **Отправлять изображения и файлы со своего телефона или браузера**: когда вы добавляете вложение в приложение Claude или на claude.ai/code, Claude Code загружает его на ваш компьютер и передаёт его Claude как ссылку на файл `@`, с подписью или без неё. {/* min-version: 2.1.202 */}До версии 2.1.202 Claude Code мог удалить вложение, отправленное без подписи, прежде чем оно достигло сеанса.

20* **Пережить перебои**: если ваш ноутбук перейдёт в режим сна или сетевое соединение разорвётся, сеанс автоматически переподключится, когда ваш компьютер вернётся в сеть20* **Пережить перебои**: если ваш ноутбук перейдёт в режим сна или сетевое соединение разорвётся, сеанс автоматически переподключится, когда ваш компьютер вернётся в сеть. Claude Code ставит в очередь обновления статуса от subagents и workflows во время восстановления соединения и доставляет их после восстановления. {/* min-version: 2.1.207 */}До версии 2.1.207 обновление, отправленное во время переподключения или обновления учётных данных, могло быть потеряно, поэтому подключённое устройство продолжало показывать завершённую задачу как выполняющуюся.

21 21 

22В отличие от [Claude Code в веб-версии](/ru/claude-code-on-the-web), которая работает на облачной инфраструктуре, сеансы Remote Control работают непосредственно на вашем компьютере и взаимодействуют с вашей локальной файловой системой. Веб- и мобильные интерфейсы — это просто окно в этот локальный сеанс.22В отличие от [Claude Code в веб-версии](/ru/claude-code-on-the-web), которая работает на облачной инфраструктуре, сеансы Remote Control работают непосредственно на вашем компьютере и взаимодействуют с вашей локальной файловой системой. Веб- и мобильные интерфейсы — это просто окно в этот локальный сеанс.

23 23 


132* **Отсканируйте QR-код**, показанный рядом с URL сеанса, чтобы открыть его непосредственно в приложении Claude. С помощью `claude remote-control` нажмите пробел, чтобы переключить отображение QR-кода.132* **Отсканируйте QR-код**, показанный рядом с URL сеанса, чтобы открыть его непосредственно в приложении Claude. С помощью `claude remote-control` нажмите пробел, чтобы переключить отображение QR-кода.

133* **Откройте [claude.ai/code](https://claude.ai/code) или приложение Claude** и найдите сеанс по имени в списке сеансов. В мобильном приложении Claude нажмите **Code** в навигации, чтобы перейти к списку сеансов. Сеансы Remote Control показывают значок компьютера с зелёной точкой статуса при подключении.133* **Откройте [claude.ai/code](https://claude.ai/code) или приложение Claude** и найдите сеанс по имени в списке сеансов. В мобильном приложении Claude нажмите **Code** в навигации, чтобы перейти к списку сеансов. Сеансы Remote Control показывают значок компьютера с зелёной точкой статуса при подключении.

134 134 

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

136 

135Название удалённого сеанса выбирается в следующем порядке:137Название удалённого сеанса выбирается в следующем порядке:

136 138 

1371. Имя, которое вы передали в `--name`, `--remote-control` или `/remote-control`1391. Имя, которое вы передали в `--name`, `--remote-control` или `/remote-control`


161 163 

162Весь трафик проходит через API Anthropic через TLS, тот же транспортный протокол безопасности, что и любой сеанс Claude Code. Соединение использует несколько краткосрочных учётных данных, каждое из которых ограничено одной целью и истекает независимо.164Весь трафик проходит через API Anthropic через TLS, тот же транспортный протокол безопасности, что и любой сеанс Claude Code. Соединение использует несколько краткосрочных учётных данных, каждое из которых ограничено одной целью и истекает независимо.

163 165 

166Пока Remote Control подключен, стенограмма сеанса, включая ваши сообщения, ответы Claude и активность инструментов, хранится на серверах Anthropic. Сохраненная стенограмма синхронизирует беседу на всех ваших устройствах и позволяет сеансу переподключиться после разрыва сети. Выполнение и доступ к файловой системе остаются на вашем компьютере, а сохраненные стенограммы хранятся в соответствии с политикой [Использование данных](/ru/data-usage).

167 

168Чтобы полностью отключить Remote Control, используйте параметр [`disableRemoteControl`](/ru/settings#available-settings). Организации с требованиями соответствия, такими как Zero Data Retention, не могут включить Remote Control.

169 

164<h2 id="trusted-devices">170<h2 id="trusted-devices">

165 Доверенные устройства171 Доверенные устройства

166</h2>172</h2>


240 246 

241Claude решает, когда отправить уведомление. Обычно он отправляет одно, когда завершается долгоживущая задача или когда ему нужно решение от вас для продолжения. Вы также можете запросить push в своей подсказке, например `notify me when the tests finish`. Помимо двух переключателей включения/отключения ниже, нет конфигурации для каждого события.247Claude решает, когда отправить уведомление. Обычно он отправляет одно, когда завершается долгоживущая задача или когда ему нужно решение от вас для продолжения. Вы также можете запросить push в своей подсказке, например `notify me when the tests finish`. Помимо двух переключателей включения/отключения ниже, нет конфигурации для каждого события.

242 248 

243<Note>

244 Мобильные push-уведомления требуют Claude Code версии 2.1.110 или позже.

245</Note>

246 

247Чтобы настроить мобильные push-уведомления:249Чтобы настроить мобильные push-уведомления:

248 250 

249<Steps>251<Steps>


281* **Продолжительный сбой сети**: если ваш компьютер включен, но не может достичь сеть более чем примерно на 10 минут, сеанс истекает и процесс завершается. Запустите `claude remote-control` снова, чтобы начать новый сеанс.283* **Продолжительный сбой сети**: если ваш компьютер включен, но не может достичь сеть более чем примерно на 10 минут, сеанс истекает и процесс завершается. Запустите `claude remote-control` снова, чтобы начать новый сеанс.

282* **Ultraplan отключает Remote Control**: запуск сеанса [ultraplan](/ru/ultraplan) отключает любой активный сеанс Remote Control, потому что обе функции занимают интерфейс claude.ai/code и одновременно может быть подключена только одна.284* **Ultraplan отключает Remote Control**: запуск сеанса [ultraplan](/ru/ultraplan) отключает любой активный сеанс Remote Control, потому что обе функции занимают интерфейс claude.ai/code и одновременно может быть подключена только одна.

283* **Некоторые команды работают только локально**: команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, работают только из локального CLI, независимо от того, передаёте ли вы аргумент или нет. Следующие команды работают с мобильных устройств и веб-браузеров:285* **Некоторые команды работают только локально**: команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, работают только из локального CLI, независимо от того, передаёте ли вы аргумент или нет. Следующие команды работают с мобильных устройств и веб-браузеров:

284 * Команды с текстовым выводом: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, `/reload-plugins`286 * Команды с текстовым выводом: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits` (запускает текстовую форму вместо открытия диалога в CLI), `/recap`, `/reload-plugins`

285 * `/model`, `/effort`, `/fast`, `/color` и `/rename`: передайте значение как аргумент, например `/model sonnet` или `/effort high`. С мобильных устройств и веб-браузеров `/model` и `/effort` принимают аргумент вместо выбора в терминале или ползунка.287 * `/model`, `/effort`, `/fast`, `/color` и `/rename`: передайте значение как аргумент, например `/model sonnet` или `/effort high`. С мобильных устройств и веб-браузеров `/model` и `/effort` принимают аргумент вместо выбора в терминале или ползунка.

286 * {/* min-version: 2.1.166 */}`/mcp`, начиная с версии 2.1.166: возвращает текстовое резюме статуса сервера вместо открытия выбора и принимает подкоманды `reconnect`, `enable` и `disable` [](/ru/commands#all-commands). В отличие от локального CLI, `/mcp reconnect` без имени сервера переподключает каждый сервер, который не работает или требует аутентификации.288 * {/* min-version: 2.1.166 */}`/mcp`, начиная с версии 2.1.166: с мобильного приложения возвращает текстовое резюме статуса сервера вместо открытия выбора. В веб-версии `/mcp` без аргументов открывает каталог [соединителей claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai) вместо возврата резюме. Подкоманды `reconnect`, `enable` и `disable` [](/ru/commands#all-commands) работают с обеих версий. В отличие от локального CLI, `/mcp reconnect` без имени сервера переподключает каждый сервер, который не работает или требует аутентификации.

287 * {/* min-version: 2.1.181 */}`/config`, начиная с версии 2.1.181: передайте `key=value` для установки параметра или запустите её без аргументов, чтобы вывести список ключей, которые вы можете установить.289 * {/* min-version: 2.1.181 */}`/config`, начиная с версии 2.1.181: с мобильного приложения передайте `key=value` для установки параметра или запустите её без аргументов, чтобы вывести список ключей, которые вы можете установить. В веб-версии `/config` открывает раздел Claude Code ваших параметров и игнорирует текст после команды.

288 290 

289<h2 id="troubleshooting">291<h2 id="troubleshooting">

290 Устранение неполадок292 Устранение неполадок


296 298 

297Вы не аутентифицированы с помощью учётной записи claude.ai. Запустите `claude auth login` и выберите опцию claude.ai. Если в вашей среде установлена переменная `ANTHROPIC_API_KEY`, отключите её сначала.299Вы не аутентифицированы с помощью учётной записи claude.ai. Запустите `claude auth login` и выберите опцию claude.ai. Если в вашей среде установлена переменная `ANTHROPIC_API_KEY`, отключите её сначала.

298 300 

301{/* min-version: 2.1.206 */}До версии 2.1.206 запуск `/remote-control` при выходе из системы сообщал `Unknown command: /remote-control` вместо этого сообщения.

302 

299<h3 id="remote-control-requires-a-full-scope-login-token">303<h3 id="remote-control-requires-a-full-scope-login-token">

300 "Remote Control requires a full-scope login token"304 "Remote Control requires a full-scope login token"

301</h3>305</h3>

routines.md +16 −4

Details

126 126 

127Запустите `/schedule` в любом сеансе, чтобы создать запланированную рутину в диалоговом режиме. Вы также можете передать описание напрямую, например для повторяющейся рутины как `/schedule daily PR review at 9am` или одноразовой как `/schedule clean up feature flag in one week`. Claude проходит через ту же информацию, которую собирает веб-форма, затем сохраняет рутину в ваш аккаунт.127Запустите `/schedule` в любом сеансе, чтобы создать запланированную рутину в диалоговом режиме. Вы также можете передать описание напрямую, например для повторяющейся рутины как `/schedule daily PR review at 9am` или одноразовой как `/schedule clean up feature flag in one week`. Claude проходит через ту же информацию, которую собирает веб-форма, затем сохраняет рутину в ваш аккаунт.

128 128 

129Успешный старт выглядит как диалог: Claude задает уточняющие вопросы о расписании, репозиториях и подсказке перед сохранением. Если Claude вместо этого ответит, что вам нужно пройти аутентификацию или что он не может подключиться к вашему удаленному аккаунту claude.ai, рутина не была создана; смотрите [Troubleshooting](#troubleshooting).

130 

129`/schedule` в CLI создает только запланированные рутины. Чтобы добавить триггер API или GitHub, отредактируйте рутину в веб-версии на [claude.ai/code/routines](https://claude.ai/code/routines).131`/schedule` в CLI создает только запланированные рутины. Чтобы добавить триггер API или GitHub, отредактируйте рутину в веб-версии на [claude.ai/code/routines](https://claude.ai/code/routines).

130 132 

131CLI также поддерживает управление существующими рутинами. Запустите `/schedule list`, чтобы увидеть все рутины, `/schedule update`, чтобы изменить одну, или `/schedule run`, чтобы запустить ее немедленно.133CLI также поддерживает управление существующими рутинами. Запустите `/schedule list`, чтобы увидеть все рутины, `/schedule update`, чтобы изменить одну, или `/schedule run`, чтобы запустить ее немедленно.


152 154 

153Одноразовое расписание запускает рутину один раз в определенный момент времени. Используйте его, чтобы напомнить себе позже на неделе, открыть PR очистки после завершения развертывания или запустить последующую задачу, когда приходит изменение вышестоящего уровня. После запуска рутины она автоматически отключается, и веб-интерфейс отмечает ее как **Ran**. Чтобы запустить ее снова, отредактируйте рутину и установите новое одноразовое время.155Одноразовое расписание запускает рутину один раз в определенный момент времени. Используйте его, чтобы напомнить себе позже на неделе, открыть PR очистки после завершения развертывания или запустить последующую задачу, когда приходит изменение вышестоящего уровня. После запуска рутины она автоматически отключается, и веб-интерфейс отмечает ее как **Ran**. Чтобы запустить ее снова, отредактируйте рутину и установите новое одноразовое время.

154 156 

157<Note>

158 Одноразовое планирование из CLI постепенно развертывается и может быть еще недоступно на вашем аккаунте. Если `/schedule` предлагает только повторяющиеся расписания, создайте одноразовый запуск из веб-версии на [claude.ai/code/routines](https://claude.ai/code/routines).

159</Note>

160 

155Создайте одноразовый запуск из CLI, описав время на естественном языке. Claude разрешает фразу относительно текущего времени и подтверждает абсолютный момент времени перед сохранением.161Создайте одноразовый запуск из CLI, описав время на естественном языке. Claude разрешает фразу относительно текущего времени и подтверждает абсолютный момент времени перед сохранением.

156 162 

157```text theme={null}163```text theme={null}


200 206 

201Отправьте POST запрос на конечную точку `/fire` с токеном-носителем в заголовке `Authorization`. Тело запроса принимает дополнительное поле `text` для контекста, специфичного для запуска, такого как тело оповещения или неудачный журнал, переданное рутине вместе с ее сохраненной подсказкой. Значение — это свободный текст и не анализируется: если вы отправляете JSON или другую структурированную полезную нагрузку, рутина получает ее как буквальную строку.207Отправьте POST запрос на конечную точку `/fire` с токеном-носителем в заголовке `Authorization`. Тело запроса принимает дополнительное поле `text` для контекста, специфичного для запуска, такого как тело оповещения или неудачный журнал, переданное рутине вместе с ее сохраненной подсказкой. Значение — это свободный текст и не анализируется: если вы отправляете JSON или другую структурированную полезную нагрузку, рутина получает ее как буквальную строку.

202 208 

203Пример ниже запускает рутину из shell:209Пример ниже запускает рутину из shell. ID рутины и токен, показанные здесь, являются заполнителями: замените их на URL и токен, которые вы скопировали при [добавлении триггера API](#add-an-api-trigger), или запрос завершится с ошибкой аутентификации `401`:

204 210 

205```bash theme={null}211```bash theme={null}

206curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \212curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \


410 Troubleshooting416 Troubleshooting

411</h2>417</h2>

412 418 

413<h3 id="/schedule-shows-no-commands-match-or-unknown-command">419<h3 id="/schedule-returns-unknown-command">

414 `/schedule` shows "No commands match" or "Unknown command"420 `/schedule` returns "Unknown command"

415</h3>421</h3>

416 422 

417CLI скрывает `/schedule`, когда одно из его требований не выполнено, поэтому меню команд показывает `No commands match "/schedule"` во время ввода, а отправка возвращает `Unknown command: /schedule`. Причина обычно одна из следующих:423CLI скрывает `/schedule`, когда одно из его требований не выполнено: меню команд показывает `No commands match "/schedule"` во время ввода, а отправка возвращает `Unknown command: /schedule`. Причина обычно одна из следующих:

418 424 

419* You are authenticated with a Console API key or a cloud provider such as Amazon Bedrock, Google Cloud's Agent Platform, or Microsoft Foundry. `/schedule` requires a claude.ai subscription login. If `ANTHROPIC_API_KEY` or `ANTHROPIC_AUTH_TOKEN` is set in your shell, or `apiKeyHelper` is set in `settings.json`, remove it first, since these take precedence over a claude.ai login425* You are authenticated with a Console API key or a cloud provider such as Amazon Bedrock, Google Cloud's Agent Platform, or Microsoft Foundry. `/schedule` requires a claude.ai subscription login. If `ANTHROPIC_API_KEY` or `ANTHROPIC_AUTH_TOKEN` is set in your shell, or `apiKeyHelper` is set in `settings.json`, remove it first, since these take precedence over a claude.ai login

420* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` или `DISABLE_GROWTHBOOK` установлены в переменных окружения вашей оболочки или в блоке `env` файла [`settings.json`](/ru/settings#available-settings). Они отключают получение флагов функций, от которого зависит `/schedule`426* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` или `DISABLE_GROWTHBOOK` установлены в переменных окружения вашей оболочки или в блоке `env` файла [`settings.json`](/ru/settings#available-settings). Они отключают получение флагов функций, от которого зависит `/schedule`


422 428 

423Вы всегда можете создавать и управлять рутинами на [claude.ai/code/routines](https://claude.ai/code/routines) независимо от того, как настроен ваш CLI.429Вы всегда можете создавать и управлять рутинами на [claude.ai/code/routines](https://claude.ai/code/routines) независимо от того, как настроен ваш CLI.

424 430 

431<h3 id="/schedule-asks-you-to-authenticate">

432 `/schedule` asks you to authenticate

433</h3>

434 

435Если `/schedule` запускается, но Claude отвечает, что вам нужно сначала аутентифицироваться с помощью учетной записи claude.ai, то CLI не имеет сохраненного входа claude.ai. Учетные записи API не поддерживаются для рутин. Запустите `/login`, войдите с помощью вашей учетной записи claude.ai, затем снова запустите `/schedule`.

436 

425<h3 id="routines-are-disabled-by-your-organization’s-policy">437<h3 id="routines-are-disabled-by-your-organization’s-policy">

426 "Routines are disabled by your organization's policy"438 "Routines are disabled by your organization's policy"

427</h3>439</h3>

Details

60 60 

61[Режимы разрешений](/ru/permission-modes) определяют, выполняется ли вызов инструмента и будете ли вы запрошены в первую очередь. Изоляция ограничивает то, что может получить доступ команда после ее выполнения. Эти два работают вместе: когда режим разрешений позволяет действиям выполняться без вашего запроса, граница изоляции ограничивает то, что эти действия могут достичь.61[Режимы разрешений](/ru/permission-modes) определяют, выполняется ли вызов инструмента и будете ли вы запрошены в первую очередь. Изоляция ограничивает то, что может получить доступ команда после ее выполнения. Эти два работают вместе: когда режим разрешений позволяет действиям выполняться без вашего запроса, граница изоляции ограничивает то, что эти действия могут достичь.

62 62 

63`--dangerously-skip-permissions` удаляет проверку для каждого действия, кроме явных [ask rules](/ru/permissions#manage-permissions), поэтому граница изоляции это единственное, что ограничивает то, что может сделать Claude. Всегда запускайте его внутри контейнера, VM или [sandbox runtime](#sandbox-runtime), чтобы инструменты файлов, серверы MCP и hooks также находились внутри границы.63Когда вы передаете `--dangerously-skip-permissions`, Claude действует без предварительного запроса; вы получаете запрос только для явных [ask rules](/ru/permissions#manage-permissions), инструментов соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools), инструментов MCP, отмеченных [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), и удалений, нацеленных на `/` или ваш домашний каталог. Без запросов для перехвата ошибок, граница изоляции, которую вы выбираете, это то, что защищает вашу систему. Всегда запускайте сеансы `--dangerously-skip-permissions` внутри контейнера, VM или [sandbox runtime](#sandbox-runtime), чтобы инструменты файлов, серверы MCP и hooks также находились внутри границы.

64 64 

65[Auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) заменяет запрос классификатором, который проверяет действия и блокирует те, которые выходят за пределы запроса, нацеливаются на неизвестную инфраструктуру или кажутся вызванными враждебным контентом, который прочитал Claude. Классификатор — это контроль для каждого действия, а не граница изоляции, поэтому граница изоляции все еще добавляет защиту в глубину для автоматических запусков и не требуется так, как для `--dangerously-skip-permissions`.65[Auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) заменяет запрос классификатором, который проверяет действия и блокирует те, которые выходят за пределы запроса, нацеливаются на неизвестную инфраструктуру или кажутся вызванными враждебным контентом, который прочитал Claude. Классификатор — это контроль для каждого действия, а не граница изоляции, поэтому граница изоляции все еще добавляет защиту в глубину для автоматических запусков и не требуется так, как для `--dangerously-skip-permissions`.

66 66 

sandboxing.md +10 −5

Details

121 121 

122Claude Code предлагает два режима sandbox:122Claude Code предлагает два режима sandbox:

123 123 

124**Режим автоматического разрешения**: Команды Bash будут пытаться выполняться внутри sandbox и автоматически разрешаются без требования разрешения. Команды, которые не могут быть изолированы, такие как те, которые требуют сетевого доступа к неразрешённым хостам, возвращаются к обычному потоку разрешений, где Claude Code проверяет ваши [правила разрешений](/ru/permissions) и запрашивает у вас разрешение для любой команды, которую эти правила не разрешают.124**Режим автоматического разрешения**: Команды Bash будут пытаться выполняться внутри sandbox и автоматически разрешаются без требования разрешения. Команды, которые не могут быть изолированы, такие как те, которые требуют сетевого доступа к неразрешённым хостам, возвращаются к обычному потоку разрешений, где Claude Code проверяет ваши [правила разрешений](/ru/permissions) и запрашивает у вас разрешение для любой команды, которую эти правила не разрешают, с запросом в режиме по умолчанию или классификатором в [режиме auto](/ru/permission-modes#eliminate-prompts-with-auto-mode).

125 125 

126Даже в режиме автоматического разрешения применяется следующее:126Даже в режиме автоматического разрешения применяется следующее:

127 127 


136 136 

137Каталог временных файлов сеанса доступен для записи внутри sandbox по умолчанию, наряду с рабочим каталогом. Claude Code устанавливает `$TMPDIR` в этот каталог для изолированных команд, поэтому инструменты, которые записывают временные файлы, работают без дополнительной конфигурации. Неизолированные команды наследуют `$TMPDIR` вашей оболочки без изменений, что означает, что изолированные и неизолированные команды разрешают `$TMPDIR` в разные каталоги. Чтобы передавать временные файлы между ними, записывайте их в рабочий каталог вместо этого.137Каталог временных файлов сеанса доступен для записи внутри sandbox по умолчанию, наряду с рабочим каталогом. Claude Code устанавливает `$TMPDIR` в этот каталог для изолированных команд, поэтому инструменты, которые записывают временные файлы, работают без дополнительной конфигурации. Неизолированные команды наследуют `$TMPDIR` вашей оболочки без изменений, что означает, что изолированные и неизолированные команды разрешают `$TMPDIR` в разные каталоги. Чтобы передавать временные файлы между ними, записывайте их в рабочий каталог вместо этого.

138 138 

139Некоторые команды вообще не могут выполняться внутри sandbox, такие как инструменты, несовместимые с ним, или те, которые требуют хоста, который вы не разрешили. Вместо того чтобы не выполнить задачу или потребовать отключения sandboxing, Claude Code включает механизм выхода: когда команда не выполняется из-за ограничений sandbox, Claude анализирует сбой и может повторить команду с параметром `dangerouslyDisableSandbox`. Повторная команда выполняется вне sandbox, поэтому она проходит через обычный поток разрешений. В [режиме auto](/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатор оценивает базовую команду вместо того, чтобы запрашивать у вас разрешение.139Некоторые команды вообще не могут выполняться внутри sandbox, такие как инструменты, несовместимые с ним, или те, которые требуют хоста, который вы не разрешили. Вместо того чтобы не выполнить задачу или потребовать отключения sandboxing, Claude Code включает механизм выхода: когда команда не выполняется из-за ограничений sandbox, Claude анализирует сбой и может повторить команду с параметром `dangerouslyDisableSandbox`. Повторная команда выполняется вне sandbox, поэтому она проходит через обычный поток разрешений: в режиме по умолчанию вы получаете запрос подтверждения; в [режиме auto](/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатор оценивает базовую команду вместо того, чтобы запрашивать у вас разрешение. Чтобы получить запрос на каждый неизолированный повтор даже в режиме auto, добавьте [правило ask](/ru/permissions#match-by-input-parameter) для `Bash(dangerouslyDisableSandbox:true)`.

140 140 

141Вы можете отключить этот механизм выхода, установив `"allowUnsandboxedCommands": false` в ваши [параметры sandbox](/ru/settings#sandbox-settings). При отключении, что панель Overrides в `/sandbox` показывает как **Strict sandbox mode**, параметр `dangerouslyDisableSandbox` полностью игнорируется и все команды должны выполняться в sandbox или быть явно указаны в `excludedCommands`.141Вы можете отключить этот механизм выхода, установив `"allowUnsandboxedCommands": false` в ваши [параметры sandbox](/ru/settings#sandbox-settings). При отключении, что панель Overrides в `/sandbox` показывает как **Strict sandbox mode**, параметр `dangerouslyDisableSandbox` полностью игнорируется и все команды должны выполняться в sandbox или быть явно указаны в `excludedCommands`.

142 142 


177 177 

178Этот синтаксис отличается от [правил разрешений Read и Edit](/ru/permissions#read-and-edit), которые используют `//path` для абсолютных и `/path` для относительных к проекту. Пути файловой системы sandbox используют стандартные соглашения: `/tmp/build` — это абсолютный путь.178Этот синтаксис отличается от [правил разрешений Read и Edit](/ru/permissions#read-and-edit), которые используют `//path` для абсолютных и `/path` для относительных к проекту. Пути файловой системы sandbox используют стандартные соглашения: `/tmp/build` — это абсолютный путь.

179 179 

180Вы также можете запретить доступ на запись или чтение, используя `sandbox.filesystem.denyWrite` и `sandbox.filesystem.denyRead`, и повторно разрешить определённые пути в запрещённой области, используя `sandbox.filesystem.allowRead`.180Вы также можете запретить доступ на запись или чтение, используя `sandbox.filesystem.denyWrite` и `sandbox.filesystem.denyRead`, и повторно разрешить определённые пути в запрещённой области, используя `sandbox.filesystem.allowRead`. Когда правила чтения перекрываются, более специфичный путь побеждает:

181 

182| Примеры правил | Результат |

183| :--------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

184| `"denyRead": ["~/"]` с `"allowRead": ["~/projects"]` | `~/projects` доступен для чтения, а остальная часть домашнего каталога остаётся заблокирована. Более узкое разрешение повторно открывает эту часть запрещённой области |

185| `"allowRead": ["~/"]` с `"denyRead": ["~/.env"]` | `~/.env` остаётся заблокирован, а остальная часть домашнего каталога доступна для чтения. Точный запрет действует внутри более широкого разрешения, поэтому широкое разрешение не может скрытно повторно открыть секрет |

181 186 

182Пример ниже блокирует чтение из всего домашнего каталога, но при этом разрешает чтение из текущего проекта. Поместите его в `.claude/settings.json` вашего проекта, потому что относительный путь `.` разрешается в корень проекта только когда конфигурация находится в параметрах проекта:187Пример ниже блокирует чтение из всего домашнего каталога, но при этом разрешает чтение из текущего проекта. Поместите его в `.claude/settings.json` вашего проекта, потому что относительный путь `.` разрешается в корень проекта только когда конфигурация находится в параметрах проекта:

183 188 


351`/sandbox` не является [режимом разрешений](/ru/permission-modes). Режимы разрешений решают, выполняется ли вызов инструмента и запрашивается ли вас сначала, в то время как sandbox ограничивает, к чему может получить доступ команда Bash после её запуска. Они отличаются в том, что они контролируют и что заменяет запрос для каждого действия:356`/sandbox` не является [режимом разрешений](/ru/permission-modes). Режимы разрешений решают, выполняется ли вызов инструмента и запрашивается ли вас сначала, в то время как sandbox ограничивает, к чему может получить доступ команда Bash после её запуска. Они отличаются в том, что они контролируют и что заменяет запрос для каждого действия:

352 357 

353| | Что контролирует | Что заменяет запрос |358| | Что контролирует | Что заменяет запрос |

354| :----------------------------------------------------------------- | :--------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |359| :----------------------------------------------------------------- | :--------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

355| `/sandbox` | К чему может получить доступ команда Bash после её запуска | Сама граница sandbox в [режиме автоматического разрешения](#sandbox-modes) |360| `/sandbox` | К чему может получить доступ команда Bash после её запуска | Сама граница sandbox в [режиме автоматического разрешения](#sandbox-modes) |

356| [Auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) | Выполняется ли каждый вызов инструмента | Классификатор, который проверяет действия |361| [Auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) | Выполняется ли каждый вызов инструмента | Классификатор, который проверяет действия |

357| `--dangerously-skip-permissions` | Выполняется ли каждый вызов инструмента | Ничего. Проверки [защищённого пути](/ru/permission-modes#protected-paths) также пропускаются; только удаление `/` или вашего домашнего каталога по-прежнему запрашивает |362| `--dangerously-skip-permissions` | Выполняется ли каждый вызов инструмента | Ничего. Проверки [защищённого пути](/ru/permission-modes#protected-paths) также пропускаются; только явные [правила ask](/ru/permissions#manage-permissions), инструменты соединителя [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools), инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), и удаление `/` или вашего домашнего каталога по-прежнему запрашивают |

358 363 

359Режим [автоматического разрешения](#sandbox-modes) sandbox отличается от [режима auto](/ru/permission-modes#eliminate-prompts-with-auto-mode): автоматическое разрешение одобряет команды Bash, потому что граница sandbox их содержит, в то время как режим auto использует классификатор для проверки действий. Два работают независимо и могут быть объединены. Чтобы выбрать границу изоляции для автоматических запусков, см. [Sandbox environments](/ru/sandbox-environments#how-isolation-relates-to-permission-modes).364Режим [автоматического разрешения](#sandbox-modes) sandbox отличается от [режима auto](/ru/permission-modes#eliminate-prompts-with-auto-mode): автоматическое разрешение одобряет команды Bash, потому что граница sandbox их содержит, в то время как режим auto использует классификатор для проверки действий. Два работают независимо и могут быть объединены. Чтобы выбрать границу изоляции для автоматических запусков, см. [Sandbox environments](/ru/sandbox-environments#how-isolation-relates-to-permission-modes).

360 365 

Details

82Динамически запланированный цикл появляется в вашем [списке запланированных задач](#manage-scheduled-tasks) как любая другая задача, поэтому вы можете перечислить или отменить его таким же образом. [Правила дрожания](#jitter) не применяются к нему, но [истечение через семь дней](#seven-day-expiry) применяется: цикл автоматически заканчивается через семь дней после его запуска.82Динамически запланированный цикл появляется в вашем [списке запланированных задач](#manage-scheduled-tasks) как любая другая задача, поэтому вы можете перечислить или отменить его таким же образом. [Правила дрожания](#jitter) не применяются к нему, но [истечение через семь дней](#seven-day-expiry) применяется: цикл автоматически заканчивается через семь дней после его запуска.

83 83 

84<Note>84<Note>

85 На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry подсказка без интервала запускается по фиксированному расписанию в 10 минут вместо этого.85 На Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform и Microsoft Foundry подсказка без интервала запускается по фиксированному расписанию в 10 минут вместо этого.

86</Note>86</Note>

87 87 

88<h3 id="run-the-built-in-maintenance-prompt">88<h3 id="run-the-built-in-maintenance-prompt">


104Простой `/loop` запускает эту подсказку с [динамически выбранным интервалом](#let-claude-choose-the-interval). Добавьте интервал, например `/loop 15m`, чтобы запустить его по фиксированному расписанию вместо этого. Чтобы заменить встроенную подсказку своей собственной по умолчанию, см. [Настройте подсказку по умолчанию с помощью loop.md](#customize-the-default-prompt-with-loop-md).104Простой `/loop` запускает эту подсказку с [динамически выбранным интервалом](#let-claude-choose-the-interval). Добавьте интервал, например `/loop 15m`, чтобы запустить его по фиксированному расписанию вместо этого. Чтобы заменить встроенную подсказку своей собственной по умолчанию, см. [Настройте подсказку по умолчанию с помощью loop.md](#customize-the-default-prompt-with-loop-md).

105 105 

106<Note>106<Note>

107 На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry `/loop` без подсказки выводит сообщение об использовании вместо запуска подсказки обслуживания.107 На Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform и Microsoft Foundry `/loop` без подсказки выводит сообщение об использовании вместо запуска подсказки обслуживания.

108</Note>108</Note>

109 109 

110<h3 id="customize-the-default-prompt-with-loop-md">110<h3 id="customize-the-default-prompt-with-loop-md">


132Изменения в `loop.md` вступают в силу на следующей итерации, поэтому вы можете уточнить инструкции, пока цикл работает. Когда `loop.md` не существует ни в одном месте, цикл возвращается к встроенной подсказке обслуживания. Держите файл кратким: содержимое, превышающее 25 000 байт, усекается.132Изменения в `loop.md` вступают в силу на следующей итерации, поэтому вы можете уточнить инструкции, пока цикл работает. Когда `loop.md` не существует ни в одном месте, цикл возвращается к встроенной подсказке обслуживания. Держите файл кратким: содержимое, превышающее 25 000 байт, усекается.

133 133 

134<Note>134<Note>

135 На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry `loop.md` не читается и `/loop` без подсказки выводит сообщение об использовании вместо этого.135 На Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform и Microsoft Foundry `loop.md` не читается и `/loop` без подсказки выводит сообщение об использовании вместо этого.

136</Note>136</Note>

137 137 

138<h3 id="stop-a-loop">138<h3 id="stop-a-loop">

security.md +1 −1

Details

131 131 

132Для получения дополнительной информации о облачном выполнении см. [Claude Code в веб-версии](/ru/claude-code-on-the-web).132Для получения дополнительной информации о облачном выполнении см. [Claude Code в веб-версии](/ru/claude-code-on-the-web).

133 133 

134Сеансы [Remote Control](/ru/remote-control) работают иначе: веб-интерфейс подключается к процессу Claude Code, работающему на вашей локальной машине. Все выполнение кода и доступ к файлам остаются локальными, и те же данные, которые передаются во время любого локального сеанса Claude Code, проходят через API Anthropic по TLS. Никаких облачных ВМ или sandboxing не задействовано. Соединение использует несколько краткосрочных, узко ограниченных учетных данных, каждые ограниченные определенной целью и истекающие независимо, чтобы ограничить радиус поражения любого скомпрометированного учетного данного.134Сеансы [Remote Control](/ru/remote-control) работают иначе: веб-интерфейс подключается к процессу Claude Code, работающему на вашей локальной машине. Все выполнение кода и доступ к файлам остаются локальными, и трафик сеанса проходит через API Anthropic по TLS; при подключении транскрипт сеанса хранится на серверах Anthropic для синхронизации разговора между устройствами, как описано в [Соединение и безопасность](/ru/remote-control#connection-and-security). Никаких облачных ВМ или sandboxing не задействовано. Соединение использует несколько краткосрочных, узко ограниченных учетных данных, каждые ограниченные определенной целью и истекающие независимо, чтобы ограничить радиус поражения любого скомпрометированного учетного данного.

135 135 

136<h2 id="security-best-practices">136<h2 id="security-best-practices">

137 Лучшие практики безопасности137 Лучшие практики безопасности

Details

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

243 243 

244<Note>244<Note>

245 В неинтерактивном режиме с флагом `-p` Claude Code пропускает диалоги безопасности и применяет параметры без одобрения пользователя.245 Неинтерактивный запуск, такой как `claude -p` или сеанс Agent SDK, не может показать диалог. Когда доставленные параметры требуют одобрения, Claude Code применяет их только для этого запуска: он не записывает их как одобренные и не записывает их в [локальный кэш](#fetch-and-caching-behavior), и следующий интерактивный сеанс показывает диалог. До тех пор, пока пользователь не одобрит в интерактивном сеансе, каждый неинтерактивный запуск выбирает параметры снова при запуске. До версии 2.1.207 неинтерактивный запуск сохранял параметры как одобренные, поэтому более поздние интерактивные сеансы никогда не показывали для них диалог.

246</Note>246</Note>

247 247 

248<h2 id="platform-availability">248<h2 id="platform-availability">


259* [Claude Platform on AWS](/ru/claude-platform-on-aws)259* [Claude Platform on AWS](/ru/claude-platform-on-aws)

260* Пользовательские конечные точки API через `ANTHROPIC_BASE_URL` или [LLM gateways](/ru/llm-gateway)260* Пользовательские конечные точки API через `ANTHROPIC_BASE_URL` или [LLM gateways](/ru/llm-gateway)

261 261 

262Если вы экспортируете переменную поставщика `CLAUDE_CODE_USE_*` или нестандартный `ANTHROPIC_BASE_URL` в вашей оболочке, Claude Code пропускает выборку параметров для ваших сеансов. Вы не можете очистить экспорт с помощью управляемого сервером блока `env`, потому что блок поступает через выборку, которую экспорт предотвращает. Управляемый конечной точкой блок параметров `env` также не восстанавливает выборку: Claude Code проверяет приемлемость перед применением управляемых блоков `env`, поэтому переопределение изменяет выбор поставщика сеанса, но выборка остается пропущенной.

263 

264Чтобы восстановить доставку, управляемую сервером, удалите экспорт из вашей оболочки или установите переменную на `""` в блоке `env` пользовательских параметров, который применяется перед проверкой приемлемости. Чтобы обеспечить политику без полагания на пользователей для изменения их оболочек, доставляйте параметры через управляемый конечной точкой канал вместо этого.

265 

262Для развертываний Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry самостоятельно размещаемый [Claude apps gateway](/ru/claude-apps-gateway) обеспечивает эквивалентную доставку удаленных управляемых параметров: клиенты, вошедшие в шлюз, получают управляемые параметры из шлюза вместо `api.anthropic.com`. Семантика отказов отличается при запуске: клиент шлюза, который не может достичь шлюз, завершает работу с ошибкой вместо возврата к кэшированным параметрам, в то время как почасовое фоновое обновление открыто при отказе на обоих каналах.266Для развертываний Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry самостоятельно размещаемый [Claude apps gateway](/ru/claude-apps-gateway) обеспечивает эквивалентную доставку удаленных управляемых параметров: клиенты, вошедшие в шлюз, получают управляемые параметры из шлюза вместо `api.anthropic.com`. Семантика отказов отличается при запуске: клиент шлюза, который не может достичь шлюз, завершает работу с ошибкой вместо возврата к кэшированным параметрам, в то время как почасовое фоновое обновление открыто при отказе на обоих каналах.

263 267 

264<h2 id="audit-logging">268<h2 id="audit-logging">

sessions.md +1 −1

Details

115 115 

116Эти команды управляют тем, что находится в окне контекста, не покидая сеанс:116Эти команды управляют тем, что находится в окне контекста, не покидая сеанс:

117 117 

118* **`/clear`**: начать заново с пустым контекстом. Предыдущий диалог сохраняется и может быть возобновлен118* **`/clear`**: начать заново с пустым контекстом. Предыдущий диалог сохраняется и может быть возобновлен с помощью `/resume`, или, в том же процессе Claude Code, {/* min-version: 2.1.191 */}из [записи предыдущего сеанса меню перемотки](/ru/checkpointing#rewind-past-a-cleared-conversation)

119* **`/compact [instructions]`**: заменить историю сводкой, опционально сосредоточенной на том, что вы указали119* **`/compact [instructions]`**: заменить историю сводкой, опционально сосредоточенной на том, что вы указали

120* **`/context`**: показать, что в настоящее время потребляет контекст120* **`/context`**: показать, что в настоящее время потребляет контекст

121 121 

settings.md +60 −32

Details

180 Недействительные записи в управляемых параметрах180 Недействительные записи в управляемых параметрах

181</h3>181</h3>

182 182 

183Управляемые параметры анализируются с допуском. Когда управляемая конфигурация содержит запись, которая не проходит валидацию схемы, Claude Code удаляет эту запись, записывает предупреждение и применяет каждую оставшуюся действительную политику. Одна опечатка не может отключить остальную политику вашей организации.183Управляемые параметры анализируются с допуском. Когда управляемая конфигурация содержит запись, которая не проходит валидацию схемы, Claude Code удаляет эту запись, записывает предупреждение и применяет каждую оставшуюся действительную политику. Одна опечатка не может отключить остальную политику вашей организации. Запустите [`/doctor`](/ru/debug-your-config#check-resolved-settings), чтобы увидеть список удаленных записей с их исходным файлом и полем.

184 184 

185Это поведение согласуется во всех трех механизмах доставки: [параметры, управляемые сервером](/ru/server-managed-settings), политики plist и реестра, развернутые через MDM, и файлы `managed-settings.json`. Требует Claude Code v2.1.169 или позже.185Это поведение согласуется во всех трех механизмах доставки: [параметры, управляемые сервером](/ru/server-managed-settings), политики plist и реестра, развернутые через MDM, и файлы `managed-settings.json`. Требует Claude Code v2.1.169 или позже.

186 186 


215`settings.json` поддерживает ряд опций:215`settings.json` поддерживает ряд опций:

216 216 

217| Ключ | Описание | Пример |217| Ключ | Описание | Пример |

218| :-------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |218| :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |

219| `advisorModel` | Модель для серверного [инструмента advisor](/ru/advisor). Принимает псевдоним модели, такой как `"opus"`, `"sonnet"` или `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+), или полный ID модели. Записывается автоматически при запуске `/advisor`. Отключите, чтобы отключить advisor | `"opus"` |219| `advisorModel` | Модель для серверного [инструмента advisor](/ru/advisor). Принимает псевдоним модели, такой как `"opus"`, `"sonnet"` или `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+), или полный ID модели. Записывается автоматически при запуске `/advisor`. Отключите, чтобы отключить advisor | `"opus"` |

220| `agent` | Запустить основной поток как именованный subagent и установить агента по умолчанию для сеансов, отправленных из `claude agents`. Применяет системный запрос, ограничения инструментов и модель этого subagent. См. [Явно вызывать subagents](/ru/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |220| `agent` | Запустить основной поток как именованный subagent и установить агента по умолчанию для сеансов, отправленных из `claude agents`. Применяет системный запрос, ограничения инструментов и модель этого subagent. См. [Явно вызывать subagents](/ru/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |

221| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `false`. Когда [Remote Control](/ru/remote-control) подключен, разрешить Claude отправлять проактивные push-уведомления на ваш телефон, например когда длительная задача завершается. Появляется в `/config` как **Push when Claude decides**. См. [Mobile push notifications](/ru/remote-control#mobile-push-notifications). Требует Claude Code v2.1.119 или позже | `true` |221| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `false`. Когда [Remote Control](/ru/remote-control) подключен, разрешить Claude отправлять проактивные push-уведомления на ваш телефон, например когда длительная задача завершается. Появляется в `/config` как **Push when Claude decides**. См. [Mobile push notifications](/ru/remote-control#mobile-push-notifications). Требует Claude Code v2.1.119 или позже | `true` |


233| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `true`. Автоматически компактировать разговор, когда контекст приближается к лимиту. Появляется в `/config` как **Auto-compact**. Чтобы отключить через переменную окружения, установите [`DISABLE_AUTO_COMPACT`](/ru/env-vars) в `env` | `false` |233| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `true`. Автоматически компактировать разговор, когда контекст приближается к лимиту. Появляется в `/config` как **Auto-compact**. Чтобы отключить через переменную окружения, установите [`DISABLE_AUTO_COMPACT`](/ru/env-vars) в `env` | `false` |

234| `autoMemoryDirectory` | Пользовательский каталог для хранения [автоматической памяти](/ru/memory#storage-location). Принимает абсолютный путь или путь с префиксом `~/`. Из параметров проекта или локальных параметров это учитывается только после того, как вы примете диалог доверия рабочей области, так как клонированный репозиторий может предоставить этот файл | `"~/my-memory-dir"` |234| `autoMemoryDirectory` | Пользовательский каталог для хранения [автоматической памяти](/ru/memory#storage-location). Принимает абсолютный путь или путь с префиксом `~/`. Из параметров проекта или локальных параметров это учитывается только после того, как вы примете диалог доверия рабочей области, так как клонированный репозиторий может предоставить этот файл | `"~/my-memory-dir"` |

235| `autoMemoryEnabled` | **По умолчанию**: `true`. Включить [автоматическую память](/ru/memory#enable-or-disable-auto-memory). Когда `false`, Claude не читает и не записывает в каталог автоматической памяти. Вы также можете переключить это с помощью `/memory` во время сеанса. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/ru/env-vars) в `env` | `false` |235| `autoMemoryEnabled` | **По умолчанию**: `true`. Включить [автоматическую память](/ru/memory#enable-or-disable-auto-memory). Когда `false`, Claude не читает и не записывает в каталог автоматической памяти. Вы также можете переключить это с помощью `/memory` во время сеанса. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/ru/env-vars) в `env` | `false` |

236| `autoMode` | Настройте, что классификатор [автоматического режима](/ru/permission-modes#eliminate-prompts-with-auto-mode) блокирует и разрешает. Содержит массивы `environment`, `allow`, `soft_deny` и `hard_deny` правил в виде текста. Включите буквальную строку `"$defaults"` в массив для наследования встроенных правил в этой позиции. См. [Настройте автоматический режим](/ru/auto-mode-config). Не читается из общих параметров проекта | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |236| `autoMode` | Настройте, что классификатор [автоматического режима](/ru/permission-modes#eliminate-prompts-with-auto-mode) блокирует и разрешает. Содержит массивы `environment`, `allow`, `soft_deny` и `hard_deny` правил в виде текста. Включите буквальную строку `"$defaults"` в массив для наследования встроенных правил в этой позиции. См. [Настройте автоматический режим](/ru/auto-mode-config). Читается из параметров пользователя, флага `--settings` и управляемых параметров только. Игнорируется в проекте `.claude/settings.json` и локальном `.claude/settings.local.json`. {/* min-version: 2.1.207 */}До v2.1.207, `.claude/settings.local.json` также читался | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |

237| `autoMode.classifyAllShell` | {/* min-version: 2.1.193 */}**По умолчанию**: `false`. Когда `true`, приостанавливает каждое правило разрешения Bash и PowerShell, пока активен автоматический режим, поэтому все команды shell маршрутизируются через классификатор, а не только правила, которые соответствуют шаблонам произвольного выполнения кода. См. [Маршрутизировать все команды shell через классификатор](/ru/auto-mode-config#route-all-shell-commands-through-the-classifier). Требует Claude Code v2.1.193 или позже | `true` |237| `autoMode.classifyAllShell` | {/* min-version: 2.1.193 */}**По умолчанию**: `false`. Когда `true`, приостанавливает каждое правило разрешения Bash и PowerShell, пока активен автоматический режим, поэтому все команды shell маршрутизируются через классификатор, а не только правила, которые соответствуют шаблонам произвольного выполнения кода. См. [Маршрутизировать все команды shell через классификатор](/ru/auto-mode-config#route-all-shell-commands-through-the-classifier). Требует Claude Code v2.1.193 или позже | `true` |

238| `autoScrollEnabled` | **По умолчанию**: `true`. В [fullscreen rendering](/ru/fullscreen), следить за новым выводом в конец разговора. Появляется в `/config` как **Auto-scroll**. Запросы разрешений по-прежнему прокручиваются в поле зрения, когда это отключено | `false` |238| `autoScrollEnabled` | **По умолчанию**: `true`. В [fullscreen rendering](/ru/fullscreen), следить за новым выводом в конец разговора. Появляется в `/config` как **Auto-scroll**. Запросы разрешений по-прежнему прокручиваются в поле зрения, когда это отключено | `false` |

239| `autoUpdatesChannel` | **По умолчанию**: `"latest"`. Канал выпуска для отслеживания обновлений. Используйте `"stable"` для версии, которая обычно примерно на неделю старше и пропускает версии с серьезными регрессиями, или `"latest"` для самого последнего выпуска. Чтобы полностью отключить автоматические обновления, установите [`DISABLE_AUTOUPDATER`](/ru/setup#disable-auto-updates) в `env` | `"stable"` |239| `autoUpdatesChannel` | **По умолчанию**: `"latest"`. Канал выпуска для отслеживания обновлений. Используйте `"stable"` для версии, которая обычно примерно на неделю старше и пропускает версии с серьезными регрессиями, или `"latest"` для самого последнего выпуска. Чтобы полностью отключить автоматические обновления, установите [`DISABLE_AUTOUPDATER`](/ru/setup#disable-auto-updates) в `env` | `"stable"` |


255| `disableAllHooks` | Отключить все [hooks](/ru/hooks) и любую пользовательскую [строку состояния](/ru/statusline) | `true` |255| `disableAllHooks` | Отключить все [hooks](/ru/hooks) и любую пользовательскую [строку состояния](/ru/statusline) | `true` |

256| `disableArtifact` | Установите на `true`, чтобы отключить инструмент [Artifact](/ru/artifacts), который публикует вывод сеанса как приватную веб-страницу на claude.ai. Эквивалентно установке `CLAUDE_CODE_DISABLE_ARTIFACT` на `1` | `true` |256| `disableArtifact` | Установите на `true`, чтобы отключить инструмент [Artifact](/ru/artifacts), который публикует вывод сеанса как приватную веб-страницу на claude.ai. Эквивалентно установке `CLAUDE_CODE_DISABLE_ARTIFACT` на `1` | `true` |

257| `disableAutoMode` | Установите на `"disable"`, чтобы предотвратить активацию [автоматического режима](/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет `auto` из цикла `Shift+Tab` и отклоняет `--permission-mode auto` при запуске. Наиболее полезно в [управляемых параметрах](/ru/permissions#managed-settings), где пользователи не могут его переопределить | `"disable"` |257| `disableAutoMode` | Установите на `"disable"`, чтобы предотвратить активацию [автоматического режима](/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет `auto` из цикла `Shift+Tab` и отклоняет `--permission-mode auto` при запуске. Наиболее полезно в [управляемых параметрах](/ru/permissions#managed-settings), где пользователи не могут его переопределить | `"disable"` |

258| `disableBrowserExternalNavigation` | (Только управляемые параметры) Установите на `true`, чтобы отключить внешний просмотр в [Browser pane](/ru/desktop#browse-external-sites) приложения desktop. Ни пользователи, ни Claude не могут переходить на внешние сайты, и локальные предпросмотры dev server не затронуты. Значение должно быть JSON логическое значение `true`; строка `"true"` игнорируется | `true` |

258| `disableBundledSkills` | Установите на `true`, чтобы отключить [skills](/ru/skills) и workflows, которые поставляются с Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные slash commands, такие как `/init`, остаются доступными для ввода, но скрыты от модели. `/doctor` остается доступным для ввода, как встроенные slash commands; скройте его с помощью [`DISABLE_DOCTOR_COMMAND`](/ru/env-vars) вместо этого. Skills из plugins, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалентно установке `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` на `1` | `true` |259| `disableBundledSkills` | Установите на `true`, чтобы отключить [skills](/ru/skills) и workflows, которые поставляются с Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные slash commands, такие как `/init`, остаются доступными для ввода, но скрыты от модели. `/doctor` остается доступным для ввода, как встроенные slash commands; скройте его с помощью [`DISABLE_DOCTOR_COMMAND`](/ru/env-vars) вместо этого. Skills из plugins, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалентно установке `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` на `1` | `true` |

259| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}Отключить [claude.ai MCP connectors](/ru/mcp#use-mcp-servers-from-claude-ai), чтобы они не загружались автоматически и не подключались. Установите в любой области параметров. `true` в любом источнике имеет приоритет, поэтому проверенный в проекте `.claude/settings.json` может отключить репозиторий от облачных разъемов, но уровень проекта `false` не может переопределить уровень пользователя или политики `true`. Servers, переданные явно через `--mcp-config`, не затронуты. Чтобы запретить отдельные разъемы вместо всех, используйте [`deniedMcpServers`](/ru/managed-mcp). Требует Claude Code v2.1.182 или позже | `true` |260| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}Отключить [claude.ai MCP connectors](/ru/mcp#use-mcp-servers-from-claude-ai), чтобы они не загружались автоматически и не подключались. Установите в любой области параметров. `true` в любом источнике имеет приоритет, поэтому проверенный в проекте `.claude/settings.json` может отключить репозиторий от облачных разъемов, но уровень проекта `false` не может переопределить уровень пользователя или политики `true`. Servers, переданные явно через `--mcp-config`, не затронуты. Чтобы запретить отдельные разъемы вместо всех, используйте [`deniedMcpServers`](/ru/managed-mcp). Требует Claude Code v2.1.182 или позже | `true` |

260| `disableDeepLinkRegistration` | Установите на `"disable"`, чтобы предотвратить регистрацию Claude Code обработчика протокола `claude-cli://` с операционной системой при запуске. Deep links позволяют внешним инструментам открыть сеанс Claude Code с предварительно заполненным запросом. Полезно в окружениях, где регистрация обработчика протокола ограничена или управляется отдельно | `"disable"` |261| `disableDeepLinkRegistration` | Установите на `"disable"`, чтобы предотвратить регистрацию Claude Code обработчика протокола `claude-cli://` с операционной системой при запуске. Deep links позволяют внешним инструментам открыть сеанс Claude Code с предварительно заполненным запросом. Полезно в окружениях, где регистрация обработчика протокола ограничена или управляется отдельно | `"disable"` |


268| `enableAllProjectMcpServers` | Автоматически одобрить все MCP servers, определенные в файлах проекта `.mcp.json`. {/* min-version: 2.1.196 */}Начиная с v2.1.196, `claude mcp list` и `claude mcp get` учитывают этот ключ в ненадежной папке только из [файлов параметров, которые не проверяются в репозитории](/ru/mcp#managing-your-servers) | `true` |269| `enableAllProjectMcpServers` | Автоматически одобрить все MCP servers, определенные в файлах проекта `.mcp.json`. {/* min-version: 2.1.196 */}Начиная с v2.1.196, `claude mcp list` и `claude mcp get` учитывают этот ключ в ненадежной папке только из [файлов параметров, которые не проверяются в репозитории](/ru/mcp#managing-your-servers) | `true` |

269| `enableArtifact` | {/* min-version: 2.1.196 */}Включить или отключить инструмент [Artifact](/ru/artifacts) для этого пользователя. Когда не установлено, значение по умолчанию следует [доступности](/ru/artifacts#availability) функции для вашей учетной записи. Строка **Artifacts** в `/config` записывает этот ключ. Управляемый `disableArtifact` и [параметр администратора](/ru/artifacts#manage-artifacts-for-your-organization) вашей организации имеют приоритет, и ключ игнорируется в параметрах проекта и локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), которые репозиторий мог бы в противном случае зафиксировать. Требует Claude Code v2.1.196 или позже | `true` |270| `enableArtifact` | {/* min-version: 2.1.196 */}Включить или отключить инструмент [Artifact](/ru/artifacts) для этого пользователя. Когда не установлено, значение по умолчанию следует [доступности](/ru/artifacts#availability) функции для вашей учетной записи. Строка **Artifacts** в `/config` записывает этот ключ. Управляемый `disableArtifact` и [параметр администратора](/ru/artifacts#manage-artifacts-for-your-organization) вашей организации имеют приоритет, и ключ игнорируется в параметрах проекта и локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), которые репозиторий мог бы в противном случае зафиксировать. Требует Claude Code v2.1.196 или позже | `true` |

270| `enabledMcpjsonServers` | Список конкретных MCP servers из файлов `.mcp.json` для одобрения. {/* min-version: 2.1.196 */}Начиная с v2.1.196, `claude mcp list` и `claude mcp get` учитывают этот ключ в ненадежной папке только из [файлов параметров, которые не проверяются в репозитории](/ru/mcp#managing-your-servers) | `["memory", "github"]` |271| `enabledMcpjsonServers` | Список конкретных MCP servers из файлов `.mcp.json` для одобрения. {/* min-version: 2.1.196 */}Начиная с v2.1.196, `claude mcp list` и `claude mcp get` учитывают этот ключ в ненадежной папке только из [файлов параметров, которые не проверяются в репозитории](/ru/mcp#managing-your-servers) | `["memory", "github"]` |

271| `enforceAvailableModels` | {/* min-version: 2.1.175 */}Расширить список разрешений `availableModels` на модель Default. Когда `true` в управляемых параметрах и `availableModels` - это непустой массив, опция Default возвращается к первой разрешенной записи, которая доступна, но только когда модель по умолчанию для типа учетной записи пользователя не находится в списке разрешений; разрешенное значение по умолчанию сохраняется как есть. Не имеет эффекта, когда `availableModels` не установлен или пуст. См. [Ограничить выбор модели](/ru/model-config#restrict-model-selection) | `true` |272| `enforceAvailableModels` | {/* min-version: 2.1.175 */}Расширить список разрешений `availableModels` на модель Default. Когда `true` в управляемых параметрах и `availableModels` - это непустой массив, опция Default возвращается к первой разрешенной записи, которая доступна, но только когда модель Default, которая будет разрешена (организационное значение по умолчанию, когда оно применяется, иначе значение по умолчанию для типа учетной записи), не находится в списке разрешений; разрешенное значение по умолчанию сохраняется как есть. Не имеет эффекта, когда `availableModels` не установлен или пуст. См. [Ограничить выбор модели](/ru/model-config#restrict-model-selection) для поддерживаемых моделей | `true` |

272| `env` | Переменные окружения, применяемые к каждому сеансу и к подпроцессам, которые Claude Code порождает из него. {/* min-version: 2.1.143 */}Начиная с v2.1.143, `NO_COLOR` и `FORCE_COLOR`, установленные здесь, передаются подпроцессам, но не изменяют цвета собственного интерфейса Claude Code. Установите их в вашей оболочке перед запуском `claude`, чтобы изменить цвета интерфейса. {/* min-version: 2.1.195 */}Начиная с v2.1.195, переменные идентификации, которые устанавливают окружения хостинга Claude Code, например `CLAUDE_CODE_REMOTE` и `CLAUDE_CODE_ACCOUNT_UUID`, игнорируются при установке здесь | `{"FOO": "bar"}` |273| `env` | Переменные окружения, применяемые к каждому сеансу и к подпроцессам, которые Claude Code порождает из него. Установите переменную на `""`, чтобы переопределить экспорт оболочки пустой строкой, которую Claude Code обрабатывает как неустановленную для выбора поставщика. Подпроцессы по-прежнему наследуют пустое значение. `NO_COLOR` и `FORCE_COLOR`, установленные здесь, достигают только подпроцессов; чтобы изменить цвета собственного интерфейса Claude Code, установите их в вашей оболочке перед запуском `claude`. {/* min-version: 2.1.195 */}Начиная с v2.1.195, переменные идентификации, которые устанавливают окружения хостинга Claude Code, например `CLAUDE_CODE_REMOTE` и `CLAUDE_CODE_ACCOUNT_UUID`, игнорируются при установке здесь | `{"FOO": "bar"}` |

273| `fallbackModel` | Резервная модель(и) для попытки по порядку, когда основная модель перегружена или недоступна. Claude Code переключается на следующую доступную модель в цепи для остальной части хода и показывает уведомление. `"default"` расширяется до модели по умолчанию. Цепи ограничены тремя моделями; дополнительные записи игнорируются. В отличие от большинства параметров массива, этот ключ не объединяется в разных файлах параметров: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь. Флаг [`--fallback-model`](/ru/cli-reference#cli-flags) переопределяет это на один сеанс. См. [Цепи резервных моделей](/ru/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |274| `fallbackModel` | Резервная модель(и) для попытки по порядку, когда основная модель перегружена или недоступна. Claude Code переключается на следующую доступную модель в цепи для остальной части хода и показывает уведомление. `"default"` расширяется до модели по умолчанию. Цепи ограничены тремя моделями; дополнительные записи игнорируются. В отличие от большинства параметров массива, этот ключ не объединяется в разных файлах параметров: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь. Флаг [`--fallback-model`](/ru/cli-reference#cli-flags) переопределяет это на один сеанс. См. [Цепи резервных моделей](/ru/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |

275| `fastMode` | Включить [быстрый режим](/ru/fast-mode) для сеансов, где он доступен. Переключение с помощью `/fast` записывает `true` здесь в параметры пользователя и удаляет ключ при отключении быстрого режима | `true` |

274| `fastModePerSessionOptIn` | Когда `true`, быстрый режим не сохраняется между сеансами. Каждый сеанс начинается с отключенным быстрым режимом, требуя от пользователей включить его с помощью `/fast`. Предпочтение быстрого режима пользователя по-прежнему сохраняется. См. [Требовать согласие для каждого сеанса](/ru/fast-mode#require-per-session-opt-in) | `true` |276| `fastModePerSessionOptIn` | Когда `true`, быстрый режим не сохраняется между сеансами. Каждый сеанс начинается с отключенным быстрым режимом, требуя от пользователей включить его с помощью `/fast`. Предпочтение быстрого режима пользователя по-прежнему сохраняется. См. [Требовать согласие для каждого сеанса](/ru/fast-mode#require-per-session-opt-in) | `true` |

275| `feedbackSurveyRate` | Вероятность (0–1) того, что [опрос качества сеанса](/ru/data-usage#session-quality-surveys) появится при наличии условий. Установите на `0`, чтобы полностью подавить, или установите [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/ru/env-vars) в `env`. Полезно при использовании Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, где частота выборки по умолчанию не применяется | `0.05` |277| `feedbackSurveyRate` | Вероятность (0–1) того, что [опрос качества сеанса](/ru/data-usage#session-quality-surveys) появится при наличии условий. Установите на `0`, чтобы полностью подавить, или установите [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/ru/env-vars) в `env`. Полезно при использовании Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, где частота выборки по умолчанию не применяется | `0.05` |

276| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `true`. Снимок файлов перед каждым редактированием, чтобы [`/rewind`](/ru/checkpointing) мог их восстановить. Появляется в `/config` как **Rewind code (checkpoints)**. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/ru/env-vars) в `env` | `false` |278| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `true`. Снимок файлов перед каждым редактированием, чтобы [`/rewind`](/ru/checkpointing) мог их восстановить. Появляется в `/config` как **Rewind code (checkpoints)**. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/ru/env-vars) в `env` | `false` |


308| `showClearContextOnPlanAccept` | **По умолчанию**: `false`. Показать опцию "очистить контекст" на экране принятия плана. Установите на `true`, чтобы восстановить опцию | `true` |310| `showClearContextOnPlanAccept` | **По умолчанию**: `false`. Показать опцию "очистить контекст" на экране принятия плана. Установите на `true`, чтобы восстановить опцию | `true` |

309| `showThinkingSummaries` | **По умолчанию**: `false`. Показать [расширенное мышление](/ru/model-config#extended-thinking) резюме в интерактивных сеансах. Когда не установлено или `false`, блоки мышления редактируются API и показываются как свернутая заглушка. Редактирование изменяет только то, что вы видите, а не то, что генерирует модель: чтобы снизить расходы на мышление, [снизьте бюджет или отключите мышление](/ru/model-config#extended-thinking) вместо этого. Этот параметр не имеет эффекта в неинтерактивном режиме (`-p`), Agent SDK или расширениях IDE, таких как VS Code | `true` |311| `showThinkingSummaries` | **По умолчанию**: `false`. Показать [расширенное мышление](/ru/model-config#extended-thinking) резюме в интерактивных сеансах. Когда не установлено или `false`, блоки мышления редактируются API и показываются как свернутая заглушка. Редактирование изменяет только то, что вы видите, а не то, что генерирует модель: чтобы снизить расходы на мышление, [снизьте бюджет или отключите мышление](/ru/model-config#extended-thinking) вместо этого. Этот параметр не имеет эффекта в неинтерактивном режиме (`-p`), Agent SDK или расширениях IDE, таких как VS Code | `true` |

310| `showTurnDuration` | **По умолчанию**: `true`. Показывать сообщения о продолжительности хода после ответов, например "Cooked for 1m 6s". Появляется в `/config` как **Show turn duration** | `false` |312| `showTurnDuration` | **По умолчанию**: `true`. Показывать сообщения о продолжительности хода после ответов, например "Cooked for 1m 6s". Появляется в `/config` как **Show turn duration** | `false` |

311| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}**По умолчанию**: `0.01`. Доля окна контекста модели, зарезервированная для [списка skills](/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Когда список превышает бюджет, описания для наименее используемых skills сворачиваются до простых имен, чтобы Claude все еще мог их вызывать, но не видел бы, почему. Увеличьте, чтобы сохранить больше описаний видимыми за счет большего контекста за ход. `/doctor` показывает текущее количество усечений и какие skills затронуты. Требует Claude Code v2.1.105 или позже | `0.02` |313| `skillListingBudgetFraction` | **По умолчанию**: `0.01`. Доля окна контекста модели, зарезервированная для [списка skills](/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Когда список превышает бюджет, описания для наименее используемых skills сворачиваются до простых имен, чтобы Claude все еще мог их вызывать, но не видел бы, почему. Увеличьте, чтобы сохранить больше описаний видимыми за счет большего контекста за ход. `/doctor` показывает текущее количество усечений и какие skills затронуты. Требует Claude Code v2.1.105 или позже | `0.02` |

312| `skillListingMaxDescChars` | {/* min-version: 2.1.105 */}**По умолчанию**: `1536`. Ограничение количества символов для каждого skill на объединенный текст `description` и `when_to_use` в [списке skills](/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Текст длиннее этого усекается. Увеличьте, чтобы сохранить длинные описания в целости за счет большего контекста за ход; уменьшьте, чтобы вместить больше skills в рамках [`skillListingBudgetFraction`](#available-settings). Требует Claude Code v2.1.105 или позже | `2048` |314| `skillListingMaxDescChars` | **По умолчанию**: `1536`. Ограничение количества символов для каждого skill на объединенный текст `description` и `when_to_use` в [списке skills](/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Текст длиннее этого усекается. Увеличьте, чтобы сохранить длинные описания в целости за счет большего контекста за ход; уменьшьте, чтобы вместить больше skills в рамках [`skillListingBudgetFraction`](#available-settings). Требует Claude Code v2.1.105 или позже | `2048` |

313| `skillOverrides` | {/* min-version: 2.1.129 */}Переопределения видимости для каждого skill, ключ которых - имя skill. Значение - `"on"`, `"name-only"`, `"user-invocable-only"` или `"off"`. Позволяет скрыть или свернуть skill без редактирования его SKILL.md. Не применяется к plugin skills, которые управляются через `/plugin`. Меню `/skills` записывает эти значения в `.claude/settings.local.json`. См. [Переопределить видимость skill из параметров](/ru/skills#override-skill-visibility-from-settings). Требует Claude Code v2.1.129 или позже | `{"legacy-context": "name-only", "deploy": "off"}` |315| `skillOverrides` | {{/* min-version: 2.1.129 */}}Переопределения видимости для каждого skill, ключ которых - имя skill. Значение - `"on"`, `"name-only"`, `"user-invocable-only"` или `"off"`. Позволяет скрыть или свернуть skill без редактирования его SKILL.md. Не применяется к plugin skills, которые управляются через `/plugin`. Меню `/skills` записывает эти значения в `.claude/settings.local.json`. См. [Переопределить видимость skill из параметров](/ru/skills#override-skill-visibility-from-settings). Требует Claude Code v2.1.129 или позже | `{"legacy-context": "name-only", "deploy": "off"}` |

314| `skipWebFetchPreflight` | Пропустить [проверку безопасности домена WebFetch](/ru/data-usage#webfetch-domain-safety-check), которая отправляет каждое запрашиваемое имя хоста на `api.anthropic.com` перед выборкой. Установите на `true` в окружениях, которые блокируют трафик к Anthropic, таких как развертывания Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry с ограничивающим исходящим трафиком. При пропуске WebFetch пытается любой URL без консультации со списком блокировок | `true` |316| `skipWebFetchPreflight` | Пропустить [проверку безопасности домена WebFetch](/ru/data-usage#webfetch-domain-safety-check), которая отправляет каждое запрашиваемое имя хоста на `api.anthropic.com` перед выборкой. Установите на `true` в окружениях, которые блокируют трафик к Anthropic, таких как развертывания Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry с ограничивающим исходящим трафиком. При пропуске WebFetch пытается любой URL без консультации со списком блокировок | `true` |

315| `spinnerTipsEnabled` | **По умолчанию**: `true`. Показывать советы в спиннере, пока Claude работает. Установите на `false`, чтобы отключить советы | `false` |317| `spinnerTipsEnabled` | **По умолчанию**: `true`. Показывать советы в спиннере, пока Claude работает. Установите на `false`, чтобы отключить советы | `false` |

316| `spinnerTipsOverride` | Переопределить советы спиннера пользовательскими строками. `tips`: массив строк советов. `excludeDefault`: если `true`, показывать только пользовательские советы; если `false` или отсутствует, пользовательские советы объединяются со встроенными советами | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |318| `spinnerTipsOverride` | Переопределить советы спиннера пользовательскими строками. `tips`: массив строк советов. `excludeDefault`: если `true`, показывать только пользовательские советы; если `false` или отсутствует, пользовательские советы объединяются со встроенными советами | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |


322| `syntaxHighlightingDisabled` | Отключить подсветку синтаксиса в дифах, блоках кода и предпросмотрах файлов | `true` |324| `syntaxHighlightingDisabled` | Отключить подсветку синтаксиса в дифах, блоках кода и предпросмотрах файлов | `true` |

323| `teammateMode` | **По умолчанию**: `in-process`. Как отображаются товарищи по [команде агентов](/ru/agent-teams): `in-process`, `auto` (разделенные панели в tmux или iTerm2, в процессе в противном случае), `tmux` (разделенные панели с использованием tmux или iTerm2, обнаруженные из вашего терминала), или {/* min-version: 2.1.186 */}}`iterm2` (iTerm2 native split panes via the `it2` CLI, added in v2.1.186). По умолчанию изменилось с `auto` в v2.1.179. `--teammate-mode` переопределяет это на один сеанс. См. [выбрать режим отображения](/ru/agent-teams#choose-a-display-mode) | `"auto"` |325| `teammateMode` | **По умолчанию**: `in-process`. Как отображаются товарищи по [команде агентов](/ru/agent-teams): `in-process`, `auto` (разделенные панели в tmux или iTerm2, в процессе в противном случае), `tmux` (разделенные панели с использованием tmux или iTerm2, обнаруженные из вашего терминала), или {/* min-version: 2.1.186 */}}`iterm2` (iTerm2 native split panes via the `it2` CLI, added in v2.1.186). По умолчанию изменилось с `auto` в v2.1.179. `--teammate-mode` переопределяет это на один сеанс. См. [выбрать режим отображения](/ru/agent-teams#choose-a-display-mode) | `"auto"` |

324| `terminalProgressBarEnabled` | **По умолчанию**: `true`. Показывать полосу прогресса терминала в поддерживаемых терминалах: ConEmu, Ghostty 1.2.0+ и iTerm2 3.6.6+. Появляется в `/config` как **Terminal progress bar** | `false` |326| `terminalProgressBarEnabled` | **По умолчанию**: `true`. Показывать полосу прогресса терминала в поддерживаемых терминалах: ConEmu, Ghostty 1.2.0+ и iTerm2 3.6.6+. Появляется в `/config` как **Terminal progress bar** | `false` |

325| `theme` | {/* min-version: 2.1.119 */}**По умолчанию**: `"dark"`. Цветовая тема для интерфейса: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"` или ссылка на пользовательскую тему, такая как `"custom:<slug>"` или `"custom:<plugin-name>:<slug>"`. См. [Создать пользовательскую тему](/ru/terminal-config#create-a-custom-theme). Появляется в `/config` как **Theme** | `"dark"` |327| `theme` | {{/* min-version: 2.1.119 */}}**По умолчанию**: `"dark"`. Цветовая тема для интерфейса: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"` или ссылка на пользовательскую тему, такая как `"custom:<slug>"` или `"custom:<plugin-name>:<slug>"`. См. [Создать пользовательскую тему](/ru/terminal-config#create-a-custom-theme). Появляется в `/config` как **Theme** | `"dark"` |

326| `tui` | Средство визуализации Terminal UI. Используйте `"fullscreen"` для безмерцающего [alt-screen renderer](/ru/fullscreen) с виртуализированной прокруткой. Используйте `"default"` для классического main-screen renderer. Установите через `/tui`. Вы также можете установить переменную окружения [`CLAUDE_CODE_NO_FLICKER`](/ru/env-vars). Фоновые сеансы, открытые из [представления агента](/ru/agent-view), всегда используют fullscreen renderer независимо от этого параметра | `"fullscreen"` |328| `tui` | Средство визуализации Terminal UI. Используйте `"fullscreen"` для безмерцающего [alt-screen renderer](/ru/fullscreen) с виртуализированной прокруткой. Используйте `"default"` для классического main-screen renderer. Установите через `/tui`. Вы также можете установить переменную окружения [`CLAUDE_CODE_NO_FLICKER`](/ru/env-vars). Фоновые сеансы, открытые из [представления агента](/ru/agent-view), всегда используют fullscreen renderer независимо от этого параметра | `"fullscreen"` |

327| `ultracode` | Включить [ultracode](/ru/workflows#let-claude-decide-with-ultracode) для сеанса. Этот ключ не читается из `settings.json`. Установите через `/effort ultracode`, `--settings` или запрос управления Agent SDK. {/* min-version: 2.1.203 */}Чтобы запустить сеанс с уже включенным ultracode, запустите с `claude --effort ultracode`, что требует Claude Code v2.1.203 или позже | `true` |329| `ultracode` | Включить [ultracode](/ru/workflows#let-claude-decide-with-ultracode) для сеанса. Этот ключ не читается из `settings.json`. Установите через `/effort ultracode`, `--settings` или запрос управления Agent SDK. {{/* min-version: 2.1.203 */}}Чтобы запустить сеанс с уже включенным ultracode, запустите с `claude --effort ultracode`, что требует Claude Code v2.1.203 или позже | `true` |

328| `useAutoModeDuringPlan` | **По умолчанию**: `true`. Использует ли Plan Mode семантику автоматического режима, когда автоматический режим доступен. Не читается из общих параметров проекта. Появляется в `/config` как "Use auto mode during plan" | `false` |330| `useAutoModeDuringPlan` | **По умолчанию**: `true`. Использует ли Plan Mode семантику автоматического режима, когда автоматический режим доступен. Не читается из общих параметров проекта. Появляется в `/config` как "Use auto mode during plan" | `false` |

329| `verbose` | {/* min-version: 2.1.119 */}**По умолчанию**: `false`. Показать полный вывод инструмента вместо усеченных сводок. Появляется в `/config` как **Verbose output**. Флаг `--verbose` переопределяет это на один сеанс | `true` |331| `verbose` | {{/* min-version: 2.1.119 */}}**По умолчанию**: `false`. Показать полный вывод инструмента вместо усеченных сводок. Появляется в `/config` как **Verbose output**. Флаг `--verbose` переопределяет это на один сеанс | `true` |

330| `viewMode` | Режим просмотра стенограммы по умолчанию при запуске: `"default"`, `"verbose"` или `"focus"`. Переопределяет липкий выбор `/focus` при установке. Флаг `--verbose` переопределяет это на один сеанс | `"verbose"` |332| `viewMode` | Режим просмотра стенограммы по умолчанию при запуске: `"default"`, `"verbose"` или `"focus"`. Переопределяет липкий выбор `/focus` при установке. Флаг `--verbose` переопределяет это на один сеанс | `"verbose"` |

333| `vimInsertModeRemaps` | {{/* min-version: 2.1.208 */}}Сопоставить двухклавишные последовательности режима INSERT с Escape в [режиме редактора vim](/ru/interactive-mode#vim-editor-mode). Каждый ключ - это ровно два печатаемых символа, введенные последовательно, и `"<Esc>"` - единственная поддерживаемая цель; другие записи игнорируются. Читается из параметров пользователя, флага `--settings` и управляемых параметров только, поэтому проверенные в репозитории параметры не могут переопределить ваши сочетания клавиш. Не имеет эффекта, если `editorMode` не `"vim"`. См. [Переопределить сочетания клавиш режима INSERT](/ru/interactive-mode#remap-insert-mode-key-sequences). Требует Claude Code v2.1.208 или позже | `{"jj": "<Esc>"}` |

331| `voice` | Параметры [голосового диктанта](/ru/voice-dictation): `enabled` включает диктант, `mode` выбирает `"hold"` или `"tap"`, и `autoSubmit` отправляет запрос при отпускании клавиши в режиме hold. Записывается автоматически при запуске `/voice`. Требует учетную запись Claude.ai | `{ "enabled": true, "mode": "tap" }` |334| `voice` | Параметры [голосового диктанта](/ru/voice-dictation): `enabled` включает диктант, `mode` выбирает `"hold"` или `"tap"`, и `autoSubmit` отправляет запрос при отпускании клавиши в режиме hold. Записывается автоматически при запуске `/voice`. Требует учетную запись Claude.ai | `{ "enabled": true, "mode": "tap" }` |

332| `voiceEnabled` | Устаревший псевдоним для `voice.enabled`. Предпочитайте объект `voice` | `true` |335| `voiceEnabled` | Устаревший псевдоним для `voice.enabled`. Предпочитайте объект `voice` | `true` |

333| `wheelScrollAccelerationEnabled` | {/* min-version: 2.1.174 */}**По умолчанию**: `true`. В [fullscreen rendering](/ru/fullscreen#mouse-wheel-scrolling), ускорить скорость прокрутки колеса мыши во время быстрой прокрутки. Установите на `false` для постоянной скорости прокрутки за один оборот колеса. Требует Claude Code v2.1.174 или позже | `false` |336| `wheelScrollAccelerationEnabled` | {{/* min-version: 2.1.174 */}}**По умолчанию**: `true`. В [fullscreen rendering](/ru/fullscreen#mouse-wheel-scrolling), ускорить скорость прокрутки колеса мыши во время быстрой прокрутки. Установите на `false` для постоянной скорости прокрутки за один оборот колеса. Требует Claude Code v2.1.174 или позже | `false` |

334| `workflowKeywordTriggerEnabled` | {/* min-version: 2.1.157 */}**По умолчанию**: `true`. Вызывает ли слово `ultracode` в запросе [динамический workflow](/ru/workflows#ask-for-a-workflow-in-your-prompt). Установите на `false`, чтобы вводить слово без срабатывания. Ultracode, `/workflows` и сохраненные команды workflow не затронуты. Появляется в `/config` как **Ultracode keyword trigger**. Добавлено в v2.1.157; до v2.1.160 ключевое слово триггера было `workflow` | `false` |337| `workflowKeywordTriggerEnabled` | {{/* min-version: 2.1.157 */}}**По умолчанию**: `true`. Вызывает ли слово `ultracode` в запросе [динамический workflow](/ru/workflows#ask-for-a-workflow-in-your-prompt). Установите на `false`, чтобы вводить слово без срабатывания. Ultracode, `/workflows` и сохраненные команды workflow не затронуты. Появляется в `/config` как **Ultracode keyword trigger**. Добавлено в v2.1.157; до v2.1.160 ключевое слово триггера было `workflow` | `false` |

335| `wslInheritsWindowsSettings` | (Только управляемые параметры Windows) Когда `true`, Claude Code на WSL читает управляемые параметры из цепочки политик Windows в дополнение к `/etc/claude-code`, с приоритетом источников Windows. Учитывается только при установке в ключе реестра HKLM или `C:\Program Files\ClaudeCode\managed-settings.json`, оба из которых требуют администратора Windows для записи. Чтобы политика HKCU также применялась на WSL, флаг должен быть дополнительно установлен в самом HKCU. Не влияет на нативный Windows | `true` |338| `wslInheritsWindowsSettings` | (Только управляемые параметры Windows) Когда `true`, Claude Code на WSL читает управляемые параметры из цепочки политик Windows в дополнение к `/etc/claude-code`, с приоритетом источников Windows. Учитывается только при установке в ключе реестра HKLM или `C:\Program Files\ClaudeCode\managed-settings.json`, оба из которых требуют администратора Windows для записи. Чтобы политика HKCU также применялась на WSL, флаг должен быть дополнительно установлен в самом HKCU. Не влияет на нативный Windows | `true` |

336 339 

337<h3 id="global-config-settings">340<h3 id="global-config-settings">


345</Note>348</Note>

346 349 

347| Ключ | Описание | Пример |350| Ключ | Описание | Пример |

348| :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |351| :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |

349| `autoConnectIde` | **По умолчанию**: `false`. Автоматически подключаться к запущенной IDE при запуске Claude Code из внешнего терминала. Появляется в `/config` как **Auto-connect to IDE (external terminal)** при запуске вне терминала VS Code или JetBrains. Переменная окружения [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/ru/env-vars) переопределяет это при установке | `true` |352| `autoConnectIde` | **По умолчанию**: `false`. Автоматически подключаться к запущенной IDE при запуске Claude Code из внешнего терминала. Появляется в `/config` как **Auto-connect to IDE (external terminal)** при запуске вне терминала VS Code или JetBrains. Переменная окружения [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/ru/env-vars) переопределяет это при установке | `true` |

350| `autoInstallIdeExtension` | **По умолчанию**: `true`. Автоматически устанавливать расширение Claude Code IDE при запуске из терминала VS Code. Появляется в `/config` как **Auto-install IDE extension** при запуске внутри терминала VS Code или JetBrains. Вы также можете установить переменную окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/ru/env-vars) на `1` | `false` |353| `autoInstallIdeExtension` | **По умолчанию**: `true`. Автоматически устанавливать расширение Claude Code IDE при запуске из терминала VS Code. Появляется в `/config` как **Auto-install IDE extension** при запуске внутри терминала VS Code или JetBrains. Вы также можете установить переменную окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/ru/env-vars) на `1` | `false` |

351| `externalEditorContext` | **По умолчанию**: `false`. Добавить предыдущий ответ Claude как контекст с комментариями `#` при открытии внешнего редактора с помощью `Ctrl+G`. Появляется в `/config` как **Show last response in external editor** | `true` |354| `externalEditorContext` | **По умолчанию**: `false`. Добавить предыдущий ответ Claude как контекст с комментариями `#` при открытии внешнего редактора с помощью `Ctrl+G`. Появляется в `/config` как **Show last response in external editor** | `true` |

355| `permissionExplainerEnabled` | **По умолчанию**: `true`. Показать объяснение, созданное моделью, [команды](/ru/permissions#permission-system) при нажатии `Ctrl+E` на запросе разрешения Bash или PowerShell. Установите на `false`, чтобы отключить сочетание клавиш | `false` |

352| `teammateDefaultModel` | Модель по умолчанию для товарищей по [команде агентов](/ru/agent-teams) когда запрос порождения не указывает одну. Установите на псевдоним модели, такой как `"sonnet"`, или `null` для наследования текущего выбора `/model` лидера. Появляется в `/config` как **Default teammate model** | `"sonnet"` |356| `teammateDefaultModel` | Модель по умолчанию для товарищей по [команде агентов](/ru/agent-teams) когда запрос порождения не указывает одну. Установите на псевдоним модели, такой как `"sonnet"`, или `null` для наследования текущего выбора `/model` лидера. Появляется в `/config` как **Default teammate model** | `"sonnet"` |

353| `workflowSizeGuideline` | {/* min-version: 2.1.202 */}**По умолчанию**: `unrestricted`, который не отправляет никакого руководства. Устанавливает [количество агентов, на которое Claude нацелен](/ru/workflows#set-a-size-guideline) в динамических workflows, которые он пишет. Claude Code отправляет значение Claude как совет, а не как принудительный лимит. Принимает `unrestricted`, `small`, `medium` или `large`. Появляется в `/config` как **Dynamic workflow size**. Вы также можете установить его напрямую с помощью `/config workflowSizeGuideline=small`. Требует Claude Code v2.1.202 или позже. {/* min-version: 2.1.203 */}Руководство по количеству агентов также заменяет порог по умолчанию для [предупреждения `Large workflow`](/ru/workflows#cost); это поведение требует Claude Code v2.1.203 или позже | `"small"` |357| `workflowSizeGuideline` | {{/* min-version: 2.1.202 */}}**По умолчанию**: `unrestricted`, который не отправляет никакого руководства. Устанавливает [количество агентов, на которое Claude нацелен](/ru/workflows#set-a-size-guideline) в динамических workflows, которые он пишет. Claude Code отправляет значение Claude как совет, а не как принудительный лимит. Принимает `unrestricted`, `small`, `medium` или `large`. Появляется в `/config` как **Dynamic workflow size**. Вы также можете установить его напрямую с помощью `/config workflowSizeGuideline=small`. Требует Claude Code v2.1.202 или позже. {{/* min-version: 2.1.203 */}}Руководство по количеству агентов также заменяет порог по умолчанию для [предупреждения `Large workflow`](/ru/workflows#cost); это поведение требует Claude Code v2.1.203 или позже | `"small"` |

354 358 

355<h3 id="worktree-settings">359<h3 id="worktree-settings">

356 Параметры Worktree360 Параметры Worktree


359Настройте, как `--worktree` создает и управляет git worktrees.363Настройте, как `--worktree` создает и управляет git worktrees.

360 364 

361| Ключ | Описание | Пример |365| Ключ | Описание | Пример |

362| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |366| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

363| `worktree.baseRef` | Какой ref новые worktrees ветвятся от. `"fresh"` (по умолчанию) ветвится от `origin/<default-branch>` для чистого дерева, соответствующего удаленному. `"head"` ветвится от вашего текущего локального `HEAD`, поэтому неотправленные коммиты и состояние ветки функции присутствуют в worktree. Применяется к `--worktree`, инструменту `EnterWorktree` и изоляции subagent | `"head"` |367| `worktree.baseRef` | Какой ref новые worktrees ветвятся от. `"fresh"` (по умолчанию) ветвится от `origin/<default-branch>` для чистого дерева, соответствующего удаленному. `"head"` ветвится от вашего текущего локального `HEAD`, поэтому неотправленные коммиты и состояние ветки функции присутствуют в worktree. Внутри связанного worktree, `"head"` разрешается в `HEAD` этого worktree, а не в основной проверке. Применяется к `--worktree`, инструменту `EnterWorktree` и изоляции subagent | `"head"` |

364| `worktree.symlinkDirectories` | Каталоги для создания символических ссылок из основного репозитория в каждый worktree, чтобы избежать дублирования больших каталогов на диске. По умолчанию никакие каталоги не создаются символическими ссылками | `["node_modules", ".cache"]` |368| `worktree.symlinkDirectories` | Каталоги для создания символических ссылок из основного репозитория в каждый worktree, чтобы избежать дублирования больших каталогов на диске. По умолчанию никакие каталоги не создаются символическими ссылками | `["node_modules", ".cache"]` |

365| `worktree.sparsePaths` | Каталоги для проверки в каждом worktree через git sparse-checkout. На диск записываются только перечисленные пути, что быстрее в больших монорепозиториях | `["packages/my-app", "shared/utils"]` |369| `worktree.sparsePaths` | Каталоги для проверки в каждом worktree через git sparse-checkout. На диск записываются только перечисленные пути, что быстрее в больших монорепозиториях. Пока существует разреженный worktree, git включает `extensions.worktreeConfig` в общий файл `.git/config` репозитория; см. [Проверить только нужные вам каталоги](/ru/large-codebases#check-out-only-the-directories-you-need) | `["packages/my-app", "shared/utils"]` |

366| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Режим изоляции для [фоновых сеансов](/ru/agent-view#how-file-edits-are-isolated). `"worktree"` (по умолчанию) блокирует `Edit`/`Write` в основной проверке до вызова `EnterWorktree`. {/* min-version: 2.1.203 */}Вне git репозитория, [hook `WorktreeCreate`](/ru/worktrees#non-git-version-control), который не удается, освобождает блок, чтобы сеанс мог редактировать рабочий каталог на месте; требует Claude Code v2.1.203 или позже. `"none"` позволяет фоновым заданиям редактировать рабочую копию напрямую. Требует Claude Code v2.1.143 или позже | `"none"` |370| `worktree.bgIsolation` | {{/* min-version: 2.1.143 */}}Режим изоляции для [фоновых сеансов](/ru/agent-view#how-file-edits-are-isolated). `"worktree"` (по умолчанию) блокирует `Edit`/`Write` в основной проверке до вызова `EnterWorktree`. {{/* min-version: 2.1.203 */}}Вне git репозитория, [hook `WorktreeCreate`](/ru/worktrees#non-git-version-control), который не удается, освобождает блок, чтобы сеанс мог редактировать рабочий каталог на месте; требует Claude Code v2.1.203 или позже. `"none"` позволяет фоновым заданиям редактировать рабочую копию напрямую. Требует Claude Code v2.1.143 или позже | `"none"` |

367 371 

368Чтобы скопировать файлы, игнорируемые gitignore, такие как `.env`, в новые worktrees, используйте [файл `.worktreeinclude`](/ru/worktrees#copy-gitignored-files-into-worktrees) в корне вашего проекта вместо параметра.372Чтобы скопировать файлы, игнорируемые gitignore, такие как `.env`, в новые worktrees, используйте [файл `.worktreeinclude`](/ru/worktrees#copy-gitignored-files-into-worktrees) в корне вашего проекта вместо параметра.

369 373 


372</h3>376</h3>

373 377 

374| Ключи | Описание | Пример |378| Ключи | Описание | Пример |

375| :---------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |379| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------- |

376| `allow` | Массив правил разрешений для разрешения использования инструмента. Глобусы имен инструментов поддерживаются только в позиции инструмента после буквального префикса `mcp__<server>__`, такого как `mcp__github__get_*`; сегмент сервера должен быть без глобусов. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже для деталей сопоставления шаблонов | `[ "Bash(git diff *)" ]` |380| `allow` | Массив правил разрешений для разрешения использования инструмента. Глобусы имен инструментов поддерживаются только в позиции инструмента после буквального префикса `mcp__<server>__`, такого как `mcp__github__get_*`; сегмент сервера должен быть без глобусов. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже для деталей сопоставления шаблонов | `[ "Bash(git diff *)" ]` |

377| `ask` | Массив правил разрешений для запроса подтверждения при использовании инструмента. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже | `[ "Bash(git push *)" ]` |381| `ask` | Массив правил разрешений для запроса подтверждения при использовании инструмента. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже | `[ "Bash(git push *)" ]` |

378| `deny` | Массив правил разрешений для запрета использования инструмента. Используйте это для исключения чувствительных файлов из доступа Claude Code. Имена инструментов принимают глобусы: `"*"` запрещает каждый инструмент и `"mcp__*"` запрещает все MCP инструменты. См. [Синтаксис правила разрешения](#permission-rule-syntax) и [Ограничения разрешений Bash](/ru/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |382| `deny` | Массив правил разрешений для запрета использования инструмента. Используйте это для исключения чувствительных файлов из доступа Claude Code. Имена инструментов принимают глобусы: `"*"` запрещает каждый инструмент и `"mcp__*"` запрещает все MCP инструменты. См. [Синтаксис правила разрешения](#permission-rule-syntax) и [Ограничения разрешений Bash](/ru/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

379| `additionalDirectories` | Дополнительные [рабочие каталоги](/ru/permissions#working-directories) для доступа к файлам. Большинство конфигурации `.claude/` [не обнаруживается](/ru/permissions#additional-directories-grant-file-access-not-configuration) из этих каталогов | `[ "../docs/" ]` |383| `additionalDirectories` | Дополнительные [рабочие каталоги](/ru/permissions#working-directories) для доступа к файлам. Большинство конфигурации `.claude/` [не обнаруживается](/ru/permissions#additional-directories-grant-file-access-not-configuration) из этих каталогов | `[ "../docs/" ]` |

380| `defaultMode` | Режим [разрешения](/ru/permission-modes) по умолчанию при открытии Claude Code. Допустимые значения: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` и {/* min-version: 2.1.200 */}}`manual` как псевдоним для `default`, режим, обозначенный как Manual в CLI и расширениях VS Code и JetBrains. Псевдоним `manual` требует Claude Code v2.1.200 или позже. {/* min-version: 2.1.142 */}}`auto` игнорируется при установке в параметрах проекта или локальных параметрах, поэтому репозиторий не может предоставить себе автоматический режим; установите его в `~/.claude/settings.json` вместо этого. До v2.1.142 параметры проекта могли устанавливать `auto`. Флаг CLI `--permission-mode` переопределяет этот параметр для одного сеанса | `"acceptEdits"` |384| `defaultMode` | Режим [разрешения](/ru/permission-modes) по умолчанию при открытии Claude Code. Допустимые значения: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` и {{/* min-version: 2.1.200 */}}`manual` как псевдоним для `default`, режим, обозначенный как Manual в CLI и расширениях VS Code и JetBrains. Псевдоним `manual` требует Claude Code v2.1.200 или позже. {{/* min-version: 2.1.142 */}}`auto` игнорируется при установке в параметрах проекта или локальных параметрах, поэтому репозиторий не может предоставить себе автоматический режим; установите его в `~/.claude/settings.json` вместо этого. До v2.1.142 параметры проекта могли устанавливать `auto`. Флаг CLI `--permission-mode` переопределяет этот параметр для одного сеанса | `"acceptEdits"` |

381| `disableBypassPermissionsMode` | Установите на `"disable"`, чтобы предотвратить активацию режима `bypassPermissions`. Это отключает флаг командной строки `--dangerously-skip-permissions`. Обычно размещается в [управляемых параметрах](/ru/permissions#managed-settings) для применения организационной политики, но работает из любой области | `"disable"` |385| `disableBypassPermissionsMode` | Установите на `"disable"`, чтобы предотвратить активацию режима `bypassPermissions`. Это отключает флаг командной строки `--dangerously-skip-permissions`. Обычно размещается в [управляемых параметрах](/ru/permissions#managed-settings) для применения организационной политики, но работает из любой области | `"disable"` |

382| `skipDangerousModePermissionPrompt` | Пропустить подтверждение, показываемое перед входом в режим обхода разрешений через `--dangerously-skip-permissions` или `defaultMode: "bypassPermissions"`. Игнорируется при установке в параметрах проекта (`.claude/settings.json`) для предотвращения автоматического обхода подтверждения ненадежными репозиториями | `true` |386| `skipDangerousModePermissionPrompt` | Пропустить подтверждение, показываемое перед входом в режим обхода разрешений через `--dangerously-skip-permissions` или `defaultMode: "bypassPermissions"`. Игнорируется при установке в параметрах проекта (`.claude/settings.json`) для предотвращения автоматического обхода подтверждения ненадежными репозиториями | `true` |

383 387 


405Настройте расширенное поведение sandboxing. Sandboxing изолирует команды bash от вашей файловой системы и сети. См. [Sandboxing](/ru/sandboxing) для деталей.409Настройте расширенное поведение sandboxing. Sandboxing изолирует команды bash от вашей файловой системы и сети. См. [Sandboxing](/ru/sandboxing) для деталей.

406 410 

407| Ключи | Описание | Пример |411| Ключи | Описание | Пример |

408| :------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |412| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

409| `enabled` | Включить bash sandboxing (macOS, Linux и WSL2). По умолчанию: false | `true` |413| `enabled` | Включить bash sandboxing (macOS, Linux и WSL2). По умолчанию: false | `true` |

410| `failIfUnavailable` | Выход с ошибкой при запуске, если `sandbox.enabled` равно true, но sandbox не может запуститься (отсутствуют зависимости или неподдерживаемая платформа). Когда false (по умолчанию), выводится предупреждение и команды выполняются без sandbox. Предназначено для развертываний управляемых параметров, требующих sandboxing как жесткого шлюза | `true` |414| `failIfUnavailable` | Выход с ошибкой при запуске, если `sandbox.enabled` равно true, но sandbox не может запуститься (отсутствуют зависимости или неподдерживаемая платформа). Когда false (по умолчанию), выводится предупреждение и команды выполняются без sandbox. Предназначено для развертываний управляемых параметров, требующих sandboxing как жесткого шлюза | `true` |

411| `autoAllowBashIfSandboxed` | Автоматически одобрить команды bash при sandboxing. По умолчанию: true | `true` |415| `autoAllowBashIfSandboxed` | Автоматически одобрить команды bash при sandboxing. По умолчанию: true | `true` |


414| `filesystem.allowWrite` | Дополнительные пути, где команды в sandbox могут писать. Массивы объединяются во всех областях параметров: пути пользователя, проекта и управляемые пути объединяются, не заменяются. Также объединяются с путями из правил разрешения `Edit(...)`. См. [префиксы пути sandbox](#sandbox-path-prefixes) ниже. | `["/tmp/build", "~/.kube"]` |418| `filesystem.allowWrite` | Дополнительные пути, где команды в sandbox могут писать. Массивы объединяются во всех областях параметров: пути пользователя, проекта и управляемые пути объединяются, не заменяются. Также объединяются с путями из правил разрешения `Edit(...)`. См. [префиксы пути sandbox](#sandbox-path-prefixes) ниже. | `["/tmp/build", "~/.kube"]` |

415| `filesystem.denyWrite` | Пути, где команды в sandbox не могут писать. Массивы объединяются во всех областях параметров. Также объединяются с путями из правил разрешения `Edit(...)`. | `["/etc", "/usr/local/bin"]` |419| `filesystem.denyWrite` | Пути, где команды в sandbox не могут писать. Массивы объединяются во всех областях параметров. Также объединяются с путями из правил разрешения `Edit(...)`. | `["/etc", "/usr/local/bin"]` |

416| `filesystem.denyRead` | Пути, где команды в sandbox не могут читать. Массивы объединяются во всех областях параметров. Также объединяются с путями из правил разрешения `Read(...)`. | `["~/.aws/credentials"]` |420| `filesystem.denyRead` | Пути, где команды в sandbox не могут читать. Массивы объединяются во всех областях параметров. Также объединяются с путями из правил разрешения `Read(...)`. | `["~/.aws/credentials"]` |

417| `filesystem.allowRead` | Пути для повторного разрешения чтения в пределах регионов `denyRead`. Имеет приоритет над `denyRead`. Массивы объединяются во всех областях параметров. Используйте это для создания шаблонов доступа для чтения только рабочей области. | `["."]` |421| `filesystem.allowRead` | Пути для повторного разрешения чтения в пределах регионов `denyRead`. Путь `allowRead` повторно открывает чтение внутри более широкого региона `denyRead`, и точный путь в `denyRead` остается заблокированным внутри более широкого `allowRead`; см. [таблицу перекрытия](/ru/sandboxing#configure-sandboxing) для примеров. Массивы объединяются во всех областях параметров. Используйте это для создания шаблонов доступа для чтения только рабочей области. | `["."]` |

418| `filesystem.allowManagedReadPathsOnly` | (Только управляемые параметры) Только пути `allowRead` из управляемых параметров учитываются. `denyRead` по-прежнему объединяется из всех источников. По умолчанию: false | `true` |422| `filesystem.allowManagedReadPathsOnly` | (Только управляемые параметры) Только пути `allowRead` из управляемых параметров учитываются. `denyRead` по-прежнему объединяется из всех источников. По умолчанию: false | `true` |

419| `credentials.files` | {/* min-version: 2.1.187 */}Файлы учетных данных или каталоги, которые команды в sandbox не могут читать. Применяет тот же блок чтения, что и `filesystem.denyRead`; отдельный ключ держит пути учетных данных сгруппированными с `credentials.envVars` и отдельно от общих правил файловой системы. Каждая запись - это `{ "path": "...", "mode": "deny" }`, и `deny` - единственный поддерживаемый режим для файлов. Пути используют те же [префиксы](#sandbox-path-prefixes), что и параметры `filesystem.*`. Массивы объединяются во всех областях параметров. Требует Claude Code v2.1.187 или позже. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |423| `credentials.files` | {{/* min-version: 2.1.187 */}}Файлы учетных данных или каталоги, которые команды в sandbox не могут читать. Применяет тот же блок чтения, что и `filesystem.denyRead`; отдельный ключ держит пути учетных данных сгруппированными с `credentials.envVars` и отдельно от общих правил файловой системы. Каждая запись - это `{ "path": "...", "mode": "deny" }`, и `deny` - единственный поддерживаемый режим для файлов. Пути используют те же [префиксы](#sandbox-path-prefixes), что и параметры `filesystem.*`. Массивы объединяются во всех областях параметров. Требует Claude Code v2.1.187 или позже. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |

420| `credentials.envVars` | {/* min-version: 2.1.187 */}Переменные окружения для [защиты от команд в sandbox](/ru/sandboxing#protect-credentials). Каждая запись имеет `name` и `mode`; имя должно начинаться с буквы или подчеркивания и содержать только буквы, цифры и подчеркивания. `deny` удаляет переменную из окружения команд в sandbox. Требует Claude Code v2.1.187 или позже. {/* min-version: 2.1.199 */}}`mask` заменяет переменную значением-дозорным для каждого сеанса внутри sandbox, пока прокси sandbox подставляет реальное значение на исходящих запросах к записям `injectHosts` этой записи; это требует `network.tlsTerminate` и Claude Code v2.1.199 или позже. Записи `mask` учитываются только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. Массивы объединяются во всех областях параметров, и `deny` имеет приоритет, когда одна переменная появляется с обоими режимами. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |424| `credentials.envVars` | {{/* min-version: 2.1.187 */}}Переменные окружения для [защиты от команд в sandbox](/ru/sandboxing#protect-credentials). Каждая запись имеет `name` и `mode`; имя должно начинаться с буквы или подчеркивания и содержать только буквы, цифры и подчеркивания. `deny` удаляет переменную из окружения команд в sandbox. Требует Claude Code v2.1.187 или позже. {{/* min-version: 2.1.199 */}}`mask` заменяет переменную значением-дозорным для каждого сеанса внутри sandbox, пока прокси sandbox подставляет реальное значение на исходящих запросах к записям `injectHosts` этой записи; это требует `network.tlsTerminate` и Claude Code v2.1.199 или позже. Записи `mask` учитываются только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. Массивы объединяются во всех областях параметров, и `deny` имеет приоритет, когда одна переменная появляется с обоими режимами. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |

421| `credentials.envVars[].injectHosts` | Хосты, где прокси sandbox подставляет реальное значение записи `mask`. Каждый хост также должен быть покрыт `network.allowedDomains`, либо точно, либо подстановочным знаком. Когда не установлено, прокси подставляет значение на запросы каждому хосту в `network.allowedDomains`. Принимается, но игнорируется, когда `mode` - `deny`. Требует Claude Code v2.1.199 или позже. {/* min-version: 2.1.199 */} | `["api.github.com"]` |425| `credentials.envVars[].injectHosts` | Хосты, где прокси sandbox подставляет реальное значение записи `mask`. Каждый хост также должен быть покрыт `network.allowedDomains`, либо точно, либо подстановочным знаком. Когда не установлено, прокси подставляет значение на запросы каждому хосту в `network.allowedDomains`. Принимается, но игнорируется, когда `mode` - `deny`. Требует Claude Code v2.1.199 или позже. {{/* min-version: 2.1.199 */}} | `["api.github.com"]` |

422| `credentials.allowPlaintextInject` | Разрешить подстановку `mask` на простых HTTP запросах, а также на TLS-завершенных HTTPS. На простом HTTP восходящая идентификация не проверена и учетные данные путешествуют в открытом виде, поэтому оставьте это отключенным вне доверенных тестовых сетей. Учитывается только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. По умолчанию: false. Требует Claude Code v2.1.199 или позже. {/* min-version: 2.1.199 */} | `true` |426| `credentials.allowPlaintextInject` | Разрешить подстановку `mask` на простых HTTP запросах, а также на TLS-завершенных HTTPS. На простом HTTP восходящая идентификация не проверена и учетные данные путешествуют в открытом виде, поэтому оставьте это отключенным вне доверенных тестовых сетей. Учитывается только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. По умолчанию: false. Требует Claude Code v2.1.199 или позже. {{/* min-version: 2.1.199 */}} | `true` |

423| `network.allowUnixSockets` | (Только macOS) Пути Unix socket, доступные в sandbox. Игнорируется на Linux и WSL2, где фильтр seccomp не может проверить пути socket; используйте `allowAllUnixSockets` вместо этого. | `["~/.ssh/agent-socket"]` |427| `network.allowUnixSockets` | (Только macOS) Пути Unix socket, доступные в sandbox. Игнорируется на Linux и WSL2, где фильтр seccomp не может проверить пути socket; используйте `allowAllUnixSockets` вместо этого. | `["~/.ssh/agent-socket"]` |

424| `network.allowAllUnixSockets` | Разрешить все подключения Unix socket в sandbox. На Linux и WSL2 это единственный способ разрешить Unix sockets, так как он пропускает фильтр seccomp, который в противном случае блокирует вызовы `socket(AF_UNIX, ...)`. По умолчанию: false | `true` |428| `network.allowAllUnixSockets` | Разрешить все подключения Unix socket в sandbox. На Linux и WSL2 это единственный способ разрешить Unix sockets, так как он пропускает фильтр seccomp, который в противном случае блокирует вызовы `socket(AF_UNIX, ...)`. По умолчанию: false | `true` |

425| `network.allowLocalBinding` | Разрешить привязку к портам localhost (только macOS). По умолчанию: false | `true` |429| `network.allowLocalBinding` | Разрешить привязку к портам localhost (только macOS). По умолчанию: false | `true` |


429| `network.allowManagedDomainsOnly` | (Только управляемые параметры) Только `allowedDomains` и правила разрешения `WebFetch(domain:...)` из управляемых параметров учитываются. Домены из параметров пользователя, проекта и локальной области игнорируются. Неразрешенные домены автоматически блокируются без запроса пользователя. Запрещенные домены по-прежнему учитываются из всех источников. По умолчанию: false | `true` |433| `network.allowManagedDomainsOnly` | (Только управляемые параметры) Только `allowedDomains` и правила разрешения `WebFetch(domain:...)` из управляемых параметров учитываются. Домены из параметров пользователя, проекта и локальной области игнорируются. Неразрешенные домены автоматически блокируются без запроса пользователя. Запрещенные домены по-прежнему учитываются из всех источников. По умолчанию: false | `true` |

430| `network.httpProxyPort` | Порт HTTP прокси, используемый, если вы хотите использовать собственный прокси. Если не указано, Claude запустит собственный прокси. | `8080` |434| `network.httpProxyPort` | Порт HTTP прокси, используемый, если вы хотите использовать собственный прокси. Если не указано, Claude запустит собственный прокси. | `8080` |

431| `network.socksProxyPort` | Порт SOCKS5 прокси, используемый, если вы хотите использовать собственный прокси. Если не указано, Claude запустит собственный прокси. | `8081` |435| `network.socksProxyPort` | Порт SOCKS5 прокси, используемый, если вы хотите использовать собственный прокси. Если не указано, Claude запустит собственный прокси. | `8081` |

432| `network.tlsTerminate` | Экспериментально. Завершить TLS внутри прокси sandbox, чтобы он мог читать содержимое HTTPS запросов. Требуется для [подстановки учетных данных](/ru/sandboxing#protect-credentials) `mask`. Установите `{}` для создания эфемерного центра сертификации для сеанса, или установите `caCertPath` и `caKeyPath` для использования вашего собственного. Учитывается только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. Требует Claude Code v2.1.199 или позже. {/* min-version: 2.1.199 */} | `{}` |436| `network.tlsTerminate` | Экспериментально. Завершить TLS внутри прокси sandbox, чтобы он мог читать содержимое HTTPS запросов. Требуется для [подстановки учетных данных](/ru/sandboxing#protect-credentials) `mask`. Установите `{}` для создания эфемерного центра сертификации для сеанса, или установите `caCertPath` и `caKeyPath` для использования вашего собственного. Учитывается только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. Требует Claude Code v2.1.199 или позже. {{/* min-version: 2.1.199 */}} | `{}` |

433| `enableWeakerNestedSandbox` | Включить более слабый sandbox для непривилегированных окружений Docker (только Linux и WSL2). **Снижает безопасность.** По умолчанию: false | `true` |437| `enableWeakerNestedSandbox` | Включить более слабый sandbox для непривилегированных окружений Docker (только Linux и WSL2). **Снижает безопасность.** По умолчанию: false | `true` |

434| `enableWeakerNetworkIsolation` | (Только macOS) Разрешить доступ к системной службе доверия TLS (`com.apple.trustd.agent`) в sandbox. Требуется для инструментов на основе Go, таких как `gh`, `gcloud` и `terraform`, для проверки сертификатов TLS при использовании `httpProxyPort` с MITM прокси и пользовательским CA. **Снижает безопасность** путем открытия потенциального пути утечки данных. По умолчанию: false | `true` |438| `enableWeakerNetworkIsolation` | (Только macOS) Разрешить доступ к системной службе доверия TLS (`com.apple.trustd.agent`) в sandbox. Требуется для инструментов на основе Go, таких как `gh`, `gcloud` и `terraform`, для проверки сертификатов TLS при использовании `httpProxyPort` с MITM прокси и пользовательским CA. **Снижает безопасность** путем открытия потенциального пути утечки данных. По умолчанию: false | `true` |

435| `allowAppleEvents` | (Только macOS) Разрешить команды в sandbox отправлять Apple Events. Требуется для `open`, `osascript` и инструментов, которые открывают URL в браузере, которые в противном случае не удаются с ошибкой `-600`. **Удаляет изоляцию выполнения кода.** Команды в sandbox могут запускать другие приложения без sandbox без запроса пользователя; они также могут отправлять команды AppleScript запущенным приложениям, таким как Terminal, в соответствии с запросом согласия на автоматизацию macOS для каждого приложения (TCC). Учитывается только из параметров пользователя, управляемых или CLI, а не из параметров проекта. По умолчанию: false | `true` |439| `allowAppleEvents` | (Только macOS) Разрешить команды в sandbox отправлять Apple Events. Требуется для `open`, `osascript` и инструментов, которые открывают URL в браузере, которые в противном случае не удаются с ошибкой `-600`. **Удаляет изоляцию выполнения кода.** Команды в sandbox могут запускать другие приложения без sandbox без запроса пользователя; они также могут отправлять команды AppleScript запущенным приложениям, таким как Terminal, в соответствии с запросом согласия на автоматизацию macOS для каждого приложения (TCC). Учитывается только из параметров пользователя, управляемых или CLI, а не из параметров проекта. По умолчанию: false | `true` |


448| `~/` | Относительно домашнего каталога | `~/.kube` становится `$HOME/.kube` |452| `~/` | Относительно домашнего каталога | `~/.kube` становится `$HOME/.kube` |

449| `./` или без префикса | Относительно корня проекта для параметров проекта, или к `~/.claude` для параметров пользователя | `./output` в `.claude/settings.json` разрешается в `<project-root>/output` |453| `./` или без префикса | Относительно корня проекта для параметров проекта, или к `~/.claude` для параметров пользователя | `./output` в `.claude/settings.json` разрешается в `<project-root>/output` |

450 454 

451Более старый префикс `//path` для абсолютных путей по-прежнему работает. Если вы ранее использовали одиночный слэш `/path`, ожидая разрешения относительно проекта, переключитесь на `./path`. Этот синтаксис отличается от [правил разрешения Read и Edit](/ru/permissions#read-and-edit), которые используют `//path` для абсолютного и `/path` для относительного к проекту. Пути файловой системы sandbox используют стандартные соглашения: `/tmp/build` - это абсолютный путь.455Более старый префикс `//path` для абсолютных путей по-прежнему работает. Если вы ранее использовали одиночный слэш `/path`, ожидая разрешения относительно проекта, переключитесь на `./path`.

456 

457Этот синтаксис отличается от [правил разрешения Read и Edit](/ru/permissions#read-and-edit), которые используют `//path` для абсолютного и `/path` для относительного к проекту. Пути файловой системы sandbox используют стандартные соглашения: `/tmp/build` - это абсолютный путь.

452 458 

453**Пример конфигурации:**459**Пример конфигурации:**

454 460 


597| Количество значков | Максимум 5 значков отображаются. Самый старый вытесняется новыми совпадениями и `/clear` удаляет их |603| Количество значков | Максимум 5 значков отображаются. Самый старый вытесняется новыми совпадениями и `/clear` удаляет их |

598| Область параметров | Читается из параметров пользователя, флага `--settings` и управляемых параметров только. Игнорируется в проекте `.claude/settings.json` и локальном `.claude/settings.local.json` |604| Область параметров | Читается из параметров пользователя, флага `--settings` и управляемых параметров только. Игнорируется в проекте `.claude/settings.json` и локальном `.claude/settings.local.json` |

599 605 

600Когда ход завершается, Claude Code сопоставляет регулярное выражение `pattern` каждой записи с выводом хода на основном потоке, поэтому медленное регулярное выражение блокирует пользовательский интерфейс до завершения. Вложенные квантификаторы, такие как `(a+)+$`, могут занимать экспоненциально долго против определенных входов и замораживать сеанс, поэтому держите каждый `pattern` линейным и избегайте вложения `+` или `*`.606Когда ход завершается, Claude Code сопоставляет регулярное выражение `pattern` каждой записи с выводом хода на основном потоке, поэтому медленное регулярное выражение блокирует пользовательский интерфейс до завершения. Влож енные квантификаторы, такие как `(a+)+$`, могут занимать экспоненциально долго против определенных входов и замораживать сеанс, поэтому держите каждый `pattern` линейным и избегайте вложения `+` или `*`.

601 607 

602Значки нижнего колонтитула отображаются рядом с [пользовательской строкой состояния](/ru/statusline), когда она настроена; ни один не заменяет другой. Используйте строку состояния для строки, управляемой скриптом, которая вычисляет свой собственный контент из данных сеанса, и значки нижнего колонтитула для преобразования ID из разговора в ссылки без скрипта.608Значки нижнего колонтитула отображаются рядом с [пользовательской строкой состояния](/ru/statusline), когда она настроена; ни один не заменяет другой. Используйте строку состояния для строки, управляемой скриптом, которая вычисляет свой собственный контент из данных сеанса, и значки нижнего колонтитула для преобразования ID из разговора в ссылки без скрипта.

603 609 


6701. **Управляемые параметры** ([управляемые сервером](/ru/server-managed-settings), [политики MDM/OS-уровня](#configuration-scopes) или [управляемые параметры](/ru/settings#settings-files))6761. **Управляемые параметры** ([управляемые сервером](/ru/server-managed-settings), [политики MDM/OS-уровня](#configuration-scopes) или [управляемые параметры](/ru/settings#settings-files))

671 * Политики, развернутые IT через доставку сервера, профили конфигурации MDM, политики реестра или файлы управляемых параметров677 * Политики, развернутые IT через доставку сервера, профили конфигурации MDM, политики реестра или файлы управляемых параметров

672 * Не могут быть переопределены никаким другим уровнем, включая аргументы командной строки678 * Не могут быть переопределены никаким другим уровнем, включая аргументы командной строки

673 * В пределах управляемого уровня приоритет: [`policyHelper`](#compute-managed-settings-with-a-policy-helper) вывод, который при настройке является единственным используемым управляемым источником > удаленный (параметры, управляемые сервером claude.ai или [Claude apps gateway](/ru/claude-apps-gateway)-доставленные) > политики MDM/OS-уровня > на основе файлов (`managed-settings.d/*.json` + `managed-settings.json`) > реестр HKCU (только Windows). Используется только один управляемый источник; источники не объединяются в разных уровнях, с одним исключением: ключи блокировки sandbox `sandbox.network.allowManagedDomainsOnly` и `sandbox.filesystem.allowManagedReadPathsOnly`, с их связанными списками разрешений, `allowAllClaudeAiMcps` и пути двоичных файлов sandbox `sandbox.bwrapPath` и `sandbox.socatPath` учитываются, когда любой управляемый источник, контролируемый администратором, их устанавливает; уровень HKCU, доступный для записи пользователем, исключен. В пределах уровня на основе файлов, drop-in файлы и базовый файл объединяются вместе.679 * В пределах управляемого уровня приоритет: [`policyHelper`](#compute-managed-settings-with-a-policy-helper) вывод, который при настройке является единственным используемым управляемым источником > удаленный (параметры, управляемые сервером claude.ai или [Claude apps gateway](/ru/claude-apps-gateway)-доставленные) > политики MDM/OS-уровня > на основе файлов (`managed-settings.d/*.json` и `managed-settings.json`, объединенные вместе) > реестр HKCU (только Windows). Используется только один управляемый источник; источники не объединяются в разных уровнях, с одним исключением: ключи блокировки sandbox `sandbox.network.allowManagedDomainsOnly` и `sandbox.filesystem.allowManagedReadPathsOnly`, с их связанными списками разрешений, `allowAllClaudeAiMcps` и пути двоичных файлов sandbox `sandbox.bwrapPath` и `sandbox.socatPath` учитываются, когда любой управляемый источник, контролируемый администратором, их устанавливает; уровень HKCU, доступный для записи пользователем, исключен.

674 * Хосты встраивания, такие как Claude Desktop, могут предоставлять политику через опцию SDK `managedSettings`. По умолчанию это игнорируется, когда присутствует любой управляемый источник, развернутый администратором: параметры, управляемые сервером, политика MDM или OS-уровня, или файл управляемых параметров. Резервный реестр HKCU, доступный для записи пользователем, не считается управляемым источником, развернутым администратором. Администраторы могут согласиться, установив [`parentSettingsBehavior`](#available-settings) на `"merge"`. Значения встраивателя отфильтрованы, чтобы они могли ужесточить управляемую политику, но не ослабить ее.680 * Хосты встраивания, такие как Claude Desktop, могут предоставлять политику через опцию SDK `managedSettings`. По умолчанию это игнорируется, когда присутствует любой управляемый источник, развернутый администратором: параметры, управляемые сервером, политика MDM или OS-уровня, или файл управляемых параметров. Резервный реестр HKCU, доступный для записи пользователем, не считается управляемым источником, развернутым администратором. Администраторы могут согласиться, установив [`parentSettingsBehavior`](#available-settings) на `"merge"`. Значения встраивателя отфильтрованы, чтобы они могли ужесточить управляемую политику, но не ослабить ее.

675 681 

6762. **Аргументы командной строки**6822. **Аргументы командной строки**


695 Два параметра массива не объединяются таким образом:701 Два параметра массива не объединяются таким образом:

696 702 

697 * [`fallbackModel`](#available-settings) - это упорядоченная цепь, где позиция имеет значение: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь.703 * [`fallbackModel`](#available-settings) - это упорядоченная цепь, где позиция имеет значение: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь.

698 * [`availableModels`](#available-settings): {/* min-version: 2.1.175 */}когда [источник управляемых параметров с наивысшим приоритетом](/ru/server-managed-settings#settings-precedence) его определяет, этот список применяется как есть и записи пользователя, проекта и локальной области не могут его расширить. В разных неуправляемых областях массивы объединяются как обычно. См. [Поведение объединения](/ru/model-config#merge-behavior).704 * [`availableModels`](#available-settings): {{/* min-version: 2.1.175 */}}когда [источник управляемых параметров с наивысшим приоритетом](/ru/server-managed-settings#settings-precedence) его определяет, этот список применяется как есть и записи пользователя, проекта и локальной области не могут его расширить. В разных неуправляемых областях массивы объединяются как обычно. См. [Поведение объединения](/ru/model-config#merge-behavior).

699</Note>705</Note>

700 706 

701<h3 id="verify-active-settings">707<h3 id="verify-active-settings">


821}827}

822```828```

823 829 

830<h4 id="pluginconfigs">

831 `pluginConfigs`

832</h4>

833 

834Хранит значения параметров, не содержащих конфиденциальную информацию, которые собирает [`userConfig`](/ru/plugins-reference#user-configuration) prompt plugin, индексированные по ID plugin. Claude Code записывает этот ключ в параметры пользователя, когда вы заполняете диалоговое окно конфигурации plugin, поэтому вам не нужно редактировать его вручную. Конфиденциальные параметры хранятся в macOS Keychain вместо этого, или в `~/.claude/.credentials.json` на платформах без поддерживаемого keychain.

835 

836Этот пример хранит один параметр для plugin, установленного из marketplace `acme-tools`:

837 

838```json theme={null}

839{

840 "pluginConfigs": {

841 "deployer@acme-tools": {

842 "options": {

843 "api_endpoint": "https://api.example.com"

844 }

845 }

846 }

847}

848```

849 

850`pluginConfigs` читается из параметров пользователя, флага `--settings` и управляемых параметров только. Записи в файле `.claude/settings.json` или `.claude/settings.local.json` проекта игнорируются, потому что эти значения подставляются в конфигурации hook, MCP и LSP plugin, и клонированный репозиторий не должен иметь возможность их предоставить. До v2.1.207 параметры проекта и локальные параметры также читались.

851 

824<h4 id="extraknownmarketplaces">852<h4 id="extraknownmarketplaces">

825 `extraKnownMarketplaces`853 `extraKnownMarketplaces`

826</h4>854</h4>

setup.md +6 −0

Details

206 206 

207Выполните `claude doctor` для просмотра результата последней попытки обновления.207Выполните `claude doctor` для просмотра результата последней попытки обновления.

208 208 

209На macOS и Linux встроенный установщик управляет средством запуска в `~/.local/bin/claude` как символической ссылкой в `~/.local/share/claude/versions/`. Если вы замените это средство запуска своим собственным скриптом или символической ссылкой, автоматическое обновление и `claude update` оставляют его на месте: новые версии по-прежнему устанавливаются в каталог `versions/`, и ваше средство запуска решает, какая версия запускается. До версии 2.1.207 автоматический обновляющий заменял пользовательское средство запуска в этом пути своей собственной символической ссылкой при каждом обновлении.

210 

211С пользовательским средством запуска Claude Code также сохраняет каждую установленную версию на диске, потому что не может определить, какая версия нужна средству запуска. `claude doctor` сообщает о средстве запуска, которое встроенный установщик не создал.

212 

213Чтобы позволить Claude Code снова управлять средством запуска, удалите `~/.local/bin/claude` и выполните `claude update`.

214 

209Если глобальная установка npm не может автоматически обновляться, потому что глобальный каталог npm не доступен для записи, Claude Code показывает одноразовое уведомление при запуске, и `claude doctor` перечисляет доступные исправления. Подробнее см. в разделе [ошибки разрешений при установке](/ru/troubleshoot-install#permission-errors-during-installation).215Если глобальная установка npm не может автоматически обновляться, потому что глобальный каталог npm не доступен для записи, Claude Code показывает одноразовое уведомление при запуске, и `claude doctor` перечисляет доступные исправления. Подробнее см. в разделе [ошибки разрешений при установке](/ru/troubleshoot-install#permission-errors-during-installation).

210 216 

211<Note>217<Note>

skills.md +1 −1

Details

359 359 

360* **`user-invocable: false`**: Только Claude может вызвать skill. Используйте это для фоновых знаний, которые не являются действенными как команда. Skill `legacy-system-context` объясняет, как работает старая система. Claude должен знать это при необходимости, но `/legacy-system-context` не является значимым действием для пользователей.360* **`user-invocable: false`**: Только Claude может вызвать skill. Используйте это для фоновых знаний, которые не являются действенными как команда. Skill `legacy-system-context` объясняет, как работает старая система. Claude должен знать это при необходимости, но `/legacy-system-context` не является значимым действием для пользователей.

361 361 

362Этот пример создаёт skill развёртывания, который может запустить только вы. Поле `disable-model-invocation: true` предотвращает автоматическое запуск Claude:362Этот пример создаёт skill развёртывания, который может запустить только вы. Если вы установите `disable-model-invocation: true`, Claude не сможет запустить skill автоматически:

363 363 

364```yaml theme={null}364```yaml theme={null}

365---365---

slack.md +1 −1

Details

7> Делегируйте задачи кодирования прямо из вашего рабочего пространства Slack7> Делегируйте задачи кодирования прямо из вашего рабочего пространства Slack

8 8 

9<Note>9<Note>

10 Claude Code в Slack заменяется на [Claude Tag](https://claude.com/docs/claude-tag/overview) для рабочих пространств Team и Enterprise. Claude Tag запускает @Claude как общую идентификацию вашей организации с настроенным администратором доступом в рамках одного приложения Slack, поэтому нет необходимости переустанавливать, и существующие настройки продолжают работать во время перехода. Чтобы переключить рабочее пространство, см. [Миграция с более ранней версии Claude в Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier).10 Claude Code в Slack заменяется на [Claude Tag](https://claude.com/product/tag) для рабочих пространств Team и Enterprise. Claude Tag запускает @Claude как общую идентификацию вашей организации с настроенным администратором доступом в рамках одного приложения Slack, поэтому нет необходимости переустанавливать, и существующие настройки продолжают работать во время перехода. Чтобы переключить рабочее пространство, см. [Миграция с более ранней версии Claude в Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier).

11</Note>11</Note>

12 12 

13Claude Code в Slack приносит мощь Claude Code прямо в ваше рабочее пространство Slack. Когда вы упоминаете `@Claude` с задачей кодирования, Claude автоматически определяет намерение и создает сеанс Claude Code в веб-версии, позволяя вам делегировать работу по разработке, не покидая командные беседы.13Claude Code в Slack приносит мощь Claude Code прямо в ваше рабочее пространство Slack. Когда вы упоминаете `@Claude` с задачей кодирования, Claude автоматически определяет намерение и создает сеанс Claude Code в веб-версии, позволяя вам делегировать работу по разработке, не покидая командные беседы.

sub-agents.md +11 −4

Details

284| :---------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |284| :---------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

285| `name` | Да | Уникальный идентификатор, использующий строчные буквы и дефисы. [Hooks](/ru/hooks#subagentstart) получают это значение как `agent_type`. Имя файла не должно совпадать |285| `name` | Да | Уникальный идентификатор, использующий строчные буквы и дефисы. [Hooks](/ru/hooks#subagentstart) получают это значение как `agent_type`. Имя файла не должно совпадать |

286| `description` | Да | Когда Claude должен делегировать этому subagent |286| `description` | Да | Когда Claude должен делегировать этому subagent |

287| `tools` | Нет | [Инструменты](#available-tools), которые может использовать subagent. Наследует все инструменты, если опущено. Чтобы предварительно загрузить Skills в контекст, используйте поле `skills` вместо перечисления `Skill` здесь |287| `tools` | Нет | [Инструменты](#available-tools), которые может использовать subagent. Наследует все инструменты, если опущено. Если ни один элемент в списке не разрешается в инструмент, subagent не запускается с ошибкой, называющей элементы. Чтобы предварительно загрузить Skills в контекст, используйте поле `skills` вместо перечисления `Skill` здесь |

288| `disallowedTools` | Нет | Инструменты для запрета, удалённые из унаследованного или указанного списка |288| `disallowedTools` | Нет | Инструменты для запрета, удалённые из унаследованного или указанного списка |

289| `model` | Нет | [Модель](#choose-a-model) для использования: `sonnet`, `opus`, `haiku`, `fable`, полный ID модели (например, `claude-opus-4-8`), или `inherit`. По умолчанию `inherit` |289| `model` | Нет | [Модель](#choose-a-model) для использования: `sonnet`, `opus`, `haiku`, `fable`, полный ID модели (например, `claude-opus-4-8`), или `inherit`. По умолчанию `inherit` |

290| `permissionMode` | Нет | [Режим разрешений](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, или {/* min-version: 2.1.200 */}`manual` как псевдоним для `default`. Псевдоним `manual` требует Claude Code v2.1.200 или позже. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |290| `permissionMode` | Нет | [Режим разрешений](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, или {/* min-version: 2.1.200 */}`manual` как псевдоним для `default`. Псевдоним `manual` требует Claude Code v2.1.200 или позже. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |


363 363 

364Если оба установлены, `disallowedTools` применяется первым, затем `tools` разрешается против оставшегося пула. Инструмент, указанный в обоих, удаляется.364Если оба установлены, `disallowedTools` применяется первым, затем `tools` разрешается против оставшегося пула. Инструмент, указанный в обоих, удаляется.

365 365 

366Когда ничего в списке `tools` не разрешается в инструмент, например потому что каждая запись неправильно написана или называет инструмент, который недоступен для subagents, Claude Code отказывается запускать subagent и инструмент Agent возвращает ошибку, называющую неразрешённые записи. {/* min-version: 2.1.208 */}До версии 2.1.208 этот subagent запускался без инструментов и мог вернуть пустой или запутанный результат.

367 

366Оба поля принимают паттерны уровня MCP сервера в дополнение к точным названиям инструментов: `mcp__<server>` или `mcp__<server>__*` предоставляет или удаляет каждый инструмент из названного сервера. В `disallowedTools`, `mcp__*` также удаляет каждый MCP инструмент из любого сервера. Этот пример удаляет каждый инструмент из MCP сервера `github`, сохраняя инструменты из других серверов и каждый встроенный инструмент:368Оба поля принимают паттерны уровня MCP сервера в дополнение к точным названиям инструментов: `mcp__<server>` или `mcp__<server>__*` предоставляет или удаляет каждый инструмент из названного сервера. В `disallowedTools`, `mcp__*` также удаляет каждый MCP инструмент из любого сервера. Этот пример удаляет каждый инструмент из MCP сервера `github`, сохраняя инструменты из других серверов и каждый встроенный инструмент:

367 369 

368```yaml theme={null}370```yaml theme={null}


456Поле `permissionMode` контролирует, как subagent обрабатывает запросы разрешений. Subagents наследуют контекст разрешений из основного разговора и могут переопределить режим, кроме случаев, когда режим родителя имеет приоритет, как описано ниже.458Поле `permissionMode` контролирует, как subagent обрабатывает запросы разрешений. Subagents наследуют контекст разрешений из основного разговора и могут переопределить режим, кроме случаев, когда режим родителя имеет приоритет, как описано ниже.

457 459 

458| Mode | Behavior |460| Mode | Behavior |

459| :------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------- |461| :------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

460| `default` | Стандартная проверка разрешений с запросами |462| `default` | Стандартная проверка разрешений с запросами |

461| `acceptEdits` | Автоматически принимать редактирование файлов и общие команды файловой системы для путей в рабочей директории или `additionalDirectories` |463| `acceptEdits` | Автоматически принимать редактирование файлов и общие команды файловой системы для путей в рабочей директории или `additionalDirectories` |

462| `auto` | [Auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode): классификатор AI оценивает каждый вызов инструмента и записи в защищённые директории |464| `auto` | [Auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode): классификатор AI оценивает каждый вызов инструмента и записи в защищённые директории |

463| `dontAsk` | Автоматически отклонять запросы разрешений (явно разрешённые инструменты по-прежнему работают) |465| `dontAsk` | Автоматически отклонять запросы разрешений. Явно разрешённые инструменты по-прежнему работают; `AskUserQuestion`, инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и MCP инструменты, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), отклоняются, даже если вы их разрешили |

464| `bypassPermissions` | Пропустить все проверки разрешений |466| `bypassPermissions` | Пропустить все проверки разрешений |

465| `plan` | Режим плана (исследование только для чтения) |467| `plan` | Режим плана (исследование только для чтения) |

466 468 

467<Warning>469<Warning>

468 Используйте `bypassPermissions` с осторожностью. Это пропускает все проверки разрешений, позволяя subagent выполнять любую операцию без одобрения, включая записи в `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` и `.mvn`. Явные правила [`ask`](/ru/permissions#manage-permissions) и удаления корневого и домашнего каталога, такие как `rm -rf /`, по-прежнему требуют подтверждения. См. [permission modes](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) для деталей.470 Используйте `bypassPermissions` с осторожностью. Это пропускает все проверки разрешений, позволяя subagent выполнять любую операцию без одобрения, включая записи в `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` и `.mvn`.

471 

472 Явные правила [`ask`](/ru/permissions#manage-permissions), инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools), MCP инструменты, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), и удаления корневого и домашнего каталога, такие как `rm -rf /`, по-прежнему требуют подтверждения. См. [permission modes](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) для деталей.

469</Warning>473</Warning>

470 474 

471Если родитель использует `bypassPermissions` или `acceptEdits`, это имеет приоритет и не может быть переопределено. Если родитель использует [auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode), subagent наследует auto mode и любой `permissionMode` в его frontmatter игнорируется: классификатор оценивает вызовы инструментов subagent с теми же правилами блокировки и разрешения, что и родительская сессия.475Если родитель использует `bypassPermissions` или `acceptEdits`, это имеет приоритет и не может быть переопределено. Если родитель использует [auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode), subagent наследует auto mode и любой `permissionMode` в его frontmatter игнорируется: классификатор оценивает вызовы инструментов subagent с теми же правилами блокировки и разрешения, что и родительская сессия.


786* Попросите Claude запустить задачу в фоне или в переднем плане790* Попросите Claude запустить задачу в фоне или в переднем плане

787* Нажмите **Ctrl+B** для фонового выполнения работающей задачи791* Нажмите **Ctrl+B** для фонового выполнения работающей задачи

788 792 

793{/* min-version: 2.1.208 */}Фоновый subagent, который завершается, остаётся в списке [`/tasks`](/ru/commands), отмечен как выполненный и отсортирован ниже работающих задач, пока сессия не очистит список задач. Его представление деталей остаётся открытым, когда subagent завершается. Subagents, которые не удаются или которые вы остановили, покидают список. До v2.1.208 завершённый subagent покидал список в момент завершения и его представление деталей закрывалось.

794 

789Чтобы отключить всю функциональность фоновых задач, установите переменную окружения `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` на `1`. См. [Environment variables](/ru/env-vars).795Чтобы отключить всю функциональность фоновых задач, установите переменную окружения `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` на `1`. См. [Environment variables](/ru/env-vars).

790 796 

791Когда [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) установлена на `1`, каждый spawn subagent работает в фоне и поле frontmatter `background` не имеет эффекта, потому что режим fork удаляет параметр `run_in_background` из инструмента `Agent`. `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` имеет приоритет над режимом fork и сохраняет spawns subagent в переднем плане.797Когда [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) установлена на `1`, каждый spawn subagent работает в фоне и поле frontmatter `background` не имеет эффекта, потому что режим fork удаляет параметр `run_in_background` из инструмента `Agent`. `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` имеет приоритет над режимом fork и сохраняет spawns subagent в переднем плане.


899* **CLAUDE.md and memory**: каждый уровень [иерархии памяти](/ru/memory#how-claude-md-files-load), который загружает основной разговор, включая `~/.claude/CLAUDE.md`, правила проекта, `CLAUDE.local.md` и управляемые файлы политики. Встроенные агенты Explore и Plan пропускают это.905* **CLAUDE.md and memory**: каждый уровень [иерархии памяти](/ru/memory#how-claude-md-files-load), который загружает основной разговор, включая `~/.claude/CLAUDE.md`, правила проекта, `CLAUDE.local.md` и управляемые файлы политики. Встроенные агенты Explore и Plan пропускают это.

900* **Git status**: снимок, сделанный в начале родительской сессии. Отсутствует, когда рабочая директория не является Git репозиторием или когда [`includeGitInstructions`](/ru/settings#available-settings) имеет значение `false`. Explore и Plan пропускают это независимо.906* **Git status**: снимок, сделанный в начале родительской сессии. Отсутствует, когда рабочая директория не является Git репозиторием или когда [`includeGitInstructions`](/ru/settings#available-settings) имеет значение `false`. Explore и Plan пропускают это независимо.

901* **Preloaded skills**: полное содержание любого навыка, названного в поле [`skills`](#preload-skills-into-subagents) агента. Встроенные агенты не предзагружают навыки.907* **Preloaded skills**: полное содержание любого навыка, названного в поле [`skills`](#preload-skills-into-subagents) агента. Встроенные агенты не предзагружают навыки.

908* **Sibling roster**: системное напоминание, в котором перечислены `main` и каждый другой именованный агент в сессии, каждый является допустимым значением `to` для [`SendMessage`](#resume-subagents). {/* min-version: 2.1.206 */}Требует Claude Code v2.1.206 или позже. Реестр появляется только когда инструменты subagent включают `SendMessage` и по крайней мере один другой агент имеет имя, независимо от того, назвал ли его Claude при порождении или он работает как товарищ [agent team](/ru/agent-teams). Это снимок, сделанный при запуске subagent, поэтому агенты, названные позже, не появляются.

902 909 

903Explore и Plan — единственные subagents, которые опускают CLAUDE.md и git status. Нет поля frontmatter или параметра per-agent для изменения того, какие агенты их пропускают.910Explore и Plan — единственные subagents, которые опускают CLAUDE.md и git status. Нет поля frontmatter или параметра per-agent для изменения того, какие агенты их пропускают.

904 911 

Details

202* [Google Cloud's Agent Platform](/ru/google-vertex-ai)202* [Google Cloud's Agent Platform](/ru/google-vertex-ai)

203* [Microsoft Foundry](/ru/microsoft-foundry)203* [Microsoft Foundry](/ru/microsoft-foundry)

204 204 

205Для Amazon Bedrock и Google Vertex AI вы также можете запустить `claude` и выбрать **3rd-party platform** в приглашении входа для запуска интерактивного мастера настройки.

206 

205<h2 id="configure-proxies-and-gateways">207<h2 id="configure-proxies-and-gateways">

206 Настройка прокси и шлюзов208 Настройка прокси и шлюзов

207</h2>209</h2>


209Большинство организаций могут использовать поставщика облачных услуг напрямую без дополнительной конфигурации. Однако вам может потребоваться настроить корпоративный прокси или шлюз LLM, если ваша организация имеет специфические требования к сети или управлению. Это разные конфигурации, которые можно использовать вместе:211Большинство организаций могут использовать поставщика облачных услуг напрямую без дополнительной конфигурации. Однако вам может потребоваться настроить корпоративный прокси или шлюз LLM, если ваша организация имеет специфические требования к сети или управлению. Это разные конфигурации, которые можно использовать вместе:

210 212 

211* **Корпоративный прокси**: маршрутизирует трафик через прокси HTTP/HTTPS. Используйте это, если ваша организация требует, чтобы весь исходящий трафик проходил через прокси-сервер для мониторинга безопасности, соответствия требованиям или обеспечения политики сети. Настройте с помощью переменных окружения `HTTPS_PROXY` или `HTTP_PROXY`. Узнайте больше в разделе [Конфигурация корпоративной сети](/ru/network-config).213* **Корпоративный прокси**: маршрутизирует трафик через прокси HTTP/HTTPS. Используйте это, если ваша организация требует, чтобы весь исходящий трафик проходил через прокси-сервер для мониторинга безопасности, соответствия требованиям или обеспечения политики сети. Настройте с помощью переменных окружения `HTTPS_PROXY` или `HTTP_PROXY`. Узнайте больше в разделе [Конфигурация корпоративной сети](/ru/network-config).

212* **Шлюз LLM**: сервис, который находится между Claude Code и поставщиком облачных услуг для обработки аутентификации и маршрутизации. Используйте это, если вам нужно централизованное отслеживание использования между командами, пользовательское ограничение скорости или бюджеты, или централизованное управление аутентификацией. Настройте с помощью переменных окружения `ANTHROPIC_BASE_URL`, `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_AWS_BASE_URL` или `ANTHROPIC_VERTEX_BASE_URL`. Узнайте больше в разделе [Шлюзы LLM](/ru/llm-gateway).214* **Шлюз LLM**: сервис, который находится между Claude Code и поставщиком облачных услуг для обработки аутентификации и маршрутизации. Используйте это, если вам нужно централизованное отслеживание использования между командами, пользовательское ограничение скорости или бюджеты, или централизованное управление аутентификацией. Настройте с помощью переменных окружения `ANTHROPIC_BASE_URL`, `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_AWS_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_FOUNDRY_BASE_URL`. Узнайте больше в разделе [Шлюзы LLM](/ru/llm-gateway).

213 215 

214Следующие примеры показывают переменные окружения для установки в вашей оболочке или профиле оболочки (`.bashrc`, `.zshrc`). См. раздел [Параметры](/ru/settings) для других методов конфигурации.216Следующие примеры показывают переменные окружения для установки в вашей оболочке или профиле оболочки (`.bashrc`, `.zshrc`). См. раздел [Параметры](/ru/settings) для других методов конфигурации.

215 217 


314</Tabs>316</Tabs>

315 317 

316<Tip>318<Tip>

317 Используйте `/status` в Claude Code для проверки того, что конфигурация прокси и шлюза применена правильно.319 Используйте `/status` в Claude Code для проверки того, что конфигурация прокси и шлюза применена правильно. Например, с конфигурацией шлюза Bedrock выше, вывод включает строки вроде:

320 

321 ```

322 API provider: Amazon Bedrock

323 Bedrock base URL: https://your-llm-gateway.com/bedrock

324 AWS region: us-east-1

325 AWS auth skipped

326 ```

327 

328 Если вы настроили корпоративный прокси, `/status` также показывает строку `Proxy` с URL вашего прокси.

318</Tip>329</Tip>

319 330 

320<h2 id="best-practices-for-organizations">331<h2 id="best-practices-for-organizations">


327 338 

328Мы настоятельно рекомендуем инвестировать в документацию, чтобы Claude Code понимал вашу кодовую базу. Организации могут развертывать файлы CLAUDE.md на нескольких уровнях:339Мы настоятельно рекомендуем инвестировать в документацию, чтобы Claude Code понимал вашу кодовую базу. Организации могут развертывать файлы CLAUDE.md на нескольких уровнях:

329 340 

330* **На уровне организации**: развертывайте в системные каталоги, такие как `/Library/Application Support/ClaudeCode/CLAUDE.md` (macOS) для стандартов компании341* **На уровне организации**: развертывайте в системные каталоги, такие как `/Library/Application Support/ClaudeCode/CLAUDE.md` (macOS), `/etc/claude-code/CLAUDE.md` (Linux и WSL) или `C:\Program Files\ClaudeCode\CLAUDE.md` (Windows) для стандартов компании

331* **На уровне репозитория**: создавайте файлы `CLAUDE.md` в корнях репозиториев, содержащие архитектуру проекта, команды сборки и рекомендации по внесению вклада. Проверяйте их в систему контроля версий, чтобы все пользователи получали выгоду342* **На уровне репозитория**: создавайте файлы `CLAUDE.md` в корнях репозиториев, содержащие архитектуру проекта, команды сборки и рекомендации по внесению вклада. Проверяйте их в систему контроля версий, чтобы все пользователи получали выгоду

332 343 

333Узнайте больше в разделе [Память и файлы CLAUDE.md](/ru/memory).344Узнайте больше в разделе [Память и файлы CLAUDE.md](/ru/memory).

Details

15| Инструмент | Описание | Требуется разрешение |15| Инструмент | Описание | Требуется разрешение |

16| :--------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |16| :--------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |

17| `Agent` | Создает [subagent](/ru/sub-agents) с собственным контекстным окном для выполнения задачи. См. [поведение инструмента Agent](#agent-tool-behavior) | Нет |17| `Agent` | Создает [subagent](/ru/sub-agents) с собственным контекстным окном для выполнения задачи. См. [поведение инструмента Agent](#agent-tool-behavior) | Нет |

18| `Artifact` | Публикует HTML или Markdown файл как [artifact](/ru/artifacts): приватную интерактивную страницу на claude.ai. На планах Team и Enterprise вы можете делиться ею внутри вашей организации. {/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Требует план Pro, Max, Team или Enterprise и аутентификацию `/login`; см. [Доступность](/ru/artifacts#availability) | Да |18| `Artifact` | Публикует HTML или Markdown файл как [artifact](/ru/artifacts): приватную интерактивную страницу на claude.ai. Вы можете делиться ею с помощью публичной ссылки или внутри вашей организации на планах Team и Enterprise, где публичный доступ требует, чтобы владелец [включил его](/ru/artifacts#control-public-sharing). {/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Требует план Pro, Max, Team или Enterprise и аутентификацию `/login`; см. [Доступность](/ru/artifacts#availability) | Да |

19| `AskUserQuestion` | Задает вопросы с несколькими вариантами ответов для сбора требований или уточнения неоднозначности. {/* min-version: 2.1.200 */}Вопросы остаются открытыми до тех пор, пока вы на них не ответите: по умолчанию нет тайм-аута неактивности. Чтобы диалог с неактивностью продолжался автоматически, установите параметр [`askUserQuestionTimeout`](/ru/settings#available-settings) на `60s`, `5m` или `10m` либо в вашем пользовательском `settings.json`, либо из строки **Question auto-continue timeout** в `/config`. После истечения выбранного времени неактивности без ввода диалог закроется самостоятельно: он отправит все уже выбранные вами параметры и сообщит Claude, что вы можете быть вдали от клавиатуры, поэтому Claude действует по собственному суждению и может переспросить позже. Обратный отсчет появляется в течение последних 20 секунд. Любое нажатие клавиши перезапускает таймер, как и сфокусированное окно на терминалах, которые сообщают о фокусе. Тайм-аут применяется только к вопросам с несколькими вариантами ответов `AskUserQuestion`; подсказки разрешений, включая одобрение плана, никогда не разрешаются автоматически при неактивности. В версиях 2.1.198 и 2.1.199 диалог автоматически продолжался после 60 секунд неактивности по умолчанию, и [`CLAUDE_AFK_TIMEOUT_MS`](/ru/env-vars#variables) был единственным способом изменить это | Нет |19| `AskUserQuestion` | Задает вопросы с несколькими вариантами ответов для сбора требований или уточнения неоднозначности. {/* min-version: 2.1.200 */}Вопросы остаются открытыми до тех пор, пока вы на них не ответите: по умолчанию нет тайм-аута неактивности. Чтобы диалог с неактивностью продолжался автоматически, установите параметр [`askUserQuestionTimeout`](/ru/settings#available-settings) на `60s`, `5m` или `10m` либо в вашем пользовательском `settings.json`, либо из строки **Question auto-continue timeout** в `/config`. После истечения выбранного времени неактивности без ввода диалог закроется самостоятельно: он отправит все уже выбранные вами параметры и сообщит Claude, что вы можете быть вдали от клавиатуры, поэтому Claude действует по собственному суждению и может переспросить позже. Обратный отсчет появляется в течение последних 20 секунд. Любое нажатие клавиши перезапускает таймер, как и сфокусированное окно на терминалах, которые сообщают о фокусе. Тайм-аут применяется только к вопросам с несколькими вариантами ответов `AskUserQuestion`; подсказки разрешений, включая одобрение плана, никогда не разрешаются автоматически при неактивности. В версиях 2.1.198 и 2.1.199 диалог автоматически продолжался после 60 секунд неактивности по умолчанию, и [`CLAUDE_AFK_TIMEOUT_MS`](/ru/env-vars#variables) был единственным способом изменить это | Нет |

20| `Bash` | Выполняет команды оболочки в вашей среде. См. [поведение инструмента Bash](#bash-tool-behavior) | Да |20| `Bash` | Выполняет команды оболочки в вашей среде. См. [поведение инструмента Bash](#bash-tool-behavior) | Да |

21| `CronCreate` | Планирует повторяющуюся или одноразовую подсказку в текущем сеансе. Задачи привязаны к сеансу и восстанавливаются при `--resume` или `--continue`, если не истекли. См. [запланированные задачи](/ru/scheduled-tasks) | Нет |21| `CronCreate` | Планирует повторяющуюся или одноразовую подсказку в текущем сеансе. Задачи привязаны к сеансу и восстанавливаются при `--resume` или `--continue`, если не истекли. См. [запланированные задачи](/ru/scheduled-tasks) | Нет |


23| `CronList` | Выводит список всех запланированных задач в сеансе | Нет |23| `CronList` | Выводит список всех запланированных задач в сеансе | Нет |

24| `Edit` | Вносит целевые изменения в конкретные файлы. См. [поведение инструмента Edit](#edit-tool-behavior) | Да |24| `Edit` | Вносит целевые изменения в конкретные файлы. См. [поведение инструмента Edit](#edit-tool-behavior) | Да |

25| `EnterPlanMode` | Переключается в режим плана для разработки подхода перед кодированием | Нет |25| `EnterPlanMode` | Переключается в режим плана для разработки подхода перед кодированием | Нет |

26| `EnterWorktree` | Создает изолированный [git worktree](/ru/worktrees) и переключается в него. Передайте `path` для переключения в существующий worktree вместо создания нового. {/* min-version: 2.1.203 */}При первом входе целевой путь может быть worktree текущего репозитория или, в многорепозиторном рабочем пространстве, репозитория, вложенного в него. До версии 2.1.203 worktree вложенного репозитория был отклонен. Из сеанса worktree или из subagent с закрепленным рабочим каталогом, например [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields), доступна только форма `path`, и целевой путь должен находиться под `.claude/worktrees/` репозитория сеанса | Нет |26| `EnterWorktree` | Создает изолированный [git worktree](/ru/worktrees) и переключается в него. Передайте `path` для переключения в существующий worktree вместо создания нового. {/* min-version: 2.1.203 */}При первом входе целевой путь может быть worktree текущего репозитория или, в многорепозиторном рабочем пространстве, репозитория, вложенного в него. До версии 2.1.203 worktree вложенного репозитория был отклонен. {/* min-version: 2.1.206 */}Путь `path` вне `.claude/worktrees/` запрашивает ваше одобрение перед входом, так как он перемещает рабочий каталог сеанса и доступ на запись в это место. Создание новых worktrees и пути под `.claude/worktrees/` не запрашивают разрешение. До версии 2.1.206 Claude входил в пути вне `.claude/worktrees/` без запроса. Из сеанса worktree или из subagent с закрепленным рабочим каталогом, например [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields), доступна только форма `path`, и целевой путь должен находиться под `.claude/worktrees/` репозитория сеанса | Да |

27| `ExitPlanMode` | Представляет план для утверждения и выходит из режима плана | Да |27| `ExitPlanMode` | Представляет план для утверждения и выходит из режима плана | Да |

28| `ExitWorktree` | Выходит из сеанса worktree и возвращается в исходный каталог. Недоступно для subagents, которые уже работают в собственном рабочем каталоге, например с [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields) | Нет |28| `ExitWorktree` | Выходит из сеанса worktree и возвращается в исходный каталог. Недоступно для subagents, которые уже работают в собственном рабочем каталоге, например с [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields) | Нет |

29| `Glob` | Находит файлы на основе сопоставления шаблонов. См. [поведение инструмента Glob](#glob-tool-behavior) | Нет |29| `Glob` | Находит файлы на основе сопоставления шаблонов. См. [поведение инструмента Glob](#glob-tool-behavior) | Нет |


38| `ReadMcpResourceTool` | Читает конкретный ресурс MCP по URI | Нет |38| `ReadMcpResourceTool` | Читает конкретный ресурс MCP по URI | Нет |

39| `RemoteTrigger` | Создает, обновляет, запускает и выводит список [Routines](/ru/routines) на claude.ai. Поддерживает команду `/schedule`. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines находятся на claude.ai и требуют план Pro, Max, Team или Enterprise, поэтому этот инструмент недоступен из Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry | Нет |39| `RemoteTrigger` | Создает, обновляет, запускает и выводит список [Routines](/ru/routines) на claude.ai. Поддерживает команду `/schedule`. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines находятся на claude.ai и требуют план Pro, Max, Team или Enterprise, поэтому этот инструмент недоступен из Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry | Нет |

40| `ReportFindings` | Сообщает о результатах проверки кода как структурированный список с файлом, резюме и сценарием сбоя для каждого результата, чтобы Claude Code мог их отобразить вместо вывода в виде текста. Claude вызывает его, когда активные инструкции проверки кода говорят ему это сделать. {/* min-version: 2.1.196 */}Требует Claude Code v2.1.196 или позже. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, результат также может содержать необязательный слаг `category`, такой как `correctness` или `test-coverage`, показанный рядом с расположением файла в отображаемом списке | Нет |40| `ReportFindings` | Сообщает о результатах проверки кода как структурированный список с файлом, резюме и сценарием сбоя для каждого результата, чтобы Claude Code мог их отобразить вместо вывода в виде текста. Claude вызывает его, когда активные инструкции проверки кода говорят ему это сделать. {/* min-version: 2.1.196 */}Требует Claude Code v2.1.196 или позже. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, результат также может содержать необязательный слаг `category`, такой как `correctness` или `test-coverage`, показанный рядом с расположением файла в отображаемом списке | Нет |

41| `ScheduleWakeup` | Переносит следующую итерацию [самостоятельного `/loop`](/ru/scheduled-tasks#let-claude-choose-the-interval). Claude вызывает это в конце каждой итерации, чтобы выбрать, когда запустится следующая, между одной минутой и одним часом; вы не вызываете это напрямую. Чтобы вместо этого завершить цикл, Claude вызывает его с `stop: true`, что отменяет ожидающее пробуждение. {/* min-version: 2.1.202 */}Поле `stop` требует Claude Code v2.1.202 или позже. Ожидающее пробуждение появляется в `session_crons` в [входе Stop hook](/ru/hooks#stop-input). {/* plan-availability: feature=loop-dynamic providers=anthropic */}Недоступно на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, где `/loop` подсказка без интервала работает по фиксированному расписанию | Нет |41| `ScheduleWakeup` | Переносит следующую итерацию [самостоятельного `/loop`](/ru/scheduled-tasks#let-claude-choose-the-interval). Claude вызывает это в конце каждой итерации, чтобы выбрать, когда запустится следующая, между одной минутой и одним часом; вы не вызываете это напрямую. Чтобы вместо этого завершить цикл, Claude вызывает его с `stop: true`, что отменяет ожидающее пробуждение. {/* min-version: 2.1.202 */}Поле `stop` требует Claude Code v2.1.202 или позже. Ожидающее пробуждение появляется в `session_crons` в [входе Stop hook](/ru/hooks#stop-input). {/* plan-availability: feature=loop-dynamic providers=anthropic */}Недоступно на Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform или Microsoft Foundry, где `/loop` подсказка без интервала работает по фиксированному расписанию | Нет |

42| `SendMessage` | Отправляет сообщение члену [команды агентов](/ru/agent-teams), или [возобновляет subagent](/ru/sub-agents#resume-subagents) по его ID агента или имени. Завершенные subagents автоматически возобновляются в фоне; subagent, который вы остановили из `/tasks`, не возобновляется, и вызов возвращает отказ. Структурированные сообщения протокола команды требуют команды агентов. Получатель никогда не рассматривает сообщение от другого агента как ваше согласие или одобрение. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, subagent рассматривает сообщение от агента, который его запустил, как обычное направление задачи, а не как запрос от коллеги. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, отправка на имя, которое теперь разрешается в другого агента, чем раньше в разговоре, отклоняется вместо доставки; см. [Возобновление subagents](/ru/sub-agents#resume-subagents) | Нет |42| `SendMessage` | Отправляет сообщение члену [команды агентов](/ru/agent-teams), или [возобновляет subagent](/ru/sub-agents#resume-subagents) по его ID агента или имени. Завершенные subagents автоматически возобновляются в фоне; subagent, который вы остановили из `/tasks`, не возобновляется, и вызов возвращает отказ. Структурированные сообщения протокола команды требуют команды агентов. Получатель никогда не рассматривает сообщение от другого агента как ваше согласие или одобрение. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, subagent рассматривает сообщение от агента, который его запустил, как обычное направление задачи, а не как запрос от коллеги. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, отправка на имя, которое теперь разрешается в другого агента, чем раньше в разговоре, отклоняется вместо доставки; см. [Возобновление subagents](/ru/sub-agents#resume-subagents) | Нет |

43| `SendUserFile` | Отправляет файлы из сеанса вам с необязательной подписью, чтобы созданный отчет, диаграмма, снимок экрана или построенный артефакт достигли вашего устройства вместо того, чтобы только упоминаться в стенограмме. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, необязательный ввод `display` управляет представлением: `render` открывает файл встроенным образом в клиенте, `attach` показывает только карточку загрузки, и когда не установлено, клиент решает по типу файла. Доступно при подключении клиента [Remote Control](/ru/remote-control) или когда сеанс работает в управляемой облачной среде, такой как [Claude Code в веб-версии](/ru/claude-code-on-the-web). Доставка осуществляется через инфраструктуру, размещенную на Anthropic, поэтому инструмент недоступен на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry | Нет |43| `SendUserFile` | Отправляет файлы из сеанса вам с необязательной подписью, чтобы созданный отчет, диаграмма, снимок экрана или построенный артефакт достигли вашего устройства вместо того, чтобы только упоминаться в стенограмме. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, необязательный ввод `display` управляет представлением: `render` открывает файл встроенным образом в клиенте, `attach` показывает только карточку загрузки, и когда не установлено, клиент решает по типу файла. Доступно при подключении клиента [Remote Control](/ru/remote-control) или когда сеанс работает в управляемой облачной среде, такой как [Claude Code в веб-версии](/ru/claude-code-on-the-web). Доставка осуществляется через инфраструктуру, размещенную на Anthropic, поэтому инструмент недоступен на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry | Нет |

44| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Загружает `ONBOARDING.md` и возвращает ссылку для общего доступа, которую товарищи по команде могут открыть в Claude Code. Вызывается из `/team-onboarding` после написания руководства. Доступно для подписчиков claude.ai на планах Pro, Max, Team и Enterprise | Да |44| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Загружает `ONBOARDING.md` и возвращает ссылку для общего доступа, которую товарищи по команде могут открыть в Claude Code. Вызывается из `/team-onboarding` после написания руководства. Доступно для подписчиков claude.ai на планах Pro, Max, Team и Enterprise | Да |


85 85 

86Инструменты, не указанные здесь, такие как `ExitPlanMode` или `ShareOnboardingGuide`, принимают только простое имя инструмента без спецификатора.86Инструменты, не указанные здесь, такие как `ExitPlanMode` или `ShareOnboardingGuide`, принимают только простое имя инструмента без спецификатора.

87 87 

88Правило разрешения `Edit(...)` также предоставляет доступ на чтение к тому же пути, поэтому вам не нужно соответствующее правило `Read(...)`.88Правило разрешения `Edit(...)` также предоставляет доступ на чтение к тому же пути, поэтому вам не нужно соответствующее правило `Read(...)`. Правило запрета `Read(...)` также блокирует инструмент Edit на том же пути, включая создание нового файла там, потому что редактирование требует чтения результата обратно. Проверка запрета `Read` при редактировании требует Claude Code v2.1.208 или более поздней версии.

89 89 

90Поля `matcher` Hook используют простые названия инструментов, а не формат с скобками. См. [шаблоны сопоставления](/ru/hooks#matcher-patterns) для правил сопоставления. Для названий полей, которые каждый инструмент передает в `tool_input` в hooks, см. [справочник входных данных PreToolUse](/ru/hooks#pretooluse-input).90Поля `matcher` Hook используют простые названия инструментов, а не формат с скобками. См. [шаблоны сопоставления](/ru/hooks#matcher-patterns) для правил сопоставления. Для названий полей, которые каждый инструмент передает в `tool_input` в hooks, см. [справочник входных данных PreToolUse](/ru/hooks#pretooluse-input).

91 91 


106* **Только `disallowedTools`**: subagent получает каждый инструмент родителя, кроме перечисленных.106* **Только `disallowedTools`**: subagent получает каждый инструмент родителя, кроме перечисленных.

107* **Оба установлены**: `disallowedTools` имеет приоритет. Инструмент, указанный в обоих, удаляется.107* **Оба установлены**: `disallowedTools` имеет приоритет. Инструмент, указанный в обоих, удаляется.

108 108 

109Когда список `tools` subagent разрешается в отсутствие инструментов вообще, например, потому что каждая запись содержит опечатку или называет инструмент, который недоступен для subagents, инструмент Agent возвращает ошибку, перечисляющую эти записи, вместо запуска subagent. {/* min-version: 2.1.208 */}До версии 2.1.208 subagent запускался без инструментов и мог вернуть пустой или запутанный результат.

110 

109Запуск subagent сам по себе не запрашивает разрешение. Claude Code проверяет вызовы инструментов subagent против ваших правил разрешений по мере его работы.111Запуск subagent сам по себе не запрашивает разрешение. Claude Code проверяет вызовы инструментов subagent против ваших правил разрешений по мере его работы.

110 112 

111{/* min-version: 2.1.198 */}Начиная с версии 2.1.198, subagents работают в фоне по умолчанию; Claude запускает один на переднем плане, когда ему нужен результат перед продолжением.113{/* min-version: 2.1.198 */}Начиная с версии 2.1.198, subagents работают в фоне по умолчанию; Claude запускает один на переднем плане, когда ему нужен результат перед продолжением.


134* **Timeout**: два минуты по умолчанию. Claude может запросить до 10 минут на команду с параметром `timeout`. Переопределите значение по умолчанию и потолок с помощью [`BASH_DEFAULT_TIMEOUT_MS` и `BASH_MAX_TIMEOUT_MS`](/ru/env-vars).136* **Timeout**: два минуты по умолчанию. Claude может запросить до 10 минут на команду с параметром `timeout`. Переопределите значение по умолчанию и потолок с помощью [`BASH_DEFAULT_TIMEOUT_MS` и `BASH_MAX_TIMEOUT_MS`](/ru/env-vars).

135* **Длина вывода**: 30 000 символов по умолчанию. Когда команда производит больше, Claude Code сохраняет полный вывод в файл в каталоге сеанса и дает Claude путь к файлу плюс короткий предпросмотр с начала. Claude читает или ищет этот файл, когда ему нужен остаток. Увеличьте лимит с помощью [`BASH_MAX_OUTPUT_LENGTH`](/ru/env-vars), до жесткого потолка в 150 000 символов.137* **Длина вывода**: 30 000 символов по умолчанию. Когда команда производит больше, Claude Code сохраняет полный вывод в файл в каталоге сеанса и дает Claude путь к файлу плюс короткий предпросмотр с начала. Claude читает или ищет этот файл, когда ему нужен остаток. Увеличьте лимит с помощью [`BASH_MAX_OUTPUT_LENGTH`](/ru/env-vars), до жесткого потолка в 150 000 символов.

136 138 

137Для долгоживущих процессов, таких как dev серверы или watch сборки, Claude может установить `run_in_background: true` для запуска команды как фоновой задачи и продолжения работы во время ее выполнения. Выводите список и останавливайте фоновые задачи с помощью `/tasks`.139Для долгоживущих процессов, таких как dev серверы или watch сборки, Claude может установить `run_in_background: true` для запуска команды как фоновой задачи и продолжения работы во время ее выполнения. Выводите список и останавливайте фоновые задачи с помощью `/tasks`. В неинтерактивном режиме с флагом `-p` [фоновые задачи завершаются вскоре после окончательного результата запуска](/ru/headless#background-tasks-at-exit).

138 140 

139<h2 id="edit-tool-behavior">141<h2 id="edit-tool-behavior">

140 Поведение инструмента Edit142 Поведение инструмента Edit


142 144 

143Инструмент Edit выполняет точную замену строк. Он принимает `old_string` и `new_string` и заменяет первый на второй. Он не использует regex или нечеткое сопоставление.145Инструмент Edit выполняет точную замену строк. Он принимает `old_string` и `new_string` и заменяет первый на второй. Он не использует regex или нечеткое сопоставление.

144 146 

145Три проверки должны пройти для применения редактирования:147Три проверки должны пройти для применения редактирования. {/* min-version: 2.1.208 */}Перед любой из них путь, соответствующий [правилу deny `Read`](/ru/permissions#tool-specific-permission-rules), отклоняется, включая создание нового файла там. Отклонение требует Claude Code v2.1.208 или позже.

146 148 

147* **Read-before-edit**: Claude должен был прочитать файл в текущем разговоре, и файл не должен был измениться на диске с момента этого чтения. Эта проверка выполняется первой, перед любым сопоставлением строк.149* **Read-before-edit**: Claude читает файл в текущем разговоре перед редактированием, и файл, прочитанный с уведомлением [`PARTIAL view`](#read-tool-behavior), не считается. Claude Opus 4.6, Claude Haiku 4.5 и более старые модели всегда требуют чтение. Более новые модели могут редактировать непрочитанный файл при чтении, когда чтение не требует запроса разрешения и инструмент Read доступен.

148* **Match**: `old_string` должен появиться в файле точно так, как написано. Даже один символ пробела или различия в отступе достаточно, чтобы пропустить.150* **Match**: `old_string` должен появиться в файле точно так, как написано. Даже один символ пробела или различия в отступе достаточно, чтобы пропустить.

149* **Uniqueness**: `old_string` должен появиться ровно один раз. Когда он появляется более одного раза, Claude либо предоставляет более длинную строку с достаточным окружающим контекстом для определения одного вхождения, либо устанавливает `replace_all: true` для замены всех.151* **Uniqueness**: `old_string` должен появиться ровно один раз. Когда он появляется более одного раза, Claude либо предоставляет более длинную строку с достаточным окружающим контекстом для определения одного вхождения, либо устанавливает `replace_all: true` для замены всех.

150 152 

151Просмотр файла с помощью Bash также удовлетворяет требованию read-before-edit, когда команда это `cat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep` или `fgrep` на одном файле без pipes или redirects. Piped вывод и другие команды Bash не считаются, и Claude должен использовать Read перед редактированием в этих случаях.153Файл, который изменился на диске после последнего чтения Claude, все еще может быть отредактирован, когда `old_string` точно и однозначно совпадает с текущим содержимым и Claude Code может прочитать файл без запроса. Сопоставление с текущим содержимым файла обеспечивает безопасность, и результат отмечает, что файл содержит другие изменения, поэтому Claude перечитывает его перед редактированиями, которые зависят от окружающего содержимого. В любом другом случае, например при устаревшем `old_string` или при совпадении более одного раза без `replace_all`, Claude читает файл снова перед редактированием. {/* min-version: 2.1.208 */}Расслабленная обработка непрочитанных и измененных файлов требует Claude Code v2.1.208 или позже; до этого Claude Code отклонял любое редактирование файла, который он не прочитал в разговоре или который изменился на диске после чтения.

154 

155Просмотр файла с помощью Bash также удовлетворяет требованию read-before-edit, когда команда — это `cat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep` или `fgrep` на одном файле без pipes или redirects. Piped вывод и другие команды Bash не считаются для проверки read-before-edit.

152 156 

153Это влияет только на приемлемость редактирования, а не на разрешения. [Правила deny Read и Edit](/ru/permissions#tool-specific-permission-rules) также применяются к командам файлов, которые Claude Code распознает в Bash, таким как `cat`, `head`, `tail`, `sed` и `grep`, но не к произвольным подпроцессам, которые косвенно читают или записывают файлы, такие как скрипт Python или Node, который открывает файлы сам. Набор команд, распознаваемых для правил deny, не совпадает со списком read-before-edit выше: например, `egrep` и `fgrep` считаются для read-before-edit, но не проверяются против правил deny Read. Для принудительного применения на уровне ОС, охватывающего каждый процесс, [включите sandbox](/ru/sandboxing).157Это влияет только на приемлемость редактирования, а не на разрешения. [Правила deny Read и Edit](/ru/permissions#tool-specific-permission-rules) также применяются к командам файлов, которые Claude Code распознает в Bash, таким как `cat`, `head`, `tail`, `sed` и `grep`, но не к произвольным подпроцессам, которые косвенно читают или записывают файлы, такие как скрипт Python или Node, который открывает файлы сам. Набор команд, распознаваемых для правил deny, не совпадает со списком read-before-edit выше: например, `egrep` и `fgrep` считаются для read-before-edit, но не проверяются против правил deny Read. Для принудительного применения на уровне ОС, охватывающего каждый процесс, [включите sandbox](/ru/sandboxing).

154 158 


166 170 

167Glob не соблюдает `.gitignore` по умолчанию, поэтому он находит файлы, игнорируемые git, наряду с отслеживаемыми. Это отличается от [Grep](#grep-tool-behavior), который пропускает файлы, игнорируемые git. Чтобы заставить Glob соблюдать `.gitignore`, установите `CLAUDE_CODE_GLOB_NO_IGNORE=false` перед запуском Claude Code.171Glob не соблюдает `.gitignore` по умолчанию, поэтому он находит файлы, игнорируемые git, наряду с отслеживаемыми. Это отличается от [Grep](#grep-tool-behavior), который пропускает файлы, игнорируемые git. Чтобы заставить Glob соблюдать `.gitignore`, установите `CLAUDE_CODE_GLOB_NO_IGNORE=false` перед запуском Claude Code.

168 172 

173Значение `pattern` или `path`, содержащее нулевой байт, возвращает ошибку с просьбой к Claude удалить его. {/* min-version: 2.1.208 */}

174 

169<h2 id="grep-tool-behavior">175<h2 id="grep-tool-behavior">

170 Поведение инструмента Grep176 Поведение инструмента Grep

171</h2>177</h2>


174 180 

175Grep построен на [ripgrep](https://github.com/BurntSushi/ripgrep) и использует синтаксис regex ripgrep, а не POSIX grep. Шаблоны, которые включают метасимволы regex, нуждаются в экранировании. Например, поиск `interface{}` в коде Go требует шаблона `interface\{\}`.181Grep построен на [ripgrep](https://github.com/BurntSushi/ripgrep) и использует синтаксис regex ripgrep, а не POSIX grep. Шаблоны, которые включают метасимволы regex, нуждаются в экранировании. Например, поиск `interface{}` в коде Go требует шаблона `interface\{\}`.

176 182 

183Шаблон, glob или тип файла, который ripgrep отклоняет, возвращает ошибку, которая включает диагностику ripgrep, поэтому Claude может исправить входные данные и выполнить поиск снова. {/* min-version: 2.1.208 */}До версии 2.1.208 Claude Code сообщал об отклоненном входе как `No files found` вместо ошибки, даже когда искомый текст существовал в целевых файлах.

184 

177Три режима вывода контролируют, что возвращается:185Три режима вывода контролируют, что возвращается:

178 186 

179* `files_with_matches`: только пути к файлам, без содержимого строк. Это значение по умолчанию.187* `files_with_matches`: только пути к файлам, без содержимого строк. Это значение по умолчанию.

180* `content`: соответствующие строки с номером файла и строки.188* `content`: соответствующие строки с номером файла и строки.

181* `count`: количество совпадений на файл.189* `count`: количество совпадений на файл, за которым следует общее количество совпадений во всех соответствующих файлах. {/* min-version: 2.1.208 */}Общее количество охватывает каждое совпадение, даже когда параметры `head_limit` или `offset` инструмента усекают перечисленные записи для каждого файла. До версии 2.1.208 общее количество суммировало только перечисленные записи.

182 190 

183Claude может ограничить результаты по файлу с параметром `glob`, таким как `**/*.tsx`, или по языку с параметром `type`, таким как `py` или `rust`. По умолчанию шаблоны совпадают в одной строке. Claude может установить `multiline: true` для совпадения через границы строк.191Claude может ограничить результаты по файлу с параметром `glob`, таким как `**/*.tsx`, или по языку с параметром `type`, таким как `py` или `rust`. По умолчанию шаблоны совпадают в одной строке. Claude может установить `multiline: true` для совпадения через границы строк.

184 192 


325 333 

326По умолчанию Read возвращает файл с начала. Когда чтение всего файла превышает лимит токенов, Read возвращает первую страницу с уведомлением `PARTIAL view`, которое сообщает Claude, какую часть файла он получил, и как читать дальше с помощью `offset` и `limit`. Чтение, которое передает явный `offset` или `limit` и все еще превышает лимит токенов, возвращает ошибку.334По умолчанию Read возвращает файл с начала. Когда чтение всего файла превышает лимит токенов, Read возвращает первую страницу с уведомлением `PARTIAL view`, которое сообщает Claude, какую часть файла он получил, и как читать дальше с помощью `offset` и `limit`. Чтение, которое передает явный `offset` или `limit` и все еще превышает лимит токенов, возвращает ошибку.

327 335 

336Чтение с явным `limit` останавливается, как только выбранные строки превышают то, что лимит токенов когда-либо мог вместить, и возвращает ошибку без загрузки остальной части диапазона. Ошибка сообщает Claude использовать меньший `limit`, или искать конкретное содержимое с помощью [Grep](#grep-tool-behavior) вместо этого, когда одна строка такая большая. {/* min-version: 2.1.208 */}До версии 2.1.208 Claude Code загружал весь диапазон в память перед его отклонением, поэтому файл с чрезвычайно длинной одной строкой мог исчерпать память.

337 

338Чтение пустого файла возвращает уведомление о том, что файл существует, но его содержимое пусто, и `offset` за последней строкой возвращает уведомление, дающее количество строк файла. {/* min-version: 2.1.208 */}До версии 2.1.208 чтение пустого файла возвращало уведомление о конце вместо этого.

339 

328Read обрабатывает несколько типов файлов помимо простого текста:340Read обрабатывает несколько типов файлов помимо простого текста:

329 341 

330* **Изображения**: PNG, JPG и другие форматы изображений возвращаются как визуальное содержимое, которое Claude может видеть, а не как необработанные байты. Claude Code изменяет размер и переупаковывает большие изображения, чтобы они соответствовали ограничениям размера изображения модели перед отправкой, поэтому Claude может видеть уменьшенную версию большого снимка экрана. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, изображение, которое все еще больше 500KB после этого изменения размера, переупаковывается как JPEG с пониженным качеством с неизменными размерами пикселей. Если Claude пропустит детали на уровне пикселей в большом изображении, попросите его сначала обрезать интересующий регион, например с помощью ImageMagick через Bash.342* **Изображения**: PNG, JPG и другие форматы изображений возвращаются как визуальное содержимое, которое Claude может видеть, а не как необработанные байты. Claude Code изменяет размер и переупаковывает большие изображения, чтобы они соответствовали ограничениям размера изображения модели перед отправкой, поэтому Claude может видеть уменьшенную версию большого снимка экрана. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, изображение, которое все еще больше 500KB после этого изменения размера, переупаковывается как JPEG с пониженным качеством с неизменными размерами пикселей. Если Claude пропустит детали на уровне пикселей в большом изображении, попросите его сначала обрезать интересующий регион, например с помощью ImageMagick через Bash.

Details

196 ls -la ~/.local/bin/claude196 ls -la ~/.local/bin/claude

197 ```197 ```

198 198 

199 Встроенная установка показывает символическую ссылку в `~/.local/share/claude/versions/`. Скрипт или символическая ссылка, которую вы создали сами в этом пути, — это пользовательский запускатель, который [автоматическое обновление оставляет на месте](/ru/setup#auto-updates).

200 

199 Если какая-либо команда `ls` выводит `No such file or directory`, это не ошибка. Это означает, что ничего не установлено в этом месте, поэтому переходите к следующей проверке.201 Если какая-либо команда `ls` выводит `No such file or directory`, это не ошибка. Это означает, что ничего не установлено в этом месте, поэтому переходите к следующей проверке.

200 202 

201 ```bash theme={null}203 ```bash theme={null}


447 ```449 ```

448 Попросите файл сертификата у вашей IT-команды, если у вас его нет. Вы также можете попробовать на прямом соединении, чтобы подтвердить, что прокси является причиной.450 Попросите файл сертификата у вашей IT-команды, если у вас его нет. Вы также можете попробовать на прямом соединении, чтобы подтвердить, что прокси является причиной.

449 451 

4504. **На Windows обойдите проверки отзыва сертификатов**, если вы видите `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` или `CRYPT_E_REVOCATION_OFFLINE (0x80092013)`. Они означают, что curl достиг сервера, но ваша сеть блокирует поиск отзыва сертификата, что распространено за корпоративными брандмауэрами. Добавьте `--ssl-revoke-best-effort` к команде установки:4524. **На Windows переключитесь на установщики, если ваша сеть блокирует проверки отзыва**. Ошибки `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` и `CRYPT_E_REVOCATION_OFFLINE (0x80092013)` означают, что curl достиг сервера, но ваша сеть блокирует поиск отзыва сертификата, что распространено за корпоративными брандмауэрами. Добавление флага `--ssl-revoke-best-effort` к curl не исправляет это: флаг применяется только к загрузке самого `install.cmd`, а собственные загрузки скрипта работают без него, поэтому установка не удаётся с той же ошибкой. Используйте метод установки, который допускает заблокированный поиск. Откройте PowerShell и запустите установщик PowerShell, который загружается через .NET и не падает, когда сервер отзыва недоступен:

451 ```batch theme={null}453 ```powershell theme={null}

452 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd454 irm https://claude.ai/install.ps1 | iex

453 ```455 ```

454 Или установите с `winget install Anthropic.ClaudeCode`, что полностью избегает curl.456 Вы также можете установить с `winget install Anthropic.ClaudeCode`, что полностью избегает curl.

455 457 

456<h3 id="failed-to-fetch-version-from-downloads-claude-ai">458<h3 id="failed-to-fetch-version-from-downloads-claude-ai">

457 `Failed to fetch version from downloads.claude.ai`459 `Failed to fetch version from downloads.claude.ai`

Details

43 43 

44Разбор показывает размер набора резидентов, кучу JS, буферы массивов и неучтённую собственную память, что помогает определить, находится ли рост в объектах JavaScript или в собственном коде. Чтобы проверить удерживающие элементы, откройте файл `.heapsnapshot` в Chrome DevTools под Memory → Load. Прикрепите оба файла при сообщении о проблеме с памятью на [GitHub](https://github.com/anthropics/claude-code/issues).44Разбор показывает размер набора резидентов, кучу JS, буферы массивов и неучтённую собственную память, что помогает определить, находится ли рост в объектах JavaScript или в собственном коде. Чтобы проверить удерживающие элементы, откройте файл `.heapsnapshot` в Chrome DevTools под Memory → Load. Прикрепите оба файла при сообщении о проблеме с памятью на [GitHub](https://github.com/anthropics/claude-code/issues).

45 45 

46<h3 id="large-tables-are-cut-off-in-the-terminal">

47 Large tables are cut off in the terminal

48</h3>

49 

50Таблица Markdown с более чем 200 строками отображает первые 200 строк, за которыми следует строка `… N more rows not shown`. Отображение ограничено только визуально: полная таблица остаётся в разговоре, и [`/copy`](/ru/commands) копирует каждую строку. Для таблицы, которая слишком велика для чтения в терминале, попросите Claude записать её в файл вместо этого. До версии v2.1.208 Claude Code отображал каждую строку, поэтому возобновление сеанса, содержащего очень большую таблицу, могло зависнуть при её повторном отображении.

51 

46<h3 id="auto-compaction-stops-with-a-thrashing-error">52<h3 id="auto-compaction-stops-with-a-thrashing-error">

47 Auto-compaction stops with a thrashing error53 Auto-compaction stops with a thrashing error

48</h3>54</h3>

vs-code.md +7 −7

Details

360</h3>360</h3>

361 361 

362| Параметр | По умолчанию | Описание |362| Параметр | По умолчанию | Описание |

363| ----------------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |363| ----------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

364| `useTerminal` | `false` | Запустить Claude в режиме терминала вместо графической панели |364| `useTerminal` | `false` | Запустить Claude в режиме терминала вместо графической панели |

365| `initialPermissionMode` | `default` | Управляет запросами одобрения для новых бесед: `default`, `plan`, `acceptEdits` или `bypassPermissions`. {/* min-version: 2.1.200 */}`manual` — это псевдоним для `default` и выбирает режим, обозначенный как **Manual** в индикаторе режима. Требует Claude Code v2.1.200 или позже. Подробности см. в разделе [режимы разрешений](/ru/permission-modes). |365| `initialPermissionMode` | `default` | Управляет запросами одобрения для новых бесед: `default`, `plan`, `acceptEdits` или `bypassPermissions`. {/* min-version: 2.1.200 */}`manual` — это псевдоним для `default` и выбирает режим, обозначенный как **Manual** в индикаторе режима. Требует Claude Code v2.1.200 или позже. Подробности см. в разделе [режимы разрешений](/ru/permission-modes). |

366| `preferredLocation` | `panel` | Где открывается Claude: `sidebar` (справа) или `panel` (новая вкладка) |366| `preferredLocation` | `panel` | Где открывается Claude: `sidebar` (справа) или `panel` (новая вкладка) |


374| `environmentVariables` | `[]` | Установить переменные окружения для процесса Claude. Используйте параметры Claude Code вместо этого для общей конфигурации. |374| `environmentVariables` | `[]` | Установить переменные окружения для процесса Claude. Используйте параметры Claude Code вместо этого для общей конфигурации. |

375| `disableLoginPrompt` | `false` | Пропустить запросы аутентификации (для настроек поставщика третьей стороны) |375| `disableLoginPrompt` | `false` | Пропустить запросы аутентификации (для настроек поставщика третьей стороны) |

376| `allowDangerouslySkipPermissions` | `false` | Добавляет Bypass permissions к селектору режимов. Используйте только в песочницах без доступа в интернет. |376| `allowDangerouslySkipPermissions` | `false` | Добавляет Bypass permissions к селектору режимов. Используйте только в песочницах без доступа в интернет. |

377| `claudeProcessWrapper` | - | Исполняемый файл, используемый для запуска процесса Claude. Путь к встроенному двоичному файлу передаётся в качестве аргумента при наличии. Установите это значение на отдельно установленный двоичный файл `claude`, если сборка расширения не включает его для вашей платформы. |377| `claudeProcessWrapper` | - | Исполняемый файл, используемый для запуска процесса Claude. Путь к встроенному двоичному файлу передаётся в качестве аргумента при наличии. Установите это значение на отдельно установленный двоичный файл `claude`, если сборка расширения не включает его для вашей платформы. Ошибка "Unsupported platform" при активации означает, что для вашей платформы не включен двоичный файл; см. [какие платформы имеют предварительно собранные двоичные файлы](/ru/troubleshoot-install#native-binary-not-found-after-npm-install). |

378 378 

379<h2 id="vs-code-extension-vs-claude-code-cli">379<h2 id="vs-code-extension-vs-claude-code-cli">

380 Расширение VS Code и Claude Code CLI380 Расширение VS Code и Claude Code CLI


525 525 

526**Выделение и контекст открытого файла.** Во время подключения CLI включает ваше текущее выделение в редакторе и путь активного файла в качестве контекста для каждого отправляемого вами запроса. Стенограмма показывает строку `⧉ Selected N lines from <file>` когда это происходит. Чтобы исключить конфиденциальный файл, такой как `.env`, добавьте [`Read` правило отказа](/ru/permissions#read-and-edit) для его пути. Соответствующее правило отказа предотвращает как выбранный текст, так и уведомление об открытом файле для этого файла от достижения Claude.526**Выделение и контекст открытого файла.** Во время подключения CLI включает ваше текущее выделение в редакторе и путь активного файла в качестве контекста для каждого отправляемого вами запроса. Стенограмма показывает строку `⧉ Selected N lines from <file>` когда это происходит. Чтобы исключить конфиденциальный файл, такой как `.env`, добавьте [`Read` правило отказа](/ru/permissions#read-and-edit) для его пути. Соответствующее правило отказа предотвращает как выбранный текст, так и уведомление об открытом файле для этого файла от достижения Claude.

527 527 

528**Транспорт и аутентификация.** Сервер привязывается к `127.0.0.1` на случайном высоком порту и недоступен с других машин. Каждая активация расширения генерирует свежий случайный токен аутентификации, который CLI должен предоставить для подключения. Токен записывается в файл блокировки под `~/.claude/ide/` с разрешениями `0600` в каталоге `0700`, поэтому только пользователь, запускающий VS Code, может его прочитать.528**Транспорт и аутентификация.** Сервер привязывается к `127.0.0.1` на случайном порту в диапазоне 10000–65535, и порт не настраивается. Транспорт — это незашифрованный `ws://`; поскольку сокет является только локальным, любой процесс, который может перехватить трафик, также может прочитать токен из файла блокировки, поэтому TLS не добавит защиту. Каждая активация расширения генерирует свежий случайный токен аутентификации, записывает его в файл блокировки в `~/.claude/ide/<port>.lock`, и CLI должен предоставить его как заголовок `X-Claude-Code-Ide-Authorization` для подключения. Файл блокировки имеет разрешения `0600` в каталоге `0700`, поэтому только пользователь, запускающий VS Code, может его прочитать. Если установлена переменная `CLAUDE_CONFIG_DIR`, файл блокировки записывается в `$CLAUDE_CONFIG_DIR/ide/` вместо этого.

529 529 

530**Инструменты, предоставляемые модели.** Сервер размещает дюжину инструментов, но только два видны модели. Остальные — это внутренний RPC, который CLI использует для своего собственного UI — открытие diff, чтение выделений, сохранение файлов — и фильтруются перед тем, как список инструментов достигает Claude.530**Инструменты, предоставляемые модели.** Сервер размещает дюжину инструментов, но только два видны модели. Остальные — это внутренний RPC, который CLI использует для своего собственного UI — открытие diff, чтение выделений, сохранение файлов — и фильтруются перед тем, как список инструментов достигает Claude.

531 531 

532| Имя инструмента (как видно hooks) | Что он делает | Записывает? |532| Имя инструмента (как видно hooks) | Что он делает | Только для чтения |

533| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ----------- |533| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------- |

534| `mcp__ide__getDiagnostics` | Возвращает диагностику языкового сервера — ошибки и предупреждения на панели Problems VS Code. Опционально ограничено одним файлом. | Нет |534| `mcp__ide__getDiagnostics` | Возвращает диагностику языкового сервера — ошибки и предупреждения на панели Problems VS Code. Опционально ограничено одним файлом. | Да |

535| `mcp__ide__executeCode` | Запускает код Python в ядре активной записной книжки Jupyter. См. поток подтверждения ниже. | Да |535| `mcp__ide__executeCode` | Запускает код Python в ядре активной записной книжки Jupyter. См. поток подтверждения ниже. | Нет |

536 536 

537**Выполнение Jupyter всегда спрашивает сначала.** `mcp__ide__executeCode` не может запустить ничего молча. При каждом вызове код вставляется как новая ячейка в конце активной записной книжки, VS Code прокручивает её в поле зрения, и собственный Quick Pick спрашивает вас **Execute** или **Cancel**. Отмена — или закрытие выбора с помощью `Esc` — возвращает ошибку Claude и ничего не запускается. Инструмент также отказывает, когда нет активной записной книжки, когда расширение Jupyter (`ms-toolsai.jupyter`) не установлено, или когда ядро не является Python.537**Выполнение Jupyter всегда спрашивает сначала.** `mcp__ide__executeCode` не может запустить ничего молча. При каждом вызове код вставляется как новая ячейка в конце активной записной книжки, VS Code прокручивает её в поле зрения, и собственный Quick Pick спрашивает вас **Execute** или **Cancel**. Отмена — или закрытие выбора с помощью `Esc` — возвращает ошибку Claude и ничего не запускается. Инструмент также отказывает, когда нет активной записной книжки, когда расширение Jupyter (`ms-toolsai.jupyter`) не установлено, или когда ядро не является Python.

538 538 

Details

23 <video autoPlay muted loop playsInline className="w-full" src="https://mintcdn.com/claude-code/CfffsX01JHFnIKvD/images/whats-new/cli-computer-use.mp4?fit=max&auto=format&n=CfffsX01JHFnIKvD&q=85&s=c17a337902308d7c9121013ded0494db" data-path="images/whats-new/cli-computer-use.mp4" />23 <video autoPlay muted loop playsInline className="w-full" src="https://mintcdn.com/claude-code/CfffsX01JHFnIKvD/images/whats-new/cli-computer-use.mp4?fit=max&auto=format&n=CfffsX01JHFnIKvD&q=85&s=c17a337902308d7c9121013ded0494db" data-path="images/whats-new/cli-computer-use.mp4" />

24 </Frame>24 </Frame>

25 25 

26 <p className="digest-feature-try">Запустите <code>/mcp</code>, найдите <code>computer-use</code> и включите его. Затем попросите Claude проверить изменение от начала до конца:</p>26 <p className="digest-feature-try">Требует macOS и план Pro или Max; в противном случае <code>computer-use</code> не будет отображаться в <code>/mcp</code>. Запустите <code>/mcp</code>, найдите <code>computer-use</code> и включите его. Затем попросите Claude проверить изменение от начала до конца:</p>

27 27 

28 ```text Claude Code theme={null}28 ```text Claude Code theme={null}

29 > Open the iOS simulator, tap through onboarding, and screenshot each step29 > Open the iOS simulator, tap through onboarding, and screenshot each step


123 <p className="digest-wins-title">Другие улучшения</p>123 <p className="digest-wins-title">Другие улучшения</p>

124 124 

125 <div className="digest-wins-grid">125 <div className="digest-wins-grid">

126 <div>Продолжения в режиме Auto: новый hook <code>PermissionDenied</code> срабатывает при отказах классификатора (верните <code>retry: true</code>, чтобы позволить Claude попробовать другой подход), и <code>/permissions</code> → Recent позволяет вам повторить попытку вручную с помощью <code>r</code></div>126 <div>Продолжения в режиме Auto: новый hook <code>PermissionDenied</code> срабатывает при отказах классификатора (верните <code>retry: true</code>, чтобы позволить Claude попробовать другой подход), и <code>/permissions</code> → Recently denied позволяет вам повторить попытку вручную с помощью <code>r</code></div>

127 <div>Новое значение <code>defer</code> для <code>permissionDecision</code> в hooks <code>PreToolUse</code>: сессии <code>-p</code> приостанавливаются при вызове инструмента и выходят с полезной нагрузкой <code>deferred\_tool\_use</code>, чтобы приложение SDK или пользовательский интерфейс могли её отобразить, затем возобновляются с помощью <code>--resume</code></div>127 <div>Новое значение <code>defer</code> для <code>permissionDecision</code> в hooks <code>PreToolUse</code>: сессии <code>-p</code> приостанавливаются при вызове инструмента и выходят с полезной нагрузкой <code>deferred\_tool\_use</code>, чтобы приложение SDK или пользовательский интерфейс могли её отобразить, затем возобновляются с помощью <code>--resume</code></div>

128 <div><code>/buddy</code>: вылупите маленькое существо, которое наблюдает за вами во время кодирования (1 апреля)</div>128 <div><code>/buddy</code>: вылупите маленькое существо, которое наблюдает за вами во время кодирования. Шутка 1 апреля, больше недоступна</div>

129 <div>Параметр <code>disableSkillShellExecution</code> блокирует встроенную оболочку из skills, slash commands и команд плагинов</div>129 <div>Параметр <code>disableSkillShellExecution</code> блокирует встроенную оболочку из skills, slash commands и команд плагинов</div>

130 <div>Инструмент Edit теперь работает на файлах, просмотренных через <code>cat</code> или <code>sed -n</code> без отдельного Read</div>130 <div>Инструмент Edit теперь работает на файлах, просмотренных через <code>cat</code> или <code>sed -n</code> без отдельного Read</div>

131 <div>Вывод Hook свыше 50K сохраняется на диск с путём и предпросмотром вместо внедрения в контекст</div>131 <div>Вывод Hook свыше 50K сохраняется на диск с путём и предпросмотром вместо внедрения в контекст</div>

Details

25 export CLAUDE_CODE_ENABLE_AUTO_MODE=125 export CLAUDE_CODE_ENABLE_AUTO_MODE=1

26 ```26 ```

27 27 

28 <a className="digest-feature-link" href="/ru/docs/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry">Включить режим auto у сторонних поставщиков</a>28 <a className="digest-feature-link" href="/docs/ru/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry">Включить режим auto у сторонних поставщиков</a>

29</div>29</div>

30 30 

31<div className="digest-feature">31<div className="digest-feature">

workflows.md +7 −5

Details

100Представление прогресса показывает каждую фазу с количеством агентов, общим количеством токенов и прошедшим временем. Нижний колонтитул перечисляет ключ для каждого действия:100Представление прогресса показывает каждую фазу с количеством агентов, общим количеством токенов и прошедшим временем. Нижний колонтитул перечисляет ключ для каждого действия:

101 101 

102| Ключ | Действие |102| Ключ | Действие |

103| :-------------- | :----------------------------------------------------------------------------------------------------------------- |103| :-------------- | :---------------------------------------------------------------------------------------------------------------------------------------------- |

104| `↑` / `↓` | Выбрать фазу или агента |104| `↑` / `↓` | Выбрать фазу или агента |

105| `Enter` или `→` | Углубиться в выбранную фазу, затем в агента для чтения его подсказки, недавних вызовов инструментов и результата |105| `Enter` или `→` | Углубиться в выбранную фазу, затем в агента для чтения его подсказки, недавних вызовов инструментов и результата |

106| `Esc` | Вернуться на один уровень назад |106| `Esc` или `←` | Вернуться на один уровень назад. В версиях v2.1.203 по v2.1.205 `←` не позволял вернуться из фазы или агента; используйте `Esc` на этих версиях |

107| `j` / `k` | Прокручивать в деталях агента, когда это переполняется |107| `j` / `k` | Прокручивать в деталях агента, когда это переполняется |

108| `f` | {/* min-version: 2.1.186 */}Фильтровать список агентов в выбранной фазе по статусу. Нажмите снова для циклирования |108| `f` | {/* min-version: 2.1.186 */}Фильтровать список агентов в выбранной фазе по статусу. Нажмите снова для циклирования |

109| `p` | Приостановить или возобновить запуск |109| `p` | Приостановить или возобновить запуск |


192Запустите `/workflows`, выберите запуск, который вы хотите сохранить, и нажмите `s`. В диалоге сохранения Tab переключается между двумя местами сохранения:192Запустите `/workflows`, выберите запуск, который вы хотите сохранить, и нажмите `s`. В диалоге сохранения Tab переключается между двумя местами сохранения:

193 193 

194* `.claude/workflows/` в вашем проекте: общее с каждым, кто клонирует репо194* `.claude/workflows/` в вашем проекте: общее с каждым, кто клонирует репо

195* `~/.claude/workflows/` в вашем домашнем каталоге: доступно в каждом проекте, видимо только вам195* `~/.claude/workflows/` в вашем домашнем каталоге: доступно в каждом проекте, видимо только вам. Если вы установили [`CLAUDE_CONFIG_DIR`](/ru/env-vars), это местоположение — это каталог `workflows/` под этим путём.

196 

197{/* min-version: 2.1.208 */}Диалог сохранения показывает разрешённый путь для личного местоположения. До версии 2.1.208 он показывал `~/.claude/workflows/` даже когда был установлен `CLAUDE_CONFIG_DIR`; файл всё ещё сохранялся под настроенным каталогом.

196 198 

197Нажмите Enter для сохранения. Workflow запускается как `/<name>` в будущих сессиях из любого места.199Нажмите Enter для сохранения. Workflow запускается как `/<name>` в будущих сессиях из любого места.

198 200 


338 Возобновить после паузы340 Возобновить после паузы

339</h3>341</h3>

340 342 

341Если вы остановите запуск, вы можете возобновить его: агенты, которые уже завершились, возвращают свои кэшированные результаты, а остальные работают в реальном времени. Возобновите приостановленный запуск из `/workflows`, выбрав его и нажав `p`, или попросите Claude перезапустить workflow с тем же скриптом.343Если вы остановите запуск, вы можете возобновить его: агенты, которые уже завершились, возвращают свои кэшированные результаты, а остальные работают в реальном времени. Агент, который всё ещё работал, когда вы остановили запуск, не сохраняется и начинает работу заново при возобновлении, поэтому workflow, который распределяет работу между множеством небольших агентов, сохраняет больше прогресса, чем один длительный агент. Возобновите приостановленный запуск из `/workflows`, выбрав его и нажав `p`, или попросите Claude перезапустить workflow с тем же скриптом.

342 344 

343Возобновление работает в той же сессии Claude Code. Если вы выйдете из Claude Code, пока workflow работает, следующая сессия запустит workflow заново.345Возобновление работает в той же сессии Claude Code. Если вы выйдете из Claude Code, пока workflow работает, следующая сессия запустит workflow заново.

344 346 


357* Если вы [установите рекомендацию по размеру](#set-a-size-guideline), количество агентов рекомендации заменяет порог в 25 агентов.359* Если вы [установите рекомендацию по размеру](#set-a-size-guideline), количество агентов рекомендации заменяет порог в 25 агентов.

358* Сессии с включённым [ultracode](#let-claude-decide-with-ultracode) не показывают предупреждение, потому что включение ultracode уже означает согласие на крупные запуски.360* Сессии с включённым [ultracode](#let-claude-decide-with-ultracode) не показывают предупреждение, потому что включение ultracode уже означает согласие на крупные запуски.

359 361 

360Каждый агент в workflow использует модель вашей сессии, если скрипт не маршрутизирует этап на другую. Чтобы контролировать стоимость модели:362Каждый агент в workflow использует модель вашей сессии, если скрипт не маршрутизирует этап на другую или переменная окружения [`CLAUDE_CODE_SUBAGENT_MODEL`](/ru/model-config#environment-variables) не установлена, что переопределяет оба варианта. Чтобы контролировать стоимость модели:

361 363 

362* Проверьте `/model` перед крупным запуском, если вы обычно переключаетесь на меньшую модель для рутинной работы364* Проверьте `/model` перед крупным запуском, если вы обычно переключаетесь на меньшую модель для рутинной работы

363* Попросите Claude использовать меньшую модель для этапов, которые не требуют самой сильной, когда вы описываете задачу365* Попросите Claude использовать меньшую модель для этапов, которые не требуют самой сильной, когда вы описываете задачу

worktrees.md +23 −1

Details

36 36 

37Вы также можете попросить Claude "работать в worktree" во время сеанса, и он создаст один с помощью инструмента [`EnterWorktree`](/ru/tools-reference). После входа в worktree Claude может переключиться непосредственно на другой worktree в `.claude/worktrees/`, вызвав `EnterWorktree` с целевым путём. Предыдущий worktree остаётся на диске нетронутым.37Вы также можете попросить Claude "работать в worktree" во время сеанса, и он создаст один с помощью инструмента [`EnterWorktree`](/ru/tools-reference). После входа в worktree Claude может переключиться непосредственно на другой worktree в `.claude/worktrees/`, вызвав `EnterWorktree` с целевым путём. Предыдущий worktree остаётся на диске нетронутым.

38 38 

39Вход в путь вне каталога `.claude/worktrees/` репозитория требует вашего одобрения в первую очередь, потому что это перемещает рабочий каталог сеанса, доступ на запись и конфигурацию проекта, такую как `CLAUDE.md` и settings, в это место. Правило разрешения `EnterWorktree` [permission rule](/ru/permissions) или выбор "не спрашивать снова" не подавляет это приглашение; только режим `bypassPermissions` пропускает его. До версии 2.1.206 Claude мог войти в любой существующий путь worktree без запроса.

40 

39{/* min-version: 2.1.198 */}Начиная с версии 2.1.198, вход или выход из worktree также перемещает стенограмму сеанса в хранилище проекта этого каталога, так же как это делает [`/cd`](/ru/commands), поэтому `/desktop` и `--resume` находят сеанс там после этого. Worktrees, созданные hook [`WorktreeCreate`](#non-git-version-control), исключены и сохраняют стенограмму в каталоге запуска.41{/* min-version: 2.1.198 */}Начиная с версии 2.1.198, вход или выход из worktree также перемещает стенограмму сеанса в хранилище проекта этого каталога, так же как это делает [`/cd`](/ru/commands), поэтому `/desktop` и `--resume` находят сеанс там после этого. Worktrees, созданные hook [`WorktreeCreate`](#non-git-version-control), исключены и сохраняют стенограмму в каталоге запуска.

40 42 

43Worktrees работают с включённым [sandboxing](/ru/sandboxing#filesystem-isolation): песочница позволяет записывать в общий каталог `.git` основного репозитория, поэтому команды, такие как `git commit`, могут обновлять refs и индекс изнутри связанного worktree.

44 

41Перед использованием `--worktree` интерактивно в каталоге в первый раз примите диалог доверия рабочей области, запустив `claude` один раз в этом каталоге. Если доверие ещё не было принято, `--worktree` завершится с ошибкой и предложит вам сначала запустить `claude` в каталоге. Неинтерактивные запуски с `-p` пропускают [проверку доверия](/ru/security), поэтому `claude -p --worktree` продолжает работу без неё.45Перед использованием `--worktree` интерактивно в каталоге в первый раз примите диалог доверия рабочей области, запустив `claude` один раз в этом каталоге. Если доверие ещё не было принято, `--worktree` завершится с ошибкой и предложит вам сначала запустить `claude` в каталоге. Неинтерактивные запуски с `-p` пропускают [проверку доверия](/ru/security), поэтому `claude -p --worktree` продолжает работу без неё.

42 46 

43Если Claude Code не может войти в каталог worktree при запуске, например потому что hook [`WorktreeCreate`](/ru/hooks#worktreecreate) вывел что-то другое, чем каталог, который он создал, или потому что каталог был удалён после его настройки, Claude Code выводит ошибку с указанием пути и завершается с кодом 1. До версии 2.1.205 это приводило к сбою сеанса, а с `-p` это зависало примерно на 30 секунд перед выходом с кодом 0.47Если Claude Code не может войти в каталог worktree при запуске, например потому что hook [`WorktreeCreate`](/ru/hooks#worktreecreate) вывел что-то другое, чем каталог, который он создал, или потому что каталог был удалён после его настройки, Claude Code выводит ошибку с указанием пути и завершается с кодом 1. До версии 2.1.205 это приводило к сбою сеанса, а с `-p` это зависало примерно на 30 секунд перед выходом с кодом 0.


52 Выберите базовую ветку56 Выберите базовую ветку

53</h3>57</h3>

54 58 

55Worktrees ветвятся от ветки репозитория по умолчанию, `origin/HEAD`, поэтому они начинаются с чистого дерева, соответствующего удалённому серверу. Если удалённый сервер не настроен или загрузка не удалась, worktree переходит на вашу текущую локальную `HEAD`. Чтобы всегда ветвиться от локальной `HEAD`, установите `worktree.baseRef` на `"head"` в [settings](/ru/settings#worktree-settings). Установка `baseRef` на `"head"` делает новые worktrees содержащими ваши неотправленные коммиты и состояние ветки функции, что полезно при изоляции subagents, которым нужно работать с незавершённой работой. Параметр принимает только `"fresh"` или `"head"`, а не произвольные git refs:59Worktrees ветвятся от ветки репозитория по умолчанию, `origin/HEAD`, поэтому они начинаются с чистого дерева, соответствующего удалённому серверу. Когда ничего не загружало репозиторий в течение последних 24 часов, Claude Code обновляет `origin/HEAD` с помощью загрузки ветки по умолчанию, ограниченной пятью секундами, и использует локально кэшированный ref, если загрузка не удалась. Если удалённый сервер не настроен или `origin/HEAD` не кэширован локально и не может быть загружен, worktree переходит на вашу текущую локальную `HEAD`.

60 

61Обновление требует Claude Code версии 2.1.208 или позже; до этого новый worktree использовал то, что уже было кэшировано локально в `origin/HEAD`.

62 

63Чтобы всегда ветвиться от локальной `HEAD`, установите `worktree.baseRef` на `"head"` в [settings](/ru/settings#worktree-settings). Установка `baseRef` на `"head"` делает новые worktrees содержащими ваши неотправленные коммиты и состояние ветки функции, что полезно при изоляции subagents, которым нужно работать с незавершённой работой. Когда сеанс работает внутри связанного worktree, `"head"` разрешается в `HEAD` этого worktree, а не в основной копии. Параметр принимает только `"fresh"` или `"head"`, а не произвольные git refs:

56 64 

57```json theme={null}65```json theme={null}

58{66{


70 78 

71Для полного контроля над тем, как создаются worktrees, настройте hook [`WorktreeCreate`](/ru/hooks#worktreecreate), который полностью заменяет логику `git worktree` по умолчанию.79Для полного контроля над тем, как создаются worktrees, настройте hook [`WorktreeCreate`](/ru/hooks#worktreecreate), который полностью заменяет логику `git worktree` по умолчанию.

72 80 

81<h3 id="reuse-a-worktree-name">

82 Повторное использование имени worktree

83</h3>

84 

85Повторное использование имени worktree, каталог которого уже существует, возобновляет этот worktree.

86 

87Возобновленный worktree переходит к [текущей базе](#choose-the-base-branch) вместо возобновления на его старой вершине, когда выполняются все следующие условия:

88 

89* Он не имеет незафиксированных изменений или неотслеживаемых файлов.

90* Он всё ещё находится на ветке, которую создал Claude Code.

91* Он никогда не коммитил, или его pull request был объединён и его удалённая ветка удалена.

92 

93До версии 2.1.208 повторное использование имени всегда возобновляло старый worktree на его старой вершине.

94 

73<h2 id="copy-gitignored-files-into-worktrees">95<h2 id="copy-gitignored-files-into-worktrees">

74 Скопируйте игнорируемые git файлы в worktrees96 Скопируйте игнорируемые git файлы в worktrees

75</h2>97</h2>

Details

63| [Удаленные сеансы](/ru/desktop#cloud-sessions) из приложения Desktop | Требует постоянных данных сеанса, которые включают запросы и завершения. |63| [Удаленные сеансы](/ru/desktop#cloud-sessions) из приложения Desktop | Требует постоянных данных сеанса, которые включают запросы и завершения. |

64| [Артефакты](/ru/artifacts) | Требует сохранения опубликованного содержимого страницы на инфраструктуре, управляемой Anthropic. |64| [Артефакты](/ru/artifacts) | Требует сохранения опубликованного содержимого страницы на инфраструктуре, управляемой Anthropic. |

65| Отправка отзыва (`/feedback`) | Отправка отзыва отправляет данные беседы в Anthropic. |65| Отправка отзыва (`/feedback`) | Отправка отзыва отправляет данные беседы в Anthropic. |

66| [Remote Control](/ru/remote-control) | Сохраняет стенограмму сеанса на серверах Anthropic для синхронизации беседы между устройствами. |

66 67 

67Эти функции блокируются на бэкенде независимо от отображения на стороне клиента. Если вы видите отключенную функцию в терминале Claude Code при запуске, попытка использовать ее возвращает ошибку, указывающую на то, что политики организации не позволяют это действие.68Эти функции блокируются на бэкенде независимо от отображения на стороне клиента. Если вы видите отключенную функцию в терминале Claude Code при запуске, попытка использовать ее возвращает ошибку, указывающую на то, что политики организации не позволяют это действие.

68 69