SpyBara
Go Premium

Documentation 2026-07-09 23:58 UTC to 2026-07-10 17:00 UTC

112 files changed +1,703 −921. View all changes and history on the product overview
2026
Sat 11 14:02 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

admin-setup.md +6 −6

Details

15</Note>15</Note>

16 16 

17| Решение | Что вы выбираете | Справка |17| Решение | Что вы выбираете | Справка |

18| :------------------------------------------------------------------------------ | :-------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- |18| :------------------------------------------------------------------------------ | :-------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

19| [Выберите поставщика API](#choose-your-api-provider) | Где Claude Code аутентифицируется и как это выставляется счетом | [Authentication](/ru/authentication), [Bedrock](/ru/amazon-bedrock), [Vertex AI](/ru/google-vertex-ai), [Foundry](/ru/microsoft-foundry) |19| [Выберите поставщика API](#choose-your-api-provider) | Где Claude Code аутентифицируется и как это выставляется счетом | [Authentication](/ru/authentication), [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry) |

20| [Решите, как параметры достигают устройств](#decide-how-settings-reach-devices) | Как управляемая политика достигает машин разработчиков | [Server-managed settings](/ru/server-managed-settings), [Settings files](/ru/settings#settings-files) |20| [Решите, как параметры достигают устройств](#decide-how-settings-reach-devices) | Как управляемая политика достигает машин разработчиков | [Server-managed settings](/ru/server-managed-settings), [Settings files](/ru/settings#settings-files) |

21| [Решите, что принудительно применять](#decide-what-to-enforce) | Какие инструменты, команды и интеграции разрешены | [Permissions](/ru/permissions), [Sandboxing](/ru/sandboxing) |21| [Решите, что принудительно применять](#decide-what-to-enforce) | Какие инструменты, команды и интеграции разрешены | [Permissions](/ru/permissions), [Sandboxing](/ru/sandboxing) |

22| [Настройте видимость использования](#set-up-usage-visibility) | Как вы отслеживаете расходы и внедрение | [Analytics](/ru/analytics), [Monitoring](/ru/monitoring-usage), [Costs](/ru/costs) |22| [Настройте видимость использования](#set-up-usage-visibility) | Как вы отслеживаете расходы и внедрение | [Analytics](/ru/analytics), [Monitoring](/ru/monitoring-usage), [Costs](/ru/costs) |


33| Claude for Teams / Enterprise | Вы хотите Claude Code и claude.ai в одной подписке на одного пользователя без инфраструктуры для запуска. Это рекомендация по умолчанию. |33| Claude for Teams / Enterprise | Вы хотите Claude Code и claude.ai в одной подписке на одного пользователя без инфраструктуры для запуска. Это рекомендация по умолчанию. |

34| Claude Console | Вы ориентированы на API или хотите выставление счетов по мере использования |34| Claude Console | Вы ориентированы на API или хотите выставление счетов по мере использования |

35| Amazon Bedrock | Вы хотите наследовать существующие элементы управления соответствием AWS и выставление счетов |35| Amazon Bedrock | Вы хотите наследовать существующие элементы управления соответствием AWS и выставление счетов |

36| Google Vertex AI | Вы хотите наследовать существующие элементы управления соответствием GCP и выставление счетов |36| Google Cloud's Agent Platform | Вы хотите наследовать существующие элементы управления соответствием GCP и выставление счетов |

37| Microsoft Foundry | Вы хотите наследовать существующие элементы управления соответствием Azure и выставление счетов |37| Microsoft Foundry | Вы хотите наследовать существующие элементы управления соответствием Azure и выставление счетов |

38 38 

39Некоторые функции Claude Code требуют учетной записи claude.ai. [Claude Code on the web](/ru/claude-code-on-the-web), [Routines](/ru/routines), [Code Review](/ru/code-review), [Remote Control](/ru/remote-control) и [Chrome extension](/ru/chrome) недоступны только через ключи Console API или учетные данные поставщика облачных услуг. Если вы развертываете через Bedrock, Vertex или Foundry, спланируйте, нужны ли разработчикам также места Claude for Teams или Enterprise. На каждой странице функции указаны требования к плану.39Некоторые функции Claude Code требуют учетной записи claude.ai. [Claude Code on the web](/ru/claude-code-on-the-web), [Routines](/ru/routines), [Code Review](/ru/code-review), [Remote Control](/ru/remote-control) и [Chrome extension](/ru/chrome) недоступны только через ключи Console API или учетные данные поставщика облачных услуг. Если вы развертываете через Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, спланируйте, нужны ли разработчикам также места Claude for Teams или Enterprise. На каждой странице функции указаны требования к плану.

40 40 

41Для полного сравнения поставщиков, охватывающего аутентификацию, регионы и паритет функций, см. [обзор развертывания предприятия](/ru/third-party-integrations). Настройка аутентификации каждого поставщика находится в [Authentication](/ru/authentication).41Для полного сравнения поставщиков, охватывающего аутентификацию, регионы и паритет функций, см. [обзор развертывания предприятия](/ru/third-party-integrations). Настройка аутентификации каждого поставщика находится в [Authentication](/ru/authentication).

42 42 


57 57 

58Настроенный [`policyHelper`](/ru/settings#compute-managed-settings-with-a-policy-helper) имеет приоритет над всеми четырьмя источниками: его вывод становится единственной управляемой конфигурацией для запуска. См. [Settings precedence](/ru/settings#settings-precedence).58Настроенный [`policyHelper`](/ru/settings#compute-managed-settings-with-a-policy-helper) имеет приоритет над всеми четырьмя источниками: его вывод становится единственной управляемой конфигурацией для запуска. См. [Settings precedence](/ru/settings#settings-precedence).

59 59 

60Server-managed параметры достигают устройств во время аутентификации и обновляются каждый час во время активных сеансов без инфраструктуры конечной точки. Доставка через консоль администратора claude.ai требует плана Claude for Teams или Enterprise. Развертывания на Bedrock, Vertex AI или Foundry могут получить ту же удаленную доставку, запустив [Claude apps gateway](/ru/claude-apps-gateway), или вместо этого использовать один из механизмов на основе файлов или уровня ОС.60Server-managed параметры достигают устройств во время аутентификации и обновляются каждый час во время активных сеансов без инфраструктуры конечной точки. Доставка через консоль администратора claude.ai требует плана Claude for Teams или Enterprise. Развертывания на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry могут получить ту же удаленную доставку, запустив [Claude apps gateway](/ru/claude-apps-gateway), или вместо этого использовать один из механизмов на основе файлов или уровня ОС.

61 61 

62Если ваша организация смешивает поставщиков, настройте [server-managed settings](/ru/server-managed-settings) для пользователей claude.ai плюс [резервный вариант на основе файлов или plist/registry](/ru/settings#settings-files), чтобы другие пользователи по-прежнему получали управляемую политику.62Если ваша организация смешивает поставщиков, настройте [server-managed settings](/ru/server-managed-settings) для пользователей claude.ai плюс [резервный вариант на основе файлов или plist/registry](/ru/settings#settings-files), чтобы другие пользователи по-прежнему получали управляемую политику.

63 63 


153* [Server-managed settings](/ru/server-managed-settings): доставка управляемой политики из консоли администратора Claude153* [Server-managed settings](/ru/server-managed-settings): доставка управляемой политики из консоли администратора Claude

154* [Settings reference](/ru/settings): каждый ключ параметра, расположение файла и правило приоритета154* [Settings reference](/ru/settings): каждый ключ параметра, расположение файла и правило приоритета

155* [Monorepos and large repos](/ru/large-codebases): шаблоны конфигурации для каждого каталога для организаций, развертывающих в монорепозиторий155* [Monorepos and large repos](/ru/large-codebases): шаблоны конфигурации для каждого каталога для организаций, развертывающих в монорепозиторий

156* [Amazon Bedrock](/ru/amazon-bedrock), [Google Vertex AI](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry): развертывание для конкретного поставщика156* [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry): развертывание для конкретного поставщика

157* [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide): SSO, SCIM, управление местами и сценарий развертывания157* [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide): SSO, SCIM, управление местами и сценарий развертывания

advisor.md +2 −2

Details

9{/* plan-availability: feature=advisor providers=anthropic */}9{/* plan-availability: feature=advisor providers=anthropic */}

10 10 

11<Note>11<Note>

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

13</Note>13</Note>

14 14 

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


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

163 163 

164* **Claude Code v2.1.98 или позже**: запустите `claude update` для обновления.164* **Claude Code v2.1.98 или позже**: запустите `claude update` для обновления.

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

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

167 167 

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

Details

202 202 

203Когда достигается любой лимит, SDK возвращает `ResultMessage` с соответствующим подтипом ошибки (`error_max_turns` или `error_max_budget_usd`). См. [Обработать результат](#handle-the-result) для того, как проверить эти подтипы, и [`ClaudeAgentOptions`](/ru/agent-sdk/python#claudeagentoptions) / [`Options`](/ru/agent-sdk/typescript#options) для синтаксиса.203Когда достигается любой лимит, SDK возвращает `ResultMessage` с соответствующим подтипом ошибки (`error_max_turns` или `error_max_budget_usd`). См. [Обработать результат](#handle-the-result) для того, как проверить эти подтипы, и [`ClaudeAgentOptions`](/ru/agent-sdk/python#claudeagentoptions) / [`Options`](/ru/agent-sdk/typescript#options) для синтаксиса.

204 204 

205При [потоковом вводе](/ru/agent-sdk/streaming-vs-single-mode) сообщение, которое вы отправляете, пока ход все еще выполняется, остается в очереди, когда этот ход заканчивается на пределе максимальных ходов, и оно начинает свой собственный ход со своим собственным пределом максимальных ходов. До версии 2.1.205 сообщение, которое прибыло на последней итерации хода, могло быть поглощено завершающимся ходом и потеряно без когда-либо достижения модели.

206 

205<h3 id="effort-level">207<h3 id="effort-level">

206 Уровень усилий208 Уровень усилий

207</h3>209</h3>


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

232 234 

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

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

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

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

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

238| `"dontAsk"` | Никогда не подсказывает. Инструменты, предварительно одобренные [правилами разрешения](/ru/settings#permission-settings), работают, все остальное отклоняется |240| `"dontAsk"` | Никогда не подсказывает. Инструменты, предварительно одобренные [правилами разрешения](/ru/settings#permission-settings), работают, все остальное отклоняется |

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

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

241 243 

242Для интерактивных приложений используйте `"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) для полных деталей.


260Вот как каждый компонент влияет на контекст в SDK:262Вот как каждый компонент влияет на контекст в SDK:

261 263 

262| Источник | Когда он загружается | Влияние |264| Источник | Когда он загружается | Влияние |

263| :--------------------------- | :-------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |265| :--------------------------- | :-------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

264| **Системный запрос** | Каждый запрос | Небольшая фиксированная стоимость, всегда присутствует |266| **Системный запрос** | Каждый запрос | Небольшая фиксированная стоимость, всегда присутствует |

265| **CLAUDE.md файлы** | Начало сессии, через [`settingSources`](/ru/agent-sdk/claude-code-features) | Полное содержимое в каждом запросе (но кэшировано в запросе, поэтому только первый запрос платит полную стоимость) |267| **CLAUDE.md файлы** | Начало сессии, через [`settingSources`](/ru/agent-sdk/claude-code-features) | Полное содержимое в каждом запросе (но кэшировано в запросе, поэтому только первый запрос платит полную стоимость) |

266| **Определения инструментов** | Каждый запрос; схемы MCP отложены по умолчанию | Встроенные схемы инструментов загружаются в каждом запросе. [Поиск инструментов](/ru/agent-sdk/mcp#mcp-tool-search) отложит схемы инструментов MCP по умолчанию, возвращаясь к предварительной загрузке на Vertex AI или при использовании не первой стороной `ANTHROPIC_BASE_URL`. См. [Настройка поиска инструментов](/ru/agent-sdk/tool-search#configure-tool-search) для полной матрицы |268| **Определения инструментов** | Каждый запрос; схемы MCP отложены по умолчанию | Встроенные схемы инструментов загружаются в каждом запросе. [Поиск инструментов](/ru/agent-sdk/mcp#mcp-tool-search) отложит схемы инструментов MCP по умолчанию, возвращаясь к предварительной загрузке на Google Cloud's Agent Platform или при использовании не первой стороной `ANTHROPIC_BASE_URL`. См. [Настройка поиска инструментов](/ru/agent-sdk/tool-search#configure-tool-search) для полной матрицы |

267| **История разговора** | Накапливается на протяжении ходов | Растет с каждым ходом: запросы, ответы, входные данные инструментов, выходные данные инструментов |269| **История разговора** | Накапливается на протяжении ходов | Растет с каждым ходом: запросы, ответы, входные данные инструментов, выходные данные инструментов |

268| **Описания skills** | Начало сессии, через источники настроек | Короткие резюме; полное содержимое загружается только при вызове |270| **Описания skills** | Начало сессии, через источники настроек | Короткие резюме; полное содержимое загружается только при вызове |

269 271 


305 307 

306* **Используйте подагентов для подзадач.** Каждый подагент начинает со свежего разговора (без предыдущей истории сообщений, хотя он загружает свой собственный системный запрос и контекст уровня проекта, такой как CLAUDE.md). Он не видит ходы родителя, и только его финальный ответ возвращается родителю как результат инструмента. Контекст основного агента растет на эту резюме, а не на полную транскрипцию подзадачи. См. [Что наследуют подагенты](/ru/agent-sdk/subagents#what-subagents-inherit) для деталей.308* **Используйте подагентов для подзадач.** Каждый подагент начинает со свежего разговора (без предыдущей истории сообщений, хотя он загружает свой собственный системный запрос и контекст уровня проекта, такой как CLAUDE.md). Он не видит ходы родителя, и только его финальный ответ возвращается родителю как результат инструмента. Контекст основного агента растет на эту резюме, а не на полную транскрипцию подзадачи. См. [Что наследуют подагенты](/ru/agent-sdk/subagents#what-subagents-inherit) для деталей.

307* **Будьте избирательны с инструментами.** Каждое определение инструмента занимает место контекста. Используйте поле `tools` на [`AgentDefinition`](/ru/agent-sdk/subagents#agentdefinition-configuration) для ограничения подагентов минимальным набором, который им нужен.309* **Будьте избирательны с инструментами.** Каждое определение инструмента занимает место контекста. Используйте поле `tools` на [`AgentDefinition`](/ru/agent-sdk/subagents#agentdefinition-configuration) для ограничения подагентов минимальным набором, который им нужен.

308* **Следите за стоимостью MCP сервера.** [Поиск инструментов MCP](/ru/agent-sdk/mcp#mcp-tool-search) отложит схемы инструментов MCP по умолчанию и загружает их по требованию. Когда поиск инструментов отключен, на Vertex AI или за не первой стороной `ANTHROPIC_BASE_URL`, каждый MCP сервер добавляет все свои схемы инструментов в каждый запрос, поэтому несколько серверов с множеством инструментов могут потребить значительный контекст перед тем, как агент выполнит какую-либо работу.310* **Следите за стоимостью MCP сервера.** [Поиск инструментов MCP](/ru/agent-sdk/mcp#mcp-tool-search) отложит схемы инструментов MCP по умолчанию и загружает их по требованию. Когда поиск инструментов отключен, на Google Cloud's Agent Platform или за не первой стороной `ANTHROPIC_BASE_URL`, каждый MCP сервер добавляет все свои схемы инструментов в каждый запрос, поэтому несколько серверов с множеством инструментов могут потребить значительный контекст перед тем, как агент выполнит какую-либо работу.

309* **Используйте более низкие усилия для обычных задач.** Установите [effort](#effort-level) на `"low"` для агентов, которым нужно только читать файлы или список каталогов. Это снижает использование токенов и стоимость.311* **Используйте более низкие усилия для обычных задач.** Установите [effort](#effort-level) на `"low"` для агентов, которым нужно только читать файлы или список каталогов. Это снижает использование токенов и стоимость.

310 312 

311Для подробного разбора стоимости контекста для каждой функции см. [Понять стоимость контекста](/ru/features-overview#understand-context-costs).313Для подробного разбора стоимости контекста для каждой функции см. [Понять стоимость контекста](/ru/features-overview#understand-context-costs).

Details

292 Расширение TTL кэша подсказок до одного часа292 Расширение TTL кэша подсказок до одного часа

293</h3>293</h3>

294 294 

295Записи кэша, написанные SDK, используют TTL в 5 минут по умолчанию, когда вы аутентифицируетесь с помощью ключа API или запускаете на Amazon Bedrock, Google Cloud Vertex AI или Microsoft Foundry. Если ваша рабочая нагрузка запускает много коротких сессий против одной и той же системной подсказки и контекста с промежутками более 5 минут между ними, кэш истекает между сессиями и каждая новая сессия платит полную входную цену.295Записи кэша, написанные SDK, используют TTL в 5 минут по умолчанию, когда вы аутентифицируетесь с помощью ключа API или запускаете на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Если ваша рабочая нагрузка запускает много коротких сессий против одной и той же системной подсказки и контекста с промежутками более 5 минут между ними, кэш истекает между сессиями и каждая новая сессия платит полную входную цену.

296 296 

297Чтобы запросить TTL в 1 час на записи кэша, установите переменную окружения [`ENABLE_PROMPT_CACHING_1H`](/ru/env-vars). Вы можете экспортировать её в окружение вашей оболочки или контейнера, или передать её через `options.env`.297Чтобы запросить TTL в 1 час на записи кэша, установите переменную окружения [`ENABLE_PROMPT_CACHING_1H`](/ru/env-vars). Вы можете экспортировать её в окружение вашей оболочки или контейнера, или передать её через `options.env`.

298 298 

299Следующий пример включает TTL в 1 час для агента, работающего на Bedrock:299Следующий пример включает TTL в 1 час для агента, работающего на Amazon Bedrock:

300 300 

301<CodeGroup>301<CodeGroup>

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

Details

15</h2>15</h2>

16 16 

17| Если вы хотите... | Сделайте это |17| Если вы хотите... | Сделайте это |

18| :------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |18| :-------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

19| Определить инструмент | Используйте [`@tool`](/ru/agent-sdk/python#tool) (Python) или [`tool()`](/ru/agent-sdk/typescript#tool) (TypeScript) с именем, описанием, схемой и обработчиком. См. [Создание пользовательского инструмента](#create-a-custom-tool). |19| Определить инструмент | Используйте [`@tool`](/ru/agent-sdk/python#tool) (Python) или [`tool()`](/ru/agent-sdk/typescript#tool) (TypeScript) с именем, описанием, схемой и обработчиком. См. [Создание пользовательского инструмента](#create-a-custom-tool). |

20| Зарегистрировать инструмент с Claude | Оберните в `create_sdk_mcp_server` / `createSdkMcpServer` и передайте в `mcpServers` в `query()`. См. [Вызов пользовательского инструмента](#call-a-custom-tool). |20| Зарегистрировать инструмент с Claude | Оберните в `create_sdk_mcp_server` / `createSdkMcpServer` и передайте в `mcpServers` в `query()`. См. [Вызов пользовательского инструмента](#call-a-custom-tool). |

21| Предварительно одобрить инструмент | Добавьте в разрешённые инструменты. См. [Настройка разрешённых инструментов](#configure-allowed-tools). |21| Предварительно одобрить инструмент | Добавьте в разрешённые инструменты. См. [Настройка разрешённых инструментов](#configure-allowed-tools). |

22| Удалить встроенный инструмент из контекста Claude | Передайте массив `tools`, содержащий только встроенные инструменты, которые вы хотите. См. [Настройка разрешённых инструментов](#configure-allowed-tools). |22| Удалить встроенный инструмент из контекста Claude | Передайте массив `tools`, содержащий только встроенные инструменты, которые вы хотите. См. [Настройка разрешённых инструментов](#configure-allowed-tools). |

23| Позволить Claude вызывать инструменты параллельно | Установите `readOnlyHint: true` на инструментах без побочных эффектов. См. [Добавление аннотаций инструментов](#add-tool-annotations). |23| Позволить Claude вызывать инструменты параллельно | Установите `readOnlyHint: true` на инструментах без побочных эффектов. См. [Добавление аннотаций инструментов](#add-tool-annotations). |

24| Обработать ошибки без остановки цикла | Верните `isError: true` вместо выброса исключения. См. [Обработка ошибок](#handle-errors). |24| Контролировать сообщение об ошибке, которое читает Claude | Верните `isError: true` для составления сообщения вместо выброса необработанного исключения. См. [Обработка ошибок](#handle-errors). |

25| Вернуть изображения или файлы | Используйте блоки `image` или `resource` в массиве содержимого. См. [Возврат изображений и ресурсов](#return-images-and-resources). |25| Вернуть изображения или файлы | Используйте блоки `image` или `resource` в массиве содержимого. См. [Возврат изображений и ресурсов](#return-images-and-resources). |

26| Вернуть результат в формате машиночитаемого JSON | Установите `structuredContent` на результат. См. [Возврат структурированных данных](#return-structured-data). |26| Вернуть результат в формате машиночитаемого JSON | Установите `structuredContent` на результат. См. [Возврат структурированных данных](#return-structured-data). |

27| Масштабировать до множества инструментов | Используйте [поиск инструментов](/ru/agent-sdk/tool-search) для загрузки инструментов по требованию. |27| Масштабировать до множества инструментов | Используйте [поиск инструментов](/ru/agent-sdk/tool-search) для загрузки инструментов по требованию. |


356 Обработка ошибок356 Обработка ошибок

357</h2>357</h2>

358 358 

359То, как ваш обработчик сообщает об ошибках, определяет, продолжается ли цикл агента или останавливается:359Ошибка обработчика не останавливает цикл агента. Встроенный MCP-сервер SDK перехватывает необработанные исключения и возвращает их как результаты ошибок, поэтому то, как вы сообщаете об ошибке, определяет, что видит Claude, а не то, завершится ли запрос ошибкой:

360 360 

361| Что происходит | Результат |361| Что происходит | Результат |

362| :---------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------ |362| :---------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

363| Обработчик выбрасывает неперехваченное исключение | Цикл агента останавливается. Claude никогда не видит ошибку, и вызов `query` завершается ошибкой. |363| Обработчик выбрасывает необработанное исключение | MCP-сервер преобразует его в результат ошибки с исходным сообщением об исключении. Claude видит это сообщение, и цикл агента продолжается. |

364| Обработчик перехватывает ошибку и возвращает `isError: true` (TS) / `"is_error": True` (Python) | Цикл агента продолжается. Claude видит ошибку как данные и может повторить попытку, попробовать другой инструмент или объяснить сбой. |364| Обработчик перехватывает ошибку и возвращает `isError: true` (TS) / `"is_error": True` (Python) | Claude видит сообщение, которое вы составили. Вы можете добавить контекст, которого не хватает исходному исключению, например какой запрос не удался или что попробовать вместо этого. |

365 365 

366Пример ниже перехватывает два вида сбоев внутри обработчика вместо того, чтобы позволить им выбросить исключение. Статус HTTP, отличный от 200, перехватывается из ответа и возвращается как результат ошибки. Ошибка сети или неверный JSON перехватываются окружающим `try/except` (Python) или `try/catch` (TypeScript) и также возвращаются как результат ошибки. В обоих случаях обработчик возвращается нормально и цикл агента продолжается.366В обоих случаях Claude может повторить попытку, попробовать другой инструмент или объяснить сбой. Перехватывайте ошибки самостоятельно, когда исходное сообщение об исключении недостаточно для того, чтобы Claude мог действовать.

367 

368Пример ниже перехватывает два вида сбоев внутри обработчика и составляет сообщение об ошибке, которое видит Claude. Статус HTTP, отличный от 200, перехватывается из ответа и возвращается как результат ошибки. Ошибка сети или неверный JSON перехватываются окружающим `try/except` (Python) или `try/catch` (TypeScript) и также возвращаются как результат ошибки. В обоих случаях Claude получает сообщение, которое описывает сбой, вместо простой строки исключения.

367 369 

368<CodeGroup>370<CodeGroup>

369 ```python Python theme={null}371 ```python Python theme={null}


397 data = response.json()399 data = response.json()

398 return {"content": [{"type": "text", "text": json.dumps(data, indent=2)}]}400 return {"content": [{"type": "text", "text": json.dumps(data, indent=2)}]}

399 except Exception as e:401 except Exception as e:

400 # Catching here keeps the agent loop alive. An uncaught exception402 # Composes the message Claude reads. An uncaught exception would

401 # would end the whole query() call.403 # reach Claude as the raw str(e) with no context.

402 return {404 return {

403 "content": [{"type": "text", "text": f"Failed to fetch data: {str(e)}"}],405 "content": [{"type": "text", "text": f"Failed to fetch data: {str(e)}"}],

404 "is_error": True,406 "is_error": True,


440 ]442 ]

441 };443 };

442 } catch (error) {444 } catch (error) {

443 // Catching here keeps the agent loop alive. An uncaught throw445 // Composes the message Claude reads. An uncaught throw would

444 // would end the whole query() call.446 // reach Claude as the raw error message with no context.

445 return {447 return {

446 content: [448 content: [

447 {449 {


461 Возврат изображений и ресурсов463 Возврат изображений и ресурсов

462</h2>464</h2>

463 465 

464Массив `content` в результате инструмента принимает блоки `text`, `image`, `audio`, `resource` и `resource_link`. Вы можете смешивать их в одном ответе. Блоки audio сохраняются на диск, и Claude получает текстовый блок с сохранённым путём файла. Блоки resource link преобразуются в текстовый блок, содержащий имя ссылки, URI и описание.466Массив `content` в результате инструмента принимает блоки `text`, `image`, `audio`, `resource` и `resource_link`. Вы можете смешивать их в одном ответе. В TypeScript блоки audio сохраняются на диск, и Claude получает текстовый блок с сохранённым путём файла; в Python SDK удаляет блоки audio из результата инструмента и регистрирует предупреждение. Блоки resource link преобразуются в текстовый блок, содержащий имя ссылки, URI и описание.

465 467 

466<h3 id="images">468<h3 id="images">

467 Изображения469 Изображения


535Блок ресурса встраивает часть содержимого, идентифицируемую по URI. URI — это метка для Claude, чтобы ссылаться на неё; фактическое содержимое находится в поле `text` или `blob` блока. Используйте это, когда ваш инструмент производит что-то, что имеет смысл адресовать по имени позже, например сгенерированный файл или запись из внешней системы.537Блок ресурса встраивает часть содержимого, идентифицируемую по URI. URI — это метка для Claude, чтобы ссылаться на неё; фактическое содержимое находится в поле `text` или `blob` блока. Используйте это, когда ваш инструмент производит что-то, что имеет смысл адресовать по имени позже, например сгенерированный файл или запись из внешней системы.

536 538 

537| Поле | Тип | Примечания |539| Поле | Тип | Примечания |

538| :------------------ | :----------- | :----------------------------------------------------------------- |540| :------------------ | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |

539| `type` | `"resource"` | |541| `type` | `"resource"` | |

540| `resource.uri` | `string` | Идентификатор содержимого. Любая схема URI |542| `resource.uri` | `string` | Идентификатор содержимого. Любая схема URI |

541| `resource.text` | `string` | Содержимое, если это текст. Предоставьте это или `blob`, но не оба |543| `resource.text` | `string` | Содержимое, если это текст. Предоставьте это или `blob`, но не оба |

542| `resource.blob` | `string` | Содержимое в кодировке base64, если это двоичное |544| `resource.blob` | `string` | Содержимое в кодировке base64, если это двоичное. Только TypeScript: Python SDK удаляет двоичные ресурсы из результата инструмента и регистрирует предупреждение |

543| `resource.mimeType` | `string` | Необязательно |545| `resource.mimeType` | `string` | Необязательно |

544 546 

545Этот пример показывает блок ресурса, возвращаемый из обработчика инструмента. URI `file:///tmp/report.md` — это метка, на которую Claude может ссылаться позже; SDK не читает из этого пути.547Этот пример показывает блок ресурса, возвращаемый из обработчика инструмента. URI `file:///tmp/report.md` — это метка, на которую Claude может ссылаться позже; SDK не читает из этого пути.

Details

250 250 

251* **Входные данные:** типизированный объект, содержащий детали события. Каждый тип hook имеет свою форму входных данных. Например, `PreToolUseHookInput` включает `tool_name` и `tool_input`, в то время как `NotificationHookInput` включает `message`. См. полные определения типов в справочниках [TypeScript](/ru/agent-sdk/typescript#hookinput) и [Python](/ru/agent-sdk/python#hookinput) SDK.251* **Входные данные:** типизированный объект, содержащий детали события. Каждый тип hook имеет свою форму входных данных. Например, `PreToolUseHookInput` включает `tool_name` и `tool_input`, в то время как `NotificationHookInput` включает `message`. См. полные определения типов в справочниках [TypeScript](/ru/agent-sdk/typescript#hookinput) и [Python](/ru/agent-sdk/python#hookinput) SDK.

252 * Все входные данные hook содержат `session_id`, `cwd` и `hook_event_name`.252 * Все входные данные hook содержат `session_id`, `cwd` и `hook_event_name`.

253 * `agent_id` и `agent_type` заполняются, когда hook срабатывает внутри подагента. В TypeScript они находятся на базовом входе hook и доступны для всех типов hook. В Python они находятся только на `PreToolUse`, `PostToolUse` и `PostToolUseFailure`.253 * `agent_id` и `agent_type` заполняются, когда hook срабатывает внутри подагента. В TypeScript они находятся на базовом входе hook и доступны для всех типов hook. В Python они являются необязательными полями на `PreToolUse`, `PostToolUse`, `PostToolUseFailure` и `PermissionRequest`, и обязательными полями на `SubagentStart` и `SubagentStop`.

254* **ID использования инструмента** (`str | None` / `string | undefined`): коррелирует события `PreToolUse` и `PostToolUse` для одного и того же вызова инструмента.254* **ID использования инструмента** (`str | None` / `string | undefined`): коррелирует события `PreToolUse` и `PostToolUse` для одного и того же вызова инструмента.

255* **Контекст:** в TypeScript содержит свойство `signal` (`AbortSignal`) для отмены. В Python этот аргумент зарезервирован для будущего использования.255* **Контекст:** в TypeScript содержит свойство `signal` (`AbortSignal`) для отмены. В Python этот аргумент зарезервирован для будущего использования.

256 256 

Details

189 Сеть189 Сеть

190</h3>190</h3>

191 191 

192SDK требует исходящий HTTPS к `api.anthropic.com` или к региональной конечной точке вашего поставщика при запуске на Bedrock или Vertex. Если ваши агенты используют [MCP servers](/ru/agent-sdk/mcp) или внешние инструменты, им также требуется исходящий доступ к этим конечным точкам. Для production маршрутизируйте исходящий трафик через прокси исходящего трафика, который обеспечивает списки разрешенных доменов, внедряет учетные данные и регистрирует запросы. См. [Безопасное развертывание](/ru/agent-sdk/secure-deployment) для полного паттерна.192SDK требует исходящий HTTPS к `api.anthropic.com` или к региональной конечной точке вашего поставщика при запуске на Amazon Bedrock или Google Cloud's Agent Platform. Если ваши агенты используют [MCP servers](/ru/agent-sdk/mcp) или внешние инструменты, им также требуется исходящий доступ к этим конечным точкам. Для production маршрутизируйте исходящий трафик через прокси исходящего трафика, который обеспечивает списки разрешенных доменов, внедряет учетные данные и регистрирует запросы. См. [Безопасное развертывание](/ru/agent-sdk/secure-deployment) для полного паттерна.

193 193 

194Для входящего трафика откройте порт HTTP или WebSocket на контейнере. Ваше приложение обрабатывает запросы клиентов на этом порту и вызывает SDK внутренне; сам подпроцесс не прослушивает сеть.194Для входящего трафика откройте порт HTTP или WebSocket на контейнере. Ваше приложение обрабатывает запросы клиентов на этом порту и вызывает SDK внутренне; сам подпроцесс не прослушивает сеть.

195 195 

Details

823 Тайм-ауты подключения823 Тайм-ауты подключения

824</h3>824</h3>

825 825 

826SDK MCP имеет тайм-аут по умолчанию 60 секунд для подключений сервера. Если ваш сервер требует больше времени для запуска, подключение не удастся. Для серверов, которым требуется больше времени на запуск, рассмотрите:826Подключения серверов MCP истекают по умолчанию через 30 секунд. Если ваш сервер требует больше времени для запуска, подключение не удастся. Увеличьте лимит с помощью переменной окружения [`MCP_TIMEOUT`](/ru/env-vars), в миллисекундах. Для серверов, которым требуется больше времени на запуск, также рассмотрите:

827 827 

828* Использование более лёгкого сервера, если доступно828* Использование более лёгкого сервера, если доступно

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

Details

152 152 

153* **CLI**: запустите `/config` и выберите стиль вывода153* **CLI**: запустите `/config` и выберите стиль вывода

154* **Параметры**: установите `outputStyle` в `.claude/settings.local.json`154* **Параметры**: установите `outputStyle` в `.claude/settings.local.json`

155* **TypeScript SDK**: установите `outputStyle` внутри встроенного объекта `settings`, передаваемого в `query()`, или укажите `settings` на файл параметров, который его устанавливает. `outputStyle` не является полем `Options` верхнего уровня155* **TypeScript SDK**: установите `outputStyle` внутри встроенного объекта `settings`, передаваемого в `query()`, или укажите `settings` на файл параметров, который его устанавливает. `outputStyle` не является полем `Options` верхнего уровня:

156 

157 ```typescript theme={null}

158 const options = { settings: { outputStyle: "Explanatory" } };

159 ```

156 160 

157Python SDK не имеет опции для программного выбора стиля вывода. Для развёртываний только с кодом, где вы не можете писать в `.claude/settings.local.json`, используйте `append` или пользовательскую строку подсказки вместо этого.161Python SDK не имеет опции для программного выбора стиля вывода. Для развёртываний только с кодом, где вы не можете писать в `.claude/settings.local.json`, используйте `append` или пользовательскую строку подсказки вместо этого.

158 162 

Details

212 212 

213CLI прикрепляет [атрибуты идентичности](/ru/monitoring-usage#standard-attributes) к каждому событию на основе учётных данных, которые он использует для вызова Anthropic. Когда вы создаёте приложение, которое обслуживает многих конечных пользователей из одного развёртывания, эти атрибуты идентифицируют учётные данные вашего сервиса, а не конечного пользователя, от имени которого действовал агент.213CLI прикрепляет [атрибуты идентичности](/ru/monitoring-usage#standard-attributes) к каждому событию на основе учётных данных, которые он использует для вызова Anthropic. Когда вы создаёте приложение, которое обслуживает многих конечных пользователей из одного развёртывания, эти атрибуты идентифицируют учётные данные вашего сервиса, а не конечного пользователя, от имени которого действовал агент.

214 214 

215Чтобы сделать вызовы инструментов и активность MCP атрибутируемыми конечным пользователям вашего приложения, внедрите идентичность конечного пользователя как атрибуты ресурсов при каждом вызове `query()`. Процентно-кодируйте значения перед интерполяцией, так как `OTEL_RESOURCE_ATTRIBUTES` [зарезервирует запятые, пробелы и знаки равенства](/ru/monitoring-usage#multi-team-organization-support). Следующий пример прикрепляет запрашивающего пользователя и тенанта к каждому span и событию из одного запроса:215Чтобы сделать вызовы инструментов и активность MCP атрибутируемыми конечным пользователям вашего приложения, внедрите идентичность конечного пользователя как атрибуты ресурсов при каждом вызове `query()`. Процентно-кодируйте значения перед интерполяцией, так как `OTEL_RESOURCE_ATTRIBUTES` [зарезервирует запятые, пробелы и знаки равенства](/ru/monitoring-usage#multi-team-organization-support). Следующий пример прикрепляет запрашивающего пользователя и тенанта к каждому span и событию из одного запроса. Он предполагает наличие объекта `request` из вашего веб-фреймворка, содержащего идентификаторы пользователя и тенанта:

216 216 

217<CodeGroup>217<CodeGroup>

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


237 ```237 ```

238</CodeGroup>238</CodeGroup>

239 239 

240С прикреплённой идентичностью конечного пользователя события `tool_decision`, `tool_result`, `mcp_server_connection` и `permission_mode_changed` становятся журналом аудита для каждого пользователя, который вы можете переслать на платформу Security Information and Event Management (SIEM). См. [Аудит событий безопасности](/ru/monitoring-usage#audit-security-events) в справочнике Monitoring для полного списка событий, связанных с безопасностью, и атрибутов, которые несёт каждое из них.240С прикреплённой идентичностью конечного пользователя события `tool_decision`, `tool_result`, `mcp_server_connection` и `permission_mode_changed`, которые экспортируются как записи журнала с префиксом `claude_code.`, становятся журналом аудита для каждого пользователя, который вы можете переслать на платформу Security Information and Event Management (SIEM). См. [Аудит событий безопасности](/ru/monitoring-usage#audit-security-events) в справочнике Monitoring для полного списка событий, связанных с безопасностью, и атрибутов, которые несёт каждое из них.

241 241 

242<h2 id="control-sensitive-data-in-exports">242<h2 id="control-sensitive-data-in-exports">

243 Контроль конфиденциальных данных в экспортах243 Контроль конфиденциальных данных в экспортах

Details

87 87 

88 * **Amazon Bedrock**: установите переменную окружения `CLAUDE_CODE_USE_BEDROCK=1` и настройте учетные данные AWS88 * **Amazon Bedrock**: установите переменную окружения `CLAUDE_CODE_USE_BEDROCK=1` и настройте учетные данные AWS

89 * **Claude Platform on AWS**: установите `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` и `ANTHROPIC_AWS_WORKSPACE_ID`, затем настройте учетные данные AWS89 * **Claude Platform on AWS**: установите `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` и `ANTHROPIC_AWS_WORKSPACE_ID`, затем настройте учетные данные AWS

90 * **Google Vertex AI**: установите переменную окружения `CLAUDE_CODE_USE_VERTEX=1` и настройте учетные данные Google Cloud90 * **Google Cloud's Agent Platform**: установите переменную окружения `CLAUDE_CODE_USE_VERTEX=1` и настройте учетные данные Google Cloud

91 * **Microsoft Azure**: установите переменную окружения `CLAUDE_CODE_USE_FOUNDRY=1` и настройте учетные данные Azure91 * **Microsoft Azure**: установите переменную окружения `CLAUDE_CODE_USE_FOUNDRY=1` и настройте учетные данные Azure

92 92 

93 См. руководства по настройке для [Bedrock](/ru/amazon-bedrock), [Claude Platform on AWS](/ru/claude-platform-on-aws), [Vertex AI](/ru/google-vertex-ai) или [Azure AI Foundry](/ru/microsoft-foundry) для получения подробной информации.93 См. руководства по настройке для [Amazon Bedrock](/ru/amazon-bedrock), [Claude Platform on AWS](/ru/claude-platform-on-aws), [Google Cloud's Agent Platform](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry) для получения подробной информации.

94 94 

95 <Note>95 <Note>

96 Если не одобрено ранее, Anthropic не разрешает сторонним разработчикам предлагать вход в claude.ai или ограничения скорости для своих продуктов, включая агентов, созданных на Claude Agent SDK. Вместо этого используйте методы аутентификации по API ключу, описанные в этом документе.96 Если не одобрено ранее, Anthropic не разрешает сторонним разработчикам предлагать вход в claude.ai или ограничения скорости для своих продуктов, включая агентов, созданных на Claude Agent SDK. Вместо этого используйте методы аутентификации по API ключу, описанные в этом документе.

Details

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

110 110 

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

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

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

114| `dontAsk` | Отклонение вместо запроса | Всё, что не предварительно одобрено `allowed_tools` или правилами, отклоняется; `canUseTool` никогда не вызывается |114| `dontAsk` | Отклонение вместо запроса | Всё, что не предварительно одобрено `allowed_tools` или правилами, отклоняется; `canUseTool` никогда не вызывается |

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

116| `bypassPermissions` | Обход всех проверок разрешений | Инструменты работают без запросов разрешений, если только явное правило [`ask`](#how-permissions-are-evaluated) не совпадает (используйте с осторожностью) |116| `bypassPermissions` | Обход всех проверок разрешений | Инструменты работают без запросов разрешений, если только явное правило [`ask`](#how-permissions-are-evaluated) не совпадает (используйте с осторожностью) |

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

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

119 119 

120<Warning>120<Warning>

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

Details

854class ClaudeAgentOptions:854class ClaudeAgentOptions:

855 tools: list[str] | ToolsPreset | None = None855 tools: list[str] | ToolsPreset | None = None

856 allowed_tools: list[str] = field(default_factory=list)856 allowed_tools: list[str] = field(default_factory=list)

857 system_prompt: str | SystemPromptPreset | None = None857 system_prompt: str | SystemPromptPreset | SystemPromptFile | None = None

858 mcp_servers: dict[str, McpServerConfig] | str | Path = field(default_factory=dict)858 mcp_servers: dict[str, McpServerConfig] | str | Path = field(default_factory=dict)

859 strict_mcp_config: bool = False859 strict_mcp_config: bool = False

860 permission_mode: PermissionMode | None = None860 permission_mode: PermissionMode | None = None


900| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |900| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

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

904| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | Конфигурации MCP server или путь к файлу конфигурации |904| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | Конфигурации MCP server или путь к файлу конфигурации |

905| `strict_mcp_config` | `bool` | `False` | Когда `True`, используйте только servers, переданные в `mcp_servers`, и игнорируйте проект `.mcp.json`, параметры пользователя, MCP servers, предоставленные plugins, и [claude.ai connectors](/ru/mcp#use-mcp-servers-from-claude-ai). Соответствует флагу CLI `--strict-mcp-config` |905| `strict_mcp_config` | `bool` | `False` | Когда `True`, используйте только servers, переданные в `mcp_servers`, и игнорируйте проект `.mcp.json`, параметры пользователя, MCP servers, предоставленные plugins, и [claude.ai connectors](/ru/mcp#use-mcp-servers-from-claude-ai). Соответствует флагу CLI `--strict-mcp-config` |

906| `permission_mode` | `PermissionMode \| None` | `None` | Режим разрешений для использования инструментов |906| `permission_mode` | `PermissionMode \| None` | `None` | Режим разрешений для использования инструментов |


910| `max_budget_usd` | `float \| None` | `None` | Остановите запрос, когда оценка стоимости на стороне клиента достигнет этого значения USD. Сравнивается с той же оценкой, что и `total_cost_usd`; см. [Track cost and usage](/ru/agent-sdk/cost-tracking) для предостережений точности |910| `max_budget_usd` | `float \| None` | `None` | Остановите запрос, когда оценка стоимости на стороне клиента достигнет этого значения USD. Сравнивается с той же оценкой, что и `total_cost_usd`; см. [Track cost and usage](/ru/agent-sdk/cost-tracking) для предостережений точности |

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

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

913| `model` | `str \| None` | `None` | Модель Claude для использования |913| `model` | `str \| None` | `None` | Модель Claude для использования. См. [accepted values and provider-specific IDs](/ru/model-config#available-models) |

914| `fallback_model` | `str \| None` | `None` | Резервная модель для использования, если основная модель не работает |914| `fallback_model` | `str \| None` | `None` | Резервная модель для использования, если основная модель не работает |

915| `betas` | `list[SdkBeta]` | `[]` | Функции бета-версии для включения. См. [`SdkBeta`](#sdkbeta) для доступных опций |915| `betas` | `list[SdkBeta]` | `[]` | Функции бета-версии для включения. См. [`SdkBeta`](#sdkbeta) для доступных опций |

916| `output_format` | `dict[str, Any] \| None` | `None` | Формат вывода для структурированных ответов (например, `{"type": "json_schema", "schema": {...}}`). См. [Structured outputs](/ru/agent-sdk/structured-outputs) для деталей |916| `output_format` | `dict[str, Any] \| None` | `None` | Формат вывода для структурированных ответов (например, `{"type": "json_schema", "schema": {...}}`). См. [Structured outputs](/ru/agent-sdk/structured-outputs) для деталей |


1002| `append` | Нет | Дополнительные инструкции для добавления к предустановленной системной подсказке |1002| `append` | Нет | Дополнительные инструкции для добавления к предустановленной системной подсказке |

1003| `exclude_dynamic_sections` | Нет | Переместите контекст для каждого сеанса, такой как рабочий каталог, статус git и пути памяти, из системной подсказки в первое пользовательское сообщение. Улучшает повторное использование кэша подсказок между пользователями и машинами. См. [Modify system prompts](/ru/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |1003| `exclude_dynamic_sections` | Нет | Переместите контекст для каждого сеанса, такой как рабочий каталог, статус git и пути памяти, из системной подсказки в первое пользовательское сообщение. Улучшает повторное использование кэша подсказок между пользователями и машинами. См. [Modify system prompts](/ru/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

1004 1004 

1005<h3 id="systempromptfile">

1006 `SystemPromptFile`

1007</h3>

1008 

1009Конфигурация для загрузки пользовательской системной подсказки из файла вместо передачи ее в виде строки. SDK сопоставляет это с флагом CLI [`--system-prompt-file`](/ru/cli-reference#system-prompt-flags). Используйте форму файла, когда подсказка большая: SDK передает строку `system_prompt` в argv подпроцесса CLI, что подвергается ограничениям длины командной строки ОС перед отправкой SDK любого запроса API. На Linux один аргумент длиннее примерно 128 КБ не работает при порождении процесса с `Argument list too long`. На Windows вся командная строка ограничена примерно 32 КБ, поэтому форма строки не работает при более низком пороге.

1010 

1011```python theme={null}

1012class SystemPromptFile(TypedDict):

1013 type: Literal["file"]

1014 path: str

1015```

1016 

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

1018| :----- | :---------- | :-------------------------------------------------- |

1019| `type` | Да | Должно быть `"file"` для загрузки подсказки с диска |

1020| `path` | Да | Путь к файлу, содержащему системную подсказку |

1021 

1005<h3 id="settingsource">1022<h3 id="settingsource">

1006 `SettingSource`1023 `SettingSource`

1007</h3>1024</h3>


1013```1030```

1014 1031 

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

1016| :---------- | :----------------------------------------------- | :---------------------------- |1033| :---------- | :------------------------------------------------------ | :---------------------------- |

1017| `"user"` | Глобальные параметры пользователя | `~/.claude/settings.json` |1034| `"user"` | Глобальные параметры пользователя | `~/.claude/settings.json` |

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

1019| `"local"` | Локальные параметры проекта (gitignored) | `.claude/settings.local.json` |1036| `"local"` | Локальные параметры проекта (не контролируемые версией) | `.claude/settings.local.json` |

1020 1037 

1021<h4 id="default-behavior">1038<h4 id="default-behavior">

1022 Поведение по умолчанию1039 Поведение по умолчанию


1192 "plan", # Planning mode - explore without editing1209 "plan", # Planning mode - explore without editing

1193 "dontAsk", # Deny anything not pre-approved instead of prompting1210 "dontAsk", # Deny anything not pre-approved instead of prompting

1194 "bypassPermissions", # Bypass permission checks; explicit ask rules still prompt (use with caution)1211 "bypassPermissions", # Bypass permission checks; explicit ask rules still prompt (use with caution)

1212 "auto", # A model classifier approves or denies each tool call

1195]1213]

1196```1214```

1197 1215 


1434Используйте с полем `betas` в `ClaudeAgentOptions` для включения функций бета-версии.1452Используйте с полем `betas` в `ClaudeAgentOptions` для включения функций бета-версии.

1435 1453 

1436<Warning>1454<Warning>

1437 Бета-версия `context-1m-2025-08-07` снята с производства по состоянию на 30 апреля 2026 года. Передача этого заголовка с Claude Sonnet 4.5 или Sonnet 4 не имеет эффекта, и запросы, превышающие стандартное окно контекста 200k-токенов, возвращают ошибку. Чтобы использовать окно контекста 1M-токенов, перейдите на [Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7 или Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), которые включают контекст 1M по стандартной цене без требования заголовка бета-версии.1455 Бета-версия `context-1m-2025-08-07` снята с производства по состоянию на 30 апреля 2026 года. Передача этого заголовка с Claude Sonnet 4.5 или Sonnet 4 не имеет эффекта, и запросы, превышающие стандартное окно контекста 200k-токенов, возвращают ошибку. Чтобы использовать окно контекста 1M-токенов, перейдите на [Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7 или Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), которые включают контекст 1M по стандартной цене без требования заголовка бета-версии.

1438</Warning>1456</Warning>

1439 1457 

1440<h3 id="mcpsdkserverconfig">1458<h3 id="mcpsdkserverconfig">


1755```1773```

1756 1774 

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

1758| :------------------- | :--------------- | :------------------------------------------------------------------------ |1776| :------------------- | :--------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1759| `uuid` | `str` | Уникальный идентификатор для этого события |1777| `uuid` | `str` | Уникальный идентификатор для этого события |

1760| `session_id` | `str` | Идентификатор сеанса |1778| `session_id` | `str` | Идентификатор сеанса |

1761| `event` | `dict[str, Any]` | Необработанные данные события потока Claude API |1779| `event` | `dict[str, Any]` | Необработанные данные события потока Claude API |

1762| `parent_tool_use_id` | `str \| None` | ID использования родительского инструмента, если это событие из подагента |1780| `parent_tool_use_id` | `str \| None` | Всегда `None`. События потока выдаются только для основного сеанса. Для атрибуции подагента используйте полные сообщения, такие как [`AssistantMessage`](#assistantmessage) |

1763 1781 

1764<h3 id="ratelimitevent">1782<h3 id="ratelimitevent">

1765 `RateLimitEvent`1783 `RateLimitEvent`


2393 tool_name: str2411 tool_name: str

2394 tool_input: dict[str, Any]2412 tool_input: dict[str, Any]

2395 permission_suggestions: NotRequired[list[Any]]2413 permission_suggestions: NotRequired[list[Any]]

2414 agent_id: NotRequired[str]

2415 agent_type: NotRequired[str]

2396```2416```

2397 2417 

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

2399| :----------------------- | :----------------------------- | :----------------------------------------- |2419| :----------------------- | :----------------------------- | :------------------------------------------------------------------------------ |

2400| `hook_event_name` | `Literal["PermissionRequest"]` | Всегда "PermissionRequest" |2420| `hook_event_name` | `Literal["PermissionRequest"]` | Всегда "PermissionRequest" |

2401| `tool_name` | `str` | Имя инструмента, запрашивающего разрешение |2421| `tool_name` | `str` | Имя инструмента, запрашивающего разрешение |

2402| `tool_input` | `dict[str, Any]` | Входные параметры для инструмента |2422| `tool_input` | `dict[str, Any]` | Входные параметры для инструмента |

2403| `permission_suggestions` | `list[Any]` (опционально) | Предложенные обновления разрешений из CLI |2423| `permission_suggestions` | `list[Any]` (опционально) | Предложенные обновления разрешений из CLI |

2424| `agent_id` | `str` (опционально) | Идентификатор подагента, присутствует, когда hooks срабатывает внутри подагента |

2425| `agent_type` | `str` (опционально) | Тип подагента, присутствует, когда hooks срабатывает внутри подагента |

2404 2426 

2405<h3 id="hookjsonoutput">2427<h3 id="hookjsonoutput">

2406 `HookJSONOutput`2428 `HookJSONOutput`

Details

121 121 

122 * **Amazon Bedrock**: установите переменную окружения `CLAUDE_CODE_USE_BEDROCK=1` и настройте учётные данные AWS122 * **Amazon Bedrock**: установите переменную окружения `CLAUDE_CODE_USE_BEDROCK=1` и настройте учётные данные AWS

123 * **Claude Platform on AWS**: установите `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` и `ANTHROPIC_AWS_WORKSPACE_ID`, затем настройте учётные данные AWS123 * **Claude Platform on AWS**: установите `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` и `ANTHROPIC_AWS_WORKSPACE_ID`, затем настройте учётные данные AWS

124 * **Google Vertex AI**: установите переменную окружения `CLAUDE_CODE_USE_VERTEX=1` и настройте учётные данные Google Cloud124 * **Google Cloud's Agent Platform**: установите переменную окружения `CLAUDE_CODE_USE_VERTEX=1` и настройте учётные данные Google Cloud

125 * **Microsoft Azure**: установите переменную окружения `CLAUDE_CODE_USE_FOUNDRY=1` и настройте учётные данные Azure125 * **Microsoft Azure**: установите переменную окружения `CLAUDE_CODE_USE_FOUNDRY=1` и настройте учётные данные Azure

126 126 

127 Подробности см. в руководствах по настройке для [Bedrock](/ru/amazon-bedrock), [Claude Platform on AWS](/ru/claude-platform-on-aws), [Vertex AI](/ru/google-vertex-ai) или [Azure AI Foundry](/ru/microsoft-foundry).127 Подробности см. в руководствах по настройке для [Amazon Bedrock](/ru/amazon-bedrock), [Claude Platform on AWS](/ru/claude-platform-on-aws), [Google Cloud's Agent Platform](/ru/google-vertex-ai), или [Microsoft Foundry](/ru/microsoft-foundry).

128 128 

129 <Note>129 <Note>

130 Если не было предварительного одобрения, Anthropic не разрешает сторонним разработчикам предлагать вход через claude.ai или ограничения скорости для своих продуктов, включая агентов, созданных на основе Claude Agent SDK. Вместо этого используйте методы аутентификации через API ключ, описанные в этом документе.130 Если не было предварительного одобрения, Anthropic не разрешает сторонним разработчикам предлагать вход через claude.ai или ограничения скорости для своих продуктов, включая агентов, созданных на основе Claude Agent SDK. Вместо этого используйте методы аутентификации через API ключ, описанные в этом документе.


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

369 369 

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

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

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

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

374| `dontAsk` | Отклоняет всё, что не в `allowedTools` | Заблокированные автономные агенты |374| `dontAsk` | Отклоняет всё, что не в `allowedTools` | Заблокированные автономные агенты |

375| `auto` (только TypeScript) | Классификатор модели одобряет или отклоняет каждый вызов инструмента | Автономные агенты с защитой безопасности |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) не совпадает | Изолированный CI, полностью доверенные окружения |

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

378 378 

Details

91 uuid: str # Unique identifier for this event91 uuid: str # Unique identifier for this event

92 session_id: str # Session identifier92 session_id: str # Session identifier

93 event: dict[str, Any] # The raw Claude API stream event93 event: dict[str, Any] # The raw Claude API stream event

94 parent_tool_use_id: str | None # Parent tool ID if from a subagent94 parent_tool_use_id: str | None # Always None

95 ```95 ```

96 96 

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


106 ```106 ```

107</CodeGroup>107</CodeGroup>

108 108 

109Поле `parent_tool_use_id` всегда имеет значение `None` в Python и `null` в TypeScript. События потока генерируются только для основной сессии; дельты на уровне токенов от подагентов не пересылаются. Чтобы атрибутировать вывод подагенту, используйте полные сообщения, которые содержат `parent_tool_use_id`. См. [Обнаружение вызова подагента](/ru/agent-sdk/subagents#detect-subagent-invocation).

110 

109Поле `event` содержит необработанное событие потоковой передачи из [Claude API](https://platform.claude.com/docs/en/build-with-claude/streaming#event-types). Распространенные типы событий включают:111Поле `event` содержит необработанное событие потоковой передачи из [Claude API](https://platform.claude.com/docs/en/build-with-claude/streaming#event-types). Распространенные типы событий включают:

110 112 

111| Тип события | Описание |113| Тип события | Описание |

Details

247 247 

248SDK поддерживает стандартные функции JSON Schema, включая все базовые типы (object, array, string, number, boolean, null), `enum`, `const`, `required`, вложенные объекты и определения `$ref`. Для полного списка поддерживаемых функций и ограничений см. [Ограничения JSON Schema](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs#json-schema-limitations).248SDK поддерживает стандартные функции JSON Schema, включая все базовые типы (object, array, string, number, boolean, null), `enum`, `const`, `required`, вложенные объекты и определения `$ref`. Для полного списка поддерживаемых функций и ограничений см. [Ограничения JSON Schema](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs#json-schema-limitations).

249 249 

250Схема, которая не является действительной JSON Schema, приводит к сбою запуска при запуске с ошибкой, указывающей на проблему. До версии 2.1.205 недействительная схема молча игнорировалась, и агент возвращал неструктурированный текст.

251 

252Ключевое слово `format`, такое как `"format": "email"`, принимается как аннотация и не применяется валидатором SDK. До версии 2.1.205 любая схема, содержащая `format`, рассматривалась как недействительная.

253 

250<h2 id="example-todo-tracking-agent">254<h2 id="example-todo-tracking-agent">

251 Пример: агент отслеживания TODO255 Пример: агент отслеживания TODO

252</h2>256</h2>

Details

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

235</Note>235</Note>

236 236 

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

238 

239Эта обработка частичного выхода требует Claude Code v2.1.199 или более поздней версии. В v2.1.199 ограничение скорости, перегрузка или ошибка сервера оставляли форму, содержащую только вызовы инструментов, с пустым частичным результатом, содержащим только примечание об отсечении.

238 240 

239<h2 id="invoke-subagents">241<h2 id="invoke-subagents">

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

Details

296</h4>296</h4>

297 297 

298| Свойство | Тип | Описание |298| Свойство | Тип | Описание |

299| :------------------- | :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------- |299| :------------------- | :---------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

300| `type` | `"user" \| "assistant"` | Роль сообщения |300| `type` | `"user" \| "assistant"` | Роль сообщения |

301| `uuid` | `string` | Уникальный идентификатор сообщения |301| `uuid` | `string` | Уникальный идентификатор сообщения |

302| `session_id` | `string` | Сессия, к которой принадлежит это сообщение |302| `session_id` | `string` | Сессия, к которой принадлежит это сообщение |

303| `message` | `unknown` | Необработанная полезная нагрузка сообщения из транскрипта |303| `message` | `unknown` | Необработанная полезная нагрузка сообщения из транскрипта |

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 306 

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

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


563 564 

564```typescript theme={null}565```typescript theme={null}

565interface Query extends AsyncGenerator<SDKMessage, void> {566interface Query extends AsyncGenerator<SDKMessage, void> {

566 interrupt(): Promise<void>;567 interrupt(): Promise<SDKControlInterruptResponse | undefined>;

567 rewindFiles(568 rewindFiles(

568 userMessageId: string,569 userMessageId: string,

569 options?: { dryRun?: boolean }570 options?: { dryRun?: boolean }


594 595 

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

596| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |597| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

598| `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) |

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

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


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

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

627 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` в файле настроек.

630 

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

629 632 

630Последовательные вызовы выполняют shallow-merge ключей верхнего уровня. Второй вызов с `{ permissions: {...} }` заменяет весь объект `permissions` из предыдущего вызова, а не выполняет deep-merge в него. Чтобы очистить ключ из слоя flag и вернуться к источникам с более низким приоритетом, передайте `null` для этого ключа. Передача `undefined` не имеет эффекта, потому что сериализация JSON её отбрасывает.633Последовательные вызовы выполняют shallow-merge ключей верхнего уровня. Второй вызов с `{ permissions: {...} }` заменяет весь объект `permissions` из предыдущего вызова, а не выполняет deep-merge в него. Чтобы очистить ключ из слоя flag и вернуться к источникам с более низким приоритетом, передайте `null` для этого ключа. Передача `undefined` не имеет эффекта, потому что сериализация JSON её отбрасывает.


693 696 

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

695 698 

699<h3 id="sdkcontrolinterruptresponse">

700 `SDKControlInterruptResponse`

701</h3>

702 

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

704 

705```typescript theme={null}

706type SDKControlInterruptResponse = {

707 still_queued: string[];

708};

709```

710 

711`still_queued` перечисляет UUID пользовательских сообщений, которые пережили прерывание: сообщения всё ещё в очереди, плюс любой пакет уже выведенный для следующего хода, но ещё не достижимый прерыванием. Каждое из них работает как свой собственный ход после прерывания, если вы его не отмените первым. Используйте квитанцию, чтобы решить, нужно ли что-то переотправлять; переотправка сообщения, которое уже указано, создаёт дублирующийся ход.

712 

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

714 

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

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

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

718 

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

720 

696<h3 id="agentdefinition">721<h3 id="agentdefinition">

697 `AgentDefinition`722 `AgentDefinition`

698</h3>723</h3>


1097 | SDKTaskStartedMessage1122 | SDKTaskStartedMessage

1098 | SDKTaskProgressMessage1123 | SDKTaskProgressMessage

1099 | SDKTaskUpdatedMessage1124 | SDKTaskUpdatedMessage

1125 | SDKBackgroundTasksChangedMessage

1100 | SDKSessionStateChangedMessage1126 | SDKSessionStateChangedMessage

1101 | SDKWorkerShuttingDownMessage1127 | SDKWorkerShuttingDownMessage

1102 | SDKCommandsChangedMessage1128 | SDKCommandsChangedMessage


1110 | SDKPromptSuggestionMessage1136 | SDKPromptSuggestionMessage

1111 | SDKAPIRetryMessage1137 | SDKAPIRetryMessage

1112 | SDKMirrorErrorMessage1138 | SDKMirrorErrorMessage

1113 | SDKInformationalMessage;1139 | SDKInformationalMessage

1140 | SDKConversationResetMessage;

1114```1141```

1115 1142 

1116<h3 id="sdkassistantmessage">1143<h3 id="sdkassistantmessage">


1273 output_style: string;1300 output_style: string;

1274 skills: string[];1301 skills: string[];

1275 plugins: { name: string; path: string }[];1302 plugins: { name: string; path: string }[];

1303 capabilities?: string[];

1276};1304};

1277```1305```

1278 1306 

1307{/* min-version: 2.1.205 */}

1308 

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

1310 

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

1312| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

1314 

1279<h3 id="sdkpartialassistantmessage">1315<h3 id="sdkpartialassistantmessage">

1280 `SDKPartialAssistantMessage`1316 `SDKPartialAssistantMessage`

1281</h3>1317</h3>

1282 1318 

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

1284 1320 

1285```typescript theme={null}1321```typescript theme={null}

1286type SDKPartialAssistantMessage = {1322type SDKPartialAssistantMessage = {


1421type SDKMessageOrigin =1457type SDKMessageOrigin =

1422 | { kind: "human" }1458 | { kind: "human" }

1423 | { kind: "channel"; server: string }1459 | { kind: "channel"; server: string }

1424 | { kind: "peer"; from: string; name?: string; senderTaskId?: string }1460 | {

1461 kind: "peer";

1462 from: string;

1463 name?: string;

1464 senderTaskId?: string;

1465 body?: string;

1466 }

1425 | { kind: "task-notification" }1467 | { kind: "task-notification" }

1426 | { kind: "coordinator" }1468 | { kind: "coordinator" }

1427 | { kind: "auto-continuation" };1469 | { kind: "auto-continuation" };

1428```1470```

1429 1471 

1430| `kind` | Значение |1472| `kind` | Значение |

1431| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1473| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1432| `human` | Прямой ввод от конечного пользователя. На пользовательских сообщениях отсутствующий `origin` также означает ввод человека. |1474| `human` | Прямой ввод от конечного пользователя. На пользовательских сообщениях отсутствующий `origin` также означает ввод человека. |

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

1434| `peer` | Сообщение от другого агента. Для внутрипроцессного [товарища по команде](/ru/agent-teams), отправляющего на `main` через `SendMessage`, `from` это имя товарища по команде и `senderTaskId` это его ID задачи. Для кросс-сеансового пира, такого как другой локальный процесс Claude Code, `from` это адрес отправителя и `senderTaskId` отсутствует. Поле `name` зарезервировано. |1476| `peer` | Сообщение от другого агента. Для внутрипроцессного [товарища по команде](/ru/agent-teams), отправляющего на `main` через `SendMessage`, `from` это имя товарища по команде и `senderTaskId` это его ID задачи. Для кросс-сеансового пира, такого как другой локальный процесс Claude Code, `from` это адрес отправителя и `senderTaskId` отсутствует. {/* min-version: 2.1.205 */}}`name` и `body` требуют Claude Code v2.1.205 или позже. `name` это отображаемое имя отправителя, нормализованное Claude Code: оно удаляет управляющие символы Unicode, формат, суррогаты и разделители строк или абзацев, затем обрезает результат и ограничивает его 64 кодовыми точками с многоточием. `body` это декодированное тело сообщения с удалённой оболочкой пира, побайтово совпадающее с тем, что видит модель. Для сообщения товарища по команде `body` всегда присутствует; для кросс-сеансового пира оно присутствует только когда ход точно представляет собой одну оболочку пира, сформированную Claude Code. Отобразите `name` и `body` вместо повторного анализа текста сообщения. |

1435| `task-notification` | Синтетический ход, внедрённый после завершения фоновой задачи. Смотрите [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |1477| `task-notification` | Синтетический ход, внедрённый после завершения фоновой задачи. Смотрите [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |

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

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


2357 2399 

2358```typescript theme={null}2400```typescript theme={null}

2359type ExitPlanModeInput = {2401type ExitPlanModeInput = {

2402 /** Устарело: больше не используется. */

2360 allowedPrompts?: Array<{2403 allowedPrompts?: Array<{

2361 tool: "Bash";2404 tool: "Bash";

2362 prompt: string;2405 prompt: string;


2364};2407};

2365```2408```

2366 2409 

2367Выходит из режима планирования. Опционально указывает разрешения на основе запроса, необходимые для реализации плана.2410Выходит из режима планирования. Поле `allowedPrompts` устарело и игнорируется; Claude Code всё ещё принимает его, чтобы существующие вызывающие стороны и транскрипты проходили валидацию. До v2.1.205 он запрашивал разрешения Bash на основе запроса для реализации плана.

2368 2411 

2369<h3 id="listmcpresources">2412<h3 id="listmcpresources">

2370 ListMcpResources2413 ListMcpResources


2408};2451};

2409```2452```

2410 2453 

2411Создаёт и входит во временный git worktree для изолированной работы. Передайте `path` для переключения в существующий worktree текущего репозитория вместо создания нового. `name` и `path` являются взаимоисключающими.2454Создаёт и входит во временный git worktree для изолированной работы. Передайте `path` для переключения в существующий worktree вместо создания нового. На первом входе целевой объект должен быть зарегистрированным worktree текущего репозитория или, в многорепозиторном рабочем пространстве, репозитория, вложенного внутри него; из сессии worktree он должен находиться под `.claude/worktrees/` репозитория сессии. `name` и `path` являются взаимоисключающими.

2412 2455 

2413<h2 id="tool-output-types">2456<h2 id="tool-output-types">

2414 Типы выходных данных Tool2457 Типы выходных данных Tool


3318 `CallToolResult`3361 `CallToolResult`

3319</h3>3362</h3>

3320 3363 

3321Тип результата MCP tool (из `@modelcontextprotocol/sdk/types.js`). `structuredContent` это объект JSON, который может быть возвращён вместе с `content`, включая блоки изображений и аудио. См. [Возврат структурированных данных](/ru/agent-sdk/custom-tools#return-structured-data).3364Тип результата MCP tool (из `@modelcontextprotocol/sdk/types.js`). `structuredContent` это объект JSON, который может быть возвращён вместе с `content`, включая блоки изображений. См. [Возврат структурированных данных](/ru/agent-sdk/custom-tools#return-structured-data).

3322 3365 

3323```typescript theme={null}3366```typescript theme={null}

3324type CallToolResult = {3367type CallToolResult = {


3656};3699};

3657```3700```

3658 3701 

3702<h3 id="sdkbackgroundtaskschangedmessage">

3703 `SDKBackgroundTasksChangedMessage`

3704</h3>

3705 

3706Выдаётся всякий раз, когда набор активных фоновых задач изменяется: задача начинается, завершается, убивается или переднеплановый агент переводится в фоновый режим. Массив `tasks` это полный активный набор. Замените любой кэшированный набор каждым payload вместо сопряжения событий `task_started` и `task_notification`, поэтому следующее изменение членства исправит любое событие, которое вы пропустили.

3707 

3708Порядок относительно этих событий для каждой задачи не определён, поэтому не коррелируйте два потока.

3709 

3710Ничего не выдаётся при запуске. Сбросьте на пустой набор всякий раз, когда процесс CLI сессии запускается или перезапускается, и позвольте следующему изменению членства переполнить его.

3711 

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

3713 

3714```typescript theme={null}

3715type SDKBackgroundTasksChangedMessage = {

3716 type: "system";

3717 subtype: "background_tasks_changed";

3718 tasks: {

3719 task_id: string;

3720 task_type: string;

3721 description: string;

3722 }[];

3723 uuid: UUID;

3724 session_id: string;

3725};

3726```

3727 

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

3660 `SDKFilesPersistedEvent`3729 `SDKFilesPersistedEvent`

3661</h3>3730</h3>


3745};3814};

3746```3815```

3747 3816 

3817<h3 id="sdkconversationresetmessage">

3818 `SDKConversationResetMessage`

3819</h3>

3820 

3821Выдаётся, когда диалог сессии заменяется без завершения сессии, например, после `/clear`, при выходе из режима плана или когда начинается новый диалог. Смонтируйте пустой транскрипт под `new_conversation_id` и отбросьте любой кэшированный заголовок сессии.

3822 

3823```typescript theme={null}

3824type SDKConversationResetMessage = {

3825 type: "conversation_reset";

3826 new_conversation_id: UUID;

3827 uuid: UUID;

3828 session_id: string;

3829};

3830```

3831 

3832{/* min-version: 2.1.203 */}Опубликованные типизации SDK объявляют `SDKConversationResetMessage` в Claude Code v2.1.203 и позже. До v2.1.203, `SDKMessage` ссылалась на тип без его объявления, поэтому сужение на `type === "conversation_reset"` не прошло проверку типов, когда `skipLibCheck` был отключён.

3833 

3748<h3 id="aborterror">3834<h3 id="aborterror">

3749 `AbortError`3835 `AbortError`

3750</h3>3836</h3>

Details

198</CodeGroup>198</CodeGroup>

199 199 

200<Note>200<Note>

201 В Python `can_use_tool` требует [режима потоковой передачи](/ru/agent-sdk/streaming-vs-single-mode) и hook `PreToolUse`, который возвращает `{"continue_": True}` для сохранения потока открытым. Без этого hook поток закроется до того, как callback разрешения сможет быть вызван.201 В Python `can_use_tool` требует [режима потоковой передачи](/ru/agent-sdk/streaming-vs-single-mode). Когда вы передаёте конечный поток сообщений через `query(prompt=generator)` или `ClaudeSDKClient.connect(prompt=async_iterable)`, SDK закрывает входной поток после последнего сообщения, прежде чем callback разрешения сможет быть вызван, если зарегистрированный hook или встроенный MCP-сервер не держит его открытым. Пример выше держит его открытым с помощью hook `PreToolUse`, который возвращает `{"continue_": True}`. Подключение без запроса и отправка сообщений через `ClaudeSDKClient.query()` держит поток открытым самостоятельно и не требует hook.

202</Note>202</Note>

203 203 

204Этот пример использует поток y/n, где любой ввод, отличный от `y`, рассматривается как отказ. На практике вы можете создать более богатый пользовательский интерфейс, который позволяет пользователям изменять запрос, предоставлять обратную связь или полностью перенаправлять Claude. Подробнее см. [Ответ на запросы инструментов](#respond-to-tool-requests).204Этот пример использует поток y/n, где любой ввод, отличный от `y`, рассматривается как отказ. На практике вы можете создать более богатый пользовательский интерфейс, который позволяет пользователям изменять запрос, предоставлять обратную связь или полностью перенаправлять Claude. Подробнее см. [Ответ на запросы инструментов](#respond-to-tool-requests).


6864. **Сопоставление ответов**: код проверяет, является ли ввод числовым (использует метку варианта) или свободным текстом (использует текст напрямую)6864. **Сопоставление ответов**: код проверяет, является ли ввод числовым (использует метку варианта) или свободным текстом (использует текст напрямую)

6875. **Возврат Claude**: ответ включает как исходный массив `questions`, так и сопоставление `answers`6875. **Возврат Claude**: ответ включает как исходный массив `questions`, так и сопоставление `answers`

688 688 

689Сохраните версию TypeScript как `ask.ts` и запустите её с помощью `npx tsx ask.ts`, или сохраните версию Python как `ask.py` и запустите её с помощью `python ask.py`.

690 

689<CodeGroup>691<CodeGroup>

690 ```python Python theme={null}692 ```python Python theme={null}

691 import asyncio693 import asyncio

agent-view.md +63 −19

Details

90 90 

91```text theme={null}91```text theme={null}

92Pinned92Pinned

93 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m93 ✽ clawd walk cycle Drawing the walk-cycle sprite frames 3m

94 94 

95Ready for review95Ready for review

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

97 97 

98Needs input98Needs input

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

100 100 

101Working101Working

102 ✽ collision detection Edit src/physics/CollisionSystem.ts 2m102 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m

103 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m103 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m

104 104 

105Completed105Completed


141 141 

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

143 143 

144Когда вы открываете сеанс, который перестал отвечать, супервизор перезапускает его процесс, и сеанс продолжает прерванный ответ с того места, где он остановился. Сеанс может оказаться в таком состоянии, когда машина переходит в спящий режим во время его ответа. Требуется Claude Code версии 2.1.200 или позже.

145 

144<h3 id="row-summaries">146<h3 id="row-summaries">

145 Резюме строк147 Резюме строк

146</h3>148</h3>

147 149 

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

151 

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

153 

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

149 155 

150Когда сеанс запускает два или более параллельных рабочих элемента, таких как subagents, фоновые команды shell или мониторы, перед текстом резюме появляется счётчик `done/total`, например `2/5`.156Ход, весь вывод которого не содержит букв или цифр, такой как сеанс [`/loop`](/ru/scheduled-tasks), который печатает одиночный символ на тихой итерации, сохраняет предыдущее резюме и состояние строки. До версии 2.1.205 этот ход был переклассифицирован и мог перевести сеанс, ожидающий вашего ввода, обратно в `Working`.

151 157 

152Каждое обновление — это один короткий запрос класса Haiku через вашего обычного поставщика, выставляемый и обрабатываемый в соответствии с теми же [условиями использования данных](/ru/data-usage), что и сам сеанс. На сторонних поставщиках, таких как Bedrock, Vertex AI, Microsoft Foundry и пользовательские шлюзы, запрос возвращается к основной модели сеанса, когда модель Haiku не настроена. Установите [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/ru/model-config#environment-variables) для выбора модели для этих резюме на этих поставщиках.158Резюме конца хода и каждая переписка в середине хода — это один короткий запрос класса Haiku через вашего обычного поставщика, выставляемый и обрабатываемый в соответствии с теми же [условиями использования данных](/ru/data-usage), что и сам сеанс. Обновления в течение 15 секунд между переписями модели повторно используют вывод самого сеанса и не отправляют запрос. На сторонних поставщиках, таких как Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и пользовательские шлюзы, запрос возвращается к основной модели сеанса, когда модель Haiku не настроена. Установите [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/ru/model-config#environment-variables) для выбора модели для этих резюме на этих поставщиках.

153 159 

154<h3 id="pull-request-status">160<h3 id="pull-request-status">

155 Статус pull request161 Статус pull request


157 163 

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

159 165 

160Когда сеанс открыл более одного pull request, метка показывает количество вместо этого, например `3 PRs`, окрашенное по открытому pull request, который больше всего нуждается во внимании. Откройте [панель просмотра](#peek-and-reply), чтобы увидеть их все.166Сеанс, который работает над существующим pull request, связан с ним таким же образом. Редактирование, комментирование, закрытие или отметка pull request как готового с помощью `gh` связывает pull request, который называет вывод самой команды, поэтому команда `gh`, чей захваченный вывод не называет pull request, не создаёт ссылку; `gh pr merge` — это обычный случай, потому что он печатает результат только в интерактивный терминал. Проверка pull request с помощью `gh pr checkout` или отправка в ветку, которая имеет открытый pull request, связывает его, ища эту ветку с помощью `gh pr view` вместо этого. До версии 2.1.205 только pull request, которые сеанс создал или проверил, были связаны, и отправка связывала один только когда имя локальной ветки совпадало.

167 

168Claude Code читает pull request из полного вывода команды, включая часть, сохранённую в файл, когда вывод команды превышает встроенный лимит. До версии 2.1.205 pull request, созданный в вызове Bash, чей вывод превышал примерно 30 000 символов, не был связан.

169 

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

161 171 

162Номер pull request окрашен в соответствии с его статусом:172Номер pull request окрашен в соответствии с его статусом:

163 173 


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

175</h3>185</h3>

176 186 

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

178 188 

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

180 190 

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

182 192 

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

184 194 

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

186 196 

187<h3 id="attach-to-a-session">197<h3 id="attach-to-a-session">

188 Подключение к сеансу198 Подключение к сеансу


206 216 

207Если инструмент работает, когда вы нажимаете `←`, Claude Code ждёт примерно десять секунд, чтобы он завершился, прежде чем отправить сеанс в фон, и ответ продолжается в фоновом сеансе. Нажмите `←` снова, чтобы отправить в фон немедленно вместо ожидания. Когда выполняемая работа не может перейти в фоновый сеанс, сначала появляется диалог `Background this session?`, как и с [`/background`](#from-inside-a-session).217Если инструмент работает, когда вы нажимаете `←`, Claude Code ждёт примерно десять секунд, чтобы он завершился, прежде чем отправить сеанс в фон, и ответ продолжается в фоновом сеансе. Нажмите `←` снова, чтобы отправить в фон немедленно вместо ожидания. Когда выполняемая работа не может перейти в фоновый сеанс, сначала появляется диалог `Background this session?`, как и с [`/background`](#from-inside-a-session).

208 218 

209Строка создаётся даже из свежего сеанса без истории разговора, поэтому `` возвращает к ней. Когда эта строка единственная, agent view показывает подсказку адаптации ниже неё.219Десятисекундный лимит не применяется, пока работают [subagents](/ru/sub-agents). Claude Code продолжает ждать, чтобы их работа перешла, и показывает уведомление `Still backgrounding after the current tool`, пока ждёт; нажмите `←` снова, чтобы отправить в фон без ожидания, что перезапустит subagents с начала. До версии 2.1.203 ожидание заканчивалось через десять секунд и работающие subagents перезапускались с начала без предупреждения.

220 

221Строка создаётся даже из свежего сеанса без истории разговора, поэтому `→` возвращает к ней. {/* max-version: 2.1.202 */}До версии 2.1.203, agent view показывал подсказку адаптации ниже этой строки, когда она была единственной.

210 222 

211Вы можете отключить это сочетание клавиш с помощью параметра `leftArrowOpensAgents` в `/config`.223Вы можете отключить это сочетание клавиш с помощью параметра `leftArrowOpensAgents` в `/config`.

212 224 


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

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

304 316 

305Skills, ваши собственные команды и расширяющие подсказку встроенные команды, такие как `/init`, отправляются в новый фоновый сеанс как его первая подсказка. Другие встроенные команды показывают подсказку `attach to a session to run it` вместо этого.317Skills, ваши собственные команды и расширяющие подсказку встроенные команды, такие как `/init`, отправляются в новый фоновый сеанс как его первая подсказка. Другие встроенные команды показывают подсказку `attach to a session to run it` вместо этого. {/* min-version: 2.1.203 */}Всё, что вы вводили, остаётся в поле ввода рядом с подсказкой, чтобы вы могли отредактировать его. До версии 2.1.203 подсказка очищала ввод и введённый текст был потерян.

306 318 

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

308 320 


315Новый сеанс запускается в каталоге, из которого вы открыли agent view. Для целевого другого каталога используйте любой из этих способов:327Новый сеанс запускается в каталоге, из которого вы открыли agent view. Для целевого другого каталога используйте любой из этих способов:

316 328 

317* Откройте `claude agents` в этом каталоге.329* Откройте `claude agents` в этом каталоге.

318* Откройте `claude agents` в родительском каталоге и упомяните дочерний репозиторий с `@<repo>` в подсказке. Введите `@` для отображения git репозиториев на один уровень ниже каталога запуска, плюс любой каталог, который уже имеет сеанс в списке. Каталог, имя которого содержит пробел, не указывается.330* Откройте `claude agents` в родительском каталоге и упомяните дочерний репозиторий с `@<repo>` в подсказке. Введите `@` для отображения этих целей:

331 

332 * Git репозитории на один уровень ниже каталога запуска

333 * Зарегистрированные [git worktrees](/ru/worktrees) репозитория, из которого вы запустили, которые находятся внутри его дерева каталогов, такие как те, которые Claude создаёт под `.claude/worktrees/`, помеченные их проверенной ветвью. Worktrees, добавленные вне репозитория, такие как `git worktree add ../feature`, не указываются

334 * Любой каталог, который уже имеет сеанс в списке

335 

336 Каталог, имя которого содержит пробел, не указывается. {/* min-version: 2.1.203 */}До версии 2.1.203 зарегистрированные worktrees не указывались, поэтому отправка в один означала запуск `claude --bg` из каталога этого worktree.

319* Из оболочки выполните `cd` в каталог и запустите `claude --bg "<prompt>"`.337* Из оболочки выполните `cd` в каталог и запустите `claude --bg "<prompt>"`.

320 338 

321Когда agent view сгруппирован по каталогу, каталог выделенной строки становится целью отправки, поэтому вы можете прокрутить к группе и отправить в неё без переввода пути.339Когда agent view сгруппирован по каталогу, каталог выделенной строки становится целью отправки, поэтому вы можете прокрутить к группе и отправить в неё без переввода пути.


425 443 

426Вне git репозитория сеансы пишут в рабочий каталог напрямую и не изолированы друг от друга, поэтому избегайте отправки параллельных сеансов, которые редактируют одни и те же файлы. Если вы используете другую систему контроля версий, настройте [`WorktreeCreate` hook](/ru/worktrees#non-git-version-control) и Claude изолирует правки так же, как это делает для git.444Вне git репозитория сеансы пишут в рабочий каталог напрямую и не изолированы друг от друга, поэтому избегайте отправки параллельных сеансов, которые редактируют одни и те же файлы. Если вы используете другую систему контроля версий, настройте [`WorktreeCreate` hook](/ru/worktrees#non-git-version-control) и Claude изолирует правки так же, как это делает для git.

427 445 

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

447 

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

429 449 

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


464 484 

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

466 486 

467Выбор облачного поставщика, такой как `CLAUDE_CODE_USE_BEDROCK` или `CLAUDE_CODE_USE_VERTEX`, и псевдонимы `ANTHROPIC_DEFAULT_*_MODEL` следуют оболочке, которая отправила сеанс. Переменные конечной точки шлюза, такие как `ANTHROPIC_BASE_URL` и его парный `ANTHROPIC_AUTH_TOKEN`, не следуют. См. [supervisor process](#the-supervisor-process) для того, как фоновые сеансы получают параметры поставщика и учётные данные.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) для того, как фоновые сеансы получают параметры поставщика и учётные данные.

468 488 

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

470 490 

471Permission mode, модель и усилие, с которыми вы запускаете фоновый сеанс, наряду с [флагами конфигурации, которые он переносит](#from-inside-a-session), все сохраняются, когда supervisor позже [останавливает и перезапускает](#the-supervisor-process) процесс сеанса. Сеанс, который вы запустили с помощью `claude --bg --dangerously-skip-permissions` или `claude --bg --permission-mode bypassPermissions`, остаётся в `bypassPermissions` после этого перезапуска вместо возврата к `defaultMode` каталога, и модель или усилие, которые вы изменили во время сеанса с помощью `/model` или `/effort`, сохраняются.491Permission mode, модель и усилие, с которыми вы запускаете фоновый сеанс, наряду с [флагами конфигурации, которые он переносит](#from-inside-a-session), все сохраняются, когда supervisor позже [останавливает и перезапускает](#the-supervisor-process) процесс сеанса. Сеанс, который вы запустили с помощью `claude --bg --dangerously-skip-permissions` или `claude --bg --permission-mode bypassPermissions`, остаётся в `bypassPermissions` после этого перезапуска вместо возврата к `defaultMode` каталога, и модель или усилие, которые вы изменили во время сеанса с помощью `/model` или `/effort`, сохраняются.

472 492 

493Усилие, которое сеанс взял из параметра [`effortLevel` setting](/ru/settings#available-settings) вместо `--effort` или `/effort`, не фиксируется при отправке: каждый процесс, запущенный для сеанса, читает параметр снова, поэтому редактирование `effortLevel` в `settings.json` достигает сеансов, которые вы переводите в фон с помощью `←` или `/bg`, и их более поздних перезапусков. До версии 2.1.203 переведение сеанса в фон записывало его усилие, полученное из параметров, как если бы вы передали `--effort`, поэтому более поздние правки `effortLevel` никогда не достигали его.

494 

495Имя, которое вы установили с помощью [`/rename`](/ru/commands) или `Ctrl+R`, также сохраняется при этом перезапуске, поэтому [`claude --resume <name>`](/ru/sessions#name-your-sessions) по-прежнему разрешает сеанс. До версии 2.1.202 перезапуск возвращал сеанс к имени, с которым он был отправлен, и новое имя перестало разрешаться.

496 

473Чтобы установить стандартные значения для каждого сеанса, который вы отправляете из agent view, передайте любой из `--permission-mode`, `--model`, `--effort` или `--agent` при открытии его:497Чтобы установить стандартные значения для каждого сеанса, который вы отправляете из agent view, передайте любой из `--permission-mode`, `--model`, `--effort` или `--agent` при открытии его:

474 498 

475```bash theme={null}499```bash theme={null}


544 568 

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

546 570 

547Фоновый сеанс не наследует переменные конечной точки шлюза, такие как `ANTHROPIC_BASE_URL`, эквивалентные переменные базового URL Bedrock, Vertex и Foundry, или парный `ANTHROPIC_AUTH_TOKEN` из оболочки, которая запустила супервизор, или из отправляющей оболочки. Сеанс использует ваши сохранённые учётные данные и любые значения `env` в [параметрах](/ru/settings) каталога проекта вместо этого. Чтобы указать фоновые сеансы в проекте на [шлюз LLM](/ru/llm-gateway), установите `ANTHROPIC_BASE_URL` в блоке `env` файла `.claude/settings.json` этого проекта, а не экспортируйте его в вашей оболочке.571`PATH` отправляющей оболочки применяется к рабочему процессу так же, поэтому команды оболочки, которые запускает сеанс, находят те же инструменты, что и ваш терминал. До версии 2.1.203 фоновый сеанс сохранял `PATH` оболочки, которая первой запустила супервизор, поэтому инструменты, добавленные в ваш `PATH` с тех пор, могли отсутствовать, чаще всего на Windows.

572 

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` этого проекта.

574 

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.

576 

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

548 578 

549Каждый фоновый сеанс — это его собственный процесс Claude Code, управляемый супервизором, а не привязанный к вашему терминалу. Сеанс, который активно работает, ждёт вашего ввода или имеет подключённый терминал, сохраняет свой процесс работающим. Работающая фоновая команда оболочки, подагент, динамический рабочий процесс или монитор считаются активной работой, поэтому долгоживущий процесс, такой как сервер разработки, поддерживает сеанс в активном состоянии.579Каждый фоновый сеанс — это его собственный процесс Claude Code, управляемый супервизором, а не привязанный к вашему терминалу. Сеанс, который активно работает, ждёт вашего ввода или имеет подключённый терминал, сохраняет свой процесс работающим. Работающая фоновая команда оболочки, подагент, динамический рабочий процесс или монитор считаются активной работой, поэтому долгоживущий процесс, такой как сервер разработки, поддерживает сеанс в активном состоянии.

550 580 


570 600 

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

572 602 

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

604 

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

574 Где хранится состояние606 Где хранится состояние

575</h3>607</h3>


585 617 

586Каждый фоновый сеанс имеет переменную окружения `CLAUDE_JOB_DIR`, установленную в его каталог `~/.claude/jobs/<id>`, поэтому команды оболочки, которые запускает сеанс, могут записывать временные файлы в `$CLAUDE_JOB_DIR/tmp` без конфликтов с параллельными сеансами.618Каждый фоновый сеанс имеет переменную окружения `CLAUDE_JOB_DIR`, установленную в его каталог `~/.claude/jobs/<id>`, поэтому команды оболочки, которые запускает сеанс, могут записывать временные файлы в `$CLAUDE_JOB_DIR/tmp` без конфликтов с параллельными сеансами.

587 619 

588Чтобы проверить это состояние без прямого чтения файлов, запустите `claude daemon status`. Он сообщает, доступен ли супервизор, его идентификатор процесса и версию, каталог сокета и сколько фоновых сеансов активны. `/doctor` включает сводку той же проверки.620Чтобы проверить это состояние без прямого чтения файлов, запустите `claude daemon status`. Он сообщает, доступен ли супервизор, его идентификатор процесса и версию, каталог сокета и сколько фоновых сеансов активны.

589 621 

590Команда также предупреждает, когда работающий супервизор находится на другой версии, чем `claude`, который вы вызвали, что происходит после обновления, в которое супервизор ещё не перезагрузился. Предупреждение показывает обе версии и говорит вам запустить `claude daemon stop --any` для получения новой версии. Когда Claude Code установлен как служба ОС, предлагаемая команда — это `claude daemon stop` без флага.622Команда также предупреждает, когда работающий супервизор находится на другой версии, чем `claude`, который вы вызвали, что происходит после обновления, в которое супервизор ещё не перезагрузился. Предупреждение показывает обе версии и говорит вам запустить `claude daemon stop --any` для получения новой версии. Когда Claude Code установлен как служба ОС, предлагаемая команда — это `claude daemon stop` без флага.

591 623 

592Сеансы сохраняют эту версию несовпадения нетронутыми: более старая версия Claude Code, которая обновляет `state.json` сеанса, сохраняет поля, которые она не распознаёт, и сохраняет сеанс в списке.624Сеансы сохраняют эту версию несовпадения нетронутыми: более старая версия Claude Code, которая обновляет `state.json` сеанса, сохраняет поля, которые она не распознаёт, и сохраняет сеанс в списке. {/* min-version: 2.1.200 */}Список сеансов в `roster.json` следует тому же правилу: более старая версия, которая переписывает его, сохраняет поля, которые написала более новая версия, поэтому сеансы, запущенные более новой версией, остаются доступными и продолжают принимать ввод после перезагрузки супервизора. До версии 2.1.200 более старые версии могли удалить эти поля при переписывании.

593 625 

594На Windows `claude daemon status` выводит основную ошибку файла, когда файл ключа pipe супервизора заблокирован или нечитаем, вместо того чтобы сообщать об общей ошибке подключения.626На Windows `claude daemon status` выводит основную ошибку файла, когда файл ключа pipe супервизора заблокирован или нечитаем, вместо того чтобы сообщать об общей ошибке подключения.

595 627 


615 Agent view открывается без сеансов647 Agent view открывается без сеансов

616</h3>648</h3>

617 649 

618До отправки вашего первого сеанса представление агентов показывает краткую подсказку адаптации с примерами подсказок вместо списка сеансов. Введите подсказку в поле ввода внизу и нажмите `Enter`, чтобы отправить ваш первый сеанс.650До отправки вашего первого сеанса представление агентов показывает пустые заголовки разделов с описанием под каждым, плюс однострочное объяснение над вводом вместо списка сеансов. Введите подсказку в поле ввода внизу и нажмите `Enter`, чтобы отправить ваш первый сеанс.

619 651 

620<h3 id="backgrounding-shows-a-background-this-session-dialog">652<h3 id="backgrounding-shows-a-background-this-session-dialog">

621 Backgrounding показывает диалог `Background this session?`653 Backgrounding показывает диалог `Background this session?`


637 669 

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

639 671 

672<h3 id="opening-a-session-says-the-conversation-is-already-open">

673 Открытие сеанса говорит, что беседа уже открыта

674</h3>

675 

676Открытие остановленной строки, чья беседа также открыта другим работающим неинтерактивным процессом Claude Code, например фоновым рабочим процессом для той же беседы, который всё ещё завершается, показывает `This conversation is already open in another running Claude session` вместо запуска процесса строки, потому что два процесса не могут писать в один и тот же транскрипт. Ответьте в сеансе, который уже имеет открытую беседу, или выйдите из него и откройте строку снова. Ответ, который вы набрали при отказе, не потеряется; он будет отправлен при следующем запуске сеанса.

677 

678До версии 2.1.203 это состояние запускало второй процесс в любом случае. Этот процесс завершался с ошибкой `currently running as a background agent` и строка отображалась как неудачная.

679 

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

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

642</h3>682</h3>


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

731 771 

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

733| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |773| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

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 секунд сеанс, который перезагружается, со строкой статуса, указывающей причину, вместо сбоя. |

775| 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` в фоновом сеансе, сохраняется при остановке и перезапуске процесса супервизора вместо возврата к имени, с которым был отправлен сеанс. |

777| v2.1.200 | {/* min-version: 2.1.200 */}Более старая версия Claude Code, которая переписывает список сеансов в `roster.json`, сохраняет поля, написанные более новой версией, соответствуя существующей гарантии `state.json`, поэтому сеансы, запущенные более новой версией, продолжают принимать ввод после перезапуска супервизора. Когда вы открываете сеанс, который перестал отвечать, супервизор перезапускает его процесс и сеанс продолжает прерванный ответ с того места, где он остановился. |

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

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

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

amazon-bedrock.md +36 −36

Details

82 Предварительные требования82 Предварительные требования

83</h2>83</h2>

84 84 

85Перед настройкой Claude Code с Bedrock убедитесь, что у вас есть:85Перед настройкой Claude Code с Amazon Bedrock убедитесь, что у вас есть:

86 86 

87* Учетная запись AWS с включенным доступом к Bedrock87* Учетная запись AWS с включенным доступом к Amazon Bedrock

88* Доступ к нужным моделям Claude (например, Claude Sonnet 4.6) в Bedrock88* Доступ к нужным моделям Claude (например, Claude Sonnet 4.6) в Amazon Bedrock

89* AWS CLI установлен и настроен (опционально - требуется только если у вас нет другого механизма получения учетных данных)89* AWS CLI установлен и настроен (опционально - требуется только если у вас нет другого механизма получения учетных данных)

90* Соответствующие разрешения IAM90* Соответствующие разрешения IAM

91 91 

92Чтобы войти со своими собственными учетными данными Bedrock, следуйте инструкциям [Вход с Bedrock](#sign-in-with-bedrock) ниже. Чтобы развернуть Claude Code в команде, используйте шаги [ручной установки](#set-up-manually) и [закрепите версии вашей модели](#4-pin-model-versions) перед развертыванием.92Чтобы войти со своими собственными учетными данными Amazon Bedrock, следуйте инструкциям [Вход с Amazon Bedrock](#sign-in-with-bedrock) ниже. Чтобы развернуть Claude Code в команде, используйте шаги [ручной установки](#set-up-manually) и [закрепите версии вашей модели](#4-pin-model-versions) перед развертыванием.

93 93 

94<h2 id="sign-in-with-bedrock">94<h2 id="sign-in-with-bedrock">

95 Вход с Bedrock95 Вход с Bedrock

96</h2>96</h2>

97 97 

98Если у вас есть учетные данные AWS и вы хотите начать использовать Claude Code через Bedrock, мастер входа проведет вас через процесс. Вы выполняете предварительные требования на стороне AWS один раз на учетную запись; мастер обрабатывает сторону Claude Code.98Если у вас есть учетные данные AWS и вы хотите начать использовать Claude Code через Amazon Bedrock, мастер входа проведет вас через процесс. Вы выполняете предварительные требования на стороне AWS один раз на учетную запись; мастер обрабатывает сторону Claude Code.

99 99 

100<Steps>100<Steps>

101 <Step title="Включите модели Anthropic в вашей учетной записи AWS">101 <Step title="Включите модели Anthropic в вашей учетной записи AWS">

102 В [консоли Amazon Bedrock](https://console.aws.amazon.com/bedrock/) откройте каталог моделей, выберите модель Anthropic и отправьте форму варианта использования. Доступ предоставляется сразу же после отправки. См. [Отправьте детали варианта использования](#1-submit-use-case-details) для AWS Organizations и [конфигурацию IAM](#iam-configuration) для разрешений, которые требуются вашей роли.102 В [консоли Amazon Bedrock](https://console.aws.amazon.com/bedrock/) откройте каталог моделей, выберите модель Anthropic и отправьте форму варианта использования. Доступ предоставляется сразу же после отправки. См. [Отправьте детали варианта использования](#1-submit-use-case-details) для AWS Organizations и [конфигурацию IAM](#iam-configuration) для разрешений, которые требуются вашей роли.

103 </Step>103 </Step>

104 104 

105 <Step title="Запустите Claude Code и выберите Bedrock">105 <Step title="Запустите Claude Code и выберите Amazon Bedrock">

106 Запустите `claude`. При запросе входа выберите **3rd-party platform**, затем **Amazon Bedrock**.106 Запустите `claude`. При запросе входа выберите **3rd-party platform**, затем **Amazon Bedrock**.

107 </Step>107 </Step>

108 108 

109 <Step title="Следуйте подсказкам мастера">109 <Step title="Следуйте подсказкам мастера">

110 Выберите способ аутентификации в AWS: профиль AWS, обнаруженный из вашей директории `~/.aws`, ключ API Bedrock, ключ доступа и секрет, или учетные данные уже в вашей среде. Мастер выбирает ваш регион, проверяет, какие модели Claude может вызывать ваша учетная запись, и позволяет вам их закрепить. Он сохраняет результат в блок `env` вашего [файла параметров пользователя](/ru/settings), поэтому вам не нужно самостоятельно экспортировать переменные окружения.110 Выберите способ аутентификации в AWS: профиль AWS, обнаруженный из вашей директории `~/.aws`, ключ API Amazon Bedrock, ключ доступа и секрет, или учетные данные уже в вашей среде. Мастер выбирает ваш регион, проверяет, какие модели Claude может вызывать ваша учетная запись, и позволяет вам их закрепить. Он сохраняет результат в блок `env` вашего [файла параметров пользователя](/ru/settings), поэтому вам не нужно самостоятельно экспортировать переменные окружения.

111 </Step>111 </Step>

112</Steps>112</Steps>

113 113 


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

118</h2>118</h2>

119 119 

120Чтобы настроить Bedrock через переменные окружения вместо мастера, например в CI или при развертывании в масштабе предприятия, следуйте шагам ниже.120Чтобы настроить Amazon Bedrock через переменные окружения вместо мастера, например в CI или при развертывании в масштабе предприятия, следуйте шагам ниже.

121 121 

122<h3 id="1-submit-use-case-details">122<h3 id="1-submit-use-case-details">

123 1. Отправьте детали варианта использования123 1. Отправьте детали варианта использования


168 168 

169[Узнайте больше](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html) о `aws login`.169[Узнайте больше](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html) о `aws login`.

170 170 

171**Вариант E: ключи API Bedrock**171**Вариант E: ключи API Amazon Bedrock**

172 172 

173```bash theme={null}173```bash theme={null}

174export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key174export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

175```175```

176 176 

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

178 178 

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

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


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

186 186 

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

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

189 189 

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

191 Пример конфигурации191 Пример конфигурации


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

228</h3>228</h3>

229 229 

230Установите следующие переменные окружения для включения Bedrock:230Установите следующие переменные окружения для включения Amazon Bedrock:

231 231 

232```bash theme={null}232```bash theme={null}

233# Enable Bedrock integration233# Enable Bedrock integration


243# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com243# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

244```244```

245 245 

246При включении Bedrock для Claude Code имейте в виду следующее:246При включении Amazon Bedrock для Claude Code имейте в виду следующее:

247 247 

248* {/* min-version: 2.1.172 */}Начиная с версии 2.1.172, вам нужно установить `AWS_REGION` только для переопределения региона вашего профиля AWS или когда ваш профиль не имеет региона. Claude Code разрешает регион в этом порядке:248* {/* min-version: 2.1.172 */}Начиная с версии 2.1.172, вам нужно установить `AWS_REGION` только для переопределения региона вашего профиля AWS или когда ваш профиль не имеет региона. Claude Code разрешает регион в этом порядке:

249 249 


253 * `us-east-1`253 * `us-east-1`

254 254 

255 Активный профиль — это `AWS_PROFILE`, если установлен, иначе `default`. Установите `AWS_SHARED_CREDENTIALS_FILE` или `AWS_CONFIG_FILE` для указания на пути к файлам, отличные от стандартных. Запустите `/status` для просмотра разрешенного региона. Когда регион поступил из ваших файлов конфигурации AWS или стандартного резервного варианта, `/status` также указывает источник. На версии 2.1.171 и более ранних Claude Code не читает файлы конфигурации AWS, поэтому установите `AWS_REGION` явно.255 Активный профиль — это `AWS_PROFILE`, если установлен, иначе `default`. Установите `AWS_SHARED_CREDENTIALS_FILE` или `AWS_CONFIG_FILE` для указания на пути к файлам, отличные от стандартных. Запустите `/status` для просмотра разрешенного региона. Когда регион поступил из ваших файлов конфигурации AWS или стандартного резервного варианта, `/status` также указывает источник. На версии 2.1.171 и более ранних Claude Code не читает файлы конфигурации AWS, поэтому установите `AWS_REGION` явно.

256* При использовании Bedrock команда `/logout` недоступна, так как аутентификация обрабатывается через учетные данные AWS.256* При использовании Amazon Bedrock команда `/logout` недоступна, так как аутентификация обрабатывается через учетные данные AWS.

257* Инструмент WebSearch недоступен на Bedrock. См. [поведение инструмента WebSearch](/ru/tools-reference#websearch-tool-behavior).257* Инструмент WebSearch недоступен на Amazon Bedrock. См. [поведение инструмента WebSearch](/ru/tools-reference#websearch-tool-behavior).

258* Вы можете использовать файлы параметров для переменных окружения, таких как `AWS_PROFILE`, которые вы не хотите утечь в другие процессы. См. [Settings](/ru/settings) для получения дополнительной информации.258* Вы можете использовать файлы параметров для переменных окружения, таких как `AWS_PROFILE`, которые вы не хотите утечь в другие процессы. См. [Settings](/ru/settings) для получения дополнительной информации.

259 259 

260<h3 id="4-pin-model-versions">260<h3 id="4-pin-model-versions">


262</h3>262</h3>

263 263 

264<Warning>264<Warning>

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

266</Warning>266</Warning>

267 267 

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

269 269 

270Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Bedrock разрешается на Opus 4.6. Установите его на ID Opus 4.8, чтобы использовать последнюю модель:270Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Amazon Bedrock разрешается на Opus 4.6. Установите его на ID Opus 4.8, чтобы использовать последнюю модель:

271 271 

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

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


284| Основная модель | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |284| Основная модель | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |

285| Малая/быстрая модель | То же, что и основная модель |285| Малая/быстрая модель | То же, что и основная модель |

286 286 

287Фоновые задачи, такие как генерация заголовка сеанса, используют малую/быструю модель, обычно модель класса Haiku. На Bedrock Claude Code по умолчанию использует основную модель, потому что Haiku может быть не включен в каждой учетной записи или регионе. Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на ID модели, который доступен в вашей учетной записи.287Фоновые задачи, такие как генерация заголовка сеанса, используют малую/быструю модель, обычно модель класса Haiku. На Amazon Bedrock Claude Code по умолчанию использует основную модель, потому что Haiku может быть не включен в каждой учетной записи или регионе. Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на ID модели, который доступен в вашей учетной записи.

288 288 

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

290 290 


305 305 

306TTL кэша в 1 час выставляется по более высокому тарифу, чем стандартный 5-минутный. См. [cache lifetime](/ru/prompt-caching#cache-lifetime).306TTL кэша в 1 час выставляется по более высокому тарифу, чем стандартный 5-минутный. См. [cache lifetime](/ru/prompt-caching#cache-lifetime).

307 307 

308<Note>Prompt caching может быть недоступен во всех регионах Bedrock. Если количество токенов кэша остается на нуле, проверьте [поддерживаемые модели, регионы и ограничения](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) в документации Bedrock.</Note>308<Note>Prompt caching может быть недоступен во всех регионах Amazon Bedrock. Если количество токенов кэша остается на нуле, проверьте [поддерживаемые модели, регионы и ограничения](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) в документации Amazon Bedrock.</Note>

309 309 

310<h4 id="map-each-model-version-to-an-inference-profile">310<h4 id="map-each-model-version-to-an-inference-profile">

311 Сопоставьте каждую версию модели с профилем вывода311 Сопоставьте каждую версию модели с профилем вывода


326}326}

327```327```

328 328 

329Когда пользователь выбирает одну из этих версий в `/model`, Claude Code вызывает Bedrock с сопоставленным ARN. Версии без переопределения возвращаются к встроенному ID модели Bedrock или любому соответствующему профилю вывода, обнаруженному при запуске. См. [Override model IDs per version](/ru/model-config#override-model-ids-per-version) для получения подробной информации о том, как переопределения взаимодействуют с `availableModels` и другими параметрами модели.329Когда пользователь выбирает одну из этих версий в `/model`, Claude Code вызывает Amazon Bedrock с сопоставленным ARN. {/* min-version: 2.1.200 */}То же сопоставление применяется, когда вы передаете ID модели Anthropic напрямую через `--model` или `ANTHROPIC_MODEL`. Версии без переопределения возвращаются к встроенному ID модели Amazon Bedrock или любому соответствующему профилю вывода, обнаруженному при запуске. До версии 2.1.200 значения `--model` и `ANTHROPIC_MODEL` достигали Amazon Bedrock как есть без прохождения через карту переопределений. См. [Override model IDs per version](/ru/model-config#override-model-ids-per-version) для получения подробной информации о том, как переопределения взаимодействуют с `availableModels` и другими параметрами модели.

330 330 

331<h2 id="startup-model-checks">331<h2 id="startup-model-checks">

332 Проверки моделей при запуске332 Проверки моделей при запуске

333</h2>333</h2>

334 334 

335Когда Claude Code запускается с настроенным Bedrock, он проверяет, что модели, которые он намеревается использовать, доступны в вашей учетной записи. Эта проверка требует Claude Code v2.1.94 или более поздней версии.335Когда Claude Code запускается с настроенным Amazon Bedrock, он проверяет, что модели, которые он намеревается использовать, доступны в вашей учетной записи. Эта проверка требует Claude Code v2.1.94 или более поздней версии.

336 336 

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

338 338 

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

340 340 

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

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


433 Используйте конечную точку Mantle433 Используйте конечную точку Mantle

434</h2>434</h2>

435 435 

436Mantle - это конечная точка Amazon Bedrock, которая обслуживает модели Claude через форму собственного API Anthropic, а не через Bedrock Invoke API. Она использует те же учетные данные AWS, разрешения IAM и конфигурацию `awsAuthRefresh`, описанные ранее на этой странице.436Mantle - это конечная точка Amazon Bedrock, которая обслуживает модели Claude через форму собственного API Anthropic, а не через Amazon Bedrock Invoke API. Она использует те же учетные данные AWS, разрешения IAM и конфигурацию `awsAuthRefresh`, описанные ранее на этой странице.

437 437 

438<Note>438<Note>

439 Mantle требует Claude Code v2.1.94 или более поздней версии. Запустите `claude --version`, чтобы проверить.439 Mantle требует Claude Code v2.1.94 или более поздней версии. Запустите `claude --version`, чтобы проверить.


450export AWS_REGION=us-east-1450export AWS_REGION=us-east-1

451```451```

452 452 

453Claude Code конструирует URL конечной точки из региона AWS. {/* min-version: 2.1.172 */}Начиная с версии v2.1.172, регион разрешается с той же приоритетностью, что и [Bedrock выше](#3-configure-claude-code); более ранние версии используют только `AWS_REGION`. Чтобы переопределить URL для пользовательской конечной точки или шлюза, установите `ANTHROPIC_BEDROCK_MANTLE_BASE_URL`.453Claude Code конструирует URL конечной точки из региона AWS. {/* min-version: 2.1.172 */}Начиная с версии v2.1.172, регион разрешается с той же приоритетностью, что и [Amazon Bedrock выше](#3-configure-claude-code); более ранние версии используют только `AWS_REGION`. Чтобы переопределить URL для пользовательской конечной точки или шлюза, установите `ANTHROPIC_BEDROCK_MANTLE_BASE_URL`.

454 454 

455Запустите `/status` внутри Claude Code для подтверждения. Строка поставщика показывает `Amazon Bedrock (Mantle)`, когда Mantle активен.455Запустите `/status` внутри Claude Code для подтверждения. Строка поставщика показывает `Amazon Bedrock (Mantle)`, когда Mantle активен.

456 456 


470 Запустите Mantle рядом с Invoke API470 Запустите Mantle рядом с Invoke API

471</h3>471</h3>

472 472 

473Модели, доступные вам на Mantle, могут не включать каждую модель, которую вы используете сегодня. Установка как `CLAUDE_CODE_USE_BEDROCK`, так и `CLAUDE_CODE_USE_MANTLE` позволяет Claude Code вызывать обе конечные точки из одного сеанса. ID моделей, соответствующие формату Mantle, маршрутизируются на Mantle, а все остальные ID моделей идут на Bedrock Invoke API.473Модели, доступные вам на Mantle, могут не включать каждую модель, которую вы используете сегодня. Установка как `CLAUDE_CODE_USE_BEDROCK`, так и `CLAUDE_CODE_USE_MANTLE` позволяет Claude Code вызывать обе конечные точки из одного сеанса. ID моделей, соответствующие формату Mantle, маршрутизируются на Mantle, а все остальные ID моделей идут на Amazon Bedrock Invoke API.

474 474 

475```bash theme={null}475```bash theme={null}

476export CLAUDE_CODE_USE_BEDROCK=1476export CLAUDE_CODE_USE_BEDROCK=1


508Эти переменные специфичны для конечной точки Mantle. См. [Environment variables](/ru/env-vars) для полного списка.508Эти переменные специфичны для конечной точки Mantle. См. [Environment variables](/ru/env-vars) для полного списка.

509 509 

510| Переменная | Назначение |510| Переменная | Назначение |

511| :-------------------------------------- | :------------------------------------------------------------------ |511| :-------------------------------------- | :------------------------------------------------------------------------- |

512| `CLAUDE_CODE_USE_MANTLE` | Включите конечную точку Mantle. Установите на `1` или `true`. |512| `CLAUDE_CODE_USE_MANTLE` | Включите конечную точку Mantle. Установите на `1` или `true`. |

513| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Переопределите URL конечной точки Mantle по умолчанию |513| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Переопределите URL конечной точки Mantle по умолчанию |

514| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Пропустите аутентификацию на стороне клиента для настроек прокси |514| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Пропустите аутентификацию на стороне клиента для настроек прокси |

515| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Переопределите регион AWS для модели класса Haiku (общее с Bedrock) |515| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Переопределите регион AWS для модели класса Haiku (общее с Amazon Bedrock) |

516 516 

517<h2 id="troubleshooting">517<h2 id="troubleshooting">

518 Устранение неполадок518 Устранение неполадок


540 540 

541* Укажите модель как ID [профиля вывода](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)541* Укажите модель как ID [профиля вывода](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)

542 542 

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

544 544 

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

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

547</h3>547</h3>

548 548 

549Команда `/context` подсчитывает токены для каждой группы инструментов, отправляя схемы инструментов в API подсчета токенов Bedrock. {/* min-version: 2.1.196 */}В версиях Claude Code до v2.1.196 Bedrock отклонял этот запрос, потому что схемы содержали поля, которые его API подсчета токенов не принимает, поэтому каждая группа инструментов показывала 0 токенов. Другие строки в разбивке, такие как сообщения и файлы памяти, не затронуты.549Команда `/context` подсчитывает токены для каждой группы инструментов, отправляя схемы инструментов в API подсчета токенов Amazon Bedrock. {/* min-version: 2.1.196 */}В версиях Claude Code до v2.1.196 Amazon Bedrock отклонял этот запрос, потому что схемы содержали поля, которые его API подсчета токенов не принимает, поэтому каждая группа инструментов показывала 0 токенов. Другие строки в разбивке, такие как сообщения и файлы памяти, не затронуты.

550 550 

551Обновитесь до v2.1.196 или более поздней версии.551Обновитесь до v2.1.196 или более поздней версии.

552 552 


558 558 

559`403` от конечной точки Mantle с действительными учетными данными означает, что вашей учетной записи AWS не был предоставлен доступ к запрошенной модели. Свяжитесь с вашей командой учетной записи AWS, чтобы запросить доступ.559`403` от конечной точки Mantle с действительными учетными данными означает, что вашей учетной записи AWS не был предоставлен доступ к запрошенной модели. Свяжитесь с вашей командой учетной записи AWS, чтобы запросить доступ.

560 560 

561`400`, который называет ID модели, означает, что эта модель не обслуживается на Mantle. Mantle имеет свой собственный набор моделей, отдельный от стандартного каталога Bedrock, поэтому ID профилей вывода, такие как `us.anthropic.claude-sonnet-4-6`, не будут работать. Используйте ID формата Mantle или включите [обе конечные точки](#run-mantle-alongside-the-invoke-api), чтобы Claude Code маршрутизировал каждый запрос на конечную точку, где модель доступна.561`400`, который называет ID модели, означает, что эта модель не обслуживается на Mantle. Mantle имеет свой собственный набор моделей, отдельный от стандартного каталога Amazon Bedrock, поэтому ID профилей вывода, такие как `us.anthropic.claude-sonnet-4-6`, не будут работать. Используйте ID формата Mantle или включите [обе конечные точки](#run-mantle-alongside-the-invoke-api), чтобы Claude Code маршрутизировал каждый запрос на конечную точку, где модель доступна.

562 562 

563<h2 id="additional-resources">563<h2 id="additional-resources">

564 Дополнительные ресурсы564 Дополнительные ресурсы

565</h2>565</h2>

566 566 

567* [Документация Bedrock](https://docs.aws.amazon.com/bedrock/)567* [Документация Amazon Bedrock](https://docs.aws.amazon.com/bedrock/)

568* [Цены Bedrock](https://aws.amazon.com/bedrock/pricing/)568* [Цены Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/)

569* [Профили вывода Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)569* [Профили вывода Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)

570* [Burndown токенов Bedrock и квоты](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-token-burndown.html)570* [Burndown токенов Amazon Bedrock и квоты](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-token-burndown.html)

571* [Claude Code на Amazon Bedrock: Quick Setup Guide](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)571* [Claude Code на Amazon Bedrock: Quick Setup Guide](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)

572* [Claude Code Monitoring Implementation (Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)572* [Claude Code Monitoring Implementation (Amazon Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)

artifacts.md +1 −1

Details

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

193| Plan | Pro, Max, Team или Enterprise. На планах Pro и Max артефакты являются приватными для вас, и управление администратором не применяется. На планах Team артефакты включены по умолчанию. На планах Enterprise администратор [включает их](#manage-artifacts-for-your-organization) в параметрах администратора claude.ai. |193| 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) или учётные данные поставщика облачных услуг, не могут публиковать. |194| Authentication | Вошли на claude.ai с помощью `/login`. Сеансы, использующие ключ API, [токен шлюза](/ru/llm-gateway) или учётные данные поставщика облачных услуг, не могут публиковать. |

195| Model provider | Anthropic API. Недоступно на [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud Vertex AI](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry). |195| 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) не включены для организации. |196| 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). |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). |

198 198 

Details

6 6 

7> Войдите в Claude Code и настройте аутентификацию для отдельных пользователей, команд и организаций.7> Войдите в Claude Code и настройте аутентификацию для отдельных пользователей, команд и организаций.

8 8 

9Claude Code поддерживает несколько методов аутентификации в зависимости от вашей конфигурации. Отдельные пользователи могут войти с помощью учетной записи Claude.ai, а команды могут использовать Claude for Teams или Enterprise, Claude Console или облачного провайдера, такого как Amazon Bedrock, Google Vertex AI или Microsoft Foundry.9Claude Code поддерживает несколько методов аутентификации в зависимости от вашей конфигурации. Отдельные пользователи могут войти с помощью учетной записи Claude.ai, а команды могут использовать Claude for Teams или Enterprise, Claude Console или облачного провайдера, такого как Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.

10 10 

11<h2 id="log-in-to-claude-code">11<h2 id="log-in-to-claude-code">

12 Вход в Claude Code12 Вход в Claude Code


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).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).

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

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

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

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

28 28 

29Чтобы выйти и повторно аутентифицироваться, введите `/logout` в приглашение Claude Code.29Чтобы выйти и повторно аутентифицироваться, введите `/logout` в приглашение Claude Code.


40* [Claude Console](#claude-console-authentication)40* [Claude Console](#claude-console-authentication)

41* [Claude apps gateway](/ru/claude-apps-gateway), самостоятельно размещаемый шлюз, который подписывает разработчиков с помощью вашего IdP и маршрутизирует вывод к облачному провайдеру, который вы настраиваете41* [Claude apps gateway](/ru/claude-apps-gateway), самостоятельно размещаемый шлюз, который подписывает разработчиков с помощью вашего IdP и маршрутизирует вывод к облачному провайдеру, который вы настраиваете

42* [Amazon Bedrock](/ru/amazon-bedrock)42* [Amazon Bedrock](/ru/amazon-bedrock)

43* [Google Vertex AI](/ru/google-vertex-ai)43* [Google Cloud's Agent Platform](/ru/google-vertex-ai)

44* [Microsoft Foundry](/ru/microsoft-foundry)44* [Microsoft Foundry](/ru/microsoft-foundry)

45 45 

46<h3 id="claude-for-teams-or-enterprise">46<h3 id="claude-for-teams-or-enterprise">


105 Аутентификация облачного провайдера105 Аутентификация облачного провайдера

106</h3>106</h3>

107 107 

108Для команд, использующих Amazon Bedrock, Google Vertex AI или Microsoft Foundry:108Для команд, использующих Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry:

109 109 

110<Steps>110<Steps>

111 <Step title="Следуйте настройке провайдера">111 <Step title="Следуйте настройке провайдера">

112 Следуйте [документации Bedrock](/ru/amazon-bedrock), [документации Vertex](/ru/google-vertex-ai) или [документации Microsoft Foundry](/ru/microsoft-foundry).112 Следуйте [документации Amazon Bedrock](/ru/amazon-bedrock), [документации Google Cloud's Agent Platform](/ru/google-vertex-ai) или [документации Microsoft Foundry](/ru/microsoft-foundry).

113 </Step>113 </Step>

114 114 

115 <Step title="Распределите конфигурацию">115 <Step title="Распределите конфигурацию">


140 140 

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), которые аутентифицируются с помощью учетных данных этой конфигурации.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), которые аутентифицируются с помощью учетных данных этой конфигурации.

142 142 

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

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

145</h3>

146 

147Когда вход, созданный с помощью `/login`, находится в пределах пяти дней до истечения срока действия, Claude Code показывает предупреждение при запуске: `Your login expires in 3 days · run /login to renew`. Требуется Claude Code v2.1.203 или позже.

148 

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

150 

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

152 

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

154 

143<h3 id="authentication-precedence">155<h3 id="authentication-precedence">

144 Приоритет аутентификации156 Приоритет аутентификации

145</h3>157</h3>


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

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

155 167 

156Подписанный сеанс [Claude apps gateway](/ru/claude-apps-gateway) находится вне этого списка: это выбор провайдера, как Bedrock или Vertex, и он имеет приоритет над ними. Когда существует сеанс шлюза, CLI аутентифицируется с помощью токена шлюза, даже если установлены `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` или `CLAUDE_CODE_USE_FOUNDRY`, и записи токена-носителя, ключа API и `apiKeyHelper` выше не используются.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` выше не используются.

157 169 

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

159 171 

Details

9[Auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) позволяет Claude Code работать без запросов разрешения, маршрутизируя каждый вызов инструмента через классификатор, который блокирует все необратимое, деструктивное или направленное вне вашего окружения. Правила отказа и явного запроса оцениваются перед классификатором и по-прежнему блокируют или запрашивают разрешение. Используйте блок настроек `autoMode`, чтобы сообщить этому классификатору, какие репозитории, бакеты и домены доверяет ваша организация, чтобы он перестал блокировать обычные внутренние операции.9[Auto mode](/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 Vertex AI, Microsoft Foundry и сеансах [Claude apps gateway](/ru/claude-apps-gateway) с входом вы должны сначала [установить `CLAUDE_CODE_ENABLE_AUTO_MODE`](/ru/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry). Если Claude Code сообщает, что auto mode недоступен для вашей учетной записи, проверьте [полные требования](/ru/permission-modes#eliminate-prompts-with-auto-mode), которые также охватывают поддерживаемые модели и включение администратором на планах Team и Enterprise.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.

13</Note>13</Note>

14 14 

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


60 * **Organization**60 * **Organization**

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

62 * **Cloud provider(s)**62 * **Cloud provider(s)**

63 * **Repository visibility**: репозиторий считается приватным, если его удаленный хост и имя не указывают иное63 * **Repository visibility**: репозиторий считается приватным, если его удаленный хост и имя не указывают иное, {/* min-version: 2.1.200 */}или проверка видимости ранее в сеансе, которую читает классификатор, показывает, что он является публичным. Классификатор читает ваши сообщения и команды, которые запускает Claude, а не их вывод, поэтому доказательство должно быть чем-то, что он может прочитать, например вашим собственным сообщением, называющим репозиторий как публичный; вывод `gh repo view` сам по себе не достигает его. Проверка доказательств из стенограммы требует Claude Code v2.1.200 или позже

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

65 * **Org-specific CLIs**65 * **Org-specific CLIs**

66 * **Secrets management**66 * **Secrets management**


69 * **Network posture**69 * **Network posture**

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

71 * **Data retention / declassification**71 * **Data retention / declassification**

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

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

74 74 

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

76 76 

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

78 78 

channels.md +1 −1

Details

7> Используйте каналы для отправки сообщений, оповещений и вебхуков в ваш сеанс Claude Code из MCP-сервера. Перенаправляйте результаты CI, сообщения чата и события мониторинга, чтобы Claude мог реагировать, пока вас нет.7> Используйте каналы для отправки сообщений, оповещений и вебхуков в ваш сеанс Claude Code из MCP-сервера. Перенаправляйте результаты CI, сообщения чата и события мониторинга, чтобы Claude мог реагировать, пока вас нет.

8 8 

9<Note>9<Note>

10 Каналы находятся в [исследовательском превью](#research-preview) и требуют Claude Code v2.1.80 или позже. Они требуют аутентификации Anthropic через claude.ai или ключ API Console, и недоступны на Amazon Bedrock, Google Vertex AI или Microsoft Foundry. Организации Team и Enterprise должны [явно их включить](#enterprise-controls).10 Каналы находятся в [исследовательском превью](#research-preview) и требуют Claude Code v2.1.80 или позже. Они требуют аутентификации Anthropic через claude.ai или ключ API Console, и недоступны на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Организации Team и Enterprise должны [явно их включить](#enterprise-controls).

11</Note>11</Note>

12 12 

13Канал — это MCP-сервер, который отправляет события в ваш активный сеанс Claude Code, чтобы Claude мог реагировать на события, происходящие, пока вас нет у терминала. Каналы могут быть двусторонними: Claude читает событие и отвечает через тот же канал, как мост чата. События поступают только пока сеанс открыт, поэтому для постоянно работающей установки вы запускаете Claude в фоновом процессе или постоянном терминале.13Канал — это MCP-сервер, который отправляет события в ваш активный сеанс Claude Code, чтобы Claude мог реагировать на события, происходящие, пока вас нет у терминала. Каналы могут быть двусторонними: Claude читает событие и отвечает через тот же канал, как мост чата. События поступают только пока сеанс открыт, поэтому для постоянно работающей установки вы запускаете Claude в фоновом процессе или постоянном терминале.

Details

36* **Платформы чата** (Telegram, Discord): ваш плагин работает локально и опрашивает API платформы на предмет новых сообщений. Когда кто-то отправляет личное сообщение вашему боту, плагин получает сообщение и пересылает его Claude. Нет необходимости в URL для открытия.36* **Платформы чата** (Telegram, Discord): ваш плагин работает локально и опрашивает API платформы на предмет новых сообщений. Когда кто-то отправляет личное сообщение вашему боту, плагин получает сообщение и пересылает его Claude. Нет необходимости в URL для открытия.

37* **Вебхуки** (CI, мониторинг): ваш сервер прослушивает локальный HTTP-порт. Внешние системы отправляют POST на этот порт, и ваш сервер отправляет полезную нагрузку Claude.37* **Вебхуки** (CI, мониторинг): ваш сервер прослушивает локальный HTTP-порт. Внешние системы отправляют POST на этот порт, и ваш сервер отправляет полезную нагрузку Claude.

38 38 

39<img src="https://mintlify.s3.us-west-1.amazonaws.com/claude-code/ru/images/channel-architecture.svg" alt="Диаграмма архитектуры, показывающая внешние системы, подключающиеся к вашему локальному серверу канала, который взаимодействует с Claude Code через stdio" />39<img src="https://mintcdn.com/claude-code/9FG0ZKj9uKYiHmbi/images/channel-architecture.svg?fit=max&auto=format&n=9FG0ZKj9uKYiHmbi&q=85&s=9a037b7da80184ae49015c0256b21a1f" alt="Диаграмма архитектуры, показывающая внешние системы, подключающиеся к вашему локальному серверу канала, который взаимодействует с Claude Code через stdio" width="600" height="220" data-path="images/channel-architecture.svg" />

40 40 

41<h2 id="what-you-need">41<h2 id="what-you-need">

42 Что вам нужно42 Что вам нужно


474 474 

475Диалог локального терминала остаётся открытым на протяжении всего этого. Если кто-то в терминале ответит перед поступлением удалённого вердикта, этот ответ применяется вместо этого и ожидающий удалённый запрос отбрасывается.475Диалог локального терминала остаётся открытым на протяжении всего этого. Если кто-то в терминале ответит перед поступлением удалённого вердикта, этот ответ применяется вместо этого и ожидающий удалённый запрос отбрасывается.

476 476 

477<img src="https://mintlify.s3.us-west-1.amazonaws.com/claude-code/ru/images/channel-permission-relay.svg" alt="Диаграмма последовательности: Claude Code отправляет уведомление permission_request на сервер канала, сервер форматирует и отправляет запрос в приложение чата, человек отвечает вердиктом, и сервер анализирует этот ответ в уведомление разрешения обратно в Claude Code" />477<img src="https://mintcdn.com/claude-code/9FG0ZKj9uKYiHmbi/images/channel-permission-relay.svg?fit=max&auto=format&n=9FG0ZKj9uKYiHmbi&q=85&s=97d57f128f0da55f105ab1e3a7e10240" alt="Диаграмма последовательности: Claude Code отправляет уведомление permission_request на сервер канала, сервер форматирует и отправляет запрос в приложение чата, человек отвечает вердиктом, и сервер анализирует этот ответ в уведомление разрешения обратно в Claude Code" width="600" height="230" data-path="images/channel-permission-relay.svg" />

478 478 

479<h3 id="permission-request-fields">479<h3 id="permission-request-fields">

480 Поля запроса разрешения480 Поля запроса разрешения

chrome.md +1 −1

Details

40* Прямой план Anthropic (Pro, Max, Team или Enterprise)40* Прямой план Anthropic (Pro, Max, Team или Enterprise)

41 41 

42<Note>42<Note>

43 Интеграция с Chrome недоступна через сторонних поставщиков, таких как Amazon Bedrock, Google Cloud Vertex AI или Microsoft Foundry. Если вы получаете доступ к Claude исключительно через стороннего поставщика, вам нужна отдельная учетная запись claude.ai для использования этой функции.43 Интеграция с Chrome недоступна через сторонних поставщиков, таких как Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Если вы получаете доступ к Claude исключительно через стороннего поставщика, вам нужна отдельная учетная запись claude.ai для использования этой функции.

44</Note>44</Note>

45 45 

46<h2 id="get-started-in-the-cli">46<h2 id="get-started-in-the-cli">

Details

4 4 

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

6 6 

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

8 8 

9Развёртывание Claude apps gateway настраивается одним файлом YAML, обычно `gateway.yaml`. Файл определяет всё, что делает gateway: где он слушает, как разработчики входят в систему, куда идёт вывод, и какие политики и телеметрия применяются. Эта страница — справочник по каждому параметру в этом файле.9Развёртывание Claude apps gateway настраивается одним файлом YAML, обычно `gateway.yaml`. Файл определяет всё, что делает gateway: где он слушает, как разработчики входят в систему, куда идёт вывод, и какие политики и телеметрия применяются. Эта страница — справочник по каждому параметру в этом файле.

10 10 


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

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

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

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

30 30 

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

32 32 


408 `models`408 `models`

409</h3>409</h3>

410 410 

411Блок `models` — это опциональный кураторский список моделей администратором, обслуживаемый в `/v1/models` и используемый для перевода ID моделей для каждого upstream. Требуется для регионов Bedrock, не входящих в США, ARN выделенной пропускной способности Bedrock и имён развёртываний Foundry.411Блок `models` — это опциональный кураторский список моделей администратором, обслуживаемый в `/v1/models` и используемый для перевода ID моделей для каждого upstream. Требуется для регионов Bedrock, не входящих в США, ARN выделенной пропускной способности Amazon Bedrock и имён развёртываний Microsoft Foundry.

412 412 

413```yaml theme={null}413```yaml theme={null}

414auto_include_builtin_models: true # false: выставляйте только список ниже414auto_include_builtin_models: true # false: выставляйте только список ниже

Details

4 4 

5# Развертывание Claude apps gateway на Google Cloud5# Развертывание Claude apps gateway на Google Cloud

6 6 

7> Практический пример запуска Claude apps gateway на Google Cloud: Cloud Run или GKE, Cloud SQL для PostgreSQL, Secret Manager и аутентификация через сервисный аккаунт для Agent Platform.7> Практический пример запуска Claude apps gateway на Google Cloud: Cloud Run или GKE, Cloud SQL для PostgreSQL, Secret Manager и аутентификация через сервисный аккаунт для Agent Platform Google Cloud.

8 8 

9<Note>9<Note>

10 На этой странице описан один из способов запуска Claude apps gateway на Google Cloud. Конфигурация является рабочим примером для инфраструктуры, управляемой клиентом, а не поддерживаемым развертыванием для производства; используйте её, чтобы понять, как компоненты работают вместе, прежде чем адаптировать её к своей среде. Требования, независимые от платформы, см. в [руководстве по развертыванию](/ru/claude-apps-gateway-deploy).10 На этой странице описан один из способов запуска Claude apps gateway на Google Cloud. Конфигурация является рабочим примером для инфраструктуры, управляемой клиентом, а не поддерживаемым развертыванием для производства; используйте её, чтобы понять, как компоненты работают вместе, прежде чем адаптировать её к своей среде. Требования, независимые от платформы, см. в [руководстве по развертыванию](/ru/claude-apps-gateway-deploy).

Details

61 61 

62После каждого ответа счетчик использования читает количество токенов из ответа по мере его потоковой передачи клиенту, оценивает их по цене USD по прайс-листу и увеличивает счетчики Postgres для всех трех периодических корзин. Счетчик — это один читатель потока, поэтому байты клиента не затрагиваются, и сбой измерения не нарушает ответ.62После каждого ответа счетчик использования читает количество токенов из ответа по мере его потоковой передачи клиенту, оценивает их по цене USD по прайс-листу и увеличивает счетчики Postgres для всех трех периодических корзин. Счетчик — это один читатель потока, поэтому байты клиента не затрагиваются, и сбой измерения не нарушает ответ.

63 63 

64Лимиты расходов оценивают расходы на основе количества токенов по цене USD по прайс-листу; они являются автоматическим выключателем, а не счетом. Для авторитетного выставления счетов согласуйте с собственной отчетностью об использовании вашего провайдера, такой как Anthropic Usage & Cost Admin API, журналы вызовов на Bedrock или Cloud Monitoring на Google Cloud.64Лимиты расходов оценивают расходы на основе количества токенов по цене USD по прайс-листу; они являются автоматическим выключателем, а не счетом. Для авторитетного выставления счетов согласуйте с собственной отчетностью об использовании вашего провайдера, такой как Anthropic Usage & Cost Admin API, журналы вызовов на Amazon Bedrock или Cloud Monitoring на Google Cloud.

65 65 

66Ценообразование использует ту же таблицу, которую использует Claude Code CLI для собственного отображения стоимости, с той же канонизацией ID модели в формах Anthropic, Bedrock (`us.anthropic.…-v1:0`), Agent Platform (`claude-…@date`) и Foundry ID. ID модели, который таблица не может найти, такой как имя развертывания Foundry или ARN профиля вывода, оценивается по уровню неизвестной модели по умолчанию в размере \$5/\$25 за миллион входных/выходных токенов, а не нулю, поэтому неузнанный ID не может обойти лимит, оставаясь неизмеренным. Gateway предупреждает при загрузке и один раз за ID во время выполнения, когда модель оценивается через резервный вариант.66Ценообразование использует ту же таблицу, которую использует Claude Code CLI для собственного отображения стоимости, с той же канонизацией ID модели в формах Anthropic, Amazon Bedrock (`us.anthropic.…-v1:0`), Google Cloud's Agent Platform (`claude-…@date`) и Microsoft Foundry ID. ID модели, который таблица не может найти, такой как имя развертывания Microsoft Foundry или ARN профиля вывода, оценивается по уровню неизвестной модели по умолчанию в размере \$5/\$25 за миллион входных/выходных токенов, а не нулю, поэтому неузнанный ID не может обойти лимит, оставаясь неизмеренным. Gateway предупреждает при загрузке и один раз за ID во время выполнения, когда модель оценивается через резервный вариант.

67 67 

68Прерывания клиента также учитываются. Upstream сообщает выходные токены только в терминальном кадре потока, поэтому прерванный поток их не содержит. Счетчик сохраняет консервативную оценку пола из размера потокового контента, примерно четыре символа на токен, и учитывает его, когда и только когда отсутствует терминальный кадр использования. Полный поток всегда учитывает количество, сообщаемое upstream. Без этого ограниченный разработчик мог бы потоком передавать выходные данные и прерывать каждый запрос непосредственно перед концом, тратя без учета.68Прерывания клиента также учитываются. Upstream сообщает выходные токены только в терминальном кадре потока, поэтому прерванный поток их не содержит. Счетчик сохраняет консервативную оценку пола из размера потокового контента, примерно четыре символа на токен, и учитывает его, когда и только когда отсутствует терминальный кадр использования. Полный поток всегда учитывает количество, сообщаемое upstream. Без этого ограниченный разработчик мог бы потоком передавать выходные данные и прерывать каждый запрос непосредственно перед концом, тратя без учета.

69 69 

Details

4 4 

5# Использование Claude Code в веб-интерфейсе5# Использование Claude Code в веб-интерфейсе

6 6 

7> Настройте облачные окружения, скрипты установки, сетевой доступ и Docker в песочнице Anthropic. Перемещайте сессии между веб-интерфейсом и терминалом с помощью `--remote` и `--teleport`.7> Настройте облачные окружения, скрипты установки, сетевой доступ и Docker в песочнице Anthropic. Перемещайте сессии между веб-интерфейсом и терминалом с помощью `--cloud` и `--teleport`.

8 8 

9<Note>9<Note>

10 Claude Code в веб-интерфейсе находится в исследовательском предпросмотре для пользователей Pro, Max и Team, а также для пользователей Enterprise с премиум-местами или местами Chat + Claude Code.10 Claude Code в веб-интерфейсе находится в исследовательском предпросмотре для пользователей Pro, Max и Team, а также для пользователей Enterprise с премиум-местами или местами Chat + Claude Code.


22* [Облачное окружение](#the-cloud-environment): какая конфигурация переносится, какие инструменты установлены и как настроить окружения22* [Облачное окружение](#the-cloud-environment): какая конфигурация переносится, какие инструменты установлены и как настроить окружения

23* [Setup scripts](#setup-scripts) и управление зависимостями23* [Setup scripts](#setup-scripts) и управление зависимостями

24* [Сетевой доступ](#network-access): уровни, прокси и список разрешений по умолчанию24* [Сетевой доступ](#network-access): уровни, прокси и список разрешений по умолчанию

25* [Перемещение задач между веб-интерфейсом и терминалом](#move-tasks-between-web-and-terminal) с помощью `--remote` и `--teleport`25* [Перемещение задач между веб-интерфейсом и терминалом](#move-tasks-between-web-and-terminal) с помощью `--cloud` и `--teleport`

26* [Работа с сессиями](#work-with-sessions): просмотр, совместное использование, архивирование, удаление26* [Работа с сессиями](#work-with-sessions): просмотр, совместное использование, архивирование, удаление

27* [Auto-fix pull requests](#auto-fix-pull-requests): автоматический ответ на сбои CI и комментарии рецензентов27* [Auto-fix pull requests](#auto-fix-pull-requests): автоматический ответ на сбои CI и комментарии рецензентов

28* [Безопасность и изоляция](#security-and-isolation): как сессии изолированы28* [Безопасность и изоляция](#security-and-isolation): как сессии изолированы


182Окружения контролируют [сетевой доступ](#network-access), переменные окружения и [setup script](#setup-scripts), который запускается перед запуском сессии. См. [Установленные инструменты](#installed-tools) для того, что доступно без какой-либо конфигурации. Вы можете управлять окружениями из веб-интерфейса или терминала:182Окружения контролируют [сетевой доступ](#network-access), переменные окружения и [setup script](#setup-scripts), который запускается перед запуском сессии. См. [Установленные инструменты](#installed-tools) для того, что доступно без какой-либо конфигурации. Вы можете управлять окружениями из веб-интерфейса или терминала:

183 183 

184| Действие | Как |184| Действие | Как |

185| :---------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |185| :-------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

186| Добавить окружение | Выберите текущее окружение, чтобы открыть селектор, затем выберите **Add environment**. Диалог включает имя, уровень сетевого доступа, переменные окружения и setup script. |186| Добавить окружение | Выберите текущее окружение, чтобы открыть селектор, затем выберите **Add environment**. Диалог включает имя, уровень сетевого доступа, переменные окружения и setup script. |

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

188| Архивировать окружение | Откройте окружение для редактирования и выберите **Archive**. Архивированные окружения скрыты из селектора, но существующие сессии продолжают работать. |188| Архивировать окружение | Откройте окружение для редактирования и выберите **Archive**. Архивированные окружения скрыты из селектора, но существующие сессии продолжают работать. |

189| Установить значение по умолчанию для `--remote` | Запустите `/remote-env` в вашем терминале. Если у вас одно окружение, эта команда показывает вашу текущую конфигурацию. `/remote-env` только выбирает значение по умолчанию; добавляйте, редактируйте и архивируйте окружения из веб-интерфейса. |189| Установить окружение по умолчанию для CLI облачных сессий | Запустите `/remote-env` в вашем терминале. Если у вас одно окружение, эта команда показывает вашу текущую конфигурацию. `/remote-env` только выбирает значение по умолчанию; добавляйте, редактируйте и архивируйте окружения из веб-интерфейса. |

190 190 

191Переменные окружения используют формат `.env` с одной парой `KEY=value` на строку. Не оборачивайте значения в кавычки, так как кавычки хранятся как часть значения. Этот пример определяет три переменные:191Переменные окружения используют формат `.env` с одной парой `KEY=value` на строку. Не оборачивайте значения в кавычки, так как кавычки хранятся как часть значения. Этот пример определяет три переменные:

192 192 


629Эти рабочие процессы требуют [Claude Code CLI](/ru/quickstart), вошедшего в один и тот же аккаунт claude.ai. Вы можете запускать новые облачные сессии из вашего терминала или вытягивать облачные сессии в ваш терминал для продолжения локально. Облачные сессии сохраняются даже если вы закроете ваш ноутбук, и вы можете мониторить их откуда угодно, включая мобильное приложение Claude.629Эти рабочие процессы требуют [Claude Code CLI](/ru/quickstart), вошедшего в один и тот же аккаунт claude.ai. Вы можете запускать новые облачные сессии из вашего терминала или вытягивать облачные сессии в ваш терминал для продолжения локально. Облачные сессии сохраняются даже если вы закроете ваш ноутбук, и вы можете мониторить их откуда угодно, включая мобильное приложение Claude.

630 630 

631<Note>631<Note>

632 Из CLI передача сессии односторонняя: вы можете вытягивать облачные сессии в ваш терминал с помощью `--teleport`, но вы не можете отправить существующую сессию терминала в веб-интерфейс. Флаг `--remote` создаёт новую облачную сессию для вашего текущего репозитория. [Desktop app](/ru/desktop#continue-in-another-surface) предоставляет меню Continue in, которое может отправить локальную сессию в веб-интерфейс.632 Из CLI передача сессии односторонняя: вы можете вытягивать облачные сессии в ваш терминал с помощью `--teleport`, но вы не можете отправить существующую сессию терминала в веб-интерфейс. Флаг `--cloud` создаёт новую облачную сессию для вашего текущего репозитория. [Desktop app](/ru/desktop#continue-in-another-surface) предоставляет меню Continue in, которое может отправить локальную сессию в веб-интерфейс.

633</Note>633</Note>

634 634 

635<h3 id="from-terminal-to-web">635<h3 id="from-terminal-to-web">

636 От терминала к веб-интерфейсу636 От терминала к веб-интерфейсу

637</h3>637</h3>

638 638 

639Запустите облачную сессию из командной строки с флагом `--remote`:639Запустите облачную сессию из командной строки с флагом `--cloud`:

640 640 

641```bash theme={null}641```bash theme={null}

642claude --remote "Fix the authentication bug in src/auth/login.ts"642claude --cloud "Fix the authentication bug in src/auth/login.ts"

643```643```

644 644 

645Это создаёт новую облачную сессию на claude.ai. Сессия клонирует удалённый GitHub вашего текущего каталога в вашей текущей ветке, поэтому сначала отправьте, если у вас есть локальные коммиты, так как виртуальная машина клонирует из GitHub, а не с вашей машины. `--remote` работает с одним репозиторием за раз. Задача запускается в облаке, пока вы продолжаете работать локально.645Это создаёт новую облачную сессию на claude.ai. Сессия клонирует удалённый GitHub вашего текущего каталога в вашей текущей ветке, поэтому сначала отправьте, если у вас есть локальные коммиты, так как виртуальная машина клонирует из GitHub, а не с вашей машины. `--cloud` работает с одним репозиторием за раз. Задача запускается в облаке, пока вы продолжаете работать локально. Старое написание `--remote` всё ещё работает как устаревший псевдоним для `--cloud`.

646 646 

647{/* min-version: 2.1.195 */}Начиная с версии v2.1.195, CLI показывает живой чек-лист шагов настройки, таких как клонирование репозитория и запуск вашего [скрипта настройки](#setup-scripts), пока облачный контейнер запускается. Сообщения, которые вы вводите, пока контейнер подготавливается, ставятся в очередь и отправляются после того, как сессия будет готова.647{/* min-version: 2.1.195 */}Начиная с версии v2.1.195, CLI показывает живой чек-лист шагов настройки, таких как клонирование репозитория и запуск вашего [скрипта настройки](#setup-scripts), пока облачный контейнер запускается. Сообщения, которые вы вводите, пока контейнер подготавливается, ставятся в очередь и отправляются после того, как сессия будет готова.

648 648 

649<Note>649<Note>

650 `--remote` создаёт облачные сессии. `--remote-control` не связан: он предоставляет локальную сессию CLI для мониторинга из веб-интерфейса. См. [Remote Control](/ru/remote-control).650 `--cloud` создаёт облачные сессии. `--remote-control` не связан: он предоставляет локальную сессию CLI для мониторинга из веб-интерфейса. См. [Remote Control](/ru/remote-control).

651</Note>651</Note>

652 652 

653Используйте `/tasks` в Claude Code CLI для проверки прогресса, или откройте сессию на claude.ai или в мобильном приложении Claude для прямого взаимодействия. Оттуда вы можете управлять Claude, предоставлять обратную связь или отвечать на вопросы, как в любом другом разговоре.653Используйте `/tasks` в Claude Code CLI для проверки прогресса, или откройте сессию на claude.ai или в мобильном приложении Claude для прямого взаимодействия. Оттуда вы можете управлять Claude, предоставлять обратную связь или отвечать на вопросы, как в любом другом разговоре.


665В режиме плана Claude читает файлы, запускает команды для исследования и предлагает план без редактирования исходного кода. Когда вы будете довольны, сохраните план в репозиторий, зафиксируйте и отправьте, чтобы облачная виртуальная машина могла его клонировать. Затем запустите облачную сессию для автономного выполнения:665В режиме плана Claude читает файлы, запускает команды для исследования и предлагает план без редактирования исходного кода. Когда вы будете довольны, сохраните план в репозиторий, зафиксируйте и отправьте, чтобы облачная виртуальная машина могла его клонировать. Затем запустите облачную сессию для автономного выполнения:

666 666 

667```bash theme={null}667```bash theme={null}

668claude --remote "Execute the migration plan in docs/migration-plan.md"668claude --cloud "Execute the migration plan in docs/migration-plan.md"

669```669```

670 670 

671Этот паттерн даёт вам контроль над стратегией, позволяя Claude выполняться автономно в облаке.671Этот паттерн даёт вам контроль над стратегией, позволяя Claude выполняться автономно в облаке.

672 672 

673**Планируйте в облаке с ultraplan**: чтобы составить и просмотреть сам план в веб-сессии, используйте [ultraplan](/ru/ultraplan). Claude генерирует план на Claude Code в веб-интерфейсе, пока вы продолжаете работать, затем вы комментируете разделы в вашем браузере и выбираете выполнение удалённо или отправку плана обратно в ваш терминал.673**Планируйте в облаке с ultraplan**: чтобы составить и просмотреть сам план в веб-сессии, используйте [ultraplan](/ru/ultraplan). Claude генерирует план на Claude Code в веб-интерфейсе, пока вы продолжаете работать, затем вы комментируете разделы в вашем браузере и выбираете выполнение удалённо или отправку плана обратно в ваш терминал.

674 674 

675**Запускайте задачи параллельно**: каждая команда `--remote` создаёт свою собственную облачную сессию, которая запускается независимо. Вы можете запустить несколько задач, и они все будут запускаться одновременно в отдельных сессиях:675**Запускайте задачи параллельно**: каждая команда `--cloud` создаёт свою собственную облачную сессию, которая запускается независимо. Вы можете запустить несколько задач, и они все будут запускаться одновременно в отдельных сессиях:

676 676 

677```bash theme={null}677```bash theme={null}

678claude --remote "Fix the flaky test in auth.spec.ts"678claude --cloud "Fix the flaky test in auth.spec.ts"

679claude --remote "Update the API documentation"679claude --cloud "Update the API documentation"

680claude --remote "Refactor the logger to use structured output"680claude --cloud "Refactor the logger to use structured output"

681```681```

682 682 

683Мониторьте все сессии с помощью `/tasks` в Claude Code CLI. Когда сессия завершится, вы можете создать PR из веб-интерфейса или [телепортировать](#from-web-to-terminal) сессию в ваш терминал для продолжения работы.683Мониторьте все сессии с помощью `/tasks` в Claude Code CLI. Когда сессия завершится, вы можете создать PR из веб-интерфейса или [телепортировать](#from-web-to-terminal) сессию в ваш терминал для продолжения работы.


686 Отправляйте локальные репозитории без GitHub686 Отправляйте локальные репозитории без GitHub

687</h4>687</h4>

688 688 

689Когда вы запускаете `claude --remote` из репозитория, который не подключен к GitHub, Claude Code упаковывает ваш локальный репозиторий и загружает его непосредственно в облачную сессию. Пакет включает вашу полную историю репозитория во всех ветках, плюс любые незафиксированные изменения отслеживаемых файлов.689Когда вы запускаете `claude --cloud` из репозитория, который не подключен к GitHub, Claude Code упаковывает ваш локальный репозиторий и загружает его непосредственно в облачную сессию. Пакет включает вашу полную историю репозитория во всех ветках, плюс любые незафиксированные изменения отслеживаемых файлов.

690 690 

691Этот fallback активируется автоматически, когда доступ GitHub недоступен. Чтобы принудительно использовать его даже когда GitHub подключен, установите `CCR_FORCE_BUNDLE=1`:691Этот fallback активируется автоматически, когда доступ GitHub недоступен. Чтобы принудительно использовать его даже когда GitHub подключен, установите `CCR_FORCE_BUNDLE=1`:

692 692 

693```bash theme={null}693```bash theme={null}

694CCR_FORCE_BUNDLE=1 claude --remote "Run the test suite and fix any failures"694CCR_FORCE_BUNDLE=1 claude --cloud "Run the test suite and fix any failures"

695```695```

696 696 

697Упакованные репозитории должны соответствовать этим ограничениям:697Упакованные репозитории должны соответствовать этим ограничениям:


733 `--teleport` недоступен733 `--teleport` недоступен

734</h4>734</h4>

735 735 

736Телепортирование требует аутентификации подписки claude.ai. Если вы аутентифицированы через API ключ, Bedrock, Vertex AI или Microsoft Foundry, запустите `/login` для входа с вашим аккаунтом claude.ai вместо этого. Если вы уже вошли через claude.ai и `--teleport` всё ещё недоступен, ваша организация может отключить облачные сессии.736Телепортирование требует аутентификации подписки claude.ai. Если вы аутентифицированы через API ключ, Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, запустите `/login` для входа с вашим аккаунтом claude.ai вместо этого. Если вы уже вошли через claude.ai и `--teleport` всё ещё недоступен, ваша организация может отключить облачные сессии.

737 737 

738<h2 id="work-with-sessions">738<h2 id="work-with-sessions">

739 Работа с сессиями739 Работа с сессиями


745 Управление контекстом745 Управление контекстом

746</h3>746</h3>

747 747 

748Облачные сессии поддерживают [встроенные команды](/ru/commands), которые производят текстовый вывод. Команды, которые открывают интерактивный выбор терминала, такие как `/model` или `/config`, недоступны.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`.

749 749 

750Для управления контекстом конкретно:750Для управления контекстом конкретно:

751 751 

Details

270 270 

271`ANTHROPIC_AWS_WORKSPACE_ID` является обязательным и отправляется при каждом запросе как заголовок `anthropic-workspace-id`. Базовый URL вычисляется из `AWS_REGION` как `https://aws-external-anthropic.{region}.api.aws`. Чтобы переопределить URL напрямую, установите `ANTHROPIC_AWS_BASE_URL`.271`ANTHROPIC_AWS_WORKSPACE_ID` является обязательным и отправляется при каждом запросе как заголовок `anthropic-workspace-id`. Базовый URL вычисляется из `AWS_REGION` как `https://aws-external-anthropic.{region}.api.aws`. Чтобы переопределить URL напрямую, установите `ANTHROPIC_AWS_BASE_URL`.

272 272 

273Claude Platform on AWS является добровольным, даже если учетные данные AWS присутствуют в вашей среде. Bedrock и Foundry имеют приоритет в маршрутизации поставщиков, поэтому отмените установку `CLAUDE_CODE_USE_BEDROCK` и `CLAUDE_CODE_USE_FOUNDRY`, если они установлены.273Claude Platform on AWS является добровольным, даже если учетные данные AWS присутствуют в вашей среде. Amazon Bedrock и Microsoft Foundry имеют приоритет в маршрутизации поставщиков, поэтому отмените установку `CLAUDE_CODE_USE_BEDROCK` и `CLAUDE_CODE_USE_FOUNDRY`, если они установлены.

274 274 

275<h3 id="3-pin-model-versions">275<h3 id="3-pin-model-versions">

276 3. Закрепите версии моделей276 3. Закрепите версии моделей

cli-reference.md +10 −7

Details

22| `claude -c -p "query"` | Продолжить через SDK | `claude -c -p "Check for type errors"` |22| `claude -c -p "query"` | Продолжить через SDK | `claude -c -p "Check for type errors"` |

23| `claude -r "<session>" "query"` | Возобновить сеанс по ID или имени | `claude -r "auth-refactor" "Finish this PR"` |23| `claude -r "<session>" "query"` | Возобновить сеанс по ID или имени | `claude -r "auth-refactor" "Finish this PR"` |

24| `claude update` | Обновить до последней версии | `claude update` |24| `claude update` | Обновить до последней версии | `claude update` |

25| `claude gateway` | Запустить сервер самостоятельно размещаемого [Claude apps gateway](/ru/claude-apps-gateway), для администраторов, развертывающих SSO и политику перед Claude Code на Bedrock, Vertex AI или Foundry. Требует `--config`, указывающий на [`gateway.yaml`](/ru/claude-apps-gateway-config). Доступно в Claude Code v2.1.195 и позже. | `claude gateway --config gateway.yaml` |25| `claude gateway` | Запустить сервер самостоятельно размещаемого [Claude apps gateway](/ru/claude-apps-gateway), для администраторов, развертывающих SSO и политику перед Claude Code на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Требует `--config`, указывающий на [`gateway.yaml`](/ru/claude-apps-gateway-config). Доступно в Claude Code v2.1.195 и позже. | `claude gateway --config gateway.yaml` |

26| `claude install [version]` | Установить или переустановить собственный двоичный файл. Принимает версию, такую как `2.1.118`, или `stable`, или `latest`. См. [Установить конкретную версию](/ru/setup#install-a-specific-version) | `claude install stable` |26| `claude install [version]` | Установить или переустановить собственный двоичный файл. Принимает версию, такую как `2.1.118`, или `stable`, или `latest`. См. [Установить конкретную версию](/ru/setup#install-a-specific-version) | `claude install stable` |

27| `claude auth login` | Войти в свою учетную запись Anthropic. Используйте `--email` для предварительного заполнения адреса электронной почты, `--sso` для принудительной аутентификации SSO и `--console` для входа с помощью Anthropic Console для выставления счетов за использование API вместо подписки Claude | `claude auth login --console` |27| `claude auth login` | Войти в свою учетную запись Anthropic. Используйте `--email` для предварительного заполнения адреса электронной почты, `--sso` для принудительной аутентификации SSO и `--console` для входа с помощью Anthropic Console для выставления счетов за использование API вместо подписки Claude | `claude auth login --console` |

28| `claude auth logout` | Выйти из своей учетной записи Anthropic | `claude auth logout` |28| `claude auth logout` | Выйти из своей учетной записи Anthropic | `claude auth logout` |


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` для просмотра вашей эффективной конфигурации с применяемыми параметрами | `claude auto-mode defaults > rules.json` |

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 logs <id>` | Вывести недавний вывод из [фонового сеанса](/ru/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |36| `claude logs <id>` | Вывести недавний вывод из [фонового сеанса](/ru/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |

36| `claude mcp` | Настроить серверы Model Context Protocol (MCP) | См. [документацию Claude Code MCP](/ru/mcp). |37| `claude mcp` | Настроить серверы Model Context Protocol (MCP) | См. [документацию Claude Code MCP](/ru/mcp). |

37| `claude mcp login <name>` | {/* min-version: 2.1.186 */}Запустить поток OAuth настроенного сервера MCP без открытия интерактивной панели `/mcp`. Работает для HTTP, SSE и серверов соединителя claude.ai. Добавьте `--no-browser` через SSH для вывода URL авторизации вместо открытия браузера, затем вставьте URL перенаправления обратно в приглашение. Требует Claude Code версии 2.1.186 или позже. См. [Аутентификация из командной строки](/ru/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |38| `claude mcp login <name>` | {/* min-version: 2.1.186 */}Запустить поток OAuth настроенного сервера MCP без открытия интерактивной панели `/mcp`. Работает для HTTP, SSE и серверов соединителя claude.ai. Добавьте `--no-browser` через SSH для вывода URL авторизации вместо открытия браузера, затем вставьте URL перенаправления обратно в приглашение. Требует Claude Code версии 2.1.186 или позже. См. [Аутентификация из командной строки](/ru/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |


63| `--agents` | Определить пользовательские subagents динамически через JSON. Использует те же имена полей, что и subagent [frontmatter](/ru/sub-agents#supported-frontmatter-fields), плюс поле `prompt` для инструкций агента | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |64| `--agents` | Определить пользовательские subagents динамически через JSON. Использует те же имена полей, что и subagent [frontmatter](/ru/sub-agents#supported-frontmatter-fields), плюс поле `prompt` для инструкций агента | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

64| `--allow-dangerously-skip-permissions` | Добавить `bypassPermissions` в цикл режима `Shift+Tab` без немедленной активации. Позволяет начать в другом режиме, таком как `plan`, и переключиться на `bypassPermissions` позже. См. [режимы разрешения](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |65| `--allow-dangerously-skip-permissions` | Добавить `bypassPermissions` в цикл режима `Shift+Tab` без немедленной активации. Позволяет начать в другом режиме, таком как `plan`, и переключиться на `bypassPermissions` позже. См. [режимы разрешения](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

65| `--allowedTools`, `--allowed-tools` | Инструменты, которые выполняются без запроса разрешения. См. [синтаксис правила разрешения](/ru/settings#permission-rule-syntax) для сопоставления шаблонов. Чтобы ограничить доступные инструменты, используйте `--tools` вместо этого | `"Bash(git log *)" "Bash(git diff *)" "Read"` |66| `--allowedTools`, `--allowed-tools` | Инструменты, которые выполняются без запроса разрешения. См. [синтаксис правила разрешения](/ru/settings#permission-rule-syntax) для сопоставления шаблонов. Чтобы ограничить доступные инструменты, используйте `--tools` вместо этого | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}Добавить пользовательский текст в конец системного приглашения каждого [subagent](/ru/sub-agents), включая вложенные subagents. Применяется только в неинтерактивном режиме с `-p`. Требует Claude Code v2.1.205 или позже | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

66| `--append-system-prompt` | Добавить пользовательский текст в конец системного приглашения по умолчанию | `claude --append-system-prompt "Always use TypeScript"` |68| `--append-system-prompt` | Добавить пользовательский текст в конец системного приглашения по умолчанию | `claude --append-system-prompt "Always use TypeScript"` |

67| `--append-system-prompt-file` | Загрузить дополнительный текст системного приглашения из файла и добавить к приглашению по умолчанию | `claude --append-system-prompt-file ./extra-rules.txt` |69| `--append-system-prompt-file` | Загрузить дополнительный текст системного приглашения из файла и добавить к приглашению по умолчанию | `claude --append-system-prompt-file ./extra-rules.txt` |

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


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

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

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

76| `--cloud` | Создать новый [веб-сеанс](/ru/claude-code-on-the-web) на claude.ai с предоставленным описанием задачи | `claude --cloud "Fix the login bug"` |

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

75| `--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` |

76| `--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) для информации о том, что это пропускает и что не пропускает | `claude --dangerously-skip-permissions` |


78| `--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` |

79| `--disable-slash-commands` | Отключить все skills и команды для этого сеанса | `claude --disable-slash-commands` |82| `--disable-slash-commands` | Отключить все skills и команды для этого сеанса | `claude --disable-slash-commands` |

80| `--disallowedTools`, `--disallowed-tools` | Правила отрицания. Простое имя инструмента удаляет соответствующие инструменты из контекста модели: `"Edit"` удаляет Edit, `"*"` удаляет каждый инструмент, и `"mcp__*"` удаляет каждый MCP инструмент. Правило с областью действия, такое как `Bash(rm *)`, оставляет инструмент доступным и отрицает только совпадающие вызовы | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |83| `--disallowedTools`, `--disallowed-tools` | Правила отрицания. Простое имя инструмента удаляет соответствующие инструменты из контекста модели: `"Edit"` удаляет Edit, `"*"` удаляет каждый инструмент, и `"mcp__*"` удаляет каждый MCP инструмент. Правило с областью действия, такое как `Bash(rm *)`, оставляет инструмент доступным и отрицает только совпадающие вызовы | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

81| `--effort` | Установить [уровень усилий](/ru/model-config#adjust-effort-level) для текущего сеанса. Опции: `low`, `medium`, `high`, `xhigh`, `max`; доступные уровни зависят от модели. Переопределяет параметр [`effortLevel`](/ru/settings#available-settings) для этого сеанса и не сохраняется | `claude --effort high` |84| `--effort` | Установить [уровень усилий](/ru/model-config#adjust-effort-level) для текущего сеанса. Опции: `low`, `medium`, `high`, `xhigh`, `max` или {/* min-version: 2.1.203 */}}`ultracode`. Доступные уровни зависят от модели. `ultracode` запускает сеанс с усилием `xhigh` с включенным [ultracode](/ru/workflows#let-claude-decide-with-ultracode) и требует Claude Code v2.1.203 или позже. Переопределяет параметр [`effortLevel`](/ru/settings#available-settings) для этого сеанса и не сохраняется | `claude --effort high` |

82| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Удалено в v2.1.111. Auto mode теперь находится в цикле `Shift+Tab` по умолчанию; используйте `--permission-mode auto` для запуска в нем | `claude --permission-mode auto` |85| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Удалено в v2.1.111. Auto mode теперь находится в цикле `Shift+Tab` по умолчанию; используйте `--permission-mode auto` для запуска в нем | `claude --permission-mode auto` |

83| `--exclude-dynamic-system-prompt-sections` | Переместить разделы для каждой машины из системного приглашения (рабочий каталог, информация об окружении, пути памяти, флаг git-repo) в первое пользовательское сообщение. Улучшает повторное использование prompt-cache на разных пользователях и машинах, запускающих одну и ту же задачу. Применяется только с системным приглашением по умолчанию; игнорируется, когда установлены `--system-prompt` или `--system-prompt-file`. Используйте с `-p` для скриптовых многопользовательских рабочих нагрузок | `claude -p --exclude-dynamic-system-prompt-sections "query"` |86| `--exclude-dynamic-system-prompt-sections` | Переместить разделы для каждой машины из системного приглашения (рабочий каталог, информация об окружении, пути памяти, флаг git-repo) в первое пользовательское сообщение. Улучшает повторное использование prompt-cache на разных пользователях и машинах, запускающих одну и ту же задачу. Применяется только с системным приглашением по умолчанию; игнорируется, когда установлены `--system-prompt` или `--system-prompt-file`. Используйте с `-p` для скриптовых многопользовательских рабочих нагрузок | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

84| `--exec` | Запустить команду shell как фоновое задание с поддержкой PTY вместо запуска сеанса Claude. Используйте с `--bg` для запуска из shell | `claude --bg --exec 'pytest -x'` |87| `--exec` | Запустить команду shell как фоновое задание с поддержкой PTY вместо запуска сеанса Claude. Используйте с `--bg` для запуска из shell | `claude --bg --exec 'pytest -x'` |


91| `--include-hook-events` | Включить все события жизненного цикла hook в выходной поток. Требует `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |94| `--include-hook-events` | Включить все события жизненного цикла hook в выходной поток. Требует `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |

92| `--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"` |

93| `--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` |

94| `--json-schema` | Получить проверенный вывод JSON, соответствующий JSON Schema после завершения рабочего процесса агента (только режим печати, см. [структурированные выходы](/ru/agent-sdk/structured-outputs)) | `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"` |

95| `--maintenance` | Запустить [Setup hooks](/ru/hooks#setup) с помощью matcher `maintenance` перед сеансом (только режим печати) | `claude -p --maintenance "query"` |98| `--maintenance` | Запустить [Setup hooks](/ru/hooks#setup) с помощью matcher `maintenance` перед сеансом (только режим печати) | `claude -p --maintenance "query"` |

96| `--max-budget-usd` | Максимальная сумма в долларах для расходования на вызовы API перед остановкой (только режим печати) | `claude -p --max-budget-usd 5.00 "query"` |99| `--max-budget-usd` | Максимальная сумма в долларах для расходования на вызовы API перед остановкой (только режим печати) | `claude -p --max-budget-usd 5.00 "query"` |

97| `--max-turns` | Ограничить количество агентских ходов (только режим печати). Выходит с ошибкой при достижении лимита. По умолчанию нет лимита | `claude -p --max-turns 3 "query"` |100| `--max-turns` | Ограничить количество агентских ходов (только режим печати). Выходит с ошибкой при достижении лимита. По умолчанию нет лимита. {/* min-version: 2.1.205 */}С `--input-format stream-json` сообщение, отправленное во время работы Claude, остается в очереди и выполняется как собственный ход с собственным лимитом, когда лимит заканчивает текущий. До v2.1.205 Claude Code отбрасывал это сообщение | `claude -p --max-turns 3 "query"` |

98| `--mcp-config` | Загрузить MCP серверы из JSON файлов или строк (разделенные пробелом) | `claude --mcp-config ./mcp.json` |101| `--mcp-config` | Загрузить MCP серверы из JSON файлов или строк (разделенные пробелом) | `claude --mcp-config ./mcp.json` |

99| `--model` | Устанавливает модель для текущего сеанса с псевдонимом для последней модели (`sonnet`, `opus`, `haiku` или `fable`) или полным именем модели. Переопределяет параметр [`model`](/ru/settings#available-settings) и [`ANTHROPIC_MODEL`](/ru/model-config#environment-variables) | `claude --model claude-sonnet-5` |102| `--model` | Устанавливает модель для текущего сеанса с псевдонимом для последней модели (`sonnet`, `opus`, `haiku` или `fable`) или полным именем модели. Переопределяет параметр [`model`](/ru/settings#available-settings) и [`ANTHROPIC_MODEL`](/ru/model-config#environment-variables) | `claude --model claude-sonnet-5` |

100| `--name`, `-n` | Установить отображаемое имя для сеанса, показываемое в `/resume` и в заголовке терминала. Вы можете возобновить именованный сеанс с помощью `claude --resume <name>`. <br /><br />[`/rename`](/ru/commands) изменяет имя во время сеанса и также показывает его на панели приглашения | `claude -n "my-feature-work"` |103| `--name`, `-n` | Установить отображаемое имя для сеанса, показываемое в `/resume` и в заголовке терминала. Вы можете возобновить именованный сеанс с помощью `claude --resume <name>`. <br /><br />[`/rename`](/ru/commands) изменяет имя во время сеанса и также показывает его на панели приглашения | `claude -n "my-feature-work"` |

101| `--no-chrome` | Отключить [интеграцию браузера Chrome](/ru/chrome) для этого сеанса | `claude --no-chrome` |104| `--no-chrome` | Отключить [интеграцию браузера Chrome](/ru/chrome) для этого сеанса | `claude --no-chrome` |

102| `--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"` |

103| `--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` |

104| `--permission-mode` | Начать в указанном [режиме разрешения](/ru/permission-modes). Принимает `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` или `bypassPermissions`. Переопределяет `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` |

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

106| `--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` |

107| `--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` |

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

109| `--prompt-suggestions` | Выдать сообщение `prompt_suggestion` после каждого хода с предсказанным следующим приглашением пользователя. Требует `--print`, `--output-format stream-json` и `--verbose`. См. [Предложения приглашений](/ru/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |112| `--prompt-suggestions` | Выдать сообщение `prompt_suggestion` после каждого хода с предсказанным следующим приглашением пользователя. Требует `--print`, `--output-format stream-json` и `--verbose`. См. [Предложения приглашений](/ru/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

110| `--remote` | Создать новый [веб-сеанс](/ru/claude-code-on-the-web) на claude.ai с предоставленным описанием задачи | `claude --remote "Fix the login bug"` |113| `--remote` | Устаревший псевдоним для `--cloud` | `claude --remote "Fix the login bug"` |

111| `--remote-control`, `--rc` | Запустить интерактивный сеанс с включенным [Remote Control](/ru/remote-control#start-a-remote-control-session), чтобы вы также могли управлять им из claude.ai или приложения Claude. Опционально передайте имя для сеанса | `claude --remote-control "My Project"` |114| `--remote-control`, `--rc` | Запустить интерактивный сеанс с включенным [Remote Control](/ru/remote-control#start-a-remote-control-session), чтобы вы также могли управлять им из claude.ai или приложения Claude. Опционально передайте имя для сеанса | `claude --remote-control "My Project"` |

112| `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически генерируемых имен сеансов [Remote Control](/ru/remote-control) при отсутствии явного имени. По умолчанию используется имя хоста вашей машины, создавая имена вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта | `claude remote-control --remote-control-session-name-prefix dev-box` |115| `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически генерируемых имен сеансов [Remote Control](/ru/remote-control) при отсутствии явного имени. По умолчанию используется имя хоста вашей машины, создавая имена вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта | `claude remote-control --remote-control-session-name-prefix dev-box` |

113| `--replay-user-messages` | Повторно отправить пользовательские сообщения из stdin обратно на stdout для подтверждения. Требует `--input-format stream-json` и `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |116| `--replay-user-messages` | Повторно отправить пользовательские сообщения из stdin обратно на stdout для подтверждения. Требует `--input-format stream-json` и `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |


120| `--system-prompt` | Заменить весь системный запрос пользовательским текстом | `claude --system-prompt "You are a Python expert"` |123| `--system-prompt` | Заменить весь системный запрос пользовательским текстом | `claude --system-prompt "You are a Python expert"` |

121| `--system-prompt-file` | Загрузить системный запрос из файла, заменяя приглашение по умолчанию | `claude --system-prompt-file ./custom-prompt.txt` |124| `--system-prompt-file` | Загрузить системный запрос из файла, заменяя приглашение по умолчанию | `claude --system-prompt-file ./custom-prompt.txt` |

122| `--teleport` | Возобновить [веб-сеанс](/ru/claude-code-on-the-web) в вашем локальном терминале | `claude --teleport` |125| `--teleport` | Возобновить [веб-сеанс](/ru/claude-code-on-the-web) в вашем локальном терминале | `claude --teleport` |

123| `--teammate-mode` | Установить способ отображения товарищей по [команде агентов](/ru/agent-teams): `in-process` (по умолчанию), `auto`, `tmux` или {/* min-version: 2.1.186 */}`iterm2` (добавлено в v2.1.186). Значение по умолчанию изменилось с `auto` в v2.1.179. Переопределяет параметр [`teammateMode`](/ru/settings#available-settings) для этого сеанса. См. [выбор режима отображения](/ru/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |126| `--teammate-mode` | Установить способ отображения товарищей по [команде агентов](/ru/agent-teams): `in-process` (по умолчанию), `auto`, `tmux` или {/* min-version: 2.1.186 */}}`iterm2` (добавлено в v2.1.186). Значение по умолчанию изменилось с `auto` в v2.1.179. Переопределяет параметр [`teammateMode`](/ru/settings#available-settings) для этого сеанса. См. [выбор режима отображения](/ru/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |

124| `--tmux` | Создать сеанс tmux для worktree. Требует `--worktree`. Использует встроенные панели iTerm2, если доступны; передайте `--tmux=classic` для традиционного tmux | `claude -w feature-auth --tmux` |127| `--tmux` | Создать сеанс tmux для worktree. Требует `--worktree`. Использует встроенные панели iTerm2, если доступны; передайте `--tmux=classic` для традиционного tmux | `claude -w feature-auth --tmux` |

125| `--tools` | Ограничить, какие встроенные инструменты может использовать Claude. Используйте `""` для отключения всех, `"default"` для всех или имена инструментов, такие как `"Bash,Edit,Read"`. MCP инструменты не затронуты; чтобы отрицать и их, используйте `--disallowedTools "mcp__*"` или передайте `--strict-mcp-config` без `--mcp-config`, чтобы не загружались MCP серверы | `claude --tools "Bash,Edit,Read"` |128| `--tools` | Ограничить, какие встроенные инструменты может использовать Claude. Используйте `""` для отключения всех, `"default"` для всех или имена инструментов, такие как `"Bash,Edit,Read"`. MCP инструменты не затронуты; чтобы отрицать и их, используйте `--disallowedTools "mcp__*"` или передайте `--strict-mcp-config` без `--mcp-config`, чтобы не загружались MCP серверы | `claude --tools "Bash,Edit,Read"` |

126| `--verbose` | Включить подробное логирование, показывает полный вывод по ходам. Переопределяет параметр [`viewMode`](/ru/settings#available-settings) для этого сеанса | `claude --verbose` |129| `--verbose` | Включить подробное логирование, показывает полный вывод по ходам. Переопределяет параметр [`viewMode`](/ru/settings#available-settings) для этого сеанса | `claude --verbose` |

code-review.md +1 −1

Details

275 275 

276В любом режиме комментарий `@claude review` [выбирает PR для проверок, запускаемых при push](#manually-trigger-reviews), поэтому дополнительные затраты накапливаются при каждом push после этого комментария. Чтобы запустить одну проверку без подписки на будущие push, прокомментируйте `@claude review once` вместо этого.276В любом режиме комментарий `@claude review` [выбирает PR для проверок, запускаемых при push](#manually-trigger-reviews), поэтому дополнительные затраты накапливаются при каждом push после этого комментария. Чтобы запустить одну проверку без подписки на будущие push, прокомментируйте `@claude review once` вместо этого.

277 277 

278Затраты появляются в вашем счёте Anthropic независимо от того, использует ли ваша организация Amazon Bedrock или Google Vertex AI для других функций Claude Code. Чтобы установить ежемесячный лимит расходов для Code Review, перейдите на [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) и настройте лимит для сервиса Claude Code Review.278Затраты появляются в вашем счёте Anthropic независимо от того, использует ли ваша организация Amazon Bedrock или Google Cloud's Agent Platform для других функций Claude Code. Чтобы установить ежемесячный лимит расходов для Code Review, перейдите на [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) и настройте лимит для сервиса Claude Code Review.

279 279 

280Отслеживайте расходы через еженедельную диаграмму затрат в [аналитике](#view-usage) или столбец средней стоимости для каждого репо в параметрах администратора.280Отслеживайте расходы через еженедельную диаграмму затрат в [аналитике](#view-usage) или столбец средней стоимости для каждого репо в параметрах администратора.

281 281 

commands.md +14 −14

Details

24 24 

25**Параллельное выполнение работы.** Claude делегирует побочные задачи [subagents](/ru/sub-agents), и `/tasks` выводит список того, что выполняется в фоне текущего сеанса. `/background` отделяет весь сеанс, чтобы он продолжал работать как [фоновый агент](/ru/agent-view), и освобождает ваш терминал. Для крупного изменения, охватывающего всю кодовую базу, `/batch` разбивает его на независимые единицы и запускает каждую в своем собственном [worktree](/ru/worktrees). Смотрите [Запуск агентов параллельно](/ru/agents), чтобы понять, как эти подходы связаны между собой.25**Параллельное выполнение работы.** Claude делегирует побочные задачи [subagents](/ru/sub-agents), и `/tasks` выводит список того, что выполняется в фоне текущего сеанса. `/background` отделяет весь сеанс, чтобы он продолжал работать как [фоновый агент](/ru/agent-view), и освобождает ваш терминал. Для крупного изменения, охватывающего всю кодовую базу, `/batch` разбивает его на независимые единицы и запускает каждую в своем собственном [worktree](/ru/worktrees). Смотрите [Запуск агентов параллельно](/ru/agents), чтобы понять, как эти подходы связаны между собой.

26 26 

27**Перед отправкой.** `/diff` показывает, что изменилось, `/code-review` проверяет diff на наличие ошибок корректности и очистки и может применить результаты с помощью `--fix`, `/review` запускает ту же проверку только для чтения на GitHub pull request, а `/security-review` дает более глубокий проход только для чтения. `/code-review ultra` запускает многоагентный обзор в облаке.27**Перед отправкой.** `/diff` показывает, что изменилось, `/code-review` проверяет diff на наличие ошибок корректности и очистки и может применить результаты с помощью `--fix`, `/review` запускает быструю однопроходную проверку только для чтения GitHub pull request, `/code-review <level> <pr#>` запускает многоагентный обзор одного, а `/security-review` проверяет diff на наличие уязвимостей безопасности. `/code-review ultra` запускает многоагентный обзор в облаке.

28 28 

29**Между сеансами.** `/clear` начинает заново с новой задачей, сохраняя память проекта. `/resume` и `/branch` позволяют вернуться к более ранней беседе или создать ветвь. `/teleport` переносит веб-сеанс в этот терминал, а `/remote-control` позволяет продолжить этот локальный сеанс с другого устройства.29**Между сеансами.** `/clear` начинает заново с новой задачей, сохраняя память проекта. `/resume` и `/branch` позволяют вернуться к более ранней беседе или создать ветвь. `/teleport` переносит веб-сеанс в этот терминал, а `/remote-control` позволяет продолжить этот локальный сеанс с другого устройства.

30 30 

31**Когда что-то не так.** `/rewind` откатывает код и беседу к контрольной точке или суммирует часть беседы. `/doctor` и `/debug` диагностируют проблемы установки и выполнения, а `/feedback` сообщает об ошибке с контекстом сеанса.31**Когда что-то не так.** `/rewind` откатывает код и беседу к контрольной точке или суммирует часть беседы. `/doctor` запускает проверку настройки, которая диагностирует проблемы установки и конфигурации и может их исправить, `/debug` диагностирует проблемы выполнения, а `/feedback` сообщает об ошибке с контекстом сеанса.

32 32 

33<h2 id="all-commands">33<h2 id="all-commands">

34 Все команды34 Все команды


48</Note>48</Note>

49 49 

50| Команда | Назначение |50| Команда | Назначение |

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

52| `/add-dir <path>` | Добавить рабочий каталог для доступа к файлам во время текущего сеанса. Большинство конфигурации `.claude/` [не обнаруживается](/ru/permissions#additional-directories-grant-file-access-not-configuration) из добавленного каталога. Вы можете позже возобновить сеанс из добавленного каталога с помощью `--continue` или `--resume` |52| `/add-dir <path>` | Добавить рабочий каталог для доступа к файлам во время текущего сеанса. Большинство конфигурации `.claude/` [не обнаруживается](/ru/permissions#additional-directories-grant-file-access-not-configuration) из добавленного каталога. Вы можете позже возобновить сеанс из добавленного каталога с помощью `--continue` или `--resume` |

53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}Включить или отключить [инструмент advisor](/ru/advisor), который консультирует вторую модель для получения рекомендаций в ключевые моменты во время задачи. Принимает `opus`, `sonnet`, `fable` ({/* min-version: 2.1.170 */}v2.1.170+) или полный ID модели. Без аргумента открывает выбор. Требует Claude Code v2.1.98 или позже |53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}Включить или отключить [инструмент advisor](/ru/advisor), который консультирует вторую модель для получения рекомендаций в ключевые моменты во время задачи. Принимает `opus`, `sonnet`, `fable` ({/* min-version: 2.1.170 */}v2.1.170+) или полный ID модели. Без аргумента открывает выбор. Требует Claude Code v2.1.98 или позже |

54| `/agents` | {/* min-version: 2.1.198 */}Начиная с v2.1.198, запуск `/agents` выводит напоминание попросить Claude создать или управлять [подагентами](/ru/sub-agents) или отредактировать `.claude/agents/` или `~/.claude/agents/` напрямую. {/* max-version: 2.1.197 */}На v2.1.197 и более ранних версиях открывает интерактивный интерфейс для создания и управления конфигурациями подагентов |54| `/agents` | {/* min-version: 2.1.198 */}Начиная с v2.1.198, запуск `/agents` выводит напоминание попросить Claude создать или управлять [подагентами](/ru/sub-agents) или отредактировать `.claude/agents/` или `~/.claude/agents/` напрямую. {/* max-version: 2.1.197 */}На v2.1.197 и более ранних версиях открывает интерактивный интерфейс для создания и управления конфигурациями подагентов |


62| `/claude-api [migrate\|managed-agents-onboard]` | **[Skill](/ru/skills#bundled-skills).** Загрузить справочный материал Claude API для языка вашего проекта (Python, TypeScript, Java, Go, Ruby, C#, PHP или cURL) и справочник Managed Agents. Охватывает использование инструментов, потоковую передачу, пакеты, структурированные выходы и распространенные ошибки. Также активируется автоматически, когда ваш код импортирует `anthropic` или `@anthropic-ai/sdk`. Запустите `/claude-api migrate` для обновления существующего кода Claude API на более новую модель: Claude спрашивает, какие файлы сканировать и какую модель выбрать, затем обновляет ID моделей, конфигурацию thinking и другие параметры, которые изменились между версиями. Запустите `/claude-api managed-agents-onboard` для интерактивного пошагового руководства, которое создает новый Managed Agent с нуля |62| `/claude-api [migrate\|managed-agents-onboard]` | **[Skill](/ru/skills#bundled-skills).** Загрузить справочный материал Claude API для языка вашего проекта (Python, TypeScript, Java, Go, Ruby, C#, PHP или cURL) и справочник Managed Agents. Охватывает использование инструментов, потоковую передачу, пакеты, структурированные выходы и распространенные ошибки. Также активируется автоматически, когда ваш код импортирует `anthropic` или `@anthropic-ai/sdk`. Запустите `/claude-api migrate` для обновления существующего кода Claude API на более новую модель: Claude спрашивает, какие файлы сканировать и какую модель выбрать, затем обновляет ID моделей, конфигурацию thinking и другие параметры, которые изменились между версиями. Запустите `/claude-api managed-agents-onboard` для интерактивного пошагового руководства, которое создает новый Managed Agent с нуля |

63| `/clear [name]` | Начать новую беседу с пустым контекстом. Предыдущая беседа остается доступной в `/resume`. Передайте имя для обозначения предыдущей беседы в выборщике `/resume`. Чтобы освободить контекст при продолжении той же беседы, используйте `/compact`. Псевдонимы: `/reset`, `/new` |63| `/clear [name]` | Начать новую беседу с пустым контекстом. Предыдущая беседа остается доступной в `/resume`. Передайте имя для обозначения предыдущей беседы в выборщике `/resume`. Чтобы освободить контекст при продолжении той же беседы, используйте `/compact`. Псевдонимы: `/reset`, `/new` |

64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/ru/skills#bundled-skills).** Просмотреть текущий diff на предмет ошибок корректности и предложить улучшения по переиспользованию, упрощению и эффективности. Передайте `--fix` для применения результатов к вашему рабочему дереву, `--comment` для публикации их как встроенных комментариев GitHub PR, или `ultra` для запуска глубокого [облачного просмотра](/ru/ultrareview). {/* min-version: 2.1.154 */}Начиная с v2.1.154, `/simplify` запускает отдельный просмотр только для очистки, который применяет исправления без поиска ошибок. См. [Просмотр diff локально](/ru/code-review#review-a-diff-locally) для уровней усилий и целей |64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/ru/skills#bundled-skills).** Просмотреть текущий diff на предмет ошибок корректности и предложить улучшения по переиспользованию, упрощению и эффективности. Передайте `--fix` для применения результатов к вашему рабочему дереву, `--comment` для публикации их как встроенных комментариев GitHub PR, или `ultra` для запуска глубокого [облачного просмотра](/ru/ultrareview). {/* min-version: 2.1.154 */}Начиная с v2.1.154, `/simplify` запускает отдельный просмотр только для очистки, который применяет исправления без поиска ошибок. См. [Просмотр diff локально](/ru/code-review#review-a-diff-locally) для уровней усилий и целей |

65| `/color [color\|default]` | Установить цвет строки приглашения для текущего сеанса. Доступные цвета: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Используйте `default` для сброса, или запустите без аргумента для выбора случайного цвета. Когда подключен [Remote Control](/ru/remote-control), цвет синхронизируется с claude.ai/code |65| `/color [color\|default]` | Установить цвет строки приглашения для текущего сеанса. Доступные цвета: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Используйте `default` для сброса, или запустите без аргумента для выбора случайного цвета. Когда подключен [Remote Control](/ru/remote-control), цвет синхронизируется с claude.ai/code. {/* min-version: 2.1.205 */}Также доступно в неинтерактивном режиме (`-p`); требует Claude Code v2.1.205 или позже |

66| `/compact [instructions]` | Освободить контекст путем суммирования беседы до сих пор. Опционально передайте инструкции фокуса для сводки. См. [как сжатие обрабатывает правила, skills и файлы памяти](/ru/context-window#what-survives-compaction) |66| `/compact [instructions]` | Освободить контекст путем суммирования беседы до сих пор. Опционально передайте инструкции фокуса для сводки. См. [как сжатие обрабатывает правила, skills и файлы памяти](/ru/context-window#what-survives-compaction) |

67| `/config [key=value ...]` | Открыть интерфейс [Параметры](/ru/settings) для настройки темы, модели, [стиля вывода](/ru/output-styles) и других предпочтений. {/* min-version: 2.1.181 */}Начиная с v2.1.181, передайте одну или несколько пар `key=value` для установки параметра непосредственно без открытия интерфейса, например `/config thinking=false`. {/* min-version: 2.1.182 */}Начиная с v2.1.182, также принимаются именованные сокращенные ключи, такие как `/config theme=dark` или `/config model=sonnet`. Форма `key=value` также работает в неинтерактивном режиме (`-p`) и из [Remote Control](/ru/remote-control). Запустите `/config --help` для списка каждого устанавливаемого ключа с его опциями. Псевдоним: `/settings` |67| `/config [key=value ...]` | Открыть интерфейс [Параметры](/ru/settings) для настройки темы, модели, [стиля вывода](/ru/output-styles) и других предпочтений. {/* min-version: 2.1.181 */}Начиная с v2.1.181, передайте одну или несколько пар `key=value` для установки параметра непосредственно без открытия интерфейса, например `/config thinking=false`. {/* min-version: 2.1.182 */}Начиная с v2.1.182, также принимаются именованные сокращенные ключи, такие как `/config theme=dark` или `/config model=sonnet`. Форма `key=value` также работает в неинтерактивном режиме (`-p`) и из [Remote Control](/ru/remote-control). Запустите `/config --help` для списка каждого устанавливаемого ключа с его опциями. Псевдоним: `/settings` |

68| `/context [all]` | Визуализировать текущее использование контекста в виде цветной сетки. Показывает предложения по оптимизации для инструментов, требующих много контекста, утечек памяти и предупреждений о емкости. В [полноэкранном режиме](/ru/fullscreen) разбивка по элементам свернута, чтобы сетка оставалась видимой. Передайте `all` для развертывания |68| `/context [all]` | Визуализировать текущее использование контекста в виде цветной сетки. Показывает предложения по оптимизации для инструментов, требующих много контекста, утечек памяти и предупреждений о емкости. В [полноэкранном режиме](/ru/fullscreen) разбивка по элементам свернута, чтобы сетка оставалась видимой. Передайте `all` для развертывания |


75| `/design-sync [hint]` | **[Skill](/ru/skills#bundled-skills).** Преобразовать систему дизайна React вашего репозитория и загрузить ее в [Claude Design](https://claude.ai/design), чтобы создаваемые ею дизайны использовали ваши реальные компоненты. Опционально назовите систему дизайна, например `/design-sync Acme DS`. Первоначальная синхронизация проверяет каждый компонент и может занять несколько часов на большом репозитории. Доступно на Anthropic API; на Amazon Bedrock, платформе Google Cloud Agent Platform и Microsoft Foundry базовый инструмент не может достичь claude.ai, поэтому команда недоступна |75| `/design-sync [hint]` | **[Skill](/ru/skills#bundled-skills).** Преобразовать систему дизайна React вашего репозитория и загрузить ее в [Claude Design](https://claude.ai/design), чтобы создаваемые ею дизайны использовали ваши реальные компоненты. Опционально назовите систему дизайна, например `/design-sync Acme DS`. Первоначальная синхронизация проверяет каждый компонент и может занять несколько часов на большом репозитории. Доступно на Anthropic API; на Amazon Bedrock, платформе Google Cloud Agent Platform и Microsoft Foundry базовый инструмент не может достичь claude.ai, поэтому команда недоступна |

76| `/desktop` | Продолжить текущий сеанс в приложении Claude Code Desktop. Требует macOS или Windows и подписку Claude. Псевдоним: `/app` |76| `/desktop` | Продолжить текущий сеанс в приложении Claude Code Desktop. Требует macOS или Windows и подписку Claude. Псевдоним: `/app` |

77| `/diff` | Открыть интерактивное средство просмотра различий, показывающее незафиксированные изменения и различия для каждого хода. Используйте стрелки влево/вправо для переключения между текущим git diff и отдельными ходами Claude, а вверх/вниз для просмотра файлов. {/* min-version: 2.1.198 */}Начиная с v2.1.198, открытое средство просмотра также автоматически обновляется при изменении состояния git репозитория вне сеанса, например при переключении ветви или коммите в другом терминале |77| `/diff` | Открыть интерактивное средство просмотра различий, показывающее незафиксированные изменения и различия для каждого хода. Используйте стрелки влево/вправо для переключения между текущим git diff и отдельными ходами Claude, а вверх/вниз для просмотра файлов. {/* min-version: 2.1.198 */}Начиная с v2.1.198, открытое средство просмотра также автоматически обновляется при изменении состояния git репозитория вне сеанса, например при переключении ветви или коммите в другом терминале |

78| `/doctor` | Диагностировать и проверить вашу установку и параметры Claude Code. Результаты отображаются со значками статуса. Нажмите `f`, чтобы Claude исправил любые сообщаемые проблемы |78| `/doctor` | **[Skill](/ru/skills#bundled-skills).** Запустить проверку настройки, которая диагностирует проблемы и может их исправить. Проверяет здоровье установки, включая дублирующиеся или оставшиеся установки, проблемы с `PATH` и непарсируемые файлы параметров. Находит неиспользуемые skills, MCP серверы и plugins в сравнении с их стоимостью контекста, дедублирует локальные файлы `CLAUDE.md` в сравнении с зафиксированными, переносит всегда загруженное руководство в [skills](/ru/skills) и вложенные файлы `CLAUDE.md`, которые загружаются по требованию, отмечает медленные [hooks](/ru/hooks) и проверяет наличие более новой версии. Также предлагает сделать [автоматический режим](/ru/permissions#permission-modes) вашим значением по умолчанию и [предварительно одобрить](/ru/permissions) часто отклоняемые команды только для чтения. Сообщает результаты в первую очередь и запрашивает подтверждение перед изменением чего-либо. Из терминала `claude doctor` выводит диагностику установки только для чтения без запуска сеанса. Псевдоним: `/checkup`. {/* min-version: 2.1.205 */}До v2.1.205, `/doctor` открывал экран диагностики только для чтения и нажатие `f` отправляло отчет Claude |

79| `/effort [level\|auto]` | Установить [уровень усилий](/ru/model-config#adjust-effort-level) модели. Принимает `low`, `medium`, `high`, `xhigh`, `max` или `ultracode`; доступные уровни зависят от модели, и `max` и `ultracode` применяются только к сеансу. `ultracode` — это параметр Claude Code, который объединяет `xhigh` reasoning с автоматической [workflow](/ru/workflows#let-claude-decide-with-ultracode) оркестрацией. `auto` сбрасывает значение по умолчанию модели. Без аргумента открывает интерактивный ползунок; используйте стрелки влево и вправо для выбора уровня и `Enter` для применения. Вступает в силу немедленно без ожидания завершения текущего ответа |79| `/effort [level\|auto]` | Установить [уровень усилий](/ru/model-config#adjust-effort-level) модели. Принимает `low`, `medium`, `high`, `xhigh`, `max` или `ultracode`; доступные уровни зависят от модели, и `max` и `ultracode` применяются только к сеансу. `ultracode` — это параметр Claude Code, который объединяет `xhigh` reasoning с автоматической [workflow](/ru/workflows#let-claude-decide-with-ultracode) оркестрацией. `auto` сбрасывает значение по умолчанию модели. Без аргумента открывает интерактивный ползунок; используйте стрелки влево и вправо для выбора уровня и `Enter` для применения. Вступает в силу немедленно без ожидания завершения текущего ответа. {/* min-version: 2.1.205 */}Также доступно в неинтерактивном режиме (`-p`) с аргументом уровня, где оно применяется только к текущему сеансу и не сохраняется как ваше значение по умолчанию; требует Claude Code v2.1.205 или позже. На Fable 5, Opus 4.8 и Opus 4.7, неинтерактивный `/effort` сообщает `Not applied`, пока действует [удержание усилий по умолчанию модели](/ru/model-config#adjust-effort-level), поэтому вместо этого передайте `--effort` при запуске |

80| `/exit` | Выход из CLI. В подключенном [фоновом сеансе](/ru/agent-view#attach-to-a-session) это отсоединяет и сеанс продолжает работать. Псевдоним: `/quit` |80| `/exit` | Выход из CLI. В подключенном [фоновом сеансе](/ru/agent-view#attach-to-a-session) это отсоединяет и сеанс продолжает работать. Псевдоним: `/quit` |

81| `/export [filename]` | Экспортировать текущую беседу как простой текст. С именем файла записывает непосредственно в этот файл. Без имени открывает диалог для копирования в буфер обмена или сохранения в файл |81| `/export [filename]` | Экспортировать текущую беседу как простой текст. С именем файла записывает непосредственно в этот файл. Без имени открывает диалог для копирования в буфер обмена или сохранения в файл |

82| `/fast [on\|off]` | Переключить [быстрый режим](/ru/fast-mode) включен или выключен |82| `/fast [on\|off]` | Переключить [быстрый режим](/ru/fast-mode) включен или выключен. {/* min-version: 2.1.205 */}В неинтерактивном режиме (`-p`), `/fast` работает только в сеансе, запущенном с быстрым режимом в его значении [`--settings`](/ru/cli-reference#cli-flags), например `claude -p --settings '{"fastMode": true}'`; переключение затем применяется только к текущему сеансу и не сохраняется как ваше значение по умолчанию, и в любом другом неинтерактивном сеансе команда сообщает, что быстрый режим недоступен. Требует Claude Code v2.1.205 или позже |

83| `/feedback [report]` | Отправить отзыв, сообщить об ошибке или поделиться вашей беседой. Псевдонимы: `/bug`, `/share` |83| `/feedback [report]` | Отправить отзыв, сообщить об ошибке или поделиться вашей беседой. Псевдонимы: `/bug`, `/share` |

84| `/fewer-permission-prompts` | **[Skill](/ru/skills#bundled-skills).** Сканировать ваши стенограммы на предмет распространенных вызовов инструментов Bash и MCP только для чтения, затем добавить приоритизированный список разрешений в проект `.claude/settings.json` для уменьшения запросов разрешений |84| `/fewer-permission-prompts` | **[Skill](/ru/skills#bundled-skills).** Сканировать ваши стенограммы на предмет распространенных вызовов инструментов Bash и MCP только для чтения, затем добавить приоритизированный список разрешений в проект `.claude/settings.json` для уменьшения запросов разрешений |

85| `/focus` | Переключить представление фокуса, которое показывает только ваше последнее приглашение, однострочную сводку вызова инструмента с редактированием diffstats и финальный ответ. {/* min-version: 2.1.198 */}Начиная с v2.1.198, сводка вызова инструмента также подсчитывает запущенные в ходе подагенты и сворачивает завершенные уведомления фоновых задач в один счет. Выбор сохраняется между сеансами; установите [`viewMode`](/ru/settings#available-settings) в параметрах для переопределения. Доступно только в [полноэкранном рендеринге](/ru/fullscreen) |85| `/focus` | Переключить представление фокуса, которое показывает только ваше последнее приглашение, однострочную сводку вызова инструмента с редактированием diffstats и финальный ответ. {/* min-version: 2.1.198 */}Начиная с v2.1.198, сводка вызова инструмента также подсчитывает запущенные в ходе подагенты и сворачивает завершенные уведомления фоновых задач в один счет. Выбор сохраняется между сеансами; установите [`viewMode`](/ru/settings#available-settings) в параметрах для переопределения. Доступно только в [полноэкранном рендеринге](/ru/fullscreen) |


97| `/login` | Войти в вашу учетную запись Anthropic |97| `/login` | Войти в вашу учетную запись Anthropic |

98| `/logout` | Выйти из вашей учетной записи Anthropic |98| `/logout` | Выйти из вашей учетной записи Anthropic |

99| `/loop [interval] [prompt]` | **[Skill](/ru/skills#bundled-skills).** Запустить подсказку повторно, пока сеанс остается открытым. Опустите интервал, и Claude будет самостоятельно устанавливать темп между итерациями. Опустите подсказку, и [где доступно](/ru/scheduled-tasks#run-the-built-in-maintenance-prompt), Claude запустит автономную проверку обслуживания или подсказку в `.claude/loop.md`. Пример: `/loop 5m check if the deploy finished`. См. [Запуск подсказок по расписанию](/ru/scheduled-tasks). Псевдоним: `/proactive` |99| `/loop [interval] [prompt]` | **[Skill](/ru/skills#bundled-skills).** Запустить подсказку повторно, пока сеанс остается открытым. Опустите интервал, и Claude будет самостоятельно устанавливать темп между итерациями. Опустите подсказку, и [где доступно](/ru/scheduled-tasks#run-the-built-in-maintenance-prompt), Claude запустит автономную проверку обслуживания или подсказку в `.claude/loop.md`. Пример: `/loop 5m check if the deploy finished`. См. [Запуск подсказок по расписанию](/ru/scheduled-tasks). Псевдоним: `/proactive` |

100| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Управлять подключениями MCP server и аутентификацией OAuth. Запустите без аргумента для открытия интерактивного списка, передайте `reconnect <server>` для переподключения одного отключенного сервера, или передайте `enable`/`disable` с именем сервера или `all` для изменения состояния подключения без открытия диалога |100| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Управлять подключениями MCP server и аутентификацией OAuth. Запустите без аргумента для открытия интерактивного списка, передайте `reconnect <server>` для переподключения одного отключенного сервера, или передайте `enable`/`disable` с именем сервера или `all` для изменения состояния подключения без открытия диалога. {/* min-version: 2.1.205 */}Также доступно в неинтерактивном режиме (`-p`), где запуск его без аргумента выводит текстовую сводку статуса сервера вместо открытия списка; требует Claude Code v2.1.205 или позже |

101| `/memory` | Редактировать файлы памяти `CLAUDE.md`, включать или отключать [auto-memory](/ru/memory#auto-memory) и просматривать записи auto-memory |101| `/memory` | Редактировать файлы памяти `CLAUDE.md`, включать или отключать [auto-memory](/ru/memory#auto-memory) и просматривать записи auto-memory |

102| `/mobile` | Показать QR-код для загрузки мобильного приложения Claude. Псевдонимы: `/ios`, `/android` |102| `/mobile` | Показать QR-код для загрузки мобильного приложения Claude. Псевдонимы: `/ios`, `/android` |

103| `/model [model]` | Переключить модель AI и сохранить ее как значение по умолчанию для новых сеансов. Для моделей, которые это поддерживают, используйте стрелки влево/вправо для [регулировки уровня усилий](/ru/model-config#adjust-effort-level). Без аргумента открывает выбор; нажмите `s` на строке для переключения только для текущего сеанса. Выбор запрашивает подтверждение, когда беседа имеет предыдущий вывод, так как следующий ответ перечитывает полную историю без кэшированного контекста. После подтверждения изменение вступает в силу без ожидания завершения текущего ответа |103| `/model [model]` | Переключить модель AI и сохранить ее как значение по умолчанию для новых сеансов. Для моделей, которые это поддерживают, используйте стрелки влево/вправо для [регулировки уровня усилий](/ru/model-config#adjust-effort-level). Без аргумента открывает выбор; нажмите `s` на строке для переключения только для текущего сеанса. Выбор запрашивает подтверждение, когда беседа имеет предыдущий вывод, так как следующий ответ перечитывает полную историю без кэшированного контекста. После подтверждения изменение вступает в силу без ожидания завершения текущего ответа. {/* min-version: 2.1.205 */}Также доступно в неинтерактивном режиме (`-p`) с аргументом модели вместо выбора, где оно применяется только к текущему сеансу и не сохраняется как ваше значение по умолчанию; требует Claude Code v2.1.205 или позже |

104| `/passes` | Поделиться бесплатной неделей Claude Code с друзьями. Видна только если ваша учетная запись имеет право на это |104| `/passes` | Поделиться бесплатной неделей Claude Code с друзьями. Видна только если ваша учетная запись имеет право на это |

105| `/permissions` | Управлять правилами разрешения, запроса и отказа для разрешений инструментов. Открывает интерактивный диалог, где вы можете просматривать правила по области, добавлять или удалять правила, управлять рабочими каталогами и просматривать [недавние отказы в автоматическом режиме](/ru/auto-mode-config#review-denials). Псевдоним: `/allowed-tools` |105| `/permissions` | Управлять правилами разрешения, запроса и отказа для разрешений инструментов. Открывает интерактивный диалог, где вы можете просматривать правила по области, добавлять или удалять правила, управлять рабочими каталогами и просматривать [недавние отказы в автоматическом режиме](/ru/auto-mode-config#review-denials). Псевдоним: `/allowed-tools` |

106| `/plan [description]` | Войти в Plan Mode непосредственно из приглашения. Передайте необязательное описание для входа в Plan Mode и немедленного начала с этой задачей, например `/plan fix the auth bug` |106| `/plan [description]` | Войти в Plan Mode непосредственно из приглашения. Передайте необязательное описание для входа в Plan Mode и немедленного начала с этой задачей, например `/plan fix the auth bug` |


108| `/powerup` | Открыть для себя функции Claude Code через быстрые интерактивные уроки с анимированными демонстрациями |108| `/powerup` | Открыть для себя функции Claude Code через быстрые интерактивные уроки с анимированными демонстрациями |

109| `/pr-comments [PR]` | {/* max-version: 2.1.90 */}Удалено в v2.1.91. Попросите Claude напрямую просмотреть комментарии pull request. В более ранних версиях получает и отображает комментарии из запроса на слияние GitHub; автоматически обнаруживает PR для текущей ветви или передайте URL или номер PR. Требует CLI `gh` |109| `/pr-comments [PR]` | {/* max-version: 2.1.90 */}Удалено в v2.1.91. Попросите Claude напрямую просмотреть комментарии pull request. В более ранних версиях получает и отображает комментарии из запроса на слияние GitHub; автоматически обнаруживает PR для текущей ветви или передайте URL или номер PR. Требует CLI `gh` |

110| `/privacy-settings` | Просмотреть и обновить параметры конфиденциальности. Доступно только для подписчиков планов Pro и Max |110| `/privacy-settings` | Просмотреть и обновить параметры конфиденциальности. Доступно только для подписчиков планов Pro и Max |

111| `/radio` | Открыть Claude FM lo-fi радио в вашем браузере. Выводит URL потока, когда браузер недоступен. Недоступно на Bedrock, Vertex или Foundry |111| `/radio` | Открыть Claude FM lo-fi радио в вашем браузере. Выводит URL потока, когда браузер недоступен. Недоступно на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry |

112| `/recap` | Создать однострочную сводку текущего сеанса по требованию. См. [Сводка сеанса](/ru/interactive-mode#session-recap) для автоматической сводки, которая появляется после вашего отсутствия |112| `/recap` | Создать однострочную сводку текущего сеанса по требованию. См. [Сводка сеанса](/ru/interactive-mode#session-recap) для автоматической сводки, которая появляется после вашего отсутствия |

113| `/release-notes` | Просмотреть журнал изменений в интерактивном выборщике версий. Выберите конкретную версию для просмотра ее примечаний к выпуску или выберите отображение всех версий |113| `/release-notes` | Просмотреть журнал изменений в интерактивном выборщике версий. Выберите конкретную версию для просмотра ее примечаний к выпуску или выберите отображение всех версий |

114| `/reload-plugins [--force]` | Перезагрузить все активные [plugins](/ru/plugins) для применения ожидающих изменений без перезагрузки. Сообщает количество для каждого перезагруженного компонента и отмечает любые ошибки загрузки. Когда перезагрузка изменит, какие MCP инструменты загружены и аннулирует кэш подсказок, команда предупреждает и пропускает, если вы не передадите `--force` |114| `/reload-plugins [--force]` | Перезагрузить все активные [plugins](/ru/plugins) для применения ожидающих изменений без перезагрузки. Сообщает количество для каждого перезагруженного компонента и отмечает любые ошибки загрузки. Когда перезагрузка изменит, какие MCP инструменты загружены и аннулирует кэш подсказок, команда предупреждает и пропускает, если вы не передадите `--force` |

115| `/reload-skills` | {/* min-version: 2.1.152 */}Повторно сканировать каталоги [skill](/ru/skills) и команд, чтобы skills, добавленные или измененные на диске во время сеанса, стали доступны без перезагрузки. Сообщает, сколько skills доступно и сколько было добавлено или удалено. Добавлено в v2.1.152 |115| `/reload-skills` | {/* min-version: 2.1.152 */}Повторно сканировать каталоги [skill](/ru/skills) и команд, чтобы skills, добавленные или измененные на диске во время сеанса, стали доступны без перезагрузки. Сообщает, сколько skills доступно и сколько было добавлено или удалено. Добавлено в v2.1.152 |

116| `/remote-control` | Сделать этот сеанс доступным для [удаленного управления](/ru/remote-control) с claude.ai. Псевдоним: `/rc` |116| `/remote-control` | Сделать этот сеанс доступным для [удаленного управления](/ru/remote-control) с claude.ai. Псевдоним: `/rc` |

117| `/remote-env` | Выбрать окружение по умолчанию для [облачных агентов](/ru/claude-code-on-the-web#configure-your-environment) |117| `/remote-env` | Выбрать окружение по умолчанию для [облачных агентов](/ru/claude-code-on-the-web#configure-your-environment) |

118| `/rename [name]` | Переименовать текущий сеанс и показать имя на строке приглашения. Без имени автоматически генерирует одно из истории беседы |118| `/rename [name]` | Переименовать текущий сеанс и показать имя на строке приглашения. Без имени автоматически генерирует одно из истории беседы. {/* min-version: 2.1.205 */}Также доступно в неинтерактивном режиме (`-p`); требует Claude Code v2.1.205 или позже |

119| `/resume [session]` | Возобновить беседу по ID или имени, или открыть выбор сеанса. Начиная с v2.1.144, [фоновые сеансы](/ru/agent-view) отображаются в выборщике, отмеченные как `bg`. Псевдоним: `/continue` |119| `/resume [session]` | Возобновить беседу по ID или имени, или открыть выбор сеанса. Начиная с v2.1.144, [фоновые сеансы](/ru/agent-view) отображаются в выборщике, отмеченные как `bg`. Псевдоним: `/continue` |

120| `/review [PR]` | Просмотреть pull request GitHub по номеру, используя тот же механизм просмотра, что и `/code-review`. Без аргументов выводит список открытых PR для выбора. Для облачного просмотра см. [`/code-review ultra`](/ru/ultrareview) |120| `/review [PR]` | {/* min-version: 2.1.202 */}Запустить быстрый однопроходный просмотр только для чтения запроса на слияние GitHub по номеру. Без аргумента выводит список открытых PR для выбора; текст после номера PR становится дополнительными инструкциями просмотра. Начиная с v2.1.186 по v2.1.201, `/review` вместо этого запускал тот же многоагентный механизм, что и `/code-review medium`. Для многоагентного просмотра на выбранном уровне усилий используйте [`/code-review <level> <pr#>`](/ru/code-review#review-a-diff-locally); для облачного просмотра см. [`/code-review ultra`](/ru/ultrareview) |

121| `/rewind` | Перемотать беседу и/или код к предыдущей точке или суммировать с выбранного сообщения. См. [checkpointing](/ru/checkpointing). Псевдонимы: `/checkpoint`, `/undo` |121| `/rewind` | Перемотать беседу и/или код к предыдущей точке или суммировать с выбранного сообщения. См. [checkpointing](/ru/checkpointing). Псевдонимы: `/checkpoint`, `/undo` |

122| `/run` | **[Skill](/ru/skills#bundled-skills).** Запустить и управлять приложением вашего проекта, чтобы увидеть работающее изменение в запущенном приложении, а не только в тестах. См. [Запуск и проверка вашего приложения](/ru/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Требует Claude Code v2.1.145 или позже |122| `/run` | **[Skill](/ru/skills#bundled-skills).** Запустить и управлять приложением вашего проекта, чтобы увидеть работающее изменение в запущенном приложении, а не только в тестах. См. [Запуск и проверка вашего приложения](/ru/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Требует Claude Code v2.1.145 или позже |

123| `/run-skill-generator` | **[Skill](/ru/skills#bundled-skills).** Научить `/run` и `/verify` как собирать, запускать и управлять приложением вашего проекта из чистого окружения путем написания [skill](/ru/skills#run-and-verify-your-app) для каждого проекта. {/* min-version: 2.1.145 */}Требует Claude Code v2.1.145 или позже |123| `/run-skill-generator` | **[Skill](/ru/skills#bundled-skills).** Научить `/run` и `/verify` как собирать, запускать и управлять приложением вашего проекта из чистого окружения путем написания [skill](/ru/skills#run-and-verify-your-app) для каждого проекта. {/* min-version: 2.1.145 */}Требует Claude Code v2.1.145 или позже |


126| `/scroll-speed` | Отрегулировать [скорость прокрутки](/ru/fullscreen#mouse-wheel-scrolling) колеса мыши интерактивно, с линейкой, которую вы можете прокручивать, пока диалог открыт, чтобы предварительно просмотреть изменение. Доступно только в [полноэкранном рендеринге](/ru/fullscreen) и не в терминале JetBrains IDE |126| `/scroll-speed` | Отрегулировать [скорость прокрутки](/ru/fullscreen#mouse-wheel-scrolling) колеса мыши интерактивно, с линейкой, которую вы можете прокручивать, пока диалог открыт, чтобы предварительно просмотреть изменение. Доступно только в [полноэкранном рендеринге](/ru/fullscreen) и не в терминале JetBrains IDE |

127| `/security-review` | Анализировать ожидающие изменения на текущей ветви на предмет уязвимостей безопасности. Проверяет git diff и определяет риски, такие как инъекции, проблемы с аутентификацией и утечка данных |127| `/security-review` | Анализировать ожидающие изменения на текущей ветви на предмет уязвимостей безопасности. Проверяет git diff и определяет риски, такие как инъекции, проблемы с аутентификацией и утечка данных |

128| `/setup-bedrock` | Настроить аутентификацию [Amazon Bedrock](/ru/amazon-bedrock), регион и привязки моделей через интерактивный мастер. Видна только когда установлено `CLAUDE_CODE_USE_BEDROCK=1`. Пользователи Bedrock в первый раз также могут получить доступ к этому мастеру с экрана входа |128| `/setup-bedrock` | Настроить аутентификацию [Amazon Bedrock](/ru/amazon-bedrock), регион и привязки моделей через интерактивный мастер. Видна только когда установлено `CLAUDE_CODE_USE_BEDROCK=1`. Пользователи Bedrock в первый раз также могут получить доступ к этому мастеру с экрана входа |

129| `/setup-vertex` | Настроить аутентификацию [Google Vertex AI](/ru/google-vertex-ai), проект, регион и привязки моделей через интерактивный мастер. Видна только когда установлено `CLAUDE_CODE_USE_VERTEX=1`. Пользователи Vertex AI в первый раз также могут получить доступ к этому мастеру с экрана входа |129| `/setup-vertex` | Настроить аутентификацию [Google Cloud's Agent Platform](/ru/google-vertex-ai), проект, регион и привязки моделей через интерактивный мастер. Видна только когда установлено `CLAUDE_CODE_USE_VERTEX=1`. Пользователи Google Cloud's Agent Platform в первый раз также могут получить доступ к этому мастеру с экрана входа |

130| `/simplify [target]` | {/* min-version: 2.1.154 */}**[Skill](/ru/skills#bundled-skills).** Просмотреть измененный код на предмет возможностей очистки и применить исправления. Четыре агента просмотра [agents](/ru/sub-agents) работают параллельно, охватывая переиспользование существующих помощников, упрощение, эффективность и находится ли изменение на правильном уровне абстракции. Начиная с v2.1.154, просмотр не ищет ошибки корректности. Используйте `/code-review` для поиска ошибок. В более ранних версиях `/simplify` эквивалентен `/code-review --fix`. Передайте путь или ссылку PR для просмотра конкретной цели |130| `/simplify [target]` | {/* min-version: 2.1.154 */}**[Skill](/ru/skills#bundled-skills).** Просмотреть измененный код на предмет возможностей очистки и применить исправления. Четыре агента просмотра [agents](/ru/sub-agents) работают параллельно, охватывая переиспользование существующих помощников, упрощение, эффективность и находится ли изменение на правильном уровне абстракции. Начиная с v2.1.154, просмотр не ищет ошибки корректности. Используйте `/code-review` для поиска ошибок. В более ранних версиях `/simplify` эквивалентен `/code-review --fix`. Передайте путь или ссылку PR для просмотра конкретной цели |

131| `/skills` | Список доступных [skills](/ru/skills). {/* min-version: 2.1.121 */}Начиная с v2.1.121, введите для фильтрации списка по имени. Нажмите `t` для сортировки по количеству токенов. Нажмите `Space` для [скрытия skill от Claude или меню `/`](/ru/skills#override-skill-visibility-from-settings), затем `Enter` для сохранения |131| `/skills` | Список доступных [skills](/ru/skills). {/* min-version: 2.1.121 */}Начиная с v2.1.121, введите для фильтрации списка по имени. Нажмите `t` для сортировки по количеству токенов. Нажмите `Space` для [скрытия skill от Claude или меню `/`](/ru/skills#override-skill-visibility-from-settings), затем `Enter` для сохранения |

132| `/stats` | Псевдоним для `/usage`. Открывается на вкладке Stats |132| `/stats` | Псевдоним для `/usage`. Открывается на вкладке Stats |


144| `/ultrareview [PR]` | Запустить глубокий многоагентный просмотр кода в облачной песочнице с [ultrareview](/ru/ultrareview). Предпочтительный вызов теперь `/code-review ultra`, и `/ultrareview` остается как псевдоним. Включает 3 бесплатных запуска на Pro и Max, затем требует [дополнительное использование](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |144| `/ultrareview [PR]` | Запустить глубокий многоагентный просмотр кода в облачной песочнице с [ultrareview](/ru/ultrareview). Предпочтительный вызов теперь `/code-review ultra`, и `/ultrareview` остается как псевдоним. Включает 3 бесплатных запуска на Pro и Max, затем требует [дополнительное использование](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

145| `/upgrade` | Открыть страницу обновления для переключения на более высокий уровень плана |145| `/upgrade` | Открыть страницу обновления для переключения на более высокий уровень плана |

146| `/usage` | Показать стоимость сеанса, ограничения использования плана и статистику активности. На планах Pro, Max, Team и Enterprise включает разбивку использования по skills, subagent, plugins и MCP server. См. [руководство по отслеживанию затрат](/ru/costs#using-the-%2Fusage-command) для деталей. `/cost` и `/stats` являются псевдонимами |146| `/usage` | Показать стоимость сеанса, ограничения использования плана и статистику активности. На планах Pro, Max, Team и Enterprise включает разбивку использования по skills, subagent, plugins и MCP server. См. [руководство по отслеживанию затрат](/ru/costs#using-the-%2Fusage-command) для деталей. `/cost` и `/stats` являются псевдонимами |

147| `/usage-credits` | Настроить дополнительное использование для продолжения работы при достижении ограничений. Ранее `/extra-usage` |147| `/usage-credits` | Настроить дополнительное использование для продолжения работы при достижении ограничений. Открывает страницу выставления счетов за дополнительное использование в вашем браузере. {/* min-version: 2.1.205 */}Когда браузер не может открыться, например при работе через SSH, команда выводит URL для посещения вместо этого; это требует Claude Code v2.1.205 или позже, и более ранние версии ничего не показывали в этом случае. Ранее `/extra-usage` |

148| `/verify` | **[Skill](/ru/skills#bundled-skills).** Подтвердить, что изменение кода делает то, что оно должно делать, путем сборки приложения вашего проекта, его запуска и наблюдения результата, а не полагаясь на тесты или проверки типов. См. [Запуск и проверка вашего приложения](/ru/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Требует Claude Code v2.1.145 или позже |148| `/verify` | **[Skill](/ru/skills#bundled-skills).** Подтвердить, что изменение кода делает то, что оно должно делать, путем сборки приложения вашего проекта, его запуска и наблюдения результата, а не полагаясь на тесты или проверки типов. См. [Запуск и проверка вашего приложения](/ru/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Требует Claude Code v2.1.145 или позже |

149| `/vim` | {/* max-version: 2.1.91 */}Удалено в v2.1.92. Для переключения между режимами редактирования Vim и Normal используйте `/config` → Editor mode |149| `/vim` | {/* max-version: 2.1.91 */}Удалено в v2.1.92. Для переключения между режимами редактирования Vim и Normal используйте `/config` → Editor mode |

150| `/voice [hold\|tap\|off]` | Переключить [диктовку голосом](/ru/voice-dictation) или включить ее в определенном режиме. Требует учетную запись Claude.ai |150| `/voice [hold\|tap\|off]` | Переключить [диктовку голосом](/ru/voice-dictation) или включить ее в определенном режиме. Требует учетную запись Claude.ai |

Details

255 </Step>255 </Step>

256</Steps>256</Steps>

257 257 

258Когда вы создаёте PR с помощью `gh pr create`, сеанс автоматически связывается с этим PR. Чтобы вернуться к нему позже, запустите `claude --from-pr <number>` или вставьте URL PR в средство выбора [`/resume`](/ru/sessions#use-the-session-picker).258Когда вы создаёте PR с помощью `gh pr create`, сеанс автоматически связывается с этим PR. Чтобы вернуться к нему позже, запустите `claude --from-pr 123`, заменив 123 номером PR, или вставьте URL PR в средство выбора [`/resume`](/ru/sessions#use-the-session-picker).

259 259 

260<Tip>260<Tip>

261 Просмотрите PR, созданный Claude, перед отправкой и попросите Claude выделить потенциальные риски или соображения.261 Просмотрите PR, созданный Claude, перед отправкой и попросите Claude выделить потенциальные риски или соображения.

Details

318Иногда вы хотите, чтобы Claude просил перед каждым редактированием. Иногда вы просто хотите318Иногда вы хотите, чтобы Claude просил перед каждым редактированием. Иногда вы просто хотите

319чтобы он отправил. Вы не должны выбирать один навсегда.319чтобы он отправил. Вы не должны выбирать один навсегда.

320 320 

321*Shift+Tab* циклирует, сколько свободы получает Claude: *default* просит перед321*Shift+Tab* циклирует, сколько Claude может делать без запроса: *Manual* (значение

322рискованным материалом, *acceptEdits* позволяет редактированиям файлов и общим командам файловой системы322`default`) просит перед каждым действием, *acceptEdits* позволяет редактированиям файлов и общим командам файловой системы

323проходить, пока все еще проверяя перед другими командами оболочки, и *plan*323проходить, пока все еще проверяя перед другими командами оболочки, и *plan*

324предлагает изменения для вашего одобрения перед тем, как что-либо будет тронуто. Plan mode — это324предлагает изменения для вашего одобрения перед тем, как что-либо будет тронуто. Plan mode — это

325строитель доверия, поэтому начните с него для чего-либо, касающегося нескольких файлов.325строитель доверия, поэтому начните с него для чего-либо, касающегося нескольких файлов.

computer-use.md +1 −1

Details

240* Вы на macOS. Computer use в CLI недоступен на Linux или Windows. На Windows используйте [computer use в Desktop](/ru/desktop#let-claude-use-your-computer) вместо этого.240* Вы на macOS. Computer use в CLI недоступен на Linux или Windows. На Windows используйте [computer use в Desktop](/ru/desktop#let-claude-use-your-computer) вместо этого.

241* Вы запускаете Claude Code v2.1.85 или позже. Запустите `claude --version` для проверки.241* Вы запускаете Claude Code v2.1.85 или позже. Запустите `claude --version` для проверки.

242* Вы на плане Pro или Max. Запустите `/status` для подтверждения вашей подписки.242* Вы на плане Pro или Max. Запустите `/status` для подтверждения вашей подписки.

243* Вы аутентифицированы через claude.ai. Computer use недоступен с поставщиками третьих сторон, такими как Amazon Bedrock, Google Cloud Vertex AI или Microsoft Foundry. Если вы получаете доступ к Claude исключительно через поставщика третьей стороны, вам нужна отдельная учётная запись claude.ai для использования этой функции.243* Вы аутентифицированы через claude.ai. Computer use недоступен с поставщиками третьих сторон, такими как Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Если вы получаете доступ к Claude исключительно через поставщика третьей стороны, вам нужна отдельная учётная запись claude.ai для использования этой функции.

244* Вы в интерактивном сеансе. Computer use недоступен в неинтерактивном режиме с флагом `-p`.244* Вы в интерактивном сеансе. Computer use недоступен в неинтерактивном режиме с флагом `-p`.

245 245 

246<h2 id="see-also">246<h2 id="see-also">

costs.md +1 −1

Details

51 Для организаций с пользовательскими ограничениями скорости трафик Claude Code в этом рабочем пространстве учитывается в общих ограничениях скорости API вашей организации. Вы можете установить [ограничение скорости рабочего пространства](https://platform.claude.com/docs/ru/api/rate-limits#setting-lower-limits-for-workspaces) на странице Limits этого рабочего пространства в Claude Console, чтобы ограничить долю Claude Code и защитить другие производственные рабочие нагрузки.51 Для организаций с пользовательскими ограничениями скорости трафик Claude Code в этом рабочем пространстве учитывается в общих ограничениях скорости API вашей организации. Вы можете установить [ограничение скорости рабочего пространства](https://platform.claude.com/docs/ru/api/rate-limits#setting-lower-limits-for-workspaces) на странице Limits этого рабочего пространства в Claude Console, чтобы ограничить долю Claude Code и защитить другие производственные рабочие нагрузки.

52</Note>52</Note>

53 53 

54На Bedrock, Vertex и Foundry Claude Code не отправляет метрики из вашего облака. Самостоятельно размещённый [Claude apps gateway](/ru/claude-apps-gateway) обеспечивает атрибуцию использования для каждого пользователя, метрики OTLP с подсчётом токенов и [лимиты расходов для каждого пользователя](/ru/claude-apps-gateway-spend-limits) на этих поставщиках. Организации, которые маршрутизируют Claude Code через другой [LLM gateway](/ru/llm-gateway), могут отслеживать расходы на шлюзе вместо этого, поскольку он видит каждый запрос.54На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code не отправляет метрики из вашего облака. Самостоятельно размещённый [Claude apps gateway](/ru/claude-apps-gateway) обеспечивает атрибуцию использования для каждого пользователя, метрики OTLP с подсчётом токенов и [лимиты расходов для каждого пользователя](/ru/claude-apps-gateway-spend-limits) на этих поставщиках. Организации, которые маршрутизируют Claude Code через другой [LLM gateway](/ru/llm-gateway), могут отслеживать расходы на шлюзе вместо этого, поскольку он видит каждый запрос.

55 55 

56<h3 id="rate-limit-recommendations">56<h3 id="rate-limit-recommendations">

57 Рекомендации по ограничению скорости57 Рекомендации по ограничению скорости

data-usage.md +8 −8

Details

23 Development Partner Program23 Development Partner Program

24</h3>24</h3>

25 25 

26Если вы явно согласитесь предоставить нам материалы для обучения, например через [Development Partner Program](https://support.claude.com/ru/articles/11174108-about-the-development-partner-program), мы можем использовать эти материалы для обучения наших моделей. Администратор организации может явно согласиться на участие в Development Partner Program для своей организации. Обратите внимание, что эта программа доступна только для API Anthropic первой стороны и недоступна для пользователей Bedrock или Vertex.26Если вы явно согласитесь предоставить нам материалы для обучения, например через [Development Partner Program](https://support.claude.com/ru/articles/11174108-about-the-development-partner-program), мы можем использовать эти материалы для обучения наших моделей. Администратор организации может явно согласиться на участие в Development Partner Program для своей организации. Обратите внимание, что эта программа доступна только для API Anthropic первой стороны и недоступна для пользователей Amazon Bedrock или Google Cloud's Agent Platform.

27 27 

28<h3 id="feedback-using-the-/feedback-command">28<h3 id="feedback-using-the-/feedback-command">

29 Обратная связь с помощью команды `/feedback`29 Обратная связь с помощью команды `/feedback`


39 39 

40После подсказки оценки вы можете увидеть отдельный дополнительный вопрос "Can Anthropic look at your session transcript to help us improve Claude Code?". Это необязательный второй шаг, отличный от оценки:40После подсказки оценки вы можете увидеть отдельный дополнительный вопрос "Can Anthropic look at your session transcript to help us improve Claude Code?". Это необязательный второй шаг, отличный от оценки:

41 41 

42* **Yes**: загружает стенограмму вашего разговора, любые стенограммы подагентов и файл необработанного журнала сеанса с диска в Anthropic. Известные шаблоны ключей API и токенов удаляются перед загрузкой. Исходный код, содержимое файлов и другое содержимое разговора загружаются как есть. Общие стенограммы сохраняются до 6 месяцев. На Bedrock, Vertex AI, Foundry и сеансах [Claude apps gateway](/ru/claude-apps-gateway) с входом в систему, Yes записывает тот же полезный груз в локальный архив под `~/.claude/feedback-bundles/` вместо загрузки; ничего не покидает вашу машину, пока вы не переправите этот файл.42* **Yes**: загружает стенограмму вашего разговора, любые стенограммы подагентов и файл необработанного журнала сеанса с диска в Anthropic. Известные шаблоны ключей API и токенов удаляются перед загрузкой. Исходный код, содержимое файлов и другое содержимое разговора загружаются как есть. Общие стенограммы сохраняются до 6 месяцев. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансах [Claude apps gateway](/ru/claude-apps-gateway) с входом в систему, Yes записывает тот же полезный груз в локальный архив под `~/.claude/feedback-bundles/` вместо загрузки; ничего не покидает вашу машину, пока вы не переправите этот файл.

43* **No**: отклоняет без отправки чего-либо43* **No**: отклоняет без отправки чего-либо

44* **Don't ask again**: отклоняет и останавливает появление этого дополнительного вопроса в будущих сеансах44* **Don't ask again**: отклоняет и останавливает появление этого дополнительного вопроса в будущих сеансах

45 45 


90Шифрование в покое зависит от вашего поставщика модели:90Шифрование в покое зависит от вашего поставщика модели:

91 91 

92| Поставщик | Шифрование в покое |92| Поставщик | Шифрование в покое |

93| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |93| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |

94| Anthropic API | Шифрование диска на уровне инфраструктуры (AES-256). Включите [Zero Data Retention](/ru/zero-data-retention) для отсутствия сохранения на стороне сервера. |94| Anthropic API | Шифрование диска на уровне инфраструктуры (AES-256). Включите [Zero Data Retention](/ru/zero-data-retention) для отсутствия сохранения на стороне сервера. |

95| Amazon Bedrock | AES-256 с управляемыми AWS ключами. Ключи, управляемые клиентом, доступны через AWS KMS. |95| Amazon Bedrock | AES-256 с управляемыми AWS ключами. Ключи, управляемые клиентом, доступны через AWS KMS. |

96| Google Cloud Vertex AI | Ключи шифрования, управляемые Google. CMEK доступен. |96| Google Cloud's Agent Platform | Ключи шифрования, управляемые Google. CMEK доступен. |

97| Microsoft Foundry | Запросы маршрутизируются в инфраструктуру Anthropic с шифрованием диска AES-256. |97| Microsoft Foundry | Запросы маршрутизируются в инфраструктуру Anthropic с шифрованием диска AES-256. |

98 98 

99Claude Code построен на API Anthropic. Для получения подробной информации о средствах контроля безопасности API, включая процедуры логирования API, см. артефакты соответствия в [Anthropic Trust Center](https://trust.anthropic.com).99Claude Code построен на API Anthropic. Для получения подробной информации о средствах контроля безопасности API, включая процедуры логирования API, см. артефакты соответствия в [Anthropic Trust Center](https://trust.anthropic.com).


121 121 

122Когда вы выполняете команду `/feedback`, копия вашей истории разговора, включая код, отправляется в Anthropic. Перед отправкой вы выбираете, сколько истории включить: только текущую сессию, что является значением по умолчанию, или также другие сессии из того же проекта за последние 24 часа или 7 дней. Данные зашифрованы при передаче через TLS и хранятся в Google Cloud Storage, которая по умолчанию шифрует хранящиеся данные в покое. Опционально создаётся проблема GitHub в публичном репозитории. Чтобы отказаться, установите переменную окружения `DISABLE_FEEDBACK_COMMAND` на `1`.122Когда вы выполняете команду `/feedback`, копия вашей истории разговора, включая код, отправляется в Anthropic. Перед отправкой вы выбираете, сколько истории включить: только текущую сессию, что является значением по умолчанию, или также другие сессии из того же проекта за последние 24 часа или 7 дней. Данные зашифрованы при передаче через TLS и хранятся в Google Cloud Storage, которая по умолчанию шифрует хранящиеся данные в покое. Опционально создаётся проблема GitHub в публичном репозитории. Чтобы отказаться, установите переменную окружения `DISABLE_FEEDBACK_COMMAND` на `1`.

123 123 

124Когда вы используете поставщика третьей стороны, такого как Bedrock или Vertex, или у вас не настроены учётные данные Anthropic, `/feedback` записывает отчёт в локальный архив в `~/.claude/feedback-bundles/` вместо отправки в Anthropic. Известные паттерны ключей API и токенов удаляются перед записью архива. Ничего не покидает вашу машину, пока вы не отправите этот файл своему представителю учётной записи Anthropic или не прикрепите его к запросу поддержки.124Когда вы используете поставщика третьей стороны, такого как Amazon Bedrock или Google Cloud's Agent Platform, или у вас не настроены учётные данные Anthropic, `/feedback` записывает отчёт в локальный архив в `~/.claude/feedback-bundles/` вместо отправки в Anthropic. Известные паттерны ключей API и токенов удаляются перед записью архива. Ничего не покидает вашу машину, пока вы не отправите этот файл своему представителю учётной записи Anthropic или не прикрепите его к запросу поддержки.

125 125 

126<h2 id="default-behaviors-by-api-provider">126<h2 id="default-behaviors-by-api-provider">

127 Поведение по умолчанию в зависимости от поставщика API127 Поведение по умолчанию в зависимости от поставщика API

128</h2>128</h2>

129 129 

130По умолчанию отчёты об ошибках, телеметрия и отчёты об ошибках отключены при использовании Bedrock, Vertex, Foundry или Claude Platform on AWS. Опросы о качестве сеанса и проверка безопасности домена WebFetch являются исключениями и выполняются независимо от поставщика. На сеансе с подписью [Claude apps gateway](/ru/claude-apps-gateway) аналитика использования, отчёты об ошибках и оценки опросов для Anthropic отключены самим учётным данным шлюза, без возможности их повторного включения. Вы можете отказаться от всего несущественного трафика, включая опросы, сразу же, установив `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`. Эта переменная не влияет на проверку WebFetch, которая имеет свой собственный отказ. Вот полное поведение по умолчанию: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, которая имеет свой собственный отказ. Вот полное поведение по умолчанию:

131 131 

132| Сервис | Claude API | Vertex API | Bedrock API | Foundry API | Claude Platform on AWS |132| Сервис | Claude API | Google Cloud's Agent Platform API | Amazon Bedrock API | Microsoft Foundry API | Claude Platform on AWS |

133| ------------------------------------ | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |133| ------------------------------------ | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |

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. |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. |

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. |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. |


139 139 

140Все переменные окружения можно проверить в `settings.json` (см. [settings reference](/ru/settings)).140Все переменные окружения можно проверить в `settings.json` (см. [settings reference](/ru/settings)).

141 141 

142Начиная с версии 2.1.126, когда хост-платформа устанавливает `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`, метрики по умолчанию включены для Vertex, Bedrock и Foundry и следуют стандартному отказу `DISABLE_TELEMETRY`. Отчёты об ошибках Sentry и отчёты `/feedback` остаются отключены по умолчанию на этих поставщиках.142Начиная с версии 2.1.126, когда хост-платформа устанавливает `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`, метрики по умолчанию включены для Google Cloud's Agent Platform, Amazon Bedrock и Microsoft Foundry и следуют стандартному отказу `DISABLE_TELEMETRY`. Отчёты об ошибках Sentry и отчёты `/feedback` остаются отключены по умолчанию на этих поставщиках.

143 143 

144<h3 id="webfetch-domain-safety-check">144<h3 id="webfetch-domain-safety-check">

145 WebFetch domain safety check145 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` | Диагностика конфигурации: неверные ключи, ошибки схемы, здоровье установки. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, также сообщает о дублирующихся именах [subagent](/ru/sub-agents), определённых в одной области, и отмечает, какой из них активен |28| `/doctor` | Диагностика конфигурации: неверные ключи, ошибки схемы, здоровье установки, неиспользуемые расширения и дублирующиеся имена [subagent](/ru/sub-agents) в одной папке с предложенными исправлениями |

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`, чтобы проверить файлы конфигурации и выявить неверные ключи или ошибки схемы. Когда `/doctor` сообщает о проблемах, нажмите `f`, чтобы отправить диагностический отчёт Claude и позволить ему пройти через исправления с вами.48Запустите `/doctor`, чтобы проверить вашу конфигурацию и установку. Он сообщает о том, что находит, включая неверные файлы параметров, дублирующиеся установки и неиспользуемые расширения, затем предлагает исправления, которые применяет только после вашего подтверждения. До версии 2.1.205 `/doctor` открывал экран диагностики только для чтения, и нажатие `f` отправляло отчёт Claude для исправления.

49 

50Из терминала `claude doctor` выводит диагностику установки и параметров только для чтения без запуска сеанса.

49 51 

50Запустите `/status`, чтобы увидеть, какие источники параметров активны, включая то, действуют ли управляемые параметры. Чтобы понять, какая область выигрывает для данного ключа, см. [Как взаимодействуют области](/ru/settings#how-scopes-interact).52Запустите `/status`, чтобы увидеть, какие источники параметров активны, включая то, действуют ли управляемые параметры. Чтобы понять, какая область выигрывает для данного ключа, см. [Как взаимодействуют области](/ru/settings#how-scopes-interact).

51 53 


67 69 

68Запустите `/hooks`, чтобы перечислить каждый hook, зарегистрированный для текущей сессии, сгруппированный по событиям. Если hook, который вы определили, не появляется, он не читается: hooks идут под ключом `"hooks"` в файле параметров, а не в отдельном файле.70Запустите `/hooks`, чтобы перечислить каждый hook, зарегистрированный для текущей сессии, сгруппированный по событиям. Если hook, который вы определили, не появляется, он не читается: hooks идут под ключом `"hooks"` в файле параметров, а не в отдельном файле.

69 71 

70Если hook появляется, но не срабатывает, обычно причина в matcher. Поле `matcher` — это одна строка, которая использует `|` для соответствия нескольким именам tools, например `"Edit|Write"`. {/* min-version: 2.1.191 */}На Claude Code v2.1.191 или позже `,` также работает как разделитель, поэтому `"Edit,Write"` эквивалентно. На более ранних версиях запятая переходит к оценке regex и matcher никогда не совпадает, поэтому используйте `|`, если вы ещё не на v2.1.191. Неправильное имя tool молча не срабатывает по той же причине. Значение массива — это ошибка схемы: Claude Code показывает уведомление об ошибке параметров, `/doctor` сообщает об ошибке валидации, и запись hook удаляется, поэтому она не будет отображаться в `/hooks`.72Если hook появляется, но не срабатывает, обычно причина в matcher. Проверьте его на эти ошибки:

73 

74* Поле `matcher` — это одна строка, которая использует `|` для соответствия нескольким именам tools, например `"Edit|Write"`. {/* min-version: 2.1.191 */}Разделитель `,` эквивалентен, поэтому `"Edit,Write"` соответствует тем же tools. До v2.1.191 запятая переходила к оценке regex и matcher никогда не совпадал, поэтому используйте `|`, если вы ещё не на v2.1.191.

75* Неправильное имя tool создаёт matcher, который ничему не соответствует, поэтому hook молча не срабатывает.

76* Значение массива — это ошибка схемы: Claude Code показывает уведомление об ошибке параметров и отклоняет весь файл параметров пользователя, проекта или локальных параметров, `claude doctor` сообщает об ошибке валидации, и ни один hook из этого файла не появляется в `/hooks`. В [управляемых параметрах](/ru/settings#settings-files) удаляется только неправильная запись, и другие hooks из этого файла всё ещё применяются.

71 77 

72Правки в `settings.json` вступают в силу в работающей сессии после краткой задержки стабильности файла. Вам не нужно перезагружаться. Если `/hooks` всё ещё показывает старое определение через несколько секунд после сохранения, запустите `/hooks` снова, чтобы обновить представление.78Правки в `settings.json` вступают в силу в работающей сессии после краткой задержки стабильности файла. Вам не нужно перезагружаться. Если `/hooks` всё ещё показывает старое определение через несколько секунд после сохранения, запустите `/hooks` снова, чтобы обновить представление.

73 79 


77 Протестируйте с чистой конфигурацией83 Протестируйте с чистой конфигурацией

78</h2>84</h2>

79 85 

80{/* min-version: 2.1.169 */}Начните с [`claude --safe-mode`](/ru/cli-reference#cli-flags), который запускает сессию со всеми отключёнными настройками, включая `CLAUDE.md`, skills, plugins, hooks, MCP серверы и пользовательские команды и агенты. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально. Если проблема исчезает в безопасном режиме, одна из этих поверхностей является причиной; используйте целевые проверки выше, чтобы найти, какая именно. Управляемые параметры, развёрнутые вашей организацией, всё ещё частично применяются, поэтому настроенные политикой hooks и строка состояния работают даже в безопасном режиме.86{/* min-version: 2.1.169 */}Начните с [`claude --safe-mode`](/ru/cli-reference#cli-flags), который запускает сессию со всеми отключёнными настройками, включая `CLAUDE.md`, skills, plugins, hooks, MCP серверы и пользовательские команды и агенты. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально. Если проблема исчезает в безопасном режиме, одна из этих поверхностей является причиной; используйте целевые проверки выше, чтобы найти, какая именно. Безопасный режим по-прежнему применяет управляемые hooks и политику параметров от вашей организации. Управляемые plugins, skills, `CLAUDE.md` и MCP серверы отключены.

81 87 

82Если проблема сохраняется в безопасном режиме или ваши параметры сами по себе вызывают подозрения, сравните с сессией, которая ничего не загружает из вашей обычной установки. Укажите [`CLAUDE_CONFIG_DIR`](/ru/env-vars) на пустой каталог, чтобы обойти всё под `~/.claude`, и запустите из каталога, который не имеет папки `.claude`, файла `.mcp.json` или `CLAUDE.md`, чтобы конфигурация проекта также была пропущена.88Если проблема сохраняется в безопасном режиме или ваши параметры сами по себе вызывают подозрения, сравните с сессией, которая ничего не загружает из вашей обычной установки. Укажите [`CLAUDE_CONFIG_DIR`](/ru/env-vars) на пустой каталог, чтобы обойти всё под `~/.claude`, и запустите из каталога, который не имеет папки `.claude`, файла `.mcp.json` или `CLAUDE.md`, чтобы конфигурация проекта также была пропущена.

83 89 

desktop.md +66 −32

Details

29На вкладке Code каждый разговор является **сеансом**: он имеет свою историю чата, папку проекта и изменения кода, независимые от любого другого сеанса. Боковая панель отображает ваши сеансы и позволяет запускать несколько параллельно. В рамках сеанса вы можете:29На вкладке Code каждый разговор является **сеансом**: он имеет свою историю чата, папку проекта и изменения кода, независимые от любого другого сеанса. Боковая панель отображает ваши сеансы и позволяет запускать несколько параллельно. В рамках сеанса вы можете:

30 30 

31* [Просматривать и комментировать различия](#review-changes-with-diff-view), а затем [отслеживать полученный PR через CI](#monitor-pull-request-status)31* [Просматривать и комментировать различия](#review-changes-with-diff-view), а затем [отслеживать полученный PR через CI](#monitor-pull-request-status)

32* [Просматривать ваше работающее приложение](#preview-your-app) во встроенном браузере, пока Claude проверяет свои собственные изменения32* [Просматривать ваше работающее приложение](#preview-your-app) во встроенном браузере, пока Claude проверяет свои собственные изменения, и [открывать внешние сайты](#browse-external-sites) рядом с ним

33* [Организовать панели](#arrange-your-workspace) для чата, различий, предпросмотра, терминала и редактора файлов рядом друг с другом33* [Организовать панели](#arrange-your-workspace) для чата, различий, браузера, терминала и редактора файлов рядом друг с другом

34* Задать [боковой вопрос](#ask-a-side-question-without-derailing-the-session), который использует контекст сеанса без отклонения от основного потока34* Задать [боковой вопрос](#ask-a-side-question-without-derailing-the-session), который использует контекст сеанса без отклонения от основного потока

35* [Подключить внешние инструменты](#connect-external-tools) такие как GitHub, Slack и Linear35* [Подключить внешние инструменты](#connect-external-tools) такие как GitHub, Slack и Linear

36* Позволить Claude [открывать приложения и управлять вашим экраном](#let-claude-use-your-computer)36* Позволить Claude [открывать приложения и управлять вашим экраном](#let-claude-use-your-computer)


78 Выбор режима разрешений78 Выбор режима разрешений

79</h3>79</h3>

80 80 

81Режимы разрешений контролируют, сколько автономности имеет Claude во время сеанса: спрашивает ли он перед редактированием файлов, запуском команд или обоих. Вы можете переключать режимы в любое время, используя селектор режима рядом с кнопкой отправки. Начните с Ask permissions, чтобы увидеть ровно то, что делает Claude, затем переходите к Auto accept edits или Plan mode по мере того, как вы становитесь более уверены.81Режимы разрешений контролируют, сколько автономности имеет Claude во время сеанса: спрашивает ли он перед редактированием файлов, запуском команд или обоих. Вы можете переключать режимы в любое время, используя селектор режима рядом с кнопкой отправки. Начните с Manual, чтобы увидеть ровно то, что делает Claude, затем переходите к Accept edits или Plan по мере того, как вы становитесь более уверены.

82 82 

83| Режим | Ключ параметров | Поведение |83| Режим | Ключ параметров | Поведение |

84| ---------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |84| ---------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

85| **Ask permissions** | `default` | Claude спрашивает перед редактированием файлов или запуском команд. Вы видите различия и можете принять или отклонить каждое изменение. Рекомендуется для новых пользователей. |85| **Manual** | `default` | Claude спрашивает перед редактированием файлов или запуском команд. Вы видите различия и можете принять или отклонить каждое изменение. Рекомендуется для новых пользователей. |

86| **Auto accept edits** | `acceptEdits` | Claude автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch` и `mv`, но всё ещё спрашивает перед запуском других команд терминала. Используйте это, когда вы доверяете изменениям файлов и хотите более быструю итерацию. |86| **Accept edits** | `acceptEdits` | Claude автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch` и `mv`, но всё ещё спрашивает перед запуском других команд терминала. Используйте это, когда вы доверяете изменениям файлов и хотите более быструю итерацию. |

87| **Plan mode** | `plan` | Claude читает файлы и запускает команды для исследования, затем предлагает план без редактирования вашего исходного кода. Хорошо для сложных задач, где вы хотите сначала проверить подход. |87| **Plan** | `plan` | Claude читает файлы и запускает команды для исследования, затем предлагает план без редактирования вашего исходного кода. Хорошо для сложных задач, где вы хотите сначала проверить подход. |

88| **Auto** | `auto` | Claude выполняет все действия с фоновыми проверками безопасности, которые проверяют соответствие вашему запросу. Снижает подсказки разрешений при сохранении надзора. Включите в Settings → Claude Code. См. [требования доступности](#auto-mode-availability) ниже. |88| **Auto** | `auto` | Claude выполняет все действия с фоновыми проверками безопасности, которые проверяют соответствие вашему запросу. Снижает подсказки разрешений при сохранении надзора. Включите в Settings → Claude Code. См. [требования доступности](#auto-mode-availability) ниже. |

89| **Bypass permissions** | `bypassPermissions` | Claude работает без каких-либо подсказок разрешений, кроме тех, которые вынуждены явными [правилами запроса](/ru/permissions#manage-permissions); эквивалентно `--dangerously-skip-permissions` в CLI. Включите в Settings → Claude Code под "Allow bypass permissions mode". Используйте только в изолированных контейнерах или виртуальных машинах. Администраторы предприятия могут отключить эту опцию. |89| **Bypass permissions** | `bypassPermissions` | Claude работает без каких-либо подсказок разрешений, кроме тех, которые вынуждены явными [правилами запроса](/ru/permissions#manage-permissions) или классификаторами безопасности, когда Claude [действует на внешних сайтах](#browse-external-sites); эквивалентно `--dangerously-skip-permissions` в CLI. Включите в Settings → Claude Code под "Allow bypass permissions mode". Используйте только в изолированных контейнерах или виртуальных машинах. Администраторы предприятия могут отключить эту опцию. |

90 

91Более ранние версии вкладки Code обозначали эти режимы как Ask permissions, Auto accept edits и Plan mode.

90 92 

91Режим разрешений `dontAsk` доступен только в [CLI](/ru/permission-modes#allow-only-pre-approved-tools-with-dontask-mode).93Режим разрешений `dontAsk` доступен только в [CLI](/ru/permission-modes#allow-only-pre-approved-tools-with-dontask-mode).

92 94 

93<span id="auto-mode-availability" />95<span id="auto-mode-availability" />

94 96 

95Auto mode — это исследовательский предпросмотр, доступный всем пользователям на Anthropic API и требует Claude Opus 4.6 или позже, или Sonnet 4.6 или позже. В развёртываниях Enterprise, которые маршрутизируют Desktop на Google Cloud Vertex AI, auto mode отключен до тех пор, пока вы не [установите `CLAUDE_CODE_ENABLE_AUTO_MODE`](/ru/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry), и там поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8.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.

96 98 

97<Tip title="Best practice">99<Tip title="Best practice">

98 Начните сложные задачи в Plan mode, чтобы Claude наметил подход перед внесением изменений. После одобрения плана переключитесь на Auto accept edits или Ask permissions для его выполнения. См. [explore first, then plan, then code](/ru/best-practices#explore-first-then-plan-then-code) для получения дополнительной информации об этом рабочем процессе.100 Начните сложные задачи в Plan, чтобы Claude наметил подход перед внесением изменений. После одобрения плана переключитесь на Accept edits или Manual для его выполнения. См. [explore first, then plan, then code](/ru/best-practices#explore-first-then-plan-then-code) для получения дополнительной информации об этом рабочем процессе.

99</Tip>101</Tip>

100 102 

101Облачные сеансы поддерживают Accept edits, Plan mode и Auto mode. Accept edits соответствует режиму `default`: облачные сеансы предварительно одобряют редактирование файлов, поэтому селектор показывает Accept edits вместо Ask permissions. Bypass permissions недоступен, потому что облачное окружение уже изолировано.103Облачные сеансы поддерживают Accept edits, Plan и Auto. Accept edits соответствует режиму `default`: облачные сеансы предварительно одобряют редактирование файлов, поэтому селектор показывает Accept edits вместо Manual. Bypass permissions недоступен, потому что облачное окружение уже изолировано.

102 104 

103Администраторы предприятия могут ограничить, какие режимы разрешений доступны. См. [конфигурация предприятия](#enterprise-configuration) для получения подробной информации.105Администраторы предприятия могут ограничить, какие режимы разрешений доступны. См. [конфигурация предприятия](#enterprise-configuration) для получения подробной информации.

104 106 


106 Предпросмотр вашего приложения108 Предпросмотр вашего приложения

107</h3>109</h3>

108 110 

109Claude может запустить dev-сервер и открыть встроенный браузер для проверки своих изменений. Это работает как для фронтенд-веб-приложений, так и для бэкенд-серверов: Claude может тестировать конечные точки API, просматривать логи сервера и итерировать по найденным проблемам. В большинстве случаев Claude автоматически запускает сервер после редактирования файлов проекта. Вы также можете попросить Claude предпросмотр в любое время. По умолчанию Claude [автоматически проверяет](#auto-verify-changes) изменения после каждого редактирования.111Claude может запустить dev-сервер и открыть его в панели Browser для проверки своих изменений. Это работает как для фронтенд-веб-приложений, так и для бэкенд-серверов: Claude может тестировать конечные точки API, просматривать логи сервера и итерировать по найденным проблемам. В большинстве случаев Claude автоматически запускает сервер после редактирования файлов проекта. Вы также можете попросить Claude предпросмотр в любое время. По умолчанию Claude [автоматически проверяет](#auto-verify-changes) изменения после каждого редактирования.

110 112 

111Панель предпросмотра также может открывать статические HTML-файлы, PDF-файлы, изображения и видео из вашего проекта. Нажмите на путь HTML, PDF, изображения или видео в чате, чтобы открыть его в предпросмотре.113Панель Browser также может открывать статические HTML-файлы, PDF-файлы, изображения и видео из вашего проекта. Нажмите на путь HTML, PDF, изображения или видео в чате, чтобы открыть его там.

112 114 

113Из панели предпросмотра вы можете:115Из панели Browser вы можете:

114 116 

115* Взаимодействовать с вашим запущенным приложением прямо во встроенном браузере117* Взаимодействовать с вашим запущенным приложением прямо в панели Browser

116* Смотреть, как Claude автоматически проверяет свои собственные изменения: он делает скриншоты, проверяет DOM, нажимает элементы, заполняет формы и исправляет найденные проблемы118* Смотреть, как Claude автоматически проверяет свои собственные изменения: он делает скриншоты, проверяет DOM, нажимает элементы, заполняет формы и исправляет найденные проблемы

117* Запускать или останавливать серверы из раскрывающегося списка **Preview** в панели инструментов сеанса119* Запускать или останавливать серверы из раскрывающегося списка сервера в панели инструментов сеанса

118* Сохранять cookies и локальное хранилище между перезагрузками сервера, выбрав **Persist sessions** в раскрывающемся списке, чтобы вам не пришлось повторно входить во время разработки120* Сохранять cookies и локальное хранилище между перезагрузками сервера, выбрав **Persist sessions** в раскрывающемся списке, чтобы вам не пришлось повторно входить во время разработки

119* Редактировать конфигурацию сервера или остановить все серверы сразу121* Редактировать конфигурацию сервера или остановить все серверы сразу

120 122 

121Claude создаёт начальную конфигурацию сервера на основе вашего проекта. Если ваше приложение использует пользовательскую команду dev, отредактируйте `.claude/launch.json` в соответствии с вашей установкой. См. [Конфигурация серверов предпросмотра](#configure-preview-servers) для полного справочника.123Claude создаёт начальную конфигурацию сервера на основе вашего проекта. Если ваше приложение использует пользовательскую команду dev, отредактируйте `.claude/launch.json` в соответствии с вашей установкой. См. [Configure preview servers](#configure-preview-servers) для полного справочника.

124 

125Чтобы очистить сохранённые данные сеанса или полностью отключить Browser, используйте переключатели в Settings → Claude Code.

126 

127<h3 id="browse-external-sites">

128 Просмотр внешних сайтов

129</h3>

130 

131Панель Browser — это браузер с вкладками, поэтому вы можете открывать документацию, трекеры проблем или любой другой сайт рядом с вашим запущенным приложением. Чтобы открыть Browser, нажмите **Cmd+Shift+B** на macOS или **Ctrl+Shift+B** на Windows, или выберите его из меню **Views**. Когда вы нажимаете на внешнюю ссылку в чате, выбор предлагает **Open in app** для использования панели Browser или **Default browser** для использования вашего собственного; **Cmd**-нажатие на macOS или **Ctrl**-нажатие на Windows открывает ссылку в вашем системном браузере напрямую. Вы можете войти на сайты в панели, включая всплывающие потоки входа, такие как Google OAuth.

132 

133Claude может читать и взаимодействовать с внешними страницами, используя те же инструменты, которые он использует для [проверки вашего приложения](#preview-your-app), с двумя дополнительными проверками безопасности:

134 

135* Классификаторы безопасности проверяют действия записи Claude на внешних страницах, такие как нажатие и ввод текста, в каждом режиме разрешений. Это те же классификаторы, которые использует [auto mode](#choose-a-permission-mode), и когда они отмечают действие, вы получаете подсказку разрешения независимо от режима.

136* В режимах разрешений, отличных от Auto и Bypass permissions, проверка списка разрешённых доменов также применяется перед тем, как Claude переходит на новый сайт.

137 

138<h4 id="approve-claude’s-actions-on-a-site">

139 Одобрение действий Claude на сайте

140</h4>

141 

142В первый раз, когда Claude действует на внешнем сайте, появляется карточка разрешения и Claude ждёт вашего выбора: **Allow once**, **Always allow** или **Deny**. **Allow once** одобряет действие без сохранения чего-либо. **Always allow** сохраняет одобрение для этого сайта на вашем устройстве, и вы можете отозвать его в Settings. Каждый сайт требует собственного одобрения, включая поддомены. Ваши локальные dev-серверы и файлы проекта не требуют одобрения, поэтому [auto-verify](#auto-verify-changes) продолжает работать без подсказок.

143 

144Даже на одобренном сайте Claude не будет покупать товары, создавать учётные записи или обходить CAPTCHAs без вашего ввода. Просмотр в панели Browser использует ту же модель безопасности, что и [Claude in Chrome extension](/ru/chrome). См. [Using Claude in Chrome safely](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) для того, как Claude обрабатывает чувствительные сайты и рискованные действия.

145 

146<h4 id="choose-between-the-browser-and-the-chrome-extension">

147 Выбор между Browser и Chrome extension

148</h4>

149 

150Панель Browser использует чистый профиль браузера, отдельный от вашего личного браузера, без каких-либо сохранённых входов или истории. Используйте его для создания и тестирования вашего приложения и для сайтов, которые не требуют вашей личности. Когда вы хотите, чтобы Claude действовал как вы в ваших вошедших сеансах, используйте [Claude in Chrome extension](/ru/chrome) вместо этого, которая делится состоянием входа вашего браузера.

151 

152<h4 id="restrict-external-browsing-for-your-organization">

153 Ограничение внешнего просмотра для вашей организации

154</h4>

122 155 

123Чтобы очистить сохранённые данные сеанса, переключите **Persist preview sessions** в Settings Claude Code. Чтобы полностью отключить предпросмотр, переключите **Preview** в Settings Claude Code.156Browser следует тем же [элементам управления списком разрешённых и заблокированных сайтов](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls), что и Claude in Chrome extension. Если ваша организация уже настроила эти списки для расширения, Browser уважает их автоматически. Администраторы также могут отключить инструменты Claude на внешних страницах с помощью параметра управления [`browserExternalPageTools`](#managed-settings). С отключёнными инструментами пользователи всё ещё могут переходить на внешние сайты; инструменты Claude не могут читать или действовать на них.

124 157 

125<h3 id="review-changes-with-diff-view">158<h3 id="review-changes-with-diff-view">

126 Просмотр изменений с помощью diff view159 Просмотр изменений с помощью diff view


164 Организация рабочей области197 Организация рабочей области

165</h2>198</h2>

166 199 

167Вкладка Code построена вокруг панелей, которые вы можете организовать в любой макет: чат, diff, предпросмотр, терминал, файл, план, задачи и подагент. Перетащите панель за её заголовок, чтобы переместить её, или перетащите край панели, чтобы изменить её размер. Нажмите **Cmd+\\** на macOS или **Ctrl+\\** на Windows, чтобы закрыть сфокусированную панель. Откройте дополнительные панели из меню **Views** в панели инструментов сеанса.200Вкладка Code построена вокруг панелей, которые вы можете организовать в любой макет: чат, diff, браузер, терминал, файл, план, задачи и подагент. Перетащите панель за её заголовок, чтобы переместить её, или перетащите край панели, чтобы изменить её размер. Нажмите **Cmd+\\** на macOS или **Ctrl+\\** на Windows, чтобы закрыть сфокусированную панель. Откройте дополнительные панели из меню **Views** в панели инструментов сеанса.

168 201 

169<Note>202<Note>

170 Макет панели, терминал, редактор файлов и режимы просмотра в этом разделе требуют Claude Desktop v1.2581.0 или более поздней версии. Откройте **Claude → Check for Updates** на macOS или **Help → Check for Updates** на Windows для обновления.203 Макет панели, терминал, редактор файлов и режимы просмотра в этом разделе требуют Claude Desktop v1.2581.0 или более поздней версии. Откройте **Claude → Check for Updates** на macOS или **Help → Check for Updates** на Windows для обновления.


180 Открытие и редактирование файлов213 Открытие и редактирование файлов

181</h3>214</h3>

182 215 

183Нажмите на путь файла в чате или средстве просмотра различий, чтобы открыть его в панели файлов. HTML, PDF, пути изображений и видео открываются в [панели предпросмотра](#preview-your-app) вместо этого. Сделайте точечные правки и нажмите **Save**, чтобы записать их обратно. Если файл изменился на диске с момента его открытия, панель предупредит вас и позволит вам переопределить или отклонить. Нажмите **Discard**, чтобы отменить ваши правки, или нажмите на путь в заголовке панели, чтобы скопировать абсолютный путь.216Нажмите на путь файла в чате или средстве просмотра различий, чтобы открыть его в панели файлов. HTML, PDF, пути изображений и видео открываются в [панели браузера](#preview-your-app) вместо этого. Сделайте точечные правки и нажмите **Save**, чтобы записать их обратно. Если файл изменился на диске с момента его открытия, панель предупредит вас и позволит вам переопределить или отклонить. Нажмите **Discard**, чтобы отменить ваши правки, или нажмите на путь в заголовке панели, чтобы скопировать абсолютный путь.

184 217 

185Панель файлов доступна в локальных и SSH-сеансах. Для удалённых сеансов попросите Claude сделать изменение.218Панель файлов доступна в локальных и SSH-сеансах. Для облачных сеансов попросите Claude сделать изменение.

186 219 

187<h3 id="open-files-in-other-apps">220<h3 id="open-files-in-other-apps">

188 Открытие файлов в других приложениях221 Открытие файлов в других приложениях


224| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Следующий или предыдущий сеанс |257| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Следующий или предыдущий сеанс |

225| `Esc` | Остановить ответ Claude |258| `Esc` | Остановить ответ Claude |

226| `Cmd` `Shift` `D` | Переключить панель diff |259| `Cmd` `Shift` `D` | Переключить панель diff |

227| `Cmd` `Shift` `P` | Переключить панель предпросмотра |260| `Cmd` `Shift` `B` | Переключить панель браузера |

228| `Cmd` `Shift` `S` | Выбрать элемент в предпросмотре |261| `Cmd` `Shift` `S` | Выбрать элемент в браузере |

229| `Ctrl` `` ` `` | Переключить панель терминала |262| `Ctrl` `` ` `` | Переключить панель терминала |

230| `Cmd` `\` | Закрыть сфокусированную панель |263| `Cmd` `\` | Закрыть сфокусированную панель |

231| `Cmd` `;` | Открыть боковой чат |264| `Cmd` `;` | Открыть боковой чат |


437 470 

438Claude автоматически обнаруживает вашу установку dev-сервера и сохраняет конфигурацию в `.claude/launch.json` в корне папки, которую вы выбрали при запуске сеанса. Preview использует эту папку как свой рабочий каталог, поэтому если вы выбрали родительскую папку, подпапки с их собственными dev-серверами не будут обнаружены автоматически. Чтобы работать с сервером подпапки, либо запустите сеанс в этой папке напрямую, либо добавьте конфигурацию вручную.471Claude автоматически обнаруживает вашу установку dev-сервера и сохраняет конфигурацию в `.claude/launch.json` в корне папки, которую вы выбрали при запуске сеанса. Preview использует эту папку как свой рабочий каталог, поэтому если вы выбрали родительскую папку, подпапки с их собственными dev-серверами не будут обнаружены автоматически. Чтобы работать с сервером подпапки, либо запустите сеанс в этой папке напрямую, либо добавьте конфигурацию вручную.

439 472 

440Чтобы настроить, как запускается ваш сервер, например использовать `yarn dev` вместо `npm run dev` или изменить порт, отредактируйте файл вручную или нажмите **Edit configuration** в раскрывающемся списке Preview, чтобы открыть его в вашем редакторе кода. Файл поддерживает JSON с комментариями.473Чтобы настроить, как запускается ваш сервер, например использовать `yarn dev` вместо `npm run dev` или изменить порт, отредактируйте файл вручную или нажмите **Edit configuration** в раскрывающемся списке сервера, чтобы открыть его в вашем редакторе кода. Файл поддерживает JSON с комментариями.

441 474 

442```json theme={null}475```json theme={null}

443{476{


461 494 

462Когда `autoVerify` включен, Claude автоматически проверяет изменения кода после редактирования файлов. Он делает скриншоты, проверяет ошибки и подтверждает работу изменений перед завершением своего ответа.495Когда `autoVerify` включен, Claude автоматически проверяет изменения кода после редактирования файлов. Он делает скриншоты, проверяет ошибки и подтверждает работу изменений перед завершением своего ответа.

463 496 

464Auto-verify включен по умолчанию. Отключите его для каждого проекта, добавив `"autoVerify": false` в `.claude/launch.json`, или переключите его из меню **Preview**.497Auto-verify включен по умолчанию. Отключите его для каждого проекта, добавив `"autoVerify": false` в `.claude/launch.json`, или переключите его из меню раскрывающегося списка сервера.

465 498 

466```json theme={null}499```json theme={null}

467{500{


702| `permissions.disableBypassPermissionsMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима обхода разрешений. |735| `permissions.disableBypassPermissionsMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима обхода разрешений. |

703| `disableAutoMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима [Auto](/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет Auto из селектора режима. Также принимается под `permissions`. |736| `disableAutoMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима [Auto](/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет Auto из селектора режима. Также принимается под `permissions`. |

704| `autoMode` | настройте, что классификатор auto mode доверяет и блокирует во всей вашей организации. См. [Configure auto mode](/ru/auto-mode-config). |737| `autoMode` | настройте, что классификатор auto mode доверяет и блокирует во всей вашей организации. См. [Configure auto mode](/ru/auto-mode-config). |

738| `browserExternalPageTools` | установите на `"disabled"`, чтобы предотвратить Claude от использования инструментов для чтения или действия на внешних страницах в [панели браузера](#browse-external-sites). Пользователи по-прежнему могут самостоятельно переходить на внешние сайты, и предпросмотры локального сервера разработки не затронуты. |

705| `sshConfigs` | предварительно настройте [SSH-соединения](#pre-configure-ssh-connections-for-your-team), которые появляются в раскрывающемся списке окружения. Пользователи не могут редактировать или удалять управляемые соединения. |739| `sshConfigs` | предварительно настройте [SSH-соединения](#pre-configure-ssh-connections-for-your-team), которые появляются в раскрывающемся списке окружения. Пользователи не могут редактировать или удалять управляемые соединения. |

706| `sshHostAllowlist` | ограничьте [SSH-сеансы](#restrict-which-ssh-hosts-users-can-connect-to) хостами, чьё разрешённое имя хоста совпадает с одним из этих шаблонов. Пустой массив отключает SSH-сеансы. Читается только из управляемых параметров. |740| `sshHostAllowlist` | ограничьте [SSH-сеансы](#restrict-which-ssh-hosts-users-can-connect-to) хостами, чьё разрешённое имя хоста совпадает с одним из этих шаблонов. Пустой массив отключает SSH-сеансы. Читается только из управляемых параметров. |

707| `managedMcpServers` | отправьте конфигурации MCP-сервера всем пользователям в развёртывании третьей стороны. Каждая запись указывает транспорт `"http"`, `"sse"` или `"stdio"`, детали подключения и опционально карту `toolPolicy`, которая ограничивает, какие инструменты на этом сервере пользователи могут вызывать. Доступно только в развёртываниях Desktop третьей стороны (3P). Доставляйте этот ключ через файл управляемых параметров или MDM, так как развёртывания третьей стороны не получают параметры консоли администратора. |741| `managedMcpServers` | отправьте конфигурации MCP-сервера всем пользователям в развёртывании третьей стороны. Каждая запись указывает транспорт `"http"`, `"sse"` или `"stdio"`, детали подключения и опционально карту `toolPolicy`, которая ограничивает, какие инструменты на этом сервере пользователи могут вызывать. Доступно только в развёртываниях Desktop третьей стороны (3P). Доставляйте этот ключ через файл управляемых параметров или MDM, так как развёртывания третьей стороны не получают параметры консоли администратора. |


733 Обработка данных767 Обработка данных

734</h3>768</h3>

735 769 

736Claude Code обрабатывает ваш код локально в локальных сеансах или на облачной инфраструктуре Anthropic в удалённых сеансах. Разговоры и контекст кода отправляются в API Anthropic для обработки. См. [обработка данных](/ru/data-usage) для получения подробной информации о сохранении данных, конфиденциальности и соответствии.770Claude Code обрабатывает ваш код локально в локальных сеансах или на облачной инфраструктуре Anthropic в облачных сеансах. Разговоры и контекст кода отправляются в API Anthropic для обработки. См. [обработка данных](/ru/data-usage) для получения подробной информации о сохранении данных, конфиденциальности и соответствии.

737 771 

738<h3 id="deployment">772<h3 id="deployment">

739 Развёртывание773 Развёртывание


754 788 

755Если вы уже используете Claude Code CLI, Desktop запускает тот же базовый механизм с графическим интерфейсом. Вы можете запускать оба одновременно на одной машине, даже на одном проекте. Каждый поддерживает отдельную историю сеансов, но они делят конфигурацию и память проекта через файлы CLAUDE.md.789Если вы уже используете Claude Code CLI, Desktop запускает тот же базовый механизм с графическим интерфейсом. Вы можете запускать оба одновременно на одной машине, даже на одном проекте. Каждый поддерживает отдельную историю сеансов, но они делят конфигурацию и память проекта через файлы CLAUDE.md.

756 790 

757Чтобы переместить сеанс CLI в Desktop, запустите `/desktop` в терминале. Claude сохраняет ваш сеанс и открывает его в приложении desktop, затем выходит из CLI. Эта команда доступна на macOS и Windows, когда вы вошли с подпиской Claude. Она недоступна при аутентификации по ключу API или на Bedrock, Vertex или Foundry.791Чтобы переместить сеанс CLI в Desktop, запустите `/desktop` в терминале. Claude сохраняет ваш сеанс и открывает его в приложении desktop, затем выходит из CLI. Эта команда доступна на macOS и Windows, когда вы вошли с подпиской Claude. Она недоступна при аутентификации по ключу API или на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.

758 792 

759<Tip>793<Tip>

760 Когда использовать Desktop vs CLI: используйте Desktop, когда вы хотите управлять параллельными сеансами в одном окне, организовать панели рядом или просмотреть изменения визуально. Используйте CLI, когда вам нужны скрипты, автоматизация или вы предпочитаете рабочий процесс терминала.794 Когда использовать Desktop vs CLI: используйте Desktop, когда вы хотите управлять параллельными сеансами в одном окне, организовать панели рядом или просмотреть изменения визуально. Используйте CLI, когда вам нужны скрипты, автоматизация или вы предпочитаете рабочий процесс терминала.


804Эта таблица сравнивает основные возможности между CLI и Desktop. Для полного списка флагов CLI см. [справочник CLI](/ru/cli-reference).838Эта таблица сравнивает основные возможности между CLI и Desktop. Для полного списка флагов CLI см. [справочник CLI](/ru/cli-reference).

805 839 

806| Функция | CLI | Desktop |840| Функция | CLI | Desktop |

807| ---------------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |841| ---------------------------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

808| Режимы разрешений | Все режимы, включая `dontAsk` | Ask permissions, Auto accept edits, Plan mode, Auto и Bypass permissions через Settings |842| Режимы разрешений | Все режимы, включая `dontAsk` | Manual, Accept edits и Plan. Auto и Bypass permissions появляются в селекторе режима после того, как вы включите их в Settings |

809| `--dangerously-skip-permissions` | Флаг CLI | Режим Bypass permissions. Включите в Settings → Claude Code → "Allow bypass permissions mode" |843| `--dangerously-skip-permissions` | Флаг CLI | Режим Bypass permissions. Включите в Settings → Claude Code → "Allow bypass permissions mode" |

810| [Сторонние провайдеры](/ru/third-party-integrations) | Bedrock, Vertex AI, Foundry | Anthropic's API по умолчанию. Развёртывания предприятия могут конфигурировать Vertex AI и провайдеров шлюза. См. [руководство конфигурации предприятия](https://support.claude.com/en/articles/12622667-enterprise-configuration). Чтобы запустить вкладку Code на Bedrock, Vertex AI, Foundry или самостоятельно размещённом шлюзе LLM, см. [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview). |844| [Сторонние провайдеры](/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). |

811| [MCP servers](/ru/mcp) | Настройте в файлах параметров | UI Connectors для локальных и SSH-сеансов, или файлы параметров |845| [MCP servers](/ru/mcp) | Настройте в файлах параметров | UI Connectors для локальных и SSH-сеансов, или файлы параметров |

812| [Plugins](/ru/plugins) | Команда `/plugin` | UI менеджера плагинов |846| [Plugins](/ru/plugins) | Команда `/plugin` | UI менеджера плагинов |

813| @mention файлы | Текстовые | С автодополнением; локальные и SSH-сеансы только |847| @mention файлы | Текстовые | С автодополнением; локальные и SSH-сеансы только |


825 859 

826Следующие функции доступны только в CLI или расширении VS Code, кроме случаев, указанных ниже:860Следующие функции доступны только в CLI или расширении VS Code, кроме случаев, указанных ниже:

827 861 

828* **Сторонние провайдеры**: Desktop подключается к API Anthropic по умолчанию. Развёртывания предприятия могут конфигурировать Vertex AI и провайдеров шлюза через [управляемые параметры](https://support.claude.com/en/articles/12622667-enterprise-configuration). Для Bedrock или Foundry в CLI см. [quickstart](/ru/quickstart). В качестве исключения из раздела выше, [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview) запускает вкладку Code на Bedrock, Vertex AI, Foundry или самостоятельно размещённом шлюзе LLM.862* **Сторонние провайдеры**: 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.

829* **Linux (бета)**: Computer Use ещё недоступна в приложении desktop Linux. См. [Claude Desktop на Linux](/ru/desktop-linux).863* **Linux (бета)**: Computer Use ещё недоступна в приложении desktop Linux. См. [Claude Desktop на Linux](/ru/desktop-linux).

830* **Встроенные предложения кода**: Desktop не предоставляет предложения в стиле автодополнения. Это работает через разговорные подсказки и явные изменения кода.864* **Встроенные предложения кода**: Desktop не предоставляет предложения в стиле автодополнения. Это работает через разговорные подсказки и явные изменения кода.

831* **Команды агентов**: параллельные сеансы Claude Code, которые обмениваются сообщениями друг с другом, доступны в [CLI](/ru/agent-teams), а не в Desktop. Для многоагентной работы внутри одного сеанса используйте [динамические рабочие процессы](/ru/workflows), которые работают в Desktop.865* **Команды агентов**: параллельные сеансы Claude Code, которые обмениваются сообщениями друг с другом, доступны в [CLI](/ru/agent-teams), а не в Desktop. Для многоагентной работы внутри одного сеанса используйте [динамические рабочие процессы](/ru/workflows), которые работают в Desktop.

832* **Команды диалога терминала**: встроенные команды, которые открывают интерактивную панель в терминале, такие как `/permissions`, `/config` и `/doctor`, недоступны на вкладке Code и отвечают сообщением `isn't available in this environment`. Отредактируйте [файлы параметров](/ru/settings) напрямую, чтобы управлять правилами разрешений и конфигурацией, или запустите команду из автономного CLI.866* **Команды диалога терминала**: встроенные команды, которые открывают интерактивную панель в терминале, такие как `/permissions` и `/config`, недоступны на вкладке Code и отвечают сообщением `isn't available in this environment`. `/config` устанавливает параметр, когда вы передаёте `key=value`, например `/config theme=dark`; доступна только его форма выбора. Отредактируйте [файлы параметров](/ru/settings) напрямую, чтобы управлять правилами разрешений и конфигурацией, или запустите команду из автономного CLI.

833 867 

834<h2 id="troubleshooting">868<h2 id="troubleshooting">

835 Устранение неполадок869 Устранение неполадок

desktop-linux.md +26 −2

Details

25 Установка25 Установка

26</h2>26</h2>

27 27 

28Установите из репозитория apt Anthropic, чтобы обновления поступали через обычные обновления пакетов вашей системы.28Установите из репозитория apt Anthropic, чтобы обновления поступали через обычные обновления пакетов вашей системы. Откройте терминал и выполните команды на каждом шаге.

29 29 

30<Steps>30<Steps>

31 <Step title="Добавьте репозиторий apt Anthropic">31 <Step title="Добавьте репозиторий apt Anthropic">

32 Этот шаг загружает ключ подписи с помощью `curl`, который свежие установки Debian и Ubuntu могут не включать. Если команда загрузки завершится с ошибкой `sudo: curl: command not found`, сначала установите curl:

33 

34 ```bash theme={null}

35 sudo apt install curl

36 ```

37 

32 Загрузите ключ подписи Anthropic:38 Загрузите ключ подписи Anthropic:

33 39 

34 ```bash theme={null}40 ```bash theme={null}


69 Установка из загруженного файла75 Установка из загруженного файла

70</h3>76</h3>

71 77 

72Если вы не можете использовать репозиторий apt, загрузите пакет `.deb` для вашей архитектуры (x64 или arm64) с сайта [claude.com/download](https://claude.com/download), затем либо откройте его с помощью установщика программного обеспечения, либо запустите из каталога загрузок:78Если вы не можете использовать репозиторий apt, сначала загрузите пакет `.deb` для вашей архитектуры (x64 или arm64) с сайта [claude.com/download](https://claude.com/download). Затем откройте загруженный файл с помощью установщика программного обеспечения или установите его с помощью apt из каталога, содержащего загруженный файл:

73 79 

74```bash theme={null}80```bash theme={null}

75sudo apt install ./claude-desktop_*.deb81sudo apt install ./claude-desktop_*.deb

76```82```

77 83 

84Если apt сообщает об ошибке `E: Unsupported file ./claude-desktop_*.deb given on commandline`, шаблон не совпадает с файлом `.deb` в текущем каталоге. Подтвердите, что загрузка завершена, затем выполните команду снова из каталога, содержащего файл.

85 

78Пакет `.deb`, установленный таким образом, не получает обновления. Чтобы получать обновления через apt, добавьте репозиторий, как показано выше, или раскомментируйте строку `deb` в записи-заполнителе, которую пакет записывает в `/etc/apt/sources.list.d/claude-desktop.list`.86Пакет `.deb`, установленный таким образом, не получает обновления. Чтобы получать обновления через apt, добавьте репозиторий, как показано выше, или раскомментируйте строку `deb` в записи-заполнителе, которую пакет записывает в `/etc/apt/sources.list.d/claude-desktop.list`.

79 87 

80<h2 id="update">88<h2 id="update">


103sudo rm /etc/apt/sources.list.d/claude-desktop.list111sudo rm /etc/apt/sources.list.d/claude-desktop.list

104```112```

105 113 

114<h2 id="troubleshoot">

115 Troubleshooting

116</h2>

117 

118<h3 id="unable-to-locate-package-claude-desktop">

119 Unable to locate package claude-desktop

120</h3>

121 

122Если `sudo apt install claude-desktop` завершается с ошибкой `E: Unable to locate package claude-desktop`, apt не смог найти добавленный вами репозиторий. Проверьте следующее:

123 

124* Подтвердите, что запись репозитория была записана. `cat /etc/apt/sources.list.d/claude-desktop.list` должна показать строку `deb` из шага [Add Anthropic's apt repository](#install). Если файл пуст или отсутствует, выполните этот шаг снова.

125* Подтвердите, что ваша архитектура поддерживается. `dpkg --print-architecture` должна вывести `amd64` или `arm64`. Репозиторий не публикует пакеты для других архитектур.

126* Выполните `sudo apt update` снова и проверьте его вывод на наличие ошибок, связанных с `downloads.claude.ai`. Ошибка сети или ключа там означает, что репозиторий был добавлен, но не может быть достигнут или проверен.

127 

128Если репозиторий на месте и доступен, а пакет все еще не найден, вместо этого [install from a downloaded file](#install-from-a-downloaded-file).

129 

106<h2 id="what’s-not-in-the-linux-beta-yet">130<h2 id="what’s-not-in-the-linux-beta-yet">

107 Что еще не включено в бета-версию Linux131 Что еще не включено в бета-версию Linux

108</h2>132</h2>

Details

89 </Step>89 </Step>

90 90 

91 <Step title="Просмотрите и примите изменения">91 <Step title="Просмотрите и примите изменения">

92 По умолчанию вкладка Code запускается в [режиме Ask permissions](/ru/desktop#choose-a-permission-mode), где Claude предлагает изменения и ждет вашего одобрения перед их применением. Вы увидите:92 По умолчанию вкладка Code запускается в [режиме Manual mode](/ru/desktop#choose-a-permission-mode), где Claude предлагает изменения и ждет вашего одобрения перед их применением. Вы увидите:

93 93 

94 1. [Представление различий](/ru/desktop#review-changes-with-diff-view), показывающее точно, что изменится в каждом файле94 1. [Представление различий](/ru/desktop#review-changes-with-diff-view), показывающее точно, что изменится в каждом файле

95 2. Кнопки Accept/Reject для одобрения или отклонения каждого изменения95 2. Кнопки Accept/Reject для одобрения или отклонения каждого изменения


113 113 

114**Просмотрите изменения перед фиксацией.** После того как Claude отредактирует файлы, появляется индикатор `+12 -1`. Нажмите на него, чтобы открыть [представление различий](/ru/desktop#review-changes-with-diff-view), просмотрите изменения файл за файлом и оставляйте комментарии к определенным строкам. Claude читает ваши комментарии и пересматривает. Нажмите **Review code**, чтобы Claude оценил различия сам и оставил встроенные предложения.114**Просмотрите изменения перед фиксацией.** После того как Claude отредактирует файлы, появляется индикатор `+12 -1`. Нажмите на него, чтобы открыть [представление различий](/ru/desktop#review-changes-with-diff-view), просмотрите изменения файл за файлом и оставляйте комментарии к определенным строкам. Claude читает ваши комментарии и пересматривает. Нажмите **Review code**, чтобы Claude оценил различия сам и оставил встроенные предложения.

115 115 

116**Отрегулируйте, сколько контроля у вас есть.** Ваш [режим разрешений](/ru/desktop#choose-a-permission-mode) контролирует баланс. Ask permissions (по умолчанию) требует одобрения перед каждым редактированием. Auto accept edits автоматически принимает редактирование файлов для более быстрой итерации. Plan mode позволяет Claude наметить подход без касания каких-либо файлов, что полезно перед крупным рефакторингом.116**Отрегулируйте, сколько контроля у вас есть.** Ваш [режим разрешений](/ru/desktop#choose-a-permission-mode) определяет, сколько Claude может делать без запроса одобрения:

117 

118* **Manual**: по умолчанию. Claude просит разрешение перед редактированием файлов или запуском команд.

119* **Accept edits**: Claude автоматически принимает редактирование файлов для более быстрой итерации.

120* **Plan**: Claude предлагает подход без редактирования каких-либо файлов, что полезно перед крупным рефакторингом.

117 121 

118**Добавьте плагины для большей функциональности.** Нажмите кнопку **+** рядом с полем подсказки и выберите **Plugins**, чтобы просмотреть и установить [плагины](/ru/desktop#install-plugins), которые добавляют skills, агентов, MCP servers и многое другое.122**Добавьте плагины для большей функциональности.** Нажмите кнопку **+** рядом с полем подсказки и выберите **Plugins**, чтобы просмотреть и установить [плагины](/ru/desktop#install-plugins), которые добавляют skills, агентов, MCP servers и многое другое.

119 123 

120**Расположите вашу рабочую область.** Перетащите панели чата, различий, терминала, файла и предпросмотра в любой макет, который вам нужен. Откройте терминал с помощью **Ctrl+\`**, чтобы запускать команды рядом с вашим сеансом, или нажмите на путь файла, чтобы открыть его в панели файлов. См. [Расположение вашей рабочей области](/ru/desktop#arrange-your-workspace).124**Расположите вашу рабочую область.** Перетащите панели чата, различий, терминала, файла и браузера в любой макет, который вам нужен. Откройте терминал с помощью **Ctrl+\`**, чтобы запускать команды рядом с вашим сеансом, или нажмите на путь файла, чтобы открыть его в панели файлов. См. [Расположение вашей рабочей области](/ru/desktop#arrange-your-workspace).

121 125 

122**Предпросмотрите ваше приложение.** Нажмите на раскрывающееся меню **Preview**, чтобы запустить ваш dev server прямо в настольном приложении. Claude может просмотреть работающее приложение, протестировать конечные точки, проверить журналы и повторить то, что он видит. См. [Предпросмотр вашего приложения](/ru/desktop#preview-your-app).126**Предпросмотрите ваше приложение.** Когда вы запускаете ваш dev server в настольном приложении, ваше приложение открывается в панели браузера, которая также может [открывать внешние сайты](/ru/desktop#browse-external-sites). Claude может просмотреть работающее приложение, протестировать конечные точки, проверить журналы и повторить то, что он видит. См. [Предпросмотр вашего приложения](/ru/desktop#preview-your-app).

123 127 

124**Отслеживайте ваш pull request.** После открытия PR, Claude Code отслеживает результаты проверок CI и может автоматически исправить сбои или объединить PR после прохождения всех проверок. См. [Мониторинг статуса pull request](/ru/desktop#monitor-pull-request-status).128**Отслеживайте ваш pull request.** После открытия PR, Claude Code отслеживает результаты проверок CI и может автоматически исправить сбои или объединить PR после прохождения всех проверок. См. [Мониторинг статуса pull request](/ru/desktop#monitor-pull-request-status).

125 129 

devcontainer.md +2 −2

Details

75То, что вы видите в подсказке аутентификации, зависит от вашего поставщика:75То, что вы видите в подсказке аутентификации, зависит от вашего поставщика:

76 76 

77* **Anthropic**: вход через браузер с вашей учетной записью Claude или Anthropic Console77* **Anthropic**: вход через браузер с вашей учетной записью Claude или Anthropic Console

78* **[Amazon Bedrock, Google Vertex AI или Microsoft Foundry](/ru/third-party-integrations)**: Claude Code использует учетные данные вашего облачного поставщика без подсказки браузера78* **[Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](/ru/third-party-integrations)**: Claude Code использует учетные данные вашего облачного поставщика без подсказки браузера

79 79 

80Для облачных поставщиков передавайте учетные данные в контейнер как переменные окружения через `containerEnv`, секрет Codespaces или удостоверение рабочей нагрузки вашего облака, а не монтируйте файлы учетных данных с хоста. См. [Amazon Bedrock](/ru/amazon-bedrock), [Google Vertex AI](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry) для цепочки учетных данных, которую читает Claude Code.80Для облачных поставщиков передавайте учетные данные в контейнер как переменные окружения через `containerEnv`, секрет Codespaces или удостоверение рабочей нагрузки вашего облака, а не монтируйте файлы учетных данных с хоста. См. [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry) для цепочки учетных данных, которую читает Claude Code.

81 81 

82См. [Выбор поставщика API](/ru/admin-setup#choose-your-api-provider), чтобы решить, какой путь подходит вашей организации.82См. [Выбор поставщика API](/ru/admin-setup#choose-your-api-provider), чтобы решить, какой путь подходит вашей организации.

83 83 

Details

332* ввести текст для фильтрации по имени плагина или описанию332* ввести текст для фильтрации по имени плагина или описанию

333* нажать Enter, чтобы открыть подробный вид плагина и включить, отключить или удалить его333* нажать Enter, чтобы открыть подробный вид плагина и включить, отключить или удалить его

334 334 

335Удаление плагина, который `.claude/settings.json` проекта включает, запрашивает, какую область вы имеете в виду: отключить его только для вас, что записывает переопределение в ваш `.claude/settings.local.json` и оставляет плагин установленным для проекта, или удалить его для всех, что удаляет его из общего `.claude/settings.json`. Требуется Claude Code v2.1.203 или более поздняя версия. До v2.1.203 диалог предлагал только локальное отключение.

336 

335Подробный вид показывает компоненты, которые предоставляет плагин: команды, skills, agents, hooks, MCP servers и LSP servers. Тот же инвентарь доступен из командной строки с помощью `claude plugin details`.337Подробный вид показывает компоненты, которые предоставляет плагин: команды, skills, agents, hooks, MCP servers и LSP servers. Тот же инвентарь доступен из командной строки с помощью `claude plugin details`.

336 338 

337В Claude Code v2.1.187 и более поздних версиях вкладка Installed добавляет группу **Not used recently** для плагинов из маркетплейса, которые вы установили сами, но не использовали в течение как минимум двух недель и как минимум 10 сеансов, а подробный вид показывает строку **Last used** для каждого плагина. Используйте их, чтобы найти плагины, которые вы больше не используете, но которые по-прежнему добавляют стоимость запуска и контекста, затем отключите или удалите их.339Вкладка **Installed** также собирает плагины маркетплейса, которые вы установили сами, но не использовали в течение как минимум двух недель, в течение как минимум 10 сеансов, под заголовком **Not used recently**. Подробный вид показывает строку **Last used** для каждого плагина. Используйте их, чтобы найти плагины, которые по-прежнему добавляют стоимость запуска и контекста, хотя вы больше их не используете, затем отключите или удалите их. Требуется Claude Code v2.1.187 или более поздняя версия.

340 

341Два вида плагинов никогда не отображаются как неиспользуемые:

342 

343* плагины, которыми управляет ваша организация, или которые вы загружаете с помощью `--plugin-dir`

344* плагины, которые предоставляют тему, стиль вывода, монитор или workflow, поскольку они обеспечивают ценность без вызова для отслеживания

345 

346Заголовок **Not used recently** и строка **Last used** обе скрыты, когда ваша организация ограничивает маркетплейсы с помощью [`strictKnownMarketplaces`](/ru/settings#strictknownmarketplaces).

338 347 

339Плагины, которыми управляет ваша организация, или которые вы загружаете с помощью `--plugin-dir`, никогда не отображаются как неиспользуемые, и плагины, которые предоставляют LSP server, тему, стиль вывода, монитор или workflow, также никогда не отображаются, поскольку они обеспечивают ценность без вызова для отслеживания. Группа и строка **Last used** обе скрыты, когда ваша организация ограничивает маркетплейсы с помощью [`strictKnownMarketplaces`](/ru/settings#strictknownmarketplaces).348[Language server](/ru/plugins#add-lsp-servers-to-your-plugin) плагина считается использованным, когда он предоставляет диагностику или отвечает на запрос навигации по коду, поэтому плагин LSP, чей сервер активен в ваших сеансах, не отображается как неиспользуемый. До v2.1.203 активность языкового сервера не могла быть учтена как использование, поэтому плагины, которые предоставляют LSP server, были полностью исключены из группы, так же как плагины темы и стиля вывода по-прежнему есть.

340 349 

341Когда вы устанавливаете плагин, который объявляет зависимости, вывод установки указывает, какие зависимости были автоматически установлены вместе с ним.350Когда вы устанавливаете плагин, который объявляет зависимости, вывод установки указывает, какие зависимости были автоматически установлены вместе с ним.

342 351 

env-vars.md +52 −50

Details

96</h2>96</h2>

97 97 

98| Переменная | Назначение |98| Переменная | Назначение |

99| :------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |99| :------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

100| `ANTHROPIC_API_KEY` | Ключ API, отправляемый как заголовок `X-Api-Key`. При установке этот ключ используется вместо вашей подписки Claude Pro, Max, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии. В интерактивном режиме вам предлагается одобрить ключ один раз перед тем, как он переопределит вашу подписку. Чтобы использовать вашу подписку вместо этого, запустите `unset ANTHROPIC_API_KEY` |100| `ANTHROPIC_API_KEY` | Ключ API, отправляемый как заголовок `X-Api-Key`. При установке этот ключ используется вместо вашей подписки Claude Pro, Max, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии. В интерактивном режиме вам предлагается одобрить ключ один раз перед тем, как он переопределит вашу подписку. Чтобы использовать вашу подписку вместо этого, запустите `unset ANTHROPIC_API_KEY` |

101| `ANTHROPIC_AUTH_TOKEN` | Пользовательское значение для заголовка `Authorization` (значение, которое вы установите здесь, будет дополнено префиксом `Bearer `) |101| `ANTHROPIC_AUTH_TOKEN` | Пользовательское значение для заголовка `Authorization` (значение, которое вы установите здесь, будет дополнено префиксом `Bearer `) |

102| `ANTHROPIC_AWS_API_KEY` | Ключ API рабочей области для [Claude Platform on AWS](/ru/claude-platform-on-aws), созданный в AWS Console. Отправляется как `x-api-key` и имеет приоритет над AWS SigV4 |102| `ANTHROPIC_AWS_API_KEY` | Ключ API рабочей области для [Claude Platform on AWS](/ru/claude-platform-on-aws), созданный в AWS Console. Отправляется как `x-api-key` и имеет приоритет над AWS SigV4 |

103| `ANTHROPIC_AWS_BASE_URL` | Переопределить URL конечной точки [Claude Platform on AWS](/ru/claude-platform-on-aws). Используйте для пользовательских регионов или при маршрутизации через [шлюз LLM](/ru/llm-gateway). По умолчанию `https://aws-external-anthropic.{AWS_REGION}.api.aws` |103| `ANTHROPIC_AWS_BASE_URL` | Переопределить URL конечной точки [Claude Platform on AWS](/ru/claude-platform-on-aws). Используйте для пользовательских регионов или при маршрутизации через [шлюз LLM](/ru/llm-gateway). По умолчанию `https://aws-external-anthropic.{AWS_REGION}.api.aws` |

104| `ANTHROPIC_AWS_WORKSPACE_ID` | Требуется для [Claude Platform on AWS](/ru/claude-platform-on-aws). Отправляется в каждом запросе как заголовок `anthropic-workspace-id` |104| `ANTHROPIC_AWS_WORKSPACE_ID` | Требуется для [Claude Platform on AWS](/ru/claude-platform-on-aws). Отправляется в каждом запросе как заголовок `anthropic-workspace-id` |

105| `ANTHROPIC_BASE_URL` | Переопределить конечную точку API для маршрутизации запросов через прокси или шлюз. При установке на хост, не являющийся хостом первой стороны, [поиск инструментов MCP](/ru/mcp#scale-with-mcp-tool-search) отключен по умолчанию. Установите `ENABLE_TOOL_SEARCH=true`, если ваш прокси пересылает блоки `tool_reference`. {/* min-version: 2.1.196 */}Начиная с v2.1.196, [Remote Control](/ru/remote-control#requirements) отключен, когда это указывает на хост, отличный от `api.anthropic.com`, что соответствует его поведению на Bedrock, Vertex AI и Foundry |105| `ANTHROPIC_BASE_URL` | Переопределить конечную точку API для маршрутизации запросов через прокси или шлюз. При установке на хост, не являющийся хостом первой стороны, [поиск инструментов MCP](/ru/mcp#scale-with-mcp-tool-search) отключен по умолчанию. Установите `ENABLE_TOOL_SEARCH=true`, если ваш прокси пересылает блоки `tool_reference`. {/* min-version: 2.1.196 */}Начиная с v2.1.196, [Remote Control](/ru/remote-control#requirements) отключен, когда это указывает на хост, отличный от `api.anthropic.com`, что соответствует его поведению на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry |

106| `ANTHROPIC_BEDROCK_BASE_URL` | Переопределить URL конечной точки Bedrock. Используйте для пользовательских конечных точек Bedrock или при маршрутизации через [шлюз LLM](/ru/llm-gateway). См. [Amazon Bedrock](/ru/amazon-bedrock) |106| `ANTHROPIC_BEDROCK_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock. Используйте для пользовательских конечных точек Amazon Bedrock или при маршрутизации через [шлюз LLM](/ru/llm-gateway). См. [Amazon Bedrock](/ru/amazon-bedrock) |

107| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Переопределить URL конечной точки Bedrock Mantle. См. [конечная точка Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) |107| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock Mantle. См. [конечная точка Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) |

108| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Bedrock [уровень обслуживания](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) (`default`, `flex` или `priority`). Отправляется как заголовок `X-Amzn-Bedrock-Service-Tier`. См. [Amazon Bedrock](/ru/amazon-bedrock#service-tiers) |108| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [уровень обслуживания](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) (`default`, `flex` или `priority`). Отправляется как заголовок `X-Amzn-Bedrock-Service-Tier`. См. [Amazon Bedrock](/ru/amazon-bedrock#service-tiers) |

109| `ANTHROPIC_BETAS` | Разделённый запятыми список дополнительных значений заголовка `anthropic-beta` для включения в запросы API. Claude Code уже отправляет необходимые ему заголовки beta; используйте это, чтобы согласиться на [бета-версию Anthropic API](https://platform.claude.com/docs/en/api/beta-headers) перед тем, как Claude Code добавит встроенную поддержку. В отличие от [флага `--betas`](/ru/cli-reference#cli-flags), который требует аутентификации с помощью ключа API, эта переменная работает со всеми методами аутентификации, включая подписку Claude.ai |109| `ANTHROPIC_BETAS` | Разделённый запятыми список дополнительных значений заголовка `anthropic-beta` для включения в запросы API. Claude Code уже отправляет необходимые ему заголовки beta; используйте это, чтобы согласиться на [бета-версию Anthropic API](https://platform.claude.com/docs/en/api/beta-headers) перед тем, как Claude Code добавит встроенную поддержку. В отличие от [флага `--betas`](/ru/cli-reference#cli-flags), который требует аутентификации с помощью ключа API, эта переменная работает со всеми методами аутентификации, включая подписку Claude.ai |

110| `ANTHROPIC_CUSTOM_HEADERS` | Пользовательские заголовки для добавления к запросам (формат `Name: Value`, разделённые новой строкой для нескольких заголовков) |110| `ANTHROPIC_CUSTOM_HEADERS` | Пользовательские заголовки для добавления к запросам (формат `Name: Value`, разделённые новой строкой для нескольких заголовков) |

111| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID модели для добавления в качестве пользовательской записи в средство выбора `/model`. Используйте это, чтобы сделать нестандартную или специфичную для шлюза модель выбираемой без замены встроенных псевдонимов. См. [Конфигурация модели](/ru/model-config#add-a-custom-model-option) |111| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID модели для добавления в качестве пользовательской записи в средство выбора `/model`. Используйте это, чтобы сделать нестандартную или специфичную для шлюза модель выбираемой без замены встроенных псевдонимов. См. [Конфигурация модели](/ru/model-config#add-a-custom-model-option) |


129| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |129| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |

130| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |130| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |

131| `ANTHROPIC_FOUNDRY_API_KEY` | Ключ API для аутентификации Microsoft Foundry (см. [Microsoft Foundry](/ru/microsoft-foundry)) |131| `ANTHROPIC_FOUNDRY_API_KEY` | Ключ API для аутентификации Microsoft Foundry (см. [Microsoft Foundry](/ru/microsoft-foundry)) |

132| `ANTHROPIC_FOUNDRY_BASE_URL` | Полный базовый URL для ресурса Foundry (например, `https://my-resource.services.ai.azure.com/anthropic`). Альтернатива `ANTHROPIC_FOUNDRY_RESOURCE` (см. [Microsoft Foundry](/ru/microsoft-foundry)) |132| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | {/* min-version: 2.1.203 */}Bearer токен для аутентификации Microsoft Foundry, такой как токен доступа Microsoft Entra. Claude Code отправляет его как заголовок `Authorization: Bearer`. Имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY` и над цепочкой учётных данных Azure по умолчанию. См. [Microsoft Foundry](/ru/microsoft-foundry). Требуется Claude Code v2.1.203 или более поздняя версия |

133| `ANTHROPIC_FOUNDRY_RESOURCE` | Имя ресурса Foundry (например, `my-resource`). Требуется, если `ANTHROPIC_FOUNDRY_BASE_URL` не установлен (см. [Microsoft Foundry](/ru/microsoft-foundry)) |133| `ANTHROPIC_FOUNDRY_BASE_URL` | Полный базовый URL для ресурса Microsoft Foundry (например, `https://my-resource.services.ai.azure.com/anthropic`). Альтернатива `ANTHROPIC_FOUNDRY_RESOURCE` (см. [Microsoft Foundry](/ru/microsoft-foundry)) |

134| `ANTHROPIC_FOUNDRY_RESOURCE` | Имя ресурса Microsoft Foundry (например, `my-resource`). Требуется, если `ANTHROPIC_FOUNDRY_BASE_URL` не установлен (см. [Microsoft Foundry](/ru/microsoft-foundry)) |

134| `ANTHROPIC_MODEL` | Имя параметра модели для использования (см. [Конфигурация модели](/ru/model-config#environment-variables)) |135| `ANTHROPIC_MODEL` | Имя параметра модели для использования (см. [Конфигурация модели](/ru/model-config#environment-variables)) |

135| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Имя [модели класса Haiku для фоновых задач](/ru/costs) |136| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Имя [модели класса Haiku для фоновых задач](/ru/costs) |

136| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Переопределить регион AWS для модели класса Haiku при использовании Bedrock или Bedrock Mantle. На Bedrock это вступает в силу только при установке `ANTHROPIC_DEFAULT_HAIKU_MODEL` или устаревшей переменной `ANTHROPIC_SMALL_FAST_MODEL`, так как Bedrock в противном случае использует основную модель для фоновых задач |137| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Переопределить регион AWS для модели класса Haiku при использовании Amazon Bedrock или Amazon Bedrock Mantle. На Amazon Bedrock это вступает в силу только при установке `ANTHROPIC_DEFAULT_HAIKU_MODEL` или устаревшей переменной `ANTHROPIC_SMALL_FAST_MODEL`, так как Amazon Bedrock в противном случае использует основную модель для фоновых задач |

137| `ANTHROPIC_VERTEX_BASE_URL` | Переопределить URL конечной точки Vertex AI. Используйте для пользовательских конечных точек Vertex или при маршрутизации через [шлюз LLM](/ru/llm-gateway). См. [Google Vertex AI](/ru/google-vertex-ai) |138| `ANTHROPIC_VERTEX_BASE_URL` | Переопределить URL конечной точки Google Cloud's Agent Platform. Используйте для пользовательских конечных точек Google Cloud's Agent Platform или при маршрутизации через [шлюз LLM](/ru/llm-gateway). См. [Google Cloud's Agent Platform](/ru/google-vertex-ai) |

138| `ANTHROPIC_VERTEX_PROJECT_ID` | ID проекта GCP для запросов Vertex AI. Переопределяется `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` или проектом в файле учётных данных `GOOGLE_APPLICATION_CREDENTIALS`. См. [Google Vertex AI](/ru/google-vertex-ai) |139| `ANTHROPIC_VERTEX_PROJECT_ID` | ID проекта GCP для запросов Google Cloud's Agent Platform. Переопределяется `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` или проектом в файле учётных данных `GOOGLE_APPLICATION_CREDENTIALS`. См. [Google Cloud's Agent Platform](/ru/google-vertex-ai) |

139| `ANTHROPIC_WORKSPACE_ID` | ID рабочей области для [федерации рабочей нагрузки](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите это, когда ваше правило федерации охватывает более одной рабочей области, чтобы обмен токенов знал, какую рабочую область выбрать |140| `ANTHROPIC_WORKSPACE_ID` | ID рабочей области для [федерации рабочей нагрузки](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите это, когда ваше правило федерации охватывает более одной рабочей области, чтобы обмен токенов знал, какую рабочую область выбрать |

140| `API_FORCE_IDLE_TIMEOUT` | {/* min-version: 2.1.169 */}Переопределить тайм-аут неактивности в 5 минут, который прерывает потоковый ответ модели, когда не поступают байты. Установите на `0`, чтобы отключить тайм-аут, например, когда медленный [шлюз](/ru/llm-gateway) или локальная модель делает паузу дольше 5 минут между фрагментами. Установите на `1`, чтобы сохранить тайм-аут на каждом поставщике. Если не установлено, тайм-аут неактивен на прямом Anthropic API и соединениях [Claude Platform on AWS](/ru/claude-platform-on-aws), где работает собственный сторож потока Claude Code на уровне байтов, и активен на каждом другом поставщике, включая [Vertex AI](/ru/google-vertex-ai), [Foundry](/ru/microsoft-foundry), [Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint), [Bedrock](/ru/amazon-bedrock) и соединения шлюза, поэтому зависший поток прерывается вместо зависания. Начиная с v2.1.169 |141| `API_FORCE_IDLE_TIMEOUT` | {/* min-version: 2.1.169 */}Переопределить тайм-аут неактивности в 5 минут, который прерывает потоковый ответ модели, когда не поступают байты. Установите на `0`, чтобы отключить тайм-аут, например, когда медленный [шлюз](/ru/llm-gateway) или локальная модель делает паузу дольше 5 минут между фрагментами. Установите на `1`, чтобы сохранить тайм-аут на каждом поставщике. Если не установлено, тайм-аут неактивен на прямом Anthropic API и соединениях [Claude Platform on AWS](/ru/claude-platform-on-aws), где работает собственный сторож потока Claude Code на уровне байтов, и активен на каждом другом поставщике, включая [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry), [Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint), [Amazon Bedrock](/ru/amazon-bedrock) и соединения шлюза, поэтому зависший поток прерывается вместо зависания. Начиная с v2.1.169 |

141| `API_TIMEOUT_MS` | Тайм-аут для запросов API в миллисекундах (по умолчанию: 600000, или 10 минут; максимум: 2147483647). Увеличьте это значение, когда запросы истекают на медленных сетях или при маршрутизации через прокси. Значения выше максимума переполняют базовый таймер и вызывают немедленный отказ запросов |142| `API_TIMEOUT_MS` | Тайм-аут для запросов API в миллисекундах (по умолчанию: 600000, или 10 минут; максимум: 2147483647). Увеличьте это значение, когда запросы истекают на медленных сетях или при маршрутизации через прокси. Значения выше максимума переполняют базовый таймер и вызывают немедленный отказ запросов |

142| `AWS_BEARER_TOKEN_BEDROCK` | Ключ API Bedrock для аутентификации (см. [Ключи API Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |143| `AWS_BEARER_TOKEN_BEDROCK` | Ключ API Amazon Bedrock для аутентификации (см. [Ключи API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

143| `BASH_DEFAULT_TIMEOUT_MS` | Тайм-аут по умолчанию для долгоживущих команд bash (по умолчанию: 120000, или 2 минуты) |144| `BASH_DEFAULT_TIMEOUT_MS` | Тайм-аут по умолчанию для долгоживущих команд bash (по умолчанию: 120000, или 2 минуты) |

144| `BASH_MAX_OUTPUT_LENGTH` | Максимальное количество символов в выводе bash перед сохранением полного вывода в файл и получением Claude пути плюс краткий предпросмотр. См. [Поведение инструмента Bash](/ru/tools-reference#bash-tool-behavior) |145| `BASH_MAX_OUTPUT_LENGTH` | Максимальное количество символов в выводе bash перед сохранением полного вывода в файл и получением Claude пути плюс краткий предпросмотр. См. [Поведение инструмента Bash](/ru/tools-reference#bash-tool-behavior) |

145| `BASH_MAX_TIMEOUT_MS` | Максимальный тайм-аут, который модель может установить для долгоживущих команд bash (по умолчанию: 600000, или 10 минут) |146| `BASH_MAX_TIMEOUT_MS` | Максимальный тайм-аут, который модель может установить для долгоживущих команд bash (по умолчанию: 600000, или 10 минут) |

146| `CCR_FORCE_BUNDLE` | Установите на `1`, чтобы принудительно [`claude --remote`](/ru/claude-code-on-the-web#send-local-repositories-without-github) объединить и загрузить ваш локальный репозиторий, даже когда доступ GitHub доступен |147| `CCR_FORCE_BUNDLE` | Установите на `1`, чтобы принудительно [`claude --cloud`](/ru/claude-code-on-the-web#send-local-repositories-without-github) объединить и загрузить ваш локальный репозиторий, даже когда доступ GitHub доступен |

147| `CLAUDECODE` | Установите на `1` в подпроцессах, которые порождает Claude Code (инструмент Bash и PowerShell, сессии tmux, команды [hook](/ru/hooks), команды [строки состояния](/ru/statusline), подпроцессы [MCP server](/ru/mcp) stdio). IDE extensions также устанавливают это в их встроенных терминалах. Используйте для обнаружения, когда скрипт выполняется внутри подпроцесса, порождённого Claude Code. Чтобы проверить, был ли текущий процесс порождён непосредственно вызовом инструмента или hook, а не внутри stdio MCP server, который запустил Claude Code, используйте вместо этого `CLAUDE_CODE_CHILD_SESSION` |148| `CLAUDECODE` | Установите на `1` в подпроцессах, которые порождает Claude Code (инструмент Bash и PowerShell, сессии tmux, команды [hook](/ru/hooks), команды [строки состояния](/ru/statusline), подпроцессы [MCP server](/ru/mcp) stdio). IDE extensions также устанавливают это в их встроенных терминалах. Используйте для обнаружения, когда скрипт выполняется внутри подпроцесса, порождённого Claude Code. Чтобы проверить, был ли текущий процесс порождён непосредственно вызовом инструмента или hook, а не внутри stdio MCP server, который запустил Claude Code, используйте вместо этого `CLAUDE_CODE_CHILD_SESSION` |

148| `CLAUDE_AFK_COUNTDOWN_MS` | {/* min-version: 2.1.198 */}Сколько миллисекунд перед автоматическим продолжением появляется обратный отсчёт на экране в диалоговом окне `AskUserQuestion` без ответа. По умолчанию `20000` (20 секунд). См. `CLAUDE_AFK_TIMEOUT_MS`. Требуется Claude Code v2.1.198 или более поздняя версия |149| `CLAUDE_AFK_COUNTDOWN_MS` | {/* min-version: 2.1.198 */}Сколько миллисекунд перед автоматическим продолжением появляется обратный отсчёт на экране в диалоговом окне [`AskUserQuestion`](/ru/tools-reference) без ответа. По умолчанию `20000` (20 секунд), ограничено тайм-аутом автоматического продолжения. Не имеет эффекта, если автоматическое продолжение отключено; см. параметр [`askUserQuestionTimeout`](/ru/settings#available-settings) и `CLAUDE_AFK_TIMEOUT_MS`. Требуется Claude Code v2.1.198 или более поздняя версия |

149| `CLAUDE_AFK_TIMEOUT_MS` | {/* min-version: 2.1.198 */}Сколько миллисекунд времени неактивности перед диалоговым окном [`AskUserQuestion`](/ru/tools-reference) без ответа автоматически продолжается без вас. По умолчанию `60000` (60 секунд). Чтобы сохранить вопросы открытыми, пока вас нет, установите большое значение, такое как `86400000` (24 часа). Установка `0` не отключает тайм-аут; она закрывает диалоговое окно немедленно. Требуется Claude Code v2.1.198 или более поздняя версия |150| `CLAUDE_AFK_TIMEOUT_MS` | {/* min-version: 2.1.198 */}Сколько миллисекунд времени неактивности перед диалоговым окном [`AskUserQuestion`](/ru/tools-reference) без ответа автоматически продолжается без вас. {/* min-version: 2.1.200 */}Автоматическое продолжение отключено по умолчанию; согласитесь с параметром [`askUserQuestionTimeout`](/ru/settings#available-settings). Эта переменная переопределение для демонстраций и автоматизированных тестов: при установке она имеет приоритет над этим параметром и включает автоматическое продолжение, даже когда параметр не установлен или имеет значение `never`. Установка `0` не отключает тайм-аут; она закрывает диалоговое окно немедленно. В v2.1.198 и v2.1.199 автоматическое продолжение было включено по умолчанию с тайм-аутом `60000` (60 секунд). Требуется Claude Code v2.1.198 или более поздняя версия |

150| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Установите на `1`, чтобы отключить все встроенные типы [subagent](/ru/sub-agents), такие как Explore и Plan. Применяется только в неинтерактивном режиме (флаг `-p`). Полезно для пользователей SDK, которые хотят чистый лист |151| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Установите на `1`, чтобы отключить все встроенные типы [subagent](/ru/sub-agents), такие как Explore и Plan. Применяется только в неинтерактивном режиме (флаг `-p`). Полезно для пользователей SDK, которые хотят чистый лист |

151| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Установите на `1`, чтобы пропустить префикс `mcp__<server>__` на именах инструментов из MCP серверов, созданных SDK. Инструменты используют свои исходные имена. Только для использования SDK |152| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Установите на `1`, чтобы пропустить префикс `mcp__<server>__` на именах инструментов из MCP серверов, созданных SDK. Инструменты используют свои исходные имена. Только для использования SDK |

152| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Тайм-аут зависания в миллисекундах для фоновых subagents. По умолчанию `600000` (10 минут). Таймер сбрасывается при каждом событии потоковой передачи прогресса; если прогресс не поступает в течение окна, subagent прерывается и задача отмечается как неудачная, выводя любой частичный результат родителю |153| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Тайм-аут зависания в миллисекундах для фоновых subagents. По умолчанию `600000` (10 минут). Таймер сбрасывается при каждом событии потоковой передачи прогресса; если прогресс не поступает в течение окна, subagent прерывается и задача отмечается как неудачная, выводя любой частичный результат родителю |


184| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Установите на `1`, чтобы отключить всю функциональность фоновых задач, включая параметр `run_in_background` на инструментах Bash и subagent, автоматическое фоновое выполнение и сочетание клавиш Ctrl+B |185| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Установите на `1`, чтобы отключить всю функциональность фоновых задач, включая параметр `run_in_background` на инструментах Bash и subagent, автоматическое фоновое выполнение и сочетание клавиш Ctrl+B |

185| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}Установите на `1`, чтобы остановить выполняющиеся фоновые команды оболочки, динамические workflows {/* min-version: 2.1.198 */}и, начиная с v2.1.198, фоновые subagents [фоновой сессии](/ru/agent-view) при остановке, перезагрузке или обновлении процесса этой сессии [супервизором](/ru/agent-view#the-supervisor-process), вместо передачи их следующему процессу сессии. Влияет только на эту передачу: фоновое выполнение сессии с помощью `←` или [`/background`](/ru/agent-view#from-inside-a-session) по-прежнему переносит выполняющуюся работу, и `CLAUDE_DISABLE_ADOPT` отключает оба. Требуется Claude Code v2.1.196 или более поздняя версия |186| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}Установите на `1`, чтобы остановить выполняющиеся фоновые команды оболочки, динамические workflows {/* min-version: 2.1.198 */}и, начиная с v2.1.198, фоновые subagents [фоновой сессии](/ru/agent-view) при остановке, перезагрузке или обновлении процесса этой сессии [супервизором](/ru/agent-view#the-supervisor-process), вместо передачи их следующему процессу сессии. Влияет только на эту передачу: фоновое выполнение сессии с помощью `←` или [`/background`](/ru/agent-view#from-inside-a-session) по-прежнему переносит выполняющуюся работу, и `CLAUDE_DISABLE_ADOPT` отключает оба. Требуется Claude Code v2.1.196 или более поздняя версия |

186| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}Установите на `1`, чтобы остановить Claude Code от завершения [фоновых команд оболочки](/ru/interactive-mode#background-bash-commands) при сообщении операционной системой о нехватке памяти. По умолчанию на macOS и Linux Claude Code завершает фоновую оболочку, запущенную в основной сессии, при сигнале нехватки памяти, как только сессия была неактивна в течение 30 минут и ни один ход или subagent не выполняется. Windows не имеет сигнала нехватки памяти, поэтому эта переменная не влияет там. Требуется Claude Code v2.1.193 или более поздняя версия |187| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}Установите на `1`, чтобы остановить Claude Code от завершения [фоновых команд оболочки](/ru/interactive-mode#background-bash-commands) при сообщении операционной системой о нехватке памяти. По умолчанию на macOS и Linux Claude Code завершает фоновую оболочку, запущенную в основной сессии, при сигнале нехватки памяти, как только сессия была неактивна в течение 30 минут и ни один ход или subagent не выполняется. Windows не имеет сигнала нехватки памяти, поэтому эта переменная не влияет там. Требуется Claude Code v2.1.193 или более поздняя версия |

187| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Установите на `1`, чтобы отключить [skills](/ru/skills) и workflows, которые поставляются с Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные slash commands, такие как `/init`, остаются доступными для ввода, но скрыты от модели. Skills из plugins, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалент параметра [`disableBundledSkills`](/ru/settings#available-settings); `0` не переопределяет его |188| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Установите на `1`, чтобы отключить [skills](/ru/skills) и workflows, которые поставляются с Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные slash commands, такие как `/init`, остаются доступными для ввода, но скрыты от модели. `/doctor` остаётся доступной для ввода, как встроенные команды; скройте её с помощью `DISABLE_DOCTOR_COMMAND` вместо этого. Skills из plugins, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалент параметра [`disableBundledSkills`](/ru/settings#available-settings); `0` не переопределяет его |

188| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Установите на `1`, чтобы предотвратить загрузку любых файлов памяти CLAUDE.md в контекст, включая файлы пользователя, проекта и автоматической памяти |189| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Установите на `1`, чтобы предотвратить загрузку любых файлов памяти CLAUDE.md в контекст, включая файлы пользователя, проекта и автоматической памяти |

189| `CLAUDE_CODE_DISABLE_CRON` | Установите на `1`, чтобы отключить [запланированные задачи](/ru/scheduled-tasks). Skill `/loop` и инструменты cron становятся недоступными и все уже запланированные задачи перестают срабатывать, включая задачи, которые уже выполняются в середине сессии |190| `CLAUDE_CODE_DISABLE_CRON` | Установите на `1`, чтобы отключить [запланированные задачи](/ru/scheduled-tasks). Skill `/loop` и инструменты cron становятся недоступными и все уже запланированные задачи перестают срабатывать, включая задачи, которые уже выполняются в середине сессии |

190| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Установите на `1`, чтобы удалить заголовки запроса `anthropic-beta` для Anthropic и поля схемы инструментов beta (такие как `defer_loading` и `eager_input_streaming`) из запросов API. Используйте это, когда шлюз прокси отклоняет запросы с ошибками типа "Unexpected value(s) for the `anthropic-beta` header" или "Extra inputs are not permitted". Стандартные поля (`name`, `description`, `input_schema`, `cache_control`) сохраняются |191| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Установите на `1`, чтобы удалить заголовки запроса `anthropic-beta` для Anthropic и поля схемы инструментов beta (такие как `defer_loading` и `eager_input_streaming`) из запросов API. Используйте это, когда шлюз прокси отклоняет запросы с ошибками типа "Unexpected value(s) for the `anthropic-beta` header" или "Extra inputs are not permitted". Стандартные поля (`name`, `description`, `input_schema`, `cache_control`) сохраняются |


193| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Установите на `1`, чтобы отключить опросы качества сессии "How is Claude doing?". Опросы также отключаются, когда установлена переменная `DISABLE_TELEMETRY`, `DO_NOT_TRACK` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, если только `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` не согласится вернуться. Чтобы установить частоту выборки вместо полного отключения, используйте параметр [`feedbackSurveyRate`](/ru/settings#available-settings). См. [Опросы качества сессии](/ru/data-usage#session-quality-surveys) |194| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Установите на `1`, чтобы отключить опросы качества сессии "How is Claude doing?". Опросы также отключаются, когда установлена переменная `DISABLE_TELEMETRY`, `DO_NOT_TRACK` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, если только `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` не согласится вернуться. Чтобы установить частоту выборки вместо полного отключения, используйте параметр [`feedbackSurveyRate`](/ru/settings#available-settings). См. [Опросы качества сессии](/ru/data-usage#session-quality-surveys) |

194| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Установите на `1`, чтобы отключить [checkpointing](/ru/checkpointing) файлов. Команда `/rewind` не сможет восстановить изменения кода |195| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Установите на `1`, чтобы отключить [checkpointing](/ru/checkpointing) файлов. Команда `/rewind` не сможет восстановить изменения кода |

195| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Установите на `1`, чтобы удалить встроенные инструкции рабочего процесса коммита и PR и снимок статуса git из системного приглашения Claude. Полезно при использовании собственных skills рабочего процесса git. Имеет приоритет над параметром [`includeGitInstructions`](/ru/settings#available-settings) при установке |196| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Установите на `1`, чтобы удалить встроенные инструкции рабочего процесса коммита и PR и снимок статуса git из системного приглашения Claude. Полезно при использовании собственных skills рабочего процесса git. Имеет приоритет над параметром [`includeGitInstructions`](/ru/settings#available-settings) при установке |

196| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Установите на `1`, чтобы предотвратить автоматическое переназначение Opus 4.0 и 4.1 на текущую версию Opus в Anthropic API. Используйте, когда вы намеренно хотите закрепить старую модель. Переназначение не выполняется на Bedrock, Vertex или Foundry |197| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Установите на `1`, чтобы предотвратить автоматическое переназначение Opus 4.0 и 4.1 на текущую версию Opus в Anthropic API. Используйте, когда вы намеренно хотите закрепить старую модель. Переназначение не выполняется на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry |

197| `CLAUDE_CODE_DISABLE_MOUSE` | Установите на `1`, чтобы отключить отслеживание мыши в [полноэкранном режиме](/ru/fullscreen). Прокрутка с клавиатуры с помощью `PgUp` и `PgDn` по-прежнему работает. Используйте это, чтобы сохранить поведение выделения при нажатии мыши вашего терминала |198| `CLAUDE_CODE_DISABLE_MOUSE` | Установите на `1`, чтобы отключить отслеживание мыши в [полноэкранном режиме](/ru/fullscreen). Прокрутка с клавиатуры с помощью `PgUp` и `PgDn` по-прежнему работает. Используйте это, чтобы сохранить поведение выделения при нажатии мыши вашего терминала |

198| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | {/* min-version: 2.1.195 */}Установите на `1`, чтобы отключить обработку щелчков, перетаскивания и наведения в [полноэкранном режиме](/ru/fullscreen), сохраняя прокрутку колеса мыши. Используйте это, когда вы хотите, чтобы прокрутка колеса работала внутри Claude Code, но не хотите, чтобы щелчки позиционировали курсор, расширяли вывод инструмента или открывали ссылки. `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет, когда оба установлены. Требуется Claude Code v2.1.195 или более поздняя версия |199| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | {/* min-version: 2.1.195 */}Установите на `1`, чтобы отключить обработку щелчков, перетаскивания и наведения в [полноэкранном режиме](/ru/fullscreen), сохраняя прокрутку колеса мыши. Используйте это, когда вы хотите, чтобы прокрутка колеса работала внутри Claude Code, но не хотите, чтобы щелчки позиционировали курсор, расширяли вывод инструмента или открывали ссылки. `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет, когда оба установлены. Требуется Claude Code v2.1.195 или более поздняя версия |

199| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Эквивалент установки `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` и `DISABLE_TELEMETRY` |200| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Эквивалент установки `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` и `DISABLE_TELEMETRY` |


206| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Установите на `1`, чтобы отключить виртуальную прокрутку в [полноэкранном режиме](/ru/fullscreen) и отрендерить каждое сообщение в транскрипте. Используйте это, если прокрутка в полноэкранном режиме показывает пустые области, где должны появляться сообщения |207| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Установите на `1`, чтобы отключить виртуальную прокрутку в [полноэкранном режиме](/ru/fullscreen) и отрендерить каждое сообщение в транскрипте. Используйте это, если прокрутка в полноэкранном режиме показывает пустые области, где должны появляться сообщения |

207| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Установите на `1`, чтобы отключить [workflows](/ru/workflows#turn-workflows-off). Эквивалент параметра [`disableWorkflows`](/ru/settings#available-settings) |208| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Установите на `1`, чтобы отключить [workflows](/ru/workflows#turn-workflows-off). Эквивалент параметра [`disableWorkflows`](/ru/settings#available-settings) |

208| `CLAUDE_CODE_EFFORT_LEVEL` | Установите уровень усилий для поддерживаемых моделей. Значения: `low`, `medium`, `high`, `xhigh`, `max` или `auto` для использования значения по умолчанию модели. Доступные уровни зависят от модели. Имеет приоритет над `/effort` и параметром `effortLevel`. См. [Отрегулировать уровень усилий](/ru/model-config#adjust-effort-level) |209| `CLAUDE_CODE_EFFORT_LEVEL` | Установите уровень усилий для поддерживаемых моделей. Значения: `low`, `medium`, `high`, `xhigh`, `max` или `auto` для использования значения по умолчанию модели. Доступные уровни зависят от модели. Имеет приоритет над `/effort` и параметром `effortLevel`. См. [Отрегулировать уровень усилий](/ru/model-config#adjust-effort-level) |

209| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {/* min-version: 2.1.158 */}Установите на `1`, чтобы сделать [автоматический режим](/ru/permission-modes#eliminate-prompts-with-auto-mode) доступным на Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry и вошедших в систему сессиях [Claude apps gateway](/ru/claude-apps-gateway). Требуется Claude Code v2.1.158 или более поздняя версия. Не влияет на Anthropic API, где автоматический режим доступен по умолчанию. См. [Включить автоматический режим на Bedrock, Vertex AI или Foundry](/ru/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry) |210| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | {/* min-version: 2.1.205 */}Установите на `1`, чтобы включить добавление дополнительного текста в конец системного приглашения каждого [subagent](/ru/sub-agents). Флаг [`--append-subagent-system-prompt`](/ru/cli-reference#cli-flags) предоставляет добавленный текст и устанавливает эту переменную автоматически, поэтому вам не нужно устанавливать её самостоятельно. Требуется Claude Code v2.1.205 или более поздняя версия |

211| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {/* min-version: 2.1.158 */}Установите на `1`, чтобы сделать [автоматический режим](/ru/permission-modes#eliminate-prompts-with-auto-mode) доступным на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и вошедших в систему сессиях [Claude apps gateway](/ru/claude-apps-gateway). Требуется Claude Code v2.1.158 или более поздняя версия. Не влияет на Anthropic API, где автоматический режим доступен по умолчанию. См. [Включить автоматический режим на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](/ru/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) |

210| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Переопределить доступность [сводки сессии](/ru/interactive-mode#session-recap). Установите на `0`, чтобы принудительно отключить сводки независимо от переключателя `/config`. Установите на `1`, чтобы принудительно включить сводки, когда [`awaySummaryEnabled`](/ru/settings#available-settings) имеет значение `false`. Имеет приоритет над параметром и переключателем `/config` |212| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Переопределить доступность [сводки сессии](/ru/interactive-mode#session-recap). Установите на `0`, чтобы принудительно отключить сводки независимо от переключателя `/config`. Установите на `1`, чтобы принудительно включить сводки, когда [`awaySummaryEnabled`](/ru/settings#available-settings) имеет значение `false`. Имеет приоритет над параметром и переключателем `/config` |

211| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Установите на `1`, чтобы обновлять состояние plugin на границах хода в [неинтерактивном режиме](/ru/headless) после завершения фоновой установки. Отключено по умолчанию, потому что обновление изменяет системное приглашение в середине сессии, что делает недействительным [кэширование приглашений](/ru/prompt-caching) для этого хода |213| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Установите на `1`, чтобы обновлять состояние plugin на границах хода в [неинтерактивном режиме](/ru/headless) после завершения фоновой установки. Отключено по умолчанию, потому что обновление изменяет системное приглашение в середине сессии, что делает недействительным [кэширование приглашений](/ru/prompt-caching) для этого хода |

212| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Установите на `1`, чтобы направить опрос качества сессии "How is Claude doing?" на ваш собственный [сборщик OpenTelemetry](/ru/monitoring-usage), когда трафик, не связанный с Anthropic, заблокирован. Оценки опроса выдаются только как события OTEL вашему настроенному сборщику. Никакие данные опроса не отправляются в Anthropic в этом режиме. Применяется, когда установлена переменная `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` или `DO_NOT_TRACK`, и не имеет эффекта в противном случае. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` и политика обратной связи организации имеют приоритет |214| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Установите на `1`, чтобы направить опрос качества сессии "How is Claude doing?" на ваш собственный [сборщик OpenTelemetry](/ru/monitoring-usage), когда трафик, не связанный с Anthropic, заблокирован. Оценки опроса выдаются только как события OTEL вашему настроенному сборщику. Никакие данные опроса не отправляются в Anthropic в этом режиме. Применяется, когда установлена переменная `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` или `DO_NOT_TRACK`, и не имеет эффекта в противном случае. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` и политика обратной связи организации имеют приоритет |

213| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Управляет потоковой передачей входных данных инструмента с тонкой зернистостью из API по мере их создания Claude. С этим отключением большой входной параметр инструмента, такой как длинная запись файла, поступает только после завершения создания Claude, что может выглядеть как зависание. Включено по умолчанию на Anthropic API. На Bedrock и Vertex включено для каждой модели, где развёрнутый контейнер это поддерживает. Установите на `0`, чтобы отказаться. Установите на `1`, чтобы принудительно включить при маршрутизации через прокси через `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_BEDROCK_BASE_URL`. Отключено по умолчанию на Foundry и соединениях [шлюза](/ru/llm-gateway) |215| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Управляет потоковой передачей входных данных инструмента с тонкой зернистостью из API по мере их создания Claude. С этим отключением большой входной параметр инструмента, такой как длинная запись файла, поступает только после завершения создания Claude, что может выглядеть как зависание. Включено по умолчанию на Anthropic API. На Amazon Bedrock и Google Cloud's Agent Platform включено для каждой модели, где развёрнутый контейнер это поддерживает. Установите на `0`, чтобы отказаться. Установите на `1`, чтобы принудительно включить при маршрутизации через прокси через `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_BEDROCK_BASE_URL`. Отключено по умолчанию на Microsoft Foundry и соединениях [шлюза](/ru/llm-gateway) |

214| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Установите на `1`, чтобы заполнить средство выбора `/model` из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз, такой как LiteLLM, Kong или внутренний прокси. Отключено по умолчанию, потому что шлюзы, поддерживаемые общим ключом API, в противном случае показывали бы каждому пользователю каждую модель, к которой может получить доступ ключ. Обнаруженные модели по-прежнему фильтруются по списку разрешений [`availableModels`](/ru/settings#available-settings), который сессия получает; доставляйте список через [MDM или управляемый файл параметров](/ru/settings#settings-files), так как [доставка, управляемая сервером, недоступна на конфигурациях шлюза](/ru/server-managed-settings#platform-availability) |216| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Установите на `1`, чтобы заполнить средство выбора `/model` из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз, такой как LiteLLM, Kong или внутренний прокси. Отключено по умолчанию, потому что шлюзы, поддерживаемые общим ключом API, в противном случае показывали бы каждому пользователю каждую модель, к которой может получить доступ ключ. Обнаруженные модели по-прежнему фильтруются по списку разрешений [`availableModels`](/ru/settings#available-settings), который сессия получает; доставляйте список через [MDM или управляемый файл параметров](/ru/settings#settings-files), так как [доставка, управляемая сервером, недоступна на конфигурациях шлюза](/ru/server-managed-settings#platform-availability) |

215| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Удалено в v2.1.142, когда [быстрый режим](/ru/fast-mode) по умолчанию переместился с Opus 4.6 на Opus 4.7 |217| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Удалено в v2.1.142, когда [быстрый режим](/ru/fast-mode) по умолчанию переместился с Opus 4.6 на Opus 4.7 |

216| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Установите на `false`, чтобы отключить предложения приглашений (переключатель "Prompt suggestions" в `/config`). Это затемнённые предсказания, которые появляются в вашем вводе приглашения после ответа Claude. См. [Предложения приглашений](/ru/interactive-mode#prompt-suggestions) |218| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Установите на `false`, чтобы отключить предложения приглашений (переключатель "Prompt suggestions" в `/config`). Это затемнённые предсказания, которые появляются в вашем вводе приглашения после ответа Claude. См. [Предложения приглашений](/ru/interactive-mode#prompt-suggestions) |


238| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Максимальное количество инструментов только для чтения и subagents, которые могут выполняться параллельно (по умолчанию: 10). Более высокие значения увеличивают параллелизм, но потребляют больше ресурсов |240| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Максимальное количество инструментов только для чтения и subagents, которые могут выполняться параллельно (по умолчанию: 10). Более высокие значения увеличивают параллелизм, но потребляют больше ресурсов |

239| `CLAUDE_CODE_MAX_TURNS` | Ограничить количество агентских ходов, когда явный лимит не передан. Эквивалент передачи [`--max-turns`](/ru/cli-reference#cli-flags), который имеет приоритет, когда оба установлены. Значение, которое не является положительным целым числом, отклоняется при запуске с ошибкой, а не рассматривается как отсутствие лимита |241| `CLAUDE_CODE_MAX_TURNS` | Ограничить количество агентских ходов, когда явный лимит не передан. Эквивалент передачи [`--max-turns`](/ru/cli-reference#cli-flags), который имеет приоритет, когда оба установлены. Значение, которое не является положительным целым числом, отклоняется при запуске с ошибкой, а не рассматривается как отсутствие лимита |

240| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Установите на `1`, чтобы порождать stdio MCP servers с только безопасной базовой средой плюс настроенная `env` сервера, вместо наследования вашей среды оболочки |242| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Установите на `1`, чтобы порождать stdio MCP servers с только безопасной базовой средой плюс настроенная `env` сервера, вместо наследования вашей среды оболочки |

241| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}Тайм-аут неактивности в миллисекундах для удалённых вызовов инструментов MCP (по умолчанию: 300000, или 5 минут). Когда HTTP, SSE, WebSocket или [claude.ai connector](/ru/mcp#use-mcp-servers-from-claude-ai) MCP server не отправляет ответ и не отправляет уведомление о прогрессе в течение этого времени, вызов инструмента прерывается с ошибкой вместо ожидания стены часов `MCP_TOOL_TIMEOUT`. Установите на `0`, чтобы отключить проверку неактивности. Значения ниже 1000 повышаются до одной секунды, и значение ограничено эффективным `MCP_TOOL_TIMEOUT`. Не применяется к stdio или IDE servers. Требуется Claude Code v2.1.187 или более поздняя версия |243| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}Тайм-аут неактивности в миллисекундах для удалённых вызовов инструментов MCP. Когда HTTP, SSE, WebSocket или [claude.ai connector](/ru/mcp#use-mcp-servers-from-claude-ai) MCP server не отправляет ответ и не отправляет уведомление о прогрессе в течение этого времени, вызов инструмента прерывается с ошибкой вместо ожидания стены часов `MCP_TOOL_TIMEOUT`. Переопределяет значения по умолчанию для каждого транспорта в 300000 (5 минут) для сетевых серверов и 1800000 (30 минут) для stdio серверов. Установите на `0`, чтобы отключить проверку неактивности. Значения ниже 1000 повышаются до одной секунды, и значение ограничено эффективным `MCP_TOOL_TIMEOUT`. Поле `timeout` для каждого сервера в `.mcp.json` не менее 1000 повышает окно неактивности этого сервера по крайней мере до значения `timeout`; это требует Claude Code v2.1.203 или более поздней версии. Не применяется к IDE servers или SDK in-process servers. Требуется Claude Code v2.1.187 или более поздняя версия. {/* min-version: 2.1.203 */}До v2.1.203 stdio серверы были освобождены от тайм-аута неактивности |

242| `CLAUDE_CODE_NATIVE_CURSOR` | Установите на `1`, чтобы показать собственный курсор терминала в позиции ввода вместо нарисованного блока. Курсор соблюдает параметры мигания, формы и фокуса терминала |244| `CLAUDE_CODE_NATIVE_CURSOR` | Установите на `1`, чтобы показать собственный курсор терминала в позиции ввода вместо нарисованного блока. Курсор соблюдает параметры мигания, формы и фокуса терминала |

243| `CLAUDE_CODE_NEW_INIT` | Установите на `1`, чтобы `/init` запустил интерактивный поток настройки. Поток спрашивает, какие файлы генерировать, включая CLAUDE.md, skills и hooks, перед исследованием кодовой базы и их написанием. Без этой переменной `/init` автоматически генерирует CLAUDE.md без запроса |245| `CLAUDE_CODE_NEW_INIT` | Установите на `1`, чтобы `/init` запустил интерактивный поток настройки. Поток спрашивает, какие файлы генерировать, включая CLAUDE.md, skills и hooks, перед исследованием кодовой базы и их написанием. Без этой переменной `/init` автоматически генерирует CLAUDE.md без запроса |

244| `CLAUDE_CODE_NO_FLICKER` | Установите на `1`, чтобы включить [полноэкранный режим](/ru/fullscreen), исследовательский предпросмотр, который уменьшает мерцание и сохраняет память плоской в длинных разговорах. Эквивалент параметра [`tui`](/ru/settings#available-settings); вы также можете переключаться с помощью `/tui fullscreen` |246| `CLAUDE_CODE_NO_FLICKER` | Установите на `1`, чтобы включить [полноэкранный режим](/ru/fullscreen), исследовательский предпросмотр, который уменьшает мерцание и сохраняет память плоской в длинных разговорах. Эквивалент параметра [`tui`](/ru/settings#available-settings); вы также можете переключаться с помощью `/tui fullscreen` |


260| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Установите на `1`, чтобы остановить Claude Code от передачи `-ExecutionPolicy Bypass` при порождении PowerShell для вызовов инструментов, hooks и команд строки состояния, и вместо этого соблюдать эффективную политику выполнения машины. По умолчанию Claude Code обходит политику выполнения в области процесса, поэтому скрипты `.ps1` и импорты модулей работают на установках Windows с ограничением по умолчанию. Обход области процесса никогда не переопределяет Group Policy `MachinePolicy` или `UserPolicy` независимо от этого параметра |262| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Установите на `1`, чтобы остановить Claude Code от передачи `-ExecutionPolicy Bypass` при порождении PowerShell для вызовов инструментов, hooks и команд строки состояния, и вместо этого соблюдать эффективную политику выполнения машины. По умолчанию Claude Code обходит политику выполнения в области процесса, поэтому скрипты `.ps1` и импорты модулей работают на установках Windows с ограничением по умолчанию. Обход области процесса никогда не переопределяет Group Policy `MachinePolicy` или `UserPolicy` независимо от этого параметра |

261| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}Максимальное время в миллисекундах, которое [неинтерактивный режим](/ru/headless#background-tasks-at-exit) с флагом `-p` ждёт после финального хода для фоновых subagents и workflows, результат которых является частью вывода. По умолчанию: `600000`, или 10 минут. Когда лимит превышен, оставшиеся фоновые задачи завершаются и процесс выходит. Установите на `0`, чтобы ждать бесконечно. Этот лимит отделён от пятисекундного периода благодати, который применяется к простым фоновым оболочкам |263| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}Максимальное время в миллисекундах, которое [неинтерактивный режим](/ru/headless#background-tasks-at-exit) с флагом `-p` ждёт после финального хода для фоновых subagents и workflows, результат которых является частью вывода. По умолчанию: `600000`, или 10 минут. Когда лимит превышен, оставшиеся фоновые задачи завершаются и процесс выходит. Установите на `0`, чтобы ждать бесконечно. Этот лимит отделён от пятисекундного периода благодати, который применяется к простым фоновым оболочкам |

262| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}Установите на `1`, чтобы распространять контекст трассировки W3C, когда `ANTHROPIC_BASE_URL` указывает на пользовательский прокси. Распространение охватывает заголовок `traceparent` на запросах модели и HTTP MCP и переменную окружения `TRACEPARENT` для подпроцессов Bash, PowerShell и hook. По умолчанию распространение включено только при прямом подключении к Anthropic API. Добавлено в v2.1.152. См. [Трассировки (beta)](/ru/monitoring-usage#traces-beta) |264| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}Установите на `1`, чтобы распространять контекст трассировки W3C, когда `ANTHROPIC_BASE_URL` указывает на пользовательский прокси. Распространение охватывает заголовок `traceparent` на запросах модели и HTTP MCP и переменную окружения `TRACEPARENT` для подпроцессов Bash, PowerShell и hook. По умолчанию распространение включено только при прямом подключении к Anthropic API. Добавлено в v2.1.152. См. [Трассировки (beta)](/ru/monitoring-usage#traces-beta) |

263| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Установлено хост-платформами, которые встраивают Claude Code и управляют маршрутизацией поставщика модели от его имени. При установке переменные выбора поставщика, конечной точки и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY` в файлах параметров, игнорируются, поэтому параметры пользователя не могут переопределить маршрутизацию хоста. Автоматический отказ от телеметрии для Bedrock, Vertex и Foundry также пропускается, поэтому телеметрия следует стандартному отказу `DISABLE_TELEMETRY`. См. [Поведение по умолчанию по поставщику API](/ru/data-usage#default-behaviors-by-api-provider) |265| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Установлено хост-платформами, которые встраивают Claude Code и управляют маршрутизацией поставщика модели от его имени. При установке переменные выбора поставщика, конечной точки и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY` в файлах параметров, игнорируются, поэтому параметры пользователя не могут переопределить маршрутизацию хоста. Автоматический отказ от телеметрии для Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry также пропускается, поэтому телеметрия следует стандартному отказу `DISABLE_TELEMETRY`. См. [Поведение по умолчанию по поставщику API](/ru/data-usage#default-behaviors-by-api-provider) |

264| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Установите на `1`, чтобы позволить прокси выполнять разрешение DNS вместо вызывающей стороны. Согласитесь для сред, где прокси должен обрабатывать разрешение имён хостов |266| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Установите на `1`, чтобы позволить прокси выполнять разрешение DNS вместо вызывающей стороны. Согласитесь для сред, где прокси должен обрабатывать разрешение имён хостов |

265| `CLAUDE_CODE_REMOTE` | Установите автоматически на `true`, когда Claude Code работает как [облачная сессия](/ru/claude-code-on-the-web). Прочитайте это из hook или скрипта настройки, чтобы обнаружить, находитесь ли вы в облачной среде |267| `CLAUDE_CODE_REMOTE` | Установите автоматически на `true`, когда Claude Code работает как [облачная сессия](/ru/claude-code-on-the-web). Прочитайте это из hook или скрипта настройки, чтобы обнаружить, находитесь ли вы в облачной среде |

266| `CLAUDE_CODE_REMOTE_SESSION_ID` | Установите автоматически в [облачных сессиях](/ru/claude-code-on-the-web) на ID текущей сессии. Прочитайте это, чтобы построить ссылку обратно на транскрипт сессии. См. [Ссылка вывода обратно на сессию](/ru/claude-code-on-the-web#link-output-back-to-the-session) |268| `CLAUDE_CODE_REMOTE_SESSION_ID` | Установите автоматически в [облачных сессиях](/ru/claude-code-on-the-web) на ID текущей сессии. Прочитайте это, чтобы построить ссылку обратно на транскрипт сессии. См. [Ссылка вывода обратно на сессию](/ru/claude-code-on-the-web#link-output-back-to-the-session) |


277| `CLAUDE_CODE_SIMPLE` | Установите на `1`, чтобы запустить с минимальным системным приглашением и только инструментами Bash, чтения файлов и редактирования файлов. MCP tools из `--mcp-config` по-прежнему доступны. Отключает автоматическое обнаружение hooks, skills, plugins, MCP servers, автоматическую память и CLAUDE.md. OAuth токены и учётные данные цепочки ключей не читаются, поэтому аутентификация Anthropic должна поступать из `ANTHROPIC_API_KEY` или `apiKeyHelper` в `--settings`. Эквивалент передачи [`--bare`](/ru/headless#start-faster-with-bare-mode) |279| `CLAUDE_CODE_SIMPLE` | Установите на `1`, чтобы запустить с минимальным системным приглашением и только инструментами Bash, чтения файлов и редактирования файлов. MCP tools из `--mcp-config` по-прежнему доступны. Отключает автоматическое обнаружение hooks, skills, plugins, MCP servers, автоматическую память и CLAUDE.md. OAuth токены и учётные данные цепочки ключей не читаются, поэтому аутентификация Anthropic должна поступать из `ANTHROPIC_API_KEY` или `apiKeyHelper` в `--settings`. Эквивалент передачи [`--bare`](/ru/headless#start-faster-with-bare-mode) |

278| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Установите на `1`, чтобы использовать минимальное системное приглашение и свёрнутые описания инструментов на любой модели. Установите на `0`, `false`, `no` или `off`, чтобы отказаться даже на моделях, где эксперимент или конфигурация сервера в противном случае включили бы это. Полный набор инструментов, hooks, MCP servers и обнаружение CLAUDE.md остаются включены |280| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Установите на `1`, чтобы использовать минимальное системное приглашение и свёрнутые описания инструментов на любой модели. Установите на `0`, `false`, `no` или `off`, чтобы отказаться даже на моделях, где эксперимент или конфигурация сервера в противном случае включили бы это. Полный набор инструментов, hooks, MCP servers и обнаружение CLAUDE.md остаются включены |

279| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Пропустить аутентификацию на стороне клиента для [Claude Platform on AWS](/ru/claude-platform-on-aws), для шлюзов, которые подписывают запросы сами |281| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Пропустить аутентификацию на стороне клиента для [Claude Platform on AWS](/ru/claude-platform-on-aws), для шлюзов, которые подписывают запросы сами |

280| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Пропустить аутентификацию AWS для Bedrock (например, при использовании шлюза LLM) |282| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock (например, при использовании шлюза LLM) |

281| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Пропустить аутентификацию Azure для Microsoft Foundry. Для шлюза установите учётные данные в `ANTHROPIC_FOUNDRY_API_KEY` вместо этого; без ключа API эта переменная оставляет клиент Foundry неспособным отправлять запросы |283| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Пропустить аутентификацию Azure для Microsoft Foundry, для прокси или шлюза, который внедряет свой собственный заголовок `Authorization`. Claude Code отправляет запросы без учётных данных Azure и сохраняет заголовок `Authorization`, который вы предоставляете, например через `ANTHROPIC_CUSTOM_HEADERS`. Игнорируется, когда установлен `ANTHROPIC_FOUNDRY_API_KEY` или `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. {/* min-version: 2.1.203 */}До v2.1.203 эта переменная оставляла клиент Microsoft Foundry неспособным отправлять запросы, если ключ API также не был установлен |

282| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Пропустить аутентификацию AWS для Bedrock Mantle (например, при использовании шлюза LLM) |284| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock Mantle (например, при использовании шлюза LLM) |

283| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Установите на `1`, чтобы пропустить запись истории приглашений и транскриптов сессий на диск. Сессии, запущенные с этой переменной, не появляются в `--resume`, `--continue` или истории стрелок вверх. Полезно для эфемерных скриптовых сессий |285| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Установите на `1`, чтобы пропустить запись истории приглашений и транскриптов сессий на диск. Сессии, запущенные с этой переменной, не появляются в `--resume`, `--continue` или истории стрелок вверх. Полезно для эфемерных скриптовых сессий |

284| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Пропустить аутентификацию Google для Vertex (например, при использовании шлюза LLM) |286| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Пропустить аутентификацию Google для Google Cloud's Agent Platform (например, при использовании шлюза LLM) |

285| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Максимальное количество последовательных раз, когда [Stop](/ru/hooks#stop) или [SubagentStop](/ru/hooks#subagentstop) hook может заблокировать завершение хода перед тем, как Claude Code переопределит его и завершит ход в любом случае (по умолчанию: 8). Установите на `0`, чтобы отключить лимит. Повысьте это, если ваш hook законно нуждается в большем количестве итераций для разрешения |287| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Максимальное количество последовательных раз, когда [Stop](/ru/hooks#stop) или [SubagentStop](/ru/hooks#subagentstop) hook может заблокировать завершение хода перед тем, как Claude Code переопределит его и завершит ход в любом случае (по умолчанию: 8). Установите на `0`, чтобы отключить лимит. Повысьте это, если ваш hook законно нуждается в большем количестве итераций для разрешения |

286| `CLAUDE_CODE_SUBAGENT_MODEL` | См. [Конфигурация модели](/ru/model-config). {/* min-version: 2.1.196 */}Начиная с v2.1.196, установка на `inherit` — это то же самое, что оставить её неустановленной; более ранние версии рассматривали `inherit` как переопределение, которое принудительно переводило каждого subagent на модель основного разговора |288| `CLAUDE_CODE_SUBAGENT_MODEL` | См. [Конфигурация модели](/ru/model-config). {/* min-version: 2.1.196 */}Начиная с v2.1.196, установка на `inherit` — это то же самое, что оставить её неустановленной; более ранние версии рассматривали `inherit` как переопределение, которое принудительно переводило каждого subagent на модель основного разговора |

287| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Установите на `1`, чтобы удалить учётные данные Anthropic и поставщика облачных услуг из сред подпроцессов (инструмент Bash, hooks, MCP stdio servers). Родительский процесс Claude сохраняет эти учётные данные для вызовов API, но дочерние процессы не могут их читать, снижая воздействие атак внедрения приглашений, которые пытаются экспортировать секреты через расширение оболочки. На Linux это также запускает подпроцессы Bash в изолированном пространстве имён PID, поэтому они не могут читать сред хост-процессов через `/proc`; как побочный эффект, `ps`, `pgrep` и `kill` не могут видеть или сигнализировать хост-процессам. `claude-code-action` устанавливает это автоматически, когда настроен `allowed_non_write_users` |289| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Установите на `1`, чтобы удалить учётные данные Anthropic и поставщика облачных услуг из сред подпроцессов (инструмент Bash, hooks, MCP stdio servers). Родительский процесс Claude сохраняет эти учётные данные для вызовов API, но дочерние процессы не могут их читать, снижая воздействие атак внедрения приглашений, которые пытаются экспортировать секреты через расширение оболочки. На Linux это также запускает подпроцессы Bash в изолированном пространстве имён PID, поэтому они не могут читать сред хост-процессов через `/proc`; как побочный эффект, `ps`, `pgrep` и `kill` не могут видеть или сигнализировать хост-процессам. `claude-code-action` устанавливает это автоматически, когда настроен `allowed_non_write_users` |


296| `CLAUDE_CODE_TMPDIR` | Переопределить временный каталог, используемый для внутренних временных файлов. Claude Code добавляет `/claude-{uid}/` на Unix или `/claude/` на Windows к этому пути. По умолчанию: `/tmp` на macOS, `os.tmpdir()` на Linux и Windows. {/* min-version: 2.1.161 */}Начиная с v2.1.161, на macOS и Linux [изолированные](/ru/sandboxing) подпроцессы Bash получают короткий резервный `$TMPDIR` в системном стандарте, когда ваше переопределение — это длинный путь, так как некоторые инструменты не работают, когда пути временных файлов становятся слишком длинными. Неизолированные команды Bash наследуют `$TMPDIR` вашей оболочки без изменений. Собственные временные файлы Claude Code всегда используют ваше переопределение |298| `CLAUDE_CODE_TMPDIR` | Переопределить временный каталог, используемый для внутренних временных файлов. Claude Code добавляет `/claude-{uid}/` на Unix или `/claude/` на Windows к этому пути. По умолчанию: `/tmp` на macOS, `os.tmpdir()` на Linux и Windows. {/* min-version: 2.1.161 */}Начиная с v2.1.161, на macOS и Linux [изолированные](/ru/sandboxing) подпроцессы Bash получают короткий резервный `$TMPDIR` в системном стандарте, когда ваше переопределение — это длинный путь, так как некоторые инструменты не работают, когда пути временных файлов становятся слишком длинными. Неизолированные команды Bash наследуют `$TMPDIR` вашей оболочки без изменений. Собственные временные файлы Claude Code всегда используют ваше переопределение |

297| `CLAUDE_CODE_TMUX_TRUECOLOR` | Установите на `1`, чтобы разрешить вывод 24-битного truecolor внутри tmux. По умолчанию Claude Code ограничивает 256 цветами, когда установлена `$TMUX`, потому что tmux не пропускает последовательности выхода truecolor, если не настроен. Установите это после добавления `set -ga terminal-overrides ',*:Tc'` в ваш `~/.tmux.conf`. См. [Конфигурация терминала](/ru/terminal-config) для других параметров tmux |299| `CLAUDE_CODE_TMUX_TRUECOLOR` | Установите на `1`, чтобы разрешить вывод 24-битного truecolor внутри tmux. По умолчанию Claude Code ограничивает 256 цветами, когда установлена `$TMUX`, потому что tmux не пропускает последовательности выхода truecolor, если не настроен. Установите это после добавления `set -ga terminal-overrides ',*:Tc'` в ваш `~/.tmux.conf`. См. [Конфигурация терминала](/ru/terminal-config) для других параметров tmux |

298| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Использовать [Claude Platform on AWS](/ru/claude-platform-on-aws) |300| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Использовать [Claude Platform on AWS](/ru/claude-platform-on-aws) |

299| `CLAUDE_CODE_USE_BEDROCK` | Использовать [Bedrock](/ru/amazon-bedrock) |301| `CLAUDE_CODE_USE_BEDROCK` | Использовать [Amazon Bedrock](/ru/amazon-bedrock) |

300| `CLAUDE_CODE_USE_FOUNDRY` | Использовать [Microsoft Foundry](/ru/microsoft-foundry) |302| `CLAUDE_CODE_USE_FOUNDRY` | Использовать [Microsoft Foundry](/ru/microsoft-foundry) |

301| `CLAUDE_CODE_USE_MANTLE` | Использовать конечную точку Bedrock [Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) |303| `CLAUDE_CODE_USE_MANTLE` | Использовать конечную точку Amazon Bedrock [Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) |

302| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Установите на `1`, чтобы обнаруживать пользовательские команды, subagents и стили вывода, используя API файлов Node.js вместо ripgrep. Установите это, если встроенный бинарный файл ripgrep недоступен или заблокирован в вашей среде. Не влияет на инструменты Grep или поиск файлов |304| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Установите на `1`, чтобы обнаруживать пользовательские команды, subagents и стили вывода, используя API файлов Node.js вместо ripgrep. Установите это, если встроенный бинарный файл ripgrep недоступен или заблокирован в вашей среде. Не влияет на инструменты Grep или поиск файлов |

303| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Управляет инструментом PowerShell. На Windows без Git Bash инструмент включен автоматически; установите на `0`, чтобы отключить его. На Windows с установленным Git Bash инструмент постепенно развёртывается: установите на `1`, чтобы согласиться, или на `0`, чтобы отказаться. На Linux, macOS и WSL установите на `1`, чтобы включить его, что требует `pwsh` в вашем `PATH`. При включении на Windows Claude может запускать команды PowerShell изначально вместо маршрутизации через Git Bash. См. [Инструмент PowerShell](/ru/tools-reference#powershell-tool) |305| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Управляет инструментом PowerShell. На Windows без Git Bash инструмент включен автоматически; установите на `0`, чтобы отключить его. На Windows с установленным Git Bash инструмент постепенно развёртывается: установите на `1`, чтобы согласиться, или на `0`, чтобы отказаться. На Linux, macOS и WSL установите на `1`, чтобы включить его, что требует `pwsh` в вашем `PATH`. При включении на Windows Claude может запускать команды PowerShell изначально вместо маршрутизации через Git Bash. См. [Инструмент PowerShell](/ru/tools-reference#powershell-tool) |

304| `CLAUDE_CODE_USE_VERTEX` | Использовать [Vertex](/ru/google-vertex-ai) |306| `CLAUDE_CODE_USE_VERTEX` | Использовать [Google Cloud's Agent Platform](/ru/google-vertex-ai) |

305| `CLAUDE_CONFIG_DIR` | Переопределить каталог конфигурации (по умолчанию: `~/.claude`). Все параметры, учётные данные, история сессии и plugins хранятся под этим путём. Полезно для запуска нескольких учётных записей рядом: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |307| `CLAUDE_CONFIG_DIR` | Переопределить каталог конфигурации (по умолчанию: `~/.claude`). Все параметры, учётные данные, история сессии и plugins хранятся под этим путём. Полезно для запуска нескольких учётных записей рядом: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

306| `CLAUDE_DISABLE_ADOPT` | {/* min-version: 2.1.195 */}Установите на `1`, чтобы остановить выполняющуюся фоновую работу вместо её переноса при фоновом выполнении сессии нажатием `←` или с помощью [`/background`](/ru/agent-view#from-inside-a-session). Claude Code просит вас подтвердить перед фоновым выполнением, затем останавливает задачи, которые в противном случае переносились бы. Требуется Claude Code v2.1.195 или более поздняя версия |308| `CLAUDE_DISABLE_ADOPT` | {/* min-version: 2.1.195 */}Установите на `1`, чтобы остановить выполняющуюся фоновую работу вместо её переноса при фоновом выполнении сессии нажатием `←` или с помощью [`/background`](/ru/agent-view#from-inside-a-session). Claude Code просит вас подтвердить перед фоновым выполнением, затем останавливает задачи, которые в противном случае переносились бы. Требуется Claude Code v2.1.195 или более поздняя версия |

307| `CLAUDE_EFFORT` | Установите автоматически в подпроцессах инструмента Bash и командах hook на активный [уровень усилий](/ru/model-config#adjust-effort-level) для хода: `low`, `medium`, `high`, `xhigh` или `max`. Ultracode не является отдельным уровнем и сообщается как `xhigh`. Совпадает с полем `effort.level`, переданным в [hooks](/ru/hooks). Установлено только, когда текущая модель поддерживает параметр усилий |309| `CLAUDE_EFFORT` | Установите автоматически в подпроцессах инструмента Bash и командах hook на активный [уровень усилий](/ru/model-config#adjust-effort-level) для хода: `low`, `medium`, `high`, `xhigh` или `max`. Ultracode не является отдельным уровнем и сообщается как `xhigh`. Совпадает с полем `effort.level`, переданным в [hooks](/ru/hooks). Установлено только, когда текущая модель поддерживает параметр усилий |

308| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторож простоя на уровне байтов, или установите на `0`, чтобы принудительно отключить его. Когда не установлено, сторож включен по умолчанию для соединений Anthropic API и [Claude Platform on AWS](/ru/claude-platform-on-aws). Сторож байтов прерывает соединение, когда на проводе не поступают байты в течение 180 секунд по умолчанию на соединениях прямого Anthropic API, 300 секунд на Claude Platform on AWS и когда включен на Bedrock, или для значения `CLAUDE_STREAM_IDLE_TIMEOUT_MS`, когда это установлено, которое ограничено минимумом 5 минут, независимо от сторожа на уровне событий |310| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторож простоя на уровне байтов, или установите на `0`, чтобы принудительно отключить его. Когда не установлено, сторож включен по умолчанию для соединений Anthropic API и [Claude Platform on AWS](/ru/claude-platform-on-aws). Сторож байтов прерывает соединение, когда на проводе не поступают байты в течение 180 секунд по умолчанию на соединениях прямого Anthropic API, 300 секунд на Claude Platform on AWS и когда включен на Amazon Bedrock, или для значения `CLAUDE_STREAM_IDLE_TIMEOUT_MS`, когда это установлено, которое ограничено минимумом 5 минут, независимо от сторожа на уровне событий |

309| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите на `1`, чтобы включить сторож простоя на уровне байтов на ответах Amazon Bedrock `vnd.amazon.eventstream`. Отключено по умолчанию. Настройте тайм-аут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |311| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите на `1`, чтобы включить сторож простоя на уровне байтов на ответах Amazon Bedrock `vnd.amazon.eventstream`. Отключено по умолчанию. Настройте тайм-аут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

310| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторож простоя потока на уровне событий, или установите на `0`, чтобы принудительно отключить его. {/* min-version: 2.1.196 */}Когда не установлено, сторож включен по умолчанию для всех поставщиков. До v2.1.196 неустановленное значение по умолчанию было контролируемым сервером на прямом Anthropic API и отключено на других поставщиках. {/* min-version: 2.1.169 */}Начиная с v2.1.169, поставщики, отличные от прямого Anthropic API и Claude Platform on AWS, также имеют тайм-аут простоя тела в 5 минут по умолчанию, независимый от этой переменной; см. `API_FORCE_IDLE_TIMEOUT`. На Bedrock вы также можете включить независимый сторож на уровне байтов с помощью `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`; оба работают вместе, когда оба установлены. Настройте тайм-аут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |312| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторож простоя потока на уровне событий, или установите на `0`, чтобы принудительно отключить его. {/* min-version: 2.1.196 */}Когда не установлено, сторож включен по умолчанию для всех поставщиков. До v2.1.196 неустановленное значение по умолчанию было контролируемым сервером на прямом Anthropic API и отключено на других поставщиках. {/* min-version: 2.1.169 */}Начиная с v2.1.169, поставщики, отличные от прямого Anthropic API и Claude Platform on AWS, также имеют тайм-аут простоя тела в 5 минут по умолчанию, независимый от этой переменной; см. `API_FORCE_IDLE_TIMEOUT`. На Amazon Bedrock вы также можете включить независимый сторож на уровне байтов с помощью `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`; оба работают вместе, когда оба установлены. Настройте тайм-аут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

311| `CLAUDE_ENV_FILE` | Путь к скрипту оболочки, содержимое которого Claude Code запускает перед каждой командой Bash в том же процессе оболочки, поэтому экспорты в файле видны команде. Используйте для сохранения активации virtualenv или conda между командами. Также динамически заполняется [SessionStart](/ru/hooks#persist-environment-variables), [Setup](/ru/hooks#setup), [CwdChanged](/ru/hooks#cwdchanged) и [FileChanged](/ru/hooks#filechanged) hooks |313| `CLAUDE_ENV_FILE` | Путь к скрипту оболочки, содержимое которого Claude Code запускает перед каждой командой Bash в том же процессе оболочки, поэтому экспорты в файле видны команде. Используйте для сохранения активации virtualenv или conda между командами. Также динамически заполняется [SessionStart](/ru/hooks#persist-environment-variables), [Setup](/ru/hooks#setup), [CwdChanged](/ru/hooks#cwdchanged) и [FileChanged](/ru/hooks#filechanged) hooks |

312| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Префикс для автоматически сгенерированных имён сессий [Remote Control](/ru/remote-control), когда явное имя не предоставлено. По умолчанию имя хоста вашей машины, создавая имена, такие как `myhost-graceful-unicorn`. Флаг CLI `--remote-control-session-name-prefix` устанавливает то же значение для одного вызова |314| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Префикс для автоматически сгенерированных имён сессий [Remote Control](/ru/remote-control), когда явное имя не предоставлено. По умолчанию имя хоста вашей машины, создавая имена, такие как `myhost-graceful-unicorn`. Флаг CLI `--remote-control-session-name-prefix` устанавливает то же значение для одного вызова |

313| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Тайм-аут в миллисекундах перед тем, как сторож простоя потока закроет зависшее соединение. Когда вы устанавливаете эту переменную явно, минимум составляет `300000` (5 минут); более низкие значения молча ограничиваются, чтобы поглотить паузы расширенного мышления и буферизацию прокси. Когда не установлено, сторож на уровне событий по умолчанию составляет 300 секунд, а сторож на уровне байтов по умолчанию составляет 180 секунд на соединениях прямого Anthropic API (300 секунд на Claude Platform on AWS и других поставщиках). Неустановленное значение по умолчанию сторожа на уровне байтов в 180 секунд — это отдельное значение и не подлежит ограничению в 5 минут. Тайм-аут простоя тела, описанный в `API_FORCE_IDLE_TIMEOUT`, применяется независимо. На Bedrock также применяется, когда `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |315| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Тайм-аут в миллисекундах перед тем, как сторож простоя потока закроет зависшее соединение. Когда вы устанавливаете эту переменную явно, минимум составляет `300000` (5 минут); более низкие значения молча ограничиваются, чтобы поглотить паузы расширенного мышления и буферизацию прокси. Когда не установлено, сторож на уровне событий по умолчанию составляет 300 секунд, а сторож на уровне байтов по умолчанию составляет 180 секунд на соединениях прямого Anthropic API (300 секунд на Claude Platform on AWS и других поставщиках). Неустановленное значение по умолчанию сторожа на уровне байтов в 180 секунд — это отдельное значение и не подлежит ограничению в 5 минут. Тайм-аут простоя тела, описанный в `API_FORCE_IDLE_TIMEOUT`, применяется независимо. На Amazon Bedrock также применяется, когда `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |

314| `DEBUG` | Установите на `1`, чтобы включить режим отладки, эквивалент запуска с [`--debug`](/ru/cli-reference#cli-flags). Журналы отладки записываются в `~/.claude/debug/<session-id>.txt`, или в путь, установленный `CLAUDE_CODE_DEBUG_LOGS_DIR`. Только истинные значения `1`, `true`, `yes` и `on` включают режим отладки, поэтому шаблоны пространства имён, такие как `DEBUG=express:*`, установленные для других инструментов, не запускают его |316| `DEBUG` | Установите на `1`, чтобы включить режим отладки, эквивалент запуска с [`--debug`](/ru/cli-reference#cli-flags). Журналы отладки записываются в `~/.claude/debug/<session-id>.txt`, или в путь, установленный `CLAUDE_CODE_DEBUG_LOGS_DIR`. Только истинные значения `1`, `true`, `yes` и `on` включают режим отладки, поэтому шаблоны пространства имён, такие как `DEBUG=express:*`, установленные для других инструментов, не запускают его |

315| `DISABLE_AUTOUPDATER` | Установите на `1`, чтобы отключить автоматические обновления в фоне. Ручная команда `claude update` по-прежнему работает. Используйте `DISABLE_UPDATES`, чтобы заблокировать оба |317| `DISABLE_AUTOUPDATER` | Установите на `1`, чтобы отключить автоматические обновления в фоне. Ручная команда `claude update` по-прежнему работает. Используйте `DISABLE_UPDATES`, чтобы заблокировать оба |

316| `DISABLE_AUTO_COMPACT` | Установите на `1`, чтобы отключить автоматическое сжатие при приближении к лимиту контекста. Команда `/compact` остаётся доступной. Используйте, когда вы хотите явный контроль над тем, когда происходит сжатие |318| `DISABLE_AUTO_COMPACT` | Установите на `1`, чтобы отключить автоматическое сжатие при приближении к лимиту контекста. Команда `/compact` остаётся доступной. Используйте, когда вы хотите явный контроль над тем, когда происходит сжатие |


322| `DISABLE_FEEDBACK_COMMAND` | Установите на `1`, чтобы отключить команду `/feedback`. Также принимается старое имя `DISABLE_BUG_COMMAND` |324| `DISABLE_FEEDBACK_COMMAND` | Установите на `1`, чтобы отключить команду `/feedback`. Также принимается старое имя `DISABLE_BUG_COMMAND` |

323| `DISABLE_GROWTHBOOK` | Установите на `1`, чтобы отключить получение флагов функций GrowthBook и использовать значения по умолчанию кода для каждого флага. Логирование событий телеметрии остаётся включённым, если также не установлена переменная `DISABLE_TELEMETRY` |325| `DISABLE_GROWTHBOOK` | Установите на `1`, чтобы отключить получение флагов функций GrowthBook и использовать значения по умолчанию кода для каждого флага. Логирование событий телеметрии остаётся включённым, если также не установлена переменная `DISABLE_TELEMETRY` |

324| `DISABLE_INSTALLATION_CHECKS` | Установите на `1`, чтобы отключить предупреждения об установке. Используйте только при ручном управлении местоположением установки, так как это может скрыть проблемы со стандартными установками |326| `DISABLE_INSTALLATION_CHECKS` | Установите на `1`, чтобы отключить предупреждения об установке. Используйте только при ручном управлении местоположением установки, так как это может скрыть проблемы со стандартными установками |

325| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Установите на `1`, чтобы скрыть команду `/install-github-app`. Уже скрыта при использовании сторонних поставщиков (Bedrock, Vertex или Foundry) |327| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Установите на `1`, чтобы скрыть команду `/install-github-app`. Уже скрыта при использовании сторонних поставщиков (Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry) |

326| `DISABLE_INTERLEAVED_THINKING` | Установите на `1`, чтобы предотвратить отправку заголовка beta interleaved-thinking. Полезно, когда ваш шлюз LLM или поставщик не поддерживает [interleaved thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |328| `DISABLE_INTERLEAVED_THINKING` | Установите на `1`, чтобы предотвратить отправку заголовка beta interleaved-thinking. Полезно, когда ваш шлюз LLM или поставщик не поддерживает [interleaved thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

327| `DISABLE_LOGIN_COMMAND` | Установите на `1`, чтобы скрыть команду `/login`. Полезно, когда аутентификация обрабатывается внешне через ключи API или `apiKeyHelper` |329| `DISABLE_LOGIN_COMMAND` | Установите на `1`, чтобы скрыть команду `/login`. Полезно, когда аутентификация обрабатывается внешне через ключи API или `apiKeyHelper` |

328| `DISABLE_LOGOUT_COMMAND` | Установите на `1`, чтобы скрыть команду `/logout` |330| `DISABLE_LOGOUT_COMMAND` | Установите на `1`, чтобы скрыть команду `/logout` |


336| `DISABLE_UPGRADE_COMMAND` | Установите на `1`, чтобы скрыть команду `/upgrade` |338| `DISABLE_UPGRADE_COMMAND` | Установите на `1`, чтобы скрыть команду `/upgrade` |

337| `DO_NOT_TRACK` | Установите на `1`, чтобы отказаться от телеметрии. Эквивалент установки `DISABLE_TELEMETRY`. Claude Code признаёт это как кроссплатформенное соглашение, признанное многими инструментами разработчика |339| `DO_NOT_TRACK` | Установите на `1`, чтобы отказаться от телеметрии. Эквивалент установки `DISABLE_TELEMETRY`. Claude Code признаёт это как кроссплатформенное соглашение, признанное многими инструментами разработчика |

338| `ENABLE_CLAUDEAI_MCP_SERVERS` | Установите на `false`, чтобы отключить [MCP servers claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai) в Claude Code. Включено по умолчанию для вошедших в систему пользователей. Чтобы отключить для каждого проекта или организации, установите [`disableClaudeAiConnectors`](/ru/settings#available-settings) в параметрах вместо этого |340| `ENABLE_CLAUDEAI_MCP_SERVERS` | Установите на `false`, чтобы отключить [MCP servers claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai) в Claude Code. Включено по умолчанию для вошедших в систему пользователей. Чтобы отключить для каждого проекта или организации, установите [`disableClaudeAiConnectors`](/ru/settings#available-settings) в параметрах вместо этого |

339| `ENABLE_PROMPT_CACHING_1H` | Установите на `1`, чтобы запросить TTL кэша приглашений в 1 час вместо стандартных 5 минут. Предназначено для пользователей ключа API, [Bedrock](/ru/amazon-bedrock), [Vertex](/ru/google-vertex-ai), [Foundry](/ru/microsoft-foundry) и [Claude Platform on AWS](/ru/claude-platform-on-aws). Пользователи подписки получают TTL в 1 час автоматически. Записи кэша в 1 час выставляются по более высокой ставке |341| `ENABLE_PROMPT_CACHING_1H` | Установите на `1`, чтобы запросить TTL кэша приглашений в 1 час вместо стандартных 5 минут. Предназначено для пользователей ключа API, [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). Пользователи подписки получают TTL в 1 час автоматически. Записи кэша в 1 час выставляются по более выс окой ставке |

340| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Устарело. Используйте `ENABLE_PROMPT_CACHING_1H` вместо этого |342| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Устарело. Используйте `ENABLE_PROMPT_CACHING_1H` вместо этого |

341| `ENABLE_TOOL_SEARCH` | Управляет [поиском инструментов MCP](/ru/mcp#scale-with-mcp-tool-search). Не установлено: все инструменты MCP отложены по умолчанию, но загружены заранее на Vertex AI или когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся хостом первой стороны. Значения: `true` (всегда откладывать и отправлять заголовок beta, запросы не удаются на моделях Vertex AI ранее Sonnet 4.5 или Opus 4.5, или на прокси, которые не поддерживают `tool_reference`), `auto` (режим порога: загружать заранее, если инструменты подходят в пределах 10% контекста), `auto:N` (пользовательский порог, например, `auto:5` для 5%), `false` (загружать все заранее) |343| `ENABLE_TOOL_SEARCH` | Управляет [поиском инструментов MCP](/ru/mcp#scale-with-mcp-tool-search). Не установлено: все инструменты MCP отложены по умолчанию, но загружены заранее на Google Cloud's Agent Platform или когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся хостом первой стороны. Значения: `true` (всегда откладывать и отправлять заголовок beta, запросы не удаются на моделях Google Cloud's Agent Platform ранее Sonnet 4.5 или Opus 4.5, или на прокси, которые не поддерживают `tool_reference`), `auto` (режим порога: загружать заранее, если инструменты подходят в пределах 10% контекста), `auto:N` (пользовательский порог, например, `auto:5` для 5%), `false` (загружать все заранее) |

342| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Установите на любое непустое значение, чтобы все модели, а не только Opus, перестали повторять попытки с повторной ошибкой перегрузки, когда резервная модель не настроена. {/* min-version: 2.1.160 */}Начиная с v2.1.160, настроенная [цепь резервных моделей](/ru/model-config#fallback-model-chains) срабатывает при повторных ошибках перегрузки для любой основной модели, поэтому эта переменная не влияет на переключение на резервную модель |344| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Установите на любое непустое значение, чтобы все модели, а не только Opus, перестали повторять попытки с повторной ошибкой перегрузки, когда резервная модель не настроена. {/* min-version: 2.1.160 */}Начиная с v2.1.160, настроенная [цепь резервных моделей](/ru/model-config#fallback-model-chains) срабатывает при повторных ошибках перегрузки для любой основной модели, поэтому эта переменная не влияет на переключение на резервную модель |

343| `FORCE_AUTOUPDATE_PLUGINS` | Установите на `1`, чтобы принудительно обновлять plugins автоматически, даже если основной автоматический обновитель отключен через `DISABLE_AUTOUPDATER` |345| `FORCE_AUTOUPDATE_PLUGINS` | Установите на `1`, чтобы принудительно обновлять plugins автоматически, даже если основной автоматический обновитель отключен через `DISABLE_AUTOUPDATER` |

344| `FORCE_PROMPT_CACHING_5M` | Установите на `1`, чтобы принудительно использовать TTL кэша приглашений в 5 минут, даже когда в противном случае применялся бы TTL в 1 час. Переопределяет `ENABLE_PROMPT_CACHING_1H` |346| `FORCE_PROMPT_CACHING_5M` | Установите на `1`, чтобы принудительно использовать TTL кэша приглашений в 5 минут, даже когда в противном случае применялся бы TTL в 1 час. Переопределяет `ENABLE_PROMPT_CACHING_1H` |


355| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество удалённых MCP servers (HTTP/SSE) для подключения параллельно при запуске (по умолчанию: 20) |357| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество удалённых MCP servers (HTTP/SSE) для подключения параллельно при запуске (по умолчанию: 20) |

356| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество локальных MCP servers (stdio) для подключения параллельно при запуске (по умолчанию: 3) |358| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество локальных MCP servers (stdio) для подключения параллельно при запуске (по умолчанию: 3) |

357| `MCP_TIMEOUT` | Тайм-аут в миллисекундах для запуска MCP server (по умолчанию: 30000, или 30 секунд) |359| `MCP_TIMEOUT` | Тайм-аут в миллисекундах для запуска MCP server (по умолчанию: 30000, или 30 секунд) |

358| `MCP_TOOL_TIMEOUT` | Тайм-аут в миллисекундах для выполнения инструмента MCP (по умолчанию: 100000000, примерно 28 часов). Поле `timeout` для каждого сервера в `.mcp.json` переопределяет это для этого сервера. Для переменной окружения значения ниже 1000 ограничиваются одной секундой; для поля для каждого сервера значения ниже 1000 игнорируются |360| `MCP_TOOL_TIMEOUT` | Тайм-аут в миллисекундах для выполнения инструмента MCP (по умолчанию: 100000000, примерно 28 часов). Поле `timeout` для каждого сервера в `.mcp.json` переопределяет это для этого сервера. {/* min-version: 2.1.203 */}Поле `timeout` для каждого сервера не менее 1000 также устанавливает минимальное окно неактивности для вызовов инструментов этого сервера, поэтому `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` никогда не прерывает их раньше; этот пол требует Claude Code v2.1.203 или более поздней версии. Для переменной окружения значения ниже 1000 ограничиваются одной секундой; для поля для каждого сервера значения ниже 1000 игнорируются |

359| `NO_PROXY` | Список доменов и IP-адресов, на которые запросы будут отправляться напрямую, обходя прокси |361| `NO_PROXY` | Список доменов и IP-адресов, на которые запросы будут отправляться напрямую, обходя прокси |

360| `OTEL_LOG_ASSISTANT_RESPONSES` | {/* min-version: 2.1.193 */}Установите на `1`, чтобы включить текст ответа модели на события логирования OpenTelemetry `assistant_response`. Когда не установлено, используется значение `OTEL_LOG_USER_PROMPTS`. Установите на `0`, чтобы сохранить ответы скрытыми, даже когда установлен `OTEL_LOG_USER_PROMPTS`. Требуется Claude Code v2.1.193 или более поздняя версия. См. [Мониторинг](/ru/monitoring-usage#assistant-response-event) |362| `OTEL_LOG_ASSISTANT_RESPONSES` | {/* min-version: 2.1.193 */}Установите на `1`, чтобы включить текст ответа модели на события логирования OpenTelemetry `assistant_response`. Когда не установлено, используется значение `OTEL_LOG_USER_PROMPTS`. Установите на `0`, чтобы сохранить ответы скрытыми, даже когда установлен `OTEL_LOG_USER_PROMPTS`. Требуется Claude Code v2.1.193 или более поздняя версия. См. [Мониторинг](/ru/monitoring-usage#assistant-response-event) |

361| `OTEL_LOG_RAW_API_BODIES` | Выдавать JSON запроса и ответа Anthropic Messages API как события логирования `api_request_body` / `api_response_body`. Установите на `1` для встроенных тел, усечённых на 60 КБ, или `file:<dir>` для записи неусечённых тел на диск и выдачи пути `body_ref` вместо этого. Отключено по умолчанию; тела включают всю историю разговора. См. [Мониторинг](/ru/monitoring-usage#api-request-body-event) |363| `OTEL_LOG_RAW_API_BODIES` | Выдавать JSON запроса и ответа Anthropic Messages API как события логирования `api_request_body` / `api_response_body`. Установите на `1` для встроенных тел, усечённых на 60 КБ, или `file:<dir>` для записи неусечённых тел на диск и выдачи пути `body_ref` вместо этого. Отключено по умолчанию; тела включают всю историю разговора. См. [Мониторинг](/ru/monitoring-usage#api-request-body-event) |


370| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Переопределить бюджет символов для метаданных skills, показанных [инструменту Skill](/ru/skills#control-who-invokes-a-skill). Бюджет масштабируется динамически на 1% контекстного окна с резервным значением 8 000 символов. Устаревшее имя сохранено для обратной совместимости |372| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Переопределить бюджет символов для метаданных skills, показанных [инструменту Skill](/ru/skills#control-who-invokes-a-skill). Бюджет масштабируется динамически на 1% контекстного окна с резервным значением 8 000 символов. Устаревшее имя сохранено для обратной совместимости |

371| `TASK_MAX_OUTPUT_LENGTH` | Максимальное количество символов в выводе [subagent](/ru/sub-agents) перед усечением (по умолчанию: 32000, максимум: 160000). При усечении полный вывод сохраняется на диск и путь включается в усечённый ответ |373| `TASK_MAX_OUTPUT_LENGTH` | Максимальное количество символов в выводе [subagent](/ru/sub-agents) перед усечением (по умолчанию: 32000, максимум: 160000). При усечении полный вывод сохраняется на диск и путь включается в усечённый ответ |

372| `USE_BUILTIN_RIPGREP` | Установите на `0`, чтобы использовать установленный в системе `rg` вместо `rg`, включённого в Claude Code |374| `USE_BUILTIN_RIPGREP` | Установите на `0`, чтобы использовать установленный в системе `rg` вместо `rg`, включённого в Claude Code |

373| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Переопределить регион для Claude 3.5 Haiku при использовании Vertex AI |375| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Переопределить регион для Claude 3.5 Haiku при использовании Google Cloud's Agent Platform |

374| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Переопределить регион для Claude 3.5 Sonnet при использовании Vertex AI |376| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Переопределить регион для Claude 3.5 Sonnet при использовании Google Cloud's Agent Platform |

375| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Переопределить регион для Claude 3.7 Sonnet при использовании Vertex AI |377| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Переопределить регион для Claude 3.7 Sonnet при использовании Google Cloud's Agent Platform |

376| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Переопределить регион для Claude 4.0 Opus при использовании Vertex AI |378| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Переопределить регион для Claude 4.0 Opus при использовании Google Cloud's Agent Platform |

377| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Переопределить регион для Claude 4.0 Sonnet при использовании Vertex AI |379| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Переопределить регион для Claude 4.0 Sonnet при использовании Google Cloud's Agent Platform |

378| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Переопределить регион для Claude 4.1 Opus при использовании Vertex AI |380| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Переопределить регион для Claude 4.1 Opus при использовании Google Cloud's Agent Platform |

379| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Переопределить регион для Claude Opus 4.5 при использовании Vertex AI |381| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Переопределить регион для Claude Opus 4.5 при использовании Google Cloud's Agent Platform |

380| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Переопределить регион для Claude Sonnet 4.5 при использовании Vertex AI |382| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Переопределить регион для Claude Sonnet 4.5 при использовании Google Cloud's Agent Platform |

381| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Переопределить регион для Claude Opus 4.6 при использовании Vertex AI |383| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Переопределить регион для Claude Opus 4.6 при использовании Google Cloud's Agent Platform |

382| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Переопределить регион для Claude Sonnet 4.6 при использовании Vertex AI |384| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Переопределить регион для Claude Sonnet 4.6 при использовании Google Cloud's Agent Platform |

383| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Переопределить регион для Claude Opus 4.7 при использовании Vertex AI. Добавлено в v2.1.111 |385| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Переопределить регион для Claude Opus 4.7 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.111 |

384| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Переопределить регион для Claude Opus 4.8 при использовании Vertex AI. Добавлено в v2.1.154 |386| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Переопределить регион для Claude Opus 4.8 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.154 |

385| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}Переопределить регион для Claude Sonnet 5 при использовании Vertex AI. Добавлено в v2.1.197 |387| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}Переопределить регион для Claude Sonnet 5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.197 |

386| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Переопределить регион для Claude Fable 5 при использовании Vertex AI. Добавлено в v2.1.170 |388| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Переопределить регион для Claude Fable 5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.170 |

387| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Переопределить регион для Claude Haiku 4.5 при использовании Vertex AI |389| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Переопределить регион для Claude Haiku 4.5 при использовании Google Cloud's Agent Platform |

388 390 

389Также поддерживаются стандартные переменные экспортёра OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` и варианты для конкретных сигналов). См. [Мониторинг](/ru/monitoring-usage) для деталей конфигурации.391Также поддерживаются стандартные переменные экспортёра OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` и варианты для конкретных сигналов). См. [Мониторинг](/ru/monitoring-usage) для деталей конфигурации.

390 392 

errors.md +429 −209

Details

53| `SSL certificate verification failed` | [Network](#ssl-certificate-errors) |53| `SSL certificate verification failed` | [Network](#ssl-certificate-errors) |

54| `SSL certificate error (...)` during login or startup | [Network](#ssl-certificate-errors) |54| `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) |55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Network](#host-not-allowed-in-a-cloud-session) |

56| `Couldn't reconnect to your Remote Control session` | [Network](#couldn%E2%80%99t-reconnect-to-your-remote-control-session) |

56| `Prompt is too long` | [Request errors](#prompt-is-too-long) |57| `Prompt is too long` | [Request errors](#prompt-is-too-long) |

57| `Error during compaction: Conversation too long` | [Request errors](#error-during-compaction-conversation-too-long) |58| `Error during compaction: Conversation too long` | [Request errors](#error-during-compaction-conversation-too-long) |

58| `Request too large` | [Request errors](#request-too-large) |59| `Request too large` | [Request errors](#request-too-large) |


61| `PDF too large` / `PDF is password protected` | [Request errors](#pdf-errors) |62| `PDF too large` / `PDF is password protected` | [Request errors](#pdf-errors) |

62| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |63| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |

63| `There's an issue with the selected model` | [Request errors](#there%E2%80%99s-an-issue-with-the-selected-model) |64| `There's an issue with the selected model` | [Request errors](#there%E2%80%99s-an-issue-with-the-selected-model) |

65| `Model ... is not a recognized model id` | [Request errors](#model-is-not-a-recognized-model-id) |

64| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |66| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |

65| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organization%E2%80%99s-settings) |67| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organization%E2%80%99s-settings) |

66| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |68| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |

67| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |69| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |

68| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |70| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |

69| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |71| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |

72| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |

73| `Installation was killed before it could finish (exit code 137)` | [Installation errors](#installation-was-killed-before-it-could-finish) |

74| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |

75| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |

70| `--bg and --print conflict` | [Command-line errors](#command-line-errors) |76| `--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) |

78| `Could not import <server>: <reason>` | [Command-line errors](#could-not-import-a-server-from-claude-desktop) |

79| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |

80| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |

71| Responses seem lower quality than usual | [Response quality](#responses-seem-lower-quality-than-usual) |81| Responses seem lower quality than usual | [Response quality](#responses-seem-lower-quality-than-usual) |

72 82 

73<h2 id="automatic-retries">83<h2 id="automatic-retries">


96| [`API_TIMEOUT_MS`](/ru/env-vars) | 600000 | Тайм-аут для каждого запроса в миллисекундах. Повысьте его для медленных сетей или прокси. |106| [`API_TIMEOUT_MS`](/ru/env-vars) | 600000 | Тайм-аут для каждого запроса в миллисекундах. Повысьте его для медленных сетей или прокси. |

97 107 

98<h2 id="server-errors">108<h2 id="server-errors">

99 Server errors109 Ошибки сервера

100</h2>110</h2>

101 111 

102Эти ошибки исходят от поставщика услуг вывода, а не от вашей учетной записи или запроса. На Anthropic API это означает инфраструктуру Anthropic. На Bedrock, Vertex AI, Foundry или пользовательском шлюзе это означает инфраструктуру этого поставщика.112Эти ошибки поступают от поставщика услуг вывода, а не от вашей учетной записи или запроса. На Anthropic API это означает инфраструктуру Anthropic. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или пользовательском шлюзе это означает инфраструктуру этого поставщика.

103 113 

104<h3 id="api-error-500-internal-server-error">114<h3 id="api-error-500-internal-server-error">

105 API Error: 500 Internal server error115 API Error: 500 Internal server error

106</h3>116</h3>

107 117 

108Claude Code отображает код статуса и сообщение об ошибке API для любого ответа 5xx. Пример ниже показывает ответ 500 на Anthropic API:118Claude Code отображает код состояния и сообщение об ошибке API для любого ответа 5xx. Пример ниже показывает ответ 500 на Anthropic API:

109 119 

110```text theme={null}120```text theme={null}

111API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.121API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

112```122```

113 123 

114Завершающее предложение указывает, где проверить состояние здоровья сервиса и варьируется в зависимости от поставщика. Конфигурации Bedrock, Vertex AI и Foundry указывают статус сервиса этого поставщика. Пользовательский `ANTHROPIC_BASE_URL` указывает хост шлюза.124Завершающее предложение указывает, где проверить состояние службы, и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry указывают страницу состояния этого поставщика. Пользовательский `ANTHROPIC_BASE_URL` указывает хост шлюза.

115 125 

116Это указывает на неожиданный сбой внутри API. Это не вызвано вашим запросом, настройками или учетной записью.126Это указывает на неожиданный сбой внутри API. Это не вызвано вашим запросом, параметрами или учетной записью.

117 127 

118**Что делать:**128**Что делать:**

119 129 

120* Проверьте [status.claude.com](https://status.claude.com) или страницу статуса поставщика, указанную в сообщении, на наличие активных инцидентов130* Проверьте [status.claude.com](https://status.claude.com) или страницу состояния поставщика, указанную в сообщении, на предмет активных инцидентов

121* Подождите минуту, затем отправьте сообщение еще раз. Ваше исходное сообщение все еще находится в разговоре, поэтому для длинного запроса вы можете ввести `try again` вместо вставки всего текста.131* Подождите минуту, затем отправьте сообщение еще раз. Ваше исходное сообщение все еще находится в беседе, поэтому для длинного запроса вы можете ввести `try again` вместо вставки всего текста.

122* Если ошибка сохраняется без опубликованного инцидента, запустите `/feedback`, чтобы Anthropic могла расследовать детали вашего запроса. См. [Report an error](#report-an-error), если `/feedback` недоступна в вашей среде.132* Если ошибка сохраняется без опубликованного инцидента, запустите `/feedback`, чтобы Anthropic могла провести расследование с деталями вашего запроса. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде.

123 133 

124<h3 id="api-error-repeated-529-overloaded-errors">134<h3 id="api-error-repeated-529-overloaded-errors">

125 API Error: Repeated 529 Overloaded errors135 API Error: Repeated 529 Overloaded errors

126</h3>136</h3>

127 137 

128API временно работает на полную мощность для всех пользователей. Claude Code уже несколько раз повторила попытку перед отображением этого сообщения:138API временно работает на полную мощность для всех пользователей. Claude Code уже несколько раз повторил попытку перед отображением этого сообщения:

129 139 

130```text theme={null}140```text theme={null}

131API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.141API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.


137 147 

138**Что делать:**148**Что делать:**

139 149 

140* Проверьте [status.claude.com](https://status.claude.com) или страницу статуса поставщика, указанную в сообщении, на наличие уведомлений о емкости150* Проверьте [status.claude.com](https://status.claude.com) или страницу состояния поставщика, указанную в сообщении, на предмет уведомлений о емкости

141* Попробуйте еще раз через несколько минут151* Повторите попытку через несколько минут

142* Запустите `/model` и переключитесь на другую модель, чтобы продолжить работу, так как емкость отслеживается для каждой модели. Claude Code предлагает вам это сделать, когда одна модель испытывает особенно высокую нагрузку, например `Opus is experiencing high load, please use /model to switch to Sonnet`.152* Запустите `/model` и переключитесь на другую модель, чтобы продолжить работу, так как емкость отслеживается для каждой модели. Claude Code предлагает вам это сделать, когда одна модель испытывает особенно высокую нагрузку, например `Opus is experiencing high load, please use /model to switch to Sonnet`.

143 153 

144<h3 id="request-timed-out">154<h3 id="request-timed-out">

145 Request timed out155 Request timed out

146</h3>156</h3>

147 157 

148API не ответила до истечения срока соединения.158API не ответил до истечения срока подключения.

149 159 

150```text theme={null}160```text theme={null}

151Request timed out161Request timed out

152```162```

153 163 

154Это может произойти в периоды высокой нагрузки или когда генерируется очень большой ответ. Тайм-аут запроса по умолчанию составляет 10 минут.164Это может произойти в периоды высокой нагрузки или когда модель генерирует очень большой ответ. Время ожидания запроса по умолчанию составляет 10 минут.

155 165 

156**Что делать:**166**Что делать:**

157 167 

158* Повторите запрос168* Повторите запрос

159* Для долгосрочных задач разбейте работу на более мелкие запросы169* Для долгосрочных задач разбейте работу на более мелкие запросы

160* Если причина в медленной сети или прокси, повысьте `API_TIMEOUT_MS`, как описано в [Automatic retries](#automatic-retries)170* Если причина в медленной сети или прокси, увеличьте `API_TIMEOUT_MS`, как описано в [Automatic retries](#automatic-retries)

161* Если тайм-ауты частые и ваша сеть в остальном здорова, см. [Network and connection errors](#network-and-connection-errors) ниже171* Если тайм-ауты частые и ваша сеть в остальном здорова, см. [Network and connection errors](#network-and-connection-errors) ниже

162 172 

163<h3 id="the-response-above-may-be-incomplete">173<h3 id="the-response-above-may-be-incomplete">

164 The response above may be incomplete174 The response above may be incomplete

165</h3>175</h3>

166 176 

167Потоковый ответ завершился ошибкой после того, как Claude уже произвел видимый вывод. Повторная отправка запроса может выполнить те же вызовы инструментов дважды, поэтому Claude Code сохраняет то, что уже передалось, и добавляет это уведомление вместо отбрасывания хода. Какой вариант вы видите, называет причину:177Потоковый ответ не удался после того, как Claude уже произвел видимый результат. Повторная отправка запроса может привести к двойному выполнению одних и тех же вызовов инструментов, поэтому Claude Code сохраняет то, что уже было передано, и добавляет это уведомление вместо отказа от хода. Какой вариант вы видите, указывает на причину:

168 178 

169```text theme={null}179```text theme={null}

170API Error: Server error mid-response. The response above may be incomplete.180API Error: Server error mid-response. The response above may be incomplete.


172API Error: Response stalled mid-stream. The response above may be incomplete.182API Error: Response stalled mid-stream. The response above may be incomplete.

173```183```

174 184 

175* {/* min-version: 2.1.199 */}}`Server error mid-response`: ошибка сервера перегрузки или 5xx в середине потока. Этот вариант требует Claude Code v2.1.199 или позже; до этого этот случай отбрасывал частичный вывод и сообщал весь ход как об ошибке.185* {/* min-version: 2.1.199 */}`Server error mid-response`: ошибка перегрузки или 5xx сервера в середине потока. Этот вариант требует Claude Code v2.1.199 или позже; до этого этот случай отбрасывал частичный результат и сообщал весь ход как ошибку.

176* `Connection closed mid-response`: соединение разорвалось.186* `Connection closed mid-response`: соединение разорвалось.

177* `Response stalled mid-stream`: поток перестал отправлять данные.187* `Response stalled mid-stream`: поток перестал отправлять данные.

178 188 

179**Что делать:**189**Что делать:**

180 190 

181* Прочитайте ответ, который передался. Ничего не потеряно, но последние предложения или вызовы инструментов могут отсутствовать.191* Прочитайте ответ, который был передан. Ничего не потеряно, но последние предложения или вызовы инструментов могут отсутствовать.

182* Ответьте с `continue`, чтобы Claude продолжил с того места, где остановился192* Ответьте `continue`, чтобы Claude продолжил с того места, где остановился

183* Если та же ошибка появляется перед любым видимым выводом, Claude Code повторяет запрос вместо его завершения. См. [Automatic retries](#automatic-retries).193* Если одна и та же ошибка появляется до какого-либо видимого результата, Claude Code повторяет запрос вместо его завершения. См. [Automatic retries](#automatic-retries).

184 194 

185<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">195<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">

186 Auto mode cannot determine the safety of an action196 Auto mode cannot determine the safety of an action


200 210 

201* Повторите попытку через несколько секунд; Claude видит то же сообщение и обычно повторяет попытку самостоятельно211* Повторите попытку через несколько секунд; Claude видит то же сообщение и обычно повторяет попытку самостоятельно

202* Если повторные попытки продолжают не удаваться, продолжайте с задачами только для чтения и вернитесь к заблокированному действию позже212* Если повторные попытки продолжают не удаваться, продолжайте с задачами только для чтения и вернитесь к заблокированному действию позже

203* Это временно и не связано с [auto mode eligibility](/ru/permission-modes#eliminate-prompts-with-auto-mode); вам не нужно менять настройки213* Это временно и не связано с [auto mode eligibility](/ru/permission-modes#eliminate-prompts-with-auto-mode); вам не нужно менять параметры

204 214 

205Когда классификатор вернул непарсируемый ответ:215Когда классификатор вернул непарсируемый ответ:

206 216 


210 220 

211**Что делать:**221**Что делать:**

212 222 

213* Повторите действие; это обычно успешно срабатывает при следующей попытке223* Повторите действие; это обычно успешно при следующей попытке

214* Запустите `claude --debug` и повторите действие, чтобы увидеть основной ответ классификатора в журнале отладки224* Запустите `claude --debug` и повторите действие, чтобы увидеть основной ответ классификатора в журнале отладки

215 225 

216Когда разговор вырос больше, чем контекстное окно классификатора:226Когда отдельная проверка безопасности API заблокировала запрос классификатора из-за более раннего содержимого беседы:

227 

228```text theme={null}

229Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details

230```

231 

232**Что делать:**

233 

234* Это не решение о вашем действии. Содержимое, уже находящееся в вашей беседе, вызвало фильтр безопасности на API, когда auto mode отправил беседу классификатору

235* Повторная попытка не поможет; то же содержимое беседы снова вызовет фильтр

236* Переключитесь на другой [permission mode](/ru/permission-modes), чтобы вы могли одобрить действие при появлении запроса, или начните новую беседу без содержимого, вызывающего проблему

237 

238Когда беседа выросла больше, чем контекстное окно классификатора:

217 239 

218```text theme={null}240```text theme={null}

219Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)241Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

220```242```

221 243 

222В интерактивном сеансе auto mode переходит на обычный запрос разрешения для этого действия, чтобы вы могли одобрить или отклонить его вручную. В [non-interactive mode](/ru/headless) запуск прерывается, потому что стенограмма только растет и повторная попытка не может быть успешной.244В интерактивном сеансе auto mode возвращается к обычному запросу разрешения для этого действия, чтобы вы могли одобрить или отклонить его вручную. В [non-interactive mode](/ru/headless) запуск прерывается, потому что стенограмма только растет и повторная попытка не может быть успешной.

223 245 

224**Что делать:**246**Что делать:**

225 247 

226* Одобрите или отклоните действие в появившемся запросе248* Одобрите или отклоните действие в появившемся запросе

227* Запустите `/compact`, чтобы уменьшить размер разговора, чтобы последующие действия снова поместились в окне классификатора249* Запустите `/compact`, чтобы уменьшить размер беседы, чтобы последующие действия снова поместились в окне классификатора

228 250 

229<h3 id="agent-terminated-early-due-to-an-api-error">251<h3 id="agent-terminated-early-due-to-an-api-error">

230 Agent terminated early due to an API error252 Agent terminated early due to an API error

231</h3>253</h3>

232 254 

233{/* min-version: 2.1.199 */}Запрос API [subagent](/ru/sub-agents) завершился ошибкой окончательно, например, потому что был достигнут лимит использования или повторные попытки для ошибки сервера исчерпаны, поэтому подагент остановился перед завершением своей задачи. Это сообщение требует Claude Code v2.1.199 или позже; до этого текст ошибки API возвращался Claude, как если бы это был результат подагента.255{/* min-version: 2.1.199 */}Запрос API [subagent](/ru/sub-agents) не удался окончательно, например, потому что был достигнут лимит использования или повторные попытки для ошибки сервера закончились, поэтому subagent остановился до завершения своей задачи. Это сообщение требует Claude Code v2.1.199 или позже; до этого текст ошибки API был возвращен Claude как если бы это был результат subagent.

234 256 

235```text theme={null}257```text theme={null}

236Agent terminated early due to an API error: <error detail>258Agent terminated early due to an API error: <error detail>


238 260 

239**Что делать:**261**Что делать:**

240 262 

241* Сопоставьте деталь ошибки после двоеточия с её собственным разделом на этой странице, такой как [Usage limits](#usage-limits) или [Server errors](#server-errors), и следуйте шагам этого раздела263* Сопоставьте деталь ошибки после двоеточия с ее собственным разделом на этой странице, например [Usage limits](#usage-limits) или [Server errors](#server-errors), и следуйте шагам этого раздела

242* После того как базовая ошибка исчезнет, попросите Claude повторить задачу или [resume the subagent](/ru/sub-agents#resume-subagents)264* После того как основная ошибка исчезнет, попросите Claude повторить задачу или [resume the subagent](/ru/sub-agents#resume-subagents)

243 265 

244Когда лимит скорости, перегрузка или ошибка сервера прерывает переднего подагента, который уже произвел вывод, Claude получает этот частичный вывод, отмеченный как неполный, вместо этой ошибки. См. [API errors in subagents](/ru/sub-agents#api-errors-in-subagents).266Когда ограничение скорости, перегрузка или ошибка сервера прерывает foreground subagent, который уже произвел текстовый результат, Claude получает этот частичный результат, отмеченный как неполный, вместо этой ошибки. {/* min-version: 2.1.200 */}Subagent, единственным результатом которого были вызовы инструментов, также получает эту ошибку; в v2.1.199 эта форма возвращала пустой частичный результат вместо этого. См. [API errors in subagents](/ru/sub-agents#api-errors-in-subagents).

245 267 

246<h2 id="usage-limits">268<h2 id="usage-limits">

247 Usage limits269 Ограничения использования

248</h2>270</h2>

249 271 

250Эти ошибки означают, что квота, привязанная к вашей учетной записи или плану, была достигнута. Они отличаются от [server errors](#server-errors), которые влияют на всех.272Эти ошибки означают, что достигнута квота, связанная с вашей учетной записью или планом. Они отличаются от [ошибок сервера](#server-errors), которые влияют на всех.

251 273 

252<h3 id="you’ve-hit-your-session-limit">274<h3 id="you’ve-hit-your-session-limit">

253 You've hit your session limit275 Вы достигли лимита сеанса

254</h3>276</h3>

255 277 

256Планы подписки включают скользящий лимит использования. Когда он заканчивается, вы видите одно из этих сообщений:278Планы подписки включают скользящий лимит использования. Когда он исчерпывается, вы видите одно из этих сообщений:

257 279 

258```text theme={null}280```text theme={null}

259You've hit your session limit · resets 3:45pm281You've hit your session limit · resets 3:45pm


261You've hit your Opus limit · resets 3:45pm283You've hit your Opus limit · resets 3:45pm

262```284```

263 285 

264Claude Code блокирует дальнейшие запросы до времени сброса, показанного в сообщении.286Claude Code блокирует дальнейшие запросы до времени сброса, указанного в сообщении.

265 287 

266**Что делать:**288**Что делать:**

267 289 

268* Дождитесь времени сброса, показанного в ошибке290* Дождитесь времени сброса, указанного в ошибке

269* Запустите `/usage`, чтобы увидеть лимиты вашего плана и когда они сбрасываются291* Запустите `/usage` для просмотра лимитов вашего плана и времени их сброса

270* Запустите `/usage-credits`, чтобы купить дополнительное использование на Pro и Max, или запросить его у администратора на Team и Enterprise. См. [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) для информации о том, как это выставляется счетом.292* Запустите `/usage-credits` для покупки дополнительного использования на Pro и Max, или для запроса у администратора на Team и Enterprise. См. [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) для информации о выставлении счетов.

271* Чтобы обновить ваш план для более высоких базовых лимитов, см. [claude.com/pricing](https://claude.com/pricing)293* Для обновления вашего плана на более высокие базовые лимиты см. [claude.com/pricing](https://claude.com/pricing)

272 294 

273Чтобы отслеживать оставшийся лимит перед его достижением, добавьте поля `rate_limits` в [custom status line](/ru/statusline#rate-limit-usage), или в Desktop app нажмите [usage ring](/ru/desktop#check-usage) рядом с выбором модели.295Чтобы отслеживать оставшийся лимит перед его исчерпанием, добавьте поля `rate_limits` в [пользовательскую строку состояния](/ru/statusline#rate-limit-usage), или в приложении Desktop нажмите на [кольцо использования](/ru/desktop#check-usage) рядом с выбором модели.

274 296 

275<h3 id="usage-credits-required-for-1m-context">297<h3 id="usage-credits-required-for-1m-context">

276 Usage credits required for 1M context298 Требуются кредиты использования для контекста 1M

277</h3>299</h3>

278 300 

279Выбранная модель использует расширенное окно контекста с 1M токенами, и ваш план включает его только через usage credits.301Выбранная модель использует расширенное окно контекста на 1M токенов, и ваш план включает его только через кредиты использования.

280 302 

281```text theme={null}303```text theme={null}

282API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context304API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

283```305```

284 306 

285Это проверка прав доступа, а не исчерпание квоты. Она срабатывает даже когда у вас остается емкость в лимитах сеанса и недельного использования. См. [Extended context](/ru/model-config#extended-context) для информации о том, какие планы включают 1M контекст напрямую и какие требуют usage credits.307Это проверка прав доступа, а не исчерпание квоты. Она срабатывает даже когда ваши лимиты сеанса и недельного использования имеют оставшуюся емкость. См. [Extended context](/ru/model-config#extended-context) для информации о том, какие планы включают контекст 1M напрямую и какие требуют кредитов использования.

286 308 

287{/* min-version: 2.1.172 */}Когда эта ошибка появляется в середине разговора, потому что контекст вырос более чем на 200K токенов, Claude Code автоматически сжимает разговор обратно под стандартный лимит контекста и сохраняет сеанс на этом уровне впоследствии, поэтому никаких действий не требуется. На версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая `/compact`; запустите `/clear` на этих версиях для восстановления. Приведенные ниже шаги применяются, когда вы явно выбрали модель `[1m]`.309{/* min-version: 2.1.172 */}Когда эта ошибка появляется в середине разговора, потому что контекст вырос более 200K токенов, Claude Code автоматически сжимает разговор обратно под стандартный лимит контекста и сохраняет сеанс на этом уровне впоследствии, поэтому никаких действий не требуется. На версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая `/compact`; запустите `/clear` на этих версиях для восстановления. Приведенные ниже шаги применяются, когда вы явно выбрали модель `[1m]`.

288 310 

289**Что делать:**311**Что делать:**

290 312 

291* Запустите `/model` и выберите вариант без суффикса `[1m]`, чтобы вернуться к стандартному окну контекста313* Запустите `/model` и выберите вариант без суффикса `[1m]` для возврата к стандартному окну контекста

292* Запустите `/usage-credits`, чтобы включить поэтапное выставление счетов для варианта 1M на Pro и Max, или запросить его у администратора на Team и Enterprise314* Запустите `/usage-credits` для включения тарифицированного выставления счетов для варианта 1M на Pro и Max, или для запроса у администратора на Team и Enterprise

293* Если ошибка сохраняется после `/model`, ID модели 1M может быть установлен в другом месте. См. [There's an issue with the selected model](#there%E2%80%99s-an-issue-with-the-selected-model) для проверки мест конфигурации в порядке приоритета.315* Если ошибка сохраняется после `/model`, ID модели 1M может быть установлен в другом месте. См. [There's an issue with the selected model](#there%E2%80%99s-an-issue-with-the-selected-model) для проверки мест конфигурации в порядке приоритета.

294* Чтобы полностью удалить варианты 1M из выбора модели, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/ru/env-vars)316* Чтобы полностью удалить варианты 1M из выбора модели, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/ru/env-vars)

295 317 

296<h3 id="server-is-temporarily-limiting-requests">318<h3 id="server-is-temporarily-limiting-requests">

297 Server is temporarily limiting requests319 Сервер временно ограничивает запросы

298</h3>320</h3>

299 321 

300API применила краткосрочный дроссель, который не связан с квотой вашего плана.322API применил кратковременное дросселирование, которое не связано с квотой вашего плана.

301 323 

302```text theme={null}324```text theme={null}

303API Error: Server is temporarily limiting requests (not your usage limit)325API Error: Server is temporarily limiting requests (not your usage limit)

304```326```

305 327 

306Claude Code различает эти случаи от вашего лимита плана по отсутствию унифицированных заголовков квоты, которые несет реальный ответ лимита. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, это [retried automatically](#automatic-retries) с задержкой перед отображением, независимо от того, как вы аутентифицируетесь. На более ранних версиях сеанс, вошедший с подписью claude.ai, завершился ошибкой при первом возникновении; только входы по ключу API и Enterprise повторили попытку.328Claude Code различает это от вашего лимита плана по отсутствию унифицированных заголовков квоты, которые несет реальный ответ лимита. {/* min-version: 2.1.199 */}Начиная с v2.1.199 это [автоматически повторяется](#automatic-retries) с отступом перед отображением, независимо от способа аутентификации. На более ранних версиях сеанс, подписанный на подписку claude.ai, не прошел ход при первом возникновении; только API ключ и аутентификация Enterprise повторили попытку.

307 329 

308**Что делать:**330**Что делать:**

309 331 

310* Подождите немного и попробуйте еще раз332* Подождите немного и попробуйте снова

311* Проверьте [status.claude.com](https://status.claude.com), если это сохраняется333* Проверьте [status.claude.com](https://status.claude.com) если проблема сохраняется

312 334 

313<h3 id="request-rejected-429">335<h3 id="request-rejected-429">

314 Request rejected (429)336 Запрос отклонен (429)

315</h3>337</h3>

316 338 

317Вы достигли лимита скорости, настроенного для вашего ключа API, проекта Amazon Bedrock или проекта Google Vertex AI.339Вы достигли лимита скорости, настроенного для вашего API ключа, проекта Amazon Bedrock или проекта Google Cloud.

318 340 

319```text theme={null}341```text theme={null}

320API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.342API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

321```343```

322 344 

323Завершающее предложение указывает, где проверить состояние сервиса и варьируется в зависимости от провайдера. Конфигурации Bedrock, Vertex AI и Foundry указывают на страницу состояния этого провайдера вместо страницы состояния Anthropic. Пользовательский `ANTHROPIC_BASE_URL` указывает на хост шлюза.345Завершающее предложение указывает, где проверить здоровье сервиса и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry указывают на страницу статуса этого поставщика вместо страницы статуса Anthropic. Пользовательский `ANTHROPIC_BASE_URL` указывает на хост шлюза.

324 346 

325**Что делать:**347**Что делать:**

326 348 

327* Запустите `/status` и подтвердите, что активные учетные данные это те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может маршрутизировать запросы через низкоуровневый ключ вместо вашей подписки.349* Запустите `/status` и подтвердите, что активные учетные данные - это те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может маршрутизировать запросы через ключ низкого уровня вместо вашей подписки.

328* Проверьте консоль вашего провайдера на предмет активных лимитов и запросите более высокий уровень, если необходимо350* Проверьте консоль вашего поставщика для активных лимитов и запросите более высокий уровень, если необходимо

329* Для ключей Anthropic API см. [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) для информации о том, как работают уровни и как установить лимиты для каждого рабочего пространства351* Для API ключей Anthropic см. [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) для информации о том, как работают уровни и как установить ограничения расходов для каждого рабочего пространства

330* Снизьте параллелизм: понизьте [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ru/env-vars), избегайте запуска множества параллельных подагентов или переключитесь на меньшую модель с `/model` для высокообъемных скриптовых запусков352* Снизьте параллелизм: понизьте [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ru/env-vars), избегайте запуска множества параллельных подагентов, или переключитесь на меньшую модель с `/model` для высокообъемных скриптовых запусков

331 353 

332<h3 id="credit-balance-is-too-low">354<h3 id="credit-balance-is-too-low">

333 Credit balance is too low355 Баланс кредитов слишком низкий

334</h3>356</h3>

335 357 

336Ваша организация Console исчерпала предоплаченные кредиты.358Ваша организация Console исчерпала предоплаченные кредиты.


341 363 

342**Что делать:**364**Что делать:**

343 365 

344* Добавьте кредиты на [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing) и рассмотрите возможность включения автоматической перезагрузки там, чтобы баланс пополнялся перед тем, как он упадет до нуля366* Добавьте кредиты на [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), и рассмотрите возможность включения автоматической перезагрузки там, чтобы баланс пополнялся до того, как он упадет до нуля

345* Переключитесь на аутентификацию подписки с помощью `/login`, если у вас есть план Pro, Max, Team или Enterprise367* Переключитесь на аутентификацию подписки с `/login` если у вас есть план Pro, Max, Team или Enterprise

346* Установите лимиты расходов для каждого рабочего пространства в Console, чтобы предотвратить истощение баланса организации одним проектом. См. [Manage costs effectively](/ru/costs).368* Установите ограничения расходов для каждого рабочего пространства в Console, чтобы предотвратить истощение баланса организации одним проектом. См. [Manage costs effectively](/ru/costs).

347 369 

348<h2 id="authentication-errors">370<h2 id="authentication-errors">

349 Authentication errors371 Ошибки аутентификации

350</h2>372</h2>

351 373 

352Эти ошибки означают, что Claude Code не может доказать вашу личность API. Запустите `/status` в любое время, чтобы увидеть, какие учетные данные в настоящее время активны.374Эти ошибки означают, что Claude Code не может подтвердить вашу личность перед API. Запустите `/status` в любой момент, чтобы увидеть, какие учетные данные в настоящее время активны.

353 375 

354<h3 id="not-logged-in">376<h3 id="not-logged-in">

355 Not logged in377 Not logged in

356</h3>378</h3>

357 379 

358Для этого сеанса нет доступных действительных учетных данных.380Для этого сеанса нет действительных учетных данных.

359 381 

360```text theme={null}382```text theme={null}

361Not logged in · Please run /login383Not logged in · Please run /login


364**Что делать:**386**Что делать:**

365 387 

366* Запустите `/login` для аутентификации с помощью вашей подписки Claude или учетной записи Console388* Запустите `/login` для аутентификации с помощью вашей подписки Claude или учетной записи Console

367* Если вы ожидали, что переменная окружения будет аутентифицировать вас, подтвердите, что `ANTHROPIC_API_KEY` установлена и экспортирована в оболочке, где вы запустили `claude`389* Если вы ожидали, что переменная окружения будет вас аутентифицировать, убедитесь, что `ANTHROPIC_API_KEY` установлена и экспортирована в оболочке, где вы запустили `claude`

368* Для CI или автоматизации, где интерактивный вход невозможен, настройте скрипт [`apiKeyHelper`](/ru/settings#available-settings), который получает ключ при запуске390* Для CI или автоматизации, где интерактивный вход невозможен, настройте скрипт [`apiKeyHelper`](/ru/settings#available-settings), который получает ключ при запуске

369* См. [Authentication precedence](/ru/authentication#authentication-precedence), чтобы понять, какие учетные данные выигрывают, когда присутствуют несколько391* См. [Authentication precedence](/ru/authentication#authentication-precedence), чтобы понять, какие учетные данные использует Claude Code, когда присутствует несколько

370 392 

371Если вас просят войти повторно, см. [Not logged in or token expired](/ru/troubleshoot-install#not-logged-in-or-token-expired) для исправлений системных часов и macOS Keychain.393Если вам предлагается войти повторно, см. [Not logged in or token expired](/ru/troubleshoot-install#not-logged-in-or-token-expired) для исправления системных часов и macOS Keychain.

372 394 

373<h3 id="could-not-resolve-authentication-method">395<h3 id="could-not-resolve-authentication-method">

374 Could not resolve authentication method396 Could not resolve authentication method


385**Что делать:**407**Что делать:**

386 408 

387* Обновитесь до версии 2.1.174 или более поздней, если это появляется в фоновом или облачном сеансе и ваши учетные данные уже настроены409* Обновитесь до версии 2.1.174 или более поздней, если это появляется в фоновом или облачном сеансе и ваши учетные данные уже настроены

388* Подтвердите, что `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` или учетные данные вашего облачного провайдера установлены в окружении, которое запускает рабочий процесс, а не только в вашей интерактивной оболочке410* Убедитесь, что `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` или учетные данные вашего облачного провайдера установлены в окружении, которое запускает рабочий процесс, а не только в вашей интерактивной оболочке

389* Для Agent SDK см. [authentication setup](/ru/agent-sdk/overview#get-started)411* Для Agent SDK см. [authentication setup](/ru/agent-sdk/overview#get-started)

390* Запустите `/status` в интерактивном сеансе в том же окружении, чтобы подтвердить, какой источник учетных данных разрешается412* Запустите `/status` в интерактивном сеансе в том же окружении, чтобы подтвердить, какой источник учетных данных разрешается

391 413 


393 Invalid API key415 Invalid API key

394</h3>416</h3>

395 417 

396Переменная окружения `ANTHROPIC_API_KEY` или скрипт `apiKeyHelper` вернули ключ, который API отклонила.418Переменная окружения `ANTHROPIC_API_KEY` или скрипт `apiKeyHelper` вернули ключ, который API отклонил.

397 419 

398```text theme={null}420```text theme={null}

399Invalid API key · Fix external API key421Invalid API key · Fix external API key


401 423 

402**Что делать:**424**Что делать:**

403 425 

404* Проверьте опечатки и подтвердите, что ключ не был отозван в [Console](https://platform.claude.com/settings/keys)426* Проверьте опечатки и убедитесь, что ключ не был отозван в [Console](https://platform.claude.com/settings/keys)

405* Запустите `env | grep ANTHROPIC` в той же оболочке. Такие инструменты, как direnv, dotenv shell plugins и IDE terminals, могут загружать устаревший ключ из файла `.env` в вашем проекте без явной установки.427* Запустите `env | grep ANTHROPIC` в той же оболочке. Такие инструменты, как direnv, плагины dotenv shell и терминалы IDE, могут загружать устаревший ключ из файла `.env` в вашем проекте без явной установки.

406* Отмените установку `ANTHROPIC_API_KEY` и запустите `/login`, чтобы вместо этого использовать аутентификацию подписки428* Отмените установку `ANTHROPIC_API_KEY` и запустите `/login` для использования аутентификации подписки

407* Если ключ поступает из скрипта [`apiKeyHelper`](/ru/settings#available-settings), запустите скрипт напрямую, чтобы подтвердить, что он выводит действительный ключ на stdout429* Если ключ поступает из скрипта [`apiKeyHelper`](/ru/settings#available-settings), запустите скрипт напрямую, чтобы подтвердить, что он выводит действительный ключ на stdout

408* Запустите `/status`, чтобы подтвердить, какой источник учетных данных Claude Code фактически использует430* Запустите `/status`, чтобы подтвердить, какой источник учетных данных на самом деле использует Claude Code

409 431 

410<h3 id="this-organization-has-been-disabled">432<h3 id="this-organization-has-been-disabled">

411 This organization has been disabled433 This organization has been disabled


418API Error: 400 ... This organization has been disabled.440API Error: 400 ... This organization has been disabled.

419```441```

420 442 

421Переменные окружения имеют приоритет над `/login`, поэтому ключ, экспортированный в профиль вашей оболочки или загруженный из файла `.env`, используется даже если у вас есть работающая подписка Pro или Max. В неинтерактивном режиме (`-p`) ключ всегда используется, когда он присутствует.443Переменные окружения имеют приоритет над `/login`, поэтому ключ, экспортированный в профиль вашей оболочки или загруженный из файла `.env`, используется даже если у вас есть рабочая подписка Pro или Max. В неинтерактивном режиме (`-p`) ключ всегда используется, когда он присутствует.

422 444 

423**Что делать:**445**Что делать:**

424 446 

425* Отмените установку `ANTHROPIC_API_KEY` в текущей оболочке и удалите его из профиля вашей оболочки, затем перезапустите `claude`447* Отмените установку `ANTHROPIC_API_KEY` в текущей оболочке и удалите его из профиля вашей оболочки, затем перезапустите `claude`

426* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка448* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка

427* Если переменная окружения не установлена и ошибка сохраняется, отключенная организация — это та, которая привязана к вашему `/login`. Свяжитесь с поддержкой или войдите с другой учетной записью.449* Если переменная окружения не установлена и ошибка сохраняется, отключенная организация — это та, которая связана с вашим `/login`. Свяжитесь с поддержкой или войдите с другой учетной записью.

428 450 

429<h3 id="your-organization-has-disabled-api-key-authentication">451<h3 id="your-organization-has-disabled-api-key-authentication">

430 Your organization has disabled API key authentication452 Your organization has disabled API key authentication

431</h3>453</h3>

432 454 

433Администратор вашей организации Console отключил аутентификацию по ключу API, поэтому API отклоняет ключ, который отправляет Claude Code. Подсказка восстановления после `·` варьируется в зависимости от того, откуда поступил ключ:455Это сообщение требует Claude Code версии 2.1.169 или более поздней. Администратор организации Console отключил аутентификацию по ключу API, поэтому API отклоняет ключ, который отправляет Claude Code. Подсказка восстановления после `·` варьируется в зависимости от того, откуда поступил ключ:

434 456 

435```text theme={null}457```text theme={null}

436Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account458Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account


439Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account461Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

440```462```

441 463 

442Переменные окружения и `apiKeyHelper` имеют приоритет над `/login`, поэтому просто запуск `/login` не помогает, пока один из них все еще предоставляет ключ. См. [Authentication precedence](/ru/authentication#authentication-precedence).464Переменные окружения и `apiKeyHelper` имеют приоритет над `/login`, поэтому запуск только `/login` не помогает, пока один из них все еще предоставляет ключ. См. [Authentication precedence](/ru/authentication#authentication-precedence).

443 465 

444**Что делать:**466**Что делать:**

445 467 

446* Если сообщение указывает на `ANTHROPIC_API_KEY`, отмените его установку в текущей оболочке и удалите его из профиля вашей оболочки или файла `.env`, затем перезапустите `claude`468* Если сообщение называет `ANTHROPIC_API_KEY`, отмените его установку в текущей оболочке и удалите его из профиля вашей оболочки или файла `.env`, затем перезапустите `claude`

447* Если сообщение указывает на `apiKeyHelper`, удалите параметр [`apiKeyHelper`](/ru/settings#available-settings) из вашего `settings.json`469* Если сообщение называет `apiKeyHelper`, удалите параметр [`apiKeyHelper`](/ru/settings#available-settings) из вашего `settings.json`

448* Запустите `/login`, чтобы войти с помощью вашей учетной записи claude.ai470* Запустите `/login` для входа с помощью вашей учетной записи claude.ai

449* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка, а не ключ API471* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка, а не ключ API

450* Если вам нужна аутентификация по ключу API для автоматизации, попросите администратора вашей организации повторно включить ее в Console472* Если вам нужна аутентификация по ключу API для автоматизации, попросите администратора вашей организации повторно включить ее в Console

451 473 


453 Your organization has disabled Claude subscription access475 Your organization has disabled Claude subscription access

454</h3>476</h3>

455 477 

456Ваша организация Claude не позволяет входить в Claude Code с помощью входа по подписке. Повторный запуск `/login` с той же учетной записью возвращает ту же ошибку.478Ваша организация Claude не позволяет входить в Claude Code с помощью подписки. Повторный запуск `/login` с той же учетной записью возвращает ту же ошибку.

457 479 

458```text theme={null}480```text theme={null}

459Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access481Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access


461 483 

462Это параметр организации на стороне сервера, поэтому его нельзя переопределить из локальных параметров, переменных окружения или флагов CLI.484Это параметр организации на стороне сервера, поэтому его нельзя переопределить из локальных параметров, переменных окружения или флагов CLI.

463 485 

464Agent SDK и `-p` неинтерактивный режим отображают это как код ошибки `oauth_org_not_allowed`.486Agent SDK и неинтерактивный режим `-p` представляют это как код ошибки `oauth_org_not_allowed`.

465 487 

466**Что делать:**488**Что делать:**

467 489 

468* Попросите вашего администратора включить доступ Claude Code для вашей организации490* Попросите администратора включить доступ Claude Code для вашей организации

469* Аутентифицируйтесь с помощью ключа API Console вместо вашей подписки. См. [Claude Console authentication](/ru/authentication#claude-console-authentication) для настройки.491* Аутентифицируйтесь с помощью ключа API Console вместо вашей подписки. См. [Claude Console authentication](/ru/authentication#claude-console-authentication) для настройки.

470* Если вы администратор и не видите опцию для включения доступа, свяжитесь с [поддержкой Anthropic](https://support.claude.com)492* Если вы администратор и не видите опцию для включения доступа, свяжитесь с [Anthropic support](https://support.claude.com)

471 493 

472<h3 id="routines-are-disabled-by-your-organization’s-policy">494<h3 id="routines-are-disabled-by-your-organization’s-policy">

473 Routines are disabled by your organization's policy495 Routines are disabled by your organization's policy

474</h3>496</h3>

475 497 

476Администратор вашей Team или Enterprise организации отключил routines на уровне организации. Ошибка появляется при попытке создать или запустить routine, включая из `/schedule` и пользовательского интерфейса [Routines](/ru/routines) на claude.ai/code.498Владелец в вашей организации Team или Enterprise отключил routines на уровне организации. Ошибка появляется при попытке создать или запустить routine, включая из `/schedule` и пользовательского интерфейса [Routines](/ru/routines) на claude.ai/code.

477 499 

478```text theme={null}500```text theme={null}

479Routines are disabled by your organization's policy.501Routines are disabled by your organization's policy.


483 505 

484**Что делать:**506**Что делать:**

485 507 

486* Попросите администратора вашей организации включить переключатель **Routines** на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)508* Попросите владельца в вашей организации включить переключатель **Routines** на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)

487* Для одноразовой запланированной работы, которая не требует routines на уровне организации, см. [scheduled tasks](/ru/scheduled-tasks)509* Для одноразовой запланированной работы, которая не требует routines на уровне организации, см. [scheduled tasks](/ru/scheduled-tasks)

488 510 

489<h3 id="remote-control-requires-the-anthropic-api">511<h3 id="remote-control-requires-the-anthropic-api">


496Remote Control is only available when using Claude via api.anthropic.com.518Remote Control is only available when using Claude via api.anthropic.com.

497```519```

498 520 

499Это появляется на Amazon Bedrock, Google Vertex AI и Microsoft Foundry. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, это также появляется, когда [`ANTHROPIC_BASE_URL`](/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, такой как [LLM gateway](/ru/llm-gateway) или прокси, даже когда вы входите с помощью claude.ai.521Это появляется на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, это также появляется, когда [`ANTHROPIC_BASE_URL`](/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, такой как [LLM gateway](/ru/llm-gateway) или прокси, даже если вы входите с claude.ai.

500 522 

501**Что делать:**523**Что делать:**

502 524 

503* Отмените установку `ANTHROPIC_BASE_URL` и перезапустите сеанс, или запустите Remote Control из сеанса, который взаимодействует с Anthropic API напрямую525* Отмените установку `ANTHROPIC_BASE_URL` и перезагрузите сеанс, или запустите Remote Control из сеанса, который взаимодействует с Anthropic API напрямую

504* Для этого и других сообщений запуска Remote Control см. [Troubleshoot Remote Control](/ru/remote-control#troubleshooting)526* Для этого и других сообщений запуска Remote Control см. [Troubleshoot Remote Control](/ru/remote-control#troubleshooting)

505 527 

506<h3 id="oauth-token-revoked-or-expired">528<h3 id="oauth-token-revoked-or-expired">


517 539 

518**Что делать:**540**Что делать:**

519 541 

520* Запустите `/login`, чтобы войти снова542* Запустите `/login` для повторного входа

521* Если ошибка возвращается в том же сеансе после повторной аутентификации, сначала запустите `/logout`, чтобы полностью очистить сохраненный токен, затем `/login`543* Если ошибка возвращается в том же сеансе после повторной аутентификации, сначала запустите `/logout` для полной очистки сохраненного токена, затем `/login`

522* Для повторных запросов на вход между запусками см. проверки системных часов и macOS Keychain в [Troubleshooting](/ru/troubleshoot-install#not-logged-in-or-token-expired)544* Для повторных запросов на вход при запусках см. проверки системных часов и macOS Keychain в [Troubleshooting](/ru/troubleshoot-install#not-logged-in-or-token-expired)

523* Для других сбоев, включая `403 Forbidden` и проблемы с браузером OAuth, см. [Login and authentication](/ru/troubleshoot-install#login-and-authentication)545* Для других сбоев, включая `403 Forbidden` и проблемы с браузером OAuth, см. [Login and authentication](/ru/troubleshoot-install#login-and-authentication)

524 546 

525<h3 id="oauth-scope-requirement">547<h3 id="oauth-scope-requirement">

526 OAuth scope requirement548 OAuth scope requirement

527</h3>549</h3>

528 550 

529Сохраненный токен предшествует требованию области разрешений, которое требует более новая функция. Вы видите это чаще всего из `/usage` и индикатора использования строки состояния:551Сохраненный токен предшествует области разрешений, которая требуется более новой функции. Вы видите это чаще всего из `/usage` и индикатора использования в строке состояния:

530 552 

531```text theme={null}553```text theme={null}

532OAuth token does not meet scope requirement: user:profile554OAuth token does not meet scope requirement: user:profile


534 556 

535**Что делать:**557**Что делать:**

536 558 

537* Запустите `/login`, чтобы создать новый токен с текущими областями. Вам не нужно сначала выходить.559* Запустите `/login` для получения нового токена с текущими областями. Вам не нужно предварительно выходить.

538 560 

539<h3 id="aws-credentials-expired-or-invalid">561<h3 id="aws-credentials-expired-or-invalid">

540 AWS credentials expired or invalid562 AWS credentials expired or invalid

541</h3>563</h3>

542 564 

543{/* min-version: 2.1.198 */}Это сообщение требует Claude Code v2.1.198 или позже и появляется только когда [`awsAuthRefresh`](/ru/amazon-bedrock#advanced-credential-configuration) установлена в вашем файле параметров. Ваш токен сеанса AWS истек или был отклонен, и автоматическое обновление, которое Claude Code уже запустила, не произвело учетные данные, которые API принимает. Это появляется на 401 от [Claude Platform on AWS](/ru/claude-platform-on-aws) или [Mantle endpoint](/ru/amazon-bedrock#use-the-mantle-endpoint), что является тем, как эти провайдеры сообщают об истекшем токене безопасности.565{/* min-version: 2.1.198 */}Это сообщение требует Claude Code версии 2.1.198 или более поздней и появляется только когда [`awsAuthRefresh`](/ru/amazon-bedrock#advanced-credential-configuration) установлен в вашем файле параметров. Ваш токен сеанса AWS истек или был отклонен, и автоматическое обновление, которое уже запустил Claude Code, не создало учетные данные, которые API принимает. Это появляется при 401 от [Claude Platform on AWS](/ru/claude-platform-on-aws) или [Mantle endpoint](/ru/amazon-bedrock#use-the-mantle-endpoint), что является тем, как эти провайдеры сообщают об истекшем токене безопасности.

544 566 

545Подсказка действия в середине называет команду `awsAuthRefresh` из ваших параметров, поэтому она варьируется. Стабильная часть — это ведущий `AWS credentials expired or invalid`:567Подсказка действия в середине называет команду `awsAuthRefresh` из ваших параметров, поэтому она варьируется. Стабильная часть — это начальная `AWS credentials expired or invalid`:

546 568 

547```text theme={null}569```text theme={null}

548AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...570AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

549```571```

550 572 

551Без настроенного `awsAuthRefresh`, тот же 401 показывает общее сообщение `Please run /login` вместо этого, которое не может обновить учетные данные AWS.573Без настроенного `awsAuthRefresh`, тот же 401 показывает вместо этого общее сообщение `Please run /login`, которое не может обновить учетные данные AWS.

552 574 

553**Что делать:**575**Что делать:**

554 576 

555* Запустите команду `awsAuthRefresh`, названную в сообщении, такую как `aws sso login --profile myprofile`, в другом терминале и завершите вход в браузер, затем повторите попытку577* Запустите команду `awsAuthRefresh`, названную в сообщении, такую как `aws sso login --profile myprofile`, в другом терминале и завершите вход в браузер, затем повторите попытку

556* В интерактивном сеансе запустите `/login`, выберите **3rd-party platform**, затем выберите **Claude Platform on AWS · refresh credentials** под **Using 3rd-party platforms**, чтобы запустить ту же команду без перезапуска Claude Code. См. [Configure AWS credentials](/ru/claude-platform-on-aws#1-configure-aws-credentials)578* В интерактивном сеансе запустите `/login`, выберите **3rd-party platform**, затем выберите **Claude Platform on AWS · refresh credentials** в разделе **Using 3rd-party platforms** для запуска той же команды без перезагрузки Claude Code. См. [Configure AWS credentials](/ru/claude-platform-on-aws#1-configure-aws-credentials)

557* Если ошибка повторяется после успешного выполнения команды обновления, подтвердите, что идентификатор действителен вне Claude Code с помощью `aws sts get-caller-identity` в той же оболочке и профиле579* Если ошибка повторяется после успешного выполнения команды обновления, подтвердите, что идентификатор действителен вне Claude Code с помощью `aws sts get-caller-identity` в той же оболочке и профиле

558 580 

559<h3 id="aws-authentication-failed">581<h3 id="aws-authentication-failed">

560 AWS authentication failed582 AWS authentication failed

561</h3>583</h3>

562 584 

563{/* min-version: 2.1.198 */}Это сообщение требует Claude Code v2.1.198 или позже и появляется только когда [`awsAuthRefresh`](/ru/amazon-bedrock#advanced-credential-configuration) установлена в вашем файле параметров. Ваш провайдер AWS вернул 403, или [Amazon Bedrock](/ru/amazon-bedrock) вернула 401.585{/* min-version: 2.1.198 */}Это сообщение требует Claude Code версии 2.1.198 или более поздней и появляется только когда [`awsAuthRefresh`](/ru/amazon-bedrock#advanced-credential-configuration) установлен в вашем файле параметров. Ваш провайдер AWS вернул 403, или [Amazon Bedrock](/ru/amazon-bedrock) вернул 401.

564 586 

565Claude Code не может определить, какую причину вы получили. Amazon Bedrock сообщает об истекшем токене безопасности как 403, но 403 также является тем, как она сообщает об отказе в авторизации, такой как `AccessDeniedException` из отсутствующего разрешения IAM или модели, которая не включена для вашей учетной записи.587Claude Code не может определить, какую причину вы получили. Amazon Bedrock сообщает об истекшем токене безопасности как 403, но 403 также является тем, как он сообщает об отказе в авторизации, такой как `AccessDeniedException` из-за отсутствующего разрешения IAM или модели, которая не включена для вашей учетной записи.

566 588 

567401 от Amazon Bedrock также попадает сюда, а не под [AWS credentials expired or invalid](#aws-credentials-expired-or-invalid), потому что Bedrock не сообщает об истекшем токене как 401. 401 от этой конечной точки обычно поступает из чего-то еще в пути запроса, такого как корпоративный прокси.589401 от Amazon Bedrock также попадает сюда, а не в [AWS credentials expired or invalid](#aws-credentials-expired-or-invalid), потому что Amazon Bedrock не сообщает об истекшем токене как 401. 401 от этой конечной точки обычно поступает из чего-то другого в пути запроса, такого как корпоративный прокси.

568 590 

569Обновление учетных данных исправляет истекший токен и не может исправить другие причины, поэтому сообщение предлагает оба:591Обновление учетных данных исправляет истекший токен и не может исправить другие причины, поэтому сообщение предлагает оба:

570 592 


572AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...594AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

573```595```

574 596 

575Подсказка действия в середине называет команду `awsAuthRefresh` из ваших параметров, поэтому она варьируется. Стабильная часть — это ведущий `AWS authentication failed`.597Подсказка действия в середине называет команду `awsAuthRefresh` из ваших параметров, поэтому она варьируется. Стабильная часть — это начальная `AWS authentication failed`.

576 598 

577**Что делать:**599**Что делать:**

578 600 

579* Запустите команду `awsAuthRefresh`, названную в сообщении, или `aws sso login`, на случай, если истекшие учетные данные являются причиной601* Запустите команду `awsAuthRefresh`, названную в сообщении, или `aws sso login`, на случай, если причиной является истекшие учетные данные

580* Если ваши учетные данные текущие, подтвердите разрешения IAM в [IAM configuration](/ru/amazon-bedrock#iam-configuration) прикреплены к идентификатору, который вы используете, и что выбранная модель включена для вашей учетной записи и региона602* Если ваши учетные данные актуальны, подтвердите, что разрешения IAM в [IAM configuration](/ru/amazon-bedrock#iam-configuration) присоединены к идентификатору, который вы используете, и что выбранная модель включена для вашей учетной записи и региона

581* Запустите `aws sts get-caller-identity`, чтобы подтвердить, какой идентификатор используют ваши запросы; устаревший `AWS_PROFILE` или профиль по умолчанию — это распространенная причина несоответствия разрешений603* Запустите `aws sts get-caller-identity` для подтверждения того, какой идентификатор используют ваши запросы; устаревший `AWS_PROFILE` или профиль по умолчанию — это частая причина несоответствия разрешений

582 604 

583<h2 id="network-and-connection-errors">605<h2 id="network-and-connection-errors">

584 Network and connection errors606 Ошибки сети и подключения

585</h2>607</h2>

586 608 

587Эти ошибки означают, что сетевой запрос от Claude Code не смог достичь пункта назначения. Они обычно исходят из вашей локальной сети, прокси или брандмауэра, или из политики сети облачной среды.609Эти ошибки означают, что сетевой запрос от Claude Code не смог достичь пункта назначения. Обычно они возникают в вашей локальной сети, прокси или брандмауэре, либо в политике сети облачной среды.

588 610 

589<h3 id="unable-to-connect-to-api">611<h3 id="unable-to-connect-to-api">

590 Unable to connect to API612 Unable to connect to API

591</h3>613</h3>

592 614 

593Соединение TCP с API не удалось или никогда не завершилось.615TCP-соединение с API не удалось или никогда не завершилось.

594 616 

595```text theme={null}617```text theme={null}

596Unable to connect to API. Check your internet connection618Unable to connect to API. Check your internet connection


601Request timed out. Check your internet connection and proxy settings623Request timed out. Check your internet connection and proxy settings

602```624```

603 625 

604Распространенные причины включают отсутствие доступа в Интернет, VPN, который блокирует `api.anthropic.com`, или требуемый корпоративный прокси, который не настроен.626Распространённые причины включают отсутствие доступа в Интернет, VPN, который блокирует `api.anthropic.com`, или требуемый корпоративный прокси, который не настроен.

605 627 

606**Что делать:**628**Что делать:**

607 629 

608* Подтвердите, что вы можете достичь хоста API из той же оболочки, запустив `curl -I https://api.anthropic.com`. На Windows PowerShell используйте `curl.exe -I https://api.anthropic.com`, чтобы встроенный псевдоним `Invoke-WebRequest` не использовался.630* Убедитесь, что вы можете достичь хоста API из той же оболочки, выполнив `curl -I https://api.anthropic.com`. В Windows PowerShell используйте `curl.exe -I https://api.anthropic.com`, чтобы встроенный псевдоним `Invoke-WebRequest` не использовался.

609* Если вы находитесь за корпоративным прокси, установите `HTTPS_PROXY` перед запуском Claude Code и см. [Network configuration](/ru/network-config)631* Если вы находитесь за корпоративным прокси, установите `HTTPS_PROXY` перед запуском Claude Code и см. [Конфигурация сети](/ru/network-config)

610* Если вы маршрутизируете через шлюз LLM или ретранслятор, установите [`ANTHROPIC_BASE_URL`](/ru/env-vars) на его адрес. См. [Connect Claude Code to an LLM gateway](/ru/llm-gateway-connect) для настройки.632* Если вы маршрутизируете через шлюз LLM или ретранслятор, установите [`ANTHROPIC_BASE_URL`](/ru/env-vars) на его адрес. См. [Подключение Claude Code к шлюзу LLM](/ru/llm-gateway-connect) для настройки.

611* Убедитесь, что ваш брандмауэр разрешает хосты, перечисленные в [Network access requirements](/ru/network-config#network-access-requirements)633* Убедитесь, что ваш брандмауэр разрешает хосты, указанные в [Требования к доступу в сеть](/ru/network-config#network-access-requirements)

612* Прерывистые сбои [автоматически повторяются](#automatic-retries); постоянные сбои указывают на проблему локальной сети634* Перебойные сбои [автоматически повторяются](#automatic-retries); постоянные сбои указывают на локальную проблему с сетью

613 635 

614Если `curl` успешен, но Claude Code все еще не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:636Если `curl` работает успешно, но Claude Code всё ещё не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:

615 637 

616* На Linux и WSL проверьте `/etc/resolv.conf` на недостижимый сервер имен. WSL в частности может наследовать неработающий распознаватель от хоста.638* На Linux и WSL проверьте `/etc/resolv.conf` на наличие недостижимого сервера имён. WSL в частности может унаследовать неработающий распознаватель от хоста.

617* На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте `ifconfig` на устаревшие интерфейсы `utun` и удалите расширение сети VPN в System Settings.639* На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте `ifconfig` на наличие устаревших интерфейсов `utun` и удалите сетевое расширение VPN в Параметрах системы.

618* Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.640* Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.

619 641 

620<h3 id="ssl-certificate-errors">642<h3 id="ssl-certificate-errors">

621 SSL certificate errors643 SSL certificate errors

622</h3>644</h3>

623 645 

624Прокси или устройство безопасности в вашей сети перехватывает трафик TLS с собственным сертификатом, и Claude Code ему не доверяет.646Прокси или устройство безопасности в вашей сети перехватывает трафик TLS с помощью собственного сертификата, и Claude Code ему не доверяет.

625 647 

626```text theme={null}648```text theme={null}

627Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates649Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates

628Unable to connect to API: Self-signed certificate detected650Unable to connect to API: Self-signed certificate detected

629```651```

630 652 

631{/* min-version: 2.1.199 */}Начиная с версии 2.1.199, сбой проверки сертификата не повторяется, поэтому эта ошибка появляется при первой попытке вместо полного [retry budget](#automatic-retries). Более ранние версии повторяли попытку несколько минут перед отображением. Временные условия TLS, такие как тайм-аут рукопожатия, все еще повторяются.653{/* min-version: 2.1.199 */}Начиная с версии 2.1.199, сбой проверки сертификата не повторяется, поэтому эта ошибка появляется при первой попытке вместо того, чтобы появиться после полного [бюджета повторных попыток](#automatic-retries). Более ранние версии потратили несколько минут на повторные попытки перед её отображением. Переходящие условия TLS, такие как истечение времени ожидания при установлении соединения, всё ещё повторяются.

632 654 

633Во время `/login` и проверки подключения при запуске тот же сбой сообщается с кодом OpenSSL и исправлением в строке:655Во время `/login` и проверки подключения при запуске тот же сбой сообщается с кодом OpenSSL и исправлением в строке:

634 656 

635```text theme={null}657```text theme={null}

636SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run /doctor for details.658SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.

637```659```

638 660 

639**Что делать:**661**Что делать:**

640 662 

641* Экспортируйте пакет CA вашей организации и укажите Claude Code на него с помощью `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`663* Экспортируйте пакет CA вашей организации и укажите Claude Code на него с помощью `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`

642* См. [Network configuration](/ru/network-config#custom-ca-certificates) для полных инструкций по настройке664* См. [Конфигурация сети](/ru/network-config#custom-ca-certificates) для полных инструкций по настройке

643* Не устанавливайте `NODE_TLS_REJECT_UNAUTHORIZED=0`, что полностью отключает проверку сертификата665* Не устанавливайте `NODE_TLS_REJECT_UNAUTHORIZED=0`, что полностью отключает проверку сертификата

644 666 

645<h3 id="host-not-allowed-in-a-cloud-session">667<h3 id="host-not-allowed-in-a-cloud-session">

646 Host not allowed in a cloud session668 Host not allowed in a cloud session

647</h3>669</h3>

648 670 

649Исходящий HTTP-запрос из облачной сессии или процедуры был заблокирован политикой сети среды.671Исходящий HTTP-запрос из облачной сессии или подпрограммы был заблокирован политикой сети среды.

650 672 

651```text theme={null}673```text theme={null}

652HTTP 403674HTTP 403

653x-deny-reason: host_not_allowed675x-deny-reason: host_not_allowed

654```676```

655 677 

656Вы также можете увидеть сертификат TLS, который не соответствует реальному сертификату пункта назначения. Облачная среда маршрутизирует исходящий трафик через прокси, который применяет политику сети, поэтому несоответствующий сертификат означает, что прокси прервал соединение, а не пункт назначения.678Вы также можете увидеть сертификат TLS, который не соответствует реальному сертификату пункта назначения. Облачная среда маршрутизирует исходящий трафик через прокси, который применяет политику сети, поэтому несоответствующий сертификат означает, что прокси завершил соединение, а не пункт назначения.

657 679 

658Это не проблема сети на стороне клиента. Облачные сессии и [routines](/ru/routines) работают внутри изолированной среды, исходящий трафик которой фильтруется в соответствии со списком разрешений среды. Среда **Default** использует доступ **Trusted**, который разрешает [список разрешений по умолчанию](/ru/claude-code-on-the-web#default-allowed-domains) реестров пакетов, API поставщиков облачных услуг, реестров контейнеров и распространенных доменов разработки, но блокирует все остальное.680Это не проблема сети на стороне клиента. Облачные сессии и [подпрограммы](/ru/routines) работают внутри изолированной среды, исходящий трафик которой фильтруется в соответствии со списком разрешений среды. Среда **Default** использует доступ **Trusted**, который разрешает [список разрешений по умолчанию](/ru/claude-code-on-the-web#default-allowed-domains) реестров пакетов, API поставщиков облачных услуг, реестров контейнеров и распространённых доменов разработки, но блокирует всё остальное.

659 681 

660**Что делать:**682**Что делать:**

661 683 

662* Откройте процедуру для редактирования или запустите облачную сессию. Выберите значок облака, показывающий имя вашей среды, например **Default**, чтобы открыть селектор. Наведите указатель на вашу среду и нажмите значок параметров.684* Откройте подпрограмму для редактирования или запустите облачную сессию. Выберите облачный значок, показывающий имя вашей среды, например **Default**, чтобы открыть селектор. Наведите указатель на вашу среду и нажмите значок параметров.

663* В диалоговом окне **Update cloud environment** измените **Network access** с **Trusted** на **Custom**, затем добавьте заблокированный домен в **Allowed domains**. Введите один домен в строку. Установите флажок **Also include default list of common package managers**, чтобы сохранить [список разрешений по умолчанию](/ru/claude-code-on-the-web#default-allowed-domains) вместе с вашими пользовательскими доменами. Выберите **Full** вместо этого, если вы хотите неограниченный доступ.685* В диалоговом окне **Update cloud environment** измените **Network access** с **Trusted** на **Custom**, затем добавьте заблокированный домен в **Allowed domains**. Введите один домен в строку. Установите флажок **Also include default list of common package managers**, чтобы сохранить [список разрешений по умолчанию](/ru/claude-code-on-the-web#default-allowed-domains) вместе с вашими пользовательскими доменами. Выберите **Full** вместо этого, если вы хотите неограниченный доступ.

664* Нажмите **Save changes**. Следующий запуск использует обновленный список разрешений.686* Нажмите **Save changes**. Следующий запуск использует обновленный список разрешений.

665 687 

666См. [Network access](/ru/claude-code-on-the-web#network-access) для уровней доступа и списка разрешений по умолчанию. Локальные сессии CLI не затронуты этой политикой.688См. [Доступ в сеть](/ru/claude-code-on-the-web#network-access) для уровней доступа и списка разрешений по умолчанию. Локальные сессии CLI не затронуты этой политикой.

689 

690<h3 id="couldn’t-reconnect-to-your-remote-control-session">

691 Couldn't reconnect to your Remote Control session

692</h3>

693 

694```text theme={null}

695Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

696```

697 

698Возобновление с помощью `claude --resume` или `claude --continue` переподключается к сессии [Remote Control](/ru/remote-control), записанной в этом разговоре. Это сообщение означает, что переподключение не удалось по причине, которая может быть временной, такой как сетевой сбой или ошибка сервера, поэтому Claude Code не может подтвердить, существует ли удалённая сессия. Ваша локальная сессия продолжает работать без Remote Control.

699 

700**Что делать:**

701 

702* Запустите `/remote-control` для повторной попытки подключения

703* Запустите Claude Code без `--resume` для создания новой сессии Remote Control

704* Для других сообщений при запуске Remote Control см. [Troubleshoot Remote Control](/ru/remote-control#troubleshooting)

705 

706Вы не увидите это сообщение, когда сервер подтвердит, что предыдущая сессия больше не существует; Claude Code создаст новую в этом случае. {/* min-version: 2.1.200 */}До версии 2.1.200 любой сбой переподключения создавал новую сессию Remote Control, которая оставляла дополнительные сессии в списке сессий на claude.ai/code.

667 707 

668<h2 id="request-errors">708<h2 id="request-errors">

669 Request errors709 Ошибки запроса

670</h2>710</h2>

671 711 

672Эти ошибки означают, что API получила ваш запрос, но отклонила его содержимое.712Эти ошибки связаны с содержимым вашего запроса. Большинство из них возвращаются API после отклонения запроса; несколько производятся локально Claude Code перед отправкой запроса.

673 713 

674<h3 id="prompt-is-too-long">714<h3 id="prompt-is-too-long">

675 Prompt is too long715 Prompt is too long

676</h3>716</h3>

677 717 

678Разговор плюс прикрепленные файлы превышают контекстное окно модели.718Разговор плюс прикреплённые файлы превышают контекстное окно модели.

679 719 

680```text theme={null}720```text theme={null}

681Prompt is too long721Prompt is too long


683 723 

684**Что делать:**724**Что делать:**

685 725 

686* Запустите `/compact`, чтобы суммировать более ранние ходы и освободить место, или `/clear`, чтобы начать заново726* Запустите `/compact` для суммирования предыдущих ходов и освобождения места, или `/clear` для начала заново

687* Запустите `/context`, чтобы увидеть разбивку того, что потребляет окно: системный запрос, инструменты, файлы памяти и сообщения727* Запустите `/context` для просмотра разбивки того, что потребляет окно: системный prompt, инструменты, файлы памяти и сообщения

688* Отключите MCP servers, которые вы не используете, с помощью `/mcp disable <name>`, чтобы удалить их определения инструментов из контекста728* Отключите MCP серверы, которые вы не используете, с помощью `/mcp disable <name>` для удаления их определений инструментов из контекста

689* Обрежьте большие файлы памяти `CLAUDE.md`, или переместите инструкции в [path-scoped rules](/ru/memory#path-specific-rules), которые загружаются только при необходимости729* Обрежьте большие файлы памяти `CLAUDE.md`, или переместите инструкции в [правила с областью действия пути](/ru/memory#path-specific-rules), которые загружаются только при необходимости

690* Подагенты наследуют каждое определение инструмента MCP от родительского сеанса, что может заполнить их контекстное окно перед первым ходом. Отключите MCP servers, которые вы не используете, перед созданием подагентов.730* Подагенты наследуют каждое определение инструмента MCP из родительской сессии, что может заполнить их контекстное окно до первого хода. Отключите MCP серверы, которые вы не используете, перед созданием подагентов.

691* Auto-compact включен по умолчанию и обычно предотвращает эту ошибку. Если вы установили [`DISABLE_AUTO_COMPACT`](/ru/env-vars), повторно включите его или запустите `/compact` вручную перед заполнением окна.731* Auto-compact включен по умолчанию и обычно предотвращает эту ошибку. Если вы установили [`DISABLE_AUTO_COMPACT`](/ru/env-vars), переактивируйте его или запустите `/compact` вручную перед заполнением окна.

692 732 

693См. [Explore the context window](/ru/context-window) для интерактивного просмотра того, как заполняется контекст.733Смотрите [Explore the context window](/ru/context-window) для интерактивного просмотра того, как заполняется контекст.

694 734 

695<h3 id="error-during-compaction-conversation-too-long">735<h3 id="error-during-compaction-conversation-too-long">

696 Error during compaction: Conversation too long736 Error during compaction: Conversation too long

697</h3>737</h3>

698 738 

699`/compact` сама не удалась, потому что недостаточно свободного контекста для хранения создаваемого ею резюме.739`/compact` сам по себе не удался, потому что недостаточно свободного контекста для хранения создаваемого им резюме.

700 740 

701```text theme={null}741```text theme={null}

702Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.742Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

703```743```

704 744 

705Это может произойти, когда окно уже полно в момент срабатывания auto-compact, или когда вы запускаете `/compact` после просмотра `Prompt is too long`.745Это может произойти, когда окно уже полно в момент срабатывания auto-compact, или когда вы запускаете `/compact` после появления `Prompt is too long`.

706 746 

707**Что делать:**747**Что делать:**

708 748 

709* Нажмите Esc дважды, чтобы открыть список сообщений и вернуться на несколько ходов назад. Это удаляет самые последние сообщения из контекста. Затем запустите `/compact` снова.749* Нажмите Esc дважды, чтобы открыть список сообщений и вернуться на несколько ходов назад. Это удаляет самые последние сообщения из контекста. Затем запустите `/compact` снова.

710* Если отступление не освобождает достаточно места, запустите `/clear`, чтобы начать свежий сеанс. Ваш предыдущий разговор сохраняется и может быть переоткрыт с помощью `/resume`.750* Если отступление не освобождает достаточно места, запустите `/clear` для начала новой сессии. Ваш предыдущий разговор сохраняется и может быть переоткрыт с помощью `/resume`.

711 751 

712<h3 id="request-too-large">752<h3 id="request-too-large">

713 Request too large753 Request too large

714</h3>754</h3>

715 755 

716Исходное тело запроса превысило лимит байтов API перед токенизацией, обычно из-за большого вставленного файла или вложения.756Тело необработанного запроса превысило лимит байтов API перед токенизацией, обычно из-за большого вставленного файла или вложения.

717 757 

718```text theme={null}758```text theme={null}

719Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.759Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.

720```760```

721 761 

722Это лимит размера на HTTP запрос, отдельный от [context window limit](#prompt-is-too-long).762Это ограничение размера HTTP запроса, отдельное от [лимита контекстного окна](#prompt-is-too-long).

723 763 

724**Что делать:**764**Что делать:**

725 765 

726* Нажмите Esc дважды и вернитесь назад перед ходом, который добавил переразмеренное содержимое766* Нажмите Esc дважды и вернитесь на несколько ходов назад, пройдя ход, который добавил содержимое с избыточным размером

727* Ссылайтесь на большие файлы по пути вместо вставки их содержимого, чтобы Claude могла читать их по частям767* Ссылайтесь на большие файлы по пути вместо вставки их содержимого, чтобы Claude мог читать их по частям

728* Для изображений см. [Image was too large](#image-was-too-large) ниже768* Для изображений смотрите [Image was too large](#image-was-too-large) ниже

729 769 

730<h3 id="image-was-too-large">770<h3 id="image-was-too-large">

731 Image was too large771 Image was too large

732</h3>772</h3>

733 773 

734Вставленное или прикрепленное изображение превышает лимиты размера или размеров API.774Вставленное или прикреплённое изображение превышает ограничения размера или размеров API.

735 775 

736```text theme={null}776```text theme={null}

737Image was too large. Double press esc to go back and try again with a smaller image.777Image was too large. Double press esc to go back and try again with a smaller image.

738API Error: 400 ... image dimensions exceed max allowed size778API Error: 400 ... image dimensions exceed max allowed size

739```779```

740 780 

741{/* min-version: 2.1.142 */}Claude Code заменяет необработанное изображение текстовым заполнителем и повторяет попытку, поэтому последующие сообщения успешны. В версиях до 2.1.142 вставленное изображение могло остаться в разговоре и повторить ту же ошибку при каждом последующем сообщении. Чтобы восстановиться в этих версиях, нажмите Esc дважды и вернитесь назад перед ходом, где было добавлено изображение.781{/* min-version: 2.1.142 */}Claude Code заменяет необработанное изображение текстовым заполнителем и повторяет попытку, поэтому последующие сообщения успешны. В версиях до 2.1.142 вставленное изображение могло остаться в разговоре и повторять одну и ту же ошибку при каждом последующем сообщении. Для восстановления в этих версиях нажмите Esc дважды и вернитесь на несколько ходов назад, пройдя ход, где было добавлено изображение.

742 782 

743**Что делать:**783**Что делать:**

744 784 

745* Измените размер изображения перед вставкой. API принимает изображения до 8000 пикселей на самой длинной стороне для одного изображения или 2000 пикселей, когда в контексте много изображений.785* Измените размер изображения перед вставкой. API принимает изображения размером до 8000 пикселей по самому длинному краю для одного изображения, или 2000 пикселей, когда в контексте много изображений.

746* Сделайте более плотный скриншот соответствующего региона вместо полного экрана786* Сделайте более плотный скриншот соответствующей области вместо полного экрана

747 787 

748<h3 id="unable-to-resize-image">788<h3 id="unable-to-resize-image">

749 Unable to resize image789 Unable to resize image

750</h3>790</h3>

751 791 

752Claude Code не смог уменьшить масштаб прикрепленного изображения перед отправкой его в API.792Claude Code не смог уменьшить масштаб прикреплённого изображения перед отправкой его в API.

753 793 

754```text theme={null}794```text theme={null}

755Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.795Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.


762 802 

763**Что делать:**803**Что делать:**

764 804 

765* Если сообщение просит вас преобразовать изображение, преобразуйте его в PNG, JPEG, GIF или WebP и прикрепите его снова. Claude Code может проверить размеры для этих форматов без обработчика изображений.805* Если сообщение просит вас преобразовать изображение, преобразуйте его в PNG, JPEG, GIF или WebP и прикрепите снова. Claude Code может проверить размеры для этих форматов без обработчика изображений.

766* Если сообщение сообщает о лимите размера или размеров, измените размер или перекомпрессируйте изображение ниже этого лимита перед прикреплением.806* Если сообщение сообщает об ограничении размера или размеров, измените размер или перекомпрессируйте изображение ниже этого лимита перед прикреплением.

767 807 

768<h3 id="pdf-errors">808<h3 id="pdf-errors">

769 PDF errors809 PDF errors

770</h3>810</h3>

771 811 

772PDF, который вы прикрепили, не удалось обработать.812Прикреплённый PDF не удалось обработать.

773 813 

774```text theme={null}814```text theme={null}

775PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.815PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.


779 819 

780**Что делать:**820**Что делать:**

781 821 

782* Для больших PDF-файлов попросите Claude прочитать диапазон страниц с помощью инструмента Read вместо прикрепления всего файла, или извлеките текст с помощью инструмента, такого как `pdftotext`, и ссылайтесь на выходной файл по пути822* Для больших PDF попросите Claude прочитать диапазон страниц с помощью инструмента Read вместо прикрепления всего файла, или извлеките текст с помощью инструмента, такого как `pdftotext`, и ссылайтесь на выходной файл по пути

783* Для защищенных или недействительных PDF-файлов удалите пароль или повторно экспортируйте файл из исходного приложения, затем попробуйте еще раз823* Для защищённых или недействительных PDF удалите пароль или переэкспортируйте файл из исходного приложения, затем попробуйте снова

784 824 

785<h3 id="extra-inputs-are-not-permitted">825<h3 id="extra-inputs-are-not-permitted">

786 Extra inputs are not permitted826 Extra inputs are not permitted

787</h3>827</h3>

788 828 

789Прокси или шлюз LLM между Claude Code и API удалили заголовок запроса `anthropic-beta`, поэтому API отклонила поля, которые от него зависят.829Прокси или LLM шлюз между Claude Code и API удалил заголовок запроса `anthropic-beta`, поэтому API отклонил поля, которые от него зависят.

790 830 

791```text theme={null}831```text theme={null}

792API Error: 400 ... Extra inputs are not permitted ... context_management832API Error: 400 ... Extra inputs are not permitted ... context_management


794API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header834API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header

795```835```

796 836 

797Claude Code отправляет поля, доступные только в бета-версии, такие как `context_management`, `effort` и инструмент `input_examples`, вместе с заголовком `anthropic-beta`, который их включает. Когда шлюз пересылает тело, но удаляет заголовок, API видит поля, которые она не распознает.837Claude Code отправляет поля только для бета-версии, такие как `context_management`, `effort` и примеры инструментов `input_examples`, вместе с заголовком `anthropic-beta`, который их включает. Когда шлюз пересылает тело, но удаляет заголовок, API видит поля, которые он не распознаёт.

798 838 

799**Что делать:**839**Что делать:**

800 840 

801* Настройте ваш шлюз для пересылки заголовка `anthropic-beta`. См. [feature pass-through](/ru/llm-gateway-protocol#feature-pass-through) для информации о том, что шлюзы должны пересылать.841* Настройте ваш шлюз для пересылки заголовка `anthropic-beta`. Смотрите [feature pass-through](/ru/llm-gateway-protocol#feature-pass-through) для того, что шлюзы должны пересылать.

802* В качестве резервного варианта установите [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ru/env-vars) перед запуском. Это отключает функции, требующие заголовка бета-версии, чтобы запросы успешно проходили через шлюз, который не может его пересылать.842* В качестве резервного варианта установите [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ru/env-vars) перед запуском. Это отключает функции, которые требуют заголовка бета-версии, чтобы запросы успешно проходили через шлюз, который не может его пересылать.

803 843 

804<h3 id="there’s-an-issue-with-the-selected-model">844<h3 id="there’s-an-issue-with-the-selected-model">

805 There's an issue with the selected model845 There's an issue with the selected model

806</h3>846</h3>

807 847 

808Настроенное имя модели не было распознано или ваша учетная запись не имеет доступа к ней. Начиная с v2.1.160 подсказка в конце, показанная здесь в интерактивной форме, варьируется в зависимости от поверхности.848Имя настроенной модели не было распознано, или ваша учётная запись не имеет доступа к ней. Начиная с v2.1.160 конечная подсказка, показанная здесь в её интерактивной форме, варьируется в зависимости от поверхности.

809 849 

810```text theme={null}850```text theme={null}

811There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.851There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.


813 853 

814**Что делать:**854**Что делать:**

815 855 

816* **Interactive CLI**: запустите `/model`, чтобы выбрать из моделей, доступных вашей учетной записи.856* **Interactive CLI**: запустите `/model` для выбора из моделей, доступных вашей учётной записи.

817* **Non-interactive mode (`-p`)**: передайте `--model` с действительным псевдонимом или ID, или установите [`ANTHROPIC_MODEL`](/ru/env-vars). Текст ошибки показывает `Run --model` на этой поверхности.857* **Non-interactive mode (`-p`)**: передайте `--model` с действительным псевдонимом или ID, или установите [`ANTHROPIC_MODEL`](/ru/env-vars). Текст ошибки показывает `Run --model` на этой поверхности.

818* **Agent SDK**: текст ошибки опускает подсказку, потому что модель установлена программно. Установите [`model` на `Options`](/ru/agent-sdk/typescript#options) в TypeScript или [`ClaudeAgentOptions(model=...)`](/ru/agent-sdk/python#claudeagentoptions) в Python, и обработайте структурированную ошибку `model_not_found`, чтобы отобразить вашу собственную повторную попытку или средство выбора модели.858* **Agent SDK**: текст ошибки опускает подсказку, потому что модель установлена программно. Установите [`model` на `Options`](/ru/agent-sdk/typescript#options) в TypeScript или [`ClaudeAgentOptions(model=...)`](/ru/agent-sdk/python#claudeagentoptions) в Python, и обработайте структурированную ошибку `model_not_found` для отображения вашего собственного повтора или средства выбора модели.

819* Используйте псевдоним, такой как `sonnet` или `opus`, вместо полного версионного ID. Псевдонимы отслеживают последний выпуск, поэтому они не устаревают. См. [Model configuration](/ru/model-config).859* Используйте псевдоним, такой как `sonnet` или `opus`, вместо полного версионного ID. Псевдонимы разрешаются в поддерживаемое значение по умолчанию, поэтому они не устаревают. Смотрите [Model configuration](/ru/model-config).

820* Если неправильная модель продолжает возвращаться в CLI, где-то установлен устаревший ID. Проверьте в [порядке приоритета](/ru/model-config#setting-your-model): флаг `--model`, переменная окружения `ANTHROPIC_MODEL`, затем поле `model` в `.claude/settings.local.json`, файл `.claude/settings.json` вашего проекта и `~/.claude/settings.json`. Удалите устаревшее значение, и Claude Code вернется к стандартной модели вашей учетной записи.860* Если неправильная модель продолжает возвращаться в CLI, где-то установлен устаревший ID. Проверьте в [порядке приоритета](/ru/model-config#setting-your-model): флаг `--model`, переменная окружения `ANTHROPIC_MODEL`, затем поле `model` в `.claude/settings.local.json`, файл вашего проекта `.claude/settings.json` и `~/.claude/settings.json`. Удалите устаревшее значение, и Claude Code вернётся к умолчанию вашей учётной записи.

821* Для развертываний Vertex AI см. [Vertex AI troubleshooting](/ru/google-vertex-ai#troubleshooting).861* Для развёртываний Google Cloud's Agent Platform смотрите [Google Cloud's Agent Platform troubleshooting](/ru/google-vertex-ai#troubleshooting).

862 

863<h3 id="model-is-not-a-recognized-model-id">

864 Model is not a recognized model id

865</h3>

866 

867Строка модели, которую вы передали переключателю модели, не является псевдонимом модели, ID модели, который знает эта версия Claude Code, или ID, который начинается с `claude-`. Обычные причины — опечатка в ID, отображаемое имя, такое как `Sonnet 5`, где ожидается ID `claude-sonnet-5`, или псевдоним, который распознают только более новые версии Claude Code. Claude Code немедленно отклоняет переключение. До v2.1.200 Claude Code сохранял строку и не удавался при следующем запросе с [There's an issue with the selected model](#there%E2%80%99s-an-issue-with-the-selected-model).

868 

869```text theme={null}

870Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

871```

872 

873Конечная подсказка называет ближайший совпадающий псевдоним или ID модели. Когда ничего не совпадает достаточно близко, она читает `Run /model to see available models.` вместо этого.

874 

875Claude Code производит эту ошибку локально в момент запроса переключения, перед любым запросом API. Она применяется, когда модель установлена через метод [Agent SDK](/ru/agent-sdk/typescript) `setModel()` или приложением, таким как [Desktop app](/ru/desktop), которое запускает Claude Code CLI для вас.

876 

877**Что делать:**

878 

879* Запустите `/model` без аргумента, чтобы открыть средство выбора и выбрать из моделей, доступных вашей учётной записи, затем передайте показанный там псевдоним или ID

880* Если вы использовали псевдоним, который поддерживает более новая версия Claude Code, запустите `claude update`. Полный ID, который начинается с `claude-`, проходит эту проверку даже когда модель новее вашей версии Claude Code, поэтому обновление не требуется для них.

881* Модель, сохранённая до v2.1.200, не восстанавливается этой проверкой. Если устаревшее значение продолжает возвращаться, удалите его из мест, перечисленных в [There's an issue with the selected model](#there%E2%80%99s-an-issue-with-the-selected-model).

882* Проверка выполняется только на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/ru/claude-platform-on-aws) и за [LLM gateway](/ru/llm-gateway) или пользовательским `ANTHROPIC_BASE_URL`, ваш поставщик или шлюз определяет имена моделей, поэтому Claude Code принимает любую строку и пропускает её.

822 883 

823<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">884<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">

824 Claude Opus is not available with the Claude Pro plan885 Claude Opus is not available with the Claude Pro plan


833**Что делать:**894**Что делать:**

834 895 

835* Запустите `/model` и выберите модель, которую включает ваш план896* Запустите `/model` и выберите модель, которую включает ваш план

836* Если вы недавно обновили свой план и все еще видите это, запустите `/logout`, затем `/login`. Сохраненный токен отражает ваш план на момент входа, поэтому обновление в Интернете не вступает в силу в существующем сеансе, пока вы не повторно аутентифицируетесь.897* Если вы недавно обновили свой план и всё ещё видите это, запустите `/logout`, затем `/login`. Сохранённый токен отражает ваш план на момент входа, поэтому обновление в интернете не вступает в силу в существующей сессии до переаутентификации.

837* См. [claude.com/pricing](https://claude.com/pricing) для информации о том, какие модели включает каждый план898* Смотрите [claude.com/pricing](https://claude.com/pricing) для того, какие модели включает каждый план

838 899 

839<h3 id="model-is-restricted-by-your-organization’s-settings">900<h3 id="model-is-restricted-by-your-organization’s-settings">

840 Model is restricted by your organization's settings901 Model is restricted by your organization's settings

841</h3>902</h3>

842 903 

843Администратор вашей организации отключил эту модель в консоли Claude, или она исключена списком [`availableModels`](/ru/model-config#restrict-model-selection) в управляемых параметрах. Когда ограниченная модель была установлена с помощью `--model`, `ANTHROPIC_MODEL` или параметра `model`, Claude Code подставляет разрешенную модель и продолжает. Ввод `/model <name>` для ограниченной модели отклоняется с `Run /model to choose a different model.` и сеанс сохраняет свою текущую модель.904Администратор вашей организации отключил эту модель в консоли администратора claude.ai, или она исключена [`availableModels`](/ru/model-config#restrict-model-selection) списком разрешений в управляемых параметрах. Когда ограниченная модель была установлена с `--model`, `ANTHROPIC_MODEL` или параметром `model`, Claude Code подставляет разрешённую модель и продолжает. Ввод `/model <name>` для ограниченной модели отклоняется с `Run /model to choose a different model.` и сессия сохраняет свою текущую модель.

844 905 

845```text theme={null}906```text theme={null}

846Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.907Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

847```908```

848 909 

910Claude Code рассматривает псевдоним семейства моделей, один из `opus`, `sonnet`, `haiku` или `fable`, как запрос для этого семейства, а не для его новейшей версии. На Anthropic API и на [Claude Platform on AWS](/ru/claude-platform-on-aws) ограниченный псевдоним семейства разрешается в новейшую версию семейства, которую разрешают ваша организация и список разрешений `availableModels`, и уведомление о подстановке называет эту версию. Claude Code отклоняет `/model <alias>` только когда каждая версия семейства ограничена. До v2.1.205 псевдоним семейства был подставлен или отклонен на основе только его новейшей версии, даже когда была разрешена более старая версия того же семейства.

911 

849**Что делать:**912**Что делать:**

850 913 

851* Запустите `/model`, чтобы выбрать из моделей, которые разрешает ваша организация. Ограниченные модели скрыты от средства выбора.914* Запустите `/model` для выбора из моделей, которые разрешает ваша организация. Ограниченные модели скрыты от средства выбора.

852* Если ограниченная модель была установлена в `--model`, `ANTHROPIC_MODEL` или поле `model` файла параметров, удалите или обновите это значение, чтобы уведомление не повторялось при каждом запуске915* Если ограниченная модель была установлена в `--model`, `ANTHROPIC_MODEL` или поле `model` файла параметров, удалите или обновите это значение, чтобы уведомление не повторялось при каждом запуске

853* Если вам нужен доступ к ограниченной модели, попросите администратора вашей организации включить ее. См. [Organization model restrictions](/ru/model-config#organization-model-restrictions).916* Если вам нужен доступ к ограниченной модели, попросите администратора вашей организации включить её. Смотрите [Organization model restrictions](/ru/model-config#organization-model-restrictions).

854 917 

855<h3 id="thinking-type-enabled-is-not-supported-for-this-model">918<h3 id="thinking-type-enabled-is-not-supported-for-this-model">

856 thinking.type.enabled is not supported for this model919 thinking.type.enabled is not supported for this model

857</h3>920</h3>

858 921 

859Ваша версия Claude Code старше минимальной для Sonnet 5, Opus 4.8 или Opus 4.7. CLI отправила конфигурацию thinking, которую модель больше не принимает.922Ваша версия Claude Code старше минимума для Sonnet 5, Opus 4.8 или Opus 4.7. CLI отправил конфигурацию мышления, которую модель больше не принимает.

860 923 

861```text theme={null}924```text theme={null}

862API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.925API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.


864 927 

865**Что делать:**928**Что делать:**

866 929 

867* Запустите `claude update` и перезапустите Claude Code. Opus 4.7 требует v2.1.111 или позже. Opus 4.8 требует v2.1.154 или позже. Sonnet 5 требует v2.1.197 или позже930* Запустите `claude update` и перезагрузите Claude Code. Opus 4.7 требует v2.1.111 или позже. Opus 4.8 требует v2.1.154 или позже. Sonnet 5 требует v2.1.197 или позже

868* Если вы не можете обновиться, запустите `/model` и выберите Opus 4.6 или Sonnet 4.6 вместо этого931* Если вы не можете обновиться, запустите `/model` и выберите Opus 4.6 или Sonnet 4.6 вместо этого

869* {/* min-version: agent-sdk@0.3.197 */}Если вы столкнулись с этим в [Agent SDK](/ru/agent-sdk/overview), обновите пакет SDK вместо этого. Opus 4.8 требует TypeScript SDK v0.3.154 или позже и Python SDK v0.2.88 или позже. Sonnet 5 требует TypeScript SDK v0.3.197 или позже932* {/* min-version: agent-sdk@0.3.197 */}Если вы столкнулись с этим в [Agent SDK](/ru/agent-sdk/overview), обновите пакет SDK вместо этого. Opus 4.8 требует TypeScript SDK v0.3.154 или позже и Python SDK v0.2.88 или позже. Sonnet 5 требует TypeScript SDK v0.3.197 или позже

870 933 


872 Thinking budget exceeds output limit935 Thinking budget exceeds output limit

873</h3>936</h3>

874 937 

875Настроенный бюджет расширенного thinking превышает максимальную длину ответа, поэтому для фактического ответа не осталось места.938Настроенный бюджет расширенного мышления превышает максимальную длину ответа, поэтому для фактического ответа не остаётся места.

876 939 

877```text theme={null}940```text theme={null}

878API Error: 400 ... max_tokens must be greater than thinking.budget_tokens941API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

879```942```

880 943 

881Claude Code автоматически регулирует эти значения на Anthropic API. Вы обычно видите эту ошибку на Amazon Bedrock или Google Vertex AI, когда [`MAX_THINKING_TOKENS`](/ru/env-vars) установлена выше лимита вывода провайдера, или когда Plan Mode повышает бюджет thinking.944Claude Code автоматически регулирует эти значения на Anthropic API. Вы обычно видите эту ошибку на Amazon Bedrock или Google Cloud's Agent Platform, когда [`MAX_THINKING_TOKENS`](/ru/env-vars) установлен выше лимита вывода поставщика, или когда режим плана повышает бюджет мышления.

882 945 

883**Что делать:**946**Что делать:**

884 947 

885* Понизьте `MAX_THINKING_TOKENS`, или повысьте [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/ru/env-vars) выше бюджета thinking948* Понизьте `MAX_THINKING_TOKENS`, или повысьте [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/ru/env-vars) выше бюджета мышления

886* См. [Extended thinking](/ru/model-config#extended-thinking) для информации о том, как бюджет взаимодействует с длиной вывода949* Смотрите [Extended thinking](/ru/model-config#extended-thinking) для того, как бюджет взаимодействует с длиной вывода

887 950 

888<h3 id="tool-use-or-thinking-block-mismatch">951<h3 id="tool-use-or-thinking-block-mismatch">

889 Tool use or thinking block mismatch952 Tool use or thinking block mismatch

890</h3>953</h3>

891 954 

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

893 956 

894```text theme={null}957```text theme={null}

895API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.958API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.


897API Error: 400 ... thinking blocks ... cannot be modified960API Error: 400 ... thinking blocks ... cannot be modified

898```961```

899 962 

900Все три варианта означают одно и то же: последовательность блоков `tool_use`, `tool_result` и `thinking` в истории больше не соответствует тому, что ожидает API.963Все три варианта означают одно и то же: последовательность блоков `tool_use`, `tool_result` и `thinking` в истории больше не совпадает с тем, что ожидает API.

901 964 

902**Что делать:**965**Что делать:**

903 966 

904* {/* max-version: 2.1.155 */}Если вы используете Opus 4.7 или Opus 4.8, сначала запустите `claude update`. Версии до v2.1.156 могут вызвать эту ошибку при обычном использовании инструментов, и `/rewind` не очищает ее.967* {/* max-version: 2.1.155 */}Если вы используете Opus 4.7 или Opus 4.8, сначала запустите `claude update`. Версии до v2.1.156 могут вызвать эту ошибку при нормальном использовании инструмента, и `/rewind` её не очищает.

905* Запустите `/rewind`, или нажмите Esc дважды, чтобы вернуться к checkpoint перед поврежденным ходом и продолжить оттуда. См. [Checkpointing](/ru/checkpointing) для информации о том, как создаются и восстанавливаются checkpoints.968* Запустите `/rewind`, или нажмите Esc дважды, чтобы вернуться к контрольной точке перед повреждённым ходом и продолжить оттуда. Смотрите [Checkpointing](/ru/checkpointing) для того, как создаются и восстанавливаются контрольные точки.

906 969 

907<h3 id="usage-policy-refusal">970<h3 id="usage-policy-refusal">

908 Usage Policy refusal971 Usage Policy refusal

909</h3>972</h3>

910 973 

911API отказалась отвечать, потому что содержимое в разговоре вызвало проверку [Usage Policy](https://www.anthropic.com/legal/aup). Сообщение включает Request ID, который вы можете привести в поддержку, если считаете, что отказ неправильный.974API отказался отвечать, потому что содержимое в разговоре вызвало проверку [Usage Policy](https://www.anthropic.com/legal/aup). Сообщение включает ID запроса, который вы можете цитировать в поддержку, если вы считаете, что отказ неправильный.

912 975 

913```text theme={null}976```text theme={null}

914API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.977API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

915```978```

916 979 

917Проверка оценивает весь разговор, а не только ваш последний запрос, поэтому отправка нового сообщения в том же сеансе обычно повторно вызывает тот же отказ. То же самое применяется после выхода и повторного открытия сеанса с `--continue` или `--resume`, так как стенограмма на диске все еще содержит вызывающее содержимое.980Проверка оценивает весь разговор, а не только ваш последний prompt, поэтому отправка нового сообщения в той же сессии обычно повторно вызывает тот же отказ. То же самое применяется после выхода и переоткрытия сессии с `--continue` или `--resume`, так как стенограмма на диске всё ещё содержит вызывающее содержимое. На [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) и [Microsoft Foundry](/ru/microsoft-foundry) это сообщение также охватывает запросы, которые меры безопасности модели отметили как тему кибербезопасности. Смотрите [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).

981 

982**Что делать:**

983 

984* Нажмите Esc дважды или запустите `/rewind` для возврата к контрольной точке перед ходом, который вызвал отказ, затем переформулируйте или примите другой подход. Смотрите [Checkpointing](/ru/checkpointing).

985* Если вы не можете определить, какой ход вызвал это, запустите `/clear` для начала новой разговора в том же проекте. Ваш предыдущий разговор сохраняется на диске и остаётся доступным в `/resume`.

986* В [non-interactive mode](/ru/headless) (`-p`), где перемотка недоступна, повторите попытку с переформулированным prompt в новой сессии без `--continue`. Проверки политики варьируются в зависимости от модели, поэтому переключение на другую модель с `--model` также может разрешить отказ в некоторых случаях.

987 

988<h3 id="safety-measures-flagged-a-cybersecurity-topic">

989 Safety measures flagged a cybersecurity topic

990</h3>

991 

992Меры безопасности модели отметили содержимое в разговоре как тему кибербезопасности. Сообщение называет модель, которая отметила запрос:

993 

994```text theme={null}

995API Error: Opus 4.8 has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude.

996 

997If you were not engaging in a cybersecurity topic, please send feedback via /feedback.

998```

999 

1000Сообщение ссылается на [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), который предоставляет доступ для законной работы в области кибербезопасности. Сама защита находится на стороне сервера и предшествует v2.1.203; этот выпуск изменил только формулировку сообщения и страницу, на которую оно ссылается.

1001 

1002То, что вы видите, зависит от вашего поставщика и режима:

1003 

1004* На [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) и [Microsoft Foundry](/ru/microsoft-foundry) флаг кибербезопасности производит сообщение [Usage Policy refusal](#usage-policy-refusal) вместо этого.

1005* [Non-interactive mode](/ru/headless) опускает предложение `/feedback`.

1006 

1007{/* max-version: 2.1.202 */}До v2.1.203 сообщение читалось `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` с последующей ссылкой на форму исключения.

1008 

1009**Что делать:**

1010 

1011* Если ваша работа требует этого содержимого, подайте заявку на доступ через [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)

1012* Если ваш запрос не был о теме кибербезопасности, запустите `/feedback` для сообщения о ложном срабатывании

1013* Чтобы продолжить работу в той же сессии, нажмите Esc дважды или запустите `/rewind` для возврата к контрольной точке перед ходом, который вызвал флаг, затем примите другой подход. Смотрите [Checkpointing](/ru/checkpointing).

1014 

1015<h2 id="installation-errors">

1016 Ошибки установки

1017</h2>

1018 

1019Эти ошибки появляются при установке или обновлении Claude Code из [скрипта установки](/ru/setup#install-claude-code), `claude install` или `claude update`. Для проблем с `command not found`, PATH, разрешениями и TLS во время установки см. [Устранение неполадок установки и входа](/ru/troubleshoot-install).

1020 

1021<h3 id="installation-was-killed-before-it-could-finish">

1022 Установка была прервана до завершения

1023</h3>

1024 

1025Скрипт установки сообщает, когда этап `claude install` завершается сигналом. На Linux код выхода 137 означает, что процесс получил SIGKILL, а на хосте с низким объёмом памяти это обычно означает, что ядро активировало средство защиты от нехватки памяти (OOM killer). Скрипт выводит это объяснение и завершается с кодом 137:

1026 

1027```text theme={null}

1028Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

1029Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

1030```

1031 

1032Для любого другого фатального сигнала и для кода выхода 137 на macOS скрипт выводит `Installation was killed before it could finish (exit code <N>)` с фактическим кодом выхода и опускает объяснение о нехватке памяти. Сообщение поступает из скрипта установки, который используют macOS и Linux, и также охватывает установки внутри WSL; встроенные скрипты установки Windows никогда его не выводят. До версии 2.1.200 скрипт завершался только с простой строкой `Killed` оболочки.

1033 

1034**Что делать:**

1035 

1036* Остановите другие процессы, чтобы освободить память, затем повторно запустите установщик

1037* Добавьте пространство подкачки или перейдите на экземпляр большего размера. См. [Установка прервана на серверах Linux с низким объёмом памяти](/ru/troubleshoot-install#install-killed-on-low-memory-linux-servers) для команд файла подкачки.

1038 

1039<h3 id="the-connection-dropped-while-downloading-the-update">

1040 Соединение разорвалось при загрузке обновления

1041</h3>

1042 

1043Соединение с сервером загрузки закрылось, пока `claude install`, `claude update` или [автоматический обновитель](/ru/setup#auto-updates) загружал двоичный файл Claude Code, и повторные попытки не восстановили соединение. Claude Code повторяет загрузку, когда соединение разрывается, передача зависает или загруженный файл не проходит проверку контрольной суммы, всего до трёх попыток. Завершённая ошибка HTTP, такая как 404, не повторяется, потому что сервер уже ответил. {/* min-version: 2.1.202 */}До версии 2.1.202 одно разорванное соединение немедленно приводило к сбою загрузки с простой ошибкой `aborted` вместо повторной попытки.

1044 

1045```text theme={null}

1046The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

1047```

1048 

1049Текст в скобках указывает, какая попытка не удалась, и основную ошибку сети. `claude update` предваряет сообщение с `Error: Failed to install native update` на stderr.

1050 

1051Загрузка, которая остаётся подключённой, но не завершается в течение 10 минут, завершается с ошибкой `Download timed out: exceeded the total deadline`. Claude Code не повторяет истёкшую по времени загрузку, потому что соединение, которое слишком медленно для завершения в установленный срок, не завершится и при немедленной повторной попытке. Приведённые ниже шаги применяются к обоим сообщениям. До версии 2.1.205 тот же 10-минутный срок сообщался как универсальный `timeout of 600000ms exceeded` HTTP-клиента.

1052 

1053Обычная причина — прокси или шлюз, который закрывает длительную передачу до её завершения. Двоичный файл Claude Code — это большая загрузка, поэтому ограничение соединения прокси, которое никогда не влияет на обычный трафик API, всё равно может его прервать.

918 1054 

919**Что делать:**1055**Что делать:**

920 1056 

921* Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к checkpoint перед ходом, который вызвал отказ, затем переформулируйте или примите другой подход. См. [Checkpointing](/ru/checkpointing).1057* Запустите `claude update` снова. На в остальном здоровой сети загрузка обычно успешна при следующем запуске. Для сообщения об истечении времени запустите его снова из более быстрой или менее ограниченной сети.

922* Если вы не можете определить, какой ход вызвал это, запустите `/clear`, чтобы начать свежий разговор в том же проекте. Ваш предыдущий разговор сохраняется на диске и остается доступным в `/resume`.1058* Если ваша сеть требует прокси, установите `HTTPS_PROXY` перед запуском установщика или `claude update`. См. [Проверка подключения к сети](/ru/troubleshoot-install#check-network-connectivity).

923* В [non-interactive mode](/ru/headless) (`-p`), где перемотка недоступна, повторите попытку с переформулированным запросом в новом сеансе без `--continue`. Проверки политики варьируются в зависимости от модели, поэтому переключение на другую модель с помощью `--model` также может разрешить отказ в некоторых случаях.1059* Если корпоративный прокси продолжает закрывать передачу, попросите вашу команду сети разрешить полную загрузку с `downloads.claude.ai`. См. [Требования к доступу в сеть](/ru/network-config#network-access-requirements).

1060* Запустите `claude doctor` из вашей оболочки для диагностики установки

924 1061 

925<h2 id="command-line-errors">1062<h2 id="command-line-errors">

926 Command-line errors1063 Ошибки командной строки

927</h2>1064</h2>

928 1065 

929Эти ошибки исходят из собственной проверки Claude Code команды `claude`. Claude Code выводит их немедленно, перед созданием сеанса или отправкой любого запроса API.1066Эти ошибки поступают из командной строки `claude` и её подкоманд. Claude Code выводит их перед запуском вашего запроса или отправкой любого запроса API.

930 1067 

931<h3 id="conflict-between-bg-and-print">1068<h3 id="conflict-between-bg-and-print">

932 Conflict between --bg and --print1069 Конфликт между --bg и --print

933</h3>1070</h3>

934 1071 

935Это сообщение требует Claude Code v2.1.198 или позже. Вы объединили `--bg` с `-p` или `--print` в одном вызове `claude`. `--bg` запускает [background session](/ru/agent-view#from-your-shell), к которому вы позже присоединяетесь с помощью `claude agents`, в то время как `--print` работает [non-interactively](/ru/headless) и никогда не запускает интерактивный сеанс, к которому `claude agents` присоединяется. До версии 2.1.198 эта комбинация молча создавала фоновое задание, которое никогда не могло быть присоединено.1072Это сообщение требует 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 эта комбинация молча создавала фоновое задание, которое никогда не удавалось подключить.

936 1073 

937```text theme={null}1074```text theme={null}

938--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.1075--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.


940 1077 

941**Что делать:**1078**Что делать:**

942 1079 

943* Удалите `-p` или `--print`. `--bg` принимает запрос как позиционный аргумент, поэтому `claude --bg "<task>"` — это полная команда. См. [Dispatch new agents from your shell](/ru/agent-view#from-your-shell).1080* Удалите `-p` или `--print`. `--bg` принимает запрос в качестве позиционального аргумента, поэтому `claude --bg "<task>"` — это полная команда. См. [Dispatch new agents from your shell](/ru/agent-view#from-your-shell).

944* Чтобы запустить запрос неинтерактивно и вывести результат вместо создания фонового сеанса, удалите `--bg` и запустите `claude -p "<task>"`1081* Чтобы запустить запрос неинтерактивно и вывести результат вместо создания фонового сеанса, удалите `--bg` и запустите `claude -p "<task>"`

945 1082 

1083<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

1084 Значение --json-schema не является допустимой JSON Schema

1085</h3>

1086 

1087Схема, которую вы передали в [`--json-schema`](/ru/cli-reference#cli-flags) в [неинтерактивном режиме](/ru/headless#get-structured-output), не прошла компиляцию JSON Schema, поэтому `claude` завершает работу с кодом 1 вместо запуска запроса. До версии v2.1.205 недопустимая схема выдавала неструктурированный вывод без ошибки, и любая схема, использующая ключевое слово `format`, считалась недопустимой.

1088 

1089```text theme={null}

1090Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

1091```

1092 

1093Текст после второго двоеточия — это диагностика валидатора и указывает на ключевое слово или местоположение, которое не прошло проверку. Схемы, использующие ключевое слово `format`, такие как `"format": "email"`, являются допустимыми: Claude Code принимает `format` как аннотацию и не применяет её.

1094 

1095Claude Code выполняет две проверки перед компиляцией схемы: он отклоняет значение, которое не является парсируемым JSON, с помощью `Error: --json-schema is not valid JSON`, и допустимый JSON, который не является объектом, с помощью `Error: --json-schema must be a JSON object`.

1096 

1097**Что делать:**

1098 

1099* Исправьте часть схемы, которую указывает диагностика, затем повторно запустите команду

1100* Если диагностика — `schema too large`, уменьшите вложенность схемы и повторное использование `$ref`

1101* См. [Get structured output](/ru/headless#get-structured-output) для рабочей схемы и команды

1102 

1103<h3 id="could-not-import-a-server-from-claude-desktop">

1104 Не удалось импортировать сервер из Claude Desktop

1105</h3>

1106 

1107Claude Code не смог добавить один из серверов, которые вы выбрали в `claude mcp add-from-claude-desktop`. Команда по-прежнему импортирует другие выбранные серверы и выводит одну строку для каждого сервера, который не удалось добавить. До версии v2.1.205 первый сервер, который не прошёл проверку, останавливал импорт и ни один из выбранных серверов не был добавлен.

1108 

1109```text theme={null}

1110Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

1111```

1112 

1113Текст после имени сервера — это причина. Наиболее распространённая — проверка имени: Claude Desktop допускает символы в именах серверов, такие как пробелы и точки, которые `claude mcp` ограничивает буквами, цифрами, дефисами и подчёркиваниями. Другие причины включают конфигурацию сервера, которая не прошла валидацию, и сервер, заблокированный [политикой MCP](/ru/managed-mcp) вашей организации.

1114 

1115**Что делать:**

1116 

1117* Переименуйте сервер в `claude_desktop_config.json`, используя только буквы, цифры, дефисы и подчёркивания, затем снова запустите `claude mcp add-from-claude-desktop`

1118* Добавьте этот сервер напрямую с помощью `claude mcp add` или `claude mcp add-json` под допустимым именем. См. [Import MCP servers from Claude Desktop](/ru/mcp#import-mcp-servers-from-claude-desktop).

1119 

1120<h2 id="plugin-errors">

1121 Ошибки плагинов

1122</h2>

1123 

1124Эти ошибки возникают из конфигурации [плагинов](/ru/plugins) и [маркетплейсов](/ru/plugin-marketplaces). Для проблем с плагинами, которые не производят одно из сообщений на этой странице, таких как URL маркетплейса, который не загружается, или плагин, который устанавливается, но не появляется, см. [Устранение неполадок плагинов](/ru/discover-plugins#troubleshooting).

1125 

1126<h3 id="marketplace-is-registered-from-an-untrusted-source">

1127 Marketplace зарегистрирован из ненадежного источника

1128</h3>

1129 

1130Маркетплейс зарегистрирован под именем, которое [зарезервировано для официальных маркетплейсов Anthropic](/ru/plugin-marketplaces#marketplace-schema), но его зарегистрированный источник не является репозиторием GitHub `anthropics`. Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке или обновлении маркетплейса, поэтому маркетплейс и плагины, установленные из него, перестают загружаться. До версии 2.1.205 имя проверялось только при добавлении маркетплейса, поэтому запись, зарегистрированная до того, как ее имя было зарезервировано, продолжала загружаться.

1131 

1132```text theme={null}

1133Marketplace "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.

1134```

1135 

1136**Что делать:**

1137 

1138* Запустите `claude plugin marketplace remove <name>`, затем снова добавьте маркетплейс из официального репозитория `github.com/anthropics`

1139* Если вы публикуете сторонний маркетплейс, который использовал имя до того, как оно было зарезервировано, переименуйте его и попросите пользователей повторно добавить его из вашего источника

1140* См. список зарезервированных имен в разделе [Marketplace schema](/ru/plugin-marketplaces#marketplace-schema)

1141 

1142<h2 id="configuration-warnings">

1143 Предупреждения о конфигурации

1144</h2>

1145 

1146Claude Code выводит эти сообщения в stderr при запуске, а не показывает ошибку в диалоговом окне. Они сообщают о конфигурации, которую он прочитал, но не применил.

1147 

1148<h3 id="workspace-has-not-been-trusted">

1149 Рабочее пространство не было доверено

1150</h3>

1151 

1152Claude Code обнаружил правила `permissions.allow` или записи `permissions.additionalDirectories` в файле `.claude/settings.json` или `.claude/settings.local.json` проекта и не применил их, потому что [правила разрешения из параметров проекта требуют доверия рабочему пространству](/ru/permissions#project-allow-rules-and-workspace-trust). Количество, имя параметра и имя файла в сообщении варьируются в зависимости от вашей конфигурации. Правила `deny` и `ask` не затронуты.

1153 

1154```text theme={null}

1155Ignoring 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.

1156```

1157 

1158**Что делать:**

1159 

1160* Запустите `claude` в каталоге и примите диалоговое окно доверия. {/* min-version: 2.1.200 */}Диалоговое окно появляется даже если родительский каталог уже доверен, отображает удерживаемые правила и позволяет вам отклонить их и продолжить работу без них. До версии 2.1.200 в этой ситуации диалоговое окно не появлялось, поэтому этот шаг не мог быть завершен там.

1161* В [неинтерактивном режиме](/ru/headless) с флагом `-p` диалоговое окно не показывается. Установите запись `hasTrustDialogAccepted` в `~/.claude.json`, используя точный ключ `projects`, который выводит сообщение.

1162* {/* 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).

1163 

946<h2 id="responses-seem-lower-quality-than-usual">1164<h2 id="responses-seem-lower-quality-than-usual">

947 Responses seem lower quality than usual1165 Ответы кажутся менее качественными, чем обычно

948</h2>1166</h2>

949 1167 

950Если ответы Claude кажутся менее способными, чем вы ожидаете, но ошибка не отображается, причина обычно в состоянии разговора, а не в самой модели. Claude Code не молча меняет версии моделей. Она может переключиться на резервную модель в трёх конкретных случаях:1168Если ответы Claude кажутся менее способными, чем вы ожидаете, но ошибка не отображается, причина обычно заключается в состоянии разговора, а не в самой модели. Claude Code не молча меняет версии модели. Он может переключиться на резервную модель в трёх конкретных случаях:

1169 

1170* Настроенный [`--fallback-model`](/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке

1171* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна

1172* [Автоматический откат модели](/ru/model-config#automatic-model-fallback) на Fable 5 переводит сеанс на модель Opus по умолчанию и показывает уведомление в расшифровке

951 1173 

952* Настроенный [`--fallback-model`](/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности, только для этого хода, с уведомлением в стенограмме1174Проверка выбора модели ниже перехватывает второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/ru/model-config) объясняет, когда применяется каждый откат.

953* Проверка запуска Bedrock или Vertex AI обнаруживает, что ваша модель по умолчанию недоступна

954* [Automatic model fallback](/ru/model-config#automatic-model-fallback) на Fable 5 перемещает сеанс на модель Opus по умолчанию и показывает уведомление в стенограмме

955 1175 

956Проверка Model selection ниже ловит второй и третий случаи; первый появляется как уведомление в стенограмме, а не как изменение `/model`. [Model configuration](/ru/model-config) объясняет, когда применяется каждая резервная версия.1176Сначала проверьте следующее:

957 1177 

958Сначала проверьте эти пункты:1178* **Выбор модели**: запустите `/model`, чтобы подтвердить, что вы используете ожидаемую модель. Предыдущий выбор `/model` или переменная окружения `ANTHROPIC_MODEL` могут привести вас к меньшей модели, чем вы предполагали.

1179* **Уровень усилий**: запустите `/effort`, чтобы проверить текущий уровень рассуждений и повысить его для сложной отладки или проектной работы. Значения по умолчанию варьируются в зависимости от модели, поэтому проверьте перед тем, как предполагать, что вы ниже максимума. См. [Adjust effort level](/ru/model-config#adjust-effort-level) для значений по умолчанию для каждой модели и сокращение `ultrathink`.

1180* **Давление контекста**: запустите `/context`, чтобы увидеть, насколько заполнено окно. Если оно близко к ёмкости, запустите `/compact` в естественной точке разрыва или `/clear`, чтобы начать заново. См. [Explore the context window](/ru/context-window) для информации о том, как auto-compact влияет на предыдущие ходы.

1181* **Устаревшие инструкции**: большие или устаревшие файлы `CLAUDE.md` и определения инструментов MCP потребляют контекст и могут направлять ответы. {/* min-version: 2.1.205 */}Проверка `/doctor` отмечает файлы памяти большого размера и неиспользуемые расширения, а `/context` показывает использование токенов инструментов MCP. До версии v2.1.205 `/doctor` открывал экран диагностики, который отмечал файлы памяти большого размера и определения подагентов.

959 1182 

960* **Model selection**: запустите `/model`, чтобы подтвердить, что вы находитесь на модели, которую ожидаете. Предыдущий выбор `/model` или переменная окружения `ANTHROPIC_MODEL` могут поместить вас на меньшую модель, чем вы предполагали.1183Когда ответ идёт неправильно, откат обычно работает лучше, чем ответ с исправлениями. Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к моменту перед неправильным ходом, затем переформулируйте подсказку с большей конкретикой. Исправление в потоке сохраняет неправильную попытку в контексте, что может привязать более поздние ответы к ней. См. [Checkpointing](/ru/checkpointing).

961* **Effort level**: запустите `/effort`, чтобы проверить текущий уровень рассуждений и повысить его для сложной отладки или работы по дизайну. Значения по умолчанию варьируются в зависимости от модели, поэтому проверьте перед предположением, что вы ниже максимума. См. [Adjust effort level](/ru/model-config#adjust-effort-level) для значений по умолчанию для каждой модели и ярлыка `ultrathink`.

962* **Context pressure**: запустите `/context`, чтобы увидеть, насколько полно окно. Если оно близко к ёмкости, запустите `/compact` в естественной точке разрыва или `/clear`, чтобы начать заново. См. [Explore the context window](/ru/context-window) для информации о том, как auto-compact влияет на более ранние ходы.

963* **Stale instructions**: большие или устаревшие файлы `CLAUDE.md` и определения инструментов MCP потребляют контекст и могут направлять ответы. `/doctor` отмечает переразмеренные файлы памяти и определения подагентов; `/context` показывает использование токенов инструментов MCP.

964 1184 

965Когда ответ идет неправильно, откат обычно работает лучше, чем ответ с исправлениями. Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться перед плохим ходом, затем переформулируйте запрос с большей конкретикой. Исправление в потоке сохраняет неправильную попытку в контексте, что может привязать более поздние ответы к ней. См. [Checkpointing](/ru/checkpointing).1185Если качество всё ещё кажется неправильным после проверки вышеуказанного, запустите `/feedback` и опишите, что вы ожидали в сравнении с тем, что вы получили. Обратная связь, отправленная таким образом, включает расшифровку разговора, что является самым быстрым способом для Anthropic диагностировать реальную регрессию. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде.

966 1186 

967Если качество все ещё кажется неправильным после проверки вышеуказанного, запустите `/feedback` и опишите, что вы ожидали в сравнении с тем, что вы получили. Обратная связь, отправленная таким образом, включает стенограмму разговора, что является самым быстрым способом для Anthropic диагностировать реальную регрессию. См. [Report an error](#report-an-error), если `/feedback` недоступна в вашей среде.1187{/* min-version: 2.1.201 */}Если Sonnet 5 отклоняет запрос и ссылается на подозреваемую инъекцию подсказки на Claude Code v2.1.200 или более ранней версии, запустите `claude update`, чтобы получить исправление v2.1.201.

968 1188 

969<h2 id="report-an-error">1189<h2 id="report-an-error">

970 Report an error1190 Сообщить об ошибке

971</h2>1191</h2>

972 1192 

973Для ошибок из компонентов, которые эта страница не охватывает, см. соответствующее руководство:1193Для ошибок компонентов, которые не рассматриваются на этой странице, см. соответствующее руководство:

974 1194 

975* MCP server не удалось подключиться или аутентифицироваться: [MCP](/ru/mcp)1195* Серверу MCP не удалось подключиться или пройти аутентификацию: [MCP](/ru/mcp)

976* Hook script не удалось или заблокировал инструмент: [Debug hooks](/ru/hooks#debug-hooks)1196* Скрипт hook не выполнился или заблокировал инструмент: [Debug hooks](/ru/hooks#debug-hooks)

977* Permission denied или ошибки файловой системы во время установки: [Troubleshoot installation and login](/ru/troubleshoot-install)1197* Отказано в доступе или ошибки файловой системы при установке: [Troubleshoot installation and login](/ru/troubleshoot-install)

978 1198 

979Если ошибка не указана здесь или предложенное исправление не помогает:1199Если ошибка не указана здесь или предложенное исправление не помогает:

980 1200 

981* Запустите `/feedback` внутри Claude Code, чтобы отправить стенограмму и описание в Anthropic. Команда также предлагает открыть предварительно заполненную проблему GitHub. На Bedrock, Vertex AI, Foundry и других поставщиков третьих сторон `/feedback` сохраняет локальный архив, который вы можете отправить своему представителю учетной записи Anthropic.1201* Запустите `/feedback` внутри Claude Code, чтобы отправить стенограмму и описание в Anthropic. Команда также предлагает открыть предварительно заполненную проблему GitHub. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и других сторонних поставщиков `/feedback` сохраняет локальный архив, который вы можете отправить представителю вашей учетной записи Anthropic.

982* Запустите `/doctor`, чтобы проверить проблемы локальной конфигурации1202* Запустите `claude doctor` из вашей оболочки для диагностики только для чтения вашей установки или запустите `/doctor` внутри Claude Code, чтобы найти и исправить проблемы конфигурации

983* Проверьте [status.claude.com](https://status.claude.com) на наличие активных инцидентов1203* Проверьте [status.claude.com](https://status.claude.com) на предмет активных инцидентов

984* Поищите [existing issues](https://github.com/anthropics/claude-code/issues) на GitHub1204* Поищите [существующие проблемы](https://github.com/anthropics/claude-code/issues) на GitHub

fast-mode.md +2 −2

Details

38* Введите `/fast` и нажмите Tab для включения или отключения38* Введите `/fast` и нажмите Tab для включения или отключения

39* Установите `"fastMode": true` в вашем [файле пользовательских настроек](/ru/settings)39* Установите `"fastMode": true` в вашем [файле пользовательских настроек](/ru/settings)

40 40 

41По умолчанию быстрый режим сохраняется между сеансами. Администраторы могут настроить быстрый режим на сброс каждого сеанса. Подробности см. в разделе [обязательное согласие за сеанс](#require-per-session-opt-in).41По умолчанию быстрый режим, который вы включаете в интерактивном сеансе, сохраняется между сеансами. {/* min-version: 2.1.205 */}В [неинтерактивном режиме](/ru/headless) с флагом `-p` команда `/fast` работает только в сеансе, запущенном с быстрым режимом в его значении [`--settings`](/ru/cli-reference#cli-flags), например `claude -p --settings '{"fastMode": true}'`; переключение затем применяется только к этому сеансу и не сохраняется как ваше значение по умолчанию, а в любом другом неинтерактивном сеансе команда сообщает, что быстрый режим недоступен. Администраторы могут настроить быстрый режим на сброс каждого сеанса. Подробности см. в разделе [обязательное согласие за сеанс](#require-per-session-opt-in).

42 42 

43Для лучшей экономичности включайте быстрый режим в начале сеанса, а не переключайтесь в середине разговора. Подробности см. в разделе [понимание компромисса стоимости](#understand-the-cost-tradeoff).43Для лучшей экономичности включайте быстрый режим в начале сеанса, а не переключайтесь в середине разговора. Подробности см. в разделе [понимание компромисса стоимости](#understand-the-cost-tradeoff).

44 44 


103 103 

104Быстрый режим требует всех следующих условий:104Быстрый режим требует всех следующих условий:

105 105 

106* **Только API Anthropic или подписка**: быстрый режим доступен через API Anthropic Console и для планов подписки Claude с использованием дополнительного использования. Он недоступен на Amazon Bedrock, Google Vertex AI, Microsoft Azure Foundry или Claude Platform на AWS.106* **Только API Anthropic или подписка**: быстрый режим доступен через API Anthropic Console и для планов подписки Claude с использованием дополнительного использования. Он недоступен на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS.

107* **Включено дополнительное использование**: ваша учетная запись должна иметь включенное дополнительное использование, которое позволяет выставлять счета сверх включенного использования вашего плана. Для индивидуальных учетных записей включите это в [параметрах выставления счетов Console](https://platform.claude.com/settings/organization/billing). Для Team и Enterprise администратор должен включить дополнительное использование для организации.107* **Включено дополнительное использование**: ваша учетная запись должна иметь включенное дополнительное использование, которое позволяет выставлять счета сверх включенного использования вашего плана. Для индивидуальных учетных записей включите это в [параметрах выставления счетов Console](https://platform.claude.com/settings/organization/billing). Для Team и Enterprise администратор должен включить дополнительное использование для организации.

108 108 

109<Note>109<Note>

Details

4 4 

5# Доступность функций5# Доступность функций

6 6 

7> Сравните, какие функции Claude Code доступны в планах подписки Anthropic, Anthropic Console, Amazon Bedrock, Claude Platform на AWS, Google Vertex AI и Microsoft Foundry.7> Сравните, какие функции Claude Code доступны в планах подписки Anthropic, Anthropic Console, Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform и Microsoft Foundry.

8 8 

9CLI Claude Code и всё, что работает локально, функционирует одинаково у каждого поставщика. Инструкции по настройке для каждого поставщика см. в разделе [Обзор развёртывания для предприятий](/ru/third-party-integrations). Чтобы сразу перейти к тому, что отсутствует у вашего поставщика, см. вкладки [сводки по поставщикам](#summary-by-provider).9CLI Claude Code и всё, что работает локально, функционирует одинаково у каждого поставщика. Инструкции по настройке для каждого поставщика см. в разделе [Обзор развёртывания для предприятий](/ru/third-party-integrations). Чтобы сразу перейти к тому, что отсутствует у вашего поставщика, см. вкладки [сводки по поставщикам](#summary-by-provider).

10 10 


20* **Anthropic Console**: вы аутентифицируетесь с помощью ключа API Anthropic20* **Anthropic Console**: вы аутентифицируетесь с помощью ключа API Anthropic

21* **Amazon Bedrock**: вы используете модели Claude из каталога моделей Bedrock и устанавливаете `CLAUDE_CODE_USE_BEDROCK`. [Конечная точка Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) охватывается этим столбцом21* **Amazon Bedrock**: вы используете модели Claude из каталога моделей Bedrock и устанавливаете `CLAUDE_CODE_USE_BEDROCK`. [Конечная точка Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) охватывается этим столбцом

22* **Claude Platform на AWS**: вы приобрели Claude через AWS Marketplace, но вызываете API Anthropic и устанавливаете `CLAUDE_CODE_USE_ANTHROPIC_AWS`22* **Claude Platform на AWS**: вы приобрели Claude через AWS Marketplace, но вызываете API Anthropic и устанавливаете `CLAUDE_CODE_USE_ANTHROPIC_AWS`

23* **Google Vertex AI**: управляется Google; вы устанавливаете `CLAUDE_CODE_USE_VERTEX`23* **Google Cloud's Agent Platform**: управляется Google; вы устанавливаете `CLAUDE_CODE_USE_VERTEX`

24* **Microsoft Foundry**: управляется Anthropic на Azure; вы устанавливаете `CLAUDE_CODE_USE_FOUNDRY`24* **Microsoft Foundry**: управляется Anthropic на Azure; вы устанавливаете `CLAUDE_CODE_USE_FOUNDRY`

25 25 

26<h3 id="features-available-on-every-provider">26<h3 id="features-available-on-every-provider">


53* [Artifacts](/ru/artifacts): планы Pro, Max, Team и Enterprise53* [Artifacts](/ru/artifacts): планы Pro, Max, Team и Enterprise

54* [Voice dictation](/ru/voice-dictation)54* [Voice dictation](/ru/voice-dictation)

55 55 

56Desktop — частичное исключение: развёртывания Enterprise могут маршрутизировать Desktop на Vertex AI или поставщика шлюза через [управляемые параметры](https://support.claude.com/en/articles/12622667-enterprise-configuration), а [Cowork на 3P research preview](https://claude.com/docs/cowork/3p/overview) запускает вкладку Code на Bedrock, Vertex AI, Foundry или самостоятельно размещённом шлюзе LLM. Для доступности этих функций по плану см. [Доступность по плану подписки](#availability-by-subscription-plan).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).

57 57 

58<h3 id="cli-capabilities-that-vary-by-provider">58<h3 id="cli-capabilities-that-vary-by-provider">

59 Возможности CLI, которые различаются по поставщикам59 Возможности CLI, которые различаются по поставщикам


69 <th>Anthropic Console</th>69 <th>Anthropic Console</th>

70 <th>Amazon Bedrock</th>70 <th>Amazon Bedrock</th>

71 <th>Claude Platform на AWS</th>71 <th>Claude Platform на AWS</th>

72 <th>Google Vertex AI</th>72 <th>Google Cloud's Agent Platform</th>

73 <th>Microsoft Foundry</th>73 <th>Microsoft Foundry</th>

74 </tr>74 </tr>

75 </thead>75 </thead>


161 <th>Anthropic Console</th>161 <th>Anthropic Console</th>

162 <th>Amazon Bedrock</th>162 <th>Amazon Bedrock</th>

163 <th>Claude Platform на AWS</th>163 <th>Claude Platform на AWS</th>

164 <th>Google Vertex AI</th>164 <th>Google Cloud's Agent Platform</th>

165 <th>Microsoft Foundry</th>165 <th>Microsoft Foundry</th>

166 </tr>166 </tr>

167 </thead>167 </thead>


199 </tbody>199 </tbody>

200</table>200</table>

201 201 

202<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> На Vertex AI веб-поиск доступен для моделей Claude 4 и более поздних версий.<br />202<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 />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 />

204<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Явные интервалы, такие как `/loop every 2 hours`, работают у каждого поставщика. На Bedrock, Vertex AI и Foundry `/loop` не может выбрать свой собственный интервал или предоставить подсказку обслуживания по умолчанию, поэтому подсказка без интервала выполняется каждые 10 минут, а `/loop` без аргументов показывает сообщение об использовании. См. [Scheduled tasks](/ru/scheduled-tasks).<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 />

205<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> В соответствии с вашим соглашением с поставщиком облачных услуг.<br />205<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.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.

207 207 


213 Сводка по поставщикам213 Сводка по поставщикам

214</h3>214</h3>

215 215 

216Каждая вкладка содержит список того, что недоступно или частично поддерживается у этого поставщика, с альтернативами, где они существуют. Всё, что не указано, работает так же, как в подписке Claude. На Bedrock, Vertex AI, Foundry и Claude Platform на AWS отчёты об ошибках и телеметрия для Anthropic отключены по умолчанию. См. [поведение по умолчанию по поставщику API](/ru/data-usage#default-behaviors-by-api-provider) для информации о том, какой трафик всё ещё достигает Anthropic и как отказаться.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 и как отказаться.

217 217 

218<Tabs>218<Tabs>

219 <Tab title="Amazon Bedrock">219 <Tab title="Amazon Bedrock">


221 221 

222 **Частичная поддержка:**222 **Частичная поддержка:**

223 223 

224 * [Desktop](/ru/desktop): только через [Cowork на 3P research preview](https://claude.com/docs/cowork/3p/overview)224 * [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`225 * [Auto mode](/ru/auto-mode-config): установите `CLAUDE_CODE_ENABLE_AUTO_MODE`

226 * [`/loop`](/ru/scheduled-tasks): только явные интервалы226 * [`/loop`](/ru/scheduled-tasks): только явные интервалы

227 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением AWS227 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением AWS


232 <Tab title="Claude Platform на AWS">232 <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).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).

234 234 

235 **Доступно** там, где Bedrock недоступен: [веб-поиск](/ru/tools-reference#websearch-tool-behavior), [auto mode](/ru/auto-mode-config) без флага opt-in и [`/loop` self-pacing](/ru/scheduled-tasks).235 **Доступно** там, где Amazon Bedrock недоступен: [веб-поиск](/ru/tools-reference#websearch-tool-behavior), [auto mode](/ru/auto-mode-config) без флага opt-in и [`/loop` self-pacing](/ru/scheduled-tasks).

236 236 

237 **Альтернативы:** для планирования используйте [`/loop`](/ru/scheduled-tasks) вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](/ru/github-actions) или [GitLab CI/CD](/ru/gitlab-ci-cd).237 **Альтернативы:** для планирования используйте [`/loop`](/ru/scheduled-tasks) вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](/ru/github-actions) или [GitLab CI/CD](/ru/gitlab-ci-cd).

238 </Tab>238 </Tab>

239 239 

240 <Tab title="Google Vertex AI">240 <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).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).

242 242 

243 **Частичная поддержка:**243 **Частичная поддержка:**

244 244 

245 * [Desktop](/ru/desktop): через [управляемые параметры](https://support.claude.com/en/articles/12622667-enterprise-configuration) или [Cowork на 3P research preview](https://claude.com/docs/cowork/3p/overview)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)

246 * [Web search](/ru/tools-reference#websearch-tool-behavior): модели Claude 4 и более поздние246 * [Web search](/ru/tools-reference#websearch-tool-behavior): модели Claude 4 и более поздние

247 * [Auto mode](/ru/auto-mode-config): установите `CLAUDE_CODE_ENABLE_AUTO_MODE`247 * [Auto mode](/ru/auto-mode-config): установите `CLAUDE_CODE_ENABLE_AUTO_MODE`

248 * [`/loop`](/ru/scheduled-tasks): только явные интервалы248 * [`/loop`](/ru/scheduled-tasks): только явные интервалы


256 256 

257 **Частичная поддержка:**257 **Частичная поддержка:**

258 258 

259 * [Desktop](/ru/desktop): только через [Cowork на 3P research preview](https://claude.com/docs/cowork/3p/overview)259 * [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`260 * [Auto mode](/ru/auto-mode-config): установите `CLAUDE_CODE_ENABLE_AUTO_MODE`

261 * [`/loop`](/ru/scheduled-tasks): только явные интервалы261 * [`/loop`](/ru/scheduled-tasks): только явные интервалы

262 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением Azure262 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением Azure


275 Доступность по плану подписки275 Доступность по плану подписки

276</h2>276</h2>

277 277 

278Если вы аутентифицируетесь через Bedrock, Vertex AI, Foundry или ключ API Anthropic Console, этот раздел к вам не применяется. Когда вы входите с учётной записью claude.ai, ваш план определяет, какие из приведённых ниже функций доступны.278Если вы аутентифицируетесь через Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или ключ API Anthropic Console, этот раздел к вам не применяется. Когда вы входите с учётной записью claude.ai, ваш план определяет, какие из приведённых ниже функций доступны.

279 279 

280| Функция | Pro | Max | Team | Enterprise |280| Функция | Pro | Max | Team | Enterprise |

281| :-------------------------------------------------------------------------------------- | :-- | :-- | :------------ | :-------------------------------- |281| :-------------------------------------------------------------------------------------- | :-- | :-- | :------------ | :-------------------------------- |


303 Доступность моделей303 Доступность моделей

304</h2>304</h2>

305 305 

306Для информации о том, какие модели Claude и размеры контекстного окна доступны для каждого поставщика и региона, см. [Model configuration](/ru/model-config) и [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, PDF input и extended thinking — это возможности модели, а не функции Claude Code, и работают у каждого поставщика, который предлагает модель. [Prompt caching](/ru/prompt-caching) работает одинаково у большинства поставщиков; на Bedrock поддержка варьируется в зависимости от модели.306Для информации о том, какие модели Claude и размеры контекстного окна доступны для каждого поставщика и региона, см. [Model configuration](/ru/model-config) и [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, PDF input и extended thinking — это возможности модели, а не функции Claude Code, и работают у каждого поставщика, который предлагает модель. [Prompt caching](/ru/prompt-caching) работает одинаково у большинства поставщиков; на Amazon Bedrock поддержка варьируется в зависимости от модели.

307 307 

308<h2 id="related-resources">308<h2 id="related-resources">

309 Связанные ресурсы309 Связанные ресурсы

310</h2>310</h2>

311 311 

312* [Обзор развёртывания для предприятий](/ru/third-party-integrations): сравните аутентификацию, выставление счётов и регионы у поставщиков312* [Обзор развёртывания для предприятий](/ru/third-party-integrations): сравните аутентификацию, выставление счётов и регионы у поставщиков

313* Руководства по настройке поставщиков: [Amazon Bedrock](/ru/amazon-bedrock), [Claude Platform на AWS](/ru/claude-platform-on-aws), [Google Vertex AI](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry)313* Руководства по настройке поставщиков: [Amazon Bedrock](/ru/amazon-bedrock), [Claude Platform на AWS](/ru/claude-platform-on-aws), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry)

314* [Platforms and integrations](/ru/platforms): где работает Claude Code, включая CLI, Desktop, расширения IDE, веб, мобильные устройства и CI/CD314* [Platforms and integrations](/ru/platforms): где работает Claude Code, включая CLI, Desktop, расширения IDE, веб, мобильные устройства и CI/CD

fullscreen.md +3 −1

Details

172 172 

173Полноэкранная визуализация несовместима с режимом интеграции tmux в iTerm2, который является режимом, в который вы входите с помощью `tmux -CC`. В режиме интеграции iTerm2 отображает каждую панель tmux как встроенное разделение вместо того, чтобы позволить tmux рисовать на терминале. Альтернативный буфер экрана и отслеживание мыши не работают правильно там: колесо мыши ничего не делает, и двойной клик может повредить состояние терминала. Не включайте полноэкранную визуализацию в сеансах `tmux -CC`. Обычный tmux внутри iTerm2 без `-CC` работает нормально.173Полноэкранная визуализация несовместима с режимом интеграции tmux в iTerm2, который является режимом, в который вы входите с помощью `tmux -CC`. В режиме интеграции iTerm2 отображает каждую панель tmux как встроенное разделение вместо того, чтобы позволить tmux рисовать на терминале. Альтернативный буфер экрана и отслеживание мыши не работают правильно там: колесо мыши ничего не делает, и двойной клик может повредить состояние терминала. Не включайте полноэкранную визуализацию в сеансах `tmux -CC`. Обычный tmux внутри iTerm2 без `-CC` работает нормально.

174 174 

175tmux не поддерживает синхронизированный вывод, поэтому вы можете видеть больше мерцания во время перерисовки, чем при запуске Claude Code непосредственно в вашем терминале. Если мерцание заметно, особенно по SSH, запустите Claude Code в отдельной вкладке терминала вне tmux.175Не каждая версия tmux применяет синхронизированный вывод из приложений, поэтому вы можете видеть больше мерцания во время перерисовки под tmux, чем при запуске Claude Code непосредственно в вашем терминале. Если мерцание заметно, особенно по SSH, обновитесь до последней версии tmux или запустите Claude Code в отдельной вкладке терминала вне tmux. Проверьте версию tmux с помощью `tmux -V`.

176 

177{/* min-version: 2.1.200 */}Claude Code автоматически включает синхронизированный вывод, когда обнаруживает tmux 3.4 или позже из переменной `TERM_PROGRAM_VERSION`, и переходит к прямому запросу терминала для поддержки синхронизированного вывода, когда версия не может быть определена. Становятся ли перерисовки действительно атомарными, зависит от того, соблюдает ли ваша версия tmux синхронизированный вывод; если вы всё ещё видите мерцание под tmux 3.4 или позже, обновитесь до последней версии tmux. Это обнаружение требует Claude Code v2.1.200 или позже.

176 178 

177<h2 id="keep-native-text-selection">179<h2 id="keep-native-text-selection">

178 Сохранение встроенного выделения текста180 Сохранение встроенного выделения текста

github-actions.md +23 −23

Details

51<Note>51<Note>

52 * Вы должны быть администратором репозитория для установки GitHub app и добавления секретов52 * Вы должны быть администратором репозитория для установки GitHub app и добавления секретов

53 * GitHub app будет запрашивать права на чтение и запись для Contents, Issues и Pull requests53 * GitHub app будет запрашивать права на чтение и запись для Contents, Issues и Pull requests

54 * Этот метод быстрого старта доступен только для прямых пользователей Claude API. Если вы используете Amazon Bedrock или Google Vertex AI, см. раздел [Использование с Amazon Bedrock и Google Vertex AI](#using-with-amazon-bedrock-%26-google-vertex-ai).54 * Этот метод быстрого старта доступен только для прямых пользователей Claude API. Если вы используете Amazon Bedrock или Google Cloud's Agent Platform, см. раздел [Использование с Amazon Bedrock и Google Cloud](#using-with-amazon-bedrock-and-google-cloud).

55</Note>55</Note>

56 56 

57<h2 id="manual-setup">57<h2 id="manual-setup">


320 При ответе на комментарии issue или PR, Claude автоматически отвечает на упоминания @claude. Для других событий используйте параметр `prompt` для предоставления инструкций.320 При ответе на комментарии issue или PR, Claude автоматически отвечает на упоминания @claude. Для других событий используйте параметр `prompt` для предоставления инструкций.

321</Tip>321</Tip>

322 322 

323<h2 id="using-with-amazon-bedrock--google-vertex-ai">323<h2 id="using-with-amazon-bedrock-and-google-cloud">

324 Использование с Amazon Bedrock и Google Vertex AI324 Использование с Amazon Bedrock и Google Cloud

325</h2>325</h2>

326 326 

327Для корпоративных сред вы можете использовать Claude Code GitHub Actions с вашей собственной облачной инфраструктурой. Этот подход даёт вам контроль над местоположением данных и выставлением счётов при сохранении той же функциональности.327Для корпоративных сред вы можете использовать Claude Code GitHub Actions с вашей собственной облачной инфраструктурой. Этот подход даёт вам контроль над местоположением данных и выставлением счётов при сохранении той же функциональности.


332 332 

333Перед настройкой Claude Code GitHub Actions с облачными провайдерами вам нужно:333Перед настройкой Claude Code GitHub Actions с облачными провайдерами вам нужно:

334 334 

335<h4 id="for-google-cloud-vertex-ai">335<h4 id="for-google-cloud’s-agent-platform">

336 Для Google Cloud Vertex AI:336 Для Google Cloud's Agent Platform:

337</h4>337</h4>

338 338 

3391. Проект Google Cloud с включённым Vertex AI3391. Проект Google Cloud с включённым Google Cloud's Agent Platform

3402. Workload Identity Federation, настроенный для GitHub Actions3402. Workload Identity Federation, настроенный для GitHub Actions

3413. Сервисный аккаунт с необходимыми разрешениями3413. Сервисный аккаунт с необходимыми разрешениями

3424. GitHub App (рекомендуется) или использование стандартного GITHUB\_TOKEN3424. GitHub App (рекомендуется) или использование стандартного GITHUB\_TOKEN


347 347 

3481. Аккаунт AWS с включённым Amazon Bedrock3481. Аккаунт AWS с включённым Amazon Bedrock

3492. GitHub OIDC Identity Provider, настроенный в AWS3492. GitHub OIDC Identity Provider, настроенный в AWS

3503. IAM роль с разрешениями Bedrock3503. IAM роль с разрешениями Amazon Bedrock

3514. GitHub App (рекомендуется) или использование стандартного GITHUB\_TOKEN3514. GitHub App (рекомендуется) или использование стандартного GITHUB\_TOKEN

352 352 

353<Steps>353<Steps>

354 <Step title="Создайте пользовательский GitHub App (Рекомендуется для 3P провайдеров)">354 <Step title="Создайте пользовательский GitHub App (Рекомендуется для 3P провайдеров)">

355 Для лучшего контроля и безопасности при использовании 3P провайдеров, таких как Vertex AI или Bedrock, мы рекомендуем создать свой собственный GitHub App:355 Для лучшего контроля и безопасности при использовании 3P провайдеров, таких как Google Cloud's Agent Platform или Amazon Bedrock, мы рекомендуем создать свой собственный GitHub App:

356 356 

357 1. Перейдите на [https://github.com/settings/apps/new](https://github.com/settings/apps/new)357 1. Перейдите на [https://github.com/settings/apps/new](https://github.com/settings/apps/new)

358 2. Заполните основную информацию:358 2. Заполните основную информацию:


428 См. [документацию AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) для получения подробных инструкций по настройке OIDC.428 См. [документацию AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) для получения подробных инструкций по настройке OIDC.

429 </Accordion>429 </Accordion>

430 430 

431 <Accordion title="Google Vertex AI">431 <Accordion title="Google Cloud's Agent Platform">

432 **Настройте Google Cloud, чтобы разрешить GitHub Actions безопасно аутентифицироваться без сохранения учётных данных.**432 **Настройте Google Cloud, чтобы разрешить GitHub Actions безопасно аутентифицироваться без сохранения учётных данных.**

433 433 

434 > **Примечание по безопасности**: Используйте конфигурации, специфичные для репозитория, и предоставляйте только минимально необходимые разрешения.434 > **Примечание по безопасности**: Используйте конфигурации, специфичные для репозитория, и предоставляйте только минимально необходимые разрешения.


438 1. **Включите API** в вашем проекте Google Cloud:438 1. **Включите API** в вашем проекте Google Cloud:

439 * IAM Credentials API439 * IAM Credentials API

440 * Security Token Service (STS) API440 * Security Token Service (STS) API

441 * Vertex AI API441 * Google Cloud's Agent Platform API

442 442 

443 2. **Создайте ресурсы Workload Identity Federation**:443 2. **Создайте ресурсы Workload Identity Federation**:

444 * Создайте Workload Identity Pool444 * Создайте Workload Identity Pool


483 * `APP_ID`: ID вашего GitHub App483 * `APP_ID`: ID вашего GitHub App

484 * `APP_PRIVATE_KEY`: Содержимое приватного ключа (.pem)484 * `APP_PRIVATE_KEY`: Содержимое приватного ключа (.pem)

485 485 

486 #### Для Google Cloud Vertex AI486 #### Для Google Cloud's Agent Platform

487 487 

488 1. **Для аутентификации GCP**:488 1. **Для аутентификации GCP**:

489 * `GCP_WORKLOAD_IDENTITY_PROVIDER`489 * `GCP_WORKLOAD_IDENTITY_PROVIDER`


504 </Step>504 </Step>

505 505 

506 <Step title="Создайте файлы рабочего процесса">506 <Step title="Создайте файлы рабочего процесса">

507 Создайте файлы рабочего процесса GitHub Actions, которые интегрируются с вашим облачным провайдером. Примеры ниже показывают полные конфигурации как для Amazon Bedrock, так и для Google Vertex AI:507 Создайте файлы рабочего процесса GitHub Actions, которые интегрируются с вашим облачным провайдером. Примеры ниже показывают полные конфигурации как для Amazon Bedrock, так и для Google Cloud's Agent Platform:

508 508 

509 <AccordionGroup>509 <AccordionGroup>

510 <Accordion title="Amazon Bedrock workflow">510 <Accordion title="Amazon Bedrock workflow">


512 512 

513 * Доступ Amazon Bedrock включён с разрешениями модели Claude513 * Доступ Amazon Bedrock включён с разрешениями модели Claude

514 * GitHub настроен как OIDC поставщик идентификации в AWS514 * GitHub настроен как OIDC поставщик идентификации в AWS

515 * IAM роль с разрешениями Bedrock, которая доверяет GitHub Actions515 * IAM роль с разрешениями Amazon Bedrock, которая доверяет GitHub Actions

516 516 

517 **Требуемые секреты GitHub:**517 **Требуемые секреты GitHub:**

518 518 

519 | Имя секрета | Описание |519 | Имя секрета | Описание |

520 | -------------------- | -------------------------------------------------------- |520 | -------------------- | -------------------------------------------------------- |

521 | `AWS_ROLE_TO_ASSUME` | ARN IAM роли для доступа к Bedrock |521 | `AWS_ROLE_TO_ASSUME` | ARN IAM роли для доступа к Amazon Bedrock |

522 | `APP_ID` | ID вашего GitHub App (из параметров приложения) |522 | `APP_ID` | ID вашего GitHub App (из параметров приложения) |

523 | `APP_PRIVATE_KEY` | Приватный ключ, который вы создали для вашего GitHub App |523 | `APP_PRIVATE_KEY` | Приватный ключ, который вы создали для вашего GitHub App |

524 524 


573 ```573 ```

574 574 

575 <Tip>575 <Tip>

576 Формат ID модели для Bedrock включает префикс региона (например, `us.anthropic.claude-sonnet-4-6`).576 Формат ID модели для Amazon Bedrock включает префикс региона (например, `us.anthropic.claude-sonnet-4-6`).

577 </Tip>577 </Tip>

578 </Accordion>578 </Accordion>

579 579 

580 <Accordion title="Google Vertex AI workflow">580 <Accordion title="Google Cloud's Agent Platform workflow">

581 **Предварительные требования:**581 **Предварительные требования:**

582 582 

583 * Vertex AI API включён в вашем проекте GCP583 * Google Cloud's Agent Platform API включён в вашем проекте GCP

584 * Workload Identity Federation настроена для GitHub584 * Workload Identity Federation настроена для GitHub

585 * Сервисный аккаунт с разрешениями Vertex AI585 * Сервисный аккаунт с разрешениями Google Cloud's Agent Platform

586 586 

587 **Требуемые секреты GitHub:**587 **Требуемые секреты GitHub:**

588 588 

589 | Имя секрета | Описание |589 | Имя секрета | Описание |

590 | -------------------------------- | ------------------------------------------------------------------ |590 | -------------------------------- | -------------------------------------------------------------------------------------- |

591 | `GCP_WORKLOAD_IDENTITY_PROVIDER` | Имя ресурса поставщика рабочей идентификации |591 | `GCP_WORKLOAD_IDENTITY_PROVIDER` | Имя ресурса поставщика рабочей идентификации |

592 | `GCP_SERVICE_ACCOUNT` | Адрес электронной почты сервисного аккаунта с доступом к Vertex AI |592 | `GCP_SERVICE_ACCOUNT` | Адрес электронной почты сервисного аккаунта с доступом к Google Cloud's Agent Platform |

593 | `APP_ID` | ID вашего GitHub App (из параметров приложения) |593 | `APP_ID` | ID вашего GitHub App (из параметров приложения) |

594 | `APP_PRIVATE_KEY` | Приватный ключ, который вы создали для вашего GitHub App |594 | `APP_PRIVATE_KEY` | Приватный ключ, который вы создали для вашего GitHub App |

595 595 


675 Ошибки аутентификации675 Ошибки аутентификации

676</h3>676</h3>

677 677 

678Подтвердите, что API ключ действителен и имеет достаточные разрешения. Для Bedrock/Vertex проверьте конфигурацию учётных данных и убедитесь, что секреты правильно названы в рабочих процессах.678Подтвердите, что API ключ действителен и имеет достаточные разрешения. Для Amazon Bedrock или Google Cloud's Agent Platform проверьте конфигурацию учётных данных и убедитесь, что секреты правильно названы в рабочих процессах.

679 679 

680<h2 id="advanced-configuration">680<h2 id="advanced-configuration">

681 Расширенная конфигурация681 Расширенная конфигурация


697| `github_token` | GitHub токен для доступа к API | Нет |697| `github_token` | GitHub токен для доступа к API | Нет |

698| `trigger_phrase` | Пользовательская фраза триггера (по умолчанию: "@claude") | Нет |698| `trigger_phrase` | Пользовательская фраза триггера (по умолчанию: "@claude") | Нет |

699| `use_bedrock` | Использовать Amazon Bedrock вместо Claude API | Нет |699| `use_bedrock` | Использовать Amazon Bedrock вместо Claude API | Нет |

700| `use_vertex` | Использовать Google Vertex AI вместо Claude API | Нет |700| `use_vertex` | Использовать Google Cloud's Agent Platform вместо Claude API | Нет |

701 701 

702\*Prompt опционален — при пропуске для комментариев issue/PR, Claude отвечает на фразу триггера\702\*Prompt опционален — при пропуске для комментариев issue/PR, Claude отвечает на фразу триггера\

703\*\*Требуется для прямого Claude API, не требуется для Bedrock/Vertex703\*\*Требуется для прямого Claude API, не требуется для Amazon Bedrock или Google Cloud's Agent Platform

704 704 

705<h4 id="pass-cli-arguments">705<h4 id="pass-cli-arguments">

706 Передайте аргументы CLI706 Передайте аргументы CLI

Details

10 Поддержка GitHub Enterprise Server доступна для планов Team и Enterprise.10 Поддержка GitHub Enterprise Server доступна для планов Team и Enterprise.

11</Note>11</Note>

12 12 

13Поддержка GitHub Enterprise Server (GHES) позволяет вашей организации использовать Claude Code с репозиториями, размещёнными на вашем самоуправляемом экземпляре GitHub вместо github.com. После того как администратор подключит ваш экземпляр GHES, разработчики смогут запускать веб-сессии, получать автоматизированные проверки кода и устанавливать плагины из внутренних маркетплейсов без какой-либо конфигурации для каждого репозитория.13Поддержка GitHub Enterprise Server (GHES) позволяет вашей организации использовать Claude Code с репозиториями, размещёнными на вашем самоуправляемом экземпляре GitHub вместо github.com. После того как администратор подключит ваш экземпляр GHES, разработчики смогут запускать веб-сессии и получать автоматизированные проверки кода без какой-либо конфигурации для каждого репозитория. Маркетплейсы плагинов, размещённые на вашем экземпляре, также поддерживаются; требования к учётным данным различаются в зависимости от поверхности, как описано в [Plugin marketplaces on GHES](#plugin-marketplaces-on-ghes).

14 14 

15Для репозиториев на github.com см. [Claude Code в веб-интерфейсе](/ru/claude-code-on-the-web) и [Проверка кода](/ru/code-review). Чтобы запустить Claude в вашей собственной инфраструктуре CI, см. [GitHub Actions](/ru/github-actions).15Для репозиториев на github.com см. [Claude Code в веб-интерфейсе](/ru/claude-code-on-the-web) и [Проверка кода](/ru/code-review). Чтобы запустить Claude в вашей собственной инфраструктуре CI, см. [GitHub Actions](/ru/github-actions).

16 16 


21В таблице ниже показано, какие функции Claude Code поддерживают GHES и какие различия есть по сравнению с поведением github.com.21В таблице ниже показано, какие функции Claude Code поддерживают GHES и какие различия есть по сравнению с поведением github.com.

22 22 

23| Функция | Поддержка GHES | Примечания |23| Функция | Поддержка GHES | Примечания |

24| :--------------------------- | :------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------- |24| :--------------------------- | :------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------- |

25| Claude Code в веб-интерфейсе | ✅ Поддерживается | Администратор подключает экземпляр GHES один раз; разработчики используют `claude --remote` или [claude.ai/code](https://claude.ai/code) как обычно |25| Claude Code в веб-интерфейсе | ✅ Поддерживается | Администратор подключает экземпляр GHES один раз; разработчики используют `claude --cloud` или [claude.ai/code](https://claude.ai/code) как обычно |

26| Проверка кода | ✅ Поддерживается | Те же автоматизированные проверки PR, что и на github.com |26| Проверка кода | ✅ Поддерживается | Те же автоматизированные проверки PR, что и на github.com |

27| Claude Security | ✅ Поддерживается | Доступно в открытой бета-версии для планов Enterprise на [claude.ai/security](https://claude.ai/security) |27| Claude Security | ✅ Поддерживается | Доступно в открытой бета-версии для планов Enterprise на [claude.ai/security](https://claude.ai/security) |

28| Сессии Teleport | ✅ Поддерживается | Перемещайте сессии между веб-интерфейсом и терминалом с помощью `--teleport` |28| Сессии Teleport | ✅ Поддерживается | Перемещайте сессии между веб-интерфейсом и терминалом с помощью `--teleport` |

29| Маркетплейсы плагинов | ✅ Поддерживается | Используйте полные URL-адреса git вместо сокращения `owner/repo` |29| Маркетплейсы плагинов | ✅ Поддерживается | Требования к учётным данным различаются в зависимости от поверхности. См. [Маркетплейсы плагинов на GHES](#plugin-marketplaces-on-ghes) |

30| Метрики вклада | ✅ Поддерживается | Доставляются через webhooks на [панель аналитики](/ru/analytics) |30| Метрики вклада | ✅ Поддерживается | Доставляются через webhooks на [панель аналитики](/ru/analytics) |

31| GitHub Actions | ✅ Поддерживается | Требует ручной настройки workflow; `/install-github-app` доступен только для github.com |31| GitHub Actions | ✅ Поддерживается | Требует ручной настройки workflow; `/install-github-app` доступен только для github.com |

32| GitHub MCP server | ❌ Не поддерживается | GitHub MCP server не работает с экземплярами GHES |32| GitHub MCP server | ❌ Не поддерживается | GitHub MCP server не работает с экземплярами GHES |


107Затем запустите веб-сессию. Claude обнаруживает хост GHES из вашего git remote и маршрутизирует сессию через настроенный экземпляр вашей организации:107Затем запустите веб-сессию. Claude обнаруживает хост GHES из вашего git remote и маршрутизирует сессию через настроенный экземпляр вашей организации:

108 108 

109```bash theme={null}109```bash theme={null}

110claude --remote "Add retry logic to the payment webhook handler"110claude --cloud "Add retry logic to the payment webhook handler"

111```111```

112 112 

113Сессия запускается на инфраструктуре Anthropic, клонирует ваш репозиторий из GHES и отправляет изменения обратно в ветку. Отслеживайте прогресс с помощью `/tasks` или на [claude.ai/code](https://claude.ai/code). См. [Claude Code в веб-интерфейсе](/ru/claude-code-on-the-web) для полного рабочего процесса удалённой сессии, включая проверку diff, автоисправление и процедуры.113Сессия запускается на инфраструктуре Anthropic, клонирует ваш репозиторий из GHES и отправляет изменения обратно в ветку. Отслеживайте прогресс с помощью `/tasks` или на [claude.ai/code](https://claude.ai/code). См. [Claude Code в веб-интерфейсе](/ru/claude-code-on-the-web) для полного рабочего процесса удалённой сессии, включая проверку diff, автоисправление и процедуры.


122 Маркетплейсы плагинов на GHES122 Маркетплейсы плагинов на GHES

123</h2>123</h2>

124 124 

125Размещайте маркетплейсы плагинов на вашем экземпляре GHES для распределения внутренних инструментов по всей вашей организации. Структура маркетплейса идентична маркетплейсам, размещённым на github.com; единственное различие заключается в том, как вы на них ссылаетесь.125Размещайте маркетплейсы плагинов на вашем экземпляре GHES для распределения внутренних инструментов по всей вашей организации. Структура маркетплейса идентична маркетплейсам, размещённым на github.com, но установка работает по-разному в зависимости от того, где вы добавляете маркетплейс, и учётные данные различаются на разных поверхностях:

126 

127| Поверхность | Как работает установка | Что нужно каждому пользователю |

128| :----------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

129| Claude Code CLI и десктоп | Claude Code клонирует репозиторий маркетплейса, используя существующие учётные данные git машины | Доступ Git к вашему хосту GHES с их машины |

130| Управляемые параметры (`extraKnownMarketplaces`) | Claude Code регистрирует запись и клонирует репозиторий, используя существующие учётные данные git машины | Доступ Git к вашему хосту GHES с их машины |

131| Параметры плагина организации claude.ai | Владелец выбирает экземпляр GHES в качестве источника; серверная часть Anthropic получает и синхронизирует репозиторий, используя GitHub App из [настройки администратора](#admin-setup) | Ничего для каждого пользователя после добавления. Владельцу, добавляющему его, нужна собственная подключённая учётная запись GitHub Enterprise в качестве проверки доступа, и GitHub App должно быть установлено на репозиторий маркетплейса |

132| Параметры пользователя claude.ai | Серверная часть Anthropic получает репозиторий, используя подключение GitHub Enterprise отправляющего пользователя | Собственная учётная запись GitHub Enterprise, подключённая к Claude |

133| Claude Code в веб-версии | Облачные сеансы клонируют маркетплейсы внутри песочницы сеанса. Песочница может достичь вашего экземпляра GHES только когда репозиторий сеанса находится на том же экземпляре, и его учётные данные git ограничены репозиториями сеанса | Ненадёжно для маркетплейсов, размещённых на GHES: другой хост, чем репозиторий сеанса, недостижим, и даже установки на одном экземпляре могут не пройти. Используйте вместо этого CLI, управляемые параметры или claude.ai |

134 

135<Warning>

136 Подключения GitHub Enterprise на claude.ai являются пользовательскими, когда маркетплейс добавляется из параметров пользователя. [Настройка администратора](#admin-setup) подключает ваш экземпляр GHES к вашей организации, но она не подключает отдельные учётные записи пользователей: каждый пользователь, который добавляет маркетплейс GHES из своих собственных параметров, должен сначала подключить собственную учётную запись GitHub Enterprise, и подключение одного пользователя, включая подключение Владельца, не охватывает никого другого. Маркетплейсы, добавленные Владельцем в параметры плагина организации, не накладывают это требование на пользователей, потому что текущие получения используют GitHub App организации. Владельцу, добавляющему маркетплейс, всё ещё нужна собственная подключённая учётная запись GitHub Enterprise во время добавления.

137</Warning>

126 138 

127<h3 id="add-a-ghes-marketplace">139<h3 id="add-a-ghes-marketplace">

128 Добавьте маркетплейс GHES140 Добавьте маркетплейс GHES

129</h3>141</h3>

130 142 

131Сокращение `owner/repo` всегда разрешается на github.com. Для маркетплейсов, размещённых на GHES, используйте полный URL-адрес git:143Сокращение `owner/repo` всегда разрешается на github.com. Для маркетплейсов, размещённых на GHES, используйте полный URL-адрес git. Рекомендуются HTTPS URL-адреса:

132 144 

133```bash theme={null}145```bash theme={null}

134/plugin marketplace add git@github.example.com:platform/claude-plugins.git146/plugin marketplace add https://github.example.com/platform/claude-plugins.git

135```147```

136 148 

137HTTPS URL-адреса также работают:149SSH URL-адреса работают, если машина уже доверяет вашему хосту GHES:

138 150 

139```bash theme={null}151```bash theme={null}

140/plugin marketplace add https://github.example.com/platform/claude-plugins.git152/plugin marketplace add git@github.example.com:platform/claude-plugins.git

141```153```

142 154 

155Claude Code запускает git неинтерактивно и отклоняет SSH-подключения к хостам, которые отсутствуют в файле `known_hosts` машины. HTTPS URL-адрес с помощником учётных данных git избегает требования `known_hosts`.

156 

143См. [Создание и распределение маркетплейса плагинов](/ru/plugin-marketplaces) для полного руководства по созданию маркетплейсов.157См. [Создание и распределение маркетплейса плагинов](/ru/plugin-marketplaces) для полного руководства по созданию маркетплейсов.

144 158 

159<h3 id="pre-register-ghes-marketplaces-with-managed-settings">

160 Предварительно зарегистрируйте маркетплейсы GHES с управляемыми параметрами

161</h3>

162 

163Параметр `extraKnownMarketplaces` предварительно регистрирует маркетплейс, чтобы разработчики получили его без ручной настройки. Это работает из [любого файла параметров](/ru/settings#extraknownmarketplaces), включая `.claude/settings.json` репозитория; управляемые параметры доставляют его по всей организации:

164 

165```json theme={null}

166{

167 "extraKnownMarketplaces": {

168 "internal-tools": {

169 "source": {

170 "source": "git",

171 "url": "https://github.example.com/platform/claude-plugins.git"

172 }

173 }

174 }

175}

176```

177 

178Claude Code устанавливает эти маркетплейсы локально: он регистрирует каждую запись и клонирует репозиторий с существующими учётными данными git машины. Этот путь не проходит через claude.ai, поэтому подключение GitHub Enterprise для каждого пользователя не требуется. Для успешного развёртывания:

179 

180* **Используйте полный URL-адрес git.** Сокращение `owner/repo` всегда разрешается на github.com и не может ссылаться на хост GHES.

181* **Предпочитайте HTTPS URL-адреса.** SSH-клоны не работают на машинах, которые уже не доверяют ключу хоста GHES. HTTPS URL-адрес с помощником учётных данных git вашей организации работает на любой машине с настроенными учётными данными.

182* **Подтвердите, что каждая машина может клонировать с вашего хоста GHES.** Если машине не хватает учётных данных, маркетплейс регистрируется, но никогда не устанавливается, и его плагины сообщают об отсутствии вместо запроса учётных данных.

183* **Подтвердите, что параметр достигает каждой машины.** Файл управляемых параметров вступает в силу только на машинах, на которые он развёрнут, например через вашу систему управления устройствами. См. [управляемые параметры](/ru/settings#settings-files) для расположения файлов.

184 

145<h3 id="allowlist-ghes-marketplaces-in-managed-settings">185<h3 id="allowlist-ghes-marketplaces-in-managed-settings">

146 Добавьте маркетплейсы GHES в список разрешений в управляемых параметрах186 Добавьте маркетплейсы GHES в список разрешений в управляемых параметрах

147</h3>187</h3>


159}199}

160```200```

161 201 

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

163 

164```json theme={null}

165{

166 "extraKnownMarketplaces": {

167 "internal-tools": {

168 "source": {

169 "source": "git",

170 "url": "git@github.example.com:platform/claude-plugins.git"

171 }

172 }

173 }

174}

175```

176 

177См. справочник параметров [strictKnownMarketplaces](/ru/settings#strictknownmarketplaces) и [extraKnownMarketplaces](/ru/settings#extraknownmarketplaces) для полной схемы.202См. справочник параметров [strictKnownMarketplaces](/ru/settings#strictknownmarketplaces) и [extraKnownMarketplaces](/ru/settings#extraknownmarketplaces) для полной схемы.

178 203 

179<h2 id="limitations">204<h2 id="limitations">


193 Веб-сессия не может клонировать репозиторий218 Веб-сессия не может клонировать репозиторий

194</h3>219</h3>

195 220 

196Если `claude --remote` завершается с ошибкой клонирования, убедитесь, что владелец завершил настройку для вашего экземпляра GHES и что GitHub App установлено на репозитории, над которым вы работаете. Попросите владельца, который подключил экземпляр, подтвердить, что имя хоста, зарегистрированное в параметрах Claude, совпадает с именем хоста в вашем git remote.221Если `claude --cloud` завершается с ошибкой клонирования, убедитесь, что владелец завершил настройку для вашего экземпляра GHES и что GitHub App установлено на репозитории, над которым вы работаете. Попросите владельца, который подключил экземпляр, подтвердить, что имя хоста, зарегистрированное в параметрах Claude, совпадает с именем хоста в вашем git remote.

197 222 

198<h3 id="marketplace-add-fails-with-a-policy-error">223<h3 id="marketplace-add-fails-with-a-policy-error">

199 Добавление маркетплейса не удаётся с ошибкой политики224 Добавление маркетплейса не удаётся с ошибкой политики


201 226 

202Если `/plugin marketplace add` заблокирован для вашего URL-адреса GHES, ваша организация ограничила источники маркетплейса. Попросите администратора добавить запись `hostPattern` для имени хоста GHES в [управляемые параметры](#allowlist-ghes-marketplaces-in-managed-settings).227Если `/plugin marketplace add` заблокирован для вашего URL-адреса GHES, ваша организация ограничила источники маркетплейса. Попросите администратора добавить запись `hostPattern` для имени хоста GHES в [управляемые параметры](#allowlist-ghes-marketplaces-in-managed-settings).

203 228 

229<h3 id="marketplace-add-on-claude-ai-fails-with-a-github-access-error">

230 Добавление маркетплейса на claude.ai не удаётся с ошибкой доступа GitHub

231</h3>

232 

233Если добавление маркетплейса GHES из параметров пользователя завершается с общей ошибкой типа "Marketplace couldn't be added", сначала проверьте подключение GitHub Enterprise. Это происходит, когда ваша собственная учётная запись GitHub Enterprise не подключена к Claude, даже если экземпляр GHES вашей организации настроен и другие пользователи подключены. Диалог не указывает на процесс подключения GitHub Enterprise, а опция "Connect to GitHub" на вкладке Browse выполняет вход в github.com, что не предоставляет доступ к репозиториям GHES.

234 

235Чтобы подключить вашу учётную запись GitHub Enterprise: средство выбора репозитория на [claude.ai/code](https://claude.ai/code) предлагает опцию подключения для каждого настроенного экземпляра GHES, и владельцы также могут подключиться из раздела GitHub Enterprise [параметров администратора Claude Code](https://claude.ai/admin-settings/claude-code). Затем добавьте маркетплейс снова. Кроме того, попросите владельца добавить маркетплейс в параметры плагина организации, что устраняет требование подключения для каждого пользователя.

236 

237На других поверхностях claude.ai ошибка "Repository not found. If it's private, GitHub access is required" на маркетплейсе GHES обычно указывает на то же отсутствующее подключение. Подключите вашу учётную запись GitHub Enterprise через один из указанных выше путей, затем повторите попытку.

238 

204<h3 id="ghes-instance-not-reachable">239<h3 id="ghes-instance-not-reachable">

205 Экземпляр GHES недоступен240 Экземпляр GHES недоступен

206</h3>241</h3>

gitlab-ci-cd.md +30 −30

Details

24* **Автоматизированная реализация**: Превратите проблемы в рабочий код с помощью одной команды или упоминания24* **Автоматизированная реализация**: Превратите проблемы в рабочий код с помощью одной команды или упоминания

25* **Осведомленность о проекте**: Claude следует вашим рекомендациям `CLAUDE.md` и существующим шаблонам кода25* **Осведомленность о проекте**: Claude следует вашим рекомендациям `CLAUDE.md` и существующим шаблонам кода

26* **Простая настройка**: Добавьте одно задание в `.gitlab-ci.yml` и замаскированную переменную CI/CD26* **Простая настройка**: Добавьте одно задание в `.gitlab-ci.yml` и замаскированную переменную CI/CD

27* **Готово для предприятия**: Выберите Claude API, Amazon Bedrock или Google Vertex AI для соответствия требованиям к месторасположению данных и закупкам27* **Готово для предприятия**: Выберите Claude API, Amazon Bedrock или Google Cloud's Agent Platform для соответствия требованиям к месторасположению данных и закупкам

28* **Безопасно по умолчанию**: Работает на ваших GitLab runners с вашей защитой ветвей и утверждениями28* **Безопасно по умолчанию**: Работает на ваших GitLab runners с вашей защитой ветвей и утверждениями

29 29 

30<h2 id="how-it-works">30<h2 id="how-it-works">


382. **Абстракция поставщика**: Используйте поставщика, который подходит для вашей среды:382. **Абстракция поставщика**: Используйте поставщика, который подходит для вашей среды:

39 * Claude API (SaaS)39 * Claude API (SaaS)

40 * Amazon Bedrock (доступ на основе IAM, опции между регионами)40 * Amazon Bedrock (доступ на основе IAM, опции между регионами)

41 * Google Vertex AI (собственный GCP, Workload Identity Federation)41 * Google Cloud's Agent Platform (собственный GCP, Workload Identity Federation)

42 42 

433. **Изолированное выполнение**: Каждое взаимодействие выполняется в контейнере со строгими правилами сети и файловой системы. Claude Code обеспечивает разрешения с областью действия рабочего пространства для ограничения записей. Каждое изменение проходит через MR, чтобы рецензенты видели diff и применялись утверждения.433. **Изолированное выполнение**: Каждое взаимодействие выполняется в контейнере со строгими правилами сети и файловой системы. Claude Code обеспечивает разрешения с областью действия рабочего пространства для ограничения записей. Каждое изменение проходит через MR, чтобы рецензенты видели diff и применялись утверждения.

44 44 


108После добавления задания и переменной `ANTHROPIC_API_KEY` протестируйте, запустив задание вручную из **CI/CD** → **Pipelines**, или запустите его из MR, чтобы позволить Claude предложить обновления в ветви и открыть MR при необходимости.108После добавления задания и переменной `ANTHROPIC_API_KEY` протестируйте, запустив задание вручную из **CI/CD** → **Pipelines**, или запустите его из MR, чтобы позволить Claude предложить обновления в ветви и открыть MR при необходимости.

109 109 

110<Note>110<Note>

111 Для запуска на Amazon Bedrock или Google Vertex AI вместо Claude API см. раздел [Использование с Amazon Bedrock и Google Vertex AI](#using-with-amazon-bedrock-%26-google-vertex-ai) ниже для настройки аутентификации и окружения.111 Для запуска на Amazon Bedrock или Google Cloud's Agent Platform вместо Claude API см. раздел [Использование с Amazon Bedrock и Google Cloud](#using-with-amazon-bedrock-and-google-cloud) ниже для настройки аутентификации и окружения.

112</Note>112</Note>

113 113 

114<h3 id="manual-setup-recommended-for-production">114<h3 id="manual-setup-recommended-for-production">


119 119 

1201. **Настройте доступ поставщика**:1201. **Настройте доступ поставщика**:

121 * **Claude API**: Создайте и сохраните `ANTHROPIC_API_KEY` как замаскированную переменную CI/CD121 * **Claude API**: Создайте и сохраните `ANTHROPIC_API_KEY` как замаскированную переменную CI/CD

122 * **Amazon Bedrock**: **Настройте GitLab** → **AWS OIDC** и создайте роль IAM для Bedrock122 * **Amazon Bedrock**: **Настройте GitLab** → **AWS OIDC** и создайте роль IAM для Amazon Bedrock

123 * **Google Vertex AI**: **Настройте Workload Identity Federation для GitLab** → **GCP**123 * **Google Cloud's Agent Platform**: **Настройте Workload Identity Federation для GitLab** → **GCP**

124 124 

1252. **Добавьте учетные данные проекта для операций GitLab API**:1252. **Добавьте учетные данные проекта для операций GitLab API**:

126 * Используйте `CI_JOB_TOKEN` по умолчанию или создайте Project Access Token с областью `api`126 * Используйте `CI_JOB_TOKEN` по умолчанию или создайте Project Access Token с областью `api`


172 172 

173Claude находит ошибку, реализует исправление и обновляет ветвь или открывает новый MR.173Claude находит ошибку, реализует исправление и обновляет ветвь или открывает новый MR.

174 174 

175<h2 id="using-with-amazon-bedrock--google-vertex-ai">175<h2 id="using-with-amazon-bedrock-and-google-cloud">

176 Использование с Amazon Bedrock и Google Vertex AI176 Использование с Amazon Bedrock и Google Cloud

177</h2>177</h2>

178 178 

179Для корпоративных сред вы можете запустить Claude Code полностью на вашей облачной инфраструктуре с тем же опытом разработчика.179Для корпоративных сред вы можете запустить Claude Code полностью на вашей облачной инфраструктуре с тем же опытом разработчика.


186 186 

187 1. Учетная запись AWS с доступом Amazon Bedrock к желаемым моделям Claude187 1. Учетная запись AWS с доступом Amazon Bedrock к желаемым моделям Claude

188 2. GitLab, настроенный как поставщик идентификации OIDC в AWS IAM188 2. GitLab, настроенный как поставщик идентификации OIDC в AWS IAM

189 3. Роль IAM с разрешениями Bedrock и политикой доверия, ограниченной вашим проектом/ссылками GitLab189 3. Роль IAM с разрешениями Amazon Bedrock и политикой доверия, ограниченной вашим проектом/ссылками GitLab

190 4. Переменные GitLab CI/CD для предположения роли:190 4. Переменные GitLab CI/CD для предположения роли:

191 * `AWS_ROLE_TO_ASSUME` (ARN роли)191 * `AWS_ROLE_TO_ASSUME` (ARN роли)

192 * `AWS_REGION` (регион Bedrock)192 * `AWS_REGION` (регион Amazon Bedrock)

193 193 

194 ### Инструкции по настройке194 ### Инструкции по настройке

195 195 


200 1. Включите Amazon Bedrock и запросите доступ к целевым моделям Claude200 1. Включите Amazon Bedrock и запросите доступ к целевым моделям Claude

201 2. Создайте поставщика IAM OIDC для GitLab, если он еще не присутствует201 2. Создайте поставщика IAM OIDC для GitLab, если он еще не присутствует

202 3. Создайте роль IAM, доверяющую поставщику GitLab OIDC, ограниченную вашим проектом и защищенными ссылками202 3. Создайте роль IAM, доверяющую поставщику GitLab OIDC, ограниченную вашим проектом и защищенными ссылками

203 4. Прикрепите разрешения с наименьшими привилегиями для API вызова Bedrock203 4. Прикрепите разрешения с наименьшими привилегиями для API вызова Amazon Bedrock

204 204 

205 **Требуемые значения для сохранения в переменных CI/CD:**205 **Требуемые значения для сохранения в переменных CI/CD:**

206 206 


218 Используйте пример задания Amazon Bedrock выше для обмена токена задания GitLab на временные учетные данные AWS во время выполнения.218 Используйте пример задания Amazon Bedrock выше для обмена токена задания GitLab на временные учетные данные AWS во время выполнения.

219 </Tab>219 </Tab>

220 220 

221 <Tab title="Google Vertex AI">221 <Tab title="Google Cloud's Agent Platform">

222 ### Предварительные требования222 ### Предварительные требования

223 223 

224 Перед настройкой Claude Code с Google Vertex AI вам потребуется:224 Перед настройкой Claude Code с Google Cloud's Agent Platform вам потребуется:

225 225 

226 1. Проект Google Cloud с:226 1. Проект Google Cloud с:

227 * Включенным API Vertex AI227 * Включенным API Google Cloud's Agent Platform

228 * Настроенной Workload Identity Federation для доверия GitLab OIDC228 * Настроенной Workload Identity Federation для доверия GitLab OIDC

229 2. Выделенная учетная запись сервиса только с требуемыми ролями Vertex AI229 2. Выделенная учетная запись сервиса только с требуемыми ролями Google Cloud's Agent Platform

230 3. Переменные GitLab CI/CD для WIF:230 3. Переменные GitLab CI/CD для WIF:

231 * `GCP_WORKLOAD_IDENTITY_PROVIDER` (полное имя ресурса)231 * `GCP_WORKLOAD_IDENTITY_PROVIDER` (полное имя ресурса)

232 * `GCP_SERVICE_ACCOUNT` (адрес электронной почты учетной записи сервиса)232 * `GCP_SERVICE_ACCOUNT` (адрес электронной почты учетной записи сервиса)


237 237 

238 **Требуемая настройка:**238 **Требуемая настройка:**

239 239 

240 1. Включите IAM Credentials API, STS API и Vertex AI API240 1. Включите IAM Credentials API, STS API и Google Cloud's Agent Platform API

241 2. Создайте пул Workload Identity и поставщика для GitLab OIDC241 2. Создайте пул Workload Identity и поставщика для GitLab OIDC

242 3. Создайте выделенную учетную запись сервиса с ролями Vertex AI242 3. Создайте выделенную учетную запись сервиса с ролями Google Cloud's Agent Platform

243 4. Предоставьте основному принципу WIF разрешение на олицетворение учетной записи сервиса243 4. Предоставьте основному принципу WIF разрешение на олицетворение учетной записи сервиса

244 244 

245 **Требуемые значения для сохранения в переменных CI/CD:**245 **Требуемые значения для сохранения в переменных CI/CD:**


250 Добавьте переменные в Settings → CI/CD → Variables:250 Добавьте переменные в Settings → CI/CD → Variables:

251 251 

252 ```yaml theme={null}252 ```yaml theme={null}

253 # Для Google Vertex AI:253 # Для Google Cloud's Agent Platform:

254 - GCP_WORKLOAD_IDENTITY_PROVIDER254 - GCP_WORKLOAD_IDENTITY_PROVIDER

255 - GCP_SERVICE_ACCOUNT255 - GCP_SERVICE_ACCOUNT

256 - CLOUD_ML_REGION (например, us-east5)256 - CLOUD_ML_REGION (например, us-east5)

257 ```257 ```

258 258 

259 Используйте пример задания Google Vertex AI выше для аутентификации без сохранения ключей.259 Используйте пример задания Google Cloud's Agent Platform выше для аутентификации без сохранения ключей.

260 </Tab>260 </Tab>

261</Tabs>261</Tabs>

262 262 


305 305 

306* Amazon Bedrock включен с доступом к выбранной модели Claude306* Amazon Bedrock включен с доступом к выбранной модели Claude

307* GitLab OIDC настроен в AWS с ролью, которая доверяет вашему проекту GitLab и ссылкам307* GitLab OIDC настроен в AWS с ролью, которая доверяет вашему проекту GitLab и ссылкам

308* Роль IAM с разрешениями Bedrock (рекомендуется наименьшие привилегии)308* Роль IAM с разрешениями Amazon Bedrock (рекомендуется наименьшие привилегии)

309 309 

310**Требуемые переменные CI/CD:**310**Требуемые переменные CI/CD:**

311 311 

312* `AWS_ROLE_TO_ASSUME`: ARN роли IAM для доступа к Bedrock312* `AWS_ROLE_TO_ASSUME`: ARN роли IAM для доступа к Amazon Bedrock

313* `AWS_REGION`: Регион Bedrock (например, `us-west-2`)313* `AWS_REGION`: Регион Amazon Bedrock (например, `us-west-2`)

314 314 

315```yaml theme={null}315```yaml theme={null}

316claude-bedrock:316claude-bedrock:


347```347```

348 348 

349<Note>349<Note>

350 Идентификаторы моделей для Bedrock включают префиксы, специфичные для региона (например, `us.anthropic.claude-sonnet-4-6`). Передайте желаемую модель через конфигурацию задания или подсказку, если ваш рабочий процесс это поддерживает.350 Идентификаторы моделей для Amazon Bedrock включают префиксы, специфичные для региона (например, `us.anthropic.claude-sonnet-4-6`). Передайте желаемую модель через конфигурацию задания или подсказку, если ваш рабочий процесс это поддерживает.

351</Note>351</Note>

352 352 

353<h3 id="google-vertex-ai-job-example-workload-identity-federation">353<h3 id="agent-platform-job-example-workload-identity-federation">

354 Пример задания Google Vertex AI (Workload Identity Federation)354 Пример задания Agent Platform (Workload Identity Federation)

355</h3>355</h3>

356 356 

357**Предварительные требования:**357**Предварительные требования:**

358 358 

359* API Vertex AI включен в вашем проекте GCP359* API Agent Platform Google Cloud включен в вашем проекте GCP

360* Workload Identity Federation настроена для доверия GitLab OIDC360* Workload Identity Federation настроена для доверия GitLab OIDC

361* Учетная запись сервиса с разрешениями Vertex AI361* Учетная запись сервиса с разрешениями Agent Platform Google Cloud

362 362 

363**Требуемые переменные CI/CD:**363**Требуемые переменные CI/CD:**

364 364 

365* `GCP_WORKLOAD_IDENTITY_PROVIDER`: Полное имя ресурса поставщика365* `GCP_WORKLOAD_IDENTITY_PROVIDER`: Полное имя ресурса поставщика

366* `GCP_SERVICE_ACCOUNT`: Адрес электронной почты учетной записи сервиса366* `GCP_SERVICE_ACCOUNT`: Адрес электронной почты учетной записи сервиса

367* `CLOUD_ML_REGION`: Регион Vertex (например, `us-east5`)367* `CLOUD_ML_REGION`: Регион Agent Platform Google Cloud (например, `us-east5`)

368 368 

369```yaml theme={null}369```yaml theme={null}

370claude-vertex:370claude-vertex:


490</h3>490</h3>

491 491 

492* **Для Claude API**: Подтвердите, что `ANTHROPIC_API_KEY` действителен и не истек492* **Для Claude API**: Подтвердите, что `ANTHROPIC_API_KEY` действителен и не истек

493* **Для Bedrock/Vertex**: Проверьте конфигурацию OIDC/WIF, олицетворение роли и имена секретов; подтвердите доступность региона и модели493* **Для Amazon Bedrock или Google Cloud's Agent Platform**: Проверьте конфигурацию OIDC/WIF, олицетворение роли и имена секретов; подтвердите доступность региона и модели

494 494 

495<h2 id="advanced-configuration">495<h2 id="advanced-configuration">

496 Расширенная конфигурация496 Расширенная конфигурация


505* `prompt` / `prompt_file`: Предоставьте инструкции встроенно (`-p`) или через файл505* `prompt` / `prompt_file`: Предоставьте инструкции встроенно (`-p`) или через файл

506* `max_turns`: Ограничьте количество взаимных итераций506* `max_turns`: Ограничьте количество взаимных итераций

507* `timeout_minutes`: Ограничьте общее время выполнения507* `timeout_minutes`: Ограничьте общее время выполнения

508* `ANTHROPIC_API_KEY`: Требуется для Claude API (не используется для Bedrock/Vertex)508* `ANTHROPIC_API_KEY`: Требуется для Claude API (не используется для Amazon Bedrock или Google Cloud's Agent Platform)

509* Окружение, специфичное для поставщика: `AWS_REGION`, переменные проекта/региона для Vertex509* Окружение, специфичное для поставщика: `AWS_REGION`, переменные проекта/региона для Google Cloud's Agent Platform

510 510 

511<Note>511<Note>

512 Точные флаги и параметры могут варьироваться в зависимости от версии `@anthropic-ai/claude-code`. Запустите `claude --help` в вашем задании, чтобы увидеть поддерживаемые опции.512 Точные флаги и параметры могут варьироваться в зависимости от версии `@anthropic-ai/claude-code`. Запустите `claude --help` в вашем задании, чтобы увидеть поддерживаемые опции.

glossary.md +3 −1

Details

262 262 

263Базовое поведение одобрения для сеанса. Переключайтесь с `Shift+Tab` в CLI или используйте селектор режима в VS Code, Desktop и claude.ai. Доступные режимы: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` и `bypassPermissions`.263Базовое поведение одобрения для сеанса. Переключайтесь с `Shift+Tab` в CLI или используйте селектор режима в VS Code, Desktop и claude.ai. Доступные режимы: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk` и `bypassPermissions`.

264 264 

265Режим `default` обозначен как Manual в CLI и в расширениях VS Code и JetBrains, и Claude Code принимает `manual` как псевдоним для этого значения.

266 

265Подробнее: [Выберите режим разрешений](/ru/permission-modes)267Подробнее: [Выберите режим разрешений](/ru/permission-modes)

266 268 

267<h3 id="permission-rule">269<h3 id="permission-rule">


388 Teleport390 Teleport

389</h3>391</h3>

390 392 

391Команда, `/teleport`, которая вытягивает облачный сеанс Claude Code в ваш локальный терминал. Claude получает ветку, загружает историю разговора и возобновляет с последнего состояния веб-сеанса. Обратное направление — `--remote`, которое отправляет локальную задачу для запуска в веб-версии.393Команда, `/teleport`, которая вытягивает облачный сеанс Claude Code в ваш локальный терминал. Claude получает ветку, загружает историю разговора и возобновляет с последнего состояния веб-сеанса. Обратное направление — `--cloud`, которое отправляет локальную задачу для запуска в веб-версии.

392 394 

393Подробнее: [From web to terminal](/ru/claude-code-on-the-web#from-web-to-terminal)395Подробнее: [From web to terminal](/ru/claude-code-on-the-web#from-web-to-terminal)

394 396 

Details

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

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

4 4 

5# Claude Code на Google Vertex AI5# Claude Code на Google Cloud's Agent Platform

6 6 

7> Узнайте о настройке Claude Code через Google Vertex AI, включая установку, конфигурацию IAM и устранение неполадок.7> Узнайте о настройке Claude Code через Google Cloud's Agent Platform, ранее известную как Vertex AI, включая установку, конфигурацию IAM и устранение неполадок.

8 8 

9export const ContactSalesCard = ({surface}) => {9export const ContactSalesCard = ({surface}) => {

10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;


82 Предварительные требования82 Предварительные требования

83</h2>83</h2>

84 84 

85Перед настройкой Claude Code с Vertex AI убедитесь, что у вас есть:85Перед настройкой Claude Code с Google Cloud's Agent Platform, ранее известной как Vertex AI, убедитесь, что у вас есть:

86 86 

87* Учетная запись Google Cloud Platform (GCP) с включенной биллингом87* Учетная запись Google Cloud Platform (GCP) с включенной биллингом

88* Проект GCP с включенным API Vertex AI88* Проект GCP с включенным API Google Cloud's Agent Platform

89* Доступ к нужным моделям Claude (например, Claude Sonnet 4.6)89* Доступ к нужным моделям Claude (например, Claude Sonnet 4.6)

90* Установленный и настроенный Google Cloud SDK (`gcloud`)90* Установленный и настроенный Google Cloud SDK (`gcloud`)

91* Квота, выделенная в нужном регионе GCP91* Квота, выделенная в нужном регионе GCP

92 92 

93Чтобы войти со своими учетными данными Vertex AI, следуйте инструкциям [Вход с Vertex AI](#sign-in-with-vertex-ai) ниже. Чтобы развернуть Claude Code для команды, используйте шаги [ручной установки](#set-up-manually) и [закрепите версии ваших моделей](#5-pin-model-versions) перед развертыванием.93Чтобы войти со своими учетными данными Google Cloud's Agent Platform, следуйте инструкциям [Вход с Google Cloud's Agent Platform](#sign-in-with-agent-platform) ниже. Чтобы развернуть Claude Code для команды, используйте шаги [ручной установки](#set-up-manually) и [закрепите версии ваших моделей](#5-pin-model-versions) перед развертыванием.

94 94 

95<h2 id="sign-in-with-vertex-ai">95<h2 id="sign-in-with-agent-platform">

96 Вход с Vertex AI96 Вход с Agent Platform

97</h2>97</h2>

98 98 

99Если у вас есть учетные данные Google Cloud и вы хотите начать использовать Claude Code через Vertex AI, мастер входа проведет вас через этот процесс. Вы выполняете предварительные требования на стороне GCP один раз для каждого проекта; мастер обрабатывает сторону Claude Code.99Если у вас есть учетные данные Google Cloud и вы хотите начать использовать Claude Code через Agent Platform Google Cloud, мастер входа проведет вас через этот процесс. Вы выполняете предварительные требования на стороне GCP один раз для каждого проекта; мастер обрабатывает сторону Claude Code.

100 100 

101<Note>101<Note>

102 Мастер установки Vertex AI требует Claude Code v2.1.98 или более поздней версии. Запустите `claude --version` для проверки.102 Мастер установки Agent Platform Google Cloud требует Claude Code v2.1.98 или более поздней версии. Запустите `claude --version` для проверки.

103</Note>103</Note>

104 104 

105<Steps>105<Steps>

106 <Step title="Включите модели Claude в вашем проекте GCP">106 <Step title="Включите модели Claude в вашем проекте GCP">

107 [Включите API Vertex AI](#1-enable-vertex-ai-api) для вашего проекта, затем запросите доступ к моделям Claude, которые вам нужны, в [Vertex AI Model Garden](https://console.cloud.google.com/vertex-ai/model-garden). См. [Конфигурация IAM](#iam-configuration) для разрешений, которые требуются вашей учетной записи.107 [Включите API Agent Platform Google Cloud](#1-enable-agent-platform-api) для вашего проекта, затем запросите доступ к моделям Claude, которые вам нужны, в [Model Garden Agent Platform Google Cloud](https://console.cloud.google.com/vertex-ai/model-garden). См. [Конфигурация IAM](#iam-configuration) для разрешений, которые требуются вашей учетной записи.

108 </Step>108 </Step>

109 109 

110 <Step title="Запустите Claude Code и выберите Vertex AI">110 <Step title="Запустите Claude Code и выберите Agent Platform Google Cloud">

111 Запустите `claude`. В приглашении входа выберите **3rd-party platform**, затем **Google Vertex AI**.111 Запустите `claude`. В приглашении входа выберите **3rd-party platform**, затем **Google Vertex AI**, метку, которую мастер входа все еще использует для Agent Platform Google Cloud.

112 </Step>112 </Step>

113 113 

114 <Step title="Следуйте подсказкам мастера">114 <Step title="Следуйте подсказкам мастера">


122 Конфигурация региона122 Конфигурация региона

123</h2>123</h2>

124 124 

125Claude Code поддерживает Vertex AI [глобальные](https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai), многорегиональные и региональные конечные точки. Установите `CLOUD_ML_REGION` на `global`, многорегиональное местоположение, такое как `eu` или `us`, или конкретный регион, такой как `us-east5`. Claude Code выбирает правильное имя хоста Vertex AI для каждой формы, включая хосты `aiplatform.eu.rep.googleapis.com` и `aiplatform.us.rep.googleapis.com` для многорегиональных местоположений.125Claude Code поддерживает Google Cloud's Agent Platform [глобальные](https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai), многорегиональные и региональные конечные точки. Установите `CLOUD_ML_REGION` на `global`, многорегиональное местоположение, такое как `eu` или `us`, или конкретный регион, такой как `us-east5`. Claude Code выбирает правильное имя хоста Google Cloud's Agent Platform для каждой формы, включая хосты `aiplatform.eu.rep.googleapis.com` и `aiplatform.us.rep.googleapis.com` для многорегиональных местоположений.

126 126 

127<Note>127<Note>

128 Vertex AI может не поддерживать модели Claude Code по умолчанию на каждом типе конечной точки. Доступность моделей варьируется в зависимости от [конкретных регионов](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#genai-partner-models), многорегиональных местоположений и [глобальных конечных точек](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#supported_models). Вам может потребоваться переключиться на поддерживаемое местоположение или указать поддерживаемую модель.128 Google Cloud's Agent Platform может не поддерживать модели Claude Code по умолчанию на каждом типе конечной точки. Доступность моделей варьируется в зависимости от [конкретных регионов](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#genai-partner-models), многорегиональных местоположений и [глобальных конечных точек](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#supported_models). Вам может потребоваться переключиться на поддерживаемое местоположение или указать поддерживаемую модель.

129</Note>129</Note>

130 130 

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

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

133</h2>133</h2>

134 134 

135Чтобы настроить Vertex AI через переменные окружения вместо мастера, например в CI или при развертывании в масштабах предприятия, следуйте приведенным ниже шагам.135Чтобы настроить Google Cloud's Agent Platform через переменные окружения вместо мастера, например в CI или при развертывании в масштабах предприятия, следуйте приведенным ниже шагам.

136 136 

137<h3 id="1-enable-vertex-ai-api">137<h3 id="1-enable-agent-platform-api">

138 1. Включите API Vertex AI138 1. Включите API Agent Platform

139</h3>139</h3>

140 140 

141Включите API Vertex AI в вашем проекте GCP:141Включите API Agent Platform Google Cloud в вашем проекте GCP:

142 142 

143```bash theme={null}143```bash theme={null}

144# Установите ID вашего проекта144# Установите ID вашего проекта

145gcloud config set project YOUR-PROJECT-ID145gcloud config set project YOUR-PROJECT-ID

146 146 

147# Включите API Vertex AI147# Включите API Agent Platform

148gcloud services enable aiplatform.googleapis.com148gcloud services enable aiplatform.googleapis.com

149```149```

150 150 


152 2. Запросите доступ к модели152 2. Запросите доступ к модели

153</h3>153</h3>

154 154 

155Запросите доступ к моделям Claude в Vertex AI:155Запросите доступ к моделям Claude в Google Cloud's Agent Platform:

156 156 

1571. Перейдите в [Vertex AI Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)1571. Перейдите в [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)

1582. Найдите модели "Claude"1582. Найдите модели "Claude"

1593. Запросите доступ к нужным моделям Claude (например, Claude Sonnet 4.6)1593. Запросите доступ к нужным моделям Claude (например, Claude Sonnet 4.6)

1604. Дождитесь одобрения (может занять 24-48 часов)1604. Дождитесь одобрения (может занять 24-48 часов)


170Claude Code версии 2.1.121 или позже поддерживает [Федерацию рабочих нагрузок на основе сертификатов X.509](https://cloud.google.com/iam/docs/workload-identity-federation-with-x509-certificates) через ту же цепочку Application Default Credentials. Установите `GOOGLE_APPLICATION_CREDENTIALS` на путь к файлу конфигурации учетных данных.170Claude Code версии 2.1.121 или позже поддерживает [Федерацию рабочих нагрузок на основе сертификатов X.509](https://cloud.google.com/iam/docs/workload-identity-federation-with-x509-certificates) через ту же цепочку Application Default Credentials. Установите `GOOGLE_APPLICATION_CREDENTIALS` на путь к файлу конфигурации учетных данных.

171 171 

172<Note>172<Note>

173 Claude Code использует `ANTHROPIC_VERTEX_PROJECT_ID` как ID проекта для запросов Vertex AI. Переменные окружения `GCLOUD_PROJECT` и `GOOGLE_CLOUD_PROJECT` и файл учетных данных, на который ссылается `GOOGLE_APPLICATION_CREDENTIALS`, имеют приоритет над ним. Если ничего из этого не установлено, ID проекта разрешается из вашей конфигурации `gcloud` или присоединенной учетной записи сервиса.173 Claude Code использует `ANTHROPIC_VERTEX_PROJECT_ID` как ID проекта для запросов Google Cloud's Agent Platform. Переменные окружения `GCLOUD_PROJECT` и `GOOGLE_CLOUD_PROJECT` и файл учетных данных, на который ссылается `GOOGLE_APPLICATION_CREDENTIALS`, имеют приоритет над ним. Если ничего из этого не установлено, ID проекта разрешается из вашей конфигурации `gcloud` или присоединенной учетной записи сервиса.

174</Note>174</Note>

175 175 

176<h4 id="advanced-credential-configuration">176<h4 id="advanced-credential-configuration">


197Установите следующие переменные окружения:197Установите следующие переменные окружения:

198 198 

199```bash theme={null}199```bash theme={null}

200# Включите интеграцию Vertex AI200# Включите интеграцию Agent Platform

201export CLAUDE_CODE_USE_VERTEX=1201export CLAUDE_CODE_USE_VERTEX=1

202export CLOUD_ML_REGION=global202export CLOUD_ML_REGION=global

203export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID203export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

204 204 

205# Опционально: переопределите URL конечной точки Vertex для пользовательских конечных точек или шлюзов205# Опционально: переопределите URL конечной точки Agent Platform для пользовательских конечных точек или шлюзов

206# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com206# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com

207 207 

208# Опционально: отключите кэширование запросов, если необходимо208# Опционально: отключите кэширование запросов, если необходимо


216export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1216export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

217```217```

218 218 

219Большинство версий моделей имеют соответствующую переменную `VERTEX_REGION_CLAUDE_*`. Полный список см. в [справочнике переменных окружения](/ru/env-vars). Проверьте [Vertex Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), чтобы определить, какие модели поддерживают глобальные конечные точки в сравнении с региональными только.219Большинство версий моделей имеют соответствующую переменную `VERTEX_REGION_CLAUDE_*`. Полный список см. в [справочнике переменных окружения](/ru/env-vars). Проверьте [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), чтобы определить, какие модели поддерживают глобальные конечные точки в сравнении с региональными только.

220 220 

221[Кэширование запросов](/ru/prompt-caching) включается автоматически. Чтобы отключить его, установите `DISABLE_PROMPT_CACHING=1`. Чтобы запросить TTL кэша на 1 час вместо стандартного 5-минутного, установите `ENABLE_PROMPT_CACHING_1H=1`; записи кэша с TTL на 1 час тарифицируются по более высокому тарифу. Для повышенных лимитов скорости обратитесь в поддержку Google Cloud. При использовании Vertex AI команда `/logout` недоступна, так как аутентификация обрабатывается через учетные данные Google Cloud.221[Кэширование запросов](/ru/prompt-caching) включается автоматически. Чтобы отключить его, установите `DISABLE_PROMPT_CACHING=1`. Чтобы запросить TTL кэша на 1 час вместо стандартного 5-минутного, установите `ENABLE_PROMPT_CACHING_1H=1`; записи кэша с TTL на 1 час тарифицируются по более высокому тарифу. Для повышенных лимитов скорости обратитесь в поддержку Google Cloud. При использовании Google Cloud's Agent Platform команда `/logout` недоступна, так как аутентификация обрабатывается через учетные данные Google Cloud.

222 222 

223Claude Code отключает [поиск инструментов MCP](/ru/mcp#scale-with-mcp-tool-search) по умолчанию на Vertex AI, поэтому определения инструментов MCP загружаются заранее. Vertex AI поддерживает поиск инструментов для Claude Sonnet 4.5 и позже, а также Claude Opus 4.5 и позже. Установите `ENABLE_TOOL_SEARCH=true`, чтобы включить его на этих моделях. Более ранние модели на Vertex AI не принимают требуемый бета-заголовок, и запросы не выполняются, если вы включите поиск инструментов с ними.223Claude Code отключает [поиск инструментов MCP](/ru/mcp#scale-with-mcp-tool-search) по умолчанию на Google Cloud's Agent Platform, поэтому определения инструментов MCP загружаются заранее. Google Cloud's Agent Platform поддерживает поиск инструментов для Claude Sonnet 4.5 и позже, а также Claude Opus 4.5 и позже. Установите `ENABLE_TOOL_SEARCH=true`, чтобы включить его на этих моделях. Более ранние модели на Google Cloud's Agent Platform не принимают требуемый бета-заголовок, и запросы не выполняются, если вы включите поиск инструментов с ними.

224 224 

225<h3 id="5-pin-model-versions">225<h3 id="5-pin-model-versions">

226 5. Закрепите версии моделей226 5. Закрепите версии моделей

227</h3>227</h3>

228 228 

229<Warning>229<Warning>

230 Закрепите конкретные версии моделей при развертывании для нескольких пользователей. Без закрепления псевдонимы моделей, такие как `sonnet` и `opus`, разрешаются в последнюю версию, которая может быть еще не включена в вашем проекте Vertex AI при выпуске Anthropic обновления. Claude Code [откатывается](#startup-model-checks) на предыдущую версию при запуске, когда последняя недоступна, но закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.230 Закрепите конкретные версии моделей при развертывании для нескольких пользователей. Без закрепления псевдонимы моделей, такие как `sonnet` и `opus`, разрешаются в встроенное значение по умолчанию Claude Code для Google Cloud's Agent Platform, которое может отставать от последнего выпуска и может быть еще не включено в вашем проекте. Claude Code [откатывается](#startup-model-checks) на предыдущую версию при запуске, когда значение по умолчанию недоступно, но закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.

231</Warning>231</Warning>

232 232 

233Установите эти переменные окружения на конкретные ID моделей Vertex AI.233Установите эти переменные окружения на конкретные ID моделей Google Cloud's Agent Platform.

234 234 

235Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Vertex разрешается в Opus 4.6. Установите его на ID Opus 4.8, чтобы использовать последнюю модель:235Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Google Cloud's Agent Platform разрешается в Opus 4.6. Установите его на ID Opus 4.8, чтобы использовать последнюю модель:

236 236 

237```bash theme={null}237```bash theme={null}

238export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'238export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'


249| Основная модель | `claude-sonnet-4-5@20250929` |249| Основная модель | `claude-sonnet-4-5@20250929` |

250| Малая/быстрая модель | То же, что и основная модель |250| Малая/быстрая модель | То же, что и основная модель |

251 251 

252Фоновые задачи, такие как генерация названия сеанса, используют малую/быструю модель, обычно модель класса Haiku. На Vertex AI Claude Code по умолчанию использует основную модель, потому что Haiku может быть не включен в каждом проекте или регионе. Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на ID модели, который доступен в вашем проекте.252Фоновые задачи, такие как генерация названия сеанса, используют малую/быструю модель, обычно модель класса Haiku. На Google Cloud's Agent Platform Claude Code по умолчанию использует основную модель, потому что Haiku может быть не включен в каждом проекте или регионе. Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на ID модели, который доступен в вашем проекте.

253 253 

254Для дальнейшей настройки моделей:254Для дальнейшей настройки моделей:

255 255 


262 Проверки моделей при запуске262 Проверки моделей при запуске

263</h2>263</h2>

264 264 

265Когда Claude Code запускается с настроенным Vertex AI, он проверяет, что модели, которые он намеревается использовать, доступны в вашем проекте. Эта проверка требует Claude Code v2.1.98 или более поздней версии.265Когда Claude Code запускается с настроенной платформой Google Cloud Agent Platform, он проверяет, что модели, которые он намеревается использовать, доступны в вашем проекте. Эта проверка требует Claude Code v2.1.98 или более поздней версии.

266 266 

267Если вы закрепили версию модели, которая старше текущего значения по умолчанию Claude Code, и ваш проект может вызывать более новую версию, Claude Code предлагает вам обновить закрепление. Принятие записывает новый ID модели в ваш [файл пользовательских настроек](/ru/settings) и перезапускает Claude Code. Отклонение запоминается до следующего изменения версии по умолчанию.267Если вы закрепили версию модели, которая старше текущего значения по умолчанию Claude Code, и ваш проект может вызывать более новую версию, Claude Code предлагает вам обновить закрепление. Принятие записывает новый ID модели в ваш [файл пользовательских настроек](/ru/settings) и перезапускает Claude Code. Отклонение запоминается до следующего изменения версии по умолчанию.

268 268 


280 280 

281Для более строгих разрешений создайте пользовательскую роль только с указанными выше разрешениями.281Для более строгих разрешений создайте пользовательскую роль только с указанными выше разрешениями.

282 282 

283Для получения дополнительной информации см. [документацию Vertex IAM](https://cloud.google.com/vertex-ai/docs/general/access-control).283Для получения дополнительной информации см. [документацию Google Cloud Agent Platform IAM](https://cloud.google.com/vertex-ai/docs/general/access-control).

284 284 

285<Note>285<Note>

286 Создайте выделенный проект GCP для Claude Code, чтобы упростить отслеживание затрат и контроль доступа.286 Создайте выделенный проект GCP для Claude Code, чтобы упростить отслеживание затрат и контроль доступа.


290 Контекстное окно с 1M токенов290 Контекстное окно с 1M токенов

291</h2>291</h2>

292 292 

293Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [контекстное окно с 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window) на Vertex AI. Sonnet 5 всегда работает с окном 1M, без варианта `[1m]` для выбора. Для других моделей Claude Code автоматически включает расширенное контекстное окно при выборе варианта модели с 1M.293Claude 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.

294 294 

295[Мастер установки](#sign-in-with-vertex-ai) предлагает опцию контекстного окна с 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели, добавьте `[1m]` к ID модели. Подробности см. в разделе [Закрепите модели для развертываний третьих сторон](/ru/model-config#pin-models-for-third-party-deployments).295[Мастер установки](#sign-in-with-agent-platform) предлагает опцию контекстного окна с 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели, добавьте `[1m]` к ID модели. Подробности см. в разделе [Закрепите модели для развертываний третьих сторон](/ru/model-config#pin-models-for-third-party-deployments).

296 296 

297<h2 id="troubleshooting">297<h2 id="troubleshooting">

298 Устранение неполадок298 Устранение неполадок


325 Дополнительные ресурсы325 Дополнительные ресурсы

326</h2>326</h2>

327 327 

328* [Документация Vertex AI](https://cloud.google.com/vertex-ai/docs)328* [Документация Google Cloud's Agent Platform](https://cloud.google.com/vertex-ai/docs)

329* [Цены Vertex AI](https://cloud.google.com/vertex-ai/pricing)329* [Цены Google Cloud's Agent Platform](https://cloud.google.com/vertex-ai/pricing)

330* [Квоты и лимиты Vertex AI](https://cloud.google.com/vertex-ai/docs/quotas)330* [Квоты и лимиты Google Cloud's Agent Platform](https://cloud.google.com/vertex-ai/docs/quotas)

headless.md +9 −3

Details

56| Пользовательские агенты | `--agents <json>` |56| Пользовательские агенты | `--agents <json>` |

57| Плагин | `--plugin-dir <path>`, `--plugin-url <url>` |57| Плагин | `--plugin-dir <path>`, `--plugin-url <url>` |

58 58 

59Режим bare пропускает OAuth и чтение из связки ключей. Аутентификация Anthropic должна поступать из `ANTHROPIC_API_KEY` или `apiKeyHelper` в JSON, переданном в `--settings`. Bedrock, Vertex и Foundry используют обычные учётные данные поставщика.59Режим bare пропускает OAuth и чтение из связки ключей. Аутентификация Anthropic должна поступать из `ANTHROPIC_API_KEY` или `apiKeyHelper` в JSON, переданном в `--settings`. Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry используют обычные учётные данные поставщика.

60 60 

61<Note>61<Note>

62 `--bare` — это рекомендуемый режим для скриптовых и SDK вызовов, и он станет режимом по умолчанию для `-p` в будущем выпуске.62 `--bare` — это рекомендуемый режим для скриптовых и SDK вызовов, и он станет режимом по умолчанию для `-p` в будущем выпуске.


136 --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'136 --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'

137```137```

138 138 

139Если значение не является действительной JSON Schema, `claude` выходит с `Error: --json-schema is not a valid JSON Schema`, за которым следует диагностика валидатора. Claude Code принимает схемы, которые используют ключевое слово `format`, такие как `"format": "email"`, но рассматривает `format` как аннотацию и не применяет его. До версии v2.1.205 Claude Code молча игнорировал недействительную схему и возвращал неструктурированный текст, а также рассматривал любую схему, содержащую `format`, как недействительную.

140 

139<Tip>141<Tip>

140 Используйте инструмент вроде [jq](https://jqlang.github.io/jq/) для анализа ответа и извлечения определённых полей:142 Используйте инструмент вроде [jq](https://jqlang.github.io/jq/) для анализа ответа и извлечения определённых полей:

141 143 


182| `uuid` | строка | уникальный идентификатор события |184| `uuid` | строка | уникальный идентификатор события |

183| `session_id` | строка | сессия, к которой принадлежит событие |185| `session_id` | строка | сессия, к которой принадлежит событие |

184 186 

185Событие `system/init` сообщает метаданные сессии, включая модель, инструменты, MCP серверы и загруженные плагины. Это первое событие в потоке, если не установлена [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ru/env-vars), в этом случае события `plugin_install` предшествуют ему. Используйте поля плагина для отказа CI, когда плагин не загрузился:187Событие `system/init` сообщает метаданные сессии, включая модель, инструменты, MCP серверы и загруженные плагины. Это первое событие в потоке, если не установлена [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ru/env-vars), в этом случае события `plugin_install` предшествуют ему.

188 

189Событие также содержит опциональный массив `capabilities` строк, называющих поведения протокола, которые реализует эта версия Claude Code, такие как `interrupt_receipt_v1`. Проверьте его для обнаружения функций вместо сравнения строк версий и игнорируйте значения, которые вы не распознаёте. Поле требует Claude Code v2.1.205 или позже и отсутствует в более ранних версиях. См. [`SDKSystemMessage`](/ru/agent-sdk/typescript#sdksystemmessage) для списка возможностей.

190 

191Используйте поля плагина для отказа CI, когда плагин не загрузился:

186 192 

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

188| --------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |194| --------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |


234Флаг `--allowedTools` использует [синтаксис правил разрешений](/ru/settings#permission-rule-syntax). Завершающий ` *` включает сопоставление префиксов, поэтому `Bash(git diff *)` разрешает любую команду, начинающуюся с `git diff`. Пробел перед `*` важен: без него `Bash(git diff*)` также совпадал бы с `git diff-index`.240Флаг `--allowedTools` использует [синтаксис правил разрешений](/ru/settings#permission-rule-syntax). Завершающий ` *` включает сопоставление префиксов, поэтому `Bash(git diff *)` разрешает любую команду, начинающуюся с `git diff`. Пробел перед `*` важен: без него `Bash(git diff*)` также совпадал бы с `git diff-index`.

235 241 

236<Note>242<Note>

237 Вызываемые пользователем [skills](/ru/skills) и пользовательские команды работают в режиме `-p`: включите `/skill-name` в строку запроса, и Claude Code развернёт её перед запуском. Встроенные команды, которые открывают интерактивный диалог, такие как `/login`, недоступны в режиме `-p`. {/* min-version: 2.1.181 */}Чтобы изменить параметр из вызова `-p`, передайте `key=value` в `/config`, например `/config thinking=false`.243 Вызываемые пользователем [skills](/ru/skills) и пользовательские команды работают в режиме `-p`: включите `/skill-name` в строку запроса, и Claude Code развернёт её перед запуском. Встроенные команды, которые только работают в интерфейсе терминала, такие как `/login`, недоступны в режиме `-p`. {/* min-version: 2.1.205 */}`/model`, `/effort`, `/fast`, `/color` и `/rename` принимают значение как аргумент, например `/model sonnet`, и `/mcp` без аргумента выводит текстовую сводку статуса сервера; эти формы требуют Claude Code v2.1.205 или позже и следуют [примечаниям доступности](/ru/commands#all-commands) каждой команды. {/* min-version: 2.1.181 */}Чтобы изменить параметр из вызова `-p`, передайте `key=value` в `/config`, например `/config thinking=false`.

238</Note>244</Note>

239 245 

240<h3 id="customize-the-system-prompt">246<h3 id="customize-the-system-prompt">

hooks.md +14 −8

Details

280 280 

281Дефисы в наборе точного совпадения требуют Claude Code v2.1.195 или позже. На более ранних версиях голый дефисный префикс, такой как `mcp__brave-search`, оценивается как регулярное выражение без привязки и совпадает с каждым инструментом с этого сервера. Форма `mcp__brave-search__.*` работает на каждой версии.281Дефисы в наборе точного совпадения требуют Claude Code v2.1.195 или позже. На более ранних версиях голый дефисный префикс, такой как `mcp__brave-search`, оценивается как регулярное выражение без привязки и совпадает с каждым инструментом с этого сервера. Форма `mcp__brave-search__.*` работает на каждой версии.

282 282 

283Инструменты из [plugin-bundled MCP server](/ru/mcp#plugin-provided-mcp-servers) используют сегмент сервера с областью, который включает имя плагина: `mcp__plugin_<plugin-name>_<server-name>__<tool>`. Фильтр, написанный против голого ключа сервера, никогда не срабатывает для этих инструментов. Для плагина с именем `my-plugin`, который объединяет сервер под ключом `db`, инструмент `query` отображается как `mcp__plugin_my-plugin_db__query`, поэтому фильтр для каждого инструмента с этого сервера — `mcp__plugin_my-plugin_db__.*`. Используйте то же имя инструмента с областью в поле [`if`](#common-fields) обработчика. См. [Plugin-provided MCP servers](/ru/mcp#plugin-provided-mcp-servers) для того, как строится имя с областью.

284 

283Этот пример логирует все операции сервера memory и проверяет операции записи из любого MCP сервера:285Этот пример логирует все операции сервера memory и проверяет операции записи из любого MCP сервера:

284 286 

285```json theme={null}287```json theme={null}


456В дополнение к [общим полям](#common-fields), MCP tool hooks принимают эти поля:458В дополнение к [общим полям](#common-fields), MCP tool hooks принимают эти поля:

457 459 

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

459| :------- | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |461| :------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

460| `server` | да | Имя настроенного MCP сервера. Сервер должен быть уже подключён; hook никогда не запускает поток OAuth или подключения |462| `server` | да | Имя настроенного MCP сервера. Для [plugin-bundled server](/ru/mcp#plugin-provided-mcp-servers), это имя с областью `plugin:<plugin-name>:<server-name>`, такое как `plugin:my-plugin:db`, не голый ключ сервера. Сервер должен быть уже подключён; hook никогда не запускает поток OAuth или подключения |

461| `tool` | да | Имя инструмента для вызова на этом сервере |463| `tool` | да | Имя инструмента для вызова на этом сервере |

462| `input` | нет | Аргументы, передаваемые инструменту. Строковые значения поддерживают подстановку `${path}` из [JSON входа](#hook-input-and-output) hook, такую как `"${tool_input.file_path}"` |464| `input` | нет | Аргументы, передаваемые инструменту. Строковые значения поддерживают подстановку `${path}` из [JSON входа](#hook-input-and-output) hook, такую как `"${tool_input.file_path}"` |

463 465 


638| :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |640| :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

639| `session_id` | Текущий идентификатор сеанса |641| `session_id` | Текущий идентификатор сеанса |

640| `prompt_id` | UUID, идентифицирующий пользовательский запрос, который в настоящее время обрабатывается. Совпадает с атрибутом [`prompt.id` на событиях OpenTelemetry](/ru/monitoring-usage#event-correlation-attributes), поэтому вы можете коррелировать выход hook с телеметрией для одного запроса. Отсутствует до первого пользовательского ввода. {/* min-version: 2.1.196 */}Требует Claude Code v2.1.196 или позже |642| `prompt_id` | UUID, идентифицирующий пользовательский запрос, который в настоящее время обрабатывается. Совпадает с атрибутом [`prompt.id` на событиях OpenTelemetry](/ru/monitoring-usage#event-correlation-attributes), поэтому вы можете коррелировать выход hook с телеметрией для одного запроса. Отсутствует до первого пользовательского ввода. {/* min-version: 2.1.196 */}Требует Claude Code v2.1.196 или позже |

641| `transcript_path` | Путь к JSON разговора |643| `transcript_path` | Путь к JSON разговора. Файл транскрипта записывается асинхронно и может отставать от разговора в памяти, поэтому он может ещё не включать самые последние сообщения текущего хода, когда срабатывает hook. Hooks, которым нужен финальный текст ассистента текущего хода, должны использовать `last_assistant_message` на [Stop](#stop) и [SubagentStop](#subagentstop) вместо чтения транскрипта |

642| `cwd` | Текущий рабочий каталог при вызове hook |644| `cwd` | Текущий рабочий каталог при вызове hook |

643| `permission_mode` | Текущий [режим разрешения](/ru/permissions#permission-modes): `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` или `"bypassPermissions"`. Не все события получают это поле: см. пример JSON каждого события ниже для проверки |645| `permission_mode` | Текущий [режим разрешения](/ru/permissions#permission-modes): `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` или `"bypassPermissions"`. Режим, обозначенный как **Manual**, поступает как `"default"`, никогда не как `"manual"`, поэтому скрипты, которые совпадают с `"default"`, продолжают работать. Не все события получают это поле. Проверьте пример JSON в каждом разделе [hook event](#hook-events) |

644| `effort` | Объект с полем `level`, содержащим активный [уровень усилий](/ru/model-config#adjust-effort-level) для хода: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Если запрошенный уровень усилий модели превышает то, что поддерживает текущая модель, это понижающий уровень, который модель фактически использовала. Ultracode не является отдельным уровнем и сообщается как `"xhigh"`. Объект соответствует полю `effort` [строки статуса](/ru/statusline#available-data). Присутствует для событий, которые срабатывают в контексте использования инструмента, таких как `PreToolUse`, `PostToolUse`, `Stop` и `SubagentStop`, когда текущая модель поддерживает параметр усилий. Уровень также доступен для команд hook и инструмента Bash как переменная окружения `$CLAUDE_EFFORT`. |646| `effort` | Объект с полем `level`, содержащим активный [уровень усилий](/ru/model-config#adjust-effort-level) для хода: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Если запрошенный уровень усилий модели превышает то, что поддерживает текущая модель, это понижающий уровень, который модель фактически использовала. Ultracode не является отдельным уровнем и сообщается как `"xhigh"`. Объект соответствует полю `effort` [строки статуса](/ru/statusline#available-data). Присутствует для событий, которые срабатывают в контексте использования инструмента, таких как `PreToolUse`, `PostToolUse`, `Stop` и `SubagentStop`, когда текущая модель поддерживает параметр усилий. Уровень также доступен для команд hook и инструмента Bash как переменная окружения `$CLAUDE_EFFORT`. |

645| `hook_event_name` | Имя события, которое сработало |647| `hook_event_name` | Имя события, которое сработало |

646 648 


1592Представляет план и просит пользователя одобрить его перед тем, как Claude покинет [plan mode](/ru/permission-modes#analyze-before-you-edit-with-plan-mode). Claude записывает план в файл на диск перед вызовом инструмента, поэтому буквальный `tool_input` от модели содержит только `allowedPrompts`. Claude Code внедряет содержимое плана и путь файла перед передачей входных данных в hooks.1594Представляет план и просит пользователя одобрить его перед тем, как Claude покинет [plan mode](/ru/permission-modes#analyze-before-you-edit-with-plan-mode). Claude записывает план в файл на диск перед вызовом инструмента, поэтому буквальный `tool_input` от модели содержит только `allowedPrompts`. Claude Code внедряет содержимое плана и путь файла перед передачей входных данных в hooks.

1593 1595 

1594| Поле | Тип | Пример | Описание |1596| Поле | Тип | Пример | Описание |

1595| :--------------- | :----- | :------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |1597| :--------------- | :----- | :------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1596| `plan` | string | `"## Refactor auth\n1. Extract..."` | Содержимое плана в Markdown. Внедрено из файла плана на диске |1598| `plan` | string | `"## Refactor auth\n1. Extract..."` | Содержимое плана в Markdown. Внедрено из файла плана на диске |

1597| `planFilePath` | string | `"/Users/.../plans/refactor-auth.md"` | Путь к файлу плана. Внедрено |1599| `planFilePath` | string | `"/Users/.../plans/refactor-auth.md"` | Путь к файлу плана. Внедрено |

1598| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | Опциональный. Разрешения на основе подсказки, которые Claude запрашивает для реализации плана, каждое с именем `tool` и `prompt`, описывающим категорию действия |1600| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | {/* min-version: 2.1.205 */}Устарело. Claude Code принимает поле, но игнорирует его. До v2.1.205 оно содержало разрешения на основе подсказки, которые Claude запрашивал для реализации плана |

1599 1601 

1600В `PostToolUse`, `tool_response` — это объект с полями `plan` и `filePath`, содержащими одобренный план, плюс внутренние флаги статуса. Читайте `tool_response.plan` для содержимого плана, а не перечитывайте файл с диска.1602В `PostToolUse`, `tool_response` — это объект с полями `plan` и `filePath`, содержащими одобренный план, плюс внутренние флаги статуса. Читайте `tool_response.plan` для содержимого плана, а не перечитывайте файл с диска.

1601 1603 


1755Поле выхода `updatedPermissions` и поле входа [`permission_suggestions`](#permissionrequest-input) оба используют один и тот же массив объектов записей. Каждая запись имеет `type`, который определяет её другие поля, и `destination`, который управляет тем, где применяется изменение.1757Поле выхода `updatedPermissions` и поле входа [`permission_suggestions`](#permissionrequest-input) оба используют один и тот же массив объектов записей. Каждая запись имеет `type`, который определяет её другие поля, и `destination`, который управляет тем, где применяется изменение.

1756 1758 

1757| `type` | Поля | Эффект |1759| `type` | Поля | Эффект |

1758| :------------------ | :--------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1760| :------------------ | :--------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1759| `addRules` | `rules`, `behavior`, `destination` | Добавляет правила разрешения. `rules` — это массив объектов `{toolName, ruleContent?}`. Опустите `ruleContent` для совпадения со всем инструментом. `behavior` — это `"allow"`, `"deny"` или `"ask"` |1761| `addRules` | `rules`, `behavior`, `destination` | Добавляет правила разрешения. `rules` — это массив объектов `{toolName, ruleContent?}`. Опустите `ruleContent` для совпадения со всем инструментом. `behavior` — это `"allow"`, `"deny"` или `"ask"` |

1760| `replaceRules` | `rules`, `behavior`, `destination` | Заменяет все правила данного `behavior` в `destination` предоставленными `rules` |1762| `replaceRules` | `rules`, `behavior`, `destination` | Заменяет все правила данного `behavior` в `destination` предоставленными `rules` |

1761| `removeRules` | `rules`, `behavior`, `destination` | Удаляет совпадающие правила данного `behavior` |1763| `removeRules` | `rules`, `behavior`, `destination` | Удаляет совпадающие правила данного `behavior` |

1762| `setMode` | `mode`, `destination` | Изменяет режим разрешения. Допустимые режимы — `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions` и `plan` |1764| `setMode` | `mode`, `destination` | Изменяет режим разрешения. Допустимые режимы — `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` и {/* min-version: 2.1.200 */}`manual` как псевдоним для `default`. Псевдоним `manual` требует Claude Code v2.1.200 или позже |

1763| `addDirectories` | `directories`, `destination` | Добавляет рабочие каталоги. `directories` — это массив строк пути |1765| `addDirectories` | `directories`, `destination` | Добавляет рабочие каталоги. `directories` — это массив строк пути |

1764| `removeDirectories` | `directories`, `destination` | Удаляет рабочие каталоги |1766| `removeDirectories` | `directories`, `destination` | Удаляет рабочие каталоги |

1765 1767 


2699 2701 

2700Если hook не удаётся или не производит путь, создание worktree не удаётся с ошибкой.2702Если hook не удаётся или не производит путь, создание worktree не удаётся с ошибкой.

2701 2703 

2704Claude Code разрешает относительный путь против каталога, в котором запустился hook. Если результирующий путь не является каталогом, который Claude Code может ввести, сеанс выводит ошибку, называющую путь, и выходит с кодом 1. До v2.1.205 относительный путь или путь, который не существовал на диске, вызывал сбой сеанса при запуске, и с `-p` он зависал примерно на 30 секунд перед выходом с кодом 0.

2705 

2702<h3 id="worktreeremove">2706<h3 id="worktreeremove">

2703 WorktreeRemove2707 WorktreeRemove

2704</h3>2708</h3>


3220 3224 

3221После выхода фонового процесса, если hook произвёл JSON ответ с полем `additionalContext`, это содержимое доставляется Claude как контекст на следующем ходу разговора. Поле `systemMessage` показывается вам, а не Claude.3225После выхода фонового процесса, если hook произвёл JSON ответ с полем `additionalContext`, это содержимое доставляется Claude как контекст на следующем ходу разговора. Поле `systemMessage` показывается вам, а не Claude.

3222 3226 

3227Claude Code проверяет, что JSON ответ соответствует той же [схеме выходных данных](#json-output), что и синхронные hooks, и отбрасывает любое поле, значение которого имеет неправильный тип, например `systemMessage`, который не является строкой, вместо его доставки. Запустите с `--debug` для просмотра предупреждения, называющего каждое отброшенное поле. До версии v2.1.202 неправильно сформированный JSON выход из асинхронного hook мог привести к сбою сеанса, и сбой повторялся каждый раз при возобновлении сеанса.

3228 

3223Уведомления о завершении асинхронного hook подавляются по умолчанию. Чтобы их увидеть, включите подробный режим с помощью `Ctrl+O` или запустите Claude Code с `--verbose`.3229Уведомления о завершении асинхронного hook подавляются по умолчанию. Чтобы их увидеть, включите подробный режим с помощью `Ctrl+O` или запустите Claude Code с `--verbose`.

3224 3230 

3225<h3 id="run-tests-after-file-changes">3231<h3 id="run-tests-after-file-changes">

hooks-guide.md +1 −1

Details

695 </Tab>695 </Tab>

696 696 

697 <Tab title="Соответствие MCP инструментам">697 <Tab title="Соответствие MCP инструментам">

698 MCP инструменты используют другое соглашение об именовании, чем встроенные инструменты: `mcp__<server>__<tool>`, где `<server>` — имя MCP сервера, а `<tool>` — инструмент, который он предоставляет. Например, `mcp__github__search_repositories` или `mcp__filesystem__read_file`. Используйте matcher regex для нацеливания на все инструменты с определённого сервера, или соответствуйте серверам с шаблоном, таким как `mcp__.*__write.*`. См. [Match MCP tools](/ru/hooks#match-mcp-tools) в справочнике для полного списка примеров.698 MCP инструменты используют другое соглашение об именовании, чем встроенные инструменты: `mcp__<server>__<tool>`, где `<server>` — имя MCP сервера, а `<tool>` — инструмент, который он предоставляет. Например, `mcp__github__search_repositories` или `mcp__filesystem__read_file`. Инструменты из [plugin-bundled server](/ru/mcp#plugin-provided-mcp-servers) используют вместо этого сегмент сервера с областью видимости, такой как `mcp__plugin_my-plugin_db__query`. Используйте matcher regex для нацеливания на все инструменты с определённого сервера, или соответствуйте серверам с шаблоном, таким как `mcp__.*__write.*`. См. [Match MCP tools](/ru/hooks#match-mcp-tools) в справочнике для полного списка примеров.

699 699 

700 Команда ниже извлекает имя инструмента из JSON ввода hook с помощью `jq` и записывает его в stderr. Запись в stderr сохраняет stdout чистым для вывода JSON и отправляет сообщение в [debug log](/ru/hooks#debug-hooks):700 Команда ниже извлекает имя инструмента из JSON ввода hook с помощью `jq` и записывает его в stderr. Запись в stderr сохраняет stdout чистым для вывода JSON и отправляет сообщение в [debug log](/ru/hooks#debug-hooks):

701 701 

Details

186 186 

187Нажмите `Shift+Tab`, чтобы циклически переключаться между режимами разрешений:187Нажмите `Shift+Tab`, чтобы циклически переключаться между режимами разрешений:

188 188 

189* **По умолчанию**: Claude спрашивает перед редактированием файлов и командами shell189* **Manual**: Claude спрашивает перед редактированием файлов и командами shell

190* **Автоматическое принятие редактирования**: Claude редактирует файлы и запускает общие команды файловой системы, такие как `mkdir` и `mv`, без запроса, всё ещё спрашивает для других команд190* **Accept edits**: Claude редактирует файлы и запускает общие команды файловой системы, такие как `mkdir` и `mv`, без запроса, всё ещё спрашивает для других команд

191* **Plan Mode**: Claude исследует и предлагает план без редактирования ваших исходных файлов; запросы разрешений по-прежнему применяются, как в режиме по умолчанию191* **Plan**: Claude исследует и предлагает план без редактирования ваших исходных файлов; запросы разрешений по-прежнему применяются, как в режиме Manual

192* **Auto mode**: Claude оценивает все действия с проверками безопасности в фоновом режиме. В настоящее время это исследовательский предпросмотр192* **Auto**: Claude оценивает все действия с проверками безопасности в фоновом режиме. В настоящее время это исследовательский предпросмотр

193 193 

194Вы также можете разрешить определённые команды в `.claude/settings.json`, чтобы Claude не спрашивал каждый раз. Это полезно для доверенных команд, таких как `npm test` или `git status`. Параметры могут быть ограничены от политик на уровне организации до личных предпочтений. Подробности см. в разделе [Разрешения](/ru/permissions).194Вы также можете разрешить определённые команды в `.claude/settings.json`, чтобы Claude не спрашивал каждый раз. Это полезно для доверенных команд, таких как `npm test` или `git status`. Параметры могут быть ограничены от политик на уровне организации до личных предпочтений. Подробности см. в разделе [Разрешения](/ru/permissions).

195 195 


210Встроенные команды также помогут вам в настройке:210Встроенные команды также помогут вам в настройке:

211 211 

212* `/init` проведёт вас через создание CLAUDE.md для вашего проекта212* `/init` проведёт вас через создание CLAUDE.md для вашего проекта

213* `/doctor` диагностирует распространённые проблемы с вашей установкой213* `/doctor` запускает проверку настройки, которая диагностирует проблемы с установкой и конфигурацией и может их исправить

214 214 

215<h3 id="it’s-a-conversation">215<h3 id="it’s-a-conversation">

216 Это беседа216 Это беседа

Details

40| `Ctrl+T` | Переключить список задач Claude | Показать или скрыть [список задач Claude](#task-list) в области статуса. Это не просмотр фоновых задач; используйте [`/tasks`](/ru/commands) для просмотра выполняющихся оболочек и подагентов |40| `Ctrl+T` | Переключить список задач Claude | Показать или скрыть [список задач Claude](#task-list) в области статуса. Это не просмотр фоновых задач; используйте [`/tasks`](/ru/commands) для просмотра выполняющихся оболочек и подагентов |

41| `Left/Right arrows` | Переключение между вкладками диалога | Навигация между вкладками в диалогах разрешений и меню |41| `Left/Right arrows` | Переключение между вкладками диалога | Навигация между вкладками в диалогах разрешений и меню |

42| `Up/Down arrows` или `Ctrl+P`/`Ctrl+N` | Переместить курсор или навигировать по истории команд | Когда ввод занимает более одной визуальной строки, будь то обернутый или многострочный, сначала перемещает курсор внутри запроса. Когда курсор находится на первой или последней визуальной строке, повторное нажатие навигирует по истории команд. {/* min-version: 2.1.169 */}Начиная с версии 2.1.169, обернутый однострочный ввод ведет себя так же, как многострочный |42| `Up/Down arrows` или `Ctrl+P`/`Ctrl+N` | Переместить курсор или навигировать по истории команд | Когда ввод занимает более одной визуальной строки, будь то обернутый или многострочный, сначала перемещает курсор внутри запроса. Когда курсор находится на первой или последней визуальной строке, повторное нажатие навигирует по истории команд. {/* min-version: 2.1.169 */}Начиная с версии 2.1.169, обернутый однострочный ввод ведет себя так же, как многострочный |

43| `Esc` | Прервать Claude | Остановите текущий ответ или вызов инструмента в середине хода, чтобы вы могли перенаправить. Claude сохраняет выполненную работу |43| `Esc` | Прервать Claude или закрыть диалог | Остановите текущий ответ или вызов инструмента в середине хода, чтобы вы могли перенаправить. Claude сохраняет выполненную работу. Когда открыт диалог, такой как запрос разрешения, `Esc` закрывает диалог, а не прерывает Claude. {/* min-version: 2.1.202 */}До версии 2.1.202 `Esc` в некоторых диалогах прерывал Claude и оставлял диалог открытым |

44| `Esc` + `Esc` | Очистить черновик ввода или перемотать | Когда ввод запроса содержит текст, двойное нажатие `Esc` очищает его и сохраняет черновик в историю, чтобы `Up` мог его вспомнить. Когда ввод пуст, двойное нажатие `Esc` открывает [меню перемотки](/ru/checkpointing) для восстановления или резюме кода и разговора из предыдущей точки |44| `Esc` + `Esc` | Очистить черновик ввода или перемотать | Когда ввод запроса содержит текст, двойное нажатие `Esc` очищает его и сохраняет черновик в историю, чтобы `Up` мог его вспомнить. Когда ввод пуст, двойное нажатие `Esc` открывает [меню перемотки](/ru/checkpointing) для восстановления или резюме кода и разговора из предыдущей точки |

45| `Shift+Tab` или `Alt+M` (некоторые конфигурации) | Переключить режимы разрешений | Переключайтесь между `default`, `acceptEdits`, `plan` и любыми включенными вами режимами, такими как `auto` или `bypassPermissions`. См. [режимы разрешений](/ru/permission-modes). |45| `Shift+Tab` или `Alt+M` (некоторые конфигурации) | Переключить режимы разрешений | Переключайтесь между `default` (обозначено как Manual в индикаторе режима), `acceptEdits`, `plan` и любыми включенными вами режимами, такими как `auto` или `bypassPermissions`. См. [режимы разрешений](/ru/permission-modes). |

46| `Option+P` (macOS) или `Alt+P` (Windows/Linux) | Переключить модель | Переключайте модели без очистки вашего запроса |46| `Option+P` (macOS) или `Alt+P` (Windows/Linux) | Переключить модель | Переключайте модели без очистки вашего запроса |

47| `Option+T` (macOS) или `Alt+T` (Windows/Linux) | Переключить расширенное мышление | Включите или отключите режим расширенного мышления. Не влияет на Fable 5, который всегда использует расширенное мышление. {/* min-version: 2.1.132 */}Начиная с версии 2.1.132 это сочетание клавиш работает на macOS без настройки Option как Meta |47| `Option+T` (macOS) или `Alt+T` (Windows/Linux) | Переключить расширенное мышление | Включите или отключите режим расширенного мышления. Не влияет на Fable 5, который всегда использует расширенное мышление. {/* min-version: 2.1.132 */}Начиная с версии 2.1.132 это сочетание клавиш работает на macOS без настройки Option как Meta |

48| `Option+O` (macOS) или `Alt+O` (Windows/Linux) | Переключить быстрый режим | Включите или отключите [быстрый режим](/ru/fast-mode) |48| `Option+O` (macOS) или `Alt+O` (Windows/Linux) | Переключить быстрый режим | Включите или отключите [быстрый режим](/ru/fast-mode) |


270 270 

271Поиск загружает 100 самых последних уникальных приглашений в выбранной области, с дубликатами, свёрнутыми до самого нового появления. Совпадающие приглашения отображаются с выделенным поисковым термином, поэтому вы можете найти и повторно использовать предыдущие вводы.271Поиск загружает 100 самых последних уникальных приглашений в выбранной области, с дубликатами, свёрнутыми до самого нового появления. Совпадающие приглашения отображаются с выделенным поисковым термином, поэтому вы можете найти и повторно использовать предыдущие вводы.

272 272 

273Принятие совпадения или отмена поиска вступают в силу немедленно, даже если Claude Code всё ещё загружает историю. До версии 2.1.202 принятие или отмена во время этой загрузки могли привести к внутренней ошибке.

274 

273<h2 id="background-bash-commands">275<h2 id="background-bash-commands">

274 Фоновые bash команды276 Фоновые bash команды

275</h2>277</h2>

keybindings.md +12 −13

Details

71| `Select` | Универсальные компоненты выбора/списка |71| `Select` | Универсальные компоненты выбора/списка |

72| `Plugin` | Диалог plugin (обзор, обнаружение, управление) |72| `Plugin` | Диалог plugin (обзор, обнаружение, управление) |

73| `Scroll` | Прокрутка разговора и выделение текста в полноэкранном режиме |73| `Scroll` | Прокрутка разговора и выделение текста в полноэкранном режиме |

74| `Doctor` | Экран диагностики `/doctor` |74 

75{/* max-version: 2.1.204 */}До версии 2.1.205 контекст `Doctor` и действие `doctor:fix` существовали для экрана диагностики `/doctor`.

75 76 

76<h2 id="available-actions">77<h2 id="available-actions">

77 Доступные действия78 Доступные действия


356| `select:accept` | Enter, Space | Изменить выбранный параметр или открыть его подменю |357| `select:accept` | Enter, Space | Изменить выбранный параметр или открыть его подменю |

357| `confirm:no` | Escape | Закрыть панель. Изменения уже сохранены |358| `confirm:no` | Escape | Закрыть панель. Изменения уже сохранены |

358 359 

359<h3 id="doctor-actions">

360 Действия Doctor

361</h3>

362 

363Действия, доступные в контексте `Doctor`:

364 

365| Действие | По умолчанию | Описание |

366| :----------- | :----------- | :------------------------------------------------------------------------------------------------------------ |

367| `doctor:fix` | F | Отправить отчёт диагностики Claude для исправления сообщённых проблем. Активно только при обнаружении проблем |

368 

369<h3 id="voice-actions">360<h3 id="voice-actions">

370 Действия голоса361 Действия голоса

371</h3>362</h3>


477}468}

478```469```

479 470 

480Это также работает для привязок аккордов. Отмена привязки каждого аккорда, который использует префикс, освобождает этот префикс для использования в качестве привязки с одной клавишей:471Это также работает для привязок аккордов. Отмена привязки каждого аккорда, который использует префикс, освобождает этот префикс для использования в качестве привязки с одной клавишей. Аккорд в любом активном контексте сохраняет свой префикс зарезервированным, поэтому вы должны отменить привязку каждого аккорда в контексте, который его определяет.

472 

473Семейство `Ctrl+X` по умолчанию охватывает два контекста: `ctrl+x ctrl+k` и `ctrl+x ctrl+e` в `Chat`, и `ctrl+x ctrl+b` в `Task`. Чтобы вернуть `ctrl+x` как привязку с одной клавишей, отмените привязку всех из них:

481 474 

482```json theme={null}475```json theme={null}

483{476{

484 "bindings": [477 "bindings": [

478 {

479 "context": "Task",

480 "bindings": {

481 "ctrl+x ctrl+b": null

482 }

483 },

485 {484 {

486 "context": "Chat",485 "context": "Chat",

487 "bindings": {486 "bindings": {


546* Конфликтов мультиплексоров терминала545* Конфликтов мультиплексоров терминала

547* Дублирующихся привязок в одном контексте546* Дублирующихся привязок в одном контексте

548 547 

549Запустите `/doctor` для просмотра любых предупреждений сочетаний клавиш.548Claude Code сообщает о предупреждениях при загрузке файла и записывает каждое в журнал отладки. Запустите Claude Code с [`--debug`](/ru/cli-reference#cli-flags) для просмотра деталей.

Details

209 Настольное приложение209 Настольное приложение

210</h3>210</h3>

211 211 

212Настольное приложение читает маршрутизацию шлюза из [конфигурации, распределяемой администратором](https://claude.com/docs/cowork/3p/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`. Если ваша организация распределила ее, настольное приложение маршрутизирует через шлюз без каких-либо действий с вашей стороны; если нет, используйте терминальный CLI или расширение VS Code для сеансов шлюза. Администраторы распределяют конфигурацию, как описано в [развертывании организации](/ru/llm-gateway-rollout#distribute-through-managed-settings).

213 213 

214Если настольное приложение показывает `Gateway was unreachable`, приложение не смогло достичь настроенный базовый URL при запуске; проверьте URL и сетевой путь с помощью [теста curl выше](#verify-the-connection).214Если настольное приложение показывает `Gateway was unreachable`, приложение не смогло достичь настроенный базовый URL при запуске; проверьте URL и сетевой путь с помощью [теста curl выше](#verify-the-connection).

215 215 


287 287 

288[Remote Control](/ru/remote-control) и [голосовая диктовка](/ru/voice-dictation) оба полагаются на идентичность claude.ai: Remote Control для связи живого сеанса с вашей учетной записью, и голосовая диктовка для достижения конечной точки транскрипции claude.ai. Они недоступны, пока активны `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, Remote Control также отключен, пока `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий Anthropic, поэтому входа с claude.ai недостаточно само по себе.288[Remote Control](/ru/remote-control) и [голосовая диктовка](/ru/voice-dictation) оба полагаются на идентичность claude.ai: Remote Control для связи живого сеанса с вашей учетной записью, и голосовая диктовка для достижения конечной точки транскрипции claude.ai. Они недоступны, пока активны `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, Remote Control также отключен, пока `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий Anthropic, поэтому входа с claude.ai недостаточно само по себе.

289 289 

290Чтобы восстановить любую из этих функций, войдите с claude.ai и отмените установку переменных шлюза, которые он проверяет. `/doctor` называет переменную учетных данных для отмены установки.290Чтобы восстановить любую из этих функций, войдите с claude.ai и отмените установку переменных шлюза, которые проверяет эта функция. Раздел Remote Control в `claude doctor` называет переменную учетных данных для отмены установки.

291 291 

292* Голосовая диктовка: отмените установку учетных данных шлюза292* Голосовая диктовка: отмените установку учетных данных шлюза

293* Remote Control: отмените установку учетных данных шлюза и `ANTHROPIC_BASE_URL`293* Remote Control: отмените установку учетных данных шлюза и `ANTHROPIC_BASE_URL`


393 Маршрутизация к облачному поставщику через шлюз393 Маршрутизация к облачному поставщику через шлюз

394</h3>394</h3>

395 395 

396Эти конфигурации направляют Claude Code на шлюз через переменную базового URL, специфичную для поставщика, вместо `ANTHROPIC_BASE_URL`. Шлюзы Bedrock и Agent Platform принимают собственные форматы запросов этих поставщиков; шлюзы Foundry и Claude Platform на AWS принимают формат Anthropic Messages и отличаются только тем, какая переменная базового URL их достигает.396Эти конфигурации направляют Claude Code на шлюз через переменную базового URL, специфичную для поставщика, вместо `ANTHROPIC_BASE_URL`. Шлюзы Amazon Bedrock и Google Cloud's Agent Platform принимают собственные форматы запросов этих поставщиков; шлюзы Microsoft Foundry и Claude Platform на AWS принимают формат Anthropic Messages и отличаются только тем, какая переменная базового URL их достигает.

397 397 

398Используйте один только если команда шлюза специально назвала Bedrock, Agent Platform, Foundry или Claude Platform на AWS. Если [запрос проверки](#verify-the-connection) выше вернул JSON, вы можете пропустить этот раздел.398Используйте один только если команда шлюза специально назвала Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS. Если [запрос проверки](#verify-the-connection) выше вернул JSON, вы можете пропустить этот раздел.

399 399 

400Установите блок для поставщика, которого назвала команда шлюза. Переменные skip-auth говорят Claude Code не подписывать запросы с учетными данными поставщика, так как шлюз их держит. Если шлюзу нужен свой собственный токен, добавьте `ANTHROPIC_AUTH_TOKEN` после блока, кроме Foundry, который использует `ANTHROPIC_FOUNDRY_API_KEY`, как показано.400Установите блок для поставщика, которого назвала команда шлюза. Переменные skip-auth говорят Claude Code не подписывать запросы с учетными данными поставщика, так как шлюз их держит. Если шлюзу нужен свой собственный токен, добавьте `ANTHROPIC_AUTH_TOKEN` после блока, кроме Microsoft Foundry, который использует `ANTHROPIC_FOUNDRY_API_KEY`, как показано. {/* min-version: 2.1.203 */}Шлюз Microsoft Foundry, который ожидает токен-носитель, может использовать [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/ru/env-vars) вместо этого; он имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY`, когда оба установлены. `ANTHROPIC_FOUNDRY_AUTH_TOKEN` требует Claude Code v2.1.203 или позже.

401 401 

402<h4 id="amazon-bedrock">402<h4 id="amazon-bedrock">

403 Amazon Bedrock403 Amazon Bedrock


451 Microsoft Foundry451 Microsoft Foundry

452</h4>452</h4>

453 453 

454Поместите учетные данные шлюза в `ANTHROPIC_FOUNDRY_API_KEY`; они отправляются на шлюз как заголовок `x-api-key`. `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` здесь не применяется: без ключа API клиент Foundry не проходит каждый запрос перед тем, как он покидает машину.454Поместите учетные данные шлюза в `ANTHROPIC_FOUNDRY_API_KEY`; они отправляются на шлюз как заголовок `x-api-key`. {/* min-version: 2.1.203 */}Шлюз, который ожидает токен-носитель, может принять [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/ru/env-vars) вместо этого. Claude Code отправляет это значение как заголовок `Authorization: Bearer`, и оно имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY`, когда оба установлены. Требует Claude Code v2.1.203 или позже.

455 

456Для шлюза, который внедряет свой собственный заголовок `Authorization`, установите `CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` и оставьте обе переменные учетных данных неустановленными. Claude Code затем отправляет запросы без учетных данных Azure и сохраняет заголовок `Authorization`, который вы предоставляете, например через `ANTHROPIC_CUSTOM_HEADERS`. {/* min-version: 2.1.203 */}До v2.1.203, `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` без ключа API оставлял клиент Microsoft Foundry неспособным отправлять запросы.

455 457 

456<Tabs>458<Tabs>

457 <Tab title="Bash или Zsh">459 <Tab title="Bash или Zsh">

Details

34 API форматы34 API форматы

35</h2>35</h2>

36 36 

37Gateway должен предоставить клиентам Claude Code по крайней мере один из следующих форматов API. Какой формат использует Claude Code, определяется конфигурацией клиента: переменная в столбце "Выбрано" таблицы ниже указывает Claude Code на ваш gateway в этом формате. Agent Platform — это конечная точка Claude компании Google Cloud, ранее известная как Vertex AI; названия её переменных сохраняют написание `VERTEX`.37Gateway должен предоставить клиентам Claude Code по крайней мере один из следующих форматов API. Какой формат использует Claude Code, определяется конфигурацией клиента: переменная в столбце "Выбрано" таблицы ниже указывает Claude Code на ваш gateway в этом формате. Google Cloud's Agent Platform — это конечная точка Claude компании Google Cloud, ранее известная как Vertex AI; названия её переменных сохраняют написание `VERTEX`.

38 38 

39| Формат | Выбрано | Конечные точки | Пересылать без изменений |39| Формат | Выбрано | Конечные точки | Пересылать без изменений |

40| :------------------------ | :--------------------------------------------------------- | :-------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ |40| :--------------------------------------- | :--------------------------------------------------------- | :-------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ |

41| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (опционально) | заголовки запроса `anthropic-beta` и `anthropic-version` |41| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`, `/v1/messages/count_tokens` (опционально) | заголовки запроса `anthropic-beta` и `anthropic-version` |

42| Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` с `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream` | поля тела запроса `anthropic_beta` и `anthropic_version` |42| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` с `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream` | поля тела запроса `anthropic_beta` и `anthropic_version` |

43| Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` с `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (опционально) | заголовки запроса `anthropic-beta` и `anthropic-version`, и поле тела запроса `anthropic_version` |43| Google Cloud's Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` с `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict` (опционально) | заголовки запроса `anthropic-beta` и `anthropic-version`, и поле тела запроса `anthropic_version` |

44 44 

45<h3 id="foundry-and-claude-platform-on-aws">45<h3 id="foundry-and-claude-platform-on-aws">

46 Foundry и Claude Platform on AWS46 Foundry и Claude Platform on AWS


52 Опциональные конечные точки и трафик при запуске52 Опциональные конечные точки и трафик при запуске

53</h3>53</h3>

54 54 

55Конечные точки подсчета токенов — единственные опциональные: когда их нет, Claude Code локально оценивает использование контекста. Запросы вывода отправляются на `/v1/messages?beta=true`, поэтому сопоставляйте по пути, а не по полному URL. Суффиксы метода Agent Platform присоединяются к пути модели издателя, как в `/projects/{project}/locations/{location}/publishers/anthropic/models/{model}:streamRawPredict`.55Конечные точки подсчета токенов — единственные опциональные: когда их нет, Claude Code локально оценивает использование контекста. Запросы вывода отправляются на `/v1/messages?beta=true`, поэтому сопоставляйте по пути, а не по полному URL. Суффиксы метода Google Cloud's Agent Platform присоединяются к пути модели издателя, как в `/projects/{project}/locations/{location}/publishers/anthropic/models/{model}:streamRawPredict`.

56 56 

57Gateway также видит трафик при запуске, который он может отклонить без нарушения чего-либо: зонд подключения `HEAD /` и на gateway-ах формата Bedrock запрос `GET /inference-profiles?type=SYSTEM_DEFINED`.57Gateway также видит трафик при запуске, который он может отклонить без нарушения чего-либо: зонд подключения `HEAD /` и на gateway-ах формата Amazon Bedrock запрос `GET /inference-profiles?type=SYSTEM_DEFINED`.

58 58 

59<h3 id="streaming">59<h3 id="streaming">

60 Потоковая передача60 Потоковая передача


68 68 

69Какой формат использует клиент, определяет, что получает ваш gateway. Распространенный режим отказа — несоответствие между форматом, который клиент отправляет вашему gateway, и форматом, который принимает поставщик upstream позади него.69Какой формат использует клиент, определяет, что получает ваш gateway. Распространенный режим отказа — несоответствие между форматом, который клиент отправляет вашему gateway, и форматом, который принимает поставщик upstream позади него.

70 70 

71* Когда клиент использует формат Bedrock или Agent Platform, Claude Code отправляет только подмножество своего полного набора возможностей, которое эти поставщики принимают71* Когда клиент использует формат Amazon Bedrock или Google Cloud's Agent Platform, Claude Code отправляет только подмножество своего полного набора возможностей, которое эти поставщики принимают

72* Когда клиент использует формат Anthropic Messages, Claude Code отправляет полный набор, даже если ваш gateway пересылает на upstream Bedrock или Agent Platform72* Когда клиент использует формат Anthropic Messages, Claude Code отправляет полный набор, даже если ваш gateway пересылает на upstream Amazon Bedrock или Google Cloud's Agent Platform

73 73 

74Преодоление этого различия — задача вашего gateway. [Сквозная передача функций](#feature-pass-through) описывает, что ломается, когда этого не происходит.74Преодоление этого различия — задача вашего gateway. [Сквозная передача функций](#feature-pass-through) описывает, что ломается, когда этого не происходит.

75 75 


82| Заголовок | Описание |82| Заголовок | Описание |

83| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |83| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

84| `Authorization`, `x-api-key` | Учетные данные gateway разработчика, в одном или обоих заголовках в зависимости от того, какую [переменную учетных данных](/ru/llm-gateway-connect#set-the-credential-variable) они установили |84| `Authorization`, `x-api-key` | Учетные данные gateway разработчика, в одном или обоих заголовках в зависимости от того, какую [переменную учетных данных](/ru/llm-gateway-connect#set-the-credential-variable) они установили |

85| `anthropic-version` | Версия API, в настоящее время `2023-06-01`. Запросы формата Bedrock и Agent Platform также содержат поле тела `anthropic_version`, значение которого — строка диалекта поставщика, а не значение этого заголовка |85| `anthropic-version` | Версия API, в настоящее время `2023-06-01`. Запросы формата Amazon Bedrock и Google Cloud's Agent Platform также содержат поле тела `anthropic_version`, значение которого — строка диалекта поставщика, а не значение этого заголовка |

86| `anthropic-beta` | Значения возможностей, разделенные запятыми, для запроса. Пересылайте заголовок дословно; не создавайте список разрешений отдельных значений, потому что набор изменяется с выпусками Claude Code. Когда разработчик аутентифицируется с помощью входа claude.ai, что возможно, когда `ANTHROPIC_BASE_URL` установлен без переменной учетных данных gateway, этот заголовок также содержит возможность OAuth, которую требует upstream, и удаление его приводит к отказу этих запросов с `401` |86| `anthropic-beta` | Значения возможностей, разделенные запятыми, для запроса. Пересылайте заголовок дословно; не создавайте список разрешений отдельных значений, потому что набор изменяется с выпусками Claude Code. Когда разработчик аутентифицируется с помощью входа claude.ai, что возможно, когда `ANTHROPIC_BASE_URL` установлен без переменной учетных данных gateway, этот заголовок также содержит возможность OAuth, которую требует upstream, и удаление его приводит к отказу этих запросов с `401` |

87| `x-claude-code-session-id` | Уникальный идентификатор текущего сеанса Claude Code. Используйте его для агрегирования всех запросов из одного сеанса без анализа тел запросов |87| `x-claude-code-session-id` | Уникальный идентификатор текущего сеанса Claude Code. Используйте его для агрегирования всех запросов из одного сеанса без анализа тел запросов |

88| `x-claude-code-agent-id` | Идентификатор [подагента](/ru/sub-agents), который выдал запрос, присутствует только в запросах от агента, порожденного Claude Code внутри сеанса. Используйте его с идентификатором сеанса для отнесения затрат к параллельным агентам |88| `x-claude-code-agent-id` | Идентификатор [подагента](/ru/sub-agents), который выдал запрос, присутствует только в запросах от агента, порожденного Claude Code внутри сеанса. Используйте его с идентификатором сеанса для отнесения затрат к параллельным агентам |


100 100 

101При пересылке на upstream формата Anthropic пропускайте заголовки запроса `anthropic-*` и поля тела запроса без изменений, а не создавайте список разрешений видимых вами сегодня. Gateway, привязанный к наблюдаемому списку, удаляет заголовок или поле следующей возможности и ломает его при выпуске, который его вводит.101При пересылке на upstream формата Anthropic пропускайте заголовки запроса `anthropic-*` и поля тела запроса без изменений, а не создавайте список разрешений видимых вами сегодня. Gateway, привязанный к наблюдаемому списку, удаляет заголовок или поле следующей возможности и ломает его при выпуске, который его вводит.

102 102 

103Исключением является upstream, не относящийся к Anthropic, такой как Bedrock или Agent Platform, где преодоление различия схемы — задача gateway; см. [сквозная передача функций](#feature-pass-through).103Исключением является upstream, не относящийся к Anthropic, такой как Amazon Bedrock или Google Cloud's Agent Platform, где преодоление различия схемы — задача gateway; см. [сквозная передача функций](#feature-pass-through).

104 104 

105<h2 id="system-prompt-attribution-block">105<h2 id="system-prompt-attribution-block">

106 Блок атрибуции системного приглашения106 Блок атрибуции системного приглашения


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, но пересылает их на 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#1m-token-context-window) и [чередующееся мышление](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-ах Bedrock и 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 возвращается к локальной оценке использования контекста | Предоставьте конечную точку, если вы хотите точные подсчеты |

139 139 

140Переменные `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` [объявляют](/ru/model-config) возможности модели только в конфигурациях поставщика: `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY` и [`CLAUDE_CODE_USE_MANTLE`](/ru/amazon-bedrock#use-the-mantle-endpoint). Они не имеют эффекта позади gateway `ANTHROPIC_BASE_URL`.140Переменные `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` [объявляют](/ru/model-config) возможности модели только в конфигурациях поставщика: `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY` и [`CLAUDE_CODE_USE_MANTLE`](/ru/amazon-bedrock#use-the-mantle-endpoint). Они не имеют эффекта позади gateway `ANTHROPIC_BASE_URL`.

Details

214 214 

215Некоторые окружения требуют отдельной доставки:215Некоторые окружения требуют отдельной доставки:

216 216 

217* Настольное приложение читает маршрутизацию шлюза только из своей конфигурации вывода третьей стороны, доставляемой MDM; разверните этот файл вместе с управляемыми параметрами, чтобы сеансы рабочего стола также маршрутизировались через шлюз. См. [документацию конфигурации рабочего стола](https://claude.com/docs/cowork/3p/configuration) и [документацию шлюза рабочего стола](https://claude.com/docs/cowork/3p/gateway)217* Настольное приложение читает маршрутизацию шлюза только из своей конфигурации вывода третьей стороны, доставляемой MDM; разверните этот файл вместе с управляемыми параметрами, чтобы сеансы рабочего стола также маршрутизировались через шлюз. См. [документацию конфигурации рабочего стола](https://claude.com/docs/third-party/claude-desktop/configuration) и [документацию шлюза рабочего стола](https://claude.com/docs/third-party/claude-desktop/gateway)

218* Бегуны CI нуждаются в `ANTHROPIC_BASE_URL` и учетных данных, установленных в [окружении бегуна](/ru/llm-gateway-connect#configure-each-surface)218* Бегуны CI нуждаются в `ANTHROPIC_BASE_URL` и учетных данных, установленных в [окружении бегуна](/ru/llm-gateway-connect#configure-each-surface)

219* WSL на управляемых машинах Windows читает управляемые параметры Windows только когда [`wslInheritsWindowsSettings`](/ru/settings#available-settings) имеет значение `true`219* WSL на управляемых машинах Windows читает управляемые параметры Windows только когда [`wslInheritsWindowsSettings`](/ru/settings#available-settings) имеет значение `true`

220 220 

mcp.md +31 −14

Details

85 85 

86При настройке MCP servers через JSON в `.mcp.json`, `~/.claude.json` или `claude mcp add-json`, поле `type` принимает `streamable-http` как псевдоним для `http`. Спецификация MCP использует имя `streamable-http` для этого транспорта, поэтому конфигурации, скопированные из документации server, работают без изменений.86При настройке MCP servers через JSON в `.mcp.json`, `~/.claude.json` или `claude mcp add-json`, поле `type` принимает `streamable-http` как псевдоним для `http`. Спецификация MCP использует имя `streamable-http` для этого транспорта, поэтому конфигурации, скопированные из документации server, работают без изменений.

87 87 

88Запись JSON, которая имеет `url`, но не имеет `type`, является ошибкой конфигурации, потому что Claude Code читает запись без `type` как stdio server. Claude Code пропускает этот server и сообщает `MCP server "<name>" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry`. До версии 2.1.202 Claude Code сообщал об этой неправильной конфигурации как `command: expected string, received undefined`.

89 

88<h3 id="option-2-add-a-remote-sse-server">90<h3 id="option-2-add-a-remote-sse-server">

89 Вариант 2: Добавьте удаленный SSE server91 Вариант 2: Добавьте удаленный SSE server

90</h3>92</h3>


113 115 

114Claude Code устанавливает `CLAUDE_PROJECT_DIR` в окружение порожденного server в корень проекта, поэтому ваш server может разрешать пути относительно проекта без зависимости от рабочей директории. Это та же директория, которую hooks получают в своей переменной `CLAUDE_PROJECT_DIR`. Прочитайте ее изнутри вашего процесса server, например `process.env.CLAUDE_PROJECT_DIR` в Node или `os.environ["CLAUDE_PROJECT_DIR"]` в Python.116Claude Code устанавливает `CLAUDE_PROJECT_DIR` в окружение порожденного server в корень проекта, поэтому ваш server может разрешать пути относительно проекта без зависимости от рабочей директории. Это та же директория, которую hooks получают в своей переменной `CLAUDE_PROJECT_DIR`. Прочитайте ее изнутри вашего процесса server, например `process.env.CLAUDE_PROJECT_DIR` в Node или `os.environ["CLAUDE_PROJECT_DIR"]` в Python.

115 117 

116Ваш server также может вызвать MCP запрос `roots/list`, который возвращает директорию, из которой был запущен Claude Code.118`CLAUDE_PROJECT_DIR` это стабильный корень проекта и не изменяется при добавлении или удалении рабочих директорий во время сеанса. Server, который ограничивает собственный доступ к файловой системе набором разрешенных директорий, должен вместо этого реализовать MCP запрос `roots/list`. Claude Code отвечает на `roots/list` с директорией запуска сеанса плюс каждая [дополнительная рабочая директория](/ru/permissions#working-directories), которую вы предоставили с помощью `--add-dir`, `/add-dir` или параметра `additionalDirectories`. Claude Code отправляет `notifications/roots/list_changed` при изменении этого набора. До версии 2.1.203 `roots/list` возвращал только директорию запуска и Claude Code не отправлял `notifications/roots/list_changed`.

117 119 

118Эта переменная устанавливается в окружение server, а не в собственное окружение Claude Code, поэтому ссылка на нее через расширение `${VAR}` в проекте или пользовательском `.mcp.json` `command` или `args` требует значения по умолчанию, такого как `${CLAUDE_PROJECT_DIR:-.}`. Конфигурации MCP, предоставляемые плагинами, подставляют `${CLAUDE_PROJECT_DIR}` напрямую и не требуют значения по умолчанию.120Эта переменная устанавливается в окружение server, а не в собственное окружение Claude Code, поэтому ссылка на нее через расширение `${VAR}` в проекте или пользовательском `.mcp.json` `command` или `args` требует значения по умолчанию, такого как `${CLAUDE_PROJECT_DIR:-.}`. Конфигурации MCP, предоставляемые плагинами, подставляют `${CLAUDE_PROJECT_DIR}` напрямую и не требуют значения по умолчанию.

119 121 


191 193 

192Панель `/mcp` показывает количество инструментов рядом с каждым подключенным server и отмечает servers, которые объявляют возможность tools, но не предоставляют никаких инструментов.194Панель `/mcp` показывает количество инструментов рядом с каждым подключенным server и отмечает servers, которые объявляют возможность tools, но не предоставляют никаких инструментов.

193 195 

194Если ваш запрос требует инструментов от server, который все еще подключается в фоновом режиме, Claude ждет подключения этого server перед продолжением. С включенным [поиском инструментов](#scale-with-mcp-tool-search), который используется по умолчанию, ожидание происходит внутри вызова `ToolSearch`. В конфигурациях без поиска инструментов, таких как Vertex AI, пользовательский `ANTHROPIC_BASE_URL` или `ENABLE_TOOL_SEARCH=false`, Claude использует инструмент `WaitForMcpServers` вместо этого.196Если ваш запрос требует инструментов от server, который все еще подключается в фоновом режиме, Claude ждет подключения этого server перед продолжением. С включенным [поиском инструментов](#scale-with-mcp-tool-search), который используется по умолчанию, ожидание происходит внутри вызова `ToolSearch`. В конфигурациях без поиска инструментов, таких как Google Cloud's Agent Platform, пользовательский `ANTHROPIC_BASE_URL` или `ENABLE_TOOL_SEARCH=false`, Claude использует инструмент `WaitForMcpServers` вместо этого.

197 

198Некоторые имена servers зарезервированы для встроенных servers Claude Code: `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` и `Claude Browser`. Если ваша конфигурация определяет server с зарезервированным именем, Claude Code пропускает его при загрузке и показывает предупреждение с просьбой переименовать его. `claude mcp add` отклоняет зарезервированное имя с ошибкой.

195 199 

196Имя server `workspace` зарезервировано для внутреннего использования. Если ваша конфигурация определяет server с этим именем, Claude Code пропускает его при загрузке и показывает предупреждение с просьбой переименовать его.200`Claude Preview` и `Claude Browser` оба называют встроенный server, который использует [панель предпросмотра приложения Claude Code desktop](/ru/desktop#preview-your-app). До версии 2.1.205 `Claude Browser` не был зарезервирован, поэтому пользовательский server мог зарегистрироваться под этим именем.

197 201 

198<h3 id="dynamic-tool-updates">202<h3 id="dynamic-tool-updates">

199 Динамические обновления инструментов203 Динамические обновления инструментов


209 213 

210Та же задержка применяется, когда HTTP или SSE server не может подключиться при запуске. Начиная с версии 2.1.121, Claude Code повторяет попытку начального подключения до трех раз при временных ошибках, таких как ответ 5xx, отказ в соединении или timeout, а затем помечает server как неудачный, если он все еще не может подключиться. Ошибки аутентификации и ошибки не найдено не повторяются, так как они требуют изменения конфигурации для разрешения.214Та же задержка применяется, когда HTTP или SSE server не может подключиться при запуске. Начиная с версии 2.1.121, Claude Code повторяет попытку начального подключения до трех раз при временных ошибках, таких как ответ 5xx, отказ в соединении или timeout, а затем помечает server как неудачный, если он все еще не может подключиться. Ошибки аутентификации и ошибки не найдено не повторяются, так как они требуют изменения конфигурации для разрешения.

211 215 

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 никогда не были настроены.

217 

212Начиная с версии 2.1.191, запросы обнаружения возможностей, которые выполняются после успешного подключения, такие как `tools/list`, `prompts/list` и `resources/list`, также повторяют временные сетевые и серверные ошибки до трех раз с короткой задержкой. Ошибки аутентификации, ответы 4xx и timeout запросов не повторяются.218Начиная с версии 2.1.191, запросы обнаружения возможностей, которые выполняются после успешного подключения, такие как `tools/list`, `prompts/list` и `resources/list`, также повторяют временные сетевые и серверные ошибки до трех раз с короткой задержкой. Ошибки аутентификации, ответы 4xx и timeout запросов не повторяются.

213 219 

214<h3 id="push-messages-with-channels">220<h3 id="push-messages-with-channels">


220<Tip>226<Tip>

221 Советы:227 Советы:

222 228 

223 * Используйте флаг `--scope` для указания места хранения конфигурации:229 * Используйте флаг `-s` или `--scope` для указания места хранения конфигурации:

224 * `local` (по умолчанию): доступно только вам в текущем проекте. В старых версиях эта область называлась `project`230 * `local` (по умолчанию): доступно только вам в текущем проекте. В старых версиях эта область называлась `project`

225 * `project`: общий доступ для всех в проекте через файл `.mcp.json`231 * `project`: общий доступ для всех в проекте через файл `.mcp.json`

226 * `user`: доступно вам во всех проектах. В старых версиях эта область называлась `global`232 * `user`: доступно вам во всех проектах. В старых версиях эта область называлась `global`

227 * Установите переменные окружения с флагами `--env` (например, `--env KEY=value`)233 * Установите переменные окружения с флагами `-e` или `--env` (например, `-e KEY=value`)

234 * Флаги `--transport` и `--header` также принимают короткие формы `-t` и `-H`

228 * Настройте timeout запуска MCP server, используя переменную окружения `MCP_TIMEOUT` (например, `MCP_TIMEOUT=10000 claude` устанавливает timeout в 10 секунд)235 * Настройте timeout запуска MCP server, используя переменную окружения `MCP_TIMEOUT` (например, `MCP_TIMEOUT=10000 claude` устанавливает timeout в 10 секунд)

229 * Установите timeout выполнения инструмента для каждого server, добавив поле `timeout` в миллисекундах в запись этого server в `.mcp.json`, например `"timeout": 600000` для десяти минут. Это переопределяет переменную окружения `MCP_TOOL_TIMEOUT` только для этого server236 * Установите timeout выполнения инструмента для каждого server, добавив поле `timeout` в миллисекундах в запись этого server в `.mcp.json`, например `"timeout": 600000` для десяти минут. Это переопределяет переменную окружения `MCP_TOOL_TIMEOUT` только для этого server

230 * Claude Code отобразит предупреждение, когда выход инструмента MCP превышает 10 000 токенов. Чтобы увеличить этот лимит, установите переменную окружения `MAX_MCP_OUTPUT_TOKENS` (например, `MAX_MCP_OUTPUT_TOKENS=50000`)237 * Claude Code отобразит предупреждение, когда выход инструмента MCP превышает 10 000 токенов. Чтобы увеличить этот лимит, установите переменную окружения `MAX_MCP_OUTPUT_TOKENS` (например, `MAX_MCP_OUTPUT_TOKENS=50000`)


233 240 

234Timeout для каждого server — это жесткий лимит реального времени для каждого вызова инструмента, и уведомления о прогрессе от server не продлевают его. Значения ниже 1000 игнорируются и переходят к `MCP_TOOL_TIMEOUT`, или к его значению по умолчанию примерно 28 часов, когда эта переменная не установлена. {/* min-version: 2.1.162 */}До версии 2.1.162 значения ниже 1000 округлялись до одной секунды вместо этого.241Timeout для каждого server — это жесткий лимит реального времени для каждого вызова инструмента, и уведомления о прогрессе от server не продлевают его. Значения ниже 1000 игнорируются и переходят к `MCP_TOOL_TIMEOUT`, или к его значению по умолчанию примерно 28 часов, когда эта переменная не установлена. {/* min-version: 2.1.162 */}До версии 2.1.162 значения ниже 1000 округлялись до одной секунды вместо этого.

235 242 

243Timeout для каждого server не менее 1000 также действует как нижний предел для timeout неактивности, описанного ниже: Claude Code никогда не прерывает вызовы инструментов этого server из-за неактивности раньше, чем timeout для каждого server. Требуется Claude Code версии 2.1.203 или позже.

244 

236Для HTTP и SSE servers бюджет первого байта для каждого запроса fetch имеет минимум 60 секунд.245Для HTTP и SSE servers бюджет первого байта для каждого запроса fetch имеет минимум 60 секунд.

237 246 

238Начиная с версии 2.1.187, вызов инструмента к удаленному HTTP, SSE, WebSocket или [claude.ai connector](#use-mcp-servers-from-claude-ai) server, который не отправляет ответ и не отправляет уведомление о прогрессе в течение 5 минут, прерывается с ошибкой вместо ожидания лимита реального времени. Установите переменную окружения [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/ru/env-vars) в миллисекундах, чтобы изменить окно неактивности, или установите ее на `0`, чтобы отключить проверку. Stdio servers это локальные процессы и не подлежат timeout неактивности.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 

249Установите переменную окружения [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/ru/env-vars) в миллисекундах, чтобы изменить окно неактивности, или установите ее на `0`, чтобы отключить проверку.

239 250 

240<h3 id="plugin-provided-mcp-servers">251<h3 id="plugin-provided-mcp-servers">

241 MCP servers, предоставляемые плагинами252 MCP servers, предоставляемые плагинами


306mcp__plugin_my-plugin_database-tools__query317mcp__plugin_my-plugin_database-tools__query

307```318```

308 319 

309Используйте это полное имя при ссылке на инструмент в [правилах разрешений](/ru/permissions), в списке `allowed-tools` skill или в [поле `tools` subagent](/ru/sub-agents#available-tools).320Используйте это полное имя при ссылке на инструмент в [правилах разрешений](/ru/permissions), в списке `allowed-tools` skill, в [поле `tools` subagent](/ru/sub-agents#available-tools) или в [matcher hook](/ru/hooks#match-mcp-tools). Matcher hook, написанный для простого ключа server, такой как `mcp__database-tools__.*`, никогда не срабатывает для plugin-bundled server.

321 

322Server сам регистрируется под scoped именем `plugin:<plugin-name>:<server-name>`, такой как `plugin:my-plugin:database-tools`. Используйте это имя там, где ожидается имя настроенного server, такой как [поле `server` hook `mcp_tool`](/ru/hooks#mcp-tool-hook-fields).

310 323 

311**Преимущества plugin MCP servers**:324**Преимущества plugin MCP servers**:

312 325 


860 </Step>873 </Step>

861</Steps>874</Steps>

862 875 

876Имена servers, добавленные через команды `claude mcp`, могут содержать только буквы, цифры, дефисы и подчеркивания. Claude Desktop не применяет это ограничение, поэтому server Claude Desktop, имя которого содержит любой другой символ, например пробел, не может быть импортирован. Импорт сообщает о каждом отклоненном имени и все еще импортирует другие выбранные вами servers. До версии 2.1.205 первое недопустимое имя останавливало импорт и ни один из выбранных servers не был добавлен.

877 

863<Tip>878<Tip>

864 Советы:879 Советы:

865 880 

866 * Эта функция работает только на macOS и Windows Subsystem for Linux (WSL)881 * Эта функция работает только на macOS и Windows Subsystem for Linux (WSL)

867 * Она читает файл конфигурации Claude Desktop из его стандартного расположения на этих платформах882 * Она читает файл конфигурации Claude Desktop из его стандартного расположения на этих платформах

868 * Используйте флаг `--scope user` для добавления servers в вашу конфигурацию пользователя883 * Используйте флаг `--scope user` для добавления servers в вашу конфигурацию пользователя

869 * Импортированные servers будут иметь те же имена, что и в Claude Desktop884 * Импортированные servers сохраняют те же имена, что и в Claude Desktop, когда имя содержит только буквы, цифры, дефисы и подчеркивания. Claude Code сообщает о server, имя которого содержит любой другой символ, и пропускает его

870 * Если servers с одинаковыми именами уже существуют, они получат числовой суффикс (например, `server_1`)885 * Если servers с одинаковыми именами уже существуют, они получат числовой суффикс (например, `server_1`)

871</Tip>886</Tip>

872 887 


898 913 

899Начиная с версии 2.1.161, коннекторы, в которые вы никогда не входили, свернуты за строкой `Show unused connectors` в конце раздела claude.ai, поэтому список, предоставленный организацией, не заполняет панель. Выберите строку, чтобы развернуть их. Коннектор, в который вы входили ранее, остается видимым даже если в настоящее время требуется повторная аутентификация.914Начиная с версии 2.1.161, коннекторы, в которые вы никогда не входили, свернуты за строкой `Show unused connectors` в конце раздела claude.ai, поэтому список, предоставленный организацией, не заполняет панель. Выберите строку, чтобы развернуть их. Коннектор, в который вы входили ранее, остается видимым даже если в настоящее время требуется повторная аутентификация.

900 915 

901Коннекторы из claude.ai загружаются только когда ваш активный [метод аутентификации](/ru/authentication#authentication-precedence) — это ваша подписка claude.ai. Они не загружаются, когда активны `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper` или сторонний поставщик, такой как Bedrock или Vertex, даже если вы ранее запустили `/login`. Если `/mcp` не отображает коннектор, который вы добавили, запустите `/status`, чтобы подтвердить, какой метод аутентификации активен, отмените установку этой переменной окружения или удалите параметр `apiKeyHelper`, затем запустите `/login`, чтобы выбрать вашу учетную запись claude.ai.916Коннекторы из claude.ai загружаются только когда ваш активный [метод аутентификации](/ru/authentication#authentication-precedence) — это ваша подписка claude.ai. Они не загружаются, когда активны `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper` или сторонний поставщик, такой как Amazon Bedrock или Google Cloud's Agent Platform, даже если вы ранее запустили `/login`.

917 

918Если `/mcp` не отображает коннектор, который вы добавили, запустите `/status`, чтобы подтвердить, какой метод аутентификации активен, отмените установку этой переменной окружения или удалите параметр `apiKeyHelper`, затем запустите `/login`, чтобы выбрать вашу учетную запись claude.ai.

902 919 

903Server, который вы добавили в Claude Code, имеет [приоритет](#scope-hierarchy-and-precedence) над коннектором claude.ai, который указывает на тот же URL. Когда это происходит, `/mcp` отображает коннектор как скрытый и показывает, как удалить дубликат, если вы предпочитаете использовать коннектор.920Server, который вы добавили в Claude Code, имеет [приоритет](#scope-hierarchy-and-precedence) над коннектором claude.ai, который указывает на тот же URL. Когда это происходит, `/mcp` отображает коннектор как скрытый и показывает, как удалить дубликат, если вы предпочитаете использовать коннектор.

904 921 


1174 Настройте tool search1191 Настройте tool search

1175</h3>1192</h3>

1176 1193 

1177Tool search включен по умолчанию: инструменты MCP откладываются и обнаруживаются по требованию. Claude Code отключает его по умолчанию на Vertex AI. Он также отключен, когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся первой стороной, так как большинство прокси не пересылают блоки `tool_reference`. Установите `ENABLE_TOOL_SEARCH` явно, чтобы переопределить любой резервный вариант.1194Tool search включен по умолчанию: инструменты MCP откладываются и обнаруживаются по требованию. Claude Code отключает его по умолчанию на Google Cloud's Agent Platform. Он также отключен, когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся первой стороной, так как большинство прокси не пересылают блоки `tool_reference`. Установите `ENABLE_TOOL_SEARCH` явно, чтобы переопределить любой резервный вариант.

1178 1195 

1179Tool search требует модель, которая поддерживает блоки `tool_reference`. Модели Haiku не поддерживают это. На Vertex AI tool search поддерживается для Claude Sonnet 4.5 и позже и Claude Opus 4.5 и позже.1196Tool search требует модель, которая поддерживает блоки `tool_reference`. Модели Haiku не поддерживают это. На Google Cloud's Agent Platform tool search поддерживается для Claude Sonnet 4.5 и позже и Claude Opus 4.5 и позже.

1180 1197 

1181Управляйте поведением tool search с помощью переменной окружения `ENABLE_TOOL_SEARCH`:1198Управляйте поведением tool search с помощью переменной окружения `ENABLE_TOOL_SEARCH`:

1182 1199 

1183| Значение | Поведение |1200| Значение | Поведение |

1184| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1201| :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1185| (не установлено) | Все инструменты MCP откладываются и загружаются по требованию. Возвращается к загрузке заранее на Vertex AI или когда `ANTHROPIC_BASE_URL` является хостом, не являющимся первой стороной |1202| (не установлено) | Все инструменты MCP откладываются и загружаются по требованию. Возвращается к загрузке заранее на Google Cloud's Agent Platform или когда `ANTHROPIC_BASE_URL` является хостом, не являющимся первой стороной |

1186| `true` | Все инструменты MCP откладываются. Claude Code отправляет заголовок бета-версии даже на Vertex AI и через прокси. Запросы завершаются ошибкой на моделях Vertex AI ранее, чем Sonnet 4.5 или Opus 4.5, или на прокси, которые не поддерживают блоки `tool_reference` |1203| `true` | Все инструменты MCP откладываются. Claude Code отправляет заголовок бета-версии даже на Google Cloud's Agent Platform и через прокси. Запросы завершаются ошибкой на моделях Google Cloud's Agent Platform ранее, чем Sonnet 4.5 или Opus 4.5, или на прокси, которые не поддерживают блоки `tool_reference` |

1187| `auto` | Режим порога: инструменты загружаются заранее, если они подходят в пределах 10% окна контекста, откладываются иначе |1204| `auto` | Режим порога: инструменты загружаются заранее, если они подходят в пределах 10% окна контекста, откладываются иначе |

1188| `auto:N` | Режим порога с пользовательским процентом, где `N` — это 0-100. Например, `auto:5` для 5% |1205| `auto:N` | Режим порога с пользовательским процентом, где `N` — это 0-100. Например, `auto:5` для 5% |

1189| `false` | Все инструменты MCP загружаются заранее, без откладывания |1206| `false` | Все инструменты MCP загружаются заранее, без откладывания |

Details

315 Claude Code не нашёл никаких серверов для текущего каталога. Наиболее распространённые причины:315 Claude Code не нашёл никаких серверов для текущего каталога. Наиболее распространённые причины:

316 316 

317 * Вы запустили `claude mcp add` из другого проекта. Серверы в области local привязаны к проекту, где вы их добавили: корень репозитория или точный каталог, если вы не были в репозитории git. Повторно добавьте сервер из проекта, в котором вы находитесь сейчас, или добавьте его с `--scope user`, чтобы он не был привязан к проекту.317 * Вы запустили `claude mcp add` из другого проекта. Серверы в области local привязаны к проекту, где вы их добавили: корень репозитория или точный каталог, если вы не были в репозитории git. Повторно добавьте сервер из проекта, в котором вы находитесь сейчас, или добавьте его с `--scope user`, чтобы он не был привязан к проекту.

318 * Вы отредактировали файл конфигурации по неправильному пути. Правильные файлы — это `~/.claude.json` и `<project>/.mcp.json`. Claude Code не читает пути, такие как `~/.claude/config/mcp.json`, `~/.claude/mcp.json` или `%APPDATA%\Claude\mcp.json`.318 * Вы отредактировали файл конфигурации по неправильному пути. Правильные файлы — это `~/.claude.json` и `<project>/.mcp.json`. Claude Code не читает пути, такие как `~/.claude/.mcp.json`, `~/.claude/config/mcp.json`, `~/.claude/mcp.json` или `%APPDATA%\Claude\mcp.json`. Для серверов в области user запустите `claude mcp add --scope user`, который записывает в ключ `mcpServers` в `~/.claude.json`; для серверов в области project отредактируйте `.mcp.json` в корне проекта.

319 </Accordion>319 </Accordion>

320 320 

321 <Accordion title="Status shows Failed to connect or Connection error">321 <Accordion title="Status shows Failed to connect or Connection error">

Details

113 2) Настройка учетных данных Azure113 2) Настройка учетных данных Azure

114</h3>114</h3>

115 115 

116Claude Code поддерживает два метода аутентификации для Microsoft Foundry. Выберите метод, который лучше всего соответствует вашим требованиям безопасности.116Claude Code поддерживает три метода аутентификации для Microsoft Foundry. Выберите метод, который лучше всего соответствует вашим требованиям безопасности.

117 117 

118**Вариант A: Аутентификация по ключу API**118**Вариант A: Аутентификация по ключу API**

119 119 


128 128 

129**Вариант B: Аутентификация Microsoft Entra ID**129**Вариант B: Аутентификация Microsoft Entra ID**

130 130 

131Когда `ANTHROPIC_FOUNDRY_API_KEY` не установлен, Claude Code автоматически использует Azure SDK [цепочку учетных данных по умолчанию](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview).131Когда ни `ANTHROPIC_FOUNDRY_API_KEY`, ни `ANTHROPIC_FOUNDRY_AUTH_TOKEN` не установлены, Claude Code автоматически использует Azure SDK [цепочку учетных данных по умолчанию](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview).

132Это поддерживает различные методы аутентификации локальных и удаленных рабочих нагрузок.132Это поддерживает различные методы аутентификации локальных и удаленных рабочих нагрузок.

133 133 

134В локальных средах вы обычно можете использовать Azure CLI:134В локальных средах вы обычно можете использовать Azure CLI:


137az login137az login

138```138```

139 139 

140**Вариант C: Аутентификация с использованием токена Bearer**

141 

142{/* min-version: 2.1.203 */}Claude Code отправляет значение `ANTHROPIC_FOUNDRY_AUTH_TOKEN` в каждом запросе в качестве заголовка `Authorization: Bearer`. Используйте этот вариант, когда другой процесс, такой как хост-приложение или скрипт входа, уже получил для вас токен доступа. Требуется Claude Code версии 2.1.203 или позже.

143 

144Установите переменную на токен Bearer, выданный Microsoft Entra ID для вашего ресурса:

145 

146```bash theme={null}

147export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

148```

149 

150`ANTHROPIC_FOUNDRY_AUTH_TOKEN` имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY` и над цепочкой учетных данных по умолчанию.

151 

140<Note>152<Note>

141 При использовании Microsoft Foundry команда `/logout` недоступна, так как аутентификация обрабатывается через учетные данные Azure.153 При использовании Microsoft Foundry команда `/logout` недоступна, так как аутентификация обрабатывается через учетные данные Azure.

142</Note>154</Note>


162</h3>174</h3>

163 175 

164<Warning>176<Warning>

165 Закрепите конкретные версии моделей для каждого развертывания. Без закрепления псевдонимы моделей, такие как `sonnet` и `opus`, разрешаются в встроенное значение Claude Code по умолчанию для Foundry, которое может отставать от последнего выпуска и может быть недоступно в вашей учетной записи. Foundry не имеет проверки модели при запуске, поэтому запросы завершаются ошибкой, когда значение по умолчанию недоступно. При создании развертываний Azure выберите конкретную версию модели вместо "автоматического обновления до последней версии".177 Закрепите конкретные версии моделей для каждого развертывания. Без закрепления псевдонимы моделей, такие как `sonnet` и `opus`, разрешаются в встроенное значение Claude Code по умолчанию для Microsoft Foundry, которое может отставать от последнего выпуска и может быть недоступно в вашей учетной записи. Microsoft Foundry не имеет проверки модели при запуске, поэтому запросы завершаются ошибкой, когда значение по умолчанию недоступно. При создании развертываний Azure выберите конкретную версию модели вместо "автоматического обновления до последней версии".

166</Warning>178</Warning>

167 179 

168Установите переменные модели в соответствии с именами развертываний, которые вы создали на шаге 1.180Установите переменные модели в соответствии с именами развертываний, которые вы создали на шаге 1.

169 181 

170Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Foundry разрешается в Opus 4.6. Установите его на идентификатор Opus 4.8, чтобы использовать последнюю модель:182Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Microsoft Foundry разрешается в Opus 4.6. Установите его на идентификатор Opus 4.8, чтобы использовать последнюю модель:

171 183 

172```bash theme={null}184```bash theme={null}

173export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'185export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'


175export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'187export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'

176```188```

177 189 

178Фоновые задачи, такие как генерация заголовков сеансов, используют небольшую/быструю модель, обычно модель класса Haiku. На Foundry Claude Code по умолчанию использует основную модель, потому что не каждая учетная запись имеет развертывание Haiku. Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на развертывание Haiku, доступное в вашей учетной записи, как показано выше.190Фоновые задачи, такие как генерация заголовков сеансов, используют небольшую/быструю модель, обычно модель класса Haiku. На Microsoft Foundry Claude Code по умолчанию использует основную модель, потому что не каждая учетная запись имеет развертывание Haiku. Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на развертывание Haiku, доступное в вашей учетной записи, как показано выше.

179 191 

180Для получения текущих и устаревших идентификаторов моделей см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Полный список переменных окружения см. в разделе [Конфигурация модели](/ru/model-config#pin-models-for-third-party-deployments).192Для получения текущих и устаревших идентификаторов моделей см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Полный список переменных окружения см. в разделе [Конфигурация модели](/ru/model-config#pin-models-for-third-party-deployments).

181 193 


195claude207claude

196```208```

197 209 

198Claude Code читает `CLAUDE_CODE_USE_FOUNDRY` и другие переменные Foundry из окружения и подключается к вашему ресурсу Azure при первом запросе. В отличие от Bedrock и Vertex AI, Foundry не имеет интерактивного мастера установки, поэтому переменные окружения на шагах 3 и 4 являются единственным путем конфигурации.210Claude Code читает `CLAUDE_CODE_USE_FOUNDRY` и другие переменные Microsoft Foundry из окружения и подключается к вашему ресурсу Azure при первом запросе. В отличие от Amazon Bedrock и Google Cloud's Agent Platform, Microsoft Foundry не имеет интерактивного мастера установки, поэтому переменные окружения на шагах 3 и 4 являются единственным путем конфигурации.

199 211 

200<h2 id="azure-rbac-configuration">212<h2 id="azure-rbac-configuration">

201 Конфигурация Azure RBAC213 Конфигурация Azure RBAC

model-config.md +87 −32

Details

15* **Псевдоним модели**15* **Псевдоним модели**

16* **Имя модели**16* **Имя модели**

17 * Anthropic API: полное **[имя модели](https://platform.claude.com/docs/ru/about-claude/models/overview)**17 * Anthropic API: полное **[имя модели](https://platform.claude.com/docs/ru/about-claude/models/overview)**

18 * Bedrock: ARN профиля вывода18 * Amazon Bedrock: ARN профиля вывода

19 * Foundry: имя развертывания19 * Microsoft Foundry: имя развертывания

20 * Vertex: имя версии20 * Google Cloud's Agent Platform: имя версии

21 21 

22<Note>22<Note>

23 `ANTHROPIC_BASE_URL` изменяет, куда отправляются запросы, а не какая модель на них отвечает. Чтобы маршрутизировать Claude через шлюз LLM, см. [шлюзы LLM](/ru/llm-gateway).23 `ANTHROPIC_BASE_URL` изменяет, куда отправляются запросы, а не какая модель на них отвечает. Чтобы маршрутизировать Claude через шлюз LLM, см. [шлюзы LLM](/ru/llm-gateway).


41| **`opus[1m]`** | Использует Opus с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/ru/build-with-claude/context-windows#1m-token-context-window) для длительных сеансов |41| **`opus[1m]`** | Использует Opus с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/ru/build-with-claude/context-windows#1m-token-context-window) для длительных сеансов |

42| **`opusplan`** | Специальный режим, который использует `opus` во время режима плана, а затем переключается на `sonnet` для выполнения |42| **`opusplan`** | Специальный режим, который использует `opus` во время режима плана, а затем переключается на `sonnet` для выполнения |

43 43 

44На Anthropic API `opus` разрешается в Opus 4.8, а `sonnet` разрешается в Sonnet 5. На [Claude Platform on AWS](/ru/claude-platform-on-aws) `opus` разрешается в Opus 4.7, а `sonnet` разрешается в Sonnet 4.6. На Bedrock, Vertex и Foundry `opus` разрешается в Opus 4.6, а `sonnet` разрешается в Sonnet 4.5; более новые модели доступны на этих поставщиках путем явного выбора полного имени модели или установки `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`.44На Anthropic API `opus` разрешается в Opus 4.8, а `sonnet` разрешается в Sonnet 5. На [Claude Platform on AWS](/ru/claude-platform-on-aws) `opus` разрешается в Opus 4.7, а `sonnet` разрешается в Sonnet 4.6. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry `opus` разрешается в Opus 4.6, а `sonnet` разрешается в Sonnet 4.5; более новые модели доступны на этих поставщиках путем явного выбора полного имени модели или установки `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`.

45 45 

46Псевдонимы указывают на рекомендуемую версию для вашего поставщика и обновляются со временем. Чтобы закрепить определенную версию, используйте полное имя модели, например `claude-opus-4-8`, или установите соответствующую переменную окружения, такую как `ANTHROPIC_DEFAULT_OPUS_MODEL`.46Псевдонимы указывают на рекомендуемую версию для вашего поставщика и обновляются со временем. Чтобы закрепить определенную версию, используйте полное имя модели, например `claude-opus-4-8`, или установите соответствующую переменную окружения, такую как `ANTHROPIC_DEFAULT_OPUS_MODEL`.

47 47 


84* `Enter`: переключить модель и сохранить в качестве значения по умолчанию84* `Enter`: переключить модель и сохранить в качестве значения по умолчанию

85* `s`: переключить модель только для этого сеанса85* `s`: переключить модель только для этого сеанса

86 86 

87Ввод `/model <name>` напрямую ведет себя как `Enter`. Параметры проекта и управляемые параметры по-прежнему имеют приоритет и переприменяются при следующем запуске. {/* min-version: 2.1.196 */}[Модель по умолчанию организации](#organization-default-model), которую администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.87Ввод `/model <name>` напрямую ведет себя как `Enter`. {/* min-version: 2.1.205 */}Модель, установленная с помощью `/model` в [неинтерактивном режиме](/ru/headless), с флагом `-p`, применяется только к текущему сеансу и не сохраняется в качестве значения по умолчанию. Параметры проекта и управляемые параметры по-прежнему имеют приоритет и переприменяются при следующем запуске. {/* min-version: 2.1.196 */}[Модель по умолчанию организации](#organization-default-model), которую администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.

88 88 

89В версиях v2.1.144 по v2.1.152 `/model` применялся только к текущему сеансу, а `d` в средстве выбора сохранял значение по умолчанию.89В версиях v2.1.144 по v2.1.152 `/model` применялся только к текущему сеансу, а `d` в средстве выбора сохранял значение по умолчанию.

90 90 


96 96 

97Когда активная модель при запуске поступает из параметров проекта или управляемых параметров, а не из вашего собственного выбора, заголовок при запуске показывает, какой файл параметров установил его. Запустите `/model` для переопределения; параметр проекта или управляемый параметр переприменяется при следующем запуске.97Когда активная модель при запуске поступает из параметров проекта или управляемых параметров, а не из вашего собственного выбора, заголовок при запуске показывает, какой файл параметров установил его. Запустите `/model` для переопределения; параметр проекта или управляемый параметр переприменяется при следующем запуске.

98 98 

99Когда переключение модели запрашивается через метод [Agent SDK](/ru/agent-sdk/overview) `setModel()` или приложением, таким как [Desktop app](/ru/desktop), которое запускает Claude Code CLI для вас, Claude Code проверяет, что строка является той, которую он распознает, перед её сохранением. Эта проверка требует Claude Code v2.1.200 или более поздней версии. На Anthropic API Claude Code распознает:

100 

101* псевдоним модели

102* запись из средства выбора `/model`

103* любое имя, которое начинается с `claude-`

104* значение, которое вы сами настроили как [пользовательский вариант модели](#add-a-custom-model-option) или в [`modelOverrides`](#override-model-ids-per-version)

105 

106Claude Code отклоняет неузнанную строку с `Model "<name>" is not a recognized model id.` и сеанс сохраняет свою текущую модель, вместо того чтобы сохранить строку и потерпеть неудачу при следующем запросе. См. [справочник ошибок](/ru/errors#model-is-not-a-recognized-model-id) для шагов восстановления.

107 

108Проверка выполняется только на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/ru/claude-platform-on-aws) и за [LLM gateway](/ru/llm-gateway) или пользовательским `ANTHROPIC_BASE_URL`, ваш поставщик или шлюз определяет имена моделей, поэтому Claude Code передает любую строку без проверки. Проверка также не охватывает флаг `--model`, переменную окружения `ANTHROPIC_MODEL` или параметр `model`; неправильно введенное значение там производит [There's an issue with the selected model](/ru/errors#there%E2%80%99s-an-issue-with-the-selected-model) при первом запросе вместо этого.

109 

99Когда запрашиваемая модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, Claude Code показывает предупреждение, которое называет запрашиваемую модель. Интерактивные сеансы показывают его как уведомление при запуске. Начиная с версии v2.1.182, то же предупреждение записывается в stderr в [неинтерактивном режиме](/ru/headless) при использовании формата вывода текста по умолчанию. Проверка также охватывает `model`, установленный в [frontmatter подагента](/ru/sub-agents). Предупреждение stderr подавляется для `--output-format json` и `stream-json`; прочитайте фактическую модель из поля `modelUsage` [результирующего сообщения](/ru/headless#get-structured-output) вместо этого.110Когда запрашиваемая модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, Claude Code показывает предупреждение, которое называет запрашиваемую модель. Интерактивные сеансы показывают его как уведомление при запуске. Начиная с версии v2.1.182, то же предупреждение записывается в stderr в [неинтерактивном режиме](/ru/headless) при использовании формата вывода текста по умолчанию. Проверка также охватывает `model`, установленный в [frontmatter подагента](/ru/sub-agents). Предупреждение stderr подавляется для `--output-format json` и `stream-json`; прочитайте фактическую модель из поля `modelUsage` [результирующего сообщения](/ru/headless#get-structured-output) вместо этого.

100 111 

101Пример использования:112Пример использования:


135* **Модель советника**: настроенный параметр [`advisorModel`](/ru/advisor) и флаг `--advisor`146* **Модель советника**: настроенный параметр [`advisorModel`](/ru/advisor) и флаг `--advisor`

136* **Модель фонового агента**: модель, выбранная в [средстве выбора диспетчера](/ru/agent-view)147* **Модель фонового агента**: модель, выбранная в [средстве выбора диспетчера](/ru/agent-view)

137 148 

138Переключение на заблокированную модель с помощью `/model` отклоняется с ошибкой, в то время как заблокированный флаг `--model`, `ANTHROPIC_MODEL` или значение параметра `model` заменяются при запуске с предупреждением, в котором указаны как запрошенная, так и подставленная модели, и сеанс начинается с моделью по умолчанию. Заблокированное переопределение подагента, навыка или команды возвращается к унаследованной или модели по умолчанию, а не к отказу в запросе; заблокированный параметр `advisorModel` отключает советника на время сеанса, в то время как заблокированное значение флага `--advisor` завершает работу с ошибкой при запуске. Исключённые модели скрыты из средства выбора `/model`. {/* min-version: 2.1.199 */}Начиная с версии v2.1.199, полный идентификатор модели в списке, который не имеет встроенной строки средства выбора, такой как более старая версия, которую список закрепляет, появляется в средстве выбора `/model` как собственная помеченная строка. На более ранних версиях такой идентификатор доступен для выбора только путем ввода `/model <id>`.149На API Anthropic и [Claude Platform на AWS](/ru/claude-platform-on-aws) псевдоним семейства моделей, `opus`, `sonnet`, `haiku` или `fable`, разрешается на самую новую версию своего семейства, которую разрешает список разрешений. Когда список разрешений закрепляет конкретные версии, например `["sonnet", "claude-opus-4-6"]`, оба `/model opus` и `--model opus` выбирают Claude Opus 4.6, самый новый разрешённый Opus, и показывают уведомление, называющее как запрошенную, так и подставленную модели. До v2.1.205 псевдоним, самая новая выпущенная версия которого была вне списка, отклонялась или заменялась как любой другой заблокированный выбор, даже когда список разрешал более старую версию.

150 

151Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и [Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) используют идентификаторы развёртывания, специфичные для поставщика, а не идентификаторы моделей Anthropic, поэтому заблокированный псевдоним там следует поведению отклонения и замены ниже.

139 152 

140Автоматические изменения модели проверяются таким же образом: элементы [цепочки резервной модели](#fallback-model-chains) вне списка разрешений удаляются, обновление режима планирования, такое как [`opusplan`](#opusplan-model-setting) на исключённую модель, пропускается, чтобы планирование продолжалось на модели сеанса, и [автоматический резервный вариант модели](#automatic-model-fallback), целевая модель которого исключена, не выполняется, поэтому помеченный запрос заканчивается отказом. Включение [быстрого режима](/ru/fast-mode) отклоняется, когда модель, на которой сеанс будет работать впоследствии, находится вне списка разрешений.153Claude Code обрабатывает любой другой заблокированный выбор в соответствии с тем, где была установлена модель:

154 

155* **`/model`**: переключение отклоняется с ошибкой

156* **флаг `--model`, `ANTHROPIC_MODEL` или параметр `model`**: значение заменяется при запуске с предупреждением, называющим как запрошенную, так и подставленную модели, и сеанс начинается на модели по умолчанию

157* **Переопределение подагента, навыка или команды**: переопределение возвращается к унаследованной или модели по умолчанию, а не к отказу в запросе

158* **параметр `advisorModel`**: советник отключается на время сеанса

159* **флаг `--advisor`**: Claude Code завершает работу с ошибкой при запуске

160 

161Исключённые модели скрыты из средства выбора `/model`. {/* min-version: 2.1.199 */}Полный идентификатор модели в списке, который не имеет встроенной строки средства выбора, такой как более старая версия, которую список закрепляет, появляется в средстве выбора `/model` как собственная помеченная строка. До v2.1.199 такой идентификатор доступен для выбора только путём ввода `/model <id>`.

162 

163Изменения модели, которые Claude Code делает от вашего имени, проверяются таким же образом:

164 

165* **[Цепочки резервной модели](#fallback-model-chains)**: элементы вне списка разрешений удаляются

166* **Обновления режима планирования**: на API Anthropic и Claude Platform на AWS обновление, такое как [`opusplan`](#opusplan-model-setting) на исключённую модель, использует самую новую разрешённую версию семейства обновления. На поставщиках с идентификаторами моделей, специфичными для поставщика, и когда версия не разрешена, обновление пропускается и планирование продолжается на модели сеанса

167* **[Автоматический резервный вариант модели](#automatic-model-fallback)**: резервный вариант, целевая модель которого исключена, не выполняется, поэтому помеченный запрос заканчивается отказом

168* **[Быстрый режим](/ru/fast-mode)**: включение быстрого режима отклоняется, когда модель, на которой сеанс будет работать впоследствии, находится вне списка разрешений

141 169 

142```json theme={null}170```json theme={null}

143{171{


158 186 

159* Облачные сеансы на [Claude Code в веб-версии](/ru/claude-code-on-the-web) или в приложении Desktop работают на управляемых Anthropic виртуальных машинах: параметры, развёрнутые на вашем устройстве, не достигают их, поэтому доставляйте список разрешений через управляемые параметры сервера. Переключение модели в середине сеанса в облачном сеансе отклоняется, когда запрошенная модель исключена списком разрешений. Отклонение на стороне сервера при создании сеанса применяется к [ограничениям модели организации](#organization-model-restrictions), а не к ключу параметров `availableModels`.187* Облачные сеансы на [Claude Code в веб-версии](/ru/claude-code-on-the-web) или в приложении Desktop работают на управляемых Anthropic виртуальных машинах: параметры, развёрнутые на вашем устройстве, не достигают их, поэтому доставляйте список разрешений через управляемые параметры сервера. Переключение модели в середине сеанса в облачном сеансе отклоняется, когда запрошенная модель исключена списком разрешений. Отклонение на стороне сервера при создании сеанса применяется к [ограничениям модели организации](#organization-model-restrictions), а не к ключу параметров `availableModels`.

160* Cowork, вкладка агентской работы в приложении Claude Desktop, не является поверхностью Claude Code и по замыслу не получает управляемые параметры сервера. Управляемый файл параметров применяется к сеансам Cowork, когда он присутствует там, где работает сеанс; удалённые сеансы Cowork работают на управляемых Anthropic виртуальных машинах, где развёрнутый на устройстве файл отсутствует.188* Cowork, вкладка агентской работы в приложении Claude Desktop, не является поверхностью Claude Code и по замыслу не получает управляемые параметры сервера. Управляемый файл параметров применяется к сеансам Cowork, когда он присутствует там, где работает сеанс; удалённые сеансы Cowork работают на управляемых Anthropic виртуальных машинах, где развёрнутый на устройстве файл отсутствует.

161* Сеансы на [сторонних поставщиках](/ru/server-managed-settings#platform-availability), таких как Bedrock, Vertex AI, Foundry и [Claude Platform на AWS](/ru/claude-platform-on-aws), не получают управляемые параметры сервера, поэтому доставляйте список разрешений через MDM или управляемые файлы параметров там.189* Сеансы на [сторонних поставщиках](/ru/server-managed-settings#platform-availability), таких как Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и [Claude Platform на AWS](/ru/claude-platform-on-aws), не получают управляемые параметры сервера, поэтому доставляйте список разрешений через MDM или управляемые файлы параметров там.

162* Доставка, управляемая сервером, также требует, чтобы сеанс аутентифицировался с помощью входа в организацию или напрямую настроенного ключа API. Флоты, которые генерируют ключи только через скрипт [`apiKeyHelper`](/ru/settings#available-settings), должны доставлять список разрешений через MDM или управляемые файлы параметров.190* Доставка, управляемая сервером, также требует, чтобы сеанс аутентифицировался с помощью входа в организацию или напрямую настроенного ключа API. Флоты, которые генерируют ключи только через скрипт [`apiKeyHelper`](/ru/settings#available-settings), должны доставлять список разрешений через MDM или управляемые файлы параметров.

163* Вкладка Desktop Code также размещает [SSH-сеансы](/ru/desktop#ssh-sessions), которые читают управляемый файл параметров с удалённого хоста, на котором они работают. См. [Управляемые параметры Desktop](/ru/desktop#managed-settings).191* Вкладка Desktop Code также размещает [SSH-сеансы](/ru/desktop#ssh-sessions), которые читают управляемый файл параметров с удалённого хоста, на котором они работают. См. [Управляемые параметры Desktop](/ru/desktop#managed-settings).

164* Средства выбора модели на claude.ai и в приложении Desktop скрывают или затемняют модели, исключённые списком разрешений вашей организации. Состояние средства выбора — это удобство для пользователей; применение происходит в сеансе.192* Средства выбора модели на claude.ai и в приложении Desktop скрывают или затемняют модели, исключённые списком разрешений вашей организации. Состояние средства выбора — это удобство для пользователей; применение происходит в сеансе.


167 Поведение модели по умолчанию195 Поведение модели по умолчанию

168</h3>196</h3>

169 197 

170Опция Default в средстве выбора модели не затрагивается `availableModels`, если также не установлен [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Сам по себе `availableModels` оставляет Default доступным, разрешаясь в системное значение по умолчанию во время выполнения [на основе уровня подписки пользователя](#default-model-setting). Если значение по умолчанию для уровня — это модель, которую вы намереваетесь ограничить, установите также `enforceAvailableModels`.198Опция Default в средстве выбора модели не затрагивается `availableModels`, если также не установлен [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Сам по себе `availableModels` оставляет Default доступным, разрешаясь в системное значение по умолчанию во время выполнения [для учётной записи](#default-model-setting). Если это значение по умолчанию — это модель, которую вы намереваетесь ограничить, установите также `enforceAvailableModels`.

171 199 

172Пустой массив `availableModels` никогда не включает применение Default-модели: с `availableModels: []` именованные выборы модели блокируются, но модель Default для типа учётной записи остаётся пригодной для использования независимо от `enforceAvailableModels`.200Пустой массив `availableModels` никогда не включает применение Default-модели: с `availableModels: []` именованные выборы модели блокируются, но модель Default для типа учётной записи остаётся пригодной для использования независимо от `enforceAvailableModels`.

173 201 


184}212}

185```213```

186 214 

187Опция Default разрешается к модели по умолчанию для типа учётной записи пользователя, или к [модели по умолчанию организации](#organization-default-model), когда администратор установил её. Когда эта модель не находится в списке разрешений, опция Default вместо этого разрешается на первую запись `availableModels`, которая называет разрешённую, доступную модель, и строка Default в средстве выбора `/model` показывает эту модель. Это применяется везде, где достигается значение по умолчанию: запуск сеанса, выбор Default в `/model`, ключевое слово `"default"` в [цепочках резервной модели](#fallback-model-chains) и резервный вариант, используемый при удалении исключённого выбора.215Опция Default разрешается к модели по умолчанию для типа учётной записи, или к [модели по умолчанию организации](#organization-default-model), когда администратор установил её. Когда эта модель не находится в списке разрешений, опция Default вместо этого разрешается на первую запись `availableModels`, которая называет разрешённую, доступную модель, и строка Default в средстве выбора `/model` показывает эту модель. Это применяется везде, где достигается значение по умолчанию: запуск сеанса, выбор Default в `/model`, ключевое слово `"default"` в [цепочках резервной модели](#fallback-model-chains) и резервный вариант, используемый при удалении исключённого выбора.

188 216 

189`enforceAvailableModels` не имеет эффекта, когда `availableModels` не установлен или пуст: с `availableModels: []` модель Default для типа учётной записи остаётся пригодной для использования, поэтому параметр не может заблокировать пользователей от каждой модели. Когда `availableModels` непуст, но ни одна запись не разрешается на разрешённую и доступную модель, применение деградирует и Default переходит к значению по умолчанию для типа учётной записи с предупреждением, видимым только под `--debug`. Сохраняйте по крайней мере одну гарантированно доступную запись в списке, чтобы избежать этого.217`enforceAvailableModels` не имеет эффекта, когда `availableModels` не установлен или пуст: с `availableModels: []` модель Default для типа учётной записи остаётся пригодной для использования, поэтому параметр не может заблокировать пользователей от каждой модели. Когда `availableModels` непуст, но ни одна запись не разрешается на разрешённую и доступную модель, применение деградирует и Default переходит к значению по умолчанию для типа учётной записи с предупреждением, видимым только под `--debug`. Сохраняйте по крайней мере одну гарантированно доступную запись в списке, чтобы избежать этого.

190 218 


194 Управление моделью, на которой работают пользователи222 Управление моделью, на которой работают пользователи

195</h3>223</h3>

196 224 

197Параметр `model` является начальным выбором, а не применением. Он устанавливает, какая модель активна при запуске сеанса, но пользователи всё ещё могут открыть `/model` и выбрать Default, который разрешается в системное значение по умолчанию для их уровня независимо от того, что установлено в `model`, если только [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) не перенаправит его.225Параметр `model` является начальным выбором, а не применением. Он устанавливает, какая модель активна при запуске сеанса, но пользователи всё ещё могут открыть `/model` и выбрать Default, который разрешается в системное значение по умолчанию [для учётной записи](#default-model-setting) независимо от того, что установлено в `model`, если только [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) не перенаправит его.

198 226 

199Для полного управления опытом работы с моделью объедините эти параметры:227Для полного управления опытом работы с моделью объедините эти параметры:

200 228 


244 272 

245Ограниченная модель скрыта из средства выбора `/model`. Выбор её по имени с помощью `--model`, переменной окружения `ANTHROPIC_MODEL` или параметра `model` показывает уведомление `Model "<name>" is restricted by your organization's settings. Using <model> instead.` и сеанс начинается на разрешённой модели. Ввод `/model <name>` для ограниченной модели отклоняется с `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` и сеанс сохраняет свою текущую модель.273Ограниченная модель скрыта из средства выбора `/model`. Выбор её по имени с помощью `--model`, переменной окружения `ANTHROPIC_MODEL` или параметра `model` показывает уведомление `Model "<name>" is restricted by your organization's settings. Using <model> instead.` и сеанс начинается на разрешённой модели. Ввод `/model <name>` для ограниченной модели отклоняется с `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` и сеанс сохраняет свою текущую модель.

246 274 

247Оба механизма применяются вместе: модель доступна для выбора только когда она разрешена `availableModels` и не ограничена организацией. Ограничения организации доставляются сеансам на API Anthropic и развёртываниях [LLM gateway](/ru/llm-gateway). Сеансы на Bedrock, Vertex AI, Foundry и Claude Platform на AWS не получают их, поэтому используйте `availableModels` на этих поставщиках вместо этого.275[Псевдоним семейства моделей](#restrict-model-selection), такой как `opus`, разрешается на самую новую версию своего семейства, которую организация разрешает, с тем же уведомлением о подстановке. `/model <alias>` отклоняется только когда каждая версия его семейства ограничена; псевдоним, установленный с помощью `--model`, `ANTHROPIC_MODEL` или параметра `model`, всё ещё заменяется при запуске в этом случае. До v2.1.205 псевдоним семейства подставлялся или отклонялся на основе только его самой новой выпущенной версии, даже когда была разрешена более старая версия.

276 

277Ограничения применяются на уровне организации или по ролям:

278 

279* Отключение модели на уровне организации удаляет её для каждого члена.

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

281* Модели Haiku всегда доступны и не могут быть отключены, поэтому каждый член сохраняет по крайней мере одну пригодную для использования модель.

282* Изменение доступа вступает в силу для новых запросов в течение примерно минуты; средство выбора `/model` отражает это при следующем запуске сеанса.

283 

284Оба механизма применяются вместе: модель доступна для выбора только когда она разрешена `availableModels` и не ограничена организацией. Ограничения организации доставляются сеансам на API Anthropic и развёртываниях [LLM gateway](/ru/llm-gateway). Сеансы на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS не получают их, поэтому используйте `availableModels` на этих поставщиках вместо этого.

248 285 

249<h2 id="organization-default-model">286<h2 id="organization-default-model">

250 Модель по умолчанию организации287 Модель по умолчанию организации


303* **Max, Team Premium, Enterprise с оплатой по мере использования и Anthropic API**: по умолчанию Opus 4.8340* **Max, Team Premium, Enterprise с оплатой по мере использования и Anthropic API**: по умолчанию Opus 4.8

304* **Claude Platform на AWS**: по умолчанию Opus 4.7341* **Claude Platform на AWS**: по умолчанию Opus 4.7

305* **Pro, Team Standard и места Enterprise подписки**: по умолчанию Sonnet 5342* **Pro, Team Standard и места Enterprise подписки**: по умолчанию Sonnet 5

306* **Bedrock, Vertex и Foundry**: по умолчанию Sonnet 4.5343* **Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry**: по умолчанию Sonnet 4.5

307 344 

308Enterprise с оплатой по мере использования означает организацию Enterprise, выставляемую счет по использованию, а не по месту подписки.345Enterprise с оплатой по мере использования означает организацию Enterprise, выставляемую счет по использованию, а не по месту подписки.

309 346 


326 363 

327Фаза Opus в режиме плана использует то же контекстное окно, что и параметр модели `opus`. На уровнях подписки, где Opus [автоматически обновляется до контекста 1M](#extended-context), `opusplan` получает обновление и в режиме плана. Чтобы принудительно установить контекст 1M для обеих фаз, когда вы не находитесь на уровне с автоматическим обновлением, установите модель на `opusplan[1m]`.364Фаза Opus в режиме плана использует то же контекстное окно, что и параметр модели `opus`. На уровнях подписки, где Opus [автоматически обновляется до контекста 1M](#extended-context), `opusplan` получает обновление и в режиме плана. Чтобы принудительно установить контекст 1M для обеих фаз, когда вы не находитесь на уровне с автоматическим обновлением, установите модель на `opusplan[1m]`.

328 365 

329Когда [`availableModels`](#restrict-model-selection) исключает Opus, `opusplan` остается на Sonnet в режиме плана вместо переключения. Аналогично, сеанс Haiku, который обычно обновляется до Sonnet в режиме плана, остается на Haiku, когда Sonnet исключен.366Когда [`availableModels`](#restrict-model-selection) исключает новейший Opus, но разрешает более старую версию, например `["sonnet", "claude-opus-4-6"]`, `opusplan` использует новейший разрешенный Opus для планирования и остается только на Sonnet, когда исключен каждый Opus. Сеанс Haiku, который обычно обновляется до Sonnet в режиме плана, аналогично использует новейший разрешенный Sonnet и остается на Haiku только когда исключен каждый Sonnet. До v2.1.205 режим плана оставался на модели сеанса всякий раз, когда исключалась новейшая версия семейства обновлений, даже когда список разрешений разрешал более старую версию.

367 

368Подстановка более старой разрешенной версии применяется на Anthropic API и [Claude Platform на AWS](/ru/claude-platform-on-aws). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Mantle, чьи развертывания используют идентификаторы моделей, специфичные для поставщика, режим плана остается на модели сеанса всякий раз, когда исключается модель обновления.

330 369 

331Для гибридного подхода, при котором Claude решает в середине задачи, когда обратиться ко второй модели, а не переключаться на границе плана, см. [инструмент advisor](/ru/advisor).370Для гибридного подхода, при котором Claude решает в середине задачи, когда обратиться ко второй модели, а не переключаться на границе плана, см. [инструмент advisor](/ru/advisor).

332 371 


392* В [неинтерактивном режиме](/ru/cli-reference#cli-flags) и интеграциях SDK, которые не могут показать подсказку, помеченный запрос завершает ход с отказом вместо этого.431* В [неинтерактивном режиме](/ru/cli-reference#cli-flags) и интеграциях SDK, которые не могут показать подсказку, помеченный запрос завершает ход с отказом вместо этого.

393* Когда цель резервного варианта заблокирована [`availableModels`](#restrict-model-selection), подсказка не показывается. Помеченный запрос завершается с отказом, так же как автоматический резервный вариант, когда цель заблокирована.432* Когда цель резервного варианта заблокирована [`availableModels`](#restrict-model-selection), подсказка не показывается. Помеченный запрос завершается с отказом, так же как автоматический резервный вариант, когда цель заблокирована.

394 433 

395<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">434<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">

396 Включение резервного варианта на Bedrock, Vertex AI и Foundry435 Включение резервного варианта на Bedrock, Agent Platform и Foundry

397</h4>436</h4>

398 437 

399На [Amazon Bedrock](/ru/amazon-bedrock), [Google Vertex AI](/ru/google-vertex-ai) и [Microsoft Foundry](/ru/microsoft-foundry) идентификаторы моделей зависят от поставщика, поэтому автоматический резервный вариант работает только, когда Claude Code может идентифицировать обе задействованные модели:438На [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) и [Microsoft Foundry](/ru/microsoft-foundry) идентификаторы моделей зависят от поставщика, поэтому автоматический резервный вариант работает только, когда Claude Code может идентифицировать обе задействованные модели:

400 439 

401* Claude Code должен распознавать текущую модель как Fable 5: идентификатор модели содержит `claude-fable-5`, соответствует значению `ANTHROPIC_DEFAULT_FABLE_MODEL` или сопоставляется с [`modelOverrides`](#override-model-ids-per-version).440* Claude Code должен распознавать текущую модель как Fable 5: идентификатор модели содержит `claude-fable-5`, соответствует значению `ANTHROPIC_DEFAULT_FABLE_MODEL` или сопоставляется с [`modelOverrides`](#override-model-ids-per-version).

402* Цель резервного варианта должна разрешаться в модель Opus: значение `ANTHROPIC_DEFAULT_OPUS_MODEL`, если установлено, в противном случае запись Opus 4.8 в списке моделей поставщика.441* Цель резервного варианта должна разрешаться в модель Opus: значение `ANTHROPIC_DEFAULT_OPUS_MODEL`, если установлено, в противном случае запись Opus 4.8 в списке моделей поставщика.


429 468 

430Усилие по умолчанию составляет `high` на Fable 5, Sonnet 5, Opus 4.8, Opus 4.6 и Sonnet 4.6, и `xhigh` на Opus 4.7.469Усилие по умолчанию составляет `high` на Fable 5, Sonnet 5, Opus 4.8, Opus 4.6 и Sonnet 4.6, и `xhigh` на Opus 4.7.

431 470 

432Когда вы впервые запускаете Fable 5, Opus 4.8 или Opus 4.7, Claude Code применяет усилие по умолчанию этой модели, даже если вы ранее установили другой уровень для другой модели: `high` на Fable 5 и Opus 4.8, и `xhigh` на Opus 4.7. Запустите `/effort` снова, чтобы выбрать другой уровень после переключения.471Когда вы впервые запускаете Fable 5, Opus 4.8 или Opus 4.7, Claude Code применяет усилие по умолчанию этой модели, даже если вы ранее установили другой уровень для другой модели: `high` на Fable 5 и Opus 4.8, и `xhigh` на Opus 4.7. Запустите `/effort` снова, чтобы выбрать другой уровень после переключения. Это значение по умолчанию сохраняется между сеансами, пока вы не сделаете явный выбор усилий, такой как запуск `/effort` в интерактивном сеансе или запуск с `--effort`.

472 

473`low`, `medium`, `high` и `xhigh` сохраняются между сеансами, когда вы устанавливаете их в интерактивном сеансе. {/* min-version: 2.1.205 */}Уровень, установленный с помощью `/effort` в [неинтерактивном режиме](/ru/headless), с флагом `-p`, применяется только к текущему сеансу и не сохраняется как ваше значение по умолчанию. Неинтерактивный `/effort` также не может отменить удержание модели по умолчанию выше: на Fable 5, Opus 4.8 и Opus 4.7 он сообщает `Not applied` и сеанс остается на усилии модели по умолчанию, поэтому вместо этого передайте `--effort` при запуске. `max` обеспечивает самое глубокое рассуждение без ограничений на расходование токенов и применяется только к текущему сеансу, кроме случаев, когда установлено через переменную окружения `CLAUDE_CODE_EFFORT_LEVEL`.

474 

475Меню `/effort` также предлагает `ultracode`. Ultracode — это параметр Claude Code, а не уровень усилий модели: он отправляет `xhigh` модели и дополнительно позволяет Claude организовать [динамические рабочие процессы](/ru/workflows) для существенных задач. Применяется только к текущему сеансу.

433 476 

434`low`, `medium`, `high` и `xhigh` сохраняются между сеансами. `max` обеспечивает самое глубокое рассуждение без ограничений на расходование токенов и применяется только к текущему сеансу, кроме случаев, когда установлено через переменную окружения `CLAUDE_CODE_EFFORT_LEVEL`.477Вы можете включить ultracode любым из следующих способов:

435 478 

436Меню `/effort` также предлагает `ultracode`. Ultracode — это параметр Claude Code, а не уровень усилий модели: он отправляет `xhigh` модели и дополнительно позволяет Claude организовать [динамические рабочие процессы](/ru/workflows) для существенных задач. Применяется только к текущему сеансу. Установите его через `/effort` или передайте `"ultracode": true` через `--settings` или запрос управления Agent SDK. Это не часть параметра `effortLevel`, флага `--effort` или `CLAUDE_CODE_EFFORT_LEVEL`.479* **`/effort`**: запустите `/effort ultracode` или выберите его из меню

480* **Флаг `--effort`**: запустите с `claude --effort ultracode`, что запускает сеанс с усилием `xhigh` и включенным ultracode

481* **`--settings` или запрос управления Agent SDK**: передайте `"ultracode": true`. Запрос [`applyFlagSettings()`](/ru/agent-sdk/typescript#applyflagsettings) также принимает `effortLevel: "ultracode"`

482 

483Передача `ultracode` флагу `--effort` или значению Agent SDK `effortLevel` требует Claude Code v2.1.203 или более поздней версии. До v2.1.203 `--effort ultracode` выводил `Unknown --effort value 'ultracode'` и сеанс начинался с усилия по умолчанию.

484 

485Сохраненный параметр `effortLevel` и переменная окружения `CLAUDE_CODE_EFFORT_LEVEL` не принимают `ultracode`.

486 

487Когда ultracode недоступен, например когда [рабочие процессы отключены](/ru/workflows#turn-workflows-off), `--effort ultracode` устанавливает только усилие `xhigh`.

437 488 

438<h4 id="choose-an-effort-level">489<h4 id="choose-an-effort-level">

439 Выбор уровня усилий490 Выбор уровня усилий


590 Закрепление моделей для развертываний третьих сторон641 Закрепление моделей для развертываний третьих сторон

591</h3>642</h3>

592 643 

593При развертывании Claude Code через [Bedrock](/ru/amazon-bedrock), [Vertex AI](/ru/google-vertex-ai), [Foundry](/ru/microsoft-foundry) или [Claude Platform on AWS](/ru/claude-platform-on-aws) закрепите версии моделей перед развертыванием для пользователей.644При развертывании 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) закрепите версии моделей перед развертыванием для пользователей.

594 645 

595Без закрепления Claude Code использует псевдонимы моделей, такие как `fable`, `opus`, `sonnet` и `haiku`, которые разрешаются в встроенный идентификатор модели по умолчанию для каждого поставщика. Это значение по умолчанию может отставать от последнего выпуска Anthropic, и модель, на которую оно указывает, может быть еще не включена в учетную запись пользователя. Когда значение по умолчанию недоступно, пользователи Bedrock и Vertex AI видят уведомление и возвращаются к предыдущей версии для этого сеанса, в то время как пользователи Foundry видят ошибки, потому что Foundry не имеет эквивалентной проверки при запуске.646Без закрепления Claude Code использует псевдонимы моделей, такие как `fable`, `opus`, `sonnet` и `haiku`, которые разрешаются в встроенный идентификатор модели по умолчанию для каждого поставщика. Это значение по умолчанию может отставать от последнего выпуска Anthropic, и модель, на которую оно указывает, может быть еще не включена в учетную запись пользователя. Когда значение по умолчанию недоступно, пользователи Amazon Bedrock и Google Cloud's Agent Platform видят уведомление и возвращаются к предыдущей версии для этого сеанса, в то время как пользователи Microsoft Foundry видят ошибки, потому что Microsoft Foundry не имеет эквивалентной проверки при запуске.

596 647 

597<Warning>648<Warning>

598 Установите переменные окружения модели на конкретные идентификаторы версий как часть вашей начальной настройки. Закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.649 Установите переменные окружения модели на конкретные идентификаторы версий как часть вашей начальной настройки. Закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.


601Используйте следующие переменные окружения с идентификаторами моделей, специфичными для версии, для вашего поставщика:652Используйте следующие переменные окружения с идентификаторами моделей, специфичными для версии, для вашего поставщика:

602 653 

603| Поставщик | Пример |654| Поставщик | Пример |

604| :-------- | :------------------------------------------------------------------- |655| :---------------------------- | :------------------------------------------------------------------- |

605| Bedrock | `export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` |656| Amazon Bedrock | `export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` |

606| Vertex AI | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |657| Google Cloud's Agent Platform | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |

607| Foundry | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |658| Microsoft Foundry | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |

608 659 

609Применяйте тот же шаблон для `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` и `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Для текущих и устаревших идентификаторов моделей во всех поставщиках см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Чтобы обновить пользователей до новой версии модели, обновите эти переменные окружения и переразверните.660Применяйте тот же шаблон для `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` и `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Для текущих и устаревших идентификаторов моделей во всех поставщиках см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Чтобы обновить пользователей до новой версии модели, обновите эти переменные окружения и переразверните.

610 661 


618 669 

619* Claude Code удаляет суффикс перед отправкой идентификатора модели вашему поставщику.670* Claude Code удаляет суффикс перед отправкой идентификатора модели вашему поставщику.

620* Добавляйте `[1m]` только когда базовая модель [поддерживает контекст 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window).671* Добавляйте `[1m]` только когда базовая модель [поддерживает контекст 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window).

621* Суффикс читается для каждой переменной, а не для каждой модели. На Bedrock, Vertex и Foundry идентификатор модели без `[1m]` в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом. Sonnet 5 всегда работает с окном 1M на этих поставщиках и никогда не требует суффикса.672* Суффикс читается для каждой переменной, а не для каждой модели. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификатор модели без `[1m]` в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом. Sonnet 5 всегда работает с окном 1M на этих поставщиках и никогда не требует суффикса.

622 673 

623<Note>674<Note>

624 Список разрешений `availableModels`, доставленный через [MDM или управляемый файл параметров](/ru/settings#settings-files), все ещё применяется при использовании поставщиков третьих сторон; [параметры, управляемые сервером, не доставляются туда](/ru/server-managed-settings#platform-availability). Фильтрация соответствует псевдониму модели, такому как `opus`, префиксу версии, такому как `claude-opus-4-8`, или полному идентификатору модели в форме поставщика. Префиксы, специфичные для поставщика, такие как `us.anthropic.`, не удаляются, поэтому для разрешения конкретной модели укажите ту же форму идентификатора поставщика, которую показывает средство выбора, или отобразите ее через [`modelOverrides`](#override-model-ids-per-version). Любой суффикс `[1m]` удаляется как из записи списка разрешений, так и из запрашиваемой модели перед сопоставлением.675 Список разрешений `availableModels`, доставленный через [MDM или управляемый файл параметров](/ru/settings#settings-files), все ещё применяется при использовании поставщиков третьих сторон; [параметры, управляемые сервером, не доставляются туда](/ru/server-managed-settings#platform-availability). Фильтрация соответствует псевдониму модели, такому как `opus`, префиксу версии, такому как `claude-opus-4-8`, или полному идентификатору модели в форме поставщика. Префиксы, специфичные для поставщика, такие как `us.anthropic.`, не удаляются, поэтому для разрешения конкретной модели укажите ту же форму идентификатора поставщика, которую показывает средство выбора, или отобразите ее через [`modelOverrides`](#override-model-ids-per-version). Любой суффикс `[1m]` удаляется как из записи списка разрешений, так и из запрашиваемой модели перед сопоставлением.


630 681 

631Когда вы закрепляете модель у поставщика третьей стороны, идентификатор, специфичный для поставщика, отображается как есть в средстве выбора `/model`, и Claude Code может не распознать, какие функции поддерживает модель. Вы можете переопределить отображаемое имя и объявить возможности с помощью вспомогательных переменных окружения для каждой закрепленной модели.682Когда вы закрепляете модель у поставщика третьей стороны, идентификатор, специфичный для поставщика, отображается как есть в средстве выбора `/model`, и Claude Code может не распознать, какие функции поддерживает модель. Вы можете переопределить отображаемое имя и объявить возможности с помощью вспомогательных переменных окружения для каждой закрепленной модели.

632 683 

633Эти переменные вступают в силу у поставщиков третьих сторон, таких как Bedrock, Vertex AI и Foundry. Переменные `_NAME` и `_DESCRIPTION` также вступают в силу, когда `ANTHROPIC_BASE_URL` указывает на [LLM gateway](/ru/llm-gateway). Они не имеют эффекта при прямом подключении к `api.anthropic.com`.684Эти переменные вступают в силу у поставщиков третьих сторон, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Переменные `_NAME` и `_DESCRIPTION` также вступают в силу, когда `ANTHROPIC_BASE_URL` указывает на [LLM gateway](/ru/llm-gateway). Они не имеют эффекта при прямом подключении к `api.anthropic.com`.

634 685 

635| Переменная окружения | Описание |686| Переменная окружения | Описание |

636| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |687| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |


640 691 

641Те же суффиксы `_NAME`, `_DESCRIPTION` и `_SUPPORTED_CAPABILITIES` доступны для `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_FABLE_MODEL` и `ANTHROPIC_CUSTOM_MODEL_OPTION`.692Те же суффиксы `_NAME`, `_DESCRIPTION` и `_SUPPORTED_CAPABILITIES` доступны для `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_FABLE_MODEL` и `ANTHROPIC_CUSTOM_MODEL_OPTION`.

642 693 

643Claude Code включает функции, такие как [уровни усилий](#adjust-effort-level) и [расширенное мышление](#extended-thinking), путем сопоставления идентификатора модели с известными шаблонами. Идентификаторы, специфичные для поставщика, такие как ARN Bedrock или пользовательские имена развертывания, часто не соответствуют этим шаблонам, оставляя поддерживаемые функции отключенными. Установите `_SUPPORTED_CAPABILITIES`, чтобы сообщить Claude Code, какие функции фактически поддерживает модель:694Claude Code включает функции, такие как [уровни усилий](#adjust-effort-level) и [расширенное мышление](#extended-thinking), путем сопоставления идентификатора модели с известными шаблонами. Идентификаторы, специфичные для поставщика, такие как ARN Amazon Bedrock или пользовательские имена развертывания, часто не соответствуют этим шаблонам, оставляя поддерживаемые функции отключенными. Установите `_SUPPORTED_CAPABILITIES`, чтобы сообщить Claude Code, какие функции фактически поддерживает модель:

644 695 

645| Значение возможности | Включает |696| Значение возможности | Включает |

646| ---------------------- | -------------------------------------------------------------------------------------------- |697| ---------------------- | -------------------------------------------------------------------------------------------- |


653 704 

654Когда установлена `_SUPPORTED_CAPABILITIES`, перечисленные возможности включены, а неперечисленные возможности отключены для соответствующей закрепленной модели. Когда переменная не установлена, Claude Code возвращается к встроенному обнаружению на основе идентификатора модели.705Когда установлена `_SUPPORTED_CAPABILITIES`, перечисленные возможности включены, а неперечисленные возможности отключены для соответствующей закрепленной модели. Когда переменная не установлена, Claude Code возвращается к встроенному обнаружению на основе идентификатора модели.

655 706 

656Этот пример закрепляет Opus на пользовательский ARN модели Bedrock, устанавливает понятное имя и объявляет его возможности:707Этот пример закрепляет Opus на пользовательский ARN модели Amazon Bedrock, устанавливает понятное имя и объявляет его возможности:

657 708 

658```bash theme={null}709```bash theme={null}

659export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'710export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'


670 721 

671`modelOverrides` отображает отдельные идентификаторы моделей Anthropic на строки, специфичные для поставщика, которые Claude Code отправляет API вашего поставщика. Когда пользователь выбирает отображаемую модель в средстве выбора `/model`, Claude Code использует ваше настроенное значение вместо встроенного значения по умолчанию.722`modelOverrides` отображает отдельные идентификаторы моделей Anthropic на строки, специфичные для поставщика, которые Claude Code отправляет API вашего поставщика. Когда пользователь выбирает отображаемую модель в средстве выбора `/model`, Claude Code использует ваше настроенное значение вместо встроенного значения по умолчанию.

672 723 

673Это позволяет администраторам предприятия маршрутизировать каждую версию модели на конкретный ARN профиля вывода Bedrock, имя версии Vertex AI или имя развертывания Foundry для управления, распределения затрат или региональной маршрутизации.724Это позволяет администраторам предприятия маршрутизировать каждую версию модели на конкретный ARN профиля вывода Amazon Bedrock, имя версии Google Cloud's Agent Platform или имя развертывания Microsoft Foundry для управления, распределения затрат или региональной маршрутизации.

674 725 

675Установите `modelOverrides` в [файле параметров](/ru/settings#settings-files):726Установите `modelOverrides` в [файле параметров](/ru/settings#settings-files):

676 727 


686 737 

687Ключи должны быть идентификаторами моделей Anthropic, как указано в [Обзоре моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Для датированных идентификаторов моделей включите суффикс даты точно так, как он там отображается. Неизвестные ключи игнорируются.738Ключи должны быть идентификаторами моделей Anthropic, как указано в [Обзоре моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Для датированных идентификаторов моделей включите суффикс даты точно так, как он там отображается. Неизвестные ключи игнорируются.

688 739 

689Переопределения заменяют встроенные идентификаторы моделей, которые поддерживают каждую запись в средстве выбора `/model`. На Bedrock переопределения имеют приоритет над любыми профилями вывода, которые Claude Code автоматически обнаруживает при запуске. Значения, которые вы предоставляете непосредственно через `ANTHROPIC_MODEL`, `--model` или переменные окружения `ANTHROPIC_DEFAULT_*_MODEL`, передаются поставщику как есть и не преобразуются `modelOverrides`.740Переопределения заменяют встроенные идентификаторы моделей, которые поддерживают каждую запись в средстве выбора `/model`. На Amazon Bedrock переопределения имеют приоритет над любыми профилями вывода, которые Claude Code автоматически обнаруживает при запуске. Claude Code передает значения, которые уже являются специфичными для поставщика, такие как ARN профиля вывода Amazon Bedrock или имена развертывания Microsoft Foundry, поставщику как есть.

741 

742{/* min-version: 2.1.200 */}Переопределения также применяются, когда вы передаете идентификатор модели Anthropic непосредственно через `--model`, переменную окружения `ANTHROPIC_MODEL` или переменную окружения `ANTHROPIC_DEFAULT_*_MODEL`. На Amazon Bedrock, Google Cloud's Agent Platform и [Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) идентификатор модели Anthropic без записи `modelOverrides` разрешается в тот же идентификатор, специфичный для поставщика, что и строка средства выбора `/model` для этой версии, когда поставщик поддерживает эту версию. Mantle поддерживает подмножество версий. Для идентификатора модели Anthropic вне этого подмножества Claude Code отправляет необработанный идентификатор Mantle без отображения, если только запись `modelOverrides` не охватывает его. До версии 2.1.200 значения `--model` и переменных окружения достигали поставщика как есть без прохождения через карту переопределений.

690 743 

691`modelOverrides` работает вместе с `availableModels`. Список разрешений оценивается по идентификатору модели Anthropic, а не по значению переопределения, поэтому запись, такая как `"opus"` в `availableModels`, продолжает совпадать, даже когда версии Opus отображаются на ARN. Когда `enforceAvailableModels` установлен в управляемых параметрах, принудительное значение Default разрешается через `modelOverrides` из [источника управляемых параметров с наивысшим приоритетом](/ru/server-managed-settings#settings-precedence) только. Отображение администратора, такое как версия, закрепленная на ARN профиля вывода, соблюдается в принудительном Default. Переопределения из параметров пользователя или проекта не влияют на него.744`modelOverrides` работает вместе с `availableModels`. Список разрешений оценивается по идентификатору модели Anthropic, а не по значению переопределения, поэтому запись, такая как `"opus"` в `availableModels`, продолжает совпадать, даже когда версии Opus отображаются на ARN. Когда `enforceAvailableModels` установлен в управляемых параметрах, принудительное значение Default разрешается через `modelOverrides` из [источника управляемых параметров с наивысшим приоритетом](/ru/server-managed-settings#settings-precedence) только. Отображение администратора, такое как версия, закрепленная на ARN профиля вывода, соблюдается в принудительном Default. Переопределения из параметров пользователя или проекта не влияют на него.

692 745 

746{/* min-version: 2.1.200 */}Когда `availableModels` установлен в [управляемых параметрах](/ru/settings#settings-files), только `modelOverrides` из этого управляемого источника применяются к идентификатору модели Anthropic, переданному непосредственно через `--model` или переменные окружения выше. Claude Code игнорирует переопределения в параметрах пользователя или проекта для этих идентификаторов и никогда не разрешает идентификатор, который исключает управляемый список, через `modelOverrides` из любого источника параметров. Это ограничение управляемого источника требует Claude Code версии 2.1.200 или позже. См. [Ограничение выбора модели](#restrict-model-selection) для того, как обрабатываются заблокированные идентификаторы.

747 

693<h3 id="prompt-caching-configuration">748<h3 id="prompt-caching-configuration">

694 Конфигурация кэширования подсказок749 Конфигурация кэширования подсказок

695</h3>750</h3>

Details

79</h3>79</h3>

80 80 

81| Переменная окружения | Описание | Примеры значений |81| Переменная окружения | Описание | Примеры значений |

82| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |82| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |

83| `CLAUDE_CODE_ENABLE_TELEMETRY` | Включает сбор телеметрии (обязательно) | `1` |83| `CLAUDE_CODE_ENABLE_TELEMETRY` | Включает сбор телеметрии (обязательно) | `1` |

84| `OTEL_METRICS_EXPORTER` | Типы экспортера метрик, разделенные запятыми. Используйте `none` для отключения | `console`, `otlp`, `prometheus`, `none` |84| `OTEL_METRICS_EXPORTER` | Типы экспортера метрик, разделенные запятыми. Используйте `none` для отключения | `console`, `otlp`, `prometheus`, `none` |

85| `OTEL_LOGS_EXPORTER` | Типы экспортера логов/событий, разделенные запятыми. Используйте `none` для отключения | `console`, `otlp`, `none` |85| `OTEL_LOGS_EXPORTER` | Типы экспортера логов/событий, разделенные запятыми. Используйте `none` для отключения | `console`, `otlp`, `none` |


94| `OTEL_LOGS_EXPORT_INTERVAL` | Интервал экспорта логов в миллисекундах (по умолчанию: 5000) | `1000`, `10000` |94| `OTEL_LOGS_EXPORT_INTERVAL` | Интервал экспорта логов в миллисекундах (по умолчанию: 5000) | `1000`, `10000` |

95| `OTEL_LOG_USER_PROMPTS` | Включить логирование содержимого пользовательских подсказок (по умолчанию: отключено) | `1` для включения |95| `OTEL_LOG_USER_PROMPTS` | Включить логирование содержимого пользовательских подсказок (по умолчанию: отключено) | `1` для включения |

96| `OTEL_LOG_ASSISTANT_RESPONSES` | Включить логирование текста ответа ассистента на событиях `assistant_response` (по умолчанию: отключено). Если не установлено, возвращается к значению `OTEL_LOG_USER_PROMPTS`. {/* min-version: 2.1.193 */}Требует Claude Code v2.1.193 или позже | `1` для включения, `0` для сохранения скрытым |96| `OTEL_LOG_ASSISTANT_RESPONSES` | Включить логирование текста ответа ассистента на событиях `assistant_response` (по умолчанию: отключено). Если не установлено, возвращается к значению `OTEL_LOG_USER_PROMPTS`. {/* min-version: 2.1.193 */}Требует Claude Code v2.1.193 или позже | `1` для включения, `0` для сохранения скрытым |

97| `OTEL_LOG_TOOL_DETAILS` | Включить логирование параметров инструмента и аргументов входных данных в событиях инструментов и атрибутах span трассировки: команды Bash, имена MCP сервера и инструмента, имена навыков и входные данные инструмента. Также включает пользовательские, плагин и MCP имена команд на событиях `user_prompt` (по умолчанию: отключено) | `1` для включения |97| `OTEL_LOG_TOOL_DETAILS` | Включить логирование параметров инструмента и аргументов входных данных в событиях инструментов и атрибутах span трассировки: команды Bash, имена MCP сервера и инструмента, имена навыков, имена пользовательских рабочих процессов и входные данные инструмента. Также включает пользовательские, плагин и MCP имена команд на событиях `user_prompt` (по умолчанию: отключено) | `1` для включения |

98| `OTEL_LOG_TOOL_CONTENT` | Включить логирование входных и выходных данных инструмента в событиях span (по умолчанию: отключено). Требует [трассировку](#traces-beta). Содержимое усекается на 60 КБ | `1` для включения |98| `OTEL_LOG_TOOL_CONTENT` | Включить логирование входных и выходных данных инструмента в событиях span (по умолчанию: отключено). Требует [трассировку](#traces-beta). Содержимое усекается на 60 КБ | `1` для включения |

99| `OTEL_LOG_RAW_API_BODIES` | Выдавать полный JSON запроса и ответа Anthropic Messages API как события логов `api_request_body` / `api_response_body` (по умолчанию: отключено). Тела включают всю историю разговора. Включение этого подразумевает согласие со всем, что раскрыли бы `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` и `OTEL_LOG_TOOL_CONTENT` | `1` для встроенных тел, усеченных на 60 КБ, или `file:<dir>` для неусеченных тел на диске с указателем `body_ref` в событии |99| `OTEL_LOG_RAW_API_BODIES` | Выдавать полный JSON запроса и ответа Anthropic Messages API как события логов `api_request_body` / `api_response_body` (по умолчанию: отключено). Тела включают всю историю разговора. Включение этого подразумевает согласие со всем, что раскрыли бы `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` и `OTEL_LOG_TOOL_CONTENT` | `1` для встроенных тел, усеченных на 60 КБ, или `file:<dir>` для неусеченных тел на диске с указателем `body_ref` в событии |

100| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Предпочтение временности метрик (по умолчанию: `delta`). Установите на `cumulative`, если ваш бэкенд ожидает кумулятивную временность | `delta`, `cumulative` |100| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Предпочтение временности метрик (по умолчанию: `delta`). Установите на `cumulative`, если ваш бэкенд ожидает кумулятивную временность | `delta`, `cumulative` |


191**`claude_code.llm_request`**191**`claude_code.llm_request`**

192 192 

193| Атрибут | Описание | Управляется |193| Атрибут | Описание | Управляется |

194| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------- |194| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |

195| `model` | Идентификатор модели | |195| `model` | Идентификатор модели | |

196| `gen_ai.system` | Всегда `anthropic`. Семантическое соглашение OpenTelemetry GenAI | |196| `gen_ai.system` | Всегда `anthropic`. Семантическое соглашение OpenTelemetry GenAI | |

197| `gen_ai.request.model` | То же значение, что и `model`. Семантическое соглашение OpenTelemetry GenAI | |197| `gen_ai.request.model` | То же значение, что и `model`. Семантическое соглашение OpenTelemetry GenAI | |

198| `query_source` | Подсистема, которая выдала запрос, такая как `repl_main_thread` или имя подагента | |198| `query_source` | Подсистема, которая выдала запрос, такая как `repl_main_thread` или имя подагента | |

199| `agent_id` | Идентификатор подагента или товарища, который выдал запрос. Отсутствует в основном сеансе | |199| `agent_id` | Идентификатор подагента или товарища, который выдал запрос. Отсутствует в основном сеансе | |

200| `parent_agent_id` | Идентификатор агента, который породил этот. Отсутствует для основного сеанса и для агентов, порожденных непосредственно из него | |200| `parent_agent_id` | Идентификатор агента, который породил этот. Отсутствует для основного сеанса и для агентов, порожденных непосредственно из него | |

201| `workflow.run_id` | Идентификатор запуска инструмента [Workflow](/ru/workflows), который породил этого агента, с префиксом `wf_`. Отсутствует для агентов, не порожденных рабочим процессом | |

202| `workflow.name` | Имя рабочего процесса, который породил этого агента. Имена, созданные пользователем, заменяются на `custom`, если gate не установлен | `OTEL_LOG_TOOL_DETAILS` |

201| `speed` | `fast` или `normal` | |203| `speed` | `fast` или `normal` | |

202| `llm_request.context` | `interaction`, `tool` или `standalone` в зависимости от родительского span | |204| `llm_request.context` | `interaction`, `tool` или `standalone` в зависимости от родительского span | |

203| `duration_ms` | Длительность в реальном времени, включая повторные попытки | |205| `duration_ms` | Длительность в реальном времени, включая повторные попытки | |


228| `result_tokens` | Приблизительный размер токена результата инструмента | |230| `result_tokens` | Приблизительный размер токена результата инструмента | |

229| `agent_id` | Идентификатор подагента или товарища, который запустил инструмент. Отсутствует в основном сеансе | |231| `agent_id` | Идентификатор подагента или товарища, который запустил инструмент. Отсутствует в основном сеансе | |

230| `parent_agent_id` | Идентификатор агента, который породил этот. Отсутствует для основного сеанса и для агентов, порожденных непосредственно из него | |232| `parent_agent_id` | Идентификатор агента, который породил этот. Отсутствует для основного сеанса и для агентов, порожденных непосредственно из него | |

233| `workflow.run_id` | Идентификатор запуска инструмента Workflow, который породил этого агента, с префиксом `wf_`. Отсутствует для агентов, не порожденных рабочим процессом | |

234| `workflow.name` | Имя рабочего процесса, который породил этого агента. Имена, созданные пользователем, заменяются на `custom`, если gate не установлен | `OTEL_LOG_TOOL_DETAILS` |

231| `tool_use_id` | ID блока `tool_use` модели для этого вызова. Совпадает с `tool_use_id` на событиях [tool\_result](#tool-result-event) и [tool\_decision](#tool-decision-event) и в полезных нагрузках hook, поэтому вы можете присоединить span к этим записям | |235| `tool_use_id` | ID блока `tool_use` модели для этого вызова. Совпадает с `tool_use_id` на событиях [tool\_result](#tool-result-event) и [tool\_decision](#tool-decision-event) и в полезных нагрузках hook, поэтому вы можете присоединить span к этим записям | |

232| `gen_ai.tool.call.id` | То же значение, что и `tool_use_id`. Семантическое соглашение OpenTelemetry GenAI | |236| `gen_ai.tool.call.id` | То же значение, что и `tool_use_id`. Семантическое соглашение OpenTelemetry GenAI | |

233| `file_path` | Целевой путь файла для инструментов Read, Edit и Write | `OTEL_LOG_TOOL_DETAILS` |237| `file_path` | Целевой путь файла для инструментов Read, Edit и Write | `OTEL_LOG_TOOL_DETAILS` |


309 313 

310Если помощник не удается или выводит содержимое, которое не соответствует этим требованиям, Claude Code сообщает об ошибке в:314Если помощник не удается или выводит содержимое, которое не соответствует этим требованиям, Claude Code сообщает об ошибке в:

311 315 

312* выводе `/doctor`316* выводе `/status`

313* журнале отладки при запуске с [`--debug`](/ru/cli-reference#cli-flags) или после запуска `/debug` в сеансе317* журнале отладки при запуске с [`--debug`](/ru/cli-reference#cli-flags) или после запуска `/debug` в сеансе

314* stderr в неинтерактивных сеансах, запущенных с `-p`318* stderr в неинтерактивных сеансах, запущенных с `-p`

315 319 


443 447 

444* `prompt.id`: UUID, коррелирующий пользовательскую подсказку со всеми последующими событиями до следующей подсказки. См. [Атрибуты корреляции событий](#event-correlation-attributes).448* `prompt.id`: UUID, коррелирующий пользовательскую подсказку со всеми последующими событиями до следующей подсказки. См. [Атрибуты корреляции событий](#event-correlation-attributes).

445* `workspace.host_paths`: каталоги рабочей области хоста, выбранные в приложении для рабочего стола, как массив строк449* `workspace.host_paths`: каталоги рабочей области хоста, выбранные в приложении для рабочего стола, как массив строк

450* `workflow.run_id`: идентификатор запуска, с префиксом `wf_`, на событиях API и инструментов, выданных агентами, которые принадлежат запуску инструмента [Workflow](/ru/workflows). Фильтрация событий по одному `workflow.run_id` восстанавливает запросы API и результаты инструментов этого запуска. Идентификатор охватывает агентов, которых порождает скрипт workflow, и любых агентов, которых они порождают в свою очередь, такие как вызовы навыков. Он совпадает с идентификатором запуска, указанным в результате инструмента Workflow. Отсутствует на всех остальных событиях. Требует Claude Code v2.1.202 или позже

451* `workflow.name`: имя workflow, `meta.name` его скрипта, выданное вместе с `workflow.run_id`. Встроенные имена workflow появляются как есть при выполнении немодифицированного встроенного скрипта. Определяемые пользователем имена, включая отредактированные копии встроенных скриптов, заменяются на `custom`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`. Требует Claude Code v2.1.202 или позже

446 452 

447<h3 id="metrics">453<h3 id="metrics">

448 Метрики454 Метрики


884 Событие внутренней ошибки890 Событие внутренней ошибки

885</h4>891</h4>

886 892 

887Логируется, когда Claude Code перехватывает неожиданную внутреннюю ошибку. Записываются только имя класса ошибки и код в стиле errno. Сообщение об ошибке и трассировка стека никогда не включаются. Это событие не выдается при запуске против Bedrock, Vertex или Foundry, или когда установлен `DISABLE_ERROR_REPORTING`.893Логируется, когда Claude Code перехватывает неожиданную внутреннюю ошибку. Записываются только имя класса ошибки и код в стиле errno. Сообщение об ошибке и трассировка стека никогда не включаются. Это событие не выдается при запуске против Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, или когда установлен `DISABLE_ERROR_REPORTING`.

888 894 

889**Имя события**: `claude_code.internal_error`895**Имя события**: `claude_code.internal_error`

890 896 


1163* Атрибуцией расходов конкретным навыкам, плагинам или типам подагентов через атрибуты `skill.name`, `plugin.name` и `agent.name`1169* Атрибуцией расходов конкретным навыкам, плагинам или типам подагентов через атрибуты `skill.name`, `plugin.name` и `agent.name`

1164 1170 

1165<Note>1171<Note>

1166 Метрики затрат являются приблизительными. Для официальных данных о выставлении счетов обратитесь к вашему поставщику API (Claude Console, Amazon Bedrock или Google Cloud Vertex).1172 Метрики затрат являются приблизительными. Для официальных данных о выставлении счетов обратитесь к вашему поставщику API (Claude Console, Amazon Bedrock или Google Cloud's Agent Platform).

1167</Note>1173</Note>

1168 1174 

1169<h3 id="alerting-and-segmentation">1175<h3 id="alerting-and-segmentation">


1219 1225 

1220Вызовы инструментов MCP, команды Bash и редактирование файлов поэтому приписываются разработчику, который запустил сеанс. Claude Code не действует под отдельной учетной записью сервиса; идентификация, записанная на каждом событии, это собственная учетная запись Claude разработчика или идентификация IdP разработчика в сеансе [Claude apps gateway](/ru/claude-apps-gateway).1226Вызовы инструментов MCP, команды Bash и редактирование файлов поэтому приписываются разработчику, который запустил сеанс. Claude Code не действует под отдельной учетной записью сервиса; идентификация, записанная на каждом событии, это собственная учетная запись Claude разработчика или идентификация IdP разработчика в сеансе [Claude apps gateway](/ru/claude-apps-gateway).

1221 1227 

1222Когда Claude Code аутентифицируется с прямым ключом API или против Bedrock, Vertex AI или Microsoft Foundry, в сеансе нет учетной записи Claude и только `user.id` и `session.id` заполняются. В этих развертываниях прикрепите идентификацию пользователя самостоятельно с помощью `OTEL_RESOURCE_ATTRIBUTES`, установленного для каждого пользователя через файл [управляемых параметров](#administrator-configuration) или оболочку запуска. Сеансы Claude apps gateway не требуют ничего из этого: CLI автоматически проставляет идентификацию IdP, как описано в [Стандартные атрибуты](#standard-attributes).1228Когда Claude Code аутентифицируется с прямым ключом API или против Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, в сеансе нет учетной записи Claude и только `user.id` и `session.id` заполняются. В этих развертываниях прикрепите идентификацию пользователя самостоятельно с помощью `OTEL_RESOURCE_ATTRIBUTES`, установленного для каждого пользователя через файл [управляемых параметров](#administrator-configuration) или оболочку запуска. Сеансы Claude apps gateway не требуют ничего из этого: CLI автоматически проставляет идентификацию IdP, как описано в [Стандартные атрибуты](#standard-attributes).

1223 1229 

1224```bash theme={null}1230```bash theme={null}

1225export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."1231export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."


1354 Мониторинг Claude Code на Amazon Bedrock1360 Мониторинг Claude Code на Amazon Bedrock

1355</h2>1361</h2>

1356 1362 

1357Для подробного руководства по мониторингу использования Claude Code для Amazon Bedrock см. [Реализация мониторинга Claude Code (Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md).1363Для подробного руководства по мониторингу использования Claude Code для Amazon Bedrock см. [Реализация мониторинга Claude Code (Amazon Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md).

Details

110export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"110export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"

111```111```

112 112 

113Claude Code читает файлы сертификата и ключа при запуске и перечитывает их каждый раз при применении параметров, включая изменение параметров во время сеанса. Для ротации сертификата и ключа замените файлы по тем же путям.

114 

113<h2 id="network-access-requirements">115<h2 id="network-access-requirements">

114 Требования к доступу в сети116 Требования к доступу в сети

115</h2>117</h2>


131 133 

132Claude Code также отправляет дополнительную операционную телеметрию по умолчанию, которую вы можете отключить с помощью переменных окружения. См. [Услуги телеметрии](/ru/data-usage#telemetry-services), чтобы узнать, как отключить её перед окончательным формированием вашего белого списка.134Claude Code также отправляет дополнительную операционную телеметрию по умолчанию, которую вы можете отключить с помощью переменных окружения. См. [Услуги телеметрии](/ru/data-usage#telemetry-services), чтобы узнать, как отключить её перед окончательным формированием вашего белого списка.

133 135 

134При использовании [Amazon Bedrock](/ru/amazon-bedrock), [Google Vertex AI](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry) или сеанса [шлюза приложений Claude](/ru/claude-apps-gateway) с входом, трафик модели и аутентификация идут к вашему поставщику или шлюзу вместо `api.anthropic.com`, `claude.ai` или `platform.claude.com`. Инструмент WebFetch по-прежнему вызывает `api.anthropic.com` для своей [проверки безопасности домена](/ru/data-usage#webfetch-domain-safety-check), если вы не установите `skipWebFetchPreflight: true` в [параметрах](/ru/settings).136При использовании [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry) или сеанса [шлюза приложений Claude](/ru/claude-apps-gateway) с входом, трафик модели и аутентификация идут к вашему поставщику или шлюзу вместо `api.anthropic.com`, `claude.ai` или `platform.claude.com`. Инструмент WebFetch по-прежнему вызывает `api.anthropic.com` для своей [проверки безопасности домена](/ru/data-usage#webfetch-domain-safety-check), если вы не установите `skipWebFetchPreflight: true` в [параметрах](/ru/settings).

135 137 

136[Claude Code в веб-версии](/ru/claude-code-on-the-web) и [Code Review](/ru/code-review) подключаются к вашим репозиториям из управляемой Anthropic инфраструктуры. Если ваша организация GitHub Enterprise Cloud ограничивает доступ по IP-адресу, включите [наследование списка разрешенных IP для установленных GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps). GitHub App Claude регистрирует свои диапазоны IP, поэтому включение этого параметра позволяет получить доступ без ручной конфигурации. Чтобы [добавить диапазоны в список разрешенных вручную](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) вместо этого, или для настройки других брандмауэров, см. [IP-адреса Anthropic API](https://platform.claude.com/docs/en/api/ip-addresses).138[Claude Code в веб-версии](/ru/claude-code-on-the-web) и [Code Review](/ru/code-review) подключаются к вашим репозиториям из управляемой Anthropic инфраструктуры. Если ваша организация GitHub Enterprise Cloud ограничивает доступ по IP-адресу, включите [наследование списка разрешенных IP для установленных GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps). GitHub App Claude регистрирует свои диапазоны IP, поэтому включение этого параметра позволяет получить доступ без ручной конфигурации. Чтобы [добавить диапазоны в список разрешенных вручную](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) вместо этого, или для настройки других брандмауэров, см. [IP-адреса Anthropic API](https://platform.claude.com/docs/en/api/ip-addresses).

137 139 

overview.md +2 −2

Details

12 Начало работы12 Начало работы

13</h2>13</h2>

14 14 

15Выберите вашу среду для начала работы. Большинство поверхностей требуют [подписку Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) или учетную запись [Anthropic Console](https://console.anthropic.com/). Terminal CLI и VS Code также поддерживают [сторонних поставщиков](/ru/third-party-integrations).15Claude Code работает на нескольких платформах: в терминале, расширениях IDE, настольном приложении и в веб-версии. Выберите одну из вкладок ниже, чтобы начать. Большинство платформ требуют [подписку Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) или учетную запись [Anthropic Console](https://console.anthropic.com/). Terminal CLI и VS Code также поддерживают [сторонних поставщиков](/ru/third-party-integrations).

16 16 

17<Tabs>17<Tabs>

18 <Tab title="Terminal">18 <Tab title="Terminal">


221 Используйте Claude Code везде221 Используйте Claude Code везде

222</h2>222</h2>

223 223 

224Каждая поверхность подключается к одному и тому же базовому механизму Claude Code, поэтому ваши файлы CLAUDE.md, параметры и MCP servers работают на всех них.224Каждая [поверхность](/ru/glossary#surface) подключается к одному и тому же базовому механизму Claude Code, поэтому ваши файлы CLAUDE.md, параметры и MCP servers работают на всех них.

225 225 

226Помимо сред [Terminal](/ru/quickstart), [VS Code](/ru/vs-code), [JetBrains](/ru/jetbrains), [Desktop](/ru/desktop) и [Web](/ru/claude-code-on-the-web) выше, Claude Code интегрируется с CI/CD, чатом и рабочими процессами браузера:226Помимо сред [Terminal](/ru/quickstart), [VS Code](/ru/vs-code), [JetBrains](/ru/jetbrains), [Desktop](/ru/desktop) и [Web](/ru/claude-code-on-the-web) выше, Claude Code интегрируется с CI/CD, чатом и рабочими процессами браузера:

227 227 

Details

6 6 

7> Контролируйте, будет ли Claude просить разрешение перед редактированием файлов или выполнением команд. Переключайте режимы с помощью Shift+Tab в CLI или используйте селектор режима в VS Code, Desktop и claude.ai.7> Контролируйте, будет ли Claude просить разрешение перед редактированием файлов или выполнением команд. Переключайте режимы с помощью Shift+Tab в CLI или используйте селектор режима в VS Code, Desktop и claude.ai.

8 8 

9Когда Claude хочет отредактировать файл, выполнить команду оболочки или сделать сетевой запрос, он делает паузу и просит вас одобрить действие. Режимы разрешений контролируют, как часто происходит эта пауза. Выбранный вами режим определяет ход сеанса: режим по умолчанию требует от вас проверки каждого действия по мере его поступления, в то время как более свободные режимы позволяют Claude работать в более длительных непрерывных отрезках и сообщать о результатах по завершении. Выбирайте больше контроля для чувствительной работы или меньше прерываний, когда вы доверяете направлению.9Когда Claude хочет отредактировать файл, выполнить команду оболочки или сделать сетевой запрос, он делает паузу и просит вас одобрить действие. Режимы разрешений контролируют, как часто происходит эта пауза. Выбранный вами режим определяет ход сеанса: режим Manual mode требует от вас проверки каждого действия по мере его поступления, в то время как более свободные режимы позволяют Claude работать в более длительных непрерывных отрезках и сообщать о результатах по завершении. Выбирайте больше контроля для чувствительной работы или меньше прерываний, когда вы доверяете направлению.

10 10 

11<h2 id="available-modes">11<h2 id="available-modes">

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


16 16 

17| Режим | Что выполняется без запроса | Лучше всего для |17| Режим | Что выполняется без запроса | Лучше всего для |

18| :------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |18| :------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

19| `default` | Только чтение | Начало работы, чувствительная работа |19| `default` | Только чтение. Обозначен как **Manual** в CLI и расширениях IDE | Начало работы, чувствительная работа |

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 или позже.

27 

26Во всех режимах, кроме `bypassPermissions`, записи в [защищённые пути](#protected-paths) никогда не одобряются автоматически, защищая состояние репозитория и собственную конфигурацию Claude от случайного повреждения.28Во всех режимах, кроме `bypassPermissions`, записи в [защищённые пути](#protected-paths) никогда не одобряются автоматически, защищая состояние репозитория и собственную конфигурацию Claude от случайного повреждения.

27 29 

28Режимы устанавливают базовое поведение. Наложите [правила разрешений](/ru/permissions#manage-permissions) сверху, чтобы предварительно одобрить или заблокировать определённые инструменты. Правила отказа и явные правила запроса применяются в каждом режиме, включая `bypassPermissions`. Правила разрешения не имеют эффекта в этом режиме, потому что всё остальное уже одобрено.30Режимы устанавливают базовое поведение. Наложите [правила разрешений](/ru/permissions#manage-permissions) сверху, чтобы предварительно одобрить или заблокировать определённые инструменты. Правила отказа и явные правила запроса применяются в каждом режиме, включая `bypassPermissions`. Правила разрешения не имеют эффекта в этом режиме, потому что всё остальное уже одобрено.


35 37 

36<Tabs>38<Tabs>

37 <Tab title="CLI">39 <Tab title="CLI">

38 **Во время сеанса**: нажмите `Shift+Tab` для циклического переключения `default` → `acceptEdits` → `plan`. Текущий режим отображается в строке состояния. Не все режимы находятся в цикле по умолчанию:40 **Во время сеанса**: нажмите `Shift+Tab` для циклического переключения `default` → `acceptEdits` → `plan`. Текущий режим отображается в строке состояния. {/* min-version: 2.1.203 */}Ручной режим, `default` в этом цикле, показывает серый значок `⏸ manual mode on`. До версии 2.1.203 строка состояния не показывала значок в ручном режиме.

41 

42 Не все режимы находятся в цикле по умолчанию:

39 43 

40 * `auto`: появляется, когда ваша учётная запись соответствует [требованиям режима auto](#eliminate-prompts-with-auto-mode); циклическое переключение на него переключает режимы без подтверждающего запроса44 * `auto`: появляется, когда ваша учётная запись соответствует [требованиям режима auto](#eliminate-prompts-with-auto-mode); циклическое переключение на него переключает режимы без подтверждающего запроса

41 * `bypassPermissions`: появляется после запуска с `--permission-mode bypassPermissions`, `--dangerously-skip-permissions` или `--allow-dangerously-skip-permissions`; вариант `--allow-` добавляет режим в цикл без активации45 * `bypassPermissions`: появляется после запуска с `--permission-mode bypassPermissions`, `--dangerously-skip-permissions` или `--allow-dangerously-skip-permissions`; вариант `--allow-` добавляет режим в цикл без активации


71 75 

72 | Метка пользовательского интерфейса | Режим |76 | Метка пользовательского интерфейса | Режим |

73 | :--------------------------------- | :------------------ |77 | :--------------------------------- | :------------------ |

74 | Ask before edits | `default` |78 | Manual | `default` |

75 | Edit automatically | `acceptEdits` |79 | Edit automatically | `acceptEdits` |

76 | Plan mode | `plan` |80 | Plan | `plan` |

77 | Auto mode | `auto` |81 | Auto | `auto` |

78 | Bypass permissions | `bypassPermissions` |82 | Bypass permissions | `bypassPermissions` |

79 83 

84 До версии 2.1.205 расширение обозначало `plan` как Plan mode и `auto` как Auto mode.

85 

80 Auto mode появляется в индикаторе режима, когда ваша учётная запись соответствует каждому требованию, перечисленному в [разделе режима auto](#eliminate-prompts-with-auto-mode). Параметр `claudeCode.initialPermissionMode` не принимает `auto`. Чтобы запустить в режиме auto по умолчанию, установите `defaultMode` в вашем [пользовательском settings](/ru/settings#settings-files) вместо этого. Claude Code игнорирует `defaultMode: "auto"` в настройках проекта и локальных настройках.86 Auto mode появляется в индикаторе режима, когда ваша учётная запись соответствует каждому требованию, перечисленному в [разделе режима auto](#eliminate-prompts-with-auto-mode). Параметр `claudeCode.initialPermissionMode` не принимает `auto`. Чтобы запустить в режиме auto по умолчанию, установите `defaultMode` в вашем [пользовательском settings](/ru/settings#settings-files) вместо этого. Claude Code игнорирует `defaultMode: "auto"` в настройках проекта и локальных настройках.

81 87 

82 Bypass permissions требует переключателя **Allow dangerously skip permissions** в настройках расширения перед тем, как он появится в индикаторе режима.88 Bypass permissions требует переключателя **Allow dangerously skip permissions** в настройках расширения перед тем, как он появится в индикаторе режима.


95 <Tab title="Web and mobile">101 <Tab title="Web and mobile">

96 Используйте раскрывающееся меню режима рядом с полем подсказки на [claude.ai/code](https://claude.ai/code) или в мобильном приложении. Запросы разрешений появляются в claude.ai для одобрения. Какие режимы появляются, зависит от того, где выполняется сеанс:102 Используйте раскрывающееся меню режима рядом с полем подсказки на [claude.ai/code](https://claude.ai/code) или в мобильном приложении. Запросы разрешений появляются в claude.ai для одобрения. Какие режимы появляются, зависит от того, где выполняется сеанс:

97 103 

98 * **Облачные сеансы** на [Claude Code в веб-версии](/ru/claude-code-on-the-web): Accept edits, Plan mode и Auto mode. Accept edits соответствует режиму `default`: облачная среда предварительно одобряет редактирование файлов независимо от режима, поэтому раскрывающееся меню показывает Accept edits вместо Ask permissions. `defaultMode: "acceptEdits"` из настроек по-прежнему соблюдается. Auto mode появляется только когда ваша организация это разрешает и выбранная модель это поддерживает. Bypass permissions недоступен.104 * **Облачные сеансы** на [Claude Code в веб-версии](/ru/claude-code-on-the-web): Accept edits, Plan и Auto. Accept edits соответствует режиму `default`: облачная среда предварительно одобряет редактирование файлов независимо от режима, поэтому раскрывающееся меню показывает Accept edits вместо Manual. Облачные сеансы по-прежнему соблюдают `defaultMode: "acceptEdits"` из настроек. Auto mode появляется только когда ваша организация это разрешает и выбранная модель это поддерживает. Bypass permissions недоступен.

99 * **Сеансы [Remote Control](/ru/remote-control)** на вашем локальном компьютере: Ask permissions, Auto accept edits и Plan mode. Auto и Bypass permissions недоступны.105 * **Сеансы [Remote Control](/ru/remote-control)** на вашем локальном компьютере: Manual, Accept edits и Plan. Вы не можете выбрать Auto или Bypass permissions из приложения. {/* min-version: 2.1.202 */}Раскрывающееся меню показывает режим, в котором находится локальный сеанс, включая режим, установленный из терминала, и обновляется при изменении режима в приложении или в терминале. Единственное исключение — Bypass permissions: сеанс никогда не сообщает этот режим в claude.ai, поэтому переключение на него из терминала не изменяет то, что показывает раскрывающееся меню. До версии 2.1.202 сеансы, подключённые с помощью `/remote-control` или `claude --remote-control`, вообще не сообщали свой режим, поэтому claude.ai и мобильное приложение могли показывать режим, в котором сеанс не находился. Несоответствие влияло только на метку: Claude Code генерировал запросы разрешений из фактического режима сеанса, и они по-прежнему появлялись в приложении для одобрения.

100 106 

101 Для Remote Control вы также можете установить начальный режим при запуске хоста:107 Для Remote Control вы также можете установить начальный режим при запуске хоста:

102 108 


126 Анализируйте перед редактированием с режимом plan132 Анализируйте перед редактированием с режимом plan

127</h2>133</h2>

128 134 

129Plan mode указывает Claude исследовать и предложить изменения без их внесения. Claude читает файлы, запускает команды оболочки для исследования и пишет план, но не редактирует ваш исходный код. Запросы разрешений по-прежнему применяются так же, как в режиме по умолчанию.135Plan mode указывает Claude исследовать и предложить изменения без их внесения. Claude читает файлы, запускает команды оболочки для исследования и пишет план, но не редактирует ваш исходный код. Запросы разрешений по-прежнему применяются так же, как в режиме Manual mode.

130 136 

131Войдите в режим plan, нажав `Shift+Tab` или добавив префикс к одной подсказке с `/plan`. Вы также можете запустить в режиме plan из CLI:137Войдите в режим plan, нажав `Shift+Tab` или добавив префикс к одной подсказке с `/plan`. Вы также можете запустить в режиме plan из CLI:

132 138 


188 194 

189* **План**: Все планы.195* **План**: Все планы.

190* **Администратор**: на Team и Enterprise администратор должен включить его в [настройках администратора Claude Code](https://claude.ai/admin-settings/claude-code) перед тем, как пользователи смогут его включить. Администраторы также могут заблокировать его, установив `permissions.disableAutoMode` на `"disable"` в [управляемых параметрах](/ru/permissions#managed-settings).196* **Администратор**: на Team и Enterprise администратор должен включить его в [настройках администратора Claude Code](https://claude.ai/admin-settings/claude-code) перед тем, как пользователи смогут его включить. Администраторы также могут заблокировать его, установив `permissions.disableAutoMode` на `"disable"` в [управляемых параметрах](/ru/permissions#managed-settings).

191* **Модель**: на Anthropic API — Claude Opus 4.6 или позже, или Sonnet 4.6 или позже. На Amazon Bedrock, Google Cloud Vertex AI, 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, не поддерживаются ни на одном поставщике.197* **Модель**: на 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, не поддерживаются ни на одном поставщике.

192* **Поставщик**: доступен по умолчанию на Anthropic API. На Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry и подписанных сеансах Claude apps gateway режим auto отключён до тех пор, пока вы не [установите `CLAUDE_CODE_ENABLE_AUTO_MODE`](#enable-auto-mode-on-bedrock-vertex-ai-or-foundry).198* **Поставщик**: доступен по умолчанию на 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).

193 199 

194Если Claude Code сообщает, что режим auto недоступен, одно из этих требований не выполнено; это не временный сбой. Отдельное сообщение, которое называет модель и говорит, что режим auto "не может определить безопасность" действия, является временным сбоем классификатора; см. [справку по ошибкам](/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action).200Если Claude Code сообщает, что режим auto недоступен, одно из этих требований не выполнено; это не временный сбой. Отдельное сообщение, которое называет модель и говорит, что режим auto "не может определить безопасность" действия, является временным сбоем классификатора; см. [справку по ошибкам](/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action).

195 201 

196Если вы установили `defaultMode: "auto"` в [параметрах](/ru/settings#available-settings) и сеанс начинается в режиме `default` без ошибки, параметр, вероятно, находится в `.claude/settings.json` или `.claude/settings.local.json`. Claude Code v2.1.142 и позже игнорируют `auto` из этих файлов, поэтому репозиторий не может предоставить себе режим auto. Переместите его в `~/.claude/settings.json`.202Если вы установили `defaultMode: "auto"` в [параметрах](/ru/settings#available-settings) и сеанс начинается в режиме `default` без ошибки, параметр, вероятно, находится в `.claude/settings.json` или `.claude/settings.local.json`. Claude Code v2.1.142 и позже игнорируют `auto` из этих файлов, поэтому репозиторий не может предоставить себе режим auto. Переместите его в `~/.claude/settings.json`.

197 203 

198<h3 id="enable-auto-mode-on-bedrock-vertex-ai-or-foundry">204<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">

199 Включите режим auto на Bedrock, Vertex AI или Foundry205 Включите режим auto на Bedrock, Agent Platform или Foundry

200</h3>206</h3>

201 207 

202На [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud Vertex AI](/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.208На [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.

203 209 

204Чтобы включить его для одного разработчика, добавьте переменную в блок `env` в `~/.claude/settings.json`:210Чтобы включить его для одного разработчика, добавьте переменную в блок `env` в `~/.claude/settings.json`:

205 211 


223 Что классификатор блокирует по умолчанию229 Что классификатор блокирует по умолчанию

224</h3>230</h3>

225 231 

226Классификатор доверяет вашему рабочему каталогу и настроенным удалённым репозиториям вашего репо. Всё остальное рассматривается как внешнее до тех пор, пока вы не [настроите доверенную инфраструктуру](/ru/auto-mode-config).232Классификатор доверяет вашему рабочему каталогу и удалённым репозиториям, которые были настроены для него при запуске сеанса. {/* min-version: 2.1.200 */}Удалённый репозиторий, добавленный или переориентированный во время сеанса с помощью `git remote add` или `git remote set-url`, не является доверенным, и всё остальное рассматривается как внешнее до тех пор, пока вы не [настроите доверенную инфраструктуру](/ru/auto-mode-config). До v2.1.200 удалённые репозитории, добавленные в середине сеанса, также были доверенными.

227 233 

228**Блокируется по умолчанию**:234**Блокируется по умолчанию**:

229 235 


234* Предоставление разрешений IAM или репозитория240* Предоставление разрешений IAM или репозитория

235* Изменение общей инфраструктуры241* Изменение общей инфраструктуры

236* Необратимое уничтожение файлов, которые существовали до начала сеанса242* Необратимое уничтожение файлов, которые существовали до начала сеанса

237* Force push или прямая отправка на `main`243* Force push

244* {/* min-version: 2.1.203 */}Отправка на ветвь по умолчанию репозитория, когда отправка содержит чувствительное содержимое, такое как секреты или личные или доверенные данные, содержит изменения скрытые или неправильно описанные относительно того, что вы просили, содержит содержимое перенесённое или впервые прочитанное из-за пределов репозитория, или обходит pull request, проверку или проверку, которую вы просили. Простая отправка на ветвь по умолчанию не блокируется сама по себе, и очистка отмеченной отправки требует назвать отмеченное содержимое или обойденную проверку, а не только отправку. Классификатор — это один слой: правила [`permissions.deny`](/ru/permissions#manage-permissions) применяются в каждом режиме и могут полностью блокировать отправки на ветвь по умолчанию, и защита ветвей самого удалённого репозитория по-прежнему применяется. До v2.1.203 любая прямая отправка на ветвь по умолчанию была заблокирована

238* {/* min-version: 2.1.182 */}`git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` или `git stash clear`, которые классификатор предполагает отбросят незафиксированные изменения245* {/* min-version: 2.1.182 */}`git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` или `git stash clear`, которые классификатор предполагает отбросят незафиксированные изменения

239* `git commit --amend` когда коммит в HEAD не был создан в этом сеансе246* `git commit --amend` когда коммит в HEAD не был создан в этом сеансе

240* {/* min-version: 2.1.198 */}}От v2.1.198 `git commit --amend` когда коммит в HEAD уже был отправлен. Переформулировка только сообщения не блокируется: `--amend -m` без ничего вновь подготовленного, на коммите, который Claude создал во время этого сеанса247* {/* min-version: 2.1.198 */}От v2.1.198 `git commit --amend` когда коммит в HEAD уже был отправлен. Переформулировка только сообщения не блокируется: `--amend -m` без ничего вновь подготовленного, на коммите, который Claude создал во время этого сеанса

241* `terraform destroy`, `pulumi destroy`, `cdk destroy` или `terragrunt destroy`, и применение плана, который уничтожает ресурсы248* `terraform destroy`, `pulumi destroy`, `cdk destroy` или `terragrunt destroy`, и применение плана, который уничтожает ресурсы

242 249 

243Claude Code v2.1.195 и позже блокируют больше категорий по умолчанию. Несколько зависят от записей [environment](/ru/auto-mode-config#define-trusted-infrastructure), таких как чувствительные удалённые цели и защищённые области IaC, которые вы можете сузить до конкретных имён.250Claude Code v2.1.195 и позже блокируют больше категорий по умолчанию. Несколько зависят от записей [environment](/ru/auto-mode-config#define-trusted-infrastructure), таких как чувствительные удалённые цели и защищённые области IaC, которые вы можете сузить до конкретных имён.


261Claude Code v2.1.198 и позже также блокируют эти действия по умолчанию:268Claude Code v2.1.198 и позже также блокируют эти действия по умолчанию:

262 269 

263* Удаление файлов в `/tmp`, `$TMPDIR` или другом общем каталоге scratch или cache по подстановочному знаку, glob или фильтру возраста, а не по конкретному названному пути270* Удаление файлов в `/tmp`, `$TMPDIR` или другом общем каталоге scratch или cache по подстановочному знаку, glob или фильтру возраста, а не по конкретному названному пути

264* Включение чувствительных деталей в содержимое, отправленное, загруженное, опубликованное или написанное другим людям или общим системам, когда ваше собственное сообщение не авторизовало эти детали для этого получателя271* Включение чувствительных деталей в содержимое, отправленное, загруженное, опубликованное или написанное другим людям или общим системам, когда ваше собственное сообщение не авторизовало эти детали для этого получателя. {/* min-version: 2.1.200 */}Тела PR и issue, сообщения коммитов и комментарии считаются этим типом исходящего содержимого, когда репозиторий находится вне границы доверия или является общедоступным, включая собственные общедоступные репозитории вашей организации; внутренние пути файлов, кодовые имена, данные живого ответа API, такие как адреса электронной почты или идентификаторы учётных записей, и идентификаторы инфраструктуры считаются чувствительными деталями. Область действия PR, issue и сообщения коммита требует Claude Code v2.1.200 или позже. {/* min-version: 2.1.203 */}Живые личные данные из ответа API в теле PR или issue, такие как адрес электронной почты, идентификатор учётной записи или организации, или метрика использования, требуют, чтобы вы назвали эти детали и получателя независимо от видимости репозитория или границы доверия. Эта проверка требует Claude Code v2.1.203 или позже

265* Отправка нажатий клавиш в собственную tmux pane Claude Code для управления его собственным интерфейсом, что классификатор рассматривает как Claude изменяющий свои собственные разрешения или надзор272* Отправка нажатий клавиш в собственную tmux pane Claude Code для управления его собственным интерфейсом, что классификатор рассматривает как Claude изменяющий свои собственные разрешения или надзор

266 273 

274Claude Code v2.1.200 и позже также блокируют эти действия по умолчанию:

275 

276* Комментирование, удаление или принудительное прохождение теста или утверждения, которое защищает поведение безопасности, такое как аутентификация, контроль доступа, валидация входных данных или песочница

277* Удаление или разборка ресурса с состоянием, который Claude не создал в сеансе, когда не применяется более конкретное правило удаления и вы не назвали этот ресурс

278* Переориентация базового URL API, конечной точки прокси, получателя webhook или зеркала реестра на хост третьей стороны, который не соответствует задаче, включая в файлы примеров, такие как `.env.example`

279* Изменение того, куда идут отправки, с помощью `git remote set-url` или `git remote add`, если вы не назвали новый удалённый репозиторий

280* Отправка секретов или личных или доверенных данных в репозиторий, известный как общедоступный, или отправка туда конфиденциального материала, который не является частью собственной работы этого репозитория. {/* min-version: 2.1.203 */}Собственный предмет репозитория dotfiles — единственное исключение для личных или доверенных данных, и содержимое из приватного репозитория, достигающее любой общедоступной поверхности, блокируется таким же образом; оба уточнения требуют Claude Code v2.1.203 или позже. До v2.1.203 личные данные были сгруппированы с конфиденциальным материалом и блокировались только когда они не были частью собственной работы этого репозитория. Когда видимость репозитория не установлена, классификатор не блокирует только на этом основании; вместо этого он судит содержимое по другим правилам

281* Открытие pull request против другого репозитория или организации, форк с помощью `gh repo fork` или отправка в репозиторий третьей стороны, если вы не назвали эту внешнюю цель

282 

283Claude Code v2.1.203 и позже также блокируют эти действия по умолчанию:

284 

285* Содержимое из чувствительного локального хранилища или из файла, имя, путь или тип которого отмечает его как чувствительный, входящее в коммит, отправку, текст PR или issue, gist или paste, или публикацию пакета, если вы не назвали как источник, так и назначение. Стенограммы сеансов и журналы разговоров, папки конфигурации и учётных данных, такие как ключи SSH, облачные учётные данные, профили браузера и история оболочки, и экспорты пользовательских данных, все считаются, и приватность репозитория это не очищает

286 

287Claude Code v2.1.205 и позже также блокируют эти действия по умолчанию:

288 

289* Запись в стенограммы сеансов Claude Code, файлы истории `.jsonl` в `~/.claude/projects/` или в ваш настроенный каталог конфигурации, прямо или через команду оболочки. Правило также охватывает строки метаданных, которые Claude Code добавляет к каждой записи стенограммы для своих собственных проверок. Стенограмма — это состояние сеанса, которое Claude Code записывает, а не рабочий файл, и повреждённая запись достигает каждой более поздней проверки после возобновления сеанса, поэтому режим auto блокирует эти записи как защита в глубину. Чтение стенограммы не блокируется

290* Рекурсивное принудительное удаление, такое как `rm -rf "$VAR"` или `Remove-Item -Recurse -Force $dir`, чей целевой объект — переменная оболочки, или glob с корнем в одной, которая не назначена нигде в разговоре, который видит классификатор. Значение поступило только из более ранних выходных данных команды, которые классификатор никогда не получает, поэтому классификатор не может проверить целевой объект удаления по другим правилам удаления. Классификатор читает разговор, а не выходные данные команды по замыслу, поэтому он блокирует вызов вместо угадывания целевого объекта. Блокировка очищается, когда вы называете точный удаляемый путь, или когда Claude повторно запускает удаление с разрешённым буквальным путём, написанным в команду. Удаления, чей целевой объект классификатор может разрешить, не затронуты

291 

267**Разрешается по умолчанию**:292**Разрешается по умолчанию**:

268 293 

269* Локальные операции с файлами в вашем рабочем каталоге294* Локальные операции с файлами в вашем рабочем каталоге

permissions.md +28 −4

Details

47Claude Code поддерживает несколько режимов разрешений, которые контролируют, как он одобряет вызовы инструментов. См. [Permission modes](/ru/permission-modes) для определения того, когда использовать каждый из них. Установите `defaultMode` в ваших [файлах параметров](/ru/settings#settings-files):47Claude Code поддерживает несколько режимов разрешений, которые контролируют, как он одобряет вызовы инструментов. См. [Permission modes](/ru/permission-modes) для определения того, когда использовать каждый из них. Установите `defaultMode` в ваших [файлах параметров](/ru/settings#settings-files):

48 48 

49| Режим | Описание |49| Режим | Описание |

50| :------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |50| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

51| `default` | Стандартное поведение: запрашивает разрешение при первом использовании каждого инструмента |51| `default` | Стандартное поведение: запрашивает разрешение при первом использовании каждого инструмента. {/* min-version: 2.1.200 */}В CLI и расширениях VS Code и JetBrains обозначается как Manual, и Claude Code принимает `manual` как псевдоним. Метка и псевдоним требуют Claude Code v2.1.200 или более поздней версии |

52| `acceptEdits` | Автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch`, `mv` и `cp` для путей в рабочем каталоге или `additionalDirectories` |52| `acceptEdits` | Автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch`, `mv` и `cp` для путей в рабочем каталоге или `additionalDirectories` |

53| `plan` | Plan Mode: Claude читает файлы и запускает команды оболочки только для чтения для исследования, но не редактирует ваши исходные файлы |53| `plan` | Claude читает файлы и запускает команды оболочки только для чтения для исследования, но не редактирует ваши исходные файлы. Обозначается как Plan в CLI и расширении VS Code |

54| `auto` | Автоматически одобряет вызовы инструментов с проверками безопасности в фоне, которые проверяют, соответствуют ли действия вашему запросу. В настоящее время исследовательский предпросмотр |54| `auto` | Автоматически одобряет вызовы инструментов с проверками безопасности в фоне, которые проверяют, соответствуют ли действия вашему запросу. В настоящее время исследовательский предпросмотр |

55| `dontAsk` | Автоматически отклоняет инструменты, если они не предварительно одобрены через `/permissions` или правила `permissions.allow` |55| `dontAsk` | Автоматически отклоняет инструменты, если они не предварительно одобрены через `/permissions` или правила `permissions.allow` |

56| `bypassPermissions` | Пропускает запросы разрешений, за исключением тех, которые вынуждены явными правилами `ask`. Удаления корневого каталога и домашнего каталога, такие как `rm -rf /`, также по-прежнему запрашивают подтверждение в качестве защиты от ошибок модели |56| `bypassPermissions` | Пропускает запросы разрешений, за исключением тех, которые вынуждены явными правилами `ask`. Удаления корневого каталога и домашнего каталога, такие как `rm -rf /`, также по-прежнему запрашивают подтверждение в качестве защиты от ошибок модели |


215 215 

216Неквотированные glob-шаблоны разрешены для команд, у которых каждый флаг только для чтения, поэтому `ls *.ts` и `wc -l src/*.py` запускаются без запроса. Команды с флагами, способными к записи или выполнению, такие как `find`, `sort`, `sed` и `git`, по-прежнему запрашивают, когда присутствует неквотированный glob, потому что glob может расширяться до флага, такого как `-delete`.216Неквотированные glob-шаблоны разрешены для команд, у которых каждый флаг только для чтения, поэтому `ls *.ts` и `wc -l src/*.py` запускаются без запроса. Команды с флагами, способными к записи или выполнению, такие как `find`, `sort`, `sed` и `git`, по-прежнему запрашивают, когда присутствует неквотированный glob, потому что glob может расширяться до флага, такого как `-delete`.

217 217 

218`cd` в путь внутри вашего рабочего каталога или [дополнительного каталога](#working-directories) также только для чтения. Составная команда, такая как `cd packages/api && ls`, запускается без запроса, когда каждая часть квалифицируется самостоятельно. Объединение `cd` с `git` в одну составную команду всегда запрашивает, независимо от целевого каталога.218`cd` в путь внутри вашего рабочего каталога или [дополнительного каталога](#working-directories) также только для чтения. Составная команда, такая как `cd packages/api && ls`, запускается без запроса, когда каждая часть квалифицируется самостоятельно. Объединение `cd` с `git` в одну составную команду запрашивает, когда `cd` переходит в другой каталог, так как запуск `git` в новом каталоге может выполнить hooks этого каталога. `cd`, целевой путь которого разрешается в текущий рабочий каталог, является no-op и не вызывает этот запрос.

219 219 

220<Warning>220<Warning>

221 Шаблоны разрешений Bash, которые пытаются ограничить аргументы команды, хрупкие. Например, `Bash(curl http://github.com/ *)` предназначен для ограничения curl на URL-адреса GitHub, но не будет совпадать с вариациями, такими как:221 Шаблоны разрешений Bash, которые пытаются ограничить аргументы команды, хрупкие. Например, `Bash(curl http://github.com/ *)` предназначен для ограничения curl на URL-адреса GitHub, но не будет совпадать с вариациями, такими как:


505 505 

506Хосты встраивания могут предоставлять дополнительную управляемую политику через опцию SDK `managedSettings` когда [`parentSettingsBehavior`](/ru/settings#settings-precedence) установлен на `"merge"`; значения встраивающей стороны могут ужесточить политику, но не ослабить её.506Хосты встраивания могут предоставлять дополнительную управляемую политику через опцию SDK `managedSettings` когда [`parentSettingsBehavior`](/ru/settings#settings-precedence) установлен на `"merge"`; значения встраивающей стороны могут ужесточить политику, но не ослабить её.

507 507 

508<h2 id="project-allow-rules-and-workspace-trust">

509 Правила разрешений проекта и доверие рабочей области

510</h2>

511 

512Правила `permissions.allow` и записи `permissions.additionalDirectories` в файле `.claude/settings.json` проекта предоставляют возможности, поэтому Claude Code применяет их только после того, как вы примете [диалог доверия рабочей области](/ru/security#additional-safeguards) для этой рабочей области. До этого Claude Code читает правила, но не применяет их. Диалог доверия перечисляет правила разрешений и дополнительные каталоги, которые папка предоставит, чтобы вы могли их проверить перед принятием. Правила `deny` и `ask` не затрагиваются, так как они только ограничивают.

513 

514Claude Code сохраняет доверие для каждой рабочей области, используя в качестве ключа корень репозитория git или, вне репозитория, каталог, из которого вы запустили Claude Code. Когда вы начинаете работу в домашнем каталоге, доверие сохраняется только для текущего сеанса и не записывается на диск; см. примечание [дополнительные меры безопасности](/ru/security#additional-safeguards). Доверие к родительскому каталогу не применяет правила разрешений вложенного проекта.

515 

516`.claude/settings.local.json` — это ваш собственный файл, поэтому проверка доверия рабочей области обычно к нему не применяется. Когда репозиторий мог предоставить файл, например когда он зафиксирован в git или `.claude` является символической ссылкой, его правила разрешений и дополнительные каталоги проходят проверку доверия как параметры проекта.

517 

518Правила разрешений и дополнительные каталоги в `.claude/settings.local.json` также применяются без доверия рабочей области в двух случаях:

519 

520* Каталог, из которого вы запустили Claude Code, находится вне репозитория git.

521* Сеанс выполняется в вашем собственном конфигурационном домашнем каталоге: в вашем домашнем каталоге или в любом каталоге, чей подкаталог `.claude` вы установили как [`CLAUDE_CONFIG_DIR`](/ru/env-vars).

522 

523В обоих случаях файл создан вами, а не репозиторием, и зафиксированный в репозитории `.claude/settings.local.json` по-прежнему требует доверия рабочей области. Версии 2.1.196–2.1.199 рассматривали файл как предоставленный репозиторием в этих рабочих областях, игнорировали его правила разрешений и выводили предупреждение [`this workspace has not been trusted`](/ru/errors#workspace-has-not-been-trusted) в stderr. Два исключения выше соответствуют v2.1.195 и более ранним версиям и были восстановлены в v2.1.200.

524 

525Также начиная с v2.1.200, рабочая область, правила разрешений или дополнительные каталоги которой по-прежнему не применяются, но которая никогда не показывала диалог доверия, потому что родительский каталог уже был доверен, показывает диалог при следующем интерактивном запуске Claude Code там. Диалог предлагает два варианта:

526 

527* **Yes, I trust this folder**: сохраняет доверие для этой рабочей области и применяет правила в том же сеансе.

528* **No, continue without these permissions**: продолжает работу с игнорированием этих правил. Диалог появляется снова в следующем сеансе.

529 

530В [неинтерактивном режиме](/ru/headless) с `-p` диалог не появляется и правила остаются игнорируемыми.

531 

508<h2 id="example-configurations">532<h2 id="example-configurations">

509 Примеры конфигураций533 Примеры конфигураций

510</h2>534</h2>

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) поддерживают Vertex AI и поставщиков шлюза; для Bedrock или Foundry используйте CLI или VS Code, или [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/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 и поставщиков шлюза; для 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

125| `~2.1` | `~3.0` | Установка плагина B завершается с ошибкой `range-conflict`. Плагин A и зависимость остаются как они были. |125| `~2.1` | `~3.0` | Установка плагина B завершается с ошибкой `range-conflict`. Плагин A и зависимость остаются как они были. |

126| `=2.1.0` | none | Зависимость остается на `2.1.0`. Автоматическое обновление пропускает более новые версии, пока установлен плагин A. |126| `=2.1.0` | none | Зависимость остается на `2.1.0`. Автоматическое обновление пропускает более новые версии, пока установлен плагин A. |

127 127 

128Автоматическое обновление получает ограниченную зависимость на самом высоком теге git, который удовлетворяет диапазону каждого установленного плагина, а не на последней версии marketplace, поэтому зависимость продолжает получать обновления в пределах своего допустимого диапазона. Если ни один тег не удовлетворяет всем диапазонам, обновление пропускается и пропуск отображается в `/doctor` и на вкладке Errors в `/plugin`, указывая на ограничивающий плагин.128Автоматическое обновление получает ограниченную зависимость на самом высоком теге git, который удовлетворяет диапазону каждого установленного плагина, а не на последней версии marketplace, поэтому зависимость продолжает получать обновления в пределах своего допустимого диапазона. Если ни один тег не удовлетворяет всем диапазонам, автоматическое обновление пропускает эту зависимость и указывает пропуск на вкладке Errors в `/plugin`, называя ограничивающий плагин.

129 129 

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

131 131 


181 Разрешение ошибок зависимостей181 Разрешение ошибок зависимостей

182</h2>182</h2>

183 183 

184Проблемы с зависимостями появляются в `claude plugin list`, в интерфейсе `/plugin` и в `/doctor`. Затронутый плагин отключается до тех пор, пока вы не разрешите ошибку. Наиболее распространенные ошибки и их исправления перечислены ниже.184Проблемы с зависимостями появляются в `claude plugin list` и в интерфейсе `/plugin`. Claude Code отключает затронутый плагин до тех пор, пока вы не разрешите ошибку. Таблица ниже содержит список наиболее распространенных ошибок и способы их разрешения.

185 185 

186| Ошибка | Значение | Как разрешить |186| Ошибка | Значение | Как разрешить |

187| :------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |187| :------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

Details

170| `plugins` | array | Список доступных плагинов | См. ниже |170| `plugins` | array | Список доступных плагинов | См. ниже |

171 171 

172<Note>172<Note>

173 **Зарезервированные имена**: Следующие имена marketplace зарезервированы для официального использования Anthropic и не могут использоваться сторонними marketplace: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `claude-plugins-community`, `claude-community`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`. Имена, которые выдают себя за официальные marketplace, такие как `official-claude-plugins` или `anthropic-tools-v2`, также заблокированы.173 **Зарезервированные имена**: следующие имена marketplace зарезервированы для официального использования Anthropic и не могут использоваться сторонними marketplace: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `claude-plugins-community`, `claude-community`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins`, `healthcare`. Имена, которые выдают себя за официальные marketplace, такие как `official-claude-plugins` или `anthropic-plugins-v2`, также заблокированы. Резервирование этих имен предотвращает представление стороннего marketplace как источника, опубликованного Anthropic.

174 

175 Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке marketplace, а не только при добавлении. Marketplace, зарегистрированный под одним из этих имен до того, как имя было зарезервировано, перестает загружаться и сообщает, что он [зарегистрирован из ненадежного источника](/ru/errors#marketplace-is-registered-from-an-untrusted-source). Удалите этот marketplace и добавьте его снова из официального источника Anthropic. Сторонний marketplace, затронутый вновь зарезервированным именем, загружается снова, как только вы добавите его под другим именем. До версии v2.1.205 `first-party-plugins` и `healthcare` не были зарезервированы, и marketplace, уже зарегистрированный под зарезервированным именем, продолжал загружаться.

174</Note>176</Note>

175 177 

176<h3 id="owner-fields">178<h3 id="owner-fields">

plugins.md +2 −0

Details

203 203 

204<Warning>204<Warning>

205 **Частая ошибка**: Не помещайте `commands/`, `agents/`, `skills/` или `hooks/` внутри директории `.claude-plugin/`. Только `plugin.json` находится внутри `.claude-plugin/`. Все остальные директории должны быть на уровне корня plugin.205 **Частая ошибка**: Не помещайте `commands/`, `agents/`, `skills/` или `hooks/` внутри директории `.claude-plugin/`. Только `plugin.json` находится внутри `.claude-plugin/`. Все остальные директории должны быть на уровне корня plugin.

206 

207 Корень plugin — это собственная директория отдельного plugin: та, которая содержит `.claude-plugin/plugin.json`. Это никогда не `~/.claude/`. Например, Claude Code не читает `.mcp.json`, размещённый в `~/.claude/.mcp.json`.

206</Warning>208</Warning>

207 209 

208| Директория | Местоположение | Назначение |210| Директория | Местоположение | Назначение |

Details

159* `prompt`: оценка приглашения с помощью LLM (использует заполнитель `$ARGUMENTS` для контекста)159* `prompt`: оценка приглашения с помощью LLM (использует заполнитель `$ARGUMENTS` для контекста)

160* `agent`: запуск проверки агента с инструментами для сложных задач проверки160* `agent`: запуск проверки агента с инструментами для сложных задач проверки

161 161 

162Hooks, которые нацелены на собственный [bundled MCP server](#mcp-servers) плагина, должны использовать его scoped names. Сопоставители инструментов и поля `if` принимают scoped tool name `mcp__plugin_<plugin-name>_<server-name>__<tool>`, а поле `server` hook `mcp_tool` принимает `plugin:<plugin-name>:<server-name>`. Сопоставитель, написанный для простого ключа сервера, никогда не срабатывает. Смотрите [Match MCP tools](/ru/hooks#match-mcp-tools) и [Plugin-provided MCP servers](/ru/mcp#plugin-provided-mcp-servers).

163 

162<h3 id="mcp-servers">164<h3 id="mcp-servers">

163 MCP servers165 MCP servers

164</h3>166</h3>


266| `settings` | Параметры, передаваемые через `workspace/didChangeConfiguration` |268| `settings` | Параметры, передаваемые через `workspace/didChangeConfiguration` |

267| `workspaceFolder` | Путь папки рабочей области для сервера |269| `workspaceFolder` | Путь папки рабочей области для сервера |

268| `startupTimeout` | Максимальное время ожидания запуска сервера (миллисекунды) |270| `startupTimeout` | Максимальное время ожидания запуска сервера (миллисекунды) |

271| `shutdownTimeout` | Максимальное время ожидания корректного завершения (миллисекунды). Когда истекает время ожидания, Claude Code завершает процесс сервера. Если не установлено, время ожидания не применяется |

272| `restartOnCrash` | Следует ли перезапускать сервер после его сбоя. По умолчанию `true`. Установите значение `false`, чтобы оставить сбойный сервер остановленным вместо его перезапуска |

269| `maxRestarts` | Максимальное количество попыток перезапуска перед отказом |273| `maxRestarts` | Максимальное количество попыток перезапуска перед отказом |

270| `diagnostics` | Следует ли отправлять диагностику в контекст Claude после редактирования (по умолчанию `true`). Установите значение `false`, чтобы сохранить навигацию по коду, но подавить автоматическое внедрение диагностики. |274| `diagnostics` | Следует ли отправлять диагностику в контекст Claude после редактирования (по умолчанию `true`). Установите значение `false`, чтобы сохранить навигацию по коду, но подавить автоматическое внедрение диагностики. |

271 275 

276`restartOnCrash` и `shutdownTimeout` требуют Claude Code v2.1.205 или позже. До v2.1.205 схема конфигурации принимала обе опции, но установка любой из них заставляла Claude Code пропустить этот сервер LSP полностью при запуске, причём причина видна только в выводе `claude --debug`.

277 

278**Несколько серверов для одного расширения**: когда более одного включённого сервера LSP объявляет одно и то же расширение файла в `extensionToLanguage`, независимо от того, поступают ли серверы из одного плагина или из разных плагинов, первый зарегистрированный сервер обрабатывает файлы с этим расширением, а остальные никогда не запускаются. Интерфейс `/plugin` показывает предупреждение, называющее плагин, чей сервер активен.

279 

280**Серверы, которые не инициализируются**: Claude Code пропускает сервер, конфигурация которого недействительна, например один, в котором отсутствует `command` или `extensionToLanguage`, и остальные настроенные серверы всё ещё запускаются. Запустите `claude --debug`, чтобы увидеть, почему сервер был пропущен.

281 

282Пропущенный сервер не заявляет свои расширения файлов, поэтому другой действительный сервер, который объявляет то же расширение, из того же или другого плагина, всё ещё обрабатывает эти файлы. До v2.1.205 сервер, который не инициализировался, всё ещё заявлял свои расширения и блокировал другой действительный сервер для того же расширения.

283 

272<Warning>284<Warning>

273 **Вы должны установить двоичный файл языкового сервера отдельно.** Плагины LSP настраивают способ подключения Claude Code к языковому серверу, но они не включают сам сервер. Если вы видите `Executable not found in $PATH` на вкладке Errors в `/plugin`, установите требуемый двоичный файл для вашего языка.285 **Вы должны установить двоичный файл языкового сервера отдельно.** Плагины LSP настраивают способ подключения Claude Code к языковому серверу, но они не включают сам сервер. Если вы видите `Executable not found in $PATH` на вкладке Errors в `/plugin`, установите требуемый двоичный файл для вашего языка.

274</Warning>286</Warning>


635* **Добавляет к по умолчанию**: `skills`. Каталог по умолчанию `skills/` всегда сканируется, и каталоги, перечисленные в `skills`, загружаются вместе с ним. Исключение: для [записи маркетплейса, чей `source` разрешается в корень маркетплейса](/ru/plugin-marketplaces#advanced-plugin-entries), объявление конкретных подкаталогов заменяет сканирование по умолчанию `skills/`647* **Добавляет к по умолчанию**: `skills`. Каталог по умолчанию `skills/` всегда сканируется, и каталоги, перечисленные в `skills`, загружаются вместе с ним. Исключение: для [записи маркетплейса, чей `source` разрешается в корень маркетплейса](/ru/plugin-marketplaces#advanced-plugin-entries), объявление конкретных подкаталогов заменяет сканирование по умолчанию `skills/`

636* **Собственные правила слияния**: [hooks](#hooks), [MCP servers](#mcp-servers) и [LSP servers](#lsp-servers). Смотрите каждый раздел для того, как несколько источников объединяются648* **Собственные правила слияния**: [hooks](#hooks), [MCP servers](#mcp-servers) и [LSP servers](#lsp-servers). Смотрите каждый раздел для того, как несколько источников объединяются

637 649 

638Когда плагин имеет как папку по умолчанию, так и соответствующий ключ манифеста, Claude Code v2.1.140 и более поздние версии отмечают игнорируемую папку в `/doctor`, `claude plugin list` и представлении деталей `/plugin`. Плагин всё ещё загружается с использованием путей манифеста. Предупреждение не показывается, когда ключ манифеста указывает на папку по умолчанию, например `"commands": ["./commands/deploy.md"]`, потому что папка явно адресуется в этом случае.650Когда плагин имеет как папку по умолчанию, так и соответствующий ключ манифеста, Claude Code v2.1.140 и более поздние версии отмечают игнорируемую папку в `claude plugin list` и представлении деталей `/plugin`. Плагин всё ещё загружается с использованием путей манифеста. Предупреждение не показывается, когда ключ манифеста указывает на папку по умолчанию, например `"commands": ["./commands/deploy.md"]`, потому что папка явно адресуется в этом случае.

639 651 

640Для всех полей пути:652Для всех полей пути:

641 653 


673 685 

674**`${CLAUDE_PLUGIN_DATA}`**: постоянный каталог для состояния плагина, который сохраняется при обновлениях. Используйте это для установленных зависимостей, таких как `node_modules` или виртуальные окружения Python, сгенерированный код, кэши и любые другие файлы, которые должны сохраняться между версиями плагина. Каталог создаётся автоматически при первом обращении к этой переменной.686**`${CLAUDE_PLUGIN_DATA}`**: постоянный каталог для состояния плагина, который сохраняется при обновлениях. Используйте это для установленных зависимостей, таких как `node_modules` или виртуальные окружения Python, сгенерированный код, кэши и любые другие файлы, которые должны сохраняться между версиями плагина. Каталог создаётся автоматически при первом обращении к этой переменной.

675 687 

676**`${CLAUDE_PROJECT_DIR}`**: корень проекта. Это тот же каталог, который hooks получают в своей переменной `CLAUDE_PROJECT_DIR`. Используйте это для ссылки на скрипты или файлы конфигурации, локальные для проекта. Оборачивайте в кавычки для обработки путей с пробелами, например `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`. Серверы MCP также могут вызывать запрос MCP `roots/list`, который возвращает каталог, из которого был запущен Claude Code.688**`${CLAUDE_PROJECT_DIR}`**: корень проекта. Это тот же каталог, который hooks получают в своей переменной `CLAUDE_PROJECT_DIR`. Используйте это для ссылки на скрипты или файлы конфигурации, локальные для проекта. Оборачивайте в кавычки для обработки путей с пробелами, например `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`.

689 

690Серверы MCP также могут вызывать запрос `roots/list` для чтения рабочих каталогов сеанса во время выполнения. Смотрите [что возвращает `roots/list` и когда Claude Code уведомляет сервер об изменениях](/ru/mcp#option-3-add-a-local-stdio-server).

677 691 

678```json theme={null}692```json theme={null}

679{693{

Details

50Кэширование происходит на стороне сервера в инфраструктуре, которая обслуживает вашу модель. Где это находится, зависит от того, как вы аутентифицируетесь:50Кэширование происходит на стороне сервера в инфраструктуре, которая обслуживает вашу модель. Где это находится, зависит от того, как вы аутентифицируетесь:

51 51 

52* **API ключ, подписка Claude или [Claude Platform on AWS](/ru/claude-platform-on-aws)**: кэш находится в инфраструктуре Anthropic, доступ через [Claude API](https://platform.claude.com/docs)52* **API ключ, подписка Claude или [Claude Platform on AWS](/ru/claude-platform-on-aws)**: кэш находится в инфраструктуре Anthropic, доступ через [Claude API](https://platform.claude.com/docs)

53* **Bedrock или Vertex AI**: кэш находится в инфраструктуре обслуживания вашего облачного провайдера53* **Amazon Bedrock или Google Cloud's Agent Platform**: кэш находится в инфраструктуре обслуживания вашего облачного провайдера

54* **Foundry**: запросы маршрутизируются в инфраструктуру Anthropic54* **Microsoft Foundry**: запросы маршрутизируются в инфраструктуру Anthropic

55* **Пользовательский `ANTHROPIC_BASE_URL` или [LLM gateway](/ru/llm-gateway)**: кэш находится там, где перенаправляются ваши запросы, и работает ли кэширование, зависит от шлюза55* **Пользовательский `ANTHROPIC_BASE_URL` или [LLM gateway](/ru/llm-gateway)**: кэш находится там, где перенаправляются ваши запросы, и работает ли кэширование, зависит от шлюза

56 56 

57Для информации о том, что хранит и обрабатывает каждый провайдер, см. [использование данных](/ru/data-usage). Где бы ни находился кэш, записи истекают после периода неактивности, и [Время жизни кэша](#cache-lifetime) ниже охватывает TTL и как его продлить.57Для информации о том, что хранит и обрабатывает каждый провайдер, см. [использование данных](/ru/data-usage). Где бы ни находился кэш, записи истекают после периода неактивности, и [Время жизни кэша](#cache-lifetime) ниже охватывает TTL и как его продлить.


106Определения инструментов находятся в слое системного запроса, поэтому кэш инвалидируется, когда набор определений инструментов в запросе изменяется между ходами. Переключение [инструмента advisor](/ru/advisor) является исключением: его определение находится после точки разрыва кэша, поэтому включение или отключение `/advisor` сохраняет кэшированный префикс нетронутым. Зависит ли [изменение MCP сервера](/ru/mcp) от этого, зависит от того, отложены ли его инструменты [поиском инструментов](/ru/mcp#scale-with-mcp-tool-search) или загружены в префикс:106Определения инструментов находятся в слое системного запроса, поэтому кэш инвалидируется, когда набор определений инструментов в запросе изменяется между ходами. Переключение [инструмента advisor](/ru/advisor) является исключением: его определение находится после точки разрыва кэша, поэтому включение или отключение `/advisor` сохраняет кэшированный префикс нетронутым. Зависит ли [изменение MCP сервера](/ru/mcp) от этого, зависит от того, отложены ли его инструменты [поиском инструментов](/ru/mcp#scale-with-mcp-tool-search) или загружены в префикс:

107 107 

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

109* **Инструменты, загруженные в префикс**: любое изменение их инвалидирует кэш. Это происходит, когда [поиск инструментов недоступен или отключен](/ru/mcp#configure-tool-search), например на моделях Haiku, на Vertex AI или с пользовательским шлюзом `ANTHROPIC_BASE_URL`. Это также происходит для сервера или инструмента, отмеченного [`alwaysLoad`](/ru/mcp#exempt-a-server-from-deferral), и для определений, сохраняемых впереди [загрузкой на основе порога](/ru/mcp#configure-tool-search).109* **Инструменты, загруженные в префикс**: любое изменение их инвалидирует кэш. Это происходит, когда [поиск инструментов недоступен или отключен](/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).

110 110 

111Когда инструменты загружаются в префикс, наиболее частая причина инвалидации — это подключение или отключение сервера в середине сеанса, что может произойти без каких-либо действий с вашей стороны: процесс stdio сервера выходит, сеанс HTTP истекает, или сервер [автоматически переподключается после временного сбоя](/ru/mcp#automatic-reconnection). Подключённый сервер также может отправить [динамическое обновление инструмента](/ru/mcp#dynamic-tool-updates), которое изменяет его список инструментов.111Когда инструменты загружаются в префикс, наиболее частая причина инвалидации — это подключение или отключение сервера в середине сеанса, что может произойти без каких-либо действий с вашей стороны: процесс stdio сервера выходит, сеанс HTTP истекает, или сервер [автоматически переподключается после временного сбоя](/ru/mcp#automatic-reconnection). Подключённый сервер также может отправить [динамическое обновление инструмента](/ru/mcp#dynamic-tool-updates), которое изменяет его список инструментов.

112 112 


235 На API ключе или стороннем провайдере235 На API ключе или стороннем провайдере

236</h3>236</h3>

237 237 

238На API ключе, Bedrock, Vertex, Foundry или Claude Platform on AWS, вы платите по ставкам за токен, поэтому TTL остаётся по умолчанию дешевле пять минут. Чтобы выбрать [одночасовой TTL](https://platform.claude.com/docs/ru/build-with-claude/prompt-caching#1-hour-cache-duration), установите `ENABLE_PROMPT_CACHING_1H=1`.238На API ключе, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform on AWS, вы платите по ставкам за токен, поэтому TTL остаётся по умолчанию дешевле пять минут. Чтобы выбрать [одночасовой TTL](https://platform.claude.com/docs/ru/build-with-claude/prompt-caching#1-hour-cache-duration), установите `ENABLE_PROMPT_CACHING_1H=1`.

239 239 

240На Bedrock, поддержка prompt caching, минимальная длина кэшируемого префикса и доступность одночасового TTL варьируются по модели. Если счётчики токенов кэша остаются на нуле, проверьте [поддерживаемые модели, регионы и лимиты](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) в документации Bedrock.240На Amazon Bedrock, поддержка prompt caching, минимальная длина кэшируемого префикса и доступность одночасового TTL варьируются по модели. Если счётчики токенов кэша остаются на нуле, проверьте [поддерживаемые модели, регионы и лимиты](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) в документации Amazon Bedrock.

241 241 

242<h3 id="override-the-ttl">242<h3 id="override-the-ttl">

243 Переопределить TTL243 Переопределить TTL

quickstart.md +1 −1

Details

105 105 

106* [Claude Pro, Max, Team или Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (рекомендуется)106* [Claude Pro, Max, Team или Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (рекомендуется)

107* [Claude Console](https://console.anthropic.com/) (доступ к API с предоплаченными кредитами). При первом входе рабочее пространство "Claude Code" автоматически создаётся в Console для централизованного отслеживания затрат.107* [Claude Console](https://console.anthropic.com/) (доступ к API с предоплаченными кредитами). При первом входе рабочее пространство "Claude Code" автоматически создаётся в Console для централизованного отслеживания затрат.

108* [Amazon Bedrock, Google Vertex AI или Microsoft Foundry](/ru/third-party-integrations) (облачные провайдеры для предприятий)108* [Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](/ru/third-party-integrations) (облачные провайдеры для предприятий)

109* Самостоятельно размещённый [шлюз приложений Claude](/ru/claude-apps-gateway), если ваша организация его использует: ваш администратор предварительно настраивает URL шлюза, и `/login` открывает экран **Cloud gateway** для входа с корпоративным SSO109* Самостоятельно размещённый [шлюз приложений Claude](/ru/claude-apps-gateway), если ваша организация его использует: ваш администратор предварительно настраивает URL шлюза, и `/login` открывает экран **Cloud gateway** для входа с корпоративным SSO

110 110 

111После входа ваши учётные данные сохраняются, и вам не нужно будет входить снова.111После входа ваши учётные данные сохраняются, и вам не нужно будет входить снова.

Details

16 16 

17* **Использовать полную локальную среду удалённо**: ваша файловая система, [MCP servers](/ru/mcp), инструменты и конфигурация проекта остаются доступными, и ввод `@` автоматически дополняет пути файлов из вашего локального проекта17* **Использовать полную локальную среду удалённо**: ваша файловая система, [MCP servers](/ru/mcp), инструменты и конфигурация проекта остаются доступными, и ввод `@` автоматически дополняет пути файлов из вашего локального проекта

18* **Работать с обеих поверхностей одновременно**: беседа остаётся синхронизированной на всех подключённых устройствах, поэтому вы можете отправлять сообщения из терминала, браузера и телефона взаимозаменяемо18* **Работать с обеих поверхностей одновременно**: беседа остаётся синхронизированной на всех подключённых устройствах, поэтому вы можете отправлять сообщения из терминала, браузера и телефона взаимозаменяемо

19* **Отправлять изображения и файлы со своего телефона или браузера**: когда вы добавляете вложение в приложение Claude или на claude.ai/code, Claude Code загружает его на ваш компьютер и передаёт его Claude как ссылку на файл `@`, с подписью или без неё. {/* min-version: 2.1.202 */}До версии 2.1.202 Claude Code мог удалить вложение, отправленное без подписи, прежде чем оно достигло сеанса.

19* **Пережить перебои**: если ваш ноутбук перейдёт в режим сна или сетевое соединение разорвётся, сеанс автоматически переподключится, когда ваш компьютер вернётся в сеть20* **Пережить перебои**: если ваш ноутбук перейдёт в режим сна или сетевое соединение разорвётся, сеанс автоматически переподключится, когда ваш компьютер вернётся в сеть

20 21 

21В отличие от [Claude Code в веб-версии](/ru/claude-code-on-the-web), которая работает на облачной инфраструктуре, сеансы Remote Control работают непосредственно на вашем компьютере и взаимодействуют с вашей локальной файловой системой. Веб- и мобильные интерфейсы — это просто окно в этот локальный сеанс.22В отличие от [Claude Code в веб-версии](/ru/claude-code-on-the-web), которая работает на облачной инфраструктуре, сеансы Remote Control работают непосредственно на вашем компьютере и взаимодействуют с вашей локальной файловой системой. Веб- и мобильные интерфейсы — это просто окно в этот локальный сеанс.


34 35 

35* **Подписка**: доступна на планах Pro, Max, Team и Enterprise. API ключи не поддерживаются. На планах Team и Enterprise владелец должен сначала включить переключатель Remote Control в [параметрах администратора Claude Code](https://claude.ai/admin-settings/claude-code).36* **Подписка**: доступна на планах Pro, Max, Team и Enterprise. API ключи не поддерживаются. На планах Team и Enterprise владелец должен сначала включить переключатель Remote Control в [параметрах администратора Claude Code](https://claude.ai/admin-settings/claude-code).

36* **Аутентификация**: запустите `claude` и используйте `/login` для входа через claude.ai, если вы ещё этого не сделали.37* **Аутентификация**: запустите `claude` и используйте `/login` для входа через claude.ai, если вы ещё этого не сделали.

37* **Конечная точка API**: недоступна на Amazon Bedrock, Google Vertex AI или Microsoft Foundry. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, Remote Control также отключен, когда [`ANTHROPIC_BASE_URL`](/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, например на [LLM gateway](/ru/llm-gateway) или прокси. Отключите переменную, чтобы использовать Remote Control.38* **Конечная точка API**: недоступна на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, Remote Control также отключен, когда [`ANTHROPIC_BASE_URL`](/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, например на [LLM gateway](/ru/llm-gateway) или прокси. Отключите переменную, чтобы использовать Remote Control.

38* **Доверие рабочей области**: запустите `claude` в каталоге вашего проекта хотя бы один раз, чтобы принять диалог доверия рабочей области.39* **Доверие рабочей области**: запустите `claude` в каталоге вашего проекта хотя бы один раз, чтобы принять диалог доверия рабочей области.

39 40 

40<h2 id="start-a-remote-control-session">41<h2 id="start-a-remote-control-session">


59 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |60 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

60 | `--name "My Project"` | Установите пользовательское название сеанса, видимое в списке сеансов на claude.ai/code. |61 | `--name "My Project"` | Установите пользовательское название сеанса, видимое в списке сеансов на claude.ai/code. |

61 | `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически сгенерированных названий сеансов, когда явное имя не установлено. По умолчанию используется имя хоста вашего компьютера, создавая названия вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта. |62 | `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически сгенерированных названий сеансов, когда явное имя не установлено. По умолчанию используется имя хоста вашего компьютера, создавая названия вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта. |

63 | `-c`, `--continue` | {/* min-version: 2.1.200 */}Возобновите самый последний сеанс Remote Control, запущенный из этого каталога, вместо создания нового. Не может быть объединено с `--session-id`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требует Claude Code версии 2.1.200 или позже; более ранние версии отклоняют флаг как неизвестный аргумент. |

64 | `--session-id <id>` | {/* min-version: 2.1.200 */}Возобновите конкретный сеанс Remote Control по его ID. Не может быть объединено с `--continue`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требует Claude Code версии 2.1.200 или позже; более ранние версии отклоняют флаг как неизвестный аргумент. |

62 | `--spawn <mode>` | Как сервер создаёт сеансы.<br />• `same-dir` (по умолчанию): все сеансы используют текущий рабочий каталог, поэтому они могут конфликтовать при редактировании одних и тех же файлов.<br />• `worktree`: каждый сеанс по требованию получает свой собственный [git worktree](/ru/worktrees). Требует репозитория git.<br />• `session`: режим одного сеанса. Обслуживает ровно один сеанс и отклоняет дополнительные подключения. Устанавливается только при запуске.<br />Нажмите `w` во время выполнения, чтобы переключиться между `same-dir` и `worktree`. |65 | `--spawn <mode>` | Как сервер создаёт сеансы.<br />• `same-dir` (по умолчанию): все сеансы используют текущий рабочий каталог, поэтому они могут конфликтовать при редактировании одних и тех же файлов.<br />• `worktree`: каждый сеанс по требованию получает свой собственный [git worktree](/ru/worktrees). Требует репозитория git.<br />• `session`: режим одного сеанса. Обслуживает ровно один сеанс и отклоняет дополнительные подключения. Устанавливается только при запуске.<br />Нажмите `w` во время выполнения, чтобы переключиться между `same-dir` и `worktree`. |

63 | `--capacity <N>` | Максимальное количество одновременных сеансов. По умолчанию 32. Не может использоваться с `--spawn=session`. |66 | `--capacity <N>` | Максимальное количество одновременных сеансов. По умолчанию 32. Не может использоваться с `--spawn=session`. |

67 | `--[no-]create-session-in-dir` | Предварительно создайте один сеанс в текущем каталоге при запуске сервера, чтобы у вас было место для ввода текста сразу же. В режиме `worktree` этот сеанс остаётся в текущем каталоге, а сеансы по требованию получают изолированные worktrees. Включено по умолчанию; передайте `--no-create-session-in-dir`, чтобы начать без них. |

64 | `--verbose` | Показать подробные журналы подключения и сеанса. |68 | `--verbose` | Показать подробные журналы подключения и сеанса. |

65 | `--sandbox` / `--no-sandbox` | Включить или отключить [sandboxing](/ru/sandboxing) для изоляции файловой системы и сети. Отключено по умолчанию. |69 | `--sandbox` / `--no-sandbox` | Включить или отключить [sandboxing](/ru/sandboxing) для изоляции файловой системы и сети. Отключено по умолчанию. |

66 </Tab>70 </Tab>


149 Включение Remote Control для всех сеансов153 Включение Remote Control для всех сеансов

150</h3>154</h3>

151 155 

152Remote Control активируется только при явном запуске `claude remote-control`, `claude --remote-control` или `/remote-control`, если не включена автоподключение. Чтобы включить его автоматически для каждого интерактивного сеанса, запустите `/config` внутри Claude Code и установите **Enable Remote Control for all sessions** на `true`. Установите на `false`, чтобы никогда не автоподключаться, или оставьте без установки, чтобы следовать стандартному значению вашей организации. В приложении Desktop вы также можете переключить это в **Settings → Claude Code → Enable remote control by default**.156Remote Control активируется только при явном запуске `claude remote-control`, `claude --remote-control` или `/remote-control`, если не включена автоподключение. Чтобы включить его автоматически для каждого интерактивного сеанса, запустите `/config` внутри Claude Code и установите **Enable Remote Control for all sessions** на `true`. Установите на `false`, чтобы никогда не автоподключаться, или оставьте без установки, чтобы следовать стандартному значению вашей организации. В приложении Desktop вы также можете переключить это в **Settings → Claude Code → Enable remote control by default**. {/* min-version: 2.1.203 */}В [расширении VS Code](/ru/vs-code#use-the-prompt-box) тот же переключатель появляется как **Enable Remote Control for all sessions** в разделе Settings меню команд; требует Claude Code версии 2.1.203 или позже.

153 157 

154С этой настройкой каждый интерактивный процесс Claude Code регистрирует один удалённый сеанс. Если вы запустите несколько экземпляров, каждый получит свою собственную среду и сеанс. Чтобы запустить несколько одновременных сеансов из одного процесса, используйте [режим сервера](#start-a-remote-control-session) вместо этого.158С этой настройкой каждый интерактивный процесс Claude Code регистрирует один удалённый сеанс. Если вы запустите несколько экземпляров, каждый получит свою собственную среду и сеанс. Чтобы запустить несколько одновременных сеансов из одного процесса, используйте [режим сервера](#start-a-remote-control-session) вместо этого.

155 159 


280* **Локальный процесс должен продолжать работать**: Remote Control работает как локальный процесс. Если вы закроете терминал, выйдете из VS Code или иным образом остановите процесс `claude`, сеанс завершится.284* **Локальный процесс должен продолжать работать**: Remote Control работает как локальный процесс. Если вы закроете терминал, выйдете из VS Code или иным образом остановите процесс `claude`, сеанс завершится.

281* **Продолжительный сбой сети**: если ваш компьютер включен, но не может достичь сеть более чем примерно на 10 минут, сеанс истекает и процесс завершается. Запустите `claude remote-control` снова, чтобы начать новый сеанс.285* **Продолжительный сбой сети**: если ваш компьютер включен, но не может достичь сеть более чем примерно на 10 минут, сеанс истекает и процесс завершается. Запустите `claude remote-control` снова, чтобы начать новый сеанс.

282* **Ultraplan отключает Remote Control**: запуск сеанса [ultraplan](/ru/ultraplan) отключает любой активный сеанс Remote Control, потому что обе функции занимают интерфейс claude.ai/code и одновременно может быть подключена только одна.286* **Ultraplan отключает Remote Control**: запуск сеанса [ultraplan](/ru/ultraplan) отключает любой активный сеанс Remote Control, потому что обе функции занимают интерфейс claude.ai/code и одновременно может быть подключена только одна.

283* **Некоторые команды работают только локально**: команды, которые открывают интерактивный выбор в терминале, такие как `/plugin` или `/resume`, работают только из локального CLI. Следующие команды работают с мобильных устройств и веб-браузеров:287* **Некоторые команды работают только локально**: команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, работают только из локального CLI, независимо от того, передаёте ли вы аргумент или нет. Следующие команды работают с мобильных устройств и веб-браузеров:

284 * Команды с текстовым выводом: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, `/reload-plugins`288 * Команды с текстовым выводом: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, `/reload-plugins`

289 * `/model`, `/effort`, `/fast`, `/color` и `/rename`: передайте значение как аргумент, например `/model sonnet` или `/effort high`. С мобильных устройств и веб-браузеров `/model` и `/effort` принимают аргумент вместо выбора в терминале или ползунка.

285 * {/* min-version: 2.1.166 */}`/mcp`, начиная с версии 2.1.166: возвращает текстовое резюме статуса сервера вместо открытия выбора и принимает подкоманды `reconnect`, `enable` и `disable` [](/ru/commands#all-commands). В отличие от локального CLI, `/mcp reconnect` без имени сервера переподключает каждый сервер, который не работает или требует аутентификации.290 * {/* min-version: 2.1.166 */}`/mcp`, начиная с версии 2.1.166: возвращает текстовое резюме статуса сервера вместо открытия выбора и принимает подкоманды `reconnect`, `enable` и `disable` [](/ru/commands#all-commands). В отличие от локального CLI, `/mcp reconnect` без имени сервера переподключает каждый сервер, который не работает или требует аутентификации.

286 * {/* min-version: 2.1.181 */}`/config`, начиная с версии 2.1.181: передайте `key=value` для установки параметра или запустите её без аргументов, чтобы вывести список ключей, которые вы можете установить.291 * {/* min-version: 2.1.181 */}`/config`, начиная с версии 2.1.181: передайте `key=value` для установки параметра или запустите её без аргументов, чтобы вывести список ключей, которые вы можете установить.

287 292 


323 "Remote Control is only available when using Claude via api.anthropic.com"328 "Remote Control is only available when using Claude via api.anthropic.com"

324</h3>329</h3>

325 330 

326Сеанс не взаимодействует с API Anthropic напрямую, поэтому нет бэкенда claude.ai для сопряжения. Это происходит на Amazon Bedrock, Google Vertex AI и Microsoft Foundry. {/* min-version: 2.1.196 */}Начиная с v2.1.196 это также происходит, когда [`ANTHROPIC_BASE_URL`](/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, такой как [LLM gateway](/ru/llm-gateway) или прокси, даже если вы входите с помощью claude.ai. Отключите `ANTHROPIC_BASE_URL` и перезагрузите сеанс для использования Remote Control.331Сеанс не взаимодействует с API Anthropic напрямую, поэтому нет бэкенда claude.ai для сопряжения. Это происходит на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. {/* min-version: 2.1.196 */}Начиная с v2.1.196 это также происходит, когда [`ANTHROPIC_BASE_URL`](/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, такой как [LLM gateway](/ru/llm-gateway) или прокси, даже если вы входите с помощью claude.ai. Отключите `ANTHROPIC_BASE_URL` и перезагрузите сеанс для использования Remote Control.

327 332 

328<h3 id="remote-control-is-disabled-by-your-organization’s-policy">333<h3 id="remote-control-is-disabled-by-your-organization’s-policy">

329 "Remote Control is disabled by your organization's policy"334 "Remote Control is disabled by your organization's policy"


352* Проблема с сетью или прокси: брандмауэр или прокси может блокировать исходящий HTTPS запрос. Remote Control требует доступа к API Anthropic на порту 443.357* Проблема с сетью или прокси: брандмауэр или прокси может блокировать исходящий HTTPS запрос. Remote Control требует доступа к API Anthropic на порту 443.

353* Ошибка создания сеанса: если вы также видите `Session creation failed — see debug log`, ошибка произошла ранее при настройке. Проверьте, что ваша подписка активна.358* Ошибка создания сеанса: если вы также видите `Session creation failed — see debug log`, ошибка произошла ранее при настройке. Проверьте, что ваша подписка активна.

354 359 

360<h3 id="couldn’t-reconnect-to-your-remote-control-session">

361 "Couldn't reconnect to your Remote Control session"

362</h3>

363 

364Когда вы возобновляете разговор с `claude --resume` или `claude --continue`, Claude Code переподключается к сеансу Remote Control, записанному в этом разговоре. Это сообщение означает, что переподключение не удалось по причине, которая может быть временной, такой как сетевой сбой или ошибка сервера, поэтому Claude Code не может подтвердить, существует ли удалённый сеанс. Когда сервер подтверждает, что предыдущий сеанс больше не существует, Claude Code создаёт новый сеанс Remote Control без отображения этого сообщения.

365 

366Ваш локальный сеанс продолжает работать без Remote Control. Запустите `/remote-control` для повторной попытки подключения, или запустите Claude Code без `--resume` для создания нового сеанса Remote Control.

367 

368{/* min-version: 2.1.200 */}До v2.1.200 ошибка переподключения создавала новый сеанс Remote Control вместо отображения этого сообщения, что оставляло дополнительные сеансы в списке сеансов на claude.ai/code.

369 

355<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">370<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">

356 "Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"371 "Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"

357</h3>372</h3>

routines.md +1 −1

Details

416 416 

417CLI скрывает `/schedule`, когда одно из его требований не выполнено, поэтому меню команд показывает `No commands match "/schedule"` во время ввода, а отправка возвращает `Unknown command: /schedule`. Причина обычно одна из следующих:417CLI скрывает `/schedule`, когда одно из его требований не выполнено, поэтому меню команд показывает `No commands match "/schedule"` во время ввода, а отправка возвращает `Unknown command: /schedule`. Причина обычно одна из следующих:

418 418 

419* Вы аутентифицированы с помощью Console API key или облачного провайдера, такого как Bedrock, Vertex или Foundry. `/schedule` требует входа по подписке claude.ai. Если `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN` установлены в вашей оболочке, или `apiKeyHelper` установлен в `settings.json`, удалите их сначала, так как они имеют приоритет над входом claude.ai419* 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`420* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` или `DISABLE_GROWTHBOOK` установлены в переменных окружения вашей оболочки или в блоке `env` файла [`settings.json`](/ru/settings#available-settings). Они отключают получение флагов функций, от которого зависит `/schedule`

421* Вы находитесь в сеансе Claude Code в веб-версии. Управляйте рутинами из [веб-интерфейса](https://claude.ai/code/routines) вместо этого421* Вы находитесь в сеансе Claude Code в веб-версии. Управляйте рутинами из [веб-интерфейса](https://claude.ai/code/routines) вместо этого

422* {/* min-version: 2.1.81 */}Ваш CLI старше версии v2.1.81. Запустите `claude update`422* {/* min-version: 2.1.81 */}Ваш CLI старше версии v2.1.81. Запустите `claude update`

sandboxing.md +1 −1

Details

237 237 

238С `mask` изолированная команда видит значение-дозорное значение для каждого сеанса вместо реального. Когда запрос покидает sandbox для одного из хостов учётных данных `injectHosts`, [прокси sandbox](#network-isolation) заменяет дозорное значение на реальное. Команда и всё, что она логирует, никогда не содержат реальные учётные данные, но её запросы по-прежнему аутентифицируются.238С `mask` изолированная команда видит значение-дозорное значение для каждого сеанса вместо реального. Когда запрос покидает sandbox для одного из хостов учётных данных `injectHosts`, [прокси sandbox](#network-isolation) заменяет дозорное значение на реальное. Команда и всё, что она логирует, никогда не содержат реальные учётные данные, но её запросы по-прежнему аутентифицируются.

239 239 

240Прокси подставляет учётные данные внутри содержимого запроса, поэтому он должен их видеть. Установите [`network.tlsTerminate`](/ru/settings#sandbox-settings) так, чтобы прокси сам завершал HTTPS. Без этого маскирование закрывается неудачей: команда по-прежнему видит только дозорное значение, но дозорное значение достигает сервера без изменений и аутентификация не удаётся. Claude Code сообщает об этой неправильной конфигурации при запуске и в `/doctor`.240Прокси подставляет учётные данные внутри содержимого запроса, поэтому он должен их видеть. Установите [`network.tlsTerminate`](/ru/settings#sandbox-settings) так, чтобы прокси сам завершал TLS. Без этого маскирование закрывается неудачей: команда по-прежнему видит только дозорное значение, но дозорное значение достигает сервера без изменений и аутентификация не удаётся. Claude Code сообщает об этой неправильной конфигурации при запуске.

241 241 

242Пример ниже маскирует два токена. `GH_TOKEN` подставляется только на запросы к `api.github.com`, в то время как `NPM_TOKEN` не имеет `injectHosts` и подставляется на запросы ко всем хостам в `network.allowedDomains`. Каждая запись `injectHosts` сама должна быть охвачена `network.allowedDomains`.242Пример ниже маскирует два токена. `GH_TOKEN` подставляется только на запросы к `api.github.com`, в то время как `NPM_TOKEN` не имеет `injectHosts` и подставляется на запросы ко всем хостам в `network.allowedDomains`. Каждая запись `injectHosts` сама должна быть охвачена `network.allowedDomains`.

243 243 

Details

86Динамически запланированный цикл появляется в вашем [списке запланированных задач](#manage-scheduled-tasks) как любая другая задача, поэтому вы можете перечислить или отменить его таким же образом. [Правила дрожания](#jitter) не применяются к нему, но [истечение через семь дней](#seven-day-expiry) применяется: цикл автоматически заканчивается через семь дней после его запуска.86Динамически запланированный цикл появляется в вашем [списке запланированных задач](#manage-scheduled-tasks) как любая другая задача, поэтому вы можете перечислить или отменить его таким же образом. [Правила дрожания](#jitter) не применяются к нему, но [истечение через семь дней](#seven-day-expiry) применяется: цикл автоматически заканчивается через семь дней после его запуска.

87 87 

88<Note>88<Note>

89 На Bedrock, Vertex AI и Microsoft Foundry подсказка без интервала запускается по фиксированному расписанию в 10 минут вместо этого.89 На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry подсказка без интервала запускается по фиксированному расписанию в 10 минут вместо этого.

90</Note>90</Note>

91 91 

92<h3 id="run-the-built-in-maintenance-prompt">92<h3 id="run-the-built-in-maintenance-prompt">


108Простой `/loop` запускает эту подсказку с [динамически выбранным интервалом](#let-claude-choose-the-interval). Добавьте интервал, например `/loop 15m`, чтобы запустить его по фиксированному расписанию вместо этого. Чтобы заменить встроенную подсказку своей собственной по умолчанию, см. [Настройте подсказку по умолчанию с помощью loop.md](#customize-the-default-prompt-with-loop-md).108Простой `/loop` запускает эту подсказку с [динамически выбранным интервалом](#let-claude-choose-the-interval). Добавьте интервал, например `/loop 15m`, чтобы запустить его по фиксированному расписанию вместо этого. Чтобы заменить встроенную подсказку своей собственной по умолчанию, см. [Настройте подсказку по умолчанию с помощью loop.md](#customize-the-default-prompt-with-loop-md).

109 109 

110<Note>110<Note>

111 На Bedrock, Vertex AI и Microsoft Foundry `/loop` без подсказки выводит сообщение об использовании вместо запуска подсказки обслуживания.111 На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry `/loop` без подсказки выводит сообщение об использовании вместо запуска подсказки обслуживания.

112</Note>112</Note>

113 113 

114<h3 id="customize-the-default-prompt-with-loop-md">114<h3 id="customize-the-default-prompt-with-loop-md">


136Изменения в `loop.md` вступают в силу на следующей итерации, поэтому вы можете уточнить инструкции, пока цикл работает. Когда `loop.md` не существует ни в одном месте, цикл возвращается к встроенной подсказке обслуживания. Держите файл кратким: содержимое, превышающее 25 000 байт, усекается.136Изменения в `loop.md` вступают в силу на следующей итерации, поэтому вы можете уточнить инструкции, пока цикл работает. Когда `loop.md` не существует ни в одном месте, цикл возвращается к встроенной подсказке обслуживания. Держите файл кратким: содержимое, превышающее 25 000 байт, усекается.

137 137 

138<Note>138<Note>

139 На Bedrock, Vertex AI и Microsoft Foundry `loop.md` не читается и `/loop` без подсказки выводит сообщение об использовании вместо этого.139 На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry `loop.md` не читается и `/loop` без подсказки выводит сообщение об использовании вместо этого.

140</Note>140</Note>

141 141 

142<h3 id="stop-a-loop">142<h3 id="stop-a-loop">


145 145 

146Чтобы остановить `/loop` во время ожидания следующей итерации, нажмите `Esc`. Это очищает ожидающее пробуждение, поэтому цикл не срабатывает снова. Задачи, которые вы запланировали, [попросив Claude напрямую](#manage-scheduled-tasks), не затрагиваются `Esc` и остаются на месте до тех пор, пока вы их не удалите.146Чтобы остановить `/loop` во время ожидания следующей итерации, нажмите `Esc`. Это очищает ожидающее пробуждение, поэтому цикл не срабатывает снова. Задачи, которые вы запланировали, [попросив Claude напрямую](#manage-scheduled-tasks), не затрагиваются `Esc` и остаются на месте до тех пор, пока вы их не удалите.

147 147 

148В [режиме самостоятельного темпа](#let-claude-choose-the-interval) Claude также может завершить цикл самостоятельно, не планируя следующее пробуждение после того, как задача будет доказуемо завершена. Циклы по фиксированному интервалу продолжают работать до тех пор, пока вы их не остановите или [не пройдёт семь дней](#seven-day-expiry).148В [режиме самостоятельного темпа](#let-claude-choose-the-interval) Claude также может завершить цикл самостоятельно, как только задача будет завершена. Claude вызывает инструмент [`ScheduleWakeup`](/ru/tools-reference) с `stop: true`, что немедленно отменяет ожидающее пробуждение. Если итерация заканчивается без переплана или остановки, Claude Code планирует одно резервное пробуждение примерно через 20 минут и завершает цикл, когда эта итерация также не переплана. До версии 2.1.202 отсутствие переплана было единственным способом, которым Claude мог завершить цикл самостоятельно.

149 

150Циклы по фиксированному интервалу продолжают работать до тех пор, пока вы их не остановите или [не пройдёт семь дней](#seven-day-expiry).

149 151 

150<h2 id="set-a-one-time-reminder">152<h2 id="set-a-one-time-reminder">

151 Установите одноразовое напоминание153 Установите одноразовое напоминание

Details

219/plugin uninstall security-guidance@claude-plugins-official219/plugin uninstall security-guidance@claude-plugins-official

220```220```

221 221 

222Если плагин был включен через `.claude/settings.json` проекта, отключение его из `/plugin` записывает переопределение в ваш `.claude/settings.local.json` вместо редактирования проверенного файла, поэтому плагин остаётся отключённым для вас, а товарищи по команде не затронуты. Если он был включен через [управляемые параметры](/ru/admin-setup), только администратор может его отключить.222Если плагин был включен через `.claude/settings.json` проекта, отключение его из `/plugin` записывает переопределение в ваш `.claude/settings.local.json` вместо редактирования проверенного файла, поэтому плагин остаётся отключённым для вас, а товарищи по команде не затронуты. {/* min-version: 2.1.203 */}То же диалоговое окно также предлагает удалить плагин для всех, удалив его из общего `.claude/settings.json`; этот вариант требует Claude Code v2.1.203 или более поздней версии. Если он был включен через [управляемые параметры](/ru/admin-setup), только администратор может его отключить.

223 223 

224<h2 id="how-the-plugin-integrates-with-claude-code">224<h2 id="how-the-plugin-integrates-with-claude-code">

225 Как плагин интегрируется с Claude Code225 Как плагин интегрируется с Claude Code

Details

255Параметры, управляемые сервером, недоступны при использовании поставщиков моделей третьих сторон:255Параметры, управляемые сервером, недоступны при использовании поставщиков моделей третьих сторон:

256 256 

257* Amazon Bedrock257* Amazon Bedrock

258* Google Vertex AI258* Google Cloud's Agent Platform

259* Microsoft Foundry259* Microsoft Foundry

260* [Claude Platform on AWS](/ru/claude-platform-on-aws)260* [Claude Platform on AWS](/ru/claude-platform-on-aws)

261* Пользовательские конечные точки API через `ANTHROPIC_BASE_URL` или [LLM gateways](/ru/llm-gateway)261* Пользовательские конечные точки API через `ANTHROPIC_BASE_URL` или [LLM gateways](/ru/llm-gateway)

262 262 

263Для развертываний Bedrock, Vertex AI и Foundry самостоятельно размещаемый [Claude apps gateway](/ru/claude-apps-gateway) обеспечивает эквивалентную доставку удаленных управляемых параметров: клиенты, вошедшие в шлюз, получают управляемые параметры из шлюза вместо `api.anthropic.com`. Семантика отказов отличается при запуске: клиент шлюза, который не может достичь шлюз, завершает работу с ошибкой вместо возврата к кэшированным параметрам, в то время как почасовое фоновое обновление открыто при отказе на обоих каналах.263Для развертываний Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry самостоятельно размещаемый [Claude apps gateway](/ru/claude-apps-gateway) обеспечивает эквивалентную доставку удаленных управляемых параметров: клиенты, вошедшие в шлюз, получают управляемые параметры из шлюза вместо `api.anthropic.com`. Семантика отказов отличается при запуске: клиент шлюза, который не может достичь шлюз, завершает работу с ошибкой вместо возврата к кэшированным параметрам, в то время как почасовое фоновое обновление открыто при отказе на обоих каналах.

264 264 

265<h2 id="audit-logging">265<h2 id="audit-logging">

266 Аудит логирования266 Аудит логирования

settings.md +22 −17

Details

95* **Параметры проекта** сохраняются в каталоге вашего проекта:95* **Параметры проекта** сохраняются в каталоге вашего проекта:

96 * `.claude/settings.json` для параметров, которые проверяются в системе управления версиями и совместно используются с вашей командой96 * `.claude/settings.json` для параметров, которые проверяются в системе управления версиями и совместно используются с вашей командой

97 * `.claude/settings.local.json` для параметров, которые не проверяются, полезны для личных предпочтений и экспериментов. Когда Claude Code создает `.claude/settings.local.json`, он настраивает git на игнорирование файла. Если вы создаете файл самостоятельно, добавьте его в gitignore вручную.97 * `.claude/settings.local.json` для параметров, которые не проверяются, полезны для личных предпочтений и экспериментов. Когда Claude Code создает `.claude/settings.local.json`, он настраивает git на игнорирование файла. Если вы создаете файл самостоятельно, добавьте его в gitignore вручную.

98 

99 Поскольку этот файл принадлежит вам, а не репозиторию, его правила разрешения `allow` вступают в силу без этапа [доверия рабочей области](/ru/permissions#project-allow-rules-and-workspace-trust), который требуют правила разрешения `.claude/settings.json`. Если репозиторий предоставляет файл, например путем его фиксации, доверие рабочей области по-прежнему применяется.

98* **Управляемые параметры**: Для организаций, которым требуется централизованное управление, Claude Code поддерживает несколько механизмов доставки управляемых параметров. Все используют один и тот же формат JSON и не могут быть переопределены параметрами пользователя или проекта:100* **Управляемые параметры**: Для организаций, которым требуется централизованное управление, Claude Code поддерживает несколько механизмов доставки управляемых параметров. Все используют один и тот же формат JSON и не могут быть переопределены параметрами пользователя или проекта:

99 101 

100 * **Параметры, управляемые сервером**: доставляются удаленно при входе либо с серверов Anthropic через консоль администратора claude.ai, либо с самостоятельно размещенного [Claude apps gateway](/ru/claude-apps-gateway). См. [параметры, управляемые сервером](/ru/server-managed-settings).102 * **Параметры, управляемые сервером**: доставляются удаленно при входе либо с серверов Anthropic через консоль администратора claude.ai, либо с самостоятельно размещенного [Claude apps gateway](/ru/claude-apps-gateway). См. [параметры, управляемые сервером](/ru/server-managed-settings).


213`settings.json` поддерживает ряд опций:215`settings.json` поддерживает ряд опций:

214 216 

215| Ключ | Описание | Пример |217| Ключ | Описание | Пример |

216| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ |218| :-------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |

217| `advisorModel` | {/* min-version: 2.1.98 */}Модель для серверного [инструмента advisor](/ru/advisor). Принимает псевдоним модели, такой как `"opus"`, `"sonnet"` или `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+), или полный ID модели. Записывается автоматически при запуске `/advisor`. Отключите, чтобы отключить advisor. Требует Claude Code v2.1.98 или позже | `"opus"` |219| `advisorModel` | {/* min-version: 2.1.98 */}Модель для серверного [инструмента advisor](/ru/advisor). Принимает псевдоним модели, такой как `"opus"`, `"sonnet"` или `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+), или полный ID модели. Записывается автоматически при запуске `/advisor`. Отключите, чтобы отключить advisor. Требует Claude Code v2.1.98 или позже | `"opus"` |

218| `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"` |

219| `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` |


226| `allowManagedPermissionRulesOnly` | (Только управляемые параметры) Предотвратить определение правил разрешений `allow`, `ask` или `deny` в параметрах пользователя и проекта. Применяются только правила в управляемых параметрах. См. [Параметры только для управляемых](/ru/permissions#managed-only-settings) | `true` |228| `allowManagedPermissionRulesOnly` | (Только управляемые параметры) Предотвратить определение правил разрешений `allow`, `ask` или `deny` в параметрах пользователя и проекта. Применяются только правила в управляемых параметрах. См. [Параметры только для управляемых](/ru/permissions#managed-only-settings) | `true` |

227| `alwaysThinkingEnabled` | Включить [расширенное мышление](/ru/model-config#extended-thinking) по умолчанию для всех сеансов. Обычно настраивается через команду `/config` вместо прямого редактирования. Чтобы принудительно отключить мышление независимо от этого параметра, установите [`MAX_THINKING_TOKENS=0`](/ru/env-vars) в `env`, что отключает мышление на Anthropic API, кроме Fable 5, которая не может отключить мышление. На [поставщиках третьих сторон](/ru/third-party-integrations) это опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения все еще могут думать | `true` |229| `alwaysThinkingEnabled` | Включить [расширенное мышление](/ru/model-config#extended-thinking) по умолчанию для всех сеансов. Обычно настраивается через команду `/config` вместо прямого редактирования. Чтобы принудительно отключить мышление независимо от этого параметра, установите [`MAX_THINKING_TOKENS=0`](/ru/env-vars) в `env`, что отключает мышление на Anthropic API, кроме Fable 5, которая не может отключить мышление. На [поставщиках третьих сторон](/ru/third-party-integrations) это опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения все еще могут думать | `true` |

228| `apiKeyHelper` | Пользовательский скрипт, который будет выполнен в системной оболочке (`/bin/sh` на macOS и Linux, `cmd` на Windows), для создания значения аутентификации. Это значение будет отправлено как заголовки `X-Api-Key` и `Authorization: Bearer` для запросов модели. Установите интервал обновления с помощью [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/ru/env-vars) | `/bin/generate_temp_api_key.sh` |230| `apiKeyHelper` | Пользовательский скрипт, который будет выполнен в системной оболочке (`/bin/sh` на macOS и Linux, `cmd` на Windows), для создания значения аутентификации. Это значение будет отправлено как заголовки `X-Api-Key` и `Authorization: Bearer` для запросов модели. Установите интервал обновления с помощью [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/ru/env-vars) | `/bin/generate_temp_api_key.sh` |

231| `askUserQuestionTimeout` | {/* min-version: 2.1.200 */}**По умолчанию**: `"never"`. Время простоя перед тем, как неотвеченный диалог [`AskUserQuestion`](/ru/tools-reference) автоматически продолжится с любыми уже выбранными вами опциями. Принимает `"60s"`, `"5m"`, `"10m"` или `"never"`. По умолчанию вопросы ждут, пока вы на них ответите. Появляется в `/config` как **Question auto-continue timeout**, который записывает этот ключ в параметры пользователя. Не читается из параметров проекта или локальных параметров. Требует Claude Code v2.1.200 или позже | `"5m"` |

229| `attribution` | Настройте атрибуцию для коммитов git и pull requests. См. [Параметры атрибуции](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |232| `attribution` | Настройте атрибуцию для коммитов git и pull requests. См. [Параметры атрибуции](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |

230| `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` |

231| `autoMemoryDirectory` | Пользовательский каталог для хранения [автоматической памяти](/ru/memory#storage-location). Принимает абсолютный путь или путь с префиксом `~/`. Из параметров проекта или локальных параметров это учитывается только после того, как вы примете диалог доверия рабочей области, так как клонированный репозиторий может предоставить этот файл | `"~/my-memory-dir"` |234| `autoMemoryDirectory` | Пользовательский каталог для хранения [автоматической памяти](/ru/memory#storage-location). Принимает абсолютный путь или путь с префиксом `~/`. Из параметров проекта или локальных параметров это учитывается только после того, как вы примете диалог доверия рабочей области, так как клонированный репозиторий может предоставить этот файл | `"~/my-memory-dir"` |


240| `awsCredentialExport` | Пользовательский скрипт, который выводит JSON с учетными данными AWS (см. [расширенная конфигурация учетных данных](/ru/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |243| `awsCredentialExport` | Пользовательский скрипт, который выводит JSON с учетными данными AWS (см. [расширенная конфигурация учетных данных](/ru/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |

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

242| `blockedMarketplaces` | (Только управляемые параметры) Список запретов источников marketplace. Применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, поэтому marketplace, добавленный до установки политики, не может быть использован для получения plugins. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [Управляемые ограничения marketplace](/ru/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |245| `blockedMarketplaces` | (Только управляемые параметры) Список запретов источников marketplace. Применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, поэтому marketplace, добавленный до установки политики, не может быть использован для получения plugins. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [Управляемые ограничения marketplace](/ru/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

246| `browserExternalPageTools` | (Только управляемые параметры) Установите на `"disabled"`, чтобы предотвратить использование Claude инструментов для чтения или действия на внешних страницах в [Browser pane](/ru/desktop#browse-external-sites) приложения desktop. Пользователи по-прежнему могут самостоятельно переходить на внешние сайты, и локальные предпросмотры dev server не затронуты | `"disabled"` |

243| `channelsEnabled` | (Только управляемые параметры) Разрешить [channels](/ru/channels) для организации. На планах Claude.ai Team и Enterprise, channels блокируются, когда это не установлено или `false`. Для учетных записей [Anthropic Console](/ru/authentication#claude-console-authentication), использующих аутентификацию по ключу API, channels разрешены по умолчанию, если только ваша организация не развернула управляемые параметры, в этом случае этот ключ должен быть установлен на `true` | `true` |247| `channelsEnabled` | (Только управляемые параметры) Разрешить [channels](/ru/channels) для организации. На планах Claude.ai Team и Enterprise, channels блокируются, когда это не установлено или `false`. Для учетных записей [Anthropic Console](/ru/authentication#claude-console-authentication), использующих аутентификацию по ключу API, channels разрешены по умолчанию, если только ваша организация не развернула управляемые параметры, в этом случае этот ключ должен быть установлен на `true` | `true` |

244| `claudeMd` | (Только управляемые параметры) Инструкции в стиле CLAUDE.md, внедренные как организационная управляемая память. Учитываются только при установке в управляемых или политических параметрах и игнорируются в параметрах пользователя, проекта и локальных параметрах. См. [организационная CLAUDE.md](/ru/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |248| `claudeMd` | (Только управляемые параметры) Инструкции в стиле CLAUDE.md, внедренные как организационная управляемая память. Учитываются только при установке в управляемых или политических параметрах и игнорируются в параметрах пользователя, проекта и локальных параметрах. См. [организационная CLAUDE.md](/ru/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |

245| `claudeMdExcludes` | Glob шаблоны или абсолютные пути файлов `CLAUDE.md` для пропуска при загрузке [памяти](/ru/memory). Шаблоны соответствуют абсолютным путям файлов. Применяется только к памяти пользователя, проекта и локальной памяти; файлы управляемой политики не могут быть исключены | `["**/vendor/**/CLAUDE.md"]` |249| `claudeMdExcludes` | Glob шаблоны или абсолютные пути файлов `CLAUDE.md` для пропуска при загрузке [памяти](/ru/memory). Шаблоны соответствуют абсолютным путям файлов. Применяется только к памяти пользователя, проекта и локальной памяти; файлы управляемой политики не могут быть исключены | `["**/vendor/**/CLAUDE.md"]` |

246| `cleanupPeriodDays` | **По умолчанию**: `30` дней, минимум `1`. Сеансы, неактивные дольше этого периода, удаляются при запуске. Установка на `0` отклоняется с ошибкой валидации. Также контролирует возрастной порог для автоматического удаления [orphaned subagent worktrees](/ru/worktrees#clean-up-worktrees) при запуске. Чтобы полностью отключить запись стенограмм, установите переменную окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ru/env-vars), или в неинтерактивном режиме (`-p`) используйте флаг `--no-session-persistence` или опцию SDK `persistSession: false`. | `20` |250| `cleanupPeriodDays` | **По умолчанию**: `30` дней, минимум `1`. Claude Code удаляет [файлы сеансов и другие данные приложения](/ru/claude-directory#cleaned-up-automatically) старше этого периода при запуске. Установка `0` отклоняется с ошибкой валидации. Один и тот же возрастной порог применяется к автоматическому удалению [orphaned worktrees](/ru/worktrees#clean-up-worktrees) при запуске. {/* min-version: 2.1.203 */}Если Claude Code не может прочитать или разобрать файл параметров, он приостанавливает очистку удержания и показывает предупреждение в `/status` до тех пор, пока вы не исправите файл, если только [управляемые параметры](/ru/server-managed-settings) не предоставляют `cleanupPeriodDays`, в этом случае очистка выполняется при управляемом значении. До v2.1.203 очистка выполнялась при значении по умолчанию 30 дней в этом состоянии и могла удалить стенограммы, которые более длительный `cleanupPeriodDays` был предназначен для сохранения; файлы новее 30 дней никогда не удалялись. Чтобы полностью отключить запись стенограмм, установите переменную окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ru/env-vars). В неинтерактивном режиме передайте `--no-session-persistence` вместе с `-p` или установите `persistSession: false` в Agent SDK. | `20` |

247| `companyAnnouncements` | Объявление для отображения пользователям при запуске. Если предоставлено несколько объявлений, они будут циклически отображаться случайным образом. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |251| `companyAnnouncements` | Объявление для отображения пользователям при запуске. Если предоставлено несколько объявлений, они будут циклически отображаться случайным образом. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |

248| `defaultShell` | **По умолчанию**: `"bash"`, или `"powershell"` на Windows, когда Bash недоступен. Оболочка по умолчанию для команд `!` в поле ввода. Принимает `"bash"` или `"powershell"`. Установка `"powershell"` направляет интерактивные команды `!` через PowerShell на Windows. Требует `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. См. [Инструмент PowerShell](/ru/tools-reference#powershell-tool) | `"powershell"` |252| `defaultShell` | **По умолчанию**: `"bash"`, или `"powershell"` на Windows, когда Bash недоступен. Оболочка по умолчанию для команд `!` в поле ввода. Принимает `"bash"` или `"powershell"`. Установка `"powershell"` направляет интерактивные команды `!` через PowerShell на Windows. Требует `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. См. [Инструмент PowerShell](/ru/tools-reference#powershell-tool) | `"powershell"` |

249| `deniedMcpServers` | При установке в managed-settings.json, список запретов MCP servers, которые явно заблокированы. Применяется ко всем областям, включая управляемые servers. Список запретов имеет приоритет над списком разрешений. См. [Управляемая конфигурация MCP](/ru/managed-mcp) | `[{ "serverName": "filesystem" }]` |253| `deniedMcpServers` | При установке в managed-settings.json, список запретов MCP servers, которые явно заблокированы. Применяется ко всем областям, включая управляемые servers. Список запретов имеет приоритет над списком разрешений. См. [Управляемая конфигурация MCP](/ru/managed-mcp) | `[{ "serverName": "filesystem" }]` |


251| `disableAllHooks` | Отключить все [hooks](/ru/hooks) и любую пользовательскую [строку состояния](/ru/statusline) | `true` |255| `disableAllHooks` | Отключить все [hooks](/ru/hooks) и любую пользовательскую [строку состояния](/ru/statusline) | `true` |

252| `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` |

253| `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"` |

254| `disableBundledSkills` | Установите на `true`, чтобы отключить [skills](/ru/skills) и workflows, которые поставляются с Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные slash commands, такие как `/init`, остаются доступными для ввода, но скрыты от модели. Skills из plugins, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалентно установке `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` на `1` | `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` |

255| `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` |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` |

256| `disableDeepLinkRegistration` | Установите на `"disable"`, чтобы предотвратить регистрацию Claude Code обработчика протокола `claude-cli://` с операционной системой при запуске. Deep links позволяют внешним инструментам открыть сеанс Claude Code с предварительно заполненным запросом. Полезно в окружениях, где регистрация обработчика протокола ограничена или управляется отдельно | `"disable"` |260| `disableDeepLinkRegistration` | Установите на `"disable"`, чтобы предотвратить регистрацию Claude Code обработчика протокола `claude-cli://` с операционной системой при запуске. Deep links позволяют внешним инструментам открыть сеанс Claude Code с предварительно заполненным запросом. Полезно в окружениях, где регистрация обработчика протокола ограничена или управляется отдельно | `"disable"` |

257| `disabledMcpjsonServers` | Список конкретных MCP servers из файлов `.mcp.json` для отклонения | `["filesystem"]` |261| `disabledMcpjsonServers` | Список конкретных MCP servers из файлов `.mcp.json` для отклонения | `["filesystem"]` |


268| `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"}` |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"}` |

269| `fallbackModel` | Резервная модель(и) для попытки по порядку, когда основная модель перегружена или недоступна. Claude Code переключается на следующую доступную модель в цепи для остальной части хода и показывает уведомление. `"default"` расширяется до модели по умолчанию. Цепи ограничены тремя моделями; дополнительные записи игнорируются. В отличие от большинства параметров массива, этот ключ не объединяется в разных файлах параметров: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь. Флаг [`--fallback-model`](/ru/cli-reference#cli-flags) переопределяет это на один сеанс. См. [Цепи резервных моделей](/ru/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |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"]` |

270| `fastModePerSessionOptIn` | Когда `true`, быстрый режим не сохраняется между сеансами. Каждый сеанс начинается с отключенным быстрым режимом, требуя от пользователей включить его с помощью `/fast`. Предпочтение быстрого режима пользователя по-прежнему сохраняется. См. [Требовать согласие для каждого сеанса](/ru/fast-mode#require-per-session-opt-in) | `true` |274| `fastModePerSessionOptIn` | Когда `true`, быстрый режим не сохраняется между сеансами. Каждый сеанс начинается с отключенным быстрым режимом, требуя от пользователей включить его с помощью `/fast`. Предпочтение быстрого режима пользователя по-прежнему сохраняется. См. [Требовать согласие для каждого сеанса](/ru/fast-mode#require-per-session-opt-in) | `true` |

271| `feedbackSurveyRate` | Вероятность (0–1) того, что [опрос качества сеанса](/ru/data-usage#session-quality-surveys) появится при наличии условий. Установите на `0`, чтобы полностью подавить, или установите [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/ru/env-vars) в `env`. Полезно при использовании Bedrock, Vertex или Foundry, где частота выборки по умолчанию не применяется | `0.05` |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` |

272| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `true`. Снимок файлов перед каждым редактированием, чтобы [`/rewind`](/ru/checkpointing) мог их восстановить. Появляется в `/config` как **Rewind code (checkpoints)**. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/ru/env-vars) в `env` | `false` |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` |

273| `fileSuggestion` | Настройте пользовательский скрипт для автодополнения файлов `@`. См. [Параметры предложения файлов](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |277| `fileSuggestion` | Настройте пользовательский скрипт для автодополнения файлов `@`. См. [Параметры предложения файлов](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |

274| `footerLinksRegexes` | {/* min-version: 2.1.176 */}Отображать дополнительные кликабельные значки в нижнем колонтитуле, когда регулярное выражение совпадает с выводом хода. Каждая запись имеет `pattern`, шаблон `url` с заполняемыми `{name}` плейсхолдерами из именованных групп захвата и необязательный `label`. Читается из параметров пользователя, флага `--settings` и управляемых параметров только. См. [Значки ссылок нижнего колонтитула](#footer-link-badges) для ограничений URL, списка разрешений схемы и лимитов. Требует Claude Code v2.1.176 или позже | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |278| `footerLinksRegexes` | {/* min-version: 2.1.176 */}Отображать дополнительные кликабельные значки в нижнем колонтитуле, когда регулярное выражение совпадает с выводом хода. Каждая запись имеет `pattern`, шаблон `url` с заполняемыми `{name}` плейсхолдерами из именованных групп захвата и необязательный `label`. Читается из параметров пользователя, флага `--settings` и управляемых параметров только. См. [Значки ссылок нижнего колонтитула](#footer-link-badges) для ограничений URL, списка разрешений схемы и лимитов. Требует Claude Code v2.1.176 или позже | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |

275| `forceLoginMethod` | Используйте `claudeai` для ограничения входа учетными записями Claude.ai, `console` для ограничения входа учетными записями Claude Console, или `gateway` для ограничения входа на облачный шлюз; см. [Claude apps gateway](/ru/claude-apps-gateway). Когда установлено в управляемых параметрах, сеансы, аутентифицированные по `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске, так как ни одно значение не может быть удовлетворено без первоначальной OAuth. Сеансы поставщиков третьих сторон, такие как Bedrock, Vertex и Foundry, не блокируются: они аутентифицируются против вашего облачного провайдера, а не Anthropic | `claudeai` |279| `forceLoginMethod` | Используйте `claudeai` для ограничения входа учетными записями Claude.ai, `console` для ограничения входа учетными записями Claude Console, или `gateway` для ограничения входа на облачный шлюз; см. [Claude apps gateway](/ru/claude-apps-gateway). Когда установлено в управляемых параметрах, сеансы, аутентифицированные по `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске, так как ни одно значение не может быть удовлетворено без первоначальной OAuth. Сеансы поставщиков третьих сторон, такие как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, не блокируются: они аутентифицируются против вашего облачного провайдера, а не Anthropic | `claudeai` |

276| `forceLoginGatewayUrl` | Предварительно заполняет и блокирует URL шлюза на экране `/login` Cloud gateway. Либо этот ключ, либо `forceLoginMethod: "gateway"` отображает этот экран; установите оба, чтобы URL был заполнен. Учитывается только на управляемом уровне политики; игнорируется в параметрах пользователя и проекта. См. [Claude apps gateway](/ru/claude-apps-gateway#set-the-gateway-url) | `"https://claude-gateway.example.com"` |280| `forceLoginGatewayUrl` | Предварительно заполняет и блокирует URL шлюза на экране `/login` Cloud gateway. Либо этот ключ, либо `forceLoginMethod: "gateway"` отображает этот экран; установите оба, чтобы URL был заполнен. Учитывается только на управляемом уровне политики; игнорируется в параметрах пользователя и проекта. См. [Claude apps gateway](/ru/claude-apps-gateway#set-the-gateway-url) | `"https://claude-gateway.example.com"` |

277| `forceLoginOrgUUID` | Требовать, чтобы вход принадлежал определенной организации Anthropic. Принимает одну строку UUID, которая также предварительно выбирает эту организацию во время входа, или массив UUID, где любая указанная организация принимается без предварительного выбора. При установке в управляемых параметрах вход не удается, если аутентифицированная учетная запись не принадлежит указанной организации, и сеансы, аутентифицированные по `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске, так как членство в организации не может быть проверено для них. Сеансы поставщиков третьих сторон, такие как Bedrock, Vertex и Foundry, не блокируются: используйте IAM вашего облачного провайдера для ограничения того, какие облачные учетные записи могут быть использованы. Пустой массив не удается закрыто и блокирует вход с сообщением о неправильной конфигурации | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` или `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |281| `forceLoginOrgUUID` | Требовать, чтобы вход принадлежал определенной организации Anthropic. Принимает одну строку UUID, которая также предварительно выбирает эту организацию во время входа, или массив UUID, где любая указанная организация принимается без предварительного выбора. При установке в управляемых параметрах вход не удается, если аутентифицированная учетная запись не принадлежит указанной организации, и сеансы, аутентифицированные по `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске, так как членство в организации не может быть проверено для них. Сеансы поставщиков третьих сторон, такие как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, не блокируются: используйте IAM вашего облачного провайдера для ограничения того, какие облачные учетные записи могут быть использованы. Пустой массив не удается закрыто и блокирует вход с сообщением о неправильной конфигурации | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` или `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |

278| `forceRemoteSettingsRefresh` | (Только управляемые параметры) Блокировать запуск CLI до тех пор, пока удаленные управляемые параметры не будут свежо получены с сервера. Если получение не удается, CLI выходит вместо продолжения с кэшированными или отсутствующими параметрами. Когда не установлено, запуск продолжается без ожидания удаленных параметров. См. [fail-closed enforcement](/ru/server-managed-settings#enforce-fail-closed-startup) | `true` |282| `forceRemoteSettingsRefresh` | (Только управляемые параметры) Блокировать запуск CLI до тех пор, пока удаленные управляемые параметры не будут свежо получены с сервера. Если получение не удается, CLI выходит вместо продолжения с кэшированными или отсутствующими параметрами. Когда не установлено, запуск продолжается без ожидания удаленных параметров. См. [fail-closed enforcement](/ru/server-managed-settings#enforce-fail-closed-startup) | `true` |

279| `gcpAuthRefresh` | Пользовательский скрипт, который обновляет GCP Application Default Credentials при их истечении или невозможности загрузки. См. [расширенная конфигурация учетных данных](/ru/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |283| `gcpAuthRefresh` | Пользовательский скрипт, который обновляет GCP Application Default Credentials при их истечении или невозможности загрузки. См. [расширенная конфигурация учетных данных](/ru/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |

280| `hooks` | Настройте пользовательские команды для запуска при событиях жизненного цикла. См. [документацию hooks](/ru/hooks) для формата | См. [hooks](/ru/hooks) |284| `hooks` | Настройте пользовательские команды для запуска при событиях жизненного цикла. См. [документацию hooks](/ru/hooks) для формата | См. [hooks](/ru/hooks) |


284| `language` | Настройте предпочитаемый язык ответов Claude (например, `"japanese"`, `"spanish"`, `"french"`). Claude будет отвечать на этом языке по умолчанию. Также устанавливает язык [голосового диктанта](/ru/voice-dictation#change-the-dictation-language) и автоматически созданных названий сеансов. {/* min-version: 2.1.176 */}Начиная с v2.1.176, когда не установлено, названия сеансов соответствуют языку вашего разговора | `"japanese"` |288| `language` | Настройте предпочитаемый язык ответов Claude (например, `"japanese"`, `"spanish"`, `"french"`). Claude будет отвечать на этом языке по умолчанию. Также устанавливает язык [голосового диктанта](/ru/voice-dictation#change-the-dictation-language) и автоматически созданных названий сеансов. {/* min-version: 2.1.176 */}Начиная с v2.1.176, когда не установлено, названия сеансов соответствуют языку вашего разговора | `"japanese"` |

285| `minimumVersion` | Предотвратить понижение версии автоматического обновления ниже определенной версии. Переключение с канала `"latest"` на `"stable"` через `/config` предлагает вам остаться на текущей версии или разрешить понижение. Выбор остаться устанавливает это значение. Также полезно в [управляемых параметрах](/ru/permissions#managed-settings) для закрепления организационного минимума. Для жесткого предела, который блокирует запуск целиком, см. `requiredMinimumVersion` | `"2.1.100"` |289| `minimumVersion` | Предотвратить понижение версии автоматического обновления ниже определенной версии. Переключение с канала `"latest"` на `"stable"` через `/config` предлагает вам остаться на текущей версии или разрешить понижение. Выбор остаться устанавливает это значение. Также полезно в [управляемых параметрах](/ru/permissions#managed-settings) для закрепления организационного минимума. Для жесткого предела, который блокирует запуск целиком, см. `requiredMinimumVersion` | `"2.1.100"` |

286| `model` | Переопределить модель по умолчанию для использования в Claude Code. `--model` и [`ANTHROPIC_MODEL`](/ru/model-config#environment-variables) переопределяют это на один сеанс | `"claude-sonnet-5"` |290| `model` | Переопределить модель по умолчанию для использования в Claude Code. `--model` и [`ANTHROPIC_MODEL`](/ru/model-config#environment-variables) переопределяют это на один сеанс | `"claude-sonnet-5"` |

287| `modelOverrides` | Сопоставить ID моделей Anthropic с ID моделей, специфичными для поставщика, такими как ARN профилей вывода Bedrock. Каждая запись средства выбора модели использует свое сопоставленное значение при вызове API поставщика. См. [Переопределить ID моделей для каждой версии](/ru/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |291| `modelOverrides` | Сопоставить ID моделей Anthropic с ID моделей, специфичными для поставщика, такими как ARN профилей вывода Amazon Bedrock. Каждая запись средства выбора модели использует свое сопоставленное значение при вызове API поставщика. См. [Переопределить ID моделей для каждой версии](/ru/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |

288| `otelHeadersHelper` | Скрипт для создания динамических заголовков OpenTelemetry. Запускается при запуске и периодически. Установите интервал обновления с помощью [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/ru/env-vars). См. [Динамические заголовки](/ru/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |292| `otelHeadersHelper` | Скрипт для создания динамических заголовков OpenTelemetry. Запускается при запуске и периодически. Установите интервал обновления с помощью [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/ru/env-vars). См. [Динамические заголовки](/ru/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |

289| `outputStyle` | Настройте стиль вывода для корректировки системного запроса. См. [документацию стилей вывода](/ru/output-styles) | `"Explanatory"` |293| `outputStyle` | Настройте стиль вывода для корректировки системного запроса. См. [документацию стилей вывода](/ru/output-styles) | `"Explanatory"` |

290| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Только управляемые параметры) **По умолчанию**: `"first-wins"`. Контролирует, применяются ли управляемые параметры, предоставленные программно процессом хоста встраивания, таким как Agent SDK или расширение IDE, когда также присутствует развернутый администратором управляемый уровень. `"first-wins"`: параметры, предоставленные родителем, отбрасываются и применяется только уровень администратора. `"merge"`: параметры, предоставленные родителем, применяются под уровнем администратора, отфильтрованные так, чтобы они могли ужесточить политику, но не ослабить ее. Не имеет эффекта, когда развернут администратором уровень. Требует Claude Code v2.1.133 или позже | `"merge"` |294| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Только управляемые параметры) **По умолчанию**: `"first-wins"`. Контролирует, применяются ли управляемые параметры, предоставленные программно процессом хоста встраивания, таким как Agent SDK или расширение IDE, когда также присутствует развернутый администратором управляемый уровень. `"first-wins"`: параметры, предоставленные родителем, отбрасываются и применяется только уровень администратора. `"merge"`: параметры, предоставленные родителем, применяются под уровнем администратора, отфильтрованные так, чтобы они могли ужесточить политику, но не ослабить ее. Не имеет эффекта, когда развернут администратором уровень. Требует Claude Code v2.1.133 или позже | `"merge"` |


304| `showClearContextOnPlanAccept` | **По умолчанию**: `false`. Показать опцию "очистить контекст" на экране принятия плана. Установите на `true`, чтобы восстановить опцию | `true` |308| `showClearContextOnPlanAccept` | **По умолчанию**: `false`. Показать опцию "очистить контекст" на экране принятия плана. Установите на `true`, чтобы восстановить опцию | `true` |

305| `showThinkingSummaries` | **По умолчанию**: `false`. Показать [расширенное мышление](/ru/model-config#extended-thinking) резюме в интерактивных сеансах. Когда не установлено или `false`, блоки мышления редактируются API и показываются как свернутая заглушка. Редактирование изменяет только то, что вы видите, а не то, что генерирует модель: чтобы снизить расходы на мышление, [снизьте бюджет или отключите мышление](/ru/model-config#extended-thinking) вместо этого. Этот параметр не имеет эффекта в неинтерактивном режиме (`-p`), Agent SDK или расширениях IDE, таких как VS Code | `true` |309| `showThinkingSummaries` | **По умолчанию**: `false`. Показать [расширенное мышление](/ru/model-config#extended-thinking) резюме в интерактивных сеансах. Когда не установлено или `false`, блоки мышления редактируются API и показываются как свернутая заглушка. Редактирование изменяет только то, что вы видите, а не то, что генерирует модель: чтобы снизить расходы на мышление, [снизьте бюджет или отключите мышление](/ru/model-config#extended-thinking) вместо этого. Этот параметр не имеет эффекта в неинтерактивном режиме (`-p`), Agent SDK или расширениях IDE, таких как VS Code | `true` |

306| `showTurnDuration` | **По умолчанию**: `true`. Показывать сообщения о продолжительности хода после ответов, например "Cooked for 1m 6s". Появляется в `/config` как **Show turn duration** | `false` |310| `showTurnDuration` | **По умолчанию**: `true`. Показывать сообщения о продолжительности хода после ответов, например "Cooked for 1m 6s". Появляется в `/config` как **Show turn duration** | `false` |

307| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}**По умолчанию**: `0.01` (1%). Доля окна контекста модели, зарезервированная для [списка skills](/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Когда список превышает бюджет, описания для наименее используемых skills сворачиваются до простых имен, чтобы Claude все еще мог их вызывать, но не видел бы, почему. Увеличьте, чтобы сохранить больше описаний видимыми за счет большего контекста за ход. `/doctor` показывает текущее количество усечений и какие skills затронуты. Требует Claude Code v2.1.105 или позже | `0.02` |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` |

308| `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` |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` |

309| `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"}` |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"}` |

310| `skipWebFetchPreflight` | Пропустить [проверку безопасности домена WebFetch](/ru/data-usage#webfetch-domain-safety-check), которая отправляет каждое запрашиваемое имя хоста на `api.anthropic.com` перед выборкой. Установите на `true` в окружениях, которые блокируют трафик к Anthropic, таких как развертывания Bedrock, Vertex AI или Foundry с ограничивающим исходящим трафиком. При пропуске WebFetch пытается любой URL без консультации со списком блокировок | `true` |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` |

311| `spinnerTipsEnabled` | **По умолчанию**: `true`. Показывать советы в спиннере, пока Claude работает. Установите на `false`, чтобы отключить советы | `false` |315| `spinnerTipsEnabled` | **По умолчанию**: `true`. Показывать советы в спиннере, пока Claude работает. Установите на `false`, чтобы отключить советы | `false` |

312| `spinnerTipsOverride` | Переопределить советы спиннера пользовательскими строками. `tips`: массив строк советов. `excludeDefault`: если `true`, показывать только пользовательские советы; если `false` или отсутствует, пользовательские советы объединяются со встроенными советами | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |316| `spinnerTipsOverride` | Переопределить советы спиннера пользовательскими строками. `tips`: массив строк советов. `excludeDefault`: если `true`, показывать только пользовательские советы; если `false` или отсутствует, пользовательские советы объединяются со встроенными советами | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |

313| `spinnerVerbs` | Настройте глаголы действия, показываемые в спиннере во время хода. Установите `mode` на `"replace"`, чтобы использовать только ваши глаголы, или `"append"`, чтобы добавить их к значениям по умолчанию | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |317| `spinnerVerbs` | Настройте глаголы действия, показываемые в спиннере во время хода. Установите `mode` на `"replace"`, чтобы использовать только ваши глаголы, или `"append"`, чтобы добавить их к значениям по умолчанию | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |


320| `terminalProgressBarEnabled` | **По умолчанию**: `true`. Показывать полосу прогресса терминала в поддерживаемых терминалах: ConEmu, Ghostty 1.2.0+ и iTerm2 3.6.6+. Появляется в `/config` как **Terminal progress bar** | `false` |324| `terminalProgressBarEnabled` | **По умолчанию**: `true`. Показывать полосу прогресса терминала в поддерживаемых терминалах: ConEmu, Ghostty 1.2.0+ и iTerm2 3.6.6+. Появляется в `/config` как **Terminal progress bar** | `false` |

321| `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"` |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"` |

322| `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"` |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"` |

323| `ultracode` | Включить [ultracode](/ru/workflows#let-claude-decide-with-ultracode) для сеанса. Только для сеанса и не читается из `settings.json`. Установите через `/effort ultracode`, `--settings` или запрос управления Agent SDK | `true` |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` |

324| `useAutoModeDuringPlan` | **По умолчанию**: `true`. Использует ли Plan Mode семантику автоматического режима, когда автоматический режим доступен. Не читается из общих параметров проекта. Появляется в `/config` как "Use auto mode during plan" | `false` |328| `useAutoModeDuringPlan` | **По умолчанию**: `true`. Использует ли Plan Mode семантику автоматического режима, когда автоматический режим доступен. Не читается из общих параметров проекта. Появляется в `/config` как "Use auto mode during plan" | `false` |

325| `verbose` | {/* min-version: 2.1.119 */}**По умолчанию**: `false`. Показать полный вывод инструмента вместо усеченных сводок. Появляется в `/config` как **Verbose output**. Флаг `--verbose` переопределяет это на один сеанс | `true` |329| `verbose` | {/* min-version: 2.1.119 */}**По умолчанию**: `false`. Показать полный вывод инструмента вместо усеченных сводок. Появляется в `/config` как **Verbose output**. Флаг `--verbose` переопределяет это на один сеанс | `true` |

326| `viewMode` | Режим просмотра стенограммы по умолчанию при запуске: `"default"`, `"verbose"` или `"focus"`. Переопределяет липкий выбор `/focus` при установке. Флаг `--verbose` переопределяет это на один сеанс | `"verbose"` |330| `viewMode` | Режим просмотра стенограммы по умолчанию при запуске: `"default"`, `"verbose"` или `"focus"`. Переопределяет липкий выбор `/focus` при установке. Флаг `--verbose` переопределяет это на один сеанс | `"verbose"` |


341</Note>345</Note>

342 346 

343| Ключ | Описание | Пример |347| Ключ | Описание | Пример |

344| :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |348| :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |

345| `autoConnectIde` | **По умолчанию**: `false`. Автоматически подключаться к запущенной IDE при запуске Claude Code из внешнего терминала. Появляется в `/config` как **Auto-connect to IDE (external terminal)** при запуске вне терминала VS Code или JetBrains. Переменная окружения [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/ru/env-vars) переопределяет это при установке | `true` |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` |

346| `autoInstallIdeExtension` | **По умолчанию**: `true`. Автоматически устанавливать расширение Claude Code IDE при запуске из терминала VS Code. Появляется в `/config` как **Auto-install IDE extension** при запуске внутри терминала VS Code или JetBrains. Вы также можете установить переменную окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/ru/env-vars) | `false` |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` |

347| `externalEditorContext` | **По умолчанию**: `false`. Добавить предыдущий ответ Claude как контекст с комментариями `#` при открытии внешнего редактора с помощью `Ctrl+G`. Появляется в `/config` как **Show last response in external editor** | `true` |351| `externalEditorContext` | **По умолчанию**: `false`. Добавить предыдущий ответ Claude как контекст с комментариями `#` при открытии внешнего редактора с помощью `Ctrl+G`. Появляется в `/config` как **Show last response in external editor** | `true` |

348| `teammateDefaultModel` | Модель по умолчанию для товарищей по [команде агентов](/ru/agent-teams) когда запрос порождения не указывает одну. Установите на псевдоним модели, такой как `"sonnet"`, или `null` для наследования текущего выбора `/model` лидера. Появляется в `/config` как **Default teammate model** | `"sonnet"` |352| `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"` |

349 354 

350<h3 id="worktree-settings">355<h3 id="worktree-settings">

351 Параметры Worktree356 Параметры Worktree


354Настройте, как `--worktree` создает и управляет git worktrees.359Настройте, как `--worktree` создает и управляет git worktrees.

355 360 

356| Ключ | Описание | Пример |361| Ключ | Описание | Пример |

357| :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |362| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

358| `worktree.baseRef` | Какой ref новые worktrees ветвятся от. `"fresh"` (по умолчанию) ветвится от `origin/<default-branch>` для чистого дерева, соответствующего удаленному. `"head"` ветвится от вашего текущего локального `HEAD`, поэтому неотправленные коммиты и состояние ветки функции присутствуют в worktree. Применяется к `--worktree`, инструменту `EnterWorktree` и изоляции subagent | `"head"` |363| `worktree.baseRef` | Какой ref новые worktrees ветвятся от. `"fresh"` (по умолчанию) ветвится от `origin/<default-branch>` для чистого дерева, соответствующего удаленному. `"head"` ветвится от вашего текущего локального `HEAD`, поэтому неотправленные коммиты и состояние ветки функции присутствуют в worktree. Применяется к `--worktree`, инструменту `EnterWorktree` и изоляции subagent | `"head"` |

359| `worktree.symlinkDirectories` | Каталоги для создания символических ссылок из основного репозитория в каждый worktree, чтобы избежать дублирования больших каталогов на диске. По умолчанию никакие каталоги не создаются символическими ссылками | `["node_modules", ".cache"]` |364| `worktree.symlinkDirectories` | Каталоги для создания символических ссылок из основного репозитория в каждый worktree, чтобы избежать дублирования больших каталогов на диске. По умолчанию никакие каталоги не создаются символическими ссылками | `["node_modules", ".cache"]` |

360| `worktree.sparsePaths` | Каталоги для проверки в каждом worktree через git sparse-checkout. На диск записываются только перечисленные пути, что быстрее в больших монорепозиториях | `["packages/my-app", "shared/utils"]` |365| `worktree.sparsePaths` | Каталоги для проверки в каждом worktree через git sparse-checkout. На диск записываются только перечисленные пути, что быстрее в больших монорепозиториях | `["packages/my-app", "shared/utils"]` |

361| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Режим изоляции для [фоновых сеансов](/ru/agent-view#how-file-edits-are-isolated). `"worktree"` (по умолчанию) блокирует `Edit`/`Write` в основной проверке до вызова `EnterWorktree`. `"none"` позволяет фоновым заданиям редактировать рабочую копию напрямую. Требует Claude Code v2.1.143 или позже | `"none"` |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"` |

362 367 

363Чтобы скопировать файлы, игнорируемые gitignore, такие как `.env`, в новые worktrees, используйте [файл `.worktreeinclude`](/ru/worktrees#copy-gitignored-files-into-worktrees) в корне вашего проекта вместо параметра.368Чтобы скопировать файлы, игнорируемые gitignore, такие как `.env`, в новые worktrees, используйте [файл `.worktreeinclude`](/ru/worktrees#copy-gitignored-files-into-worktrees) в корне вашего проекта вместо параметра.

364 369 


367</h3>372</h3>

368 373 

369| Ключи | Описание | Пример |374| Ключи | Описание | Пример |

370| :---------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |375| :---------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |

371| `allow` | Массив правил разрешений для разрешения использования инструмента. Глобусы имен инструментов поддерживаются только в позиции инструмента после буквального префикса `mcp__<server>__`, такого как `mcp__github__get_*`; сегмент сервера должен быть без глобусов. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже для деталей сопоставления шаблонов | `[ "Bash(git diff *)" ]` |376| `allow` | Массив правил разрешений для разрешения использования инструмента. Глобусы имен инструментов поддерживаются только в позиции инструмента после буквального префикса `mcp__<server>__`, такого как `mcp__github__get_*`; сегмент сервера должен быть без глобусов. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже для деталей сопоставления шаблонов | `[ "Bash(git diff *)" ]` |

372| `ask` | Массив правил разрешений для запроса подтверждения при использовании инструмента. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже | `[ "Bash(git push *)" ]` |377| `ask` | Массив правил разрешений для запроса подтверждения при использовании инструмента. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже | `[ "Bash(git push *)" ]` |

373| `deny` | Массив правил разрешений для запрета использования инструмента. Используйте это для исключения чувствительных файлов из доступа Claude Code. Имена инструментов принимают глобусы: `"*"` запрещает каждый инструмент и `"mcp__*"` запрещает все MCP инструменты. См. [Синтаксис правила разрешения](#permission-rule-syntax) и [Ограничения разрешений Bash](/ru/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |378| `deny` | Массив правил разрешений для запрета использования инструмента. Используйте это для исключения чувствительных файлов из доступа Claude Code. Имена инструментов принимают глобусы: `"*"` запрещает каждый инструмент и `"mcp__*"` запрещает все MCP инструменты. См. [Синтаксис правила разрешения](#permission-rule-syntax) и [Ограничения разрешений Bash](/ru/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

374| `additionalDirectories` | Дополнительные [рабочие каталоги](/ru/permissions#working-directories) для доступа к файлам. Большинство конфигурации `.claude/` [не обнаруживается](/ru/permissions#additional-directories-grant-file-access-not-configuration) из этих каталогов | `[ "../docs/" ]` |379| `additionalDirectories` | Дополнительные [рабочие каталоги](/ru/permissions#working-directories) для доступа к файлам. Большинство конфигурации `.claude/` [не обнаруживается](/ru/permissions#additional-directories-grant-file-access-not-configuration) из этих каталогов | `[ "../docs/" ]` |

375| `defaultMode` | Режим [разрешения](/ru/permission-modes) по умолчанию при открытии Claude Code. Допустимые значения: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`. {/* min-version: 2.1.142 */}Начиная с Claude Code v2.1.142, `auto` игнорируется при установке в параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), поэтому репозиторий не может предоставить себе автоматический режим. Установите его в `~/.claude/settings.json` вместо этого. Флаг CLI `--permission-mode` переопределяет этот параметр для одного сеанса | `"acceptEdits"` |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"` |

376| `disableBypassPermissionsMode` | Установите на `"disable"`, чтобы предотвратить активацию режима `bypassPermissions`. Это отключает флаг командной строки `--dangerously-skip-permissions`. Обычно размещается в [управляемых параметрах](/ru/permissions#managed-settings) для применения организационной политики, но работает из любой области | `"disable"` |381| `disableBypassPermissionsMode` | Установите на `"disable"`, чтобы предотвратить активацию режима `bypassPermissions`. Это отключает флаг командной строки `--dangerously-skip-permissions`. Обычно размещается в [управляемых параметрах](/ru/permissions#managed-settings) для применения организационной политики, но работает из любой области | `"disable"` |

377| `skipDangerousModePermissionPrompt` | Пропустить подтверждение, показываемое перед входом в режим обхода разрешений через `--dangerously-skip-permissions` или `defaultMode: "bypassPermissions"`. Игнорируется при установке в параметрах проекта (`.claude/settings.json`) для предотвращения автоматического обхода подтверждения ненадежными репозиториями | `true` |382| `skipDangerousModePermissionPrompt` | Пропустить подтверждение, показываемое перед входом в режим обхода разрешений через `--dangerously-skip-permissions` или `defaultMode: "bypassPermissions"`. Игнорируется при установке в параметрах проекта (`.claude/settings.json`) для предотвращения автоматического обхода подтверждения ненадежными репозиториями | `true` |

378 383 


669 * Хосты встраивания, такие как Claude Desktop, могут предоставлять политику через опцию SDK `managedSettings`. По умолчанию это игнорируется, когда присутствует любой управляемый источник, развернутый администратором: параметры, управляемые сервером, политика MDM или OS-уровня, или файл управляемых параметров. Резервный реестр HKCU, доступный для записи пользователем, не считается управляемым источником, развернутым администратором. Администраторы могут согласиться, установив [`parentSettingsBehavior`](#available-settings) на `"merge"`. Значения встраивателя отфильтрованы, чтобы они могли ужесточить управляемую политику, но не ослабить ее.674 * Хосты встраивания, такие как Claude Desktop, могут предоставлять политику через опцию SDK `managedSettings`. По умолчанию это игнорируется, когда присутствует любой управляемый источник, развернутый администратором: параметры, управляемые сервером, политика MDM или OS-уровня, или файл управляемых параметров. Резервный реестр HKCU, доступный для записи пользователем, не считается управляемым источником, развернутым администратором. Администраторы могут согласиться, установив [`parentSettingsBehavior`](#available-settings) на `"merge"`. Значения встраивателя отфильтрованы, чтобы они могли ужесточить управляемую политику, но не ослабить ее.

670 675 

6712. **Аргументы командной строки**6762. **Аргументы командной строки**

672 * Временные переопределения для конкретного сеанса. JSON, переданный через `--settings <file-or-json>`, объединяется с параметрами на основе файлов, используя те же правила, что и другие уровни: ключ, установленный здесь, переопределяет тот же ключ в локальных, проектных или пользовательских параметрах, и пропуск ключа оставляет значение н нижнего уровня на месте677 * Временные переопределения для конкретного сеанса. JSON, переданный через `--settings <file-or-json>`, объединяется с параметрами на основе файлов, используя те же правила, что и другие уровни: ключ, установленный здесь, переопределяет тот же ключ в локальных, проектных или пользовательских параметрах, и пропуск ключа оставляет значение нижнего уровня на месте

673 678 

6743. **Локальные параметры проекта** (`.claude/settings.local.json`)6793. **Локальные параметры проекта** (`.claude/settings.local.json`)

675 * Личные параметры, специфичные для проекта680 * Личные параметры, специфичные для проекта

setup.md +9 −3

Details

188 Аутентификация188 Аутентификация

189</h2>189</h2>

190 190 

191Claude Code требует учетную запись Pro, Max, Team, Enterprise или Console. Бесплатный план Claude.ai не включает доступ к Claude Code. Вы также можете использовать Claude Code с поставщиком API третьей стороны, таким как [Amazon Bedrock](/ru/amazon-bedrock), [Google Vertex AI](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry).191Claude Code требует учетную запись Pro, Max, Team, Enterprise или Console. Бесплатный план Claude.ai не включает доступ к Claude Code. Вы также можете использовать Claude Code с поставщиком API третьей стороны, таким как [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry).

192 192 

193После установки войдите, выполнив `claude` и следуя подсказкам браузера. См. [Аутентификация](/ru/authentication) для всех типов учетных записей и параметров настройки команды.193После установки войдите, выполнив `claude` и следуя подсказкам браузера. См. [Аутентификация](/ru/authentication) для всех типов учетных записей и параметров настройки команды.

194 194 


376 376 

377<Tabs>377<Tabs>

378 <Tab title="apt">378 <Tab title="apt">

379 Для Debian и Ubuntu. Следующие команды настраивают канал `stable`:379 Для Debian и Ubuntu. Команды установки ниже загружают ключ подписи с помощью `curl`, который свежие установки Debian и Ubuntu могут не включать. Если загрузка не удается с ошибкой `sudo: curl: command not found`, сначала установите curl:

380 

381 ```bash theme={null}

382 sudo apt install curl

383 ```

384 

385 Следующие команды настраивают канал `stable`:

380 386 

381 ```bash theme={null}387 ```bash theme={null}

382 sudo install -d -m 0755 /etc/apt/keyrings388 sudo install -d -m 0755 /etc/apt/keyrings


526 </Step>532 </Step>

527 533 

528 <Step title="Проверка двоичного файла против манифеста">534 <Step title="Проверка двоичного файла против манифеста">

529 Сравните контрольную сумму SHA256 вашего загруженного двоичного файла со значением, указанным в `platforms.<platform>.checksum` в `manifest.json`.535 Сравните контрольную сумму SHA256 двоичного файла со значением, указанным в `platforms.<platform>.checksum` в `manifest.json`. Приведенные ниже команды предполагают двоичный файл `claude` в текущем каталоге. Чтобы вместо этого проверить установленный встроенный двоичный файл, выполните команду для `~/.local/share/claude/versions/VERSION`, заменив VERSION на выпуск, который вы установили на шаге 2.

530 536 

531 <Tabs>537 <Tabs>

532 <Tab title="Linux">538 <Tab title="Linux">

skills.md +11 −3

Details

22 Встроенные skills22 Встроенные skills

23</h2>23</h2>

24 24 

25Claude Code включает набор встроенных skills, которые доступны в каждой сессии, если они не отключены с помощью параметра [`disableBundledSkills`](/ru/settings#available-settings), включая `/code-review`, `/batch`, `/debug`, `/loop` и `/claude-api`. В отличие от большинства встроенных команд, которые выполняют фиксированную логику напрямую, встроенные skills основаны на подсказках: они дают Claude подробные инструкции и позволяют ему организовать работу, используя свои инструменты. Вы вызываете их так же, как любой другой skill, введя `/` и затем имя skill.25Claude Code включает набор встроенных skills, которые доступны в каждой сессии, если они не отключены с помощью параметра [`disableBundledSkills`](/ru/settings#available-settings), включая `/doctor`, `/code-review`, `/batch`, `/debug`, `/loop` и `/claude-api`. В отличие от большинства встроенных команд, которые выполняют фиксированную логику напрямую, встроенные skills основаны на подсказках: они дают Claude подробные инструкции и позволяют ему организовать работу, используя свои инструменты. Вы вызываете их так же, как любой другой skill, введя `/` и затем имя skill.

26 

27Проверка настройки [`/doctor`](/ru/commands#all-commands) является единственным исключением из `disableBundledSkills` в Claude Code v2.1.205 и позже: она остается доступной для ввода, когда этот параметр включен. Чтобы скрыть её, установите переменную окружения `DISABLE_DOCTOR_COMMAND` или запись [`skillOverrides`](#override-skill-visibility-from-settings) со значением `"doctor": "off"`. До версии v2.1.205 `/doctor` была встроенной командой, а не встроенным skill.

26 28 

27Встроенные skills перечислены вместе со встроенными командами в [справочнике команд](/ru/commands), отмечены как **Skill** в столбце Purpose.29Встроенные skills перечислены вместе со встроенными командами в [справочнике команд](/ru/commands), отмечены как **Skill** в столбце Purpose.

28 30 


129 131 

130Ввод `/deploy` запускает skill корня проекта. Введите квалифицированное имя `/apps/web:deploy`, чтобы запустить вложенный вариант явно.132Ввод `/deploy` запускает skill корня проекта. Введите квалифицированное имя `/apps/web:deploy`, чтобы запустить вложенный вариант явно.

131 133 

134Когда вы или Claude вызываете неквалифицированное имя, загружается skill корня проекта, и Claude Code добавляет список квалифицированных по каталогам вариантов к его содержимому с инструкцией также вызвать любой вариант, чей каталог содержит файлы, с которыми работает Claude Code. Вложенный skill поэтому по-прежнему применяется к работе в его каталоге, когда вызывается только неквалифицированное имя. Требуется Claude Code v2.1.203 или позже.

135 

132Запись `<skill-name>` в местоположениях enterprise, personal или project может быть символической ссылкой на каталог в другом месте на диске. Claude Code следует символической ссылке и читает `SKILL.md` из целевого каталога, и если один и тот же целевой каталог доступен из более чем одного местоположения, Claude Code загружает skill один раз. Plugin skills обрабатывают символические ссылки иначе; см. [Совместное использование файлов в marketplace с помощью символических ссылок](/ru/plugins-reference#share-files-within-a-marketplace-with-symlinks).136Запись `<skill-name>` в местоположениях enterprise, personal или project может быть символической ссылкой на каталог в другом месте на диске. Claude Code следует символической ссылке и читает `SKILL.md` из целевого каталога, и если один и тот же целевой каталог доступен из более чем одного местоположения, Claude Code загружает skill один раз. Plugin skills обрабатывают символические ссылки иначе; см. [Совместное использование файлов в marketplace с помощью символических ссылок](/ru/plugins-reference#share-files-within-a-marketplace-with-symlinks).

133 137 

134<Note>138<Note>


390 394 

391Когда вы или Claude вызываете skill, отрендеренное содержимое `SKILL.md` входит в разговор как одно сообщение и остаётся там для остальной части сессии. Claude Code не перечитывает файл skill при последующих ходах, поэтому пишите рекомендации, которые должны применяться на протяжении всей задачи, как постоянные инструкции, а не одноразовые шаги.395Когда вы или Claude вызываете skill, отрендеренное содержимое `SKILL.md` входит в разговор как одно сообщение и остаётся там для остальной части сессии. Claude Code не перечитывает файл skill при последующих ходах, поэтому пишите рекомендации, которые должны применяться на протяжении всей задачи, как постоянные инструкции, а не одноразовые шаги.

392 396 

397Когда Claude повторно вызывает skill, чьё отрендеренное содержимое идентично копии, уже находящейся в контексте, Claude Code добавляет краткую заметку о том, что skill уже загружен, вместо второй копии содержимого. Когда отрендеренное содержимое отличается, потому что аргументы изменились или команда [динамического контекста](#inject-dynamic-context) произвела новый выход, Claude Code добавляет полное содержимое снова. До версии 2.1.202 каждое повторное вызывание добавляло ещё одну полную копию инструкций skill.

398 

393[Auto-compact](/ru/how-claude-code-works#when-context-fills-up) переносит вызванные skills в рамках бюджета токенов. Когда разговор суммируется для освобождения контекста, Claude Code повторно прикрепляет самый последний вызов каждого skill после сводки, сохраняя первые 5 000 токенов каждого. Повторно прикреплённые skills делят объединённый бюджет в 25 000 токенов. Claude Code заполняет этот бюджет, начиная с самого недавно вызванного skill, поэтому более старые skills могут быть полностью удалены после компактирования, если вы вызвали много в одной сессии.399[Auto-compact](/ru/how-claude-code-works#when-context-fills-up) переносит вызванные skills в рамках бюджета токенов. Когда разговор суммируется для освобождения контекста, Claude Code повторно прикрепляет самый последний вызов каждого skill после сводки, сохраняя первые 5 000 токенов каждого. Повторно прикреплённые skills делят объединённый бюджет в 25 000 токенов. Claude Code заполняет этот бюджет, начиная с самого недавно вызванного skill, поэтому более старые skills могут быть полностью удалены после компактирования, если вы вызвали много в одной сессии.

394 400 

395Если skill кажется перестаёт влиять на поведение после первого ответа, содержимое обычно всё ещё присутствует, и модель выбирает другие инструменты или подходы. Усильте описание skill и инструкции, чтобы модель продолжала его предпочитать, или используйте [hooks](/ru/hooks) для детерминированного обеспечения поведения. Если skill большой или вы вызвали несколько других после него, повторно вызовите его после компактирования, чтобы восстановить полное содержимое.401Если skill кажется перестаёт влиять на поведение после первого ответа, содержимое обычно всё ещё присутствует, и модель выбирает другие инструменты или подходы. Усильте описание skill и инструкции, чтобы модель продолжала его предпочитать, или используйте [hooks](/ru/hooks) для детерминированного обеспечения поведения. Если skill большой или вы вызвали несколько других после него, повторно вызовите его после компактирования, чтобы восстановить полное содержимое.


908 Описания skills обрезаны914 Описания skills обрезаны

909</h3>915</h3>

910 916 

911Описания skills загружаются в контекст, чтобы Claude знал, что доступно. Все имена skills всегда включены, но если у вас много skills, описания сокращаются, чтобы соответствовать бюджету символов, что может удалить ключевые слова, которые Claude нужны для совпадения с вашим запросом. Бюджет масштабируется на 1% контекстного окна модели. Когда он переполняется, описания для skills, которые вы вызываете реже всего, удаляются в первую очередь, поэтому skills, которые вы фактически используете, сохраняют полный текст. Запустите `/doctor`, чтобы увидеть, сколько описаний skills сокращаются или удаляются и какие skills затронуты.917Claude Code загружает список имен skills и описаний в контекст, чтобы Claude знал, что доступно. Список всегда содержит все имена skills, но если у вас много skills, Claude Code сокращает описания, чтобы соответствовать бюджету символов списка, что может удалить ключевые слова, которые Claude нужны для совпадения с вашим запросом. Бюджет масштабируется на 1% контекстного окна модели. Когда список переполняется, Claude Code удаляет описания, начиная с skills, которые вы вызываете реже всего, поэтому skills, которые вы используете чаще всего, сохраняют полный текст.

918 

919Запустите `/doctor`, чтобы получить оценку стоимости списка в контексте и его основных участников. Когда список превышает свой бюджет, Claude Code также записывает предупреждение в журнал отладки, видимый с помощью [`--debug`](/ru/cli-reference#cli-flags).

912 920 

913Начиная с версии 2.1.196, строка Skills в `/context` отображает размер списка после применения бюджета, поэтому он соответствует тому, что получает модель. В более ранних версиях подсчитывался полный текст каждого описания, поэтому строка могла показывать значение в несколько раз больше, чем бюджет, который сообщает `/doctor`.921Строка Skills в `/context` отображает размер списка после применения бюджета, поэтому он соответствует тому, что получает модель. До версии 2.1.196 строка подсчитывала полный текст каждого описания и могла показывать значение в несколько раз больше, чем настроенный бюджет.

914 922 

915Чтобы повысить бюджет, установите параметр [`skillListingBudgetFraction`](/ru/settings#available-settings) (например, `0.02` = 2%) или переменную окружения `SLASH_COMMAND_TOOL_CHAR_BUDGET` на фиксированное количество символов. Чтобы освободить бюджет для других skills, установите записи с низким приоритетом на `"name-only"` в [`skillOverrides`](#override-skill-visibility-from-settings), чтобы они отображались без описания. Вы также можете обрезать текст `description` и `when_to_use` в источнике: поместите ключевой вариант использования в начало, так как комбинированный текст каждой записи ограничен 1 536 символами независимо от бюджета. Лимит настраивается с помощью [`skillListingMaxDescChars`](/ru/settings#available-settings).923Чтобы повысить бюджет, установите параметр [`skillListingBudgetFraction`](/ru/settings#available-settings) (например, `0.02` = 2%) или переменную окружения `SLASH_COMMAND_TOOL_CHAR_BUDGET` на фиксированное количество символов. Чтобы освободить бюджет для других skills, установите записи с низким приоритетом на `"name-only"` в [`skillOverrides`](#override-skill-visibility-from-settings), чтобы они отображались без описания. Вы также можете обрезать текст `description` и `when_to_use` в источнике: поместите ключевой вариант использования в начало, так как комбинированный текст каждой записи ограничен 1 536 символами независимо от бюджета. Лимит настраивается с помощью [`skillListingMaxDescChars`](/ru/settings#available-settings).

916 924 

statusline.md +3 −1

Details

1044}1044}

1045```1045```

1046 1046 

1047Команда запускается один раз за цикл обновления со всеми видимыми строками подагентов, переданными как один объект JSON на stdin. Входные данные включают [базовые поля hooks](/ru/hooks#common-input-fields) плюс `columns` (используемая ширина строки) и массив `tasks`, где каждая задача имеет `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `tokenCount`, `tokenSamples` и `cwd`.1047Команда запускается один раз за цикл обновления со всеми видимыми строками подагентов, переданными как один объект JSON на stdin. Входные данные включают [базовые поля hooks](/ru/hooks#common-input-fields), поле `columns` с используемой шириной строки и массив `tasks`. Каждая задача имеет `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `model`, `contextWindowSize`, `tokenCount`, `tokenSamples` и `cwd`.

1048 

1049Поле `model` для каждой задачи — это разрешённый ID модели, на которой выполняется задача. `contextWindowSize` — это контекстное окно этой модели в токенах, вычисляемое так же, как `context_window.context_window_size` в строке состояния основного интерфейса, поэтому вы можете отобразить процент для каждой строки из `tokenCount`. Оба поля требуют Claude Code v2.1.205 или более поздней версии и опускаются для задачи, модель которой ещё не разрешена.

1048 1050 

1049Напишите одну строку JSON в stdout для каждой строки, которую вы хотите переопределить, в форме `{"id": "<task id>", "content": "<row body>"}`. Строка `content` отображается как есть, включая цвета ANSI и гиперссылки OSC 8. Пропустите `id` задачи, чтобы сохранить отображение по умолчанию для этой строки; выведите пустую строку `content`, чтобы скрыть её.1051Напишите одну строку JSON в stdout для каждой строки, которую вы хотите переопределить, в форме `{"id": "<task id>", "content": "<row body>"}`. Строка `content` отображается как есть, включая цвета ANSI и гиперссылки OSC 8. Пропустите `id` задачи, чтобы сохранить отображение по умолчанию для этой строки; выведите пустую строку `content`, чтобы скрыть её.

1050 1052 

sub-agents.md +9 −3

Details

183 183 

184Claude Code сканирует `.claude/agents/` и `~/.claude/agents/` рекурсивно, поэтому вы можете организовать определения в подпапки, такие как `agents/review/` или `agents/research/`. Путь подпапки не влияет на то, как идентифицируется или вызывается subagent, потому что идентичность происходит только из поля `name` frontmatter.184Claude Code сканирует `.claude/agents/` и `~/.claude/agents/` рекурсивно, поэтому вы можете организовать определения в подпапки, такие как `agents/review/` или `agents/research/`. Путь подпапки не влияет на то, как идентифицируется или вызывается subagent, потому что идентичность происходит только из поля `name` frontmatter.

185 185 

186Сохраняйте значения `name` уникальными по всему дереву: если два файла в одной области объявляют одно и то же имя, Claude Code загружает только один из них. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, запуск `/doctor` сообщает об одинаковых именах агентов в одной области и показывает, какое определение активно.186Сохраняйте значения `name` уникальными по всему дереву: если два файла под одной директорией `.claude/agents/`, включая её подпапки, объявляют одно и то же имя, Claude Code загружает только один из них, выбранный по порядку чтения файловой системы, а не по документированному приоритету. Во вложенных директориях проекта определение, ближайшее к рабочей директории, побеждает, как описано выше. {/* min-version: 2.1.205 */}Проверка настройки [`/doctor`](/ru/commands#all-commands) сообщает о файлах в одной директории, которые имеют одно и то же имя, и предлагает переименовать или удалить все, кроме одного. До версии 2.1.205 `/doctor` открывал экран диагностики, который перечислял дубликаты и показывал, какое определение было активно.

187 187 

188Директории `agents/` plugin также сканируются рекурсивно. В отличие от областей проекта и пользователя, подпапка внутри директории `agents/` plugin становится частью [scoped identifier](#invoke-subagents-explicitly): файл в `agents/review/security.md` в plugin `my-plugin` регистрируется как `my-plugin:review:security`.188Директории `agents/` plugin также сканируются рекурсивно. В отличие от областей проекта и пользователя, подпапка внутри директории `agents/` plugin становится частью [scoped identifier](#invoke-subagents-explicitly): файл в `agents/review/security.md` в plugin `my-plugin` регистрируется как `my-plugin:review:security`.

189 189 


268 268 

269Frontmatter определяет метаданные и конфигурацию subagent. Тело становится системным приглашением, которое направляет поведение subagent. Subagents получают только это системное приглашение плюс базовые детали окружения, такие как рабочая директория, а не полное системное приглашение Claude Code.269Frontmatter определяет метаданные и конфигурацию subagent. Тело становится системным приглашением, которое направляет поведение subagent. Subagents получают только это системное приглашение плюс базовые детали окружения, такие как рабочая директория, а не полное системное приглашение Claude Code.

270 270 

271В [non-interactive mode](/ru/headless) флаг [`--append-subagent-system-prompt`](/ru/cli-reference#cli-flags) добавляет текст, который вы предоставляете, в конец системного приглашения каждого subagent, включая вложенные subagents. Требует Claude Code v2.1.205 или позже.

272 

271Subagent начинает работу в текущей рабочей директории основного разговора. В пределах subagent команды `cd` не сохраняются между вызовами инструментов Bash или PowerShell и не влияют на рабочую директорию основного разговора. Чтобы дать subagent изолированную копию репозитория вместо этого, установите [`isolation: worktree`](#supported-frontmatter-fields).273Subagent начинает работу в текущей рабочей директории основного разговора. В пределах subagent команды `cd` не сохраняются между вызовами инструментов Bash или PowerShell и не влияют на рабочую директорию основного разговора. Чтобы дать subagent изолированную копию репозитория вместо этого, установите [`isolation: worktree`](#supported-frontmatter-fields).

272 274 

275{/* min-version: 2.1.203 */}Subagent с `isolation: worktree` запускает свои команды Bash и PowerShell внутри своего worktree. Команда, рабочая директория которой разрешается в вашу основную копию вместо этого, например потому что директория worktree была удалена во время работы subagent, завершается с ошибкой. До версии 2.1.203 такая команда могла запуститься в основной копии.

276 

273<h4 id="supported-frontmatter-fields">277<h4 id="supported-frontmatter-fields">

274 Поддерживаемые поля frontmatter278 Поддерживаемые поля frontmatter

275</h4>279</h4>


283| `tools` | Нет | [Инструменты](#available-tools), которые может использовать subagent. Наследует все инструменты, если опущено. Чтобы предварительно загрузить Skills в контекст, используйте поле `skills` вместо перечисления `Skill` здесь |287| `tools` | Нет | [Инструменты](#available-tools), которые может использовать subagent. Наследует все инструменты, если опущено. Чтобы предварительно загрузить Skills в контекст, используйте поле `skills` вместо перечисления `Skill` здесь |

284| `disallowedTools` | Нет | Инструменты для запрета, удалённые из унаследованного или указанного списка |288| `disallowedTools` | Нет | Инструменты для запрета, удалённые из унаследованного или указанного списка |

285| `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` |

286| `permissionMode` | Нет | [Режим разрешений](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions` или `plan`. Игнорируется для [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) |

287| `maxTurns` | Нет | Максимальное количество агентских ходов перед остановкой subagent |291| `maxTurns` | Нет | Максимальное количество агентских ходов перед остановкой subagent |

288| `skills` | Нет | [Skills](/ru/skills) для предварительной загрузки в контекст subagent при запуске. Полное содержимое skill инжектируется, а не просто описание. Subagents по-прежнему могут вызывать неперечисленные project, user и plugin skills через инструмент Skill |292| `skills` | Нет | [Skills](/ru/skills) для предварительной загрузки в контекст subagent при запуске. Полное содержимое skill инжектируется, а не просто описание. Subagents по-прежнему могут вызывать неперечисленные project, user и plugin skills через инструмент Skill |

289| `mcpServers` | Нет | [MCP servers](/ru/mcp) доступные этому subagent. Каждая запись — это либо имя сервера, ссылающееся на уже настроенный сервер (например, `"slack"`), либо встроенное определение с именем сервера в качестве ключа и полной [конфигурацией MCP server](/ru/mcp#installing-mcp-servers) в качестве значения. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |293| `mcpServers` | Нет | [MCP servers](/ru/mcp) доступные этому subagent. Каждая запись — это либо имя сервера, ссылающееся на уже настроенный сервер (например, `"slack"`), либо встроенное определение с именем сервера в качестве ключа и полной [конфигурацией MCP server](/ru/mcp#installing-mcp-servers) в качестве значения. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |


792 796 

793{/* min-version: 2.1.199 */}Начиная с v2.1.199, subagent, чей запуск заканчивается ошибкой API, такой как лимит использования или повторяющаяся ошибка сервера, сообщает об этом отказе Claude вместо возврата текста ошибки, как если бы это были результаты subagent. То, что получает Claude, зависит от того, где работал subagent:797{/* min-version: 2.1.199 */}Начиная с v2.1.199, subagent, чей запуск заканчивается ошибкой API, такой как лимит использования или повторяющаяся ошибка сервера, сообщает об этом отказе Claude вместо возврата текста ошибки, как если бы это были результаты subagent. То, что получает Claude, зависит от того, где работал subagent:

794 798 

795* **Foreground**: если лимит скорости, перегрузка или ошибка сервера прерывает subagent, который уже произвёл выходные данные, инструмент Agent возвращает эти частичные выходные данные с примечанием, что subagent был прерван и не завершил свою задачу. В противном случае вызов инструмента завершается с ошибкой [`Agent terminated early due to an API error`](/ru/errors#agent-terminated-early-due-to-an-api-error), за которой следует деталь ошибки.799* **Foreground**: если лимит скорости, перегрузка или ошибка сервера прерывает subagent, который уже произвёл выходные данные, инструмент Agent возвращает эти частичные выходные данные с примечанием, что subagent был прерван и не завершил свою задачу. {/* min-version: 2.1.200 */}Subagent, который не произвёл ничего, или чьим единственным выходом были вызовы инструментов, завершается с ошибкой [`Agent terminated early due to an API error`](/ru/errors#agent-terminated-early-due-to-an-api-error), за которой следует деталь ошибки. В v2.1.199 лимит скорости, перегрузка или ошибка сервера, которые прервали форму, содержащую только вызовы инструментов, возвращали пустой частичный результат, содержащий только примечание об отключении вместо этого.

796* **Background**: subagent помечается как неудачный, и сообщение, которое Claude получает при завершении, называет ошибку API и включает последний выход subagent, поэтому частичная работа не теряется.800* **Background**: subagent помечается как неудачный, и сообщение, которое Claude получает при завершении, называет ошибку API и включает последний выход subagent, поэтому частичная работа не теряется.

797 801 

798После того как основная ошибка API исчезнет, попросите Claude повторить задачу или [возобновить subagent](#resume-subagents).802После того как основная ошибка API исчезнет, попросите Claude повторить задачу или [возобновить subagent](#resume-subagents).


924 928 

925Если остановленный subagent получает `SendMessage`, он автоматически возобновляется в фоне без необходимости нового вызова `Agent`.929Если остановленный subagent получает `SendMessage`, он автоматически возобновляется в фоне без необходимости нового вызова `Agent`.

926 930 

931Возобновление начинает новый запуск агента под тем же ID, поэтому subagent, который уже завершился или был неудачным, показывается как работающий снова в списке задач и в событиях задач Agent SDK. До v2.1.205 он продолжал показывать свой более ранний статус неудачи или завершения, пока возобновленный запуск работал.

932 

927{/* min-version: 2.1.199 */}Начиная с v2.1.199, `SendMessage` проверяет, что имя по-прежнему ссылается на того же агента, которого оно достигло ранее в разговоре. Если более новый агент взял имя, например повторно порождённый фоновый агент, который его переиспользовал, Claude Code отказывает в отправке, а не доставляет его неправильному агенту, и ошибка сообщает, какого агента имя теперь достигает, чтобы Claude мог перенаправить. Чтобы достичь более раннего агента, пока он всё ещё работает, Claude обращается к нему по ID агента из результата spawn. Проверка ограничена текущим разговором и сбрасывается на `/clear`.933{/* min-version: 2.1.199 */}Начиная с v2.1.199, `SendMessage` проверяет, что имя по-прежнему ссылается на того же агента, которого оно достигло ранее в разговоре. Если более новый агент взял имя, например повторно порождённый фоновый агент, который его переиспользовал, Claude Code отказывает в отправке, а не доставляет его неправильному агенту, и ошибка сообщает, какого агента имя теперь достигает, чтобы Claude мог перенаправить. Чтобы достичь более раннего агента, пока он всё ещё работает, Claude обращается к нему по ID агента из результата spawn. Проверка ограничена текущим разговором и сбрасывается на `/clear`.

928 934 

929{/* min-version: 2.1.198 */}Начиная с v2.1.198, subagent рассматривает сообщения от агента, который его запустил, как нормальное направление задачи, включая коррекции курса во время выполнения, и действует в соответствии с ними в рамках своих собственных параметров разрешения. Два лимита по-прежнему действуют независимо от того, кто отправил сообщение: ни одно сообщение от любого агента не считается вашим одобрением для ожидающего запроса разрешения, и ни один агент не может изменить параметры разрешения subagent, `CLAUDE.md` или конфигурацию. Только система разрешений или ваши собственные сообщения могут предоставить одобрение.935{/* min-version: 2.1.198 */}Начиная с v2.1.198, subagent рассматривает сообщения от агента, который его запустил, как нормальное направление задачи, включая коррекции курса во время выполнения, и действует в соответствии с ними в рамках своих собственных параметров разрешения. Два лимита по-прежнему действуют независимо от того, кто отправил сообщение: ни одно сообщение от любого агента не считается вашим одобрением для ожидающего запроса разрешения, и ни один агент не может изменить параметры разрешения subagent, `CLAUDE.md` или конфигурацию. Только система разрешений или ваши собственные сообщения могут предоставить одобрение.

Details

102 <th>Anthropic Console</th>102 <th>Anthropic Console</th>

103 <th>Amazon Bedrock</th>103 <th>Amazon Bedrock</th>

104 <th>Claude Platform on AWS</th>104 <th>Claude Platform on AWS</th>

105 <th>Google Vertex AI</th>105 <th>Google Cloud's Agent Platform, ранее Vertex AI</th>

106 <th>Microsoft Foundry</th>106 <th>Microsoft Foundry</th>

107 </tr>107 </tr>

108 </thead>108 </thead>


196 196 

197* [Claude for Teams или Enterprise](/ru/authentication#claude-for-teams-or-enterprise)197* [Claude for Teams или Enterprise](/ru/authentication#claude-for-teams-or-enterprise)

198* [Anthropic Console](/ru/authentication#claude-console-authentication)198* [Anthropic Console](/ru/authentication#claude-console-authentication)

199* [Claude apps gateway](/ru/claude-apps-gateway), самостоятельно размещаемый шлюз, который добавляет вход через IdP перед Amazon Bedrock, Claude Platform on AWS, Google Vertex AI, Microsoft Foundry или Anthropic API199* [Claude apps gateway](/ru/claude-apps-gateway), самостоятельно размещаемый шлюз, который добавляет вход через IdP перед Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, Microsoft Foundry или Anthropic API

200* [Amazon Bedrock](/ru/amazon-bedrock)200* [Amazon Bedrock](/ru/amazon-bedrock)

201* [Claude Platform on AWS](/ru/claude-platform-on-aws)201* [Claude Platform on AWS](/ru/claude-platform-on-aws)

202* [Google Vertex AI](/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<h2 id="configure-proxies-and-gateways">205<h2 id="configure-proxies-and-gateways">


219 219 

220<Tabs>220<Tabs>

221 <Tab title="Корпоративный прокси">221 <Tab title="Корпоративный прокси">

222 Маршрутизируйте трафик Bedrock через ваш корпоративный прокси, установив следующие [переменные окружения](/ru/env-vars):222 Маршрутизируйте трафик Amazon Bedrock через ваш корпоративный прокси, установив следующие [переменные окружения](/ru/env-vars):

223 223 

224 ```bash theme={null}224 ```bash theme={null}

225 # Включить Bedrock225 # Включить Bedrock


232 </Tab>232 </Tab>

233 233 

234 <Tab title="Шлюз LLM">234 <Tab title="Шлюз LLM">

235 Маршрутизируйте трафик Bedrock через ваш шлюз LLM, установив следующие [переменные окружения](/ru/env-vars):235 Маршрутизируйте трафик Amazon Bedrock через ваш шлюз LLM, установив следующие [переменные окружения](/ru/env-vars):

236 236 

237 ```bash theme={null}237 ```bash theme={null}

238 # Включить Bedrock238 # Включить Bedrock


251 251 

252<Tabs>252<Tabs>

253 <Tab title="Корпоративный прокси">253 <Tab title="Корпоративный прокси">

254 Маршрутизируйте трафик Foundry через ваш корпоративный прокси, установив следующие [переменные окружения](/ru/env-vars):254 Маршрутизируйте трафик Microsoft Foundry через ваш корпоративный прокси, установив следующие [переменные окружения](/ru/env-vars):

255 255 

256 ```bash theme={null}256 ```bash theme={null}

257 # Включить Microsoft Foundry257 # Включить Microsoft Foundry


265 </Tab>265 </Tab>

266 266 

267 <Tab title="Шлюз LLM">267 <Tab title="Шлюз LLM">

268 Маршрутизируйте трафик Foundry через ваш шлюз LLM, установив следующие [переменные окружения](/ru/env-vars):268 Маршрутизируйте трафик Microsoft Foundry через ваш шлюз LLM, установив следующие [переменные окружения](/ru/env-vars):

269 269 

270 ```bash theme={null}270 ```bash theme={null}

271 # Включить Microsoft Foundry271 # Включить Microsoft Foundry


278 </Tab>278 </Tab>

279</Tabs>279</Tabs>

280 280 

281<h3 id="google-vertex-ai">281<h3 id="google-cloud’s-agent-platform">

282 Google Vertex AI282 Google Cloud's Agent Platform

283</h3>283</h3>

284 284 

285<Tabs>285<Tabs>

286 <Tab title="Корпоративный прокси">286 <Tab title="Корпоративный прокси">

287 Маршрутизируйте трафик Vertex AI через ваш корпоративный прокси, установив следующие [переменные окружения](/ru/env-vars):287 Маршрутизируйте трафик Google Cloud's Agent Platform через ваш корпоративный прокси, установив следующие [переменные окружения](/ru/env-vars):

288 288 

289 ```bash theme={null}289 ```bash theme={null}

290 # Включить Vertex290 # Включить Agent Platform

291 export CLAUDE_CODE_USE_VERTEX=1291 export CLAUDE_CODE_USE_VERTEX=1

292 export CLOUD_ML_REGION=us-east5292 export CLOUD_ML_REGION=us-east5

293 export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id293 export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id


298 </Tab>298 </Tab>

299 299 

300 <Tab title="Шлюз LLM">300 <Tab title="Шлюз LLM">

301 Маршрутизируйте трафик Vertex AI через ваш шлюз LLM, установив следующие [переменные окружения](/ru/env-vars):301 Маршрутизируйте трафик Google Cloud's Agent Platform через ваш шлюз LLM, установив следующие [переменные окружения](/ru/env-vars):

302 302 

303 ```bash theme={null}303 ```bash theme={null}

304 # Включить Vertex304 # Включить Agent Platform

305 export CLAUDE_CODE_USE_VERTEX=1305 export CLAUDE_CODE_USE_VERTEX=1

306 306 

307 # Настроить шлюз LLM307 # Настроить шлюз LLM


348 Закрепите версии моделей для поставщиков облачных услуг348 Закрепите версии моделей для поставщиков облачных услуг

349</h3>349</h3>

350 350 

351Если вы развертываете через [Bedrock](/ru/amazon-bedrock), [Vertex AI](/ru/google-vertex-ai), [Foundry](/ru/microsoft-foundry) или [Claude Platform on AWS](/ru/claude-platform-on-aws), закрепите конкретные версии моделей, используя `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` и `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Без закрепления, псевдонимы моделей разрешаются на встроенное значение по умолчанию Claude Code для этого поставщика, что может отставать от последнего выпуска и может быть еще не включено в вашей учетной записи. Закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель. См. раздел [Конфигурация модели](/ru/model-config#pin-models-for-third-party-deployments) для получения информации о том, что делает каждый поставщик, когда значение по умолчанию недоступно.351Если вы развертываете через [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), закрепите конкретные версии моделей, используя `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` и `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Без закрепления, псевдонимы моделей разрешаются на встроенное значение по умолчанию Claude Code для этого поставщика, что может отставать от последнего выпуска и может быть еще не включено в вашей учетной записи. Закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель. См. раздел [Конфигурация модели](/ru/model-config#pin-models-for-third-party-deployments) для получения информации о том, что делает каждый поставщик, когда значение по умолчанию недоступно.

352 352 

353<h3 id="configure-security-policies">353<h3 id="configure-security-policies">

354 Настройте политики безопасности354 Настройте политики безопасности

tools-reference.md +11 −11

Details

11Чтобы добавить пользовательские инструменты, подключите [MCP server](/ru/mcp). Чтобы расширить Claude с помощью переиспользуемых рабочих процессов на основе подсказок, напишите [skill](/ru/skills), который работает через существующий инструмент `Skill` вместо добавления новой записи инструмента.11Чтобы добавить пользовательские инструменты, подключите [MCP server](/ru/mcp). Чтобы расширить Claude с помощью переиспользуемых рабочих процессов на основе подсказок, напишите [skill](/ru/skills), который работает через существующий инструмент `Skill` вместо добавления новой записи инструмента.

12 12 

13| Инструмент | Описание | Требуется разрешение |13| Инструмент | Описание | Требуется разрешение |

14| :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |14| :--------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |

15| `Agent` | Создает [subagent](/ru/sub-agents) с собственным контекстным окном для выполнения задачи. См. [поведение инструмента Agent](#agent-tool-behavior) | Нет |15| `Agent` | Создает [subagent](/ru/sub-agents) с собственным контекстным окном для выполнения задачи. См. [поведение инструмента Agent](#agent-tool-behavior) | Нет |

16| `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) | Да |16| `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) | Да |

17| `AskUserQuestion` | Задает вопросы с несколькими вариантами ответов для сбора требований или уточнения неоднозначности. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, если вы не ответите в течение 60 секунд, диалог закроется самостоятельно: он отправит все уже выбранные вами параметры и сообщит Claude, что вы можете быть вдали от клавиатуры, поэтому Claude действует по собственному суждению и может переспросить позже. Обратный отсчет появляется в течение последних 20 секунд. Любое нажатие клавиши держит диалог открытым, как и сфокусированное окно на терминалах, которые сообщают о фокусе. Установите переменную окружения [`CLAUDE_AFK_TIMEOUT_MS`](/ru/env-vars#variables) для изменения времени ожидания Claude Code или установите большое значение, например `86400000`, 24 часа, чтобы держать вопросы открытыми, пока вас нет. Это время ожидания применяется только к вопросам с несколькими вариантами ответов `AskUserQuestion`; подсказки разрешений, включая одобрение плана, никогда не разрешаются автоматически при неактивности | Нет |17| `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) был единственным способом изменить это | Нет |

18| `Bash` | Выполняет команды оболочки в вашей среде. См. [поведение инструмента Bash](#bash-tool-behavior) | Да |18| `Bash` | Выполняет команды оболочки в вашей среде. См. [поведение инструмента Bash](#bash-tool-behavior) | Да |

19| `CronCreate` | Планирует повторяющуюся или одноразовую подсказку в текущем сеансе. Задачи привязаны к сеансу и восстанавливаются при `--resume` или `--continue`, если не истекли. См. [запланированные задачи](/ru/scheduled-tasks) | Нет |19| `CronCreate` | Планирует повторяющуюся или одноразовую подсказку в текущем сеансе. Задачи привязаны к сеансу и восстанавливаются при `--resume` или `--continue`, если не истекли. См. [запланированные задачи](/ru/scheduled-tasks) | Нет |

20| `CronDelete` | Отменяет запланированную задачу по ID | Нет |20| `CronDelete` | Отменяет запланированную задачу по ID | Нет |

21| `CronList` | Выводит список всех запланированных задач в сеансе | Нет |21| `CronList` | Выводит список всех запланированных задач в сеансе | Нет |

22| `Edit` | Вносит целевые изменения в конкретные файлы. См. [поведение инструмента Edit](#edit-tool-behavior) | Да |22| `Edit` | Вносит целевые изменения в конкретные файлы. См. [поведение инструмента Edit](#edit-tool-behavior) | Да |

23| `EnterPlanMode` | Переключается в режим плана для разработки подхода перед кодированием | Нет |23| `EnterPlanMode` | Переключается в режим плана для разработки подхода перед кодированием | Нет |

24| `EnterWorktree` | Создает изолированный [git worktree](/ru/worktrees) и переключается в него. Передайте `path` для переключения в существующий worktree текущего репозитория вместо создания нового. Из сеанса worktree или из subagent с закрепленным рабочим каталогом, например [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields), доступна только форма `path`, и целевой путь должен находиться под `.claude/worktrees/` | Нет |24| `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/` репозитория сеанса | Нет |

25| `ExitPlanMode` | Представляет план для утверждения и выходит из режима плана | Да |25| `ExitPlanMode` | Представляет план для утверждения и выходит из режима плана | Да |

26| `ExitWorktree` | Выходит из сеанса worktree и возвращается в исходный каталог. Недоступно для subagents, которые уже работают в собственном рабочем каталоге, например с [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields) | Нет |26| `ExitWorktree` | Выходит из сеанса worktree и возвращается в исходный каталог. Недоступно для subagents, которые уже работают в собственном рабочем каталоге, например с [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields) | Нет |

27| `Glob` | Находит файлы на основе сопоставления шаблонов. См. [поведение инструмента Glob](#glob-tool-behavior) | Нет |27| `Glob` | Находит файлы на основе сопоставления шаблонов. См. [поведение инструмента Glob](#glob-tool-behavior) | Нет |


31| `Monitor` | Запускает команду в фоне и передает каждую строку вывода обратно Claude, чтобы он мог реагировать на записи журнала, изменения файлов или опрашиваемый статус в середине разговора. Может также открыть WebSocket и рассматривать каждое входящее сообщение как событие. См. [инструмент Monitor](#monitor-tool) | Да |31| `Monitor` | Запускает команду в фоне и передает каждую строку вывода обратно Claude, чтобы он мог реагировать на записи журнала, изменения файлов или опрашиваемый статус в середине разговора. Может также открыть WebSocket и рассматривать каждое входящее сообщение как событие. См. [инструмент Monitor](#monitor-tool) | Да |

32| `NotebookEdit` | Изменяет ячейки Jupyter notebook. См. [поведение инструмента NotebookEdit](#notebookedit-tool-behavior) | Да |32| `NotebookEdit` | Изменяет ячейки Jupyter notebook. См. [поведение инструмента NotebookEdit](#notebookedit-tool-behavior) | Да |

33| `PowerShell` | Выполняет команды PowerShell изначально. См. [инструмент PowerShell](#powershell-tool) для доступности | Да |33| `PowerShell` | Выполняет команды PowerShell изначально. См. [инструмент PowerShell](#powershell-tool) для доступности | Да |

34| `PushNotification` | Отправляет уведомление на рабочий стол и push-уведомление на телефон при подключении [Remote Control](/ru/remote-control), чтобы долгоживущая задача или [запланированная задача](/ru/scheduled-tasks) могла вас достичь, когда вы отойдете. {/* plan-availability: feature=push-notifications providers=anthropic */}Доставка push-уведомлений осуществляется через инфраструктуру, размещенную на Anthropic, которая недоступна из Amazon Bedrock, Google Vertex AI или Microsoft Foundry | Нет |34| `PushNotification` | Отправляет уведомление на рабочий стол и push-уведомление на телефон при подключении [Remote Control](/ru/remote-control), чтобы долгоживущая задача или [запланированная задача](/ru/scheduled-tasks) могла вас достичь, когда вы отойдете. {/* plan-availability: feature=push-notifications providers=anthropic */}Доставка push-уведомлений осуществляется через инфраструктуру, размещенную на Anthropic, которая недоступна из Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry | Нет |

35| `Read` | Читает содержимое файлов. См. [поведение инструмента Read](#read-tool-behavior) | Нет |35| `Read` | Читает содержимое файлов. См. [поведение инструмента Read](#read-tool-behavior) | Нет |

36| `ReadMcpResourceTool` | Читает конкретный ресурс MCP по URI | Нет |36| `ReadMcpResourceTool` | Читает конкретный ресурс MCP по URI | Нет |

37| `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 Vertex AI или Microsoft Foundry | Нет |37| `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 | Нет |

38| `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`, показанный рядом с расположением файла в отображаемом списке | Нет |38| `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`, показанный рядом с расположением файла в отображаемом списке | Нет |

39| `ScheduleWakeup` | Переносит следующую итерацию [самостоятельного `/loop`](/ru/scheduled-tasks#let-claude-choose-the-interval). Claude вызывает это в конце каждой итерации, чтобы выбрать, когда запустится следующая, между одной минутой и одним часом; вы не вызываете это напрямую. Ожидающее пробуждение появляется в `session_crons` в [входе Stop hook](/ru/hooks#stop-input). {/* plan-availability: feature=loop-dynamic providers=anthropic */}Недоступно на Amazon Bedrock, Google Vertex AI или Microsoft Foundry, где `/loop` подсказка без интервала работает по фиксированному расписанию | Нет |39| `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` подсказка без интервала работает по фиксированному расписанию | Нет |

40| `SendMessage` | Отправляет сообщение члену [команды агентов](/ru/agent-teams), или [возобновляет subagent](/ru/sub-agents#resume-subagents) по его ID агента или имени. Остановленные subagents автоматически возобновляются в фоне. Структурированные сообщения протокола команды требуют команды агентов. Получатель никогда не рассматривает сообщение от другого агента как ваше согласие или одобрение. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, subagent рассматривает сообщение от агента, который его запустил, как обычное направление задачи, а не как запрос от коллеги. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, отправка на имя, которое теперь разрешается в другого агента, чем раньше в разговоре, отклоняется вместо доставки; см. [Возобновление subagents](/ru/sub-agents#resume-subagents) | Нет |40| `SendMessage` | Отправляет сообщение члену [команды агентов](/ru/agent-teams), или [возобновляет subagent](/ru/sub-agents#resume-subagents) по его ID агента или имени. Остановленные subagents автоматически возобновляются в фоне. Структурированные сообщения протокола команды требуют команды агентов. Получатель никогда не рассматривает сообщение от другого агента как ваше согласие или одобрение. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, subagent рассматривает сообщение от агента, который его запустил, как обычное направление задачи, а не как запрос от коллеги. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, отправка на имя, которое теперь разрешается в другого агента, чем раньше в разговоре, отклоняется вместо доставки; см. [Возобновление subagents](/ru/sub-agents#resume-subagents) | Нет |

41| `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 Vertex AI или Microsoft Foundry | Нет |41| `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 | Нет |

42| `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 | Да |42| `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 | Да |

43| `Skill` | Выполняет [skill](/ru/skills#control-who-invokes-a-skill) в основном разговоре | Да |43| `Skill` | Выполняет [skill](/ru/skills#control-who-invokes-a-skill) в основном разговоре | Да |

44| `TaskCreate` | Создает новую задачу в списке задач | Нет |44| `TaskCreate` | Создает новую задачу в списке задач | Нет |

45| `TaskGet` | Получает полные сведения для конкретной задачи | Нет |45| `TaskGet` | Получает полные сведения для конкретной задачи | Нет |

46| `TaskList` | Выводит список всех задач с их текущим статусом | Нет |46| `TaskList` | Выводит список всех задач с их текущим статусом | Нет |

47| `TaskOutput` | (Устарело) Получает вывод из фоновой задачи. Предпочитайте `Read` на пути к файлу вывода задачи | Нет |47| `TaskOutput` | Получает вывод из фоновой задачи. Устарело в пользу `Read` на пути к файлу вывода задачи. {/* min-version: 2.1.203 */}Когда ни одна задача не соответствует ID, ошибка выводит список выполняющихся фоновых агентов по ID и описанию. До версии 2.1.203 ошибка называла только отсутствующий ID | Нет |

48| `TaskStop` | Завершает выполняющуюся фоновую задачу по ID. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, также принимает [товарища по команде агентов](/ru/agent-teams) или именованного фонового агента по ID агента или имени | Нет |48| `TaskStop` | Останавливает выполняющуюся фоновую задачу по ID. {/* min-version: 2.1.198 */}Также принимает [товарища по команде агентов](/ru/agent-teams) или именованного фонового агента по ID агента или имени. До версии 2.1.198 принимал только ID фоновой задачи. {/* min-version: 2.1.203 */}Когда ни одна задача не соответствует ID, ошибка выводит список выполняющихся фоновых агентов по ID и описанию, включая агентов, которых запустил другой агент. До версии 2.1.203 ошибка выводила список выполняющихся товарищей по команде и именованных агентов, но не фоновых агентов, которых запустил другой агент, поэтому их нельзя было идентифицировать или остановить из основного разговора | Нет |

49| `TaskUpdate` | Обновляет статус задачи, зависимости, сведения или удаляет задачи | Нет |49| `TaskUpdate` | Обновляет статус задачи, зависимости, сведения или удаляет задачи | Нет |

50| `TodoWrite` | {/* min-version: 2.1.142 */}Управляет контрольным списком задач сеанса. Отключено по умолчанию начиная с версии 2.1.142 в пользу `TaskCreate`, `TaskGet`, `TaskList` и `TaskUpdate`. Установите `CLAUDE_CODE_ENABLE_TASKS=0` для повторного включения | Нет |50| `TodoWrite` | {/* min-version: 2.1.142 */}Управляет контрольным списком задач сеанса. Отключено по умолчанию начиная с версии 2.1.142 в пользу `TaskCreate`, `TaskGet`, `TaskList` и `TaskUpdate`. Установите `CLAUDE_CODE_ENABLE_TASKS=0` для повторного включения | Нет |

51| `ToolSearch` | Ищет и загружает отложенные инструменты, когда включен [поиск инструментов](/ru/mcp#scale-with-mcp-tool-search) | Нет |51| `ToolSearch` | Ищет и загружает отложенные инструменты, когда включен [поиск инструментов](/ru/mcp#scale-with-mcp-tool-search) | Нет |


220 220 

221Когда Monitor запускает команду, он использует те же [правила разрешений, что и Bash](/ru/permissions#tool-specific-permission-rules), поэтому шаблоны `allow` и `deny`, которые вы установили для Bash, применяются здесь также. [Источник WebSocket](#websocket-source) имеет собственное приглашение на одобрение.221Когда Monitor запускает команду, он использует те же [правила разрешений, что и Bash](/ru/permissions#tool-specific-permission-rules), поэтому шаблоны `allow` и `deny`, которые вы установили для Bash, применяются здесь также. [Источник WebSocket](#websocket-source) имеет собственное приглашение на одобрение.

222 222 

223Инструмент недоступен на Amazon Bedrock, Google Vertex AI или Microsoft Foundry. Он также недоступен, когда установлены `DISABLE_TELEMETRY` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`.223Инструмент недоступен на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Он также недоступен, когда установлены `DISABLE_TELEMETRY` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`.

224 224 

225Плагины могут объявлять мониторы, которые запускаются автоматически при активации плагина, вместо того чтобы просить Claude запустить их. См. [мониторы плагинов](/ru/plugins-reference#monitors).225Плагины могут объявлять мониторы, которые запускаются автоматически при активации плагина, вместо того чтобы просить Claude запустить их. См. [мониторы плагинов](/ru/plugins-reference#monitors).

226 226 


371Правила разрешений WebSearch не принимают спецификатор. Запись `WebSearch` в `allow` или `deny` — это единственная форма.371Правила разрешений WebSearch не принимают спецификатор. Запись `WebSearch` в `allow` или `deny` — это единственная форма.

372 372 

373<Note>373<Note>

374 WebSearch доступен на Claude API, [Claude Platform on AWS](/ru/claude-platform-on-aws) и Microsoft Foundry. На Google Cloud Vertex AI он работает с моделями Claude 4 и более поздними версиями, включая Opus, Sonnet и Haiku. Amazon Bedrock не предоставляет инструмент веб-поиска на стороне сервера.374 WebSearch доступен на Claude API, [Claude Platform on AWS](/ru/claude-platform-on-aws) и Microsoft Foundry. На Google Cloud's Agent Platform он работает с моделями Claude 4 и более поздними версиями, включая Opus, Sonnet и Haiku. Amazon Bedrock не предоставляет инструмент веб-поиска на стороне сервера.

375</Note>375</Note>

376 376 

377<h2 id="write-tool-behavior">377<h2 id="write-tool-behavior">

Details

15Сопоставьте сообщение об ошибке или симптом, который вы видите, с исправлением:15Сопоставьте сообщение об ошибке или симптом, который вы видите, с исправлением:

16 16 

17| Что вы видите | Решение |17| Что вы видите | Решение |

18| :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |18| :--------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |

19| `command not found: claude` или `'claude' is not recognized` | [Исправьте ваш PATH](#command-not-found-claude-after-installation) |19| `command not found: claude` или `'claude' is not recognized` | [Исправьте ваш PATH](#command-not-found-claude-after-installation) |

20| `syntax error near unexpected token '<'` | [Install script returns HTML](#install-script-returns-html-instead-of-a-shell-script) |20| `syntax error near unexpected token '<'` | [Install script returns HTML](#install-script-returns-html-instead-of-a-shell-script) |

21| `curl: (22) The requested URL returned error: 403` | [Install script returned 403](#install-script-returns-html-instead-of-a-shell-script) |21| `curl: (22) The requested URL returned error: 403` | [Install script returned 403](#install-script-returns-html-instead-of-a-shell-script) |

22| `curl: (23)` или `curl: (56) Failure writing output to destination` | [Проверьте подключение или используйте альтернативный установщик](#curl-56-failure-writing-output-to-destination) |22| `curl: (23)` или `curl: (56) Failure writing output to destination` | [Проверьте подключение или используйте альтернативный установщик](#curl-56-failure-writing-output-to-destination) |

23| `Killed` во время установки на Linux | [Добавьте пространство подкачки для серверов с низкой памятью](#install-killed-on-low-memory-linux-servers) |23| `Killed` во время установки на Linux, или `Installation was killed before it could finish (exit code 137)` | [Освободите память или добавьте пространство подкачки](#install-killed-on-low-memory-linux-servers) |

24| `TLS connect error` или `SSL/TLS secure channel` | [Обновите сертификаты CA](#tls-or-ssl-connection-errors) |24| `TLS connect error` или `SSL/TLS secure channel` | [Обновите сертификаты CA](#tls-or-ssl-connection-errors) |

25| `Failed to fetch version` или невозможно достичь сервера загрузки | [Проверьте параметры сети и прокси](#check-network-connectivity) |25| `Failed to fetch version` или невозможно достичь сервера загрузки | [Проверьте параметры сети и прокси](#check-network-connectivity) |

26| `irm is not recognized` или `&& is not valid` | [Используйте правильную команду для вашей оболочки](#wrong-install-command-on-windows) |26| `irm is not recognized` или `&& is not valid` | [Используйте правильную команду для вашей оболочки](#wrong-install-command-on-windows) |


39| `App unavailable in region` | Claude Code недоступен в вашей стране. См. [поддерживаемые страны](https://www.anthropic.com/supported-countries). |39| `App unavailable in region` | Claude Code недоступен в вашей стране. См. [поддерживаемые страны](https://www.anthropic.com/supported-countries). |

40| `unable to get local issuer certificate` | [Настройте корпоративные сертификаты CA](#tls-or-ssl-connection-errors) |40| `unable to get local issuer certificate` | [Настройте корпоративные сертификаты CA](#tls-or-ssl-connection-errors) |

41| `OAuth error` или `403 Forbidden` | [Исправьте аутентификацию](#login-and-authentication) |41| `OAuth error` или `403 Forbidden` | [Исправьте аутентификацию](#login-and-authentication) |

42| `Could not load the default credentials` или `Could not load credentials from any providers` | [Bedrock, Vertex или Foundry credentials](#bedrock-vertex-or-foundry-credentials-not-loading) |42| `Could not load the default credentials` или `Could not load credentials from any providers` | [Учетные данные Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

43| `ChainedTokenCredential authentication failed` или `CredentialUnavailableError` | [Bedrock, Vertex или Foundry credentials](#bedrock-vertex-or-foundry-credentials-not-loading) |43| `ChainedTokenCredential authentication failed` или `CredentialUnavailableError` | [Учетные данные Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

44| `API Error: 500`, `529 Overloaded`, `429` или другие ошибки 4xx и 5xx, не указанные выше | См. [справочник ошибок](/ru/errors) |44| `API Error: 500`, `529 Overloaded`, `429` или другие ошибки 4xx и 5xx, не указанные выше | См. [справочник ошибок](/ru/errors) |

45 45 

46Если вашей проблемы нет в списке, выполните диагностические проверки ниже, чтобы сузить причину.46Если вашей проблемы нет в списке, выполните диагностические проверки ниже, чтобы сузить причину.


333curl: (22) The requested URL returned error: 403333curl: (22) The requested URL returned error: 403

334```334```

335 335 

336Всё это означает, что URL установки вернул HTML-страницу или статус ошибки вместо скрипта установки. Если HTML-страница говорит "App unavailable in region", Claude Code недоступен в вашей стране. См. [supported countries](https://www.anthropic.com/supported-countries).336Всё это означает, что URL установки вернул HTML-страницу или статус ошибки вместо скрипта установки. Если HTML-страница говорит "App unavailable in region", Claude Code недоступен в вашей стране. См. [поддерживаемые страны](https://www.anthropic.com/supported-countries).

337 337 

338Простой 403 без тела часто имеет ту же причину, но это также может быть вызвано корпоративным прокси или брандмауэром, блокирующим загрузку. Если вы находитесь в поддерживаемой стране и всё ещё видите 403, пройдите через [Check network connectivity](#check-network-connectivity) перед попыткой альтернативных установщиков ниже, так как они достигают тех же хостов.338Простой 403 без тела часто имеет ту же причину, но это также может быть вызвано корпоративным прокси или брандмауэром, блокирующим загрузку. Если вы находитесь в поддерживаемой стране и всё ещё видите 403, пройдите через [Проверка подключения к сети](#check-network-connectivity) перед попыткой альтернативных установщиков ниже, так как они достигают тех же хостов.

339 339 

340В противном случае это может произойти из-за проблем с сетью, региональной маршрутизации или временного сбоя сервиса.340В противном случае это может произойти из-за проблем с сетью, региональной маршрутизации или временного сбоя сервиса.

341 341 


370| Windows CMD | `'claude' is not recognized as an internal or external command` |370| Windows CMD | `'claude' is not recognized as an internal or external command` |

371| PowerShell | `claude : The term 'claude' is not recognized as the name of a cmdlet` |371| PowerShell | `claude : The term 'claude' is not recognized as the name of a cmdlet` |

372 372 

373Это означает, что директория установки не находится в пути поиска вашей оболочки. См. [Verify your PATH](#verify-your-path) для исправления на каждой платформе.373Это означает, что директория установки не находится в пути поиска вашей оболочки. См. [Проверка вашего PATH](#verify-your-path) для исправления на каждой платформе.

374 374 

375<h3 id="curl-56-failure-writing-output-to-destination">375<h3 id="curl-56-failure-writing-output-to-destination">

376 `curl: (56) Failure writing output to destination`376 `curl: (56) Failure writing output to destination`


411brew install --cask claude-code411brew install --cask claude-code

412```412```

413 413 

414Если Homebrew устанавливает более старую версию Claude Code, чем вы ожидаете, обычно причина в том же устаревшем индексе. Cask `claude-code` отслеживает стабильный канал и обычно отстаёт на неделю от последнего выпуска; для самой новой версии запустите вместо этого `brew install --cask claude-code@latest`. См. [Configure release channel](/ru/setup#configure-release-channel) для различия между двумя cask.414Если Homebrew устанавливает более старую версию Claude Code, чем вы ожидаете, обычно причина в том же устаревшем индексе. Cask `claude-code` отслеживает стабильный канал и обычно отстаёт на неделю от последнего выпуска; для самой новой версии запустите вместо этого `brew install --cask claude-code@latest`. См. [Настройка канала выпуска](/ru/setup#configure-release-channel) для различия между двумя cask.

415 415 

416<h3 id="tls-or-ssl-connection-errors">416<h3 id="tls-or-ssl-connection-errors">

417 TLS or SSL connection errors417 TLS or SSL connection errors


466 curl -sI https://downloads.claude.ai/claude-code-releases/latest466 curl -sI https://downloads.claude.ai/claude-code-releases/latest

467 ```467 ```

468 468 

4692. **Если за прокси**, установите `HTTPS_PROXY` так, чтобы установщик мог маршрутизировать через него. См. [proxy configuration](/ru/network-config#proxy-configuration) для деталей.4692. **Если за прокси**, установите `HTTPS_PROXY` так, чтобы установщик мог маршрутизировать через него. См. [конфигурация прокси](/ru/network-config#proxy-configuration) для деталей.

470 ```bash theme={null}470 ```bash theme={null}

471 export HTTPS_PROXY=http://proxy.example.com:8080471 export HTTPS_PROXY=http://proxy.example.com:8080

472 curl -fsSL https://claude.ai/install.sh | bash472 curl -fsSL https://claude.ai/install.sh | bash


538 Install killed on low-memory Linux servers538 Install killed on low-memory Linux servers

539</h3>539</h3>

540 540 

541Если вы видите `Killed` во время установки на VPS или облачном экземпляре:541Сообщение `Killed` во время установки обычно означает, что убийца Linux out-of-memory (OOM) завершил шаг `claude install`, потому что система исчерпала свободную память. Это распространено на небольших VPS и облачных экземплярах. Скрипт установки сообщает причину и выходит с кодом 137:

542 542 

543```text theme={null}543```text theme={null}

544Setting up Claude Code...544Setting up Claude Code...

545Installing Claude Code native build latest...

546bash: line 142: 34803 Killed "$binary_path" install ${TARGET:+"$TARGET"}545bash: line 142: 34803 Killed "$binary_path" install ${TARGET:+"$TARGET"}

546Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

547Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

547```548```

548 549 

549Убийца OOM Linux завершил процесс, потому что система исчерпала память. Claude Code требует по крайней мере 4 ГБ доступной оперативной памяти.550До v2.1.200 скрипт выходил только с голой строкой `Killed` оболочки и без объяснения.

551 

552Установка требует примерно 512 МБ свободной памяти, а запуск Claude Code требует больше. См. [системные требования](/ru/setup#system-requirements).

550 553 

551**Решения:**554**Решения:**

552 555 


636 639 

637Если это выводит `True`, ваша операционная система в порядке. Закройте окно, откройте `Windows PowerShell` без суффикса x86 и запустите команду установки снова.640Если это выводит `True`, ваша операционная система в порядке. Закройте окно, откройте `Windows PowerShell` без суффикса x86 и запустите команду установки снова.

638 641 

639Если это выводит `False`, вы находитесь на 32-битном издании Windows. Claude Code требует 64-битную операционную систему. См. [system requirements](/ru/setup#system-requirements).642Если это выводит `False`, вы находитесь на 32-битном издании Windows. Claude Code требует 64-битную операционную систему. См. [системные требования](/ru/setup#system-requirements).

640 643 

641<h3 id="linux-musl-or-glibc-binary-mismatch">644<h3 id="linux-musl-or-glibc-binary-mismatch">

642 Linux musl or glibc binary mismatch645 Linux musl or glibc binary mismatch


766 Permission errors during installation769 Permission errors during installation

767</h3>770</h3>

768 771 

769Если встроенный установщик не удаётся с ошибками разрешений, целевая директория может быть недоступна для записи. См. [Check directory permissions](#check-directory-permissions).772Если встроенный установщик не удаётся с ошибками разрешений, целевая директория может быть недоступна для записи. См. [Проверка разрешений директории](#check-directory-permissions).

770 773 

771Если вы ранее установили с npm и получаете ошибки разрешений, специфичные для npm, переключитесь на встроенный установщик:774Если вы ранее установили с npm и получаете ошибки разрешений, специфичные для npm, переключитесь на встроенный установщик:

772 775 


781Пакет npm `@anthropic-ai/claude-code` получает встроенный бинарный файл через зависимость, специфичную для платформы, такую как `@anthropic-ai/claude-code-darwin-arm64`. Если запуск `claude` после установки выводит `Could not find native binary package "@anthropic-ai/claude-code-<platform>"`, проверьте следующие причины:784Пакет npm `@anthropic-ai/claude-code` получает встроенный бинарный файл через зависимость, специфичную для платформы, такую как `@anthropic-ai/claude-code-darwin-arm64`. Если запуск `claude` после установки выводит `Could not find native binary package "@anthropic-ai/claude-code-<platform>"`, проверьте следующие причины:

782 785 

783* **Опциональные зависимости отключены.** Удалите `--omit=optional` из вашей команды npm install, `--no-optional` из pnpm или `--ignore-optional` из yarn, и проверьте, что `.npmrc` не устанавливает `optional=false`. Затем переустановите. Встроенный бинарный файл доставляется только как опциональная зависимость, поэтому нет JavaScript fallback, если он пропущен.786* **Опциональные зависимости отключены.** Удалите `--omit=optional` из вашей команды npm install, `--no-optional` из pnpm или `--ignore-optional` из yarn, и проверьте, что `.npmrc` не устанавливает `optional=false`. Затем переустановите. Встроенный бинарный файл доставляется только как опциональная зависимость, поэтому нет JavaScript fallback, если он пропущен.

784* **Неподдерживаемая платформа.** Предварительно собранные бинарные файлы опубликованы для `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` и `win32-arm64`. Claude Code не поставляет бинарный файл для других платформ; см. [system requirements](/ru/setup#system-requirements).787* **Неподдерживаемая платформа.** Предварительно собранные бинарные файлы опубликованы для `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` и `win32-arm64`. Claude Code не поставляет бинарный файл для других платформ; см. [системные требования](/ru/setup#system-requirements). {/* min-version: 2.1.205 */}На FreeBSD установщик сообщает платформу как неподдерживаемую. До v2.1.205 он рассматривал FreeBSD как Linux и загружал бинарный файл, который не мог работать.

785* **Корпоративное зеркало npm отсутствуют пакеты платформы.** Убедитесь, что ваш реестр зеркалирует все восемь пакетов `@anthropic-ai/claude-code-*` платформы в дополнение к мета-пакету.788* **Корпоративное зеркало npm отсутствуют пакеты платформы.** Убедитесь, что ваш реестр зеркалирует все восемь пакетов `@anthropic-ai/claude-code-*` платформы в дополнение к мета-пакету.

786 789 

787Установка с `--ignore-scripts` не вызывает эту ошибку. Шаг postinstall, который связывает бинарный файл на место, пропускается, поэтому Claude Code возвращается к обёртке, которая находит и порождает бинарный файл платформы при каждом запуске. Это работает, но запускается медленнее; переустановите со скриптами, включёнными для прямого выполнения.790Установка с `--ignore-scripts` не вызывает эту ошибку. Шаг postinstall, который связывает бинарный файл на место, пропускается, поэтому Claude Code возвращается к обёртке, которая находит и порождает бинарный файл платформы при каждом запуске. Это работает, но запускается медленнее; переустановите со скриптами, включёнными для прямого выполнения.


876 879 

877На macOS вход также может не удаться, когда Keychain заблокирован или его пароль не синхронизирован с паролем вашей учётной записи, что предотвращает Claude Code от сохранения учётных данных. Запустите `claude doctor`, чтобы проверить доступ Keychain. Чтобы разблокировать Keychain вручную, запустите `security unlock-keychain ~/Library/Keychains/login.keychain-db`. Если разблокировка не помогает, откройте Keychain Access, выберите keychain `login` и выберите Edit > Change Password for Keychain "login", чтобы пересинхронизировать его с паролем вашей учётной записи.880На macOS вход также может не удаться, когда Keychain заблокирован или его пароль не синхронизирован с паролем вашей учётной записи, что предотвращает Claude Code от сохранения учётных данных. Запустите `claude doctor`, чтобы проверить доступ Keychain. Чтобы разблокировать Keychain вручную, запустите `security unlock-keychain ~/Library/Keychains/login.keychain-db`. Если разблокировка не помогает, откройте Keychain Access, выберите keychain `login` и выберите Edit > Change Password for Keychain "login", чтобы пересинхронизировать его с паролем вашей учётной записи.

878 881 

879<h3 id="bedrock-vertex-or-foundry-credentials-not-loading">882<h3 id="bedrock-agent-platform-or-foundry-credentials-not-loading">

880 Bedrock, Vertex, or Foundry credentials not loading883 Bedrock, Agent Platform, or Foundry credentials not loading

881</h3>884</h3>

882 885 

883Если вы настроили Claude Code для использования облачного провайдера и видите `Could not load credentials from any providers` на Bedrock, `Could not load the default credentials` на Vertex или `ChainedTokenCredential authentication failed` на Foundry, ваш CLI облачного провайдера вероятно не аутентифицирован в текущей оболочке.886Если вы настроили Claude Code для использования облачного провайдера и видите `Could not load credentials from any providers` на Amazon Bedrock, `Could not load the default credentials` на Google Cloud's Agent Platform или `ChainedTokenCredential authentication failed` на Microsoft Foundry, ваш CLI облачного провайдера вероятно не аутентифицирован в текущей оболочке.

884 887 

885Для Bedrock подтвердите, что ваши учётные данные AWS действительны:888Для Amazon Bedrock подтвердите, что ваши учётные данные AWS действительны:

886 889 

887```bash theme={null}890```bash theme={null}

888aws sts get-caller-identity891aws sts get-caller-identity

889```892```

890 893 

891Для Vertex AI подтвердите, что `ANTHROPIC_VERTEX_PROJECT_ID` и `CLOUD_ML_REGION` установлены в вашей оболочке, затем установите учётные данные приложения по умолчанию:894Для Google Cloud's Agent Platform подтвердите, что `ANTHROPIC_VERTEX_PROJECT_ID` и `CLOUD_ML_REGION` установлены в вашей оболочке, затем установите учётные данные приложения по умолчанию:

892 895 

893```bash theme={null}896```bash theme={null}

894gcloud auth application-default login897gcloud auth application-default login


902 905 

903Если учётные данные работают в вашем терминале, но не в расширении VS Code или JetBrains, процесс IDE вероятно не унаследовал вашу среду оболочки. Установите переменные окружения провайдера в собственных параметрах IDE или запустите IDE из терминала, где они уже экспортированы.906Если учётные данные работают в вашем терминале, но не в расширении VS Code или JetBrains, процесс IDE вероятно не унаследовал вашу среду оболочки. Установите переменные окружения провайдера в собственных параметрах IDE или запустите IDE из терминала, где они уже экспортированы.

904 907 

905См. [Amazon Bedrock](/ru/amazon-bedrock), [Google Vertex AI](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry) для полной настройки провайдера.908См. [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry) для полной настройки провайдера.

906 909 

907<h2 id="still-stuck">910<h2 id="still-stuck">

908 Still stuck911 Still stuck

Details

9Эта страница охватывает проблемы производительности, стабильности и поиска после того, как Claude Code запущен. Для других проблем начните со страницы, которая соответствует тому, где вы застряли:9Эта страница охватывает проблемы производительности, стабильности и поиска после того, как Claude Code запущен. Для других проблем начните со страницы, которая соответствует тому, где вы застряли:

10 10 

11| Симптом | Перейти к |11| Симптом | Перейти к |

12| :--------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------- |12| :------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------- |

13| `command not found`, ошибка установки, проблемы PATH, `EACCES`, ошибки TLS | [Troubleshoot installation and login](/ru/troubleshoot-install) |13| `command not found`, ошибка установки, проблемы PATH, `EACCES`, ошибки TLS | [Troubleshoot installation and login](/ru/troubleshoot-install) |

14| Циклы входа, ошибки OAuth, `403 Forbidden`, "organization disabled", учётные данные Bedrock/Vertex/Foundry | [Troubleshoot installation and login](/ru/troubleshoot-install#login-and-authentication) |14| Обновление или установка загрузки не удаётся с `The connection dropped while downloading the update` или `aborted` | [Error reference](/ru/errors#the-connection-dropped-while-downloading-the-update) |

15| Циклы входа, ошибки OAuth, `403 Forbidden`, "organization disabled", учётные данные Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry | [Troubleshoot installation and login](/ru/troubleshoot-install#login-and-authentication) |

15| Параметры не применяются, hooks не срабатывают, MCP servers не загружаются | [Debug your configuration](/ru/debug-your-config) |16| Параметры не применяются, hooks не срабатывают, MCP servers не загружаются | [Debug your configuration](/ru/debug-your-config) |

16| `API Error: 5xx`, `529 Overloaded`, `429`, ошибки валидации запроса | [Error reference](/ru/errors) |17| `API Error: 5xx`, `529 Overloaded`, `429`, ошибки валидации запроса | [Error reference](/ru/errors) |

17| `model not found` или `you may not have access to it` | [Error reference](/ru/errors#there%E2%80%99s-an-issue-with-the-selected-model) |18| `model not found` или `you may not have access to it` | [Error reference](/ru/errors#there%E2%80%99s-an-issue-with-the-selected-model) |


19| Плагин JetBrains или IDE не обнаружена | [JetBrains integration](/ru/jetbrains#troubleshooting) |20| Плагин JetBrains или IDE не обнаружена | [JetBrains integration](/ru/jetbrains#troubleshooting) |

20| Высокое использование CPU или памяти, медленные ответы, зависания, поиск не находит файлы | [Performance and stability](#performance-and-stability) ниже |21| Высокое использование CPU или памяти, медленные ответы, зависания, поиск не находит файлы | [Performance and stability](#performance-and-stability) ниже |

21 22 

22Если вы не уверены, какой применяется, запустите `/doctor` внутри Claude Code для автоматической проверки вашей установки, параметров, MCP servers и использования контекста. Если `claude` вообще не запускается, запустите `claude doctor` из вашей оболочки вместо этого.23Если вы не уверены, какой применяется, запустите `/doctor` внутри Claude Code для автоматической проверки вашей установки, параметров, расширений и использования контекста; он предлагает исправления, которые может применить после вашего подтверждения. Если `claude` вообще не запускается, запустите `claude doctor` из вашей оболочки вместо этого. Запустите `/mcp` для проверки статуса MCP server.

23 24 

24<h2 id="performance-and-stability">25<h2 id="performance-and-stability">

25 Performance and stability26 Performance and stability


119Штрафы производительности чтения диска при [работе с файловыми системами на WSL](https://learn.microsoft.com/en-us/windows/wsl/filesystems) могут привести к меньшему количеству совпадений, чем ожидается, при использовании Claude Code на WSL. Поиск всё ещё функционирует, но возвращает меньше результатов, чем на собственной файловой системе.120Штрафы производительности чтения диска при [работе с файловыми системами на WSL](https://learn.microsoft.com/en-us/windows/wsl/filesystems) могут привести к меньшему количеству совпадений, чем ожидается, при использовании Claude Code на WSL. Поиск всё ещё функционирует, но возвращает меньше результатов, чем на собственной файловой системе.

120 121 

121<Note>122<Note>

122 `/doctor` будет показывать Search как OK в этом случае.123 `claude doctor` показывает Search как OK в этом случае.

123</Note>124</Note>

124 125 

125**Решения:**126**Решения:**


136 137 

137Если вы испытываете проблемы, не охватываемые здесь:138Если вы испытываете проблемы, не охватываемые здесь:

138 139 

1391. Запустите `/doctor`, чтобы проверить здоровье установки, валидность параметров, конфигурацию MCP и использование контекста в одном проходе1401. Запустите `/doctor` для проверки установки и `/mcp` для проверки статуса MCP сервера

1402. Используйте команду `/feedback` в Claude Code, чтобы сообщить о проблемах непосредственно в Anthropic1412. Используйте команду `/feedback` в Claude Code, чтобы сообщить о проблемах непосредственно в Anthropic

1413. Проверьте [репозиторий GitHub](https://github.com/anthropics/claude-code) на известные проблемы1423. Проверьте [репозиторий GitHub](https://github.com/anthropics/claude-code) на известные проблемы

1424. Спросите Claude напрямую о его возможностях и функциях. Claude имеет встроенный доступ к своей документации.1434. Спросите Claude напрямую о его возможностях и функциях. Claude имеет встроенный доступ к своей документации.

ultraplan.md +1 −1

Details

18* **Удалённое создание**: план создаётся удалённо, поэтому ваш терминал остаётся свободным для другой работы18* **Удалённое создание**: план создаётся удалённо, поэтому ваш терминал остаётся свободным для другой работы

19* **Гибкое выполнение**: одобрите план для запуска в веб-интерфейсе и откройте pull request, или отправьте его обратно в терминал19* **Гибкое выполнение**: одобрите план для запуска в веб-интерфейсе и откройте pull request, или отправьте его обратно в терминал

20 20 

21Ultraplan требует учётную запись [Claude Code в веб-интерфейсе](/ru/claude-code-on-the-web) и репозиторий GitHub. Поскольку он работает на облачной инфраструктуре Anthropic, он недоступен при использовании Amazon Bedrock, Google Cloud Vertex AI или Microsoft Foundry. Облачный сеанс работает в [облачной среде](/ru/claude-code-on-the-web#the-cloud-environment) по умолчанию вашей учётной записи. Если у вас ещё нет облачной среды, ultraplan создаст её автоматически при первом запуске.21Ultraplan требует учётную запись [Claude Code в веб-интерфейсе](/ru/claude-code-on-the-web) и репозиторий GitHub. Поскольку он работает на облачной инфраструктуре Anthropic, он недоступен при использовании Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Облачный сеанс работает в [облачной среде](/ru/claude-code-on-the-web#the-cloud-environment) по умолчанию вашей учётной записи. Если у вас ещё нет облачной среды, ultraplan создаст её автоматически при первом запуске.

22 22 

23<h2 id="launch-ultraplan-from-the-cli">23<h2 id="launch-ultraplan-from-the-cli">

24 Запуск ultraplan из CLI24 Запуск ultraplan из CLI

ultrareview.md +4 −4

Details

15По сравнению с локальным `/code-review` или `/review`, ultrareview предлагает:15По сравнению с локальным `/code-review` или `/review`, ultrareview предлагает:

16 16 

17* **Более высокий сигнал**: каждый найденный результат независимо воспроизводится и проверяется, поэтому результаты сосредоточены на реальных ошибках, а не на предложениях по стилю17* **Более высокий сигнал**: каждый найденный результат независимо воспроизводится и проверяется, поэтому результаты сосредоточены на реальных ошибках, а не на предложениях по стилю

18* **Более широкое покрытие**: более крупный флот агентов-рецензентов исследует изменение параллельно, что выявляет проблемы, которые может пропустить анализ среднего уровня усилий18* **Более широкое покрытие**: более крупный флот агентов-рецензентов исследует изменение параллельно, что выявляет проблемы, которые может пропустить локальный анализ

19* **Без использования локальных ресурсов**: анализ работает полностью в удаленной изолированной среде, поэтому ваш терминал остается свободным для другой работы во время его выполнения19* **Без использования локальных ресурсов**: анализ работает полностью в удаленной изолированной среде, поэтому ваш терминал остается свободным для другой работы во время его выполнения

20 20 

21Ultrareview требует аутентификации с помощью учетной записи Claude.ai, так как работает на Claude Code в облачной инфраструктуре. Если вы вошли только с помощью ключа API, запустите `/login` и сначала аутентифицируйтесь с помощью Claude.ai. Ultrareview недоступен при использовании Claude Code с Amazon Bedrock, Google Cloud Vertex AI или Microsoft Foundry, а также недоступен для организаций, которые включили Zero Data Retention.21Ultrareview требует аутентификации с помощью учетной записи Claude.ai, так как работает на Claude Code в облачной инфраструктуре. Если вы вошли только с помощью ключа API, запустите `/login` и сначала аутентифицируйтесь с помощью Claude.ai. Ultrareview недоступен при использовании Claude Code с Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, а также недоступен для организаций, которые включили Zero Data Retention.

22 22 

23<h2 id="run-ultrareview-from-the-cli">23<h2 id="run-ultrareview-from-the-cli">

24 Запуск ultrareview из CLI24 Запуск ultrareview из CLI


107| ----------------- | ----------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------ |107| ----------------- | ----------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------ |

108| Цель | ваш рабочий diff | pull request на GitHub | ваш рабочий diff или pull request |108| Цель | ваш рабочий diff | pull request на GitHub | ваш рабочий diff или pull request |

109| Запуск | локально в вашей сессии | локально в вашей сессии | удаленно в облачной изолированной среде |109| Запуск | локально в вашей сессии | локально в вашей сессии | удаленно в облачной изолированной среде |

110| Глубина | масштабируется с аргументом effort | средний движок `/code-review` | многоагентный флот с независимой проверкой |110| Глубина | масштабируется с аргументом effort | однопроходный анализ на уровне effort сессии | многоагентный флот с независимой проверкой |

111| Продолжительность | секунды до нескольких минут | несколько минут | примерно 5–10 минут |111| Продолжительность | секунды до нескольких минут | секунды до нескольких минут | примерно 5–10 минут |

112| Стоимость | учитывается в обычном использовании | учитывается в обычном использовании | бесплатные запуски, затем примерно $5–$20 за анализ как дополнительное использование |112| Стоимость | учитывается в обычном использовании | учитывается в обычном использовании | бесплатные запуски, затем примерно $5–$20 за анализ как дополнительное использование |

113| Лучше всего для | быстрая обратная связь при итерации | анализ pull request коллеги перед одобрением | уверенность перед слиянием при существенных изменениях |113| Лучше всего для | быстрая обратная связь при итерации | анализ pull request коллеги перед одобрением | уверенность перед слиянием при существенных изменениях |

114 114 

Details

20 20 

21Голосовой ввод передает вашу записанную речь на серверы Anthropic для транскрибирования. Аудио не обрабатывается локально. Для этого требуется все следующее:21Голосовой ввод передает вашу записанную речь на серверы Anthropic для транскрибирования. Аудио не обрабатывается локально. Для этого требуется все следующее:

22 22 

23* **Учетная запись Claude.ai**: служба преобразования речи в текст доступна только при аутентификации с помощью учетной записи Claude.ai и недоступна, когда Claude Code настроен на использование ключа Anthropic API напрямую, Amazon Bedrock, Google Vertex AI или Microsoft Foundry.23* **Учетная запись Claude.ai**: служба преобразования речи в текст доступна только при аутентификации с помощью учетной записи Claude.ai и недоступна, когда Claude Code настроен на использование ключа Anthropic API напрямую, Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.

24* **Организация без включенного соответствия HIPAA**: `/voice` показывает `Voice mode is disabled by your organization's policy`, когда применяется это ограничение.24* **Организация без включенного соответствия HIPAA**: `/voice` показывает `Voice mode is disabled by your organization's policy`, когда применяется это ограничение.

25* **Локальный микрофон**: голосовой ввод не работает в удаленных окружениях, таких как [Claude Code в веб-браузере](/ru/claude-code-on-the-web) или сеансы SSH.25* **Локальный микрофон**: голосовой ввод не работает в удаленных окружениях, таких как [Claude Code в веб-браузере](/ru/claude-code-on-the-web) или сеансы SSH.

26* **WSLg, если вы запускаете Claude Code в WSL**: WSLg включен в WSL2 при установке из Microsoft Store на Windows 10 или 11. Если WSLg недоступен, например на WSL1, запустите Claude Code в собственной Windows.26* **WSLg, если вы запускаете Claude Code в WSL**: WSLg включен в WSL2 при установке из Microsoft Store на Windows 10 или 11. Если WSLg недоступен, например на WSL1, запустите Claude Code в собственной Windows.


183* **`No audio recording tool found`** на Linux: собственный модуль аудио не может загрузиться и резервный вариант не установлен. Установите SoX с помощью команды, показанной в сообщении об ошибке, например `sudo apt-get install sox`.183* **`No audio recording tool found`** на Linux: собственный модуль аудио не может загрузиться и резервный вариант не установлен. Установите SoX с помощью команды, показанной в сообщении об ошибке, например `sudo apt-get install sox`.

184* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX установлен, но хост не имеет устройства захвата аудио, например безголовый сервер или контейнер. Запустите Claude Code на машине с микрофоном. {/* min-version: 2.1.195 */}Начиная с версии 2.1.195, Claude Code на Linux выводит это сообщение в такой ситуации; более ранние версии просили вас установить SoX даже когда он уже был установлен.184* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX установлен, но хост не имеет устройства захвата аудио, например безголовый сервер или контейнер. Запустите Claude Code на машине с микрофоном. {/* min-version: 2.1.195 */}Начиная с версии 2.1.195, Claude Code на Linux выводит это сообщение в такой ситуации; более ранние версии просили вас установить SoX даже когда он уже был установлен.

185* **`Voice mode could not find a working audio recorder in WSL`**: WSLg маршрутизирует аудио через PulseAudio вместо устройства ALSA, поэтому SoX требует явной установки его бэкенда PulseAudio. Запустите `sudo apt install sox libsox-fmt-pulse`. Установка только `sox` подтягивает бэкенд ALSA, который не может записывать на WSL, потому что нет устройства `/dev/snd`.185* **`Voice mode could not find a working audio recorder in WSL`**: WSLg маршрутизирует аудио через PulseAudio вместо устройства ALSA, поэтому SoX требует явной установки его бэкенда PulseAudio. Запустите `sudo apt install sox libsox-fmt-pulse`. Установка только `sox` подтягивает бэкенд ALSA, который не может записывать на WSL, потому что нет устройства `/dev/snd`.

186* **`Voice input is failing repeatedly and has been paused`**: голосовой ввод столкнулся с несколькими сбоями при запуске подряд и прекратил попытки новых сеансов до тех пор, пока один не будет успешным. Это обычно означает, что микрофон или звуковой стек на этом хосте не может захватить аудио, например безголовый сервер, удаленная оболочка без передачи аудио или запрещенное разрешение микрофона. Подтвердите работающее устройство ввода, исправьте основную причину из записей выше, затем снова активируйте голосовой ввод.186* **`Voice input is failing repeatedly and has been paused`**: голосовой ввод столкнулся с несколькими сбоями при запуске подряд и прекратил попытки новых сеансов до тех пор, пока один не будет успешным. Сбой считается независимо от того, не удается ли микрофону запуститься или рекордер запускается, а затем останавливается без создания какого-либо аудио. Это обычно означает, что микрофон или звуковой стек на этом хосте не может захватить аудио, например безголовый сервер, удаленная оболочка без передачи аудио или запрещенное разрешение микрофона. Подтвердите работающее устройство ввода, исправьте основную причину из записей выше, затем снова активируйте голосовой ввод. {/* min-version: 2.1.202 */}До версии 2.1.202 только сбои при запуске учитывались при паузе.

187* **Ничего не происходит при удержании `Space` в режиме удержания**: смотрите на поле ввода запроса, пока вы удерживаете. Если пробелы продолжают накапливаться, голосовой ввод, вероятно, отключен; запустите `/voice hold` для включения. Если появляется только один или два пробела, а затем ничего, голосовой ввод включен, но обнаружение удержания не срабатывает. Обнаружение удержания требует, чтобы ваш терминал отправлял события повтора клавиш, поэтому он не может обнаружить удерживаемую клавишу, если повтор клавиш отключен на уровне ОС. Переключитесь на режим нажатия с помощью `/voice tap`, чтобы избежать требования повтора клавиш.187* **Ничего не происходит при удержании `Space` в режиме удержания**: смотрите на поле ввода запроса, пока вы удерживаете. Если пробелы продолжают накапливаться, голосовой ввод, вероятно, отключен; запустите `/voice hold` для включения. Если появляется только один или два пробела, а затем ничего, голосовой ввод включен, но обнаружение удержания не срабатывает. Обнаружение удержания требует, чтобы ваш терминал отправлял события повтора клавиш, поэтому он не может обнаружить удерживаемую клавишу, если повтор клавиш отключен на уровне ОС. Переключитесь на режим нажатия с помощью `/voice tap`, чтобы избежать требования повтора клавиш.

188* **Нажатие `Space` печатает пробел вместо записи в режиме нажатия**: первое нажатие начинает запись только при пустом поле ввода запроса. Сначала очистите ввод или проверьте, что вы находитесь в режиме нажатия, запустив `/voice tap`.188* **Нажатие `Space` печатает пробел вместо записи в режиме нажатия**: первое нажатие начинает запись только при пустом поле ввода запроса. Сначала очистите ввод или проверьте, что вы находитесь в режиме нажатия, запустив `/voice tap`.

189* **`No audio detected from microphone`**: запись началась, но захватила молчание. Подтвердите, что правильное устройство ввода установлено по умолчанию в системе и что его уровень ввода не отключен и не близок к нулю. На Windows откройте Settings → System → Sound → Input и выберите ваш микрофон. На macOS откройте System Settings → Sound → Input.189* **`No audio detected from microphone`**: запись началась, но захватила молчание. Подтвердите, что правильное устройство ввода установлено по умолчанию в системе и что его уровень ввода не отключен и не близок к нулю. На Windows откройте Settings → System → Sound → Input и выберите ваш микрофон. На macOS откройте System Settings → Sound → Input.

190* **`Voice connection failed`**: ваша запись никогда не достигла сервиса транскрибирования, потому что соединение не удалось. Проверьте вашу сеть и попробуйте снова. {/* min-version: 2.1.200 */}Запись, которая не захватывает аудио, выводит `No audio detected from microphone` вместо этого сообщения. До версии 2.1.200 тихий микрофон мог выводить ошибку соединения, что предполагало проблему с сетью, когда фактическая проблема была в устройстве ввода.

190* **`No speech detected`**: аудио достигло сервиса транскрибирования, но слова не были распознаны. Говорите ближе к микрофону, уменьшите фоновый шум и подтвердите, что ваш [язык диктовки](#change-the-dictation-language) соответствует языку, на котором вы говорите.191* **`No speech detected`**: аудио достигло сервиса транскрибирования, но слова не были распознаны. Говорите ближе к микрофону, уменьшите фоновый шум и подтвердите, что ваш [язык диктовки](#change-the-dictation-language) соответствует языку, на котором вы говорите.

191* **Транскрибирование искажено или на неправильном языке**: диктовка по умолчанию использует английский язык. Если вы диктуете на другом языке, установите его в `/config` сначала. См. [Изменение языка диктовки](#change-the-dictation-language).192* **Транскрибирование искажено или на неправильном языке**: диктовка по умолчанию использует английский язык. Если вы диктуете на другом языке, установите его в `/config` сначала. См. [Изменение языка диктовки](#change-the-dictation-language).

192 193 

vs-code.md +10 −6

Details

19Перед установкой убедитесь, что у вас есть:19Перед установкой убедитесь, что у вас есть:

20 20 

21* VS Code версии 1.98.0 или выше21* VS Code версии 1.98.0 или выше

22* Учётная запись Anthropic: подойдёт любая платная подписка Claude (Pro, Max, Team или Enterprise) или учётная запись Claude Console, API ключ не требуется. Вы [войдёте](/ru/authentication#log-in-to-claude-code) с помощью этой учётной записи при первом открытии расширения. Если вы получаете доступ к Claude через поставщика услуг третьей стороны, такого как Amazon Bedrock или Google Vertex AI, см. [Использование поставщиков третьей стороны](#use-third-party-providers) для инструкций по настройке.22* Учётная запись Anthropic: подойдёт любая платная подписка Claude (Pro, Max, Team или Enterprise) или учётная запись Claude Console, API ключ не требуется. Вы [войдёте](/ru/authentication#log-in-to-claude-code) с помощью этой учётной записи при первом открытии расширения. Если вы получаете доступ к Claude через поставщика услуг третьей стороны, такого как Amazon Bedrock или Google Cloud's Agent Platform, см. [Использование поставщиков третьей стороны](#use-third-party-providers) для инструкций по настройке.

23 23 

24<Tip>24<Tip>

25 Расширение включает собственную копию CLI (интерфейс командной строки) для панели чата. Чтобы запустить `claude` во встроенном терминале VS Code, вам также нужна [автономная установка CLI](/ru/setup). Подробности см. в разделе [Расширение VS Code и Claude Code CLI](#vs-code-extension-vs-claude-code-cli).25 Расширение включает собственную копию CLI (интерфейс командной строки) для панели чата. Чтобы запустить `claude` во встроенном терминале VS Code, вам также нужна [автономная установка CLI](/ru/setup). Подробности см. в разделе [Расширение VS Code и Claude Code CLI](#vs-code-extension-vs-claude-code-cli).


102 102 

103Поле ввода запроса поддерживает несколько функций:103Поле ввода запроса поддерживает несколько функций:

104 104 

105* **Режимы разрешений**: нажмите на индикатор режима в нижней части поля ввода запроса, чтобы переключать режимы. В обычном режиме Claude запрашивает разрешение перед каждым действием. В Plan Mode Claude описывает, что он будет делать, и ждёт одобрения перед внесением изменений. VS Code автоматически открывает план как полный документ markdown, где вы можете добавлять встроенные комментарии, чтобы дать обратную связь перед началом работы Claude. В режиме автоматического принятия Claude вносит правки без запроса. Установите значение по умолчанию в параметрах VS Code в разделе `claudeCode.initialPermissionMode`.105* **Режимы разрешений**: нажмите на индикатор режима в нижней части поля ввода запроса, чтобы переключать режимы, или установите значение по умолчанию в параметрах VS Code в разделе `claudeCode.initialPermissionMode`. Подробнее см. в разделе [режимы разрешений](/ru/permission-modes#switch-permission-modes) для каждого режима, который предлагает индикатор.

106 * **Manual**: Claude запрашивает разрешение перед каждым действием.

107 * **Plan Mode**: Claude описывает, что он будет делать, и ждёт одобрения перед внесением изменений. VS Code автоматически открывает план как полный документ Markdown, где вы можете добавлять встроенные комментарии, чтобы дать обратную связь перед началом работы Claude.

108 * **Edit automatically**: Claude вносит правки без запроса.

106* **Меню команд**: нажмите `/` или введите `/`, чтобы открыть меню команд. Опции включают присоединение файлов, переключение моделей, переключение расширенного мышления, просмотр использования плана (`/usage`) и запуск сеанса [Remote Control](/ru/remote-control) (`/remote-control`). Раздел Customize предоставляет доступ к MCP servers, hooks, памяти, разрешениям и plugins. Элементы со значком терминала открываются во встроенном терминале.109* **Меню команд**: нажмите `/` или введите `/`, чтобы открыть меню команд. Опции включают присоединение файлов, переключение моделей, переключение расширенного мышления, просмотр использования плана (`/usage`) и запуск сеанса [Remote Control](/ru/remote-control) (`/remote-control`). Раздел Customize предоставляет доступ к MCP servers, hooks, памяти, разрешениям и plugins. Элементы со значком терминала открываются во встроенном терминале.

110 * {/* min-version: 2.1.203 */}Раздел Settings включает **Enable Remote Control for all sessions**, который устанавливает [`remoteControlAtStartup`](/ru/settings#available-settings), поэтому [каждый новый интерактивный сеанс автоматически подключается к Remote Control](/ru/remote-control#enable-remote-control-for-all-sessions). Требуется Claude Code v2.1.203 или позже.

107* **Индикатор контекста**: поле ввода запроса показывает, сколько контекстного окна Claude вы используете. Claude автоматически выполняет компактизацию при необходимости, или вы можете выполнить `/compact` вручную.111* **Индикатор контекста**: поле ввода запроса показывает, сколько контекстного окна Claude вы используете. Claude автоматически выполняет компактизацию при необходимости, или вы можете выполнить `/compact` вручную.

108* **Расширенное мышление**: позволяет Claude потратить больше времени на рассуждение о сложных проблемах. Включите его через меню команд (`/`). Рассуждение Claude появляется в беседе как свёрнутые блоки: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть каждый блок мышления в сеансе. Подробности см. в разделе [Расширенное мышление](/ru/model-config#extended-thinking).112* **Расширенное мышление**: позволяет Claude потратить больше времени на рассуждение о сложных проблемах. Включите его через меню команд (`/`). Рассуждение Claude появляется в беседе как свёрнутые блоки: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть каждый блок мышления в сеансе. Подробности см. в разделе [Расширенное мышление](/ru/model-config#extended-thinking).

109* **Многострочный ввод**: нажмите `Shift+Enter`, чтобы добавить новую строку без отправки. Это также работает в поле свободного текста "Other" диалогов вопросов.113* **Многострочный ввод**: нажмите `Shift+Enter`, чтобы добавить новую строку без отправки. Это также работает в поле свободного текста "Other" диалогов вопросов.


356</h3>360</h3>

357 361 

358| Параметр | По умолчанию | Описание |362| Параметр | По умолчанию | Описание |

359| ----------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |363| ----------------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

360| `useTerminal` | `false` | Запустить Claude в режиме терминала вместо графической панели |364| `useTerminal` | `false` | Запустить Claude в режиме терминала вместо графической панели |

361| `initialPermissionMode` | `default` | Управляет запросами одобрения для новых бесед: `default`, `plan`, `acceptEdits` или `bypassPermissions`. См. [режимы разрешений](/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). |

362| `preferredLocation` | `panel` | Где открывается Claude: `sidebar` (справа) или `panel` (новая вкладка) |366| `preferredLocation` | `panel` | Где открывается Claude: `sidebar` (справа) или `panel` (новая вкладка) |

363| `autosave` | `true` | Автоматически сохранять файлы перед тем, как Claude их читает или записывает |367| `autosave` | `true` | Автоматически сохранять файлы перед тем, как Claude их читает или записывает |

364| `useCtrlEnterToSend` | `false` | Использовать Ctrl/Cmd+Enter вместо Enter для отправки запросов |368| `useCtrlEnterToSend` | `false` | Использовать Ctrl/Cmd+Enter вместо Enter для отправки запросов |


479 Использование поставщиков третьей стороны483 Использование поставщиков третьей стороны

480</h2>484</h2>

481 485 

482По умолчанию Claude Code подключается непосредственно к API Anthropic. Если ваша организация использует Amazon Bedrock, Google Vertex AI или Microsoft Foundry для доступа к Claude, настройте расширение на использование вашего поставщика вместо этого:486По умолчанию Claude Code подключается непосредственно к API Anthropic. Если ваша организация использует Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry для доступа к Claude, настройте расширение на использование вашего поставщика вместо этого:

483 487 

484<Steps>488<Steps>

485 <Step title="Отключите запрос входа">489 <Step title="Отключите запрос входа">


492 Следуйте руководству по настройке для вашего поставщика:496 Следуйте руководству по настройке для вашего поставщика:

493 497 

494 * [Claude Code на Amazon Bedrock](/ru/amazon-bedrock)498 * [Claude Code на Amazon Bedrock](/ru/amazon-bedrock)

495 * [Claude Code на Google Vertex AI](/ru/google-vertex-ai)499 * [Claude Code на Google Cloud's Agent Platform](/ru/google-vertex-ai)

496 * [Claude Code на Microsoft Foundry](/ru/microsoft-foundry)500 * [Claude Code на Microsoft Foundry](/ru/microsoft-foundry)

497 501 

498 Эти руководства охватывают настройку вашего поставщика в `~/.claude/settings.json`, что обеспечивает совместное использование ваших параметров между расширением VS Code и CLI.502 Эти руководства охватывают настройку вашего поставщика в `~/.claude/settings.json`, что обеспечивает совместное использование ваших параметров между расширением VS Code и CLI.

Details

43Claude Code ведет себя одинаково везде. Что меняется, так это место выполнения кода и доступность вашей локальной конфигурации. Приложение Desktop предлагает как локальные, так и облачные сеансы, поэтому ответы ниже зависят от того, что вы выберете:43Claude Code ведет себя одинаково везде. Что меняется, так это место выполнения кода и доступность вашей локальной конфигурации. Приложение Desktop предлагает как локальные, так и облачные сеансы, поэтому ответы ниже зависят от того, что вы выберете:

44 44 

45| | В веб-версии | Remote Control | Terminal CLI | Приложение Desktop |45| | В веб-версии | Remote Control | Terminal CLI | Приложение Desktop |

46| :-------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------- | :---------------- | :----------------------------------- |46| :-------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------- | :---------------- | :----------------------------------- |

47| **Код выполняется на** | Облачной ВМ Anthropic | Вашей машине | Вашей машине | Вашей машине или облачной ВМ |47| **Код выполняется на** | Облачной ВМ Anthropic | Вашей машине | Вашей машине | Вашей машине или облачной ВМ |

48| **Вы общаетесь с** | claude.ai или мобильного приложения | claude.ai или мобильного приложения | Вашего терминала | Интерфейса Desktop |48| **Вы общаетесь с** | claude.ai или мобильного приложения | claude.ai или мобильного приложения | Вашего терминала | Интерфейса Desktop |

49| **Использует вашу локальную конфигурацию** | Нет, только репозиторий | Да | Да | Да для локального, нет для облачного |49| **Использует вашу локальную конфигурацию** | Нет, только репозиторий | Да | Да | Да для локального, нет для облачного |

50| **Требует GitHub** | Да, или [отправьте локальный репозиторий](/ru/claude-code-on-the-web#send-local-repositories-without-github) через `--remote` | Нет | Нет | Только для облачных сеансов |50| **Требует GitHub** | Да, или [отправьте локальный репозиторий](/ru/claude-code-on-the-web#send-local-repositories-without-github) через `--cloud` | Нет | Нет | Только для облачных сеансов |

51| **Продолжает работать при отключении** | Да | Пока терминал остается открытым | Нет | Зависит от типа сеанса |51| **Продолжает работать при отключении** | Да | Пока терминал остается открытым | Нет | Зависит от типа сеанса |

52| **[Режимы разрешений](/ru/permission-modes)** | Автоматическое принятие правок, Plan | Спросить, Автоматическое принятие правок, Plan | Все режимы | Зависит от типа сеанса |52| **[Режимы разрешений](/ru/permission-modes)** | Принять правки, Plan, Auto | Спросить, Автоматическое принятие правок, Plan | Все режимы | Зависит от типа сеанса |

53| **Доступ в сеть** | Настраивается для каждого окружения | Сеть вашей машины | Сеть вашей машины | Зависит от типа сеанса |53| **Доступ в сеть** | Настраивается для каждого окружения | Сеть вашей машины | Сеть вашей машины | Зависит от типа сеанса |

54 54 

55Смотрите документацию [быстрого старта терминала](/ru/quickstart), [приложения Desktop](/ru/desktop) или [Remote Control](/ru/remote-control) для их настройки.55Смотрите документацию [быстрого старта терминала](/ru/quickstart), [приложения Desktop](/ru/desktop) или [Remote Control](/ru/remote-control) для их настройки.


113 /web-setup113 /web-setup

114 ```114 ```

115 115 

116 Это синхронизирует ваш токен `gh` с вашей учетной записью Claude. Если у вас еще нет облачного окружения, `/web-setup` создает его с доступом в сеть Trusted и без скрипта настройки. Вы можете [отредактировать окружение или добавить переменные](/ru/claude-code-on-the-web#configure-your-environment) позже. После завершения `/web-setup` вы можете запускать облачные сеансы из терминала с помощью [`--remote`](/ru/claude-code-on-the-web#from-terminal-to-web) или настроить повторяющиеся задачи с помощью [`/schedule`](/ru/routines).116 Это синхронизирует ваш токен `gh` с вашей учетной записью Claude. Если у вас еще нет облачного окружения, `/web-setup` создает его с доступом в сеть Trusted и без скрипта настройки. Вы можете [отредактировать окружение или добавить переменные](/ru/claude-code-on-the-web#configure-your-environment) позже. После завершения `/web-setup` вы можете запускать облачные сеансы из терминала с помощью [`--cloud`](/ru/claude-code-on-the-web#from-terminal-to-web) или настроить повторяющиеся задачи с помощью [`/schedule`](/ru/routines).

117 </Step>117 </Step>

118</Steps>118</Steps>

119 119 


129 </Step>129 </Step>

130 130 

131 <Step title="Выберите режим разрешений">131 <Step title="Выберите режим разрешений">

132 Раскрывающееся меню режима рядом с вводом по умолчанию установлено на **Accept edits**, где Claude вносит изменения и отправляет ветку без остановки для одобрения. Переключитесь на **Plan mode**, если вы хотите, чтобы Claude предложил подход и дождался вашего одобрения перед редактированием файлов. Облачные сеансы не предлагают разрешения Ask или разрешения Bypass. Смотрите [Режимы разрешений](/ru/permission-modes) для полного списка.132 Раскрывающееся меню режима рядом с вводом по умолчанию установлено на **Accept edits**, где Claude вносит изменения и отправляет ветку без остановки для одобрения. Переключитесь на **Plan Mode**, если вы хотите, чтобы Claude предложил подход и дождался вашего одобрения перед редактированием файлов. Облачные сеансы не предлагают разрешения Manual или разрешения Bypass. Смотрите [полный список режимов разрешений](/ru/permission-modes#available-modes) для того, что позволяет каждый из них.

133 </Step>133 </Step>

134 134 

135 <Step title="Опишите задачу и отправьте">135 <Step title="Опишите задачу и отправьте">


216 216 

217Если вы ввели его внутри Claude Code и меню команд показывает `No commands match "/web-setup"`, или отправка возвращает `Unknown command: /web-setup`, команда скрыта, потому что требование не выполнено. Причина обычно в том, что ваш CLI старше v2.1.80 или вы аутентифицированы с помощью ключа API или поставщика третьей стороны вместо подписки claude.ai. Запустите `claude update`, затем `/login` для входа со своей учетной записью claude.ai.217Если вы ввели его внутри Claude Code и меню команд показывает `No commands match "/web-setup"`, или отправка возвращает `Unknown command: /web-setup`, команда скрыта, потому что требование не выполнено. Причина обычно в том, что ваш CLI старше v2.1.80 или вы аутентифицированы с помощью ключа API или поставщика третьей стороны вместо подписки claude.ai. Запустите `claude update`, затем `/login` для входа со своей учетной записью claude.ai.

218 218 

219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-remote-or-ultraplan">219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud-or-ultraplan">

220 "Could not create a cloud environment" или "No cloud environment available" при использовании `--remote` или ultraplan220 "Could not create a cloud environment" или "No cloud environment available" при использовании `--cloud` или ultraplan

221</h3>221</h3>

222 222 

223Функции удаленного сеанса автоматически создают облачное окружение по умолчанию, если у вас его нет. Если вы видите "Could not create a cloud environment", автоматическое создание не удалось. {/* max-version: 2.1.100 */}Если вы видите "No cloud environment available", ваш CLI предшествует автоматическому созданию. В любом случае запустите `/web-setup` в Claude Code CLI для создания вручную или посетите [claude.ai/code](https://claude.ai/code) и следуйте шагу **Create your environment** выше.223Функции удаленного сеанса автоматически создают облачное окружение по умолчанию, если у вас его нет. Если вы видите "Could not create a cloud environment", автоматическое создание не удалось. {/* max-version: 2.1.100 */}Если вы видите "No cloud environment available", ваш CLI предшествует автоматическому созданию. В любом случае запустите `/web-setup` в Claude Code CLI для создания вручную или посетите [claude.ai/code](https://claude.ai/code) и следуйте шагу **Create your environment** выше.

whats-new.md +1 −1

Details

33</Update>33</Update>

34 34 

35<Update label="Week 23" description="June 1–5, 2026" tags={["v2.1.158–v2.1.165"]}>35<Update label="Week 23" description="June 1–5, 2026" tags={["v2.1.158–v2.1.165"]}>

36 **Auto mode на Bedrock, Vertex и Foundry**: auto mode теперь доступен на сторонних поставщиках для Opus 4.7 и Opus 4.8, заменяя запросы разрешений проверками безопасности в фоновом режиме.36 **Auto mode на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry**: auto mode теперь доступен на сторонних поставщиках для Opus 4.7 и Opus 4.8, заменяя запросы разрешений проверками безопасности в фоновом режиме.

37 37 

38 Также на этой неделе: **более безопасные автоматические правки** запрашивают перед записью файлов, которые могут выполнять код в режиме `acceptEdits`; **`/plugin list`** выводит установленные плагины встроенно; и **требования к версии** позволяют управляемым развертываниям требовать утвержденный диапазон версий Claude Code.38 Также на этой неделе: **более безопасные автоматические правки** запрашивают перед записью файлов, которые могут выполнять код в режиме `acceptEdits`; **`/plugin list`** выводит установленные плагины встроенно; и **требования к версии** позволяют управляемым развертываниям требовать утвержденный диапазон версий Claude Code.

39 39 

Details

102 102 

103 <div className="digest-wins-grid">103 <div className="digest-wins-grid">

104 <div>Режим фокуса: нажмите <code>Ctrl+O</code> в режиме без мерцания, чтобы свернуть представление до вашего последнего запроса, однострочного резюме инструмента с diffstats и финального ответа Claude</div>104 <div>Режим фокуса: нажмите <code>Ctrl+O</code> в режиме без мерцания, чтобы свернуть представление до вашего последнего запроса, однострочного резюме инструмента с diffstats и финального ответа Claude</div>

105 <div>Управляемые мастера настройки <a href="/ru/docs/amazon-bedrock">Bedrock</a> и <a href="/ru/docs/google-vertex-ai">Vertex AI</a> на экране входа: выберите «3rd-party platform» для пошаговой аутентификации, выбора региона, проверки учётных данных и закрепления модели</div>105 <div>Управляемые мастера настройки <a href="/ru/docs/amazon-bedrock">Amazon Bedrock</a> и <a href="/ru/docs/google-vertex-ai">Google Cloud's Agent Platform</a> на экране входа: выберите «3rd-party platform» для пошаговой аутентификации, выбора региона, проверки учётных данных и закрепления модели</div>

106 <div><code>/agents</code> получает макет с вкладками: вкладка Running показывает активные подагенты с подсчётом <code>● N running</code>, плюс действия Run agent и View running instance на вкладке Library</div>106 <div><code>/agents</code> получает макет с вкладками: вкладка Running показывает активные подагенты с подсчётом <code>● N running</code>, плюс действия Run agent и View running instance на вкладке Library</div>

107 <div>Уровень усилий по умолчанию теперь <code>high</code> для пользователей API-key, Bedrock, Vertex, Foundry, Team и Enterprise (управляется с помощью <code>/effort</code>)</div>107 <div>Уровень усилий по умолчанию теперь <code>high</code> для пользователей API-key, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Team и Enterprise (управляется с помощью <code>/effort</code>)</div>

108 <div><code>/cost</code> показывает разбивку по моделям и попаданиям в кэш для пользователей подписки</div>108 <div><code>/cost</code> показывает разбивку по моделям и попаданиям в кэш для пользователей подписки</div>

109 <div><code>/release-notes</code> теперь интерактивный выбор версии</div>109 <div><code>/release-notes</code> теперь интерактивный выбор версии</div>

110 <div>Строка состояния: новый параметр <code>refreshInterval</code> повторно выполняет команду каждые N секунд, и <code>workspace.git\_worktree</code> в JSON-входе</div>110 <div>Строка состояния: новый параметр <code>refreshInterval</code> повторно выполняет команду каждые N секунд, и <code>workspace.git\_worktree</code> в JSON-входе</div>

Details

103 <div>`--dangerously-skip-permissions` теперь обходит подсказки для записи в `.claude/`, `.git/`, `.vscode/`, файлы конфигурации оболочки и другие ранее защищённые пути, в то время как команды катастрофического удаления по-прежнему выводят подсказки в качестве сетки безопасности</div>103 <div>`--dangerously-skip-permissions` теперь обходит подсказки для записи в `.claude/`, `.git/`, `.vscode/`, файлы конфигурации оболочки и другие ранее защищённые пути, в то время как команды катастрофического удаления по-прежнему выводят подсказки в качестве сетки безопасности</div>

104 <div>Средство выбора `/model` может выводить модели из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз; включите с помощью `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` начиная с v2.1.129</div>104 <div>Средство выбора `/model` может выводить модели из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз; включите с помощью `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` начиная с v2.1.129</div>

105 <div>MCP-серверы, которые столкнулись с временной ошибкой при запуске, теперь автоматически повторяют попытку до 3 раз вместо того, чтобы оставаться отключёнными</div>105 <div>MCP-серверы, которые столкнулись с временной ошибкой при запуске, теперь автоматически повторяют попытку до 3 раз вместо того, чтобы оставаться отключёнными</div>

106 <div>`ANTHROPIC_BEDROCK_SERVICE_TIER` выбирает уровень обслуживания Bedrock: `default`, `flex` или `priority`</div>106 <div>`ANTHROPIC_BEDROCK_SERVICE_TIER` выбирает уровень обслуживания Amazon Bedrock: `default`, `flex` или `priority`</div>

107 <div>`/terminal-setup` включает параметр доступа к буферу обмена iTerm2, чтобы `/copy` работал, включая из tmux</div>107 <div>`/terminal-setup` включает параметр доступа к буферу обмена iTerm2, чтобы `/copy` работал, включая из tmux</div>

108 <div>Vertex AI теперь поддерживает федерацию рабочей идентификации на основе сертификата X.509 (mTLS ADC)</div>108 <div>Платформа Google Cloud Agent теперь поддерживает федерацию рабочей идентификации на основе сертификата X.509 (mTLS ADC)</div>

109 <div>Значительные исправления утечек памяти: сеансы с большим количеством изображений, `/usage` в больших историях транскриптов и долгоживущие инструменты без событий прогресса</div>109 <div>Значительные исправления утечек памяти: сеансы с большим количеством изображений, `/usage` в больших историях транскриптов и долгоживущие инструменты без событий прогресса</div>

110 </div>110 </div>

111</div>111</div>

Details

37 <div>Новая команда <a href="/ru/code-review"><code>/code-review</code></a> сообщает об ошибках корректности на выбранном уровне усилий, таком как <code>/code-review high</code>, и <code>--comment</code> публикует результаты как встроенные комментарии GitHub PR. <code>/simplify</code> остается отдельной проверкой только для очистки.</div>37 <div>Новая команда <a href="/ru/code-review"><code>/code-review</code></a> сообщает об ошибках корректности на выбранном уровне усилий, таком как <code>/code-review high</code>, и <code>--comment</code> публикует результаты как встроенные комментарии GitHub PR. <code>/simplify</code> остается отдельной проверкой только для очистки.</div>

38 <div>Фоновые сеансы теперь появляются в <code>/resume</code> наряду с интерактивными, отмеченные <code>bg</code>, и сеансы, закрепленные с помощью <code>Ctrl+T</code> в <code>claude agents</code>, остаются активными при неактивности</div>38 <div>Фоновые сеансы теперь появляются в <code>/resume</code> наряду с интерактивными, отмеченные <code>bg</code>, и сеансы, закрепленные с помощью <code>Ctrl+T</code> в <code>claude agents</code>, остаются активными при неактивности</div>

39 <div><code>claude agents --json</code> выводит список активных сеансов в формате JSON для написания скриптов, таких как строки состояния и средства выбора сеансов</div>39 <div><code>claude agents --json</code> выводит список активных сеансов в формате JSON для написания скриптов, таких как строки состояния и средства выбора сеансов</div>

40 <div>Инструмент PowerShell теперь включен по умолчанию на Windows для пользователей Bedrock, Vertex и Foundry; отключите с помощью <code>CLAUDE\_CODE\_USE\_POWERSHELL\_TOOL=0</code></div>40 <div>Инструмент PowerShell теперь включен по умолчанию на Windows для пользователей Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry; отключите с помощью <code>CLAUDE\_CODE\_USE\_POWERSHELL\_TOOL=0</code></div>

41 <div><code>claude plugin disable</code> теперь отказывает, когда другой включенный plugin зависит от целевого, и <code>claude plugin enable</code> принудительно включает переходные зависимости</div>41 <div><code>claude plugin disable</code> теперь отказывает, когда другой включенный plugin зависит от целевого, и <code>claude plugin enable</code> принудительно включает переходные зависимости</div>

42 <div>Панель просмотра marketplace <code>/plugin</code> показывает прогнозируемую стоимость контекста, а экраны Discover и Browse выводят список команд, agents, skills, hooks и MCP/LSP servers плагина перед установкой</div>42 <div>Панель просмотра marketplace <code>/plugin</code> показывает прогнозируемую стоимость контекста, а экраны Discover и Browse выводят список команд, agents, skills, hooks и MCP/LSP servers плагина перед установкой</div>

43 <div>Новый параметр <code>worktree.bgIsolation: "none"</code> позволяет фоновым сеансам редактировать рабочую копию напрямую без <code>EnterWorktree</code>, для репозиториев, где worktrees непрактичны</div>43 <div>Новый параметр <code>worktree.bgIsolation: "none"</code> позволяет фоновым сеансам редактировать рабочую копию напрямую без <code>EnterWorktree</code>, для репозиториев, где worktrees непрактичны</div>

Details

109 <div>Claude Code теперь переключается на ваш настроенный <code>--fallback-model</code> для остальной части сеанса, когда основная модель не найдена, вместо того чтобы не выполнять каждый запрос</div>109 <div>Claude Code теперь переключается на ваш настроенный <code>--fallback-model</code> для остальной части сеанса, когда основная модель не найдена, вместо того чтобы не выполнять каждый запрос</div>

110 <div>Плагины могут объявлять <code>defaultEnabled: false</code> в <code>plugin.json</code> или записи marketplace, поэтому они устанавливаются без включения, пока вы их не включите</div>110 <div>Плагины могут объявлять <code>defaultEnabled: false</code> в <code>plugin.json</code> или записи marketplace, поэтому они устанавливаются без включения, пока вы их не включите</div>

111 <div>Режим Vim: <code>/</code> в режиме NORMAL открывает поиск истории в обратном направлении, соответствуя Bash и Zsh vi-mode</div>111 <div>Режим Vim: <code>/</code> в режиме NORMAL открывает поиск истории в обратном направлении, соответствуя Bash и Zsh vi-mode</div>

112 <div>Потоковое выполнение инструментов теперь всегда включено, включая с отключённой телеметрией и на Bedrock, Vertex и Foundry</div>112 <div>Потоковое выполнение инструментов теперь всегда включено, включая с отключённой телеметрией и на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry</div>

113 <div><code>←←</code> для открытия представления agents теперь работает на Bedrock, Vertex, Foundry и с отключённой телеметрией</div>113 <div><code>←←</code> для открытия представления agents теперь работает на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и с отключённой телеметрией</div>

114 <div>Claude в Chrome: выберите, какой подключённый браузер использовать через <code>/chrome</code> → "Select browser…", или в чате, когда действие браузера выполняется с несколькими подключёнными</div>114 <div>Claude в Chrome: выберите, какой подключённый браузер использовать через <code>/chrome</code> → "Select browser…", или в чате, когда действие браузера выполняется с несколькими подключёнными</div>

115 <div><code>claude mcp list</code> и <code>claude mcp get</code> теперь показывают неодобренные серверы <code>.mcp.json</code> как ожидающие одобрения вместо автоматического одобрения и подключения, когда вывод передаётся по конвейеру</div>115 <div><code>claude mcp list</code> и <code>claude mcp get</code> теперь показывают неодобренные серверы <code>.mcp.json</code> как ожидающие одобрения вместо автоматического одобрения и подключения, когда вывод передаётся по конвейеру</div>

116 </div>116 </div>

Details

4 4 

5# Неделя 23 · 1–5 июня 20265# Неделя 23 · 1–5 июня 2026

6 6 

7> Запуск режима auto на Bedrock, Vertex и Foundry, запрос перед записью файлов, которые могут выполнять код в режиме acceptEdits, список установленных плагинов с помощью /plugin list и требование утвержденного диапазона версий для управляемых развертываний.7> Запуск режима auto на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, запрос перед записью файлов, которые могут выполнять код в режиме acceptEdits, список установленных плагинов с помощью /plugin list и требование утвержденного диапазона версий для управляемых развертываний.

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>Releases <a href="/ru/docs/changelog#2-1-158">v2.1.158 → v2.1.165</a></span>10 <span>Releases <a href="/ru/docs/changelog#2-1-158">v2.1.158 → v2.1.165</a></span>


13 13 

14<div className="digest-feature">14<div className="digest-feature">

15 <div className="digest-feature-header">15 <div className="digest-feature-header">

16 <span className="digest-feature-title">Режим auto на Bedrock, Vertex и Foundry</span>16 <span className="digest-feature-title">Режим auto на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry</span>

17 <span className="digest-feature-pill">v2.1.158</span>17 <span className="digest-feature-pill">v2.1.158</span>

18 </div>18 </div>

19 19 

20 <p className="digest-feature-lede">Режим auto теперь доступен на Bedrock, Vertex и Foundry для Opus 4.7 и Opus 4.8, заменяя запросы разрешений проверками безопасности в фоновом режиме у сторонних поставщиков. Включите, установив <code>CLAUDE\_CODE\_ENABLE\_AUTO\_MODE=1</code>.</p>20 <p className="digest-feature-lede">Режим auto теперь доступен на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry для Opus 4.7 и Opus 4.8, заменяя запросы разрешений проверками безопасности в фоновом режиме у сторонних поставщиков. Включите, установив <code>CLAUDE\_CODE\_ENABLE\_AUTO\_MODE=1</code>.</p>

21 21 

22 <p className="digest-feature-try">Включите на сторонних поставщиках, затем переключитесь в режим auto с помощью Shift+Tab:</p>22 <p className="digest-feature-try">Включите на сторонних поставщиках, затем переключитесь в режим auto с помощью Shift+Tab:</p>

23 23 


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-vertex-ai-or-foundry">Включить режим auto у сторонних поставщиков</a>28 <a className="digest-feature-link" href="/ru/docs/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 +29 −3

Details

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

10 10 

11<Note>11<Note>

12 Dynamic workflows требуют Claude Code v2.1.154 или позже и доступны на всех платных планах, с доступом к Anthropic API, а также на Amazon Bedrock, Google Cloud Vertex AI и Microsoft Foundry. На Pro включите их из строки Dynamic workflows в `/config`.12 Dynamic workflows требуют Claude Code v2.1.154 или позже и доступны на всех платных планах, с доступом к Anthropic API, а также на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. На Pro включите их из строки Dynamic workflows в `/config`.

13</Note>13</Note>

14 14 

15Dynamic workflow — это JavaScript-скрипт, который оркестрирует [подагентов](/ru/sub-agents) в масштабе. Claude пишет скрипт для описанной вами задачи, а runtime выполняет его в фоне, пока ваша сессия остаётся отзывчивой.15Dynamic workflow — это JavaScript-скрипт, который оркестрирует [подагентов](/ru/sub-agents) в масштабе. Claude пишет скрипт для описанной вами задачи, а runtime выполняет его в фоне, пока ваша сессия остаётся отзывчивой.


117 117 

118Вы можете попросить Claude написать workflow для вашей задачи двумя способами:118Вы можете попросить Claude написать workflow для вашей задачи двумя способами:

119 119 

120* [Попросить workflow в вашей подсказке](#ask-for-a-workflow-in-your-prompt) со словом `ultracode`, и Claude напишет один для задачи.120* [Попросить workflow в вашей подсказке](#ask-for-a-workflow-in-your-prompt) в ваших собственных словах или включив ключевое слово `ultracode`, и Claude напишет один для задачи.

121* [Позволить Claude решить с ultracode](#let-claude-decide-with-ultracode): установите `/effort ultracode` и Claude спланирует workflow для каждой существенной задачи в сессии.121* [Позволить Claude решить с ultracode](#let-claude-decide-with-ultracode): установите `/effort ultracode` и Claude спланирует workflow для каждой существенной задачи в сессии.

122 122 

123Вы также можете запустить команду workflow, которая уже существует: [bundled workflow](#bundled-workflows) как `/deep-research`, или один, который вы [сохранили](#save-the-workflow-for-reuse).123Вы также можете запустить команду workflow, которая уже существует: [bundled workflow](#bundled-workflows) как `/deep-research`, или один, который вы [сохранили](#save-the-workflow-for-reuse).


148/effort ultracode148/effort ultracode

149```149```

150 150 

151Чтобы начать сессию с уже включённым ultracode, запустите с `claude --effort ultracode`. Требуется Claude Code версии 2.1.203 или позже.

152 

151С ultracode включённым, Claude решает, когда задача требует workflow. Один запрос может превратиться в несколько workflows подряд: один для понимания кода, один для внесения изменения и один для его проверки. Это применяется к каждой задаче в сессии, поэтому каждый запрос использует больше токенов и занимает больше времени, чем на более низких уровнях усилий.153С ultracode включённым, Claude решает, когда задача требует workflow. Один запрос может превратиться в несколько workflows подряд: один для понимания кода, один для внесения изменения и один для его проверки. Это применяется к каждой задаче в сессии, поэтому каждый запрос использует больше токенов и занимает больше времени, чем на более низких уровнях усилий.

152 154 

153Ultracode длится для текущей сессии и сбрасывается, когда вы начинаете новую. Вернитесь с `/effort high`, когда вы вернётесь к рутинной работе. Это доступно на моделях, которые поддерживают `xhigh` [усилие](/ru/model-config#adjust-effort-level); на других моделях меню `/effort` не предлагает это.155Ultracode длится для текущей сессии и сбрасывается, когда вы начинаете новую. Вернитесь с `/effort high`, когда вы вернётесь к рутинной работе. Это доступно на моделях, которые поддерживают `xhigh` [усилие](/ru/model-config#adjust-effort-level); на других моделях меню `/effort` не предлагает это.


346 348 

347Workflow создаёт множество агентов, поэтому один запуск может использовать значительно больше токенов, чем работа через ту же задачу в беседе. Запуски считаются в сторону использования вашего плана и ограничений скорости, как и любая другая сессия.349Workflow создаёт множество агентов, поэтому один запуск может использовать значительно больше токенов, чем работа через ту же задачу в беседе. Запуски считаются в сторону использования вашего плана и ограничений скорости, как и любая другая сессия.

348 350 

349Чтобы оценить расходы перед выполнением крупной задачи, сначала запустите workflow на небольшом срезе: один каталог вместо всего репозитория или узкий вопрос вместо широкого. Представление `/workflows` показывает использование токенов каждым агентом по мере выполнения запуска, и вы можете остановить запуск там в любое время без потери завершённой работы. [Ограничения агентов](#behavior-and-limits) среды выполнения ограничивают количество агентов, которых может создать один запуск, что ограничивает стоимость неконтролируемого скрипта.351Чтобы оценить расходы перед выполнением крупной задачи, сначала запустите workflow на небольшом срезе: один каталог вместо всего репозитория или узкий вопрос вместо широкого. Представление `/workflows` показывает использование токенов каждым агентом по мере выполнения запуска, и вы можете остановить запуск там в любое время без потери завершённой работы. [Ограничения агентов](#behavior-and-limits) среды выполнения ограничивают количество агентов, которых может создать один запуск, что ограничивает стоимость неконтролируемого скрипта. Чтобы по умолчанию сохранять каждый запуск меньшего размера, [установите рекомендацию по размеру](#set-a-size-guideline) в `/config`.

352 

353Claude Code также отмечает запуск, который растёт необычно быстро. Когда workflow планирует более 25 агентов, или его прогнозируемый общий объём токенов превышает 1,5 миллиона, его строка прогресса в панели задач ниже поля ввода показывает предупреждение `Large workflow`. Предупреждение указывает вам на [`/workflows`](#watch-the-run), где вы можете остановить запуск. Требуется Claude Code v2.1.203 или позже.

354 

355Предупреждение носит рекомендательный характер: оно не приостанавливает и не ограничивает запуск. Два параметра изменяются, когда вы его видите:

356 

357* Если вы [установите рекомендацию по размеру](#set-a-size-guideline), количество агентов рекомендации заменяет порог в 25 агентов.

358* Сессии с включённым [ultracode](#let-claude-decide-with-ultracode) не показывают предупреждение, потому что включение ultracode уже означает согласие на крупные запуски.

350 359 

351Каждый агент в workflow использует модель вашей сессии, если скрипт не маршрутизирует этап на другую. Чтобы контролировать стоимость модели:360Каждый агент в workflow использует модель вашей сессии, если скрипт не маршрутизирует этап на другую. Чтобы контролировать стоимость модели:

352 361 

353* Проверьте `/model` перед крупным запуском, если вы обычно переключаетесь на меньшую модель для рутинной работы362* Проверьте `/model` перед крупным запуском, если вы обычно переключаетесь на меньшую модель для рутинной работы

354* Попросите Claude использовать меньшую модель для этапов, которые не требуют самой сильной, когда вы описываете задачу363* Попросите Claude использовать меньшую модель для этапов, которые не требуют самой сильной, когда вы описываете задачу

355 364 

365<h3 id="set-a-size-guideline">

366 Установить рекомендацию по размеру

367</h3>

368 

369Параметр Dynamic workflow size в `/config` сохраняет workflows, которые пишет Claude, в меньшем масштабе по умолчанию. Claude Code отправляет параметр Claude в качестве рекомендации, поэтому подсказка, которая требует другого масштаба, всё ещё переопределяет его. Требуется Claude Code v2.1.202 или позже.

370 

371Каждое значение устанавливает количество агентов, на которое Claude нацелен в написанных им скриптах.

372 

373| Значение | Рекомендация, отправленная Claude |

374| :------------- | :------------------------------------------- |

375| `unrestricted` | Нет рекомендации. Это значение по умолчанию. |

376| `small` | Нацеливайтесь на менее 5 агентов. |

377| `medium` | Нацеливайтесь на менее 15 агентов. |

378| `large` | Нацеливайтесь на менее 50 агентов. |

379 

380Изменения вступают в силу при следующем запросе. [Ограничения агентов среды выполнения](#behavior-and-limits) по-прежнему применяются независимо от параметра.

381 

356<h3 id="turn-workflows-off">382<h3 id="turn-workflows-off">

357 Отключить workflows383 Отключить workflows

358</h3>384</h3>

worktrees.md +6 −0

Details

40 40 

41Перед использованием `--worktree` интерактивно в каталоге в первый раз примите диалог доверия рабочей области, запустив `claude` один раз в этом каталоге. Если доверие ещё не было принято, `--worktree` завершится с ошибкой и предложит вам сначала запустить `claude` в каталоге. Неинтерактивные запуски с `-p` пропускают [проверку доверия](/ru/security), поэтому `claude -p --worktree` продолжает работу без неё.41Перед использованием `--worktree` интерактивно в каталоге в первый раз примите диалог доверия рабочей области, запустив `claude` один раз в этом каталоге. Если доверие ещё не было принято, `--worktree` завершится с ошибкой и предложит вам сначала запустить `claude` в каталоге. Неинтерактивные запуски с `-p` пропускают [проверку доверия](/ru/security), поэтому `claude -p --worktree` продолжает работу без неё.

42 42 

43Если Claude Code не может войти в каталог worktree при запуске, например потому что hook [`WorktreeCreate`](/ru/hooks#worktreecreate) вывел что-то другое, чем каталог, который он создал, или потому что каталог был удалён после его настройки, Claude Code выводит ошибку с указанием пути и завершается с кодом 1. До версии 2.1.205 это приводило к сбою сеанса, а с `-p` это зависало примерно на 30 секунд перед выходом с кодом 0.

44 

45{/* min-version: 2.1.200 */}Плагины, установленные в [области проекта](/ru/plugins-reference#plugin-installation-scopes) из основной копии, также загружаются в worktrees того же репозитория, поэтому вам не нужно переустанавливать их для каждого worktree. Это применяется независимо от того, создаёте ли вы worktree с помощью `--worktree` или с помощью `git worktree add`. Требуется Claude Code версии 2.1.200 или позже.

46 

43<Tip>47<Tip>

44 Добавьте `.claude/worktrees/` в ваш `.gitignore`, чтобы содержимое worktree не отображалось как неотслеживаемые файлы в вашей основной копии.48 Добавьте `.claude/worktrees/` в ваш `.gitignore`, чтобы содержимое worktree не отображалось как неотслеживаемые файлы в вашей основной копии.

45</Tip>49</Tip>


106 110 

107Пока агент работает, Claude запускает `git worktree lock` на его worktree, чтобы одновременная очистка не могла его удалить. Блокировка снимается, когда агент завершает работу. Чтобы очистить worktree, который очистка сохраняет, запустите `git worktree remove`, добавив `--force`, если worktree содержит неотправленные изменения или неотслеживаемые файлы.111Пока агент работает, Claude запускает `git worktree lock` на его worktree, чтобы одновременная очистка не могла его удалить. Блокировка снимается, когда агент завершает работу. Чтобы очистить worktree, который очистка сохраняет, запустите `git worktree remove`, добавив `--force`, если worktree содержит неотправленные изменения или неотслеживаемые файлы.

108 112 

113В Windows перед удалением worktree Claude Code удаляет любое соединение NTFS или символическую ссылку на каталог на любой глубине внутри него как запись ссылки, чтобы удаление worktree не удаляло файлы, на которые указывает ссылка. До версии 2.1.205 Claude Code удалял только ссылки верхнего уровня как записи ссылок, и удаление worktree с соединением, вложенным в подкаталог, могло удалить содержимое каталога, на который указывала ссылка вне worktree.

114 

109<h2 id="manage-worktrees-manually">115<h2 id="manage-worktrees-manually">

110 Управляйте worktrees вручную116 Управляйте worktrees вручную

111</h2>117</h2>

Details

19* [Параметры, управляемые сервером](/ru/server-managed-settings)19* [Параметры, управляемые сервером](/ru/server-managed-settings)

20* Журналы аудита20* Журналы аудита

21 21 

22ZDR для Claude Code на Claude for Enterprise применяется только к прямой платформе Anthropic. Для развертываний Claude на Amazon Bedrock, Google Vertex AI или Microsoft Foundry обратитесь к политикам хранения данных этих платформ.22ZDR для Claude Code на Claude for Enterprise применяется только к прямой платформе Anthropic. Для развертываний Claude на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry обратитесь к политикам хранения данных этих платформ.

23 23 

24<h2 id="zdr-scope">24<h2 id="zdr-scope">

25 Область применения ZDR25 Область применения ZDR