SpyBara
Go Premium

Documentation 2026-10-27 22:59 UTC to 2026-10-28 23:57 UTC

52 files changed +502 −247. View all changes and history on the product overview
2026
Fri 30 23:01 Thu 29 23:57 Wed 28 23:57 Tue 27 22:59 Mon 26 22:57 Sun 25 23:58 Sat 24 22:59 Fri 23 22:59 Thu 22 22:58 Wed 21 23:02 Tue 20 23:00 Mon 19 23:58 Sat 17 23:57 Fri 16 22:59 Thu 15 23:58 Wed 14 22:58 Tue 13 23:57 Sun 11 23:57 Sat 10 23:01 Fri 9 23:02 Thu 8 22:58 Wed 7 23:59 Tue 6 23:59 Mon 5 23:58 Sun 4 23:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59

admin-setup.md +1 −1

Details

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

103| [Настройка корпоративного запускателя](https://code.claude.com/docs/ru/corporate-launcher.md) | Добавить префикс к [супервизору фонового агента](https://code.claude.com/docs/ru/agent-view.md#how-background-sessions-are-hosted), его рабочим процессам и [другим охватываемым фоновым процессам](https://code.claude.com/docs/ru/corporate-launcher.md#what-the-launcher-covers) с требуемым корпоративным запускателем вместо отключения представления агента | `processWrapper` |103| [Настройка корпоративного запускателя](https://code.claude.com/docs/ru/corporate-launcher.md) | Добавить префикс к [супервизору фонового агента](https://code.claude.com/docs/ru/agent-view.md#how-background-sessions-are-hosted), его рабочим процессам и [другим охватываемым фоновым процессам](https://code.claude.com/docs/ru/corporate-launcher.md#what-the-launcher-covers) с требуемым корпоративным запускателем вместо отключения представления агента | `processWrapper` |

104| [Ограничения модели](https://code.claude.com/docs/ru/model-config.md#restrict-model-selection) | `availableModels` фильтрует, какие модели появляются в средстве выбора. Добавление `enforceAvailableModels` также ограничивает автоматически выбранную модель по умолчанию. См. [охват поверхности](https://code.claude.com/docs/ru/model-config.md#surface-coverage) для того, как этот параметр достигает CLI, веб-интерфейса и IDE | `availableModels`, `enforceAvailableModels` |104| [Ограничения модели](https://code.claude.com/docs/ru/model-config.md#restrict-model-selection) | `availableModels` фильтрует, какие модели появляются в средстве выбора. Добавление `enforceAvailableModels` также ограничивает автоматически выбранную модель по умолчанию. См. [охват поверхности](https://code.claude.com/docs/ru/model-config.md#surface-coverage) для того, как этот параметр достигает CLI, веб-интерфейса и IDE | `availableModels`, `enforceAvailableModels` |

105| [Ограничение усилий](https://code.claude.com/docs/ru/settings-reference.md#maxeffortlevel) | Ограничить [уровень усилий](https://code.claude.com/docs/ru/model-config.md#adjust-effort-level) для каждой модели или для каждого поставщика | `maxEffortLevel` |105| [Ограничение усилий](https://code.claude.com/docs/ru/settings-reference.md#maxeffortlevel) | Ограничить [уровень усилий](https://code.claude.com/docs/ru/model-config.md#adjust-effort-level) для всех моделей сразу или для каждой модели отдельно, у любого поставщика | `maxEffortLevel` |

106| [Минимальная версия](https://code.claude.com/docs/ru/settings-reference.md#minimumversion) | Предотвратить автоматическое обновление от установки ниже минимума на уровне организации | `minimumVersion` |106| [Минимальная версия](https://code.claude.com/docs/ru/settings-reference.md#minimumversion) | Предотвратить автоматическое обновление от установки ниже минимума на уровне организации | `minimumVersion` |

107| [Требуемый диапазон версий](https://code.claude.com/docs/ru/settings-reference.md#requiredminimumversion) | Отказать в запуске вообще, когда работающая версия находится вне одобренного организацией диапазона. Сильнее, чем `minimumVersion`, который только блокирует понижения версии | `requiredMinimumVersion`, `requiredMaximumVersion` |107| [Требуемый диапазон версий](https://code.claude.com/docs/ru/settings-reference.md#requiredminimumversion) | Отказать в запуске вообще, когда работающая версия находится вне одобренного организацией диапазона. Сильнее, чем `minimumVersion`, который только блокирует понижения версии | `requiredMinimumVersion`, `requiredMaximumVersion` |

108| [Отказ от телеметрии](https://code.claude.com/docs/ru/data-usage.md#telemetry-services) | Отключить метрики использования, привязанные к Anthropic, отчёты об ошибках и опросы на каждом устройстве | `env` с `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, установленным на `1`; связанный раздел содержит переменные по категориям |108| [Отказ от телеметрии](https://code.claude.com/docs/ru/data-usage.md#telemetry-services) | Отключить метрики использования, привязанные к Anthropic, отчёты об ошибках и опросы на каждом устройстве | `env` с `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, установленным на `1`; связанный раздел содержит переменные по категориям |

Details

211. **Получить запрос.** Claude получает ваш запрос вместе с системным запросом, определениями инструментов и историей разговора. SDK выдает [`SystemMessage`](#message-types) с подтипом `"init"`, содержащий метаданные сессии.211. **Получить запрос.** Claude получает ваш запрос вместе с системным запросом, определениями инструментов и историей разговора. SDK выдает [`SystemMessage`](#message-types) с подтипом `"init"`, содержащий метаданные сессии.

222. **Оценить и ответить.** Claude оценивает текущее состояние и определяет, как действовать дальше. Он может ответить текстом, запросить один или несколько вызовов инструментов или оба варианта. SDK выдает один или несколько объектов [`AssistantMessage`](#message-types), по одному для каждого блока содержимого, такого как текстовый блок или запрос вызова инструмента.222. **Оценить и ответить.** Claude оценивает текущее состояние и определяет, как действовать дальше. Он может ответить текстом, запросить один или несколько вызовов инструментов или оба варианта. SDK выдает один или несколько объектов [`AssistantMessage`](#message-types), по одному для каждого блока содержимого, такого как текстовый блок или запрос вызова инструмента.

233. **Выполнить инструменты.** SDK запускает каждый запрошенный инструмент и собирает результаты. Каждый набор результатов инструментов возвращается Claude для следующего решения. Вы можете использовать [hooks](https://code.claude.com/docs/ru/agent-sdk/hooks.md) для перехвата, изменения или блокировки вызовов инструментов перед их выполнением.233. **Выполнить инструменты.** SDK запускает каждый запрошенный инструмент и собирает результаты. Каждый набор результатов инструментов возвращается Claude для следующего решения. Вы можете использовать [hooks](https://code.claude.com/docs/ru/agent-sdk/hooks.md) для перехвата, изменения или блокировки вызовов инструментов перед их выполнением.

244. **Повторить.** Шаги 2 и 3 повторяются как цикл. Каждый полный цикл — это один ход. Claude продолжает вызывать инструменты и обрабатывать результаты до тех пор, пока не выдаст ответ без вызовов инструментов.244. **Повторить.** Шаги 2 и 3 повторяются как цикл. Claude продолжает вызывать инструменты и обрабатывать результаты до тех пор, пока не выдаст ответ без вызовов инструментов.

255. **Вернуть результат.** SDK выдает финальное [`AssistantMessage`](#message-types) с текстовым ответом (без вызовов инструментов), за которым следует [`ResultMessage`](#message-types) с финальным текстом, использованием токенов, стоимостью и ID сессии.255. **Вернуть результат.** SDK выдает финальное [`AssistantMessage`](#message-types) с текстовым ответом (без вызовов инструментов), за которым следует [`ResultMessage`](#message-types) с финальным текстом, использованием токенов, стоимостью и ID сессии.

26 26 

27Быстрый вопрос («какие файлы здесь?») может занять один или два хода вызова `Glob` и ответа с результатами. Сложная задача («рефакторить модуль аутентификации и обновить тесты») может связать десятки вызовов инструментов на протяжении многих ходов, читая файлы, редактируя код и запуская тесты, при этом Claude корректирует свой подход на основе каждого результата.27Быстрый вопрос, например «какие файлы здесь?», может занять два или три [хода](#turns-and-messages): один или два с вызовом `Glob`, затем один с ответом, содержащим результаты. Сложная задача, например «выполни рефакторинг модуля аутентификации и обнови тесты», может связать десятки вызовов инструментов на протяжении многих ходов, поскольку Claude корректирует свои действия после каждого результата.

28 28 

29## Ходы и сообщения29## Ходы и сообщения

30 30 

31Ход — это один цикл внутри цикла: Claude выдает выход, который включает вызовы инструментов, SDK выполняет эти инструменты, и результаты автоматически возвращаются Claude. Это происходит без возврата управления вашему коду. Ходы продолжаются до тех пор, пока Claude не выдаст выход без вызовов инструментов, после чего цикл заканчивается и доставляется финальный результат.31Ход — это один проход цикла: Claude выдает выход, и если он включает вызовы инструментов, SDK выполняет их, а результаты автоматически возвращаются Claude. Это происходит без возврата управления вашему коду. Ходы продолжаются до тех пор, пока Claude не выдаст выход без вызовов инструментов, после чего цикл заканчивается и доставляется финальный результат.

32 32 

33Рассмотрим, как может выглядеть полная сессия для запроса «Исправить неудачные тесты в auth.ts».33Рассмотрим, как может выглядеть полная сессия для запроса «Исправить неудачные тесты в auth.ts».

34 34 

Details

1274| `updated_input` | `dict[str, Any] \| None` | `None` | Изменённые входные данные для использования вместо исходных |1274| `updated_input` | `dict[str, Any] \| None` | `None` | Изменённые входные данные для использования вместо исходных |

1275| `updated_permissions` | `list[PermissionUpdate] \| None` | `None` | Применяемые обновления разрешений |1275| `updated_permissions` | `list[PermissionUpdate] \| None` | `None` | Применяемые обновления разрешений |

1276 1276 

1277Если вы возвращаете `PermissionResultAllow` с более чем 4 096 элементами в `updated_permissions`, Claude Code считает результат недопустимым и отклоняет вызов инструмента. Каждый [`PermissionUpdate`](#permissionupdate) считается одним элементом, как и каждая запись в его списке `rules` или `directories`. Сообщение об отклонении заканчивается текстом `updatedPermissions may hold at most 4096 updates, rules and directories in all.` Чтобы избежать отклонения, возвращайте не более 4 096 элементов.

1278 

1277### `PermissionResultDeny`1279### `PermissionResultDeny`

1278 1280 

1279Результат, указывающий, что вызов инструмента должен быть отклонён.1281Результат, указывающий, что вызов инструмента должен быть отклонён.

Details

1156 1156 

1157Добавленная папка остаётся частью сессии. Когда вы снова вызываете `reloadPlugins()`, Claude Code перезагружает её вместе с другими плагинами, и передавать её в `addPlugins` повторно не нужно.1157Добавленная папка остаётся частью сессии. Когда вы снова вызываете `reloadPlugins()`, Claude Code перезагружает её вместе с другими плагинами, и передавать её в `addPlugins` повторно не нужно.

1158 1158 

1159##### Когда `reloadPlugins()` не загружает папки из `addPlugins`1159##### Когда `reloadPlugins()` не загружает папки `addPlugins`

1160 1160 

1161Если `reloadPlugins()` отклоняется, ни одна из папок `addPlugins` не добавляется, поэтому при повторной попытке снова передайте их в `addPlugins`. Если отклонение вызвано одной из следующих причин, сессия сохраняет уже имевшиеся плагины:1161Если `reloadPlugins()` отклоняется, ни одна из папок `addPlugins` не добавляется, поэтому при повторной попытке снова передайте их в `addPlugins`. Если отклонение вызвано одной из следующих причин, сессия сохраняет уже имевшиеся плагины:

1162 1162 


1405 };1405 };

1406```1406```

1407 1407 

1408Если вы возвращаете `allow` с более чем 4096 элементами в `updatedPermissions`, Claude Code считает результат недопустимым и отклоняет вызов инструмента. Каждое обновление считается одним элементом, как и каждая запись в его списке `rules` или `directories`. Сообщение об отказе заканчивается на `updatedPermissions may hold at most 4096 updates, rules and directories in all`. Чтобы вызов был разрешён, возвращайте не более 4096 элементов.1408Если вы возвращаете `allow` с более чем 4 096 элементами в `updatedPermissions`, Claude Code считает результат недействительным и отклоняет вызов инструмента. Каждое обновление считается одним элементом, как и каждая запись в его списке `rules` или `directories`. Сообщение об отказе заканчивается на `updatedPermissions may hold at most 4096 updates, rules and directories in all.` Чтобы вызов был разрешён, возвращайте не более 4 096 элементов.

1409 1409 

1410### `ToolConfig`1410### `ToolConfig`

1411 1411 


4704 humanSchedule: string;4704 humanSchedule: string;

4705 recurring: boolean;4705 recurring: boolean;

4706 durable?: boolean; // true when persisted to .claude/scheduled_tasks.json; false when session-only4706 durable?: boolean; // true when persisted to .claude/scheduled_tasks.json; false when session-only

4707 nextFireAt?: number;

4707};4708};

4708```4709```

4709 4710 

4710Возвращает идентификатор задания и понятное человеку описание расписания.4711Возвращает идентификатор задания, понятное человеку описание расписания и время следующего запуска. `nextFireAt` указывает это время в миллисекундах от эпохи с уже применённым [джиттером](https://code.claude.com/docs/ru/scheduled-tasks.md#jitter), то есть это момент, на который назначен запуск задания. Для этого поля требуется TypeScript Agent SDK v0.3.299 или новее и Claude Code v2.1.299 или новее.

4711 4712 

4712### CronDelete4713### CronDelete

4713 4714 


4734 prompt: string;4735 prompt: string;

4735 recurring?: boolean;4736 recurring?: boolean;

4736 durable?: boolean;4737 durable?: boolean;

4738 nextFireAt?: number;

4737 }[];4739 }[];

4738};4740};

4739```4741```

4740 4742 

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

4742 4744 

4745`nextFireAt` — время следующего запуска задания в миллисекундах от эпохи с учётом [джиттера](https://code.claude.com/docs/ru/scheduled-tasks.md#jitter). Ни одно значение не бывает раньше момента вызова `CronList`: задание, время которого [прошло без запуска](https://code.claude.com/docs/ru/scheduled-tasks.md#how-scheduled-tasks-run), содержит время вызова. Для этого поля требуется TypeScript Agent SDK v0.3.299 или новее и Claude Code v2.1.299 или новее.

4746 

4743### ScheduleWakeup4747### ScheduleWakeup

4744 4748 

4745**Имя инструмента:** `ScheduleWakeup`4749**Имя инструмента:** `ScheduleWakeup`


5457};5461};

5458```5462```

5459 5463 

5464Промис `setMcpServers()` разрешается после того, как вновь добавленные stdio-, HTTP- и SSE-серверы подключатся или не смогут подключиться, поэтому инструменты подключившихся серверов доступны на следующем ходу.

5465 

5460Когда вы вызываете `setMcpServers()`, Claude Code применяет следующие правила:5466Когда вы вызываете `setMcpServers()`, Claude Code применяет следующие правила:

5461 5467 

5462* **Серверы, которые вызов не называет**: вне [облачной сессии](https://code.claude.com/docs/ru/claude-code-on-the-web.md) Claude Code отключает серверы, добавленные предыдущим вызовом `setMcpServers()`, и встроенные в процесс SDK-серверы, и перечисляет их в `removed`. Остальные серверы продолжают работать и не перечисляются в `removed`, в том числе stdio-, HTTP- и SSE-серверы из опции [`mcpServers`](#options), серверы из файлов настроек и серверы, предоставленные плагинами.5468* **Серверы, которые вызов не называет**: вне [облачной сессии](https://code.claude.com/docs/ru/claude-code-on-the-web.md) Claude Code отключает серверы, добавленные предыдущим вызовом `setMcpServers()`, и встроенные в процесс SDK-серверы, и перечисляет их в `removed`. Остальные серверы продолжают работать и не перечисляются в `removed`, в том числе stdio-, HTTP- и SSE-серверы из опции [`mcpServers`](#options), серверы из файлов настроек и серверы, предоставленные плагинами.


5466* **Встроенные серверы, которые CLI запустил при старте**: если вызов называет такой сервер, Claude Code отбрасывает эту запись и сообщает о ней в `errors`.5472* **Встроенные серверы, которые CLI запустил при старте**: если вызов называет такой сервер, Claude Code отбрасывает эту запись и сообщает о ней в `errors`.

5467* **Stdio-, HTTP- или SSE-серверы, имя которых совпадает с именем сервера из области действия установки MCP, например `.mcp.json`**: под этим именем сессия использует инструменты вашего сервера, а не [сервера из области действия установки](https://code.claude.com/docs/ru/mcp.md#mcp-installation-scopes). До Claude Code v2.1.305 Claude Code мог отключить ваш сервер и подключить сервер из области действия установки, когда ваше приложение [перезагружало плагины](#query-object).5473* **Stdio-, HTTP- или SSE-серверы, имя которых совпадает с именем сервера из области действия установки MCP, например `.mcp.json`**: под этим именем сессия использует инструменты вашего сервера, а не [сервера из области действия установки](https://code.claude.com/docs/ru/mcp.md#mcp-installation-scopes). До Claude Code v2.1.305 Claude Code мог отключить ваш сервер и подключить сервер из области действия установки, когда ваше приложение [перезагружало плагины](#query-object).

5468 5474 

5469Промис разрешается после того, как вновь добавленные stdio-, HTTP- и SSE-серверы подключатся или не смогут подключиться, поэтому инструменты подключившихся серверов доступны на следующем ходу.

5470 

5471`added` перечисляет серверы, которые Claude Code добавил или заменил, независимо от того, подключились они или нет. Сервер, который не смог подключиться, появляется и в `added`, и в `errors`, с текстом ошибки в `errors` и строкой `failed` в [`mcpServerStatus()`](#methods). До Claude Code v2.1.257 сервер, попытка подключения которого выбросила исключение, сообщался только в `errors`.5475`added` перечисляет серверы, которые Claude Code добавил или заменил, независимо от того, подключились они или нет. Сервер, который не смог подключиться, появляется и в `added`, и в `errors`, с текстом ошибки в `errors` и строкой `failed` в [`mcpServerStatus()`](#methods). До Claude Code v2.1.257 сервер, попытка подключения которого выбросила исключение, сообщался только в `errors`.

5472 5476 

5477Значение в `errors`, начинающееся с `Blocked by enterprise`, означает, что сервер отклонила политика, а не что подключение не удалось:

5478 

5479* `Blocked by enterprise policy (allowedMcpServers/deniedMcpServers)`: сервера нет в `added`. Ему соответствует запись [`deniedMcpServers`](https://code.claude.com/docs/ru/managed-mcp#policy-based-control-with-allowlists-and-denylists), либо задан список `allowedMcpServers`, в котором он отсутствует. Если этот список находится в файле настроек, который вы загружаете через [`settingSources`](#options), отредактируйте файл. Если он находится в управляемых настройках, попросите администраторов изменить его.

5480* `Blocked by enterprise managed policy`: сервер есть в `added`, и для него в `mcpServerStatus()` есть строка `failed`. Спросите администратора, какая политика его блокирует.

5481 

5473### `RewindFilesResult`5482### `RewindFilesResult`

5474 5483 

5475Результат операции `rewindFiles()`.5484Результат операции `rewindFiles()`.

Details

17 17 

18Если браузер не открывается автоматически, нажмите `c`, чтобы скопировать URL для входа в буфер обмена, а затем вставьте его в браузер.18Если браузер не открывается автоматически, нажмите `c`, чтобы скопировать URL для входа в буфер обмена, а затем вставьте его в браузер.

19 19 

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

21 21 

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

23 23 


127Вы не получаете выбор на каждой машине. Claude Code создает ключ API без запроса в этих случаях:127Вы не получаете выбор на каждой машине. Claude Code создает ключ API без запроса в этих случаях:

128 128 

129* Вы работаете с облачным провайдером, таким как [Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](https://code.claude.com/docs/ru/third-party-integrations.md) или [Claude Platform on AWS](https://code.claude.com/docs/ru/claude-platform-on-aws.md)129* Вы работаете с облачным провайдером, таким как [Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](https://code.claude.com/docs/ru/third-party-integrations.md) или [Claude Platform on AWS](https://code.claude.com/docs/ru/claude-platform-on-aws.md)

130* Любой файл параметров устанавливает [`forceLoginOrgUUID`](#restrict-login-to-your-organization), или устанавливает `forceLoginMethod` на `"claudeai"` или `"console"`130* Любой файл настроек задаёт [`forceLoginOrgUUID`](#restrict-login-to-your-organization) или устанавливает `forceLoginMethod` в значение `"claudeai"`

131* `forceLoginMethod` имеет значение `"console"`, и ни один файл настроек не задаёт `forceLoginOrgUUID` — пока вы не повторите попытку с экрана ошибки после неудачного входа

131* На вашей машине существует источник управляемых параметров, такой как файл управляемых параметров, профиль MDM или кэшированные параметры, управляемые сервером, но Claude Code [не может его прочитать](https://code.claude.com/docs/ru/managed-settings.md#invalid-entries-in-managed-settings) и никакой другой управляемый источник не предоставляет политику132* На вашей машине существует источник управляемых параметров, такой как файл управляемых параметров, профиль MDM или кэшированные параметры, управляемые сервером, но Claude Code [не может его прочитать](https://code.claude.com/docs/ru/managed-settings.md#invalid-entries-in-managed-settings) и никакой другой управляемый источник не предоставляет политику

132 133 

133Отмените установку `ANTHROPIC_API_KEY` перед входом без ключа.134Отмените установку `ANTHROPIC_API_KEY` перед входом без ключа.


140 141 

141Все остальное о профилях применяется к этому входу, включая его ранжирование по сравнению с вашими другими учетными данными, строку `Profile`, которую вы получаете в `/status`, и функции, которые требуют входа claude.ai. См. [Профили Anthropic и учетные данные федерации](#anthropic-profiles-and-federation-credentials).142Все остальное о профилях применяется к этому входу, включая его ранжирование по сравнению с вашими другими учетными данными, строку `Profile`, которую вы получаете в `/status`, и функции, которые требуют входа claude.ai. См. [Профили Anthropic и учетные данные федерации](#anthropic-profiles-and-federation-credentials).

142 143 

144#### Отключение входа без ключа на управляемых машинах

145 

146Чтобы Claude Code перестал предлагать [вход без ключа](#sign-in-without-an-api-key), с помощью инструментов управления устройствами разверните [`forceLoginOrgUUID`](https://code.claude.com/docs/ru/settings-reference#forceloginorguuid) в [управляемых настройках](https://code.claude.com/docs/ru/managed-settings.md) на машине каждого разработчика. Укажите в нём [ID вашей организации Console](https://platform.claude.com/settings/organization). Перед развёртыванием убедитесь, что у каждого разработчика есть [роль, позволяющая создавать API-ключи](#claude-console-authentication). После развёртывания разработчик без такой роли не сможет войти в Console через `/login`.

147 

148Если задан только `forceLoginMethod` со значением `"console"`, разработчики могут повторить попытку после неудачного входа и выбрать вариант без ключа. После развёртывания `forceLoginOrgUUID` экран входа больше не показывает этот вариант, но разработчики по-прежнему могут использовать [профиль Anthropic](#anthropic-profiles-and-federation-credentials), который у них уже есть или который они создадут с помощью [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication). После развёртывания разберитесь со следующими учётными данными и входами на каждой машине:

149 

150* **Входы без ключа**: чтобы перевести разработчика на API-ключ, попросите его выйти и снова войти в Console — при этом будет создан ключ. Для входа без ключа он выполняет `claude auth logout` в своей оболочке. Для профиля `ant auth login` он выполняет `ant auth logout`. Claude Code отклоняет сессию, если на машине есть и профиль, и API-ключ, поэтому сначала нужно выйти.

151* **Учётные данные из окружения и хелпера**: Claude Code отклоняет сессии, которые аутентифицируются с помощью `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, даже если их предоставляют управляемые настройки. Удалите эти учётные данные, затем попросите разработчиков выполнить `/login`, чтобы создать сохранённый API-ключ.

152* **Входы claude.ai**: Claude Code [отклоняет вход](#restrict-login-to-your-organization) в организацию, которую вы не указали, включая ту, что уже используется на машине. Чтобы сохранить её, добавьте её в массив `forceLoginOrgUUID`.

153 

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

144 155 

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


172* **`claude setup-token` и `/install-github-app`**: применяют только `forceLoginMethod`, поэтому они могут создать токен в другой организации183* **`claude setup-token` и `/install-github-app`**: применяют только `forceLoginMethod`, поэтому они могут создать токен в другой организации

173* **Вход [шлюза](https://code.claude.com/docs/ru/claude-apps-gateway)**: выбирается `forceLoginMethod: "gateway"` вместо ограничения им, и не аутентифицируется против организации Anthropic, поэтому `forceLoginOrgUUID` не применяется; используйте поставщика удостоверений вашего шлюза для ограничения доступа184* **Вход [шлюза](https://code.claude.com/docs/ru/claude-apps-gateway)**: выбирается `forceLoginMethod: "gateway"` вместо ограничения им, и не аутентифицируется против организации Anthropic, поэтому `forceLoginOrgUUID` не применяется; используйте поставщика удостоверений вашего шлюза для ограничения доступа

174 185 

175Развертывайте ключи через инструменты управления устройствами. [Параметры, управляемые сервером](https://code.claude.com/docs/ru/server-managed-settings.md), достигают только учетных записей, которые уже аутентифицированы в вашей организации, поэтому они не могут перенаправить первый вход разработчика. Если ваша организация также распределяет параметры, управляемые сервером, установите ключи в обоих местах: управляемые источники [не объединяются](https://code.claude.com/docs/ru/server-managed-settings.md#settings-precedence), и кэшированные параметры, управляемые сервером, заменяют файл, управляемый устройством, за исключением нескольких [исключений для каждого ключа](https://code.claude.com/docs/ru/server-managed-settings.md#per-key-exceptions-across-managed-sources). `forceLoginOrgUUID` и значения `"claudeai"` и `"console"` `forceLoginMethod` не входят в эти исключения, поэтому держите их в обоих местах.186Развёртывайте `forceLoginMethod` и `forceLoginOrgUUID` через инструменты управления устройствами. Разработчик получает [настройки, управляемые сервером](https://code.claude.com/docs/ru/server-managed-settings.md), только после аутентификации в вашей организации, поэтому перенаправить первый вход с помощью этих настроек нельзя. Если вы также распространяете настройки, управляемые сервером, из claude.ai, задайте оба ключа и там, пока все клиенты не будут работать на v2.1.299 или новее. О том, где задавать ключи в дальнейшем и значение какого источника применяется, см. [Какой управляемый источник предоставляет ключи входа](https://code.claude.com/docs/ru/managed-settings.md#which-managed-source-supplies-login-keys).

176 187 

177При развертывании [шлюза](https://code.claude.com/docs/ru/claude-apps-gateway) также держите `forceLoginMethod` и `forceLoginOrgUUID` вне [параметров, которые служит шлюз](https://code.claude.com/docs/ru/claude-apps-gateway-config.md#managed).188При развертывании [шлюза](https://code.claude.com/docs/ru/claude-apps-gateway) также держите `forceLoginMethod` и `forceLoginOrgUUID` вне [параметров, которые служит шлюз](https://code.claude.com/docs/ru/claude-apps-gateway-config.md#managed).

178 189 

checkpointing.md +26 −26

Details

8 8 

9Claude Code автоматически отслеживает правки файлов Claude по мере работы, позволяя вам быстро отменять изменения и возвращаться к предыдущим состояниям, если что-то пойдёт не так.9Claude Code автоматически отслеживает правки файлов Claude по мере работы, позволяя вам быстро отменять изменения и возвращаться к предыдущим состояниям, если что-то пойдёт не так.

10 10 

11## Как работает checkpointing11## Как работают чекпоинты

12 12 

13По мере работы с Claude, checkpointing автоматически фиксирует состояние вашего кода перед каждым запросом, который вы отправляете и который начинает новый ход.13Когда вы работаете с Claude, функция чекпоинтов автоматически сохраняет состояние вашего кода перед каждым отправленным вами промптом, который начинает ход.

14 14 

15### Автоматическое отслеживание15### Автоматическое отслеживание

16 16 

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

18 18 

19* Каждый запрос, который вы отправляете и который начинает новый ход, создаёт новый checkpoint19* Каждый отправленный вами промпт, который начинает ход, создаёт новый чекпоинт

20* Claude Code хранит снимки файлов для 100 самых последних checkpoints в сеансе. Удаление старого checkpoint удаляет файлы снимков, на которые не ссылается ни один оставшийся checkpoint, за исключением первого снимка каждого файла, который расширение VS Code использует в качестве базовой линии для различий сеанса.20* Claude Code хранит снимки файлов для 100 последних чекпоинтов в сессии. При удалении более старого чекпоинта удаляются файлы снимков, на которые не ссылается ни один из оставшихся чекпоинтов, за исключением первого снимка каждого файла, который расширение VS Code использует как базовую версию для diff сессии.

21* Claude Code сохраняет checkpoints с беседой, поэтому вы всё ещё можете запустить `/rewind` после возобновления сеанса21* Claude Code сохраняет чекпоинты вместе с диалогом, поэтому вы можете выполнить `/rewind` и после возобновления сессии

22* Claude Code удаляет снимки файлов сеанса в [процессе очистки](https://code.claude.com/docs/ru/claude-directory.md#cleaned-up-automatically), по умолчанию примерно через 30 дней после последнего сохранения сеанса. Перемотка к checkpoint, снимки которого удалены, может завершиться ошибкой [`No files were restored`](https://code.claude.com/docs/ru/errors#no-files-were-restored). Чтобы сохранять снимки дольше, установите [`cleanupPeriodDays`](https://code.claude.com/docs/ru/settings-reference#cleanupperioddays).22* Claude Code удаляет снимки файлов сессии при [плановой очистке](https://code.claude.com/docs/ru/claude-directory.md#cleaned-up-automatically), по умолчанию примерно через 30 дней после того, как сессия в последний раз сохранила снимок. Откат к чекпоинту, снимки которого уже удалены, может завершиться ошибкой [`No files were restored`](https://code.claude.com/docs/ru/errors#no-files-were-restored). Чтобы хранить снимки дольше, задайте параметр [`cleanupPeriodDays`](https://code.claude.com/docs/ru/settings-reference#cleanupperioddays).

23 23 

24### Перемотка и суммирование24### Откат и сжатие в сводку

25 25 

26Запустите `/rewind` или нажмите `Esc` дважды, когда поле ввода запроса пусто, чтобы открыть меню перемотки.26Выполните `/rewind` или дважды нажмите `Esc`, когда поле ввода промпта пусто, чтобы открыть меню отката.

27 27 

28> [!NOTE]28> [!NOTE]

29>29>

30> Если поле ввода запроса содержит текст, двойное нажатие `Esc` очищает его вместо открытия меню. Очищенный текст сохраняется в историю ввода, поэтому нажмите `Up`, чтобы вспомнить его после завершения работы в меню перемотки.30> Если в поле ввода промпта есть текст, двойное нажатие `Esc` очищает его вместо открытия меню. Очищенный текст сохраняется в истории ввода, поэтому нажмите `Up`, чтобы вернуть его после завершения работы в меню отката.

31 31 

32Меню перемотки отображает промпты, которые вы отправили во время сессии. Выберите точку, к которой хотите применить действие, затем выберите действие:32В меню отката перечислены промпты, которые вы отправили в ходе сессии. Выберите точку, с которой хотите работать, а затем выберите действие:

33 33 

34* **Восстановить код и беседу**: вернуть как код, так и беседу в эту точку34* **Restore code and conversation**: вернуть и код, и диалог к этой точке

35* **Восстановить беседу**: перемотать к этому сообщению, сохраняя текущий код35* **Restore conversation**: откатиться к этому сообщению, сохранив текущий код

36* **Восстановить код**: отменить изменения файлов, сохраняя беседу36* **Restore code**: отменить изменения файлов, сохранив диалог

37* **Суммировать отсюда**: сжать беседу с этой точки вперёд в краткое резюме, освобождая место в context window37* **Summarize from here**: сжать диалог начиная с этой точки в сводку, освобождая место в контекстном окне

38* **Суммировать до этого момента**: сжать беседу перед этой точкой в краткое резюме, сохраняя более поздние сообщения нетронутыми38* **Summarize up to here**: сжать диалог до этой точки в сводку, сохранив последующие сообщения без изменений

39* **Отмена**: вернуться к списку сообщений без внесения изменений39* **Never mind**: вернуться к списку сообщений, ничего не меняя

40 40 

41Два варианта восстановления кода появляются только тогда, когда выбранный checkpoint имеет отслеживаемые изменения файлов для отката. Если после этой точки не было захвачено никаких редактирований файлов, меню предлагает только **Восстановить беседу**, варианты суммирования и **Отмена**.41Два варианта восстановления кода появляются, только если у выбранного чекпоинта есть отслеживаемые изменения файлов, которые можно отменить. Если после этой точки не было зафиксировано правок файлов, меню предлагает только **Restore conversation**, варианты сжатия в сводку и **Never mind**.

42 42 

43После восстановления беседы или выбора "Суммировать отсюда" исходный запрос из выбранного сообщения восстанавливается в поле ввода, чтобы вы могли переотправить или отредактировать его.43После восстановления диалога или выбора Summarize from here исходный промпт из выбранного сообщения возвращается в поле ввода, чтобы вы могли отправить его повторно или отредактировать.

44 44 

45Выбор "Суммировать до этого момента" оставляет вас в конце беседы с пустым полем ввода. При любом варианте суммирования в беседе появляется маркер **Summarized conversation** в месте, где были сжаты сообщения.45При выборе Summarize up to here вы остаётесь в конце диалога с пустым полем ввода. При любом из вариантов сжатия в диалоге на месте сжатых сообщений появляется отметка **Summarized conversation**.

46 46 

47#### Перемотанные сообщения могут вернуться, если вы выйдете до следующего промпта47#### Откаченные сообщения могут вернуться, если вы выйдете до следующего промпта

48 48 

49Чтобы снова удалить вернувшиеся сообщения, запустите `/rewind` в сессии и выберите тот же промпт, затем **Восстановить диалог**. Перед выходом отправьте Claude промпт, потому что Claude Code сохраняет перемотанный диалог вместе с этим промптом. Восстановленные вами файлы остаются в том состоянии, в котором их оставила перемотка.49Чтобы снова удалить вернувшиеся сообщения, выполните `/rewind` в этой сессии, выберите тот же промпт, а затем **Restore conversation**. Перед выходом отправьте Claude промпт, поскольку Claude Code сохраняет откаченный диалог вместе с этим промптом. Восстановленные вами файлы остаются в том состоянии, в котором их оставил откат.

50 50 

51#### Перемотка прошлой очищенной беседы51#### Откат за пределы очищенного диалога

52 52 

53Если вы запустили `/clear` ранее в том же процессе Claude Code, меню перемотки показывает дополнительную запись в верхней части списка с меткой `/resume <session-id> (previous session)`. Выберите её, чтобы возобновить беседу, которая была активна до запуска `/clear`. Запись доступна до тех пор, пока вы не выйдете из Claude Code или не возобновите другой сеанс.53Если ранее в том же процессе Claude Code вы выполняли `/clear`, в меню отката в верхней части списка появляется дополнительная запись с меткой `/resume <session-id> (previous session)`. Выберите её, чтобы возобновить диалог, который был активен до выполнения `/clear`. Эта запись доступна, пока вы не выйдете из Claude Code или не возобновите другую сессию.

54 54 

55#### Руководство для суммирования55#### Управление содержанием сводки

56 56 

57Суммирование не изменяет файлы на диске, и исходные сообщения остаются в стенограмме сеанса, поэтому Claude всё ещё может ссылаться на детали. Чтобы направить внимание суммирования, выделите опцию **Summarize** клавишами со стрелками и введите инструкции там, где в строке написано **add context (optional)**, затем нажмите `Enter`. Выбор опции с её номером выполняет суммирование немедленно без инструкций.57Сжатие в сводку не изменяет файлы на диске, а исходные сообщения остаются в транскрипте сессии, поэтому Claude по-прежнему может обращаться к деталям. Чтобы задать, на чём должна сосредоточиться сводка, выделите вариант **Summarize** клавишами со стрелками и введите инструкции в строке с надписью **add context (optional)**, а затем нажмите `Enter`. Если выбрать вариант клавишей с его номером, сводка создаётся сразу, без инструкций.

58 58 

59> [!NOTE]59> [!NOTE]

60>60>

61> Суммирование держит вас в одном сеансе и сжимает контекст, как целевой `/compact`. Чтобы ответвиться и попробовать другой подход, сохраняя исходный сеанс нетронутым, используйте вместо этого [`/branch`](https://code.claude.com/docs/ru/sessions#branch-a-session) или `claude --continue --fork-session`.61> Сжатие в сводку оставляет вас в той же сессии и сжимает контекст, подобно целенаправленной команде `/compact`. Чтобы создать ответвление и попробовать другой подход, сохранив исходную сессию нетронутой, используйте вместо этого [`/branch`](https://code.claude.com/docs/ru/sessions#branch-a-session) или `claude --continue --fork-session`.

62 62 

63## Типичные случаи использования63## Типичные случаи использования

64 64 

chrome.md +21 −21

Details

59claude --chrome59claude --chrome

60```60```

61 61 

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

63 63 

64Чтобы включить Chrome для будущих сессий без флага, см. [Включение Chrome по умолчанию](#enable-chrome-by-default).64Чтобы включить Chrome для будущих сессий без флага, см. раздел [Включение Chrome по умолчанию](#enable-chrome-by-default).

65 65 

66**2. Попросите Claude использовать браузер**66**2. Попросите Claude использовать браузер**

67 67 

68Этот пример переходит на страницу, взаимодействует с ней и сообщает, что он находит, всё из вашего терминала или редактора:68В этом примере Claude переходит на страницу, взаимодействует с ней и сообщает о том, что обнаружил, — всё это прямо из вашего терминала или редактора:

69 69 

70```text wrap theme={null}70```text wrap theme={null}

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

72type "hooks", and tell me what results appear72type "hooks", and tell me what results appear

73```73```

74 74 

75Если Claude Code запрашивает разрешение перед действием в браузере, одобрите его. Диалоговое окно начинается со слов `Claude in Chrome wants to` и предлагает вариант разрешить все действия на этом сайте на время сессии. Claude откроет новую вкладку и начнёт выполнение задачи.75Если Claude Code запрашивает разрешение перед действием в браузере, подтвердите его. Диалоговое окно начинается с `Claude in Chrome wants to` и предлагает вариант разрешить все действия на этом сайте на время сессии. Claude открывает новую вкладку и приступает к задаче.

76 76 

77Выполните `/chrome` в любое время, чтобы проверить статус подключения, управлять разрешениями, переподключить расширение или выбрать, какой подключённый браузер использовать. Интеграция работает, когда панель статуса показывает «Статус: включено» и «Расширение: установлено».77Выполните `/chrome` в любой момент, чтобы проверить статус подключения, управлять разрешениями, переподключить расширение или выбрать, какой из подключённых браузеров использовать. Интеграция работает, если на панели статуса отображаются `Status: Enabled` и `Extension: Installed`.

78 78 

79Если подключено более одного браузера, вы выбираете, какой из них использует Claude. Если действие в браузере начинается до того, как вы сделали выбор, Claude предложит вам выбрать один. Чтобы позже сменить браузер, выполните `/chrome` и выберите **Выбрать браузер…**. Claude продолжает использовать ваш выбор, даже когда подключается другой браузер.79Если подключено несколько браузеров, вы выбираете, какой из них использует Claude. Если действие в браузере начинается до того, как вы сделали выбор, Claude предложит выбрать браузер. Чтобы позже переключить браузер, выполните `/chrome` и выберите **Select browser…**. Claude продолжает использовать выбранный вами браузер, даже когда подключается другой.

80 80 

81Для VS Code см. [автоматизацию браузера в VS Code](https://code.claude.com/docs/ru/vs-code.md#automate-browser-tasks-with-chrome).81Для VS Code см. раздел [автоматизация браузера в VS Code](https://code.claude.com/docs/ru/vs-code.md#automate-browser-tasks-with-chrome).

82 82 

83### Установка расширения по запросу Claude83### Установка расширения по запросу Claude

84 84 

85Когда Claude нужен ваш браузер в интерактивной сессии, а Claude Code не обнаруживает расширение, Claude Code показывает запрос на установку с заголовком «Claude хочет использовать ваш браузер». Claude Code спрашивает не более одного раза за сессию.85Когда Claude нужен ваш браузер в интерактивной сессии, а Claude Code не обнаруживает расширение, Claude Code показывает запрос на установку с заголовком «Claude wants to use your browser». Claude Code задаёт этот вопрос не более одного раза за сессию.

86 86 

87Запрос предлагает три варианта:87Запрос предлагает три варианта:

88 88 

89* **Установить расширение**: открывает страницу установки расширения в вашем браузере и запускает пошаговую настройку. Claude Code ожидает установки, подключает расширение и включает инструменты браузера в той же сессии. Когда подключение готово, выберите «Продолжить с инструментами браузера», и Claude возобновит задачу в вашем браузере. Вы можете выйти из настройки, выбрав «Продолжить без инструментов браузера», и завершить её позже с помощью `/chrome`.89* **Install extension**: открывает страницу установки расширения в браузере и запускает пошаговую настройку. Claude Code ожидает завершения установки, подключает расширение и включает инструменты браузера в той же сессии. Когда подключение готово, выберите «Continue with browser tools», и Claude продолжит задачу в вашем браузере. Вы можете выйти из настройки, выбрав «Continue without browser tools», и завершить её позже с помощью `/chrome`.

90* **Не сейчас**: продолжает задачу без инструментов браузера. Claude Code может спросить снова в одной из следующих сессий.90* **Not now**: продолжает задачу без инструментов браузера. Claude Code может спросить снова в одной из следующих сессий.

91* **Больше не спрашивать**: отключает запрос в будущих сессиях. Вы по-прежнему можете настроить интеграцию в любое время с помощью `/chrome`.91* **Don't ask again**: отключает запрос в будущих сессиях. Вы по-прежнему можете настроить интеграцию в любое время с помощью `/chrome`.

92 92 

93Две управляемые политики MCP отключают этот запрос:93Две управляемые политики MCP отключают этот запрос:

94 94 


97 97 

98### Включение Chrome по умолчанию98### Включение Chrome по умолчанию

99 99 

100Чтобы подключать Chrome без передачи `--chrome` каждый раз, выполните `/chrome` в сессии CLI и выберите **Включено по умолчанию**. В [расширении VS Code](https://code.claude.com/docs/ru/vs-code.md#automate-browser-tasks-with-chrome) введите `/chrome` в поле промпта и включите переключатель **Включено по умолчанию**. Оба используют одну и ту же настройку, поэтому её включение в любом из этих мест включает её и для CLI, и для VS Code.100Чтобы подключать Chrome, не передавая `--chrome` каждый раз, выполните `/chrome` в сессии CLI и выберите пункт включения по умолчанию. В [расширении VS Code](https://code.claude.com/docs/ru/vs-code.md#automate-browser-tasks-with-chrome) введите `/chrome` в поле промпта и включите переключатель включения по умолчанию. Они используют одну общую настройку, поэтому её включение в любом из мест включает её как для CLI, так и для VS Code.

101 101 

102Если настройка включена и используется Claude Code v2.1.287 или новее, каждая сессия VS Code подключается к вашему браузеру при запуске, поэтому Claude может использовать его ещё до того, как вы введёте `@browser`. В более ранних версиях или при выключенной настройке сессия VS Code подключается, когда вы вводите `@browser`.102Если настройка включена и используется Claude Code версии 2.1.287 или новее, каждая сессия VS Code подключается к вашему браузеру при запуске, поэтому Claude может использовать его ещё до того, как вы введёте `@browser`. В более ранних версиях или при отключённой настройке сессия VS Code подключается, когда вы вводите `@browser`.

103 103 

104Claude Code запускается нормально, когда Chrome не запущен.104Claude Code запускается в обычном режиме, если Chrome не запущен.

105 105 

106> [!NOTE]106> [!NOTE]

107>107>

108> Включение Chrome по умолчанию увеличивает использование контекста, поскольку инструменты браузера и инструкции к ним всегда загружены. Если вы заметили увеличение потребления контекста, отключите эту настройку и подключайтесь только при необходимости: с помощью `--chrome` в CLI или введя [`@browser`](https://code.claude.com/docs/ru/vs-code#automate-browser-tasks-with-chrome) в поле промпта VS Code.108> Включение Chrome по умолчанию увеличивает использование контекста, поскольку инструменты браузера и инструкции к ним загружаются всегда. Если вы заметили возросшее потребление контекста, отключите настройку и подключайтесь только при необходимости — с помощью `--chrome` в CLI или введя [`@browser`](https://code.claude.com/docs/ru/vs-code#automate-browser-tasks-with-chrome) в поле промпта VS Code.

109 109 

110### Управление разрешениями сайта110### Управление разрешениями для сайтов

111 111 

112Разрешения на уровне сайта наследуются из расширения Chrome. Управляйте разрешениями в настройках расширения Chrome, чтобы контролировать, какие сайты Claude может просматривать, нажимать и вводить текст. В [авторежиме](https://code.claude.com/docs/ru/permission-modes.md#eliminate-prompts-with-auto-mode), когда классификатор авторежима сам одобряет вызов браузера к сайту, расширение пропускает собственную проверку для этого сайта при данном вызове, если только ваши правила разрешений не запрещают какой-либо сайт для Claude in Chrome.112Разрешения на уровне сайтов наследуются от расширения Chrome. Управляйте разрешениями в настройках расширения Chrome, чтобы контролировать, на каких сайтах Claude может просматривать страницы, нажимать и вводить текст. В [авторежиме](https://code.claude.com/docs/ru/permission-modes.md#eliminate-prompts-with-auto-mode), когда классификатор авторежима сам одобряет обращение браузера к сайту, расширение пропускает собственную проверку для этого сайта при данном обращении, если только ваши правила разрешений не запрещают Claude in Chrome доступ к какому-либо сайту.

113 113 

114### Запросы разрешений в сессиях VS Code114### Запросы разрешений в сессиях VS Code

115 115 

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

117 117 

118В сессии, которая подключилась к вашему браузеру при запуске, потому что включена настройка [Включено по умолчанию](#enable-chrome-by-default), Claude Code спрашивает вас перед действиями в браузере на сайте, который вы не разрешили, в режимах разрешений Manual, Edit automatically, Auto и Bypass permissions. В режимах Auto и Bypass permissions это действует, пока вы не введёте `@browser` в этой сессии.118В сессии, которая подключилась к вашему браузеру при запуске, потому что включена [настройка включения по умолчанию](#enable-chrome-by-default), Claude Code запрашивает подтверждение перед действиями в браузере на сайте, который вы не разрешили, в режимах Manual, Edit automatically, Auto и Bypass permissions. В режимах Auto и Bypass permissions это действует, пока вы не введёте `@browser` в этой сессии.

119 119 

120### Инструменты браузера в режиме планирования120### Инструменты браузера в режиме планирования

121 121 

122В [режиме планирования](https://code.claude.com/docs/ru/permission-modes.md#analyze-before-you-edit-with-plan-mode) запрос разрешения появляется перед тем, как Claude записывает GIF, открывает новую вкладку или запускает ярлык. Если в интерактивной сессии CLI [доступен режим обхода разрешений](https://code.claude.com/docs/ru/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) и [получение feature-флагов](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching) отключено, эти вызовы выполняются без запроса.122В [режиме планирования](https://code.claude.com/docs/ru/permission-modes.md#analyze-before-you-edit-with-plan-mode) запрос разрешения появляется перед тем, как Claude записывает GIF, открывает новую вкладку или выполняет ярлык. В интерактивной сессии CLI, если [режим bypass permissions доступен](https://code.claude.com/docs/ru/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) и [получение feature-флагов](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching) отключено, эти вызовы выполняются без запроса.

123 123 

124Вызов `tabs_context_mcp` также запрашивает разрешение, когда он устанавливает `createIfEmpty`, как и вызов `browser_batch`, включающий любое из этих действий.124Вызов `tabs_context_mcp` также требует подтверждения, если он задаёт `createIfEmpty`, как и вызов `browser_batch`, включающий любое из этих действий.

125 125 

126## Примеры рабочих процессов126## Примеры рабочих процессов

127 127 

Details

446 446 

447Следующие настройки от родителя проходят фильтр даже при всех пяти установленных блокировках:447Следующие настройки от родителя проходят фильтр даже при всех пяти установленных блокировках:

448 448 

449* **`forceLoginOrgUUID`**: Claude Code учитывает значение от родителя, если административный источник с наивысшим приоритетом не задаёт UUID организации. Вход в шлюз этот ключ не проверяет. UUID организации в административном источнике с наивысшим приоритетом блокирует значение родителя, и именно его применяет Claude Code.449* **`forceLoginOrgUUID`**: Claude Code учитывает значение от родителя, если применяемые им управляемые настройки не задают UUID организации. Вход в шлюз этот ключ не проверяет. UUID организации в управляемых настройках, которые применяет Claude Code, блокирует значение родителя, и именно его применяет Claude Code. Если ваш парк машин закрепляет организацию Anthropic, см. раздел [Какой управляемый источник предоставляет ключи входа](https://code.claude.com/docs/ru/managed-settings.md#which-managed-source-supplies-login-keys), чтобы узнать, где задавать `forceLoginOrgUUID`.

450* **`allowedMcpServers`**: Claude Code учитывает список разрешённых от родителя, если не действует ни один административный список. `allowManagedMcpServersOnly` его не блокирует, потому что блокировка применяет в качестве управляемого значения тот список, который выигрывает, включая список от родителя, если ни один административный источник не предоставляет список. Список в административном источнике с наивысшим приоритетом блокирует список родителя, и именно его применяет Claude Code, поэтому задайте `allowedMcpServers` там, рядом с блокировкой. До v2.1.223 значение любого из этих ключей в любом административном источнике блокировало значение родителя.450* **`allowedMcpServers`**: Claude Code учитывает список разрешённых от родителя, если не действует ни один административный список. `allowManagedMcpServersOnly` его не блокирует, потому что блокировка применяет в качестве управляемого значения тот список, который выигрывает, включая список от родителя, если ни один административный источник не предоставляет список. Список в административном источнике с наивысшим приоритетом блокирует список родителя, и именно его применяет Claude Code, поэтому задайте `allowedMcpServers` там, рядом с блокировкой. До v2.1.223 значение любого из этих ключей в любом административном источнике блокировало значение родителя.

451* **`availableModels`**: Claude Code учитывает список моделей от родителя, если выигравший управляемый источник его не задаёт. Если ваш парк машин ограничивает модели, задайте `availableModels` в выигравшем источнике.451* **`availableModels`**: Claude Code учитывает список моделей от родителя, если выигравший управляемый источник его не задаёт. Если ваш парк машин ограничивает модели, задайте `availableModels` в выигравшем источнике.

452* **`allowedProviders`**: Claude Code учитывает список разрешённых API-провайдеров от родителя, если выигравший управляемый источник его не задаёт. Если ваш парк машин ограничивает, какими API-провайдерами могут пользоваться разработчики, задайте `allowedProviders` в выигравшем источнике. Требуется Claude Code v2.1.285 или новее.452* **`allowedProviders`**: Claude Code учитывает список разрешённых API-провайдеров от родителя, если выигравший управляемый источник его не задаёт. Если ваш парк машин ограничивает, какими API-провайдерами могут пользоваться разработчики, задайте `allowedProviders` в выигравшем источнике. Требуется Claude Code v2.1.285 или новее.


454* **`blockedMarketplaces`**: список запрещённых маркетплейсов от родителя проходит фильтр и добавляется к любому списку запрещённых, заданному управляемым источником, поскольку список запрещённых может только усиливать ограничения. Требуется Claude Code v2.1.282 или новее.454* **`blockedMarketplaces`**: список запрещённых маркетплейсов от родителя проходит фильтр и добавляется к любому списку запрещённых, заданному управляемым источником, поскольку список запрещённых может только усиливать ограничения. Требуется Claude Code v2.1.282 или новее.

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

456 456 

457При настройке по умолчанию «побеждает первый» значение администратора блокирует значение родителя, только если находится в источнике администратора с наивысшим приоритетом, за исключением `allowedMcpServers`, пока включена [блокировка MCP-серверов](#lock-behavior-across-sources). При явном включении объединения `managedSourcesBehavior` раздел [как Claude Code объединяет управляемые источники](https://code.claude.com/docs/ru/managed-settings.md#how-claude-code-combines-managed-sources) описывает, значение какого источника применяется вместо этого.457Если вы задаёте `managedSourcesBehavior` равным `"merge"`, проверьте, [значение какого источника применяется для каждого вида ключей](https://code.claude.com/docs/ru/managed-settings.md#compose-every-managed-source).

458 458 

459#### Как действуют ключи хуков и скиллов в родительских настройках459#### Как действуют ключи хуков и скиллов в родительских настройках

460 460 

Details

421 421 

422```yaml theme={null}422```yaml theme={null}

423models:423models:

424 - id: claude-opus-restricted # пользовательский id, а не встроенное имя модели424 - id: restricted-claude-opus-4-8 # пользовательский id, а не встроенное имя модели

425 upstream_model:425 upstream_model:

426 bedrock-isolated: us.anthropic.claude-opus-4-8 # единственный upstream, который её обслуживает426 bedrock-isolated: us.anthropic.claude-opus-4-8 # единственный upstream, который её обслуживает

427```427```


631 631 

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

633 633 

634Для upstream Anthropic API время ожидания недоступного upstream ограничивает [`timeouts.upstream_ttfb_ms`](#http-tuning). Эта настройка не действует для других поставщиков: для них шлюз ждёт начала ответа upstream до одного часа.634Шлюз ждёт начала ответа в течение следующего времени:

635 

636* **Upstream `provider: anthropic`**: [`timeouts.upstream_ttfb_ms`](#http-tuning), по умолчанию 120 секунд

637* **Другие поставщики**: до одного часа. Чтобы сократить это ожидание для потоковых запросов, задайте `timeouts.upstream_ttfb_ms` на шлюзе v2.1.295 или новее. Непотоковые запросы к модели в любом случае ждут до одного часа

635 638 

636`404` означает недоступность модели в конкретном upstream, поэтому upstream, в котором модель не включена, не блокирует следующий upstream, который её обслуживает. Upstream, который не может разрешить запрошенную модель, пропускается без сетевого обращения.639`404` означает недоступность модели в конкретном upstream, поэтому upstream, в котором модель не включена, не блокирует следующий upstream, который её обслуживает. Upstream, который не может разрешить запрошенную модель, пропускается без сетевого обращения.

637 640 


875 policies:878 policies:

876 - match: { groups: [restricted-projects] }879 - match: { groups: [restricted-projects] }

877 cli:880 cli:

878 availableModels: [claude-opus-restricted]881 availableModels: [restricted-claude-opus-4-8]

879 enforceAvailableModels: true882 enforceAvailableModels: true

880 model: claude-opus-restricted883 model: restricted-claude-opus-4-8

884 env:

885 ANTHROPIC_DEFAULT_OPUS_MODEL: restricted-claude-opus-4-8 # opus and Default resolve to the ID too

881```886```

882 887 

883#### Значения matcher, которые останавливают шлюз при запуске888#### Значения matcher, которые останавливают шлюз при запуске


1012 1017 

1013#### Контекстное окно в сессиях терминала1018#### Контекстное окно в сессиях терминала

1014 1019 

1015Сессии терминала, выполненные со входом через `/login`, используют контекстное окно 1M для Opus 4.7 и новее, Sonnet 5 и новее, а также моделей Fable. ID модели не требует суффикса `[1m]`, и сессии сжимаются примерно на 967K токенов. До Claude Code v2.1.287 на машине разработчика Claude Code считал, что у моделей Opus и Fable окно 200K, если ID модели не заканчивался на `[1m]`.1020Сессии терминала, выполненные со входом через `/login`, используют контекстное окно 1M для Opus 4.7 и новее, Sonnet 5 и новее, а также моделей Fable. ID модели не требует суффикса `[1m]`, и сессии сжимаются при достижении примерно 967K токенов. До Claude Code v2.1.287 на машине разработчика Claude Code считал, что у моделей Opus и Fable окно 200K, если ID модели не заканчивался на `[1m]`.

1016 1021 

1017Чтобы сессии терминала вместо этого сжимались на границе 200K, задайте [окно автосжатия](https://code.claude.com/docs/ru/model-config.md#set-the-auto-compact-window) в `env` политики:1022Чтобы сессии терминала вместо этого сжимались на границе 200K, задайте [окно автосжатия](https://code.claude.com/docs/ru/model-config.md#set-the-auto-compact-window) в `env` политики:

1018 1023 


1148 1153 

1149`blockReadsOutsideWorkingDirectories`, `disableBypassPermissionsMode`, `configRecheckIntervalMinutes` и `sshClientPath` требуют Claude Code v2.1.281 или новее на сервере шлюза. То же относится к значению `required` для `microsoftAuthBroker` и полю `continuousAccessEvaluation` записи `managedMcpServers` для Microsoft 365. Выпуски Claude Desktop, вышедшие до появления значения `required`, читают его как `disabled`, поэтому задавайте `required` только после того, как Claude Desktop у каждого участника будет его поддерживать. В [справочнике управляемой конфигурации](https://claude.com/docs/third-party/claude-desktop/configuration) Claude Desktop указан выпуск, который первым читает каждый ключ.1154`blockReadsOutsideWorkingDirectories`, `disableBypassPermissionsMode`, `configRecheckIntervalMinutes` и `sshClientPath` требуют Claude Code v2.1.281 или новее на сервере шлюза. То же относится к значению `required` для `microsoftAuthBroker` и полю `continuousAccessEvaluation` записи `managedMcpServers` для Microsoft 365. Выпуски Claude Desktop, вышедшие до появления значения `required`, читают его как `disabled`, поэтому задавайте `required` только после того, как Claude Desktop у каждого участника будет его поддерживать. В [справочнике управляемой конфигурации](https://claude.com/docs/third-party/claude-desktop/configuration) Claude Desktop указан выпуск, который первым читает каждый ключ.

1150 1155 

1156> [!NOTE]

1157>

1158> [`sshTransport`](https://claude.com/docs/third-party/claude-desktop/configuration#sshtransport) требует Claude Code v2.1.293 или новее на сервере шлюза.

1159 

1151Если вы задаёте `orgPluginSettings` в блоке `desktop` политики, шлюз отдаёт его в форме массива, которую читает Claude Desktop 1.15200.0 и новее. Более старые десктопы игнорируют массив и не применяют никакой политики инструментов плагинов, поэтому обновите участников до 1.15200.0 или новее, прежде чем на это полагаться.1160Если вы задаёте `orgPluginSettings` в блоке `desktop` политики, шлюз отдаёт его в форме массива, которую читает Claude Desktop 1.15200.0 и новее. Более старые десктопы игнорируют массив и не применяют никакой политики инструментов плагинов, поэтому обновите участников до 1.15200.0 или новее, прежде чем на это полагаться.

1152 1161 

1153##### Как ролевая политика наследует базовый блок `desktop`1162##### Как ролевая политика наследует базовый блок `desktop`


1366Claude Code проверяет эндпоинт перед тем, как экспортировать сигнал напрямую, и оставляет этот сигнал на ретрансляторе, если проверка не пройдена. Проверки включают:1375Claude Code проверяет эндпоинт перед тем, как экспортировать сигнал напрямую, и оставляет этот сигнал на ретрансляторе, если проверка не пройдена. Проверки включают:

1367 1376 

1368* Эндпоинт поступает от самого шлюза. Если вы задаёте ту же переменную в профиле MDM или в локальном `managed-settings.json`, экспорт остаётся на ретрансляторе.1377* Эндпоинт поступает от самого шлюза. Если вы задаёте ту же переменную в профиле MDM или в локальном `managed-settings.json`, экспорт остаётся на ретрансляторе.

1369* URL использует `https://` или `http://` к loopback-адресу1378* URL использует `https://` либо, для loopback-адреса, `http://`

1370* URL разрешается в путь, заканчивающийся на `/v1/<signal>`, без строки запроса и фрагмента. Claude Code сам строит этот путь из общей переменной. Переменную для отдельного сигнала, такую как `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`, он использует как есть, поэтому указывайте в ней полный путь.1379* URL разрешается в путь, заканчивающийся на `/v1/<signal>`, без строки запроса и фрагмента. Claude Code сам строит этот путь из общей переменной. Переменную для отдельного сигнала, такую как `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`, он использует как есть, поэтому указывайте в ней полный путь.

1371* URL не является собственным хостом шлюза. Эндпоинт, адресованный шлюзу, сохраняет путь через ретранслятор и его токен сессии.1380* URL не является собственным хостом шлюза. Эндпоинт, адресованный шлюзу, сохраняет путь через ретранслятор и его токен сессии.

1372* Ни вы, ни разработчик не настроили [`otelHeadersHelper`](https://code.claude.com/docs/ru/settings-reference#otelheadershelper) ни в одном источнике настроек. Если helper настроен, все сигналы остаются на ретрансляторе.1381* Ни вы, ни разработчик не настроили [`otelHeadersHelper`](https://code.claude.com/docs/ru/settings-reference#otelheadershelper) ни в одном источнике настроек. Если helper настроен, все сигналы остаются на ретрансляторе.


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

1399| `limits` | `max_request_header_bytes` | не задано | Снижает установленный в шлюзе лимит 256 KiB на общий размер заголовков запроса. Запрос сверх лимита возвращает `431`, а значение выше 256 KiB не действует. Если разработчики получают `431` после входа, см. [Слишком большие заголовки запроса после входа](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#request-headers-too-large-after-sign-in). |1408| `limits` | `max_request_header_bytes` | не задано | Снижает установленный в шлюзе лимит 256 KiB на общий размер заголовков запроса. Запрос сверх лимита возвращает `431`, а значение выше 256 KiB не действует. Если разработчики получают `431` после входа, см. [Слишком большие заголовки запроса после входа](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#request-headers-too-large-after-sign-in). |

1400| `limits` | `max_url_length` | не задано | Если задано, слишком длинный URL возвращает `414` |1409| `limits` | `max_url_length` | не задано | Если задано, слишком длинный URL возвращает `414` |

1401| `timeouts` | `upstream_ttfb_ms` | 120000 | Максимальное время ожидания заголовков ответа вышестоящего сервера (время до первого байта). Затем тело ответа передаётся потоком без ограничения по общему времени. Применяется к прямому пути к вышестоящему серверу Anthropic; для всех остальных провайдеров шлюз ждёт начала ответа до одного часа. |1410| `timeouts` | `upstream_ttfb_ms` | 120000 | Максимальное время ожидания заголовков ответа вышестоящего сервера (время до первого байта). Затем тело ответа передаётся потоком без ограничения по реальному времени. Если ключ не задан, значение по умолчанию применяется к вышестоящим серверам `provider: anthropic`, а для всех остальных провайдеров шлюз ждёт начала ответа до одного часа. Чтобы сократить это ожидание, см. [Несколько вышестоящих серверов](#multiple-upstreams). |

1402| `rate_limits` | `device_authorization.max` / `.window_seconds` | 30 / 600 | Ограничение частоты запросов по IP для неаутентифицированного эндпоинта авторизации устройства. Увеличьте для крупной организации за общим исходящим IP или NAT. В разделе [Крупные развёртывания](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#large-rollouts) показано, как подобрать значение. Эти лимиты применяются только к процессу входа с device grant, а не к инференсу `/v1/messages`. См. [Устойчивость пользовательского кода к перебору](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#user-code-brute-force-resistance). |1411| `rate_limits` | `device_authorization.max` / `.window_seconds` | 30 / 600 | Ограничение частоты запросов по IP для неаутентифицированного эндпоинта авторизации устройства. Увеличьте для крупной организации за общим исходящим IP или NAT. В разделе [Крупные развёртывания](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#large-rollouts) показано, как подобрать значение. Эти лимиты применяются только к процессу входа с device grant, а не к инференсу `/v1/messages`. См. [Устойчивость пользовательского кода к перебору](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#user-code-brute-force-resistance). |

1403| `rate_limits` | `device_verify.max` / `.window_seconds` | 10 / 600 | Ограничение частоты запросов по IP для отправки `user_code` на `/device`. Именно оно не даёт кому-либо подобрать код другого разработчика. В разделе [Крупные развёртывания](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#large-rollouts) показано, насколько его увеличить. |1412| `rate_limits` | `device_verify.max` / `.window_seconds` | 10 / 600 | Ограничение частоты запросов по IP для отправки `user_code` на `/device`. Именно оно не даёт кому-либо подобрать код другого разработчика. В разделе [Крупные развёртывания](https://code.claude.com/docs/ru/claude-apps-gateway-deploy.md#large-rollouts) показано, насколько его увеличить. |

1404 1413 

Details

228 228 

229Телепортирование требует аутентификации подписки claude.ai. Найдите случай, соответствующий вашему:229Телепортирование требует аутентификации подписки claude.ai. Найдите случай, соответствующий вашему:

230 230 

231* **Вы аутентифицированы через API-ключ**: запустите `/login` для входа с вашим аккаунтом claude.ai вместо этого231* **Вы вошли с помощью API-ключа или аккаунта Console**: запустите `claude auth login` в вашей оболочке, затем войдите через claude.ai

232* **Ошибка называет вашего поставщика**: облачные сессии недоступны через поставщиков третьей стороны. См. [таблицу ошибок](#errors-when-sending-to-a-cloud-session)232* **Ошибка называет вашего поставщика**: облачные сессии недоступны через поставщиков третьей стороны. См. [таблицу ошибок](#errors-when-sending-to-a-cloud-session)

233* **Вы уже вошли через claude.ai**: ваша организация может отключить облачные сессии233* **Вы уже вошли через claude.ai**: ваша организация может отключить облачные сессии

234 234 


437 437 

438### Unable to get organization UUID438### Unable to get organization UUID

439 439 

440`claude --cloud` и `claude --teleport` требуют входа с аккаунтом claude.ai. Если вы аутентифицируетесь с помощью API-ключа или ваши сохранённые данные аккаунта устарели, вы увидите одно из следующего:440`claude --cloud` и `claude --teleport` требуют входа с аккаунтом claude.ai. Если вместо этого вы аутентифицируетесь с помощью API-ключа или входа через Console либо ваши сохранённые данные аккаунта устарели, вы увидите сообщение, например:

441 441 

442* `Unable to get organization UUID`442* `Unable to get organization UUID`

443* ``Cloud sessions need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.``443* ``Cloud sessions need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.``

444* ``Cloud sessions aren't available with this Console sign-in. They need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.``

444* `Error loading Claude Code sessions` в окне выбора сессии, если вы запускаете `claude --teleport` без ID сессии445* `Error loading Claude Code sessions` в окне выбора сессии, если вы запускаете `claude --teleport` без ID сессии

445 446 

446Запустите [`claude auth login`](https://code.claude.com/docs/ru/cli-reference#cli-commands) в оболочке, чтобы войти с вашим аккаунтом claude.ai, затем повторите команду. Внутри запущенной сессии то же самое делает `/login`. Если вместо этого в ошибке указан ваш поставщик, см. [таблицу ошибок](#errors-when-sending-to-a-cloud-session): облачные сессии недоступны через сторонних поставщиков.447Запустите [`claude auth login`](https://code.claude.com/docs/ru/cli-reference#cli-commands) в оболочке, чтобы войти с вашим аккаунтом claude.ai, затем повторите команду. Внутри запущенной сессии то же самое делает `/login`. Если вместо этого в ошибке указан ваш поставщик, см. [таблицу ошибок](#errors-when-sending-to-a-cloud-session): облачные сессии недоступны через сторонних поставщиков.

Details

99 99 

100Эти требования определяют, можете ли вы добавить секрет и может ли прокси агента использовать его после добавления:100Эти требования определяют, можете ли вы добавить секрет и может ли прокси агента использовать его после добавления:

101 101 

102* **Роль**: на планах Pro, Max и Team вы можете добавлять и удалять секреты в своих собственных средах независимо от вашей роли. На Team и Enterprise пользователи с ролью Owner имеют роль администратора организации в вашей организации claude.ai, а пользователи с ролью Admin — нет, что меняет то, что вы видите в следующих случаях:102* **Роль**: на любом плане вы можете добавлять и удалять секреты в своих собственных средах независимо от вашей роли. На Team и Enterprise пользователи с ролью Owner имеют роль администратора организации в вашей организации claude.ai, а пользователи с ролью Admin — нет, что меняет то, что вы видите в следующих случаях:

103 * **Ваша собственная среда на Enterprise**: с ролью администратора организации вы добавляете и удаляете секреты. Без неё строка **Network secrets** открывает список секретов с примечанием «Only an organization admin can add or delete network secrets», без кнопки **Add secret** и кнопки удаления. Попросите пользователя с ролью Owner добавить секрет в [общую среду](#organization-shared-environments), а затем запускайте свои сессии там103 * **Ваша собственная среда**: без роли администратора организации кнопка **Add secret** открывает [сокращённую форму](#add-a-secret-without-the-role)

104 * **Общая среда**: пользователи с ролью Owner [добавляют и удаляют её секреты](#add-a-credential) в настройках администратора. Без роли администратора организации попросите пользователя с ролью Owner добавить секрет, потому что в диалоге среды нет раздела **Network secrets**104 * **Общая среда**: пользователи с ролью Owner [добавляют и удаляют её секреты](#add-a-credential) в настройках администратора. Без роли администратора организации попросите пользователя с ролью Owner добавить секрет, потому что в диалоге среды нет раздела **Network secrets**

105 * **Ваша собственная среда на Team**: без роли администратора организации кнопка **Add secret** открывает [сокращённую форму](#add-a-secret-without-the-role), которая принимает один хост

106* **Тип среды**: облачная среда, размещённая Anthropic, которая уже существует. У [самостоятельно размещённой среды](https://code.claude.com/docs/ru/self-hosted-environments) нет сетевых секретов105* **Тип среды**: облачная среда, размещённая Anthropic, которая уже существует. У [самостоятельно размещённой среды](https://code.claude.com/docs/ru/self-hosted-environments) нет сетевых секретов

107* **Доступность API**: API принимает соединения из интернета, потому что запросы выходят из сети Anthropic106* **Доступность API**: API принимает соединения из интернета, потому что запросы выходят из сети Anthropic

108* **Ключи шифрования**: если ваша организация использует управляемые клиентом ключи шифрования, вы не можете сохранять сетевые секреты107* **Ключи шифрования**: если ваша организация использует управляемые клиентом ключи шифрования, вы не можете сохранять сетевые секреты


111 110 

112Вы добавляете секреты по одному. Чтобы изменить хосты или значение секрета, удалите его и добавьте снова.111Вы добавляете секреты по одному. Чтобы изменить хосты или значение секрета, удалите его и добавьте снова.

113 112 

114Чтобы добавить секрет в [общую среду](#organization-shared-environments), откройте её для редактирования на странице **Cloud environments** в [настройках администратора](https://claude.ai/admin-settings), затем продолжите с шага 2 в её разделе **Network secrets**. Если вы используете план Team и не имеете [роли администратора организации](#requirements), выполните шаг 1 в своей собственной среде, затем [заполните сокращённую форму](#add-a-secret-without-the-role).113Чтобы добавить секрет в [общую среду](#organization-shared-environments), откройте её для редактирования на странице **Cloud environments** в [настройках администратора](https://claude.ai/admin-settings), затем продолжите с шага 2 в её разделе **Network secrets**. Если вы используете план Team или Enterprise и не имеете [роли администратора организации](#requirements), выполните шаг 1 в своей собственной среде, затем [заполните сокращённую форму](#add-a-secret-without-the-role).

115 114 

116**1. Откройте сетевые секреты среды**115**1. Откройте сетевые секреты среды**

117 116 


133 132 

134Чтобы убедиться, что секрет работает, запустите сессию в среде и попросите Claude вызвать API, например с помощью `curl`. API отвечает так, как если бы ключ был в запросе, а ключ не появляется ни в переменных окружения сессии, ни в каком-либо файле. Если вместо этого список помечает секрет как **Not sent**, примечание под ним объясняет причину и что делать. Два секрета, хосты которых пересекаются без точного совпадения, не получают отметки, и прокси агента отправляет только один из них.133Чтобы убедиться, что секрет работает, запустите сессию в среде и попросите Claude вызвать API, например с помощью `curl`. API отвечает так, как если бы ключ был в запросе, а ключ не появляется ни в переменных окружения сессии, ни в каком-либо файле. Если вместо этого список помечает секрет как **Not sent**, примечание под ним объясняет причину и что делать. Два секрета, хосты которых пересекаются без точного совпадения, не получают отметки, и прокси агента отправляет только один из них.

135 134 

136#### Добавление секрета на плане Team без роли администратора организации135#### Добавление секрета без роли администратора организации

137 136 

138Если вы используете план Team и не имеете [роли администратора организации](#requirements), форма **Add secret** принимает один секрет для одного хоста. Выберите [строку **Network secrets**](#add-a-credential) вашей среды, а затем **Add secret**. Заполните эти поля и нажмите кнопку **Add secret** в форме:137Если вы используете план Team или Enterprise и не имеете [роли администратора организации](#requirements), форма **Add secret** принимает один секрет для одного хоста. Выберите [строку **Network secrets**](#add-a-credential) вашей среды, а затем **Add secret**. Заполните эти поля и нажмите кнопку **Add secret** в форме:

139 138 

140* **Host**: единственный хост, который получает секрет, например `api.example.com`. Форма не принимает подстановочный знак `*.`139* **Host**: единственный хост, который получает секрет, например `api.example.com`. Форма не принимает подстановочный знак `*.`

141* **Name**: необязательная метка для секрета140* **Name**: необязательная метка для секрета

Details

36Следующие процессы не запускаются через launcher:36Следующие процессы не запускаются через launcher:

37 37 

38* Сеанс, который вы запускаете сами в терминале, который работает так, как вы его вызвали. Чтобы охватить эти сеансы, поместите скрипт с именем `claude` в каталог, который находится раньше в `PATH`, который запускает ваш launcher с реальным бинарным файлом; не заменяйте управляемый symlink. Фоновые процессы не консультируют `PATH`, поэтому два launcher никогда не складываются там.38* Сеанс, который вы запускаете сами в терминале, который работает так, как вы его вызвали. Чтобы охватить эти сеансы, поместите скрипт с именем `claude` в каталог, который находится раньше в `PATH`, который запускает ваш launcher с реальным бинарным файлом; не заменяйте управляемый symlink. Фоновые процессы не консультируют `PATH`, поэтому два launcher никогда не складываются там.

39* Первый процесс `claude-cli://` deep link, который обработчик протокола операционной системы запускает напрямую. Все, что этот сеанс запускает в фоне после этого, работает через launcher. Чтобы полностью закрыть этот путь, [предотвратите регистрацию обработчика](https://code.claude.com/docs/ru/deep-links.md#registration-and-supported-platforms) с помощью параметра `disableDeepLinkRegistration`.39* Сессия, открытая из deep link `claude-cli://`, которая запускается в новом терминале без вашего launcher. Чтобы deep links не открывали сессии для нового пользователя, установите [`disableDeepLinkRegistration`](https://code.claude.com/docs/ru/settings-reference#disabledeeplinkregistration) в значение `"disable"` до того, как этот пользователь впервые запустит Claude Code. Для пользователя, у которого уже есть [зарегистрированный обработчик](https://code.claude.com/docs/ru/deep-links.md#registration-and-supported-platforms), deep links продолжают открывать сессии, потому что настройка не удаляет обработчик.

40* Перезапуск, который выполняет `--worktree` в сочетании с `--tmux`: терминальный мультиплексер запускает эту панель, а не бинарный файл Claude Code.40* Перезапуск, который выполняет `--worktree` в сочетании с `--tmux`: терминальный мультиплексер запускает эту панель, а не бинарный файл Claude Code.

41* Хост native-messaging, который регистрирует [Claude in Chrome](https://code.claude.com/docs/ru/chrome.md): браузер запускает его, а не бинарный файл Claude Code.41* Хост native-messaging, который регистрирует [Claude in Chrome](https://code.claude.com/docs/ru/chrome.md): браузер запускает его, а не бинарный файл Claude Code.

42 42 

desktop.md +6 −6

Details

43Перед отправкой первого сообщения выберите окружение, папку проекта, режим разрешений и модель в строке под полем промпта:43Перед отправкой первого сообщения выберите окружение, папку проекта, режим разрешений и модель в строке под полем промпта:

44 44 

45* **Environment**: с помощью селектора окружения, первого элемента управления в строке, выберите, где запускается Claude. См. [конфигурация окружения](#environment-configuration).45* **Environment**: с помощью селектора окружения, первого элемента управления в строке, выберите, где запускается Claude. См. [конфигурация окружения](#environment-configuration).

46 * Если в новой сессии под полем промпта нет селектора окружения, следуйте [шагам для прежнего макета](#check-which-layout-you-have).46 * Если в новой сессии под полем промпта не отображается окружение, следуйте [шагам для прежнего макета](#check-which-layout-you-have).

47* **Project folder**: нажмите элемент управления папкой проекта рядом с селектором окружения, чтобы выбрать папку, в которой работает Claude.47* **Project folder**: нажмите элемент управления папкой проекта рядом с селектором окружения, чтобы выбрать папку, в которой работает Claude.

48 * **Облачная сессия**: выберите [репозитории](#run-long-running-tasks-in-the-cloud) вместо папки48 * **Облачная сессия**: выберите [репозитории](#run-long-running-tasks-in-the-cloud) вместо папки

49 * **[Сохранённое локальное или SSH-окружение](#create-a-saved-environment)**: окружение уже содержит свои папки, поэтому в строке нет элемента управления папкой проекта. Чтобы изменить папки, [отредактируйте окружение](#use-edit-or-remove-a-saved-environment).49 * **[Сохранённое локальное или SSH-окружение](#create-a-saved-environment)**: окружение уже содержит свои папки, поэтому в строке нет элемента управления папкой проекта. Чтобы изменить папки, [отредактируйте окружение](#use-edit-or-remove-a-saved-environment).


861 861 

862> [!NOTE]862> [!NOTE]

863>863>

864> Если ваш селектор окружений находится над полем ввода промпта, у вас [более ранний макет](#check-which-layout-you-have), в котором нет сохранённых локальных окружений. Вместо этого используйте [редактор локального окружения](#use-the-local-environment-editor).864> Если в новой сессии под полем ввода промпта не отображается окружение, у вас [прежний макет](#check-which-layout-you-have), в котором нет сохранённых локальных окружений. Вместо этого используйте [редактор локального окружения](#use-the-local-environment-editor).

865 865 

866**1. Откройте форму локального окружения**866**1. Откройте форму локального окружения**

867 867 


963>963>

964> Если вы используете Desktop со [сторонним провайдером](https://code.claude.com/docs/ru/third-party-integrations.md), SSH-сессии требуют отдельной настройки. См. [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).964> Если вы используете Desktop со [сторонним провайдером](https://code.claude.com/docs/ru/third-party-integrations.md), SSH-сессии требуют отдельной настройки. См. [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).

965 965 

966Добавьте SSH-подключение в [диалоговом окне **New environment**](#create-a-saved-environment), затем запустите сессию на этом подключении. Если у новой сессии нет селектора окружений под полем ввода промпта, у вас более ранний макет. См. [Проверка используемого макета](#check-which-layout-you-have).966Добавьте SSH-подключение в [диалоговом окне **New environment**](#create-a-saved-environment), затем запустите сессию через это подключение. Если в новой сессии под полем ввода промпта не отображается окружение, у вас прежний макет. См. [Проверка текущего макета](#check-which-layout-you-have).

967 967 

968**1. Откройте диалоговое окно New environment**968**1. Откройте диалоговое окно New environment**

969 969 


2122 2122 

2123### Проверка используемого макета2123### Проверка используемого макета

2124 2124 

2125Если в новой сессии под полем ввода промпта нет [селектора окружения](#start-a-session), у вас более ранний макет:2125Если в новой сессии [окружение](#start-a-session) отображается над полем ввода промпта, а не под ним, у вас более ранний макет:

2126 2126 

2127* **[Desktop версии ниже v2.37337.0](#check-your-version)**: обновите приложение, чтобы получить текущий макет. Выберите **Claude > Check for Updates…** на macOS или **Help > Check for Updates…** на Windows.2127* **[Desktop версии ниже v2.37337.0](#check-your-version)**: обновите приложение, чтобы получить текущий макет. Выберите **Claude > Check for Updates…** на macOS или **Help > Check for Updates…** на Windows.

2128* **[Сторонний провайдер](https://code.claude.com/docs/ru/third-party-integrations.md) с сессиями на вашем компьютере**: для текущего макета требуется Claude Desktop v3.1623.0 или новее, поэтому [проверьте вашу версию](#check-your-version). Чтобы обновить приложение, выберите **Claude > Check for Updates…** на macOS или **Help > Check for Updates…** на Windows. Если ваша организация [отключает автообновления](#device-management-policies), пункт **Check for Updates…** скрыт, поэтому запросите у администратора v3.1623.0 или новее.2128* **[Сторонний провайдер](https://code.claude.com/docs/ru/third-party-integrations.md) с сессиями на вашем компьютере**: для текущего макета требуется Claude Desktop v3.1623.0 или новее, поэтому [проверьте вашу версию](#check-your-version). Чтобы обновить приложение, выберите **Claude > Check for Updates…** на macOS или **Help > Check for Updates…** на Windows. Если ваша организация [отключает автообновления](#device-management-policies), пункт **Check for Updates…** скрыт, поэтому запросите у администратора v3.1623.0 или новее.

2129* **Сторонний провайдер с сессиями в инфраструктуре вашей организации**: когда ваша организация запускает сессии в собственной инфраструктуре, а не на вашем компьютере, Desktop сохраняет более ранний макет, и обновление не меняет макет. Если вы не знаете, где выполняются ваши сессии, обратитесь к администратору.2129* **Сторонний провайдер с сессиями в инфраструктуре вашей организации**: для текущего макета требуется Claude Desktop v4.29.0 или новее, поэтому [проверьте вашу версию](#check-your-version). Если у вас более старая версия, запросите у администратора v4.29.0 или новее. Если вы не знаете, где выполняются ваши сессии, обратитесь к администратору.

2130 2130 

2131В более раннем макете окружение и папка проекта выбираются над полем ввода промпта, а режим разрешений и модель — в строке под ним. В более раннем макете нет [панели сведений о сессии](#see-session-details) и [сохранённых локальных и SSH-окружений](#create-a-saved-environment).2131В более раннем макете окружение и папка проекта или репозиторий выбираются над полем ввода промпта, а режим разрешений и модель — в строке под ним. В более раннем макете нет [панели сведений о сессии](#see-session-details) и [сохранённых локальных и SSH-окружений](#create-a-saved-environment).

2132 2132 

2133### Ошибки 403 или аутентификации на вкладке Code2133### Ошибки 403 или аутентификации на вкладке Code

2134 2134 

Details

57 57 

58В [строке под полем ввода промпта](https://code.claude.com/docs/ru/desktop.md#start-a-session) нажмите первый элемент управления — селектор окружения — и выберите верхний пункт в группе **Local**. Затем нажмите элемент управления папкой проекта рядом с селектором окружения, выберите **Open folder…** и укажите директорию вашего проекта.58В [строке под полем ввода промпта](https://code.claude.com/docs/ru/desktop.md#start-a-session) нажмите первый элемент управления — селектор окружения — и выберите верхний пункт в группе **Local**. Затем нажмите элемент управления папкой проекта рядом с селектором окружения, выберите **Open folder…** и укажите директорию вашего проекта.

59 59 

60Если под полем ввода промпта нет селектора окружения, у вас более ранняя версия интерфейса. См. [Проверьте, какая у вас версия интерфейса](https://code.claude.com/docs/ru/desktop.md#check-which-layout-you-have).60Если в новой сессии под полем ввода промпта не отображается окружение, у вас более ранняя версия интерфейса. См. [Проверьте, какая у вас версия интерфейса](https://code.claude.com/docs/ru/desktop.md#check-which-layout-you-have).

61 61 

62> [!TIP]62> [!TIP]

63>63>

devcontainer.md +1 −1

Details

79 79 

80> [!NOTE]80> [!NOTE]

81>81>

82> Если вход через браузер завершен, но обратный вызов никогда не достигает контейнер, скопируйте код, показанный в браузере, и вставьте его в подсказку `Paste code here if prompted` в терминале. Это может произойти, когда переадресация портов редактора не маршрутизирует обратный вызов localhost.82> Для входа через Anthropic: если браузер не открывается или выполняет вход, а затем показывает ошибку подключения к `localhost`, используйте URL для входа, показанный над запросом на вставку кода в терминале. Скопируйте его в браузер, выполните вход там, затем вставьте код, показанный браузером, в этот запрос. Если вставка ничего не делает, см. [OAuth login fails in WSL2, SSH, or containers](https://code.claude.com/docs/ru/troubleshoot-install.md#oauth-login-fails-in-wsl2-ssh-or-containers).

83 83 

84## Сохранение аутентификации и параметров при перестроении84## Сохранение аутентификации и параметров при перестроении

85 85 

env-vars.md +3 −3

Details

233| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Установите `1`, чтобы отключить обработку вложений. Упоминания файлов с синтаксисом `@` отправляются как обычный текст, а не разворачиваются в содержимое файла. Игнорируется в [настройках проекта и локальных настройках](https://code.claude.com/docs/ru/settings-reference.md#variables-claude-code-ignores-in-env) |233| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Установите `1`, чтобы отключить обработку вложений. Упоминания файлов с синтаксисом `@` отправляются как обычный текст, а не разворачиваются в содержимое файла. Игнорируется в [настройках проекта и локальных настройках](https://code.claude.com/docs/ru/settings-reference.md#variables-claude-code-ignores-in-env) |

234| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Установите `1`, чтобы процесс Claude Code сам выполнял свою команду [`gcpAuthRefresh`](https://code.claude.com/docs/ru/settings-reference#gcpauthrefresh) или [`awsAuthRefresh`](https://code.claude.com/docs/ru/settings-reference#awsauthrefresh), а не ждал, пока её выполнит другой процесс. Требуется Claude Code v2.1.286 или новее |234| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Установите `1`, чтобы процесс Claude Code сам выполнял свою команду [`gcpAuthRefresh`](https://code.claude.com/docs/ru/settings-reference#gcpauthrefresh) или [`awsAuthRefresh`](https://code.claude.com/docs/ru/settings-reference#awsauthrefresh), а не ждал, пока её выполнит другой процесс. Требуется Claude Code v2.1.286 или новее |

235| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Установите `1`, чтобы отключить [автоматическую память](https://code.claude.com/docs/ru/memory.md#auto-memory). Установите `0`, чтобы принудительно включить автоматическую память, даже если режим `--bare` или [`autoMemoryEnabled: false`](https://code.claude.com/docs/ru/settings-reference#automemoryenabled) иначе отключили бы её. Когда она отключена, Claude не создаёт и не загружает файлы автоматической памяти |235| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Установите `1`, чтобы отключить [автоматическую память](https://code.claude.com/docs/ru/memory.md#auto-memory). Установите `0`, чтобы принудительно включить автоматическую память, даже если режим `--bare` или [`autoMemoryEnabled: false`](https://code.claude.com/docs/ru/settings-reference#automemoryenabled) иначе отключили бы её. Когда она отключена, Claude не создаёт и не загружает файлы автоматической памяти |

236| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Задайте `1`, чтобы удалить параметр `run_in_background` из инструментов Bash, PowerShell и инструмента субагентов, а также отключить сочетание клавиш Ctrl+B и фоновые запуски [ответвлённых скиллов](https://code.claude.com/docs/ru/skills.md#run-skills-in-a-subagent). Тогда Claude Code также перестаёт автоматически переводить в фоновый режим субагентов, длительные вызовы инструментов MCP и shell-команды, превысившие таймаут. [Задачи MCP](https://code.claude.com/docs/ru/mcp.md#make-claude-wait-for-the-result-of-an-mcp-task) и [инструмент Monitor](https://code.claude.com/docs/ru/tools-reference.md#monitor-tool) по-прежнему выполняются в фоновом режиме |236| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Задайте `1`, чтобы убрать параметр `run_in_background` из инструментов Bash, PowerShell и субагентов, а также отключить сочетание клавиш Ctrl+B и фоновый запуск [ответвлённых скиллов](https://code.claude.com/docs/ru/skills.md#run-skills-in-a-subagent). Тогда Claude Code также перестаёт автоматически переводить в фон субагентов, длительные вызовы инструментов MCP и shell-команды, завершившиеся по таймауту. [Задачи MCP](https://code.claude.com/docs/ru/mcp.md#make-claude-wait-for-the-result-of-an-mcp-task) и [инструмент Monitor](https://code.claude.com/docs/ru/tools-reference.md#monitor-tool) по-прежнему выполняются в фоне. Чтобы отключить также [фоновые сессии](https://code.claude.com/docs/ru/agent-view.md#turn-off-agent-view), задайте `CLAUDE_CODE_DISABLE_AGENT_VIEW` равным `1` |

237| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Установите `1`, чтобы Claude Code не считал потоковый ответ [Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md) с отсутствующим или пустым заголовком `Content-Type` бинарным потоком событий Amazon Bedrock. По умолчанию Claude Code предполагает, что шлюз удалил заголовок из в остальном неизменённого ответа, поэтому декодирует тело, и потоковая передача продолжает работать. Устанавливайте эту переменную только для шлюза, который также переотправляет поток как server-sent events; тогда Claude Code читает тело без заголовка как server-sent events. Требуется Claude Code v2.1.239 или новее |237| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Установите `1`, чтобы Claude Code не считал потоковый ответ [Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md) с отсутствующим или пустым заголовком `Content-Type` бинарным потоком событий Amazon Bedrock. По умолчанию Claude Code предполагает, что шлюз удалил заголовок из в остальном неизменённого ответа, поэтому декодирует тело, и потоковая передача продолжает работать. Устанавливайте эту переменную только для шлюза, который также переотправляет поток как server-sent events; тогда Claude Code читает тело без заголовка как server-sent events. Требуется Claude Code v2.1.239 или новее |

238| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Установите `1`, чтобы пропустить проверку того, что потоковый ответ [Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md) имеет content-type `application/vnd.amazon.eventstream`. Без этой переменной, если ответ имеет другой content-type, Claude Code завершает запрос ошибкой с указанием этого типа, что означает, что [шлюз или прокси преобразует ответ](https://code.claude.com/docs/ru/amazon-bedrock.md#streaming-errors-behind-a-gateway-or-proxy). Вместо установки этой переменной настройте шлюз так, чтобы он пересылал заголовок `Content-Type` и тело без изменений. Требуется Claude Code v2.1.208 или новее |238| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Установите `1`, чтобы пропустить проверку того, что потоковый ответ [Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md) имеет content-type `application/vnd.amazon.eventstream`. Без этой переменной, если ответ имеет другой content-type, Claude Code завершает запрос ошибкой с указанием этого типа, что означает, что [шлюз или прокси преобразует ответ](https://code.claude.com/docs/ru/amazon-bedrock.md#streaming-errors-behind-a-gateway-or-proxy). Вместо установки этой переменной настройте шлюз так, чтобы он пересылал заголовок `Content-Type` и тело без изменений. Требуется Claude Code v2.1.208 или новее |

239| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Задайте `1`, чтобы останавливать выполняющуюся работу [фоновой сессии](https://code.claude.com/docs/ru/agent-view.md), когда [супервизор](https://code.claude.com/docs/ru/agent-view.md#the-supervisor-process) останавливает, перезапускает или обновляет процесс этой сессии, вместо того чтобы передавать её следующему процессу сессии. Эта работа — выполняющиеся фоновые shell-команды сессии, а начиная с v2.1.198 — и фоновые субагенты. Влияет только на эту передачу: перевод сессии в фон с помощью `←` или [`/background`](https://code.claude.com/docs/ru/agent-view#from-inside-a-session) по-прежнему переносит выполняющуюся фоновую работу. Требуется Claude Code v2.1.196 или новее |239| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Задайте `1`, чтобы останавливать выполняющуюся работу [фоновой сессии](https://code.claude.com/docs/ru/agent-view.md), когда [супервизор](https://code.claude.com/docs/ru/agent-view.md#the-supervisor-process) останавливает, перезапускает или обновляет процесс этой сессии, вместо того чтобы передавать её следующему процессу сессии. Эта работа — выполняющиеся фоновые shell-команды сессии, а начиная с v2.1.198 — и фоновые субагенты. Влияет только на эту передачу: перевод сессии в фон с помощью `←` или [`/background`](https://code.claude.com/docs/ru/agent-view#from-inside-a-session) по-прежнему переносит выполняющуюся фоновую работу. Требуется Claude Code v2.1.196 или новее |


276| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Установите `1`, чтобы отключить инструмент [WebFetch](https://code.claude.com/docs/ru/tools-reference.md#webfetch-tool-behavior). Инструмент [WebSearch](https://code.claude.com/docs/ru/tools-reference.md#websearch-tool-behavior) остаётся доступным. Требуется Claude Code v2.1.285 или новее |276| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Установите `1`, чтобы отключить инструмент [WebFetch](https://code.claude.com/docs/ru/tools-reference.md#webfetch-tool-behavior). Инструмент [WebSearch](https://code.claude.com/docs/ru/tools-reference.md#websearch-tool-behavior) остаётся доступным. Требуется Claude Code v2.1.285 или новее |

277| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Установите `1`, чтобы запускать команды [инструмента PowerShell](https://code.claude.com/docs/ru/tools-reference.md#powershell-tool) в Windows напрямую, а не через загрузчик `cmd.exe`. По умолчанию загрузчик позволяет команде PowerShell, [выполняющейся в фоне](https://code.claude.com/docs/ru/tools-reference.md#background-commands), [переходить в следующий процесс сессии](https://code.claude.com/docs/ru/agent-view.md#the-supervisor-process), например когда вы [переводите сессию в фон](https://code.claude.com/docs/ru/agent-view.md#from-inside-a-session). Если задать переменную, фоновая команда PowerShell останавливается при завершении процесса сессии. Команды Bash не затрагиваются. Требуется Claude Code v2.1.269 или новее |277| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Установите `1`, чтобы запускать команды [инструмента PowerShell](https://code.claude.com/docs/ru/tools-reference.md#powershell-tool) в Windows напрямую, а не через загрузчик `cmd.exe`. По умолчанию загрузчик позволяет команде PowerShell, [выполняющейся в фоне](https://code.claude.com/docs/ru/tools-reference.md#background-commands), [переходить в следующий процесс сессии](https://code.claude.com/docs/ru/agent-view.md#the-supervisor-process), например когда вы [переводите сессию в фон](https://code.claude.com/docs/ru/agent-view.md#from-inside-a-session). Если задать переменную, фоновая команда PowerShell останавливается при завершении процесса сессии. Команды Bash не затрагиваются. Требуется Claude Code v2.1.269 или новее |

278| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Установите `1`, чтобы отключить [рабочие процессы](https://code.claude.com/docs/ru/workflows.md#turn-workflows-off). Эквивалентно настройке [`disableWorkflows`](https://code.claude.com/docs/ru/settings-reference#disableworkflows) |278| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Установите `1`, чтобы отключить [рабочие процессы](https://code.claude.com/docs/ru/workflows.md#turn-workflows-off). Эквивалентно настройке [`disableWorkflows`](https://code.claude.com/docs/ru/settings-reference#disableworkflows) |

279| `CLAUDE_CODE_EFFORT_LEVEL` | Задаёт уровень effort для поддерживаемых моделей. Значения: `low`, `medium`, `high`, `xhigh`, `max` или `auto` для использования значения модели по умолчанию. Доступные уровни зависят от модели. Имеет приоритет над `--effort`, `/effort` и настройками `modelSettings` и `effortLevel`. Ограничение [`maxEffortLevel`](https://code.claude.com/docs/ru/settings-reference#maxeffortlevel) по-прежнему применяется. См. [Настройка уровня effort](https://code.claude.com/docs/ru/model-config.md#adjust-effort-level) |279| `CLAUDE_CODE_EFFORT_LEVEL` | Задаёт уровень effort для поддерживаемых моделей. Значения: `low`, `medium`, `high`, `xhigh` или `max`. Доступные уровни зависят от модели. Имеет приоритет над `--effort`, `/effort`, а также над настройками `modelSettings` и `effortLevel`. Ограничение [`maxEffortLevel`](https://code.claude.com/docs/ru/settings-reference#maxeffortlevel) по-прежнему действует. Установите значение `auto` или `unset`, чтобы Claude Code [не отправлял уровень effort](https://code.claude.com/docs/ru/model-config.md#send-no-effort-level) и API применял собственное значение по умолчанию для модели. См. [Настройка уровня effort](https://code.claude.com/docs/ru/model-config.md#adjust-effort-level) |

280| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | Установите `1`, чтобы добавлять в поток сообщений сообщения [`session_state_changed`](https://code.claude.com/docs/ru/agent-sdk/typescript#sdksessionstatechangedmessage), содержащие состояние сессии. Требуется либо [Agent SDK](https://code.claude.com/docs/ru/agent-sdk/overview.md), либо `--print`, `--output-format stream-json` и `--verbose` |280| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | Установите `1`, чтобы добавлять в поток сообщений сообщения [`session_state_changed`](https://code.claude.com/docs/ru/agent-sdk/typescript#sdksessionstatechangedmessage), содержащие состояние сессии. Требуется либо [Agent SDK](https://code.claude.com/docs/ru/agent-sdk/overview.md), либо `--print`, `--output-format stream-json` и `--verbose` |

281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Принимается для совместимости со старыми версиями и ни на что не влияет. Авторежим доступен по умолчанию у всех провайдеров, включая Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сессии [Claude apps gateway](https://code.claude.com/docs/ru/claude-apps-gateway) с выполненным входом. В версиях с v2.1.158 по v2.1.206 установка значения `1` требовалась, чтобы сделать [авторежим](https://code.claude.com/docs/ru/permission-modes.md#eliminate-prompts-with-auto-mode) доступным у этих провайдеров |281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Принимается для совместимости со старыми версиями и ни на что не влияет. Авторежим доступен по умолчанию у всех провайдеров, включая Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сессии [Claude apps gateway](https://code.claude.com/docs/ru/claude-apps-gateway) с выполненным входом. В версиях с v2.1.158 по v2.1.206 установка значения `1` требовалась, чтобы сделать [авторежим](https://code.claude.com/docs/ru/permission-modes.md#eliminate-prompts-with-auto-mode) доступным у этих провайдеров |

282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Переопределяет доступность [сводки сессии](https://code.claude.com/docs/ru/interactive-mode.md#session-recap). Установите `0`, чтобы принудительно отключить сводки независимо от переключателя в `/config`. Установите `1`, чтобы принудительно включить сводки, когда [`awaySummaryEnabled`](https://code.claude.com/docs/ru/settings-reference#awaysummaryenabled) имеет значение `false`. Имеет приоритет над настройкой и переключателем в `/config` |282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Переопределяет доступность [сводки сессии](https://code.claude.com/docs/ru/interactive-mode.md#session-recap). Установите `0`, чтобы принудительно отключить сводки независимо от переключателя в `/config`. Установите `1`, чтобы принудительно включить сводки, когда [`awaySummaryEnabled`](https://code.claude.com/docs/ru/settings-reference#awaysummaryenabled) имеет значение `false`. Имеет приоритет над настройкой и переключателем в `/config` |


584* Получать [инструмент PowerShell](https://code.claude.com/docs/ru/tools-reference.md#powershell-tool) по умолчанию для учётных записей claude.ai и Console в Windows с установленным Git Bash; Claude Code направляет shell-команды через Git Bash, если вы не задали `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. В Windows без Git Bash инструмент остаётся включённым584* Получать [инструмент PowerShell](https://code.claude.com/docs/ru/tools-reference.md#powershell-tool) по умолчанию для учётных записей claude.ai и Console в Windows с установленным Git Bash; Claude Code направляет shell-команды через Git Bash, если вы не задали `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. В Windows без Git Bash инструмент остаётся включённым

585* Получать [отзывы, составленные Claude](https://code.claude.com/docs/ru/tools-reference.md#sendfeedback-tool-behavior), которые Claude Code включает через загружаемый флаг585* Получать [отзывы, составленные Claude](https://code.claude.com/docs/ru/tools-reference.md#sendfeedback-tool-behavior), которые Claude Code включает через загружаемый флаг

586* Добиться того, чтобы Claude [воспринимал большие вставки как вставленный, а не набранный текст](https://code.claude.com/docs/ru/terminal-config.md#how-claude-treats-pasted-text); содержимое за заполнителем `[Pasted text #N]` поступает к Claude без пометки586* Добиться того, чтобы Claude [воспринимал большие вставки как вставленный, а не набранный текст](https://code.claude.com/docs/ru/terminal-config.md#how-claude-treats-pasted-text); содержимое за заполнителем `[Pasted text #N]` поступает к Claude без пометки

587* Добиться того, чтобы Claude Code [исключал MCP-инструменты, схему входных данных которых API отклонил бы](https://code.claude.com/docs/ru/mcp.md#tools-with-invalid-input-schemas); он всё равно отправляет схему, и запрос, который её содержит, завершается [ошибкой 400, указывающей инструмент по его позиции](https://code.claude.com/docs/ru/errors.md#tool-input-schema-is-invalid)587* Добиться того, чтобы Claude Code [исключал MCP-инструменты, схему входных данных которых API отклонил бы](https://code.claude.com/docs/ru/mcp.md#tools-with-invalid-input-schemas)

588* Добиться того, чтобы Claude Code [сжимал длинный диалог, пока ваша сессия в терминале простаивает](https://code.claude.com/docs/ru/settings-reference.md#idlecompaction), незадолго до истечения срока действия часового кэша промптов588* Добиться того, чтобы Claude Code [сжимал длинный диалог, пока ваша сессия в терминале простаивает](https://code.claude.com/docs/ru/settings-reference.md#idlecompaction), незадолго до истечения срока действия часового кэша промптов

589 589 

590### Первая сессия после установки или обновления590### Первая сессия после установки или обновления

errors.md +46 −12

Details

219| `Cloud sessions use your claude.ai login`, в конце отказа по политике, в котором указаны учётные данные | [Command-line errors](#cloud-sessions-use-your-claude-ai-login) |219| `Cloud sessions use your claude.ai login`, в конце отказа по политике, в котором указаны учётные данные | [Command-line errors](#cloud-sessions-use-your-claude-ai-login) |

220| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |220| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |

221| `Cloud sessions aren't available:`, за которым следует причина, по которой не удалось загрузить политику вашей организации | [Command-line errors](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |221| `Cloud sessions aren't available:`, за которым следует причина, по которой не удалось загрузить политику вашей организации | [Command-line errors](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |

222| `Cloud sessions aren't available with this Console sign-in. They need a claude.ai sign-in.` | [Не удаётся получить UUID организации](https://code.claude.com/docs/ru/claude-code-on-the-web.md#unable-to-get-organization-uuid) |

222| `Cloud sessions need a claude.ai sign-in` | [Unable to get organization UUID](https://code.claude.com/docs/ru/claude-code-on-the-web.md#unable-to-get-organization-uuid) |223| `Cloud sessions need a claude.ai sign-in` | [Unable to get organization UUID](https://code.claude.com/docs/ru/claude-code-on-the-web.md#unable-to-get-organization-uuid) |

223| `Nothing was stashed: "<path>" is now a folder in place of a tracked file or link` / `are now folders in place of tracked files or links` | [Command-line errors](#nothing-was-stashed-because-a-folder-replaced-a-tracked-file) |224| `Nothing was stashed: "<path>" is now a folder in place of a tracked file or link` / `are now folders in place of tracked files or links` | [Command-line errors](#nothing-was-stashed-because-a-folder-replaced-a-tracked-file) |

224| `Error: --json-schema is not a valid JSON Schema` | [Command-line errors](#the-json-schema-value-is-not-a-valid-json-schema) |225| `Error: --json-schema is not a valid JSON Schema` | [Command-line errors](#the-json-schema-value-is-not-a-valid-json-schema) |


325| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |326| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |

326| `cannot contain null bytes (\0)` | [Tool errors](#path-cannot-contain-null-bytes) |327| `cannot contain null bytes (\0)` | [Tool errors](#path-cannot-contain-null-bytes) |

327| `Path contains null bytes` | [Tool errors](#path-cannot-contain-null-bytes) |328| `Path contains null bytes` | [Tool errors](#path-cannot-contain-null-bytes) |

329| `command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run` | [Ошибки инструментов](#command-contains-an-invisible-character) |

328| `File is too large to read as an image (the limit is 128MB)` | [Tool errors](#file-is-too-large-to-read-as-an-image) |330| `File is too large to read as an image (the limit is 128MB)` | [Tool errors](#file-is-too-large-to-read-as-an-image) |

329| `Cannot read this as an image: <path> is a pipe or a device` | [Tool errors](#file-is-too-large-to-read-as-an-image) |331| `Cannot read this as an image: <path> is a pipe or a device` | [Tool errors](#file-is-too-large-to-read-as-an-image) |

330| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |332| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |


397| `Claude Code process exited with code N` | [Wrapper and IDE errors](#claude-code-process-exited-with-code-n) |399| `Claude Code process exited with code N` | [Wrapper and IDE errors](#claude-code-process-exited-with-code-n) |

398| `The connection to Claude Code ended before this message completed` | [Wrapper and IDE errors](#the-connection-to-claude-code-ended-before-this-message-completed) |400| `The connection to Claude Code ended before this message completed` | [Wrapper and IDE errors](#the-connection-to-claude-code-ended-before-this-message-completed) |

399| `Could not locate the Claude CLI on PATH` | [Wrapper and IDE errors](#could-not-locate-the-claude-cli-on-path) |401| `Could not locate the Claude CLI on PATH` | [Wrapper and IDE errors](#could-not-locate-the-claude-cli-on-path) |

402| `The Claude Code program for this computer, the <build> build, could not be found` | [Ошибки обёрток и IDE](#the-claude-code-program-for-this-computer-could-not-be-found) |

400| `Restored the code, but skipped N files` | [Rewind warnings and errors](#restored-the-code-but-skipped-files) |403| `Restored the code, but skipped N files` | [Rewind warnings and errors](#restored-the-code-but-skipped-files) |

401| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind warnings and errors](#no-files-were-restored) |404| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind warnings and errors](#no-files-were-restored) |

402| `Transcript writes are failing (...)` | [Session saving warnings](#transcript-writes-are-failing) |405| `Transcript writes are failing (...)` | [Session saving warnings](#transcript-writes-are-failing) |


485 488 

486Начиная с v2.1.198 обычный совет спиннера подавляется во время повторных попыток. После того как причина ошибки раскрыта, если сбой является перегрузкой 529, строка ниже обратного отсчёта также называет, где проверить статус услуги: `status.claude.com` на Anthropic API, или хост поставщика или шлюза, названный в сообщении, в других конфигурациях.489Начиная с v2.1.198 обычный совет спиннера подавляется во время повторных попыток. После того как причина ошибки раскрыта, если сбой является перегрузкой 529, строка ниже обратного отсчёта также называет, где проверить статус услуги: `status.claude.com` на Anthropic API, или хост поставщика или шлюза, названный в сообщении, в других конфигурациях.

487 490 

488Если никакие данные не поступают в поток ответа в течение 20 секунд, пока запрос всё ещё ожидается, спиннер показывает `Waiting for API response · will retry in … · check your network` перед началом любой повторной попытки. Запрос ещё не завершился неудачей: обратный отсчёт идёт до момента, когда Claude Code прерывает застопорившееся соединение. После прерывания то, что вы видите, зависит от того, как далеко продвинулся ответ:491#### Waiting for API response

492 

493Баннер `Waiting for API response · will retry in … · check your network` означает, что Claude Code ждал не менее 20 секунд, не получая никаких данных по запросу. Запрос ещё не завершился неудачей: обратный отсчёт идёт до момента, когда Claude Code прерывает застопорившееся соединение. Если прерывание происходит:

489 494 

490* До того, как Claude завершил блок текста или вызов инструмента, или начал один после завершения своих размышлений, Claude Code повторяет запрос или завершает ход с ошибкой. [Automatic retries](#automatic-retries) говорит, какие застои он повторяет и сколько раз.495* До того, как Claude завершил блок текста или вызов инструмента, или начал один после завершения своих размышлений, Claude Code повторяет запрос или завершает ход с ошибкой. [Automatic retries](#automatic-retries) говорит, какие застои он повторяет и сколько раз.

491* После того, как Claude завершил блок текста или вызов инструмента, или начал один после завершения своих размышлений, но до того, как Claude завершил ответ, Claude Code сохраняет то, что Claude завершил, продолжает ход из любых вызовов инструментов, которые Claude завершил, и показывает [The response above may be incomplete](#the-response-above-may-be-incomplete). В неинтерактивной сессии и для ответа субагента в любой сессии Claude Code может сначала предложить Claude продолжить ответ; эта запись говорит, когда это происходит и когда вы всё ещё видите уведомление там.496* После того, как Claude завершил блок текста или вызов инструмента, или начал один после завершения своих размышлений, но до того, как Claude завершил ответ, Claude Code сохраняет то, что Claude завершил, продолжает ход из любых вызовов инструментов, которые Claude завершил, и показывает [The response above may be incomplete](#the-response-above-may-be-incomplete). В неинтерактивной сессии и для ответа субагента в любой сессии Claude Code может сначала предложить Claude продолжить ответ; эта запись говорит, когда это происходит и когда вы всё ещё видите уведомление там.

492* После того, как Claude завершил ответ, Claude Code завершает ход нормально.497* После того, как Claude завершил ответ, Claude Code завершает ход нормально.

493 498 

494Баннер очищается сам по себе, как только данные возобновляются или повторная попытка успешна. Если он появляется при каждой попытке, рассматривайте это как [network issue](#unable-to-connect-to-api). До v2.1.185 баннер появлялся через 10 секунд с другой формулировкой.499Баннер очищается сам по себе, как только данные возобновляются или повторная попытка успешна. Если он появляется при каждой попытке, рассматривайте это как [network issue](#unable-to-connect-to-api). Если вы подключаетесь через шлюз, см. [Баннер ожидания появляется и исчезает при работе через шлюз](#waiting-banner-behind-a-gateway). До v2.1.185 баннер появлялся через 10 секунд с другой формулировкой.

495 

496Пока Claude консультируется с [advisor](https://code.claude.com/docs/ru/advisor.md), баннер появляется через 90 секунд без данных вместо 20, потому что длительный обзор советника может не отправлять ничего более 20 секунд. До v2.1.214 порог в 20 секунд применялся и во время вызовов советника, поэтому баннер появлялся во время обзоров советника, даже когда всё было в порядке.

497 500 

498#### Баннер ожидания появляется и исчезает при работе через шлюз501#### Баннер ожидания появляется и исчезает при работе через шлюз

499 502 


2495 2498 

2496**Что делать:**2499**Что делать:**

2497 2500 

2498* Если ваша версия Claude Code ниже v2.1.216, выполните `claude update`.2501* Если ваша версия Claude Code старше v2.1.300, выполните [`claude update`](https://code.claude.com/docs/ru/setup#update-claude-code) в оболочке. До v2.1.300 Claude Code не [повторял запрос без параметров отклонённого инструмента](https://code.claude.com/docs/ru/mcp.md#tools-whose-input-schema-the-api-refuses), поэтому эта ошибка повторялась в каждом запросе, включавшем этот инструмент.

2499* Удалите или [отключите](https://code.claude.com/docs/ru/mcp.md#disable-a-server-without-removing-it) MCP-сервер, объявляющий недопустимую схему. Ошибка указывает инструмент только по позиции. В v2.1.216 и новее проверьте лог каждого сервера на наличие строки с именем инструмента, чья схема входных данных будет отклонена. Если ни один лог его не называет, отключайте серверы по одному.2502* Удалите или [отключите](https://code.claude.com/docs/ru/mcp.md#disable-a-server-without-removing-it) MCP-сервер, объявляющий недопустимую схему. Ошибка указывает инструмент только по позиции. В v2.1.216 и новее проверьте лог каждого сервера на наличие строки с именем инструмента, чья схема входных данных будет отклонена. Если ни один лог его не называет, отключайте серверы по одному.

2500* Если вы поддерживаете сервер, исправьте `input_schema` инструмента. Схема должна быть допустимой JSON Schema, а имена свойств верхнего уровня должны иметь длину от 1 до 64 символов и содержать только буквы и цифры ASCII, `_`, `.` и `-`. См. раздел [Tools with invalid input schemas](https://code.claude.com/docs/ru/mcp.md#tools-with-invalid-input-schemas).2503* Если вы поддерживаете сервер, исправьте `input_schema` инструмента. Схема должна быть допустимой JSON Schema, а имена свойств верхнего уровня должны иметь длину от 1 до 64 символов и содержать только буквы и цифры ASCII, `_`, `.` и `-`. См. раздел [Tools with invalid input schemas](https://code.claude.com/docs/ru/mcp.md#tools-with-invalid-input-schemas).

2501 2504 


3295* **`Error: Workspace not trusted. <folder> is your home directory`**: поскольку доверие для домашнего каталога никогда не сохраняется, предварительный запуск `claude` там не поможет. Вместо этого выполните `claude ultrareview` из каталога проекта, предварительно один раз запустив там `claude`, чтобы принять диалог доверия, или добавьте `--trust-workspace`.3298* **`Error: Workspace not trusted. <folder> is your home directory`**: поскольку доверие для домашнего каталога никогда не сохраняется, предварительный запуск `claude` там не поможет. Вместо этого выполните `claude ultrareview` из каталога проекта, предварительно один раз запустив там `claude`, чтобы принять диалог доверия, или добавьте `--trust-workspace`.

3296* **`No answer in time.` с последующим `Error: Workspace not trusted`**: на вопрос `Trust <folder>? [y/N]` не было ответа в течение 5 минут. Снова выполните `claude ultrareview` и ответьте на него.3299* **`No answer in time.` с последующим `Error: Workspace not trusted`**: на вопрос `Trust <folder>? [y/N]` не было ответа в течение 5 минут. Снова выполните `claude ultrareview` и ответьте на него.

3297* **`Ultrareview did not start: <folder> is not trusted`**: вы отказались на вопрос `Trust <folder>? [y/N]`, например ответив `n` или нажав Enter. Чтобы начать ревью, снова выполните `claude ultrareview` и ответьте `y`.3300* **`Ultrareview did not start: <folder> is not trusted`**: вы отказались на вопрос `Trust <folder>? [y/N]`, например ответив `n` или нажав Enter. Чтобы начать ревью, снова выполните `claude ultrareview` и ответьте `y`.

3298* **``Ultrareview did not start: `--trust-workspace` takes no value``**: после `--trust-workspace` следует что-то, кроме флага, например номер PR или `false`. Если вы не доверяете папке, не указывайте флаг. Чтобы доверять ей на этот запуск, поставьте номер PR или базовую ветку перед флагом: `claude ultrareview 1234 --trust-workspace`.3301* **``Ultrareview did not start: `--trust-workspace` takes no value``**: после `--trust-workspace` следует что-то, кроме флага, например номер PR или `false`. Если вы не доверяете папке, не указывайте этот флаг. Чтобы доверять ей в этом запуске, поставьте номер PR или базовую ветку перед флагом: `claude ultrareview 1234 --trust-workspace`.

3299 3302 

3300До v2.1.309 `claude ultrareview` не принимал `--trust-workspace`.3303До v2.1.309 `claude ultrareview` не принимал `--trust-workspace`.

3301 3304 


3587 3590 

3588Родственные сообщения появляются ещё до запуска команды:3591Родственные сообщения появляются ещё до запуска команды:

3589 3592 

3590* `Shell command permission check failed for pattern "..."`: проверка разрешений для команды её не допустила. В разделе [Проверки разрешений для внедрённых команд](https://code.claude.com/docs/ru/skills.md#permission-checks-on-injected-commands) описано, какие результаты прерывают выполнение в каждом режиме разрешений и как заранее одобрить команду с помощью `allowed-tools`3593* `Shell command permission check failed for pattern "..."`: проверка разрешений команды её не разрешила. В разделе [Проверки разрешений для внедрённых команд](https://code.claude.com/docs/ru/skills.md#permission-checks-on-injected-commands) описано, какие результаты прерывают вызов в каждом режиме разрешений и как заранее разрешить команду с помощью `allowed-tools`

3591* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter скилла требует bash на компьютере, где его нет. Установите Git for Windows или измените frontmatter на `shell: powershell`. См. [Как выполняются внедрённые команды](https://code.claude.com/docs/ru/skills.md#how-injected-commands-run)3594* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter скилла требует bash на компьютере, где его нет. Установите Git for Windows или измените frontmatter на `shell: powershell`. См. [Как выполняются внедрённые команды](https://code.claude.com/docs/ru/skills.md#how-injected-commands-run)

3592* `No shell command in <name> was run`: одна из команд `!` в файле содержит необработанный управляющий символ, отличный от табуляции или перевода строки, поэтому ни одна из них не выполняется. См. [как найти и удалить этот символ](#no-shell-command-was-run)

3593 3595 

3594**Что делать:**3596**Что делать:**

3595 3597 


3599 3601 

3600### No shell command in a skill or command was run3602### No shell command in a skill or command was run

3601 3603 

3602Одна из [команд динамического контекста](https://code.claude.com/docs/ru/skills.md#inject-dynamic-context) `` !`<command>` `` в файле скилла или пользовательской команды содержит необработанный управляющий символ, отличный от табуляции или перевода строки. Claude Code отклоняет весь вызов до выполнения любой из команд файла.3604`No shell command in <name> was run` означает, что [команда динамического контекста](https://code.claude.com/docs/ru/skills.md#inject-dynamic-context) `` !`<command>` `` в этом файле скилла или команды содержит символ, который отклоняет инструмент Bash или PowerShell:

3605 

3606* **Любой инструмент**: необработанный управляющий символ, кроме табуляции или перевода строки

3607* **Инструмент PowerShell**: также U+FEFF или U+180E

3603 3608 

3604Сообщение называет инструмент оболочки, который выполнил бы команды, — Bash или PowerShell, — и заканчивается отклонённой командой. Каждый такой символ заменяется на `�`, чтобы было видно, где он находится:3609Сообщение заканчивается отклонённой командой, в которой каждый отклонённый символ показан как `�`, как в этом примере для инструмента Bash:

3605 3610 

3606```text theme={null}3611```text theme={null}

3607No shell command in /my-skill was run, because the Bash tool does not accept one of them: command contains control characters that would be hidden in the approval dialog. Unprintable characters are shown as � below: remove them from the skill or command file, or from the arguments or options substituted into it.3612No shell command in /my-skill was run, because the Bash tool does not accept one of them: command contains control characters that would be hidden in the approval dialog. Unprintable characters are shown as � below: remove them from the skill or command file, or from the arguments or options substituted into it.


3610 3615 

3611**Что делать:**3616**Что делать:**

3612 3617 

3613* Найдите каждый `�` в команде, процитированной в конце сообщения. Удалите символ, который он обозначает, из файла скилла или команды либо из аргументов или параметров, подставляемых в файл.3618* Найдите каждый `�` в команде, процитированной в конце сообщения. Удалите обозначаемый им символ из [файла скилла или команды](https://code.claude.com/docs/ru/skills.md#where-skills-live) либо из аргументов или [параметров](https://code.claude.com/docs/ru/plugins/manifest-reference.md#user-configuration), подставляемых в файл.

3614 3619 

3615### Необходимо предоставить ввод при использовании `--print`3620### Необходимо предоставить ввод при использовании `--print`

3616 3621 


3739 3744 

3740* **Вы не передали базовую ветку**: Claude Code сравнивал с веткой репозитория по умолчанию и предлагает явно передать вашу базовую ветку, как в примере выше3745* **Вы не передали базовую ветку**: Claude Code сравнивал с веткой репозитория по умолчанию и предлагает явно передать вашу базовую ветку, как в примере выше

3741* **Вы передали базовую ветку, которая уже была в вашем клоне**: подсказка гласит ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3746* **Вы передали базовую ветку, которая уже была в вашем клоне**: подсказка гласит ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``

3742* **Вы передали базовую ветку, которой не было в вашем клоне**: Claude Code загрузил её из origin перед сравнением. Подсказка гласит ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; если Claude Code не может определить, является ли ваш клон поверхностным (shallow), он предлагает вместо этого `git fetch --unshallow origin`. До v2.1.221 подсказка предлагала `git fetch --unshallow origin` для каждой загруженной базовой ветки, и в полном клоне эта команда завершалась ошибкой `fatal: --unshallow on a complete repository does not make sense`.3747* **Вы передали базовую ветку, которой не было в вашем клоне**: Claude Code получил её из origin перед сравнением. Подсказка гласит ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; если Claude Code не может определить, является ли ваш клон неглубоким (shallow), он вместо этого предлагает `git fetch --unshallow origin`. До версии v2.1.221 подсказка предлагала `git fetch --unshallow origin` для каждой полученной базовой ветки, а в полном клоне эта команда завершается ошибкой `fatal: --unshallow on a complete repository does not make sense`.

3743 3748 

3744**Что делать:**3749**Что делать:**

3745 3750 


4568 4573 

4569До версии 2.1.281 нулевой байт в пути Read, Write, Edit или NotebookEdit завершал весь ход с ошибкой `Path contains null bytes`, и инструмент так и не запускался.4574До версии 2.1.281 нулевой байт в пути Read, Write, Edit или NotebookEdit завершал весь ход с ошибкой `Path contains null bytes`, и инструмент так и не запускался.

4570 4575 

4576### Command contains an invisible character

4577 

4578[Инструмент PowerShell](https://code.claude.com/docs/ru/tools-reference.md#powershell-tool) отказался выполнять команду, содержащую U+FEFF или U+180E:

4579 

4580```text theme={null}

4581Error: command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run. Remove the character, keep the text that needs it in a file that the command reads, or write it as $([char]0xFEFF) or $([char]0x180E) inside a double-quoted string

4582```

4583 

4584**Что делать:**

4585 

4586* **Для команды, написанной Claude**: исправлять ничего не нужно. Сообщение объясняет Claude, как переписать команду.

4587* **Для файла скилла или команды**: сообщение следует за `No shell command in <name> was run`. См. [где найти символ и как его удалить](#no-shell-command-was-run).

4588 

4571### File is too large to read as an image4589### File is too large to read as an image

4572 4590 

4573Claude попытался прочитать файл как изображение с помощью [инструмента Read](https://code.claude.com/docs/ru/tools-reference.md#read-tool-behavior), а размер файла превышает 128 МБ — максимум, который Read загружает из файла изображения. Ничего не было прочитано, и Claude получает эту ошибку как результат инструмента:4591Claude попытался прочитать файл как изображение с помощью [инструмента Read](https://code.claude.com/docs/ru/tools-reference.md#read-tool-behavior), а размер файла превышает 128 МБ — максимум, который Read загружает из файла изображения. Ничего не было прочитано, и Claude получает эту ошибку как результат инструмента:


5431* Установите запись PATH как переменную окружения пользователя или системы, а не в вашем профиле PowerShell. Расширение не запускает ваш профиль, поэтому редактирование PATH, которое существует только там, никогда до него не доходит.5449* Установите запись PATH как переменную окружения пользователя или системы, а не в вашем профиле PowerShell. Расширение не запускает ваш профиль, поэтому редактирование PATH, которое существует только там, никогда до него не доходит.

5432* Перезагрузите VS Code после изменения PATH. Расширение проверяет PATH, который VS Code захватил при запуске, поэтому изменение PATH вступает в силу только после перезагрузки.5450* Перезагрузите VS Code после изменения PATH. Расширение проверяет PATH, который VS Code захватил при запуске, поэтому изменение PATH вступает в силу только после перезагрузки.

5433 5451 

5452### The Claude Code program for this computer could not be found

5453 

5454[Расширение VS Code](https://code.claude.com/docs/ru/vs-code.md) искало встроенную в него копию Claude Code и не нашло ни одной, собранной для вашего компьютера. В сообщении указана сборка, которая нужна вашему компьютеру:

5455 

5456```text theme={null}

5457The Claude Code program for this computer, the Linux (linux-x64) build, could not be found.

5458```

5459 

5460**Что делать:**

5461 

5462* Если в сообщении указано, какую сборку содержит расширение, у вас установлен пакет расширения для другой платформы: установите пакет, созданный для сборки, указанной в сообщении

5463* Если в сообщении не указано, какую сборку содержит расширение, переустановите расширение Claude Code из представления Extensions вашего редактора

5464* Или, в любом случае, задайте в [`claudeCode.claudeProcessWrapper`](https://code.claude.com/docs/ru/vs-code#extension-settings) отдельно установленный исполняемый файл `claude`

5465 

5466До версии 2.1.290 эта ошибка отображалась как `Unsupported platform: <platform>-<arch>. No compatible Claude Code binary found.`

5467 

5434### The connection to Claude Code ended before this message completed5468### The connection to Claude Code ended before this message completed

5435 5469 

5436[Расширение VS Code](https://code.claude.com/docs/ru/vs-code.md) отправило ваше сообщение процессу `claude`, и соединение завершилось без ошибки до того, как процесс подтвердил или завершил его. Расширение не может определить, было ли сообщение обработано, поэтому оно просит вас отправить его снова:5470[Расширение VS Code](https://code.claude.com/docs/ru/vs-code.md) отправило ваше сообщение процессу `claude`, и соединение завершилось без ошибки до того, как процесс подтвердил или завершил его. Расширение не может определить, было ли сообщение обработано, поэтому оно просит вас отправить его снова:

fast-mode.md +10 −8

Details

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> Быстрый режим находится в [исследовательском превью](#research-preview). Функция, цены и доступность могут измениться на основе отзывов.11> Быстрый режим для Claude Opus 5.5 доступен, а быстрый режим для Claude Opus 5 и Claude Opus 4.8 находится в [research preview](#research-preview).

12 12 

13Быстрый режим — это высокоскоростная конфигурация для Claude Opus, которая делает модель в 2,5 раза быстрее при более высокой стоимости за токен. Включайте его с помощью `/fast`, когда вам нужна скорость для интерактивной работы, такой как быстрая итерация или живая отладка, и отключайте, когда стоимость важнее, чем задержка.13Быстрый режим — это высокоскоростная конфигурация для Claude Opus, которая делает модель в 2,5 раза быстрее при более высокой стоимости за токен. Включайте его с помощью `/fast`, когда вам нужна скорость для интерактивной работы, такой как быстрая итерация или живая отладка, и отключайте, когда стоимость важнее, чем задержка.

14 14 


20 20 

21* Используйте `/fast` для включения быстрого режима в Claude Code CLI. Расширение [VS Code](https://code.claude.com/docs/ru/vs-code.md) предлагает команду **Toggle fast mode** при выборе модели, которая поддерживает быстрый режим. Claude Code сохраняет этот переключатель в вашей настройке [`fastMode`](#toggle-fast-mode).21* Используйте `/fast` для включения быстрого режима в Claude Code CLI. Расширение [VS Code](https://code.claude.com/docs/ru/vs-code.md) предлагает команду **Toggle fast mode** при выборе модели, которая поддерживает быстрый режим. Claude Code сохраняет этот переключатель в вашей настройке [`fastMode`](#toggle-fast-mode).

22* Цены на быстрый режим составляют \$8/\$40 за MTok входа/выхода на Opus 5.5 и \$10/\$50 на Opus 5 и Opus 4.8.22* Цены на быстрый режим составляют \$8/\$40 за MTok входа/выхода на Opus 5.5 и \$10/\$50 на Opus 5 и Opus 4.8.

23* Доступно пользователям Claude Code на планах подписки (Pro/Max/Team/Enterprise) и на Claude Console. Организациям Team и Enterprise требуется, чтобы Owner сначала это включил, а организациям Console требуется сначала предоставить доступ, оба варианта описаны в разделе [Requirements](#requirements).23* Доступно пользователям Claude Code на планах подписки (Pro/Max/Team/Enterprise) и на Claude Console. Организациям Team и Enterprise требуется, чтобы Owner сначала это включил, а организациям Console требуется сначала получить предоставленный доступ, чтобы использовать его с Opus 5 или Opus 4.8. Оба варианта описаны в разделе [Требования](#requirements).

24* Для пользователей Claude Code на планах подписки (Pro/Max/Team/Enterprise) быстрый режим доступен только через кредиты использования и не включен в лимиты скорости подписки.24* Для пользователей Claude Code на планах подписки (Pro/Max/Team/Enterprise) быстрый режим доступен только через кредиты использования и не включен в лимиты скорости подписки.

25 25 

26## Включение быстрого режима26## Включение быстрого режима


119 119 

120Быстрый режим требует всех следующих условий:120Быстрый режим требует всех следующих условий:

121 121 

122* **Только Anthropic API или подписка**: быстрый режим доступен через Anthropic Console API и для планов подписки Claude с использованием кредитов. Он недоступен на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS. Организации Console также должны иметь [доступ к быстрому режиму](#enable-fast-mode-for-your-organization).122* **Только Anthropic API или подписка**: быстрый режим доступен через Anthropic Console API и для планов подписки Claude с использованием кредитов. Он недоступен на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS. Организации Console также должны иметь [предоставленный доступ к быстрому режиму](#enable-fast-mode-for-your-organization), чтобы использовать его с Opus 5 или Opus 4.8.

123* **Кредиты использования включены для планов подписки**: на плане Pro, Max, Team или Enterprise в вашей учётной записи должны быть включены [кредиты использования](https://code.claude.com/docs/ru/costs.md#add-usage-credits-to-your-subscription), что позволяет оплату сверх включённого в ваш план использования. До их включения `/fast` сообщает "Fast mode requires usage credits". Способ их включения зависит от вашего плана:123* **Кредиты использования включены для планов подписки**: на плане Pro, Max, Team или Enterprise в вашей учётной записи должны быть включены [кредиты использования](https://code.claude.com/docs/ru/costs.md#add-usage-credits-to-your-subscription), что позволяет оплату сверх включённого в ваш план использования. До их включения `/fast` сообщает "Fast mode requires usage credits". Способ их включения зависит от вашего плана:

124 * На Pro и Max включите их в разделе **Usage credits** на странице [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai или запустите `/usage-credits`, чтобы открыть эту страницу.124 * На Pro и Max включите их в разделе **Usage credits** на странице [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai или запустите `/usage-credits`, чтобы открыть эту страницу.

125 * На Team и Enterprise участник с доступом к биллингу включает их для организации в [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), а участник без такого доступа запускает `/usage-credits`, чтобы отправить запрос администраторам организации.125 * На Team и Enterprise участник с доступом к биллингу включает их для организации в [**Organization settings > Usage**](https://claude.ai/admin-settings/usage), а участник без такого доступа запускает `/usage-credits`, чтобы отправить запрос администраторам организации.


129> Использование быстрого режима берет кредиты непосредственно из кредитов использования, даже если у вас остается использование в вашем плане.129> Использование быстрого режима берет кредиты непосредственно из кредитов использования, даже если у вас остается использование в вашем плане.

130 130 

131* **Платная организация Console**: учетные записи Claude Console не используют кредиты использования, и ваша организация платит за быстрый режим за токен вместе с остальным использованием API. На бесплатном плане Evaluation Console `/fast` показывает "Fast mode unavailable during evaluation. Please purchase credits." Чтобы это исправить, приобретите кредиты в [параметрах выставления счетов Console](https://platform.claude.com/settings/billing).131* **Платная организация Console**: учетные записи Claude Console не используют кредиты использования, и ваша организация платит за быстрый режим за токен вместе с остальным использованием API. На бесплатном плане Evaluation Console `/fast` показывает "Fast mode unavailable during evaluation. Please purchase credits." Чтобы это исправить, приобретите кредиты в [параметрах выставления счетов Console](https://platform.claude.com/settings/billing).

132 

133 Быстрый режим с Opus 5.5 также зависит от [уровня использования](https://platform.claude.com/docs/en/api/rate-limits) вашей организации.

132* **Включение владельцем для Team и Enterprise**: быстрый режим отключен по умолчанию для организаций Team и Enterprise. Владелец должен явно [включить быстрый режим](#enable-fast-mode-for-your-organization) перед тем, как пользователи смогут получить к нему доступ.134* **Включение владельцем для Team и Enterprise**: быстрый режим отключен по умолчанию для организаций Team и Enterprise. Владелец должен явно [включить быстрый режим](#enable-fast-mode-for-your-organization) перед тем, как пользователи смогут получить к нему доступ.

133 135 

134> [!NOTE]136> [!NOTE]


144 146 

145Место, где вы включаете быстрый режим, зависит от того, какой продукт использует ваша организация:147Место, где вы включаете быстрый режим, зависит от того, какой продукт использует ваша организация:

146 148 

147* **Console** (клиенты API): администратор включает его в [Claude Code preferences](https://platform.claude.com/claude-code/preferences). Быстрый режим находится в [исследовательском предпросмотре](#research-preview), поэтому ваша организация также должна иметь доступ к быстрому режиму, предоставленный перед тем, как запросы быстрого режима будут успешными. Чтобы получить доступ, свяжитесь с вашим менеджером по работе с клиентами или присоединитесь к списку ожидания, как описано в [быстром режиме на Claude API](https://platform.claude.com/docs/en/build-with-claude/fast-mode).149* **Console** (клиенты API): администратор включает его в [Claude Code preferences](https://platform.claude.com/claude-code/preferences)

148 

149 Без предоставленного доступа API отклоняет каждый запрос быстрого режима с кодом 429, и Claude Code рассматривает каждое отклонение как [ограничение скорости быстрого режима](#handle-rate-limits). В отличие от периода ожидания ограничения скорости, отклонения продолжаются до тех пор, пока доступ не будет предоставлен.

150* **Claude AI** (Team и Enterprise): Owner включает его в [**Organization settings > Claude Code**](https://claude.ai/admin-settings/claude-code)150* **Claude AI** (Team и Enterprise): Owner включает его в [**Organization settings > Claude Code**](https://claude.ai/admin-settings/claude-code)

151 151 

152Организациям Console, которые используют Claude Opus 5 или Claude Opus 4.8, также нужен предоставленный доступ, как описано в [быстром режиме на Claude API](https://platform.claude.com/docs/en/build-with-claude/fast-mode). Без этого доступа запросы быстрого режима к этим моделям упираются в [ограничение частоты запросов быстрого режима](#handle-rate-limits) и возвращаются к стандартной скорости, пока доступ не будет предоставлен.

153 

152Другой вариант полного отключения быстрого режима — установить `CLAUDE_CODE_DISABLE_FAST_MODE=1`. См. [Переменные окружения](https://code.claude.com/docs/ru/env-vars.md).154Другой вариант полного отключения быстрого режима — установить `CLAUDE_CODE_DISABLE_FAST_MODE=1`. См. [Переменные окружения](https://code.claude.com/docs/ru/env-vars.md).

153 155 

154### Использование быстрого режима за прокси и шлюзами LLM156### Использование быстрого режима за прокси и шлюзами LLM


201 203 

202## Обработка лимитов скорости204## Обработка лимитов скорости

203 205 

204Быстрый режим имеет отдельные лимиты скорости от стандартного Opus. Все поддерживаемые модели Opus используют один пул лимитов быстрого режима: использование на любой из них берет из одних и тех же лимитов. Когда вы достигаете лимита скорости быстрого режима:206Быстрый режим имеет отдельные ограничения частоты запросов, отличные от стандартного Opus; для организаций Console они описаны на странице [ограничений частоты запросов](https://platform.claude.com/docs/en/api/rate-limits) Claude Platform. Когда вы достигаете лимита запросов быстрого режима:

205 207 

2061. Быстрый режим автоматически переключается на стандартную скорость2081. Быстрый режим автоматически переключается на стандартную скорость

2072. Значок `↯` становится серым, указывая на охлаждение2092. Значок `↯` становится серым, указывая на охлаждение


217 219 

218## Исследовательское превью220## Исследовательское превью

219 221 

220Быстрый режим — это функция исследовательского превью. Это означает:222Быстрый режим для Claude Opus 5 и Claude Opus 4.8 — это функция исследовательского превью. Это означает:

221 223 

222* Функция может измениться на основе отзывов224* Функция может измениться на основе отзывов

223* Доступность и цены могут измениться225* Доступность и цены могут измениться

Details

90 <tr>90 <tr>

91 <td>[Fast mode](https://code.claude.com/docs/ru/fast-mode.md)</td>91 <td>[Fast mode](https://code.claude.com/docs/ru/fast-mode.md)</td>

92 <td>✓ ([включено владельцем](https://code.claude.com/docs/ru/fast-mode.md#enable-fast-mode-for-your-organization) для Team и Enterprise)</td>92 <td>✓ ([включено владельцем](https://code.claude.com/docs/ru/fast-mode.md#enable-fast-mode-for-your-organization) для Team и Enterprise)</td>

93 <td>✓ (организации с подготовленным доступом)</td>93 <td>✓ (для Opus 5 и 4.8 требуется подготовленный доступ)</td>

94 <td>✗</td>94 <td>✗</td>

95 <td>✗</td>95 <td>✗</td>

96 <td>✗</td>96 <td>✗</td>


285 285 

286**Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription).286**Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription).

287 287 

288Всё в разделе [Возможности CLI, которые различаются по поставщикам](#cli-capabilities-that-vary-by-provider) доступно, за исключением того, что [быстрый режим](https://code.claude.com/docs/ru/fast-mode.md) требует [подготовленный доступ](https://code.claude.com/docs/ru/fast-mode.md#enable-fast-mode-for-your-organization). [Server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md), которые вы настраиваете в организации claude.ai Team или Enterprise, не применяются к сессии, которая аутентифицируется с помощью API-ключа Console. См. [Доступность платформы](https://code.claude.com/docs/ru/server-managed-settings.md#platform-availability), чтобы узнать, как охватить такие сессии.288Всё в разделе [Возможности CLI, которые различаются по поставщикам](#cli-capabilities-that-vary-by-provider) доступно, за исключением того, что [быстрый режим](https://code.claude.com/docs/ru/fast-mode.md) с Claude Opus 5 или Claude Opus 4.8 требует [подготовленный доступ](https://code.claude.com/docs/ru/fast-mode.md#enable-fast-mode-for-your-organization). [Server-managed settings](https://code.claude.com/docs/ru/server-managed-settings.md), которые вы настраиваете в организации claude.ai Team или Enterprise, не применяются к сессии, которая аутентифицируется с помощью API-ключа Console. См. [Доступность платформы](https://code.claude.com/docs/ru/server-managed-settings.md#platform-availability), чтобы узнать, как охватить такие сессии.

289 289 

290**Частичная поддержка:**290**Частичная поддержка:**

291 291 

Details

241 - uses: anthropics/claude-code-action@v1241 - uses: anthropics/claude-code-action@v1

242 with:242 with:

243 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}243 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

244 plugin_marketplaces: "https://github.com/anthropics/claude-code.git"244 plugin_marketplaces: "https://github.com/anthropics/claude-plugins-official.git"

245 plugins: "code-review@claude-code-plugins"245 plugins: "code-review@claude-plugins-official"

246 prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"246 prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"

247 claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'247 claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

248```248```

Details

221 221 

222Если проверки или облачные сессии истекают по времени, ваш экземпляр GHES может быть недоступен из инфраструктуры Anthropic. Убедитесь, что ваш брандмауэр разрешает входящие соединения с [IP-адресов Anthropic](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses). Сессии в [самостоятельно размещённой среде](https://code.claude.com/docs/ru/self-hosted-environments) достигают GHES изнутри вашей сети, поэтому когда одна из них не может клонировать, проверьте собственный сетевой путь runner вместо этого. Для средства выбора репозитория и других размещённых предварительных потоков сессии см. [Требования к сети](#network-requirements).222Если проверки или облачные сессии истекают по времени, ваш экземпляр GHES может быть недоступен из инфраструктуры Anthropic. Убедитесь, что ваш брандмауэр разрешает входящие соединения с [IP-адресов Anthropic](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses). Сессии в [самостоятельно размещённой среде](https://code.claude.com/docs/ru/self-hosted-environments) достигают GHES изнутри вашей сети, поэтому когда одна из них не может клонировать, проверьте собственный сетевой путь runner вместо этого. Для средства выбора репозитория и других размещённых предварительных потоков сессии см. [Требования к сети](#network-requirements).

223 223 

224### Проверка подключения проходит, но вторая проверка не удаётся

225 

226Вторая проверка подключается к вашему экземпляру GHES так же, как это делают облачные сессии, размещённые Anthropic. Найдите своё сообщение, чтобы понять, нужно ли проверить брандмауэр или повторить попытку:

227 

228* **`Connection test passed, but a second test failed.`**: если ваш экземпляр находится за брандмауэром, разрешите все [исходящие IP-адреса](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) Anthropic, поскольку проверка подключения может пройти, даже если ваш брандмауэр блокирует некоторые из них. Также можно повторить попытку через несколько минут.

229* **`Connection test passed, but a second test could not run.`**: повторите попытку через несколько минут.

230 

231Чтобы выполнить проверку снова, откройте меню **More options** подключения на странице [**Organization settings > Git providers**](https://claude.ai/admin-settings/source-control#github-enterprise) и выберите **Test connection**.

232 

224### Запуск сессии не удаётся с `Unable to get organization UUID`233### Запуск сессии не удаётся с `Unable to get organization UUID`

225 234 

226Claude Code не смог прочитать организацию claude.ai из ваших учётных данных. Выполните вход с помощью `/login`, используя учётную запись в вашей организации Team или Enterprise, так как поддержка GitHub Enterprise Server ограничена этими планами. См. [Unable to get organization UUID](https://code.claude.com/docs/ru/claude-code-on-the-web.md#unable-to-get-organization-uuid) для причин и других сообщений, которые создаёт это состояние.235Claude Code не смог прочитать организацию claude.ai из ваших учётных данных. Выполните вход с помощью `/login`, используя учётную запись в вашей организации Team или Enterprise, так как поддержка GitHub Enterprise Server ограничена этими планами. См. [Unable to get organization UUID](https://code.claude.com/docs/ru/claude-code-on-the-web.md#unable-to-get-organization-uuid) для причин и других сообщений, которые создаёт это состояние.

Details

332* Фоновые команды в локальной сессии, с которой вы работаете из терминала, десктопного приложения или расширения VS Code, не имеют ограничения по времени. В сессии, которая выполняется без присмотра, например при запуске с `-p` или в облачной сессии, Claude Code останавливает фоновую команду по достижении её [ограничения по времени](https://code.claude.com/docs/ru/tools-reference.md#time-limit-for-background-commands)332* Фоновые команды в локальной сессии, с которой вы работаете из терминала, десктопного приложения или расширения VS Code, не имеют ограничения по времени. В сессии, которая выполняется без присмотра, например при запуске с `-p` или в облачной сессии, Claude Code останавливает фоновую команду по достижении её [ограничения по времени](https://code.claude.com/docs/ru/tools-reference.md#time-limit-for-background-commands)

333* Фоновая команда, запущенная переднеплановым [подагентом](https://code.claude.com/docs/ru/sub-agents.md#run-subagents-in-foreground-or-background), заканчивается, когда заканчивается выполнение этого подагента, независимо от того, завершилась ли она, не удалась или была прервана; см. [Когда фоновая команда останавливается](https://code.claude.com/docs/ru/tools-reference.md#when-a-background-command-stops) в справочнике инструментов333* Фоновая команда, запущенная переднеплановым [подагентом](https://code.claude.com/docs/ru/sub-agents.md#run-subagents-in-foreground-or-background), заканчивается, когда заканчивается выполнение этого подагента, независимо от того, завершилась ли она, не удалась или была прервана; см. [Когда фоновая команда останавливается](https://code.claude.com/docs/ru/tools-reference.md#when-a-background-command-stops) в справочнике инструментов

334 334 

335Чтобы отключить фоновые команды, установите переменную окружения [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ru/env-vars#variables) в `1`. При этом вы также теряете фоновые субагенты, фоновые форкнутые скиллы и `Ctrl+B`. Запуск в [режиме bare](https://code.claude.com/docs/ru/headless.md#start-faster-with-bare-mode) даёт тот же эффект.335Чтобы отключить фоновые команды, установите переменную окружения [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ru/env-vars#variables) в `1`. При этом вы также теряете сочетание клавиш `Ctrl+B` и [другие фоновые возможности](https://code.claude.com/docs/ru/env-vars.md#variables), например [запуск скиллов в фоне](https://code.claude.com/docs/ru/skills.md#run-skills-in-a-subagent). Запуск в [режиме bare](https://code.claude.com/docs/ru/headless.md#start-faster-with-bare-mode) даёт тот же эффект.

336 336 

337**Часто используемые фоновые команды:**337**Часто используемые фоновые команды:**

338 338 


738 738 

739```text theme={null}739```text theme={null}

740Usage limit reached · limit resets 3:45pm740Usage limit reached · limit resets 3:45pm

741Continuing automatically at 3:45pm · esc to cancel741Continuing automatically at 3:45pm · Esc to cancel

742```742```

743 743 

744После этих слов любая из строк может содержать дополнительный текст, например ссылку на справку в первой строке или `/usage-credits to continue now` во второй. Когда ожидание начинается само, в диалоге это также фиксируется строкой `Usage limit reached · continuing automatically at 3:45pm · esc to cancel`.744После этих слов любая из строк может содержать дополнительный текст, например ссылку на справку в первой строке или `/usage-credits to continue now` во второй. Когда ожидание начинается само, в диалоге это также фиксируется строкой `Usage limit reached · continuing automatically at 3:45pm · esc to cancel`.

745 745 

746Держите сессию открытой. Что произойдёт дальше, зависит от того, как закончится ожидание:746Держите сессию открытой. Что произойдёт дальше, зависит от того, как закончится ожидание:

747 747 

748* **При сбросе**: вторая строка меняется на `Continuing shortly · esc to cancel`. Затем в диалоге появляется `Usage limit reset · continuing automatically`, и Claude Code отправляет Claude промпт продолжить задачу там, где она остановилась. Он не переотправляет ваше последнее сообщение.748* **При сбросе**: вторая строка меняется на `Continuing shortly · Esc to cancel`. Затем в диалоге появляется `Usage limit reset · Continuing automatically`, и Claude Code отправляет Claude промпт продолжить задачу там, где она остановилась. Он не переотправляет ваше последнее сообщение.

749* **После сна вашего компьютера**: если он спал более чем примерно 30 минут и лимит сбросился во время сна, первая строка читается как `Your usage limit has reset`, а вторая — `Press enter to continue`. Нажмите `Enter` для продолжения. После более короткого сна или сна, закончившегося до сброса, Claude Code продолжает самостоятельно.749* **После сна вашего компьютера**: если он спал более чем примерно 30 минут и лимит сбросился во время сна, первая строка читается как `Your usage limit has reset`, а вторая — `Press enter to continue`. Нажмите `Enter` для продолжения. После более короткого сна или сна, закончившегося до сброса, Claude Code продолжает самостоятельно.

750* **Раньше**: когда вы закончите добавлять [кредиты использования](https://code.claude.com/docs/ru/costs.md#add-usage-credits-to-your-subscription) с помощью `/usage-credits`, снова войдёте в систему после `/upgrade` или переключите модели с помощью `/model` во время ожидания, Claude Code проверяет, доступно ли использование снова, и продолжает немедленно, если оно доступно. Он не проверяет после обновления или покупки, которые вы совершаете в браузере самостоятельно. В разделе [`opusplan`](https://code.claude.com/docs/ru/model-config#opusplan-model-setting) и других параметрах модели, которые запускают режим плана на другой модели, Claude Code ждёт сброса вместо этого.750* **Раньше**: когда вы закончите добавлять [кредиты использования](https://code.claude.com/docs/ru/costs.md#add-usage-credits-to-your-subscription) с помощью `/usage-credits`, снова войдёте в систему после `/upgrade` или переключите модели с помощью `/model` во время ожидания, Claude Code проверяет, доступно ли использование снова, и продолжает немедленно, если оно доступно. Он не проверяет после обновления или покупки, которые вы совершаете в браузере самостоятельно. В разделе [`opusplan`](https://code.claude.com/docs/ru/model-config#opusplan-model-setting) и других параметрах модели, которые запускают режим плана на другой модели, Claude Code ждёт сброса вместо этого.

751 751 

Details

178* [`forceRemoteSettingsRefresh`](https://code.claude.com/docs/ru/server-managed-settings)178* [`forceRemoteSettingsRefresh`](https://code.claude.com/docs/ru/server-managed-settings)

179* `env`, объединённый для каждой переменной из источников администратора: каждая переменная поступает из источника с наивысшим приоритетом, который её определяет, поэтому нижние источники заполняют переменные, которые оставляют неустановленными более высокие. Несколько переменных следуют своим собственным правилам; [Исключения для каждого ключа из управляемых источников](https://code.claude.com/docs/ru/server-managed-settings.md#per-key-exceptions-across-managed-sources) называет каждое. Требует Claude Code v2.1.223 или позже. До v2.1.223 Claude Code применял только весь блок `env` выбранного источника179* `env`, объединённый для каждой переменной из источников администратора: каждая переменная поступает из источника с наивысшим приоритетом, который её определяет, поэтому нижние источники заполняют переменные, которые оставляют неустановленными более высокие. Несколько переменных следуют своим собственным правилам; [Исключения для каждого ключа из управляемых источников](https://code.claude.com/docs/ru/server-managed-settings.md#per-key-exceptions-across-managed-sources) называет каждое. Требует Claude Code v2.1.223 или позже. До v2.1.223 Claude Code применял только весь блок `env` выбранного источника

180 180 

181Ключи [входа в шлюз](#choose-a-delivery-mechanism) следуют отдельному правилу. Claude Code никогда не читает их из настроек, управляемых сервером, поэтому пока настройки, управляемые сервером, являются выбранным источником, источник администратора на машине с наивысшим рейтингом, который несёт ключ политики, всё ещё их предоставляет. Значение в источнике администратора, ранжированном ниже этого, или в реестре HKCU, игнорируется.

182 

183[`allowedProviders`](https://code.claude.com/docs/ru/settings-reference#allowedproviders) имеет своё собственное правило: примечание Scope его записи говорит, как список, установленный на машине, объединяется с управляемым сервером. Требует Claude Code v2.1.285 или позже.181[`allowedProviders`](https://code.claude.com/docs/ru/settings-reference#allowedproviders) имеет своё собственное правило: примечание Scope его записи говорит, как список, установленный на машине, объединяется с управляемым сервером. Требует Claude Code v2.1.285 или позже.

184 182 

185Когда источник администратора устанавливает `allowManagedMcpServersOnly` или список `allowedMcpServers` и это значение не является тем, которое действует, `/status` и `claude doctor` называют этот источник и ключ.183Когда источник администратора устанавливает `allowManagedMcpServersOnly` или список `allowedMcpServers` и это значение не является тем, которое действует, `/status` и `claude doctor` называют этот источник и ключ.

186 184 

185#### Какой управляемый источник предоставляет ключи входа

186 

187На машине с политикой MDM или файлом управляемых настроек Claude Code берёт ключи входа из этой политики или файла, даже для ключа, который также задают [удалённые настройки](#how-claude-code-combines-managed-sources). Настройки из консоли администратора claude.ai являются удалёнными настройками, поэтому задавайте ключи входа, такие как [`forceLoginOrgUUID`](https://code.claude.com/docs/ru/settings-reference#forceloginorguuid), в политике MDM или файле.

188 

189Если на машине есть и политика MDM, и файл управляемых настроек, используйте политику MDM. Когда эта политика задаёт любой [ключ политики](#how-claude-code-combines-managed-sources), Claude Code игнорирует ключи входа в файле, [даже при `managedSourcesBehavior: "merge"`](#compose-every-managed-source).

190 

191Ключи входа:

192 

193* `forceLoginOrgUUID` и `forceLoginMethod`, установленный на `"claudeai"` или `"console"`: если политика или файл не задаёт какой-либо из этих ключей, применяется значение из удалённых настроек. Пока не все клиенты работают на v2.1.299 или позже, задавайте эти ключи также в [настройках, управляемых сервером](https://code.claude.com/docs/ru/server-managed-settings.md), на claude.ai

194* [Ключи входа в шлюз](#choose-a-delivery-mechanism): Claude Code не использует значение из удалённых настроек для входа в шлюз

195 

187### Составьте каждый управляемый источник196### Составьте каждый управляемый источник

188 197 

189Чтобы Claude Code применял каждый источник администратора, который доставляет ваша организация, установите [`managedSourcesBehavior`](https://code.claude.com/docs/ru/settings-reference#managedsourcesbehavior) на `"merge"` в источнике с наивысшим рейтингом, который вы развёртываете. Claude Code читает ключ только из источника с наивысшим рейтингом, который несёт либо ключ, либо ключ политики, поэтому нижний источник не может выбрать себя для объединения с источником выше него, и машина, которая никогда не получает настройки, управляемые сервером, нуждается в ключе в своём профиле MDM тоже. Доступный для записи пользователем реестр HKCU никогда не объединяется с другим источником. Требует Claude Code v2.1.242 или позже.198Чтобы Claude Code применял каждый источник администратора, который доставляет ваша организация, установите [`managedSourcesBehavior`](https://code.claude.com/docs/ru/settings-reference#managedsourcesbehavior) на `"merge"` в источнике с наивысшим рейтингом, который вы развёртываете. Claude Code читает ключ только из источника с наивысшим рейтингом, который несёт либо ключ, либо ключ политики, поэтому нижний источник не может выбрать себя для объединения с источником выше него, и машина, которая никогда не получает настройки, управляемые сервером, нуждается в ключе в своём профиле MDM тоже. Доступный для записи пользователем реестр HKCU никогда не объединяется с другим источником. Требует Claude Code v2.1.242 или позже.


199| Ограничивающие списки разрешённых значений | Берёт список целиком из источника с наивысшим рейтингом, который его устанавливает, без добавления записей из нижних источников | `availableModels`, `allowedMcpServers`, `strictKnownMarketplaces`, `allowedChannelPlugins` и цепь `fallbackModel` |208| Ограничивающие списки разрешённых значений | Берёт список целиком из источника с наивысшим рейтингом, который его устанавливает, без добавления записей из нижних источников | `availableModels`, `allowedMcpServers`, `strictKnownMarketplaces`, `allowedChannelPlugins` и цепь `fallbackModel` |

200| Значения, взятые целиком | Берёт значение целиком из источника с наивысшим рейтингом, который его устанавливает, без объединения записей или полей из нижних источников | `sandbox.credentials.awsPairs`, `sandbox.ripgrep` |209| Значения, взятые целиком | Берёт значение целиком из источника с наивысшим рейтингом, который его устанавливает, без объединения записей или полей из нижних источников | `sandbox.credentials.awsPairs`, `sandbox.ripgrep` |

201| Предоставленные MCP-серверы | Объединяет имена серверов из каждого источника; когда два источника устанавливают одно имя, применяет всю запись источника с более высоким рейтингом | `managedMcpServers` |210| Предоставленные MCP-серверы | Объединяет имена серверов из каждого источника; когда два источника устанавливают одно имя, применяет всю запись источника с более высоким рейтингом | `managedMcpServers` |

202| Ключи, читаемые только из источника с наивысшим рейтингом | Игнорирует ключ в каждом нижнем источнике, даже когда источник с наивысшим рейтингом оставляет его неустановленным | Помощники учётных данных, такие как `apiKeyHelper`, пины входа, такие как `forceLoginOrgUUID`, `modelPicker`, `permissions.defaultMode` |211| Ключи, читаемые только из источника с наивысшим рейтингом | Игнорирует ключ в каждом нижнем источнике, даже когда источник с наивысшим рейтингом оставляет его неустановленным | `modelPicker`, `permissions.defaultMode` и помощники учётных данных, такие как `apiKeyHelper` |

203| `env` | Объединяет для каждой переменной из источников администратора при любом параметре, как описано в [Ключи, читаемые из каждого источника администратора](#keys-read-from-every-admin-source) | |212| `env` | Объединяет для каждой переменной из источников администратора при любом параметре, как описано в [Ключи, читаемые из каждого источника администратора](#keys-read-from-every-admin-source) | |

213| Ключи входа | При любом параметре берёт их из политики MDM или файла управляемых настроек — из того, который имеет более высокий рейтинг и несёт [ключ политики](#how-claude-code-combines-managed-sources), [с приоритетом над удалёнными настройками](#which-managed-source-supplies-login-keys) | `forceLoginOrgUUID`, `forceLoginMethod` и [ключи входа в шлюз](#choose-a-delivery-mechanism) |

204| Каждый другой ключ | Берёт значение из источника с наивысшим рейтингом, который его устанавливает | `model`, `cleanupPeriodDays` |214| Каждый другой ключ | Берёт значение из источника с наивысшим рейтингом, который его устанавливает | `model`, `cleanupPeriodDays` |

205 215 

206Чтобы подтвердить, какие источники объединились на машине, [прочитайте строку `Setting sources` в `/status`](#read-the-source-in-/status); этот раздел говорит, что означает каждая метка.216Чтобы подтвердить, какие источники объединились на машине, [прочитайте строку `Setting sources` в `/status`](#read-the-source-in-/status); этот раздел говорит, что означает каждая метка.


228Claude Code также применяет эти проверки к значениям, предоставленным родителем, самостоятельно:238Claude Code также применяет эти проверки к значениям, предоставленным родителем, самостоятельно:

229 239 

230* Когда любой источник администратора устанавливает `allowManagedPermissionRulesOnly`, Claude Code удаляет [предоставленные родителем](https://code.claude.com/docs/ru/claude-apps-gateway#restrict-parent-settings) разрешающие правила и `additionalDirectories` по мере их чтения, даже когда источник с более высоким приоритетом оставляет ключ неустановленным. Эффект ключа на ваши собственные правила разрешений исходит из управляемых настроек, которые применяет Claude Code, или из родительских настроек, которые вы выбрали для объединения240* Когда любой источник администратора устанавливает `allowManagedPermissionRulesOnly`, Claude Code удаляет [предоставленные родителем](https://code.claude.com/docs/ru/claude-apps-gateway#restrict-parent-settings) разрешающие правила и `additionalDirectories` по мере их чтения, даже когда источник с более высоким приоритетом оставляет ключ неустановленным. Эффект ключа на ваши собственные правила разрешений исходит из управляемых настроек, которые применяет Claude Code, или из родительских настроек, которые вы выбрали для объединения

231* Claude Code применяет значение `forceLoginOrgUUID` или `allowedMcpServers` в управляемых настройках, которые он применяет, и блокирует предоставленное родителем. Вне блокировки списка разрешённых MCP-серверов значение в нижнем источнике администратора, который Claude Code не применяет, ни применяется, ни блокирует родителя.241* Claude Code применяет значение `forceLoginOrgUUID` или `allowedMcpServers` в управляемых настройках, которые он применяет, и блокирует предоставленное родителем. Если вы доставляете более одного управляемого источника, см. [какой источник предоставляет `forceLoginOrgUUID`](#which-managed-source-supplies-login-keys).

232 242 

233 На Claude Code v2.1.273 или позже, пока `allowManagedMcpServersOnly` включена, список `allowedMcpServers` из источника администратора с наивысшим рейтингом, который его устанавливает, применяется и блокирует родителя, как [кросс-источниковый ключ](#keys-read-from-every-admin-source). Список родителя применяется только когда ни один источник администратора не устанавливает один. Запись [`managedSourcesBehavior`](https://code.claude.com/docs/ru/settings-reference#managedsourcesbehavior) говорит, какой источник предоставляет каждый ключ при `"merge"`. До v2.1.223 значение в любом источнике администратора блокировало родителя243 На Claude Code v2.1.273 или позже, пока `allowManagedMcpServersOnly` включена, список `allowedMcpServers` из источника администратора с наивысшим рейтингом, который его устанавливает, применяется и блокирует родителя, как [кросс-источниковый ключ](#keys-read-from-every-admin-source). Список родителя применяется только когда ни один источник администратора не устанавливает один. Запись [`managedSourcesBehavior`](https://code.claude.com/docs/ru/settings-reference#managedsourcesbehavior) говорит, какой источник предоставляет каждый ключ при `"merge"`. До v2.1.223 значение в любом источнике администратора блокировало родителя

234* Для `availableModels` Claude Code применяет значение в управляемых настройках, которые он применяет, и блокирует предоставленный родителем список244* Для `availableModels` Claude Code применяет значение в управляемых настройках, которые он применяет, и блокирует предоставленный родителем список

mcp.md +45 −18

Details

242/mcp242/mcp

243```243```

244 244 

245Когда вы удаляете удалённый сервер, Claude Code также удаляет токены OAuth и регистрацию клиента, которые он хранил для этого сервера.245Когда вы удаляете удалённый сервер, Claude Code также удаляет токены OAuth и регистрацию клиента, которые он сохранил для этого сервера. Claude Code не отзывает токены на сервере авторизации, который их выдал. Чтобы отозвать токены там, где сервер авторизации поддерживает отзыв, выполните в оболочке [`claude mcp logout <name>`](#authenticate-from-the-command-line) перед `claude mcp remove <name>`.

246 246 

247#### Статус сервера247#### Статус сервера

248 248 


255* ``⏸ Pending approval (run `claude` to approve)``: сервер с областью действия проекта из `.mcp.json`, который вы ещё не подтвердили. Claude Code показывает его и в `claude mcp list`, и в `claude mcp get <name>`. Запустите `claude` в интерактивном режиме, чтобы просмотреть и подтвердить его.255* ``⏸ Pending approval (run `claude` to approve)``: сервер с областью действия проекта из `.mcp.json`, который вы ещё не подтвердили. Claude Code показывает его и в `claude mcp list`, и в `claude mcp get <name>`. Запустите `claude` в интерактивном режиме, чтобы просмотреть и подтвердить его.

256* `✘ Rejected (see disabledMcpjsonServers in settings)`: сервер из `.mcp.json`, который отклоняет запись [`disabledMcpjsonServers`](https://code.claude.com/docs/ru/settings-reference#disabledmcpjsonservers). Claude Code показывает его только в `claude mcp get <name>`.256* `✘ Rejected (see disabledMcpjsonServers in settings)`: сервер из `.mcp.json`, который отклоняет запись [`disabledMcpjsonServers`](https://code.claude.com/docs/ru/settings-reference#disabledmcpjsonservers). Claude Code показывает его только в `claude mcp get <name>`.

257* `⊘ Disabled for this project (re-enable via /mcp)`: сервер, указанный в списке [`disabledMcpServers`](#disable-a-server-without-removing-it) проекта. Claude Code показывает его и в `claude mcp list`, и в `claude mcp get <name>`. Включите сервер обратно в панели `/mcp`.257* `⊘ Disabled for this project (re-enable via /mcp)`: сервер, указанный в списке [`disabledMcpServers`](#disable-a-server-without-removing-it) проекта. Claude Code показывает его и в `claude mcp list`, и в `claude mcp get <name>`. Включите сервер обратно в панели `/mcp`.

258* `✘ Blocked by enterprise managed policy`: сервер, который отклоняет одна из политик вашей организации. Claude Code показывает его и в `claude mcp list`, и в `claude mcp get <name>`. Сервер, заблокированный списком разрешённых, списком запрещённых или другим ограничением в [управляемой конфигурации MCP](https://code.claude.com/docs/ru/managed-mcp.md#how-restrictions-appear-to-users), скрыт в обеих командах, а не показан с этим статусом. Спросите администратора, какая политика блокирует сервер.

258 259 

259#### Одобрение серверов проекта и доверие к рабочему пространству260#### Одобрение серверов проекта и доверие к рабочему пространству

260 261 


471Чтобы изменить или отключить автоматический перевод в фон:472Чтобы изменить или отключить автоматический перевод в фон:

472 473 

473* Установите переменную окружения [`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`](https://code.claude.com/docs/ru/env-vars) в миллисекундах, чтобы изменить порог, или в `0`, чтобы отключить автоматический перевод в фон. При `0` Claude также [ждёт MCP-задачи](#make-claude-wait-for-the-result-of-an-mcp-task) в интерактивной сессии474* Установите переменную окружения [`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`](https://code.claude.com/docs/ru/env-vars) в миллисекундах, чтобы изменить порог, или в `0`, чтобы отключить автоматический перевод в фон. При `0` Claude также [ждёт MCP-задачи](#make-claude-wait-for-the-result-of-an-mcp-task) в интерактивной сессии

474* Установите [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ru/env-vars) в `1`, что отключает его вместе с фоновыми командами и фоновыми субагентами475* Задайте [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ru/env-vars) равной `1`, чтобы отключить автоматический перевод в фон и [фоновые команды](https://code.claude.com/docs/ru/tools-reference.md#background-commands)

475 476 

476Некоторые вызовы никогда не переводятся в фон:477Некоторые вызовы никогда не переводятся в фон:

477 478 


828 829 

829Claude Code поддерживает подстановку переменных окружения в файлах `.mcp.json`, что позволяет командам совместно использовать конфигурации, сохраняя гибкость для путей, специфичных для конкретной машины, и конфиденциальных значений, таких как API-ключи.830Claude Code поддерживает подстановку переменных окружения в файлах `.mcp.json`, что позволяет командам совместно использовать конфигурации, сохраняя гибкость для путей, специфичных для конкретной машины, и конфиденциальных значений, таких как API-ключи.

830 831 

831#### Поддерживаемый синтаксис832Вы можете ссылаться на переменную окружения в значении `command`, `args`, `env`, `url` или `headers` сервера в одной из двух форм:

832 833 

833* `${VAR}`: подставляет значение переменной окружения `VAR`834* `${VAR}`: подставляет значение переменной окружения `VAR`

834* `${VAR:-default}`: подставляет `VAR`, если она задана, иначе использует `default`835* `${VAR:-default}`: подставляет значение `VAR`, если `VAR` задана, или `default`, если она не задана

835 

836#### Места подстановки

837 

838Переменные окружения могут подставляться в:

839 

840* `command`: путь к исполняемому файлу сервера

841* `args`: аргументы командной строки

842* `env`: переменные окружения, передаваемые серверу

843* `url`: для серверов типа HTTP

844* `headers`: для аутентификации HTTP-сервера

845 836 

846#### Пример с подстановкой переменных837#### Пример с подстановкой переменных

847 838 

839В этой записи сервера URL — это значение `API_BASE_URL`, за которым следует `/mcp`, со значением по умолчанию `https://api.example.com`, а API-ключ берётся из `API_KEY`:

840 

848```json theme={null}841```json theme={null}

849{842{

850 "mcpServers": {843 "mcpServers": {


863 856 

864Если переменная окружения, на которую есть ссылка, не задана и не имеет значения по умолчанию, конфигурация всё равно загружается: Claude Code выводит предупреждение об отсутствующей переменной для этого сервера в выводе `claude mcp list` и использует неподставленный текст `${VAR}` как есть. Задайте переменную или добавьте резервный вариант `:-default`, чтобы сервер запускался с нужным вам значением. В `url` и `headers` удалённого сервера некоторые переменные с учётными данными вместо этого [читаются как пустые](#credential-variables-that-read-as-empty), без предупреждения.857Если переменная окружения, на которую есть ссылка, не задана и не имеет значения по умолчанию, конфигурация всё равно загружается: Claude Code выводит предупреждение об отсутствующей переменной для этого сервера в выводе `claude mcp list` и использует неподставленный текст `${VAR}` как есть. Задайте переменную или добавьте резервный вариант `:-default`, чтобы сервер запускался с нужным вам значением. В `url` и `headers` удалённого сервера некоторые переменные с учётными данными вместо этого [читаются как пустые](#credential-variables-that-read-as-empty), без предупреждения.

865 858 

859#### Переменные, заданные как пустая строка

860 

861Если вы задаёте переменной значение пустой строки, она считается заданной, поэтому ссылка `${VAR:-default}` подставляется как пустая строка, а не как `default`. Для [примера сервера](#example-with-variable-expansion), если вы зададите `API_BASE_URL` пустую строку, его `url` станет `/mcp`, а `claude mcp list` сообщит `'url' is not a valid URL`. Чтобы использовать значение по умолчанию, удалите переменную, а не задавайте ей пустую строку.

862 

866#### Переменные с учётными данными, которые читаются как пустые863#### Переменные с учётными данными, которые читаются как пустые

867 864 

868В `url` и `headers` удалённого сервера Claude Code читает переменные с учётными данными из вашего окружения как пустые, а не подставляет их. Это не позволяет файлу `.mcp.json` проекта или плагину отправить ваши учётные данные Claude Code или облачного провайдера на указанный в них сервер. Если вы напишете `Bearer ${ANTHROPIC_AUTH_TOKEN}`, сервер получит `Bearer ` без учётных данных и отклонит запрос, обычно с кодом `401`. Claude Code сообщит об этом как о неудачном подключении.865В `url` и `headers` удалённого сервера Claude Code читает переменные с учётными данными из вашего окружения как пустые, а не подставляет их. Это не позволяет файлу `.mcp.json` проекта или плагину отправить ваши учётные данные Claude Code или облачного провайдера на указанный в них сервер. Если вы напишете `Bearer ${ANTHROPIC_AUTH_TOKEN}`, сервер получит `Bearer ` без учётных данных и отклонит запрос, обычно с кодом `401`. Claude Code сообщит об этом как о неудачном подключении.


1146 1143 

1147Если этого scope нет в вашем зафиксированном `oauth.scopes`, добавьте его, затем запустите `/mcp` и аутентифицируйте сервер снова. Claude Code запрашивает зафиксированные scope, а не scope, названный сервером, поэтому если вы аутентифицируетесь снова, не добавив его, полученный токен по-прежнему не будет его содержать.1144Если этого scope нет в вашем зафиксированном `oauth.scopes`, добавьте его, затем запустите `/mcp` и аутентифицируйте сервер снова. Claude Code запрашивает зафиксированные scope, а не scope, названный сервером, поэтому если вы аутентифицируетесь снова, не добавив его, полученный токен по-прежнему не будет его содержать.

1148 1145 

1146### Используйте OAuth с сервером за прокси с аутентификацией

1147 

1148Если ваш MCP-сервер использует OAuth за прокси или шлюзом, который проверяет собственный заголовок, вход завершается ошибкой, когда запросы OAuth приходят без этого заголовка. Для входа через прокси требуется Claude Code v2.1.299 или новее, причём должны быть настроены и заголовок, и вход:

1149 

1150* **Заголовок прокси**: передайте его с помощью [`--header`](#option-1-add-a-remote-http-server), поля `headers` или [`headersHelper`](#use-dynamic-headers-for-custom-authentication) под именем, которое читает прокси

1151* **Вход через OAuth**: не включайте `Authorization` в настроенные заголовки, затем войдите с помощью `claude mcp login <name>` в вашей оболочке. Если вы настроите заголовок `Authorization`, Claude Code использует его как учётные данные сервера и не возвращается к OAuth для этого сервера.

1152 

1149### Используйте динамические заголовки для пользовательской аутентификации1153### Используйте динамические заголовки для пользовательской аутентификации

1150 1154 

1151Если ваш MCP-сервер использует схему аутентификации, отличную от OAuth, такую как Kerberos, краткосрочные токены или внутреннее SSO, используйте `headersHelper` для генерации заголовков запроса во время подключения. Claude Code запускает команду и объединяет её вывод с заголовками подключения.1155Когда для аутентификации, такой как Kerberos, краткосрочные токены или внутреннее SSO, нужны заголовки, генерируемые во время подключения, задайте в `headersHelper` сервера команду. Claude Code запускает её при подключении и объединяет её вывод с отправляемыми заголовками. В этом примере используется скрипт:

1152 1156 

1153```json theme={null}1157```json theme={null}

1154{1158{


1552 1556 

1553## Инструменты с недействительными схемами входных данных1557## Инструменты с недействительными схемами входных данных

1554 1558 

1555Claude API проверяет схему входных данных каждого инструмента в запросе и отклоняет весь запрос, когда любая схема не проходит проверку, поэтому один инструмент MCP с неправильной схемой приведет к тому, что каждый запрос, который его включает, завершится ошибкой 400. Claude Code запускает две проверки API самостоятельно при загрузке инструментов сервера и исключает каждый инструмент, который не пройдет их, поэтому другие инструменты сервера продолжают работать:1559> [!NOTE]

1560>

1561> Если ваша сессия завершается ошибкой 400, в которой инструмент указан по его позиции, выполните шаги из раздела [Схема входных данных инструмента недействительна](https://code.claude.com/docs/ru/errors.md#tool-input-schema-is-invalid).

1562 

1563Если у одного из инструментов вашего MCP-сервера схема входных данных нарушает одно из двух правил, которые применяет API, Claude Code исключает этот инструмент. Другие инструменты сервера это не затрагивает. Claude Code проверяет оба правила при загрузке инструментов сервера:

1556 1564 

1557* Имена свойств верхнего уровня должны быть длиной от 1 до 64 символов и использовать только буквы и цифры ASCII, `_`, `.` и `-`1565* Имена свойств верхнего уровня должны быть длиной от 1 до 64 символов и использовать только буквы и цифры ASCII, `_`, `.` и `-`

1558* Схема должна быть действительной в соответствии с метасхемой JSON Schema draft 2020-12. Claude Code применяет эту проверку к схемам, которые не объявляют `$schema`, и к схемам, которые объявляют draft 2020-12. Схема, которая объявляет любой другой диалект, пропускает эту проверку, хотя проверка имен свойств выше все еще применяется1566* Схема должна быть действительной в соответствии с метасхемой JSON Schema draft 2020-12. Claude Code применяет эту проверку к схемам, которые не объявляют `$schema`, и к схемам, которые объявляют draft 2020-12. Схема, которая объявляет любой другой диалект, пропускает эту проверку, хотя проверка имен свойств выше все еще применяется

1559 1567 

1560Когда Claude Code исключает инструмент, он записывает причину в журнал сервера и сообщает Claude, какие инструменты он исключил и почему, чтобы вы могли спросить Claude, почему инструмент отсутствует. Если вы исправите схему на сервере, инструмент вернется в следующий раз, когда Claude Code загрузит инструменты сервера.1568Когда Claude Code исключает инструмент, он записывает причину в журнал сервера и сообщает Claude, какие инструменты он исключил и почему, чтобы вы могли спросить Claude, почему инструмент отсутствует. Если вы исправите схему на сервере, инструмент вернется в следующий раз, когда Claude Code загрузит инструменты сервера.

1561 1569 

1562Claude Code включает исключение через флаг функции, который он получает от Anthropic. На [развертывании, где получение флагов отключено](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), или на машине, флаги которой никогда не поступали, например на изолированной машине, Claude Code все еще запускает проверки и записывает в журнал сервера, какой инструмент будет отклонен, но отправляет схему инструмента в API в любом случае. API отклоняет запрос, который включает эту схему с [ошибкой 400, называющей инструмент по его позиции](https://code.claude.com/docs/ru/errors.md#tool-input-schema-is-invalid). До версии 2.1.216 ни одно развертывание не запускало эти проверки.1570Когда [получение флагов функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching) отключено или флаги так и не поступили, например на изолированной машине, инструмент, нарушающий правило, не исключается:

1571 

1572* Claude получает инструмент без изменений, а в лог сервера для него записывается `input schema would be rejected by the Anthropic API`

1573* Если затем API отклонит схему, см. раздел [Инструменты, схему входных данных которых отклоняет API](#tools-whose-input-schema-the-api-refuses)

1574 

1575До версии 2.1.216 ни одно развёртывание не запускало эти проверки.

1563 1576 

1564[Обработка комбинатора корневого уровня](#tool-input-schemas-with-a-root-level-combinator) отделена и сохраняет свое собственное поведение, когда получение флагов отключено или флаги никогда не поступали.1577[Обработка комбинатора корневого уровня](#tool-input-schemas-with-a-root-level-combinator) отделена и сохраняет свое собственное поведение, когда получение флагов отключено или флаги никогда не поступали.

1565 1578 

1579### Инструменты, схему входных данных которых отклоняет API

1580 

1581Если строка в отладочном логе содержит `the API refused this tool's input schema`, в ней указан инструмент, схему которого API отклонил в запросе. Claude Code повторно отправляет этот запрос, объявив инструмент без параметров.

1582 

1583* **Если ваша сессия завершается ошибкой 400, в которой инструмент указан по его позиции**: выполните шаги из раздела [Схема входных данных инструмента недействительна](https://code.claude.com/docs/ru/errors.md#tool-input-schema-is-invalid)

1584* **Если вы используете сервер**: вам ничего не нужно делать. Claude по-прежнему может вызывать инструмент, но не видит его параметров

1585* **Если вы поддерживаете сервер**: исправьте схему входных данных инструмента на сервере. Строка лога заканчивается на `The API said:` и причиной, по которой API отклонил схему. Проверяйте аргументы, которые получает сервер, поскольку Claude вызывает инструмент, не видя его параметров

1586 

1587До версии 2.1.300 каждый ход, включавший отклонённую схему, завершался [ошибкой 400, в которой инструмент указан по его позиции](https://code.claude.com/docs/ru/errors.md#tool-input-schema-is-invalid).

1588 

1566## Инструменты с именами длиннее 128 символов1589## Инструменты с именами длиннее 128 символов

1567 1590 

1568Если `/mcp` показывает инструмент, который Claude не может вызвать, проверьте, не превышает ли полное имя инструмента 128 символов. Выполните `/mcp` в своей сессии и выберите инструмент, чтобы увидеть его полное имя, например `mcp__<server>__<tool>`. Claude Code не включает инструмент MCP в список инструментов, отправляемых Claude, если его полное имя длиннее 128 символов. Claude API отклоняет запрос, содержащий такой инструмент, поэтому исключение этого инструмента позволяет остальным инструментам сервера продолжать работать.1591Если `/mcp` показывает инструмент, который Claude не может вызвать, проверьте, не превышает ли полное имя инструмента 128 символов. Выполните `/mcp` в своей сессии и выберите инструмент, чтобы увидеть его полное имя, например `mcp__<server>__<tool>`. Claude Code не включает инструмент MCP в список инструментов, отправляемых Claude, если его полное имя длиннее 128 символов. Claude API отклоняет запрос, содержащий такой инструмент, поэтому исключение этого инструмента позволяет остальным инструментам сервера продолжать работать.


1709 1732 

1710До v2.1.296 более короткий лимит составлял 2 048 символов, а до v2.1.295 он применялся к описанию каждого инструмента, включая загружаемые через поиск инструментов.1733До v2.1.296 более короткий лимит составлял 2 048 символов, а до v2.1.295 он применялся к описанию каждого инструмента, включая загружаемые через поиск инструментов.

1711 1734 

1712Описания и инструкции некоторых серверов MCP, которые Anthropic размещает на `api.anthropic.com`, доходят до Claude полностью. Чтобы изменить лимиты для остальных серверов MCP в вашей сессии, установите [`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`](https://code.claude.com/docs/ru/env-vars#variables) на количество символов. Заданное число заменяет оба лимита: например, `8192` повышает более короткий лимит и понижает более длинный. Эта переменная требует Claude Code v2.1.280 или позже.1735#### Изменение лимитов длины описаний

1736 

1737Чтобы изменить [лимиты по умолчанию](#for-mcp-server-authors) в 4 096 и 16 384 символа для серверов MCP в вашей сессии, установите [`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`](https://code.claude.com/docs/ru/env-vars#variables) на количество символов. Claude Code использует это число для обоих лимитов. Например, со значением `8192` вы повышаете лимит в 4 096 символов для инструкций сервера и описаний инструментов, загружаемых заранее, и понижаете лимит в 16 384 символа для описаний инструментов, загружаемых через поиск инструментов. Эта переменная требует Claude Code v2.1.280 или позже.

1738 

1739Описания и инструкции некоторых серверов MCP, которые Anthropic размещает на `api.anthropic.com`, доходят до Claude полностью, и установка этой переменной их не обрезает.

1713 1740 

1714#### Пометка инструмента для загрузки заранее или отложенной загрузки1741#### Пометка инструмента для загрузки заранее или отложенной загрузки

1715 1742 

Details

65| `✘ Connection error` | Попытка соединения выдала ошибку. См. [Troubleshooting](#troubleshooting) |65| `✘ Connection error` | Попытка соединения выдала ошибку. См. [Troubleshooting](#troubleshooting) |

66| ``⏸ Pending approval (run `claude` to approve)`` | Сервер в области проекта, который вы ещё не одобрили. См. [Редактирование .mcp.json напрямую](#edit-mcp-json-directly) |66| ``⏸ Pending approval (run `claude` to approve)`` | Сервер в области проекта, который вы ещё не одобрили. См. [Редактирование .mcp.json напрямую](#edit-mcp-json-directly) |

67| `⊘ Disabled for this project (re-enable via /mcp)` | Сервер отключён для этого проекта списком `disabledMcpServers` проекта. См. [Отключение сервера без его удаления](https://code.claude.com/docs/ru/mcp.md#disable-a-server-without-removing-it) |67| `⊘ Disabled for this project (re-enable via /mcp)` | Сервер отключён для этого проекта списком `disabledMcpServers` проекта. См. [Отключение сервера без его удаления](https://code.claude.com/docs/ru/mcp.md#disable-a-server-without-removing-it) |

68| `✘ Blocked by enterprise managed policy` | Одна из политик вашей организации блокирует этот сервер, поэтому Claude Code не будет к нему подключаться. Уточните у администратора, какая именно политика. См. [Статус сервера](https://code.claude.com/docs/ru/mcp.md#server-status) |

68 69 

69Некоторые устаревшие консоли Windows, такие как консоль по умолчанию на Windows 10, не поддерживают эти глифы Unicode и показывают `√` и `×` вместо `✔` и `✘`.70Некоторые устаревшие консоли Windows, такие как консоль по умолчанию на Windows 10, не поддерживают эти глифы Unicode и показывают `√` и `×` вместо `✔` и `✘`.

70 71 

model-config.md +20 −3

Details

689* **`/effort`**: выполните `/effort` без аргументов, чтобы открыть интерактивный ползунок, `/effort` с именем уровня, чтобы задать его напрямую, или `/effort auto`, чтобы сбросить сохранённый уровень для активной модели689* **`/effort`**: выполните `/effort` без аргументов, чтобы открыть интерактивный ползунок, `/effort` с именем уровня, чтобы задать его напрямую, или `/effort auto`, чтобы сбросить сохранённый уровень для активной модели

690* **В `/model`**: при выборе модели используйте клавиши со стрелками влево/вправо, чтобы отрегулировать ползунок усилий690* **В `/model`**: при выборе модели используйте клавиши со стрелками влево/вправо, чтобы отрегулировать ползунок усилий

691* **Флаг `--effort`**: передайте имя уровня при запуске Claude Code, чтобы задать его для одной сессии691* **Флаг `--effort`**: передайте имя уровня при запуске Claude Code, чтобы задать его для одной сессии

692* **Переменная окружения**: установите `CLAUDE_CODE_EFFORT_LEVEL` в имя уровня или `auto`692* **Переменная окружения**: установите `CLAUDE_CODE_EFFORT_LEVEL` в имя уровня. Чтобы Claude Code [не отправлял уровень усилий](#send-no-effort-level), установите её вместо этого в `auto` или `unset`

693* **Настройки**: задайте уровень для отдельной модели в [`modelSettings`](https://code.claude.com/docs/ru/settings-reference#modelsettings) или установите [`effortLevel`](https://code.claude.com/docs/ru/settings-reference#effortlevel) в `low`, `medium`, `high` или `xhigh` как уровень по умолчанию для моделей без собственного уровня. `max` не принимается как уровень ни в одном из этих ключей, а у `ultracode` есть собственный ключ [`ultracode`](https://code.claude.com/docs/ru/settings-reference#ultracode)693* **Настройки**: задайте уровень для отдельной модели в [`modelSettings`](https://code.claude.com/docs/ru/settings-reference#modelsettings) или установите [`effortLevel`](https://code.claude.com/docs/ru/settings-reference#effortlevel) в `low`, `medium`, `high` или `xhigh` как уровень по умолчанию для моделей без собственного уровня. `max` не принимается как уровень ни в одном из этих ключей, а у `ultracode` есть собственный ключ [`ultracode`](https://code.claude.com/docs/ru/settings-reference#ultracode)

694* **С подключённого устройства**: в сессии [Remote Control](https://code.claude.com/docs/ru/remote-control.md#what-connected-devices-see) выберите уровень в элементе управления усилиями на телефоне или в браузере. Уровень применяется только к текущей сессии. Требуется Claude Code версии 2.1.234 или позже694* **С подключённого устройства**: в сессии [Remote Control](https://code.claude.com/docs/ru/remote-control.md#what-connected-devices-see) выберите уровень в элементе управления усилиями на телефоне или в браузере. Уровень применяется только к текущей сессии. Требуется Claude Code версии 2.1.234 или позже

695* **Frontmatter скиллов и субагентов**: задайте `effort` в markdown-файле [скилла](https://code.claude.com/docs/ru/skills.md#frontmatter-reference) или [субагента](https://code.claude.com/docs/ru/sub-agents.md#supported-frontmatter-fields), чтобы переопределить уровень усилий при работе этого скилла или субагента695* **Frontmatter скиллов и субагентов**: задайте `effort` в markdown-файле [скилла](https://code.claude.com/docs/ru/skills.md#frontmatter-reference) или [субагента](https://code.claude.com/docs/ru/sub-agents.md#supported-frontmatter-fields), чтобы переопределить уровень усилий при работе этого скилла или субагента


711 711 

712До версии 2.1.242 Claude Code мог сам ставить `/effort` в очередь до завершения хода и всегда делал это в сессии, которая не [получает флаги функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), например у [стороннего поставщика](https://code.claude.com/docs/ru/third-party-integrations.md).712До версии 2.1.242 Claude Code мог сам ставить `/effort` в очередь до завершения хода и всегда делал это в сессии, которая не [получает флаги функций](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching), например у [стороннего поставщика](https://code.claude.com/docs/ru/third-party-integrations.md).

713 713 

714#### Работа без отправки уровня усилий

715 

716Когда Claude Code не отправляет уровень усилий [поддерживаемой модели](#adjust-effort-level), вместо значения по умолчанию Claude Code применяется [значение по умолчанию API](https://platform.claude.com/docs/en/build-with-claude/effort). Чтобы Claude Code не отправлял уровень, запускайте `claude` из оболочки, которая экспортирует `CLAUDE_CODE_EFFORT_LEVEL` со значением `auto` или `unset` — они действуют одинаково:

717 

718```bash theme={null}

719export CLAUDE_CODE_EFFORT_LEVEL=auto

720```

721 

722Пока уровень не отправляется, заголовок и нижняя строка сессии не показывают уровень усилий. Чтобы убедиться, что уровень не отправляется, выполните `/effort status` в промпте Claude Code:

723 

724* **`Effort level: auto`**: уровень усилий не отправляется.

725* **`Effort level: auto (currently <level>)`**: уровень всё ещё отправляется. Если к активной модели применяется настройка [`maxEffortLevel`](https://code.claude.com/docs/ru/settings-reference#maxeffortlevel) ниже `max`, Claude Code отправляет собственное значение по умолчанию для модели, понижённое до этого ограничения. Удалите эту настройку или установите её в `max`.

726 

727> [!NOTE]

728>

729> До версии 2.1.304 `/effort status` выводил `Effort level: auto (currently high)`, даже когда уровень не отправлялся.

730 

714#### Адаптивные рассуждения и фиксированные бюджеты мышления731#### Адаптивные рассуждения и фиксированные бюджеты мышления

715 732 

716Адаптивные рассуждения делают мышление необязательным на каждом шаге, поэтому Claude может быстрее отвечать на рутинные промпты и приберегать более глубокое мышление для шагов, которым оно полезно. Если вы хотите, чтобы Claude думал чаще или реже, чем при текущем уровне, можно сказать об этом прямо в промпте или в `CLAUDE.md`; модель учитывает такие указания в рамках своей настройки усилий.733Адаптивные рассуждения делают мышление необязательным на каждом шаге, поэтому Claude может быстрее отвечать на рутинные промпты и приберегать более глубокое мышление для шагов, которым оно полезно. Если вы хотите, чтобы Claude думал чаще или реже, чем при текущем уровне, можно сказать об этом прямо в промпте или в `CLAUDE.md`; модель учитывает такие указания в рамках своей настройки усилий.


781 798 

782Запрос к Haiku 5.5 стоит дороже за токен, если его промпт длиннее 100K токенов. Обе ставки см. в разделе [цены Anthropic](https://platform.claude.com/docs/en/about-claude/pricing).799Запрос к Haiku 5.5 стоит дороже за токен, если его промпт длиннее 100K токенов. Обе ставки см. в разделе [цены Anthropic](https://platform.claude.com/docs/en/about-claude/pricing).

783 800 

784По умолчанию сессии автоматически сжимаются примерно на 967K токенов. Чтобы сжатие происходило раньше, [задайте для модели меньшее окно автосжатия](#set-the-auto-compact-window).801По умолчанию сессии автоматически сжимаются при достижении примерно 967K токенов. Чтобы сжатие происходило раньше, [задайте для модели меньшее окно автосжатия](#set-the-auto-compact-window).

785 802 

786## Контекстное окно и автосжатие803## Контекстное окно и автосжатие

787 804 


830* [Облачные сессии](https://code.claude.com/docs/ru/claude-code-on-the-web.md) выполняют сжатие контекста по мере приближения диалога к пределу модели847* [Облачные сессии](https://code.claude.com/docs/ru/claude-code-on-the-web.md) выполняют сжатие контекста по мере приближения диалога к пределу модели

831* Sonnet 4.6 и Opus 4.6 без [расширенного контекста](#extended-context) выполняют сжатие контекста на границе 200K848* Sonnet 4.6 и Opus 4.6 без [расширенного контекста](#extended-context) выполняют сжатие контекста на границе 200K

832* Когда вы задаёте [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](https://code.claude.com/docs/ru/env-vars), модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют сжатие контекста на границе 200K849* Когда вы задаёте [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](https://code.claude.com/docs/ru/env-vars), модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют сжатие контекста на границе 200K

833* Модели, работающие с собственным окном 1M, выполняют сжатие контекста до заполнения окна, по умолчанию примерно на 967K токенов. К ним относятся модели Fable, Sonnet 5 и более поздние версии, Haiku 5.5, а также Opus 4.7 и более поздние версии. При использовании пользовательского `ANTHROPIC_BASE_URL` см. раздел [контекстное окно за шлюзом](#context-window-behind-a-gateway)850* Модели, работающие с собственным окном 1M, выполняют сжатие контекста до заполнения окна, по умолчанию при достижении примерно 967K токенов. К ним относятся модели Fable, Sonnet 5 и более поздние версии, Haiku 5.5, а также Opus 4.7 и более поздние версии. При использовании пользовательского `ANTHROPIC_BASE_URL` см. раздел [контекстное окно за шлюзом](#context-window-behind-a-gateway)

834* Сессии с ID модели, который Claude Code не распознаёт, например псевдонимом [LLM-шлюза](https://code.claude.com/docs/ru/llm-gateway), выполняют сжатие контекста при контекстном окне, которое Claude Code предполагает для этого ID; см. [Исправление окна для шлюза или пользовательского ID модели](#correct-the-window-for-a-gateway-or-custom-model-id)851* Сессии с ID модели, который Claude Code не распознаёт, например псевдонимом [LLM-шлюза](https://code.claude.com/docs/ru/llm-gateway), выполняют сжатие контекста при контекстном окне, которое Claude Code предполагает для этого ID; см. [Исправление окна для шлюза или пользовательского ID модели](#correct-the-window-for-a-gateway-or-custom-model-id)

835 852 

836О том, когда Claude Code также выполняет сжатие контекста диалога, оставленного без активности, см. настройку [`idleCompaction`](https://code.claude.com/docs/ru/settings-reference#idlecompaction).853О том, когда Claude Code также выполняет сжатие контекста диалога, оставленного без активности, см. настройку [`idleCompaction`](https://code.claude.com/docs/ru/settings-reference#idlecompaction).

Details

861* `output_tokens`: Количество выходных токенов861* `output_tokens`: Количество выходных токенов

862* `cache_read_tokens`: Количество токенов, прочитанных из кэша862* `cache_read_tokens`: Количество токенов, прочитанных из кэша

863* `cache_creation_tokens`: Количество токенов, использованных для создания кэша863* `cache_creation_tokens`: Количество токенов, использованных для создания кэша

864* `cache_creation_5m_tokens`, `cache_creation_1h_tokens`: количество токенов, которые, согласно ответу API, были записаны в кэш с пятиминутным [временем жизни кэша](https://code.claude.com/docs/ru/prompt-caching.md#cache-lifetime), и количество записанных с часовым временем жизни. Оба равны `0`, если ответ API их не сообщает, даже когда `cache_creation_tokens` больше нуля. Требуется Claude Code v2.1.300 или новее

864* `request_id`: ID API-запроса, например `"req_011..."`, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes).865* `request_id`: ID API-запроса, например `"req_011..."`, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes).

865* `client_request_id`: Сгенерированный клиентом UUID, отправляемый в заголовке запроса `x-client-request-id`; когда он присутствует, см. в таблице [атрибутов корреляции событий](#event-correlation-attributes)866* `client_request_id`: Сгенерированный клиентом UUID, отправляемый в заголовке запроса `x-client-request-id`; когда он присутствует, см. в таблице [атрибутов корреляции событий](#event-correlation-attributes)

866* `speed`: `"fast"` или `"normal"`, указывает, был ли активен быстрый режим867* `speed`: `"fast"` или `"normal"`, указывает, был ли активен быстрый режим

Details

287claude --permission-mode acceptEdits287claude --permission-mode acceptEdits

288```288```

289 289 

290## Анализируйте перед редактированием с режимом plan290## Анализ перед редактированием в режиме планирования

291 291 

292Режим Plan указывает Claude исследовать и предложить изменения без их внесения. Claude читает файлы, запускает команды оболочки для исследования и пишет план, но не редактирует ваш исходный код. За исключением интерактивных сеансов терминала с [доступными разрешениями на обход](#skip-all-checks-with-bypasspermissions-mode), редактирования остаются заблокированными до тех пор, пока вы не одобрите план.292Режим планирования указывает Claude исследовать код и предлагать изменения, не внося их. Claude читает файлы, выполняет shell-команды для изучения и составляет план, но не редактирует ваш исходный код. За исключением интерактивных сессий в терминале, где [доступен обход разрешений](#skip-all-checks-with-bypasspermissions-mode), редактирование остаётся заблокированным, пока вы не утвердите план.

293 293 

294Что происходит с командой оболочки во время планирования, зависит от сеанса, и применяется первый из этих случаев, который совпадает:294Что происходит с shell-командой во время планирования, зависит от сессии; применяется первый подходящий из следующих случаев:

295 295 

296* **Интерактивные сеансы терминала с доступными разрешениями на обход**: ни классификатор, ни запрос не применяются к командам планирования. [Пропустить все проверки с режимом bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) охватывает несколько вещей, которые по-прежнему требуют запроса там.296* **Интерактивные сессии в терминале с доступным обходом разрешений**: к командам планирования не применяются ни классификатор, ни запрос разрешения. В разделе [Пропуск всех проверок с режимом bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) описаны немногие случаи, когда запрос там всё же появляется.

297* **[Режим auto](https://code.claude.com/docs/ru/auto-mode-config.md) доступен и параметр `useAutoModeDuringPlan` включен**, что является значением по умолчанию: классификатор проверяет команды оболочки, отличные от [критических удалений пути](#critical-paths), вместо запроса у вас. Одобренные команды выполняются, и отклонённые блокируются.297* **[Авторежим](https://code.claude.com/docs/ru/auto-mode-config.md) доступен и настройка `useAutoModeDuringPlan` включена**, что задано по умолчанию: классификатор проверяет shell-команды, кроме [удалений критических путей](#critical-paths), вместо того чтобы запрашивать у вас разрешение. Одобренные команды выполняются, а отклонённые блокируются.

298* **Режим auto недоступен или `useAutoModeDuringPlan` отключен**: команды вне [встроенного набора только для чтения](https://code.claude.com/docs/ru/permissions.md#read-only-commands) требуют одобрения, включая когда [режим auto-allow](https://code.claude.com/docs/ru/sandboxing.md#sandbox-modes) песочницы включен.298* **Авторежим недоступен или `useAutoModeDuringPlan` выключена**: команды вне [встроенного набора команд только для чтения](https://code.claude.com/docs/ru/permissions.md#read-only-commands) запрашивают подтверждение, в том числе когда включён [режим автоматического разрешения](https://code.claude.com/docs/ru/sandboxing.md#sandbox-modes) песочницы.

299 299 

300Войдите в режим plan, нажав `Shift+Tab` или добавив префикс к одной подсказке с `/plan`. Вы также можете запустить в режиме plan из CLI:300Войдите в режим планирования, нажав `Shift+Tab` или добавив `/plan` в начало отдельного промпта. Вы также можете запустить сессию в режиме планирования из CLI:

301 301 

302```bash theme={null}302```bash theme={null}

303claude --permission-mode plan303claude --permission-mode plan

304```304```

305 305 

306Нажмите `Shift+Tab` снова, чтобы выйти из режима plan без одобрения плана.306Нажмите `Shift+Tab` ещё раз, чтобы выйти из режима планирования, не утверждая план.

307 307 

308### Проверьте и одобрите план308### Просмотр и утверждение плана

309 309 

310Когда план готов, Claude представляет его и спрашивает, как действовать дальше. Из этого запроса вы можете выбрать:310Когда план готов, Claude показывает его и спрашивает, как продолжить. В этом запросе вы можете выбрать:

311 311 

312* **Да, и использовать режим auto**: одобрить и запустить в [режиме auto](#eliminate-prompts-with-auto-mode). Если режим auto недоступен [для вашего сеанса](#eliminate-prompts-with-auto-mode), например потому что ваша организация его отключила, эта опция читается как **Да, автоматически принять редактирование**. Если вы запустили сеанс с включёнными разрешениями на обход, опция читается как **Да, и переключиться на BYPASS PERMISSIONS (без дальнейших запросов) для этого сеанса** вместо этого.312* **Yes, and use auto mode**: утвердить план и начать работу в [авторежиме](#eliminate-prompts-with-auto-mode). Если авторежим [недоступен в вашей сессии](#eliminate-prompts-with-auto-mode), например потому что ваша организация его отключила, этот вариант называется **Yes, auto-accept edits**. Если вы запустили сессию с включённым обходом разрешений, вариант вместо этого называется **Yes, and switch to BYPASS PERMISSIONS (no further prompts) for this session**.

313* **Да, вручную одобрить редактирование**: одобрить и проверить каждое редактирование отдельно.313* **Yes, manually approve edits**: утвердить план и проверять каждое изменение по отдельности.

314* **Нет, продолжить планирование**: остаться в режиме plan и сказать Claude, что изменить.314* **No, keep planning**: остаться в режиме планирования и сообщить Claude, что изменить.

315 315 

316Одобрение плана выходит из режима plan и переключает сеанс на режим разрешений, который описывает каждая опция одобрения, поэтому Claude начинает редактирование. Чтобы снова планировать, вернитесь в режим plan с помощью `Shift+Tab` или добавьте префикс к следующей подсказке с `/plan`.316Утверждение плана завершает режим планирования и переключает сессию в режим разрешений, описанный в соответствующем варианте утверждения, после чего Claude начинает редактирование. Чтобы снова перейти к планированию, вернитесь в режим планирования с помощью `Shift+Tab` или добавьте `/plan` в начало следующего промпта.

317 317 

318Нажмите `Ctrl+G`, чтобы открыть предложенный план в текстовом редакторе по умолчанию и отредактировать его непосредственно перед тем, как Claude продолжит. Когда включена опция [`showClearContextOnPlanAccept`](https://code.claude.com/docs/ru/settings-reference#showclearcontextonplanaccept), список получает первую опцию, которая одобряет план и очищает контекст планирования.318Нажмите `Ctrl+G`, чтобы открыть предложенный план в текстовом редакторе по умолчанию и отредактировать его напрямую, прежде чем Claude продолжит. Когда включена настройка [`showClearContextOnPlanAccept`](https://code.claude.com/docs/ru/settings-reference#showclearcontextonplanaccept), в списке появляется первый вариант, который утверждает план и очищает контекст планирования.

319 319 

320Принятие плана также даёт сеансу [сгенерированное название](https://code.claude.com/docs/ru/sessions.md#name-your-sessions) на основе плана, если вы уже не назвали сеанс.320Принятие плана также присваивает сессии [сгенерированное название](https://code.claude.com/docs/ru/sessions.md#name-your-sessions) на основе плана, если вы ещё не назвали сессию.

321 321 

322### Установите режим plan как значение по умолчанию322### Установка режима планирования по умолчанию

323 323 

324Чтобы сделать режим plan значением по умолчанию для сеансов терминала проекта, установите `defaultMode` на `plan` в `.claude/settings.json`, размещённый как пример в [Начните в другом режиме разрешений](#start-in-a-different-mode) показывает. Разговоры, которые [расширение VS Code](https://code.claude.com/docs/ru/vs-code.md) запускает, не читают параметры проекта для начального режима разрешений. Там установите `claudeCode.initialPermissionMode` на `plan` в параметрах пользователя VS Code вместо этого.324Чтобы сделать режим планирования режимом по умолчанию для сессий проекта в терминале, задайте для `defaultMode` значение `plan` в `.claude/settings.json`, разместив его так, как показано в примере в разделе [Запуск в другом режиме разрешений](#start-in-a-different-mode). Диалоги, которые запускает [расширение VS Code](https://code.claude.com/docs/ru/vs-code.md), не считывают начальный режим разрешений из настроек проекта. В этом случае задайте для `claudeCode.initialPermissionMode` значение `plan` в пользовательских настройках VS Code.

325 325 

326## Исключите запросы разрешений с помощью авторежима326## Исключите запросы разрешений с помощью авторежима

327 327 

Details

4 4 

5# Маркетплейсы Anthropic5# Маркетплейсы Anthropic

6 6 

7> Официальный, общественный и демонстрационный маркетплейсы плагинов Anthropic для Claude Code: их названия, репозитории, способы добавления каждого и где просматривать их плагины.7> Официальный и общественный маркетплейсы плагинов Anthropic для Claude Code: их названия, репозитории, способы добавления каждого и где просматривать их плагины.

8 8 

9Anthropic публикует три маркетплейса плагинов общего назначения для Claude Code: [официальный](https://github.com/anthropics/claude-plugins-official), [общественный](https://github.com/anthropics/claude-plugins-community) и [демонстрационный](https://github.com/anthropics/claude-code). Каждый из них представляет собой каталог плагинов в собственном репозитории GitHub. Когда вы устанавливаете плагин из одного из них в сессии Claude Code, вы вводите название маркетплейса после `@`, например `/plugin install commit-commands@claude-plugins-official`.9Anthropic публикует два маркетплейса плагинов общего назначения для Claude Code: [официальный](https://github.com/anthropics/claude-plugins-official) и [общественный](https://github.com/anthropics/claude-plugins-community). Каждый из них представляет собой каталог плагинов в собственном репозитории GitHub. Когда вы устанавливаете плагин из одного из них в сессии Claude Code, вы вводите название маркетплейса после `@`, например `/plugin install commit-commands@claude-plugins-official`.

10 10 

11Используйте эту страницу, чтобы различать три маркетплейса и узнать, где проверить, есть ли нужный плагин в официальном маркетплейсе.11Используйте эту страницу, чтобы различать два маркетплейса и узнать, где проверить, есть ли нужный плагин в официальном маркетплейсе.

12 12 

13> [!NOTE]13> [!NOTE]

14>14>


19 19 

20Перейдите к нужной части страницы:20Перейдите к нужной части страницы:

21 21 

22* Чтобы различать три маркетплейса по репозиторию, названию маркетплейса и способу получения каждого, см. [Маркетплейсы Anthropic](#anthropic’s-marketplaces).22* Чтобы различать два маркетплейса по репозиторию, названию маркетплейса и способу получения каждого, см. [Маркетплейсы Anthropic](#anthropic’s-marketplaces).

23* Чтобы найти плагин в официальном маркетплейсе, см. [Поиск плагинов в официальном маркетплейсе](#find-plugins-in-the-official-marketplace).23* Чтобы найти плагин в официальном маркетплейсе, см. [Поиск плагинов в официальном маркетплейсе](#find-plugins-in-the-official-marketplace).

24 24 

25## Маркетплейсы Anthropic25## Маркетплейсы Anthropic

26 26 

27Маркетплейс — это каталог плагинов, который репозиторий определяет в своём файле `.claude-plugin/marketplace.json`. Официальный, общественный и демонстрационный маркетплейсы берутся каждый из своего репозитория GitHub. Anthropic также публикует тематические маркетплейсы, такие как `anthropics/skills` и `anthropics/knowledge-work-plugins`, которые вы добавляете в сессии Claude Code с помощью `/plugin marketplace add <owner>/<repo>`.27Маркетплейс — это каталог плагинов, который репозиторий определяет в своём файле `.claude-plugin/marketplace.json`. Официальный и общественный маркетплейсы берутся каждый из своего репозитория GitHub. Anthropic также публикует тематические маркетплейсы, такие как `anthropics/skills` и `anthropics/knowledge-work-plugins`, которые вы добавляете в сессии Claude Code с помощью `/plugin marketplace add <owner>/<repo>`.

28 28 

29В этой таблице указаны репозиторий и название каждого маркетплейса — именно название вы вводите после `@`, когда устанавливаете плагин из этого маркетплейса. Название общественного маркетплейса — `claude-community`, а не название его репозитория.29В этой таблице указаны репозиторий и название каждого маркетплейса — именно название вы вводите после `@`, когда устанавливаете плагин из этого маркетплейса. Название общественного маркетплейса — `claude-community`, а не название его репозитория.

30 30 

31| | Официальный | Общественный | Демонстрационный |31| | Официальный | Общественный |

32| :- | :- | :- | :- |32| :- | :- | :- |

33| Репозиторий | [`anthropics/claude-plugins-official`](https://github.com/anthropics/claude-plugins-official) | [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) | [`anthropics/claude-code`](https://github.com/anthropics/claude-code/tree/main/plugins) |33| Репозиторий | [`anthropics/claude-plugins-official`](https://github.com/anthropics/claude-plugins-official) | [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) |

34| Название маркетплейса | `claude-plugins-official` | `claude-community` | `claude-code-plugins` |34| Название маркетплейса | `claude-plugins-official` | `claude-community` |

35| Что в нём | Плагины, которые поддерживает Anthropic, а также плагины от партнёров и других авторов | Сторонние плагины, которые их авторы отправили в Anthropic | Небольшой набор примеров плагинов, показывающих, что может содержать плагин |35| Что в нём | Плагины, которые поддерживает Anthropic, а также плагины от партнёров и других авторов | Сторонние плагины, которые их авторы отправили в Anthropic |

36| Как его получить | Claude Code добавляет его при первом запуске интерактивной сессии в терминале, если это не заблокировано [управляемой политикой](https://code.claude.com/docs/ru/plugins/org.md#allow-the-official-marketplace-and-your-own) или `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Если он отсутствует, см. [Маркетплейс `claude-plugins-official` не найден](https://code.claude.com/docs/ru/plugins/troubleshooting#marketplace-claude-plugins-official-not-found) | Вы добавляете его в сессии Claude Code с помощью `/plugin marketplace add anthropics/claude-plugins-community` | Вы добавляете его в сессии Claude Code с помощью `/plugin marketplace add anthropics/claude-code` |36| Как его получить | Claude Code добавляет его при первом запуске интерактивной сессии в терминале, если это не заблокировано [управляемой политикой](https://code.claude.com/docs/ru/plugins/org.md#allow-the-official-marketplace-and-your-own) или `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Если он отсутствует, см. [Маркетплейс `claude-plugins-official` не найден](https://code.claude.com/docs/ru/plugins/troubleshooting#marketplace-claude-plugins-official-not-found) | Вы добавляете его в сессии Claude Code с помощью `/plugin marketplace add anthropics/claude-plugins-community` |

37 37 

38Если вы написали плагин и хотите, чтобы другие могли его установить, см. [Публикация плагина](https://code.claude.com/docs/ru/plugins/publish.md) — там рассказывается о собственном маркетплейсе и отправке в каталог Anthropic.38Если вы написали плагин и хотите, чтобы другие могли его установить, см. [Публикация плагина](https://code.claude.com/docs/ru/plugins/publish.md) — там рассказывается о собственном маркетплейсе и отправке в каталог Anthropic.

39 39 

40### Демонстрационный маркетплейс в `anthropics/claude-code`40### Устаревший маркетплейс `claude-code-plugins`

41 41 

42Если руководство или более старая инструкция предлагает вам выполнить `/plugin marketplace add anthropics/claude-code`, эта команда добавляет демонстрационный маркетплейс с названием `claude-code-plugins`. Это не официальный маркетплейс.42> [!WARNING]

43>

44> Маркетплейс `claude-code-plugins` в `anthropics/claude-code` объявлен устаревшим. Чтобы добавить плагин, выполните `claude plugin install <plugin>@claude-plugins-official` в своей оболочке и пропустите любой шаг руководства, в котором выполняется `/plugin marketplace add anthropics/claude-code`.

45 

46Если у вас не установлен один из двух плагинов ниже, вы можете оставить свои плагины из `claude-code-plugins` и сам маркетплейс как есть. Они обновляются из репозитория `claude-plugins-official`.

43 47 

44Большинство плагинов демонстрационного маркетплейса также есть в официальном маркетплейсе под теми же названиями. Например, `code-review`, `feature-dev` и `commit-commands` есть в обоих. Устанавливайте их из `claude-plugins-official`, чтобы у вас не было установлено две копии.48* **`ralph-wiggum`**: этот плагин теперь называется `ralph-loop`, и его команды начинаются с `/ralph-loop:`. Если эти команды недоступны, выполните `claude plugin install ralph-loop@claude-plugins-official` в своей оболочке.

49* **`claude-opus-4-5-migration`**: этот плагин выведен из эксплуатации, поэтому удалите его, выполнив `claude plugin uninstall claude-opus-4-5-migration@claude-code-plugins` в своей оболочке.

50 

51Если какой-либо другой плагин перестал работать, см. [Плагин установлен, но не работает](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugin-installed-but-not-working).

45 52 

46## Поиск плагинов в официальном маркетплейсе53## Поиск плагинов в официальном маркетплейсе

47 54 


62 69 

63Чтобы установить плагин из настольного приложения или из скрипта либо узнать, что загружает облачная сессия, см. [Установка плагинов](https://code.claude.com/docs/ru/plugins/install.md).70Чтобы установить плагин из настольного приложения или из скрипта либо узнать, что загружает облачная сессия, см. [Установка плагинов](https://code.claude.com/docs/ru/plugins/install.md).

64 71 

65### Добавление общественного или демонстрационного маркетплейса72### Добавление общественного маркетплейса

66 

67Общественный и демонстрационный маркетплейсы не зарегистрированы, пока вы не добавите их в сессии Claude Code:

68 73 

69* **Общественный**: выполните `/plugin marketplace add anthropics/claude-plugins-community`, затем устанавливайте с суффиксом `@claude-community`.74Общественный маркетплейс не зарегистрирован, пока вы не добавите его. В сессии Claude Code выполните `/plugin marketplace add anthropics/claude-plugins-community`, затем устанавливайте с суффиксом `@claude-community`.

70* **Демонстрационный**: выполните `/plugin marketplace add anthropics/claude-code`, затем устанавливайте с суффиксом `@claude-code-plugins`.

71 75 

72Если `claude-plugins-official` отсутствует на вкладке **Marketplaces** в `/plugin`, добавьте его тем же способом с помощью `/plugin marketplace add anthropics/claude-plugins-official`.76Если `claude-plugins-official` отсутствует на вкладке **Marketplaces** в `/plugin`, добавьте его тем же способом с помощью `/plugin marketplace add anthropics/claude-plugins-official`.

73 77 

Details

638| Код выхода | Строка вердикта | Значение |638| Код выхода | Строка вердикта | Значение |

639| :- | :- | :- |639| :- | :- | :- |

640| `0` | `Validation passed` или `Validation passed with warnings` | Манифест загружается. С `--strict` также нет предупреждений |640| `0` | `Validation passed` или `Validation passed with warnings` | Манифест загружается. С `--strict` также нет предупреждений |

641| `1` | `Validation failed` или `Validation failed (--strict treats warnings as errors)` | Ошибка или предупреждение под `--strict` |641| `1` | `Validation failed` или `Validation failed (--strict treats warnings as errors)` | Ошибка или предупреждение под `--strict`. [Рекомендации](#advice-on-the-readme) не учитываются, с `--strict` или без него |

642| `2` | `Unexpected error during validation: <reason>` | Сам валидатор не выполнился, например на нечитаемом пути |642| `2` | `Unexpected error during validation: <reason>` | Сам валидатор не выполнился, например на нечитаемом пути |

643 643 

644С `--json` Claude Code записывает отчёт на stdout как один JSON объект с этими полями верхнего уровня:644С `--json` Claude Code записывает отчёт на stdout как один JSON объект с этими полями верхнего уровня:


647* `strict`: рассматривал ли запуск предупреждения как ошибки647* `strict`: рассматривал ли запуск предупреждения как ошибки

648* `target`: разрешённый путь, который Claude Code проверил648* `target`: разрешённый путь, который Claude Code проверил

649* `manifest`: собственный результат манифеста или `null` для запуска без манифеста649* `manifest`: собственный результат манифеста или `null` для запуска без манифеста

650* `contents`: результаты для каждого файла, каждый называет свой `file` и содержит массивы `errors`, `warnings` и `notes`650* `contents`: результаты для каждого файла, каждый называет свой `file` и содержит массивы `errors`, `warnings` и `notes`. Файлы без ошибок, предупреждений или заметок не получают записи, поэтому `contents` пуст, когда сообщать не о чем. Для [каталога с `marketplace.json` и `plugin.json`](#validate-a-directory) `manifest` — это результат `marketplace.json`, а результаты `plugin.json` попадают в `contents`

651 * `gatingHooks`: есть ли у каждого хука [мода](https://code.claude.com/docs/ru/plugins/mods/overview.md), который может отклонить действие, например хука `tool.call`, [обработчик `.catch`](https://code.claude.com/docs/ru/plugins/mods/events#handle-a-hook-that-fails). Каждый элемент содержит `module`, `pattern`, `hook` и `hasCatch`. Требует Claude Code v2.1.290 или позже651 * `gatingHooks`: есть ли у каждого хука [мода](https://code.claude.com/docs/ru/plugins/mods/overview.md), который может отклонить действие, например хука `tool.call`, [обработчик `.catch`](https://code.claude.com/docs/ru/plugins/mods/events#handle-a-hook-that-fails). Каждый элемент содержит `module`, `pattern`, `hook` и `hasCatch`. Требует Claude Code v2.1.290 или позже

652* `advice`: [рекомендации](#advice-on-the-readme) запуска; каждая запись называет README как `file` и содержит `message` и `installLine` для вставки. Пусто, когда рекомендаций нет. Требует Claude Code v2.1.295 или позже

652 653 

653При выходе `2` команда ничего не записывает на stdout. Сообщение об ошибке идёт на stderr.654При выходе `2` команда ничего не записывает на stdout. Сообщение об ошибке идёт на stderr.

654 655 

656#### Рекомендации по README

657 

658Блок `Advice` в выводе `claude plugin validate` означает, что в README плагина нет строки, которая устанавливает плагин из маркетплейса, и предлагает вам строку для добавления. Рекомендация не является ни ошибкой, ни предупреждением. Она не меняет строку вердикта или код выхода, с `--strict` или без него. Требует Claude Code v2.1.295 или позже.

659 

660Например, проверка каталога маркетплейса `acme-tools` выводит такую рекомендацию для его плагина `deploy-helper`:

661 

662```text theme={null}

663Validating marketplace manifest: /path/to/acme-tools/.claude-plugin/marketplace.json

664 

665ℹ Advice (does not change the verdict):

666 

667 ❯ /path/to/acme-tools/plugins/deploy-helper/README.md: This README has no line that installs "deploy-helper" from a marketplace. Add the install line, which works in one step on Claude Code 2.1.275 or later.

668 /plugin install deploy-helper --marketplace acme/tools

669 

670✔ Validation passed

671```

672 

673Чтобы убрать рекомендацию, вставьте предложенную строку в указанный README, затем снова запустите `claude plugin validate` в вашей оболочке. Блок `Advice` исчезнет.

674 

675Если предложенная строка содержит заполнитель `<owner>/<repo>`, вставка её без изменений не уберёт рекомендацию. Сначала получите реальный источник:

676 

677* **Вы проверили собственный каталог плагина**: когда маркетплейс перечисляет плагин из каталога внутри своего собственного, проверьте вместо этого этот каталог. Когда он перечисляет плагин из другого места, например из репозитория GitHub, заполните `<owner>/<repo>` самостоятельно

678* **Вы проверили каталог маркетплейса**: Claude Code заполняет источник из удалённого репозитория `origin` каталога `.git` на верхнем уровне этого каталога. Когда он не может использовать этот удалённый репозиторий, например когда его нет, замените `<owner>/<repo>` источником вашего маркетплейса самостоятельно

679 

680Строка установки, которую вы уже написали, учитывается, когда за `plugin install` или его краткой формой `plugin i` на той же строке следует одно из следующего. Учитываются оба написания — `/plugin` и `claude plugin`:

681 

682* `<plugin>@<marketplace>`, например `/plugin install deploy-helper@acme-tools`

683* Имя плагина и `--marketplace <source>`, например `/plugin install deploy-helper --marketplace acme/tools`

684 

655## Команды claude plugin marketplace685## Команды claude plugin marketplace

656 686 

657Запустите `claude plugin marketplace <subcommand>` из вашей оболочки, чтобы добавить, вывести, обновить и удалить маркетплейсы, из которых вы устанавливаете плагины.687Запустите `claude plugin marketplace <subcommand>` из вашей оболочки, чтобы добавить, вывести, обновить и удалить маркетплейсы, из которых вы устанавливаете плагины.

Details

376* [Структура плагина и тестирование](https://claude.com/docs/plugins/build): одна и та же папка плагина устанавливается на claude.ai и в Cowork. Некоторые компоненты только для Claude Code, и [таблица поддержки компонентов](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app) указывает, какие загружаются на каждой поверхности376* [Структура плагина и тестирование](https://claude.com/docs/plugins/build): одна и та же папка плагина устанавливается на claude.ai и в Cowork. Некоторые компоненты только для Claude Code, и [таблица поддержки компонентов](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app) указывает, какие загружаются на каждой поверхности

377* [Справочник манифеста плагина](https://code.claude.com/docs/ru/plugins/manifest-reference.md): каждое поле `plugin.json`, правило пути и директория377* [Справочник манифеста плагина](https://code.claude.com/docs/ru/plugins/manifest-reference.md): каждое поле `plugin.json`, правило пути и директория

378* [Skills](https://code.claude.com/docs/ru/skills.md): напишите skills, которые предоставляет ваш плагин378* [Skills](https://code.claude.com/docs/ru/skills.md): напишите skills, которые предоставляет ваш плагин

379* [Плагины Anthropic в репозитории claude-code](https://github.com/anthropics/claude-code/tree/main/plugins): полные рабочие примеры макета на этой странице, такие как `feature-dev` и `code-review`379* [Плагины Anthropic в репозитории claude-plugins-official](https://github.com/anthropics/claude-plugins-official/tree/main/plugins): полные рабочие примеры макета на этой странице, такие как `feature-dev` и `code-review`

Details

220 220 

221## Host your marketplace221## Host your marketplace

222 222 

223После того как вы сможете установить плагин из marketplace на своей машине, как в [Создание marketplace](#create-a-marketplace), отправьте каталог marketplace на хост git.223После того как вы сможете установить плагин из маркетплейса на своей машине, как в разделе [Создание маркетплейса](#create-a-marketplace), отправьте каталог маркетплейса на Git-хостинг. Перед отправкой задайте маркетплейсу `name` верхнего уровня, который другие авторы вряд ли выберут, потому что у пользователя [не может быть двух маркетплейсов с одинаковым именем](https://code.claude.com/docs/ru/plugins/marketplace-reference.md#marketplace-file).

224 224 

225Ваши товарищи по команде затем запускают `claude plugin marketplace add <owner>/<repo>` в своей оболочке для репозитория GitHub или ту же команду с URL репозитория. Затем они устанавливают плагин по имени, как в [пошаговом руководстве](#create-a-marketplace).225Ваши товарищи по команде затем запускают `claude plugin marketplace add <owner>/<repo>` в своей оболочке для репозитория GitHub или ту же команду с URL репозитория. Затем они устанавливают плагин по имени, как в [пошаговом руководстве](#create-a-marketplace).

226 226 

Details

193 193 

194| Источник | Что вы вводите | Пример |194| Источник | Что вы вводите | Пример |

195| :- | :- | :- |195| :- | :- | :- |

196| Репозиторий GitHub | `owner/repo`. Добавьте `#ref`, чтобы закрепить ветку или тег. | `/plugin marketplace add anthropics/claude-code`, или `/plugin marketplace add your-org/plugins#v1.2.0`, чтобы закрепить тег `v1.2.0` |196| Репозиторий GitHub | `owner/repo`. Добавьте `#ref`, чтобы закрепить ветку или тег. | `/plugin marketplace add anthropics/claude-plugins-official`, или `/plugin marketplace add your-org/plugins#v1.2.0`, чтобы закрепить тег `v1.2.0` |

197| Репозиторий Git на любом хосте | Полный URL клонирования. Добавьте `#ref`, чтобы закрепить ветку или тег. | `/plugin marketplace add https://gitlab.example.com/your-group/your-marketplace.git#v1.0.0` |197| Репозиторий Git на любом хосте | Полный URL клонирования. Добавьте `#ref`, чтобы закрепить ветку или тег. | `/plugin marketplace add https://gitlab.example.com/your-group/your-marketplace.git#v1.0.0` |

198| Локальный каталог или файл | Относительный или абсолютный путь к каталогу, который содержит `.claude-plugin/marketplace.json`, или к самому JSON файлу. Начните относительный путь с `./` или `../`, потому что Claude Code читает голый `name/name` как репозиторий GitHub. | `/plugin marketplace add ./my-marketplace` |198| Локальный каталог или файл | Относительный или абсолютный путь к каталогу, который содержит `.claude-plugin/marketplace.json`, или к самому JSON файлу. Начните относительный путь с `./` или `../`, потому что Claude Code читает голый `name/name` как репозиторий GitHub. | `/plugin marketplace add ./my-marketplace` |

199| Размещённый `marketplace.json` | Его URL `https://` | `/plugin marketplace add https://example.com/marketplace.json` |199| Размещённый `marketplace.json` | Его URL `https://` | `/plugin marketplace add https://example.com/marketplace.json` |


383 383 

384## Следующие шаги384## Следующие шаги

385 385 

386* [Anthropic's marketplaces](https://code.claude.com/docs/ru/plugins/anthropic-marketplaces.md): как отличаются официальный, маркетплейсы сообщества и демонстрационный и где просмотреть каждый386* [Маркетплейсы Anthropic](https://code.claude.com/docs/ru/plugins/anthropic-marketplaces.md): чем отличаются официальный маркетплейс и маркетплейсы сообщества и где просмотреть каждый из них

387* [Plugin loading reference](https://code.claude.com/docs/ru/plugins/loading.md): почему плагин загрузился, не загрузился или не изменился после обновления387* [Plugin loading reference](https://code.claude.com/docs/ru/plugins/loading.md): почему плагин загрузился, не загрузился или не изменился после обновления

388* [Plugin security and trust](https://code.claude.com/docs/ru/plugins/security.md): что просмотреть перед установкой плагина из маркетплейса, который вы не знаете388* [Plugin security and trust](https://code.claude.com/docs/ru/plugins/security.md): что просмотреть перед установкой плагина из маркетплейса, который вы не знаете

389* [Troubleshoot plugins](https://code.claude.com/docs/ru/plugins/troubleshooting.md): установка и сообщения об ошибках маркетплейса с их исправлениями389* [Troubleshoot plugins](https://code.claude.com/docs/ru/plugins/troubleshooting.md): установка и сообщения об ошибках маркетплейса с их исправлениями

Details

366 366 

367Значение, возвращённое для указанного ключа, не соответствует схеме этого ключа, например по типу или по диапазону.367Значение, возвращённое для указанного ключа, не соответствует схеме этого ключа, например по типу или по диапазону.

368 368 

369* **Ваше значение не соответствует схеме ключа**: верните значение, которое допускает запись этого ключа в [справочнике настроек](https://code.claude.com/docs/ru/settings-reference.md).369* **Ваше значение не соответствует схеме ключа**: верните значение, допустимое согласно записи этого ключа в [справочнике настроек](https://code.claude.com/docs/ru/settings-reference.md).

370* **Ваше значение подходит**: неподходящее значение пришло из хука `settings.read` другого мода. Чтобы найти этот мод, выполните [шаги по поочерёдному отключению модов](#settings-read-refused). Ищите в каждом новом логе эту строку вместо `refused to the engine`.370* **Ваше значение подходит**: неподходящее значение пришло из хука `settings.read` другого мода. Чтобы найти этот мод, выполните [шаги по поочерёдному отключению модов](#settings-read-refused). Ищите в каждом новом логе эту строку вместо `refused to the engine`.

371 371 

372Пока значение не подходит, ключ сохраняет значение, объединённое из источников настроек до ответа какого-либо хука. В строке оно называется собственным значением настроек.372Пока значение не подходит, ключ сохраняет значение, объединённое из источников настроек до ответа какого-либо хука. В строке оно называется собственным значением настроек.

Details

66>66>

67> Marketplace plugin — это не [Claude Marketplace](https://claude.com/marketplace). Claude Marketplace — это веб-сайт на claude.com/marketplace, где вы просматриваете plugins, connectors, партнерские продукты и партнеров услуг. Это не marketplace, который вы добавляете с помощью `/plugin marketplace add`.67> Marketplace plugin — это не [Claude Marketplace](https://claude.com/marketplace). Claude Marketplace — это веб-сайт на claude.com/marketplace, где вы просматриваете plugins, connectors, партнерские продукты и партнеров услуг. Это не marketplace, который вы добавляете с помощью `/plugin marketplace add`.

68 68 

69Claude Code добавляет официальный marketplace Anthropic при первом запуске интерактивного сеанса терминала, если [управляемая политика](https://code.claude.com/docs/ru/plugins/org.md#allow-the-official-marketplace-and-your-own) это не блокирует. Claude Code не добавляет Anthropic's community и demo marketplaces самостоятельно. Чтобы различить три marketplace Anthropic, прочитайте [Anthropic's marketplaces](https://code.claude.com/docs/ru/plugins/anthropic-marketplaces.md). Чтобы увидеть, что перечисляет официальный, откройте вкладку **Discover** в `/plugin` в сеансе или просмотрите [Claude Marketplace](https://claude.com/marketplace/plugins).69Claude Code добавляет официальный маркетплейс Anthropic при первом запуске интерактивной сессии в терминале, если это не блокирует [управляемая политика](https://code.claude.com/docs/ru/plugins/org.md#allow-the-official-marketplace-and-your-own). Claude Code не добавляет маркетплейс сообщества Anthropic самостоятельно. Чтобы различать маркетплейсы Anthropic, прочитайте [Маркетплейсы Anthropic](https://code.claude.com/docs/ru/plugins/anthropic-marketplaces.md). Чтобы увидеть, что перечисляет официальный маркетплейс, откройте вкладку **Discover** в `/plugin` в сессии или просмотрите [Claude Marketplace](https://claude.com/marketplace/plugins).

70 70 

71На этой диаграмме показан путь от marketplace к вашему сеансу. Marketplace перечисляет plugin, вы устанавливаете этот plugin, и Claude Code загружает его компоненты.71На этой диаграмме показан путь от marketplace к вашему сеансу. Marketplace перечисляет plugin, вы устанавливаете этот plugin, и Claude Code загружает его компоненты.

72 72 


88 88 

89Имя marketplace помещает его в один из трех уровней. Claude Code принимает официальные и community имена только для marketplaces, полученных из репозиториев `github.com/anthropics/`:89Имя marketplace помещает его в один из трех уровней. Claude Code принимает официальные и community имена только для marketplaces, полученных из репозиториев `github.com/anthropics/`:

90 90 

91* **Official**: marketplaces с одним из [официальных имен marketplace](https://code.claude.com/docs/ru/plugins/security.md#official-marketplace-names) Anthropic, включая `claude-plugins-official` и demo marketplace `claude-code-plugins`.91* **Официальные**: маркетплейсы с одним из [официальных имён маркетплейсов](https://code.claude.com/docs/ru/plugins/security.md#official-marketplace-names) Anthropic, включая `claude-plugins-official` и `claude-code-plugins`.

92* **Community**: marketplaces с одним из community имен Anthropic, например `claude-community`. [Identify Anthropic's marketplaces by name](https://code.claude.com/docs/ru/plugins/security.md#marketplace-tiers) их перечисляет.92* **Community**: marketplaces с одним из community имен Anthropic, например `claude-community`. [Identify Anthropic's marketplaces by name](https://code.claude.com/docs/ru/plugins/security.md#marketplace-tiers) их перечисляет.

93* **Third-party**: все остальные marketplaces. Marketplace, который публикует ваш коллега или ваша организация, является third-party.93* **Third-party**: все остальные marketplaces. Marketplace, который публикует ваш коллега или ваша организация, является third-party.

94 94 

Details

96}96}

97```97```

98 98 

99В вашей оболочке запустите `claude plugin validate .` в репозитории перед отправкой. О том, что проверяет этот запуск, см. [Проверка каталога](https://code.claude.com/docs/ru/plugins/cli-reference.md#validate-a-directory).99Замените `your-marketplace` именем, которое другие авторы вряд ли выберут, потому что у пользователя [не может быть двух маркетплейсов с одинаковым именем](https://code.claude.com/docs/ru/plugins/marketplace-reference.md#marketplace-file). В вашей оболочке запустите `claude plugin validate .` в репозитории перед отправкой. О том, что проверяет этот запуск, см. [Проверка каталога](https://code.claude.com/docs/ru/plugins/cli-reference.md#validate-a-directory).

100 100 

101[Создание маркетплейса](https://code.claude.com/docs/ru/plugins/create-marketplace.md) охватывает макет с несколькими плагинами в одном репозитории.101[Создание маркетплейса](https://code.claude.com/docs/ru/plugins/create-marketplace.md) охватывает макет с несколькими плагинами в одном репозитории.

102 102 

Details

76* `first-party-plugins`76* `first-party-plugins`

77* `claude-tag-plugins`77* `claude-tag-plugins`

78 78 

79О том, чем отличаются official, community и demo marketplace и где можно просмотреть, что указано в каждом, см. [Anthropic's marketplaces](https://code.claude.com/docs/ru/plugins/anthropic-marketplaces.md).79О том, чем отличаются маркетплейсы official и community и где можно просмотреть, что указано в каждом из них, см. [Маркетплейсы Anthropic](https://code.claude.com/docs/ru/plugins/anthropic-marketplaces.md).

80 80 

81## Проверьте плагин перед установкой81## Проверьте плагин перед установкой

82 82 

Details

18 18 

19Используйте скрипт-обёртку, когда каждой сессии требуется настройка, которую средство выполнения не может выполнить самостоятельно: подготовка краткосрочных учётных данных, ограниченных создателем сессии, экспорт секретов, специфичных для окружения, подготовка цепочек инструментов языка или применение ограничений ресурсов вокруг дочернего процесса. Средство выполнения запускает вашу обёртку вместо двоичного файла Claude Code один раз за сессию. Завершите обёртку, выполнив `exec` в `$CLAUDE_RUNNER_CLAUDE_BIN`, собственный двоичный файл средства выполнения, чтобы сигналы и коды выхода распространялись правильно.19Используйте скрипт-обёртку, когда каждой сессии требуется настройка, которую средство выполнения не может выполнить самостоятельно: подготовка краткосрочных учётных данных, ограниченных создателем сессии, экспорт секретов, специфичных для окружения, подготовка цепочек инструментов языка или применение ограничений ресурсов вокруг дочернего процесса. Средство выполнения запускает вашу обёртку вместо двоичного файла Claude Code один раз за сессию. Завершите обёртку, выполнив `exec` в `$CLAUDE_RUNNER_CLAUDE_BIN`, собственный двоичный файл средства выполнения, чтобы сигналы и коды выхода распространялись правильно.

20 20 

21Укажите в `--exec-path` или `SELF_HOSTED_RUNNER_EXEC_PATH` путь к обёртке при запуске средства выполнения:21Укажите в `--exec-path` или `SELF_HOSTED_RUNNER_EXEC_PATH` путь к обёртке при запуске средства выполнения, заменив `<writable-dir>`, как описано в разделе [быстрого старта](https://code.claude.com/docs/ru/self-hosted-environments-quickstart.md#set-up-manually):

22 22 

23```bash theme={null}23```bash theme={null}

24claude self-hosted-runner --environment-secret-file /etc/claude/environment-secret --exec-path /etc/claude/session-wrapper.sh24claude self-hosted-runner --environment-secret-file /etc/claude/environment-secret --base-dir '<writable-dir>' --exec-path /etc/claude/session-wrapper.sh

25```25```

26 26 

27Средство выполнения устанавливает следующие переменные в окружении обёртки:27Средство выполнения устанавливает следующие переменные в окружении обёртки:


457 457 

458Чтобы убедиться, что ловушка работает, добавьте сразу под строкой `trap` строку, вызывающую несуществующую команду, например `no-such-command`. Запустите файл хука из своей оболочки и убедитесь, что `echo $?` выводит `1`, затем удалите эту строку.458Чтобы убедиться, что ловушка работает, добавьте сразу под строкой `trap` строку, вызывающую несуществующую команду, например `no-such-command`. Запустите файл хука из своей оболочки и убедитесь, что `echo $?` выводит `1`, затем удалите эту строку.

459 459 

460### Остановка или перезапуск оркестратора

461 

462Чтобы остановить или перезапустить оркестратор, не обрывая выполняющиеся хуки `spawn-runner`, запускайте его с [`--shutdown-drain-sec`](https://code.claude.com/docs/ru/self-hosted-environments-reference#orchestrator-cli-flags). Тогда при получении `SIGTERM` он даёт выполняющимся хукам на завершение не больше заданного вами числа секунд. О том, как выбрать значение и настроить под него супервизор процессов, см. [Подбор `--shutdown-drain-sec` и таймаута остановки оркестратора](#size-shutdown-drain-sec-and-the-supervisors-stop-timeout-for-the-orchestrator).

463 

464Эта команда запуска отводит 70 секунд:

465 

466```bash theme={null}

467claude self-hosted-runner orchestrator \

468 --environment-secret-file /etc/claude/environment-secret \

469 --hooks-dir /etc/claude/hooks \

470 --shutdown-drain-sec 70

471```

472 

473Оркестратор завершается, как только завершатся уже отправленный опрос и все хуки. Когда истекают секунды `--shutdown-drain-sec`, хуки, которые всё ещё выполняются, получают `SIGTERM`, и оркестратор завершается. Второй `SIGTERM` или любой `SIGINT` приводит к тому же без ожидания. Строка лога, содержащая `[runner:orchestrator] stop summary:`, подсчитывает хуки и запросы на порождение по тому, как завершился каждый из них.

474 

475Без `--shutdown-drain-sec` оркестратор останавливается сразу при получении `SIGTERM` или `SIGINT`. Каждый выполняющийся хук получает `SIGTERM`, а Anthropic ничего не сообщается. Сессия, средство выполнения которой так и не было запущено, может тогда оставаться в очереди, пока Anthropic [не запросит его повторно](#the-spawn-runner-hook), что происходит по истечении `--expected-spawn-seconds`, по умолчанию 120 секунд.

476 

477> [!NOTE]

478>

479> `--shutdown-drain-sec` требует Claude Code v2.1.299 или новее. Более старая версия завершается при запуске с ошибкой `error: unknown flag --shutdown-drain-sec`.

480 

481#### Подбор `--shutdown-drain-sec` и таймаута остановки оркестратора

482 

483При настройках по умолчанию используйте [`--shutdown-drain-sec 70`](https://code.claude.com/docs/ru/self-hosted-environments-reference#orchestrator-cli-flags) с таймаутом остановки 85 секунд, то есть `terminationGracePeriodSeconds: 85` в Kubernetes или `TimeoutStopSec=85` в systemd. Если вы изменили `--hook-timeout`, масштабируйте оба значения:

484 

485* **`--shutdown-drain-sec`**: не меньше `--hook-timeout` плюс 10 секунд, чтобы хук, запущенный прямо перед `SIGTERM`, всё же успел завершиться

486* **Таймаут остановки**: не меньше `--shutdown-drain-sec` плюс 15 секунд. Оркестратор записывает это значение в лог при запуске: найдите строку, содержащую `shutdown drain:`.

487 

488Настройте супервизор процессов так, чтобы он отправлял один `SIGTERM` и только процессу оркестратора, потому что второй сигнал прерывает ожидание `--shutdown-drain-sec`. Если оставить в systemd значение по умолчанию [`KillMode=control-group`](https://code.claude.com/docs/ru/self-hosted-environments-deploy#what-reaches-a-running-post-session-hook), хуки тоже получат `SIGTERM`, и хук может завершиться до того, как отправит свою рабочую нагрузку. Прежде чем менять `KillMode`, проверьте, как ваш хук `spawn-runner` запускает средства выполнения:

489 

490* **Если ваш хук отправляет рабочую нагрузку на платформу и завершается**: запускайте оркестратор как основной процесс юнита и задайте `KillMode=mixed`, при котором `SIGTERM` отправляется только этому процессу.

491* **Если ваш хук запускает средства выполнения как процессы в собственном юните оркестратора**: при `KillMode=mixed` эти средства выполнения не получают `SIGTERM`. Вместо этого systemd позже отправляет им `SIGKILL`, поэтому они завершаются, не освободив свои сессии и не выполнив свой хук `post-session`.

492 

460## Отправка запросов к модели в Bedrock или Agent Platform493## Отправка запросов к модели в Bedrock или Agent Platform

461 494 

462Если ваша организация требует, чтобы запросы к модели проходили через её собственный аккаунт AWS или Google Cloud, настройте runner для [Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md) или [Google Cloud's Agent Platform, ранее Vertex AI](https://code.claude.com/docs/ru/google-vertex-ai.md). После этого каждая сессия, которую запускает этот runner, обращается к модели в вашем облачном аккаунте с вашими облачными учётными данными. Без этой конфигурации сессии отправляют запросы к модели в Anthropic API.495Если ваша организация требует, чтобы запросы к модели проходили через её собственный аккаунт AWS или Google Cloud, настройте runner для [Amazon Bedrock](https://code.claude.com/docs/ru/amazon-bedrock.md) или [Google Cloud's Agent Platform, ранее Vertex AI](https://code.claude.com/docs/ru/google-vertex-ai.md). После этого каждая сессия, которую запускает этот runner, обращается к модели в вашем облачном аккаунте с вашими облачными учётными данными. Без этой конфигурации сессии отправляют запросы к модели в Anthropic API.

Details

583 583 

584## Время завершения работы584## Время завершения работы

585 585 

586После `SIGTERM` runner нужно время, чтобы корректно завершить свои сессии, прежде чем ваш оркестратор его убьёт. Сколько именно, он записывает в лог при запуске, в строке, которая при настройках по умолчанию содержит `This runner needs up to 80s`. Установите таймаут остановки вашего оркестратора не меньше этого количества секунд: `terminationGracePeriodSeconds` в Kubernetes, `stop_grace_period` в Docker Compose или эквивалент на вашей платформе. В Kubernetes значение по умолчанию составляет 30 секунд, поэтому без этой настройки он может остановить pod до того, как runner завершит работу.586> [!NOTE]

587>

588> Эти значения времени относятся к runner. У процесса `claude self-hosted-runner orchestrator` есть свои: см. [Подберите `--shutdown-drain-sec` и таймаут остановки оркестратора](https://code.claude.com/docs/ru/self-hosted-environments-configuration#size-shutdown-drain-sec-and-the-supervisors-stop-timeout-for-the-orchestrator).

589 

590При запуске каждый runner записывает в лог, сколько времени ему может понадобиться после `SIGTERM`, чтобы корректно завершить свои сессии, например `This runner needs up to 80s` при настройках по умолчанию. Таймаут остановки — это время, которое ваш супервизор процессов ждёт после `SIGTERM`, прежде чем убить runner. Установите его не меньше времени, записанного в лог:

591 

592* **Kubernetes**: `terminationGracePeriodSeconds`. В Kubernetes значение по умолчанию составляет 30 секунд, поэтому без этой настройки он может остановить pod до того, как runner завершит работу.

593* **Docker Compose**: `stop_grace_period`

587 594 

588При получении `SIGTERM` runner перестаёт принимать новые сессии. Затем он начинает корректное завершение работы, называемое drain, если только вы не установили [`--defer-shutdown-max-min`](#defer-the-drain-past-the-first-signal), чтобы отложить его. Drain состоит из трёх шагов:595При получении `SIGTERM` runner перестаёт принимать новые сессии. Затем он начинает корректное завершение работы, называемое drain, если только вы не установили [`--defer-shutdown-max-min`](#defer-the-drain-past-the-first-signal), чтобы отложить его. Drain состоит из трёх шагов:

589 596 


744 751 

745**2. Запустите runner**752**2. Запустите runner**

746 753 

747Из вашей оболочки запустите runner с `--hold-idle-file`, `--release-idle-session-min` и [`--max-hold-min`](https://code.claude.com/docs/ru/self-hosted-environments-reference#runner-cli-flags) — ограничением на удержание, отсчитываемым с момента перехода сессии в простой. Без него ограничение составляет один день. Задайте его больше, чем `--release-idle-session-min`, иначе ничего не будет удерживаться. В этом примере простаивающие сессии освобождаются через 30 минут, а удерживаемая сессия освобождается не позднее чем через 4 часа после перехода в простой:754Из вашей оболочки запустите runner с `--hold-idle-file`, `--release-idle-session-min` и [`--max-hold-min`](https://code.claude.com/docs/ru/self-hosted-environments-reference#runner-cli-flags) — ограничением на удержание, отсчитываемым с момента перехода сессии в простой. Без него ограничение составляет один день. Задайте его больше, чем `--release-idle-session-min`, иначе ничего не будет удерживаться. Замените `<writable-dir>`, как описано в [руководстве по быстрому старту](https://code.claude.com/docs/ru/self-hosted-environments-quickstart.md#set-up-manually). В этом примере простаивающие сессии освобождаются через 30 минут, а удерживаемая сессия освобождается не позднее чем через 4 часа после перехода в простой:

748 755 

749```bash theme={null}756```bash theme={null}

750claude self-hosted-runner \757claude self-hosted-runner \

751 --environment-secret-file /etc/claude/environment-secret \758 --environment-secret-file /etc/claude/environment-secret \

759 --base-dir '<writable-dir>' \

752 --release-idle-session-min 30 \760 --release-idle-session-min 30 \

753 --hold-idle-file /var/lib/claude-hold/hold-idle \761 --hold-idle-file /var/lib/claude-hold/hold-idle \

754 --max-hold-min 240762 --max-hold-min 240


816 * **Незакоммиченные изменения всё равно теряются**: чтобы побудить Claude делать коммит и push по завершении ответа, см. [Побуждение сессий отправлять свою работу](https://code.claude.com/docs/ru/self-hosted-environments-configuration.md#prompt-sessions-to-push-their-work)824 * **Незакоммиченные изменения всё равно теряются**: чтобы побудить Claude делать коммит и push по завершении ответа, см. [Побуждение сессий отправлять свою работу](https://code.claude.com/docs/ru/self-hosted-environments-configuration.md#prompt-sessions-to-push-their-work)

817* **Команда, прерванная из-за потери runner, может выполниться повторно**: когда сессия возобновляется на другом runner, Claude видит прерванный вызов инструмента с результатом, сообщающим, что его исход неизвестен.825* **Команда, прерванная из-за потери runner, может выполниться повторно**: когда сессия возобновляется на другом runner, Claude видит прерванный вызов инструмента с результатом, сообщающим, что его исход неизвестен.

818* **Репозиторий, добавленный в середине сессии, может не клонироваться**: Claude клонирует его с помощью `git clone` по HTTPS. На runner без [`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy) клонирование завершается ошибкой аутентификации git, если ничто на хосте не может прочитать репозиторий. По возможности выбирайте все необходимые сессии репозитории при её создании.826* **Репозиторий, добавленный в середине сессии, может не клонироваться**: Claude клонирует его с помощью `git clone` по HTTPS. На runner без [`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy) клонирование завершается ошибкой аутентификации git, если ничто на хосте не может прочитать репозиторий. По возможности выбирайте все необходимые сессии репозитории при её создании.

827 * **При возобновлении сессии**: [хук `checkout`](https://code.claude.com/docs/ru/self-hosted-environments-configuration#checkout) запускается и для добавленного репозитория, при этом [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/ru/self-hosted-environments-configuration#checkout) пуст, поэтому убедитесь, что ваш хук обрабатывает этот случай.

819* **Некоторые коннекторы не появляются в самостоятельно размещаемых сеансах**: коннектор, который вы еще не подключили в параметрах claude.ai, не указан в самостоятельно размещаемом сеансе, и сеанс не будет вас приглашать подключить его. Подключите его в параметрах сначала, затем запустите свежий сеанс. Добавление коннектора в уже работающий сеанс тоже не делает его инструменты доступными для Claude; запустите свежий сеанс, чтобы подхватить недавно добавленный коннектор.828* **Некоторые коннекторы не появляются в самостоятельно размещаемых сеансах**: коннектор, который вы еще не подключили в параметрах claude.ai, не указан в самостоятельно размещаемом сеансе, и сеанс не будет вас приглашать подключить его. Подключите его в параметрах сначала, затем запустите свежий сеанс. Добавление коннектора в уже работающий сеанс тоже не делает его инструменты доступными для Claude; запустите свежий сеанс, чтобы подхватить недавно добавленный коннектор.

820* **Когда кто-то архивирует или удаляет сессию либо освобождает её runner из меню сессии**: не рассчитывайте на push через [`--push-outcome-on-release`](https://code.claude.com/docs/ru/self-hosted-environments-reference#runner-cli-flags). Чтобы сохранить коммиты в этих случаях, отправляйте `HEAD` в резервную ветку из [хука `post-session`](https://code.claude.com/docs/ru/self-hosted-environments-configuration#post-session). Если вы берёте за основу приведённый там пример, сделайте так, чтобы он выполнял push, даже когда незакоммиченных изменений нет, поскольку он выполняет push только после коммита-снимка.829* **Когда кто-то архивирует или удаляет сессию либо освобождает её runner из меню сессии**: не рассчитывайте на push через [`--push-outcome-on-release`](https://code.claude.com/docs/ru/self-hosted-environments-reference#runner-cli-flags). Чтобы сохранить коммиты в этих случаях, отправляйте `HEAD` в резервную ветку из [хука `post-session`](https://code.claude.com/docs/ru/self-hosted-environments-configuration#post-session). Если вы берёте за основу приведённый там пример, сделайте так, чтобы он выполнял push, даже когда незакоммиченных изменений нет, поскольку он выполняет push только после коммита-снимка.

821 830 


833 842 

834Частые проблемы:843Частые проблемы:

835 844 

836* **Runner не появляется в окружении**: убедитесь, что хост может подключиться к `api.anthropic.com` по HTTPS, секрет окружения актуален, а часы хоста отклоняются от реального времени не более чем на пять минут; большее расхождение приводит к сбою аутентификации. При сбое аутентификации runner записывает в лог `[runner:fatal]` с причиной отказа.845* **Runner не появляется в окружении**: убедитесь, что хост может подключиться к `api.anthropic.com` по HTTPS, а секрет окружения актуален. При сбое аутентификации runner записывает в лог `[runner:fatal]` с причиной отказа.

837* **Runner завершается при запуске с `cannot create or write to base directory`**: runner не может создать `--base-dir` или записать в него; по умолчанию это `/workspace`. Исправьте владельца каталога или укажите в `--base-dir` путь, доступный для записи, как описано в разделе [Сохраняйте одинаковые базовый каталог и ёмкость на всех runner'ах](#keep-the-base-directory-and-capacity-identical-across-runners). Если вместо этого runner записывает в лог `[runner:fatal]` с сообщением о том, что истёк таймаут проверки базового каталога, каталог находится на зависшем монтировании NFS или CSI. Проверьте работоспособность монтирования, а не права доступа. Runner выводит оба этих сбоя запуска в stderr до того, как откроет `--log-file`, поэтому ищите их в терминале или в логах контейнеров вашей платформы, а не в файле лога. До v2.1.225 runner не проверял базовый каталог при запуске, и такая ошибка конфигурации вместо этого приводила к сбою сессий после их принятия.846* **Runner завершается при запуске с `cannot create or write to base directory`**: runner не может создать `--base-dir` или записать в него; по умолчанию это `/workspace`. Исправьте владельца каталога или укажите в `--base-dir` путь, доступный для записи, как описано в разделе [Сохраняйте одинаковые базовый каталог и ёмкость на всех runner'ах](#keep-the-base-directory-and-capacity-identical-across-runners). Если вместо этого runner записывает в лог `[runner:fatal]` с сообщением о том, что истёк таймаут проверки базового каталога, каталог находится на зависшем монтировании NFS или CSI. Проверьте работоспособность монтирования, а не права доступа. Runner выводит оба этих сбоя запуска в stderr до того, как откроет `--log-file`, поэтому ищите их в терминале или в логах контейнеров вашей платформы, а не в файле лога. До v2.1.225 runner не проверял базовый каталог при запуске, и такая ошибка конфигурации вместо этого приводила к сбою сессий после их принятия.

838* **Runner завершается при запуске с `RegisterRunner failed:` и ошибкой TLS-сертификата**: например, ошибка может быть `self signed certificate in certificate chain`. Runner не доверяет центру сертификации (CA), выпустившему полученный сертификат, как бывает за прокси с инспекцией TLS. Задайте в окружении runner'а переменную [`NODE_EXTRA_CA_CERTS`](https://code.claude.com/docs/ru/network-config#custom-ca-certificates) с путём к PEM-файлу, содержащему корневой CA прокси.847* **Runner завершается при запуске с `RegisterRunner failed:` и ошибкой TLS-сертификата**: например, ошибка может быть `self signed certificate in certificate chain`. Runner не доверяет центру сертификации (CA), выпустившему полученный сертификат, как бывает за прокси с инспекцией TLS. Задайте в окружении runner'а переменную [`NODE_EXTRA_CA_CERTS`](https://code.claude.com/docs/ru/network-config#custom-ca-certificates) с путём к PEM-файлу, содержащему корневой CA прокси.

839 848 

840 Для сессий её не нужно задавать повторно — они её наследуют. Git её не читает: для клонирования через этот прокси также задайте [`GIT_SSL_CAINFO`](#trust-a-private-certificate-authority-with-anthropic-managed-git).849 Для сессий её не нужно задавать повторно — они её наследуют. Git её не читает: для клонирования через этот прокси также задайте [`GIT_SSL_CAINFO`](#trust-a-private-certificate-authority-with-anthropic-managed-git).

841* **Ваш стартовый скрипт выводит ошибку записи, содержащую `Resource temporarily unavailable`, и завершается**: ваш скрипт делит stdout или stderr с запускаемым им процессом `claude self-hosted-runner` или [оркестратора](https://code.claude.com/docs/ru/self-hosted-environments-configuration.md#on-demand-runners), который переключил этот общий канал или сокет в неблокирующий режим. Когда канал заполнен, запись из вашего скрипта вместо ожидания завершается этой ошибкой операционной системы, и при `set -e` скрипт завершается.850* **Ваш стартовый скрипт выводит ошибку записи, содержащую `Resource temporarily unavailable`, и завершается**: ваш скрипт делит stdout или stderr с запускаемым им процессом `claude self-hosted-runner` или [оркестратора](https://code.claude.com/docs/ru/self-hosted-environments-configuration.md#on-demand-runners), который переключил этот общий канал или сокет в неблокирующий режим. Когда канал заполнен, запись из вашего скрипта вместо ожидания завершается этой ошибкой операционной системы, и при `set -e` скрипт завершается.

842 851 

843 Чтобы устранить ошибку, направьте вывод runner'а или оркестратора в файл, который может создать пользователь вашего скрипта. Добавьте `>> "$HOME/claude-runner.log" 2>&1` к команде, которая его запускает, перед любым `&`, переводящим её в фоновый режим:852 Чтобы устранить ошибку, направьте вывод runner'а или оркестратора в файл, который может создать пользователь вашего скрипта. Добавьте `>> "$HOME/claude-runner.log" 2>&1` к команде, которая его запускает, перед любым `&`, переводящим её в фоновый режим, и замените `<writable-dir>`, как описано в разделе [быстрого старта](https://code.claude.com/docs/ru/self-hosted-environments-quickstart.md#set-up-manually):

844 853 

845 ```bash theme={null}854 ```bash theme={null}

846 claude self-hosted-runner --environment-secret-file /etc/claude/environment-secret >> "$HOME/claude-runner.log" 2>&1855 claude self-hosted-runner --environment-secret-file /etc/claude/environment-secret --base-dir '<writable-dir>' >> "$HOME/claude-runner.log" 2>&1

847 ```856 ```

848 857 

849 Собственный вывод вашего скрипта по-прежнему идёт туда же, куда и раньше, а то, что runner пишет в stdout и stderr, включая ошибки запуска, попадает в этот файл. Используйте это перенаправление оболочки, а не только [`--log-file`](https://code.claude.com/docs/ru/self-hosted-environments-reference#runner-cli-flags), который дублирует лог в файл, пока runner продолжает писать в stdout и stderr. Если вы уже передаёте `--log-file`, сохраните и его, поскольку перенаправление не меняет того, что попадает в этот файл.858 Собственный вывод вашего скрипта по-прежнему идёт туда же, куда и раньше, а то, что runner пишет в stdout и stderr, включая ошибки запуска, попадает в этот файл. Используйте это перенаправление оболочки, а не только [`--log-file`](https://code.claude.com/docs/ru/self-hosted-environments-reference#runner-cli-flags), который дублирует лог в файл, пока runner продолжает писать в stdout и stderr. Если вы уже передаёте `--log-file`, сохраните и его, поскольку перенаправление не меняет того, что попадает в этот файл.


901 До v2.1.274 runner прекращал повторные попытки получения токена после нескольких неудач и ждал следующего запланированного получения. Неудавшийся ход не вызывал получение токена, поэтому каждый ход завершался ошибкой 401 до следующего запланированного получения.910 До v2.1.274 runner прекращал повторные попытки получения токена после нескольких неудач и ждал следующего запланированного получения. Неудавшийся ход не вызывал получение токена, поэтому каждый ход завершался ошибкой 401 до следующего запланированного получения.

902* **Ход завершается в claude.ai/code с `This model needs a newer version of Claude Code`**: версия Claude Code, с которой ваши runner'ы запускают сессии, старше, чем требует модель сессии, поэтому API [отклоняет запрос](https://code.claude.com/docs/ru/errors.md#claude-code-does-not-support-this-model). Обновите runner'ы до версии, указанной в сообщении, или более поздней, как описано в разделе [Закрепите версию](#pin-the-version). До этого пользователи могут выбрать в сессии другую модель.911* **Ход завершается в claude.ai/code с `This model needs a newer version of Claude Code`**: версия Claude Code, с которой ваши runner'ы запускают сессии, старше, чем требует модель сессии, поэтому API [отклоняет запрос](https://code.claude.com/docs/ru/errors.md#claude-code-does-not-support-this-model). Обновите runner'ы до версии, указанной в сообщении, или более поздней, как описано в разделе [Закрепите версию](#pin-the-version). До этого пользователи могут выбрать в сессии другую модель.

903* **Под завершается принудительно во время drain**: увеличьте `terminationGracePeriodSeconds` как минимум до значения, которое runner записывает в лог при запуске. См. [Время завершения работы](#shutdown-timing).912* **Под завершается принудительно во время drain**: увеличьте `terminationGracePeriodSeconds` как минимум до значения, которое runner записывает в лог при запуске. См. [Время завершения работы](#shutdown-timing).

913* **Runner записывает в лог строку `[runner:log]`, заканчивающуюся на `was paused or too slow`**: runner продолжил работу, и перезапуск не требуется. Пока поток stdout или stderr, названный в строке, снова не начали читать, runner отбрасывал все строки этого потока, кроме последних 256 КиБ. Если вы передали [`--log-file`](https://code.claude.com/docs/ru/self-hosted-environments-reference#runner-cli-flags), ищите отброшенные строки там.

914* **Runner записывает в лог `Nobody can read this process's stdout anymore`**: то, что читало stdout runner'а, больше не существует, поэтому runner прекращает писать туда до конца своей работы и продолжает работать. Пока stderr остаётся открытым, эта строка и последующие строки состояния runner'а, включая строки `[runner:fatal]`, идут в stderr, поэтому читайте их там.

904 915 

905После инициализации логирования runner пишет свой лог жизненного цикла, включая строки `[runner:fatal]`, в stdout, а отладочный вывод — в stderr, всё в виде строк простого текста, а не JSON. Сбои базового каталога, описанные в пунктах выше, выводятся в stderr до этого момента. Сохраняйте оба потока с помощью `--log-file`, что также позволяет `self-hosted-runner doctor` отслеживать их, или с помощью средств сбора логов вашей платформы.916После инициализации логирования runner пишет свой лог жизненного цикла, включая строки `[runner:fatal]`, в stdout, а отладочный вывод — в stderr, всё в виде строк простого текста, а не JSON. Сбои базового каталога, описанные в пунктах выше, выводятся в stderr до этого момента. Сохраняйте оба потока с помощью `--log-file`, что также позволяет `self-hosted-runner doctor` отслеживать их, или с помощью средств сбора логов вашей платформы.

906 917 

Details

29 29 

30* Хост или контейнер Linux или macOS с исходящим HTTPS к `api.anthropic.com`, к `claude.ai` и хостам загрузки, на которые он перенаправляет для шага установки ниже, и к вашему git-хосту для клонирования; [таблица требований к сети](https://code.claude.com/docs/ru/self-hosted-environments-deploy.md#network-requirements) содержит полный список. Windows не поддерживается в качестве хоста runner; запустите runner в контейнере Linux вместо этого. Рабочие станции разработчиков не затронуты, так как сеансы запускаются из claude.ai в браузере.30* Хост или контейнер Linux или macOS с исходящим HTTPS к `api.anthropic.com`, к `claude.ai` и хостам загрузки, на которые он перенаправляет для шага установки ниже, и к вашему git-хосту для клонирования; [таблица требований к сети](https://code.claude.com/docs/ru/self-hosted-environments-deploy.md#network-requirements) содержит полный список. Windows не поддерживается в качестве хоста runner; запустите runner в контейнере Linux вместо этого. Рабочие станции разработчиков не затронуты, так как сеансы запускаются из claude.ai в браузере.

31* Репозиторий для тестовой сессии: публичный или такой, который этот хост уже может клонировать по его HTTPS URL без запроса учётных данных. Одного SSH-ключа недостаточно, поскольку runner клонирует `https://` URL репозитория. Чтобы вместо этого клонировать по SSH, см. [Rewrite git URLs for private networks](https://code.claude.com/docs/ru/self-hosted-environments-deploy.md#rewrite-git-urls-for-private-networks).31* Репозиторий для тестовой сессии: публичный или такой, который этот хост уже может клонировать по его HTTPS URL без запроса учётных данных. Одного SSH-ключа недостаточно, поскольку runner клонирует `https://` URL репозитория. Чтобы вместо этого клонировать по SSH, см. [Rewrite git URLs for private networks](https://code.claude.com/docs/ru/self-hosted-environments-deploy.md#rewrite-git-urls-for-private-networks).

32* Часы, синхронизированные с реальным временем, например с помощью NTP. Аутентификация не удаётся, когда часы отстают или спешат более чем на пять минут; см. [Troubleshooting](https://code.claude.com/docs/ru/self-hosted-environments-deploy.md#troubleshooting).32* Часы, синхронизированные с реальным временем, например с помощью NTP.

33 33 

34### Программное обеспечение на хосте runner34### Программное обеспечение на хосте runner

35 35 

Details

33| `--drain-wait-sec <n>` | `SELF_HOSTED_RUNNER_DRAIN_WAIT_MS` | `0` | После начала осушения, которое происходит на `SIGTERM`, если вы не установили [`--defer-shutdown-max-min`](https://code.claude.com/docs/ru/self-hosted-environments-deploy#defer-the-drain-past-the-first-signal), ждите до N секунд для завершения текущего хода каждого сеанса и фоновых задач перед завершением дочернего процесса. Во время этого ожидания runner считает фоновую задачу, которая только что завершилась, все еще работающей до тех пор, пока не начнется следующий ход, который читает её результат, в течение максимум окна [`SELF_HOSTED_RUNNER_BG_RESULT_GRACE_MS`](#environment-variable-only-settings). [Также повысьте таймаут остановки](https://code.claude.com/docs/ru/self-hosted-environments-deploy.md#let-running-turns-finish-before-a-restart). |33| `--drain-wait-sec <n>` | `SELF_HOSTED_RUNNER_DRAIN_WAIT_MS` | `0` | После начала осушения, которое происходит на `SIGTERM`, если вы не установили [`--defer-shutdown-max-min`](https://code.claude.com/docs/ru/self-hosted-environments-deploy#defer-the-drain-past-the-first-signal), ждите до N секунд для завершения текущего хода каждого сеанса и фоновых задач перед завершением дочернего процесса. Во время этого ожидания runner считает фоновую задачу, которая только что завершилась, все еще работающей до тех пор, пока не начнется следующий ход, который читает её результат, в течение максимум окна [`SELF_HOSTED_RUNNER_BG_RESULT_GRACE_MS`](#environment-variable-only-settings). [Также повысьте таймаут остановки](https://code.claude.com/docs/ru/self-hosted-environments-deploy.md#let-running-turns-finish-before-a-restart). |

34| `--environment-secret-file <path>` | `SELF_HOSTED_RUNNER_ENVIRONMENT_SECRET` | required | Путь к файлу, содержащему секрет среды, или, для runner, порожденных [orchestrator](https://code.claude.com/docs/ru/self-hosted-environments-configuration.md#on-demand-runners), одноразовый JWT работного заказа. `SELF_HOSTED_RUNNER_ENVIRONMENT_SECRET` несет значение секрета напрямую, а не путь к файлу. Старый флаг `--pool-secret-file` и переменная `SELF_HOSTED_RUNNER_POOL_SECRET` по-прежнему работают и выводят уведомление об устаревании в stderr; сборки runner программы предварительного просмотра старше 2.1.216 распознают только эти старые имена. |34| `--environment-secret-file <path>` | `SELF_HOSTED_RUNNER_ENVIRONMENT_SECRET` | required | Путь к файлу, содержащему секрет среды, или, для runner, порожденных [orchestrator](https://code.claude.com/docs/ru/self-hosted-environments-configuration.md#on-demand-runners), одноразовый JWT работного заказа. `SELF_HOSTED_RUNNER_ENVIRONMENT_SECRET` несет значение секрета напрямую, а не путь к файлу. Старый флаг `--pool-secret-file` и переменная `SELF_HOSTED_RUNNER_POOL_SECRET` по-прежнему работают и выводят уведомление об устаревании в stderr; сборки runner программы предварительного просмотра старше 2.1.216 распознают только эти старые имена. |

35| `--exec-path <path>` | `SELF_HOSTED_RUNNER_EXEC_PATH` | собственный бинарный файл | Бинарный файл или скрипт-обертка для порождения для каждого сеанса. См. [Wrapper scripts](https://code.claude.com/docs/ru/self-hosted-environments-configuration.md#wrapper-scripts). |35| `--exec-path <path>` | `SELF_HOSTED_RUNNER_EXEC_PATH` | собственный бинарный файл | Бинарный файл или скрипт-обертка для порождения для каждого сеанса. См. [Wrapper scripts](https://code.claude.com/docs/ru/self-hosted-environments-configuration.md#wrapper-scripts). |

36| `--exit-if-unused-min <n>` | `SELF_HOSTED_RUNNER_IDLE_SHUTDOWN_MS` | `0` | Выйдите после N минут опроса без назначенной работы, для масштабирования автомасштабера. `0` отключает. |36| `--exit-if-unused-min <n>` | `SELF_HOSTED_RUNNER_IDLE_SHUTDOWN_MS` | `0` | Выйдите после N минут опроса, если работа так ни разу и не была назначена, для уменьшения масштаба при автомасштабировании. `0` отключает. |

37| `--git-host-rewrite <from>=<to>` | none | unset | Переписать URL источников `https://<from>/...` на `https://<to>/...` перед клонированием для разделенного DNS горизонта. Повторяемо; только флаг. |37| `--git-host-rewrite <from>=<to>` | none | unset | Переписать URL источников `https://<from>/...` на `https://<to>/...` перед клонированием для разделенного DNS горизонта. Повторяемо; только флаг. |

38| `--git-ssh-rewrite <host>` | none | unset | Переписать URL источников `https://<host>/...` на `git@<host>:...` перед клонированием для хостов git только с SSH. Повторяемо; только флаг. |38| `--git-ssh-rewrite <host>` | none | unset | Переписать URL источников `https://<host>/...` на `git@<host>:...` перед клонированием для хостов git только с SSH. Повторяемо; только флаг. |

39| `--health-port <port>` | `SELF_HOSTED_RUNNER_HEALTH_PORT` | `8080` | Порт для слушателя `/healthz` и `/metrics`. Установите `0` для отключения. |39| `--health-port <port>` | `SELF_HOSTED_RUNNER_HEALTH_PORT` | `8080` | Порт для слушателя `/healthz` и `/metrics`. Установите `0` для отключения. |


95| `--hook-timeout <sec>` | `60` | Завершите дерево процессов hook после этого количества секунд. Timeout плюс его 5-секундная благодать убийства должны оставаться ниже `--expected-spawn-seconds`; orchestrator обеспечивает это при запуске. |95| `--hook-timeout <sec>` | `60` | Завершите дерево процессов hook после этого количества секунд. Timeout плюс его 5-секундная благодать убийства должны оставаться ниже `--expected-spawn-seconds`; orchestrator обеспечивает это при запуске. |

96| `--expected-spawn-seconds <sec>` | `120` | Ожидаемое время p99 с момента получения orchestrator запроса на порождение до регистрации runner, включая любое ожидание свободных ресурсов на вашей платформе. Сервер допускает диапазон от 10 до 3600. Отправляется при каждом опросе как аренда на стороне сервера: если ни один runner не зарегистрируется до её истечения, сессия предлагается повторно с новым ID заказа. Все реплики должны использовать одно и то же значение. |96| `--expected-spawn-seconds <sec>` | `120` | Ожидаемое время p99 с момента получения orchestrator запроса на порождение до регистрации runner, включая любое ожидание свободных ресурсов на вашей платформе. Сервер допускает диапазон от 10 до 3600. Отправляется при каждом опросе как аренда на стороне сервера: если ни один runner не зарегистрируется до её истечения, сессия предлагается повторно с новым ID заказа. Все реплики должны использовать одно и то же значение. |

97| `--min-idle <n>` | `0` | Держите по крайней мере N свободных слотов сеанса в режиме ожидания, активно порождая резервные runner. `0` отключает предварительное прогревание. Объедините с `--exit-if-unused-min` runner, чтобы избыточные резервные runner восстановили себя. |97| `--min-idle <n>` | `0` | Держите по крайней мере N свободных слотов сеанса в режиме ожидания, активно порождая резервные runner. `0` отключает предварительное прогревание. Объедините с `--exit-if-unused-min` runner, чтобы избыточные резервные runner восстановили себя. |

98| `--shutdown-drain-sec <n>` | `0` | При получении `SIGTERM` прекратить опрос запросов на порождение и дать запущенным хукам `spawn-runner` и любому опросу, ещё не получившему ответа, до указанного числа секунд на завершение, после чего остановить всё оставшееся. При `0` остановка происходит немедленно. Максимум `3600`, что orchestrator проверяет при запуске. Чтобы выбрать значение, см. [Подбор `--shutdown-drain-sec` и таймаута остановки orchestrator](https://code.claude.com/docs/ru/self-hosted-environments-configuration#size-shutdown-drain-sec-and-the-supervisors-stop-timeout-for-the-orchestrator). Требуется Claude Code v2.1.299 или новее. |

98| `--debug-dir <path>` | unset | Запишите рабочий заказ каждого запроса на порождение и stderr hook на диск. Только для отладки; никогда не устанавливайте в production. |99| `--debug-dir <path>` | unset | Запишите рабочий заказ каждого запроса на порождение и stderr hook на диск. Только для отладки; никогда не устанавливайте в production. |

99 100 

100### Флаги SCM connector101### Флаги SCM connector

Details

154 * **Единица телеметрии**: ключи экспортера `OTEL_EXPORTER_OTLP_*`, переключатели захвата содержимого `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` и бета-переменные трассировки `ENABLE_BETA_TRACING_DETAILED` и `BETA_TRACING_ENDPOINT` следуют источнику с наивысшим приоритетом, который устанавливает любой из них как единицу. Источник, который доставляет ключ учетных данных `otelHeadersHelper`, также претендует на единицу, но размещает эти переменные только когда он является выбранным источником: источник, который не выбран, но доставляет ключ, не вносит ни один из них и все еще блокирует более низкие источники от их заполнения. В любом случае конечная точка экспортера из одного источника никогда не может быть связана с учетными данными из другого.154 * **Единица телеметрии**: ключи экспортера `OTEL_EXPORTER_OTLP_*`, переключатели захвата содержимого `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` и бета-переменные трассировки `ENABLE_BETA_TRACING_DETAILED` и `BETA_TRACING_ENDPOINT` следуют источнику с наивысшим приоритетом, который устанавливает любой из них как единицу. Источник, который доставляет ключ учетных данных `otelHeadersHelper`, также претендует на единицу, но размещает эти переменные только когда он является выбранным источником: источник, который не выбран, но доставляет ключ, не вносит ни один из них и все еще блокирует более низкие источники от их заполнения. В любом случае конечная точка экспортера из одного источника никогда не может быть связана с учетными данными из другого.

155 * **Маршрутизация с привязкой к учетным данным**: источник, который связывает переменные маршрутизации с ключом учетных данных, доступным только для выбранного источника, такой как `apiKeyHelper` или `otelHeadersHelper`, вносит эти переменные маршрутизации только когда он выигрывает слот.155 * **Маршрутизация с привязкой к учетным данным**: источник, который связывает переменные маршрутизации с ключом учетных данных, доступным только для выбранного источника, такой как `apiKeyHelper` или `otelHeadersHelper`, вносит эти переменные маршрутизации только когда он выигрывает слот.

156* **`allowedProviders`**: список, установленный на машине, и список, управляемый сервером, объединяются как [указано в примечании Scope этой записи](https://code.claude.com/docs/ru/settings-reference.md#allowedproviders). Требуется Claude Code v2.1.285 или более поздняя версия156* **`allowedProviders`**: список, установленный на машине, и список, управляемый сервером, объединяются как [указано в примечании Scope этой записи](https://code.claude.com/docs/ru/settings-reference.md#allowedproviders). Требуется Claude Code v2.1.285 или более поздняя версия

157* **Ключи собственного входа**: [`forceLoginOrgUUID`](https://code.claude.com/docs/ru/settings-reference#forceloginorguuid) и значения `"claudeai"` и `"console"` для [`forceLoginMethod`](https://code.claude.com/docs/ru/settings-reference#forceloginmethod). Если вы также развёртываете политику MDM или файл управляемых настроек, задавайте их и там, и в управляемых сервером настройках на claude.ai, пока на всех клиентах не будет v2.1.299 или новее. О том, где задавать эти ключи после этого и значение какого источника применяется, см. в разделе [Какой управляемый источник предоставляет ключи входа](https://code.claude.com/docs/ru/managed-settings.md#which-managed-source-supplies-login-keys).

157* **Ключи входа в шлюз**: Claude Code никогда не читает [`forceLoginGatewayUrl`](https://code.claude.com/docs/ru/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](https://code.claude.com/docs/ru/settings-reference#gatewayinternalnetworks) или значение `"gateway"` [`forceLoginMethod`](https://code.claude.com/docs/ru/settings-reference#forceloginmethod) из управляемых сервером параметров, поэтому значение там ни не применяется, ни не скрывает значение, установленное в политике MDM или файле управляемых параметров. Запись [`managedSourcesBehavior`](https://code.claude.com/docs/ru/settings-reference#managedsourcesbehavior) указывает, какой источник администратора на машине их предоставляет.158* **Ключи входа в шлюз**: Claude Code никогда не читает [`forceLoginGatewayUrl`](https://code.claude.com/docs/ru/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](https://code.claude.com/docs/ru/settings-reference#gatewayinternalnetworks) или значение `"gateway"` [`forceLoginMethod`](https://code.claude.com/docs/ru/settings-reference#forceloginmethod) из управляемых сервером параметров, поэтому значение там ни не применяется, ни не скрывает значение, установленное в политике MDM или файле управляемых параметров. Запись [`managedSourcesBehavior`](https://code.claude.com/docs/ru/settings-reference#managedsourcesbehavior) указывает, какой источник администратора на машине их предоставляет.

158 159 

159### Поведение выборки и кэширования160### Поведение выборки и кэширования

sessions.md +1 −1

Details

257| - | - | - |257| - | - | - |

258| Переместить хранилище с `~/.claude` | [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ru/env-vars) | Переменная окружения |258| Переместить хранилище с `~/.claude` | [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ru/env-vars) | Переменная окружения |

259| [Назвать каталог `<project>` самостоятельно](#name-the-project-directory-yourself) | [`CLAUDE_CODE_PROJECT_DIR_NAME`](https://code.claude.com/docs/ru/env-vars) | Переменная окружения |259| [Назвать каталог `<project>` самостоятельно](#name-the-project-directory-yourself) | [`CLAUDE_CODE_PROJECT_DIR_NAME`](https://code.claude.com/docs/ru/env-vars) | Переменная окружения |

260| Изменить сохранение на 30 дней | [`cleanupPeriodDays`](https://code.claude.com/docs/ru/settings-reference#cleanupperioddays) | `settings.json` |260| Изменить 30-дневный срок хранения | [`cleanupPeriodDays`](https://code.claude.com/docs/ru/settings-reference#cleanupperioddays) | `settings.json` |

261| Установить ограничение по возрасту для [стенограмм Claude Desktop и Cowork](https://code.claude.com/docs/ru/claude-directory.md#cleaned-up-automatically) | [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/ru/settings-reference#desktopsessioncleanupperioddays) | Пользовательские параметры, управляемые параметры или `--settings` |261| Установить ограничение по возрасту для [стенограмм Claude Desktop и Cowork](https://code.claude.com/docs/ru/claude-directory.md#cleaned-up-automatically) | [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/ru/settings-reference#desktopsessioncleanupperioddays) | Пользовательские параметры, управляемые параметры или `--settings` |

262| Ограничить рост размера файла транскрипта сессии `-p` или Agent SDK | [`CLAUDE_CODE_TRANSCRIPT_LOCAL_GC`](https://code.claude.com/docs/ru/env-vars) | Переменная окружения |262| Ограничить рост размера файла транскрипта сессии `-p` или Agent SDK | [`CLAUDE_CODE_TRANSCRIPT_LOCAL_GC`](https://code.claude.com/docs/ru/env-vars) | Переменная окружения |

263| Подавить запись стенограмм во всех режимах | [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](https://code.claude.com/docs/ru/env-vars) | Переменная окружения |263| Подавить запись стенограмм во всех режимах | [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](https://code.claude.com/docs/ru/env-vars) | Переменная окружения |

Details

2424 2424 

2425Сжатие в режиме простоя включено по умолчанию для диалогов, которые соответствуют всем следующим условиям:2425Сжатие в режиме простоя включено по умолчанию для диалогов, которые соответствуют всем следующим условиям:

2426 2426 

2427* **Сессия**: вы находитесь в интерактивной сессии терминала либо в панели чата расширения VS Code или на вкладке Code настольного приложения с [учётной записью, которую выбирает Anthropic](#idle-compaction-in-vs-code-and-the-desktop-app)2427* **Сессия**: вы находитесь в интерактивной сессии терминала, в панели чата расширения VS Code или на вкладке Code настольного приложения, если сессия выполняется на вашем компьютере или через SSH

2428* **Автосжатие**: [`autoCompactEnabled`](#autocompactenabled) включён2428* **Автосжатие**: [`autoCompactEnabled`](#autocompactenabled) включён

2429* **Кэш промптов**: диалог использует [часовой TTL кэша промптов](https://code.claude.com/docs/ru/prompt-caching.md#which-ttl-each-request-gets)2429* **Кэш промптов**: диалог использует [часовой TTL кэша промптов](https://code.claude.com/docs/ru/prompt-caching.md#which-ttl-each-request-gets)

2430* **Флаги функций**: Claude Code может [получать флаги функций от Anthropic](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching)2430* **Флаги функций**: Claude Code может [получать флаги функций от Anthropic](https://code.claude.com/docs/ru/env-vars.md#features-that-need-feature-flag-fetching)

2431* **Размер**: контекст диалога достиг порога токенов, который вы можете [изменить](#change-the-idle-compaction-threshold) со значения по умолчанию 200 0002431* **Размер**: контекст диалога достиг порога токенов, который вы можете [изменить](#change-the-idle-compaction-threshold) со значения по умолчанию 200 000

2432* **Время простоя**: с момента последнего запроса прошло около 54 минут, и в этот момент ваш компьютер не находится в спящем режиме2432* **Время простоя**: с момента последнего запроса прошло около часа, и до этого момента ваш компьютер не переходит в спящий режим

2433 2433 

2434Чтобы отключить сжатие в режиме простоя, установите этот ключ в `false`.2434Чтобы отключить сжатие в режиме простоя, установите этот ключ в `false`.

2435 2435 


2475Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json2475Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json

2476```2476```

2477 2477 

2478Вам не нужно ничего делать. Чтобы отключить сжатие в режиме простоя, установите `idleCompaction` в `false` в `~/.claude/settings.json` или другом [файле настроек](https://code.claude.com/docs/ru/settings.md#settings-files-and-who-they-affect).2478Вам не нужно ничего делать. Чтобы отключить сжатие в режиме простоя, установите `idleCompaction` в `false` в `~/.claude/settings.json` на компьютере или в дистрибутиве WSL, где выполняется сессия, или в другом [файле настроек](https://code.claude.com/docs/ru/settings.md#settings-files-and-who-they-affect).

2479 

2480В панели чата расширения VS Code и на вкладке Code настольного приложения сжатие в режиме простоя выполняется для учётных записей, которые выбирает Anthropic. Claude Code составляет сводку, пока вас нет, а затем выполняет с её помощью сжатие, только если ваше следующее сообщение приходит через час или более после последнего запроса.

2481 2479 

2482### `plansDirectory`2480### `plansDirectory`

2483 2481 


5173 5171 

5174### `forceLoginMethod`5172### `forceLoginMethod`

5175 5173 

5176Ограничьте, с каким типом учётной записи люди могут входить. Установите `"claudeai"`, чтобы разрешить только учётные записи claude.ai, `"console"`, чтобы разрешить только учётные записи Claude Console, или `"gateway"`, чтобы направлять людей на [облачный шлюз](https://code.claude.com/docs/ru/claude-apps-gateway) вместо входа первой стороны. Администраторы устанавливают это в управляемых настройках и сочетают с [`forceLoginOrgUUID`](#forceloginorguuid), чтобы входы разработчиков в claude.ai оставались внутри одной организации. Если вы установите значение `"claudeai"` или `"console"` в любом файле настроек, Claude Code также перестаёт предлагать [вход в Console без ключа](https://code.claude.com/docs/ru/authentication.md#sign-in-without-an-api-key) в сессиях, к которым применяется этот файл.5174Ограничьте, с каким типом учётной записи люди могут входить. Установите `"claudeai"`, чтобы разрешить только учётные записи claude.ai, `"console"`, чтобы разрешить только учётные записи Claude Console, или `"gateway"`, чтобы направлять людей на [облачный шлюз](https://code.claude.com/docs/ru/claude-apps-gateway) вместо входа первой стороны. Администраторы устанавливают это в управляемых настройках и сочетают с [`forceLoginOrgUUID`](#forceloginorguuid), чтобы входы разработчиков в claude.ai оставались внутри одной организации.

5175 

5176Если вы установите значение `"claudeai"` в любом файле настроек, Claude Code также перестаёт предлагать [вход в Console без ключа](https://code.claude.com/docs/ru/authentication.md#sign-in-without-an-api-key) в сессиях, к которым применяется этот файл. Если установлено только `"console"`, люди по-прежнему могут перейти ко входу без ключа после неудачной попытки входа. Чтобы Claude Code перестал его предлагать, см. [Прекращение предложения входа без ключа на управляемых машинах](https://code.claude.com/docs/ru/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines), где также перечислено, что ещё изменяет `forceLoginOrgUUID`.

5177 5177 

5178* **Scope**: [`Any file`](#scopes). Claude Code учитывает `"gateway"` из тех же источников, что и [`forceLoginGatewayUrl`](#forcelogingatewayurl), и рассматривает его как неустановленное значение во всех остальных.5178* **Scope**: [`Any file`](#scopes). Claude Code учитывает `"gateway"` из тех же источников, что и [`forceLoginGatewayUrl`](#forcelogingatewayurl), и рассматривает его как неустановленное значение во всех остальных.

5179* **Type**: строка, одно из значений:5179* **Type**: строка, одно из значений:


5585| Списки разрешённых значений для ограничений | Берёт список целиком из самого приоритетного источника, который его задаёт, не добавляя записи из нижестоящих источников. Если самый приоритетный источник его не задаёт, берёт его целиком из следующего источника ниже | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`allowedProviders`](#allowedproviders), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins) и цепочка [`fallbackModel`](#fallbackmodel) |5585| Списки разрешённых значений для ограничений | Берёт список целиком из самого приоритетного источника, который его задаёт, не добавляя записи из нижестоящих источников. Если самый приоритетный источник его не задаёт, берёт его целиком из следующего источника ниже | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`allowedProviders`](#allowedproviders), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins) и цепочка [`fallbackModel`](#fallbackmodel) |

5586| Значения, берущиеся целиком | Берёт значение целиком из самого приоритетного источника, который его задаёт, не объединяя записи или поля из нижестоящих источников. Если самый приоритетный источник его не задаёт, берёт его целиком из следующего источника ниже | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) |5586| Значения, берущиеся целиком | Берёт значение целиком из самого приоритетного источника, который его задаёт, не объединяя записи или поля из нижестоящих источников. Если самый приоритетный источник его не задаёт, берёт его целиком из следующего источника ниже | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) |

5587| Предоставляемые MCP-серверы | Объединяет имена серверов из всех источников. Если два источника задают одинаковое имя, применяет запись из вышестоящего источника целиком | [`managedMcpServers`](#managedmcpservers) |5587| Предоставляемые MCP-серверы | Объединяет имена серверов из всех источников. Если два источника задают одинаковое имя, применяет запись из вышестоящего источника целиком | [`managedMcpServers`](#managedmcpservers) |

5588| Чтение только из источника с наивысшим приоритетом | Читает ключ только из источника с наивысшим приоритетом, содержащего ключ политики, поэтому значение нижестоящего источника игнорируется, даже если самый приоритетный источник не задаёт никакого значения | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`forceLoginOrgUUID`](#forceloginorguuid), значения `"claudeai"` и `"console"` ключа [`forceLoginMethod`](#forceloginmethod), [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) |5588| Чтение только из источника с наивысшим приоритетом | Читает ключ только из источника с наивысшим приоритетом, содержащего ключ политики, поэтому значение нижестоящего источника игнорируется, даже если самый приоритетный источник не задаёт никакого значения | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) |

5589| `env` | [Объединяется по отдельным переменным во всех источниках администратора](https://code.claude.com/docs/ru/managed-settings.md#keys-read-from-every-admin-source) как при `"first-wins"`, так и при `"merge"` | [`env`](#env) |5589| `env` | [Объединяется по отдельным переменным во всех источниках администратора](https://code.claude.com/docs/ru/managed-settings.md#keys-read-from-every-admin-source) как при `"first-wins"`, так и при `"merge"` | [`env`](#env) |

5590| Все остальные ключи | Берёт значение из самого приоритетного источника, который его задаёт | [`cleanupPeriodDays`](#cleanupperioddays), [`model`](#model) |5590| Все остальные ключи | Берёт значение из самого приоритетного источника, который его задаёт | [`cleanupPeriodDays`](#cleanupperioddays), [`model`](#model) |

5591 5591 


5596* **[`policyHelper`](#policyhelper)**: Claude Code учитывает его, только если самый приоритетный источник, содержащий ключ политики, — это политика MDM или файл управляемых настроек, поэтому при настройках, управляемых сервером, он не применяется.5596* **[`policyHelper`](#policyhelper)**: Claude Code учитывает его, только если самый приоритетный источник, содержащий ключ политики, — это политика MDM или файл управляемых настроек, поэтому при настройках, управляемых сервером, он не применяется.

5597* **[`modelOverrides`](#modeloverrides)**: работает в паре с `availableModels`. Claude Code берёт `modelOverrides` из самого приоритетного источника, который его задаёт, если только вышестоящий источник не задаёт `availableModels` без `modelOverrides`. В этом случае он игнорирует `modelOverrides` из всех источников.5597* **[`modelOverrides`](#modeloverrides)**: работает в паре с `availableModels`. Claude Code берёт `modelOverrides` из самого приоритетного источника, который его задаёт, если только вышестоящий источник не задаёт `availableModels` без `modelOverrides`. В этом случае он игнорирует `modelOverrides` из всех источников.

5598* **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks) и значение `"gateway"` ключа [`forceLoginMethod`](#forceloginmethod)**: Claude Code никогда не читает ни один из них из настроек, управляемых сервером, поэтому значение там не применяется и не скрывает значение, заданное в политике MDM или файле управляемых настроек. Из источников администратора на компьютере их предоставляет только самый высокий по рангу источник, содержащий ключ политики, независимо от того, присутствуют ли также настройки, управляемые сервером.5598* **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks) и значение `"gateway"` ключа [`forceLoginMethod`](#forceloginmethod)**: Claude Code никогда не читает ни один из них из настроек, управляемых сервером, поэтому значение там не применяется и не скрывает значение, заданное в политике MDM или файле управляемых настроек. Из источников администратора на компьютере их предоставляет только самый высокий по рангу источник, содержащий ключ политики, независимо от того, присутствуют ли также настройки, управляемые сервером.

5599* **[`forceLoginOrgUUID`](#forceloginorguuid) и значения `"claudeai"` и `"console"` ключа [`forceLoginMethod`](#forceloginmethod)**: какое значение применяется, смотрите в разделе [Какой управляемый источник предоставляет ключи входа](https://code.claude.com/docs/ru/managed-settings.md#which-managed-source-supplies-login-keys), а не в таблице.

5599* **[`allowedProviders`](#allowedproviders)**: после применения правила из таблицы результат по-прежнему ограничивается собственным списком компьютера, как указано в примечании об области действия в описании этого ключа.5600* **[`allowedProviders`](#allowedproviders)**: после применения правила из таблицы результат по-прежнему ограничивается собственным списком компьютера, как указано в примечании об области действия в описании этого ключа.

5600 5601 

5601Чтобы проверить, какие источники были объединены на компьютере, выполните `/status` и [посмотрите строку `Setting sources`](https://code.claude.com/docs/ru/managed-settings#read-the-source-in-/status).5602Чтобы проверить, какие источники были объединены на компьютере, выполните `/status` и [посмотрите строку `Setting sources`](https://code.claude.com/docs/ru/managed-settings#read-the-source-in-/status).

skills.md +10 −3

Details

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

396| :- | :- | :- |396| :- | :- | :- |

397| `name` | Нет | Имя команды, показываемое в меню `/`. По умолчанию используется имя каталога. См. [Как skill получает имя команды](#how-a-skill-gets-its-command-name), чтобы узнать, как это поле взаимодействует с именем, которое вы вводите для вызова skill. |397| `name` | Нет | Имя команды, показываемое в меню `/`. По умолчанию используется имя каталога. См. [Как skill получает имя команды](#how-a-skill-gets-its-command-name), чтобы узнать, как это поле взаимодействует с именем, которое вы вводите для вызова skill. |

398| `description` | Рекомендуется | Что делает skill и когда его использовать. Claude использует это, чтобы решить, когда применить skill. Если опущено, использует первую непустую строку содержимого markdown. Поместите основной вариант использования в первую очередь: объединенный текст `description` и `when_to_use` усекается на 1536 символов в списке skills для снижения использования контекста. |398| `description` | Рекомендуется | Что делает skill и когда его использовать. Claude использует это, чтобы решить, когда применить skill. Если опущено, использует первую непустую строку содержимого markdown. Поместите основной вариант использования в первую очередь: объединенный текст `description` и `when_to_use` усекается на 1536 символов в списке skills для снижения использования контекста. Угловые скобки в тексте [отображаются как `&lt;` и `&gt;`](#angle-brackets-in-a-skill-description). |

399| `when_to_use` | Нет | Дополнительный контекст для того, когда Claude должен вызвать skill, такой как фразы-триггеры или примеры запросов. Добавляется к `description` в списке skills и учитывается в ограничении 1536 символов. |399| `when_to_use` | Нет | Дополнительный контекст для того, когда Claude должен вызвать skill, такой как фразы-триггеры или примеры запросов. Добавляется к `description` в списке skills и учитывается в ограничении 1536 символов. |

400| `argument-hint` | Нет | Подсказка, показываемая при автодополнении, чтобы указать ожидаемые аргументы. Пример: `[issue-number]` или `[filename] [format]`. |400| `argument-hint` | Нет | Подсказка, показываемая при автодополнении, чтобы указать ожидаемые аргументы. Пример: `[issue-number]` или `[filename] [format]`. |

401| `arguments` | Нет | Именованные позиционные аргументы для [`$name` подстановки](#available-string-substitutions) в содержимом skill. Принимает строку, разделенную пробелами, или список YAML. Имена соответствуют позициям аргументов по порядку. |401| `arguments` | Нет | Именованные позиционные аргументы для [`$name` подстановки](#available-string-substitutions) в содержимом skill. Принимает строку, разделенную пробелами, или список YAML. Имена соответствуют позициям аргументов по порядку. |


778 778 

779При оболочке `bash` по умолчанию добавляйте `|| true` к любой другой команде, которая, как вы ожидаете, завершится с ненулевым кодом. Пример — скрипт проверки, который завершается с кодом 1, если находит проблемы.779При оболочке `bash` по умолчанию добавляйте `|| true` к любой другой команде, которая, как вы ожидаете, завершится с ненулевым кодом. Пример — скрипт проверки, который завершается с кодом 1, если находит проблемы.

780 780 

781#### Управляющие символы во внедрённых командах781#### Когда ни одна shell-команда не была выполнена

782 782 

783`No shell command in <name> was run` означает, что одна из команд `!` в файле содержит необработанный управляющий символ, отличный от табуляции или перевода строки, поэтому ни одна из них не выполняется. См. [как найти и удалить этот символ](https://code.claude.com/docs/ru/errors.md#no-shell-command-was-run).783`No shell command in <name> was run` означает, что одна из его shell-команд содержит символ, который инструмент не принимает. Чтобы найти и удалить этот символ, см. [справочник по ошибкам](https://code.claude.com/docs/ru/errors.md#no-shell-command-was-run).

784 784 

785#### Проверка разрешений для внедрённых команд785#### Проверка разрешений для внедрённых команд

786 786 


1229 1229 

1230Чтобы увеличить бюджет, установите параметр [`skillListingBudgetFraction`](https://code.claude.com/docs/ru/settings-reference#skilllistingbudgetfraction) (например `0.02` = 2%) или переменную окружения `SLASH_COMMAND_TOOL_CHAR_BUDGET` на фиксированное количество символов. Чтобы освободить бюджет для других skills, установите записи с низким приоритетом на `"name-only"` в [`skillOverrides`](#override-skill-visibility-from-settings), чтобы они отображались без описания. Вы также можете сократить текст `description` и `when_to_use` в источнике: поместите основной вариант использования в первую очередь, так как объединённый текст каждой записи ограничен 1536 символами независимо от бюджета. Ограничение настраивается с помощью [`skillListingMaxDescChars`](https://code.claude.com/docs/ru/settings-reference#skilllistingmaxdescchars).1230Чтобы увеличить бюджет, установите параметр [`skillListingBudgetFraction`](https://code.claude.com/docs/ru/settings-reference#skilllistingbudgetfraction) (например `0.02` = 2%) или переменную окружения `SLASH_COMMAND_TOOL_CHAR_BUDGET` на фиксированное количество символов. Чтобы освободить бюджет для других skills, установите записи с низким приоритетом на `"name-only"` в [`skillOverrides`](#override-skill-visibility-from-settings), чтобы они отображались без описания. Вы также можете сократить текст `description` и `when_to_use` в источнике: поместите основной вариант использования в первую очередь, так как объединённый текст каждой записи ограничен 1536 символами независимо от бюджета. Ограничение настраивается с помощью [`skillListingMaxDescChars`](https://code.claude.com/docs/ru/settings-reference#skilllistingmaxdescchars).

1231 1231 

1232### Угловые скобки в описании скилла отображаются как `&lt;` и `&gt;`

1233 

1234Claude Code отображает `<` и `>` в полях `description` и `when_to_use` как `&lt;` и `&gt;`. Чтобы показать заполнитель, например `<branch>`, используйте квадратные скобки или [`argument-hint`](#frontmatter-reference):

1235 

1236* **Квадратные скобки**: замените `<branch>` на `[branch]`, что отображается так, как введено

1237* **`argument-hint`**: перенесите заполнитель в новую строку `argument-hint: <branch>`. Он отображается после имени команды. Если вы также загружаете skill в claude.ai или Skills API, сначала [проверьте, принимается ли там `argument-hint`](#using-skill-frontmatter-outside-claude-code).

1238 

1232### Личные скиллы исчезли1239### Личные скиллы исчезли

1233 1240 

1234Если папки skills, которые вы создали в `~/.claude/skills/`, исчезли, посмотрите в `~/.claude/skills/.trash/`. Когда Claude Code [синхронизирует skills из claude.ai](#how-synced-skills-behave), он загружает их в отдельную подпапку `synced` и не перемещает и не удаляет папки, которые вы создаёте.1241Если папки skills, которые вы создали в `~/.claude/skills/`, исчезли, посмотрите в `~/.claude/skills/.trash/`. Когда Claude Code [синхронизирует skills из claude.ai](#how-synced-skills-behave), он загружает их в отдельную подпапку `synced` и не перемещает и не удаляет папки, которые вы создаёте.

sub-agents.md +1 −1

Details

938 938 

939Чтобы продолжать работу, пока Claude ждёт, нажмите **Ctrl+B** в терминале или нажмите [**Run in background**](https://code.claude.com/docs/ru/vs-code.md#move-a-running-command-or-subagent-to-the-background) в VS Code.939Чтобы продолжать работу, пока Claude ждёт, нажмите **Ctrl+B** в терминале или нажмите [**Run in background**](https://code.claude.com/docs/ru/vs-code.md#move-a-running-command-or-subagent-to-the-background) в VS Code.

940 940 

941Если вместо выключения режима fork вы установите переменную окружения [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ru/env-vars) в `1`, Claude будет дожидаться каждого субагента. Фоновые команды также отключаются, а **Ctrl+B** ничего не переводит в фон.941Если вместо выключения режима fork вы установите переменную окружения [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ru/env-vars) в `1`, Claude будет дожидаться завершения субагентов, прежде чем продолжить. Фоновые команды также отключаются, а **Ctrl+B** ничего не переводит в фон.

942 942 

943#### Инструменты, разрешения и результаты фоновых субагентов943#### Инструменты, разрешения и результаты фоновых субагентов

944 944 

tools-reference.md +22 −22

Details

618 618 

619## Поведение инструмента WebFetch619## Поведение инструмента WebFetch

620 620 

621WebFetch принимает URL и промпт, описывающий, что нужно извлечь. Он загружает страницу и преобразует ответ в Markdown, когда сервер возвращает HTML. Для большинства загрузок он затем выполняет промпт над содержимым в отдельном вызове модели, и Claude получает результат этого вызова, а не исходную страницу. Этап преобразования не настраивается.621WebFetch принимает URL и промпт, описывающий, что нужно извлечь. Он загружает страницу и преобразует ответ в Markdown, если сервер возвращает HTML. Для большинства загрузок он затем применяет промпт к содержимому в отдельном вызове модели, и Claude получает результат этого вызова, а не исходную страницу. Шаг преобразования не настраивается.

622 622 

623Это делает WebFetch с потерей данных по замыслу. Подсказка извлечения определяет, что достигает Claude, поэтому результат, который говорит, что страница не упоминает что-то, может означать только то, что подсказка об этом не спрашивала. Попросите Claude загрузить снова с более конкретной подсказкой или используйте `curl` через Bash для необработанной страницы.623Поэтому WebFetch по своей природе работает с потерями. Промпт извлечения определяет, что дойдёт до Claude, так что результат, в котором говорится, что на странице что-то не упоминается, может означать лишь то, что промпт об этом не спрашивал. Попросите Claude загрузить страницу снова с более конкретным промптом или используйте `curl` через Bash, чтобы получить необработанную страницу.

624 624 

625Несколько поведений формируют ответ, который получает Claude:625Несколько особенностей поведения определяют ответ, который получает Claude:

626 626 

627* WebFetch отказывает `localhost` и любому другому имени хоста без точки, например простому имени интранета, перед выполнением запроса. [Ошибка, которую он возвращает](https://code.claude.com/docs/ru/errors.md#webfetch-cannot-fetch-localhost), говорит Claude достичь локальных серверов с помощью `curl` через Bash вместо этого.627* WebFetch отклоняет `localhost` и любое другое имя хоста без точки, например голое имя в интрасети, ещё до отправки запроса. [Возвращаемая ошибка](https://code.claude.com/docs/ru/errors.md#webfetch-cannot-fetch-localhost) предлагает Claude обращаться к локальным серверам через `curl` в Bash.

628* HTTP URL-адреса автоматически обновляются до HTTPS.628* URL с HTTP автоматически повышаются до HTTPS.

629* WebFetch считывает до 100 000 символов содержимого страницы за один вызов. В Claude Code v2.1.290 или новее результат для более длинной страницы сообщает Claude, какой объём остался непрочитанным, чтобы Claude мог загрузить следующую часть.629* WebFetch считывает до 100 000 символов содержимого страницы за один вызов. В Claude Code v2.1.290 и новее результат для более длинной страницы сообщает Claude, какой объём остался непрочитанным, чтобы Claude мог загрузить следующую часть.

630* WebFetch кэширует каждый ответ на 15 минут по умолчанию, поэтому повторные загрузки одного и того же URL возвращаются быстро. На Claude Code v2.1.233 или позже установите [`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`](https://code.claude.com/docs/ru/env-vars#variables) для изменения того, как долго WebFetch хранит каждый ответ.630* По умолчанию WebFetch кэширует каждый ответ на 15 минут, поэтому повторные загрузки того же URL выполняются быстро. В Claude Code v2.1.233 и новее задайте [`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`](https://code.claude.com/docs/ru/env-vars#variables), чтобы изменить, как долго WebFetch хранит каждый ответ.

631* Страница, которая не завершила загрузку в течение пяти минут, включая любые перенаправления, которые следует WebFetch, завершается ошибкой истечения срока. На Claude Code v2.1.268 или позже установите [`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`](https://code.claude.com/docs/ru/env-vars#variables) для изменения ограничения или на `0` для его удаления.631* Если страница не загрузилась полностью в течение пяти минут, включая все перенаправления, по которым проходит WebFetch, загрузка завершается ошибкой превышения срока. В Claude Code v2.1.268 и новее задайте [`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`](https://code.claude.com/docs/ru/env-vars#variables), чтобы изменить ограничение, или установите `0`, чтобы убрать его.

632* Когда URL перенаправляет на другой хост, WebFetch возвращает текстовый результат, который называет исходный URL и цель перенаправления вместо его следования. Claude затем загружает новый URL со вторым вызовом WebFetch.632* Когда URL перенаправляет на другой хост, WebFetch не следует перенаправлению, а возвращает текстовый результат с исходным URL и целью перенаправления. Затем Claude загружает новый URL вторым вызовом WebFetch.

633* Когда этап извлечения сталкивается с перегруженным API, Claude Code повторяет попытку с нарастающей задержкой; загрузка, которая всё равно не удалась, возвращает результат с ошибкой.633* Когда на шаге извлечения API оказывается перегружен, Claude Code повторяет попытку с задержкой; если загрузка всё равно не удаётся, возвращается результат с ошибкой.

634 634 

635В режимах Manual и `acceptEdits` [режимы разрешений](https://code.claude.com/docs/ru/permission-modes.md), WebFetch запрашивает перед загрузкой, за исключением доменов, которые ваши [правила разрешений](https://code.claude.com/docs/ru/permissions.md#manage-permissions) уже разрешают или запрещают, и встроенный набор предварительно одобренных доменов документации, которые загружаются без запроса. Независимо от того, что разрешают ваши правила, загрузка также проходит [проверку безопасности домена WebFetch](https://code.claude.com/docs/ru/data-usage.md#webfetch-domain-safety-check) в первую очередь; этот раздел охватывает то, что отправляет проверка, и параметр, который ее пропускает. Подсказка предлагает три варианта:635В режиме Manual и в [режиме разрешений](https://code.claude.com/docs/ru/permission-modes.md) `acceptEdits` WebFetch запрашивает подтверждение перед загрузкой, за исключением доменов, которые ваши [правила разрешений](https://code.claude.com/docs/ru/permissions.md#manage-permissions) уже разрешают или запрещают, а также встроенного набора заранее одобренных доменов документации, загрузка с которых выполняется без запроса. Что бы ни разрешали ваши правила, загрузка также сначала проходит [проверку безопасности домена WebFetch](https://code.claude.com/docs/ru/data-usage.md#webfetch-domain-safety-check); в этом разделе описано, что отправляет проверка, и настройка, позволяющая её пропустить. Запрос предлагает три варианта:

636 636 

637* **Да**: одобряет эту загрузку только. Следующий вызов WebFetch снова запрашивает, даже для одного и того же домена.637* **Yes**: подтверждает только эту загрузку. Следующий вызов WebFetch снова запросит подтверждение, даже для того же домена.

638* **Да, и больше не спрашивайте для `<domain>`**: одобряет загрузку и сохраняет правило разрешения `WebFetch(domain:...)` для этого домена в `.claude/settings.local.json` для этого репозитория. См. [как сохраненные одобрения сохраняются](https://code.claude.com/docs/ru/permissions.md#permission-system). Когда ваша организация устанавливает [`allowManagedPermissionRulesOnly`](https://code.claude.com/docs/ru/permissions#managed-only-settings), Claude Code скрывает этот вариант.638* **Yes, and don't ask again for `<domain>`**: подтверждает загрузку и сохраняет разрешающее правило `WebFetch(domain:...)` для этого домена в `.claude/settings.local.json` для данного репозитория. См. [как сохраняются подтверждения](https://code.claude.com/docs/ru/permissions.md#permission-system). Если ваша организация задаёт [`allowManagedPermissionRulesOnly`](https://code.claude.com/docs/ru/permissions#managed-only-settings), Claude Code скрывает этот вариант.

639* **Нет, и скажите Claude, что делать по-другому**: отклоняет загрузку.639* **No, and tell Claude what to do differently**: отклоняет загрузку.

640 640 

641Чтобы разрешить домен заранее без запроса, добавьте правило разрешения, такое как `WebFetch(domain:example.com)`; `WebFetch(domain:*)` разрешает каждый домен. Режимы разрешений `auto` и `bypassPermissions` [режимы разрешений](https://code.claude.com/docs/ru/permissions.md#permission-modes) пропускают подсказку, за исключением домена, который соответствует явному правилу `ask`.641Чтобы заранее разрешить домен без запроса, добавьте разрешающее правило, например `WebFetch(domain:example.com)`; `WebFetch(domain:*)` разрешает все домены. [Режимы разрешений](https://code.claude.com/docs/ru/permissions.md#permission-modes) `auto` и `bypassPermissions` пропускают запрос, кроме случаев, когда домен соответствует явному правилу `ask`.

642 642 

643Явное правило `WebFetch(domain:...)` в `deny`, `ask` или `allow` имеет приоритет над предварительно одобренным набором, поэтому вы можете заблокировать предварительно одобренный домен или потребовать для него подсказку.643Явное правило `WebFetch(domain:...)` в `deny`, `ask` или `allow` имеет приоритет над набором заранее одобренных доменов, поэтому вы можете заблокировать заранее одобренный домен или требовать для него запрос.

644 644 

645Если URL является ссылкой на [артефакт](https://code.claude.com/docs/ru/artifacts.md) claude.ai, Claude Code также может запросить подтверждение на чтение самого артефакта. О случаях, когда он запрашивает подтверждение, см. [Чтение артефакта, которым с вами поделились](https://code.claude.com/docs/ru/artifacts.md#read-an-artifact-shared-with-you).645Если URL является ссылкой на [артефакт](https://code.claude.com/docs/ru/artifacts.md) claude.ai, Claude Code может также запросить подтверждение на чтение самого артефакта. О случаях, когда он запрашивает подтверждение, см. [Чтение артефакта, которым с вами поделились](https://code.claude.com/docs/ru/artifacts.md#read-an-artifact-shared-with-you).

646 646 

647WebFetch устанавливает заголовок `User-Agent`, начинающийся с `Claude-User`, и заголовок `Accept`, который предпочитает Markdown перед HTML, чтобы серверы, поддерживающие согласование содержимого, могли возвращать Markdown напрямую.647WebFetch устанавливает заголовок `User-Agent`, начинающийся с `Claude-User`, и заголовок `Accept`, который предпочитает Markdown вместо HTML, чтобы серверы, поддерживающие согласование содержимого, могли сразу вернуть Markdown.

648 648 

649Изолированные команды не наследуют встроенный набор предварительно одобренных доменов документации WebFetch. Чтобы позволить изолированной команде достичь домена без запроса, добавьте домен в [`allowedDomains`](https://code.claude.com/docs/ru/settings-reference#sandbox-network-alloweddomains) или разрешите его с помощью правила `WebFetch(domain:...)`, которое [песочница также соблюдает](https://code.claude.com/docs/ru/sandboxing.md#network-isolation). WebFetch никогда не читает список разрешений песочницы в ответ, поэтому добавление домена в песочницу или список разрешений сети организации не останавливает WebFetch от запроса для него.649Команды в песочнице не наследуют встроенный набор заранее одобренных доменов документации WebFetch. Чтобы команда в песочнице могла обращаться к домену без запроса, добавьте домен в [`allowedDomains`](https://code.claude.com/docs/ru/settings-reference#sandbox-network-alloweddomains) или разрешите его правилом `WebFetch(domain:...)`, которое [песочница также учитывает](https://code.claude.com/docs/ru/sandboxing.md#network-isolation). В обратную сторону WebFetch никогда не читает список разрешённых доменов песочницы, поэтому добавление домена в список разрешённых доменов песочницы или сети организации не отменяет запросы WebFetch для этого домена.

650 650 

651### Доступность WebFetch651### Доступность WebFetch

652 652 

653На Claude Code v2.1.285 или позже установите [`CLAUDE_CODE_DISABLE_WEB_FETCH`](https://code.claude.com/docs/ru/env-vars#variables) на `1` для отключения WebFetch.653В Claude Code v2.1.285 и новее установите [`CLAUDE_CODE_DISABLE_WEB_FETCH`](https://code.claude.com/docs/ru/env-vars#variables) в `1`, чтобы отключить WebFetch.

654 654 

655Если вы входите с помощью учетной записи Team или Enterprise claude.ai и не подключаетесь через [LLM gateway](https://code.claude.com/docs/ru/llm-gateway), WebFetch также зависит от политики вашей организации, которую Claude Code запрашивает у `api.anthropic.com` при запуске сеанса. То же самое относится к сеансу, план которого Claude Code не может определить, например к сеансу, работающему под токеном claude.ai, который предоставило другое приложение.655Если вы входите с учётной записью claude.ai уровня Team или Enterprise и не подключаетесь через [LLM-шлюз](https://code.claude.com/docs/ru/llm-gateway), WebFetch также зависит от политики вашей организации, которую Claude Code запрашивает у `api.anthropic.com` при запуске сессии. То же относится к сессии, тарифный план которой Claude Code не может определить, например к сессии, работающей с токеном claude.ai, предоставленным другим приложением.

656 656 

657Если WebFetch отсутствует в сеансе, запустите `/status` в сеансе. Если его строка `Organization policy` сообщает, что политика не загрузилась и называет веб-выборку среди функций, которые ждут ее, Claude Code удерживает WebFetch до тех пор, пока не сможет подтвердить, что ваша организация это разрешает. Вне сеанса `claude doctor` делает свой собственный запрос и выводит ту же строку. После загрузки политики, которая разрешает WebFetch, инструмент возвращается без перезагрузки.657Если в сессии отсутствует WebFetch, выполните `/status` в этой сессии. Если строка `Organization policy` сообщает, что политика не загрузилась, и называет web fetch среди функций, ожидающих её, значит Claude Code не предоставляет WebFetch, пока не сможет подтвердить, что ваша организация его разрешает. Вне сессии `claude doctor` выполняет собственный запрос и выводит ту же строку. Как только загрузится политика, разрешающая WebFetch, инструмент снова станет доступен без перезапуска.

658 658 

659## Поведение инструмента WebSearch659## Поведение инструмента WebSearch

660 660 

Details

1169 1169 

1170### OAuth login fails in WSL2, SSH, or containers1170### OAuth login fails in WSL2, SSH, or containers

1171 1171 

1172Когда Claude Code работает в WSL2, на удалённой машине через SSH или внутри контейнера, браузер обычно открывается на другом хосте и его перенаправление не может достичь локального сервера обратного вызова Claude Code. После того как вы войдёте, браузер показывает код входа вместо автоматического перенаправления обратно. Вставьте этот код в терминал в приглашение `Paste code here if prompted`, чтобы завершить вход.1172Если браузер не открывается или браузер выполняет вход, а затем показывает ошибку подключения для адреса `localhost`, вы можете завершить вход, не устраняя ни одну из этих проблем. Вместо этого войдите через отдельный URL входа, который терминал показывает над приглашением для вставки:

1173 1173 

1174Если браузер вообще не открывается из WSL2, установите переменную окружения `BROWSER` на путь вашего браузера Windows:1174**1. Скопируйте URL входа**

1175 1175 

1176```bash theme={null}1176В интерактивном приглашении входа нажмите `c`, чтобы скопировать URL, или выделите его в терминале. При использовании `claude auth login` скопируйте URL, который выводит эта команда.

1177export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"1177 

1178claude1178**2. Войдите через этот URL**

1179```1179 

1180Откройте URL в браузере на вашей локальной машине и войдите. После этого браузер покажет код вместо возврата на `localhost`.

1181 

1182**3. Вставьте код**

1180 1183 

1181Или нажмите `c` на интерактивном приглашении входа, чтобы скопировать URL OAuth, или скопируйте URL, который печатает `claude auth login`, и откройте его в браузере на вашей локальной машине.1184Вставьте этот код в терминал в приглашение, которое начинается с `Paste code here`.

1182 1185 

1183Если вставка кода в интерактивное приглашение ничего не делает, привязка вставки вашего терминала вероятно не достигает поля ввода. Попробуйте альтернативное сочетание клавиш вставки вашего терминала, часто правый клик или Shift+Insert в Windows Terminal, или используйте `claude auth login` вместо этого, который читает вставленный код из стандартного ввода:1186Если вставка кода в интерактивное приглашение ничего не делает, привязка вставки вашего терминала вероятно не достигает поля ввода. Попробуйте альтернативное сочетание клавиш вставки вашего терминала, часто правый клик или Shift+Insert в Windows Terminal, или используйте `claude auth login` вместо этого, который читает вставленный код из стандартного ввода:

1184 1187 


1188 1191 

1189Этот резервный вариант также применяется на нативном Windows или любом терминале, где вставка в интерактивное приглашение не удаётся.1192Этот резервный вариант также применяется на нативном Windows или любом терминале, где вставка в интерактивное приглашение не удаётся.

1190 1193 

1194В WSL2, если браузер не открылся, вы также можете позволить Claude Code в следующий раз открыть ваш браузер Windows, установив переменную окружения `BROWSER` на путь к этому браузеру:

1195 

1196```bash theme={null}

1197export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"

1198claude

1199```

1200 

1191### Not logged in or token expired1201### Not logged in or token expired

1192 1202 

1193Если Claude Code предлагает вам войти снова после сессии, ваш токен OAuth может истечь.1203Если Claude Code предлагает вам войти снова после сессии, ваш токен OAuth может истечь.

vs-code.md +16 −5

Details

133 Если текущая модель поддерживает [уровни effort](https://code.claude.com/docs/ru/model-config.md#adjust-effort-level), в окне выбора также отображается строка **Effort**, а на кнопке с названием модели показывается выбранный уровень. Если вы выбираете уровень, отличный от `max`, Claude Code сохраняет его для текущей модели как уровень по умолчанию в [`modelSettings`](https://code.claude.com/docs/ru/settings-reference#modelsettings) в ваших пользовательских настройках; `max` применяется только к текущей сессии. Кнопка с названием модели и строка **Effort** требуют Claude Code v2.1.257 или более поздней версии.133 Если текущая модель поддерживает [уровни effort](https://code.claude.com/docs/ru/model-config.md#adjust-effort-level), в окне выбора также отображается строка **Effort**, а на кнопке с названием модели показывается выбранный уровень. Если вы выбираете уровень, отличный от `max`, Claude Code сохраняет его для текущей модели как уровень по умолчанию в [`modelSettings`](https://code.claude.com/docs/ru/settings-reference#modelsettings) в ваших пользовательских настройках; `max` применяется только к текущей сессии. Кнопка с названием модели и строка **Effort** требуют Claude Code v2.1.257 или более поздней версии.

134 134 

135 Если включены [динамические рабочие процессы](https://code.claude.com/docs/ru/workflows.md) и текущая модель их поддерживает, под строкой **Effort** появляется переключатель **Ultracode**. Включите его, чтобы Claude планировал [рабочий процесс](https://code.claude.com/docs/ru/workflows.md#let-claude-decide-with-ultracode) для каждой содержательной задачи в этой сессии с выбранным уровнем effort. Пока он включён, на кнопке с названием модели после уровня отображается `· Ultracode`. Переключатель требует Claude Code v2.1.284 или более поздней версии.135 Если включены [динамические рабочие процессы](https://code.claude.com/docs/ru/workflows.md) и текущая модель их поддерживает, под строкой **Effort** появляется переключатель **Ultracode**. Включите его, чтобы Claude планировал [рабочий процесс](https://code.claude.com/docs/ru/workflows.md#let-claude-decide-with-ultracode) для каждой содержательной задачи в этой сессии с выбранным уровнем effort. Пока он включён, на кнопке с названием модели после уровня отображается `· Ultracode`. Переключатель требует Claude Code v2.1.284 или более поздней версии.

136* **Меню команд**: нажмите `/` или введите `/`, чтобы открыть меню команд. Среди вариантов — прикрепление файлов, переключение моделей и включение или отключение расширенного мышления.136* **Меню команд**: нажмите `/` или введите `/`, чтобы открыть меню команд. Среди вариантов — прикрепление файлов и переключение моделей.

137 137 

138 Раздел Customize содержит такие пункты, как MCP-серверы, команды, стили вывода, хуки, память, инструкции, разрешения и плагины. Пункты со значком терминала открываются во встроенном терминале.138 Раздел Customize содержит такие пункты, как MCP-серверы, команды, стили вывода, хуки, память, инструкции, разрешения и плагины. Пункты со значком терминала открываются во встроенном терминале.

139 139 


191 Чтобы открыть карту, когда счётчик агентов не отображается, например когда Claude запустил фоновую оболочку, но не запустил субагентов, введите `/tasks` в поле ввода промпта. Фоновые задачи на карте и ввод `/tasks` требуют Claude Code v2.1.277 или более поздней версии.191 Чтобы открыть карту, когда счётчик агентов не отображается, например когда Claude запустил фоновую оболочку, но не запустил субагентов, введите `/tasks` в поле ввода промпта. Фоновые задачи на карте и ввод `/tasks` требуют Claude Code v2.1.277 или более поздней версии.

192 192 

193 В Claude Code v2.1.286 и более поздних версиях, когда вы нажимаете **Stop** или клавишу `Esc`, текущий ход завершается. Фоновые агенты продолжают работать, пока не закончат или пока вы не остановите их с карты.193 В Claude Code v2.1.286 и более поздних версиях, когда вы нажимаете **Stop** или клавишу `Esc`, текущий ход завершается. Фоновые агенты продолжают работать, пока не закончат или пока вы не остановите их с карты.

194* **Расширенное мышление**: позволяет Claude тратить больше времени на рассуждения над сложными задачами. Включите его через меню команд (`/`). Размышления Claude отображаются в диалоге в виде свёрнутых блоков: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть все блоки размышлений в сессии. Подробнее см. в разделе [Расширенное мышление](https://code.claude.com/docs/ru/model-config.md#extended-thinking).194* **Расширенное мышление**: позволяет Claude тратить больше времени на рассуждения над сложными задачами. Чтобы отключить его или снова включить, используйте переключатель **Thinking** в разделе Model меню команд (`/`). В моделях, где [мышление нельзя отключить](https://code.claude.com/docs/ru/model-config.md#extended-thinking), в меню нет переключателя **Thinking**, и мышление остаётся включённым.

195 

196 Блок размышлений, в котором отображается только метка, например `Thought for 12s`, не содержит текста и не раскрывается при нажатии. Чтобы видеть сводки размышлений, задайте для [`showThinkingSummaries`](https://code.claude.com/docs/ru/settings-reference#showthinkingsummaries) значение `true` в `~/.claude/settings.json`, затем выполните **Developer: Reload Window** из палитры команд.

197 

198 Уже имеющиеся блоки размышлений остаются пустыми. В ответах после перезагрузки нажмите на блок или нажмите `Ctrl+O`, чтобы развернуть их все.

195* **Многострочный ввод**: нажмите `Shift+Enter`, чтобы добавить новую строку без отправки. Это также работает в поле свободного ввода «Other» в диалоговых окнах с вопросами.199* **Многострочный ввод**: нажмите `Shift+Enter`, чтобы добавить новую строку без отправки. Это также работает в поле свободного ввода «Other» в диалоговых окнах с вопросами.

196 200 

197### Ссылки на файлы и папки201### Ссылки на файлы и папки


333 337 

334Выполните `/usage`, чтобы открыть диалоговое окно Account & usage, в котором отображаются учётная запись, с которой вы вошли, и ваше использование. Показатели использования зависят от способа входа:338Выполните `/usage`, чтобы открыть диалоговое окно Account & usage, в котором отображаются учётная запись, с которой вы вошли, и ваше использование. Показатели использования зависят от способа входа:

335 339 

336* **Тариф claude.ai**: полосы использования для лимитов вашего тарифа, например для текущей сессии и недели. Каждая полоса показывает, сколько времени осталось до сброса её лимита.340* **Тариф claude.ai**: полосы использования для лимитов вашего тарифа, например для текущей сессии и недели.

337 341 

338 Диалоговое окно также показывает разбивку того, что влияет на лимиты тарифа:342 Диалоговое окно также показывает разбивку того, что влияет на лимиты тарифа:

339 343 


580 584 

581При создании pull request'ов Claude генерирует описания на основе фактических изменений кода и может добавлять контекст о тестировании или решениях по реализации.585При создании pull request'ов Claude генерирует описания на основе фактических изменений кода и может добавлять контекст о тестировании или решениях по реализации.

582 586 

587### Повторное открытие диалога, перешедшего в worktree

588 

589В повторно открытом диалоге баннер **This session is in worktree** означает, что рабочий каталог диалога — это указанный в баннере [worktree](https://code.claude.com/docs/ru/worktrees.md), а не папка, открытая в этом окне. Чтобы открыть worktree в новом окне VS Code, нажмите **Open worktree** на баннере.

590 

591Диалог переходит в worktree, например, когда вы [просите Claude работать в нём](https://code.claude.com/docs/ru/worktrees.md#ask-claude-to-create-a-worktree). Когда вы снова открываете его или панель [повторно открывает его после перезагрузки окна](#continue-conversations-after-a-reload), он возобновляется в worktree, если Claude Code создал этот worktree в `.claude/worktrees/` и тот всё ещё существует. До Claude Code v2.1.300 вместо этого открывался пустой диалог. В этих версиях обновите расширение.

592 

583## Выполнение работы в фоновом режиме593## Выполнение работы в фоновом режиме

584 594 

585Отправьте длительную команду или субагента в фоновый режим, а затем проверяйте их состояние из поля ввода промпта.595Отправьте длительную команду или субагента в фоновый режим, а затем проверяйте их состояние из поля ввода промпта.


633| Insert @-Mention Reference | `Option+K` (Mac) / `Alt+K` (Windows/Linux) | Вставить ссылку на текущий файл и выделение (требуется, чтобы редактор был в фокусе) |643| Insert @-Mention Reference | `Option+K` (Mac) / `Alt+K` (Windows/Linux) | Вставить ссылку на текущий файл и выделение (требуется, чтобы редактор был в фокусе) |

634| Accept Change at Cursor | - | Принять изменение в позиции курсора при [просмотре предложенной правки](#get-started) по одному изменению за раз. Требуется Claude Code v2.1.275 или новее |644| Accept Change at Cursor | - | Принять изменение в позиции курсора при [просмотре предложенной правки](#get-started) по одному изменению за раз. Требуется Claude Code v2.1.275 или новее |

635| Reject Change at Cursor | - | Отменить изменение в позиции курсора при просмотре предложенной правки по одному изменению за раз. Требуется Claude Code v2.1.275 или новее |645| Reject Change at Cursor | - | Отменить изменение в позиции курсора при просмотре предложенной правки по одному изменению за раз. Требуется Claude Code v2.1.275 или новее |

636| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Скрыть или показать активность инструментов в диалоге. Работает, когда видна панель или боковая панель Claude. Требуется Claude Code v2.1.221 или новее |646| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Скрыть или показать активность инструментов в диалоге. Работает, когда видна панель или боковая панель Claude. В Windows/Linux, когда фокус находится в Debug Console или в списке с поиском, например в Explorer, `Ctrl+Alt+F` вместо этого открывает поиск VS Code. Переместите фокус в редактор или на панель Claude и нажмите сочетание ещё раз. Требуется Claude Code v2.1.221 или новее |

637| Rename Session Tab | - | Переименовать сессию в активной вкладке Claude. Требуется Claude Code v2.1.257 или новее |647| Rename Session Tab | - | Переименовать сессию в активной вкладке Claude. Требуется Claude Code v2.1.257 или новее |

638| Add Session Tab to Group | - | Добавить сессию из активной вкладки Claude в [группу сессий](#organize-sessions-into-groups), которую вы выберете или создадите. Требуется Claude Code v2.1.257 или новее |648| Add Session Tab to Group | - | Добавить сессию из активной вкладки Claude в [группу сессий](#organize-sessions-into-groups), которую вы выберете или создадите. Требуется Claude Code v2.1.257 или новее |

639| Mark Session as Unread | - | Отметить сессию в активной вкладке Claude как непрочитанную в списке сессий. Требуется Claude Code v2.1.257 или новее |649| Mark Session as Unread | - | Отметить сессию в активной вкладке Claude как непрочитанную в списке сессий. Требуется Claude Code v2.1.257 или новее |


679| Параметр | Описание |689| Параметр | Описание |

680| - | - |690| - | - |

681| `prompt` | Текст для предварительного заполнения поля ввода промпта. Должен быть закодирован для URL. Промпт подставляется, но не отправляется автоматически. |691| `prompt` | Текст для предварительного заполнения поля ввода промпта. Должен быть закодирован для URL. Промпт подставляется, но не отправляется автоматически. |

682| `session` | ID сессии, которую нужно возобновить вместо начала нового диалога. Сессия должна принадлежать рабочей области, открытой в данный момент в VS Code. Если сессия не найдена, вместо неё начинается новый диалог. Если сессия уже открыта во вкладке, фокус переходит на эту вкладку. Чтобы получить ID сессии программно, см. раздел [Продолжение диалогов](https://code.claude.com/docs/ru/headless.md#continue-conversations). |692| `session` | ID сессии, которую нужно возобновить, из папки, открытой в VS Code. В Claude Code v2.1.300 или новее также возобновляется сессия из основного checkout или [worktree](https://code.claude.com/docs/ru/worktrees.md) репозитория этой папки. Если сессия не найдена, вместо неё начинается новый диалог. Если сессия уже открыта во вкладке, фокус переходит на эту вкладку. Чтобы получить ID сессии программно, см. раздел [Продолжение диалогов](https://code.claude.com/docs/ru/headless.md#continue-conversations). |

683 693 

684Например, чтобы открыть вкладку с предварительно заполненным текстом «review my changes»:694Например, чтобы открыть вкладку с предварительно заполненным текстом «review my changes»:

685 695 


916| `Claude Code process exited with code 1` или другой код | [Claude Code process exited with code N](https://code.claude.com/docs/ru/errors.md#claude-code-process-exited-with-code-n) |926| `Claude Code process exited with code 1` или другой код | [Claude Code process exited with code N](https://code.claude.com/docs/ru/errors.md#claude-code-process-exited-with-code-n) |

917| `Could not locate the Claude CLI on PATH` | [Could not locate the Claude CLI on PATH](https://code.claude.com/docs/ru/errors.md#could-not-locate-the-claude-cli-on-path) |927| `Could not locate the Claude CLI on PATH` | [Could not locate the Claude CLI on PATH](https://code.claude.com/docs/ru/errors.md#could-not-locate-the-claude-cli-on-path) |

918| `The connection to Claude Code ended before this message completed` | [The connection to Claude Code ended before this message completed](https://code.claude.com/docs/ru/errors.md#the-connection-to-claude-code-ended-before-this-message-completed) |928| `The connection to Claude Code ended before this message completed` | [The connection to Claude Code ended before this message completed](https://code.claude.com/docs/ru/errors.md#the-connection-to-claude-code-ended-before-this-message-completed) |

929| `The Claude Code program for this computer, the <build> build, could not be found` | [The Claude Code program for this computer could not be found](https://code.claude.com/docs/ru/errors.md#the-claude-code-program-for-this-computer-could-not-be-found) |

919| `claude` не найден во встроенном терминале VS Code | [Запуск CLI в VS Code](#run-cli-in-vs-code) |930| `claude` не найден во встроенном терминале VS Code | [Запуск CLI в VS Code](#run-cli-in-vs-code) |

920 931 

921### Расширение не устанавливается932### Расширение не устанавливается

workflows.md +1 −1

Details

147 147 

148Чтобы включить его с помощью ползунка `/effort`, нажмите `Tab` для переключения переключателя **Ultracode**, затем `Enter` для применения. Раздел [Регулировка уровня усилий](https://code.claude.com/docs/ru/model-config.md#adjust-effort-level) перечисляет маршруты, которые включают ultracode.148Чтобы включить его с помощью ползунка `/effort`, нажмите `Tab` для переключения переключателя **Ultracode**, затем `Enter` для применения. Раздел [Регулировка уровня усилий](https://code.claude.com/docs/ru/model-config.md#adjust-effort-level) перечисляет маршруты, которые включают ultracode.

149 149 

150С ultracode включённым, Claude решает, когда задача требует workflow. Один запрос может превратиться в несколько workflows подряд: один для понимания кода, один для внесения изменения и один для его проверки. Это применяется к каждой задаче в сессии, поэтому каждый запрос использует больше токенов и занимает больше времени, чем на более низких уровнях усилий. На плане подписки эти токены расходуют ваши лимиты использования, поэтому сессия с включённым ultracode достигает лимита сессии или недельного лимита раньше, чем та же работа с ним отключённым.150С ultracode включённым, Claude решает, когда задача требует workflow. Один запрос может превратиться в несколько workflows подряд: один для понимания кода, один для внесения изменения и один для его проверки. Это применяется к каждой задаче в сессии, поэтому каждый запрос использует больше токенов и занимает больше времени, чем тот же запрос без workflow. На плане подписки эти токены расходуют ваши лимиты использования, поэтому сессия с включённым ultracode достигает лимита сессии или недельного лимита раньше, чем та же работа с ним отключённым.

151 151 

152Включение ultracode уже предполагает согласие на большие запуски, поэтому эти проверки не применяются, пока он включён:152Включение ultracode уже предполагает согласие на большие запуски, поэтому эти проверки не применяются, пока он включён:

153 153 

worktrees.md +15 −1

Details

214 214 

215### Повторное использование имени worktree215### Повторное использование имени worktree

216 216 

217Если передать `--worktree` имя, каталог которого уже существует, будет открыт этот существующий worktree, а не создан новый.217Если worktree с именем, которое вы передаёте в `--worktree`, уже существует, Claude Code открывает его, а не создаёт новый. Если Claude Code останавливается с ошибкой, содержащей `belongs to a different repository` или `is a leftover worktree`, см. [Каталог worktree `belongs to a different repository`](#belongs-to-a-different-repository).

218 218 

219При [базе](#choose-the-base-branch) `"fresh"` по умолчанию повторно открытый worktree сбрасывается на ветку по умолчанию репозитория, а не продолжает с прежней вершины, если выполняются все следующие условия:219При [базе](#choose-the-base-branch) `"fresh"` по умолчанию повторно открытый worktree сбрасывается на ветку по умолчанию репозитория, а не продолжает с прежней вершины, если выполняются все следующие условия:

220 220 


353 353 

354Ошибка, содержащая `This repository is a partial clone`, означает, что Claude Code не смог получить все объекты git, необходимые для начального коммита worktree. Выполните действие из предложения сообщения, которое заканчивается на `try again`. Затем повторите попытку из той оболочки, в которой вы его выполнили: запустите `claude --worktree` или запустите там `claude` и попросите снова.354Ошибка, содержащая `This repository is a partial clone`, означает, что Claude Code не смог получить все объекты git, необходимые для начального коммита worktree. Выполните действие из предложения сообщения, которое заканчивается на `try again`. Затем повторите попытку из той оболочки, в которой вы его выполнили: запустите `claude --worktree` или запустите там `claude` и попросите снова.

355 355 

356### `Can only use --worktree in a git repository`

357 

358Эта ошибка означает, что вы передали `--worktree` в каталоге, который не является git checkout, и ни один [хук `WorktreeCreate`](#non-git-version-control) не активен.

359 

360* В папке без системы контроля версий выполните там `git init`, создайте первый коммит, затем повторите попытку.

361* В checkout другой системы контроля версий настройте хук, который предлагает сообщение.

362* Чтобы работать непосредственно в каталоге, запустите Claude без `--worktree`.

363 

364### Каталог worktree `belongs to a different repository`

365 

366Ошибки `belongs to a different repository` и `is a leftover worktree` обе означают, что git связывает каталог для переданного вами имени worktree с другим расположением. Это может произойти после копирования или перемещения проекта.

367 

368Передайте другое имя worktree. Если в каталоге нет работы, которую нужно сохранить, и вы не копировали и не перемещали проект, вы можете удалить его и повторить попытку с тем же именем. После копирования или перемещения такая повторная попытка может завершиться ошибкой `is already checked out elsewhere in this repository`, поэтому используйте другое имя.

369 

356### Claude Code отказывается использовать worktree370### Claude Code отказывается использовать worktree

357 371 

358Ошибка, начинающаяся с `Refusing to use <path> as an isolation worktree`, означает, что Claude Code проверил идентичность git каталога перед его принятием как изолированной копии сеанса или subagent и отказал. Проверка выполняется независимо от того, создаёт ли Claude Code worktree, входит в существующий или повторно использует один из более раннего запуска.372Ошибка, начинающаяся с `Refusing to use <path> as an isolation worktree`, означает, что Claude Code проверил идентичность git каталога перед его принятием как изолированной копии сеанса или subagent и отказал. Проверка выполняется независимо от того, создаёт ли Claude Code worktree, входит в существующий или повторно использует один из более раннего запуска.