Documentation — Spybara

accessibility.md +1 −1

Details

111 Ответ на меню и подсказки111 Ответ на меню и подсказки

112</h2>112</h2>

113 113

114В режиме программы чтения с экрана меню, которыми вы обычно навигируете с помощью клавиш со стрелками, включая подсказки разрешения, становятся нумерованными списками. Claude Code объявляет каждый параметр как нумерованную строку, затем подсказку `Enter selection`, которая называет допустимый диапазон. Введите номер нужного параметра и нажмите Enter.114В режиме программы чтения с экрана меню, которыми вы обычно навигируете с помощью клавиш со стрелками, включая подсказки разрешения, становятся нумерованными списками. Claude Code объявляет каждый параметр как нумерованную строку, затем подсказку `Select with numbers`, которая называет допустимый диапазон. Введите номер нужного параметра и нажмите Enter.

115 115

116* Нажмите Escape, чтобы отменить меню, чья подсказка заканчивается на `or Escape to cancel`.116* Нажмите Escape, чтобы отменить меню, чья подсказка заканчивается на `or Escape to cancel`.

117* Если вы введёте номер, которого нет в списке, Claude Code объявляет допустимый диапазон и позволяет вам попробовать снова.117* Если вы введёте номер, которого нет в списке, Claude Code объявляет допустимый диапазон и позволяет вам попробовать снова.

admin-setup.md +2 −2

Details

97| :- | :- | :- |97| :- | :- | :- |

99| [Блокировка разрешений](/docs/ru/permissions#managed-only-settings) | Сделать управляемые параметры [единственным источником правил разрешений](/docs/ru/settings-reference#allowmanagedpermissionrulesonly). Отключить `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`, `permissions.disableBypassPermissionsMode` |99| [Блокировка разрешений](/docs/ru/permissions#managed-only-settings) | Сделать управляемые параметры [единственным источником правил разрешений](/docs/ru/settings-reference#allowmanagedpermissionrulesonly). Отключить `--dangerously-skip-permissions` | `allowManagedPermissionRulesOnly`, `permissions.disableBypassPermissionsMode` |

100| [Начальный режим разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in) | Выберите режим разрешений, в котором начинаются сеансы терминала ваших разработчиков, вместо встроенного начального режима разрешений, или удалите режим авто. Расширение VS Code читает `defaultMode`, который вы устанавливаете только в планах Pro, Max и Team; [Переключение режимов разрешений](/docs/ru/permission-modes#switch-permission-modes) указывает, что читает расширение | `permissions.defaultMode`, `permissions.disableAutoMode` |100| [Начальный режим разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in) | Выберите режим разрешений, в котором начинаются сеансы терминала ваших разработчиков, вместо встроенного начального режима разрешений, или удалите режим авто. [Переключение режимов разрешений](/docs/ru/permission-modes#switch-permission-modes) указывает, когда расширение VS Code читает `defaultMode`, который вы устанавливаете | `permissions.defaultMode`, `permissions.disableAutoMode` |

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

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

105| [Блокировка настройки](/docs/ru/settings-reference#strictpluginonlycustomization) | Заблокировать skills, агентов, hooks и серверы MCP из пользовательских и проектных источников, чтобы они могли поступать только из плагинов или управляемых параметров. Блокировка skills также останавливает [skills, которые ваши разработчики включают на claude.ai](/docs/ru/skills#where-synced-skills-load) от синхронизации | `strictPluginOnlyCustomization` |105| [Блокировка настройки](/docs/ru/settings-reference#strictpluginonlycustomization) | Заблокировать skills, агентов, hooks и серверы MCP из пользовательских и проектных источников, чтобы они могли поступать только из плагинов или управляемых параметров. Блокировка skills также останавливает [skills, которые ваши разработчики включают на claude.ai](/docs/ru/skills#where-synced-skills-load) от синхронизации | `strictPluginOnlyCustomization` |

106| [Отключить синхронизацию claude.ai](/docs/ru/settings-reference#syncclaudeaiskills) | Остановить Claude Code от загрузки [skills](/docs/ru/skills#how-synced-skills-behave) и [плагинов](/docs/ru/plugins/loading#synced-plugins), которые ваши разработчики включают на claude.ai. Если вы отключите Skills для вашей организации на claude.ai, Claude Code останавливает синхронизацию обоих, и на v2.1.273 или позже это также удаляет те, которые он уже синхронизировал. Чтобы остановить один из них без отключения Skills, установите его ключ на `false` в управляемых параметрах | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |106| [Отключить синхронизацию claude.ai](/docs/ru/settings-reference#syncclaudeaiskills) | Остановить Claude Code от загрузки [skills](/docs/ru/skills#how-synced-skills-behave) и [плагинов](/docs/ru/plugins/loading#synced-plugins), которые ваши разработчики включают на claude.ai. Если вы отключите Skills для вашей организации на claude.ai, Claude Code останавливает синхронизацию обоих, и на v2.1.273 или позже это также удаляет те, которые он уже синхронизировал. Чтобы остановить один из них без отключения Skills, установите его ключ на `false` в управляемых параметрах | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |

107| [Ограничения hooks](/docs/ru/settings-reference#allowmanagedhooksonly) | Ограничить, какие hooks выполняются, и ограничить URL-адреса HTTP hooks; см. [что выполняется под `allowManagedHooksOnly`](/docs/ru/settings-reference#what-runs-under-allowmanagedhooksonly) для полного списка эффектов | `allowManagedHooksOnly`, `allowedHttpHookUrls` |107| [Ограничения hooks](/docs/ru/settings-reference#allowmanagedhooksonly) | Ограничить, какие hooks выполняются, и ограничить URL-адреса HTTP hooks; см. [что выполняется под `allowManagedHooksOnly`](/docs/ru/settings-reference#what-runs-under-allowmanagedhooksonly) для полного списка эффектов | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

108| [Принудительный вход](/docs/ru/settings-reference#forceloginmethod) | Ограничить вход определённым методом или организацией Anthropic. Ограничение метода применяется во всём расширении VS Code, Agent SDK, `claude setup-token` и `/install-github-app`, а интерактивный экран входа терминала, доступный через `/login` или первоначальную настройку, предварительно выбирает метод без его принудительного применения; Claude Code проверяет организацию для входов в учётную запись claude.ai в терминале, расширении VS Code и Agent SDK, и не проверяет её для входов в Claude Console или для входа через [gateway](/docs/ru/claude-apps-gateway). До версии 2.1.212 только входы в терминал применяли любой из ключей. Когда установлено, сеансы, аутентифицированные через `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске; облачные сеансы поставщиков не затрагиваются | `forceLoginMethod`, `forceLoginOrgUUID` |108| [Принудительный вход](/docs/ru/settings-reference#forceloginmethod) | Ограничить вход определённым методом или организацией Anthropic. Ограничение метода применяется во всём расширении VS Code, Agent SDK, `claude setup-token` и `/install-github-app`, а интерактивный экран входа терминала, доступный через `/login` или первоначальную настройку, предварительно выбирает метод без его принудительного применения; Claude Code проверяет организацию для входов в учётную запись claude.ai в терминале, расширении VS Code и Agent SDK, и не проверяет её для входов в Claude Console или для входа через [gateway](/docs/ru/claude-apps-gateway). До версии 2.1.212 только входы в терминал применяли любой из ключей. Когда установлено, сеансы, аутентифицированные через `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске; облачные сеансы поставщиков не затрагиваются, если только одно из этих учётных данных или ключ API, сохранённый более ранним входом в Claude Console, также не присутствует | `forceLoginMethod`, `forceLoginOrgUUID` |

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

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

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

advisor.md +3 −2

Details

103| - | - | - |103| - | - | - |

105| Sonnet 4.6 | Fable, Opus, Sonnet | |105| Sonnet 4.6 | Fable, Opus, Sonnet | |

163 163

164* **Reviewed**: строка подтверждает, что советник проверил диалог. Когда советник вернул читаемые рекомендации, нажмите `Ctrl+O`, чтобы прочитать их.164* **Reviewed**: строка подтверждает, что советник проверил диалог. Когда советник вернул читаемые рекомендации, нажмите `Ctrl+O`, чтобы прочитать их.

165* **Declined**: строка читается как `Advisor declined to advise on this request`. Если советник дал причину, нажмите `Ctrl+O`, чтобы прочитать её.165* **Declined**: строка читается как `Advisor declined to advise on this request`. Если советник дал причину, нажмите `Ctrl+O`, чтобы прочитать её.

166* **Unavailable**: вызов советника не удался, и строка читается как `Advisor unavailable (<error_code>)`, где `<error_code>` — это код, который вернул вызов.

166 167

167Claude обычно следует рекомендациям советника, но адаптируется, когда его собственные доказательства противоречат конкретному утверждению: если рекомендуемый шаг не удаётся при попытке или содержимое файла противоречит совету, Claude выявляет конфликт, а не следует рекомендации безусловно.168Claude обычно следует рекомендациям советника, но адаптируется, когда его собственные доказательства противоречат конкретному утверждению: если рекомендуемый шаг не удаётся при попытке или содержимое файла противоречит совету, Claude выявляет конфликт, а не следует рекомендации безусловно.

168 169

agent-sdk/custom-tools.md +12 −11

Details

129Смотрите справку [`tool()`](/docs/ru/agent-sdk/typescript#tool) TypeScript или справку [`@tool`](/docs/ru/agent-sdk/python#tool) Python для полных деталей параметров, включая форматы входных JSON Schema и структуру возвращаемого значения.129Смотрите справку [`tool()`](/docs/ru/agent-sdk/typescript#tool) TypeScript или справку [`@tool`](/docs/ru/agent-sdk/python#tool) Python для полных деталей параметров, включая форматы входных JSON Schema и структуру возвращаемого значения.

130 130

131<Tip>131<Tip>

132 Чтобы сделать параметр необязательным: в TypeScript добавьте `.default()` к полю Zod. В Python словарь schema рассматривает каждый ключ как обязательный, поэтому оставьте параметр вне schema, упомяните его в строке описания и прочитайте его с помощью `args.get()` в обработчике. Инструмент [`get_precipitation_chance` ниже](#add-more-tools) показывает оба паттерна.132 Чтобы сделать параметр необязательным: в TypeScript добавьте `.optional()` к полю Zod и примените значение по умолчанию в обработчике. В Python словарь schema рассматривает каждый ключ как обязательный, поэтому оставьте параметр вне schema, упомяните его в строке описания и прочитайте его с помощью `args.get()` в обработчике. Инструмент [`get_precipitation_chance` ниже](#add-more-tools) показывает оба паттерна.

133</Tip>133</Tip>

134 134

135<h3 id="call-a-custom-tool">135<h3 id="call-a-custom-tool">

182 ```182 ```

183</CodeGroup>183</CodeGroup>

184 184

185Объедините этот фрагмент с определениями инструмента и сервера из [примера инструмента weather](#weather-tool-example) в одном файле, затем запустите его с помощью `python weather.py` для Python или `npx tsx weather.ts` для TypeScript. Claude вызывает `get_temperature` и скрипт выводит однострочный ответ с текущей температурой в Сан-Франциско.185Объедините этот фрагмент с определениями инструмента и сервера из [примера инструмента Weather](#weather-tool-example) в одном файле, затем запустите его с помощью `python weather.py` для Python или `npx tsx weather.ts` для TypeScript. Claude вызывает `get_temperature` и скрипт выводит однострочный ответ с текущей температурой в Сан-Франциско.

186 186

187<h3 id="add-more-tools">187<h3 id="add-more-tools">

188 Добавление дополнительных инструментов188 Добавление дополнительных инструментов

190 190

191Сервер содержит столько инструментов, сколько вы перечислите в его массиве `tools`. Если на сервере более одного инструмента, вы можете перечислить каждый в `allowedTools` отдельно или использовать подстановочный знак `mcp__weather__*`, чтобы охватить каждый инструмент, который сервер предоставляет.191Сервер содержит столько инструментов, сколько вы перечислите в его массиве `tools`. Если на сервере более одного инструмента, вы можете перечислить каждый в `allowedTools` отдельно или использовать подстановочный знак `mcp__weather__*`, чтобы охватить каждый инструмент, который сервер предоставляет.

192 192

193Пример ниже определяет второй инструмент, `get_precipitation_chance`, и заменяет определение `weatherServer` из [примера инструмента weather](#weather-tool-example) на то, которое перечисляет оба инструмента в массиве.193Пример ниже определяет второй инструмент, `get_precipitation_chance`, и заменяет определение `weatherServer` из [примера инструмента Weather](#weather-tool-example) на то, которое перечисляет оба инструмента в массиве.

194 194

195<CodeGroup>195<CodeGroup>

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

248 .int()248 .int()

249 .min(1)249 .min(1)

250 .max(24)250 .max(24)

251 .default(12) // .default() makes the parameter optional251 .optional() // .optional() lets Claude omit the parameter

252 .describe("How many hours of forecast to return")252 .describe("How many hours of forecast to return")

253 },253 },

254 async (args) => {254 async (args) => {

255 const hours = args.hours ?? 12; // Apply the default in the handler

255 const response = await fetch(256 const response = await fetch(

256 `https://api.open-meteo.com/v1/forecast?latitude=${args.latitude}&longitude=${args.longitude}&hourly=precipitation_probability&forecast_days=1`257 `https://api.open-meteo.com/v1/forecast?latitude=${args.latitude}&longitude=${args.longitude}&hourly=precipitation_probability&forecast_days=1`

257 );258 );

258 const data: any = await response.json();259 const data: any = await response.json();

259 const chances = data.hourly.precipitation_probability.slice(0, args.hours);260 const chances = data.hourly.precipitation_probability.slice(0, hours);

260 261

261 return {262 return {

262 content: [{ type: "text", text: `Next ${args.hours} hours: ${chances.join("%, ")}%` }]263 content: [{ type: "text", text: `Next ${hours} hours: ${chances.join("%, ")}%` }]

263 };264 };

264 }265 }

265 );266 );

290 291

291Аннотации — это метаданные, а не принуждение. Инструмент, отмеченный как `readOnlyHint: true`, всё ещё может писать на диск, если это то, что делает обработчик. Держите аннотацию точной для обработчика.292Аннотации — это метаданные, а не принуждение. Инструмент, отмеченный как `readOnlyHint: true`, всё ещё может писать на диск, если это то, что делает обработчик. Держите аннотацию точной для обработчика.

292 293

293Этот пример добавляет `readOnlyHint` к инструменту `get_temperature` из [примера инструмента weather](#weather-tool-example).294Этот пример добавляет `readOnlyHint` к инструменту `get_temperature` из [примера инструмента Weather](#weather-tool-example).

294 295

295<CodeGroup>296<CodeGroup>

296 ```python Python theme={null}297 ```python Python theme={null}

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

470</h3>471</h3>

471 472

472Блок изображения содержит байты изображения встроенными, закодированными в base64. Поля URL нет. Чтобы вернуть изображение, которое находится по URL, получите его в обработчике, прочитайте байты ответа и закодируйте их в base64 перед возвратом. Результат обрабатывается как визуальный ввод.473Блок изображения содержит байты изображения встроенными, закодированными в base64. Поля URL нет. Чтобы вернуть изображение, которое находится по URL, получите его в обработчике, прочитайте байты ответа и закодируйте их в base64 перед возвратом. Изображение PNG, JPEG, GIF или WebP поступает в Claude как визуальный ввод; изображение любого другого типа сохраняется на диск, и Claude получает его путь к файлу в виде текста.

473 474

474| Поле | Тип | Примечания |475| Поле | Тип | Примечания |

475| :- | :- | :- |476| :- | :- | :- |

538 Ресурсы539 Ресурсы

539</h3>540</h3>

540 541

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

542 543

543| Поле | Тип | Примечания |544| Поле | Тип | Примечания |

544| :- | :- | :- |545| :- | :- | :- |

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

550 551

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

552 553

553<CodeGroup>554<CodeGroup>

554 ```typescript TypeScript theme={null}555 ```typescript TypeScript theme={null}

572 {573 {

573 "type": "resource",574 "type": "resource",

574 "resource": {575 "resource": {

575 "uri": "file:///tmp/report.md", # Label for Claude to reference, not a path the SDK reads576 "uri": "file:///tmp/report.md", # Not a path the SDK reads

576 "mimeType": "text/markdown",577 "mimeType": "text/markdown",

577 "text": "# Report\n...", # The actual content, inline578 "text": "# Report\n...", # The actual content, inline

578 },579 },

agent-sdk/examples.md +4 −4

Details

6 6

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

8 8

9Эта страница направляет вас к полным, готовым к запуску проектам Agent SDK и пошаговым рецептам Claude Cookbook. Приложения TypeScript находятся в репозитории [`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos), а рецепты Python находятся в [Claude Cookbook](https://platform.claude.com/cookbook).9Эта страница направляет вас к полным, готовым к запуску проектам Agent SDK и пошаговым рецептам Claude Cookbook. Приложения находятся в репозитории [`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos), а рецепты Python находятся в [Claude Cookbook](https://platform.claude.com/cookbook).

10 10

11<h2 id="run-a-minimal-agent-first">11<h2 id="run-a-minimal-agent-first">

12 Сначала запустите минимальный агент12 Сначала запустите минимальный агент

18 18

19* [Hello World](https://github.com/anthropics/claude-agent-sdk-demos/tree/main/hello-world): минимальный проект TypeScript для клонирования, когда вы хотите начать с кода репозитория19* [Hello World](https://github.com/anthropics/claude-agent-sdk-demos/tree/main/hello-world): минимальный проект TypeScript для клонирования, когда вы хотите начать с кода репозитория

20 20

~~21<h2 id="explore-a-typescript-application">~~21<h2 id="explore-a-demo-application">

~~22 Изучите приложение TypeScript~~22 Изучите приложение-демонстрацию

23</h2>23</h2>

24 24

25Приложения TypeScript в [`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos) — это демонстрации для локальной разработки, от почтового клиента до многоагентной системы исследований. Клонируйте демонстрацию, структура которой соответствует тому, что вы создаете.25Приложения в [`claude-agent-sdk-demos`](https://github.com/anthropics/claude-agent-sdk-demos) — это демонстрации для локальной разработки, от почтового клиента до многоагентной системы исследований. Клонируйте демонстрацию, структура которой соответствует тому, что вы создаете.

26 26

27<h2 id="work-through-a-python-recipe">27<h2 id="work-through-a-python-recipe">

28 Работайте с рецептом Python28 Работайте с рецептом Python

agent-sdk/file-checkpointing.md +8 −127

Details

6 6

7> Отслеживайте изменения файлов во время сеансов агента и восстанавливайте файлы в любое предыдущее состояние7> Отслеживайте изменения файлов во время сеансов агента и восстанавливайте файлы в любое предыдущее состояние

8 8

9File checkpointing отслеживает изменения файлов, внесённые через инструменты Write, Edit и NotebookEdit во время сеанса агента, позволяя вам отмотать файлы в любое предыдущее состояние. Хотите попробовать? Перейдите к [интерактивному примеру](#try-it-out).9File checkpointing отслеживает изменения файлов, внесённые через инструменты [Write](/docs/ru/tools-reference#write-tool-behavior), [Edit](/docs/ru/tools-reference#edit-tool-behavior) и [NotebookEdit](/docs/ru/tools-reference#notebookedit-tool-behavior) во время сеанса агента, позволяя вам отмотать файлы в любое предыдущее состояние. Чтобы увидеть, как отмотка восстанавливает файл, перейдите к [интерактивному примеру](#try-it-out).

~~11С помощью checkpointing вы можете:~~

~~13* **Отменить нежелательные изменения**, восстановив файлы в известное хорошее состояние~~

~~14* **Исследовать альтернативы**, восстановив checkpoint и попробовав другой подход~~

~~15* **Восстановиться после ошибок**, когда агент вносит неправильные изменения~~

16 10

17<Warning>11<Warning>

18 Отслеживаются только изменения, внесённые через инструменты Write, Edit и NotebookEdit. Изменения, внесённые через команды Bash (например, `echo > file.txt` или `sed -i`), не захватываются системой checkpoint, и также не захватываются правки, которые применяет [subagent](/docs/ru/agent-sdk/subagents), за исключением [skill с `context: fork`](/docs/ru/skills#run-skills-in-a-subagent), который работает на переднем плане.12 Отслеживаются только изменения, внесённые через инструменты Write, Edit и NotebookEdit. Изменения, внесённые через команды Bash (например, `echo > file.txt` или `sed -i`), не захватываются системой checkpoint, и также не захватываются правки, которые применяет [subagent](/docs/ru/agent-sdk/subagents), за исключением [skill с `context: fork`](/docs/ru/skills#run-skills-in-a-subagent), который работает на переднем плане.

36 30

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

38 32

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

35Этот пример включает checkpointing, захватывает UUID checkpoint и ID сеанса из потока ответов, затем возобновляет сеанс позже для отмотки файлов. Пронумерованные комментарии примера соответствуют шагам, которые следуют ниже.

40 36

41<CodeGroup>37<CodeGroup>

42 ```python Python theme={null}38 ```python Python theme={null}

154 | Получить UUID checkpoint | `extra_args={"replay-user-messages": None}` | `extraArgs: { 'replay-user-messages': null }` | Требуется для получения UUID пользовательских сообщений в потоке |150 | Получить UUID checkpoint | `extra_args={"replay-user-messages": None}` | `extraArgs: { 'replay-user-messages': null }` | Требуется для получения UUID пользовательских сообщений в потоке |

155 151

156 <CodeGroup>152 Основной пример в разделе [Реализация checkpointing](#implement-checkpointing) также устанавливает режим разрешений на `acceptEdits`, который одобряет редактирование файлов агентом без приглашения. Для получения дополнительной информации см. [Режимы разрешений](/docs/ru/agent-sdk/permissions#permission-modes).

157 ```python Python theme={null}

158 options = ClaudeAgentOptions(

159 enable_file_checkpointing=True,

160 permission_mode="acceptEdits",

161 extra_args={"replay-user-messages": None},

162 )

~~163~~

164 async with ClaudeSDKClient(options) as client:

165 await client.query("Refactor the authentication module")

166 ```

~~167~~

168 ```typescript TypeScript theme={null}

169 const response = query({

170 prompt: "Refactor the authentication module",

171 options: {

172 enableFileCheckpointing: true,

173 permissionMode: "acceptEdits" as const,

174 extraArgs: { "replay-user-messages": null }

175 }

176 });

177 ```

178 </CodeGroup>

179 </Step>153 </Step>

180 154

181 <Step title="Захват UUID checkpoint и ID сеанса">155 <Step title="Захват UUID checkpoint и ID сеанса">

184 Для большинства случаев использования захватите UUID первого пользовательского сообщения (`message.uuid`); отмотка к нему восстанавливает все файлы в их исходное состояние. Чтобы сохранить несколько checkpoint и отмотать к промежуточным состояниям, см. [Несколько точек восстановления](#multiple-restore-points).158 Для большинства случаев использования захватите UUID первого пользовательского сообщения (`message.uuid`); отмотка к нему восстанавливает все файлы в их исходное состояние. Чтобы сохранить несколько checkpoint и отмотать к промежуточным состояниям, см. [Несколько точек восстановления](#multiple-restore-points).

185 159

186 Захват ID сеанса (`message.session_id`) является необязательным; вам он нужен только если вы хотите отмотать позже, после завершения потока. Если вы вызываете `rewindFiles()` немедленно, пока всё ещё обрабатываете сообщения (как это делает пример в [Checkpoint перед рискованными операциями](#checkpoint-before-risky-operations)), вы можете пропустить захват ID сеанса.160 Захват ID сеанса (`message.session_id`) является необязательным; вам он нужен только если вы хотите отмотать позже, после завершения потока. Если вы вызываете `rewindFiles()` немедленно, пока всё ещё обрабатываете сообщения (как это делает пример в [Checkpoint перед рискованными операциями](#checkpoint-before-risky-operations)), вы можете пропустить захват ID сеанса.

~~187~~

188 <CodeGroup>

189 ```python Python theme={null}

190 checkpoint_id = None

191 session_id = None

~~192~~

193 async for message in client.receive_response():

194 # Capture the first user message UUID as the checkpoint

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

196 checkpoint_id = message.uuid

197 # Capture session ID from the result message

198 if isinstance(message, ResultMessage):

199 session_id = message.session_id

200 ```

~~201~~

202 ```typescript TypeScript theme={null}

203 let checkpointId: string | undefined;

204 let sessionId: string | undefined;

~~205~~

206 for await (const message of response) {

207 // Capture the first user message UUID as the checkpoint

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

209 checkpointId = message.uuid;

210 }

211 // Capture session ID from any message that has it

212 if ("session_id" in message) {

213 sessionId = message.session_id;

214 }

215 }

216 ```

217 </CodeGroup>

218 </Step>161 </Step>

219 162

220 <Step title="Отмотка файлов">163 <Step title="Отмотка файлов">

221 Чтобы отмотать после завершения потока, возобновите сеанс с пустым приглашением и вызовите `rewind_files()` (Python) или `rewindFiles()` (TypeScript) с вашим UUID checkpoint. Вы также можете отмотать во время потока; см. [Checkpoint перед рискованными операциями](#checkpoint-before-risky-operations) для этого паттерна.164 Чтобы отмотать после завершения потока, возобновите сеанс с пустым приглашением и вызовите `rewind_files()` (Python) или `rewindFiles()` (TypeScript) с вашим UUID checkpoint. Включите checkpointing в параметрах возобновленного сеанса также, и вызовите отмотку изнутри цикла ответов. Вы также можете отмотать во время потока. См. [Checkpoint перед рискованными операциями](#checkpoint-before-risky-operations) для этого паттерна.

222 165

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

224 ```python Python theme={null}

225 async with ClaudeSDKClient(

226 ClaudeAgentOptions(enable_file_checkpointing=True, resume=session_id)

227 ) as client:

228 await client.query("") # Empty prompt to open the connection

229 async for message in client.receive_response():

230 if checkpoint_id:

231 await client.rewind_files(checkpoint_id)

232 break

233 ```

~~234~~

235 ```typescript TypeScript theme={null}

236 const rewindQuery = query({

237 prompt: "", // Empty prompt to open the connection

238 options: { ...opts, resume: sessionId }

239 });

~~240~~

241 for await (const msg of rewindQuery) {

242 if (checkpointId) {

243 await rewindQuery.rewindFiles(checkpointId);

244 }

245 break;

246 }

247 ```

248 </CodeGroup>

~~249~~

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

251 167

252 ```bash theme={null}168 ```bash theme={null}

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

783 699

784Эта ошибка возникает, когда вы вызываете `rewindFiles()` или `rewind_files()` после завершения итерации по ответу. Соединение с процессом CLI закрывается при завершении цикла.700Эта ошибка возникает, когда вы вызываете `rewindFiles()` или `rewind_files()` после завершения итерации по ответу. Соединение с процессом CLI закрывается при завершении цикла.

785 701

786**Решение**: Возобновите сеанс с пустым приглашением, затем отмотайте в новом запросе:702**Решение**: Возобновите сеанс с пустым приглашением, затем отмотайте в новом запросе. Основной пример в разделе [Implement checkpointing](#implement-checkpointing) показывает вызов возобновления и отмотки на обоих языках, в комментарии, отмеченном как Step 3.

~~787~~

788<CodeGroup>

789 ```python Python theme={null}

790 # Resume session with empty prompt, then rewind

791 async with ClaudeSDKClient(

792 ClaudeAgentOptions(enable_file_checkpointing=True, resume=session_id)

793 ) as client:

794 await client.query("")

795 async for message in client.receive_response():

796 if checkpoint_id:

797 await client.rewind_files(checkpoint_id)

798 break

799 ```

~~800~~

801 ```typescript TypeScript theme={null}

802 // Resume session with empty prompt, then rewind

803 const rewindQuery = query({

804 prompt: "",

805 options: { ...opts, resume: sessionId }

806 });

~~807~~

808 try {

809 for await (const msg of rewindQuery) {

810 if (checkpointId) {

811 await rewindQuery.rewindFiles(checkpointId);

812 }

813 break;

814 }

815 } catch (error) {

816 // An error here means the rewind didn't complete, for example the checkpoint

817 // wasn't found or the session couldn't be resumed.

818 console.error(`Rewind session ended with an error: ${error}`);

819 }

820 ```

821</CodeGroup>

822 703

823<h2 id="next-steps">704<h2 id="next-steps">

824 Следующие шаги705 Следующие шаги

agent-sdk/hosting.md +7 −2

Details

127 127

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

129 129

130Контейнер предоставляет конечную точку HTTP или WebSocket и сопоставляет каждый активный сеанс с долгоживущим запросом и подпроцессом позади него. В TypeScript используйте [`streamInput()`](/docs/ru/agent-sdk/typescript#query-object) для добавления ходов к активному сеансу и [`startup()`](/docs/ru/agent-sdk/typescript#startup) для предварительного прогрева подпроцессов перед входящим трафиком. В Python используйте [`ClaudeSDKClient`](/docs/ru/agent-sdk/python#claudesdkclient) для сохранения сеанса открытым между ходами. Размер контейнера должен быть таким, чтобы он мог вмещать максимальное количество одновременных сеансов в памяти.130Контейнер предоставляет конечную точку HTTP или WebSocket и сопоставляет каждый активный сеанс с долгоживущим запросом и подпроцессом позади него. Вызовы, которые держат сеансы открытыми и активными, различаются между SDK:

131

132* **TypeScript**: используйте [`streamInput()`](/docs/ru/agent-sdk/typescript#query-object) для добавления ходов к активному сеансу. Вызовите [`startup()`](/docs/ru/agent-sdk/typescript#startup) для предварительного прогрева подпроцессов перед входящим трафиком. Если вы не знаете рабочий каталог сеанса до поступления его первого запроса, предварительно прогрейте с помощью [`prewarm()`](/docs/ru/agent-sdk/typescript#prewarm) вместо этого.

133* **Python**: используйте [`ClaudeSDKClient`](/docs/ru/agent-sdk/python#claudesdkclient) для сохранения сеанса открытым между ходами.

134

135Размер контейнера должен быть таким, чтобы он мог вмещать максимальное количество одновременных сеансов в памяти.

131 136

132<h3 id="hybrid-sessions">137<h3 id="hybrid-sessions">

133 Hybrid sessions138 Hybrid sessions

314 319

315* Передайте `settingSources: []` в TypeScript или `setting_sources=[]` в Python, чтобы пропустить пользовательские, проектные и локальные параметры.320* Передайте `settingSources: []` в TypeScript или `setting_sources=[]` в Python, чтобы пропустить пользовательские, проектные и локальные параметры.

316* Установите `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` в `env`. [Автоматическая память](/docs/ru/memory#auto-memory) в `~/.claude/projects/<project>/memory/` загружается в системную подсказку независимо от `settingSources`. См. [Что settingSources не контролирует](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для других входных данных, которые загружаются безусловно.321* Установите `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` в `env`. [Автоматическая память](/docs/ru/memory#auto-memory) в `~/.claude/projects/<project>/memory/` загружается в системную подсказку независимо от `settingSources`. См. [Что settingSources не контролирует](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для других входных данных, которые загружаются безусловно.

317* Укажите `CLAUDE_CONFIG_DIR` на каталог для каждого арендатора, чтобы арендаторы не делили глобальный конфиг `~/.claude.json`. Когда каждый каталог конфигурации обслуживает один рабочий каталог и вы не делите [`SessionStore`](/docs/ru/agent-sdk/session-storage) между арендаторами, вы также можете установить [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ru/sessions#name-the-project-directory-yourself) в `env`, чтобы сохранить пути транскрипта под ним короткими. Требуется TypeScript Agent SDK v0.3.234 или позже, или Python Agent SDK v0.2.140 или позже.322* Укажите `CLAUDE_CONFIG_DIR` на каталог для каждого арендатора, чтобы арендаторы не делили глобальный конфиг `~/.claude.json`. Когда каждый каталог конфигурации обслуживает один рабочий каталог и вы не передаете [`SessionStore`](/docs/ru/agent-sdk/session-storage), вы также можете установить [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ru/sessions#name-the-project-directory-yourself) в `env`, чтобы сохранить пути транскрипта под ним короткими. Требуется TypeScript Agent SDK v0.3.234 или позже, или Python Agent SDK v0.2.140 или позже.

318* Используйте рабочий каталог для каждого арендатора. Передайте `cwd` явно при каждом вызове `query()`.323* Используйте рабочий каталог для каждого арендатора. Передайте `cwd` явно при каждом вызове `query()`.

319* Применяйте правила исходящего трафика для каждого арендатора на вашем прокси, такие как различные исходящие IP-адреса, учетные данные или списки разрешенных доменов, чтобы скомпрометированный арендатор не мог экспортировать данные через политику исходящего трафика другого арендатора.324* Применяйте правила исходящего трафика для каждого арендатора на вашем прокси, такие как различные исходящие IP-адреса, учетные данные или списки разрешенных доменов, чтобы скомпрометированный арендатор не мог экспортировать данные через политику исходящего трафика другого арендатора.

320 325

agent-sdk/mcp.md +1 −1

Details

162| :- | :- | :- |162| :- | :- | :- |

163| Сервер stdio или HTTP/SSE сервер без кэшированного списка инструментов | Да, до подключения | [`MCP_TIMEOUT`](/docs/ru/env-vars), по умолчанию 30 секунд; подключение завершается ошибкой в этот момент |163| Сервер stdio или HTTP/SSE сервер без кэшированного списка инструментов | Да, до подключения | [`MCP_TIMEOUT`](/docs/ru/env-vars), по умолчанию 30 секунд; подключение завершается ошибкой в этот момент |

164| Удалённый сервер с кэшированным списком инструментов, сохранённый Claude Code из предыдущего подключения | Нет; кэшированные инструменты доступны с первого хода | Нет; подключается при первом вызове инструмента, и это отложенное подключение имеет собственный тайм-аут |164| Удалённый сервер с кэшированным списком инструментов, сохранённый Claude Code из предыдущего подключения | Нет; кэшированные инструменты доступны с первого хода | Нет; подключается при первом вызове инструмента, и это отложенное подключение имеет собственный тайм-аут |

165| In-process [SDK сервер](#sdk-mcp-servers) | Да, до подключения и получения списка инструментов | Нет; запросы подключения и получения списка инструментов имеют собственные тайм-ауты |165| In-process [SDK сервер](#sdk-mcp-servers) | Да, до подключения и получения списка инструментов | [`MCP_TIMEOUT`](/docs/ru/env-vars), по умолчанию 30 секунд, за попытку подключения; подключение завершается ошибкой в этот момент |

166 166

167Серверы, загруженные из [файлов конфигурации](#from-a-config-file), таких как `.mcp.json`, или из плагинов обычно показывают `pending` в сообщении инициализации. Когда `options.mcpServers` содержит сервер stdio, HTTP или SSE, первый ход ждёт эти ожидающие серверы тоже, до `MCP_TIMEOUT`. Когда `options.mcpServers` пуст или содержит только SDK серверы, первый ход ждёт до 2 секунд вместо этого:167Серверы, загруженные из [файлов конфигурации](#from-a-config-file), таких как `.mcp.json`, или из плагинов обычно показывают `pending` в сообщении инициализации. Когда `options.mcpServers` содержит сервер stdio, HTTP или SSE, первый ход ждёт эти ожидающие серверы тоже, до `MCP_TIMEOUT`. Когда `options.mcpServers` пуст или содержит только SDK серверы, первый ход ждёт до 2 секунд вместо этого:

168 168

agent-sdk/modifying-system-prompts.md +124 −9

Details

14 14

15Системная подсказка — это начальный набор инструкций, который определяет поведение Claude на протяжении всего разговора. Agent SDK имеет три начальные точки для неё:15Системная подсказка — это начальный набор инструкций, который определяет поведение Claude на протяжении всего разговора. Agent SDK имеет три начальные точки для неё:

16 16

17* **Минимальное значение по умолчанию**: когда вы не устанавливаете `systemPrompt` в TypeScript или `system_prompt` в Python, SDK использует минимальную подсказку, которая охватывает вызов инструментов, но исключает остальное содержимое предустановки `claude_code`, включая её инструкции по безопасности и защите, а также контекст о рабочем каталоге и окружении. Это отличается от `claude -p`, который по умолчанию использует системную подсказку Claude Code. Если вы переходите с CLI и хотите совпадающее поведение, установите предустановку `claude_code`.17* **Минимальное значение по умолчанию**: когда вы не устанавливаете `systemPrompt` в TypeScript или `system_prompt` в Python, SDK использует минимальную подсказку, которая охватывает вызов инструментов, но исключает остальное содержимое предустановки `claude_code`, включая её инструкции по безопасности и защите. Это отличается от `claude -p`, который по умолчанию использует системную подсказку Claude Code. Если вы переходите с CLI и хотите совпадающее поведение, установите предустановку `claude_code`.

18* **Предустановка `claude_code`**: системная подсказка, которую использует CLI Claude Code, с инструкциями по использованию инструментов, инструкциями по безопасности и защите, а также контекстом о рабочем каталоге и окружении. Установите `systemPrompt: { type: "preset", preset: "claude_code" }` в TypeScript или `system_prompt={"type": "preset", "preset": "claude_code"}` в Python, опционально с `append` для добавления ваших собственных инструкций в конец.18* **Предустановка `claude_code`**: системная подсказка, которую использует CLI Claude Code, с инструкциями по использованию инструментов и инструкциями по безопасности и защите. Установите `systemPrompt: { type: "preset", preset: "claude_code" }` в TypeScript или `system_prompt={"type": "preset", "preset": "claude_code"}` в Python, опционально с `append` для добавления ваших собственных инструкций в конец.

19* **Пользовательская строка**: подсказка, которую вы пишете сами. SDK отправляет только то, что вы предоставляете.19* **Пользовательская строка**: подсказка, которую вы пишете сами. SDK отправляет только то, что вы предоставляете.

20 20

21<h3 id="decide-on-a-starting-point">21<h3 id="decide-on-a-starting-point">

26 26

28| :- | :- | :- |28| :- | :- | :- |

29| Инструмент CLI или IDE-подобный инструмент кодирования, где человек смотрит и управляет, и значения по умолчанию Claude Code — это то, что вам нужно | Предустановка `claude_code` | Подсказка Claude Code, включая руководство по инструментам, правила безопасности и контекст окружения |29| Инструмент CLI или IDE-подобный инструмент кодирования, где человек смотрит и управляет, и значения по умолчанию Claude Code — это то, что вам нужно | Предустановка `claude_code` | Подсказка Claude Code, включая руководство по инструментам и правила безопасности |

30| Тот же вид инструмента, плюс правила, специфичные для продукта, такие как стандарты кодирования, формат вывода или контекст домена | Предустановка `claude_code` с `append` | Всё вышеперечисленное, с вашими инструкциями, добавленными после предустановки. Ничего не удаляется, поэтому это наименее рискованная настройка |30| Тот же вид инструмента, плюс правила, специфичные для продукта, такие как стандарты кодирования, формат вывода или контекст домена | Предустановка `claude_code` с `append` | Всё вышеперечисленное, с вашими инструкциями, добавленными после предустановки. Ничего не удаляется, поэтому это наименее рискованная настройка |

31| Агент с другой поверхностью, идентичностью или моделью разрешений, или агент без кодирования | Пользовательская строка подсказки | Только то, что вы пишете. Вы берёте на себя ответственность за замену руководства по инструментам и инструкций по безопасности, которые вашему агенту всё ещё нужны |31| Агент с другой поверхностью, идентичностью или моделью разрешений, или агент без кодирования | Пользовательская строка подсказки | Только то, что вы пишете. Вы берёте на себя ответственность за замену руководства по инструментам и инструкций по безопасности, которые вашему агенту всё ещё нужны |

32| Тонкий цикл вызова инструментов без персоны агента, где вы предоставляете всё поведение в подсказке пользователя | Без опции `systemPrompt` | Минимальное значение по умолчанию: поддержка вызова инструментов и ничего больше |32| Тонкий цикл вызова инструментов без персоны агента, где вы предоставляете всё поведение в подсказке пользователя | Без опции `systemPrompt` | Минимальное значение по умолчанию: поддержка вызова инструментов и ничего больше |

225 Улучшение кэширования подсказок между пользователями и машинами225 Улучшение кэширования подсказок между пользователями и машинами

226</h4>226</h4>

227 227

228По умолчанию два сеанса, которые используют одну и ту же предустановку `claude_code` и текст `append`, всё ещё не могут совместно использовать запись кэша подсказок, если они запускаются из разных рабочих каталогов. Это потому, что предустановка встраивает контекст для каждого сеанса в системную подсказку перед вашим текстом `append`: рабочий каталог, является ли это репозиторием git, платформу, активную оболочку, версию ОС и пути автоматической памяти. Любое различие в этом контексте создаёт другую системную подсказку и промах кэша. Содержимое CLAUDE.md не влияет на кэш системной подсказки, потому что SDK внедряет его в разговор, а не в системную подсказку.228По умолчанию два сеанса, которые используют одну и ту же предустановку `claude_code` и текст `append`, всё ещё не могут совместно использовать запись кэша подсказок, когда их расположения автоматической памяти отличаются. Предустановка встраивает это расположение в системную подсказку перед вашим текстом `append`. Расположение по умолчанию — это абсолютный путь под `~/.claude/projects/`, названный по пути репозитория на диске, поэтому он отличается между пользователями, машинами и checkouts.

229 229

230Чтобы сделать системную подсказку идентичной во всех сеансах, установите `excludeDynamicSections: true` в TypeScript или `"exclude_dynamic_sections": True` в Python. Контекст для каждого сеанса переходит в первое пользовательское сообщение, оставляя только статическую предустановку и ваш текст `append` в системной подсказке, чтобы идентичные конфигурации совместно использовали запись кэша между пользователями и машинами.230Содержимое CLAUDE.md и детали окружения, такие как рабочий каталог, платформа, оболочка и версия ОС, не влияют на кэш системной подсказки, потому что Claude Code доставляет их в разговор, а не в системную подсказку.

231

232Чтобы сделать системную подсказку идентичной во всех сеансах, установите `excludeDynamicSections: true` в TypeScript или `"exclude_dynamic_sections": True` в Python. Контекст для каждого пользователя переходит в первое пользовательское сообщение, оставляя только статическую предустановку и ваш текст `append` в системной подсказке, чтобы идентичные конфигурации совместно использовали запись кэша между пользователями и машинами.

231 233

232<Note>234<Note>

233 `excludeDynamicSections` требует `@anthropic-ai/claude-agent-sdk` v0.2.98 или позже, или `claude-agent-sdk` v0.1.58 или позже для Python. Установите его только на форме объекта предустановки. SDK игнорирует его, когда вы передаёте пользовательскую подсказку вместо предустановки; чтобы сохранить пользовательскую подсказку в кэше в TypeScript SDK, см. [Cache the static part of a custom prompt](#cache-the-static-part-of-a-custom-prompt).235 `excludeDynamicSections` требует `@anthropic-ai/claude-agent-sdk` v0.2.98 или позже, или `claude-agent-sdk` v0.1.58 или позже для Python. Установите его только на форме объекта предустановки. SDK игнорирует его, когда вы передаёте пользовательскую подсказку вместо предустановки; чтобы сохранить пользовательскую подсказку в кэше в TypeScript SDK, см. [Cache the static part of a custom prompt](#cache-the-static-part-of-a-custom-prompt).

234</Note>236</Note>

235 237

236Следующий пример объединяет общий блок `append` с `excludeDynamicSections`, чтобы флот агентов, работающих из разных каталогов, мог переиспользовать одну и ту же кэшированную системную подсказку:238Следующий пример объединяет общий блок `append` с `excludeDynamicSections`, чтобы флот агентов мог переиспользовать одну и ту же кэшированную системную подсказку:

237 239

238<CodeGroup>240<CodeGroup>

239 ```typescript TypeScript theme={null}241 ```typescript TypeScript theme={null}

279 ```281 ```

280</CodeGroup>282</CodeGroup>

281 283

282**Компромиссы:** рабочий каталог, флаг git-repo, платформа, активная оболочка, версия ОС и пути автоматической памяти всё ещё достигают Claude, но как часть первого пользовательского сообщения, а не системной подсказки. Инструкции в пользовательском сообщении имеют немного меньший вес, чем тот же текст в системной подсказке, поэтому Claude может полагаться на них менее сильно при рассуждении о текущем каталоге или путях автоматической памяти. Включите эту опцию, когда переиспользование кэша между сеансами важнее, чем максимально авторитетный контекст окружения.284**Компромиссы:** текст, который переходит из системной подсказки, всё ещё достигает Claude, но в пользовательском сообщении. Это по крайней мере расположение каталога автоматической памяти, и часто весь раздел автоматической памяти. Инструкции в пользовательском сообщении имеют немного меньший вес, чем тот же текст в системной подсказке, поэтому Claude может следовать его руководству автоматической памяти менее последовательно. Включите эту опцию, когда переиспользование кэша между сеансами важнее, чем это.

283 285

284Для эквивалентного флага в неинтерактивном режиме CLI см. [`--exclude-dynamic-system-prompt-sections`](/docs/ru/cli-reference).286Для эквивалентного флага в неинтерактивном режиме CLI см. [`--exclude-dynamic-system-prompt-sections`](/docs/ru/cli-reference).

285 287

355В TypeScript SDK вы можете передать пользовательскую подсказку как массив строк вместо одной строки, с маркером `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` между статической частью и остальным. Используйте это, когда ваша подсказка объединяет инструкции, которые одинаковы на каждом запросе, с контекстом, который изменяется для каждого запроса, например клиент или билет, который обрабатывает агент. Когда вы передаёте обе части как одну строку, изменение части для каждого запроса изменяет всю системную подсказку, поэтому статические инструкции пропускают кэш тоже. Форма массива недоступна в Python SDK; [`ClaudeAgentOptions`](/docs/ru/agent-sdk/python#claudeagentoptions) перечисляет формы, которые принимает `system_prompt`.357В TypeScript SDK вы можете передать пользовательскую подсказку как массив строк вместо одной строки, с маркером `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` между статической частью и остальным. Используйте это, когда ваша подсказка объединяет инструкции, которые одинаковы на каждом запросе, с контекстом, который изменяется для каждого запроса, например клиент или билет, который обрабатывает агент. Когда вы передаёте обе части как одну строку, изменение части для каждого запроса изменяет всю системную подсказку, поэтому статические инструкции пропускают кэш тоже. Форма массива недоступна в Python SDK; [`ClaudeAgentOptions`](/docs/ru/agent-sdk/python#claudeagentoptions) перечисляет формы, которые принимает `system_prompt`.

356 358

357<Note>359<Note>

358 SDK разделяет подсказку только когда он вызывает Claude API напрямую или работает на [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Во всех остальных конфигурациях, таких как Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или [LLM gateway](/docs/ru/llm-gateway-connect), и когда вы установите [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities), SDK отправляет всю подсказку как один блок, то же самое, что передача одной строки.360 Claude Code разделяет подсказку только когда он вызывает Claude API напрямую или работает на [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Во всех остальных конфигурациях, таких как Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или [LLM gateway](/docs/ru/llm-gateway-connect), он отправляет всю подсказку как один блок, то же самое, что передача одной строки. То же самое происходит, когда вы установите [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities).

359</Note>361</Note>

360 362

361Чтобы разделить подсказку, импортируйте `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` из `@anthropic-ai/claude-agent-sdk` и передайте его как собственный элемент массива между двумя частями. SDK отправляет строки перед маркером как один текстовый блок и строки после него как второй блок, каждый со своей собственной точкой разрыва кэша. В примере ниже агент поддержки загружает свои инструкции по сортировке из файла и получает детали об одном билете на каждый запрос, поэтому инструкции остаются в кэше, пока детали билета изменяются:363Чтобы разделить подсказку, импортируйте `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` из `@anthropic-ai/claude-agent-sdk` и передайте его как собственный элемент массива между двумя частями. SDK отправляет строки перед маркером как один текстовый блок и строки после него как второй блок, каждый со своей собственной точкой разрыва кэша. В примере ниже агент поддержки загружает свои инструкции по сортировке из файла и получает детали об одном билете на каждый запрос, поэтому инструкции остаются в кэше, пока детали билета изменяются:

418 420

419Запись `append` или пользовательской подсказки по умолчанию требует Claude Code v2.1.265 или позже, который TypeScript Agent SDK поставляет с v0.3.265 и Python Agent SDK с v0.2.153. До Claude Code v2.1.268 сеансы, которые не [получают флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), включая сеансы на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, перестраивали подсказку на каждом запросе и `snapshot` не имел эффекта.421Запись `append` или пользовательской подсказки по умолчанию требует Claude Code v2.1.265 или позже, который TypeScript Agent SDK поставляет с v0.3.265 и Python Agent SDK с v0.2.153. До Claude Code v2.1.268 сеансы, которые не [получают флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), включая сеансы на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, перестраивали подсказку на каждом запросе и `snapshot` не имел эффекта.

420 422

423<h2 id="context-claude-code-adds-outside-the-system-prompt">

424 Контекст, который Claude Code добавляет вне системного приглашения

425</h2>

426

427Системные напоминания — это сообщения, которые Claude Code добавляет в беседу во время сеанса, чтобы предоставить Claude контекст, например содержимое ваших файлов CLAUDE.md или примечание об изменении файла на диске. Claude Code отправляет их в беседу, а не в системное приглашение, поэтому они достигают Claude независимо от того, используете ли вы предустановку `claude_code` или передаёте собственную строку как `systemPrompt`.

428

429В этом разделе рассматриваются [напоминания, которые с наибольшей вероятностью изменят поведение вашего агента](#reminders-claude-code-adds-to-the-conversation), как [отключить те, которые заменяет ваш агент](#turn-off-the-context-your-agent-replaces), и как [увидеть, что получил Claude](#see-what-claude-received) в конкретном запросе.

430

431<h3 id="reminders-claude-code-adds-to-the-conversation">

432 Напоминания, которые Claude Code добавляет в беседу

433</h3>

434

435Системные напоминания — это текст, который Claude Code добавляет в беседу вместе с приглашениями, которые отправляет ваш код. Следующие напоминания — это те, которые с наибольшей вероятностью изменят поведение вашего агента:

436

437* **Инструкции проекта**: файлы CLAUDE.md, которые загружает ваш параметр [`settingSources`](#claude-md-files-for-project-level-instructions)

438* **Инструкции по стилю вывода**: инструкции активного [стиля вывода](#output-styles-for-persistent-configurations) в основной беседе

439* **Атрибуция коммитов и запросов на слияние**: трейлер `Co-Authored-By` и нижний колонтитул запроса на слияние из параметра [`attribution`](/docs/ru/settings-reference#attribution)

440* **Вывод hooks**: текст, который ваши [hooks](/docs/ru/agent-sdk/hooks#outputs) возвращают как `additionalContext`

441* **Доступные skills**: имена и описания [skills](/docs/ru/agent-sdk/skills), которые может вызвать Claude

442* **Доступные subagents**: имена и описания [subagents](/docs/ru/agent-sdk/subagents), которые может запустить Claude

443* **Подсказки списка задач**: в [сеансе, который имеет инструменты отслеживания задач](/docs/ru/agent-sdk/todo-tracking#model-availability), приглашение обновить список задач, когда Claude не трогал его несколько ходов

444* **Примечания об изменённых файлах**: примечание о том, что файл, который Claude читал ранее, изменился на диске

445

446Claude Code представляет ваши файлы CLAUDE.md строкой, сообщающей Claude, что инструкции переопределяют поведение по умолчанию.

447

448Если вы передаёте собственную строку как `systemPrompt`, добавьте в неё предложение, объясняющее, что такое системное напоминание. Предустановка `claude_code` имеет одно, и ваша строка заменяет всю предустановку. Без этого ничто в вашем приглашении не говорит Claude, что напоминания, такие как содержимое CLAUDE.md и вывод hooks, поступают из приложения, а не от пользователя. Например:

449

450```text theme={null}

451The application adds system reminders to this conversation. Treat them as context from the application, not as messages from the user.

452```

453

454<h3 id="turn-off-the-context-your-agent-replaces">

455 Отключите контекст, который заменяет ваш агент

456</h3>

457

458Отключите часть встроенного контекста, когда ваш агент предоставляет собственную версию того же руководства. Например, если ваше приглашение говорит Claude писать сообщения коммитов как `PROJ-142: fix login redirect` без трейлеров, Claude Code всё равно говорит Claude заканчивать каждое сообщение коммита трейлером `Co-Authored-By`, поэтому Claude получает два конфликтующих инструкции для одного коммита.

459

460Передавайте ключи параметров через параметр [`settings`](/docs/ru/agent-sdk/typescript#options) в TypeScript или [`settings`](/docs/ru/agent-sdk/python#claudeagentoptions) в Python, и переменные окружения через параметр `env`. В TypeScript [`env`](/docs/ru/agent-sdk/typescript#options) заменяет унаследованное окружение, поэтому распределите `process.env` в него.

461

462| Встроенный контекст | Как его отключить |

463| :- | :- |

464| Встроенные инструкции коммитов и запросов на слияние и снимок статуса git | Установите [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions) в `false`, или `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1` |

465| Трейлер `Co-Authored-By` и нижний колонтитул запроса на слияние | Установите [`attribution.commit`](/docs/ru/settings-reference#attribution-commit) и [`attribution.pr`](/docs/ru/settings-reference#attribution-pr) на собственный текст, или на пустые строки для их удаления |

466| Источник параметров пользователя или проекта, включая его CLAUDE.md | Оставьте `'user'` или `'project'` вне [`settingSources`](/docs/ru/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) |

467| Каждый файл CLAUDE.md | Установите `CLAUDE_CODE_DISABLE_CLAUDE_MDS=1` |

468| Подсказки списка задач, примечания об изменённых файлах и список skills | Установите `CLAUDE_CODE_DISABLE_ATTACHMENTS=1` |

469

470Встроенные инструкции Claude Code для коммитов и запросов на слияние — это не напоминание. Они являются частью описания инструмента Bash, поэтому они также достигают Claude при передаче пользовательского `systemPrompt`.

471

472Если вы установите `CLAUDE_CODE_DISABLE_ATTACHMENTS`, Claude Code также отправляет упоминания файлов `@` как простой текст вместо их расширения в содержимое файла. Список доступных subagents и уведомления о фоновых задачах всё ещё поступают.

473

474Следующий пример предназначен для агента, который несёт собственные правила коммитов в `append`. Он устанавливает оба ключа `attribution` на пустые строки для удаления трейлера и нижнего колонтитула и отключает `includeGitInstructions`, чтобы собственные инструкции рабочего процесса коммитов Claude Code не конкурировали с вашими:

475

476<CodeGroup>

477 ```typescript TypeScript theme={null}

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

479

480 for await (const message of query({

481 prompt: "Commit the staged changes for ticket PROJ-142",

482 options: {

483 systemPrompt: {

484 type: "preset",

485 preset: "claude_code",

486 append: "Write commit messages as: <ticket id>: <summary>. Add no trailers."

487 },

488 settings: {

489 includeGitInstructions: false,

490 attribution: { commit: "", pr: "" }

491 },

492 allowedTools: ["Bash(git *)"]

493 }

494 })) {

495 if (message.type === "result") console.log(message.subtype);

496 }

497 ```

498

499 ```python Python theme={null}

500 import asyncio

501 from claude_agent_sdk import query, ClaudeAgentOptions

502

503

504 async def main():

505 async for message in query(

506 prompt="Commit the staged changes for ticket PROJ-142",

507 options=ClaudeAgentOptions(

508 system_prompt={

509 "type": "preset",

510 "preset": "claude_code",

511 "append": "Write commit messages as: <ticket id>: <summary>. Add no trailers.",

512 },

513 settings='{"includeGitInstructions": false, "attribution": {"commit": "", "pr": ""}}',

514 allowed_tools=["Bash(git *)"],

515 ),

516 ):

517 print(message)

518

519

520 asyncio.run(main())

521 ```

522</CodeGroup>

523

524Чтобы подтвердить изменение, запустите пример в репозитории с поставленными в очередь изменениями и проверьте новый коммит с помощью `git log -1`. Сообщение заканчивается без трейлера `Co-Authored-By`.

525

526<h3 id="see-what-claude-received">

527 Посмотрите, что получил Claude

528</h3>

529

530Поток сообщений SDK не включает системные напоминания, поэтому чтение сообщений, которые получает ваш код, не покажет вам, что видел Claude. Чтобы их увидеть, логируйте запросы, которые отправляет Claude Code:

531

532* **Логирование необработанных запросов**: установите [`OTEL_LOG_RAW_API_BODIES`](/docs/ru/monitoring-usage#api-request-body-event) в `file:<dir>`. Claude Code записывает каждое тело запроса в этот каталог.

533* **Шлюз, который вы контролируете**: укажите [`ANTHROPIC_BASE_URL`](/docs/ru/llm-gateway) на прокси, который логирует тела запросов.

534

535В логируемом запросе посмотрите в массив `messages`. Напоминание появляется внутри пользовательского сообщения, обёрнутого в теги `<system-reminder>`, или, на некоторых моделях, как отдельное сообщение с ролью `system`.

536

421<h2 id="compare-the-four-approaches">537<h2 id="compare-the-four-approaches">

422 Сравнение четырех подходов538 Сравнение четырех подходов

423</h2>539</h2>

agent-sdk/observability.md +2 −2

Details

253| Переменная | Добавляет |253| Переменная | Добавляет |

254| - | - |254| - | - |

256| `OTEL_LOG_TOOL_DETAILS=1` | Аргументы входных данных инструмента (пути файлов, команды оболочки, шаблоны поиска) на событиях `claude_code.tool_result` |256| `OTEL_LOG_TOOL_DETAILS=1` | Аргументы входных данных инструмента, такие как пути файлов, команды оболочки и шаблоны поиска на событиях `claude_code.tool_result`, а также реальные имена агента, skill, plugin и MCP сервера на [метриках стоимости и токенов](/docs/ru/monitoring-usage#cost-counter) |

257| `OTEL_LOG_TOOL_CONTENT=1` | Событие span [`tool.output`](/docs/ru/monitoring-usage#tool-output-span-event) на `claude_code.tool` с содержимым файлов и выводом Bash, усечённое на 60 КБ по умолчанию, настраиваемое через `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, что требует Claude Code v2.1.214 или более поздней версии. Требует, чтобы [трассировка](#read-agent-traces) была включена. Атрибуты span содержат содержимое инструмента в соответствии с [их собственными шлюзами](/docs/ru/monitoring-usage#new-context-gates) |257| `OTEL_LOG_TOOL_CONTENT=1` | Событие span [`tool.output`](/docs/ru/monitoring-usage#tool-output-span-event) на `claude_code.tool` с содержимым файлов, выводом Bash и тем, что возвращают инструменты MCP, WebFetch и WebSearch, усечённое на 60 КБ по умолчанию, настраиваемое через `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, что требует Claude Code v2.1.214 или более поздней версии. Результаты от инструментов MCP, WebFetch и WebSearch требуют Claude Code v2.1.283 или более поздней версии. Требует, чтобы [трассировка](#read-agent-traces) была включена. Атрибуты span содержат содержимое инструмента в соответствии с [их собственными шлюзами](/docs/ru/monitoring-usage#new-context-gates) |

258| `OTEL_LOG_RAW_API_BODIES` | Полный JSON запроса и ответа Anthropic Messages API как события логов `claude_code.api_request_body` и `claude_code.api_response_body`. Установите на `1` для встроенных тел, усечённых на 60 КБ по умолчанию, или `file:<dir>` для неусечённых тел на диске с путём `body_ref` в событии. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` настраивает лимит встроенного усечения, и требует Claude Code v2.1.214 или более поздней версии. Тела включают всю историю разговора и имеют содержимое расширенного мышления отредактировано. Включение этого подразумевает согласие на всё, что раскроют три переменные выше |258| `OTEL_LOG_RAW_API_BODIES` | Полный JSON запроса и ответа Anthropic Messages API как события логов `claude_code.api_request_body` и `claude_code.api_response_body`. Установите на `1` для встроенных тел, усечённых на 60 КБ по умолчанию, или `file:<dir>` для неусечённых тел на диске с путём `body_ref` в событии. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` настраивает лимит встроенного усечения, и требует Claude Code v2.1.214 или более поздней версии. Тела включают всю историю разговора и имеют содержимое расширенного мышления отредактировано. Включение этого подразумевает согласие на всё, что раскроют три переменные выше |

259 259

260Оставьте эти переменные неустановленными, если ваш конвейер наблюдаемости не одобрен для хранения данных, которые обрабатывает ваш агент. См. [Безопасность и конфиденциальность](/docs/ru/monitoring-usage#security-and-privacy) в справочнике Monitoring для полного списка атрибутов и поведения редактирования.260Оставьте эти переменные неустановленными, если ваш конвейер наблюдаемости не одобрен для хранения данных, которые обрабатывает ваш агент. См. [Безопасность и конфиденциальность](/docs/ru/monitoring-usage#security-and-privacy) в справочнике Monitoring для полного списка атрибутов и поведения редактирования.

agent-sdk/permissions.md +7 −3

Details

41 </Step>41 </Step>

42 42

43 <Step title="Allow rules">43 <Step title="Allow rules">

44 Проверьте правила `allow` (из `allowed_tools` и settings.json). Если правило совпадает, инструмент одобряется. Вызов, который инструмент одобряет самостоятельно, также разрешается на этом шаге без необходимости в правиле: например, чтение файла в ваших рабочих каталогах или [команда Bash только для чтения](/docs/ru/permissions#read-only-commands). Удаления `rm` и `rmdir`, нацеленные на [критический путь](/docs/ru/permission-modes#critical-paths), никогда не одобряются правилом allow: они достигают вашего callback в режимах, которые запрашивают, переходят в [классификатор](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) в режиме `auto` на Claude Code v2.1.218 или позже, и отклоняются в режиме `dontAsk`.44 Проверьте правила `allow` (из `allowed_tools` и settings.json). Если правило совпадает, инструмент одобряется. Вызов, который инструмент одобряет самостоятельно, также разрешается на этом шаге без необходимости в правиле: например, чтение файла в ваших рабочих каталогах или [команда Bash только для чтения](/docs/ru/permissions#read-only-commands).

46 Удаления `rm` и `rmdir`, нацеленные на [критический путь](/docs/ru/permission-modes#critical-paths), никогда не одобряются правилом allow. Достигают ли они вашего callback, зависит от режима разрешений: например, в сеансе Agent SDK в режиме `auto` Claude Code отклоняет их по умолчанию без вызова. Таблица режима [Critical paths](/docs/ru/permission-modes#critical-paths) перечисляет, что каждый режим с ними делает.

45 </Step>47 </Step>

46 48

47 <Step title="canUseTool callback">49 <Step title="canUseTool callback">

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

90 92

91<Warning>93<Warning>

92 **Автоматически одобренные инструменты никогда не достигают `canUseTool`.** Вызов инструмента, одобренный на любом более раннем этапе, по `acceptEdits` или `bypassPermissions`, или по правилу разрешения, пропускает ваш обратный вызов `canUseTool`, поэтому проверки разрешений, которые вы там поместили, молча обходятся для этого инструмента. `AskUserQuestion`, инструменты MCP, отмеченные [`_meta["anthropic/requiresUserInteraction"]`](/docs/ru/mcp#require-approval-for-a-specific-tool), инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools), и удаления `rm` и `rmdir`, нацеленные на [критический путь](/docs/ru/permission-modes#critical-paths), по-прежнему достигают обратного вызова, даже когда правило разрешения совпадает. В режиме `auto` удаления критических путей переходят к [классификатору](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) вместо обратного вызова, в то время как другие вызовы, перечисленные здесь, по-прежнему достигают его; маршрутизация классификатора требует Claude Code v2.1.218 или позже. В режиме `dontAsk` эти вызовы вместо этого отклоняются, без вызова обратного вызова.94 **Автоматически одобренные инструменты никогда не достигают `canUseTool`.** Вызов инструмента, одобренный на любом более раннем этапе, по `acceptEdits` или `bypassPermissions`, или по правилу разрешения, пропускает ваш обратный вызов `canUseTool`, поэтому проверки разрешений, которые вы там поместили, молча обходятся для этого инструмента.

96 Правило разрешения никогда не одобряет автоматически `AskUserQuestion`, инструменты MCP, отмеченные [`_meta["anthropic/requiresUserInteraction"]`](/docs/ru/mcp#require-approval-for-a-specific-tool), инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools), или удаления `rm` и `rmdir`, нацеленные на [критический путь](/docs/ru/permission-modes#critical-paths). В режиме `dontAsk` Claude Code отклоняет эти вызовы без вызова обратного вызова. В других режимах первые три достигают обратного вызова. В зависимости от [режима разрешений](/docs/ru/permission-modes#critical-paths), удаление критического пути либо достигает обратного вызова, либо Claude Code отклоняет его без вызова, как это происходит по умолчанию для сеанса Agent SDK в режиме `auto`.

93 97

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

95</Warning>99</Warning>

301 305

302Редактирование файлов никогда не одобряется автоматически в режиме планирования, даже когда правило разрешения совпадает. Вместо этого они запрашиваются через ваш обратный вызов `canUseTool`. В Claude Code v2.1.212 или более поздней версии команды оболочки, которые изменяют файлы, такие как `touch` и `rm`, достигают вашего обратного вызова `canUseTool` таким же образом.306Редактирование файлов никогда не одобряется автоматически в режиме планирования, даже когда правило разрешения совпадает. Вместо этого они запрашиваются через ваш обратный вызов `canUseTool`. В Claude Code v2.1.212 или более поздней версии команды оболочки, которые изменяют файлы, такие как `touch` и `rm`, достигают вашего обратного вызова `canUseTool` таким же образом.

303 307

304Если вы установите `allowDangerouslySkipPermissions: true` вместе с `permissionMode: 'plan'`, редактирование файлов и команды оболочки, которые изменяют файлы, по-прежнему достигают вашего обратного вызова `canUseTool`. Опция позволяет вам позже переключиться на `bypassPermissions` с помощью `setPermissionMode()`.308В TypeScript SDK, если вы установите `allowDangerouslySkipPermissions: true` вместе с `permissionMode: 'plan'`, редактирование файлов и команды оболочки, которые изменяют файлы, по-прежнему достигают вашего обратного вызова `canUseTool`. Опция позволяет вам позже переключиться на `bypassPermissions` с помощью `setPermissionMode()`.

305 309

306Claude может использовать `AskUserQuestion` для уточнения требований перед финализацией плана. См. [Обработка одобрений и ввода пользователя](/docs/ru/agent-sdk/user-input#handle-clarifying-questions) для обработки этих запросов.310Claude может использовать `AskUserQuestion` для уточнения требований перед финализацией плана. См. [Обработка одобрений и ввода пользователя](/docs/ru/agent-sdk/user-input#handle-clarifying-questions) для обработки этих запросов.

307 311

agent-sdk/plugins.md +1 −1

Details

331 Plugin не загружается331 Plugin не загружается

332</h3>332</h3>

333 333

334Если ваш plugin не появляется в сообщении инициализации:334Если ваш plugin не появляется в списке `plugins` сообщения инициализации, проверьте его поле [`plugin_errors`](/docs/ru/agent-sdk/typescript#sdksystemmessage) для получения причины, затем выполните следующие проверки:

335 335

3361. **Проверьте путь**: убедитесь, что путь указывает на корневую директорию plugin, родительскую директорию `skills/`, `agents/`, `hooks/`, `commands/` или `.claude-plugin/`3361. **Проверьте путь**: убедитесь, что путь указывает на корневую директорию plugin, родительскую директорию `skills/`, `agents/`, `hooks/`, `commands/` или `.claude-plugin/`

3372. **Проверьте plugin.json**: если ваш plugin включает манифест, убедитесь, что он имеет корректный синтаксис JSON3372. **Проверьте plugin.json**: если ваш plugin включает манифест, убедитесь, что он имеет корректный синтаксис JSON

agent-sdk/python.md +148 −144

Details

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

296| :- | :- | :- |296| :- | :- | :- |

297| `session_id` | `str` | Уникальный идентификатор сеанса |297| `session_id` | `str` | Уникальный идентификатор сеанса |

298| `summary` | `str` | Отображаемое название: пользовательское название, автоматически созданное резюме или первая подсказка |298| `summary` | `str` | Отображаемое название: пользовательское название, самый последний запрос, автоматически созданное резюме или первый запрос |

299| `last_modified` | `int` | Время последнего изменения в миллисекундах с начала эпохи |299| `last_modified` | `int` | Время последнего изменения в миллисекундах с начала эпохи |

760</h2>760</h2>

761 761

762<Note>762<Note>

763 **`@dataclass` vs `TypedDict`:** Этот SDK использует два вида типов. Классы, украшенные `@dataclass` (такие как `ResultMessage`, `AgentDefinition`, `TextBlock`), являются экземплярами объектов во время выполнения и поддерживают доступ к атрибутам: `msg.result`. Классы, определенные с помощью `TypedDict` (такие как `ThinkingConfigEnabled`, `McpStdioServerConfig`, `SyncHookJSONOutput`), являются **простыми словарями во время выполнения** и требуют доступа к ключам: `config["budget_tokens"]`, а не `config.budget_tokens`. Синтаксис вызова `ClassName(field=value)` работает для обоих, но только dataclasses создают объекты с атрибутами.763 **`@dataclass` vs `TypedDict`:** Этот SDK использует два вида типов. Классы, украшенные `@dataclass` (такие как `ResultMessage`, `AgentDefinition`, `TextBlock`), являются экземплярами объектов во время выполнения и поддерживают доступ к атрибутам: `msg.result`. Классы, определённые с помощью `TypedDict` (такие как `ThinkingConfigEnabled`, `McpStdioServerConfig`, `SyncHookJSONOutput`), являются **простыми словарями во время выполнения** и требуют доступа по ключам: `config["budget_tokens"]`, а не `config.budget_tokens`. Синтаксис вызова `ClassName(field=value)` работает для обоих, но только dataclasses создают объекты с атрибутами.

764</Note>764</Note>

765 765

766<h3 id="sdkmcptool">766<h3 id="sdkmcptool">

767 `SdkMcpTool`767 `SdkMcpTool`

768</h3>768</h3>

769 769

770Определение для SDK MCP tool, созданного с помощью декоратора `@tool`.770Определение инструмента SDK MCP, созданного с помощью декоратора `@tool`.

771 771

772```python theme={null}772```python theme={null}

773@dataclass773@dataclass

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

783| :- | :- | :- |783| :- | :- | :- |

784| `name` | `str` | Уникальный идентификатор инструмента |784| `name` | `str` | Уникальный идентификатор инструмента |

785| `description` | `str` | Понятное описание |785| `description` | `str` | Описание, понятное человеку |

789 789

791 `Transport`791 `Transport`

792</h3>792</h3>

793 793

794Абстрактный базовый класс для пользовательских реализаций транспорта. Используйте это для связи с процессом Claude через пользовательский канал (например, удаленное соединение вместо локального подпроцесса).794Абстрактный базовый класс для пользовательских реализаций транспорта. Используйте это для связи с процессом Claude через пользовательский канал (например, удалённое соединение вместо локального подпроцесса).

795 795

796<Warning>796<Warning>

797 Это низкоуровневый внутренний API. Интерфейс может измениться в будущих выпусках. Пользовательские реализации должны быть обновлены в соответствии с любыми изменениями интерфейса.797 Это низкоуровневый внутренний API. Интерфейс может измениться в будущих версиях. Пользовательские реализации должны быть обновлены в соответствии с любыми изменениями интерфейса.

798</Warning>798</Warning>

799 799

800```python theme={null}800```python theme={null}

825 825

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

827| :- | :- |827| :- | :- |

834 834

835Импорт: `from claude_agent_sdk import Transport`835Импорт: `from claude_agent_sdk import Transport`

836 836

838 `ClaudeAgentOptions`838 `ClaudeAgentOptions`

839</h3>839</h3>

840 840

841Dataclass конфигурации для запросов Claude Code.841Конфигурационный dataclass для запросов Claude Code.

842 842

843```python theme={null}843```python theme={null}

844@dataclass844@dataclass

875 include_partial_messages: bool = False875 include_partial_messages: bool = False

876 include_hook_events: bool = False876 include_hook_events: bool = False

877 forward_subagent_text: bool = False877 forward_subagent_text: bool = False

878 verbatim_prompts: bool = False

878 fork_session: bool = False879 fork_session: bool = False

879 resume_session_at: str | None = None880 resume_session_at: str | None = None

880 resume_drops_turn: str | None = None881 resume_drops_turn: str | None = None

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

897| :- | :- | :- | :- |898| :- | :- | :- | :- |

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

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

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

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

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

906| `session_id` | `str \| None` | `None` | Используйте определенный ID сеанса вместо автоматически сгенерированного. Должен быть действительным UUID. Не может быть объединен с `continue_conversation` или `resume`, если `fork_session` также не установлен |907| `session_id` | `str \| None` | `None` | Используйте определённый ID сеанса вместо автоматически сгенерированного. Должен быть действительным UUID. Не может быть объединён с `continue_conversation` или `resume`, если `fork_session` также не установлен |

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

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

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

916| `cwd` | `str \| Path \| None` | `None` | Текущий рабочий каталог |917| `cwd` | `str \| Path \| None` | `None` | Текущий рабочий каталог |

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

920| `env` | `dict[str, str]` | `{}` | Переменные окружения, объединенные поверх унаследованного окружения процесса. См. [Environment variables](/docs/ru/env-vars) для переменных, которые читает базовый CLI, и [Handle slow or stalled API responses](#handle-slow-or-stalled-api-responses) для переменных, связанных с тайм-аутом. Установите `CLAUDE_AGENT_SDK_CLIENT_APP` для идентификации вашего приложения в заголовке User-Agent |921| `env` | `dict[str, str]` | `{}` | Переменные окружения, объединённые поверх унаследованного окружения процесса. См. [Переменные окружения](/docs/ru/env-vars) для переменных, которые читает базовый CLI, и [Обработка медленных или зависших ответов API](#handle-slow-or-stalled-api-responses) для переменных, связанных с тайм-аутом. Установите `CLAUDE_AGENT_SDK_CLIENT_APP` для идентификации вашего приложения в заголовке User-Agent |

921| `extra_args` | `dict[str, str \| None]` | `{}` | Дополнительные аргументы CLI для прямой передачи в CLI |922| `extra_args` | `dict[str, str \| None]` | `{}` | Дополнительные аргументы CLI для передачи непосредственно в CLI |

925| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Функция обратного вызова разрешения инструмента, вызываемая только когда [permission flow](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) переходит к подсказке. Не вызывается для вызовов, автоматически одобренных `allowed_tools`, правилами разрешения или `permission_mode`. Правило разрешения не предварительно одобряет [действия, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves). См. [`CanUseTool`](#canusetool) для деталей |926| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Обратный вызов разрешения инструмента, вызываемый только когда [поток разрешения](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) переходит к приглашению. Не вызывается для вызовов, автоматически одобренных `allowed_tools`, правилами разрешения или `permission_mode`. Правило разрешения не предварительно одобряет [действия, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves). См. [`CanUseTool`](#canusetool) для деталей |

930| `forward_subagent_text` | `bool` | `False` | Переадресовать текст subagent и блоки мышления в поток сообщений. Без этой опции Claude Code выдает subagent `tool_use` и `tool_result` блоки, но не текст или мышление. Требует Python Agent SDK 0.2.140 или позже |931| `forward_subagent_text` | `bool` | `False` | Пересылать текст subagent и блоки thinking в поток сообщений. Без этой опции Claude Code выдаёт блоки `tool_use` и `tool_result` subagent, но не текст или thinking. Требует Python Agent SDK 0.2.140 или позже |

931| `fork_session` | `bool` | `False` | При возобновлении с `resume` разветвитесь на новый ID сеанса вместо продолжения исходного сеанса |932| `verbatim_prompts` | `bool` | `False` | Доставлять каждое приглашение как написано. SDK отправляет каждое пользовательское сообщение с `client_composed`, установленным на `True`. См. [`client_composed`](/docs/ru/agent-sdk/typescript#sdkusermessage) для того, что Claude Code пропускает на этих сообщениях. Используйте эту опцию, когда текст вашего приглашения включает содержимое, которое конечный пользователь не вводил. Для управления по ходам оставьте его отключённым и установите `"client_composed": True` на отдельных потоковых сообщениях вместо этого. Пока опция включена, SDK перезаписывает любое значение `client_composed`, которое вы установили. Требует Python Agent SDK 0.2.158 или позже и Claude Code v2.1.248 или позже; CLI, поставляемый с этими версиями SDK, удовлетворяет требованию Claude Code |

933| `resume_drops_turn` | `str \| None` | `None` | UUID пользовательского запроса, чей ход усечение `resume_session_at` отбрасывает. Когда установлено, CLI отказывает в возобновлении, если отброшенный диапазон содержит записи, не относящиеся к этому ходу. Требует Python Agent SDK 0.2.137 или позже и Claude Code v2.1.223 или позже; CLI, поставляемый с этими версиями SDK, удовлетворяет требованию Claude Code |934| `resume_session_at` | `str \| None` | `None` | При возобновлении загрузить разговор только до и включая сообщение с этим UUID. Используйте с `resume`, и обычно `fork_session`, для ветвления с более ранней точки. Требует Python Agent SDK 0.2.137 или позже |

934| `agents` | `dict[str, AgentDefinition] \| None` | `None` | Программно определенные subagents |935| `resume_drops_turn` | `str \| None` | `None` | UUID пользовательского приглашения, чей ход усечение `resume_session_at` отбрасывает. Когда установлено, CLI отказывает в возобновлении, если отброшенный диапазон содержит записи, не относящиеся к этому ходу. Требует Python Agent SDK 0.2.137 или позже и Claude Code v2.1.223 или позже; CLI, поставляемый с этими версиями SDK, удовлетворяет требованию Claude Code |

937| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI defaults: all sources) | Контролируйте, какие параметры файловой системы загружать. Передайте `[]` для отключения пользовательских, проектных и локальных параметров. С `skills` установленным и этим полем не установленным, загружаются только пользовательские и проектные источники. Установите `setting_sources` явно, чтобы сохранить локальные параметры. Управляемая политика конечной точки загружается независимо; параметры, управляемые сервером, загружаются, когда сеанс аутентифицируется с учетными данными организации на [подходящей конфигурации](/docs/ru/server-managed-settings#platform-availability). Для входов, читаемых независимо от этой опции, см. [What settingSources does not control](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) |938| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | Настроить поведение sandbox программно. См. [Параметры sandbox](#sandboxsettings) для деталей |

938| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills, доступные сеансу. Передайте `"all"` для включения каждого обнаруженного skill, или список имен skills. Передавайте только точные имена. SDK отклоняет неправильно сформированные и имена в форме подстановочных знаков с `ValueError` перед запуском процесса Claude Code; эта проверка требует Python Agent SDK 0.2.129 или позже. Когда установлено, SDK автоматически добавляет инструмент Skill в `allowed_tools`. Если вы также передаете `tools`, включите `"Skill"` в этот список. См. [Skills](/docs/ru/agent-sdk/skills) |939| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI defaults: all sources) | Контролировать, какие параметры файловой системы загружать. Передайте `[]` для отключения пользовательских, проектных и локальных параметров. С установленным `skills` и этим полем не установленным, загружаются только пользовательские и проектные источники. Установите `setting_sources` явно, чтобы сохранить локальные параметры. Политика, управляемая конечной точкой, загружается независимо; параметры, управляемые сервером, извлекаются, когда сеанс аутентифицируется с учётными данными организации на [подходящей конфигурации](/docs/ru/server-managed-settings#platform-availability). Для входных данных, читаемых независимо от этой опции, см. [Что settingSources не контролирует](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

939| `max_thinking_tokens` | `int \| None` | `None` | *Устарело* - Максимальные токены для блоков мышления. Вместо этого используйте `thinking` |940| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills, доступные для сеанса. Передайте `"all"` для включения каждого обнаруженного skill, или список имён skills. Передавайте только точные имена. SDK отклоняет неправильно сформированные и имена в форме подстановочных знаков с `ValueError` перед запуском процесса Claude Code; эта проверка требует Python Agent SDK 0.2.129 или позже. Когда установлено, SDK автоматически добавляет инструмент Skill в `allowed_tools`. Если вы также передаёте `tools`, включите `"Skill"` в этот список. См. [Skills](/docs/ru/agent-sdk/skills) |

944| `session_store` | [`SessionStore`](/docs/ru/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Зеркалировать стенограммы сеансов во внешний бэкэнд, чтобы другой хост мог их возобновить. См. [Сохранять сеансы во внешнее хранилище](/docs/ru/agent-sdk/session-storage) |

943| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Когда сбрасывать записи зеркальной стенограммы в `session_store`. `"batched"` сбрасывает один раз за ход или когда буфер заполняется; `"eager"` запускает фоновый сброс после каждого кадра. Игнорируется, когда `session_store` равен `None` |945| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Когда сбрасывать записи зеркальной стенограммы в `session_store`. `"batched"` сбрасывает один раз за ход или когда буфер заполняется; `"eager"` запускает фоновый сброс после каждого кадра. Игнорируется, когда `session_store` равен `None` |

944| `load_timeout_ms` | `int` | `60000` | Тайм-аут для каждого вызова `session_store.load()` и `list_subkeys()` во время материализации возобновления, в миллисекундах |946| `load_timeout_ms` | `int` | `60000` | Тайм-аут для каждого вызова `session_store.load()` и `list_subkeys()` во время материализации возобновления, в миллисекундах |

945| `task_budget` | `TaskBudget \| None` | `None` | Бюджет токенов на стороне API. Отправляется как `output_config.task_budget` с заголовком бета-версии `task-budgets-2026-03-13`. Передайте `{"total": <int>}`. |947| `task_budget` | `TaskBudget \| None` | `None` | Бюджет токенов на стороне API. Отправляется как `output_config.task_budget` с заголовком бета-версии `task-budgets-2026-03-13`. Передайте `{"total": <int>}`. |

948 Обработка медленных или зависших ответов API950 Обработка медленных или зависших ответов API

949</h4>951</h4>

950 952

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

952 954

953```python theme={null}955```python theme={null}

954from claude_agent_sdk import ClaudeAgentOptions956from claude_agent_sdk import ClaudeAgentOptions

962)964)

963```965```

964 966

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

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

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

968 970

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

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

971 973

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

973 975

974<h3 id="outputformat">976<h3 id="outputformat">

975 `OutputFormat`977 `OutputFormat`

978Конфигурация для валидации структурированного вывода. Передайте это как `dict` в поле `output_format` на `ClaudeAgentOptions`:980Конфигурация для валидации структурированного вывода. Передайте это как `dict` в поле `output_format` на `ClaudeAgentOptions`:

979 981

980```python theme={null}982```python theme={null}

981# Expected dict shape for output_format983# Ожидаемая форма dict для output_format

982{984{

983 "type": "json_schema",985 "type": "json_schema",

984 "schema": {...}, # Your JSON Schema definition986 "schema": {...}, # Ваше определение JSON Schema

985}987}

986```988```

987 989

994 `SystemPromptPreset`996 `SystemPromptPreset`

995</h3>997</h3>

996 998

997Конфигурация для использования предустановленной системной подсказки Claude Code с дополнительными добавлениями.999Конфигурация для использования предустановленного системного приглашения Claude Code с дополнительными добавлениями.

998 1000

999```python theme={null}1001```python theme={null}

1000class SystemPromptPreset(TypedDict):1002class SystemPromptPreset(TypedDict):

1007 1009

1009| :- | :- | :- |1011| :- | :- | :- |

1010| `type` | Да | Должно быть `"preset"` для использования предустановленной системной подсказки |1012| `type` | Да | Должно быть `"preset"` для использования предустановленного системного приглашения |

1011| `preset` | Да | Должно быть `"claude_code"` для использования системной подсказки Claude Code |1013| `preset` | Да | Должно быть `"claude_code"` для использования системного приглашения Claude Code |

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

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

1014| `snapshot` | Нет | Установите значение `False` для перестройки системной подсказки при каждом запросе вместо [повторного использования подсказки, которую сеанс записал при первом запросе](/docs/ru/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session). Требует `claude-agent-sdk` v0.2.153 или позже |1016| `snapshot` | Нет | Установите на `False` для перестроения системного приглашения при каждом запросе вместо [повторного использования приглашения, которое сеанс записал при первом запросе](/docs/ru/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session). Требует `claude-agent-sdk` v0.2.153 или позже |

1015 1017

1016<h3 id="systempromptcustom">1018<h3 id="systempromptcustom">

1017 `SystemPromptCustom`1019 `SystemPromptCustom`

1018</h3>1020</h3>

1019 1021

1020Пользовательская системная подсказка в форме объекта, эквивалентная передаче строки как `system_prompt`, которая также может установить `snapshot`. Требует `claude-agent-sdk` v0.2.153 или позже.1022Пользовательское системное приглашение в форме объекта, эквивалентное передаче строки как `system_prompt`, которое также может установить `snapshot`. Требует `claude-agent-sdk` v0.2.153 или позже.

1021 1023

1022```python theme={null}1024```python theme={null}

1023class SystemPromptCustom(TypedDict):1025class SystemPromptCustom(TypedDict):

1030| :- | :- | :- |1032| :- | :- | :- |

1031| `type` | Да | Должно быть `"custom"` |1033| `type` | Да | Должно быть `"custom"` |

1032| `prompt` | Да | Текст системной подсказки. Передается в CLI как аргумент командной строки, поэтому [ограничения длины командной строки](#systempromptfile) применяются |1034| `prompt` | Да | Текст системного приглашения. Передаётся в CLI как аргумент командной строки, поэтому применяются [ограничения длины командной строки](#systempromptfile) |

1033| `snapshot` | Нет | То же, что [`SystemPromptPreset.snapshot`](#systempromptpreset), применяется к `prompt` |1035| `snapshot` | Нет | То же, что [`SystemPromptPreset.snapshot`](#systempromptpreset), применяется к `prompt` |

1034 1036

1035<h3 id="systempromptfile">1037<h3 id="systempromptfile">

1036 `SystemPromptFile`1038 `SystemPromptFile`

1037</h3>1039</h3>

1038 1040

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

1040 1042

1041```python theme={null}1043```python theme={null}

1042class SystemPromptFile(TypedDict):1044class SystemPromptFile(TypedDict):

1046 1048

1048| :- | :- | :- |1050| :- | :- | :- |

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

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

1051 1053

1052<h3 id="settingsource">1054<h3 id="settingsource">

1053 `SettingSource`1055 `SettingSource`

1054</h3>1056</h3>

1055 1057

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

1057 1059

1058```python theme={null}1060```python theme={null}

1059SettingSource = Literal["user", "project", "local"]1061SettingSource = Literal["user", "project", "local"]

1061 1063

1063| :- | :- | :- |1065| :- | :- | :- |

1067 1069

1068<h4 id="default-behavior">1070<h4 id="default-behavior">

1069 Поведение по умолчанию1071 Поведение по умолчанию

1070</h4>1072</h4>

1071 1073

1072Когда `setting_sources` опущено или `None` и `skills` не установлен, `query()` загружает те же параметры файловой системы, что и Claude Code CLI: пользовательские, проектные и локальные. С `skills` установленным, строка [`setting_sources`](#claudeagentoptions) описывает текущее значение по умолчанию. Управляемые параметры политики загружаются во всех случаях; параметры, управляемые сервером, загружаются, когда сеанс аутентифицируется с учетными данными организации на [подходящей конфигурации](/docs/ru/server-managed-settings#platform-availability). Для получения дополнительной информации см. [What settingSources does not control](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control).1074Когда `setting_sources` опущен или `None` и `skills` не установлен, `query()` загружает те же параметры файловой системы, что и CLI Claude Code: пользовательские, проектные и локальные. С установленным `skills`, строка [`setting_sources`](#claudeagentoptions) описывает текущее значение по умолчанию. Политика, управляемая конечной точкой, загружается во всех случаях; параметры, управляемые сервером, извлекаются, когда сеанс аутентифицируется с учётными данными организации на [подходящей конфигурации](/docs/ru/server-managed-settings#platform-availability). Для получения дополнительной информации см. [Что settingSources не контролирует](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control).

1073 1075

1074<h4 id="why-use-setting_sources">1076<h4 id="why-use-setting_sources">

1075 Почему использовать setting\_sources1077 Почему использовать setting\_sources

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

1079 1081

1080```python theme={null}1082```python theme={null}

1081# Do not load user, project, or local settings from disk1083# Не загружать пользовательские, проектные или локальные параметры с диска

1082import asyncio1084import asyncio

1083from claude_agent_sdk import query, ClaudeAgentOptions1085from claude_agent_sdk import query, ClaudeAgentOptions

1084 1086

1100 В Python SDK 0.1.59 и более ранних версиях пустой список рассматривался так же, как опущение опции, поэтому `setting_sources=[]` не отключал параметры файловой системы. Обновитесь до более новой версии, если вам нужно, чтобы пустой список вступил в силу. TypeScript SDK не затронут.1102 В Python SDK 0.1.59 и более ранних версиях пустой список рассматривался так же, как опущение опции, поэтому `setting_sources=[]` не отключал параметры файловой системы. Обновитесь до более новой версии, если вам нужно, чтобы пустой список вступил в силу. TypeScript SDK не затронут.

1101</Note>1103</Note>

1102 1104

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

1104 1106

1105```python theme={null}1107```python theme={null}

1106# Load only project settings, ignore user and local1108# Загрузить только параметры проекта, игнорировать пользовательские и локальные

1107import asyncio1109import asyncio

1108from claude_agent_sdk import query, ClaudeAgentOptions1110from claude_agent_sdk import query, ClaudeAgentOptions

1109 1111

1112 async for message in query(1114 async for message in query(

1113 prompt="Run CI checks",1115 prompt="Run CI checks",

1114 options=ClaudeAgentOptions(1116 options=ClaudeAgentOptions(

1115 setting_sources=["project"] # Only .claude/settings.json1117 setting_sources=["project"] # Только .claude/settings.json

1116 ),1118 ),

1117 ):1119 ):

1118 print(message)1120 print(message)

1124**Приложения только SDK:**1126**Приложения только SDK:**

1125 1127

1126```python theme={null}1128```python theme={null}

1127# Define everything programmatically.1129# Определить всё программно.

1128# Pass [] to opt out of filesystem setting sources.1130# Передайте [] для отказа от источников параметров файловой системы.

1129import asyncio1131import asyncio

1130from claude_agent_sdk import AgentDefinition, ClaudeAgentOptions, query1132from claude_agent_sdk import AgentDefinition, ClaudeAgentOptions, query

1131 1133

1150asyncio.run(main())1152asyncio.run(main())

1151```1153```

1152 1154

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

1154 1156

1155<h4 id="settings-precedence">1157<h4 id="settings-precedence">

1156 Приоритет параметров1158 Приоритет параметров

1160 1162

11611. Локальные параметры (`.claude/settings.local.json`)11631. Локальные параметры (`.claude/settings.local.json`)

11622. Параметры проекта (`.claude/settings.json`)11642. Параметры проекта (`.claude/settings.json`)

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

1164 1166

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

1166 1168

1167<h3 id="agentdefinition">1169<h3 id="agentdefinition">

1168 `AgentDefinition`1170 `AgentDefinition`

1169</h3>1171</h3>

1170 1172

1171Конфигурация для subagent, определенного программно.1173Конфигурация для subagent, определённого программно.

1172 1174

1173```python theme={null}1175```python theme={null}

1174@dataclass1176@dataclass

1192| :- | :- | :- |1194| :- | :- | :- |

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

1194| `prompt` | Да | Системная подсказка агента |1196| `prompt` | Да | Системное приглашение агента |

1195| `tools` | Нет | Массив разрешенных имен инструментов. Если опущено, наследует каждый [инструмент, доступный для subagents](/docs/ru/sub-agents#available-tools) |1197| `tools` | Нет | Массив разрешённых имён инструментов. Если опущено, наследует каждый [инструмент, доступный для subagents](/docs/ru/sub-agents#available-tools) |

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

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

1198| `skills` | Нет | Список имен skills для предварительной загрузки в контекст агента при запуске. Неуказанные skills остаются вызываемыми через инструмент Skill |1200| `skills` | Нет | Список имён skills для предварительной загрузки в контекст агента при запуске. Неуказанные skills остаются вызываемыми через инструмент Skill |

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

1200| `mcpServers` | Нет | MCP servers, доступные этому агенту. Каждая запись - это имя сервера или встроенный словарь `{name: config}` |1202| `mcpServers` | Нет | MCP-серверы, доступные для этого агента. Каждая запись — это имя сервера или встроенный dict `{name: config}` |

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

1202| `maxTurns` | Нет | Максимальное количество агентских ходов перед остановкой агента |1204| `maxTurns` | Нет | Максимальное количество агентских ходов перед остановкой агента |

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

1204| `effort` | Нет | Уровень усилий рассуждения для этого агента. Принимает именованный уровень или целое число. См. [`EffortLevel`](#effortlevel) |1206| `effort` | Нет | Уровень усилий рассуждения для этого агента. Принимает именованный уровень или целое число. См. [`EffortLevel`](#effortlevel) |

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

1206 1208

1207<Note>1209<Note>

1208 Имена полей `AgentDefinition` используют camelCase, такие как `disallowedTools`, `permissionMode` и `maxTurns`. Эти имена напрямую соответствуют формату проводки, общему с TypeScript SDK. Это отличается от `ClaudeAgentOptions`, который использует Python snake\_case для эквивалентных полей верхнего уровня, таких как `disallowed_tools` и `permission_mode`. Поскольку `AgentDefinition` является dataclass, передача ключевого слова snake\_case вызывает `TypeError` во время конструирования.1210 Имена полей `AgentDefinition` используют camelCase, такие как `disallowedTools`, `permissionMode` и `maxTurns`. Эти имена напрямую отображаются на формат провода, общий с TypeScript SDK. Это отличается от `ClaudeAgentOptions`, который использует Python snake\_case для эквивалентных полей верхнего уровня, таких как `disallowed_tools` и `permission_mode`. Поскольку `AgentDefinition` является dataclass, передача ключевого слова snake\_case вызывает `TypeError` во время конструирования.

1209</Note>1211</Note>

1210 1212

1211<h3 id="permissionmode">1213<h3 id="permissionmode">

1212 `PermissionMode`1214 `PermissionMode`

1213</h3>1215</h3>

1214 1216

1215Режимы разрешений для управления выполнением инструментов.1217Режимы разрешения для контроля выполнения инструментов.

1216 1218

1217```python theme={null}1219```python theme={null}

1218PermissionMode = Literal[1220PermissionMode = Literal[

1219 "default", # Standard permission behavior1221 "default", # Стандартное поведение разрешения

1220 "acceptEdits", # Auto-accept file edits1222 "acceptEdits", # Автоматически принимать редактирования файлов

1221 "plan", # Planning mode - explore without editing1223 "plan", # Режим планирования - исследовать без редактирования

1222 "dontAsk", # Deny anything not pre-approved instead of prompting1224 "dontAsk", # Отрицать всё, что не предварительно одобрено, вместо запроса

1223 "bypassPermissions", # Bypass permission checks; explicit ask rules still prompt (use with caution)1225 "bypassPermissions", # Обойти проверки разрешения; явные правила запроса всё ещё запрашивают (используйте с осторожностью)

1224 "auto", # Model classifier approves or denies permission prompts1226 "auto", # Классификатор модели проверяет действия, такие как команды shell и сетевые запросы

1225]1227]

1226```1228```

1227 1229

1229 `EffortLevel`1231 `EffortLevel`

1230</h3>1232</h3>

1231 1233

1232Уровни усилий для руководства глубиной мышления.1234Уровни усилий для руководства глубиной thinking.

1233 1235

1234```python theme={null}1236```python theme={null}

1235EffortLevel = Literal[1237EffortLevel = Literal[

1236 "low", # Minimal thinking, fastest responses1238 "low", # Минимальное thinking, самые быстрые ответы

1237 "medium", # Moderate thinking1239 "medium", # Умеренное thinking

1238 "high", # Deep reasoning1240 "high", # Глубокое рассуждение

1239 "xhigh", # Extended reasoning; falls back to "high" on models that don't support it1241 "xhigh", # Расширенное рассуждение; откатывается на "high" на моделях, которые его не поддерживают

1240 "max", # Maximum effort1242 "max", # Максимальное усилие

1241]1243]

1242```1244```

1243 1245

1256Обратный вызов получает:1258Обратный вызов получает:

1257 1259

1258* `tool_name`: Имя вызываемого инструмента1260* `tool_name`: Имя вызываемого инструмента

1259* `input_data`: Входные параметры инструмента1261* `input_data`: Параметры входных данных инструмента

1260* `context`: `ToolPermissionContext` с дополнительной информацией1262* `context`: `ToolPermissionContext` с дополнительной информацией

1261 1263

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

1263 1265

1264Обратный вызов - это замена SDK для интерактивной подсказки разрешения: он вызывается только когда [permission evaluation flow](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) разрешается в подсказку. Вызовы инструментов, уже одобренные записью `allowed_tools`, правилом параметров разрешения или режимом разрешения, таким как `acceptEdits` или `bypassPermissions`, никогда его не вызывают. Правило разрешения не предварительно одобряет [действия, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves); см. [How permissions are evaluated](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) для того, какие из них достигают обратного вызова и что происходит в режиме `dontAsk` и `auto`. Чтобы контролировать каждый вызов инструмента, используйте вместо этого [hook `PreToolUse`](/docs/ru/agent-sdk/hooks).1266Обратный вызов — это замена SDK для интерактивного приглашения разрешения: он вызывается только когда [поток оценки разрешения](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) разрешается в приглашение. Вызовы инструментов, уже одобренные записью `allowed_tools`, правилом параметров разрешения или режимом разрешения, таким как `acceptEdits` или `bypassPermissions`, никогда его не вызывают. Для управления каждым вызовом инструмента используйте hook [`PreToolUse`](/docs/ru/agent-sdk/hooks) вместо этого.

1267

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

1265 1269

1266<h3 id="toolpermissioncontext">1270<h3 id="toolpermissioncontext">

1267 `ToolPermissionContext`1271 `ToolPermissionContext`

1268</h3>1272</h3>

1269 1273

1270Информация контекста, передаваемая в обратные вызовы разрешения инструмента.1274Информация контекста, передаваемая обратным вызовам разрешения инструмента.

1271 1275

1272```python theme={null}1276```python theme={null}

1273@dataclass1277@dataclass

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

1287| :- | :- | :- |1291| :- | :- | :- |

1289| `suggestions` | `list[PermissionUpdate]` | Предложения обновления разрешений из CLI. Подсказки Bash включают предложение с назначением `localSettings`, поэтому возврат его в `updated_permissions` записывает правило в `.claude/settings.local.json` и сохраняется между сеансами. |1293| `suggestions` | `list[PermissionUpdate]` | Предложения обновления разрешения из CLI. Приглашения Bash включают предложение с назначением `localSettings`, поэтому возврат его в `updated_permissions` записывает правило в `.claude/settings.local.json` и сохраняется между сеансами. |

1297 1301

1298<h3 id="permissionresult">1302<h3 id="permissionresult">

1299 `PermissionResult`1303 `PermissionResult`

1309 `PermissionResultAllow`1313 `PermissionResultAllow`

1310</h3>1314</h3>

1311 1315

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

1313 1317

1314```python theme={null}1318```python theme={null}

1315@dataclass1319@dataclass

1322| Поле | Тип | По умолчанию | Описание |1326| Поле | Тип | По умолчанию | Описание |

1323| :- | :- | :- | :- |1327| :- | :- | :- | :- |

1327 1331

1328<h3 id="permissionresultdeny">1332<h3 id="permissionresultdeny">

1329 `PermissionResultDeny`1333 `PermissionResultDeny`

1330</h3>1334</h3>

1331 1335

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

1333 1337

1334```python theme={null}1338```python theme={null}

1335@dataclass1339@dataclass

1342| Поле | Тип | По умолчанию | Описание |1346| Поле | Тип | По умолчанию | Описание |

1343| :- | :- | :- | :- |1347| :- | :- | :- | :- |

1345| `message` | `str` | `""` | Сообщение, объясняющее, почему инструмент был отклонен |1349| `message` | `str` | `""` | Сообщение, объясняющее, почему инструмент был отрицан |

1347 1351

1348<h3 id="permissionupdate">1352<h3 id="permissionupdate">

1373 1377

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

1375| :- | :- | :- |1379| :- | :- | :- |

1382 1386

1383<h3 id="permissionrulevalue">1387<h3 id="permissionrulevalue">

1384 `PermissionRuleValue`1388 `PermissionRuleValue`

1385</h3>1389</h3>

1386 1390

1387Правило для добавления, замены или удаления в обновлении разрешений.1391Правило для добавления, замены или удаления в обновлении разрешения.

1388 1392

1389```python theme={null}1393```python theme={null}

1390@dataclass1394@dataclass

1409 `ThinkingConfig`1413 `ThinkingConfig`

1410</h3>1414</h3>

1411 1415

1412Управляет поведением расширенного мышления. Объединение трех конфигураций:1416Контролирует поведение расширенного thinking. Объединение трёх конфигураций:

1413 1417

1414```python theme={null}1418```python theme={null}

1415ThinkingDisplay = Literal["summarized", "omitted"]1419ThinkingDisplay = Literal["summarized", "omitted"]

1437| :- | :- | :- |1441| :- | :- | :- |

1441 1445

1442Дополнительное поле `display` управляет тем, возвращается ли текст мышления `"summarized"` или `"omitted"`. На Claude Opus 4.7 и более поздних версиях API по умолчанию используется `"omitted"`, поэтому установите `"summarized"` для получения содержимого мышления в выводах [`ThinkingBlock`](#thinkingblock). Claude Code не отправляет `display` на Amazon Bedrock или Google Cloud's Agent Platform, поэтому на этих поставщиках Opus 4.7 и позже возвращают пустые выводы `ThinkingBlock` даже когда вы устанавливаете `display` на `"summarized"`.1446Дополнительное поле `display` контролирует, возвращается ли текст thinking `"summarized"` или `"omitted"`. На Claude Opus 4.7 и позже, по умолчанию API — `"omitted"`, поэтому установите `"summarized"` для получения содержимого thinking в выходах [`ThinkingBlock`](#thinkingblock). Claude Code не отправляет `display` на Amazon Bedrock или Google Cloud's Agent Platform, поэтому на этих поставщиках Opus 4.7 и позже возвращают пустые выходы `ThinkingBlock` даже когда вы установили `display` на `"summarized"`.

1443 1447

1444Поскольку это классы `TypedDict`, они являются простыми словарями во время выполнения. Либо создавайте их как литералы словарей, либо вызывайте класс как конструктор; оба создают `dict`. Получайте доступ к полям с помощью `config["budget_tokens"]`, а не `config.budget_tokens`:1448Поскольку это классы `TypedDict`, они являются простыми dicts во время выполнения. Либо конструируйте их как dict-литералы, либо вызывайте класс как конструктор; оба создают `dict`. Получайте доступ к полям с `config["budget_tokens"]`, а не `config.budget_tokens`:

1445 1449

1446```python theme={null}1450```python theme={null}

1447from claude_agent_sdk import ClaudeAgentOptions, ThinkingConfigEnabled1451from claude_agent_sdk import ClaudeAgentOptions, ThinkingConfigEnabled

1448 1452

1449# Option 1: dict literal (recommended, no import needed)1453# Опция 1: dict-литерал (рекомендуется, импорт не требуется)

1450options = ClaudeAgentOptions(thinking={"type": "enabled", "budget_tokens": 20000})1454options = ClaudeAgentOptions(thinking={"type": "enabled", "budget_tokens": 20000})

1451 1455

1452# Option 2: constructor-style (returns a plain dict)1456# Опция 2: стиль конструктора (возвращает простой dict)

1453config = ThinkingConfigEnabled(type="enabled", budget_tokens=20000)1457config = ThinkingConfigEnabled(type="enabled", budget_tokens=20000)

1454print(config["budget_tokens"]) # 200001458print(config["budget_tokens"]) # 20000

1455# config.budget_tokens would raise AttributeError1459# config.budget_tokens вызовет AttributeError

1456```1460```

1457 1461

1458<h3 id="taskbudget">1462<h3 id="taskbudget">

1459 `TaskBudget`1463 `TaskBudget`

1460</h3>1464</h3>

1461 1465

1462Бюджет задач на стороне API в токенах, используется с полем `task_budget` в `ClaudeAgentOptions`.1466Бюджет задачи на стороне API в токенах, используемый с полем `task_budget` в `ClaudeAgentOptions`.

1463 1467

1464```python theme={null}1468```python theme={null}

1465class TaskBudget(TypedDict):1469class TaskBudget(TypedDict):

1476 `SdkBeta`1480 `SdkBeta`

1477</h3>1481</h3>

1478 1482

1479Тип Literal для функций бета-версии SDK.1483Литеральный тип для бета-функций SDK.

1480 1484

1481```python theme={null}1485```python theme={null}

1482SdkBeta = Literal["context-1m-2025-08-07"]1486SdkBeta = Literal["context-1m-2025-08-07"]

1483```1487```

1484 1488

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

1486 1490

1487<Warning>1491<Warning>

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

1489</Warning>1493</Warning>

1490 1494

1491<h3 id="mcpsdkserverconfig">1495<h3 id="mcpsdkserverconfig">

1492 `McpSdkServerConfig`1496 `McpSdkServerConfig`

1493</h3>1497</h3>

1494 1498

1495Конфигурация для SDK MCP servers, созданных с помощью `create_sdk_mcp_server()`.1499Конфигурация для SDK MCP-серверов, созданных с помощью `create_sdk_mcp_server()`.

1496 1500

1497```python theme={null}1501```python theme={null}

1498class McpSdkServerConfig(TypedDict):1502class McpSdkServerConfig(TypedDict):

1505 `McpServerConfig`1509 `McpServerConfig`

1506</h3>1510</h3>

1507 1511

1508Тип объединения для конфигураций MCP server.1512Тип объединения для конфигураций MCP-сервера.

1509 1513

1510```python theme={null}1514```python theme={null}

1511McpServerConfig = (1515McpServerConfig = (

1551 `McpServerStatusConfig`1555 `McpServerStatusConfig`

1552</h3>1556</h3>

1553 1557

1554Конфигурация MCP server, как сообщается [`get_mcp_status()`](#methods). Это объединение всех вариантов транспорта [`McpServerConfig`](#mcpserverconfig) плюс вариант `claudeai-proxy` только для вывода для servers, проксированных через claude.ai.1558Конфигурация MCP-сервера, как сообщается [`get_mcp_status()`](#methods). Это объединение всех вариантов транспорта [`McpServerConfig`](#mcpserverconfig) плюс выходной вариант `claudeai-proxy` для серверов, проксированных через claude.ai.

1555 1559

1556```python theme={null}1560```python theme={null}

1557McpServerStatusConfig = (1561McpServerStatusConfig = (

1563)1567)

1564```1568```

1565 1569

1566`McpSdkServerConfigStatus` - это сериализуемая форма [`McpSdkServerConfig`](#mcpsdkserverconfig) с только полями `type` (`"sdk"`) и `name` (`str`); встроенный `instance` опущен. `McpClaudeAIProxyServerConfig` имеет поля `type` (`"claudeai-proxy"`), `url` (`str`) и `id` (`str`).1570`McpSdkServerConfigStatus` — это сериализуемая форма [`McpSdkServerConfig`](#mcpsdkserverconfig) с только полями `type` (`"sdk"`) и `name` (`str`); в процессе `instance` опущен. `McpClaudeAIProxyServerConfig` имеет поля `type` (`"claudeai-proxy"`), `url` (`str`) и `id` (`str`).

1567 1571

1568<h3 id="mcpstatusresponse">1572<h3 id="mcpstatusresponse">

1569 `McpStatusResponse`1573 `McpStatusResponse`

1570</h3>1574</h3>

1571 1575

1572Ответ от [`ClaudeSDKClient.get_mcp_status()`](#methods). Оборачивает список статусов сервера под ключом `mcpServers`.1576Ответ от [`ClaudeSDKClient.get_mcp_status()`](#methods). Обёртывает список статусов сервера под ключом `mcpServers`.

1573 1577

1574```python theme={null}1578```python theme={null}

1575class McpStatusResponse(TypedDict):1579class McpStatusResponse(TypedDict):

1580 `McpServerStatus`1584 `McpServerStatus`

1581</h3>1585</h3>

1582 1586

1583Статус подключенного MCP server, содержащийся в [`McpStatusResponse`](#mcpstatusresponse).1587Статус подключённого MCP-сервера, содержащийся в [`McpStatusResponse`](#mcpstatusresponse).

1584 1588

1585```python theme={null}1589```python theme={null}

1586class McpServerStatus(TypedDict):1590class McpServerStatus(TypedDict):

1599| `status` | `str` | Один из `"connected"`, `"failed"`, `"needs-auth"`, `"pending"` или `"disabled"` |1603| `status` | `str` | Один из `"connected"`, `"failed"`, `"needs-auth"`, `"pending"` или `"disabled"` |

1600| `serverInfo` | `dict` (опционально) | Имя и версия сервера (`{"name": str, "version": str}`) |1604| `serverInfo` | `dict` (опционально) | Имя и версия сервера (`{"name": str, "version": str}`) |

1602| `config` | [`McpServerStatusConfig`](#mcpserverstatusconfig) (опционально) | Конфигурация сервера. Та же форма, что и [`McpServerConfig`](#mcpserverconfig) (stdio, SSE, HTTP или SDK), плюс вариант `claudeai-proxy` для servers, подключенных через claude.ai |1606| `config` | [`McpServerStatusConfig`](#mcpserverstatusconfig) (опционально) | Конфигурация сервера. Та же форма, что и [`McpServerConfig`](#mcpserverconfig) (stdio, SSE, HTTP или SDK), плюс вариант `claudeai-proxy` для серверов, подключённых через claude.ai |

1605 1609

1606<h3 id="sdkpluginconfig">1610<h3 id="sdkpluginconfig">

1607 `SdkPluginConfig`1611 `SdkPluginConfig`

1608</h3>1612</h3>

1609 1613

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

1611 1615

1612```python theme={null}1616```python theme={null}

1613class SdkPluginConfig(TypedDict):1617class SdkPluginConfig(TypedDict):

1617 1621

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

1619| :- | :- | :- |1623| :- | :- | :- |

1621| `path` | `str` | Абсолютный или относительный путь к каталогу plugin |1625| `path` | `str` | Абсолютный или относительный путь к каталогу плагина |

1622 1626

1623**Пример:**1627**Пример:**

1624 1628

1629]1633]

1630```1634```

1631 1635

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

1633 1637

1634<h2 id="message-types">1638<h2 id="message-types">

1635 Типы сообщений1639 Типы сообщений

3789<Warning>3793<Warning>

3790 Команды, выполняемые с `dangerouslyDisableSandbox: True`, имеют полный доступ к системе. Убедитесь, что ваш обработчик `can_use_tool` тщательно проверяет эти запросы.3794 Команды, выполняемые с `dangerouslyDisableSandbox: True`, имеют полный доступ к системе. Убедитесь, что ваш обработчик `can_use_tool` тщательно проверяет эти запросы.

3791 3795

3792 Если `permission_mode` установлен на `bypassPermissions` и `allow_unsandboxed_commands` включен, модель может автономно выполнять команды вне sandbox без запросов одобрения, кроме [действий, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves). Эта комбинация фактически позволяет модели молча выходить из изоляции sandbox.3796 Если `permission_mode` установлен на `bypassPermissions` и `allowUnsandboxedCommands` включен, модель может автономно выполнять команды вне sandbox без запросов одобрения, кроме [действий, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves). Эта комбинация фактически позволяет модели молча выходить из изоляции sandbox.

3793</Warning>3797</Warning>

3794 3798

3795<h2 id="see-also">3799<h2 id="see-also">

agent-sdk/streaming-output.md +1 −1

Details

330 Известные ограничения330 Известные ограничения

331</h2>331</h2>

332 332

333* **Structured output**: результат JSON появляется только в финальном `ResultMessage.structured_output`, а не как потоковые дельта-обновления. Подробнее см. в разделе [structured outputs](/docs/ru/agent-sdk/structured-outputs).333* **Structured output**: при включённых частичных сообщениях JSON передаётся потоком как невалидированные `input_json_delta` фрагменты инструмента, и только валидированный результат попадает в финальный `ResultMessage.structured_output`. Подробнее см. в разделе [structured outputs](/docs/ru/agent-sdk/structured-outputs).

334 334

335<h2 id="next-steps">335<h2 id="next-steps">

336 Следующие шаги336 Следующие шаги

agent-sdk/troubleshooting.md +1 −1

Details

162 structured\_output is None but the result says success162 structured\_output is None but the result says success

163</h3>163</h3>

164 164

165Сообщение результата может заканчиваться `subtype: "success"`, пока `structured_output` равен `None` в Python или `undefined` в TypeScript. Запуск завершается, но проверенный выход не существует. Один из способов попасть в это — схема, которую не может удовлетворить никакой выход, например конфликтующие ограничения длины. Запуск завершается без ошибки валидации, и единственный сигнал — отсутствующий `structured_output`.165Сообщение результата может заканчиваться `subtype: "success"`, пока `structured_output` равен `None` в Python или `undefined` в TypeScript. Запуск завершается, но проверенный выход не существует. Один из способов попасть в это — схема, которую не может удовлетворить никакой выход, например конфликтующие ограничения длины.

166 166

167Рассматривайте этот результат как сбой в коде приложения. Проверьте как то, что `subtype` равен `success`, так и то, что `structured_output` присутствует, прежде чем использовать его. Раздел [Error handling](/docs/ru/agent-sdk/structured-outputs#error-handling) показывает этот паттерн для обоих SDK.167Рассматривайте этот результат как сбой в коде приложения. Проверьте как то, что `subtype` равен `success`, так и то, что `structured_output` присутствует, прежде чем использовать его. Раздел [Error handling](/docs/ru/agent-sdk/structured-outputs#error-handling) показывает этот паттерн для обоих SDK.

168 168

agent-sdk/typescript.md +293 −27

Details

54* Для кросс-компиляции установите пакет несовпадающей платформы, например `npm install @anthropic-ai/claude-agent-sdk-linux-x64 --force`.54* Для кросс-компиляции установите пакет несовпадающей платформы, например `npm install @anthropic-ai/claude-agent-sdk-linux-x64 --force`.

55* На Windows подпуть бинарного файла — это `claude.exe`, например `@anthropic-ai/claude-agent-sdk-win32-x64/claude.exe`.55* На Windows подпуть бинарного файла — это `claude.exe`, например `@anthropic-ai/claude-agent-sdk-win32-x64/claude.exe`.

56 56

57<h3 id="import-the-/core-entry-when-you-bundle-the-agent-sdk">

58 Импортируйте запись `/core` при объединении Agent SDK

59</h3>

61Если ваше приложение объединяет Agent SDK вместе со своими собственными зависимостями, импортируйте из `@anthropic-ai/claude-agent-sdk/core` вместо корня пакета. Запись `/core` требует TypeScript Agent SDK версии 0.3.282 или позже, и её типы требуют TypeScript 5.0 или позже.

63Запись `/core` экспортирует то же самое `query()`, `startup()`, `tool()`, `createSdkMcpServer()` и `resolveSettings()`, что и корневая запись, вместе с функциями, которые переименовывают, помечают и удаляют сеансы, `AbortError`, константы времени выполнения и каждый тип. Она не добавляет имена своего собственного. Чтобы сохранить код, который загружает ваше приложение, небольшим, `/core` опускает некоторые корневые экспорты, включая `prewarm()`, класс `InMemorySessionStore` и вспомогательные функции, которые перечисляют, читают, разветвляют, импортируют и суммируют сеансы. Если вам нужна одна из них, используйте корневую запись вместо этого.

65Корневая запись встраивает свои собственные копии `zod` и `@modelcontextprotocol/sdk`. Запись `/core` импортирует их из вашего `node_modules` в диапазонах, которые объявляют `peerDependencies` Agent SDK, поэтому пакет, который уже их включает, не несёт вторую копию. Импортируйте либо из корня, либо из `/core` в данном процессе, но не из обоих: это отдельные пакеты, и загрузка обоих даёт вам две копии классов и состояния Agent SDK.

57<h2 id="functions">67<h2 id="functions">

58 Функции68 Функции

59</h2>69</h2>

93 `startup()`103 `startup()`

94</h3>104</h3>

95 105

96Предварительно разогревает подпроцесс CLI, запуская его и завершая инициализационное рукопожатие до того, как запрос будет доступен. Возвращённый дескриптор [`WarmQuery`](#warmquery) принимает запрос позже и записывает его в уже готовый процесс, поэтому первый вызов `query()` разрешается без затрат на запуск подпроцесса и инициализацию в строке.106Предварительно разогревает подпроцесс CLI, запуская его и завершая инициализационное рукопожатие до того, как запрос будет доступен. Возвращённый дескриптор [`WarmQuery`](#warmquery) принимает запрос позже и записывает его в уже готовый процесс, поэтому первый вызов `query()` разрешается без затрат на запуск подпроцесса и инициализацию в строке. Если вы ещё не знаете рабочую директорию сессии, используйте [`prewarm()`](#prewarm) вместо этого.

97 107

98```typescript theme={null}108```typescript theme={null}

99function startup(params?: {109function startup(params?: {

135}145}

136```146```

137 147

148<h3 id="prewarm">

149 `prewarm()`

150</h3>

151

152*Альфа.* Запускает процесс Claude Code как запасной до того, как вы узнаете, какую сессию он будет обслуживать, чтобы вы могли привязать его к сессии позже с помощью [`claim()`](#spareprocess). Используйте его в приложении, которое загружается до того, как пользователь выберет папку. Требуется TypeScript Agent SDK v0.3.282 или позже.

153

154`prewarm()` завершает то же инициализационное рукопожатие, что и [`startup()`](#startup), с процессом, ожидающим в `options.cwd`, когда вы его устанавливаете, и в противном случае в приватной временной директории под вашей директорией конфигурации Claude Code. Рабочая директория сессии, её hooks `SessionStart`, её stdio MCP серверы и её CLAUDE.md и контекст git ждут требования. Запасной процесс занимает примерно 230–260 МБ памяти во время ожидания. Если ваш [`spawnClaudeCodeProcess`](#options) запускает Claude Code на другой машине или в контейнере, установите `options.cwd` в директорию, которая там существует, чтобы запасной процесс ждал в ней.

155

156```typescript theme={null}

157function prewarm(params?: {

158 options?: Options;

159 initializeTimeoutMs?: number;

160}): Promise<SpareProcess>;

161```

162

163`options` и `initializeTimeoutMs` означают то же самое, что и для `startup()`, за исключением того, что `options.cwd` устанавливает только директорию, в которой запасной процесс ждёт. Промис разрешается с [`SpareProcess`](#spareprocess) после того, как процесс завершил инициализационное рукопожатие. `prewarm()` выбрасывает исключение, если `options` устанавливает `resume`, `continue` или `forkSession`, потому что запасной процесс ещё не имеет сессии. Всё, что требование не может установить, такое как `mcpServers`, `hooks`, `canUseTool`, `settingSources`, `systemPrompt` и `plugins`, зафиксировано на время жизни запасного процесса, поэтому держите один запасной процесс на каждый отдельный набор этих параметров и предварительно разогревайте снова, когда они изменяются.

164

165<h4 id="example-2">

166 Пример

167</h4>

168

169Предварительно разогрейте при загрузке приложения, затем требуйте запасной процесс, когда пользователь начинает сессию:

170

171```typescript theme={null}

172import { prewarm } from "@anthropic-ai/claude-agent-sdk";

173

174// При загрузке приложения, до того как папка сессии известна

175const spare = await prewarm({ options: { maxTurns: 3 } });

176

177// Позже, когда пользователь начинает сессию в папке

178const claimedQuery = spare.claim({

179 prompt: "What files are here?",

180 options: { cwd: "/path/to/project" },

181});

182

183spare.claimed.catch((error: Error) => {

184 // Если сообщение не начинается с "option_not_applied", запрос не выполнился:

185 // начните эту сессию с query() вместо этого

186 console.error("Claim failed:", error.message);

187});

188

189for await (const message of claimedQuery) {

190 console.log(message);

191}

192```

193

138<h3 id="tool">194<h3 id="tool">

139 `tool()`195 `tool()`

140</h3>196</h3>

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

250| :- | :- | :- |306| :- | :- | :- |

261 317

262<h4 id="example-2">318<h4 id="example-3">

263 Пример319 Пример

264</h4>320</h4>

265 321

313| `parent_agent_id` | `string \| null` | Для сообщений от [вложенного подагента](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents), `agentId` подагента, который его запустил. `null` для сообщений основной сессии, сообщений от подагентов верхнего уровня и более старых сессий. Требуется Claude Code v2.1.202 или позже |369| `parent_agent_id` | `string \| null` | Для сообщений от [вложенного подагента](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents), `agentId` подагента, который его запустил. `null` для сообщений основной сессии, сообщений от подагентов верхнего уровня и более старых сессий. Требуется Claude Code v2.1.202 или позже |

314 370

315<h4 id="example-3">371<h4 id="example-4">

316 Пример372 Пример

317</h4>373</h4>

318 374

418Снимок отличается от того, что применяет живая сессия `query()`:474Снимок отличается от того, что применяет живая сессия `query()`:

419 475

420* **`policyHelper`**: `resolveSettings()` читает источники MDM, включая macOS plist и Windows HKLM/HKCU, но не выполняет настроенный администратором подпроцесс `policyHelper`.476* **`policyHelper`**: `resolveSettings()` читает источники MDM, включая macOS plist и Windows HKLM/HKCU, но не выполняет настроенный администратором подпроцесс `policyHelper`.

421* **Параметры, управляемые сервером**: `resolveSettings()` не загружает [параметры, управляемые сервером](/docs/ru/managed-settings#delivery-mechanisms). Передайте их как `options.serverManagedSettings` для включения.477* **Параметры, управляемые сервером**: `resolveSettings()` не загружает [параметры, управляемые сервером](/docs/ru/server-managed-settings#fetch-and-caching-behavior). Передайте их как `options.serverManagedSettings` для включения.

422* **`defaultMode`**: снимок возвращает `permissions.defaultMode` как есть из каждого уровня, поэтому он может включать значения `'auto'` и `'bypassPermissions'` из параметров проекта и локальных параметров, которые [живая сессия игнорирует](/docs/ru/permission-modes#which-mode-a-session-starts-in).478* **`defaultMode`**: снимок возвращает `permissions.defaultMode` как есть из каждого уровня, поэтому он может включать значения `'auto'` и `'bypassPermissions'` из параметров проекта и локальных параметров, которые [живая сессия игнорирует](/docs/ru/permission-modes#which-mode-a-session-starts-in).

423 479

424```typescript theme={null}480```typescript theme={null}

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

454 510

455<h4 id="example-4">511<h4 id="example-5">

456 Пример512 Пример

457</h4>513</h4>

458 514

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

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

606| `verbatimPrompts` | `boolean` | `false` | Доставляйте каждую подсказку как написано. SDK отправляет каждое сообщение пользователя с `client_composed: true`. См. [`client_composed`](#sdkusermessage) для того, что Claude Code пропускает на этих сообщениях. Используйте этот параметр, когда текст вашей подсказки включает содержимое, которое конечный пользователь не вводил. Для управления для каждого хода оставьте его выключенным и установите `client_composed` на отдельные потоковые сообщения вместо этого. Требует TypeScript Agent SDK v0.3.280 или позже и Claude Code v2.1.248 или позже; версия Claude Code, поставляемая с этими версиями SDK, удовлетворяет требованию версии Claude Code |

550 607

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

552 Обработка медленных или зависших ответов API609 Обработка медленных или зависших ответов API

617 path: string,674 path: string,

618 options?: { maxBytes?: number; encoding?: 'utf-8' | 'base64' }675 options?: { maxBytes?: number; encoding?: 'utf-8' | 'base64' }

619 ): Promise<SDKControlReadFileResponse | null>;676 ): Promise<SDKControlReadFileResponse | null>;

677 reloadPlugins(options?: {

678 holdOnCacheImpact?: boolean;

679 }): Promise<SDKControlReloadPluginsResponse>;

620 reloadSkills(): Promise<SDKControlReloadSkillsResponse>;680 reloadSkills(): Promise<SDKControlReloadSkillsResponse>;

681 reloadOutputStyles(): Promise<SDKControlReloadOutputStylesResponse>;

621 accountInfo(): Promise<AccountInfo>;682 accountInfo(): Promise<AccountInfo>;

622 reconnectMcpServer(serverName: string): Promise<void>;683 reconnectMcpServer(serverName: string): Promise<void>;

623 toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;684 toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;

624 setMcpServers(servers: Record<string, McpServerConfig>): Promise<McpSetServersResult>;685 setMcpServers(servers: Record<string, McpServerConfig>): Promise<McpSetServersResult>;

686 readMcpResource(serverName: string, uri: string): Promise<SDKControlMcpReadResourceResponse>;

625 streamInput(stream: AsyncIterable<SDKUserMessage>): Promise<void>;687 streamInput(stream: AsyncIterable<SDKUserMessage>): Promise<void>;

626 stopTask(taskId: string): Promise<void>;688 stopTask(taskId: string): Promise<void>;

627 close(): void;689 close(): void;

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

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

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

714| `reloadPlugins(options?)` | Перезагружает плагины с диска, поэтому плагины, которые вы устанавливаете или редактируете в середине сеанса, достигают работающего сеанса. Разрешается с помощью [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse), перечисляющего команды, подагентов, плагины и статус MCP сервера сеанса. Требует Agent SDK v0.2.85 или позже. Параметр [`holdOnCacheImpact`](#sdkcontrolreloadpluginsresponse) требует Agent SDK v0.3.268 или позже |

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

716| `reloadOutputStyles()` | Повторно читает [стили вывода](/docs/ru/output-styles) с диска, поэтому файл стиля, который вы добавляете или редактируете в середине сеанса, становится доступен для работающего сеанса. Разрешается с помощью [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse), перечисляющего имена стилей, доступные после перезагрузки. Требует Agent SDK v0.3.261 или позже |

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

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

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

721| `readMcpResource(serverName, uri)` | *Alpha.* Читает один MCP Apps `ui://` ресурс из подключенного MCP сервера, чтобы ваше приложение могло отобразить виджет инструмента. Разрешается с помощью [`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse). Требует TypeScript Agent SDK v0.3.280 или позже |

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

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

672 737

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

674 739

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

676 741

677Последовательные вызовы выполняют поверхностное слияние ключей верхнего уровня. Второй вызов с `{ permissions: {...} }` заменяет весь объект `permissions` из предыдущего вызова, а не глубоко объединяется в него.742Последовательные вызовы выполняют поверхностное слияние ключей верхнего уровня. Второй вызов с `{ permissions: {...} }` заменяет весь объект `permissions` из предыдущего вызова, а не глубоко объединяется в него.

678 743

739 804

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

741 806

807<h3 id="spareprocess">

808 `SpareProcess`

809</h3>

810

811*Alpha.* Дескриптор, возвращаемый [`prewarm()`](#prewarm): запущенный процесс Claude Code, который еще не привязан к сеансу и может быть заявлен один раз. Требует TypeScript Agent SDK v0.3.282 или позже.

812

813```typescript theme={null}

814interface SpareProcess extends AsyncDisposable {

815 claim(params: {

816 prompt: string | AsyncIterable<SDKUserMessage>;

817 options: ClaimOptions;

818 }): Query;

819 readonly claimed: Promise<{ cwd: string; sessionId: string; parkedMs?: number; sdkMcpSettled: boolean }>;

820 readonly exited: Promise<void>;

821 close(): void;

822}

823```

824

825<h4 id="members">

826 Члены

827</h4>

828

829| Член | Описание |

830| :- | :- |

831| `claim({ prompt, options })` | Привяжите запасной к сеансу в `options.cwd` и отправьте его первое сообщение. Возвращает [`Query`](#query-object) синхронно, как это делает `query()`. Может быть вызван только один раз |

832| `claimed` | Разрешается с рабочим каталогом и ID сеанса сеанса, как только Claude Code принимает заявку. Отклоняется, когда Claude Code отказывает в заявке, когда процесс вышел или был закрыт первым, и, с сообщением, которое начинается с `option_not_applied`, когда сеанс работает без `model` или `maxThinkingTokens`, которые вы запросили |

833| `exited` | Разрешается, когда процесс выходит, заявлен или нет. Замените запасной, который выходит перед тем, как вы его заявите |

834| `close()` | Завершить процесс. До заявки это отклоняет запасной и отклоняет `claimed` |

835

836`options.cwd` требуется. Заявка также может установить `additionalDirectories`, `model`, `permissionMode`, `maxThinkingTokens`, наложение параметров флага в `settings`, `appendSystemPrompt`, `title`, `agents` и токены для каждого сеанса в `env`.

837

838Claude Code может отказать в заявке, например, для папки, которая не существует, или той, чьи параметры проекта устанавливают `env`, `agent` или `model`. Когда `claimed` отклоняется с сообщением, которое начинается с `option_not_applied`, сеанс работает без `model` или `maxThinkingTokens`, которые вы запросили. После любого другого отказа ваша подсказка не запустилась, поэтому запустите сеанс с `query()` вместо этого.

839

742<h3 id="sdkcontrolinitializeresponse">840<h3 id="sdkcontrolinitializeresponse">

743 `SDKControlInitializeResponse`841 `SDKControlInitializeResponse`

744</h3>842</h3>

822 tokens: number;920 tokens: number;

823 color: string;921 color: string;

824 isDeferred?: boolean;922 isDeferred?: boolean;

923 kind: "used" | "free" | "buffer" | "deferred";

825 }[];924 }[];

826 totalTokens: number;925 totalTokens: number;

827 maxTokens: number;926 maxTokens: number;

911 1010

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

913 1012

914* `categories` содержит итоги для каждой категории.1013* `categories` содержит итоги для каждой категории. Каждая запись `kind` классифицирует строку с теми же значениями, что и [`SDKContextUsageCategory`](#sdkcontextusagecategory). Классифицируйте строки на нем, а не на отображаемом `name`. Поле требует Agent SDK v0.3.268 или позже.

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

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

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

948 1047

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

950 1049

1050<h3 id="sdkcontrolreloadpluginsresponse">

1051 `SDKControlReloadPluginsResponse`

1052</h3>

1053

1054Тип возврата [`reloadPlugins()`](#query-object).

1055

1056```typescript theme={null}

1057type SDKControlReloadPluginsResponse = {

1058 commands: SlashCommand[];

1059 agents: AgentInfo[];

1060 plugins: {

1061 name: string;

1062 path: string;

1063 source?: string;

1064 version?: string;

1065 }[];

1066 mcpServers: McpServerStatus[];

1067 error_count: number;

1068 held?: boolean;

1069 cache_impact?: {

1070 mcp_servers_added: string[];

1071 mcp_servers_removed: string[];

1072 lsp_tool_change: ("adds" | "may-add" | "removes" | "may-remove") | null;

1073 };

1074};

1075```

1076

1077Поля коллекции описывают сеанс после вызова:

1078

1079* `commands`, `agents` и `mcpServers`: команды, подагенты и статус MCP сервера сеанса в тех же формах, которые возвращают `supportedCommands()`, `supportedAgents()` и `mcpServerStatus()`. `supportedAgents()` продолжает возвращать список, захваченный при инициализации, поэтому читайте `agents` здесь для набора после перезагрузки

1080* `plugins`: каждый загруженный плагин с его `name` и установкой `path`. `version` повторяет то, что объявляет манифест плагина, и контролируется автором плагина, поэтому проверьте его перед доверием. Он опущен, когда манифест не объявляет ничего

1081* `error_count`: количество ошибок при загрузке плагинов

1082

1083Передайте `{ holdOnCacheImpact: true }` в `reloadPlugins()` для удержания перезагрузки, которая инвалидировала бы кэш подсказок разговора, вместо применения. Claude Code запускает проверку, которую интерактивная команда `/reload-plugins` делает перед [предупреждением о стоимости кэша](/docs/ru/prompt-caching#enabling-or-disabling-a-plugin). Параметр требует Agent SDK v0.3.268 или позже. Исполняемый файл Claude Code старше v2.1.268, такой как тот, на который вы указываете `pathToClaudeCodeExecutable`, игнорирует параметр и применяет перезагрузку.

1084

1085Когда вы передаете параметр, читайте `held`, чтобы узнать, что произошло:

1086

1087* `true`: перезагрузка не была применена, и поля коллекции описывают сеанс, как он все еще есть. `cache_impact` говорит, что применение изменит. Чтобы применить в любом случае, вызовите `reloadPlugins()` снова без параметра.

1088* `false`: проверка не нашла влияния на кэш, и перезагрузка была применена.

1089* Отсутствует: вы не передали параметр, или исполняемый файл Claude Code старше v2.1.268 и применил перезагрузку.

1090

1091`cache_impact` присутствует только рядом с `held: true`. `mcp_servers_added` и `mcp_servers_removed` называют MCP серверы плагина, которые перезагрузка зарегистрирует или удалит, как имена с областью действия `plugin:<plugin>:<server>`. Имена создаются автором плагина, поэтому проверьте их перед показом. `lsp_tool_change` говорит, добавит ли применение или удалит инструмент LSP, или `null`, когда оно не будет ни того, ни другого. Формы `may-` означают, что проверка не могла полностью увидеть ожидающий набор плагинов.

1092

951<h3 id="sdkcontrolreloadskillsresponse">1093<h3 id="sdkcontrolreloadskillsresponse">

952 `SDKControlReloadSkillsResponse`1094 `SDKControlReloadSkillsResponse`

953</h3>1095</h3>

962 1104

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

964 1106

1107<h3 id="sdkcontrolreloadoutputstylesresponse">

1108 `SDKControlReloadOutputStylesResponse`

1109</h3>

1110

1111Тип возврата [`reloadOutputStyles()`](#query-object).

1112

1113```typescript theme={null}

1114type SDKControlReloadOutputStylesResponse = {

1115 available_output_styles: string[];

1116};

1117```

1118

1119`available_output_styles` перечисляет имена встроенных и пользовательских стилей вывода, доступные после перезагрузки.

1120

1121<h3 id="sdkcontrolmcpreadresourceresponse">

1122 `SDKControlMcpReadResourceResponse`

1123</h3>

1124

1125Тип возврата [`readMcpResource()`](#query-object), несущий результат `resources/read` MCP сервера. Требует TypeScript Agent SDK v0.3.280 или позже.

1126

1127```typescript theme={null}

1128type SDKControlMcpReadResourceResponse = {

1129 contents: {

1130 uri: string;

1131 mimeType?: string;

1132 text?: string;

1133 blob?: string;

1134 _meta?: Record<string, unknown>;

1135 }[];

1136};

1137```

1138

1139Передайте `readMcpResource()` имя сервера, как `mcpServerStatus()` его сообщает, и URI `ui://`, такой как `ui.resourceUri`, который инструмент объявляет в своем [`_meta`](#mcpserverstatus). Вызов отклоняется для любой другой схемы URI, для [SDK MCP сервера](#createsdkmcpserver), который ваше приложение размещает само, и для сервера, который не подключен. Это доступно, когда сообщение инициализации [`capabilities`](#sdksystemmessage) включает `mcp_read_resource_v1`.

1140

1141Каждая запись `contents` — это один элемент содержимого, как его отправил сервер, минус любой ключ `_meta` под префиксом `com.anthropic/`, который зарезервирован для Claude Code. `blob` содержит данные base64 для двоичного элемента, и `_meta` — это собственный `_meta` элемента, где MCP Apps сервер помещает `ui.csp` и `ui.permissions` ресурса.

1142

1143Содержимое — это ненадежный HTML третьей стороны, поэтому отобразите его в песочнице.

1144

965<h3 id="agentdefinition">1145<h3 id="agentdefinition">

966 `AgentDefinition`1146 `AgentDefinition`

967</h3>1147</h3>

1118 blockedPath?: string;1298 blockedPath?: string;

1119 mcpServer?: { name: string; source: string };1299 mcpServer?: { name: string; source: string };

1120 decisionReason?: string;1300 decisionReason?: string;

1301 defaultToNo?: boolean;

1302 suppressAlwaysAllowRule?: boolean;

1121 toolUseID: string;1303 toolUseID: string;

1122 agentID?: string;1304 agentID?: string;

1123 requestId: string;1305 requestId: string;

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

1317| `defaultToNo` | `boolean` | Когда `true`, одиночный случайный нажатие клавиши не должно одобрить этот запрос: откройте вашу подсказку на его опции отклонения, не предварительно выбирайте одобрение и не предлагайте ярлык одобрения одной клавишей. Требует Agent SDK v0.3.268 или позже |

1318| `suppressAlwaysAllowRule` | `boolean` | Когда `true`, не предлагайте постоянный выбор всегда разрешить для этого запроса, потому что правило, которое он напишет, предоставляет больше, чем действие самого запроса. Требует Agent SDK v0.3.268 или позже |

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

1356 context_usage?: SDKContextUsage;1540 context_usage?: SDKContextUsage;

1357 user_message_uuid?: string;1541 user_message_uuid?: string;

1358 user_message_uuids?: string[];1542 user_message_uuids?: string[];

1543 resume_reason?: string;

1359};1544};

1360```1545```

1361 1546

1370 1555

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

1372 1557

1373Claude Code устанавливает `user_message_uuid` и `user_message_uuids` на первое сообщение ассистента в этом ходу при условиях, описанных в [`user_message_uuid`](#user_message_uuid).1558Claude Code устанавливает `user_message_uuid` и `user_message_uuids` на первое сообщение ассистента в этом ходу при условиях, описанных в [`user_message_uuid`](#user_message_uuid). Когда Claude Code повторно запускает ход, который прерывание прервало, сообщения ассистента повторного запуска, которые содержат эти поля, также содержат [`resume_reason`](#resume_reason).

1374 1559

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

1376 1561

1392 parent_tool_use_id: string | null;1577 parent_tool_use_id: string | null;

1393 isSynthetic?: boolean;1578 isSynthetic?: boolean;

1394 shouldQuery?: boolean;1579 shouldQuery?: boolean;

1580 client_composed?: true;

1395 tool_use_result?: unknown;1581 tool_use_result?: unknown;

1396 origin?: SDKMessageOrigin;1582 origin?: SDKMessageOrigin;

1583 inline_pastes?: string[];

1397};1584};

1398```1585```

1399 1586

1400Установите `pasted_content` для отправки содержимого, которое пользователь вставил в ваш пользовательский интерфейс подсказки, а не напечатал, одна запись на вставку, каждая — строка или массив блоков содержимого. Claude Code добавляет текст каждой записи после напечатанного текста по порядку и может обернуть каждую вставку в теги `<pasted_content>`. Блоки, отличные от текста, игнорируются, поэтому отправляйте изображения и документы в `message.content`. Требует Agent SDK v0.3.277 или позже.1587Установите `pasted_content` для отправки содержимого, которое пользователь вставил в ваш пользовательский интерфейс подсказки, а не напечатал, одна запись на вставку, каждая — строка или массив блоков содержимого. Claude Code добавляет текст каждой записи после напечатанного текста по порядку и может обернуть каждую вставку в теги `<pasted_content>`. Блоки, отличные от текста, игнорируются, поэтому отправляйте изображения и документы в `message.content`. Требует Agent SDK v0.3.277 или позже.

1401 1588

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

1590

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

1592* `client_composed`: установите его в `true`, чтобы Claude Code доставил текст сообщения как написано. Claude Code затем не расширяет упоминания `@path` или [`@server:resource`](/docs/ru/mcp#use-mcp-resources) и не запускает текст, начинающийся с `/`, как команду. Пока опция [`verbatimPrompts`](#options) включена, SDK устанавливает это поле на каждое сообщение. Требует TypeScript Agent SDK v0.3.280 или позже и Claude Code v2.1.248 или позже.

1403 1593

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

1405 1595

1407 1597

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

1409 1599

1600Установите `inline_pastes`, чтобы сказать Claude Code, какие части `message.content` пользователь вставил, а не напечатал, одна строка на вставку. Текст подсказки остаётся там, где его поместил пользователь. Claude Code может обернуть каждую указанную вставку в теги `<pasted_content>`, где она стоит, чтобы Claude мог отличить вставленный материал от собственных слов пользователя. Только вставки в последнем текстовом блоке подсказки обёрнуты. Требует TypeScript Agent SDK v0.3.280 или позже.

1601

1410<h3 id="sdkusermessagereplay">1602<h3 id="sdkusermessagereplay">

1411 `SDKUserMessageReplay`1603 `SDKUserMessageReplay`

1412</h3>1604</h3>

1421 message: MessageParam;1613 message: MessageParam;

1422 parent_tool_use_id: string | null;1614 parent_tool_use_id: string | null;

1423 isSynthetic?: boolean;1615 isSynthetic?: boolean;

1616 client_composed?: true;

1424 tool_use_result?: unknown;1617 tool_use_result?: unknown;

1425 origin?: SDKMessageOrigin;1618 origin?: SDKMessageOrigin;

1426 isReplay: true;1619 isReplay: true;

1453 ttft_stream_ms?: number;1646 ttft_stream_ms?: number;

1454 user_message_uuid?: string;1647 user_message_uuid?: string;

1455 user_message_uuids?: string[];1648 user_message_uuids?: string[];

1649 resume_reason?: string;

1650 local_command?: string;

1456 request_sent_wall_ms?: number;1651 request_sent_wall_ms?: number;

1457 first_content_frame_ms?: number;1652 first_content_frame_ms?: number;

1458 first_stream_post_ms?: number;1653 first_stream_post_ms?: number;

1466 structured_output?: unknown;1661 structured_output?: unknown;

1467 deferred_tool_use?: { id: string; name: string; input: Record<string, unknown> };1662 deferred_tool_use?: { id: string; name: string; input: Record<string, unknown> };

1468 terminal_reason?: TerminalReason;1663 terminal_reason?: TerminalReason;

1664 result_index?: number;

1469 fast_mode_state?: FastModeState;1665 fast_mode_state?: FastModeState;

1470 fast_mode_disabled_reason?: FastModeDisabledReason;1666 fast_mode_disabled_reason?: FastModeDisabledReason;

1471 origin?: SDKMessageOrigin;1667 origin?: SDKMessageOrigin;

1493 startup_failure_reason?: SDKStartupFailureReason;1689 startup_failure_reason?: SDKStartupFailureReason;

1494 user_message_uuid?: string;1690 user_message_uuid?: string;

1495 user_message_uuids?: string[];1691 user_message_uuids?: string[];

1692 resume_reason?: string;

1496 terminal_reason?: TerminalReason;1693 terminal_reason?: TerminalReason;

1694 result_index?: number;

1497 fast_mode_state?: FastModeState;1695 fast_mode_state?: FastModeState;

1498 fast_mode_disabled_reason?: FastModeDisabledReason;1696 fast_mode_disabled_reason?: FastModeDisabledReason;

1499 origin?: SDKMessageOrigin;1697 origin?: SDKMessageOrigin;

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

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

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

1708* `resume_reason`: почему Claude Code повторно запустил этот ход после перезагрузки, которая его прервала. Присутствует на обеих ветвях и только на таком повторном запуске. См. [`resume_reason`](#resume_reason).

1709* `local_command`: имя команды, которую ход отправил, на результате успеха хода, который команда завершила без входа в цикл агента, такой как `/compact`. Имя складывается в строчные буквы и подчёркивания, поэтому `/reload-plugins` сообщает `reload_plugins`. Команда, которую предоставляет сервер MCP, и встроенная `/mcp` сообщают `mcp`. Команда, которую вы определили сами, сообщает `custom`. Аргументы никогда не включаются. Отсутствует на каждом ходе, который вошёл в цикл агента, и на отправках, которые не запустили команду. Требует Agent SDK v0.3.268 или позже.

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

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

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

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

1515* `total_cost_usd`: кумулятивная предполагаемая стоимость в USD, охватывающая те же вызовы, что и `modelUsage`, и сбрасываемая в тех же точках. Вызов, который возобновляет сеанс, также учитывает [итоги, восстановленные из более ранних вызовов сеанса](/docs/ru/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Это оценка, а не выписка по счёту. См. [Track cost and usage](/docs/ru/agent-sdk/cost-tracking) для предостережений по точности.1715* `total_cost_usd`: кумулятивная предполагаемая стоимость в USD, охватывающая те же вызовы, что и `modelUsage`, и сбрасываемая в тех же точках. Вызов, который возобновляет сеанс, также учитывает [итоги, восстановленные из более ранних вызовов сеанса](/docs/ru/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Это оценка, а не выписка по счёту. См. [Track cost and usage](/docs/ru/agent-sdk/cost-tracking) для предостережений по точности.

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

1717* `result_index`: где этот результат падает в порядке доставки запуска, считая от 0 по каждому результату, который процесс записывает. Присутствует на обеих ветвях. Результат, чья запись не удаётся, всё ещё потребляет свой номер, поэтому разрыв в последовательности означает, что результат был потерян. Требует Agent SDK v0.3.268 или позже.

1517* `startup_failure_reason`: почему Claude Code отказался запускаться, на результате `error_during_execution`, который он записывает перед выходом при известной ошибке запуска. См. [`startup_failure_reason`](#startup_failure_reason) для значений и того, какие ошибки его содержат. Требует Agent SDK v0.3.274 или позже.1718* `startup_failure_reason`: почему Claude Code отказался запускаться, на результате `error_during_execution`, который он записывает перед выходом при известной ошибке запуска. См. [`startup_failure_reason`](#startup_failure_reason) для значений и того, какие ошибки его содержат. Требует Agent SDK v0.3.274 или позже.

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

1519* `fast_mode_state`: одно из значений `"on"`, `"off"` или `"cooldown"`.1720* `fast_mode_state`: одно из значений `"on"`, `"off"` или `"cooldown"`.

1536 1737

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

1538 1739

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

1540 1741

1541Когда несколько завершений фоновой задачи ставятся в очередь вместе, Claude Code может ответить на них в одном ходу, а не в одном ходу каждый. Каждое завершение всё ещё создаёт свой результат с этим происхождением. Все, кроме последнего из завершений, на которые Claude Code отвечает вместе, создают пустые результаты с `num_turns: 0` по порядку, и результат последнего содержит ход, который отвечает на них все.1742Когда несколько завершений фоновой задачи ставятся в очередь вместе, Claude Code может ответить на них в одном ходу, а не в одном ходу каждый. Каждое завершение всё ещё создаёт свой результат с этим происхождением. Все, кроме последнего из завершений, на которые Claude Code отвечает вместе, создают пустые результаты с `num_turns: 0` по порядку, и результат последнего содержит ход, который отвечает на них все.

1542 1743

1554 1755

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

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

1557* **Подсказка, которую Claude Code сгенерировал сам**, такая как ход, который продолжает прерванную работу после перезагрузки сеанса: ход сначала не отвечает ни на какое ваше сообщение и его кадры не содержат повторения. Если Claude Code подхватит обычное сообщение вашего между вызовами инструментов, ход будет отвечать на это сообщение с этого момента. Повторение подхвата требует Agent SDK v0.3.265 или позже; более ранние версии ничего не повторяют на этих ходах.1758* **Подсказка Claude Code, которая повторно запускает прерванный ход под [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ru/env-vars)**: когда последняя подсказка прерванного хода — это обычное сообщение, которое вы отправили, был ли оно открыло ход или Claude Code подхватил его во время хода, повторный запуск отвечает на это сообщение сначала. [`resume_reason`](#resume_reason) говорит кадры повторного запуска от попытки прерывания. Когда последняя подсказка не является обычным сообщением вашего, повторный запуск не отвечает ни на какое сообщение вашего сначала. Если Claude Code подхватит обычное сообщение вашего между вызовами инструментов, ход будет отвечать на подхваченное сообщение с этого момента. Повторение подсказки прерванного хода требует Agent SDK v0.3.268 или позже.

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

1558 1760

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

1560 1762

1566 1768

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

1568* Кадры подагента1770* Кадры подагента

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

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

1571 1773

1572<h4 id="user_message_uuids">1774<h4 id="user_message_uuids">

1581 1783

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

1583 1785

1786<h4 id="resume_reason">

1787 `resume_reason`

1788</h4>

1789

1790Почему Claude Code повторно запустил этот ход после перезагрузки. Claude Code устанавливает это поле на ход, который он повторно запустил под [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ru/env-vars), чтобы вы могли отличить повторный запуск ответа и результата от попытки прерывания. Требует Agent SDK v0.3.268 или позже.

1791

1792Claude Code устанавливает это поле на два вида кадра:

1793

1794* **Результат повторного запуска**: на ветвях успеха и ошибки, независимо от того, содержит ли результат `user_message_uuid`.

1795* **Кадры ответа повторного запуска**: те, которые содержат [`user_message_uuid`](#user_message_uuid).

1796

1797Значение — это короткий токен в нижнем регистре, называющий, почему ход был повторно запущен, такой как `interrupted_turn`. Это поле отсутствует на каждом другом ходе.

1798

1584<h4 id="queued_turn_count">1799<h4 id="queued_turn_count">

1585 `queued_turn_count`1800 `queued_turn_count`

1586</h4>1801</h4>

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

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

1633| `managed_settings_invalid` | Управляемые параметры политики не смогли быть прочитаны, или булавка не называет организацию |1848| `managed_settings_invalid` | Управляемые параметры политики не смогли быть прочитаны, булавка не называет организацию, или [управляемые ограничения модели](/docs/ru/errors#managed-settings-block-the-default-model) не оставляют разрешённую модель для опции Default |

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

1674 output_style: string;1889 output_style: string;

1675 skills: string[];1890 skills: string[];

1676 plugins: { name: string; path: string }[];1891 plugins: { name: string; path: string }[];

1892 plugin_errors?: {

1893 plugin: string;

1894 type: string;

1895 message: string;

1896 path?: string;

1897 }[];

1677 fast_mode_state?: FastModeState;1898 fast_mode_state?: FastModeState;

1678 fast_mode_disabled_reason?: FastModeDisabledReason;1899 fast_mode_disabled_reason?: FastModeDisabledReason;

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

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

1702 1923

1924Массив `plugin_errors` перечисляет ошибки загрузки плагина. Запись описывает либо плагин, который не загрузился и отсутствует в `plugins`, либо плагин, который загрузился без одной из его частей, такой как его файл hooks. Ключ опускается, когда ничего не произошло. `SDKSystemMessage` объявляет `plugin_errors` в Agent SDK v0.3.283 или позже.

1925

1926Когда каталог или архив из вашей опции [`plugins`](#options) сам не загружается, поле `plugin` записи содержит позиционный тег, такой как `inline[0]`, вместо имени плагина. Это происходит, например, когда путь не существует или манифест недействителен. Сопоставьте такую запись с вашей опцией по её полю `path`.

1927

1928Таблица ниже перечисляет поля каждой записи `plugin_errors`.

1929

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

1931| - | - | - |

1932| `plugin` | `string` | ID неудачного плагина или позиционный тег, такой как `inline[0]`, когда сам каталог или архив плагина не загрузился |

1933| `type` | `string` | Категория ошибки из открытого набора, такая как `path-not-found` или `manifest-validation-error`. Рассматривайте значение, которое вы не узнаёте, как общий отказ |

1934| `message` | `string` | Текст отображения, описывающий отказ |

1935| `path` | `string` | Присутствует только когда сам каталог или архив плагина не загрузился. Его абсолютный путь, с относительным путём из вашей опции `plugins`, разрешённым против опции [`cwd`](#options) |

1936

1703<h3 id="sdkpartialassistantmessage">1937<h3 id="sdkpartialassistantmessage">

1704 `SDKPartialAssistantMessage`1938 `SDKPartialAssistantMessage`

1705</h3>1939</h3>

1716 ttft_ms?: number; // Time to first token in ms, present only on message_start events1950 ttft_ms?: number; // Time to first token in ms, present only on message_start events

1717 user_message_uuid?: string;1951 user_message_uuid?: string;

1718 user_message_uuids?: string[];1952 user_message_uuids?: string[];

1953 resume_reason?: string;

1719};1954};

1720```1955```

1721 1956

1722Claude Code устанавливает `user_message_uuid` и `user_message_uuids` на первое событие потока без ping хода и снова, когда сообщение, на которое ход отвечает, изменяется, при условиях в [`user_message_uuid`](#user_message_uuid).1957Claude Code устанавливает `user_message_uuid` и `user_message_uuids` на первое событие потока без ping хода и снова, когда сообщение, на которое ход отвечает, изменяется, при условиях в [`user_message_uuid`](#user_message_uuid). Когда Claude Code повторно запускает ход, который прерывание прервало, события потока повторного запуска, которые содержат эти поля, также содержат [`resume_reason`](#resume_reason).

1723 1958

1724<h3 id="sdkcompactboundarymessage">1959<h3 id="sdkcompactboundarymessage">

1725 `SDKCompactBoundaryMessage`1960 `SDKCompactBoundaryMessage`

1744 `SDKInformationalMessage`1979 `SDKInformationalMessage`

1745</h3>1980</h3>

1746 1981

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

1983

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

1985

1986Выполняйте рендеринг `content` как простого текста на заданном `level`.

1748 1987

1749```typescript theme={null}1988```typescript theme={null}

1750type SDKInformationalMessage = {1989type SDKInformationalMessage = {

1964 | {2203 | {

1965 kind: "task-notification";2204 kind: "task-notification";

1966 subkind?: "scheduled-trigger" | "peer-send-message";2205 subkind?: "scheduled-trigger" | "peer-send-message";

2206 fireReason?: string;

1967 }2207 }

1968 | { kind: "coordinator" }2208 | { kind: "coordinator" }

1969 | { kind: "auto-continuation" }2209 | { kind: "auto-continuation" }

1984 Task-notification subkinds2224 Task-notification subkinds

1985</h3>2225</h3>

1986 2226

1987Когда Claude Code доставляет уведомление задачи в сеанс, он устанавливает `subkind` на `origin` уведомления только если серверы Anthropic проверили, откуда поступило это уведомление. `subkind` требует Claude Code v2.1.213 или позже и принимает одно из двух значений:2227Когда Claude Code доставляет уведомление задачи в сеанс, он устанавливает `subkind` на `origin` уведомления, если серверы Anthropic проверили, откуда поступило это уведомление. Он также устанавливает `subkind`, когда ваше приложение [объявляет сообщение как запланированный запуск](#declare-a-scheduled-run) само, что требует TypeScript Agent SDK v0.3.280 или позже. `subkind` требует Claude Code v2.1.213 или позже и принимает одно из двух значений:

1988 2228

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

1990*2230*

1991 2231

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

1993 2233

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

1995 2235

2236`fireReason` говорит, почему сработало уведомление `scheduled-trigger`, как короткий токен в нижнем регистре, такой как `scheduled`, `manual`, `retry`, `catch_up` или `api`. Серверы Anthropic устанавливают его на доставки [подпрограммы](/docs/ru/routines), и ваше приложение устанавливает его, когда объявляет запланированный запуск. Он отсутствует, когда ни один не отправил его. Требует TypeScript Agent SDK v0.3.280 или позже.

2237

2238<h4 id="declare-a-scheduled-run">

2239 Declare a scheduled run

2240</h4>

2241

2242Если ваше приложение запускает подсказки по собственному расписанию, объявите каждый запуск, чтобы Claude Code кадрировал ход модели как запланированную задачу, а не как живой ввод от пользователя. Запустите сеанс с `CLAUDE_CODE_HOST_SCHEDULED_RUN`, установленным в `1` в [`env`](#options), затем отправьте [`SDKUserMessage`](#sdkusermessage) запуска с `origin: { kind: "task-notification", subkind: "scheduled-trigger", fireReason: "scheduled" }` и без `isSynthetic`. Claude Code игнорирует объявление в процессе, запущенном без этой переменной. Он также игнорирует его в процессе, чьё окружение содержит [`CLAUDECODE`](/docs/ru/env-vars) или `CLAUDE_CODE_CHILD_SESSION`. Claude Code сохраняет `fireReason` только когда значение — это 1-32 строчные буквы или подчёркивания. Требует TypeScript Agent SDK v0.3.280 или позже.

2243

1996<h3 id="peer-origin-fields">2244<h3 id="peer-origin-fields">

1997 Peer origin fields2245 Peer origin fields

1998</h3>2246</h3>

2847 Типы входных данных tool3095 Типы входных данных tool

2848</h2>3096</h2>

2849 3097

2850Документация схем входных данных для всех встроенных tools Claude Code. Эти типы экспортируются из `@anthropic-ai/claude-agent-sdk` и могут быть использованы для типобезопасного взаимодействия с tools.3098Документация схем входных данных для всех встроенных tools Claude Code. Эти типы экспортируются из `@anthropic-ai/claude-agent-sdk/sdk-tools` и могут быть использованы для типобезопасного взаимодействия с tools.

2851 3099

2852<h3 id="toolinputschemas">3100<h3 id="toolinputschemas">

2853 `ToolInputSchemas`3101 `ToolInputSchemas`

2854</h3>3102</h3>

2855 3103

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

2857 3105

2858```typescript theme={null}3106```typescript theme={null}

2859type ToolInputSchemas =3107type ToolInputSchemas =

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

3656</h2>3904</h2>

3657 3905

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

3659 3907

3660<h3 id="tooloutputschemas">3908<h3 id="tooloutputschemas">

3661 `ToolOutputSchemas`3909 `ToolOutputSchemas`

3662</h3>3910</h3>

3663 3911

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

3665 3913

3666```typescript theme={null}3914```typescript theme={null}

3667type ToolOutputSchemas =3915type ToolOutputSchemas =

4863```5111```

4864 5112

4865<Warning>5113<Warning>

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

4867</Warning>5115</Warning>

4868 5116

4869<h3 id="slashcommand">5117<h3 id="slashcommand">

4990 destructive?: boolean;5238 destructive?: boolean;

4991 openWorld?: boolean;5239 openWorld?: boolean;

4992 };5240 };

5241 _meta?: Record<string, unknown>;

4993 }[];5242 }[];

4994};5243};

4995```5244```

4996 5245

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

4998 5247

5248`_meta` на записи `tools` содержит членов MCP Apps этого tool `_meta`, поэтому ваше приложение может найти ресурс `ui://` для отображения с помощью [`readMcpResource()`](#query-object). Claude Code пропускает объект `ui` и устаревшую плоскую строку `ui/resourceUri`, и скрывает каждый другой ключ. Внутри `ui`, `resourceUri` это строка `ui://` и `visibility` массив `"model"` и `"app"` когда сервер их устанавливает, и любой другой член пропускается без изменений. Claude Code отбрасывает любой ключ, когда значение неправильно сформировано, и опускает `_meta` из tool, который не объявляет ни один. Поле присутствует только когда [`capabilities`](#sdksystemmessage) инициализирующего сообщения включают `mcp_tool_ui_meta_v1`, и требует TypeScript Agent SDK v0.3.280 или позже.

5249

4999<h3 id="mcpserverstatusconfig">5250<h3 id="mcpserverstatusconfig">

5000 `McpServerStatusConfig`5251 `McpServerStatusConfig`

5001</h3>5252</h3>

5497 `SDKTaskProgressMessage`5748 `SDKTaskProgressMessage`

5498</h3>5749</h3>

5499 5750

5500Выдаётся периодически во время выполнения подагента или фоновой задачи. Поле `summary` заполняется только когда включён [`agentProgressSummaries`](#options).5751Выдаётся периодически во время выполнения подагента или фоновой задачи.

5752

5753Для задачи подагента поле `summary` содержит сгенерированное моделью резюме прогресса и заполняется только когда включён [`agentProgressSummaries`](#options). Для [фоновой задачи вызова MCP tool](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls), `summary` содержит последний сообщённый прогресс MCP сервера и не зависит от этой опции.

5501 5754

5502```typescript theme={null}5755```typescript theme={null}

5503type SDKTaskProgressMessage = {5756type SDKTaskProgressMessage = {

5660 5913

5661Выдаётся, когда набор доступных команд изменяется во время сессии, например, когда Claude Code обнаруживает skills при входе агента в подпапку. Массив `commands` это полный обновлённый список, поэтому замените любой кэшированный список команд этим payload. Вызов [`supportedCommands()`](#query-object) после этого сообщения возвращает тот же обновлённый список, потому что метод отслеживает последний push; это требует Agent SDK v0.3.216 или позже. В более ранних версиях SDK `supportedCommands()` возвращает снимок, захваченный при инициализации, и никогда не отражает изменения во время сессии.5914Выдаётся, когда набор доступных команд изменяется во время сессии, например, когда Claude Code обнаруживает skills при входе агента в подпапку. Массив `commands` это полный обновлённый список, поэтому замените любой кэшированный список команд этим payload. Вызов [`supportedCommands()`](#query-object) после этого сообщения возвращает тот же обновлённый список, потому что метод отслеживает последний push; это требует Agent SDK v0.3.216 или позже. В более ранних версиях SDK `supportedCommands()` возвращает снимок, захваченный при инициализации, и никогда не отражает изменения во время сессии.

5662 5915

5916Claude Code также выдаёт это сообщение, когда [prompts](/docs/ru/mcp#use-mcp-prompts-as-commands) MCP сервера присоединяются или покидают список, например, когда сервер завершает подключение после запуска сессии. Это требует Claude Code v2.1.281 или позже.

5917

5663```typescript theme={null}5918```typescript theme={null}

5664type SDKCommandsChangedMessage = {5919type SDKCommandsChangedMessage = {

5665 type: "system";5920 type: "system";

5697 new_conversation_id: UUID;5952 new_conversation_id: UUID;

5698 uuid: UUID;5953 uuid: UUID;

5699 session_id: string;5954 session_id: string;

5955 trigger?: "clear" | "plan_mode_exit" | "fresh_session" | "onboarding";

5956 user_message_uuid?: string;

5957 timestamp?: string;

5700};5958};

5701```5959```

5702 5960

5961Опциональные поля описывают сброс:

5962

5963* `trigger`: что отбросило диалог. Сбросьте ваш транскрипт на каждом сообщении `conversation_reset`, включая то, где это поле отсутствует или несёт значение, которое вы не узнаёте.

5964* `user_message_uuid`: `uuid` пользовательского сообщения, которое несло `/clear`. Используйте его для сопоставления сброса с этим сообщением.

5965* `timestamp`: когда произошёл сброс, как строка ISO 8601 в UTC. Используйте его для отображения, а не для упорядочивания сообщений.

5966

5967Поля `trigger`, `user_message_uuid` и `timestamp` требуют Claude Code v2.1.281 или позже.

5968

5703Опубликованные типизации SDK объявляют `SDKConversationResetMessage` в Claude Code v2.1.203 и позже. До v2.1.203, `SDKMessage` ссылалась на тип без его объявления, поэтому сужение на `type === "conversation_reset"` не прошло проверку типов, когда `skipLibCheck` был отключён.5969Опубликованные типизации SDK объявляют `SDKConversationResetMessage` в Claude Code v2.1.203 и позже. До v2.1.203, `SDKMessage` ссылалась на тип без его объявления, поэтому сужение на `type === "conversation_reset"` не прошло проверку типов, когда `skipLibCheck` был отключён.

5704 5970

5705<h3 id="aborterror">5971<h3 id="aborterror">

5818| `strictAllowlist` | `boolean` | `false` | Запретите sandboxed командам доступ к хостам вне [сетевого allowlist](/docs/ru/sandboxing#network-isolation) вместо запроса. Применяется только для sandboxed команд; встроенные инструменты, такие как WebFetch, не контролируются этим. Учитывается только из пользовательских, управляемых или CLI `--settings` параметров; параметры проекта игнорируются. Требует Claude Code v2.1.219 или позже |6084| `strictAllowlist` | `boolean` | `false` | Запретите sandboxed командам доступ к хостам вне [сетевого allowlist](/docs/ru/sandboxing#network-isolation) вместо запроса. Применяется только для sandboxed команд; встроенные инструменты, такие как WebFetch, не контролируются этим. Учитывается только из пользовательских, управляемых или CLI `--settings` параметров; параметры проекта игнорируются. Требует Claude Code v2.1.219 или позже |

5819| `allowManagedDomainsOnly` | `boolean` | `false` | Только управляемые параметры. Когда установлено в [управляемых параметрах](/docs/ru/managed-settings), только записи `allowedDomains` и правила разрешения `WebFetch(domain:...)` из управляемых параметров учитываются, а записи разрешения из пользовательских, проектных или локальных параметров игнорируются. Не имеет эффекта при установке через опции SDK |6085| `allowManagedDomainsOnly` | `boolean` | `false` | Только управляемые параметры. Когда установлено в [управляемых параметрах](/docs/ru/managed-settings), только записи `allowedDomains` и правила разрешения `WebFetch(domain:...)` из управляемых параметров учитываются, а записи разрешения из пользовательских, проектных или локальных параметров игнорируются. Из SDK передайте это через опцию [`managedSettings`](#options) |

agent-sdk/user-input.md +2 −0

Details

296 <Tab title="Одобрить и запомнить">296 <Tab title="Одобрить и запомнить">

297 Пользователь одобряет и не хочет, чтобы его спрашивали снова для этого вида вызова. Третий аргумент callback содержит `suggestions`, массив готовых записей [`PermissionUpdate`](/docs/ru/agent-sdk/typescript#permissionupdate). Отправьте одну обратно в `updatedPermissions` для её применения. Предложение с назначением `localSettings` записывает правило в `.claude/settings.local.json`, чтобы будущие сеансы пропускали запрос для совпадающих вызовов.297 Пользователь одобряет и не хочет, чтобы его спрашивали снова для этого вида вызова. Третий аргумент callback содержит `suggestions`, массив готовых записей [`PermissionUpdate`](/docs/ru/agent-sdk/typescript#permissionupdate). Отправьте одну обратно в `updatedPermissions` для её применения. Предложение с назначением `localSettings` записывает правило в `.claude/settings.local.json`, чтобы будущие сеансы пропускали запрос для совпадающих вызовов.

298 298

299 В TypeScript пропустите вариант всегда разрешить для запроса, параметры которого содержат [`suppressAlwaysAllowRule: true`](/docs/ru/agent-sdk/typescript#canusetool). Подсказка требует Agent SDK версии 0.3.268 или позже, и Python `context` её не содержит.

300

299 Пример Python требует `claude-agent-sdk` версии 0.1.80 или позже.301 Пример Python требует `claude-agent-sdk` версии 0.1.80 или позже.

300 302

301 <CodeGroup>303 <CodeGroup>

agent-teams.md +3 −1

Details

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

334</h3>334</h3>

335 335

336Каждый товарищ по команде имеет свое собственное контекстное окно. При порождении товарищ по команде загружает тот же контекст проекта, что и обычный сеанс: CLAUDE.md, MCP servers и skills. Он также получает запрос на порождение от лидера. История разговора лидера не переносится.336Каждый товарищ по команде имеет свое собственное контекстное окно. При порождении товарищ по команде загружает тот же контекст проекта, что и обычный сеанс: CLAUDE.md, MCP servers и skills. Если вы запустите лидера с [`--setting-sources`](/docs/ru/cli-reference#cli-flags), товарищи по команде загружают из того же ограниченного списка источников. До версии 2.1.281 товарищи по команде в [разделенной панели](#choose-a-display-mode) загружали каждый источник параметров.

337

338Товарищ по команде также получает запрос на порождение от лидера. История разговора лидера не переносится.

337 339

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

339 341

agent-view.md +13 −5

Details

260 260

261Нажатие `←` создаёт строку сеанса даже когда разговор не имеет сообщений, поэтому `→` всё ещё возвращает к нему.261Нажатие `←` создаёт строку сеанса даже когда разговор не имеет сообщений, поэтому `→` всё ещё возвращает к нему.

262 262

263Вы можете отключить это сочетание клавиш с помощью параметра `leftArrowOpensAgents` в `/config`.263Вы можете отключить это сочетание клавиш с помощью параметра [`leftArrowOpensAgents`](/docs/ru/settings-reference#leftarrowopensagents) в `/config`.

264 264

265<h3 id="organize-the-list">265<h3 id="organize-the-list">

266 Организация списка266 Организация списка

454 454

455* `--mcp-config` и `--strict-mcp-config`455* `--mcp-config` и `--strict-mcp-config`

456* `--settings`456* `--settings`

457* `--setting-sources`

457* `--add-dir`458* `--add-dir`

458* `--plugin-dir`459* `--plugin-dir`

459* `--fallback-model`460* `--fallback-model`

473 474

474Подсказка является позиционным аргументом, а не значением `-p`. Claude Code отклоняет `--bg` в сочетании с `-p` или `--print` перед созданием любого сеанса, потому что `--print` никогда не запускает интерактивный сеанс, к которому подключается `claude agents`.475Подсказка является позиционным аргументом, а не значением `-p`. Claude Code отклоняет `--bg` в сочетании с `-p` или `--print` перед созданием любого сеанса, потому что `--print` никогда не запускает интерактивный сеанс, к которому подключается `claude agents`.

475 476

477Если вы запускаете `claude --bg` из терминала в каталоге, который вы не [доверили](/docs/ru/permissions#project-allow-rules-and-workspace-trust), диалог доверия рабочего пространства появляется в первую очередь и сеанс запускается после того, как вы примете. Если вы отклоните, Claude Code выходит без запуска сеанса. Где диалог не может появиться, такой как в скрипте, команда выходит с ошибкой [`Workspace not trusted`](/docs/ru/errors#workspace-not-trusted-when-dispatching-a-background-session) вместо этого.

478

476Чтобы запустить конкретного [subagent](/docs/ru/sub-agents), который вы определили, такого как `code-reviewer`, как основного агента сеанса, объедините `--bg` с `--agent`:479Чтобы запустить конкретного [subagent](/docs/ru/sub-agents), который вы определили, такого как `code-reviewer`, как основного агента сеанса, объедините `--bg` с `--agent`:

477 480

478```bash theme={null}481```bash theme={null}

639 Settings и поставщик642 Settings и поставщик

640</h4>643</h4>

641 644

642Фоновый сеанс читает свои [settings](/docs/ru/settings) из каталога, в котором он запускается, так же как если бы вы запустили `claude` там. Это включает значения [`env`](/docs/ru/settings-reference#env) в settings проекта, поэтому `ANTHROPIC_MODEL` или переменная поставщика, установленная там, применяется к каждому фоновому сеансу в этом каталоге.645Фоновый сеанс читает свои [settings](/docs/ru/settings) из каталога, в котором он запускается, так же как если бы вы запустили `claude` там с [флагами конфигурации, которые он переносит](#what-carries-over-when-you-background). Это включает значения [`env`](/docs/ru/settings-reference#env) в settings проекта, поэтому `ANTHROPIC_MODEL` или переменная поставщика, установленная там, применяется к каждому фоновому сеансу в этом каталоге.

643 646

644Фоновый сеанс также запускается с `PATH` оболочки, из которой вы его отправили, поэтому команды, которые он запускает, находят те же инструменты, что и ваш терминал. Он также сохраняет выбор облачного поставщика этой оболочки, такой как `CLAUDE_CODE_USE_BEDROCK` или `CLAUDE_CODE_USE_VERTEX`, вместе с его псевдонимами `ANTHROPIC_DEFAULT_*_MODEL` и любым переопределением [`CLAUDE_CODE_EXTRA_BODY`](/docs/ru/env-vars), которое вы экспортировали там.647Фоновый сеанс также запускается с `PATH` оболочки, из которой вы его отправили, поэтому команды, которые он запускает, находят те же инструменты, что и ваш терминал. Он также сохраняет выбор облачного поставщика этой оболочки, такой как `CLAUDE_CODE_USE_BEDROCK` или `CLAUDE_CODE_USE_VERTEX`, вместе с его псевдонимами `ANTHROPIC_DEFAULT_*_MODEL` и любым переопределением [`CLAUDE_CODE_EXTRA_BODY`](/docs/ru/env-vars), которое вы экспортировали там.

645 648

708 711

709Permission mode, модель и усилие, которые вы выбрали для фонового сеанса, вместе с [флагами конфигурации, которые он переносит](#what-carries-over-when-you-background), все сохраняются, когда supervisor позже [останавливает и перезапускает](#the-supervisor-process) его процесс. Сеанс, который вы запустили с помощью `claude --bg --dangerously-skip-permissions` или `claude --bg --permission-mode bypassPermissions`, остаётся в `bypassPermissions` после этого перезапуска. Модель или усилие, которые вы изменили во время сеанса с помощью `/model` или `/effort`, также сохраняются.712Permission mode, модель и усилие, которые вы выбрали для фонового сеанса, вместе с [флагами конфигурации, которые он переносит](#what-carries-over-when-you-background), все сохраняются, когда supervisor позже [останавливает и перезапускает](#the-supervisor-process) его процесс. Сеанс, который вы запустили с помощью `claude --bg --dangerously-skip-permissions` или `claude --bg --permission-mode bypassPermissions`, остаётся в `bypassPermissions` после этого перезапуска. Модель или усилие, которые вы изменили во время сеанса с помощью `/model` или `/effort`, также сохраняются.

710 713

711Если сеанс взял своё усилие из ваших settings, а не из `--effort` или `/effort`, Claude Code читает ваши settings снова каждый раз, когда он запускает процесс для сеанса. Поэтому, когда вы редактируете сохранённое усилие в `settings.json`, изменение достигает сеансов, которые вы отправляете в фон с `←` или `/bg`, и их более поздних перезапусков. Сохранённое усилие — это ключ [`effortLevel`](/docs/ru/settings-reference#effortlevel) или запись [`modelSettings`](/docs/ru/settings-reference#modelsettings).714Если сеанс взял своё усилие из ваших settings, а не из `--effort` или `/effort`, Claude Code читает ваши settings снова каждый раз, когда он запускает процесс для сеанса. После того как вы редактируете сохранённое усилие в `settings.json`, изменение достигает сеансов, которые вы отправляете в фон с `←` или `/bg`, и их более поздних перезапусков. Сохранённое усилие — это ключ [`effortLevel`](/docs/ru/settings-reference#effortlevel) или запись [`modelSettings`](/docs/ru/settings-reference#modelsettings).

712 715

713Claude Code также сохраняет имя, которое вы установили с помощью [`/rename`](/docs/ru/commands) или `Ctrl+R`, при этом перезапуске, поэтому вы всё ещё можете запустить [`claude --resume <name>`](/docs/ru/sessions#name-your-sessions) для достижения сеанса.716Claude Code также сохраняет имя, которое вы установили с помощью [`/rename`](/docs/ru/commands) или `Ctrl+R`, при этом перезапуске, поэтому вы всё ещё можете запустить [`claude --resume <name>`](/docs/ru/sessions#name-your-sessions) для достижения сеанса.

714 717

718 Settings, plugins и MCP servers721 Settings, plugins и MCP servers

719</h3>722</h3>

720 723

721Agent view принимает те же флаги конфигурации, что и `claude` для загрузки settings, plugins, MCP servers и дополнительных каталогов. Agent view применяет `--settings` и `--plugin-dir` к себе и передаёт каждый флаг конфигурации в сеансы, которые вы отправляете из него, поэтому plugin или MCP server, который вы загружаете таким образом, доступен в этих сеансах.724Agent view принимает те же флаги конфигурации, что и `claude` для загрузки settings, plugins, MCP servers и дополнительных каталогов. Agent view применяет `--settings`, `--setting-sources` и `--plugin-dir` к себе и передаёт каждый флаг конфигурации в сеансы, которые вы отправляете из него, поэтому plugin или MCP server, который вы загружаете таким образом, доступен в этих сеансах.

722 725

723| Флаг | Эффект |726| Флаг | Эффект |

724| :- | :- |727| :- | :- |

729| [`--setting-sources <sources>`](/docs/ru/cli-reference#cli-flags) | Загрузить только названные источники settings в agent view и отправленных сеансах |

726| [`--add-dir <path>`](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) | Предоставить доступ к файлам дополнительного каталога |730| [`--add-dir <path>`](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) | Предоставить доступ к файлам дополнительного каталога |

727| [`--plugin-dir <path>`](/docs/ru/plugins/create#load-a-directory-or-archive-for-one-session) | Загрузить plugin из локального каталога |731| [`--plugin-dir <path>`](/docs/ru/plugins/create#load-a-directory-or-archive-for-one-session) | Загрузить plugin из локального каталога |

730 734

731Повторите `--add-dir`, `--plugin-dir` или `--mcp-config` один раз для каждого значения. `claude agents` не поддерживает форму, разделённую пробелами, такую как `--add-dir a b c`.735Повторите `--add-dir`, `--plugin-dir` или `--mcp-config` один раз для каждого значения. `claude agents` не поддерживает форму, разделённую пробелами, такую как `--add-dir a b c`.

732 736

733Вы можете поместить `--settings` и `--plugin-dir` перед или после `agents`. Держите `--add-dir` и `--mcp-config` после `agents`: если вы поместите любой из них перед `agents`, [`claude agents --json`](#manage-sessions-from-the-shell) не удаётся с ошибкой `unknown option`.737Вы можете поместить `--settings`, `--setting-sources` и `--plugin-dir` перед или после `agents`. Держите `--add-dir` и `--mcp-config` после `agents`: если вы поместите любой из них перед `agents`, [`claude agents --json`](#manage-sessions-from-the-shell) не удаётся с ошибкой `unknown option`.

734 738

735Следующий пример открывает agent view с переопределением settings и одним дополнительным каталогом:739Следующий пример открывает agent view с переопределением settings и одним дополнительным каталогом:

736 740

1048 1052

1049| Версия | Изменение |1053| Версия | Изменение |

1050| - | - |1054| - | - |

1055| v2.1.281 | Ограничение [`--setting-sources`](/docs/ru/cli-reference#cli-flags) [переносится](#what-carries-over-when-you-background) в сеанс, который вы отправляете в фон с помощью `←` или `/bg`, и в сеансы, которые вы отправляете из agent view. До этого выпуска запущенный сеанс загружал каждый источник параметров. |

1056| v2.1.281 | `claude --bg` и команды, которые перезагружают сеанс, проверяют доверие рабочей области для каталога сеанса в первую очередь. Из терминала в этом каталоге [диалог доверия появляется](#from-your-shell), если вы его ещё не приняли; где диалог не может появиться, например в скрипте, команда выходит с ошибкой [`Workspace not trusted`](/docs/ru/errors#workspace-not-trusted-when-dispatching-a-background-session). |

1057| v2.1.274 | После автоматического обновления agent view, от которого вы были в отсутствии примерно час, может перезагрузиться на новую сборку. Когда это происходит, он сохраняет [значения отправки по умолчанию](#dispatch-defaults), с которыми вы его открыли: `--model`, `--effort`, `--permission-mode`, `--allow-dangerously-skip-permissions` и `--agent`. До этого выпуска перезагруженный view сохранял только `--cwd` и флаги конфигурации, такие как `--settings` и `--mcp-config`, поэтому сеансы, которые вы отправляли впоследствии, запускались без этих значений по умолчанию. |

1058| v2.1.274 | Когда [удаление отклоняется](#what-deleting-a-session-removes), потому что git или ваш hook `WorktreeRemove` не смог удалить worktree, проверенный подмодуль, который Claude Code проверяет, не имеет незафиксированных изменений отслеживаемых файлов, не блокирует предложение удалить снова и удалить каталог в любом случае. Незафиксированная работа внутри проверенного подмодуля считается незафиксированными изменениями, и сообщение называет подмодуль. До этого выпуска любая проверка подмодуля в worktree блокировала предложение, с сообщением, говорящим, что worktree содержит вложенный репозиторий. |

1051| v2.1.268 | Когда [удаление отклоняется](#what-deleting-a-session-removes), потому что git или ваш hook `WorktreeRemove` не смог удалить worktree, сообщение называет причину, включая то, как завершился hook и начало его stderr. Для связанного worktree в каталоге `.claude/worktrees/` репозитория без незафиксированных изменений отслеживаемых файлов, без вложенного репозитория внутри него и без записи другого сеанса, называющей его, удаление сеанса снова удаляет каталог в любом случае, из agent view или с помощью `claude rm <id> --force-remove-worktree <worktree-id>`. До этого выпуска строка показывала только `worktree could not be removed (WorktreeRemove hook failed)` или ошибку git, stderr hook переходил только в журнал отладки, и удаление снова было отклонено таким же образом. |1059| v2.1.268 | Когда [удаление отклоняется](#what-deleting-a-session-removes), потому что git или ваш hook `WorktreeRemove` не смог удалить worktree, сообщение называет причину, включая то, как завершился hook и начало его stderr. Для связанного worktree в каталоге `.claude/worktrees/` репозитория без незафиксированных изменений отслеживаемых файлов, без вложенного репозитория внутри него и без записи другого сеанса, называющей его, удаление сеанса снова удаляет каталог в любом случае, из agent view или с помощью `claude rm <id> --force-remove-worktree <worktree-id>`. До этого выпуска строка показывала только `worktree could not be removed (WorktreeRemove hook failed)` или ошибку git, stderr hook переходил только в журнал отладки, и удаление снова было отклонено таким же образом. |

1052| v2.1.268 | После того как первый `←` показывает `Press ← again to open agents` или `Press ← again to go back to agents` в присоединённом сеансе, [первое нажатие, которое приходит по крайней мере через секунду позже, переключается](#switch-sessions-without-leaving-the-terminal), даже когда более быстрые нажатия между ними были проигнорированы. До этого выпуска каждое проигнорированное нажатие перезапускало ожидание, поэтому нажатие `←` снова в устойчивом темпе не переключалось до тех пор, пока вы не делали паузу более чем на секунду. |1060| v2.1.268 | После того как первый `←` показывает `Press ← again to open agents` или `Press ← again to go back to agents` в присоединённом сеансе, [первое нажатие, которое приходит по крайней мере через секунду позже, переключается](#switch-sessions-without-leaving-the-terminal), даже когда более быстрые нажатия между ними были проигнорированы. До этого выпуска каждое проигнорированное нажатие перезапускало ожидание, поэтому нажатие `←` снова в устойчивом темпе не переключалось до тех пор, пока вы не делали паузу более чем на секунду. |

1053| v2.1.260 | Когда вы [отправляете сеанс в фон](#from-inside-a-session), [список агентов](/docs/ru/cross-session-messaging#see-which-sessions-claude-can-reach) ваших других сеансов показывает разговор один раз как его фоновый сеанс, и их сообщения ему больше не достигают терминала, с которого вы его переместили. До этого выпуска этот терминал мог остаться указанным как второй интерактивный сеанс под названием разговора, и сеанс, который отправил сообщение разговору до перемещения, продолжал доставлять на этот терминал. |1061| v2.1.260 | Когда вы [отправляете сеанс в фон](#from-inside-a-session), [список агентов](/docs/ru/cross-session-messaging#see-which-sessions-claude-can-reach) ваших других сеансов показывает разговор один раз как его фоновый сеанс, и их сообщения ему больше не достигают терминала, с которого вы его переместили. До этого выпуска этот терминал мог остаться указанным как второй интерактивный сеанс под названием разговора, и сеанс, который отправил сообщение разговору до перемещения, продолжал доставлять на этот терминал. |

agents.md +1 −1

Details

13| [Subagents](/docs/ru/sub-agents) | Делегированные работники в одном сеансе, которые выполняют побочную задачу в своем собственном контексте и возвращают резюме | Побочная задача заполнит ваш основной разговор результатами поиска, логами или содержимым файлов, на которые вы больше не будете ссылаться |13| [Subagents](/docs/ru/sub-agents) | Делегированные работники в одном сеансе, которые выполняют побочную задачу в своем собственном контексте и возвращают резюме | Побочная задача заполнит ваш основной разговор результатами поиска, логами или содержимым файлов, на которые вы больше не будете ссылаться |

14| [Agent view](/docs/ru/agent-view) | Один экран для отправки и мониторинга сеансов, работающих в фоновом режиме, открывается с помощью `claude agents`. Предварительный просмотр исследования | У вас есть несколько независимых задач, и вы хотите их передать, проверить статус с первого взгляда и вмешаться только когда один из них нуждается в вас |14| [Agent view](/docs/ru/agent-view) | Один экран для отправки и мониторинга сеансов, работающих в фоновом режиме, открывается с помощью `claude agents`. Предварительный просмотр исследования | У вас есть несколько независимых задач, и вы хотите их передать, проверить статус с первого взгляда и вмешаться только когда один из них нуждается в вас |

15| [Agent teams](/docs/ru/agent-teams) | Несколько координируемых сеансов с общим списком задач и обменом сообщениями между агентами, управляемые лидером. Экспериментальная функция и отключена по умолчанию | Вы хотите, чтобы Claude разделил проект на части, назначил их и держал работников в синхронизации |15| [Agent teams](/docs/ru/agent-teams) | Несколько координируемых сеансов с общим списком задач и обменом сообщениями между агентами, управляемые лидером. Экспериментальная функция и отключена по умолчанию | Вы хотите, чтобы Claude разделил проект на части, назначил их и держал работников в синхронизации |

16| [Projects](/docs/ru/claude-projects) | Один текущий разговор на claude.ai/code или в приложении для рабочего стола. Claude запускает параллельные облачные сеансы, называемые потоками, дает каждому репозитории проекта, инструкции и память, и показывает вам, какие из них нуждаются в вас. Публичная бета на Pro и Max | Работа охватывает множество задач в течение дней или недель, должна продолжаться, когда ваша машина выключена, и вы предпочитаете описать это один раз, чем отправлять и отслеживать каждый сеанс |16| [Projects](/docs/ru/claude-projects) | Один текущий разговор на claude.ai/code или в приложении для рабочего стола. Claude запускает параллельные сеансы, называемые потоками, в облаке или, когда вы попросите, на вашем компьютере через Remote Control, дает каждому инструкции проекта и показывает вам, какие из них нуждаются в вас. Публичная бета на Pro и Max | Работа охватывает множество задач в течение дней или недель, должна продолжаться, когда ваша машина выключена, и вы предпочитаете описать это один раз, чем отправлять и отслеживать каждый сеанс |

17| [Dynamic workflows](/docs/ru/workflows) | Скрипт, который запускает множество подагентов и проверяет их результаты, для работы, которая слишком велика для координации за один ход или которая требует более одного прохода | Задача слишком велика для нескольких подагентов, или вы хотите, чтобы результаты были проверены друг против друга: аудит всей кодовой базы, миграция 500 файлов, перепроверенное исследование или план, разработанный с нескольких углов |17| [Dynamic workflows](/docs/ru/workflows) | Скрипт, который запускает множество подагентов и проверяет их результаты, для работы, которая слишком велика для координации за один ход или которая требует более одного прохода | Задача слишком велика для нескольких подагентов, или вы хотите, чтобы результаты были проверены друг против друга: аудит всей кодовой базы, миграция 500 файлов, перепроверенное исследование или план, разработанный с нескольких углов |

18 18

19В каждом подходе работники — это сеансы Claude. Чтобы задействовать другой инструмент, предоставьте его Claude как [MCP server](/docs/ru/mcp).19В каждом подходе работники — это сеансы Claude. Чтобы задействовать другой инструмент, предоставьте его Claude как [MCP server](/docs/ru/mcp).

artifacts.md +39 −12

Details

51Build a dashboard artifact of last week's deploy failures by service and keep it updated as you investigate.51Build a dashboard artifact of last week's deploy failures by service and keep it updated as you investigate.

52```52```

53 53

54Если вы не указали местоположение, Claude записывает страницу в файл HTML или Markdown во временный каталог вне вашего проекта, а затем публикует его. Публикация нового артефакта проходит через [режим разрешений](/docs/ru/permission-modes) вашей сессии:54Если вы не указали местоположение, Claude записывает страницу в файл HTML или Markdown во временный каталог вне вашего проекта, а затем публикует его. Вне [режима разрешений](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode), новый артефакт, который Claude публикует в ответ на введенную вами подсказку, проходит без запроса разрешения или проверки классификатором, если только эта публикация не объявляет возможности выполнения для страницы, такие как [вызовы соединителя](#pull-live-data-with-mcp-connectors) или [загрузки файлов](#offer-a-file-download). В режиме разрешений Claude Code запрашивает у вас разрешение перед первой публикацией каждого артефакта.

55 55

56* **Режим Auto**: классификатор проверяет публикацию вместо того, чтобы вас спрашивать, поэтому Claude может опубликовать страницу без того, чтобы вы видели подсказку. Какой режим используется в начале ваших сессий, зависит от вашего плана; см. [начальный режим разрешений](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode).56Артефакт остается приватным для вас до тех пор, пока вы не [поделитесь им](#share-an-artifact). После того как вы поделитесь им публично, Claude Code запрашивает ваше одобрение один раз за разговор перед изменением, или в [автоматическом режиме](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатор проверяет изменение.

57* **Режимы Manual и Accept edits**: Claude Code запрашивает разрешение; это может звучать примерно так: `Claude wants to publish deploy-failures.html, uploading it to claude.ai (Anthropic's servers) to host as the page "Deploy failures by service", private to you until you share it`. Выберите **Yes** для публикации.

58 57

59После того как вы один раз одобрите артефакт, Claude Code переиздает его без вопросов и снова спрашивает в некоторых случаях, включая:58Если вы отключили [получение флагов функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), Claude Code запрашивает перед первой публикацией каждого артефакта, или в автоматическом режиме классификатор проверяет его.

61* Claude объявляет возможность выполнения для страницы, такую как [вызовы соединителя](#pull-live-data-with-mcp-connectors) или [загрузки файлов](#offer-a-file-download)

~~62* Вы с тех пор [поделились им публично](#share-an-artifact)~~

63* Вы с тех пор поделились им с конкретными людьми или вашей организацией с последней версией, выбранной как версия, которую видят зрители

64 59

65После первой публикации Claude выводит URL, и ваш браузер открывает новую страницу. Если вы отправили подсказку через [Remote Control](/docs/ru/remote-control) с claude.ai, Claude Desktop или мобильного приложения Claude, вкладка не открывается на машине, на которой работает сессия. Браузер открывается там в следующий раз, когда Claude публикует артефакт из подсказки, которую вы вводите в терминале. Нажмите `Ctrl+]` в любой момент, чтобы переоткрыть самый последний артефакт сессии.60После первой публикации Claude выводит URL, и ваш браузер открывает новую страницу. Если вы отправили подсказку через [Remote Control](/docs/ru/remote-control) с claude.ai, Claude Desktop или мобильного приложения Claude, вкладка не открывается на машине, на которой работает сессия. Браузер открывается там в следующий раз, когда Claude публикует артефакт из подсказки, которую вы вводите в терминале. Нажмите `Ctrl+]` в любой момент, чтобы переоткрыть самый последний артефакт сессии.

66 61

305 300

306Для типографики Claude может загружать шрифт из Google Fonts, единственного внешнего источника шрифтов, из которого может загружаться страница артефакта. Claude встраивает любой другой шрифт как `@font-face` data URI и предоставляет каждому шрифту резервный стек, поэтому страница все еще отображается, если шрифт не загружается. Чтобы использовать определенный шрифт, назовите его в вашей подсказке или в вашей системе дизайна.301Для типографики Claude может загружать шрифт из Google Fonts, единственного внешнего источника шрифтов, из которого может загружаться страница артефакта. Claude встраивает любой другой шрифт как `@font-face` data URI и предоставляет каждому шрифту резервный стек, поэтому страница все еще отображается, если шрифт не загружается. Чтобы использовать определенный шрифт, назовите его в вашей подсказке или в вашей системе дизайна.

307 302

308<h2 id="draft-a-design-canvas">303<h2 id="start-from-a-slides-design-or-docs-template">

309 Создание макета дизайна304 Начните с шаблона Slides, Design или Docs

310</h2>305</h2>

311 306

312Чтобы создать макет пользовательского интерфейса, потока экранов, целевой страницы или постера вместо создания страницы, запустите `/design` с кратким описанием. Claude создает дизайн в виде артбордов на одном холсте и публикует холст как артефакт Design. В кратком описании указывается, что вы хотите нарисовать:307Вместо создания страницы с нуля Claude может начать артефакт с одного из шаблонов в вашей учетной записи claude.ai: [Claude Slides](https://support.claude.com/en/articles/17153992-what-are-artifacts-and-how-do-i-use-them#h_11d5a9a5fa) для презентации, [Claude Design](https://support.claude.com/en/articles/14604416-get-started-with-claude-design) для визуального дизайна или [Claude Docs](https://support.claude.com/en/articles/16923645-get-started-with-claude-docs) для документа, который будут читать и редактировать другие люди. Каждый открывается в собственном редакторе на claude.ai, где вы и ваши коллеги можете изменять его напрямую или попросить это сделать Claude, а затем экспортировать его в форматы, такие как PowerPoint, PDF или Word.

308

309Чтобы начать с шаблона, опишите, что вы хотите, например «превратите заметки о миграции в презентацию для обзора в четверг» или «оформите этот план как документ для команды». Claude выбирает подходящий шаблон, заполняет его на основе вашего запроса и того, что уже есть в сеансе, и дает вам ссылку. Для презентации или дизайна вы также можете запустить `/slides` или `/design` с кратким описанием.

310

311<Note>

312 Шаблоны находятся в бета-версии. Они включены по умолчанию в планах Pro, Max и Team. В планах Enterprise владелец [включает каждый шаблон](https://support.claude.com/en/articles/16994751-artifacts-admin-guide-for-team-and-enterprise-plans) в разделе **Organization settings > Artifacts**. Если в вашей организации шаблон Slides отключен, `/slides` не отображается; если шаблон Design отключен, `/design` не создает дизайны. Обе команды требуют Claude Code версии 2.1.265 или более поздней и сеанса, где [артефакты доступны](#availability).

313</Note>

314

315<h3 id="make-a-slide-deck">

316 Создайте слайд-шоу

317</h3>

318

319Запустите `/slides` с кратким описанием, которое говорит, что охватывает презентация и для кого она предназначена:

320

321```text wrap theme={null}

322/slides a quarterly review of the platform team's reliability work, for the engineering all-hands

323```

324

325Claude создает артефакт Claude Slides и дает вам ссылку. Откройте его в браузере рабочего стола, чтобы редактировать или представить презентацию. Если вы запустите `/slides` без краткого описания, Claude спросит, о чем должна быть презентация, прежде чем что-либо создавать.

326

327<h3 id="draft-a-design-canvas">

328 Создайте макет дизайна

329</h3>

330

331Чтобы создать макет пользовательского интерфейса, потока экранов, целевой страницы или постера вместо создания страницы, запустите `/design` с кратким описанием. Claude создает дизайн в виде артбордов на одном холсте и публикует холст как артефакт Claude Design. В кратком описании указывается, что вы хотите нарисовать:

313 332

314```text wrap theme={null}333```text wrap theme={null}

315/design a settings screen for a mobile banking app334/design a settings screen for a mobile banking app

317 336

318Откройте опубликованный артефакт в браузере рабочего стола для просмотра артбордов. Выберите элемент на артборде и измените его, и ваши правки сохранятся автоматически. Вы можете экспортировать каждый артборд как PNG или PDF.337Откройте опубликованный артефакт в браузере рабочего стола для просмотра артбордов. Выберите элемент на артборде и измените его, и ваши правки сохранятся автоматически. Вы можете экспортировать каждый артборд как PNG или PDF.

319 338

320`/design` требует сеанса, где [артефакты доступны](#availability), и Claude Code версии 2.1.265 или более поздней.339<h3 id="write-a-document-with-claude-docs">

340 Напишите документ с помощью Claude Docs

341</h3>

342

343Claude Docs подключается к Claude Code как [соединитель](/docs/ru/mcp#use-mcp-servers-from-claude-ai) claude.ai, а не как команда. Когда он подключен, `/mcp` отображает его как `claude.ai Claude Docs`. Запрос на документ, предназначенный для других людей, затем переходит в Claude Docs вместо страницы артефакта: спецификация, предложение или описание плана, который вы разработали в сеансе. Claude дает вам ссылку на документ, когда он создан.

344

345Документ, который принадлежит кодовой базе, например README, остается файлом. Чтобы получить файл для чего-то, что Claude иначе поместил бы в Claude Docs, укажите формат, например `.docx` или файл Markdown в репозитории.

346

347Чтобы отключить соединитель, добавьте `claude.ai Claude Docs` в `deniedMcpServers` или используйте переключатель `/mcp`, оба описаны в разделе [Отключение соединителей claude.ai](/docs/ru/mcp#disable-claude-ai-connectors).

321 348

322<h2 id="page-constraints">349<h2 id="page-constraints">

323 Ограничения страницы350 Ограничения страницы

authentication.md +47 −21

Details

32 32

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

34 34

35Чтобы оставаться в системе с несколькими учетными записями одновременно, например с рабочей и личной учетными записями, дайте каждой учетной записи свой собственный каталог конфигурации. Когда вы запускаете `claude`, установите переменную окружения [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars#variables) в каталог для учетной записи, которую вы хотите использовать. Каждый каталог имеет свои собственные параметры, историю сеансов и вход claude.ai или API ключ. Например, в Bash или Zsh добавьте этот псевдоним в `~/.bashrc` или `~/.zshrc`, чтобы `claude-work` использовал вашу рабочую учетную запись, а `claude` сохранял вашу личную:

37```bash theme={null}

38alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

39```

41После открытия нового терминала и первого запуска `claude-work` Claude Code проведет вас через вход и настройку для нового каталога. Отдельные каталоги не разделяют две учетные записи Claude Console [без API ключа](#sign-in-without-an-api-key), потому что Claude Code хранит этот тип входа вне каталога конфигурации.

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

36 44

37<h2 id="set-up-team-authentication">45<h2 id="set-up-team-authentication">

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

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

124 132

125Отмените установку `ANTHROPIC_API_KEY` перед входом без ключа. Профиль, написанный собственным входом Claude Code в Console, или входом Claude Platform CLI `ant auth login`, — это один и тот же вид учетных данных, поэтому повторный вход заменяет его.133Отмените установку `ANTHROPIC_API_KEY` перед входом без ключа.

126 134

127После входа без ключа у вас есть профиль вместо сохраненного ключа API:135После входа без ключа у вас есть профиль вместо сохраненного ключа API:

128 136

160 168

161Чтобы требовать, чтобы входы claude.ai разработчиков принадлежали определенной организации Anthropic, установите [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) и [`forceLoginOrgUUID`](/docs/ru/settings-reference#forceloginorguuid) в [управляемых параметрах](/docs/ru/managed-settings). Установите `forceLoginOrgUUID` на ваш ID организации, показанный в [параметрах администратора claude.ai](https://claude.ai/admin-settings/organization) для организаций Claude for Teams или Enterprise. Claude Code сообщает об ошибке для входа claude.ai в любую другую организацию и выходит при запуске, если учетные данные claude.ai в использовании принадлежат организации, которая не указана в списке.169Чтобы требовать, чтобы входы claude.ai разработчиков принадлежали определенной организации Anthropic, установите [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) и [`forceLoginOrgUUID`](/docs/ru/settings-reference#forceloginorguuid) в [управляемых параметрах](/docs/ru/managed-settings). Установите `forceLoginOrgUUID` на ваш ID организации, показанный в [параметрах администратора claude.ai](https://claude.ai/admin-settings/organization) для организаций Claude for Teams или Enterprise. Claude Code сообщает об ошибке для входа claude.ai в любую другую организацию и выходит при запуске, если учетные данные claude.ai в использовании принадлежат организации, которая не указана в списке.

162 170

163Для входов Claude Console, Claude Code использует `forceLoginOrgUUID` для предварительного выбора организации на странице входа Console, когда вы устанавливаете его на один ID организации Console, показанный на [platform.claude.com/settings/organization](https://platform.claude.com/settings/organization). Он не проверяет, какой организации принадлежат полученные учетные данные Console, при входе или при запуске, и разработчик, который вошел с учетной записью Console до развертывания ключей, остается в системе.171Для входов Claude Console, Claude Code использует `forceLoginOrgUUID` для предварительного выбора организации на странице входа Console, когда вы устанавливаете его на один ID организации Console, показанный на [platform.claude.com/settings/organization](https://platform.claude.com/settings/organization). Он не проверяет, какой организации принадлежат полученные учетные данные Console, при входе или при запуске. Разработчик, который вошел с учетной записью Console до развертывания ключей, остается в системе, и этот сохраненный ключ блокируется на машине, которая также требует [вход через шлюз](/docs/ru/claude-apps-gateway) или в сеансе, который выбирает облачного провайдера.

164 172

165Если вы установите `forceLoginOrgUUID` в любом файле параметров, Claude Code прекратит предлагать [вход в Console без ключа](#sign-in-without-an-api-key) в сеансах, к которым применяется этот файл, и вместо этого создаст ключ API. Чтобы направить разработчиков на вход claude.ai, установите `forceLoginMethod` на `"claudeai"`.173Если вы установите `forceLoginOrgUUID` в любом файле параметров, Claude Code прекратит предлагать [вход в Console без ключа](#sign-in-without-an-api-key) в сеансах, к которым применяется этот файл, и вместо этого создаст ключ API. Чтобы направить разработчиков на вход claude.ai, установите `forceLoginMethod` на `"claudeai"`.

166 174

167Разработчики могут входить несколькими путями: поток терминала `/login`, [расширение VS Code](/docs/ru/vs-code), Agent SDK, `claude setup-token`, `/install-github-app` и [вход через шлюз](/docs/ru/claude-apps-gateway) для организаций, которые маршрутизируют через облачный шлюз. На Claude Code v2.1.212 или позже каждый путь применяет `forceLoginMethod`; до v2.1.212 только входы терминала применяли любой ключ. На интерактивном экране входа терминала, доступном через `/login` или первоначальную настройку, Claude Code предварительно выбирает метод `claudeai` или `console` без его принудительного применения, поэтому даже с установленным `forceLoginMethod` на `"claudeai"`, разработчик все еще может завершить вход Console там. Пути отличаются на `forceLoginOrgUUID`:175На Claude Code v2.1.212 или позже каждый путь входа, указанный здесь, применяет `forceLoginMethod`. На интерактивном экране входа терминала, доступном через `/login` или первоначальную настройку, Claude Code предварительно выбирает метод `claudeai` или `console` без его принудительного применения, поэтому даже с установленным `forceLoginMethod` на `"claudeai"`, разработчик все еще может завершить вход Console там.

168 176

169* **Входы терминала, расширения VS Code и Agent SDK**: проверяют `forceLoginOrgUUID` для входов учетной записи claude.ai177Пути отличаются на `forceLoginOrgUUID`:

178

179* **Входы терминала, [расширения VS Code](/docs/ru/vs-code) и Agent SDK**: проверяют `forceLoginOrgUUID` для входов учетной записи claude.ai

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

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

172 182

173Развертывайте ключи через инструменты управления устройствами. [Параметры, управляемые сервером](/docs/ru/server-managed-settings), достигают только учетных записей, которые уже аутентифицированы в вашей организации, поэтому они не могут перенаправить первый вход разработчика. Если ваша организация также распределяет параметры, управляемые сервером, установите ключи в обоих местах: управляемые источники параметров [не объединяются](/docs/ru/server-managed-settings#settings-precedence), и кэшированные параметры, управляемые сервером, заменяют файл, управляемый устройством, за исключением нескольких [исключений для каждого ключа](/docs/ru/server-managed-settings#per-key-exceptions-across-managed-sources). `forceLoginOrgUUID` и значения `"claudeai"` и `"console"` `forceLoginMethod` не входят в эти исключения, поэтому держите их в обоих местах.183Развертывайте ключи через инструменты управления устройствами. [Параметры, управляемые сервером](/docs/ru/server-managed-settings), достигают только учетных записей, которые уже аутентифицированы в вашей организации, поэтому они не могут перенаправить первый вход разработчика. Если ваша организация также распределяет параметры, управляемые сервером, установите ключи в обоих местах: управляемые источники параметров [не объединяются](/docs/ru/server-managed-settings#settings-precedence), и кэшированные параметры, управляемые сервером, заменяют файл, управляемый устройством, за исключением нескольких [исключений для каждого ключа](/docs/ru/server-managed-settings#per-key-exceptions-across-managed-sources). `forceLoginOrgUUID` и значения `"claudeai"` и `"console"` `forceLoginMethod` не входят в эти исключения, поэтому держите их в обоих местах.

174 184

185В развертывании [шлюза](/docs/ru/claude-apps-gateway) также держите `forceLoginMethod` и `forceLoginOrgUUID` вне [параметров, которые служит шлюз](/docs/ru/claude-apps-gateway-config#managed).

186

175Ключи также определяют, может ли сеанс, который не использует учетные данные входа, начаться. См. [`forceLoginOrgUUID`](/docs/ru/settings-reference#forceloginorguuid) в справочнике параметров для полного поведения.187Ключи также определяют, может ли сеанс, который не использует учетные данные входа, начаться. См. [`forceLoginOrgUUID`](/docs/ru/settings-reference#forceloginorguuid) в справочнике параметров для полного поведения.

176 188

177* **`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`**: заблокированы при запуске, так как членство в организации не может быть проверено для учетных данных окружения189* **`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`**: заблокированы при запуске. При `forceLoginOrgUUID` членство в организации не может быть проверено для учетных данных окружения, и при `forceLoginMethod` учетные данные будут стоять вместо требуемого входа. Когда управляемые параметры также требуют [вход через шлюз](/docs/ru/claude-apps-gateway), Claude Code блокирует ключ API, сохраненный более ранним входом Claude Console, таким же образом. См. [Политика администратора требует вход через облачный шлюз](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in)

178* **Сеансы облачного провайдера, такие как Amazon Bedrock**: не заблокированы, потому что они аутентифицируются против вашего облачного провайдера. Ограничьте их через ваши политики облачного IAM190* **Сеансы облачного провайдера, такие как Amazon Bedrock**: заблокированы только пока учетные данные `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, или ключ API, сохраненный более ранним входом Claude Console, все еще присутствуют на машине. Удалите его и сеанс начнется. Эти сеансы аутентифицируются против вашего облачного провайдера, политики доступа которого их регулируют

179* **[Профиль Anthropic или учетные данные федерации](#anthropic-profiles-and-federation-credentials)**: не заблокированы, и ключи не проверяют, какой организации принадлежит профиль191* **[Профиль Anthropic или учетные данные федерации](#anthropic-profiles-and-federation-credentials)**: не заблокированы, если только учетные данные `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, или ключ API, сохраненный более ранним входом Claude Console, также не присутствуют на машине. Удалите его и сеанс начнется. Ключи не проверяют, какой организации принадлежит профиль

180 192

181<h2 id="credential-management">193<h2 id="credential-management">

182 Управление учетными данными194 Управление учетными данными

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

193* **Поддерживаемые типы аутентификации**: учетные данные claude.ai, учетные данные Claude API, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, учетные данные профиля Anthropic и [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation), а также токены сеанса [Claude apps gateway](/docs/ru/claude-apps-gateway).205* **Поддерживаемые типы аутентификации**: учетные данные claude.ai, учетные данные Claude API, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, учетные данные профиля Anthropic и [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation), а также токены сеанса [Claude apps gateway](/docs/ru/claude-apps-gateway).

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

195* **Интервалы обновления**: Claude Code повторно запускает `apiKeyHelper` через пять минут по умолчанию. Установите переменную окружения `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` для пользовательских интервалов обновления. Смотрите [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) для других случаев, в которых Claude Code повторно запускает помощник.207* **Интервалы обновления**: смотрите [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) для случаев, в которых Claude Code повторно запускает помощник.

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

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

198 210

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

200 212

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

203</h3>215</h3>

204 216

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

206 218

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

208 220

209После истечения срока действия сохраненного входа и невозможности его обновления каждый запрос модели завершается с ошибкой [`Login expired · Please run /login`](/docs/ru/errors#login-expired) до тех пор, пока вы снова не войдете. До версии 2.1.206 Claude Code сообщал об истекшем входе при запросах модели как об ошибке модели.221После истечения срока действия сохраненного входа и невозможности его обновления каждый запрос модели завершается с ошибкой [`Login expired · Please run /login`](/docs/ru/errors#login-expired) до тех пор, пока вы снова не войдете.

210 222

211Вы можете проверить это состояние перед тем, как запрос завершится ошибкой: [`/status`](/docs/ru/commands) показывает строку `Login`, читающую `Expired — log in again`, плюс организацию и адрес электронной почты, которые он сохранил для истекшего входа. Строка появляется только когда сохраненный вход claude.ai или Claude Console является активным учетным данием. Строка требует Claude Code v2.1.210 или позже.223Вы можете проверить это состояние перед тем, как запрос завершится ошибкой: [`/status`](/docs/ru/commands) показывает строку `Login`, читающую `Expired — log in again`, плюс организацию и адрес электронной почты, которые он сохранил для истекшего входа. Строка появляется только когда сохраненный вход claude.ai является активным учетным данием. Строка требует Claude Code v2.1.210 или позже.

212 224

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

214 226

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

216 228

230 242

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

232 244

233Если [управляемые параметры](/docs/ru/managed-settings) вашей машины устанавливают [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) на `"gateway"` или устанавливают [`forceLoginGatewayUrl`](/docs/ru/settings-reference#forcelogingatewayurl), и вы не выбираете облачного провайдера через переменную, такую как `CLAUDE_CODE_USE_BEDROCK` или `CLAUDE_CODE_USE_VERTEX`, ваш сеанс использует только вход через шлюз. Claude Code пропускает другие источники учетных данных и просит вас войти с помощью `/login`. Смотрите [Administrator policy requires a Cloud gateway sign-in](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in) для того, что вы видите с каждым оставшимся учетным данием. До версии 2.1.261 или до версии 2.1.265 на машине, которая устанавливает только `forceLoginGatewayUrl`, Claude Code использовал оставшийся сохраненный вход на этих машинах, пока вы не вошли в шлюз.245Если [управляемые параметры](/docs/ru/managed-settings) вашей машины устанавливают [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) на `"gateway"` или устанавливают [`forceLoginGatewayUrl`](/docs/ru/settings-reference#forcelogingatewayurl), и вы не выбираете облачного провайдера через переменную, такую как `CLAUDE_CODE_USE_BEDROCK` или `CLAUDE_CODE_USE_VERTEX`, ваш сеанс использует только вход через шлюз. Claude Code пропускает другие источники учетных данных и просит вас войти с помощью `/login`. Смотрите [Administrator policy requires a Cloud gateway sign-in](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in) для того, что вы видите с каждым оставшимся учетным данием. Требуется Claude Code v2.1.261 или позже, или v2.1.265 или позже на машине, которая устанавливает только `forceLoginGatewayUrl`.

234 246

235Если у вас есть активная подписка Claude, но также установлен `ANTHROPIC_API_KEY` в вашей среде, Claude Code использует ключ API после одобрения. Это может привести к сбоям аутентификации, если ключ принадлежит отключенной или истекшей организации.247Если у вас есть активная подписка Claude, но также установлен `ANTHROPIC_API_KEY` в вашей среде, Claude Code использует ключ API после одобрения. Это может привести к сбоям аутентификации, если ключ принадлежит отключенной или истекшей организации.

236 248

255| Активный профиль | Файл [`active_config`](https://platform.claude.com/docs/en/manage-claude/wif-reference#active-profile) в вашем каталоге конфигурации или профиль с именем `default` | Выше когда его режим аутентификации — `oidc_federation`; ниже рабочего учетного данного `/login` когда его режим аутентификации — `user_oauth` |267| Активный профиль | Файл [`active_config`](https://platform.claude.com/docs/en/manage-claude/wif-reference#active-profile) в вашем каталоге конфигурации или профиль с именем `default` | Выше когда его режим аутентификации — `oidc_federation`; ниже рабочего учетного данного `/login` когда его режим аутентификации — `user_oauth` |

256 268

257Правило `user_oauth` предотвращает перемещение оставшегося профиля `ant auth login` с запросов с учетной записи, на которую вы вошли с помощью `/login`. Для переменных федерации Claude Code также читает другие переменные в [справочнике WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#environment-variables), такие как `ANTHROPIC_IDENTITY_TOKEN_FILE`, когда он обменивает ваш токен идентификации. Для формата файла профиля смотрите [справочник WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#profile-configuration-file).269Для переменных федерации Claude Code также читает другие переменные в [справочнике WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#environment-variables), такие как `ANTHROPIC_IDENTITY_TOKEN_FILE`, когда он обменивает ваш токен идентификации. Для формата файла профиля смотрите [справочник WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#profile-configuration-file).

258 270

259Чтобы подтвердить, какой источник выбрал Claude Code, запустите `/status`. Строка `Profile` называет источник вместо строки `Login method`. Когда профиль является используемым учетным данием, строки `Organization` и `Email` показывают его учетную запись.271Чтобы подтвердить, какой источник выбрал Claude Code, запустите `/status`. Строка `Profile` называет источник вместо строки `Login method`. Когда профиль является используемым учетным данием, строки `Organization` и `Email` показывают его учетную запись.

260 272

261Если вы запустите Claude Code с `--debug`, он также записывает строку `Using Anthropic profile auth` с именем источника в журнал отладки в `~/.claude/debug/<session-id>.txt`. Когда Claude Code пропускает активный профиль `user_oauth` потому что у вас есть рабочее учетное данные `/login`, он записывает предупреждение в журнал отладки, говоря, что использует вход claude.ai вместо этого.

~~262~~

263Когда вход профиля `user_oauth` истек и Claude Code не может его обновить, запросы завершаются с ошибкой [Anthropic profile login expired](/docs/ru/errors#anthropic-profile-login-expired).273Когда вход профиля `user_oauth` истек и Claude Code не может его обновить, запросы завершаются с ошибкой [Anthropic profile login expired](/docs/ru/errors#anthropic-profile-login-expired).

264 274

265Функции, которые требуют вашего входа claude.ai, такие как [соединители claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) и [`/schedule`](/docs/ru/routines), недоступны при выборе одного из этих источников. Чтобы остановить Claude Code от выбора источника:275Функции, которые требуют вашего входа claude.ai, такие как [соединители claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) и [`/schedule`](/docs/ru/routines), недоступны при выборе одного из этих источников. Чтобы остановить Claude Code от выбора источника:

279 289

280Команда открывает тот же поток авторизации браузера, что и `/login`, и токен выводится в терминал после того, как вы одобрите доступ в браузере. Она не сохраняет токен нигде; скопируйте его и установите его как переменную окружения `CLAUDE_CODE_OAUTH_TOKEN` везде, где вы хотите аутентифицироваться:290Команда открывает тот же поток авторизации браузера, что и `/login`, и токен выводится в терминал после того, как вы одобрите доступ в браузере. Она не сохраняет токен нигде; скопируйте его и установите его как переменную окружения `CLAUDE_CODE_OAUTH_TOKEN` везде, где вы хотите аутентифицироваться:

281 291

282```bash theme={null}292<Tabs>

283export CLAUDE_CODE_OAUTH_TOKEN=your-token293 <Tab title="macOS, Linux, WSL">

284```294 ```bash theme={null}

295 export CLAUDE_CODE_OAUTH_TOKEN=your-token

296 ```

297 </Tab>

298

299 <Tab title="Windows PowerShell">

300 ```powershell theme={null}

301 $env:CLAUDE_CODE_OAUTH_TOKEN = "your-token"

302 ```

303 </Tab>

304

305 <Tab title="Windows CMD">

306 ```batch theme={null}

307 set CLAUDE_CODE_OAUTH_TOKEN=your-token

308 ```

309 </Tab>

310</Tabs>

285 311

286Этот токен аутентифицируется с помощью вашей подписки Claude и требует план Pro, Max, Team или Enterprise. Он может только выполнять запросы модели, поэтому он не может устанавливать сеансы [Remote Control](/docs/ru/remote-control) или получать [соединители claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai). Серверы MCP, которые вы настраиваете локально, все еще работают.312Этот токен аутентифицируется с помощью вашей подписки Claude и требует план Pro, Max, Team или Enterprise. Он может только выполнять запросы модели, поэтому он не может устанавливать сеансы [Remote Control](/docs/ru/remote-control) или получать [соединители claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai). Серверы MCP, которые вы настраиваете локально, все еще работают.

287 313

auto-mode-config.md +14 −30

Details

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

10 10

11<Note>11<Note>

12 Режим auto доступен всем пользователям на каждом поставщике, включая Anthropic API, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и сеансы [шлюза приложений Claude](/docs/ru/claude-apps-gateway). Если Claude Code сообщает, что режим auto недоступен для вашей учетной записи, проверьте [полные требования](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), которые также охватывают поддерживаемые модели и управление на уровне организации на планах Team и Enterprise. В версиях с v2.1.158 по v2.1.206 режим auto на Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и сеансах шлюза приложений Claude требовал установки `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 удалил это требование.12 Эта страница является справочником по конфигурации. Включение и отключение режима auto рассматривается на странице Permission modes:

14 * **Переключение на режим auto во время сеанса или выход из него**: см. [Переключение режимов разрешений](/docs/ru/permission-modes#switch-permission-modes)

15 * **Запуск сеанса в режиме auto**: см. [Запуск в другом режиме разрешений](/docs/ru/permission-modes#start-in-a-different-mode)

13</Note>16</Note>

14 17

15По умолчанию классификатор доверяет только рабочему каталогу и настроенным удаленным репозиториям текущего репозитория. Действия, такие как отправка в исходный контроль вашей компании или запись в командный облачный бакет, блокируются до тех пор, пока вы не добавите их в `autoMode.environment`.18Режим auto доступен всем пользователям на каждом поставщике, включая Anthropic API, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и сеансы [шлюза приложений Claude](/docs/ru/claude-apps-gateway). Если Claude Code сообщает, что режим auto недоступен для вашей учетной записи, проверьте [полные требования](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), которые также охватывают поддерживаемые модели и управление на уровне организации на планах Team и Enterprise.

16 19

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

18 21

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

20 23

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

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

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

24* [Создать записи окружения](#generate-environment-entries) с помощью `/auto-mode-setup`26* [Создать записи окружения](#generate-environment-entries) с помощью `/auto-mode-setup`

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

~~26* [Редактировать правила из `/permissions`](#edit-rules-from-permissions) без открытия файла настроек~~

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

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

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

30 28

31<h2 id="common-boundaries">29<h2 id="common-boundaries">

34 32

35Автоматический режим позволяет отправлять изменения в любую ветку репозитория, над которым вы работаете, включая ветку по умолчанию, и создавать pull request по умолчанию. Ветка, не являющаяся веткой по умолчанию, имя которой обозначает её как цель развёртывания или публикации, такая как `production`, `release` или `gh-pages`, не охватывается этим значением по умолчанию: классификатор оценивает отправку туда по собственным критериям, включая её как развёртывание в production. Содержимое отправки также по-прежнему проверяется, поэтому force push, секрет, попадающий в коммит, или изменение, которое отправило бы секреты за пределы репозитория при запуске CI или конвейера развёртывания, остаётся заблокированным.33Автоматический режим позволяет отправлять изменения в любую ветку репозитория, над которым вы работаете, включая ветку по умолчанию, и создавать pull request по умолчанию. Ветка, не являющаяся веткой по умолчанию, имя которой обозначает её как цель развёртывания или публикации, такая как `production`, `release` или `gh-pages`, не охватывается этим значением по умолчанию: классификатор оценивает отправку туда по собственным критериям, включая её как развёртывание в production. Содержимое отправки также по-прежнему проверяется, поэтому force push, секрет, попадающий в коммит, или изменение, которое отправило бы секреты за пределы репозитория при запуске CI или конвейера развёртывания, остаётся заблокированным.

36 34

37<Info>До версии 2.1.211 классификатор разрешал отправки только в вашу рабочую ветку, ветки, созданные Claude, и обычные отправки в ветку по умолчанию.</Info>

39Если вы хотите контрольную точку человека перед командами push и pull request от Claude, добавьте правила разрешений: [рецепты ниже](#add-a-human-checkpoint) сохраняют автоматический режим включённым для всего остального.35Если вы хотите контрольную точку человека перед командами push и pull request от Claude, добавьте правила разрешений: [рецепты ниже](#add-a-human-checkpoint) сохраняют автоматический режим включённым для всего остального.

40 36

41<h3 id="add-a-human-checkpoint">37<h3 id="add-a-human-checkpoint">

81 77

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

83 79

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

85 81

93 89

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

95 91

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

97 93

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

99 * **Organization**95 * **Organization**

101 * **Cloud provider(s)**97 * **Cloud provider(s)**

102 * **Repository visibility**: репозиторий считается приватным, если только его удаленный хост и имя не указывают иное, или классификатор читает проверку видимости ранее в разговоре, показывающую, что он публичный.98 * **Repository visibility**: репозиторий считается приватным, если только его удаленный хост и имя не указывают иное, или классификатор читает проверку видимости ранее в разговоре, показывающую, что он публичный.

103 99

104 В запросах классификатора, отправляемых самим Claude Code, классификатор читает ваши сообщения и команды, которые выполняет Claude, но не их вывод. Доказательство должно быть чем-то, что классификатор может прочитать, например вашим собственным сообщением, в котором репозиторий назван публичным; вывод `gh repo view` сам по себе не достигает его. Проверка доказательств из стенограммы требует Claude Code v2.1.200 или позже100 В запросах классификатора, отправляемых самим Claude Code, классификатор читает ваши сообщения и команды, которые выполняет Claude, но не их вывод. Доказательство должно быть чем-то, что классификатор может прочитать, например вашим собственным сообщением, в котором репозиторий назван публичным; вывод `gh repo view` сам по себе не достигает его.

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

106 * **Org-specific CLIs**102 * **Org-specific CLIs**

107 * **Secrets management**103 * **Secrets management**

110 * **Host containment**: по умолчанию обычная машина разработчика или CI runner с открытым интернетом. Если Claude Code работает в контейнере, виртуальной машине или поде с allow-list исходящих соединений или соседями, которых он не должен трогать, назовите разрешенные хосты, должна ли быть доступна конечная точка метаданных облака и какой облачный проект, кластер или реестр использует задача и под какой идентичностью. Пока эта запись не назовет эту идентичность, классификатор [блокирует](/docs/ru/permission-modes#what-the-classifier-blocks-by-default) запросы на учетные данные самого хоста. Требует Claude Code v2.1.257 или позже106 * **Host containment**: по умолчанию обычная машина разработчика или CI runner с открытым интернетом. Если Claude Code работает в контейнере, виртуальной машине или поде с allow-list исходящих соединений или соседями, которых он не должен трогать, назовите разрешенные хосты, должна ли быть доступна конечная точка метаданных облака и какой облачный проект, кластер или реестр использует задача и под какой идентичностью. Пока эта запись не назовет эту идентичность, классификатор [блокирует](/docs/ru/permission-modes#what-the-classifier-blocks-by-default) запросы на учетные данные самого хоста. Требует Claude Code v2.1.257 или позже

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

112 * **Data retention / declassification**108 * **Data retention / declassification**

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

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

115 111

116<Info>До v2.1.211 контекстные слоты также включали запись Default / protected branches, которая рассматривала `main` и `master` как защищенные, пока вы не назовете другие. v2.1.211 удалил это: [отправки в любую ветвь репозитория, в котором вы работаете](#common-boundaries), разрешены по умолчанию, поэтому нет защищенного ветвления по умолчанию для настройки.</Info>

~~117~~

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

119 113

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

143* **Trusted internal domains**: имена хостов для API, панелей управления и сервисов внутри вашей сети, например `*.internal.example.com`137* **Trusted internal domains**: имена хостов для API, панелей управления и сервисов внутри вашей сети, например `*.internal.example.com`

144* **Key internal services**: CI, реестры артефактов, внутренние индексы пакетов, инструменты для работы с инцидентами138* **Key internal services**: CI, реестры артефактов, внутренние индексы пакетов, инструменты для работы с инцидентами

145* **Internal package registry**: приватный npm, PyPI или другой реестр, через который должны маршрутизироваться установки, поэтому установки, которые обходят его для публичного реестра, блокируются139* **Internal package registry**: приватный npm, PyPI или другой реестр, через который должны маршрутизироваться установки, поэтому установки, которые обходят его для публичного реестра, блокируются

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

147* **Sensitive remote targets**: пространства имен, хосты или контейнеры, которые считаются производством, поэтому удаленные оболочки и переадресация портов в них требуют вашего явного одобрения141* **Sensitive remote targets**: пространства имен, хосты или контейнеры, которые считаются производством, поэтому удаленные оболочки и переадресация портов в них требуют вашего явного одобрения

148* **Protected IaC scopes**: ресурсы инфраструктуры, применение или уничтожение которых всегда должно требовать от вас назвать изменение142* **Protected IaC scopes**: ресурсы инфраструктуры, применение или уничтожение которых всегда должно требовать от вас назвать изменение

149* **Additional context**: ограничения регулируемой отрасли, многотенантная инфраструктура или требования соответствия, которые влияют на то, что классификатор должен рассматривать как рискованное143* **Additional context**: ограничения регулируемой отрасли, многотенантная инфраструктура или требования соответствия, которые влияют на то, что классификатор должен рассматривать как рискованное

150 144

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

~~152~~

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

154 146

155```json theme={null}147```json theme={null}

169}161}

170```162```

171 163

172Чем более конкретный контекст вы предоставляете, тем лучше классификатор может различать обычные внутренние операции и попытки утечки данных.

~~173~~

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

175 165

176<h2 id="generate-environment-entries">166<h2 id="generate-environment-entries">

309 299

310По умолчанию узкие правила Bash и PowerShell, такие как `Bash(npm test)`, остаются в силе в режиме auto. Claude Code разрешает их до запуска классификатора, если только команда не содержит [разрешённые домены для отдельных команд](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode). Claude Code приостанавливает только широкие правила, которые предоставляют произвольное выполнение кода, такие как `Bash(*)` или интерпретаторы с подстановочными знаками, вместе с каждым правилом, которое называет [`Monitor`](/docs/ru/tools-reference#monitor-tool), потому что команды Monitor выполняются через shell. Это означает, что узкое правило всё ещё может пропустить деструктивный аргумент без того, чтобы классификатор его увидел, например путь скрипта или флаг, который префикс правила не предусмотрел.300По умолчанию узкие правила Bash и PowerShell, такие как `Bash(npm test)`, остаются в силе в режиме auto. Claude Code разрешает их до запуска классификатора, если только команда не содержит [разрешённые домены для отдельных команд](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode). Claude Code приостанавливает только широкие правила, которые предоставляют произвольное выполнение кода, такие как `Bash(*)` или интерпретаторы с подстановочными знаками, вместе с каждым правилом, которое называет [`Monitor`](/docs/ru/tools-reference#monitor-tool), потому что команды Monitor выполняются через shell. Это означает, что узкое правило всё ещё может пропустить деструктивный аргумент без того, чтобы классификатор его увидел, например путь скрипта или флаг, который префикс правила не предусмотрел.

311 301

312Установите `autoMode.classifyAllShell` в значение `true`, чтобы приостановить каждое правило разрешения Bash и PowerShell, пока активен режим auto, так чтобы классификатор оценивал каждую команду shell независимо от вашего списка разрешений.302Установите `autoMode.classifyAllShell` в значение `true`, чтобы приостановить каждое правило разрешения Bash и PowerShell, пока активен режим auto, так чтобы классификатор оценивал каждую команду shell независимо от вашего списка разрешений, кроме [критических путей удаления](/docs/ru/permission-modes#critical-paths).

313 303

314```json theme={null}304```json theme={null}

315{305{

323 313

324Параметр применяется только во время активности режима auto, и ваши правила разрешения работают нормально в других режимах разрешений.314Параметр применяется только во время активности режима auto, и ваши правила разрешения работают нормально в других режимах разрешений.

325 315

326<Note>

327 `autoMode.classifyAllShell` требует Claude Code v2.1.193 или более поздней версии. Более ранние версии игнорируют ключ и продолжают применять узкие правила разрешения shell в режиме auto.

328</Note>

~~329~~

330<h2 id="inspect-the-defaults-and-your-effective-config">316<h2 id="inspect-the-defaults-and-your-effective-config">

331 Проверьте значения по умолчанию и вашу эффективную конфигурацию317 Проверьте значения по умолчанию и вашу эффективную конфигурацию

332</h2>318</h2>

375claude auto-mode critique361claude auto-mode critique

376```362```

377 363

378Запустите `claude auto-mode config` после сохранения ваших параметров, чтобы подтвердить, что эффективные правила соответствуют вашим ожиданиям, с `"$defaults"` развёрнутыми на месте. Если вы написали пользовательские правила, `claude auto-mode critique` проверяет их и отмечает записи, которые неоднозначны, избыточны или могут вызвать ложные срабатывания.364Если вы написали пользовательские правила, `claude auto-mode critique` проверяет их и отмечает записи, которые неоднозначны, избыточны или могут вызвать ложные срабатывания.

379 365

380Чтобы отменить ваши настройки и вернуться к встроенным значениям по умолчанию, запустите подкоманду reset. Она требует Claude Code v2.1.212 или позже и удаляет раздел `autoMode` из вашего файла пользовательских параметров:366Чтобы отменить ваши настройки и вернуться к встроенным значениям по умолчанию, запустите подкоманду reset. Она требует Claude Code v2.1.212 или позже и удаляет раздел `autoMode` из вашего файла пользовательских параметров:

381 367

409 395

410Вы можете добавить запись окружения или правило `allow` из вкладки [**Auto mode** диалога `/permissions`](#edit-rules-from-permissions).396Вы можете добавить запись окружения или правило `allow` из вкладки [**Auto mode** диалога `/permissions`](#edit-rules-from-permissions).

411 397

412В большинстве сеансов имя причины называет правило, которое совпал классификатор, в квадратных скобках, такое как `[Data Exfiltration]` или `[Production Deploy]`, и некоторые сеансы запускают модель классификатора, которая добавляет краткое объяснение. Claude Code выбирает модель классификатора, поэтому то, какую форму вы видите, — это не то, что вы можете настроить.398Текст в квадратных скобках, такой как `[Data Exfiltration]`, — это название правила, которое совпал классификатор. Чтобы прочитать полный текст этого правила, см. [Проверить значения по умолчанию и вашу эффективную конфигурацию](#inspect-the-defaults-and-your-effective-config).

413 399

414<h3 id="fix-repeated-denials">400<h3 id="fix-repeated-denials">

415 Исправить повторяющиеся отклонения401 Исправить повторяющиеся отклонения

417 403

418Повторяющиеся отклонения для одного и того же пункта назначения обычно означают, что классификатору не хватает контекста. Добавьте этот пункт назначения в `autoMode.environment` или [запустите `/auto-mode-setup`](#generate-environment-entries), чтобы Claude Code составил записи, затем запустите `claude auto-mode config`, чтобы подтвердить, что изменение вступило в силу.404Повторяющиеся отклонения для одного и того же пункта назначения обычно означают, что классификатору не хватает контекста. Добавьте этот пункт назначения в `autoMode.environment` или [запустите `/auto-mode-setup`](#generate-environment-entries), чтобы Claude Code составил записи, затем запустите `claude auto-mode config`, чтобы подтвердить, что изменение вступило в силу.

419 405

420Чтобы реагировать на отклонения программно, используйте [`PermissionDenied` hook](/docs/ru/hooks#permissiondenied).

~~421~~

422<h2 id="see-also">406<h2 id="see-also">

423 См. также407 См. также

424</h2>408</h2>

best-practices.md +3 −3

Details

46 46

47* **В одном запросе**: попросите Claude запустить проверку и повторить итерации в одном сообщении, как в таблице выше.47* **В одном запросе**: попросите Claude запустить проверку и повторить итерации в одном сообщении, как в таблице выше.

48* **На протяжении сеанса**: установите проверку как условие [`/goal`](/docs/ru/goal). Отдельный оценщик повторно проверяет её после каждого хода, и Claude продолжает работать, пока она не будет выполнена. Если Claude застопорится, Claude Code в конечном итоге остановит запуск с установленной целью — см. [как работает оценка /goal](/docs/ru/goal#how-evaluation-works).48* **На протяжении сеанса**: установите проверку как условие [`/goal`](/docs/ru/goal). Отдельный оценщик повторно проверяет её после каждого хода, и Claude продолжает работать, пока она не будет выполнена. Если Claude застопорится, Claude Code в конечном итоге остановит запуск с установленной целью — см. [как работает оценка /goal](/docs/ru/goal#how-evaluation-works).

49* **Как детерминированный шлюз**: [Stop hook](/docs/ru/hooks#stop) запускает вашу проверку как скрипт и блокирует завершение хода до тех пор, пока она не пройдёт. Claude Code переопределяет hook и завершает ход после 8 последовательных блокировок.49* **Как детерминированный шлюз**: [Stop hook](/docs/ru/hooks#stop) запускает вашу проверку как скрипт и блокирует завершение хода до тех пор, пока она не пройдёт. [Stop input](/docs/ru/hooks#stop-input) охватывает ограничение на последовательные блокировки.

50* **По второму мнению**: [verification subagent](/docs/ru/sub-agents) или [dynamic workflow](/docs/ru/workflows), который проверяет собственные выводы, имеет свежую модель, которая пытается опровергнуть результат, поэтому агент, выполняющий работу, не является тем, кто её оценивает.50* **По второму мнению**: [verification subagent](/docs/ru/sub-agents) или [dynamic workflow](/docs/ru/workflows), который проверяет собственные выводы, имеет свежую модель, которая пытается опровергнуть результат, поэтому агент, выполняющий работу, не является тем, кто её оценивает.

51 51

52Каждый шаг обменивает настройку на внимание. Версия с запросом работает на любой задаче сегодня. Версии `/goal` и Stop hook — это то, что позволяет неконтролируемому запуску завершиться правильно без вас.52Каждый шаг обменивает настройку на внимание. Версия с запросом работает на любой задаче сегодня. Версии `/goal` и Stop hook — это то, что позволяет неконтролируемому запуску завершиться правильно без вас.

209 Чтобы получить меньше подсказок без потери контроля, предварительно одобрите инструменты, которым вы доверяете, с помощью `/permissions` и позвольте изолированным командам работать без запроса с помощью `/sandbox`. Переключитесь в режим Manual, когда вы хотите одобрить правки и команды самостоятельно.209 Чтобы получить меньше подсказок без потери контроля, предварительно одобрите инструменты, которым вы доверяете, с помощью `/permissions` и позвольте изолированным командам работать без запроса с помощью `/sandbox`. Переключитесь в режим Manual, когда вы хотите одобрить правки и команды самостоятельно.

210</Tip>210</Tip>

211 211

212На планах Pro, Max и Team, auto mode — это [встроенный начальный режим разрешений](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) для интерактивных сеансов терминала и VS Code: отдельная модель-классификатор проверяет большинство действий вместо вас и блокирует только то, что выглядит рискованно, например расширение области, неизвестная инфраструктура или действия, вызванные враждебным контентом.212С Claude Code v2.1.283 или позже, auto mode — это [встроенный начальный режим разрешений](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) для интерактивных сеансов терминала и VS Code: отдельная модель-классификатор проверяет большинство действий вместо вас и блокирует только то, что выглядит рискованно, например расширение области, неизвестная инфраструктура или действия, вызванные враждебным контентом. На более ранних версиях, auto mode — это встроенный начальный режим разрешений только на планах Pro, Max и Team.

213 213

214В режиме Manual, встроенном начальном режиме разрешений на других планах, Claude Code запрашивает разрешение перед действиями, которые могут модифицировать вашу систему: записи файлов, команды Bash, MCP tools. Это безопасно, но утомительно. После десятого одобрения вы кликаете, не совсем проверяя. Два инструмента сокращают эти прерывания в режиме Manual и применяются также в режиме auto:214В режиме Manual, Claude Code запрашивает разрешение перед действиями, которые могут модифицировать вашу систему: записи файлов, команды Bash, MCP tools. Это безопасно, но утомительно. После десятого одобрения вы кликаете, не совсем проверяя. Два инструмента сокращают эти прерывания в режиме Manual и применяются также в режиме auto:

215 215

216* **Белые списки разрешений**: разрешить конкретные инструменты, которые вы знаете, что безопасны, например `npm run lint` или `git commit`216* **Белые списки разрешений**: разрешить конкретные инструменты, которые вы знаете, что безопасны, например `npm run lint` или `git commit`

217* **Sandboxing**: включить изоляцию на уровне ОС, которая ограничивает доступ к файловой системе и сети, позволяя Claude работать более свободно в определённых границах217* **Sandboxing**: включить изоляцию на уровне ОС, которая ограничивает доступ к файловой системе и сети, позволяя Claude работать более свободно в определённых границах

channels.md +1 −1

Details

359 359

360Во время превью `--channels` принимает только плагины из списка разрешенных, поддерживаемого Anthropic, или из списка разрешенных вашей организации, если администратор установил [`allowedChannelPlugins`](#restrict-which-channel-plugins-can-run). Плагины каналов в [claude-plugins-official](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins) — это набор по умолчанию, одобренный Anthropic. Если вы передадите что-то, что не находится в действующем списке разрешенных, Claude Code запустится нормально, но канал не зарегистрируется, и уведомление при запуске скажет вам почему.360Во время превью `--channels` принимает только плагины из списка разрешенных, поддерживаемого Anthropic, или из списка разрешенных вашей организации, если администратор установил [`allowedChannelPlugins`](#restrict-which-channel-plugins-can-run). Плагины каналов в [claude-plugins-official](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins) — это набор по умолчанию, одобренный Anthropic. Если вы передадите что-то, что не находится в действующем списке разрешенных, Claude Code запустится нормально, но канал не зарегистрируется, и уведомление при запуске скажет вам почему.

361 361

362Для тестирования создаваемого вами канала используйте `--dangerously-load-development-channels`. См. [Тестирование во время исследовательского превью](/docs/ru/channels-reference#test-during-the-research-preview) для информации о тестировании пользовательских каналов, которые вы создаете.362Для тестирования создаваемого вами канала передайте его в `--dangerously-load-development-channels` в форме `plugin:<name>@<marketplace>` или `server:<name>`. См. [Тестирование во время исследовательского превью](/docs/ru/channels-reference#test-during-the-research-preview) для информации о тестировании пользовательских каналов, которые вы создаете.

363 363

364Сообщайте о проблемах или отзывах в [репозитории Claude Code на GitHub](https://github.com/anthropics/claude-code/issues).364Сообщайте о проблемах или отзывах в [репозитории Claude Code на GitHub](https://github.com/anthropics/claude-code/issues).

365 365

channels-reference.md +1 −1

Details

803 803

804Чтобы сделать ваш канал устанавливаемым и общим, оберните его в [плагин](/docs/ru/plugins/overview) и опубликуйте на [маркетплейс](/docs/ru/plugins/overview). Пользователи устанавливают его с `/plugin install`, затем включают его за сеанс с `--channels plugin:<name>@<marketplace>`.804Чтобы сделать ваш канал устанавливаемым и общим, оберните его в [плагин](/docs/ru/plugins/overview) и опубликуйте на [маркетплейс](/docs/ru/plugins/overview). Пользователи устанавливают его с `/plugin install`, затем включают его за сеанс с `--channels plugin:<name>@<marketplace>`.

805 805

806Канал, опубликованный на вашем собственном маркетплейсе, по-прежнему требует `--dangerously-load-development-channels` для запуска, так как он не находится в [одобренном списке разрешений](/docs/ru/channels#supported-channels). Список разрешений по умолчанию — это плагины каналов в `claude-plugins-official`. [Встроенные формы отправки](/docs/ru/plugins/publish#submit-to-the-community-marketplace) добавляют плагины на маркетплейс сообщества, который не находится в списке разрешений каналов.806Канал, опубликованный на вашем собственном маркетплейсе, по-прежнему требует `--dangerously-load-development-channels` для запуска, так как он не находится в [одобренном списке разрешений](/docs/ru/channels#supported-channels). Список разрешений по умолчанию — это плагины каналов в `claude-plugins-official`. Маркетплейс сообщества не находится в списке разрешений каналов.

807 807

808Если вы работаете с контактом партнёра Anthropic, свяжитесь с ними, чтобы согласовать официальный список маркетплейса. На планах Team и Enterprise администратор может вместо этого включить ваш плагин в список [`allowedChannelPlugins`](/docs/ru/channels#restrict-which-channel-plugins-can-run) организации, который заменяет список разрешений Anthropic по умолчанию.808Если вы работаете с контактом партнёра Anthropic, свяжитесь с ними, чтобы согласовать официальный список маркетплейса. На планах Team и Enterprise администратор может вместо этого включить ваш плагин в список [`allowedChannelPlugins`](/docs/ru/channels#restrict-which-channel-plugins-can-run) организации, который заменяет список разрешений Anthropic по умолчанию.

809 809

checkpointing.md +1 −1

Details

114 Сообщения, отправленные во время хода, не сохраняются в checkpoint114 Сообщения, отправленные во время хода, не сохраняются в checkpoint

115</h3>115</h3>

116 116

117Когда сообщение, которое вы [ставите в очередь, пока Claude работает](/docs/ru/interactive-mode#queue-messages-while-claude-works), достигает Claude в течение текущего хода, оно присоединяется к этому ходу вместо того, чтобы начать новый. Сообщение появляется в беседе, но Claude Code не создаёт для него checkpoint, и меню rewind его не отображает. Сообщение в очереди, которое Claude Code отправляет как свой собственный ход, получает checkpoint как обычно.117Когда сообщение, которое вы [ставите в очередь, пока Claude работает](/docs/ru/interactive-mode#queue-messages-while-claude-works), достигает Claude в течение текущего хода, оно присоединяется к этому ходу вместо того, чтобы начать новый. Сообщение появляется в беседе, но Claude Code не создаёт для него checkpoint, и меню rewind его не отображает. Сообщение в очереди, которое Claude Code отправляет как свой собственный ход, получает checkpoint как обычно, включая случаи, когда несколько сообщений в очереди [совместно используют этот ход](/docs/ru/interactive-mode#when-claude-code-sends-what-you-queued).

118 118

119Чтобы удалить такое сообщение или отменить правки, которые Claude внёс после него, выполните rewind до подсказки, которая начала ход. Это выполнит rewind всего хода, включая работу, которую Claude выполнил до прибытия вашего сообщения.119Чтобы удалить такое сообщение или отменить правки, которые Claude внёс после него, выполните rewind до подсказки, которая начала ход. Это выполнит rewind всего хода, включая работу, которую Claude выполнил до прибытия вашего сообщения.

120 120

claude-apps-gateway.md +2 −2

Details

77| Поставщик удостоверений OpenID Connect (OIDC) | Okta, Microsoft Entra ID, Google Workspace, Keycloak или Dex, или любой другой совместимый с OIDC IdP, такой как PingFederate. Шлюз запускает стандартное обнаружение OIDC и поток кода авторизации против него. SAML и LDAP не поддерживаются. |77| Поставщик удостоверений OpenID Connect (OIDC) | Okta, Microsoft Entra ID, Google Workspace, Keycloak или Dex, или любой другой совместимый с OIDC IdP, такой как PingFederate. Шлюз запускает стандартное обнаружение OIDC и поток кода авторизации против него. SAML и LDAP не поддерживаются. |

78| PostgreSQL 14 или позже | Поддерживает поток входа устройства, где обратный вызов браузера пишет, а опрашивающий CLI читает, плюс счётчики ограничения скорости. Любой управляемый Postgres работает, включая самый маленький уровень. Без настроенных ограничений расходов шлюз хранит несколько КБ краткосрочного состояния аутентификации; с [ограничениями расходов](/docs/ru/claude-apps-gateway-spend-limits) он также содержит долговечные таблицы расходов, аудита и идентификации, которые должны быть скопированы. TLS через `?sslmode=require` рекомендуется. |78| PostgreSQL 14 или позже | Поддерживает поток входа устройства, где обратный вызов браузера пишет, а опрашивающий CLI читает, плюс счётчики ограничения скорости. Любой управляемый Postgres работает, включая самый маленький уровень. Без настроенных ограничений расходов шлюз хранит несколько КБ краткосрочного состояния аутентификации; с [ограничениями расходов](/docs/ru/claude-apps-gateway-spend-limits) он также содержит долговечные таблицы расходов, аудита и идентификации, которые должны быть скопированы. TLS через `?sslmode=require` рекомендуется. |

79| Вышестоящий уровень модели | Учётные данные Amazon Bedrock, учётные данные Claude Platform on AWS, учётные данные Google Cloud, ресурс Microsoft Foundry или ключ API Anthropic. Поддерживаются несколько вышестоящих уровней с отказоустойчивостью. |79| Вышестоящий уровень модели | Учётные данные Amazon Bedrock, учётные данные Claude Platform on AWS, учётные данные Google Cloud, ресурс Microsoft Foundry или ключ API Anthropic. Поддерживаются несколько вышестоящих уровней с отказоустойчивостью. |

80| HTTPS | Шлюз должен быть доступен по `https://` с ноутбуков разработчиков и из любого браузера, используемого для входа; шлюз служит страницей проверки устройства на том же слушателе. Либо предоставьте сертификат TLS через `listen.tls`, либо запустите позади завершающего TLS входа, и установите `listen.public_url` на внешнее происхождение в обоих случаях. Простое происхождение `http://` принимается только когда хост шлюза является loopback: `localhost`, `127.0.0.1` или `::1`. |80| HTTPS | Шлюз должен быть доступен по `https://` с ноутбуков разработчиков и из любого браузера, используемого для входа; шлюз служит страницей проверки устройства на том же слушателе. Либо предоставьте сертификат TLS через `listen.tls`, либо запустите позади завершающего TLS входа, и установите `listen.public_url` на внешнее происхождение в обоих случаях. При `/login` Claude Code принимает простое происхождение `http://` только когда хост шлюза является loopback: `localhost`, `127.0.0.1` или `::1`. |

81| Адрес частной сети | При `/login` Claude Code требует, чтобы имя хоста или IP-адрес шлюза разрешались только в частные адреса: RFC 1918, link-local, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` или loopback. Для шлюза, который вы размещаете, любой общедоступный адрес вне блока, который вы объявляете, отклоняется; см. [модель угроз](/docs/ru/claude-apps-gateway-deploy#threat-model-summary) в руководстве развёртывания. Если машины разработчиков маршрутизируют HTTPS через корпоративный прокси, вход также требует, чтобы хост прокси разрешался в частные адреса; если это не так, добавьте хост шлюза в `NO_PROXY`, чтобы CLI подключался напрямую. Если ваша внутренняя сеть пронумерована из общедоступного пространства IPv4, которым владеет ваша организация, [объявите эти блоки](#allow-a-gateway-on-public-address-space-you-own), чтобы `/login` принял шлюз там. |81| Адрес частной сети | При `/login` Claude Code требует, чтобы имя хоста или IP-адрес шлюза разрешались только в частные адреса: RFC 1918, link-local, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` или loopback. Для шлюза, который вы размещаете, любой общедоступный адрес вне блока, который вы объявляете, отклоняется; см. [модель угроз](/docs/ru/claude-apps-gateway-deploy#threat-model-summary) в руководстве развёртывания. Если машины разработчиков маршрутизируют HTTPS через корпоративный прокси, вход также требует, чтобы хост прокси разрешался в частные адреса; если это не так, добавьте хост шлюза в `NO_PROXY`, чтобы CLI подключался напрямую. Если ваша внутренняя сеть пронумерована из общедоступного пространства IPv4, которым владеет ваша организация, [объявите эти блоки](#allow-a-gateway-on-public-address-space-you-own), чтобы `/login` принял шлюз там. |

82| Среда выполнения Linux | Сервер шлюза работает только на собственном двоичном файле Linux. macOS работает для локальной разработки. Windows не поддерживается как платформа сервера. |82| Среда выполнения Linux | Сервер шлюза работает только на собственном двоичном файле Linux. macOS работает для локальной разработки. Windows не поддерживается как платформа сервера. |

83 83

454 454

455Шесть параметров, предоставленных родителем, проходят фильтр даже со всеми пятью установленными блокировками. В соответствии с параметром первого выигрыша по умолчанию, значение администратора, которое блокирует родителя, находится в источнике администратора с наивысшим приоритетом, кроме `allowedMcpServers` пока [блокировка MCP сервера](#lock-behavior-across-sources) включена. В соответствии с согласием на объединение `managedSourcesBehavior`, [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) говорит, какое значение источника применяется вместо этого.455Шесть параметров, предоставленных родителем, проходят фильтр даже со всеми пятью установленными блокировками. В соответствии с параметром первого выигрыша по умолчанию, значение администратора, которое блокирует родителя, находится в источнике администратора с наивысшим приоритетом, кроме `allowedMcpServers` пока [блокировка MCP сервера](#lock-behavior-across-sources) включена. В соответствии с согласием на объединение `managedSourcesBehavior`, [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) говорит, какое значение источника применяется вместо этого.

456 456

457* **`forceLoginOrgUUID`**: Claude Code соблюдает значение, предоставленное родителем, когда источник администратора с наивысшим приоритетом не устанавливает UUID организации. Вход в шлюз не проверяет этот ключ, поэтому он имеет значение только для флотов, которые также используют входы Anthropic первой стороны. UUID организации в источнике администратора с наивысшим приоритетом блокирует значение родителя и является тем, который Claude Code применяет, поэтому установите `forceLoginOrgUUID` там.457* **`forceLoginOrgUUID`**: Claude Code соблюдает значение, предоставленное родителем, когда источник администратора с наивысшим приоритетом не устанавливает UUID организации. Вход в шлюз не проверяет этот ключ. UUID организации в источнике администратора с наивысшим приоритетом блокирует значение родителя и является тем, который Claude Code применяет.

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

459* **`availableModels`**: Claude Code соблюдает список моделей, предоставленный родителем, когда выигрывающий управляемый источник не устанавливает один. Если ваш флот ограничивает модели, установите `availableModels` в выигрывающем источнике.459* **`availableModels`**: Claude Code соблюдает список моделей, предоставленный родителем, когда выигрывающий управляемый источник не устанавливает один. Если ваш флот ограничивает модели, установите `availableModels` в выигрывающем источнике.

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

claude-apps-gateway-config.md +40 −3

Details

947* `OTEL_EXPORTER_OTLP_ENDPOINT=<public_url>`947* `OTEL_EXPORTER_OTLP_ENDPOINT=<public_url>`

948* `OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf`948* `OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf`

949 949

950Когда вы [добавляете свои собственные метки](#add-your-own-labels), gateway также отправляет `OTEL_RESOURCE_ATTRIBUTES`.

951

950До Claude Code v2.1.265 на сервере gateway, gateway отправлял все три селектора экспортера как `otlp`, включая для сигналов, которые ни одно назначение не включало.952До Claude Code v2.1.265 на сервере gateway, gateway отправлял все три селектора экспортера как `otlp`, включая для сигналов, которые ни одно назначение не включало.

951 953

952Отправленная конечная точка строится из публичного URL, поэтому метрики и логи не нуждаются в конфигурации OTEL от разработчиков или политик.954Отправленная конечная точка строится из публичного URL, поэтому метрики и логи не нуждаются в конфигурации OTEL от разработчиков или политик.

964 966

965Оба кодирования OTLP protobuf и JSON передаются, и любой совместимый с OpenTelemetry backend работает как назначение.967Оба кодирования OTLP protobuf и JSON передаются, и любой совместимый с OpenTelemetry backend работает как назначение.

966 968

969<h4 id="add-your-own-labels">

970 Добавление собственных меток

971</h4>

972

973Чтобы поместить фиксированные метки, такие как `service.namespace` или `deployment.environment.name`, на телеметрию сеансов, подписанных через gateway, установите `telemetry.resource_attributes`. Каждая метка — это атрибут ресурса OpenTelemetry, и каждое назначение получает одни и те же метки.

974

975Сеансы получают метки только, когда вы также устанавливаете `telemetry.forward_to` и `listen.public_url`. Этот пример добавляет две метки:

976

977```yaml theme={null}

978telemetry:

979 forward_to:

980 - url: https://otel-collector.internal.example.com

981 resource_attributes:

982 service.namespace: claude

983 deployment.environment.name: prod

984```

985

986Gateway отказывается запускаться, когда метка нарушает одно из этих правил, и ошибка запуска называет метку:

987

988* Имена используют только буквы, цифры, `.`, `_` и `-`

989* Имена не зарезервированы. Сравниваемые в любом регистре букв, зарезервированные имена — это всё, что начинается с `user.`, `enduser.` или `identity.`, плюс `service.name`, `service.version`, `claude.deployment_mode`, `host.arch`, `os.type`, `os.version` и `wsl.version`

990* Значения — это непустой печатный ASCII без пробела и ни одного из `, ; = \ " %`

991* Значения не более 255 символов, как их считает gateway после процентного кодирования, поэтому `/`, `:` и `@` каждый считаются как три

992* Значения — это текст, поэтому заключите в кавычки число, `true` или `false`

993

994Вам нужен Claude Code v2.1.281 или позже на сервере gateway для установки `telemetry.resource_attributes`. Более ранний gateway отказывается запускаться, когда находит ключ. Обновите каждую реплику перед добавлением ключа и удалите ключ перед откатом на более раннюю версию.

995

996Сеансы терминала, подписанные через `/login`, получают метки как `OTEL_RESOURCE_ATTRIBUTES`, отправленные с другими [переменными телеметрии](#telemetry). Если вы установите `OTEL_RESOURCE_ATTRIBUTES` в блоке `env` политики, сеансы терминала, которым соответствует эта политика, получают это значение вместо метк. Claude Desktop получает метки от gateway наряду с `user.email` и другими атрибутами идентификации.

997

998Claude Code также копирует каждую метку на каждую точку данных метрики, поэтому вы можете фильтровать метрики по ней в backend, который не индексирует атрибуты ресурса. Чтобы отключить эту копию, см. [Контроль кардинальности метрик](/docs/ru/monitoring-usage#metrics-cardinality-control).

999

967<h4 id="export-directly-to-your-collector">1000<h4 id="export-directly-to-your-collector">

968 Экспорт прямо на ваш сборщик1001 Экспорт прямо на ваш сборщик

969</h4>1002</h4>

1034 1067

1035Блок `load_test_mode` позволяет вам нагрузочно тестировать gateway без вызова поставщика модели. Пока он включён, gateway строит и подписывает каждый запрос поставщика как обычно, отбрасывает его вместо отправки и потоком консервированный ответ обратно через его нормальный путь ответа. Ответ — это текст-заполнитель, который начинается с предложения, говорящего, что это консервированный.1068Блок `load_test_mode` позволяет вам нагрузочно тестировать gateway без вызова поставщика модели. Пока он включён, gateway строит и подписывает каждый запрос поставщика как обычно, отбрасывает его вместо отправки и потоком консервированный ответ обратно через его нормальный путь ответа. Ответ — это текст-заполнитель, который начинается с предложения, говорящего, что это консервированный.

1036 1069

1037Требует v2.1.283 или позже. Более ранние версии отказываются запускаться, когда ключ установлен, поэтому обновите каждую реплику перед добавлением блока и удалите его перед откатом.1070Требует Claude Code v2.1.282 или позже на сервере gateway. Более ранние версии отказываются запускаться, когда ключ установлен, поэтому обновите каждую реплику перед добавлением блока и удалите его перед откатом.

1038 1071

1039Пример ниже включает режим с значениями по умолчанию, ответ из 750 выходных токенов, потоком в течение примерно 10 секунд:1072Пример ниже включает режим с значениями по умолчанию, ответ из примерно 750 выходных токенов, потоком в течение примерно 10 секунд:

1040 1073

1041```yaml theme={null}1074```yaml theme={null}

1042load_test_mode:1075load_test_mode:

1053 1086

1054Нагрузочный тест в этом режиме охватывает gateway, ваш Postgres и всё впереди gateway. Он не охватывает ограничения поставщика, скорость или сетевой путь.1087Нагрузочный тест в этом режиме охватывает gateway, ваш Postgres и всё впереди gateway. Он не охватывает ограничения поставщика, скорость или сетевой путь.

1055 1088

1056Пока режим включён, запрос может нести заголовок `x-load-test-user`, содержащий целое число до семи цифр, и gateway считает каждое число отдельным разработчиком с электронной почтой и группами разработчика, чей токен пришёл с запросом. Дайте развёртыванию нагрузочного теста свою собственную пустую базу данных, потому что gateway отказывается запускаться с режимом включённым против базы данных, в которой любой разработчик уже потратил что-то.1089Ни один запрос модели не отправляется поставщику, поэтому CPU реплики на запрос — это оценка и читает ниже, чем производство, которое также шифрует свой трафик поставщику. Подтвердите количество реплик с небольшим пилотом против реального поставщика. До v2.1.283 оценка читает намного ниже.

1090

1091Пока режим включён, запрос может нести заголовок `x-load-test-user`, содержащий целое число до семи цифр. Gateway считает каждое число отдельным разработчиком с электронной почтой и группами разработчика, чей токен пришёл с запросом.

1092

1093Дайте развёртыванию нагрузочного теста свою собственную пустую базу данных, потому что gateway отказывается запускаться с режимом включённым против базы данных, в которой любой разработчик уже потратил что-то.

1057 1094

1058<Warning>1095<Warning>

1059 Никогда не включайте это для gateway, который используют разработчики. Каждый запрос получает консервированный ответ и ни одна модель не вызывается. Gateway регистрирует предупреждение `load_test_mode is on` при загрузке и отмечает каждое событие аудита `inference` [audit event](/docs/ru/claude-apps-gateway-deploy#logs) с `load_test: true` пока режим включён.1096 Никогда не включайте это для gateway, который используют разработчики. Каждый запрос получает консервированный ответ и ни одна модель не вызывается. Gateway регистрирует предупреждение `load_test_mode is on` при загрузке и отмечает каждое событие аудита `inference` [audit event](/docs/ru/claude-apps-gateway-deploy#logs) с `load_test: true` пока режим включён.

claude-apps-gateway-deploy.md +62 −50

Details

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

156</h2>156</h2>

157 157

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

159 159

160<h3 id="logs">160<h3 id="logs">

161 Логи161 Логи

162</h3>162</h3>

163 163

164Шлюз записывает два потока в stderr, оба JSON-дружественные:164Шлюз записывает два потока в stderr, оба удобные для JSON:

165 165

166* **События аудита**: однострочный JSON для каждого события, связанного с безопасностью. Направьте stderr в ваш агрегатор логов.166* **События аудита**: одна строка JSON на каждое событие, связанное с безопасностью. Направьте stderr в ваш агрегатор логов.

167 167

168 Выдаваемые события включают `config.load`, `session.mint`, `session.refresh`, `device.authorize`, `device.verify`, `device.callback`, `auth.denied`, `access.denied`, `access.public_client`, `inference`, `managed.serve`, `desktop_bootstrap.serve`, `desktop_bootstrap.denied`, `spend.blocked`, `admin.denied`, `admin.limit.upsert` и `admin.limit.delete`. Поля варьируются по событиям:168 Излучаемые события включают `config.load`, `session.mint`, `session.refresh`, `device.authorize`, `device.verify`, `device.callback`, `auth.denied`, `access.denied`, `access.public_client`, `inference`, `managed.serve`, `desktop_bootstrap.serve`, `desktop_bootstrap.denied`, `spend.blocked`, `admin.denied`, `admin.limit.upsert` и `admin.limit.delete`. Поля варьируются в зависимости от события:

169 169

170 * Успешные события mint и refresh содержат `sub`, `email`, `client_ip` и результат170 * Успешные события mint и refresh содержат `sub`, `email`, `client_ip` и результат

171 * `auth.denied` и `access.denied` содержат причину и IP клиента, плюс путь запроса для `auth.denied`, так как идентификация пользователя не существует при этих отказах. Две причины `access.denied` изменяют то, что несет событие:171 * `auth.denied` и `access.denied` содержат причину и IP клиента, плюс путь запроса для `auth.denied`, так как в момент этих отказов не существует идентификации пользователя. Две причины `access.denied` изменяют то, что несёт событие:

172 * `xff_unparseable`: событие также содержит запись `X-Forwarded-For`, которую не удалось прочитать172 * `xff_unparseable`: событие также содержит запись `X-Forwarded-For`, которую не удалось прочитать

173 * `client_ip_unknown`: событие не содержит IP клиента, потому что соединение не имело адреса peer, пока был установлен список `access_control`173 * `client_ip_unknown`: событие не содержит IP клиента, потому что соединение не имело адреса узла, пока был установлен список `access_control`

174 * `access.public_client` содержит IP клиента первого запроса за процесс, поступившего с публичного адреса, пока `access_control.allow_cidrs` пуст. Шлюз обслуживает запрос как обычно; событие сигнализирует, что шлюз может быть доступен из публичного интернета. Смотрите [справку `access_control`](/docs/ru/claude-apps-gateway-config#http-tuning) для того, что считается публичным и для рекомендуемого списка разрешений.174 * `access.public_client` содержит IP клиента первого запроса за процесс, поступившего с публичного адреса, пока `access_control.allow_cidrs` пуст. Шлюз обслуживает запрос как обычно; событие сигнализирует, что шлюз может быть доступен из публичного интернета. Смотрите [справку `access_control`](/docs/ru/claude-apps-gateway-config#http-tuning) для информации о том, что считается публичным и для рекомендуемого списка разрешений.

175 * `inference` записывает, какой upstream обслужил запрос и статус ответа175 * `inference` записывает, какой вышестоящий сервер обслужил запрос и статус ответа

176 * `desktop_bootstrap.denied` записывает отклоненную выборку Claude Desktop bootstrap с причиной (`not_configured`, `policy_not_opted_in` или `no_policy_matched`) и идентификацией пользователя176 * `desktop_bootstrap.denied` записывает отклонённую выборку Claude Desktop bootstrap с причиной (`not_configured`, `policy_not_opted_in` или `no_policy_matched`) и идентификацией пользователя

177 * `admin.denied` записывает отклоненную попытку аутентификации admin-API с IP клиента, методом, путем и причиной, без представленного материала ключа: `invalid_key` когда был представлен `x-api-key`, но он не совпал ни с одним настроенным ключом, `bearer_rejected` когда был представлен только заголовок `Authorization` и он не проверился как сеанс шлюза в `admin.admin_groups`, или `no_credentials` когда ни один заголовок не был представлен177 * `admin.denied` записывает отклонённую попытку аутентификации admin-API с IP клиента, методом, путём и причиной, без представленного ключевого материала: `invalid_key` когда был представлен `x-api-key`, но он не совпал ни с одним настроенным ключом, `bearer_rejected` когда был представлен только заголовок `Authorization` и он не проверился как сеанс шлюза в `admin.admin_groups`, или `no_credentials` когда ни один заголовок не был представлен

178* **Операционные логи**: читаемые для человека строки с префиксом `[gateway]` для загрузки, предупреждений и ошибок upstream. Переменная окружения `CLAUDE_GATEWAY_LOG_LEVEL` управляет многословностью и принимает `debug`, `info`, `warn` или `error`, с `info` по умолчанию. При `debug`, каждый вход и обновление также логируют имена, а не значения, утверждений в id\_token, плюс имена утверждений userinfo когда `userinfo_fallback` предоставил какие-либо, поэтому вы можете диагностировать параметры `email_claim` и `groups_claim` без логирования PII. Это не влияет на события аудита, которые всегда выдаются.178* **Операционные логи**: удобочитаемые строки с префиксом `[gateway]` для загрузки, предупреждений и ошибок вышестоящих серверов. Переменная окружения `CLAUDE_GATEWAY_LOG_LEVEL` управляет подробностью и принимает `debug`, `info`, `warn` или `error`, с `info` по умолчанию. На уровне `debug` каждый вход и обновление также логируют имена, а не значения, утверждений в id\_token, плюс имена утверждений userinfo когда `userinfo_fallback` предоставил какие-либо, так что вы можете диагностировать параметры `email_claim` и `groups_claim` без логирования PII. Это не влияет на события аудита, которые всегда излучаются.

179 179

180<h3 id="health">180<h3 id="health">

181 Здоровье181 Здоровье

182</h3>182</h3>

183 183

184Шлюз обслуживает `GET /healthz` как зонд живучести и `GET /readyz` как зонд готовности; `/readyz` проверяет доступность хранилища. Оба исключены из `access_control.allow_cidrs`, поэтому зонды продолжают работать на заблокированном слушателе.184Шлюз обслуживает `GET /healthz` как зонд живучести и `GET /readyz` как зонд готовности. `/readyz` проверяет доступность хранилища. Если вы установили [`store.readiness_grace_seconds`](/docs/ru/claude-apps-gateway-config#store), `/readyz` продолжает сообщать о готовности до этого количества секунд после того, как хранилище перестаёт отвечать.

185 185

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

187

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

187 189

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

189 Одновременные upstream запросы191 Одновременные вышестоящие запросы

190</h3>192</h3>

191 193

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

193 195

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

195 197

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

197 199

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

199 201

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

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

202 204

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

204 206

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

206 208

207<Warning>209<Warning>

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

209</Warning>211</Warning>

210 212

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

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

213</h3>215</h3>

214 216

215Если Postgres выходит из строя, сам шлюз продолжает обслуживать вошедших разработчиков, а новые входы не удаются. Продолжают ли разработчики работать, зависит от того, как ваш оркестратор обрабатывает готовность:217Если Postgres выходит из строя, сам шлюз продолжает обслуживать вошедших разработчиков, а новые входы не удаются. Действительно ли разработчики продолжают работать, зависит от того, как ваш оркестратор обрабатывает готовность:

218

219* **Существующие сеансы**: токены-носители проверяются локально с помощью секрета JWT, обновления сеансов не касаются хранилища, и процесс шлюза всё ещё может обслуживать вывод

220* **Новые входы**: не удаются до восстановления Postgres, потому что поток устройства и его счётчики ограничения скорости находятся в Postgres

221* **[Применение лимита расходов](/docs/ru/claude-apps-gateway-spend-limits#postgres-availability)**: по умолчанию не выполняется во время сбоя, поэтому вывод всё ещё течёт; переключитесь на отказ в закрытом состоянии, если вы предпочитаете блокировать, чем работать без учёта

222* **Готовность**: по умолчанию `/readyz` сообщает о неготовности, как только Postgres недоступен, поэтому каждая реплика не выполняет свою проверку готовности одновременно. Где трафик достигает только реплик, которые проходят проверку, весь трафик, включая вывод, который шлюз всё ещё может обслуживать, не выполняется до восстановления Postgres. Зонд живучести на `/healthz` продолжает проходить на протяжении всего времени.

223

224Если ваш IdP выходит из строя, существующие сеансы работают до `ttl_hours` и новые входы не удаются. Обновление сеанса получает ответ повторить попытку и успешно выполняется после восстановления IdP. Установите более длительный `ttl_hours`, если ваш IdP имеет частые окна обслуживания.

225

226<h4 id="readiness-grace-period">

227 Период благодати готовности

228</h4>

229

230Чтобы сохранить вошедших разработчиков работающими через короткий сбой Postgres, такой как отказоустойчивость базы данных, установите [`store.readiness_grace_seconds`](/docs/ru/claude-apps-gateway-config#store) на более длительное время, чем требуется отказоустойчивость, например `300`. При включённых лимитах расходов и поведении отказа по умолчанию, запросы через реплику, которая остаётся готовой, не учитываются до восстановления Postgres, поэтому держите значение как можно ниже, чтобы оно охватывало вашу отказоустойчивость. Если вы установили [`enforcement.fail_closed_on_error: true`](/docs/ru/claude-apps-gateway-config#enforcement), шлюз отказывает вывод вошедших разработчиков с сообщением `429` `spend limit unavailable` до восстановления Postgres, даже пока реплики всё ещё проходят свою проверку готовности.

216 231

217* **Существующие сеансы**: bearer tokens проверяются локально с помощью JWT secret, обновления сеанса не касаются хранилища, и процесс шлюза все еще может обслуживать inference232Параметр требует Claude Code v2.1.282 или позже на сервере шлюза. Более ранний шлюз отказывается запускаться, когда находит ключ, поэтому обновите каждую реплику перед добавлением. [Обновления](#upgrades) охватывают откат.

218* **Новые входы**: не удаются до восстановления Postgres, потому что поток устройства и его счетчики ограничения скорости живут в Postgres

219* **[Применение ограничения расходов](/docs/ru/claude-apps-gateway-spend-limits#postgres-availability)**: по умолчанию не удается открыто во время сбоя, поэтому inference все еще течет; переключите его на отказ закрыто, если вы предпочитаете блокировать, чем работать без учета

220* **Готовность**: `/readyz` сообщает о неготовности во время сбоя, поэтому оркестраторы, которые управляют трафиком на готовность, удаляют каждую реплику из ротации сразу. В этой топологии весь трафик, включая inference, который шлюз все еще может обслуживать, не удается на балансировщике нагрузки до восстановления Postgres. Зонд живучести на `/healthz` продолжает проходить, поэтому реплики не перезапускаются. Укажите зонд готовности на `/healthz` вместо этого, если вы предпочитаете, чтобы вошедшие разработчики продолжали работать через сбой хранилища; стоимость в том, что новые входы не удаются против реплики, которая все еще сообщает о готовности.

221 233

222Если ваш IdP выходит из строя, существующие сеансы работают до `ttl_hours`, новые входы не удаются, и обновление сеанса получает ответ повторить попытку и проходит после восстановления IdP. Установите более длительный `ttl_hours`, если ваш IdP имеет частые окна обслуживания.234Если вы направите зонд готовности на `/healthz` вместо этого, реплики также продолжают проходить его через сбой, но `/healthz` никогда не сообщает о неготовности, поэтому реплика, чьё соединение Postgres не восстанавливается, продолжает проходить тоже.

223 235

224<h3 id="jwt-secret-rotation">236<h3 id="jwt-secret-rotation">

225 Ротация JWT secret237 Ротация секрета JWT

226</h3>238</h3>

227 239

228Ротируйте подписывающий secret в три этапа, чтобы существующие сеансы оставались действительными:240Ротируйте секрет подписи поэтапно, чтобы существующие сеансы оставались действительными:

229 241

2301. Создайте новый secret. Добавьте его в начало массива `session.jwt_secret`.2421. Сгенерируйте новый секрет. Добавьте его в начало массива `session.jwt_secret`.

2312. Разверните развертывание. Новые tokens подписываются новым secret; старые tokens все еще проверяются.2432. Разверните развёртывание. Новые токены подписываются новым секретом; старые токены всё ещё проверяются.

2323. После `ttl_hours` плюс запас, удалите старый secret и разверните снова.2443. После `ttl_hours` плюс запас, удалите старый секрет и разверните снова.

233 245

234Ротация также является единственным способом вынудить сеансы выйти до истечения: bearer tokens проверяются локально против JWT secret, поэтому нет отзыва для каждого сеанса. Замена secret полностью, без сохранения старого в массиве, делает недействительным каждый выдающийся сеанс сразу. Для индивидуального offboarding deprovision пользователя в вашем IdP; их сеанс заканчивается в течение `ttl_hours`.246Ротация также является единственным способом вынудить сеансы выйти до их истечения: токены-носители проверяются локально против секрета JWT, поэтому нет отзыва для каждого сеанса. Замена секрета полностью, без сохранения старого в массиве, делает недействительным каждый выдающийся сеанс сразу. Для индивидуального отключения отмените подготовку пользователя в вашем IdP; их сеанс заканчивается в течение `ttl_hours`.

235 247

236<h3 id="postgres">248<h3 id="postgres">

237 Postgres249 Postgres

239 251

240Шлюз содержит пять таблиц данных плюс таблицу `_migrations`, все созданные его миграциями при загрузке:252Шлюз содержит пять таблиц данных плюс таблицу `_migrations`, все созданные его миграциями при загрузке:

241 253

243| - | - | - |255| - | - | - |

244| `kv` | Гранты устройства (10-минутный TTL) и счетчики ограничения скорости | TTL для каждой строки |256| `kv` | Гранты устройств (TTL 10 минут) и счётчики ограничения скорости | TTL за строку |

248| `principal_emails` | Последний просмотренный email каждого principal, отображаемое имя и группы IdP. Содержит PII. | `admin.identity_retention_days` с момента последней активности, по умолчанию 90 |260| `principal_emails` | Последний просмотренный адрес электронной почты каждого принципала, отображаемое имя и группы IdP. Содержит PII. | `admin.identity_retention_days` с момента последней активности, по умолчанию 90 |

249 261

250Цикл на 30 секунд истекает строки `kv` прошедшие их TTL, и почасовая очистка применяет окна хранения на таблицы расходов, поэтому ничего не растет без ограничений. Без [ограничений расходов](/docs/ru/claude-apps-gateway-spend-limits) настроенных, только `kv` записывается. Шлюз применяет свои собственные миграции схемы при загрузке и при каждом обновлении, поэтому его роль базы данных нуждается в правах для создания и изменения таблиц. Укажите его на базу данных или схему, выделенную для шлюза, чтобы сохранить это разрешение узким.262Цикл в 30 секунд истекает строки `kv` после их TTL, и почасовая очистка применяет окна удержания на таблицы расходов, поэтому ничего не растёт без ограничений. Без [лимитов расходов](/docs/ru/claude-apps-gateway-spend-limits) настроенных, только `kv` записывается. Шлюз применяет свои собственные миграции схемы при загрузке и при каждом обновлении, поэтому его роль базы данных нуждается в правах на создание и изменение таблиц. Направьте его на базу данных или схему, выделенную для шлюза, чтобы сохранить это разрешение узким.

251 263

252С ограничениями расходов в использовании, потерянная база данных означает потерю отслеживания расходов и лимитов, а не просто повторные входы разработчиков, поэтому запускайте регулярные резервные копии. Чтобы стереть одного ушедшего разработчика немедленно, а не ждать хранения, запустите `DELETE FROM principal_emails WHERE principal = '<sub>'` напрямую; это удаляет единственную таблицу, содержащую их email, имя и группы. Строки `spend` и `admin_audit` ссылаются только на псевдонимный OIDC `sub`.264При использовании лимитов расходов потерянная база данных означает потерю отслеживания расходов и лимитов, а не только повторные входы разработчиков, поэтому выполняйте регулярные резервные копии. Чтобы стереть одного ушедшего разработчика немедленно, а не ждать удержания, запустите `DELETE FROM principal_emails WHERE principal = '<sub>'` напрямую; это удаляет единственную таблицу, содержащую их адрес электронной почты, имя и группы. Строки `spend` и `admin_audit` ссылаются только на псевдонимный OIDC `sub`.

253 265

254<h3 id="upgrades">266<h3 id="upgrades">

255 Обновления267 Обновления

256</h3>268</h3>

257 269

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

259 271

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

261 273

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

263 275

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

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

266 278

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

268 280

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

270 282

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

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

273 285

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

275 287

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

277 289

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

279 291

280<h2 id="security">292<h2 id="security">

281 Безопасность293 Безопасность

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

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

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

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

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

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

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

claude-apps-gateway-on-aws.md +3 −1

Details

255 255

256 store:256 store:

257 postgres_url: ${GATEWAY_POSTGRES_URL} # EKS: ${file:/secrets/postgres-url}257 postgres_url: ${GATEWAY_POSTGRES_URL} # EKS: ${file:/secrets/postgres-url}

258 # readiness_grace_seconds: 300 # продолжайте проходить проверку здоровья

259 # через отказ RDS

258 260

259 upstreams:261 upstreams:

260 - provider: bedrock262 - provider: bedrock

423 --load-balancers "targetGroupArn=$TG_ARN,containerName=gateway,containerPort=8080"425 --load-balancers "targetGroupArn=$TG_ARN,containerName=gateway,containerPort=8080"

424 ```426 ```

425 427

426 Период благодати в 60 секунд даёт холодной задаче время на извлечение образа, подключение к хранилищу и ответ на первую проверку здоровья перед тем, как ECS начнёт считать отказы против развёртывания. Проверка здоровья целевой группы на `GET /readyz` проверяет, что хранилище доступно, поэтому задача, которая не может достичь Postgres, никогда не входит в ротацию; см. [Поведение при сбое](/docs/ru/claude-apps-gateway-deploy#outage-behavior) для компромисса и альтернативы `/healthz`.428 Период благодати в 60 секунд даёт холодной задаче время на извлечение образа, подключение к хранилищу и ответ на первую проверку здоровья перед тем, как ECS начнёт считать отказы против развёртывания. Проверка здоровья целевой группы на `GET /readyz` проверяет, что хранилище доступно, поэтому задача, которая не может достичь Postgres, никогда не входит в ротацию. Чтобы держать задачи проходящими проверку через короткий сбой базы данных, такой как отказ RDS, установите `store.readiness_grace_seconds`, как описано в [Поведение при сбое](/docs/ru/claude-apps-gateway-deploy#outage-behavior), которое также охватывает альтернативу `/healthz`.

427 429

428 Задачи работают в приватных подсетях без публичного IP, поэтому весь исходящий трафик (в Bedrock, ваш IdP, Secrets Manager, ECR и CloudWatch Logs) проходит через NAT gateway. Чтобы держать трафик Bedrock вне публичного пути, создайте интерфейсную конечную точку VPC `bedrock-runtime` и укажите `base_url` upstream на неё, как показано в [справочнике upstream Bedrock](/docs/ru/claude-apps-gateway-config#amazon-bedrock); IdP всё ещё нуждается в исходящем доступе в интернет.430 Задачи работают в приватных подсетях без публичного IP, поэтому весь исходящий трафик (в Bedrock, ваш IdP, Secrets Manager, ECR и CloudWatch Logs) проходит через NAT gateway. Чтобы держать трафик Bedrock вне публичного пути, создайте интерфейсную конечную точку VPC `bedrock-runtime` и укажите `base_url` upstream на неё, как показано в [справочнике upstream Bedrock](/docs/ru/claude-apps-gateway-config#amazon-bedrock); IdP всё ещё нуждается в исходящем доступе в интернет.

429 431

claude-apps-gateway-spend-limits.md +20 −18

Details

52* Токен bearer gateway, чей claim `groups` включает одну из [`admin.admin_groups`](/docs/ru/claude-apps-gateway-config#admin). Это полный доступ и аудит как `oidc:<sub>`, поэтому предпочитайте это для администраторов-людей.52* Токен bearer gateway, чей claim `groups` включает одну из [`admin.admin_groups`](/docs/ru/claude-apps-gateway-config#admin). Это полный доступ и аудит как `oidc:<sub>`, поэтому предпочитайте это для администраторов-людей.

53 53

54<h2 id="how-enforcement-works">54<h2 id="how-enforcement-works">

~~55 Как работает соблюдение~~55 Как работает принудительное применение

56</h2>56</h2>

57 57

58При каждом запросе `/v1/messages` gateway разрешает лимиты разработчика и расходы с начала периода в одном запросе Postgres. Разработчик, превысивший какой-либо лимит, получает `429` с `error.type: billing_error` и заголовком `x-should-retry: false`.58При каждом запросе `/v1/messages` шлюз ищет лимиты разработчика и его расходы с начала периода в одном запросе Postgres. Разработчик, превысивший любой лимит, получает `429` с `error.type: billing_error` и заголовком `x-should-retry: false`.

59 59

60Сообщение указывает период и время сброса, например `spend limit reached (daily; resets 2026-08-08 00:00 UTC)`, за которым следует ваш [`admin.blocked_message`](/docs/ru/claude-apps-gateway-config#admin), если установлен. Когда разработчик превышает несколько лимитов одновременно, сообщение указывает лимит, который сбрасывается последним. Ответ также содержит заголовок `retry-after` с количеством секунд до этого сброса. До версии 2.1.225 на сервере gateway сообщение было `spend limit reached` без периода, времени сброса или заголовка `retry-after`.60Сообщение указывает период и время сброса, например `spend limit reached (daily; resets 2026-08-08 00:00 UTC)`, за которым следует ваш [`admin.blocked_message`](/docs/ru/claude-apps-gateway-config#admin), если он установлен. Когда разработчик превышает несколько лимитов одновременно, сообщение указывает лимит, который сбрасывается последним. Ответ также содержит заголовок `retry-after` с количеством секунд до этого сброса. До версии 2.1.225 на сервере шлюза сообщение было `spend limit reached` без периода, времени сброса или заголовка `retry-after`.

61 61

62На версии 2.1.227 или позже справочник протокола по адресу `<public_url>/protocol` также перечисляет точные заголовки ответа об ограничении использования и тело `429`.62На версии 2.1.227 или позже справочник протокола по адресу `<public_url>/protocol` также содержит точные заголовки ответа об ограничении использования и тело `429`.

63 63

64Лимиты сбрасываются на границах календаря UTC: ежедневно в 00:00 UTC, еженедельно в понедельник и ежемесячно в первый день. Gateway никогда не блокирует `/v1/messages/count_tokens`, потому что подсчет токенов бесплатен.64Лимиты сбрасываются на границах календаря UTC: ежедневно в 00:00 UTC, еженедельно в понедельник и ежемесячно в первый день. Шлюз никогда не блокирует `/v1/messages/count_tokens`, так как подсчёт токенов бесплатен.

65 65

66<h3 id="how-requests-are-priced">66<h3 id="how-requests-are-priced">

67 Как оцениваются запросы67 Как оцениваются запросы

68</h3>68</h3>

69 69

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

71 71

~~72Счетчик выбирает тарифы каждого запроса в этом порядке:~~72Счётчик выбирает тарифы каждого запроса в этом порядке:

73 73

741. Совпадающая строка [`pricing.overrides`](/docs/ru/claude-apps-gateway-config#pricing) для upstream, который обслужил запрос. Требует версию 2.1.227 или позже.741. Соответствующая строка [`pricing.overrides`](/docs/ru/claude-apps-gateway-config#pricing) для upstream, который обслужил запрос. Требует версию 2.1.227 или позже.

752. Прайс-лист для ID модели upstream, строка, которую gateway отправляет провайдеру, когда таблица стоимости Claude Code ее распознает. Таблица принимает формы Anthropic, Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry ID.752. Прайс-лист для ID модели upstream, строка, которую шлюз отправляет поставщику, когда таблица стоимости Claude Code её распознаёт. Таблица принимает формы Anthropic, Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry ID.

763. Прайс-лист для [`models[].id`](/docs/ru/claude-apps-gateway-config#models), который вы сопоставили с этим ID upstream, для строк upstream, которые не содержат имя модели, например ARN профиля вывода приложения Amazon Bedrock или имя развертывания Microsoft Foundry. Требует версию 2.1.218 или позже.763. Прайс-лист для [`models[].id`](/docs/ru/claude-apps-gateway-config#models), который вы сопоставили этому ID upstream, для строк upstream, которые не содержат имя модели, например ARN профиля приложения-вывода Amazon Bedrock или имя развёртывания Microsoft Foundry. Требует версию 2.1.218 или позже.

774. Уровень неизвестной модели \$5/\$25 за миллион входных/выходных токенов, поэтому ID, который счетчик не может определить, никогда не бывает бесплатным. Gateway предупреждает при загрузке и один раз за ID во время выполнения, когда использует этот уровень.774. Уровень неизвестной модели \$5/\$25 за миллион входных/выходных токенов, поэтому ID, который счётчик не может определить, никогда не бывает бесплатным. Шлюз предупреждает при загрузке и один раз за ID во время выполнения, когда использует этот уровень.

78 78

79Независимо от того, какой тариф применяется, счетчик затем умножает сумму на [`pricing.multiplier`](/docs/ru/claude-apps-gateway-config#pricing), по умолчанию `1`.79Независимо от того, какой тариф применяется, счётчик затем умножает сумму на [`pricing.multiplier`](/docs/ru/claude-apps-gateway-config#pricing), по умолчанию `1`.

80 80

81Прерывания клиента также учитываются. Когда поток заканчивается без финального кадра использования upstream, счетчик выставляет счет за оценку пола примерно четыре символа на выходной токен для текста, уже отправленного клиенту, поэтому прерывание запросов в начале не позволяет избежать лимита.81Прерывания клиентом также учитываются в счёте. Когда поток заканчивается без финального фрейма использования от upstream, счётчик выставляет счёт за минимальную оценку примерно четырёх символов на выходной токен для текста, уже отправленного клиенту, поэтому прерывание запросов на ранней стадии не позволяет избежать лимита.

82 82

83<h3 id="postgres-availability">83<h3 id="postgres-availability">

84 Доступность Postgres84 Доступность Postgres

85</h3>85</h3>

86 86

87Предварительная проверка запрашивает Postgres с двухсекундным тайм-аутом. Если хранилище недоступно или истекает время ожидания, соблюдение по умолчанию не срабатывает: запрос продолжается, gateway регистрирует предупреждение, и ответ не содержит заголовков `anthropic-ratelimit-unified-*`. Установите [`enforcement.fail_closed_on_error: true`](/docs/ru/claude-apps-gateway-config#enforcement), чтобы вместо этого не срабатывать закрыто, что возвращает то же самое `429 billing_error`, но с сообщением `spend limit unavailable` и без периода, времени сброса или заголовка `retry-after`. Отказ в открытом виде предотвращает превращение сбоя хранилища в сбой вывода; отказ в закрытом виде гарантирует отсутствие неучтенных расходов.87Предварительная проверка запрашивает Postgres с двухсекундным таймаутом. Если хранилище недоступно или истекает время ожидания, принудительное применение по умолчанию **открывается** (fail open): запрос продолжается, шлюз регистрирует предупреждение, и ответ не содержит заголовков `anthropic-ratelimit-unified-*`. Установите [`enforcement.fail_closed_on_error: true`](/docs/ru/claude-apps-gateway-config#enforcement) для **закрытия** (fail closed) вместо этого, что возвращает ту же `429 billing_error`, но с сообщением `spend limit unavailable` и без периода, времени сброса или заголовка `retry-after`. Открытое состояние (fail-open) предотвращает превращение сбоя хранилища в сбой вывода; закрытое состояние (fail-closed) гарантирует отсутствие неизмеренных расходов.

89Открытое состояние (fail-open) помогает только пока ваш балансировщик нагрузки или оркестратор всё ещё маршрутизирует трафик на шлюз. См. [Поведение при сбое](/docs/ru/claude-apps-gateway-deploy#outage-behavior) для `store.readiness_grace_seconds`, который держит реплики в прохождении проверки готовности через короткий сбой.

88 90

89<h3 id="usage-warnings-in-claude-code">91<h3 id="usage-warnings-in-claude-code">

90 Предупреждения об использовании в Claude Code92 Предупреждения об использовании в Claude Code

91</h3>93</h3>

92 94

93Claude Code предупреждает разработчика по мере приближения к его лимиту: один раз, когда использование превышает 75%, и снова, когда превышает 95% его наиболее потребляемого лимита. Когда gateway блокирует запрос, Claude Code показывает сообщение `429` gateway как есть, включая ваш `admin.blocked_message`.95Claude Code предупреждает разработчика по мере приближения к его лимиту: один раз, когда использование превышает 75%, и снова, когда превышает 95% его наиболее потребляемого лимита. Когда шлюз блокирует запрос, Claude Code показывает сообщение `429` шлюза как есть, включая ваш `admin.blocked_message`.

94 96

95Предупреждение работает на основе заголовков ответа:97Предупреждение работает на основе заголовков ответа:

96 98

97* С версией 2.1.225 или позже на сервере gateway каждый успешный ответ `/v1/messages` для разработчика, у которого есть лимит, содержит его собственное использование лимита и время сброса в заголовках `anthropic-ratelimit-unified-*`.99* С версией 2.1.225 или позже на сервере шлюза каждый успешный ответ `/v1/messages` для разработчика, у которого есть лимит, содержит его собственное использование лимита и время сброса в заголовках `anthropic-ratelimit-unified-*`.

98* С версией 2.1.225 или позже также на машине разработчика Claude Code читает заголовки и показывает предупреждение.100* С версией 2.1.225 или позже также на машине разработчика Claude Code читает заголовки и показывает предупреждение.

99 101

100Заголовки всегда описывают лимит самого разработчика: gateway удаляет заголовки ограничения скорости провайдера upstream, которые описывают вашу общую квоту, и никогда их не пересылает.102Заголовки всегда описывают лимит самого разработчика: шлюз удаляет заголовки ограничения скорости поставщика upstream, которые описывают вашу общую квоту, и никогда их не пересылает.

101 103

102С версией 2.1.251 или позже на машине разработчика Claude Code также читает те же заголовки для отображения полосы **Spend limit** в `/usage` с процентом использованного лимита и временем его сброса, а также для добавления объекта `rate_limits.spend_limit` в [строку статуса](/docs/ru/statusline#rate-limit-usage) ввода. Claude Code показывает оба как процент, а не как сумму в долларах, и не требует ничего новее, чем версия 2.1.225 на сервере gateway.104С версией 2.1.251 или позже на машине разработчика Claude Code также читает те же заголовки для отображения полосы **Spend limit** в `/usage`, с процентом использованного лимита и временем его сброса, и для добавления объекта `rate_limits.spend_limit` в [строку состояния](/docs/ru/statusline#rate-limit-usage) ввода. Claude Code показывает оба как процент, а не как сумму в долларах, и не требует ничего новее, чем версия 2.1.225 на сервере шлюза.

103 105

104<h2 id="admin-api-reference">106<h2 id="admin-api-reference">

105 Справочник Admin API107 Справочник Admin API

claude-code-on-the-web.md +10 −7

Details

4 4

5# Использование Claude Code в облаке5# Использование Claude Code в облаке

6 6

7> Запускайте сессии Claude Code в облаке из браузера, телефона, настольного приложения или терминала, перемещайте их с помощью --cloud и --teleport, а также автоматически исправляйте pull requests.7> Запускайте сессии Claude Code в облаке из браузера, телефона, настольного приложения или терминала, перемещайте их с помощью `--cloud` и `--teleport`, а также автоматически исправляйте pull requests.

8 8

9<Note>9<Note>

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

61 61

62Потоки в [проекте](/docs/ru/claude-projects) требуют установки приложения Claude GitHub на каждом репозитории, который они клонируют, независимо от того, каким методом вы подключились. См. [Set up GitHub access](/docs/ru/claude-projects#set-up-github-access).62Потоки в [проекте](/docs/ru/claude-projects) требуют установки приложения Claude GitHub на каждом репозитории, который они клонируют, независимо от того, каким методом вы подключились. См. [Set up GitHub access](/docs/ru/claude-projects#set-up-github-access).

63 63

64В среде, размещённой на серверах Anthropic, ваши учётные данные GitHub остаются зашифрованными на серверах Anthropic и никогда не попадают в виртуальную машину сессии. Операции GitHub из виртуальной машины проходят через [GitHub proxy](/docs/ru/cloud-environments#github-proxy), который прикрепляет учётные данные на стороне сервера.

64Для информации о том, как `/schedule` проверяет доступ к репозиторию перед созданием routine, см. [Repositories and branch permissions](/docs/ru/routines#repositories-and-branch-permissions). См. [Connect from your terminal](/docs/ru/web-quickstart#connect-from-your-terminal) для пошагового руководства `/web-setup`, включая то, что хранит `/web-setup` и как его удалить.66Для информации о том, как `/schedule` проверяет доступ к репозиторию перед созданием routine, см. [Repositories and branch permissions](/docs/ru/routines#repositories-and-branch-permissions). См. [Connect from your terminal](/docs/ru/web-quickstart#connect-from-your-terminal) для пошагового руководства `/web-setup`, включая то, что хранит `/web-setup` и как его удалить.

65 67

66Quick web setup — это параметр организации, который позволяет членам подключать GitHub с помощью `/web-setup`, пропускает запрос на установку Claude GitHub App во время веб-подключения в браузере и заставляет веб-подключение создать [**Default** окружение](/docs/ru/cloud-environments#the-default-environment) для них вместо отображения формы окружения. На планах Team и Enterprise он отключен по умолчанию, что скрывает `/web-setup`. [Owner](/docs/ru/server-managed-settings#access-control) включает его с помощью переключателя **Quick web setup** в [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code).68Quick web setup — это параметр организации, который позволяет членам подключать GitHub с помощью `/web-setup`, пропускает запрос на установку Claude GitHub App во время веб-подключения в браузере и заставляет веб-подключение создать [**Default** окружение](/docs/ru/cloud-environments#the-default-environment) для них вместо отображения формы окружения. На планах Team и Enterprise он отключен по умолчанию, что скрывает `/web-setup`. [Owner](/docs/ru/server-managed-settings#access-control) включает его с помощью переключателя **Quick web setup** в [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code).

135 137

136Когда вы запускаете `claude --cloud` из репозитория, который не имеет git remote, или из репозитория github.com, на котором Claude GitHub App не установлено, Claude Code упаковывает ваш локальный репозиторий и загружает его непосредственно в облачную сессию. Это применяется даже если вы подключили GitHub с помощью `/web-setup`. Пакет включает вашу полную историю репозитория во всех ветках, плюс незафиксированные изменения отслеживаемых файлов.138Когда вы запускаете `claude --cloud` из репозитория, который не имеет git remote, или из репозитория github.com, на котором Claude GitHub App не установлено, Claude Code упаковывает ваш локальный репозиторий и загружает его непосредственно в облачную сессию. Это применяется даже если вы подключили GitHub с помощью `/web-setup`. Пакет включает вашу полную историю репозитория во всех ветках, плюс незафиксированные изменения отслеживаемых файлов.

137 139

138На macOS, Linux и WSL Claude Code исключает незафиксированные изменения файлов, названных как учётные данные или ключи, из загрузки и называет файлы, которые он исключил. Это охватывает файлы `.env`, Terraform файлы `*.tfvars` и файлы ключей, такие как `id_rsa` и `*.pem`. Сессия начинается с зафиксированной версии каждого, или без файла, если ничего не зафиксировано. В связанном worktree, подмодуле или аналогичной раскладке Claude Code загружает эти изменения с остальным и называет файлы, которые он загружает.140На macOS, Linux и WSL Claude Code исключает незафиксированные изменения файлов, названных как учётные данные или ключи, из загрузки и называет файлы, которые он исключил. Это охватывает файлы `.env`, Terraform файлы `*.tfvars` и файлы ключей, такие как `id_rsa` и `*.pem`. Сессия начинается с зафиксированной версии каждого, или без файла, если ничего не зафиксировано.

139 141

140Чтобы загрузить пакет даже когда Claude Code иначе клонировал бы с удалённого сервера, установите `CCR_FORCE_BUNDLE=1`:142Чтобы загрузить пакет даже когда Claude Code иначе клонировал бы с удалённого сервера, установите `CCR_FORCE_BUNDLE=1`:

141 143

426 Ограничения428 Ограничения

427</h2>429</h2>

428 430

429Перед тем как полагаться на облачные сессии для рабочего процесса, учтите эти ограничения:431Перед использованием облачных сеансов в рабочем процессе учитывайте следующие ограничения:

430 432

431* **Ограничения скорости**: облачные сессии делят ограничения скорости со всеми другими использованиями Claude и Claude Code в вашем аккаунте. Запуск нескольких задач параллельно потребляет больше ограничений скорости пропорционально. Нет отдельной платы за вычисления для облачной виртуальной машины.433* **Ограничения частоты запросов**: облачные сеансы используют общие ограничения частоты запросов со всеми остальными использованиями Claude и Claude Code в вашей учётной записи. Запуск нескольких задач параллельно потребляет больше ограничений частоты запросов пропорционально. Отдельной платы за вычисления на облачной виртуальной машине нет.

432* **Аутентификация репозитория**: вы можете перемещать облачную сессию в ваш терминал только когда вы аутентифицированы на одном и том же аккаунте434* **Ограничения по времени**: команды, которые запускает Claude, и hooks SessionStart имеют стандартные тайм-ауты, которые вы можете изменить, а скрипт настройки кэшируется только при завершении примерно за пять минут. См. [Time limits](/docs/ru/cloud-environments#time-limits)

433* **Ограничения платформы**: клонирование репозитория и создание pull request требуют GitHub. Самостоятельно размещённые экземпляры [GitHub Enterprise Server](/docs/ru/github-enterprise-server) поддерживаются для планов Team и Enterprise. Вы можете отправить репозиторий GitLab, Bitbucket или другой не-GitHub репозиторий в облачную сессию как [локальный пакет](#send-local-repositories-without-github), установив `CCR_FORCE_BUNDLE=1`, но сессия не может отправлять результаты обратно на удалённый сервер435* **Аутентификация репозитория**: вы можете извлечь облачный сеанс в свой терминал только при аутентификации в одной и той же учётной записи

434* **Список разрешений IP организации**: облачные сессии вызывают API Anthropic из инфраструктуры, управляемой Anthropic, а не из вашей сети, пока сессии в [самостоятельно размещённом окружении](/docs/ru/self-hosted-environments) вызывают его из вашей собственной сети. Если ваша организация имеет [IP allowlisting](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) включённый, каждая облачная сессия, размещённая Anthropic, не пройдёт с ошибкой аутентификации. То же самое применяется к [Code Review](/docs/ru/code-review) и к [routines](/docs/ru/routines), которые запускаются на окружениях, размещённых Anthropic; routine, маршрутизированная в самостоятельно размещённое окружение, вызывает API из вашей собственной сети. Свяжитесь с [поддержкой Anthropic](https://support.claude.com/), чтобы список разрешений IP вашей организации не распространялся на размещённые Anthropic сервисы.436* **Ограничения платформы**: клонирование репозитория и создание запросов на слияние требуют GitHub. Экземпляры [GitHub Enterprise Server](/docs/ru/github-enterprise-server) с собственным размещением поддерживаются для планов Team и Enterprise. Вы можете отправить репозиторий GitLab, Bitbucket или другой репозиторий, не являющийся GitHub, в облачный сеанс как [локальный пакет](#send-local-repositories-without-github), установив `CCR_FORCE_BUNDLE=1`, но сеанс не сможет отправить результаты обратно на этот удалённый сервер

437* **Список разрешённых IP-адресов организации**: облачные сеансы вызывают API Anthropic из инфраструктуры, управляемой Anthropic, а не из вашей сети, в то время как сеансы в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments) вызывают его из вашей собственной сети. Если в вашей организации включена [фильтрация по IP-адресам](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting), каждый облачный сеанс, размещённый в Anthropic, завершится ошибкой аутентификации. То же самое применяется к [Code Review](/docs/ru/code-review) и к [routines](/docs/ru/routines), которые выполняются в размещённых в Anthropic средах; routine, маршрутизированная в самостоятельно размещённую среду, вызывает API из вашей собственной сети. Обратитесь в [службу поддержки Anthropic](https://support.claude.com/), чтобы исключить размещённые в Anthropic сервисы из списка разрешённых IP-адресов вашей организации.

435 438

436<h2 id="related-resources">439<h2 id="related-resources">

437 Связанные ресурсы440 Связанные ресурсы

claude-directory.md +75 −53

Details

1541 Данные приложения1541 Данные приложения

1542</h2>1542</h2>

1543 1543

1544Помимо конфигурации, которую вы создаёте, `~/.claude` содержит данные, которые Claude Code записывает во время сеансов. Эти файлы — простой текст. Всё, что проходит через инструмент, попадает в стенограмму на диск: содержимое файлов, вывод команд, вставленный текст.1544Помимо конфигурации, которую вы создаёте, `~/.claude` содержит данные, которые Claude Code записывает во время сеансов. Эти файлы представляют собой простой текст. Всё, что проходит через инструмент, записывается в транскрипт на диск: содержимое файлов, вывод команд, вставленный текст.

1545 1545

1546<h3 id="cleaned-up-automatically">1546<h3 id="cleaned-up-automatically">

1547 Автоматически очищается1547 Автоматически удаляется

1548</h3>1548</h3>

1549 1549

1550Claude Code удаляет файлы в путях ниже, как только им исполняется больше [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), при условии, что он может безопасно определить период хранения. По умолчанию это 30 дней, минимум — 1; установка `0` приводит к ошибке валидации. Тот же возрастной порог применяется к автоматическому удалению [orphaned worktrees](/docs/ru/worktrees#clean-up-subagent-and-background-session-worktrees).1550Claude Code удаляет файлы в путях ниже, как только они становятся старше [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), при условии, что он может безопасно определить период хранения. По умолчанию это 30 дней, минимум — 1 день; установка `0` приводит к ошибке валидации. Тот же порог возраста применяется к автоматическому удалению [orphaned worktrees](/docs/ru/worktrees#clean-up-subagent-and-background-session-worktrees).

1551 1551

1553| - | - |1553| - | - |

1554| `projects/<project>/<session>.jsonl` | Полная стенограмма разговора: каждое сообщение, вызов инструмента и результат инструмента |1554| `projects/<project>/<session>.jsonl` | Полный транскрипт беседы: каждое сообщение, вызов инструмента и результат инструмента |

1555| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>` | Предыдущая стенограмма для сеанса, которую Claude Code отложил вместо перезаписи или удаления. Она не появляется в средстве выбора сеансов |1555| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>` | Предыдущий транскрипт сеанса, который Claude Code отложил вместо перезаписи или удаления. Он не отображается в средстве выбора сеанса |

1556| `projects/<project>/<session>/subagents/` | Стенограммы разговоров [Subagent](/docs/ru/sub-agents), удаляемые вместе со стенограммой родительского сеанса, когда она устаревает |1556| `projects/<project>/<session>/subagents/` | Транскрипты беседы [Subagent](/docs/ru/sub-agents), удаляются вместе с транскриптом родительского сеанса при его устаревании |

1557| `projects/<project>/<session>/tool-results/` | Большие выходные данные инструмента разлиты в отдельные файлы |1557| `projects/<project>/<session>/tool-results/` | Большие выходные данные инструментов, разделённые на отдельные файлы, и полноразмерные копии [изображений, возвращаемых инструментами MCP](/docs/ru/mcp#images-in-tool-results) |

1558| `file-history/<session>/` | Снимки файлов перед редактированием, которые Claude изменил, используемые для [восстановления checkpoint](/docs/ru/checkpointing). Содержит снимки для 100 самых последних контрольных точек; файлы снимков, на которые не ссылается ни один сохранённый checkpoint, удаляются, за исключением первого снимка каждого файла |1558| `file-history/<session>/` | Снимки файлов до редактирования, которые изменил Claude, используются для [восстановления контрольной точки](/docs/ru/checkpointing). Содержит снимки для 100 самых последних контрольных точек; файлы снимков, на которые не ссылается ни одна сохранённая контрольная точка, удаляются, за исключением первого снимка каждого файла |

1559| `plans/` | Файлы плана, написанные во время [plan mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) |1559| `plans/` | Файлы плана, написанные во время [режима плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) |

1560| `debug/` | Журналы отладки для каждого сеанса, написанные при включённом логировании отладки, например при запуске с [`--debug`](/docs/ru/cli-reference#cli-flags) или запуске `/debug` |1560| `debug/` | Журналы отладки для каждого сеанса, записываются при включённой отладке, например при запуске с [`--debug`](/docs/ru/cli-reference#cli-flags) или выполнении `/debug` |

1562| `image-cache/<session>/` | Прикреплённые изображения, сохранённые Claude Code v2.1.274 и более ранними версиями. Более поздние версии сохраняют вставленные и прикреплённые изображения вне `~/.claude`, в директории `images/` для каждого сеанса в временной директории, которую контролирует [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars). Очистка удаляет оставшиеся директории других сеансов здесь, независимо от их возраста. |1562| `image-cache/<session>/` | Прикреплённые изображения, сохранённые Claude Code v2.1.274 и более ранними версиями. Более поздние версии сохраняют вставленные и прикреплённые изображения вне `~/.claude`, в каталоге `images/` для каждого сеанса в временном каталоге, который контролирует [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars). Очистка удаляет оставшиеся каталоги других сеансов здесь, независимо от их возраста. |

1563| `uploads/<session>/` | Файлы, которые вы прикрепляете из веб-приложения или мобильного приложения, и фотографии, которые вы прикрепляете из мобильного приложения, при отправке сообщения в сеанс [Remote Control](/docs/ru/remote-control). Вложение в [облачный сеанс](/docs/ru/claude-code-on-the-web) сохраняется в собственной облачной среде этого сеанса, а не на вашей машине. |1563| `uploads/<session>/` | Файлы, которые вы прикрепляете из веб-приложения или мобильного приложения, и фотографии, которые вы прикрепляете из мобильного приложения, при отправке сообщения в сеанс [Remote Control](/docs/ru/remote-control). Вложение в [облачный сеанс](/docs/ru/claude-code-on-the-web) сохраняется в собственной облачной среде этого сеанса, а не на вашей машине. |

1566| `shell-snapshots/` | Псевдонимы, функции и параметры оболочки, захваченные при запуске и применяемые инструментом [Bash](/docs/ru/tools-reference#bash-tool-behavior) к каждой команде. Удаляется при чистом выходе. Очистка удаляет любые оставшиеся после сбоя. |1566| `shell-snapshots/` | Псевдонимы, функции и параметры оболочки, захваченные при запуске и применяемые [инструментом Bash](/docs/ru/tools-reference#bash-tool-behavior) к каждой команде. Удаляются при корректном выходе. Очистка удаляет оставшиеся после сбоя. |

1567| `backups/` | Более ранние версии `~/.claude.json`, скопированные при переписывании файла Claude Code. Claude Code сохраняет пять самых новых, плюс копию любой версии, которую он не смог разобрать. |1567| `backups/` | Более ранние версии `~/.claude.json`, скопированные при перезаписи файла Claude Code. Claude Code сохраняет пять самых новых, плюс копию любой версии, которую он не смог разобрать. |

1568| `feedback-bundles/` | Отредактированные архивы стенограмм, написанные `/feedback` на сторонних поставщиков или когда не настроены учётные данные Anthropic, для отправки команде вашего аккаунта Anthropic |1568| `feedback-bundles/` | Отредактированные архивы транскриптов, написанные `/feedback` на сторонних поставщиках или когда учётные данные Anthropic не настроены, для отправки команде вашего аккаунта Anthropic |

1569| `feedback/drafts/` | Очередь [Claude-drafted feedback](/docs/ru/tools-reference#sendfeedback-tool-behavior), ожидающая вашего рассмотрения в `/feedback`. Очищается после `cleanupPeriodDays` или 30 дней, в зависимости от того, что меньше. Когда очередь достигает лимита в 10 черновиков, Claude Code удаляет самый старый черновик, чтобы освободить место. |1569| `feedback/drafts/` | Очередь [составленного Claude отзыва](/docs/ru/tools-reference#sendfeedback-tool-behavior), ожидающего вашего рассмотрения в `/feedback`. Очищается после `cleanupPeriodDays` или 30 дней, в зависимости от того, что меньше. Когда очередь достигает лимита в 10 черновиков, Claude Code удаляет самый старый черновик, чтобы освободить место. |

1570| `usage-data/` | `report.html` и копии отчётов с временными метками, написанные [`/insights`](/docs/ru/costs#analyze-your-usage-patterns), плюс кэшированные данные анализа для каждого сеанса, используемые для их построения |1570| `usage-data/` | `report.html` и копии отчётов с временными метками, написанные [`/insights`](/docs/ru/costs#analyze-your-usage-patterns), плюс кэшированные данные анализа для каждого сеанса, используемые для их построения |

1571| `skills/.trash/`, `plugins/.trash/` | [Skills](/docs/ru/skills#how-synced-skills-behave) и [plugins](/docs/ru/plugins/loading#synced-plugins), которые синхронизация claude.ai удалила, например после отключения одного на claude.ai или остановки синхронизации. Файлы остаются здесь, чтобы вы могли их восстановить, пока очистка их не удалит |1571| `skills/.trash/`, `plugins/.trash/` | [Skills](/docs/ru/skills#how-synced-skills-behave) и [plugins](/docs/ru/plugins/loading#synced-plugins), которые синхронизация claude.ai удалила, например после отключения одного на claude.ai или остановки синхронизации. Файлы остаются здесь, чтобы вы могли их восстановить, пока очистка их не удалит |

1572| `todos/`, `statsig/`, `logs/` | Устаревшие директории из более старых версий. Больше не записываются. Очистка удаляет их содержимое, а затем пустую директорию. |1572| `todos/`, `statsig/`, `logs/` | Устаревшие каталоги из более старых версий. Больше не записываются. Очистка удаляет их содержимое, а затем пустой каталог. |

1573 1573

1574Файлы сеансов в `sessions/`, автоматическая память и стенограммы Claude Desktop и Cowork следуют своим собственным правилам хранения:1574Файлы сеанса в `sessions/`, автоматическая память, а также транскрипты Claude Desktop и Cowork следуют своим собственным правилам хранения:

1575 1575

1576* **`sessions/`**: содержит один небольшой файл на запущенный сеанс, используемый для обнаружения одновременных сеансов и сбоев. Это не часть очистки на основе возраста: Claude Code удаляет каждый файл при выходе из сеанса и очищает остатки сбоев при следующем запуске.1576* **`sessions/`**: содержит один небольшой файл на работающий сеанс, используется для обнаружения одновременных сеансов и сбоев. Это не часть очистки на основе возраста: Claude Code удаляет каждый файл при выходе из сеанса и очищает остатки сбоев при следующем запуске.

1577* **Автоматическая память**: очистка не удаляет файлы памяти в директории [автоматической памяти](/docs/ru/memory#auto-memory) проекта, `projects/<project>/memory/`. Claude Code удаляет эту директорию только если она была пуста в течение всего периода хранения. До версии 2.1.228 очистка рассматривала папки внутри директории памяти как данные сеанса и могла удалять старые файлы под ней.1577* **Автоматическая память**: очистка не удаляет файлы памяти в каталоге [автоматической памяти](/docs/ru/memory#auto-memory) проекта, `projects/<project>/memory/`. Claude Code удаляет этот каталог только если он был пуст в течение всего периода хранения. До версии v2.1.228 очистка рассматривала папки внутри каталога памяти как данные сеанса и могла удалять старые файлы под ними.

1578* **Стенограммы Claude Desktop и Cowork**: Claude Code сохраняет стенограмму сеанса, который вы запустили или последний раз продолжили в Claude Desktop или Cowork, в любом возрасте. Чтобы установить возрастной лимит для этих стенограмм, установите [`desktopSessionCleanupPeriodDays`](/docs/ru/settings-reference#desktopsessioncleanupperioddays). Когда [управляемые параметры](/docs/ru/managed-settings) устанавливают `cleanupPeriodDays`, Claude Code удаляет эти стенограммы после этого периода. Требует Claude Code v2.1.248 или более позднюю версию; более ранние версии удаляют их после `cleanupPeriodDays`.1578* **Транскрипты Claude Desktop и Cowork**: Claude Code сохраняет транскрипт сеанса, который вы запустили или последний раз продолжили в Claude Desktop или Cowork, в любом возрасте. Чтобы установить ограничение по возрасту для этих транскриптов, установите [`desktopSessionCleanupPeriodDays`](/docs/ru/settings-reference#desktopsessioncleanupperioddays). Когда [управляемые параметры](/docs/ru/managed-settings) устанавливают `cleanupPeriodDays`, Claude Code удаляет эти транскрипты после этого периода. Требуется Claude Code v2.1.248 или позже; более ранние версии удаляют их после `cleanupPeriodDays`.

1579 1579

1580Claude Code пропускает очистку полностью в этих случаях:1580Claude Code пропускает очистку на основе возраста в этих случаях:

1581 1581

1582* **Bare mode**: когда вы запускаете `claude -p` с [`--bare`](/docs/ru/headless#start-faster-with-bare-mode), Claude Code не запускает очистку в этом сеансе.1582* **Bare mode**: когда вы запускаете `claude -p` с [`--bare`](/docs/ru/headless#start-faster-with-bare-mode), Claude Code не запускает очистку в этом сеансе.

1583* **Paused sweep**: если Claude Code не может безопасно определить период хранения, он приостанавливает очистку хранения; событие [`retention_sweep`](/docs/ru/monitoring-usage#retention-sweep-event) перечисляет каждую конфигурацию, которая его приостанавливает. Когда причина — файл параметров, который не может быть прочитан или разобран, или ошибки параметров с явно установленными `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays`, Claude Code также показывает предупреждение в `/status` до тех пор, пока вы не исправите ошибки параметров. Когда [управляемые параметры](/docs/ru/server-managed-settings) предоставляют `cleanupPeriodDays`, Claude Code запускает очистку при управляемом значении в любом случае.1583* **Paused sweep**: если Claude Code не может безопасно определить период хранения, он приостанавливает очистку хранения; событие [`retention_sweep`](/docs/ru/monitoring-usage#retention-sweep-event) перечисляет каждую конфигурацию, которая её приостанавливает. Когда причина — файл параметров, который не может быть прочитан или разобран, или ошибки параметров с явно установленными `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays`, Claude Code также показывает предупреждение в `/status` до тех пор, пока вы не исправите ошибки параметров. Когда [управляемые параметры](/docs/ru/server-managed-settings) предоставляют `cleanupPeriodDays`, Claude Code запускает очистку с управляемым значением в любом случае.

1584

1585<h3 id="session-scratchpad-directory">

1586 Каталог временной памяти сеанса

1587</h3>

1588

1589Временная память — это каталог для каждого сеанса, который Claude Code предоставляет Claude для временных файлов: промежуточные результаты, вспомогательные скрипты и черновики, которые не принадлежат вашему проекту. Когда Claude говорит, что он сохранил что-то «в временную память», файл находится там. Claude использует его вместо `/tmp` и может создавать, редактировать и читать файлы в нём без запроса разрешения.

1590

1591Временная память находится в временном каталоге Claude Code, а не в `~/.claude`. Найдите путь текущего сеанса для вашей платформы:

1592

1593* **macOS**: `/private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`

1594* **Linux**: `/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`, или той же формы под `$TMPDIR`, когда ваша система её устанавливает

1595* **Windows**: `%TEMP%\claude\<project>\<session-id>\scratchpad\`

1596

1597`<project>` — это путь вашего рабочего каталога со всеми символами, кроме букв и цифр, заменёнными на `-`, например `-Users-you-my-project`. Если вы установите [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars), дерево переместится в этот каталог. Hooks получают путь текущего сеанса как [`scratchpad_dir`](/docs/ru/hooks#common-input-fields).

1598

1599Файлы временной памяти существуют столько же, сколько транскрипт сеанса: [очистка хранения](#cleaned-up-automatically) удаляет каталог при удалении транскрипта, и [`claude project purge`](#clear-local-data) не трогает временный каталог. Поскольку каталог находится в системном временном расположении, ваша операционная система также может его очистить, например при перезагрузке. Чтобы сохранить что-то, что Claude написал там, попросите Claude переместить это в ваш проект.

1600

1601Сеанс имеет временную память только когда выполняются все эти условия:

1602

1603* Вы вошли с учётной записью claude.ai, а не с ключом API

1604* Сеанс использует Anthropic API, а не Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry

1605* [`enableArtifact`](/docs/ru/settings-reference#enableartifact) не установлен на `false`

1584 1606

1585<h3 id="kept-until-you-delete-them">1607<h3 id="kept-until-you-delete-them">

1586 Сохраняется до удаления вами1608 Сохраняется до удаления вручную

1587</h3>1609</h3>

1588 1610

1589Очистка хранения не удаляет пути ниже. Claude Code сохраняет их до удаления вами, за исключением двух кэшей, которые он удаляет при выходе.1611Очистка хранения не удаляет пути ниже. Claude Code сохраняет их до удаления вручную, за исключением двух кэшей, которые он удаляет при выходе.

1590 1612

1592| - | - |1614| - | - |

1593| `history.jsonl` | Каждая подсказка, которую вы ввели, с временной меткой и путём проекта. Используется для отзыва стрелки вверх, поиска истории `Ctrl+R` и завершения команды оболочки `!`. |1615| `history.jsonl` | Каждый запрос, который вы ввели, с временной меткой и путём проекта. Используется для вызова стрелкой вверх, поиска истории `Ctrl+R` и завершения команды оболочки `!`. |

1595| `remote-settings.json` | Кэшированная копия [управляемых сервером параметров](/docs/ru/server-managed-settings) для вашей организации, или `{}` когда ваша организация не настроила никаких. Присутствует только когда сеанс [их загружает](/docs/ru/server-managed-settings#platform-availability). Claude Code проверяет обновления при запуске и ежечасно во время сеанса. Claude Code удаляет его при выходе. |1617| `remote-settings.json` | Кэшированная копия [управляемых параметров сервера](/docs/ru/server-managed-settings) для вашей организации, или `{}`, когда ваша организация не настроила никаких. Присутствует только когда сеанс их [получает](/docs/ru/server-managed-settings#platform-availability). Claude Code проверяет обновления при запуске и ежечасно во время сеанса. Claude Code удаляет его при выходе. |

1596| `cache/changelog.md` | Кэшированная копия журнала изменений Claude Code, показанная `/release-notes`. Обновляется в фоне. |1618| `cache/changelog.md` | Кэшированная копия журнала изменений Claude Code, показанная `/release-notes`. Обновляется в фоне. |

1597| `policy-limits.json` | Кэшированные параметры политики функций для вашей организации. Присутствует только для некоторых типов аккаунтов. Обновляется автоматически. Файл `policy-limits.json.stamp.json` сидекар записывает, какому аккаунту или API ключу принадлежит кэш. Claude Code удаляет оба файла при выходе. |1619| `policy-limits.json` | Кэшированные параметры политики функций для вашей организации. Присутствует только для некоторых типов аккаунтов. Обновляется автоматически. Файл `policy-limits.json.stamp.json` записывает, какому аккаунту или ключу API принадлежит кэш. Claude Code удаляет оба файла при выходе. |

1598 1620

1599<span id="state-files-to-keep" />1621<span id="state-files-to-keep" />

1600 1622

1601Другие файлы появляются в зависимости от того, какие функции вы используете. Кэши и файлы блокировок безопасны для удаления. Сохраняйте эти файлы состояния:1623Другие файлы появляются в зависимости от того, какие функции вы используете. Кэши и файлы блокировки безопасно удалять. Сохраняйте эти файлы состояния:

1602 1624

1603* `.credentials.json`: ваши [учётные данные входа](/docs/ru/authentication#credential-management)1625* `.credentials.json`: ваши [учётные данные входа](/docs/ru/authentication#credential-management)

1604* `agent-memory/`: [память subagent](/docs/ru/sub-agents#enable-persistent-memory)1626* `agent-memory/`: [память subagent](/docs/ru/sub-agents#enable-persistent-memory)

1605* `jobs/` и `daemon/`: состояние [фонового сеанса](/docs/ru/agent-view#where-state-is-stored)1627* `jobs/` и `daemon/`: состояние [фонового сеанса](/docs/ru/agent-view#where-state-is-stored)

1606 1628

1607<h3 id="plaintext-storage">1629<h3 id="plaintext-storage">

1608 Хранилище простого текста1630 Хранение в виде простого текста

1609</h3>1631</h3>

1610 1632

1611Стенограммы и история не зашифрованы в покое. Разрешения файлов ОС — единственная защита. Если инструмент читает файл `.env` или команда выводит учётные данные, это значение записывается в `projects/<project>/<session>.jsonl`. Чтобы снизить риск:1633Транскрипты и история не зашифрованы в покое. Разрешения файлов ОС — единственная защита. Если инструмент читает файл `.env` или команда выводит учётные данные, это значение записывается в `projects/<project>/<session>.jsonl`. Чтобы снизить риск:

1612 1634

1613* Снизьте `cleanupPeriodDays`, чтобы сократить время хранения стенограмм Claude Code1635* Уменьшите `cleanupPeriodDays`, чтобы сократить время хранения транскриптов Claude Code

1614* Установите [`desktopSessionCleanupPeriodDays`](/docs/ru/settings-reference#desktopsessioncleanupperioddays), чтобы установить возрастной лимит для стенограмм Claude Desktop и Cowork1636* Установите [`desktopSessionCleanupPeriodDays`](/docs/ru/settings-reference#desktopsessioncleanupperioddays), чтобы установить ограничение по возрасту для транскриптов Claude Desktop и Cowork

1615* Установите переменную окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars), чтобы пропустить запись стенограмм и истории подсказок в любом режиме. В неинтерактивном режиме вы можете вместо этого передать `--no-session-persistence` вместе с `-p`, или установить `persistSession: false` в TypeScript Agent SDK; Python SDK не имеет эквивалентной опции.1637* Установите переменную окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars), чтобы пропустить запись транскриптов и истории запросов в любом режиме. В неинтерактивном режиме вы можете вместо этого передать `--no-session-persistence` вместе с `-p`, или установить `persistSession: false` в TypeScript Agent SDK; Python SDK не имеет эквивалентного параметра.

1616* Используйте [правила разрешений](/docs/ru/permissions) для запрета чтения файлов учётных данных1638* Используйте [правила разрешений](/docs/ru/permissions) для запрета чтения файлов учётных данных

1617 1639

1618<h3 id="clear-local-data">1640<h3 id="clear-local-data">

1619 Очистить локальные данные1641 Очистить локальные данные

1620</h3>1642</h3>

1621 1643

1622Запустите `claude project purge`, чтобы удалить состояние, которое Claude Code хранит для одного проекта. Это удаляет:1644Запустите `claude project purge`, чтобы удалить состояние, которое Claude Code хранит для одного проекта. Он удаляет:

1623 1645

1624* Стенограммы и автоматическую память под `projects/`1646* Транскрипты и автоматическую память в `projects/`

1625* Записи `tasks/`, `debug/` и `file-history/` для каждого сеанса1647* Записи `tasks/`, `debug/` и `file-history/` для каждого сеанса

1626* Соответствующие строки подсказок в `history.jsonl`1648* Совпадающие строки запросов в `history.jsonl`

1627* Запись проекта в `~/.claude.json`1649* Запись проекта в `~/.claude.json`

1628 1650

1629Изображения, которые вы вставили или прикрепили в сеансах проекта, хранятся в временной директории Claude Code, а не в `~/.claude`, поэтому очистка их не удаляет. [Очистка хранения](#cleaned-up-automatically) удаляет их, как только они становятся старше `cleanupPeriodDays`.1651Изображения, которые вы вставили или прикрепили в сеансах проекта, и [временная память](#session-scratchpad-directory) каждого сеанса хранятся в временном каталоге Claude Code, а не в `~/.claude`, поэтому очистка их не удаляет. [Очистка хранения](#cleaned-up-automatically) всё ещё удаляет изображения, как только они становятся старше `cleanupPeriodDays`; временная память очищенного сеанса остаётся до удаления вручную или пока ваша операционная система не очистит временный каталог.

1630 1652

1631Команда выводит полный план удаления и запрашивает подтверждение перед удалением чего-либо.1653Команда выводит полный план удаления и запрашивает подтверждение перед удалением чего-либо.

1632 1654

1633Примеры ниже используют `~/work/my-repo` как заполнитель. Замените его на путь к вашему проекту. Если никакое состояние не соответствует пути, команда выводит ошибку и выходит со статусом 1.1655Примеры ниже используют `~/work/my-repo` в качестве заполнителя. Замените его на путь к вашему проекту. Если состояние не совпадает с путём, команда выводит ошибку и выходит со статусом 1.

1634 1656

1635Просмотрите план без удаления чего-либо:1657Просмотрите план без удаления:

1636 1658

1637```bash theme={null}1659```bash theme={null}

1638claude project purge ~/work/my-repo --dry-run1660claude project purge ~/work/my-repo --dry-run

1639```1661```

1640 1662

1641План перечисляет каждый соответствующий элемент и причину его включения:1663План перечисляет каждый совпадающий элемент и причину его включения:

1642 1664

1643```text theme={null}1665```text theme={null}

1644Purge plan for /home/user/work/my-repo:1666Purge plan for /home/user/work/my-repo:

1675 1697

1676Команда оставляет `shell-snapshots/` и `backups/` в покое, потому что они не ограничены проектом, и предупреждает о них в выводе плана.1698Команда оставляет `shell-snapshots/` и `backups/` в покое, потому что они не ограничены проектом, и предупреждает о них в выводе плана.

1677 1699

1678Вы также можете удалить любой из путей данных приложения выше вручную, за исключением [файлов состояния для сохранения](#state-files-to-keep). Новые сеансы не затронуты. Таблица ниже показывает, что вы потеряете для прошлых сеансов.1700Вы также можете удалить любой из путей данных приложения выше вручную, за исключением [файлов состояния для сохранения](#state-files-to-keep). Новые сеансы не затронуты. Таблица ниже показывает, что вы теряете для прошлых сеансов.

1679 1701

1680| Удалить | Вы потеряете |1702| Удалить | Вы теряете |

1681| - | - |1703| - | - |

1682| `~/.claude/projects/` | Возобновление, продолжение и перемотка для прошлых сеансов, и автоматическую память для каждого проекта |1704| `~/.claude/projects/` | Возобновление, продолжение и перемотка для прошлых сеансов, и автоматическая память для каждого проекта |

1684| `~/.claude/paste-cache/` | Вставленный текст в вспомненных подсказках; см. [вставка большого содержимого](/docs/ru/terminal-config#paste-large-content) |1706| `~/.claude/paste-cache/` | Вставленный текст в вызванных запросах; см. [вставка большого содержимого](/docs/ru/terminal-config#paste-large-content) |

1685| `~/.claude/uploads/` | Вложения, на которые ссылаются прошлые сеансы [Remote Control](/docs/ru/remote-control) по пути |1707| `~/.claude/uploads/` | Вложения, на которые ссылаются прошлые сеансы [Remote Control](/docs/ru/remote-control) по пути |

1688| `~/.claude/usage-data/` | Прошлые отчёты [`/insights`](/docs/ru/costs#analyze-your-usage-patterns) и кэшированные данные анализа, используемые для их построения |1710| `~/.claude/usage-data/` | Прошлые отчёты [`/insights`](/docs/ru/costs#analyze-your-usage-patterns) и кэшированные данные анализа, используемые для их построения |

1689| `~/.claude/feedback-bundles/` | Отзывы и архивы отчётов об ошибках, которые вы ещё не отправили команде вашего аккаунта Anthropic |1711| `~/.claude/feedback-bundles/` | Отзывы и архивы отчётов об ошибках, которые вы ещё не отправили команде вашего аккаунта Anthropic |

1690| `~/.claude/feedback/drafts/` | [Claude-drafted feedback](/docs/ru/tools-reference#sendfeedback-tool-behavior), которые вы не отправили |1712| `~/.claude/feedback/drafts/` | [Составленный Claude отзыв](/docs/ru/tools-reference#sendfeedback-tool-behavior), который вы не отправили |

1695| `~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/` | Возможность восстановления [синхронизированных skills](/docs/ru/skills#how-synced-skills-behave) и [синхронизированных plugins](/docs/ru/plugins/loading#synced-plugins), которые Claude Code удалил |1717| `~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/` | Возможность восстановления [синхронизированных skills](/docs/ru/skills#how-synced-skills-behave) и [синхронизированных plugins](/docs/ru/plugins/loading#synced-plugins), которые Claude Code удалил |

1696| `~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/` | Ничего, видимого пользователю |1718| `~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/` | Ничего видимого пользователю |

1697| `~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/`, `~/.claude/image-cache/` | Ничего. Устаревшие директории, не записываемые текущими версиями. |1719| `~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/`, `~/.claude/image-cache/` | Ничего. Устаревшие каталоги, не записываемые текущими версиями. |

1698 1720

1699Не удаляйте `~/.claude.json`, `~/.claude/settings.json` или `~/.claude/plugins/`: они содержат вашу аутентификацию, предпочтения и установленные plugins.1721Не удаляйте `~/.claude.json`, `~/.claude/settings.json` или `~/.claude/plugins/`: они содержат вашу аутентификацию, предпочтения и установленные plugins.

1700 1722

claude-projects.md +50 −8

Details

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

8 8

9<Note>9<Note>

10 Projects находятся в публичной бета-версии на планах Pro и Max и постепенно развертываются, начиная с аккаунтов, которые использовали [облачные сеансы](/docs/ru/claude-code-on-the-web) и не имеют существующих проектов в claude.ai chat или Cowork. Они еще недоступны на планах Team и Enterprise. Если **Projects** не отображается на боковой панели в [claude.ai/code](https://claude.ai/code) или на вкладке Code [настольного приложения](/docs/ru/desktop), развертывание еще не достигло вашего аккаунта, и вы можете [присоединиться к списку ожидания](https://claude.com/form/projects). [Запуск агентов параллельно](/docs/ru/agents) содержит список того, что вы можете использовать в то время.10 Projects находятся в публичной бета-версии на планах Pro и Max и постепенно развертываются, начиная с аккаунтов, которые использовали [облачные сеансы](/docs/ru/claude-code-on-the-web) и не имеют существующих проектов в чате claude.ai или Cowork. Они еще недоступны на планах Team и Enterprise. Если **Projects** не отображается на боковой панели на [claude.ai/code](https://claude.ai/code) или на вкладке Code [настольного приложения](/docs/ru/desktop), развертывание еще не достигло вашего аккаунта, и вы можете [присоединиться к списку ожидания](https://claude.com/form/projects). [Запуск агентов параллельно](/docs/ru/agents) содержит список того, что вы можете использовать в то время.

11</Note>11</Note>

12 12

13Project — это один текущий разговор, в котором Claude координирует поток связанной работы для вас. Вы говорите ему, что нужно сделать, и он запускает поток для каждой задачи.13Проект — это один текущий разговор, в котором Claude координирует поток связанной работы для вас. Вы говорите ему, что нужно сделать, и он запускает поток для каждой задачи.

14 14

15Каждый поток обычно является [облачным сеансом](/docs/ru/claude-code-on-the-web): Claude Code, работающий в облаке, а не на вашей машине. Когда задаче требуется что-то, что есть только на вашем компьютере, вы можете попросить Claude запустить этот поток на вашем компьютере вместо этого через [Remote Control](/docs/ru/remote-control). Потоки работают параллельно и вы можете проверить их и направить их со своего телефона. Облачные потоки продолжают работу после того, как вы закроете ноутбук.15Каждый поток обычно является [облачным сеансом](/docs/ru/claude-code-on-the-web): Claude Code, работающий в облаке, а не на вашем компьютере. Когда задаче требуется что-то, что есть только на вашем компьютере, вы можете попросить Claude [запустить этот поток на вашем компьютере](#run-a-thread-on-your-own-computer) вместо облака через [Remote Control](/docs/ru/remote-control). Потоки работают параллельно, и вы можете проверять их и управлять ими со своего телефона. Облачные потоки продолжают работать после того, как вы закроете ноутбук, в то время как поток на вашем компьютере работает только при включенном компьютере.

16 16

17Без проекта запуск нескольких сеансов означает самостоятельное координирование: вы решаете, над чем работает каждый, повторяете одинаковый контекст в начале каждого и проверяете, какой завершился или требует ответа. С проектом вместо этого вы:17Без проекта запуск нескольких сеансов означает самостоятельное координирование: вы решаете, над чем работает каждый, повторяете одинаковый контекст в начале каждого и проверяете, какой завершился или требует ответа. С проектом вместо этого вы:

18 18

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

20* **Устанавливаете контекст один раз**: каждый новый поток начинается с инструкций проекта, поэтому правило, которое вы указываете один раз, например какую ветку выбрать, достигает все потоки.20* **Устанавливаете контекст один раз**: каждый новый поток начинается с инструкций проекта, поэтому правило, которое вы указываете один раз, например какую ветку выбрать, достигает все потоки.

21* **Уходите и возвращаетесь к завершенной работе**: когда вы вернетесь через час или на следующее утро, панель **Overview** показывает, какие потоки завершены, какие pull request готовы к проверке и какой поток ждет вашего ответа.21* **Уходите и возвращаетесь к завершенной работе**: когда вы вернетесь через час или на следующее утро, панель **Overview** показывает, какие потоки завершены, какие pull request готовы к проверке и какой поток ждет вашего ответа.

22 22

23Если вы уже знаете работу, которую хотите запустить в проекте, переходите прямо к [Создание проекта](#create-a-project).23Если вы уже знаете работу, которую хотите, чтобы проект выполнил, переходите прямо к [Создание проекта](#create-a-project).

24 24

25<h2 id="when-to-use-a-project">25<h2 id="when-to-use-a-project">

26 Когда использовать проект26 Когда использовать проект

39 Когда что-то другое подходит лучше39 Когда что-то другое подходит лучше

40</h3>40</h3>

41 41

42Потоки работают с репозиториями GitHub и с файлами, папками и папками Google Drive, которые вы загружаете в проект, а не с файлами или инструментами, которые существуют только на вашей машине. Если задача требует вашей машины, попросите Claude запустить её поток там через [Remote Control](/docs/ru/remote-control). [Ограничения](#limitations) перечисляют, что для этого требуется. Что-то другое подходит лучше в этих случаях:42Проект все еще подходит, когда только некоторые задачи требуют вашей машины. Облачные потоки работают с репозиториями GitHub и с файлами, папками и папками Google Drive, которые вы загружаете в проект, а для случайной задачи, которая требует локальной базы данных или инструмента на вашем компьютере, вы можете попросить Claude [запустить поток этой задачи на вашем компьютере](#run-a-thread-on-your-own-computer). Что-то другое подходит лучше в этих случаях:

43 43

44* **Одна задача, которая подходит в сеанс**: "Исправить нестабильный тест входа." Запустите [облачный сеанс](/docs/ru/claude-code-on-the-web) самостоятельно.44* **Одна задача, которая подходит в сеанс**: "Исправить нестабильный тест входа." Запустите [облачный сеанс](/docs/ru/claude-code-on-the-web) самостоятельно.

45* **Работа, где каждая задача требует вашей машины**: локальная база данных, эмулятор устройства или API за вашим VPN. Используйте локальный сеанс или [agent view](/docs/ru/agent-view) для запуска нескольких одновременно. Если работе нужны только локальные файлы, загрузите их в проект вместо этого.45* **Работа, где каждая задача требует вашей машины**: локальная база данных, эмулятор устройства или API за вашим VPN. Используйте локальный сеанс или [agent view](/docs/ru/agent-view) для запуска нескольких одновременно. Если работе нужны только локальные файлы, загрузите их в проект вместо этого.

277 277

278Каждое одобрение охватывает эту подсказку или остаток этого потока, если вы выберете более широкий вариант. Чтобы позволить каждому потоку запускать определенные команды без запроса или блокировать некоторые, добавьте [правила разрешений](/docs/ru/permissions) в `.claude/settings.json` репозитория. Потоки применяют их только в проекте с одним репозиторием; см. [Что потоки берут из ваших репозиториев](#what-threads-pick-up-from-your-repositories).278Каждое одобрение охватывает эту подсказку или остаток этого потока, если вы выберете более широкий вариант. Чтобы позволить каждому потоку запускать определенные команды без запроса или блокировать некоторые, добавьте [правила разрешений](/docs/ru/permissions) в `.claude/settings.json` репозитория. Потоки применяют их только в проекте с одним репозиторием; см. [Что потоки берут из ваших репозиториев](#what-threads-pick-up-from-your-repositories).

279 279

280<h3 id="run-a-thread-on-your-own-computer">

281 Запустите поток на своем компьютере

282</h3>

283

284Когда задача требует что-то, что есть только на вашем компьютере, например локальную базу данных, эмулятор устройства или API за вашим VPN, попросите Claude запустить поток для этой задачи на вашем компьютере вместо облака. Когда вы просите в разговоре проекта, поток — это сеанс Claude Code в папке на вашей машине, подключенный через [Remote Control](/docs/ru/remote-control). Другие потоки проекта продолжают работать в облаке. По сравнению с облачным потоком, поток на вашем компьютере:

285

286* Работает с файлами, инструментами, MCP серверами и параметрами Claude Code на этой машине вместо облачной среды проекта

287* Начинается с инструкций проекта, но без загруженных файлов памяти

288* Работает только пока этот компьютер включен с включенным Remote Control

289

290<Steps>

291 <Step title="Подключите папку">

292 На компьютере, у которого есть папка, которая нужна задаче, сделайте ее доступной через Remote Control одним из двух способов. Оба требуют Claude Code v2.1.280 или позже на этом компьютере.

293

294 * **В приложении Claude для рабочего стола**: откройте **Settings > Claude Code**, включите **Use this computer from your phone and claude.ai**, и добавьте папку в список под этим переключателем. Потоки могут работать на этом компьютере, пока приложение открыто.

295 * **В терминале**: запустите `claude remote-control` в папке и оставьте его работающим.

296 </Step>

297

298 <Step title="Попросите задачу с Work locally">

299 В разговоре проекта выберите **Work locally** из меню **+** рядом с полем сообщения, которое помечает ваше сообщение **Local**, и напишите, что вы хотите сделать. Сказание в сообщении, что задача должна работать на вашем компьютере, тоже работает.

300 </Step>

301

302 <Step title="Разрешите это на карточке">

303 Claude отвечает с карточкой **Allow Claude to work in a folder on your device**. Выберите папку, если вы подключили несколько. Затем нажмите **Allow once**.

304 </Step>

305</Steps>

306

307Поток работает в [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), поэтому Claude запускает команды и редактирует файлы в этой папке без вашего запроса каждый раз. Если auto mode недоступен или отключен в Claude Code этого компьютера, поток работает без него, и любая подсказка разрешения, которую он вызывает, ждет вашего ответа в потоке, как описано в [Разблокировка потока, ожидающего одобрения](#unblock-a-thread-waiting-on-approval).

308

309Пока поток работает, значок ноутбука в его заголовке показывает, подключен ли ваш компьютер. Нажмите на него, чтобы увидеть, какую папку использует поток, или отключить соединение. Поток приостанавливается, пока этот компьютер спит, и останавливается, если приложение для рабочего стола или `claude remote-control` завершает работу. [Lost contact with your folder](#lost-contact-with-your-folder) охватывает его запуск снова. В приложении для рабочего стола включите **Keep this computer awake for Remote Control** в **Settings > Claude Code**, чтобы компьютер не спал самостоятельно.

310

311Проект не может запустить поток на вашем компьютере, пока [**Require trusted devices**](/docs/ru/remote-control#trusted-devices) включен для вашей учетной записи.

312

280<h2 id="give-a-project-standing-context">313<h2 id="give-a-project-standing-context">

281 Предоставление проекту постоянного контекста314 Предоставление проекту постоянного контекста

282</h2>315</h2>

441* **Claude Tag**: [Claude Tag](https://claude.com/docs/claude-tag/overview) — это Claude в каналах Slack вашей команды, на планах Team и Enterprise. Любой в канале может дать ему работу, все в канале видят и направляют его, и он использует соединения, которые администратор установил для этого канала. Проект — это только ваш: вы единственный, кто отправляет ему работу или видит его потоки, он использует ваш собственный доступ GitHub и connectors, и он на Pro и Max. [Как Claude Tag отличается от Cowork и Claude Code](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code) имеет рядом.474* **Claude Tag**: [Claude Tag](https://claude.com/docs/claude-tag/overview) — это Claude в каналах Slack вашей команды, на планах Team и Enterprise. Любой в канале может дать ему работу, все в канале видят и направляют его, и он использует соединения, которые администратор установил для этого канала. Проект — это только ваш: вы единственный, кто отправляет ему работу или видит его потоки, он использует ваш собственный доступ GitHub и connectors, и он на Pro и Max. [Как Claude Tag отличается от Cowork и Claude Code](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code) имеет рядом.

442* **Cloud sessions**: каждый поток — это [облачный сеанс](/docs/ru/claude-code-on-the-web), если вы не попросите Claude запустить его на вашей машине. В любом случае Claude запускает и отслеживает его вместо вас. Облачный сеанс, который вы запустили самостоятельно, может стать проектом или питать один через [**Continue as a project** или **Move to project**](#start-from-an-existing-cloud-session).475* **Cloud sessions**: каждый поток — это [облачный сеанс](/docs/ru/claude-code-on-the-web), если вы не попросите Claude запустить его на вашей машине. В любом случае Claude запускает и отслеживает его вместо вас. Облачный сеанс, который вы запустили самостоятельно, может стать проектом или питать один через [**Continue as a project** или **Move to project**](#start-from-an-existing-cloud-session).

443* **Routines**: когда вы просите запланированную работу в проекте, Claude создает [routine](/docs/ru/routines), которая работает как потоки в этом проекте и отображается на его вкладке **Routines**. Routines, которые вы создаете вне проекта, продолжают работать самостоятельно.476* **Routines**: когда вы просите запланированную работу в проекте, Claude создает [routine](/docs/ru/routines), которая работает как потоки в этом проекте и отображается на его вкладке **Routines**. Routines, которые вы создаете вне проекта, продолжают работать самостоятельно.

444* **Local sessions и agent view**: сеанс, который вы запускаете самостоятельно в вашем терминале, IDE или локальной среде настольного приложения, не может быть добавлен в проект. Проект достигает вашей машины только путем запуска потока там через [Remote Control](/docs/ru/remote-control). [Agent view](/docs/ru/agent-view) — это экран для отслеживания нескольких локальных сеансов, которые вы запустили самостоятельно; он не имеет координатора.477* **Remote Control**: [Remote Control](/docs/ru/remote-control) соединяет claude.ai с сеансом Claude Code, работающим на вашей машине. Когда вы просите Claude в проекте запустить поток на вашем компьютере, проект [использует Remote Control для этого](#run-a-thread-on-your-own-computer).

478* **Local sessions и agent view**: сеанс, который вы запускаете самостоятельно в вашем терминале, IDE или локальной среде настольного приложения, не может быть добавлен в проект. [Agent view](/docs/ru/agent-view) — это экран для отслеживания нескольких локальных сеансов рядом, и вы по-прежнему запускаете каждый и даете ему его задачу самостоятельно.

445* **Worktrees**: [worktree](/docs/ru/worktrees) дает каждому локальному сеансу свою рабочую копию репозитория, поэтому параллельные сеансы на вашей машине не перезаписывают друг друга. Облачным потокам они не нужны: каждый клонирует свои репозитории в свою облачную песочницу и работает на своей ветке.479* **Worktrees**: [worktree](/docs/ru/worktrees) дает каждому локальному сеансу свою рабочую копию репозитория, поэтому параллельные сеансы на вашей машине не перезаписывают друг друга. Облачным потокам они не нужны: каждый клонирует свои репозитории в свою облачную песочницу и работает на своей ветке.

446* **Agent teams**: [agent team](/docs/ru/agent-teams) — это один сеанс, который запускает сеансы товарищей для одной задачи, на вашей машине или внутри облачного сеанса, и заканчивается этой задачей.480* **Agent teams**: [agent team](/docs/ru/agent-teams) — это один сеанс, который запускает сеансы товарищей для одной задачи, на вашей машине или внутри облачного сеанса, и заканчивается этой задачей.

447* **Projects в claude.ai chat и Cowork**: [более ранний опыт Projects](https://support.claude.com/en/articles/9517075-what-are-projects), который группирует разговоры и справочные файлы без потоков или координатора. Эти проекты продолжают работать так, как они работают сегодня, пока переработанный опыт не достигнет их.481* **Projects в claude.ai chat и Cowork**: [более ранний опыт Projects](https://support.claude.com/en/articles/9517075-what-are-projects), который группирует разговоры и справочные файлы без потоков или координатора. Эти проекты продолжают работать так, как они работают сегодня, пока переработанный опыт не достигнет их.

454 488

455* Projects доступны в claude.ai/code, в настольном приложении и в мобильном приложении Claude, но не в CLI терминала или через Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Команда [`claude project`](/docs/ru/cli-reference) CLI, которая управляет локальным состоянием Claude Code для директории, не связана.489* Projects доступны в claude.ai/code, в настольном приложении и в мобильном приложении Claude, но не в CLI терминала или через Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Команда [`claude project`](/docs/ru/cli-reference) CLI, которая управляет локальным состоянием Claude Code для директории, не связана.

456* Потоки проекта — это [облачные сеансы](/docs/ru/claude-code-on-the-web) или сеансы на вашей собственной машине через [Remote Control](/docs/ru/remote-control), с Anthropic в качестве поставщика модели в обоих случаях. [Безопасность](/docs/ru/security) и [Использование данных](/docs/ru/data-usage) охватывают, как облачные сеансы изолированы и что сохраняется, а [Connection and security](/docs/ru/remote-control#connection-and-security) охватывает, как поток на вашей машине подключается и что хранится.490* Потоки проекта — это [облачные сеансы](/docs/ru/claude-code-on-the-web) или сеансы на вашей собственной машине через [Remote Control](/docs/ru/remote-control), с Anthropic в качестве поставщика модели в обоих случаях. [Безопасность](/docs/ru/security) и [Использование данных](/docs/ru/data-usage) охватывают, как облачные сеансы изолированы и что сохраняется, а [Connection and security](/docs/ru/remote-control#connection-and-security) охватывает, как поток на вашей машине подключается и что хранится.

457* Вы не можете добавить сеанс, который вы запустили сами на вашей машине, в проект. Чтобы позволить проекту запустить поток на вашей машине, подключите папку, в которой он должен работать, через [Remote Control](/docs/ru/remote-control#requirements): включите Remote Control в **Settings > Claude Code** в настольном приложении Claude или запустите `claude remote-control` в папке и оставьте его работающим. Эта машина должна иметь Claude Code v2.1.280 или позже. Проект также не может запустить поток на вашей машине, пока в ваших настройках claude.ai включена опция **Require trusted devices**.491* Вы не можете добавить сеанс, который вы запустили сами на вашей машине, в проект. Проект достигает вашей машины только путем [запуска потока там через Remote Control](#run-a-thread-on-your-own-computer), и этот раздел перечисляет, что ему нужно.

458* Песочница потока приостанавливается между ходами и возобновляется, когда поток продолжает. Если песочница не может быть возобновлена, поток продолжает с свежего клона, поэтому незафиксированные изменения могут быть потеряны. На долгих задачах попросите Claude зафиксировать и отправить работу в процессе.492* Песочница потока приостанавливается между ходами и возобновляется, когда поток продолжает. Если песочница не может быть возобновлена, поток продолжает с свежего клона, поэтому незафиксированные изменения могут быть потеряны. На долгих задачах попросите Claude зафиксировать и отправить работу в процессе.

459* Проект принадлежит одному пользователю. Вы не можете поделиться проектом или его потоками с другим пользователем, и транскрипты потоков не имеют опции поделиться, которую имеют другие облачные сеансы. Нет элементов управления на уровне организации для проектов во время бета-версии.493* Проект принадлежит одному пользователю. Вы не можете поделиться проектом или его потоками с другим пользователем, и транскрипты потоков не имеют опции поделиться, которую имеют другие облачные сеансы. Нет элементов управления на уровне организации для проектов во время бета-версии.

460* Поток принадлежит одному проекту, который его запустил. Вы не можете переместить или скопировать поток в другой проект или переместить его отдельно. [**Move to project**](#start-from-an-existing-cloud-session) идет только в другую сторону: он переносит работу облачного сеанса в проект.494* Поток принадлежит одному проекту, который его запустил. Вы не можете переместить или скопировать поток в другой проект или переместить его отдельно. [**Move to project**](#start-from-an-existing-cloud-session) идет только в другую сторону: он переносит работу облачного сеанса в проект.

513 547

514Поток или разговор проекта сделал запрос, который ваш план охватывает только с usage credits, например один к модели или размеру контекста, который ваш план не включает, и usage credits не включены для вашего аккаунта. [Добавить usage credits к вашей подписке](/docs/ru/costs#add-usage-credits-to-your-subscription) охватывает, кто может их включить или купить на каждом плане. Когда credits доступны, отправьте другое сообщение для повтора.548Поток или разговор проекта сделал запрос, который ваш план охватывает только с usage credits, например один к модели или размеру контекста, который ваш план не включает, и usage credits не включены для вашего аккаунта. [Добавить usage credits к вашей подписке](/docs/ru/costs#add-usage-credits-to-your-subscription) охватывает, кто может их включить или купить на каждом плане. Когда credits доступны, отправьте другое сообщение для повтора.

515 549

550<h3 id="lost-contact-with-your-folder">

551 Потеря контакта с вашей папкой

552</h3>

553

554Поток, работающий на вашем компьютере, показывает это, когда сеанс Claude Code там перестал отвечать, обычно потому, что компьютер перешел в режим сна или настольное приложение или `claude remote-control` завершилось. Разбудите компьютер, и если настольное приложение или `claude remote-control` больше не работает там, запустите его снова: переоткройте приложение и подтвердите, что **Use this computer from your phone and claude.ai** все еще включено в **Settings > Claude Code**, или запустите `claude remote-control` снова в той же папке.

555

516<h3 id="context-limit">556<h3 id="context-limit">

517 Другие сообщения557 Другие сообщения

518</h3>558</h3>

527| "The project's environment was removed" | Выберите другую среду в **Project settings > Environment**; изменение применяется к новым потокам |567| "The project's environment was removed" | Выберите другую среду в **Project settings > Environment**; изменение применяется к новым потокам |

528| "Setup script failed" | Нажмите **Edit setup script** на ошибке, исправьте скрипт в среде, затем отправьте другое сообщение. [Setup script failed](/docs/ru/web-quickstart#setup-script-failed) перечисляет общие причины |568| "Setup script failed" | Нажмите **Edit setup script** на ошибке, исправьте скрипт в среде, затем отправьте другое сообщение. [Setup script failed](/docs/ru/web-quickstart#setup-script-failed) перечисляет общие причины |

529| "Claude ran out of context on this turn" | Поток заполнил свое контекстное окно. Если сообщение говорит, что поток продолжает в свежем сеансе, он продолжает самостоятельно; в противном случае попросите Claude в разговоре проекта запустить новый поток для оставшейся работы |569| "Claude ran out of context on this turn" | Поток заполнил свое контекстное окно. Если сообщение говорит, что поток продолжает в свежем сеансе, он продолжает самостоятельно; в противном случае попросите Claude в разговоре проекта запустить новый поток для оставшейся работы |

570| "Couldn't start in" с последующим названием вашей папки | Вы разрешили потоку работать на вашем компьютере, но сеанс не смог там начать. Когда строка под сообщением дает причину, исправьте это, затем попросите Claude запустить задачу снова |

571| "Claude is out of date on your device" | Компьютер, который вы выбрали для запуска потока, имеет версию Claude Code старше v2.1.280. Обновите Claude Code там или обновите настольное приложение, если это то, что подключает папку, затем попросите Claude запустить задачу снова |

530| "Reached the turn limit" | Поток достиг ограничения на шаги для одного сообщения, которое устанавливает [`CLAUDE_CODE_MAX_TURNS`](/docs/ru/env-vars). Отправьте другое сообщение для продолжения, или повысьте или удалите эту переменную там, где она установлена |572| "Reached the turn limit" | Поток достиг ограничения на шаги для одного сообщения, которое устанавливает [`CLAUDE_CODE_MAX_TURNS`](/docs/ru/env-vars). Отправьте другое сообщение для продолжения, или повысьте или удалите эту переменную там, где она установлена |

531 573

532<h2 id="related-resources">574<h2 id="related-resources">

cli-reference.md +5 −5

Details

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

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

29| `claude auth status` | Показать статус аутентификации в формате JSON. Используйте `--text` для удобочитаемого вывода. Выходит с кодом 0, если вы вошли, 1, если нет | `claude auth status` |29| `claude auth status` | Показать статус аутентификации в формате JSON. Используйте `--text` для удобочитаемого вывода. Выходит с кодом 0, если вы вошли, 1, если нет. JSON включает поле `configDirectory`, называющее [каталог конфигурации](/docs/ru/claude-directory), который использует CLI. Это поле требует Claude Code v2.1.268 или позже | `claude auth status` |

30| `claude agents` | Открыть [представление агентов](/docs/ru/agent-view) для мониторинга и отправки параллельных фоновых сеансов. Используйте `--cwd <path>` для отображения только сеансов, запущенных в этом каталоге, или `--json` для вывода активных сеансов в виде массива JSON для написания скриптов (`--json --all` также включает завершенные фоновые сеансы). Передайте `--permission-mode`, `--model`, `--effort` или `--agent` для установки [значений по умолчанию для отправленных сеансов](/docs/ru/agent-view#permission-mode-model-and-effort). Принимает `--settings`, `--add-dir`, `--plugin-dir` и `--mcp-config` как команда верхнего уровня `claude`. Открытие представления агентов требует интерактивный терминал | `claude agents --json` |30| `claude agents` | Открыть [представление агентов](/docs/ru/agent-view) для мониторинга и отправки параллельных фоновых сеансов. Используйте `--cwd <path>` для отображения только сеансов, запущенных в этом каталоге, или `--json` для вывода активных сеансов в виде массива JSON для написания скриптов (`--json --all` также включает завершенные фоновые сеансы). Передайте `--permission-mode`, `--model`, `--effort` или `--agent` для установки [значений по умолчанию для отправленных сеансов](/docs/ru/agent-view#permission-mode-model-and-effort). Принимает `--settings`, `--add-dir`, `--plugin-dir` и `--mcp-config` как команда верхнего уровня `claude`. Открытие представления агентов требует интерактивный терминал | `claude agents --json` |

32| `claude auto-mode defaults` | Вывести встроенные правила классификатора [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) в формате JSON. Используйте `claude auto-mode config` для просмотра вашей эффективной конфигурации с применяемыми параметрами. `--label <prefix>` выводит только правила, метка которых начинается с этого префикса, сопоставляя без учета регистра. Требует Claude Code v2.1.208 или позже | `claude auto-mode defaults --label 'Git Destructive'` |32| `claude auto-mode defaults` | Вывести встроенные правила классификатора [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) в формате JSON. Используйте `claude auto-mode config` для просмотра вашей эффективной конфигурации с применяемыми параметрами. `--label <prefix>` выводит только правила, метка которых начинается с этого префикса, сопоставляя без учета регистра. Требует Claude Code v2.1.208 или позже | `claude auto-mode defaults --label 'Git Destructive'` |

64| `--add-dir` | Добавить дополнительные рабочие каталоги для Claude для чтения и редактирования файлов. Предоставляет доступ к файлам; Claude Code [не обнаруживает](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) большинство конфигурации `.claude/` из этих каталогов. Проверяет, что каждый путь существует как каталог. Вы не можете добавить большинство [сетевых путей](/docs/ru/errors#working-directory-is-a-network-path), таких как `\\server\share`. Чтобы сохранить эти каталоги между сеансами, установите [`permissions.additionalDirectories`](/docs/ru/settings-reference#permissions-additionaldirectories) в параметрах | `claude --add-dir ../apps ../lib` |64| `--add-dir` | Добавить дополнительные рабочие каталоги для Claude для чтения и редактирования файлов. Предоставляет доступ к файлам; Claude Code [не обнаруживает](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) большинство конфигурации `.claude/` из этих каталогов. Проверяет, что каждый путь существует как каталог. Вы не можете добавить большинство [сетевых путей](/docs/ru/errors#working-directory-is-a-network-path), таких как `\\server\share`. Чтобы сохранить эти каталоги между сеансами, установите [`permissions.additionalDirectories`](/docs/ru/settings-reference#permissions-additionaldirectories) в параметрах | `claude --add-dir ../apps ../lib` |

65| `--advisor <model>` | Включить инструмент [advisor](/docs/ru/advisor) на стороне сервера для этого сеанса с псевдонимом модели `fable`, `opus` или `sonnet`, или полным ID модели. Имеет приоритет над параметром `advisorModel` для сеанса. `fable` требует [доступ к Fable](/docs/ru/advisor#choose-an-advisor-model) | `claude --advisor opus` |65| `--advisor <model>` | Включить инструмент [advisor](/docs/ru/advisor) на стороне сервера для этого сеанса с псевдонимом модели `fable`, `opus` или `sonnet`, или полным ID модели. Имеет приоритет над параметром `advisorModel` для сеанса. `fable` требует [доступ к Fable](/docs/ru/advisor#choose-an-advisor-model) | `claude --advisor opus` |

67| `--agents` | Определить пользовательские subagents динамически через JSON. Принимает [поля, указанные для subagents, определённых через CLI](/docs/ru/sub-agents#choose-the-subagent-scope). Claude Code проверяет JSON при запуске и выходит при недействительном значении; см. [`Invalid --agents configuration`](/docs/ru/errors#invalid-agents-configuration) для сообщения и для флагов и переменной окружения, которые пропускают проверку. Проверка требует Claude Code v2.1.242 или позже | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |67| `--agents` | Определить пользовательские subagents динамически через JSON. Принимает [поля, указанные для subagents, определённых через CLI](/docs/ru/sub-agents#choose-the-subagent-scope). С `--print` значение может быть вместо этого путём к файлу JSON, содержащему объект; форма файла требует Claude Code v2.1.281 или позже. Claude Code проверяет значение при запуске и выходит при недействительном; см. [`Invalid --agents configuration`](/docs/ru/errors#invalid-agents-configuration) для сообщения и для флагов и переменной окружения, которые пропускают проверку. Проверка требует Claude Code v2.1.242 или позже | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

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

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

70| `--append-subagent-system-prompt` | Добавить пользовательский текст в конец системного приглашения каждого [subagent](/docs/ru/sub-agents), включая вложенные subagents, кроме [forked subagent](/docs/ru/sub-agents#fork-the-current-conversation), который повторно использует приглашение собственной беседы. Применяется только в неинтерактивном режиме с `-p`. Требует Claude Code v2.1.205 или позже | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |70| `--append-subagent-system-prompt` | Добавить пользовательский текст в конец системного приглашения каждого [subagent](/docs/ru/sub-agents), включая вложенные subagents, кроме [forked subagent](/docs/ru/sub-agents#fork-the-current-conversation), который повторно использует приглашение собственной беседы. Применяется только в неинтерактивном режиме с `-p`. Требует Claude Code v2.1.205 или позже | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

75| `--ax-screen-reader` | Отрендерить вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Принудительно использует классический рендерер, поэтому параметр [`tui`](/docs/ru/settings-reference#tui) не имеет эффекта; присоединённые [фоновые сеансы](/docs/ru/agent-view) по-прежнему отрендериваются в полноэкранном режиме. Имеет приоритет над [`CLAUDE_AX_SCREEN_READER`](/docs/ru/env-vars) и параметром [`axScreenReader`](/docs/ru/settings-reference#axscreenreader). Требует Claude Code v2.1.181 или позже | `claude --ax-screen-reader` |75| `--ax-screen-reader` | Отрендерить вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Принудительно использует классический рендерер, поэтому параметр [`tui`](/docs/ru/settings-reference#tui) не имеет эффекта; присоединённые [фоновые сеансы](/docs/ru/agent-view) по-прежнему отрендериваются в полноэкранном режиме. Имеет приоритет над [`CLAUDE_AX_SCREEN_READER`](/docs/ru/env-vars) и параметром [`axScreenReader`](/docs/ru/settings-reference#axscreenreader). Требует Claude Code v2.1.181 или позже | `claude --ax-screen-reader` |

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

78| `--bg`, `--background` | Запустить сеанс как [фоновый агент](/docs/ru/agent-view) и вернуться немедленно. Выводит ID сеанса и команды управления. Комбинируйте с `--exec` для запуска команды shell как фонового задания вместо сеанса Claude, или с `--agent` для запуска конкретного subagent. Не может быть скомбинирован с `-p`/`--print`; см. [справочник ошибок](/docs/ru/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |78| `--bg`, `--background` | Запустить сеанс как [фоновый агент](/docs/ru/agent-view) и вернуться немедленно. Выводит ID сеанса и команды управления. Комбинируйте с `--exec` для запуска команды shell как фонового задания вместо сеанса Claude, или с `--agent` для запуска конкретного subagent. Проверяет [доверие рабочей области](/docs/ru/permissions#project-allow-rules-and-workspace-trust) для каталога перед запуском. Не может быть скомбинирован с `-p`/`--print`; см. [справочник ошибок](/docs/ru/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |

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

81| `--cloud` | С описанием задачи создать новый [веб-сеанс](/docs/ru/claude-code-on-the-web). С ID сеанса (`session_...` или `cse_...`) или URL claude.ai/code поставить в очередь сообщение в этот существующий сеанс вместо этого, с `-p`. См. [отправить последующее сообщение](/docs/ru/claude-code-on-the-web#send-follow-ups-from-the-cli). | `claude --cloud "Fix the login bug"` |81| `--cloud` | С описанием задачи создать новый [веб-сеанс](/docs/ru/claude-code-on-the-web). С ID сеанса (`session_...` или `cse_...`) или URL claude.ai/code поставить в очередь сообщение в этот существующий сеанс вместо этого, с `-p`. См. [отправить последующее сообщение](/docs/ru/claude-code-on-the-web#send-follow-ups-from-the-cli). | `claude --cloud "Fix the login bug"` |

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

90| `--enable-auto-mode` | Удалено в v2.1.111. Auto mode теперь находится в цикле `Shift+Tab` по умолчанию; используйте `--permission-mode auto` для запуска в нем | `claude --permission-mode auto` |90| `--enable-auto-mode` | Удалено в v2.1.111. Auto mode теперь находится в цикле `Shift+Tab` по умолчанию; используйте `--permission-mode auto` для запуска в нем | `claude --permission-mode auto` |

91| `--environment <environment-id>` | Создать новый облачный сеанс, который работает на [самостоятельно размещённой среде](/docs/ru/self-hosted-environments) с заданным ID. ID среды начинаются с `ccpool_`. См. [поведение отправки `--environment`](/docs/ru/self-hosted-environments-testing#environment-dispatch-behavior) для поведения отправки и комбинаций флагов, которые она отклоняет. Требует Claude Code v2.1.224 или позже | `claude -p "Fix the login bug" --environment ccpool_abc123` |91| `--environment <environment-id>` | Создать новый облачный сеанс, который работает на [самостоятельно размещённой среде](/docs/ru/self-hosted-environments) с заданным ID. ID среды начинаются с `ccpool_`. См. [поведение отправки `--environment`](/docs/ru/self-hosted-environments-testing#environment-dispatch-behavior) для поведения отправки и комбинаций флагов, которые она отклоняет. Требует Claude Code v2.1.224 или позже | `claude -p "Fix the login bug" --environment ccpool_abc123` |

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

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

94| `--fallback-model` | Включить автоматический переход на указанную модель (модели) при перегрузке или недоступности основной модели, например снятая с производства модель. Принимает разделённый запятыми список, пробуемый по порядку. См. [Цепочки резервных моделей](/docs/ru/model-config#fallback-model-chains). Чтобы сохранить цепочку между сеансами, используйте параметр [`fallbackModel`](/docs/ru/settings-reference#fallbackmodel), который этот флаг переопределяет | `claude --fallback-model sonnet,haiku` |94| `--fallback-model` | Включить автоматический переход на указанную модель (модели) при перегрузке или недоступности основной модели, например снятая с производства модель. Принимает разделённый запятыми список, пробуемый по порядку. См. [Цепочки резервных моделей](/docs/ru/model-config#fallback-model-chains). Чтобы сохранить цепочку между сеансами, используйте параметр [`fallbackModel`](/docs/ru/settings-reference#fallbackmodel), который этот флаг переопределяет | `claude --fallback-model sonnet,haiku` |

95| `--fork-session` | При возобновлении создать новый ID сеанса вместо повторного использования исходного (используйте с `--resume` или `--continue`) | `claude --resume abc123 --fork-session` |95| `--fork-session` | При возобновлении создать новый ID сеанса вместо повторного использования исходного (используйте с `--resume` или `--continue`) | `claude --resume abc123 --fork-session` |

127| `--resume`, `-r` | Возобновить конкретный сеанс по ID или имени, или показать интерактивный выбор для выбора сеанса. Вместо ID вы можете передать абсолютный путь к [файлу транскрипта `.jsonl` сеанса](/docs/ru/sessions#where-transcripts-are-stored). Выбор и поиск по имени включают сеансы, которые добавили этот каталог с `/add-dir`. Когда вы передаёте ID сеанса, Claude Code ищет текущий каталог проекта и его git worktrees, затем каждый другой проект на этой машине. До v2.1.223 поиск ID охватывал только текущий каталог проекта и его git worktrees. [Фоновые сеансы](/docs/ru/agent-view) появляются в выборе, отмеченные с `bg` | `claude --resume auth-refactor` |127| `--resume`, `-r` | Возобновить конкретный сеанс по ID или имени, или показать интерактивный выбор для выбора сеанса. Вместо ID вы можете передать абсолютный путь к [файлу транскрипта `.jsonl` сеанса](/docs/ru/sessions#where-transcripts-are-stored). Выбор и поиск по имени включают сеансы, которые добавили этот каталог с `/add-dir`. Когда вы передаёте ID сеанса, Claude Code ищет текущий каталог проекта и его git worktrees, затем каждый другой проект на этой машине. До v2.1.223 поиск ID охватывал только текущий каталог проекта и его git worktrees. [Фоновые сеансы](/docs/ru/agent-view) появляются в выборе, отмеченные с `bg` | `claude --resume auth-refactor` |

128| `--safe-mode` | Запустить со всеми отключенными настройками для устранения неполадок в нарушенной конфигурации: CLAUDE.md, skills, plugins, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, рабочие процессы, пользовательские темы, пользовательские сочетания клавиш, строка состояния и команды предложения файлов, LSP серверы и автоматическая память не загружаются. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально, что отличается от [`--bare`](/docs/ru/headless#start-faster-with-bare-mode). Политика управляемых параметров всё ещё применяется, включая настроенные политикой hooks, строку состояния и команды предложения файлов; управляемые plugins, управляемые skills, управляемый CLAUDE.md и настроенные политикой MCP серверы не загружаются. Полезно для проверки того, является ли настройка причиной [автоматического переключения модели](/docs/ru/model-config#automatic-model-fallback). Устанавливает [`CLAUDE_CODE_SAFE_MODE`](/docs/ru/env-vars) | `claude --safe-mode` |128| `--safe-mode` | Запустить со всеми отключенными настройками для устранения неполадок в нарушенной конфигурации: CLAUDE.md, skills, plugins, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, рабочие процессы, пользовательские темы, пользовательские сочетания клавиш, строка состояния и команды предложения файлов, LSP серверы и автоматическая память не загружаются. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально, что отличается от [`--bare`](/docs/ru/headless#start-faster-with-bare-mode). Политика управляемых параметров всё ещё применяется, включая настроенные политикой hooks, строку состояния и команды предложения файлов; управляемые plugins, управляемые skills, управляемый CLAUDE.md и настроенные политикой MCP серверы не загружаются. Полезно для проверки того, является ли настройка причиной [автоматического переключения модели](/docs/ru/model-config#automatic-model-fallback). Устанавливает [`CLAUDE_CODE_SAFE_MODE`](/docs/ru/env-vars) | `claude --safe-mode` |

130| `--setting-sources` | Разделённый запятыми список источников параметров для загрузки (`user`, `project`, `local`) | `claude --setting-sources user,project` |130| `--setting-sources` | Разделённый запятыми список источников параметров для загрузки (`user`, `project`, `local`). См. [agent view](/docs/ru/agent-view#what-carries-over-when-you-background) и [agent teams](/docs/ru/agent-teams#context-and-communication) для сеансов, которые вы запускаете из этого, которые наследуют список | `claude --setting-sources user,project` |

131| `--settings` | Путь к файлу параметров JSON или встроенная строка JSON. Значения, которые вы устанавливаете здесь, переопределяют те же ключи в ваших файлах `settings.json` для этого сеанса. Ключи, которые вы опускаете, сохраняют свои значения на основе файла. Файл должен быть обычным файлом размером не более 2 МиБ. См. [приоритет параметров](/docs/ru/settings#settings-precedence) | `claude --settings ./settings.json` |131| `--settings` | Путь к файлу параметров JSON или встроенная строка JSON. Значения, которые вы устанавливаете здесь, переопределяют те же ключи в ваших файлах `settings.json` для этого сеанса. Ключи, которые вы опускаете, сохраняют свои значения на основе файла. Файл должен быть обычным файлом размером не более 2 МиБ. См. [приоритет параметров](/docs/ru/settings#settings-precedence) | `claude --settings ./settings.json` |

132| `--strict-mcp-config` | Использовать только MCP серверы из `--mcp-config`, игнорируя все остальные конфигурации MCP. См. [Исключительный контроль с managed-mcp.json](/docs/ru/managed-mcp#exclusive-control-with-managed-mcp-json) для того, что флаг делает под управляемым файлом MCP | `claude --strict-mcp-config --mcp-config ./mcp.json` |132| `--strict-mcp-config` | Использовать только MCP серверы из `--mcp-config`, игнорируя все остальные конфигурации MCP. См. [Исключительный контроль с managed-mcp.json](/docs/ru/managed-mcp#exclusive-control-with-managed-mcp-json) для того, что флаг делает под управляемым файлом MCP | `claude --strict-mcp-config --mcp-config ./mcp.json` |

cloud-environments.md +47 −33

Details

78DATABASE_URL=postgres://localhost:5432/myapp78DATABASE_URL=postgres://localhost:5432/myapp

79```79```

80 80

81Каждый сеанс копирует значения среды один раз при запуске в обычные переменные окружения, которые может читать любая команда, которую запускает Claude. Поскольку работающие сеансы не перечитывают конфигурацию, редактирование или добавление переменных влияет на сеансы, которые вы запускаете позже; сеансы, которые уже работают, сохраняют значения, с которыми они начали.81Каждый сеанс копирует значения среды один раз при запуске в обычные переменные окружения, которые может читать любая команда, которую запускает Claude, кроме переменных `OTEL_*`. Claude Code использует их для собственного [экспорта телеметрии](/docs/ru/monitoring-usage#telemetry-from-cloud-sessions-and-claude-tag) и не передаёт их командам, которые он запускает. Поскольку работающие сеансы не перечитывают конфигурацию, редактирование или добавление переменных влияет на сеансы, которые вы запускаете позже; сеансы, которые уже работают, сохраняют значения, с которыми они начали.

82 82

83Облачный сеанс также устанавливает некоторые переменные сам, когда запускается. Для [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/ru/claude-code-on-the-web#manage-context) значение, которое устанавливает сеанс, переопределяет то, которое вы добавляете здесь, поэтому добавление этого ключа здесь не имеет эффекта.83Облачный сеанс также устанавливает некоторые переменные сам, когда запускается. Для [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/ru/claude-code-on-the-web#manage-context) значение, которое устанавливает сеанс, переопределяет то, которое вы добавляете здесь, поэтому добавление этого ключа здесь не имеет эффекта.

84 84

149* **GitHub**: [прокси GitHub](#github-proxy) аутентифицирует запросы к GitHub вместо этого, поэтому вам не нужны учётные данные API для этого149* **GitHub**: [прокси GitHub](#github-proxy) аутентифицирует запросы к GitHub вместо этого, поэтому вам не нужны учётные данные API для этого

150* **API Anthropic и общедоступные реестры пакетов**: `api.anthropic.com`, `registry.npmjs.org`, `jsr.io`, `npm.jsr.io`, `pypi.org`, `files.pythonhosted.org`, `index.crates.io` и `proxy.golang.org`150* **API Anthropic и общедоступные реестры пакетов**: `api.anthropic.com`, `registry.npmjs.org`, `jsr.io`, `npm.jsr.io`, `pypi.org`, `files.pythonhosted.org`, `index.crates.io` и `proxy.golang.org`

151* **Запросы скрипта установки**: Claude Code подключается к прокси агента, когда он запускается, после того как [скрипт установки](#setup-scripts) запустился151* **Запросы скрипта установки**: Claude Code подключается к прокси агента, когда он запускается, после того как [скрипт установки](#setup-scripts) запустился

152* **Экспорт телеметрии Claude Code**: Claude Code отправляет свой [экспорт телеметрии](/docs/ru/monitoring-usage#telemetry-from-cloud-sessions-and-claude-tag) сам, а не через команду, которую он запускает, и этот запрос не проходит через прокси агента

152 153

153<h3 id="select-an-environment-from-the-cli">154<h3 id="select-an-environment-from-the-cli">

154 Выбор среды из CLI155 Выбор среды из CLI

200* [Закрепите одну на канале](https://claude.com/docs/claude-tag/admins/troubleshooting#channel-sessions-use-the-wrong-environment-or-can%E2%80%99t-find-one) в параметрах администратора Claude Tag.201* [Закрепите одну на канале](https://claude.com/docs/claude-tag/admins/troubleshooting#channel-sessions-use-the-wrong-environment-or-can%E2%80%99t-find-one) в параметрах администратора Claude Tag.

201 202

202<h2 id="network-access">203<h2 id="network-access">

203 Доступ в сеть204 Сетевой доступ

204</h2>205</h2>

205 206

206Каждая среда устанавливает один уровень доступа в сеть, который контролирует исходящие соединения, которые могут устанавливать её сеансы. Уровень по умолчанию, **Trusted**, разрешает реестры пакетов и другие [разрешённые домены](#default-allowed-domains); **Custom** принимает ваш собственный список доменов.207Каждая среда устанавливает один уровень сетевого доступа, который контролирует исходящие соединения, которые могут устанавливать её сеансы. Уровень по умолчанию, **Trusted**, разрешает реестры пакетов и другие [домены в списке разрешённых](#default-allowed-domains); **Custom** использует ваш собственный список доменов.

207 208

208Чтобы изменить доступ в сеть среды, [откройте её для редактирования](#configure-your-environment) и используйте селектор **Network access** в диалоге. [Общая для организации среда](#organization-shared-environments) открывается в режиме только для чтения там, поэтому владелец изменяет её доступ в сеть со страницы **Cloud environments** в [параметрах администратора](https://claude.ai/admin-settings). Облачный значок, который открывает селектор, появляется на поверхностях приложения, перечисленных в [Среда Default](#the-default-environment) и в [редакторе процедуры](/docs/ru/routines#environments-and-network-access); личные среды не имеют отдельной страницы в параметрах вашей учётной записи claude.ai.209Чтобы изменить сетевой доступ среды, [откройте её для редактирования](#configure-your-environment) и используйте селектор **Network access** в диалоговом окне. [Общая среда](#organization-shared-environments) открывается там в режиме только для чтения, поэтому владелец изменяет её сетевой доступ со страницы **Cloud environments** в [параметрах администратора](https://claude.ai/admin-settings). Значок облака, который открывает селектор, появляется на поверхностях приложения, перечисленных в разделе [Среда по умолчанию](#the-default-environment), и в [редакторе процедур](/docs/ru/routines#environments-and-network-access); личные среды не имеют отдельной страницы в параметрах вашего аккаунта claude.ai.

209 210

210<Note>211<Note>

211 Соединители MCP, которые вы включаете в сеансе или процедуре, работают без добавления их хостов в **Allowed domains**, потому что трафик соединителя проходит через серверы Anthropic, а не через сеть сеанса. Это полагается на тот же канал, привязанный к Anthropic, отмеченный в [Безопасность и изоляция](/docs/ru/claude-code-on-the-web#security-and-isolation). Отключите любой соединитель, который вам не нужен, чтобы ограничить, какие инструменты может достичь Claude.212 Соединители MCP, которые вы включаете в сеансе или процедуре, работают без добавления их хостов в **Allowed domains**, потому что трафик соединителя проходит через серверы Anthropic, а не через сеть сеанса. Это зависит от того же канала, привязанного к Anthropic, отмеченного в разделе [Безопасность и изоляция](/docs/ru/claude-code-on-the-web#security-and-isolation). Отключите любой соединитель, который вам не нужен, чтобы ограничить, какие инструменты может использовать Claude.

212</Note>213</Note>

213 214

214<h3 id="access-levels">215<h3 id="access-levels">

215 Уровни доступа216 Уровни доступа

216</h3>217</h3>

217 218

218Поле **Network access** в [диалоге среды](#configure-your-environment) принимает один из четырёх уровней:219Поле **Network access** в [диалоговом окне среды](#configure-your-environment) принимает один из четырёх уровней:

219 220

220| Уровень | Исходящие соединения |221| Уровень | Исходящие соединения |

221| :- | :- |222| :- | :- |

222| **None** | Нет исходящего сетевого доступа через сеть сеанса |223| **None** | Нет исходящего сетевого доступа через сеть сеанса |

223| **Trusted** | Только [разрешённые домены](#default-allowed-domains): реестры пакетов, GitHub, облачные SDK |224| **Trusted** | Только [домены в списке разрешённых](#default-allowed-domains): реестры пакетов, GitHub, облачные SDK |

224| **Full** | Любой домен |225| **Full** | Любой домен |

225| **Custom** | Ваш собственный список разрешений, опционально включая значения по умолчанию |226| **Custom** | Ваш собственный список разрешённых, опционально включающий значения по умолчанию |

226 227

227Какой бы уровень вы ни выбрали, сеансы всё ещё могут достичь этих, потому что каждый из них принимает путь, который не проходит через список разрешений доступа в сеть сеанса:228Независимо от выбранного уровня, сеансы всё ещё могут достичь следующего, потому что каждый из них использует путь, который не проходит через список разрешённых сетей сеанса:

228 229

229* GitHub, через его [отдельный прокси](#github-proxy)230* GitHub, через его [отдельный прокси](#github-proxy)

230* [Соединители MCP](#network-access), которые вы включаете, чей трафик проходит через серверы Anthropic231* [Соединители MCP](#network-access), которые вы включаете, трафик которых проходит через серверы Anthropic

231* Хосты, которые вы перечислили на [учётных данных API](#add-api-credentials) среды, кроме [хостов, которые никогда не получают учётные данные](#requests-that-never-get-the-credential)232* Хосты, которые вы указали в [учётных данных API](#add-api-credentials) среды, кроме [хостов, которые никогда не получают учётные данные](#requests-that-never-get-the-credential)

232* API Anthropic, для собственных запросов Claude Code, даже при **None**, как отмечено в [Безопасность и изоляция](/docs/ru/claude-code-on-the-web#security-and-isolation)233* API Anthropic, для собственных запросов Claude Code, даже при **None**, как отмечено в разделе [Безопасность и изоляция](/docs/ru/claude-code-on-the-web#security-and-isolation)

233 234

234<h3 id="allow-specific-domains">235<h3 id="allow-specific-domains">

235 Разрешение определённых доменов236 Разрешить определённые домены

236</h3>237</h3>

237 238

238Чтобы разрешить домены, которые не находятся в списке Trusted, выберите **Custom** в параметрах доступа в сеть среды, затем перечислите один домен на строку в поле **Allowed domains**. Этот пример разрешает три хоста, которые может потребоваться внутреннему проекту.239Чтобы разрешить домены, которых нет в списке Trusted, выберите **Custom** в параметрах сетевого доступа среды, затем перечислите один домен в строке в поле **Allowed domains**. Этот пример разрешает три хоста, которые может потребоваться внутреннему проекту.

239 240

240```text theme={null}241```text theme={null}

241api.example.com242api.example.com

243registry.example.com244registry.example.com

244```245```

245 246

246Сеансы в этой среде теперь могут достичь `api.example.com`, любого поддомена `internal.example.com` и `registry.example.com`, и никаких других доменов через сеть сеанса. [Трафик GitHub](#github-proxy), [трафик соединителя MCP](#network-access) и запросы к хостам [учётных данных API](#add-api-credentials) среды, кроме [хостов, которые никогда не получают учётные данные](#requests-that-never-get-the-credential), не проходят через этот список разрешений. Ведущий `*.` соответствует каждому поддомену. Чтобы сохранить [доверенные домены](#default-allowed-domains) тоже, отметьте **Also include default list of common package managers**; оставьте его без отметки, чтобы разрешить только то, что вы перечислили.247Сеансы в этой среде теперь могут достичь `api.example.com`, любого поддомена `internal.example.com` и `registry.example.com`, и никаких других доменов через сеть сеанса. [Трафик GitHub](#github-proxy), [трафик соединителя MCP](#network-access) и запросы к хостам [учётных данных API](#add-api-credentials) среды, кроме [хостов, которые никогда не получают учётные данные](#requests-that-never-get-the-credential), не проходят через этот список разрешённых. Ведущий `*.` соответствует каждому поддомену. Чтобы сохранить [домены Trusted](#default-allowed-domains) также, установите флажок **Also include default list of common package managers**; оставьте его без флажка, чтобы разрешить только то, что вы указали.

247 248

248Если ваша организация использует [артефакты](/docs/ru/artifacts#availability), вам не нужен `*.frame.claudeusercontent.com` в списке для сеансов, чтобы их читать. Когда список оставляет этот хост, Claude Code читает содержимое артефакта через соединение сеанса с Anthropic вместо этого. Сохраняйте хост в списке разрешений в двух ситуациях:249Если ваша организация использует [артефакты](/docs/ru/artifacts#availability), вам не нужно добавлять `*.frame.claudeusercontent.com` в список, чтобы сеансы могли их читать. Когда список исключает этот хост, Claude Code читает содержимое артефакта через соединение сеанса с Anthropic. Сохраняйте хост в списке разрешённых в двух ситуациях:

249 250

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

251* **Вы настраиваете локальный CLI или самостоятельно размещённый runner**: сохраняйте хост в этом списке разрешений. Смотрите [требования доступа в сеть](/docs/ru/network-config#network-access-requirements) и самостоятельно размещённые [требования к сети](/docs/ru/self-hosted-environments-deploy#network-requirements).252* **Вы настраиваете локальный CLI или самостоятельно размещённый runner**: сохраняйте хост в этом списке разрешённых. См. [требования к сетевому доступу](/docs/ru/network-config#network-access-requirements) и требования к сетевому доступу самостоятельно размещённого [сетевые требования](/docs/ru/self-hosted-environments-deploy#network-requirements).

252 253

253Каждая среда имеет свой собственный список разрешённых доменов; нет организационного списка разрешений, который администраторы могут отправить в среды каждого члена. [Параметры, управляемые сервером](/docs/ru/server-managed-settings) всё ещё применяются внутри облачных сеансов, но ни один из них не добавляет домены в список разрешений доступа в сеть среды. Чтобы дать команде один стандартный список, владелец может создать [общую для организации среду](#organization-shared-environments) с **Custom** доступом в сеть и этим списком.254Каждая среда имеет свой собственный список разрешённых доменов; нет списка разрешённых на уровне организации, который администраторы могут применить к средам каждого члена. Никакой [параметр, управляемый сервером](/docs/ru/server-managed-settings), не добавляет домены в список разрешённых сетей среды. Чтобы дать команде один стандартный список, владелец может создать [общую среду организации](#organization-shared-environments) с сетевым доступом **Custom** и этим списком.

254 255

255<h3 id="github-proxy">256<h3 id="github-proxy">

256 GitHub прокси257 Прокси GitHub

257</h3>258</h3>

258 259

259В среде, размещённой Anthropic, все операции GitHub проходят через выделенный прокси, который держит ваши реальные учётные данные GitHub вне виртуальной машины сеанса, независимо от [уровня доступа](#access-levels) среды. Сеансы в самостоятельно размещённой среде аутентифицируют операции git с учётными данными, которые предоставляет ваше развёртывание; [Настройка git](/docs/ru/self-hosted-environments-deploy#configure-git) охватывает опции, включая выданные для каждого сеанса учётные данные и согласие на использование этого же прокси. Прокси предоставляет:260В средах, размещённых в Anthropic, все операции GitHub проходят через выделенный прокси, который держит ваши реальные учётные данные GitHub вне виртуальной машины сеанса, независимо от [уровня доступа](#access-levels) среды. Сеансы в самостоятельно размещённой среде аутентифицируют операции git с учётными данными, которые предоставляет ваше развёртывание; [Настройка git](/docs/ru/self-hosted-environments-deploy#configure-git) охватывает варианты, включая выданные для каждого сеанса учётные данные и согласие на использование этого же прокси. Прокси предоставляет:

260 261

261* **Git учётные данные**: git-клиент внутри виртуальной машины использует ограниченные учётные данные, которые прокси проверяет и обменивает на ваш фактический токен GitHub.262* **Учётные данные Git**: git-клиент внутри виртуальной машины использует ограниченные учётные данные, которые прокси проверяет и заменяет на ваш реальный токен GitHub.

262* **Запросы API**: запросы от встроенных инструментов GitHub и от `gh` под [заполнителем `proxy-injected`](#work-with-github-issues-and-pull-requests) выходят с подставленными вашими реальными учётными данными.263* **Запросы API**: запросы от встроенных инструментов GitHub и от `gh` под [заполнителем `proxy-injected`](#work-with-github-issues-and-pull-requests) отправляются с подставленными вашими реальными учётными данными.

263* **Защита от отправки**: `git push` работает только для текущей рабочей ветви сеанса; клонирование, получение и операции PR работают нормально.264* **Защита от отправки**: `git push` работает только для текущей рабочей ветви сеанса; клонирование, получение и операции PR работают нормально.

264* **Область репозитория**: API GitHub и запросы активов выпуска достигают только репозиториев, прикреплённых к сеансу, поэтому скрипт установки, который загружает активы выпуска из неприкреплённого репозитория, получает 403.265* **Область репозитория**: запросы GitHub API и запросы активов выпуска достигают только репозиториев, прикреплённых к сеансу, поэтому скрипт установки, который загружает активы выпуска из неприкреплённого репозитория, получает 403.

265* **Ограничения GraphQL**: прокси служит только закреплённому набору операций GraphQL для рабочих процессов запросов на слияние. Прокси отклоняет всё остальное на конечной точке GraphQL с 403, который говорит `This GraphQL query is not enabled for this session` и называет резервный вариант REST, `gh api repos/{owner}/{repo}/...`. Ограничение применяется к каждому запросу через прокси независимо от учётных данных, которые вы предоставляете, поэтому `GH_TOKEN`, который вы устанавливаете, получает тот же 403. Claude не может достичь API GitHub, которые существуют только в GraphQL, такие как Projects v2, через прокси.266* **Ограничения GraphQL**: прокси обслуживает только закреплённый набор операций GraphQL для рабочих процессов pull-request. Прокси отклоняет всё остальное на конечной точке GraphQL с 403, который говорит `This GraphQL query is not enabled for this session` и называет резервный вариант REST, `gh api repos/{owner}/{repo}/...`. Ограничение применяется к каждому запросу через прокси независимо от предоставленных вами учётных данных, поэтому установленный вами `GH_TOKEN` получает тот же 403. Claude не может достичь API GitHub, которые существуют только в GraphQL, таких как Projects v2, через прокси.

266 267

267Зафиксированные файлы из общедоступных репозиториев поступают через `raw.githubusercontent.com`, который [прокси безопасности](#security-proxy) обрабатывает вместо этого. Этот домен находится в списке [Trusted](#default-allowed-domains) по умолчанию, поэтому эти файлы остаются доступными, если [уровень доступа](#access-levels) среды их не исключает.268Зафиксированные файлы из публичных репозиториев поступают через `raw.githubusercontent.com`, который обрабатывает [прокси безопасности](#security-proxy). Этот домен находится в списке [Trusted](#default-allowed-domains) по умолчанию, поэтому эти файлы остаются доступными, если [уровень доступа](#access-levels) среды их не исключает.

268 269

269<h3 id="security-proxy">270<h3 id="security-proxy">

270 Прокси безопасности271 Прокси безопасности

271</h3>272</h3>

272 273

273Облачные сеансы в среде, размещённой Anthropic, работают за HTTP/HTTPS сетевым прокси в целях безопасности и предотвращения злоупотреблений; в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments-deploy#default-deny-egress) исходящий трафик выходит через вашу собственную границу сети вместо этого. Весь исходящий интернет-трафик из сеанса, размещённого Anthropic, проходит через этот прокси, который обеспечивает:274Облачные сеансы в средах, размещённых в Anthropic, работают за HTTP/HTTPS сетевым прокси в целях безопасности и предотвращения злоупотреблений; в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments-deploy#default-deny-egress) исходящий трафик проходит через вашу собственную границу сети. Весь исходящий интернет-трафик из сеанса, размещённого в Anthropic, проходит через этот прокси, который предоставляет:

274 275

275* Защиту от вредоносных запросов276* Защиту от вредоносных запросов

276* Ограничение скорости и предотвращение злоупотреблений277* Ограничение скорости и предотвращение злоупотреблений

277* Фильтрацию контента для повышенной безопасности278* Фильтрацию содержимого для повышенной безопасности

278* Журнал аудита на уровне DNS запрошенных имён хостов279* Журнал аудита на уровне DNS запрошенных имён хостов

279 280

280<h2 id="what’s-available-in-cloud-sessions">281<h2 id="what’s-available-in-cloud-sessions">

281 Что доступно в облачных сеансах282 Что доступно в облачных сеансах

282</h2>283</h2>

283 284

284В среде, размещённой Anthropic, каждый сеанс получает свежую виртуальную машину (VM) под управлением Ubuntu 24.04 на x86\_64, независимо от вашей собственной операционной системы и архитектуры CPU, с клонированным репозиторием и предустановленными общими цепочками инструментов. Когда зависимость предоставляет предкомпилированные двоичные файлы, такие как Ruby gems с собственными расширениями или предварительно построенные колёса Python, используйте его сборку x86\_64 Linux, чтобы соответствовать VM. Этот раздел охватывает значения по умолчанию, размещённые Anthropic, встроенные инструменты GitHub, как [запускать тесты и сервисы](#run-tests-start-services-and-add-packages), и [ограничения ресурсов](#resource-limits), которые получает каждая VM.285В среде, размещённой Anthropic, каждый сеанс получает свежую виртуальную машину (VM) под управлением Ubuntu 24.04 на x86\_64, независимо от вашей собственной операционной системы и архитектуры CPU, с клонированным репозиторием и предустановленными общими цепочками инструментов. Когда зависимость предоставляет предкомпилированные двоичные файлы, такие как Ruby gems с собственными расширениями или предварительно построенные колёса Python, используйте его сборку x86\_64 Linux, чтобы соответствовать VM. Этот раздел охватывает значения по умолчанию, размещённые Anthropic, встроенные инструменты GitHub, как [запускать тесты и сервисы](#run-tests-start-services-and-add-packages), [ограничения ресурсов](#resource-limits), которые получает каждая VM, и [ограничения времени](#time-limits) на долгоживущую работу.

285 286

286<Note>287<Note>

287 Сеансы, которые ваша организация маршрутизирует в [самостоятельно размещённую среду](/docs/ru/self-hosted-environments), работают на ваших собственных runners вместо этого, с инструментами, которые предоставляет образ вашего runner.288 Сеансы, которые ваша организация маршрутизирует в [самостоятельно размещённую среду](/docs/ru/self-hosted-environments), работают на ваших собственных runners вместо этого, с инструментами, которые предоставляет образ вашего runner.

301| Ваши репозитория `.claude/rules/` | Да | Часть клона |302| Ваши репозитория `.claude/rules/` | Да | Часть клона |

302| Ваши репозитория `.claude/skills/`, `.claude/agents/`, `.claude/commands/` | Да | Часть клона |303| Ваши репозитория `.claude/skills/`, `.claude/agents/`, `.claude/commands/` | Да | Часть клона |

303| Плагины и marketplaces, объявленные в `.claude/settings.json` вашего репозитория | Нет | Облачный сеанс не устанавливает плагины, которые репозиторий включает в [`enabledPlugins`](/docs/ru/settings-reference#enabledplugins), включая те из marketplaces, которые он перечисляет в [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces) |304| Плагины и marketplaces, объявленные в `.claude/settings.json` вашего репозитория | Нет | Облачный сеанс не устанавливает плагины, которые репозиторий включает в [`enabledPlugins`](/docs/ru/settings-reference#enabledplugins), включая те из marketplaces, которые он перечисляет в [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces) |

304| [Параметры, управляемые сервером](/docs/ru/server-managed-settings) вашей организации | Да | Получены с серверов Anthropic при запуске сеанса. Смотрите [Охват поверхности](/docs/ru/model-config#surface-coverage) для того, как `availableModels` применяется в облачных сеансах. Параметры, развёрнутые на вашем устройстве через MDM или файлы управляемых параметров, не применяются, потому что сеанс работает на управляемой Anthropic виртуальной машине; в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments) сеансы также читают файл управляемых параметров в образе runner, согласно [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) |305| [Параметры, управляемые сервером](/docs/ru/server-managed-settings) вашей организации | Да, кроме в сеансах [Claude Tag](https://claude.com/docs/claude-tag/overview) | Получены с серверов Anthropic при запуске сеанса. Смотрите [Охват поверхности](/docs/ru/model-config#surface-coverage) для того, как `availableModels` применяется в облачных сеансах. Параметры, развёрнутые на вашем устройстве через MDM или файлы управляемых параметров, не применяются, потому что сеанс работает на управляемой Anthropic виртуальной машине; в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments) сеансы также читают файл управляемых параметров в образе runner, согласно [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) |

305| Ваш пользовательский `~/.claude/CLAUDE.md` | Нет | Находится на вашей машине, не в репозитории |306| Ваш пользовательский `~/.claude/CLAUDE.md` | Нет | Находится на вашей машине, не в репозитории |

306| Ваши пользовательские `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | Нет | Находятся на вашей машине, не в репозитории. Зафиксируйте их в каталоге `.claude/` репозитория вместо этого. Облачные сеансы автоматически загружают skills, которые вы включаете на claude.ai |307| Ваши пользовательские `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | Нет | Находятся на вашей машине, не в репозитории. Зафиксируйте их в каталоге `.claude/` репозитория вместо этого. Облачные сеансы автоматически загружают skills, которые вы включаете на claude.ai |

307| Плагины, включённые только в ваши пользовательские параметры | Нет | Пользовательский `enabledPlugins` находится в `~/.claude/settings.json` на вашей машине |308| Плагины, включённые только в ваши пользовательские параметры | Нет | Пользовательский `enabledPlugins` находится в `~/.claude/settings.json` на вашей машине |

421 422

422Виртуальная машина может остановить задачи, которые требуют значительно больше памяти, такие как большие работы сборки или тесты, требующие много памяти. Для рабочих нагрузок, превышающих эти ограничения, используйте [Remote Control](/docs/ru/remote-control), чтобы запустить Claude Code на вашем собственном оборудовании, или запустите облачные сеансы в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments) на вычислениях, которые работает ваша организация.423Виртуальная машина может остановить задачи, которые требуют значительно больше памяти, такие как большие работы сборки или тесты, требующие много памяти. Для рабочих нагрузок, превышающих эти ограничения, используйте [Remote Control](/docs/ru/remote-control), чтобы запустить Claude Code на вашем собственном оборудовании, или запустите облачные сеансы в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments) на вычислениях, которые работает ваша организация.

423 424

425<h3 id="time-limits">

426 Ограничения времени

427</h3>

428

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

430

431* **Команды, которые запускает Claude**: облачная среда не устанавливает свой собственный timeout команды, поэтому применяются значения по умолчанию инструмента Bash. Claude ждёт команду 2 минуты по умолчанию и может запросить до 10 минут. Когда команда достигает своего [timeout](/docs/ru/tools-reference#timeout-and-output-limits), Claude Code [перемещает её в фон](/docs/ru/tools-reference#background-commands) вместо того, чтобы остановить её, если только команда не начинается с `sleep`.

432* **SessionStart hooks**: Claude Code отменяет hook `command` после 600 секунд, если вы не установите [`timeout`](/docs/ru/hooks#common-fields), в секундах, на запись hook. Claude Code не применяет timeout на hook, который вы запускаете с [`async: true`](/docs/ru/hooks#run-hooks-in-the-background).

433* **Setup script**: скрипт, который занимает больше примерно пяти минут, не кэшируется. [Требования скрипта](#script-requirements) охватывает, как оставаться ниже этого.

434* **Idle sessions**: сеанс останавливается после периода неактивности и его VM восстанавливается. [Environment expired](/docs/ru/claude-code-on-the-web#environment-expired) охватывает, что считается неактивным и как повторно открыть сеанс.

435

436Чтобы повысить timeouts команд для сеансов среды, добавьте [`BASH_DEFAULT_TIMEOUT_MS` и `BASH_MAX_TIMEOUT_MS`](/docs/ru/env-vars#variables) в её [переменные среды](#set-environment-variables). Оба принимают миллисекунды. Например, `BASH_DEFAULT_TIMEOUT_MS=600000` делает 10 минут значением по умолчанию.

437

424<h2 id="setup-scripts">438<h2 id="setup-scripts">

425 Скрипты установки439 Скрипты установки

426</h2>440</h2>

445Скрипт установки имеет три ограничения для работы:459Скрипт установки имеет три ограничения для работы:

446 460

447* **Выход с нулём**: если скрипт выходит с ненулевым значением, сеанс не запускается. Добавьте `|| true` к некритичным командам, чтобы перебой установки не блокировал сеанс.461* **Выход с нулём**: если скрипт выходит с ненулевым значением, сеанс не запускается. Добавьте `|| true` к некритичным командам, чтобы перебой установки не блокировал сеанс.

448* **Завершение в течение пяти минут**: держите общее время выполнения скрипта примерно под пять минут, чтобы [кэш среды](#environment-caching) мог построиться. Запускайте независимые установки параллельно с `&` и `wait`, и переместите любую одиночную загрузку, которая не подходит, в [hook SessionStart](#setup-scripts-vs-sessionstart-hooks), который запускает её в фоне.462* **Завершение в течение пяти минут**: держите общее время выполнения скрипта примерно под пять минут, чтобы [кэш среды](#environment-caching) мог построиться. Когда установка занимает больше времени, среда не кэшируется. Запускайте независимые установки параллельно с `&` и `wait`, и переместите любую одиночную загрузку, которая не подходит, в [SessionStart hook](#setup-scripts-vs-sessionstart-hooks), который запускает её в фоне. Если новые сеансы зависают или не удаются во время установки, смотрите [New sessions hang or time out during setup](/docs/ru/web-quickstart#new-sessions-hang-or-time-out-during-setup).

449* **Сетевой доступ для установок**: установки пакетов должны достичь реестров. Уровень **Trusted** по умолчанию охватывает [общие реестры пакетов](#default-allowed-domains), включая npm, PyPI, RubyGems и crates.io; с **None** сетевым доступом установки не удаются.463* **Сетевой доступ для установок**: установки пакетов должны достичь реестров. Уровень **Trusted** по умолчанию охватывает [общие реестры пакетов](#default-allowed-domains), включая npm, PyPI, RubyGems и crates.io; с **None** сетевым доступом установки не удаются.

450 464

451<h3 id="environment-caching">465<h3 id="environment-caching">

452 Кэширование среды466 Кэширование среды

453</h3>467</h3>

454 468

455Скрипт установки запускается в первый раз, когда вы запускаете сеанс в среде. После его завершения Anthropic создаёт снимок файловой системы и повторно использует этот снимок как начальную точку для более поздних сеансов. Новые сеансы начинаются с ваших зависимостей, инструментов и образов Docker уже на диске и пропускают шаг скрипта установки. Это держит запуск быстрым, даже когда скрипт устанавливает большие цепочки инструментов или получает образы контейнеров.469Скрипт установки запускается в первый раз, когда вы запускаете сеанс в среде. Когда установка завершается в течение [примерно пяти минут](#script-requirements), Anthropic создаёт снимок файловой системы и повторно использует этот снимок как начальную точку для более поздних сеансов. Новые сеансы начинаются с ваших зависимостей, инструментов и образов Docker уже на диске и пропускают шаг скрипта установки. Это держит запуск быстрым, даже когда скрипт устанавливает большие цепочки инструментов или получает образы контейнеров. Если установка занимает больше времени, чем примерно пять минут, среда не кэшируется.

456 470

457Кэш — это снимок файловой системы, поэтому он сохраняет то, что скрипт установки пишет на диск, и теряет всё, что было только работающим. Пакеты, которые вы устанавливаете, образы Docker, которые вы получаете, и файлы, которые вы пишете, все переносятся. База данных, которую запустил скрипт, стек `docker compose up` или любой другой фоновый процесс не переносятся; запускайте их для каждого сеанса, попросив Claude или с помощью [hook SessionStart](#setup-scripts-vs-sessionstart-hooks).471Кэш — это снимок файловой системы, поэтому он сохраняет то, что скрипт установки пишет на диск, и теряет всё, что было только работающим. Пакеты, которые вы устанавливаете, образы Docker, которые вы получаете, и файлы, которые вы пишете, все переносятся. База данных, которую запустил скрипт, стек `docker compose up` или любой другой фоновый процесс не переносятся; запускайте их для каждого сеанса, попросив Claude или с помощью [hook SessionStart](#setup-scripts-vs-sessionstart-hooks).

458 472

476 490

477Если у вас есть hooks SessionStart в вашем пользовательском `~/.claude/settings.json`, не ожидайте их в облаке: пользовательские параметры остаются на вашей машине. Какие другие hooks запускаются, зависит от того, где работает сеанс:491Если у вас есть hooks SessionStart в вашем пользовательском `~/.claude/settings.json`, не ожидайте их в облаке: пользовательские параметры остаются на вашей машине. Какие другие hooks запускаются, зависит от того, где работает сеанс:

478 492

479* **Среда, размещённая Anthropic**: Claude Code запускает hooks из репозитория и из [параметров, управляемых сервером](/docs/ru/server-managed-settings) вашей организации.493* **Среда, размещённая Anthropic**: Claude Code запускает hooks из репозитория и из [параметров, управляемых сервером](/docs/ru/server-managed-settings) вашей организации. Сеансы [Claude Tag](https://claude.com/docs/claude-tag/overview) не получают параметры, управляемые сервером, поэтому hooks из параметров, управляемых сервером, не запускаются там.

480* **[Самостоятельно размещённая среда](/docs/ru/self-hosted-environments-configuration#permissions-and-tool-approval)**: Claude Code также запускает hooks, которые оператор посеял из `~/.claude/` хоста runner, и hooks в файле управляемых параметров образа runner, когда этот файл является одним из [управляемых источников, которые применяет Claude Code](/docs/ru/managed-settings#how-claude-code-combines-managed-sources).494* **[Самостоятельно размещённая среда](/docs/ru/self-hosted-environments-configuration#permissions-and-tool-approval)**: Claude Code также запускает hooks, которые оператор посеял из `~/.claude/` хоста runner, и hooks в файле управляемых параметров образа runner, когда этот файл является одним из [управляемых источников, которые применяет Claude Code](/docs/ru/managed-settings#how-claude-code-combines-managed-sources).

481 495

482<h3 id="install-dependencies-with-a-sessionstart-hook">496<h3 id="install-dependencies-with-a-sessionstart-hook">

code-review.md +3 −3

Details

48| 🟡 | Nit | Незначительная проблема, стоит исправить, но не блокирует |48| 🟡 | Nit | Незначительная проблема, стоит исправить, но не блокирует |

49| 🟣 | Pre-existing | Ошибка, которая существует в кодовой базе, но не была введена этим PR |49| 🟣 | Pre-existing | Ошибка, которая существует в кодовой базе, но не была введена этим PR |

50 50

51Результаты включают свёртываемый раздел расширенного рассуждения, который вы можете развернуть, чтобы понять, почему Claude пометил проблему и как она проверила проблему.51Результаты включают свёртываемый раздел **Why this was flagged**, который вы можете развернуть, чтобы понять, почему Claude пометил проблему и как она проверила проблему.

52 52

53<h3 id="rate-and-reply-to-findings">53<h3 id="rate-and-reply-to-findings">

54 Оценка и ответ на результаты54 Оценка и ответ на результаты

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

300</h2>300</h2>

301 301

302Запуски проверок выполняются по принципу best-effort. Сбой запуска никогда не блокирует ваш PR, но он также не повторяется автоматически. Этот раздел охватывает, как восстановиться после сбоя запуска и где искать, когда проверка сообщает о проблемах, которые вы не можете найти.302Запуски проверок выполняются по принципу best-effort, и сбой запуска никогда не блокирует ваш PR. Code Review автоматически повторяет некоторые прерванные проверки. Этот раздел охватывает, как запустить проверку снова самостоятельно и где искать, когда проверка сообщает о проблемах, которые вы не можете найти.

303 303

304<h3 id="retrigger-a-failed-or-timed-out-review">304<h3 id="retrigger-a-failed-or-timed-out-review">

305 Повторный запуск сбойной или истёкшей по времени проверки305 Повторный запуск сбойной или истёкшей по времени проверки

306</h3>306</h3>

307 307

308Когда инфраструктура проверки сталкивается с внутренней ошибкой или превышает лимит времени, проверка завершается с названием **Code review encountered an error** или **Code review timed out**. Вывод по-прежнему нейтральный, поэтому ничто не блокирует ваше слияние, но результаты не публикуются.308Когда проверка сбивается или превышает лимит времени, проверка завершается с названием, таким как **Code review failed** или **Code review timed out**. Вывод по-прежнему нейтральный, поэтому ничто не блокирует ваше слияние. Если сводка проверки не говорит, что новая проверка коммита была автоматически поставлена в очередь, запустите проверку снова самостоятельно.

309 309

310Чтобы запустить проверку снова, прокомментируйте `@claude review` на PR. Это запускает свежую проверку без подписки PR на будущие push. Если PR не [из форка](#review-pull-requests-from-forks), вы можете вместо этого нажать **Re-run** на проверке **Claude Code Review** на вкладке Checks в GitHub. Повторный запуск также запускает свежую проверку без подписки PR.310Чтобы запустить проверку снова, прокомментируйте `@claude review` на PR. Это запускает свежую проверку без подписки PR на будущие push. Если PR не [из форка](#review-pull-requests-from-forks), вы можете вместо этого нажать **Re-run** на проверке **Claude Code Review** на вкладке Checks в GitHub. Повторный запуск также запускает свежую проверку без подписки PR.

311 311

commands.md +94 −93

Details

39В таблице ниже перечислены все команды, включённые в Claude Code. Большинство из них — встроенные команды, поведение которых закодировано в CLI. Два типа записей отмечены:39В таблице ниже перечислены все команды, включённые в Claude Code. Большинство из них — встроенные команды, поведение которых закодировано в CLI. Два типа записей отмечены:

40 40

41* **[Skill](/docs/ru/skills#bundled-skills)**: встроенный skill. Он работает как skills, которые вы пишете сами: подсказка, переданная Claude.41* **[Skill](/docs/ru/skills#bundled-skills)**: встроенный skill. Он работает как skills, которые вы пишете сами: подсказка, переданная Claude.

~~42 * `/verify` запускается только при вызове. До версии 2.1.215 Claude также мог запускать `/verify` самостоятельно.~~42 * `/verify` запускается только при вызове. До версии 2.1.215 Claude мог также запускать `/verify` самостоятельно.

43* **[Workflow](/docs/ru/workflows#bundled-workflows)**: встроенный [динамический workflow](/docs/ru/workflows), который распределяет работу между множеством подагентов и выполняется в фоновом режиме.43* **[Workflow](/docs/ru/workflows#bundled-workflows)**: встроенный [динамический workflow](/docs/ru/workflows), который распределяет работу между множеством подагентов и выполняется в фоне.

~~44 * `/deep-research` запускается только при вызове. До версии 2.1.218 Claude также мог запускать его самостоятельно.~~44 * `/deep-research` запускается только при вызове. До версии 2.1.218 Claude мог также запускать его самостоятельно.

45 45

~~46Чтобы добавить свои собственные команды, см. [skills](/docs/ru/skills).~~46Чтобы добавить свои команды, см. [skills](/docs/ru/skills).

47 47

48В таблице ниже `<arg>` обозначает обязательный аргумент, а `[arg]` обозначает необязательный.48В таблице ниже `<arg>` обозначает обязательный аргумент, а `[arg]` обозначает необязательный.

49 49

53 53

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

55| :- | :- |55| :- | :- |

56| `/add-dir <path>` | Добавить рабочий каталог для доступа к файлам во время текущего сеанса. Введите частичный путь, чтобы увидеть предложения соответствующих каталогов; нажмите `Tab` для принятия. Большинство конфигурации `.claude/` [не обнаруживается](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) из добавленного каталога. Вы не можете добавить большинство [сетевых путей](/docs/ru/errors#working-directory-is-a-network-path), таких как `\\server\share`. После успешного добавления выполняются ваши [`DirectoryAdded` hooks](/docs/ru/hooks#directoryadded). Когда вы запускаете её во время ответа Claude, Claude Code просит вас подтвердить каталог сразу же, и после подтверждения следующий вызов инструмента Claude в этом же ходу может получить доступ к нему. До версии 2.1.234 Claude Code ставил команду в очередь до завершения хода |56| `/add-dir <path>` | Добавить рабочий каталог для доступа к файлам во время текущей сессии. Введите частичный путь, чтобы увидеть предложения соответствующих каталогов; нажмите `Tab` для принятия. Большинство конфигурации `.claude/` [не обнаруживается](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) из добавленного каталога. Вы не можете добавить большинство [сетевых путей](/docs/ru/errors#working-directory-is-a-network-path), таких как `\\server\share`. После успешного добавления запускаются ваши [`DirectoryAdded` hooks](/docs/ru/hooks#directoryadded). Когда вы запускаете команду во время ответа Claude, Claude Code просит вас подтвердить каталог сразу же, и после подтверждения следующий вызов инструмента Claude в этом же ходу может получить доступ к нему. До версии 2.1.234 Claude Code ставил команду в очередь до завершения хода |

57| `/advisor [model\|off]` | Включить или отключить [инструмент advisor](/docs/ru/advisor), который консультирует вторую модель для получения рекомендаций в ключевые моменты выполнения задачи. Принимает `fable`, `opus`, `sonnet` или полный ID модели. `fable` требует [доступ к Fable](/docs/ru/advisor#choose-an-advisor-model). Без аргумента открывает средство выбора. В сеансе без интерактивного терминала или через [Remote Control](/docs/ru/remote-control#limitations), передайте модель или `off` как аргумент; без аргумента команда выводит текущий advisor как текст. Эти формы требуют Claude Code версии 2.1.260 или позже |57| `/advisor [model\|off]` | Включить или отключить [инструмент advisor](/docs/ru/advisor), который консультирует вторую модель для получения рекомендаций в ключевые моменты задачи. Принимает `fable`, `opus`, `sonnet` или полный ID модели. `fable` требует [доступ к Fable](/docs/ru/advisor#choose-an-advisor-model). Без аргумента открывает средство выбора. В сессии без интерактивного терминала или через [Remote Control](/docs/ru/remote-control#limitations), передайте модель или `off` как аргумент; без аргумента команда выводит текущий advisor как текст. Эти формы требуют Claude Code v2.1.260 или позже |

58| `/agents` | Начиная с версии 2.1.198, запуск `/agents` выводит напоминание попросить Claude создать или управлять [подагентами](/docs/ru/sub-agents), или отредактировать `.claude/agents/` или `~/.claude/agents/` напрямую. На версии 2.1.197 и ранее открывает интерактивный интерфейс для создания и управления конфигурациями подагентов |58| `/agents` | Начиная с версии 2.1.198, запуск `/agents` выводит напоминание попросить Claude создать или управлять [подагентами](/docs/ru/sub-agents), или отредактировать `.claude/agents/` или `~/.claude/agents/` напрямую. На версии 2.1.197 и ранее открывает интерактивный интерфейс для создания и управления конфигурациями подагентов |

59| `/artifacts` | Список [артефактов](/docs/ru/artifacts#find-an-artifact-again), которыми вы владеете или которые с вами поделены, затем прикрепить один к сеансу, открыть его в браузере или скопировать его ссылку. Доступно где [артефакты](/docs/ru/artifacts#availability) есть. Требует Claude Code версии 2.1.208 или позже; прикрепление с помощью `Enter` требует версии 2.1.216 |59| `/artifacts` | Список [артефактов](/docs/ru/artifacts#find-an-artifact-again), которыми вы владеете или которые с вами поделены, затем прикрепить один к сессии, открыть его в браузере или скопировать его ссылку. Доступно где [артефакты](/docs/ru/artifacts#availability) есть. Требует Claude Code v2.1.208 или позже; прикрепление с `Enter` требует v2.1.216 |

60| `/auto-mode-setup` | [Составить записи `autoMode.environment`](/docs/ru/auto-mode-config#generate-environment-entries) из вашего проекта и недавних сеансов, затем просмотреть черновик и сохранить его в пользовательские параметры. Требует план Pro, Max или Team и Claude Code версии 2.1.228 или позже. На нативной Windows требует версии 2.1.233 или позже |60| `/auto-mode-setup` | [Составить записи `autoMode.environment`](/docs/ru/auto-mode-config#generate-environment-entries) из вашего проекта и недавних сессий, затем просмотреть черновик и сохранить его в пользовательские настройки. Требует план Pro, Max или Team и Claude Code v2.1.228 или позже. На нативном Windows требует v2.1.233 или позже |

61| `/autocompact [auto\|<tokens>]` | Установить окно auto-compact: насколько полным становится контекстное окно перед автоматической компактификацией Claude Code. Передайте размер, такой как `500k`, или `auto` для возврата к окну, настроенному для вашей модели. Claude Code сохраняет значение в пользовательские параметры и применяет его к текущему сеансу. См. [Установить окно auto-compact](/docs/ru/model-config#set-the-auto-compact-window) для принимаемых значений и того, что его переопределяет. Без аргумента открывает диалог, показывающий текущее окно. Требует Claude Code версии 2.1.221 или позже |61| `/autocompact [auto\|<tokens>]` | Установить окно auto-compact: насколько полным становится контекстное окно перед автоматическим сжатием Claude Code. Передайте размер, такой как `500k`, или `auto` для возврата к окну, настроенному для вашей модели. Claude Code сохраняет значение в пользовательские настройки и применяет его к текущей сессии. См. [Установить окно auto-compact](/docs/ru/model-config#set-the-auto-compact-window) для принимаемых значений и того, что его переопределяет. Без аргумента открывает диалог, показывающий текущее окно. Требует Claude Code v2.1.221 или позже |

62| `/autofix-pr [prompt]` | Запустить сеанс [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web#auto-fix-pull-requests), который отслеживает PR текущей ветки и отправляет исправления при сбое CI или комментариях рецензентов. Обнаруживает открытый PR из вашей текущей ветки с помощью `gh pr view`; чтобы отслеживать другой PR, сначала переключитесь на его ветку. По умолчанию облачному сеансу сообщается исправить каждый сбой CI и комментарий рецензента; передайте подсказку, чтобы дать ему другие инструкции, например `/autofix-pr only fix lint and type errors`. Требует CLI `gh` и доступ к [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) |62| `/autofix-pr [prompt]` | Запустить [облачную сессию](/docs/ru/claude-code-on-the-web#auto-fix-pull-requests), которая отслеживает PR текущей ветки и отправляет исправления при сбое CI или комментариях рецензентов. Обнаруживает открытый PR из вашей проверенной ветки с помощью `gh pr view`; чтобы отслеживать другой PR, сначала проверьте его ветку. По умолчанию облачной сессии сказано исправлять каждый сбой CI и комментарий рецензента; передайте подсказку, чтобы дать ей другие инструкции, например `/autofix-pr only fix lint and type errors`. Требует CLI `gh` и доступ к [облачным сессиям](/docs/ru/claude-code-on-the-web) |

63| `/background [prompt]` | Отсоединить текущий сеанс для запуска как [фоновый агент](/docs/ru/agent-view) и освободить этот терминал. Передайте подсказку, чтобы отправить ещё одну инструкцию перед отсоединением. Отслеживайте сеанс с помощью `claude agents`. Чтобы скопировать разговор в новый фоновый сеанс, пока этот продолжает работать, используйте `/fork`. Псевдоним: `/bg` |63| `/background [prompt]` | Отсоединить текущую сессию для запуска как [фоновый агент](/docs/ru/agent-view) и освободить этот терминал. Передайте подсказку для отправки ещё одной инструкции перед отсоединением. Мониторьте сессию с помощью `claude agents`. Чтобы скопировать разговор в новую фоновую сессию, пока эта продолжает работать, используйте `/fork`. Псевдоним: `/bg` |

64| `/batch <instruction>` | **[Skill](/docs/ru/skills#bundled-skills).** Организовать крупномасштабные изменения по всей кодовой базе параллельно. Исследует кодовую базу, разбивает работу на 5–30 независимых единиц и представляет план. После одобрения запускает один [фоновый подагент](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) на единицу в изолированном [worktree](/docs/ru/worktrees). Каждый подагент реализует свою единицу, запускает тесты и публикует свои изменения. Требует git-репозиторий или [`WorktreeCreate` hook](/docs/ru/worktrees#non-git-version-control), который создаёт worktrees. Вне git-репозитория `/batch` требует Claude Code версии 2.1.281 или позже. Пример: `/batch migrate src/ from JavaScript to TypeScript` |64| `/batch <instruction>` | **[Skill](/docs/ru/skills#bundled-skills).** Организовать крупномасштабные изменения по всей кодовой базе параллельно. Исследует кодовую базу, разбивает работу на 5–30 независимых единиц и представляет план. После одобрения запускает один [фоновый подагент](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) на единицу в изолированном [worktree](/docs/ru/worktrees). Каждый подагент реализует свою единицу, запускает тесты и публикует своё изменение. Требует git-репозиторий или [`WorktreeCreate` hook](/docs/ru/worktrees#non-git-version-control), который создаёт worktrees. Вне git-репозитория `/batch` требует Claude Code v2.1.281 или позже. Пример: `/batch migrate src/ from JavaScript to TypeScript` |

65| `/branch [name]` | Создать ветку текущего разговора в этой точке, чтобы вы могли попробовать другое направление без потери разговора в его текущем состоянии. Переключает вас в ветку и сохраняет оригинал, к которому вы можете вернуться с помощью `/resume`. Чтобы запустить копию как отдельный [фоновый сеанс](/docs/ru/agent-view) вместо переключения в неё, используйте `/fork`; чтобы передать побочную задачу [подагенту](/docs/ru/sub-agents), который отчитывается обратно в этот разговор, используйте `/subtask` |65| `/branch [name]` | Создать ветку текущего разговора в этой точке, чтобы вы могли попробовать другое направление без потери разговора в его текущем состоянии. Переключает вас в ветку и сохраняет оригинал, к которому вы можете вернуться с помощью `/resume`. Чтобы запустить копию как отдельную [фоновую сессию](/docs/ru/agent-view) вместо переключения в неё, используйте `/fork`; чтобы передать побочную задачу [подагенту](/docs/ru/sub-agents), который отчитывается обратно в этот разговор, используйте `/subtask` |

66| `/btw [question]` | Задать [побочный вопрос](/docs/ru/interactive-mode#side-questions-with-%2Fbtw) о текущем сеансе без добавления в разговор. Если вы запустите `/btw` без вопроса, Claude Code показывает ваш самый последний побочный вопрос, чтобы вы могли просмотреть более ранние ответы; если вы ещё не задавали его, Claude Code выводит строку использования. До версии 2.1.212 `/btw` требовал вопрос |66| `/btw [question]` | Задать [побочный вопрос](/docs/ru/interactive-mode#side-questions-with-%2Fbtw) о текущей сессии без добавления в разговор. Если вы запустите `/btw` без вопроса, Claude Code показывает ваш самый последний побочный вопрос, чтобы вы могли просмотреть более ранние ответы; если вы ещё не задавали его, Claude Code выводит строку использования. До версии 2.1.212 `/btw` требовал вопрос |

67| `/bug [report]` | Сообщить об ошибке или поделиться своим разговором. Вы выбираете, сколько истории сеанса включить, и подтверждаете на экране согласия перед отправкой чего-либо. Когда вы вошли в Anthropic на первостороннем соединении, отчёт идёт в Anthropic; на стороннем поставщике или без учётных данных Anthropic, Claude Code записывает отчёт в [локальный архив под `~/.claude/feedback-bundles/`](/docs/ru/data-usage#telemetry-services), который вы пересылаете сами. В [расширении VS Code](/docs/ru/vs-code#use-the-prompt-box) `/bug` открывает собственный диалог обратной связи расширения; требует Claude Code версии 2.1.229 или позже. Когда вы запускаете её во время ответа Claude, Claude Code открывает диалог сразу же. До версии 2.1.232 Claude Code ставил команду в очередь до завершения хода. Псевдоним: `/share`. До версии 2.1.212 `/bug` и `/share` были псевдонимами `/feedback` |67| `/bug [report]` | Сообщить об ошибке или поделиться своим разговором. Вы выбираете, сколько истории сессии включить, и подтверждаете на экране согласия перед отправкой чего-либо. Когда вы вошли в Anthropic при подключении первой стороны, отчёт идёт в Anthropic; у поставщика третьей стороны или без учётных данных Anthropic Claude Code записывает отчёт в [локальный архив под `~/.claude/feedback-bundles/`](/docs/ru/data-usage#telemetry-services), который вы пересылаете сами. В [расширении VS Code](/docs/ru/vs-code#use-the-prompt-box) `/bug` открывает собственный диалог обратной связи расширения; требует Claude Code v2.1.229 или позже. Когда вы запускаете его во время ответа Claude, Claude Code открывает диалог сразу же. До версии 2.1.232 Claude Code ставил команду в очередь до завершения хода. Псевдоним: `/share`. До версии 2.1.212 `/bug` и `/share` были псевдонимами `/feedback` |

68| `/cd <path>` | Переместить этот сеанс в новый рабочий каталог, сохраняя разговор. Введите частичный путь, чтобы увидеть предложения соответствующих каталогов; нажмите `Tab` для принятия. Предложения требуют Claude Code версии 2.1.206 или позже. Для того, что Claude Code применяет из нового каталога сразу же при перемещении, и как `/cd` отличается от `/add-dir`, см. [Переместить сеанс в другой каталог](/docs/ru/permissions#move-the-session-to-another-directory) |68| `/cd <path>` | Переместить эту сессию в новый рабочий каталог, сохраняя разговор. Введите частичный путь, чтобы увидеть предложения соответствующих каталогов; нажмите `Tab` для принятия. Предложения требуют Claude Code v2.1.206 или позже. Для того, что Claude Code применяет из нового каталога сразу же при перемещении, и как `/cd` отличается от `/add-dir`, см. [Переместить сессию в другой каталог](/docs/ru/permissions#move-the-session-to-another-directory) |

69| `/chrome` | Настроить параметры [Claude в Chrome](/docs/ru/chrome) |69| `/chrome` | Настроить параметры [Claude в Chrome](/docs/ru/chrome) |

70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/ru/skills#bundled-skills).** Загрузить справочный материал [Claude API](https://platform.claude.com/docs/en/api/overview) и [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) для языка вашего проекта. Также активируется автоматически, когда ваш код импортирует `anthropic` или `@anthropic-ai/sdk`. Запустите `migrate` для обновления существующего кода Claude API на более новую модель. Запустите `upgrade` для перемещения зависимости Anthropic SDK вашего проекта через основную версию, в настоящее время пакет Python `anthropic` с 0.x на 1.x. Запустите `managed-agents-onboard` для пошагового руководства, которое создаёт нового Managed Agent. Запустите `prompt-audit` для отмечания инструкций, написанных для более старых моделей в ваших подсказках, skills и описаниях инструментов, и предложения исправлений как diff. Запустите `cost-optimize` для профилирования того, куда идут расходы Claude API вашего проекта, и предложения сбережений из опций, таких как prompt caching, обрезка ненужных входных и выходных токенов, пакетная обработка, усилие и выбор модели, по одному изменению за раз. Запустите `build-eval` для создания набора eval для вашего приложения на базе Claude, и `hillclimb` для итеративного улучшения приложения против существующего eval. Подкоманда `prompt-audit` требует Claude Code версии 2.1.221 или позже, `upgrade` требует версии 2.1.236 или позже, `cost-optimize` требует версии 2.1.247 или позже, а `build-eval` и `hillclimb` требуют версии 2.1.259 или позже |70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/ru/skills#bundled-skills).** Загрузить справочный материал [Claude API](https://platform.claude.com/docs/en/api/overview) и [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) для языка вашего проекта. Также активируется автоматически, когда ваш код импортирует `anthropic` или `@anthropic-ai/sdk`. Запустите `migrate` для обновления существующего кода Claude API на более новую модель. Запустите `upgrade` для перемещения зависимости Anthropic SDK вашего проекта через основную версию, в настоящее время пакет Python `anthropic` с 0.x на 1.x. Запустите `managed-agents-onboard` для пошагового руководства, которое создаёт нового Managed Agent. Запустите `prompt-audit` для отмечания инструкций, написанных для более старых моделей в ваших подсказках, skills и описаниях инструментов, и предложения исправлений как diff. Запустите `cost-optimize` для профилирования того, куда идят расходы Claude API вашего проекта, и предложения сбережений из опций, таких как prompt caching, обрезка ненужных входных и выходных токенов, пакетная обработка, усилие и выбор модели, по одному изменению за раз. Запустите `build-eval` для создания набора eval для вашего приложения на базе Claude, и `hillclimb` для итеративного улучшения приложения против существующего eval. Подкоманда `prompt-audit` требует Claude Code v2.1.221 или позже, `upgrade` требует v2.1.236 или позже, `cost-optimize` требует v2.1.247 или позже, а `build-eval` и `hillclimb` требуют v2.1.259 или позже |

71| `/clear [name]` | Начать новый разговор с пустым контекстом. Передайте имя для обозначения предыдущего разговора в средстве выбора `/resume`. Чтобы освободить контекст, продолжая тот же разговор, используйте `/compact`. Возобновите предыдущий разговор с помощью `/resume`, или, в том же процессе Claude Code, восстановите его из [записи предыдущего сеанса меню перемотки](/docs/ru/checkpointing#rewind-past-a-cleared-conversation). Псевдонимы: `/reset`, `/new` |71| `/clear [name]` | Начать новый разговор с пустым контекстом. Передайте имя для обозначения предыдущего разговора в средстве выбора `/resume`. Чтобы освободить контекст, продолжая тот же разговор, используйте `/compact` вместо этого. Возобновите предыдущий разговор с помощью `/resume`, или, в том же процессе Claude Code, восстановите его из [записи предыдущей сессии меню перемотки](/docs/ru/checkpointing#rewind-past-a-cleared-conversation). Псевдонимы: `/reset`, `/new` |

72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/ru/skills#bundled-skills).** Проверить текущий diff, или PR номер, ветку или путь, который вы передаёте, на ошибки корректности. В зависимости от вашей модели и уровня усилий, проверка также охватывает возможности очистки. Передайте `--fix` для применения результатов, `--comment` для публикации их на GitHub PR или GitLab merge request, или `ultra` для запуска глубокой [облачной проверки](/docs/ru/ultrareview). Публикация в GitLab merge request требует Claude Code версии 2.1.257 или позже. С `ultra` на целевом `github.com` PR передайте `--post` для предварительного выбора [публикации завершённых результатов на PR](/docs/ru/ultrareview#post-findings-to-the-pull-request) в диалоге запуска; `--post` требует Claude Code версии 2.1.227 или позже. См. [Проверить diff локально](/docs/ru/code-review#review-a-diff-locally) для уровней усилий, нацеливания и того, как это связано с `/simplify`. Псевдоним: `/review` |72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/ru/skills#bundled-skills).** Проверить текущий diff или номер PR, ветку или путь, который вы передаёте, на наличие ошибок корректности. В зависимости от вашей модели и уровня усилия, проверка также охватывает возможности очистки. Передайте `--fix` для применения результатов, `--comment` для их публикации на GitHub PR или GitLab merge request, или `ultra` для запуска глубокой [облачной проверки](/docs/ru/ultrareview). Публикация в GitLab merge request требует Claude Code v2.1.257 или позже. С `ultra` на целевом `github.com` PR передайте `--post` для предварительного выбора [публикации готовых результатов на PR](/docs/ru/ultrareview#post-findings-to-the-pull-request) в диалоге запуска; `--post` требует Claude Code v2.1.227 или позже. См. [Проверить diff локально](/docs/ru/code-review#review-a-diff-locally) для уровней усилия, нацеливания и того, как это связано с `/simplify`. Псевдоним: `/review` |

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

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

75| `/config [key=value ...]` | Открыть интерфейс [Параметры](/docs/ru/settings) для настройки темы, модели, [стиля вывода](/docs/ru/output-styles) и других предпочтений. Передайте одну или несколько пар `key=value` для установки параметра напрямую без открытия интерфейса, например `/config thinking=false`, `/config theme=dark` или `/config model=sonnet`. Форма `key=value` также работает в неинтерактивном режиме (`-p`) и из мобильного приложения Claude через [Remote Control](/docs/ru/remote-control). Форма `key=value` не может включить параметр, который требует вашего подтверждения на панели, такой как [`autoContinueAtUsageLimit`](/docs/ru/interactive-mode#turn-automatic-continue-off), хотя может его отключить. Запустите `/config --help` для списка ключей, которые он принимает. Псевдоним: `/settings` |75| `/config [key=value ...]` | Открыть интерфейс [Параметры](/docs/ru/settings) для настройки темы, модели, [стиля вывода](/docs/ru/output-styles) и других предпочтений. Передайте одну или несколько пар `key=value` для установки параметра напрямую без открытия интерфейса, например `/config thinking=false`, `/config theme=dark` или `/config model=sonnet`. Форма `key=value` также работает в неинтерактивном режиме (`-p`) и из мобильного приложения Claude через [Remote Control](/docs/ru/remote-control). Форма `key=value` не может включить параметр, который требует вашего подтверждения на панели, такой как [`autoContinueAtUsageLimit`](/docs/ru/interactive-mode#turn-automatic-continue-off), хотя может его отключить. Запустите `/config --help` для списка принимаемых ключей. Псевдоним: `/settings` |

76| `/context [all]` | Визуализировать текущее использование контекста как цветную сетку. Показывает предложения оптимизации для контекстно-тяжёлых инструментов, раздутия памяти и предупреждения о ёмкости. Когда разговор превышает контекстное окно, вывод включает [предупреждение](/docs/ru/errors#context-exceeds-the-token-limit), показывающее, насколько вы превышаете лимит и какая команда освобождает место. В [полноэкранном режиме](/docs/ru/fullscreen) `/context` сворачивает разбор по элементам, чтобы сетка оставалась видимой. Передайте `all` для развёртывания |76| `/context [all]` | Визуализировать текущее использование контекста как цветную сетку. Показывает предложения оптимизации для контекстно-тяжёлых инструментов, раздутия памяти и предупреждения о ёмкости. Когда разговор превышает контекстное окно, вывод включает [предупреждение](/docs/ru/errors#context-exceeds-the-token-limit), показывающее, насколько вы превышаете лимит и какая команда освобождает место. В [полноэкранном режиме](/docs/ru/fullscreen) `/context` сворачивает разбор по элементам, чтобы сетка оставалась видимой. Передайте `all` для развёртывания |

77| `/copy [N]` | Скопировать последний ответ помощника в буфер обмена. Передайте число `N` для копирования N-го последнего ответа: `/copy 2` копирует второй с конца. Когда присутствуют блоки кода, показывает интерактивное средство выбора для выбора отдельных блоков или полного ответа. Нажмите `w` в средстве выбора для записи выбора в файл вместо буфера обмена, что полезно через SSH |77| `/copy [N]` | Скопировать последний ответ ассистента в буфер обмена. Передайте число `N` для копирования N-го последнего ответа: `/copy 2` копирует второй с конца. Когда присутствуют блоки кода, показывает интерактивное средство выбора для выбора отдельных блоков или полного ответа. Нажмите `w` в средстве выбора для записи выделения в файл вместо буфера обмена, что полезно через SSH |

78| `/cost` | Псевдоним для `/usage` |78| `/cost` | Псевдоним для `/usage` |

79| `/dataviz [request]` | **[Skill](/docs/ru/skills#bundled-skills).** Рекомендации по дизайну для диаграмм, графиков и панелей управления. Claude выбирает форму диаграммы для данных, назначает цвет по роли, проверяет палитру на безопасность для дальтоников и контраст с помощью встроенного скрипта и применяет правила отметок, взаимодействия и доступности. Использует нейтральную к бренду палитру-заполнитель, которую вы заменяете своей собственной. Требует Claude Code версии 2.1.198 или позже |79| `/dataviz [request]` | **[Skill](/docs/ru/skills#bundled-skills).** Рекомендации по дизайну для диаграмм, графиков и панелей управления. Claude выбирает форму диаграммы для данных, назначает цвет по роли, проверяет палитру на безопасность для дальтоников и контраст с помощью встроенного скрипта и применяет правила отметок, взаимодействия и доступности. Использует нейтральную к бренду палитру-заполнитель, которую вы заменяете своей собственной. Требует Claude Code v2.1.198 или позже |

80| `/debug [description]` | **[Skill](/docs/ru/skills#bundled-skills).** Включить логирование отладки для текущего сеанса и устранить проблемы путём чтения журнала отладки сеанса. Логирование отладки отключено по умолчанию, если вы не запустили с `claude --debug`, поэтому запуск `/debug` в середине сеанса начинает захватывать журналы с этой точки вперёд. Опционально опишите проблему для фокусировки анализа |80| `/debug [description]` | **[Skill](/docs/ru/skills#bundled-skills).** Включить логирование отладки для текущей сессии и устранить проблемы путём чтения журнала отладки сессии. Логирование отладки отключено по умолчанию, если вы не запустили с `claude --debug`, поэтому запуск `/debug` в середине сессии начинает захватывать логи с этого момента. Опционально опишите проблему для фокусировки анализа |

81| `/deep-research <question>` | **[Workflow](/docs/ru/workflows#bundled-workflows).** Распределить веб-поиски по вопросу, получить и перекрёстно проверить источники и синтезировать цитируемый отчёт |81| `/deep-research <question>` | **[Workflow](/docs/ru/workflows#bundled-workflows).** Развернуть веб-поиски по вопросу, получить и перекрёстно проверить источники и синтезировать цитируемый отчёт |

82| `/design [brief]` | **[Skill](/docs/ru/skills#bundled-skills).** Составить макеты UI, потоки экранов, целевые страницы или плакаты как артборды на одном холсте, опубликованные как [артефакт](/docs/ru/artifacts#draft-a-design-canvas), например `/design a settings screen for a mobile banking app`. Вы редактируете артборды в браузере рабочего стола, и ваши правки сохраняются автоматически. Вы можете экспортировать каждый артборд как PNG или PDF. Требует сеанс, где [артефакты доступны](/docs/ru/artifacts#availability) и Claude Code версии 2.1.265 или позже. Доступно на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS артефакты недоступны, поэтому команда недоступна там |82| `/design [brief]` | **[Skill](/docs/ru/skills#bundled-skills).** Составить макеты UI, потоки экранов, целевые страницы или плакаты как артборды на одном холсте, опубликованные как Claude Design [артефакт](/docs/ru/artifacts#draft-a-design-canvas), например `/design a settings screen for a mobile banking app`. Вы редактируете артборды в браузере рабочего стола, и ваши правки сохраняются автоматически. Вы можете экспортировать каждый артборд как PNG или PDF. Требует Claude Code v2.1.265 или позже, сессию где [артефакты доступны](/docs/ru/artifacts#availability) и учётную запись где [шаблон Design доступен](/docs/ru/artifacts#start-from-a-slides-design-or-docs-template); если ваша организация отключила этот шаблон, `/design` не составляет дизайны. Доступно на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS артефакты недоступны, поэтому команда недоступна там |

84| `/design-sync [hint]` | **[Skill](/docs/ru/skills#bundled-skills).** Преобразовать систему дизайна React вашего репо и загрузить её в [Claude Design](https://claude.ai/design), чтобы дизайны, которые она производит, использовали ваши реальные компоненты. Опционально назовите систему дизайна, например `/design-sync Acme DS`. Первая синхронизация проверяет каждый компонент и может занять несколько часов на большом репо. Доступно на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS, или через [Claude apps gateway](/docs/ru/claude-apps-gateway#availability-and-limitations), команда недоступна там |84| `/design-sync [hint]` | **[Skill](/docs/ru/skills#bundled-skills).** Преобразовать систему дизайна React вашего репо и загрузить её в [Claude Design](https://claude.ai/design), чтобы дизайны, которые она производит, использовали ваши реальные компоненты. Опционально назовите систему дизайна, например `/design-sync Acme DS`. Первоначальная синхронизация проверяет каждый компонент и может занять несколько часов на большом репо. Доступно на Anthropic API. Ей нужен claude.ai, который CLI не контактирует на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS, или через [Claude apps gateway](/docs/ru/claude-apps-gateway#availability-and-limitations), поэтому команда недоступна там |

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

86| `/diff` | Просмотреть изменения в вашем рабочем дереве, включая правки, которые Claude сделал до сих пор. См. [Просмотреть изменения с /diff](/docs/ru/interactive-mode#review-changes-with-%2Fdiff) |86| `/diff` | Просмотреть изменения в вашем рабочем дереве, включая правки, которые Claude сделал до сих пор. См. [Просмотреть изменения с /diff](/docs/ru/interactive-mode#review-changes-with-%2Fdiff) |

87| `/doctor` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить проверку настройки, которая диагностирует проблемы и может их исправить. Проверяет здоровье установки, включая дублирующиеся или оставшиеся установки, проблемы `PATH` и непарсируемые файлы параметров. Находит неиспользуемые skills, MCP серверы и плагины в сравнении с их стоимостью контекста, отмечает медленные [hooks](/docs/ru/hooks) и проверяет наличие более новой версии на вашем [канале выпуска](/docs/ru/setup#configure-release-channel). Дедублирует локальные файлы `CLAUDE.md` против проверенных, обрезает проверенные файлы [`CLAUDE.md`](/docs/ru/memory#my-claude-md-is-too-large) путём вырезания контента, который Claude может вывести из кодовой базы, и переносит оставшееся всегда загружаемое руководство в [skills](/docs/ru/skills) и вложенные файлы `CLAUDE.md`, которые загружаются по требованию. Также предлагает сделать [auto mode](/docs/ru/permissions#permission-modes) вашим по умолчанию и [предварительно одобрить](/docs/ru/permissions) часто отклоняемые команды только для чтения. Сообщает результаты в первую очередь и просит подтверждение перед изменением чего-либо. Из терминала `claude doctor` выводит диагностику установки только для чтения без запуска сеанса. Псевдоним: `/checkup`. Проверка обрезки `CLAUDE.md` требует Claude Code версии 2.1.206 или позже. До версии 2.1.205 `/doctor` открывал экран диагностики только для чтения и нажатие `f` отправляло отчёт Claude |87| `/doctor [prompt-audit [path]]` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить проверку настройки, которая диагностирует проблемы и может их исправить. Проверяет здоровье установки, включая дублирующиеся или оставшиеся установки, проблемы `PATH` и непарсируемые файлы настроек. Находит неиспользуемые skills, MCP серверы и плагины в сравнении с их стоимостью контекста, отмечает медленные [hooks](/docs/ru/hooks) и проверяет наличие более новой версии на вашем [канале выпуска](/docs/ru/setup#configure-release-channel). Дедублирует локальные файлы `CLAUDE.md` против проверенных. Обрезает проверенные файлы [`CLAUDE.md`](/docs/ru/memory#my-claude-md-is-too-large) путём вырезания контента, который Claude мог бы вывести из кодовой базы, и переносит оставшееся всегда загружаемое руководство в [skills](/docs/ru/skills) и вложенные файлы `CLAUDE.md`, которые загружаются по требованию. Также предлагает сделать [auto mode](/docs/ru/permissions#permission-modes) вашим по умолчанию и [предварительно одобрить](/docs/ru/permissions) часто отклоняемые команды только для чтения. Сначала сообщает результаты и просит подтверждение перед изменением чего-либо. Из терминала `claude doctor` выводит диагностику установки только для чтения без запуска сессии. Псевдоним: `/checkup`. Запустите `/doctor prompt-audit` чтобы Claude [проверил ваши файлы `CLAUDE.md`, skills и другую конфигурацию](/docs/ru/memory#write-effective-instructions) на устаревшие или конфликтующие инструкции вместо запуска проверки. Подкоманда `prompt-audit` требует Claude Code v2.1.283 или позже. Проверка обрезки `CLAUDE.md` требует Claude Code v2.1.206 или позже. До версии 2.1.205 `/doctor` открывал экран диагностики только для чтения и нажатие `f` отправляло отчёт Claude |

88| `/effort [level\|auto\|status]` | Установить [уровень усилий](/docs/ru/model-config#adjust-effort-level): `low` до `xhigh`, `max`, [`ultracode`](/docs/ru/workflows#let-claude-decide-with-ultracode), или `auto`; `status` выводит его. `max` и `ultracode` только для сеанса; ключ [`ultracode`](/docs/ru/settings-reference#ultracode) сохраняется. Запустите её во время ответа Claude и, после подтверждения [предупреждения о кэше](/docs/ru/prompt-caching#changing-effort-level), если Claude Code показывает его, Claude Code применяет новый уровень к следующему запросу в этом ходу. До версии 2.1.242 Claude Code решал из флага функции, который он получал от Anthropic, запускать ли команду в середине хода или ставить её в очередь до завершения хода, и всегда ставил её в очередь в сеансе, который не [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), такой как на [стороннем поставщике](/docs/ru/third-party-integrations). Работает в `-p` |88| `/effort [level\|auto\|status\|ultracode [on\|off]]` | Установить [уровень усилия](/docs/ru/model-config#adjust-effort-level): `low` до `xhigh`, `max`, или `auto`; `status` выводит его. `ultracode` или `ultracode on` включает [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode) для сессии на текущем уровне, и `ultracode off` выключает его; ключ [`ultracode`](/docs/ru/settings-reference#ultracode) сохраняется. `max` только для сессии. Аргументы `on` и `off` и сохранение текущего уровня требуют Claude Code v2.1.284 или позже. До версии 2.1.284 `/effort ultracode` устанавливал сессию на `xhigh`, и `/effort ultracode off` не удавался с `Invalid argument`. Запустите его во время ответа Claude и, после подтверждения [предупреждения о кэше](/docs/ru/prompt-caching#changing-effort-level), если Claude Code показывает его, Claude Code применяет новый уровень к следующему запросу в этом ходу. До версии 2.1.242 Claude Code решал из флага функции, который он получал от Anthropic, запускать ли команду в середине хода или ставить её в очередь до завершения хода, и всегда ставил её в очередь в сессии, которая не [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), такой как на [поставщике третьей стороны](/docs/ru/third-party-integrations). Работает в `-p` |

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

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

91| `/fast [on\|off]` | Переключить [быстрый режим](/docs/ru/fast-mode) включен или выключен. Запустите её во время ответа Claude и Claude Code переключает быстрый режим без ожидания завершения хода, хотя текущий ход завершается с его исходной скоростью. До версии 2.1.242 Claude Code решал из флага функции, который он получал от Anthropic, запускать ли команду в середине хода или ставить её в очередь до завершения хода, и всегда ставил её в очередь в сеансе, который не [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching). Доступность в неинтерактивном режиме с `-p` ограничена; см. [Переключить быстрый режим](/docs/ru/fast-mode#toggle-fast-mode). Требует Claude Code версии 2.1.205 или позже |91| `/fast [on\|off]` | Переключить [быстрый режим](/docs/ru/fast-mode) включен или выключен. Запустите его во время ответа Claude и Claude Code переключает быстрый режим без ожидания завершения хода, хотя текущий ход завершается с его исходной скоростью. До версии 2.1.242 Claude Code решал из флага функции, который он получал от Anthropic, запускать ли команду в середине хода или ставить её в очередь до завершения хода, и всегда ставил её в очередь в сессии, которая не [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching). Доступность в неинтерактивном режиме с `-p` ограничена; см. [Переключить быстрый режим](/docs/ru/fast-mode#toggle-fast-mode). Требует Claude Code v2.1.205 или позже |

92| `/feedback [report]` | Отправить отзыв о продукте о Claude Code. Открывает тот же диалог, что и [`/bug`](#all-commands), с тем же шагом согласия, правилами отправки и поведением в середине хода. В сеансах с [отзывом, составленным Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), `/feedback` без аргумента открывает очередь черновиков вместо этого, где вы просматриваете, редактируете, отправляете или отклоняете черновики, которые Claude поставил в очередь; очередь включает опцию для написания нового отчёта в диалоге. С аргументом, и для `/bug` всегда, диалог открывается напрямую |92| `/feedback [report]` | Отправить отзыв о продукте о Claude Code. Открывает тот же диалог, что и [`/bug`](#all-commands), с тем же шагом согласия, правилами отправки и поведением в середине хода. В сессиях с [отзывом, составленным Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), `/feedback` без аргумента открывает очередь черновиков вместо этого, где вы просматриваете, редактируете, отправляете или отклоняете черновики, которые Claude поставил в очередь; очередь включает опцию для написания нового отчёта в диалоге. С аргументом и для `/bug` всегда диалог открывается напрямую |

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

94| `/focus` | Переключить представление фокуса, которое показывает только вашу последнюю подсказку, однострочное резюме вызова инструмента с диффстатами и финальный ответ. Резюме вызова инструмента также подсчитывает подагентов, запущенных в ходу, и сворачивает завершённые уведомления фоновых задач в один счёт. Выбор сохраняется между сеансами; установите [`viewMode`](/docs/ru/settings-reference#viewmode) в параметрах для переопределения. Доступно только в [полноэкранном рендеринге](/docs/ru/fullscreen). [Расширение VS Code](/docs/ru/vs-code#use-the-prompt-box) предлагает свой собственный вид Focus как переключатель меню команд, сохранённый как параметр расширения, независимый от `viewMode` |94| `/focus` | Переключить представление фокуса, которое показывает только вашу последнюю подсказку, однострочное резюме вызова инструмента с diffstats редактирования и финальный ответ. Резюме вызова инструмента также подсчитывает подагентов, запущенных в ходу, и сворачивает завершённые уведомления фоновых задач в один счёт. Выбор сохраняется между сессиями; установите [`viewMode`](/docs/ru/settings-reference#viewmode) в настройках для переопределения. Доступно только в [полноэкранном рендеринге](/docs/ru/fullscreen). [Расширение VS Code](/docs/ru/vs-code#use-the-prompt-box) предлагает свой собственный вид Focus как переключатель меню команд, сохранённый как параметр расширения, независимый от `viewMode` |

95| `/fork [prompt]` | [Скопировать текущий разговор](/docs/ru/agent-view#copy-the-session-with-%2Ffork) в новый фоновый сеанс и продолжить работу здесь. Передайте подсказку и копия начнёт работать над ней сразу же; без неё она ждёт в представлении агента для своей первой подсказки. Кроме случаев, когда копия [редактирует на месте](/docs/ru/agent-view#how-file-edits-are-isolated), Claude Code инструктирует её создать свой собственный worktree перед внесением изменений кода; инструкция изоляции требует Claude Code версии 2.1.221 или позже. Чтобы передать побочную задачу подагенту, результат которого возвращается в этот разговор, используйте `/subtask`; чтобы переключиться в копию самостоятельно, используйте `/branch`. Требует Claude Code версии 2.1.212 или позже; на версиях 2.1.161 через 2.1.211 и когда [представление агента отключено](/docs/ru/agent-view#turn-off-agent-view), `/fork` запускает [разветвлённый подагент](/docs/ru/sub-agents#fork-the-current-conversation) вместо этого |95| `/fork [prompt]` | [Скопировать текущий разговор](/docs/ru/agent-view#copy-the-session-with-%2Ffork) в новую фоновую сессию и продолжить работу здесь. Передайте подсказку и копия начнёт работать над ней сразу же; без неё она ждёт в представлении агента для своей первой подсказки. Кроме случаев, когда копия [редактирует на месте](/docs/ru/agent-view#how-file-edits-are-isolated), Claude Code инструктирует её создать свой собственный worktree перед внесением изменений кода; инструкция изоляции требует Claude Code v2.1.221 или позже. Чтобы передать побочную задачу подагенту, результат которого возвращается в этот разговор, используйте `/subtask`; чтобы переключиться в копию самостоятельно, используйте `/branch`. Требует Claude Code v2.1.212 или позже; на v2.1.161 через v2.1.211 и когда [представление агента отключено](/docs/ru/agent-view#turn-off-agent-view), `/fork` запускает [разветвлённый подагент](/docs/ru/sub-agents#fork-the-current-conversation) вместо этого |

96| `/goal [condition\|clear]` | Установить [цель](/docs/ru/goal): Claude продолжает работать между ходами до выполнения условия или цель [очищается по другой причине](/docs/ru/goal#how-evaluation-works). Без аргумента показывает текущую или недавно достигнутую цель. `clear`, `stop`, `off`, `reset`, `none` или `cancel` удаляет активную цель рано |96| `/goal [condition\|clear]` | Установить [цель](/docs/ru/goal): Claude продолжает работать между ходами до тех пор, пока условие не будет выполнено или цель [очищается по другой причине](/docs/ru/goal#how-evaluation-works). Без аргумента показывает текущую или недавно достигнутую цель. `clear`, `stop`, `off`, `reset`, `none` или `cancel` удаляет активную цель рано |

97| `/heapdump` | Записать снимок кучи JavaScript и разбор памяти в `~/Desktop`, или ваш домашний каталог на Linux без папки Desktop, для диагностики высокого использования памяти. Прикрепляйте только файл `-diagnostics.json` при сообщении о проблеме с памятью; `.heapsnapshot` содержит ваш полный разговор и учётные данные, поэтому не делитесь им. [Скрыто из меню команд](#how-the-command-menu-matches-what-you-type); введите полностью. См. [что делать с выводом](/docs/ru/troubleshooting#high-cpu-or-memory-usage) |97| `/heapdump` | Записать снимок кучи JavaScript и разбор памяти в `~/Desktop` или ваш домашний каталог на Linux без папки Desktop для диагностики высокого использования памяти. Прикрепляйте только файл `-diagnostics.json` при сообщении о проблеме с памятью; `.heapsnapshot` содержит ваш полный разговор и учётные данные, поэтому не делитесь им. [Скрыто из меню команд](#how-the-command-menu-matches-what-you-type); введите его полностью. См. [что делать с выводом](/docs/ru/troubleshooting#high-cpu-or-memory-usage) |

98| `/help` | Показать справку и доступные команды |98| `/help` | Показать справку и доступные команды |

99| `/hooks` | Просмотреть конфигурации [hook](/docs/ru/hooks) для событий инструментов |99| `/hooks` | Просмотреть конфигурации [hook](/docs/ru/hooks) для событий инструментов |

100| `/ide` | Управлять интеграциями IDE и показать статус |100| `/ide` | Управлять интеграциями IDE и показать статус |

101| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | Привести конфигурацию из OpenAI Codex, Google Gemini CLI или Cursor на вашей машине в Claude Code, включая файлы инструкций, MCP серверы, команды, подагентов и skills. В [неинтерактивном режиме](/docs/ru/headless) с `-p`, `/import` перечисляет то, что он нашёл, и даёт вам команду, которая подтверждает импорт. Добавьте `--dry-run` для предварительного просмотра без записи чего-либо, или `--yes` для пропуска интерактивного средства выбора. Недоступно на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS, или через [Claude apps gateway](/docs/ru/claude-apps-gateway#availability-and-limitations). Также недоступно, когда вы отключаете [получение флагов функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching). Требует Claude Code версии 2.1.213 или позже. Импорт из Cursor требует версии 2.1.265 или позже |101| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | Привести конфигурацию из OpenAI Codex, Google Gemini CLI или Cursor на вашей машине в Claude Code, включая файлы инструкций, MCP серверы, команды, подагентов и skills. В [неинтерактивном режиме](/docs/ru/headless) с `-p` `/import` перечисляет то, что он нашёл, и даёт вам команду, которая подтверждает импорт. Добавьте `--dry-run` для предварительного просмотра без записи чего-либо или `--yes` для пропуска интерактивного средства выбора. Недоступно на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS, или через [Claude apps gateway](/docs/ru/claude-apps-gateway#availability-and-limitations). Также недоступно, когда вы отключаете [получение флагов функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching). Требует Claude Code v2.1.213 или позже. Импорт из Cursor требует v2.1.265 или позже |

102| `/init` | Инициализировать проект с руководством `CLAUDE.md`. Установите `CLAUDE_CODE_NEW_INIT=1` для интерактивного потока, который также проходит через skills, hooks и файлы личной памяти. Если `/init` находит конфигурацию OpenAI Codex или Google Gemini CLI, он предлагает перенести её с помощью `/import` |102| `/init` | Инициализировать проект с руководством `CLAUDE.md`. Установите `CLAUDE_CODE_NEW_INIT=1` для интерактивного потока, который также проходит через skills, hooks и файлы личной памяти. Если `/init` находит конфигурацию OpenAI Codex или Google Gemini CLI, он предлагает перенести её с помощью `/import` |

103| `/insights` | Создать HTML отчёт, анализирующий ваши недавние сеансы на этой машине: в каких проектах вы работаете, как вы используете Claude Code, где что-то идёт не так и функции для попытки. Недоступно в [облачных сеансах](/docs/ru/claude-code-on-the-web). См. [Анализировать ваши шаблоны использования](/docs/ru/costs#analyze-your-usage-patterns) для местоположения отчёта, удержания и стоимости |103| `/insights` | Создать HTML отчёт, анализирующий ваши недавние сессии на этой машине: в каких проектах вы работаете, как вы используете Claude Code, где что-то идёт не так и функции для попытки. Недоступно в [облачных сессиях](/docs/ru/claude-code-on-the-web). См. [Анализировать ваши паттерны использования](/docs/ru/costs#analyze-your-usage-patterns) для местоположения отчёта, хранения и стоимости |

104| `/install-github-app` | Установить приложение Claude GitHub для репозитория, с необязательным шагом для настройки рабочих процессов [GitHub Actions](/docs/ru/github-actions) и секретов. Проходит вас через выбор репо и настройку интеграции. Работает только с репозиториями github.com. Когда удалённый git вашего репозитория находится на gitlab.com или bitbucket.org, команда выводит уведомление и выходит вместо запуска настройки. Чтобы запустить Claude Code из конвейеров GitLab, см. [GitLab CI/CD](/docs/ru/gitlab-ci-cd) |104| `/install-github-app` | Установить Claude GitHub App для репозитория с необязательным шагом для настройки [GitHub Actions](/docs/ru/github-actions) рабочих процессов и секретов. Проходит вас через выбор репо и настройку интеграции. Работает только с репозиториями github.com. Когда удалённый git вашего репозитория находится на gitlab.com или bitbucket.org, команда выводит уведомление и выходит вместо запуска настройки. Чтобы запустить Claude Code из конвейеров GitLab, см. [GitLab CI/CD](/docs/ru/gitlab-ci-cd) |

107| `/list-agents` | Список подагентов, товарищей [команды агентов](/docs/ru/agent-teams) и других сеансов Claude Code, которым Claude может отправлять сообщения, с именем для использования для каждого. См. [кросс-сеансовое сообщение](/docs/ru/cross-session-messaging). Также доступно как `/peers`. Требует Claude Code версии 2.1.224 или позже; более ранние версии сообщают `Unknown command: /list-agents`. Строки товарищей и первая строка, показывающая имя этого сеанса, требуют версии 2.1.239 или позже. Доступно только в сеансах, где [кросс-сеансовое сообщение включено](/docs/ru/cross-session-messaging#availability) |107| `/list-agents` | Список подагентов, товарищей [команды агентов](/docs/ru/agent-teams) и других сессий Claude Code, которым Claude может отправлять сообщения, с именем для использования для каждого. См. [кросс-сессионный обмен сообщениями](/docs/ru/cross-session-messaging). Также доступно как `/peers`. Требует Claude Code v2.1.224 или позже; более ранние версии сообщают `Unknown command: /list-agents`. Строки товарищей и первая строка, показывающая имя этой сессии, требуют v2.1.239 или позже. Доступно только в сессиях где [кросс-сессионный обмен сообщениями включён](/docs/ru/cross-session-messaging#availability) |

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

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

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

114| `/model [model]` | Переключить модель AI и сохранить её как вашу по умолчанию для новых сеансов. Для моделей, которые это поддерживают, используйте стрелки влево/вправо для [регулировки уровня усилий](/docs/ru/model-config#adjust-effort-level). Без аргумента открывает средство выбора; нажмите `s` на строке для переключения только для текущего сеанса. См. [когда Claude Code просит вас подтвердить переключение](/docs/ru/prompt-caching#switching-models). После подтверждения переключения, если Claude Code спрашивает, Claude Code применяет изменение без ожидания завершения текущего ответа. До версии 2.1.242 Claude Code решал из флага функции, который он получал от Anthropic, применять ли команду в середине хода или ставить её в очередь до завершения хода, и всегда ставил её в очередь в сеансе, который не [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), такой как на [стороннем поставщике](/docs/ru/third-party-integrations). Также доступно в неинтерактивном режиме (`-p`) с аргументом модели вместо средства выбора, где он применяется только к текущему сеансу и не сохраняется как ваша по умолчанию; требует Claude Code версии 2.1.205 или позже |114| `/model [model]` | Переключить модель AI и сохранить её как вашу по умолчанию для новых сессий. Для моделей, которые это поддерживают, используйте стрелки влево/вправо для [регулировки уровня усилия](/docs/ru/model-config#adjust-effort-level). Без аргумента открывает средство выбора; нажмите `s` на строке для переключения только для текущей сессии. См. [когда Claude Code просит вас подтвердить переключение](/docs/ru/prompt-caching#switching-models). После подтверждения переключения, если Claude Code спрашивает, Claude Code применяет изменение без ожидания завершения текущего ответа. До версии 2.1.242 Claude Code решал из флага функции, который он получал от Anthropic, запускать ли команду в середине хода или ставить её в очередь до завершения хода, и всегда ставил её в очередь в сессии, которая не [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), такой как на [поставщике третьей стороны](/docs/ru/third-party-integrations). Также доступно в неинтерактивном режиме (`-p`) с аргументом модели вместо средства выбора, где он применяется только к текущей сессии и не сохраняется как ваша по умолчанию; требует Claude Code v2.1.205 или позже |

115| `/output-style [style]` | Список [стилей вывода](/docs/ru/output-styles) или переключиться на один, например `/output-style concise`. См. [Изменить ваш стиль вывода](/docs/ru/output-styles#change-your-output-style). Требует Claude Code версии 2.1.269 или позже |115| `/output-style [style]` | Список [стилей вывода](/docs/ru/output-styles) или переключиться на один, например `/output-style concise`. См. [Изменить ваш стиль вывода](/docs/ru/output-styles#change-your-output-style). Требует Claude Code v2.1.269 или позже |

117| `/permissions` | Управлять правилами разрешения, запроса и отказа для разрешений инструментов. Открывает интерактивный диалог, где вы можете просмотреть правила по области, добавить или удалить правила, управлять рабочими каталогами и просмотреть [недавние отказы auto mode](/docs/ru/auto-mode-config#review-denials). Вы также можете просмотреть и отредактировать [правила классификатора auto mode](/docs/ru/auto-mode-config#edit-rules-from-permissions) из вкладки **Auto mode** диалога. Когда вы запускаете её во время ответа Claude, Claude Code открывает диалог сразу же и применяет ваши изменения, начиная со следующего вызова инструмента Claude в этом же ходу. До версии 2.1.234 Claude Code ставил команду в очередь до завершения хода. Псевдоним: `/allowed-tools` |117| `/permissions` | Управлять правилами разрешения, запроса и отказа для разрешений инструментов. Открывает интерактивный диалог где вы можете просмотреть правила по области, добавить или удалить правила, управлять рабочими каталогами и просмотреть [недавние отказы auto mode](/docs/ru/auto-mode-config#review-denials). Вы также можете просмотреть и отредактировать [правила классификатора auto mode](/docs/ru/auto-mode-config#edit-rules-from-permissions) из вкладки **Auto mode** диалога. Когда вы запускаете его во время ответа Claude, Claude Code открывает диалог сразу же и применяет ваши изменения начиная со следующего вызова инструмента Claude в этом же ходу. До версии 2.1.234 Claude Code ставил команду в очередь до завершения хода. Псевдоним: `/allowed-tools` |

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

119| `/plugin [subcommand]` | Управлять [плагинами](/docs/ru/plugins/overview) Claude Code. Запустите без аргумента для открытия меню плагинов, или передайте подкоманду, такую как `list`, `install`, `enable` или `disable` для прямого действия. Claude Code может активировать плагин во время установки; [резюме установки](/docs/ru/plugins/install#install-a-plugin) говорит вам, сделал ли он это или нужно ли запустить `/reload-plugins` |119| `/plugin [subcommand]` | Управлять Claude Code [плагинами](/docs/ru/plugins/overview). Запустите без аргумента для открытия меню плагинов или передайте подкоманду, такую как `list`, `install`, `enable` или `disable` для прямого действия. Claude Code может активировать плагин во время установки; [резюме установки](/docs/ru/plugins/install#install-a-plugin) говорит вам, сделал ли он это или нужно ли запустить `/reload-plugins` |

121| `/pr-comments [PR]` | Удалено в версии 2.1.91. Попросите Claude напрямую просмотреть комментарии pull request. На более ранних версиях получает и отображает комментарии из GitHub pull request; автоматически обнаруживает PR для текущей ветки, или передайте URL или номер PR. Требует CLI `gh` |121| `/pr-comments [PR]` | Удалено в v2.1.91. Попросите Claude напрямую просмотреть комментарии pull request вместо этого. На более ранних версиях получает и отображает комментарии из GitHub pull request; автоматически обнаруживает PR для текущей ветки или передайте URL или номер PR. Требует CLI `gh` |

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

124| `/rate-limit-options` | Показать способы продолжить работу, когда лимит использования claude.ai блокирует запрос: ждать и [продолжить автоматически, когда лимит сбросится](/docs/ru/interactive-mode#wait-for-a-usage-limit-to-reset), добавить [кредиты использования](/docs/ru/costs#add-usage-credits-to-your-subscription) или обновить ваш план. Claude Code также может открыть это меню самостоятельно, когда вы достигаете лимита на вашем собственном терминале. См. [Отключить автоматическое продолжение](/docs/ru/interactive-mode#turn-automatic-continue-off). Требует подписку claude.ai. Не отображается в меню команд; введите полностью. Строки ожидания и продолжения требуют Claude Code версии 2.1.234 или позже |124| `/rate-limit-options` | Показать способы продолжить работу, когда лимит использования claude.ai блокирует запрос: ждать и [продолжить автоматически, когда лимит сбросится](/docs/ru/interactive-mode#wait-for-a-usage-limit-to-reset), добавить [кредиты использования](/docs/ru/costs#add-usage-credits-to-your-subscription) или обновить ваш план. Claude Code также может открыть это меню самостоятельно, когда вы достигнете лимита на вашем собственном терминале. См. [Отключить автоматическое продолжение](/docs/ru/interactive-mode#turn-automatic-continue-off). Требует подписку claude.ai. Не отображается в меню команд; введите полностью. Строки ожидания и продолжения требуют Claude Code v2.1.234 или позже |

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

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

127| `/reload-plugins [--force]` | Перезагрузить все активные [плагины](/docs/ru/plugins/overview) для применения ожидающих изменений без перезагрузки. Сообщает счёты для каждого перезагруженного компонента и отмечает любые ошибки загрузки. Когда перезагрузка изменит, какие инструменты MCP загружены и аннулирует кэш подсказок, команда предупреждает и пропускает, если вы не передаёте `--force`. Также доступно в неинтерактивном режиме (`-p`), Agent SDK и приложении для рабочего стола, где оно запускается только на входе, введённом напрямую в сеанс и не применяет изменения MCP сервера плагина; требует Claude Code версии 2.1.260 или позже. См. [Применить изменения плагина без перезагрузки](/docs/ru/plugins/cli-reference#reload-plugins) |127| `/reload-plugins [--force]` | Перезагрузить все активные [плагины](/docs/ru/plugins/overview) для применения ожидающих изменений без перезагрузки. Сообщает счёты для каждого перезагруженного компонента и отмечает любые ошибки загрузки. Когда перезагрузка изменит, какие инструменты MCP загружены и инвалидирует кэш подсказок, команда предупреждает и пропускает, если вы не передадите `--force`. Также доступно в неинтерактивном режиме (`-p`), Agent SDK и приложении рабочего стола, где оно запускается только на входе, введённом напрямую в сессию и не применяет изменения MCP плагинов; требует Claude Code v2.1.260 или позже. См. [Применить изменения плагинов без перезагрузки](/docs/ru/plugins/cli-reference#reload-plugins) |

128| `/reload-skills` | Повторно сканировать каталоги [skill](/docs/ru/skills) и команд, чтобы skills, добавленные или изменённые на диске во время сеанса, стали доступны без перезагрузки. Сообщает, сколько skills доступно и сколько было добавлено или удалено |128| `/reload-skills` | Повторно сканировать каталоги [skill](/docs/ru/skills) и команд, чтобы skills добавленные или изменённые на диске во время сессии стали доступны без перезагрузки. Сообщает, сколько skills доступно и сколько было добавлено или удалено |

129| `/remote-control` | Сделать этот сеанс доступным для [Remote Control](/docs/ru/remote-control) из claude.ai. Запуск при выходе выводит, что Remote Control требует подписку claude.ai и говорит вам, как войти; до версии 2.1.206 это сообщало `Unknown command: /remote-control`. Псевдоним: `/rc` |129| `/remote-control` | Сделать эту сессию доступной для [Remote Control](/docs/ru/remote-control) из claude.ai. Запуск при выходе выводит, что Remote Control требует подписку claude.ai и говорит вам как войти; до версии 2.1.206 это сообщало `Unknown command: /remote-control`. Псевдоним: `/rc` |

130| `/remote-env` | Выбрать окружение по умолчанию для [облачных сеансов](/docs/ru/cloud-environments#select-an-environment-from-the-cli), которые вы запускаете из CLI |130| `/remote-env` | Выбрать [облачное окружение](/docs/ru/cloud-environments#select-an-environment-from-the-cli) по умолчанию для облачных сессий, которые вы запускаете из CLI |

131| `/rename [name]` | Переименовать текущий сеанс и показать имя на строке подсказки. Без имени автоматически создаёт одно из истории разговора. Также доступно в неинтерактивном режиме (`-p`); требует Claude Code версии 2.1.205 или позже. Из каждой поверхности переименования, включая claude.ai и приложение для рабочего стола, Claude Code заменяет управляющие и невидимые символы в новом имени пробелами и ограничивает имя 200 символами. Если имя пусто после удаления невидимых символов, Claude Code отклоняет его и показывает `That name is empty once invisible characters are removed. Usage: /rename <name>`. Замена символов и ограничение длины требуют Claude Code версии 2.1.221 или позже. Если другой живой сеанс на этой машине уже использует имя, которое вы передаёте, Claude Code применяет [вариант его](/docs/ru/sessions#name-your-sessions) вместо этого |131| `/rename [name]` | Переименовать текущую сессию и показать имя на строке подсказки. Без имени автоматически создаёт одно из истории разговора. Также доступно в неинтерактивном режиме (`-p`); требует Claude Code v2.1.205 или позже. Из каждой поверхности переименования, включая claude.ai и приложение рабочего стола, Claude Code заменяет управляющие и невидимые символы в новом имени пробелами и ограничивает имя 200 символами. Если имя пусто после удаления невидимых символов, Claude Code отклоняет его и показывает `That name is empty once invisible characters are removed. Usage: /rename <name>`. Замена символов и ограничение длины требуют Claude Code v2.1.221 или позже. Если другая живая сессия на этой машине уже использует имя, которое вы передаёте, Claude Code применяет [вариант его](/docs/ru/sessions#name-your-sessions) вместо этого |

132| `/resume [session]` | Возобновить разговор по ID или имени, или открыть средство выбора сеанса. [Фоновые сеансы](/docs/ru/agent-view) появляются в средстве выбора, отмеченные с `bg`; тот, который всё ещё работает, не может быть возобновлен здесь, поэтому прикрепитесь к нему из `claude agents` или остановите его там сначала. Псевдоним: `/continue` |132| `/resume [session]` | Возобновить разговор по ID или имени или открыть средство выбора сессии. [Фоновые сессии](/docs/ru/agent-view) появляются в средстве выбора отмеченные с `bg`; одна, которая всё ещё работает, не может быть возобновлена здесь, поэтому прикрепитесь к ней из `claude agents` или остановите её там сначала. Псевдоним: `/continue` |

133| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Псевдоним [`/code-review`](/docs/ru/code-review#review-a-diff-locally): проверяет текущий diff, или PR номер, ветку или путь, который вы передаёте, такой как `/review 1234`, и принимает те же уровни усилий и флаги. Без уровня, проверка повторно использует последний уровень `low` через `max`, который вы вводили; см. [Проверить diff локально](/docs/ru/code-review#review-a-diff-locally) для точных правил. Для глубокой облачной проверки используйте [`/code-review ultra`](/docs/ru/ultrareview). До версии 2.1.223 `/review` была отдельной командой, которая запускала однопроходную проверку только для чтения GitHub pull request по номеру, перечисляя открытые PR для выбора при запуске без аргумента; с версии 2.1.186 по 2.1.201 она запускала тот же многоагентный движок, что и `/code-review medium` |133| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Псевдоним [`/code-review`](/docs/ru/code-review#review-a-diff-locally): проверяет текущий diff или номер PR, ветку или путь, который вы передаёте, такой как `/review 1234`, и принимает те же уровни усилия и флаги. Без уровня, заданного, проверка повторно использует последний уровень `low` через `max`, который вы вводили; см. [Проверить diff локально](/docs/ru/code-review#review-a-diff-locally) для точных правил. Для глубокой облачной проверки используйте [`/code-review ultra`](/docs/ru/ultrareview). До версии 2.1.223 `/review` была отдельной командой, которая запускала однопроходную проверку только для чтения GitHub pull request по номеру, перечисляя открытые PR для выбора при запуске без аргумента; с v2.1.186 по v2.1.201 она запускала тот же многоагентный движок, что и `/code-review medium` |

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

135| `/run` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить и управлять приложением вашего проекта, чтобы увидеть работающее изменение, не только проходящие тесты. См. [Запустить и проверить ваше приложение](/docs/ru/skills#run-and-verify-your-app) |135| `/run` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить и управлять приложением вашего проекта, чтобы увидеть работающее изменение, не только проходящие тесты. См. [Запустить и проверить ваше приложение](/docs/ru/skills#run-and-verify-your-app) |

136| `/run-skill-generator` | **[Skill](/docs/ru/skills#bundled-skills).** Научить `/run` и `/verify` как собирать, запускать и управлять приложением вашего проекта из чистого окружения путём написания [skill](/docs/ru/skills#run-and-verify-your-app) для каждого проекта |136| `/run-skill-generator` | **[Skill](/docs/ru/skills#bundled-skills).** Научить `/run` и `/verify` как собирать, запускать и управлять приложением вашего проекта из чистого окружения путём написания per-project [skill](/docs/ru/skills#run-and-verify-your-app) |

138| `/schedule [description]` | Создать, обновить, перечислить или запустить [процедуры](/docs/ru/routines), которые выполняются в облаке. Claude проходит вас через настройку разговорно. Вы также можете спросить о [недавних запусках процедуры](/docs/ru/routines#manage-routines-from-the-cli). Псевдоним: `/routines` |138| `/schedule [description]` | Создать, обновить, список или запустить [routines](/docs/ru/routines), которые выполняются в облаке. Claude проходит вас через настройку разговорно. Вы также можете спросить о [недавних запусках routine](/docs/ru/routines#manage-routines-from-the-cli). Псевдоним: `/routines` |

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

140| `/security-review` | Анализировать изменения на вашей текущей ветке на предмет уязвимостей безопасности. Проверяет diff между вашей веткой и веткой по умолчанию origin, выявляя риски, такие как инъекция, проблемы с аутентификацией и утечка данных. Нужен удалённый `origin`; если проверка не удаётся с ошибкой `ambiguous argument`, см. [справку по ошибкам](/docs/ru/errors#security-review-fails-without-origin-head) |140| `/security-review` | Анализировать изменения на вашей текущей ветке на предмет уязвимостей безопасности. Проверяет diff между вашей веткой и веткой по умолчанию origin, определяя риски, такие как инъекция, проблемы аутентификации и утечка данных. Нужен удалённый `origin`; если проверка не удаётся с ошибкой `ambiguous argument`, см. [справку по ошибкам](/docs/ru/errors#security-review-fails-without-origin-head) |

141| `/setup-bedrock` | Настроить аутентификацию [Amazon Bedrock](/docs/ru/amazon-bedrock), регион и закрепления модели через интерактивный мастер. [Скрыто из меню команд](#how-the-command-menu-matches-what-you-type) до установки `CLAUDE_CODE_USE_BEDROCK=1`; введите полностью. Пользователи Amazon Bedrock в первый раз также могут получить доступ к этому мастеру с экрана входа |141| `/setup-bedrock` | Настроить аутентификацию [Amazon Bedrock](/docs/ru/amazon-bedrock), регион и закрепления модели через интерактивный мастер. [Скрыто из меню команд](#how-the-command-menu-matches-what-you-type) до установки `CLAUDE_CODE_USE_BEDROCK=1`; введите полностью. Пользователи Amazon Bedrock в первый раз также могут получить доступ к этому мастеру с экрана входа |

142| `/setup-vertex` | Настроить аутентификацию [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), проект, регион и закрепления модели через интерактивный мастер. [Скрыто из меню команд](#how-the-command-menu-matches-what-you-type) до установки `CLAUDE_CODE_USE_VERTEX=1`; введите полностью. Пользователи Google Cloud's Agent Platform в первый раз также могут получить доступ к этому мастеру с экрана входа |142| `/setup-vertex` | Настроить аутентификацию [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), проект, регион и закрепления модели через интерактивный мастер. [Скрыто из меню команд](#how-the-command-menu-matches-what-you-type) до установки `CLAUDE_CODE_USE_VERTEX=1`; введите полностью. Пользователи Google Cloud's Agent Platform в первый раз также могут получить доступ к этому мастеру с экрана входа |

143| `/simplify [target]` | **[Skill](/docs/ru/skills#bundled-skills).** Проверить изменённый код на предмет возможностей очистки и применить исправления. Четыре агента проверки [agents](/docs/ru/sub-agents) работают параллельно, охватывая повторное использование существующих помощников, упрощение, эффективность и находится ли изменение на правильном уровне абстракции. Проверка не ищет ошибки корректности. Используйте `/code-review` для поиска ошибок. Передайте путь или ссылку PR для проверки конкретной цели |143| `/simplify [target]` | **[Skill](/docs/ru/skills#bundled-skills).** Проверить изменённый код на возможности очистки и применить исправления. Четыре агента проверки [agents](/docs/ru/sub-agents) запускаются параллельно, охватывая повторное использование существующих помощников, упрощение, эффективность и находится ли изменение на правильном уровне абстракции. Проверка не ищет ошибки корректности. Используйте `/code-review` для поиска ошибок. Передайте путь или ссылку PR для проверки конкретной цели |

144| `/skill-doctor` | Показать, что каждый из ваших [skills](/docs/ru/skills) стоит в контексте и как часто он используется, чтобы вы могли [найти skills для отключения](/docs/ru/skills#find-unused-skills). Требует Claude Code версии 2.1.252 или позже и [получение флагов функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching) |144| `/skill-doctor` | Показать, что каждый из ваших [skills](/docs/ru/skills) стоит в контексте и как часто он используется, чтобы вы могли [найти skills для отключения](/docs/ru/skills#find-unused-skills). Требует Claude Code v2.1.252 или позже и [получение флагов функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching) |

145| `/skills` | Список доступных [skills](/docs/ru/skills). Введите для фильтрации списка по имени, описанию или источнику. Нажмите `t` для сортировки по количеству токенов, `Space` или `Enter` для [циклирования видимости skill для Claude и меню `/`](/docs/ru/skills#override-skill-visibility-from-settings), и `Esc` для сохранения и закрытия. Вы не можете циклировать плагин skills, skills, чьи frontmatter устанавливают `disable-model-invocation: true`, или skills с записью `skillOverrides` в управляемых параметрах или флаге `--settings` |145| `/skills` | Список доступных [skills](/docs/ru/skills). Введите для фильтрации списка по имени, описанию или источнику. Нажмите `t` для сортировки по количеству токенов, `Space` или `Enter` для [цикла видимости skill для Claude и меню `/`](/docs/ru/skills#override-skill-visibility-from-settings) и `Esc` для сохранения и закрытия. Вы не можете циклировать плагин skills, skills чьи frontmatter устанавливают `disable-model-invocation: true` или skills с записью `skillOverrides` в управляемых настройках или флаге `--settings` |

146| `/slides [brief]` | **[Skill](/docs/ru/skills#bundled-skills).** Создать новую презентацию как Claude Slides [артефакт](/docs/ru/artifacts#make-a-slide-deck) заполненный из вашего краткого описания, например `/slides a quarterly review of the platform team`. Требует Claude Code v2.1.265 или позже, сессию где [артефакты доступны](/docs/ru/artifacts#availability) и учётную запись где [шаблон Slides доступен](/docs/ru/artifacts#start-from-a-slides-design-or-docs-template); иначе команда не отображается. Доступно на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS артефакты недоступны, поэтому команда недоступна там |

147| `/status` | Открыть интерфейс Settings на вкладке Status, показывающей версию, модель, аккаунт и подключение. Строка `Session kind` читает `background job · attached` или `background job · unattended` в [фоновом сеансе](/docs/ru/agent-view), в зависимости от того, прикреплён ли терминал, и `interactive` в любом другом сеансе. До версии 2.1.221 `/status` не показывал эту строку. Работает во время ответа Claude |148| `/status` | Открыть интерфейс Settings на вкладке Status, показывающей версию, модель, учётную запись и подключение. Строка `Session kind` читает `background job · attached` или `background job · unattended` в [фоновой сессии](/docs/ru/agent-view), в зависимости от того, прикреплён ли терминал, и `interactive` в любой другой сессии. До версии 2.1.221 `/status` не показывал эту строку. Работает во время ответа Claude |

148| `/statusline` | Настроить [строку статуса](/docs/ru/statusline) Claude Code. Опишите, что вы хотите, или запустите без аргументов для автоматической настройки из вашей подсказки оболочки |149| `/statusline` | Настроить [строку статуса](/docs/ru/statusline) Claude Code. Опишите, что вы хотите, или запустите без аргументов для автоматической настройки из вашей подсказки оболочки |

150| `/stop` | Остановить текущий [фоновый сеанс](/docs/ru/agent-view). Доступно только при прикреплении к фоновому сеансу; стенограмма и любой worktree сохраняются. Чтобы отсоединиться без остановки, используйте `/exit` или нажмите `←` |151| `/stop` | Остановить текущую [фоновую сессию](/docs/ru/agent-view). Доступно только при прикреплении к фоновой сессии; стенограмма и любой worktree сохраняются. Чтобы отсоединиться без остановки, используйте `/exit` или нажмите `←` |

151| `/subtask <task>` | Запустить [разветвлённый подагент](/docs/ru/sub-agents#fork-the-current-conversation): фоновый подагент, который наследует полный разговор и работает над задачей, пока вы продолжаете работать. Его результат возвращается в этот разговор, когда он завершается. Чтобы скопировать разговор в отдельный фоновый сеанс вместо этого, используйте `/fork`. Требует Claude Code версии 2.1.212 или позже; на версиях 2.1.161 через 2.1.211 эта команда — `/fork`. Когда [представление агента отключено](/docs/ru/agent-view#turn-off-agent-view), `/subtask` недоступен и `/fork` сохраняет поведение разветвлённого подагента |152| `/subtask <task>` | Запустить [разветвлённый подагент](/docs/ru/sub-agents#fork-the-current-conversation): фоновый подагент, который наследует полный разговор и работает над задачей, пока вы продолжаете работать. Его результат возвращается в этот разговор, когда он завершается. Чтобы скопировать разговор в отдельную фоновую сессию вместо этого, используйте `/fork`. Требует Claude Code v2.1.212 или позже; на v2.1.161 через v2.1.211 эта команда — `/fork`. Когда [представление агента отключено](/docs/ru/agent-view#turn-off-agent-view), `/subtask` недоступен и `/fork` сохраняет поведение разветвлённого подагента |

152| `/tasks` | Просмотреть и управлять фоновой работой в текущем сеансе, включая подагентов, которые завершились. Также доступно как `/bashes` |153| `/tasks` | Просмотреть и управлять фоновой работой в текущей сессии, включая подагентов, которые завершились. Также доступно как `/bashes` |

153| `/team-onboarding` | Создать руководство по адаптации команды из истории использования Claude Code. Claude анализирует ваши сеансы, команды и использование MCP сервера за последние 30 дней и создаёт руководство markdown, которое товарищ может вставить как первое сообщение для быстрой настройки. Для подписчиков claude.ai на планах Pro, Max, Team и Enterprise также возвращает ссылку для совместного использования, которую товарищи могут открыть напрямую в Claude Code |154| `/team-onboarding` | Создать руководство по адаптации команды из истории использования Claude Code. Claude анализирует ваши сессии, команды и использование MCP серверов за последние 30 дней и производит руководство markdown, которое товарищ может вставить как первое сообщение для быстрой настройки. Для подписчиков claude.ai на планах Pro, Max, Team и Enterprise также возвращает ссылку для совместного использования, которую товарищи могут открыть напрямую в Claude Code |

154| `/teleport` | Вытащить сеанс [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web#from-cloud-to-terminal) в этот терминал. Открывает средство выбора, затем получает ветку и разговор. Также доступно как `/tp`. Требует подписку claude.ai |155| `/teleport` | Вытащить [облачную сессию](/docs/ru/claude-code-on-the-web#from-cloud-to-terminal) в этот терминал. Открывает средство выбора, затем получает ветку и разговор. Также доступно как `/tp`. Требует подписку claude.ai |

155| `/terminal-setup` | [Установить сочетание клавиш Shift+Enter для новых строк](/docs/ru/terminal-config#enter-multiline-prompts) в VS Code, Cursor, Devin Desktop, Alacritty или Zed. В Apple Terminal, [включить Option+Enter для новых строк и отключить звуковой сигнал](/docs/ru/terminal-config#enable-option-key-shortcuts-on-macos) вместо этого. В iTerm2, [включить доступ к буферу обмена, чтобы `/copy` работал](/docs/ru/terminal-config#enable-option-key-shortcuts-on-macos) |156| `/terminal-setup` | [Установить сочетание клавиш Shift+Enter для новых строк](/docs/ru/terminal-config#enter-multiline-prompts) в VS Code, Cursor, Devin Desktop, Alacritty или Zed. В Apple Terminal [включить Option+Enter для новых строк и отключить звуковой сигнал](/docs/ru/terminal-config#enable-option-key-shortcuts-on-macos) вместо этого. В iTerm2 [включить доступ к буферу обмена, чтобы `/copy` работал](/docs/ru/terminal-config#enable-option-key-shortcuts-on-macos) |

156| `/theme` | Изменить цветовую тему. Включает опцию `auto`, которая соответствует светлому или тёмному фону вашего терминала, светлые и тёмные варианты, доступные для дальтоников (далтонизированные) темы, ANSI темы, которые используют палитру цветов вашего терминала, и любые [пользовательские темы](/docs/ru/terminal-config#create-a-custom-theme) из `~/.claude/themes/` или плагинов. Выберите **New custom theme…** для создания одной |157| `/theme` | Изменить цветовую тему. Включает опцию `auto`, которая соответствует светлому или тёмному фону вашего терминала, светлые и тёмные варианты, доступные для дальтоников (далтонизированные) темы, ANSI темы, которые используют палитру цветов вашего терминала и любые [пользовательские темы](/docs/ru/terminal-config#create-a-custom-theme) из `~/.claude/themes/` или плагинов. Выберите **New custom theme…** для создания одной |

157| `/tui [default\|fullscreen]` | Установить рендерер терминального UI и перезагрузиться в него с вашим разговором нетронутым. `fullscreen` включает [рендерер alt-screen без мерцания](/docs/ru/fullscreen). Без аргумента выводит активный рендерер |158| `/tui [default\|fullscreen]` | Установить рендерер терминального UI и перезагрузить его с вашим разговором нетронутым. `fullscreen` включает [рендерер alt-screen без мерцания](/docs/ru/fullscreen). Без аргумента выводит активный рендерер |

158| `/ultraplan <prompt>` | Удалено. Используйте [Plan Mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) вместо этого. Ранее отправляла задачу планирования в сеанс [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) для проверки в вашем браузере |159| `/ultraplan <prompt>` | Удалено. Используйте [режим плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) вместо этого. Ранее отправляла задачу планирования [облачной сессии](/docs/ru/claude-code-on-the-web) для проверки в вашем браузере |

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

160| `/update-config [request]` | **[Skill](/docs/ru/skills#bundled-skills).** Опишите изменение параметров, такое как разрешение команды, установка переменной окружения или добавление [hook](/docs/ru/hooks), и Claude редактирует соответствующий файл [`settings.json`](/docs/ru/settings). Для опций, таких как тема и модель, используйте `/config` вместо этого |161| `/update-config [request]` | **[Skill](/docs/ru/skills#bundled-skills).** Опишите изменение параметров, такое как разрешение команды, установка переменной окружения или добавление [hook](/docs/ru/hooks), и Claude редактирует соответствующий файл [`settings.json`](/docs/ru/settings). Для опций, таких как тема и модель, используйте `/config` вместо этого |

161| `/upgrade` | Открыть страницу обновления в вашем браузере для переключения на более высокий уровень плана. Когда браузер не открывается, команда показывает подсказку входа без вывода URL |162| `/upgrade` | Открыть страницу обновления в вашем браузере для переключения на более высокий уровень плана. Когда браузер не открывается, команда показывает подсказку входа без вывода URL |

162| `/usage` | Показать стоимость сеанса, лимиты использования плана и статистику активности. На плане Pro, Max, Team или Enterprise, включает [разбор того, что считается против ваших лимитов плана](/docs/ru/costs#plan-usage-breakdown). `/cost` и `/stats` — псевдонимы |163| `/usage` | Показать стоимость сессии, лимиты использования плана и статистику активности. На плане Pro, Max, Team или Enterprise включает [разбор того, что считается против ваших лимитов плана](/docs/ru/costs#plan-usage-breakdown). `/cost` и `/stats` — это псевдонимы |

163| `/usage-credits` | Настроить кредиты использования, или запросить их у вашего администратора, когда вы достигаете лимита. Открывает ваши [параметры биллинга кредитов использования](/docs/ru/costs#add-usage-credits-to-your-subscription) в браузере, кроме того, что члены Team и Enterprise без доступа к биллингу вместо этого отправляют запрос кредитов использования своему администратору из CLI, после подтверждения в диалоге, что запрос уведомляет их администраторов. Когда браузер не может открыть страницу биллинга, например через SSH, команда выводит URL для посещения вместо этого; это требует Claude Code версии 2.1.205 или позже, и более ранние версии ничего не показывали в этом случае. Ранее `/extra-usage` |164| `/usage-credits` | Настроить кредиты использования или запросить их у вашего администратора, когда вы достигнете лимита. Открывает ваши [параметры биллинга кредитов использования](/docs/ru/costs#add-usage-credits-to-your-subscription) в браузере, кроме того, что члены Team и Enterprise без доступа к биллингу вместо этого отправляют запрос кредитов использования своему администратору из CLI после подтверждения в диалоге, что запрос уведомляет их администраторов. Когда браузер не может открыть страницу биллинга, например через SSH, команда выводит URL для посещения вместо этого; это требует Claude Code v2.1.205 или позже, и более ранние версии ничего не показывали в этом случае. Ранее `/extra-usage` |

164| `/verify` | **[Skill](/docs/ru/skills#bundled-skills).** Подтвердить, что изменение кода делает то, что оно должно, путём сборки приложения вашего проекта, его запуска и наблюдения результата, а не полагаясь на тесты или проверки типов. См. [Запустить и проверить ваше приложение](/docs/ru/skills#run-and-verify-your-app) |165| `/verify` | **[Skill](/docs/ru/skills#bundled-skills).** Подтвердить, что изменение кода делает то, что оно должно, путём сборки приложения вашего проекта, его запуска и наблюдения результата, а не полагаясь на тесты или проверки типов. См. [Запустить и проверить ваше приложение](/docs/ru/skills#run-and-verify-your-app) |

165| `/vim` | Удалено в версии 2.1.92. Чтобы переключаться между режимами редактирования Vim и Normal, используйте `/config` → Editor mode |166| `/vim` | Удалено в v2.1.92. Чтобы переключаться между режимами редактирования Vim и Normal, используйте `/config` → Editor mode |

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

167| `/web-setup` | Подключить ваш аккаунт GitHub к [Claude Code в веб-версии](/docs/ru/web-quickstart#connect-from-your-terminal) используя учётные данные локального CLI `gh` |168| `/web-setup` | Подключить вашу учётную запись GitHub для [облачных сессий](/docs/ru/web-quickstart#connect-from-your-terminal) используя ваши локальные учётные данные CLI `gh` |

168| `/workflow-authoring` | **[Skill](/docs/ru/skills#bundled-skills).** Загрузить справку для написания скриптов [динамического workflow](/docs/ru/workflows): API скрипта, поведение возобновления, шаблоны качества и отработанные примеры. Claude обычно загружает её самостоятельно перед написанием скрипта; запустите её самостоятельно перед [редактированием сохранённого скрипта вручную](/docs/ru/workflows#edit-a-saved-script). Доступно, когда динамические workflows включены, и требует Claude Code версии 2.1.248 или позже |169| `/workflow-authoring` | **[Skill](/docs/ru/skills#bundled-skills).** Загрузить справку для написания скриптов [динамического workflow](/docs/ru/workflows): API скрипта, поведение возобновления, паттерны качества и отработанные примеры. Claude обычно загружает её самостоятельно перед написанием скрипта; запустите её самостоятельно перед [редактированием сохранённого скрипта вручную](/docs/ru/workflows#edit-a-saved-script). Доступно, когда динамические workflows включены, и требует Claude Code v2.1.248 или позже |

169| `/workflows` | Открыть представление прогресса [workflow](/docs/ru/workflows#watch-the-run) для просмотра, паузы, возобновления или сохранения запущенных и завершённых workflows |170| `/workflows` | Открыть представление [workflow](/docs/ru/workflows#watch-the-run) прогресса для просмотра, паузы, возобновления или сохранения запущенных и завершённых workflows |

170 171

171<h2 id="how-the-command-menu-matches-what-you-type">172<h2 id="how-the-command-menu-matches-what-you-type">

172 Как меню команд соответствует вводимому тексту173 Как меню команд соответствует вводимому тексту

communications-kit.md +28 −27

Details

68 68

69 Куда идет ваш код: Claude Code работает в вашем терминале и разговаривает напрямую69 Куда идет ваш код: Claude Code работает в вашем терминале и разговаривает напрямую

70 с API Anthropic, без сторонних серверов в цепи. Он просит разрешение перед70 с API Anthropic, без сторонних серверов в цепи. Он просит разрешение перед

~~71 редактированием файлов или запуском команд. В соответствии с нашим соглашением Enterprise,~~71 редактированием файлов или запуском команд. В соответствии с нашим планом Team или Enterprise,

72 Anthropic не использует ваш код или подсказки для обучения своих моделей.72 Anthropic не использует ваш код или подсказки для обучения своих моделей.

~~73 Подробности: https://code.claude.com/docs/ru/data-usage~~73 Подробности: https://code.claude.com/docs/en/data-usage

~~74 https://code.claude.com/docs/ru/security~~74 https://code.claude.com/docs/en/security

75 75

76 Куда обратиться с вопросами: #claude-code. [Имя владельца] следит за этим76 Куда обратиться с вопросами: #claude-code. [Имя владельца] следит за этим

77 на этой неделе.77 на этой неделе.

96 выясните почему и исправьте".96 выясните почему и исправьте".

97 97

98 🔒 Работает в вашем терминале, разговаривает только с API Anthropic. В соответствии с нашим98 🔒 Работает в вашем терминале, разговаривает только с API Anthropic. В соответствии с нашим

~~99 планом Enterprise ваш код и подсказки не используются для обучения моделей.~~99 планом Team или Enterprise ваш код и подсказки не используются для обучения моделей.

100 Использование данных → https://code.claude.com/docs/ru/data-usage100 Использование данных → https://code.claude.com/docs/en/data-usage

101 101

102 📚 Quickstart · VS Code · Бесплатный курс на 1 час102 📚 Quickstart · VS Code · Бесплатный курс на 1 час

103 https://code.claude.com/docs/ru/quickstart103 https://code.claude.com/docs/en/quickstart

104 https://code.claude.com/docs/ru/vs-code104 https://code.claude.com/docs/en/vs-code

105 https://academy.claude.com/courses/claude-code-in-action105 https://academy.claude.com/courses/claude-code-in-action

106 106

107 Вопросы → в этой ветке. [Владелец] на точке.107 Вопросы → в этой ветке. [Владелец] на точке.

229*Fable* — это самая229*Fable* — это самая

230способная модель для ваших самых сложных, долгоживущих задач; это не230способная модель для ваших самых сложных, долгоживущих задач; это не

231значение по умолчанию, поэтому выберите его с помощью `/model fable`, и обратите внимание, что содержимое кибербезопасности и231значение по умолчанию, поэтому выберите его с помощью `/model fable`, и обратите внимание, что содержимое кибербезопасности и

232биологии автоматически переходит на Opus. Opus 5.5 и Opus 5 запускают свои собственные232биологии автоматически переходит на Opus. Opus 5.5, Sonnet 5.5 и

233проверки: отмеченное содержимое переключается на более ранний Opus, за исключением233Opus 5 запускают свои собственные проверки: отмеченное содержимое переключается на более ранний модель

234того, что отмеченное содержимое биологии на Opus 5 отклоняется.234в том же семействе, за исключением того, что отмеченное содержимое биологии на Opus 5 или Sonnet

2355.5 отклоняется.

235 236

236*Попробуйте сейчас:* введите `/model` и выберите Sonnet, если вы еще этого не сделали. Это237*Попробуйте сейчас:* введите `/model` и выберите Sonnet, если вы еще этого не сделали. Это

237правильное значение по умолчанию для большинства задач.238правильное значение по умолчанию для большинства задач.

243| - | - |244| - | - |

244| Fable | Самые сложные, долгоживущие задачи. Только по выбору: выберите его с помощью `/model fable`. Содержимое кибербезопасности или биологии вызывает [автоматический переход на Opus](/docs/ru/model-config#automatic-model-fallback) |245| Fable | Самые сложные, долгоживущие задачи. Только по выбору: выберите его с помощью `/model fable`. Содержимое кибербезопасности или биологии вызывает [автоматический переход на Opus](/docs/ru/model-config#automatic-model-fallback) |

245| Opus | Крупномасштабные рефакторинги, сложная отладка, архитектурные решения, высокорисковые изменения. На Opus 5.5 и Opus 5 содержимое кибербезопасности или биологии вызывает [автоматический переход или отказ](/docs/ru/model-config#automatic-model-fallback) |246| Opus | Крупномасштабные рефакторинги, сложная отладка, архитектурные решения, высокорисковые изменения. На Opus 5.5 и Opus 5 содержимое кибербезопасности или биологии вызывает [автоматический переход или отказ](/docs/ru/model-config#automatic-model-fallback) |

246| Sonnet | Повседневная работа с функциями, исправления ошибок, тесты, документация, обзор кода. Рекомендуемое значение по умолчанию. |247| Sonnet | Повседневная работа с функциями, исправления ошибок, тесты, документация, обзор кода. Рекомендуемое значение по умолчанию. На Sonnet 5.5 содержимое кибербезопасности или биологии вызывает [автоматический переход или отказ](/docs/ru/model-config#automatic-model-fallback) |

247| Haiku | Быстрые вопросы, форматирование, механические правки, быстрая итерация |248| Haiku | Быстрые вопросы, форматирование, механические правки, быстрая итерация |

248 249

249**Быстрые победы для попытки в первую очередь**250**Быстрые победы для попытки в первую очередь**

518```519```

519 520

520<h2 id="quick-reference">521<h2 id="quick-reference">

521 Быстрая справка522 Краткий справочник

522</h2>523</h2>

523 524

524<h3 id="faq-responses">525<h3 id="faq-responses">

529 530

530| Вопрос | Ответ |531| Вопрос | Ответ |

531| - | - |532| - | - |

532| "Это работает в VS Code?" | Да. Есть расширение VS Code и плагин JetBrains с теми же функциями, встроенные в ваш редактор. [VS Code →](/docs/ru/vs-code) |533| "Работает ли это в VS Code?" | Да. Существует расширение VS Code и плагин JetBrains с одинаковыми функциями, встроенные в ваш редактор. [VS Code →](/docs/ru/vs-code) |

533| "Мне нужно что-то настраивать в первую очередь?" | Нет. Установите, затем запустите `claude` в любом репозитории. Запустите `/init` один раз и все готово. [Quickstart →](/docs/ru/quickstart) |534| "Нужно ли мне что-то настраивать в первую очередь?" | Нет. Установите, затем запустите `claude` в любом репозитории. Запустите `/init` один раз и всё готово. [Быстрый старт →](/docs/ru/quickstart) |

534| "Куда идет мой код?" | CLI работает в вашем терминале и отправляет контекст в API Anthropic для вывода, без сторонних серверов. В соответствии с вашим планом Enterprise ваш код и подсказки не используются для обучения моделей. [Использование данных →](/docs/ru/data-usage) |535| "Куда идёт мой код?" | CLI работает в вашем терминале и отправляет контекст в API Anthropic для вывода, без серверов третьих сторон. В плане Team или Enterprise ваш код и подсказки не используются для обучения моделей. [Использование данных →](/docs/ru/data-usage) |

535| "Может ли он видеть весь мой репозиторий?" | Он читает то, к чему вы даете ему доступ. Чтение файлов в вашем рабочем каталоге не требует подсказки; подсказки разрешений контролируют редактирования, команды оболочки и что-либо вне этого каталога. Встроенный набор команд оболочки только для чтения, таких как `ls` и `cat`, работает без подсказок; ограничьте его с помощью [правил sandbox `denyRead`](/docs/ru/sandboxing#filesystem-isolation). [Разрешения →](/docs/ru/permissions) |536| "Может ли он видеть весь мой репозиторий?" | Он читает то, к чему вы ему даёте доступ. Чтение файлов в вашем рабочем каталоге не требует подтверждения; подсказки разрешений контролируют редактирование, команды оболочки, не являющиеся только для чтения, и чтение файлов инструментом file-tool вне этого каталога. Встроенный набор команд оболочки только для чтения, таких как `ls` и `cat`, работает без подтверждения; ограничьте его с помощью [правил sandboxing `denyRead`](/docs/ru/sandboxing#filesystem-isolation). [Разрешения →](/docs/ru/permissions) |

536| "Чем это отличается от Copilot?" | Copilot автодополняет строки. Claude Code — это агент, который читает файлы, запускает команды и делает многофайловые правки. [Обзор →](/docs/ru/overview) |537| "Чем это отличается от Copilot?" | Copilot автодополняет строки. Claude Code — это агент, который читает файлы, запускает команды и выполняет многофайловые редактирования. [Обзор →](/docs/ru/overview) |

537| "Что мне попробовать в первую очередь?" | Ошибка, которую вы откладывали, потому что это утомительно. "Тест в \[файл] нестабилен, выясните почему." [Quickstart →](/docs/ru/quickstart) |538| "Что мне попробовать в первую очередь?" | Ошибку, которую вы откладывали, потому что это утомительно. "Тест в \[файле] нестабилен, выясните почему." [Быстрый старт →](/docs/ru/quickstart) |

538 539

539<h3 id="prompt-templates">540<h3 id="prompt-templates">

540 Шаблоны подсказок541 Шаблоны подсказок

541</h3>542</h3>

542 543

543Поделитесь этими начальными подсказками с инженерами, которые установили, но не уверены, что спросить. Каждая сформулирована так, как она была бы введена в реальный сеанс; замените части в скобках файлами из вашего собственного репозитория.544Поделитесь этими начальными подсказками с инженерами, которые установили, но не уверены, что спросить. Каждая сформулирована так, как она была бы введена в реальной сессии; замените части в скобках на файлы из вашего собственного репозитория.

544 545

545| Задача | Подсказка |546| Задача | Подсказка |

546| - | - |547| - | - |

547| Исправить ошибку | "тесты в \[файл] не проходят, выясните почему и исправьте" |548| Исправить ошибку | "тесты в \[файле] не проходят, выясните почему и исправьте" |

548| Понять код | "расскажите мне, как работает \[модуль], затем скажите мне, где точка входа" |549| Понять код | "объясните мне, как работает \[модуль], затем скажите мне, где находится точка входа" |

549| Безопасный рефакторинг | "рефакторьте \[модуль] на \[цель], используйте plan mode, чтобы я мог сначала рецензировать" |550| Безопасный рефакторинг | "рефакторьте \[модуль] для \[цели], используйте Plan Mode, чтобы я мог сначала проверить" |

550| Написать тесты | "напишите тесты для \[файл], которые охватывают граничные случаи вокруг \[сценарий]" |551| Написать тесты | "напишите тесты для \[файла], которые охватывают граничные случаи вокруг \[сценария]" |

551| Рецензировать перед коммитом | "посмотрите на мой рабочий diff и скажите мне, что выглядит рискованно" |552| Проверить перед коммитом | "посмотрите на мой рабочий diff и скажите мне, что выглядит рискованно" |

552| Открыть PR | "исправьте \[проблема], напишите обычный коммит и откройте PR с резюме" |553| Открыть PR | "исправьте \[проблему], напишите обычный коммит и откройте PR с резюме" |

553| Создать skill | "создайте мне /ship skill, который запускает тесты и lint перед коммитом" |554| Создать skill | "создайте мне /ship skill, который запускает тесты и lint перед коммитом" |

554| Отладить stack trace | "вот stack trace, найдите основную причину, не просто замазывайте это" |555| Отладить трассировку стека | "вот трассировка стека, найдите основную причину, не просто замазывайте её" |

555 556

556<Tip>557<Tip>

557 Claude Code часто выпускается. Проверьте детали, специфичные для версии, на [домашней странице документации](/docs/ru/overview) перед распределением внутри.558 Claude Code выпускается часто. Проверьте детали, зависящие от версии, на [домашней странице документации](/docs/ru/overview) перед внутренним распространением.

558</Tip>559</Tip>

context-window.md +2 −2

Details

1632* **Очищайте между задачами**: запустите `/clear` при переходе на несвязанную работу. Старый разговор вытесняет файлы, которые вам нужны дальше, и стоит токены на каждом сообщении.1632* **Очищайте между задачами**: запустите `/clear` при переходе на несвязанную работу. Старый разговор вытесняет файлы, которые вам нужны дальше, и стоит токены на каждом сообщении.

1633* **Делегируйте большие чтения**: отправьте исследование [subagent](/docs/ru/sub-agents), чтобы содержимое файла оставалось в его контекстном окне, а не в вашем.1633* **Делегируйте большие чтения**: отправьте исследование [subagent](/docs/ru/sub-agents), чтобы содержимое файла оставалось в его контекстном окне, а не в вашем.

1634 1634

1635Если вам нужно большее окно, а не меньший разговор, Fable модели, Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают контекстное окно в 1 миллион токенов. Смотрите [Extended context](/docs/ru/model-config#extended-context) для доступности по плану и как выбрать вариант модели `[1m]`. Компактирование работает так же при большем лимите.1635Если вам нужно большее окно, а не меньший разговор, модели Fable, Sonnet 5 и более поздние версии, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают контекстное окно в 1 миллион токенов. Смотрите [Extended context](/docs/ru/model-config#extended-context) для доступности по плану и как выбрать вариант модели `[1m]`. Компактирование работает так же при большем лимите.

1636 1636

1637Sonnet 5 работает с контекстным окном 1M и не имеет варианта `[1m]` для выбора. Смотрите [Sonnet 5 context window](/docs/ru/model-config#sonnet-5-context-window) для его пороговых значений автокомпактирования и исключения шлюза LLM.1637Sonnet 5.5 и Sonnet 5 работают с контекстным окном 1M и не имеют варианта `[1m]` для выбора. Смотрите [Sonnet 5.5 and Sonnet 5 context window](/docs/ru/model-config#sonnet-5-5-and-sonnet-5-context-window) для их пороговых значений автокомпактирования и исключения шлюза LLM.

1638 1638

1639Точка, в которой запускается автоматическое компактирование, зависит от вашей модели и конфигурации. Смотрите [Default auto-compact thresholds](/docs/ru/model-config#default-auto-compact-thresholds) для границ по модели и [Correct the window for a gateway or custom model ID](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id), если Claude Code предполагает неправильное окно для вашего ID модели, например [LLM gateway](/docs/ru/llm-gateway) псевдоним.1639Точка, в которой запускается автоматическое компактирование, зависит от вашей модели и конфигурации. Смотрите [Default auto-compact thresholds](/docs/ru/model-config#default-auto-compact-thresholds) для границ по модели и [Correct the window for a gateway or custom model ID](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id), если Claude Code предполагает неправильное окно для вашего ID модели, например [LLM gateway](/docs/ru/llm-gateway) псевдоним.

1640 1640

costs.md +4 −1

Details

359 359

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

361 361

362Для более простых задач, где глубокое рассуждение не требуется, вы можете снизить затраты, понизив [уровень усилий](/docs/ru/model-config#adjust-effort-level) с помощью `/effort` или в `/model`, или отключив мышление в `/config`. Вы не можете отключить мышление на Opus 5.5 или моделях Fable, которые всегда используют расширенное мышление.362Для более простых задач, где глубокое рассуждение не требуется, вы можете снизить затраты, понизив [уровень усилий](/docs/ru/model-config#adjust-effort-level) с помощью `/effort` или в `/model`, или отключив мышление в `/config`. Вы не можете отключить мышление на Opus 5.5, Sonnet 5.5 или моделях Fable, которые всегда используют расширенное мышление.

363 363

364На моделях с [фиксированным бюджетом мышления](/docs/ru/model-config#adaptive-reasoning-and-fixed-thinking-budgets), вы также можете понизить бюджет путём установки переменной окружения `MAX_THINKING_TOKENS` [environment variable](/docs/ru/env-vars), например `MAX_THINKING_TOKENS=8000`. Модели адаптивного рассуждения игнорируют ненулевые бюджеты, поэтому используйте вместо этого уровни усилий.364На моделях с [фиксированным бюджетом мышления](/docs/ru/model-config#adaptive-reasoning-and-fixed-thinking-budgets), вы также можете понизить бюджет путём установки переменной окружения `MAX_THINKING_TOKENS` [environment variable](/docs/ru/env-vars), например `MAX_THINKING_TOKENS=8000`. Модели адаптивного рассуждения игнорируют ненулевые бюджеты, поэтому используйте вместо этого уровни усилий.

365 365

369 369

370Запуск тестов, получение документации или обработка файлов логов может потребить значительный контекст. Делегируйте эти [subagents](/docs/ru/sub-agents#isolate-high-volume-operations), чтобы многословный вывод оставался в контексте subagent, в то время как только резюме возвращается в вашу основную беседу.370Запуск тестов, получение документации или обработка файлов логов может потребить значительный контекст. Делегируйте эти [subagents](/docs/ru/sub-agents#isolate-high-volume-operations), чтобы многословный вывод оставался в контексте subagent, в то время как только резюме возвращается в вашу основную беседу.

371 371

372Собственные запросы subagent по-прежнему используют вашу квоту. Чтобы потратить меньше на них, [выберите меньшую модель для subagent](/docs/ru/sub-agents#choose-a-model) или [запустите каждый subagent на одной модели](/docs/ru/sub-agents#run-every-subagent-on-one-model).

373

372<h3 id="manage-agent-team-costs">374<h3 id="manage-agent-team-costs">

373 Управление затратами команды агентов375 Управление затратами команды агентов

374</h3>376</h3>

416* **Запланированные задачи**: [запланированная задача](/docs/ru/scheduled-tasks) срабатывает по своему интервалу даже во время простоя сессии, отправляя ваш полный контекст каждый раз418* **Запланированные задачи**: [запланированная задача](/docs/ru/scheduled-tasks) срабатывает по своему интервалу даже во время простоя сессии, отправляя ваш полный контекст каждый раз

417* **Сообщения между сессиями**: Claude Code доставляет [сообщение из другой вашей сессии](/docs/ru/cross-session-messaging) как новый ход, когда эта сессия находится в режиме ожидания, отправляя ваш полный контекст каждый раз. Чтобы удерживать входящие сообщения вместо их доставки, установите [`crossSessionInbound`](/docs/ru/settings-reference#crosssessioninbound) на `hold`419* **Сообщения между сессиями**: Claude Code доставляет [сообщение из другой вашей сессии](/docs/ru/cross-session-messaging) как новый ход, когда эта сессия находится в режиме ожидания, отправляя ваш полный контекст каждый раз. Чтобы удерживать входящие сообщения вместо их доставки, установите [`crossSessionInbound`](/docs/ru/settings-reference#crosssessioninbound) на `hold`

418* **Проверки целей**: пока фоновая работа держит активную [цель](/docs/ru/goal) в ожидании, Claude Code [просит Claude проверить эту работу](/docs/ru/goal#background-work-defers-evaluation) даже когда сессия находится в режиме ожидания, начиная новый ход, который отправляет ваш полный контекст. Claude Code начинает максимум три проверки в режиме ожидания на цель между вашими подсказками. До версии v2.1.246 проверки в режиме ожидания были неограниченными. Чтобы отключить проверки, установите [`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`](/docs/ru/env-vars) на `0`. Проверки в режиме ожидания требуют Claude Code v2.1.236 или позже420* **Проверки целей**: пока фоновая работа держит активную [цель](/docs/ru/goal) в ожидании, Claude Code [просит Claude проверить эту работу](/docs/ru/goal#background-work-defers-evaluation) даже когда сессия находится в режиме ожидания, начиная новый ход, который отправляет ваш полный контекст. Claude Code начинает максимум три проверки в режиме ожидания на цель между вашими подсказками. До версии v2.1.246 проверки в режиме ожидания были неограниченными. Чтобы отключить проверки, установите [`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`](/docs/ru/env-vars) на `0`. Проверки в режиме ожидания требуют Claude Code v2.1.236 или позже

421* **Подагенты и рабочие процессы**: каждый подагент и каждый агент, который порождает [динамический рабочий процесс](/docs/ru/workflows#cost), отправляют свои собственные запросы поверх запросов основной беседы. [Разбор атрибуции](#plan-usage-breakdown) показывает долю подагента

419* **Товарищи-агенты**: каждый активный [товарищ](#agent-team-token-costs) продолжает потреблять токены до выхода422* **Товарищи-агенты**: каждый активный [товарищ](#agent-team-token-costs) продолжает потреблять токены до выхода

420* **Компактность**: `/compact` читает беседу, которую он суммирует, поэтому [компактирование большого контекста](/docs/ru/prompt-caching#compacting-the-conversation) само по себе является большим запросом. Когда вы хотите свежее начало вместо непрерывности, `/clear` ничего не стоит423* **Компактность**: `/compact` читает беседу, которую он суммирует, поэтому [компактирование большого контекста](/docs/ru/prompt-caching#compacting-the-conversation) само по себе является большим запросом. Когда вы хотите свежее начало вместо непрерывности, `/clear` ничего не стоит

421 424

cross-session-messaging.md +86 −121

Details

14 14

15Сообщение — это фрагмент текста, который один Claude пишет другому, никогда не история разговора отправителя или файлы. Чтобы переместить весь разговор или его контекст, [возобновите сеанс](/docs/ru/sessions#resume-a-session) вместо этого.15Сообщение — это фрагмент текста, который один Claude пишет другому, никогда не история разговора отправителя или файлы. Чтобы переместить весь разговор или его контекст, [возобновите сеанс](/docs/ru/sessions#resume-a-session) вместо этого.

16 16

17Claude использует два инструмента для этого: `ListAgents` для обнаружения, какие агенты он может достичь, и `SendMessage` для доставки сообщения одному из них по имени. С помощью того же инструмента `SendMessage` Claude также может отправлять сообщения [подагентам](/docs/ru/sub-agents#resume-subagents) и товарищам [команды агентов](/docs/ru/agent-teams) в одном сеансе или команде. На этой странице рассматриваются сообщения между вашими независимыми сеансами.

19<h2 id="when-to-use-cross-session-messaging">17<h2 id="when-to-use-cross-session-messaging">

20 Когда использовать обмен сообщениями между сеансами18 Когда использовать обмен сообщениями между сеансами

21</h2>19</h2>

27* **Получение статуса от долгоживущей работы**: попросите миграцию или тестовый запуск отправить отчет обратно в сеанс, который вы наблюдаете, или попросите его оттуда. Если этот сеанс находится на этом компьютере, Claude также может [попросить одно уведомление, когда сеанс следующий раз перейдет в режим ожидания или выйдет](#get-a-notice-when-another-session-goes-idle).25* **Получение статуса от долгоживущей работы**: попросите миграцию или тестовый запуск отправить отчет обратно в сеанс, который вы наблюдаете, или попросите его оттуда. Если этот сеанс находится на этом компьютере, Claude также может [попросить одно уведомление, когда сеанс следующий раз перейдет в режим ожидания или выйдет](#get-a-notice-when-another-session-goes-idle).

28* **Отправка сообщений между машинами**: достичь один из ваших сеансов на другой машине или в веб-версии.26* **Отправка сообщений между машинами**: достичь один из ваших сеансов на другой машине или в веб-версии.

29 27

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

32* Чтобы продолжить один разговор в другом терминале или поделиться его контекстом с новым сеансом, [возобновите сеанс](/docs/ru/sessions#resume-a-session)

33* Для координируемой команды сеансов, которые Claude порождает и контролирует, используйте [команды агентов](/docs/ru/agent-teams)

34* Чтобы наблюдать и управлять многими сеансами из одного места, используйте [представление агента](/docs/ru/agent-view)

35* Чтобы управлять сеансом самостоятельно со своего телефона или другого устройства, вместо того чтобы сеансы отправляли друг другу сообщения, используйте [Удаленное управление](/docs/ru/remote-control)

36* Чтобы отправить внешние события, такие как результаты CI или сообщения чата, в сеанс, используйте [каналы](/docs/ru/channels)

38<h2 id="message-another-session">28<h2 id="message-another-session">

~~39 Отправка сообщения другому сеансу~~29 Отправить сообщение другой сессии

40</h2>30</h2>

41 31

42Когда один из ваших сеансов узнает что-то, что нужно другому сеансу, например находку, статус или решение, Claude передает это вместо того чтобы вы копировали и вставляли между терминалами. Claude обнаруживает цель с помощью `ListAgents` и отправляет с помощью `SendMessage`, поэтому вы никогда не вызываете ни один инструмент самостоятельно. Claude может решить отправить сообщение без просьбы, и вы также можете попросить его отправить одно.32Когда одна из ваших сессий узнает что-то, что нужно другой сессии, например находку, статус или решение, Claude передаёт это вместо того, чтобы вы копировали и вставляли между терминалами. Claude обнаруживает цель с помощью `ListAgents` и отправляет с помощью `SendMessage`, поэтому вы никогда не вызываете ни один из этих инструментов самостоятельно. Claude может решить отправить сообщение без просьбы, и вы также можете попросить его отправить одно.

43 33

44Чтобы попросить его самостоятельно, скажите Claude, что вы хотите, чтобы другой сеанс узнал или сделал. Этот пример — это подсказка, которую вы вводите, а не сообщение, которое отправляет Claude:34Чтобы попросить его самостоятельно, скажите Claude, что вы хотите, чтобы другая сессия узнала или сделала. Этот пример — это подсказка, которую вы вводите, а не сообщение, которое отправляет Claude:

45 35

46```text wrap theme={null}36```text wrap theme={null}

~~47Ask the session running in my other terminal whether the migration finished~~37Спросите сессию, работающую в моём другом терминале, закончилась ли миграция

48```38```

49 39

50Claude пишет само сообщение, поэтому ваша подсказка может оставить содержание Claude. Эта подсказка просит резюме без диктовки его формулировки, и то, что отправляет Claude, варьируется:40Claude пишет само сообщение, поэтому ваша подсказка может оставить содержание Claude. Эта подсказка просит резюме без диктовки его формулировки, и то, что отправляет Claude, варьируется:

51 41

52```text wrap theme={null}42```text wrap theme={null}

~~53Explain what we just did to the session working on the payments API~~43Объясните то, что мы только что сделали, сессии, работающей над API платежей

54```44```

55 45

56Чтобы назвать цель самостоятельно, упомяните сеанс в своей подсказке: введите `@` с последующими первыми буквами имени сеанса и выберите сеанс из раскрывающегося списка, так же как вы [@-упоминаете подагента](/docs/ru/sub-agents#invoke-subagents-explicitly). Требуется Claude Code v2.1.232 или более поздней версии. Claude Code вставляет упоминание, такое как `@api-worker`, и сообщает Claude, какой сеанс оно называет, поэтому Claude может отправить сообщение этому сеансу без предварительного составления списка ваших сеансов. Эта подсказка называет цель с упоминанием:46Чтобы назвать цель самостоятельно, упомяните сессию в своей подсказке: введите `@` и первые буквы имени сессии и выберите сессию из выпадающего списка, так же как вы [@-упоминаете подагента](/docs/ru/sub-agents#invoke-subagents-explicitly). Требуется Claude Code v2.1.232 или позже. Claude Code вставляет упоминание, например `@api-worker`, и говорит Claude, какую сессию оно называет, поэтому Claude может отправить сообщение этой сессии без предварительного списка ваших сессий. Эта подсказка называет цель с упоминанием:

57 47

58```text wrap theme={null}48```text wrap theme={null}

~~59Let @api-worker know the schema migration finished~~49Дайте знать @api-worker, что миграция схемы завершена

60```50```

61 51

62Раскрывающийся список показывает ваши другие активные сеансы на этом компьютере. Два случая требуют больше, чем первые буквы имени:52Выпадающий список показывает ваши другие активные сессии на этой машине. Два случая требуют больше, чем первые буквы имени:

63 53

64* **Сеанс за пределами этого компьютера**: облачный сеанс или сеанс удаленного управления появляется в раскрывающемся списке только после того, как Claude составит список или отправит сообщения вашим сеансам за пределами этого компьютера, поэтому сначала попросите Claude составить их список.54* **Сессия за пределами этой машины**: облачная или сессия Remote Control появляется в выпадающем списке только после того, как Claude перечислит или отправит сообщение вашим сессиям за пределами этой машины, поэтому сначала попросите Claude их перечислить.

65* **Имя с пробелом или другими символами вне букв, цифр, дефисов и подчеркиваний**: введите его в двойных кавычках, например `@"release notes"`. Когда вы выбираете сеанс из раскрывающегося списка, Claude Code вставляет кавычки для вас.55* **Имя с пробелом или другими символами вне букв, цифр, дефисов и подчёркиваний**: введите его в двойных кавычках, например `@"release notes"`. Когда вы выбираете сессию из выпадающего списка, Claude Code вставляет кавычки для вас.

66 56

67Вы также можете ввести упоминание без средства выбора. Когда более одного активного сеанса отвечает на упомянутое имя, Claude спросит вас, какой вы имеете в виду, прежде чем отправить.57Вы также можете ввести упоминание без средства выбора. Когда более одной активной сессии отвечает на упомянутое имя, Claude спросит вас, какую вы имеете в виду, прежде чем отправить.

68 58

69Чтобы увидеть, как выглядит сообщение, которое пишет Claude, когда оно прибывает, включая пример одного, смотрите [как выглядит сообщение](#what-a-message-looks-like).59О том, как выглядит сообщение, которое пишет Claude, когда оно прибывает, включая пример одного, см. [как выглядит сообщение](#what-a-message-looks-like).

70 60

71<h3 id="message-delivery">61<h3 id="message-delivery">

72 Доставка сообщения62 Доставка сообщения

73</h3>63</h3>

74 64

75Получающий Claude читает сообщение между вызовами инструментов во время активного хода, поэтому работающий инструмент никогда не прерывается. Когда получающий сеанс неактивен, Claude Code начинает новый ход с сообщением.65Получающий Claude читает сообщение между вызовами инструментов во время активного хода, поэтому работающий инструмент никогда не прерывается. Когда получающая сессия неактивна, Claude Code начинает новый ход с сообщением.

76 66

77Сообщение от другого сеанса прибывает как простой текст. Если оно упоминает файл или [ресурс MCP](/docs/ru/mcp#use-mcp-resources) с `@`, Claude видит упоминание как написанное, и Claude Code ничего не прикрепляет, независимо от того, начинает ли сообщение новый ход или прибывает во время одного. Claude все еще может открыть упомянутый путь на получающей машине со своими собственными инструментами, в соответствии с разрешениями этого сеанса. До v2.1.251 упоминание `@` в сообщении, которое начало новый ход, прикрепляло файл или ресурс MCP на получающей стороне.67Сообщение от другой сессии поступает как простой текст. Если оно упоминает файл или [ресурс MCP](/docs/ru/mcp#use-mcp-resources) с `@`, Claude видит упоминание в том виде, в котором оно написано, и Claude Code ничего не прикрепляет, независимо от того, начинает ли сообщение новый ход или прибывает во время одного. Claude всё ещё может открыть упомянутый путь на получающей машине со своими собственными инструментами, в соответствии с разрешениями этой сессии.

78 68

79Claude Code отказывает в сообщении в следующих случаях:69Claude Code отказывает в сообщении в следующих случаях:

80 70

81* Сообщение [превышает ограничение размера](#limitations). Claude Code отказывает ему в отправляющем сеансе, прежде чем оно уйдет.71* Сообщение [превышает ограничение размера](#limitations). Claude Code отказывает ему в отправляющей сессии, прежде чем оно уйдёт.

82* Быстрый всплеск к сеансу на этом компьютере достиг [того, что принимает входящий ящик этого сеанса](#limitations). Claude Code отказывает дальнейшие сообщения этому сеансу.72* Быстрый поток к сессии на этой машине достиг [того, что принимает входящий ящик этой сессии](#limitations). Claude Code отказывает в дальнейших сообщениях этой сессии.

83* Цель ответа на этом компьютере не проходит проверку безопасности, такую как символическая ссылка на цель или конечная точка, которая не является ожидаемым процессом. [Отказ в отправке сообщения между сеансами](/docs/ru/errors#refusing-to-send-a-cross-session-message) перечисляет эти проверки.73* Цель ответа на этой машине не проходит проверку безопасности, например символическая ссылка на цель. [Отказ отправить кросс-сессионное сообщение](/docs/ru/errors#refusing-to-send-a-cross-session-message) перечисляет эти проверки.

84* Claude адресует сообщение собственному имени этого сеанса, как описано в разделе [Посмотрите, какие сеансы Claude может достичь](#see-which-sessions-claude-can-reach).

85 74

86Получающий сеанс проверяет каждое прибывающее сообщение против своих собственных [входящих элементов управления](#control-inbound-messages), и проверка заканчивается одним из трех результатов:75Получающая сессия проверяет каждое поступающее сообщение против своих собственных [входящих элементов управления](#control-inbound-messages), и проверка заканчивается одним из трёх результатов:

87 76

~~88* **Доставлено**: Claude Code передает сообщение получающему Claude.~~77* **Доставлено**: Claude Code передаёт сообщение получающему Claude.

89* **Удержано**: Claude Code откладывает сообщение в сторону недоставленным. Удержанное сообщение достигает Claude только когда вы его одобрите или позже применится режим или изменение параметров, которое его позволяет.78* **Удержано**: Claude Code откладывает сообщение недоставленным. Удержанное сообщение достигает Claude только когда вы его одобрите или позже режим или изменение параметров позволит это.

90* **Отказано**: Claude Code отбрасывает сообщение без доставки.79* **Отказано**: Claude Code отбрасывает сообщение без доставки.

91 80

92После доставки сообщение учитывается в [использовании](/docs/ru/costs) как подсказка, которую вы вводите, и получающий Claude может ответить отправителю так же, за исключением [одностороннего случая между машинами](#message-sessions-on-other-machines).81После доставки сообщение учитывается в [использовании](/docs/ru/costs) как подсказка, которую вы вводите, и получающий Claude может ответить отправителю так же, за исключением [одностороннего кросс-машинного случая](#message-sessions-on-other-machines).

93 82

94Границы разрешений остаются для каждого сеанса. Claude инструктирован никогда не просить другой сеанс о действии, которое было отклонено или заблокировано в его собственном сеансе, или которое его собственные параметры разрешений заблокировали бы, и маршрутизировать эту работу обратно вам. На получающей стороне [собственные подсказки разрешений и правила получающего сеанса все еще применяются](#how-a-session-treats-an-incoming-message) ко всему, что сообщение просит.83Границы разрешений остаются для каждой сессии. Claude инструктирован никогда не просить другую сессию о действии, которое было отклонено или заблокировано в его собственной сессии, или которое его собственные параметры разрешений заблокировали бы, и вместо этого направить эту работу вам. На стороне получения [собственные подсказки разрешений получающей сессии и правила всё ещё применяются](#how-a-session-treats-an-incoming-message) ко всему, что сообщение просит.

95 84

96<h3 id="get-a-notice-when-another-session-goes-idle">85<h3 id="get-a-notice-when-another-session-goes-idle">

~~97 Получение уведомления, когда другой сеанс переходит в режим ожидания~~86 Получить уведомление, когда другая сессия становится неактивной

98</h3>87</h3>

99 88

100Claude может попросить один из ваших сеансов на этом компьютере отправить обратно одно уведомление, когда этот сеанс следующий раз перейдет в режим ожидания или выйдет. Режим ожидания здесь означает, что сеанс завершил ход без ничего в очереди. Используйте это, когда вы ждете долгую задачу в другом сеансе и хотите услышать, когда она будет готова, вместо проверки. Требуется Claude Code v2.1.236 или более поздней версии в обоих сеансах.89Claude может попросить одну из ваших сессий на этой машине отправить обратно одно уведомление, когда эта сессия в следующий раз станет неактивной или выйдет. Неактивность здесь означает, что сессия завершила ход без ничего в очереди. Используйте это, когда вы ждёте длительной задачи в другой сессии и хотите узнать, когда она будет готова, вместо проверки. Требуется Claude Code v2.1.236 или позже в обеих сессиях.

101 90

102<h4 id="ask-for-a-notice">91<h4 id="ask-for-a-notice">

103 Запрос уведомления92 Попросить уведомление

104</h4>93</h4>

105 94

106Скажите Claude, что вы ждете. Эта подсказка запрашивает уведомление из сеанса миграции:95Скажите Claude, на что вы ждёте. Эта подсказка просит уведомление из сессии миграции:

107 96

108```text wrap theme={null}97```text wrap theme={null}

109Tell me when the migration session finishes what it's working on98Скажите мне, когда сессия миграции закончит то, над чем она работает

110```99```

111 100

112Claude подписывается с помощью входного параметра `notify_when_idle` инструмента `SendMessage`, либо прикрепленного к сообщению, которое он отправляет в любом случае, либо самостоятельно. Самостоятельно Claude Code подписывается без запуска хода или трат токенов в наблюдаемом сеансе и отправляет уведомление сразу же, если этот сеанс уже неактивен. Прикрепленное к сообщению Claude Code сначала доставляет сообщение и отправляет уведомление позже.101Claude подписывается с помощью входного параметра `notify_when_idle` инструмента `SendMessage`, либо прикреплённого к сообщению, которое оно отправляет в любом случае, либо самостоятельно. Самостоятельно Claude Code подписывается без запуска хода или трат токенов в наблюдаемой сессии, и отправляет уведомление сразу же, если эта сессия уже неактивна. Прикреплённое к сообщению, Claude Code сначала доставляет сообщение и отправляет уведомление позже.

113 102

114<h4 id="what-each-session-shows">103<h4 id="what-each-session-shows">

115 Что показывает каждый сеанс104 Что показывает каждая сессия

116</h4>105</h4>

117 106

118Наблюдаемый сеанс показывает строку, говорящую, что другой процесс попросил быть уведомленным, когда сеанс следующий раз перейдет в режим ожидания. Запрашивающий сеанс показывает уведомление как строку, называющую наблюдаемый сеанс. Строка может включать время завершения хода этого сеанса и однострочный статус из этого хода. Если запрашивающий сеанс неактивен, Claude Code начинает новый ход с уведомлением.107Наблюдаемая сессия показывает строку, говорящую, что другой процесс попросил быть уведомлённым, когда сессия в следующий раз станет неактивной. Запрашивающая сессия показывает уведомление как строку, называющую наблюдаемую сессию. Строка может включать время завершения хода этой сессии и однострочный статус из этого хода. Если запрашивающая сессия неактивна, Claude Code начинает новый ход с уведомлением.

119 108

120<h4 id="limits">109<h4 id="limits">

121 Ограничения110 Ограничения

122</h4>111</h4>

123 112

124Уведомление является одноразовым: Claude Code отправляет его один раз из наблюдаемого сеанса, и ни один сеанс не опрашивает другой. Если уведомление не прибывает в течение 12 часов, Claude Code отбрасывает подписку и сообщает Claude, поэтому оно не продолжает ждать.113Если уведомление не поступит в течение 12 часов, Claude Code отбрасывает подписку и говорит Claude, поэтому оно не продолжает ждать.

125 114

126[Входящие элементы управления](#control-inbound-messages) каждой стороны применяются к уведомлению как к сообщению:115[Входящие элементы управления](#control-inbound-messages) каждой стороны применяются к уведомлению как к сообщению:

127 116

128* **`refuse` на любой стороне**: ничего не прибывает. Наблюдаемый сеанс отбрасывает запрос без записи или ответа на него, поэтому подписка истекает без ответа через 12 часов, и запрашивающий сеанс с `refuse` никогда не подписывается.117* **`refuse` на любой стороне**: ничего не поступает. Наблюдаемая сессия отбрасывает запрос без записи или ответа на него, поэтому подписка истекает без ответа через 12 часов, и запрашивающая сессия с `refuse` никогда не подписывается.

129* **`hold` на любой стороне**: уведомление прибывает с меньшим. Наблюдаемый сеанс опускает однострочный статус, и запрашивающий сеанс показывает уведомление в вашей расшифровке без доставки его Claude.118* **`hold` на любой стороне**: уведомление поступает с меньшим. Наблюдаемая сессия оставляет однострочный статус, и запрашивающая сессия показывает уведомление в вашей расшифровке без доставки его Claude.

130 119

131Только Claude в вашем основном разговоре может подписаться, и только на ваши сеансы на этом компьютере. Когда подагент или товарищ команды агентов устанавливает `notify_when_idle`, Claude Code не делает подписку и сообщает ему об этом. Когда Claude просит уведомление от любого другого агента, такого как товарищ, подагент или сеанс за пределами этого компьютера, Claude Code отказывает весь вызов, включая любое прикрепленное сообщение, и сообщает об отказе Claude, чтобы оно могло отправить сообщение без запроса.120Только Claude в вашем основном разговоре может подписаться, и только на ваши сессии на этой машине. Когда Claude просит уведомление от любой другой цели, такой как товарищ по команде, подагент или сессия за пределами этой машины, Claude Code отказывает во всём вызове, включая любое сообщение, прикреплённое к нему.

132 121

133<h3 id="see-which-sessions-claude-can-reach">122<h3 id="see-which-sessions-claude-can-reach">

134 Посмотрите, какие сеансы Claude может достичь123 Посмотрите, какие сессии может достичь Claude

135</h3>124</h3>

136 125

137Claude находит цель сообщения самостоятельно, поэтому вам не нужно ничего запускать перед тем как попросить его отправить. Чтобы увидеть самостоятельно, какие сеансы Claude может достичь, запустите команду `/list-agents`. Первая строка, когда присутствует, — это имя этого сеанса, то, которое ваши другие сеансы используют для отправки ему сообщений. Строки ниже — это сеансы, которые Claude может достичь:126Claude находит цель сообщения самостоятельно, поэтому вам не нужно ничего запускать перед тем, как просить его отправить. Чтобы самостоятельно увидеть, какие сессии может достичь Claude, запустите команду `/list-agents`. Первая строка, если она присутствует, — это имя этой сессии, то, которое ваши другие сессии используют для отправки ей сообщений. Строки ниже — это сессии, которые может достичь Claude:

~~138~~

139* **Подагенты**: агенты, работающие внутри текущего сеанса.

140* **Товарищи**: товарищи [команды агентов](/docs/ru/agent-teams) этого сеанса. До v2.1.239 товарищи не появлялись в списке, хотя Claude уже мог отправлять им сообщения по имени.

141* **Ваши другие локальные сеансы**: сеансы Claude Code, работающие на одной машине, включая [фоновые сеансы](/docs/ru/agent-view). Сеанс появляется только когда он привязывает [входящий сокет](#the-sessions-inbox-socket).

142* **Ваши облачные сеансы**: ваши сеансы [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web), показанные пока этот сеанс подключен к [Удаленному управлению](/docs/ru/remote-control). Claude Code помечает их `cloud` в списке.

143* **Ваши сеансы удаленного управления на других машинах**: показаны пока этот сеанс подключен к [Удаленному управлению](/docs/ru/remote-control), и помечены `Remote Control`. Claude Code показывает `offline` как статус сеанса, чье соединение удаленного управления упало.

144 127

145Этот сеанс не является одной из строк. Если Claude адресует сообщение собственному имени этого сеанса, Claude Code отказывает и сообщает Claude, что цель — текущий сеанс. До v2.1.239 список не показывал имя этого сеанса, и Claude Code сообщал о сообщении, отправленном ему, как об агенте, которого он не мог найти.128* **Подагенты**: агенты, работающие внутри текущей сессии.

129* **Товарищи по команде**: товарищи по команде [команды агентов](/docs/ru/agent-teams) этой сессии.

130* **Ваши другие локальные сессии**: сессии Claude Code, работающие на одной машине, включая [фоновые сессии](/docs/ru/agent-view). Сессия появляется только когда она привязывает [сокет входящего ящика](#the-sessions-inbox-socket).

131* **Ваши [облачные сессии](/docs/ru/claude-code-on-the-web)**: показаны, пока эта сессия подключена к [Remote Control](/docs/ru/remote-control).

132* **Ваши сессии Remote Control на других машинах**: показаны, пока эта сессия подключена к [Remote Control](/docs/ru/remote-control), и помечены `Remote Control`. Claude Code показывает `offline` как статус сессии, чьё соединение Remote Control разорвалось.

146 133

147Пока этот сеанс подключен к [Удаленному управлению](/docs/ru/remote-control), Claude Code скрывает некоторые детали ваших локальных сеансов из вывода `/list-agents`, без изменения того, что Claude видит, когда ищет сеанс для отправки сообщения:134Пока эта сессия подключена к [Remote Control](/docs/ru/remote-control), Claude Code скрывает некоторые детали ваших локальных сессий из вывода `/list-agents`, без изменения того, что видит сам Claude при поиске сессии для отправки сообщения:

148 135

149* **Рабочие каталоги**: он опускает рабочий каталог каждого локального сеанса.136* **Рабочие каталоги**: оно оставляет рабочий каталог каждой локальной сессии.

150* **Имена сеансов**: он опускает любое имя сеанса, которое не может приписать человеку, поэтому строка, оставленная без имени, читается как `(unnamed session)`.137* **Имена сессий**: оно оставляет любое имя сессии, которое не может приписать человеку, поэтому строка, оставленная без имени, читается как `(unnamed session)`.

151* **Первая строка**: он опускает строку с именем этого сеанса, если вы не вводили это имя на этом терминале, с `--name` или с `/rename` и имя, с момента запуска или последнего возобновления сеанса.138* **Первая строка**: оно оставляет строку с именем этой сессии, если вы не вводили это имя на этом терминале, с `--name` или с `/rename` и имя, с момента запуска или последнего возобновления сессии.

152 139

153Когда вывод что-то перечисляет, он заканчивается примечанием, говорящим, что детали были скрыты. Запуск `/rename` с последующим неиспользованным именем на клавиатуре сеанса дает этому сеансу имя, которое появляется в выводе.140Когда вывод что-то перечисляет, он заканчивается примечанием, говорящим, что детали были скрыты. Запуск `/rename` с последующим неиспользуемым именем на клавиатуре сессии даёт этой сессии имя, которое появляется в выводе.

154 141

155Claude Code читает ваши облачные и списки сеансов удаленного управления от новейших и останавливается после ограниченного количества страниц для каждого. Если ваша учетная запись имеет больше этих сеансов, чем подходит, Claude Code не перечисляет старые, и Claude не может отправлять им сообщения по имени. Когда это происходит, Claude Code говорит об этом в списке, и Claude видит то же примечание, когда отправляет сообщение.142Сессия отвечает на имя, которое вы установили с помощью команды [`/rename`](/docs/ru/commands) или флага [`--name`](/docs/ru/cli-reference#cli-flags). Когда вы не устанавливаете его, Claude Code называет сессию сам. Для интерактивной сессии это имя, показанное в [списках работающих сессий](/docs/ru/sessions#name-your-sessions).

156 143

157Claude адресует сеанс за пределами этого компьютера по имени, так же как локальный сеанс. Смотрите [Отправка сообщений сеансам на других машинах](#message-sessions-on-other-machines) для того, как эти сообщения путешествуют.144Когда вы переименовываете сессию или запускаете или возобновляете интерактивную с именем, которое другая активная сессия на этой машине уже использует, Claude Code оставляет имя с сессией, которая уже его имеет, и [переименовывает ваше в вариант](/docs/ru/sessions#name-your-sessions). Сессии всё ещё могут делить имя, например когда одна из них запускает более раннюю версию Claude Code или общее имя — это то, что Claude Code сгенерировал. Если эта сессия не подключена к Remote Control, Claude Code показывает рабочий каталог каждой локальной сессии в выводе `/list-agents`, поэтому вы можете отличить сессии с одинаковыми именами, когда они работают в разных каталогах. Claude адресует сообщение одним из двух способов, в зависимости от того, сколько активных сессий отвечают на имя:

158 145

159Сеанс отвечает на имя, которое вы устанавливаете с помощью команды [`/rename`](/docs/ru/commands) или флага [`--name`](/docs/ru/cli-reference#cli-flags). Когда вы не устанавливаете одно, Claude Code называет сеанс сам. Для интерактивного сеанса это имя, показанное в [списках работающих сеансов](/docs/ru/sessions#name-your-sessions).146* **Одна сессия отвечает на имя**: Claude Code доставляет сообщение только по имени.

~~160~~ 147* **Несколько сессий делят имя, или Claude Code не смог проверить везде, где работают ваши сессии**: Claude добавляет короткий идентификатор к каждой строке своего списка и использует идентификатор в адресе.

161Когда вы переименовываете сеанс, Claude Code также обновляет общую запись, которую ваши другие сеансы используют для поиска имени сеанса. Если он не может обновить эту запись, он предупреждает вас в выводе `/rename`, что другие сеансы могут все еще показывать старое имя. Запустите сеанс с [`--debug`](/docs/ru/cli-reference#cli-flags), и Claude Code регистрирует причину неудачного обновления.

~~162~~

163Когда вы переименовываете сеанс или запускаете или возобновляете интерактивный с именем, которое другой активный сеанс на этом компьютере уже использует, Claude Code оставляет имя с сеансом, который уже его имеет, и [переименовывает ваше в вариант](/docs/ru/sessions#name-your-sessions). Сеансы все еще могут делить имя, например когда один из них запускает более раннюю версию Claude Code или общее имя — это то, что Claude Code сгенерировал. Если этот сеанс не подключен к удаленному управлению, Claude Code показывает рабочий каталог каждого локального сеанса в выводе `/list-agents`, поэтому вы можете отличить сеансы с одинаковым именем, когда они работают в разных каталогах. Claude адресует сообщение одним из двух способов, в зависимости от того, сколько активных сеансов отвечают на имя:

~~164~~

165* **Один сеанс отвечает на имя**: Claude Code доставляет сообщение только по имени.

166* **Несколько сеансов делят имя, или Claude Code не мог проверить везде, где работают ваши сеансы**: Claude добавляет короткий идентификатор к каждой строке своего списка и использует идентификатор в адресе.

167 148

168<h3 id="message-sessions-on-other-machines">149<h3 id="message-sessions-on-other-machines">

169 Отправка сообщений сеансам на других машинах150 Отправить сообщение сессиям на других машинах

170</h3>151</h3>

171 152

172Как сообщение путешествует и проходит ли оно через серверы Anthropic, зависит от того, где работает целевой сеанс:153Как путешествует сообщение и проходит ли оно через серверы Anthropic, зависит от того, где работает целевая сессия:

173 154

174| Где работает другой сеанс | Как путешествует сообщение |155| Где работает другая сессия | Как путешествует сообщение |

175| :- | :- |156| :- | :- |

176| На этом компьютере | Через сокет для каждого сеанса на macOS и Linux, или именованный канал для каждого сеанса на нативной Windows, никогда через серверы Anthropic |157| На этой машине | Через сокет для каждой сессии на macOS и Linux или именованный канал для каждой сессии на нативной Windows, никогда через серверы Anthropic |

177| На другой из ваших машин | Через серверы Anthropic, прибывая через соединение [Удаленного управления](/docs/ru/remote-control) этой машины |158| На другой из ваших машин | Через серверы Anthropic, прибывая через соединение [Remote Control](/docs/ru/remote-control) этой машины |

178| На [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) | Через серверы Anthropic, прямо в облачный сеанс |159| В [облаке](/docs/ru/claude-code-on-the-web) | Через серверы Anthropic, прямо в облачную сессию |

~~179~~

180Начало разговора с сеансом на другой из ваших машин требует Claude Code v2.1.225 или более поздней версии и цели, которая [появляется в списке](#see-which-sessions-claude-can-reach). До v2.1.225 Claude мог только ответить на сообщение, которое прибыло от одного.

181 160

182Вы можете отправить сообщение сеансу, показанному как `offline` в [списке](#see-which-sessions-claude-can-reach), тому, чье соединение удаленного управления упало. Отправка проходит, но сообщение прибывает только после того, как машина этого сеанса переподключится. Claude сообщается об этом, когда отправляет.161Начало разговора с сессией на другой из ваших машин требует Claude Code v2.1.225 или позже и цель, которая [появляется в списке](#see-which-sessions-claude-can-reach).

183 162

184Доставка на одной машине работает везде, где функция включена. Каждый сеанс регистрирует себя в файлах на диске. Когда Claude составляет список или отправляет сообщения вашим локальным сеансам, Claude Code читает эти файлы для поиска сеансов, поэтому два сеанса могут достичь друг друга только когда они могут видеть одни и те же файлы.163Вы можете отправить сообщение сессии, показанной как `offline` в [списке](#see-which-sessions-claude-can-reach), той, чьё соединение Remote Control разорвалось. Отправка проходит, но сообщение прибывает только после того, как машина этой сессии переподключится.

185 164

186Контейнер имеет свою собственную файловую систему, поэтому сеанс внутри него и сеанс на хосте не могут достичь друг друга. Два сеанса внутри одного контейнера все еще могут отправлять друг другу сообщения, включая на [самостоятельно размещенном runner](/docs/ru/self-hosted-environments). Сеанс внутри WSL 2 и нативный сеанс Windows на одном компьютере также не могут достичь друг друга, потому что они регистрируются в разных домашних каталогах и слушают разные типы сокетов.165Сессия внутри контейнера и сессия на хосте не могут достичь друг друга. Две сессии внутри одного контейнера всё ещё могут отправлять сообщения друг другу, включая на [самостоятельно размещённом раннере](/docs/ru/self-hosted-environments). Сессия внутри WSL 2 и нативная сессия Windows на одном компьютере также не могут достичь друг друга.

187 166

188Пока этот сеанс подключен к удаленному управлению, когда вы отправляете сообщение сеансу на другой из ваших машин, Claude Code показывает сообщение в разговоре этого сеанса под именем удаленного управления этого сеанса. Claude на этой машине может ответить на это имя. Например, когда этот сеанс подключен к удаленному управлению как `laptop-graceful-unicorn` и вы отправляете сообщение вашему рабочему столу, вы видите сообщение в сеансе рабочего стола под `laptop-graceful-unicorn`.167Если эта сессия не подключена к Remote Control, когда Claude отправляет сессии за пределами этой машины, сообщение всё ещё проходит, но без [адреса ответа](#what-a-message-looks-like), поэтому получающий Claude не может ответить на него.

189 168

190Если этот сеанс не подключен к удаленному управлению, когда Claude отправляет сеансу за пределами этого компьютера, сообщение все еще проходит, но без [адреса ответа](#what-a-message-looks-like), поэтому получающий Claude не может ответить на него. Claude сообщается об этом, когда отправляет.169Чтобы требовать вашего одобрения перед отправкой любого сообщения за пределы этой машины, установите [`isolatePeerMachines`](#require-approval-for-cross-machine-messages).

~~191~~

192Чтобы требовать вашего одобрения перед тем как любое сообщение выйдет за пределы этого компьютера, установите [`isolatePeerMachines`](#require-approval-for-cross-machine-messages).

193 170

194<h2 id="how-a-session-treats-an-incoming-message">171<h2 id="how-a-session-treats-an-incoming-message">

195 Как сеанс обрабатывает входящее сообщение172 Как сеанс обрабатывает входящее сообщение

206 Как выглядит сообщение183 Как выглядит сообщение

207</h3>184</h3>

208 185

209Когда сообщение прибывает, Claude Code показывает его в разговоре как тусклый однострочный предпросмотр, и строка предпросмотра остается в разговоре впоследствии. Предпросмотр несет имя отправителя и первую строку сообщения, обрезанную с `…` когда она длинная, такую как `› Message from @api-worker: Schema migration finished (ctrl+o to expand)`. До v2.1.247 Claude Code показывал прибывающее сообщение полностью вместо предпросмотра.186Когда сообщение прибывает, Claude Code показывает его в разговоре как тусклый однострочный предпросмотр, и строка предпросмотра остается в разговоре впоследствии. Предпросмотр несет имя отправителя и первую строку сообщения, обрезанную с `…` когда она длинная, такую как `› Message from @api-worker: Schema migration finished (ctrl+o to expand)`.

210 187

211Любое из этих показывает вам полный текст:188Любое из этих показывает вам полный текст:

212 189

215 192

216Предпросмотр сокращает только то, что вы видите. Независимо от того, расширяете ли вы его, Claude читает полное сообщение.193Предпросмотр сокращает только то, что вы видите. Независимо от того, расширяете ли вы его, Claude читает полное сообщение.

217 194

218Claude получает сообщение с именем отправителя и адресом ответа, за исключением [одностороннего сообщения между машинами](#message-sessions-on-other-machines), которое не несет адреса ответа. Помимо имени и адреса ответа, получающий Claude получает текст сообщения, никогда историю разговора отправителя или файлы. [Доставка сообщения](#message-delivery) охватывает упоминания `@` в тексте.195Claude получает сообщение с именем отправителя и адресом ответа, за исключением [одностороннего сообщения между машинами](#message-sessions-on-other-machines), которое не несет адреса ответа.

~~219~~

220Сообщение, которое написал [подагент](/docs/ru/sub-agents), прибывает под именем отправляющего сеанса, с подагентом, идентифицированным в тексте сообщения. Ответ на него достигает основного разговора этого сеанса, а не подагента.

221 196

222Этот пример — это сообщение, которое один Claude написал другому, как его полный текст читается, когда вы его расширяете:197Этот пример — это сообщение, которое один Claude написал другому, как его полный текст читается, когда вы его расширяете:

223 198

240 215

241Помимо редактирования файла параметров, вы можете выбрать значение в строке `/config` **Messages from your other sessions**. Claude Code записывает выбранное вами значение в ваши пользовательские параметры. Строка требует Claude Code v2.1.232 или более поздней версии и не появляется, пока управляемые параметры или флаг `--settings` устанавливает ключ, так как значение пользовательских параметров не применялось бы тогда. Claude Code отклоняет сокращение `/config crossSessionInbound=value` для этого ключа.216Помимо редактирования файла параметров, вы можете выбрать значение в строке `/config` **Messages from your other sessions**. Claude Code записывает выбранное вами значение в ваши пользовательские параметры. Строка требует Claude Code v2.1.232 или более поздней версии и не появляется, пока управляемые параметры или флаг `--settings` устанавливает ключ, так как значение пользовательских параметров не применялось бы тогда. Claude Code отклоняет сокращение `/config crossSessionInbound=value` для этого ключа.

242 217

243Чтобы увидеть, какое значение применяется, следуйте правилам приоритета `crossSessionInbound` в [справочнике параметров](/docs/ru/settings-reference#crosssessioninbound). Когда значение не применяется, Claude Code решает для каждого сообщения из режимов разрешений двух сеансов. Он группирует сеансы, которые [обходят запросы разрешений](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) в один класс, и каждый другой сеанс в другой. План режим считается обходящим в интерактивных сеансах терминала с доступными разрешениями обхода, и [авто](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), `acceptEdits` и `dontAsk` считаются запрашивающими:218Чтобы увидеть, какое значение применяется, следуйте правилам приоритета `crossSessionInbound` в [справочнике параметров](/docs/ru/settings-reference#crosssessioninbound).

219

220Когда значение не применяется, Claude Code решает для каждого сообщения из режимов разрешений двух сеансов. Он группирует сеансы, которые [обходят запросы разрешений](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) в один класс, и каждый другой сеанс в другой. Plan Mode считается обходящим в интерактивных сеансах терминала с доступными разрешениями обхода, и [auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), `acceptEdits` и `dontAsk` считаются запрашивающими:

244 221

245* **Получающий сеанс запрашивает разрешения**: Claude Code доставляет каждое сообщение. Он удерживает одно для вашего одобрения только когда отправляющий сеанс идентифицирует себя как обходящий запросы разрешений.222* **Получающий сеанс запрашивает разрешения**: Claude Code доставляет каждое сообщение. Он удерживает одно для вашего одобрения только когда отправляющий сеанс идентифицирует себя как обходящий запросы разрешений.

246* **Получающий сеанс обходит запросы разрешений**: Claude Code удерживает каждое сообщение для вашего одобрения. Он доставляет одно только когда отправляющий сеанс идентифицирует себя как также обходящий.223* **Получающий сеанс обходит запросы разрешений**: Claude Code удерживает каждое сообщение для вашего одобрения. Он доставляет одно только когда отправляющий сеанс идентифицирует себя как также обходящий.

252* Когда диалог остается без ответа после крайнего срока [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), Claude Code закрывает его и отбрасывает сообщение. Крайний срок по умолчанию составляет пять минут.229* Когда диалог остается без ответа после крайнего срока [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), Claude Code закрывает его и отбрасывает сообщение. Крайний срок по умолчанию составляет пять минут.

253* Пока терминал не прикреплен к [фоновому сеансу](/docs/ru/agent-view), Claude Code оставляет диалог открытым после крайнего срока. После того как вы прикрепите, если диалог остается без ответа в течение полного периода крайнего срока, Claude Code закрывает его и отбрасывает сообщение.230* Пока терминал не прикреплен к [фоновому сеансу](/docs/ru/agent-view), Claude Code оставляет диалог открытым после крайнего срока. После того как вы прикрепите, если диалог остается без ответа в течение полного периода крайнего срока, Claude Code закрывает его и отбрасывает сообщение.

254* Если класс режима разрешений этого сеанса изменяется пока сообщения удерживаются, Claude Code повторно применяет входящие правила, доставляет сообщения, которые они теперь принимают, и показывает уведомление.231* Если класс режима разрешений этого сеанса изменяется пока сообщения удерживаются, Claude Code повторно применяет входящие правила, доставляет сообщения, которые они теперь принимают, и показывает уведомление.

255* Если изменение параметров делает `refuse` применимым пока сообщения удерживаются, Claude Code отбрасывает каждое удержанное сообщение и сообщает об отказе каждому отправителю, которого он может достичь.

~~256~~

257Когда отправитель — сеанс на одной машине, Claude Code отправляет уведомление обратно ему, когда получатель удерживает сообщение, и последующее, когда получатель позже доставляет, отклоняет или истекает его. Уведомление достигает Claude отправителя, поэтому он знает, что не должен продолжать ждать сообщение, которое другой сеанс не прочитал.

258 232

259В интерактивном отправляющем сеансе уведомление появляется в расшифровке. Отправитель [`claude -p`](/docs/ru/headless) получает его в [потоковом выводе](/docs/ru/headless#stream-responses) как [информационное сообщение `system`](/docs/ru/agent-sdk/typescript#sdkinformationalmessage). Уведомления отправителям `claude -p` требуют Claude Code v2.1.271 или более поздней версии.233Claude Code удерживает максимум 100 сообщений, и после этого отбрасывает самое старое.

~~260~~

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

~~262~~

263Claude Code удерживает максимум 100 сообщений, отдельно от очереди доставки, и после этого отбрасывает самое старое.

264 234

265<h3 id="non-interactive-sessions">235<h3 id="non-interactive-sessions">

266 Неинтерактивные сеансы236 Неинтерактивные сеансы

275 245

276Установите `dialogExpiry` на `"never"` для сохранения сообщений, удерживаемых по умолчанию, до конца сеанса. Сообщение, удерживаемое явным параметром `hold`, не истекает; Claude Code доставляет его только когда позже применяется `accept`.246Установите `dialogExpiry` на `"never"` для сохранения сообщений, удерживаемых по умолчанию, до конца сеанса. Сообщение, удерживаемое явным параметром `hold`, не истекает; Claude Code доставляет его только когда позже применяется `accept`.

277 247

278Когда сеанс заканчивается с удержанными сообщениями, Claude Code сообщает об их истечении каждому отправителю, которого он может достичь. До v2.1.225 крайний срок не применялся в сеансе `-p`: удержанное сообщение оставалось удержанным, если только изменение режима разрешений во время запуска не доставило его, и сеанс, заканчивающийся с удержанными сообщениями, ничего не сообщал их отправителям.

~~279~~

280Чтобы позволить рабочему `-p` принимать сообщения без присмотра, запустите его с `crossSessionInbound`, установленным на `accept` в его значении `--settings`. `accept` в ваших пользовательских параметрах также работает, но применяется к каждому сеансу, который вы запускаете.248Чтобы позволить рабочему `-p` принимать сообщения без присмотра, запустите его с `crossSessionInbound`, установленным на `accept` в его значении `--settings`. `accept` в ваших пользовательских параметрах также работает, но применяется к каждому сеансу, который вы запускаете.

281 249

282<h3 id="the-sessions-inbox-socket">250<h3 id="the-sessions-inbox-socket">

292* `/status` показывает его в строке `Peer address`. Путь имеет префикс `uds:`.260* `/status` показывает его в строке `Peer address`. Путь имеет префикс `uds:`.

293* Claude Code экспортирует его в [hooks](/docs/ru/hooks) и команды Bash как переменную окружения [`CLAUDE_CODE_MESSAGING_SOCKET`](/docs/ru/env-vars#variables):261* Claude Code экспортирует его в [hooks](/docs/ru/hooks) и команды Bash как переменную окружения [`CLAUDE_CODE_MESSAGING_SOCKET`](/docs/ru/env-vars#variables):

294 * В сеансе, который запускается с включенным обменом сообщениями, Claude Code экспортирует переменную перед запуском любого hook, включая `SessionStart`.262 * В сеансе, который запускается с включенным обменом сообщениями, Claude Code экспортирует переменную перед запуском любого hook, включая `SessionStart`.

295 * Каждый сеанс экспортирует свой собственный сокет, никогда унаследованный от родительского сеанса.

296 263

297На macOS и Linux Claude Code ограничивает сокет вашему пользователю операционной системы. На нативной Windows он вместо этого требует, чтобы каждое соединение сначала аутентифицировалось с ключом, который может прочитать только ваш пользователь операционной системы. В любом случае, на общей машине сеансы другого пользователя не могут доставить ему.264На macOS и Linux Claude Code ограничивает сокет вашему пользователю операционной системы. На нативной Windows он вместо этого требует, чтобы каждое соединение сначала аутентифицировалось с ключом, который может прочитать только ваш пользователь операционной системы. В любом случае, на общей машине сеансы другого пользователя не могут доставить ему.

298 265

305 272

306Откройте соединение только когда сообщение, которое вы отправляете, готово. Claude Code закрывает соединение, которое не отправило полную строку в течение 30 секунд, поэтому сначала захватите вывод медленной команды, а затем откройте соединение для отправки.273Откройте соединение только когда сообщение, которое вы отправляете, готово. Claude Code закрывает соединение, которое не отправило полную строку в течение 30 секунд, поэтому сначала захватите вывод медленной команды, а затем откройте соединение для отправки.

307 274

308[Правила собственного дочернего элемента](#own-child-messages) ниже говорят, когда Claude Code консультирует токен и как он обрабатывает сообщение, которое не может проверить.

~~309~~

310<span id="own-child-messages" />Claude Code запускает сообщения, прибывающие на сокет, через те же [входящие элементы управления](#control-inbound-messages), что и любое другое одноранговое сообщение, с одним исключением и одним предварительным условием:275<span id="own-child-messages" />Claude Code запускает сообщения, прибывающие на сокет, через те же [входящие элементы управления](#control-inbound-messages), что и любое другое одноранговое сообщение, с одним исключением и одним предварительным условием:

311 276

312* **Сообщения собственного дочернего элемента**: когда значение `crossSessionInbound` не применяется, Claude Code доставляет сообщение, которое оно проверяет, пришло из собственных дочерних процессов сеанса, таких как hook или команда Bash, отправляющая обратно в собственный сокет сеанса.277* **Сообщения собственного дочернего элемента**: когда значение `crossSessionInbound` не применяется, Claude Code доставляет сообщение, которое оно проверяет, пришло из собственных дочерних процессов сеанса, таких как hook или команда Bash, отправляющая обратно в собственный сокет сеанса.

313 * На Linux, включая внутри WSL 2, Claude Code может проверить по доказательству процесса даже для дочернего элемента, который уже вышел. На macOS он может проверить это только пока отправляющий процесс все еще работает, и в контейнере, где Claude Code работает как ID процесса 1, он вообще не имеет доказательства процесса. На нативной Windows он также не имеет.278 * На Linux, включая внутри WSL 2, Claude Code может проверить по доказательству процесса даже для дочернего элемента, который уже вышел. На macOS он может проверить это только пока отправляющий процесс все еще работает, и в контейнере, где Claude Code работает как ID процесса 1, он вообще не имеет доказательства процесса. На нативной Windows он также не имеет.

314 * На macOS после выхода отправляющего процесса и в контейнерах, где Claude Code работает как ID процесса 1, это доказательство процесса отсутствует, и Claude Code вместо этого проверяет дочерний элемент, который отправил экспортированный сеансом [`CLAUDE_CODE_MESSAGING_TOKEN`](/docs/ru/env-vars#variables) в строке аутентификации, которая открыла его соединение. На нативной Windows этот токен — единственный способ, которым Claude Code проверяет сообщение собственного дочернего элемента.279 * На macOS после выхода отправляющего процесса и в контейнерах, где Claude Code работает как ID процесса 1, это доказательство процесса отсутствует, и Claude Code вместо этого проверяет дочерний элемент, который отправил экспортированный сеансом [`CLAUDE_CODE_MESSAGING_TOKEN`](/docs/ru/env-vars#variables) в строке аутентификации, которая открыла его соединение. На нативной Windows этот токен — единственный способ, которым Claude Code проверяет сообщение собственного дочернего элемента.

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

316* **Изолированные сеансы**: управляйте тем, может ли команда Bash достичь сокет изнутри [изоляции](/docs/ru/sandboxing) с параметрами Unix-сокета изоляции, [`sandbox.network.allowAllUnixSockets` и `sandbox.network.allowUnixSockets`](/docs/ru/settings-reference#sandbox-settings).281* **Изолированные сеансы**: управляйте тем, может ли команда Bash достичь сокет изнутри [sandbox](/docs/ru/sandboxing) с параметрами Unix-сокета sandbox, [`sandbox.network.allowAllUnixSockets` и `sandbox.network.allowUnixSockets`](/docs/ru/settings-reference#sandbox-settings).

317 282

318<h2 id="restrict-cross-session-messaging">283<h2 id="restrict-cross-session-messaging">

319 Ограничение обмена сообщениями между сеансами284 Ограничение обмена сообщениями между сеансами

361 Доступность326 Доступность

362</h2>327</h2>

363 328

364Обмен сообщениями между сеансами требует Claude Code v2.1.224 или более поздней версии на macOS, Linux и WSL 2, и v2.1.234 или более поздней версии на нативной Windows. Доступность и то, какие сеансы Claude может отправлять сообщения, также зависят от вашей операционной системы, поставщика и конфигурации:329Обмен сообщениями между сеансами требует Claude Code v2.1.224 или более поздней версии на macOS, Linux и WSL 2, и v2.1.234 или более поздней версии на нативной Windows. Доступность и то, какие сеансы Claude может использовать для отправки сообщений, также зависят от вашей операционной системы, поставщика и конфигурации:

365 330

366* **Операционная система**: доступна на macOS, Windows и Linux, включая Linux внутри WSL 2.331* **Операционная система**: доступно на macOS, Windows и Linux, включая Linux внутри WSL 2.

367 332

368* **Сеансы на этом компьютере**: доступны на каждом поставщике, включая Amazon Bedrock, Claude Platform на AWS, Agent Platform Google Cloud и Microsoft Foundry, и в сеансах, которые работают с [получением флагов функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching) отключенным. На этих поставщиках и с отключенным получением флагов, обмен сообщениями на одной машине требует Claude Code v2.1.248 или более поздней версии. Claude Code доставляет эти сообщения через [сокет для каждого сеанса на вашей машине](#the-sessions-inbox-socket), никогда через серверы Anthropic.333* **Сеансы на этом компьютере**: доступно у каждого поставщика, включая Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform и Microsoft Foundry, а также в сеансах, которые работают с [получением флагов функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching) отключённым. На этих поставщиках и с отключённым получением флагов обмен сообщениями на одном компьютере требует Claude Code v2.1.248 или более поздней версии. Claude Code доставляет эти сообщения через [сокет для каждого сеанса на вашем компьютере](#the-sessions-inbox-socket), никогда не через серверы Anthropic.

369 334

370 Чтобы остановить сеанс от получения их, установите [`crossSessionInbound`](#turn-off-cross-session-messaging) на `refuse`.335 Чтобы запретить сеансу получать их, установите [`crossSessionInbound`](#turn-off-cross-session-messaging) в значение `refuse`.

371 336

372* **Сеансы за пределами этого компьютера**: Claude находит ваши сеансы [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) и ваши сеансы на других машинах из сеанса, который подключен к удаленному управлению, что требует входа claude.ai как активной аутентификации этого сеанса и другие [требования удаленного управления](/docs/ru/remote-control#requirements). Claude не может найти эти сеансы с ключом API или на Amazon Bedrock, Claude Platform на AWS, Agent Platform Google Cloud и Microsoft Foundry.337* **Сеансы за пределами этого компьютера**: Claude находит ваши [облачные сеансы](/docs/ru/claude-code-on-the-web) и ваши сеансы на других компьютерах из сеанса, который подключен к Remote Control, для чего требуется вход в claude.ai в качестве активной аутентификации этого сеанса и другие [требования Remote Control](/docs/ru/remote-control#requirements). Claude не может найти эти сеансы с помощью ключа API или на Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform и Microsoft Foundry.

373 338

374Чтобы проверить сеанс, введите `/list-agents`, также доступный как `/peers`. Результат отделяет сеанс, который не имеет функции, от сеанса, где что-то более узкое заблокировало сообщение, такое как отсутствующий инструмент `SendMessage` или отказанная отправка:339Чтобы проверить сеанс, введите `/list-agents`, также доступно как `/peers`. Результат отделяет сеанс, у которого нет этой функции, от сеанса, где что-то более узкое заблокировало сообщение, например отсутствие инструмента `SendMessage` или отказ в отправке:

375 340

376* **`/list-agents` не распознается**: сеанс не имеет обмена сообщениями между сеансами. Работайте через требования выше, начиная с `claude --version` для требования версии.341* **`/list-agents` не распознан**: сеанс не имеет обмена сообщениями между сеансами. Пройдите через требования выше, начиная с `claude --version` для проверки версии.

377* **`/list-agents` работает, но отправка не прибыла**: обмен сообщениями включен, и что-то более узкое применяется:342* **`/list-agents` работает, но отправка не прошла**: обмен сообщениями включен, и применяется что-то более узкое:

378 * **Правила отказа**: [правило отказа разрешений](#turn-off-cross-session-messaging) удаляет инструменты `SendMessage` и `ListAgents`.343 * **Правила отказа**: [правило отказа в разрешении](#turn-off-cross-session-messaging) удаляет инструменты `SendMessage` и `ListAgents`.

379 * **Входящие элементы управления**: [входящие элементы управления получающего сеанса](#control-inbound-messages) могут удержать или отбросить то, что вы отправляете ему.344 * **Входящие элементы управления**: [входящие элементы управления принимающего сеанса](#control-inbound-messages) могут задержать или отбросить то, что вы ему отправляете.

380 * **Облачный сеанс отсутствует**: облачный сеанс появляется только пока этот сеанс подключен к [Удаленному управлению](/docs/ru/remote-control).345 * **Облачный сеанс отсутствует**: облачный сеанс появляется только во время подключения этого сеанса к [Remote Control](/docs/ru/remote-control).

381 * **Сеанс на другой машине отсутствует**: сеанс на другой из ваших машин появляется только когда он работает с [Удаленным управлением](/docs/ru/remote-control) и этот сеанс также подключен.346 * **Сеанс на другом компьютере отсутствует**: сеанс на другом из ваших компьютеров появляется только при работе с [Remote Control](/docs/ru/remote-control) и подключении этого сеанса также.

382 * **Сеанс на другой машине `offline`**: сообщение сеансу, указанному как `offline`, проходит, но [прибывает только после переподключения машины этого сеанса](#message-sessions-on-other-machines).347 * **Сеанс на другом компьютере `offline`**: сообщение сеансу, указанному как `offline`, проходит, но [прибывает только после переподключения компьютера этого сеанса](#message-sessions-on-other-machines).

383 * **Старый облачный или сеанс на другой машине отсутствует**: Claude Code [читает эти списки сеансов от новейших и останавливается после ограниченного количества страниц](#see-which-sessions-claude-can-reach), поэтому Claude не может отправить сообщение сеансу, который упал мимо них по имени.348 * **Старый облачный или сеанс на другом компьютере отсутствует**: Claude Code читает эти списки сеансов от новых к старым и останавливается после ограниченного количества страниц, поэтому Claude не может отправить сообщение сеансу, который прошёл мимо них по имени.

384 * **Начало разговора**: [Отправка сообщений сеансам на других машинах](#message-sessions-on-other-machines) охватывает начало разговора с сеансом за пределами этого компьютера.

385 349

386В сеансе с обменом сообщениями, `/status` также показывает строку `Peer address` с собственным адресом входящего сеанса, или `unavailable` и причину, когда Claude Code [не мог установить входящий](#the-sessions-inbox-socket).350В сеансе с обменом сообщениями `/status` также показывает строку `Peer address` с адресом входящей папки самого сеанса, или `unavailable` и причину, когда Claude Code [не смог установить входящую папку](#the-sessions-inbox-socket).

387 351

388<h2 id="limitations">352<h2 id="limitations">

389 Ограничения353 Ограничения

393 357

394* **Только простой текст**: Claude отправляет только простой текст между сеансами. Структурированные сообщения протокола [команды агентов](/docs/ru/agent-teams) остаются внутри команды.358* **Только простой текст**: Claude отправляет только простой текст между сеансами. Структурированные сообщения протокола [команды агентов](/docs/ru/agent-teams) остаются внутри команды.

395* **Размер сообщения на одной машине ограничен**: Claude Code отказывает сообщение сеансу на этом компьютере один раз его сериализованная форма проходит около миллиона символов. Отказ [называет точные размеры](/docs/ru/errors#message-too-large-for-cross-session-delivery). Ничего не достигает получающего сеанса.359* **Размер сообщения на одной машине ограничен**: Claude Code отказывает сообщение сеансу на этом компьютере один раз его сериализованная форма проходит около миллиона символов. Отказ [называет точные размеры](/docs/ru/errors#message-too-large-for-cross-session-delivery). Ничего не достигает получающего сеанса.

396* **Быстрые всплески к одному сеансу отказываются на отправителе**: один раз быстрый всплеск сообщений к сеансу на этом компьютере достигает того, что принимает входящий этого сеанса, Claude Code отказывает дальнейшие отправки в отправляющем сеансе. [Отказ называет всплеск](/docs/ru/errors#too-many-messages-to-this-session-just-now) и сообщает Claude объединить остаток в одно сообщение или подождать. До v2.1.236 Claude Code сообщал об этих отправках как отправленных, пока получающий сеанс их отбрасывал.360* **Быстрые всплески к одному сеансу отказываются на отправителе**: один раз быстрый всплеск сообщений к сеансу на этом компьютере достигает того, что принимает входящий этого сеанса, Claude Code отказывает дальнейшие отправки в отправляющем сеансе. [Отказ называет всплеск](/docs/ru/errors#too-many-messages-to-this-session-just-now) и сообщает Claude объединить остаток в одно сообщение или подождать.

397* **Циклы сообщений ограничены**: в получающем сеансе Claude Code ограничивает повторяющиеся сообщения для каждого отправителя, отбрасывает идентичные повторы, прибывающие в короком окне, и ставит в очередь максимум 50 принятых сообщений для Claude для чтения. Цикл сообщений между двумя сеансами поэтому останавливается самостоятельно. Когда ограничение скорости, проверка повтора или ограничение очереди отбрасывает сообщение из интерактивного сеанса на этой машине, Claude Code сообщает этому сеансу, какое отбросило, и сообщает Claude отправителя не отправлять повторно сразу.361* **Циклы сообщений ограничены**: в получающем сеансе Claude Code ограничивает повторяющиеся сообщения для каждого отправителя, отбрасывает идентичные повторы, прибывающие в короком окне, и ставит в очередь максимум 50 принятых сообщений для Claude для чтения. Цикл сообщений между двумя сеансами поэтому останавливается самостоятельно.

398 362

399<h2 id="related-resources">363<h2 id="related-resources">

400 Связанные ресурсы364 Связанные ресурсы

403* [Подагенты](/docs/ru/sub-agents#resume-subagents) и [команды агентов](/docs/ru/agent-teams#messages-between-agents): обмен сообщениями в одном сеансе или команде367* [Подагенты](/docs/ru/sub-agents#resume-subagents) и [команды агентов](/docs/ru/agent-teams#messages-between-agents): обмен сообщениями в одном сеансе или команде

404* [Фоновые агенты](/docs/ru/agent-view): отправка и мониторинг параллельных сеансов, которые вы можете отправлять сообщениями368* [Фоновые агенты](/docs/ru/agent-view): отправка и мониторинг параллельных сеансов, которые вы можете отправлять сообщениями

405* [Удаленное управление](/docs/ru/remote-control): подключите этот сеанс для достижения ваших сеансов на других машинах369* [Удаленное управление](/docs/ru/remote-control): подключите этот сеанс для достижения ваших сеансов на других машинах

370* [Каналы](/docs/ru/channels): отправляйте внешние события, такие как результаты CI или сообщения чата, в сеанс

406* [Параметры](/docs/ru/settings-reference#all-settings): `crossSessionInbound`, `isolatePeerMachines` и `dialogExpiry`371* [Параметры](/docs/ru/settings-reference#all-settings): `crossSessionInbound`, `isolatePeerMachines` и `dialogExpiry`

407* [Режимы разрешений](/docs/ru/permission-modes): режимы позади входящего значения по умолчанию двух классов372* [Режимы разрешений](/docs/ru/permission-modes): режимы позади входящего значения по умолчанию двух классов

408* [Справочник инструментов](/docs/ru/tools-reference): строки `ListAgents` и `SendMessage` в таблице инструментов373* [Справочник инструментов](/docs/ru/tools-reference): строки `ListAgents` и `SendMessage` в таблице инструментов

data-usage.md +2 −2

Details

110 110

111[Cloud sessions](/docs/ru/claude-code-on-the-web) выполняются на виртуальных машинах, управляемых Anthropic, по умолчанию вместо локального выполнения. Сеансы, которые ваша организация маршрутизирует в [самостоятельно размещённую среду](/docs/ru/self-hosted-environments), выполняются на инфраструктуре, которой вы управляете; для информации о том, что остаётся на ваших машинах и что всё ещё идёт в Anthropic, см. [What stays on your infrastructure](/docs/ru/self-hosted-environments#what-stays-on-your-infrastructure). В облачных сеансах, размещённых на Anthropic:111[Cloud sessions](/docs/ru/claude-code-on-the-web) выполняются на виртуальных машинах, управляемых Anthropic, по умолчанию вместо локального выполнения. Сеансы, которые ваша организация маршрутизирует в [самостоятельно размещённую среду](/docs/ru/self-hosted-environments), выполняются на инфраструктуре, которой вы управляете; для информации о том, что остаётся на ваших машинах и что всё ещё идёт в Anthropic, см. [What stays on your infrastructure](/docs/ru/self-hosted-environments#what-stays-on-your-infrastructure). В облачных сеансах, размещённых на Anthropic:

112 112

113* **Хранилище кода и данных:** Ваш репозиторий клонируется на изолированную виртуальную машину. Код и данные сеанса подлежат политикам хранения и использования для вашего типа учётной записи (см. раздел Хранение данных выше)113* **Хранилище кода и данных:** Ваш репозиторий клонируется на изолированную виртуальную машину. Anthropic хранит стенограмму сеанса, чтобы вы могли вернуться к сеансу позже. Код и данные сеанса подлежат [политикам хранения и использования](#data-retention) для вашего типа учётной записи

114* **Учётные данные:** Аутентификация GitHub обрабатывается через защищённый прокси; ваши учётные данные GitHub никогда не попадают в sandbox114* **Учётные данные:** Учётные данные GitHub хранятся в зашифрованном виде на серверах Anthropic и никогда не попадают на виртуальную машину. Трафик GitHub с виртуальной машины проходит через прокси Anthropic, который прикрепляет их на стороне сервера

115* **Сетевой трафик:** Весь исходящий трафик проходит через прокси безопасности для логирования аудита и предотвращения злоупотреблений115* **Сетевой трафик:** Весь исходящий трафик проходит через прокси безопасности для логирования аудита и предотвращения злоупотреблений

116* **Данные сеанса:** Подсказки, изменения кода и выходные данные следуют тем же политикам данных, что и локальное использование Claude Code116* **Данные сеанса:** Подсказки, изменения кода и выходные данные следуют тем же политикам данных, что и локальное использование Claude Code

117 117

debug-your-config.md +1 −1

Details

110| Hook никогда не срабатывает | `matcher` использует `,` как разделитель в версии до v2.1.191 | Claude Code v2.1.191 или позже рассматривает `,` как разделитель списка, как `\|`. Более ранние версии оценивают запятую как буквальный символ, поэтому `"Edit,Write"` ничему не соответствует. Используйте `\|` вместо этого или обновите Claude Code. |110| Hook никогда не срабатывает | `matcher` использует `,` как разделитель в версии до v2.1.191 | Claude Code v2.1.191 или позже рассматривает `,` как разделитель списка, как `\|`. Более ранние версии оценивают запятую как буквальный символ, поэтому `"Edit,Write"` ничему не соответствует. Используйте `\|` вместо этого или обновите Claude Code. |

111| Hook никогда не срабатывает | значение `matcher` в нижнем регистре, например `"bash"` | Соответствие чувствительно к регистру. Имена tools написаны с заглавной буквы: `Bash`, `Edit`, `Write`, `Read`. |111| Hook никогда не срабатывает | значение `matcher` в нижнем регистре, например `"bash"` | Соответствие чувствительно к регистру. Имена tools написаны с заглавной буквы: `Bash`, `Edit`, `Write`, `Read`. |

112| Hook никогда не срабатывает | Hooks находятся в отдельном файле вместо `settings.json` | Нет отдельного файла hooks для конфигурации проекта или пользователя. Определите hooks под ключом `"hooks"` в `settings.json`. Только [plugins](/docs/ru/plugins/components#hooks) загружают отдельный `hooks/hooks.json`. См. [hook configuration](/docs/ru/hooks). |112| Hook никогда не срабатывает | Hooks находятся в отдельном файле вместо `settings.json` | Нет отдельного файла hooks для конфигурации проекта или пользователя. Определите hooks под ключом `"hooks"` в `settings.json`. Только [plugins](/docs/ru/plugins/components#hooks) загружают отдельный `hooks/hooks.json`. См. [hook configuration](/docs/ru/hooks). |

113| Permissions, hooks или env, установленные глобально, игнорируются | Конфигурация была добавлена в `~/.claude.json` | `~/.claude.json` содержит состояние приложения и переключатели UI. `permissions`, `hooks` и `env` принадлежат `~/.claude/settings.json`. Это два разных файла. |113| Permissions или hooks, установленные глобально, игнорируются | Конфигурация была добавлена в `~/.claude.json` | `~/.claude.json` содержит состояние приложения и переключатели UI. `permissions`, `hooks` и `env` принадлежат `~/.claude/settings.json`. Это два разных файла. |

114| Значение `settings.json` кажется игнорируемым | Тот же ключ установлен в `settings.local.json` | `settings.local.json` переопределяет `settings.json`, и оба переопределяют `~/.claude/settings.json`. См. [settings precedence](/docs/ru/settings#settings-precedence). |114| Значение `settings.json` кажется игнорируемым | Тот же ключ установлен в `settings.local.json` | `settings.local.json` переопределяет `settings.json`, и оба переопределяют `~/.claude/settings.json`. См. [settings precedence](/docs/ru/settings#settings-precedence). |

115| Skill не появляется в `/skills` | Файл skill находится в `.claude/skills/name.md` вместо папки | Используйте папку с `SKILL.md` внутри: `.claude/skills/name/SKILL.md`. |115| Skill не появляется в `/skills` | Файл skill находится в `.claude/skills/name.md` вместо папки | Используйте папку с `SKILL.md` внутри: `.claude/skills/name/SKILL.md`. |

116| Skill появляется в `/skills`, но Claude никогда его не вызывает | Skill имеет `disable-model-invocation: true` в своём frontmatter или его описание не совпадает с тем, как вы формулируете запрос | Проверьте значок в `/skills`: метка "user-only" означает, что Claude не будет его запускать самостоятельно. См. [skill invocation](/docs/ru/skills). |116| Skill появляется в `/skills`, но Claude никогда его не вызывает | Skill имеет `disable-model-invocation: true` в своём frontmatter или его описание не совпадает с тем, как вы формулируете запрос | Проверьте значок в `/skills`: метка "user-only" означает, что Claude не будет его запускать самостоятельно. См. [skill invocation](/docs/ru/skills). |

desktop.md +12 −4

Details

735 735

736Чтобы установить переменные окружения для локальных сеансов и dev-серверов на любой платформе, откройте раскрывающийся список окружения в поле подсказки, наведите курсор на **Local** и нажмите значок шестерёнки, чтобы открыть локальный редактор окружения. Переменные, которые вы сохраняете здесь, хранятся в зашифрованном виде на вашей машине и применяются к каждому локальному сеансу и серверу предпросмотра, который вы запускаете. Вы также можете добавить переменные к ключу `env` в вашем файле `~/.claude/settings.json`, хотя они достигают только сеансов Claude, а не dev-серверов. См. [переменные окружения](/docs/ru/env-vars) для полного списка поддерживаемых переменных.736Чтобы установить переменные окружения для локальных сеансов и dev-серверов на любой платформе, откройте раскрывающийся список окружения в поле подсказки, наведите курсор на **Local** и нажмите значок шестерёнки, чтобы открыть локальный редактор окружения. Переменные, которые вы сохраняете здесь, хранятся в зашифрованном виде на вашей машине и применяются к каждому локальному сеансу и серверу предпросмотра, который вы запускаете. Вы также можете добавить переменные к ключу `env` в вашем файле `~/.claude/settings.json`, хотя они достигают только сеансов Claude, а не dev-серверов. См. [переменные окружения](/docs/ru/env-vars) для полного списка поддерживаемых переменных.

737 737

738[Extended thinking](/docs/ru/model-config#extended-thinking) включен по умолчанию, что улучшает производительность на сложных задачах рассуждения, но использует дополнительные токены. На API Anthropic установите `MAX_THINKING_TOKENS` на `0` в локальном редакторе окружения, чтобы отключить thinking; это не влияет на Opus 5.5 или модели Fable, которые всегда используют extended thinking. С отключённым thinking на API Anthropic Claude Code отправляет effort `high` вместо более высокого уровня моделям, которые, как известно, [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5.738[Extended thinking](/docs/ru/model-config#extended-thinking) включен по умолчанию, что улучшает производительность на сложных задачах рассуждения, но использует дополнительные токены. На API Anthropic установите `MAX_THINKING_TOKENS` на `0` в локальном редакторе окружения, чтобы отключить thinking; это не влияет на Opus 5.5, Sonnet 5.5 или модели Fable, которые всегда используют extended thinking. С отключённым thinking на API Anthropic Claude Code отправляет effort `high` вместо более высокого уровня моделям, которые, как известно, [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5.

739 739

740На моделях с [адаптивным рассуждением](/docs/ru/model-config#adjust-effort-level) значения `MAX_THINKING_TOKENS`, отличные от `0`, игнорируются, потому что адаптивное рассуждение контролирует глубину thinking вместо этого. На Opus 4.6 и Sonnet 4.6 установите `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` на `1`, чтобы использовать фиксированный бюджет thinking; модели Fable, Sonnet 5 и Opus 4.7 и более поздние версии всегда используют адаптивное рассуждение и не имеют режима фиксированного бюджета.740На моделях с [адаптивным рассуждением](/docs/ru/model-config#adjust-effort-level) значения `MAX_THINKING_TOKENS`, отличные от `0`, игнорируются, потому что адаптивное рассуждение контролирует глубину thinking вместо этого. На Opus 4.6 и Sonnet 4.6 установите `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` на `1`, чтобы использовать фиксированный бюджет thinking; модели Fable, Sonnet 5 и более поздние версии, а также Opus 4.7 и более поздние версии всегда используют адаптивное рассуждение и не имеют режима фиксированного бюджета.

741 741

742<h4 id="local-sessions-on-managed-devices">742<h4 id="local-sessions-on-managed-devices">

743 Локальные сеансы на управляемых устройствах743 Локальные сеансы на управляемых устройствах

932 Аутентификация и SSO932 Аутентификация и SSO

933</h3>933</h3>

934 934

935Организации предприятия могут требовать SSO для всех пользователей. См. [аутентификация](/docs/ru/authentication) для деталей уровня плана и [Setting up SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) для конфигурации SAML; настройка OIDC рассматривается в [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide).935Организации Team и Enterprise могут требовать SSO для всех пользователей. См. [аутентификация](/docs/ru/authentication) для деталей уровня плана и [Setting up SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) для конфигурации SAML; настройка OIDC рассматривается в [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide).

936 936

937<h3 id="data-handling">937<h3 id="data-handling">

938 Обработка данных938 Обработка данных

961 961

962Чтобы переместить сеанс CLI в Desktop, запустите `/desktop` в терминале. Claude сохраняет ваш сеанс и открывает его в приложении desktop, затем выходит из CLI. Эта команда доступна на macOS и x64 Windows, когда вы вошли с подпиской Claude. Она недоступна при аутентификации по ключу API или на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.962Чтобы переместить сеанс CLI в Desktop, запустите `/desktop` в терминале. Claude сохраняет ваш сеанс и открывает его в приложении desktop, затем выходит из CLI. Эта команда доступна на macOS и x64 Windows, когда вы вошли с подпиской Claude. Она недоступна при аутентификации по ключу API или на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.

963 963

964Чтобы продолжить сеанс CLI из Desktop, введите `/resume` в поле подсказки. Desktop выводит список сеансов, которые вы запустили из CLI, и вы можете искать их по названию, папке или ветке и просмотреть, где каждый из них остановился. Выберите сеанс, и он продолжится в приложении с полной историей разговора и контекстом.964Вы также можете продолжить сеанс CLI из Desktop с помощью `/resume`. Команда доступна в локальных сеансах, но не в SSH, WSL или облачных сеансах.

965

966Чтобы продолжить сеанс терминала в Desktop:

967

9681. Закройте сеанс в терминале.

9692. В поле подсказки Desktop введите `/resume`. Desktop выводит список сеансов, которые вы запустили из CLI на этом компьютере. Ищите по названию, папке или ветке и просмотрите, где каждый из них остановился.

9703. Выберите сеанс. Он продолжится в приложении с полной историей разговора и контекстом.

971

972Desktop продолжает тот же сеанс, а не копию, поэтому `claude --resume` в терминале по-прежнему находит его впоследствии.

965 973

966<Tip>974<Tip>

967 Когда использовать Desktop vs CLI: используйте Desktop, когда вы хотите управлять параллельными сеансами в одном окне, организовать панели рядом или просмотреть изменения визуально. Используйте CLI, когда вам нужны скрипты, автоматизация или вы предпочитаете рабочий процесс терминала.975 Когда использовать Desktop vs CLI: используйте Desktop, когда вы хотите управлять параллельными сеансами в одном окне, организовать панели рядом или просмотреть изменения визуально. Используйте CLI, когда вам нужны скрипты, автоматизация или вы предпочитаете рабочий процесс терминала.

desktop-ios-simulator.md +19 −17

Details

23* Claude Desktop v1.24012.0 или позже23* Claude Desktop v1.24012.0 или позже

24* Mac, так как Apple iOS Simulator работает только на macOS24* Mac, так как Apple iOS Simulator работает только на macOS

25* [Xcode](https://developer.apple.com/xcode/) с установленной платформой iOS, которая предоставляет устройства симулятора. Если Xcode ещё не показывает симуляторы, см. [Панель симулятора говорит, что симуляторы не найдены](#the-simulator-pane-says-no-simulators-were-found)25* [Xcode](https://developer.apple.com/xcode/) с установленной платформой iOS, которая предоставляет устройства симулятора. Если Xcode ещё не показывает симуляторы, см. [Панель симулятора говорит, что симуляторы не найдены](#the-simulator-pane-says-no-simulators-were-found)

26 * Используйте Xcode 26.x. Панель ещё не работает с Xcode 27, которая заменяет приложение Simulator на Device Hub. Если `xcode-select` указывает на Xcode 27 на вашем Mac, см. [Панель симулятора не работает с Xcode 27](#the-simulator-pane-fails-with-xcode-27)26 * Рекомендуется Xcode 26.x или Xcode 27, и панель работает с обоими. Если у вас установлено более одного Xcode, см. [Выберите, какой Xcode использует панель симулятора](#choose-which-xcode-the-simulator-pane-uses)

27 27

28<Note>28<Note>

29 На этой странице "устройство" относится к симулированному iPhone или iPad, одному из тех же устройств симулятора, которыми вы управляете в Xcode в разделе **Window → Devices and Simulators**, а не к физическому оборудованию.29 На этой странице "устройство" относится к симулированному iPhone или iPad, одному из тех же устройств симулятора, которыми вы управляете в Xcode в разделе **Window → Devices and Simulators**, а не к физическому оборудованию.

31 31

32Панель симулятора доступна только в локальных сессиях. В [облачных](/docs/ru/desktop#run-long-running-tasks-in-the-cloud) и [SSH](/docs/ru/desktop#ssh-sessions) сессиях Claude работает на машине, которая не может получить доступ к симуляторам на вашем Mac.32Панель симулятора доступна только в локальных сессиях. В [облачных](/docs/ru/desktop#run-long-running-tasks-in-the-cloud) и [SSH](/docs/ru/desktop#ssh-sessions) сессиях Claude работает на машине, которая не может получить доступ к симуляторам на вашем Mac.

33 33

34<h3 id="choose-which-xcode-the-simulator-pane-uses">

35 Выберите, какой Xcode использует панель симулятора

36</h3>

38Если у вас установлено более одного Xcode, например Xcode 26.x рядом с Xcode 27, панель использует тот, на который указывает `xcode-select`. Чтобы использовать другую установку, выберите её по пути.

40Например, если нужный вам Xcode установлен как `/Applications/Xcode-26.4.app`, выполните это в Terminal:

42```bash theme={null}

43sudo xcode-select -s /Applications/Xcode-26.4.app

44```

46Затем закройте и снова откройте Claude Desktop, чтобы панель использовала вновь выбранный Xcode.

48Чтобы проверить, какая установка выбрана, выполните `xcode-select -p`. Она выведет папку Developer выбранной установки, например `/Applications/Xcode-26.4.app/Contents/Developer`.

34<h2 id="run-your-app-in-the-simulator">50<h2 id="run-your-app-in-the-simulator">

35 Запуск вашего приложения в симуляторе51 Запуск вашего приложения в симуляторе

36</h2>52</h2>

59 75

60Панель симулятора показывает то устройство, на котором приложение фактически запустилось. Чтобы протестировать на конкретном устройстве, назовите его в своем запросе, например "запустите его на симуляторе iPhone SE", и Claude будет нацеливаться на это устройство при сборке и запуске.76Панель симулятора показывает то устройство, на котором приложение фактически запустилось. Чтобы протестировать на конкретном устройстве, назовите его в своем запросе, например "запустите его на симуляторе iPhone SE", и Claude будет нацеливаться на это устройство при сборке и запуске.

61 77

62Устройство, которое Claude загружает, также появляется в приложении Apple Simulator, и Claude может установить приложение на устройство, которое вы уже загрузили.78Устройство, которое Claude загружает, также появляется в приложении Apple Simulator, или в Device Hub на Xcode 27. Claude может установить приложение на устройство, которое вы уже загрузили.

63 79

64Вы также можете открыть панель симулятора самостоятельно. После того как сессия имеет подключённый симулятор или отредактировала файлы Swift, меню **Views** в панели инструментов сессии показывает запись **iOS Simulator**. Если панель ещё не показывает устройство, нажмите **Attach simulator** или выберите конкретное устройство из меню устройств рядом с ним; выбор выключенного устройства его загружает. Если Xcode или его симуляторы отсутствуют, панель показывает шаги настройки вместо этого и отмечает их по мере завершения.80Вы также можете открыть панель симулятора самостоятельно. После того как сессия имеет подключённый симулятор или отредактировала файлы Swift, меню **Views** в панели инструментов сессии показывает запись **iOS Simulator**. Если панель ещё не показывает устройство, нажмите **Attach simulator** или выберите конкретное устройство из меню устройств рядом с ним; выбор выключенного устройства его загружает. Если Xcode или его симуляторы отсутствуют, панель показывает шаги настройки вместо этого и отмечает их по мере завершения.

65 81

150 Панель симулятора говорит, что симуляторы не найдены166 Панель симулятора говорит, что симуляторы не найдены

151</h3>167</h3>

152 168

153Если `xcode-select` указывает на Xcode 27, панель может сообщить об отсутствии симуляторов, даже если устройства существуют; см. [Панель симулятора не работает с Xcode 27](#the-simulator-pane-fails-with-xcode-27). В противном случае Xcode установлен, но не имеет iOS симуляторов для отображения. Панель симулятора показывает шаги настройки для выполнения и отмечает их по мере завершения каждого. Чтобы установить отсутствующую часть вручную, загрузите среду выполнения iOS симулятора из настроек Xcode или запустите `xcodebuild -downloadPlatform iOS`.169Xcode установлен, но не имеет iOS симуляторов для отображения. Панель симулятора показывает шаги настройки для выполнения и отмечает их по мере завершения каждого. Чтобы установить отсутствующую часть вручную, загрузите среду выполнения iOS симулятора из настроек Xcode или запустите `xcodebuild -downloadPlatform iOS`.

~~154~~

155<h3 id="the-simulator-pane-fails-with-xcode-27">

156 Панель симулятора не работает с Xcode 27

157</h3>

~~158~~

159Панель ещё не работает с Xcode 27, которая заменяет приложение Simulator на Device Hub. С выбранной Xcode 27 подключение устройства не удаётся или панель сообщает об отсутствии симуляторов, даже если устройства существуют.

~~160~~

161Панель использует ту Xcode, на которую указывает `xcode-select`. Если Xcode 27 — ваша единственная установка, сначала установите Xcode 26.x рядом с ней. Затем выберите установку 26.x по её пути. Например, если она установлена как `/Applications/Xcode-26.4.app`:

~~162~~

163```bash theme={null}

164sudo xcode-select -s /Applications/Xcode-26.4.app

165```

~~166~~

167Запустите `xcode-select -p`, чтобы проверить, какая установка выбрана.

168 170

169<h2 id="see-also">171<h2 id="see-also">

170 See also172 See also

desktop-linux.md +1 −1

Details

158* Все отсутствующие зависимости показывают `not installable` с суффиксом `:amd64` или `:arm64`: вы загрузили `.deb` для другой архитектуры, чем архитектура вашей машины. Выполните `dpkg --print-architecture` и загрузите соответствующий `.deb`, или [установите из репозитория apt](#install), который выбирает пакет для вашей архитектуры.158* Все отсутствующие зависимости показывают `not installable` с суффиксом `:amd64` или `:arm64`: вы загрузили `.deb` для другой архитектуры, чем архитектура вашей машины. Выполните `dpkg --print-architecture` и загрузите соответствующий `.deb`, или [установите из репозитория apt](#install), который выбирает пакет для вашей архитектуры.

159 159

160<h3 id="running-as-root-without-no-sandbox-is-not-supported">160<h3 id="running-as-root-without-no-sandbox-is-not-supported">

161 Running as root without --no-sandbox is not supported161 Running as root without `--no-sandbox` is not supported

162</h3>162</h3>

163 163

164Если `claude-desktop` завершается с этим сообщением, вы запустили его от имени root. Войдите как обычный пользователь и запустите его оттуда.164Если `claude-desktop` завершается с этим сообщением, вы запустили его от имени root. Войдите как обычный пользователь и запустите его оттуда.

desktop-quickstart.md +8 −7

Details

4 4

5# Начало работы с настольным приложением5# Начало работы с настольным приложением

6 6

~~7> Установите Claude Code на рабочий стол и начните свой первый сеанс кодирования~~7> Установите настольное приложение Claude, откройте вкладку Code и начните свой первый сеанс Claude Code в папке проекта на вашем компьютере.

8 8

9Настольное приложение предоставляет вам Claude Code с графическим интерфейсом, созданным для запуска нескольких сеансов рядом: боковая панель для управления параллельной работой, макет с перетаскиванием с интегрированным терминалом и редактором файлов, визуальный просмотр различий, предпросмотр приложения в реальном времени, мониторинг GitHub PR с автоматическим слиянием и запланированные задачи. Терминал не требуется.9Настольное приложение предоставляет вам Claude Code с графическим интерфейсом, поэтому вы можете попросить Claude работать с кодом в папке на вашем компьютере и просматривать его изменения без использования терминала. На этой странице описывается установка приложения и начало вашего первого сеанса на вкладке **Code**. Claude Code требует [подписку Pro, Max, Team или Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_pricing).

10 10

11<CardGroup cols={3}>11<CardGroup cols={3}>

12 <Card title="Скачать для macOS" icon="apple" href="https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code&utm_medium=docs">12 <Card title="Скачать для macOS" icon="apple" href="https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code&utm_medium=docs">

25Для Windows ARM64 скачайте [установщик ARM64](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs). На Linux установите с помощью apt; см. [Claude Desktop на Linux](/docs/ru/desktop-linux).25Для Windows ARM64 скачайте [установщик ARM64](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs). На Linux установите с помощью apt; см. [Claude Desktop на Linux](/docs/ru/desktop-linux).

26 26

27<Note>27<Note>

~~28 Claude Code требует [подписку Pro, Max, Team или Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_pricing).~~28 Следующие случаи рассматриваются на других страницах:

~~29</Note>~~

30 29

31На этой странице описывается установка приложения и начало вашего первого сеанса. Если вы уже настроены, см. [Использование Claude Code Desktop](/docs/ru/desktop) для полного справочника.30 * **Уже настроено**: см. [Использование Claude Code Desktop](/docs/ru/desktop) для всех возможностей вкладки Code

31 * **Хотите `claude` в вашем терминале**: [установите CLI](/docs/ru/quickstart) отдельно

32</Note>

32 33

33Настольное приложение имеет три вкладки:34Настольное приложение имеет три вкладки:

34 35

35* **Chat**: Общее общение без доступа к файлам, аналогично claude.ai.36* **Chat**: Общее общение без доступа к файлам, аналогично claude.ai.

36* **Cowork**: Автономный фоновый агент, который работает над задачами в изолированной виртуальной машине с собственной средой, работая независимо, пока вы занимаетесь другой работой. Локальные сеансы Cowork запускают виртуальную машину на вашем компьютере; удалённые сеансы Cowork запускают её на управляемой Anthropic виртуальной машине вместо этого.37* **Cowork**: Автономный фоновый агент, который работает над задачами независимо, пока вы занимаетесь другой работой.

37* **Code**: Интерактивный помощник по кодированию с прямым доступом к вашим локальным файлам. В зависимости от режима разрешений вы одобряете каждое изменение по мере его предложения Claude или просматриваете изменения после того, как Claude их внесёт.38* **Code**: Интерактивный помощник по кодированию с прямым доступом к вашим локальным файлам. В зависимости от режима разрешений вы одобряете каждое изменение по мере его предложения Claude или просматриваете изменения после того, как Claude их внесёт.

38 39

39Chat и Cowork рассматриваются в [Центре справки Claude](https://support.claude.com/); установка и развёртывание настольного приложения рассматриваются в [статьях поддержки Claude Desktop](https://support.claude.com/en/collections/16163169-claude-desktop). На этой странице основное внимание уделяется вкладке **Code**.40Chat и Cowork рассматриваются в [Центре справки Claude](https://support.claude.com/); установка и развёртывание настольного приложения рассматриваются в [статьях поддержки Claude Desktop](https://support.claude.com/en/collections/16163169-claude-desktop). На этой странице основное внимание уделяется вкладке **Code**.

52 </Step>53 </Step>

53</Steps>54</Steps>

54 55

55Настольное приложение включает Claude Code. Вам не нужно устанавливать Node.js или CLI отдельно. Чтобы использовать `claude` из терминала, установите CLI отдельно. См. [Начало работы с CLI](/docs/ru/quickstart).56Настольное приложение включает Claude Code, поэтому вам не нужно устанавливать Node.js или CLI для использования вкладки Code.

56 57

57<h2 id="start-your-first-session">58<h2 id="start-your-first-session">

58 Начните свой первый сеанс59 Начните свой первый сеанс

desktop-scheduled-tasks.md +1 −1

Details

61 61

62* **Manual**: без расписания, запускается только при нажатии **Run now**. Полезно для сохранения подсказки, которую вы запускаете по требованию62* **Manual**: без расписания, запускается только при нажатии **Run now**. Полезно для сохранения подсказки, которую вы запускаете по требованию

63* **Hourly**: запускается каждый час63* **Hourly**: запускается каждый час

~~64* **Daily**: показывает средство выбора времени, по умолчанию 9:00 AM местного времени~~64* **Daily**: запускается каждый день в выбранное вами местное время

65* **Weekdays**: то же самое, что Daily, но пропускает субботу и воскресенье65* **Weekdays**: то же самое, что Daily, но пропускает субботу и воскресенье

66* **Weekly**: показывает средство выбора времени и средство выбора дня66* **Weekly**: показывает средство выбора времени и средство выбора дня

67 67

errors.md +760 −380

Details

24| :- | :- |24| :- | :- |

25| `API Error: 500 Internal server error` | [Server errors](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [Server errors](#api-error-500-internal-server-error) |

26| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |

27| `Opus is experiencing high load` / `Fable is experiencing high load` | [Server errors](#api-error-repeated-529-overloaded-errors) |

27| `Request timed out` | [Server errors](#request-timed-out), или [Network](#unable-to-connect-to-api) если сообщение упоминает вашу интернет-соединение |28| `Request timed out` | [Server errors](#request-timed-out), или [Network](#unable-to-connect-to-api) если сообщение упоминает вашу интернет-соединение |

28| `API Error: No response from API` | [Server errors](#no-response-from-api) |29| `API Error: No response from API` | [Server errors](#no-response-from-api) |

29| `Server error mid-response. The response above may be incomplete.` | [Server errors](#the-response-above-may-be-incomplete) |30| `Server error mid-response. The response above may be incomplete.` | [Server errors](#the-response-above-may-be-incomplete) |

30| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Server errors](#the-response-above-may-be-incomplete) |31| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Server errors](#the-response-above-may-be-incomplete) |

31| `Connection closed mid-response` / `Response stalled mid-stream` | [Server errors](#the-response-above-may-be-incomplete) |32| `Connection closed mid-response` / `Response stalled mid-stream` | [Server errors](#the-response-above-may-be-incomplete) |

33| `Part of the response never arrived` / `The response stream was malformed` | [Server errors](#the-response-above-may-be-incomplete) |

34| `API Error: Content block not found` / `API Error: Content block already closed` / `API Error: Stream event unreadable` | [Server errors](#the-response-above-may-be-incomplete) |

32| `Connection lost before a response was produced` / `Your computer went to sleep before a response was produced` / `The response stalled before a response was produced` | [Automatic retries](#automatic-retries) |35| `Connection lost before a response was produced` / `Your computer went to sleep before a response was produced` / `The response stalled before a response was produced` | [Automatic retries](#automatic-retries) |

33| `Connection closed while thinking` / `Response stalled while thinking` | [Automatic retries](#automatic-retries) |36| `Connection closed while thinking` / `Response stalled while thinking` | [Automatic retries](#automatic-retries) |

34| `Connection lost while your computer was asleep` | [Automatic retries](#automatic-retries) |37| `Connection lost while your computer was asleep` | [Automatic retries](#automatic-retries) |

49| `Could not update your spend limit` | [Usage limits](#could-not-update-your-spend-limit) |52| `Could not update your spend limit` | [Usage limits](#could-not-update-your-spend-limit) |

50| `spend limit reached` / `spend limit unavailable` | [Usage limits](#spend-limit-reached) |53| `spend limit reached` / `spend limit unavailable` | [Usage limits](#spend-limit-reached) |

51| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |54| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |

55| `Couldn't save your login` | [Authentication](#couldnt-save-your-login) |

56| `Authentication required · Sign in again to continue` | [Authentication](#not-logged-in) |

52| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |57| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |

53| `Invalid API key` | [Authentication](#invalid-api-key) |58| `Invalid API key` | [Authentication](#invalid-api-key) |

54| `Your apiKeyHelper script is failing` | [Authentication](#your-apikeyhelper-script-is-failing) |59| `Your apiKeyHelper script is failing` | [Authentication](#your-apikeyhelper-script-is-failing) |

69| `signed-in claude.ai account or organization changed on this machine` | [Authentication](#remote-control-stopped-because-the-signed-in-account-changed) |74| `signed-in claude.ai account or organization changed on this machine` | [Authentication](#remote-control-stopped-because-the-signed-in-account-changed) |

70| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |75| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |

71| `Remote Control stopped — the app running this session is signed out of Claude` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |76| `Remote Control stopped — the app running this session is signed out of Claude` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |

77| `Couldn't verify your organization's policy for remote control` | [Troubleshoot Remote Control](/docs/ru/remote-control#couldnt-verify-your-organizations-policy-for-remote-control) |

72| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |78| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |

73| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |79| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |

74| `Login expired · Please run /login` | [Authentication](#login-expired) |80| `Login expired · Please run /login` | [Authentication](#login-expired) |

81| `Failed to start OAuth callback server` | [Authentication](#failed-to-start-oauth-callback-server) |

75| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |82| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |

76| `Artifacts need a claude.ai login` | [Authentication](#artifacts-need-a-claude-ai-login) |83| `Artifacts need a claude.ai login` | [Authentication](#artifacts-need-a-claude-ai-login) |

77| `Not signed in to the Cloud gateway — run /login.` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |84| `Not signed in to the Cloud gateway — run /login.` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |

78| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |85| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |

79| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |86| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |

87| `Could not refresh your login because another Claude Code process is refreshing it` | [Authentication](#could-not-refresh-your-login) |

88| `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh` | [Authentication](#could-not-refresh-your-login) |

80| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentication](#your-account-is-on-hold) |89| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentication](#your-account-is-on-hold) |

81| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentication](#your-account-is-on-hold) |90| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentication](#your-account-is-on-hold) |

82| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentication](#anthropic-profile-login-expired) |91| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentication](#anthropic-profile-login-expired) |

121| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Network](#sessions-ended-while-this-machine-was-offline) |130| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Network](#sessions-ended-while-this-machine-was-offline) |

132| `Couldn't send feedback` | [Network](#couldnt-send-feedback) |

125| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Request errors](#prompt-is-too-long) |135| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Request errors](#prompt-is-too-long) |

131| `all upstreams failed (N attempted)` on a Claude apps gateway session | [Upstream error messages](/docs/ru/claude-apps-gateway-config#upstream-error-messages) |141| `all upstreams failed (N attempted)` on a Claude apps gateway session | [Upstream error messages](/docs/ru/claude-apps-gateway-config#upstream-error-messages) |

132| `Claude Code may not be enabled for your organization` after a Claude apps gateway sign-in | [Claude apps gateway troubleshooting](/docs/ru/claude-apps-gateway-deploy#troubleshooting) |142| `Claude Code may not be enabled for your organization` after a Claude apps gateway sign-in | [Claude apps gateway troubleshooting](/docs/ru/claude-apps-gateway-deploy#troubleshooting) |

133| `Context exceeds the ...-token limit by ... tokens` in `/context` output | [Request errors](#context-exceeds-the-token-limit) |143| `Context exceeds the ...-token limit by ... tokens` in `/context` output | [Request errors](#context-exceeds-the-token-limit) |

134| `Error during compaction: Conversation too long` | [Request errors](#error-during-compaction-conversation-too-long) |

141| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Request errors](#tool-input-schema-is-invalid) |150| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Request errors](#tool-input-schema-is-invalid) |

151| `tool_use.name: String should have at most 200 characters` | [Request errors](#tool-use-name-over-200-characters) |

155| `API error: ... · model not changed` | [Request errors](#api-error-model-not-changed) |

145| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |156| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |

146| `Claude Code ... does not support this model; version ... or newer is required` | [Request errors](#claude-code-does-not-support-this-model) |157| `Claude Code ... does not support this model; version ... or newer is required` | [Request errors](#claude-code-does-not-support-this-model) |

147| `Claude Code ... is older than the minimum version required by your organization's policy` | [Request errors](#claude-code-does-not-support-this-model) |158| `Claude Code ... is older than the minimum version required by your organization's policy` | [Request errors](#claude-code-does-not-support-this-model) |

148| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organizations-settings) |159| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organizations-settings) |

160| `Model ... is not available. Your organization restricts model selection.` | [Request errors](#model-is-restricted-by-your-organizations-settings) |

149| `Model switch ... blocked by a PreModelSwitch hook` | [Request errors](#model-switch-was-blocked-by-a-premodelswitch-hook) |161| `Model switch ... blocked by a PreModelSwitch hook` | [Request errors](#model-switch-was-blocked-by-a-premodelswitch-hook) |

150| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Request errors](#couldnt-save-it-as-your-default) |162| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Request errors](#couldnt-save-it-as-your-default) |

151| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |163| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |

157| `API Error: 400 duplicate tool_use ID in conversation history` | [Request errors](#tool-use-or-thinking-block-mismatch) |169| `API Error: 400 duplicate tool_use ID in conversation history` | [Request errors](#tool-use-or-thinking-block-mismatch) |

170| `Invalid data in redacted_thinking block` | [Request errors](#invalid-data-in-redacted-thinking-block) |

160| `Invalid encrypted_content in search_result block` / `Invalid encrypted_index in text block` / `Failed to decrypt web search result content` | [Request errors](#invalid-encrypted-content-in-search-result-block) |173| `Invalid encrypted_content in search_result block` / `Invalid encrypted_index in text block` / `Failed to decrypt web search result content` | [Request errors](#invalid-encrypted-content-in-search-result-block) |

174| `Invalid encrypted_stdout in encrypted_code_execution_result block` | [Request errors](#invalid-encrypted-content-in-search-result-block) |

161| `server_tool_use.name: Input should be` on every turn of a resumed session | [Request errors](#unsupported-tool-content-removed) |175| `server_tool_use.name: Input should be` on every turn of a resumed session | [Request errors](#unsupported-tool-content-removed) |

163| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |177| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |

166| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |180| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |

167| `Installation was killed before it could finish (exit code 137)` | [Installation errors](#installation-was-killed-before-it-could-finish) |181| `Installation was killed before it could finish (exit code 137)` | [Installation errors](#installation-was-killed-before-it-could-finish) |

168| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |182| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |

169| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |183| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |

171| `Cloud sessions cannot be created from a --restricted session` | [Command-line errors](#cloud-sessions-cannot-be-created-from-a-restricted-session) |185| `Cloud sessions cannot be created from a --restricted session` | [Command-line errors](#cloud-sessions-cannot-be-created-from-a-restricted-session) |

172| `Cloud sessions are disabled by your organization's policy` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |186| `Cloud sessions are disabled by your organization's policy` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |

173| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |187| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |

190| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [Command-line errors](#invalid-agents-configuration) |

191| `Error: --agents file not found` | [Command-line errors](#invalid-agents-configuration) |

177| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [Command-line errors](#the-current-directory-no-longer-exists) |193| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [Command-line errors](#the-current-directory-no-longer-exists) |

178| `Temp directory <dir> ... Refusing to use it` / `ENOSPC: no space left on device, mkdir '<dir>'` | [Command-line errors](#temp-directory-refused-or-cannot-be-created) |194| `Temp directory <dir> ... Refusing to use it` / `ENOSPC: no space left on device, mkdir '<dir>'` | [Command-line errors](#temp-directory-refused-or-cannot-be-created) |

209| `No conversation found with session ID: <session-id>` | [Command-line errors](#no-conversation-found-with-the-session-id) |225| `No conversation found with session ID: <session-id>` | [Command-line errors](#no-conversation-found-with-the-session-id) |

226| `Windows reported an error (EBADF) when Claude Code read this session's transcript file` | [Command-line errors](#windows-reported-an-error-ebadf) |

211| `Cannot switch renderers while work is running in the background` | [Command-line errors](#cannot-switch-renderers-in-this-session) |228| `Cannot switch renderers while work is running in the background` | [Command-line errors](#cannot-switch-renderers-in-this-session) |

218| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Command-line errors](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |235| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Command-line errors](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |

219| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |236| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |

220| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |237| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |

238| `Claude Code refuses the marketplace name "<name>"` | [Plugin errors](#claude-code-refuses-the-marketplace-name) |

239| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [Plugin errors](#claude-code-refuses-the-marketplace-name) |

221| `Marketplace "<name>" is already added from a different source` | [Plugin errors](#marketplace-is-already-added-from-a-different-source) |240| `Marketplace "<name>" is already added from a different source` | [Plugin errors](#marketplace-is-already-added-from-a-different-source) |

222| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin errors](#marketplace-name-is-another-spelling-of-a-reserved-name) |241| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [Plugin errors](#marketplace-name-is-another-spelling-of-a-reserved-name) |

223| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |242| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |

233| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [Plugin errors](#plugin-is-required-by-your-organization) |252| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [Plugin errors](#plugin-is-required-by-your-organization) |

253| `"<plugin>" was not uninstalled: it is still switched on in <file>` | [Plugin errors](#plugin-was-not-uninstalled) |

254| `"<plugin>" was not uninstalled: <file> is there and could not be read` | [Plugin errors](#plugin-was-not-uninstalled) |

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

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

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

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

237| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Tool errors](#memory-index-is-over-its-read-limit) |260| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Tool errors](#memory-index-is-over-its-read-limit) |

241| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Tool errors](#teammate-agent-definition-not-restored) |264| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Tool errors](#teammate-agent-definition-not-restored) |

267| `Cross-session message was dropped at the recipient session's inbox` | [Tool errors](#cross-session-message-dropped-at-the-inbox) |

244| `Refusing to send: reply target is a symlink` / `Refusing to send: cannot vet reply target` | [Tool errors](#refusing-to-send-a-cross-session-message) |268| `Refusing to send: reply target is a symlink` / `Refusing to send: cannot vet reply target` | [Tool errors](#refusing-to-send-a-cross-session-message) |

245| `Refusing to send: connected endpoint is not the expected process` / `Refusing to send: connected endpoint identity could not be read` | [Tool errors](#refusing-to-send-a-cross-session-message) |

246| `Refusing to send: connected endpoint is not owned by this user` / `Refusing to send: connected endpoint owner could not be read` | [Tool errors](#refusing-to-send-a-cross-session-message) |

247| `Refusing to send: connected endpoint is a different process with the expected pid` | [Tool errors](#refusing-to-send-a-cross-session-message) |

248| `Refusing to read <path>: its symlink resolution changed after permission was checked (<reason>)` / `Refusing to search <path>: its symlink resolution changed after permission was checked` | [Tool errors](#refusing-after-a-symlink-changed) |269| `Refusing to read <path>: its symlink resolution changed after permission was checked (<reason>)` / `Refusing to search <path>: its symlink resolution changed after permission was checked` | [Tool errors](#refusing-after-a-symlink-changed) |

249| `Refusing to write <path>: its parent-directory symlink resolution changed after permission was checked` / `Refusing to write <path>: it is a symbolic link. Write to the link's target path instead` | [Tool errors](#refusing-after-a-symlink-changed) |270| `Refusing to write <path>: its parent-directory symlink resolution changed after permission was checked` / `Refusing to write <path>: it is a symbolic link. Write to the link's target path instead` | [Tool errors](#refusing-after-a-symlink-changed) |

250| `Refusing to write through symlink: <path>` / `Refusing to write into symlinked directory: <path>` | [Tool errors](#refusing-after-a-symlink-changed) |271| `Refusing to write through symlink: <path>` / `Refusing to write into symlinked directory: <path>` | [Tool errors](#refusing-after-a-symlink-changed) |

272| `Refusing to write <path>: where it leads on disk could not be determined` / `Refusing to read <path>: where it leads on disk could not be determined` | [Tool errors](#refusing-after-a-symlink-changed) |

251| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Tool errors](#refusing-after-a-symlink-changed) |273| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Tool errors](#refusing-after-a-symlink-changed) |

252| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [Tool errors](#refusing-after-a-symlink-changed) |274| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [Tool errors](#refusing-after-a-symlink-changed) |

254| `Command killed: its output file was replaced or could no longer be verified` | [Tool errors](#task-output-swap-refused) |276| `Command killed: its output file was replaced or could no longer be verified` | [Tool errors](#task-output-swap-refused) |

277| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |

278| `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |

279| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |

255| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |280| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |

257| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |282| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |

280| `exited before it became reachable` | [Background session errors](#background-service-exited-before-it-became-reachable) |305| `exited before it became reachable` | [Background session errors](#background-service-exited-before-it-became-reachable) |

281| `Couldn't start a background session (working directory no longer exists or is not accessible: ...)` | [Background session errors](#working-directory-no-longer-exists-when-starting-a-background-session) |306| `Couldn't start a background session (working directory no longer exists or is not accessible: ...)` | [Background session errors](#working-directory-no-longer-exists-when-starting-a-background-session) |

307| `Workspace not trusted.` when starting or restarting a background session | [Background session errors](#workspace-not-trusted-when-dispatching-a-background-session) |

282| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Background session errors](#eacces-when-starting-a-background-session) |308| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Background session errors](#eacces-when-starting-a-background-session) |

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

291| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Configuration warnings](#fullscreen-failed-start-notice) |317| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Configuration warnings](#fullscreen-failed-start-notice) |

292| `Claude Code exited after an unrecoverable interface error (...)` | [Configuration warnings](#exited-after-an-unrecoverable-interface-error) |318| `Claude Code exited after an unrecoverable interface error (...)` | [Configuration warnings](#exited-after-an-unrecoverable-interface-error) |

293| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |319| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |

320| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Configuration warnings](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |

294| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |321| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |

295| `is a network path, which cannot be added as a working directory` | [Configuration warnings](#working-directory-is-a-network-path) |322| `is a network path, which cannot be added as a working directory` | [Configuration warnings](#working-directory-is-a-network-path) |

297| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |324| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |

325| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Configuration warnings](#managed-settings-block-the-default-model) |

298| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |326| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |

299| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |327| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |

300| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |328| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |

313 Автоматические повторные попытки341 Автоматические повторные попытки

314</h2>342</h2>

315 343

316Claude Code повторяет временные сбои до 10 раз с экспоненциальной задержкой перед отображением ошибки. Он не всегда повторяет сбой, который происходит в середине ответа Claude. Когда вы видите одну из ошибок на этой странице, Claude Code уже выполнил все применимые повторные попытки для этого сбоя; списки ниже указывают, какие сбои получают полный бюджет, какие получают меньший, а какие не получают никакого.344Claude Code повторяет временные сбои до 10 раз с экспоненциальной задержкой перед отображением ошибки. Он не всегда повторяет сбой, который происходит в середине ответа Claude. Когда вы видите одну из ошибок на этой странице, Claude Code уже выполнил все применимые повторные попытки для этого сбоя.

317 345

318Claude Code повторяет эти сбои:346Claude Code повторяет эти сбои:

319 347

390 418

391Завершающее предложение указывает, где проверить здоровье сервиса и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry указывают на страницу статуса этого поставщика. Пользовательский `ANTHROPIC_BASE_URL` указывает на хост шлюза.419Завершающее предложение указывает, где проверить здоровье сервиса и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry указывают на страницу статуса этого поставщика. Пользовательский `ANTHROPIC_BASE_URL` указывает на хост шлюза.

392 420

393Это указывает на неожиданный сбой внутри API. Это не вызвано вашим приглашением, настройками или учетной записью.4215xx от самого API указывает на неожиданный сбой внутри API. Это не вызвано вашим приглашением, настройками или учетной записью.

422

423Когда прокси, балансировщик нагрузки или шлюз отвечает страницей ошибки HTML, сообщение показывает код состояния и заголовок страницы, такой как `API Error: 502 Bad Gateway`. Для страницы без заголовка сообщение показывает код состояния и его стандартное имя вместо этого. До v2.1.281 код состояния был удален, когда страница имела заголовок, и разметка страницы была напечатана в сыром виде, когда она не имела.

394 424

395**Что делать:**425**Что делать:**

396 426

416 446

417* Проверьте [status.claude.com](https://status.claude.com) или страницу статуса поставщика, указанную в сообщении, на предмет уведомлений о емкости447* Проверьте [status.claude.com](https://status.claude.com) или страницу статуса поставщика, указанную в сообщении, на предмет уведомлений о емкости

418* Повторите попытку через несколько минут448* Повторите попытку через несколько минут

419* Запустите `/model` и переключитесь на другую модель, чтобы продолжить работу, так как емкость отслеживается для каждой модели. Claude Code предлагает вам это сделать, когда одна модель испытывает особенно высокую нагрузку, например `Opus is experiencing high load, please use /model to switch to Sonnet`.449* Запустите `/model` и переключитесь на другую модель, чтобы продолжить работу, так как емкость отслеживается для каждой модели. Claude Code предлагает вам это сделать, когда одна модель испытывает особенно высокую нагрузку, например `Opus is experiencing high load, please use /model to switch to Sonnet`. На моделях Fable сообщение называет Fable.

450

451 В сессии, которую запускает приложение Claude Desktop, такой как вкладка Code или Cowork, сообщение читается как `Opus is experiencing high load. Switch to Sonnet.` и вы переключаете модели с помощью средства выбора модели приложения.

420 452

421<h3 id="request-timed-out">453<h3 id="request-timed-out">

422 Request timed out454 Request timed out

433**Что делать:**465**Что делать:**

434 466

435* Повторите запрос467* Повторите запрос

436* Для долгосрочных задач разбейте работу на более мелкие приглашения

437* Если причина в медленной сети или прокси, увеличьте `API_TIMEOUT_MS`, как описано в [Automatic retries](#automatic-retries)468* Если причина в медленной сети или прокси, увеличьте `API_TIMEOUT_MS`, как описано в [Automatic retries](#automatic-retries)

438* Если тайм-ауты частые и ваша сеть в остальном здорова, см. [Network and connection errors](#network-and-connection-errors) ниже469* Если тайм-ауты частые и ваша сеть в остальном здорова, см. [Network and connection errors](#network-and-connection-errors) ниже

439 470

457**Что делать:**488**Что делать:**

458 489

459* Отправьте сообщение еще раз. Ваше исходное сообщение все еще находится в разговоре, поэтому для длинного приглашения вы можете ввести `try again` вместо вставки всего текста.490* Отправьте сообщение еще раз. Ваше исходное сообщение все еще находится в разговоре, поэтому для длинного приглашения вы можете ввести `try again` вместо вставки всего текста.

460* Если это повторяется, рассматривайте это как [network or proxy problem](#unable-to-connect-to-api). Прокси, который принимает соединение и никогда не пересылает запрос, производит эту ошибку при каждой попытке.491* Если это повторяется, рассматривайте это как [network or proxy problem](#unable-to-connect-to-api).

461* Если прокси или шлюз в вашей сети держит ответы до их завершения, увеличьте `API_TIMEOUT_MS`, чтобы повторная попытка ждала дольше. На Amazon Bedrock также увеличьте `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`.492* Если прокси или шлюз в вашей сети держит ответы до их завершения, увеличьте `API_TIMEOUT_MS`, чтобы повторная попытка ждала дольше. На Amazon Bedrock также увеличьте `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`.

462* Если первая попытка продолжает истекать по времени, а повторная попытка затем успешна, увеличьте `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`, чтобы первая попытка также ждала достаточно долго.493* Если первая попытка продолжает истекать по времени, а повторная попытка затем успешна, увеличьте `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`, чтобы первая попытка также ждала достаточно долго.

463 494

474API Error: Connection lost mid-response. The response above may be incomplete.505API Error: Connection lost mid-response. The response above may be incomplete.

475API Error: Your computer went to sleep mid-response. The response above may be incomplete.506API Error: Your computer went to sleep mid-response. The response above may be incomplete.

476API Error: The response stopped arriving. The response above may be incomplete.507API Error: The response stopped arriving. The response above may be incomplete.

508API Error: Part of the response never arrived. The response above may be incomplete.

509API Error: The response stream was malformed. The response above may be incomplete.

477```510```

478 511

479* `Server error mid-response`: ошибка сервера перегрузки или 5xx в середине потока. Этот вариант требует Claude Code v2.1.199 или позже; до этого этот случай отбросил частичный выход и сообщил весь ход как ошибку.512* `Server error mid-response`: ошибка сервера перегрузки или 5xx в середине потока. Этот вариант требует Claude Code v2.1.199 или позже; до этого этот случай отбросил частичный выход и сообщил весь ход как ошибку.

480* `Connection lost mid-response`: соединение разорвалось.513* `Connection lost mid-response`: соединение разорвалось. Вы также видите этот вариант, когда прокси или шлюз завершает тело ответа чистым образом перед завершением ответа.

481* `Your computer went to sleep mid-response`: Claude Code обнаружил, что ваш компьютер перешел в режим сна во время потоковой передачи ответа. После пробуждения компьютера Claude Code рассматривает соединение как разорванное и прекращает чтение из него.514* `Your computer went to sleep mid-response`: Claude Code обнаружил, что ваш компьютер перешел в режим сна во время потоковой передачи ответа. После пробуждения компьютера Claude Code рассматривает соединение как разорванное и прекращает чтение из него.

515* `Part of the response never arrived`: событие потока было потеряно между API и Claude Code, поэтому более позднее событие ссылалось на содержимое, которое никогда не прибыло. До v2.1.281 этот случай завершал ход с `API Error: Content block not found`.

516* `The response stream was malformed`: событие прибыло для блока содержимого, который уже завершился, или событие прибыло поврежденным. Поврежденное событие — это событие, чьи данные не являются действительным JSON, чье содержимое отсутствует или чье содержимое не соответствует типу события. До v2.1.284 ошибка парсера, такая как начинающаяся с `API Error: JSON Parse error`, появлялась вместо этого, когда событие с недействительным JSON прибыло после того, как Claude завершил свое мышление, блок текста или вызов инструмента.

482* `The response stopped arriving`: соединение оставалось открытым, но перестало доставлять данные, поэтому потоковый idle watchdog прервал его. До v2.1.222 Claude Code также мог сообщить об этом сбое на [gateway](/docs/ru/gateways) соединениях, достигнутых через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`, пока пинги keep-alive сервера все еще поступали, потому что он считал только проанализированные события ответа там; обновление останавливает эти ложные тайм-ауты на этих маршрутах. Шлюзы, достигнутые через URL базы поставщика, такой как `ANTHROPIC_BEDROCK_BASE_URL`, не обернуты байт-уровневым watchdog; см. [Streaming idle watchdogs](/docs/ru/network-config#streaming-idle-watchdogs).517* `The response stopped arriving`: соединение оставалось открытым, но перестало доставлять данные, поэтому потоковый idle watchdog прервал его. До v2.1.222 Claude Code также мог сообщить об этом сбое на [gateway](/docs/ru/gateways) соединениях, достигнутых через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`, пока пинги keep-alive сервера все еще поступали, потому что он считал только проанализированные события ответа там; обновление останавливает эти ложные тайм-ауты на этих маршрутах. Шлюзы, достигнутые через URL базы поставщика, такой как `ANTHROPIC_BEDROCK_BASE_URL`, не обернуты байт-уровневым watchdog; см. [Streaming idle watchdogs](/docs/ru/network-config#streaming-idle-watchdogs).

483 518

484До v2.1.227 `Connection lost mid-response` читалось как `Connection closed mid-response` и `The response stopped arriving` читалось как `Response stalled mid-stream`.519До v2.1.227 `Connection lost mid-response` читалось как `Connection closed mid-response` и `The response stopped arriving` читалось как `Response stalled mid-stream`.

485 520

521Когда опущенное, дублированное или поврежденное событие потока прибывает до того, как Claude начал какой-либо текст или вызов инструмента, вы не видите это уведомление:

522

523* Если Claude завершил только свое мышление, Claude Code переиздает запрос. Когда переизданные потоки ломаются таким же образом, ход завершается с `Part of the response never arrived and no response was produced. Try again.` или `The response stream was malformed and no response was produced. Try again.`

524* Если ничего не завершилось, Claude Code повторно отправляет запрос без потоковой передачи вместо этого. Если вы отключили этот fallback с помощью [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](/docs/ru/env-vars), ход завершается с `API Error: Content block not found` для опущенного события или `API Error: Content block already closed` для дублированного. Для поврежденного события с отключенным fallback ход завершается с `API Error: Stream event unreadable` или ошибкой парсера.

525

486В четырех случаях Claude Code обрабатывает сбой без отображения этого уведомления сразу:526В четырех случаях Claude Code обрабатывает сбой без отображения этого уведомления сразу:

487 527

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

512<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.552<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.

513```553```

514 554

515Когда Claude Code может определить категорию сбоя, он называет категорию в скобках после `temporarily unavailable`, например `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. Категории: `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` и `(connection failed)`. Ограничение скорости, перегрузка и ошибки сервера являются временными, и повторная попытка работает. Если `(timed out)` или `(connection failed)` повторяется, проверьте ваше соединение; см. [Unable to connect to API](#unable-to-connect-to-api). До v2.1.229 сообщение никогда не называло категорию и читалось как `Wait briefly and then try this action again`.555Когда Claude Code может определить категорию сбоя, он называет категорию в скобках после `temporarily unavailable`, например `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. Категории: `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` и `(connection failed)`. Если `(timed out)` или `(connection failed)` повторяется, проверьте ваше соединение; см. [Unable to connect to API](#unable-to-connect-to-api). До v2.1.229 сообщение никогда не называло категорию и читалось как `Wait briefly and then try this action again`.

516 556

517Когда ни одна категория не подходит, сообщение появляется без категории в скобках; более одного сбоя производит эту форму. На [Amazon Bedrock](/docs/ru/amazon-bedrock), включая [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), это также появляется, когда ваша учетная запись AWS не может вызвать модель, указанную в сообщении, и этот сбой повторяется при каждой повторной попытке, пока вашей учетной записи не будет предоставлен доступ к модели.557Когда ни одна категория не подходит, сообщение появляется без категории в скобках; более одного сбоя производит эту форму. На [Amazon Bedrock](/docs/ru/amazon-bedrock), включая [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), это также появляется, когда ваша учетная запись AWS не может вызвать модель, указанную в сообщении, и этот сбой повторяется при каждой повторной попытке, пока вашей учетной записи не будет предоставлен доступ к модели.

518 558

533**Что делать:**573**Что делать:**

534 574

535* Повторите действие; это обычно успешно при следующей попытке575* Повторите действие; это обычно успешно при следующей попытке

536* Запустите `claude --debug` и повторите действие, чтобы увидеть основной ответ классификатора в журнале отладки576* Запустите `claude --debug` и повторите действие для деталей в журнале отладки

537 577

538Когда отдельная проверка безопасности API заблокировала запрос классификатора из-за более раннего содержимого разговора:578Когда отдельная проверка безопасности API заблокировала запрос классификатора из-за более раннего содержимого разговора:

539 579

668API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context708API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context

669```709```

670 710

671Это проверка прав доступа, а не исчерпание квоты. Она срабатывает даже когда ваши лимиты сеанса и недели имеют оставшуюся ёмкость. См. [Extended context](/docs/ru/model-config#extended-context) для информации о том, какие планы включают контекст 1M напрямую и какие требуют кредитов использования. Claude Code выполняет эту проверку, когда вы выбираете модель с помощью `/model`, и только при прямом подключении к API Anthropic; если вы указываете `ANTHROPIC_BASE_URL` на [LLM gateway](/docs/ru/llm-gateway), `/model` позволяет выбрать `[1m]` и шлюз решает, будет ли запрос успешным.711В сеансе, который запускает Claude Desktop app, подсказка не называет команды: она указывает на страницу параметров использования claude.ai, или на планах Team и Enterprise говорит включить кредиты использования на claude.ai/admin-settings/usage или попросить вашего администратора.

712

713Это проверка прав доступа, а не исчерпание квоты. Она срабатывает даже когда ваши лимиты сеанса и недели имеют оставшуюся ёмкость. См. [Extended context](/docs/ru/model-config#extended-context) для информации о том, какие планы включают контекст 1M напрямую и какие требуют кредитов использования.

672 714

673Когда эта ошибка появляется в середине разговора, потому что контекст вырос более чем на 200K токенов, Claude Code автоматически сжимает разговор обратно под стандартный лимит контекста и сохраняет сеанс на этом лимите впоследствии, поэтому никаких действий не требуется. В версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая `/compact`; запустите `/clear` на этих версиях для восстановления. Приведённые ниже шаги применяются, когда вы явно выбрали модель `[1m]`.715Когда эта ошибка появляется в середине разговора, потому что контекст вырос более чем на 200K токенов, Claude Code автоматически сжимает разговор обратно под стандартный лимит контекста и сохраняет сеанс на этом лимите впоследствии, поэтому никаких действий не требуется. В версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая `/compact`; запустите `/clear` на этих версиях для восстановления. Приведённые ниже шаги применяются, когда вы явно выбрали модель `[1m]`.

674 716

733 775

734Завершающее предложение называет, где проверить здоровье сервиса, и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry называют страницу статуса этого поставщика вместо страницы статуса Anthropic. Пользовательский `ANTHROPIC_BASE_URL` называет хост шлюза.776Завершающее предложение называет, где проверить здоровье сервиса, и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry называют страницу статуса этого поставщика вместо страницы статуса Anthropic. Пользовательский `ANTHROPIC_BASE_URL` называет хост шлюза.

735 777

778Когда прокси, балансировщик нагрузки или шлюз между Claude Code и API отвечает своей собственной HTML-страницей 429, текст после `·` — это название этой страницы, если оно есть, например `Too Many Requests`. До версии v2.1.281 вся разметка страницы была напечатана после `·`.

779

736**Что делать:**780**Что делать:**

737 781

738* Запустите `/status` и подтвердите, что активные учётные данные — это те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может маршрутизировать запросы через низкоуровневый ключ вместо вашей подписки.782* Запустите `/status` и подтвердите, что активные учётные данные — это те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может маршрутизировать запросы через низкоуровневый ключ вместо вашей подписки.

839Not logged in · Please run /login883Not logged in · Please run /login

840```884```

841 885

886В сеансе, который запускает приложение Claude Desktop, например на вкладке Code или Cowork, сообщение читается как `Authentication required · Sign in again to continue`, и вы снова входите из приложения.

887

842**Что делать:**888**Что делать:**

843 889

844* Запустите `/login` для аутентификации с помощью вашей подписки Claude или учетной записи Console890* Запустите `/login` для аутентификации с помощью вашей подписки Claude или учетной записи Console

845* Если вы ожидали, что переменная окружения будет аутентифицировать вас, убедитесь, что `ANTHROPIC_API_KEY` установлена и экспортирована в оболочке, где вы запустили `claude`891* Если вы ожидали, что переменная окружения будет вас аутентифицировать, убедитесь, что `ANTHROPIC_API_KEY` установлена и экспортирована в оболочке, где вы запустили `claude`

846* Для CI или автоматизации, где интерактивный вход невозможен, настройте скрипт [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), который получает ключ при запуске892* Для CI или автоматизации, где интерактивный вход невозможен, настройте скрипт [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), который получает ключ при запуске

847* См. [Authentication precedence](/docs/ru/authentication#authentication-precedence), чтобы понять, какие учетные данные Claude Code использует, когда присутствует несколько893* См. [Authentication precedence](/docs/ru/authentication#authentication-precedence), чтобы понять, какие учетные данные Claude Code использует, когда присутствует несколько

848 894

852 Could not resolve authentication method898 Could not resolve authentication method

853</h3>899</h3>

854 900

855Сеанс достиг клиента API без каких-либо учетных данных. [Background sessions](/docs/ru/agent-view) и облачные сеансы показывают это сообщение, когда рабочий процесс запускается без учетных данных. Интерактивные, `-p` и запуски Agent SDK сообщают о том же состоянии, что и [Not logged in](#not-logged-in) и записывают эту строку только в журнал отладки, поэтому если вы нашли ее там, следуйте этой записи вместо этого.901Сеанс достиг клиента API без каких-либо учетных данных. [Background sessions](/docs/ru/agent-view) и облачные сеансы показывают это сообщение, когда рабочий процесс запускается без учетных данных. Интерактивные, `-p` и запуски Agent SDK сообщают о том же состоянии, что и [Not logged in](#not-logged-in), и записывают эту строку только в свой журнал отладки, поэтому если вы нашли ее там, следуйте этой записи вместо этого.

856 902

857```text theme={null}903```text theme={null}

858Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted904Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

877Invalid API key · Fix external API key923Invalid API key · Fix external API key

878```924```

879 925

880Когда сообщение продолжается после `Fix external API key` с описанием, таким как `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`, API никогда не видел ключ. Claude Code обнаружил символ, который HTTP-заголовки не могут передавать, и остановил запрос перед его отправкой. См. [Invalid request header value](#invalid-request-header-value) для того, как прочитать описание и исправить значение.926Когда сообщение продолжается после `Fix external API key` с описанием, таким как `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`, API никогда не видел ключ. Claude Code обнаружил символ, который HTTP-заголовки не могут передавать, и остановил запрос перед его отправкой. См. [Invalid request header value](#invalid-request-header-value), чтобы узнать, как прочитать описание и исправить значение.

881 927

882**Что делать:**928**Что делать:**

883 929

885* В той же оболочке запустите `env | grep ANTHROPIC`, или в PowerShell `Get-ChildItem Env:ANTHROPIC*`. Такие инструменты, как direnv, плагины dotenv shell и терминалы IDE, могут загружать устаревший ключ из файла `.env` в вашем проекте без явной установки.931* В той же оболочке запустите `env | grep ANTHROPIC`, или в PowerShell `Get-ChildItem Env:ANTHROPIC*`. Такие инструменты, как direnv, плагины dotenv shell и терминалы IDE, могут загружать устаревший ключ из файла `.env` в вашем проекте без явной установки.

886* Отмените установку `ANTHROPIC_API_KEY` и запустите `/login` для использования аутентификации подписки вместо этого932* Отмените установку `ANTHROPIC_API_KEY` и запустите `/login` для использования аутентификации подписки вместо этого

887* Если ключ поступает из скрипта [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), запустите скрипт напрямую, чтобы подтвердить, что он выводит действительный ключ на stdout933* Если ключ поступает из скрипта [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), запустите скрипт напрямую, чтобы подтвердить, что он выводит действительный ключ на stdout

888* Запустите `/status`, чтобы подтвердить, какой источник учетных данных Claude Code фактически использует934* Запустите `/status`, чтобы подтвердить, какой источник учетных данных Claude Code на самом деле использует

889 935

890<h3 id="your-apikeyhelper-script-is-failing">936<h3 id="your-apikeyhelper-script-is-failing">

891 Your apiKeyHelper script is failing937 Your apiKeyHelper script is failing

892</h3>938</h3>

893 939

894Claude Code запустил команду в вашей настройке [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) и не получил ключ обратно. Без него запрос достигает API с заполнительными учетными данными, и API отклоняет его с `401`. Панель `Authentication` в терминале показывает, что произошло одно из следующих:940Claude Code запустил команду в вашей настройке [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) и не получил ключ обратно. Без него запрос достигает API с учетными данными-заполнителем, и API отклоняет его с `401`. Панель `Authentication` в терминале показывает, что произошло:

895 941

896* Команда завершилась с ошибкой или истекло время ожидания942* Команда завершилась с ошибкой или истекло время ожидания

897* Команда ничего не вывела на stdout943* Команда ничего не вывела на stdout

903 949

904В [non-interactive mode](/docs/ru/headless) stderr также содержит конкретную причину с префиксом `apiKeyHelper failed:`.950В [non-interactive mode](/docs/ru/headless) stderr также содержит конкретную причину с префиксом `apiKeyHelper failed:`.

905 951

906Claude Code повторно запускает скрипт и повторяет попытку запроса еще два раза перед отображением этого сообщения, поэтому сбой проявляется в течение трех попыток. До v2.1.208 Claude Code потратил полный [retry budget](#automatic-retries) на повторную отправку запроса с заполнительными учетными данными, а затем сообщил об общей ошибке аутентификации `401` вместо сбоя скрипта.952Claude Code повторно запускает скрипт и повторяет попытку запроса еще два раза перед отображением этого сообщения, поэтому сбой проявляется в течение трех попыток. До v2.1.208 Claude Code тратил полный [retry budget](#automatic-retries), повторно отправляя запрос с учетными данными-заполнителем, а затем сообщал об общей ошибке аутентификации `401` вместо сбоя скрипта.

907 953

908Запуск `/login` не помогает здесь: вывод помощника [takes precedence](/docs/ru/authentication#authentication-precedence) над сохраненным входом, пока параметр присутствует.954Запуск `/login` здесь не помогает: вывод помощника [takes precedence](/docs/ru/authentication#authentication-precedence) над сохраненным входом, пока параметр присутствует.

909 955

910**Что делать:**956**Что делать:**

911 957

912* Запустите команду, настроенную в `apiKeyHelper`, напрямую в вашей оболочке, чтобы воспроизвести сбой958* Запустите команду, настроенную в `apiKeyHelper`, непосредственно в вашей оболочке, чтобы воспроизвести сбой

913* Если команда сообщает об истекшем сеансе, повторно аутентифицируйтесь у вашего поставщика учетных данных, например, снова войдя в свой SSO или хранилище секретов959* Если команда сообщает об истекшем сеансе, повторно аутентифицируйтесь с помощью вашего поставщика учетных данных, например, снова войдя в свой SSO или хранилище секретов

914* Исправьте команду так, чтобы она выводила только ключ на stdout как один токен печатаемого ASCII до 16 384 символов и выходила с кодом 0. См. [rotate credentials with apiKeyHelper](/docs/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) для рабочей установки.960* Исправьте команду так, чтобы она выводила только ключ на stdout как один токен печатаемого ASCII до 16 384 символов и выходила с кодом 0. См. [rotate credentials with apiKeyHelper](/docs/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) для рабочей установки.

915* Запустите `/status`, чтобы подтвердить, что `apiKeyHelper` является активным источником учетных данных. Строка `apiKeyHelper` показывает `Failing` с деталью последнего сбоя, такой как код выхода и вывод ошибки команды, и исчезает после следующего успешного запуска. До v2.1.274 `/status` показал только источник учетных данных, а не сбой.961* Запустите `/status`, чтобы увидеть сбой и подтвердить, что `apiKeyHelper` является активным источником учетных данных. Строка `apiKeyHelper` показывает `Failing` с деталью последнего сбоя, такой как код выхода и вывод ошибки команды, и исчезает после следующего успешного запуска. До v2.1.274 `/status` показывал только источник учетных данных, а не сбой.

916* Каждый раз, когда команда не выполняется, ее код выхода и вывод ошибки также появляются в панели `Authentication` в терминале. До v2.1.212 панель была озаглавлена `Cloud authentication`.962* Каждый раз, когда команда не выполняется, ее код выхода и вывод ошибки также появляются в панели `Authentication` в терминале. До v2.1.212 панель была озаглавлена `Cloud authentication`.

917 963

918<h3 id="invalid-request-header-value">964<h3 id="invalid-request-header-value">

921 967

922Значение, которое Claude Code собирался отправить как заголовок запроса, содержит символ, который HTTP-заголовки не могут передавать: разрыв строки, байт NUL или символ выше `U+00FF`, такой как фигурная кавычка или нулевой пробел. Claude Code останавливает запрос перед отправкой чего-либо и называет переменную или параметр для исправления. Обычная причина — учетные данные, вставленные из документа или чата, которые содержали невидимый символ или случайный разрыв строки.968Значение, которое Claude Code собирался отправить как заголовок запроса, содержит символ, который HTTP-заголовки не могут передавать: разрыв строки, байт NUL или символ выше `U+00FF`, такой как фигурная кавычка или нулевой пробел. Claude Code останавливает запрос перед отправкой чего-либо и называет переменную или параметр для исправления. Обычная причина — учетные данные, вставленные из документа или чата, которые содержали невидимый символ или случайный разрыв строки.

923 969

924Claude Code запускает эту проверку при отправке запросов к Claude API напрямую или через [LLM gateway](/docs/ru/llm-gateway). На поставщике облачных услуг третьей стороны, таком как [Amazon Bedrock](/docs/ru/amazon-bedrock), Claude Code не запускает ее перед отправкой.970Claude Code запускает эту проверку при отправке запросов к Claude API напрямую или через [LLM gateway](/docs/ru/llm-gateway). На стороннем облачном провайдере, таком как [Amazon Bedrock](/docs/ru/amazon-bedrock), Claude Code не запускает ее перед отправкой.

925 971

926```text theme={null}972```text theme={null}

927Invalid auth token · Fix external auth token973Invalid auth token · Fix external auth token

932Первая часть сообщения зависит от того, откуда поступило плохое значение:978Первая часть сообщения зависит от того, откуда поступило плохое значение:

933 979

934* `Invalid auth token`: токен-носитель из [`ANTHROPIC_AUTH_TOKEN`](/docs/ru/env-vars) или [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars)980* `Invalid auth token`: токен-носитель из [`ANTHROPIC_AUTH_TOKEN`](/docs/ru/env-vars) или [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars)

935* `Invalid ANTHROPIC_CUSTOM_HEADERS`: имя или значение заголовка, которое вы установили в [`ANTHROPIC_CUSTOM_HEADERS`](/docs/ru/env-vars). Описание подсчитывает, какая пара `Name: Value` виновата, например `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, без повторения имени или значения, так как вы выбрали оба.981* `Invalid ANTHROPIC_CUSTOM_HEADERS`: имя заголовка или значение, которое вы установили в [`ANTHROPIC_CUSTOM_HEADERS`](/docs/ru/env-vars). Описание подсчитывает, какая пара `Name: Value` виновата, например `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, без повторения имени или значения, так как вы выбрали оба.

936* `Invalid request header from the environment`: значение, которое Claude Code копирует в заголовок запроса из другой переменной окружения, такой как `CLAUDE_AGENT_SDK_CLIENT_APP`. Описание называет переменную для исправления.982* `Invalid request header from the environment`: значение, которое Claude Code копирует в заголовок запроса из другой переменной окружения, такой как `CLAUDE_AGENT_SDK_CLIENT_APP`. Описание называет переменную для исправления.

937 983

938Claude Code сообщает о плохом `ANTHROPIC_API_KEY`, перехваченном этой проверкой, как [Invalid API key](#invalid-api-key), с тем же завершающим описанием. Он сообщает о плохих сохраненных учетных данных `/login` как [Not logged in](#not-logged-in) вместо этого; запустите `/login`, чтобы сохранить свежие. Вывод скрипта [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) никогда не достигает этой проверки: Claude Code проверяет его при запуске скрипта, и вывод, который HTTP-заголовок не может передавать, завершается ошибкой [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing).984Claude Code сообщает о плохом `ANTHROPIC_API_KEY`, перехваченном этой проверкой, как [Invalid API key](#invalid-api-key), с тем же завершающим описанием. Он сообщает о плохих сохраненных учетных данных `/login` как [Not logged in](#not-logged-in) вместо этого; запустите `/login`, чтобы сохранить свежие. Вывод скрипта [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) никогда не достигает этой проверки: Claude Code проверяет его при запуске скрипта, и вывод, который HTTP-заголовок не может передавать, завершается ошибкой [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing).

943Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).989Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).

944```990```

945 991

946Позиции считают символы, начиная с одного. Описание построено из фиксированных фраз и подсчетов символов, поэтому оно никогда не включает само значение. Оно называет оскорбительный символ только тогда, когда это хорошо известный невидимый или типографский символ, такой как метка порядка байтов, нулевой пробел или фигурная кавычка, и сообщает обо всем остальном как `a non-ASCII character`.992Позиции считают символы, начиная с одного. Описание построено из фиксированных фраз и подсчета символов, поэтому оно никогда не включает само значение. Оно называет оскорбительный символ только тогда, когда это хорошо известный невидимый или типографский символ, такой как метка порядка байтов, нулевой пробел или фигурная кавычка, и сообщает все остальное как `a non-ASCII character`.

947 993

948**Что делать:**994**Что делать:**

949 995

963API Error: 400 ... This organization has been disabled.1009API Error: 400 ... This organization has been disabled.

964```1010```

965 1011

966Подсказка после `·` зависит от ваших сохраненных учетных данных: первая форма появляется, когда сохраненный `/login` может взять верх после отмены установки ключа, а вторая — когда ключ является вашим единственным учетным данным.1012Подсказка после `·` зависит от ваших сохраненных учетных данных: первая форма появляется, когда сохраненный `/login` может взять верх после отмены установки ключа, а вторая, когда ключ является вашим единственным учетным данным.

967 1013

968Переменные окружения имеют приоритет над `/login`, поэтому ключ, экспортированный в профиль вашей оболочки или загруженный из файла `.env`, используется даже при наличии рабочей подписки Pro или Max. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии.1014Переменные окружения имеют приоритет над `/login`, поэтому ключ, экспортированный в профиль вашей оболочки или загруженный из файла `.env`, используется даже при наличии рабочей подписки Pro или Max. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии.

969 1015

972* Отмените установку `ANTHROPIC_API_KEY` в текущей оболочке и удалите его из профиля вашей оболочки, затем перезапустите `claude`1018* Отмените установку `ANTHROPIC_API_KEY` в текущей оболочке и удалите его из профиля вашей оболочки, затем перезапустите `claude`

973* Если сообщение говорит `Update or unset`, у вас нет сохраненного входа для отката. Отмените установку ключа и запустите `/login`, или замените ключ на ключ из активной организации Console.1019* Если сообщение говорит `Update or unset`, у вас нет сохраненного входа для отката. Отмените установку ключа и запустите `/login`, или замените ключ на ключ из активной организации Console.

974* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка1020* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка

975* Если переменная окружения не установлена и ошибка сохраняется, отключенная организация — это та, которая связана с вашим `/login`. Свяжитесь с поддержкой или войдите с другой учетной записью.1021* Если переменная окружения не установлена и ошибка сохраняется, свяжитесь с поддержкой или войдите с другой учетной записью.

976 1022

977<h3 id="your-organization-has-disabled-api-key-authentication">1023<h3 id="your-organization-has-disabled-api-key-authentication">

978 Your organization has disabled API key authentication1024 Your organization has disabled API key authentication

979</h3>1025</h3>

980 1026

981Это сообщение требует Claude Code v2.1.169 или более поздней версии. Администратор организации Console отключил аутентификацию по ключу API, поэтому API отклоняет ключ, который отправляет Claude Code. Подсказка восстановления после `·` варьируется в зависимости от того, откуда поступил ключ:1027Это сообщение требует Claude Code v2.1.169 или более поздней версии. Администратор вашей организации Console отключил аутентификацию по ключу API, поэтому API отклоняет ключ, который отправляет Claude Code. Подсказка восстановления после `·` варьируется в зависимости от того, откуда поступил ключ:

982 1028

983```text theme={null}1029```text theme={null}

984Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account1030Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account

985Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead1031Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead

986Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account1032Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account

987Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account1033Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

1034Your organization has disabled API key authentication · Sign in again with your claude.ai account

988```1035```

989 1036

990Переменные окружения и `apiKeyHelper` имеют приоритет над `/login`, поэтому запуск только `/login` не помогает, пока один из них все еще предоставляет ключ. См. [Authentication precedence](/docs/ru/authentication#authentication-precedence).1037Последняя форма появляется в сеансе, который запускает приложение Claude Desktop, такой как вкладка Code или Cowork, где вы снова входите из приложения.

1038

1039Переменные окружения и `apiKeyHelper` имеют приоритет над `/login`, поэтому запуск только `/login` не помогает, пока любой из них все еще предоставляет ключ. См. [Authentication precedence](/docs/ru/authentication#authentication-precedence).

991 1040

992**Что делать:**1041**Что делать:**

993 1042

994* Если сообщение называет `ANTHROPIC_API_KEY`, отмените его установку в текущей оболочке и удалите из профиля вашей оболочки или файла `.env`, затем перезапустите `claude`1043* Если сообщение называет `ANTHROPIC_API_KEY`, отмените его установку в текущей оболочке и удалите его из профиля вашей оболочки или файла `.env`, затем перезапустите `claude`

995* Если сообщение называет `apiKeyHelper`, удалите параметр [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) из вашего `settings.json`1044* Если сообщение называет `apiKeyHelper`, удалите параметр [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) из вашего `settings.json`

996* Запустите `/login` для входа с вашей учетной записью claude.ai1045* Запустите `/login`, чтобы войти с помощью вашей учетной записи claude.ai

997* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка, а не ключ API1046* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка, а не ключ API

998* Если вам нужна аутентификация по ключу API для автоматизации, попросите администратора вашей организации повторно включить ее в Console1047* Если вам нужна аутентификация по ключу API для автоматизации, попросите администратора вашей организации повторно включить ее в Console

999 1048

1001 Your organization has disabled Claude subscription access1050 Your organization has disabled Claude subscription access

1002</h3>1051</h3>

1003 1052

1004Ваша организация Claude не позволяет входить в Claude Code с входом подписки. Повторный запуск `/login` с той же учетной записью возвращает ту же ошибку.1053Ваша организация Claude не позволяет входить в Claude Code с помощью входа подписки. Запуск `/login` снова с той же учетной записью возвращает ту же ошибку.

1005 1054

1006```text theme={null}1055```text theme={null}

1007Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access1056Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

1009 1058

1010Это параметр организации на стороне сервера, поэтому его нельзя переопределить из локальных параметров, переменных окружения или флагов CLI.1059Это параметр организации на стороне сервера, поэтому его нельзя переопределить из локальных параметров, переменных окружения или флагов CLI.

1011 1060

1012Agent SDK и режим неинтерактивности `-p` представляют это как код ошибки `oauth_org_not_allowed`.1061Agent SDK и неинтерактивный режим `-p` отображают это как код ошибки `oauth_org_not_allowed`.

1013 1062

1014**Что делать:**1063**Что делать:**

1015 1064

1021 Routines are disabled by your organization's policy1070 Routines are disabled by your organization's policy

1022</h3>1071</h3>

1023 1072

1024An Owner в вашей организации Team или Enterprise отключил routines на уровне организации. Ошибка появляется при попытке создать или запустить routine, например из пользовательского интерфейса [Routines](/docs/ru/routines) на claude.ai/code. На Claude Code v2.1.227 или более поздней версии тот же параметр также [hides `/schedule`](/docs/ru/routines#troubleshooting) в CLI.1073Владелец в вашей организации Team или Enterprise отключил routines на уровне организации. Ошибка появляется при попытке создать или запустить routine, например из пользовательского интерфейса [Routines](/docs/ru/routines) на claude.ai/code. На Claude Code v2.1.227 или более поздней версии тот же параметр также [hides `/schedule`](/docs/ru/routines#troubleshooting) в CLI.

1025 1074

1026```text theme={null}1075```text theme={null}

1027Routines are disabled by your organization's policy.1076Routines are disabled by your organization's policy.

1038 Remote Control requires the Anthropic API1087 Remote Control requires the Anthropic API

1039</h3>1088</h3>

1040 1089

1041Сеанс не разговаривает с Anthropic API напрямую, поэтому нет бэкенда claude.ai для [Remote Control](/docs/ru/remote-control) для сопряжения.1090Сеанс не разговаривает с Anthropic API напрямую, что требует [Remote Control](/docs/ru/remote-control).

1042 1091

1043```text theme={null}1092```text theme={null}

1044Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.1093Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.

1061 Remote Control couldn't refresh your login1110 Remote Control couldn't refresh your login

1062</h3>1111</h3>

1063 1112

1064Claude Code запускает живое соединение [Remote Control](/docs/ru/remote-control) на краткосрочных учетных данных, которые он получает и обновляет, используя ваш сохраненный вход claude.ai. Когда claude.ai перестает принимать этот вход, или Claude Code больше не имеет сохраненного входа, Claude Code останавливает Remote Control и просит вас войти снова. Любой сбой может произойти, пока Claude Code все еще подключается или позже, когда он обновляет учетные данные.1113Claude Code запускает живое соединение [Remote Control](/docs/ru/remote-control) на краткосрочных учетных данных, которые он получает и обновляет, используя ваш сохраненный вход claude.ai. Когда claude.ai перестает принимать этот вход, или Claude Code больше не имеет сохраненного входа, Claude Code останавливает Remote Control и просит вас снова войти. Любой сбой может произойти, пока Claude Code все еще подключается, или позже, когда он обновляет учетные данные.

1065 1114

1066Когда Claude Code просит службу входа обновить ваш сохраненный вход и не получает ответ, он продолжает запускать Remote Control и пытается обновление снова, пока учетные данные текущего соединения все еще действительны. Обновление не получает ответ, когда Claude Code не может достичь службы входа, запрос истекает, или служба завершается ошибкой без отклонения вашего входа. Если служба входа все еще не отвечает, когда эти учетные данные истекают, Claude Code останавливает Remote Control и сообщает `OAuth token refresh failed`.1115Когда Claude Code просит службу входа обновить ваш сохраненный вход и не получает ответ, он продолжает работу Remote Control и пытается обновление снова, пока текущее учетное данные соединения все еще действительны. Обновление не получает ответ, когда Claude Code не может достичь службы входа, запрос истекает, или служба завершается ошибкой без отклонения вашего входа. Если служба входа все еще не отвечает, когда это учетное данные истекает, Claude Code останавливает Remote Control и сообщает `OAuth token refresh failed`.

1067 1116

1068Когда Claude Code останавливает Remote Control, он показывает причину в предупреждении и в строке стенограммы, которая начинается с `Remote Control disconnected`. Ваш локальный сеанс продолжает работать без Remote Control. Этот раздел охватывает эти строки:1117Когда Claude Code останавливает Remote Control, он показывает причину в предупреждении и в строке стенограммы, которая начинается с `Remote Control disconnected`. Ваш локальный сеанс продолжает работу без Remote Control. Этот раздел охватывает эти строки:

1069 1118

1070```text theme={null}1119```text theme={null}

1071Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control1120Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control

1079 1128

1080Claude Code называет причину в середине сообщения:1129Claude Code называет причину в середине сообщения:

1081 1130

1082* `Claude.ai login expired` и `Claude.ai login was rejected`: claude.ai больше не принимает ваш сохраненный токен входа, потому что он истек или был отозван1131* ` Claude.ai login expired` и `Claude.ai login was rejected`: claude.ai больше не принимает ваш сохраненный токен входа, потому что он истек или был отозван

1083* `OAuth token unavailable`: Claude Code не имел сохраненного токена входа, когда учетные данные соединения пришли на обновление1132* ` OAuth token unavailable`: Claude Code не имел сохраненного токена входа, когда учетные данные соединения пришли на обновление

1084* `OAuth token refresh failed`: claude.ai отклонил ваш сохраненный токен входа, пока Claude Code переподключался, и обновление токена не произвело новый1133* `OAuth token refresh failed`: claude.ai отклонил ваш сохраненный токен входа, пока Claude Code переподключался, и обновление токена не дало нового

1085* `JWT refresh failed: no OAuth token`: Claude Code не нашел сохраненный токен входа для обновления1134* `JWT refresh failed: no OAuth token`: Claude Code не нашел сохраненный токен входа для обновления

1086* `Signed out of Claude`: вы вышли на этой машине, например, запустив `/logout` в другом терминале, поэтому Claude Code больше не имеет сохраненного входа для обновления соединения1135* ` Signed out of Claude`: вы вышли на этой машине, например, запустив `/logout` в другом терминале, поэтому Claude Code больше не имеет сохраненного входа для обновления соединения

1087 1136

1088**Что делать:**1137**Что делать:**

1089 1138

1090* Запустите `/login` для входа снова1139* Запустите `/login`, чтобы снова войти

1091* Запустите `/remote-control` для переподключения сеанса. Сообщения, заканчивающиеся `run /login to restore Remote Control`, не нуждаются в этом шаге: Claude Code переподключается автоматически после входа.1140* Запустите `/remote-control`, чтобы переподключить сеанс. Сообщения, заканчивающиеся `run /login to restore Remote Control`, не нуждаются в этом шаге: Claude Code переподключается автоматически после входа.

1092 1141

1093До v2.1.224 `OAuth token refresh failed — run /login to re-authenticate` читалось как `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, и `JWT refresh failed: no OAuth token — run /login` читалось как `no OAuth token available for recovery (code <N>)`. Сообщения `Claude.ai login expired`, `Claude.ai login was rejected` и `OAuth token unavailable` были добавлены в v2.1.225.1142До v2.1.224 `OAuth token refresh failed — run /login to re-authenticate` читалось как `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, и `JWT refresh failed: no OAuth token — run /login` читалось как `no OAuth token available for recovery (code <N>)`. Сообщения `Claude.ai login expired`, `Claude.ai login was rejected` и `OAuth token unavailable` были добавлены в v2.1.225.

1094 1143

1106Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control1155Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control

1107```1156```

1108 1157

1109Claude Code останавливает сеанс Remote Control как только claude.ai подтверждает, что учетная запись или организация изменилась. Ваш локальный сеанс продолжает работать без Remote Control.1158Claude Code останавливает сеанс Remote Control как только claude.ai подтверждает, что учетная запись или организация изменились. Ваш локальный сеанс продолжает работу без Remote Control.

1110 1159

1111**Что делать:**1160**Что делать:**

1112 1161

1113* Запустите `/remote-control` для запуска нового сеанса Remote Control под текущей учетной записью или организацией1162* Запустите `/remote-control`, чтобы запустить новый сеанс Remote Control под текущей учетной записью или организацией

1114* Для переключения назад запустите `/login` и войдите в предыдущую учетную запись или организацию снова. Затем запустите `/remote-control`.1163* Для переключения обратно запустите `/login` и снова войдите в предыдущую учетную запись или организацию. Затем запустите `/remote-control`.

1115 1164

1116До v2.1.234 Claude Code не замечал, когда вы переключались на другую учетную запись или организацию вне сеанса Claude Code. Claude Code держал сеанс Remote Control подключенным до более позднего запроса к серверу Remote Control, который завершился ошибкой `Remote Control server rejected the request (HTTP 404)`. Этот сбой мог произойти часами после переключения.1165До v2.1.234 Claude Code не замечал, когда вы переключались на другую учетную запись или организацию вне сеанса Claude Code. Claude Code держал сеанс Remote Control подключенным до более позднего запроса к серверу Remote Control, который завершился ошибкой `Remote Control server rejected the request (HTTP 404)`. Этот сбой мог произойти часами после переключения.

1117 1166

1126Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on1175Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on

1127```1176```

1128 1177

1129Ваш локальный сеанс продолжает работать без Remote Control.1178Ваш локальный сеанс продолжает работу без Remote Control.

1130 1179

1131**Что делать:**1180**Что делать:**

1132 1181

1133* Если приложение вышло, войдите в него снова, затем включите Remote Control снова в приложении1182* Если приложение вышло, снова войдите в него, затем включите Remote Control обратно в приложении

1134* Если приложение переключило учетные записи, Claude Code не может продолжить завершенный сеанс под новой учетной записью. Запустите новый сеанс Remote Control под этой учетной записью.1183* Если приложение переключило учетные записи, Claude Code не может продолжить завершенный сеанс под новой учетной записью. Запустите новый сеанс Remote Control под этой учетной записью.

1135 1184

1136До v2.1.238 Claude Code отправлял приложению сообщения `run /login`, перечисленные в [Remote Control couldn't refresh your login](#remote-control-couldnt-refresh-your-login) в обоих случаях.1185До v2.1.238 Claude Code отправлял приложению сообщения `run /login`, перечисленные в [Remote Control couldn't refresh your login](#remote-control-couldnt-refresh-your-login) в обоих случаях.

1141 1190

1142Ваш сохраненный вход больше не действителен. Отозванный токен означает, что вы вышли везде или администратор удалил доступ; истекший токен означает, что автоматическое обновление не удалось в середине сеанса.1191Ваш сохраненный вход больше не действителен. Отозванный токен означает, что вы вышли везде или администратор удалил доступ; истекший токен означает, что автоматическое обновление не удалось в середине сеанса.

1143 1192

1144Оба сообщения сообщают об отклонении, которое API вернул для запроса, который отправил Claude Code. Когда сохраненный вход уже был очищен после неудачного обновления, вы видите [Login expired](#login-expired) вместо этого. Если вы аутентифицируетесь с долгоживущим токеном в [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars), вы видите те же сообщения, когда этот токен истекает или отзывается.1193Оба сообщения сообщают об отклонении, которое API вернул для запроса, отправленного Claude Code. Когда сохраненный вход уже был очищен после неудачного обновления, вы видите [Login expired](#login-expired) вместо этого. Если вы аутентифицируетесь с помощью долгоживущего токена в [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars), вы видите те же сообщения, когда этот токен истекает или отзывается.

1145 1194

1146```text theme={null}1195```text theme={null}

1147OAuth token revoked · Please run /login1196OAuth token revoked · Please run /login

1150 1199

1151**Что делать:**1200**Что делать:**

1152 1201

1153* Запустите `/login` для входа снова1202* Запустите `/login`, чтобы снова войти

1154* Если ошибка возвращается в том же сеансе после повторной аутентификации, сначала запустите `/logout` для полной очистки сохраненного токена, затем `/login`1203* Если вы аутентифицируетесь с помощью переменной окружения `CLAUDE_CODE_OAUTH_TOKEN`, Claude Code продолжает отправлять установленное вами значение после того, как запрос завершится ошибкой 401, а не переключается на токен сохраненного входа. [`/status`](/docs/ru/commands) показывает это учетное данные как строку `Auth token`, читающую `CLAUDE_CODE_OAUTH_TOKEN`. Создайте свежий токен с помощью [`claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token) и перезапустите с ним, или отмените установку переменной и запустите `/login`. До v2.1.225 Claude Code мог заменить значение переменной в середине сеанса краткосрочным токеном доступа из сохраненного входа, и сеанс снова завершился ошибками 401 после истечения этого токена.

1155* Если вы аутентифицируетесь с переменной окружения `CLAUDE_CODE_OAUTH_TOKEN`, Claude Code продолжает отправлять установленное вами значение после того, как запрос завершится ошибкой 401, а не переключаться на токен сохраненного входа. [`/status`](/docs/ru/commands) показывает это учетное данное как строку `Auth token`, читающую `CLAUDE_CODE_OAUTH_TOKEN`. Создайте свежий токен с помощью [`claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token) и перезапустите с ним, или отмените установку переменной и запустите `/login`. До v2.1.225 Claude Code мог заменить значение переменной в середине сеанса краткосрочным токеном доступа из сохраненного входа, и сеанс снова завершился ошибками 401 после истечения этого токена.

1156* Для повторных запросов на вход при запусках см. проверки системных часов и шаги восстановления хранилища учетных данных macOS в [Troubleshooting](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired)1204* Для повторных запросов на вход при запусках см. проверки системных часов и шаги восстановления хранилища учетных данных macOS в [Troubleshooting](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired)

1157* Для других сбоев, включая `403 Forbidden` и проблемы браузера OAuth, см. [Login and authentication](/docs/ru/troubleshoot-install#login-and-authentication)1205* Для других сбоев, включая `403 Forbidden` и проблемы браузера OAuth, см. [Login and authentication](/docs/ru/troubleshoot-install#login-and-authentication)

1158 1206

1160 API Error: 401 Invalid authentication credentials1208 API Error: 401 Invalid authentication credentials

1161</h3>1209</h3>

1162 1210

1163API распознал формат вашего учетного данного, но отклонил учетную запись или организацию позади него. Anthropic возвращает это сообщение, когда учетное данное было недавно отозвано, когда организация была отключена или удалила ваш доступ, или когда сама учетная запись была деактивирована, поэтому истекший токен не является причиной. Учетное данное может быть вашим сохраненным входом или одобренным `ANTHROPIC_API_KEY`, и исправление отличается, поэтому начните с запуска `/status`, чтобы увидеть, какой активен.1211API распознал формат вашего учетного данные, но отклонил учетную запись или организацию позади него. Anthropic возвращает это сообщение, когда учетные данные были недавно отозваны, когда организация была отключена или удалила ваш доступ, или когда сама учетная запись была деактивирована, поэтому истекший токен не является причиной. Учетные данные могут быть вашим сохраненным входом или одобренным `ANTHROPIC_API_KEY`, и исправление отличается, поэтому начните с запуска `/status`, чтобы увидеть, какой из них активен.

1164 1212

1165```text theme={null}1213```text theme={null}

1166Please run /login · API Error: 401 Invalid authentication credentials1214Please run /login · API Error: 401 Invalid authentication credentials

1168 1216

1169**Что делать:**1217**Что делать:**

1170 1218

1171* Если `/status` показывает строку `API key`, которая не отмечена как не используется, одобренный [`ANTHROPIC_API_KEY`](/docs/ru/authentication#authentication-precedence) является активным учетным данным и имеет приоритет над вашим входом, поэтому `/login` не заменяет его. Поверните ключ в Claude Console, или вернитесь к вашей подписке, запустив `unset ANTHROPIC_API_KEY`, или в PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.1219* Если `/status` показывает строку `API key`, которая не отмечена как не используется, одобренный [`ANTHROPIC_API_KEY`](/docs/ru/authentication#authentication-precedence) является активным учетным данием и имеет приоритет над вашим входом, поэтому `/login` не заменяет его. Поверните ключ в Claude Console, или вернитесь к вашей подписке, запустив `unset ANTHROPIC_API_KEY`, или в PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.

1172* Если `/status` показывает только ваш вход, запустите `/login` один раз. Если учетное данное было отозвано, свежий вход заменяет его.1220* Если `/status` показывает только ваш вход, запустите `/login` один раз. Если учетные данные были отозваны, свежий вход заменяет его.

1173* Если то же сообщение возвращается для той же учетной записи входа, учетная запись или организация больше не активны. Проверьте учетную запись и организацию, которые сообщает `/status`, и попросите администратора вашей организации восстановить доступ.1221* Если то же сообщение возвращается для той же учетной записи входа, учетная запись или организация больше не активны. Проверьте учетную запись и организацию, которые сообщает `/status`, и попросите администратора вашей организации восстановить доступ.

1174* Если [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на [LLM gateway](/docs/ru/llm-gateway), текст после `401` — это сообщение вашего шлюза, а не Anthropic, и `/login` не изменяет его. Исправьте учетное данное, которое ожидает ваш шлюз.1222* Если [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на [LLM gateway](/docs/ru/llm-gateway), текст после `401` — это сообщение вашего шлюза, а не Anthropic, и `/login` не изменяет его. Исправьте учетные данные, которые ожидает ваш шлюз, вместо этого.

1175 1223

1176<h3 id="login-expired">1224<h3 id="login-expired">

1177 Login expired1225 Login expired

1178</h3>1226</h3>

1179 1227

1180Claude Code попытался обновить ваш сохраненный вход claude.ai или Claude Console, и служба OAuth отклонила сохраненный токен обновления, поэтому Claude Code очистил сохраненные учетные данные. После этого каждый запрос модели останавливается локально с этим сообщением перед тем, как достичь API, потому что только `/login` может создать новые учетные данные.1228Claude Code попытался обновить ваш сохраненный вход claude.ai, и служба OAuth отклонила сохраненный токен обновления, поэтому Claude Code очистил сохраненные учетные данные. После этого каждый запрос модели останавливается локально с этим сообщением перед тем, как достичь API, потому что только `/login` может создать новые учетные данные.

1181 1229

1182До v2.1.206 Claude Code отправлял запрос модели в любом случае с любым оставшимся учетным данным в окружении, и каждая модель затем завершалась ошибкой [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) или 401 вместо запроса на вход.1230До v2.1.206 Claude Code отправлял запрос модели в любом случае с любыми оставшимися учетными данными в окружении, и каждая модель затем завершалась ошибкой [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) или 401 вместо запроса на вход.

1183 1231

1184```text theme={null}1232```text theme={null}

1185Login expired · Please run /login1233Login expired · Please run /login

1191Failed to authenticate: OAuth session expired and could not be refreshed1239Failed to authenticate: OAuth session expired and could not be refreshed

1192```1240```

1193 1241

1194Это не то же состояние, что [OAuth token revoked or expired](#oauth-token-revoked-or-expired). Эти сообщения сообщают об отклонении, которое API вернул. Claude Code сам производит `Login expired` для входа, который уже не удалось обновить, поэтому он не отправляет запрос. Когда обновление не удается, потому что сама учетная запись приостановлена, а не потому, что вход устарел, Claude Code показывает [Your account is on hold](#your-account-is-on-hold) вместо этого.1242Это не то же состояние, что [OAuth token revoked or expired](#oauth-token-revoked-or-expired). Эти сообщения сообщают об отклонении, которое API вернул. Claude Code сам производит `Login expired` для входа, который он уже не смог обновить, поэтому он не отправляет запрос. Когда обновление не удается, потому что сама учетная запись приостановлена, а не потому, что вход устарел, Claude Code показывает [Your account is on hold](#your-account-is-on-hold) вместо этого.

1195 1243

1196Сеансы, аутентифицированные с помощью ключа API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars) или поставщика третьей стороны, не используют сохраненный вход и никогда не видят это сообщение.1244Сеансы, аутентифицированные с помощью ключа API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars) или стороннего поставщика, не используют сохраненный вход и никогда не видят это сообщение.

1197 1245

1198Вы можете проверить это состояние перед тем, как запрос завершится ошибкой: [`/status`](/docs/ru/commands) показывает строку `Login`, читающую `Expired — log in again`, плюс организацию и электронную почту, которые она сохранила для истекшего входа. Строка появляется только, когда сохраненный вход является вашим активным учетным данным и больше не может быть обновлен. Сеансы, аутентифицированные другим способом, не показывают строку, даже если истекший вход остается сохраненным. До v2.1.210 `/status` не давал никакого указания в этом состоянии, что вход когда-либо существовал, потому что очищенное учетное данные оставило ему нечего сообщать.1246Вы можете проверить это состояние перед тем, как запрос завершится ошибкой: [`/status`](/docs/ru/commands) показывает строку `Login`, читающую `Expired — log in again`, плюс организацию и электронную почту, которые она сохранила для истекшего входа. Строка появляется только, когда сохраненный вход является вашим активным учетным данием и больше не может быть обновлен. Сеансы, аутентифицированные другим способом, не показывают строку, даже если истекший вход остается сохраненным. До v2.1.210 `/status` не давал никакого указания в этом состоянии, что вход когда-либо существовал, потому что очищенное учетное данные оставило ему нечего сообщать.

1199 1247

1200**Что делать:**1248**Что делать:**

1201 1249

1202* Запустите `/login` для входа снова. Повторная попытка без входа показывает то же сообщение на каждом запросе.1250* Запустите `/login`, чтобы снова войти. Повторная попытка без входа показывает то же сообщение при каждом запросе.

1203* В неинтерактивном режиме запустите `claude` в том же окружении, завершите `/login`, затем перезапустите вашу команду. Для автоматизации, которая не может войти интерактивно, аутентифицируйтесь с помощью `ANTHROPIC_API_KEY` или [generate a long-lived token with `claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token).1251* В неинтерактивном режиме запустите `claude` в том же окружении, завершите `/login`, затем повторно запустите вашу команду. Для автоматизации, которая не может войти интерактивно, аутентифицируйтесь с помощью `ANTHROPIC_API_KEY` или [generate a long-lived token with `claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token).

1204* Если вход продолжает не удаваться, см. [Login and authentication](/docs/ru/troubleshoot-install#login-and-authentication)1252* Если вход продолжает не удаваться, см. [Login and authentication](/docs/ru/troubleshoot-install#login-and-authentication)

1205 1253

1254<h3 id="could-not-refresh-your-login">

1255 Could not refresh your login because another Claude Code process is refreshing it

1256</h3>

1257

1258Это сообщение не означает, что ваш вход был отклонен. Ваш сохраненный вход claude.ai истек и нуждался в обновлении. Другой процесс Claude Code на той же машине держал общую блокировку обновления, или вышел и оставил ее позади, и обновление не прогрессировало, пока этот сеанс ждал. Claude Code останавливает запрос перед его отправкой:

1259

1260```text theme={null}

1261Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login

1262```

1263

1264В [non-interactive mode](/docs/ru/headless) (`-p`) и [Agent SDK](/docs/ru/agent-sdk/overview) сообщение читается следующим образом, и код структурированной ошибки — `server_error`:

1265

1266```text theme={null}

1267Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again

1268```

1269

1270Сеансы, аутентифицированные с помощью ключа API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars) или стороннего поставщика, не используют сохраненный вход и никогда не видят это сообщение.

1271

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

1273

1274* Попробуйте снова через минуту. Если другой процесс завершит обновление первым, этот сеанс использует обновленный вход.

1275* Если сообщение продолжает возвращаться, закройте другие окна и процессы Claude Code, затем повторите попытку.

1276* Если оно возвращается без другого запущенного процесса Claude Code, запустите `/login`. Повторный вход не ждет блокировку обновления.

1277

1278<h3 id="couldnt-save-your-login">

1279 Couldn't save your login

1280</h3>

1281

1282Вы вошли с claude.ai, но Claude Code не смог сохранить вход в его хранилище учетных данных, поэтому вход не завершился. На macOS это может произойти, когда цепочка входа блокируется, например, при сне или неактивности, после того как Claude Code уже прочитал или сохранил учетные данные в ней во время того же сеанса.

1283

1284```text theme={null}

1285Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.

1286Couldn't save your login. Try logging in again.

1287```

1288

1289Первая форма появляется на macOS, а вторая везде. Временный сбой хранилища учетных данных, такой как тайм-аут или нечитаемое хранилище, производит то же сообщение.

1290

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

1292

1293* На macOS разблокируйте цепочку входа, затем запустите `/login` снова

1294* На других платформах запустите `/login` снова

1295* Если вход все еще не сохраняется, см. [Not logged in or token expired](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired) для команды разблокировки цепочки и других шагов восстановления хранилища учетных данных

1296

1297<h3 id="failed-to-start-oauth-callback-server">

1298 Failed to start OAuth callback server

1299</h3>

1300

1301Когда `/login`, `claude auth login`, или `claude setup-token` подписывает вас через браузер, Claude Code открывает прослушивающий порт на `127.0.0.1`, чтобы ваш браузер мог вернуть результат входа ему. Это сообщение означает, что Claude Code не смог открыть этот порт, и вход останавливается перед появлением окна браузера или URL входа:

1302

1303```text theme={null}

1304Failed to start OAuth callback server: Failed to start server. Is port 0 in use?

1305```

1306

1307Если ваше сообщение заканчивается на `Is port 0 in use?`, попытка прослушивания адреса IPv4 loopback `127.0.0.1` полностью завершилась ошибкой. Потому что сбой происходит перед существованием URL входа, поток `Paste code here if prompted` недоступен как обходной путь.

1308

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

1310

1311* Чтобы войти прямо сейчас без локального слушателя: если вы используете подписку claude.ai, запустите [`claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token) на машине, где вход работает, и установите токен, который он выводит, как `CLAUDE_CODE_OAUTH_TOKEN` на этой машине. В противном случае установите `ANTHROPIC_API_KEY` на ключ из [Claude Console](https://platform.claude.com/settings/keys). [Authentication precedence](/docs/ru/authentication#authentication-precedence) объясняет, как Claude Code выбирает между учетными данными.

1312* Чтобы использовать вход в браузер на этой машине вместо этого, Claude Code должен быть в состоянии прослушивать `127.0.0.1`. Если он работает внутри песочницы, проверьте, что политика песочницы позволяет прослушивать локальные порты, затем запустите `/login` снова. Если он должен быть в состоянии и все еще завершается ошибкой, запустите `/feedback`, чтобы отчет включал детали вашего окружения.

1313

1206<h3 id="claude-login-not-accepted">1314<h3 id="claude-login-not-accepted">

1207 Claude login not accepted1315 Claude login not accepted

1208</h3>1316</h3>

1209 1317

1210Вы попытались запустить [cloud session](/docs/ru/claude-code-on-the-web), и сервер отказался создать его с 401: он не принял вход Claude, который отправила эта машина, обычно потому, что вход истек или был отозван.1318Вы попытались запустить [cloud session](/docs/ru/claude-code-on-the-web), и сервер отказался создавать его с 401: он не принял вход Claude, который отправила эта машина, обычно потому, что вход истек или был отозван.

1211 1319

1212Первая часть строки — это собственная причина сервера, когда он дает одну. В противном случае строка читается:1320Первая часть строки — это собственная причина сервера, когда он дает одну. В противном случае строка читается:

1213 1321

1223 Artifacts need a claude.ai login1331 Artifacts need a claude.ai login

1224</h3>1332</h3>

1225 1333

1226Claude Code отказал [artifact](/docs/ru/artifacts) публикации или чтению, потому что сеанс не имеет входа claude.ai, который он может использовать для артефактов.1334Claude Code отказал в публикации или чтении [artifact](/docs/ru/artifacts), потому что сеанс не имеет входа claude.ai, который он может использовать для артефактов.

1227 1335

1228Каждая форма сообщения начинается с одних и тех же слов, за которыми следует средство, которое зависит от того, как ваш сеанс аутентифицируется. Без конкурирующего учетного данного он читается:1336Каждая форма сообщения начинается с одних и тех же слов, за которыми следует средство, которое зависит от того, как ваш сеанс аутентифицируется. Без конкурирующего учетного данные он читается:

1229 1337

1230```text theme={null}1338```text theme={null}

1231Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.1339Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.

1234**Что делать:**1342**Что делать:**

1235 1343

1236* Запустите `/login` и выберите **Claude account with subscription**. Опция **Anthropic Console account** не предоставляет учетные данные claude.ai.1344* Запустите `/login` и выберите **Claude account with subscription**. Опция **Anthropic Console account** не предоставляет учетные данные claude.ai.

1237* Когда сообщение называет учетное данное, которое имеет приоритет, такое как `ANTHROPIC_API_KEY`, параметр `apiKeyHelper` или ключ Console, сохраненный предыдущим `/login`, удалите его так, как говорит сообщение, затем запустите `/login`1345* Когда сообщение называет учетное данные, которое имеет приоритет, такое как `ANTHROPIC_API_KEY`, параметр `apiKeyHelper` или ключ Console, сохраненный предыдущим `/login`, удалите его так, как говорит сообщение, затем запустите `/login`

1238* Когда сообщение говорит, что этот удаленный сеанс аутентифицируется через машину, которая его запустила, войдите в claude.ai на этой машине, затем переподключите сеанс1346* Когда сообщение говорит, что этот удаленный сеанс аутентифицируется через машину, которая его запустила, войдите в claude.ai на этой машине, затем переподключите сеанс

1239* Когда сообщение говорит, что учетные данные вводятся окружением хоста сеанса, вы не можете изменить их в этом сеансе; запустите сеанс, который подписан на claude.ai1347* Когда сообщение говорит, что учетные данные вводятся окружением хоста сеанса, вы не можете изменить его в этом сеансе; запустите сеанс, который подписан на claude.ai

1240* См. [Availability](/docs/ru/artifacts#availability) для других требований, которые имеют артефакты, такие как план, поставщик модели и политика организации1348* См. [Availability](/docs/ru/artifacts#availability) для других требований, которые имеют артефакты, такие как план, поставщик модели и политика организации

1241 1349

1242<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">1350<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">

1243 Administrator policy requires a Cloud gateway sign-in1351 Administrator policy requires a Cloud gateway sign-in

1244</h3>1352</h3>

1245 1353

1246Параметр [managed settings](/docs/ru/managed-settings) администратора на этой машине установил [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) на `"gateway"` или установил [`forceLoginGatewayUrl`](/docs/ru/settings-reference#forcelogingatewayurl). Если вы не выбираете поставщика облачных услуг через переменную, такую как `CLAUDE_CODE_USE_BEDROCK`, Claude Code затем принимает только вход [Claude apps gateway](/docs/ru/claude-apps-gateway). Вы видите одно из двух сообщений:1354Параметры [managed settings](/docs/ru/managed-settings) администратора на этой машине установили [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) на `"gateway"` или установили [`forceLoginGatewayUrl`](/docs/ru/settings-reference#forcelogingatewayurl). Если вы не выберете облачного поставщика через переменную, такую как `CLAUDE_CODE_USE_BEDROCK`, Claude Code затем принимает только вход [Claude apps gateway](/docs/ru/claude-apps-gateway). Вы видите одно из двух сообщений:

1247 1355

1248```text theme={null}1356```text theme={null}

1249Not signed in to the Cloud gateway — run /login.1357Not signed in to the Cloud gateway — run /login.

1251 1359

1252Запросы модели завершаются ошибкой с этим сообщением, когда сеанс не имеет входа шлюза, например, потому что вы не запустили `/login` с момента достижения политики машины.1360Запросы модели завершаются ошибкой с этим сообщением, когда сеанс не имеет входа шлюза, например, потому что вы не запустили `/login` с момента достижения политики машины.

1253 1361

1254Если у вас также есть учетное данное `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, настроенное, и параметры управления установили `forceLoginMethod`, Claude Code выходит при запуске вместо этого с сообщением, которое начинается:1362Если машина также содержит учетные данные, выданные Anthropic, и параметры управления установили `forceLoginMethod` или `forceLoginOrgUUID`, Claude Code вместо этого выходит при запуске. Это учетное данные может быть переменной `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN`, параметром `apiKeyHelper` или ключом API, сохраненным более ранним входом Claude Console. Сообщение начинается:

1255 1363

1256```text theme={null}1364```text theme={null}

1257Administrator policy requires a Cloud gateway sign-in on this machine; the1365Administrator policy requires a Cloud gateway sign-in on this machine; the

1262**Что делать:**1370**Что делать:**

1263 1371

1264* Запустите `/login` и завершите вход на экране **Cloud gateway**1372* Запустите `/login` и завершите вход на экране **Cloud gateway**

1265* Для сообщения при запуске удалите параметр `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, который вы настроили, затем запустите `claude` и запустите `/login`1373* Для сообщения при запуске удалите параметр `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, который вы настроили. Чтобы удалить сохраненный ключ API Console, запустите `claude auth logout`, который также удаляет сохраненный вход claude.ai. Если вы выберете облачного поставщика с `CLAUDE_CODE_USE_*`, сеанс затем запускается без входа. В противном случае запустите `claude` и запустите `/login`

1266* Если вы считаете, что машина не должна требовать шлюз, попросите администратора, который управляет ею, удалить `forceLoginMethod` и `forceLoginGatewayUrl` из его параметров управления1374* Если вы считаете, что машина не должна требовать шлюз, попросите администратора, который управляет ею, удалить `forceLoginMethod` и `forceLoginGatewayUrl` из его параметров управления

1267 1375

1268На v2.1.265 регрессия также показала первое сообщение в некоторых конфигурациях LLM-gateway и прокси, которые аутентифицируются с помощью ключа API, `apiKeyHelper` или пользовательских заголовков, даже без требования администратора на машине. Обновитесь до v2.1.266 или более поздней версии. Вам не нужно менять вашу конфигурацию.1376На v2.1.265 регрессия также показала первое сообщение в некоторых конфигурациях LLM-gateway и прокси, которые аутентифицируются с помощью ключа API, `apiKeyHelper` или пользовательских заголовков, даже без требования администратора на машине. Обновитесь до v2.1.266 или более поздней версии. Вам не нужно менять вашу конфигурацию.

1269 1377

1270До v2.1.261 на машинах, которые установили `forceLoginMethod` на `"gateway"`, Claude Code использовал оставшийся сохраненный вход вместо того, чтобы завершить запросы модели ошибкой, и сообщал о настроенном учетном данном окружения с `This machine's managed settings require a first-party login` вместо сообщения при запуске. До v2.1.265 машина, чьи параметры управления установили только `forceLoginGatewayUrl`, не требовала входа шлюза, и Claude Code использовал оставшееся учетное данные там.1378До v2.1.261 на машинах, которые установили `forceLoginMethod` на `"gateway"`, Claude Code использовал оставшийся сохраненный вход вместо того, чтобы завершить запросы модели ошибкой, и сообщал о настроенном учетном данные окружения с `This machine's managed settings require a first-party login` вместо сообщения при запуске. До v2.1.265 машина, чьи параметры управления установили только `forceLoginGatewayUrl`, не требовала входа шлюза, и Claude Code использовал оставшееся учетное данные там.

1271 1379

1272<h3 id="your-account-is-on-hold">1380<h3 id="your-account-is-on-hold">

1273 Your account is on hold1381 Your account is on hold

1274</h3>1382</h3>

1275 1383

1276Учетная запись Claude позади вашего входа была приостановлена. Claude Code показывает первое сообщение, когда он пытается обновить ваш сохраненный вход и узнает о задержке, и второе, когда завершенный вами вход в браузер сообщает об этом:1384Учетная запись Claude позади вашего входа была приостановлена. Claude Code показывает первое сообщение, когда он пытается обновить ваш сохраненный вход и узнает о задержке, и второе, когда завершенный вход в браузер сообщает об этом:

1277 1385

1278```text theme={null}1386```text theme={null}

1279Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted1387Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted

1284 1392

1285**Что делать:**1393**Что делать:**

1286 1394

1287* Откройте ссылку в сообщении, чтобы просмотреть детали задержки или обжаловать ее1395* Откройте ссылку в сообщении, чтобы просмотреть детали задержки или подать апелляцию

1288* Если у вас есть другая учетная запись Claude или ключ API, на который не влияет задержка, вы можете продолжить работу, пока задержка разрешается: запустите `/login` с этой учетной записью, или установите ключ с помощью `ANTHROPIC_API_KEY`1396* Если у вас есть другая учетная запись Claude или ключ API, на который не влияет задержка, вы можете продолжить работу, пока задержка разрешается: запустите `/login` с этой учетной записью, или установите ключ с `ANTHROPIC_API_KEY`

1289 1397

1290<h3 id="anthropic-profile-login-expired">1398<h3 id="anthropic-profile-login-expired">

1291 Anthropic profile login expired1399 Anthropic profile login expired

1292</h3>1400</h3>

1293 1401

1294Claude Code аутентифицируется через профиль учетных данных Anthropic, чей сохраненный вход истек, и профиль не содержит учетные данные обновления, которые Claude Code может использовать для его обновления. Claude Code останавливает каждый запрос локально без повторных попыток, потому что повторная попытка прочитает то же истекшее учетное данные.1402Claude Code аутентифицируется через профиль учетных данных Anthropic, чьи сохраненные учетные данные входа истекли, и профиль не содержит учетные данные обновления, которые Claude Code может использовать для его обновления. Claude Code останавливает каждый запрос локально без повторных попыток, потому что повторная попытка прочитает те же истекшие учетные данные.

1295 1403

1296```text theme={null}1404```text theme={null}

1297Anthropic profile login expired · Re-authenticate your Anthropic profile1405Anthropic profile login expired · Re-authenticate your Anthropic profile

1298Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile1406Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile

1299```1407```

1300 1408

1301Это появляется только, когда активное учетное данные поступает из профиля учетных данных Anthropic, который вы выбираете с переменной окружения `ANTHROPIC_PROFILE`, который Claude Code обнаруживает как активный профиль в вашем каталоге конфигурации Anthropic, или который Claude Code написал, когда вы [signed in without an API key](/docs/ru/authentication#sign-in-without-an-api-key). Сеансы, которые аутентифицируются с помощью опции claude.ai `/login`, ключа API, токена-носителя, такого как `ANTHROPIC_AUTH_TOKEN`, или поставщика третьей стороны, никогда не видят это сообщение.1409Это появляется только, когда активное учетное данные поступает из профиля учетных данных Anthropic, который вы выбираете с переменной окружения `ANTHROPIC_PROFILE`, который Claude Code обнаруживает как активный профиль в вашем каталоге конфигурации Anthropic, или который Claude Code написал, когда вы [signed in without an API key](/docs/ru/authentication#sign-in-without-an-api-key). Сеансы, которые аутентифицируются с помощью ключа API, токена-носителя, такого как `ANTHROPIC_AUTH_TOKEN`, или стороннего поставщика, никогда не видят это сообщение.

1302 1410

1303На машине, которая [offers the keyless sign-in](/docs/ru/authentication#sign-in-without-an-api-key), запустите `/login`, выберите учетную запись Anthropic Console и войдите снова, чтобы обновить профиль, который написал вход без ключа Console или CLI Claude Platform `ant auth login`. Claude Code заменяет истекшее учетные данные в этом профиле. Для профиля федерации или профиля, созданного другим инструментом, `/login` не обновляет учетные данные. Какую форму вы видите, зависит от того, выбрали ли вы профиль или Claude Code его обнаружил:1411На машине, которая [offers the keyless sign-in](/docs/ru/authentication#sign-in-without-an-api-key), запустите `/login`, выберите учетную запись Anthropic Console и снова войдите, чтобы обновить профиль, который написали вход без ключа Console или CLI платформы Claude `ant auth login`. Claude Code заменяет истекшие учетные данные в этом профиле. Для профиля федерации или созданного другим инструментом `/login` не обновляет учетные данные. Какую форму вы видите, зависит от того, выбрали ли вы профиль или Claude Code его обнаружил:

1304 1412

1305* Когда вы явно установили `ANTHROPIC_PROFILE`, сообщение заканчивается с `Re-authenticate your Anthropic profile`.1413* Когда вы явно установили `ANTHROPIC_PROFILE`, сообщение заканчивается `Re-authenticate your Anthropic profile`.

1306* Когда Claude Code обнаружил профиль из вашего каталога конфигурации, сообщение предлагает `/login`, потому что Claude Code дает рабочему `/login` приоритет над обнаруженным профилем и затем аутентифицируется с вашей учетной записью claude.ai или Console вместо этого. До v2.1.234 Claude Code показал форму `Re-authenticate your Anthropic profile` в этом случае тоже.1414* Когда Claude Code обнаружил профиль из вашего каталога конфигурации, сообщение предлагает `/login`, потому что Claude Code дает рабочему `/login` приоритет над обнаруженным профилем и затем аутентифицируется с помощью вашей учетной записи claude.ai или Console вместо этого. До v2.1.234 Claude Code показал форму `Re-authenticate your Anthropic profile` в этом случае тоже.

1307 1415

1308**Что делать:**1416**Что делать:**

1309 1417

1310* Войдите в профиль снова, затем повторите попытку: на машине, которая [offers the keyless sign-in](/docs/ru/authentication#sign-in-without-an-api-key), запустите `/login` и выберите учетную запись Anthropic Console для профиля, который написал вход без ключа Console или CLI Claude Platform `ant auth login`; для других профилей используйте инструмент, который их создал1418* Снова войдите в профиль, затем повторите попытку: на машине, которая [offers the keyless sign-in](/docs/ru/authentication#sign-in-without-an-api-key), запустите `/login` и выберите учетную запись Anthropic Console для профиля, который написали вход без ключа Console или CLI платформы Claude `ant auth login`; для других профилей используйте инструмент, который их создал

1311* Если администратор подготовил учетные данные профиля, попросите его выдать новое1419* Если администратор подготовил учетные данные профиля, попросите его выдать новые

1312* Запустите `/status`, чтобы подтвердить активный источник учетных данных и имя профиля1420* Запустите `/status`, чтобы подтвердить активный источник учетных данных и имя профиля

1313* Чтобы перестать использовать профиль, отмените установку `ANTHROPIC_PROFILE`, если вы его установили, затем аутентифицируйтесь другим способом, например `/login` или `ANTHROPIC_API_KEY`1421* Чтобы перестать использовать профиль, отмените установку `ANTHROPIC_PROFILE`, если вы его установили, затем аутентифицируйтесь другим способом, такой как `/login` или `ANTHROPIC_API_KEY`

1314 1422

1315<h3 id="oauth-scope-requirement">1423<h3 id="oauth-scope-requirement">

1316 OAuth scope requirement1424 OAuth scope requirement

1317</h3>1425</h3>

1318 1426

1319Сохраненный токен предшествует области разрешений, которая требуется более новой функции. Вы видите это чаще всего из `/usage` и индикатора использования строки состояния:1427Сохраненный токен предшествует области разрешения, которая требуется более новой функции:

1320 1428

1321```text theme={null}1429```text theme={null}

1322OAuth token does not meet scope requirement: user:profile1430OAuth token does not meet scope requirement: user:profile

1330 claude.ai rejected the session token1438 claude.ai rejected the session token

1331</h3>1439</h3>

1332 1440

1333Запрос [claude.ai connector](/docs/ru/mcp#use-mcp-servers-from-claude-ai) завершился ошибкой, потому что claude.ai отклонил токен из вашего входа Claude Code, обычно вход, который истек и не мог быть обновлен. Отклоненный токен — это ваш вход, а не собственная авторизация соединителя в claude.ai, поэтому повторная авторизация соединителя не разрешает это. В `/mcp` соединитель показывается как `connected · session token rejected` и его представление деталей читает:1441Запрос [claude.ai connector](/docs/ru/mcp#use-mcp-servers-from-claude-ai) завершился ошибкой, потому что claude.ai отклонил токен из вашего входа Claude Code. Отклоненный токен — это ваш вход, а не собственная авторизация соединителя в claude.ai, поэтому повторная авторизация соединителя не разрешает это. В `/mcp` соединитель показывает как `session token rejected` и его представление деталей читается:

1334 1442

1335```text theme={null}1443```text theme={null}

1336claude.ai rejected the session token. Run /login, then reconnect.1444claude.ai rejected the session token. Run /login, then reconnect.

1338 1446

1339**Что делать:**1447**Что делать:**

1340 1448

1341* Запустите `/login` для входа снова1449* Запустите `/login`, чтобы снова войти

1342* Переподключите соединитель из `/mcp`, или запустите `/mcp reconnect <server>`. Переподключение перед повторным входом оставляет соединитель в том же состоянии. Опция **Reconnect** панели `/mcp` сообщает `your claude.ai session token was rejected`; введенная форма `/mcp reconnect <server>` сообщает об успешном переподключении, даже если токен все еще отклонен.1450* Переподключите соединитель из `/mcp`, или запустите `/mcp reconnect <server>`. Переподключение перед повторным входом оставляет соединитель в том же состоянии. Опция **Reconnect** панели `/mcp` сообщает `your claude.ai session token was rejected`; введенная форма `/mcp reconnect <server>` сообщает об успешном переподключении, даже если токен все еще отклонен.

1343 1451

1344До v2.1.222 Claude Code отметил соединитель как нуждающийся в аутентификации вместо этого, что указывал вас на поток авторизации соединителя, даже если завершение его не разрешало состояние.1452До v2.1.222 Claude Code отметил соединитель как нуждающийся в аутентификации вместо этого, что указывал вас на поток авторизации соединителя, даже если его завершение не разрешало состояние.

1345 1453

1346<h3 id="mcp-server-needs-you-to-sign-in-again">1454<h3 id="mcp-server-needs-you-to-sign-in-again">

1347 MCP server needs you to sign in again1455 MCP server needs you to sign in again

1348</h3>1456</h3>

1349 1457

1350Удаленный [MCP server](/docs/ru/mcp) отклонил учетные данные при вызове инструмента в середине сеанса, обычно потому, что вход или токен истек или потому, что токен не имеет разрешения, которое требует инструмент. Вызов инструмента завершается ошибкой, и `/mcp` отмечает сервер как [needing authentication](/docs/ru/mcp#authenticate-with-remote-mcp-servers).1458Удаленный [MCP server](/docs/ru/mcp) отклонил учетные данные при вызове инструмента в середине сеанса, обычно потому, что вход или токен истек, или потому что токену не хватает разрешения, которое требует инструмент. Вызов инструмента завершается ошибкой, и `/mcp` отмечает сервер как [needing authentication](/docs/ru/mcp#authenticate-with-remote-mcp-servers).

1351 1459

1352Для сервера, на который вы входите из Claude Code, включая соединитель claude.ai, вход истек или был отозван:1460Для сервера, на который вы входите из Claude Code, включая соединитель claude.ai, вход истек или был отозван:

1353 1461

1355MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)1463MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)

1356```1464```

1357 1465

1358Запустите `/mcp`, выберите сервер и войдите снова из его меню.1466Запустите `/mcp`, выберите сервер и снова войдите из его меню.

1359 1467

1360Для сервера, настроенного с помощью скрипта [`headersHelper`](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication), Claude Code уже повторно запустил помощника и повторил вызов один раз перед отображением этого:1468Для сервера, настроенного со скриптом [`headersHelper`](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication), Claude Code уже повторно запустил помощника и повторил вызов один раз перед отображением этого:

1361 1469

1362```text theme={null}1470```text theme={null}

1363MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)1471MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)

1364```1472```

1365 1473

1366Проверьте, что помощник возвращает учетные данные, которые сервер принимает, затем переподключитесь из `/mcp`, который запускает помощника снова.1474Проверьте, что помощник возвращает учетные данные, которые сервер принимает, затем переподключитесь из `/mcp`, который снова запускает помощника.

1367 1475

1368Для сервера со статическим заголовком `Authorization` в его конфигурации:1476Для сервера со статическим заголовком `Authorization` в его конфигурации:

1369 1477

1371MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)1479MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)

1372```1480```

1373 1481

1374Обновите значение заголовка там, где сервер настроен, затем переподключитесь из `/mcp`.1482Обновите значение заголовка, где сервер настроен, затем переподключитесь из `/mcp`.

1375 1483

1376До v2.1.273 все три случая показали `MCP server "<name>" requires re-authorization (token expired)`.1484До v2.1.273 истекший вход, `headersHelper` и случаи заголовка `Authorization` все показали `MCP server "<name>" requires re-authorization (token expired)`.

1377 1485

1378Сервер также может отказать вызову инструмента с HTTP 403 `insufficient_scope`, чтобы попросить вас авторизовать область, иногда ту, которую ваш токен уже указывает. Сообщение называет эту область:1486Сервер также может отказать вызову инструмента с HTTP 403 `insufficient_scope`, чтобы попросить вас авторизовать область, иногда ту, которую ваш токен уже указывает. Сообщение называет эту область:

1379 1487

1397Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"1505Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"

1398```1506```

1399 1507

1400`expected` — это издатель из метаданных OAuth сервера, и `received` — это значение `iss`, которое перенаправление несло. Вход, чье перенаправление не содержит параметр `iss`, проходит проверку, если только метаданные сервера не установили `authorization_response_iss_parameter_supported`, в этом случае Claude Code завершает вход ошибкой.1508`expected` — это издатель из метаданных OAuth сервера, и `received` — это значение `iss`, которое перенаправление несло. Вход, чье перенаправление не несет параметр `iss`, проходит проверку, если только метаданные сервера не устанавливают `authorization_response_iss_parameter_supported`, в этом случае Claude Code завершает вход ошибкой.

1401 1509

1402**Что делать:**1510**Что делать:**

1403 1511

1404* Попробуйте вход снова из `/mcp`1512* Попробуйте вход снова из `/mcp`

1405* Если ошибка повторяется, сообщите об этом оператору сервера. Исправление находится на стороне сервера: сервер авторизации должен вернуть того же издателя в параметре `iss`, который он объявляет в своих метаданных1513* Если ошибка повторяется, сообщите об этом оператору сервера. Исправление находится на стороне сервера: сервер авторизации должен вернуть того же издателя в параметре `iss`, который он объявляет в своих метаданных

1406* Для подключения, пока сервер исправляется, запустите Claude Code с [`MCP_SDK_GENERATION=v1`](/docs/ru/env-vars), чей [runtime](/docs/ru/mcp#mcp-client-runtimes) не запускает эту проверку. Это удаляет защиту от атак смешивания, поэтому предпочитайте исправление на стороне сервера1514* Чтобы подключиться, пока сервер исправляется, запустите Claude Code с [`MCP_SDK_GENERATION=v1`](/docs/ru/env-vars), чьи [runtime](/docs/ru/mcp#mcp-client-runtimes) не запускают эту проверку. Это удаляет защиту от атак смешивания, поэтому предпочитайте исправление на стороне сервера

1407 1515

1408До v2.1.232 Claude Code использовал только v2 runtime в постепенном развертывании или когда вы установили `MCP_SDK_GENERATION=v2`.1516До v2.1.232 Claude Code использовал только v2 runtime в постепенном развертывании или когда вы установили `MCP_SDK_GENERATION=v2`.

1409 1517

1411 AWS credentials expired or invalid1519 AWS credentials expired or invalid

1412</h3>1520</h3>

1413 1521

1414Ваш токен сеанса AWS истек или был отклонен. Это сообщение появляется на 401 из [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) или [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), что является тем, как эти поставщики сообщают об истекшем токене безопасности.1522Ваш токен сеанса AWS истек или был отклонен. Это сообщение появляется при 401 из [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) или [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), что является тем, как эти поставщики сообщают об истекшем токене безопасности.

1415 1523

1416Подсказка действия в середине варьируется в зависимости от вашей установки. Стабильная часть — это ведущая `AWS credentials expired or invalid`:1524Подсказка действия в середине варьируется в зависимости от вашей установки. Стабильная часть — это ведущий `AWS credentials expired or invalid`:

1417 1525

1418```text theme={null}1526```text theme={null}

1419AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...1527AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

1420```1528```

1421 1529

1422До v2.1.273 это сообщение появлялось только, когда `awsAuthRefresh` был настроен.1530До v2.1.273 это сообщение появлялось только, когда был настроен `awsAuthRefresh`.

1423 1531

1424**Что делать:**1532**Что делать:**

1425 1533

1426* Если подсказка говорит, что учетные данные управляются этим окружением, приложение, которое запустило Claude Code, владеет учетным данным и другие шаги здесь не применяются: повторите попытку, или свяжитесь с администратором1534* Если подсказка говорит, что учетные данные управляются этим окружением, приложение, которое запустило Claude Code, владеет учетным данием, и другие шаги здесь не применяются: повторите попытку, или свяжитесь с администратором

1427* Если [`awsAuthRefresh`](/docs/ru/amazon-bedrock#advanced-credential-configuration) установлен, запустите команду, названную в сообщении, такую как `aws sso login --profile myprofile`, в другом терминале и завершите вход в браузер, затем повторите попытку. В противном случае обновите учетные данные AWS, которые вы используете сами: ваш вход SSO, ключи доступа, ключ API или токен прокси1535* Если [`awsAuthRefresh`](/docs/ru/amazon-bedrock#advanced-credential-configuration) установлен, запустите команду, названную в сообщении, такую как `aws sso login --profile myprofile`, в другом терминале и завершите вход в браузер, затем повторите попытку. В противном случае обновите учетные данные AWS, которые вы используете сами: ваш вход SSO, ключи доступа, ключ API или токен прокси

1428* С `awsAuthRefresh`, установленным в интерактивном сеансе, вы можете вместо этого запустить `/login`, выбрать **3rd-party platform**, затем выбрать **Claude Platform on AWS · refresh credentials** под **Using 3rd-party platforms**, чтобы запустить ту же команду без перезапуска Claude Code. См. [Configure AWS credentials](/docs/ru/claude-platform-on-aws#1-configure-aws-credentials)1536* С `awsAuthRefresh`, установленным в интерактивном сеансе, вы можете вместо этого запустить `/login`, выбрать **3rd-party platform**, затем выбрать **Claude Platform on AWS · refresh credentials** в разделе **Using 3rd-party platforms**, чтобы запустить ту же команду без перезапуска Claude Code. См. [Configure AWS credentials](/docs/ru/claude-platform-on-aws#1-configure-aws-credentials)

1429* Если ошибка повторяется после успешного выполнения команды обновления, подтвердите, что идентификатор действителен вне Claude Code с помощью `aws sts get-caller-identity` в той же оболочке и профиле1537* Если ошибка повторяется после успешного выполнения команды обновления, подтвердите, что личность действительна вне Claude Code с помощью `aws sts get-caller-identity` в той же оболочке и профиле

1430 1538

1431<h3 id="aws-authentication-failed">1539<h3 id="aws-authentication-failed">

1432 AWS authentication failed1540 AWS authentication failed

1434 1542

1435Ваш поставщик AWS вернул 403, или [Amazon Bedrock](/docs/ru/amazon-bedrock) вернул 401.1543Ваш поставщик AWS вернул 403, или [Amazon Bedrock](/docs/ru/amazon-bedrock) вернул 401.

1436 1544

1437Amazon Bedrock сообщает об истекшем токене безопасности как 403, но 403 также является тем, как он сообщает об отказе в авторизации, такой как `AccessDeniedException` из отсутствующего разрешения IAM. Claude Code не может различить эти две причины.1545Amazon Bedrock сообщает об истекшем токене безопасности как 403, но 403 — это также то, как он сообщает об отказе в авторизации, такой как `AccessDeniedException` из отсутствующего разрешения IAM. Claude Code не может различить эти две причины.

1438 1546

1439401 из Amazon Bedrock также приземляется здесь, а не под [AWS credentials expired or invalid](#aws-credentials-expired-or-invalid), потому что Amazon Bedrock не сообщает об истекшем токене как 401. 401 из этой конечной точки обычно поступает из чего-то еще в пути запроса, такого как корпоративный прокси.1547401 из Amazon Bedrock также приземляется здесь, а не в [AWS credentials expired or invalid](#aws-credentials-expired-or-invalid), потому что Amazon Bedrock не сообщает об истекшем токене как 401. 401 из этой конечной точки обычно поступает из чего-то еще в пути запроса, такого как корпоративный прокси.

1440 1548

1441Обновление учетных данных исправляет истекший токен и не может исправить другие причины, поэтому сообщение предлагает оба:1549Обновление учетных данных исправляет истекший токен и не может исправить другие причины, поэтому сообщение предлагает оба:

1442 1550

1444AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...1552AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

1445```1553```

1446 1554

1447Подсказка действия в середине варьируется в зависимости от вашей установки. Стабильная часть — это ведущая `AWS authentication failed`.1555Подсказка действия в середине варьируется в зависимости от вашей установки. Стабильная часть — это ведущий `AWS authentication failed`.

1448 1556

1449Когда 403 — это ответ Amazon Bedrock, что у вас нет доступа к модели с указанным ID модели, подсказка вместо этого говорит вам включить модель для вашей учетной записи и региона в консоли Amazon Bedrock.1557Когда 403 — это ответ Amazon Bedrock, что у вас нет доступа к модели с указанным ID модели, подсказка вместо этого говорит вам включить модель для вашей учетной записи и региона в консоли Amazon Bedrock.

1450 1558

1451До v2.1.273 это сообщение появлялось только, когда `awsAuthRefresh` был настроен.1559До v2.1.273 это сообщение появлялось только, когда был настроен `awsAuthRefresh`.

1452 1560

1453**Что делать:**1561**Что делать:**

1454 1562

1455* Если подсказка говорит, что учетные данные управляются этим окружением, приложение, которое запустило Claude Code, владеет учетным данным и другие шаги здесь не применяются: повторите попытку, или свяжитесь с администратором1563* Если подсказка говорит, что учетные данные управляются этим окружением, приложение, которое запустило Claude Code, владеет учетным данием, и другие шаги здесь не применяются: повторите попытку, или свяжитесь с администратором

1456* Обновите ваши учетные данные AWS на случай, если истекшее учетное данные является причиной: запустите команду [`awsAuthRefresh`](/docs/ru/amazon-bedrock#advanced-credential-configuration), названную в сообщении, когда она установлена, или обновите ваш вход SSO, ключи доступа, ключ API или токен прокси сами1564* Обновите ваши учетные данные AWS на случай, если истекшие учетные данные являются причиной: запустите команду [`awsAuthRefresh`](/docs/ru/amazon-bedrock#advanced-credential-configuration), названную в сообщении, когда она установлена, или обновите ваш вход SSO, ключи доступа, ключ API или токен прокси сами

1457* Если ваши учетные данные текущие, подтвердите разрешения IAM в [IAM configuration](/docs/ru/amazon-bedrock#iam-configuration), прикреплены к идентификатору, который вы используете, и что выбранная модель включена для вашей учетной записи и региона1565* Если ваши учетные данные текущие, подтвердите разрешения IAM в [IAM configuration](/docs/ru/amazon-bedrock#iam-configuration), прикреплены к личности, которую вы используете, и что выбранная модель включена для вашей учетной записи и региона

1458* Запустите `aws sts get-caller-identity`, чтобы подтвердить, какой идентификатор используют ваши запросы; устаревший `AWS_PROFILE` или профиль по умолчанию — это частая причина несоответствия разрешений1566* Запустите `aws sts get-caller-identity`, чтобы подтвердить, какую личность используют ваши запросы

1459 1567

1460<h3 id="google-cloud-credentials-expired-or-invalid">1568<h3 id="google-cloud-credentials-expired-or-invalid">

1461 Google Cloud credentials expired or invalid1569 Google Cloud credentials expired or invalid

1463 1571

1464Ваши учетные данные Google Cloud для [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) истекли или были отклонены: запрос вернул 401, что является тем, как Agent Platform сообщает об истечении учетных данных.1572Ваши учетные данные Google Cloud для [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) истекли или были отклонены: запрос вернул 401, что является тем, как Agent Platform сообщает об истечении учетных данных.

1465 1573

1466Подсказка действия в середине варьируется в зависимости от вашей установки. Стабильная часть — это ведущая `Google Cloud credentials expired or invalid`:1574Подсказка действия в середине варьируется в зависимости от вашей установки. Стабильная часть — это ведущий `Google Cloud credentials expired or invalid`:

1467 1575

1468```text theme={null}1576```text theme={null}

1469Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...1577Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...

1471 1579

1472**Что делать:**1580**Что делать:**

1473 1581

1474* Если подсказка говорит, что учетные данные управляются этим окружением, приложение, которое запустило Claude Code, владеет учетным данным и другие шаги здесь не применяются: повторите попытку, или свяжитесь с администратором1582* Если подсказка говорит, что учетные данные управляются этим окружением, приложение, которое запустило Claude Code, владеет учетным данием, и другие шаги здесь не применяются: повторите попытку, или свяжитесь с администратором

1475* Если вы аутентифицируетесь с учетными данными приложения по умолчанию, запустите команду [`gcpAuthRefresh`](/docs/ru/google-vertex-ai#advanced-credential-configuration), названную в сообщении, или `gcloud auth application-default login`, и завершите вход, затем повторите попытку1583* Если вы аутентифицируетесь с учетными данными по умолчанию приложения, запустите команду [`gcpAuthRefresh`](/docs/ru/google-vertex-ai#advanced-credential-configuration), названную в сообщении, или `gcloud auth application-default login`, и завершите вход, затем повторите попытку

1476* Если вы маршрутизируете через [LLM gateway](/docs/ru/llm-gateway) с установленным `CLAUDE_CODE_SKIP_VERTEX_AUTH`, обновите токен шлюза в `ANTHROPIC_AUTH_TOKEN` или `ANTHROPIC_CUSTOM_HEADERS`, затем повторите попытку1584* Если вы маршрутизируете через [LLM gateway](/docs/ru/llm-gateway) с установленным `CLAUDE_CODE_SKIP_VERTEX_AUTH`, обновите токен шлюза в `ANTHROPIC_AUTH_TOKEN` или `ANTHROPIC_CUSTOM_HEADERS`, затем повторите попытку

1477* Если вы аутентифицируетесь с файлом ключа учетной записи обслуживания, подтвердите, что `GOOGLE_APPLICATION_CREDENTIALS` указывает на действительный ключ. См. [Configure GCP credentials](/docs/ru/google-vertex-ai#3-configure-gcp-credentials)1585* Если вы аутентифицируетесь с файлом ключа учетной записи обслуживания, подтвердите, что `GOOGLE_APPLICATION_CREDENTIALS` указывает на действительный ключ. См. [Configure GCP credentials](/docs/ru/google-vertex-ai#3-configure-gcp-credentials)

1478* Если ошибка повторяется после обновления, подтвердите, что идентификатор работает вне Claude Code с помощью `gcloud auth application-default print-access-token` в той же оболочке1586* Если ошибка повторяется после обновления, подтвердите, что личность работает вне Claude Code с помощью `gcloud auth application-default print-access-token` в той же оболочке

1479 1587

1480До v2.1.273 401 из Agent Platform показал общее сообщение `Please run /login` или `Failed to authenticate` вместо этого, которое не может обновить учетные данные Google Cloud.1588До v2.1.273 401 из Agent Platform показал общее сообщение `Please run /login` или `Failed to authenticate` вместо этого, которое не может обновить учетные данные Google Cloud.

1481 1589

1483 Google Cloud authentication failed1591 Google Cloud authentication failed

1484</h3>1592</h3>

1485 1593

1486[Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) вернул 403, который он использует для отказов в авторизации, а не для истекших учетных данных. Обычно идентификатор, с которым вы аутентифицируетесь, отсутствует разрешение IAM, или модель не включена для вашего проекта.1594[Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) вернул 403, который он использует для отказов в авторизации, а не истекших учетных данных. Обычно личность, с которой вы аутентифицируетесь, не имеет разрешения IAM, или модель не включена для вашего проекта.

1487 1595

1488Подсказка действия в середине варьируется в зависимости от вашей установки. Стабильная часть — это ведущая `Google Cloud authentication failed`:1596Подсказка действия в середине варьируется в зависимости от вашей установки. Стабильная часть — это ведущий `Google Cloud authentication failed`:

1489 1597

1490```text theme={null}1598```text theme={null}

1491Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...1599Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...

1493 1601

1494**Что делать:**1602**Что делать:**

1495 1603

1496* Если подсказка говорит, что учетные данные управляются этим окружением, приложение, которое запустило Claude Code, владеет учетным данным и другие шаги здесь не применяются: повторите попытку, или свяжитесь с администратором1604* Если подсказка говорит, что учетные данные управляются этим окружением, приложение, которое запустило Claude Code, владеет учетным данием, и другие шаги здесь не применяются: повторите попытку, или свяжитесь с администратором

1497* Подтвердите роли в [IAM configuration](/docs/ru/google-vertex-ai#iam-configuration), предоставлены идентификатору, с которым вы аутентифицируетесь1605* Подтвердите роли в [IAM configuration](/docs/ru/google-vertex-ai#iam-configuration), предоставлены личности, с которой вы аутентифицируетесь

1498* Подтвердите, что модель включена для вашего проекта. См. [Request model access](/docs/ru/google-vertex-ai#2-request-model-access)1606* Подтвердите, что модель включена для вашего проекта. См. [Request model access](/docs/ru/google-vertex-ai#2-request-model-access)

1499 1607

1500До v2.1.273 403 из Agent Platform показал общее сообщение `Please run /login` или `Failed to authenticate` вместо этого, которое не может обновить учетные данные Google Cloud.1608До v2.1.273 403 из Agent Platform показал общее сообщение `Please run /login` или `Failed to authenticate` вместо этого, которое не может обновить учетные данные Google Cloud.

1503 Microsoft Foundry authentication failed1611 Microsoft Foundry authentication failed

1504</h3>1612</h3>

1505 1613

1506[Microsoft Foundry](/docs/ru/microsoft-foundry) вернул 401 или 403: учетные данные Azure в запросе были отклонены, или идентификатор позади них не имеет доступа к ресурсу Foundry. `/login` не может создавать учетные данные Azure. Подсказка действия в середине варьируется в зависимости от вашей установки. Стабильная часть — это ведущая `Microsoft Foundry authentication failed`:1614[Microsoft Foundry](/docs/ru/microsoft-foundry) вернул 401 или 403: учетные данные Azure в запросе были отклонены, или личность позади них не имеет доступа к ресурсу Foundry. `/login` не может выпускать учетные данные Azure. Подсказка действия в середине варьируется в зависимости от вашей установки. Стабильная часть — это ведущий `Microsoft Foundry authentication failed`:

1507 1615

1508```text theme={null}1616```text theme={null}

1509Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...1617Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...

1511 1619

1512**Что делать:**1620**Что делать:**

1513 1621

1514* Если подсказка говорит, что учетные данные управляются этим окружением, приложение, которое запустило Claude Code, владеет учетным данным и другие шаги здесь не применяются: повторите попытку, или свяжитесь с администратором1622* Если подсказка говорит, что учетные данные управляются этим окружением, приложение, которое запустило Claude Code, владеет учетным данием, и другие шаги здесь не применяются: повторите попытку, или свяжитесь с администратором

1515* Обновите учетные данные, которые вы настроили в [Configure Azure credentials](/docs/ru/microsoft-foundry#2-configure-azure-credentials): поверните `ANTHROPIC_FOUNDRY_API_KEY`, создайте свежий `ANTHROPIC_FOUNDRY_AUTH_TOKEN`, или запустите `az login`, чтобы цепь учетных данных Microsoft Entra по умолчанию могла войти снова1623* Обновите учетные данные, которые вы настроили в [Configure Azure credentials](/docs/ru/microsoft-foundry#2-configure-azure-credentials): поверните `ANTHROPIC_FOUNDRY_API_KEY`, выпустите свежий `ANTHROPIC_FOUNDRY_AUTH_TOKEN`, или запустите `az login`, чтобы цепочка учетных данных Microsoft Entra по умолчанию могла снова войти

1516* Если учетные данные текущие, подтвердите, что идентификатор имеет доступ к ресурсу Foundry. См. [Azure RBAC configuration](/docs/ru/microsoft-foundry#azure-rbac-configuration)1624* Если учетные данные текущие, подтвердите, что личность имеет доступ к ресурсу Foundry. См. [Azure RBAC configuration](/docs/ru/microsoft-foundry#azure-rbac-configuration)

1517 1625

1518До v2.1.273 401 или 403 из Microsoft Foundry показал общее сообщение `Please run /login` или `Failed to authenticate` вместо этого, которое не может обновить учетные данные Azure.1626До v2.1.273 401 или 403 из Microsoft Foundry показал общее сообщение `Please run /login` или `Failed to authenticate` вместо этого, которое не может обновить учетные данные Azure.

1519 1627

1521 Could not load AWS or Google Cloud credentials1629 Could not load AWS or Google Cloud credentials

1522</h3>1630</h3>

1523 1631

1524Claude Code не мог получить используемые учетные данные из цепи поставщика учетных данных AWS или из ваших учетных данных приложения Google по умолчанию на машине, на которой он работает, поэтому ни один запрос не достиг вашего облачного поставщика. Claude Code очищает свои кэшированные учетные данные и повторяет попытку дважды перед отображением этого сообщения. Деталь после `·` называет конкретную причину, такую как истекший сеанс SSO, отсутствующие учетные данные приложения по умолчанию, сообщаемые как `Could not load the default credentials`, или отозванный вход, сообщаемый как `invalid_grant`:1632Claude Code не смог получить пригодные учетные данные из цепочки поставщика учетных данных AWS или из ваших учетных данных приложения Google по умолчанию на машине, на которой он работает, поэтому ни один запрос не достиг вашего облачного поставщика. Claude Code очищает свои кэшированные учетные данные и повторяет попытку дважды перед отображением этого сообщения. Деталь после `·` называет конкретную причину, такую как истекший сеанс SSO, отсутствующие учетные данные приложения по умолчанию, сообщаемые как `Could not load the default credentials`, или отозванный вход, сообщаемый как `invalid_grant`:

1525 1633

1526```text theme={null}1634```text theme={null}

1527API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.1635API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.

1533**Что делать:**1641**Что делать:**

1534 1642

1535* Запустите команду входа вашего поставщика, такую как `aws sso login --profile myprofile` или `gcloud auth application-default login`, затем повторите попытку. [Bedrock, Agent Platform, or Foundry credentials not loading](/docs/ru/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) показывает, как подтвердить учетные данные вне Claude Code1643* Запустите команду входа вашего поставщика, такую как `aws sso login --profile myprofile` или `gcloud auth application-default login`, затем повторите попытку. [Bedrock, Agent Platform, or Foundry credentials not loading](/docs/ru/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) показывает, как подтвердить учетные данные вне Claude Code

1536* Если деталь читает `AWS default-chain credential resolve timed out`, цепь зависла, а не завершилась ошибкой, поэтому следуйте [AWS default-chain credential resolve timed out](#aws-default-chain-credential-resolve-timed-out) вместо этого1644* Если деталь читается `AWS default-chain credential resolve timed out`, цепь зависла, а не завершилась ошибкой, поэтому следуйте [AWS default-chain credential resolve timed out](#aws-default-chain-credential-resolve-timed-out) вместо этого

1537 1645

1538<h3 id="aws-default-chain-credential-resolve-timed-out">1646<h3 id="aws-default-chain-credential-resolve-timed-out">

1539 AWS default-chain credential resolve timed out1647 AWS default-chain credential resolve timed out

1540</h3>1648</h3>

1541 1649

1542Цепь поставщика учетных данных AWS по умолчанию не произвела учетные данные в течение 60 секунд, поэтому Claude Code остановил разрешение и завершил запрос ошибкой. Это время ожидания — одна из причин [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials). Сбой — это локальное разрешение учетных данных: запрос никогда не достиг [Amazon Bedrock](/docs/ru/amazon-bedrock), [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) или [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Claude Code очищает свой [credential cache](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout) и повторяет попытку перед тем, как эта ошибка проявляется, поэтому к тому времени, когда вы ее видите, цепь зависла при повторных попытках.1650Цепочка поставщика учетных данных AWS по умолчанию не выдала учетные данные в течение 60 секунд, поэтому Claude Code остановил разрешение и завершил запрос ошибкой. Этот тайм-аут — одна из причин [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials). Сбой — это локальное разрешение учетных данных: запрос никогда не достиг [Amazon Bedrock](/docs/ru/amazon-bedrock), [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) или [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Claude Code очищает свой [credential cache](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout) и повторяет попытку перед тем, как эта ошибка проявляется, поэтому к тому времени, когда вы ее видите, цепь зависла при повторных попытках.

1543 1651

1544```text theme={null}1652```text theme={null}

1545API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.1653API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.

1546```1654```

1547 1655

1548Частые причины — команда `credential_process` в вашем профиле AWS, которая ждет входа, который она не может получить, и контейнер или VM, чей сервис метаданных экземпляра (IMDS) никогда не отвечает на зонд цепи.1656Распространенные причины — это команда `credential_process` в вашем профиле AWS, которая ждет входа, который она не может получить, и контейнер или VM, чей сервис метаданных экземпляра (IMDS) никогда не отвечает на зонд цепи.

1549 1657

1550До v2.1.267 сообщение читалось `API Error: AWS default-chain credential resolve timed out`.1658До v2.1.267 сообщение читалось `API Error: AWS default-chain credential resolve timed out`.

1551До v2.1.207 зависшая цепь оставляла запрос ожидающим неопределенно долго вместо того, чтобы завершиться ошибкой.1659До v2.1.207 зависшая цепь оставляла запрос ожидающим неопределенно долго вместо завершения ошибкой.

1552 1660

1553**Что делать:**1661**Что делать:**

1554 1662

1555* Запустите `aws sts get-caller-identity` в той же оболочке с тем же `AWS_PROFILE`. Если он также зависает, исправьте профиль; команда `credential_process`, которая запрашивает интерактивно, — это частая причина.1663* Запустите `aws sts get-caller-identity` в той же оболочке с тем же `AWS_PROFILE`. Если он также зависает, исправьте профиль; команда `credential_process`, которая интерактивно подсказывает, — это распространенная причина.

1556* Завершите шаг входа перед запуском Claude Code, например `aws sso login --profile myprofile`, поэтому цепь разрешается из локального кэша SSO вместо ожидания потока браузера1664* Завершите шаг входа перед запуском Claude Code, например `aws sso login --profile myprofile`

1557* Если ваша цепь запускает интерактивный вход, который законно нуждается в более чем 60 секундах, такой как SSO с MFA через оболочку, такую как `aws-vault`, поднимите лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars)1665* Если ваша цепь запускает интерактивный вход, который законно требует более 60 секунд, такой как SSO с MFA через обертку, такую как `aws-vault`, поднимите лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars)

1558 1666

1559<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">1667<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">

1560 Bedrock setup verification timed out waiting for AWS1668 Bedrock setup verification timed out waiting for AWS

1561</h3>1669</h3>

1562 1670

1563Вызов AWS во время [Bedrock setup wizard](/docs/ru/amazon-bedrock#sign-in-with-bedrock) проверки учетных данных, такой как поиск учетных данных или проверка идентификатора, не завершился в течение лимита 60 секунд. Мастер перестает ждать и завершает шаг проверки ошибкой:1671Вызов AWS во время [Bedrock setup wizard](/docs/ru/amazon-bedrock#sign-in-with-bedrock) шага проверки учетных данных, такой как поиск учетных данных или проверка личности, не завершился в течение 60-секундного лимита. Мастер перестает ждать и завершает шаг проверки ошибкой:

1564 1672

1565```text theme={null}1673```text theme={null}

1566Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.1674Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.

1568 1676

1569Число отражает ваш лимит: 60 секунд по умолчанию, или значение, которое вы установили в [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars).1677Число отражает ваш лимит: 60 секунд по умолчанию, или значение, которое вы установили в [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars).

1570 1678

1571Частые причины — сеть или прокси, которые зависают запросы к AWS, включая обновление токена SSO, и помощник учетных данных, все еще ожидающий входа, который вы не можете видеть. Поднимите лимит только, когда помощник законно нуждается в большем времени.1679Распространенные причины — это сеть или прокси, которые зависают запросы к AWS, включая обновление токена SSO, и помощник учетных данных, который все еще ждет входа, который вы не можете видеть. Поднимите лимит только, когда помощник законно требует больше времени.

1572 1680

1573Один зависший запрос к AWS также может завершиться ошибкой на его собственном времени ожидания для каждого запроса, которое показывает более короткое сообщение на том же шаге:1681Один зависший запрос к AWS также может завершиться ошибкой на его собственном тайм-ауте для каждого запроса, который показывает более короткое сообщение на том же шаге:

1574 1682

1575```text theme={null}1683```text theme={null}

1576A request to AWS timed out. Check your network and proxy settings, then try again.1684A request to AWS timed out. Check your network and proxy settings, then try again.

1577```1685```

1578 1686

1579Когда те же времена ожидания происходят на шаге закрепления модели, мастер отмечает модель как `unreachable` вместо отображения любого сообщения.1687Когда те же тайм-ауты происходят на шаге закрепления модели, мастер отмечает модель как `unreachable` вместо отображения любого сообщения.

1580 1688

1581**Что делать:**1689**Что делать:**

1582 1690

1583* Запустите `aws sts get-caller-identity` в той же оболочке. Если он также зависает, зависание находится вне Claude Code, в вашей сети, вашем прокси или помощнике учетных данных в вашем профиле AWS; исправьте это сначала.1691* Запустите `aws sts get-caller-identity` в той же оболочке. Если он также зависает, зависание находится вне Claude Code, в вашей сети, вашем прокси или помощнике учетных данных в вашем профиле AWS; исправьте это сначала.

1584* Завершите любой интерактивный вход перед открытием мастера, например `aws sso login --profile myprofile`1692* Завершите любой интерактивный вход перед открытием мастера, например `aws sso login --profile myprofile`

1585* Если помощник учетных данных в вашем профиле AWS законно нуждается в более чем 60 секундах для запроса, поднимите лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars)1693* Если помощник учетных данных в вашем профиле AWS законно требует более 60 секунд для подсказки, поднимите лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars)

1586 1694

1587<h3 id="cloud-gateway-session-expired">1695<h3 id="cloud-gateway-session-expired">

1588 Cloud gateway session expired1696 Cloud gateway session expired

1589</h3>1697</h3>

1590 1698

1591Вы вошли через [Claude apps gateway](/docs/ru/claude-apps-gateway), и сеанс шлюза, сохраненный на этой машине, истек и не мог быть обновлен, или шлюз больше его не принимает, например, после [JWT secret is replaced](/docs/ru/claude-apps-gateway-deploy#jwt-secret-rotation) шлюза. Если вы видите эту строку при запуске `claude` интерактивно, сеанс открылся без входа в шлюз:1699Вы вошли через [Claude apps gateway](/docs/ru/claude-apps-gateway), и сеанс шлюза, сохраненный на этой машине, истек и не смог быть обновлен, или шлюз больше его не принимает, например, после [JWT secret is replaced](/docs/ru/claude-apps-gateway-deploy#jwt-secret-rotation) шлюза. Если вы видите эту строку при запуске `claude` интерактивно, сеанс открылся без входа в шлюз:

1592 1700

1593```text theme={null}1701```text theme={null}

1594Cloud gateway session expired — run /login to reconnect.1702Cloud gateway session expired — run /login to reconnect.

1596 1704

1597Та же строка может появиться в середине сеанса, когда учетные данные шлюза истекают и Claude Code не может их обновить.1705Та же строка может появиться в середине сеанса, когда учетные данные шлюза истекают и Claude Code не может их обновить.

1598 1706

1599В [non-interactive](/docs/ru/headless) запуске, фоновом или другом автоматическом сеансе, или подкоманде `claude`, отличной от `claude auth`, Claude Code выходит с этим сообщением вместо этого, когда шлюз больше не принимает сеанс:1707В [non-interactive](/docs/ru/headless) запуске, фоновом или другом автоматическом сеансе, или подкоманде `claude`, отличной от `claude auth`, Claude Code вместо этого выходит с этим сообщением, когда шлюз больше не принимает сеанс:

1600 1708

1601```text theme={null}1709```text theme={null}

1602Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.1710Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.

1605**Что делать:**1713**Что делать:**

1606 1714

1607* Запустите `/login` в сеансе и завершите вход в браузер1715* Запустите `/login` в сеансе и завершите вход в браузер

1608* Для неинтерактивного запуска запустите `claude` в том же окружении, запустите `/login`, затем перезапустите вашу команду1716* Для неинтерактивного запуска запустите `claude` в том же окружении, запустите `/login`, затем повторно запустите вашу команду

1609 1717

1610<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">1718<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">

1611 Sign-in timed out while waiting for you to continue1719 Sign-in timed out while waiting for you to continue

1612</h3>1720</h3>

1613 1721

1614Во время [Claude apps gateway](/docs/ru/claude-apps-gateway) входа шлюз назвал учетную запись, которая вошла, и Claude Code попросил вас подтвердить ее перед сохранением учетных данных. Вы оставили подтверждение открытым после истечения входа, и шлюз не выдал токен обновления, который мог бы его обновить, поэтому Claude Code ничего не сохранил, когда вы продолжили:1722Во время входа [Claude apps gateway](/docs/ru/claude-apps-gateway) шлюз назвал учетную запись, которая вошла, и Claude Code попросил вас подтвердить ее перед сохранением учетных данных. Вы оставили подтверждение открытым после истечения срока действия входа, и шлюз не выдал токен обновления, который мог бы его обновить, поэтому Claude Code ничего не сохранил, когда вы продолжили:

1615 1723

1616```text theme={null}1724```text theme={null}

1617Sign-in timed out while waiting for you to continue. Try again.1725Sign-in timed out while waiting for you to continue. Try again.

1619 1727

1620**Что делать:**1728**Что делать:**

1621 1729

1622* Запустите `/login` снова и подтвердите учетную запись перед истечением входа1730* Запустите `/login` снова и подтвердите учетную запись перед истечением срока действия входа

1623 1731

1624<h3 id="gateway-refused-the-request">1732<h3 id="gateway-refused-the-request">

1625 Gateway refused the request1733 Gateway refused the request

1626</h3>1734</h3>

1627 1735

1628Вы подписаны через [Claude apps gateway](/docs/ru/claude-apps-gateway), и запрос вернул 403: шлюз, или вышестоящий позади него, отказал в нем. Повторный вход не изменяет отказ, поэтому сообщение указывает на администратора вашего шлюза:1736Вы подписаны через [Claude apps gateway](/docs/ru/claude-apps-gateway), и запрос вернул 403: шлюз, или восходящий позади него, отказал в нем. Повторный вход не изменяет отказ, поэтому сообщение указывает на администратора вашего шлюза:

1629 1737

1630```text theme={null}1738```text theme={null}

1631Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...1739Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...

1633 1741

1634**Что делать:**1742**Что делать:**

1635 1743

1636* Попросите администратора вашего шлюза посмотреть запрос. Хвост `API Error:` содержит отказ, который вернул шлюз1744* Попросите администратора вашего шлюза посмотреть запрос. Хвост `API Error:` несет отказ, который вернул шлюз

1637* Для администраторов: [access control rule](/docs/ru/claude-apps-gateway-config#http-tuning) на шлюзе возвращает 403, который [audit log](/docs/ru/claude-apps-gateway-deploy#logs) записывает с его причиной, и отказ авторизации вышестоящего проходит через [Upstream error messages](/docs/ru/claude-apps-gateway-config#upstream-error-messages)1745* Для администраторов: [access control rule](/docs/ru/claude-apps-gateway-config#http-tuning) на шлюзе возвращает 403, который [audit log](/docs/ru/claude-apps-gateway-deploy#logs) записывает с его причиной, и отказ авторизации восходящего проходит через [Upstream error messages](/docs/ru/claude-apps-gateway-config#upstream-error-messages)

1638 1746

1639До v2.1.273 403 на сеансе шлюза показал общее сообщение `Please run /login` или `Failed to authenticate` вместо этого, и повторный вход не очистил отказ.1747До v2.1.273 403 на сеансе шлюза показал общее сообщение `Please run /login` или `Failed to authenticate` вместо этого, и повторный вход не очистил отказ.

1640 1748

1657No internet route — check your connection or VPN (EHOSTUNREACH)1765No internet route — check your connection or VPN (EHOSTUNREACH)

1658Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host1766Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host

1659Connection dropped (ECONNRESET)1767Connection dropped (ECONNRESET)

1660fetch failed

1661Request timed out. Check your internet connection and proxy settings1768Request timed out. Check your internet connection and proxy settings

1662```1769```

1663 1770

1677 1784

1678Если `curl` успешен, но Claude Code всё ещё не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:1785Если `curl` успешен, но Claude Code всё ещё не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:

1679 1786

1787* Проверьте, установлена ли переменная `ANTHROPIC_BASE_URL`, запустив `echo $ANTHROPIC_BASE_URL`, или `echo $env:ANTHROPIC_BASE_URL` в PowerShell, и посмотрите её в блоке `env` ваших [settings files](/docs/ru/settings). Когда она установлена, Claude Code отправляет запросы модели на этот адрес вместо `api.anthropic.com`, поэтому оставшееся значение, указывающее на локальный прокси или шлюз, который больше не работает, производит `Connection refused`, даже если `curl` достигает API. Удалите его из профиля вашей оболочки или параметров и запустите Claude Code из нового терминала.

1680* На Linux и WSL проверьте `/etc/resolv.conf` на наличие недостижимого сервера имён. WSL в частности может унаследовать неработающий распознаватель от хоста.1788* На Linux и WSL проверьте `/etc/resolv.conf` на наличие недостижимого сервера имён. WSL в частности может унаследовать неработающий распознаватель от хоста.

1681* На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте `ifconfig` на наличие устаревших интерфейсов `utun` и удалите сетевое расширение VPN в System Settings.1789* На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте `ifconfig` на наличие устаревших интерфейсов `utun` и удалите сетевое расширение VPN в System Settings.

1682* Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.1790* Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.

1702 1810

1703* Если сообщение указывает переменную прокси, проверьте, что её значение указывает на правильный прокси, и попросите вашу команду сети разрешить HTTPS-соединения через него к хосту в сообщении. См. [Network configuration](/docs/ru/network-config).1811* Если сообщение указывает переменную прокси, проверьте, что её значение указывает на правильный прокси, и попросите вашу команду сети разрешить HTTPS-соединения через него к хосту в сообщении. См. [Network configuration](/docs/ru/network-config).

1704* Пройдите проверки в [Unable to connect to API](#unable-to-connect-to-api). Тест `curl` и рекомендации по брандмауэру там применяются и к этой проверке.1812* Пройдите проверки в [Unable to connect to API](#unable-to-connect-to-api). Тест `curl` и рекомендации по брандмауэру там применяются и к этой проверке.

1705* Если ваша организация входит через [cloud gateway](/docs/ru/claude-apps-gateway) и эта ошибка появляется при первом запуске, обновитесь до Claude Code v2.1.247 или позже.

1706* Если ваша сеть открыта и сбой сохраняется, Claude Code может быть [недоступен в вашей стране](https://www.anthropic.com/supported-countries)1813* Если ваша сеть открыта и сбой сохраняется, Claude Code может быть [недоступен в вашей стране](https://www.anthropic.com/supported-countries)

1707 1814

1708<h3 id="socket-is-closed">1815<h3 id="socket-is-closed">

1897* Запустите новый сеанс с помощью `claude --remote-control`, чтобы создать новый сеанс Remote Control2004* Запустите новый сеанс с помощью `claude --remote-control`, чтобы создать новый сеанс Remote Control

1898* Для других сообщений запуска Remote Control см. [Troubleshoot Remote Control](/docs/ru/remote-control#troubleshooting)2005* Для других сообщений запуска Remote Control см. [Troubleshoot Remote Control](/docs/ru/remote-control#troubleshooting)

1899 2006

1900Если сервер вместо этого сообщает, что предыдущий сеанс исчез, вы не видите это сообщение. Claude Code запускает новый сеанс на его месте или показывает [`Previous session is unavailable — run /remote-control to start a new one`](/docs/ru/remote-control#previous-session-is-unavailable), в зависимости от [the conversation's reconnection record](/docs/ru/remote-control#resume-outcomes). Из версии v2.1.227 по v2.1.231 Claude Code показывал сообщение, которое начинается с `Remote Control could not resume the previous session under the current login` вместо этого, и [более ранние версии вели себя иначе](/docs/ru/remote-control#reconnect-history).2007Если сервер вместо этого сообщает, что предыдущий сеанс исчез, вы не видите это сообщение. Claude Code запускает новый сеанс на его месте или показывает [`Previous session is unavailable — run /remote-control to start a new one`](/docs/ru/remote-control#previous-session-is-unavailable).

1901 2008

1902<h3 id="sessions-ended-while-this-machine-was-offline">2009<h3 id="sessions-ended-while-this-machine-was-offline">

1903 Sessions ended while this machine was offline2010 Sessions ended while this machine was offline

1931* Запустите `/feedback` для отправки стенограммы с описанием того, что произошло. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде2038* Запустите `/feedback` для отправки стенограммы с описанием того, что произошло. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде

1932* Если другие запросы также не удаются, проверьте ваше сетевое соединение и см. [Unable to connect to API](#unable-to-connect-to-api)2039* Если другие запросы также не удаются, проверьте ваше сетевое соединение и см. [Unable to connect to API](#unable-to-connect-to-api)

1933 2040

2041<h3 id="couldnt-send-feedback">

2042 Couldn't send feedback

2043</h3>

2044

2045Вы отправили отчёт из диалогового окна [`/feedback`, `/bug`, или `/share`](/docs/ru/commands#all-commands) и загрузка в Anthropic не удалась. Диалоговое окно сохраняет ваш текст, чтобы вы могли повторить попытку.

2046

2047```text theme={null}

2048Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.

2049```

2050

2051Текст после префикса указывает, что не удалось:

2052

2053* **`: not signed in. Run /login, then retry.`**: диалоговое окно загружает только когда Claude Code нашёл учётные данные Anthropic при его открытии, и ни один из них не был пригоден к использованию к моменту отправки. Например, вы вышли на этой машине в то же время, или ваш вход больше не может быть обновлён.

2054* **Скобка**: `(server returned <status>)` — это код ответа сервиса; `(request timed out)` и `(couldn't reach the service)` — это сетевые сбои. Когда Claude Code не может назвать причину, скобка отсутствует.

2055

2056В [feedback drafts queue](/docs/ru/tools-reference#sendfeedback-tool-behavior) тот же сбой заканчивается с `The draft is still queued. Try again later.` вместо этого, и черновик остаётся в очереди для другой попытки.

2057

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

2059

2060* Для формулировки не подписано, запустите `/login` и отправьте снова

2061* В противном случае отправьте снова; если другие запросы также не удаются, проверьте ваше сетевое соединение и см. [Unable to connect to API](#unable-to-connect-to-api)

2062* Если это продолжает не удаваться, подайте отчёт на [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues), как говорит сообщение

2063

2064До версии v2.1.281 каждая отправка не удавалась с этим сообщением один раз, когда Remote Control **Stop** или срочное кросс-сеансовое сообщение прибыло, пока диалоговое окно было открыто. На этих версиях закройте диалоговое окно, откройте его снова и отправьте снова.

2065

1934<h2 id="request-errors">2066<h2 id="request-errors">

1935 Ошибки запроса2067 Ошибки запроса

1936</h2>2068</h2>

2008* Запустите `/context` для просмотра разбивки того, что потребляет окно: системный prompt, инструменты, файлы памяти и сообщения2140* Запустите `/context` для просмотра разбивки того, что потребляет окно: системный prompt, инструменты, файлы памяти и сообщения

2009* Отключите MCP серверы, которые вы не используете, с помощью `/mcp disable <имя>` для удаления их определений инструментов из контекста2141* Отключите MCP серверы, которые вы не используете, с помощью `/mcp disable <имя>` для удаления их определений инструментов из контекста

2010* Обрежьте большие файлы памяти `CLAUDE.md` или переместите инструкции в [правила с областью действия пути](/docs/ru/memory#path-specific-rules), которые загружаются только при необходимости2142* Обрежьте большие файлы памяти `CLAUDE.md` или переместите инструкции в [правила с областью действия пути](/docs/ru/memory#path-specific-rules), которые загружаются только при необходимости

2011* Подагенты наследуют каждое определение инструмента MCP от родительского сеанса, что может заполнить их контекстное окно до первого хода. Отключите MCP серверы, которые вы не используете, перед созданием подагентов.

2012* Автоматическое компактирование включено по умолчанию и обычно предотвращает эту ошибку. Если вы отключили его в `/config` или с помощью [`DISABLE_AUTO_COMPACT`](/docs/ru/env-vars), включите его обратно. Если вы держите его отключённым, запустите `/compact` самостоятельно перед заполнением окна.2143* Автоматическое компактирование включено по умолчанию и обычно предотвращает эту ошибку. Если вы отключили его в `/config` или с помощью [`DISABLE_AUTO_COMPACT`](/docs/ru/env-vars), включите его обратно. Если вы держите его отключённым, запустите `/compact` самостоятельно перед заполнением окна.

2013 2144

2014Смотрите [Explore the context window](/docs/ru/context-window) для интерактивного просмотра того, как заполняется контекст.2145Смотрите [Explore the context window](/docs/ru/context-window) для интерактивного просмотра того, как заполняется контекст.

2038 2169

2039До версии 2.1.216 `/context` показывал использование выше 100% без строки предупреждения, объясняющей, что это означает или как восстановиться.2170До версии 2.1.216 `/context` показывал использование выше 100% без строки предупреждения, объясняющей, что это означает или как восстановиться.

2040 2171

2041<h3 id="error-during-compaction-conversation-too-long">

2042 Error during compaction: Conversation too long

2043</h3>

~~2044~~

2045`/compact` сам завершился с ошибкой, потому что недостаточно свободного контекста для хранения создаваемого им резюме.

~~2046~~

2047```text theme={null}

2048Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

2049```

~~2050~~

2051Это может произойти, когда окно уже заполнено в момент срабатывания автоматического компактирования, или когда вы запускаете `/compact` после просмотра [`Prompt is too long`](#prompt-is-too-long). В интерактивном сеансе эта ошибка — это строка `Context limit reached`.

~~2052~~

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

~~2054~~

2055* Нажмите Esc дважды, чтобы открыть список сообщений и вернуться на несколько ходов назад. Это удаляет самые последние сообщения из контекста. Затем запустите `/compact` снова.

2056* Если возврат на несколько ходов не освобождает достаточно места, запустите `/clear` для начала свежего сеанса. Ваш предыдущий разговор сохраняется и может быть переоткрыт с помощью `/resume`.

~~2057~~

2058Это сообщение и другие сбои `/compact` отображаются в стиле ошибки. До версии 2.1.216 они отображались в том же тусклом стиле, что и успешный вывод команды, поэтому вы могли прочитать неудачное компактирование как успех.

~~2059~~

2060<h3 id="request-too-large">2172<h3 id="request-too-large">

2061 Request too large2173 Request too large

2062</h3>2174</h3>

2070Когда запрос прошёл прямо в Claude API и сам API отклонил его, Claude Code измеряет разговор и формулирует сообщение в зависимости от того, может ли работать восстановление. Через прокси, шлюз или поставщика облачных услуг вы получаете общее сообщение. Измеренные формы:2182Когда запрос прошёл прямо в Claude API и сам API отклонил его, Claude Code измеряет разговор и формулирует сообщение в зависимости от того, может ли работать восстановление. Через прокси, шлюз или поставщика облачных услуг вы получаете общее сообщение. Измеренные формы:

2071 2183

2072* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: изображения или документы превысили лимит запроса. Claude Code повторяет попытку с их удалением.2184* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: изображения или документы превысили лимит запроса. Claude Code повторяет попытку с их удалением.

2073* `Request too large for the API's 32MB request limit`: сами сообщения превышают лимит, поэтому сообщение говорит `compacting cannot make it fit` и Claude Code не повторяет попытку. В [неинтерактивном режиме](/docs/ru/headless) сообщение говорит вам уменьшить входные данные или начать новый сеанс.2185* `Request too large for the API's 32MB request limit`: сами сообщения превышают лимит, поэтому сообщение говорит `compacting cannot make it fit` и Claude Code не повторяет попытку. В [неинтерактивном режиме](/docs/ru/headless) сообщение говорит вам уменьшить входные данные или начать новый сеанс вместо этого.

2074 2186

2075До версии 2.1.212 разговоры с достаточным накопленным количеством изображений завершались с ошибкой на каждом ходу с `Request too large (max 32MB). Double press esc to go back and try with a smaller file.` До версии 2.1.229 Claude Code показывал совет о вложениях для каждого отклонения, даже когда компактирование не могло помочь.2187До версии 2.1.212 разговоры с достаточным накопленным количеством изображений завершались с ошибкой на каждом ходу с `Request too large (max 32MB). Double press esc to go back and try with a smaller file.` До версии 2.1.229 Claude Code показывал совет о вложениях для каждого отклонения, даже когда компактирование не могло помочь.

2076 2188

2140* Для больших PDF попросите Claude прочитать диапазон страниц с помощью инструмента Read вместо прикрепления всего файла, или извлеките текст с помощью инструмента, такого как `pdftotext`, и ссылайтесь на выходной файл по пути2252* Для больших PDF попросите Claude прочитать диапазон страниц с помощью инструмента Read вместо прикрепления всего файла, или извлеките текст с помощью инструмента, такого как `pdftotext`, и ссылайтесь на выходной файл по пути

2141* Для защищённых или недействительных PDF удалите пароль или повторно экспортируйте файл из исходного приложения, затем попробуйте снова2253* Для защищённых или недействительных PDF удалите пароль или повторно экспортируйте файл из исходного приложения, затем попробуйте снова

2142 2254

2255Когда Claude читает диапазон страниц из PDF с помощью инструмента Read, чтение может завершиться с другим сообщением:

2256

2257```text theme={null}

2258pdftoppm is not installed. Install poppler-utils (e.g. `brew install poppler` or `apt-get install poppler-utils`) to enable PDF page rendering.

2259```

2260

2261Чтение диапазона страниц отображает страницы с помощью `pdftoppm`. Установите poppler-utils с помощью команды, которую даёт сообщение, или на других платформах сборку poppler, которая помещает `pdftoppm` на ваш `PATH`. Смотрите [Read tool behavior](/docs/ru/tools-reference#read-tool-behavior) для того, какие PDF читаются по диапазону страниц.

2262

2143<h3 id="extra-inputs-are-not-permitted">2263<h3 id="extra-inputs-are-not-permitted">

2144 Extra inputs are not permitted2264 Extra inputs are not permitted

2145</h3>2265</h3>

2148 2268

2149```text theme={null}2269```text theme={null}

2150API Error: 400 ... Extra inputs are not permitted ... context_management2270API Error: 400 ... Extra inputs are not permitted ... context_management

2151API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header

2152```2271```

2153 2272

2154Claude Code отправляет поля, доступные только в бета-версии, такие как `context_management` и `effort`, вместе с заголовком `anthropic-beta`, который их включает. Когда шлюз пересылает тело, но удаляет заголовок, API видит поля, которые не распознаёт.2273Claude Code отправляет поля, доступные только в бета-версии, такие как `context_management` и `effort`, вместе с заголовком `anthropic-beta`, который их включает. Когда шлюз пересылает тело, но удаляет заголовок, API видит поля, которые не распознаёт.

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

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

2187 2306

2307<h3 id="tool-use-name-over-200-characters">

2308 tool\_use.name over 200 characters

2309</h3>

2310

2311Вызов инструмента в истории разговора содержит имя, превышающее 200 символов, которые API принимает в запросе:

2312

2313```text theme={null}

2314API Error: 400 ... tool_use.name: String should have at most 200 characters

2315```

2316

2317Claude Code обрезает такое имя до 200 символов, когда ответ прибывает и когда загружает сохранённый разговор, поэтому вызов завершается с обычной ошибкой инструмента `No such tool available` и разговор продолжается без этой ошибки API.

2318

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

2320

2321* Запустите `claude update`, затем возобновите разговор. Обновленная версия восстанавливает переполненное имя при загрузке расшифровки, поэтому разговор, который был застрял, снова работает.

2322

2323До версии 2.1.281 переполненное имя оставалось в истории и API отклонял каждый запрос, который повторно отправлял разговор, включая `/compact` и `--resume`, поэтому эта ошибка повторялась и разговор был застрял.

2324

2188<h3 id="theres-an-issue-with-the-selected-model">2325<h3 id="theres-an-issue-with-the-selected-model">

2189 There's an issue with the selected model2326 There's an issue with the selected model

2190</h3>2327</h3>

2202* **Agent SDK**: текст ошибки опускает подсказку, потому что модель установлена программно. Установите [`model` на `Options`](/docs/ru/agent-sdk/typescript#options) в TypeScript или [`ClaudeAgentOptions(model=...)`](/docs/ru/agent-sdk/python#claudeagentoptions) в Python, и обработайте структурированную ошибку `model_not_found` для вывода вашего собственного повтора или выбора модели.2339* **Agent SDK**: текст ошибки опускает подсказку, потому что модель установлена программно. Установите [`model` на `Options`](/docs/ru/agent-sdk/typescript#options) в TypeScript или [`ClaudeAgentOptions(model=...)`](/docs/ru/agent-sdk/python#claudeagentoptions) в Python, и обработайте структурированную ошибку `model_not_found` для вывода вашего собственного повтора или выбора модели.

2203* Используйте псевдоним, такой как `sonnet` или `opus`, вместо полного версионного ID. Псевдонимы разрешаются в поддерживаемое значение по умолчанию, поэтому они не устаревают. Смотрите [Model configuration](/docs/ru/model-config).2340* Используйте псевдоним, такой как `sonnet` или `opus`, вместо полного версионного ID. Псевдонимы разрешаются в поддерживаемое значение по умолчанию, поэтому они не устаревают. Смотрите [Model configuration](/docs/ru/model-config).

2204* Если неправильная модель продолжает возвращаться в CLI, где-то установлен устаревший ID. Проверьте места, где вы можете установить модель в [порядке приоритета](/docs/ru/model-config#setting-your-model), и удалите устаревшее значение.2341* Если неправильная модель продолжает возвращаться в CLI, где-то установлен устаревший ID. Проверьте места, где вы можете установить модель в [порядке приоритета](/docs/ru/model-config#setting-your-model), и удалите устаревшее значение.

2205* Недавно запущенная модель может быть доступна на Anthropic API перед Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Если вы закрепили новый ID модели на одном из этих поставщиков и видите эту ошибку, проверьте каталог моделей вашего поставщика на доступность в вашем регионе и держите предыдущую версию закреплённой до появления новой там.

2206* Claude Code сообщает об истёкшем входе claude.ai как [Login expired](#login-expired), а не как эта ошибка. До версии 2.1.206 истёкший вход, который больше не мог быть обновлён, завершался с ошибкой на каждой модели с этой ошибкой; запустите `/login`, если вы видите это в более старой версии.2342* Claude Code сообщает об истёкшем входе claude.ai как [Login expired](#login-expired), а не как эта ошибка. До версии 2.1.206 истёкший вход, который больше не мог быть обновлён, завершался с ошибкой на каждой модели с этой ошибкой; запустите `/login`, если вы видите это в более старой версии.

2207* Для развёртываний Google Cloud's Agent Platform смотрите [Google Cloud's Agent Platform troubleshooting](/docs/ru/google-vertex-ai#troubleshooting).2343* Для развёртываний Google Cloud's Agent Platform смотрите [Google Cloud's Agent Platform troubleshooting](/docs/ru/google-vertex-ai#troubleshooting).

2208 2344

2216Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?2352Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

2217```2353```

2218 2354

2219Конечная подсказка называет ближайший соответствующий псевдоним или ID модели. Когда ничего не достаточно близко, она читается `Run /model to see available models.` вместо этого.2355Конечная подсказка называет ближайший соответствующий псевдоним или ID модели. Когда ничего не достаточно близко, она читается `Run /model to see available models.` вместо этого. В сеансе, который [Desktop app](/docs/ru/desktop) запускает для вас, подсказка без совпадения читается `Switch to a different model.`

2220 2356

2221Claude Code производит эту ошибку локально в момент запроса переключения, перед любым запросом API. Она применяется, когда модель установлена через метод [Agent SDK](/docs/ru/agent-sdk/typescript) `setModel()`, приложением, таким как [Desktop app](/docs/ru/desktop), которое запускает Claude Code CLI для вас, или когда вы выбираете модель с устройства, подключённого через [Remote Control](/docs/ru/remote-control). До версии 2.1.260 проверка не охватывала выборы Remote Control, поэтому Claude Code применял выбор и следующий запрос завершался с [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).2357Claude Code производит эту ошибку локально в момент запроса переключения, перед любым запросом API. Она применяется, когда модель установлена через метод [Agent SDK](/docs/ru/agent-sdk/typescript) `setModel()`, приложением, таким как [Desktop app](/docs/ru/desktop), которое запускает Claude Code CLI для вас, или когда вы выбираете модель с устройства, подключённого через [Remote Control](/docs/ru/remote-control). До версии 2.1.260 проверка не охватывала выборы Remote Control, поэтому Claude Code применял выбор и следующий запрос завершался с [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).

2222 2358

2245* Если вы ввели полный ID, проверьте его в каталоге моделей вашего поставщика. Недавно запущенная модель может быть доступна на Anthropic API перед тем, как ваш поставщик или регион её предложит.2381* Если вы ввели полный ID, проверьте его в каталоге моделей вашего поставщика. Недавно запущенная модель может быть доступна на Anthropic API перед тем, как ваш поставщик или регион её предложит.

2246* До версии 2.1.265 `/model` также отклонял написание псевдонима `opusplan[1m]` с этой ошибкой. В этих версиях обновите Claude Code или установите модель в [settings](/docs/ru/model-config#setting-your-model) или с помощью `--model` вместо этого.2382* До версии 2.1.265 `/model` также отклонял написание псевдонима `opusplan[1m]` с этой ошибкой. В этих версиях обновите Claude Code или установите модель в [settings](/docs/ru/model-config#setting-your-model) или с помощью `--model` вместо этого.

2247 2383

2384<h3 id="api-error-model-not-changed">

2385 API error when checking the picked model

2386</h3>

2387

2388Вы выбрали модель с `/model <имя>`, или приложение, подключённое к сеансу, запросило переключение. API отклонил минимальный запрос, который Claude Code отправляет для проверки модели, по причине, которая не имеет собственной записи, такой как ограничение скорости или ошибка сервера. Сеанс сохраняет свою текущую модель, и сообщение заканчивается, говоря об этом:

2389

2390```text theme={null}

2391API error: 429 <объяснение сервера> · model not changed

2392```

2393

2394Середина сообщения — это статус HTTP и собственное объяснение сервера.

2395

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

2397

2398* Действуйте в соответствии с объяснением сервера; для ограничения скорости или статуса 5xx подождите и выберите модель снова

2399* Отказы с собственной формулировкой охватываются окружающими записями, такими как [Model not found](#model-not-found) и [Model is restricted by your organization's settings](#model-is-restricted-by-your-organizations-settings)

2400

2248<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">2401<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">

2249 Claude Opus is not available with the Claude Pro plan2402 Claude Opus is not available with the Claude Pro plan

2250</h3>2403</h3>

2255Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.2408Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.

2256```2409```

2257 2410

2411В сеансе, который Claude Desktop app запускает, сообщение говорит `sign out and sign in again` вместо названия команд.

2412

2258**Что делать:**2413**Что делать:**

2259 2414

2260* Запустите `/model` и выберите модель, которую включает ваш план2415* Запустите `/model` и выберите модель, которую включает ваш план

2287 Model is restricted by your organization's settings2442 Model is restricted by your organization's settings

2288</h3>2443</h3>

2289 2444

2290Администратор вашей организации отключил эту модель в консоли администратора claude.ai, или она исключена списком разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) в управляемых настройках. Когда ограниченная модель была установлена с `--model`, `ANTHROPIC_MODEL` или настройкой `model`, Claude Code подставляет разрешённую модель и продолжает. Ввод `/model <имя>` для ограниченной модели отклоняется с `Run /model to choose a different model.` и сеанс сохраняет свою текущую модель. Уведомление о подстановке также может появиться в середине сеанса после того, как администратор отключит модель, на которой работает сеанс, в консоли администратора claude.ai.2445Администратор вашей организации отключил эту модель в консоли администратора claude.ai, или управляемые настройки исключают её через список разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) или список [`deniedModels`](/docs/ru/model-config#block-specific-models-or-versions). Уведомление появляется при запуске, когда `--model`, `ANTHROPIC_MODEL` или настройка `model` назвали ограниченную модель, и оно называет модель, которую сеанс использует вместо этого. Если управляемые настройки не оставляют разрешённую модель для использования сеансом, смотрите [Managed settings block the default model](#managed-settings-block-the-default-model). Уведомление о подстановке также может появиться в середине сеанса после того, как администратор отключит модель, на которой работает сеанс, в консоли администратора claude.ai.

2291 2446

2292```text theme={null}2447```text theme={null}

2293Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.2448Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

2294```2449```

2295 2450

2451Ввод `/model <имя>` для ограниченной модели отклоняется и сеанс сохраняет свою текущую модель. Для модели, отключённой в консоли администратора, отказ читается `Model '<имя>' is restricted by your organization's settings. Run /model to choose a different model.` Для модели, которую управляемые настройки исключают, он читается `Model '<имя>' is not available. Your organization restricts model selection.`

2452

2296Уведомление с префиксом имени агента, навыка или команды означает, что ограничение применилось к [запрошенной модели подагента](/docs/ru/sub-agents#choose-a-model): подагент работает на подставленной модели и модель вашего сеанса не изменяется. До версии 2.1.223 Claude Code показывал уведомление только для подагентов, запущенных с помощью инструмента Agent.2453Уведомление с префиксом имени агента, навыка или команды означает, что ограничение применилось к [запрошенной модели подагента](/docs/ru/sub-agents#choose-a-model): подагент работает на подставленной модели и модель вашего сеанса не изменяется. До версии 2.1.223 Claude Code показывал уведомление только для подагентов, запущенных с помощью инструмента Agent.

2297 2454

2298Claude Code обрабатывает псевдоним семейства моделей, один из `opus`, `sonnet`, `haiku` или `fable`, как запрос для этого семейства, а не для его новейшей версии. На Anthropic API и на [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) ограниченный псевдоним семейства разрешается в новейшую версию семейства, которую разрешают ваша организация и список разрешений `availableModels`, и уведомление о подстановке называет эту версию. Claude Code отклоняет `/model <псевдоним>` только когда каждая версия семейства ограничена. До версии 2.1.205 псевдоним семейства был подставлен или отклонен на основе только его новейшей версии, даже когда была разрешена более старая версия того же семейства.2455Claude Code обрабатывает псевдоним семейства моделей, один из `opus`, `sonnet`, `haiku` или `fable`, как запрос для этого семейства, а не для его новейшей версии. На Anthropic API и на [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) ограниченный псевдоним семейства разрешается в новейшую версию семейства, которую разрешают ваша организация и список разрешений `availableModels`, и уведомление о подстановке называет эту версию. Claude Code отклоняет `/model <псевдоним>` только когда каждая версия семейства ограничена. До версии 2.1.205 псевдоним семейства был подставлен или отклонен на основе только его новейшей версии, даже когда была разрешена более старая версия того же семейства.

2354 2511

2355**Что делать:**2512**Что делать:**

2356 2513

2357* Запустите `claude update` и перезагрузите Claude Code. Opus 4.7 требует v2.1.111 или позже. Opus 4.8 требует v2.1.154 или позже. Sonnet 5 требует v2.1.197 или позже. Opus 5 требует v2.1.219 или позже. Opus 5.5 требует v2.1.280 или позже2514* Запустите `claude update` и перезагрузите Claude Code. Opus 4.7 требует v2.1.111 или позже. Opus 4.8 требует v2.1.154 или позже. Sonnet 5 требует v2.1.197 или позже. Opus 5 требует v2.1.219 или позже. Opus 5.5 требует v2.1.280 или позже. Sonnet 5.5 требует v2.1.284 или позже

2358* Если вы не можете обновиться, запустите `/model` и выберите Opus 4.6 или Sonnet 4.6 вместо этого2515* Если вы не можете обновиться, запустите `/model` и выберите Opus 4.6 или Sonnet 4.6 вместо этого

2359* Если вы столкнулись с этим в [Agent SDK](/docs/ru/agent-sdk/overview), обновите пакет SDK вместо этого. Opus 4.8 требует TypeScript SDK v0.3.154 или позже и Python SDK v0.2.88 или позже. Sonnet 5 требует TypeScript SDK v0.3.197 или позже. Opus 5 требует TypeScript SDK v0.3.219 или позже. Opus 5.5 требует TypeScript SDK v0.3.280 или позже2516* Если вы столкнулись с этим в [Agent SDK](/docs/ru/agent-sdk/overview), обновите пакет SDK вместо этого. Opus 4.8 требует TypeScript SDK v0.3.154 или позже и Python SDK v0.2.88 или позже. Sonnet 5 требует TypeScript SDK v0.3.197 или позже. Opus 5 требует TypeScript SDK v0.3.219 или позже. Opus 5.5 требует TypeScript SDK v0.3.280 или позже. Sonnet 5.5 требует TypeScript SDK v0.3.284 или позже

2360 2517

2361<h3 id="effort-isnt-available-with-thinking-turned-off">2518<h3 id="effort-isnt-available-with-thinking-turned-off">

2362 Effort isn't available with thinking turned off2519 Effort isn't available with thinking turned off

2368API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)2525API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)

2369```2526```

2370 2527

2528Подсказка после `·` варьируется в зависимости от сеанса: в неинтерактивном сеансе она читается `use --effort high (or the effortLevel setting)`, и в сеансе, который Claude Desktop app запускает, она читается `you can lower effort to High`.

2529

2371**Что делать:**2530**Что делать:**

2372 2531

2373* [Понизьте уровень усилий](/docs/ru/model-config#set-the-effort-level) до `high` или ниже.2532* [Понизьте уровень усилий](/docs/ru/model-config#set-the-effort-level) до `high` или ниже.

2374* Включите мышление обратно, например, отменив [`MAX_THINKING_TOKENS`](/docs/ru/env-vars) или удалив [`"alwaysThinkingEnabled": false`](/docs/ru/settings-reference#alwaysthinkingenabled) из ваших настроек.2533* Включите мышление обратно, например, отменив [`MAX_THINKING_TOKENS`](/docs/ru/env-vars) или удалив [`"alwaysThinkingEnabled": false`](/docs/ru/settings-reference#alwaysthinkingenabled) из ваших настроек.

2375 2534

2376До версии 2.1.242 Claude Code показывал собственное сообщение API: `API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking.` До версии 2.1.251 Claude Code отправлял запрос на уровне усилий, который вы установили, поэтому Opus 5 отклонял каждый запрос выше `high` с отключённым мышлением. Claude Code теперь отправляет усилие `high` вместо этого моделям, которые, как он знает, отклоняют комбинацию, такие как Opus 5, поэтому на v2.1.251 или позже эта ошибка достигает вас только от модели, которую Claude Code не знает отклоняет.2535До версии 2.1.242 Claude Code показывал собственное сообщение API: `API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking.` До версии 2.1.251 Claude Code отправлял запрос на уровне усилий, который вы установили, поэтому Opus 5 отклонял каждый запрос выше `high` с отключённым мышлением. Claude Code теперь отправляет усилие `high` вместо этого моделям, которые, как он знает, отклоняют комбинацию, такие как Opus 5.

2377 2536

2378<h3 id="thinking-budget-exceeds-output-limit">2537<h3 id="thinking-budget-exceeds-output-limit">

2379 Thinking budget exceeds output limit2538 Thinking budget exceeds output limit

2385API Error: 400 ... max_tokens must be greater than thinking.budget_tokens2544API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

2386```2545```

2387 2546

2388Claude Code автоматически регулирует эти значения на Anthropic API. Вы обычно видите эту ошибку на Amazon Bedrock или Google Cloud's Agent Platform, когда [`MAX_THINKING_TOKENS`](/docs/ru/env-vars) установлен выше лимита вывода поставщика, или когда режим плана повышает бюджет мышления.

~~2389~~

2390**Что делать:**2547**Что делать:**

2391 2548

2392* Понизьте `MAX_THINKING_TOKENS` или повысьте [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ru/env-vars) выше бюджета мышления2549* Повысьте [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ru/env-vars) выше бюджета мышления

2393* Смотрите [Extended thinking](/docs/ru/model-config#extended-thinking) для того, как бюджет взаимодействует с длиной вывода2550* Смотрите [Extended thinking](/docs/ru/model-config#extended-thinking) для того, как бюджет взаимодействует с длиной вывода

2394 2551

2395<h3 id="tool-use-or-thinking-block-mismatch">2552<h3 id="tool-use-or-thinking-block-mismatch">

2396 Tool use or thinking block mismatch2553 Tool use or thinking block mismatch

2397</h3>2554</h3>

2398 2555

2399История разговора достигла API в несогласованном состоянии, обычно после того, как вызов инструмента был прерван или ход был отредактирован в середине потока.2556История разговора достигла API в несогласованном состоянии.

2400 2557

2401```text theme={null}2558```text theme={null}

2402API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.2559API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.

2411**Что делать:**2568**Что делать:**

2412 2569

2413* Если вы используете Opus 4.7 или Opus 4.8, сначала запустите `claude update`. Версии до v2.1.156 могут вызвать эту ошибку во время нормального использования инструмента, и `/rewind` её не очищает.2570* Если вы используете Opus 4.7 или Opus 4.8, сначала запустите `claude update`. Версии до v2.1.156 могут вызвать эту ошибку во время нормального использования инструмента, и `/rewind` её не очищает.

2414* Запустите `/rewind` или нажмите Esc дважды, чтобы вернуться к контрольной точке перед повреждённым ходом и продолжить оттуда. Смотрите [Checkpointing](/docs/ru/checkpointing) для того, как создаются и восстанавливаются контрольные точки.2571* Запустите `/rewind` или нажмите Esc дважды, чтобы вернуться к checkpoint перед повреждённым ходом и продолжить оттуда. Смотрите [Checkpointing](/docs/ru/checkpointing) для того, как создаются и восстанавливаются checkpoints.

2572

2573<h3 id="invalid-data-in-redacted-thinking-block">

2574 Invalid data in redacted\_thinking block

2575</h3>

2576

2577API отклонил запрос с 400, потому что он не смог принять блок `redacted_thinking`, который более ранний ход в истории разговора содержит.

2578

2579```text theme={null}

2580API Error: 400 ... Invalid `data` in `redacted_thinking` block

2581```

2582

2583Claude Code оставляет мышление разговора из более ранних ходов вне запроса и повторяет один раз, поэтому сеанс продолжается без показа ошибки. До версии 2.1.282 Claude Code сохранял отклонённый блок, и каждый более поздний ход завершался с той же ошибкой.

2584

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

2586

2587* Если вы на v2.1.281 или раньше и каждый ход завершается с этой ошибкой, запустите `claude update` и возобновите сеанс

2588* Если ошибка сохраняется, запустите `/clear` для начала разговора, который не содержит блок

2415 2589

2416<h3 id="unsupported-tool-content-removed">2590<h3 id="unsupported-tool-content-removed">

2417 Unsupported tool content removed2591 Unsupported tool content removed

2446 2620

2447**Что делать:**2621**Что делать:**

2448 2622

2449* Запустите `/clear` для начала свежего разговора. Если ошибка возвращается там тоже, причина находится на пути запроса, а не в сохранённом разговоре.

2450* Если ошибка повторяется на каждом ходу позади прокси или шлюза, настроенного через [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars), подключитесь без прокси, чтобы подтвердить источник, и сообщите об ошибке тому, кто его управляет2623* Если ошибка повторяется на каждом ходу позади прокси или шлюза, настроенного через [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars), подключитесь без прокси, чтобы подтвердить источник, и сообщите об ошибке тому, кто его управляет

2624* Запустите `/clear` для начала свежего разговора. Если ошибка возвращается там тоже, причина находится на пути запроса, а не в сохранённом разговоре.

2451 2625

2452До версии 2.1.280 Claude Code не распознавал эту формулировку, поэтому ошибка также появлялась, когда отклонённое системное сообщение было тем, которое сам Claude Code отправил, и каждый более поздний ход разговора завершался с той же ошибкой.2626До версии 2.1.280 Claude Code не распознавал эту формулировку, поэтому ошибка также появлялась, когда отклонённое системное сообщение было тем, которое сам Claude Code отправил, и каждый более поздний ход разговора завершался с той же ошибкой.

2453 2627

2458API отклонил запрос с 400, потому что история разговора содержит размещённое содержимое веб-поиска, которое он не может расшифровать. Формулировка называет поле, которое он не может прочитать:2632API отклонил запрос с 400, потому что история разговора содержит размещённое содержимое веб-поиска, которое он не может расшифровать. Формулировка называет поле, которое он не может прочитать:

2459 2633

2460```text theme={null}2634```text theme={null}

2461API Error: 400 messages.21.content.0: Invalid `encrypted_content` in `search_result` block2635API Error: 400 ... Invalid `encrypted_content` in `search_result` block

2462API Error: 400 messages.21.content.3.citations.0: Invalid `encrypted_index` in `text` block2636API Error: 400 ... Invalid `encrypted_index` in `text` block

2463API Error: 400 Failed to decrypt web search result content2637API Error: 400 ... Failed to decrypt web search result content

2638API Error: 400 ... Invalid `encrypted_stdout` in `encrypted_code_execution_result` block

2464```2639```

2465 2640

2466Результаты из размещённого [инструмента веб-поиска](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) API содержат зашифрованные поля, которые только API может прочитать. API отклоняет запрос, который воспроизводит содержимое, которое он не может расшифровать, такое как содержимое, созданное для другой организации.2641Результаты из размещённого [инструмента веб-поиска](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) API содержат зашифрованные поля, которые только API может прочитать. Формулировка `encrypted_stdout` называет вывод размещённой программы выполнения кода, которая прочитала такие результаты, которые API также шифрует. API отклоняет запрос, который воспроизводит содержимое, которое он не может расшифровать, такое как содержимое, созданное для другой организации.

2467 2642

2468Собственный [инструмент WebSearch](/docs/ru/tools-reference#websearch-tool-behavior) Claude Code записывает результаты поиска как простой текст, поэтому эти блоки обычно достигают разговора через прокси или [LLM gateway](/docs/ru/llm-gateway), который сам запустил размещённый веб-поиск.2643Собственный [инструмент WebSearch](/docs/ru/tools-reference#websearch-tool-behavior) Claude Code записывает результаты поиска как простой текст, поэтому эти блоки обычно достигают разговора через прокси или [LLM gateway](/docs/ru/llm-gateway), который сам запустил размещённый веб-поиск.

2469 2644

2470Отклонённые блоки остаются в истории разговора, поэтому каждый более поздний ход и `/compact` завершаются с той же ошибкой.2645Для трёх формулировок веб-поиска Claude Code оставляет вызовы поиска, результаты и цитаты вне того, что он отправляет, и повторяет запрос один раз, поэтому сеанс продолжается без показа ошибки. Формулировка `encrypted_stdout` не имеет такого восстановления, поэтому это сообщение всё ещё достигает вас. До версии 2.1.282 Claude Code сохранял отклонённые блоки веб-поиска тоже, и каждый более поздний ход и `/compact` завершались с той же ошибкой.

2471 2646

2472**Что делать:**2647**Что делать:**

2473 2648

2474* Запустите `/clear` или начните новый сеанс; новый разговор не содержит отклонённые блоки2649* Если вы на v2.1.281 или раньше и каждый ход завершается с одной из формулировок веб-поиска, запустите `claude update` и возобновите сеанс

2650* Если ошибка сохраняется, или сообщение называет `encrypted_stdout`, запустите `/rewind` для возврата к checkpoint перед ходом, который добавил содержимое, или запустите `/clear` для начала разговора, который не содержит его

2475* Если вы запускаете Claude Code позади прокси или шлюза, сообщите об ошибке тому, кто его управляет2651* Если вы запускаете Claude Code позади прокси или шлюза, сообщите об ошибке тому, кто его управляет

2476 2652

2477<h3 id="usage-policy-refusal">2653<h3 id="usage-policy-refusal">

2478 Usage Policy refusal2654 Usage Policy refusal

2479</h3>2655</h3>

2480 2656

2481API отклонил ответ, потому что содержимое в разговоре вызвало проверку [Usage Policy](https://www.anthropic.com/legal/aup). Сообщение включает ID запроса, который вы можете привести в поддержку, если вы считаете, что отказ неправильный.2657API отклонил ответ, потому что содержимое в разговоре вызвало проверку [Usage Policy](https://www.anthropic.com/legal/aup).

2658

2659Сообщение включает Request ID и Message ID, которые вы можете привести в поддержку, если вы считаете, что отказ неправильный.

2482 2660

2483```text theme={null}2661```text theme={null}

2484API Error: Opus 4.6 can't help with this. Start a new session to continue.2662API Error: Opus 4.6 can't help with this. Start a new session to continue.

2494 2672

2495**Что делать:**2673**Что делать:**

2496 2674

2497* Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к контрольной точке перед ходом, который вызвал отказ, затем переформулируйте или возьмите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).2675* Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к checkpoint перед ходом, который вызвал отказ, затем переформулируйте или возьмите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).

2498* Если вы не можете определить, какой ход вызвал это, запустите `/clear`, чтобы начать свежий разговор в том же проекте. Ваш предыдущий разговор сохраняется на диске и остаётся доступным в `/resume`.2676* Если вы не можете определить, какой ход вызвал это, запустите `/clear`, чтобы начать свежий разговор в том же проекте. Ваш предыдущий разговор сохраняется на диске и остаётся доступным в `/resume`.

2499* В [неинтерактивном режиме](/docs/ru/headless) (`-p`), где перемотка недоступна, повторите попытку с переформулированным prompt в новом сеансе без `--continue`. Проверки политики варьируются в зависимости от модели, поэтому переключение на другую модель с помощью `--model` также может разрешить отказ в некоторых случаях.2677* В [неинтерактивном режиме](/docs/ru/headless) (`-p`), где перемотка недоступна, повторите попытку с переформулированным prompt в новом сеансе без `--continue`. Проверки политики варьируются в зависимости от модели, поэтому переключение на другую модель с помощью `--model` также может разрешить отказ в некоторых случаях.

2500 2678

2508API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude2686API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude

2509```2687```

2510 2688

2511Сообщение ссылается на [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), который предоставляет доступ для законной работы в области кибербезопасности. На Opus 5.5, который требует v2.1.280 или позже, сообщение открывается с `Opus 5.5's safeguards flagged this session` вместо этого. Когда отмеченная категория имеет доступную резервную модель, Claude Code [переключает модели](/docs/ru/model-config#automatic-model-fallback) вместо показа этой ошибки.2689Сообщение ссылается на [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), который предоставляет доступ для законной работы в области кибербезопасности. На Opus 5.5 и Sonnet 5.5 сообщение открывается с `<модель>'s safeguards flagged this session` вместо этого. Когда отмеченная категория имеет доступную резервную модель, Claude Code [переключает модели](/docs/ru/model-config#automatic-model-fallback) вместо показа этой ошибки.

2512 2690

2513На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) флаг кибербезопасности вместо этого производит сообщение [Usage Policy refusal](#usage-policy-refusal).2691На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) флаг кибербезопасности вместо этого производит сообщение [Usage Policy refusal](#usage-policy-refusal).

2514 2692

2520 2698

2521* Если ваша работа требует этого содержимого, подайте заявку на доступ через [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)2699* Если ваша работа требует этого содержимого, подайте заявку на доступ через [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)

2522* Если ваш запрос не был о теме кибербезопасности, запустите `/feedback`, чтобы сообщить о ложном срабатывании2700* Если ваш запрос не был о теме кибербезопасности, запустите `/feedback`, чтобы сообщить о ложном срабатывании

2523* Чтобы продолжить работу в том же сеансе, нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к контрольной точке перед ходом, который вызвал флаг, затем возьмите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).2701* Чтобы продолжить работу в том же сеансе, нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к checkpoint перед ходом, который вызвал флаг, затем возьмите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).

2524 2702

2525<h2 id="installation-errors">2703<h2 id="installation-errors">

2526 Ошибки установки2704 Ошибки установки

2550 Соединение разорвалось при загрузке обновления2728 Соединение разорвалось при загрузке обновления

2551</h3>2729</h3>

2552 2730

2553Соединение с сервером загрузки закрылось, пока `claude install`, `claude update` или [автоматический обновляющий модуль](/docs/ru/setup#auto-updates) загружал двоичный файл Claude Code, и повторные попытки не восстановили соединение. Claude Code повторяет загрузку, когда соединение разрывается, передача зависает или загруженный файл не проходит проверку контрольной суммы, всего до трёх попыток. Завершённая ошибка HTTP, такая как 404, не повторяется, потому что сервер уже ответил. До версии 2.1.202 одно разорванное соединение немедленно приводило к сбою загрузки с простой ошибкой `aborted` вместо повторной попытки.2731Соединение с сервером загрузки закрылось, пока `claude install` или `claude update` загружал двоичный файл Claude Code, и повторные попытки не восстановили соединение. Claude Code повторяет загрузку, когда соединение разрывается, передача зависает или загруженный файл не проходит проверку контрольной суммы, всего до трёх попыток. Завершённая ошибка HTTP, такая как 404, не повторяется, потому что сервер уже ответил. До версии 2.1.202 одно разорванное соединение немедленно приводило к сбою загрузки с простой ошибкой `aborted` вместо повторной попытки.

2554 2732

2555```text theme={null}2733```text theme={null}

2556The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.2734The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

2560 2738

2561Загрузка, которая остаётся подключённой, но не завершается в течение 10 минут, завершается с ошибкой `Download timed out: exceeded the total deadline`. Claude Code не повторяет загрузку с истекшим временем ожидания, потому что соединение, которое слишком медленно для завершения в течение установленного срока, не завершится при немедленной повторной попытке. Приведённые ниже шаги применяются к обоим сообщениям.2739Загрузка, которая остаётся подключённой, но не завершается в течение 10 минут, завершается с ошибкой `Download timed out: exceeded the total deadline`. Claude Code не повторяет загрузку с истекшим временем ожидания, потому что соединение, которое слишком медленно для завершения в течение установленного срока, не завершится при немедленной повторной попытке. Приведённые ниже шаги применяются к обоим сообщениям.

2562 2740

2563Обычная причина — прокси или шлюз, который закрывает длительную передачу до её завершения. Двоичный файл Claude Code — это большая загрузка, поэтому ограничение соединения прокси, которое никогда не влияет на обычный трафик API, всё равно может его прервать.2741Прокси или шлюз может закрыть длительную передачу до её завершения, и двоичный файл Claude Code — это большая загрузка.

2564 2742

2565**Что делать:**2743**Что делать:**

2566 2744

2569* Если корпоративный прокси продолжает закрывать передачу, попросите вашу команду сети разрешить полную загрузку с `downloads.claude.ai`. См. [Требования к доступу в сеть](/docs/ru/network-config#network-access-requirements).2747* Если корпоративный прокси продолжает закрывать передачу, попросите вашу команду сети разрешить полную загрузку с `downloads.claude.ai`. См. [Требования к доступу в сеть](/docs/ru/network-config#network-access-requirements).

2570* Запустите `claude doctor` из вашей оболочки для диагностики установки2748* Запустите `claude doctor` из вашей оболочки для диагностики установки

2571 2749

2572***

~~2573~~

2574title: "Ошибки командной строки"

2575description: "Справочник по ошибкам командной строки Claude Code, включая конфликты флагов, проблемы с конфигурацией и неполадки с облачными сеансами."

~~2576~~

2577<h2 id="command-line-errors">2750<h2 id="command-line-errors">

2578 Ошибки командной строки2751 Ошибки командной строки

2579</h2>2752</h2>

2580 2753

2581Эти ошибки поступают из командной строки `claude` и её подкоманд, из имени команды, которое вы отправляете в приглашение, и из команд, таких как `/security-review`, которые собирают контекст, запуская команды оболочки перед выполнением своего приглашения. Они также поступают из `/tui`, который перезапускает CLI.2754Эти ошибки поступают из командной строки `claude` и её подкоманд, из имени команды, которое вы вводите в приглашение, и из команд, таких как `/security-review`, которые собирают контекст, запуская команды оболочки перед выполнением своего приглашения. Они также поступают из `/tui`, который перезапускает CLI.

2582 2755

2583<h3 id="conflict-between-bg-and-print">2756<h3 id="conflict-between-bg-and-print">

2584 Конфликт между --bg и --print2757 Конфликт между `--bg` и `--print`

2585</h3>2758</h3>

2586 2759

2587Это сообщение требует Claude Code v2.1.198 или позже. Вы объединили `--bg` с `-p` или `--print` в одном вызове `claude`. `--bg` запускает [фоновый сеанс](/docs/ru/agent-view#from-your-shell), к которому вы позже подключаетесь с помощью `claude agents`, в то время как `--print` работает [неинтерактивно](/docs/ru/headless) и никогда не запускает интерактивный сеанс, к которому подключается `claude agents`. До версии 2.1.198 эта комбинация молча создавала фоновое задание, к которому невозможно было подключиться.2760Это сообщение требует Claude Code v2.1.198 или более поздней версии. Вы объединили `--bg` с `-p` или `--print` в одном вызове `claude`. `--bg` запускает [фоновый сеанс](/docs/ru/agent-view#from-your-shell), к которому вы позже подключаетесь с помощью `claude agents`, а `--print` запускает [неинтерактивно](/docs/ru/headless) и никогда не запускает интерактивный сеанс, к которому подключается `claude agents`. До версии v2.1.198 эта комбинация молча создавала фоновое задание, к которому невозможно было подключиться.

2588 2761

2589```text theme={null}2762```text theme={null}

2590--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.2763--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.

2597* Чтобы запустить приглашение неинтерактивно и вывести результат вместо создания фонового сеанса, удалите `--bg` и запустите `claude -p "<task>"`2769* Чтобы запустить приглашение неинтерактивно и вывести результат вместо создания фонового сеанса, удалите `--bg` и запустите `claude -p "<task>"`

2598 2770

2599<h3 id="invalid-agents-configuration">2771<h3 id="invalid-agents-configuration">

2600 Неверная конфигурация --agents2772 Неверная конфигурация `--agents`

2601</h3>2773</h3>

2602 2774

2603Значение, которое вы передали в `--agents`, недействительно, поэтому `claude` выходит с кодом 1 вместо запуска сеанса. Когда вы передаёте `--safe-mode`, `--resume` или `--continue`, или устанавливаете [`CLAUDE_CODE_SAFE_MODE`](/docs/ru/env-vars#variables), Claude Code не проверяет значение и запускает сеанс. До версии 2.1.242 Claude Code запускал сеанс в любом случае и пропускал определения, которые не мог загрузить.2775Значение, которое вы передали в `--agents`, недействительно, поэтому `claude` завершает работу с кодом 1 вместо запуска сеанса. Когда вы передаёте `--safe-mode` или устанавливаете [`CLAUDE_CODE_SAFE_MODE`](/docs/ru/env-vars#variables), Claude Code полностью игнорирует `--agents`. С `--resume` или `--continue` встроенное значение JSON не проверяется и сеанс запускается; значение, прочитанное из файла, проверяется при каждом запуске. До версии v2.1.242 Claude Code запускал сеанс в любом случае.

2604 2776

2605```text theme={null}2777```text theme={null}

2606Error: Invalid --agents configuration:2778Error: Invalid --agents configuration:

2609 2781

2610То, что следует после первой строки, зависит от того, как значение не прошло проверку. Claude Code выполняет эти проверки по порядку и останавливается на первой, которая не пройдена. Если ваше значение имеет два вида проблем, вы видите второе только после исправления первого:2782То, что следует после первой строки, зависит от того, как значение не прошло проверку. Claude Code выполняет эти проверки по порядку и останавливается на первой, которая не пройдена. Если ваше значение имеет два вида проблем, вы видите второе только после исправления первого:

2611 2783

26121. Когда значение не анализируется как JSON, Claude Code выводит одну строку `invalid JSON:` с собственным сообщением парсера JSON27841. Когда значение начинается с `{`, но не анализируется как JSON, или содержимое файла `--agents` не анализируется, Claude Code выводит одну строку `invalid JSON:` с собственным сообщением парсера JSON

26132. Когда оно анализируется, но определение агента не соответствует схеме для [подагентов, определённых в CLI](/docs/ru/sub-agents#choose-the-subagent-scope), Claude Code выводит одну строку на проблему27852. Когда оно анализируется, но определение агента не соответствует схеме для [определённых в CLI подагентов](/docs/ru/sub-agents#choose-the-subagent-scope), Claude Code выводит одну строку на проблему

26143. Когда имя агента начинается с `-`, Claude Code выводит `<name>: agent names must not start with '-'`27863. Когда имя агента начинается с `-`, Claude Code выводит `<name>: agent names must not start with '-'`

2615 2787

2616Когда строк проблем больше 20, Claude Code выводит первые 20 и заменяет остальные на `…and N more`.2788Когда строк проблем больше 20, Claude Code выводит первые 20 и заменяет остальные на `…and N more`.

2617 2789

2790С `--print`, `--agents` также принимает [путь к файлу JSON](/docs/ru/sub-agents#choose-the-subagent-scope) вместо встроенного объекта. До версии v2.1.281 `--agents` принимал только встроенный JSON и рассматривал путь к файлу как недействительный JSON. Форма файла имеет свои отказы, выводимые вместо этого сообщения, включая следующие:

2791

2792* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code прочитал значение как путь к файлу в интерактивном сеансе. Передайте определения как встроенный JSON или добавьте `-p` для чтения из файла.

2793* **`Error: --agents file not found: <path>`**: файл не существует по этому пути. Значение, которое не начинается с `{` и не является действительным JSON, читается как путь, поэтому встроенный JSON, который ваша оболочка повредила, может не пройти таким образом. Проверьте путь или кавычки и запустите команду снова.

2794

2618**Что делать:**2795**Что делать:**

2619 2796

2620* Исправьте каждую проблему, которую указывает сообщение, затем запустите команду снова. См. [поля, которые принимает подагент, определённый в CLI](/docs/ru/sub-agents#choose-the-subagent-scope).2797* Исправьте каждую проблему, которую указывает сообщение, затем запустите команду снова. См. [поля, которые принимает определённый в CLI подагент](/docs/ru/sub-agents#choose-the-subagent-scope).

2621 2798

2622<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">2799<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">

2623 Облачные сеансы не могут быть созданы из сеанса --restricted2800 Облачные сеансы не могут быть созданы из сеанса `--restricted`

2624</h3>2801</h3>

2625 2802

2626Когда вы запускаете сеанс с [`--restricted`](/docs/ru/cli-reference#cli-flags), Claude Code отказывается создавать [облачные сеансы](/docs/ru/claude-code-on-the-web#from-terminal-to-cloud) из него, потому что новый сеанс будет работать вне ограниченного процесса и не будет применять ограниченный режим. Claude Code отказывает на клиенте, перед контактом с сервером, поэтому облачный сеанс не создаётся:2803Когда вы запускаете сеанс с [`--restricted`](/docs/ru/cli-reference#cli-flags), Claude Code отказывается создавать [облачные сеансы](/docs/ru/claude-code-on-the-web#from-terminal-to-cloud) из него, потому что новый сеанс будет работать вне ограниченного процесса и не будет применять ограниченный режим. Claude Code отказывает на клиенте, перед контактом с сервером, поэтому облачный сеанс не создаётся:

2634* Запустите задачу локально в ограниченном сеансе2811* Запустите задачу локально в ограниченном сеансе

2635* Если вы контролируете способ запуска сеанса, запустите новый сеанс `claude` без `--restricted` и создайте облачный сеанс оттуда2812* Если вы контролируете способ запуска сеанса, запустите новый сеанс `claude` без `--restricted` и создайте облачный сеанс оттуда

2636 2813

2637До версии 2.1.248 Claude Code не имел флага `--restricted`; более ранние версии отклоняют сам флаг с ошибкой неизвестного параметра.2814До версии v2.1.248 Claude Code не имел флага `--restricted`; более ранние версии отклоняют сам флаг с ошибкой неизвестного параметра.

2638 2815

2639<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">2816<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">

2640 Облачные сеансы отключены политикой вашей организации2817 Облачные сеансы отключены политикой вашей организации

2646Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.2823Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.

2647```2824```

2648 2825

2649Сообщение появляется, когда вы [создаёте облачный сеанс из терминала](/docs/ru/claude-code-on-the-web#from-terminal-to-cloud) и когда вы отправляете команду, которая требует облачные сеансы, такие как `/teleport`, `/remote-env` или `/web-setup`. До версии 2.1.268 отправка одной из этих команд возвращала [`Unknown command`](#unknown-command) вместо этого.2826Сообщение появляется, когда вы [создаёте облачный сеанс из терминала](/docs/ru/claude-code-on-the-web#from-terminal-to-cloud) и когда вы отправляете команду, которая требует облачные сеансы, такую как `/teleport`, `/remote-env` или `/web-setup`. До версии v2.1.268 отправка одной из этих команд возвращала [`Unknown command`](#unknown-command) вместо этого.

2650 2827

2651Это политика организации на стороне сервера, поэтому её нельзя переопределить из локальных параметров, переменных окружения или флагов CLI.2828Это политика организации на стороне сервера, поэтому её нельзя переопределить из локальных параметров, переменных окружения или флагов CLI.

2652 2829

2654 2831

2655**Что делать:**2832**Что делать:**

2656 2833

2657* Попросите [Owner](/docs/ru/server-managed-settings#access-control) в вашей организации включить облачные сеансы в параметрах администратора Claude Code на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)2834* Попросите [владельца](/docs/ru/server-managed-settings#access-control) в вашей организации включить облачные сеансы в параметрах администратора Claude Code на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)

2658* Если сообщение говорит, что оно не смогло проверить политику, проверьте подключение к сети, затем перезагрузите Claude Code и попробуйте снова2835* Если сообщение говорит, что не удалось проверить политику, проверьте подключение к сети, затем перезагрузите Claude Code и попробуйте снова

2659 2836

2660<h3 id="the-json-schema-value-is-not-a-valid-json-schema">2837<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

2661 Значение --json-schema не является действительной JSON Schema2838 Значение `--json-schema` не является действительной JSON Schema

2662</h3>2839</h3>

2663 2840

2664Схема, которую вы передали в [`--json-schema`](/docs/ru/cli-reference#cli-flags) в [неинтерактивном режиме](/docs/ru/headless#get-structured-output), не прошла компиляцию JSON Schema, поэтому `claude` выходит с кодом 1 вместо запуска приглашения. До версии 2.1.205 недействительная схема выдавала неструктурированный вывод без ошибки, и любая схема, использующая ключевое слово `format`, рассматривалась как недействительная.2841Схема, которую вы передали в [`--json-schema`](/docs/ru/cli-reference#cli-flags) в [неинтерактивном режиме](/docs/ru/headless#get-structured-output), не прошла компиляцию JSON Schema, поэтому `claude` завершает работу с кодом 1 вместо запуска приглашения. До версии v2.1.205 недействительная схема выдавала неструктурированный вывод без ошибки, и любая схема, использующая ключевое слово `format`, рассматривалась как недействительная.

2665 2842

2666```text theme={null}2843```text theme={null}

2667Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values2844Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

2674**Что делать:**2851**Что делать:**

2675 2852

2676* Исправьте часть схемы, которую указывает диагностика, затем повторно запустите команду2853* Исправьте часть схемы, которую указывает диагностика, затем повторно запустите команду

2677* Если диагностика — `schema too large`, уменьшите вложенность схемы и повторное использование `$ref`

2678* См. [Get structured output](/docs/ru/headless#get-structured-output) для рабочей схемы и команды2854* См. [Get structured output](/docs/ru/headless#get-structured-output) для рабочей схемы и команды

2679 2855

2680<h3 id="settings-file-exceeds-the-2mib-limit">2856<h3 id="settings-file-exceeds-the-2mib-limit">

2681 Файл параметров превышает лимит 2MiB2857 Файл параметров превышает лимит 2MiB

2682</h3>2858</h3>

2683 2859

2684Файл, который вы передали в [`--settings`](/docs/ru/cli-reference#cli-flags), больше 2 MiB, поэтому `claude` выходит с кодом 1 при запуске вместо загрузки. Файл параметров — это небольшой документ JSON, поэтому файл такого размера обычно означает, что путь указывает на неправильный файл. До версии 2.1.214 Claude Code читал файл без проверки размера, и файл размером в несколько гигабайт или файл устройства, такой как `/dev/zero`, увеличивал память без ограничений.2860Файл, который вы передали в [`--settings`](/docs/ru/cli-reference#cli-flags), больше 2 MiB, поэтому `claude` завершает работу с кодом 1 при запуске вместо загрузки. До версии v2.1.214 Claude Code читал файл без проверки размера, и многогигабайтный файл или файл устройства, такой как `/dev/zero`, увеличивал память без ограничений.

2685 2861

2686```text theme={null}2862```text theme={null}

2687Error: Settings file exceeds the 2MiB limit: /path/to/settings.json2863Error: Settings file exceeds the 2MiB limit: /path/to/settings.json

2688```2864```

2689 2865

2690Claude Code отклоняет путь `--settings`, который не является обычным файлом, таким же образом: устройство, FIFO или сокет выводит `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` с последующим путём, а каталог выводит причину `EISDIR`.2866Claude Code отклоняет путь `--settings`, который не является обычным файлом, таким же образом: устройство, FIFO или сокет сообщает `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` с последующим путём, а каталог сообщает причину `EISDIR`.

2691 2867

2692**Что делать:**2868**Что делать:**

2693 2869

2697 Текущий каталог больше не существует2873 Текущий каталог больше не существует

2698</h3>2874</h3>

2699 2875

2700Вы запустили `claude` из каталога, который был удалён или перемещён после того, как ваша оболочка вошла в него, например рабочее дерево или временный каталог, удалённый другой оболочкой. Claude Code не может прочитать свой рабочий каталог, поэтому он выходит с кодом 1 перед запуском сеанса, как в интерактивном, так и в [неинтерактивном](/docs/ru/headless) режиме. До версии 2.1.239 Claude Code падал с минифицированным исходным кодом пакета и необработанным стеком `ENOENT ... uv_cwd` на stderr вместо этого сообщения.2876Вы запустили `claude` из каталога, который был удалён или перемещён после того, как ваша оболочка вошла в него, например worktree или временный каталог, удалённый другой оболочкой. Claude Code не может прочитать свой рабочий каталог, поэтому он завершает работу с кодом 1 перед запуском сеанса, как в интерактивном, так и в [неинтерактивном](/docs/ru/headless) режиме. До версии v2.1.239 Claude Code падал с минифицированным исходным кодом пакета и необработанным стеком `ENOENT ... uv_cwd` на stderr вместо этого сообщения.

2701 2877

2702```text theme={null}2878```text theme={null}

2703The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.2879The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.

2708 2884

2709Когда Claude Code не может прочитать рабочий каталог по другой причине, такой как изменение разрешений, сообщение указывает код ошибки вместо этого: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`2885Когда Claude Code не может прочитать рабочий каталог по другой причине, такой как изменение разрешений, сообщение указывает код ошибки вместо этого: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`

2710 2886

2711На macOS `EPERM` для каталога в `~/Desktop`, `~/Documents`, `~/Downloads` или iCloud Drive обычно означает, что macOS блокирует доступ вашего приложения терминала к этой папке. Другие команды, которые читают эту папку, не работают так же: `ls` там выводит `Operation not permitted`, даже с `sudo`.2887На macOS `EPERM` для каталога в `~/Desktop`, `~/Documents`, `~/Downloads` или iCloud Drive обычно означает, что macOS блокирует доступ вашего приложения терминала к этой папке. Другие команды, которые читают эту папку, не работают так же: `ls` там сообщает `Operation not permitted`, даже с `sudo`.

2712 2888

2713**Что делать:**2889**Что делать:**

2714 2890

2720 Временный каталог отклонён или не может быть создан2896 Временный каталог отклонён или не может быть создан

2721</h3>2897</h3>

2722 2898

2723На macOS и Linux Claude Code создаёт приватный временный каталог при запуске, `claude-<uid>` под системным временным каталогом или переопределением [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars). Когда каталог не может быть создан или запись, уже находящаяся по этому пути, не проходит проверки безопасности, Claude Code выводит ошибку на stderr и выходит с кодом 1 вместо запуска сеанса:2899На macOS и Linux Claude Code создаёт приватный временный каталог при запуске, `claude-<uid>` в системном временном каталоге или переопределении [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars). Когда каталог не может быть создан или запись, уже находящаяся по этому пути, не проходит проверки безопасности, Claude Code выводит сбой на stderr и завершает работу с кодом 1 вместо запуска сеанса:

2724 2900

2725```text wrap theme={null}2901```text wrap theme={null}

2726ENOSPC: no space left on device, mkdir '/tmp/claude-501'2902ENOSPC: no space left on device, mkdir '/tmp/claude-501'

2734 2910

2735**Что делать:**2911**Что делать:**

2736 2912

2737* Для `ENOSPC`, освободите место на диске на томе, который содержит временный каталог2913* Для `ENOSPC` освободите место на диске на томе, который содержит временный каталог

2738* Для форм `Refusing to use it`, удалите саму названную запись, не то, на что указывает ссылка, и запустите Claude Code снова; для формы `owned by uid`, только администратор или этот пользователь могут удалить её2914* Для форм `Refusing to use it` удалите саму названную запись, а не то, на что указывает ссылка, и запустите Claude Code снова; для формы `owned by uid` только администратор или этот пользователь могут удалить её

2739* Для `is not readable`, запустите `chmod 0700` на названном каталоге или удалите его и запустите снова2915* Для `is not readable` запустите `chmod 0700` на названном каталоге или удалите его и запустите снова

2740* В любом из этих случаев установите [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars) на каталог, который вы контролируете, и запустите Claude Code снова, оставляя отклонённый путь в покое2916* В любом из этих случаев установите [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars) на каталог, который вы контролируете, и запустите Claude Code снова, оставив отклонённый путь в покое

2741 2917

2742<h3 id="directory-couldnt-be-resolved-to-a-real-location">2918<h3 id="directory-couldnt-be-resolved-to-a-real-location">

2743 Каталог не удалось разрешить в реальное местоположение2919 Каталог не удалось разрешить в реальное местоположение

2745 2921

2746Вы запустили `/add-dir` для подкаталога вашего рабочего каталога, и Claude Code не смог разрешить каталог в его реальное местоположение.2922Вы запустили `/add-dir` для подкаталога вашего рабочего каталога, и Claude Code не смог разрешить каталог в его реальное местоположение.

2747 2923

2748У вас уже есть доступ к файлам подкаталога рабочего каталога, поэтому `/add-dir` только загружает его skills, команды и агентов. Перед загрузкой Claude Code проверяет, что реальное местоположение каталога, с разрешёнными всеми символическими ссылками, находится внутри рабочего каталога. Когда Claude Code не может разрешить это местоположение, он ничего не загружает и показывает это сообщение:2924У вас уже есть доступ к файлам подкаталога рабочего каталога, поэтому `/add-dir` только загружает его skills, команды и агентов. Перед загрузкой Claude Code проверяет, что реальное местоположение каталога, с разрешёнными любыми символическими ссылками, находится внутри рабочего каталога. Когда Claude Code не может разрешить это местоположение, он ничего не загружает и показывает это сообщение:

2749 2925

2750```text theme={null}2926```text theme={null}

2751packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.2927packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.

2756* Проверьте, что путь указывает на реальный каталог внутри рабочего каталога, затем запустите `/add-dir` снова2932* Проверьте, что путь указывает на реальный каталог внутри рабочего каталога, затем запустите `/add-dir` снова

2757* Сообщение не изменяет ваш доступ к файлам; оно только сообщает, что содержимое `.claude/` каталога не было загружено2933* Сообщение не изменяет ваш доступ к файлам; оно только сообщает, что содержимое `.claude/` каталога не было загружено

2758 2934

2759До версии 2.1.261 это сообщение также появлялось для каждого `/add-dir <subdirectory>`, когда рабочий каталог находился на автомонтировании `/net/<host>`, где Claude Code по дизайну отказывается разрешать пути; каталог был в порядке и повторная попытка не могла помочь.2935До версии v2.1.261 это сообщение также появлялось для каждого `/add-dir <subdirectory>`, когда рабочий каталог находился на автомонтировании `/net/<host>`, где Claude Code отказывается разрешать пути по дизайну; каталог был в порядке и повторная попытка не могла помочь.

2760 2936

2761<h3 id="workspace-not-trusted-when-starting-remote-control">2937<h3 id="workspace-not-trusted-when-starting-remote-control">

2762 Рабочее пространство не доверено при запуске Remote Control2938 Рабочее пространство не доверено при запуске Remote Control

2763</h3>2939</h3>

2764 2940

2765Вы запустили сервер [Remote Control](/docs/ru/remote-control) в режиме с помощью `claude remote-control` или его псевдонима `claude rc` в каталоге, которому вы не доверяете. Команда не показывает диалог доверия рабочего пространства сама по себе, поэтому она выходит с кодом 1 и указывает исправление:2941Вы запустили сервер [Remote Control](/docs/ru/remote-control) в режиме с `claude remote-control` или его псевдонимом `claude rc` в каталоге, которому вы не доверяете, и команда не смогла спросить вас, доверяете ли вы ему. Например, стандартный ввод или стандартный вывод команды не является терминалом, потому что один из них перенаправлен или передан по конвейеру. Команда завершает работу с кодом 1:

2766 2942

2767```text theme={null}2943```text theme={null}

2768Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.2944Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.

2769```2945```

2770 2946

2771В вашем домашнем каталоге сообщение отличается, потому что диалог доверия рабочего пространства никогда не сохраняет доверие для домашнего каталога, поэтому принятие его там не может удовлетворить эту проверку. До версии 2.1.214 домашний каталог показывал сообщение выше, совет которого не может быть успешным там.2947Два варианта, которые также начинаются с `Error: Workspace not trusted.`, появляются и в терминале, который слишком мал для отображения того, что включает доверие к каталогу, или в терминале, который не сообщил свой размер. Увеличьте окно или переключитесь на обычное окно терминала, затем запустите `claude rc` снова.

2948

2949В вашем домашнем каталоге сообщение отличается, потому что диалог доверия рабочего пространства никогда не сохраняет доверие для домашнего каталога, поэтому принятие его там не может удовлетворить эту проверку. До версии v2.1.214 домашний каталог показывал сообщение выше, совет которого не может там сработать.

2772 2950

2773```text theme={null}2951```text theme={null}

2774Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).2952Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).

2775```2953```

2776 2954

2955Если вы ответите `n` или нажмёте Enter на вопрос [`Trust <directory>?`](/docs/ru/remote-control#requirements), команда выведет сообщение `Remote Control did not start`, которое указывает каталог и завершит работу с кодом 1. Запустите `claude rc` снова, чтобы ответить `y`.

2956

2777**Что делать:**2957**Что делать:**

2778 2958

2779* Запустите `claude` в каталоге, примите [диалог доверия рабочего пространства](/docs/ru/permissions#project-allow-rules-and-workspace-trust), затем запустите `claude remote-control` снова2959* Сначала доверьте каталогу из терминала: запустите `claude rc` там и ответьте `y`, или запустите `claude` там и примите [диалог доверия рабочего пространства](/docs/ru/permissions#project-allow-rules-and-workspace-trust), затем запустите вашу исходную команду снова

2780* В вашем домашнем каталоге перейдите в проектный каталог и запустите Remote Control там2960* В вашем домашнем каталоге перейдите в проектный каталог и запустите Remote Control там

2781 2961

2962До версии v2.1.284 команда никогда не спрашивала, даже в терминале.

2963

2782<h3 id="not-carried-over-to-the-sessions-remote-control-starts">2964<h3 id="not-carried-over-to-the-sessions-remote-control-starts">

2783 Не перенесено в сеансы, которые запускает Remote Control2965 Не перенесено в сеансы, которые запускает Remote Control

2784</h3>2966</h3>

2785 2967

2786Вы запустили [Remote Control](/docs/ru/remote-control) с глобальным флагом `claude` перед глаголом `remote-control`, флагом, который ограничивал бы или конфигурировал сеансы, которые запускает Remote Control, такие как `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` или `--mcp-config`. Флаг, размещённый перед глаголом, никогда не достигает этих сеансов. Claude Code отказывает запускаться вместо этого, указывая флаг:2968Вы запустили [Remote Control](/docs/ru/remote-control) с глобальным флагом `claude` перед глаголом `remote-control`, флагом, который ограничивал бы или конфигурировал сеансы, которые запускает Remote Control, такой как `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` или `--mcp-config`. Флаг, размещённый перед глаголом, никогда не достигает этих сеансов. Claude Code отказывает запуститься вместо этого, указывая флаг:

2787 2969

2788```text theme={null}2970```text theme={null}

2789Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).2971Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).

2790```2972```

2791 2973

2792Claude Code не отказывает глобальные флаги, которые безопасно удалить, такие как `--verbose`, `--model` или внедрённый оболочкой `--session-id` или `--plugin-dir`: он их игнорирует и Remote Control запускается.2974Claude Code не отказывает глобальные флаги, которые безопасно отбросить, такие как `--verbose`, `--model` или введённые оболочкой `--session-id` или `--plugin-dir`: он их игнорирует и Remote Control запускается.

2793 2975

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

2795 2977

2796**Что делать:**2978**Что делать:**

2797 2979

2798* Удалите флаг перед глаголом и передайте [собственные параметры Remote Control](/docs/ru/remote-control#start-a-remote-control-session) после него; `claude remote-control --help` их перечисляет2980* Удалите флаг перед глаголом и передайте [собственные параметры Remote Control](/docs/ru/remote-control#start-a-remote-control-session) после него; `claude remote-control --help` их перечисляет

2799* Когда отклонённый флаг — `--permission-mode`, запустите `claude remote-control --permission-mode <mode>` для установки режима разрешений для сеансов, которые запускает Remote Control2981* Когда отклонённый флаг — это `--permission-mode`, запустите `claude remote-control --permission-mode <mode>` для установки режима разрешений для сеансов, которые запускает Remote Control

2800 2982

2801До версии 2.1.248 `claude remote-control` не принимал свои флаги, когда глобальный флаг шёл первым, и команда не работала с ошибкой `unknown option`.2983До версии v2.1.248 `claude remote-control` не принимал свои флаги, когда глобальный флаг шёл первым, и команда не работала с ошибкой `unknown option`.

2802 2984

2803<h3 id="claude-import-is-not-yet-available-in-this-build">2985<h3 id="claude-import-is-not-yet-available-in-this-build">

2804 claude import ещё не доступен в этой сборке2986 claude import ещё недоступен в этой сборке

2805</h3>2987</h3>

2806 2988

2807Вы запустили [`claude import`](/docs/ru/cli-reference#cli-commands), и Claude Code обнаружил, что поток импорта отключен, поэтому команда выходит с кодом 1 вместо запуска импорта. До версии 2.1.222 сборка с отключённым потоком импорта рассматривала `import` как приглашение и запускала интерактивный сеанс вместо вывода этого сообщения.2989Вы запустили [`claude import`](/docs/ru/cli-reference#cli-commands), и Claude Code обнаружил, что поток импорта отключен, поэтому команда завершает работу с кодом 1 вместо запуска импорта. До версии v2.1.222 сборка с отключённым потоком импорта рассматривала `import` как приглашение и запускала интерактивный сеанс вместо вывода этого сообщения.

2808 2990

2809```text theme={null}2991```text theme={null}

2810`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.2992`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.

2813Claude Code включает `claude import` через флаг функции, который он получает от Anthropic и кэширует на диске. Это сообщение означает, что кэшированное значение отключено. Причина обычно одна из следующих:2995Claude Code включает `claude import` через флаг функции, который он получает от Anthropic и кэширует на диске. Это сообщение означает, что кэшированное значение отключено. Причина обычно одна из следующих:

2814 2996

2815* Вы не запустили сеанс с момента установки, поэтому Claude Code ещё не получил флаг. Первый `claude import` может вывести это даже когда функция доступна вам.2997* Вы не запустили сеанс с момента установки, поэтому Claude Code ещё не получил флаг. Первый `claude import` может вывести это даже когда функция доступна вам.

2816* Вы используете Claude Code через Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS, или через [шлюз приложений Claude](/docs/ru/claude-apps-gateway#availability-and-limitations). Claude Code не получает флаги функций в этих сеансах, поэтому `claude import` остаётся недоступным.2998* Вы используете Claude Code через Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS, или через [Claude apps gateway](/docs/ru/claude-apps-gateway#availability-and-limitations). Claude Code не получает флаги функций в этих сеансах, поэтому `claude import` остаётся недоступным.

2817* Вы установили `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` или [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars), которые отключают получение флагов функций, поэтому `claude import` остаётся недоступным.2999* Вы установили `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` или [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars), которые отключают получение флагов функций, поэтому `claude import` остаётся недоступным.

2818 3000

2819**Что делать:**3001**Что делать:**

2820 3002

2821* На свежей установке запустите `claude`, дождитесь загрузки сеанса, выйдите и запустите `claude import` снова3003* На свежей установке запустите `claude`, дождитесь загрузки сеанса, выйдите и запустите `claude import` снова

2822* Где получение флагов функций остаётся отключённым, установите конфигурацию самостоятельно: добавьте серверы MCP с помощью [`claude mcp add`](/docs/ru/mcp#installing-mcp-servers) и создайте [`CLAUDE.md` файлы](/docs/ru/memory#how-claude-md-files-load), [skills и команды](/docs/ru/skills#where-skills-live) и [подагентов](/docs/ru/sub-agents#choose-the-subagent-scope), которые вы хотите перенести. Сообщение также указывает `~/.claude/settings.json`. Из конфигурации, которую переносит `claude import`, этот файл содержит только [режим разрешений](/docs/ru/settings-reference#permission-settings); Claude Code не читает серверы MCP из него.3004* Где получение флагов функций остаётся отключённым, установите конфигурацию самостоятельно: добавьте серверы MCP с [`claude mcp add`](/docs/ru/mcp#installing-mcp-servers) и создайте [`CLAUDE.md` файлы](/docs/ru/memory#how-claude-md-files-load), [skills и команды](/docs/ru/skills#where-skills-live) и [подагентов](/docs/ru/sub-agents#choose-the-subagent-scope), которые вы хотите перенести. Сообщение также указывает `~/.claude/settings.json`. Из конфигурации, которую переносит `claude import`, этот файл содержит только [режим разрешений](/docs/ru/settings-reference#permission-settings); Claude Code не читает серверы MCP из него.

2823 3005

2824<h3 id="could-not-read-claude-code-config">3006<h3 id="could-not-read-claude-code-config">

2825 Не удалось прочитать конфигурацию Claude Code3007 Не удалось прочитать конфигурацию Claude Code

2826</h3>3008</h3>

2827 3009

2828Вы запустили [`claude import`](/docs/ru/cli-reference#cli-commands), пока Claude Code не мог анализировать `~/.claude.json`, файл, где он хранит вашу учётную запись и состояние для каждого проекта. Подкоманда читает этот файл для проверки доступности, но не показывает диалог восстановления, который показывает интерактивный сеанс, поэтому она выходит с кодом 1. До версии 2.1.222 `claude import` с нечитаемым файлом конфигурации запускал интерактивный сеанс, диалог восстановления которого обрабатывал файл.3010Вы запустили [`claude import`](/docs/ru/cli-reference#cli-commands) в то время как Claude Code не мог анализировать `~/.claude.json`, файл, где он хранит вашу учётную запись и состояние для каждого проекта. Подкоманда читает этот файл для проверки доступности, но не показывает диалог восстановления, который показывает интерактивный сеанс, поэтому завершает работу с кодом 1. До версии v2.1.222 `claude import` с нечитаемым файлом конфигурации запускал интерактивный сеанс, диалог восстановления которого обрабатывал файл.

2829 3011

2830```text theme={null}3012```text theme={null}

2831Could not read Claude Code config — run `claude` with no arguments to recover it.3013Could not read Claude Code config — run `claude` with no arguments to recover it.

2840 Не удалось импортировать сервер из Claude Desktop3022 Не удалось импортировать сервер из Claude Desktop

2841</h3>3023</h3>

2842 3024

2843Claude Code не смог добавить один из серверов, которые вы выбрали в `claude mcp add-from-claude-desktop`. Команда всё ещё импортирует другие выбранные серверы и выводит одну строку на сервер, который она не смогла добавить. До версии 2.1.205 первый сервер, который не прошёл, останавливал импорт и ни один из выбранных серверов не был добавлен.3025Claude Code не смог добавить один из серверов, которые вы выбрали в `claude mcp add-from-claude-desktop`. Команда всё ещё импортирует другие выбранные серверы и выводит одну строку на сервер, который не смог добавить. До версии v2.1.205 первый сервер, который не прошёл, останавливал импорт.

2844 3026

2845```text theme={null}3027```text theme={null}

2846Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3028Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

2847```3029```

2848 3030

2849Текст после имени сервера — это причина. Наиболее распространённая — проверка имени: Claude Desktop позволяет символы в именах серверов, такие как пробелы и точки, которые `claude mcp` ограничивает буквами, цифрами, дефисами и подчёркиваниями. Другие причины включают конфигурацию сервера, которая не проходит валидацию, и сервер, заблокированный [политикой MCP](/docs/ru/managed-mcp) вашей организации.3031Текст после имени сервера — это причина. Наиболее распространённая — это проверка имени: Claude Desktop позволяет символы в именах серверов, такие как пробелы и точки, которые `claude mcp` ограничивает буквами, цифрами, дефисами и подчёркиваниями. Другие причины включают конфигурацию сервера, которая не проходит валидацию, и сервер, заблокированный [политикой MCP](/docs/ru/managed-mcp) вашей организации.

2850 3032

2851**Что делать:**3033**Что делать:**

2852 3034

2853* Переименуйте сервер в `claude_desktop_config.json`, чтобы использовать только буквы, цифры, дефисы и подчёркивания, затем запустите `claude mcp add-from-claude-desktop` снова3035* Переименуйте сервер в `claude_desktop_config.json`, чтобы использовать только буквы, цифры, дефисы и подчёркивания, затем запустите `claude mcp add-from-claude-desktop` снова

2854* Добавьте этот сервер напрямую с помощью `claude mcp add` или `claude mcp add-json` под действительным именем. См. [Import MCP servers from Claude Desktop](/docs/ru/mcp#import-mcp-servers-from-claude-desktop).3036* Добавьте этот сервер напрямую с `claude mcp add` или `claude mcp add-json` под действительным именем. См. [Import MCP servers from Claude Desktop](/docs/ru/mcp#import-mcp-servers-from-claude-desktop).

2855 3037

2856<h3 id="cannot-add-mcp-server-to-the-managed-scope">3038<h3 id="cannot-add-mcp-server-to-the-managed-scope">

2857 Не удалось добавить сервер MCP в управляемую область3039 Не удалось добавить сервер MCP в управляемую область

2858</h3>3040</h3>

2859 3041

2860Вы запустили `claude mcp add` или `claude mcp add-json` с `--scope managed`. Эта область содержит серверы, которые ваша организация предоставляет через управляемый параметр [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers). Claude Code читает их только из управляемых параметров, поэтому команда не может записать сервер в эту область.3042Вы запустили `claude mcp add` или `claude mcp add-json` с `--scope managed`. Эта область содержит серверы, которые ваша организация предоставляет через управляемый параметр [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers). Claude Code читает их из управляемых параметров только, поэтому команда не может записать сервер в эту область.

2861 3043

2862```text theme={null}3044```text theme={null}

2863Cannot add MCP server to scope: managed3045Cannot add MCP server to scope: managed

2872 Не удалось прочитать .mcp.json3054 Не удалось прочитать .mcp.json

2873</h3>3055</h3>

2874 3056

2875Команда, которая читает проект [`.mcp.json`](/docs/ru/mcp#project-scope), такая как `claude mcp add` или `claude mcp add-json` с `--scope project` или `claude mcp remove`, обнаружила, что файл в вашем текущем каталоге не является обычным файлом или больше 2 MiB, поэтому она выходит с этой ошибкой вместо чтения файла.3057Команда, которая читает проект [`.mcp.json`](/docs/ru/mcp#project-scope), такая как `claude mcp add` или `claude mcp add-json` с `--scope project`, или `claude mcp remove`, обнаружила, что файл в вашем текущем каталоге не является обычным файлом или больше 2 MiB, поэтому завершает работу с этой ошибкой вместо чтения файла.

2876 3058

2877```text theme={null}3059```text theme={null}

2878Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.3060Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.

2879```3061```

2880 3062

2881До версии 2.1.257 FIFO в `.mcp.json` оставлял команду ждущей вечно без вывода, и символическая ссылка на файл устройства, такой как `/dev/zero`, увеличивала память до тех пор, пока процесс не был убит.3063До версии v2.1.257 FIFO в `.mcp.json` оставлял команду ждущей вечно без вывода, и символическая ссылка на файл устройства, такой как `/dev/zero`, увеличивала память до тех пор, пока процесс не был убит.

2882 3064

2883**Что делать:**3065**Что делать:**

2884 3066

2885* Проверьте, что находится в `.mcp.json` в вашем текущем каталоге. Замените его обычным файлом JSON в [формате проектной области](/docs/ru/mcp#project-scope) или удалите его, затем запустите команду снова.3067* Проверьте, что находится в `.mcp.json` в вашем текущем каталоге. Замените его обычным файлом JSON в [формате project-scope](/docs/ru/mcp#project-scope) или удалите его, затем запустите команду снова.

2886 3068

2887<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">3069<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">

2888 Сервер размещён Anthropic и не поддерживает локальный OAuth3070 Сервер размещён Anthropic и не поддерживает локальный OAuth

2889</h3>3071</h3>

2890 3072

2891Вы запустили вход для сервера MCP, чей URL указывает на размещённый Anthropic хост соединителя, который аутентифицируется через поставщика удостоверений третьей стороны. Эти хосты включают `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com` и `gcal.mcp.claude.com`. Claude Code отказывает запускать свой локальный поток OAuth для этих хостов как из панели `/mcp`, так и из `claude mcp login`, потому что [их вход работает только через claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai).3073Вы запустили вход для сервера MCP, чей URL указывает на хост соединителя, размещённый Anthropic, который аутентифицируется через поставщика идентификации третьей стороны. Эти хосты включают `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com` и `gcal.mcp.claude.com`. Claude Code отказывает запустить свой локальный поток OAuth для этих хостов как из панели `/mcp`, так и из `claude mcp login`, потому что [их вход работает только через claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai).

2892 3074

2893```text theme={null}3075```text theme={null}

2894"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.3076"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.

2895```3077```

2896 3078

2897Claude Code сопоставляет эти хосты по URL, поэтому сообщение появляется, когда сервер, который вы добавили с помощью `claude mcp add` или в `.mcp.json`, указывает на один из них.3079Claude Code сопоставляет эти хосты по URL, поэтому сообщение появляется, когда сервер, который вы добавили с `claude mcp add` или в `.mcp.json`, указывает на один из них.

2898 3080

2899**Что делать:**3081**Что делать:**

2900 3082

2901* Удалите вашу запись с помощью `claude mcp remove <name>`, чтобы она не могла скрыть соединитель claude.ai по тому же URL3083* Удалите вашу запись с `claude mcp remove <name>`, чтобы она не могла скрыть соединитель claude.ai по тому же URL

2902* После удаления подключите сервис на [claude.ai/customize/connectors](https://claude.ai/customize/connectors), пока вы вошли в учётную запись, которую вы используете в Claude Code. После подключения [соединитель появляется в Claude Code автоматически](/docs/ru/mcp#use-mcp-servers-from-claude-ai), если ваш активный метод аутентификации — это вход по подписке claude.ai3084* После удаления подключитесь к сервису на [claude.ai/customize/connectors](https://claude.ai/customize/connectors), пока вы вошли в учётную запись, которую вы используете в Claude Code. После подключения [соединитель появляется в Claude Code автоматически](/docs/ru/mcp#use-mcp-servers-from-claude-ai), если ваш активный метод аутентификации — это вход в подписку claude.ai

2903 3085

2904<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">3086<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">

2905 Сервер отклонил заголовок Authorization, созданный настроенным headersHelper3087 Сервер отклонил заголовок Authorization, созданный настроенным headersHelper

2911Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.3093Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.

2912```3094```

2913 3095

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

2915 3097

2916**Что делать:**3098**Что делать:**

2917 3099

2918* Запустите команду `headersHelper` самостоятельно так, как её запускает Claude Code: из [каталога, в котором Claude Code её запускает](/docs/ru/mcp#where-the-helper-runs), с [переменными окружения, которые Claude Code для неё устанавливает](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication), и без [переменных учётных данных, которые Claude Code удаляет](/docs/ru/mcp#which-variables-a-helper-can-read) для сервера из проектного `.mcp.json`, плагина или файла проектного агента. Проверьте, что она выводит значение `Authorization`, которое принимает конечная точка сервера3100* Запустите команду `headersHelper` самостоятельно так, как Claude Code её запускает: из [каталога, в котором Claude Code её запускает](/docs/ru/mcp#where-the-helper-runs), с [переменными окружения, которые Claude Code для неё устанавливает](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication), и без [переменных учётных данных, которые Claude Code удаляет](/docs/ru/mcp#which-variables-a-helper-can-read) для сервера из проекта `.mcp.json`, плагина или файла агента проекта. Проверьте, что она выводит значение `Authorization`, которое принимает конечная точка сервера

2919* После исправления помощника или его источника учётных данных выберите сервер в `/mcp` и выберите **Reconnect**3101* После исправления помощника или его источника учётных данных выберите сервер в `/mcp` и выберите **Reconnect**

2920 3102

2921До версии 2.1.248 Claude Code запускал обнаружение OAuth для сервера, чей помощник предоставлял заголовок `Authorization`. Это обнаружение могло не пройти с `Incompatible auth server: does not support dynamic client registration` вместо сообщения об отклонённом учётном данном.3103До версии v2.1.248 Claude Code запускал обнаружение OAuth для сервера, чей помощник предоставлял заголовок `Authorization`. Это обнаружение могло не пройти с `Incompatible auth server: does not support dynamic client registration` вместо сообщения об отклонённом учётном данном.

2922 3104

2923<h3 id="mcp-permission-prompt-tool-not-found">3105<h3 id="mcp-permission-prompt-tool-not-found">

2924 Инструмент запроса разрешения MCP не найден3106 Инструмент запроса разрешения MCP не найден

2925</h3>3107</h3>

2926 3108

2927Инструмент, который вы передали в [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags), не был среди подключённых инструментов MCP, когда запуск впервые нуждался в решении разрешения, либо потому, что его сервер никогда не подключался, либо потому, что ни один подключённый сервер не предоставляет инструмент с этим именем. Claude Code всё ещё отправляет ваше приглашение: [неинтерактивный](/docs/ru/headless) запуск выходит с этой ошибкой и кодом выхода 1 при первом вызове инструмента, который требует одобрения, поэтому он не выдаёт ответ, даже хотя запрос был сделан. Перед первым приглашением Claude Code ждёт до установленного для каждого сервера времени ожидания соединения в 30 секунд, установленного [`MCP_TIMEOUT`](/docs/ru/env-vars), чтобы этот сервер подключился. До версии 2.1.206 запуск не ждал завершения соединения сервера, поэтому медленно запускающийся, но здоровый сервер также выдавал эту ошибку.3109Инструмент, который вы передали в [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags), не был среди подключённых инструментов MCP, когда запуск впервые нуждался в решении разрешения, либо потому что его сервер никогда не подключался, либо потому что ни один подключённый сервер не предоставляет инструмент с этим именем. Claude Code всё ещё отправляет ваше приглашение: [неинтерактивный](/docs/ru/headless) запуск завершает работу с этой ошибкой и кодом выхода 1 при первом вызове инструмента, поэтому не выдаёт ответ, даже хотя запрос был сделан. Перед первым приглашением Claude Code ждёт до установленного на сервер времени ожидания соединения 30 секунд, установленного [`MCP_TIMEOUT`](/docs/ru/env-vars), чтобы этот сервер подключился. До версии v2.1.206 запуск не ждал завершения подключения сервера, поэтому медленно запускающийся, но здоровый сервер выдавал эту ошибку тоже.

2928 3110

2929```text theme={null}3111```text theme={null}

2930Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3112Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none

2931```3113```

2932 3114

2933Список после `Available MCP tools:` указывает инструменты MCP, которые были подключены, когда ожидание закончилось.3115Список после `Available MCP tools:` указывает инструменты MCP, которые были подключены.

2934 3116

2935**Что делать:**3117**Что делать:**

2936 3118

2942 Порт обратного вызова OAuth уже используется3124 Порт обратного вызова OAuth уже используется

2943</h3>3125</h3>

2944 3126

2945Когда вы входите на удалённый сервер MCP с помощью OAuth, Claude Code запускает локальный слушатель для получения обратного вызова входа. Если порт, который нужен этому слушателю, занят другим процессом, вход не удаётся с этим сообщением. Это в основном происходит с [фиксированным портом обратного вызова](/docs/ru/mcp#use-a-fixed-oauth-callback-port), установленным через переменную [`MCP_OAUTH_CALLBACK_PORT`](/docs/ru/env-vars) или `--callback-port`, так как без неё Claude Code выбирает доступный порт.3127Когда вы входите на удалённый сервер MCP с OAuth, Claude Code запускает локальный слушатель для получения обратного вызова входа. Если порт, который нужен этому слушателю, занят другим процессом, вход не работает с этим сообщением. Это в основном происходит с [фиксированным портом обратного вызова](/docs/ru/mcp#use-a-fixed-oauth-callback-port), установленным через переменную [`MCP_OAUTH_CALLBACK_PORT`](/docs/ru/env-vars) или `--callback-port`, так как без него Claude Code выбирает доступный порт.

2946 3128

2947```text theme={null}3129```text theme={null}

2948OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.3130OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.

2949```3131```

2950 3132

2951На Windows предлагаемая команда — `netstat -ano | findstr :<port>` вместо этого.3133На Windows предложенная команда вместо этого `netstat -ano | findstr :<port>`.

2952 3134

2953**Что делать:**3135**Что делать:**

2954 3136

2955* Запустите команду из сообщения, чтобы найти процесс, занимающий порт, и остановите его или дождитесь его завершения3137* Запустите команду из сообщения, чтобы найти процесс, занимающий порт, и остановите его или дождитесь его завершения

2956* Если другой программе постоянно нужен этот порт, зарегистрируйте другой URI перенаправления на сервере и установите его порт с помощью `MCP_OAUTH_CALLBACK_PORT` или `--callback-port`, в зависимости от того, что вы используете3138* Если другой программе постоянно нужен этот порт, зарегистрируйте другой URI перенаправления с сервером и установите его порт с `MCP_OAUTH_CALLBACK_PORT` или `--callback-port`, в зависимости от того, что вы используете

2957* Затем запустите вход снова, например выбрав сервер в `/mcp`3139* Затем запустите вход снова, например выбрав сервер в `/mcp`

2958 3140

2959<h3 id="no-available-ports-for-oauth-redirect">3141<h3 id="no-available-ports-for-oauth-redirect">

2960 Нет доступных портов для перенаправления OAuth3142 Нет доступных портов для перенаправления OAuth

2961</h3>3143</h3>

2962 3144

2963Когда вы входите на удалённый сервер MCP с помощью [OAuth](/docs/ru/mcp#authenticate-with-remote-mcp-servers), Claude Code запускает локальный слушатель для получения обратного вызова входа. Вход не удаётся с этим сообщением, когда Claude Code не может привязать локальный порт для него. Что-то на машине препятствует прослушиванию на `127.0.0.1`, например программное обеспечение безопасности или политика песочницы, которая запрещает локальные слушатели.3145Когда вы входите на удалённый сервер MCP с [OAuth](/docs/ru/mcp#authenticate-with-remote-mcp-servers), Claude Code запускает локальный слушатель для получения обратного вызова входа. Вход не работает с этим сообщением, когда Claude Code не может привязать локальный порт для него. Что-то на машине препятствует прослушиванию на `127.0.0.1`, например программное обеспечение безопасности или политика песочницы, которая запрещает локальные слушатели.

2964 3146

2965```text theme={null}3147```text theme={null}

2966No available ports for OAuth redirect3148No available ports for OAuth redirect

2967```3149```

2968 3150

2969До версии 2.1.268 Claude Code не переходил на порт, назначенный операционной системой, поэтому сообщение также появлялось, когда только его самостоятельно выбранные порты не могли быть привязаны. Это может произойти на хостах Windows, где Hyper-V резервирует диапазоны портов, которые охватывают порты, которые Claude Code выбирает.3151До версии v2.1.268 Claude Code не переходил на порт, назначенный операционной системой, поэтому сообщение также появлялось, когда только самостоятельно выбранные порты не могли быть привязаны. Это может произойти на хостах Windows, где Hyper-V резервирует диапазоны портов, которые охватывают порты, которые Claude Code выбирает.

2970 3152

2971**Что делать:**3153**Что делать:**

2972 3154

2977 /security-review не работает без origin/HEAD3159 /security-review не работает без origin/HEAD

2978</h3>3160</h3>

2979 3161

2980[`/security-review`](/docs/ru/commands#all-commands) создаёт контекст своего обзора, сравнивая вашу ветку с `origin/HEAD`, локальной ссылкой, которая записывает, какая ветка является стандартной на вашем удалённом `origin`. Когда эта ссылка не существует, команды git, которые собирают diff, не работают и обзор останавливается перед началом.3162[`/security-review`](/docs/ru/commands#all-commands) строит контекст своего обзора, сравнивая вашу ветку с `origin/HEAD`, локальной ссылкой, которая записывает, какая ветка является стандартной на вашем удалённом `origin`. Когда эта ссылка не существует, команды git, которые собирают diff, не работают и обзор останавливается перед началом.

2981 3163

2982```text theme={null}3164```text theme={null}

2983Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]3165Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]

2986'git <command> [<revision>...] -- [<file>...]'3168'git <command> [<revision>...] -- [<file>...]'

2987```3169```

2988 3170

2989Сообщение может цитировать `git log` или другой `git diff` вместо этого. Git создаёт `origin/HEAD` только когда удалённый объявляет стандартную ветку и ваша спецификация получения её охватывает, что полный `git clone` удалённого с коммитами делает. Ссылка отсутствует в этих установках:3171Сообщение может цитировать `git log` или другой `git diff` вместо этого. Git создаёт `origin/HEAD` только когда удалённый сервер объявляет стандартную ветку и ваш refspec получения её охватывает, что полный `git clone` удалённого с коммитами делает. Ссылка отсутствует в этих установках:

2990 3172

2991* Получение одной ветки или получение CI, которое получает слишком узкую спецификацию3173* Получение одной ветки или получение CI, которое получает слишком узкий refspec

2992* Удалённый, чей HEAD на стороне сервера указывает на ветку, которую никто не отправил3174* Удалённый сервер, чей HEAD на стороне сервера указывает на ветку, которую никто не отправил

2993* Репозиторий без удалённого `origin` или того, из которого вы никогда не получали3175* Репозиторий без удалённого `origin` или того, из которого вы никогда не получали

2994 3176

2995Claude Code показывает ту же ошибку для любого skill, который [внедряет динамический контекст](/docs/ru/skills#when-an-injected-command-fails), и неудачная внедрённая команда прерывает вызов этого skill. Две соседние строки срабатывают перед запуском команды вообще:3177Claude Code показывает ту же ошибку для любого skill, который [вводит динамический контекст](/docs/ru/skills#when-an-injected-command-fails), и неудачная введённая команда прерывает вызов этого skill. Две похожие строки срабатывают перед запуском команды вообще:

2996 3178

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

2998* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter skill требует bash на машине без него. Установите Git для Windows или измените frontmatter на `shell: powershell`. См. [How injected commands run](/docs/ru/skills#how-injected-commands-run)3180* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter skill требует bash на машине без него. Установите Git для Windows или измените frontmatter на `shell: powershell`. См. [How injected commands run](/docs/ru/skills#how-injected-commands-run)

2999 3181

3000**Что делать:**3182**Что делать:**

3001 3183

3002* Создайте ссылку, назвав стандартную ветку вашего удалённого: `git remote set-head origin <default-branch>`. Это работает всякий раз, когда существует локальная отслеживаемая ссылка `origin/<default-branch>`. Если её нет, как в клонах одной ветки, сначала получите ветку: запустите `git remote set-branches --add origin <branch>`, затем `git fetch origin`, затем повторно запустите команду set-head. Повторно запустите `/security-review`.3184* Создайте ссылку, назвав стандартную ветку вашего удалённого: `git remote set-head origin <default-branch>`. Это работает всякий раз, когда локальная отслеживающая ссылка `origin/<default-branch>` существует. Если её нет, как в клонах одной ветки, сначала получите ветку: запустите `git remote set-branches --add origin <branch>`, затем `git fetch origin`, затем повторно запустите команду set-head. Повторно запустите `/security-review`.

3003* Если вы предпочитаете не называть ветку, запустите `git fetch origin` и затем `git remote set-head origin --auto`, который спрашивает удалённый, какая ветка является его стандартной. Это не работает с `error: Cannot determine remote HEAD`, когда удалённый не объявляет стандартную ветку, потому что он пуст или его HEAD указывает на ветку, которую никто не отправил; вместо этого назовите ветку явно. Это не работает с `error: Not a valid ref`, когда ваш клон не получает эту ветку; сначала расширьте спецификацию, как выше.3185* Если вы предпочитаете не называть ветку, запустите `git fetch origin` и затем `git remote set-head origin --auto`, который спрашивает удалённый, какая ветка является его стандартной. Это не работает с `error: Cannot determine remote HEAD`, когда удалённый не объявляет стандартную ветку, потому что он пуст или его HEAD указывает на ветку, которую никто не отправил; вместо этого назовите ветку явно. Это не работает с `error: Not a valid ref`, когда ваш клон не получает эту ветку; сначала расширьте refspec как выше.

3004* Если репозиторий не имеет удалённого, добавьте один с помощью `git remote add origin <url>` и получите перед созданием ссылки. Если удалённый пуст, сначала отправьте вашу ветку с помощью `git push -u origin HEAD` и назовите эту ветку в команде set-head; `origin/HEAD` затем указывает на ветку, которую вы только что отправили, поэтому `/security-review` видит пустой diff, пока ветка не отличается от неё.3186* Если репозиторий не имеет удалённого, добавьте один с `git remote add origin <url>` и получите перед созданием ссылки. Если удалённый пуст, сначала отправьте вашу ветку с `git push -u origin HEAD` и назовите эту ветку в команде set-head; `origin/HEAD` затем указывает на ветку, которую вы только что отправили, поэтому `/security-review` видит пустой diff до тех пор, пока ветка не отличается от неё.

3005 3187

3006<h3 id="input-must-be-provided-when-using-print">3188<h3 id="input-must-be-provided-when-using-print">

3007 Входные данные должны быть предоставлены при использовании --print3189 Ввод должен быть предоставлен при использовании `--print`

3008</h3>3190</h3>

3009 3191

3010Bare `claude` нужен stdout, чтобы быть терминалом для запуска интерактивного UI. Когда stdout перенаправлен или консоль не является реальным терминалом, такой как PowerShell ISE и некоторые панели вывода IDE, `claude` вместо этого работает [неинтерактивно](/docs/ru/headless). Это тот же режим, что и `claude -p`, который требует приглашение, поэтому сообщение указывает `--print` даже когда вы не передали флаг. Передача `-p`/`--print` без приглашения и ничего не передано на stdin выдаёт ту же ошибку везде.3192Bare `claude` нужен stdout, чтобы быть терминалом для запуска интерактивного UI. Когда stdout перенаправлен или консоль не является реальным терминалом, такой как PowerShell ISE и некоторые панели вывода IDE, `claude` запускает [неинтерактивно](/docs/ru/headless) вместо этого. Это тот же режим, что и `claude -p`, который требует приглашение, поэтому сообщение указывает `--print` даже когда вы не передали флаг. Передача `-p`/`--print` без приглашения и ничего не передано на stdin выдаёт ту же ошибку везде.

3011 3193

3012```text theme={null}3194```text theme={null}

3013Error: Input must be provided either through stdin or as a prompt argument when using --print3195Error: Input must be provided either through stdin or as a prompt argument when using --print

3016**Что делать:**3198**Что делать:**

3017 3199

3018* Для интерактивного использования запустите `claude` в реальном терминале: Windows Terminal или консоль PowerShell вместо ISE и интегрированный терминал вашего IDE вместо панели вывода3200* Для интерактивного использования запустите `claude` в реальном терминале: Windows Terminal или консоль PowerShell вместо ISE и интегрированный терминал вашего IDE вместо панели вывода

3019* Для одноразового использования передайте приглашение: `claude -p "your question"` или передайте его с помощью `echo "your question" | claude -p`3201* Для одноразового использования передайте приглашение: `claude -p "your question"` или передайте его с `echo "your question" | claude -p`

3020 3202

3021<h3 id="input-contained-only-whitespace">3203<h3 id="input-contained-only-whitespace">

3022 Входные данные содержали только пробелы3204 Ввод содержал только пробелы

3023</h3>3205</h3>

3024 3206

3025В [неинтерактивном режиме](/docs/ru/headless) Claude Code отказывает приглашение, состоящее полностью из пробелов, табуляций или новых строк вместо его отправки, потому что API отклоняет сообщения без видимого текста. Какое сообщение вы видите, зависит от того, откуда пришло пустое приглашение:3207В [неинтерактивном режиме](/docs/ru/headless) Claude Code отказывает приглашению, состоящему полностью из пробелов, табуляций или новых строк вместо его отправки, потому что API отклоняет сообщения без видимого текста. Какое сообщение вы видите, зависит от того, откуда пришло пустое приглашение:

3026 3208

3027* **Аргумент приглашения или передача stdin для `claude -p`**: `claude` выходит с `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`3209* **Аргумент приглашения или передача stdin для `claude -p`**: `claude` завершает работу с `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`

3028* **Сообщение, отправленное работающему сеансу `--input-format stream-json` или [Agent SDK](/docs/ru/agent-sdk/overview)**: Claude Code заканчивает ход без вызова модели и сеанс остаётся пригодным. Отказ приходит как информационное сообщение и как текст результата хода: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`3210* **Сообщение, отправленное в работающий сеанс `--input-format stream-json` или [Agent SDK](/docs/ru/agent-sdk/overview)**: Claude Code заканчивает ход без вызова модели и сеанс остаётся пригодным. Отказ приходит как информационное сообщение и как текст результата хода: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`

3029 3211

3030До версии 2.1.229 Claude Code отправлял сообщение только с пробелами в API, который отклонял запрос с ошибкой 400.3212До версии v2.1.229 Claude Code отправлял сообщение только с пробелами в API, который отклонял запрос с ошибкой 400.

3031 3213

3032**Что делать:**3214**Что делать:**

3033 3215

3034* Включите видимый текст в приглашение. Если скрипт создаёт приглашение из переменной или файла, проверьте, что источник не пуст перед вызовом Claude Code.3216* Включите видимый текст в приглашение. Если скрипт строит приглашение из переменной или файла, проверьте, что источник не пуст перед вызовом Claude Code.

3035 3217

3036<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">3218<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">

3037 stream-json входные данные содержали более 256M символов без новой строки3219 stream-json ввод содержал более 256M символов без новой строки

3038</h3>3220</h3>

3039 3221

3040Ваша программа отправила более 268,435,456 символов на stdin без новой строки в запуск `claude -p --input-format stream-json`, поэтому Claude Code выводит эту ошибку на stderr и выходит с кодом 1 вместо буферизации дополнительного входа. Сообщение указывает этот бюджет как `256M`. До версии 2.1.257 Claude Code буферизировал такой вход без ограничений, увеличивая память до тех пор, пока процесс не падал или не был убит.3222Ваша программа отправила более 268,435,456 символов на stdin без новой строки в запуск `claude -p --input-format stream-json`, поэтому Claude Code выводит эту ошибку на stderr и завершает работу с кодом 1 вместо буферизации большего ввода. Сообщение указывает этот бюджет как `256M`. До версии v2.1.257 Claude Code буферизировал такой ввод без ограничений, увеличивая память до тех пор, пока процесс не упал или не был убит.

3041 3223

3042```text theme={null}3224```text theme={null}

3043Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.3225Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.

3044```3226```

3045 3227

3046Входные данные такой длины без новой строки обычно означают, что производитель вообще не является производителем stream-json, такой как двоичный файл или простой вывод журнала, случайно передаваемый. Одно сообщение сверх бюджета не проходит ту же проверку.3228Ввод такой длины без новой строки обычно означает, что производитель вообще не является производителем stream-json, такой как двоичный файл или простой вывод журнала, передаваемый случайно. Одно сообщение сверх бюджета не проходит ту же проверку.

3047 3229

3048**Что делать:**3230**Что делать:**

3049 3231

3050* Проверьте, что передаётся на stdin. С [`--input-format stream-json`](/docs/ru/cli-reference#cli-flags) каждое сообщение должно быть одной строкой JSON, завершённой новой строкой3232* Проверьте, что передаётся на stdin. С [`--input-format stream-json`](/docs/ru/cli-reference#cli-flags) каждое сообщение должно быть одной строкой JSON, завершённой новой строкой

3051* Чтобы вместо этого отправить простой текст, удалите `--input-format stream-json`; `claude -p` по умолчанию читает простой текстовый запрос из stdin3233* Чтобы отправить простой текст вместо этого, удалите `--input-format stream-json`; `claude -p` читает простой текстовый запрос из stdin по умолчанию

3052 3234

3053<h3 id="unknown-command">3235<h3 id="unknown-command">

3054 Неизвестная команда3236 Неизвестная команда

3055</h3>3237</h3>

3056 3238

3057В интерактивном сеансе терминала вы отправили имя `/`, которое не соответствует никакой команде в этом сеансе, поэтому Claude Code сообщает имя вместо запуска чего-либо:3239В интерактивном сеансе терминала вы отправили имя `/`, которое не соответствует ни одной команде в этом сеансе, поэтому Claude Code сообщает имя вместо запуска чего-либо:

3058 3240

3059```text theme={null}3241```text theme={null}

3060Unknown command: /hepl. Did you mean /help?3242Unknown command: /hepl. Did you mean /help?

3061```3243```

3062 3244

3063Claude Code предлагает ближайшее имя команды или псевдоним, который меню перечисляет в этом сеансе. Когда ничего не близко, сообщение заканчивается после имени. Причина обычно одна из следующих:3245Claude Code предлагает ближайшее имя команды или псевдоним, который меню указывает в этом сеансе. Когда ничего не близко, сообщение заканчивается после имени. Причина обычно одна из следующих:

3064 3246

3065* Опечатка, такая как `/hepl` для `/help`. [How the command menu matches what you type](/docs/ru/commands#how-the-command-menu-matches-what-you-type) охватывает выбор близкого совпадения перед отправкой3247* Опечатка, такая как `/hepl` для `/help`. [How the command menu matches what you type](/docs/ru/commands#how-the-command-menu-matches-what-you-type) охватывает выбор близкого совпадения перед отправкой

3066* Команда, которая существует, но недоступна в этом сеансе, потому что требование не выполнено, такое как ваша платформа, план или метод аутентификации. Записи устранения неполадок для [`/web-setup`](/docs/ru/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) и [`/schedule`](/docs/ru/routines#schedule-returns-unknown-command) проходят через два распространённых случая. Некоторые команды отвечают своим собственным сообщением, когда политика вашей организации их отключает, такие как [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)3248* Команда, которая существует, но недоступна в этом сеансе, потому что требование не выполнено, такое как ваша платформа, план или метод аутентификации. Записи устранения неполадок для [`/web-setup`](/docs/ru/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) и [`/schedule`](/docs/ru/routines#schedule-returns-unknown-command) проходят через два распространённых случая. Некоторые команды отвечают своим собственным сообщением, когда политика вашей организации их отключает, такие как [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)

3067* Команда из [плагина](/docs/ru/plugins/overview) или [сервера MCP](/docs/ru/mcp#use-mcp-prompts-as-commands), который не установлен или не подключен в этом сеансе3249* Команда из [плагина](/docs/ru/plugins/overview) или [сервера MCP](/docs/ru/mcp#use-mcp-prompts-as-commands), который не установлен или не подключен в этом сеансе

3068 3250

3069Claude Code отвечает на несовпадающее имя `/` этим способом только в интерактивном сеансе терминала. Во всех остальных сеансах он отправляет приглашение Claude как обычное сообщение вместо этого, с примечанием, что команда не запустилась и список команд, которые Claude может запустить в сеансе. Эти сеансы включают:3251Claude Code отвечает на несовпадающее имя `/` таким образом только в интерактивном сеансе терминала. В каждом другом сеансе он отправляет приглашение Claude как обычное сообщение вместо этого, с примечанием, что команда не запустилась и список команд, которые Claude может запустить в сеансе. Эти сеансы включают:

3070 3252

3071* Запуски `-p`3253* запуски `-p`

3072* Приложения [Agent SDK](/docs/ru/agent-sdk/overview)3254* приложения [Agent SDK](/docs/ru/agent-sdk/overview)

3073* Вкладка Code [Desktop app](/docs/ru/desktop)3255* вкладка Code [Desktop app](/docs/ru/desktop)

3074* Панель чата [VS Code extension](/docs/ru/vs-code)3256* панель чата [VS Code extension](/docs/ru/vs-code)

3075* [Облачные сеансы](/docs/ru/claude-code-on-the-web) и [рутины](/docs/ru/routines)3257* [облачные сеансы](/docs/ru/claude-code-on-the-web) и [routines](/docs/ru/routines)

3076 3258

3077Для встроенной команды, которая не может работать в одном из этих сеансов, Claude Code всё ещё отвечает, что команда недоступна вместо отправки её Claude. До версии 2.1.274 только облачные сеансы и рутины отправляли несовпадающее имя Claude. До версии 2.1.273 они также отвечали `Unknown command`.3259Для встроенной команды, которая не может запуститься в одном из этих сеансов, Claude Code всё ещё отвечает, что команда недоступна вместо отправки её Claude. До версии v2.1.274 только облачные сеансы и routines отправляли несовпадающее имя Claude. До версии v2.1.273 они также отвечали `Unknown command`.

3078 3260

3079Claude Code не рассматривает каждое приглашение, которое начинается с `/`, как команду. Он отправляет приглашение Claude как обычное сообщение, когда первое слово после `/` начинается с пунктуации, такой как `/--`, который открывает комментарий документа Lean, или является путём, такой как `/var/log/syslog`.3261Claude Code не рассматривает каждое приглашение, которое начинается с `/`, как команду. Он отправляет приглашение Claude как обычное сообщение, когда первое слово после `/` начинается с пунктуации, такой как `/--`, который открывает комментарий Lean doc, или является путём, такой как `/var/log/syslog`.

3080 3262

3081До версии 2.1.236, если вы нажали `Enter`, пока меню команд перечисляло близкое совпадение для имени, которое вы ввели, Claude Code запускал это совпадение, поэтому опечатка, такая как `/hepl`, запускала `/help` вместо выдачи этого сообщения.3263До версии v2.1.236, если вы нажали `Enter` в то время как меню команд указывало близкое совпадение для имени, которое вы ввели, Claude Code запускал это совпадение, поэтому опечатка, такая как `/hepl`, запускала `/help` вместо выдачи этого сообщения.

3082 3264

3083**Что делать:**3265**Что делать:**

3084 3266

3085* Запустите предложенное имя или введите `/` с последующей частью имени, чтобы увидеть, что доступно в этом сеансе3267* Запустите предложенное имя или введите `/` с последующей частью имени, чтобы увидеть, что доступно в этом сеансе

3086* Если Claude Code сообщает задокументированную команду как неизвестную, проверьте её строку в [справочнике команд](/docs/ru/commands) для требования, которое она указывает3268* Если Claude Code сообщает о документированной команде как неизвестной, проверьте её строку в [справочнике команд](/docs/ru/commands) для требования, которое она указывает

3087 3269

3088<h3 id="diff-is-too-large-for-ultrareview">3270<h3 id="diff-is-too-large-for-ultrareview">

3089 Diff слишком большой для ultrareview3271 Diff слишком большой для ultrareview

3090</h3>3272</h3>

3091 3273

3092Diff между вашей веткой и базовой веткой, включая незафиксированные и поставленные в очередь изменения, превышает ограничения размера для [ultrareview](/docs/ru/ultrareview), поэтому `/code-review ultra` и подкоманда `claude ultrareview` отказывают обзор перед запуском облачного сеанса. Отклонённый обзор не использует бесплатный запуск и не выставляет счёт за использование кредитов. Сообщение указывает действующие ограничения, размер вашего diff и файлы, которые вносят наибольшее количество изменённых строк. До версии 2.1.216 сообщение показывало только необработанную статистику diff.3274Diff между вашей веткой и базовой веткой, включая незафиксированные и поставленные в очередь изменения, превышает лимиты размера для [ultrareview](/docs/ru/ultrareview), поэтому `/code-review ultra` и подкоманда `claude ultrareview` отказывают обзор перед запуском облачного сеанса. Отклонённый обзор не использует бесплатный запуск и не выставляет счёт за кредиты использования. Сообщение указывает действующие лимиты, размер вашего diff и файлы, которые вносят наибольшее количество изменённых строк. До версии v2.1.216 сообщение показывало только необработанную статистику diff.

3093 3275

3094```text theme={null}3276```text theme={null}

3095Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.3277Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.

3096```3278```

3097 3279

3098Обзор запроса на слияние применяет те же ограничения; эта форма сообщения начинается с `PR #<N> is too large for ultrareview` и указывает количество файлов и строк PR.3280Обзор pull request применяет те же лимиты; эта форма сообщения начинается с `PR #<N> is too large for ultrareview` и указывает количество файлов и строк PR.

3099 3281

3100**Что делать:**3282**Что делать:**

3101 3283

3102* Передайте базовую ветку ближе к вашей работе, такую как `/code-review ultra develop`, чтобы обзор охватывал только diff против этой ветки3284* Передайте базовую ветку ближе к вашей работе, такую как `/code-review ultra develop`, поэтому обзор охватывает только diff против этой ветки

3103* Разделите изменение на меньшие ветки и обзорьте каждую. Файлы, которые сообщение указывает, вносят наибольшее количество изменённых строк, поэтому начните с перемещения их в свою собственную ветку.3285* Разделите изменение на меньшие ветки и обзорьте каждую. Файлы, которые сообщение указывает, вносят наибольшее количество изменённых строк, поэтому начните с перемещения их в свою собственную ветку.

3104 3286

3105<h3 id="could-not-find-merge-base-with-the-base-branch">3287<h3 id="could-not-find-merge-base-with-the-base-branch">

3106 Не удалось найти merge-base с базовой веткой3288 Не удалось найти merge-base с базовой веткой

3107</h3>3289</h3>

3108 3290

3109`/code-review ultra` и подкоманда `claude ultrareview` обзорят diff между вашей веткой и базовой веткой, что требует коммита, который они оба разделяют. Когда `git merge-base` не находит ни одного, Claude Code отказывает обзор перед запуском облачного сеанса. На клоне, который Claude Code может проверить как полный, с по крайней мере одной веткой, он переходит на [обзор каждого отслеживаемого файла](/docs/ru/ultrareview#diff-limits-and-fallbacks) вместо отказа. Вы видите этот отказ, когда базовую ветку вообще не удалось найти, когда Claude Code не может проверить, что ваш клон полный, или в редком репозитории, где diff всего дерева невозможен, такой как формат объекта SHA-256.3291`/code-review ultra` и подкоманда `claude ultrareview` обзорят diff между вашей веткой и базовой веткой, что требует коммита, который два разделяют. Когда `git merge-base` не находит ни одного, Claude Code отказывает обзор перед запуском облачного сеанса. На клоне, который Claude Code может проверить как полный, с по крайней мере одной веткой, он переходит на [обзор каждого отслеживаемого файла](/docs/ru/ultrareview#diff-limits-and-fallbacks) вместо отказа. Вы видите этот отказ, когда базовая ветка вообще не может быть найдена, когда Claude Code не может проверить, что ваш клон полный, или в редком репозитории, где diff всего дерева невозможен, такой как формат объекта SHA-256.

3110 3292

3111```text theme={null}3293```text theme={null}

3112Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.3294Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.

3116 3298

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

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

3119* **Вы передали базовую ветку, которой не было в вашем клоне**: 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 не может сказать, полный ли ваш клон, он предлагает `git fetch --unshallow origin` вместо этого. До версии 2.1.221 подсказка предлагала `git fetch --unshallow origin` для каждой полученной базовой ветки, и на полном клоне эта команда не работает с `fatal: --unshallow on a complete repository does not make sense`.3301* **Вы передали базовую ветку, которой не было в вашем клоне**: 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 не может сказать, полный ли ваш клон, он предлагает `git fetch --unshallow origin` вместо этого. До версии v2.1.221 подсказка предлагала `git fetch --unshallow origin` для каждой полученной базовой ветки, и на полном клоне эта команда не работает с `fatal: --unshallow on a complete repository does not make sense`.

3120 3302

3121**Что делать:**3303**Что делать:**

3122 3304

3123* Если другая ветка является вашей реальной базой, передайте её явно: `/code-review ultra <branch>`3305* Если другая ветка является вашей реальной базой, передайте её явно: `/code-review ultra <branch>`

3124* Если ваш клон может не иметь полной истории, запустите `git fetch --unshallow origin` и повторно запустите обзор3306* Если ваш клон может не иметь полную историю, запустите `git fetch --unshallow origin` и повторно запустите обзор

3125 3307

3126<h3 id="your-checkout-has-no-branches">3308<h3 id="your-checkout-has-no-branches">

3127 Ваш checkout не имеет веток3309 Ваш checkout не имеет веток

3128</h3>3310</h3>

3129 3311

3130Checkout может иметь коммиты, но не иметь веток: если вы запустите `git init`, затем `git fetch <url>` и `git checkout FETCH_HEAD`, вы получите отсоединённый HEAD без ссылок. Claude Code упаковывает ваш репозиторий как git bundle для загрузки его для [ultrareview](/docs/ru/ultrareview), и он не может упаковать репозиторий, который не имеет веток или других ссылок, поэтому `/code-review ultra` и подкоманда `claude ultrareview` отказывают обзор перед запуском облачного сеанса.3312Checkout может иметь коммиты, но не иметь веток: если вы запустите `git init` с последующим `git fetch <url>` и `git checkout FETCH_HEAD`, вы получите отсоединённый HEAD без ссылок. Claude Code упаковывает ваш репозиторий как git bundle для загрузки его для [ultrareview](/docs/ru/ultrareview), и он не может упаковать репозиторий, который не имеет веток или других ссылок, поэтому `/code-review ultra` и подкоманда `claude ultrareview` отказывают обзор перед запуском облачного сеанса.

3131 3313

3132```text theme={null}3314```text theme={null}

3133Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.3315Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.

3134```3316```

3135 3317

3136До версии 2.1.221 Claude Code пытался обзорить каждый отслеживаемый файл в этом checkout, и загрузка не работала.3318До версии v2.1.221 Claude Code пытался обзорить каждый отслеживаемый файл в этом checkout, и загрузка не работала.

3137 3319

3138**Что делать:**3320**Что делать:**

3139 3321

3140* Создайте ветку в вашем текущем коммите с помощью `git checkout -b <name>`, затем повторно запустите обзор3322* Создайте ветку в вашем текущем коммите с `git checkout -b <name>`, затем повторно запустите обзор

3141 3323

3142<h3 id="no-github-account-is-connected-to-your-claude-account">3324<h3 id="no-github-account-is-connected-to-your-claude-account">

3143 Ни одна учётная запись GitHub не подключена к вашей учётной записи Claude3325 Ни один аккаунт GitHub не подключен к вашему аккаунту Claude

3144</h3>3326</h3>

3145 3327

3146Вы запустили `/code-review ultra <PR#>` или `claude ultrareview <PR#>`, и перед созданием облачного сеанса Claude Code спрашивает сервер, может ли [учётная запись GitHub, подключённая к вашей учётной записи Claude](/docs/ru/ultrareview#review-a-pull-request), достичь репозитория PR. Ни одна учётная запись не подключена или соединение истекло, поэтому облачный клон не удастся и Claude Code отказывает запуск. Claude Code не тратит бесплатный запуск и не выставляет счёт за использование кредитов для отклонённого запуска.3328Вы запустили `/code-review ultra <PR#>` или `claude ultrareview <PR#>`, и перед созданием облачного сеанса Claude Code спрашивает сервер, может ли [аккаунт GitHub, подключённый к вашему аккаунту Claude](/docs/ru/ultrareview#review-a-pull-request), достичь репозитория PR. Ни один аккаунт не подключен или соединение истекло, поэтому облачный клон не работал бы и Claude Code отказывает запуск. Claude Code не тратит бесплатный запуск и не выставляет счёт за кредиты использования для отклонённого запуска.

3147 3329

3148```text theme={null}3330```text theme={null}

3149Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).3331Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).

3150```3332```

3151 3333

3152Когда [`/web-setup`](/docs/ru/web-quickstart#connect-from-your-terminal) недоступна в вашем сеансе, сообщение указывает только ссылку claude.ai.3334Когда [`/web-setup`](/docs/ru/web-quickstart#connect-from-your-terminal) недоступен в вашем сеансе, сообщение указывает только ссылку claude.ai.

3153 3335

3154**Что делать:**3336**Что делать:**

3155 3337

3156* Запустите `/web-setup` для подключения вашего входа GitHub CLI к вашей учётной записи Claude или подключите учётную запись на [claude.ai/connect-github](https://claude.ai/connect-github)3338* Запустите `/web-setup` для подключения вашего входа GitHub CLI к вашему аккаунту Claude или подключите аккаунт на [claude.ai/connect-github](https://claude.ai/connect-github)

3157* Повторно запустите обзор через минуту после подключения3339* Повторно запустите обзор через минуту после подключения

3158 3340

3159До версии 2.1.248 Claude Code не проверял это перед запуском.3341До версии v2.1.248 Claude Code не проверял это перед запуском.

3160 3342

3161<h3 id="your-connected-github-account-cant-see-the-repository">3343<h3 id="your-connected-github-account-cant-see-the-repository">

3162 Ваша подключённая учётная запись GitHub не может видеть репозиторий3344 Ваш подключённый аккаунт GitHub не может видеть репозиторий

3163</h3>3345</h3>

3164 3346

3165Вы запустили `/code-review ultra <PR#>` или `claude ultrareview <PR#>`, и [учётная запись GitHub, подключённая к вашей учётной записи Claude](/docs/ru/ultrareview#review-a-pull-request), не может прочитать репозиторий PR, поэтому облачный клон не удастся и Claude Code отказывает запуск. Claude Code не тратит бесплатный запуск и не выставляет счёт за использование кредитов для отклонённого запуска.3347Вы запустили `/code-review ultra <PR#>` или `claude ultrareview <PR#>`, и [аккаунт GitHub, подключённый к вашему аккаунту Claude](/docs/ru/ultrareview#review-a-pull-request), не может прочитать репозиторий PR, поэтому облачный клон не работал бы и Claude Code отказывает запуск. Claude Code не тратит бесплатный запуск и не выставляет счёт за кредиты использования для отклонённого запуска.

3166 3348

3167```text theme={null}3349```text theme={null}

3168Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.3350Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.

3169```3351```

3170 3352

3171Когда [`/web-setup`](/docs/ru/web-quickstart#connect-from-your-terminal) недоступна в вашем сеансе, сообщение указывает только установку приложения.3353Когда [`/web-setup`](/docs/ru/web-quickstart#connect-from-your-terminal) недоступен в вашем сеансе, сообщение указывает только установку приложения.

3172 3354

3173**Что делать:**3355**Что делать:**

3174 3356

3175* Если ваш локальный CLI `gh` может прочитать репозиторий, запустите `/web-setup` для подключения этого входа к вашей учётной записи Claude3357* Если ваш локальный CLI `gh` может прочитать репозиторий, запустите `/web-setup` для подключения этого входа к вашему аккаунту Claude

3176* Повторно запустите обзор после изменения3358* Повторно запустите обзор после изменения

3177 3359

3178До версии 2.1.248 Claude Code не проверял это перед запуском.3360До версии v2.1.248 Claude Code не проверял это перед запуском.

3179 3361

3180<h3 id="the-github-app-preflight-failed-transiently">3362<h3 id="the-github-app-preflight-failed-transiently">

3181 Проверка GitHub App не прошла временно3363 Проверка GitHub App не прошла временно

3182</h3>3364</h3>

3183 3365

3184Вы запустили [облачный сеанс](/docs/ru/claude-code-on-the-web) из локального репозитория, и два шага не прошли вместе. Claude Code не смог создать или загрузить bundle вашего репозитория. Перед загрузкой он проверил, может ли облачный сервис клонировать репозиторий из GitHub, и вместо определённого ответа эта проверка закончилась ошибкой, которую повторная попытка могла бы очистить, такой как сетевая ошибка, тайм-аут или временная ошибка сервера. Полное сообщение начинается с того, что остановило bundle, например `Could not upload repo bundle (<error>)`, и заканчивается предложением проверки:3366Вы запустили [облачный сеанс](/docs/ru/claude-code-on-the-web) из локального репозитория, и два шага не прошли вместе. Claude Code не смог построить или загрузить bundle вашего репозитория. Перед загрузкой он проверил, может ли облачный сервис клонировать репозиторий из GitHub, и вместо определённого ответа эта проверка закончилась ошибкой, которую повторная попытка могла бы очистить, такой как ошибка сети, тайм-аут или временная ошибка сервера. Полное сообщение начинается с того, что остановило bundle, например `Could not upload repo bundle (<error>)`, и заканчивается предложением проверки:

3185 3367

3186```text theme={null}3368```text theme={null}

3187Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead3369Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead

3190**Что делать:**3372**Что делать:**

3191 3373

3192* Повторно запустите команду через момент. Когда проверка GitHub пройдёт, Claude Code может запустить сеанс из клона GitHub, поэтому неудачная загрузка больше не блокирует запуск3374* Повторно запустите команду через момент. Когда проверка GitHub пройдёт, Claude Code может запустить сеанс из клона GitHub, поэтому неудачная загрузка больше не блокирует запуск

3193* Если повторные попытки продолжают не работать, начало сообщения указывает, что остановило загрузку. Когда эта причина — что-то, что вы можете исправить, исправьте это, чтобы сеанс мог запуститься из вашего локального репозитория вместо этого3375* Если повторные попытки продолжают не работать, начало сообщения указывает, что остановило загрузку. Когда эта причина — это что-то, что вы можете исправить, исправьте это, чтобы сеанс мог запуститься из вашего локального репозитория вместо этого

3194 3376

3195До версии 2.1.251 Claude Code заканчивал сообщение с `Please set up GitHub on https://claude.ai/code` даже когда проверка GitHub не прошла только временно, и совет по настройке не может очистить временный отказ.3377До версии v2.1.251 Claude Code заканчивал сообщение с `Please set up GitHub on https://claude.ai/code` даже когда проверка GitHub не прошла только временно, и совет по установке не может очистить временный сбой.

3196 3378

3197<h3 id="github-isnt-connected-to-your-claude-account">3379<h3 id="github-isnt-connected-to-your-claude-account">

3198 GitHub не подключён к вашей учётной записи Claude3380 GitHub не подключен к вашему аккаунту Claude

3199</h3>3381</h3>

3200 3382

3201Вы запустили [облачный сеанс](/docs/ru/claude-code-on-the-web) из вашего локального репозитория, например с помощью `/autofix-pr`. Ни одна учётная запись GitHub не подключена к вашей учётной записи Claude, или соединение истекло, поэтому Claude Code отказывает запуск:3383Вы запустили [облачный сеанс](/docs/ru/claude-code-on-the-web) из вашего локального репозитория, например с `/autofix-pr`. Ни один аккаунт GitHub не подключен к вашему аккаунту Claude или соединение истекло, поэтому Claude Code отказывает запуск:

3202 3384

3203```text theme={null}3385```text theme={null}

3204GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github3386GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github

3205```3387```

3206 3388

3207Когда вы создаёте рутину с помощью [`/schedule`](/docs/ru/routines), то же сообщение появляется как примечание настройки, которое указывает репозиторий; примечание не блокирует создание рутины.3389Когда вы создаёте routine с [`/schedule`](/docs/ru/routines), то же сообщение появляется как примечание по установке, которое указывает репозиторий; примечание не блокирует создание routine.

3208 3390

3209**Что делать:**3391**Что делать:**

3210 3392

3211* Запустите `/web-setup` для подключения вашего входа GitHub CLI к вашей учётной записи Claude или подключите учётную запись на [claude.ai/connect-github](https://claude.ai/connect-github). См. [GitHub authentication options](/docs/ru/claude-code-on-the-web#github-authentication-options) для того, как они отличаются.3393* Запустите `/web-setup` для подключения вашего входа GitHub CLI к вашему аккаунту Claude или подключите аккаунт на [claude.ai/connect-github](https://claude.ai/connect-github). См. [GitHub authentication options](/docs/ru/claude-code-on-the-web#github-authentication-options) для того, как два отличаются.

3212* Повторно запустите команду через минуту после подключения3394* Повторно запустите команду через минуту после подключения

3213 3395

3214До версии 2.1.268 Claude Code сообщал об этом как о временном отказе проверки Claude GitHub App и предлагал повторить попытку или установить приложение; ни то, ни другое не подключает учётную запись GitHub.3396До версии v2.1.268 Claude Code сообщал об этом как о временном сбое проверки Claude GitHub App и предлагал повторить попытку или установить приложение; ни один не подключает аккаунт GitHub.

3215 3397

3216<h3 id="single-sign-on-authorization-needed">3398<h3 id="single-sign-on-authorization-needed">

3217 Требуется авторизация единого входа3399 Требуется авторизация единого входа

3218</h3>3400</h3>

3219 3401

3220Вы запустили [`/install-github-app`](/docs/ru/github-actions#quick-setup) и выбрали репозиторий, организация которого применяет единый вход SAML. Перед настройкой Claude Code проверяет ваш доступ к репозиторию с помощью GitHub CLI, и GitHub отказал эту проверку, потому что ваш токен `gh` ещё не авторизован для организации. Мастер показывает предупреждение с шагами для авторизации:3402Вы запустили [`/install-github-app`](/docs/ru/github-actions#quick-setup) и выбрали репозиторий, организация которого применяет SAML единый вход. Перед установкой Claude Code проверяет ваш доступ к репозиторию с GitHub CLI, и GitHub отклонил эту проверку, потому что ваш токен `gh` ещё не авторизован для организации. Мастер показывает предупреждение с шагами для авторизации:

3221 3403

3222```text theme={null}3404```text theme={null}

3223Single sign-on authorization needed3405Single sign-on authorization needed

3230* Если вы аутентифицируетесь с личным токеном доступа в `GH_TOKEN`, откройте [github.com/settings/tokens](https://github.com/settings/tokens), выберите **Configure SSO** на токене и авторизуйте организацию3412* Если вы аутентифицируетесь с личным токеном доступа в `GH_TOKEN`, откройте [github.com/settings/tokens](https://github.com/settings/tokens), выберите **Configure SSO** на токене и авторизуйте организацию

3231* Запустите `/install-github-app` снова3413* Запустите `/install-github-app` снова

3232 3414

3233До версии 2.1.273 Claude Code показывал предупреждение `Admin permissions required` для этого условия вместо этого.3415До версии v2.1.273 Claude Code показывал предупреждение `Admin permissions required` для этого условия вместо этого.

3234 3416

3235<h3 id="failed-to-resume-the-conversation">3417<h3 id="failed-to-resume-the-conversation">

3236 Не удалось возобновить разговор3418 Не удалось возобновить разговор

3237</h3>3419</h3>

3238 3420

3239Claude Code не смог прочитать или обработать сохранённую стенограмму для сеанса, который вы выбрали из [средства выбора `claude --resume`](/docs/ru/sessions#use-the-session-picker), поэтому он заканчивает процесс вместо продолжения в частично загруженном состоянии. Сообщение включает команду для повторной попытки:3421Claude Code не смог прочитать или обработать сохранённую стенограмму для сеанса, который вы выбрали из [`claude --resume` picker](/docs/ru/sessions#use-the-session-picker), поэтому он заканчивает процесс вместо продолжения в частично загруженном состоянии. Сообщение включает команду для повторной попытки:

3240 3422

3241```text theme={null}3423```text theme={null}

3242Failed to resume the conversation.3424Failed to resume the conversation.

3243Run claude --resume <session-id> to retry, or claude to start a new session.3425Run claude --resume <session-id> to retry, or claude to start a new session.

3244```3426```

3245 3427

3246Claude Code выходит с кодом 1 после показа сообщения. Средство выбора `/resume` внутри работающего сеанса сообщает `Failed to resume conversation` в разговоре вместо этого, и ваш текущий сеанс продолжает работать. До версии 2.1.216 неудачное возобновление из средства выбора `claude --resume` оставалось на спиннере `Resuming conversation…` бесконечно вместо показа этого сообщения.3428Claude Code завершает работу с кодом 1 после показа сообщения. Picker `/resume` внутри работающего сеанса сообщает `Failed to resume conversation` в разговоре вместо этого, и ваш текущий сеанс продолжает работать. До версии v2.1.216 неудачное возобновление из picker `claude --resume` оставалось на спиннере `Resuming conversation…` бесконечно вместо показа этого сообщения.

3247 3429

3248**Что делать:**3430**Что делать:**

3249 3431

3250* Запустите `claude --resume <session-id>` с ID сеанса из сообщения для повторной попытки3432* Запустите `claude --resume <session-id>` с ID сеанса из сообщения для повторной попытки

3251* Если каждая повторная попытка не работает так же, запустите `claude update` и возобновите снова. Версии до v2.1.275 не работают при возобновлении, когда сохранённая стенограмма содержит запись, которую они не могут прочитать.3433* Если каждая повторная попытка не работает так же, запустите `claude update` и возобновите снова. Версии до v2.1.275 не работают при возобновлении, когда сохранённая стенограмма содержит запись, которую они не могут прочитать.

3252* Если повторная попытка снова не работает, запустите `claude` для запуска нового сеанса3434* Если повторная попытка не работает снова, запустите `claude` для запуска нового сеанса

3253 3435

3254<h3 id="no-conversation-found-with-the-session-id">3436<h3 id="no-conversation-found-with-the-session-id">

3255 Разговор не найден с ID сеанса3437 Разговор не найден с ID сеанса

3261No conversation found with session ID: <session-id>3443No conversation found with session ID: <session-id>

3262```3444```

3263 3445

3264Claude Code выходит с кодом 1 после показа сообщения. Claude Code [ищет текущий проект первым, затем каждый другой проект на этой машине](/docs/ru/sessions#resume-a-session) для ID. До версии 2.1.223 поиск останавливался в текущем каталоге проекта и его git worktrees, поэтому возобновляется из каталога, в котором сеанс в последний раз работал.3446Claude Code завершает работу с кодом 1 после показа сообщения. Claude Code [ищет текущий проект сначала, затем каждый другой проект на этой машине](/docs/ru/sessions#resume-a-session) для ID. До версии v2.1.223 поиск остановился в текущем каталоге проекта и его git worktrees, поэтому возобновите из каталога, в котором сеанс в последний раз работал.

3265 3447

3266Распространённые причины:3448Распространённые причины:

3267 3449

3268* **Неправильно введённый ID**: для неинтерактивного запуска ID — это поле `session_id` вывода [`--output-format json`](/docs/ru/headless#get-structured-output)3450* **Неправильно введённый ID**: для неинтерактивного запуска ID — это поле `session_id` вывода [`--output-format json`](/docs/ru/headless#get-structured-output)

3269* **Удалённая стенограмма**: Claude Code удаляет стенограммы после [периода хранения](/docs/ru/sessions#where-transcripts-are-stored), 30 дней по умолчанию, следуя [правилам очистки хранения](/docs/ru/claude-directory#cleaned-up-automatically)3451* **Удалённая стенограмма**: Claude Code удаляет стенограммы после [периода хранения](/docs/ru/sessions#where-transcripts-are-stored), 30 дней по умолчанию, следуя [правилам очистки хранения](/docs/ru/claude-directory#cleaned-up-automatically)

3270* **Другая машина**: Claude Code хранит стенограммы локально, поэтому возобновляет сеанс на машине, где он работал3452* **Другая машина**: Claude Code хранит стенограммы локально, поэтому возобновите сеанс на машине, где он работал

3271* **Дублирующиеся копии**: если вы скопировали каталог проекта под `~/.claude/projects`, чтобы две стенограммы имели один и тот же ID, Claude Code сообщает это сообщение вместо возобновления одной копии произвольно3453* **Дублирующиеся копии**: если вы скопировали каталог проекта под `~/.claude/projects`, поэтому две стенограммы несут один и тот же ID, Claude Code сообщает это сообщение вместо возобновления одной копии произвольно

3272 3454

3273**Что делать:**3455**Что делать:**

3274 3456

3275* Для интерактивного сеанса откройте [средство выбора сеанса](/docs/ru/sessions#use-the-session-picker) с помощью `claude --resume` и нажмите `Ctrl+A` для расширения на каждый проект на этой машине, затем выберите сеанс3457* Для интерактивного сеанса откройте [picker сеанса](/docs/ru/sessions#use-the-session-picker) с `claude --resume` и нажмите `Ctrl+A` для расширения на каждый проект на этой машине, затем выберите сеанс

3276* Сеансы, созданные с помощью `claude -p` или [Agent SDK](/docs/ru/agent-sdk/overview), не появляются в средстве выбора, поэтому повторно проверьте ID против `session_id`, который выводит ваш исходный запуск3458* Сеансы, созданные с `claude -p` или [Agent SDK](/docs/ru/agent-sdk/overview), не появляются в picker, поэтому повторно проверьте ID против `session_id`, который выводит ваш исходный запуск

3459

3460<h3 id="windows-reported-an-error-ebadf">

3461 Windows сообщила об ошибке (EBADF) при чтении Claude Code файла стенограммы этого сеанса

3462</h3>

3463

3464Вы возобновили сеанс на Windows, его сохранённый [файл стенограммы](/docs/ru/sessions#where-transcripts-are-stored) открылся нормально, и чтение его затем не прошло с системной ошибкой EBADF. Системная ошибка не говорит, почему чтение не прошло, поэтому сообщение предлагает вероятные причины и что попробовать:

3465

3466```text theme={null}

3467Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.

3468```

3469

3470Сообщение следует за собственной строкой сбоя команды, такой как `Failed to resume session <session-id>`. Команда `claude --resume` или [`claude -p`](/docs/ru/headless) завершает работу с кодом 1 после показа. После `/resume` внутри сеанса ваш текущий сеанс продолжает работать.

3471

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

3473

3474* Исключите папку, которая содержит ваши стенограммы сеанса, из программного обеспечения, которое сканирует или перехватывает чтение файлов, такого как инструменты безопасности, шифрования или управления конечными точками. Стенограммы находятся под `%USERPROFILE%\.claude\projects` по умолчанию или под каталогом, который [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars) указывает

3475* Если вы не можете добавить исключение, добавьте Claude Code в разрешённые приложения этого программного обеспечения вместо этого

3476* Возобновите сеанс снова

3477

3478До версии v2.1.282 сбой пришёл без объяснения: `claude --resume <session-id>` закончился на `Failed to resume session <session-id>`, и запуск `-p` выводил только текст системной ошибки, такой как `Failed to resume session: EBADF: bad file descriptor, read`.

3277 3479

3278<h3 id="cannot-switch-renderers-in-this-session">3480<h3 id="cannot-switch-renderers-in-this-session">

3279 Не удалось переключить рендеры в этом сеансе3481 Не удалось переключить рендереры в этом сеансе

3280</h3>3482</h3>

3281 3483

3282Когда вы переключаете рендеры, Claude Code перезапускает свой процесс. Вы запустили [`/tui`](/docs/ru/fullscreen#enable-fullscreen-rendering) в сеансе, который Claude Code отказывает перезапускать, поэтому он не переключается и ничего не сохраняет. Какое сообщение вы видите, говорит вам причину:3484Когда вы переключаете рендереры, Claude Code перезапускает свой процесс. Вы запустили [`/tui`](/docs/ru/fullscreen#enable-fullscreen-rendering) в сеансе, который Claude Code отказывает перезапустить, поэтому он не переключается и ничего не сохраняет. Какое сообщение вы видите, говорит вам причину:

3283 3485

3284* `Cannot switch renderers while work is running in the background`: у вас есть фоновая работа, которая перезапуск бросит, такая как фоновая оболочка или подагент. Дождитесь завершения работы или остановите её с помощью [`/tasks`](/docs/ru/commands), затем запустите `/tui fullscreen` или `/tui default` снова3486* `Cannot switch renderers while work is running in the background`: у вас есть фоновая работа, которая перезапуск бросил бы, такая как фоновая оболочка или подагент. Дождитесь завершения работы или остановите её с [`/tasks`](/docs/ru/commands), затем запустите `/tui fullscreen` или `/tui default` снова

3285* `Cannot switch renderers in this session`: сеанс имеет ограничения, которые Claude Code не может передать перезапущенному процессу. До версии 2.1.234 Claude Code перезапускал в любом случае и повторно запущенный сеанс работал без них3487* `Cannot switch renderers in this session`: сеанс имеет ограничения, которые Claude Code не может передать перезапущенному процессу. До версии v2.1.234 Claude Code перезапускал в любом случае и перезапущенный сеанс работал без них

3286 3488

3287В сообщении об ограничениях часть в скобках указывает найденные ограничения Claude Code:3489В сообщении ограничений часть в скобках указывает найденные ограничения:

3288 3490

3289```text theme={null}3491```text theme={null}

3290Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.3492Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.

3292 3494

3293Каждая причина, которую сообщение может показать в скобках:3495Каждая причина, которую сообщение может показать в скобках:

3294 3496

3295* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: вы запустили сеанс с флагом, который Claude Code не передаёт обратно перезапущенному процессу. Эти флаги включают [`--system-prompt`](/docs/ru/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, список [`--tools`](/docs/ru/cli-reference#cli-flags), [`--setting-sources`](/docs/ru/cli-reference#cli-flags) и [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags)3497* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: вы запустили сеанс с флагом, который Claude Code не передаёт обратно перезапущенному процессу. Эти флаги включают [`--system-prompt`](/docs/ru/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, [`--tools`](/docs/ru/cli-reference#cli-flags) allowlist, [`--setting-sources`](/docs/ru/cli-reference#cli-flags) и [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags)

3296* `permission rules set for this session only`: [обновление разрешений](/docs/ru/hooks#permission-update-entries) из hook или вызывающего SDK добавило правила deny или ask с назначением `session`. Правила allow с областью сеанса не вызывают отказ. Перезапуск их удаляет, и Claude Code вместо этого запрашивает снова3498* `permission rules set for this session only`: [обновление разрешений](/docs/ru/hooks#permission-update-entries) из hook или вызывающего SDK добавило правила deny или ask с назначением `session`. Правила allow с областью сеанса не запускают отказ. Перезапуск их отбрасывает, и Claude Code вместо этого запрашивает снова

3297* `ask-before-running rules with no command-line form`: обновление разрешений из hook или вызывающего SDK добавило правила ask наряду с правилами, которые Claude Code передаёт обратно как `--allowed-tools` и `--disallowed-tools`. Флаг для правил ask не существует3499* `ask-before-running rules with no command-line form`: обновление разрешений из hook или вызывающего SDK добавило правила ask наряду с правилами, которые Claude Code передаёт обратно как `--allowed-tools` и `--disallowed-tools`. Ни один флаг не существует для правил ask

3298* `permission rules a command line cannot carry intact` и `added directories a command line cannot carry intact`: обновление разрешений добавило правило или путь каталога в середине сеанса. Командная строка перезапущенного процесса не может нести его текст как то же значение3500* `permission rules a command line cannot carry intact` и `added directories a command line cannot carry intact`: обновление разрешений добавило правило или путь каталога в середине сеанса. Командная строка перезапущенного процесса не может нести его текст как то же значение

3299 3501

3300**Что делать:**3502**Что делать:**

3305 Не удалось открыть Claude Desktop3507 Не удалось открыть Claude Desktop

3306</h3>3508</h3>

3307 3509

3308Вы запустили [`/desktop`](/docs/ru/desktop#coming-from-the-cli), или его псевдоним `/app`, и системная команда, которую Claude Code использует для открытия Claude Desktop, не работала. Сеанс остаётся в терминале.3510Вы запустили [`/desktop`](/docs/ru/desktop#coming-from-the-cli) или его псевдоним `/app`, и системная команда, которую Claude Code использует для открытия Claude Desktop, не прошла. Сеанс остаётся в терминале.

3309 3511

3310```text theme={null}3512```text theme={null}

3311Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and run /desktop again.3513Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and run /desktop again.

3314**Что делать:**3516**Что делать:**

3315 3517

3316* Откройте Claude Desktop самостоятельно, затем запустите `/desktop` снова3518* Откройте Claude Desktop самостоятельно, затем запустите `/desktop` снова

3317* Чтобы прочитать полный вывод ошибки этой команды, включите отладочное логирование с помощью `/debug`, запустите `/desktop` снова и проверьте журнал отладки3519* Чтобы прочитать полный вывод ошибки этой команды, включите отладочное логирование с `/debug`, запустите `/desktop` снова и проверьте журнал отладки

3318 3520

3319До версии 2.1.275 сообщение было `Failed to open Claude Desktop. Please try opening it manually.` и не говорило, что не прошло.3521До версии v2.1.275 сообщение было `Failed to open Claude Desktop. Please try opening it manually.` и не говорило, что не прошло.

3320 3522

3321<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3523<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3322 /terminal-setup оставил вашу раскладку клавиш Zed без изменений3524 /terminal-setup оставил вашу Zed keymap без изменений

3323</h3>3525</h3>

3324 3526

3325Вы запустили [`/terminal-setup`](/docs/ru/terminal-config#enter-multiline-prompts) в Zed, и Claude Code не смог завершить обновление вашего `keymap.json` Zed, поэтому он оставил файл как он был.3527Вы запустили [`/terminal-setup`](/docs/ru/terminal-config#enter-multiline-prompts) в Zed, и Claude Code не смог завершить обновление вашего Zed `keymap.json`, поэтому оставил файл как он был.

3326 3528

3327Каждое сообщение указывает путь к вашей раскладке и заканчивается блоком сочетания клавиш для добавления самостоятельно:3529Каждое сообщение указывает путь к вашей keymap и заканчивается блоком сочетания клавиш для добавления самостоятельно:

3328 3530

3329```text theme={null}3531```text theme={null}

3330Couldn't update your Zed keymap, so it was left unchanged.3532Couldn't update your Zed keymap, so it was left unchanged.

3335Первая строка сообщения указывает причину:3537Первая строка сообщения указывает причину:

3336 3538

3337* `Couldn't read your Zed keymap, so it was left unchanged.`: Claude Code не смог прочитать файл, например из-за разрешений файла3539* `Couldn't read your Zed keymap, so it was left unchanged.`: Claude Code не смог прочитать файл, например из-за разрешений файла

3338* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: файл прочитался хорошо, но не анализируется как массив блоков сочетаний клавиш, даже с разрешёнными комментариями `//` и запятыми в конце3540* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: файл прочитался нормально, но не анализируется как массив блоков сочетаний клавиш, даже с разрешёнными комментариями `//` и конечными запятыми

3339* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code не смог скопировать файл в резервную копию `.bak` рядом с ним, поэтому он ничего не изменил3541* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code не смог скопировать файл в резервную копию `.bak` рядом с ним, поэтому ничего не изменил

3340* `Couldn't update your Zed keymap, so it was left unchanged.`: объединённый результат не проверился как действительная раскладка, несущая сочетание, поэтому Claude Code отбросил его вместо записи. Блок сочетания с дублированным ключом может вызвать это3542* `Couldn't update your Zed keymap, so it was left unchanged.`: объединённый результат не проверился как действительная keymap, несущая сочетание клавиш, поэтому Claude Code отбросил его вместо записи. Блок сочетания клавиш с дублированным ключом может вызвать это

3341 3543

3342**Что делать:**3544**Что делать:**

3343 3545

3344* Скопируйте блок из сообщения в массив верхнего уровня в вашем `keymap.json` по пути, который указывает сообщение3546* Скопируйте блок из сообщения в массив верхнего уровня в вашем `keymap.json` по пути, который указывает сообщение

3345* Для `isn't a readable list of keybindings`, исправьте ошибку синтаксиса или сделайте значение верхнего уровня файла массивом, затем запустите `/terminal-setup` снова3547* Для `isn't a readable list of keybindings`, исправьте ошибку синтаксиса или сделайте значение верхнего уровня файла массивом, затем запустите `/terminal-setup` снова

3346 3548

3347До версии 2.1.247 `/terminal-setup` не мог анализировать раскладку Zed, которая использовала комментарии `//` или запятые в конце, и она заменила весь файл только своим собственным сочетанием, сообщая о сочетании как установленном. Чтобы восстановить раскладку, которую более ранняя версия заменила, используйте файл резервной копии `.bak`, описанный в разделе [Enter multiline prompts](/docs/ru/terminal-config#enter-multiline-prompts).3549До версии v2.1.247 `/terminal-setup` не мог анализировать Zed keymap, которая использовала комментарии `//` или конечные запятые, и она заменила весь файл только своим собственным сочетанием клавиш при сообщении о сочетании как установленном. Чтобы восстановить keymap, которую более ранняя версия заменила, используйте файл резервной копии `.bak`, описанный в [Enter multiline prompts](/docs/ru/terminal-config#enter-multiline-prompts).

3348 3550

3349<h3 id="skill-usage-reports-are-not-available-on-this-connection">3551<h3 id="skill-usage-reports-are-not-available-on-this-connection">

3350 Отчёты об использовании Skill недоступны на этом соединении3552 Отчёты об использовании Skill недоступны на этом соединении

3351</h3>3553</h3>

3352 3554

3353Вы запустили [`/skill-doctor`](/docs/ru/skills#find-unused-skills) через [Remote Control](/docs/ru/remote-control), с вашего телефона или браузера. Claude Code не отправляет отчёт об использовании skill через Remote Control и вместо этого отвечает этим сообщением:3555Вы запустили [`/skill-doctor`](/docs/ru/skills#find-unused-skills) через [Remote Control](/docs/ru/remote-control), с вашего телефона или браузера. Claude Code не отправляет отчёт об использовании skill через Remote Control и отвечает этим сообщением вместо этого:

3354 3556

3355```text theme={null}3557```text theme={null}

3356Skill usage reports are not available on this connection.3558Skill usage reports are not available on this connection.

3364 Пользовательские стили вывода не могут быть выбраны через Remote Control3566 Пользовательские стили вывода не могут быть выбраны через Remote Control

3365</h3>3567</h3>

3366 3568

3367Вы запустили [`/output-style`](/docs/ru/output-styles#change-your-output-style) из мобильного приложения или веб-версии через [Remote Control](/docs/ru/remote-control), или команда пришла в сообщении, переданном в сеанс. Потому что такой ход может не поступить от владельца учётной записи, Claude Code перечисляет и выбирает только [встроенные стили](/docs/ru/output-styles#built-in-output-styles) на нём и добавляет это уведомление всякий раз, когда команда перечисляет стили или не распознаёт имя, которое вы дали. Имя [пользовательского стиля](/docs/ru/output-styles#create-a-custom-output-style) получает тот же ответ, что и имя, которое не существует:3569Вы запустили [`/output-style`](/docs/ru/output-styles#change-your-output-style) из мобильного приложения или веб-приложения через [Remote Control](/docs/ru/remote-control) или команда пришла в сообщение, переданное в сеанс. Потому что такой ход может не поступить от владельца аккаунта, Claude Code указывает и выбирает только [встроенные стили](/docs/ru/output-styles#built-in-output-styles) на нём и добавляет это уведомление всякий раз, когда команда указывает стили или не признаёт имя, которое вы дали. Имя [пользовательского стиля](/docs/ru/output-styles#create-a-custom-output-style) получает тот же ответ, что и имя, которое не существует:

3368 3570

3369```text theme={null}3571```text theme={null}

3370Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.3572Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.

3373**Что делать:**3575**Что делать:**

3374 3576

3375* Выберите встроенный стиль, например `/output-style concise`3577* Выберите встроенный стиль, например `/output-style concise`

3376* Чтобы использовать пользовательский стиль, установите [`outputStyle`](/docs/ru/settings-reference#outputstyle) в `.claude/settings.local.json` проекта или запустите `/output-style <style>` в собственном терминале сеанса, если он у него есть3578* Чтобы использовать пользовательский стиль, установите [`outputStyle`](/docs/ru/settings-reference#outputstyle) в `.claude/settings.local.json` проекта или запустите `/output-style <style>` в собственном терминале сеанса, если он есть

3377 3579

3378<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">3580<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">

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

3380</h3>3582</h3>

3381 3583

3382Вы попытались переключить [стили вывода](/docs/ru/output-styles) с помощью `/output-style <style>` или `/config outputStyle=<style>` в сеансе, чьи источники параметров исключают `local`. Примеры — сеанс [Agent SDK](/docs/ru/agent-sdk/typescript), чьи [`settingSources`](/docs/ru/agent-sdk/typescript#options) оставляют `"local"` и сеанс CLI, запущенный с [`--setting-sources`](/docs/ru/cli-reference#cli-flags) значением, которое оставляет `local`. Обе команды сохраняют стиль в `.claude/settings.local.json`, файл, который такой сеанс никогда не читает обратно, поэтому Claude Code отказывает вместо записи параметра, который не будет иметь никакого эффекта:3584Вы попытались переключить [стили вывода](/docs/ru/output-styles) с `/output-style <style>` или `/config outputStyle=<style>` в сеансе, чьи источники параметров исключают `local`. Примеры — это сеанс [Agent SDK](/docs/ru/agent-sdk/typescript), чьи [`settingSources`](/docs/ru/agent-sdk/typescript#options) оставляют `"local"` и сеанс CLI, запущенный со значением [`--setting-sources`](/docs/ru/cli-reference#cli-flags), которое оставляет `local`. Обе команды сохраняют стиль в `.claude/settings.local.json`, файл, который такой сеанс никогда не читает обратно, поэтому Claude Code отказывает вместо записи параметра, который не имел бы эффекта:

3383 3585

3384```text theme={null}3586```text theme={null}

3385Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.3587Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.

3387 3589

3388**Что делать:**3590**Что делать:**

3389 3591

3390* Добавьте `local` к источникам параметров сеанса и переключитесь снова3592* Добавьте `local` в источники параметров сеанса и переключитесь снова

3391* Установите ключ [`outputStyle`](/docs/ru/settings-reference#outputstyle) в файле параметров, который сеанс загружает, такой как `.claude/settings.json` в проекте или `~/.claude/settings.json`. В TypeScript SDK установите `outputStyle` внутри встроенного объекта `settings` вместо этого; см. [Activate an output style](/docs/ru/agent-sdk/modifying-system-prompts#activate-an-output-style)3593* Установите ключ [`outputStyle`](/docs/ru/settings-reference#outputstyle) в файл параметров, который сеанс загружает, такой как `.claude/settings.json` в проекте или `~/.claude/settings.json`. В TypeScript SDK установите `outputStyle` внутри встроенного объекта `settings` вместо этого; см. [Activate an output style](/docs/ru/agent-sdk/modifying-system-prompts#activate-an-output-style)

3392 3594

3393<h2 id="plugin-errors">3595<h2 id="plugin-errors">

3394 Ошибки плагинов3596 Ошибки плагинов

3421 Marketplace is registered from an untrusted source3623 Marketplace is registered from an untrusted source

3422</h3>3624</h3>

3423 3625

3424Маркетплейс зарегистрирован под именем, которое [зарезервировано для официальных маркетплейсов Anthropic](/docs/ru/plugins/marketplace-reference#marketplace-file), но его зарегистрированный источник не является репозиторием GitHub `anthropics`. Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке или обновлении маркетплейса, поэтому маркетплейс и плагины, установленные из него, перестают загружаться. До версии v2.1.205 имя проверялось только при добавлении маркетплейса, поэтому запись, зарегистрированная до того, как её имя было зарезервировано, продолжала загружаться.3626Маркетплейс зарегистрирован под именем, которое [зарезервировано для официальных маркетплейсов Anthropic](/docs/ru/plugins/marketplace-reference#marketplace-file), но его зарегистрированный источник не является репозиторием GitHub `anthropics`. Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке или обновлении маркетплейса, поэтому маркетплейс и плагины, установленные из него, перестают загружаться. До версии v2.1.205 запись, зарегистрированная до того, как её имя было зарезервировано, продолжала загружаться.

3425 3627

3426```text theme={null}3628```text theme={null}

3427Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.3629Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

3458* Переименуйте маркетплейс на имя, которое не соответствует зарезервированному имени, и добавьте его снова3660* Переименуйте маркетплейс на имя, которое не соответствует зарезервированному имени, и добавьте его снова

3459* Для предупреждения об игнорируемой записи запустите команду `claude plugin marketplace remove`, которую оно даёт, или удалите запись из `~/.claude/plugins/known_marketplaces.json`3661* Для предупреждения об игнорируемой записи запустите команду `claude plugin marketplace remove`, которую оно даёт, или удалите запись из `~/.claude/plugins/known_marketplaces.json`

3460 3662

3663<h3 id="claude-code-refuses-the-marketplace-name">

3664 Claude Code refuses the marketplace name

3665</h3>

3666

3667Имя зарегистрированного маркетплейса [выдаёт себя за официальный маркетплейс Anthropic](/docs/ru/plugins/marketplace-reference#reserved-names) в соответствии с правилами, которые перечисляет этот раздел.

3668

3669Если маркетплейс был зарегистрирован под таким именем до того, как проверка его заблокировала, маркетплейс и плагины, установленные из него, перестают загружаться, потому что Claude Code проверяет имя каждый раз при чтении каталога маркетплейса. Когда имя имитирует официальное, `claude plugin list` и вкладка **Errors** в `/plugin` сообщают о каждом затронутом плагине с сообщением, которое начинается с:

3670

3671```text theme={null}

3672Claude Code refuses the marketplace name "anthropic-plugins-v2"

3673```

3674

3675Для имитирующего имени ошибка самого маркетплейса читается как `Claude Code refuses this marketplace's name: it looks like one of Anthropic's own` вместо этого. `claude plugin marketplace add` отказывает любому выдающему себя за имени с `Marketplace name impersonates an official Anthropic/Claude marketplace`.

3676

3677До версии v2.1.282 `claude plugin list` и `/plugin` сообщали о плагинах имитирующего имени как не загруженных, без указания имени маркетплейса как причины.

3678

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

3680

3681* Запустите `claude plugin marketplace remove <name>`. Это также удаляет плагины, установленные из маркетплейса, и удаляет их сохранённые данные

3682* Чтобы сохранить маркетплейс, дождитесь, пока его разработчик переименует его, затем запустите `claude plugin marketplace update <name>`

3683* Если вы публикуете маркетплейс, переименуйте его в вашем `marketplace.json`; пользователи затем обновят маркетплейс вместо его удаления

3684

3461<h3 id="marketplace-is-already-added-from-a-different-source">3685<h3 id="marketplace-is-already-added-from-a-different-source">

3462 Marketplace is already added from a different source3686 Marketplace is already added from a different source

3463</h3>3687</h3>

3660 3884

3661* Попросите администратора вашей организации claude.ai изменить статус обязательности плагина на claude.ai3885* Попросите администратора вашей организации claude.ai изменить статус обязательности плагина на claude.ai

3662 3886

3887<h3 id="plugin-was-not-uninstalled">

3888 Plugin was not uninstalled

3889</h3>

3890

3891Вы запустили [`claude plugin uninstall`](/docs/ru/plugins/cli-reference#plugin-uninstall), или выбрали **Uninstall** на вкладке `/plugin` **Installed**, и удаление остановилось с сообщением, начинающимся с `"<plugin>" was not uninstalled:`.

3892

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

3894

3895```text theme={null}

3896✘ Failed to uninstall plugin "formatter": "formatter" was not uninstalled: it is still switched on in /home/user/project/.claude/settings.local.json, although the settings change reported no error. It is still installed. Take it out of "enabledPlugins" in that file yourself, then uninstall it again.

3897```

3898

3899Середина сообщения называет файл и причину:

3900

3901* `it is still switched on in <file>, although the settings change reported no error`: запись параметров сообщила об успехе, но запись всё ещё там при чтении файла обратно

3902* `it is still switched on in <file>, and the settings change failed (<error>)`: файл не мог быть сохранён по причине в скобках

3903* `<file> is there and could not be read`: файл существует, но не мог быть прочитан как параметры, например потому что это не действительный JSON, поэтому он может всё ещё включить плагин

3904* `<file> (not read: it is on a network path or is a link to one, or could not be checked)`: Claude Code не прочитала файл параметров проекта или локальных параметров, потому что файл, или папка `.claude`, которая его содержит, это ссылка, которая ведёт на сетевое расположение, или потому что она не могла проверить этот путь

3905

3906`claude plugin uninstall` выходит с кодом 1, и с `--json` результат несёт `failureCode: "settings_still_on"`. `/plugin` показывает то же сообщение.

3907

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

3909

3910* Следуйте последнему предложению сообщения: исправьте или замените файл параметров, который оно называет, или удалите запись плагина из `enabledPlugins` в этом файле самостоятельно, затем запустите удаление снова

3911

3663<h2 id="tool-errors">3912<h2 id="tool-errors">

3664 Ошибки инструментов3913 Ошибки инструментов

3665</h2>3914</h2>

3709* Если Claude должен иметь возможность изменять файл, удалите или сузьте правило отказа `Read` в `/permissions` или в [параметрах](/docs/ru/settings-reference#permission-settings)3958* Если Claude должен иметь возможность изменять файл, удалите или сузьте правило отказа `Read` в `/permissions` или в [параметрах](/docs/ru/settings-reference#permission-settings)

3710* Если файл должен остаться нетронутым, сохраните правило и добавьте правило отказа `Edit` для того же пути, чтобы также заблокировать инструмент NotebookEdit3959* Если файл должен остаться нетронутым, сохраните правило и добавьте правило отказа `Edit` для того же пути, чтобы также заблокировать инструмент NotebookEdit

3711 3960

3961<h3 id="path-cannot-contain-null-bytes">

3962 Path cannot contain null bytes

3963</h3>

3964

3965Аргумент пути или шаблона вызова инструмента файла содержал нулевой байт, который файловые системы и инструменты поиска не могут принять. Read, Write, Edit, NotebookEdit, Glob и Grep проверяют это, и сообщение называет инструмент и аргумент:

3966

3967```text theme={null}

3968Read file_path cannot contain null bytes (\0). Remove the null byte and try again.

3969```

3970

3971Вызов инструмента не удаётся, Claude видит ошибку, и ход продолжается.

3972

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

3974

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

3976

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

3978

3712<h3 id="subagent-type-is-required">3979<h3 id="subagent-type-is-required">

3713 subagent\_type is required3980 subagent\_type is required

3714</h3>3981</h3>

3845 4112

3846До версии 2.1.236 Claude Code сообщал об этих отправках как отправленных. Получающий сеанс отбросил их непрочитанными.4113До версии 2.1.236 Claude Code сообщал об этих отправках как отправленных. Получающий сеанс отбросил их непрочитанными.

3847 4114

4115<h3 id="cross-session-message-dropped-at-the-inbox">

4116 Cross-session message was dropped at the recipient session's inbox

4117</h3>

4118

4119Claude отправил [кросс-сеансовое сообщение](/docs/ru/cross-session-messaging) другому вашему сеансу на этой машине, и входящие сообщения этого сеанса отбросили его перед тем, как Claude в этом сеансе прочитал его. Строка называет адрес получателя и, когда получатель дал причину, добавляет причину после дефиса:

4120

4121```text wrap theme={null}

4122Cross-session message was dropped at the recipient session's inbox (recipient: uds:/tmp/cc-socks/13605.sock) and not delivered — its queue of undelivered peer messages was full. Claude was told not to resend right away.

4123```

4124

4125Одна строка может охватывать несколько отброшенных сообщений. Затем она начинается во множественном числе, например `Cross-session messages (12) were dropped`. Чтобы найти, какому сеансу принадлежит адрес, сравните его с [`Peer address` строкой](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), которую `/status` показывает в каждом сеансе.

4126

4127После дефиса строка даёт одну или несколько из этих причин:

4128

4129* `its queue of undelivered peer messages was full`: получатель уже держал столько недоставленных сообщений от других сеансов, сколько его очередь позволяет

4130* `you sent faster than that session accepts`: сообщения отправляющего сеанса прибыли быстрее, чем получатель принимает от одного отправителя

4131* `it repeated your previous message`: сообщение было идентично тому, которое отправляющий сеанс отправил этому получателю незадолго до этого

4132* `a relay loop between sessions was cut`: сообщение продолжило цепь сеансов, отправляющих друг другу сообщения, и цепь прошла через получателя слишком много раз или выросла слишком длинной

4133

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

4135

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

4137* Если ваши сеансы отправляют друг другу частые обновления, попросите Claude отправлять меньше, более крупные сообщения, например один отчёт, когда сеанс завершает свою работу

4138* Для `a relay loop between sessions was cut` введите следующую инструкцию в один из сеансов самостоятельно. Сообщение, которое Claude отправляет в ответ на вашу собственную подсказку, начинает новую цепь

4139

4140До версии 2.1.238 отправляющий сеанс не получал отчёт, когда входящие сообщения получателя отбросили сообщение.

4141

3848<h3 id="refusing-to-send-a-cross-session-message">4142<h3 id="refusing-to-send-a-cross-session-message">

3849 Refusing to send a cross-session message4143 Refusing to send a cross-session message

3850</h3>4144</h3>

3859 4153

3860* `reply target is a symlink`: символическая ссылка находится на пути сокета целевого сеанса. Claude Code не доставляет через неё, потому что ссылка там может перенаправить сообщение на конечную точку, которую целевой сеанс не создавал.4154* `reply target is a symlink`: символическая ссылка находится на пути сокета целевого сеанса. Claude Code не доставляет через неё, потому что ссылка там может перенаправить сообщение на конечную точку, которую целевой сеанс не создавал.

3861* `cannot vet reply target`: Claude Code не смог проверить целевой путь вообще, например потому что чтение не удалось с ошибкой разрешения.4155* `cannot vet reply target`: Claude Code не смог проверить целевой путь вообще, например потому что чтение не удалось с ошибкой разрешения.

3862* `connected endpoint is not the expected process`: процесс, держащий сокет, не является сеансом, на который было адресовано сообщение, поэтому адрес устарел или другой процесс заменил сокет.

3863* `connected endpoint identity could not be read`: Claude Code подключился, но не смог прочитать, какой процесс держит другой конец, поэтому он не смог подтвердить цель. Это может быть временным.

3864* `connected endpoint is not owned by this user`: процесс, держащий сокет, работает под другой учётной записью пользователя, поэтому это не один из ваших сеансов.

3865* `connected endpoint owner could not be read`: Claude Code подключился, но не смог прочитать, какая учётная запись пользователя владеет другим концом, поэтому он не смог подтвердить, что конечная точка ваша.

3866* `connected endpoint is a different process with the expected pid`: ID процесса соответствует тому, на который было адресовано сообщение, но Claude Code не смог подтвердить, что это тот же процесс. Обычно этот сеанс вышел и операционная система переиспользовала его ID процесса, поэтому адрес устарел.

3867 4156

3868**Что делать:**4157**Что делать:**

3869 4158

3870* Обычно ничего: проверки предотвращают достижение сообщением конечной точки, отличной от сеанса, на который оно было адресовано, и ничего не было отправлено4159* Обычно ничего: проверки предотвращают достижение сообщением конечной точки, отличной от сеанса, на который оно было адресовано, и ничего не было отправлено

3871* Попросите Claude снова перечислить ваши сеансы и повторно отправить; отказ, вызванный устаревшим адресом, разрешается после того как Claude отправляет текущему

3872* Если `reply target is a symlink` повторяется для одного сеанса, проверьте, что создало ссылку на пути сокета этого сеанса, показанном в его `/status` под `Peer address`4160* Если `reply target is a symlink` повторяется для одного сеанса, проверьте, что создало ссылку на пути сокета этого сеанса, показанном в его `/status` под `Peer address`

3873* Для `connected endpoint identity could not be read`, повторно отправьте; условие может быть временным

3874* Если `connected endpoint is not owned by this user` появляется на общей машине, сеанс по этому адресу работает под учётной записью другого пользователя, поэтому Claude не может отправить ему сообщение из вашей

~~3875~~

3876До версии 2.1.248 Claude Code не проверял владельца конечной точки или время запуска процесса, поэтому отказы, которые называют эти проверки, не появляются в более ранних версиях.

3877 4161

3878<h3 id="refusing-after-a-symlink-changed">4162<h3 id="refusing-after-a-symlink-changed">

3879 Refusing to read, write, or search a path4163 Refusing to read, write, or search a path

3889 4173

3890* `its symlink resolution changed after permission was checked`: символическая ссылка вдоль пути или в корне поиска Grep или Glob была заменена между проверкой разрешения и операцией. В отказе чтения фраза в скобках называет, какое сравнение не удалось.4174* `its symlink resolution changed after permission was checked`: символическая ссылка вдоль пути или в корне поиска Grep или Glob была заменена между проверкой разрешения и операцией. В отказе чтения фраза в скобках называет, какое сравнение не удалось.

3891* `its parent-directory symlink resolution changed after permission was checked`: каталог, через который проходит путь записи, больше не разрешается в одобренное место4175* `its parent-directory symlink resolution changed after permission was checked`: каталог, через который проходит путь записи, больше не разрешается в одобренное место

4176* `where it leads on disk could not be determined (a link on the way could not be examined, or the links do not resolve)`: Claude Code не смог следовать пути к окончательному месту на диске, например потому что символические ссылки на нём образуют цикл

3892* `it is a symbolic link. Write to the link's target path instead`: символическая ссылка находится в одобренном месте записи, например `CLAUDE.md`, который является символической ссылкой на `AGENTS.md`; сообщение направляет Claude к цели ссылки4177* `it is a symbolic link. Write to the link's target path instead`: символическая ссылка находится в одобренном месте записи, например `CLAUDE.md`, который является символической ссылкой на `AGENTS.md`; сообщение направляет Claude к цели ссылки

3893* `Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.`: то же самое условие, обнаруженное, когда другой писатель открывает файл, например запись в символически связанный `.mcp.json`4178* `Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.`: то же самое условие, обнаруженное, когда другой писатель открывает файл, например запись в символически связанный `.mcp.json`

3894* `Refusing to write into symlinked directory: <path>`: каталог, который содержит файл, сам является символической ссылкой, например каталог `.claude/` проекта, связанный с другим местоположением4179* `Refusing to write into symlinked directory: <path>`: каталог, который содержит файл, сам является символической ссылкой, например каталог `.claude/` проекта, связанный с другим местоположением

3907 4192

3908До версии 2.1.251 Claude Code повторно проверял разрешение пути только для записей файлов, поэтому ссылка, заменённая после проверки разрешения, могла перенаправить чтение или поиск в другое место без сообщения. Из этих отказов только отказ записи родительского каталога, через символическую ссылку и в символически связанный каталог появляются в более ранних версиях.4193До версии 2.1.251 Claude Code повторно проверял разрешение пути только для записей файлов, поэтому ссылка, заменённая после проверки разрешения, могла перенаправить чтение или поиск в другое место без сообщения. Из этих отказов только отказ записи родительского каталога, через символическую ссылку и в символически связанный каталог появляются в более ранних версиях.

3909 4194

4195До версии 2.1.280 отказ `where it leads on disk could not be determined` не появлялся.

4196

3910<h3 id="task-output-swap-refused">4197<h3 id="task-output-swap-refused">

3911 Task output swap refused4198 Task output swap refused

3912</h3>4199</h3>

3932* Или проверьте каталог вашего проекта в временном каталоге Claude Code, `/private/tmp/claude-501/-Users-you-my-project` в примере сообщения. Если этот путь является символической ссылкой или каталогом, который не должен быть там, удалите саму ссылку или каталог, а не цель ссылки, и перезагрузитесь4219* Или проверьте каталог вашего проекта в временном каталоге Claude Code, `/private/tmp/claude-501/-Users-you-my-project` в примере сообщения. Если этот путь является символической ссылкой или каталогом, который не должен быть там, удалите саму ссылку или каталог, а не цель ссылки, и перезагрузитесь

3933* Если отказ повторяется, процесс заменяет, связывает или удаляет записи в временном каталоге Claude Code, пока сеанс работает. Установите [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars) в каталог, который ничто другое не управляет, и перезагрузитесь4220* Если отказ повторяется, процесс заменяет, связывает или удаляет записи в временном каталоге Claude Code, пока сеанс работает. Установите [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars) в каталог, который ничто другое не управляет, и перезагрузитесь

3934 4221

4222<h3 id="disk-quota-or-temp-filesystem-is-full">

4223 Disk quota or temp filesystem is full

4224</h3>

4225

4226Claude Code сохраняет вывод каждой команды Bash и PowerShell в файл в своём временном каталоге. Когда команда завершается с ненулевым кодом и вообще без вывода, Claude Code проверяет, заполнена ли файловая система, содержащая этот файл, или нет места для индексных дескрипторов, или ваша квота диска на ней использована. Если это так, диагностика появляется в результате команды вместо пустого вывода:

4227

4228```text wrap theme={null}

4229Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.

4230```

4231

4232Сообщение называет то, что закончилось:

4233

4234* `Your disk quota is full ... (EDQUOT)`: ваша собственная квота на этой файловой системе использована. Квота может быть полной, пока файловая система всё ещё показывает свободное место

4235* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`: файловая система или ваша квота на ней не имеет места

4236* `Command output was lost: the temp filesystem at ... is full` или `... is out of inodes`: файловая система имеет почти нет свободного места или заканчиваются индексные дескрипторы

4237

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

4239

4240* Удалите файлы, которые вам больше не нужны на файловой системе, содержащей временный каталог Claude Code. Для `EDQUOT` удалите файлы, которые учитываются в вашей собственной квоте. Для `out of inodes` удалите много файлов, а не несколько больших, так как каждый файл занимает один индексный дескриптор независимо от его размера

4241* Или перезагрузите Claude Code с [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars), установленным в каталог на файловой системе с местом

4242* Затем попросите Claude запустить команду снова. Вывод, который она напечатала, был потерян, а не усечён

4243

3935<h3 id="the-source-file-is-not-valid-utf-8-text">4244<h3 id="the-source-file-is-not-valid-utf-8-text">

3936 The source file is not valid UTF-8 text4245 The source file is not valid UTF-8 text

3937</h3>4246</h3>

3999 Команды, отклонённые в фоновом сеансе4308 Команды, отклонённые в фоновом сеансе

4000</h3>4309</h3>

4001 4310

4002Команды, которые открывают интерактивный диалог, не могут это делать, пока к фоновому сеансу не подключён терминал. `/install-github-app`, список параметров `/mcp` и действия аутентификации в меню сервера MCP отвечают сообщением, и сеанс появляется под **Needs input** в [представлении агента](/docs/ru/agent-view), чтобы вы могли его найти, подключиться и запустить команду снова. Пока терминал подключён, эти команды работают нормально.4311Команды, которые открывают интерактивный диалог, не могут это делать, пока к фоновому сеансу не подключён терминал. `/install-github-app`, список параметров `/mcp` и действия аутентификации в меню сервера MCP отвечают сообщением. Для `/install-github-app` и списка параметров `/mcp` сеанс также появляется под **Needs input** в [представлении агента](/docs/ru/agent-view), чтобы вы могли его найти, подключиться и запустить команду снова. Пока терминал подключён, эти команды работают нормально.

4003 4312

4004До версии 2.1.216 сеанс не появлялся под **Needs input** после одного из этих отказов. В версиях 2.1.213–2.1.215 команды всё ещё работали, пока был подключён терминал, и сообщение об отказе говорило вам подключиться и запустить команду снова. С версии 2.1.208 по 2.1.212 Claude Code отклонял их даже при подключённом терминале с сообщением вроде `Can't open MCP settings in a background session`; на этих версиях запустите команду из обычного сеанса `claude` вместо этого или обновитесь. До версии 2.1.208 они открывали свой диалог внутри фонового сеанса. Только в версии 2.1.208 Claude Code также отклонял средство выбора `/model` в фоновом сеансе, и `/upgrade` выводил URL обновления вместо открытия браузера.4313До версии 2.1.216 сеанс не появлялся под **Needs input** после `/install-github-app` или списка параметров `/mcp` был отклонён. В версиях 2.1.213–2.1.215 команды всё ещё работали, пока был подключён терминал, и сообщение об отказе говорило вам подключиться и запустить команду снова. С версии 2.1.208 по 2.1.212 Claude Code отклонял их даже при подключённом терминале с сообщением вроде `Can't open MCP settings in a background session`; на этих версиях запустите команду из обычного сеанса `claude` вместо этого или обновитесь. До версии 2.1.208 они открывали свой диалог внутри фонового сеанса. Только в версии 2.1.208 Claude Code также отклонял средство выбора `/model` в фоновом сеансе, и `/upgrade` выводил URL обновления вместо открытия браузера.

4005 4314

4006Формулировка называет команду. Список параметров `/mcp` сообщает:4315Формулировка называет команду. Список параметров `/mcp` сообщает:

4007 4316

4011 4320

4012**Что делать:**4321**Что делать:**

4013 4322

4014* Подключитесь к сеансу из представления агента, где он указан под **Needs input**, и запустите команду снова4323* Подключитесь к сеансу из представления агента и запустите команду снова

4015* Или используйте форму, которую называет сообщение, например `/mcp reconnect <server>`, `/mcp enable` или `/mcp disable`, которые работают без подключения4324* Или используйте форму, которую называет сообщение, например `/mcp reconnect <server>`, `/mcp enable` или `/mcp disable`, которые работают без подключения

4016 4325

4017<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">4326<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">

4046**Что делать:**4355**Что делать:**

4047 4356

4048* Обычно ничего: Claude повторяет попытку с локальным написанием, которое просит сообщение4357* Обычно ничего: Claude повторяет попытку с локальным написанием, которое просит сообщение

4049* Если файл находится на сетевом ресурсе, а не на локальном файле, написанном с сетевым путём, он находится вне локального рабочего пространства сеанса; отредактируйте его из обычного интерактивного сеанса вместо этого

4050 4358

4051<h3 id="command-blocked-by-the-worktree-isolation-checks">4359<h3 id="command-blocked-by-the-worktree-isolation-checks">

4052 Команда заблокирована проверками изоляции worktree4360 Команда заблокирована проверками изоляции worktree

4281 4589

4282На некоторых учётных записях сообщение говорит `daemon` вместо `background service`.4590На некоторых учётных записях сообщение говорит `daemon` вместо `background service`.

4283 4591

4284При установке npm ошибка `EUNKNOWN`, которая появляется, пока `npm install -g @anthropic-ai/claude-code` заменяет двоичный файл, имеет ту же причину, что и [`EACCES` при переустановке](#eacces-when-starting-a-background-session), и очищается, когда вы повторяете попытку после завершения установки.4592При установке npm ошибка `EUNKNOWN`, которая появляется, пока `npm install -g @anthropic-ai/claude-code` заменяет двоичный файл, имеет ту же причину, что и [`EACCES` при переустановке](#eacces-when-starting-a-background-session) и очищается, когда вы повторяете попытку после завершения установки.

4285 4593

4286Claude Code запускает фоновую службу через PowerShell, чтобы служба пережила закрытие терминала, используя PowerShell 7, когда он установлен, и Windows PowerShell 5.1 в противном случае. Когда ни один PowerShell не может работать, Claude Code запускает службу напрямую вместо этого, поэтому политика, которая блокирует только PowerShell, не вызывает эту ошибку. Если вы видите её, пока не запущена установка npm, политика блокирует сам исполняемый файл Claude Code.4594Claude Code запускает фоновую службу через PowerShell, чтобы служба пережила закрытие терминала, используя PowerShell 7, когда он установлен, и Windows PowerShell 5.1 в противном случае. Когда ни один PowerShell не может работать, Claude Code запускает службу напрямую вместо этого, поэтому политика, которая блокирует только PowerShell, не вызывает эту ошибку.

4287 4595

4288До версии 2.1.212 Claude Code использовал только Windows PowerShell 5.1 для запуска службы, поэтому любая машина, где Group Policy блокировал PowerShell 5.1, не удавалась с `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`, даже с установленным PowerShell 7.4596До версии 2.1.212 Claude Code использовал только Windows PowerShell 5.1 для запуска службы, поэтому любая машина, где Group Policy блокировал PowerShell 5.1, не удавалась с `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`, даже с установленным PowerShell 7.

4289 4597

4291 4599

4292* Если сообщение читается `Couldn't start the session`, обновитесь до версии 2.1.212 или позже. На более ранних версиях вы также можете запустить `claude daemon run` в отдельном терминале сначала, затем запустить фоновый сеанс снова. Эта команда запускает фоновую службу на переднем плане терминала, поэтому служба длится только столько, сколько этот терминал остаётся открытым.4600* Если сообщение читается `Couldn't start the session`, обновитесь до версии 2.1.212 или позже. На более ранних версиях вы также можете запустить `claude daemon run` в отдельном терминале сначала, затем запустить фоновый сеанс снова. Эта команда запускает фоновую службу на переднем плане терминала, поэтому служба длится только столько, сколько этот терминал остаётся открытым.

4293* Если установка npm заменяла двоичный файл, дождитесь её завершения, затем запустите фоновый сеанс снова4601* Если установка npm заменяла двоичный файл, дождитесь её завершения, затем запустите фоновый сеанс снова

4294* Если ошибка появляется в версии 2.1.212 или позже, пока не запущена установка npm, попросите администратора Windows разрешить исполняемый файл Claude Code в политике ограничения4602* Если ошибка появляется в версии 2.1.212 или позже, пока не запущена установка npm, проверьте с администратором Windows, блокирует ли политика ограничения исполняемый файл Claude Code

4295* Если фоновая служба останавливается при закрытии терминала, Claude Code запустил её без PowerShell. Установите PowerShell 7 или попросите администратора разблокировать PowerShell, чтобы служба могла пережить терминал.4603* Если фоновая служба останавливается при закрытии терминала, Claude Code запустил её без PowerShell. Установите PowerShell 7 или попросите администратора разблокировать PowerShell, чтобы служба могла пережить терминал.

4296 4604

4297<h3 id="eacces-when-starting-a-background-session">4605<h3 id="eacces-when-starting-a-background-session">

4347 Рабочий каталог больше не существует при запуске фонового сеанса4655 Рабочий каталог больше не существует при запуске фонового сеанса

4348</h3>4656</h3>

4349 4657

4350Вы попытались запустить [фоновый сеанс](/docs/ru/agent-view) в каталоге, который больше не существует. Это происходит, когда вы отправляете из представления агента или запускаете `/background` после того, как каталог, в котором вы работаете, был удалён или перемещён. Это также происходит, когда вы подключаетесь к или перезапускаете сеанс, чей процесс вышел и чей каталог ушёл, потому что новый процесс запустился бы в том же каталоге. Claude Code не запускает сеанс, и сообщение называет отсутствующий каталог:4658Вы попытались запустить [фоновый сеанс](/docs/ru/agent-view) в каталоге, который больше не существует. Claude Code не запускает сеанс, и сообщение называет отсутствующий каталог:

4351 4659

4352```text theme={null}4660```text theme={null}

4353Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)4661Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)

4355 4663

4356До версии 2.1.257 сеанс казался запущенным и затем показывался в представлении агента как неудачная строка с той же причиной.4664До версии 2.1.257 сеанс казался запущенным и затем показывался в представлении агента как неудачная строка с той же причиной.

4357 4665

4666До версии 2.1.281 это сообщение также появлялось, когда каталог уже был удалён до того, как вы запустили сеанс. Этот случай сообщает [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session).

4667

4358**Что делать:**4668**Что делать:**

4359 4669

4360* Пересоздайте каталог, который называет сообщение, или отправьте из каталога, который существует, затем попробуйте снова4670* Пересоздайте каталог, который называет сообщение, или отправьте из каталога, который существует, затем попробуйте снова

4361 4671

4672<h3 id="workspace-not-trusted-when-dispatching-a-background-session">

4673 Рабочее пространство не доверено при отправке фонового сеанса

4674</h3>

4675

4676Вы запустили или перезапустили [фоновый сеанс](/docs/ru/agent-view) в каталоге, которому вы не [доверили](/docs/ru/permissions#project-allow-rules-and-workspace-trust), и диалог доверия рабочего пространства не мог появиться, чтобы спросить вас. Claude Code не запускает сеанс:

4677

4678```text theme={null}

4679Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.

4680```

4681

4682Из терминала в собственном каталоге сеанса та же команда показывает диалог доверия вместо этого и запускает сеанс после того, как вы примете. Это сообщение появляется там, где диалог не может, например в скрипте, или когда вы перезапускаете сеанс из каталога, отличного от его собственного.

4683

4684Два варианта называют другую причину:

4685

4686* **`The home directory is trusted one session at a time`**: каталог сеанса — это ваш домашний каталог. Claude Code никогда не сохраняет доверие для домашнего каталога, поэтому принятие диалога там в более раннем сеансе не считается.

4687* **`<path> could not be resolved on disk`**: Claude Code не мог найти каталог сеанса на диске.

4688

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

4690

4691* Запустите `claude` в каталоге, который называет сообщение, и примите диалог доверия, затем запустите команду снова

4692* Для сообщения о домашнем каталоге запустите команду из терминала в вашем домашнем каталоге, чтобы диалог мог появиться, или запустите сеанс из каталога проекта вместо этого

4693* Для сообщения `could not be resolved on disk` пересоздайте каталог или запустите новый сеанс из каталога, который существует

4694

4362<h2 id="wrapper-and-ide-errors">4695<h2 id="wrapper-and-ide-errors">

4363 Ошибки обёртки и IDE4696 Ошибки обёртки и IDE

4364</h2>4697</h2>

4443 4776

4444* Определите, какие файлы были пропущены, чтобы вы могли обработать каждый из них, следуя приведённым ниже шагам. Сообщение содержит только количество; журнал отладки в `~/.claude/debug/<session-id>.txt` указывает каждый пропущенный путь по мере выполнения восстановления, поэтому включите логирование отладки с помощью `/debug` перед следующим восстановлением. На macOS или Linux вы можете вместо этого найти ссылки напрямую: `find . -type l` для символических ссылок и `find . -type f -links +1` для жёстко связанных файлов.4777* Определите, какие файлы были пропущены, чтобы вы могли обработать каждый из них, следуя приведённым ниже шагам. Сообщение содержит только количество; журнал отладки в `~/.claude/debug/<session-id>.txt` указывает каждый пропущенный путь по мере выполнения восстановления, поэтому включите логирование отладки с помощью `/debug` перед следующим восстановлением. На macOS или Linux вы можете вместо этого найти ссылки напрямую: `find . -type l` для символических ссылок и `find . -type f -links +1` для жёстко связанных файлов.

4445* Если пропущенный файл — это ссылка, которую вы создали намеренно, например файл конфигурации, управляемый менеджером dotfile, или файл, жёстко связанный инструментами вроде pnpm, то rewind оставил его содержимое без изменений. Чтобы отменить изменения сеанса в этом файле, попросите Claude отменить редактирование или отредактируйте файл самостоятельно4778* Если пропущенный файл — это ссылка, которую вы создали намеренно, например файл конфигурации, управляемый менеджером dotfile, или файл, жёстко связанный инструментами вроде pnpm, то rewind оставил его содержимое без изменений. Чтобы отменить изменения сеанса в этом файле, попросите Claude отменить редактирование или отредактируйте файл самостоятельно

4446* Если вы не создавали ссылку, проверьте путь перед тем, как доверять его содержимому: что-то заменило файл после создания контрольной точки4779* Если вы не создавали ссылку, проверьте путь перед тем, как доверять его содержимому

4447 4780

4448<h3 id="no-files-were-restored">4781<h3 id="no-files-were-restored">

4449 No files were restored4782 No files were restored

4591* Сократите frontmatter `description` ваших файлов агентов или попросите Claude сократить их для вас.4924* Сократите frontmatter `description` ваших файлов агентов или попросите Claude сократить их для вас.

4592* Удалите файлы агентов, которые вы больше не используете.4925* Удалите файлы агентов, которые вы больше не используете.

4593 4926

4927<h3 id="a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved">

4928 A skill, command, or workflow wasn't loaded because its name is reserved

4929</h3>

4930

4931Папка skill, frontmatter `name`, файл или подпапка в `.claude/commands/` или [saved workflow](/docs/ru/workflows#save-the-workflow-for-reuse) использует имя `anthropic-skills` или имя, которое начинается с `anthropic-skills:`. Claude Code [зарезервировал это имя для skills, синхронизированных из claude.ai](/docs/ru/skills#names-reserved-for-synced-skills) и не загружает этот элемент.

4932

4933Claude Code показывает это предупреждение как уведомление при запуске в представлении беседы, а не на stderr:

4934

4935```text theme={null}

4936Not loaded: rename .claude/skills/anthropic-skills, then restart — its name uses "anthropic-skills", a name reserved for the skills synced from your claude.ai account

4937```

4938

4939Уведомление называет то, что нужно изменить для первого отклонённого элемента: папку или файл для переименования, строку `name:` для редактирования или workflow для переименования. Когда было отклонено более одного элемента, уведомление заканчивается счётом, например `· 2 more`, и [debug log](/docs/ru/debug-your-config) называет каждый.

4940

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

4942

4943* Переименуйте элемент, который называет уведомление, или отредактируйте строку `name:`, на которую оно указывает, затем перезагрузите сеанс.

4944

4945До версии 2.1.282 Claude Code загружал skills и commands с этими именами.

4946

4594<h3 id="workspace-has-not-been-trusted">4947<h3 id="workspace-has-not-been-trusted">

4595 Workspace has not been trusted4948 Workspace has not been trusted

4596</h3>4949</h3>

4637 Remote managed settings failed to load4990 Remote managed settings failed to load

4638</h3>4991</h3>

4639 4992

4640Ваш сеанс имеет право на [server-managed settings](/docs/ru/server-managed-settings), но Claude Code не смог их получить, поэтому он показывает это предупреждение в интерактивных сеансах. Причина в скобках называет то, что не удалось, например `network error`, `request timed out` или `authentication rejected (401)`, а остальная часть строки говорит, какую политику запускает сеанс:4993Ваш сеанс имеет право на [server-managed settings](/docs/ru/server-managed-settings), но Claude Code не смог их получить или не смог применить то, что вернул сервер, поэтому он показывает это предупреждение в интерактивных сеансах.

4994

4995Причина в скобках называет то, что не удалось, например `network error`, `request timed out` или `authentication rejected (401)`. Причина `no setting in the server response could be applied as written` означает, что сервер ответил, но ни один из параметров, которые он вернул, не прошёл [validation](/docs/ru/server-managed-settings#invalid-entries-in-delivered-settings). До версии 2.1.282 эта причина читалась как `server returned invalid settings`.

4996

4997Остальная часть строки говорит, какую политику запускает сеанс:

4641 4998

4642* **Settings cached from an earlier successful fetch**: Claude Code запускает сеанс на этой кэшированной политике, кроме [withheld environment variables](/docs/ru/server-managed-settings#fetch-and-caching-behavior), и строка читается `using cached policy`.4999* **Settings cached from an earlier successful fetch**: Claude Code запускает сеанс на этой кэшированной политике, кроме [withheld environment variables](/docs/ru/server-managed-settings#fetch-and-caching-behavior), и строка читается `using cached policy`.

4643* **No cache**: Claude Code запускает сеанс без server-managed settings, и строка читается `no remote policy applied`.5000* **No cache**: Claude Code запускает сеанс без server-managed settings, и строка читается `no remote policy applied`.

4645**Что делать:**5002**Что делать:**

4646 5003

4647* Действуйте в соответствии с причиной, которую называет сообщение: для сетевой причины проверьте, что эта машина может достичь `api.anthropic.com`; для причины аутентификации проверьте вашу регистрацию с помощью `/status`5004* Действуйте в соответствии с причиной, которую называет сообщение: для сетевой причины проверьте, что эта машина может достичь `api.anthropic.com`; для причины аутентификации проверьте вашу регистрацию с помощью `/status`

5005* Для `no setting in the server response could be applied as written` попросите вашего администратора исправить параметры на сервере

4648* Выполните `/status` или `claude doctor` для полной диагностики5006* Выполните `/status` или `claude doctor` для полной диагностики

4649 5007

4650До версии 2.1.248 Claude Code сообщал о неудачной выборке параметров только в журнале отладки.5008До версии 2.1.248 Claude Code сообщал о неудачной выборке параметров только в журнале отладки.

4664* Запустите Claude Code снова и одобрите диалог, чтобы продолжить в соответствии с параметрами вашей организации. Отклонённый диалог не запоминается, поэтому он появляется снова при следующем запуске.5022* Запустите Claude Code снова и одобрите диалог, чтобы продолжить в соответствии с параметрами вашей организации. Отклонённый диалог не запоминается, поэтому он появляется снова при следующем запуске.

4665* Если вы не уверены в параметре, который перечисляет диалог, спросите того, кто поддерживает управляемые параметры вашей организации, перед одобрением5023* Если вы не уверены в параметре, который перечисляет диалог, спросите того, кто поддерживает управляемые параметры вашей организации, перед одобрением

4666 5024

5025<h3 id="managed-settings-block-the-default-model">

5026 Managed settings block the default model

5027</h3>

5028

5029[managed settings](/docs/ru/managed-settings) вашей организации блокируют модель, на которую разрешается Default option, и каждую модель, на которую она может перейти. Сеанс, который должен был бы запуститься на Default option, выходит при запуске вместо запуска заблокированной модели. Какое сообщение вы видите, зависит от параметра, который её блокирует. Когда список [`deniedModels`](/docs/ru/model-config#block-specific-models-or-versions) блокирует её, сообщение читается:

5030

5031```text theme={null}

5032Claude Code can't start: your organization's managed settings block the default model (claude-opus-5-5) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".

5033```

5034

5035Когда список `availableModels` с [`availableModelsMatch`](/docs/ru/settings-reference#availablemodelsmatch) установленным на `"exact"` его опускает, сообщение читается:

5036

5037```text theme={null}

5038Claude Code can't start: your organization allows only the models listed in "availableModels", and none of them can be used as the default model (claude-opus-5-5 isn't listed). Ask your administrator to update "availableModels".

5039```

5040

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

5042

5043* Если вы администрируете параметры, добавьте модель, которую ваши пользователи могут запустить, в `availableModels` или сузьте записи `deniedModels`, которые блокируют каждый fallback. [Block specific models or versions](/docs/ru/model-config#block-specific-models-or-versions) описывает, как Default option переходит

5044* Если вы их не администрируете, отправьте сообщение вашему администратору. Ваши собственные файлы параметров не могут расширить управляемый `availableModels` или `deniedModels` список

5045

4667<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">5046<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">

4668 MCP server is blocked by enterprise managed policy5047 MCP server is blocked by enterprise managed policy

4669</h3>5048</h3>

4933 5312

4934* Настроенный [`--fallback-model`](/docs/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке5313* Настроенный [`--fallback-model`](/docs/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке

4935* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна5314* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна

4936* [Автоматический переход на резервную модель](/docs/ru/model-config#automatic-model-fallback) на Fable 5.1, Fable 5, Opus 5.5 и Opus 5 переводит сеанс на резервную модель категории с флагом, когда у этой категории она есть, и показывает уведомление в расшифровке5315* [Автоматический переход на резервную модель](/docs/ru/model-config#automatic-model-fallback) на Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 и Opus 5 переводит сеанс на резервную модель категории с флагом, когда у этой категории она есть, и показывает уведомление в расшифровке

4937 5316

4938Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/docs/ru/model-config) объясняет, когда применяется каждый переход на резервную модель.5317Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/docs/ru/model-config) объясняет, когда применяется каждый переход на резервную модель.

4939 5318

feature-availability.md +2 −2

Details

219</table>219</table>

220 220

221<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> На Google Cloud's Agent Platform веб-поиск доступен для моделей Claude 4 и более поздних версий.<br />221<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> На Google Cloud's Agent Platform веб-поиск доступен для моделей Claude 4 и более поздних версий.<br />

222<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> На этих поставщиках auto mode поддерживает только Claude Sonnet 5, Opus 4.7 или более поздние версии и модели Fable. См. [Конфигурация Auto mode](/docs/ru/auto-mode-config). Встроенный режим разрешений по умолчанию на этих поставщиках — Manual. См. [в каком режиме начинается сеанс](/docs/ru/permission-modes#which-mode-a-session-starts-in). В v2.1.158 через v2.1.206 auto mode на этих поставщиках также требовал установки `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 удалил это требование.<br />222<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> На этих поставщиках auto mode поддерживает только Claude Sonnet 5, Opus 4.7 или более поздние версии и модели Fable. См. [Конфигурация Auto mode](/docs/ru/auto-mode-config). Для режима разрешений, в котором сеанс начинается на этих поставщиках, см. [В каком режиме начинается сеанс](/docs/ru/permission-modes#which-mode-a-session-starts-in). В v2.1.158 через v2.1.206 auto mode на этих поставщиках также требовал установки `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 удалил это требование.<br />

223<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> В соответствии с вашим соглашением с поставщиком облачных услуг.<br />223<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> В соответствии с вашим соглашением с поставщиком облачных услуг.<br />

224<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Только панель управления и API. [Contribution metrics](/docs/ru/analytics#enable-contribution-metrics) требует организацию claude.ai Team или Enterprise.<br />224<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> Только панель управления и API. [Contribution metrics](/docs/ru/analytics#enable-contribution-metrics) требует организацию claude.ai Team или Enterprise.<br />

225<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Требует Claude Code v2.1.224 или более поздней версии на macOS и Linux, включая Linux внутри WSL 2. На нативной Windows требует Claude Code v2.1.234 или более поздней версии. При аутентификации с помощью ключа API передача сообщений доступна только на одной машине. На Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform и Microsoft Foundry передача сообщений доступна только на одной машине и требует Claude Code v2.1.248 или более поздней версии. Claude может найти ваши сеансы [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) и ваши сеансы на других машинах только из сеанса, подключённого к [Remote Control](/docs/ru/remote-control). Для подключения вам нужна учётная запись claude.ai и другие [требования Remote Control](/docs/ru/remote-control#requirements). См. [Передача сообщений между сеансами на других машинах](/docs/ru/cross-session-messaging#message-sessions-on-other-machines).225<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Требует Claude Code v2.1.224 или более поздней версии на macOS и Linux, включая Linux внутри WSL 2. На нативной Windows требует Claude Code v2.1.234 или более поздней версии. При аутентификации с помощью ключа API передача сообщений доступна только на одной машине. На Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform и Microsoft Foundry передача сообщений доступна только на одной машине и требует Claude Code v2.1.248 или более поздней версии. Claude может найти ваши [облачные сеансы](/docs/ru/claude-code-on-the-web) и ваши сеансы на других машинах только из сеанса, подключённого к [Remote Control](/docs/ru/remote-control). Для подключения вам нужна учётная запись claude.ai и другие [требования Remote Control](/docs/ru/remote-control#requirements). См. [Передача сообщений между сеансами на других машинах](/docs/ru/cross-session-messaging#message-sessions-on-other-machines).

226 226

227<Note>227<Note>

228 Если вы аутентифицируетесь через [LLM gateway](/docs/ru/llm-gateway), доступность функций соответствует базовому поставщику, на который шлюз перенаправляет запросы, за исключением функций, которые сам Claude Code отключает. Когда `ANTHROPIC_BASE_URL` указывает на хост, отличный от `api.anthropic.com`, Claude Code отключает функции такие как [Remote Control](/docs/ru/remote-control#requirements) и [server-managed settings](/docs/ru/server-managed-settings#platform-availability), независимо от того, что перенаправляет шлюз. Некоторые функции, доступные только для Anthropic, такие как [Advisor](/docs/ru/advisor), работают только если шлюз перенаправляет запросы без изменений на API Anthropic.228 Если вы аутентифицируетесь через [LLM gateway](/docs/ru/llm-gateway), доступность функций соответствует базовому поставщику, на который шлюз перенаправляет запросы, за исключением функций, которые сам Claude Code отключает. Когда `ANTHROPIC_BASE_URL` указывает на хост, отличный от `api.anthropic.com`, Claude Code отключает функции такие как [Remote Control](/docs/ru/remote-control#requirements) и [server-managed settings](/docs/ru/server-managed-settings#platform-availability), независимо от того, что перенаправляет шлюз. Некоторые функции, доступные только для Anthropic, такие как [Advisor](/docs/ru/advisor), работают только если шлюз перенаправляет запросы без изменений на API Anthropic.

fullscreen.md +3 −1

Details

104* **Щелкните опцию в меню множественного выбора**, чтобы переключить её, и нажмите кнопку отправки, чтобы подтвердить ваш выбор. Щелчок по строке свободного текста, например по строке `Other` в вопросе с несколькими вариантами ответов, фокусирует её поле ввода, чтобы вы могли ввести ответ. Требуется Claude Code v2.1.208 или более поздняя версия.104* **Щелкните опцию в меню множественного выбора**, чтобы переключить её, и нажмите кнопку отправки, чтобы подтвердить ваш выбор. Щелчок по строке свободного текста, например по строке `Other` в вопросе с несколькими вариантами ответов, фокусирует её поле ввода, чтобы вы могли ввести ответ. Требуется Claude Code v2.1.208 или более поздняя версия.

105* **Щелкните значение параметра в панели `/config`**, чтобы изменить его, и прокручивайте список параметров колесом мыши. Требуется Claude Code v2.1.271 или более поздняя версия.105* **Щелкните значение параметра в панели `/config`**, чтобы изменить его, и прокручивайте список параметров колесом мыши. Требуется Claude Code v2.1.271 или более поздняя версия.

106* **Прокручивайте меню выбора или множественного выбора колесом мыши**, когда оно содержит больше опций, чем может отобразить одновременно, например список `/model` в коротком окне терминала. Колесо прокручивает список, пока указатель находится над его опциями. Требуется Claude Code v2.1.280 или более поздняя версия.106* **Прокручивайте меню выбора или множественного выбора колесом мыши**, когда оно содержит больше опций, чем может отобразить одновременно, например список `/model` в коротком окне терминала. Колесо прокручивает список, пока указатель находится над его опциями. Требуется Claude Code v2.1.280 или более поздняя версия.

107* **Прокручивайте переполняющийся список с помощью его полосы прокрутки.** В панелях списков, таких как `/skills`, `/mcp` и список Installed в `/plugin`, полоса прокрутки появляется рядом со списком, содержащим больше строк, чем может поместиться, пока указатель находится над ним. Щелкните по дорожке, чтобы перейти к этой точке, или перетащите ползунок. Требуется Claude Code v2.1.281 или более поздняя версия.

107* **Щелкните свёрнутый результат инструмента**, чтобы развернуть его и увидеть полный результат. Щелкните снова, чтобы свернуть. Вызов инструмента и его результат разворачиваются вместе. Щелкаемы только сообщения, которые имеют больше информации для отображения.108* **Щелкните свёрнутый результат инструмента**, чтобы развернуть его и увидеть полный результат. Щелкните снова, чтобы свернуть. Вызов инструмента и его результат разворачиваются вместе. Щелкаемы только сообщения, которые имеют больше информации для отображения.

108 * Щелчок также разворачивает результат команды оболочки `!`, будь то старый усечённый результат или строка прямого хода во время выполнения команды. Требуется Claude Code v2.1.257 или более поздняя версия.109 * Щелчок также разворачивает результат команды оболочки `!`, будь то старый усечённый результат или строка прямого хода во время выполнения команды. Требуется Claude Code v2.1.257 или более поздняя версия.

110 * Щелчок также разворачивает тусклую строку `Message from @<sender>`, когда отправитель является [товарищем по команде](/docs/ru/agent-teams) или другим агентом, работающим в вашей сессии. Строка для сообщения из [одной из ваших других сессий](/docs/ru/cross-session-messaging#what-a-message-looks-like) также показывает первую строку сообщения и не является щелкаемой, поэтому нажмите `Ctrl+o`, чтобы прочитать её.

109* **Удерживайте `Cmd` на macOS или `Ctrl` на Linux и Windows и щелкните URL или путь к файлу**, чтобы открыть его. Простые URL-адреса `http://` и `https://` открываются в вашем браузере, а пути к файлам в результатах инструментов, например те, которые выводятся после Edit или Write, открываются в вашем приложении по умолчанию. Простой щелчок без модификатора не открывает ссылки, что соответствует поведению встроенного терминала.111* **Удерживайте `Cmd` на macOS или `Ctrl` на Linux и Windows и щелкните URL или путь к файлу**, чтобы открыть его. Простые URL-адреса `http://` и `https://` открываются в вашем браузере, а пути к файлам в результатах инструментов, например те, которые выводятся после Edit или Write, открываются в вашем приложении по умолчанию. Простой щелчок без модификатора не открывает ссылки, что соответствует поведению встроенного терминала.

110 * Claude Code отображает сетевой путь (UNC), такой как `\\server\share\file.ts`, как простой текст без ссылки, потому что открытие сетевого пути может отправить ваши учётные данные Windows на хост, который он указывает.112 * Claude Code отображает сетевой путь (UNC), такой как `\\server\share\file.ts`, как простой текст без ссылки, потому что открытие сетевого пути может отправить ваши учётные данные Windows на хост, который он указывает.

111 * Некоторые терминалы macOS перенаправляют `Cmd`+щелчок запущенному приложению вместо того, чтобы открывать ссылку самостоятельно, и протокол мыши терминала не имеет способа кодировать клавишу `Cmd`, поэтому Claude Code получает простой щелчок. В Ghostty и в Warp на macOS Claude Code это обнаруживает и позволяет простому щелчку на ссылке открыть её, а удержание `Cmd` по-прежнему работает.113 * Некоторые терминалы macOS перенаправляют `Cmd`+щелчок запущенному приложению вместо того, чтобы открывать ссылку самостоятельно, и протокол мыши терминала не имеет способа кодировать клавишу `Cmd`, поэтому Claude Code получает простой щелчок. В Ghostty и в Warp на macOS Claude Code это обнаруживает и позволяет простому щелчку на ссылке открыть её, а удержание `Cmd` по-прежнему работает.

290CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude292CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude

291```293```

292 294

293С отключённым захватом мыши прокрутка с помощью клавиатуры с `PgUp`, `PgDn`, `Ctrl+Home` и `Ctrl+End` по-прежнему работает, и ваш терминал обрабатывает выделение нативно. Вы теряете щелчок для позиционирования курсора, щелчок для расширения вывода инструмента, щелчок по URL и прокрутку колеса внутри Claude Code.295С отключённым захватом мыши прокрутка с помощью клавиатуры с `PgUp`, `PgDn`, `Ctrl+Home` и `Ctrl+End` по-прежнему работает, и ваш терминал обрабатывает выделение нативно. Вы теряете щелчок для позиционирования курсора, щелчок для расширения, щелчок по URL и прокрутку колеса внутри Claude Code.

294 296

295Чтобы сохранить прокрутку колеса, но отключить обработку щелчков, перетаскивания и наведения, установите вместо этого `CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1`. Требуется Claude Code версии v2.1.195 или позже. `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет, когда установлены обе переменные.297Чтобы сохранить прокрутку колеса, но отключить обработку щелчков, перетаскивания и наведения, установите вместо этого `CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1`. Требуется Claude Code версии v2.1.195 или позже. `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет, когда установлены обе переменные.

296 298

github-enterprise-server.md +1 −1

Details

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

253</h3>253</h3>

254 254

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

256 256

257<h2 id="related-resources">257<h2 id="related-resources">

258 Связанные ресурсы258 Связанные ресурсы

glossary.md +33 −6

Details

16 AGENTS.md16 AGENTS.md

17</h3>17</h3>

18 18

19Файл markdown с инструкциями проекта, которые вы пишете для AI-агентов кодирования. Если в вашем репозитории есть такой файл и нет [CLAUDE.md](#claude-md), Claude читает его как инструкции вашего проекта без необходимости добавления второго файла. Вы можете изменить параметр **Project instructions** в `/config`, чтобы Claude читал оба файла или только `CLAUDE.md`. Прямое чтение `AGENTS.md` требует Claude Code v2.1.277 или более поздней версии. В некоторых сеансах Claude [не может читать `AGENTS.md`](/docs/ru/memory#when-agents-md-support-is-unavailable), поэтому [импортируйте его из `CLAUDE.md`](/docs/ru/memory#share-one-file-with-other-coding-tools) вместо этого.19Файл markdown с инструкциями проекта, которые вы пишете для AI-агентов кодирования. Если в вашем репозитории есть такой файл и нет [CLAUDE.md](#claude-md), Claude читает его как инструкции вашего проекта без необходимости добавлять второй файл. Вы можете изменить параметр **Project instructions** в `/config`, чтобы Claude читал оба файла или только `CLAUDE.md`. Прямое чтение `AGENTS.md` требует Claude Code v2.1.277 или более поздней версии. В некоторых сеансах Claude [не может читать `AGENTS.md`](/docs/ru/memory#when-agents-md-support-is-unavailable), поэтому [импортируйте его из `CLAUDE.md`](/docs/ru/memory#share-one-file-with-other-coding-tools) вместо этого.

20 20

21Подробнее: [AGENTS.md](/docs/ru/memory#agents-md)21Подробнее: [AGENTS.md](/docs/ru/memory#agents-md)

22 22

32 Agentic coding32 Agentic coding

33</h3>33</h3>

34 34

35Рабочий процесс, при котором ИИ может автономно читать файлы, выполнять команды и вносить изменения, пока вы наблюдаете, перенаправляете или отсутствуете, в отличие от чат-ассистентов на основе текста, которые только отвечают текстом, который вы должны применить сами. Claude Code является agentic, потому что он имеет [tools](#tool), которые позволяют ему действовать, а не только давать советы.35Рабочий процесс, при котором AI может автономно читать файлы, выполнять команды и вносить изменения, пока вы наблюдаете, перенаправляете или отходите в сторону, в отличие от чат-ассистентов на основе текста, которые только отвечают текстом, который вы должны применить самостоятельно. Claude Code является агентским, потому что он имеет [tools](#tool), которые позволяют ему действовать, а не только давать советы.

36 36

37Подробнее: [How Claude Code works](/docs/ru/how-claude-code-works)37Подробнее: [How Claude Code works](/docs/ru/how-claude-code-works)

38 38

48 Agentic loop48 Agentic loop

49</h3>49</h3>

50 50

51Цикл, через который проходит Claude для каждой задачи: собрать контекст, предпринять действие, проверить результаты и повторять до завершения. Каждое использование tool возвращает информацию, которая информирует следующий шаг. Вы можете прервать цикл в любой момент для перенаправления. Большинство точек расширения, включая [hooks](#hook), [skills](#skill) и [MCP](#mcp-model-context-protocol), подключаются к определённым фазам этого цикла.51Цикл, через который Claude проходит для каждой задачи: собрать контекст, предпринять действие, проверить результаты и повторять до завершения. Каждое использование инструмента возвращает информацию, которая информирует следующий шаг. Вы можете прервать цикл в любой момент для перенаправления. Большинство точек расширения, включая [hooks](#hook), [skills](#skill) и [MCP](#mcp-model-context-protocol), подключаются к определенным фазам этого цикла.

52 52

53Подробнее: [How Claude Code works](/docs/ru/how-claude-code-works#the-agentic-loop)53Подробнее: [How Claude Code works](/docs/ru/how-claude-code-works#the-agentic-loop)

54 54

56 Artifact56 Artifact

57</h3>57</h3>

58 58

59Живая интерактивная веб-страница, которую Claude Code публикует из вашего сеанса на приватный URL на claude.ai, чтобы вы могли видеть результат визуально или поделиться им вместо чтения текста терминала. Страница обновляется на месте, когда сеанс переиздаёт её. Артефакты, которые вы создаёте из Claude Code, появляются в той же галерее, что и артефакты, созданные в разговорах claude.ai. Совместное использование зависит от вашего плана: на Pro и Max — общедоступная ссылка, которую может открыть кто угодно; на Team и Enterprise — совместное использование в вашей организации, плюс общедоступные ссылки после того, как владелец их включит.59Живая интерактивная веб-страница, которую Claude Code публикует из вашего сеанса на приватный URL на claude.ai, чтобы вы могли видеть результат визуально или поделиться им вместо чтения текста терминала. Страница обновляется на месте, когда сеанс переиздается. Артефакты, которые вы создаете из Claude Code, появляются в той же галерее, что и артефакты, созданные в разговорах claude.ai. Совместное использование зависит от вашего плана: на Pro и Max — публичная ссылка, которую может открыть кто угодно; на Team и Enterprise — совместное использование в вашей организации, плюс публичные ссылки после того, как владелец их включит.

60 60

61Подробнее: [Share session output as artifacts](/docs/ru/artifacts)61Подробнее: [Share session output as artifacts](/docs/ru/artifacts)

62 62

64 Auto memory64 Auto memory

65</h3>65</h3>

66 66

67Заметки, которые Claude пишет для себя на основе ваших исправлений и предпочтений, хранящиеся в репозитории git в `~/.claude/projects/`. Все worktrees одного репозитория используют один каталог auto memory. Первые 200 строк или 25 КБ индекса `MEMORY.md` загружаются в начале каждого сеанса. Auto memory — это написанный Claude аналог [CLAUDE.md](#claude-md), который вы пишете.67Заметки, которые Claude пишет для себя на основе ваших исправлений и предпочтений, хранящиеся в каждом git-репозитории в `~/.claude/projects/`. Все worktrees одного репозитория используют один каталог auto memory. Первые 200 строк или 25 КБ индекса `MEMORY.md` загружаются в начале каждого сеанса. Auto memory — это написанный Claude аналог [CLAUDE.md](#claude-md), который пишете вы.

68 68

69Подробнее: [Auto memory](/docs/ru/memory#auto-memory)69Подробнее: [Auto memory](/docs/ru/memory#auto-memory)

70 70

72 Auto mode72 Auto mode

73</h3>73</h3>

74 74

75[permission mode](#permission-mode), где отдельная модель классификатора проверяет действия вместо вас, поэтому Claude Code выполняет большинство из них без запроса. Claude Code по-прежнему запрашивает вас перед действиями, которые совпадают с вашими явными правилами запроса. На планах Pro, Max и Team, auto mode является [встроенным начальным режимом разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in) для интерактивного терминала и сеансов VS Code. Классификатор блокирует расширение области, ненадёжную инфраструктуру и [prompt injection](#prompt-injection). Результаты tool удаляются из того, что он видит, поэтому враждебный контент в файле или веб-странице не может напрямую манипулировать им.75[Permission mode](#permission-mode), в котором отдельная модель классификатора проверяет действия вместо вас, поэтому Claude Code выполняет большинство из них без вашего запроса. Claude Code все еще просит вас перед действиями, которые совпадают с вашими явными правилами запроса. Начиная с Claude Code v2.1.283 или более поздней версии, auto mode является [встроенным начальным режимом разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in) для интерактивного терминала и сеансов VS Code на всех планах, а на более ранних версиях только на планах Pro, Max и Team. Классификатор блокирует расширение области действия, ненадежную инфраструктуру и [prompt injection](#prompt-injection). Результаты инструментов удаляются из того, что он видит, поэтому враждебный контент в файле или веб-странице не может манипулировать им напрямую.

76 76

77Подробнее: [Eliminate prompts with auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode)77Подробнее: [Eliminate prompts with auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode)

78 78

428 428

429Подробнее: [Platforms and integrations](/docs/ru/platforms)429Подробнее: [Platforms and integrations](/docs/ru/platforms)

430 430

431<h3 id="system-prompt">

432 System prompt

433</h3>

434

435Инструкции, которые Claude Code отправляет перед вашим разговором при каждом запросе, охватывающие то, как Claude использует tools, ведёт себя безопасно и форматирует свои ответы. Вы можете добавить к системному prompt с помощью `--append-system-prompt` или заменить его с помощью `--system-prompt`. System prompt — это первый слой [prompt cache](/docs/ru/prompt-caching#how-the-cache-is-organized).

436

437Ваши файлы [CLAUDE.md](#claude-md) и инструкции вашего [output style](#output-style) не являются частью system prompt. Claude Code доставляет их в разговор как [system reminders](#system-reminder).

438

439Подробнее: [System prompt flags](/docs/ru/cli-reference#system-prompt-flags)

440

441<h3 id="system-reminder">

442 System reminder

443</h3>

444

445Сообщение, которое Claude Code, как [harness](#agentic-harness), добавляет в разговор, чтобы дать Claude контекст. Вы не отправляете system reminders сами. Claude Code вставляет их по мере выполнения сеанса, например когда сеанс начинается, когда hook возвращает текст или когда файл изменяется на диске. Claude читает их вместе с вашими сообщениями. Все следующие достигают Claude как system reminders:

446

447* Ваши файлы [CLAUDE.md](#claude-md)

448* Инструкции вашего [output style](#output-style)

449* Текст, который [hook](#hook) возвращает как `additionalContext`

450* Список доступных [skills](#skill)

451* Примечание о том, что файл, который Claude читал ранее, изменился на диске

452* Строки атрибуции commit и pull request

453

454В залогированном API запросе system reminder появляется обёрнутым в теги `<system-reminder>` внутри пользовательского сообщения или на некоторых моделях как отдельное сообщение с ролью `system`.

455

456Подробнее: [Context Claude Code adds outside the system prompt](/docs/ru/agent-sdk/modifying-system-prompts#context-claude-code-adds-outside-the-system-prompt)

457

431<h2 id="t">458<h2 id="t">

432 T459 T

433</h2>460</h2>

goal.md +1 −1

Details

155 155

156Если ход завершается ошибкой, которая не будет очищена, пока вы её не исправите, Claude Code очищает цель и выводит предупреждение, называя причину. Предупреждение начинается с `Goal cleared after an unrecoverable error` и заканчивается с `Run /goal again to continue`. Исправьте причину, затем [установите цель снова](#set-a-goal) с помощью `/goal <condition>`. Четыре вида отказа очищают цель:156Если ход завершается ошибкой, которая не будет очищена, пока вы её не исправите, Claude Code очищает цель и выводит предупреждение, называя причину. Предупреждение начинается с `Goal cleared after an unrecoverable error` и заканчивается с `Run /goal again to continue`. Исправьте причину, затем [установите цель снова](#set-a-goal) с помощью `/goal <condition>`. Четыре вида отказа очищают цель:

157 157

158* Ошибка аутентификации, когда Claude Code управляет своими собственными учётными данными. Когда хост управляет ими для вас, например в приложении для рабочего стола, расширении VS Code или [облачном сеансе](/docs/ru/claude-code-on-the-web), Claude Code оставляет цель активной, потому что хост восстанавливает доступ самостоятельно.158* Ошибка аутентификации, когда Claude Code управляет своими собственными учётными данными. Когда хост управляет ими для вас, например в приложении для рабочего стола или [облачном сеансе](/docs/ru/claude-code-on-the-web), Claude Code оставляет цель активной, потому что хост восстанавливает доступ самостоятельно.

159* Исчерпанный баланс кредитов159* Исчерпанный баланс кредитов

160* Переполнение контекста, которое [auto-compact](/docs/ru/model-config#set-the-auto-compact-window) не смог очистить160* Переполнение контекста, которое [auto-compact](/docs/ru/model-config#set-the-auto-compact-window) не смог очистить

161* Модель, которая недоступна161* Модель, которая недоступна

headless.md +10 −2

Details

89* **Выполнение команды**: Claude Code записывает команду как убитую в сессии.89* **Выполнение команды**: Claude Code записывает команду как убитую в сессии.

90* **Ожидание ответа на запрос разрешения**: если вы отправите SIGTERM процессу, Claude Code оставляет запрос без ответа. Если ваша программа закрывает сессию через Agent SDK, SDK завершает ввод Claude Code перед отправкой любого сигнала, и Claude Code отменяет запрос, как только ввод завершается.90* **Ожидание ответа на запрос разрешения**: если вы отправите SIGTERM процессу, Claude Code оставляет запрос без ответа. Если ваша программа закрывает сессию через Agent SDK, SDK завершает ввод Claude Code перед отправкой любого сигнала, и Claude Code отменяет запрос, как только ввод завершается.

91 91

~~92Когда вы [возобновляете сессию](#continue-conversations), Claude Code продолжает ход, который SIGTERM оставил незавершённым.~~92Когда вы [возобновляете сессию](#continue-conversations), Claude Code оставляет прерванный ход как есть, и ваш следующий запрос ведёт разговор. Чтобы Claude Code продолжил прерванный ход при возобновлении вместо этого, установите [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN=1`](/docs/ru/env-vars).

94<h3 id="if-the-working-directory-is-deleted">

95 Если рабочий каталог удалён

96</h3>

98Если рабочий каталог сессии `claude -p` или Agent SDK удалён во время сессии, сессия продолжает работать. Когда ход начинается, пока каталог отсутствует, Claude Code выдаёт [предупреждающее сообщение](/docs/ru/agent-sdk/typescript#sdkinformationalmessage) в выводе `stream-json`, и команды оболочки не выполняются до тех пор, пока каталог снова не существует.

93 99

94<h2 id="examples">100<h2 id="examples">

95 Примеры101 Примеры

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

256| - | - | - |262| - | - | - |

258| `plugin_errors` | массив | ошибки загрузки plugin, каждая с `plugin`, `type` и `message`. Включает неудовлетворённые версии зависимостей и ошибки загрузки `--plugin-dir`, такие как отсутствующий путь или недопустимый архив. Затронутые plugins понижены в рейтинге и отсутствуют в `plugins`. Ключ опускается, когда нет ошибок |264| `plugin_errors` | массив | ошибки загрузки plugin, каждая с `plugin`, `type` и `message`. Включает неудовлетворённые версии зависимостей и ошибки загрузки `--plugin-dir`, такие как отсутствующий путь или недопустимый архив. Затронутые plugins отсутствуют в `plugins`. Ключ опускается, когда нет ошибок |

265

266Когда каталог `--plugin-dir` или архив сам не загружается, его запись `plugin_errors` включает разрешённый абсолютный путь как `path`. Используйте его, чтобы определить, какой из нескольких значений `--plugin-dir` не загрузился. Поле `path` требует Claude Code версии 2.1.283 или позже.

259 267

260Используйте поля MCP сервера так же. Когда вы передаёте [`--mcp-config`](/docs/ru/cli-reference#cli-flags) с `-p`, Claude Code ждёт всё ещё ожидающих серверов перед запуском первого хода, до [`MCP_TIMEOUT`](/docs/ru/env-vars) времени ожидания запуска, 30 секунд по умолчанию. Удалённый сервер с [кэшированным списком инструментов](/docs/ru/agent-sdk/mcp#connection-timing) пропускает ожидание, показывает `pending` в `system/init` и подключается при первом вызове инструмента. Ожидание требует Claude Code версии 2.1.221 или позже.268Используйте поля MCP сервера так же. Когда вы передаёте [`--mcp-config`](/docs/ru/cli-reference#cli-flags) с `-p`, Claude Code ждёт всё ещё ожидающих серверов перед запуском первого хода, до [`MCP_TIMEOUT`](/docs/ru/env-vars) времени ожидания запуска, 30 секунд по умолчанию. Удалённый сервер с [кэшированным списком инструментов](/docs/ru/agent-sdk/mcp#connection-timing) пропускает ожидание, показывает `pending` в `system/init` и подключается при первом вызове инструмента. Ожидание требует Claude Code версии 2.1.221 или позже.

261 269

hooks.md +28 −38

Details

474| `command` | да | Команда оболочки для выполнения. С `args`, исполняемый файл для прямого запуска. См. [Exec form and shell form](#exec-form-and-shell-form) |474| `command` | да | Команда оболочки для выполнения. С `args`, исполняемый файл для прямого запуска. См. [Exec form and shell form](#exec-form-and-shell-form) |

475| `args` | нет | Список аргументов. Когда присутствует, `command` разрешается как исполняемый файл и запускается напрямую с `args` как вектор аргументов, без участия оболочки. См. [Exec form and shell form](#exec-form-and-shell-form) |475| `args` | нет | Список аргументов. Когда присутствует, `command` разрешается как исполняемый файл и запускается напрямую с `args` как вектор аргументов, без участия оболочки. См. [Exec form and shell form](#exec-form-and-shell-form) |

476| `async` | нет | Если `true`, запускается в фоне без блокировки. См. [Run hooks in the background](#run-hooks-in-the-background) |476| `async` | нет | Если `true`, запускается в фоне без блокировки. См. [Run hooks in the background](#run-hooks-in-the-background) |

477| `asyncRewake` | нет | Если `true`, запускается в фоне и пробуждает Claude при коде выхода 2. Hook stderr или stdout, если stderr пусто, показывается Claude как системное напоминание, чтобы он мог реагировать на долгоживущий фоновый сбой |477| `asyncRewake` | нет | Если `true`, запускается в фоне и пробуждает Claude при коде выхода 2. Hook stderr или stdout, если stderr пусто, показывается Claude как [системное напоминание](/docs/ru/glossary#system-reminder) чтобы он мог реагировать на долгоживущий фоновый сбой |

478| `shell` | нет | Оболочка для использования для этого hook. Принимает `"bash"` или `"powershell"`. По умолчанию `"bash"`, или `"powershell"` на Windows когда Git Bash не установлен. Установка `"powershell"` запускает команду через PowerShell на Windows. Не требует `CLAUDE_CODE_USE_POWERSHELL_TOOL`, так как hooks порождают PowerShell напрямую. Игнорируется когда установлен `args` |478| `shell` | нет | Оболочка для использования для этого hook. Принимает `"bash"` или `"powershell"`. По умолчанию `"bash"`, или `"powershell"` на Windows когда Git Bash не установлен. Установка `"powershell"` запускает команду через PowerShell на Windows. Не требует `CLAUDE_CODE_USE_POWERSHELL_TOOL`, так как hooks порождают PowerShell напрямую. Игнорируется когда установлен `args` |

479 479

480<a id="exec-form-and-shell-form" />480<a id="exec-form-and-shell-form" />

571 571

573| :- | :- | :- |573| :- | :- | :- |

574| `server` | да | Имя настроенного MCP сервера. Для [plugin-bundled server](/docs/ru/mcp#plugin-provided-mcp-servers), это имя с областью `plugin:<plugin-name>:<server-name>`, такое как `plugin:my-plugin:db`, не голый ключ сервера. Сервер должен быть уже подключён; hook никогда не запускает поток OAuth или подключения |574| `server` | да | Имя настроенного MCP сервера. Для [plugin-bundled server](/docs/ru/mcp#plugin-provided-mcp-servers), это имя с областью `plugin:<plugin-name>:<server-name>`, такое как `plugin:my-plugin:db`, не голый ключ сервера |

575| `tool` | да | Имя инструмента для вызова на этом сервере |575| `tool` | да | Имя инструмента для вызова на этом сервере |

576| `input` | нет | Аргументы, передаваемые инструменту. Строковые значения поддерживают подстановку `${path}` из [JSON входа](#hook-input-and-output) hook, такую как `"${tool_input.file_path}"` |576| `input` | нет | Аргументы, передаваемые инструменту. Строковые значения поддерживают подстановку `${path}` из [JSON входа](#hook-input-and-output) hook, такую как `"${tool_input.file_path}"` |

577 577

578Claude Code читает текстовое содержимое инструмента так же, как читает command-hook stdout, следуя [правилу разбора под кодом выхода 0](#exit-code-0). Если названный сервер не подключён или инструмент возвращает `isError: true`, hook производит неблокирующую ошибку и выполнение продолжается.

~~579~~

580Этот пример вызывает инструмент `security_scan` на MCP сервере `my_server` после каждого `Write` или `Edit`, передавая путь отредактированного файла:578Этот пример вызывает инструмент `security_scan` на MCP сервере `my_server` после каждого `Write` или `Edit`, передавая путь отредактированного файла:

581 579

582```json theme={null}580```json theme={null}

599}597}

600```598```

601 599

602MCP tool hook может запускаться только после того, как Claude Code сделал MCP серверы сеанса доступными для hooks. `SessionStart` и `Setup` могут срабатывать до этого момента:600<h5 id="how-the-tool’s-result-is-read">

601 How the tool's result is read

602</h5>

603 603

604* **При запуске**: `SessionStart` срабатывает перед доступностью серверов, включая когда вы запускаете с `--continue` или `--resume`. Claude Code пропускает `mcp_tool` hooks события без вызова их инструментов, и [debug log](#debug-hooks) записывает `mcp_tool hooks are not available for the 'SessionStart' hook event (no MCP client context)`.604Claude Code читает текстовое содержимое инструмента так же, как читает command-hook stdout, следуя [правилу разбора под кодом выхода 0](#exit-code-0). Если инструмент возвращает `isError: true`, hook производит неблокирующую ошибку и выполнение продолжается.

605* **Позже в работающем сеансе**: после `/clear` или компактирования, `SessionStart` срабатывает снова с серверами уже доступными, и его `mcp_tool` hooks запускаются.

606* **На `Setup`**: `Setup` всегда срабатывает перед доступностью серверов, поэтому Claude Code пропускает его `mcp_tool` hooks каждый раз и записывает то же сообщение, называющее `Setup`.

607 605

608Например, эта конфигурация вызывает инструмент `load_context` на MCP сервере `my_server` из hook `SessionStart` без фильтра, поэтому она применяется к каждому источнику `SessionStart`:606<h5 id="when-the-server-is-still-connecting">

607 When the server is still connecting

608</h5>

609 609

610```json theme={null}610На событиях, где hook может блокировать или изменять результат, такие как `PreToolUse` или `Stop`, Claude Code ждёт подключения сервера перед вызовом инструмента, максимум [`MCP_TIMEOUT`](/docs/ru/env-vars) и в пределах собственного [`timeout`](#common-fields) hook. На наблюдательных событиях, таких как `Notification` или `SessionEnd`, он не ждёт.

611{611

612 "hooks": {612Сервер, показывающий статус [`cached`](/docs/ru/mcp#server-status-detail), подключается, когда hook вызывает его инструмент. Если сервер не подключён в этот момент, hook производит неблокирующую ошибку и выполнение продолжается. Hook никогда не запускает поток OAuth, поэтому [аутентифицируйте сервер из `/mcp`](/docs/ru/mcp#authenticate-with-remote-mcp-servers) сначала.

613 "SessionStart": [613

614 {614<h5 id="events-that-fire-before-mcp-servers-are-available">

615 "hooks": [615 Events that fire before MCP servers are available

616 {616</h5>

617 "type": "mcp_tool",

618 "server": "my_server",

619 "tool": "load_context"

620 }

621 ]

622 }

623 ]

624 }

625}

626```

627 617

628Когда вы запускаете `claude`, Claude Code пропускает этот hook, никогда не вызывает `load_context` и записывает сообщение `no MCP client context` в debug log. Запустите `/clear` в том же сеансе и hook запустится и вызовет `load_context`. Hook `type: "command"` на `SessionStart` запускается при запуске, поэтому используйте один для всего, что сеансу нужно с его первого хода.618`SessionStart` при запуске, включая с `--continue` или `--resume`, и каждое событие `Setup` срабатывают перед доступностью MCP серверов сеанса для hooks. Claude Code пропускает их `mcp_tool` hooks без вызова инструмента, и [debug log](#debug-hooks) записывает `mcp_tool hooks are not available for the 'SessionStart' hook event (no MCP client context)`, или то же сообщение, называющее `Setup`. Когда `SessionStart` срабатывает снова позже в сеансе, после `/clear` или компактирования, его `mcp_tool` hooks запускаются. Для всего, что сеансу нужно при запуске, используйте `type: "command"` hook на `SessionStart` вместо этого.

629 619

630<h4 id="prompt-and-agent-hook-fields">620<h4 id="prompt-and-agent-hook-fields">

631 Prompt and agent hook fields621 Prompt and agent hook fields

637| :- | :- | :- |627| :- | :- | :- |

638| `prompt` | да | Текст подсказки для отправки модели. Используйте `$ARGUMENTS` как заполнитель для JSON входа hook. Экранируйте обратной косой чертой для включения буквального текста: `\$1.00` отображается как `$1.00` |628| `prompt` | да | Текст подсказки для отправки модели. Используйте `$ARGUMENTS` как заполнитель для JSON входа hook. Экранируйте обратной косой чертой для включения буквального текста: `\$1.00` отображается как `$1.00` |

639| `model` | нет | Модель для использования при оценке. По умолчанию быстрая модель |629| `model` | нет | Модель для использования при оценке. По умолчанию модель, которую Claude Code использует для [фоновой функциональности](/docs/ru/costs#background-token-usage) |

640 630

641<h3 id="reference-scripts-by-path">631<h3 id="reference-scripts-by-path">

642 Reference scripts by path632 Reference scripts by path

791| `prompt_id` | UUID, идентифицирующий пользовательский запрос, который в настоящее время обрабатывается. Совпадает с атрибутом [`prompt.id` на событиях OpenTelemetry](/docs/ru/monitoring-usage#event-correlation-attributes), поэтому вы можете коррелировать выход hook с телеметрией для одного запроса. Отсутствует до первого ввода пользователя. Требуется Claude Code v2.1.196 или позже |781| `prompt_id` | UUID, идентифицирующий пользовательский запрос, который в настоящее время обрабатывается. Совпадает с атрибутом [`prompt.id` на событиях OpenTelemetry](/docs/ru/monitoring-usage#event-correlation-attributes), поэтому вы можете коррелировать выход hook с телеметрией для одного запроса. Отсутствует до первого ввода пользователя. Требуется Claude Code v2.1.196 или позже |

792| `transcript_path` | Путь к файлу JSON разговора. Файл транскрипта записывается асинхронно и может отставать от разговора в памяти, поэтому он может еще не включать самые последние сообщения текущего хода, когда срабатывает hook. Hooks, которым нужен финальный текст ассистента текущего хода, должны использовать `last_assistant_message` на [Stop](#stop) и [SubagentStop](#subagentstop) вместо чтения транскрипта |782| `transcript_path` | Путь к файлу JSON разговора. Файл транскрипта записывается асинхронно и может отставать от разговора в памяти, поэтому он может еще не включать самые последние сообщения текущего хода, когда срабатывает hook. Hooks, которым нужен финальный текст ассистента текущего хода, должны использовать `last_assistant_message` на [Stop](#stop) и [SubagentStop](#subagentstop) вместо чтения транскрипта |

793| `cwd` | Текущий рабочий каталог при вызове hook |783| `cwd` | Текущий рабочий каталог при вызове hook |

794| `scratchpad_dir` | Путь к каталогу scratchpad сеанса, где Claude хранит временные рабочие файлы. Отсутствует, когда сеанс не имеет scratchpad или временный каталог недоступен. Требуется Claude Code v2.1.257 или позже |784| `scratchpad_dir` | Путь к [каталогу scratchpad сеанса](/docs/ru/claude-directory#session-scratchpad-directory), где Claude хранит временные рабочие файлы. Отсутствует, когда сеанс не имеет scratchpad или временный каталог недоступен. Требуется Claude Code v2.1.257 или позже |

795| `permission_mode` | Текущий [режим разрешений](/docs/ru/permissions#permission-modes): `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` или `"bypassPermissions"`. Режим, обозначенный как **Manual**, поступает как `"default"`, никогда не как `"manual"`, поэтому скрипты, которые совпадают с `"default"`, продолжают работать. Не все события получают это поле. Проверьте пример JSON в каждом разделе [hook event](#hook-events) |785| `permission_mode` | Текущий [режим разрешений](/docs/ru/permissions#permission-modes): `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` или `"bypassPermissions"`. Режим, обозначенный как **Manual**, поступает как `"default"`, никогда не как `"manual"`, поэтому скрипты, которые совпадают с `"default"`, продолжают работать. Не все события получают это поле. Проверьте пример JSON в каждом разделе [hook event](#hook-events) |

796| `effort` | Объект с полем `level`, содержащим [уровень усилий](/docs/ru/model-config#adjust-effort-level), действующий при запуске hook: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Если вы установите уровень, который активная модель не поддерживает, `level` сообщает уровень, который вместо этого запустил Claude Code; [Adjust effort level](/docs/ru/model-config#adjust-effort-level) говорит, как он выбирает этот уровень. Ultracode не является отдельным уровнем и сообщается как `"xhigh"`. Объект совпадает с полем `effort` [строки состояния](/docs/ru/statusline#available-data). Присутствует для событий, которые срабатывают в контексте использования инструмента, таких как `PreToolUse`, `PostToolUse`, `Stop` и `SubagentStop`, когда текущая модель поддерживает параметр усилий. Уровень также доступен для команд hook и инструмента Bash как переменная окружения `$CLAUDE_EFFORT`. |786| `effort` | Объект с полем `level`, содержащим [уровень усилий](/docs/ru/model-config#adjust-effort-level), действующий при запуске hook: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Если вы установите уровень, который активная модель не поддерживает, `level` сообщает уровень, который вместо этого запустил Claude Code; [Adjust effort level](/docs/ru/model-config#adjust-effort-level) говорит, как он выбирает этот уровень. Объект совпадает с полем `effort` [строки состояния](/docs/ru/statusline#available-data). Присутствует для событий, которые срабатывают в контексте использования инструмента, таких как `PreToolUse`, `PostToolUse`, `Stop` и `SubagentStop`, когда текущая модель поддерживает параметр усилий. Уровень также доступен для команд hook и инструмента Bash как переменная окружения `$CLAUDE_EFFORT`. |

798 788

799При запуске с `--agent` или внутри subagent включаются два дополнительных поля:789При запуске с `--agent` или внутри subagent включаются два дополнительных поля:

1057 Add context for Claude1047 Add context for Claude

1058</h4>1048</h4>

1059 1049

1060Поле `additionalContext` передает строку из вашего hook в контекстное окно Claude. Claude Code оборачивает строку в напоминание системы и вставляет ее в разговор в точке, где сработал hook. Claude читает напоминание при следующем запросе модели, но оно не появляется как сообщение чата в интерфейсе.1050Поле `additionalContext` передает строку из вашего hook в контекстное окно Claude. Claude Code оборачивает строку в [напоминание системы](/docs/ru/glossary#system-reminder) и вставляет ее в разговор в точке, где сработал hook. Claude читает напоминание при следующем запросе модели, но оно не появляется как сообщение чата в интерфейсе.

1061 1051

1062Верните `additionalContext` внутри `hookSpecificOutput` рядом с именем события:1052Верните `additionalContext` внутри `hookSpecificOutput` рядом с именем события:

1063 1053

1938| Поле | Описание |1928| Поле | Описание |

1939| :- | :- |1929| :- | :- |

1940| `permissionDecision` | `"allow"` пропускает подсказку разрешения, кроме [действий, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves) и для `AskUserQuestion` и `ExitPlanMode`, которым нужна [`updatedInput`, связанная с ней](#allow-with-updatedinput). `"deny"` предотвращает вызов инструмента. `"ask"` подсказывает пользователю подтвердить. `"defer"` выходит корректно, чтобы инструмент можно было возобновить позже. [Правила отказа и запроса](/docs/ru/permissions#manage-permissions) все еще оцениваются независимо от того, что возвращает hook |1930| `permissionDecision` | `"allow"` пропускает подсказку разрешения, кроме [действий, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves) и для `AskUserQuestion` и `ExitPlanMode`, которым нужна [`updatedInput`, связанная с ней](#allow-with-updatedinput). `"deny"` предотвращает вызов инструмента. `"ask"` подсказывает пользователю подтвердить. `"defer"` выходит корректно, чтобы инструмент можно было возобновить позже. [Правила отказа и запроса](/docs/ru/permissions#manage-permissions) все еще оцениваются независимо от того, что возвращает hook |

1941| `permissionDecisionReason` | Для `"allow"` и `"ask"`, показано пользователю, но не Claude. Для `"deny"`, показано Claude. Для `"defer"`, игнорируется |1931| `permissionDecisionReason` | Для `"deny"`, показано Claude. Для `"ask"`, показано пользователю, но не Claude. Для `"allow"` и `"defer"`, написано в [debug log](#debug-hooks) только |

1942| `updatedInput` | Изменяет параметры ввода инструмента перед выполнением. Заменяет весь объект ввода, поэтому включите неизменные поля рядом с измененными. Claude Code оценивает правила разрешения и [автоматическую фоновую приемлемость](/docs/ru/tools-reference#background-commands) команды Bash против ввода, который возвращает ваш hook, а не ввода, который отправил Claude. Объедините с `"allow"` для автоматического одобрения или с `"ask"` для показа измененного ввода пользователю. Для `"defer"`, игнорируется |1932| `updatedInput` | Изменяет параметры ввода инструмента перед выполнением. Заменяет весь объект ввода, поэтому включите неизменные поля рядом с измененными. Claude Code оценивает правила разрешения и [автоматическую фоновую приемлемость](/docs/ru/tools-reference#background-commands) команды Bash против ввода, который возвращает ваш hook, а не ввода, который отправил Claude. Объедините с `"allow"` для автоматического одобрения или с `"ask"` для показа измененного ввода пользователю. Для `"defer"`, игнорируется |

1943| `additionalContext` | Строка, добавленная в контекст Claude рядом с результатом инструмента. Игнорируется, когда `permissionDecision` имеет значение `"defer"`. См. [Add context for Claude](#add-context-for-claude) |1933| `additionalContext` | Строка, добавленная в контекст Claude рядом с результатом инструмента. Игнорируется, когда `permissionDecision` имеет значение `"defer"`. См. [Add context for Claude](#add-context-for-claude) |

1944 1934

2011Если отложенный инструмент больше не доступен при возобновлении, процесс выходит с `stop_reason: "tool_deferred_unavailable"` и `is_error: true` перед срабатыванием hook. Это происходит, когда сервер MCP, который предоставил инструмент, не подключен для возобновленного сеанса. Полезная нагрузка `deferred_tool_use` все еще включена, чтобы вы могли определить, какой инструмент исчез.2001Если отложенный инструмент больше не доступен при возобновлении, процесс выходит с `stop_reason: "tool_deferred_unavailable"` и `is_error: true` перед срабатыванием hook. Это происходит, когда сервер MCP, который предоставил инструмент, не подключен для возобновленного сеанса. Полезная нагрузка `deferred_tool_use` все еще включена, чтобы вы могли определить, какой инструмент исчез.

2012 2002

2013<Note>2003<Note>

2014 Чтобы возобновить отложенный сеанс в режиме плана, передайте [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) вместе с `--resume`, чтобы Claude Code мог представить план для одобрения. Без него Claude Code не восстанавливает режим плана. Требует Claude Code v2.1.246 или позже.2004 Чтобы возобновить отложенный сеанс в режиме плана, передайте [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) вместе с `--resume`, чтобы Claude Code мог представить план для одобрения. Если вы передаете определенные другие флаги запуска, возобновленный запуск не возвращается в режим плана; см. [Resume in plan mode with `-p`](/docs/ru/sessions#resume-in-plan-mode-with-p). Требует Claude Code v2.1.246 или позже.

2015 2005

2016 Когда вы возобновляете с `-p`, Claude Code не восстанавливает никакой другой сохраненный режим разрешений. Он запускает запуск в режиме разрешений, который новый запуск `claude -p` запустил бы, поэтому передайте `--permission-mode` или `--dangerously-skip-permissions` снова, если отложенный сеанс использовал один. Когда вы возобновляете с `claude --resume <session-id>` без `-p`, Claude Code восстанавливает сохраненный режим разрешений, с исключениями, перечисленными в [режим разрешений при возобновлении](/docs/ru/sessions#permission-mode-on-resume).2006 Когда вы возобновляете с `-p`, Claude Code не восстанавливает никакой другой сохраненный режим разрешений. Он запускает запуск в режиме разрешений, который новый запуск `claude -p` запустил бы, поэтому передайте `--permission-mode` или `--dangerously-skip-permissions` снова, если отложенный сеанс использовал один. Когда вы возобновляете с `claude --resume <session-id>` без `-p`, Claude Code восстанавливает сохраненный режим разрешений, с исключениями, перечисленными в [режим разрешений при возобновлении](/docs/ru/sessions#permission-mode-on-resume).

2017</Note>2007</Note>

2331 "tool_name": "Read",2321 "tool_name": "Read",

2332 "tool_input": {"file_path": "/.../ledger/accounts.py"},2322 "tool_input": {"file_path": "/.../ledger/accounts.py"},

2333 "tool_use_id": "toolu_01...",2323 "tool_use_id": "toolu_01...",

2334 "tool_response": " 1\tfrom __future__ import annotations\n 2\t..."2324 "tool_response": "1\tfrom __future__ import annotations\n2\t..."

2335 },2325 },

2336 {2326 {

2337 "tool_name": "Read",2327 "tool_name": "Read",

2338 "tool_input": {"file_path": "/.../ledger/transactions.py"},2328 "tool_input": {"file_path": "/.../ledger/transactions.py"},

2339 "tool_use_id": "toolu_02...",2329 "tool_use_id": "toolu_02...",

2340 "tool_response": " 1\tfrom __future__ import annotations\n 2\t..."2330 "tool_response": "1\tfrom __future__ import annotations\n2\t..."

2341 }2331 }

2342 ]2332 ]

2343}2333}

2739 Ввод Stop2729 Ввод Stop

2740</h4>2730</h4>

2741 2731

2742Помимо [общих полей ввода](#common-input-fields), hooks Stop получают `stop_hook_active`, `last_assistant_message`, `background_tasks` и `session_crons`. Поле `stop_hook_active` имеет значение `true`, когда Claude Code уже продолжает в результате hook stop. Проверьте это значение или обработайте транскрипт, чтобы избежать блокировки на условии, которое никогда не разрешится. Claude Code переопределяет hook и заканчивает ход после 8 последовательных блокировок.2732Помимо [общих полей ввода](#common-input-fields), hooks Stop получают `stop_hook_active`, `last_assistant_message`, `background_tasks` и `session_crons`. Поле `stop_hook_active` имеет значение `true`, когда Claude Code уже продолжает в результате hook stop. Проверьте это значение или обработайте транскрипт, чтобы избежать блокировки на условии, которое никогда не разрешится. Claude Code переопределяет hook и заканчивает ход после 8 последовательных блокировок. Чтобы повысить ограничение, установите [`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`](/docs/ru/env-vars).

2743 2733

2744Поле `last_assistant_message` содержит текстовое содержимое финального ответа Claude, поэтому hooks могут получить доступ к нему без анализа файла транскрипта. Для hooks, которые действуют на только что завершенный ход, такие как hooks чтения вслух или уведомления, используйте это поле, а не читайте `transcript_path`: файл транскрипта не гарантируется включать финальное сообщение во время Stop на всех версиях.2734Поле `last_assistant_message` содержит текстовое содержимое финального ответа Claude, поэтому hooks могут получить доступ к нему без анализа файла транскрипта. Для hooks, которые действуют на только что завершенный ход, такие как hooks чтения вслух или уведомления, используйте это поле, а не читайте `transcript_path`: файл транскрипта не гарантируется включать финальное сообщение во время Stop на всех версиях.

2745 2735

3804 3794

3805Вместо выполнения команды Bash, prompt-based hooks:3795Вместо выполнения команды Bash, prompt-based hooks:

3806 3796

38071. Отправляют входные данные hook и вашу подсказку модели Claude, Haiku по умолчанию37971. Отправляют входные данные hook и вашу подсказку модели Claude, по умолчанию той, которую Claude Code использует для [фоновой функциональности](/docs/ru/costs#background-token-usage)

38082. LLM отвечает структурированным JSON, содержащим решение37982. LLM отвечает структурированным JSON, содержащим решение

38093. Claude Code автоматически обрабатывает решение37993. Claude Code автоматически обрабатывает решение

3810 3800

3837| :- | :- | :- |3827| :- | :- | :- |

3838| `type` | да | Должно быть `"prompt"` |3828| `type` | да | Должно быть `"prompt"` |

3839| `prompt` | да | Текст подсказки для отправки LLM. Используйте `$ARGUMENTS` как заполнитель для JSON входа hook. Если `$ARGUMENTS` отсутствует, JSON входа добавляется к подсказке |3829| `prompt` | да | Текст подсказки для отправки LLM. Используйте `$ARGUMENTS` как заполнитель для JSON входа hook. Если `$ARGUMENTS` отсутствует, JSON входа добавляется к подсказке |

3840| `model` | нет | Модель для использования при оценке. По умолчанию быстрая модель |3830| `model` | нет | Модель для использования при оценке. По умолчанию модель, которую Claude Code использует для [фоновой функциональности](/docs/ru/costs#background-token-usage) |

3841| `timeout` | нет | Таймаут в секундах. По умолчанию: 30 |3831| `timeout` | нет | Таймаут в секундах. По умолчанию: 30 |

3842| `continueOnBlock` | нет | На событиях, к которым это применяется, `true` передаёт причину `ok: false` обратно Claude и продолжает вместо завершения хода. По умолчанию: `false`. См. [Response schema](#response-schema) для поведения для каждого события |3832| `continueOnBlock` | нет | На событиях, к которым это применяется, `true` передаёт причину `ok: false` обратно Claude и продолжает вместо завершения хода. По умолчанию: `false`. См. [Response schema](#response-schema) для поведения для каждого события |

3843 3833

hooks-guide.md +2 −2

Details

880 Hooks на основе подсказок880 Hooks на основе подсказок

881</h2>881</h2>

882 882

883Для решений, требующих суждения, а не детерминированных правил, используйте hooks `type: "prompt"`. Вместо запуска команды оболочки Claude Code отправляет вашу подсказку и данные ввода hook модели Claude (Haiku по умолчанию) для принятия решения. Вы можете указать другую модель с полем `model`, если вам нужна большая возможность.883Для решений, требующих суждения, а не детерминированных правил, используйте hooks `type: "prompt"`. Вместо запуска команды оболочки Claude Code отправляет вашу подсказку и данные ввода hook модели Claude для принятия решения. Вы можете указать другую модель с полем `model`, если вам нужна большая возможность.

884 884

885Единственная работа модели — вернуть решение в виде JSON:885Единственная работа модели — вернуть решение в виде JSON:

886 886

995 995

996Помните об этих ограничениях при разработке hooks:996Помните об этих ограничениях при разработке hooks:

997 997

998* Command hooks взаимодействуют только через stdout, stderr и коды выхода. Они не могут запускать команды `/` или вызовы инструментов. Текст, возвращённый через `additionalContext`, внедряется как системное напоминание, которое Claude читает как простой текст. HTTP hooks взаимодействуют через тело ответа вместо этого.998* Command hooks взаимодействуют только через stdout, stderr и коды выхода. Они не могут запускать команды `/` или вызовы инструментов. Текст, возвращённый через `additionalContext`, внедряется как [системное напоминание](/docs/ru/glossary#system-reminder), которое Claude читает как простой текст. HTTP hooks взаимодействуют через тело ответа вместо этого.

999* Время ожидания hook варьируется в зависимости от типа. Переопределите для каждого hook с помощью поля `timeout` в секундах.999* Время ожидания hook варьируется в зависимости от типа. Переопределите для каждого hook с помощью поля `timeout` в секундах.

1000 * `command`, `http`, `mcp_tool`: 10 минут. Claude Code снижает это значение по умолчанию до 30 секунд для hooks `UserPromptSubmit`, `PreModelSwitch` и `PostModelSwitch`, и до 10 секунд для `MessageDisplay`.1000 * `command`, `http`, `mcp_tool`: 10 минут. Claude Code снижает это значение по умолчанию до 30 секунд для hooks `UserPromptSubmit`, `PreModelSwitch` и `PostModelSwitch`, и до 10 секунд для `MessageDisplay`.

1001 * `prompt`: 30 секунд.1001 * `prompt`: 30 секунд.

how-claude-code-works.md +19 −6

Details

144 144

145Для интерактивного пошагового руководства по тому, что загружается и когда, см. [Исследуйте context window](/docs/ru/context-window).145Для интерактивного пошагового руководства по тому, что загружается и когда, см. [Исследуйте context window](/docs/ru/context-window).

146 146

147<h4 id="context-claude-code-adds-on-its-own">

148 Context Claude Code добавляет самостоятельно

149</h4>

150

151Если Claude следует правилу, которое вы не писали, например добавляет трейлер `Co-Authored-By` к коммиту, правило могло поступить из [системного напоминания](/docs/ru/glossary#system-reminder). По мере работы Claude Code добавляет свой собственный контекст к беседе наряду с вашими сообщениями:

152

153* Ваши файлы CLAUDE.md

154* Инструкции вашего [стиля вывода](/docs/ru/output-styles)

155* Примечание, когда файл, который Claude читал ранее, изменяется на диске

156* Строки атрибуции коммита и pull request

157

158Чтобы изменить или удалить строки атрибуции, установите [`attribution`](/docs/ru/settings-reference#attribution). Чтобы удалить встроенные инструкции Claude Code для коммитов и pull request, установите [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions) на `false`. Для других переключателей см. [Отключение контекста, который заменяет ваш агент](/docs/ru/agent-sdk/modifying-system-prompts#turn-off-the-context-your-agent-replaces).

159

147<h4 id="when-context-fills-up">160<h4 id="when-context-fills-up">

148 Когда контекст заполняется161 Когда контекст заполняется

149</h4>162</h4>

169Информацию о том, что стоит каждая функция, см. в разделе [затраты контекста](/docs/ru/features-overview#understand-context-costs), а советы по управлению контекстом см. в разделе [снижение использования токенов](/docs/ru/costs#reduce-token-usage).182Информацию о том, что стоит каждая функция, см. в разделе [затраты контекста](/docs/ru/features-overview#understand-context-costs), а советы по управлению контекстом см. в разделе [снижение использования токенов](/docs/ru/costs#reduce-token-usage).

170 183

171<h2 id="stay-safe-with-checkpoints-and-permissions">184<h2 id="stay-safe-with-checkpoints-and-permissions">

172 Оставайтесь в безопасности с контрольными точками и разрешениями185 Оставайтесь в безопасности с checkpoints и разрешениями

173</h2>186</h2>

174 187

175Claude имеет два механизма безопасности: контрольные точки позволяют откатывать изменения файлов, а разрешения контролируют, что Claude может делать без запроса.188Claude имеет два механизма безопасности: checkpoints позволяют откатывать изменения файлов, а разрешения контролируют, что Claude может делать без запроса.

176 189

177<h3 id="undo-changes-with-checkpoints">190<h3 id="undo-changes-with-checkpoints">

178 Откат изменений с контрольными точками191 Откат изменений с checkpoints

179</h3>192</h3>

180 193

181**Каждое редактирование файла обратимо.** Перед редактированием любого файла Claude создаёт снимок текущего содержимого. Если что-то пойдёт не так, нажмите `Esc` дважды, чтобы откатиться к предыдущему состоянию, или попросите Claude отменить.194**Каждое редактирование файла обратимо.** Перед редактированием любого файла Claude создаёт снимок текущего содержимого. Если что-то пойдёт не так, нажмите `Esc` дважды, чтобы откатиться к предыдущему состоянию, или попросите Claude отменить.

182 195

183Контрольные точки отделены от git и остаются доступными при возобновлении разговора. Они охватывают только изменения файлов, и восстановление [пропускает символические и жёсткие ссылки](/docs/ru/checkpointing#symlinked-and-hard-linked-paths-not-restored). Действия, которые влияют на удалённые системы (базы данных, API, развёртывания), не могут быть контрольными точками. Вы контролируете их с помощью режима разрешений и правил разрешений.196Checkpoints отделены от git и остаются доступными при возобновлении разговора. Они охватывают только изменения файлов, и восстановление [пропускает символические и жёсткие ссылки](/docs/ru/checkpointing#symlinked-and-hard-linked-paths-not-restored). Действия, которые влияют на удалённые системы (базы данных, API, развёртывания), не могут быть checkpointed. Вы контролируете их с помощью режима разрешений и правил разрешений.

184 197

185<h3 id="control-what-claude-can-do">198<h3 id="control-what-claude-can-do">

186 Контролируйте, что может делать Claude199 Контролируйте, что может делать Claude

188 201

189Выберите режим разрешений, чтобы установить, что Claude может делать без запроса. Нажмите `Shift+Tab`, чтобы циклически переключаться между режимами разрешений:202Выберите режим разрешений, чтобы установить, что Claude может делать без запроса. Нажмите `Shift+Tab`, чтобы циклически переключаться между режимами разрешений:

190 203

191* **Auto**: классификатор проверяет большинство действий в фоновом режиме и блокирует рискованные вместо того, чтобы спрашивать вас. На планах Pro, Max и Team это [встроенный начальный режим разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in) для интерактивных сеансов терминала и VS Code204* **Auto**: классификатор проверяет большинство действий в фоновом режиме и блокирует рискованные вместо того, чтобы спрашивать вас. На Claude Code v2.1.283 или позже это [встроенный начальный режим разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in) для интерактивных сеансов терминала и VS Code, а на более ранних версиях только на планах Pro, Max и Team

192* **Manual**: Claude спрашивает перед редактированием файлов и командами shell205* **Manual**: Claude спрашивает перед редактированием файлов и командами shell

193* **Accept edits**: Claude редактирует файлы и запускает общие команды файловой системы, такие как `mkdir` и `mv`, без запроса, всё ещё спрашивает для других команд206* **Accept edits**: Claude редактирует файлы и запускает общие команды файловой системы, такие как `mkdir` и `mv`, без запроса, всё ещё спрашивает для других команд

194* **Plan**: Claude исследует и предлагает план без редактирования ваших исходных файлов207* **Plan**: Claude исследует и предлагает план без редактирования ваших исходных файлов

241Вы можете перенаправить Claude в любой момент без начала заново. Сделайте одно из следующего:254Вы можете перенаправить Claude в любой момент без начала заново. Сделайте одно из следующего:

242 255

243* **Нажмите `Esc`**, чтобы остановить Claude немедленно. Выполняемый вызов инструмента отменяется, и Claude ожидает вашей следующей инструкции. Если у вас есть сообщения в очереди, Claude Code [отправляет их далее](/docs/ru/interactive-mode#queue-messages-while-claude-works).256* **Нажмите `Esc`**, чтобы остановить Claude немедленно. Выполняемый вызов инструмента отменяется, и Claude ожидает вашей следующей инструкции. Если у вас есть сообщения в очереди, Claude Code [отправляет их далее](/docs/ru/interactive-mode#queue-messages-while-claude-works).

244* **Введите коррекцию и нажмите `Enter`** без остановки Claude. Сообщение отображается как поставленное в очередь над полем ввода. Если Claude выполняет вызовы инструментов, он прочитает сообщение, как только эти вызовы завершатся, в рамках того же хода, и скорректирует перед своим следующим шагом. [Поставьте сообщения в очередь, пока Claude работает](/docs/ru/interactive-mode#queue-messages-while-claude-works) охватывает, когда отправляются другие поставленные в очередь записи.257* **Введите коррекцию и нажмите `Enter`** без остановки Claude. Сообщение отображается как поставленное в очередь в разговоре. Если Claude выполняет вызовы инструментов, он прочитает сообщение, как только эти вызовы завершатся, в рамках того же хода, и скорректирует перед своим следующим шагом. [Поставьте сообщения в очередь, пока Claude работает](/docs/ru/interactive-mode#queue-messages-while-claude-works) охватывает, когда отправляются другие поставленные в очередь записи.

245 258

246<h3 id="delegate-don’t-dictate">259<h3 id="delegate-don’t-dictate">

247 Делегируйте, не диктуйте260 Делегируйте, не диктуйте

interactive-mode.md +21 −13

Details

34| `Ctrl+T` | Переключение контрольного списка задач Claude | Показать или скрыть [контрольный список задач Claude](#task-list) в области состояния. Это не представление фоновых задач; используйте [`/tasks`](/docs/ru/commands) для просмотра работающих оболочек и подагентов |34| `Ctrl+T` | Переключение контрольного списка задач Claude | Показать или скрыть [контрольный список задач Claude](#task-list) в области состояния. Это не представление фоновых задач; используйте [`/tasks`](/docs/ru/commands) для просмотра работающих оболочек и подагентов |

35| `Ctrl+S` | Сохранить или восстановить подсказку | Если в вводе есть текст, сохраняет его и очищает подсказку. При нажатии снова на пустой подсказке восстанавливает сохраненный текст, позицию курсора, вставленное содержимое и режим ввода, поэтому сохраненная команда shell `!` [shell command](#shell-mode-with-prefix) возвращается в режиме shell |35| `Ctrl+S` | Сохранить или восстановить подсказку | Если в вводе есть текст, сохраняет его и очищает подсказку. При нажатии снова на пустой подсказке восстанавливает сохраненный текст, позицию курсора, вставленное содержимое и режим ввода, поэтому сохраненная команда shell `!` [shell command](#shell-mode-with-prefix) возвращается в режиме shell |

37| `Left/Right arrows` | Циклический переход по вкладкам диалога | Навигация между вкладками в диалогах разрешений и меню |37| `Left/Right arrows` | Циклический переход по вкладкам диалога | Навигация между вкладками в диалогах разрешений и меню. В диалоге с вкладками клавиши переключают вкладки, пока строка вкладок имеет фокус. См. [Действия вкладок](/docs/ru/keybindings#tabs-actions) для информации о том, как перемещается фокус |

38| `Tab` | Принять предложение автодополнения или добавить комментарий к ответу разрешения | Пока в вводе подсказки отображаются предложения автодополнения, принимает выбранное предложение. В большинстве подсказок разрешений с сфокусированным **Yes** или **No** открывает поле комментария для этого параметра, а повторное нажатие закрывает поле. См. [добавить комментарий при ответе на подсказку разрешения](/docs/ru/permissions#add-a-comment-when-you-answer-a-permission-prompt) |38| `Tab` | Принять предложение автодополнения или добавить комментарий к ответу разрешения | Пока в вводе подсказки отображаются предложения автодополнения, принимает выбранное предложение. В большинстве подсказок разрешений с сфокусированным **Yes** или **No** открывает поле комментария для этого параметра, а повторное нажатие закрывает поле. См. [добавить комментарий при ответе на подсказку разрешения](/docs/ru/permissions#add-a-comment-when-you-answer-a-permission-prompt) |

39| `Up/Down arrows` или `Ctrl+P`/`Ctrl+N` | Перемещение курсора или навигация по истории команд | Когда ввод занимает более одной визуальной строки, будь то обернутый или многострочный, сначала перемещает курсор в подсказке. Когда курсор находится на первой или последней визуальной строке, повторное нажатие переходит по истории команд. Пока у вас есть очередные сообщения, `Up` с первой строки вместо этого [берет их обратно](#take-back-what-you-queued) |39| `Up/Down arrows` или `Ctrl+P`/`Ctrl+N` | Перемещение курсора или навигация по истории команд | Когда ввод занимает более одной визуальной строки, будь то обернутый или многострочный, сначала перемещает курсор в подсказке. Когда курсор находится на первой или последней визуальной строке, повторное нажатие переходит по истории команд. Пока у вас есть очередные сообщения, `Up` с первой строки вместо этого [берет их обратно](#take-back-what-you-queued) |

40| `Esc` | Прерывание Claude или закрытие диалога | Остановить текущий ответ или вызов инструмента в середине хода, чтобы вы могли перенаправить. Claude сохраняет выполненную работу. Если у вас есть [очередные сообщения](#queue-messages-while-claude-works), Claude Code отправляет их дальше. Когда диалог открыт, `Esc` закрывает диалог. На подсказке разрешения `Esc` отклоняет действие, то же самое, что [**No** без комментария](/docs/ru/permissions#add-a-comment-when-you-answer-a-permission-prompt) |40| `Esc` | Прерывание Claude или закрытие диалога | Остановить текущий ответ или вызов инструмента в середине хода, чтобы вы могли перенаправить. Claude сохраняет выполненную работу. Если у вас есть [очередные сообщения](#queue-messages-while-claude-works), Claude Code отправляет их дальше. Когда диалог открыт, `Esc` закрывает диалог. Пока элемент нижнего колонтитула выбран, такой как строка в [панели подагента](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) ниже подсказки, `Esc` [отменяет его выбор](/docs/ru/keybindings#footer-actions) вместо прерывания. На подсказке разрешения `Esc` отклоняет действие, то же самое, что [**No** без комментария](/docs/ru/permissions#add-a-comment-when-you-answer-a-permission-prompt) |

41| `Esc` + `Esc` | Очистить черновик ввода или перемотать | Когда ввод подсказки содержит текст, двойной `Esc` очищает его и сохраняет черновик в историю, чтобы `Up` его вспомнил. Когда ввод пуст, двойной `Esc` открывает [меню перемотки](/docs/ru/checkpointing) для восстановления или суммирования кода и разговора с предыдущей точки |41| `Esc` + `Esc` | Очистить черновик ввода или перемотать | Когда ввод подсказки содержит текст, двойной `Esc` очищает его и сохраняет черновик в историю, чтобы `Up` его вспомнил. Когда ввод пуст, двойной `Esc` открывает [меню перемотки](/docs/ru/checkpointing) для восстановления или суммирования кода и разговора с предыдущей точки |

42| `Ctrl+Enter` или `Ctrl+X Ctrl+S` | Отправить очередные сообщения сейчас | Отправляет ваши [очередные сообщения](#queue-messages-while-claude-works) и ваш черновик с ними прямо сейчас. [Когда Claude Code отправляет то, что вы поставили в очередь](#when-claude-code-sends-what-you-queued) охватывает то, что происходит с ходом, над которым работает Claude. В [режиме shell](#shell-mode-with-prefix) клавиша ставит вашу команду в очередь. В терминалах, которые не сообщают о расширенных клавишах, `Ctrl+Enter` приходит как простой `Enter`; `Ctrl+X Ctrl+S` работает в любом терминале. Требует Claude Code v2.1.275 или более поздней версии |42| `Ctrl+Enter` или `Ctrl+X Ctrl+S` | Отправить очередные сообщения сейчас | Отправляет ваши [очередные сообщения](#queue-messages-while-claude-works) и ваш черновик с ними прямо сейчас. [Когда Claude Code отправляет то, что вы поставили в очередь](#when-claude-code-sends-what-you-queued) охватывает то, что происходит с ходом, над которым работает Claude. В [режиме shell](#shell-mode-with-prefix) клавиша ставит вашу команду в очередь. В терминалах, которые не сообщают о расширенных клавишах, `Ctrl+Enter` приходит как простой `Enter`; `Ctrl+X Ctrl+S` работает в любом терминале. Требует Claude Code v2.1.275 или более поздней версии |

43| `Shift+Tab`, или `Alt+M` на Windows, когда среда выполнения Node или Bun не включает режим ввода VT | Циклический переход по режимам разрешений | Циклический переход через `default` (помечено как Manual в индикаторе режима), `acceptEdits`, `plan` и, если доступно, `bypassPermissions` и затем `auto`. Из `auto` первое нажатие переключается на `default`. См. [режимы разрешений](/docs/ru/permission-modes). На подсказке разрешения файла то же самое ключевое слово закрывает открытое [поле комментария](/docs/ru/permissions#add-a-comment-when-you-answer-a-permission-prompt). Без открытого поля выбирает параметр, который разрешает действие на остаток сеанса, когда подсказка предлагает этот параметр |43| `Shift+Tab`, или `Alt+M` на Windows, когда среда выполнения Node или Bun не включает режим ввода VT | Циклический переход по режимам разрешений | Циклический переход через `default` (помечено как Manual в индикаторе режима), `acceptEdits`, `plan` и, если доступно, `bypassPermissions` и затем `auto`. Из `auto` первое нажатие переключается на `default`. См. [режимы разрешений](/docs/ru/permission-modes). На подсказке разрешения файла то же самое ключевое слово закрывает открытое [поле комментария](/docs/ru/permissions#add-a-comment-when-you-answer-a-permission-prompt). Без открытого поля выбирает параметр, который разрешает действие на остаток сеанса, когда подсказка предлагает этот параметр |

45| `Option+T` (macOS) или `Alt+T` (Windows/Linux) | Переключение расширенного мышления | Включение или отключение режима расширенного мышления. Не влияет на Opus 5.5 или модели Fable, которые всегда используют расширенное мышление. Работает на macOS без настройки Option как Meta |45| `Option+T` (macOS) или `Alt+T` (Windows/Linux) | Переключение расширенного мышления | Включение или отключение режима расширенного мышления. Не влияет на Opus 5.5, Sonnet 5.5 или модели Fable, которые всегда используют расширенное мышление. Работает на macOS без настройки Option как Meta |

47 47

48<h3 id="text-editing">48<h3 id="text-editing">

176| `A` | Вставить в конец строки | NORMAL |176| `A` | Вставить в конец строки | NORMAL |

177| `o` | Открыть строку ниже | NORMAL |177| `o` | Открыть строку ниже | NORMAL |

178| `O` | Открыть строку выше | NORMAL |178| `O` | Открыть строку выше | NORMAL |

179| `v` | Начать посимвольное визуальное выделение | NORMAL |179| `v` | Начать выделение по символам | NORMAL |

180| `V` | Начать построчное визуальное выделение | NORMAL |180| `V` | Начать выделение по строкам | NORMAL |

181 181

182<h3 id="remap-insert-mode-key-sequences">182<h3 id="remap-insert-mode-key-sequences">

183 Переназначение последовательностей клавиш в режиме INSERT183 Переназначение последовательностей клавиш в режиме INSERT

196 196

197Каждый ключ состоит ровно из двух печатаемых символов, введённых последовательно, и `"<Esc>"` — единственная поддерживаемая цель. Записи с другой длиной или целью игнорируются.197Каждый ключ состоит ровно из двух печатаемых символов, введённых последовательно, и `"<Esc>"` — единственная поддерживаемая цель. Записи с другой длиной или целью игнорируются.

198 198

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

200 200

201Claude Code читает этот параметр из вашего файла пользовательских параметров, флага `--settings` и [управляемых параметров](/docs/ru/managed-settings) только. Записи в `.claude/settings.json` или `.claude/settings.local.json` проекта игнорируются, поэтому проверенный репозиторий не может переназначить ваши нажатия клавиш.201Claude Code читает этот параметр из файла пользовательских параметров, флага `--settings` и [управляемых параметров](/docs/ru/managed-settings) только. Записи в `.claude/settings.json` или `.claude/settings.local.json` проекта игнорируются, поэтому проверенный репозиторий не может переназначить ваши нажатия клавиш.

202 202

203<h3 id="navigation-normal-mode">203<h3 id="navigation-normal-mode">

204 Навигация (режим NORMAL)204 Навигация (режим NORMAL)

225| `/` | Открыть поиск в обратной истории, то же самое, что `Ctrl+R`. Пустое приглашение поиска показывает подсказку: нажмите `Esc`, затем `i`, затем `/`, чтобы открыть меню команд вместо этого |225| `/` | Открыть поиск в обратной истории, то же самое, что `Ctrl+R`. Пустое приглашение поиска показывает подсказку: нажмите `Esc`, затем `i`, затем `/`, чтобы открыть меню команд вместо этого |

226 226

227<Note>227<Note>

228 В режиме vim NORMAL, если курсор находится в начале или конце ввода и не может двигаться дальше, `j`/`k` и `↑`/`↓` переходят к истории команд вместо этого. `←` на пустом приглашении открывает [представление агента](/docs/ru/agent-view) как из режима NORMAL, так и из INSERT; до v2.1.219 `←` на пустом приглашении ничего не делал в режиме NORMAL.228 В режиме vim NORMAL, если курсор находится в начале или конце ввода и не может двигаться дальше, `j`/`k` и `↑`/`↓` переходят по истории команд вместо этого. `←` на пустом приглашении открывает [представление агента](/docs/ru/agent-view) как из режима NORMAL, так и из INSERT; до v2.1.219 `←` на пустом приглашении ничего не делал в режиме NORMAL.

229</Note>229</Note>

230 230

231<h3 id="editing-normal-mode">231<h3 id="editing-normal-mode">

235| Команда | Действие |235| Команда | Действие |

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

237| `x` | Удалить символ |237| `x` | Удалить символ |

238| `r{char}` | Заменить символ под курсором на `{char}` |

238| `dd` | Удалить строку |239| `dd` | Удалить строку |

239| `D` | Удалить до конца строки |240| `D` | Удалить до конца строки |

241| `df{char}`/`dt{char}` | Удалить до и включая, или до следующего вхождения символа |242| `df{char}`/`dt{char}` | Удалить до и включая, или до следующего вхождения символа |

243| `dj`/`dk` | Удалить текущую строку и строку ниже или выше |

244| `dgg`/`dG` | Удалить с текущей строки до первой или последней строки |

245| `d0`/`c0`/`y0` | Удалить, изменить или скопировать от курсора к началу строки. Требует Claude Code v2.1.281 или более позднюю версию |

242| `cc` | Изменить строку |246| `cc` | Изменить строку |

243| `C` | Изменить до конца строки |247| `C` | Изменить до конца строки |

271| `i{`/`a{` | Внутри/вокруг фигурных скобок |275| `i{`/`a{` | Внутри/вокруг фигурных скобок |

272 276

273<h3 id="visual-mode">277<h3 id="visual-mode">

274 Визуальный режим278 Режим VISUAL

275</h3>279</h3>

276 280

277Нажмите `v` для посимвольного выделения или `V` для построчного выделения. Движения расширяют выделение, а операторы действуют на него напрямую.281Нажмите `v` для выделения по символам или `V` для выделения по строкам. Движения расширяют выделение, а операторы действуют на него напрямую.

278 282

279| Команда | Действие |283| Команда | Действие |

280| :- | :- |284| :- | :- |

288| `J` | Объединить выбранные строки |292| `J` | Объединить выбранные строки |

289| `o` | Поменять местами курсор и якорь |293| `o` | Поменять местами курсор и якорь |

291| `v`/`V` | Переключиться между посимвольным и построчным, или выйти |295| `v`/`V` | Переключиться между выделением по символам и по строкам, или выйти |

292 296

293Блочный визуальный режим с `Ctrl+V` не поддерживается.297Режим выделения по блокам с `Ctrl+V` не поддерживается.

294 298

295<h2 id="command-history">299<h2 id="command-history">

296 История команд300 История команд

342* Попросить Claude Code запустить команду в фоне346* Попросить Claude Code запустить команду в фоне

343* Нажать `Ctrl+B` для перемещения обычного вызова инструмента Bash в фон. Пользователи Tmux должны нажать `Ctrl+B` дважды из-за префиксного ключа tmux.347* Нажать `Ctrl+B` для перемещения обычного вызова инструмента Bash в фон. Пользователи Tmux должны нажать `Ctrl+B` дважды из-за префиксного ключа tmux.

344 348

349Когда команда достигает своего времени ожидания до завершения, Claude Code автоматически [перемещает её в фон](/docs/ru/tools-reference#background-commands) вместо остановки, если только команда не начинается с `sleep`. Чтобы изменить, как долго команды выполняются до этого, установите [переменные окружения для времени ожидания Bash](/docs/ru/tools-reference#timeout-and-output-limits).

350

345**Ключевые возможности:**351**Ключевые возможности:**

346 352

347* Вывод записывается в файл, и Claude может получить его с помощью инструмента Read353* Вывод записывается в файл, и Claude может получить его с помощью инструмента Read

395 Ставьте сообщения в очередь, пока Claude работает401 Ставьте сообщения в очередь, пока Claude работает

396</h2>402</h2>

397 403

398Введите сообщение и нажмите `Enter` пока Claude работает. Claude Code ставит сообщение в очередь вместо прерывания хода, и отображает записи в очереди над полем ввода до их отправки. Вы можете ставить в очередь `!` [команды оболочки](#shell-mode-with-prefix) и большинство [команд](/docs/ru/commands) таким же образом, за исключением команд, таких как `/status`, которые Claude Code выполняет сразу же при их отправке.404Введите сообщение и нажмите `Enter` пока Claude работает. Claude Code ставит сообщение в очередь вместо прерывания хода, и отображает записи в очереди в разговоре до их отправки. Вы можете ставить в очередь `!` [команды оболочки](#shell-mode-with-prefix) и большинство [команд](/docs/ru/commands) таким же образом, за исключением команд, таких как `/status`, которые Claude Code выполняет сразу же при их отправке.

399 405

400Отправленные и поставленные в очередь сообщения отображаются серым цветом до тех пор, пока Claude не начнет на них отвечать, поэтому вы можете видеть, какие сообщения Claude еще не начинал обрабатывать.406Отправленные и поставленные в очередь сообщения отображаются серым цветом до тех пор, пока Claude не начнет на них отвечать, поэтому вы можете видеть, какие сообщения Claude еще не начинал обрабатывать.

401 407

408Если вы поставите в очередь сообщение с выделением, прикрепленным из [подключенной IDE](/docs/ru/vs-code#the-built-in-ide-mcp-server) или [панели различий](#diff-panel), оно сохранит выделение, которое у вас было при нажатии `Enter`, независимо от того, что вы выберете впоследствии.

409

402<h3 id="when-claude-code-sends-what-you-queued">410<h3 id="when-claude-code-sends-what-you-queued">

403 Когда Claude Code отправляет то, что вы поставили в очередь411 Когда Claude Code отправляет то, что вы поставили в очередь

404</h3>412</h3>

jetbrains.md +5 −1

Details

249 249

250Сервер называется `ide` и скрыт от `/mcp`, потому что нечего конфигурировать. Однако если ваша организация использует [`PreToolUse` hook](/docs/ru/hooks#pretooluse) для создания списка разрешенных MCP инструментов, вам нужно знать, что он существует.250Сервер называется `ide` и скрыт от `/mcp`, потому что нечего конфигурировать. Однако если ваша организация использует [`PreToolUse` hook](/docs/ru/hooks#pretooluse) для создания списка разрешенных MCP инструментов, вам нужно знать, что он существует.

251 251

252**Контекст выделения и открытого файла.** При подключении CLI включает вашу текущую выделенную область редактора и путь активного файла в качестве контекста для каждого отправляемого вами запроса. Стенограмма показывает строку `⧉ Selected N lines from <file>` когда это происходит. Чтобы исключить конфиденциальный файл, такой как `.env`, добавьте [`Read` правило отказа](/docs/ru/permissions#read-and-edit) для его пути. Соответствующее правило отказа предотвращает как выделенный текст, так и уведомление об открытом файле для этого файла от достижения Claude.252**Контекст выделения и открытого файла.** При подключении CLI включает вашу текущую выделенную область редактора и путь активного файла в качестве контекста для каждого отправляемого вами запроса. Стенограмма показывает строку `⧉ Selected N lines from <file>` когда это происходит.

253

254Если вы [поставите сообщение в очередь, пока Claude работает](/docs/ru/interactive-mode#queue-messages-while-claude-works), он сохранит выделение, которое у вас было, когда вы нажали `Enter`, независимо от того, что вы выберете впоследствии.

255

256Чтобы исключить конфиденциальный файл, такой как `.env`, добавьте [`Read` правило отказа](/docs/ru/permissions#read-and-edit) для его пути. Соответствующее правило отказа предотвращает как выделенный текст, так и уведомление об открытом файле для этого файла от достижения Claude.

253 257

254**Транспорт и аутентификация.** Сервер прослушивает порт, назначенный ОС, и порт не настраивается. Транспорт — это незашифрованный `ws://`; на loopback любой процесс, который может захватить трафик, также может прочитать токен из файла блокировки, поэтому TLS не добавит защиту от локального злоумышленника. Каждый запуск IDE генерирует свежий случайный токен аутентификации, записывает его в файл блокировки в `~/.claude/ide/<port>.lock`, и CLI должен представить его как заголовок `X-Claude-Code-Ide-Authorization` для подключения. Если установлена переменная `CLAUDE_CONFIG_DIR`, файл блокировки записывается в `$CLAUDE_CONFIG_DIR/ide/` вместо этого.258**Транспорт и аутентификация.** Сервер прослушивает порт, назначенный ОС, и порт не настраивается. Транспорт — это незашифрованный `ws://`; на loopback любой процесс, который может захватить трафик, также может прочитать токен из файла блокировки, поэтому TLS не добавит защиту от локального злоумышленника. Каждый запуск IDE генерирует свежий случайный токен аутентификации, записывает его в файл блокировки в `~/.claude/ide/<port>.lock`, и CLI должен представить его как заголовок `X-Claude-Code-Ide-Authorization` для подключения. Если установлена переменная `CLAUDE_CONFIG_DIR`, файл блокировки записывается в `$CLAUDE_CONFIG_DIR/ide/` вместо этого.

255 259

keybindings.md +46 −25

Details

22| `$docs` | Необязательный URL документации |22| `$docs` | Необязательный URL документации |

23| `bindings` | Массив блоков привязок по контексту |23| `bindings` | Массив блоков привязок по контексту |

24 24

~~25Этот пример привязывает `Ctrl+E` к открытию внешнего редактора в контексте чата и отменяет привязку `Ctrl+U`:~~25Этот пример привязывает `Ctrl+E` к открытию внешнего редактора в контексте чата и отменяет привязку `Ctrl+S`:

26 26

27```json theme={null}27```json theme={null}

28{28{

29 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",29 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",

~~30 "$docs": "https://code.claude.com/docs/ru/keybindings",~~30 "$docs": "https://code.claude.com/docs/en/keybindings",

31 "bindings": [31 "bindings": [

32 {32 {

33 "context": "Chat",33 "context": "Chat",

34 "bindings": {34 "bindings": {

35 "ctrl+e": "chat:externalEditor",35 "ctrl+e": "chat:externalEditor",

~~36 "ctrl+u": null~~36 "ctrl+s": null

37 }37 }

38 }38 }

39 ]39 ]

41```41```

42 42

43<h2 id="contexts">43<h2 id="contexts">

~~44 Контексты~~44 Contexts

45</h2>45</h2>

46 46

~~47Каждый блок привязки указывает **контекст**, где применяются привязки:~~47Each binding block specifies a **context** where the bindings apply:

48 48

~~49| Контекст | Описание |~~49| Context | Description |

50| :- | :- |50| :- | :- |

51| `Global` | Применяется везде в приложении |51| `Global` | Применяется везде в приложении |

52| `Chat` | Основная область ввода чата |52| `Chat` | Основная область ввода чата |

56| `Tabs` | Компоненты навигации по вкладкам |56| `Tabs` | Компоненты навигации по вкладкам |

57| `Help` | Меню справки видимо |57| `Help` | Меню справки видимо |

58| `Transcript` | Средство просмотра стенограммы |58| `Transcript` | Средство просмотра стенограммы |

61| `ThemePicker` | Диалог выбора темы |61| `ThemePicker` | Диалог выбора темы |

62| `Attachments` | Навигация по вложениям изображений в диалогах выбора |62| `Attachments` | Навигация по вложениям изображений в диалогах выбора |

63| `Footer` | Навигация по индикатору нижнего колонтитула (задачи, команды, diff, артефакты) |63| `Footer` | Навигация по индикатору нижнего колонтитула (задачи, команды, diff, артефакты) |

64| `MessageSelector` | Выбор сообщения в диалоге перемотки и резюме |64| `MessageSelector` | Выбор сообщения в диалоге перемотки и резюме |

66| `DiffPanel` | [Панель diff](/docs/ru/interactive-mode#diff-panel) открыта |66| `DiffPanel` | [Панель diff](/docs/ru/interactive-mode#diff-panel) открыта |

67| `ModelPicker` | Уровень усилий выбора модели |67| `ModelPicker` | Уровень усилий выбора модели |

68| `EffortSlider` | Ползунок усилий, открытый с помощью `/effort` |68| `EffortSlider` | Ползунок усилий, открытый с помощью `/effort` |

69| `Select` | Универсальные компоненты выбора/списка |69| `Select` | Универсальные компоненты выбора/списка |

72| `Scroll` | Прокрутка разговора и выделение текста в полноэкранном режиме |72| `Scroll` | Прокрутка разговора и выделение текста в полноэкранном режиме |

73 73

74До версии 2.1.205 контекст `Doctor` и действие `doctor:fix` существовали для экрана диагностики `/doctor`.74До версии 2.1.205 контекст `Doctor` и действие `doctor:fix` существовали для экрана диагностики `/doctor`.

168 168

169Диалоги используют `confirm:yes` и `confirm:no` для принятия и отмены даже когда они не задают вопрос да или нет. Если вы привяжете простую букву, такую как `y` или `n`, в этом контексте, буква также действует на диалоги, которые никогда не показывают её как клавишу. Диалог, который показывает `y` и `n` как его клавиши, читает эти буквы сам и не требует привязки.169Диалоги используют `confirm:yes` и `confirm:no` для принятия и отмены даже когда они не задают вопрос да или нет. Если вы привяжете простую букву, такую как `y` или `n`, в этом контексте, буква также действует на диалоги, которые никогда не показывают её как клавишу. Диалог, который показывает `y` и `n` как его клавиши, читает эти буквы сам и не требует привязки.

170 170

171В большинстве диалогов нажатие `Ctrl+C` или `Ctrl+D` дважды закрывает диалог вместо выхода из Claude Code. Подсказка после первого нажатия говорит, закрывает ли второе нажатие диалог или выходит. Обе клавиши [зарезервированы](#reserved-shortcuts) и не могут быть переназначены.

172

171Этот пример привязывает `y` к `confirm:yes` и `n` к `confirm:no`:173Этот пример привязывает `y` к `confirm:yes` и `n` к `confirm:no`:

172 174

173```json theme={null}175```json theme={null}

270 272

273В диалоге с вкладками `tabs:next` и `tabs:previous` переключают вкладки, пока строка вкладок имеет фокус. В некоторых диалогах, таких как `/help` и `/sandbox`, клавиши переключения вкладок также работают изнутри содержимого вкладки.

274

275`Up` и `Down` перемещают фокус между строкой вкладок и содержимым вкладки, а список в содержимом реагирует на клавиши только пока он имеет фокус.

276

271<h3 id="attachments-actions">277<h3 id="attachments-actions">

272 Действия вложений278 Действия вложений

273</h3>279</h3>

298| `footer:dismiss` | Backspace, Delete | Удалить выбранную ссылку [артефакта](/docs/ru/artifacts) из нижнего колонтитула; сам опубликованный артефакт не затронут. На других строках нижнего колонтитула эти клавиши не имеют эффекта. Требует v2.1.217 или более позднюю версию |304| `footer:dismiss` | (не привязано) | Удалено в v2.1.281. `keybindings.json`, который по-прежнему называет действие, остаётся действительным, и привязка ничего не делает. До v2.1.281 Backspace и Delete удаляли выбранную ссылку артефакта из нижнего колонтитула |

299 305

300Пока элемент нижнего колонтитула выбран, например строка в панели агента ниже подсказки, `Enter` открывает его даже если вы переназначили `Enter` в контексте `Chat` на `chat:queueSubmit` или `chat:newline`.306Пока элемент нижнего колонтитула выбран, например строка в панели агента ниже подсказки, `Enter` открывает его даже если вы переназначили `Enter` в контексте `Chat` на `chat:queueSubmit` или `chat:newline`.

301 307

305 Действия выбора сообщения311 Действия выбора сообщения

306</h3>312</h3>

307 313

308Действия, доступные в контексте `MessageSelector`:314В списке сообщений [меню перемотки](/docs/ru/checkpointing) вы перемещаетесь по сообщениям и выбираете одно с помощью [действий выбора](#select-actions) и их клавиш по умолчанию. Ваши привязки `Select` для этих действий применяются там же. Контекст `MessageSelector` не имеет собственных действий или привязок по умолчанию. Используйте его для изменения клавиши только для этого списка, привязав действие Select, такое как `select:accept`, в блоке `MessageSelector`.

309 315

310| Действие | По умолчанию | Описание |316Этот пример привязывает `o` для выбора выделенного сообщения в меню перемотки, без изменения каких-либо других списков:

311| :- | :- | :- |317

312| `messageSelector:up` | Up, K, Ctrl+P | Переместиться вверх в списке |318```json theme={null}

313| `messageSelector:down` | Down, J, Ctrl+N | Переместиться вниз в списке |319{

314| `messageSelector:top` | Ctrl+Up, Shift+Up, Meta+Up, Shift+K | Перейти в начало |320 "bindings": [

315| `messageSelector:bottom` | Ctrl+Down, Shift+Down, Meta+Down, Shift+J | Перейти в конец |321 {

316| `messageSelector:select` | Enter | Выбрать сообщение |322 "context": "MessageSelector",

323 "bindings": {

324 "o": "select:accept"

325 }

326 }

327 ]

328}

329```

330

331До v2.1.283 этот список игнорировал привязки Select и имел собственные действия: `messageSelector:up`, `messageSelector:down`, `messageSelector:top`, `messageSelector:bottom` и `messageSelector:select`. Если ваш `keybindings.json` привязывает одно из этих имён, привязка продолжает работать в этом списке как действие Select, которое делает то же самое. `Home` и `End` прыгают на любой конец списка; до v2.1.283 клавиши, такие как `Shift+K` и `Shift+J`, делали это по умолчанию.

317 332

318<h3 id="diff-actions">333<h3 id="diff-actions">

319 Действия diff334 Действия diff

329| `diff:previousFile` | Up, K | Предыдущий файл в списке файлов; прокрутка вверх на одну строку в представлении деталей |344| `diff:previousFile` | Up, K | Предыдущий файл в списке файлов; прокрутка вверх на одну строку в представлении деталей |

331| `diff:viewDetails` | Enter | Просмотреть детали diff |

332| `diff:back` | (не привязано) | Вернуться в средстве просмотра diff. Escape выполняет действие возврата через `diff:dismiss`. Предыдущое значение по умолчанию Left в представлении деталей было удалено в v2.1.203 |346| `diff:back` | (не привязано) | Вернуться в средстве просмотра diff. Escape выполняет действие возврата через `diff:dismiss`. Предыдущое значение по умолчанию Left в представлении деталей было удалено в v2.1.203 |

333 347

348Список файлов также реагирует на [действия выбора](#select-actions), через их клавиши по умолчанию и ваши привязки `Select`. `select:previous` и `select:next` перемещаются к предыдущему и следующему файлу, а `Enter` открывает diff выбранного файла через `select:accept`. Чтобы изменить одну из этих клавиш только для списка файлов, привяжите действие Select в блоке `DiffDialog`.

349

350До v2.1.283 список файлов игнорировал привязки Select, и `Enter` открывал diff выбранного файла через отдельное действие `diff:viewDetails`. Если ваш `keybindings.json` привязывает `diff:viewDetails`, привязка продолжает работать в списке файлов как `select:accept`.

351

334Представление деталей diff также привязывает клавиши в стиле пейджера к стандартным [действиям прокрутки](#scroll-actions). Эти привязки являются частью контекста `DiffDialog` и применяются только в представлении деталей; значения по умолчанию контекста `Scroll`, указанные в разделе [Действия прокрутки](#scroll-actions), остаются неизменными.352Представление деталей diff также привязывает клавиши в стиле пейджера к стандартным [действиям прокрутки](#scroll-actions). Эти привязки являются частью контекста `DiffDialog` и применяются только в представлении деталей; значения по умолчанию контекста `Scroll`, указанные в разделе [Действия прокрутки](#scroll-actions), остаются неизменными.

335 353

373 Действия ползунка усилий391 Действия ползунка усилий

374</h3>392</h3>

375 393

376Действия, доступные в контексте `EffortSlider`, ползунок, который открывается при запуске `/effort` без аргументов. Клавиши Left, Right, Enter и Escape ползунка не могут быть переназначены.394Действия, доступные в контексте `EffortSlider`, ползунок, который открывается при запуске `/effort` без аргументов. Клавиши Enter и Escape ползунка не могут быть переназначены.

377 395

379| :- | :- | :- |397| :- | :- | :- |

398| `effortSlider:decreaseEffort` | Left | Переместить ползунок на следующий более низкий уровень усилий. Требует v2.1.284 или более позднюю версию |

399| `effortSlider:increaseEffort` | Right | Переместить ползунок на следующий более высокий уровень усилий. Требует v2.1.284 или более позднюю версию |

400| `effortSlider:toggleUltracode` | Tab | Включить [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode) или выключить для этого сеанса, когда ползунок [предлагает это](/docs/ru/model-config#when-ultracode-is-available). Требует v2.1.284 или более позднюю версию |

380| `effortSlider:thisSessionOnly` | s | Применить сфокусированный [уровень усилий](/docs/ru/model-config#adjust-effort-level) только к этому сеансу. Требует v2.1.257 или более позднюю версию |401| `effortSlider:thisSessionOnly` | s | Применить сфокусированный [уровень усилий](/docs/ru/model-config#adjust-effort-level) только к этому сеансу. Требует v2.1.257 или более позднюю версию |

381 402

382<h3 id="select-actions">403<h3 id="select-actions">

398 419

399Claude Code применяет ваши привязки `select:pageUp`, `select:pageDown`, `select:first` и `select:last` в меню `/skills`. В большинстве других списков, таких как выбор модели `/model`, ваши привязки `select:first` и `select:last` применяются. PageUp и PageDown разбивают на страницы параметры в этих списках независимо от ваших привязок.420В панелях списков, таких как `/skills` и `/mcp`, Claude Code применяет ваши привязки `select:pageUp`, `select:pageDown`, `select:first` и `select:last`. В большинстве других списков, таких как выбор модели `/model`, ваши привязки `select:first` и `select:last` применяются. PageUp и PageDown разбивают на страницы параметры в этих списках независимо от ваших привязок.

400 421

401До v2.1.280 эти другие списки игнорировали Home, End и ваши привязки `select:first` и `select:last`.422До v2.1.280 эти другие списки игнорировали Home, End и ваши привязки `select:first` и `select:last`.

402 423

668 Валидация689 Валидация

669</h2>690</h2>

670 691

671Claude Code проверяет ваши сочетания клавиш и показывает предупреждения для:692Claude Code проверяет ваши сочетания клавиш и записывает предупреждение в журнал отладки для:

672 693

673* Ошибок разбора (неверный JSON или структура)694* Ошибок разбора (неверный JSON или структура)

674* Неверных имён контекстов695* Неверных имён контекстов

677* Конфликтов зарезервированных сочетаний698* Конфликтов зарезервированных сочетаний

678* Дублирующихся привязок в одном контексте699* Дублирующихся привязок в одном контексте

679 700

680Claude Code сообщает о предупреждениях при загрузке файла и записывает каждое в журнал отладки. Запустите Claude Code с [`--debug`](/docs/ru/cli-reference#cli-flags) для просмотра деталей.701Запустите Claude Code с [`--debug`](/docs/ru/cli-reference#cli-flags) для просмотра деталей.

llm-gateway.md +1 −1

Details

49 Подписки и шлюзы49 Подписки и шлюзы

50</h2>50</h2>

51 51

52Пока активна [переменная учетных данных шлюза](/docs/ru/llm-gateway-connect#set-the-credential-variable) или `apiKeyHelper`, подписка claude.ai разработчика не используется: учетные данные заменяют вход подписки для этого сеанса, и ограничения использования подписки не применяются. Этот трафик выставляется счетом за токен тому, кто владеет учетными данными, которые перенаправляет шлюз, например вашей учетной записи Anthropic Console организации, или вашей учетной записи Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, когда шлюз маршрутизирует туда.52Пока активна [переменная учетных данных шлюза](/docs/ru/llm-gateway-connect#set-the-credential-variable) или `apiKeyHelper`, запросы несут эти учетные данные вместо входа подписки claude.ai разработчика, и ограничения использования подписки не применяются к ним. Claude Code сохраняет вход claude.ai на машине, но не отправляет его с этими запросами. Этот трафик выставляется счетом за токен тому, кто владеет учетными данными, которые перенаправляет шлюз, например вашей учетной записи Anthropic Console организации, или вашей учетной записи Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, когда шлюз маршрутизирует туда.

53 53

54[`ANTHROPIC_BASE_URL`](/docs/ru/llm-gateway-connect#set-the-base-url-and-credential) — это переменная, которая указывает Claude Code на шлюз. Установка только этой переменной без учетных данных шлюза не заменяет подписку. Запросы по-прежнему маршрутизируются через шлюз, но сохраненный вход claude.ai остается активным учетным данным, поэтому применяются его ограничения использования и выставление счетов. Шлюзы, которые передают этот трафик на Anthropic, должны перенаправлять возможность OAuth в `anthropic-beta`; см. [справочник заголовков запроса](/docs/ru/llm-gateway-protocol#request-headers).54[`ANTHROPIC_BASE_URL`](/docs/ru/llm-gateway-connect#set-the-base-url-and-credential) — это переменная, которая указывает Claude Code на шлюз. Установка только этой переменной без учетных данных шлюза не заменяет подписку. Запросы по-прежнему маршрутизируются через шлюз, но сохраненный вход claude.ai остается активным учетным данным, поэтому применяются его ограничения использования и выставление счетов. Шлюзы, которые передают этот трафик на Anthropic, должны перенаправлять возможность OAuth в `anthropic-beta`; см. [справочник заголовков запроса](/docs/ru/llm-gateway-protocol#request-headers).

55 55

llm-gateway-connect.md +2 −2

Details

140<Tabs>140<Tabs>

141 <Tab title="Bash или Zsh">141 <Tab title="Bash или Zsh">

142 ```bash theme={null}142 ```bash theme={null}

143 curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \143 curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \

144 -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \144 -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \

145 -H "anthropic-version: 2023-06-01" \145 -H "anthropic-version: 2023-06-01" \

146 -H "content-type: application/json" \146 -H "content-type: application/json" \

594| `/fast` сообщает `Fast mode has been disabled by your organization` в сеансе, аутентифицированном с помощью `ANTHROPIC_AUTH_TOKEN`, даже если организация имеет включенный быстрый режим | Проверка доступности требует входа claude.ai или ключа API Anthropic; только с токеном-носителем Claude Code рассматривает быстрый режим как отключенный без отправки проверки | Установите `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; см. [использование быстрого режима за прокси и LLM шлюзами](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |594| `/fast` сообщает `Fast mode has been disabled by your organization` в сеансе, аутентифицированном с помощью `ANTHROPIC_AUTH_TOKEN`, даже если организация имеет включенный быстрый режим | Проверка доступности требует входа claude.ai или ключа API Anthropic; только с токеном-носителем Claude Code рассматривает быстрый режим как отключенный без отправки проверки | Установите `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; см. [использование быстрого режима за прокси и LLM шлюзами](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |

595| Claude Code просит вас войти, даже если [тест curl](#verify-the-connection) успешен | CLI не имеет собственных учетных данных: достижимый базовый URL не является одним, и в интерактивном сеансе блок `env` в `.claude/settings.json` или `.claude/settings.local.json` проекта применяется только после мастера первого запуска и [подсказки доверия](/docs/ru/permissions#what-runs-before-you-trust-a-folder) | Установите `ANTHROPIC_AUTH_TOKEN` где-то, где Claude Code читает перед первоначальной настройкой: экспорт оболочки, блок `env` в `~/.claude/settings.json` или управляемые параметры |595| Claude Code просит вас войти, даже если [тест curl](#verify-the-connection) успешен | CLI не имеет собственных учетных данных: достижимый базовый URL не является одним, и в интерактивном сеансе блок `env` в `.claude/settings.json` или `.claude/settings.local.json` проекта применяется только после мастера первого запуска и [подсказки доверия](/docs/ru/permissions#what-runs-before-you-trust-a-folder) | Установите `ANTHROPIC_AUTH_TOKEN` где-то, где Claude Code читает перед первоначальной настройкой: экспорт оболочки, блок `env` в `~/.claude/settings.json` или управляемые параметры |

596| `ANTHROPIC_API_KEY` установлен, но игнорируется, без подсказки | Ключ требует одобрения один раз в интерактивных сеансах, и ранее отклоненный ключ игнорируется без повторного запроса | Включите его под `/config` с опцией `Use custom API key` |596| `ANTHROPIC_API_KEY` установлен, но игнорируется, без подсказки | Ключ требует одобрения один раз в интерактивных сеансах, и ранее отклоненный ключ игнорируется без повторного запроса | Включите его под `/config` с опцией `Use custom API key` |

597| `This machine's managed settings require a first-party login` | Управляемые параметры включают `forceLoginMethod` или `forceLoginOrgUUID`, которые не могут сосуществовать с `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper` | Администратор должен удалить `forceLoginMethod` и `forceLoginOrgUUID` из управляемых параметров, чтобы использовать учетные данные шлюза, или удалить учетные данные шлюза, чтобы использовать вход первой стороны. Эти два не могут быть объединены |597| `This machine's managed settings require a first-party login`, или [`Administrator policy requires a Cloud gateway sign-in`](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in) когда управляемые параметры устанавливают `forceLoginMethod` на `"gateway"` или также устанавливают `forceLoginGatewayUrl` | Управляемые параметры включают `forceLoginMethod` или `forceLoginOrgUUID`, которые не могут сосуществовать с `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper` | Администратор должен удалить `forceLoginMethod`, `forceLoginOrgUUID` и `forceLoginGatewayUrl` из управляемых параметров, чтобы использовать учетные данные шлюза, или удалить учетные данные шлюза и использовать вход, который требуют управляемые параметры. Эти два не могут быть объединены |

598| `403` с телом HTML, такое как `403 Forbidden`, когда собственные журналы шлюза не показывают полученный запрос | Веб-приложение брандмауэра или обратный прокси перед шлюзом заблокировал тело запроса перед тем, как оно достигло шлюза. Подсказки Claude Code включают теги в стиле XML и исходный код, которые соответствуют правилам тела межсайтового скриптинга, поэтому короткий тест curl проходит, а реальный сеанс нет | Исключите путь `/v1/messages` шлюза из проверки тела запроса. На AWS WAF это управляемое правило `CrossSiteScripting_Body`; на nginx с ModSecurity это эквивалентные правила тела OWASP CRS |598| `403` с телом HTML, такое как `403 Forbidden`, когда собственные журналы шлюза не показывают полученный запрос | Веб-приложение брандмауэра или обратный прокси перед шлюзом заблокировал тело запроса перед тем, как оно достигло шлюза. Подсказки Claude Code включают теги в стиле XML и исходный код, которые соответствуют правилам тела межсайтового скриптинга, поэтому короткий тест curl проходит, а реальный сеанс нет | Исключите путь `/v1/messages` шлюза из проверки тела запроса. На AWS WAF это управляемое правило `CrossSiteScripting_Body`; на nginx с ModSecurity это эквивалентные правила тела OWASP CRS |

599| Ошибки сертификата или TLS, такие как `SSL certificate verification failed` или `Self-signed certificate detected`, когда [тест curl](#verify-the-connection) успешен | Среда выполнения Claude Code не доверяет тому же центру сертификации, что и `curl`. Обычно за корпоративными прокси-серверами проверки TLS | Установите `NODE_EXTRA_CA_CERTS` на путь пакета CA; см. [хранилище сертификатов CA](/docs/ru/network-config#ca-certificate-store) |599| Ошибки сертификата или TLS, такие как `SSL certificate verification failed` или `Self-signed certificate detected`, когда [тест curl](#verify-the-connection) успешен | Среда выполнения Claude Code не доверяет тому же центру сертификации, что и `curl`. Обычно за корпоративными прокси-серверами проверки TLS | Установите `NODE_EXTRA_CA_CERTS` на путь пакета CA; см. [хранилище сертификатов CA](/docs/ru/network-config#ca-certificate-store) |

600 600

llm-gateway-protocol.md +10 −3

Details

73 73

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

75 75

76Доставляйте полную последовательность событий каждого ответа без пропусков, дублирования или переупорядочивания событий. Когда событие ссылается на блок контента, чей `content_block_start` никогда не прибыл, или на блок, чей `content_block_stop` уже прибыл, Claude Code прекращает чтение потока на этом событии вместо его применения, поэтому дублированный `content_block_stop` не может запустить один и тот же вызов инструмента дважды. [The response above may be incomplete](/docs/ru/errors#the-response-above-may-be-incomplete) описывает то, что видит пользователь, в вариантах `Part of the response never arrived` и `The response stream was malformed`.

78Передавайте каждый ответ через его финальные события `message_delta` и `message_stop` перед завершением тела. Тело, которое заканчивается после `message_delta`, несущего `stop_reason`, без открытого блока контента и без события блока контента после этого кадра, считается полным даже когда `message_stop` отсутствует. Тело, которое ваш шлюз завершает чисто раньше, как только блок контента начался, рассматривается так же, как разорванное соединение: [Automatic retries](/docs/ru/errors#automatic-retries) говорит, когда Claude Code переиздаёт запрос, и [The response above may be incomplete](/docs/ru/errors#the-response-above-may-be-incomplete) охватывает то, что он сохраняет после появления видимого контента. Claude Code сохраняет `stop_reason`, который доставляет `message_delta`, поэтому более поздний `message_delta`, содержащий только использование, чей `delta` имеет `stop_reason: null` или не имеет ключа `stop_reason`, не очищает его.

76Когда клиент использует формат Amazon Bedrock, передавайте тело ответа `InvokeModelWithResponseStream` и его заголовок `Content-Type: application/vnd.amazon.eventstream` без изменений, и не преобразуйте поток в server-sent events. См. [Streaming errors behind a gateway or proxy](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).80Когда клиент использует формат Amazon Bedrock, передавайте тело ответа `InvokeModelWithResponseStream` и его заголовок `Content-Type: application/vnd.amazon.eventstream` без изменений, и не преобразуйте поток в server-sent events. См. [Streaming errors behind a gateway or proxy](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).

77 81

78Пересылайте также keep-alive пинги. На соединениях через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`, Claude Code считает каждый байт, который ваш шлюз передаёт, включая SSE события `ping` и строки комментариев, и прерывает поток, который молчит в течение 300 секунд по умолчанию. Пинги вышестоящего сервера — единственный трафик во время длительных пауз размышления, поэтому если ваш шлюз удаляет или буферизирует их, Claude Code прерывает поток во время этих пауз; [Automatic retries](/docs/ru/errors#automatic-retries) охватывает то, что прерванный поток сообщает в зависимости от того, насколько далеко продвинулся ответ. Вышестоящий сервер, который вообще не отправляет пинги, такой как двоичный event-stream Amazon Bedrock, оставляет эти паузы без чего-либо для передачи. При переводе с такого вышестоящего сервера выдавайте свои собственные события `ping` во время молчаливых пауз. Шлюзы, достигнутые через `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_FOUNDRY_BASE_URL`, не обёрнуты этим байт-уровневым сторожем, даже когда они передают формат Anthropic Messages; там [5-минутный timeout неактивности](/docs/ru/env-vars) прерывает молчаливый поток вместо этого, и на соединениях `ANTHROPIC_BEDROCK_BASE_URL` вы можете добавить байт-уровневый сторож с помощью [`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`](/docs/ru/env-vars).82Пересылайте также keep-alive пинги. На соединениях через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`, Claude Code считает каждый байт, который ваш шлюз передаёт, включая SSE события `ping` и строки комментариев, и прерывает поток, который молчит в течение 300 секунд по умолчанию. Пинги вышестоящего сервера — единственный трафик во время длительных пауз размышления, поэтому если ваш шлюз удаляет или буферизирует их, Claude Code прерывает поток во время этих пауз; [Automatic retries](/docs/ru/errors#automatic-retries) охватывает то, что прерванный поток сообщает в зависимости от того, насколько далеко продвинулся ответ. Вышестоящий сервер, который вообще не отправляет пинги, такой как двоичный event-stream Amazon Bedrock, оставляет эти паузы без чего-либо для передачи. При переводе с такого вышестоящего сервера выдавайте свои собственные события `ping` во время молчаливых пауз. Шлюзы, достигнутые через `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_FOUNDRY_BASE_URL`, не обёрнуты этим байт-уровневым сторожем, даже когда они передают формат Anthropic Messages; там [5-минутный timeout неактивности](/docs/ru/env-vars) прерывает молчаливый поток вместо этого, и на соединениях `ANTHROPIC_BEDROCK_BASE_URL` вы можете добавить байт-уровневый сторож с помощью [`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`](/docs/ru/env-vars).

158 162

159Установка `CLAUDE_CODE_GATEWAY_HINT_HEADERS` на `0` останавливает заголовки на каждом подключении.163Установка `CLAUDE_CODE_GATEWAY_HINT_HEADERS` на `0` останавливает заголовки на каждом подключении.

160 164

161Заголовки содержат только то, что указано в строках ниже: фиксированные словари, имена инструментов и длительности, никогда текст подсказки или содержимое файлов. Каждое значение — это печатаемый ASCII.165Заголовки содержат только то, что указано в строках ниже: фиксированные словари, имена инструментов, длительности и случайный идентификатор подсказки, никогда текст подсказки или содержимое файлов. Каждое значение — это печатаемый ASCII.

162 166

163| Заголовок | Описание |167| Заголовок | Описание |

164| :- | :- |168| :- | :- |

167| `x-claude-code-compaction` | Присутствует в запросе, который суммирует разговор во время [компактирования](/docs/ru/prompt-caching#compacting-the-conversation). Значение говорит, что его вызвало: `auto` когда окно контекста приближалось к емкости, `manual` для `/compact`, или `reactive` когда API отклонил запрос как слишком длинный. Отсутствует на каждом другом запросе |171| `x-claude-code-compaction` | Присутствует в запросе, который суммирует разговор во время [компактирования](/docs/ru/prompt-caching#compacting-the-conversation). Значение говорит, что его вызвало: `auto` когда окно контекста приближалось к емкости, `manual` для `/compact`, или `reactive` когда API отклонил запрос как слишком длинный. Отсутствует на каждом другом запросе |

168| `x-claude-code-context-compacted` | Присутствует один раз, на первом запросе основного разговора после компактирования, с теми же значениями, что и `x-claude-code-compaction`. Префикс разговора перед этим запросом больше не используется, поэтому кэш, основанный на нем, может быть удален |172| `x-claude-code-context-compacted` | Присутствует один раз, на первом запросе основного разговора после компактирования, с теми же значениями, что и `x-claude-code-compaction`. Префикс разговора перед этим запросом больше не используется, поэтому кэш, основанный на нем, может быть удален |

169| `x-claude-code-prev-tool-durations` | Измеренное время выполнения вызовов инструментов, результаты которых содержит этот запрос, как `<name>=<ms>;<name>=<ms>`, например `Bash=742;Read=9`. Отправляется на следующем запросе того же разговора после пакета вызовов инструментов, из основного сеанса или подагента |173| `x-claude-code-prev-tool-durations` | Измеренное время выполнения вызовов инструментов, результаты которых содержит этот запрос, как `<name>=<ms>;<name>=<ms>`, например `Bash=742;Read=9`. Отправляется на следующем запросе того же разговора после пакета вызовов инструментов, из основного сеанса или подагента |

174| `x-claude-code-prompt-id` | Случайный UUID, который идентифицирует пользовательскую подсказку, которой служит запрос. Запросы, служащие одной подсказке, делят значение, включая ходы подагентов, которые подсказка запустила. Запросы, не отнесенные к подсказке, его опускают. Используйте его для группировки запросов сеанса по подсказке. Требуется Claude Code v2.1.283 или позже |

170 175

171Перед анализом `x-claude-code-prev-tool-durations` проверьте, как Claude Code строит значение и что оно опускает:176Перед анализом `x-claude-code-prev-tool-durations` проверьте, как Claude Code строит значение и что оно опускает:

172 177

265 Отключение предварительных возможностей270 Отключение предварительных возможностей

266</h3>271</h3>

267 272

268`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` останавливает Claude Code от отправки предварительных возможностей и их полей тела на каждого поставщика, включая управление контекстом и бета-поля инструментов. Переменная не влияет на адаптивное рассуждение, которое выбирается по модели, а не по бета. Она никогда не подавляет возможность OAuth, которую требует аутентификация подписки.273`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` останавливает Claude Code от отправки предварительных возможностей и их полей тела, включая управление контекстом и бета-поля инструментов. Переменная не влияет на адаптивное рассуждение, которое выбирается по модели, а не по бета. Она никогда не подавляет возможность OAuth, которую требует аутентификация подписки.

274

275Когда хост-платформа, которая встраивает Claude Code, устанавливает [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` не останавливает сеансы автоматического режима на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или [Claude apps gateway](/docs/ru/claude-apps-gateway) от запроса к серверу [проверки классификатора](/docs/ru/permission-modes#server-side-classifier-review). Эта проверка добавляет значение `anthropic-beta` и поле запроса `safeguards`. Установите `CLAUDE_CODE_AUTO_MODE_SERVER=0`, чтобы остановить это там.

269 276

270На Claude Code v2.1.227 или более поздней версии ваша организация может сохранить [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) в соответствии с этой переменной через [управляемые параметры](/docs/ru/managed-settings). То, что Claude Code отправляет с этим переопределением, зависит от того, как вы подключаетесь:277На Claude Code v2.1.227 или более поздней версии ваша организация может сохранить [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) в соответствии с этой переменной через [управляемые параметры](/docs/ru/managed-settings). То, что Claude Code отправляет с этим переопределением, зависит от того, как вы подключаетесь:

271 278

340Обнаруженный ID не получает свою собственную строку, когда он совпадает со строкой, уже находящейся в средстве выбора:347Обнаруженный ID не получает свою собственную строку, когда он совпадает со строкой, уже находящейся в средстве выбора:

341 348

342* Одинаковый ID: обнаруженный ID точно совпадает с ID существующей строки, или оба ID являются написаниями одной и той же версии [Fable](/docs/ru/model-config#work-with-fable).349* Одинаковый ID: обнаруженный ID точно совпадает с ID существующей строки, или оба ID являются написаниями одной и той же версии [Fable](/docs/ru/model-config#work-with-fable).

343* Та же модель, что и встроенный псевдоним: когда обнаруженный явный ID называет модель, на которую встроенный псевдоним в настоящее время разрешается, средство выбора показывает только строку псевдонима. Например, пока `sonnet` разрешается в `claude-sonnet-5`, обнаруженный `claude-sonnet-5` объединяется в строку `sonnet`, и обнаруженный `claude-sonnet-4-6` все еще получает свою собственную строку. До версии v2.1.197 Claude Code не объединял эти ID во встроенные строки, поэтому `claude-sonnet-5` также получал свою собственную строку "From gateway".350* Та же модель, что и встроенный псевдоним: когда обнаруженный явный ID называет модель, на которую встроенный псевдоним в настоящее время разрешается, средство выбора показывает только строку псевдонима. Например, пока `sonnet` разрешается в `claude-sonnet-5-5`, обнаруженный `claude-sonnet-5-5` объединяется в строку `sonnet`, и обнаруженный `claude-sonnet-5` все еще получает свою собственную строку. До версии v2.1.197 Claude Code не объединял эти ID во встроенные строки, поэтому ID, на который разрешался псевдоним, также получал свою собственную строку "From gateway".

344 351

345Результаты кешируются в `~/.claude/cache/gateway-models.json` или `%USERPROFILE%\.claude\cache\gateway-models.json` на Windows и обновляются при каждом запуске. Если вы установили [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars), кеш находится в этом каталоге вместо этого. Если запрос не выполняется или gateway не реализует `/v1/models`, средство выбора возвращается к кешированному списку из предыдущего запуска или к встроенному списку моделей. Если ваш gateway обслуживает модели Claude под псевдонимами, которые не совпадают с фильтром обнаружения, разработчики могут добавить эти псевдонимы вручную с помощью переменных [конфигурации модели](/docs/ru/model-config).352Результаты кешируются в `~/.claude/cache/gateway-models.json` или `%USERPROFILE%\.claude\cache\gateway-models.json` на Windows и обновляются при каждом запуске. Если вы установили [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars), кеш находится в этом каталоге вместо этого. Если запрос не выполняется или gateway не реализует `/v1/models`, средство выбора возвращается к кешированному списку из предыдущего запуска или к встроенному списку моделей. Если ваш gateway обслуживает модели Claude под псевдонимами, которые не совпадают с фильтром обнаружения, разработчики могут добавить эти псевдонимы вручную с помощью переменных [конфигурации модели](/docs/ru/model-config).

346 353

llm-gateway-rollout.md +1 −1

Details

208 208

209Добавьте условные переменные из таблицы в тот же блок `env`. Управляемый `ANTHROPIC_BASE_URL` применяется и не может быть переопределен экспортом оболочки разработчика, так как Claude Code применяет его над переменными процесса и параметрами с более низким приоритетом.209Добавьте условные переменные из таблицы в тот же блок `env`. Управляемый `ANTHROPIC_BASE_URL` применяется и не может быть переопределен экспортом оболочки разработчика, так как Claude Code применяет его над переменными процесса и параметрами с более низким приоритетом.

210 210

211Не включайте `forceLoginMethod` или `forceLoginOrgUUID` в управляемые параметры вместе с учетными данными шлюза. Любой ключ, с любым значением, блокирует `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` и `apiKeyHelper` при запуске, и разработчики не могут продолжить. Они видят `This machine's managed settings require a first-party login` или [`Administrator policy requires a Cloud gateway sign-in`](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in) под значением `"gateway"`.211Не включайте `forceLoginMethod`, `forceLoginOrgUUID` или `forceLoginGatewayUrl` в управляемые параметры вместе с учетными данными шлюза. `forceLoginMethod` или `forceLoginOrgUUID`, с любым значением, блокирует `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` и `apiKeyHelper` при запуске, и разработчики не могут продолжить. Они видят `This machine's managed settings require a first-party login` или [`Administrator policy requires a Cloud gateway sign-in`](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in) когда файл устанавливает `forceLoginMethod` на `"gateway"` или устанавливает `forceLoginGatewayUrl`.

212 212

213[Доставка управляемых параметров на сервере](/docs/ru/server-managed-settings#platform-availability) требует прямого подключения к `api.anthropic.com`, поэтому она не достигает сеансов, маршрутизируемых через шлюз. Развертывания шлюза используют этот путь управляемых параметров на основе файлов, который применяет те же ключи.213[Доставка управляемых параметров на сервере](/docs/ru/server-managed-settings#platform-availability) требует прямого подключения к `api.anthropic.com`, поэтому она не достигает сеансов, маршрутизируемых через шлюз. Развертывания шлюза используют этот путь управляемых параметров на основе файлов, который применяет те же ключи.

214 214

managed-mcp.md +1 −1

Details

526 Мониторинг использования MCP526 Мониторинг использования MCP

527</h2>527</h2>

528 528

529Когда [OpenTelemetry export](/docs/ru/monitoring-usage) настроен, Claude Code может записывать, какие MCP серверы и инструменты вызывают пользователи. Установите `OTEL_LOG_TOOL_DETAILS=1`, чтобы включить имена MCP серверов и инструментов в события инструментов, затем агрегируйте их в вашем сборщике, чтобы увидеть, какие серверы фактически подключают ваши пользователи. См. [Monitoring](/docs/ru/monitoring-usage) для настройки экспортера и полной схемы событий.529Когда вы настраиваете [OpenTelemetry export](/docs/ru/monitoring-usage), Claude Code может записывать, какие MCP серверы и инструменты вызывают пользователи. Установите `OTEL_LOG_TOOL_DETAILS=1`, чтобы включить имена MCP серверов и инструментов в события инструментов и на [счётчики стоимости и токенов](/docs/ru/monitoring-usage#cost-counter), затем агрегируйте их в вашем сборщике, чтобы увидеть, какие серверы фактически подключают ваши пользователи. См. [Monitoring](/docs/ru/monitoring-usage) для настройки экспортера и полной схемы событий.

530 530

531<h2 id="configuration-summary">531<h2 id="configuration-summary">

532 Сводка конфигурации532 Сводка конфигурации

managed-settings.md +122 −86

Details

75| [Server-managed settings](/docs/ru/server-managed-settings) | В консоли администратора claude.ai или на самостоятельно размещаемом [Claude apps gateway](/docs/ru/claude-apps-gateway) | Получается при запуске и опрашивается каждый час; см. [изменения, требующие одобрения](#where-and-when-a-policy-applies) | Вы хотите одно место для изменения политики для организации claude.ai без касания каждой машины |75| [Server-managed settings](/docs/ru/server-managed-settings) | В консоли администратора claude.ai или на самостоятельно размещаемом [Claude apps gateway](/docs/ru/claude-apps-gateway) | Получается при запуске и опрашивается каждый час; см. [изменения, требующие одобрения](#where-and-when-a-policy-applies) | Вы хотите одно место для изменения политики для организации claude.ai без касания каждой машины |

76| MDM или политика уровня ОС | Как профиль конфигурации macOS или значение реестра Windows `HKLM`, через Jamf, Intune, Group Policy или аналогичный инструмент; см. [где каждый механизм хранит политику](#where-each-mechanism-stores-the-policy) | Читается при запуске и проверяется на наличие изменений каждые 30 минут | Вы уже управляете устройствами с помощью MDM или Group Policy |76| MDM или политика уровня ОС | Как профиль конфигурации macOS или значение реестра Windows `HKLM`, через Jamf, Intune, Group Policy или аналогичный инструмент; см. [где каждый механизм хранит политику](#where-each-mechanism-stores-the-policy) | Читается при запуске и проверяется на наличие изменений каждые 30 минут | Вы уже управляете устройствами с помощью MDM или Group Policy |

77| На основе файла | Как `managed-settings.json` в системном каталоге на каждой машине; см. [где каждый механизм хранит политику](#where-each-mechanism-stores-the-policy) | Читается при запуске и перезагружается при изменении файла | Машины без MDM, хосты Linux или образы, которые вы создаёте сами |77| На основе файла | Как `managed-settings.json` в системном каталоге на каждой машине; см. [где каждый механизм хранит политику](#where-each-mechanism-stores-the-policy) | Читается при запуске и перезагружается при изменении файла | Машины без MDM, хосты Linux или образы, которые вы создаёте сами |

78| HKCU реестр, Windows и WSL | Как значение реестра Windows `HKCU`; см. [где каждый механизм хранит политику](#where-each-mechanism-stores-the-policy) | Читается при запуске и проверяется на наличие изменений каждые 30 минут; Claude Code использует его только когда ни один другой управляемый источник не доставляет ключ политики и [параметры, предоставленные хостом](#let-an-embedding-host-add-policy) не предоставляют ограничивающий ключ | Вы не можете записать ключ уровня машины `HKLM` |78| HKCU реестр, Windows и WSL | Как значение реестра Windows `HKCU`; см. [где каждый механизм хранит политику](#where-each-mechanism-stores-the-policy) | Читается при запуске и проверяется на наличие изменений каждые 30 минут; Claude Code использует его только когда [ни один документ администратора не присутствует выше](#present-admin-documents) и [параметры, предоставленные хостом](#let-an-embedding-host-add-policy) не предоставляют ограничивающий ключ | Вы не можете записать ключ уровня машины `HKLM` |

79 79

80Начальные шаблоны для Jamf, Iru, Intune и Group Policy находятся в [репозитории примеров MDM](https://github.com/anthropics/claude-code/tree/main/examples/mdm).80Начальные шаблоны для Jamf, Iru, Intune и Group Policy находятся в [репозитории примеров MDM](https://github.com/anthropics/claude-code/tree/main/examples/mdm).

81 81

89 89

90* **Поверхности**: на машине разработчика, в терминале, расширениях VS Code и JetBrains, вкладке Code настольного приложения и сеансах [Agent SDK](/docs/ru/agent-sdk/typescript) читают все эти источники. Сеансы Agent SDK загружают управляемые параметры даже когда `settingSources` исключает пользовательские, проектные и локальные файлы.90* **Поверхности**: на машине разработчика, в терминале, расширениях VS Code и JetBrains, вкладке Code настольного приложения и сеансах [Agent SDK](/docs/ru/agent-sdk/typescript) читают все эти источники. Сеансы Agent SDK загружают управляемые параметры даже когда `settingSources` исключает пользовательские, проектные и локальные файлы.

91* **Облачные сеансы**: сеанс в среде, размещённой Anthropic, не читает профиль MDM или файл устройства, поэтому политика для него должна поступать из server-managed settings. Сеанс в [самостоятельно размещаемой среде](/docs/ru/self-hosted-environments) также читает файл управляемых параметров в образе своего runner, по умолчанию только когда server-managed settings не доставляют ключ политики, кроме [ключей, которые Claude Code читает из каждого источника администратора](#keys-read-from-every-admin-source). [Как Claude Code объединяет управляемые источники](#how-claude-code-combines-managed-sources) охватывает согласие, которое применяется к обоим.91* **Облачные сеансы**: сеанс в среде, размещённой Anthropic, не читает профиль MDM или файл устройства, поэтому политика для него должна поступать из server-managed settings. Сеанс в [самостоятельно размещаемой среде](/docs/ru/self-hosted-environments) также читает файл управляемых параметров в образе своего runner, по умолчанию только когда server-managed settings не доставляют ключ политики, кроме [ключей, которые Claude Code читает из каждого источника администратора](#keys-read-from-every-admin-source). [Как Claude Code объединяет управляемые источники](#how-claude-code-combines-managed-sources) охватывает согласие, которое применяется к обоим.

92* **Сеансы Claude Tag**: сеансы [Claude Tag](https://claude.com/docs/claude-tag/overview) работают в облачных средах, но не получают server-managed settings. В [самостоятельно размещаемой среде](/docs/ru/self-hosted-environments) они всё ещё читают файл управляемых параметров в образе runner. Настройте сам Claude Tag в [параметрах администратора Claude Tag](https://claude.com/docs/claude-tag/admins/customize).

92* **Сеансы Cowork**: [Cowork](https://claude.com/docs/cowork/overview) в приложении Claude Desktop запускает свои сеансы на Claude Code. В сеансе Cowork Claude Code никогда не получает server-managed settings из консоли администратора claude.ai, даже когда пользователь входит с учётной записью Team или Enterprise, поэтому то, какая политика применяется, зависит от того, где запускается сеанс:93* **Сеансы Cowork**: [Cowork](https://claude.com/docs/cowork/overview) в приложении Claude Desktop запускает свои сеансы на Claude Code. В сеансе Cowork Claude Code никогда не получает server-managed settings из консоли администратора claude.ai, даже когда пользователь входит с учётной записью Team или Enterprise, поэтому то, какая политика применяется, зависит от того, где запускается сеанс:

93 94

94 * **На машине пользователя**: по умолчанию Claude Code в сеансе Cowork читает политику MDM или уровня ОС и файл управляемых параметров на этом устройстве, поэтому разверните политику там.95 * **На машине пользователя**: по умолчанию Claude Code в сеансе Cowork читает политику MDM или уровня ОС и файл управляемых параметров на этом устройстве, поэтому разверните политику там.

143 144

144Когда ваша организация доставляет более одного управляемого источника на одну машину, ключ [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) определяет, что Claude Code делает с остальными:145Когда ваша организация доставляет более одного управляемого источника на одну машину, ключ [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) определяет, что Claude Code делает с остальными:

145 146

146* **`"first-wins"`, по умолчанию**: Claude Code использует источник с наивысшим рейтингом, который доставляет хотя бы один ключ политики, и игнорирует остальные, а не объединяет их, за исключением ключей в [Ключи, читаемые из каждого источника администратора](#keys-read-from-every-admin-source). Claude Code не показывает предупреждение для источников, которые он пропускает; `/status` [называет источник, который он использовал, и те, которые он пропустил](#read-the-source-in-/status).147* **`"first-wins"`, по умолчанию**: Claude Code использует источник с наивысшим рейтингом, который доставляет по крайней мере один ключ политики, и игнорирует остальные, а не объединяет их, за исключением ключей в [Ключи, читаемые из каждого источника администратора](#keys-read-from-every-admin-source). Claude Code не показывает предупреждение для источников, которые он пропускает; `/status` [называет источник, который он использовал, и те, которые он пропустил](#read-the-source-in-/status).

147* **`"merge"`**: Claude Code применяет каждый источник администратора, который доставляет ключ политики, и объединяет их по типу ключа: для большинства ключей применяется значение источника с более высоким рейтингом, списки объединяются, а блокировки принимают наиболее строгое значение. [Составьте каждый управляемый источник](#compose-every-managed-source) говорит, где установить ключ и как объединяется каждый тип ключа. Требует Claude Code v2.1.242 или позже.148* **`"merge"`**: Claude Code применяет каждый источник администратора, который доставляет ключ политики, и объединяет их по типу ключа: для большинства ключей применяется значение источника с более высоким рейтингом, списки объединяются, а блокировки принимают наиболее строгое значение. [Составьте каждый управляемый источник](#compose-every-managed-source) указывает, где установить ключ и как объединяется каждый тип ключа. Требует Claude Code v2.1.242 или позже.

148 149

149Оба параметра ранжируют источники одинаково. Эти термины повторяются в этом разделе:150Оба параметра ранжируют источники одинаково. Эти термины повторяются в этом разделе:

150 151

151* **Ключ политики**: любой ключ параметров, кроме двух управляющих ключей, [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) и [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior). Управляемый файл параметров или политика MDM, которые содержат только эти, не считаются, и Claude Code переходит к следующему источнику.152* **Ключ политики**: любой ключ параметров, кроме двух управляющих ключей, [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) и [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior). Управляемый файл параметров или политика MDM, которые содержат только эти ключи, не учитываются, и Claude Code переходит к следующему источнику.

152* **Источник администратора**: один из первых трёх источников ниже. Реестр HKCU доступен для записи пользователем и не является одним из них.153* **Источник администратора**: один из первых трёх источников ниже. Реестр HKCU доступен для записи пользователем и не является источником администратора.

153 154

154Claude Code проверяет источники в этом порядке, сначала с наивысшим приоритетом:155Claude Code проверяет источники в этом порядке, от наивысшего приоритета к наименьшему:

155 156

1561. Удалённые параметры, доставленные с claude.ai как [параметры, управляемые сервером](/docs/ru/server-managed-settings) или через [шлюз приложений Claude](/docs/ru/claude-apps-gateway). Claude Code получает этот источник только когда сеанс аутентифицируется в API Anthropic напрямую с [подходящим входом или ключом](/docs/ru/server-managed-settings#platform-availability) или входит в шлюз с `/login`. На других поставщиках или когда `ANTHROPIC_BASE_URL` указывает на что-то другое, чем API Anthropic, он начинает со следующего источника1571. Удалённые параметры, доставленные с claude.ai как [параметры, управляемые сервером](/docs/ru/server-managed-settings) или через [шлюз приложений Claude](/docs/ru/claude-apps-gateway). Claude Code получает этот источник только когда сеанс аутентифицируется в API Anthropic напрямую с помощью [подходящего входа или ключа](/docs/ru/server-managed-settings#platform-availability) или входит в шлюз с помощью `/login`. На других поставщиках или когда `ANTHROPIC_BASE_URL` указывает на что-то другое, чем API Anthropic, он начинает со следующего источника

1572. Политики MDM или уровня ОС: plist macOS или ключ реестра HKLM1582. Политики MDM или уровня ОС: plist macOS или ключ реестра HKLM

1583. Управляемые файлы параметров, `managed-settings.d/*.json` и `managed-settings.json` объединены вместе1593. Управляемые файлы параметров, `managed-settings.d/*.json` и `managed-settings.json` объединённые вместе

1594. Реестр HKCU на Windows и на WSL после того, как реестр HKLM или файл управляемых параметров Windows включит [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) и значение HKCU также его установит. Claude Code читает его только когда ни один источник выше него не доставляет ключ политики и ни один [параметр родителя, предоставленный хостом](#let-an-embedding-host-add-policy) не предоставляет ограничивающий ключ1604. Реестр HKCU на Windows и на WSL после того, как реестр HKLM или файл управляемых параметров Windows включит [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) и значение HKCU также установит его. Claude Code читает его только когда нет документа администратора выше него и нет [параметров родителя, предоставленных хостом](#let-an-embedding-host-add-policy), которые предоставляют ограничивающий ключ

161

162<span id="present-admin-documents" />

163

164Claude Code никогда не применяет доступный для записи пользователем реестр HKCU под документом администратора, который присутствует. Документ присутствует, когда он устанавливает любой ключ политики на значение, отличное от `null`, даже значение, которое Claude Code не может прочитать. Значение HKLM, файл управляемых параметров или каталог `managed-settings.d`, которые существуют, но не могут быть прочитаны, также присутствуют. На WSL `/etc/claude-code` также доступен для записи пользователем, и запись [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) указывает, когда документы Windows находятся выше него.

160 165

161Эта диаграмма показывает ранжирование с примерами кросс-источниковых ключей, которые Claude Code читает из первых трёх источников при любом параметре:166Эта диаграмма показывает ранжирование с примерами кросс-источниковых ключей, которые Claude Code читает из первых трёх источников при любом параметре:

162 167

163<img src="https://mintcdn.com/claude-code/zuWID2B-Rxm8DEC8/images/managed-source-precedence.svg?fit=max&auto=format&n=zuWID2B-Rxm8DEC8&q=85&s=53f6be49f06eff48e01422c8ae1bc2e6" className="dark:hidden" alt="Диаграмма, показывающая четыре источника управляемых параметров, ранжированные от удалённых параметров в верхней части через MDM, управляемые файлы параметров и реестр HKCU внизу. По умолчанию первый источник с ключом политики предоставляет политику, а остальные пропускаются; с managedSourcesBehavior установленным на merge, каждый источник администратора с ключом политики вносит вклад, объединённый по типу ключа, и реестр HKCU остаётся в стороне. Боковая панель показывает, что кросс-источниковые ключи, такие как блокировки песочницы, forceRemoteSettingsRefresh и слияние env для каждой переменной, читаются из каждого источника администратора, что исключает реестр HKCU." width="680" height="330" data-path="images/managed-source-precedence.svg" />168<img src="https://mintcdn.com/claude-code/zuWID2B-Rxm8DEC8/images/managed-source-precedence.svg?fit=max&auto=format&n=zuWID2B-Rxm8DEC8&q=85&s=53f6be49f06eff48e01422c8ae1bc2e6" className="dark:hidden" alt="Диаграмма, показывающая четыре управляемых источника параметров, ранжированные от удалённых параметров в верхней части через MDM, управляемые файлы параметров и реестр HKCU в нижней части. По умолчанию первый источник с ключом политики предоставляет политику, а остальные пропускаются; с managedSourcesBehavior установленным на merge, каждый источник администратора с ключом политики вносит вклад, объединённый по типу ключа, и реестр HKCU остаётся в стороне. Боковая панель показывает, что кросс-источниковые ключи, такие как блокировки песочницы, forceRemoteSettingsRefresh и слияние env для каждой переменной, читаются из каждого источника администратора, что исключает реестр HKCU." width="680" height="330" data-path="images/managed-source-precedence.svg" />

164 169

165<img src="https://mintcdn.com/claude-code/zuWID2B-Rxm8DEC8/images/managed-source-precedence-dark.svg?fit=max&auto=format&n=zuWID2B-Rxm8DEC8&q=85&s=ae407a9a08a3d680e80cf1a2af845d71" className="hidden dark:block" alt="Диаграмма, показывающая четыре источника управляемых параметров, ранжированные от удалённых параметров в верхней части через MDM, управляемые файлы параметров и реестр HKCU внизу. По умолчанию первый источник с ключом политики предоставляет политику, а остальные пропускаются; с managedSourcesBehavior установленным на merge, каждый источник администратора с ключом политики вносит вклад, объединённый по типу ключа, и реестр HKCU остаётся в стороне. Боковая панель показывает, что кросс-источниковые ключи, такие как блокировки песочницы, forceRemoteSettingsRefresh и слияние env для каждой переменной, читаются из каждого источника администратора, что исключает реестр HKCU." width="680" height="330" data-path="images/managed-source-precedence-dark.svg" />170<img src="https://mintcdn.com/claude-code/zuWID2B-Rxm8DEC8/images/managed-source-precedence-dark.svg?fit=max&auto=format&n=zuWID2B-Rxm8DEC8&q=85&s=ae407a9a08a3d680e80cf1a2af845d71" className="hidden dark:block" alt="Диаграмма, показывающая четыре управляемых источника параметров, ранжированные от удалённых параметров в верхней части через MDM, управляемые файлы параметров и реестр HKCU в нижней части. По умолчанию первый источник с ключом политики предоставляет политику, а остальные пропускаются; с managedSourcesBehavior установленным на merge, каждый источник администратора с ключом политики вносит вклад, объединённый по типу ключа, и реестр HKCU остаётся в стороне. Боковая панель показывает, что кросс-источниковые ключи, такие как блокировки песочницы, forceRemoteSettingsRefresh и слияние env для каждой переменной, читаются из каждого источника администратора, что исключает реестр HKCU." width="680" height="330" data-path="images/managed-source-precedence-dark.svg" />

166 171

167<h3 id="keys-read-from-every-admin-source">172<h3 id="keys-read-from-every-admin-source">

168 Ключи, читаемые из каждого источника администратора173 Ключи, читаемые из каждого источника администратора

169</h3>174</h3>

170 175

171При параметре по умолчанию `"first-wins"` Claude Code читает большинство ключей только из [источника, который он выбрал](#how-claude-code-combines-managed-sources), и игнорирует значение в источнике с более низким рейтингом даже когда выбранный источник оставляет этот ключ неустановленным.176При параметре по умолчанию `"first-wins"` Claude Code читает большинство ключей только из [источника, который он выбрал](#how-claude-code-combines-managed-sources), и игнорирует значение в источнике с более низким рейтингом, даже когда выбранный источник оставляет этот ключ неустановленным.

172 177

173Несколько ключей работают иначе. Claude Code читает их из каждого источника администратора, поэтому политика MDM с более низким рейтингом или управляемый файл параметров могут всё ещё установить их, когда выбранный источник этого не делает. Claude Code исключает доступный для записи пользователем реестр HKCU из этого сканирования; когда HKCU является единственным источником и ни один хост не предоставляет параметры родителя, HKCU применяется как любой выбранный источник.178Несколько ключей работают иначе. Claude Code читает их из каждого источника администратора, поэтому политика MDM с более низким рейтингом или файл управляемых параметров могут всё ещё установить их, когда выбранный источник этого не делает. Claude Code исключает доступный для записи пользователем реестр HKCU из этого сканирования; когда HKCU является единственным источником и ни один хост не предоставляет параметры родителя, HKCU применяется как любой выбранный источник.

174 179

175Кросс-источниковые ключи включают:180Кросс-источниковые ключи включают:

176 181

177* `sandbox.network.allowManagedDomainsOnly` и `sandbox.filesystem.allowManagedReadPathsOnly`: `true` в любом источнике администратора включает блокировку. Пока блокировка включена, Claude Code объединяет список разрешений, который она блокирует, `sandbox.network.allowedDomains` вместе с правилами разрешения WebFetch(domain:...), или `sandbox.filesystem.allowRead`, по всем источникам администратора. Без блокировки Claude Code обрабатывает список разрешений как любой другой ключ, поэтому при `"first-wins"` список разрешений невыбранного источника администратора игнорируется182* `sandbox.network.allowManagedDomainsOnly` и `sandbox.filesystem.allowManagedReadPathsOnly`: `true` в любом источнике администратора включает блокировку. Пока блокировка включена, Claude Code объединяет список разрешений, который она блокирует, `sandbox.network.allowedDomains` вместе с правилами разрешения `WebFetch(domain:...)` или `sandbox.filesystem.allowRead` из каждого источника администратора. Без блокировки Claude Code обрабатывает список разрешений как любой другой ключ, поэтому при `"first-wins"` список разрешений невыбранного источника администратора игнорируется

178* `allowAllClaudeAiMcps`183* `allowAllClaudeAiMcps`

179* `allowManagedMcpServersOnly`: `true` в любом источнике администратора включает блокировку списка разрешений MCP. Пока блокировка включена, управляемый список `allowedMcpServers` поступает из источника администратора с наивысшим рейтингом, который его устанавливает. Список, управляемый сервером, заменяет список более низкого источника, а не объединяется с ним.184* `allowManagedMcpServersOnly`: `true` в любом источнике администратора включает блокировку списка разрешений MCP. Пока блокировка включена, управляемый список `allowedMcpServers` поступает из источника администратора с наивысшим рейтингом, который его устанавливает. Список, управляемый сервером, заменяет список нижнего источника, а не объединяется с ним.

180 185

181 Если ни один источник администратора не устанавливает список, каждый сервер, который проходит список отрицания, загружается, если только [параметры родителя](#let-an-embedding-host-add-policy) не предоставляют список.186 Если ни один источник администратора не устанавливает список, каждый сервер, который проходит список запрещённых, загружается, если только [параметры родителя](#let-an-embedding-host-add-policy) не предоставляют список.

182 187

183 Без блокировки Claude Code читает `allowedMcpServers` из управляемого источника, который он применяет, поэтому при `"first-wins"` список невыбранного источника администратора игнорируется. Требует Claude Code v2.1.273 или позже188 Без блокировки Claude Code читает `allowedMcpServers` из управляемого источника, который он применяет, поэтому при `"first-wins"` список невыбранного источника администратора игнорируется. Требует Claude Code v2.1.273 или позже

184* `deniedMcpServers` и [`disableClaudeAiConnectors`](/docs/ru/settings-reference#disableclaudeaiconnectors): запись или `true` в любом источнике администратора применяется. Требует Claude Code v2.1.273 или позже189* `deniedMcpServers` и [`disableClaudeAiConnectors`](/docs/ru/settings-reference#disableclaudeaiconnectors): запись или `true` в любом источнике администратора применяется. Требует Claude Code v2.1.273 или позже

186* Двоичный файл песочницы `ripgrep`, [`sandbox.ripgrep`](/docs/ru/settings-reference#sandbox-ripgrep)191* Двоичный файл песочницы `ripgrep`, [`sandbox.ripgrep`](/docs/ru/settings-reference#sandbox-ripgrep)

187* `sandbox.filesystem.disabled` и `sandbox.network.strictAllowlist`192* `sandbox.filesystem.disabled` и `sandbox.network.strictAllowlist`

188* [`useAutoModeDuringPlan`](/docs/ru/settings-reference#useautomodeduringplan), [`syncClaudeAiSkills`](/docs/ru/settings-reference#syncclaudeaiskills) и [`syncClaudeAiPlugins`](/docs/ru/settings-reference#syncclaudeaiplugins), где `false` из любого источника администратора отключает поведение. `false` в параметрах пользователя или локальных параметрах разработчика также отключает его; каждый ключ может только отрицать193* [`useAutoModeDuringPlan`](/docs/ru/settings-reference#useautomodeduringplan), [`syncClaudeAiSkills`](/docs/ru/settings-reference#syncclaudeaiskills) и [`syncClaudeAiPlugins`](/docs/ru/settings-reference#syncclaudeaiplugins), где `false` из любого источника администратора отключает поведение. `false` в параметрах пользователя или локальных параметрах разработчика также отключает его; каждый ключ может только отрицать

189* [`enableArtifact`](/docs/ru/settings-reference#enableartifact), где `false` из любого источника администратора отключает [инструмент Artifact](/docs/ru/artifacts). `false` в параметрах пользователя, проекта или локальных параметрах разработчика также отключает его, и ни один источник не включает его обратно; см. [какие значения более низкого уровня всё ещё считаются](/docs/ru/settings#exceptions-to-managed-settings-precedence). Требует Claude Code v2.1.242 или позже194* [`enableArtifact`](/docs/ru/settings-reference#enableartifact), где `false` из любого источника администратора отключает [инструмент Artifact](/docs/ru/artifacts). `false` в параметрах пользователя, проекта или локальных параметрах разработчика также отключает его, и ни один источник не включает его обратно; см. [какие значения более низкого уровня всё ещё учитываются](/docs/ru/settings#exceptions-to-managed-settings-precedence). Требует Claude Code v2.1.242 или позже

190* [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel), где применяется самый низкий лимит в любом источнике администратора. Если разработчик установит более низкий лимит в своих собственных параметрах или с `--settings`, Claude Code применит этот; ни один источник не может повысить лимит. Требует Claude Code v2.1.267 или позже195* [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel), где применяется наименьший лимит из любого источника администратора. Если разработчик устанавливает более низкий лимит в своих собственных параметрах или с помощью `--settings`, Claude Code применяет этот; ни один источник не может повысить лимит. Требует Claude Code v2.1.267 или позже

191* Отказ от трейлера коммита в `attribution` или в устаревшем `includeCoAuthoredBy` из любого уровня196* Отказ от трейлера коммита в `attribution` или в устаревшем `includeCoAuthoredBy` из любого уровня

192* [`forceRemoteSettingsRefresh`](/docs/ru/server-managed-settings)197* [`forceRemoteSettingsRefresh`](/docs/ru/server-managed-settings)

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

194 199

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

196 201

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

198 203

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

201</h3>206</h3>

202 207

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

204 209

205При `"merge"` Claude Code добавляет записи списка более низкого источника, такие как правила `permissions.allow` и hooks, к политике, поэтому включайте это только когда каждый источник, ранжированный ниже вашего наивысшего, находится под контролем администратора.210При `"merge"` Claude Code добавляет записи списка нижнего источника, такие как правила `permissions.allow` и hooks, к политике, поэтому включайте это только когда каждый источник, ранжированный ниже вашего наивысшего, находится под контролем администратора.

206 211

207Эта таблица показывает, как Claude Code объединяет каждый тип ключа при `"merge"`. Запись [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) называет каждый ключ в трёх из строк: списки ограничений, значения, взятые целиком, и ключи, читаемые только из источника с наивысшим рейтингом.212Эта таблица показывает, как Claude Code объединяет каждый тип ключа при `"merge"`. Запись [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) называет каждый ключ в трёх из строк: списки разрешений ограничений, значения, взятые целиком, и ключи, читаемые только из источника с наивысшим рейтингом.

208 213

210| :- | :- | :- |215| :- | :- | :- |

212| Блокировки | Применяет наиболее строгое значение, которое устанавливает любой источник; более мягкое значение применяется только из источника с наивысшим рейтингом | `allowManagedHooksOnly`, `permissions.disableBypassPermissionsMode`, `crossSessionInbound` |217| Блокировки | Применяет наиболее строгое значение, которое устанавливает любой источник; более мягкое значение применяется только из источника с наивысшим рейтингом | `allowManagedHooksOnly`, `permissions.disableBypassPermissionsMode`, `crossSessionInbound`, `availableModelsMatch` |

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

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

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

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

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

219 224

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

221 226

222<h3 id="compute-the-policy-with-a-helper-program">227<h3 id="compute-the-policy-with-a-helper-program">

223 Вычислите политику с помощью вспомогательной программы228 Вычислите политику с помощью вспомогательной программы

224</h3>229</h3>

225 230

226[`policyHelper`](/docs/ru/settings-reference#policyhelper) — это исполняемый файл, который называет ваша политика MDM или управляемый файл параметров, и Claude Code запускает его для вычисления управляемых параметров при запуске. Когда выбранный источник настраивает один и помощник выдаёт объект `managedSettings`, этот вывод изменяет то, что Claude Code читает:231[`policyHelper`](/docs/ru/settings-reference#policyhelper) — это исполняемый файл, который называет ваша политика MDM или файл управляемых параметров, и Claude Code запускает его для вычисления управляемых параметров при запуске. Когда выбранный источник настраивает один и помощник выдаёт объект `managedSettings`, этот вывод изменяет то, что читает Claude Code:

227 232

228* **Выданный объект `managedSettings` — это единственные управляемые параметры для сеанса**, включая [ключи, которые он иначе читает из каждого источника администратора](#keys-read-from-every-admin-source), кроме [`forceRemoteSettingsRefresh`, который имеет своё собственное правило запуска](/docs/ru/settings-reference#forceremotesettingsrefresh)233* **Выданный объект `managedSettings` — это единственные управляемые параметры для сеанса**, включая [ключи, которые он иначе читает из каждого источника администратора](#keys-read-from-every-admin-source), кроме [`forceRemoteSettingsRefresh`, который имеет своё собственное правило запуска](/docs/ru/settings-reference#forceremotesettingsrefresh)

229 234

230Для того, какие запуски помощника не удаются и что Claude Code делает, когда один не удаётся, см. [Сбои помощника](/docs/ru/settings-reference#helper-failures).235Для того, какие запуски помощника не удаются и что Claude Code делает, когда это происходит, см. [Сбои помощника](/docs/ru/settings-reference#helper-failures).

231 236

232<span id="parent-settings-from-embedding-hosts" />237<span id="parent-settings-from-embedding-hosts" />

233 238

241 246

242Когда другое приложение запускает Claude Code, такое как Claude Desktop, расширение IDE или приложение Agent SDK, этот хост может передать свои собственные управляемые параметры через опцию SDK `managedSettings`. Claude Code называет эти параметры родителя.247Когда другое приложение запускает Claude Code, такое как Claude Desktop, расширение IDE или приложение Agent SDK, этот хост может передать свои собственные управляемые параметры через опцию SDK `managedSettings`. Claude Code называет эти параметры родителя.

243 248

244По умолчанию Claude Code игнорирует параметры родителя всякий раз, когда присутствует источник администратора: параметры, управляемые сервером, политика MDM или уровня ОС, или управляемый файл параметров.249По умолчанию Claude Code игнорирует параметры родителя всякий раз, когда присутствует источник администратора: параметры, управляемые сервером, политика MDM или уровня ОС, или файл управляемых параметров.

245 250

246Чтобы Claude Code объединял параметры родителя наряду с источником администратора, установите [`parentSettingsBehavior`](/docs/ru/settings-reference#parentsettingsbehavior) на `"merge"` в источнике с наивысшим приоритетом; Claude Code читает ключ из этого источника только.251Чтобы Claude Code объединял параметры родителя наряду с источником администратора, установите [`parentSettingsBehavior`](/docs/ru/settings-reference#parentsettingsbehavior) на `"merge"` в источнике с наивысшим приоритетом; Claude Code читает ключ только из этого источника.

247 252

248Claude Code затем сохраняет только значения хоста, которые ограничивают то, что может делать Claude, с одним пробелом, о котором нужно знать: если вы также не установите блокировки `allowManaged*Only`, правила разрешения разрешений хоста и списки разрешений песочницы всё ещё применяются. См. [Ограничьте параметры родителя](/docs/ru/claude-apps-gateway#restrict-parent-settings) для блокировок.253Claude Code затем сохраняет только значения хоста, которые ограничивают то, что может делать Claude, с одним пробелом, о котором нужно знать: если вы также не установите блокировки `allowManaged*Only`, правила разрешения хоста и списки разрешений песочницы всё ещё применяются. См. [Ограничьте параметры родителя](/docs/ru/claude-apps-gateway#restrict-parent-settings) для блокировок.

249 254

250[`policyHelper`](/docs/ru/settings-reference#policyhelper) может отключить слияние родителя независимо от этого ключа; его запись говорит, когда.255[`policyHelper`](/docs/ru/settings-reference#policyhelper) может отключить слияние родителя независимо от этого ключа; его запись говорит, когда.

251 256

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

253 258

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

255* Claude Code применяет значение `forceLoginOrgUUID` или `allowedMcpServers` в управляемых параметрах, которые он применяет, и блокирует предоставленное родителем. Вне блокировки списка разрешений MCP значение в более низком источнике администратора, который Claude Code не применяет, ни применяется, ни блокирует родителя.260* Claude Code применяет значение `forceLoginOrgUUID` или `allowedMcpServers` в управляемых параметрах, которые он применяет, и блокирует предоставленное родителем. Вне блокировки списка разрешений MCP значение в нижнем источнике администратора, который Claude Code не применяет, ни применяется, ни блокирует родителя.

256 261

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

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

263 Сохраните доступ к папке Cowork, когда применяются только управляемые правила268 Сохраните доступ к папке Cowork, когда применяются только управляемые правила

264</h4>269</h4>

265 270

266[Cowork](https://claude.com/docs/cowork/overview) в приложении Claude Desktop запускает свои сеансы на Claude Code и предоставляет каждому сеансу доступ к своим рабочим папкам, таким как папка, которую подключает пользователь, через правила разрешения, которые он предоставляет при запуске сеанса. Когда ваша управляемая политика устанавливает [`allowManagedPermissionRulesOnly`](/docs/ru/settings-reference#allowmanagedpermissionrulesonly), Claude Code сохраняет только правила разрешения в управляемой политике: он отбрасывает правила разрешения, которые хост предоставляет как параметры родителя, как `--allowedTools` или в файле параметров, поэтому записи в эти папки теряют предварительное одобрение. В сеансе Cowork, который спрашивает перед редактированием, Cowork не может показать подсказку, и Claude сообщает о каждой записи как заблокированной, потому что путь разрешается в защищённое место или путь вне подключённой папки.271[Cowork](https://claude.com/docs/cowork/overview) в приложении Claude Desktop запускает свои сеансы на Claude Code и предоставляет каждому сеансу доступ к его рабочим папкам, таким как папка, которую подключает пользователь, через правила разрешения, которые он предоставляет при запуске сеанса. Когда ваша управляемая политика устанавливает [`allowManagedPermissionRulesOnly`](/docs/ru/settings-reference#allowmanagedpermissionrulesonly), Claude Code сохраняет только правила разрешения в управляемой политике: он удаляет правила разрешения, которые хост предоставляет как параметры родителя, как `--allowedTools` или в файле параметров, поэтому записи в эти папки теряют предварительное одобрение. В сеансе Cowork, который спрашивает перед редактированием, Cowork не может показать подсказку, и Claude сообщает о каждой записи как заблокированной, потому что путь разрешается в защищённое место или путь вне подключённой папки.

267 272

268Чтобы восстановить записи, добавьте правила разрешения для этих папок в управляемый источник, который Claude Code [выбирает](#precedence-within-the-managed-tier) на этих машинах: на управляемом MDM парке это политика MDM, а не отдельный управляемый файл параметров. Этот пример использует форму файла, и политика MDM принимает те же ключи. Она сохраняет `allowManagedPermissionRulesOnly` установленным и позволяет редактирование в папке `CoworkProjects` в домашнем каталоге каждого пользователя; замените путь на папки, которые подключают ваши пользователи:273Чтобы восстановить записи, добавьте правила разрешения для этих папок в управляемый источник, который Claude Code [выбирает](#precedence-within-the-managed-tier) на этих машинах: на управляемом MDM парке это политика MDM, а не отдельный файл управляемых параметров. Этот пример использует форму файла, и политика MDM принимает те же ключи. Она сохраняет `allowManagedPermissionRulesOnly` установленным и позволяет редактирование в папке `CoworkProjects` в домашнем каталоге каждого пользователя; замените путь на папки, которые подключают ваши пользователи:

269 274

270```json managed-settings.json theme={null}275```json managed-settings.json theme={null}

271{276{

284 Что может изменить разработчик289 Что может изменить разработчик

285</h3>290</h3>

286 291

287Собственные файлы параметров разработчика, значения `--settings` и файлы проекта никогда не переопределяют управляемое значение; [исключения](/docs/ru/settings#exceptions-to-managed-settings-precedence) только позволяют более строгому значению более низкого уровня считаться. Эти случаи находятся вне этого правила:292Собственные файлы параметров разработчика, значения `--settings` и файлы проекта никогда не переопределяют управляемое значение; [исключения](/docs/ru/settings#exceptions-to-managed-settings-precedence) только позволяют учитывать более строгое значение более низкого уровня. Эти случаи находятся вне этого правила:

288 293

289* **Модель для сеанса**: управляемая `model` — это значение по умолчанию, а не блокировка. `--model` и `ANTHROPIC_MODEL` всё ещё выбирают модель для этого сеанса, поэтому развёртывайте [`availableModels`](/docs/ru/settings-reference#availablemodels) для ограничения выбора.294* **Модель для сеанса**: управляемая `model` — это значение по умолчанию, а не блокировка. `--model` и `ANTHROPIC_MODEL` всё ещё выбирают модель для этого сеанса, поэтому развёртывайте [`availableModels`](/docs/ru/settings-reference#availablemodels) для ограничения выбора.

290* **Локальные права администратора**: разработчик, который является администратором на машине, может редактировать сам управляемый источник, поэтому инструменты MDM могут переразвёртывать профиль или файл по расписанию и почему существуют реестр HKLM и домен управляемых предпочтений macOS.295* **Локальные права администратора**: разработчик, который является администратором на машине, может редактировать сам управляемый источник, поэтому инструменты MDM могут переразвёртывать профиль или файл по расписанию и почему существуют реестр HKLM и домен управляемых предпочтений macOS.

291* **Кэш, управляемый сервером**: параметры, управляемые сервером, поступают с серверов Anthropic, и редактирование локального кэша [длится только до следующей успешной выборки](/docs/ru/server-managed-settings#security-considerations).296* **Кэш, управляемый сервером**: параметры, управляемые сервером, поступают с серверов Anthropic, и редактирование локального кэша [длится только до следующей успешной выборки](/docs/ru/server-managed-settings#security-considerations).

292* **Другие инструменты**: управляемые параметры связывают только Claude Code. Разработчик, который вызывает API из другого инструмента, не находится под ними.297* **Другие инструменты**: управляемые параметры привязывают только Claude Code. Разработчик, который вызывает API из другого инструмента, не подчиняется им.

293 298

294<span id="verify-enforcement" />299<span id="verify-enforcement" />

295 300

299 Проверьте, что политика действует304 Проверьте, что политика действует

300</h2>305</h2>

301 306

302Разработчик сообщает, что политика не применяется, или вы хотите подтвердить, что развертывание приземлилось перед отправкой на парк. Две команды на этой машине отвечают на это: `/status` показывает, какой управляемый источник выбрал Claude Code, и `claude doctor` перечисляет то, что он отбросил.307Разработчик сообщает, что политика не применяется, или вы хотите подтвердить, что развертывание прошло успешно перед развертыванием на весь парк. Две команды на этой машине дают ответ: `/status` показывает, какой управляемый источник выбрал Claude Code, а `claude doctor` перечисляет то, что он отбросил.

303 308

304<h3 id="read-the-source-in-/status">309<h3 id="read-the-source-in-/status">

305 Прочитайте источник в /status310 Прочитайте источник в /status

306</h3>311</h3>

307 312

308На машине разработчика запустите `/status` внутри Claude Code и прочитайте строку `Setting sources`. Когда управляемый источник действует, строка перечисляет `Enterprise managed settings` с источником, который выбрал Claude Code, в скобках:313На машине разработчика запустите `/status` внутри Claude Code и прочитайте строку `Setting sources`. Когда управляемый источник действует, строка перечисляет `Enterprise managed settings` с источником, выбранным Claude Code в скобках:

309 314

310* `(remote)`: управляемые параметры сервера из claude.ai или шлюза315* `(remote)`: управляемые сервером параметры из claude.ai или шлюза

311* `(plist)` или `(HKLM)`: политика MDM или ОС316* `(plist)` или `(HKLM)`: политика MDM или ОС

312* `(file)`, `(drop-ins)` или `(file + drop-ins)`: `managed-settings.json`, каталог drop-in или оба317* `(file)`, `(drop-ins)` или `(file + drop-ins)`: `managed-settings.json`, каталог drop-in или оба

313* `(remote + file, merged)` или другой список, заканчивающийся на `, merged`: ваша организация [составляет каждый управляемый источник](#compose-every-managed-source), и Claude Code объединил перечисленные источники в политику. Более низкий источник все еще может предоставлять переменные `env` без появления в списке. Требует Claude Code v2.1.242 или позже318* `(remote + file, merged)` или другой список, заканчивающийся на `, merged`: ваша организация [объединяет каждый управляемый источник](#compose-every-managed-source), и Claude Code объединил перечисленные источники в политику. Нижний источник все еще может предоставлять переменные `env` без появления в списке. Требуется Claude Code v2.1.242 или позже

314* `(HKCU)`: резервный реестр, доступный для записи пользователем319* `(HKCU)`: резервный реестр, доступный для записи пользователем

315* `(parent process)`: [хост встраивания](#let-an-embedding-host-add-policy) предоставил ограничивающие параметры320* `(parent process)`: [хост встраивания](#let-an-embedding-host-add-policy) предоставил ограничивающие параметры

316* `(helper)`: [`policyHelper`](/docs/ru/settings-reference#policyhelper), настроенный выбранным источником MDM или файла321* `(helper)`: [`policyHelper`](/docs/ru/settings-reference#policyhelper), настроенный выбранным источником MDM или файла

317 322

318Когда Claude Code нашел управляемый источник на машине и не выбрал его, вторая строка, `Skipped sources`, называет каждый такой источник. Прочитайте его, чтобы различить политику, которая никогда не достигла машину, от той, которая достигла и которую источник с более высоким приоритетом переопределил. Требует Claude Code v2.1.242 или позже.323Когда Claude Code обнаружил управляемый источник на машине и не выбрал его, вторая строка, `Skipped sources`, называет каждый такой источник. Прочитайте ее, чтобы различить политику, которая никогда не достигла машину, от той, которая достигла ее и которую источник с более высоким приоритетом переопределил. Требуется Claude Code v2.1.242 или позже.

319 324

320Когда политика не применяется, строка `Setting sources` говорит вам, какая из двух проблем у вас есть:325Когда политика не применяется, строка `Setting sources` говорит вам, какая из двух проблем у вас есть:

321 326

322* **Строка отсутствует**: Claude Code не нашел управляемый источник, который доставляет ключ политики.327* **Строка отсутствует**: Claude Code не нашел управляемый источник, который доставляет ключ политики.

323 328

324 Если вы развернули файл управляемых параметров, проверьте, что он находится по пути для ОС и что он содержит [ключ политики](#how-claude-code-combines-managed-sources), а не только ключи управления. Файл, который не является действительным JSON, не производит это состояние; Claude Code [отказывается запускаться](#find-entries-claude-code-dropped) вместо этого.329 Если вы развернули файл управляемых параметров, проверьте, что он находится по пути для ОС и что он содержит [ключ политики](#how-claude-code-combines-managed-sources), а не только ключи управления. Файл, который не является допустимым JSON, не создает это состояние; Claude Code [отказывается запускаться](#find-entries-claude-code-dropped) вместо этого.

325 330

326 Когда вы развернули через управляемые параметры сервера вместо этого, запустите `claude doctor`, который сообщает [результат выборки](/docs/ru/server-managed-settings#verify-settings-delivery).331 Когда вы развернули через управляемые сервером параметры, запустите `claude doctor`, который сообщает [результат выборки](/docs/ru/server-managed-settings#verify-settings-delivery).

327* **Строка называет источник, отличный от того, который вы развернули**: источник с более высоким приоритетом присутствует и Claude Code игнорировал ваш, и `Skipped sources` его перечисляет. [Как Claude Code объединяет управляемые источники](#how-claude-code-combines-managed-sources) дает порядок.332* **Строка называет источник, отличный от того, который вы развернули**: присутствует источник с более высоким приоритетом, и Claude Code проигнорировал ваш, и `Skipped sources` его перечисляет. [Как Claude Code объединяет управляемые источники](#how-claude-code-combines-managed-sources) дает порядок.

328 333

329<span id="invalid-entries-in-managed-settings" />334<span id="invalid-entries-in-managed-settings" />

330 335

332 Найдите записи, которые Claude Code отбросил337 Найдите записи, которые Claude Code отбросил

333</h3>338</h3>

334 339

335Когда файл управляемых параметров, профиль MDM, значение реестра или полезная нагрузка управляемого сервера не проходит проверку схемы, Claude Code сначала пропускает отдельные записи, которые он может исправить, такие как одно неправильное правило разрешения, с предупреждением для каждого, затем отбрасывает любой ключ верхнего уровня, значение которого все еще не проходит, и продолжает применять каждый оставшийся действительный ключ.340Если ваш файл управляемых параметров, профиль MDM, значение реестра или полезная нагрузка, управляемая сервером, не проходит проверку схемы, Claude Code сначала пропускает каждую отдельную запись, которую он может исправить, например одно неправильное правило разрешения, и предупреждает о каждой. Claude Code затем отбрасывает любое значение, которое все еще не проходит, если только значение не принадлежит одному из ключей, которые [не проходят закрыто](#keys-that-fail-closed) вместо этого.

336 341

337Claude Code более строг с `managedSettings`, который выдает [`policyHelper`](/docs/ru/settings-reference#policyhelper): он делает те же исправления записей, но любое нарушение схемы, которое выживает, не удается весь запуск помощника, и при запуске Claude Code отказывается запускаться, то же самое, что для помощника, который выходит с ненулевым кодом.342Claude Code более строг с `managedSettings`, который [`policyHelper`](/docs/ru/settings-reference#policyhelper) выдает: он делает те же исправления записей, но любое нарушение схемы, которое выживает, не проходит весь запуск помощника, и при запуске Claude Code отказывается запускаться, то же самое, что и для помощника, который выходит с ненулевым кодом.

338 343

339Когда файл управляемых параметров, файл drop-in, plist MDM или значение реестра HKLM присутствуют, но не могут быть проанализированы как объект JSON, Claude Code отказывается запускаться и печатает [ошибку, называющую источник](/docs/ru/errors#managed-settings-document-could-not-be-parsed), даже когда другой источник администратора доставляет действительную политику. Каждый источник не удается таким образом, когда:344Когда файл управляемых параметров, файл drop-in, plist MDM или значение реестра HKLM присутствуют, но не могут быть проанализированы как объект JSON, Claude Code отказывается запускаться и выводит [ошибку, называющую источник](/docs/ru/errors#managed-settings-document-could-not-be-parsed), даже когда другой источник администратора доставляет допустимую политику. Каждый источник не проходит таким образом, когда:

340 345

341* **Файл управляемых параметров или файл drop-in**: файл не является действительным JSON или его верхний уровень не является объектом346* **Файл управляемых параметров или файл drop-in**: файл не является допустимым JSON или его верхний уровень не является объектом

342* **Plist MDM**: `plutil` macOS сообщает plist неправильно сформированным или его преобразованное содержимое не является объектом JSON347* **MDM plist**: `plutil` macOS сообщает, что plist неправильно сформирован, или его преобразованное содержимое не является объектом JSON

343* **Значение реестра HKLM**: значение `Settings` не является строкой, пусто или не содержит объект JSON348* **Значение реестра HKLM**: значение `Settings` не является строкой, пусто или не содержит объект JSON

344 349

345Три состояния источника не вызывают этот отказ:350Три состояния источника не вызывают этого отказа:

346 351

347* Отсутствующий файл, профиль или значение реестра не является сбоем; Claude Code работает без этого источника.352* Отсутствующий файл, профиль или значение реестра не является сбоем; Claude Code работает без этого источника.

348* Пустой файл управляемых параметров считается `{}`.353* Пустой файл управляемых параметров считается `{}`.

349* Неправильное значение в доступном для записи пользователем ключе реестра HKCU никогда не блокирует запуск. Claude Code сообщает об этом как уведомление в `/status` и `claude doctor` вместо этого.354* Неправильное значение в доступном для записи ключе реестра HKCU никогда не блокирует запуск. Claude Code сообщает об этом как уведомление в `/status` и `claude doctor` вместо этого.

350 355

351Если файл управляемых параметров, файл drop-in или каталог `managed-settings.d/` не может быть прочитан и никакой источник администратора не предоставляет политику, сеансы, вошедшие с учетными данными claude.ai или Claude Console, выходят при запуске с сообщением о контакте с администратором.356Если файл управляемых параметров, файл drop-in или каталог `managed-settings.d/` не могут быть прочитаны и ни один источник администратора не предоставляет политику, сеансы, вошедшие с учетными данными claude.ai или Claude Console, выходят при запуске с сообщением о необходимости связаться с администратором.

352 357

353Чтобы найти отброшенную запись, посмотрите в одном из трех мест:358Чтобы найти отброшенную запись, посмотрите в одном из трех мест:

354 359

355* Интерактивные сеансы показывают диалог при запуске, перечисляющий неправильные записи.360* Интерактивные сеансы показывают диалоговое окно при запуске, в котором перечислены неправильные записи.

356* Неинтерактивные запуски с `-p` печатают сводку в stderr.361* Неинтерактивные запуски с `-p` выводят сводку в stderr.

357* [`claude doctor`](/docs/ru/debug-your-config) перечисляет каждую неправильную запись с ее источником и полем.362* [`claude doctor`](/docs/ru/debug-your-config) перечисляет каждую неправильную запись с ее источником и полем.

358 363

359<h4 id="keys-that-fail-closed">364<h4 id="keys-that-fail-closed">

360 Ключи, которые не удаются закрыто365 Ключи, которые не проходят закрыто

361</h4>366</h4>

362 367

363Несколько ключей применения не отбрасываются, когда они неправильны. Claude Code применяет более строгое резервное значение, пока значение не будет исправлено; таблица показывает, что оно применяет для каждого ключа:368Когда управляемый источник устанавливает ключ верхнего уровня, который имеет одно ограничивающее значение, такое как `allowManagedPermissionRulesOnly`, `disableAutoMode` или `skipDangerousModePermissionPrompt`, на что-то, что Claude Code не может прочитать, ключ читается как это значение, пока вы его не исправите. Отчет говорит, что ключ `was present but invalid` и называет значение, которое Claude Code рассматривает как. Для ключа внутри `sandbox` см. [Неправильные значения внутри `sandbox`](#invalid-values-inside-sandbox).

369

370Эти случаи не проходят закрыто:

371

372* `null` удаляет ключ.

373* Неправильный `disableAllHooks`, даже логическое значение в кавычках, отбрасывается с предупреждением, потому что применение `true` также выгрузит hooks, которые развертывают ваши собственные управляемые параметры.

374* Для каждого другого логического ключа, который охватывает правило, строка `"true"` или `"false"` читается как это логическое значение, с уведомлением в `/status`, просящим вас удалить кавычки.

375

376Claude Code исправляет блоки `permissions`, `autoMode`, `worktree` и `attribution` по полям вместо того, чтобы отбрасывать их целиком:

377

378* Блокировка внутри одного, такая как `permissions.disableBypassPermissionsMode`, читается как его ограничивающее значение.

379* Неправильный `permissions.defaultMode` читается как `default`.

380* Хотя список `deny` или `ask` в `permissions` не может быть прочитан вообще, Claude Code удерживает `allow` и `additionalDirectories`, поэтому гранты никогда не применяются без ограничений, написанных рядом с ними. Отчет называет каждый удерживаемый грант и список, который не мог быть прочитан.

381* В `autoMode` список `soft_deny` или `hard_deny`, который не может быть прочитан или потерял неправильную запись, удерживает `allow` и `environment` таким же образом.

382

383Правило не проходит закрыто для ключей с одним ограничивающим значением и исправления по полям требуют Claude Code v2.1.282 или позже.

364 384

365| Поле | Поведение, когда присутствует, но неправильно |385Эти ключи имеют свой собственный резервный вариант:

386

387| Поле | Поведение при наличии, но неправильном |

366| :- | :- |388| :- | :- |

367| `allowedMcpServers` | Применяется как пустой список разрешений, пока значение не будет исправлено, поэтому никакие MCP серверы, которые добавляют пользователи, не допускаются. Серверы, которые ваша организация доставляет через [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers), все еще загружаются, и серверы `managed-mcp.json` загружаются в соответствии с [Как сервер оценивается](/docs/ru/managed-mcp#how-a-server-is-evaluated). Отдельная неправильная запись удаляется и применяется действительное подмножество. |389| `allowedMcpServers` | Применяется как пустой список разрешений до исправления значения, поэтому ни один MCP-сервер, который добавляют пользователи, не допускается. Серверы, которые ваша организация доставляет через [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers), все еще загружаются, и серверы `managed-mcp.json` загружаются в соответствии с [Как сервер оценивается](/docs/ru/managed-mcp#how-a-server-is-evaluated). Неправильная отдельная запись удаляется и применяется допустимое подмножество. |

368| `allowedHttpHookUrls` | Claude Code применяет пустой [список разрешений](/docs/ru/settings-reference#allowedhttphookurls), пока вы не исправите значение, поэтому HTTP hook запускается только если другой файл параметров перечисляет его URL. Если только отдельная запись неправильна, Claude Code удаляет эту запись и применяет остальное. |390| `allowedHttpHookUrls` | Claude Code применяет пустой управляемый [список разрешений](/docs/ru/settings-reference#allowedhttphookurls) до исправления значения, поэтому HTTP hook работает только если другой файл параметров перечисляет его URL. Если неправильна только отдельная запись, Claude Code удаляет эту запись и применяет остальное. |

369| `httpHookAllowedEnvVars` | Claude Code применяет пустой [список разрешений](/docs/ru/settings-reference#httphookallowedenvvars), пока вы не исправите значение, поэтому переменная заголовка интерполируется только если другой файл параметров называет ее. Если только отдельная запись неправильна, Claude Code удаляет эту запись и применяет остальное. |391| `httpHookAllowedEnvVars` | Claude Code применяет пустой управляемый [список разрешений](/docs/ru/settings-reference#httphookallowedenvvars) до исправления значения, поэтому переменная заголовка интерполируется только если другой файл параметров ее называет. Если неправильна только отдельная запись, Claude Code удаляет эту запись и применяет остальное. |

370| `allowedChannelPlugins` | Claude Code применяет пустой список разрешений, пока вы не исправите значение, поэтому никакой плагин канала, переданный в `--channels`, не допускается. Если только отдельная запись неправильна, она удаляет эту запись и применяет остальное. |392| `allowedChannelPlugins` | Claude Code применяет пустой список разрешений до исправления значения, поэтому ни один плагин канала, переданный в `--channels`, не допускается. Если неправильна только отдельная запись, он удаляет эту запись и применяет остальное. |

371| `strictKnownMarketplaces` | Применяется как пустой список разрешений, пока значение не будет исправлено, поэтому никакой [источник marketplace](/docs/ru/plugins/org#restrict-what-users-can-install) не допускается. Отдельная запись, которая неправильна или не может быть применена, такая как регулярное выражение `hostPattern`, которое не компилируется, удаляется и применяется действительное подмножество. |393| `strictKnownMarketplaces` | Применяется как пустой список разрешений до исправления значения, поэтому ни один [источник маркетплейса](/docs/ru/plugins/org#restrict-what-users-can-install) не допускается. Отдельная запись, которая неправильна или не может быть применена, такая как регулярное выражение `hostPattern`, которое не компилируется, удаляется и применяется допустимое подмножество. |

372| `allowManagedHooksOnly` | Обрабатывается как `true`, пока не будет исправлено: [ограничения hook](/docs/ru/settings-reference#allowmanagedhooksonly) применяются и, если `disableCommandPluginSources` явно не `false`, плагины, полученные из команд, отключены. |394| `availableModels` | Применяется как пустой список разрешений до исправления, поэтому доступна только модель по умолчанию; запись, которая не является строкой, удаляется и применяется допустимое подмножество. |

374| `disableCommandPluginSources` | Обрабатывается как `true`, поэтому плагины, полученные из команд, остаются отключены, пока значение не будет исправлено. |396| `forceLoginOrgUUID` | Ни одной организации не разрешается входить до исправления значения. |

375| `disableSideloadFlags` | Обрабатывается как `true`, пока значение не будет исправлено, с эффектами, перечисленными для [`disableSideloadFlags`](/docs/ru/settings-reference#disablesideloadflags). |397| `gatewayInternalNetworks` | Когда неправильное значение поступает от наивысшего управляемого источника на машине, `/login` отказывает каждому новому входу [облачного шлюза](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) на этой машине до исправления значения. |

376| `availableModels` | Применяется как пустой список разрешений, пока не будет исправлено, поэтому доступна только модель Default; запись, не являющаяся строкой, удаляется и применяется действительное подмножество. |398| `crossSessionInbound` | Рассматривается как `refuse`, наиболее ограничивающее значение, поэтому входящие [сообщения между сеансами](/docs/ru/cross-session-messaging#control-inbound-messages) отказываются до исправления значения. Разработчик видит [предупреждение](/docs/ru/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |

377| `enforceAvailableModels` | Обрабатывается как `true`. |399| `deniedMcpServers` | Неправильная отдельная запись удаляется и применяется допустимое подмножество. Полностью неправильное значение отбрасывается с предупреждением, так как отрицание каждого сервера заблокирует серверы, которые политика никогда не называла. |

378| `syncClaudeAiPlugins` | Обрабатывается как `false`, поэтому синхронизация [плагинов claude.ai](/docs/ru/settings-reference#syncclaudeaiplugins) отключена, пока значение не будет исправлено. |400| [`deniedModels`](/docs/ru/settings-reference#deniedmodels) | Запись, которая не является строкой, удаляется и остальная часть списка применяется. Полностью неправильное значение отбрасывается с предупреждением и не блокирует никакие модели до исправления. |

379| `forceLoginOrgUUID` | Никакой организации не разрешается входить, пока значение не будет исправлено. |401| `blockedMarketplaces` | Неправильная отдельная запись удаляется и применяется допустимое подмножество. Запись, которая анализируется, но никогда не может совпадать, такая как регулярное выражение `hostPattern`, которое не компилируется, сохраняется с предупреждением. Она ничего не блокирует до исправления, но [ограничения маркетплейса](/docs/ru/plugins/org#restrict-what-users-can-install) остаются активными. Полностью неправильное значение отбрасывается с предупреждением, так как блокирование каждого маркетплейса заблокирует источники, которые политика никогда не называла. |

380| `gatewayInternalNetworks` | Когда неправильное значение поступает из наивысшего управляемого источника на машине, `/login` отказывает каждому новому входу [облачного шлюза](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) на этой машине, пока значение не будет исправлено. |402| `sandbox` | Когда одно значение внутри блока неправильно, Claude Code не отбрасывает весь блок. Для того, что происходит с каждым видом неправильного поля, см. [Неправильные значения внутри `sandbox`](#invalid-values-inside-sandbox). |

381| `crossSessionInbound` | Обрабатывается как `refuse`, самое строгое значение, поэтому входящие [кросс-сеансовые сообщения](/docs/ru/cross-session-messaging#control-inbound-messages) отказываются, пока значение не будет исправлено. Разработчик видит [предупреждение](/docs/ru/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |403| `sandbox.credentials` | Восстанавливаемая неправильная запись деградирует до `mode: "deny"` с предупреждением; невосстанавливаемая удаляется; допустимые записи остаются применяемыми. См. [неправильные записи учетных данных](/docs/ru/settings-reference#invalid-credential-entries-in-managed-settings). |

382| `deniedMcpServers` | Отдельная неправильная запись удаляется и применяется действительное подмножество. Полностью неправильное значение отбрасывается с предупреждением, так как отрицание каждого сервера заблокировало бы серверы, которые политика никогда не называла. |404| `strictPluginOnlyCustomization` | Рассматривается как `true`, блокирующее все четыре поверхности, когда значение не является ни логическим, ни массивом. Запись массива, которую эта версия не распознает как поверхность, не блокирует ничего; примечание статуса считает такие записи, чтобы вы могли проверить их на опечатки. |

383| `blockedMarketplaces` | Отдельная неправильная запись удаляется и применяется действительное подмножество. Запись, которая анализируется, но никогда не может совпадать, такая как регулярное выражение `hostPattern`, которое не компилируется, сохраняется с предупреждением. Она ничего не блокирует, пока не будет исправлена, но [ограничения marketplace](/docs/ru/plugins/org#restrict-what-users-can-install) остаются активными. Полностью неправильное значение отбрасывается с предупреждением, так как блокирование каждого marketplace заблокировало бы источники, которые политика никогда не называла. |405| `enabledPlugins` | Неправильная запись отбрасывается с предупреждением и другие записи остаются применяемыми. Значение, которое не является картой ID плагинов или чья каждая запись неправильна, отбрасывается целиком с предупреждением. |

384| `sandbox.credentials` | Восстанавливаемая неправильная запись деградирует до `mode: "deny"` с предупреждением; невосстанавливаемая удаляется; действительные записи остаются применяемыми. См. [неправильные записи учетных данных](/docs/ru/settings-reference#invalid-credential-entries-in-managed-settings) |

385 406

386`allowedHttpHookUrls` и `httpHookAllowedEnvVars` объединяются в файлах параметров, поэтому записи в ваших пользовательских, проектных или локальных параметрах все еще применяются, пока управляемый список пуст.407`allowedHttpHookUrls` и `httpHookAllowedEnvVars` объединяются в файлах параметров, поэтому записи в ваших пользовательских, проектных или локальных параметрах все еще применяются, пока управляемый список пуст.

387 408

388Резервные значения для этих двух ключей и для `allowedChannelPlugins` требуют Claude Code v2.1.267 или позже; более ранние версии отбрасывают весь ключ, когда его значение или любая запись неправильна. Резервные значения для `strictKnownMarketplaces`, `blockedMarketplaces` и `disableSideloadFlags` требуют Claude Code v2.1.277 или позже; более ранние версии отбрасывают весь ключ, когда его значение или любая запись неправильна.409Резервные варианты для этих двух ключей и для `allowedChannelPlugins` требуют Claude Code v2.1.267 или позже; более ранние версии отбрасывают весь ключ, когда его значение или любая запись неправильна. Резервные варианты `strictKnownMarketplaces` и `blockedMarketplaces` требуют Claude Code v2.1.277 или позже; более ранние версии отбрасывают весь ключ, когда его значение или любая запись неправильна. Резервные варианты `strictPluginOnlyCustomization` и `enabledPlugins` требуют Claude Code v2.1.282 или позже.

410

411`requiredMinimumVersion` и `requiredMaximumVersion` не проходят открыто по замыслу: неправильное значение отбрасывается, а не применяется.

412

413Эта толерантность применяется только к управляемым параметрам. Файлы пользовательских, проектных и локальных параметров остаются строгими: файл, чья JSON или форма верхнего уровня не проходит проверку, отклоняется целиком и сообщается, и отдельная запись, которая не проходит, такая как неправильное правило разрешения, пропускается с предупреждением, пока остальная часть файла применяется.

414

415<h4 id="invalid-values-inside-sandbox">

416 Неправильные значения внутри `sandbox`

417</h4>

418

419Когда одно значение в вашем управляемом блоке `sandbox` неправильно, Claude Code не отбрасывает весь блок, потому что он проверяет каждое поле самостоятельно. Эта обработка по полям требует Claude Code v2.1.283 или позже. На версиях до v2.1.283 Claude Code отбрасывает каждое поле `sandbox`, кроме [`credentials`](/docs/ru/settings-reference#invalid-credential-entries-in-managed-settings), когда значение вне `credentials` неправильно.

389 420

390`requiredMinimumVersion` и `requiredMaximumVersion` не удаются открыто по замыслу: неправильное значение отбрасывается, а не применяется.421Предупреждение, которое вы получаете для неправильного поля, называет поле и говорит вам, что с ним происходит. Что происходит, зависит от того, что контролирует поле:

391 422

392Эта толерантность применяется только к управляемым параметрам. Файлы параметров пользователя, проекта и локального остаются строгими: файл, чья JSON или форма верхнего уровня не проходит проверку, отклоняется целиком и сообщается, и отдельная запись, которая не удается, такая как неправильное правило разрешения, пропускается с предупреждением, пока остальная часть файла применяется.423* Если вы установите логический ключ на кавычки `"true"` или `"false"`, значение считается этим логическим. Вместо предупреждения `/status` показывает уведомление, просящее вас удалить кавычки.

424* Если `failIfUnavailable` неправильно, Claude Code отбрасывает значение, а не рассматривает его как `true`, поэтому нечитаемое значение никогда не останавливает сеансы от запуска на всем вашем парке.

425* Claude Code рассматривает каждое другое неправильное логическое значение как значение, которое держит песочницу самой строгой до исправления. Ключ, который включает песочницу или одно из ее ограничений, такой как `enabled` или `network.allowManagedDomainsOnly`, считается `true`. Ключ, который ослабляет ее, такой как `allowUnsandboxedCommands`, считается `false`.

426* В списке вне `credentials`, такой как `excludedCommands` или `network.allowedDomains`, Claude Code отбрасывает неправильную запись и сохраняет остальную часть списка. Список, который не является массивом или не имеет допустимой записи, вообще не применяется.

427* Пока `network.deniedDomains` или любая запись в нем неправильна, Claude Code также удерживает `network.allowedDomains`, поэтому управляемый список разрешений ничего не предоставляет до исправления списка отрицания.

428* Пока `filesystem.denyRead`, `filesystem.denyWrite` или любая запись в любом из них неправильна, Claude Code также удерживает оба `filesystem.allowRead` и `filesystem.allowWrite` до исправления списка отрицания.

393 429

394<span id="managed-only-settings" />430<span id="managed-only-settings" />

395 431

401 437

402Большинство из них — это блокировки: значение, которое блокировка управляет, такое как правила разрешения или `sandbox.network.allowedDomains`, — это обычный ключ, который может установить любой уровень, и блокировка говорит Claude Code чтить только управляемое значение.438Большинство из них — это блокировки: значение, которое блокировка управляет, такое как правила разрешения или `sandbox.network.allowedDomains`, — это обычный ключ, который может установить любой уровень, и блокировка говорит Claude Code чтить только управляемое значение.

403 439

404Таблица охватывает элементы управления разрешением, плагином и доставкой. Для любого ключа, не указанного здесь, столбец Scope [справочника параметров](/docs/ru/settings-reference#all-settings) говорит, является ли он только управляемым; оставшиеся ключи только управляемые там включают URL входа шлюза, версию, браузер, мобильный симулятор, хост SSH, локальный сеанс Desktop, путь двоичного файла песочницы, ценообразование модели и элементы управления CLAUDE.md.440Таблица охватывает элементы управления разрешением, плагином и доставкой. Для любого ключа, не указанного здесь, столбец Scope [справочника параметров](/docs/ru/settings-reference#all-settings) говорит, является ли он только управляемым; оставшиеся ключи только управляемые там включают URL входа шлюза, версию, браузер, мобильный симулятор, хост SSH, локальный сеанс Desktop, путь двоичного файла песочницы, ценообразование модели, ограничение модели и элементы управления CLAUDE.md.

405 441

406| Параметр | Описание |442| Параметр | Описание |

407| :- | :- |443| :- | :- |

425| [`sandbox.network.allowManagedDomainsOnly`](/docs/ru/settings-reference#sandbox-network-allowmanageddomainsonly) | Чтите только управляемые `allowedDomains` и правила разрешения `WebFetch(domain:...)`; блокируйте другие домены без подсказки |461| [`sandbox.network.allowManagedDomainsOnly`](/docs/ru/settings-reference#sandbox-network-allowmanageddomainsonly) | Чтите только управляемые `allowedDomains` и правила разрешения `WebFetch(domain:...)`; блокируйте другие домены без подсказки |

426| [`strictKnownMarketplaces`](/docs/ru/settings-reference#strictknownmarketplaces) | Контролирует, какие источники маркетплейса плагинов пользователи могут добавлять и устанавливать плагины из. См. [управляемые ограничения маркетплейса](/docs/ru/plugins/org#restrict-what-users-can-install) |462| [`strictKnownMarketplaces`](/docs/ru/settings-reference#strictknownmarketplaces) | Контролирует, какие источники маркетплейса плагинов пользователи могут добавлять и устанавливать плагины из. См. [управляемые ограничения маркетплейса](/docs/ru/plugins/org#restrict-what-users-can-install) |

427| [`strictPluginOnlyCustomization`](/docs/ru/settings-reference#strictpluginonlycustomization) | Блокируйте skills, agents, hooks и MCP серверы из источников пользователя и проекта; `true` блокирует все четыре, массив называет, какие |463| [`strictPluginOnlyCustomization`](/docs/ru/settings-reference#strictpluginonlycustomization) | Блокируйте skills, agents, hooks и MCP серверы из источников пользователя и проекта; `true` блокирует все четыре, массив называет, какие |

428| [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) | Когда установлено в реестре HKLM или файле под `C:\Program Files\ClaudeCode`, имейте WSL читать цепь политики Windows и читайте `/etc/claude-code` только когда никакой файл управляемых параметров или drop-in под этим каталогом не доставляет [ключ политики](#how-claude-code-combines-managed-sources); запись дает порядок |464| [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) | Когда установлено в реестре HKLM или файле под `C:\Program Files\ClaudeCode`, имейте WSL читать цепь политики Windows и читайте `/etc/claude-code` только когда [нет документа администратора Windows](#present-admin-documents); запись дает порядок |

429 465

430<Note>466<Note>

431 На планах Team и Enterprise владелец включает или отключает [Remote Control](/docs/ru/remote-control) и [веб-сеансы](/docs/ru/claude-code-on-the-web) организацией в целом в [параметрах администратора Claude Code](https://claude.ai/admin-settings/claude-code). Remote Control может дополнительно быть отключен для каждого устройства с параметром [`disableRemoteControl`](/docs/ru/settings-reference#disableremotecontrol). Веб-сеансы не имеют ключа управляемых параметров для каждого устройства.467 На планах Team и Enterprise владелец включает или отключает [Remote Control](/docs/ru/remote-control) и [веб-сеансы](/docs/ru/claude-code-on-the-web) организацией в целом в [параметрах администратора Claude Code](https://claude.ai/admin-settings/claude-code). Remote Control может дополнительно быть отключен для каждого устройства с параметром [`disableRemoteControl`](/docs/ru/settings-reference#disableremotecontrol). Веб-сеансы не имеют ключа управляемых параметров для каждого устройства.

449 485

450Claude Code применяет значение `1` без показа пользователю [диалога одобрения](/docs/ru/server-managed-settings#environment-variables-and-the-approval-dialog).486Claude Code применяет значение `1` без показа пользователю [диалога одобрения](/docs/ru/server-managed-settings#environment-variables-and-the-approval-dialog).

451 487

452Если вы отключите телеметрию, Claude Code прекратит отправку данных об использовании, которые питают [панель аналитики](/docs/ru/analytics) вашей организации для разработчиков, которых достигает политика. Переменная также отключает получение флагов функций, что делает Remote Control, режим автоматического по умолчанию и другие [функции, которые нуждаются в получении флагов функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), недоступными для этих разработчиков.488Если вы отключите телеметрию, Claude Code прекратит отправку данных об использовании, которые питают [панель аналитики](/docs/ru/analytics) вашей организации для разработчиков, которых достигает политика. Переменная также отключает [получение флагов функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching) для этих разработчиков. Для Remote Control см. [требования Remote Control](/docs/ru/remote-control#requirements).

453 489

454[Где и когда политика применяется](#where-and-when-a-policy-applies) говорит, какой механизм доставки достигает каждую поверхность, и [Доступность платформы](/docs/ru/server-managed-settings#platform-availability) говорит, какие сеансы пропускают выборку управляемых параметров сервера.490[Где и когда политика применяется](#where-and-when-a-policy-applies) говорит, какой механизм доставки достигает каждую поверхность, и [Доступность платформы](/docs/ru/server-managed-settings#platform-availability) говорит, какие сеансы пропускают выборку управляемых параметров сервера.

455 491

mcp.md +258 −241

Details

65</Steps>65</Steps>

66 66

67<h2 id="installing-mcp-servers">67<h2 id="installing-mcp-servers">

~~68 Установка MCP servers~~68 Установка MCP серверов

69</h2>69</h2>

70 70

~~71MCP servers можно настроить несколькими способами в зависимости от ваших потребностей:~~71MCP серверы можно настроить несколькими способами в зависимости от ваших потребностей:

72 72

73<h3 id="option-1-add-a-remote-http-server">73<h3 id="option-1-add-a-remote-http-server">

~~74 Вариант 1: Добавьте удаленный HTTP server~~74 Вариант 1: Добавление удалённого HTTP сервера

75</h3>75</h3>

76 76

77HTTP servers — это рекомендуемый вариант для подключения к удаленным MCP servers. Это наиболее широко поддерживаемый транспорт для облачных сервисов.77HTTP серверы — это рекомендуемый вариант для подключения к удалённым MCP серверам. Это наиболее широко поддерживаемый транспорт для облачных сервисов.

78 78

79```bash theme={null}79```bash theme={null}

80# Базовый синтаксис80# Базовый синтаксис

88 --header "Authorization: Bearer your-token"88 --header "Authorization: Bearer your-token"

89```89```

90 90

91При настройке MCP servers через JSON в `.mcp.json`, `~/.claude.json` или `claude mcp add-json`, поле `type` принимает `streamable-http` как псевдоним для `http`. Спецификация MCP использует имя `streamable-http` для этого транспорта, поэтому конфигурации, скопированные из документации server, работают без изменений.91При настройке MCP серверов через JSON в `.mcp.json`, `~/.claude.json` или `claude mcp add-json`, поле `type` принимает `streamable-http` как псевдоним для `http`. Спецификация MCP использует имя `streamable-http` для этого транспорта, поэтому конфигурации, скопированные из документации сервера, работают без изменений.

92 92

93Запись JSON, которая имеет `url`, но не имеет `type`, является ошибкой конфигурации, потому что Claude Code читает запись без `type` как stdio server. Claude Code пропускает этот server и сообщает `MCP server "<name>" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry`. До версии 2.1.202 Claude Code сообщал об этой неправильной конфигурации как `command: expected string, received undefined`.93Запись JSON, которая имеет `url` но не имеет `type`, является ошибкой конфигурации, потому что Claude Code читает запись без `type` как stdio сервер. Claude Code пропускает этот сервер и сообщает `MCP server "<name>" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry`. До версии v2.1.202 Claude Code сообщал об этой неправильной конфигурации как `command: expected string, received undefined`.

94 94

95В запусках `--output-format stream-json` Claude Code также сообщает о пропущенной записи `--mcp-config` в поле [`mcp_server_errors`](/docs/ru/headless#stream-responses) события `system/init`, поэтому скрипты могут обнаружить, что server никогда не загружался. Это требует Claude Code версии 2.1.219 или позже.95Только приложение-хост SDK, такое как приложение [Agent SDK](/docs/ru/agent-sdk/mcp) или [настольное приложение](/docs/ru/desktop), может зарегистрировать встроенный сервер `"type": "sdk"`. Claude Code пропускает запись `"type": "sdk"` в `.mcp.json`, `~/.claude.json` или параметрах и сообщает `Skipped — MCP server "<name>" declares type "sdk", which only an SDK host application can register`.

97В запусках `--output-format stream-json` Claude Code также сообщает о пропущенной записи `--mcp-config` в поле [`mcp_server_errors`](/docs/ru/headless#stream-responses) события `system/init`, поэтому скрипты могут обнаружить, что сервер никогда не загружался. Это требует Claude Code v2.1.219 или позже.

96 98

97<h3 id="option-2-add-a-remote-sse-server">99<h3 id="option-2-add-a-remote-sse-server">

~~98 Вариант 2: Добавьте удаленный SSE server~~100 Вариант 2: Добавление удалённого SSE сервера

99</h3>101</h3>

100 102

101<Warning>103<Warning>

102 Транспорт SSE (Server-Sent Events) устарел. Используйте вместо этого HTTP servers, где они доступны.104 Транспорт SSE (Server-Sent Events) устарел. Используйте HTTP серверы вместо этого, где они доступны.

103</Warning>105</Warning>

104 106

105Некоторые сервисы по-прежнему предоставляют только SSE endpoint. Добавьте их с помощью той же команды `claude mcp add --transport http <name> <url>`, что и [HTTP server](#option-1-add-a-remote-http-server). Claude Code сначала пытается использовать HTTP транспорт и переключается на SSE, когда server его не принимает. Автоматическое переключение требует Claude Code версии 2.1.265 или позже.107Некоторые сервисы по-прежнему предоставляют только SSE конечную точку. Добавляйте их с той же командой `claude mcp add --transport http <name> <url>`, что и [HTTP сервер](#option-1-add-a-remote-http-server). Claude Code сначала пробует HTTP транспорт и переключается на SSE, когда сервер его не принимает. Автоматическое переключение требует Claude Code v2.1.265 или позже.

106 108

107На более ранней версии или для прямого подключения через SSE передайте `--transport sse` вместо этого:109На более ранней версии или для прямого подключения через SSE передайте `--transport sse` вместо этого:

108 110

119```121```

120 122

121<h3 id="option-3-add-a-local-stdio-server">123<h3 id="option-3-add-a-local-stdio-server">

122 Вариант 3: Добавьте локальный stdio server124 Вариант 3: Добавление локального stdio сервера

123</h3>125</h3>

124 126

125Stdio servers работают как локальные процессы на вашей машине. Они идеальны для инструментов, которым требуется прямой доступ к системе или пользовательские скрипты.127Stdio серверы работают как локальные процессы на вашей машине. Они идеальны для инструментов, которым нужен прямой доступ к системе или пользовательские скрипты.

126 128

127Claude Code устанавливает `CLAUDE_PROJECT_DIR` в окружение порожденного server в корень проекта, поэтому ваш server может разрешать пути относительно проекта без зависимости от рабочей директории. Это та же директория, которую hooks получают в своей переменной `CLAUDE_PROJECT_DIR`. Прочитайте ее изнутри вашего процесса server, например `process.env.CLAUDE_PROJECT_DIR` в Node или `os.environ["CLAUDE_PROJECT_DIR"]` в Python.129Claude Code устанавливает `CLAUDE_PROJECT_DIR` в окружение порождённого сервера в корень проекта, поэтому ваш сервер может разрешать пути относительно проекта без зависимости от рабочей директории. Это та же директория, которую hooks получают в своей переменной `CLAUDE_PROJECT_DIR`. Читайте её изнутри процесса вашего сервера, например `process.env.CLAUDE_PROJECT_DIR` в Node или `os.environ["CLAUDE_PROJECT_DIR"]` в Python.

128 130

129`CLAUDE_PROJECT_DIR` — это стабильный корень проекта и не изменяется при добавлении или удалении рабочих директорий во время сеанса. Server, который ограничивает собственный доступ к файловой системе набором разрешенных директорий, должен вместо этого реализовать MCP запрос `roots/list`. Claude Code отвечает на `roots/list` с директорией запуска сеанса плюс каждая [дополнительная рабочая директория](/docs/ru/permissions#working-directories), которую вы предоставили с помощью `--add-dir`, `/add-dir` или параметра `additionalDirectories`. Claude Code отправляет `notifications/roots/list_changed` при изменении этого набора. До версии 2.1.203 `roots/list` возвращал только директорию запуска и Claude Code не отправлял `notifications/roots/list_changed`.131`CLAUDE_PROJECT_DIR` — это стабильный корень проекта и не меняется, когда вы добавляете или удаляете рабочие директории во время сеанса. Сервер, который ограничивает свой собственный доступ к файловой системе набором разрешённых директорий, должен вместо этого реализовать MCP запрос `roots/list`. Claude Code отвечает на `roots/list` с директорией запуска сеанса плюс каждая [дополнительная рабочая директория](/docs/ru/permissions#working-directories), которую вы предоставили с `--add-dir`, `/add-dir` или параметром `additionalDirectories`. Claude Code отправляет `notifications/roots/list_changed`, когда этот набор меняется. До версии v2.1.203 `roots/list` возвращал только директорию запуска и Claude Code не отправлял `notifications/roots/list_changed`.

130 132

131Эта переменная устанавливается в окружение server, а не в собственное окружение Claude Code, поэтому ссылка на нее через расширение `${VAR}` в `command` или `args` записи `.mcp.json` с областью действия проекта или записи server с локальной или пользовательской областью действия в `~/.claude.json` требует значения по умолчанию, такого как `${CLAUDE_PROJECT_DIR:-.}`. Конфигурации MCP, предоставляемые плагинами, подставляют `${CLAUDE_PROJECT_DIR}` напрямую и не требуют значения по умолчанию.133Эта переменная устанавливается в окружение сервера, а не в собственное окружение Claude Code, поэтому ссылка на неё через расширение `${VAR}` в `command` или `args` записи `.mcp.json` с областью проекта или локальной или пользовательской записи сервера в `~/.claude.json` требует значения по умолчанию, такого как `${CLAUDE_PROJECT_DIR:-.}`. Конфигурации MCP, предоставляемые плагинами, подставляют `${CLAUDE_PROJECT_DIR}` напрямую и не нуждаются в значении по умолчанию.

132 134

133```bash theme={null}135```bash theme={null}

134# Базовый синтаксис136# Базовый синтаксис

135claude mcp add [options] <name> -- <command> [args...]137claude mcp add [options] <name> -- <command> [args...]

136 138

137# Реальный пример: добавление Airtable server139# Реальный пример: добавление сервера Airtable

138claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \140claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \

139 -- npx -y airtable-mcp-server141 -- npx -y airtable-mcp-server

140```142```

141 143

142<Note>144<Note>

~~143 **Важно: разделение аргументов server с помощью `--`**~~145 **Важно: разделяйте аргументы сервера с помощью `--`**

144 146

145 Для stdio servers `--` (двойной дефис) разделяет собственные опции Claude, такие как `--transport`, `--env` и `--scope`, от команды и аргументов, которые запускают server. Все, что идет после `--`, передается server без изменений.147 Для stdio серверов `--` (двойной дефис) разделяет собственные опции Claude, такие как `--transport`, `--env` и `--scope`, от команды и аргументов, которые запускают сервер. Всё после `--` передаётся серверу без изменений.

146 148

147 Например:149 Например:

148 150

149 * `claude mcp add --transport stdio myserver -- npx server` → запускает `npx server`151 * `claude mcp add --transport stdio myserver -- npx server` → запускает `npx server`

150 * `claude mcp add --env KEY=value --transport stdio myserver -- python server.py --port 8080` → запускает `python server.py --port 8080` с `KEY=value` в окружении152 * `claude mcp add --env KEY=value --transport stdio myserver -- python server.py --port 8080` → запускает `python server.py --port 8080` с `KEY=value` в окружении

151 153

152 Без `--` Claude Code попытался бы разобрать флаги server, такие как `--port` выше, как свои собственные опции.154 Без `--` Claude Code попытался бы разобрать флаги сервера, такие как `--port` выше, как свои собственные опции.

153 155

154 `--env` принимает несколько пар `KEY=value`. Если имя server идет сразу после `--env`, CLI читает имя как еще одну пару и отклоняет его, поэтому поместите хотя бы одну другую опцию, такую как `--transport stdio`, между `--env` и именем server.156 `--env` принимает несколько пар `KEY=value`. Если имя сервера идёт сразу после `--env`, CLI читает имя как другую пару и отклоняет её, поэтому поместите хотя бы одну другую опцию, такую как `--transport stdio`, между `--env` и именем сервера.

155</Note>157</Note>

156 158

157<h3 id="option-4-add-a-remote-websocket-server">159<h3 id="option-4-add-a-remote-websocket-server">

158 Вариант 4: Добавьте удаленный WebSocket server160 Вариант 4: Добавление удалённого WebSocket сервера

159</h3>161</h3>

160 162

161WebSocket servers поддерживают постоянное двусторонее соединение, которое подходит для удаленных MCP servers, которые отправляют события в Claude без запроса. Используйте HTTP вместо этого, когда ваш server только отвечает на запросы, так как HTTP поддерживает OAuth и флаг `claude mcp add --transport`, в то время как WebSocket не поддерживает ни то, ни другое.163WebSocket серверы поддерживают постоянное двусторонее соединение, которое подходит для удалённых MCP серверов, которые отправляют события Claude без запроса. Используйте HTTP вместо этого, когда ваш сервер только отвечает на запросы, так как HTTP поддерживает OAuth и флаг `claude mcp add --transport`, в то время как WebSocket не поддерживает ни то, ни другое.

162 164

163Настройте WebSocket servers в `.mcp.json` или с помощью `claude mcp add-json`:165Настраивайте WebSocket серверы в `.mcp.json` или с помощью `claude mcp add-json`:

164 166

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

166claude mcp add-json events-server \168claude mcp add-json events-server \

170Запись `type: "ws"` принимает те же поля `url`, `headers`, `headersHelper`, `timeout` и `alwaysLoad`, что и `http`. Аутентификация только через заголовки, поэтому передайте статический токен в `headers` или сгенерируйте его во время подключения с помощью [`headersHelper`](#use-dynamic-headers-for-custom-authentication). Флаг `claude mcp add --transport` не принимает `ws`.172Запись `type: "ws"` принимает те же поля `url`, `headers`, `headersHelper`, `timeout` и `alwaysLoad`, что и `http`. Аутентификация только через заголовки, поэтому передайте статический токен в `headers` или сгенерируйте его во время подключения с помощью [`headersHelper`](#use-dynamic-headers-for-custom-authentication). Флаг `claude mcp add --transport` не принимает `ws`.

171 173

172<h3 id="add-a-server-from-setup-instructions-written-for-another-client">174<h3 id="add-a-server-from-setup-instructions-written-for-another-client">

173 Добавьте server из инструкций по настройке, написанных для другого клиента175 Добавление сервера из инструкций по настройке, написанных для другого клиента

174</h3>176</h3>

175 177

176MCP servers не специфичны для Claude Code, поэтому инструкции по настройке server могут быть написаны для Claude Desktop, Cursor или другого MCP клиента и не содержать команду `claude mcp add`. Чтобы добавить server в любом случае, посмотрите в этих инструкциях одно из этих трех:178MCP серверы не специфичны для Claude Code, поэтому инструкции по настройке сервера могут быть написаны для Claude Desktop, Cursor или другого MCP клиента и не давать команду `claude mcp add`. Чтобы добавить сервер в любом случае, ищите в этих инструкциях URL, команду запуска или блок JSON:

177 179

178* **URL**, такой как `https://mcp.example.com/mcp`: server удален.180* **URL** такой как `https://mcp.example.com/mcp`: сервер удалённый.

179* **Команда запуска**, такая как `npx -y @example/mcp-server`: server работает на вашей машине.181* **Команда запуска** такая как `npx -y @example/mcp-server`: сервер работает на вашей машине.

180* **Блок JSON `mcpServers`**: конфигурация, написанная для файла параметров другого клиента.182* **Блок JSON `mcpServers`**: конфигурация, написанная для файла параметров другого клиента.

181 183

182Каждый из них является одним из входов, которые четыре варианта в [Установка MCP servers](#installing-mcp-servers) принимают. Найдите форму, которую вы имеете ниже, чтобы превратить ее в команду, которую Claude Code принимает. Каждая команда записывает в [локальную область](#local-scope), если вы не добавите `--scope project` или `--scope user`.184Каждый из них — один из входов, которые принимают четыре варианта в [Установка MCP серверов](#installing-mcp-servers). Найдите форму, которую вы имеете ниже, чтобы превратить её в команду, которую принимает Claude Code. Каждая команда записывает в [локальную область](#local-scope), если вы не добавите `--scope project` или `--scope user`.

183 185

184<h4 id="from-a-url">186<h4 id="from-a-url">

185 Из URL187 Из URL

186</h4>188</h4>

187 189

188URL означает, что server удален. Для endpoint `https://`, добавьте его с помощью `--transport http`, или следуйте [Вариант 2](#option-2-add-a-remote-sse-server), когда инструкции говорят, что endpoint использует SSE. Для endpoint `wss://`, используйте [Вариант 4](#option-4-add-a-remote-websocket-server) вместо этого, так как `--transport` не принимает `ws`:190URL означает, что сервер удалённый. Для конечной точки `https://`, добавьте её с `--transport http` или следуйте [Варианту 2](#option-2-add-a-remote-sse-server), когда инструкции говорят, что конечная точка использует SSE. Для конечной точки `wss://` используйте вместо этого [Вариант 4](#option-4-add-a-remote-websocket-server), так как `--transport` не принимает `ws`:

189 191

190```bash theme={null}192```bash theme={null}

191claude mcp add --transport http example https://mcp.example.com/mcp193claude mcp add --transport http example https://mcp.example.com/mcp

192```194```

193 195

194Если инструкции также дают API ключ или заголовок токена, передайте его с помощью `--header`, как показано в [Вариант 1](#option-1-add-a-remote-http-server).196Если инструкции также дают ключ API или заголовок токена, передайте его с `--header`, как показано в [Варианте 1](#option-1-add-a-remote-http-server).

195 197

196<h4 id="from-an-npx-uvx-or-binary-command">198<h4 id="from-an-npx-uvx-or-binary-command">

197 Из команды `npx`, `uvx` или binary199 Из команды `npx`, `uvx` или двоичного файла

198</h4>200</h4>

199 201

200Команда запуска означает, что server работает как локальный stdio процесс. Поместите всю команду после `--`, чтобы Claude Code передал флаги, такие как `-y`, команде, которая запускает server, вместо того чтобы читать их как свои собственные опции. Передайте любые переменные окружения, которые инструкции просят, с помощью `--env`, после имени server и перед `--`:202Команда запуска означает, что сервер работает как локальный stdio процесс. Поместите всю команду после `--`, чтобы Claude Code передал флаги, такие как `-y`, команде, которая запускает сервер, вместо того чтобы читать их как свои собственные опции. Передайте любые переменные окружения, которые инструкции требуют, с `--env`, после имени сервера и перед `--`:

201 203

202```bash theme={null}204```bash theme={null}

203claude mcp add example --env API_KEY=your-key -- npx -y @example/mcp-server205claude mcp add example --env API_KEY=your-key -- npx -y @example/mcp-server

209 Из блока JSON `mcpServers`211 Из блока JSON `mcpServers`

210</h4>212</h4>

211 213

212Блок `mcpServers`, написанный для другого MCP клиента, такого как Claude Desktop, использует ключ-обертку и форму записи, которую Claude Code читает. Передайте `claude mcp add-json` объект внутри `mcpServers`, а не обертку. Две записи нуждаются в исправлении сначала:214Блок `mcpServers`, написанный для другого MCP клиента, такого как Claude Desktop, использует ключ обёртки и форму записи, которую читает Claude Code. Передайте `claude mcp add-json` объект внутри `mcpServers`, а не обёртку. Две записи нуждаются в исправлении сначала:

213 215

214* **`url` без `type`**: добавьте `"type": "http"`, `"type": "sse"` или `"type": "ws"` для соответствия endpoint. Claude Code читает запись без `type` как stdio server, поэтому запись `url` без `type` не работает.216* **`url` без `type`**: добавьте `"type": "http"`, `"type": "sse"` или `"type": "ws"` для соответствия конечной точке. Claude Code читает запись без `type` как stdio сервер, поэтому запись `url` без `type` не работает.

215* **Ключ с символами, отличными от букв, цифр, дефисов и подчеркиваний**: выберите имя server, которое использует только эти символы. В противном случае ключ является именем server.217* **Ключ с символами, отличными от букв, цифр, дефисов и подчёркиваний**: выберите имя сервера, которое использует только эти символы. В противном случае ключ — это имя сервера.

216 218

217Например, этот блок:219Например, этот блок:

218 220

233claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}'235claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}'

234```236```

235 237

236[Добавьте MCP servers из конфигурации JSON](#add-mcp-servers-from-json-configuration) охватывает экранирование shell и флаг `--scope` для `add-json`. Чтобы поделиться server с вашей командой вместо этого, добавьте `--scope project`, или добавьте запись под `mcpServers` в `.mcp.json` в корне вашего проекта и зафиксируйте ее. [Область действия проекта](#project-scope) охватывает, как Claude Code загружает и одобряет этот файл.238[Добавление MCP серверов из конфигурации JSON](#add-mcp-servers-from-json-configuration) охватывает экранирование оболочки и флаг `--scope` для `add-json`. Чтобы поделиться сервером с вашей командой вместо этого, добавьте `--scope project` или добавьте запись под `mcpServers` в `.mcp.json` в корне вашего проекта и зафиксируйте её. [Область проекта](#project-scope) охватывает, как Claude Code загружает и одобряет этот файл.

237 239

238Каждая команда `claude mcp add` и `claude mcp add-json` выводит строку `Added ...`. Чтобы проверить, что Claude Code подключился, запустите `claude mcp get <name>`; [Статус server](#server-status) охватывает статусы, которые он показывает, и шаг одобрения для servers `.mcp.json`.240Каждая команда `claude mcp add` и `claude mcp add-json` выводит строку `Added ...`. Чтобы проверить, что Claude Code подключился, запустите `claude mcp get <name>`; [Статус сервера](#server-status) охватывает статусы, которые он показывает, и шаг одобрения для серверов `.mcp.json`.

239 241

240<h3 id="managing-your-servers">242<h3 id="managing-your-servers">

241 Управление вашими servers243 Управление вашими серверами

242</h3>244</h3>

243 245

244После настройки вы можете управлять своими MCP servers с помощью этих команд:246После настройки вы можете управлять вашими MCP серверами с помощью этих команд:

245 247

246```bash theme={null}248```bash theme={null}

247# Список всех настроенных servers249# Список всех настроенных серверов

248claude mcp list250claude mcp list

249 251

250# Получить детали для конкретного server252# Получить детали для конкретного сервера

251claude mcp get notion253claude mcp get notion

252 254

253# Удалить server255# Удалить сервер

254claude mcp remove notion256claude mcp remove notion

255 257

256# (в Claude Code) Проверить статус server258# (внутри Claude Code) Проверить статус сервера

257/mcp259/mcp

258```260```

259 261

260Когда вы удаляете удаленный server, Claude Code также удаляет OAuth токены и регистрацию клиента, которые он хранил для этого server.262Когда вы удаляете удалённый сервер, Claude Code также удаляет токены OAuth и регистрацию клиента, которые он хранил для этого сервера.

261 263

262<h4 id="server-status">264<h4 id="server-status">

263 Статус server265 Статус сервера

264</h4>266</h4>

265 267

266`claude mcp add` подтверждает успешное добавление, выводя строку `Added ...`, что означает, что конфигурация была записана. `claude mcp list` затем показывает статус здоровья рядом с каждым server, который он перечисляет, такой как `✔ Connected`, `! Needs authentication` или `✘ Failed to connect`. Статус отказа означает, что Claude Code не мог подключиться к этому server, а не то, что команда list не удалась.268`claude mcp add` подтверждает успешное добавление, выводя строку `Added ...`, что означает, что конфигурация была записана. `claude mcp list` затем показывает статус здоровья рядом с каждым сервером, который он перечисляет, такой как `✔ Connected`, `! Needs authentication` или `✘ Failed to connect`. Статус отказа означает, что Claude Code не смог подключиться к этому серверу, а не то, что команда list не удалась.

267 269

268Статусы в этом списке сообщают о решении конфигурации, а не о попытке подключения, поэтому Claude Code выводит их без подключения к server:270Статусы в этом списке сообщают о решении конфигурации, а не о попытке подключения, поэтому Claude Code выводит их без подключения к серверу:

269 271

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

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

272* `⊘ Disabled for this project (re-enable via /mcp)`: server, который список [`disabledMcpServers`](#disable-a-server-without-removing-it) проекта называет. Claude Code показывает его как в `claude mcp list`, так и в `claude mcp get <name>`. Включите server обратно из панели `/mcp`. До версии 2.1.238 обе команды подключались к отключенному server для проверки здоровья и сообщали результат подключения.274* `⊘ 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`. До версии v2.1.238 обе команды подключались к отключённому серверу для проверки здоровья и сообщали результат подключения.

273 275

274WebSocket servers не отображаются в выводе `claude mcp list`. Используйте `claude mcp get <name>` или панель `/mcp` для их проверки.276WebSocket серверы не появляются в выводе `claude mcp list`. Используйте `claude mcp get <name>` или панель `/mcp` для их проверки.

275 277

276<h4 id="project-server-approvals-and-workspace-trust">278<h4 id="project-server-approvals-and-workspace-trust">

277 Одобрения servers проекта и доверие рабочей области279 Одобрения серверов проекта и доверие рабочей области

278</h4>280</h4>

279 281

280Начиная с версии 2.1.196, `claude mcp list` и `claude mcp get` читают одобрения `.mcp.json` только из файлов параметров, которые не проверены в репозитории, пока вы не доверите рабочей области, запустив `claude` в ней и приняв диалог доверия рабочей области. Клонированный репозиторий не может одобрить свои собственные servers: [`enableAllProjectMcpServers`](/docs/ru/settings-reference#enableallprojectmcpservers) или [`enabledMcpjsonServers`](/docs/ru/settings-reference#enabledmcpjsonservers), зафиксированные в `.claude/settings.json` проекта, игнорируются в недоверенной папке, и server остается в состоянии `⏸ Pending approval` вместо подключения и проверки здоровья.282Начиная с версии v2.1.196, `claude mcp list` и `claude mcp get` читают одобрения `.mcp.json` только из файлов параметров, которые не зафиксированы в репозитории, пока вы не доверите рабочей области, запустив `claude` в ней и приняв диалог доверия рабочей области. Клонированный репозиторий не может одобрить свои собственные серверы: [`enableAllProjectMcpServers`](/docs/ru/settings-reference#enableallprojectmcpservers) или [`enabledMcpjsonServers`](/docs/ru/settings-reference#enabledmcpjsonservers), зафиксированные в `.claude/settings.json` проекта, игнорируются в недоверенной папке, и сервер остаётся в `⏸ Pending approval` вместо подключения и проверки здоровья.

281 283

282Одобрения из этих источников все еще применяются в недоверенной папке:284Одобрения из этих источников по-прежнему применяются в недоверенной папке:

283 285

284* ваш пользовательский `~/.claude/settings.json`286* ваш пользовательский `~/.claude/settings.json`

285* управляемые параметры287* управляемые параметры

286* параметры, переданные с помощью `--settings`288* параметры, переданные с `--settings`

287 289

288Claude Code также применяет одобрения из неотслеживаемого `.claude/settings.local.json`, но он запускает git для проверки того, отслеживается ли файл, и выполняет эту проверку только в [доверенной папке](/docs/ru/permissions#project-allow-rules-and-workspace-trust). В папке, которой вы никогда не доверяли, Claude Code ждет диалога доверия перед применением одобрений файла, если только папка не является вашей конфигурационной домашней директорией: вашей домашней директорией или директорией, чей `.claude` вы установили как [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars). До версии 2.1.207 Claude Code применял одобрения из неотслеживаемого `.claude/settings.local.json` даже в папке, которой вы никогда не доверяли.290Claude Code также применяет одобрения из отслеживаемого `.claude/settings.local.json`, но он запускает git для проверки, отслеживается ли файл, и запускает эту проверку только в [доверенной папке](/docs/ru/permissions#project-allow-rules-and-workspace-trust). В папке, которую вы никогда не доверяли, Claude Code ждёт диалога доверия перед применением одобрений файла, если только папка не является вашей конфигурационной домашней директорией: вашей домашней директорией или директорией, чей `.claude` вы установили как [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars). До версии v2.1.207 Claude Code применял одобрения из отслеживаемого `.claude/settings.local.json` даже в папке, которую вы никогда не доверяли.

289 291

290Запись `disabledMcpjsonServers` в любом файле параметров все еще отклоняет server.292Запись `disabledMcpjsonServers` в любом файле параметров по-прежнему отклоняет сервер.

291 293

292<h4 id="server-status-detail">294<h4 id="server-status-detail">

293 Деталь статуса server295 Деталь статуса сервера

294</h4>296</h4>

295 297

296В `/mcp`, включая меню server там, и в [менеджере `/plugin`](/docs/ru/plugins/install), удаленный HTTP или SSE server, который вы использовали раньше, может показать статус `cached`, такой как `cached 2h ago · connects on first use · 5 tools`. Claude Code загрузил список инструментов server из своего кэша обнаружения, сохраненного в предыдущем сеансе, вместо подключения при запуске, и Claude Code подключает server в первый раз, когда Claude вызывает один из инструментов server. Инструменты доступны с вашего первого сообщения, поэтому вам не нужно ничего делать. Кэш обнаружения и его статус `cached` требуют Claude Code версии 2.1.221 или позже.298В `/mcp`, включая меню сервера там, и в [менеджере](/docs/ru/plugins/install) `/plugin`, удалённый HTTP или SSE сервер, который вы использовали раньше, может показать статус `cached` такой как `cached 2h ago · connects on first use · 5 tools`. Claude Code загрузил список инструментов сервера из своего кэша обнаружения, сохранённого в предыдущем сеансе, вместо подключения при запуске, и Claude Code подключает сервер в первый раз, когда Claude вызывает один из инструментов сервера. Инструменты доступны с вашего первого сообщения, поэтому вам не нужно ничего делать. Кэш обнаружения и его статус `cached` требуют Claude Code v2.1.221 или позже.

~~297~~

298Кэш обнаружения отключен по умолчанию, если постепенный rollout не включил его для вашей учетной записи. Установите [`MCP_DISCOVERY_CACHE=1`](/docs/ru/env-vars) для его включения или `0` для его отключения, даже если rollout включил его. До версии 2.1.238 кэш был включен по умолчанию.

299 299

300Два действия в меню server в `/mcp` также влияют на запись кэша этого server:300Кэш обнаружения отключён по умолчанию, если постепенное развёртывание не включило его для вашей учётной записи. Установите [`MCP_DISCOVERY_CACHE=1`](/docs/ru/env-vars) для его включения или `0` для его отключения, даже если развёртывание включило его. До версии v2.1.238 кэш был включён по умолчанию.

301 301

302* **Reconnect**: на `cached` server Claude Code подключает его сейчас, а не при его первом вызове инструмента, и сохраняет запись. На подключенном или неудачном server Claude Code переподключает его и также отбрасывает запись.302Когда вы выбираете **Disable** или **Clear authentication** из меню сервера в `/mcp`, Claude Code также отбрасывает запись кэша этого сервера. **Reconnect** отбрасывает её тоже на подключённом или неудачном сервере; на сервере `cached` **Reconnect** подключает сервер сейчас и сохраняет запись. В следующий раз, когда Claude Code подключится к серверу после отбрасывания записи, он получит список инструментов с сервера вместо кэша.

303* **Clear authentication**: Claude Code отзывает аутентификацию server и также отбрасывает запись.

304 303

305После отбрасывания записи Claude Code получает список инструментов server из server вместо кэша.304Когда статус сервера `✘ Failed to connect`, `claude mcp list` добавляет деталь отказа к этой строке статуса, и `claude mcp get <name>` показывает её на строке `Issue:`: HTTP статус или код ошибки, плюс любой текст ошибки, который вернул сервер. Представление деталей сервера в `/mcp` включает тот же текст, сообщённый сервером, в его строку `Issue:`. Claude Code редактирует текст, похожий на учётные данные, из этой детали и никогда не включает развёрнутый URL сервера, который может нести секреты. Claude Code не добавляет деталь к статусу `✘ Connection error`, потому что текст исключения, который он выводил бы там, может встроить этот URL. До версии v2.1.219 обе команды показывали только голый статус отказа, без кода статуса или текста ошибки сервера.

306 305

307Когда статус server — `✘ Failed to connect`, `claude mcp list` добавляет деталь отказа к этой строке статуса, и `claude mcp get <name>` показывает ее на строке `Issue:`: HTTP статус или код ошибки, плюс любой текст ошибки, который server вернул. Представление деталей server в `/mcp` включает тот же текст, сообщенный server, в его строке `Issue:`. Claude Code редактирует текст, похожий на учетные данные, из этой детали и никогда не включает развернутый URL server, который может содержать секреты. Claude Code не добавляет деталь к статусу `✘ Connection error`, потому что текст исключения, который он выводил бы там, может встроить этот URL. До версии 2.1.219 обе команды показывали только статус отказа, без кода статуса или текста ошибки server.306Когда вы завершаете аутентификацию из `/mcp` и подключение по-прежнему не удаётся с HTTP статусом или кодом ошибки транспорта, Claude Code добавляет этот код и источник URL сервера к сообщению, которое он выводит после попытки. Источник — это схема и хост, плюс порт, когда URL называет один, такой как `https://mcp.example.com`.

~~308~~

309Когда вы завершаете аутентификацию из `/mcp` и подключение все еще не удается с HTTP статусом или кодом ошибки транспорта, Claude Code добавляет этот код и источник URL server к сообщению, которое он выводит после попытки. Источник — это схема и хост, плюс порт, когда URL называет один, такой как `https://mcp.example.com`.

310 307

311* Путь и запрос никогда не появляются в этом сообщении.308* Путь и запрос никогда не появляются в этом сообщении.

312* Для server в локальной, проектной или пользовательской [области](#mcp-installation-scopes) или в управляемой конфигурации MCP источник показывает хост, как написано в этой конфигурации, поэтому ссылка `${VAR}` в хосте не развернута в сообщении.309* Для сервера в локальной, проектной или пользовательской [области](#mcp-installation-scopes) или в управляемой конфигурации MCP источник показывает хост, как написано в этой конфигурации, поэтому ссылка `${VAR}` в хосте не развёрнута в сообщении.

313* Для отказа без статуса или кода ошибки Claude Code показывает текст ошибки без источника.310* Для отказа без статуса или кода ошибки Claude Code показывает текст ошибки без источника.

314 311

315Удаленный server, конфигурация которого имеет пустой `url`, отображается как `not configured` в `/mcp`, в `claude mcp list` и в [менеджере `/plugin`](/docs/ru/plugins/install), и Claude Code не пытается подключиться к нему. Плагин может включать запись-заполнитель, подобную этой, для коннектора, который вы настроите позже, поэтому Claude Code не сообщает об этом как об ошибке или проблеме настройки. Представление деталей server в `/mcp` читает `No URL configured for this server`; установите `url` записи для подключения. До версии 2.1.208 Claude Code сообщал об пустом `url` как о проблеме конфигурации с подсказкой переподключиться.312Удалённый сервер, чья конфигурация имеет пустой `url`, показывается как `not configured` в `/mcp`, в `claude mcp list` и в [менеджере](/docs/ru/plugins/install) `/plugin`, и Claude Code не пытается подключиться к нему. Плагин может включить запись-заполнитель, подобную этой, для соединителя, который вы настраиваете позже, поэтому Claude Code не сообщает об этом как об ошибке или проблеме настройки. Представление деталей сервера в `/mcp` читает `No URL configured for this server`; установите `url` записи для подключения к нему. До версии v2.1.208 Claude Code сообщал о пустом `url` как о проблеме конфигурации с подсказкой переподключиться.

316 313

317<h4 id="configuration-warnings">314<h4 id="configuration-warnings">

318 Предупреждения конфигурации315 Предупреждения конфигурации

320 317

321Claude Code предупреждает о проблемах конфигурации ниже. Каждая запись говорит, что Claude Code проверяет и как очистить предупреждение:318Claude Code предупреждает о проблемах конфигурации ниже. Каждая запись говорит, что Claude Code проверяет и как очистить предупреждение:

322 319

323* **Скрытое пробельное пространство**: Claude Code предупреждает, когда значение конфигурации MCP содержит скрытое ведущее или конечное пробельное пространство, которое часто поступает из вставки токена с конечным переводом строки. Claude Code проверяет `command`, `url`, каждую запись `args` и значения и имена ключей под `env` и `headers`. Claude Code показывает предупреждение в выводе `claude mcp list` и в `/mcp`, называя затронутые поля без повторения их значений, например `Leading or trailing whitespace in: headers.Authorization`. Claude Code не обрезает пробельное пространство и использует значения точно так, как написано, поэтому отредактируйте конфигурацию, чтобы удалить его.320* **Скрытое пробельное пространство**: Claude Code предупреждает, когда значение конфигурации MCP несёт скрытое ведущее или конечное пробельное пространство, которое часто происходит из вставки токена с конечным переводом строки. Claude Code проверяет `command`, `url`, каждую запись `args` и значения и имена ключей под `env` и `headers`. Claude Code показывает предупреждение в выводе `claude mcp list` и в `/mcp`, называя затронутые поля без повторения их значений, например `Leading or trailing whitespace in: headers.Authorization`. Claude Code не обрезает пробельное пространство и использует значения точно так, как написано, поэтому отредактируйте конфигурацию, чтобы удалить его.

324* **Одно имя в более чем одной области**: если вы определяете одно имя server в более чем одной [области](#mcp-installation-scopes) с разными endpoint, Claude Code предупреждает о конфликте в выводе `claude mcp list` и в `/mcp`. Claude Code хранит OAuth входы для каждого endpoint, поэтому когда вы аутентифицируете определение, которое загружается в одном проекте, вам все еще нужно войти отдельно в проекте, где загружается другое определение. Сохраните endpoint, который вы хотите, и удалите остальные с помощью `claude mcp remove <name> --scope <scope>`. В предупреждении Claude Code цитирует endpoint каждой области, как написано в вашей конфигурации, с неразвернутыми ссылками [`${VAR}`](#environment-variable-expansion-in-mcp-json), поэтому он никогда не показывает разрешенное значение, такое как API ключ.321* **Одно имя в более чем одной области**: если вы определяете одно имя сервера в более чем одной [области](#mcp-installation-scopes) с разными конечными точками, Claude Code предупреждает о конфликте в выводе `claude mcp list` и в `/mcp`. Claude Code хранит входы OAuth для каждой конечной точки, поэтому когда вы аутентифицируете определение, которое загружается в одном проекте, вам по-прежнему нужно отдельно войти в проект, где загружается другое определение. Сохраните конечную точку, которую вы хотите, и удалите остальные с помощью `claude mcp remove <name> --scope <scope>`. В предупреждении Claude Code цитирует конечную точку каждой области, как написано в вашей конфигурации, с [ссылками `${VAR}`](#environment-variable-expansion-in-mcp-json) не развёрнутыми, поэтому она никогда не показывает разрешённое значение, такое как ключ API.

325* **Зарезервированные имена**: Claude Code резервирует имена своих встроенных servers, включая `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` и `Claude Browser`. Если ваша конфигурация определяет server с зарезервированным именем, Claude Code пропускает его при загрузке и показывает предупреждение с просьбой переименовать его. `claude mcp add` отклоняет зарезервированное имя с ошибкой. `Claude Preview` и `Claude Browser` оба называют встроенный server, который использует [панель предпросмотра приложения Claude Code desktop](/docs/ru/desktop#preview-your-app). До версии 2.1.205 `Claude Browser` не был зарезервирован, поэтому пользовательский server мог зарегистрироваться под этим именем.322* **Зарезервированные имена**: Claude Code резервирует имена своих встроенных серверов, включая `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` и `Claude Browser`. Если ваша конфигурация определяет сервер с зарезервированным именем, Claude Code пропускает его при загрузке и показывает предупреждение, прося вас переименовать его. `claude mcp add` отклоняет зарезервированное имя с ошибкой. `Claude Preview` и `Claude Browser` оба называют встроенный сервер, который использует [панель предпросмотра настольного приложения Claude Code](/docs/ru/desktop#preview-your-app). До версии v2.1.205 `Claude Browser` не был зарезервирован, поэтому пользовательский сервер мог зарегистрироваться под этим именем.

326* **Отсутствующая переменная окружения**: если ссылка [`${VAR}`](#environment-variable-expansion-in-mcp-json) в конфигурации server называет переменную, которая не установлена и не имеет `:-default`, Claude Code предупреждает в выводе `claude mcp list` и в `/mcp`, называя переменную, и все еще загружает server с текстом `${VAR}` неразвернутым. Установите переменную или добавьте fallback `${VAR:-default}`. В URL и `headers` удаленного server некоторые переменные учетных данных [читаются как пустые](#credential-variables-that-read-as-empty) вместо этого, без предупреждения.323* **Отсутствующая переменная окружения**: если ссылка [`${VAR}`](#environment-variable-expansion-in-mcp-json) в конфигурации сервера называет переменную, которая не установлена и не имеет `:-default`, Claude Code предупреждает в выводе `claude mcp list` и в `/mcp`, называя переменную, и по-прежнему загружает сервер с текстом `${VAR}` не развёрнутым. Установите переменную или добавьте резервный вариант `${VAR:-default}`. В `url` и `headers` удалённого сервера некоторые переменные учётных данных [читаются как пустые](#credential-variables-that-read-as-empty) вместо этого, без предупреждения.

327 324

328<h4 id="tool-availability">325<h4 id="tool-availability">

329 Доступность инструментов326 Доступность инструментов

330</h4>327</h4>

331 328

332Панель `/mcp` показывает количество инструментов рядом с каждым подключенным server и отмечает servers, которые объявляют возможность tools, но не предоставляют никаких инструментов.329Панель `/mcp` показывает количество инструментов рядом с каждым подключённым сервером и отмечает серверы, которые объявляют возможность инструментов, но не предоставляют инструменты.

333 330

334Если ваш запрос требует инструментов от server, который все еще подключается в фоновом режиме, Claude ждет подключения этого server перед продолжением. Как происходит ожидание, зависит от вашей конфигурации:331Если ваш запрос нуждается в инструментах с сервера, который всё ещё подключается в фоне, Claude ждёт этого сервера перед продолжением. Как происходит ожидание, зависит от вашей конфигурации:

335 332

336* **С [поиском инструментов](#scale-with-mcp-tool-search), по умолчанию**: ожидание происходит внутри вызова `ToolSearch`.333* **С [поиском инструментов](#scale-with-mcp-tool-search), по умолчанию**: ожидание происходит внутри вызова `ToolSearch`.

337* **Без поиска инструментов**: Claude использует инструмент `WaitForMcpServers` вместо этого. Конфигурации без поиска инструментов включают пользовательский `ANTHROPIC_BASE_URL`, `ENABLE_TOOL_SEARCH=false` и модель более раннюю, чем поколение Claude 4.5 на Google Cloud's Agent Platform.334* **Без поиска инструментов**: Claude использует инструмент `WaitForMcpServers` вместо этого. Конфигурации без поиска инструментов включают пользовательский `ANTHROPIC_BASE_URL`, `ENABLE_TOOL_SEARCH=false` и модель более ранней версии, чем поколение Claude 4.5 на платформе Agent Platform Google Cloud.

338* **На развертывании Microsoft Foundry [размещенном на Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)**: Claude начинает на пути поиска инструментов, а не с `WaitForMcpServers`, так как Claude Code обнаруживает отказ server-side развертывания только из API. После того как Claude Code переключит это развертывание на [upfront loading](#scale-with-mcp-tool-search), инструменты от server, который завершает подключение, становятся доступными при следующем запросе Claude.335* **На развёртывании Microsoft Foundry [размещённом на Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)**: Claude начинает на пути поиска инструментов, а не с `WaitForMcpServers`, так как Claude Code обнаруживает отклонение на стороне сервера развёртывания только из API. После того как Claude Code переключит это развёртывание на [предварительную загрузку](#scale-with-mcp-tool-search), инструменты с сервера, который завершает подключение, становятся доступны при следующем запросе Claude.

339 336

340С включенным поиском инструментов, когда server завершает подключение, пока Claude работает, Claude Code перечисляет имена инструментов server для Claude при его следующем запросе в том же ходу. Claude затем может искать и вызывать эти инструменты без ожидания вашего следующего сообщения.337С включённым поиском инструментов, когда сервер завершает подключение, пока Claude работает, Claude Code перечисляет имена инструментов сервера Claude при его следующем запросе в том же ходу. Claude затем может искать и вызывать эти инструменты без ожидания вашего следующего сообщения.

341 338

342<h3 id="disable-a-server-without-removing-it">339<h3 id="disable-a-server-without-removing-it">

343 Отключите server без его удаления340 Отключение сервера без его удаления

344</h3>341</h3>

345 342

346Переключите server в панели `/mcp`, чтобы остановить Claude Code от подключения к нему без потери его конфигурации. Claude Code все еще перечисляет server в `/mcp`, отмеченный как отключенный.343Переключите сервер в панели `/mcp`, чтобы остановить Claude Code от подключения к нему без потери его конфигурации. Claude Code по-прежнему перечисляет сервер в `/mcp`, отмеченный как отключённый.

347 344

348Когда вы переключаете server, Claude Code записывает ваш выбор для каждого проекта в `~/.claude.json`, в одном из двух списков, которые охватывают непересекающиеся наборы servers:345Когда вы переключаете сервер, Claude Code записывает ваш выбор для каждого проекта в `~/.claude.json`, в один из двух списков, которые охватывают непересекающиеся наборы серверов:

349 346

350* `disabledMcpServers`: список opt-out для пользовательских servers, plugin servers, servers, которые ваша организация [предоставляет через управляемые параметры](/docs/ru/managed-mcp#provide-servers-through-managed-settings), claude.ai коннекторов, которые Claude Code [получает сам](#how-connectors-reach-claude-code), и встроенных servers, которые по умолчанию включены. Claude Code не подключается к server, который вы перечисляете здесь. Когда вы отключаете claude.ai коннектор с помощью переключателя `/mcp` для каждого проекта, описанного в [Отключите claude.ai коннекторы](#disable-claude-ai-connectors), Claude Code записывает его в этот список под его отображаемым именем, например `claude.ai Slack`.347* `disabledMcpServers`: список отказа для пользовательских серверов, серверов плагинов, серверов, которые ваша организация [предоставляет через управляемые параметры](/docs/ru/managed-mcp#provide-servers-through-managed-settings), соединителей claude.ai, которые Claude Code [получает сам](#how-connectors-reach-claude-code), и встроенных серверов, которые по умолчанию включены. Claude Code не подключается к серверу, который вы перечисляете здесь. Когда вы отключаете соединитель claude.ai с помощью переключателя `/mcp` для каждого проекта, описанного в [Отключение соединителей claude.ai](#disable-claude-ai-connectors), Claude Code записывает его в этот список под его отображаемым именем, например `claude.ai Slack`.

351* `enabledMcpServers`: список opt-in для встроенных servers, которые по умолчанию отключены, такие как `computer-use`. Claude Code подключается к server, который по умолчанию отключен, только когда вы перечисляете его здесь.348* `enabledMcpServers`: список включения для встроенных серверов, которые по умолчанию отключены, такие как `computer-use`. Claude Code подключается к серверу, отключённому по умолчанию, только когда вы перечисляете его здесь.

352 349

353Claude Code консультирует ровно один из двух списков для каждого server, поэтому ни один список не переопределяет другой. Если вы добавляете обычный server в `enabledMcpServers` или server, который по умолчанию отключен, в `disabledMcpServers`, Claude Code игнорирует запись.350Claude Code консультирует ровно один из двух списков для каждого сервера, поэтому ни один список не переопределяет другой. Если вы добавляете обычный сервер в `enabledMcpServers` или сервер, отключённый по умолчанию, в `disabledMcpServers`, Claude Code игнорирует запись.

354 351

355`disabledMcpServers` и `enabledMcpServers` не связаны с [`enabledMcpjsonServers`](/docs/ru/settings-reference#enabledmcpjsonservers) и [`disabledMcpjsonServers`](/docs/ru/settings-reference#disabledmcpjsonservers), которые контролируют одобрение servers, определенных в файле `.mcp.json` проекта.352`disabledMcpServers` и `enabledMcpServers` не связаны с [`enabledMcpjsonServers`](/docs/ru/settings-reference#enabledmcpjsonservers) и [`disabledMcpjsonServers`](/docs/ru/settings-reference#disabledmcpjsonservers), которые контролируют одобрение серверов, определённых в файле `.mcp.json` проекта.

356 353

357<h3 id="mcp-client-runtimes">354<h3 id="mcp-client-runtimes">

358 MCP client runtimes355 Среды выполнения клиента MCP

359</h3>356</h3>

360 357

361Claude Code подключается к MCP servers через один из двух client runtimes. Runtime v1 построен на MCP TypeScript SDK 1.x. Runtime v2 — это тот же код на [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/), который добавляет MCP protocol revision 2026-07-28. Остальная часть этой страницы применяется к обоим runtimes, кроме случаев, когда раздел называет runtime v2.358Claude Code подключается к MCP серверам через одну из двух сред выполнения клиента. Среда выполнения v1 построена на MCP TypeScript SDK 1.x. Среда выполнения v2 — это тот же код на [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/), который добавляет пересмотр протокола MCP 2026-07-28. Остальная часть этой страницы применяется к обеим средам выполнения, кроме случаев, когда раздел называет среду выполнения v2.

362 359

363Claude Code выбирает runtime каждый раз, когда вы его запускаете, и сохраняет его до выхода. В сеансах, где он [получает feature flags](/docs/ru/env-vars#features-that-need-feature-flag-fetching), он использует runtime v2 на Claude Code версии 2.1.232 или позже.360Claude Code выбирает среду выполнения каждый раз, когда вы его запускаете, и сохраняет её до выхода. В сеансах, где он [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), он использует среду выполнения v2 на Claude Code v2.1.232 или позже.

364 361

365В сеансах, где он не получает feature flags, Claude Code использует runtime v2 по умолчанию на Claude Code версии 2.1.274 или позже:362В сеансах, где он не получает флаги функций, Claude Code использует среду выполнения v2 по умолчанию на Claude Code v2.1.274 или позже:

366 363

367* Сеансы на Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform или Microsoft Foundry, если платформа-хост, которая встраивает Claude Code, не установит [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars)364* Сеансы на Amazon Bedrock, Claude Platform на AWS, платформе Agent Platform Google Cloud или Microsoft Foundry, если платформа-хост, которая встраивает Claude Code, не устанавливает [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars)

368* Сеансы, вошедшие через [Claude apps gateway](/docs/ru/claude-apps-gateway)365* Сеансы, вошедшие через [шлюз приложений Claude](/docs/ru/claude-apps-gateway)

369* Сеансы, где вы отключаете телеметрию или получение feature-flag, например с `DISABLE_TELEMETRY`366* Сеансы, где вы отключаете телеметрию или получение флагов функций, например с `DISABLE_TELEMETRY`

370 367

371На v2 Claude Code также:368На v2 Claude Code также:

372 369

373* Спрашивает HTTP servers, поддерживают ли они более новую revision, и использует ее с теми, которые это делают. Он также спрашивает claude.ai connector servers в сеансах, где он получает feature flags. Чтобы он спрашивал stdio servers или connector servers в каждом сеансе, установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) на `auto`. Он подключается к каждому другому server, как v1 это делает.370* Спрашивает HTTP серверы, поддерживают ли они более новый пересмотр, и использует его с теми, которые это делают. Он также спрашивает серверы соединителей claude.ai в сеансах, где он получает флаги функций. Чтобы заставить его спрашивать stdio серверы или серверы соединителей в каждом сеансе, установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) на `auto`. Он подключается к каждому другому серверу, как v1 это делает.

374* Получает уведомления `list_changed` от servers на более новой revision через [stream, который он держит открытым](#notification-streams-on-the-v2-runtime).371* Получает уведомления `list_changed` с серверов на более новом пересмотре через [поток, который он держит открытым](#notification-streams-on-the-v2-runtime).

375* Не регистрирует [channel](#push-messages-with-channels) server, который подключается на более новой revision, потому что эта revision не может переносить channel сообщения.372* Не регистрирует сервер [канала](#push-messages-with-channels), который подключается на более новом пересмотре, потому что этот пересмотр не может нести сообщения канала.

376* Не удается [MCP OAuth sign-in](#authenticate-with-remote-mcp-servers), чей ответ авторизации называет неожиданный issuer.373* Не удаётся [вход MCP OAuth](#authenticate-with-remote-mcp-servers), чей ответ авторизации называет неожиданного издателя.

377 374

378Anthropic может сохранить конкретный server на более ранней protocol или вне этого stream с помощью feature flag, который Claude Code получает.375Anthropic может сохранить конкретный сервер на более раннем протоколе или вне этого потока с флагом функции, который Claude Code получает.

379 376

380Чтобы выбрать runtime самостоятельно, установите [`MCP_SDK_GENERATION`](/docs/ru/env-vars) на `v1` или `v2`. Чтобы решить, спрашивает ли Claude Code, установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) на `auto` или `legacy`.377Чтобы выбрать среду выполнения самостоятельно, установите [`MCP_SDK_GENERATION`](/docs/ru/env-vars) на `v1` или `v2`. Чтобы решить, спрашивает ли Claude Code, установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) на `auto` или `legacy`.

381 378

382<h3 id="dynamic-tool-updates">379<h3 id="dynamic-tool-updates">

383 Динамические обновления инструментов380 Динамические обновления инструментов

384</h3>381</h3>

385 382

386Claude Code поддерживает MCP `list_changed` уведомления, позволяя MCP servers динамически обновлять свои доступные инструменты, подсказки и ресурсы без необходимости отключения и переподключения. Когда MCP server отправляет уведомление `list_changed`, Claude Code автоматически обновляет доступные возможности от этого server.383Claude Code поддерживает уведомления MCP `list_changed`, позволяя MCP серверам динамически обновлять свои доступные инструменты, подсказки и ресурсы без необходимости отключения и переподключения. Когда MCP сервер отправляет уведомление `list_changed`, Claude Code автоматически обновляет доступные возможности с этого сервера.

387 384

388Если запрос обновления не удается, Claude Code сохраняет ранее обнаруженные инструменты, подсказки и ресурсы server до тех пор, пока более позднее обновление не удастся. До версии 2.1.214 временная ошибка во время обновления заменяла инструменты, подсказки и ресурсы server пустым списком.385Если запрос обновления не удаётся, Claude Code сохраняет ранее обнаруженные инструменты, подсказки и ресурсы сервера до тех пор, пока более позднее обновление не удастся. До версии v2.1.214 переходная ошибка во время обновления заменяла инструменты, подсказки и ресурсы сервера пустым списком.

389 386

390<h4 id="notification-streams-on-the-v2-runtime">387<h4 id="notification-streams-on-the-v2-runtime">

391 Notification streams на runtime v2388 Потоки уведомлений на среде выполнения v2

392</h4>389</h4>

393 390

394На [runtime v2](#mcp-client-runtimes) Claude Code получает уведомления `list_changed` от server на более новой protocol revision через stream, который он держит открытым. Когда stream закрывается, Claude Code переоткрывает его с двумя ограничениями:391На [среде выполнения v2](#mcp-client-runtimes) Claude Code получает уведомления `list_changed` с сервера на более новом пересмотре протокола через поток, который он держит открытым. Когда поток закрывается, Claude Code переоткрывает его с двумя ограничениями:

395 392

396* **Stream закрывается снова в течение 10 секунд**: Claude Code переоткрывает его до трех раз, затем останавливается для этого подключения.393* **Поток закрывается снова в течение 10 секунд**: Claude Code переоткрывает его до трёх раз, затем останавливается для этого соединения.

397* **Stream остается открытым дольше 10 секунд, затем закрывается**, как streams к serverless хостам обычно делают: после пяти переоткрытий в час Claude Code ждет примерно шесть часов перед следующим.394* **Поток остаётся открытым дольше 10 секунд, затем закрывается**, как потоки к бессерверным хостам обычно делают: после пяти переоткрытий в час Claude Code ждёт около шести часов перед следующим.

398 395

399До переоткрытия stream вы сохраняете последний полученный инструменты, подсказки и ресурсы server. Чтобы подобрать его изменения раньше, переподключите server из `/mcp`.396До переоткрытия потока вы сохраняете последние полученные инструменты, подсказки и ресурсы сервера. Чтобы подобрать его изменения раньше, переподключите сервер из `/mcp`.

400 397

401<h3 id="automatic-reconnection">398<h3 id="automatic-reconnection">

402 Автоматическое переподключение399 Автоматическое переподключение

403</h3>400</h3>

404 401

405Claude Code переподключает удаленный server, который отключается во время сеанса, и повторяет попытку первого подключения HTTP или SSE server после временной ошибки. Stdio servers — это локальные процессы, и Claude Code не переподключает их автоматически.402Claude Code переподключает удалённый сервер, который отключается во время сеанса, и повторяет попытку первого подключения HTTP или SSE сервера после переходной ошибки. Stdio серверы — это локальные процессы, и Claude Code не переподключает их автоматически.

406 403

407<h4 id="mid-session-drops-of-a-remote-server">404<h4 id="mid-session-drops-of-a-remote-server">

408 Mid-session drops удаленного server405 Отключения удалённого сервера во время сеанса

409</h4>406</h4>

410 407

411Claude Code переподключает отключенный удаленный server с экспоненциальной задержкой: до пяти попыток, начиная с задержки в одну секунду и удваивая ее каждый раз. Что вы видите, зависит от того, как вы запускаете Claude Code:408Claude Code переподключает отключённый удалённый сервер с экспоненциальной задержкой: до пяти попыток, начиная с задержки в одну секунду и удваивая её каждый раз. То, что вы видите, зависит от того, как вы запускаете Claude Code:

412 409

413* **В интерактивном сеансе**: `/mcp` показывает server как ожидающий, пока Claude Code переподключается. После пяти неудачных попыток Claude Code помечает server как неудачный или как нуждающийся в аутентификации, когда server нуждается в авторизации снова. Вы можете повторить попытку вручную из `/mcp`.410* **В интерактивном сеансе**: `/mcp` показывает сервер как ожидающий, пока Claude Code переподключается. После пяти неудачных попыток Claude Code отмечает сервер как неудачный или как нуждающийся в аутентификации, когда сервер нуждается в авторизации снова. Когда он отмечает сервер как неудачный, вы видите уведомление `MCP server "<name>" disconnected · open /mcp to reconnect`. Вы можете повторить попытку вручную из `/mcp`.

414* **В [`claude -p`](/docs/ru/headless) запусках и [Agent SDK](/docs/ru/agent-sdk/overview) сеансах**: Claude Code переподключается по тому же расписанию, без панели `/mcp` для показа попыток.411* **В запусках [`claude -p`](/docs/ru/headless) и сеансах [Agent SDK](/docs/ru/agent-sdk/overview)**: Claude Code переподключается по тому же расписанию, без панели `/mcp` для показа попыток.

415 412

416<h4 id="failed-first-connections">413<h4 id="failed-first-connections">

417 Неудачные первые подключения414 Неудачные первые подключения

418</h4>415</h4>

419 416

420Когда первое подключение HTTP или SSE server не удается с временной ошибкой, такой как ответ 5xx, отказ в соединении или timeout, Claude Code повторяет попытку до трех раз. Если подключение все еще не удается, Claude Code помечает server как неудачный. Claude Code повторяет попытку таким образом при запуске и когда server добавляется во время сеанса. Это включает server, который Claude Code добавляет к [cloud session](/docs/ru/claude-code-on-the-web) из его конфигурации, и server, который вы добавляете с помощью Agent SDK's [`setMcpServers()`](/docs/ru/agent-sdk/typescript).417Когда первое подключение HTTP или SSE сервера не удаётся с переходной ошибкой, такой как ответ 5xx, отказ в соединении или тайм-аут, Claude Code повторяет попытку до трёх раз. Если подключение по-прежнему не удаётся, Claude Code отмечает сервер как неудачный. Claude Code повторяет попытку таким образом при запуске и когда сервер добавляется во время сеанса. Это включает сервер, который Claude Code добавляет в [облачный сеанс](/docs/ru/claude-code-on-the-web) из его конфигурации, и сервер, который вы добавляете с помощью метода [`setMcpServers()`](/docs/ru/agent-sdk/typescript) Agent SDK.

421 418

422Claude Code не повторяет попытку в этих случаях:419Claude Code не повторяет попытку в этих случаях:

423 420

424* Первое подключение WebSocket server421* Первое подключение WebSocket сервера

425* Ошибка аутентификации или не найдено, потому что это требует изменения конфигурации для разрешения. Когда [`headersHelper`](#use-dynamic-headers-for-custom-authentication) является единственным источником server заголовка `Authorization`, Claude Code повторяет попытку ошибки аутентификации в любом случае, потому что он повторно запускает helper при каждой попытке и может подобрать свежие учетные данные422* Ошибка аутентификации или не найдено, потому что это требует изменения конфигурации для разрешения. Когда [`headersHelper`](#use-dynamic-headers-for-custom-authentication) — единственный источник сервера заголовка `Authorization`, Claude Code повторяет попытку ошибки аутентификации в любом случае, потому что он повторно запускает помощника при каждой попытке и может подобрать свежие учётные данные

426 423

427<h4 id="failed-discovery-requests">424<h4 id="failed-discovery-requests">

428 Неудачные запросы обнаружения425 Неудачные запросы обнаружения

429</h4>426</h4>

430 427

431После подключения server Claude Code отправляет ему запросы обнаружения возможностей, такие как `tools/list`, `prompts/list` и `resources/list`. Claude Code повторяет эти запросы до трех раз с короткой задержкой после временной сетевой или серверной ошибки. Он не повторяет ошибки аутентификации, ответы 4xx или timeout запросов.428После подключения сервера Claude Code отправляет ему запросы обнаружения возможностей, такие как `tools/list`, `prompts/list` и `resources/list`. Claude Code повторяет эти запросы до трёх раз с короткой задержкой после переходной сетевой или серверной ошибки. Он не повторяет ошибки аутентификации, ответы 4xx или тайм-ауты запросов.

432 429

433<h4 id="how-claude-learns-that-a-server-failed">430<h4 id="how-claude-learns-that-a-server-failed">

434 Как Claude узнает, что server не удался431 Как Claude узнаёт, что сервер не удался

435</h4>432</h4>

436 433

437Зависит ли то, что Claude Code сообщает Claude о настроенном server, который не удалось подключить, от [поиска инструментов](#scale-with-mcp-tool-search), который включен по умолчанию:434Сообщает ли Claude Code Claude о настроенном сервере, который не смог подключиться, зависит от [поиска инструментов](#scale-with-mcp-tool-search), который включён по умолчанию:

438 435

439* С поиском инструментов Claude Code сообщает Claude, какой server не удалось подключить и его ошибку подключения, поэтому Claude сообщает об ошибке подключения в своем ответе. Claude Code включает ту же информацию в результаты `ToolSearch`, которые не находят соответствующий инструмент.436* С поиском инструментов Claude Code сообщает Claude, какой сервер не удался и его ошибка подключения, поэтому Claude сообщает об ошибке подключения в своём ответе. Claude Code включает ту же информацию в результаты `ToolSearch`, которые не находят соответствующий инструмент.

440* В любой [конфигурации без поиска инструментов](#configure-tool-search) Claude Code не сообщает Claude об ошибках подключения неудачных servers.437* В любой [конфигурации без поиска инструментов](#configure-tool-search) Claude Code не сообщает Claude о неудачных подключениях сервера.

441 438

442<h3 id="push-messages-with-channels">439<h3 id="push-messages-with-channels">

443 Отправка сообщений через каналы440 Отправка сообщений с каналами

444</h3>441</h3>

445 442

446MCP server также может отправлять сообщения непосредственно в вашу сессию, чтобы Claude мог реагировать на внешние события, такие как результаты CI, оповещения мониторинга или сообщения чата. Чтобы включить это, ваш server объявляет возможность `claude/channel` и вы включаете ее с флагом `--channels` при запуске. См. [Каналы](/docs/ru/channels) для использования официально поддерживаемого канала или [Справочник каналов](/docs/ru/channels-reference) для создания собственного.443MCP сервер также может отправлять сообщения непосредственно в ваш сеанс, чтобы Claude мог реагировать на внешние события, такие как результаты CI, оповещения мониторинга или сообщения чата. Чтобы включить это, ваш сервер объявляет возможность `claude/channel` и вы выбираете его с флагом `--channels` при запуске. Смотрите [Каналы](/docs/ru/channels) для использования официально поддерживаемого канала или [Справочник каналов](/docs/ru/channels-reference) для создания своего собственного.

447 444

448На [runtime v2](#mcp-client-runtimes), если вы установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) на `auto` и channel server согласует MCP protocol revision 2026-07-28, он не может доставлять channel сообщения, поэтому Claude Code не регистрирует его как канал. Оставление переменной неустановленной или установка ее на `legacy` сохраняет stdio servers на более ранней handshake.445На [среде выполнения v2](#mcp-client-runtimes), если вы установите [`MCP_PROTOCOL_NEGOTIATION`](/docs/ru/env-vars) на `auto` и сервер канала согласует пересмотр протокола MCP 2026-07-28, он не может доставлять сообщения канала, поэтому Claude Code не регистрирует его как канал. Оставление переменной неустановленной или установка её на `legacy` сохраняет stdio серверы на более раннем рукопожатии.

449 446

450<Tip>447<Tip>

451 Советы:448 Советы:

452 449

453 * Используйте флаг `-s` или `--scope` для указания места хранения конфигурации:450 * Используйте флаг `-s` или `--scope` для указания, где хранится конфигурация:

454 * `local` (по умолчанию): доступно только вам в текущем проекте451 * `local` (по умолчанию): доступно только вам в текущем проекте

455 * `project`: общий доступ для всех в проекте через файл `.mcp.json`452 * `project`: общее со всеми в проекте через файл `.mcp.json`

456 * `user`: доступно вам во всех проектах453 * `user`: доступно вам во всех проектах

457 * Установите переменные окружения с флагами `-e` или `--env` (например, `-e KEY=value`)454 * Установите переменные окружения с флагами `-e` или `--env` (например, `-e KEY=value`)

458 * Флаги `--transport` и `--header` также принимают короткие формы `-t` и `-H`455 * Флаги `--transport` и `--header` также принимают короткие формы `-t` и `-H`

459 * Настройте timeout запуска MCP server, используя переменную окружения `MCP_TIMEOUT` (например, `MCP_TIMEOUT=10000 claude` устанавливает timeout в 10 секунд)456 * Настройте тайм-аут запуска MCP сервера, используя переменную окружения `MCP_TIMEOUT` (например, `MCP_TIMEOUT=10000 claude` устанавливает тайм-аут в 10 секунд)

460 * Установите timeout выполнения инструмента для каждого server, добавив поле `timeout` в миллисекундах в запись этого server в `.mcp.json`, например `"timeout": 600000` для десяти минут. Это переопределяет переменную окружения `MCP_TOOL_TIMEOUT` только для этого server457 * Установите тайм-аут выполнения инструмента для каждого сервера, добавив поле `timeout` в миллисекундах в запись `.mcp.json` этого сервера, например `"timeout": 600000` на десять минут. Это переопределяет переменную окружения `MCP_TOOL_TIMEOUT` только для этого сервера

461 * Claude Code отобразит предупреждение, когда выход инструмента MCP превышает 10 000 токенов и ограничивает выход до 25 000 токенов по умолчанию. Чтобы увеличить этот лимит, установите переменную окружения `MAX_MCP_OUTPUT_TOKENS` (например, `MAX_MCP_OUTPUT_TOKENS=50000`); порог предупреждения фиксирован. См. [Лимиты выхода MCP и предупреждения](#mcp-output-limits-and-warnings)458 * Claude Code отображает предупреждение, когда выход инструмента MCP превышает 10 000 токенов и ограничивает выход до 25 000 токенов по умолчанию. Чтобы повысить лимит, установите переменную окружения `MAX_MCP_OUTPUT_TOKENS` (например, `MAX_MCP_OUTPUT_TOKENS=50000`); порог предупреждения фиксирован. Смотрите [Ограничения и предупреждения выхода MCP](#mcp-output-limits-and-warnings)

462 * Используйте `/mcp` для аутентификации с удаленными servers, которые требуют аутентификацию OAuth 2.0459 * Используйте `/mcp` для аутентификации с удалёнными серверами, которые требуют аутентификацию OAuth 2.0

463</Tip>460</Tip>

464 461

465Timeout для каждого server — это жесткий лимит реального времени для каждого вызова инструмента, и уведомления о прогрессе от server не продлевают его. Значения ниже 1000 игнорируются и переходят к `MCP_TOOL_TIMEOUT`, или к его значению по умолчанию примерно 28 часов, когда эта переменная не установлена. Для HTTP, SSE или [claude.ai connector](/docs/ru/mcp#use-mcp-servers-from-claude-ai) server существует также второй таймер для каждого запроса, который охватывает каждый запрос до первого байта ответа server. Claude Code устанавливает этот таймер на наибольшее из трех значений: 60 секунд, timeout инструмента, который применяется к server, и `MCP_TIMEOUT`. Значение по умолчанию 28 часов неустановленного `MCP_TOOL_TIMEOUT` не входит в это сравнение, и значение ниже 60 секунд не сокращает таймер. Stdio и WebSocket servers не имеют таймера для каждого запроса.462Тайм-аут для каждого сервера — это жёсткий предел реального времени для каждого вызова инструмента, и уведомления о прогрессе с сервера не расширяют его. Значения ниже 1000 игнорируются и переходят к `MCP_TOOL_TIMEOUT` или к его значению по умолчанию около 28 часов, когда эта переменная не установлена. Для HTTP, SSE или [соединителя claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) сервера также есть второй таймер для каждого запроса, который охватывает каждый запрос до первого байта ответа сервера. Claude Code устанавливает этот таймер на наибольшее из трёх значений: 60 секунд, тайм-аут инструмента, который применяется к серверу, и `MCP_TIMEOUT`. Значение по умолчанию 28 часов неустановленного `MCP_TOOL_TIMEOUT` не входит в это сравнение, и значение ниже 60 секунд не сокращает таймер. Stdio и WebSocket серверы не имеют таймера для каждого запроса.

466 463

467Timeout для каждого server не менее 1000 также действует как нижний предел для timeout неактивности, описанного ниже: Claude Code никогда не прерывает вызовы инструментов этого server из-за неактивности раньше, чем timeout для каждого server. Требуется Claude Code версии 2.1.203 или позже.464Тайм-аут для каждого сервера не менее 1000 также действует как нижний предел для тайм-аута неактивности, описанного ниже: Claude Code никогда не прерывает вызовы инструментов этого сервера из-за неактивности раньше, чем тайм-аут для каждого сервера. Требует Claude Code v2.1.203 или позже.

468 465

469Вызов инструмента к MCP server, который не отправляет ответ и не отправляет уведомление о прогрессе в течение окна неактивности, прерывается с ошибкой вместо ожидания лимита реального времени. Он применяется к каждому типу server, кроме IDE servers и SDK in-process servers. Окно неактивности по умолчанию составляет пять минут для HTTP, SSE, WebSocket и [claude.ai connector](#use-mcp-servers-from-claude-ai) servers, и 30 минут для stdio servers. До версии 2.1.203 stdio servers были освобождены от timeout неактивности.466Вызов инструмента к MCP серверу, который не отправляет ответ и не отправляет уведомление о прогрессе в течение окна неактивности, прерывается с ошибкой вместо ожидания предела реального времени. Тайм-аут неактивности применяется к каждому типу сервера, кроме IDE серверов и SDK встроенных серверов. Окно неактивности по умолчанию составляет пять минут для HTTP, SSE, WebSocket и [соединителей claude.ai](#use-mcp-servers-from-claude-ai) серверов и 30 минут для stdio серверов. До версии v2.1.203 stdio серверы были освобождены от тайм-аута неактивности.

470 467

471Установите переменную окружения [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/docs/ru/env-vars) в миллисекундах, чтобы изменить окно неактивности, или установите ее на `0`, чтобы отключить проверку.468Установите переменную окружения [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/docs/ru/env-vars) в миллисекундах, чтобы изменить окно неактивности, или установите её на `0`, чтобы отключить проверку.

472 469

473Эти timeouts ограничивают, как долго вызов может работать, не всегда как долго он блокирует сеанс: вызов основного разговора, который работает более двух минут, сначала переходит в фоновую задачу. См. [Автоматическое фоновое выполнение долгих вызовов инструментов](#automatic-backgrounding-of-long-tool-calls).470Эти тайм-ауты ограничивают, как долго может работать вызов, не всегда как долго он блокирует сеанс: вызов основного разговора, который работает более двух минут, сначала переходит в фоновую задачу. Смотрите [Автоматическое фоновое выполнение долгих вызовов инструментов](#automatic-backgrounding-of-long-tool-calls).

474 471

475<h3 id="automatic-backgrounding-of-long-tool-calls">472<h3 id="automatic-backgrounding-of-long-tool-calls">

476 Автоматическое фоновое выполнение долгих вызовов инструментов473 Автоматическое фоновое выполнение долгих вызовов инструментов

477</h3>474</h3>

478 475

479Вызов инструмента MCP в основном разговоре, который все еще работает после двух минут, переходит в фоновую задачу вместо блокирования сеанса. Claude получает ID задачи немедленно и продолжает работать, и результат приходит как уведомление задачи, когда вызов завершается. Автоматическое фоновое выполнение требует Claude Code версии 2.1.212 или позже.476Вызов инструмента MCP в основном разговоре, который всё ещё работает после двух минут, переходит в фоновую задачу вместо блокирования сеанса. Claude получает ID задачи немедленно и продолжает работать, и результат приходит как уведомление задачи, когда вызов завершается. Автоматическое фоновое выполнение требует Claude Code v2.1.212 или позже.

480 477

481Задача отображается в [`/tasks`](/docs/ru/commands#all-commands), где вы также можете ее остановить, и она не сохраняется при выходе из сеанса. Лимиты для каждого вызова все еще применяются, пока вызов работает в фоне: лимит реального времени, установленный timeout для каждого server или [`MCP_TOOL_TIMEOUT`](/docs/ru/env-vars), и timeout неактивности, установленный [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/docs/ru/env-vars).478Задача появляется в [`/tasks`](/docs/ru/commands#all-commands), где вы также можете её остановить, и она не сохраняется при выходе из сеанса. Ограничения для каждого вызова по-прежнему применяются, пока вызов работает в фоне: предел реального времени, установленный тайм-аутом для каждого сервера или [`MCP_TOOL_TIMEOUT`](/docs/ru/env-vars), и тайм-аут неактивности, установленный [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/docs/ru/env-vars).

482 479

483Установите переменную окружения [`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`](/docs/ru/env-vars) в миллисекундах, чтобы изменить порог, или установите ее на `0`, чтобы отключить автоматическое фоновое выполнение. Установка `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` на `1` также отключает его, наряду со всеми другими функциями фоновых задач.480Установите переменную окружения [`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`](/docs/ru/env-vars) в миллисекундах, чтобы изменить порог, или установите её на `0`, чтобы отключить автоматическое фоновое выполнение. Установка `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` на `1` также отключает его, наряду со всеми другими функциями фоновых задач.

484 481

485Некоторые вызовы никогда не переходят в фон:482Некоторые вызовы никогда не переходят в фон:

486 483

487* Вызовы от [subagents](/docs/ru/sub-agents); Claude Code фоновое выполнение только вызовов основного разговора484* Вызовы из [подагентов](/docs/ru/sub-agents); Claude Code фоновое выполнение только вызовов основного разговора

488* Вызовы к IDE servers485* Вызовы к IDE серверам

489* Вызовы в [non-interactive mode](/docs/ru/headless), если `CLAUDE_AUTO_BACKGROUND_TASKS` не установлен на `1`, так как одноразовый запуск может завершиться до прихода результата486* Вызовы в [неинтерактивном режиме](/docs/ru/headless), если только `CLAUDE_AUTO_BACKGROUND_TASKS` не установлена на `1`, так как одноразовый запуск может завершиться до прибытия результата

490 487

491Вызов, ожидающий открытого [диалога elicitation](#respond-to-mcp-elicitation-requests), не фоновое выполнение, пока диалог открыт; server заблокирован на вашем вводе, а не медленный, поэтому Claude Code откладывает перемещение до закрытия диалога.488Вызов, ожидающий открытого [диалога запроса](#respond-to-mcp-elicitation-requests), не фоновое выполнение, пока диалог открыт; сервер заблокирован на вашем вводе, а не медленный, поэтому Claude Code откладывает переход до закрытия диалога.

492 489

493<h3 id="plugin-provided-mcp-servers">490<h3 id="plugin-provided-mcp-servers">

494 Plugin-provided MCP servers491 MCP серверы, предоставляемые плагинами

495</h3>492</h3>

496 493

497[Плагины](/docs/ru/plugins/overview) могут включать MCP servers, которые предоставляют инструменты и интеграции при включении плагина. Plugin MCP servers работают идентично пользовательским настроенным servers.494[Плагины](/docs/ru/plugins/overview) могут объединять MCP серверы, которые предоставляют инструменты и интеграции при включении плагина. MCP серверы плагинов работают идентично пользовательским настроенным серверам.

498 495

499**Как работают plugin MCP servers**:496**Как работают MCP серверы плагинов**:

500 497

501* Плагины определяют MCP servers в `.mcp.json` в корне плагина или встроенные в `plugin.json`498* Плагины определяют MCP серверы в `.mcp.json` в корне плагина или встроенные в `plugin.json`

502* Когда вы включаете плагин, Claude Code автоматически запускает его MCP servers499* Когда вы включаете плагин, Claude Code автоматически запускает его MCP серверы

503* Claude Code предлагает plugin MCP tools рядом с вручную настроенными MCP tools500* Claude Code предлагает инструменты MCP плагинов наряду с вручную настроенными инструментами MCP

504* Вы добавляете и удаляете plugin servers путем установки или удаления плагина, а не с помощью команд `/mcp`. Вы все еще можете [отключить установленный plugin server](#disable-a-server-without-removing-it) в `/mcp`, что останавливает Claude Code от подключения к нему без удаления плагина501* Вы добавляете и удаляете серверы плагинов, устанавливая или удаляя плагин, а не с помощью команд `/mcp`. Вы по-прежнему можете [переключить установленный сервер плагина](#disable-a-server-without-removing-it) в `/mcp`, что останавливает Claude Code от подключения к нему без удаления плагина

505 502

506**Пример конфигурации plugin MCP**:503**Пример конфигурации MCP плагина**:

507 504

508В `.mcp.json` в корне плагина:505В `.mcp.json` в корне плагина:

509 506

535}532}

536```533```

537 534

538**Функции plugin MCP**:535**Функции MCP плагинов**:

539 536

540* **Автоматический жизненный цикл**: servers подключаются и отключаются в этих точках:537* **Автоматический жизненный цикл**: серверы подключаются и отключаются в этих точках:

541 * При запуске сеанса Claude Code автоматически подключает servers для включенных плагинов. В `/mcp` удаленный (HTTP или SSE) plugin server, который вы использовали раньше, может показать статус [`cached`](#server-status-detail) вместо этого; Claude Code подключает его, когда Claude впервые вызывает один из его инструментов538 * При запуске сеанса Claude Code автоматически подключает серверы для включённых плагинов. В `/mcp` удалённый (HTTP или SSE) сервер плагина, который вы использовали раньше, может показать статус [`cached`](#server-status-detail) вместо этого; Claude Code подключает его, когда Claude впервые вызывает один из его инструментов

542 * Если вы включаете или отключаете плагин во время сеанса, Claude Code подключает или отключает его MCP servers, когда изменение применяется. [Применить изменения плагина без перезагрузки](/docs/ru/plugins/cli-reference#reload-plugins) описывает, когда это происходит. В сеансе без интерактивного терминала `/reload-plugins` не подключает или отключает plugin MCP servers; эти изменения вступают в силу в вашем следующем сеансе539 * Если вы включаете или отключаете плагин во время сеанса, Claude Code подключает или отключает его MCP серверы, когда изменение применяется. [Применение изменений плагина без перезагрузки](/docs/ru/plugins/cli-reference#reload-plugins) описывает, когда это происходит. В сеансе без интерактивного терминала `/reload-plugins` не подключает и не отключает MCP серверы плагинов; эти изменения вступают в силу в вашем следующем сеансе

543 * Когда вы перезагружаете, Claude Code сохраняет живые подключения plugin servers, конфигурация которых не изменилась, и делает то же самое, когда вы [заменяете список MCP servers сеанса](/docs/ru/agent-sdk/typescript#mcpsetserversresult) из Agent SDK без их названия540 * Когда вы перезагружаете, Claude Code сохраняет живые соединения серверов плагинов, чья конфигурация не изменилась, и делает то же самое, когда вы [заменяете список MCP сервера сеанса](/docs/ru/agent-sdk/typescript#mcpsetserversresult) из Agent SDK без их названия

544 * Когда вы [перемещаете сеанс с `/cd`](/docs/ru/permissions#move-the-session-to-another-directory) на версии 2.1.246 или позже, Claude Code подключает servers плагинов, которые включают параметры новой директории, и отключает servers плагинов, которые больше не включены, поэтому вам не нужно запускать `/reload-plugins` после перемещения541 * Когда вы [перемещаете сеанс с `/cd`](/docs/ru/permissions#move-the-session-to-another-directory) на v2.1.246 или позже, Claude Code подключает серверы плагинов, которые включают параметры новой директории, и отключает серверы плагинов, которые больше не включены, поэтому вам не нужно запускать `/reload-plugins` после перемещения

545 * В [cloud sessions](/docs/ru/claude-code-on-the-web) вызов MCP к plugin server, который еще не подключен, такой как сразу после пробуждения неактивного сеанса, запускает server по требованию и ждет его подключения542 * В [облачных сеансах](/docs/ru/claude-code-on-the-web) вызов MCP к серверу плагина, который ещё не подключён, такой как сразу после пробуждения неактивного сеанса, запускает сервер по требованию и ждёт его подключения

546* **Заполнители пути**: `${CLAUDE_PLUGIN_ROOT}` разрешается в директорию установки плагина, `${CLAUDE_PLUGIN_DATA}` в его [директорию постоянного состояния](/docs/ru/plugins/components#path-variables-and-persistent-data), и `${CLAUDE_PROJECT_DIR}` в стабильный корень проекта. Подстановка применяется к:543* **Заполнители пути**: `${CLAUDE_PLUGIN_ROOT}` разрешается в директорию установки плагина, `${CLAUDE_PLUGIN_DATA}` в его директорию [постоянного состояния](/docs/ru/plugins/components#path-variables-and-persistent-data) и `${CLAUDE_PROJECT_DIR}` в стабильный корень проекта. Подстановка применяется к:

547 * `stdio` servers: `command`, `args`, `env`544 * серверам `stdio`: `command`, `args`, `env`

548 * `http`, `sse` и `ws` servers: `url`, `headers` и `headersHelper`. До версии 2.1.195 `headersHelper` передавал заполнитель как буквальную строку545 * серверам `http`, `sse` и `ws`: `url`, `headers` и `headersHelper`. До версии v2.1.195 `headersHelper` передавал заполнитель как буквальную строку

549* **Доступ к переменным окружения пользователя**: доступ к тем же переменным окружения, что и вручную настроенные servers546* **Доступ к пользовательскому окружению**: доступ к тем же переменным окружения, что и вручную настроенные серверы

550* **Несколько типов транспорта**: поддержка stdio, SSE, HTTP и WebSocket транспортов, хотя поддержка транспорта может варьироваться в зависимости от server547* **Несколько типов транспорта**: поддержка транспортов stdio, SSE, HTTP и WebSocket, хотя поддержка транспорта может варьироваться по серверам

551 548

552Plugin servers отображаются в `/mcp` с индикаторами, показывающими, что они поступают из плагинов.549Серверы плагинов появляются в `/mcp` с индикаторами, показывающими, что они поступают из плагинов.

553 550

554**Имена plugin MCP tools**:551**Имена инструментов MCP плагинов**:

555 552

556Инструменты из MCP server, включенного в плагин, содержат как имя плагина, так и ключ server в их вызываемом имени. Полная форма — `mcp__plugin_<plugin-name>_<server-name>__<tool-name>`, где любой символ вне `A-Z`, `a-z`, `0-9`, `_` и `-` заменяется на `_`. Для server `database-tools`, включенного в плагин с именем `my-plugin`, инструмент `query` вызывается как:553Инструменты с сервера MCP, объединённого с плагином, включают как имя плагина, так и ключ сервера в их вызываемое имя. Полная форма — `mcp__plugin_<plugin-name>_<server-name>__<tool-name>`, где любой символ вне `A-Z`, `a-z`, `0-9`, `_` и `-` заменяется на `_`. Для сервера `database-tools`, объединённого в плагин с именем `my-plugin`, инструмент `query` вызывается как:

557 554

558```555```

559mcp__plugin_my-plugin_database-tools__query556mcp__plugin_my-plugin_database-tools__query

560```557```

561 558

562Используйте это полное имя при ссылке на инструмент в [правилах разрешений](/docs/ru/permissions), в списке `allowed-tools` skill, в [поле `tools` subagent](/docs/ru/sub-agents#available-tools) или в [matcher hook](/docs/ru/hooks#match-mcp-tools). Matcher hook, написанный против простого ключа server, такой как `mcp__database-tools__.*`, никогда не срабатывает для plugin-bundled server.559Используйте это полное имя при ссылке на инструмент в [правилах разрешений](/docs/ru/permissions), списке `allowed-tools` навыка, поле `tools` [подагента](/docs/ru/sub-agents#available-tools) или [сопоставителе hook](/docs/ru/hooks#match-mcp-tools). Сопоставитель hook, написанный для голого ключа сервера, такой как `mcp__database-tools__.*`, никогда не срабатывает для сервера, объединённого с плагином.

563 560

564Server сам регистрируется под scoped именем `plugin:<plugin-name>:<server-name>`, такой как `plugin:my-plugin:database-tools`. Используйте это имя там, где ожидается имя настроенного server, такой как [поле `server` hook `mcp_tool`](/docs/ru/hooks#mcp-tool-hook-fields).561Сам сервер регистрируется под именем с областью `plugin:<plugin-name>:<server-name>`, такой как `plugin:my-plugin:database-tools`. Используйте это имя, где ожидается имя настроенного сервера, такое как поле `server` [hook `mcp_tool`](/docs/ru/hooks#mcp-tool-hook-fields).

565 562

566См. [справочник компонентов плагина](/docs/ru/plugins/components#mcp-servers) для получения подробной информации о включении MCP servers в плагины.563Смотрите [справочник компонентов плагинов](/docs/ru/plugins/components#mcp-servers) для деталей об объединении MCP серверов с плагинами.

567 564

568<h2 id="mcp-installation-scopes">565<h2 id="mcp-installation-scopes">

569 Области установки MCP566 Области установки MCP

6694. [Plugin-provided servers](/docs/ru/plugins/components#mcp-servers)6664. [Plugin-provided servers](/docs/ru/plugins/components#mcp-servers)

6705. [claude.ai connectors](#use-mcp-servers-from-claude-ai)6675. [claude.ai connectors](#use-mcp-servers-from-claude-ai)

671 668

672Три области совпадают дубликаты по имени. Плагины и соединители совпадают по конечной точке, поэтому тот, который указывает на тот же URL или команду, что и server выше, рассматривается как дубликат.669Claude Code совпадает дубликаты по трем областям по имени. Плагины и соединители совпадают по конечной точке, поэтому тот, который указывает на тот же URL или команду, что и server выше, рассматривается как дубликат.

670

671Два написания URL считаются одной конечной точкой, когда они отличаются только буквой регистра схемы или хоста, портом по умолчанию схемы, таким как `:443` на `https`, или косой чертой в конце. Другой путь, строка запроса, userinfo или нестандартный порт делают два servers разными.

673 672

674Server, который ваша организация предоставляет через управляемый параметр [`managedMcpServers`](/docs/ru/managed-mcp#provide-servers-through-managed-settings), занимает место выше всех этих, поэтому когда один из них дублирует его, Claude Code подключает определение организации. Требует Claude Code v2.1.259 или позже.673Server, который ваша организация предоставляет через управляемый параметр [`managedMcpServers`](/docs/ru/managed-mcp#provide-servers-through-managed-settings), занимает место выше всех этих, поэтому когда один из них дублирует его, Claude Code подключает определение организации. Требует Claude Code v2.1.259 или позже.

675 674

816```815```

817 816

818<h2 id="authenticate-with-remote-mcp-servers">817<h2 id="authenticate-with-remote-mcp-servers">

819 Аутентификация с удаленными MCP servers818 Аутентификация с удаленными MCP серверами

820</h2>819</h2>

821 820

822Многие облачные MCP servers требуют аутентификации. Claude Code поддерживает OAuth 2.0 для безопасных соединений.821Многие облачные MCP серверы требуют аутентификации. Claude Code поддерживает OAuth 2.0 для безопасных соединений.

823 822

824Claude Code отмечает удаленный server как требующий аутентификации, когда server отвечает с `401 Unauthorized` или `403 Forbidden`. То, что показывает Claude Code, зависит от server:823Claude Code помечает удаленный сервер как требующий аутентификации, когда сервер отвечает с `401 Unauthorized` или `403 Forbidden`. То, что показывает Claude Code, зависит от сервера:

825 824

826* Для server, на который вы еще не вошли, любой из этих кодов состояния отмечает его в `/mcp`, чтобы вы могли завершить поток OAuth.825* Для сервера, на который вы еще не вошли, любой из этих кодов состояния помечает его в `/mcp`, чтобы вы могли завершить поток OAuth.

827* Для [разъема claude.ai](#use-mcp-servers-from-claude-ai), `401`, вызванный отклонением claude.ai вашего токена сеанса, не отмечает разъем, потому что повторная авторизация разъема не может исправить вашу учетную запись. Claude Code показывает [состояние отклонения токена сеанса](/docs/ru/errors#claude-ai-rejected-the-session-token) вместо этого.826* Для [коннектора claude.ai](#use-mcp-servers-from-claude-ai), `401`, вызванный отклонением claude.ai вашего токена сеанса, не помечает коннектор, потому что повторная авторизация коннектора не может исправить вашу учетную запись. Claude Code показывает [состояние отклонения токена сеанса](/docs/ru/errors#claude-ai-rejected-the-session-token) вместо этого.

828* Для server, чей заголовок `Authorization` вы настроили в `headers` или через [`headersHelper`](#use-dynamic-headers-for-custom-authentication), `401` или `403` при подключении не отмечает server, потому что учетные данные для исправления — это те, которые вы настроили. Claude Code сообщает о соединении как о неудачном вместо этого. Если вы установили этот заголовок из ссылки `${VAR}`, проверьте, является ли эта переменная одной из тех, которые Claude Code [читает как пустые](#credential-variables-that-read-as-empty).827* Для сервера, чей заголовок `Authorization` вы настроили в `headers` или через [`headersHelper`](#use-dynamic-headers-for-custom-authentication), `401` или `403` при подключении не помечает сервер, потому что учетные данные для исправления — это те, которые вы настроили. Claude Code вместо этого сообщает о неудачном соединении. Если вы установили этот заголовок из ссылки `${VAR}`, проверьте, является ли эта переменная одной из тех, которые Claude Code [читает как пустые](#credential-variables-that-read-as-empty).

829* Для разъема [доставленного в облачный сеанс](#how-connectors-reach-claude-code), Claude Code не запускает поток входа, потому что прокси сеанса аутентифицируется с разъемом с авторизацией, которую вы предоставили в claude.ai. Когда разъем там требует авторизации снова, переподключите его на [claude.ai/customize/connectors](https://claude.ai/customize/connectors) вместо сеанса.828* Для коннектора [доставленного в облачный сеанс](#how-connectors-reach-claude-code), Claude Code не запускает поток входа, потому что прокси сеанса аутентифицируется на коннекторе с авторизацией, которую вы предоставили в claude.ai. Когда коннектор там требует повторной авторизации, переподключитесь на [claude.ai/customize/connectors](https://claude.ai/customize/connectors) вместо сеанса.

830 829

831Когда запрос к OAuth server, на который вы уже вошли, возвращает `401 Unauthorized`, Claude Code обновляет сохраненный токен, переподключается и повторяет запрос один раз. Он отмечает server в `/mcp` только если этот повторный запрос также не удается. До v2.1.206 обновление токена, которое не удалось по временной причине, такой как ошибка сети, отмечало OAuth server как требующий аутентификации для остальной части сеанса, даже если его токен обновления был все еще действителен.830Когда запрос к OAuth серверу, на который вы уже вошли, возвращает `401 Unauthorized`, Claude Code обновляет сохраненный токен, переподключается и повторяет запрос один раз. Он помечает сервер в `/mcp` только если этот повтор также не удается. До v2.1.206 обновление токена, которое не удалось по временной причине, такой как ошибка сети, помечало OAuth сервер как требующий аутентификации на остаток сеанса, даже если его токен обновления был все еще действителен.

832 831

833Когда server отклоняет сохраненный токен обновления, Claude Code немедленно показывает уведомление, указывающее на `/mcp`. Откройте `/mcp` и выберите **Re-authenticate** на server, чтобы снова войти перед следующим вызовом инструмента.832Когда сервер отклоняет сохраненный токен обновления, Claude Code немедленно показывает уведомление, указывающее на `/mcp`. Откройте `/mcp` и выберите **Re-authenticate** на сервере, чтобы войти снова перед следующим вызовом инструмента.

834 833

835Пользовательский server, который возвращает заголовок `WWW-Authenticate`, указывающий на его сервер авторизации, получает то же автоматическое обнаружение, как и любой другой удаленный server.834Пользовательский сервер, который возвращает заголовок `WWW-Authenticate`, указывающий на его сервер авторизации, получает такое же автоматическое обнаружение, как и любой другой удаленный сервер.

836 835

837Claude Code также показывает уведомление при запуске, когда один или несколько настроенных servers требуют аутентификации, поэтому вам не нужно открывать `/mcp` для обнаружения, какие servers требуют входа. Уведомление требует Claude Code v2.1.193 или позже. Оно считает только servers, на которые вы можете войти из Claude Code. До v2.1.218 оно также считало [разъемы claude.ai](#use-mcp-servers-from-claude-ai), которые не были подключены в claude.ai, которые вы можете подключить только из параметров claude.ai.836Claude Code также показывает уведомление при запуске, когда один или несколько настроенных серверов требуют аутентификации, поэтому вам не нужно открывать `/mcp`, чтобы узнать, какие серверы требуют входа. Уведомление требует Claude Code v2.1.193 или позже. Оно считает только серверы, на которые вы можете войти из Claude Code. До v2.1.218 оно также считало [коннекторы claude.ai](#use-mcp-servers-from-claude-ai), которые не были подключены в claude.ai, которые вы можете подключить только из параметров claude.ai.

838 837

839Уведомление объявляет каждый server один раз и исключает его из подсчета при последующих запусках, пока этот server не подключится и не потребует входа снова. `/mcp` по-прежнему перечисляет каждый server, который требует входа.838Уведомление объявляет каждый сервер один раз и исключает его из подсчета при последующих запусках, пока этот сервер не подключится и снова не потребует входа. `/mcp` по-прежнему перечисляет каждый сервер, который требует входа.

840 839

841В неинтерактивном режиме нет панели `/mcp`, поэтому Claude Code не может запустить поток OAuth для вас. Начиная с v2.1.196, когда настроенный server требует аутентификации во время запуска `claude -p` или Agent SDK с включенным [поиском инструментов](#scale-with-mcp-tool-search), что является значением по умолчанию, Claude Code сообщает Claude, что инструменты server недоступны, пока вы его не авторизуете. Claude затем может назвать server, который требует входа, вместо того чтобы отвечать так, как будто server не был настроен. Завершите вход из интерактивного сеанса с помощью `/mcp` или `claude mcp login <name>`.840В неинтерактивном режиме нет панели `/mcp`, поэтому Claude Code не может запустить поток OAuth для вас. Начиная с v2.1.196, когда настроенный сервер требует аутентификации во время запуска `claude -p` или Agent SDK с включенным [поиском инструментов](#scale-with-mcp-tool-search), что является значением по умолчанию, Claude Code сообщает Claude, что инструменты сервера недоступны, пока вы его не авторизуете. Claude затем может назвать сервер, который требует входа, вместо того чтобы отвечать так, как если бы сервер не был настроен. Завершите вход из интерактивного сеанса с `/mcp` или `claude mcp login <name>`.

842 841

843Если вы настроили `headers.Authorization` для server и server отклонил этот заголовок, Claude Code сообщает о соединении как о неудачном вместо того, чтобы вернуться к OAuth. Проверьте, что токен действителен для конечной точки MCP, или удалите заголовок, чтобы использовать поток OAuth.842Если вы настроили `headers.Authorization` для сервера и сервер отклоняет этот заголовок, Claude Code сообщает о неудачном соединении вместо возврата к OAuth. Проверьте, что токен действителен для конечной точки MCP, или удалите заголовок, чтобы использовать поток OAuth.

844 843

845<Steps>844<Steps>

846 <Step title="Добавьте server, который требует аутентификации">845 <Step title="Добавьте сервер, требующий аутентификации">

847 Если вы уже добавили server `sentry` в [быстром старте MCP](/docs/ru/mcp-quickstart#connect-a-server-that-requires-sign-in), пропустите этот шаг: запуск `claude mcp add` снова с тем же именем server в той же области не удается с `MCP server sentry already exists in local config`. В противном случае запустите:846 Если вы уже добавили сервер `sentry` в [быстром старте MCP](/docs/ru/mcp-quickstart#connect-a-server-that-requires-sign-in), пропустите этот шаг: повторный запуск `claude mcp add` с тем же именем сервера в той же области завершится ошибкой `MCP server sentry already exists in local config`. В противном случае запустите:

848 847

849 ```bash theme={null}848 ```bash theme={null}

850 claude mcp add --transport http sentry https://mcp.sentry.dev/mcp849 claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

869 * Используйте "Clear authentication" в меню `/mcp` для отзыва доступа868 * Используйте "Clear authentication" в меню `/mcp` для отзыва доступа

870 * Если ваш браузер не открывается автоматически, скопируйте предоставленный URL и откройте его вручную869 * Если ваш браузер не открывается автоматически, скопируйте предоставленный URL и откройте его вручную

871 * Если перенаправление браузера не удается с ошибкой соединения после аутентификации, вставьте полный URL обратного вызова из адресной строки браузера в приглашение URL, которое появляется в Claude Code870 * Если перенаправление браузера не удается с ошибкой соединения после аутентификации, вставьте полный URL обратного вызова из адресной строки браузера в приглашение URL, которое появляется в Claude Code

872 * Аутентификация OAuth работает с HTTP servers871 * Аутентификация OAuth работает с HTTP серверами

873</Tip>872</Tip>

874 873

875<h3 id="authenticate-from-the-command-line">874<h3 id="authenticate-from-the-command-line">

876 Аутентификация из командной строки875 Аутентификация из командной строки

877</h3>876</h3>

878 877

879Команда `claude mcp login <name>` запускает поток OAuth настроенного server прямо из вашей оболочки, поэтому вам не нужно открывать панель `/mcp` внутри сеанса.878Команда `claude mcp login <name>` запускает поток OAuth настроенного сервера непосредственно из вашей оболочки, поэтому вам не нужно открывать панель `/mcp` внутри сеанса.

880 879

881```bash theme={null}880```bash theme={null}

882claude mcp login sentry881claude mcp login sentry

884 883

885Чтобы позже очистить сохраненные учетные данные, запустите `claude mcp logout <name>`.884Чтобы позже очистить сохраненные учетные данные, запустите `claude mcp logout <name>`.

886 885

887`claude mcp login` обнаруживает, когда локальный браузер недоступен, например во время сеанса SSH или на Linux без сервера отображения, и выводит URL авторизации вместо попытки открыть браузер. Откройте URL на вашей локальной машине, затем вставьте полный URL перенаправления из адресной строки браузера обратно в приглашение. Команде требуется интерактивный терминал для шага вставки, поэтому подключитесь с помощью `ssh -t`. Передайте `--no-browser` для принудительного приглашения URL даже при обнаружении локального браузера.886`claude mcp login` обнаруживает, когда локальный браузер недоступен, например во время сеанса SSH или на Linux без сервера отображения, и выводит URL авторизации вместо попытки открыть браузер. Откройте URL на вашей локальной машине, затем вставьте полный URL перенаправления из адресной строки браузера обратно в приглашение. Команде требуется интерактивный терминал для шага вставки, поэтому подключитесь с `ssh -t`. Передайте `--no-browser`, чтобы принудительно использовать приглашение URL даже при обнаружении локального браузера.

888 887

889```bash theme={null}888```bash theme={null}

890claude mcp login sentry --no-browser889claude mcp login sentry --no-browser

894 Используйте фиксированный порт обратного вызова OAuth893 Используйте фиксированный порт обратного вызова OAuth

895</h3>894</h3>

896 895

897Некоторые MCP servers требуют конкретный URI перенаправления, зарегистрированный заранее. По умолчанию Claude Code выбирает случайный доступный порт для обратного вызова OAuth. Используйте `--callback-port` для фиксации порта, чтобы он соответствовал предварительно зарегистрированному URI перенаправления формы `http://localhost:PORT/callback`. Если вход на Claude Code v2.1.229 не удается с несоответствием URI перенаправления, см. примечание версии в разделе [Используйте предварительно настроенные учетные данные OAuth](#use-pre-configured-oauth-credentials).896Некоторые MCP серверы требуют определенный URI перенаправления, зарегистрированный заранее. По умолчанию Claude Code выбирает случайный доступный порт для обратного вызова OAuth. Используйте `--callback-port`, чтобы зафиксировать порт так, чтобы он соответствовал предварительно зарегистрированному URI перенаправления формы `http://localhost:PORT/callback`. Если вход на Claude Code v2.1.229 не удается с несоответствием URI перенаправления, см. примечание версии в разделе [Используйте предварительно настроенные учетные данные OAuth](#use-pre-configured-oauth-credentials).

898 897

899Вы можете использовать `--callback-port` самостоятельно (с динамической регистрацией клиента) или вместе с `--client-id` (с предварительно настроенными учетными данными).898Вы можете использовать `--callback-port` самостоятельно (с динамической регистрацией клиента) или вместе с `--client-id` (с предварительно настроенными учетными данными).

900 899

909 Используйте предварительно настроенные учетные данные OAuth908 Используйте предварительно настроенные учетные данные OAuth

910</h3>909</h3>

911 910

912Некоторые MCP servers не поддерживают автоматическую настройку OAuth через Dynamic Client Registration. Если вы видите ошибку типа "Incompatible auth server: does not support dynamic client registration", server требует предварительно настроенные учетные данные. Claude Code также поддерживает servers, которые используют Client ID Metadata Document (CIMD) вместо Dynamic Client Registration, и обнаруживает их автоматически. Если автоматическое обнаружение не удается, сначала зарегистрируйте приложение OAuth через портал разработчика server, затем предоставьте учетные данные при добавлении server.911Некоторые MCP серверы не поддерживают автоматическую настройку OAuth через Dynamic Client Registration. Если вы видите ошибку типа "Incompatible auth server: does not support dynamic client registration," сервер требует предварительно настроенные учетные данные. Claude Code также поддерживает серверы, которые используют Client ID Metadata Document (CIMD) вместо Dynamic Client Registration, и обнаруживает их автоматически. Если автоматическое обнаружение не удается, сначала зарегистрируйте приложение OAuth через портал разработчика сервера, затем предоставьте учетные данные при добавлении сервера.

913 912

914<Steps>913<Steps>

915 <Step title="Зарегистрируйте приложение OAuth с помощью server">914 <Step title="Зарегистрируйте приложение OAuth на сервере">

916 Создайте приложение через портал разработчика server и запишите ваш client ID и client secret.915 Создайте приложение через портал разработчика сервера и запишите ваш ID клиента и секрет клиента.

917 916

918 Многие servers также требуют URI перенаправления. Если это так, выберите порт и зарегистрируйте URI перенаправления в формате `http://localhost:PORT/callback`. Используйте тот же порт с `--callback-port` на следующем шаге.917 Если форма регистрации запрашивает URI перенаправления, выберите любой доступный порт и введите `http://localhost:PORT/callback` с этим портом. Вы будете использовать тот же порт на следующем шаге.

919 918

920 В v2.1.229 Claude Code отправлял `http://127.0.0.1:PORT/callback` вместо этого, и servers, которые точно совпадают с зарегистрированным URI перенаправления, отклоняли вход с несоответствием URI перенаправления. Claude Code v2.1.231 восстановил форму `localhost`. Чтобы восстановиться на v2.1.229, обновите Claude Code или временно добавьте форму `http://127.0.0.1:PORT/callback` к зарегистрированным URI перенаправления server.919 В v2.1.229 Claude Code отправлял `http://127.0.0.1:PORT/callback` вместо этого, и серверы, которые точно совпадают с зарегистрированным URI перенаправления, отклоняли вход с несоответствием URI перенаправления. Claude Code v2.1.231 восстановил форму `localhost`. Чтобы восстановиться на v2.1.229, обновите Claude Code или временно добавьте форму `http://127.0.0.1:PORT/callback` к зарегистрированным URI перенаправления сервера.

921 </Step>920 </Step>

922 921

923 <Step title="Добавьте server с вашими учетными данными">922 <Step title="Добавьте сервер с вашими учетными данными">

924 Выберите один из следующих методов. Порт, используемый для `--callback-port`, может быть любым доступным портом. Он должен соответствовать URI перенаправления, который вы зарегистрировали на предыдущем шаге.923 Вкладки охватывают обе команды: `claude mcp add` принимает ваш ID клиента и порт обратного вызова как флаги, а `claude mcp add-json` принимает их в объекте `oauth`. Если вы зарегистрировали URI перенаправления, установите порт обратного вызова на порт в этом URI.

925 924

926 <Tabs>925 <Tabs>

927 <Tab title="claude mcp add">926 <Tab title="claude mcp add">

928 Используйте `--client-id` для передачи client ID вашего приложения. Флаг `--client-secret` запрашивает secret с замаскированным вводом:927 Используйте `--client-id` для передачи ID клиента вашего приложения. Флаг `--client-secret` запрашивает секрет с замаскированным вводом:

929 928

930 ```bash theme={null}929 ```bash theme={null}

931 claude mcp add --transport http \930 claude mcp add --transport http \

945 </Tab>944 </Tab>

946 945

947 <Tab title="claude mcp add-json (только порт обратного вызова)">946 <Tab title="claude mcp add-json (только порт обратного вызова)">

948 Используйте `--callback-port` без client ID для фиксации порта при использовании динамической регистрации клиента:947 Чтобы зафиксировать только порт обратного вызова и позволить Claude Code зарегистрировать клиента автоматически, установите `callbackPort` самостоятельно:

949 948

950 ```bash theme={null}949 ```bash theme={null}

951 claude mcp add-json my-server \950 claude mcp add-json my-server \

954 </Tab>953 </Tab>

955 954

956 <Tab title="CI / переменная окружения">955 <Tab title="CI / переменная окружения">

957 Установите secret через переменную окружения, чтобы пропустить интерактивное приглашение:956 Установите секрет через переменную окружения, чтобы пропустить интерактивное приглашение:

958 957

959 ```bash theme={null}958 ```bash theme={null}

960 MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \959 MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \

965 </Tabs>964 </Tabs>

966 </Step>965 </Step>

967 966

968 <Step title="Аутентифицируйтесь в Claude Code">967 <Step title="Аутентификация в Claude Code">

969 Запустите `/mcp` в Claude Code и следуйте потоку входа браузера.968 Запустите `/mcp` в Claude Code и следуйте потоку входа браузера.

970 </Step>969 </Step>

971</Steps>970</Steps>

973<Tip>972<Tip>

974 Советы:973 Советы:

975 974

976 * Client secret хранится безопасно в вашей системной связке ключей (macOS) или файле учетных данных, а не в вашей конфигурации975 * Секрет клиента хранится безопасно в цепочке ключей вашей системы (macOS) или файле учетных данных, а не в вашей конфигурации

977 * Вы можете установить client secret только при добавлении server. Когда вы аутентифицируетесь с помощью `claude mcp login` или из `/mcp`, Claude Code использует сохраненный secret и не запрашивает его или не читает `MCP_CLIENT_SECRET`976 * Вы можете установить секрет клиента только при добавлении сервера. Когда вы аутентифицируетесь с помощью `claude mcp login` или из `/mcp`, Claude Code использует сохраненный секрет и не запрашивает его или не читает `MCP_CLIENT_SECRET`

978 * Чтобы добавить или изменить secret позже, удалите server с помощью `claude mcp remove <name>`, затем добавьте его снова с помощью `--client-secret` и той же `--scope`977 * Чтобы позже добавить или изменить секрет, удалите сервер с помощью `claude mcp remove <name>`, затем добавьте его снова с `--client-secret` и той же `--scope`

979 * Если server использует публичный OAuth клиент без secret, используйте только `--client-id` без `--client-secret`978 * Если сервер использует публичный OAuth клиент без секрета, используйте только `--client-id` без `--client-secret`

980 * Эти флаги применяются только к HTTP и SSE транспортам. Они не влияют на stdio servers979 * Эти флаги применяются только к транспортам HTTP и SSE. Они не влияют на серверы stdio

981 * Используйте `claude mcp get <name>` для проверки того, что учетные данные OAuth настроены для server980 * Используйте `claude mcp get <name>` для проверки того, что учетные данные OAuth настроены для сервера

982</Tip>981</Tip>

983 982

984<h3 id="override-oauth-metadata-discovery">983<h3 id="override-oauth-metadata-discovery">

985 Переопределите обнаружение метаданных OAuth984 Переопределите обнаружение метаданных OAuth

986</h3>985</h3>

987 986

988Укажите Claude Code на конкретный URL метаданных сервера авторизации OAuth, чтобы обойти цепочку обнаружения по умолчанию. Установите `authServerMetadataUrl`, когда стандартные конечные точки MCP server выдают ошибку, или когда вы хотите направить обнаружение через внутренний прокси. По умолчанию Claude Code сначала проверяет метаданные защищенного ресурса RFC 9728 на `/.well-known/oauth-protected-resource`, затем возвращается к метаданным сервера авторизации RFC 8414 на `/.well-known/oauth-authorization-server`.987Укажите Claude Code на определенный URL метаданных сервера авторизации OAuth, чтобы обойти цепочку обнаружения по умолчанию. Установите `authServerMetadataUrl`, когда стандартные конечные точки MCP сервера выдают ошибки, или когда вы хотите маршрутизировать обнаружение через внутренний прокси. По умолчанию Claude Code сначала проверяет RFC 9728 Protected Resource Metadata на `/.well-known/oauth-protected-resource`, затем возвращается к RFC 8414 authorization server metadata на `/.well-known/oauth-authorization-server`.

989 988

990Установите `authServerMetadataUrl` в объекте `oauth` конфигурации вашего server в `.mcp.json`:989Установите `authServerMetadataUrl` в объекте `oauth` конфигурации вашего сервера в `.mcp.json`:

991 990

992```json theme={null}991```json theme={null}

993{992{

1003}1002}

1004```1003```

1005 1004

1006URL должен использовать `https://`. `scopes_supported` URL метаданных переопределяет области, которые объявляет upstream server.1005URL должен использовать `https://`. `scopes_supported` URL метаданных переопределяет области, которые объявляет вышестоящий сервер.

1007 1006

1008<h3 id="restrict-oauth-scopes">1007<h3 id="restrict-oauth-scopes">

1009 Ограничьте области OAuth1008 Ограничьте области OAuth

1010</h3>1009</h3>

1011 1010

1012Установите `oauth.scopes` для фиксации областей, которые Claude Code запрашивает во время потока авторизации. Это поддерживаемый способ ограничить MCP server подмножеством, одобренным командой безопасности, когда upstream сервер авторизации объявляет больше областей, чем вы хотите предоставить. Значение — это одна строка, разделенная пробелами, соответствующая формату параметра `scope` в RFC 6749 §3.3.1011Установите `oauth.scopes`, чтобы зафиксировать области, которые Claude Code запрашивает во время потока авторизации. Это поддерживаемый способ ограничить MCP сервер подмножеством, одобренным командой безопасности, когда вышестоящий сервер авторизации объявляет больше областей, чем вы хотите предоставить. Значение — это одна строка с разделением пробелами, соответствующая формату параметра `scope` в RFC 6749 §3.3.

1013 1012

1014```json theme={null}1013```json theme={null}

1015{1014{

1025}1024}

1026```1025```

1027 1026

1028`oauth.scopes` имеет приоритет над `authServerMetadataUrl` и областями, которые server обнаруживает на `/.well-known`. Оставьте его неустановленным, чтобы позволить MCP server определить запрашиваемый набор областей.1027`oauth.scopes` имеет приоритет над `authServerMetadataUrl` и областями, которые сервер обнаруживает на `/.well-known`. Оставьте его неустановленным, чтобы позволить MCP серверу определить запрашиваемый набор областей.

1029 1028

1030Начиная с v2.1.196, когда `oauth.scopes` не установлен, Claude Code запрашивает область, предоставленную заголовком `WWW-Authenticate` server или его метаданными защищенного ресурса, и не отправляет параметр `scope`, когда ни один из них не предоставляет его. Он больше не запрашивает полный каталог `scopes_supported` из автоматически обнаруженных метаданных сервера авторизации. Запрос этого каталога заставил поставщиков идентификации, которые объявляют области только для администраторов или шаблонов, отклонить запрос авторизации с ошибкой `invalid_scope`. Метаданные, полученные из настроенного `authServerMetadataUrl`, по-прежнему предоставляют свой `scopes_supported` как запрашиваемые области.1029Начиная с v2.1.196, когда `oauth.scopes` не установлен, Claude Code запрашивает область, предоставленную заголовком `WWW-Authenticate` сервера или его метаданными защищенного ресурса, и не отправляет параметр `scope`, когда ни один из них не предоставляет его. Он больше не запрашивает полный каталог `scopes_supported` из автоматически обнаруженных метаданных сервера авторизации. Запрос этого каталога заставлял поставщиков идентификации, которые объявляют области только для администраторов или шаблонов, отклонять запрос авторизации с ошибкой `invalid_scope`. Метаданные, полученные из настроенного `authServerMetadataUrl`, по-прежнему предоставляют свой `scopes_supported` как запрашиваемые области.

1031 1030

1032Если сервер авторизации объявляет `offline_access` в `scopes_supported`, Claude Code добавляет его к фиксированным областям, чтобы токен доступа мог быть обновлен без нового входа в браузер.1031Если сервер авторизации объявляет `offline_access` в `scopes_supported`, Claude Code добавляет его к зафиксированным областям, чтобы токен доступа можно было обновить без нового входа в браузер.

1033 1032

1034Если server позже возвращает 403 `insufficient_scope` для вызова инструмента, вызов не удается с сообщением [`needs additional permissions`](/docs/ru/errors#mcp-server-needs-you-to-sign-in-again), которое называет область, которую запрашивает server. Server показывается как требующий аутентификации в `/mcp`.1033Если сервер позже возвращает 403 `insufficient_scope` для вызова инструмента, вызов не удается с сообщением [`needs additional permissions`](/docs/ru/errors#mcp-server-needs-you-to-sign-in-again), которое называет область, которую запрашивает сервер. Сервер показывается как требующий аутентификации в `/mcp`.

1035 1034

1036Если эта область не находится в вашем фиксированном `oauth.scopes`, добавьте ее, затем запустите `/mcp` и аутентифицируйте server снова. Claude Code запрашивает фиксированные области, а не область, которую назвал server, поэтому если вы аутентифицируетесь снова без добавления ее, токен, который вы получите, по-прежнему ей не хватает.1035Если эта область не находится в вашем зафиксированном `oauth.scopes`, добавьте ее, затем запустите `/mcp` и аутентифицируйте сервер снова. Claude Code запрашивает зафиксированные области, а не область, которую назвал сервер, поэтому если вы аутентифицируетесь снова без добавления ее, токен, который вы получаете, по-прежнему ей не хватает.

1037 1036

1038<h3 id="use-dynamic-headers-for-custom-authentication">1037<h3 id="use-dynamic-headers-for-custom-authentication">

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

1040</h3>1039</h3>

1041 1040

1042Если ваш MCP server использует схему аутентификации, отличную от OAuth (такую как Kerberos, краткосрочные токены или внутреннее SSO), используйте `headersHelper` для генерации заголовков запроса во время подключения. Claude Code запускает команду и объединяет ее выход в заголовки подключения.1041Если ваш MCP сервер использует схему аутентификации, отличную от OAuth, такую как Kerberos, краткосрочные токены или внутреннее SSO, используйте `headersHelper` для генерации заголовков запроса во время подключения. Claude Code запускает команду и объединяет ее вывод в заголовки соединения.

1043 1042

1044```json theme={null}1043```json theme={null}

1045{1044{

1071 1070

1072* Команда должна записать объект JSON пар строк ключ-значение в stdout1071* Команда должна записать объект JSON пар строк ключ-значение в stdout

1073* Claude Code запускает команду в оболочке и отказывается от нее через 10 секунд1072* Claude Code запускает команду в оболочке и отказывается от нее через 10 секунд

1074* Claude Code выбирает рабочий каталог команды по [месту, где вы настроили server](#where-the-helper-runs), поэтому дайте скрипт как абсолютный путь или поместите его на `PATH`1073* Claude Code выбирает рабочий каталог команды по [месту, где вы настроили сервер](#where-the-helper-runs), поэтому дайте скрипт как абсолютный путь или поместите его на `PATH`

1075* Динамические заголовки переопределяют любые статические `headers` с тем же именем1074* Динамические заголовки переопределяют любые статические `headers` с тем же именем

1076 1075

1077Claude Code запускает помощника заново при каждом подключении, при запуске сеанса и при переподключении, как только [правило доверия для servers проекта и локальной области](#trust-a-folder-before-its-headershelper-runs) позволяет ему запуститься. Он не кэширует результат, поэтому ваш скрипт отвечает за любое повторное использование токена.1076Claude Code запускает помощника заново при каждом подключении, при запуске сеанса и при переподключении, как только [правило доверия для серверов области проекта и локальной области](#trust-a-folder-before-its-headershelper-runs) позволяет ему запуститься. Он не кэширует результат, поэтому ваш скрипт отвечает за любое повторное использование токена.

1078 1077

1079Если вызов инструмента возвращает `401 Unauthorized` или `403 Forbidden`, Claude Code автоматически повторно запускает помощника под тем же правилом, переподключается со свежими заголовками и повторяет вызов один раз. Claude Code отмечает server как требующий аутентификации в `/mcp` только если этот повторный вызов также не удается.1078Если вызов инструмента возвращает `401 Unauthorized` или `403 Forbidden`, Claude Code автоматически повторно запускает помощника под тем же правилом, переподключается со свежими заголовками и повторяет вызов один раз. Claude Code помечает сервер как требующий аутентификации в `/mcp` только если этот повтор также не удается.

1080 1079

1081Когда выход помощника включает заголовок `Authorization`, Claude Code использует это учетное данные как аутентификацию server и не возвращается к OAuth для server.1080Когда вывод помощника включает заголовок `Authorization`, Claude Code использует это учетное данное как аутентификацию сервера и не возвращается к OAuth для сервера.

1082 1081

1083Если server отклоняет учетное данные помощника при подключении, Claude Code сообщает о соединении как о неудачном, а не отмечает server как требующий аутентификации. Исправьте учетное данные, которое возвращает ваш помощник, затем переподключитесь из `/mcp` для повторного запуска помощника.1082Если сервер отклоняет учетное данное помощника при подключении, Claude Code сообщает о неудачном соединении, а не помечает сервер как требующий аутентификации. Исправьте учетное данное, которое возвращает ваш помощник, затем переподключитесь из `/mcp`, чтобы повторно запустить помощника.

1084 1083

1085Claude Code устанавливает эти переменные окружения при выполнении помощника:1084Claude Code устанавливает эти переменные окружения при выполнении помощника:

1086 1085

1087| Переменная | Значение |1086| Переменная | Значение |

1088| :- | :- |1087| :- | :- |

1091| `CLAUDE_PLUGIN_ROOT` | корневой каталог плагина. Установлено только когда [плагин](/docs/ru/plugins/components#mcp-servers) предоставляет server |1090| `CLAUDE_PLUGIN_ROOT` | корневой каталог плагина. Установлено только когда [плагин](/docs/ru/plugins/components#mcp-servers) предоставляет сервер |

1092 1091

1093Используйте их для написания одного скрипта помощника, который служит нескольким MCP servers.1092Используйте их для написания одного скрипта помощника, который служит нескольким MCP серверам.

1094 1093

1095Помощник `headersHelper`, предоставленный плагином, не может ссылаться на значения [`${user_config.*}`](/docs/ru/plugins/manifest-reference#user-configuration) плагина, потому что команда запускается через оболочку. Claude Code сообщает о server как о неправильно настроенном с [ошибкой](/docs/ru/errors#plugin-command-references-user-config) и не подставляет значение. Поместите `${user_config.KEY}` в поле `headers` server вместо этого, которое не анализируется оболочкой, или попросите скрипт помощника прочитать значение из файла конфигурации. До v2.1.207 `headersHelper` подставлял значения `${user_config.*}`.1094Предоставленный плагином `headersHelper` не может ссылаться на значения [`${user_config.*}`](/docs/ru/plugins/manifest-reference#user-configuration) плагина, потому что команда запускается через оболочку. Claude Code сообщает о неправильной конфигурации сервера с [ошибкой](/docs/ru/errors#plugin-command-references-user-config) и не подставляет значение. Поместите `${user_config.KEY}` в поле `headers` сервера вместо этого, которое не анализируется оболочкой, или попросите скрипт помощника прочитать значение из файла конфигурации. До v2.1.207 `headersHelper` подставлял значения `${user_config.*}`.

1096 1095

1097<h4 id="where-the-helper-runs">1096<h4 id="where-the-helper-runs">

1098 Где запускается помощник1097 Где запускается помощник

1099</h4>1098</h4>

1100 1099

1101Claude Code выбирает рабочий каталог команды `headersHelper` из конфигурации, которая объявляет server. `cd`, который Claude запускает в Bash, не перемещает его, и [`/cd`](/docs/ru/permissions#move-the-session-to-another-directory) перемещает его только для servers, которые запускаются из основного рабочего каталога сеанса. Каждая строка ниже дает каталог, в котором относительный путь в вашей команде `headersHelper` разрешается.1100Claude Code выбирает рабочий каталог команды `headersHelper` из конфигурации, которая объявляет сервер. `cd`, который Claude запускает в Bash, не перемещает его, и [`/cd`](/docs/ru/permissions#move-the-session-to-another-directory) перемещает его только для серверов, которые запускаются из основного рабочего каталога сеанса. Каждая строка ниже дает каталог, в котором относительный путь в вашей команде `headersHelper` разрешается.

1102 1101

1103| Где вы настроили server | Рабочий каталог |1102| Где вы настроили сервер | Рабочий каталог |

1104| :- | :- |1103| :- | :- |

1105| [Плагин](/docs/ru/plugins/components#mcp-servers) | Корневой каталог плагина. Требует Claude Code v2.1.195 или позже |1104| [Плагин](/docs/ru/plugins/components#mcp-servers) | Корневой каталог плагина. Требует Claude Code v2.1.195 или позже |

1107| Файл агента в вашем проекте, server из опции `mcpServers` SDK или метода `setMcpServers()`, или [`--mcp-config`](/docs/ru/cli-reference) | [Основной рабочий каталог](/docs/ru/permissions#working-directories) сеанса |1106| Файл агента в вашем проекте, сервер из опции `mcpServers` SDK или метода `setMcpServers()`, или [`--mcp-config`](/docs/ru/cli-reference) | [Основной рабочий каталог](/docs/ru/permissions#working-directories) сеанса |

1108| [Область пользователя](#user-scope), [управляемый MCP](/docs/ru/managed-mcp), [разъем claude.ai](#use-mcp-servers-from-claude-ai), или файл агента из вне вашего проекта, включая один из каталога `--add-dir` | Ваш каталог конфигурации, `~/.claude` если вы не установили [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars) |1107| [Область пользователя](#user-scope), [управляемый MCP](/docs/ru/managed-mcp), [коннектор claude.ai](#use-mcp-servers-from-claude-ai), или файл агента из вне вашего проекта, включая один из каталога `--add-dir` | Ваш каталог конфигурации, `~/.claude` если вы не установили [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars) |

1109 1108

1110До v2.1.238 Claude Code также запускал помощников servers пользовательской области, управляемых и разъемов claude.ai, и файлов агентов из вне вашего проекта из каталога, в котором вы его запустили.1109До v2.1.238 Claude Code также запускал помощников серверов области пользователя, управляемых и коннекторов claude.ai, и файлов агентов из вне вашего проекта, из каталога, в котором вы его запустили.

1111 1110

1112<h4 id="which-variables-a-helper-can-read">1111<h4 id="which-variables-a-helper-can-read">

1113 Какие переменные может читать помощник1112 Какие переменные может читать помощник

1114</h4>1113</h4>

1115 1114

1116`headersHelper`, который предоставляет репозиторий или плагин, — это команда, которую вы не писали, поэтому Claude Code запускает ее без переменных учетных данных из вашего окружения, таких как `ANTHROPIC_API_KEY`. Место, где вы настроили server, определяет, применяется ли это:1115`headersHelper`, который поставляет репозиторий или плагин, — это команда, которую вы не писали, поэтому Claude Code запускает ее без переменных учетных данных из вашей среды, таких как `ANTHROPIC_API_KEY`. Место, где вы настроили сервер, определяет, применяется ли это:

1117 1116

1118* **Удалено**: server в проекте `.mcp.json` или в плагине, и встроенный server в файле агента из вашего проекта или из каталога `--add-dir`1117* **Удалено**: сервер в проекте `.mcp.json` или в плагине, и встроенный сервер в файле агента из вашего проекта или из каталога `--add-dir`

1119* **Не удалено**: server в [пользовательской](#user-scope) или [локальной области](#local-scope), в [управляемом MCP](/docs/ru/managed-mcp), из [разъема claude.ai](#use-mcp-servers-from-claude-ai), или предоставленный SDK или [`--mcp-config`](/docs/ru/cli-reference), и встроенный server в файле агента из `~/.claude/agents/`, из управляемых параметров или переданный с `--agents`1118* **Не удалено**: сервер в [области пользователя](#user-scope) или [локальной области](#local-scope), в [управляемом MCP](/docs/ru/managed-mcp), из [коннектора claude.ai](#use-mcp-servers-from-claude-ai), или предоставленный SDK или [`--mcp-config`](/docs/ru/cli-reference), и встроенный сервер в файле агента из `~/.claude/agents/`, из управляемых параметров или переданный с `--agents`

1120 1119

1121Помимо переменных `GIT_CONFIG_KEY_<n>` Git, Claude Code удаляет каждую переменную из вашего окружения, чье имя выглядит как учетное данные, такое как имя с `TOKEN`, `SECRET`, `PASSWORD`, `KEY` или `AUTH` в нем в любом регистре, поэтому `ANTHROPIC_API_KEY` и `MY_REGISTRY_TOKEN` оба удаляются. Claude Code также удаляет фиксированный список переменных учетных данных, чьи имена не следуют этому шаблону, такие как `ANTHROPIC_CUSTOM_HEADERS`.1120Помимо переменных `GIT_CONFIG_KEY_<n>` Git, Claude Code удаляет каждую переменную из вашей среды, чье имя выглядит как учетное данное, такое как имя с `TOKEN`, `SECRET`, `PASSWORD`, `KEY` или `AUTH` в нем в любом регистре, поэтому `ANTHROPIC_API_KEY` и `MY_REGISTRY_TOKEN` оба удаляются. Claude Code также удаляет фиксированный список переменных учетных данных, чьи имена не следуют этому шаблону, такие как `ANTHROPIC_CUSTOM_HEADERS`.

1122 1121

1123Когда это применяется к вашему помощнику, попросите скрипт прочитать его учетное данные из файла или хранилища учетных данных. Если `url` server [расширяет одну из этих переменных](#environment-variable-expansion-in-mcp-json), значение `CLAUDE_CODE_MCP_SERVER_URL`, которое получает помощник, имеет эту часть заменена на `REDACTED` также.1122Когда это применяется к вашему помощнику, попросите скрипт прочитать его учетное данные из файла или хранилища учетных данных. Если URL сервера [несет живое значение одной из этих переменных](#environment-variable-expansion-in-mcp-json), такой как `MY_REGISTRY_TOKEN`, значение `CLAUDE_CODE_MCP_SERVER_URL`, которое получает помощник, имеет эту часть заменена на `REDACTED` также.

1124 1123

1125<h4 id="trust-a-folder-before-its-headershelper-runs">1124<h4 id="trust-a-folder-before-its-headershelper-runs">

1126 Доверьте папке перед запуском ее headersHelper1125 Доверьте папку перед запуском ее headersHelper

1127</h4>1126</h4>

1128 1127

1129Claude Code выполняет `headersHelper` как произвольную команду оболочки. Для server в проекте `.mcp.json` или в [локальной области](#local-scope), он запускает помощника только после того, как вы примете [диалог доверия](/docs/ru/permissions#project-allow-rules-and-workspace-trust) для каталога проекта, в котором объявлен server. До v2.1.238 сеанс `claude -p` или SDK запускал этих помощников без проверки доверия, и интерактивный сеанс запускал их после того, как вы доверили родительской папке.1128Claude Code выполняет `headersHelper` как произвольную команду оболочки. Для сервера в проекте `.mcp.json` или в [локальной области](#local-scope), он запускает помощника только после того, как вы примете [диалог доверия](/docs/ru/permissions#project-allow-rules-and-workspace-trust) для каталога проекта, в котором объявлен сервер. До v2.1.238 сеанс `claude -p` или SDK запускал этих помощников без проверки доверия, и интерактивный сеанс запускал их один раз, когда вы доверили родительской папке.

1130 1129

1131* **Доверие, которое не считается**: доверие родительской папки и автоматическое доверие, которое получает сеанс `claude -p` или SDK для [hooks в файлах параметров](/docs/ru/permissions#what-runs-before-you-trust-a-folder)1130* **Доверие, которое не считается**: доверие родительской папки и автоматическое доверие, которое получает сеанс `claude -p` или SDK для [hooks в файлах параметров](/docs/ru/permissions#what-runs-before-you-trust-a-folder)

1132* **До тех пор, пока вы не доверите папке**: Claude Code подключает server только с его статическими `headers`. В сеансе `claude -p` или SDK он также выводит одну строку [`headersHelper not run`](/docs/ru/errors#headershelper-not-run) на stderr, сообщая вам, как предоставить доверие.1131* **Пока вы не доверите папке**: Claude Code подключает сервер только с его статическими `headers`. В сеансе `claude -p` или SDK он также выводит одну строку [`headersHelper not run`](/docs/ru/errors#headershelper-not-run) на stderr, сообщая вам, как предоставить доверие.

1133* **Доверие без диалога**: установите `projects["<path>"].hasTrustDialogAccepted` на `true` в `~/.claude.json`. `<path>` — это папка, на которой [Project allow rules and workspace trust](/docs/ru/permissions#project-allow-rules-and-workspace-trust) говорит Claude Code ключ доверия.1132* **Доверие без диалога**: установите `projects["<path>"].hasTrustDialogAccepted` на `true` в `~/.claude.json`. `<path>` — это папка, на которой [Project allow rules and workspace trust](/docs/ru/permissions#project-allow-rules-and-workspace-trust) говорит Claude Code ключ доверия.

1134 1133

1135Claude Code применяет то же правило к server, объявленному встроенным в [файл агента](/docs/ru/sub-agents#scope-mcp-servers-to-a-subagent), проверяя, откуда этот файл агента пришел: ваш проект, для файла в его каталоге `.claude/agents/`, или каталог `--add-dir`. До тех пор, пока вы не [доверите этому проекту или каталогу самому](/docs/ru/permissions#what-runs-before-you-trust-a-folder), Claude Code не загружает server вообще, поэтому его помощник никогда не запускается либо.1134Claude Code применяет то же правило к серверу, объявленному встроенным в [файл агента](/docs/ru/sub-agents#scope-mcp-servers-to-a-subagent), проверяя, откуда этот файл агента пришел: ваш проект, для файла в его каталоге `.claude/agents/`, или каталог `--add-dir`. Пока вы не [доверите этому проекту или каталогу самому](/docs/ru/permissions#what-runs-before-you-trust-a-folder), Claude Code не загружает сервер вообще, поэтому его помощник никогда не запускается либо.

1136 1135

1137<h2 id="add-mcp-servers-from-json-configuration">1136<h2 id="add-mcp-servers-from-json-configuration">

1138 Добавьте MCP servers из конфигурации JSON1137 Добавьте MCP servers из конфигурации JSON

1235 </Step>1234 </Step>

1236</Steps>1235</Steps>

1237 1236

1237Anthropic также предоставляет некоторые connectors самостоятельно, без добавления вами или администратором. На учётных записях, где доступны [Claude Docs](/docs/ru/artifacts#write-a-document-with-claude-docs), `/mcp` отображает `claude.ai Claude Docs` без настройки, и Claude использует его, когда вы просите документ, предназначенный для других людей. Чтобы отключить его, добавьте запись `serverName` со значением `"claude.ai Claude Docs"` в `deniedMcpServers` или используйте переключатель `/mcp`, оба описаны в разделе [Отключение connectors claude.ai](#disable-claude-ai-connectors).

1238

1238Claude Code помечает connector как `managed` в `/mcp` и в менеджере [`/plugin`](/docs/ru/plugins/install) когда ваша организация управляет его аутентификацией в claude.ai. Статус managed не изменяет способ подключения Claude Code к connector или применение [инструментов управления](#organization-controls-on-connector-tools) вашей организации.1239Claude Code помечает connector как `managed` в `/mcp` и в менеджере [`/plugin`](/docs/ru/plugins/install) когда ваша организация управляет его аутентификацией в claude.ai. Статус managed не изменяет способ подключения Claude Code к connector или применение [инструментов управления](#organization-controls-on-connector-tools) вашей организации.

1239 1240

1240Connectors, в которые вы никогда не входили, свёрнуты за строкой `Show unused connectors` в конце раздела claude.ai, поэтому список, предоставленный организацией, не заполняет панель. Выберите строку, чтобы развернуть их. Connector, в который вы входили ранее, остаётся видимым даже если в настоящий момент требуется повторная аутентификация.1241Connectors, в которые вы никогда не входили, свёрнуты за строкой `Show unused connectors` в конце раздела claude.ai, поэтому список, предоставленный организацией, не заполняет панель. Выберите строку, чтобы развернуть их. Connector, в который вы входили ранее, остаётся видимым даже если в настоящий момент требуется повторная аутентификация.

1250 1251

1251Если временная проблема с сетью препятствует загрузке списка connectors при запуске сеанса, Claude Code повторяет попытку загрузки до трёх раз в фоновом режиме, и connectors появляются после успешной повторной попытки. Если они всё ещё не появились, перезагрузите Claude Code, чтобы загрузить список снова.1252Если временная проблема с сетью препятствует загрузке списка connectors при запуске сеанса, Claude Code повторяет попытку загрузки до трёх раз в фоновом режиме, и connectors появляются после успешной повторной попытки. Если они всё ещё не появились, перезагрузите Claude Code, чтобы загрузить список снова.

1252 1253

1253Если `/mcp` показывает connector как `connected · session token rejected` или его подробное представление показывает [`claude.ai rejected the session token`](/docs/ru/errors#claude-ai-rejected-the-session-token), claude.ai отклонил токен из вашего входа в Claude Code, обычно потому что вход истёк и не мог быть обновлён. Повторная авторизация connector не очищает это состояние, потому что собственная авторизация connector в claude.ai — это не то, что было отклонено. Чтобы очистить это:1254Если `/mcp` показывает connector как `session token rejected`, или его подробное представление показывает [`claude.ai rejected the session token`](/docs/ru/errors#claude-ai-rejected-the-session-token), claude.ai отклонил токен из вашего входа в Claude Code. Повторная авторизация connector не очищает это состояние, потому что собственная авторизация connector в claude.ai — это не то, что было отклонено. Чтобы очистить это:

1254 1255

12551. Запустите `/login`, чтобы войти снова.12561. Запустите `/login`, чтобы войти снова.

12562. Переподключите connector из `/mcp`.12572. Переподключите connector из `/mcp`.

1416 Если вы часто сталкиваетесь с предупреждениями о выходных данных с конкретными серверами MCP, которыми вы не управляете, рассмотрите возможность увеличения лимита `MAX_MCP_OUTPUT_TOKENS`. Вы также можете попросить автора сервера добавить аннотацию `anthropic/maxResultSizeChars` или разбить свои ответы на страницы. Аннотация не влияет на инструменты, которые возвращают содержимое изображений; для них единственный вариант — повысить `MAX_MCP_OUTPUT_TOKENS`.1417 Если вы часто сталкиваетесь с предупреждениями о выходных данных с конкретными серверами MCP, которыми вы не управляете, рассмотрите возможность увеличения лимита `MAX_MCP_OUTPUT_TOKENS`. Вы также можете попросить автора сервера добавить аннотацию `anthropic/maxResultSizeChars` или разбить свои ответы на страницы. Аннотация не влияет на инструменты, которые возвращают содержимое изображений; для них единственный вариант — повысить `MAX_MCP_OUTPUT_TOKENS`.

1417</Warning>1418</Warning>

1418 1419

1420<h3 id="images-in-tool-results">

1421 Изображения в результатах инструментов

1422</h3>

1423

1424Когда инструмент MCP возвращает изображение PNG, JPEG, GIF или WebP, Claude видит изображение встроенным в разговор. Встроенная копия может быть уменьшена или сжата, чтобы соответствовать ограничениям размера изображения модели. Claude Code также сохраняет исходные байты в файл в директории `tool-results` сеанса в [`~/.claude/projects/`](/docs/ru/claude-directory#cleaned-up-automatically) и предоставляет Claude путь к файлу. Claude затем может обрезать, конвертировать или повторно использовать полнофункциональный файл с помощью инструментов, таких как Bash.

1425

1426Если вы отключите сохранение сеанса с помощью [`--no-session-persistence`](/docs/ru/cli-reference#cli-flags) или [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars), Claude Code не будет записывать файл изображения, и Claude получит только встроенную копию.

1427

1428Сохранение результатов изображений MCP в файл требует Claude Code версии 2.1.283 или более поздней.

1429

1419<h2 id="tool-input-schemas-with-a-root-level-combinator">1430<h2 id="tool-input-schemas-with-a-root-level-combinator">

1420 Схемы входных данных инструментов с комбинатором корневого уровня1431 Схемы входных данных инструментов с комбинатором корневого уровня

1421</h2>1432</h2>

1487Серверы могут запрашивать ввод двумя способами:1498Серверы могут запрашивать ввод двумя способами:

1488 1499

1489* **Режим формы**: Claude Code показывает диалог с полями формы, определенными сервером (например, запрос имени пользователя и пароля). Заполните поля и отправьте.1500* **Режим формы**: Claude Code показывает диалог с полями формы, определенными сервером (например, запрос имени пользователя и пароля). Заполните поля и отправьте.

1490* **Режим URL**: Claude Code открывает URL браузера для аутентификации или одобрения. Завершите процесс в браузере, затем подтвердите в CLI.1501* **Режим URL**: Claude Code спрашивает, открыть ли ссылку в вашем браузере, и открывает её при вашем согласии. Серверы используют этот режим для потока, который завершается вне терминала, например для входа в систему.

1491 1502

1492В режиме URL Claude Code передает URL в качестве аргумента командной строки обработчику URL вашей системы и ограничивает длину этого аргумента. Когда URL, после экранирования для командной строки, превышает это ограничение, вы можете только отклонить запрос. Каждый символ, который требует экранирования, такой как `%` или `&`, считается четыре раза в сторону ограничения: сам символ плюс три символа экранирования. URL без них достигает ограничения примерно на 8000 символов. URL, построенный в основном из процентных экранирований, где каждый третий символ — это `%`, достигает его примерно на 4000.1503В режиме URL Claude Code передает URL в качестве аргумента командной строки обработчику URL вашей системы и ограничивает длину этого аргумента. Когда URL, после экранирования для командной строки, превышает это ограничение, вы можете только отклонить запрос. Каждый символ, который требует экранирования, такой как `%` или `&`, считается четыре раза в сторону ограничения: сам символ плюс три символа экранирования. URL без них достигает ограничения примерно на 8000 символов. URL, построенный в основном из процентных экранирований, где каждый третий символ — это `%`, достигает его примерно на 4000.

1493 1504

1495 1506

1496Если вы создаете MCP сервер, который использует elicitation, см. [спецификацию MCP elicitation](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) для деталей протокола и примеров схемы.1507Если вы создаете MCP сервер, который использует elicitation, см. [спецификацию MCP elicitation](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) для деталей протокола и примеров схемы.

1497 1508

1509На соединениях, которые используют [revision протокола 2026-07-28](#mcp-client-runtimes), Claude Code объявляет `elicitation: {form: {}, url: {}}` в своих возможностях клиента, поэтому сервер там может запросить любой режим через стандартный запрос elicitation протокола.

1510

1498<h2 id="use-mcp-resources">1511<h2 id="use-mcp-resources">

1499 Использование ресурсов MCP1512 Использование ресурсов MCP

1500</h2>1513</h2>

1540 * Ресурсы могут содержать любой тип контента, который предоставляет сервер MCP (текст, JSON, структурированные данные и т. д.)1553 * Ресурсы могут содержать любой тип контента, который предоставляет сервер MCP (текст, JSON, структурированные данные и т. д.)

1541</Tip>1554</Tip>

1542 1555

1556Ресурсы MCP Apps UI — это записи с URI `ui://` или типом мультимедиа `text/html;profile=mcp-app`: страницы для отображения хост-приложением, а не контент для чтения Claude. Они не отображаются в предложениях `@` или в результатах инструмента списка ресурсов, и сервер, предлагающий только ресурсы UI, показывает пустой список ресурсов. Чтение ресурса UI по его URI по-прежнему работает.

1557

1543<h2 id="scale-with-mcp-tool-search">1558<h2 id="scale-with-mcp-tool-search">

1544 Масштабирование с помощью поиска инструментов MCP1559 Масштабирование с помощью поиска инструментов MCP

1545</h2>1560</h2>

1643 1658

1644MCP серверы могут предоставлять prompts, которые становятся доступными как команды в Claude Code.1659MCP серверы могут предоставлять prompts, которые становятся доступными как команды в Claude Code.

1645 1660

1661Prompts с сервера с именем `anthropic-skills` не отображаются, потому что Claude Code [зарезервировал это имя](/docs/ru/skills#names-reserved-for-synced-skills) для skills, синхронизированных с claude.ai. Инструменты сервера по-прежнему работают. Переименуйте сервер в конфигурации MCP, чтобы отобразить его prompts.

1662

1646<h3 id="execute-mcp-prompts">1663<h3 id="execute-mcp-prompts">

1647 Выполнение MCP prompts1664 Выполнение MCP prompts

1648</h3>1665</h3>

memory.md +9 −0

Details

103 103

104**Согласованность**: если два правила противоречат друг другу, Claude может выбрать одно произвольно. Периодически проверяйте ваши файлы CLAUDE.md, вложенные файлы CLAUDE.md в подкаталогах и [`.claude/rules/`](#organize-rules-with-claude/rules/) для удаления устаревших или конфликтующих инструкций. В монорепозиториях используйте [`claudeMdExcludes`](#exclude-specific-claude-md-files) для пропуска файлов CLAUDE.md от других команд, которые не имеют отношения к вашей работе.104**Согласованность**: если два правила противоречат друг другу, Claude может выбрать одно произвольно. Периодически проверяйте ваши файлы CLAUDE.md, вложенные файлы CLAUDE.md в подкаталогах и [`.claude/rules/`](#organize-rules-with-claude/rules/) для удаления устаревших или конфликтующих инструкций. В монорепозиториях используйте [`claudeMdExcludes`](#exclude-specific-claude-md-files) для пропуска файлов CLAUDE.md от других команд, которые не имеют отношения к вашей работе.

105 105

106Чтобы Claude проверил эти файлы на устаревшие или конфликтующие инструкции, запустите `/doctor prompt-audit` в сессии. Claude читает ваши файлы CLAUDE.md, CLAUDE.local.md и AGENTS.md, а также правила, skills, команды, подагентов и стили вывода в `.claude/` и `~/.claude/`. Он ищет проблемы, такие как инструкции, написанные для более старых моделей, ссылки на файлы или команды, которые не существуют, и файлы, которые противоречат друг другу. Вы получаете отчёт о результатах и набор предложенных правок, и ничего в ваших файлах не изменяется, пока вы не попросите Claude применить их.

107

108Чтобы проверить один файл или каталог вместо этого, передайте его путь, например `/doctor prompt-audit .claude/skills/deploy`. Проверка выполняется через встроенный skill `/claude-api`, поэтому он недоступен, пока этот skill отключён в [`skillOverrides`](/docs/ru/skills#override-skill-visibility-from-settings) или с [`disableBundledSkills`](/docs/ru/settings-reference#disablebundledskills). `/doctor prompt-audit` требует Claude Code v2.1.283 или позже.

109

106<h3 id="import-additional-files">110<h3 id="import-additional-files">

107 Импортируйте дополнительные файлы111 Импортируйте дополнительные файлы

108</h3>112</h3>

273ln -s ~/company-standards/security.md .claude/rules/security.md277ln -s ~/company-standards/security.md .claude/rules/security.md

274```278```

275 279

280Если вы указываете символическую ссылку `.claude/rules/` или `CLAUDE.md` на сетевой путь, такой как UNC-общая папка `\\server\share` или путь в `/net` или `/Network`, связанные инструкции не загружаются. Claude Code не следует по ссылке, потому что поиск такого пути может связаться с хостом, который он называет. Пути `\\wsl$` не считаются сетевыми путями.

281

276<h4 id="user-level-rules">282<h4 id="user-level-rules">

277 Правила уровня пользователя283 Правила уровня пользователя

278</h4>284</h4>

620* Проверьте, что соответствующий CLAUDE.md находится в местоположении, которое загружается для вашего сеанса (см. [Выберите, где разместить файлы CLAUDE.md](#choose-where-to-put-claude-md-files)).626* Проверьте, что соответствующий CLAUDE.md находится в местоположении, которое загружается для вашего сеанса (см. [Выберите, где разместить файлы CLAUDE.md](#choose-where-to-put-claude-md-files)).

621* Сделайте инструкции более конкретными. "Используйте отступ из 2 пробелов" работает лучше, чем "красиво форматируйте код".627* Сделайте инструкции более конкретными. "Используйте отступ из 2 пробелов" работает лучше, чем "красиво форматируйте код".

622* Ищите конфликтующие инструкции в файлах CLAUDE.md. Если два файла дают разные рекомендации для одного поведения, Claude может выбрать одну произвольно.628* Ищите конфликтующие инструкции в файлах CLAUDE.md. Если два файла дают разные рекомендации для одного поведения, Claude может выбрать одну произвольно.

629* Проверьте, конкурирует ли ваша инструкция с рекомендациями, которые Claude Code добавляет самостоятельно. Если ваш CLAUDE.md устанавливает правила коммитов или pull-запросов, отключите встроенные с помощью [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions) и установите текст атрибуции с помощью [`attribution`](/docs/ru/settings-reference#attribution).

623 630

624Если инструкция — это что-то, что должно выполняться в определённый момент, например перед каждым коммитом или после каждого редактирования файла, напишите её как [hook](/docs/ru/hooks-guide). Hooks выполняются как команды shell в фиксированных событиях жизненного цикла и применяются независимо от того, что решит сделать Claude.631Если инструкция — это что-то, что должно выполняться в определённый момент, например перед каждым коммитом или после каждого редактирования файла, напишите её как [hook](/docs/ru/hooks-guide). Hooks выполняются как команды shell в фиксированных событиях жизненного цикла и применяются независимо от того, что решит сделать Claude.

625 632

657 664

658Файлы более 200 строк потребляют больше контекста и могут снизить соблюдение. Claude Code пропускает файл размером более 4 MiB. Используйте [path-scoped rules](#path-specific-rules) для загрузки инструкций только когда Claude работает с соответствующими файлами, или сократите содержимое, которое не требуется в каждом сеансе. Разделение на [`@path` imports](#import-additional-files) помогает организации, но не снижает контекст, так как импортированные файлы загружаются при запуске.665Файлы более 200 строк потребляют больше контекста и могут снизить соблюдение. Claude Code пропускает файл размером более 4 MiB. Используйте [path-scoped rules](#path-specific-rules) для загрузки инструкций только когда Claude работает с соответствующими файлами, или сократите содержимое, которое не требуется в каждом сеансе. Разделение на [`@path` imports](#import-additional-files) помогает организации, но не снижает контекст, так как импортированные файлы загружаются при запуске.

659 666

667Если один из ваших файлов инструкций превышает рекомендуемую длину, вы видите предупреждение при запуске и когда запускаете `/status`. Вы также видите предупреждение, когда файлы, каждый из которых находится в пределах этой длины, в сумме превышают объединённый лимит при запуске сеанса. Каждый CLAUDE.md, файл правил и `@path` импорт считаются отдельным файлом.

668

660Проверка [`/doctor`](/docs/ru/commands#all-commands) предлагает сокращения для проверенного CLAUDE.md: она удаляет содержимое, которое Claude может вывести из кодовой базы, такое как макеты каталогов, списки зависимостей и обзоры архитектуры, и сохраняет подводные камни, обоснование и соглашения, которые отличаются от стандартных инструментов. Проверка сокращения требует Claude Code v2.1.206 или более поздней версии.669Проверка [`/doctor`](/docs/ru/commands#all-commands) предлагает сокращения для проверенного CLAUDE.md: она удаляет содержимое, которое Claude может вывести из кодовой базы, такое как макеты каталогов, списки зависимостей и обзоры архитектуры, и сохраняет подводные камни, обоснование и соглашения, которые отличаются от стандартных инструментов. Проверка сокращения требует Claude Code v2.1.206 или более поздней версии.

661 670

662<h3 id="instructions-seem-lost-after-/compact">671<h3 id="instructions-seem-lost-after-/compact">

mobile.md +1 −1

Details

44| :- | :- | :- |44| :- | :- | :- |

45| [Cloud sessions](/docs/ru/claude-code-on-the-web) | Сеанс на облачной инфраструктуре, управляемой Anthropic по умолчанию | Ваш репозиторий находится на GitHub и задача должна продолжаться после того, как вы отложите телефон. См. [краткое руководство веб-версии](/docs/ru/web-quickstart) для настройки. |45| [Cloud sessions](/docs/ru/claude-code-on-the-web) | Сеанс на облачной инфраструктуре, управляемой Anthropic по умолчанию | Ваш репозиторий находится на GitHub и задача должна продолжаться после того, как вы отложите телефон. См. [краткое руководство веб-версии](/docs/ru/web-quickstart) для настройки. |

46| [Projects](/docs/ru/claude-projects) | Беседа, в которой Claude координирует параллельные облачные сеансы как потоки | У вас есть поток связанной работы, а не одна задача, и вы хотите увидеть, какие потоки завершены или требуют вас. |46| [Projects](/docs/ru/claude-projects) | Беседа, в которой Claude координирует параллельные потоки работы и отчитывается | У вас есть поток связанной работы, а не одна задача, и вы хотите увидеть, какие потоки завершены или требуют вас. |

48| [Dispatch](/docs/ru/desktop#sessions-from-dispatch) | Приложение Desktop на вашем компьютере | Вы хотите отправить задачу и позволить Dispatch решить, как её запустить. Требуется план Pro или Max. |48| [Dispatch](/docs/ru/desktop#sessions-from-dispatch) | Приложение Desktop на вашем компьютере | Вы хотите отправить задачу и позволить Dispatch решить, как её запустить. Требуется план Pro или Max. |

49 49

model-config.md +176 −102

Details

29 Псевдонимы моделей29 Псевдонимы моделей

30</h3>30</h3>

31 31

32Используйте псевдоним модели для выбора параметров модели без необходимости помнить точные номера версий:32Используйте псевдоним модели для выбора параметров модели без необходимости запоминать точные номера версий:

33 33

34| Псевдоним модели | Поведение |34| Псевдоним модели | Поведение |

35| - | - |35| - | - |

36| **`default`** | Специальное значение, которое очищает любое переопределение модели и возвращается к [стандартной модели для вашей учётной записи](#default-model-setting). Сам по себе не является псевдонимом модели |36| **`default`** | Специальное значение, которое очищает любое переопределение модели и возвращается к [стандартной модели для вашей учётной записи](#default-model-setting). Сам по себе не является псевдонимом модели |

37| **`best`** | Использует модель, на которую разрешается [псевдоним `fable`](#fable-alias-resolution), если Fable доступна для вас, в противном случае ту же модель, что и `opus` |37| **`best`** | Использует модель, на которую разрешается [псевдоним `fable`](#fable-alias-resolution), где Fable доступна вам, в противном случае ту же модель, что и `opus` |

38| **`fable`** | Использует [модель Fable для вашего поставщика](#fable-alias-resolution) для ваших самых сложных и долгоживущих задач |38| **`fable`** | Использует [модель Fable для вашего поставщика](#fable-alias-resolution) для ваших самых сложных и долгоживущих задач |

39| **`sonnet`** | Использует последнюю модель Sonnet для ежедневных задач кодирования |39| **`sonnet`** | Использует последнюю модель Sonnet для ежедневных задач кодирования |

40| **`opus`** | Использует последнюю модель Opus для сложных задач рассуждения |40| **`opus`** | Использует последнюю модель Opus для сложных задач рассуждения |

41| **`haiku`** | Использует быструю и эффективную модель Haiku для простых задач |41| **`haiku`** | Использует быструю и эффективную модель Haiku для простых задач |

42| **`sonnet[1m]`** | Использует Sonnet с [окном контекста в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов. Не имеет эффекта, когда `sonnet` уже разрешается на Sonnet 5 с его встроенным окном 1M; за [шлюзом LLM](/docs/ru/llm-gateway) выбирает окно 1M для Sonnet 5 |42| **`sonnet[1m]`** | Использует Sonnet с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов. Не имеет эффекта, когда `sonnet` уже разрешается на Sonnet 5.5 или Sonnet 5 с их встроенным окном 1M; за [шлюзом LLM](/docs/ru/llm-gateway) выбирает окно 1M для этой модели |

43| **`opus[1m]`** | Использует Opus с [окном контекста в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов |43| **`opus[1m]`** | Использует Opus с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов |

44| **`opusplan`** | Специальный режим, который использует `opus` во время режима плана, а затем переключается на `sonnet` для выполнения |44| **`opusplan`** | Специальный режим, который использует `opus` во время режима плана, затем переключается на `sonnet` для выполнения |

45 45

46Версия, на которую разрешаются псевдонимы `opus` и `sonnet`, зависит от поставщика:46Версия, на которую разрешаются псевдонимы `opus` и `sonnet`, зависит от поставщика:

47 47

49| :- | :- | :- |49| :- | :- | :- |

54 54

55<span id="fable-alias-resolution" />55<span id="fable-alias-resolution" />

56 56

57Если вы не установили `ANTHROPIC_DEFAULT_FABLE_MODEL`, псевдоним `fable` разрешается на Fable 5.1, за исключением сеансов [Claude apps gateway](/docs/ru/claude-apps-gateway), где `fable` и `best` разрешаются на Fable 5. До версии 2.1.257 `fable` разрешался на Fable 5 на каждом поставщике.57Если вы не установили `ANTHROPIC_DEFAULT_FABLE_MODEL`, псевдоним `fable` разрешается на Fable 5.1, за исключением сеансов [Claude apps gateway](/docs/ru/claude-apps-gateway), где `fable` и `best` разрешаются на Fable 5.

58 58

59Шлюз, который не настроен на обслуживание `claude-fable-5-1`, отклоняет запросы для этой модели. Чтобы использовать Fable 5.1 через шлюз, который его обслуживает, выберите его с помощью `/model claude-fable-5-1`.59Шлюз, который не настроен на обслуживание `claude-fable-5-1`, отклоняет запросы для этой модели. Чтобы использовать Fable 5.1 через шлюз, который его обслуживает, выберите его с помощью `/model claude-fable-5-1`.

60 60

61Если псевдоним разрешается на более старую модель, более новые модели доступны путём явного выбора полного имени модели или установки `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`.61Где псевдоним разрешается на более старую модель, более новые модели доступны путём явного выбора полного имени модели или установки `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`.

62 62

63До версии 2.1.280 `opus` разрешался на Opus 5 в Anthropic API, Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform начиная с версии 2.1.219. До версии 2.1.219 `opus` разрешался на Opus 4.8 в Anthropic API начиная с версии 2.1.154 и на Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform начиная с версии 2.1.207. До версии 2.1.207 `opus` разрешался на Opus 4.7 на Claude Platform on AWS и на Opus 4.6 на Amazon Bedrock и Google Cloud's Agent Platform.63Более ранние версии разрешают эти псевдонимы на более старые модели. Для версии, в которой каждый псевдоним изменился, см. [Version history](#version-history).

64 64

65Псевдонимы указывают на рекомендуемую версию для вашего поставщика и обновляются со временем. Чтобы закрепить определённую версию, используйте полное имя модели, например `claude-opus-5-5`, или установите соответствующую переменную окружения, например `ANTHROPIC_DEFAULT_OPUS_MODEL`.65Псевдонимы указывают на рекомендуемую версию для вашего поставщика и обновляются со временем. Чтобы закрепить определённую версию, используйте полное имя модели, например `claude-opus-5-5`, или установите соответствующую переменную окружения, например `ANTHROPIC_DEFAULT_OPUS_MODEL`.

66 66

67<Note>67<Note>

68 Opus 5.5 требует Claude Code версии 2.1.280 или позже. Opus 5 требует версии 2.1.219 или позже. Sonnet 5 требует версии 2.1.197 или позже. Запустите `claude update` для обновления.68 Sonnet 5.5 требует Claude Code версии 2.1.284 или позже, а Opus 5.5 требует версии 2.1.280 или позже. Запустите `claude update` для обновления.

69</Note>69</Note>

70 70

71<h3 id="work-with-fable">71<h3 id="work-with-fable">

72 Работа с Fable72 Работа с Fable

73</h3>73</h3>

74 74

75[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) и Claude Fable 5 — это наиболее мощные модели в Claude Code, подходящие для задач, которые занимают больше одного сеанса. Они поддерживают длительные автономные сеансы, исследуют перед действием и проверяют свою работу чаще, чем меньшие модели. Fable 5.1 — это более новый выпуск.75[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) и Claude Fable 5 — это наиболее мощные модели в Claude Code, подходящие для задач, требующих более одного сеанса. Они поддерживают длительные автономные сеансы, исследуют перед действием и проверяют свою работу чаще, чем меньшие модели. Fable 5.1 — это более новый выпуск.

76 76

77Ни одна из моделей Fable не является стандартной для типа учётной записи ни на одном плане или поставщике. Выберите одну явно:77Ни одна из моделей Fable не является стандартной для типа учётной записи ни на одном плане или поставщике. Выберите одну явно:

78 78

79* **Fable 5.1**: запустите `/model fable` или запустите с `claude --model fable`. В сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway), где псевдоним разрешается на Fable 5, вместо этого запустите `/model claude-fable-5-1`.79* **Fable 5.1**: запустите `/model fable` или запустите с помощью `claude --model fable`. В сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway), где псевдоним разрешается на Fable 5, вместо этого запустите `/model claude-fable-5-1`.

80* **Fable 5**: выберите её по ID модели. В Anthropic API запустите `/model claude-fable-5` или запустите с `claude --model claude-fable-5`. На других поставщиках используйте ID модели Fable 5 вашего поставщика или [закрепите её](#pin-models-for-third-party-deployments) с помощью `ANTHROPIC_DEFAULT_FABLE_MODEL`.80* **Fable 5**: выберите её по ID модели. В Anthropic API запустите `/model claude-fable-5` или запустите с помощью `claude --model claude-fable-5`. На других поставщиках используйте ID модели Fable 5 вашего поставщика или [закрепите её](#pin-models-for-third-party-deployments) с помощью `ANTHROPIC_DEFAULT_FABLE_MODEL`.

81 81

82Если вы подключаетесь непосредственно к Anthropic API и ваши пользовательские параметры содержат `claude-fable-5` или `claude-fable-5[1m]` в качестве модели, например потому что вы выбрали Fable в средстве выбора `/model` до версии 2.1.257, Claude Code изменит это сохранённое значение на псевдоним `fable` или `fable[1m]` при первом запуске версии 2.1.257 или позже. Строка запуска модели показывает `(auto-updated)` один раз. Значение `claude-fable-5` в параметрах проекта, локальных или управляемых параметрах остаётся как есть.82Если вы подключаетесь непосредственно к Anthropic API и ваши пользовательские параметры содержат `claude-fable-5` или `claude-fable-5[1m]` в качестве модели, например потому что вы выбрали Fable в средстве выбора `/model` до версии 2.1.257, Claude Code изменит это сохранённое значение на псевдоним `fable` или `fable[1m]` при первом запуске версии 2.1.257 или позже. Строка запуска модели показывает `(auto-updated)` один раз. Значение `claude-fable-5` в параметрах проекта, локальных или управляемых параметрах остаётся как есть.

83 83

85 85

86Чтобы получить максимум от Fable:86Чтобы получить максимум от Fable:

87 87

88* **Опишите результат, а не шаги**: дайте ей результат, который вы хотите, и позвольте ей спланировать путь. Чтобы она продолжала работать над этим результатом, [установите цель](/docs/ru/goal).88* **Описывайте результат, а не шаги**: дайте ей результат, который вы хотите, и позвольте ей спланировать путь. Чтобы она продолжала работать над этим результатом, [установите цель](/docs/ru/goal).

89* **Дайте ей неоднозначные проблемы**: исследования первопричин, отладка сбоев и решения по архитектуре — это то, где дополнительное исследование и проверка окупаются.89* **Дайте ей неоднозначные проблемы**: исследования коренных причин, отладка сбоев и решения по архитектуре — это то, где дополнительное исследование и проверка окупаются.

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

91* **Масштабируйте более крупные задачи**: дайте ей работу, которую вы обычно разбиваете на части. Она держит длительные сеансы без потери нити.91* **Масштабируйте более крупные задачи**: дайте ей работу, которую вы обычно разбиваете на части. Она выдерживает длительные сеансы без потери нити.

92 92

93<Note>93<Note>

94 Fable 5.1 требует Claude Code версии 2.1.257 или позже. Если запрос для неё из более старой версии не удаётся, см. [Claude Code does not support this model](/docs/ru/errors#claude-code-does-not-support-this-model). Запустите `claude update` для обновления. Для доступности при нулевом сохранении данных см. [Model availability under ZDR](/docs/ru/zero-data-retention#model-availability-under-zdr).94 Fable 5.1 требует Claude Code версии 2.1.257 или позже. Если запрос для неё из более старой версии не удаётся, см. [Claude Code does not support this model](/docs/ru/errors#claude-code-does-not-support-this-model). Запустите `claude update` для обновления. Для доступности при нулевом сохранении данных см. [Model availability under ZDR](/docs/ru/zero-data-retention#model-availability-under-zdr).

95</Note>95</Note>

96 96

97В Anthropic API средство выбора `/model` отображает модель Fable, если [`availableModels`](#restrict-model-selection) или [ограничения модели организации](#organization-model-restrictions) её не исключают. Когда ваша организация вообще не может использовать Fable, например при [нулевом сохранении данных](/docs/ru/zero-data-retention#model-availability-under-zdr), строка остаётся в средстве выбора неактивной с примечанием о причине.97В Anthropic API модель Fable появляется в средстве выбора `/model`, если [`availableModels`](#restrict-model-selection) или [ограничения модели организации](#organization-model-restrictions) её не исключают. Когда ваша организация вообще не может использовать Fable, например при [нулевом сохранении данных](/docs/ru/zero-data-retention#model-availability-under-zdr), строка остаётся в средстве выбора неактивной с примечанием о причине.

98 98

99<h4 id="fable-and-usage-credits">99<h4 id="fable-and-usage-credits">

100 Fable и кредиты использования100 Fable и кредиты использования

102 102

103В зависимости от вашего плана и уровня места, использование Fable может выставляться в счёт [кредитам использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) вместо использования включённых лимитов вашего плана. Когда это происходит, средство выбора `/model` показывает "Requires usage credits" в строке Fable. Для управления кредитами использования см. [Add usage credits to your subscription](/docs/ru/costs#add-usage-credits-to-your-subscription).103В зависимости от вашего плана и уровня места, использование Fable может выставляться в счёт [кредитам использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) вместо использования включённых лимитов вашего плана. Когда это происходит, средство выбора `/model` показывает "Requires usage credits" в строке Fable. Для управления кредитами использования см. [Add usage credits to your subscription](/docs/ru/costs#add-usage-credits-to-your-subscription).

104 104

105В интерактивных сеансах Claude Code показывает запрос согласия перед запросом Fable, который выставляет кредиты использования. Члены планов Enterprise с организационным выставлением счётов не видят запрос. Вы можете продолжить работу с Fable, используя кредиты использования, или переключиться на вашу модель по умолчанию. Вы также можете отклонить запрос:105В интерактивных сеансах Claude Code показывает запрос согласия перед запросом Fable, который выставляет кредиты использования. Члены планов Enterprise с организационным выставлением счётов не видят запрос. Вы можете продолжить работу на Fable, используя кредиты использования, или переключиться на вашу модель по умолчанию. Вы также можете отклонить запрос:

106 106

107* В средстве выбора `/model` вы сохраняете вашу текущую модель.107* В средстве выбора `/model` вы сохраняете вашу текущую модель.

108* Во время сеанса Claude Code продолжает ход на вашей модели по умолчанию.108* Во время сеанса Claude Code продолжает ход на вашей модели по умолчанию.

109 109

110После того как вы выберете продолжить работу с Fable, используя кредиты использования, Claude Code больше не показывает запрос.110После того как вы выберете продолжить работу на Fable, используя кредиты использования, Claude Code больше не показывает запрос.

111 111

112В сеансе с подключённым [Remote Control](/docs/ru/remote-control), [фоновым сеансом](/docs/ru/agent-view) или сеансом товарища по [команде агентов](/docs/ru/agent-teams), никто не может быть у терминала, поэтому Claude Code удерживает запрос согласия во время сеанса до крайнего срока [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), пять минут по умолчанию. Если никто не ответил к крайнему сроку, Claude Code завершает ход без отправки запроса и добавляет уведомление в стенограмму, которое также показывает клиент Remote Control. Ваш выбор модели не изменяется, и Claude Code снова запрашивает согласие при вашем следующем сообщении.112В сеансе с подключённым [Remote Control](/docs/ru/remote-control), [фоновом сеансе](/docs/ru/agent-view) или сеансе товарища по [команде агентов](/docs/ru/agent-teams), никто не может быть у терминала, поэтому Claude Code удерживает запрос согласия во время сеанса до крайнего срока [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), пять минут по умолчанию. Если никто не ответил к крайнему сроку, Claude Code завершает ход без отправки запроса и добавляет примечание в стенограмму, которое также показывает клиент Remote Control. Ваш выбор модели не изменяется, и Claude Code снова запрашивает согласие при следующем сообщении.

113 113

114То, что вы можете делать во время ожидания запроса, зависит от сеанса:114То, что вы можете делать во время ожидания запроса, зависит от сеанса:

115 115

116* С подключённым Remote Control или в сеансе товарища нажмите любую клавишу у терминала, чтобы отменить крайний срок, и Claude Code ждёт вашего ответа.116* С подключённым Remote Control или в сеансе товарища нажмите любую клавишу у терминала, чтобы отменить крайний срок, и Claude Code будет ждать вашего ответа.

117* В фоновом сеансе ответьте до крайнего срока.117* В фоновом сеансе ответьте до крайнего срока.

118* Если вы отправите новое сообщение от удалённого клиента до того, как кто-нибудь напечатает у терминала, Claude Code завершит ход таким же образом, и ваше новое сообщение начнёт следующий ход. После того как кто-нибудь напечатает у терминала, Claude Code продолжает ждать ответа и ставит ваше новое сообщение в очередь позади него.118* Если вы отправите новое сообщение от удалённого клиента до того, как кто-нибудь напечатает у терминала, Claude Code завершит ход так же, и ваше новое сообщение начнёт следующий ход. После того как кто-нибудь напечатает у терминала, Claude Code продолжит ждать ответа и поставит ваше новое сообщение в очередь позади него.

119 119

120В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` и через Agent SDK Claude Code никогда не показывает запрос согласия. Когда запрос Fable там выставляет кредиты использования, Claude Code выставляет его без запроса.120В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` и через Agent SDK Claude Code никогда не показывает запрос согласия. Когда запрос Fable там выставляет кредиты использования, Claude Code выставляет его без запроса.

121 121

126Вы можете настроить вашу модель несколькими способами, перечисленными в порядке приоритета:126Вы можете настроить вашу модель несколькими способами, перечисленными в порядке приоритета:

127 127

1281. **Во время сеанса**: используйте `/model <alias|name>` для немедленного переключения или запустите `/model` без аргумента, чтобы открыть средство выбора. См. [когда Claude Code просит вас подтвердить переключение](/docs/ru/prompt-caching#switching-models)1281. **Во время сеанса**: используйте `/model <alias|name>` для немедленного переключения или запустите `/model` без аргумента, чтобы открыть средство выбора. См. [когда Claude Code просит вас подтвердить переключение](/docs/ru/prompt-caching#switching-models)

1292. **При запуске**: запустите с `claude --model <alias|name>`1292. **При запуске**: запустите с помощью `claude --model <alias|name>`

1303. **Переменная окружения**: установите `ANTHROPIC_MODEL=<alias|name>`1303. **Переменная окружения**: установите `ANTHROPIC_MODEL=<alias|name>`

1314. **Параметры**: настройте постоянно в файле параметров, используя поле `model`1314. **Параметры**: настройте постоянно в файле параметров, используя поле `model`

1325. **[Стандартная для новых сеансов](#set-a-default-model-for-new-sessions)**: установите `ANTHROPIC_DEFAULT_MODEL=<alias|name>`1325. **[Стандартная для новых сеансов](#set-a-default-model-for-new-sessions)**: установите `ANTHROPIC_DEFAULT_MODEL=<alias|name>`

136* `Enter`: переключить модель и сохранить как вашу стандартную136* `Enter`: переключить модель и сохранить как вашу стандартную

137* `s`: переключить модель только для этого сеанса и оставить вашу стандартную без изменений. Чтобы использовать другую клавишу, переназначьте [`modelPicker:thisSessionOnly`](/docs/ru/keybindings#model-picker-actions)137* `s`: переключить модель только для этого сеанса и оставить вашу стандартную без изменений. Чтобы использовать другую клавишу, переназначьте [`modelPicker:thisSessionOnly`](/docs/ru/keybindings#model-picker-actions)

138 138

139Ввод `/model <name>` напрямую ведёт себя как `Enter`. Чтобы переключиться только для этого сеанса, откройте средство выбора с `/model` и нажмите `s` в строке модели.139Ввод `/model <name>` напрямую ведёт себя как `Enter`. Чтобы переключиться только для этого сеанса, откройте средство выбора с помощью `/model` и нажмите `s` в строке модели.

140 140

141Если вы переключаете модели с `/model`, переключение также достигает [подагентов, которые наследуют модель основного разговора](/docs/ru/sub-agents#choose-a-model), потому что Claude Code разрешает их модель из той, которую использует ваш сеанс, когда Claude их запускает. Переключитесь на Opus перед тем, как Claude делегирует исследование или тестовые запуски одному из них, и эта работа также будет выполняться на Opus. Чтобы сохранить пользовательского подагента на меньшей модели, установите `model` в его определении.141На плане Enterprise, когда вы вошли в систему с помощью своей учётной записи claude.ai и сохранили стандартную с помощью `/model`, Claude Code также записывает выбор на эту учётную запись. Это требует Claude Code версии 2.1.280 или позже.

142 142

143Если вы установите модель с `/model` в [неинтерактивном режиме](/docs/ru/headless), с флагом `-p`, ваш выбор применяется только к текущему сеансу и не сохраняется как ваша стандартная; `/model` в этом режиме требует Claude Code версии 2.1.205 или позже. Параметры проекта и управляемые параметры по-прежнему имеют приоритет и переприменяются при следующем запуске. [Стандартная модель организации](#organization-default-model), которую ваш администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.143* Когда ваш администратор не установил [стандартную модель организации](#organization-default-model), опция [Default](#default-model-setting) может разрешиться на записанную модель, и когда это происходит, строка Default в средстве выбора показывает имя этой модели.

144* Если [ограничения модели](#restrict-model-selection) исключают записанную модель или она недоступна для вашей учётной записи, и ваш администратор не установил стандартную модель организации, опция Default разрешается так, как если бы ничего не было записано.

145* Если вы выберете Default или `opusplan` в `/model`, записанный выбор не изменяется.

146

147Если вы переключаете модели с помощью `/model`, переключение также достигает [подагентов, которые наследуют модель основного разговора](/docs/ru/sub-agents#choose-a-model), потому что Claude Code разрешает их модель из той, которую использует ваш сеанс, когда Claude их запускает. Переключитесь на Opus перед тем, как Claude делегирует исследование или тестовые запуски одному из них, и эта работа также будет выполняться на Opus. Чтобы сохранить пользовательского подагента на меньшей модели, установите `model` в его определении.

148

149Если вы установите модель с помощью `/model` в [неинтерактивном режиме](/docs/ru/headless), с флагом `-p`, ваш выбор применяется только к текущему сеансу и не сохраняется как ваша стандартная; `/model` в этом режиме требует Claude Code версии 2.1.205 или позже. Параметры проекта и управляемые параметры по-прежнему имеют приоритет и переприменяются при следующем запуске. [Стандартная модель организации](#organization-default-model), которую ваш администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.

144 150

145В версиях 2.1.144 по 2.1.152 `/model` применялся только к текущему сеансу, а `d` в средстве выбора сохранял стандартную.151В версиях 2.1.144 по 2.1.152 `/model` применялся только к текущему сеансу, а `d` в средстве выбора сохранял стандартную.

146 152

147Флаг `--model` и переменная окружения `ANTHROPIC_MODEL` применяются только к сеансу, который вы запускаете с ними. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждый с его собственным флагом `--model` вместо переключения с `/model`.153Флаг `--model` и переменная окружения `ANTHROPIC_MODEL` применяются только к сеансу, который вы запускаете с ними. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждый с его собственным флагом `--model` вместо переключения с помощью `/model`.

148 154

149Цены в средстве выбора `/model` появляются, когда Claude Code разговаривает с Anthropic API, непосредственно или через [шлюз LLM](/docs/ru/llm-gateway), который его проксирует, и цена в строке — это цена модели, которую выбирает эта строка. На [поставщиках третьих сторон](/docs/ru/third-party-integrations), таких как Amazon Bedrock, и на [шлюзе Claude apps gateway](/docs/ru/claude-apps-gateway), ваш поставщик или шлюз определяет, что вы платите, поэтому строки средства выбора не показывают цену. Цена — это только метка отображения; она не влияет на то, какую модель выбирает строка, или что выставляет ваш поставщик. До версии 2.1.206 [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и сеансы шлюза показывали цены списка Anthropic, и строка могла показывать цену другой модели, чем та, которую она выбирала.155Цены в средстве выбора `/model` появляются, когда Claude Code разговаривает с Anthropic API, напрямую или через [шлюз LLM](/docs/ru/llm-gateway), который его проксирует, и цена в строке — это цена модели, которую выбирает эта строка. На [поставщиках третьих сторон](/docs/ru/third-party-integrations), таких как Amazon Bedrock, и на [шлюзе Claude apps gateway](/docs/ru/claude-apps-gateway), ваш поставщик или шлюз определяет, что вы платите, поэтому строки средства выбора не показывают цену. Цена — это только метка отображения; она не влияет на то, какую модель выбирает строка, или что выставляет в счёт ваш поставщик. До версии 2.1.206 [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и сеансы шлюза показывали цены списка Anthropic, и строка могла показывать цену другой модели, чем та, которую она выбирала.

150 156

151Возобновлённые сеансы, запущенные с `claude --resume`, `--continue` или средством выбора `/resume`, сохраняют модель, которую они использовали при сохранении стенограммы, независимо от текущего параметра `model`. Если восстановленная модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сеанс переходит к нормальному порядку приоритета. Это предотвращает изменение модели при возобновлении из-за выбора `/model` другого сеанса. На поставщиках, которые используют ID развёртывания, специфичные для поставщика, а не ID моделей Anthropic, такие как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, модель стенограммы вообще не восстанавливается, и сеанс разрешает свою модель через нормальный порядок приоритета.157Возобновлённые сеансы, начатые с помощью `claude --resume`, `--continue` или средства выбора `/resume`, сохраняют модель, которую они использовали, когда стенограмма была сохранена, независимо от текущего параметра `model`. Если восстановленная модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сеанс переходит к нормальному порядку приоритета. Это предотвращает изменение модели при возобновлении из-за выбора `/model` другого сеанса. На поставщиках, которые используют специфичные для поставщика ID развёртывания вместо ID моделей Anthropic, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, модель стенограммы вообще не восстанавливается, и сеанс разрешает свою модель через нормальный порядок приоритета.

152 158

153Модель, которую вы выбираете для нового запуска с `--model` или `ANTHROPIC_MODEL`, по-прежнему имеет приоритет над восстановленной моделью. Начиная с версии 2.1.195, также переменная семейства [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables). [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) может тоже, при условиях, перечисленных в её разделе.159Модель, которую вы выбираете для нового запуска с помощью `--model` или `ANTHROPIC_MODEL`, по-прежнему имеет приоритет над восстановленной моделью. Начиная с версии 2.1.195, переменная семейства [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables) также имеет приоритет. [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) может тоже, при условиях, перечисленных в её разделе.

154 160

155Когда активная модель при запуске поступает из параметров проекта или управляемых параметров, а не из вашего собственного выбора, заголовок запуска показывает, какой файл параметров её установил. Запустите `/model` для переопределения; параметр проекта или управляемый параметр переприменяется при следующем запуске. На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми параметрами модели, в то время как управляемый список разрешений `availableModels` остаётся в силе, если только хост не предоставляет свой собственный; [Exceptions to managed settings precedence](/docs/ru/settings#exceptions-to-managed-settings-precedence) говорит, какие ключи и переменные переопределяет хост.161Когда активная модель при запуске поступает из параметров проекта или управляемых параметров, а не из вашего собственного выбора, заголовок запуска показывает, какой файл параметров её установил. Запустите `/model` для переопределения; параметр проекта или управляемый параметр переприменяется при следующем запуске. На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми параметрами модели, в то время как управляемый список разрешений `availableModels` остаётся в силе, если только хост не предоставляет свой собственный; [Exceptions to managed settings precedence](/docs/ru/settings#exceptions-to-managed-settings-precedence) говорит, какие ключи и переменные переопределяет хост.

156 162

158 164

159Когда Claude Code не может определить, какие PreModelSwitch hooks доставляют [управляемые плагины](/docs/ru/settings-reference#enabledplugins) вашей организации, например потому что управляемый плагин не загрузился, он отказывает в переключении вместо его применения, и он проверяет снова при каждой новой попытке. См. [Model switch was blocked by a PreModelSwitch hook](/docs/ru/errors#model-switch-was-blocked-by-a-premodelswitch-hook) для сообщения и восстановления.165Когда Claude Code не может определить, какие PreModelSwitch hooks доставляют [управляемые плагины](/docs/ru/settings-reference#enabledplugins) вашей организации, например потому что управляемый плагин не загрузился, он отказывает в переключении вместо его применения, и он проверяет снова при каждой новой попытке. См. [Model switch was blocked by a PreModelSwitch hook](/docs/ru/errors#model-switch-was-blocked-by-a-premodelswitch-hook) для сообщения и восстановления.

160 166

161Когда вы переключаете модели через метод [Agent SDK](/docs/ru/agent-sdk/overview) `setModel()` или с устройства, подключённого через [Remote Control](/docs/ru/remote-control), или приложение, такое как [Desktop app](/docs/ru/desktop), которое переключает Claude Code CLI для вас, Claude Code проверяет, что строка — это та, которую он распознаёт, перед её сохранением. Эта проверка требует Claude Code версии 2.1.200 или позже. Проверка выбора Remote Control требует Claude Code версии 2.1.260 или позже на вашей машине. В Anthropic API Claude Code распознаёт:167Когда вы переключаете модели через метод [Agent SDK](/docs/ru/agent-sdk/overview) `setModel()` или с устройства, подключённого через [Remote Control](/docs/ru/remote-control), или приложение, такое как [Desktop app](/docs/ru/desktop), которое запускает CLI Claude Code для вас, Claude Code проверяет, что строка — это та, которую он распознаёт, перед её сохранением. Эта проверка требует Claude Code версии 2.1.200 или позже. Проверка выбора Remote Control требует Claude Code версии 2.1.260 или позже на вашей машине. В Anthropic API Claude Code распознаёт:

162 168

163* псевдоним модели169* псевдоним модели

164* запись из средства выбора `/model`170* запись из средства выбора `/model`

165* любое имя, которое начинается с `claude-`171* любое имя, которое начинается с `claude-`

166* значение, которое вы сами настроили как [пользовательский вариант модели](#add-a-custom-model-option) или в [`modelOverrides`](#override-model-ids-per-version)172* значение, которое вы сами настроили как [пользовательский вариант модели](#add-a-custom-model-option) или в [`modelOverrides`](#override-model-ids-per-version)

167 173

168Claude Code отклоняет неузнанную строку с `Model "<name>" is not a recognized model id.` и сеанс сохраняет свою текущую модель, вместо сохранения строки и отказа при следующем запросе. См. [справку по ошибкам](/docs/ru/errors#model-is-not-a-recognized-model-id) для шагов восстановления.174Claude Code отклоняет нераспознанную строку с `Model "<name>" is not a recognized model id.` и сеанс сохраняет свою текущую модель, вместо сохранения строки и сбоя при следующем запросе. См. [справку по ошибкам](/docs/ru/errors#model-is-not-a-recognized-model-id) для шагов восстановления.

169 175

170Проверка запускается только в Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и за [шлюзом LLM](/docs/ru/llm-gateway) или пользовательским `ANTHROPIC_BASE_URL`, ваш поставщик или шлюз определяет имена моделей, поэтому Claude Code пропускает любую строку без проверки. Проверка также не охватывает флаг `--model`, переменную окружения `ANTHROPIC_MODEL` или параметр `model`; неправильно введённое значение там производит [There's an issue with the selected model](/docs/ru/errors#theres-an-issue-with-the-selected-model) при первом запросе вместо этого. Claude Code по-прежнему может написать [строку диагностики неузнанной модели](/docs/ru/errors#unrecognized-model-id-on-a-request) во время запроса на каждом поставщике.176Проверка запускается только в Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и за [шлюзом LLM](/docs/ru/llm-gateway) или пользовательским `ANTHROPIC_BASE_URL`, ваш поставщик или шлюз определяет имена моделей, поэтому Claude Code пропускает любую строку без проверки. Проверка также не охватывает флаг `--model`, переменную окружения `ANTHROPIC_MODEL` или параметр `model`; неправильно введённое значение там производит [There's an issue with the selected model](/docs/ru/errors#theres-an-issue-with-the-selected-model) при первом запросе вместо этого. Claude Code по-прежнему может написать [строку диагностики нераспознанной модели](/docs/ru/errors#unrecognized-model-id-on-a-request) во время запроса на каждом поставщике.

171 177

172Когда запрошенная модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, Claude Code показывает предупреждение, которое называет запрошенную модель. Интерактивные сеансы показывают его как уведомление при запуске. Начиная с версии 2.1.182, то же предупреждение записывается в stderr в [неинтерактивном режиме](/docs/ru/headless) при использовании формата вывода текста по умолчанию. Проверка также охватывает `model`, установленный в [frontmatter подагента](/docs/ru/sub-agents). Предупреждение stderr подавляется для `--output-format json` и `stream-json`; прочитайте фактическую модель из поля `modelUsage` [сообщения результата](/docs/ru/headless#get-structured-output) вместо этого.178Когда запрошенная модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, Claude Code показывает предупреждение, которое называет запрошенную модель. Интерактивные сеансы показывают его как уведомление при запуске. Начиная с версии 2.1.182, то же предупреждение записывается в stderr в [неинтерактивном режиме](/docs/ru/headless) при использовании формата вывода текста по умолчанию. Проверка также охватывает `model`, установленный в [фронтматтере подагента](/docs/ru/sub-agents). Предупреждение stderr подавляется для `--output-format json` и `stream-json`; прочитайте фактическую модель из поля `modelUsage` [результирующего сообщения](/docs/ru/headless#get-structured-output) вместо этого.

173 179

174Например, запустите сеанс на Opus:180Например, запустите сеанс на Opus:

175 181

177claude --model opus183claude --model opus

178```184```

179 185

180Затем переключите модели из сеанса:186Затем переключайте модели из сеанса:

181 187

182```text theme={null}188```text theme={null}

183/model sonnet189/model sonnet

204 210

205* Флаг `--model`211* Флаг `--model`

206* `ANTHROPIC_MODEL`212* `ANTHROPIC_MODEL`

207* Значение `model` в любом файле параметров, включая выбор, который вы сохраняете с `/model`213* Значение `model` в любом файле параметров, включая выбор, который вы сохраняете с помощью `/model`

208* [Стандартная модель организации](#organization-default-model)214* [Стандартная модель организации](#organization-default-model)

209 215

210Выбор, который вы сохраняете с `/model`, имеет приоритет над переменной при последующих запусках тоже. С установленным `ANTHROPIC_MODEL` вместо этого Claude Code возвращается к модели переменной при следующем запуске, независимо от того, что вы сохранили с `/model`.216Выбор, который вы сохраняете с помощью `/model`, имеет приоритет над переменной при последующих запусках. С установленным `ANTHROPIC_MODEL` вместо этого Claude Code возвращается к модели этой переменной при следующем запуске, независимо от того, что вы сохранили с помощью `/model`.

211 217

212Claude Code также разрешает опцию Default на модель переменной, если не применяется стандартная модель организации. Когда опция Default разрешается на модель переменной, строка Default в средстве выбора `/model` показывает метку Set by ANTHROPIC\_DEFAULT\_MODEL.218Claude Code также разрешает опцию Default на модель переменной, если не применяется стандартная модель организации. Когда опция Default разрешается на модель переменной, строка Default в средстве выбора `/model` показывает метку Set by ANTHROPIC\_DEFAULT\_MODEL.

213 219

214Claude Code игнорирует переменную в этих случаях, и опция Default разрешается как если бы вы её не установили:220Claude Code игнорирует переменную в этих случаях, и опция Default разрешается так, как если бы вы её не установили:

215 221

216* Вы установили её на `default`, `inherit`, `opusplan` или `haiku`222* Вы установили её на `default`, `inherit`, `opusplan` или `haiku`

217* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) включена223* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) включена

218* [`availableModels`](#restrict-model-selection) или [ограничения модели организации](#organization-model-restrictions) исключают модель224* [Ограничения модели](#restrict-model-selection) вашей организации исключают модель

219* Модель недоступна для вашей учётной записи225* Модель недоступна для вашей учётной записи

220 226

221Когда новый сеанс запустится на модели переменной, сеанс, который вы возобновляете с `claude --resume`, `--continue` или средством выбора `/resume`, также запустится на ней. Claude Code не восстанавливает модель, сохранённую в стенограмме этого сеанса. В противном случае Claude Code не использует переменную, когда вы [возобновляете сеанс](#setting-your-model).227Когда новый сеанс запустится на модели переменной, сеанс, который вы возобновляете с помощью `claude --resume`, `--continue` или средства выбора `/resume`, также запустится на ней. Claude Code не восстанавливает модель, сохранённую в стенограмме этого сеанса. В противном случае Claude Code не использует переменную, когда вы [возобновляете сеанс](#setting-your-model).

222 228

223<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">229<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">

224 Новый сеанс запускается на другой модели, чем вы выбрали230 Новый сеанс запускается на другой модели, чем вы выбрали

225</h4>231</h4>

226 232

227Когда вы выбираете модель с `/model` и ваш следующий сеанс запускается на чём-то другом, это обычные причины:233Когда вы выбираете модель с помощью `/model` и ваш следующий сеанс запускается на чём-то другом, это обычные причины:

228 234

229* **Вы выбрали её для одного сеанса.** Нажатие `s` в средстве выбора, запуск с `--model` и запуск `/model` в неинтерактивном режиме все применяются к текущему сеансу и оставляют вашу сохранённую стандартную без изменений.235* **Вы выбрали её для одного сеанса.** Нажатие `s` в средстве выбора, запуск с помощью `--model` и запуск `/model` в неинтерактивном режиме применяются только к текущему сеансу и оставляют вашу сохранённую стандартную без изменений.

230* **Что-то с более высоким приоритетом устанавливает модель.** Значение `model` в параметрах проекта или управляемых параметрах, `ANTHROPIC_MODEL` в вашей оболочке или [стандартная модель организации](#organization-default-model), которую ваш администратор установил для переопределения выбора пользователя, применяется снова при каждом запуске. Ваш выбор `/model` по-прежнему сохранён; он лишь уступает по приоритету. Когда параметры проекта или управляемые параметры устанавливают модель, заголовок запуска называет файл.236* **Что-то с более высоким приоритетом устанавливает модель.** Значение `model` в параметрах проекта или управляемых параметрах, `ANTHROPIC_MODEL` в вашей оболочке или [стандартная модель организации](#organization-default-model), которую ваш администратор установил для переопределения выбора пользователя, применяется снова при каждом запуске. Ваш выбор `/model` по-прежнему сохранён; он превосходит. Когда параметры проекта или управляемые параметры устанавливают модель, заголовок запуска называет файл.

231* **Claude Code не смог сохранить ваш выбор.** `/model` записывает `model` в `~/.claude/settings.json`. Если вы не можете писать в этот файл, например потому что другой инструмент его генерирует или связывает его с копией только для чтения, модель, которую вы выбрали, длится для сеанса, и следующий запуск читает старое значение. Установите `model` в инструменте, который генерирует файл, или сделайте файл доступным для записи. См. [A change you made in Claude Code is lost in new sessions](/docs/ru/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).237* **Claude Code не смог сохранить ваш выбор.** `/model` записывает `model` в `~/.claude/settings.json`. Если вы не можете писать в этот файл, например потому что другой инструмент его генерирует или связывает его с копией только для чтения, модель, которую вы выбрали, длится для сеанса, и следующий запуск читает старое значение. Установите `model` в инструменте, который генерирует файл, или сделайте файл доступным для записи. См. [A change you made in Claude Code is lost in new sessions](/docs/ru/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).

232* **Вы возобновили сеанс.** Сеанс, который вы возобновляете с `claude --resume` или `--continue`, обычно [сохраняет модель, которую он использовал](#setting-your-model), вместо вашей текущей стандартной.238* **Вы возобновили сеанс.** Сеанс, который вы возобновляете с помощью `claude --resume` или `--continue`, обычно [сохраняет модель, которую он использовал](#setting-your-model), вместо вашей текущей стандартной.

233 239

234<h2 id="restrict-model-selection">240<h2 id="restrict-model-selection">

235 Ограничение выбора модели241 Ограничение выбора модели

236</h2>242</h2>

237 243

238Администраторы предприятия могут использовать `availableModels` в [управляемых или политических параметрах](/docs/ru/managed-settings) для ограничения того, какие модели могут выбирать пользователи. Записи соответствуют семейству моделей, такому как `sonnet`, префиксу версии, такому как `claude-sonnet-4-5`, или полному идентификатору модели, такому как `claude-sonnet-4-5-20250929`. Префикс версии также соответствует более поздним идентификаторам моделей, которые расширяют его еще одним сегментом, поэтому `claude-fable-5` разрешает как Fable 5, так и Fable 5.1, а `claude-fable-5-1` разрешает только Fable 5.1.244Администраторы предприятия могут использовать `availableModels` в [управляемых или политических параметрах](/docs/ru/managed-settings) для ограничения того, какие модели могут выбирать пользователи. Записи соответствуют семейству моделей, такому как `sonnet`, префиксу версии, такому как `claude-sonnet-4-5`, или полному идентификатору модели, такому как `claude-sonnet-4-5-20250929`. Префикс версии также соответствует более поздним идентификаторам моделей, которые расширяют его еще одним сегментом, поэтому `claude-fable-5` разрешает как Fable 5, так и Fable 5.1, а `claude-fable-5-1` разрешает только Fable 5.1. Чтобы заблокировать модель, которую разрешает список, или чтобы каждая запись идентификатора модели разрешала только версию, которую она называет, см. [Блокировка конкретных моделей или версий](#block-specific-models-or-versions).

239 245

240На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми параметрами модели, в то время как управляемый список разрешений `availableModels` остается в силе, если только хост не предоставляет свой собственный; [Исключения из приоритета управляемых параметров](/docs/ru/settings#exceptions-to-managed-settings-precedence) указывает, какие ключи и переменные переопределяет хост.246На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми параметрами модели, в то время как управляемый список разрешений `availableModels` остается в силе, если только хост не предоставляет свой собственный; [Исключения из приоритета управляемых параметров](/docs/ru/settings#exceptions-to-managed-settings-precedence) указывает, какие ключи и переменные переопределяет хост.

241 247

291 297

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

295| [MDM или файлы управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms) | Применяется | Применяется | Не доставляется в средах, размещенных Anthropic; в [самостоятельно размещенных средах](/docs/ru/self-hosted-environments) применяется из образа runner согласно [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) | Применяется | Применяется где развернуто |301| [MDM или файлы управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms) | Применяется | Применяется | Не доставляется в средах, размещенных Anthropic; в [самостоятельно размещенных средах](/docs/ru/self-hosted-environments) применяется из образа runner согласно [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) | Применяется | Применяется где развернуто |

296 302

297* Облачные сессии на [Claude Code в веб](/docs/ru/claude-code-on-the-web), включая те, которые вы запускаете из приложения Desktop, по умолчанию запускаются на управляемых Anthropic виртуальных машинах: параметры, развернутые на вашем устройстве, не достигают их, поэтому доставляйте список разрешений через управляемые параметры сервера. Сессии, которые ваша организация маршрутизирует в [самостоятельно размещенную среду](/docs/ru/self-hosted-environments), запускаются на вашем собственном вычислении и также читают файл управляемых параметров в образе runner. [Как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) указывает, когда этот файл применяется. Переключение модели в середине сессии в облачной сессии отклоняется, когда запрошенная модель исключена списком разрешений. Когда список `availableModels` в ваших управляемых параметрах сервера не пуст, сервер отклоняет запрос пользователя на запуск облачной сессии на модели, которую список исключает.303* [Облачные сессии](/docs/ru/claude-code-on-the-web), включая те, которые вы запускаете из приложения Desktop, по умолчанию запускаются на управляемых Anthropic виртуальных машинах: параметры, развернутые на вашем устройстве, не достигают их, поэтому доставляйте список разрешений через управляемые параметры сервера. Сессии, которые ваша организация маршрутизирует в [самостоятельно размещенную среду](/docs/ru/self-hosted-environments), запускаются на вашем собственном вычислении и также читают файл управляемых параметров в образе runner. [Как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) указывает, когда этот файл применяется. Переключение модели в середине сессии в облачной сессии отклоняется, когда запрошенная модель исключена списком разрешений. Когда список `availableModels` в ваших управляемых параметрах сервера не пуст, сервер отклоняет запрос на запуск облачной сессии на модели, которую список исключает, на claude.ai/code или из приложения Desktop.

304* Сессии [Claude Tag](https://claude.com/docs/claude-tag/overview) запускаются в облачных средах, но не получают управляемые параметры сервера; в [самостоятельно размещенной среде](/docs/ru/self-hosted-environments) они все еще читают файл управляемых параметров в образе runner. Чтобы установить модель для этих сессий, см. [Выбор модели для области](https://claude.com/docs/claude-tag/admins/customize#choose-the-model-for-a-scope) в руководстве администратора Claude Tag.

298* Cowork, вкладка агентской работы в приложении Claude Desktop, запускает свои сессии на Claude Code, но по замыслу не получает управляемые параметры сервера из консоли администратора claude.ai. Файл управляемых параметров применяется к сессиям Cowork, когда он присутствует там, где запускается сессия; удаленные сессии Cowork запускаются на управляемых Anthropic виртуальных машинах, где развернутый на устройстве файл отсутствует.305* Cowork, вкладка агентской работы в приложении Claude Desktop, запускает свои сессии на Claude Code, но по замыслу не получает управляемые параметры сервера из консоли администратора claude.ai. Файл управляемых параметров применяется к сессиям Cowork, когда он присутствует там, где запускается сессия; удаленные сессии Cowork запускаются на управляемых Anthropic виртуальных машинах, где развернутый на устройстве файл отсутствует.

299* Сессии на [поставщиках третьих сторон](/docs/ru/server-managed-settings#platform-availability), таких как Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), не получают управляемые параметры сервера, поэтому доставляйте список разрешений через MDM или файлы управляемых параметров там.306* Сессии на [поставщиках третьих сторон](/docs/ru/server-managed-settings#platform-availability), таких как Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), не получают управляемые параметры сервера, поэтому доставляйте список разрешений через MDM или файлы управляемых параметров там.

300* Доставка, управляемая сервером, также требует, чтобы сессия аутентифицировалась с помощью [подходящего входа или ключа](/docs/ru/server-managed-settings#platform-availability). Флоты, которые генерируют ключи только через скрипт [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), должны доставлять список разрешений через MDM или файлы управляемых параметров.307* Доставка, управляемая сервером, также требует, чтобы сессия аутентифицировалась с помощью [подходящего входа или ключа](/docs/ru/server-managed-settings#platform-availability). Флоты, которые генерируют ключи только через скрипт [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), должны доставлять список разрешений через MDM или файлы управляемых параметров.

305 Поведение модели по умолчанию312 Поведение модели по умолчанию

306</h3>313</h3>

307 314

308Сам по себе `availableModels` оставляет параметр Default на [значении по умолчанию runtime](#default-model-setting) системы для учетной записи, пока вы также не установите [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Если это значение по умолчанию — это модель, которую вы намереваетесь ограничить, установите `enforceAvailableModels` также.315С префиксным сопоставлением по умолчанию, `availableModels` сам по себе оставляет параметр Default на [значении по умолчанию runtime](#default-model-setting) системы для учетной записи, пока вы также не установите [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Если это значение по умолчанию — это модель, которую вы намереваетесь ограничить, установите `enforceAvailableModels` также или [заблокируйте эту модель](#block-specific-models-or-versions).

309 316

310Пустой массив `availableModels` никогда не включает применение Default-модели: с `availableModels: []`, именованные выборы моделей блокируются, но модель Default для типа учетной записи остается пригодной для использования независимо от `enforceAvailableModels`.317С `availableModels: []`, именованные выборы моделей блокируются и `enforceAvailableModels` не имеет никакого эффекта.

311 318

312<h3 id="enforce-the-allowlist-for-the-default-model">319<h3 id="enforce-the-allowlist-for-the-default-model">

313 Применение списка разрешений к модели Default320 Применение списка разрешений к модели Default

322}329}

323```330```

324 331

325Параметр Default разрешается в значение по умолчанию типа учетной записи или в [модель по умолчанию организации](#organization-default-model), когда администратор установил одну. Когда эта модель не находится в списке разрешений, параметр Default вместо этого разрешается в первую запись `availableModels`, которая называет разрешенную, доступную модель, и строка Default средства выбора `/model` показывает эту модель. Это применяется везде, где достигается значение по умолчанию: запуск сессии, выбор Default в `/model`, ключевое слово `"default"` в [цепочках резервных моделей](#fallback-model-chains) и резервный вариант, используемый при удалении исключенного выбора.332Для члена без модели [записанной на его учетной записи](#setting-your-model), параметр Default разрешается в значение по умолчанию типа учетной записи, или в [модель по умолчанию организации](#organization-default-model), когда администратор установил одну. Когда эта модель не находится в списке разрешений, параметр Default вместо этого разрешается в первую запись `availableModels`, которая называет разрешенную, доступную модель, и строка Default средства выбора `/model` показывает эту модель. Это применяется везде, где достигается значение по умолчанию: запуск сессии, выбор Default в `/model`, ключевое слово `"default"` в [цепочках резервных моделей](#fallback-model-chains) и резервный вариант, используемый при удалении исключенного выбора. Модель, записанная на учетной записи члена, также проверяется против `availableModels`; [Установка вашей модели](#setting-your-model) описывает, как параметр Default ее обрабатывает.

326 333

327`enforceAvailableModels` переназначает параметр Default только когда `availableModels` непуст. С `availableModels: []`, модель Default для типа учетной записи остается пригодной для использования, поэтому параметр не может заблокировать пользователей из каждой модели. Когда `availableModels` непуст, но ни одна запись не разрешается в разрешенную и доступную модель, применение пропускается и Default разрешается в значение по умолчанию типа учетной записи с предупреждением, видимым только под `--debug`. Сохраняйте по крайней мере одну гарантированно доступную запись в списке, чтобы избежать этого.334`enforceAvailableModels` переназначает параметр Default только когда `availableModels` непуст. Когда `availableModels` непуст, но ни одна запись не разрешается в разрешенную и доступную модель, применение пропускается с предупреждением, видимым только под `--debug`. Сохраняйте по крайней мере одну гарантированно доступную запись в списке, чтобы избежать этого.

328 335

329Развертывайте оба ключа вместе в источнике управляемых параметров с наивысшим рейтингом, который вы доставляете. По умолчанию Claude Code читает только этот источник, поэтому пара, размещенная в файле управляемых параметров, игнорируется, когда консоль администратора доставляет какие-либо параметры; при выборе слияния в [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), Claude Code все еще игнорирует карту `modelOverrides` из источника, ранжированного ниже того, который устанавливает `availableModels`.336Развертывайте оба ключа вместе в источнике управляемых параметров с наивысшим рейтингом, который вы доставляете. По умолчанию Claude Code читает только этот источник, поэтому пара, размещенная в файле управляемых параметров, игнорируется, когда консоль администратора доставляет какие-либо параметры; при выборе слияния в [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), Claude Code все еще игнорирует карту `modelOverrides` из источника, ранжированного ниже того, который устанавливает `availableModels`.

330 337

332 Управление моделью, на которой работают пользователи339 Управление моделью, на которой работают пользователи

333</h3>340</h3>

334 341

335Параметр `model` — это начальный выбор, а не применение. Он устанавливает, какая модель активна при запуске сессии, но пользователи все еще могут открыть `/model` и выбрать Default, который разрешается в [значение по умолчанию runtime](#default-model-setting) системы независимо от того, что установлено в `model`, если только [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) не перенаправляет его.342Параметр `model` — это начальный выбор, а не применение. Он устанавливает, какая модель активна при запуске сессии, но пользователи все еще могут открыть `/model` и выбрать Default, который разрешается в [значение по умолчанию runtime](#default-model-setting) системы независимо от того, что установлено в `model`, если только [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) или [ключи, которые блокируют конкретные версии](#block-specific-models-or-versions), не применяются к нему.

336 343

337Чтобы полностью управлять опытом модели, объедините эти параметры:344Чтобы полностью управлять опытом модели, объедините эти параметры:

338 345

339* **`availableModels`**: ограничивает, какие именованные модели пользователи могут переключать346* **`availableModels`**: ограничивает, какие именованные модели пользователи могут переключать

340* **`enforceAvailableModels`**: расширяет список разрешений `availableModels` на параметр Default, поэтому Default не может разрешиться в модель вне списка347* **`enforceAvailableModels`**: расширяет список разрешений `availableModels` на параметр Default, поэтому Default не может разрешиться в модель вне списка

348* **`deniedModels`** и **`availableModelsMatch`**: [блокируют конкретные версии](#block-specific-models-or-versions), которые запись `availableModels` иначе разрешила бы

341* **`model`**: устанавливает начальный выбор модели при запуске сессии349* **`model`**: устанавливает начальный выбор модели при запуске сессии

342* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`** / **`ANTHROPIC_DEFAULT_FABLE_MODEL`**: управляют тем, на что разрешаются псевдонимы `sonnet`, `opus`, `haiku` и `fable`, и какую версию использует [значение по умолчанию типа учетной записи](#default-model-setting)350* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`** / **`ANTHROPIC_DEFAULT_FABLE_MODEL`**: управляют тем, на что разрешаются псевдонимы `sonnet`, `opus`, `haiku` и `fable`, и какую версию использует [значение по умолчанию типа учетной записи](#default-model-setting)

343 351

370 378

371Когда включена [конечная точка Amazon Bedrock Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), записи в `availableModels`, которые начинаются с `anthropic.`, добавляются в средство выбора `/model` как пользовательские параметры и маршрутизируются на конечную точку Mantle. Это исключение из сопоставления псевдонимов, описанного в [Закрепление моделей для развертываний третьих сторон](#pin-models-for-third-party-deployments). Параметр все еще ограничивает средство выбора перечисленными записями, и идентификатор Mantle встраивает имя семейства, поэтому он считается конкретной записью и отключает подстановочный знак семейства: рядом с любыми идентификаторами Mantle перечислите префиксы версий или полные идентификаторы, которые вы хотите сохранить выбираемыми. См. [Поведение слияния](#merge-behavior).379Когда включена [конечная точка Amazon Bedrock Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), записи в `availableModels`, которые начинаются с `anthropic.`, добавляются в средство выбора `/model` как пользовательские параметры и маршрутизируются на конечную точку Mantle. Это исключение из сопоставления псевдонимов, описанного в [Закрепление моделей для развертываний третьих сторон](#pin-models-for-third-party-deployments). Параметр все еще ограничивает средство выбора перечисленными записями, и идентификатор Mantle встраивает имя семейства, поэтому он считается конкретной записью и отключает подстановочный знак семейства: рядом с любыми идентификаторами Mantle перечислите префиксы версий или полные идентификаторы, которые вы хотите сохранить выбираемыми. См. [Поведение слияния](#merge-behavior).

372 380

381<h3 id="block-specific-models-or-versions">

382 Блокировка конкретных моделей или версий

383</h3>

384

385Запись `availableModels`, такая как `claude-opus-5`, также разрешает более поздние выпуски, которые расширяют ее, такие как Opus 5.5, как только Claude Code их поддерживает. Два управляемых параметра позволяют вам задержать выпуск, и оба требуют Claude Code v2.1.283 или позже:

386

387* [`deniedModels`](/docs/ru/settings-reference#deniedmodels): перечислите модели для блокировки. Перечисленная модель блокируется даже когда `availableModels` ее разрешает, и ключ также работает без списка разрешений вообще. Выпуск, который ни одна запись не блокирует, остается разрешенным

388* [`availableModelsMatch`](/docs/ru/settings-reference#availablemodelsmatch): установите его на `"exact"`, чтобы каждый идентификатор модели в `availableModels` разрешал только версию, которую он называет. Более новая версия перечисленного идентификатора модели затем остается заблокированной, пока вы не добавите ее в список

389

390Более ранние версии игнорируют оба ключа, поэтому также установите [`requiredMinimumVersion`](/docs/ru/settings-reference#requiredminimumversion), чтобы предотвратить запуск этих версий.

391

392Этот пример разрешает модели Opus и Sonnet и блокирует Opus 5.5 в каждом написании, включая датированные и специфичные для поставщика идентификаторы:

393

394```json theme={null}

395{

396 "availableModels": ["opus", "sonnet"],

397 "deniedModels": ["claude-opus-5-5"]

398}

399```

400

401Заблокированная модель, будь то `deniedModels` называет ее или список `"exact"` ее опускает, рассматривается как заблокированный выбор везде, [где применяется список разрешений](#restrict-model-selection). Она скрыта из средства выбора `/model`, и `/model <name>` отклоняет ее. Если вы назовете заблокированный идентификатор модели с помощью `--model`, `ANTHROPIC_MODEL` или параметра `model`, Claude Code удаляет его при запуске и разрешает параметр Default вместо этого. Если [hook](/docs/ru/hooks) или фоновый запрос называет модель, которую `deniedModels` блокирует, такую как поле `model` hook агента, этот запрос запускается на модели сессии вместо этого.

402

403Параметр Default следует обоим ключам также, независимо от того, установили ли вы [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Если вы установите его с непустым `availableModels`, заблокированный default считается моделью вне списка разрешений. В противном случае параметр Default, который разрешился бы в заблокированную модель, понижается в этом порядке:

404

4051. Самая новая разрешенная версия того же семейства

4062. Самая новая разрешенная модель каждого семейства с более низкой стоимостью по очереди: Sonnet, затем Haiku

4073. Первая запись `availableModels`, которая называет разрешенную модель

408

409Если ни один из них не разрешен, сессия, запускаемая на параметре Default, [отказывает запуститься](/docs/ru/errors#managed-settings-block-the-default-model) с ошибкой, которая называет ключ для исправления. Список `"exact"` влияет на параметр Default только когда управляемый список `availableModels` называет по крайней мере одну модель или семейство.

410

411Claude Code читает оба ключа только из управляемых параметров. Если вы установите любой из них в параметрах пользователя, проекта или локальных параметрах или с `--settings`, Claude Code игнорирует его с предупреждением.

412

373<h3 id="organization-model-restrictions">413<h3 id="organization-model-restrictions">

374 Ограничения модели организации414 Ограничения модели организации

375</h3>415</h3>

417 457

418Организационное значение по умолчанию проходит эти проверки ограничений перед его принятием:458Организационное значение по умолчанию проходит эти проверки ограничений перед его принятием:

419 459

420* [`availableModels`](#restrict-model-selection) сам по себе не применяется к организационному значению по умолчанию, поэтому организационное значение по умолчанию вне списка разрешений по-прежнему применяется. Когда также установлен [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model), организационное значение по умолчанию вне списка разрешений переназначается первой записи списка разрешений, как и любое другое Default460* С совпадением префикса по умолчанию [`availableModels`](#restrict-model-selection) сам по себе не применяется к организационному значению по умолчанию, поэтому организационное значение по умолчанию вне списка разрешений по-прежнему применяется. Когда также установлен [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model), организационное значение по умолчанию вне списка разрешений переназначается первой записи списка разрешений, как и любое другое Default

421* организационное значение по умолчанию, которое [ограничения модели организации](#organization-model-restrictions) запрещают для вашего аккаунта, заменяется самой новой разрешенной моделью в его семействе или моделью с более низкой стоимостью, когда каждая версия ее ограничена461* организационное значение по умолчанию, которое [ограничения модели организации](#organization-model-restrictions) запрещают для вашего аккаунта, заменяется самой новой разрешенной моделью в его семействе или моделью с более низкой стоимостью, когда каждая версия ее ограничена

462* для организационного значения по умолчанию, которое `deniedModels` или список `"exact"` блокирует, см. [Блокировка определенных моделей или версий](#block-specific-models-or-versions)

422* организационное значение по умолчанию, которое вообще недоступно для вашего аккаунта, пропускается, и опция Default разрешается так, как это было бы [без организационного значения по умолчанию](#default-model-setting)463* организационное значение по умолчанию, которое вообще недоступно для вашего аккаунта, пропускается, и опция Default разрешается так, как это было бы [без организационного значения по умолчанию](#default-model-setting)

423 464

424Начиная с v2.1.199, когда организационное значение по умолчанию является другим семейством моделей от обычного значения по умолчанию типа вашего аккаунта, средство выбора `/model` сохраняет отдельную строку для этого обычного семейства, чтобы вы все еще могли переключиться на него для сеанса. В версиях v2.1.196 по v2.1.198 эта строка отсутствует в средстве выбора.465Начиная с v2.1.199, когда организационное значение по умолчанию является другим семейством моделей от обычного значения по умолчанию типа вашего аккаунта, средство выбора `/model` сохраняет отдельную строку для этого обычного семейства, чтобы вы все еще могли переключиться на него для сеанса. В версиях v2.1.196 по v2.1.198 эта строка отсутствует в средстве выбора.

451 492

452До версии 2.1.280 `default` разрешался в Sonnet 5 на Pro и Team Standard, а в Opus 5 на Max, Team Premium, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.219. До версии 2.1.219 `default` разрешался в Opus 4.8 на Anthropic API, Max, Team Premium и Enterprise с оплатой по мере использования с версии 2.1.154, а также на Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.207. До версии 2.1.207 `default` разрешался в Opus 4.7 на Claude Platform on AWS и в Sonnet 4.5 на Amazon Bedrock и Google Cloud's Agent Platform.493До версии 2.1.280 `default` разрешался в Sonnet 5 на Pro и Team Standard, а в Opus 5 на Max, Team Premium, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.219. До версии 2.1.219 `default` разрешался в Opus 4.8 на Anthropic API, Max, Team Premium и Enterprise с оплатой по мере использования с версии 2.1.154, а также на Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.207. До версии 2.1.207 `default` разрешался в Opus 4.7 на Claude Platform on AWS и в Sonnet 4.5 на Amazon Bedrock и Google Cloud's Agent Platform.

453 494

454Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается в эту модель вместо стандартного значения для типа учетной записи выше. Требуется Claude Code версии 2.1.196 или позже. `default` также может разрешаться в модель, которую вы установили с помощью [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), при условиях, указанных в его разделе.495Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается в эту модель вместо стандартного значения для типа учетной записи выше. Требуется Claude Code версии 2.1.196 или позже. `default` также может разрешаться в модель, которую вы установили с помощью [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), при условиях, указанных в его разделе, или в модель, [записанную в вашей учетной записи](#setting-your-model).

455 496

456Когда управляемые параметры [применяют список разрешений для модели Default](#enforce-the-allowlist-for-the-default-model) и стандартное значение для типа учетной записи отсутствует в `availableModels`, `default` разрешается в принудительный Default вместо стандартного значения для типа учетной записи выше. Когда применяются оба условия, модель по умолчанию организации сначала заменяет стандартное значение для типа учетной записи, а затем применяется принудительное значение: модель по умолчанию организации в списке разрешений сохраняется, а модель вне списка разрешается в принудительный Default.497Когда ничего не записано в вашей учетной записи, управляемые параметры [применяют список разрешений для модели Default](#enforce-the-allowlist-for-the-default-model), и стандартное значение для типа учетной записи отсутствует в `availableModels`, `default` разрешается в принудительный Default вместо стандартного значения для типа учетной записи выше. Когда применяются оба условия, модель по умолчанию организации сначала заменяет стандартное значение для типа учетной записи, а затем применяется принудительное значение: модель по умолчанию организации в списке разрешений сохраняется, а модель вне списка разрешается в принудительный Default.

457 498

458Модели Fable не являются стандартным значением для типа учетной записи ни на одном плане или поставщике. Выбор одной с помощью `/model` сохраняет ее как выбранную модель в параметрах пользователя, поэтому более поздние сеансы начинаются с нее. Для одноразового изменения, которое Claude Code вносит в сохраненный выбор Fable 5 в версии 2.1.257, см. [Работа с Fable](#work-with-fable).499Модели Fable не являются стандартным значением для типа учетной записи ни на одном плане или поставщике. Выбор одной с помощью `/model` сохраняет ее как выбранную модель в параметрах пользователя, поэтому более поздние сеансы начинаются с нее. Для одноразового изменения, которое Claude Code вносит в сохраненный выбор Fable 5 в версии 2.1.257, см. [Работа с Fable](#work-with-fable).

459 500

463 504

464Псевдоним модели `opusplan` обеспечивает автоматизированный гибридный подход:505Псевдоним модели `opusplan` обеспечивает автоматизированный гибридный подход:

465 506

466* **В режиме плана**: использует `opus` для сложного рассуждения и решений по архитектуре507* **В Plan Mode**: использует `opus` для сложного рассуждения и решений по архитектуре

467* **В режиме выполнения**: автоматически переключается на `sonnet` для генерации кода и реализации508* **В режиме выполнения**: автоматически переключается на `sonnet` для генерации кода и реализации

468 509

469Это сочетает рассуждение Opus для планирования с эффективностью Sonnet для выполнения.510Это сочетает рассуждение Opus для планирования с эффективностью Sonnet для выполнения.

470 511

471Фаза Opus в режиме плана использует то же окно контекста, что и параметр модели `opus`, а фаза выполнения использует то же окно, что и `sonnet`. Когда `opus` и `sonnet` разрешаются в модели, которые работают с [окном контекста 1M](#extended-context) по умолчанию, как это делают текущие модели на Anthropic API, обе фазы работают с ним. Чтобы запросить контекст 1M для обеих фаз, где они этого не делают, [установите модель](#setting-your-model) на `opusplan[1m]`, например с помощью `/model opusplan[1m]`. Установка с помощью `/model` требует Claude Code версии 2.1.265 или позже; в более ранних версиях используйте флаг `--model` или параметр `model` вместо этого.512Фаза Opus в Plan Mode использует то же окно контекста, что и параметр модели `opus`, а фаза выполнения использует то же окно, что и `sonnet`. Когда `opus` и `sonnet` разрешаются в модели, которые работают с [окном контекста 1M](#extended-context) по умолчанию, как это делают текущие модели на Anthropic API, обе фазы работают с ним. Чтобы запросить контекст 1M для обеих фаз, где они этого не делают, [установите модель](#setting-your-model) на `opusplan[1m]`, например с помощью `/model opusplan[1m]`. Установка с помощью `/model` требует Claude Code версии 2.1.265 или позже; в более ранних версиях используйте флаг `--model` или параметр `model` вместо этого.

472 513

473Когда [`availableModels`](#restrict-model-selection) исключает новейший Opus, но разрешает более старую версию, например `["sonnet", "claude-opus-4-6"]`, `opusplan` использует новейший разрешенный Opus для планирования и остается только на Sonnet, когда исключены все версии Opus. Сеанс Haiku, который обычно обновляется до Sonnet в режиме плана, аналогично использует новейший разрешенный Sonnet и остается на Haiku только когда исключены все версии Sonnet. До версии 2.1.205 режим плана оставался на модели сеанса всякий раз, когда исключалась новейшая версия семейства обновлений, даже когда список разрешений разрешал более старую версию.514Когда [`availableModels`](#restrict-model-selection) исключает новейший Opus, но разрешает более старую версию, например `["sonnet", "claude-opus-4-6"]`, `opusplan` использует новейший разрешенный Opus для планирования и остается только на Sonnet, когда исключены все версии Opus. Сеанс Haiku, который обычно обновляется до Sonnet в Plan Mode, аналогично использует новейший разрешенный Sonnet и остается на Haiku только когда исключены все версии Sonnet. До версии 2.1.205 Plan Mode оставался на модели сеанса всякий раз, когда исключалась новейшая версия семейства обновлений, даже когда список разрешений разрешал более старую версию.

474 515

475Подстановка более старой разрешенной версии применяется на Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Mantle, развертывания которых используют специфичные для поставщика идентификаторы моделей, режим плана остается на модели сеанса всякий раз, когда модель обновления исключена.516Подстановка более старой разрешенной версии применяется на Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Mantle, развертывания которых используют специфичные для поставщика идентификаторы моделей, Plan Mode остается на модели сеанса всякий раз, когда модель обновления исключена.

476 517

477Для гибридного подхода, при котором Claude решает во время выполнения задачи, когда обратиться ко второй модели, а не переключаться на границе плана, см. [инструмент advisor](/docs/ru/advisor).518Для гибридного подхода, при котором Claude решает во время выполнения задачи, когда обратиться ко второй модели, а не переключаться на границе плана, см. [инструмент advisor](/docs/ru/advisor).

478 519

507* **Вне списка разрешений**: Claude Code удаляет любую запись, не разрешенную [`availableModels`](#restrict-model-selection), когда читает цепочку.548* **Вне списка разрешений**: Claude Code удаляет любую запись, не разрешенную [`availableModels`](#restrict-model-selection), когда читает цепочку.

508* **Меньшее окно контекста во время компактирования**: цепочка также охватывает [компактирование](/docs/ru/context-window#what-survives-compaction), но Claude Code не будет переходить в режим отказа на модель с меньшим окном контекста, чем у основной, так как суммирование там сначала отрежет часть разговора. Если все резервные модели меньше, компактирование показывает исходную ошибку и вы можете повторить попытку.549* **Меньшее окно контекста во время компактирования**: цепочка также охватывает [компактирование](/docs/ru/context-window#what-survives-compaction), но Claude Code не будет переходить в режим отказа на модель с меньшим окном контекста, чем у основной, так как суммирование там сначала отрежет часть разговора. Если все резервные модели меньше, компактирование показывает исходную ошибку и вы можете повторить попытку.

509 550

510Claude Code также применяет цепочку к [подагентам](/docs/ru/sub-agents). Когда запрос подагента переходит в режим отказа, Claude Code пробует ваши настроенные резервные модели по порядку, и подагент продолжает работу на модели, которая принимает запрос. Модель вашего сеанса не изменяется. До версии 2.1.247 отказ, который охватывает цепочка, завершал подагента.551Claude Code также применяет цепочку к [subagents](/docs/ru/sub-agents). Когда запрос subagent переходит в режим отказа, Claude Code пробует ваши настроенные резервные модели по порядку, и subagent продолжает работу на модели, которая принимает запрос. Модель вашего сеанса не изменяется. До версии 2.1.247 отказ, который охватывает цепочка, завершал subagent.

511 552

512<h3 id="automatic-model-fallback">553<h3 id="automatic-model-fallback">

513 Автоматический резервный вариант модели554 Автоматический резервный вариант модели

514</h3>555</h3>

515 556

516Этот раздел охватывает резервный вариант на основе содержимого из моделей Fable, Opus 5.5 и Opus 5. Для резервного варианта на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).557Этот раздел охватывает резервный вариант на основе содержимого из моделей Fable, Opus 5.5, Sonnet 5.5 и Opus 5. Для резервного варианта на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).

517 558

518Модели Fable, Opus 5.5 и Opus 5 работают с классификаторами безопасности, которые чаще всего отмечают содержимое кибербезопасности и биологии. Когда классификатор отмечает запрос и отмеченная категория имеет резервную модель, Claude Code повторно запускает запрос на этой модели и показывает уведомление в стенограмме. Для этих двух категорий резервная модель зависит от того, какая модель отказала:559Модели Fable, Opus 5.5, Sonnet 5.5 и Opus 5 работают с классификаторами безопасности, которые чаще всего отмечают содержимое кибербезопасности и биологии. Когда классификатор отмечает запрос и отмеченная категория имеет резервную модель, Claude Code повторно запускает запрос на этой модели и показывает уведомление в стенограмме. Для этих двух категорий резервная модель зависит от того, какая модель отказала:

519 560

520* **Fable 5.1, Fable 5 и Opus 5.5**: запросы, отмеченные биологией, повторно запускаются на Opus 5, а запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8.561* **Fable 5.1, Fable 5 и Opus 5.5**: запросы, отмеченные биологией, повторно запускаются на Opus 5, а запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8.

562* **Sonnet 5.5**: запросы, отмеченные кибербезопасностью, повторно запускаются на Sonnet 5. Запросы, отмеченные биологией, заканчиваются отказом, потому что Sonnet 5.5 не имеет резервной модели биологии.

521* **Opus 5**: запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8. Запросы, отмеченные биологией, заканчиваются отказом, потому что Opus 5 запускает свои собственные классификаторы биологии без резервной модели.563* **Opus 5**: запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8. Запросы, отмеченные биологией, заканчиваются отказом, потому что Opus 5 запускает свои собственные классификаторы биологии без резервной модели.

522 564

523На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code разрешает эти цели через ваше развертывание, и если вы установите `ANTHROPIC_DEFAULT_OPUS_MODEL`, категории, которые имеют резервный вариант, повторно запускаются на закрепленной модели; см. [Включение резервного варианта на Bedrock, Agent Platform и Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).565На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code разрешает эти цели через идентификаторы моделей вашего развертывания. См. [Включение резервного варианта на Bedrock, Agent Platform и Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).

524 566

525После резервного варианта сеанс продолжается на резервной модели. Чтобы вернуться к исходной модели, запустите [`/model`](#setting-your-model).567После резервного варианта сеанс продолжается на резервной модели. Чтобы вернуться к исходной модели, запустите [`/model`](#setting-your-model).

526 568

544 586

545Некоторые случаи ведут себя иначе:587Некоторые случаи ведут себя иначе:

546 588

547* Когда отмеченная категория не имеет резервной модели, такой как флаг биологии на Opus 5, Claude Code не показывает подсказку и запрос заканчивается отказом.589* Когда отмеченная категория не имеет резервной модели, такой как флаг биологии на Opus 5 или Sonnet 5.5, Claude Code не показывает подсказку и запрос заканчивается отказом.

548* Если обе модели отмечают один и тот же запрос, вы можете отредактировать подсказку и повторить попытку, или начать новый сеанс.590* Если обе модели отмечают один и тот же запрос, вы можете отредактировать подсказку и повторить попытку, или начать новый сеанс.

549* На мобильных сеансах [Claude Code в веб-браузере](/docs/ru/claude-code-on-the-web) редактирование и повторная попытка не поддерживаются. Переключите модели или продолжите сеанс из браузера рабочего стола или приложения рабочего стола.591* На мобильных сеансах [Claude Code в веб-браузере](/docs/ru/claude-code-on-the-web) редактирование и повторная попытка не поддерживаются. Переключите модели или продолжите сеанс из браузера рабочего стола или приложения рабочего стола.

550* В [неинтерактивном режиме](/docs/ru/cli-reference#cli-flags) и интеграциях SDK, которые не могут показать подсказку, отмеченный запрос завершает ход с отказом.592* В [неинтерактивном режиме](/docs/ru/cli-reference#cli-flags) и интеграциях SDK, которые не могут показать подсказку, отмеченный запрос завершает ход с отказом.

554 Включение резервного варианта на Bedrock, Agent Platform и Foundry596 Включение резервного варианта на Bedrock, Agent Platform и Foundry

555</h4>597</h4>

556 598

557На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) идентификаторы моделей специфичны для поставщика, поэтому автоматический резервный вариант работает только когда Claude Code может идентифицировать обе задействованные модели:599На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) идентификаторы моделей специфичны для поставщика, поэтому автоматический резервный вариант работает только когда Claude Code может идентифицировать каждую задействованную модель:

600

601* Claude Code должен распознавать текущую модель как источник резервного варианта. Fable 5.1 и Fable 5 распознаются, когда идентификатор модели содержит `claude-fable-5`, соответствует значению `ANTHROPIC_DEFAULT_FABLE_MODEL` или сопоставляется с [`modelOverrides`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5 и Opus 5 распознаются по их идентификатору модели поставщика или сопоставлению [`modelOverrides`](#override-model-ids-per-version).

602* Цель Opus должна разрешаться в вашем развертывании, независимо от того, какая модель отказала: установите `ANTHROPIC_DEFAULT_OPUS_MODEL` или сохраните запись Opus 4.8 в списке моделей поставщика. Без одной резервный вариант остается отключенным для каждой исходной модели, включая Sonnet 5.5, и отмеченные запросы заканчиваются отказом.

603* Резервная модель отмеченной категории должна разрешаться в вашем развертывании. Из модели Fable, Opus 5.5 или Opus 5, если вы установите `ANTHROPIC_DEFAULT_OPUS_MODEL`, отмеченные запросы повторно запускаются на этой модели для каждой категории, которая имеет резервный вариант; флаг биологии на Opus 5 по-прежнему заканчивается отказом. Если вы не установите его, запросы, отмеченные кибербезопасностью, повторно запускаются на записи Opus 4.8, а запросы, отмеченные биологией, из модели Fable или Opus 5.5 на записи Opus 5. Из Sonnet 5.5 запросы, отмеченные кибербезопасностью, повторно запускаются на модели, которую вы установили в `ANTHROPIC_DEFAULT_SONNET_MODEL`, или на записи Sonnet 5 в списке моделей поставщика, если вы не установите его.

558 604

559* Claude Code должен распознавать текущую модель как источник резервного варианта. Fable 5.1 и Fable 5 распознаются, когда идентификатор модели содержит `claude-fable-5`, соответствует значению `ANTHROPIC_DEFAULT_FABLE_MODEL` или сопоставляется с [`modelOverrides`](#override-model-ids-per-version). Opus 5.5 и Opus 5 распознаются по их идентификатору модели поставщика или сопоставлению [`modelOverrides`](#override-model-ids-per-version).605Если какая-либо модель не может быть идентифицирована, Claude Code не переключается. Отмеченный запрос заканчивается сообщением об отказе, и вы можете переключить модели с помощью [`/model`](#setting-your-model) и повторить попытку. Чтобы сделать обе модели идентифицируемыми, установите закрепления для вашей исходной модели:

560* Резервная модель должна разрешаться в вашем развертывании. Если вы установите `ANTHROPIC_DEFAULT_OPUS_MODEL`, отмеченные запросы повторно запускаются на этой модели для каждой категории, которая имеет резервный вариант; флаг биологии на Opus 5 по-прежнему заканчивается отказом. Если вы не установите его, запросы, отмеченные кибербезопасностью, повторно запускаются на записи Opus 4.8 в списке моделей поставщика, а запросы, отмеченные биологией, из модели Fable или Opus 5.5 на записи Opus 5.

561 606

562Если какая-либо модель не может быть идентифицирована, Claude Code не переключается автоматически. Отмеченный запрос заканчивается сообщением об отказе, и вы можете переключить модели с помощью [`/model`](#setting-your-model) и повторить попытку. Установка `ANTHROPIC_DEFAULT_FABLE_MODEL` на идентификатор вашей модели Fable включает распознавание Fable. Установка `ANTHROPIC_DEFAULT_OPUS_MODEL` на идентификатор модели Opus дает отмеченным категориям цель резервного варианта, если только закрепление не называет модель вне семейства Opus или модель, которая отказала; затем Claude Code не переключается и отказ остается в силе.607* **Модели Fable**: установите `ANTHROPIC_DEFAULT_FABLE_MODEL` на идентификатор вашей модели Fable, чтобы Claude Code распознал ее как источник резервного варианта.

608* **Каждая исходная модель**: установите `ANTHROPIC_DEFAULT_OPUS_MODEL` на идентификатор модели Opus, чтобы включить резервный вариант и дать отмеченным категориям цель. Закрепление, которое называет модель вне семейства Opus или модель, которая отказала, оставляет отказ в силе.

609* **Sonnet 5.5**: в дополнение к закреплению Opus установите `ANTHROPIC_DEFAULT_SONNET_MODEL` или сохраните запись Sonnet 5 в списке моделей поставщика, чтобы предоставить модель, на которой запрос повторно запускается. Закрепление Sonnet, которое называет модель вне семейства Sonnet или Sonnet 5.5 само по себе, оставляет отказ в силе.

563 610

564<h4 id="security-research-and-biology-workloads">611<h4 id="security-research-and-biology-workloads">

565 Исследование безопасности и рабочие нагрузки биологии612 Исследование безопасности и рабочие нагрузки биологии

566</h4>613</h4>

567 614

568Рабочие нагрузки в наступательной безопасности или биологии, включая тестирование на проникновение, упражнения Capture the Flag (CTF) и кодовые базы, смежные с биологией, часто вызывают резервный вариант, часто при первом запросе. Для существенной работы по биологии на Fable 5.1, Fable 5 или Opus 5.5 Claude Code перемещает сеанс на Opus 5 при первом отмеченном запросе, и более поздние запросы, отмеченные биологией, заканчиваются отказами там, потому что Opus 5 не имеет резервного варианта биологии. На Opus 5 вы получаете эти отказы с первого отмеченного запроса.615Рабочие нагрузки в наступательной безопасности или биологии, включая тестирование на проникновение, упражнения Capture the Flag (CTF) и кодовые базы, смежные с биологией, часто вызывают резервный вариант, часто при первом запросе. Для существенной работы по биологии на Fable 5.1, Fable 5 или Opus 5.5 Claude Code перемещает сеанс на Opus 5 при первом отмеченном запросе, и более поздние запросы, отмеченные биологией, заканчиваются отказами там, потому что Opus 5 не имеет резервного варианта биологии. На Opus 5 и Sonnet 5.5 вы получаете эти отказы с первого отмеченного запроса.

569 616

570Это ожидаемая маршрутизация для этих областей, а не флаг учетной записи. Если вашей организации требуется возможность класса Fable для этой работы, обратитесь к команде учетной записи Anthropic о программах доверенного доступа.617Это ожидаемая маршрутизация для этих областей, а не флаг учетной записи. Если вашей организации требуется возможность класса Fable для этой работы, обратитесь к команде учетной записи Anthropic о программах доверенного доступа.

571 618

580| Модель | Уровни |627| Модель | Уровни |

581| :- | :- |628| :- | :- |

585 632

586Если вы установите уровень, который активная модель не поддерживает, Claude Code переходит на наивысший поддерживаемый уровень на или ниже установленного. Например, `xhigh` работает как `high` на Opus 4.6. Ваша организация или ваши собственные параметры также могут ограничивать уровни, которые предлагает модель; см. [Ограничения усилий организации](#organization-effort-limits).633Если вы установите уровень, который активная модель не поддерживает, Claude Code переходит на наивысший поддерживаемый уровень на или ниже установленного. Например, `xhigh` работает как `high` на Opus 4.6. Ваша организация или ваши собственные параметры также могут ограничивать уровни, которые предлагает модель; см. [Ограничения усилий организации](#organization-effort-limits).

587 634

588С параметром [`ultracode`](/docs/ru/settings-reference#ultracode) отключенным, Claude Code разрешает уровень усилий сеанса в этом порядке, принимая первый применимый:635Claude Code разрешает уровень усилий сеанса в этом порядке, принимая первый применимый:

589 636

5901. Явный выбор: переменная окружения [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars#variables), запуск с `--effort` или `/effort` в сеансе ([неинтерактивный `/effort` имеет более узкий эффект](#non-interactive-effort))6371. Явный выбор: переменная окружения [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars#variables), запуск с `--effort` или `/effort` в сеансе ([неинтерактивный `/effort` имеет более узкий эффект](#non-interactive-effort))

5912. Ваши параметры: уровень, который вы сохранили для модели или ключ [`effortLevel`](/docs/ru/settings-reference#effortlevel), с приоритетом между ними и между файлами параметров, указанным в [`modelSettings`](/docs/ru/settings-reference#modelsettings)6382. Ваши параметры: уровень, который вы сохранили для модели или ключ [`effortLevel`](/docs/ru/settings-reference#effortlevel), с приоритетом между ними и между файлами параметров, указанным в [`modelSettings`](/docs/ru/settings-reference#modelsettings)

5923. Уровень усилий модели по умолчанию: `high` на каждой модели, которая поддерживает усилия, за исключением того, что Opus 5.5 по умолчанию имеет `medium`, Opus 4.7 по умолчанию имеет `xhigh` и, когда ваша организация устанавливает уровень усилий по умолчанию для своей [модели по умолчанию организации](#organization-default-model), этот уровень является стандартным при запуске этой модели6393. Уровень усилий модели по умолчанию: `high` на каждой модели, которая поддерживает усилия, за исключением того, что Opus 5.5 и Sonnet 5.5 по умолчанию имеют `medium`, Opus 4.7 по умолчанию имеет `xhigh` и, когда ваша организация устанавливает уровень усилий по умолчанию для своей [модели по умолчанию организации](#organization-default-model), этот уровень является стандартным при запуске этой модели

593 640

594Opus 5.5 начинает с `medium`, если один из источников выше не устанавливает уровень для него, и верхний уровень `effortLevel` в файле параметров пользователя не считается для Opus 5.5. Этот ключ — это более старая форма, которую `/effort` писал перед тем, как Claude Code сохранял уровни для каждой модели: он продолжает применяться там, где применялся раньше, на Opus 5, Fable 5.1 и более ранних моделях, в то время как Opus 5.5 и модели, выпущенные после него, начинают со своего собственного стандарта, пока вы не выберете уровень для них с помощью `/effort` или средства выбора `/model`. Верхний уровень `effortLevel` в параметрах проекта, локальных или управляемых параметрах, или переданный с `--settings`, применяется к каждой модели.641Opus 5.5 начинает с `medium`, если один из источников выше не устанавливает уровень для него, и верхний уровень `effortLevel` в файле параметров пользователя не считается для Opus 5.5. Этот ключ — это более старая форма, которую `/effort` писал перед тем, как Claude Code сохранял уровни для каждой модели: он продолжает применяться там, где применялся раньше, на Opus 5, Fable 5.1 и более ранних моделях, в то время как Opus 5.5 и модели, выпущенные после него, начинают со своего собственного стандарта, пока вы не выберете уровень для них с помощью `/effort` или средства выбора `/model`. Верхний уровень `effortLevel` в параметрах проекта, локальных или управляемых параметрах, или переданный с `--settings`, применяется к каждой модели.

595 642

610 657

611Когда вы устанавливаете уровень с `/effort` в запуске [`-p`](/docs/ru/headless), Claude Code применяет его только к этому сеансу и не сохраняет его как стандартный.658Когда вы устанавливаете уровень с `/effort` в запуске [`-p`](/docs/ru/headless), Claude Code применяет его только к этому сеансу и не сохраняет его как стандартный.

612 659

613Меню `/effort` также предлагает `ultracode`. Ultracode — это параметр Claude Code, а не уровень усилий модели: он отправляет `xhigh` модели и дополнительно имеет Claude оркестрирует [динамические рабочие процессы](/docs/ru/workflows) для существенных задач. Для того, где это можно установить постоянно, см. параметр [`ultracode`](/docs/ru/settings-reference#ultracode).660Ползунок `/effort` также имеет переключатель **Ultracode**. Ultracode — это параметр Claude Code, а не уровень усилий модели: с его включением Claude организует [динамические рабочие процессы](/docs/ru/workflows) для существенных задач, на любом уровне усилий, на котором работает сеанс. Для того, где это можно установить постоянно, см. параметр [`ultracode`](/docs/ru/settings-reference#ultracode).

661

662Включение или отключение ultracode с помощью `/effort` или параметра `ultracode` оставляет уровень усилий неизменным. Флаг `--effort ultracode` и значение Agent SDK `effortLevel: "ultracode"` включают его и также устанавливают уровень на `xhigh`. Выбор уровня в ползунке `/effort` или средстве выбора `/model` оставляет ultracode таким, как он был.

614 663

615Вы можете включить ultracode через любое из следующего:664Вы можете включить ultracode через любое из следующего:

616 665

617* **`/effort`**: запустите `/effort ultracode` или выберите его из меню666* **`/effort`**: запустите `/effort ultracode`, чтобы включить его для текущего сеанса, или `/effort ultracode off`, чтобы отключить его. В ползунке `/effort` нажмите `Tab`, чтобы переключить переключатель **Ultracode**, затем `Enter`, чтобы применить его

618* **Флаг `--effort`**: запустите с `claude --effort ultracode`, который запускает сеанс с усилиями `xhigh` и включенным ultracode667* **Флаг `--effort`**: запустите с `claude --effort ultracode`, который запускает сеанс с усилиями `xhigh` и включенным ultracode

619* **Параметр `ultracode`**: установите [`"ultracode": true`](/docs/ru/settings-reference#ultracode) в файле параметров, с `--settings` или в запросе управления Agent SDK. Запрос [`applyFlagSettings()`](/docs/ru/agent-sdk/typescript#applyflagsettings) также принимает `effortLevel: "ultracode"`668* **Параметр `ultracode`**: установите [`"ultracode": true`](/docs/ru/settings-reference#ultracode) в файле параметров, с `--settings` или в запросе управления Agent SDK. Запрос [`applyFlagSettings()`](/docs/ru/agent-sdk/typescript#applyflagsettings) также принимает `effortLevel: "ultracode"`, который включает его и устанавливает уровень усилий на `xhigh`

620* **Средство выбора `/model`**: переместите ползунок усилий на `ultracode` с помощью клавиш со стрелками, пока вы выбираете модель. Claude Code включает его для текущего сеанса, даже когда вы сохраняете эту модель как стандартную669

670Форма `/effort ultracode off`, переключатель ползунка и сохранение ultracode включенным на уровнях усилий, отличных от `xhigh`, требуют Claude Code версии 2.1.284 или позже. До версии 2.1.284 включение ultracode устанавливало сеанс на усилия `xhigh`, выбор другого уровня отключал его, и ограничение усилий ниже `xhigh` делало его недоступным.

621 671

622Передача `ultracode` флагу `--effort` или значению Agent SDK `effortLevel` требует Claude Code версии 2.1.203 или позже. До версии 2.1.203 `--effort ultracode` печатал `Unknown --effort value 'ultracode'` и сеанс начинался с усилиями по умолчанию.672Передача `ultracode` флагу `--effort` или значению Agent SDK `effortLevel` требует Claude Code версии 2.1.203 или позже. До версии 2.1.203 `--effort ultracode` печатал `Unknown --effort value 'ultracode'` и сеанс начинался с усилиями по умолчанию.

623 673

624Сохраненный параметр `effortLevel` и переменная окружения `CLAUDE_CODE_EFFORT_LEVEL` не принимают `ultracode`. Когда `CLAUDE_CODE_EFFORT_LEVEL` установлен на уровень, отличный от `xhigh`, запросы работают на этом уровне, и оркестрация рабочего процесса ultracode остается неактивной. Выбор ultracode затем показывает предупреждение, что переменная окружения переопределяет усилия для сеанса.674Сохраненный параметр `effortLevel` и переменная окружения `CLAUDE_CODE_EFFORT_LEVEL` не принимают `ultracode`. Если `CLAUDE_CODE_EFFORT_LEVEL` или [ограничение усилий](#organization-effort-limits) устанавливает уровень сеанса, ultracode остается включенным на этом уровне.

625 675

626<span id="when-ultracode-is-available" />676<span id="when-ultracode-is-available" />

627 677

629 679

630* [Рабочие процессы отключены](/docs/ru/workflows#turn-workflows-off)680* [Рабочие процессы отключены](/docs/ru/workflows#turn-workflows-off)

631* Модель не поддерживает усилия `xhigh`681* Модель не поддерживает усилия `xhigh`

632* [Ограничение усилий](#organization-effort-limits) ниже `xhigh` применяется к модели

633 682

634В этих случаях `--effort ultracode` запускает сеанс с отключенным ultracode, на наивысшем уровне усилий, который модель и любое ограничение позволяют, вплоть до `xhigh`.683В этих случаях `--effort ultracode` запускает сеанс с отключенным ultracode, на наивысшем уровне усилий, который модель и любое ограничение позволяют, вплоть до `xhigh`.

635 684

641 690

642| Уровень | Когда его использовать |691| Уровень | Когда его использовать |

643| :- | :- |692| :- | :- |

644| `low` | Зарезервируйте для коротких, ограниченных, чувствительных к задержкам задач, которые не требуют интеллекта |693| `low` | Быстрые обмены, где вы проверяете каждый результат, такие как мозговой штурм, первый набросок или небольшое изменение, такое как переименование |

645| `medium` | Снижает использование токенов для работы, чувствительной к затратам, которая может пожертвовать некоторым интеллектом. Стандартный на Opus 5.5 |694| `medium` | Стандартный на Opus 5.5 и Sonnet 5.5, где он подходит для повседневной инженерной работы с четкой областью, такой как реализация новой функции. На других моделях снижает использование токенов для работы, чувствительной к затратам, которая может пожертвовать некоторым интеллектом |

646| `high` | Балансирует использование токенов и интеллект. Стандартный на каждой модели, кроме Opus 5.5 и Opus 4.7 |695| `high` | Работа, где проверка имеет значение или вероятны граничные случаи, такие как исправление ошибки в существующей кодовой базе. Стандартный на каждой модели, кроме Opus 5.5, Sonnet 5.5 и Opus 4.7 |

648| `max` | Может улучшить производительность на сложных задачах, но может показать убывающую отдачу и склонен к чрезмерному размышлению. Протестируйте перед широким внедрением |697| `max` | Сложные проблемы, которые вы хотите, чтобы Claude решил без вас, такие как поиск уязвимостей безопасности. `max` может показать убывающую отдачу и склонен к чрезмерному размышлению, поэтому протестируйте перед широким внедрением |

649| `ultracode` | Параметр Claude Code, который планирует [динамический рабочий процесс](/docs/ru/workflows) для каждой существенной задачи с рассуждением `xhigh` для каждого сообщения |698| `ultracode` | Параметр Claude Code, а не уровень: планирует [динамический рабочий процесс](/docs/ru/workflows) для каждой существенной задачи на любом уровне усилий |

699

700В тестах на Opus 5.5 и Fable 5.1 Claude на более высоком уровне протестировал больше граничных случаев и проверил больше своей работы перед ответом. Он также сделал больше выборов самостоятельно. На более низком уровне Claude вернул начальную точку быстрее, что подходит для работы, где вы проверяете каждый результат и направляете следующий шаг. Чтобы увидеть одни и те же задачи, выполняемые на каждом уровне, прочитайте [Using Claude Code: Spending your effort](https://claude.dev/blog/spending-your-effort/) в блоге.

650 701

651Шкала усилий откалибрована для каждой модели, поэтому одно и то же имя уровня не представляет одно и то же базовое значение между моделями.702Шкала усилий откалибрована для каждой модели, поэтому одно и то же имя уровня не представляет одно и то же базовое значение между моделями.

652 703

704Opus 5.5 [по умолчанию имеет `medium`](#adjust-effort-level), на один уровень ниже стандарта Opus 5 в `high`. В тестировании Anthropic Opus 5.5 на `medium` соответствует или превосходит Opus 5 на `high` при оценке кодирования и работы со знаниями. На заданном уровне Opus 5.5 имеет тенденцию думать больше за ход, чем Opus 5. Когда вы переходите с Opus 5 на Opus 5.5, начните с `medium` вместо того, чтобы переносить уровень, который вы использовали на Opus 5. Чтобы протестировать уровни на вашей собственной работе, см. [Calibrate effort](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort) в руководстве по подсказкам Opus 5.5.

705

653<h4 id="use-ultrathink-for-one-off-deep-reasoning">706<h4 id="use-ultrathink-for-one-off-deep-reasoning">

654 Использование ultrathink для одноразового глубокого рассуждения707 Использование ultrathink для одноразового глубокого рассуждения

655</h4>708</h4>

682 735

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

684 737

685Модели Fable, Sonnet 5 и Opus 4.7 и позже всегда используют адаптивное рассуждение. Режим фиксированного бюджета размышления и `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` не применяются к ним.738Модели Fable, Sonnet 5 и позже, и Opus 4.7 и позже всегда используют адаптивное рассуждение. Режим фиксированного бюджета размышления и `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` не применяются к ним.

686 739

687На Opus 4.6 и Sonnet 4.6 вы можете установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`, чтобы вернуться к предыдущему фиксированному бюджету размышления, контролируемому `MAX_THINKING_TOKENS`. См. [переменные окружения](/docs/ru/env-vars).740На Opus 4.6 и Sonnet 4.6 вы можете установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`, чтобы вернуться к предыдущему фиксированному бюджету размышления, контролируемому `MAX_THINKING_TOKENS`. См. [переменные окружения](/docs/ru/env-vars).

688 741

689<h3 id="extended-thinking">742<h3 id="extended-thinking">

690 Расширенное размышление743 Extended thinking

691</h3>744</h3>

692 745

693Расширенное размышление — это рассуждение, которое Claude выдает перед ответом. На моделях, которые поддерживают [адаптивное рассуждение](#adjust-effort-level), уровень усилий является основным управлением тем, сколько размышления происходит; параметры ниже включают или отключают размышление и управляют тем, как оно отображается. С отключенным размышлением на Anthropic API Claude Code отправляет усилия `high` вместо более высокого уровня моделям, которые он знает [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5.746Extended thinking — это рассуждение, которое Claude выдает перед ответом. На моделях, которые поддерживают [адаптивное рассуждение](#adjust-effort-level), уровень усилий является основным управлением тем, сколько размышления происходит; параметры ниже включают или отключают размышление и управляют тем, как оно отображается. С отключенным размышлением на Anthropic API Claude Code отправляет усилия `high` вместо более высокого уровня моделям, которые он знает [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5.

694 747

695| Управление | Как его установить |748| Управление | Как его установить |

696| :- | :- |749| :- | :- |

698| Установка глобального стандартного | Запустите `/config` и переключите режим размышления. Сохранено как `alwaysThinkingEnabled` в `~/.claude/settings.json` |751| Установка глобального стандартного | Запустите `/config` и переключите Thinking Mode. Сохранено как `alwaysThinkingEnabled` в `~/.claude/settings.json` |

699| Отключение через переменную окружения | Установите [`MAX_THINKING_TOKENS=0`](/docs/ru/env-vars), что отключает размышление на Anthropic API, кроме Opus 5.5 и моделей Fable. На [сторонних поставщиках](/docs/ru/third-party-integrations) Claude Code опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения все еще могут думать. Другие значения применяются только с [фиксированным бюджетом размышления](#adaptive-reasoning-and-fixed-thinking-budgets) |752| Отключение через переменную окружения | Установите [`MAX_THINKING_TOKENS=0`](/docs/ru/env-vars), что отключает размышление на Anthropic API, кроме Opus 5.5, Sonnet 5.5 и моделей Fable. На [сторонних поставщиках](/docs/ru/third-party-integrations) Claude Code опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения все еще могут думать. Другие значения применяются только с [фиксированным бюджетом размышления](#adaptive-reasoning-and-fixed-thinking-budgets) |

700 753

701Вы не можете отключить размышление на Opus 5.5 или моделях Fable. Переключение сеанса, `alwaysThinkingEnabled` и `MAX_THINKING_TOKENS=0` не имеют эффекта там, и модель решает на каждом шаге, сколько думать на основе уровня усилий.754Вы не можете отключить размышление на Opus 5.5, Sonnet 5.5 или моделях Fable. Переключение сеанса, `alwaysThinkingEnabled` и `MAX_THINKING_TOKENS=0` не имеют эффекта там, и модель решает на каждом шаге, сколько думать на основе уровня усилий.

702 755

703Claude Code сворачивает вывод размышления по умолчанию. Нажмите `Ctrl+O`, чтобы переключить подробный режим и увидеть рассуждение как серый курсивный текст. Интерактивные сеансы на Anthropic API получают отредактированные блоки размышления по умолчанию, поэтому установите `showThinkingSummaries: true` в [параметрах](/docs/ru/settings), если вы хотите, чтобы полные резюме были доступны при расширении. Вам выставляется счет за все сгенерированные токены размышления, даже когда они свернуты или отредактированы.756Claude Code сворачивает вывод размышления по умолчанию. Нажмите `Ctrl+O`, чтобы переключить подробный режим и увидеть рассуждение как серый курсивный текст. Интерактивные сеансы на Anthropic API получают отредактированные блоки размышления по умолчанию, поэтому установите `showThinkingSummaries: true` в [параметрах](/docs/ru/settings), если вы хотите, чтобы полные резюме были доступны при расширении. Вам выставляется счет за все сгенерированные токены размышления, даже когда они свернуты или отредактированы.

704 757

758<a id="extended-context-with-1m" />

759

705<h3 id="extended-context">760<h3 id="extended-context">

706 Расширенный контекст761 Extended context

707</h3>762</h3>

708 763

709Fable 5.1, Fable 5, Sonnet 5, Opus 4.6 и позже, а также Sonnet 4.6 поддерживают [окно контекста в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов с большими кодовыми базами.764Fable 5.1, Fable 5, Sonnet 5 и позже, Opus 4.6 и позже, и Sonnet 4.6 поддерживают [окно контекста в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов с большими кодовыми базами.

710 765

711На Anthropic API Fable 5.1, Fable 5, Sonnet 5 и Opus 4.7 и позже работают с окном 1M по умолчанию на каждом плане, включая Pro. Вы не выбираете вариант `[1m]` или не включаете кредиты использования для окна 1M на этих моделях. Использование Fable само по себе может выставляться в счет кредитов использования на некоторых планах; см. [Fable и кредиты использования](#fable-and-usage-credits).766На Anthropic API Fable 5.1, Fable 5, Sonnet 5 и позже, и Opus 4.7 и позже работают с окном 1M по умолчанию на каждом плане, включая Pro. Вы не выбираете вариант `[1m]` или не включаете кредиты использования для окна 1M на этих моделях. Использование Fable само по себе может выставляться в счет кредитов использования на некоторых планах; см. [Fable и кредиты использования](#fable-and-usage-credits).

712 767

713Opus 4.6 и Sonnet 4.6 достигают 1M только через их вариант `[1m]`, и доступ к этому варианту зависит от вашего плана. На планах Max, Team и Enterprise, включая как места Team Standard, так и Team Premium, Opus 4.6 с контекстом 1M включен в вашу подписку. Sonnet 4.6 с контекстом 1M требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) на каждом плане подписки, включая Max.768Opus 4.6 и Sonnet 4.6 достигают 1M только через их вариант `[1m]`, и доступ к этому варианту зависит от вашего плана. На планах Max, Team и Enterprise, включая как места Team Standard, так и Team Premium, Opus 4.6 с контекстом 1M включен в вашу подписку. Sonnet 4.6 с контекстом 1M требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) на каждом плане подписки, включая Max.

714 769

722 777

723Чтобы отключить контекст 1M, установите `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code удаляет варианты модели 1M из средства выбора модели. На моделях с собственным окном 1M, таких как Sonnet 5 и модели Fable, он также рассматривает модель как имеющую окно контекста 200K:778Чтобы отключить контекст 1M, установите `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code удаляет варианты модели 1M из средства выбора модели. На моделях с собственным окном 1M, таких как Sonnet 5 и модели Fable, он также рассматривает модель как имеющую окно контекста 200K:

724 779

725* С включенным автоматическим компактированием сеансы компактируются на границе 200K через [автоматическое компактирование](#set-the-auto-compact-window). Установка окна автоматического компактирования выше 200K не снимает удержание, потому что Claude Code ограничивает это окно окном контекста модели.780* С включенным auto-compact сеансы компактируются на границе 200K через [auto-compact](#set-the-auto-compact-window). Установка окна auto-compact выше 200K не снимает удержание, потому что Claude Code ограничивает это окно окном контекста модели.

726* С отключенным автоматическим компактированием сеансы останавливаются на границе 200K с [ошибкой ограничения контекста](/docs/ru/errors#prompt-is-too-long) вместо компактирования.781* С отключенным auto-compact сеансы останавливаются на границе 200K с [ошибкой ограничения контекста](/docs/ru/errors#prompt-is-too-long) вместо компактирования.

727 782

728До версии 2.1.223 Claude Code удерживал только сеансы Sonnet 5, Opus 4.8 и Opus 5 на 200K. См. [переменные окружения](/docs/ru/env-vars).783До версии 2.1.223 Claude Code удерживал только сеансы Sonnet 5, Opus 4.8 и Opus 5 на 200K. См. [переменные окружения](/docs/ru/env-vars).

729 784

742/model claude-opus-4-8[1m]797/model claude-opus-4-8[1m]

743```798```

744 799

745<h4 id="sonnet-5-context-window">800<h4 id="sonnet-5-5-and-sonnet-5-context-window">

746 Окно контекста Sonnet 5801 Окно контекста Sonnet 5.5 и Sonnet 5

747</h4>802</h4>

748 803

749На Anthropic API Sonnet 5 всегда работает с окном контекста 1M. Нет варианта 200K, нет суффикса `[1m]` для выбора и нет требуемых кредитов использования ни на одном плане. Сеансы автоматически компактируются перед заполнением окна, примерно на 967K токенов по умолчанию; установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars), чтобы выбрать другой порог.804На Anthropic API Sonnet 5.5 и Sonnet 5 всегда работают с окном контекста 1M. Нет варианта 200K, нет суффикса `[1m]` для выбора и нет требуемых кредитов использования ни на одном плане. Сеансы автоматически компактируются перед заполнением окна, примерно на 967K токенов по умолчанию; установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars), чтобы выбрать другой порог.

750 805

751Две конфигурации бюджетируют окно на 200K вместо этого:806Две конфигурации бюджетируют окно на 200K вместо этого:

752 807

753* **LLM gateway**: когда `ANTHROPIC_BASE_URL` указывает на [шлюз](/docs/ru/llm-gateway), Claude Code не может проверить поддержку 1M. Чтобы использовать полное окно, выберите Sonnet 5 (1M context) в средстве выбора модели, которое сопоставляется с `sonnet[1m]`.808* **LLM gateway**: когда `ANTHROPIC_BASE_URL` указывает на [шлюз](/docs/ru/llm-gateway), Claude Code не может проверить поддержку 1M. Чтобы использовать полное окно, выберите Sonnet 5.5 (1M context) в средстве выбора модели, которое сопоставляется с `sonnet[1m]`, или запустите `/model claude-sonnet-5[1m]` для Sonnet 5.

754* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: удерживает сеансы на каждой модели с собственным окном 1M на окне 200K; см. [Расширенный контекст](#extended-context) для того, как удержание применяется. Полезно для развертываний, которым нужно ограничить контекст.809* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: удерживает сеансы на каждой модели с собственным окном 1M на окне 200K; см. [Extended context](#extended-context) для того, как удержание применяется. Полезно для развертываний, которым нужно ограничить контекст.

755 810

756<h2 id="context-window-and-auto-compaction">811<h2 id="context-window-and-auto-compaction">

757 Контекстное окно и auto-compact812 Контекстное окно и auto-compact

786* [Cloud sessions](/docs/ru/claude-code-on-the-web) выполняют компактирование по мере приближения разговора к пределу модели841* [Cloud sessions](/docs/ru/claude-code-on-the-web) выполняют компактирование по мере приближения разговора к пределу модели

787* Sonnet 4.6 и Opus 4.6 без [extended context](#extended-context) выполняют компактирование на границе 200K, как и Opus 4.8 и более поздние версии при работе с контекстным окном 200K, например на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry842* Sonnet 4.6 и Opus 4.6 без [extended context](#extended-context) выполняют компактирование на границе 200K, как и Opus 4.8 и более поздние версии при работе с контекстным окном 200K, например на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry

788* Когда вы установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars), модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют компактирование на границе 200K843* Когда вы установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars), модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют компактирование на границе 200K

789* Модели, работающие с собственным окном 1M, такие как Sonnet 5, модели Fable и Opus 4.7 и более поздние версии на Anthropic API, выполняют компактирование перед заполнением окна, примерно на 967K токенов по умолчанию. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry раздел [Pin models for third-party deployments](#pin-models-for-third-party-deployments) указывает, какие модели работают с этим окном; для конфигураций, которые бюджетируют Sonnet 5 на 200K, см. [Sonnet 5 context window](#sonnet-5-context-window)844* Модели, работающие с собственным окном 1M, такие как Sonnet 5, модели Fable и Opus 4.7 и более поздние версии на Anthropic API, выполняют компактирование перед заполнением окна, примерно на 967K токенов по умолчанию. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry раздел [Pin models for third-party deployments](#pin-models-for-third-party-deployments) указывает, какие модели работают с этим окном; для конфигураций, которые бюджетируют Sonnet 5.5 и Sonnet 5 на 200K, см. [Sonnet 5.5 and Sonnet 5 context window](#sonnet-5-5-and-sonnet-5-context-window)

790* Сеансы на ID модели, которую Claude Code не распознаёт, такие как псевдоним [LLM gateway](/docs/ru/llm-gateway), выполняют компактирование при контекстном окне, которое Claude Code предполагает для ID; см. [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)845* Сеансы на ID модели, которую Claude Code не распознаёт, такие как псевдоним [LLM gateway](/docs/ru/llm-gateway), выполняют компактирование при контекстном окне, которое Claude Code предполагает для ID; см. [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)

791 846

792<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">847<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">

861| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Модель для использования для `haiku`, или [фоновой функциональности](/docs/ru/costs#background-token-usage) |916| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Модель для использования для `haiku`, или [фоновой функциональности](/docs/ru/costs#background-token-usage) |

862| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель по умолчанию для [subagents](/docs/ru/sub-agents#choose-a-model), [agent team](/docs/ru/agent-teams#specify-teammates-and-models) товарищей по команде и [workflow](/docs/ru/workflows) агентов, которым не назначена модель другим способом. Принимает псевдоним, такой как `haiku`, или полное имя модели. Модель для каждого вызова или поле `model` определения, включая `inherit`, имеет приоритет. Чтобы изменить это, установите [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ru/sub-agents#run-every-subagent-on-one-model) |917| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель по умолчанию для [subagents](/docs/ru/sub-agents#choose-a-model), [agent team](/docs/ru/agent-teams#specify-teammates-and-models) товарищей по команде и [workflow](/docs/ru/workflows) агентов, которым не назначена модель другим способом. Принимает псевдоним, такой как `haiku`, или полное имя модели. Модель для каждого вызова или поле `model` определения, включая `inherit`, имеет приоритет. Чтобы изменить это, установите [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ru/sub-agents#run-every-subagent-on-one-model) |

863 918

919На поставщиках третьих сторон [Настройка отображения и возможностей закрепленной модели](#customize-pinned-model-display-and-capabilities) описывает, что показывает строка закрепленной модели в средстве выбора `/model`.

920

864Примечание: `ANTHROPIC_SMALL_FAST_MODEL` устарел в пользу `ANTHROPIC_DEFAULT_HAIKU_MODEL`.921Примечание: `ANTHROPIC_SMALL_FAST_MODEL` устарел в пользу `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

865 922

866<h3 id="pin-models-for-third-party-deployments">923<h3 id="pin-models-for-third-party-deployments">

995| Переменная окружения | Описание |1052| Переменная окружения | Описание |

996| - | - |1053| - | - |

997| `DISABLE_PROMPT_CACHING` | Установите на `1` для отключения кэширования подсказок для всех моделей. Имеет приоритет над параметрами для каждой модели |1054| `DISABLE_PROMPT_CACHING` | Установите на `1` для отключения кэширования подсказок для всех моделей. Имеет приоритет над параметрами для каждой модели |

998| `DISABLE_PROMPT_CACHING_HAIKU` | Установите на `1` для отключения кэширования подсказок только для моделей Haiku |1055| `DISABLE_PROMPT_CACHING_HAIKU` | Установите на `1` для отключения кэширования подсказок для [модели Haiku по умолчанию](/docs/ru/prompt-caching#disable-prompt-caching) |

1002 1059

1003Чтобы выбрать TTL кэша для основного разговора и для subagents отдельно, см. [выберите TTL самостоятельно](/docs/ru/prompt-caching#choose-the-ttl-yourself). Для того, что вызывает промах кэша, см. [Как Claude Code использует кэширование подсказок](/docs/ru/prompt-caching).1060Чтобы выбрать TTL кэша для основного разговора и для subagents отдельно, см. [выберите TTL самостоятельно](/docs/ru/prompt-caching#choose-the-ttl-yourself). Для того, что вызывает промах кэша, см. [Как Claude Code использует кэширование подсказок](/docs/ru/prompt-caching).

1061

1062<h2 id="version-history">

1063 История версий

1064</h2>

1065

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

1067

1068| Версия | Изменение |

1069| :- | :- |

1070| v2.1.284 | `sonnet` разрешается на Sonnet 5.5 в Anthropic API |

1071| v2.1.280 | `opus` разрешается на Opus 5.5 в Anthropic API, Claude Platform на AWS, Amazon Bedrock и Agent Platform Google Cloud |

1072| v2.1.257 | `fable` разрешается на Fable 5.1, кроме сеансов шлюза приложений Claude |

1073| v2.1.219 | `opus` разрешается на Opus 5 в Anthropic API, Claude Platform на AWS, Amazon Bedrock и Agent Platform |

1074| v2.1.207 | `opus` разрешается на Opus 4.8 в Claude Platform на AWS, Amazon Bedrock и Agent Platform |

1075| v2.1.197 | `sonnet` разрешается на Sonnet 5 в Anthropic API |

1076| v2.1.154 | `opus` разрешается на Opus 4.8 в Anthropic API |

1077| Более ранние | `opus` разрешается на Opus 4.7 в Claude Platform на AWS и на Opus 4.6 в Amazon Bedrock и Agent Platform. `fable` разрешается на Fable 5 у каждого поставщика |

monitoring-usage.md +287 −243

Details

39 39

40Чтобы проверить настройку, которая экспортирует метрики, проверьте вашу систему на наличие метрики `claude_code.session.count`, которую Claude Code отправляет при запуске сеанса. Чтобы проверить настройку только логов, отправьте запрос и проверьте событие `claude_code.user_prompt`.40Чтобы проверить настройку, которая экспортирует метрики, проверьте вашу систему на наличие метрики `claude_code.session.count`, которую Claude Code отправляет при запуске сеанса. Чтобы проверить настройку только логов, отправьте запрос и проверьте событие `claude_code.user_prompt`.

41 41

42Если ничего не поступает, запустите `claude --debug` и проверьте журнал отладки. Claude Code сообщает об ошибках от настроенных вами экспортеров как об ошибках `[3P telemetry]`, где 3P означает third-party. Строки с префиксом `[Anthropic telemetry]` описывают [отдельную операционную телеметрию Anthropic](/docs/ru/data-usage#telemetry-services) и не указывают на проблему с вашей настройкой.42Если ничего не поступает, запустите Claude Code с помощью `claude --debug-file <path>` и проверьте журнал, который он записывает в этот путь. Claude Code сообщает об ошибках от настроенных вами экспортеров как об ошибках `[3P telemetry]`, где 3P означает third-party. Строки с префиксом `[Anthropic telemetry]` описывают [отдельную операционную телеметрию Anthropic](/docs/ru/data-usage#telemetry-services) и не указывают на проблему с вашей настройкой.

43 43

44Для полного списка параметров конфигурации см. [спецификацию OpenTelemetry](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#configuration-options).44Для полного списка параметров конфигурации см. [спецификацию OpenTelemetry](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md#configuration-options).

45 45

72 Как управляемые параметры блокируют назначение OTLP72 Как управляемые параметры блокируют назначение OTLP

73</h3>73</h3>

74 74

75Когда вы устанавливаете переменную `OTEL_EXPORTER_OTLP_*` в управляемых параметрах, Claude Code удаляет конфликтующие переменные, установленные разработчиком при запуске, и регистрирует предупреждение, которое вы можете увидеть с помощью `claude --debug`. То, что удаляется, зависит от того, какую переменную вы установили:75Когда вы устанавливаете переменную `OTEL_EXPORTER_OTLP_*` в управляемых параметрах, Claude Code удаляет конфликтующие переменные, установленные разработчиком при запуске, и регистрирует предупреждение в журнале отладки. То, что удаляется, зависит от того, какую переменную вы установили:

76 76

77* **Endpoints**: когда вы устанавливаете `OTEL_EXPORTER_OTLP_ENDPOINT`, Claude Code удаляет каждый endpoint для конкретного сигнала, установленный разработчиком. Разработчики не могут направить один сигнал на другой сборщик, поэтому вам не нужно также устанавливать переменные endpoint для конкретного сигнала в управляемых параметрах.77* **Endpoints**: когда вы устанавливаете `OTEL_EXPORTER_OTLP_ENDPOINT`, Claude Code удаляет каждый endpoint для конкретного сигнала, установленный разработчиком. Разработчики не могут направить один сигнал на другой сборщик, поэтому вам не нужно также устанавливать переменные endpoint для конкретного сигнала в управляемых параметрах.

78* **Протоколы**: когда вы устанавливаете `OTEL_EXPORTER_OTLP_PROTOCOL`, Claude Code удаляет каждый протокол для конкретного сигнала, установленный разработчиком.78* **Протоколы**: когда вы устанавливаете `OTEL_EXPORTER_OTLP_PROTOCOL`, Claude Code удаляет каждый протокол для конкретного сигнала, установленный разработчиком.

103 Общие переменные конфигурации103 Общие переменные конфигурации

104</h3>104</h3>

105 105

106Эти переменные настраивают экспортеры, endpoints и поведение экспорта для всех развертываний.106Эти переменные настраивают экспортеры, конечные точки и поведение экспорта для всех развертываний.

107 107

108Если вы установите переменную endpoint или протокола для конкретного сигнала, такую как `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`, Claude Code использует её вместо универсальной переменной для этого сигнала. Если вы установите переменную заголовков для конкретного сигнала, такую как `OTEL_EXPORTER_OTLP_METRICS_HEADERS`, Claude Code объединяет её с универсальной переменной `OTEL_EXPORTER_OTLP_HEADERS` для этого сигнала.108Если вы установите переменную конечной точки или протокола для конкретного сигнала, такую как `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`, Claude Code использует её вместо универсальной переменной для этого сигнала. Если вы установите переменную заголовков для конкретного сигнала, такую как `OTEL_EXPORTER_OTLP_METRICS_HEADERS`, Claude Code объединяет её с универсальной переменной `OTEL_EXPORTER_OTLP_HEADERS` для этого сигнала.

109 109

110На машинах с управляемыми параметрами см. [Как управляемые параметры блокируют назначение OTLP](#how-managed-settings-lock-the-otlp-destination) для информации о том, что Claude Code удаляет.110На машинах с управляемыми параметрами см. [Как управляемые параметры блокируют назначение OTLP](#how-managed-settings-lock-the-otlp-destination), чтобы узнать, что Claude Code удаляет.

111 111

113| - | - | - |113| - | - | - |

114| `CLAUDE_CODE_ENABLE_TELEMETRY` | Включает сбор телеметрии (обязательно) | `1` |114| `CLAUDE_CODE_ENABLE_TELEMETRY` | Включает сбор телеметрии (обязательно) | `1` |

117| `OTEL_EXPORTER_OTLP_PROTOCOL` | Протокол для OTLP экспортера, применяется ко всем сигналам. Claude Code не имеет протокола по умолчанию, поэтому установите это или переменную протокола для конкретного сигнала для каждого включенного экспортера `otlp` | `grpc`, `http/json`, `http/protobuf` |117| `OTEL_EXPORTER_OTLP_PROTOCOL` | Протокол для экспортера OTLP, применяется ко всем сигналам. Claude Code не имеет протокола по умолчанию, поэтому установите эту переменную или переменную протокола для конкретного сигнала для каждого включённого экспортера `otlp` | `grpc`, `http/json`, `http/protobuf` |

127| `OTEL_LOGS_EXPORT_INTERVAL` | Интервал экспорта логов в миллисекундах (по умолчанию: 5000) | `1000`, `10000` |127| `OTEL_LOGS_EXPORT_INTERVAL` | Интервал экспорта логов в миллисекундах (по умолчанию: 5000) | `1000`, `10000` |

129| `OTEL_LOG_ASSISTANT_RESPONSES` | Включить логирование текста ответа ассистента на событиях `assistant_response` (по умолчанию: отключено). Если не установлено, возвращается к значению `OTEL_LOG_USER_PROMPTS`. Требует Claude Code v2.1.193 или позже | `1` для включения, `0` для сохранения скрытым |129| `OTEL_LOG_ASSISTANT_RESPONSES` | Включить логирование текста ответа ассистента на событиях `assistant_response` (по умолчанию: отключено). Если не установлено, возвращается к значению `OTEL_LOG_USER_PROMPTS`. Требует Claude Code v2.1.193 или позже | `1` для включения, `0` для сохранения скрытым |

130| `OTEL_LOG_TOOL_DETAILS` | Включить логирование параметров инструмента и аргументов входных данных в событиях инструментов и атрибутах span трассировки: команды Bash, имена MCP сервера и инструмента, имена навыков, имена пользовательских рабочих процессов и входные данные инструмента. Также включает пользовательские, плагин и MCP имена команд на событиях `user_prompt` (по умолчанию: отключено). Для встроенных серверов Claude Desktop в сеансах, которыми владеет Claude Desktop, `mcp_server_name`/`mcp_tool_name` выдаются на `tool_decision`/`tool_result` даже с отключенным флагом. Исключение требует Claude Code v2.1.214 или позже | `1` для включения |130| `OTEL_LOG_TOOL_DETAILS` | Включить логирование параметров инструмента и входных аргументов в событиях инструмента и атрибутах span трассировки: команды Bash, имена серверов MCP и инструментов, имена skills, имена пользовательских рабочих процессов и входные данные инструмента. Также включает имена пользовательских, plugin и MCP команд на событиях `user_prompt` и реальные имена агентов, skills, plugins и серверов MCP и инструментов на [счётчиках стоимости и токенов](#cost-counter) (по умолчанию: отключено). Для встроенных серверов Claude Desktop в сеансах, которыми владеет Claude Desktop, `mcp_server_name`/`mcp_tool_name` выдаются на `tool_decision`/`tool_result` даже с отключённым флагом. Исключение требует Claude Code v2.1.214 или позже | `1` для включения |

131| `OTEL_LOG_TOOL_CONTENT` | Включить логирование содержимого инструмента в событии span [`tool.output`](#tool-output-span-event) (по умолчанию: отключено). Атрибуты span несут содержимое инструмента под [их собственными вентилями](#new-context-gates). Требует [трассировку](#traces-beta). Содержимое усекается на лимит содержимого (60 КБ по умолчанию) | `1` для включения |131| `OTEL_LOG_TOOL_CONTENT` | Включить логирование содержимого инструмента в [событии span `tool.output`](#tool-output-span-event) (по умолчанию: отключено). Атрибуты span переносят содержимое инструмента под [их собственные шлюзы](#new-context-gates). Требует [трассировку](#traces-beta). Содержимое усекается на лимите содержимого (60 КБ по умолчанию) | `1` для включения |

132| `OTEL_LOG_MANAGED_SETTINGS` | Добавить скрытые управляемые параметры и дайджест SHA-256 параметров перед скрытием в события [управляемые параметры разрешены](#managed-settings-resolved-event) (по умолчанию: отключено). Значение в параметрах проекта или локальных параметрах не включает его. Требует Claude Code v2.1.274 или позже | `1` для включения |132| `OTEL_LOG_MANAGED_SETTINGS` | Добавить скрытые управляемые параметры и дайджест SHA-256 параметров перед скрытием на события [managed settings resolved](#managed-settings-resolved-event) (по умолчанию: отключено). Значение в параметрах проекта или локальных параметрах не включает его. Требует Claude Code v2.1.274 или позже | `1` для включения |

133| `OTEL_LOG_RAW_API_BODIES` | Выдавать полный JSON запроса и ответа Anthropic Messages API как события логов `api_request_body` / `api_response_body` (по умолчанию: отключено). Тела включают всю историю разговора. Включение этого подразумевает согласие со всем, что раскрыли бы `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` и `OTEL_LOG_TOOL_CONTENT` | `1` для встроенных тел, усеченных на лимит содержимого (60 КБ по умолчанию), или `file:<dir>` для неусеченных тел на диске с указателем `body_ref` в событии |133| `OTEL_LOG_RAW_API_BODIES` | Выдать полный запрос и ответ JSON API Anthropic Messages как события логов `api_request_body` / `api_response_body` (по умолчанию: отключено). Тела включают всю историю разговора. Включение этого подразумевает согласие на всё, что раскрыли бы `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` и `OTEL_LOG_TOOL_CONTENT` | `1` для встроенных тел, усечённых на лимите содержимого (60 КБ по умолчанию), или `file:<dir>` для неусечённых тел на диске с указателем `body_ref` в событии |

134| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Лимит содержимого: максимальная длина атрибутов, содержащих содержимое, таких как ответы модели, содержимое инструмента, системные подсказки и тела сырого API, включая маркер усечения, в единицах кода UTF-16 (по умолчанию: 61440, т.е. 60 КБ). По умолчанию размер рассчитан для бэкендов, которые ограничивают значения атрибутов на 64 КБ; увеличивайте его только если ваш бэкенд принимает большие значения, или уменьшайте его для снижения объема телеметрии. Когда установлен лимит атрибутов OpenTelemetry SDK, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` или один из его вариантов logrecord и span, Claude Code усекает на это меньшее значение, чтобы маркер `[TRUNCATED ...]` оставался в пределах лимита SDK. Требует Claude Code v2.1.214 или позже | `262144` |134| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Лимит содержимого: максимальная длина атрибутов, содержащих содержимое, таких как ответы модели, содержимое инструмента, системные подсказки и тела сырого API, включая маркер усечения, в единицах кода UTF-16 (по умолчанию: 61440, т.е. 60 КБ). По умолчанию размер рассчитан для бэкендов, которые ограничивают значения атрибутов на 64 КБ; увеличивайте его только если ваш бэкенд принимает большие значения, или уменьшайте, чтобы сократить объём телеметрии. Когда лимит атрибута OpenTelemetry SDK, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` или один из его вариантов logrecord и span, установлен ниже, Claude Code усекает на этом меньшем значении, чтобы маркер `[TRUNCATED ...]` оставался в пределах лимита SDK. Требует Claude Code v2.1.214 или позже | `262144` |

135| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Предпочтение временности метрик (по умолчанию: `delta`). Установите на `cumulative`, если ваш бэкенд ожидает кумулятивную временность | `delta`, `cumulative` |135| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Предпочтение временности метрик (по умолчанию: `delta`). Установите на `cumulative`, если ваш бэкенд ожидает кумулятивную временность | `delta`, `cumulative` |

136| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Интервал для обновления динамических заголовков (по умолчанию: 1740000ms / 29 минут) | `900000` |136| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Интервал обновления динамических заголовков (по умолчанию: 1740000ms / 29 минут) | `900000` |

137 137

138Для протоколов `http/protobuf` и `http/json` Claude Code отправляет каждый запрос экспорта с заголовком `Content-Length`. До v2.1.212 версии Claude Code от v2.1.191 и позже отправляли эти запросы с кодированием передачи по частям; Azure Monitor и другие endpoints, требующие объявленной длины, отклоняли их с ошибками `411 Length Required` или `400`.138Для протоколов `http/protobuf` и `http/json` Claude Code отправляет каждый запрос экспорта с заголовком `Content-Length`. До v2.1.212 версии Claude Code от v2.1.191 и позже отправляли эти запросы с кодированием передачи по частям; Azure Monitor и другие конечные точки, требующие объявленной длины, отклоняли их с ошибками `411 Length Required` или `400`.

139 139

140<h3 id="mtls-authentication">140<h3 id="mtls-authentication">

141 Аутентификация mTLS141 Аутентификация mTLS

142</h3>142</h3>

143 143

144Способ настройки сертификатов клиента для экспортера OTLP зависит от протокола OTLP, используемого для этого сигнала, установленного через `OTEL_EXPORTER_OTLP_PROTOCOL` или переопределение для каждого сигнала. Одна и та же конфигурация применяется к метрикам, логам и трассировкам.144Способ настройки сертификатов клиента для экспортера OTLP зависит от протокола OTLP, используемого для этого сигнала, установленного через `OTEL_EXPORTER_OTLP_PROTOCOL` или переопределение для конкретного сигнала. Одна и та же конфигурация применяется к метрикам, логам и трассировкам.

145 145

147| :- | :- | :- |147| :- | :- | :- |

148| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` и опционально `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. См. [Конфигурация сети](/docs/ru/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |148| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` и опционально `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. См. [Конфигурация сети](/docs/ru/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |

149| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` и `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, или переопределения для каждого сигнала, такие как `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` для использования другого сертификата для каждого сигнала | `OTEL_EXPORTER_OTLP_CERTIFICATE` |149| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` и `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, или варианты для конкретного сигнала, такие как `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY`, чтобы использовать другой сертификат для каждого сигнала | `OTEL_EXPORTER_OTLP_CERTIFICATE` |

150 150

151Для `grpc` SDK OpenTelemetry читает стандартные переменные OTLP напрямую, поэтому существующие конфигурации, которые устанавливают переменные метрик для каждого сигнала, продолжают работать. На машинах с управляемыми параметрами Claude Code [может удалить установленные разработчиком учетные данные и endpoints для каждого сигнала](#how-managed-settings-lock-the-otlp-destination) при запуске.151Для `grpc` OpenTelemetry SDK читает стандартные переменные OTLP напрямую, поэтому существующие конфигурации, которые устанавливают переменные метрик для конкретного сигнала, продолжают работать. На машинах с управляемыми параметрами Claude Code [может удалить установленные разработчиком учётные данные и конечные точки для конкретного сигнала](#how-managed-settings-lock-the-otlp-destination) при запуске.

152 152

153<h3 id="metrics-cardinality-control">153<h3 id="metrics-cardinality-control">

154 Управление кардинальностью метрик154 Контроль кардинальности метрик

155</h3>155</h3>

156 156

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

158 158

160| - | - | - | - |160| - | - | - | - |

166| `OTEL_METRICS_INCLUDE_REPOSITORY` | Включить атрибуты идентификации репозитория `vcs.*` [repository attributes](#repository-attributes) на метриках и событиях. Требует Claude Code v2.1.269 или позже | `false` | `true` |166| `OTEL_METRICS_INCLUDE_REPOSITORY` | Включить атрибуты идентификации репозитория `vcs.*` [repository identity attributes](#repository-attributes) на метрики и события. Требует Claude Code v2.1.269 или позже | `false` | `true` |

167 167

168Более низкая кардинальность обычно означает лучшую производительность и более низкие затраты на хранилище, но менее детальные данные для анализа.168Более низкая кардинальность обычно означает лучшую производительность и более низкие затраты на хранилище, но менее детальные данные для анализа.

169 169

171 Traces (beta)171 Traces (beta)

172</h3>172</h3>

173 173

174Распределенная трассировка экспортирует spans, которые связывают каждую пользовательскую подсказку с запросами API и выполнением инструментов, которые она вызывает, так что вы можете просмотреть полный запрос как одну трассировку в вашем бэкенде трассировки.174Распределённая трассировка экспортирует spans, которые связывают каждую пользовательскую подсказку с запросами API и выполнениями инструментов, которые она запускает, поэтому вы можете просмотреть полный запрос как одну трассировку в вашем бэкенде трассировки.

175 175

176Трассировка отключена по умолчанию. Чтобы включить её, установите оба `CLAUDE_CODE_ENABLE_TELEMETRY=1` и `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1`, затем установите `OTEL_TRACES_EXPORTER` для выбора места отправки spans. Трассировки повторно используют [общую конфигурацию OTLP](#common-configuration-variables) для endpoint, протокола, заголовков и [mTLS](#mtls-authentication). На машинах с управляемыми параметрами Claude Code [может удалить установленные разработчиком учетные данные и endpoints для каждого сигнала](#how-managed-settings-lock-the-otlp-destination) при запуске.176Трассировка отключена по умолчанию. Чтобы включить её, установите оба `CLAUDE_CODE_ENABLE_TELEMETRY=1` и `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1`, затем установите `OTEL_TRACES_EXPORTER`, чтобы выбрать, куда отправляются spans. Трассировки повторно используют [общую конфигурацию OTLP](#common-configuration-variables) для конечной точки, протокола, заголовков и [mTLS](#mtls-authentication). На машинах с управляемыми параметрами Claude Code [может удалить установленные разработчиком учётные данные и конечные точки для конкретного сигнала](#how-managed-settings-lock-the-otlp-destination) при запуске.

177 177

179| - | - | - |179| - | - | - |

180| `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` | Включить трассировку span (обязательно). `ENABLE_ENHANCED_TELEMETRY_BETA` также принимается | `1` |180| `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` | Включить трассировку span (обязательно). `ENABLE_ENHANCED_TELEMETRY_BETA` также принимается | `1` |

185| `OTEL_TRACES_EXPORT_INTERVAL` | Интервал экспорта пакета span в миллисекундах (по умолчанию: 5000) | `1000`, `10000` |185| `OTEL_TRACES_EXPORT_INTERVAL` | Интервал пакетного экспорта span в миллисекундах (по умолчанию: 5000) | `1000`, `10000` |

186 186

187Spans скрывают текст пользовательской подсказки, детали входных данных инструмента и содержимое инструмента по умолчанию. Установите `OTEL_LOG_USER_PROMPTS=1`, `OTEL_LOG_TOOL_DETAILS=1` и `OTEL_LOG_TOOL_CONTENT=1` для их включения.187Spans скрывают текст пользовательской подсказки, детали входных данных инструмента и содержимое инструмента по умолчанию. Установите `OTEL_LOG_USER_PROMPTS=1`, `OTEL_LOG_TOOL_DETAILS=1` и `OTEL_LOG_TOOL_CONTENT=1`, чтобы включить их.

188 188

189Когда трассировка активна, подпроцессы Bash и PowerShell автоматически наследуют переменную окружения `TRACEPARENT`, содержащую контекст трассировки W3C активного span выполнения инструмента. Это позволяет любому подпроцессу, который читает `TRACEPARENT`, родить свои собственные spans под той же трассировкой, обеспечивая сквозную распределенную трассировку через скрипты и команды, которые запускает Claude.189Когда трассировка активна, подпроцессы Bash и PowerShell автоматически наследуют переменную окружения `TRACEPARENT`, содержащую контекст трассировки W3C активного span выполнения инструмента. Это позволяет любому подпроцессу, который читает `TRACEPARENT`, родить свои собственные spans под одной и той же трассировкой, обеспечивая сквозную распределённую трассировку через скрипты и команды, которые запускает Claude.

190 190

191Когда трассировка активна и Claude Code подключен непосредственно к API Anthropic, каждый запрос модели несет заголовок W3C `traceparent`, установленный на контекст span `claude_code.llm_request`, и заголовок `traceresponse` API записывается как ссылка span. Вместе они соединяют spans Claude Code на стороне клиента с трассировкой на стороне сервера через любого совместимого посредника. Исходящие HTTP MCP запросы несут `traceparent` таким же образом. Заголовок не отправляется поставщикам третьих сторон.191Когда трассировка активна и Claude Code подключен непосредственно к API Anthropic, каждый запрос модели содержит заголовок W3C `traceparent`, установленный на контекст span `claude_code.llm_request`, и заголовок `traceresponse` API записывается как ссылка span. Вместе они соединяют spans Claude Code на стороне клиента с трассировкой на стороне сервера через любой совместимый посредник. Исходящие запросы HTTP MCP переносят `traceparent` таким же образом. Заголовок не отправляется сторонним поставщикам.

192 192

193По умолчанию заголовок `traceparent` на запросах модели и HTTP MCP отправляется только когда `ANTHROPIC_BASE_URL` не установлен или указывает на API Anthropic, так как некоторые прокси отклоняют неузнанные заголовки. Переменная `TRACEPARENT` подпроцесса управляется тем же переключателем для согласованности. Если вы запускаете Claude Code через пользовательский прокси `ANTHROPIC_BASE_URL` и хотите распространять контекст трассировки, установите `CLAUDE_CODE_PROPAGATE_TRACEPARENT=1`.193По умолчанию заголовок `traceparent` на запросах модели и HTTP MCP отправляется только когда `ANTHROPIC_BASE_URL` не установлен или указывает на API Anthropic, так как некоторые прокси отклоняют неизвестные заголовки. Переменная подпроцесса `TRACEPARENT` контролируется тем же переключателем для согласованности. Если вы запускаете Claude Code через пользовательский прокси `ANTHROPIC_BASE_URL` и хотите распространять контекст трассировки, установите `CLAUDE_CODE_PROPAGATE_TRACEPARENT=1`.

194 194

195В Agent SDK и неинтерактивных сеансах, запущенных с `-p`, Claude Code также читает `TRACEPARENT` и `TRACESTATE` из своего собственного окружения при запуске каждого span взаимодействия. Это позволяет процессу встраивания передать свой активный контекст трассировки W3C в подпроцесс, так что spans Claude Code появляются как дочерние элементы трассировки вызывающей стороны. Интерактивные сеансы игнорируют входящий `TRACEPARENT`, чтобы избежать случайного наследования значений окружения из CI или контейнерных сред.195В Agent SDK и неинтерактивных сеансах, запущенных с `-p`, Claude Code также читает `TRACEPARENT` и `TRACESTATE` из своего собственного окружения при запуске каждого span взаимодействия. Это позволяет процессу встраивания передать свой активный контекст трассировки W3C в подпроцесс, чтобы spans Claude Code появились как дочерние элементы распределённой трассировки вызывающей стороны. Интерактивные сеансы игнорируют входящий `TRACEPARENT`, чтобы избежать случайного наследования значений окружения из CI или контейнерных сред.

196 196

197Входящий контекст трассировки также применяется к [событиям](#events). В сеансах Agent SDK и `-p` с установленным `TRACEPARENT` каждая запись логов OTLP события несет значения `trace_id` и `span_id`, которые присоединяют её к трассировке вашего приложения, даже когда экспортер трассировок не настроен, так что ваш бэкенд логирования может коррелировать события с остальной частью трассировки.197Входящий контекст трассировки также применяется к [событиям](#events). В сеансах Agent SDK и `-p` с установленным `TRACEPARENT` каждая запись логов OTLP события содержит значения `trace_id` и `span_id`, которые присоединяют её к трассировке вашего приложения, даже когда экспортер трассировок не настроен, поэтому ваш бэкенд логирования может коррелировать события с остальной частью трассировки.

198 198

199Запись, выданная во время активного взаимодействия, несет ID span взаимодействия, даже когда Claude Code выдает её вне асинхронного контекста span, такого как в обратном вызове запроса разрешения или для записи, буферизованной во время запуска и экспортированной позже. Запись, выданная без активного span взаимодействия, несет ID входящего `TRACEPARENT` напрямую. До v2.1.214 записи, выданные вне активного span, несли ID входящего `TRACEPARENT` вместо ID span. До v2.1.212 записи событий, выданные вне активного span, не несли `trace_id` или `span_id`.199Запись, выданная во время активного взаимодействия, содержит ID span взаимодействия, даже когда Claude Code выдаёт её вне асинхронного контекста span, такого как обратный вызов подсказки разрешения или для записи, буферизованной при запуске и экспортированной позже. Запись, выданная без активного span взаимодействия, содержит ID входящего `TRACEPARENT` напрямую. До v2.1.214 записи, выданные вне асинхронного контекста span, содержали ID входящего `TRACEPARENT` вместо ID span. До v2.1.212 записи событий, выданные вне активного span, не содержали `trace_id` или `span_id`.

200 200

201<h4 id="span-hierarchy">201<h4 id="span-hierarchy">

202 Иерархия span202 Иерархия span

203</h4>203</h4>

204 204

205Каждая пользовательская подсказка запускает корневой span `claude_code.interaction`. Вызовы API, вызовы инструментов и выполнения hooks записываются как его дочерние элементы. Spans инструментов имеют два собственных дочерних span: один для времени, потраченного на ожидание решения о разрешении, и один для самого выполнения. Когда инструмент Agent или устаревший инструмент Task порождает подагента, spans API и инструментов подагента вложены под span `claude_code.tool` родителя.205Каждая пользовательская подсказка запускает корневой span `claude_code.interaction`. Вызовы API, вызовы инструментов и выполнения hooks записываются как его дочерние элементы. Spans инструментов имеют два собственных дочерних span: один для времени, потраченного на ожидание решения разрешения, и один для самого выполнения. Когда инструмент Agent или устаревший инструмент Task порождает подагента, spans API и инструментов подагента вложены под span `claude_code.tool` родителя.

206 206

207```text theme={null}207```text theme={null}

208claude_code.interaction208claude_code.interaction

211└── claude_code.tool211└── claude_code.tool

212 ├── claude_code.tool.blocked_on_user212 ├── claude_code.tool.blocked_on_user

213 ├── claude_code.tool.execution213 ├── claude_code.tool.execution

214 └── (инструмент Agent) spans claude_code.llm_request / claude_code.tool подагента214 └── (инструмент Agent) spans подагента claude_code.llm_request / claude_code.tool

215```215```

216 216

217В сеансах Agent SDK и `claude -p`, `claude_code.interaction` сам становится дочерним элементом span вызывающей стороны, когда `TRACEPARENT` установлен в окружении.217В сеансах Agent SDK и `claude -p` сам `claude_code.interaction` становится дочерним элементом span вызывающей стороны, когда `TRACEPARENT` установлен в окружении.

218 218

219Когда hook `PreToolUse` [откладывает вызов инструмента](/docs/ru/hooks#defer-a-tool-call-for-later), Claude Code сохраняет контекст трассировки хода, который отложил его. Когда вы возобновляете сеанс и инструмент повторно запускается, spans инструмента присоединяются к трассировке этого более раннего хода как дочерние элементы span `claude_code.interaction` хода.219Когда hook `PreToolUse` [откладывает вызов инструмента](/docs/ru/hooks#defer-a-tool-call-for-later), Claude Code сохраняет контекст трассировки хода, который отложил его. Когда вы возобновляете сеанс и инструмент повторно запускается, spans инструмента присоединяются к трассировке этого более раннего хода как дочерние элементы span `claude_code.interaction` хода.

220 220

222 Атрибуты span222 Атрибуты span

223</h4>223</h4>

224 224

225Каждый span несет [стандартные атрибуты](#standard-attributes) плюс атрибут `span.type`, соответствующий его имени. Таблицы ниже перечисляют дополнительные атрибуты, установленные на каждом span. Spans `llm_request`, `tool.execution` и `hook` устанавливают статус OpenTelemetry `ERROR` при записи сбоя; другие spans всегда заканчиваются со статусом `UNSET`.225Каждый span содержит [стандартные атрибуты](#standard-attributes) плюс атрибут `span.type`, соответствующий его имени. Таблицы ниже перечисляют дополнительные атрибуты, установленные на каждом span. Spans `llm_request`, `tool.execution` и `hook` устанавливают статус OpenTelemetry `ERROR`, когда они записывают сбой; другие spans всегда заканчиваются со статусом `UNSET`.

226 226

227**`claude_code.interaction`**227**`claude_code.interaction`**

228 228

230| - | - | - |230| - | - | - |

233| `interaction.sequence` | Счетчик на основе 1 взаимодействий, подсчитанный за процесс Claude Code, а не за сеанс, как описано для [`event.sequence`](#event-correlation-attributes) | |233| `interaction.sequence` | Счётчик взаимодействий на основе 1, считаемый за процесс Claude Code, а не за сеанс, как описано для [`event.sequence`](#event-correlation-attributes) | |

234| `parent.source` | Как span получил своего родителя трассировки: `env` когда он был родителем под входящим `TRACEPARENT`, `none` когда он запустил свою собственную трассировку. Требует Claude Code v2.1.268 или позже | |234| `parent.source` | Как span получил своего родителя трассировки: `env` когда он был родителем под входящим `TRACEPARENT`, `none` когда он запустил свою собственную трассировку. Требует Claude Code v2.1.268 или позже | |

236 236

237**`claude_code.llm_request`**237**`claude_code.llm_request`**

238 238

240| - | - | - |240| - | - | - |

245| `query_source_safe` | Ограниченная форма `query_source`, выданная независимо от того, активна ли детальная бета-трассировка, со значениями такими как `repl_main_thread` или `agent.builtin.general-purpose`. `:` становится `.` и названные пользователем агенты появляются как `agent.custom`. Требует Claude Code v2.1.268 или позже | |245| `query_source_safe` | Ограниченная форма `query_source`, выданная независимо от того, активна ли детальная бета-трассировка, со значениями такими как `repl_main_thread` или `agent.builtin.general-purpose`. `:` становится `.` и агенты с пользовательскими именами появляются как `agent.custom`. Требует Claude Code v2.1.268 или позже | |

247| `parent_agent_id` | Идентификатор агента, который породил этот. Отсутствует для основного сеанса и для агентов, порожденных непосредственно из него | |247| `parent_agent_id` | Идентификатор агента, который породил этот. Отсутствует для основного сеанса и для агентов, порождённых непосредственно из него | |

248| `workflow.run_id` | Идентификатор запуска инструмента [Workflow](/docs/ru/workflows), который породил этого агента, с префиксом `wf_`. Отсутствует для агентов, не порожденных рабочим процессом | |248| `workflow.run_id` | Идентификатор запуска [Workflow](/docs/ru/workflows) запуска инструмента, который породил этого агента, с префиксом `wf_`. Отсутствует для агентов, не порождённых рабочим процессом | |

249| `workflow.name` | Имя рабочего процесса, который породил этого агента. Имена, созданные пользователем, заменяются на `custom`, если gate не установлен | `OTEL_LOG_TOOL_DETAILS` |249| `workflow.name` | Имя рабочего процесса, который породил этого агента. Имена, созданные пользователем, заменяются на `custom`, если шлюз не установлен | `OTEL_LOG_TOOL_DETAILS` |

251| `effort` | [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применяемый к запросу: `low`, `medium`, `high`, `xhigh` или `max`. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия. Требует Claude Code v2.1.274 или позже | |251| `effort` | [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу: `low`, `medium`, `high`, `xhigh` или `max`. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия. Требует Claude Code v2.1.274 или позже | |

255| `first_content_ms` | Время от начала запроса до первого блока содержимого успешной попытки в миллисекундах. Отсутствует на запросах, которые вернулись к пути без потоковой передачи. Требует Claude Code v2.1.268 или позже | |255| `first_content_ms` | Время от начала запроса до первого блока содержимого успешной попытки в миллисекундах. Отсутствует на запросах, которые вернулись к пути без потоковой передачи. Требует Claude Code v2.1.268 или позже | |

267| `error_class` | Короткий токен класса ошибки при сбое запроса, такой как `api_timeout` или `server_overload`. Требует Claude Code v2.1.268 или позже | |267| `error_class` | Короткий токен класса ошибки, когда запрос не удался, такой как `api_timeout` или `server_overload`. Требует Claude Code v2.1.268 или позже | |

269| `stop_reason` | API ответ `stop_reason`, такой как `end_turn`, `tool_use`, `max_tokens`, `stop_sequence`, `pause_turn` или `refusal` | |269| `stop_reason` | API ответ `stop_reason`, такой как `end_turn`, `tool_use`, `max_tokens`, `stop_sequence`, `pause_turn` или `refusal` | |

270| `gen_ai.response.finish_reasons` | То же значение, что и `stop_reason`, обернутое в массив строк. Семантическое соглашение OpenTelemetry GenAI | |270| `gen_ai.response.finish_reasons` | Одно и то же значение как `stop_reason`, обёрнутое в массив строк. Семантическое соглашение OpenTelemetry GenAI | |

271 271

272Каждая повторная попытка также записывается как событие span `gen_ai.request.attempt` с атрибутами `attempt` и `client_request_id`.272Каждая повторная попытка также записывается как событие span `gen_ai.request.attempt` с атрибутами `attempt` и `client_request_id`.

273 273

274**`claude_code.tool`**274**`claude_code.tool`**

275 275

277| - | - | - |277| - | - | - |

279| `tool_name_safe` | Форма `tool_name`, которая не несет никаких названий, выбранных пользователем. Встроенные имена инструментов проходят дословно. Имена инструментов MCP появляются как `mcp_other`, за исключением имен инструментов, соответствующих нескольким фиксированным формам, таких как инструменты `playwright` с именами `browser_*`, которые проходят дословно. Требует Claude Code v2.1.268 или позже | |279| `tool_name_safe` | Форма `tool_name`, которая не содержит имён, выбранных пользователем. Встроенные имена инструментов проходят дословно. Имена инструментов MCP появляются как `mcp_other`, за исключением имён инструментов, соответствующих нескольким фиксированным формам, таких как инструменты `playwright` с именами `browser_*`, которые проходят дословно. Требует Claude Code v2.1.268 или позже | |

280| `bash_command_class` | Для инструмента Bash: категория первой программы команды из фиксированного списка, такая как `vcs` или `package_manager`. `other` для программы вне списка, `unparsed` когда строка не может быть разобрана. Требует Claude Code v2.1.268 или позже | |280| `bash_command_class` | Для инструмента Bash: категория первой программы команды из фиксированного списка, такая как `vcs` или `package_manager`. `other` для программы вне списка, `unparsed` когда строка не может быть разобрана. Требует Claude Code v2.1.268 или позже | |

281| `bash_argv0` | Для инструмента Bash: первая программа команды, когда она находится в том же фиксированном списке, такая как `git` или `npm`. `other` для любой программы вне списка. Требует Claude Code v2.1.268 или позже | |281| `bash_argv0` | Для инструмента Bash: первая программа команды, когда она находится в одном и том же фиксированном списке, такая как `git` или `npm`. `other` для любой программы вне списка. Требует Claude Code v2.1.268 или позже | |

285| `parent_agent_id` | Идентификатор агента, который породил этот. Отсутствует для основного сеанса и для агентов, порожденных непосредственно из него | |285| `parent_agent_id` | Идентификатор агента, который породил этот. Отсутствует для основного сеанса и для агентов, порождённых непосредственно из него | |

286| `workflow.run_id` | Идентификатор запуска инструмента Workflow, который породил этого агента, с префиксом `wf_`. Отсутствует для агентов, не порожденных рабочим процессом | |286| `workflow.run_id` | Идентификатор запуска инструмента Workflow, который породил этого агента, с префиксом `wf_`. Отсутствует для агентов, не порождённых рабочим процессом | |

287| `workflow.name` | Имя рабочего процесса, который породил этого агента. Имена, созданные пользователем, заменяются на `custom`, если gate не установлен | `OTEL_LOG_TOOL_DETAILS` |287| `workflow.name` | Имя рабочего процесса, который породил этого агента. Имена, созданные пользователем, заменяются на `custom`, если шлюз не установлен | `OTEL_LOG_TOOL_DETAILS` |

288| `tool_use_id` | ID блока `tool_use` модели для этого вызова. Совпадает с `tool_use_id` на событиях [tool\_result](#tool-result-event) и [tool\_decision](#tool-decision-event) и в полезных нагрузках hook, поэтому вы можете присоединить span к этим записям | |288| `tool_use_id` | ID блока `tool_use` модели для этого вызова. Совпадает с `tool_use_id` на событиях [tool\_result](#tool-result-event) и [tool\_decision](#tool-decision-event) и в полезных нагрузках hooks, поэтому вы можете присоединить span к этим записям | |

294 294

~~295<span id="tool-output-span-event" />**`tool.output` span event на `claude_code.tool`**~~295<span id="tool-output-span-event" />**Событие span `tool.output` на `claude_code.tool`**

296 296

297Если вы установите `OTEL_LOG_TOOL_CONTENT=1`, вызовы Read и Bash могут записать событие span `tool.output` на span `claude_code.tool`. Вызовы Edit и Write записывают его только когда вы также установите `OTEL_LOG_TOOL_DETAILS=1`. Эта переменная не ограничена этими двумя инструментами, поэтому проверьте её [строку в таблице конфигурации](#common-configuration-variables) для аргументов, которые она добавляет в другом месте.297Если вы установите `OTEL_LOG_TOOL_CONTENT=1`, вызовы Read и Bash могут записать событие span `tool.output` на span `claude_code.tool`. Вызовы Edit и Write записывают его только когда вы также установите `OTEL_LOG_TOOL_DETAILS=1`. Эта переменная не ограничена этими двумя инструментами, поэтому проверьте её [строку в таблице конфигурации](#common-configuration-variables) для аргументов, которые она добавляет в другом месте.

298 298

299Claude Code записывает это событие из успешного возврата вызова инструмента, поэтому вызов, который вызывает ошибку, не записывает ничего, независимо от инструмента. Среди вызовов, которые действительно возвращаются, он не записывает событие span `tool.output` для:299Инструменты MCP, WebFetch и WebSearch также записывают это событие на Claude Code v2.1.283 или позже.

300

301Claude Code записывает это событие из успешного возврата вызова инструмента, поэтому вызов, который вызывает ошибку, ничего не записывает, независимо от инструмента. Среди вызовов, которые действительно возвращаются, он не записывает событие `tool.output` для:

300 302

301* Вызова любого инструмента, отличного от Read, Edit, Write и Bash, включая MCP инструменты и WebFetch303* Вызова любого инструмента, отличного от Read, Edit, Write, Bash, WebFetch, WebSearch и инструментов MCP

302* Read, который возвращает что-либо, отличное от текста файла, такое как изображение, PDF или повторное чтение файла, содержимое которого не изменилось304* Read, который возвращает что-либо, отличное от текста файла, такое как изображение, PDF или повторное чтение файла, содержимое которого не изменилось

303* Вызова Edit или Write, если вы также не установите `OTEL_LOG_TOOL_DETAILS=1`305* Вызова Edit или Write, если вы также не установите `OTEL_LOG_TOOL_DETAILS=1`

306* Вызова WebFetch или WebSearch, который Claude Code переместил в фоновый режим, потому что вы прервали ход, чтобы [отправить ваши поставленные в очередь сообщения прямо сейчас](/docs/ru/interactive-mode#when-claude-code-sends-what-you-queued), пока вызов выполнялся. Claude получает этот результат позже, после того как span инструмента закончился

304 307

305Событие несет эти атрибуты, каждый усеченный на лимит содержимого (60 КБ по умолчанию). `Управляется` называет переменную, которая требуется атрибуту в дополнение к `OTEL_LOG_TOOL_CONTENT=1`, и для Edit и Write эта переменная управляет самим событием, а не атрибутом.308Событие содержит эти атрибуты, каждый усечённый на лимите содержимого (60 КБ по умолчанию). `Контролируется` называет переменную, которая нужна атрибуту в дополнение к `OTEL_LOG_TOOL_CONTENT=1`, и для Edit и Write эта переменная контролирует само событие, а не атрибут.

306 309

308| - | - | - |311| - | - | - |

310| `output` | Объединенный вывод команды Bash, с stderr чередующимся в stdout | |313| `output` | Для инструмента Bash, объединённый вывод команды, с stderr чередующимся в stdout. Для инструмента MCP, WebFetch или WebSearch, результат, который вернул инструмент: текстовые блоки, объединённые новыми строками, с изображением или документом, заменённым на заполнитель, такой как `[image]` | |

314 317

315Атрибут `tool_name` родительского span говорит вам, из какого инструмента пришло событие. Атрибут, усеченный на лимит содержимого, сопровождается `<attribute>_truncated` и `<attribute>_original_length`.318Атрибут `tool_name` родительского span говорит вам, из какого инструмента пришло событие. Атрибут, усечённый на лимите содержимого, сопровождается `<attribute>_truncated` и `<attribute>_original_length`.

316 319

317**`claude_code.tool.blocked_on_user`**320**`claude_code.tool.blocked_on_user`**

318 321

320| - | - | - |323| - | - | - |

324 327

325**`claude_code.tool.execution`**328**`claude_code.tool.execution`**

326 329

328| - | - | - |331| - | - | - |

333| `error` | Строка категории ошибки при сбое выполнения, такая как `Error:ENOENT` или `ShellError`. Содержит полное сообщение об ошибке вместо этого, когда gate установлен | `OTEL_LOG_TOOL_DETAILS` |336| `error` | Строка категории ошибки при сбое выполнения, такая как `Error:ENOENT` или `ShellError`. Содержит полное сообщение об ошибке вместо этого, когда шлюз установлен | `OTEL_LOG_TOOL_DETAILS` |

334| `error_class` | Категория ошибки в форме идентификатора, с символами вне букв, цифр и подчеркиваний, замененными на `_`, такой как `Error_ENOENT` или `ShellError`. Несет категорию даже когда `error` несет полное сообщение. Требует Claude Code v2.1.268 или позже | |337| `error_class` | Категория ошибки в форме идентификатора, с символами вне букв, цифр и подчёркиваний, заменённых на `_`, такой как `Error_ENOENT` или `ShellError`. Содержит категорию даже когда `error` содержит полное сообщение. Требует Claude Code v2.1.268 или позже | |

335 338

336**`claude_code.hook`**339**`claude_code.hook`**

337 340

338Этот span выдается только при активной детальной бета-трассировке, которая требует `ENABLE_BETA_TRACING_DETAILED=1` и `BETA_TRACING_ENDPOINT`, пара, которая также [изменяет место отправки ваших логов и трассировок](/docs/ru/env-vars#variables). Установите пару в вашей оболочке, пользовательских параметрах или управляемых параметрах; обе переменные игнорируются в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` один не производит это.341Этот span появляется только когда активна детальная бета-трассировка, которая требует `ENABLE_BETA_TRACING_DETAILED=1` и `BETA_TRACING_ENDPOINT`, пару, которая также [изменяет, куда идут ваши логи и трассировки](/docs/ru/env-vars#variables). Установите пару в вашей оболочке, пользовательских параметрах или управляемых параметрах; обе переменные игнорируются в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` один не производит его.

339 342

340В интерактивных сеансах CLI детальная бета-трассировка также требует, чтобы ваша организация была в списке разрешений для функции. Сеансы Agent SDK и неинтерактивные сеансы `-p` не требуют разрешения.343В интерактивных сеансах CLI детальная бета-трассировка также требует, чтобы ваша организация была в списке разрешений для функции. Сеансы Agent SDK и неинтерактивные сеансы `-p` не требуют списка разрешений.

341 344

343| - | - | - |346| - | - | - |

353 356

354<span id="new-context-gates" />357<span id="new-context-gates" />

355 358

356<Note>359<Note>

357 Дополнительные атрибуты, содержащие содержимое, такие как `new_context`, `system_prompt_preview`, `user_system_prompt`, `tool_input` и `response.model_output`, выдаются только при активной детальной бета-трассировке. Они не являются частью стабильной схемы span.360 Дополнительные атрибуты, содержащие содержимое, такие как `new_context`, `system_prompt_preview`, `user_system_prompt`, `tool_input` и `response.model_output`, выдаются только когда активна детальная бета-трассировка. Они не являются частью стабильной схемы span.

358 361

359 Вентиль на `new_context` зависит от того, какой span его несет, и каждая копия усекается на лимит содержимого (60 КБ по умолчанию). На span `claude_code.tool` он несет результат этого вызова инструмента, независимо от инструмента, и требует `OTEL_LOG_TOOL_CONTENT=1`. На span `claude_code.interaction` он несет пользовательскую подсказку, и на span `claude_code.llm_request` новые пользовательские сообщения и результаты инструментов этого запроса. Оба требуют `OTEL_LOG_USER_PROMPTS=1`.362 Шлюз на `new_context` зависит от того, какой span его содержит, и каждая копия усекается на лимите содержимого (60 КБ по умолчанию). На span `claude_code.tool` он содержит результат этого вызова инструмента, независимо от инструмента, и требует `OTEL_LOG_TOOL_CONTENT=1`. На span `claude_code.interaction` он содержит пользовательскую подсказку, и на span `claude_code.llm_request` новые пользовательские сообщения и результаты инструментов этого запроса. Оба требуют `OTEL_LOG_USER_PROMPTS=1`.

360 363

361 `user_system_prompt` дополнительно требует `OTEL_LOG_USER_PROMPTS=1`. Он содержит только текст системной подсказки, который вы предоставляете через опцию SDK `systemPrompt` или флаги `--system-prompt` и `--append-system-prompt`, усеченный на лимит содержимого (60 КБ по умолчанию), и выдается один раз за сеанс, а не за запрос.364 `user_system_prompt` дополнительно требует `OTEL_LOG_USER_PROMPTS=1`. Он содержит только текст системной подсказки, который вы предоставляете через опцию SDK `systemPrompt` или флаги `--system-prompt` и `--append-system-prompt`, усечённый на лимите содержимого (60 КБ по умолчанию), и выдаётся один раз за сеанс, а не за запрос.

362</Note>365</Note>

363 366

364<h3 id="dynamic-headers">367<h3 id="dynamic-headers">

365 Динамические заголовки368 Динамические заголовки

366</h3>369</h3>

367 370

368Для корпоративных сред, требующих динамической аутентификации, вы можете настроить скрипт для динамического создания заголовков. Динамические заголовки применяются только к протоколам `http/protobuf` и `http/json`. С протоколом `grpc` Claude Code использует только статические переменные заголовков, `OTEL_EXPORTER_OTLP_HEADERS` и его переопределения для каждого сигнала.371Для корпоративных сред, требующих динамической аутентификации, вы можете настроить скрипт для динамического создания заголовков. Динамические заголовки применяются только к протоколам `http/protobuf` и `http/json`. С протоколом `grpc` Claude Code использует только переменные статических заголовков, `OTEL_EXPORTER_OTLP_HEADERS` и его варианты для конкретного сигнала.

369 372

370<h4 id="settings-configuration">373<h4 id="settings-configuration">

371 Конфигурация параметров374 Конфигурация параметров

379}382}

380```383```

381 384

382Значение может быть путем к исполняемому файлу, включая путь, содержащий пробелы, или командной строкой shell с аргументами. На Windows значение всегда запускается через shell, поэтому заключите путь, содержащий пробелы, в кавычки внутри значения JSON.385Значение может быть путём к исполняемому файлу, включая путь, содержащий пробелы, или строкой команды оболочки с аргументами. На Windows значение всегда запускается через оболочку, поэтому заключите путь, содержащий пробелы, в кавычки внутри значения JSON.

383 386

384<h4 id="script-requirements">387<h4 id="script-requirements">

385 Требования к скрипту388 Требования к скрипту

386</h4>389</h4>

387 390

388Скрипт должен выводить корректный JSON с парами строк ключ-значение, представляющими HTTP заголовки:391Скрипт должен выводить действительный JSON с парами ключ-значение строк, представляющими заголовки HTTP:

389 392

390```bash theme={null}393```bash theme={null}

391#!/bin/bash394#!/bin/bash

393echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"396echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

394```397```

395 398

396Если помощник не удается или выводит содержимое, которое не соответствует этим требованиям, экспорты не удаются и ваш бэкенд телеметрии не получает ничего из сеанса до тех пор, пока помощник не будет работать снова. Claude Code сообщает об ошибке в:399Если помощник не удаётся или выводит вывод, который не соответствует этим требованиям, экспорты не удаются и ваш бэкенд телеметрии не получает ничего из сеанса, пока помощник снова не заработает. Claude Code сообщает об ошибке в:

397 400

398* Уведомлении предупреждения в интерактивных сеансах, [`otelHeadersHelper failed; telemetry is not being exported`](/docs/ru/errors#otelheadershelper-failed), показано один раз за сеанс, когда помощник впервые не удается401* Уведомление предупреждения в интерактивных сеансах, [`otelHeadersHelper failed; telemetry is not being exported`](/docs/ru/errors#otelheadershelper-failed), показано один раз за сеанс, когда помощник впервые не удаётся

399* выводе `/status`402* Вывод `/status`

400* журнале отладки при запуске с [`--debug`](/docs/ru/cli-reference#cli-flags) или после запуска `/debug` в сеансе403* Журнал отладки, при запуске с [`--debug`](/docs/ru/cli-reference#cli-flags) или после запуска `/debug` в сеансе

401* stderr в неинтерактивных сеансах, запущенных с `-p`404* stderr, в неинтерактивных сеансах, запущенных с `-p`

402 405

403<h4 id="refresh-behavior">406<h4 id="refresh-behavior">

404 Поведение обновления407 Поведение обновления

405</h4>408</h4>

406 409

407Скрипт помощника заголовков запускается при запуске и периодически после этого для поддержки обновления токена. По умолчанию скрипт запускается каждые 29 минут. Настройте интервал с помощью переменной окружения `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`.410Скрипт помощника заголовков запускается при запуске и периодически после этого для поддержки обновления токена. По умолчанию скрипт запускается каждые 29 минут. Настройте интервал с переменной окружения `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`.

408 411

409<h3 id="multi-team-organization-support">412<h3 id="multi-team-organization-support">

410 Поддержка многокомандной организации413 Поддержка организаций с несколькими командами

411</h3>414</h3>

412 415

413Организации с несколькими командами или отделами могут добавлять пользовательские атрибуты для различия между разными группами, используя переменную окружения `OTEL_RESOURCE_ATTRIBUTES`:416Организации с несколькими командами или отделами могут добавлять пользовательские атрибуты для различия между разными группами, используя переменную окружения `OTEL_RESOURCE_ATTRIBUTES`:

417export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"420export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

418```421```

419 422

420Эти пользовательские атрибуты будут включены во все метрики и события, позволяя вам:423Эти пользовательские атрибуты включены во все метрики и события, позволяя вам:

421 424

422* Фильтровать метрики по команде или отделу425* Фильтровать метрики по команде или отделу

423* Отслеживать затраты по центру затрат426* Отслеживать затраты по центру затрат

424* Создавать панели мониторинга для конкретных команд427* Создавать панели мониторинга для конкретных команд

425* Настраивать оповещения для конкретных команд428* Настраивать оповещения для конкретных команд

426 429

427Claude Code прикрепляет эти значения как атрибуты на каждой точке данных метрик и записи событий, в дополнение к отправке их в блоке ресурсов OTLP. Поскольку большинство бэкендов метрик предоставляют атрибуты точек данных как запрашиваемые метки, вы можете группировать и фильтровать метрики по вашим пользовательским ключам напрямую. За исключением атрибутов репозитория `vcs.*` [repository attributes](#repository-attributes), пользовательские ключи никогда не переопределяют [стандартные атрибуты](#standard-attributes), такие как `user.id` или `session.id`: когда ключ конфликтует, Claude Code сохраняет встроенное значение.430Claude Code присоединяет эти значения как атрибуты на каждой точке данных метрики и записи события, в дополнение к отправке их в блоке ресурсов OTLP. Поскольку большинство бэкендов метрик предоставляют атрибуты точек данных как запрашиваемые метки, вы можете группировать и фильтровать метрики по вашим пользовательским ключам напрямую. За исключением атрибутов репозитория `vcs.*` [repository attributes](#repository-attributes), пользовательские ключи никогда не переопределяют [стандартные атрибуты](#standard-attributes), такие как `user.id` или `session.id`: когда ключ конфликтует, Claude Code сохраняет встроенное значение.

428 431

429Каждый пользовательский ключ становится меткой на каждой серии метрик, поэтому высококардинальные значения увеличивают затраты на хранилище в вашем бэкенде метрик. Чтобы отправлять пользовательские атрибуты только в блоке ресурсов и опускать их из меток точек данных, установите `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false`. См. [Управление кардинальностью метрик](#metrics-cardinality-control).432Каждый пользовательский ключ становится меткой на каждой серии метрик, поэтому значения высокой кардинальности увеличивают затраты на хранилище в вашем бэкенде метрик. Чтобы отправлять пользовательские атрибуты только в блоке ресурсов и опускать их из меток точек данных, установите `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false`. См. [Контроль кардинальности метрик](#metrics-cardinality-control).

430 433

431<Warning>434<Warning>

432 Переменная окружения `OTEL_RESOURCE_ATTRIBUTES` использует пары ключ=значение, разделенные запятыми, со строгими требованиями к форматированию:435 Переменная окружения `OTEL_RESOURCE_ATTRIBUTES` использует пары ключ=значение, разделённые запятыми, со строгими требованиями к форматированию:

433 436

434 * **Пробелы не допускаются**: значения не могут содержать пробелы. Например, `user.organizationName=My Company` недопустимо437 * **Пробелы не допускаются**: значения не могут содержать пробелы. Например, `user.organizationName=My Company` недействительно

435 * **Формат**: должны быть пары ключ=значение, разделенные запятыми: `key1=value1,key2=value2`438 * **Формат**: должны быть пары ключ=значение, разделённые запятыми: `key1=value1,key2=value2`

436 * **Допустимые символы**: только символы US-ASCII, исключая управляющие символы, пробелы, двойные кавычки, запятые, точки с запятой и обратные слэши439 * **Допустимые символы**: только символы US-ASCII, исключая управляющие символы, пробелы, двойные кавычки, запятые, точки с запятой и обратные косые черты

437 * **Специальные символы**: символы вне допустимого диапазона должны быть закодированы в процентах440 * **Специальные символы**: символы вне допустимого диапазона должны быть процентно-кодированы

438 441

439 Для значения, которому нужен пробел, используйте подчеркивания или camelCase вместо этого. Следующие примеры устанавливают `org.name` с каждой формой:442 Для значения, которому нужен пробел, используйте подчёркивания или camelCase вместо этого. Следующие примеры устанавливают `org.name` с каждой формой:

440 443

441 ```bash theme={null}444 ```bash theme={null}

442 export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"445 export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"

443 export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"446 export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"

444 ```447 ```

445 448

446 Вы можете закодировать в процентах любой символ, не только исключенные. Этот пример кодирует как пробел, так и апостроф:449 Вы можете процентно-кодировать любой символ, не только исключённые. Этот пример кодирует как пробел, так и апостроф:

447 450

448 ```bash theme={null}451 ```bash theme={null}

449 export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"452 export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"

450 ```453 ```

451 454

452 Заключение значений в кавычки не экранирует пробелы. Например, `org.name="My Company"` приводит к буквальному значению `"My Company"` с кавычками включены, а не `My Company`.455 Обёртывание значений в кавычки не экранирует пробелы. Например, `org.name="My Company"` приводит к буквальному значению `"My Company"` с включёнными кавычками, а не `My Company`.

453</Warning>456</Warning>

454 457

455<h3 id="example-configurations">458<h3 id="example-configurations">

456 Примеры конфигураций459 Примеры конфигураций

457</h3>460</h3>

458 461

459Установите эти переменные окружения перед запуском `claude`. Каждый сценарий ниже показывает полную конфигурацию, и каждая переменная описана в разделе [Общие переменные конфигурации](#common-configuration-variables). Чтобы подтвердить, что конфигурация вступила в силу, проверьте ваш бэкенд на наличие метрики `claude_code.session.count` после запуска сеанса; раздел [Быстрый старт](#quick-start) охватывает проверку только логов и что проверять, когда ничего не приходит.462Установите эти переменные окружения перед запуском `claude`. Каждый сценарий ниже показывает полную конфигурацию, и каждая переменная описана в разделе [Общие переменные конфигурации](#common-configuration-variables). Чтобы подтвердить, что конфигурация вступила в силу, проверьте ваш бэкенд на наличие метрики `claude_code.session.count` после запуска сеанса; [Быстрый старт](#quick-start) охватывает проверку только логов и что проверить, когда ничего не приходит.

460 463

461Для отладки консоли с интервалом экспорта 1 секунда:464Для отладки консоли с интервалом экспорта 1 секунда:

462 465

482export OTEL_METRICS_EXPORTER=prometheus485export OTEL_METRICS_EXPORTER=prometheus

483```486```

484 487

485На [самостоятельно размещенной среде](/docs/ru/self-hosted-environments-reference#pass-through-session-child-metrics) сеанс привязывает порт 9464 только при емкости по умолчанию для одного запуска. При более высокой емкости запуск повторно выставляет счетчики сеансов и датчики на своей собственной конечной точке `/metrics` вместо этого.488В [самостоятельно размещённой среде](/docs/ru/self-hosted-environments-reference#pass-through-session-child-metrics) сеанс привязывает порт 9464 только при мощности по умолчанию в один. При более высокой мощности бегун повторно выставляет счётчики и датчики сеанса на своей собственной конечной точке `/metrics` вместо этого.

486 489

487Для отправки метрик нескольким экспортерам:490Для отправки метрик нескольким экспортерам:

488 491

492export OTEL_EXPORTER_OTLP_PROTOCOL=http/json495export OTEL_EXPORTER_OTLP_PROTOCOL=http/json

493```496```

494 497

495Для отправки метрик и логов на разные endpoints или бэкенды:498Для отправки метрик и логов на разные конечные точки или бэкенды:

496 499

497```bash theme={null}500```bash theme={null}

498export CLAUDE_CODE_ENABLE_TELEMETRY=1501export CLAUDE_CODE_ENABLE_TELEMETRY=1

522export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317525export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

523```526```

524 527

528<h2 id="telemetry-from-cloud-sessions-and-claude-tag">

529 Телеметрия из облачных сеансов и Claude Tag

530</h2>

531

532[Облачные сеансы](/docs/ru/claude-code-on-the-web), включая сеансы канала [Claude Tag](https://claude.com/docs/claude-tag/overview), работают в [облачных окружениях](/docs/ru/cloud-environments) вместо устройств ваших пользователей, поэтому управляемый файл параметров или профиль оболочки на этих устройствах не настраивает их телеметрию. Для сеансов в окружениях, размещённых Anthropic, этот раздел охватывает, где устанавливать переменные телеметрии, как сделать ваш сборщик доступным из окружения и как различать облачные сеансы и сеансы Claude Tag в экспортированных данных.

533

534Чтобы экспортировать телеметрию из этих сеансов, установите `CLAUDE_CODE_ENABLE_TELEMETRY` и переменные `OTEL_*`, используя те же ключи, что и в примере [конфигурации администратора](#administrator-configuration), в одном из двух мест:

535

536* **Параметры, управляемые сервером**: добавьте их в блок `env` [параметров, управляемых сервером](/docs/ru/server-managed-settings) вашей организации. Claude Code получает эти параметры при запуске везде, где [применяются параметры, управляемые сервером](/docs/ru/model-config#surface-coverage), что включает машины ваших пользователей и облачные сеансы, кроме сеансов канала Claude Tag. Сеансы Claude Tag не получают ваши параметры, управляемые сервером, поэтому этот способ их не настраивает.

537* **Переменные окружения**: добавьте их в [переменные окружения](/docs/ru/cloud-environments#set-environment-variables) облачного окружения, чтобы настроить только сеансы, работающие в этом окружении. Это способ, который достигает сеансов Claude Tag.

538

539Любой, кто использует окружение, может читать его переменные, поэтому не помещайте туда учётные данные, такие как токен сборщика в `OTEL_EXPORTER_OTLP_HEADERS`. [Учётные данные API](/docs/ru/cloud-environments#add-api-credentials) в окружении тоже не помогут, потому что собственный экспорт телеметрии Claude Code — это один из [запросов, которые никогда не получают учётные данные](/docs/ru/cloud-environments#requests-that-never-get-the-credential). Если ваш сборщик требует учётные данные, настройте весь экспорт через параметры, управляемые сервером, вместо этого, потому что когда вы устанавливаете учётные данные там, [Claude Code удаляет переменные конечной точки, установленные вне управляемых параметров](#how-managed-settings-lock-the-otlp-destination).

540

541Помните об этих ограничениях при настройке телеметрии для облачных сеансов:

542

543* **Позвольте сеансам достичь сборщика**: Claude Code отправляет экспорт через сеть сеанса, поэтому достигнет ли он хоста в вашем `OTEL_EXPORTER_OTLP_ENDPOINT`, зависит от [уровня сетевого доступа](/docs/ru/cloud-environments#access-levels) окружения. Если сеансы не могут достичь домена сборщика на выбранном вами уровне, [добавьте домен в список разрешений окружения](/docs/ru/cloud-environments#allow-specific-domains), потому что ни один параметр, управляемый сервером, не добавляет домены в список разрешений сети окружения.

544* **Каналы Claude Tag используют окружения уровня организации**: сеансы канала работают в окружениях уровня организации, а не в личных окружениях членов, поэтому внесите изменения в список разрешений и любые переменные окружения в [общем окружении](/docs/ru/cloud-environments#organization-shared-environments), установленном как стандартное для вашей организации или закреплённом на канале.

545* **Cowork настраивается отдельно**: сеансы Cowork не получают параметры, управляемые сервером, как показывает [таблица охвата поверхности](/docs/ru/model-config#surface-coverage), поэтому блок `env`, управляемый сервером, не настраивает их телеметрию.

546

547<h3 id="attribute-telemetry-to-cloud-sessions">

548 Атрибутирование телеметрии облачным сеансам

549</h3>

550

551По умолчанию метрики и события из облачного сеанса содержат [стандартные атрибуты](#standard-attributes), включая `session.id`, `ccr.session.id` и `organization.id`, поэтому вы можете фильтровать по сеансу или организации без дополнительной настройки. Значение `ccr.session.id` — это `CLAUDE_CODE_REMOTE_SESSION_ID` сеанса. Чтобы преобразовать его в URL транскрипта сеанса, см. [Связать вывод обратно с сеансом](/docs/ru/cloud-environments#link-output-back-to-the-session).

552

553Чтобы атрибутировать телеметрию более подробно, используйте эти параметры:

554

555* **Определить сеансы Claude Tag**: установите `OTEL_METRICS_INCLUDE_ENTRYPOINT=true`, как описано в разделе [Контроль кардинальности метрик](#metrics-cardinality-control). Метрики затем содержат `app.entrypoint`, значение которого — `claude-in-slack` для сеансов Claude Tag.

556* **Добавить пользовательские атрибуты**: установите [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support) в том же месте, где вы устанавливаете другие переменные `OTEL_*` для этих сеансов. Если вы `export` его в [скрипте настройки](/docs/ru/cloud-environments#setup-scripts) окружения вместо этого, значение не достигает Claude Code: скрипт настройки — это отдельный скрипт Bash, который запускается перед запуском Claude Code, и переменные, которые он экспортирует, заканчиваются с ним.

557

558В сеансах канала Claude Tag Claude работает как [общая идентичность](/docs/ru/cloud-environments#set-the-environment-a-claude-tag-channel-uses) вашей организации, а не как какой-либо член, поэтому не полагайтесь на атрибуты `user.*` для определения того, кто отметил Claude.

559

525<h2 id="available-metrics-and-events">560<h2 id="available-metrics-and-events">

526 Доступные метрики и события561 Доступные метрики и события

527</h2>562</h2>

532 567

533Все метрики и события имеют эти стандартные атрибуты:568Все метрики и события имеют эти стандартные атрибуты:

534 569

536| - | - | - |571| - | - | - |

573| `ccr.session.id` | Идентификатор облачного сеанса, значение `CLAUDE_CODE_REMOTE_SESSION_ID`, в сеансах, которые работают в [облачной среде](/docs/ru/cloud-environments) | `OTEL_METRICS_INCLUDE_SESSION_ID` (по умолчанию: true) |

539| `app.entrypoint` | Способ запуска сеанса, например `cli`, `sdk-cli`, `sdk-ts`, `sdk-py` или `claude-vscode` | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (по умолчанию: false) |575| `app.entrypoint` | Способ запуска сеанса, например `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, `claude-vscode` или `claude-in-slack` для сеансов Claude Tag | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (по умолчанию: false) |

542| `user.account_id` | ID учётной записи в формате с тегами, соответствующий API администратора Anthropic (при аутентификации), например `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (по умолчанию: true) |578| `user.account_id` | ID учётной записи в формате с тегом, соответствующий API администратора Anthropic (при аутентификации), например `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (по умолчанию: true) |

543| `user.id` | Случайный анонимный идентификатор, созданный при первом запуске и сохранённый в `~/.claude.json`. Он не содержит личной информации и не является производным от вашей учётной записи Claude. Удаление файла создаёт новое несвязанное значение при следующем запуске. | Всегда включается |579| `user.id` | Случайный анонимный идентификатор, созданный при первом запуске и сохранённый в `~/.claude.json`. Он не содержит личной информации и не является производным от вашей учётной записи Claude. Удаление файла создаёт новое несвязанное значение при следующем запуске. | Всегда включается |

544| `user.email` | Адрес электронной почты пользователя из вашего входа или, в [облачном сеансе](/docs/ru/claude-code-on-the-web), из учётных данных самого сеанса | Всегда включается, когда доступен |580| `user.email` | Адрес электронной почты пользователя, из вашего входа или, в [облачном сеансе](/docs/ru/claude-code-on-the-web), из учётных данных самого сеанса | Всегда включается, если доступно |

546| Ключи из `OTEL_RESOURCE_ATTRIBUTES` | Пользовательские атрибуты, которые вы устанавливаете, например `department` или `team.id`. См. [Поддержка многокомандной организации](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (по умолчанию: true) |582| Ключи из `OTEL_RESOURCE_ATTRIBUTES` | Пользовательские атрибуты, которые вы устанавливаете, например `department` или `team.id`. См. [Поддержка многокомандной организации](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (по умолчанию: true) |

547| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | Идентификация репозитория сеанса, полученная из его удалённого хранилища `origin`. См. [Атрибуты репозитория](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (по умолчанию: false). Требуется Claude Code v2.1.269 или позже |583| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | Идентификатор репозитория сеанса, полученный из его удалённого хранилища `origin`. См. [Атрибуты репозитория](#repository-attributes) | `OTEL_METRICS_INCLUDE_REPOSITORY` (по умолчанию: false). Требуется Claude Code v2.1.269 или позже |

548 584

549Когда Claude Code подписан на [шлюз приложений Claude](/docs/ru/claude-apps-gateway), CLI помечает экспорты аутентифицированной идентификацией из сеанса шлюза: `user.id` — это субъект IdP, а не анонимный идентификатор установки, `user.email` — это адрес электронной почты входа, а `user.groups` содержит членство в группе IdP в виде строки, разделённой запятыми. Каждый экспорт также содержит `identity.source: gateway-oidc`. Идентификация шлюза применяется последней, поэтому ключи `user.*` и `identity.*`, установленные через `OTEL_RESOURCE_ATTRIBUTES`, игнорируются в сеансах шлюза.585Когда Claude Code подписан на [шлюз приложений Claude](/docs/ru/claude-apps-gateway), CLI помечает экспорты аутентифицированной идентификацией из сеанса шлюза: `user.id` — это субъект IdP, а не анонимный идентификатор установки, `user.email` — это адрес электронной почты входа, и `user.groups` содержит членство в группе IdP в виде строки, разделённой запятыми. Каждый экспорт также содержит `identity.source: gateway-oidc`. Идентификация шлюза применяется последней, поэтому ключи `user.*` и `identity.*`, установленные через `OTEL_RESOURCE_ATTRIBUTES`, игнорируются в сеансах шлюза.

550 586

551События дополнительно включают следующие атрибуты. Они никогда не прикрепляются к метрикам, так как это вызовет неограниченную кардинальность:587События дополнительно включают следующие атрибуты. Они никогда не прикрепляются к метрикам, так как это вызовет неограниченную кардинальность:

552 588

553* `prompt.id`: UUID, коррелирующий пользовательский запрос со всеми последующими событиями до следующего запроса. См. [Атрибуты корреляции событий](#event-correlation-attributes).589* `prompt.id`: UUID, коррелирующий пользовательский запрос со всеми последующими событиями до следующего запроса. См. [Атрибуты корреляции событий](#event-correlation-attributes).

554* `workspace.host_paths`: каталоги рабочей области хоста, выбранные в приложении для рабочего стола, в виде массива строк590* `workspace.host_paths`: каталоги рабочей области хоста, выбранные в приложении для рабочего стола, как массив строк

555* `workflow.run_id`: идентификатор запуска с префиксом `wf_` на событиях API и инструментов, выпущенных агентами, которые принадлежат запуску инструмента [Workflow](/docs/ru/workflows). Фильтрация событий по одному `workflow.run_id` восстанавливает запросы API и результаты инструментов этого запуска. Идентификатор охватывает агентов, которых порождает скрипт рабочего процесса, и любых агентов, которых они порождают в свою очередь, например вызовы навыков. Он совпадает с идентификатором запуска, указанным в результате инструмента Workflow. Отсутствует на всех остальных событиях. Требуется Claude Code v2.1.202 или позже591* `workflow.run_id`: идентификатор запуска, с префиксом `wf_`, в API и событиях инструментов, выпущенных агентами, которые принадлежат запуску инструмента [Workflow](/docs/ru/workflows). Фильтрация событий по одному `workflow.run_id` восстанавливает запросы API и результаты инструментов этого запуска. Идентификатор охватывает агентов, которых порождает скрипт рабочего процесса, и любых агентов, которых они порождают в свою очередь, например вызовы навыков. Он совпадает с идентификатором запуска, указанным в результате инструмента Workflow. Отсутствует во всех остальных событиях. Требуется Claude Code v2.1.202 или позже

556* `workflow.name`: имя рабочего процесса, `meta.name` его скрипта, выпущенное вместе с `workflow.run_id`. Встроенные имена рабочих процессов отображаются как есть при выполнении немодифицированного встроенного скрипта. Имена, созданные пользователем, включая отредактированные копии встроенных скриптов, заменяются на `custom`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`. Требуется Claude Code v2.1.202 или позже592* `workflow.name`: имя рабочего процесса, `meta.name` его скрипта, выпущенное вместе с `workflow.run_id`. Встроенные имена рабочих процессов отображаются как есть при выполнении немодифицированного встроенного скрипта. Имена, созданные пользователем, включая отредактированные копии встроенных скриптов, заменяются на `custom`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`. Требуется Claude Code v2.1.202 или позже

557 593

558<h4 id="repository-attributes">594<h4 id="repository-attributes">

559 Атрибуты репозитория595 Атрибуты репозитория

560</h4>596</h4>

561 597

562Установите `OTEL_METRICS_INCLUDE_REPOSITORY=true`, чтобы пометить метрики и события идентификацией репозитория сеанса, чтобы общий сборщик мог атрибутировать использование по репозиторию. Требуется Claude Code v2.1.269 или позже.598Установите `OTEL_METRICS_INCLUDE_REPOSITORY=true`, чтобы помечать метрики и события идентификацией репозитория сеанса, чтобы общий сборщик мог атрибутировать использование по репозиторию. Требуется Claude Code v2.1.269 или позже.

563 599

564Claude Code получает эти атрибуты один раз за сеанс из удалённого хранилища `origin` репозитория. HTTPS и SSH удалённые хранилища одного репозитория создают идентичные значения:600Claude Code получает эти атрибуты один раз за сеанс из удалённого хранилища `origin` репозитория. Когда удалённые хранилища HTTPS и SSH репозитория называют один и тот же хост и один и тот же путь, как это происходит на GitHub, GitLab и Bitbucket Cloud, оба производят идентичные значения:

565 601

566| Атрибут | Значение |602| Атрибут | Значение |

567| - | - |603| - | - |

572 608

573Значения приводятся в нижний регистр, и учётные данные, строки запроса и фрагменты из URL удалённого хранилища никогда не отображаются в них. Атрибуты опускаются, когда сеанс не имеет удалённого хранилища `origin`, когда удалённое хранилище не имеет формы URL или когда единственный охватывающий репозиторий — это ваш домашний каталог.609Значения приводятся в нижний регистр, и учётные данные, строки запроса и фрагменты из URL удалённого хранилища никогда не отображаются в них. Атрибуты опускаются, когда сеанс не имеет удалённого хранилища `origin`, когда удалённое хранилище не имеет формы URL или когда единственный охватывающий репозиторий — это ваш домашний каталог.

574 610

611Чтобы получить эти атрибуты из [облачного сеанса](/docs/ru/claude-code-on-the-web), установите переменные телеметрии, включая `OTEL_METRICS_INCLUDE_REPOSITORY`, в его [облачной среде](/docs/ru/cloud-environments#set-environment-variables). Также разрешите домен вашего сборщика в [сетевом доступе](/docs/ru/cloud-environments#network-access) среды.

612

575Ключ `vcs.*`, который вы объявляете в [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support), заменяет полученное значение для этого ключа. Если вы объявляете `vcs.repository.url.full`, Claude Code никогда не читает удалённое хранилище и сообщает только объявленные вами ключи.613Ключ `vcs.*`, который вы объявляете в [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support), заменяет полученное значение для этого ключа. Если вы объявляете `vcs.repository.url.full`, Claude Code никогда не читает удалённое хранилище и сообщает только объявленные вами ключи.

576 614

615Если клоны HTTPS и SSH одного репозитория сообщают разные значения, например на самостоятельно размещённой установке, где URL клона HTTPS содержит префикс пути, которого не хватает URL SSH, объявите `vcs.repository.url.full` в `OTEL_RESOURCE_ATTRIBUTES` вместе со всеми остальными ключами `vcs.*`, которые вы хотите сообщить. Каждый клон затем сообщает идентификацию, которую вы объявляете.

616

577Атрибуты передаются только вашим собственным экспортёрам; телеметрия Anthropic отбрасывает каждый ключ `vcs.*`.617Атрибуты передаются только вашим собственным экспортёрам; телеметрия Anthropic отбрасывает каждый ключ `vcs.*`.

578 618

579<h3 id="metrics">619<h3 id="metrics">

593| `claude_code.code_edit_tool.decision` | Количество решений о разрешении инструмента редактирования кода | нет |633| `claude_code.code_edit_tool.decision` | Количество решений о разрешении инструмента редактирования кода | нет |

594| `claude_code.active_time.total` | Общее активное время | s |634| `claude_code.active_time.total` | Общее активное время | s |

595 635

596Когда `prometheus` — единственный экспортёр, указанный в `OTEL_METRICS_EXPORTER`, Claude Code опускает единицы `USD`, `tokens` и `s` из экспортируемых метрик, чтобы скрейп оставался действительным текстовым форматом Prometheus. Имена метрик не изменяются, и конфигурации, которые объединяют экспортёры, такие как `otlp,prometheus`, сохраняют единицы. До v2.1.216 скрейп Prometheus включал строки `# UNIT`, специфичные для OpenMetrics, которые некоторые скрейперы отклоняли.636Когда `prometheus` — единственный экспортёр, указанный в `OTEL_METRICS_EXPORTER`, Claude Code опускает единицы `USD`, `tokens` и `s` из экспортированных метрик, чтобы скрейп оставался в действительном формате текста Prometheus. Имена метрик не меняются, и конфигурации, которые объединяют экспортёры, такие как `otlp,prometheus`, сохраняют единицы. До v2.1.216 скрейп Prometheus включал строки `# UNIT`, специфичные для OpenMetrics, которые некоторые скрейперы отклоняли.

597 637

598<h3 id="metric-details">638<h3 id="metric-details">

599 Детали метрик639 Детали метрик

610**Атрибуты**:650**Атрибуты**:

611 651

612* Все [стандартные атрибуты](#standard-attributes)652* Все [стандартные атрибуты](#standard-attributes)

613* `start_type`: Способ запуска сеанса. Один из `"fresh"`, `"resume"`, `"continue"` или `"agents_view"`. Значение `"agents_view"` идентифицирует процесс панели управления `claude agents`, локальный пользовательский интерфейс, а не разговорный сеанс. Фильтруйте по этому значению, чтобы отделить запуски процесса пользовательского интерфейса от разговорных сеансов в ваших панелях управления.653* `start_type`: Как был запущен сеанс. Один из `"fresh"`, `"resume"`, `"continue"` или `"agents_view"`. Значение `"agents_view"` идентифицирует процесс панели управления `claude agents`, локальный пользовательский интерфейс, а не разговорный сеанс. Фильтруйте по этому значению, чтобы отделить запуски процесса пользовательского интерфейса от разговорных сеансов в ваших панелях управления.

614 654

615<h4 id="lines-of-code-counter">655<h4 id="lines-of-code-counter">

616 Счётчик строк кода656 Счётчик строк кода

650 690

651Увеличивается после каждого запроса API.691Увеличивается после каждого запроса API.

652 692

693Атрибуты `agent.name`, `skill.name`, `plugin.name`, `mcp_server.name` и `mcp_tool.name` по умолчанию скрывают некоторые имена в заполнитель `"custom"` или `"third-party"`. Если вы установите `OTEL_LOG_TOOL_DETAILS=1`, они вместо этого содержат реальные имена. До v2.1.273 счётчики стоимости и токенов и события `api_request`, `api_error` и `api_refusal` содержали скрытые значения даже с установленным `OTEL_LOG_TOOL_DETAILS=1`.

694

653**Атрибуты**:695**Атрибуты**:

654 696

655* Все [стандартные атрибуты](#standard-attributes)697* Все [стандартные атрибуты](#standard-attributes)

657* `query_source`: Категория подсистемы, которая выдала запрос. Один из `"main"`, `"subagent"` или `"auxiliary"`699* `query_source`: Категория подсистемы, которая выдала запрос. Один из `"main"`, `"subagent"` или `"auxiliary"`

658* `speed`: `"fast"`, когда запрос использовал быстрый режим. Отсутствует в противном случае700* `speed`: `"fast"`, когда запрос использовал быстрый режим. Отсутствует в противном случае

659* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия.701* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия.

660* `agent.name`: Тип подагента, который выдал запрос. Встроенные имена агентов и агенты из официальных плагинов маркетплейса отображаются как есть. Другие определённые пользователем имена агентов заменяются на `"custom"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`. Отсутствует, когда запрос не был выдан именованным типом подагента.702* `agent.name`: Тип подагента, который выдал запрос. Встроенные имена агентов и агенты из официальных плагинов маркетплейса отображаются как есть. Другие определённые пользователем имена агентов заменяются на `"custom"`. Отсутствует, когда запрос не был выдан именованным типом подагента.

661* `skill.name`: Навык, активный для запроса, установленный инструментом Skill, командой `/` или унаследованный порождённым подагентом. Встроенные, связанные, определённые пользователем и имена навыков плагинов официального маркетплейса отображаются как есть. Имена навыков плагинов третьих сторон заменяются на `"third-party"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`. Отсутствует, когда нет активного навыка.703* `skill.name`: Навык, активный для запроса, установленный инструментом Skill или командой `/`, или унаследованный порождённым подагентом. Встроенные, связанные, определённые пользователем и официальные имена навыков маркетплейса отображаются как есть. Имена навыков плагинов третьих сторон заменяются на `"third-party"`. Отсутствует, когда нет активного навыка.

662* `plugin.name`: Владеющий плагин, когда активный навык или подагент предоставляется плагином. Имена плагинов официального маркетплейса отображаются как есть. Имена плагинов третьих сторон заменяются на `"third-party"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`. Отсутствует, когда ни навык, ни подагент не имеют владеющего плагина.704* `plugin.name`: Владеющий плагин, когда активный навык или подагент предоставляется плагином. Имена официальных плагинов маркетплейса отображаются как есть. Имена плагинов третьих сторон заменяются на `"third-party"`. Отсутствует, когда ни навык, ни подагент не имеют владеющего плагина.

663* `marketplace.name`: Маркетплейс, из которого был установлен владеющий плагин. Выпускается только для плагинов официального маркетплейса. Отсутствует в противном случае.705* `marketplace.name`: Маркетплейс, из которого был установлен владеющий плагин. Выпускается только для официальных плагинов маркетплейса, даже с установленным `OTEL_LOG_TOOL_DETAILS=1`. Отсутствует в противном случае.

664* `mcp_server.name`: Сервер MCP, результат инструмента которого этот запрос потребил. Встроенные, проксируемые claude.ai и имена серверов официального реестра отображаются как есть. Имена серверов, настроенные пользователем, заменяются на `"custom"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`. Отсутствует, когда запрос не потребил результат инструмента MCP. До v2.1.222 Claude Code устанавливал этот атрибут на каждый запрос после вызова инструмента MCP, а не только на запросы, которые потребили результат инструмента, поэтому панели управления, которые его агрегируют, показывают снижение после обновления.706* `mcp_server.name`: Сервер MCP, результат инструмента которого использовал этот запрос. Встроенные, проксированные claude.ai и официальные имена серверов реестра отображаются как есть. Имена серверов, настроенные пользователем, заменяются на `"custom"`. Отсутствует, когда запрос не использовал результат инструмента MCP. До v2.1.222 Claude Code устанавливал этот атрибут на каждый запрос после вызова инструмента MCP, а не только на запросы, которые использовали результат инструмента, поэтому панели управления, которые его агрегируют, показывают снижение после обновления.

665* `mcp_tool.name`: Инструмент MCP, результат которого этот запрос потребил, с тем же редактированием и поведением версии, что и `mcp_server.name`. Отсутствует, когда запрос не потребил результат инструмента MCP.707* `mcp_tool.name`: Инструмент MCP, результат которого использовал этот запрос, с тем же скрытием и поведением версии, что и `mcp_server.name`. Отсутствует, когда запрос не использовал результат инструмента MCP.

666 708

667<h4 id="token-counter">709<h4 id="token-counter">

668 Счётчик токенов710 Счётчик токенов

678* `query_source`: Категория подсистемы, которая выдала запрос. Один из `"main"`, `"subagent"` или `"auxiliary"`720* `query_source`: Категория подсистемы, которая выдала запрос. Один из `"main"`, `"subagent"` или `"auxiliary"`

679* `speed`: `"fast"`, когда запрос использовал быстрый режим. Отсутствует в противном случае721* `speed`: `"fast"`, когда запрос использовал быстрый режим. Отсутствует в противном случае

680* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу. См. [Счётчик стоимости](#cost-counter) для деталей.722* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу. См. [Счётчик стоимости](#cost-counter) для деталей.

681* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. См. [Счётчик стоимости](#cost-counter) для определений и поведения редактирования.723* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. См. [Счётчик стоимости](#cost-counter) для определений и поведения скрытия.

682 724

683<h4 id="code-edit-tool-decision-counter">725<h4 id="code-edit-tool-decision-counter">

684 Счётчик решений инструмента редактирования кода726 Счётчик решений инструмента редактирования кода

698 Счётчик активного времени740 Счётчик активного времени

699</h4>741</h4>

700 742

701Отслеживает фактическое время активного использования Claude Code, исключая время простоя. Эта метрика увеличивается во время взаимодействия пользователя, такого как ввод текста и чтение ответов, и во время обработки CLI, такой как выполнение инструментов и генерация ответов AI.743Отслеживает фактическое время, потраченное на активное использование Claude Code, исключая время простоя. Эта метрика увеличивается во время взаимодействия пользователя, такого как ввод текста и чтение ответов, и во время обработки CLI, такой как выполнение инструментов и генерация ответов AI.

702 744

703**Атрибуты**:745**Атрибуты**:

704 746

715 Атрибуты корреляции событий757 Атрибуты корреляции событий

716</h4>758</h4>

717 759

718Когда пользователь отправляет запрос, Claude Code может сделать несколько вызовов API и запустить несколько инструментов. Атрибут `prompt.id` позволяет вам связать все эти события с единственным запросом, который их вызвал.760Когда пользователь отправляет запрос, Claude Code может сделать несколько вызовов API и запустить несколько инструментов. Атрибут `prompt.id` позволяет вам связать все эти события с одним запросом, который их вызвал.

719 761

720| Атрибут | Описание |762| Атрибут | Описание |

721| - | - |763| - | - |

724| `message.uuid` | UUID сообщения, как сохранено в стенограмме сеанса, файлы `~/.claude/projects/*/*.jsonl`. Присутствует на `assistant_response`, на `api_response_body` и на `user_prompt`, кроме отправок команд, которые могут создавать ноль или много сообщений. На `assistant_response` и `api_response_body` это последняя запись стенограммы ответа, от которой цепочка `parentUuid` следующего хода. Требуется Claude Code v2.1.214 или позже, или v2.1.274 или позже на `api_response_body` |766| `message.uuid` | UUID сообщения, как сохранено в транскрипте сеанса, файлы `~/.claude/projects/*/*.jsonl`. Присутствует на `assistant_response`, на `api_response_body` и на `user_prompt`, кроме отправок команд, которые могут создавать ноль или много сообщений. На `assistant_response` и `api_response_body` это финальная запись транскрипта ответа, от которой цепочка `parentUuid` следующего хода. Требуется Claude Code v2.1.214 или позже, или v2.1.274 или позже на `api_response_body` |

725| `client_request_id` | UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`. Присутствует на `api_request` и `api_error` на подключениях API первой стороны; отсутствует на бэкендах поставщиков третьих сторон и когда запрос был повторён через резервный вариант без потоковой передачи. Связывает запрос с его ответом и остаётся доступным для сбоев, таких как тайм-ауты, которые никогда не создали `request_id` сервера. Совпадает с тем же атрибутом на диапазоне трассировки `llm_request`. Требуется Claude Code v2.1.214 или позже |767| `request_id` | Назначенный сервером ID запроса API, прочитанный из заголовка ответа `request-id`, например `req_011...`. На ответе без заголовка `request-id`, как на [Amazon Bedrock](/docs/ru/amazon-bedrock), значение поступает из заголовка `x-amzn-requestid` вместо этого. Присутствует на `api_request`, `api_error`, `api_refusal`, `assistant_response` и `api_response_body`, когда ответ содержит любой из этих заголовков. Совпадает с тем же атрибутом на диапазоне трассировки `llm_request`. Источник `x-amzn-requestid` требует Claude Code v2.1.282 или позже |

768| `client_request_id` | Созданный клиентом UUID, отправленный как заголовок запроса `x-client-request-id`. Присутствует на `api_request` и `api_error` на подключениях API первой стороны; отсутствует на бэкендах поставщиков третьих сторон и когда запрос был повторён через резервный вариант без потоковой передачи. Связывает запрос с его ответом и остаётся доступным для сбоев, таких как тайм-ауты, которые никогда не создали серверный `request_id`. Совпадает с тем же атрибутом на диапазоне трассировки `llm_request`. Требуется Claude Code v2.1.214 или позже |

726 769

727Чтобы отследить всю деятельность, вызванную одним запросом, отфильтруйте события по определённому значению `prompt.id`. Это возвращает событие user\_prompt, любые события api\_request и любые события tool\_result, которые произошли при обработке этого запроса.770Чтобы отследить всю деятельность, вызванную одним запросом, отфильтруйте события по определённому значению `prompt.id`. Это возвращает событие user\_prompt, любые события api\_request и любые события tool\_result, которые произошли при обработке этого запроса.

728 771

729`event.sequence` начинается с 0 каждый раз, когда процесс Claude Code запускается, и считает вверх в течение жизни этого процесса. Он продолжает считать через `/clear`, который назначает новый `session.id`. Если вы [возобновляете сеанс без ветвления](/docs/ru/how-claude-code-works#resume-or-fork-sessions), сеанс сохраняет свой `session.id`, но берёт свои значения `event.sequence` из процесса, который его возобновил, поэтому в одном сеансе более позднее событие может нести более низкое значение, чем более раннее, или повторить одно. Чтобы упорядочить события сеанса, отсортируйте по `event.timestamp` и используйте `event.sequence` для упорядочивания событий, которые имеют одну и ту же временную метку.772`event.sequence` начинается с 0 каждый раз, когда процесс Claude Code запускается, и считает вверх в течение жизни этого процесса. Он продолжает считать через `/clear`, который назначает новый `session.id`. Если вы [возобновляете сеанс без ветвления](/docs/ru/how-claude-code-works#resume-or-fork-sessions), сеанс сохраняет свой `session.id`, но берёт свои значения `event.sequence` из процесса, который его возобновил, поэтому в одном сеансе более позднее событие может содержать более низкое значение, чем более раннее, или повторить одно. Чтобы упорядочить события сеанса, отсортируйте по `event.timestamp` и используйте `event.sequence` для упорядочивания событий, которые имеют одну и ту же временную метку.

730 773

731Для восстановления на уровне сообщений каждый класс событий содержит ключ, который совпадает с полем в стенограмме сеанса. Формат записи стенограммы [внутренний для Claude Code](/docs/ru/sessions#where-transcripts-are-stored) и изменяется между версиями, поэтому конвейер, который объединяет эти поля, может сломаться при любом выпуске; рассматривайте объединения как специфичные для версии, а не как стабильный контракт:774Для восстановления на уровне сообщений каждый класс событий содержит ключ, который совпадает с полем в транскрипте сеанса. Формат записи транскрипта [внутренний для Claude Code](/docs/ru/sessions#where-transcripts-are-stored) и меняется между версиями, поэтому конвейер, который объединяет эти поля, может сломаться при любом выпуске; рассматривайте объединения как специфичные для версии, а не как стабильный контракт:

732 775

733* `message.uuid` на `user_prompt`, `assistant_response` и `api_response_body`776* `message.uuid` на `user_prompt`, `assistant_response` и `api_response_body`

734* `request_id` на событиях API, сохранённых как `requestId` на записях помощника стенограммы777* `request_id` на событиях API, сохранённых как `requestId` на записях помощника транскрипта

735* `tool_use_id` на событиях `tool_result` и `tool_decision`778* `tool_use_id` на событиях `tool_result` и `tool_decision`

736 779

737<h4 id="user-prompt-event">780<h4 id="user-prompt-event">

749* `event.timestamp`: Временная метка ISO 8601792* `event.timestamp`: Временная метка ISO 8601

750* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)793* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

751* `prompt_length`: Длина запроса794* `prompt_length`: Длина запроса

752* `prompt`: Содержание запроса. Редактируется по умолчанию. Установите `OTEL_LOG_USER_PROMPTS=1`, чтобы включить его795* `prompt`: Содержание запроса. Скрыто по умолчанию. Установите `OTEL_LOG_USER_PROMPTS=1`, чтобы включить его

753* `message.uuid`: UUID результирующего пользовательского сообщения, совпадающий с сохранённой записью стенограммы. Отсутствует при отправке команд, которые могут создавать ноль или много сообщений. Требуется Claude Code v2.1.214 или позже796* `message.uuid`: UUID результирующего пользовательского сообщения, совпадающий с сохранённой записью транскрипта. Отсутствует при отправке команд, которые могут создавать ноль или много сообщений. Требуется Claude Code v2.1.214 или позже

754* `command_name`: Имя команды, когда запрос вызывает одну. Встроенные и связанные имена команд, такие как `compact` или `debug`, выпускаются как есть; псевдонимы, такие как `reset`, выпускаются как введено, а не как каноническое имя. Пользовательские, плагины и имена команд MCP сворачиваются в `custom` или `mcp`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`797* `command_name`: Имя команды, когда запрос вызывает одну. Встроенные и связанные имена команд, такие как `compact` или `debug`, выпускаются как есть; псевдонимы, такие как `reset`, выпускаются как введено, а не как каноническое имя. Пользовательские, плагины и имена команд MCP сворачиваются в `custom` или `mcp`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`

755* `command_source`: Происхождение команды, когда присутствует: `builtin`, `custom` или `mcp`. Команды, предоставленные плагинами, сообщаются как `custom`798* `command_source`: Происхождение команды, если присутствует: `builtin`, `custom` или `mcp`. Команды, предоставленные плагинами, сообщаются как `custom`

756 799

757<h4 id="assistant-response-event">800<h4 id="assistant-response-event">

758 Событие ответа помощника801 Событие ответа помощника

769* `event.timestamp`: Временная метка ISO 8601812* `event.timestamp`: Временная метка ISO 8601

770* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)813* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

771* `response_length`: Длина текста ответа в символах814* `response_length`: Длина текста ответа в символах

772* `response`: Текст ответа, усечённый на пределе содержания (60 КБ по умолчанию). Редактируется в `<REDACTED>` по умолчанию. Установите `OTEL_LOG_ASSISTANT_RESPONSES=1`, чтобы включить его. Когда `OTEL_LOG_ASSISTANT_RESPONSES` не установлен, `OTEL_LOG_USER_PROMPTS` контролирует его вместо этого, поэтому установите `OTEL_LOG_ASSISTANT_RESPONSES=0`, чтобы сохранить ответы редактируемыми, пока логирование запроса включено815* `response`: Текст ответа, усечённый на пределе содержания (60 КБ по умолчанию). Скрыт в `<REDACTED>` по умолчанию. Установите `OTEL_LOG_ASSISTANT_RESPONSES=1`, чтобы включить его. Когда `OTEL_LOG_ASSISTANT_RESPONSES` не установлен, `OTEL_LOG_USER_PROMPTS` управляет им вместо этого, поэтому установите `OTEL_LOG_ASSISTANT_RESPONSES=0`, чтобы сохранить ответы скрытыми, пока логирование запросов включено

773* `model`: Идентификатор модели (например, "claude-sonnet-5")816* `model`: Идентификатор модели (например, "claude-sonnet-5")

774* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`. Присутствует только, когда API возвращает один817* `request_id`: ID запроса API, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

775* `message.uuid`: UUID последней записи стенограммы ответа. Ответ API сохраняется как одна запись стенограммы на блок содержания; это последний, от которого цепочка `parentUuid` следующего хода. Требуется Claude Code v2.1.214 или позже818* `message.uuid`: UUID финальной записи транскрипта ответа. Ответ API сохраняется как одна запись транскрипта на блок содержания; это последняя, от которой цепочка `parentUuid` следующего хода. Требуется Claude Code v2.1.214 или позже

776* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента819* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента

777 820

778<h4 id="tool-result-event">821<h4 id="tool-result-event">

796* `error_type`: Строка категории ошибки, когда инструмент не удался, например `"Error:ENOENT"` или `"ShellError"`839* `error_type`: Строка категории ошибки, когда инструмент не удался, например `"Error:ENOENT"` или `"ShellError"`

797* `error` (когда `OTEL_LOG_TOOL_DETAILS=1`): Полное сообщение об ошибке, когда инструмент не удался840* `error` (когда `OTEL_LOG_TOOL_DETAILS=1`): Полное сообщение об ошибке, когда инструмент не удался

798* `decision_type`: Всегда `"accept"`, так как это событие выпускается только после запуска инструмента. Отклонённые вызовы не создают результат инструмента841* `decision_type`: Всегда `"accept"`, так как это событие выпускается только после запуска инструмента. Отклонённые вызовы не создают результат инструмента

799* `decision_source`: Откуда пришло решение о разрешении. Один из `"config"`, `"hook"`, `"user_permanent"` или `"user_temporary"`. См. [Событие решения инструмента](#tool-decision-event) для того, что означает каждое значение. Источники, специфичные для отклонения, `"user_abort"` и `"user_reject"`, никогда не появляются на этом событии.842* `decision_source`: Откуда пришло решение о разрешении. Один из `"config"`, `"hook"`, `"user_permanent"` или `"user_temporary"`. См. [Событие решения инструмента](#tool-decision-event) для того, что означает каждое значение. Источники, только для отклонения, `"user_abort"` и `"user_reject"` никогда не появляются на этом событии.

800* `tool_input_size_bytes`: Размер сериализованного JSON входа инструмента в байтах843* `tool_input_size_bytes`: Размер сериализованного в JSON входа инструмента в байтах

801* `tool_result_size_bytes`: Размер результата инструмента в байтах844* `tool_result_size_bytes`: Размер результата инструмента в байтах

802* `mcp_server_scope`: Идентификатор области сервера MCP (для инструментов MCP)845* `mcp_server_scope`: Идентификатор области сервера MCP (для инструментов MCP)

803* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (когда `OTEL_LOG_TOOL_DETAILS=1`): идентификация коммита успешного запуска `git commit` инструментом Bash или PowerShell. `vcs.ref.head.revision` — это SHA коммита, `vcs.ref.head.name` — это ветка, на которую он был закоммичен, и `vcs.ref.head.type` — это `branch`. Имя и тип опускаются, когда коммит был сделан на отсоединённой HEAD. Требуется Claude Code v2.1.269 или позже846* `vcs.ref.head.revision`, `vcs.ref.head.name`, `vcs.ref.head.type` (когда `OTEL_LOG_TOOL_DETAILS=1`): идентификация коммита успешного запуска `git commit` инструментом Bash или PowerShell. `vcs.ref.head.revision` — это SHA коммита, `vcs.ref.head.name` — это ветка, на которую он был закоммичен, и `vcs.ref.head.type` — это `branch`. Имя и тип опускаются, когда коммит был сделан на отсоединённой HEAD. Требуется Claude Code v2.1.269 или позже

804* `tool_parameters` (когда `OTEL_LOG_TOOL_DETAILS=1`): Строка JSON, содержащая параметры, специфичные для инструмента. Для встроенных серверов Claude Desktop в сеансах, которыми владеет Claude Desktop, пара `mcp_server_name`/`mcp_tool_name` включается даже с отключённым флагом, то же исключение, созданное хостом, что и [Событие решения инструмента](#tool-decision-event), требующее Claude Code v2.1.214 или позже. Параметры варьируются по инструменту:847* `tool_parameters` (когда `OTEL_LOG_TOOL_DETAILS=1`): Строка JSON, содержащая параметры, специфичные для инструмента. Для встроенных серверов Claude Desktop в сеансах, которыми владеет Claude Desktop, пара `mcp_server_name`/`mcp_tool_name` включается даже с отключённым флагом, то же исключение, созданное хостом, как [Событие решения инструмента](#tool-decision-event), требующее Claude Code v2.1.214 или позже. Параметры варьируются по инструменту:

805 * Для инструмента Bash: включает `bash_command`, `full_command`, `timeout`, `description` и `dangerouslyDisableSandbox`, плюс `git_commit_id` и `git_branch`, когда команда `git commit` успешна. `git_commit_id` — это полный SHA коммита, когда коммит является HEAD рабочего каталога сеанса, и сокращённый SHA git в противном случае. `git_branch` — это ветка, на которую он был закоммичен, опускается на отсоединённой HEAD848 * Для инструмента Bash: включает `bash_command`, `full_command`, `timeout`, `description` и `dangerouslyDisableSandbox`, плюс `git_commit_id` и `git_branch`, когда команда `git commit` успешна. `git_commit_id` — это полный SHA коммита, когда коммит является HEAD рабочего каталога сеанса, и сокращённый SHA git в противном случае. `git_branch` — это ветка, на которую он был закоммичен, опускается на отсоединённой HEAD

806 * Для инструмента рабочей области приложения для рабочего стола, который также сообщает `tool_name` как `Bash`: включает только `bash_command`, `full_command` и `timeout`849 * Для инструмента рабочей области приложения для рабочего стола, который также сообщает `tool_name` как `Bash`: включает только `bash_command`, `full_command` и `timeout`

807 * Для инструментов MCP: включает `mcp_server_name`, `mcp_tool_name`850 * Для инструментов MCP: включает `mcp_server_name`, `mcp_tool_name`

808 * Для инструмента Skill: включает `skill_name`851 * Для инструмента Skill: включает `skill_name`

809 * Для инструмента Agent или устаревшего инструмента Task: включает `subagent_type`852 * Для инструмента Agent или устаревшего инструмента Task: включает `subagent_type`

810* `tool_input` (когда `OTEL_LOG_TOOL_DETAILS=1`): Сериализованные JSON аргументы инструмента. Отдельные значения свыше 512 символов усекаются, и полная нагрузка ограничена примерно 4 К символами. Применяется ко всем инструментам, включая инструменты MCP.853* `tool_input` (когда `OTEL_LOG_TOOL_DETAILS=1`): Сериализованные в JSON аргументы инструмента. Отдельные значения свыше 512 символов усекаются, и полная нагрузка ограничена примерно 4 К символами. Применяется ко всем инструментам, включая инструменты MCP.

811 854

812<h4 id="api-request-event">855<h4 id="api-request-event">

813 Событие запроса API856 Событие запроса API

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

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

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

834* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`, например `"req_011..."`. Присутствует только, когда API возвращает один.877* `request_id`: ID запроса API, например `"req_011..."`, описанный в [Атрибуты корреляции событий](#event-correlation-attributes).

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

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

837* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента880* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента

838* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия.881* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия.

839* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. См. [Счётчик стоимости](#cost-counter) для определений и поведения редактирования.882* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. См. [Счётчик стоимости](#cost-counter) для определений и поведения скрытия.

840 883

841<h4 id="api-error-event">884<h4 id="api-error-event">

842 Событие ошибки API885 Событие ошибки API

857* `status_code`: Код состояния HTTP как число. Отсутствует для ошибок, не связанных с HTTP, таких как сбои соединения.900* `status_code`: Код состояния HTTP как число. Отсутствует для ошибок, не связанных с HTTP, таких как сбои соединения.

858* `duration_ms`: Длительность запроса в миллисекундах901* `duration_ms`: Длительность запроса в миллисекундах

859* `attempt`: Общее количество попыток, включая исходный запрос (`1` означает, что повторных попыток не было)902* `attempt`: Общее количество попыток, включая исходный запрос (`1` означает, что повторных попыток не было)

860* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`, например `"req_011..."`. Присутствует только, когда API возвращает один.903* `request_id`: ID запроса API, например `"req_011..."`, описанный в [Атрибуты корреляции событий](#event-correlation-attributes).

861* `client_request_id`: UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`. Доступен даже при сбое, таком как тайм-аут или ошибка соединения, которые никогда не создали `request_id` сервера; см. таблицу [атрибуты корреляции событий](#event-correlation-attributes) для того, когда он присутствует. Требуется Claude Code v2.1.214 или позже904* `client_request_id`: Созданный клиентом UUID, отправленный как заголовок запроса `x-client-request-id`. Доступен даже при сбое, таком как тайм-аут или ошибка соединения, которые никогда не создали серверный `request_id`; см. таблицу [атрибутов корреляции событий](#event-correlation-attributes) для того, когда он присутствует. Требуется Claude Code v2.1.214 или позже

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

863* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента906* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента

864* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия.907* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия.

865* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. См. [Счётчик стоимости](#cost-counter) для определений и поведения редактирования.908* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. См. [Счётчик стоимости](#cost-counter) для определений и поведения скрытия.

866 909

867<h4 id="api-refusal-event">910<h4 id="api-refusal-event">

868 Событие отказа API911 Событие отказа API

879* `event.timestamp`: Временная метка ISO 8601922* `event.timestamp`: Временная метка ISO 8601

880* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)923* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

881* `model`: Идентификатор модели из запроса924* `model`: Идентификатор модели из запроса

882* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`, например `"req_011..."`. Присутствует только, когда API возвращает один.925* `request_id`: ID запроса API, например `"req_011..."`, описанный в [Атрибуты корреляции событий](#event-correlation-attributes).

883* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента. См. [`api_request`](#api-request-event) для определений.926* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента. См. [`api_request`](#api-request-event) для определений.

884* `speed`: Либо `"fast"`, когда активен [Быстрый режим](/docs/ru/fast-mode), либо `"normal"`927* `speed`: Либо `"fast"`, когда активен [Быстрый режим](/docs/ru/fast-mode), либо `"normal"`

885* `attempt`: Номер попытки повтора. Первая попытка — это `1`.928* `attempt`: Номер попытки повтора. Первая попытка — это `1`.

887* `server_fallback_hop`: `true`, когда резервный вариант модели на стороне сервера API уже повторил этот отказ на другой модели, поэтому пользователь не видел этот конкретный отказ. `false`, когда запрос закончился отказом. Один ход может выпустить как событие `true` hop, так и более позднее событие `false` final, когда модель резервного варианта также отказывает.930* `server_fallback_hop`: `true`, когда резервный вариант модели на стороне сервера API уже повторил этот отказ на другой модели, поэтому пользователь не видел этот конкретный отказ. `false`, когда запрос закончился отказом. Один ход может выпустить как событие `true` hop, так и более позднее событие `false` final, когда модель резервного варианта также отказывает.

888* `has_category`: `true`, когда ответ API содержал `stop_details.category` из `"cyber"`, `"bio"`, `"frontier_llm"` или `"reasoning_extraction"`. `false`, когда ответ не содержал категорию или значение вне этого набора. Отсутствует, когда `server_fallback_hop` — это `true`, потому что hop блоки не содержат `stop_details`.931* `has_category`: `true`, когда ответ API содержал `stop_details.category` из `"cyber"`, `"bio"`, `"frontier_llm"` или `"reasoning_extraction"`. `false`, когда ответ не содержал категорию или значение вне этого набора. Отсутствует, когда `server_fallback_hop` — это `true`, потому что hop блоки не содержат `stop_details`.

889* `has_explanation`: `true`, когда ответ API содержал `stop_details.explanation`, в противном случае `false`. Отсутствует, когда `server_fallback_hop` — это `true`.932* `has_explanation`: `true`, когда ответ API содержал `stop_details.explanation`, в противном случае `false`. Отсутствует, когда `server_fallback_hop` — это `true`.

890* `category`: Значение `stop_details.category` из ответа API. Один из `"cyber"`, `"bio"`, `"frontier_llm"` или `"reasoning_extraction"`. Присутствует только, когда установлено `OTEL_LOG_TOOL_DETAILS=1` и `has_category` — это `true`.933* `category`: Значение `stop_details.category` из ответа API. Один из `"cyber"`, `"bio"`, `"frontier_llm"` или `"reasoning_extraction"`. Присутствует только, когда установлен `OTEL_LOG_TOOL_DETAILS=1` и `has_category` — это `true`.

891* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. См. [Счётчик стоимости](#cost-counter) для определений и поведения редактирования.934* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. См. [Счётчик стоимости](#cost-counter) для определений и поведения скрытия.

892 935

893<h4 id="api-request-body-event">936<h4 id="api-request-body-event">

894 Событие тела запроса API937 Событие тела запроса API

895</h4>938</h4>

896 939

897Регистрируется для каждой попытки запроса API, когда установлено `OTEL_LOG_RAW_API_BODIES`. Одно событие выпускается на попытку, поэтому повторные попытки с отрегулированными параметрами каждая создают своё собственное событие.940Регистрируется для каждой попытки запроса API, когда установлен `OTEL_LOG_RAW_API_BODIES`. Одно событие выпускается на попытку, поэтому повторные попытки с отрегулированными параметрами каждая создают своё собственное событие.

898 941

899**Имя события**: `claude_code.api_request_body`942**Имя события**: `claude_code.api_request_body`

900 943

904* `event.name`: `"api_request_body"`947* `event.name`: `"api_request_body"`

905* `event.timestamp`: Временная метка ISO 8601948* `event.timestamp`: Временная метка ISO 8601

906* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)949* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

907* `body`: Сериализованные JSON параметры запроса Messages API, такие как системный запрос, сообщения и инструменты, усечённые на пределе содержания (60 КБ по умолчанию). Содержание расширенного мышления в предыдущих ходах помощника редактируется. Выпускается только в встроенном режиме (`OTEL_LOG_RAW_API_BODIES=1`).950* `body`: Сериализованные в JSON параметры запроса Messages API, такие как системный запрос, сообщения и инструменты, усечённые на пределе содержания (60 КБ по умолчанию). Содержание расширенного мышления в предыдущих ходах помощника скрыто. Выпускается только в встроенном режиме (`OTEL_LOG_RAW_API_BODIES=1`).

908* `body_ref`: Абсолютный путь к файлу `<dir>/<uuid>.request.json`, содержащему неусечённое тело. Выпускается только в режиме файла (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).951* `body_ref`: Абсолютный путь к файлу `<dir>/<uuid>.request.json`, содержащему неусечённое тело. Выпускается только в режиме файла (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

909* `body_length`: Неусечённая длина тела. Байты UTF-8, когда `OTEL_LOG_RAW_API_BODIES=file:<dir>`, или единицы кода UTF-16, когда `=1`952* `body_length`: Неусечённая длина тела. Байты UTF-8, когда `OTEL_LOG_RAW_API_BODIES=file:<dir>`, или единицы кода UTF-16, когда `=1`

910* `body_truncated`: `"true"`, когда произошло встроенное усечение. Отсутствует в режиме файла и когда усечение не произошло.953* `body_truncated`: `"true"`, когда произошло встроенное усечение. Отсутствует в режиме файла и когда усечение не произошло.

916 Событие тела ответа API959 Событие тела ответа API

917</h4>960</h4>

918 961

919Регистрируется для каждого успешного ответа API, когда установлено `OTEL_LOG_RAW_API_BODIES`.962Регистрируется для каждого успешного ответа API, когда установлен `OTEL_LOG_RAW_API_BODIES`.

920 963

921В режиме файла (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code также добавляет одну строку JSON в `<dir>/index.jsonl` для каждого успешного ответа с полями `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file` и `response_file`. Прочитайте его, чтобы найти файлы запроса и ответа за данным сообщением стенограммы без запроса к вашему бэкенду телеметрии. Файл индекса требует Claude Code v2.1.274 или позже.964В режиме файла (`OTEL_LOG_RAW_API_BODIES=file:<dir>`), Claude Code также добавляет одну строку JSON в `<dir>/index.jsonl` для каждого успешного ответа с полями `timestamp`, `session_id`, `query_source`, `model`, `request_id`, `message_id`, `message_uuid`, `request_file` и `response_file`. Прочитайте его, чтобы найти файлы запроса и ответа за данным сообщением транскрипта без запроса к вашему бэкенду телеметрии. Файл индекса требует Claude Code v2.1.274 или позже.

922 965

923**Имя события**: `claude_code.api_response_body`966**Имя события**: `claude_code.api_response_body`

924 967

928* `event.name`: `"api_response_body"`971* `event.name`: `"api_response_body"`

929* `event.timestamp`: Временная метка ISO 8601972* `event.timestamp`: Временная метка ISO 8601

930* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)973* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

931* `body`: Сериализованный JSON ответ Messages API, включая id, блоки содержания, использование и причину остановки, усечённый на пределе содержания (60 КБ по умолчанию). Содержание расширенного мышления редактируется. Выпускается только в встроенном режиме (`OTEL_LOG_RAW_API_BODIES=1`).974* `body`: Сериализованный в JSON ответ Messages API, включая id, блоки содержания, использование и причину остановки, усечённый на пределе содержания (60 КБ по умолчанию). Содержание расширенного мышления скрыто. Выпускается только в встроенном режиме (`OTEL_LOG_RAW_API_BODIES=1`).

932* `body_ref`: Абсолютный путь к файлу `<dir>/<request_id>.response.json`, содержащему неусечённое тело. Выпускается только в режиме файла (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).975* `body_ref`: Абсолютный путь к файлу `<dir>/<request_id>.response.json`, содержащему неусечённое тело. Выпускается только в режиме файла (`OTEL_LOG_RAW_API_BODIES=file:<dir>`).

933* `body_length`: Неусечённая длина тела. Байты UTF-8, когда `OTEL_LOG_RAW_API_BODIES=file:<dir>`, или единицы кода UTF-16, когда `=1`976* `body_length`: Неусечённая длина тела. Байты UTF-8, когда `OTEL_LOG_RAW_API_BODIES=file:<dir>`, или единицы кода UTF-16, когда `=1`

934* `body_truncated`: `"true"`, когда произошло встроенное усечение. Отсутствует в режиме файла и когда усечение не произошло.977* `body_truncated`: `"true"`, когда произошло встроенное усечение. Отсутствует в режиме файла и когда усечение не произошло.

935* `model`: Идентификатор модели978* `model`: Идентификатор модели

936* `query_source`: Подсистема, которая выдала запрос979* `query_source`: Подсистема, которая выдала запрос

937* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`, например `"req_011..."`. Присутствует только, когда API возвращает один.980* `request_id`: ID запроса API, например `"req_011..."`, описанный в [Атрибуты корреляции событий](#event-correlation-attributes).

938* `request_body_id`: `request_body_id` события [`api_request_body`](#api-request-body-event), на которое этот ответ отвечает. Требуется Claude Code v2.1.274 или позже981* `request_body_id`: `request_body_id` события [`api_request_body`](#api-request-body-event), на которое отвечает этот ответ. Требуется Claude Code v2.1.274 или позже

939* `message.id`: ID сообщения, назначенный API ответу, поле `id` тела ответа. Требуется Claude Code v2.1.274 или позже982* `message.id`: ID сообщения, который API назначил ответу, поле `id` тела ответа. Требуется Claude Code v2.1.274 или позже

940* `message.uuid`: UUID последней записи стенограммы ответа. Вместе с `request_body_id` он связывает сообщение стенограммы с телами запроса и ответа позади него. Требуется Claude Code v2.1.274 или позже983* `message.uuid`: UUID финальной записи транскрипта ответа. Вместе с `request_body_id` он связывает сообщение транскрипта с телами запроса и ответа позади него. Требуется Claude Code v2.1.274 или позже

941 984

942<h4 id="tool-decision-event">985<h4 id="tool-decision-event">

943 Событие решения инструмента986 Событие решения инструмента

961 * `"mcp"`: серверы MCP в целом1004 * `"mcp"`: серверы MCP в целом

962 * `"sdk_host_builtin_mcp"`: встроенный в процесс сервер, встроенный в сам Claude Desktop, в сеансе, которым владеет Claude Desktop. Claude Desktop владеет сеансом, который он запустил из одной из своих собственных точек входа, `claude-desktop`, `claude-desktop-3p` или `local-agent`, когда этот сеанс не является вложенным дочерним; вложенные сеансы, включая сеансы, которые сам Claude Code порождает, сообщают эти серверы как `"mcp"`1005 * `"sdk_host_builtin_mcp"`: встроенный в процесс сервер, встроенный в сам Claude Desktop, в сеансе, которым владеет Claude Desktop. Claude Desktop владеет сеансом, который он запустил из одной из своих собственных точек входа, `claude-desktop`, `claude-desktop-3p` или `local-agent`, когда этот сеанс не является вложенным дочерним; вложенные сеансы, включая сеансы, которые сам Claude Code порождает, сообщают эти серверы как `"mcp"`

963* `source`: Откуда пришло решение:1006* `source`: Откуда пришло решение:

964 * `"config"`: Решено автоматически без подсказки, на основе параметров проекта, правил разрешения или запрета в личных параметрах пользователя, политики, управляемой предприятием, флагов `--allowedTools` или `--disallowedTools`, активного режима разрешения, предоставления области действия сеанса из более раннего запроса в одном интерактивном сеансе CLI или потому что инструмент по своей природе безопасен. Событие не указывает, какой из этих источников совпадал. Claude Code также сообщает `"config"`, когда сам запрос подсказки разрешения не удаётся, например когда обратный вызов [`canUseTool`](/docs/ru/agent-sdk/typescript#canusetool) Agent SDK или инструмент [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) возвращает недействительный результат, или когда входной поток закрывается, пока запрос ожидает. До v2.1.216 Claude Code сообщал эти сбои как `"user_reject"`.1007 * `"config"`: Решено автоматически без запроса, на основе параметров проекта, правил разрешения или запрета в личных параметрах пользователя, политики, управляемой предприятием, флагов `--allowedTools` или `--disallowedTools`, активного режима разрешения, предоставления области действия сеанса из более раннего запроса в том же интерактивном сеансе CLI или потому что инструмент по своей природе безопасен. Событие не указывает, какой из этих источников совпал. Claude Code также сообщает `"config"`, когда сам запрос подсказки разрешения не удаётся, например когда обратный вызов [`canUseTool`](/docs/ru/agent-sdk/typescript#canusetool) Agent SDK или инструмент [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) возвращает недействительный результат, или когда входной поток закрывается во время ожидания запроса. До v2.1.216 Claude Code сообщал эти сбои как `"user_reject"`.

965 * `"hook"`: Hook `PreToolUse` или `PermissionRequest` вернул решение.1008 * `"hook"`: Hook `PreToolUse` или `PermissionRequest` вернул решение.

966 * `"user_permanent"`: Выпускается, когда пользователь выбрал "Да, и больше не спрашивай для ..." в подсказке разрешения, которая сохраняет правило разрешения в его личные параметры. В интерактивном CLI это выпускается только для самого этого выбора; более поздние вызовы, которые совпадают с сохранённым правилом, выпускают `"config"` вместо этого. В сеансах Agent SDK или неинтерактивных `-p`, как исходный выбор, так и более поздние совпадения правил выпускают `"user_permanent"`. Рассматривается как принятие.1009 * `"user_permanent"`: Выпускается, когда пользователь выбрал "Да, и больше не спрашивать для ..." в подсказке разрешения, которая сохраняет правило разрешения в его личные параметры. В интерактивном CLI это выпускается только для самого этого выбора; более поздние вызовы, которые совпадают с сохранённым правилом, выпускают `"config"` вместо этого. В сеансах Agent SDK или неинтерактивных `-p`, как исходный выбор, так и более поздние совпадения правил выпускают `"user_permanent"`. Рассматривается как принятие.

967 * `"user_temporary"`: Выпускается, когда пользователь выбрал "Да" в подсказке разрешения для одобрения в один раз, или выбрал опцию, которая предоставляет доступ на оставшуюся часть сеанса в подсказке редактирования или чтения файла. В интерактивном CLI это выпускается только для самого выбора; более поздние вызовы, разрешённые этим предоставлением области действия сеанса, выпускают `"config"` вместо этого. В сеансах Agent SDK или неинтерактивных `-p`, как выбор, так и более поздние совпадения выпускают `"user_temporary"`. Рассматривается как принятие.1010 * `"user_temporary"`: Выпускается, когда пользователь выбрал "Да" в подсказке разрешения для одобрения в один раз, или выбрал опцию, которая предоставляет доступ на оставшуюся часть сеанса в подсказке редактирования или чтения файла. В интерактивном CLI это выпускается только для самого выбора; более поздние вызовы, разрешённые этим предоставлением области действия сеанса, выпускают `"config"` вместо этого. В сеансах Agent SDK или неинтерактивных `-p`, как выбор, так и более поздние совпадения выпускают `"user_temporary"`. Рассматривается как принятие.

968 * `"user_abort"`: Выпускается, когда пользователь отклонил подсказку разрешения без ответа. В сеансах Agent SDK и неинтерактивных `-p`, это включает прерывание хода, пока запрос разрешения `canUseTool` или `--permission-prompt-tool` ожидает; до v2.1.216 Claude Code сообщал это прерывание как `"user_reject"`. Рассматривается как отклонение.1011 * `"user_abort"`: Выпускается, когда пользователь отклонил подсказку разрешения без ответа. В сеансах Agent SDK и неинтерактивных `-p` это включает прерывание хода, пока запрос разрешения `canUseTool` или `--permission-prompt-tool` ожидает; до v2.1.216 Claude Code сообщал это прерывание как `"user_reject"`. Рассматривается как отклонение.

969 * `"user_reject"`: Выпускается, когда пользователь выбрал "Нет" при подсказке. В интерактивном CLI это выпускается только для самого этого выбора; вызовы, которые совпадают с правилом запрета в личных параметрах пользователя, выпускают `"config"` вместо этого. В сеансах Agent SDK или неинтерактивных `-p`, вызовы, которые совпадают с правилом запрета в личных параметрах, выпускают `"user_reject"`. Рассматривается как отклонение.1012 * `"user_reject"`: Выпускается, когда пользователь выбрал "Нет" при запросе. В интерактивном CLI это выпускается только для самого этого выбора; вызовы, которые совпадают с правилом запрета в личных параметрах пользователя, выпускают `"config"` вместо этого. В сеансах Agent SDK или неинтерактивных `-p` вызовы, которые совпадают с правилом запрета в личных параметрах, выпускают `"user_reject"`. Рассматривается как отклонение.

970* `tool_parameters` (когда `OTEL_LOG_TOOL_DETAILS=1`): Строка JSON, содержащая параметры, специфичные для инструмента. Та же форма, что и [Событие результата инструмента](#tool-result-event), минус поля после выполнения, такие как `git_commit_id`. Значения могут отличаться от `tool_result` для принятого вызова, если решение разрешения переписывает вход инструмента через `updatedInput`. Используйте этот атрибут, чтобы увидеть, какая команда была отклонена, когда `decision` — это `"reject"`.1013* `tool_parameters` (когда `OTEL_LOG_TOOL_DETAILS=1`): Строка JSON, содержащая параметры, специфичные для инструмента. Та же форма, что и [Событие результата инструмента](#tool-result-event), минус поля после выполнения, такие как `git_commit_id`. Значения могут отличаться от `tool_result` для принятого вызова, если решение о разрешении переписывает вход инструмента через `updatedInput`. Используйте этот атрибут, чтобы увидеть, какая команда была отклонена, когда `decision` — это `"reject"`.

971 * Для инструментов `"sdk_host_builtin_mcp"`: `mcp_server_name` и `mcp_tool_name` включаются даже когда `OTEL_LOG_TOOL_DETAILS` отключен, потому что приложение хоста определяет эти имена; без них отклонённый вызов одного из этих встроенных серверов был бы неатрибутируемым в потоке по умолчанию. Для серверов MCP, настроенных пользователем, `tool_name` события всегда является буквальным `"mcp_tool"`, и имена сервера и инструмента отображаются только в `tool_parameters` с включённым флагом; содержание аргумента требует флага везде. Требуется Claude Code v2.1.214 или позже1014 * Для инструментов `"sdk_host_builtin_mcp"`: `mcp_server_name` и `mcp_tool_name` включаются даже когда `OTEL_LOG_TOOL_DETAILS` отключён, потому что приложение хоста определяет эти имена; без них отклонённый вызов одного из этих встроенных серверов был бы неатрибутируемым в потоке по умолчанию. Для серверов MCP, настроенных пользователем, `tool_name` события всегда является буквальным `"mcp_tool"`, и имена сервера и инструмента появляются только в `tool_parameters` с включённым флагом; содержание аргумента требует флага везде. Требуется Claude Code v2.1.214 или позже

972 * Для инструмента Bash: включает `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. Инструмент bash рабочей области приложения для рабочего стола также сообщает `tool_name` как `Bash`, но включает только `bash_command`, `full_command` и `timeout`1015 * Для инструмента Bash: включает `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`. Инструмент bash рабочей области приложения для рабочего стола также сообщает `tool_name` как `Bash`, но включает только `bash_command`, `full_command` и `timeout`

973 * Для инструментов MCP: включает `mcp_server_name`, `mcp_tool_name`1016 * Для инструментов MCP: включает `mcp_server_name`, `mcp_tool_name`

974 * Для инструмента Skill: включает `skill_name`1017 * Для инструмента Skill: включает `skill_name`

978 Событие изменения режима разрешения1021 Событие изменения режима разрешения

979</h4>1022</h4>

980 1023

981Регистрируется, когда режим разрешения изменяется, например из цикла Shift+Tab, выхода из режима плана или проверки ворот автоматического режима.1024Регистрируется, когда режим разрешения меняется, например из цикла `Shift+Tab`, выхода из режима плана или проверки ворот автоматического режима.

982 1025

983**Имя события**: `claude_code.permission_mode_changed`1026**Имя события**: `claude_code.permission_mode_changed`

984 1027

1016 Событие подключения сервера MCP1059 Событие подключения сервера MCP

1017</h4>1060</h4>

1018 1061

1019Регистрируется, когда сервер MCP подключается, отключается или не удаётся подключиться.1062Регистрируется, когда сервер MCP подключается, отключается или не может подключиться.

1020 1063

1021**Имя события**: `claude_code.mcp_server_connection`1064**Имя события**: `claude_code.mcp_server_connection`

1022 1065

1032* `duration_ms`: Длительность попытки подключения в миллисекундах1075* `duration_ms`: Длительность попытки подключения в миллисекундах

1033* `error_code`: Код ошибки, когда подключение не удалось1076* `error_code`: Код ошибки, когда подключение не удалось

1034* `is_plugin`: `true`, когда сервер предоставляется плагином, `false` в противном случае1077* `is_plugin`: `true`, когда сервер предоставляется плагином, `false` в противном случае

1035* `plugin_id_hash` (когда `is_plugin` — это `true`): Стабильный хеш имени плагина и маркетплейса для группировки событий по плагину без раскрытия имени. Claude Code вычисляет его, как описано в [событие загрузки плагина](#plugin-loaded-event)1078* `plugin_id_hash` (когда `is_plugin` — это `true`): Стабильный хеш имени плагина и маркетплейса для группировки событий по плагину без раскрытия имени. Claude Code вычисляет его, как описано в [событии загрузки плагина](#plugin-loaded-event)

1036* `plugin.name` (когда `is_plugin` — это `true`): Имя плагина, который предоставляет сервер. Для плагинов третьих сторон это буквальная строка `"third-party"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`; это защищает имена плагинов третьих сторон от появления в логах по умолчанию. Плагины из официальных источников Anthropic всегда идентифицируются по имени. Атрибуты `plugin_id_hash` и `plugin.name` передаются только вашему собственному бэкенду мониторинга и не отправляются в Anthropic1079* `plugin.name` (когда `is_plugin` — это `true`): Имя плагина, который предоставляет сервер. Для плагинов третьих сторон это буквальная строка `"third-party"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`; это защищает имена плагинов третьих сторон от появления в логах по умолчанию. Плагины из официальных источников Anthropic всегда идентифицируются по имени. Атрибуты `plugin_id_hash` и `plugin.name` передаются в ваш собственный бэкенд мониторинга и не отправляются в Anthropic

1037* `server_name` (когда `OTEL_LOG_TOOL_DETAILS=1`): Настроенное имя сервера1080* `server_name` (когда `OTEL_LOG_TOOL_DETAILS=1`): Настроенное имя сервера

1038* `error` (когда `OTEL_LOG_TOOL_DETAILS=1`): Полное сообщение об ошибке, когда подключение не удалось1081* `error` (когда `OTEL_LOG_TOOL_DETAILS=1`): Полное сообщение об ошибке, когда подключение не удалось

1039 1082

1041 Событие внутренней ошибки1084 Событие внутренней ошибки

1042</h4>1085</h4>

1043 1086

1044Регистрируется, когда Claude Code перехватывает неожиданную внутреннюю ошибку. Записываются только имя класса ошибки и код в стиле errno. Сообщение об ошибке и трассировка стека никогда не включаются. Это событие не выпускается при запуске против Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, или когда установлено `DISABLE_ERROR_REPORTING`.1087Регистрируется, когда Claude Code перехватывает неожиданную внутреннюю ошибку. Записываются только имя класса ошибки и код в стиле errno. Сообщение об ошибке и трассировка стека никогда не включаются. Это событие не выпускается при работе с Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry или когда установлен `DISABLE_ERROR_REPORTING`.

1045 1088

1046**Имя события**: `claude_code.internal_error`1089**Имя события**: `claude_code.internal_error`

1047 1090

1052* `event.timestamp`: Временная метка ISO 86011095* `event.timestamp`: Временная метка ISO 8601

1053* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)1096* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1054* `error_name`: Имя класса ошибки, например `"TypeError"` или `"SyntaxError"`1097* `error_name`: Имя класса ошибки, например `"TypeError"` или `"SyntaxError"`

1055* `error_code`: Код errno Node.js, такой как `"ENOENT"`, когда присутствует на ошибке1098* `error_code`: Код errno Node.js, такой как `"ENOENT"`, если присутствует в ошибке

1056 1099

1057<h4 id="plugin-installed-event">1100<h4 id="plugin-installed-event">

1058 Событие установки плагина1101 Событие установки плагина

1070* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)1113* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1071* `marketplace.is_official`: `"true"`, если маркетплейс является официальным маркетплейсом Anthropic, `"false"` в противном случае1114* `marketplace.is_official`: `"true"`, если маркетплейс является официальным маркетплейсом Anthropic, `"false"` в противном случае

1072* `install.trigger`: `"cli"` или `"ui"`1115* `install.trigger`: `"cli"` или `"ui"`

1073* `plugin.name`: Имя установленного плагина. Для маркетплейсов третьих сторон это включается только, когда установлено `OTEL_LOG_TOOL_DETAILS=1`1116* `plugin.name`: Имя установленного плагина. Для маркетплейсов третьих сторон это включается только когда установлен `OTEL_LOG_TOOL_DETAILS=1`

1074* `plugin.version`: Версия плагина, когда объявлена в записи маркетплейса. Для маркетплейсов третьих сторон это включается только, когда установлено `OTEL_LOG_TOOL_DETAILS=1`1117* `plugin.version`: Версия плагина, когда объявлена в записи маркетплейса. Для маркетплейсов третьих сторон это включается только когда установлен `OTEL_LOG_TOOL_DETAILS=1`

1075* `marketplace.name`: Маркетплейс, из которого был установлен плагин. Для маркетплейсов третьих сторон это включается только, когда установлено `OTEL_LOG_TOOL_DETAILS=1`1118* `marketplace.name`: Маркетплейс, из которого был установлен плагин. Для маркетплейсов третьих сторон это включается только когда установлен `OTEL_LOG_TOOL_DETAILS=1`

1076 1119

1077<h4 id="plugin-loaded-event">1120<h4 id="plugin-loaded-event">

1078 Событие загрузки плагина1121 Событие загрузки плагина

1088* `event.name`: `"plugin_loaded"`1131* `event.name`: `"plugin_loaded"`

1089* `event.timestamp`: Временная метка ISO 86011132* `event.timestamp`: Временная метка ISO 8601

1090* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)1133* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1091* `plugin.name`: имя плагина. Для плагинов вне официального маркетплейса и встроенного пакета значение — это `"third-party"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`1134* `plugin.name`: имя плагина. Для плагинов вне официального маркетплейса и встроенного пакета значение — это `"third-party"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`

1092* `marketplace.name`: маркетплейс, из которого был установлен плагин, когда известен. Редактируется в `"third-party"` при том же условии, что и `plugin.name`1135* `marketplace.name`: маркетплейс, из которого был установлен плагин, если известен. Скрыт в `"third-party"` при том же условии, что и `plugin.name`

1093* `plugin.version`: версия из манифеста плагина. Включается только, когда имя не редактируется и манифест объявляет версию1136* `plugin.version`: версия из манифеста плагина. Включается только когда имя не скрыто и манифест объявляет версию

1094* `plugin.scope`: категория происхождения для плагина: `"official"`, `"community"`, `"org"`, `"user-local"` или `"default-bundle"`1137* `plugin.scope`: категория происхождения для плагина: `"official"`, `"community"`, `"org"`, `"user-local"` или `"default-bundle"`

1095* `enabled_via`: как плагин стал включённым: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"` или `"user-install"`. Значение `"admin-install"` означает, что плагин установлен как обязательный или автоустановка для вашей организации в [**Organization settings > Plugins & skills**](https://claude.ai/admin-settings/skills?tab=inventory). До v2.1.246 Claude Code сообщал эти плагины как `"user-install"` или `"seed-mount"`1138* `enabled_via`: как плагин стал включённым: `"default-enable"`, `"org-policy"`, `"admin-install"`, `"seed-mount"` или `"user-install"`. Значение `"admin-install"` означает, что плагин установлен как обязательный или автоустановка для вашей организации в [**Organization settings > Plugins & skills**](https://claude.ai/admin-settings/skills?tab=inventory). До v2.1.246 Claude Code сообщал эти плагины как `"user-install"` или `"seed-mount"`

1096* `plugin_id_hash`: детерминированный хеш имени плагина и маркетплейса, отправляемый только вашему настроенному экспортёру. Позволяет вам считать отдельные плагины третьих сторон, загруженные в вашем парке, без записи их имён. Для [плагинов, синхронизированных из claude.ai](/docs/ru/plugins/loading#synced-plugins), Claude Code хеширует имя плагина с именем маркетплейса, которое claude.ai сообщает для плагина, или с `synced` в противном случае. До v2.1.246 Claude Code не использовал имя маркетплейса claude.ai сообщает в хеше1139* `plugin_id_hash`: детерминированный хеш имени плагина и маркетплейса, отправляемый только вашему настроенному экспортёру. Позволяет вам считать отдельные плагины третьих сторон, загруженные в вашем парке, без записи их имён. Для [плагинов, синхронизированных из claude.ai](/docs/ru/plugins/loading#synced-plugins), Claude Code хеширует имя плагина с именем маркетплейса, которое claude.ai сообщает для плагина, или с `synced` в противном случае. До v2.1.246 Claude Code не использовал имя маркетплейса claude.ai сообщает в хеше

1116* `event.name`: `"skill_activated"`1159* `event.name`: `"skill_activated"`

1117* `event.timestamp`: Временная метка ISO 86011160* `event.timestamp`: Временная метка ISO 8601

1118* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)1161* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1119* `skill.name`: Имя навыка. Для определённых пользователем и навыков плагинов третьих сторон значение — это заполнитель `"custom_skill"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`1162* `skill.name`: Имя навыка. Для определённых пользователем и навыков плагинов третьих сторон значение — это заполнитель `"custom_skill"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`

1120* `invocation_trigger`: Как был вызван навык (`"user-slash"`, `"claude-proactive"` или `"nested-skill"`)1163* `invocation_trigger`: Как был вызван навык (`"user-slash"`, `"claude-proactive"` или `"nested-skill"`)

1121* `skill.source`: Откуда был загружен навык (например, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)1164* `skill.source`: Откуда был загружен навык (например, `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)

1122* `skill.kind`: `"workflow"`, когда навык является навыком рабочего процесса. Отсутствует в противном случае1165* `skill.kind`: `"workflow"`, когда навык является навыком рабочего процесса. Отсутствует в противном случае

1158* `error`: Финальное сообщение об ошибке1201* `error`: Финальное сообщение об ошибке

1159* `status_code`: Код состояния HTTP как число. Отсутствует для ошибок, не связанных с HTTP.1202* `status_code`: Код состояния HTTP как число. Отсутствует для ошибок, не связанных с HTTP.

1160* `total_attempts`: Общее количество попыток1203* `total_attempts`: Общее количество попыток

1161* `total_retry_duration_ms`: Общее время на стене часов во всех попытках1204* `total_retry_duration_ms`: Общее время на стене во всех попытках

1162* `speed`: `"fast"` или `"normal"`1205* `speed`: `"fast"` или `"normal"`

1163 1206

1164<h4 id="hook-registered-event">1207<h4 id="hook-registered-event">

1180* `hook_source`: где определён hook: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` или `"pluginHook"`1223* `hook_source`: где определён hook: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` или `"pluginHook"`

1181* `safe_mode`: `"true"`, когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требуется Claude Code v2.1.169 или позже1224* `safe_mode`: `"true"`, когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требуется Claude Code v2.1.169 или позже

1182* `hook_matcher` (когда `OTEL_LOG_TOOL_DETAILS=1`): строка сопоставления из конфигурации hook, когда она установлена1225* `hook_matcher` (когда `OTEL_LOG_TOOL_DETAILS=1`): строка сопоставления из конфигурации hook, когда она установлена

1183* `plugin.name` (когда `hook_source` — это `"pluginHook"`): имя способствующего плагина. Для плагинов вне официального маркетплейса и встроенного пакета значение — это `"third-party"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`1226* `plugin.name` (когда `hook_source` — это `"pluginHook"`): имя участвующего плагина. Для плагинов вне официального маркетплейса и встроенного пакета значение — это `"third-party"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`

1184* `plugin_id_hash` (когда `hook_source` — это `"pluginHook"`): детерминированный хеш имени плагина и маркетплейса, отправляемый только вашему настроенному экспортёру. Позволяет вам считать отдельные способствующие плагины без записи их имён. Claude Code вычисляет его, как описано в [событие загрузки плагина](#plugin-loaded-event)1227* `plugin_id_hash` (когда `hook_source` — это `"pluginHook"`): детерминированный хеш имени плагина и маркетплейса, отправляемый только вашему настроенному экспортёру. Позволяет вам считать отдельные участвующие плагины без записи их имён. Claude Code вычисляет его, как описано в [событии загрузки плагина](#plugin-loaded-event)

1185 1228

1186<h4 id="hook-execution-start-event">1229<h4 id="hook-execution-start-event">

1187 Событие начала выполнения hook1230 Событие начала выполнения hook

1203* `managed_only`: `"true"`, когда разрешены только hooks управляемой политики1246* `managed_only`: `"true"`, когда разрешены только hooks управляемой политики

1204* `hook_source`: `"policySettings"` или `"merged"`1247* `hook_source`: `"policySettings"` или `"merged"`

1205* `safe_mode`: `"true"`, когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требуется Claude Code v2.1.169 или позже1248* `safe_mode`: `"true"`, когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требуется Claude Code v2.1.169 или позже

1206* `hook_definitions`: Сериализованная JSON конфигурация hook. Включается только, когда включены как детальная бета-трассировка, так и `OTEL_LOG_TOOL_DETAILS=1`1249* `hook_definitions`: Конфигурация hook, сериализованная в JSON. Включается только когда включены как детальная бета-трассировка, так и `OTEL_LOG_TOOL_DETAILS=1`

1207 1250

1208<h4 id="hook-execution-complete-event">1251<h4 id="hook-execution-complete-event">

1209 Событие завершения выполнения hook1252 Событие завершения выполнения hook

1226* `num_blocking`: Количество, которое вернуло решение блокировки1269* `num_blocking`: Количество, которое вернуло решение блокировки

1227* `num_non_blocking_error`: Количество, которое не удалось без блокировки1270* `num_non_blocking_error`: Количество, которое не удалось без блокировки

1228* `num_cancelled`: Количество отменено до завершения1271* `num_cancelled`: Количество отменено до завершения

1229* `total_duration_ms`: Длительность на стене часов всех совпадающих hooks1272* `total_duration_ms`: Длительность на стене всех совпадающих hooks

1230* `stdout_chars`: Общее количество символов stdout в совпадающих hooks, которые успешно завершились. Требуется Claude Code v2.1.280 или позже1273* `stdout_chars`: Общее количество символов stdout в совпадающих hooks, которые успешно завершились. Требуется Claude Code v2.1.280 или позже

1231* `additional_context_chars`: Общее количество символов `additionalContext`, возвращённых совпадающими hooks. Требуется Claude Code v2.1.280 или позже1274* `additional_context_chars`: Общее количество символов `additionalContext`, возвращённых совпадающими hooks. Требуется Claude Code v2.1.280 или позже

1232* `system_message_chars`: Общее количество символов `systemMessage`, возвращённых совпадающими hooks. Требуется Claude Code v2.1.280 или позже1275* `system_message_chars`: Общее количество символов `systemMessage`, возвращённых совпадающими hooks. Требуется Claude Code v2.1.280 или позже

1233* `initial_user_message_chars`: Общее количество символов `initialUserMessage`, возвращённых совпадающими hooks. Требуется Claude Code v2.1.280 или позже1276* `initial_user_message_chars`: Общее количество символов `initialUserMessage`, возвращённых совпадающими hooks. Требуется Claude Code v2.1.280 или позже

1234* `num_outputs_persisted`: Количество выходов hook сверх [лимита 10 000 символов](/docs/ru/hooks#json-output), которые Claude Code сохранил в файл. Требуется Claude Code v2.1.280 или позже1277* `num_outputs_persisted`: Количество выходов hook свыше [10 000-символьного лимита](/docs/ru/hooks#json-output), которые Claude Code сохранил в файл. Требуется Claude Code v2.1.280 или позже

1235* `managed_only`: `"true"`, когда разрешены только hooks управляемой политики1278* `managed_only`: `"true"`, когда разрешены только hooks управляемой политики

1236* `hook_source`: `"policySettings"` или `"merged"`1279* `hook_source`: `"policySettings"` или `"merged"`

1237* `safe_mode`: `"true"`, когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требуется Claude Code v2.1.169 или позже1280* `safe_mode`: `"true"`, когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требуется Claude Code v2.1.169 или позже

1238* `hook_definitions`: Сериализованная JSON конфигурация hook. Включается только, когда включены как детальная бета-трассировка, так и `OTEL_LOG_TOOL_DETAILS=1`1281* `hook_definitions`: Конфигурация hook, сериализованная в JSON. Включается только когда включены как детальная бета-трассировка, так и `OTEL_LOG_TOOL_DETAILS=1`

1239 1282

1240<h4 id="hook-plugin-metrics-event">1283<h4 id="hook-plugin-metrics-event">

1241 Событие метрик hook плагина1284 Событие метрик hook плагина

1242</h4>1285</h4>

1243 1286

1244Регистрируется, когда hook плагина официального маркетплейса выпускает метрики на выполнение. Только плагины, установленные из официального маркетплейса Anthropic, могут выпускать эти. Плагины маркетплейса третьих сторон и пользовательские hooks не выпускают в это событие. Используйте это событие для мониторинга поведения плагина, такого как скорости поиска, затраты и длительность из вашего собственного стека наблюдаемости.1287Регистрируется, когда hook плагина официального маркетплейса выпускает метрики на выполнение. Только плагины, установленные из официального маркетплейса Anthropic, могут выпускать эти. Плагины маркетплейса третьих сторон и настроенные пользователем hooks не выпускают в это событие. Используйте это событие для мониторинга поведения плагина, такого как поиск скоростей, затрат и длительностей из вашего собственного стека наблюдаемости.

1245 1288

1246**Имя события**: `claude_code.hook_plugin_metrics`1289**Имя события**: `claude_code.hook_plugin_metrics`

1247 1290

1272* `trigger`: `"auto"` или `"manual"`1315* `trigger`: `"auto"` или `"manual"`

1273* `success`: `"true"` или `"false"`1316* `success`: `"true"` или `"false"`

1274* `duration_ms`: Длительность компактирования1317* `duration_ms`: Длительность компактирования

1275* `pre_tokens`: Приблизительный подсчёт токенов до компактирования1318* `pre_tokens`: Приблизительный счёт токенов до компактирования

1276* `post_tokens`: Приблизительный подсчёт токенов после компактирования1319* `post_tokens`: Приблизительный счёт токенов после компактирования

1277* `error`: Сообщение об ошибке, когда компактирование не удалось1320* `error`: Сообщение об ошибке, когда компактирование не удалось

1278* `precompute_reuse`: Установлено только, когда `trigger` — это `"manual"`. Автокомпактирование может подготовить резюме в фоне перед заполнением окна контекста, и этот атрибут записывает, было ли это подготовленное резюме повторно использовано `/compact`. `"hit"` означает, что оно было повторно использовано; `"miss_custom_instructions"`, `"miss_hook"` и `"miss_not_ready"` дают причину, по которой вместо этого было вычислено свежее резюме. Требуется Claude Code v2.1.153 или позже1321* `precompute_reuse`: Установлено только когда `trigger` — это `"manual"`. Автокомпактирование может подготовить сводку в фоне перед заполнением окна контекста, и этот атрибут записывает, повторно ли использовал `/compact` эту подготовленную сводку. `"hit"` означает, что она была повторно использована; `"miss_custom_instructions"`, `"miss_hook"` и `"miss_not_ready"` дают причину, по которой вместо этого была вычислена свежая сводка. Требуется Claude Code v2.1.153 или позже

1279 1322

1280<h4 id="subagent-completed-event">1323<h4 id="subagent-completed-event">

1281 Событие завершения подагента1324 Событие завершения подагента

1282</h4>1325</h4>

1283 1326

1284Регистрируется, когда [подагент](/docs/ru/sub-agents) завершается и возвращает свой результат в разговор, который его запустил. Используйте его для сворачивания использования инструментов и времени выполнения по типу подагента; для сворачивания токенов или затрат используйте [счётчик токенов](#token-counter) и [счётчик стоимости](#cost-counter), отфильтрованные по `query_source` `"subagent"`, так как `total_tokens` этого события охватывает только финальный запрос. Категория `"subagent"` также считает запросы от hooks на основе агентов, которые не выпускают событие подагента.1327Регистрируется, когда [подагент](/docs/ru/sub-agents) завершает работу и возвращает свой результат в разговор, который его запустил. Используйте его для сворачивания использования инструментов и времени выполнения по типу подагента; для сворачивания токенов или стоимости используйте [счётчик токенов](#token-counter) и [счётчик стоимости](#cost-counter), отфильтрованные по `query_source` `"subagent"`, так как `total_tokens` этого события охватывает только финальный запрос. Категория `"subagent"` также считает запросы из hooks на основе агентов, которые не выпускают событие подагента.

1285 1328

1286**Имя события**: `claude_code.subagent_completed`1329**Имя события**: `claude_code.subagent_completed`

1287 1330

1291* `event.name`: `"subagent_completed"`1334* `event.name`: `"subagent_completed"`

1292* `event.timestamp`: Временная метка ISO 86011335* `event.timestamp`: Временная метка ISO 8601

1293* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)1336* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1294* `agent_type`: Тип подагента. Встроенные имена агентов и агенты из официальных плагинов маркетплейса отображаются как есть; другие имена агентов заменяются на `"custom"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`1337* `agent_type`: Тип подагента. Встроенные имена агентов и агенты из официальных плагинов маркетплейса отображаются как есть; другие имена агентов заменяются на `"custom"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`

1295* `agent.source`: Откуда пришло определение агента: `built-in`, `plugin` или источник параметров, который определил пользовательского агента, например `userSettings` или `projectSettings`1338* `agent.source`: Откуда пришло определение агента: `built-in`, `plugin` или источник параметров, который определил пользовательского агента, например `userSettings` или `projectSettings`

1296* `is_built_in`: Является ли подагент встроенным типом агента1339* `is_built_in`: Является ли подагент встроенным типом агента

1297* `is_async`: Работал ли подагент в [фоне](/docs/ru/sub-agents#run-subagents-in-foreground-or-background)1340* `is_async`: Работал ли подагент в [фоне](/docs/ru/sub-agents#run-subagents-in-foreground-or-background)

1298* `total_tokens`: Отпечаток токена финального запроса API подагента: входные, создание кэша, чтение кэша и выходные токены этого одного запроса, примерно размер контекста подагента при завершении. Не сумма по всему запуску1341* `total_tokens`: Объём токенов финального запроса API подагента: входные, создание кэша, чтение кэша и выходные токены этого одного запроса, примерно размер контекста подагента при завершении. Не сумма по всему запуску

1299* `total_tool_uses`: Количество вызовов инструментов, которые подагент сделал во всём запуске1342* `total_tool_uses`: Количество вызовов инструментов, которые подагент сделал во всём запуске

1300* `duration_ms`: Время выполнения в миллисекундах1343* `duration_ms`: Время выполнения в миллисекундах

1301* `model`: Модель, на которую был разрешён подагент для запуска1344* `model`: Модель, на которую был разрешён подагент для запуска

1302* `final_model`: Модель, которая создала финальный ответ подагента, отличающаяся от `model` после переключения во время запуска, такого как резервный вариант. Требуется Claude Code v2.1.212 или позже1345* `final_model`: Модель, которая создала финальный ответ подагента, отличающаяся от `model` после переключения во время запуска, такого как резервный вариант. Требуется Claude Code v2.1.212 или позже

1303* `model_swapped`: Обслуживала ли более одной модели запросы подагента. Требуется Claude Code v2.1.212 или позже1346* `model_swapped`: Обслуживала ли более одной модели запросы подагента. Требуется Claude Code v2.1.212 или позже

1304* `plugin_id_hash`, `plugin.name`: Присутствует для агентов, предоставленных плагинами. Имена плагинов официального маркетплейса отображаются как есть; другие имена плагинов заменяются на `"third-party"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`1347* `plugin_id_hash`, `plugin.name`: Присутствует для агентов, предоставляемых плагинами. Имена плагинов официального маркетплейса отображаются как есть; другие имена плагинов заменяются на `"third-party"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`

1305 1348

1306<h4 id="feedback-survey-event">1349<h4 id="feedback-survey-event">

1307 Событие опроса обратной связи1350 Событие опроса обратной связи

1321* `appearance_id`: Уникальный ID, связывающий события, выпущенные для одного экземпляра опроса1364* `appearance_id`: Уникальный ID, связывающий события, выпущенные для одного экземпляра опроса

1322* `survey_type`: Какой опрос создал событие. `"session"` — это подсказка рейтинга "Как работает Claude?"1365* `survey_type`: Какой опрос создал событие. `"session"` — это подсказка рейтинга "Как работает Claude?"

1323* `response`: Выбор пользователя на событиях `responded`1366* `response`: Выбор пользователя на событиях `responded`

1324* `enabled_via_override`: `true`, когда установлено [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/ru/env-vars). Выпускается как логическое значение, не строка. Присутствует на событиях опроса `session`. Фильтруйте по этому атрибуту, чтобы подтвердить, что переопределение применяется в парке1367* `enabled_via_override`: `true`, когда установлен [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/ru/env-vars). Выпускается как логическое значение, а не строка. Присутствует на событиях опроса `session`. Отфильтруйте по этому атрибуту, чтобы подтвердить, что переопределение применяется в парке

1325 1368

1326<h4 id="retention-sweep-event">1369<h4 id="retention-sweep-event">

1327 Событие развёртки удержания1370 Событие развёртки удержания

1328</h4>1371</h4>

1329 1372

1330Регистрируется один раз за запуск развёртки очистки удержания, которая удаляет [стенограммы сеансов и другие данные приложения](/docs/ru/claude-directory#cleaned-up-automatically), старше чем параметр [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays). Claude Code запускает развёртку в фоне максимум один раз за сеанс, и запуск, который ничего не удаляет, всё ещё выпускает событие. Если Claude Code запустил развёртку в любом сеансе на одной машине в последние 24 часа, он задерживает развёртку этого сеанса как минимум на 10 минут, поэтому сеанс, который выходит раньше, ничего не выпускает. Когда вы запускаете `claude -p` с `--bare`, Claude Code не запускает развёртку и ничего не выпускает.1373Регистрируется один раз за запуск развёртки очистки удержания, которая удаляет [транскрипты сеансов и другие данные приложения](/docs/ru/claude-directory#cleaned-up-automatically) старше параметра [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays). Claude Code запускает развёртку в фоне максимум один раз за сеанс, и запуск, который ничего не удаляет, всё равно выпускает событие. Если Claude Code запустил развёртку в любом сеансе на одной машине в последние 24 часа, он задерживает развёртку этого сеанса как минимум на 10 минут, поэтому сеанс, который выходит раньше, ничего не выпускает. Когда вы запускаете `claude -p` с `--bare`, Claude Code не запускает развёртку и ничего не выпускает.

1331 1374

1332Как каждое событие OTel на этой странице, оно идёт только на бэкенд телеметрии, который вы настраиваете. Требуется Claude Code v2.1.227 или позже.1375Как каждое событие OTel на этой странице, оно идёт только на бэкенд телеметрии, который вы настраиваете. Требуется Claude Code v2.1.227 или позже.

1333 1376

1334Когда Claude Code не может безопасно определить период удержания, он приостанавливает развёртку и выпускает событие с `result`, установленным в `"skipped"`, и `skip_reason`. Когда [управляемые параметры](/docs/ru/server-managed-settings) устанавливают `cleanupPeriodDays`, управляемое значение закрепляет период удержания и развёртка работает даже когда файл параметров в более низком приоритете области повреждён или недействителен. Когда сам `managed-settings.json` не может быть прочитан, Claude Code всё ещё приостанавливает развёртку, если только [управляемый уровень](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) не поставляет `cleanupPeriodDays` откуда-то ещё, например из параметров, управляемых сервером, или `managed-settings.d/` drop-in рядом с повреждённым файлом. Атрибуты счётчика удаления присутствуют только, когда `result` — это `"complete"`.1377Когда Claude Code не может безопасно определить период удержания, он приостанавливает развёртку и выпускает событие с `result`, установленным в `"skipped"` и `skip_reason`. Когда [управляемые параметры](/docs/ru/server-managed-settings) устанавливают `cleanupPeriodDays`, управляемое значение закрепляет период удержания и развёртка работает даже когда файл параметров в более низком приоритете сломан или недействителен. Когда сам `managed-settings.json` не может быть прочитан, Claude Code всё равно приостанавливает развёртку, если только [управляемый уровень](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) не поставляет `cleanupPeriodDays` откуда-то ещё, например из параметров, управляемых сервером, или из `managed-settings.d/` drop-in рядом с повреждённым файлом. Атрибуты счётчика удаления присутствуют только когда `result` — это `"complete"`.

1335 1378

1336**Имя события**: `claude_code.retention_sweep`1379**Имя события**: `claude_code.retention_sweep`

1337 1380

1343* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)1386* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1344* `result`: `"complete"`, когда развёртка работала, `"skipped"`, когда Claude Code её приостановил1387* `result`: `"complete"`, когда развёртка работала, `"skipped"`, когда Claude Code её приостановил

1345* `period_days`: Значение `cleanupPeriodDays` из объединённых параметров, в днях, или `30`, когда ни один источник его не устанавливает. На пропущенных событиях значение, которое развёртка использовала бы, вычисленное из источников параметров, которые Claude Code мог прочитать1388* `period_days`: Значение `cleanupPeriodDays` из объединённых параметров, в днях, или `30`, когда ни один источник его не устанавливает. На пропущенных событиях значение, которое развёртка использовала бы, вычисленное из источников параметров, которые Claude Code мог прочитать

1346* `used_default`: `"true"`, когда ни один читаемый источник параметров не устанавливает `cleanupPeriodDays`, `"false"` в противном случае. На полных событиях `"true"` означает, что применялось значение по умолчанию 30 дней1389* `used_default`: `"true"`, когда ни один читаемый источник параметров не устанавливает `cleanupPeriodDays`, `"false"` в противном случае. На полных событиях `"true"` означает, что применён 30-дневный стандарт

1347* `skip_reason`: Почему Claude Code приостановил развёртку. Присутствует только, когда `result` — это `"skipped"`:1390* `skip_reason`: Почему Claude Code приостановил развёртку. Присутствует только когда `result` — это `"skipped"`:

1348 * `"user_source_disabled"`: Параметры пользователя исключены, например флагом [`--setting-sources`](/docs/ru/cli-reference#cli-flags) или опцией [`settingSources`](/docs/ru/agent-sdk/typescript#options) SDK, и ни один включённый источник не предоставляет `cleanupPeriodDays`1391 * `"user_source_disabled"`: Параметры пользователя исключены, например флагом [`--setting-sources`](/docs/ru/cli-reference#cli-flags) или опцией [`settingSources`](/docs/ru/agent-sdk/typescript#options) SDK, и ни один включённый источник не предоставляет `cleanupPeriodDays`

1349 * `"settings_unknowable"`: Файл параметров не мог быть прочитан или разобран, поэтому `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays` может быть установлен на значение, которое Claude Code не может видеть1392 * `"settings_unknowable"`: Файл параметров не может быть прочитан или разобран, поэтому `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays` может быть установлен в значение, которое Claude Code не может видеть

1350 * `"settings_invalid_key_set"`: Параметры имеют ошибки валидации и `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays` явно установлены, поэтому возврат к значению по умолчанию может удалить или сохранить файлы против этого параметра1393 * `"settings_invalid_key_set"`: Параметры имеют ошибки валидации и `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays` явно установлены, поэтому возврат к стандарту может удалить или сохранить файлы против этого параметра

1351* `transcripts_deleted`: Количество стенограмм сеансов, файлы верхнего уровня `~/.claude/projects/*/*.jsonl`, которые развёртка удалила1394* `transcripts_deleted`: Количество транскриптов сеансов, файлы верхнего уровня `~/.claude/projects/*/*.jsonl`, которые развёртка удалила

1352* `transcripts_exempted_desktop`: Количество стенограмм, прошедших период удержания, которые развёртка сохранила в соответствии с [правилом Claude Desktop и Cowork](/docs/ru/claude-directory#cleaned-up-automatically). Они не считаются в `files_past_cutoff`. Требуется Claude Code v2.1.248 или позже1395* `transcripts_exempted_desktop`: Количество транскриптов прошлого периода удержания, которые развёртка сохранила в соответствии с [правилом Claude Desktop и Cowork](/docs/ru/claude-directory#cleaned-up-automatically). Они не считаются в `files_past_cutoff`. Требуется Claude Code v2.1.248 или позже

1353* `session_files_deleted`: Количество артефактов, которые развёртка файлов сеанса удалила: стенограммы плюс файлы-спутники на сеанс, такие как боковые панели, записи и результаты инструментов1396* `session_files_deleted`: Количество артефактов, которые развёртка файлов сеанса удалила: транскрипты плюс файлы-спутники для каждого сеанса, такие как боковые панели, записи и результаты инструментов

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

1355* `files_retained_fresh`: Файлы, проверенные и оставленные на месте, потому что они всё ещё находятся в пределах периода удержания. Только развёртки на основе файлов считают эти, поэтому значение — это нижний предел; ненулевое значение — это нормальное устойчивое состояние1398* `files_retained_fresh`: Файлы, проверенные и оставленные на месте, потому что они всё ещё находятся в пределах периода удержания. Только развёртки для каждого файла считают эти, поэтому значение — это нижний предел; ненулевое значение — это нормальное устойчивое состояние

1356* `files_past_cutoff`: Файлы, старше чем период удержания, которые развёртка не удалась удалить, например из-за ошибки разрешения или файла, удерживаемого открытым. Значение выше нуля означает, что файлы пережили настроенный период удержания; ноль не является доказательством того, что они не были, потому что неудачное удаление целого каталога считается в `error_count` вместо этого1399* `files_past_cutoff`: Файлы старше периода удержания, которые развёртка не смогла удалить, например из-за ошибки разрешения или файла, удерживаемого открытым. Значение выше нуля означает, что файлы пережили настроенный период удержания; ноль не является доказательством того, что они не были, потому что неудачное удаление целого каталога считается в `error_count` вместо этого

1357* `error_count`: Количество ошибок, которые развёртка встретила при перечислении или удалении файлов1400* `error_count`: Количество ошибок, которые развёртка встретила при перечислении или удалении файлов

1358 1401

1359<h4 id="managed-settings-resolved-event">1402<h4 id="managed-settings-resolved-event">

1360 Событие разрешения управляемых параметров1403 Событие разрешения управляемых параметров

1361</h4>1404</h4>

1362 1405

1363Регистрируется с [управляемыми параметрами](/docs/ru/managed-settings), которые сеанс разрешил: один раз при запуске сеанса, снова когда либо управляемые параметры, либо состояние [помощника политики](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) изменяется во время сеанса, и когда Claude Code отказывает в запуске или завершает сеанс по одной из причин, которые атрибут `error.type` перечисляет.1406Регистрируется с [управляемыми параметрами](/docs/ru/managed-settings), которые разрешил сеанс: один раз при запуске сеанса, снова когда либо управляемые параметры, либо состояние [помощника политики](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) меняется во время сеанса, и когда Claude Code отказывается запускаться или заканчивает сеанс по одной из причин, которые атрибут `error.type` перечисляет.

1364Используйте это событие, чтобы найти машины, работающие на неожиданном управляемом источнике, машины, чей помощник политики не работает, и причину, по которой машина отказала в запуске.1407Используйте это событие, чтобы найти машины, работающие на неожиданном управляемом источнике, машины, чей помощник политики не работает, и причину, по которой машина отказалась запускаться.

1365Требуется Claude Code v2.1.274 или позже.1408Требуется Claude Code v2.1.274 или позже.

1366 1409

1367По умолчанию событие содержит управляемые источники и состояние помощника политики, но не сами параметры. Чтобы добавить редактируемый атрибут `managed_settings.settings` и дайджест `managed_settings.resolved_sha256`, установите `OTEL_LOG_MANAGED_SETTINGS=1`:1410По умолчанию событие содержит управляемые источники и состояние помощника политики, но не сами параметры. Чтобы добавить скрытый атрибут `managed_settings.settings` и дайджест `managed_settings.resolved_sha256`, установите `OTEL_LOG_MANAGED_SETTINGS=1`:

1368 1411

1369* Установите его в блоке `env` управляемых параметров, параметров пользователя или `--settings`, или в окружении, в котором вы запускаете Claude Code. Значение в параметрах проекта или локальных параметрах не включает его, потому что клонированный репозиторий может их писать.1412* Установите его в блоке `env` управляемых параметров, параметров пользователя или `--settings`, или в среде, в которой вы запускаете Claude Code. Значение в параметрах проекта или локальных параметрах не включает его, потому что клонированный репозиторий может их писать.

1370* Параметры, управляемые сервером, могут установить его без показа [диалога одобрения безопасности](/docs/ru/server-managed-settings#security-approval-dialogs), потому что переменная только добавляет вашу собственную редактируемую политику организации к событию, которое ваша организация уже получает.1413* Параметры, управляемые сервером, могут установить его без отображения [диалога одобрения безопасности](/docs/ru/server-managed-settings#security-approval-dialogs), потому что переменная только добавляет вашу собственную скрытую политику организации к событию, которое ваша организация уже получает.

1371 1414

1372В интерактивном сеансе в папке, которую вы не [доверили](/docs/ru/permissions#what-runs-before-you-trust-a-folder), Claude Code не экспортирует событие отказа.1415В интерактивном сеансе в папке, которую вы не [доверили](/docs/ru/permissions#what-runs-before-you-trust-a-folder), Claude Code не экспортирует событие отказа.

1373 1416

1379* `event.name`: `"managed_settings_resolved"`1422* `event.name`: `"managed_settings_resolved"`

1380* `event.timestamp`: Временная метка ISO 86011423* `event.timestamp`: Временная метка ISO 8601

1381* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)1424* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

1382* `managed_settings.trigger`: `"startup"` для события запуска сеанса, `"change"`, когда управляемые параметры или состояние помощника политики изменились позже в сеансе, или `"refused"`, когда политика управляемых параметров остановила сеанс. Claude Code отправляет событие `change` только, когда атрибут отличается от последнего события, которое он отправил, и изменённое значение параметра считается даже когда `OTEL_LOG_MANAGED_SETTINGS` отключен1425* `managed_settings.trigger`: `"startup"` для события запуска сеанса, `"change"`, когда управляемые параметры или состояние помощника политики изменились позже в сеансе, или `"refused"`, когда политика управляемых параметров остановила сеанс. Claude Code отправляет событие `change` только когда атрибут отличается от последнего события, которое он отправил, и изменённое значение параметра считается даже когда `OTEL_LOG_MANAGED_SETTINGS` отключён

1383* `error.type`: почему Claude Code остановил сеанс. Присутствует только на событиях `refused`:1426* `error.type`: почему Claude Code остановил сеанс. Присутствует только на событиях `refused`:

1384 * `"helper_failed"`: [запуск помощника политики не удался](/docs/ru/settings-reference#helper-failures)1427 * `"helper_failed"`: [запуск помощника политики не удался](/docs/ru/settings-reference#helper-failures)

1385 * `"policy_invalid"`: управляемые параметры содержат ошибку, которая останавливает Claude Code от запуска, или источник администратора не удалось загрузить, поэтому Claude Code не может проверить принудительное входа организации1428 * `"policy_invalid"`: управляемые параметры содержат ошибку, которая останавливает Claude Code от запуска, или источник администратора не смог загрузиться, поэтому Claude Code не может проверить принудительный вход организации

1386 * `"consent_rejected"`: пользователь отклонил [диалог одобрения безопасности](/docs/ru/server-managed-settings#security-approval-dialogs) для параметров, управляемых сервером1429 * `"consent_rejected"`: пользователь отклонил [диалог одобрения безопасности](/docs/ru/server-managed-settings#security-approval-dialogs) для параметров, управляемых сервером

1387 * `"force_refresh_failed"`: выборка параметров, которую требует [`forceRemoteSettingsRefresh`](/docs/ru/settings-reference#forceremotesettingsrefresh), не удалась1430 * `"force_refresh_failed"`: выборка параметров, которую требует [`forceRemoteSettingsRefresh`](/docs/ru/settings-reference#forceremotesettingsrefresh), не удалась

1388 * `"gateway_rejected"`: [шлюз приложений Claude](/docs/ru/claude-apps-gateway) ответил на загрузку управляемых параметров с HTTP 4031431 * `"gateway_rejected"`: [шлюз приложений Claude](/docs/ru/claude-apps-gateway) ответил на загрузку управляемых параметров с HTTP 403

1389 * `"version_below_minimum"`: эта версия Claude Code ниже [`requiredMinimumVersion`](/docs/ru/settings-reference#requiredminimumversion) или выше [`requiredMaximumVersion`](/docs/ru/settings-reference#requiredmaximumversion)1432 * `"version_below_minimum"`: эта версия Claude Code ниже [`requiredMinimumVersion`](/docs/ru/settings-reference#requiredminimumversion) или выше [`requiredMaximumVersion`](/docs/ru/settings-reference#requiredmaximumversion)

1390 * `"_OTHER"`: загрузка управляемых параметров шлюза приложений Claude не удалась по другой причине1433 * `"_OTHER"`: загрузка управляемых параметров шлюза приложений Claude не удалась по другой причине

1391* `managed_settings.sources`: каждый управляемый источник, который доставляет как минимум один [ключ политики](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), в порядке приоритета от высшего к низшему, включая источники, чьи ключи не вступают в силу в соответствии с `first-wins`. Значения — это `"remote"`, `"plist"` или `"hklm"` для политики MDM или уровня ОС, `"file"` для файлов управляемых параметров и drop-ins, `"parent"`, когда [хост встраивания](/docs/ru/managed-settings#let-an-embedding-host-add-policy) поставляет параметры, и `"hkcu"` для [значения реестра Windows HKCU](/docs/ru/managed-settings#where-each-mechanism-stores-the-policy), когда Claude Code [его читает](/docs/ru/managed-settings#how-claude-code-combines-managed-sources). Источник, который содержит только ключи управления, или который Claude Code не мог прочитать, не указывается. Выпускается как массив строк, пусто, когда ни один управляемый источник не доставляет ключ политики1434* `managed_settings.sources`: каждый управляемый источник, который доставляет как минимум один [ключ политики](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), в порядке убывания приоритета, включая источники, чьи ключи не вступают в силу в `first-wins`. Значения — это `"remote"`, `"plist"` или `"hklm"` для политики MDM или уровня ОС, `"file"` для файлов управляемых параметров и drop-ins, `"parent"`, когда [хост встраивания](/docs/ru/managed-settings#let-an-embedding-host-add-policy) поставляет параметры, и `"hkcu"` для [значения реестра Windows HKCU](/docs/ru/managed-settings#where-each-mechanism-stores-the-policy), когда Claude Code [его читает](/docs/ru/managed-settings#how-claude-code-combines-managed-sources). Источник, который содержит только ключи управления или который Claude Code не смог прочитать, не указан. Выпускается как массив строк, пусто, когда ни один управляемый источник не доставляет ключ политики

1392* `managed_settings.source_behavior`: значение [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior), которое Claude Code прочитал, `"first-wins"` или `"merge"`. `"first-wins"`, когда ни один источник не устанавливает ключ1435* `managed_settings.source_behavior`: значение [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior), которое Claude Code прочитал, `"first-wins"` или `"merge"`. `"first-wins"`, когда ни один источник не устанавливает ключ

1393* `managed_settings.helper.state`: состояние помощника политики, который выбранный источник MDM или файла настраивает:1436* `managed_settings.helper.state`: состояние помощника политики, который выбранный источник MDM или файла настраивает:

1394 * `"ok"`: выход помощника служит управляемыми параметрами1437 * `"ok"`: выход помощника служит управляемыми параметрами

1396 * `"none"`: помощник не настроен, или источник, который его настраивает, не является политикой MDM или файлом управляемых параметров1439 * `"none"`: помощник не настроен, или источник, который его настраивает, не является политикой MDM или файлом управляемых параметров

1397* `managed_settings.helper.applied`: `"output"`, пока выход помощника служит управляемыми параметрами, `"none"`, когда он не служит1440* `managed_settings.helper.applied`: `"output"`, пока выход помощника служит управляемыми параметрами, `"none"`, когда он не служит

1398* `managed_settings.helper.entry`: `"policyHelper"`, когда Claude Code выбрал [`policyHelper`](/docs/ru/settings-reference#policyhelper). Отсутствует, когда он не выбрал помощника1441* `managed_settings.helper.entry`: `"policyHelper"`, когда Claude Code выбрал [`policyHelper`](/docs/ru/settings-reference#policyhelper). Отсутствует, когда он не выбрал помощника

1399* `managed_settings.helper.path`: настроенный [`path`](/docs/ru/settings-reference#policyhelper-path) помощника. Присутствует, когда Claude Code выбрал помощника, независимо от того, установлено ли `OTEL_LOG_MANAGED_SETTINGS`1442* `managed_settings.helper.path`: настроенный [`path`](/docs/ru/settings-reference#policyhelper-path) помощника. Присутствует всякий раз, когда Claude Code выбрал помощника, независимо от того, установлен ли `OTEL_LOG_MANAGED_SETTINGS`

1400* `managed_settings.resolved_sha256` (когда `OTEL_LOG_MANAGED_SETTINGS=1`): SHA-256 разрешённых управляемых параметров перед редактированием, сериализованных как JSON с ключами, отсортированными рекурсивно и без пробелов. Машины с одинаковым дайджестом работают с одной и той же политикой. Claude Code отправляет дайджест только с opt-in, потому что короткая политика может быть восстановлена путём хеширования предположений. Отсутствует, когда управляемые параметры не разрешены, и на событиях `refused`1443* `managed_settings.resolved_sha256` (когда `OTEL_LOG_MANAGED_SETTINGS=1`): SHA-256 разрешённых управляемых параметров перед скрытием, сериализованных как JSON с ключами, отсортированными рекурсивно и без пробелов. Машины с одинаковым дайджестом работают с одной и той же политикой. Claude Code отправляет дайджест только с opt-in, потому что короткая политика может быть восстановлена путём хеширования предположений. Отсутствует, когда управляемые параметры не разрешены, и на событиях `refused`

1401* `managed_settings.settings` (когда `OTEL_LOG_MANAGED_SETTINGS=1`): имена и форма разрешённых управляемых параметров как строка JSON, с редактируемыми значениями. Отсутствует на событиях `refused`. Claude Code строит его из своей схемы параметров:1444* `managed_settings.settings` (когда `OTEL_LOG_MANAGED_SETTINGS=1`): имена и форма разрешённых управляемых параметров как строка JSON со скрытыми значениями. Отсутствует на событиях `refused`. Claude Code строит её из своей схемы параметров:

1402 1445

1403 * Имя параметра, которое схема объявляет, экспортируется, и ключ, который она не объявляет, опускается1446 * Имя параметра, которое схема объявляет, экспортируется, и ключ, который она не объявляет, опускается

1404 * Логические значения, числа и строковые значения, которые схема ограничивает фиксированным набором опций, такие как `permissions.defaultMode`, экспортируются как есть. `sandbox.network.httpProxyPort` и `sandbox.network.socksProxyPort` экспортируются как `"[REDACTED]"`1447 * Логические значения, числа и строковые значения, которые схема ограничивает фиксированным набором опций, например `permissions.defaultMode`, экспортируются как есть. `sandbox.network.httpProxyPort` и `sandbox.network.socksProxyPort` экспортируются как `"[REDACTED]"`

1405 * Каждая другая строка, такая как `model`, `apiKeyHelper`, каждое значение `env`, каждый URL и каждая команда, экспортируется как `"[REDACTED]"`1448 * Каждая другая строка, такая как `model`, `apiKeyHelper`, каждое значение `env`, каждый URL и каждая команда, экспортируется как `"[REDACTED]"`

1406 * Имена записей карт, такие как имена переменных `env` и ID плагинов, экспортируются как есть. Параметр, чьи записи схема не типирует, такой как `vimInsertModeRemaps`, экспортируется как одиночный `"[REDACTED]"`, и `sandbox.ignoreViolations` экспортируется как список его списков путей без шаблонов команд1449 * Имена записей карт, такие как имена переменных `env` и ID плагинов, экспортируются как есть. Параметр, чьи записи схема не типизирует, например `vimInsertModeRemaps`, экспортируется как одиночный `"[REDACTED]"`, и `sandbox.ignoreViolations` экспортируется как список его списков путей без шаблонов команд

1407 * Список сохраняет свою длину, с каждой записью редактируемой по тем же правилам1450 * Список сохраняет свою длину, с каждой записью скрытой по тем же правилам

1408 * Правило `permissions.allow`, `permissions.deny` или `permissions.ask` экспортируется как его имя инструмента с редактируемым содержанием, такое как `Read([REDACTED])`, когда инструмент встроен в эту версию Claude Code или является ссылкой `mcp__`, такой как `mcp__jira__create_issue`. Любое другое правило экспортируется как `"[REDACTED]"`1451 * Правило `permissions.allow`, `permissions.deny` или `permissions.ask` экспортируется как его имя инструмента со скрытым содержанием, например `Read([REDACTED])`, когда инструмент встроен в эту версию Claude Code или является ссылкой `mcp__`, такой как `mcp__jira__create_issue`. Любое другое правило экспортируется как `"[REDACTED]"`

1409 * Hooks следуют тем же правилам, поэтому поля с фиксированными опциями и числовые поля, такие как `type` и `timeout`, показываются, пока каждая команда, URL, `matcher` и условие `if` экспортируются как `"[REDACTED]"`1452 * Hooks следуют тем же правилам, поэтому поля с фиксированными опциями и числовые поля, такие как `type` и `timeout`, показываются, пока каждая команда, URL, `matcher` и условие `if` экспортируются как `"[REDACTED]"`

1410 1453

1411 Например, управляемые параметры с `apiKeyHelper`, двумя переменными `env` и правилом запрета экспортируются как `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}`.1454 Например, управляемые параметры с `apiKeyHelper`, двумя переменными `env` и правилом запрета экспортируются как `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}`.

1412 1455

1413 Claude Code обрезает значение на 8 КБ UTF-8, и обрезанное значение не является действительным JSON1456 Claude Code обрезает значение на 8 КБ UTF-8, и обрезанное значение не является действительным JSON

1414* `managed_settings.settings_truncated` (когда `managed_settings.settings` присутствует): `true`, когда Claude Code обрезал `managed_settings.settings` на 8 КБ, `false` в противном случае. Выпускается как логическое значение, не строка1457* `managed_settings.settings_truncated` (когда `managed_settings.settings` присутствует): `true`, когда Claude Code обрезал `managed_settings.settings` на 8 КБ, `false` в противном случае. Выпускается как логическое значение, а не строка

1415 1458

1416<h2 id="interpret-metrics-and-events-data">1459<h2 id="interpret-metrics-and-events-data">

1417 Интерпретация данных метрик и событий1460 Интерпретация данных метрик и событий

1499 1542

1500[Стандартные атрибуты](#standard-attributes) на каждом событии включают идентификацию аутентифицированного пользователя: `user.email`, `user.account_uuid`, `user.account_id` и `organization.id` при входе с учетной записью Claude или, в [облачном сеансе](/docs/ru/claude-code-on-the-web), когда учетные данные самого сеанса их содержат, плюс `user.id` и область сеанса `session.id`. `user.id` является идентификатором, ограниченным установкой, за исключением сеансов [Claude apps gateway](/docs/ru/claude-apps-gateway), где это субъект IdP из выданного шлюзом токена.1543[Стандартные атрибуты](#standard-attributes) на каждом событии включают идентификацию аутентифицированного пользователя: `user.email`, `user.account_uuid`, `user.account_id` и `organization.id` при входе с учетной записью Claude или, в [облачном сеансе](/docs/ru/claude-code-on-the-web), когда учетные данные самого сеанса их содержат, плюс `user.id` и область сеанса `session.id`. `user.id` является идентификатором, ограниченным установкой, за исключением сеансов [Claude apps gateway](/docs/ru/claude-apps-gateway), где это субъект IdP из выданного шлюзом токена.

1501 1544

1502Вызовы инструментов MCP, команды Bash и редактирование файлов поэтому приписываются разработчику, который запустил сеанс. Claude Code не действует под отдельной учетной записью сервиса; идентификация, записанная на каждом событии, это собственная учетная запись Claude разработчика или идентификация IdP разработчика в сеансе [Claude apps gateway](/docs/ru/claude-apps-gateway).1545В сеансе, который запускает разработчик, вызовы инструментов MCP, команды Bash и редактирование файлов поэтому приписываются этому разработчику. Claude Code не действует под отдельной учетной записью сервиса; идентификация, записанная на каждом событии, это собственная учетная запись Claude разработчика или идентификация IdP разработчика в сеансе [Claude apps gateway](/docs/ru/claude-apps-gateway). В сеансах канала Claude Tag, Claude работает как [общая идентификация](/docs/ru/cloud-environments#set-the-environment-a-claude-tag-channel-uses) вашей организации.

1503 1546

1504Когда Claude Code аутентифицируется с прямым ключом API или против Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, в сеансе нет учетной записи Claude и только `user.id` и `session.id` заполняются. В этих развертываниях прикрепите идентификацию пользователя самостоятельно с помощью `OTEL_RESOURCE_ATTRIBUTES`, установленного для каждого пользователя через файл [управляемых параметров](#administrator-configuration) или оболочку запуска. Сеансы Claude apps gateway не требуют ничего из этого: CLI автоматически проставляет идентификацию IdP, как описано в [Стандартные атрибуты](#standard-attributes).1547Когда Claude Code аутентифицируется с прямым ключом API или против Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, в сеансе нет учетной записи Claude и только `user.id` и `session.id` заполняются. В этих развертываниях прикрепите идентификацию пользователя самостоятельно с помощью `OTEL_RESOURCE_ATTRIBUTES`, установленного для каждого пользователя через файл [управляемых параметров](#administrator-configuration) или оболочку запуска. Сеансы Claude apps gateway не требуют ничего из этого: CLI автоматически проставляет идентификацию IdP, как описано в [Стандартные атрибуты](#standard-attributes).

1505 1548

1563}1606}

1564```1607```

1565 1608

1566Чтобы подтвердить, что события прибыли, отправьте подсказку в сеансе, работающем под этой конфигурацией, и проверьте ваш SIEM на событие `claude_code.user_prompt`. Если ничего не прибыло, запустите `claude --debug` и проверьте журнал отладки на ошибки экспорта `[3P telemetry]`.1609Чтобы подтвердить, что события прибыли, отправьте подсказку в сеансе, работающем под этой конфигурацией, и проверьте ваш SIEM на событие `claude_code.user_prompt`. Если ничего не прибыло, запустите Claude Code с `claude --debug-file <path>` и проверьте этот журнал на ошибки экспорта `[3P telemetry]`.

1567 1610

1568<h2 id="backend-considerations">1611<h2 id="backend-considerations">

1569 Рассмотрения бэкенда1612 Рассмотрения бэкенда

1633 * События `tool_result` и `tool_decision` включают атрибут `tool_parameters` с командами Bash, именами MCP сервера и инструмента и именами навыков. Поля, такие как `full_command`, выдаются неусеченными1676 * События `tool_result` и `tool_decision` включают атрибут `tool_parameters` с командами Bash, именами MCP сервера и инструмента и именами навыков. Поля, такие как `full_command`, выдаются неусеченными

1634 * События `tool_result` дополнительно включают атрибут `tool_input` с путями к файлам, URL-адресами, шаблонами поиска и другими аргументами. Отдельные значения более 512 символов усекаются, и общее количество ограничено примерно 4 K символами1677 * События `tool_result` дополнительно включают атрибут `tool_input` с путями к файлам, URL-адресами, шаблонами поиска и другими аргументами. Отдельные значения более 512 символов усекаются, и общее количество ограничено примерно 4 K символами

1635 * События `user_prompt` включают буквальное `command_name` для пользовательских, плагин и MCP команд1678 * События `user_prompt` включают буквальное `command_name` для пользовательских, плагин и MCP команд

1679 * [Счётчики стоимости и токенов](#cost-counter) и события `api_request`, `api_error` и `api_refusal` содержат реальные имена агента, навыка, плагина и MCP сервера и инструмента в их атрибутах атрибуции

1636 * Span трассировки включают тот же атрибут `tool_input` и атрибуты, полученные из входных данных, такие как `file_path`, с тем же усечением, что и `tool_input`1680 * Span трассировки включают тот же атрибут `tool_input` и атрибуты, полученные из входных данных, такие как `file_path`, с тем же усечением, что и `tool_input`

1637* Содержимое инструмента не логируется в span трассировок по умолчанию. Чтобы включить его, установите `OTEL_LOG_TOOL_CONTENT=1`. Span `claude_code.tool` затем содержит событие span [`tool.output`](#tool-output-span-event) с содержимым файлов в исходном виде и выходными данными команды Bash, усеченными на лимит содержимого (60 КБ по умолчанию) на атрибут. Содержимое инструмента также достигает span через [`new_context`, чей gate отличается для каждого span](#new-context-gates). Настройте ваш бэкенд телеметрии для фильтрации или редактирования этих атрибутов по мере необходимости1681* Содержимое инструмента не логируется в span трассировок по умолчанию. Чтобы включить его, установите `OTEL_LOG_TOOL_CONTENT=1`. Span `claude_code.tool` затем содержит событие span [`tool.output`](#tool-output-span-event) с содержимым файлов в исходном виде, выходными данными команды Bash и тем, что возвращают MCP инструменты, WebFetch и WebSearch, усеченными на лимит содержимого (60 КБ по умолчанию) на атрибут. Результаты от MCP инструментов, WebFetch и WebSearch требуют Claude Code v2.1.283 или позже. Содержимое инструмента также достигает span через [`new_context`, чей gate отличается для каждого span](#new-context-gates). Настройте ваш бэкенд телеметрии для фильтрации или редактирования этих атрибутов по мере необходимости

1638* Тела запроса и ответа Anthropic Messages API в исходном виде не логируются по умолчанию. Чтобы включить их, установите `OTEL_LOG_RAW_API_BODIES` в вашей оболочке, пользовательских параметрах или управляемых параметрах. Это игнорируется в [project and local settings](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). Тела содержат полную историю разговора, включая системную подсказку, каждый предыдущий ход пользователя и помощника, и результаты инструментов, поэтому включение этого подразумевает согласие со всем, что раскрыли бы другие флаги содержимого `OTEL_LOG_*`. Claude Code всегда скрывает содержимое расширенного мышления Claude из этих тел, независимо от других параметров. Значение, которое вы установите, определяет, как Claude Code доставляет тела:1682* Тела запроса и ответа Anthropic Messages API в исходном виде не логируются по умолчанию. Чтобы включить их, установите `OTEL_LOG_RAW_API_BODIES` в вашей оболочке, пользовательских параметрах или управляемых параметрах. Это игнорируется в [project and local settings](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). Тела содержат полную историю разговора, включая системную подсказку, каждый предыдущий ход пользователя и помощника, и результаты инструментов, поэтому включение этого подразумевает согласие со всем, что раскрыли бы другие флаги содержимого `OTEL_LOG_*`. Claude Code всегда скрывает содержимое расширенного мышления Claude из этих тел, независимо от других параметров. Значение, которое вы установите, определяет, как Claude Code доставляет тела:

1639 * С `=1`, Claude Code выдает события логов `api_request_body` и `api_response_body` для каждого вызова API. Атрибут `body` событий содержит JSON-сериализованную нагрузку, усеченную на лимит содержимого (60 КБ по умолчанию)1683 * С `=1`, Claude Code выдает события логов `api_request_body` и `api_response_body` для каждого вызова API. Атрибут `body` событий содержит JSON-сериализованную нагрузку, усеченную на лимит содержимого (60 КБ по умолчанию)

1640 * С `=file:<dir>`, Claude Code записывает неусеченные тела в файлы `.request.json` и `.response.json` в этом каталоге, и события содержат путь `body_ref` вместо встроенного тела. Отправьте каталог с коллектором логов или sidecar, а не через поток телеметрии.1684 * С `=file:<dir>`, Claude Code записывает неусеченные тела в файлы `.request.json` и `.response.json` в этом каталоге, и события содержат путь `body_ref` вместо встроенного тела. Отправьте каталог с коллектором логов или sidecar, а не через поток телеметрии.

overview.md +3 −1

Details

18 <Tab title="Terminal">18 <Tab title="Terminal">

19 Полнофункциональный CLI для работы с Claude Code прямо в вашем терминале. Редактируйте файлы, выполняйте команды и управляйте всем проектом из командной строки.19 Полнофункциональный CLI для работы с Claude Code прямо в вашем терминале. Редактируйте файлы, выполняйте команды и управляйте всем проектом из командной строки.

20 20

~~21 Для установки Claude Code используйте один из следующих методов:~~21 Для установки Claude Code откройте терминал и выполните команду для вашей системы. Если вы раньше не использовали терминал, [руководство по терминалу](/docs/ru/terminal-guide) показывает, как его открыть и вставить команду.

22 22

23 <Tabs>23 <Tabs>

24 <Tab title="Встроенная установка (рекомендуется)">24 <Tab title="Встроенная установка (рекомендуется)">

40 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd40 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

41 ```41 ```

42 42

43 Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](/docs/ru/troubleshoot-install#command-not-found-claude-after-installation).

43 Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell. Ваша подсказка показывает `PS C:\` когда вы находитесь в PowerShell и `C:\` без `PS` когда вы находитесь в CMD.45 Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell. Ваша подсказка показывает `PS C:\` когда вы находитесь в PowerShell и `C:\` без `PS` когда вы находитесь в CMD.

44 46

45 Если команда установки завершается с ошибкой `syntax error near unexpected token '<'`, `403` или другой ошибкой curl, см. [Устранение неполадок при установке](/docs/ru/troubleshoot-install#find-your-error) чтобы сопоставить ошибку с исправлением и для альтернативных методов установки.47 Если команда установки завершается с ошибкой `syntax error near unexpected token '<'`, `403` или другой ошибкой curl, см. [Устранение неполадок при установке](/docs/ru/troubleshoot-install#find-your-error) чтобы сопоставить ошибку с исправлением и для альтернативных методов установки.

permission-modes.md +150 −55

Details

8 8

9Режим разрешений определяет, какие действия Claude может выполнять в сеансе без предварительного запроса у вас. В режиме Manual Claude Code останавливается и просит вас перед большинством действий, которые редактируют файлы, запускают команды оболочки или обращаются в сеть. В [режиме auto](#eliminate-prompts-with-auto-mode) вторая модель, классификатор, проверяет действия вместо вас; [как классификатор оценивает действия](#how-the-classifier-evaluates-actions) перечисляет, какие действия он проверяет и какие его пропускают.9Режим разрешений определяет, какие действия Claude может выполнять в сеансе без предварительного запроса у вас. В режиме Manual Claude Code останавливается и просит вас перед большинством действий, которые редактируют файлы, запускают команды оболочки или обращаются в сеть. В [режиме auto](#eliminate-prompts-with-auto-mode) вторая модель, классификатор, проверяет действия вместо вас; [как классификатор оценивает действия](#how-the-classifier-evaluates-actions) перечисляет, какие действия он проверяет и какие его пропускают.

10 10

11На планах Pro, Max и Team встроенный начальный режим разрешений — это режим auto. [Какой режим начинается в сеансе](#which-mode-a-session-starts-in) охватывает интерфейсы и параметры, которые изменяют начальный режим разрешений. Вы также можете изменить режим разрешений работающего сеанса в любое время.11С Claude Code версии 2.1.283 или позже режим auto является встроенным начальным режимом разрешений для интерактивных сеансов терминала и VS Code. В более ранних версиях это встроенный начальный режим разрешений только на планах Pro, Max и Team. [Какой режим начинается в сеансе](#which-mode-a-session-starts-in) охватывает интерфейсы и параметры, которые изменяют начальный режим разрешений. Вы также можете изменить режим разрешений работающего сеанса в любое время.

12 12

13<h2 id="available-modes">13<h2 id="available-modes">

14 Available modes14 Available modes

58| Итерировать локально с меньшим количеством запросов, без классификатора | Режим Manual плюс песочница Bash в [режиме auto-allow](/docs/ru/sandboxing#sandbox-modes): `claude --permission-mode default`, затем запустите `/sandbox` и выберите auto-allow | Встроенная песочница Bash, на macOS, Linux и WSL2 | Правила отказа по-прежнему применяются, и правила запроса, которые называют команду, такие как `Bash(git push *)`, по-прежнему запрашивают. Чтобы включить песочницу из файла параметров вместо этого, установите [`sandbox.enabled`](/docs/ru/settings-reference#sandbox-enabled) на `true` |58| Итерировать локально с меньшим количеством запросов, без классификатора | Режим Manual плюс песочница Bash в [режиме auto-allow](/docs/ru/sandboxing#sandbox-modes): `claude --permission-mode default`, затем запустите `/sandbox` и выберите auto-allow | Встроенная песочница Bash, на macOS, Linux и WSL2 | Правила отказа по-прежнему применяются, и правила запроса, которые называют команду, такие как `Bash(git push *)`, по-прежнему запрашивают. Чтобы включить песочницу из файла параметров вместо этого, установите [`sandbox.enabled`](/docs/ru/settings-reference#sandbox-enabled) на `true` |

60| Работать в режиме auto без участия | `claude --permission-mode auto`, [встроенный начальный режим разрешений](#which-mode-a-session-starts-in) на Pro, Max и Team | Нет; песочница или контейнер добавляет защиту в глубину | Требует [поддерживаемую модель](#eliminate-prompts-with-auto-mode), и ваша организация может [отключить режим auto](#eliminate-prompts-with-auto-mode) |60| Работать в режиме auto без участия | `claude --permission-mode auto`, [встроенный начальный режим разрешений](#which-mode-a-session-starts-in) с v2.1.283 или позже | Нет; песочница или контейнер добавляет защиту в глубину | Требует [поддерживаемую модель](#eliminate-prompts-with-auto-mode), и ваша организация может [отключить режим auto](#eliminate-prompts-with-auto-mode) |

61| Запустить в CI с точным списком разрешений | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | Нет, кроме того, что предоставляет ваш CI runner | [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) игнорирует `dontAsk` из файлов параметров |61| Запустить в CI с точным списком разрешений | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | Нет, кроме того, что предоставляет ваш CI runner | [Облачные сеансы](/docs/ru/claude-code-on-the-web) игнорируют `dontAsk` из файлов параметров |

62| Запустить полностью автоматически внутри контейнера | `claude -p "<prompt>" --dangerously-skip-permissions` | Требуется: контейнер, виртуальная машина или [runtime песочницы](/docs/ru/sandbox-environments#sandbox-runtime); на Linux и macOS запустите его как [непривилегированный пользователь](#skip-all-checks-with-bypasspermissions-mode) | Claude Code в веб-версии игнорирует этот режим из файлов параметров. В этом запуске `-p` [несколько вызовов, которые по-прежнему запрашивают](#skip-all-checks-with-bypasspermissions-mode), отклоняются вместо этого |62| Запустить полностью автоматически внутри контейнера | `claude -p "<prompt>" --dangerously-skip-permissions` | Требуется: контейнер, виртуальная машина или [runtime песочницы](/docs/ru/sandbox-environments#sandbox-runtime); на Linux и macOS запустите его как [непривилегированный пользователь](#skip-all-checks-with-bypasspermissions-mode) | Облачные сеансы игнорируют этот режим из файлов параметров. В этом запуске `-p` [несколько вызовов, которые по-прежнему запрашивают](#skip-all-checks-with-bypasspermissions-mode), отклоняются вместо этого |

63 63

64Песочница Bash и режим auto работают независимо и объединяются, за исключением случаев, перечисленных в разделе [Режимы песочницы](/docs/ru/sandboxing#sandbox-modes). Для полного взаимодействия см. [Как песочница связана с разрешениями и режимами разрешений](/docs/ru/sandboxing#how-sandboxing-relates-to-permissions-and-permission-modes) и [Как изоляция связана с режимами разрешений](/docs/ru/sandbox-environments#how-isolation-relates-to-permission-modes).64Песочница Bash и режим auto работают независимо и объединяются, за исключением случаев, перечисленных в разделе [Режимы песочницы](/docs/ru/sandboxing#sandbox-modes). Для полного взаимодействия см. [Как песочница связана с разрешениями и режимами разрешений](/docs/ru/sandboxing#how-sandboxing-relates-to-permissions-and-permission-modes) и [Как изоляция связана с режимами разрешений](/docs/ru/sandbox-environments#how-isolation-relates-to-permission-modes).

65 65

81 81

82Встроенное значение по умолчанию `auto` требует Claude Code v2.1.228 или позже на macOS, Linux и WSL, и v2.1.233 или позже на нативной Windows. На более ранних версиях встроенное значение по умолчанию — Manual.82Встроенное значение по умолчанию `auto` требует Claude Code v2.1.228 или позже на macOS, Linux и WSL, и v2.1.233 или позже на нативной Windows. На более ранних версиях встроенное значение по умолчанию — Manual.

83 83

84Встроенное значение по умолчанию зависит от того, как вы запускаете Claude Code, от вашего плана и от того, может ли Claude Code получить свои флаги функций. Первая строка, которая соответствует вашему сеансу, применяется. Таблица охватывает сеансы, которые вы запускаете в терминале или через расширение VS Code; для настольного приложения и claude.ai см. вкладки Desktop и Web в [Переключение режимов разрешений](#switch-permission-modes).84Встроенное значение по умолчанию зависит от того, как вы запускаете Claude Code. Первая строка, которая соответствует вашему сеансу, применяется. Таблица охватывает сеансы, которые вы запускаете в терминале или через расширение VS Code; для настольного приложения и claude.ai см. вкладки Desktop и Web в [Переключение режимов разрешений](#switch-permission-modes).

85 85

86| Как вы запускаете Claude Code | Встроенный начальный режим разрешений |86| Как вы запускаете Claude Code | Встроенный начальный режим разрешений |

87| :- | :- |87| :- | :- |

88| Любой файл параметров устанавливает `disableAutoMode` на `"disable"` | `default` |88| Любой файл параметров устанавливает `disableAutoMode` на `"disable"` | `default` |

~~89| [Получение флагов функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching) отключено | `default` |~~

90| Ваш [первый сеанс после установки Claude Code или обновления](/docs/ru/env-vars#first-session-after-an-install-or-upgrade) до версии, которая добавляет это значение по умолчанию, если только после свежей установки Claude Code не получит флаги вовремя | `default` |

91| `claude -p` или [Agent SDK](/docs/ru/agent-sdk/permissions) | `default` |89| `claude -p` или [Agent SDK](/docs/ru/agent-sdk/permissions) | `default` |

92| Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) или сеанс подписанного [Claude apps gateway](/docs/ru/claude-apps-gateway) | `default` |90| В терминале или через [расширение VS Code](/docs/ru/vs-code) | `auto` с Claude Code v2.1.283 или позже; на более ранних версиях `auto` на планах Pro, Max или Team в сеансах, которые [получают флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), и `default` в противном случае |

~~93| План Pro, Max или Team, в терминале или через [расширение VS Code](/docs/ru/vs-code) | `auto` |~~

~~94| План Enterprise или ключ API Claude Console | `default` |~~

95 91

96Когда получение флагов функций отключено или в [первом сеансе после установки или обновления](/docs/ru/env-vars#first-session-after-an-install-or-upgrade), где флаги ещё не прибыли, расширение VS Code игнорирует каждый файл параметров при выборе начального режима разрешений.92В вашем [первом сеансе после установки или обновления](/docs/ru/env-vars#first-session-after-an-install-or-upgrade), Claude Code может выбрать начальный режим разрешений до того, как прибудут его флаги функций. Этот сеанс может начаться в другом режиме разрешений, чем указано в таблице, и ваш следующий сеанс соответствует таблице.

97 93

98Когда флаг, файл параметров или встроенное значение по умолчанию выбирает `auto`, но режим auto недоступен для сеанса, Claude Code запускает сеанс в режиме Manual вместо этого. Режим auto недоступен, когда сеанс не соответствует [требованиям доступности](#eliminate-prompts-with-auto-mode), таким как файл параметров, отключающий его, или модель, которая его не поддерживает, или когда Anthropic временно отключила его на стороне сервера.94Когда флаг, файл параметров или встроенное значение по умолчанию выбирает `auto`, но режим auto недоступен для сеанса, Claude Code запускает сеанс в режиме Manual вместо этого. Режим auto недоступен, когда сеанс не соответствует [требованиям доступности](#eliminate-prompts-with-auto-mode), таким как файл параметров, отключающий его, или модель, которая его не поддерживает, или когда Anthropic временно отключила его на стороне сервера.

99 95

177 173

178 1. `claudeCode.initialPermissionMode`174 1. `claudeCode.initialPermissionMode`

179 2. Режим, который вы последний раз выбрали из индикатора режима, если это был Manual, Edit automatically или Auto. Выбор Plan или Bypass permissions применяется только к этому разговору175 2. Режим, который вы последний раз выбрали из индикатора режима, если это был Manual, Edit automatically или Auto. Выбор Plan или Bypass permissions применяется только к этому разговору

180 3. `permissions.defaultMode` из [управляемых параметров](/docs/ru/managed-settings) или `~/.claude/settings.json`, на планах Pro, Max и Team с доступным [получением флагов функций](#which-mode-a-session-starts-in)176 3. `permissions.defaultMode` из [управляемых параметров](/docs/ru/managed-settings) или `~/.claude/settings.json`

181 4. [Встроенное значение по умолчанию](#which-mode-a-session-starts-in) для вашего плана, поставщика и параметров организации177 4. [Встроенное значение по умолчанию](#which-mode-a-session-starts-in) для вашего плана, поставщика и параметров организации

182 178

183 Расширение никогда не читает `.claude/settings.json` или `.claude/settings.local.json` проекта для начального режима разрешений, и в разговорах, которые не соответствуют условиям пункта 3, он вообще не читает файл параметров. Когда установлен `claudeCode.claudeProcessWrapper`, пункты 3 и 4 также не применяются: эти разговоры начинаются в режиме Manual, если пункт 1 или пункт 2 не устанавливает режим разрешений.179 Расширение никогда не читает `.claude/settings.json` или `.claude/settings.local.json` проекта для начального режима разрешений. Когда установлен `claudeCode.claudeProcessWrapper`, пункты 3 и 4 не применяются: эти разговоры начинаются в режиме Manual, если пункт 1 или пункт 2 не устанавливает режим разрешений.

180

181 До v2.1.283 пункт 3 применялся только на планах Pro, Max и Team в сеансах, которые [получают флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching).

184 182

185 Auto появляется в индикаторе режима, когда [режим auto доступен](#eliminate-prompts-with-auto-mode).183 Auto появляется в индикаторе режима, когда [режим auto доступен](#eliminate-prompts-with-auto-mode).

186 184

214 Используйте раскрывающееся меню режима рядом с полем подсказки на [claude.ai/code](https://claude.ai/code) или в мобильном приложении. Запросы разрешений появляются в claude.ai для одобрения. Какие режимы появляются, зависит от того, где выполняется сеанс:212 Используйте раскрывающееся меню режима рядом с полем подсказки на [claude.ai/code](https://claude.ai/code) или в мобильном приложении. Запросы разрешений появляются в claude.ai для одобрения. Какие режимы появляются, зависит от того, где выполняется сеанс:

215 213

216 * **[Облачные сеансы](/docs/ru/claude-code-on-the-web)**: Accept edits, Plan и Auto. Accept edits соответствует режиму `default`: облачные сеансы предварительно одобряют редактирование файлов независимо от режима, поэтому раскрывающееся меню показывает Accept edits вместо Manual. Облачные сеансы по-прежнему соблюдают `defaultMode: "acceptEdits"` из параметров. Auto mode появляется только когда ваша организация это разрешает и выбранная модель это поддерживает. Bypass permissions недоступен.214 * **[Облачные сеансы](/docs/ru/claude-code-on-the-web)**: Accept edits, Plan и Auto. Accept edits соответствует режиму `default`: облачные сеансы предварительно одобряют редактирование файлов независимо от режима, поэтому раскрывающееся меню показывает Accept edits вместо Manual. Облачные сеансы по-прежнему соблюдают `defaultMode: "acceptEdits"` из параметров. Auto mode появляется только когда ваша организация это разрешает и выбранная модель это поддерживает. Bypass permissions недоступен.

217 * **[Remote Control](/docs/ru/remote-control) сеансы** на вашем локальном компьютере: Manual, Accept edits и Plan. Вы не можете выбрать Auto или Bypass permissions из приложения.215 * **[Remote Control](/docs/ru/remote-control) сеансы** на вашем локальном компьютере: Manual, Accept edits и Plan для сеанса, который вы запустили сами, и вы не можете выбрать Auto или Bypass permissions из приложения. Для потока проекта, работающего на вашем компьютере, см. [Запустить поток на вашем собственном компьютере](/docs/ru/claude-projects#run-a-thread-on-your-own-computer).

218 * За исключением Bypass permissions, раскрывающееся меню показывает режим разрешений, в котором находится локальный сеанс, включая режим, установленный из терминала. Оно обновляется, когда режим разрешений изменяется в приложении или в терминале. Сеанс никогда не сообщает Bypass permissions в claude.ai, поэтому переключение на него из терминала не изменяет то, что показывает раскрывающееся меню.216 * За исключением Bypass permissions, раскрывающееся меню показывает режим разрешений, в котором находится локальный сеанс, включая режим, установленный из терминала. Оно обновляется, когда режим разрешений изменяется в приложении или в терминале.

219 * Сеансы, размещённые [настольным приложением](/docs/ru/desktop) или [расширением VS Code](/docs/ru/vs-code), сообщают изменения режима разрешений в claude.ai по мере их возникновения, так же как сеансы, размещённые в терминале.217 * Сеансы, размещённые [настольным приложением](/docs/ru/desktop) или [расширением VS Code](/docs/ru/vs-code), сообщают изменения режима разрешений в claude.ai по мере их возникновения, так же как сеансы, размещённые в терминале.

220 * До v2.1.202 сеансы, подключённые с помощью `/remote-control` или `claude --remote-control`, вообще не сообщали свой режим разрешений, поэтому claude.ai и мобильное приложение могли показывать режим разрешений, в котором сеанс не находился. Несоответствие влияло только на метку. Claude Code генерировал запросы разрешений из фактического режима разрешений сеанса, и они по-прежнему появлялись в приложении для одобрения.218 * До v2.1.202 сеансы, подключённые с помощью `/remote-control` или `claude --remote-control`, вообще не сообщали свой режим разрешений, поэтому claude.ai и мобильное приложение могли показывать режим разрешений, в котором сеанс не находился. Несоответствие влияло только на метку. Claude Code генерировал запросы разрешений из фактического режима разрешений сеанса, и они по-прежнему появлялись в приложении для одобрения.

221 219

233 231

234Режим `acceptEdits` позволяет Claude создавать и редактировать файлы в вашем рабочем каталоге без запроса. Строка состояния показывает `⏵⏵ accept edits on`, пока этот режим активен.232Режим `acceptEdits` позволяет Claude создавать и редактировать файлы в вашем рабочем каталоге без запроса. Строка состояния показывает `⏵⏵ accept edits on`, пока этот режим активен.

235 233

236В дополнение к редактированию файлов, режим `acceptEdits` автоматически одобряет распространённые команды Bash файловой системы: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` и `sed`. Эти команды также автоматически одобряются при префиксе с безопасными переменными окружения, такими как `LANG=C` или `NO_COLOR=1`, или обёртками процессов, такими как `timeout`, `nice` или `nohup`. Как и редактирование файлов, автоматическое одобрение применяется только к путям внутри вашего рабочего каталога или `additionalDirectories`. Пути вне этой области, записи в [защищённые пути](#protected-paths), удаления `rm` и `rmdir`, нацеленные на [критический путь](#critical-paths), и все остальные команды Bash, кроме [встроенного набора только для чтения](/docs/ru/permissions#read-only-commands), по-прежнему требуют запроса.234В дополнение к редактированию файлов, режим `acceptEdits` автоматически одобряет распространённые команды Bash файловой системы: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` и `sed`. Эти команды также автоматически одобряются при префиксе с безопасными переменными окружения, такими как `LANG=C` или `NO_COLOR=1`, или обёртками процессов, такими как `timeout`, `nice` или `nohup`. Как и редактирование файлов, автоматическое одобрение применяется только к путям внутри вашего рабочего каталога или `additionalDirectories`.

235

236Каждый путь также проходит через [проверку символических ссылок](/docs/ru/permissions#symlinks), поэтому запись, которая разрешается вне этой области, также не одобряется автоматически. Пути вне этой области, записи в [защищённые пути](#protected-paths), удаления `rm` и `rmdir`, нацеленные на [критический путь](#critical-paths), и все остальные команды Bash, кроме [встроенного набора только для чтения](/docs/ru/permissions#read-only-commands), по-прежнему требуют запроса.

237 237

238Когда инструмент [PowerShell](/docs/ru/tools-reference#powershell-tool) включен, режим `acceptEdits` также автоматически одобряет `Set-Content`, `Add-Content`, `Clear-Content` и `Remove-Item` на путях в области действия, вместе с их распространёнными псевдонимами. Применяются те же правила области действия и защищённых путей, и `Remove-Item` получает [свою собственную проверку](#remove-item-in-powershell). Позиционный аргумент, содержащий символ кавычки, такой как апостроф в `Set-Content .\notes.txt "It's done"`, по-прежнему требует запроса даже на путях в области действия, потому что Claude Code не может статически проверить аргумент, чьи цитируемые и нецитируемые прочтения отличаются. Передайте содержимое через именованный параметр, такой как `-Value`, чтобы избежать запроса.238Когда инструмент [PowerShell](/docs/ru/tools-reference#powershell-tool) включен, режим `acceptEdits` также автоматически одобряет `Set-Content`, `Add-Content`, `Clear-Content` и `Remove-Item` на путях в области действия, вместе с их распространёнными псевдонимами. Применяются те же правила области действия и защищённых путей, и `Remove-Item` получает [свою собственную проверку](#remove-item-in-powershell). Позиционный аргумент, содержащий символ кавычки, такой как апостроф в `Set-Content .\notes.txt "It's done"`, по-прежнему требует запроса даже на путях в области действия, потому что Claude Code не может статически проверить аргумент, чьи цитируемые и нецитируемые прочтения отличаются. Передайте содержимое через именованный параметр, такой как `-Value`, чтобы избежать запроса.

239 239

251 251

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

253 253

254Когда [режим auto](/docs/ru/auto-mode-config) доступен и параметр `useAutoModeDuringPlan` включен, что является значением по умолчанию, классификатор проверяет команды оболочки во время планирования вместо запроса у вас. Одобренные команды выполняются, и отклонённые блокируются. В противном случае команды вне [встроенного набора только для чтения](/docs/ru/permissions#read-only-commands) требуют одобрения, включая когда [режим auto-allow](/docs/ru/sandboxing#sandbox-modes) песочницы включен. В интерактивных сеансах терминала с доступными разрешениями на обход ни классификатор, ни запрос не применяются к командам планирования; [Пропустить все проверки с режимом bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) охватывает несколько вещей, которые по-прежнему требуют запроса там. В v2.1.212 через v2.1.217 сеансы без доступных разрешений на обход требовали запроса для каждой команды вне набора только для чтения, независимо от того, был ли доступен режим auto.254Что происходит с командой оболочки во время планирования, зависит от сеанса, и применяется первый из этих случаев, который совпадает:

255

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

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

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

255 259

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

257 261

289 293

290Автоматический режим позволяет Claude выполнять действия без обычных запросов разрешения. Отдельная модель классификатора проверяет действия перед их выполнением, блокируя все, что выходит за рамки вашего запроса, нацелено на неизвестную инфраструктуру или выглядит как результат враждебного контента, который прочитал Claude. Явные [правила запроса](/docs/ru/permissions#manage-permissions) по-прежнему вызывают запрос.294Автоматический режим позволяет Claude выполнять действия без обычных запросов разрешения. Отдельная модель классификатора проверяет действия перед их выполнением, блокируя все, что выходит за рамки вашего запроса, нацелено на неизвестную инфраструктуру или выглядит как результат враждебного контента, который прочитал Claude. Явные [правила запроса](/docs/ru/permissions#manage-permissions) по-прежнему вызывают запрос.

291 295

292На планах Pro, Max и Team автоматический режим является [встроенным начальным режимом разрешений](#which-mode-a-session-starts-in).296С Claude Code v2.1.283 или более поздней версии автоматический режим является [встроенным начальным режимом разрешений](#which-mode-a-session-starts-in) для интерактивных сеансов терминала и VS Code на каждом плане и поставщике. На более ранних версиях это встроенный начальный режим разрешений только на планах Pro, Max и Team.

293 297

294Классификатор также проверяет каждое сообщение, которое Claude отправляет другому агенту с помощью [`SendMessage`](/docs/ru/tools-reference), будь то простой текст или структурированное сообщение [команды агентов](/docs/ru/agent-teams), перед тем как Claude Code его доставит, как в автоматическом режиме, так и в [режиме плана, пока классификатор проверяет команды](#analyze-before-you-edit-with-plan-mode); проверка отправки требует Claude Code v2.1.222 или более поздней версии.298Классификатор также проверяет каждое сообщение, которое Claude отправляет другому агенту с помощью [`SendMessage`](/docs/ru/tools-reference), будь то простой текст или структурированное сообщение [команды агентов](/docs/ru/agent-teams), перед тем как Claude Code его доставит, как в автоматическом режиме, так и в [режиме плана, пока классификатор проверяет команды](#analyze-before-you-edit-with-plan-mode); проверка отправки требует Claude Code v2.1.222 или более поздней версии.

295 299

296Классификатор также проверяет и одобряет или блокирует удаления `rm` и `rmdir`, нацеленные на [критический путь](#critical-paths), такие как `rm -rf /` и `rm -rf ~`, включая случаи, когда удаление находится внутри подстановки команды или процесса.300По умолчанию классификатор не проверяет удаления `rm` и `rmdir`, нацеленные на критический путь, такие как `rm -rf /` или `rm -rf ~`. [Критические пути](#critical-paths) охватывает то, что с ними происходит в каждом режиме разрешений.

297 301

298Автоматический режим также побуждает Claude продолжать работу без остановки для уточняющих вопросов, хотя Claude по-прежнему спрашивает, когда ваш запрос или навык явно на этом основаны. Для более сильного автономного поведения в режиме, который по-прежнему вас спрашивает, установите [стиль вывода Proactive](/docs/ru/output-styles).302Автоматический режим также побуждает Claude продолжать работу без остановки для уточняющих вопросов, хотя Claude по-прежнему спрашивает, когда ваш запрос или навык явно на этом основаны. Для более сильного автономного поведения в режиме, который по-прежнему вас спрашивает, установите [стиль вывода Proactive](/docs/ru/output-styles).

299 303

305 309

306* **План**: Все планы.310* **План**: Все планы.

307* **Организация**: на Team и Enterprise автоматический режим доступен по умолчанию. Администраторы могут отключить его для организации, установив `permissions.disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings).311* **Организация**: на Team и Enterprise автоматический режим доступен по умолчанию. Администраторы могут отключить его для организации, установив `permissions.disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings).

308* **Модель**: на Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Claude Opus 4.6 или более поздней версии, Sonnet 4.6 или более поздней версии, или [модель Fable](/docs/ru/model-config#work-with-fable). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом, только Claude Sonnet 5, Opus 4.7 или более поздней версии и модели Fable. Более старые модели, включая Sonnet 4.5, Opus 4.5, Haiku и модели claude-3, не поддерживаются ни на одном поставщике.312* **Модель**: на Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Claude Opus 4.6 или более поздней версии, Sonnet 4.6 или более поздней версии, или [модель Fable](/docs/ru/model-config#work-with-fable). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом, только Claude Sonnet 5 или более поздней версии, Opus 4.7 или более поздней версии и модели Fable. Более старые модели, включая Sonnet 4.5, Opus 4.5, Haiku и модели claude-3, не поддерживаются ни на одном поставщике.

309* **Поставщик**: доступен по умолчанию на Anthropic API, Claude Platform on AWS, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансах Claude apps gateway с входом.313* **Поставщик**: доступен по умолчанию на Anthropic API, Claude Platform on AWS, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансах Claude apps gateway с входом.

310 314

311Если Claude Code сообщает, что автоматический режим недоступен, сначала проверьте эти требования и не устанавливает ли какой-либо файл параметров [`disableAutoMode`](/docs/ru/settings-reference#disableautomode). Anthropic также может отключить автоматический режим на стороне сервера, или сервер может отклонить автоматический режим для вашей учетной записи. Сеанс, получивший любой из этих ответов, держит автоматический режим отключенным до конца сеанса, поэтому позже начните новый сеанс.315Если Claude Code сообщает, что автоматический режим недоступен, сначала проверьте эти требования и не устанавливает ли какой-либо файл параметров [`disableAutoMode`](/docs/ru/settings-reference#disableautomode). Anthropic также может отключить автоматический режим на стороне сервера, или сервер может отклонить автоматический режим для вашей учетной записи. Сеанс, получивший любой из этих ответов, держит автоматический режим отключенным до конца сеанса, поэтому позже начните новый сеанс.

318 Автоматический режим на Bedrock, Agent Platform или Foundry322 Автоматический режим на Bedrock, Agent Platform или Foundry

319</h3>323</h3>

320 324

321На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) и сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом автоматический режим появляется в цикле `Shift+Tab` по умолчанию. Появление в цикле не изменяет режим разрешений, в котором начинается сеанс: на этих поставщиках сеансы терминала начинаются в вашем [`defaultMode`](/docs/ru/settings-reference#permissions-defaultmode), который является Manual, если вы его не измените, и разговоры в [расширении VS Code](/docs/ru/vs-code) начинаются в Manual, если `claudeCode.initialPermissionMode` или выбранный вами режим в расширении не устанавливает один. На этих поставщиках поддерживаются только Claude Sonnet 5, Opus 4.7 или более поздней версии и модели Fable.325На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) и сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом автоматический режим доступен по умолчанию. С Claude Code v2.1.283 или более поздней версии это также [встроенный начальный режим разрешений](#which-mode-a-session-starts-in) для интерактивных сеансов терминала и [VS Code](/docs/ru/vs-code). Чтобы выбрать начальный режим разрешений самостоятельно, установите `permissions.defaultMode` как [Начать в другом режиме разрешений](#start-in-a-different-mode) описывает, или выберите режим разрешений из индикатора режима расширения VS Code.

322 326

323Чтобы сделать автоматический режим режимом разрешений по умолчанию при запуске, установите `"permissions": {"defaultMode": "auto"}` в пользовательские или управляемые параметры. В сеансах, которые запускает расширение VS Code, вместо этого выберите **Auto** из индикатора режима. [Переключение режимов разрешений](#switch-permission-modes) охватывает то, что имеет приоритет над этим выбором.327На этих поставщиках поддерживаются только Claude Sonnet 5 или более поздней версии, Opus 4.7 или более поздней версии и модели Fable. На любой другой модели сеанс начинается в Manual вместо этого.

324 328

325Проверка [`/doctor`](/docs/ru/commands#all-commands) предлагает этот пользовательский параметр по умолчанию на этих поставщиках так же, как на Anthropic API.329Чтобы предотвратить использование автоматического режима разработчиками, установите `disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings). Это удаляет `auto` из цикла `Shift+Tab`, и сеанс, запущенный с `--permission-mode auto`, начинается в Manual вместо этого. Сеанс, уже работающий в автоматическом режиме, выходит из него, когда параметр достигает этого сеанса из [источника, развернутого администратором](/docs/ru/managed-settings#which-managed-source-claude-code-uses), и показывает `auto mode disabled by settings`. До v2.1.251 работающий сеанс оставался в автоматическом режиме до конца.

~~326~~

327Чтобы предотвратить использование автоматического режима разработчиками, установите `disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings). Это удаляет `auto` из цикла `Shift+Tab`, и сеанс, запущенный с `--permission-mode auto`, начинается в Manual. Сеанс, уже работающий в автоматическом режиме, выходит из него, когда параметр достигает этого сеанса из [источника, развернутого администратором](/docs/ru/managed-settings#which-managed-source-claude-code-uses), и показывает `auto mode disabled by settings`. До v2.1.251 работающий сеанс оставался в автоматическом режиме до конца.

328 330

329В v2.1.158 через v2.1.206 автоматический режим был отключен на этих поставщиках до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, и Claude Code игнорировал `defaultMode: "auto"` на этих поставщиках, если переменная также не была установлена. Переменная по-прежнему принимается для совместимости и не имеет эффекта с v2.1.207 и далее.331В v2.1.158 через v2.1.206 автоматический режим был отключен на этих поставщиках до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, и Claude Code игнорировал `defaultMode: "auto"` на этих поставщиках, если переменная также не была установлена. Переменная по-прежнему принимается для совместимости и не имеет эффекта с v2.1.207 и далее.

330 332

343* **Сервер не проверяет сеанс**: ответ завершается без результатов проверки, или сервер отвечает, что он не проверяет этот сеанс. Наиболее частые причины — это LLM gateway или proxy, который блокирует запрос на проверку или результаты, и платформа, регион или учетные данные, которые еще не имеют проверок на стороне сервера. Claude Code возвращается к собственным запросам классификатора. Как только этот откат сохраняется для остальной части сеанса, он показывает [уведомление о расходах на запросы классификатора](/docs/ru/auto-mode-classifier-billing) на учетных записях, где эти запросы выставляются счетом.345* **Сервер не проверяет сеанс**: ответ завершается без результатов проверки, или сервер отвечает, что он не проверяет этот сеанс. Наиболее частые причины — это LLM gateway или proxy, который блокирует запрос на проверку или результаты, и платформа, регион или учетные данные, которые еще не имеют проверок на стороне сервера. Claude Code возвращается к собственным запросам классификатора. Как только этот откат сохраняется для остальной части сеанса, он показывает [уведомление о расходах на запросы классификатора](/docs/ru/auto-mode-classifier-billing) на учетных записях, где эти запросы выставляются счетом.

344* **Сервер не дает вердикт для действия**: Claude Code отклоняет действие, а не выполняет его без проверки. На любом подключении это происходит, когда ответ заканчивается до прибытия результатов проверки или результаты прибывают в форме, которую Claude Code не может прочитать. LLM gateway или proxy, который сокращает ответы или переписывает результаты, может вызвать любое из них. На прямом подключении к Anthropic API это также происходит, когда проверка сервера не удается для действия, например истечение времени ожидания. [Сервер не вернул вердикт безопасности](/docs/ru/errors#the-server-returned-no-safety-verdict) охватывает сообщение об отказе, что происходит, когда отказы повторяются, и что делать.346* **Сервер не дает вердикт для действия**: Claude Code отклоняет действие, а не выполняет его без проверки. На любом подключении это происходит, когда ответ заканчивается до прибытия результатов проверки или результаты прибывают в форме, которую Claude Code не может прочитать. LLM gateway или proxy, который сокращает ответы или переписывает результаты, может вызвать любое из них. На прямом подключении к Anthropic API это также происходит, когда проверка сервера не удается для действия, например истечение времени ожидания. [Сервер не вернул вердикт безопасности](/docs/ru/errors#the-server-returned-no-safety-verdict) охватывает сообщение об отказе, что происходит, когда отказы повторяются, и что делать.

345 347

346Чтобы пропустить запрос к серверу и всегда использовать собственные запросы классификатора Claude Code, установите [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ru/env-vars). На прямом подключении к Anthropic API переменная требует Claude Code v2.1.281 или более поздней версии. Установка ее на `1` там включает проверку сервера в сеансе, который еще ее не имеет, такой как сеанс `-p` или Agent SDK, если вы также не установили `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`. Если вы установили `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` и оставили `CLAUDE_CODE_AUTO_MODE_SERVER` неустановленным, Claude Code также перестает запрашивать сервер.348Чтобы пропустить запрос к серверу и всегда использовать собственные запросы классификатора Claude Code, установите [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ru/env-vars). На прямом подключении к Anthropic API переменная требует Claude Code v2.1.281 или более поздней версии. Установка ее на `1` там включает проверку сервера в сеансе, который еще ее не имеет, такой как сеанс `-p` или Agent SDK, если вы также не установили `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`. Если вы установили `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` и оставили `CLAUDE_CODE_AUTO_MODE_SERVER` неустановленным, Claude Code также перестает запрашивать сервер, кроме как [Отключение предварительных возможностей](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) описывает.

347 349

348<h3 id="what-the-classifier-blocks-by-default">350<h3 id="what-the-classifier-blocks-by-default">

349 Что классификатор блокирует по умолчанию351 Что классификатор блокирует по умолчанию

407Claude Code v2.1.205 и более поздние версии также блокируют эти по умолчанию:409Claude Code v2.1.205 и более поздние версии также блокируют эти по умолчанию:

408 410

409* Запись в стенограммы сеансов Claude Code, файлы истории `.jsonl` в `~/.claude/projects/` или вашем настроенном каталоге конфигурации, прямо или через команду оболочки. Правило также охватывает строки метаданных, которые Claude Code добавляет к каждой записи стенограммы для своих собственных проверок. Чтение стенограммы не блокируется411* Запись в стенограммы сеансов Claude Code, файлы истории `.jsonl` в `~/.claude/projects/` или вашем настроенном каталоге конфигурации, прямо или через команду оболочки. Правило также охватывает строки метаданных, которые Claude Code добавляет к каждой записи стенограммы для своих собственных проверок. Чтение стенограммы не блокируется

410* Рекурсивное принудительное удаление, такое как `rm -rf "$VAR"` или `Remove-Item -Recurse -Force $dir`, цель которого является переменной оболочки или glob, укорененным в одной, которая не назначена где-либо в разговоре, который видит классификатор. Значение пришло только из более раннего вывода команды, который классификатор никогда не получает, поэтому классификатор не может проверить цель удаления по другим правилам удаления. Блок очищается, когда вы называете точный удаляемый путь, или когда Claude повторно запускает удаление с разрешенным буквальным путем, написанным в команду. Удаления, цель которых классификатор может разрешить, не затронуты. Цели `Remove-Item`, которые являются голым `*` или заканчиваются на `/*` или `\*`, никогда не достигают классификатора: Claude Code [отклоняет их сразу](#remove-item-in-powershell)412* Рекурсивное принудительное удаление, такое как `rm -rf "$VAR"` или `Remove-Item -Recurse -Force $dir`, цель которого является переменной оболочки, которая не назначена где-либо в разговоре, который видит классификатор, или glob, укорененным в такой переменной. Значение пришло только из более раннего вывода команды, который классификатор никогда не получает, поэтому классификатор не может проверить цель удаления по другим правилам удаления. Блок очищается, когда вы называете точный удаляемый путь, или когда Claude повторно запускает удаление с разрешенным буквальным путем, написанным в команду. Удаления, цель которых классификатор может разрешить, не затронуты.

413

414 Glob непосредственно под переменной, как в `rm -rf "$VAR"/*`, является [критическим путем](#critical-paths) вместо этого. Цели `Remove-Item`, которые являются голым `*` или заканчиваются на `/*` или `\*`, никогда не достигают классификатора: Claude Code [отклоняет их сразу](#remove-item-in-powershell).

411 415

412Claude Code v2.1.257 и более поздние версии также блокируют эти по умолчанию:416Claude Code v2.1.257 и более поздние версии также блокируют эти по умолчанию:

413 417

457* **Продолжить разрешение**: чтение выполняется, более поздние чтения вне рабочих каталогов выполняются как раньше, и Claude Code записывает ваш ответ, чтобы запрос больше не появлялся461* **Продолжить разрешение**: чтение выполняется, более поздние чтения вне рабочих каталогов выполняются как раньше, и Claude Code записывает ваш ответ, чтобы запрос больше не появлялся

458* **Блокировать с этого момента**: чтение отклоняется, и Claude Code устанавливает [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) на `true` в ваши пользовательские параметры, что заставляет инструменты файлов отклонять такие чтения в каждом более позднем сеансе и каждом режиме разрешений. Чтобы позволить Claude позже прочитать такой путь, добавьте его каталог с `/add-dir` или удалите параметр.462* **Блокировать с этого момента**: чтение отклоняется, и Claude Code устанавливает [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) на `true` в ваши пользовательские параметры, что заставляет инструменты файлов отклонять такие чтения в каждом более позднем сеансе и каждом режиме разрешений. Чтобы позволить Claude позже прочитать такой путь, добавьте его каталог с `/add-dir` или удалите параметр.

459* **Спросить снова в следующий раз**: чтение отклоняется, и следующее чтение вне рабочих каталогов снова спрашивает463* **Спросить снова в следующий раз**: чтение отклоняется, и следующее чтение вне рабочих каталогов снова спрашивает

464* **Да, но спросить снова в следующий раз**: чтение выполняется, ничего не сохраняется, и следующее чтение вне рабочих каталогов снова спрашивает

460 465

461<h3 id="boundaries-you-state-in-conversation">466<h3 id="boundaries-you-state-in-conversation">

462 Границы, которые вы указываете в разговоре467 Границы, которые вы указываете в разговоре

482 487

483Когда автоматический режим не может одобрить действия вашего сеанса, что происходит, зависит от случая:488Когда автоматический режим не может одобрить действия вашего сеанса, что происходит, зависит от случая:

484 489

485* **Заблокированное действие**: Claude Code показывает уведомление и перечисляет действие в `/permissions` на вкладке **Recently denied**, где вы можете нажать `r` для повторной попытки с ручным одобрением. Когда классификатор выдает [отсутствие вердикта по действию](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action), потому что проверка безопасности, отдельная от автоматического режима, отклонила собственный запрос классификатора или его ответ не был разобран, Claude Code отклоняет действие без уведомления или записи **Recently denied**.490* **Заблокированное действие**: Claude Code показывает уведомление и перечисляет действие в `/permissions` на вкладке **Recently denied**, где вы можете нажать `r` для повторной попытки с ручным одобрением.

486* **Повторные блоки**: если классификатор блокирует действие 3 раза подряд или 20 раз всего, автоматический режим приостанавливается и Claude Code возобновляет запросы. Одобрение запрошенного действия возобновляет автоматический режим. Эти пороги не настраиваются. Любое разрешенное действие сбрасывает счетчик последовательных, пока счетчик всего сохраняется для сеанса и сбрасывается только когда его собственный предел запускает откат. Claude Code не считает отказ к любому пороговому значению, когда [проверка безопасности, отдельная от автоматического режима, отклоняет собственный запрос классификатора](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action); связанная запись охватывает, как Claude Code обрабатывает эти отказы.491* **Повторные блоки**: если классификатор блокирует действие 3 раза подряд или 20 раз всего, автоматический режим приостанавливается и Claude Code возобновляет запросы. Одобрение запрошенного действия возобновляет автоматический режим. Смотрите [Пороги повторных блоков](#repeated-block-thresholds) для того, как блоки считаются.

487* **Сеансы, которые не могут спрашивать**: [неинтерактивный](/docs/ru/headless) запуск `-p` без [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) не имеет запроса для возврата. Когда повторные блоки достигают порога, действие не выполняется и Claude продолжает работать. То же самое применяется, когда [проверка безопасности, отдельная от автоматического режима, отклоняет запрос классификатора](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action). Claude Code не останавливает запуск ни в одном случае.492* **Нет вердикта от классификатора**: когда проверка безопасности, отдельная от автоматического режима, отклоняет собственный запрос классификатора, или ответ классификатора не разбирается, Claude Code отклоняет действие без уведомления или записи **Recently denied**. Смотрите [Auto mode cannot determine the safety of an action](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action) для сообщения каждого случая и что делать.

488* **Нет вердикта от сервера**: под [проверкой классификатора на стороне сервера](#server-side-classifier-review), Claude Code отклоняет действие, для которого сервер не дает вердикт, и останавливает ход после десяти ответов подряд без вердикта. Смотрите [Сервер не вернул вердикт безопасности](/docs/ru/errors#the-server-returned-no-safety-verdict).493* **Нет вердикта от сервера**: под [проверкой классификатора на стороне сервера](#server-side-classifier-review), Claude Code отклоняет действие, для которого сервер не дает вердикт, и останавливает ход после десяти ответов подряд без вердикта. Смотрите [Сервер не вернул вердикт безопасности](/docs/ru/errors#the-server-returned-no-safety-verdict).

489* **Переключение режима во время проверки**: если вы переключаете режимы разрешений, пока проверка классификатора ожидает, Claude Code отклоняет вердикт, который новый режим не запросил бы, вместо его применения: вместо этого вас спрашивают для одобрения, или действие автоматически отклоняется в [`dontAsk` режиме](#allow-only-pre-approved-tools-with-dontask-mode).494* **Переключение режима во время проверки**: если вы переключаете режимы разрешений, пока проверка классификатора ожидает, Claude Code отклоняет вердикт, который новый режим не запросил бы. Вместо этого вас спрашивают для одобрения, или действие автоматически отклоняется в [`dontAsk` режиме](#allow-only-pre-approved-tools-with-dontask-mode).

495

496<h4 id="repeated-block-thresholds">

497 Пороги повторных блоков

498</h4>

499

500Пороги 3 блоков подряд и 20 блоков всего не настраиваются. Счетчик всего сохраняется для сеанса и сбрасывается только когда его собственный предел запускает откат. Claude Code не считает отказ к любому пороговому значению, когда проверка безопасности, отдельная от автоматического режима, отклоняет собственный запрос классификатора.

501

502[Неинтерактивный](/docs/ru/headless) запуск `-p` без [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) не имеет запроса для возврата. Когда повторные блоки достигают порога, действие не выполняется и Claude продолжает работать. Claude Code не останавливает запуск.

490 503

491Повторные блоки обычно означают, что классификатор упускает контекст о вашей инфраструктуре. Используйте `/feedback` для сообщения о ложных срабатываниях, или пусть администратор [настроит доверенную инфраструктуру](/docs/ru/auto-mode-config).504Повторные блоки обычно означают, что классификатор упускает контекст о вашей инфраструктуре. Используйте `/feedback` для сообщения о ложных срабатываниях, или пусть администратор [настроит доверенную инфраструктуру](/docs/ru/auto-mode-config).

492 505

506<h3 id="how-auto-mode-evaluates-actions">

507 Как автоматический режим оценивает действия

508</h3>

509

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

511

493<span id="how-the-classifier-evaluates-actions" />512<span id="how-the-classifier-evaluates-actions" />

494 513

495<AccordionGroup>514<AccordionGroup>

497 Каждое действие проходит через фиксированный порядок решений. Первый соответствующий шаг побеждает:516 Каждое действие проходит через фиксированный порядок решений. Первый соответствующий шаг побеждает:

498 517

499 1. Действия, соответствующие вашим [правилам разрешения, запроса или отказа](/docs/ru/permissions#manage-permissions), разрешаются немедленно, с этими исключениями:518 1. Действия, соответствующие вашим [правилам разрешения, запроса или отказа](/docs/ru/permissions#manage-permissions), разрешаются немедленно, с этими исключениями:

500 * Записи в [защищенные пути](#protected-paths) маршрутизируются к классификатору, даже когда правило разрешения соответствует, и так же `rm` и `rmdir` удаления, нацеленные на [критический путь](#critical-paths) в Claude Code v2.1.218 и более поздних версиях519 * Записи в [защищенные пути](#protected-paths) маршрутизируются к классификатору, даже когда правило разрешения соответствует

501 * MCP инструменты, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), спрашивают вас напрямую, даже когда правило разрешения соответствует, и так же инструменты connector, которые ваша организация установила на `ask`]\(/ru/mcp#organization-controls-on-connector-tools) в сеансах, где эта параметр достигает Claude Code520 * Нет правила разрешения, которое одобряет удаления `rm` и `rmdir`, нацеленные на [критический путь](#critical-paths)

521 * MCP инструменты, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), спрашивают вас напрямую, даже когда правило разрешения соответствует, и так же инструменты connector, которые ваша организация установила на `ask`]\(/ru/mcp#organization-controls-on-connector-tools) в сеансах, где этот параметр достигает Claude Code

502 * Команда оболочки, которая несет [разрешенные домены для каждой команды](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode), также маршрутизируется к классификатору, даже когда правило разрешения соответствует, потому что правило одобряет команду, а не ее хосты522 * Команда оболочки, которая несет [разрешенные домены для каждой команды](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode), также маршрутизируется к классификатору, даже когда правило разрешения соответствует, потому что правило одобряет команду, а не ее хосты

503 * Правила запроса, которые соответствуют содержимому команды, такие как `Bash(git push *)`, возвращаются к запросу разрешения523 * Правила запроса, которые соответствуют содержимому команды, такие как `Bash(git push *)`, возвращаются к запросу разрешения

524 * Запись, которую [проверка symlink](/docs/ru/permissions#symlinks) разрешает на защищенный путь, спрашивает вас, когда путь, который запросил Claude, сам не защищен

504 2. Действия только для чтения и редактирование файлов в вашем рабочем каталоге автоматически одобряются, кроме записей в [защищенные пути](#protected-paths) и [первое чтение вне рабочих каталогов](#first-read-outside-the-working-directories), которое вас спрашивает525 2. Действия только для чтения и редактирование файлов в вашем рабочем каталоге автоматически одобряются, кроме записей в [защищенные пути](#protected-paths) и [первое чтение вне рабочих каталогов](#first-read-outside-the-working-directories), которое вас спрашивает

505 * В сеансе с [проверкой классификатора на стороне сервера](#server-side-classifier-review), действия только для чтения и [команды оболочки в песочнице](/docs/ru/sandboxing#sandbox-modes) ждут эту проверку и блокируются, если она их отмечает526 * В сеансе с [проверкой классификатора на стороне сервера](#server-side-classifier-review), действия только для чтения и [команды оболочки в песочнице](/docs/ru/sandboxing#sandbox-modes) ждут эту проверку и блокируются, если она их отмечает

506 3. Все остальное идет к классификатору. Инструменты connector и MCP инструменты `requiresUserInteraction`, которые спрашивают вас напрямую на шаге 1, никогда не достигают классификатора, поэтому ни одобрение, требуемое организацией, ни шаг согласия не автоматически одобряются527 * Запись внутри вашего рабочего каталога, которую [проверка symlink](/docs/ru/permissions#symlinks) разрешает на местоположение вне него, спрашивает вас

528 3. Все остальное идет к классификатору, кроме [удаления критических путей](#critical-paths) при их обработке по умолчанию. Инструменты connector и `requiresUserInteraction` MCP инструменты, которые спрашивают вас напрямую на шаге 1, никогда не достигают классификатора, поэтому ни одобрение, требуемое организацией, ни шаг согласия не автоматически одобряются

507 4. Если классификатор блокирует, Claude получает причину и пытается альтернативу. В большинстве сеансов причина называет правило, которое классификатор совпал, такое как `[Data Exfiltration]`, вместо того чтобы давать письменное объяснение; смотрите [Проверка отказов](/docs/ru/auto-mode-config#review-denials)529 4. Если классификатор блокирует, Claude получает причину и пытается альтернативу. В большинстве сеансов причина называет правило, которое классификатор совпал, такое как `[Data Exfiltration]`, вместо того чтобы давать письменное объяснение; смотрите [Проверка отказов](/docs/ru/auto-mode-config#review-denials)

508 530

509 При входе в автоматический режим широкие правила разрешения, которые предоставляют произвольное выполнение кода, отбрасываются:531 При входе в автоматический режим широкие правила разрешения, которые предоставляют произвольное выполнение кода, отбрасываются:

568 590

569Режим `bypassPermissions` отключает запросы разрешений и проверки безопасности, чтобы вызовы инструментов выполнялись немедленно, включая записи в [защищённые пути](#protected-paths).591Режим `bypassPermissions` отключает запросы разрешений и проверки безопасности, чтобы вызовы инструментов выполнялись немедленно, включая записи в [защищённые пути](#protected-paths).

570 592

571[Действия, которые ни один режим не одобряет](#actions-no-mode-auto-approves) по-прежнему требуют запроса в этом режиме.593[Действия, которые ни один режим не одобряет](#actions-no-mode-auto-approves) по-прежнему требуют запроса в этом режиме. [Удаление Remove-Item в PowerShell](#remove-item-in-powershell) также применяется в этом режиме.

572 594

573Две [гарантии обмена сообщениями между сеансами](/docs/ru/cross-session-messaging) по-прежнему применяются в этом режиме, и в интерактивных сеансах режима plan, где доступны разрешения на обход:595Две [гарантии обмена сообщениями между сеансами](/docs/ru/cross-session-messaging) по-прежнему применяются в этом режиме, и в интерактивных сеансах режима plan, где доступны разрешения на обход:

574 596

593 615

594Claude Code отклоняет `bypassPermissions` в сеансе, который вы запускаете с [`--restricted`](/docs/ru/cli-reference#cli-flags). `--restricted` требует Claude Code v2.1.248 или позже.616Claude Code отклоняет `bypassPermissions` в сеансе, который вы запускаете с [`--restricted`](/docs/ru/cli-reference#cli-flags). `--restricted` требует Claude Code v2.1.248 или позже.

595 617

596В первый раз, когда вы запускаете интерактивный сеанс с этим режимом включённым, Claude Code показывает диалоговое окно предупреждения, просящее вас принять ответственность за действия, предпринятые без проверок разрешений. Claude Code сохраняет ваше принятие в пользовательские параметры, поэтому диалоговое окно появляется только один раз. Если вы отклоните, Claude Code выходит. В [неинтерактивном режиме](/docs/ru/headless) диалоговое окно не показывается, и [фоновый сеанс](/docs/ru/agent-view), запущенный с `--bg`, отклоняется до тех пор, пока вы не приняли диалоговое окно в интерактивном сеансе.618В первый раз, когда вы запускаете интерактивный сеанс с этим режимом включённым, Claude Code показывает диалоговое окно предупреждения, просящее вас принять ответственность за действия, предпринятые без проверок разрешений:

619

620* **Если вы согласитесь**: Claude Code устанавливает `skipDangerousModePermissionPrompt` на `true` в `~/.claude/settings.json`, поэтому более поздние сеансы пропускают диалоговое окно. Чтобы увидеть диалоговое окно снова, удалите ключ из этого файла или установите его на `false`. [Справка `skipDangerousModePermissionPrompt`](/docs/ru/settings-reference#skipdangerousmodepermissionprompt) перечисляет другие файлы параметров, где вы или ваша организация можете установить его.

621* **Если вы отклоните**: Claude Code выходит.

622

623В [неинтерактивном режиме](/docs/ru/headless) диалоговое окно не показывается, и [фоновый сеанс](/docs/ru/agent-view), запущенный с `--bg`, отклоняется до тех пор, пока вы не приняли диалоговое окно в интерактивном сеансе.

597 624

598На Linux и macOS Claude Code отклоняет запуск в этом режиме при запуске от пользователя root или под `sudo`:625На Linux и macOS Claude Code отклоняет запуск в этом режиме при запуске от пользователя root или под `sudo`:

599 626

603 630

604Проверка пропускается автоматически внутри признанной песочницы. Чтобы запустить автономно в контейнере, используйте конфигурацию [dev container](/docs/ru/devcontainer), которая запускает Claude Code от непривилегированного пользователя.631Проверка пропускается автоматически внутри признанной песочницы. Чтобы запустить автономно в контейнере, используйте конфигурацию [dev container](/docs/ru/devcontainer), которая запускает Claude Code от непривилегированного пользователя.

605 632

606[Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) не учитывает `defaultMode: "bypassPermissions"` или `"dontAsk"` из ваших файлов параметров, поэтому проверенные в репозитории параметры не могут запустить облачный сеанс в режиме bypass-permissions. Параметр игнорируется молча, и сеанс запускается в режиме разрешений, показанном в селекторе режима вместо этого. См. [Переключение режимов разрешений](#switch-permission-modes) для информации о том, какие режимы предлагают облачные сеансы.633[Облачные сеансы](/docs/ru/claude-code-on-the-web) не учитывают `defaultMode: "bypassPermissions"` или `"dontAsk"` из ваших файлов параметров, поэтому проверенные в репозитории параметры не могут запустить облачный сеанс в режиме bypass-permissions. Параметр игнорируется молча, и сеанс запускается в режиме разрешений, показанном в селекторе режима вместо этого. См. [Переключение режимов разрешений](#switch-permission-modes) для информации о том, какие режимы предлагают облачные сеансы.

607 634

608<Warning>635<Warning>

609 `bypassPermissions` не обеспечивает защиту от инъекции подсказок или непредвиденных действий. Для фоновых проверок безопасности с гораздо меньшим количеством запросов разрешений используйте [режим auto](#eliminate-prompts-with-auto-mode) вместо этого. Администраторы могут заблокировать этот режим, установив `permissions.disableBypassPermissionsMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings).636 `bypassPermissions` не обеспечивает защиту от инъекции подсказок или непредвиденных действий. Для фоновых проверок безопасности с гораздо меньшим количеством запросов разрешений используйте [режим auto](#eliminate-prompts-with-auto-mode) вместо этого. Администраторы могут заблокировать этот режим, установив `permissions.disableBypassPermissionsMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings).

625 652

626В сеансе, запущенном с [`--restricted`](/docs/ru/cli-reference#cli-flags), который требует Claude Code v2.1.248 или позже, классификатор не может одобрить записи в защищённые пути.653В сеансе, запущенном с [`--restricted`](/docs/ru/cli-reference#cli-flags), который требует Claude Code v2.1.248 или позже, классификатор не может одобрить записи в защищённые пути.

627 654

628Правила [`permissions.allow`](/docs/ru/permissions#manage-permissions) в файлах параметров не предварительно одобряют записи в защищённые пути. Проверка безопасности выполняется до того, как Claude Code оценивает правила allow из параметров, поэтому запись вроде `Edit(.claude/**)` в `~/.claude/settings.json` или `.claude/settings.json` не изменяет результат для каждого режима в таблице выше. В режимах, которые требуют подтверждения, запрос для записи `.claude/` предлагает **Да, и разрешить Claude редактировать свои собственные параметры для этого сеанса**, что одобряет более поздние записи `.claude/` в этом сеансе без повторного запроса.655В режимах, которые маршрутизируют записи в защищённые пути классификатору, запись, которую [проверка символических ссылок](/docs/ru/permissions#symlinks) разрешает в защищённый путь, требует вашего подтверждения вместо этого, когда путь, который запросил Claude, сам по себе не защищён.

656

657Правила [`permissions.allow`](/docs/ru/permissions#manage-permissions) в файлах параметров не предварительно одобряют записи в защищённые пути. Проверка безопасности выполняется до того, как Claude Code оценивает правила allow из параметров, поэтому запись вроде `Edit(.claude/**)` в `~/.claude/settings.json` или `.claude/settings.json` не изменяет результат для каждого режима в таблице выше. В режимах, которые требуют подтверждения, запрос для записи в папку `.claude/` проекта или в `~/.claude/` может предложить один из этих вариантов, ограниченных сеансом:

658

659* Для папки `.claude/` проекта: **Да, и разрешить Claude редактировать файлы в папке .claude этого проекта для этого сеанса**

660* Для `~/.claude/`: **Да, и разрешить Claude редактировать файлы в своей папке \~/.claude для этого сеанса**

629 661

630Защищённые каталоги:662Защищённые каталоги:

631 663

656 Критические пути688 Критические пути

657</h2>689</h2>

658 690

691Критические пути — это каталоги, которые Claude Code защищает от команд `rm` и `rmdir`, такие как корневой каталог файловой системы, ваш домашний каталог и ваш рабочий каталог.

692

659Claude Code никогда не позволяет правилу [`permissions.allow`](/docs/ru/permissions#manage-permissions) или hook [`PreToolUse`](/docs/ru/permissions#extend-permissions-with-hooks), который возвращает `"allow"`, одобрить команду `rm` или `rmdir`, которая нацелена на критический путь, даже в режимах, которые пропускают другие запросы. Этот автоматический выключатель защищает от ошибки модели. Совпадающее правило deny по-прежнему полностью блокирует команду.693Claude Code никогда не позволяет правилу [`permissions.allow`](/docs/ru/permissions#manage-permissions) или hook [`PreToolUse`](/docs/ru/permissions#extend-permissions-with-hooks), который возвращает `"allow"`, одобрить команду `rm` или `rmdir`, которая нацелена на критический путь, даже в режимах, которые пропускают другие запросы. Этот автоматический выключатель защищает от ошибки модели. Совпадающее правило deny по-прежнему полностью блокирует команду.

660 694

661Что происходит вместо этого, зависит от вашего режима разрешений:695Что происходит вместо этого, [зависит от вашего режима разрешений](#critical-path-removals-in-each-permission-mode). `Remove-Item` и встроенные команды `cmd` для удаления имеют свои собственные проверки, описанные в [Remove-Item в PowerShell](#remove-item-in-powershell).

662 696

663| Режим | Что Claude Code делает с удалением критического пути |697<h3 id="which-paths-are-critical">

664| :- | :- |698 Какие пути являются критическими

665| `default`, `acceptEdits` | Спрашивает вас одобрить его |699</h3>

666| `plan` | Спрашивает вас одобрить его. С [доступным режимом auto во время планирования](#analyze-before-you-edit-with-plan-mode) и без доступных разрешений на обход, отправляет его классификатору вместо этого |

667| `auto` | Отправляет его [классификатору](#eliminate-prompts-with-auto-mode) |

668| `dontAsk` | Отклоняет его |

669| `bypassPermissions` | Спрашивает вас одобрить его |

~~670~~

671Если явное [правило ask](/docs/ru/permissions#manage-permissions) совпадает с командой, Claude Code спрашивает вас даже в режиме `auto`. В режимах, которые спрашивают, hook [`PermissionRequest`](/docs/ru/hooks#permissionrequest) может ответить на запрос так же, как он отвечает на любой другой.

672 700

673Claude Code рассматривает цель `rm` или `rmdir` как критический путь, когда это любое из следующего:701Claude Code рассматривает цель `rm` или `rmdir` как критический путь, когда это любое из следующего:

674 702

679* Ваш рабочий каталог и его родители707* Ваш рабочий каталог и его родители

680* Ваши дополнительные рабочие каталоги и их родители, но только когда удаление — это glob под одним из них, такой как `rm -rf <dir>/*`. `rm -rf <dir>` на самом каталоге не вызывает эту проверку708* Ваши дополнительные рабочие каталоги и их родители, но только когда удаление — это glob под одним из них, такой как `rm -rf <dir>/*`. `rm -rf <dir>` на самом каталоге не вызывает эту проверку

681 709

682Claude Code также рассматривает glob или косую черту непосредственно под переменной оболочки, такую как `rm -rf "$DIR"/*`, как удаление критического пути, потому что команда становится удалением из корня файловой системы, когда переменная пуста.710<h3 id="other-targets-that-count-as-critical-paths">

711 Другие цели, которые считаются критическими путями

712</h3>

713

714Claude Code также рассматривает следующие цели `rm` и `rmdir` как критические пути. Последний столбец объясняет, почему каждая из них считается критической.

683 715

684Подсказка для этого случая переменной называет помеченную команду `rm` и говорит, как переписать её, чтобы проверка прошла:716| Цель | Пример | Почему это считается критическим |

717| :- | :- | :- |

718| Glob или косая черта непосредственно под переменной оболочки | `rm -rf "$DIR"/*` | Команда становится удалением из корня файловой системы, когда переменная пуста |

719| Та же форма под позиционным параметром, таким как `$1` или `$@`, когда ничто в команде не присваивает ему значение | `rm -rf "$1"/*` | Команда расширяется в удаление из корня |

720| Переменная оболочки, за которой следует одно общее имя каталога верхнего уровня, такое как `mnt`, `tmp`, `usr` или `Users` | `rm -rf "$TMPDIR/mnt"` | Когда переменная расширяется пусто, команда удаляет `/mnt` |

721| Переменная, которую та же команда присваивает из подстановки, выводящей каталог, такой как `$(pwd)` или `$(git rev-parse --show-toplevel)` | `D=$(pwd); rm -rf "$D"` | Значение может называть ваш рабочий каталог или корень репозитория |

722| Цель, которая является только выводом подстановки команды, когда `rm` рекурсивна | `rm -rf "$(pwd)"` | Claude Code не может проверить цель перед запуском команды |

723| Завершающая подстановка команды после критического пути | `rm -rf ~/$(cmd)` | Claude Code проверяет путь, который остался бы, если бы подстановка расширилась пусто, здесь ваш домашний каталог |

724| Цель, которая состоит только из обратных косых черт | `rm -rf "\\"` | Git Bash на Windows читает одну обратную косую черту как корень текущего диска, поэтому проверка применяется на каждой платформе |

725

726Чтобы отключить проверку на цели, которая является только выводом подстановки команды, установите [`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1`](/docs/ru/env-vars#variables) в окружении, которое запускает Claude Code.

727

728<h3 id="removals-inside-nested-commands-and-inline-scripts">

729 Удаления внутри вложенных команд и встроенных скриптов

730</h3>

731

732Claude Code также смотрит внутри этих конструкций:

733

734* **Вложенные команды**: подоболочка с `(...)`, группа в фигурных скобках с `{ ...; }`, подстановка команд с `$(...)` или обратные кавычки, или подстановка процесса с `<(...)`. Claude Code находит удаление критического пути, находится ли оно внутри вложенной формы, как в `(rm -rf ~)` или `echo "$(rm -rf ~)"`, или в другом месте той же команды.

735* **Встроенные скрипты**: Claude Code проверяет скрипт, переданный оболочке, такой как `sh -c` или `bash -c`, на предмет переменных оболочки и позиционных параметров [целей](#other-targets-that-count-as-critical-paths).

736 * Когда скрипт заключён в двойные кавычки, вызывающая оболочка расширяет его переменные перед тем, как внутренняя оболочка получит скрипт. В `find . -name '*.tmp' -exec sh -c "rm -rf \"$1\"/*" _ {} \;` команда расширяется в удаление из корня файловой системы один раз для каждого совпадения, и Claude Code рассматривает это как удаление критического пути.

737 * Скрипт в одинарных кавычках, который привязывает `$1` к реальному значению, как `sh -c 'rm -rf "$1"/*' _ {}`, не помечается.

738

739<h3 id="rewrite-a-flagged-command">

740 Переписать помеченную команду

741</h3>

685 742

686* Для переменной, такой как `$DIR`, защитите каждое расширение так, чтобы оболочка остановилась с ошибкой, когда переменная не установлена или пуста, как в `rm -rf "${DIR:?}"/*`, или используйте буквальный путь743Как переписать команду, чтобы она прошла проверку, зависит от того, какие из [других целей](#other-targets-that-count-as-critical-paths) она использует:

687* Для переменной, которая обычно установлена, такой как `$HOME`, используйте буквальный путь

688 744

689Удаление, чьи расширения защищены таким образом, не является удалением критического пути, поэтому в режиме `bypassPermissions` оно выполняется без подсказки.745* **Glob или косая черта под переменной, такой как `$DIR`**: защитите каждое расширение так, чтобы оболочка остановилась с ошибкой, когда переменная не установлена или пуста, как в `rm -rf "${DIR:?}"/*`, или используйте буквальный путь. Удаление, чьи расширения защищены таким образом, проходит эту проверку, поэтому в режиме `bypassPermissions` оно выполняется без запроса, если другая [критическая-путь](#critical-paths) проверка не помечает его.

746* **Glob или косая черта под переменной, которая обычно установлена, такой как `$HOME`**: используйте буквальный путь.

747* **Переменная, присвоенная из подстановки, выводящей каталог**: используйте буквальный путь. Защита `"${D:?}"` не очищает эту проверку, потому что переменная не пуста.

748* **Цель, которая является только выводом подстановки команды**: запустите подстановку самостоятельно сначала, а затем удалите буквальные пути, которые она выводит. Запрос говорит Claude сделать то же самое.

690 749

691Скрытие удаления внутри подстановки с `(...)`, группы в фигурных скобках с `{ ...; }`, подстановки команд с `$(...)` или обратными кавычками, или подстановки процесса с `<(...)`, не пропускает проверку. Claude Code находит удаление критического пути, находится ли оно внутри вложенной формы, как в `(rm -rf ~)` или `echo "$(rm -rf ~)"`, или в другом месте той же команды.750Для glob или косой черты под переменной запрос называет помеченную команду `rm` и говорит, как переписать её, чтобы проверка прошла.

751

752<h3 id="critical-path-removals-in-each-permission-mode">

753 Удаления критических путей в каждом режиме разрешений

754</h3>

755

756Что Claude Code делает с удалением критического пути, зависит от вашего режима разрешений:

757

758| Режим | Результат |

759| :- | :- |

760| `default`, `acceptEdits` | Спрашивает вас одобрить его |

761| `plan` | Спрашивает вас одобрить его. Когда [классификатор проверяет команды во время планирования](#analyze-before-you-edit-with-plan-mode) и нет доступных разрешений на обход, обрабатывает это как в режиме `auto` |

762| `auto` | Спрашивает вас одобрить это в терминале с [ограничением по времени](#time-limits-and-denials-in-auto-and-bypasspermissions-modes). В других местах отклоняет это |

763| `dontAsk` | Отклоняет его |

764| `bypassPermissions` | Спрашивает вас одобрить это с ограничением по времени в терминале |

765

766Если явное [правило ask](/docs/ru/permissions#manage-permissions) совпадает с командой, Claude Code спрашивает вас вместо этого, даже в режиме `auto` и без ограничения по времени. В режимах, которые спрашивают, hook [`PermissionRequest`](/docs/ru/hooks#permissionrequest) может ответить на запрос.

767

768<h3 id="time-limits-and-denials-in-auto-and-bypasspermissions-modes">

769 Ограничения по времени и отклонения в режимах auto и bypassPermissions

770</h3>

771

772В режимах `auto` и `bypassPermissions` запрос в терминале для удаления критического пути показывает обратный отсчёт в две минуты:

773

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

775* Нажмите любую клавишу, пока запрос открыт, чтобы остановить обратный отсчёт и оставить запрос в ожидании вашего ответа.

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

777

778В режиме `auto`, везде, где Claude Code не может показать вам запрос в терминале, он немедленно отклоняет команду, например в [неинтерактивных запусках](/docs/ru/headless) с `-p`, в сеансах [Agent SDK](/docs/ru/agent-sdk/permissions) и в панели чата расширения VS Code и приложении Desktop. Отклонение говорит Claude сообщить, что он хотел удалить, и оставить удаление вам.

779

780Обработка `auto` и `bypassPermissions` требует Claude Code v2.1.281 или позже. Чтобы отключить это, установите [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1`](/docs/ru/env-vars#variables) в окружении, которое запускает Claude Code. В режиме `auto` удаления критических путей затем переходят к классификатору, а в режиме `bypassPermissions` запрос не имеет ограничения по времени.

692 781

693<h3 id="remove-item-in-powershell">782<h3 id="remove-item-in-powershell">

694 Remove-Item в PowerShell783 Remove-Item в PowerShell

695</h3>784</h3>

696 785

697Когда вы включаете инструмент [PowerShell](/docs/ru/tools-reference#powershell-tool), Claude Code даёт `Remove-Item` свою собственную проверку, отдельную от списка критических путей `rm`. Результат зависит от цели, и первый совпадающий случай применяется:786Когда вы включаете инструмент [PowerShell](/docs/ru/tools-reference#powershell-tool), Claude Code даёт `Remove-Item` и встроенные команды `cmd` `rd`, `rmdir`, `del` и `erase` свои собственные проверки, отдельные от списка критических путей `rm`. Для `Remove-Item` результат зависит от цели, и первый совпадающий случай применяется:

698 787

699* **Системные пути**: корневой каталог файловой системы и его каталоги верхнего уровня, корни дисков и их каталоги верхнего уровня, и ваш домашний каталог. Claude Code отклоняет команду в каждом режиме, без запроса у вас.788* **Системные пути**: корневой каталог файловой системы и его каталоги верхнего уровня, корни дисков и их каталоги верхнего уровня, и ваш домашний каталог. Claude Code отклоняет команду в каждом режиме, без запроса у вас.

700* **Подстановочные знаки**: голый `*` или любая цель, заканчивающаяся на `/*` или `\*`, включая glob под переменной оболочки, такой как `$dir/*`. Claude Code отклоняет команду в каждом режиме, без запроса у вас, перед тем как [классификатор](#eliminate-prompts-with-auto-mode) её видит.789* **Подстановочные знаки**: голый `*` или любая цель, заканчивающаяся на `/*` или `\*`, включая glob под переменной оболочки, такой как `$dir/*`. Claude Code отклоняет команду в каждом режиме, без запроса у вас, перед тем как [классификатор](#eliminate-prompts-with-auto-mode) её видит.

701* **Ваш рабочий каталог или один из его родителей, с `-Recurse`**: Claude Code рассматривает команду как любую другую, которая требует одобрения в вашем режиме разрешений, поэтому он спрашивает вас в режимах, которые спрашивают, отправляет её классификатору в режиме `auto` и отклоняет её в режиме `dontAsk`. Режим `bypassPermissions` пропускает эту проверку.790* **Ваш рабочий каталог или один из его родителей, с `-Recurse`**: Claude Code рассматривает команду как любую другую, которая требует одобрения в вашем режиме разрешений, поэтому он спрашивает вас в режимах, которые спрашивают, отправляет её классификатору в режиме `auto` и отклоняет её в режиме `dontAsk`. Режим `bypassPermissions` пропускает эту проверку.

702 791

792Случай системных путей также применяется к `rd`, `rmdir`, `del` и `erase`, когда Claude запускает их через `cmd`, как в `cmd /c rd /s /q C:\Users`. По умолчанию Claude Code отклоняет такую команду в каждом режиме, без запроса у вас. Эта проверка `cmd` требует Claude Code v2.1.283 или позже.

793

794При оценке цели `cmd` Claude Code рассматривает переменную PowerShell, которая следует за буквальным текстом, как пустую. Это делает `cmd /c rd /s /q "C:\$name"` удалением `C:\`, поэтому она также отклоняется. Завершающий подстановочный знак считается папкой, которую он очищает, поэтому `cmd /c del /q C:\*` отклоняется, а `cmd /c del /q dist\*` в вашем проекте — нет.

795

796Чтобы отключить проверку `cmd`, установите [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY=1`](/docs/ru/env-vars#variables) в окружении, которое запускает Claude Code. Claude Code игнорирует эту переменную в блоке `env` файла параметров. `Remove-Item` на системном пути остаётся отклонённым в любом случае.

797

703<h2 id="see-also">798<h2 id="see-also">

704 См. также799 См. также

705</h2>800</h2>

permissions.md +139 −110

Details

228 Bash228 Bash

229</h3>229</h3>

230 230

231Правила разрешений Bash совпадают с полным текстом команды, где `*` обозначает любой текст. [Шаблоны подстановочных символов](#wildcard-patterns) показывает, какие команды совпадают с каждой формой правила и где размещать `*`. Остальная часть этого раздела охватывает, как Claude Code совпадает с составными командами и оборачивателями, что правило не совпадает, команды только для чтения и перенаправления.231Правила Bash соответствуют всему тексту команды, где `*` обозначает любой текст. [Шаблоны подстановки](#wildcard-patterns) показывает, какие команды соответствуют каждой форме правила и где размещать `*`. Остальная часть этого раздела охватывает то, как Claude Code сопоставляет составные команды и обёртки, что правило не соответствует, команды только для чтения и перенаправления.

232 232

233<h4 id="compound-commands">233<h4 id="compound-commands">

234 Составные команды234 Составные команды

235</h4>235</h4>

236 236

237<Tip>237<Tip>

238 Claude Code осведомлен об операторах оболочки, поэтому правило, такое как `Bash(safe-cmd *)`, не даст ему разрешение на выполнение команды `safe-cmd && other-cmd`. Распознаваемые разделители команд - это `&&`, `||`, `;`, `|`, `|&`, `&` и новые строки. Правило должно совпадать с каждой подкомандой независимо.238 Claude Code осведомлён об операторах оболочки, поэтому правило вроде `Bash(safe-cmd *)` не даст ему разрешение на выполнение команды `safe-cmd && other-cmd`. Распознаваемые разделители команд — это `&&`, `||`, `;`, `|`, `|&`, `&` и новые строки. Правило должно соответствовать каждой подкоманде независимо.

239</Tip>239</Tip>

240 240

241Правила deny и ask применяются, когда любая подкоманда совпадает с ними, включая команду, вложенную в подоболочку, подстановку команды или тело управления потоком, такое как цикл `for`. Правило ask, такое как `Bash(git clean *)`, по-прежнему запрашивает вас для `cd /tmp && git clean -f` или `echo "$(git clean -f)"`, даже в [режиме auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode).241Правила отказа и запроса применяются, когда любая подкоманда им соответствует, включая команду, вложенную в подоболочку, подстановку команды или тело управления потоком, такое как цикл `for`. Правило запроса вроде `Bash(git clean *)` по-прежнему запрашивает вас для `cd /tmp && git clean -f` или `echo "$(git clean -f)"`, даже в [автоматическом режиме](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode).

242 242

243Когда `&&` или `||` не имеет ничего после него, например в `npm test &&`, Claude Code рассматривает команду как неразбираемую и не разделяет её на подкоманды для сопоставления правил allow, поэтому правило, такое как `Bash(npm *)`, не одобряет её.243Когда после `&&` или `||` ничего нет, например в `npm test &&`, Claude Code рассматривает команду как неразбираемую и не разбивает её на подкоманды для сопоставления правил разрешения, поэтому правило вроде `Bash(npm *)` не одобряет её.

244 244

245Когда вы одобряете составную команду с "Да, не спрашивать снова", Claude Code сохраняет отдельное правило для каждой подкоманды, требующей одобрения, а не одно правило для полной составной строки. Например, одобрение `git status && npm test` сохраняет правило для `npm test`, поэтому будущие вызовы `npm test` распознаются независимо от того, что предшествует `&&`. Подкоманды, такие как `cd` в подкаталог, генерируют свое собственное правило Read для этого пути. Для одной составной команды может быть сохранено до 5 правил.245Когда вы одобряете составную команду с помощью «Да, и больше не спрашивать», Claude Code сохраняет отдельное правило для каждой подкоманды, требующей одобрения, а не одно правило для полной строки составной команды. Например, одобрение `git status && npm test` сохраняет правило для `npm test`, поэтому будущие вызовы `npm test` распознаются независимо от того, что предшествует `&&`. Подкоманды вроде `cd` в каталог вне ваших рабочих каталогов генерируют собственное правило Read для этого пути. Для одной составной команды может быть сохранено до 5 правил.

246 246

247<h4 id="process-wrappers">247<h4 id="process-wrappers">

248 Оборачиватели248 Обёртки

249</h4>249</h4>

250 250

251Перед сопоставлением правил Bash, Claude Code удаляет фиксированный набор оборачивателей, поэтому правило, такое как `Bash(npm test *)`, также совпадает с `timeout 30 npm test`. Удаляемые оборачиватели - это `timeout`, `time`, `nice`, `nohup` и `stdbuf`, плюс встроенные команды оболочки `command` и `builtin`, а также `noglob` в zsh. Каждый запускает свой аргумент как фактическую команду. Две связанные формы не удаляются: форма запроса `command -v`, которая ищет команду, а не запускает её, и `nocorrect` в zsh.251Перед сопоставлением правил Bash, Claude Code удаляет фиксированный набор обёрток, поэтому правило вроде `Bash(npm test *)` также соответствует `timeout 30 npm test`. Удаляемые обёртки — это `timeout`, `time`, `nice`, `nohup` и `stdbuf`, плюс встроенные команды оболочки `command` и `builtin`, а также `noglob` в zsh. Каждая запускает свой аргумент как фактическую команду. Две связанные формы не удаляются: форма запроса `command -v`, которая ищет команду, а не запускает её, и `nocorrect` в zsh.

252 252

253Claude Code также удаляет ведущее присваивание определённых известных безопасных переменных окружения, поэтому `Bash(npm test *)` совпадает с `NODE_ENV=test npm test`. Правило allow не совпадает с присваиванием любой другой переменной. Правило deny или ask совпадает с любым ведущим присваиванием, поэтому `Bash(rm *)` в deny по-прежнему совпадает с `FOO=bar rm -rf tmp/`.253Claude Code также удаляет начальное присваивание определённых известных безопасных переменных окружения, поэтому `Bash(npm test *)` соответствует `NODE_ENV=test npm test`. Правило разрешения не будет соответствовать после присваивания любой другой переменной. Правило отказа или запроса соответствует после любого начального присваивания, поэтому `Bash(rm *)` в отказе по-прежнему соответствует `FOO=bar rm -rf tmp/`.

254 254

255Голый `xargs` также удаляется, поэтому `Bash(grep *)` совпадает с `xargs grep pattern`. Удаление применяется только когда `xargs` не имеет флагов: вызов, такой как `xargs -n1 grep pattern`, совпадает как команда `xargs`, поэтому правила, написанные для внутренней команды, не охватывают его.255Голый `xargs` также удаляется, поэтому `Bash(grep *)` соответствует `xargs grep pattern`. Удаление применяется только когда `xargs` не имеет флагов: вызов вроде `xargs -n1 grep pattern` сопоставляется как команда `xargs`, поэтому правила, написанные для внутренней команды, его не охватывают.

256 256

257Этот список оборачивателей встроен и не настраивается. Средства выполнения окружения разработки, такие как `direnv exec`, `devbox run`, `mise exec`, `npx` и `docker exec`, не входят в список. Потому что эти инструменты выполняют свои аргументы как команду, правило, такое как `Bash(devbox run *)`, совпадает с чем угодно после `run`, включая `devbox run rm -rf .`. Чтобы одобрить работу внутри средства выполнения окружения, напишите конкретное правило, которое включает как средство выполнения, так и внутреннюю команду, такое как `Bash(devbox run npm test)`. Добавьте одно правило для каждой внутренней команды, которую вы хотите разрешить.257Этот список обёрток встроен и не настраивается. Средства запуска среды разработки, такие как `direnv exec`, `devbox run`, `mise exec`, `npx` и `docker exec`, не входят в список. Поскольку эти инструменты выполняют свои аргументы как команду, правило вроде `Bash(devbox run *)` соответствует всему, что идёт после `run`, включая `devbox run rm -rf .`. Чтобы одобрить работу внутри средства запуска среды, напишите конкретное правило, которое включает как средство запуска, так и внутреннюю команду, например `Bash(devbox run npm test)`. Добавьте одно правило для каждой внутренней команды, которую вы хотите разрешить.

258 258

259Оборачиватели exec, такие как `watch`, `setsid`, `ionice` и `flock`, не могут быть автоматически одобрены правилом префикса, таким как `Bash(watch *)`, поэтому в режиме Manual они всегда запрашивают. То же самое применяется к `find` с `-exec` или `-delete`: правило `Bash(find *)` не охватывает эти формы. Чтобы одобрить конкретный вызов, напишите правило точного совпадения для полной строки команды.259Обёртки exec, такие как `watch`, `setsid`, `ionice` и `flock`, не могут быть автоматически одобрены правилом префикса вроде `Bash(watch *)`, поэтому в ручном режиме они всегда запрашивают. То же самое применяется к `find` с `-exec` или `-delete`: правило `Bash(find *)` не охватывает эти формы. Чтобы одобрить конкретный вызов, напишите правило точного совпадения для полной строки команды.

260 260

261<h4 id="bash-rule-limits">261<h4 id="bash-rule-limits">

262 Что правило Bash не совпадает262 Что правило Bash не соответствует

263</h4>263</h4>

264 264

265Правило Bash совпадает с текстом команды, который пишет Claude, после того как Claude Code разделит [составные команды](#compound-commands) и удалит [оборачиватели](#process-wrappers). Оно не совпадает с одной и той же программой, вызванной в другой форме, поэтому правило deny или ask охватывает вызов, который Claude обычно производит, и не является границей безопасности вокруг программы. Эти правила в `deny` или `ask` останавливают первую форму, а не другие:265Правило Bash соответствует тексту команды, который пишет Claude, после того как Claude Code разбивает [составные команды](#compound-commands) и удаляет [обёртки](#process-wrappers). Оно не соответствует одной и той же программе, вызванной в другой форме, поэтому правило отказа или запроса охватывает вызов, который Claude обычно производит, и не является границей безопасности вокруг программы. Эти правила в `deny` или `ask` останавливают первую форму, но не другие:

266 266

268| :- | :- | :- |268| :- | :- | :- |

272 272

273Ваши другие правила и режим разрешений определяют команды в последнем столбце.273Ваши другие правила и режим разрешений определяют команды в последнем столбце.

274 274

275Для принудительного применения файловой системы и сети, которое не зависит от текста команды, используйте [sandboxing](/docs/ru/sandboxing). Чтобы проверить полный текст команды с вашей собственной логикой перед её выполнением, используйте [hook PreToolUse](#extend-permissions-with-hooks).275Для принудительного применения файловой системы и сети, которое не зависит от текста команды, используйте [изоляцию в песочнице](/docs/ru/sandboxing). Чтобы проверить полный текст команды с вашей собственной логикой перед её выполнением, используйте [hook PreToolUse](#extend-permissions-with-hooks).

276 276

277<h4 id="read-only-commands">277<h4 id="read-only-commands">

278 Команды только для чтения278 Команды только для чтения

279</h4>279</h4>

280 280

281Claude Code распознает встроенный набор команд Bash как только для чтения и запускает их без запроса разрешения в каждом режиме, за исключением пути, который [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) ограничивает. Набор включает `ls`, `cat`, `echo`, `pwd`, `head`, `tail`, `grep`, `find`, `wc`, `which`, `diff`, `stat`, `du`, `cd` и формы `git` только для чтения. Набор не настраивается; чтобы требовать запрос для одной из этих команд, добавьте правило `ask` или `deny` для неё.281Claude Code распознаёт встроенный набор команд Bash как команды только для чтения и выполняет их без запроса разрешения в каждом режиме, за исключением пути, который [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) ограничивает. Набор включает `ls`, `cat`, `echo`, `pwd`, `head`, `tail`, `grep`, `find`, `wc`, `which`, `diff`, `stat`, `du`, `cd` и формы `git` только для чтения. Набор не настраивается; чтобы требовать запрос для одной из этих команд, добавьте правило `ask` или `deny` для неё. В автоматическом режиме эти команды также могут ждать проверки классификатора; см. [как классификатор оценивает действия](/docs/ru/permission-modes#how-the-classifier-evaluates-actions).

282 282

283Перенаправление, такое как `ls > out.txt`, добавляет проверку на цель. См. [Перенаправления](#redirections).283Перенаправление вроде `ls > out.txt` добавляет проверку на цель. См. [Перенаправления](#redirections).

284 284

285Неквотированные glob-шаблоны разрешены для команд, у которых каждый флаг только для чтения, поэтому `ls *.ts` и `wc -l src/*.py` запускаются без запроса.285Неэкранированные шаблоны glob разрешены для команд, у которых каждый флаг только для чтения, поэтому `ls *.ts` и `wc -l src/*.py` выполняются без запроса.

286 286

287В режиме Manual команды из этого набора по-прежнему запрашивают в этих случаях:287В ручном режиме команды из этого набора по-прежнему запрашивают в этих случаях:

288 288

289* **Неквотированные глобы для команд с флагами, способными к записи**: команды с флагами, способными к записи или выполнению, такие как `find`, `sort`, `sed` и `git`, запрашивают, когда присутствует неквотированный глоб, потому что глоб может расширяться до флага, такого как `-delete`.289* **Неэкранированные глобы для команд с флагами, способными к записи**: команды с флагами, способными к записи или выполнению, такие как `find`, `sort`, `sed` и `git`, запрашивают при наличии неэкранированного глоба, потому что глоб может расширяться до флага вроде `-delete`.

290* **`docker`, указывающий на другой демон**: формы `docker` только для чтения запрашивают, когда команда содержит флаг, который выбирает другой демон, такой как `-H`, `--context` или `--url` и `--connection` в Podman.290* **`docker` указывающий на другой демон**: формы `docker` только для чтения запрашивают, когда команда содержит флаг, который выбирает другой демон, такой как `-H`, `--context` или `--url` и `--connection` в Podman.

291* **`file` с флагами открытия пути**: `file` запрашивает, когда он передаёт `-m`/`--magic-file` или `-f`/`--files-from`, потому что эти флаги заставляют `file` открывать пути, названные в значении флага.291* **`file` с флагами открытия пути**: `file` запрашивает, когда он передаёт `-m`/`--magic-file` или `-f`/`--files-from`, потому что эти флаги заставляют `file` открывать пути, названные в значении флага.

292* **Сетевые пути в Windows**: команда, чьи аргументы включают сетевой путь (UNC), такой как `\\server\share\file`, запрашивает, потому что доступ к сетевому пути может отправить ваши учётные данные Windows на хост, который он называет. Та же проверка применяется к командам [инструмента PowerShell](/docs/ru/tools-reference#powershell-tool).292* **Сетевые пути в Windows**: команда, аргументы которой включают сетевой путь (UNC), такой как `\\server\share\file`, запрашивает, потому что доступ к сетевому пути может отправить ваши учётные данные Windows хосту, который он называет. Та же проверка применяется к командам [инструмента PowerShell](/docs/ru/tools-reference#powershell-tool).

293* **Команды, которые анализ не может разобрать**: когда Claude Code не может полностью разобрать команду, он запрашивает одобрение вместо того, чтобы рассматривать команду как только для чтения. Команды длиннее 10 000 символов всегда запрашивают, потому что они превышают то, что анализирует анализ.293* **Команды, которые анализ не может разобрать**: когда Claude Code не может полностью разобрать команду, он запрашивает одобрение вместо того, чтобы рассматривать команду как только для чтения. Команды длиннее 10 000 символов всегда запрашивают, потому что они превышают то, что анализ разбирает.

294 294

295`cd` в путь внутри вашего рабочего каталога или [дополнительного каталога](#working-directories) также только для чтения, и составная команда, такая как `cd packages/api && ls`, запускается без запроса, когда каждая часть квалифицируется самостоятельно. Эти комбинации запрашивают, даже когда каждая часть только для чтения:295`cd` в путь внутри вашего рабочего каталога или [дополнительного каталога](#working-directories) также только для чтения, и составная команда вроде `cd packages/api && ls` выполняется без запроса, когда каждая часть квалифицируется самостоятельно. Эти комбинации запрашивают даже когда каждая часть только для чтения:

296 296

297* **`cd` с `git`**: запрашивает, когда `cd` переходит в другой каталог, так как запуск `git` в новом каталоге может выполнить hooks этого каталога. `cd`, целевой путь которого разрешается в текущий рабочий каталог, является no-op и не вызывает запрос.297* **`cd` с `git`**: запрашивает, когда `cd` переходит в другой каталог, поскольку запуск `git` в новом каталоге может выполнить hooks этого каталога. `cd`, чья цель разрешается в текущий рабочий каталог, является холостым ходом и не вызывает запрос.

298* **`cd` с перенаправлением**: запрашивает, когда Claude Code не может определить, в какой каталог разрешается целевой путь перенаправления после выполнения `cd`. Команда, единственной целью перенаправления которой является `/dev/null`, такая как `cd app; grep -r pattern . 2>/dev/null`, не запрашивает, потому что `/dev/null` не зависит от рабочего каталога.298* **`cd` с перенаправлением**: запрашивает, когда Claude Code не может определить, в какой каталог разрешается цель перенаправления после выполнения `cd`. Команда, единственной целью перенаправления которой является `/dev/null`, такая как `cd app; grep -r pattern . 2>/dev/null`, не запрашивает, потому что `/dev/null` не зависит от рабочего каталога.

299 299

300<Warning>300<Warning>

301 Шаблоны разрешений Bash, которые пытаются ограничить аргументы команды, хрупкие. Например, `Bash(curl http://github.com/ *)` предназначен для ограничения curl на URL-адреса GitHub, но не будет совпадать с вариациями, такими как:301 Шаблоны разрешений Bash, которые пытаются ограничить аргументы команды, хрупкие. Например, `Bash(curl http://github.com/ *)` предназначен для ограничения curl URL-адресами GitHub, но не будет соответствовать вариациям вроде:

302 302

303 * Опции перед URL: `curl -X GET http://github.com/...`303 * Опции перед URL: `curl -X GET http://github.com/...`

304 * Другой протокол: `curl https://github.com/...`304 * Другой протокол: `curl https://github.com/...`

305 * Перенаправления: `curl -L http://short.example.com/xyz`, которое перенаправляет на GitHub305 * Перенаправления: `curl -L http://short.example.com/xyz`, которое перенаправляет на GitHub

306 * Переменные: `URL=http://github.com && curl $URL`306 * Переменные: `URL=http://github.com && curl $URL`

307 307

308 Для более надежной фильтрации URL рассмотрите:308 Для более надёжной фильтрации URL рассмотрите:

309 309

310 * **Ограничение сетевых инструментов Bash**: используйте правила deny для блокировки `curl`, `wget` и подобных команд, затем используйте инструмент WebFetch с разрешением `WebFetch(domain:github.com)` для разрешенных доменов. Правило deny не совпадает с одной и той же программой по пути или внутри `sh -c`, поэтому объедините его с [списком разрешений сетевого sandbox](/docs/ru/sandboxing#network-isolation), когда ограничение должно действовать; см. [что правило Bash не совпадает](#bash-rule-limits)310 * **Ограничить сетевые инструменты Bash**: используйте правила отказа для остановки `curl`, `wget` и подобных команд, затем используйте инструмент WebFetch с разрешением `WebFetch(domain:github.com)` для разрешённых доменов. Правило отказа не соответствует одной и той же программе по пути или внутри `sh -c`, поэтому объедините его с [списком разрешений сети песочницы](/docs/ru/sandboxing#network-isolation), когда ограничение должно действовать; см. [что правило Bash не соответствует](#bash-rule-limits)

311 * **Использование hooks PreToolUse**: реализуйте hook, который проверяет URL-адреса в командах Bash и блокирует недопустимые домены311 * **Используйте hooks PreToolUse**: реализуйте hook, который проверяет URL-адреса в командах Bash и блокирует недопустимые домены

312 * **Добавьте руководство CLAUDE.md**: опишите ваши разрешенные curl шаблоны в `CLAUDE.md`. Это формирует то, что Claude пытается, но не обеспечивает границу, поэтому объедините это с одним из вариантов выше312 * **Добавьте руководство CLAUDE.md**: опишите ваши разрешённые шаблоны curl в `CLAUDE.md`. Это формирует то, что Claude пытается, но не обеспечивает границу, поэтому объедините с одним из вариантов выше

313 313

314 Обратите внимание, что использование только WebFetch не предотвращает сетевой доступ. Если Bash разрешен, Claude все еще может использовать `curl`, `wget` или другие инструменты для доступа к любому URL-адресу.314 Обратите внимание, что использование только WebFetch не предотвращает сетевой доступ. Если Bash разрешён, Claude по-прежнему может использовать `curl`, `wget` или другие инструменты для доступа к любому URL-адресу.

315</Warning>315</Warning>

316 316

317<h4 id="redirections">317<h4 id="redirections">

320 320

321Когда команда перенаправляет вывод или ввод, Claude Code проверяет цель перенаправления против ваших правил файлов, как если бы Claude напрямую написал или прочитал этот файл:321Когда команда перенаправляет вывод или ввод, Claude Code проверяет цель перенаправления против ваших правил файлов, как если бы Claude напрямую написал или прочитал этот файл:

322 322

323* **Перенаправления вывода**: для `> file`, `>> file` или `2> file`, проверка охватывает ваши правила allow и deny `Edit`, [защищённые пути](/docs/ru/permission-modes#protected-paths) и [рабочие каталоги](#working-directories). Правило, такое как `Bash(git commit *)`, разрешает команду, а не цель. Цель, которая начинается с `~` или содержит символ глоба, требует вашего одобрения.323* **Перенаправления вывода**: для `> file`, `>> file` или `2> file`, проверка охватывает ваши правила разрешения и отказа `Edit`, [защищённые пути](/docs/ru/permission-modes#protected-paths) и [рабочие каталоги](#working-directories). Правило вроде `Bash(git commit *)` разрешает команду, а не цель. Цель, которая начинается с `~` или содержит символ глоба, требует вашего одобрения.

324* **Перенаправления ввода**: для `< file`, проверка охватывает ваши правила allow и deny `Read` и рабочие каталоги. Цель вне рабочих каталогов требует вашего одобрения, если правило allow не охватывает её. Цель, которая содержит шаблон глоба или относительный путь, следующий за `cd` в одной команде, требует вашего одобрения, даже когда правило allow охватывает её. Claude Code проверяет цели ввода в v2.1.257 и позже.324* **Перенаправления ввода**: для `< file`, проверка охватывает ваши правила разрешения и отказа `Read` и рабочие каталоги. Цель вне рабочих каталогов требует вашего одобрения, если правило разрешения её не охватывает. Цель, которая содержит шаблон глоба или относительный путь, следующий за `cd` в той же команде, требует вашего одобрения даже когда правило разрешения её охватывает. Claude Code проверяет цели ввода в v2.1.257 и позже.

325 325

326Цели без файла позади них не проверяются: `/dev/null`, формы дескриптора файла, такие как `2>&1` и `<&3`, и here-docs и here-strings.326Цели без файла позади них не проверяются: `/dev/null`, формы дескриптора файла, такие как `2>&1` и `<&3`, и here-docs и here-strings.

327 327

328Claude Code также проверяет файлы, которые пишет команда `tee`, включая в конвейер, такой как `make | tee build.log`. Проверка охватывает ваши правила allow и deny `Edit`, [защищённые пути](/docs/ru/permission-modes#protected-paths) и [рабочие каталоги](#working-directories). Правило allow, такое как `Bash(tee *)`, не охватывает назначение вне рабочих каталогов. Claude Code проверяет цели `tee` в v2.1.269 и позже.328Claude Code также проверяет файлы, которые пишет команда `tee`, включая в конвейер вроде `make | tee build.log`. Проверка охватывает ваши правила разрешения и отказа `Edit`, [защищённые пути](/docs/ru/permission-modes#protected-paths) и [рабочие каталоги](#working-directories). Правило разрешения вроде `Bash(tee *)` не охватывает пункт назначения вне рабочих каталогов. Claude Code проверяет цели `tee` в v2.1.269 и позже.

329 329

330<h3 id="powershell">330<h3 id="powershell">

331 PowerShell331 PowerShell

332</h3>332</h3>

333 333

334Правила разрешений PowerShell используют ту же форму, что и правила Bash. Подстановочные символы с `*` совпадают в любой позиции, суффикс `:*` эквивалентен конечному ` *`, и голый `PowerShell` или `PowerShell(*)` совпадает с каждой командой. Эта конфигурация позволяет команды `Get-ChildItem` и `git commit`, блокируя `Remove-Item`:334Правила разрешений PowerShell используют ту же форму, что и правила Bash. Подстановки с `*` соответствуют в любой позиции, суффикс `:*` эквивалентен конечному ` *`, и голый `PowerShell` или `PowerShell(*)` соответствует каждой команде. Эта конфигурация разрешает команды `Get-ChildItem` и `git commit` при блокировании `Remove-Item`:

335 335

336```json theme={null}336```json theme={null}

337{337{

347}347}

348```348```

349 349

350Общие псевдонимы канонизируются перед сопоставлением. Правило, написанное для имени cmdlet, также совпадает с его псевдонимами, поэтому `PowerShell(Get-ChildItem *)` совпадает с `gci`, `ls` и `dir`. Сопоставление не чувствительно к регистру.350Общие псевдонимы канонизируются перед сопоставлением. Правило, написанное для имени cmdlet, также соответствует его псевдонимам, поэтому `PowerShell(Get-ChildItem *)` соответствует `gci`, `ls` и `dir` также. Сопоставление не чувствительно к регистру.

351 351

352Claude Code анализирует AST PowerShell и проверяет каждую команду в составной команде независимо. Операторы конвейера `|`, разделители операторов `;` и на PowerShell 7+ операторы цепочки `&&` и `||` разделяют составную команду на подкоманды. Правило должно совпадать с каждой подкомандой, чтобы составная команда была разрешена.352Claude Code разбирает AST PowerShell и проверяет каждую команду в составной команде независимо. Операторы конвейера `|`, разделители операторов `;` и на PowerShell 7+ операторы цепи `&&` и `||` разбивают составную команду на подкоманды. Правило должно соответствовать каждой подкоманде, чтобы составная команда была разрешена.

353 353

354<h3 id="read-and-edit">354<h3 id="read-and-edit">

355 Read и Edit355 Read и Edit

356</h3>356</h3>

357 357

358Чтобы заблокировать инструменты файлов Claude от чтения файла или каталога, добавьте правило deny `Read` для его пути, такое как `Read(./.env)` или `Read(./secrets/**)`; [Исключить конфиденциальные файлы](/docs/ru/settings-reference#exclude-sensitive-files) содержит готовый к вставке пример.358Чтобы заблокировать инструменты файлов Claude от чтения файла или каталога, добавьте правило отказа `Read` для его пути, такое как `Read(./.env)` или `Read(./secrets/**)` ; [Исключить конфиденциальные файлы](/docs/ru/settings-reference#exclude-sensitive-files) содержит готовый к вставке пример.

359 359

360Правила `Edit` применяются ко всем встроенным инструментам, которые редактируют файлы. Claude прилагает наилучшие усилия для применения правил `Read` ко всем встроенным инструментам, которые читают файлы, таким как Grep и Glob, к упоминаниям `@file` в ваших подсказках и к выделению и контексту открытого файла, которые подключенный [IDE](/docs/ru/vs-code#the-built-in-ide-mcp-server) делится с Claude.360Правила `Edit` применяются ко всем встроенным инструментам, которые редактируют файлы. Claude прилагает наилучшие усилия для применения правил `Read` ко всем встроенным инструментам, которые читают файлы, таким как Grep и Glob, к упоминаниям `@file` в ваших подсказках и к выделению и контексту открытого файла, которые подключённый [IDE](/docs/ru/vs-code#the-built-in-ide-mcp-server) делит с Claude.

361 361

362Правило deny `Read` также блокирует [инструменты Edit и Write](/docs/ru/errors#file-is-covered-by-a-read-deny-rule) на том же пути, включая создание нового файла там. NotebookEdit не охватывается, поэтому добавьте правило deny `Edit` для путей, которые ни один инструмент не может изменять. Проверка требует Claude Code v2.1.208 или позже при редактировании, и v2.1.228 или позже при записи.362Правило отказа `Read` также блокирует [инструменты Edit и Write](/docs/ru/errors#file-is-covered-by-a-read-deny-rule) на том же пути, включая создание нового файла там. NotebookEdit не охватывается, поэтому добавьте правило отказа `Edit` для путей, которые ни один инструмент не может изменять. Проверка требует Claude Code v2.1.208 или позже при редактировании, и v2.1.228 или позже при записи.

363 363

364Claude Code проверяет разрешения файлов только против правил `Edit(path)` и `Read(path)`. Если вы напишете правило пути для `Write`, `NotebookEdit`, `Glob` или устаревшего инструмента `MultiEdit` вместо этого, Claude Code принимает правило, но никогда не консультируется с ним и [предупреждает при запуске](/docs/ru/errors#is-not-matched-by-file-permission-checks), за исключением правила `Glob`, переданного в `--allowedTools`. Используйте `Edit(docs/**)` вместо `Write(docs/**)`, `NotebookEdit(docs/**)` или `MultiEdit(docs/**)`, и `Read(docs/**)` вместо `Glob(docs/**)`. Claude Code не предупреждает о правиле имени инструмента без пути, такое как правило deny для `Write`; оно совпадает с этим правилом на уровне инструмента везде. Требует Claude Code v2.1.210 или позже.364Claude Code проверяет разрешения файлов только против правил `Edit(path)` и `Read(path)`. Если вы напишете правило пути для `Write`, `NotebookEdit`, `Glob` или устаревшего инструмента `MultiEdit`, Claude Code принимает правило, но никогда не консультируется с ним, и [предупреждает при запуске](/docs/ru/errors#is-not-matched-by-file-permission-checks), за исключением правила `Glob`, переданного в `--allowedTools`. Используйте `Edit(docs/**)` вместо `Write(docs/**)`, `NotebookEdit(docs/**)` или `MultiEdit(docs/**)`, и `Read(docs/**)` вместо `Glob(docs/**)`. Claude Code не предупреждает о правиле имени инструмента без пути, такое как правило отказа для `Write`; оно соответствует этому правилу на уровне инструмента везде. Требует Claude Code v2.1.210 или позже.

365 365

366<Warning>366<Warning>

367 Правила deny Read и Edit применяются к встроенным инструментам файлов Claude, к командам файлов, которые Claude Code распознает в Bash, таким как `cat`, `head`, `tail`, `sed` и `tee`, и к целям перенаправлений Bash [](#redirections), таким как `> file` и `< file`. Они не применяются к команде, которая читает файлы без их именования, такой как `grep -r pattern .`, запущенная из каталога, который содержит файл, или к произвольным подпроцессам, которые косвенно читают или записывают файлы, таким как скрипт Python или Node, который открывает файлы самостоятельно. Для принудительного применения на уровне ОС, которое блокирует все процессы от доступа к пути, [включите sandbox](/docs/ru/sandboxing).367 Правила отказа Read и Edit применяются к встроенным инструментам файлов Claude, к командам файлов, которые Claude Code распознаёт в Bash, таким как `cat`, `head`, `tail`, `sed` и `tee`, и к целям перенаправления Bash [redirections](#redirections), таким как `> file` и `< file`. Они не применяются к команде, которая читает файлы без их именования, такой как `grep -r pattern .`, запущенная из каталога, который содержит файл, или к произвольным подпроцессам, которые косвенно читают или пишут файлы, вроде скрипта Python или Node, который открывает файлы сам. Для принудительного применения на уровне ОС, которое блокирует все процессы от доступа к пути, [включите песочницу](/docs/ru/sandboxing).

368</Warning>368</Warning>

369 369

370Правила Read и Edit используют синтаксис шаблонов [gitignore](https://git-scm.com/docs/gitignore) с четырьмя различными типами шаблонов; для шаблонов каталогов с одним сегментом глубина сопоставления также зависит от типа правила, описанного далее в этом разделе:370Правила Read и Edit оба используют синтаксис шаблона [gitignore](https://git-scm.com/docs/gitignore) с четырьмя различными типами шаблонов; для шаблонов каталогов с одним сегментом глубина сопоставления также зависит от типа правила, описанного позже в этом разделе:

371 371

373| - | - | - | - |373| - | - | - | - |

374| `//path` | Абсолютный путь от корня файловой системы | `Read(//Users/alice/secrets/**)` | `/Users/alice/secrets/**` |374| `//path` | Абсолютный путь от корня файловой системы | `Read(//Users/alice/secrets/**)` | `/Users/alice/secrets/**` |

375| `~/path` | Путь от домашнего каталога | `Read(~/Documents/*.pdf)` | `/Users/alice/Documents/*.pdf` |375| `~/path` | Путь от домашнего каталога | `Read(~/Documents/*.pdf)` | `/Users/alice/Documents/*.pdf` |

377| `path` или `./path` | Путь относительно текущего каталога | `Read(*.env)` | `<cwd>/*.env` |377| `path` или `./path` | Путь относительно текущего каталога | `Read(*.env)` | `<cwd>/*.env` |

378 378

379<Warning>379<Warning>

380 Шаблон, такой как `/Users/alice/file`, не является абсолютным путем. Одиночная косая черта якорирует источник параметров, а не корень файловой системы. Используйте `//Users/alice/file` для абсолютных путей.380 Шаблон вроде `/Users/alice/file` не является абсолютным путём. Одна начальная косая черта якорирует в источнике параметров, а не в корне файловой системы. Используйте `//Users/alice/file` для абсолютных путей.

381</Warning>381</Warning>

382 382

383Шаблон `/path` якорирует в каталоге, связанном с источником параметров, который его определяет, поэтому одно и то же правило совпадает с разными местоположениями в зависимости от того, где вы его разместите:383Шаблон `/path` якорирует в каталоге, связанном с источником параметров, который его определяет, поэтому одно и то же правило соответствует разным местоположениям в зависимости от того, где вы его разместите:

384 384

386| :- | :- |386| :- | :- |

392 392

393Правило, которое вы добавляете через `/permissions`, следует строке для файла параметров, в который вы его сохраняете.393Правило, которое вы добавляете через `/permissions`, следует строке для файла параметров, в который вы его сохраняете.

394 394

395Локальные параметры правил якорируют в [основном рабочем каталоге](#working-directories) сеанса, а не в корне репозитория, где Claude Code [хранит файл](#permission-system) в v2.1.211 и позже. В сеансе, запущенном в корне репозитория, два каталога одинаковые; в сеансе [worktree](/docs/ru/worktrees) общее правило, такое как `Edit(/src/**)`, совпадает с собственным каталогом `src/` этого worktree.395Правила локальных параметров якорируют в [основном рабочем каталоге](#working-directories) сеанса, а не в корне репозитория, где Claude Code [хранит файл](#permission-system) в v2.1.211 и позже. В сеансе, запущенном в корне репозитория, два каталога одинаковы; в сеансе [worktree](/docs/ru/worktrees), общее правило вроде `Edit(/src/**)` соответствует собственному каталогу `src/` этого worktree.

396 396

397Правило deny, такое как `Read(/secrets/**)` в параметрах пользователя, блокирует `~/.claude/secrets/**`, а не каталог `secrets` в вашем проекте. Чтобы написать правило в параметрах пользователя, которое применяется внутри каждого проекта, используйте абсолютный путь `//` или путь относительно дома `~/` вместо этого.397Правило отказа вроде `Read(/secrets/**)` в параметрах пользователя блокирует `~/.claude/secrets/**`, а не каталог `secrets` в вашем проекте. Чтобы написать правило в параметрах пользователя, которое применяется внутри каждого проекта, используйте вместо этого абсолютный путь `//` или путь относительно дома `~/`.

398 398

399В Windows пути нормализуются в форму POSIX перед сопоставлением. `C:\Users\alice` становится `/c/Users/alice`, поэтому используйте `//c/**/.env` для сопоставления файлов `.env` в любом месте на этом диске. Чтобы сопоставить все диски, используйте `//**/.env`.399В Windows пути нормализуются в форму POSIX перед сопоставлением. `C:\Users\alice` становится `/c/Users/alice`, поэтому используйте `//c/**/.env` для соответствия файлам `.env` в любом месте на этом диске. Чтобы соответствовать на всех дисках, используйте `//**/.env`.

400 400

401Примеры:401Примеры:

402 402

403* `Edit(/docs/**)`: редактирование в `<primary working directory>/docs/`, не в `/docs/` или `<primary working directory>/.claude/docs/`403* `Edit(/docs/**)`: редактирует в `<primary working directory>/docs/`, а не в `/docs/` или `<primary working directory>/.claude/docs/`

404* `Read(~/.zshrc)`: чтение `.zshrc` вашего домашнего каталога404* `Read(~/.zshrc)`: читает `.zshrc` вашего домашнего каталога

405* `Edit(//tmp/scratch.txt)`: редактирование абсолютного пути `/tmp/scratch.txt`405* `Edit(//tmp/scratch.txt)`: редактирует абсолютный путь `/tmp/scratch.txt`

406* `Read(src/**)`: как правило allow, чтение из `<current-directory>/src/` только; как правило deny или ask, совпадает с каталогом `src` на любой глубине под текущим каталогом406* `Read(src/**)`: как правило разрешения, читает из `<current-directory>/src/` только; как правило отказа или запроса, соответствует каталогу `src` на любой глубине под текущим каталогом

407 407

408Правило совпадает только с файлами под его якорем; в пределах этой границы глубина сопоставления зависит от формы шаблона и, для шаблонов каталогов с одним сегментом, типа правила, описанного ниже. Голые имена файлов следуют семантике gitignore и совпадают на любой глубине, поэтому `Read(.env)` и `Read(**/.env)` эквивалентны:408Правило соответствует только файлам под его якорем; в этих границах глубина сопоставления зависит от формы шаблона и, для шаблонов каталогов с одним сегментом, типа правила, описанного ниже. Голые имена файлов следуют семантике gitignore и соответствуют на любой глубине, поэтому `Read(.env)` и `Read(**/.env)` эквивалентны:

409 409

411| - | - | - |411| - | - | - |

413| `Read(//**/.env)` | любой `.env` в любом месте файловой системы | ничего; правило якорировано в корне файловой системы |413| `Read(//**/.env)` | любой `.env` в любом месте файловой системы | ничего; правило якорировано в корне файловой системы |

414 414

415Относительный шаблон с одним сегментом каталога, такой как `src/**`, совпадает на разных глубинах в зависимости от типа правила:415Относительный шаблон с одним сегментом каталога, такой как `src/**`, соответствует на разных глубинах в зависимости от типа правила:

416 416

417* **Правила allow**: `Edit(src/**)` совпадает только с `<cwd>/src` и файлами под ним. Чтобы разрешить имя каталога на любой глубине, напишите `Edit(**/src/**)`.417* **Правила разрешения**: `Edit(src/**)` соответствует только `<cwd>/src` и файлам под ним. Чтобы разрешить имя каталога на любой глубине, напишите `Edit(**/src/**)`.

418* **Правила deny и ask**: `Read(secrets/**)` совпадает с каталогом с именем `secrets` на любой глубине под текущим каталогом, поэтому правило также применяется к вложенным копиям.418* **Правила отказа и запроса**: `Read(secrets/**)` соответствует каталогу с именем `secrets` на любой глубине под текущим каталогом, поэтому правило также применяется к вложенным копиям.

419 419

420Каждая другая форма шаблона совпадает на одной и той же глубине в каждом типе правила: `Edit(/src/**)` и `Edit(src/components/**)` совпадают только в их якорированном местоположении, в то время как `Edit(**/src/**)` совпадает на любой глубине.420Каждая другая форма шаблона соответствует на одной и той же глубине в каждом типе правила: `Edit(/src/**)` и `Edit(src/components/**)` соответствуют только в их якорированном местоположении, в то время как `Edit(**/src/**)` соответствует на любой глубине.

421 421

422Следующий пример показывает каждую форму шаблона против проекта с каталогом `src/` верхнего уровня и вложенной копией под `vendor/`:422Следующий пример показывает каждую форму шаблона против проекта с каталогом `src/` верхнего уровня и вложенной копией под `vendor/`:

423 423

431 └── lib.js431 └── lib.js

432```432```

433 433

435| :- | :- | :- |435| :- | :- | :- |

436| `Edit(src/**)` как правило allow | Да | Нет |436| `Edit(src/**)` как правило разрешения | Да | Нет |

437| `Edit(src/**)` как правило deny или ask | Да | Да |437| `Edit(src/**)` как правило отказа или запроса | Да | Да |

438| `Edit(/src/**)` в любом типе правила | Да | Нет |438| `Edit(/src/**)` в любом типе правила | Да | Нет |

439| `Edit(**/src/**)` в любом типе правила | Да | Да |439| `Edit(**/src/**)` в любом типе правила | Да | Да |

440 440

441<Note>441<Note>

442 В шаблонах gitignore `*` совпадает в одном сегменте пути и может появляться в любой позиции в шаблоне, в то время как `**` совпадает по каталогам.442 В шаблонах gitignore `*` соответствует в пределах одного сегмента пути и может появляться в любой позиции в шаблоне, в то время как `**` соответствует через каталоги.

443</Note>443</Note>

444 444

445Когда вы одобряете путь к файлу с "Да, не спрашивать снова", Claude Code экранирует символы шаблона gitignore в этом пути, такие как `[`, `]` и `*`, поэтому сгенерированное правило совпадает только с буквальным путем, который вы одобрили. Правила, которые вы пишете сами, не экранируются. До версии 2.1.202 Claude Code сохранял путь без экранирования, поэтому сгенерированное правило для каталога с именем `[2024-06] Reports` могло не совпадать с его собственным путем или совпадать с непредусмотренными соседними каталогами.445Когда вы одобряете путь файла с помощью «Да, и больше не спрашивать», Claude Code экранирует символы шаблона gitignore в этом пути, такие как `[`, `]` и `*`, поэтому сгенерированное правило соответствует только буквальному пути, который вы одобрили. Правила, которые вы пишете сами, не экранируются. До v2.1.202 Claude Code сохранял путь неэкранированным, поэтому сгенерированное правило для каталога с именем `[2024-06] Reports` могло не соответствовать собственному пути или соответствовать непредусмотренным соседним каталогам.

446 446

447Вам не нужно экранировать скобки в пути, поэтому `Edit(./Finance (2024)/**)` совпадает с папкой `Finance (2024)` как написано.447Вам не нужно экранировать скобки в пути, поэтому `Edit(./Finance (2024)/**)` соответствует папке `Finance (2024)` как написано.

448 448

449Правило deny или ask, чей путь не пригоден как шаблон gitignore, по-прежнему охраняет этот точный путь. Правило allow с непригодным шаблоном ничего не одобряет.449Правило отказа или запроса, чей путь не пригоден для использования в качестве шаблона gitignore, по-прежнему охраняет этот точный путь. Правило разрешения с непригодным шаблоном ничего не одобряет.

450 450

451Шаблон deny или ask, который начинается с `!`, является отрицанием gitignore. Он вырезает пути, которые он совпадает, из правил `path` или `./path`, перечисленных перед ним. В одном списке `deny` файла параметров, `Read(*.env)` с последующим `Read(!sample.env)` блокирует каждый файл, имя которого заканчивается на `.env` на любой глубине, за исключением файлов с именем `sample.env`. Правило `!`, перечисленное первым, ничего не вырезает.451Шаблон отказа или запроса, который начинается с `!`, является отрицанием gitignore. Он вырезает пути, которые он соответствует, из правил `path` или `./path`, перечисленных перед ним. В одном списке `deny` файла параметров `Read(*.env)`, за которым следует `Read(!sample.env)`, блокирует каждый файл, имя которого заканчивается на `.env` на любой глубине, за исключением файлов с именем `sample.env`. Правило `!`, перечисленное первым, ничего не вырезает.

452 452

453Вырезание достигает только правил из одного источника. `Read(!.env)` в параметрах проекта или в `--disallowedTools` не отменяет `Read(./.env)` deny из управляемых параметров или любого другого файла параметров.453Вырезание достигает только правил из одного источника. `Read(!.env)` в параметрах проекта или в `--disallowedTools` не отменяет отказ `Read(./.env)` из управляемых параметров или любого другого файла параметров.

454 454

455Два ограничения сужают то, что шаблон `!` может вырезать:455Два ограничения сужают то, что может вырезать шаблон `!`:

456 456

457* Claude Code читает шаблон `!` относительно текущего каталога, даже когда после `!` следует `/`, `~/` или `//`, поэтому шаблон не может достичь правила, якорированного одним из этих префиксов. `Read(!~/notes/public/**)` ничего не вырезает из `Read(~/notes/**)`.457* Claude Code читает шаблон `!` относительно текущего каталога даже когда после `!` следует `/`, `~/` или `//`, поэтому шаблон не может достичь правила, якорированного одним из этих префиксов. `Read(!~/notes/public/**)` ничего не вырезает из `Read(~/notes/**)`.

458* Вырезание не может переоткрыть файл внутри каталога, который правило блокирует целиком. С `Read(secrets/**)` и `Read(!secrets/public/**)`, Claude Code по-прежнему блокирует `secrets/public` вместе с остальной частью `secrets`.458* Вырезание не может переоткрыть файл внутри каталога, который правило блокирует целиком. С `Read(secrets/**)` и `Read(!secrets/public/**)`, Claude Code по-прежнему блокирует `secrets/public` вместе с остальной частью `secrets`.

459 459

460Когда Claude получает доступ к символической ссылке, правила разрешений проверяют два пути: саму символическую ссылку и файл, на который она указывает. Правила allow и deny обрабатывают эту пару по-разному: правила allow возвращаются к запросу вас, в то время как правила deny блокируют полностью.460<h4 id="symlinks">

461 Символические ссылки

462</h4>

463

464Когда путь файла, который запрашивает Claude, проходит через символическую ссылку, проверка разрешения охватывает два пути: запрошенный путь и файл, на который он разрешается. Это применяется к символическим ссылкам на macOS, Linux и Windows, а также к соединениям каталогов на Windows.

465

466<h5 id="how-rules-match-a-symlinked-path">

467 Как правила соответствуют символически связанному пути

468</h5>

469

470Правила разрешения и отказа обрабатывают запрошенный путь и файл, на который он разрешается, по-разному:

471

472* **Правила разрешения**: применяются только когда оба пути символической ссылки и её цель соответствуют. Чтение через символическую ссылку внутри разрешённого каталога, которая указывает вне его, не соответствует правилу.

473* **Правила отказа**: применяются когда либо путь символической ссылки, либо её цель соответствует. Символическая ссылка, которая указывает на запрещённый файл, сама запрещена. Например, с `Read(./project/**)` разрешённым и `Read(~/.ssh/**)` запрещённым, символическая ссылка в `./project/key`, указывающая на `~/.ssh/id_rsa`, блокируется: цель не проходит правило разрешения и соответствует правилу отказа.

474

475На macOS и Linux, правило отказа или запроса, написанное через символически связанный каталог с шаблоном `//`, `~/` или `/`, также применяется в реальном местоположении каталога. Например, на macOS, где `/etc` разрешается в `/private/etc`, `Read(//etc/**)` также блокирует `/private/etc/hosts`. До v2.1.268 правило отказа или запроса, написанное через символически связанный каталог, не применялось к пути, заданному его реальным местоположением.

461 476

462* **Правила allow**: применяются только когда совпадают как путь символической ссылки, так и его цель. Символическая ссылка внутри разрешенного каталога, которая указывает вне его, по-прежнему запрашивает вас.477Grep и Glob ищут каталог, на который разрешается аргумент `path`. Claude Code применяет правила отказа `Read` к этому каталогу.

463* **Правила deny**: применяются когда совпадает либо путь символической ссылки, либо его цель. Символическая ссылка, которая указывает на запрещенный файл, сама запрещена. Например, с `Read(./project/**)` разрешено и `Read(~/.ssh/**)` запрещено, символическая ссылка в `./project/key`, указывающая на `~/.ssh/id_rsa`, блокируется: цель не проходит правило allow и совпадает с правилом deny.

464 478

465На macOS и Linux правило deny или ask, написанное через символически связанный каталог с шаблоном `//`, `~/` или `/`, также применяется в реальном местоположении каталога. Например, на macOS, где `/etc` разрешается в `/private/etc`, `Read(//etc/**)` также блокирует `/private/etc/hosts`. До версии 2.1.268 правило deny или ask, написанное через символически связанный каталог, не применялось к пути, заданному его реальным местоположением.479<h5 id="writes-through-a-symlink">

480 Записи через символическую ссылку

481</h5>

466 482

467Когда инструмент открывает одобренный файл, Claude Code [подтверждает, что путь по-прежнему разрешается в местоположение, которое проверка разрешений одобрила](/docs/ru/errors#refusing-after-a-symlink-changed).483Если путь, который Claude просит отредактировать или написать, сам является символической ссылкой, инструменты Edit и Write [отказывают в записи и направляют Claude к цели ссылки](/docs/ru/errors#refusing-after-a-symlink-changed).

468 484

469Grep и Glob ищут каталог, в который разрешается аргумент `path`. Claude Code применяет правила deny `Read` к этому каталогу.485Запись по-прежнему может пройти через символическую ссылку, когда каталог на пути к файлу является символической ссылкой, или когда команда Bash или PowerShell выполняет запись. Для этих записей то, что происходит, зависит от того, где файл, на который разрешается запись, находится относительно ваших [рабочих каталогов](#working-directories) и [защищённых путей](/docs/ru/permission-modes#protected-paths):

486

487* **Разрешается вне рабочих каталогов**: когда запрошенный путь находится внутри ваших рабочих каталогов, а файл, на который он разрешается, нет, запись не автоматически одобряется в режиме [`acceptEdits`](/docs/ru/permission-modes#auto-approve-file-edits-with-acceptedits-mode). В [автоматическом режиме](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), если правило разрешения не одобряет запись, вас запрашивают вместо того, чтобы классификатор решал. Запрос называет путь, на который разрешается запись.

488* **Разрешается к защищённому пути, который запрошенный путь не называет**: [таблица защищённых путей](/docs/ru/permission-modes#protected-paths) даёт результат для каждого режима разрешений, за исключением того, что где таблица маршрутизирует запись к классификатору, эта запись вместо этого запрашивает вас.

489

490<h5 id="paths-that-can’t-be-resolved-or-that-change">

491 Пути, которые не могут быть разрешены или которые изменяются

492</h5>

493

494Когда Claude Code не может определить, где путь ведёт на диск, например потому что символические ссылки на нём образуют цикл, инструменты Read, Edit и Write [отказывают в операции](/docs/ru/errors#refusing-after-a-symlink-changed).

495

496Когда инструмент затем открывает одобренный файл, он [подтверждает, что путь по-прежнему разрешается в местоположение, которое проверка разрешения одобрила](/docs/ru/errors#refusing-after-a-symlink-changed).

470 497

471<h3 id="webfetch">498<h3 id="webfetch">

472 WebFetch499 WebFetch

473</h3>500</h3>

474 501

475Правила WebFetch используют префикс `domain:` и совпадают с именем хоста запрашиваемого URL. Сопоставление не чувствительно к регистру, поддерживает подстановочные символы `*` и удаляет конечную точку из правила и имени хоста, поэтому `example.com.` и `example.com` рассматриваются одинаково.502Правила WebFetch используют префикс `domain:` и соответствуют имени хоста запрашиваемого URL. Сопоставление не чувствительно к регистру, поддерживает подстановки `*` и удаляет конечную `.` из правила и имени хоста, поэтому `example.com.` и `example.com` рассматриваются одинаково.

476 503

477* `WebFetch(domain:example.com)` совпадает с запросами на `example.com`504* `WebFetch(domain:example.com)` соответствует запросам к `example.com`

478* `WebFetch(domain:*.example.com)` совпадает с любым поддоменом на любой глубине, таким как `api.example.com` или `a.b.example.com`, но не с самим `example.com`505* `WebFetch(domain:*.example.com)` соответствует любому поддомену на любой глубине, такому как `api.example.com` или `a.b.example.com`, но не самому `example.com`

479* `WebFetch(domain:*)` совпадает с каждым доменом. Это не то же самое, что голое правило `WebFetch`; см. [Разрешить или запретить каждую выборку](#allow-or-deny-every-fetch)506* `WebFetch(domain:*)` соответствует каждому домену. Это не то же самое, что голое правило `WebFetch`; см. [Разрешить или запретить каждую выборку](#allow-or-deny-every-fetch)

480 507

481В любой позиции, отличной от ведущего `*.` или голого `*`, подстановочный символ совпадает только с текстом между двумя точками. `WebFetch(domain:example.*)` совпадает с `example.org`, где `*` становится `org`, но не с `example.evil.com`, где `*` должен был бы стать `evil.com` и пересечь точку. Это предотвращает совпадение конечного подстановочного символа с доменами, которые может зарегистрировать злоумышленник.508В любой позиции, отличной от начального `*.` или голого `*`, подстановка соответствует только тексту между двумя точками. `WebFetch(domain:example.*)` соответствует `example.org`, где `*` становится `org`, но не `example.evil.com`, где `*` пришлось бы стать `evil.com` и пересечь точку. Это предотвращает конечную подстановку от соответствия доменам, которые злоумышленник мог бы зарегистрировать.

482 509

483Подстановочные символы в правилах `WebFetch` требуют Claude Code v2.1.172 или позже для совпадения выборок.510Подстановки в правилах `WebFetch` требуют Claude Code v2.1.172 или позже для соответствия выборкам.

484 511

485<h4 id="allow-or-deny-every-fetch">512<h4 id="allow-or-deny-every-fetch">

486 Разрешить или запретить каждую выборку513 Разрешить или запретить каждую выборку

487</h4>514</h4>

488 515

489Голое правило `WebFetch` - это имя инструмента без части `domain:`, такое как `"deny": ["WebFetch"]`. Оно и `WebFetch(domain:*)` охватывают каждый URL, но Claude Code применяет их по-разному, и только форма `domain:` также добавляет свой домен в [список разрешённых или запрещённых доменов](/docs/ru/sandboxing#network-isolation) sandbox. Этот раздел перечисляет формы подстановочных символов, которые sandbox поддерживает, и версию, которая добавила голый `*`.516Голое правило `WebFetch` — это имя инструмента без части `domain:`, такое как `"deny": ["WebFetch"]`. Оно и `WebFetch(domain:*)` охватывают каждый URL, но Claude Code применяет их по-разному, и только форма `domain:` также добавляет свой домен в [список разрешённых или запрещённых доменов](/docs/ru/sandboxing#network-isolation) песочницы. Этот раздел перечисляет формы подстановки, которые песочница соблюдает, и версию, которая добавила голый `*`.

490 517

491Каждая строка показывает, что правило делает в списке `allow` и в списке `deny`:518Каждая строка показывает, что правило делает в списке `allow` и в списке `deny`:

492 519

494| :- | :- | :- |521| :- | :- | :- |

495| `WebFetch` | Claude выполняет выборку без запроса вас. Не изменяет, какие хосты могут достичь команды в sandbox. | Claude Code удаляет инструмент `WebFetch`, поэтому Claude не может выполнять выборку вообще. Не изменяет, какие хосты могут достичь команды в sandbox. |522| `WebFetch` | Claude выполняет выборку без запроса вас. Не изменяет, какие хосты могут достичь изолированные команды. | Claude Code удаляет инструмент `WebFetch`, поэтому Claude вообще не может выполнять выборку. Не изменяет, какие хосты могут достичь изолированные команды. |

496| `WebFetch(domain:*)` | Claude выполняет выборку без запроса вас, и команды в sandbox могут достичь любого хоста. | Claude Code сохраняет инструмент и отказывает в каждой выборке, и команды в sandbox не могут достичь никакого хоста. |523| `WebFetch(domain:*)` | Claude выполняет выборку без запроса вас, и изолированные команды могут достичь любого хоста. | Claude Code сохраняет инструмент и отказывает каждой выборке, и изолированные команды не могут достичь ни один хост. |

497 524

498Две формы также отличаются при чтении [артефактов](/docs/ru/artifacts), страниц, которые инструмент Artifact публикует на claude.ai. Голое правило deny или ask `WebFetch` не применяется к этим чтениям. Правило `domain:`, охватывающее `claude.ai` или хост содержимого `*.claudeusercontent.com`, такое как `WebFetch(domain:claude.ai)` или `WebFetch(domain:*)`, отказывает в каждом чтении или запрашивает перед ним. Правило [`Artifact`](/docs/ru/artifacts#disable-artifacts) делает то же самое.525Две формы также отличаются при чтении [артефактов](/docs/ru/artifacts), страниц, которые инструмент Artifact публикует на claude.ai. Голое правило отказа или запроса `WebFetch` не применяется к этим чтениям. Правило `domain:`, охватывающее `claude.ai` или хост содержимого `*.claudeusercontent.com`, такое как `WebFetch(domain:claude.ai)` или `WebFetch(domain:*)`, отказывает каждому чтению или запрашивает перед ним. Правило [`Artifact`](/docs/ru/artifacts#disable-artifacts) делает то же самое.

499 526

500Когда правило блокирует чтение, отказ называет правило. До версии 2.1.268 голое правило deny `WebFetch` блокировало каждое чтение артефакта, и голое правило ask запрашивало перед каждым.527Когда правило блокирует чтение, отказ называет правило. До v2.1.268 голое правило отказа `WebFetch` блокировало каждое чтение артефакта, и голое правило запроса запрашивало перед каждым.

501 528

502Чтобы позволить Claude выполнять выборку свободно, сохраняя список разрешений sandbox как есть, используйте голую форму. Этот `settings.json` делает это:529Чтобы позволить Claude выполнять выборку свободно, сохраняя список разрешений песочницы как есть, используйте голую форму. Этот `settings.json` делает это:

503 530

504```json theme={null}531```json theme={null}

505{532{

509}536}

510```537```

511 538

512Когда вы просите Claude выполнить выборку страницы, он выполняет выборку без запроса. Когда вы просите его запустить [sandboxed](/docs/ru/sandboxing) `curl` против хоста вне списка разрешений sandbox, Claude Code по-прежнему запрашивает вас для этого хоста, потому что голое правило не добавило хост в список разрешений.539Когда вы просите Claude выполнить выборку страницы, он выполняет её без запроса. Когда вы просите его запустить [изолированный](/docs/ru/sandboxing) `curl` против хоста вне списка разрешений песочницы, Claude Code по-прежнему запрашивает вас для этого хоста, потому что голое правило не добавило хост в список разрешений.

513 540

514В [режиме auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) Claude вместо этого называет хост в [разрешённых доменах для каждой команды](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode) сеанса для проверки классификатором.541В [автоматическом режиме](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), Claude вместо этого называет хост в [разрешённых доменах для каждой команды](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode) команды для проверки классификатором.

515 542

516<h3 id="mcp">543<h3 id="mcp">

517 MCP544 MCP

518</h3>545</h3>

519 546

520Правила MCP используют имя сервера, настроенное в Claude Code, опционально за которым следует имя инструмента с этого сервера.547Правила MCP используют имя сервера в соответствии с конфигурацией Claude Code, опционально за которым следует имя инструмента с этого сервера.

521 548

522* `mcp__puppeteer` совпадает с любым инструментом, предоставленным сервером `puppeteer`549* `mcp__puppeteer` соответствует любому инструменту, предоставленному сервером `puppeteer`

523* `mcp__puppeteer__*` использует синтаксис подстановочных символов и также совпадает со всеми инструментами с сервера `puppeteer`550* `mcp__puppeteer__*` использует синтаксис подстановки и также соответствует всем инструментам с сервера `puppeteer`

524* `mcp__puppeteer__puppeteer_navigate` совпадает с инструментом `puppeteer_navigate`, предоставленным сервером `puppeteer`551* `mcp__puppeteer__puppeteer_navigate` соответствует инструменту `puppeteer_navigate`, предоставленному сервером `puppeteer`

525 552

526Если ваша организация установила [инструмент соединителя claude.ai](/docs/ru/mcp#organization-controls-on-connector-tools) на `ask` и эта настройка достигает Claude Code в вашем сеансе, правила allow для этого инструмента не вступают в силу: Claude Code запрашивает при каждом вызове, даже в режимах `auto` и `bypassPermissions`. В режиме `dontAsk`, который никогда не запрашивает, Claude Code отказывает в вызове вместо этого. Инструменты из соединителей, которые Claude Code получает сам, отображаются как `mcp__claude_ai_<server>__<tool>`.553Если ваша организация установила инструмент [коннектора claude.ai](/docs/ru/mcp#organization-controls-on-connector-tools) на `ask` и эта настройка достигает Claude Code в вашем сеансе, правила разрешения для этого инструмента не вступают в силу: Claude Code запрашивает при каждом вызове, даже в режимах `auto` и `bypassPermissions`. В режиме `dontAsk`, который никогда не запрашивает, Claude Code вместо этого отказывает вызову. Инструменты из коннекторов, которые Claude Code выбирает сам, появляются как `mcp__claude_ai_<server>__<tool>`.

527 554

528В сеансе [Cowork](https://claude.com/docs/cowork/overview) в приложении Claude Desktop Claude запускает команды оболочки через инструмент `mcp__workspace__bash` Cowork вместо встроенного инструмента `Bash`, и Cowork также предоставляет `mcp__workspace__web_fetch` для выборок в сети. Claude Code также применяет правила deny, которые называют весь инструмент `Bash` или `WebFetch`, к этим инструментам Cowork, поэтому управляемое правило deny `Bash` останавливает Claude от запуска команд оболочки в Cowork. Когда Claude Code блокирует такой вызов, сообщение называет инструмент Cowork: `Permission to use mcp__workspace__bash has been denied.` Правила allow не переносятся: Claude Code никогда не применяет правило allow `Bash` к `mcp__workspace__bash`.555В сеансе [Cowork](https://claude.com/docs/cowork/overview) в приложении Claude Desktop, Claude запускает команды оболочки через инструмент `mcp__workspace__bash` Cowork вместо встроенного инструмента `Bash`, и Cowork также предоставляет `mcp__workspace__web_fetch` для выборок в сети. Claude Code также применяет правила отказа, которые называют весь инструмент `Bash` или `WebFetch`, к этим инструментам Cowork, поэтому управляемое правило отказа `Bash` останавливает Claude от запуска команд оболочки в Cowork. Когда Claude Code блокирует такой вызов, сообщение называет инструмент Cowork: `Permission to use mcp__workspace__bash has been denied.` Правила разрешения не переносятся: Claude Code никогда не применяет правило разрешения `Bash` к `mcp__workspace__bash`.

529 556

530<h3 id="agent-subagents">557<h3 id="agent-subagents">

531 Agent (subagents)558 Agent (подагенты)

532</h3>559</h3>

533 560

534Используйте правила `Agent(AgentName)` для контроля, какие [subagents](/docs/ru/sub-agents) может использовать Claude:561Используйте правила `Agent(AgentName)` для управления тем, какие [подагенты](/docs/ru/sub-agents) может использовать Claude:

535 562

536* `Agent(Explore)` совпадает с subagent Explore563* `Agent(Explore)` соответствует подагенту Explore

537* `Agent(Plan)` совпадает с subagent Plan564* `Agent(Plan)` соответствует подагенту Plan

538* `Agent(my-custom-agent)` совпадает с пользовательским subagent с именем `my-custom-agent`565* `Agent(my-custom-agent)` соответствует пользовательскому подагенту с именем `my-custom-agent`

539 566

540Добавьте эти правила в массив `deny` в ваших параметрах или используйте флаг CLI `--disallowedTools` для отключения конкретных агентов. Чтобы отключить агент Explore:567Добавьте эти правила в массив `deny` в ваших параметрах или используйте флаг CLI `--disallowedTools` для отключения конкретных агентов. Чтобы отключить агент Explore:

541 568

551 Cd578 Cd

552</h3>579</h3>

553 580

554Правила `Cd` контролируют, в какие каталоги команда [`/cd`](/docs/ru/commands) может переместить сеанс. `Cd` не является инструментом, вызываемым моделью: Claude не может его вызвать, и правила применяются только когда вы сами запускаете `/cd`.581Правила `Cd` управляют тем, в какие каталоги команда [`/cd`](/docs/ru/commands) может переместить сеанс. `Cd` не является инструментом, вызываемым моделью: Claude не может его вызвать, и правила применяются только когда вы сами запускаете `/cd`.

555 582

556Голое правило deny `Cd` отключает `/cd` полностью. Правило deny `Cd(<path-pattern>)` блокирует совпадающие цели. Правила deny проверяют каждое написание цели, включая каждый переход символической ссылки, через который она разрешается, поэтому правило, написанное для одного пути, также блокирует цели, которые разрешаются в него.583Голое правило отказа `Cd` полностью отключает `/cd`. Правило отказа `Cd(<path-pattern>)` блокирует соответствующие цели. Правила отказа проверяют каждое написание цели, включая каждый скачок символической ссылки, через который она разрешается, поэтому правило, написанное для одного пути, также блокирует цели, которые разрешаются в него.

557 584

558Добавление любого правила allow `Cd` переключает `/cd` в режим списка разрешений: разрешенный целевой каталог должен совпадать с одним из ваших правил allow, или `/cd` отказывает. Без настроенных правил `Cd`, `/cd` сохраняет своё поведение по умолчанию и запрашивает вас доверять незнакомому каталогу.585Добавление любого правила разрешения `Cd` переключает `/cd` в режим списка разрешений: разрешённый целевой каталог должен соответствовать одному из ваших правил разрешения, или `/cd` отказывает. Без настроенных правил `Cd`, `/cd` сохраняет своё поведение по умолчанию и запрашивает вас доверять незнакомому каталогу.

559 586

560Шаблоны путей используют якоря `//`, `~/` и `/` из [правил Read и Edit](#read-and-edit), но сопоставление якорировано ко всему пути каталога, а не в стиле gitignore. `*` совпадает ровно с одним сегментом пути и `**` совпадает по сегментам. Конечный `/**` также совпадает с его названным корнем.587Шаблоны путей используют якоря `//`, `~/` и `/` из [правил Read и Edit](#read-and-edit), но сопоставление якорировано к целому пути каталога, а не в стиле gitignore. `*` соответствует ровно одному сегменту пути и `**` соответствует через сегменты. Конечный `/**` также соответствует его названному корню.

561 588

563| - | - | - |590| - | - | - |

564| `Cd(~/code/*)` | `~/code/app` | `~/code/app/src`, `~/code` |591| `Cd(~/code/*)` | `~/code/app` | `~/code/app/src`, `~/code` |

565| `Cd(~/code/**)` | `~/code` и любой каталог под ним | каталоги вне `~/code` |592| `Cd(~/code/**)` | `~/code` и любой каталог под ним | каталоги вне `~/code` |

567 594

568<h2 id="extend-permissions-with-hooks">595<h2 id="extend-permissions-with-hooks">

569 Расширение разрешений с помощью hooks596 Расширение разрешений с помощью hooks

605 632

606* Его параметры проекта, включая их правила разрешений и [hooks](/docs/ru/hooks)633* Его параметры проекта, включая их правила разрешений и [hooks](/docs/ru/hooks)

607* Его [серверы `.mcp.json`](/docs/ru/mcp#project-scope), подлежащие тому же [одобрению сервера](/docs/ru/mcp#project-server-approvals-and-workspace-trust), что и при запуске, и [локальные](/docs/ru/mcp#local-scope) MCP серверы, которые вы зарегистрировали в нём634* Его [серверы `.mcp.json`](/docs/ru/mcp#project-scope), подлежащие тому же [одобрению сервера](/docs/ru/mcp#project-server-approvals-and-workspace-trust), что и при запуске, и [локальные](/docs/ru/mcp#local-scope) MCP серверы, которые вы зарегистрировали в нём

608* [Плагины](/docs/ru/plugins), которые его параметры включают, его [skills](/docs/ru/skills#discovery-from-parent-and-nested-directories) и его [subagents](/docs/ru/sub-agents)635* [Плагины](/docs/ru/plugins/overview), которые его параметры включают, его [skills](/docs/ru/skills#discovery-from-parent-and-nested-directories) и его [subagents](/docs/ru/sub-agents)

609* Его значения [`env`](/docs/ru/settings-reference#env), применённые поверх переменных окружения из параметров предыдущего каталога, которые остаются в силе636* Его значения [`env`](/docs/ru/settings-reference#env), применённые поверх переменных окружения из параметров предыдущего каталога, которые остаются в силе

610 637

611Claude Code также отключает проект предыдущего каталога и [локальные](/docs/ru/mcp#local-scope) MCP серверы, а также серверы [плагинов](/docs/ru/mcp#plugin-provided-mcp-servers), которые больше не включены после перемещения. Он берёт [дополнительные каталоги](#working-directories) из параметров нового каталога вместо параметров предыдущего и сохраняет каталоги, которые вы добавили с помощью `--add-dir` или `/add-dir`. Hooks, которые активирует перемещение, по-прежнему получают [`${CLAUDE_PROJECT_DIR}`](/docs/ru/hooks#reference-scripts-by-path), установленный в корень проекта, где сеанс начался.638Claude Code также отключает проект предыдущего каталога и [локальные](/docs/ru/mcp#local-scope) MCP серверы, а также серверы [плагинов](/docs/ru/mcp#plugin-provided-mcp-servers), которые больше не включены после перемещения. Он берёт [дополнительные каталоги](#working-directories) из параметров нового каталога вместо параметров предыдущего и сохраняет каталоги, которые вы добавили с помощью `--add-dir` или `/add-dir`. Hooks, которые активирует перемещение, по-прежнему получают [`${CLAUDE_PROJECT_DIR}`](/docs/ru/hooks#reference-scripts-by-path), установленный в корень проекта, где сеанс начался.

641Чтобы поделиться этой конфигурацией между проектами, используйте один из этих подходов:668Чтобы поделиться этой конфигурацией между проектами, используйте один из этих подходов:

642 669

643* **Конфигурация на уровне пользователя**: поместите файлы в `~/.claude/agents/`, `~/.claude/output-styles/` или `~/.claude/settings.json`, чтобы сделать их доступными в каждом проекте670* **Конфигурация на уровне пользователя**: поместите файлы в `~/.claude/agents/`, `~/.claude/output-styles/` или `~/.claude/settings.json`, чтобы сделать их доступными в каждом проекте

644* **Плагины**: упакуйте и распространяйте конфигурацию как [плагин](/docs/ru/plugins), который команды могут установить671* **Плагины**: упакуйте и распространяйте конфигурацию как [плагин](/docs/ru/plugins/overview), который команды могут установить

645* **Запуск из каталога конфигурации**: запустите Claude Code из каталога, содержащего конфигурацию `.claude/`, которую вы хотите использовать672* **Запуск из каталога конфигурации**: запустите Claude Code из каталога, содержащего конфигурацию `.claude/`, которую вы хотите использовать

646 673

647<h2 id="how-permissions-interact-with-sandboxing">674<h2 id="how-permissions-interact-with-sandboxing">

705 732

706Claude Code показывает диалог доверия только в интерактивных сеансах. Запуск `claude -p` или сеанс SDK никогда не показывает его, и доверие к родительской папке не учитывается для этих правил, поэтому [Что выполняется до того, как вы доверяете папке](#what-runs-before-you-trust-a-folder) указывает, какое содержимое репозитория Claude Code всё ещё использует в каждой из этих двух ситуаций.733Claude Code показывает диалог доверия только в интерактивных сеансах. Запуск `claude -p` или сеанс SDK никогда не показывает его, и доверие к родительской папке не учитывается для этих правил, поэтому [Что выполняется до того, как вы доверяете папке](#what-runs-before-you-trust-a-folder) указывает, какое содержимое репозитория Claude Code всё ещё использует в каждой из этих двух ситуаций.

707 734

735Перед запуском или перезапуском [фонового сеанса](/docs/ru/agent-view) Claude Code также проверяет доверие рабочей области для каталога, в котором выполняется сеанс. Если вы запустите `claude --bg` из терминала в каталоге, которому вы не доверяли, диалог доверия появляется в первую очередь, и сеанс начинается после того, как вы его примете. Где диалог не может появиться, например в скрипте, команда вместо этого завершается с ошибкой [`Workspace not trusted`](/docs/ru/errors#workspace-not-trusted-when-dispatching-a-background-session).

736

708<h3 id="when-your-local-settings-file-needs-trust">737<h3 id="when-your-local-settings-file-needs-trust">

709 Когда ваш локальный файл параметров требует доверия738 Когда ваш локальный файл параметров требует доверия

710</h3>739</h3>

732| :- | :- | :- |761| :- | :- | :- |

733| [Hooks](/docs/ru/hooks) в файлах параметров, блок [`env`](/docs/ru/settings-reference#env) и вспомогательные команды, такие как [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), и [hooks](/docs/ru/hooks#hooks-in-skills-and-agents) проектного skill и [`allowed-tools`](/docs/ru/skills#pre-approve-tools-for-a-skill) | Используется | Используется. Доверие рабочей области никогда не блокирует `allowed-tools` skill в любом сеансе |762| [Hooks](/docs/ru/hooks) в файлах параметров, блок [`env`](/docs/ru/settings-reference#env) и вспомогательные команды, такие как [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), и [hooks](/docs/ru/hooks#hooks-in-skills-and-agents) проектного skill и [`allowed-tools`](/docs/ru/skills#pre-approve-tools-for-a-skill) | Используется | Используется. Доверие рабочей области никогда не блокирует `allowed-tools` skill в любом сеансе |

734| Правила `permissions.allow` и `additionalDirectories` в `.claude/settings.json` | Не используется до тех пор, пока вы не примете диалог доверия, который появляется снова, перечисляя их | Не используется. Claude Code выводит предупреждение [`this workspace has not been trusted`](/docs/ru/errors#workspace-has-not-been-trusted) в stderr |763| Правила `permissions.allow` и `additionalDirectories` в `.claude/settings.json` | Не используется до тех пор, пока вы не примете диалог доверия, который появляется снова, перечисляя их | Не используется. Claude Code выводит предупреждение [`this workspace has not been trusted`](/docs/ru/errors#workspace-has-not-been-trusted) в stderr |

735| Hooks frontmatter в проектном [subagent](/docs/ru/sub-agents#hooks-in-subagent-frontmatter), проектном плагине [`@skills-dir`](/docs/ru/plugins-reference#skills-directory-plugins) и записях [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces) из репозитория или каталога `--add-dir` | Не используется, и диалог не предлагается | Не используется |764| Hooks frontmatter в проектном [subagent](/docs/ru/sub-agents#hooks-in-subagent-frontmatter), проектном плагине [`@skills-dir`](/docs/ru/plugins/loading#plugins-shared-through-a-repository) и записях [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces) из репозитория или каталога `--add-dir` | Не используется, и диалог не предлагается | Не используется |

736| Встроенные [`mcpServers`](/docs/ru/sub-agents#scope-mcp-servers-to-a-subagent) в frontmatter subagent из репозитория или каталога `--add-dir`. До версии 2.1.238 Claude Code загружал эти серверы в обоих ситуациях | Не используется, и диалог не предлагается | Не используется |765| Встроенные [`mcpServers`](/docs/ru/sub-agents#scope-mcp-servers-to-a-subagent) в frontmatter subagent из репозитория или каталога `--add-dir`. До версии 2.1.238 Claude Code загружал эти серверы в обоих ситуациях | Не используется, и диалог не предлагается | Не используется |

737| Серверы в `.mcp.json`, включая те, которые репозиторий [одобряет в своих собственных параметрах](/docs/ru/mcp#project-server-approvals-and-workspace-trust) | Claude Code спрашивает вас перед подключением. Собственные одобрения репозитория не учитываются | Подключены без запроса, одобрены или нет. SDK загружает их только когда `settingSources` включает параметры проекта. `claude mcp list` в той же папке по-прежнему сообщает о таком сервере как ожидающем |766| Серверы в `.mcp.json`, включая те, которые репозиторий [одобряет в своих собственных параметрах](/docs/ru/mcp#project-server-approvals-and-workspace-trust) | Claude Code спрашивает вас перед подключением. Собственные одобрения репозитория не учитываются | Подключены без запроса, одобрены или нет. SDK загружает их только когда `settingSources` включает параметры проекта. `claude mcp list` в той же папке по-прежнему сообщает о таком сервере как ожидающем |

738| [`headersHelper`](/docs/ru/mcp#trust-a-folder-before-its-headershelper-runs) на сервере в `.mcp.json`. До версии 2.1.238 Claude Code запускал помощника в обоих ситуациях | Не запускается до тех пор, пока вы не примете диалог доверия, который появляется снова, указывая, где объявлен помощник. Claude Code подключает сервер только с его статическими `headers` до этого момента | Не запускается. Claude Code подключает сервер с его статическими `headers` и выводит строку [`headersHelper not run`](/docs/ru/errors#headershelper-not-run) на сервер в stderr |767| [`headersHelper`](/docs/ru/mcp#trust-a-folder-before-its-headershelper-runs) на сервере в `.mcp.json`. До версии 2.1.238 Claude Code запускал помощника в обоих ситуациях | Не запускается до тех пор, пока вы не примете диалог доверия, который появляется снова, указывая, где объявлен помощник. Claude Code подключает сервер только с его статическими `headers` до этого момента | Не запускается. Claude Code подключает сервер с его статическими `headers` и выводит строку [`headersHelper not run`](/docs/ru/errors#headershelper-not-run) на сервер в stderr |

platforms.md +1 −1

Details

54| :- | :- | :- | :- | :- |54| :- | :- | :- | :- | :- |

55| [Dispatch](/docs/ru/desktop#sessions-from-dispatch) | Отправьте задачу из мобильного приложения Claude | Ваша машина (Desktop) | [Свяжите мобильное приложение с Desktop](https://support.claude.com/en/articles/13947068) | Делегирование работы, когда вас нет, минимальная настройка |55| [Dispatch](/docs/ru/desktop#sessions-from-dispatch) | Отправьте задачу из мобильного приложения Claude | Ваша машина (Desktop) | [Свяжите мобильное приложение с Desktop](https://support.claude.com/en/articles/13947068) | Делегирование работы, когда вас нет, минимальная настройка |

56| [Remote Control](/docs/ru/remote-control) | Управляйте запущенной сессией из [claude.ai/code](https://claude.ai/code) или мобильного приложения Claude | Ваша машина (CLI или VS Code) | Запустите `claude remote-control` | Управление текущей работой с другого устройства |56| [Remote Control](/docs/ru/remote-control) | Управляйте запущенной сессией из [claude.ai/code](https://claude.ai/code) или мобильного приложения Claude | Ваша машина (CLI, Desktop или VS Code) | Запустите [`claude remote-control` или `/remote-control`](/docs/ru/remote-control#start-a-remote-control-session) | Управление текущей работой с другого устройства |

57| [Channels](/docs/ru/channels) | Отправляйте события из приложения чата, такого как Telegram или Discord, или с вашего собственного сервера | Ваша машина (CLI) | [Установите плагин канала](/docs/ru/channels#quickstart) или [создайте свой](/docs/ru/channels-reference) | Реагирование на внешние события, такие как сбои CI или сообщения в чате |57| [Channels](/docs/ru/channels) | Отправляйте события из приложения чата, такого как Telegram или Discord, или с вашего собственного сервера | Ваша машина (CLI) | [Установите плагин канала](/docs/ru/channels#quickstart) или [создайте свой](/docs/ru/channels-reference) | Реагирование на внешние события, такие как сбои CI или сообщения в чате |

58| [Slack](/docs/ru/slack) | Упомяните `@Claude` в канале команды | Облако Anthropic | [Установите приложение Slack](/docs/ru/slack#setting-up-claude-code-in-slack) с включенным [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) | PR и рецензии из чата команды |58| [Slack](/docs/ru/slack) | Упомяните `@Claude` в канале команды | Облако Anthropic | [Установите приложение Slack](/docs/ru/slack#setting-up-claude-code-in-slack) с включенным [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) | PR и рецензии из чата команды |

59| [Self-hosted environments](/docs/ru/self-hosted-environments) | Запустите [облачную сессию](/docs/ru/claude-code-on-the-web) и выберите окружение вашей организации | Инфраструктура вашей организации | [Разверните runners](/docs/ru/self-hosted-environments-quickstart), в планах Team и Enterprise | Облачные сессии, которые должны работать внутри вашей сети |59| [Self-hosted environments](/docs/ru/self-hosted-environments) | Запустите [облачную сессию](/docs/ru/claude-code-on-the-web) и выберите окружение вашей организации | Инфраструктура вашей организации | [Разверните runners](/docs/ru/self-hosted-environments-quickstart), в планах Team и Enterprise | Облачные сессии, которые должны работать внутри вашей сети |

plugin-evals.md +19 −4

Details

16* Выявления регрессий при изменении plugin или выпуске новой модели16* Выявления регрессий при изменении plugin или выпуске новой модели

17* Определения того, что plugin вносит в сравнении с отсутствием plugin17* Определения того, что plugin вносит в сравнении с отсутствием plugin

18 18

19Эта страница предназначена для авторов plugin и skills, у которых есть работающий plugin и которые хотят протестировать его поведение, а также для команд, которые ограничивают изменения plugin в CI. Формат кейса отличается от файла `evals/evals.json`, который использует [skill-creator plugin](/docs/ru/skills#run-evals-with-skill-creator). Чтобы создать plugin, см. [Create a plugin](/docs/ru/plugins/create); чтобы проверить файлы plugin на синтаксические и схемные ошибки, а не его поведение, используйте [`claude plugin validate`](/docs/ru/plugins/cli-reference#plugin-validate).19Эта страница предназначена для авторов plugin и skills, у которых есть работающий plugin и которые хотят протестировать его поведение, а также для команд, которые ограничивают изменения plugin в CI. Для итерации над одним skill внутри разговора Claude Code [skill-creator plugin](/docs/ru/skills#run-evals-with-skill-creator) запускает аналогичное сравнение с собственным форматом `evals/evals.json`, и ни один инструмент не читает файлы кейсов другого. Чтобы создать plugin, см. [Create a plugin](/docs/ru/plugins/create); чтобы проверить файлы plugin на синтаксические и схемные ошибки, а не его поведение, используйте [`claude plugin validate`](/docs/ru/plugins/cli-reference#plugin-validate).

20 20

21<Note>21<Note>

22 Каждый запуск eval и каждый judge grader — это реальный вызов модели на вашем аккаунте, учитываемый в использовании вашего плана или счете API, поэтому сначала проверьте [требования](#requirements). Затем [создайте свой первый eval suite](#create-your-first-eval-suite) или перейдите к [Run evals in CI](#run-evals-in-ci), если у вас уже есть один.22 Каждый запуск eval и каждый judge grader — это реальный вызов модели на вашем аккаунте, учитываемый в использовании вашего плана или счете API, поэтому сначала проверьте [требования](#requirements). Затем [создайте свой первый eval suite](#create-your-first-eval-suite) или перейдите к [Run evals in CI](#run-evals-in-ci), если у вас уже есть один.

29Для запуска plugin evals вам нужно:29Для запуска plugin evals вам нужно:

30 30

31* Claude Code v2.1.269 или позже. Запустите `claude --version` для проверки и `claude update` для обновления.31* Claude Code v2.1.269 или позже. Запустите `claude --version` для проверки и `claude update` для обновления.

32* Git 2.31 или позже, если git установлен. Запустите `git --version` для проверки. Со старой версией git, `claude plugin eval` [останавливается перед запуском любого случая](#git-is-too-old-for-claude-plugin-eval). Без git он работает нормально.

32* Директория plugin с манифестом `plugin.json` или `.claude-plugin/plugin.json`, или [skills-directory plugin](/docs/ru/plugins/loading#plugins-shared-through-a-repository).33* Директория plugin с манифестом `plugin.json` или `.claude-plugin/plugin.json`, или [skills-directory plugin](/docs/ru/plugins/loading#plugins-shared-through-a-repository).

33* Та же аутентификация и поставщик модели, которые используют ваши обычные Claude Code сессии. Запуски eval, graders, оцениваемые judge, и `claude plugin eval init` вызывают модель с вашими учетными данными, поэтому они учитываются в пределах использования вашего плана или счета API. Когда команда сообщает стоимость, цифра — это [оценка по прейскуранту](/docs/ru/costs) этих вызовов.34* Та же аутентификация и поставщик модели, которые используют ваши обычные Claude Code сессии. Запуски eval, graders, оцениваемые judge, и `claude plugin eval init` вызывают модель с вашими учетными данными, поэтому они учитываются в пределах использования вашего плана или счета API. Когда команда сообщает стоимость, цифра — это [оценка по прейскуранту](/docs/ru/costs) этих вызовов.

34 35

434| 130 | Прервано. Частичные результаты написаны |435| 130 | Прервано. Частичные результаты написаны |

435| 143 | Завершено, такое как timeout CI |436| 143 | Завершено, такое как timeout CI |

436 437

437Проблемы с написанием или публикацией HTML отчета никогда не изменяют exit код.438Дельта with-minus-without сообщается, но никогда не изменяет exit код, и проблемы с написанием или публикацией HTML отчета тоже не изменяют.

438 439

439Чтобы увидеть, почему кейс оценен низко, запустите его локально без `--json`, чтобы строки прогресса per-run и grader печатались.440Чтобы увидеть, почему кейс оценен низко, запустите его локально без `--json`, чтобы строки прогресса per-run и grader печатались.

440 441

441CI runner также нуждается в этом на месте:442CI runner также нуждается в этом на месте:

442 443

443* **Установка и учетные данные**: CI runner нуждается в Claude Code установке и [учетных данных в окружении](/docs/ru/authentication), такие как `ANTHROPIC_API_KEY`.444* **Установка и учетные данные**: CI runner нуждается в Claude Code установке и [учетных данных в окружении](/docs/ru/authentication), такие как `ANTHROPIC_API_KEY`.

444* **Доверие**: без `--trust-plugin`, работа, чья директория checkout Claude Code еще не доверяет, нуждается в [первом запросе доверия](#security), и запуск, который не может спросить, отказан с exit 1.445* **Доверие**: без `--trust-plugin`, работа, чья директория checkout Claude Code еще не доверяет, нуждается в [первом запросе доверия](#trust-the-plugin-directory), и запуск, который не может спросить, отказан с exit 1.

445* **`init` в CI**: `claude plugin eval init` нуждается в терминале, чтобы задать вам его вопросы; в CI запустите `claude plugin eval init --bare <name>`, чтобы получить пустой шаблон.446* **`init` в CI**: `claude plugin eval init` нуждается в терминале, чтобы задать вам его вопросы; в CI запустите `claude plugin eval init --bare <name>`, чтобы получить пустой шаблон.

446 447

447Чтобы держать стоимости предсказуемыми, дайте быстрым every-change suites только graders, которые не вызывают judge, используйте `--ablation none`, где вам не нужно `Δ`, и оставьте `partial: true` документы и запуски с `skippedPaidGraders` вне любого тренда, который вы составляете.448Чтобы держать стоимости предсказуемыми, дайте быстрым every-change suites только graders, которые не вызывают judge, используйте `--ablation none`, где вам не нужно `Δ`, и оставьте `partial: true` документы и запуски с `skippedPaidGraders` вне любого тренда, который вы составляете.

680 681

681Это первый запуск против директории, которой Claude Code еще не доверяет, и он не может спросить, потому что stdin или stdout не является терминалом, вы передали `--json`, или переменная окружения `CI` установлена на значение true, такое как `true`. Запустите `claude plugin eval <dir>` один раз в терминале и ответьте на запрос, или передайте `--trust-plugin`, если вы доверяете коду plugin и suite. См. [What a run can access](#security).682Это первый запуск против директории, которой Claude Code еще не доверяет, и он не может спросить, потому что stdin или stdout не является терминалом, вы передали `--json`, или переменная окружения `CI` установлена на значение true, такое как `true`. Запустите `claude plugin eval <dir>` один раз в терминале и ответьте на запрос, или передайте `--trust-plugin`, если вы доверяете коду plugin и suite. См. [What a run can access](#security).

682 683

684<h3 id="git-is-too-old-for-claude-plugin-eval">

685 "is too old for claude plugin eval"

686</h3>

687

688`git` на вашем `PATH` старше версии 2.31, поэтому `claude plugin eval` остановился перед запуском любого кейса и вышел с кодом 1 с сообщением, называющим вашу версию:

689

690```text theme={null}

691git 2.30 is too old for claude plugin eval: it ignores the environment configuration (GIT_CONFIG_COUNT, added in git 2.31) that switches off the repository's git hooks and helper programs for the run. Install git 2.31 or newer.

692```

693

694Для каждого запуска Claude Code отключает git hooks, credential helpers и другие программы, которые конфигурация git репозитория может запустить. Это делается через конфигурацию окружения, которую git читает только из версии 2.31. Более старый git игнорирует эту конфигурацию, поэтому suite останавливается, а не оценивает запуски, где эти программы могли бы выполняться. Установите git 2.31 или позже и запустите suite снова.

695

696До версии v2.1.283 `claude plugin eval` не проверял версию git, и на более старом git suite запускался с этими программами оставленными включенными.

697

683<h3 id="no-eval-cases-found">698<h3 id="no-eval-cases-found">

684 "No eval cases found"699 "No eval cases found"

685</h3>700</h3>

733Default `--threshold` — это 1.0, поэтому команда выходит 1, когда любой кейс оценен ниже совершенства. Установите порог, который соответствует требуемой оценке. Exit 1 также охватывает файл кейса, который не загружен, который сообщается на stderr выше таблицы.748Default `--threshold` — это 1.0, поэтому команда выходит 1, когда любой кейс оценен ниже совершенства. Установите порог, который соответствует требуемой оценке. Exit 1 также охватывает файл кейса, который не загружен, который сообщается на stderr выше таблицы.

734 749

735<h3 id="json-output-path-must-end-in-json">750<h3 id="json-output-path-must-end-in-json">

736 "--json output path must end in .json"751 `--json output path must end in .json`

737</h3>752</h3>

738 753

739Вы поместили target после `--json`, поэтому он был прочитан как путь вывода. Поместите target первым, как в `claude plugin eval . --json`, или дайте `--json` явный путь `.json`.754Вы поместили target после `--json`, поэтому он был прочитан как путь вывода. Поместите target первым, как в `claude plugin eval . --json`, или дайте `--json` явный путь `.json`.

plugins/cli-hints.md +2 −2

Details

132 Следующие шаги132 Следующие шаги

133</h2>133</h2>

134 134

135* [Опубликуйте и распространяйте plugin](/docs/ru/plugins/publish): маршруты в каждый marketplace, включая официальный marketplace, который требует подсказка135* [Опубликовать и распространить плагин](/docs/ru/plugins/publish): маршруты для распространения плагина, включая официальный marketplace, который требует подсказка

136* [Справочник команд plugin](/docs/ru/plugins/cli-reference#plugin-install): команда shell, которая устанавливает тот же plugin вне сеанса136* [Справочник команд плагина](/docs/ru/plugins/cli-reference#plugin-install): команда оболочки, которая устанавливает тот же плагин вне сеанса

plugins/cli-reference.md +20 −2

Details

163 163

164Claude Code выводит `Successfully uninstalled plugin: formatter (scope: project)`. Когда плагин не установлен в этой области действия, команда выводит строку, которая начинается с `Failed to uninstall plugin "formatter@my-marketplace":` и выходит с кодом `1`.164Claude Code выводит `Successfully uninstalled plugin: formatter (scope: project)`. Когда плагин не установлен в этой области действия, команда выводит строку, которая начинается с `Failed to uninstall plugin "formatter@my-marketplace":` и выходит с кодом `1`.

165 165

166Если строка ошибки продолжается с `"formatter" was not uninstalled:`, Claude Code не смог подтвердить, что параметры области действия больше не включают плагин, поэтому плагин остаётся установленным со всем, что он сохранил. С `--json` результат содержит `failureCode: "settings_still_on"`. Эта проверка параметров требует Claude Code v2.1.282 или позже.

167

168<h4 id="what-an-uninstall-deletes-and-keeps">

169 Что удаляет и сохраняет удаление

170</h4>

171

172Когда вы удаляете плагин из последней области действия, в которой он установлен, Claude Code также удаляет сохранённые [опции и секреты](/docs/ru/plugins/manifest-reference#user-configuration) плагина и его каталог данных, `~/.claude/plugins/data/<id>/`. Есть три исключения:

173

174* С `--keep-data` каталог данных остаётся

175* Когда другой установленный плагин использует ту же папку, например тот, чей ID отличается от этого только буквой, каталог данных остаётся

176* Когда Claude Code не может прочитать список установленных плагинов обратно после удаления плагина из этой области действия, опции, секреты и каталог данных все остаются, потому что плагин может быть установлен в другой области действия. Удаление всё ещё успешно. Сообщение выводит список того, что осталось и как его удалить, и с `--json` результат содержит `savedKept: "install_records_unreadable"`

177

178С `--json` `keptData` сообщает, остался ли каталог, и `/plugin` показывает `· data preserved`, когда он остался. Для каталога, который остаётся без `--keep-data`, это сообщение требует Claude Code v2.1.281 или позже. Поле `savedKept` требует Claude Code v2.1.282 или позже.

179

166<h3 id="plugin-enable">180<h3 id="plugin-enable">

167 plugin enable181 plugin enable

168</h3>182</h3>

246 260

247| Флаг | Описание |261| Флаг | Описание |

248| :- | :- |262| :- | :- |

249| `-s, --scope <scope>` | Область действия для обновления: `user`, `project`, `local` или `managed`. По умолчанию область действия, в которой установлен плагин |263| `-s, --scope <scope>` | Область действия для обновления: `user`, `project`, `local` или `managed`. Автоопределяется при пропуске |

250| `-y, --yes` | Примите изменённую команду установки из плагина [command-source](/docs/ru/plugins/host-marketplace) без запроса. Требуется, когда stdin или stdout не является TTY, если вы не передаёте `--accept-command`. Требует Claude Code v2.1.229 или позже |264| `-y, --yes` | Примите изменённую команду установки из плагина [command-source](/docs/ru/plugins/host-marketplace) без запроса. Требуется, когда stdin или stdout не является TTY, если вы не передаёте `--accept-command`. Требует Claude Code v2.1.229 или позже |

251| `--accept-command <sha256>` | Примите команду, объявленную маркетплейсом, чей `sha256` предыдущий запуск [`--json`](#plugin-json-result) сообщил в `shownCommand`, вместо `-y`. Не может быть объединён с `-y`. Требует Claude Code v2.1.271 или позже |265| `--accept-command <sha256>` | Примите команду, объявленную маркетплейсом, чей `sha256` предыдущий запуск [`--json`](#plugin-json-result) сообщил в `shownCommand`, вместо `-y`. Не может быть объединён с `-y`. Требует Claude Code v2.1.271 или позже |

252| `--json` | Выведите результат как один JSON объект на последней строке stdout в [том же формате, что и `plugin install --json`](#plugin-json-result). Требует Claude Code v2.1.268 или позже |266| `--json` | Выведите результат как один JSON объект на последней строке stdout в [том же формате, что и `plugin install --json`](#plugin-json-result). Требует Claude Code v2.1.268 или позже |

253 267

268Если вы опустите `--scope`, команда обновляет плагин в наиболее специфичной области действия, в которой он установлен для вашего текущего проекта, проверяя local, project, user, затем managed.

269

270До v2.1.281 команда использовала `user`, когда вы опускали `--scope`, поэтому обновление плагина, установленного только в области действия project или local, не выполнялось с `Plugin "<name>" is not installed at scope user`. На этих версиях передайте `--scope`.

271

254`managed` — это единственная область действия, которую вы можете обновить, но не установить. Для плагинов, установленных администратором, см. [Управление плагинами для вашей организации](/docs/ru/plugins/org).272`managed` — это единственная область действия, которую вы можете обновить, но не установить. Для плагинов, установленных администратором, см. [Управление плагинами для вашей организации](/docs/ru/plugins/org).

255 273

256Обновите плагин:274Обновите плагин:

557 575

558* **`SKILL.md` в корне плагина**: когда вы запускаете `claude plugin validate` против каталога плагина, Claude Code не проверяет `SKILL.md` в корне плагина576* **`SKILL.md` в корне плагина**: когда вы запускаете `claude plugin validate` против каталога плагина, Claude Code не проверяет `SKILL.md` в корне плагина

559* **`CLAUDE.md` в корне плагина**: в запуске плагина Claude Code также предупреждает о `CLAUDE.md` в корне плагина577* **`CLAUDE.md` в корне плагина**: в запуске плагина Claude Code также предупреждает о `CLAUDE.md` в корне плагина

560* **Файлы плагина в запуске маркетплейса**: из каталога маркетплейса Claude Code не открывает файлы skill, agent, command или hook плагинов. Чтобы найти ошибки в этих файлах, проверьте каждый каталог плагина578* **Файлы плагина в запуске маркетплейса**: из каталога маркетплейса Claude Code не открывает файлы skill, agent, command или hook плагинов или файлы MCP сервера, которые они объединяют. Чтобы найти ошибки в этих файлах, проверьте каждый каталог плагина

561 579

562<h4 id="output-and-exit-codes">580<h4 id="output-and-exit-codes">

563 Выход и коды выхода581 Выход и коды выхода

plugins/components.md +4 −4

Details

413 413

414 * **Создание вашего первого плагина**: начните с [Create a plugin](/docs/ru/plugins/create)414 * **Создание вашего первого плагина**: начните с [Create a plugin](/docs/ru/plugins/create)

415 * **Установка плагина кого-то другого**: см. [Install plugins](/docs/ru/plugins/install)415 * **Установка плагина кого-то другого**: см. [Install plugins](/docs/ru/plugins/install)

416 * **Ваши пользователи плагина находятся на claude.ai или в Cowork**: там загружается другой набор компонентов. См. [Plugins on claude.ai and in Cowork](https://claude.com/docs/plugins/overview)416 * **Ваши пользователи плагина находятся на claude.ai или в Cowork**: там загружается другой набор компонентов. См. [Plugin structure and testing](https://claude.com/docs/plugins/build) и [component support table](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app)

417</Note>417</Note>

418 418

419<h2 id="explore-the-plugin-directory">419<h2 id="explore-the-plugin-directory">

436 436

437<PluginExplorer>437<PluginExplorer>

438 <Piece id="manifest">438 <Piece id="manifest">

439 [Манифест](/docs/ru/plugins/manifest-reference) — это файл `plugin.json` в директории `.claude-plugin/` плагина. Он содержит метаданные плагина и значения `userConfig`, которые Claude Code запрашивает у пользователя. Обязателен только `name`. В этом примере `description` — это текст, который пользователи видят для плагина в `/plugin`, а `version` удерживает пользователей на этой версии, пока вы её не измените:439 [Манифест](/docs/ru/plugins/manifest-reference) — это файл `plugin.json` в директории `.claude-plugin/` плагина. Он содержит метаданные плагина и значения `userConfig`, которые Claude Code запрашивает у пользователя. Claude Code загружает плагин без него, но [каталог Anthropic](/docs/ru/plugins/publish#submit-to-anthropics-directory) требует его. В файле обязателен только `name`. В этом примере `description` — это текст, который пользователи видят для плагина в `/plugin`, а `version` удерживает пользователей на этой версии, пока вы её не измените:

440 440

441 ```json theme={null}441 ```json theme={null}

442 {442 {

838 Достижение пользователей на claude.ai и Cowork838 Достижение пользователей на claude.ai и Cowork

839</h4>839</h4>

840 840

841Локальный сервер stdio, такой как сервер `db` под [MCP servers](#mcp-servers), работает в Claude Code и в сессии Cowork, которая работает на вашей машине в приложении Claude Desktop, но не на claude.ai. Чтобы достичь пользователей там тоже, ссылайтесь на удалённый сервер по его URL `https://`, который claude.ai и Cowork предлагают пользователю как соединитель.841Локальный сервер stdio, такой как сервер `db` под [MCP servers](#mcp-servers), работает в Claude Code и в сессии Cowork, которая работает на вашей машине в приложении Claude Desktop, но не на claude.ai. Чтобы достичь пользователей там тоже, ссылайтесь на удалённый сервер по его URL `https://`, который claude.ai и Cowork предлагают пользователю как соединитель, как показано в [Bundle an MCP connector with its skill](https://claude.com/docs/plugins/build#bundle-an-mcp-connector-with-its-skill).

842 842

843<h4 id="server-names-tool-names-and-reloads">843<h4 id="server-names-tool-names-and-reloads">

844 Имена серверов, имена инструментов и перезагрузки844 Имена серверов, имена инструментов и перезагрузки

918 918

919Директории `bin/` плагина идут после собственных записей `PATH` пользователя, поэтому плагин не может затенять `git`, `ls` или другую системную команду.919Директории `bin/` плагина идут после собственных записей `PATH` пользователя, поэтому плагин не может затенять `git`, `ls` или другую системную команду.

920 920

921claude.ai и Cowork не устанавливают плагин, который имеет директорию `bin/` верхнего уровня, включая тот, который вы [распространяете через параметры организации claude.ai](/docs/ru/plugins/host-marketplace#distribute-through-organization-settings).921claude.ai и Cowork не устанавливают плагин, который имеет директорию `bin/` верхнего уровня, включая тот, который вы [распространяете через параметры организации claude.ai](https://claude.com/docs/plugins/org-sync#keep-executables-out-of-the-top-level-bin-directory).

922 922

923<h3 id="default-settings">923<h3 id="default-settings">

924 Параметры по умолчанию924 Параметры по умолчанию

plugins/create.md +8 −4

Details

15 15

16 * **Установка плагина другого человека**: см. [Установка плагинов](/docs/ru/plugins/install)16 * **Установка плагина другого человека**: см. [Установка плагинов](/docs/ru/plugins/install)

17 * **Не уверены, нужен ли вам плагин**: см. [Решите, нужен ли вам плагин](/docs/ru/plugins/overview#decide-whether-you-need-a-plugin) в обзоре17 * **Не уверены, нужен ли вам плагин**: см. [Решите, нужен ли вам плагин](/docs/ru/plugins/overview#decide-whether-you-need-a-plugin) в обзоре

18 * **Пользователи вашего плагина находятся на claude.ai или в Cowork**: одна и та же папка устанавливается там с другим подмножеством компонентов. См. [Плагины на claude.ai и в Cowork](https://claude.com/docs/plugins/overview)18 * **Пользователи вашего плагина находятся на claude.ai или в Cowork**: одна и та же папка устанавливается там с другим подмножеством компонентов. См. [Plugin structure and testing](https://claude.com/docs/plugins/build) и [component support table](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app)

19</Note>19</Note>

20 20

21Начните с раздела, который соответствует тому, что у вас уже есть:21Начните с раздела, который соответствует тому, что у вас уже есть:

132 132

133Плагин загружается только в сессиях, которые вы запускаете с `--plugin-dir`. Чтобы продолжить работу над ним без флага или протестировать сборку `.zip`, см. [Разработка без marketplace](#develop-without-a-marketplace).133Плагин загружается только в сессиях, которые вы запускаете с `--plugin-dir`. Чтобы продолжить работу над ним без флага или протестировать сборку `.zip`, см. [Разработка без marketplace](#develop-without-a-marketplace).

134 134

135Чтобы Claude создал каркас и проверил более крупный плагин вместе с вами, [установите](/docs/ru/plugins/install#install-a-plugin) плагин `plugin-dev` от Anthropic из marketplace `claude-plugins-official`, который добавляет skills и agents для написания компонентов, таких как skills, hooks и MCP серверы, и для проверки готового плагина. После установки запустите `/plugin-dev:create-plugin`, за которым следует описание плагина, который вы хотите, и Claude проведёт вас через проектирование, создание и проверку.

136

135<h3 id="share-the-plugin">137<h3 id="share-the-plugin">

136 Поделитесь своим плагином138 Поделитесь своим плагином

137</h3>139</h3>

140 142

141* **Отправьте его нескольким людям напрямую**: дайте им директорию плагина или `.zip` её, и ничего не нужно публиковать. См. [Поделитесь плагином без marketplace](/docs/ru/plugins/publish#share-a-plugin-without-a-marketplace).143* **Отправьте его нескольким людям напрямую**: дайте им директорию плагина или `.zip` её, и ничего не нужно публиковать. См. [Поделитесь плагином без marketplace](/docs/ru/plugins/publish#share-a-plugin-without-a-marketplace).

142* **Перечислите его в своём собственном marketplace**: коллеги добавляют ваш marketplace один раз и устанавливают плагин по имени, и они получают ваши обновления. См. [Опубликуйте через свой собственный marketplace](/docs/ru/plugins/publish#publish-through-your-own-marketplace).144* **Перечислите его в своём собственном marketplace**: коллеги добавляют ваш marketplace один раз и устанавливают плагин по имени, и они получают ваши обновления. См. [Опубликуйте через свой собственный marketplace](/docs/ru/plugins/publish#publish-through-your-own-marketplace).

143* **Отправьте его на community marketplace Anthropic**: после того как он будет указан, любой, кто добавит этот marketplace, сможет его установить. См. [Отправьте на community marketplace](/docs/ru/plugins/publish#submit-to-the-community-marketplace).145* **Отправьте его в справочник Anthropic**: после того как он пройдёт проверку, люди смогут добавить его на claude.ai и в Cowork, и он достигнет Claude Code через их учётную запись. См. [Отправьте в справочник Anthropic](/docs/ru/plugins/publish#submit-to-anthropics-directory).

144 146

145<h3 id="plugin-layout">147<h3 id="plugin-layout">

146 Макет плагина148 Макет плагина

201 203

202Если папка не имеет директории `.claude-plugin/` и нет компонентов плагина на её верхнем уровне, Claude Code рассматривает её как папку плагинов. Каждая непосредственная подпапка, которая имеет манифест `.claude-plugin/plugin.json`, затем загружается как отдельный плагин. Всё остальное в папке пропускается без ошибки, включая подпапку, которая не имеет манифеста. Если плагин в папке не загружается, проверьте, что его подпапка имеет `.claude-plugin/plugin.json`.204Если папка не имеет директории `.claude-plugin/` и нет компонентов плагина на её верхнем уровне, Claude Code рассматривает её как папку плагинов. Каждая непосредственная подпапка, которая имеет манифест `.claude-plugin/plugin.json`, затем загружается как отдельный плагин. Всё остальное в папке пропускается без ошибки, включая подпапку, которая не имеет манифеста. Если плагин в папке не загружается, проверьте, что его подпапка имеет `.claude-plugin/plugin.json`.

203 205

206Вы также можете передать папку, которая хранит `.claude-plugin/marketplace.json` рядом с папками плагинов. Пока эта директория `.claude-plugin/` не содержит `plugin.json`, папки плагинов всё ещё загружаются. Ничего не устанавливается и не включается из файла marketplace, потому что Claude Code его не читает. Загрузка плагинов из такой папки требует Claude Code v2.1.281 или позже.

207

204В интерактивной сессии вы также можете добавлять и удалять плагины в папке после запуска:208В интерактивной сессии вы также можете добавлять и удалять плагины в папке после запуска:

205 209

206* Подпапка, которую вы добавляете, загружается как новый плагин, как только существует её манифест.210* Подпапка, которую вы добавляете, загружается как новый плагин, как только существует её манифест.

417 421

418* [Компоненты плагина](/docs/ru/plugins/components): добавьте agents, hooks, MCP серверы, LSP серверы и конфигурацию пользователя в ваш плагин422* [Компоненты плагина](/docs/ru/plugins/components): добавьте agents, hooks, MCP серверы, LSP серверы и конфигурацию пользователя в ваш плагин

419* [Протестируйте плагины с evals](/docs/ru/plugin-evals): напишите случаи eval и запустите их с `claude plugin eval` для проверки того, насколько надёжно плагин направляет поведение Claude423* [Протестируйте плагины с evals](/docs/ru/plugin-evals): напишите случаи eval и запустите их с `claude plugin eval` для проверки того, насколько надёжно плагин направляет поведение Claude

420* [Опубликуйте плагин](/docs/ru/plugins/publish): версионируйте его, поместите его в marketplace и отправьте на community marketplace424* [Опубликуйте плагин](/docs/ru/plugins/publish): версионируйте его, поместите его в marketplace и отправьте на рецензирование

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

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

423* [Skills](/docs/ru/skills): напишите skills, которые предоставляет ваш плагин427* [Skills](/docs/ru/skills): напишите skills, которые предоставляет ваш плагин

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

plugins/create-marketplace.md +1 −1

Details

14 Эти случаи рассмотрены на других страницах:14 Эти случаи рассмотрены на других страницах:

15 15

16 * **Совместное использование одного плагина с несколькими людьми**: отправьте им каталог плагина или его `.zip`. См. [Совместное использование плагина без marketplace](/docs/ru/plugins/publish#share-a-plugin-without-a-marketplace).16 * **Совместное использование одного плагина с несколькими людьми**: отправьте им каталог плагина или его `.zip`. См. [Совместное использование плагина без marketplace](/docs/ru/plugins/publish#share-a-plugin-without-a-marketplace).

17 * **Предложение плагина всем**: отправьте его в community marketplace Anthropic. См. [Отправка в community marketplace](/docs/ru/plugins/publish#submit-to-the-community-marketplace).17 * **Предложение плагина всем**: отправьте его в community marketplace Anthropic. См. [Отправка в community marketplace](/docs/ru/plugins/publish#submit-to-anthropics-directory).

18 * **Использование плагина самостоятельно**: загрузите его с помощью `--plugin-dir` или сохраните в каталог skills. См. [Разработка без marketplace](/docs/ru/plugins/create#develop-without-a-marketplace).18 * **Использование плагина самостоятельно**: загрузите его с помощью `--plugin-dir` или сохраните в каталог skills. См. [Разработка без marketplace](/docs/ru/plugins/create#develop-without-a-marketplace).

19</Note>19</Note>

20 20

plugins/host-marketplace.md +3 −3

Details

89Organization sync более строг к репозиторию, чем `/plugin marketplace add`:89Organization sync более строг к репозиторию, чем `/plugin marketplace add`:

90 90

91* **Репозиторий Marketplace**: на github.com и gitlab.com он должен быть приватным или внутренним91* **Репозиторий Marketplace**: на github.com и gitlab.com он должен быть приватным или внутренним

92* **Источники плагинов**: каждый источник плагина должен быть типа `github`, `url` или `git-subdir`, или [относительный путь](/docs/ru/plugins/marketplace-reference#relative-path-plugin-source), который начинается с `./`92* **Источники плагинов**: organization sync принимает только некоторые [типы источников](/docs/ru/plugins/marketplace-reference#plugin-sources)

93* **Каталог `bin/` верхнего уровня**: claude.ai отклоняет плагин, который его имеет, и синхронизирует остальную часть marketplace. Сообщение об ошибке начинается с `Plugin contains a top-level bin/ directory`. Держите исполняемые файлы в другом каталоге, таком как `scripts/`, и ссылайтесь на них как `${CLAUDE_PLUGIN_ROOT}/scripts/<name>` из ваших hooks или конфигов MCP сервера93* **Каталог `bin/` верхнего уровня**: claude.ai отклоняет плагин, который его имеет, и синхронизирует остальную часть marketplace. Сообщение об ошибке начинается с `Plugin contains a top-level bin/ directory`. Держите исполняемые файлы в другом каталоге, таком как `scripts/`, и ссылайтесь на них как `${CLAUDE_PLUGIN_ROOT}/scripts/<name>` из ваших hooks или конфигов MCP сервера

94 94

~~95Смотрите [Manage plugins for your organization](https://support.claude.com/en/articles/13837433) для рабочего процесса администратора.~~95[Sync your organization's plugins from a repository](https://claude.com/docs/plugins/org-sync) на claude.com содержит список принятых источников, настройку GitLab и ошибку `bin/`, а [Manage plugins for your organization](https://claude.com/docs/plugins/admin) охватывает рабочий процесс администратора.

96 96

97<h2 id="grant-access-to-a-private-marketplace">97<h2 id="grant-access-to-a-private-marketplace">

98 Grant access to a private marketplace98 Grant access to a private marketplace

113 113

114Для хоста GitHub Enterprise Server пользователям нужен доступ git к этому хосту с их машины. Смотрите [Plugin marketplaces on GHES](/docs/ru/github-enterprise-server#plugin-marketplaces-on-ghes) для того, что каждой поверхности Claude Code нужно, чтобы достичь marketplace, размещенного на GHES.114Для хоста GitHub Enterprise Server пользователям нужен доступ git к этому хосту с их машины. Смотрите [Plugin marketplaces on GHES](/docs/ru/github-enterprise-server#plugin-marketplaces-on-ghes) для того, что каждой поверхности Claude Code нужно, чтобы достичь marketplace, размещенного на GHES.

115 115

116Если вы распространяете через **Organization settings > Plugins & skills** на claude.ai вместо этого, учетные данные git ваших пользователей не задействованы. Смотрите [Distribute through organization settings](#distribute-through-organization-settings) для того, какие источники плагинов могут быть приватными там.116Если вы распространяете через **Organization settings > Plugins & skills** на claude.ai вместо этого, учетные данные git ваших пользователей не задействованы. Смотрите [Distribute through organization settings](#distribute-through-organization-settings).

117 117

118<h3 id="serve-users-who-have-no-git-host-account">118<h3 id="serve-users-who-have-no-git-host-account">

119 Serve users who have no git-host account119 Serve users who have no git-host account

plugins/install.md +1 −1

Details

143Область установки плагина определяет, кто получает плагин и какой файл настроек записывает его как включённый:143Область установки плагина определяет, кто получает плагин и какой файл настроек записывает его как включённый:

144 144

145* **User scope**: плагин включен для вас в каждом проекте на этой машине. Запись идёт в `enabledPlugins` в `~/.claude/settings.json`.145* **User scope**: плагин включен для вас в каждом проекте на этой машине. Запись идёт в `enabledPlugins` в `~/.claude/settings.json`.

146* **Project scope**: плагин включен для всех, кто работает в этом репозитории. Запись идёт в `.claude/settings.json`, который вы коммитите.146* **Project scope**: плагин включен для всех, кто работает в этом репозитории. Запись идёт в `.claude/settings.json`, который вы коммитите. Коммитинг этой записи включает плагин для ваших сотрудников, но не загружает его на их машины, поэтому каждый сотрудник также запускает `claude plugin install <name>@<marketplace> --scope project` один раз; см. [Enabled in project settings but not installed](/docs/ru/plugins/loading#enabled-in-project-settings-but-not-installed).

147* **Local scope**: плагин включен для вас только в этом репозитории. Запись идёт в `.claude/settings.local.json`.147* **Local scope**: плагин включен для вас только в этом репозитории. Запись идёт в `.claude/settings.local.json`.

148 148

149Некоторые плагины установлены их автором на запуск в отключённом состоянии через поле [`defaultEnabled`](/docs/ru/plugins/manifest-reference#defaultenabled). Такой плагин установлен, но остаётся отключённым, пока вы не включите его с помощью `claude plugin enable <name>` в вашей оболочке или со вкладки **Installed** в `/plugin` в сессии.149Некоторые плагины установлены их автором на запуск в отключённом состоянии через поле [`defaultEnabled`](/docs/ru/plugins/manifest-reference#defaultenabled). Такой плагин установлен, но остаётся отключённым, пока вы не включите его с помощью `claude plugin enable <name>` в вашей оболочке или со вкладки **Installed** в `/plugin` в сессии.

plugins/loading.md +2 −2

Details

100 100

101В сеансах терминала навыки, агенты, hooks, MCP серверы и LSP серверы синхронизированного плагина все загружаются с тем же доверием, что и плагин маркетплейса, который вы установили.101В сеансах терминала навыки, агенты, hooks, MCP серверы и LSP серверы синхронизированного плагина все загружаются с тем же доверием, что и плагин маркетплейса, который вы установили.

102 102

103О компонентах, которые загружает Cowork, см. [Плагины на claude.ai и в Cowork](https://claude.com/docs/plugins/overview) на claude.com.103О компонентах, которые загружает Cowork, см. [таблицу поддержки компонентов](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app) на claude.com.

104 104

105Синхронизированные плагины загружаются в сеансах Cowork и в сеансах терминала, где вы входите с помощью своей учётной записи claude.ai:105Синхронизированные плагины загружаются в сеансах Cowork и в сеансах терминала, где вы входите с помощью своей учётной записи claude.ai:

106 106

184| Путь | Что он содержит |184| Путь | Что он содержит |

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

186| `cache/<marketplace>/<plugin>/<version>/` | Один каталог на установленную версию плагина маркетплейса. `<plugin>` — это имя записи маркетплейса и `<version>` — это [разрешённая версия](#versions-and-updates). `${CLAUDE_PLUGIN_ROOT}` указывает на этот каталог |186| `cache/<marketplace>/<plugin>/<version>/` | Один каталог на установленную версию плагина маркетплейса. `<plugin>` — это имя записи маркетплейса и `<version>` — это [разрешённая версия](#versions-and-updates). `${CLAUDE_PLUGIN_ROOT}` указывает на этот каталог |

187| `data/<plugin-id>/` | Постоянный каталог плагина, открытый как `${CLAUDE_PLUGIN_DATA}`. О том, как формируется `<plugin-id>`, см. [Переменные пути и постоянные данные](/docs/ru/plugins/components#path-variables-and-persistent-data). Claude Code создаёт его, когда компонент плагина впервые его использует, и сохраняет его при обновлениях. Claude Code удаляет его, когда вы удаляете плагин из его последней области, если вы не передаёте `--keep-data` |187| `data/<plugin-id>/` | Постоянный каталог плагина, открытый как `${CLAUDE_PLUGIN_DATA}`. О том, как формируется `<plugin-id>`, см. [Переменные пути и постоянные данные](/docs/ru/plugins/components#path-variables-and-persistent-data). Claude Code создаёт его, когда компонент плагина впервые его использует, и сохраняет его при обновлениях. По умолчанию Claude Code удаляет его, когда вы удаляете плагин из его последней области. О `--keep-data` и других случаях, когда он остаётся, см. [удаление плагина](/docs/ru/plugins/cli-reference#plugin-uninstall) |

188| `marketplaces/<name>/` | Клон или загрузка маркетплейса, добавленного с GitHub, другого хоста Git или URL. Маркетплейс, добавленный из локального источника `file` или `directory`, не имеет копии здесь, и его `installLocation` в `known_marketplaces.json` — это путь, который вы дали |188| `marketplaces/<name>/` | Клон или загрузка маркетплейса, добавленного с GitHub, другого хоста Git или URL. Маркетплейс, добавленный из локального источника `file` или `directory`, не имеет копии здесь, и его `installLocation` в `known_marketplaces.json` — это путь, который вы дали |

190| `.trash/` | Плагины, которые синхронизация claude.ai удалила, например, после того как вы отключили один на claude.ai или прекратили синхронизацию |190| `.trash/` | Плагины, которые синхронизация claude.ai удалила, например, после того как вы отключили один на claude.ai или прекратили синхронизацию |

plugins/manifest-reference.md +19 −10

Details

116* **`Validation passed with warnings`**: манифест загружается, но валидатор нашел что-то для исправления, например неизвестное поле верхнего уровня, которое Claude Code удаляет, `name`, который не в kebab-case, или отсутствующие `version`, `description` или `author`. Передайте `--strict`, чтобы превратить предупреждения в ошибки в CI116* **`Validation passed with warnings`**: манифест загружается, но валидатор нашел что-то для исправления, например неизвестное поле верхнего уровня, которое Claude Code удаляет, `name`, который не в kebab-case, или отсутствующие `version`, `description` или `author`. Передайте `--strict`, чтобы превратить предупреждения в ошибки в CI

117* **`Validation failed`**: манифест имеет несоответствие типов, путь, который отсутствует или выходит за пределы корня плагина, или неизвестный ключ внутри опции `userConfig`, записи `channels`, конфигурации `lspServers` или записи `monitors`. Claude Code сообщает о той же проблеме при загрузке плагина117* **`Validation failed`**: манифест имеет несоответствие типов, путь, который отсутствует или выходит за пределы корня плагина, или неизвестный ключ внутри опции `userConfig`, записи `channels`, конфигурации `lspServers` или записи `monitors`. Claude Code сообщает о той же проблеме при загрузке плагина

118 118

119Команда также проверяет каждую запись MCP-сервера, которую плагин объявляет в `.mcp.json`, в файле `.json`, который называет [`mcpServers`](#mcpservers), или встроенную в `plugin.json`. Эти проверки MCP требуют Claude Code v2.1.281 или более поздней версии и включают:

120

121* **Ошибки**: запись, которую Claude Code удалит при загрузке плагина, ссылка `${user_config.KEY}` на опцию, которую манифест не объявляет, и удаленный `url`, который не является действительным абсолютным URL

122* **Предупреждения**: URL `http://` или `ws://` на хост, не являющийся loopback, и значение заголовка, которое выглядит как буквальные учетные данные

123

119<h2 id="fields">124<h2 id="fields">

120 Поля125 Поля

121</h2>126</h2>

387 Содержание и существование392 Содержание и существование

388</h3>393</h3>

389 394

390Каждый путь компонента должен разрешаться внутри корня плагина и должен существовать. `claude plugin validate` не проверяет пути `outputStyles`, `lspServers`, `monitors` или `themes`, поэтому плохой путь в этих полях не загружается только при загрузке плагина:395Каждый путь компонента должен разрешаться внутри корня плагина и должен существовать. `claude plugin validate` проверяет пути под каждым ключом компонента:

391 396

392* **Содержание**: путь, который разрешается вне корня плагина, не загружается, и вкладка `/plugin` **Errors** показывает `<component> path escapes plugin directory: <path>`. Путь, содержащий `..`, — обычный случай, и `claude plugin validate` сообщает об этом как `Path contains ".." which could be a path traversal attempt`397* **Содержание**: путь, который разрешается вне корня плагина, не загружается, и вкладка `/plugin` **Errors** показывает `<component> path escapes plugin directory: <path>`. Путь, содержащий `..`, — обычный случай, и `claude plugin validate` сообщает об ошибке `Path contains ".." which could be a path traversal attempt`

393* **Существование**: путь, который не существует, не загружается, и вкладка `/plugin` **Errors** показывает `<component> path not found: <path>`. `claude plugin validate` сообщает об этом как `Path not found`398* **Существование**: путь, который не существует, не загружается, и вкладка `/plugin` **Errors** показывает `<component> path not found: <path>`. `claude plugin validate` сообщает об ошибке `Path not found`

399

400Для путей `outputStyles`, `lspServers`, `monitors` и `themes` проверка `claude plugin validate` требует Claude Code v2.1.283 или более поздней версии.

394 401

395<h3 id="how-each-key-combines-with-its-default-location">402<h3 id="how-each-key-combines-with-its-default-location">

396 Как каждый ключ объединяется с его расположением по умолчанию403 Как каждый ключ объединяется с его расположением по умолчанию

561 568

562`${CLAUDE_PLUGIN_ROOT}` изменяется при обновлении плагина, поэтому не записывайте состояние туда. Для того, где корень перемещается и когда старая директория очищается, см. [страницу загрузки](/docs/ru/plugins/loading).569`${CLAUDE_PLUGIN_ROOT}` изменяется при обновлении плагина, поэтому не записывайте состояние туда. Для того, где корень перемещается и когда старая директория очищается, см. [страницу загрузки](/docs/ru/plugins/loading).

563 570

564Когда вы удаляете плагин из последнего места, где он установлен, директория `${CLAUDE_PLUGIN_DATA}` удаляется, если вы не передадите [`--keep-data`](/docs/ru/plugins/cli-reference).571По умолчанию Claude Code удаляет директорию `${CLAUDE_PLUGIN_DATA}` при удалении плагина из последнего места, где он установлен. Для `--keep-data` и других случаев, когда она сохраняется, см. [удаление плагина](/docs/ru/plugins/cli-reference#plugin-uninstall).

565 572

566<h3 id="where-each-variable-resolves">573<h3 id="where-each-variable-resolves">

567 Где каждая переменная разрешается574 Где каждая переменная разрешается

571 578

572| Компонент плагина | Поля, где `${...}` разрешается | Экспортируется в процесс |579| Компонент плагина | Поля, где `${...}` разрешается | Экспортируется в процесс |

573| :- | :- | :- |580| :- | :- | :- |

580 587

581Переменные отсутствуют в окружении команд, которые Claude запускает через инструмент Bash, в основном сеансе или в подагенте. В содержимом skill, команды и агента напишите ссылку `${...}` в теле Markdown вместо этого, и Claude Code подставляет путь встроенным образом при загрузке содержимого.588Переменные отсутствуют в окружении команд, которые Claude запускает через инструмент Bash, в основном сеансе или в подагенте. В содержимом skill, команды и агента напишите ссылку `${...}` в теле Markdown вместо этого, и Claude Code подставляет путь встроенным образом при загрузке содержимого.

582 589

586 593

587Сохраняйте каждый подставленный путь одним аргументом:594Сохраняйте каждый подставленный путь одним аргументом:

588 595

589* **Команды Hook**: используйте [exec form](/docs/ru/hooks#exec-form-and-shell-form) с `args`, чтобы каждый путь был одним аргументом без кавычек596* **Hook команды**: используйте [exec form](/docs/ru/hooks#exec-form-and-shell-form) с `args`, чтобы каждый путь был одним аргументом без кавычек

590* **Shell-form hooks и команды монитора**: оберните переменную в двойные кавычки, чтобы путь с пробелами оставался одним словом597* **Shell-form hooks и monitor команды**: оберните переменную в двойные кавычки, чтобы путь с пробелами оставался одним словом

598

599Если вы оставите одну из этих переменных вне кавычек в shell-form команде в файле hooks, `claude plugin validate` выдаст предупреждение, если только hook не устанавливает [`shell`](/docs/ru/hooks#command-hook-fields) на `"powershell"`.

591 600

592Этот shell-form hook запускает скрипт, поставляемый с плагином:601Этот shell-form hook запускает скрипт, поставляемый с плагином:

593 602

632| Исполняемые файлы | `bin/` | Файлы здесь находятся на `PATH` инструмента Bash при включении плагина, поэтому Claude запускает их как простые команды. claude.ai и Cowork не устанавливают плагин, который имеет эту директорию, включая тот, который вы [распространяете через параметры организации claude.ai](/docs/ru/plugins/host-marketplace#distribute-through-organization-settings) |641| Исполняемые файлы | `bin/` | Файлы здесь находятся на `PATH` инструмента Bash при включении плагина, поэтому Claude запускает их как простые команды. claude.ai и Cowork не устанавливают плагин, который имеет эту директорию, включая тот, который вы [распространяете через параметры организации claude.ai](https://claude.com/docs/plugins/org-sync#keep-executables-out-of-the-top-level-bin-directory) |

634 643

635Плагин, который использует каждое расположение по умолчанию, плюс папку `scripts/`, которую вызывают его hooks, расположен следующим образом:644Плагин, который использует каждое расположение по умолчанию, плюс папку `scripts/`, которую вызывают его hooks, расположен следующим образом:

plugins/marketplace-reference.md +3 −1

Details

47* **Имена официального marketplace**: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `life-sciences`, `knowledge-work-plugins`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins` и `claude-tag-plugins`. Зарезервированы, если только marketplace не поступает из источника `github` или `git` [marketplace source](#marketplace-sources) под `github.com/anthropics/`.47* **Имена официального marketplace**: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `life-sciences`, `knowledge-work-plugins`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins` и `claude-tag-plugins`. Зарезервированы, если только marketplace не поступает из источника `github` или `git` [marketplace source](#marketplace-sources) под `github.com/anthropics/`.

48* **Имена community marketplace**: `claude-community`, `claude-plugins-community` и `healthcare`. Зарезервированы по тому же правилу, что и официальные имена.48* **Имена community marketplace**: `claude-community`, `claude-plugins-community` и `healthcare`. Зарезервированы по тому же правилу, что и официальные имена.

49* **Имена директории плагинов**: `anthropic-plugin-directory` и `claude-plugin-directory`. Зарезервированы по тому же правилу, что и официальные имена.49* **Имена директории плагинов**: `anthropic-plugin-directory` и `claude-plugin-directory`. Зарезервированы по тому же правилу, что и официальные имена.

50* **Имена, выдающие себя за официальный marketplace**: имена такие как `official-claude-plugins` или `claude-plugins-v2`, и любое имя, содержащее символ, отличный от ASCII. Ошибка: `Marketplace name impersonates an official Anthropic/Claude marketplace`. Управляющий символ или символ двунаправленного форматирования в имени также сообщает `Marketplace name cannot contain control or bidirectional-formatting characters`.50* **Имена, выдающие себя за официальный marketplace**: имена такие как `official-claude-plugins` или `claude-plugins-v2`, и любое имя, содержащее символ, отличный от ASCII. Ошибка: `Marketplace name impersonates an official Anthropic/Claude marketplace`. Управляющий символ или символ двунаправленного форматирования в имени также сообщает `Marketplace name cannot contain control or bidirectional-formatting characters`. Marketplace, уже зарегистрированный под таким именем, перестаёт загружаться, вместе с его плагинами.

51* <span id="reserved-name-spellings" />**Другое написание зарезервированного имени**: имя, которое отличается от зарезервированного имени только конечной точкой, или символом, отличным от подчёркивания, вместо дефиса, поэтому `claude.code.plugins` считается `claude-code-plugins`. `claude plugin validate` принимает такое имя; добавление marketplace завершается ошибкой [`is another spelling of "<reserved>", a reserved marketplace name`](/docs/ru/errors#marketplace-name-is-another-spelling-of-a-reserved-name), и marketplace, уже зарегистрированный под одним, перестаёт загружаться. Эта проверка требует Claude Code v2.1.280 или позже.51* <span id="reserved-name-spellings" />**Другое написание зарезервированного имени**: имя, которое отличается от зарезервированного имени только конечной точкой, или символом, отличным от подчёркивания, вместо дефиса, поэтому `claude.code.plugins` считается `claude-code-plugins`. `claude plugin validate` принимает такое имя; добавление marketplace завершается ошибкой [`is another spelling of "<reserved>", a reserved marketplace name`](/docs/ru/errors#marketplace-name-is-another-spelling-of-a-reserved-name), и marketplace, уже зарегистрированный под одним, перестаёт загружаться. Эта проверка требует Claude Code v2.1.280 или позже.

52* **Имена, которые Claude Code использует для плагинов, которые не поступают из marketplace**: `inline` для плагинов, загруженных с [`--plugin-dir`](/docs/ru/cli-reference), `builtin` для встроенных плагинов, `skills-dir` для плагинов, автоматически загруженных из [`.claude/skills/`](/docs/ru/skills), и `synced` для плагинов, синхронизированных с вашего аккаунта claude.ai. `claude-plugin-test` также зарезервирован. `skills-dir` также появляется как `{"source": "skills-dir"}` в `strictKnownMarketplaces` и `blockedMarketplaces`, описанные в разделе [Source values valid only in policy lists](#source-values-valid-only-in-policy-lists).52* **Имена, которые Claude Code использует для плагинов, которые не поступают из marketplace**: `inline` для плагинов, загруженных с [`--plugin-dir`](/docs/ru/cli-reference), `builtin` для встроенных плагинов, `skills-dir` для плагинов, автоматически загруженных из [`.claude/skills/`](/docs/ru/skills), и `synced` для плагинов, синхронизированных с вашего аккаунта claude.ai. `claude-plugin-test` также зарезервирован. `skills-dir` также появляется как `{"source": "skills-dir"}` в `strictKnownMarketplaces` и `blockedMarketplaces`, описанные в разделе [Source values valid only in policy lists](#source-values-valid-only-in-policy-lists).

53* **`npm`, `pip`, `uv`, `cargo`, `github` и `gh`**: зарезервированы в любом регистре. Эта проверка требует Claude Code v2.1.275 или позже.53* **`npm`, `pip`, `uv`, `cargo`, `github` и `gh`**: зарезервированы в любом регистре. Эта проверка требует Claude Code v2.1.275 или позже.

54* **Имена, начинающиеся с `claudeai-`**: зарезервированы для marketplace, размещённых на claude.ai. `claude plugin marketplace add` отказывает любому другому marketplace, который использует один с `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.54* **Имена, начинающиеся с `claudeai-`**: зарезервированы для marketplace, размещённых на claude.ai. `claude plugin marketplace add` отказывает любому другому marketplace, который использует один с `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.

55 55

56Когда зарегистрированный marketplace перестаёт загружаться, потому что его имя имитирует официальное, `claude plugin list` и `/plugin` сообщают `Claude Code refuses the marketplace name "<name>"`. Сообщение говорит вам удалить marketplace. Удаление его также удаляет его плагины и удаляет их сохранённые данные. Это именованное сообщение об отказе требует Claude Code v2.1.282 или позже.

56<h2 id="top-level-fields">58<h2 id="top-level-fields">

57 Поля верхнего уровня59 Поля верхнего уровня

58</h2>60</h2>

plugins/measure.md +2 −0

Details

96* **Это товарищи по команде, которых вы можете спросить**: собственный Claude Code каждого пользователя показывает им, используют ли они все еще плагин, в четырех местах: панель [`/plugin`](#not-used-recently-in-/plugin), [`/skill-doctor`](#find-skills-that-never-run), [`/doctor`](#unused-plugins-in-/doctor) и [`/usage`](#usage-share-in-/usage). Все четыре — это команды, которые пользователь запускает в приглашении Claude Code в сеансе на своей собственной машине.96* **Это товарищи по команде, которых вы можете спросить**: собственный Claude Code каждого пользователя показывает им, используют ли они все еще плагин, в четырех местах: панель [`/plugin`](#not-used-recently-in-/plugin), [`/skill-doctor`](#find-skills-that-never-run), [`/doctor`](#unused-plugins-in-/doctor) и [`/usage`](#usage-share-in-/usage). Все четыре — это команды, которые пользователь запускает в приглашении Claude Code в сеансе на своей собственной машине.

97* **Ни то, ни другое**: у вас нет сигнала об использовании Claude Code для этого плагина.97* **Ни то, ни другое**: у вас нет сигнала об использовании Claude Code для этого плагина.

98 98

99Для использования плагина, указанного в каталоге Anthropic, см. [Track published plugin usage](https://claude.com/docs/connectors/building/after-publishing#track-published-plugin-usage) на claude.com.

100

99<h3 id="not-used-recently-in-/plugin">101<h3 id="not-used-recently-in-/plugin">

100 Не использовалось недавно в `/plugin`102 Не использовалось недавно в `/plugin`

101</h3>103</h3>

plugins/org.md +2 −1

Details

14 Эти случаи рассматриваются на других страницах:14 Эти случаи рассматриваются на других страницах:

15 15

16 * **Установка плагинов для себя**: начните с [Установка плагинов](/docs/ru/plugins/install)16 * **Установка плагинов для себя**: начните с [Установка плагинов](/docs/ru/plugins/install)

17 * **Контроль, какие плагины члены могут использовать в claude.ai и Cowork**: см. [Управление плагинами для вашей организации](https://support.claude.com/en/articles/13837433) в справочном центре17 * **Контроль, какие плагины члены могут использовать в claude.ai и Cowork**: см. [Управление плагинами для вашей организации](https://claude.com/docs/plugins/admin) на claude.com

18 * **Развертывание одного плагина в claude.ai, Cowork и Claude Code вместе**: см. [Выберите маршрут развертывания](https://claude.com/docs/plugins/org-rollout#choose-a-rollout-route) на claude.com

18 * **Страница плагинов в параметрах администратора claude.ai**: [**Organization settings > Plugins & skills**](https://claude.ai/admin-settings/skills?tab=inventory) включает плагины для учетных записей claude.ai членов, и они достигают Claude Code как [синхронизированные плагины](/docs/ru/plugins/loading#synced-plugins). Это не устанавливает ни один из ключей на этой странице19 * **Страница плагинов в параметрах администратора claude.ai**: [**Organization settings > Plugins & skills**](https://claude.ai/admin-settings/skills?tab=inventory) включает плагины для учетных записей claude.ai членов, и они достигают Claude Code как [синхронизированные плагины](/docs/ru/plugins/loading#synced-plugins). Это не устанавливает ни один из ключей на этой странице

19</Note>20</Note>

20 21

plugins/overview.md +6 −3

Details

9Claude Code plugin — это директория skills, agents, hooks, MCP servers или других компонентов, которые Claude Code устанавливает и загружает как одну единицу. Большинство plugins поступают из marketplace, который представляет собой каталог, в котором перечислены plugins и указано, где получить каждый из них. Вы также можете загрузить plugin из папки, которую вам дал кто-то другой, или [создать свой собственный](/docs/ru/plugins/create).9Claude Code plugin — это директория skills, agents, hooks, MCP servers или других компонентов, которые Claude Code устанавливает и загружает как одну единицу. Большинство plugins поступают из marketplace, который представляет собой каталог, в котором перечислены plugins и указано, где получить каждый из них. Вы также можете загрузить plugin из папки, которую вам дал кто-то другой, или [создать свой собственный](/docs/ru/plugins/create).

10 10

11<Note>11<Note>

~~12 Если вы используете claude.ai chat или Cowork, а не Claude Code, см. [Plugins на claude.ai и в Cowork](https://claude.com/docs/plugins/overview).~~12 Начните на claude.com, если вы относитесь к одной из этих категорий:

14 * **Вы используете claude.ai chat или Cowork, а не Claude Code**: см. [Plugins на claude.ai и в Cowork](https://claude.com/docs/plugins/overview)

15 * **Вы создали MCP server и хотите его в директории Anthropic**: см. [Опубликовать в директории](https://claude.com/docs/directory/publish)

13</Note>16</Note>

14 17

15Чтобы попробовать plugin прямо сейчас, запустите `/plugin` в сеансе терминала Claude Code и установите один из вкладки **Discover**, на которой перечислены plugins из официального marketplace Anthropic и любого marketplace, который вы добавили. Оттуда:18Чтобы попробовать plugin прямо сейчас, запустите `/plugin` в сеансе терминала Claude Code и установите один из вкладки **Discover**, на которой перечислены plugins из официального marketplace Anthropic и любого marketplace, который вы добавили. Оттуда:

122Облачный сеанс, включая сеанс в браузере на claude.ai/code, не загружает plugins в ваши локальные settings. Для шагов установки в терминале, VS Code и настольном приложении, а также для того, что загружает облачный сеанс, см. [Install a plugin](/docs/ru/plugins/install#install-a-plugin).125Облачный сеанс, включая сеанс в браузере на claude.ai/code, не загружает plugins в ваши локальные settings. Для шагов установки в терминале, VS Code и настольном приложении, а также для того, что загружает облачный сеанс, см. [Install a plugin](/docs/ru/plugins/install#install-a-plugin).

123 126

124<Note>127<Note>

125 Тот же формат plugin также устанавливается на claude.ai и в Cowork, где загружается другой набор компонентов. Для этих поверхностей см. [Plugins на claude.ai и в Cowork](https://claude.com/docs/plugins/overview) на claude.com.128 Тот же формат plugin также устанавливается на claude.ai и в Cowork, где загружается другой набор компонентов. Для этих поверхностей см. [Plugins на claude.ai и в Cowork](https://claude.com/docs/plugins/overview) на claude.com и его [таблицу поддержки компонентов](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app).

126</Note>129</Note>

127 130

128<h2 id="next-steps">131<h2 id="next-steps">

135 138

136После установки или создания plugin эти страницы охватывают то, что дальше:139После установки или создания plugin эти страницы охватывают то, что дальше:

137 140

138* **Поделитесь тем, что вы создали**: [Publish and distribute a plugin](/docs/ru/plugins/publish)141* **Поделитесь тем, что вы создали**: [Publish and distribute a plugin](/docs/ru/plugins/publish), через ваш собственный marketplace или [Anthropic's directory](/docs/ru/plugins/publish#submit-to-anthropics-directory)

139* **Проверьте, работает ли он и используется ли**: [Test plugins with evals](/docs/ru/plugin-evals) и [Measure plugin cost and usage](/docs/ru/plugins/measure)142* **Проверьте, работает ли он и используется ли**: [Test plugins with evals](/docs/ru/plugin-evals) и [Measure plugin cost and usage](/docs/ru/plugins/measure)

140* **Запустите marketplace для вашей команды**: [Create a marketplace](/docs/ru/plugins/create-marketplace), затем [Host and maintain a marketplace](/docs/ru/plugins/host-marketplace)143* **Запустите marketplace для вашей команды**: [Create a marketplace](/docs/ru/plugins/create-marketplace), затем [Host and maintain a marketplace](/docs/ru/plugins/host-marketplace)

141* **Установите политику plugin для организации**: [Manage plugins for your organization](/docs/ru/plugins/org)144* **Установите политику plugin для организации**: [Manage plugins for your organization](/docs/ru/plugins/org)

plugins/publish.md +21 −18

Details

4 4

5# Публикация и распространение плагина5# Публикация и распространение плагина

6 6

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

8 8

9Публикация плагина Claude Code означает его размещение в маркетплейсе — каталоге JSON, который содержит список плагинов и указывает, откуда получить каждый из них, чтобы другие люди могли установить его по имени и получать ваши обновления. Вы можете запустить собственный маркетплейс или отправить свой плагин в маркетплейс сообщества Anthropic. Чтобы поделиться плагином без публикации, отправьте людям папку плагина или файл `.zip` для самостоятельной загрузки.9Публикация плагина Claude Code означает его размещение в маркетплейсе — каталоге JSON, который содержит список плагинов и указывает, откуда получить каждый из них, чтобы другие люди могли установить его по имени и получать ваши обновления. Вы можете запустить собственный маркетплейс или отправить свой плагин в каталог Anthropic. Чтобы поделиться плагином без публикации, отправьте людям папку плагина или файл `.zip` для самостоятельной загрузки.

10 10

11Эта страница предназначена для автора готового плагина, который готов поделиться им.11Эта страница предназначена для автора готового плагина, который готов поделиться им.

12 12

29| :- | :- | :- | :- |29| :- | :- | :- | :- |

31| [Собственный маркетплейс](#publish-through-your-own-marketplace) | Любой, кто может получить доступ к репозиторию, который может быть приватным, который может клонировать ваша команда | Репозиторий git или другой хост с файлом `.claude-plugin/marketplace.json`, который содержит список вашего плагина | Выключено |31| [Собственный маркетплейс](#publish-through-your-own-marketplace) | Любой, кто может получить доступ к репозиторию, который может быть приватным, который может клонировать ваша команда | Репозиторий git или другой хост с файлом `.claude-plugin/marketplace.json`, который содержит список вашего плагина | Выключено |

32| [Маркетплейс сообщества Anthropic](#submit-to-the-community-marketplace) | Любой, кто добавит `anthropics/claude-plugins-community` | Отправка через форму отправки каталога плагинов | Выключено |32| [Маркетплейс Anthropic](#submit-to-anthropics-directory) | Люди, которые добавляют его на claude.ai или в Cowork. Он также загружается в их сеансах Claude Code через [синхронизацию учётной записи](/docs/ru/plugins/loading#synced-plugins) | Репозиторий GitHub, содержащий плагин, и платный план claude.ai для отправки | Да, после публикации отправленной вами версии |

33 33

34Автоматическое обновление — это параметр маркетплейса на стороне пользователя, который получает новые версии в фоновом режиме.34Автоматическое обновление — это параметр маркетплейса на стороне пользователя, который получает новые версии в фоновом режиме.

35 35

141 141

142[Установка плагинов](/docs/ru/plugins/install) охватывает команды на стороне пользователя, а [когда запускается автоматическое обновление](/docs/ru/plugins/loading#when-auto-update-runs) охватывает время.142[Установка плагинов](/docs/ru/plugins/install) охватывает команды на стороне пользователя, а [когда запускается автоматическое обновление](/docs/ru/plugins/loading#when-auto-update-runs) охватывает время.

143 143

144<h2 id="submit-to-the-community-marketplace">144<h2 id="submit-to-anthropics-directory">

145 Отправить в сообщество marketplace145 Отправить в справочник Anthropic

146</h2>146</h2>

147 147

148Сообщество marketplace Anthropic, `claude-community`, — это публичный marketplace, в котором перечислены плагины, отправленные через форму отправки каталога плагинов.148Справочник Anthropic — это каталог, который люди просматривают на claude.ai и в Cowork для добавления плагинов и коннекторов. Одно объявление там достигает людей на claude.ai, в Cowork и в Claude Code. Вы отправляете из портала разработчика на [claude.ai/directory/manage](https://claude.ai/directory/manage); [Подготовка к проверке](https://claude.com/docs/directory/publish#prepare-for-review) на claude.com описывает, что происходит с каждой версией перед её публикацией.

149 149

150Пользователи добавляют сообщество marketplace в сеанс Claude Code с помощью `/plugin marketplace add anthropics/claude-plugins-community` и устанавливают его как `@claude-community`.150Отправка требует платный план claude.ai. На Pro и Max вы отправляете со своего собственного аккаунта. На Team и Enterprise владелец может отправлять, а на Enterprise владелец также может предоставить разрешение **Directory** другим членам через пользовательскую роль в разделе **Organization settings > Roles**. См. [Подтвердите, что вы можете отправлять в справочник](https://claude.com/docs/directory/publish#confirm-you-can-submit-to-the-directory).

151 151

152О том, чем сообщество marketplace отличается от официального marketplace, см. [Marketplaces Anthropic](/docs/ru/plugins/anthropic-marketplaces).152Этапы отправки, проверки, которые должна пройти каждая версия, и что происходит после публикации, задокументированы на claude.com, потому что они одинаковы независимо от того, на какой поверхности находятся ваши пользователи:

153 153

154Чтобы отправить ваш плагин в сообщество marketplace, используйте одну из встроенных форм:154* [Опубликовать в справочнике](https://claude.com/docs/directory/publish#before-you-submit-to-the-directory): что вы можете отправить и кто может это отправить

155* [Отправить плагин](https://claude.com/docs/plugins/submit#submit-a-plugin): этапы портала и [обновление опубликованного плагина](https://claude.com/docs/plugins/submit#update-a-published-plugin)

156* [Контрольный список перед отправкой плагина](https://claude.com/docs/plugins/pre-submission-checklist#run-the-checks-before-you-submit): проверки для запуска и исправления перед отправкой

157* [Переместить более раннюю отправку на портал разработчика](https://claude.com/docs/directory/publish#move-an-earlier-submission-to-the-developer-portal): что делать, если вы отправили плагин через одну из более ранних форм отправки, до того как портал существовал

155 158

156* **claude.ai**: [claude.ai/admin-settings/directory/submissions/plugins/new](https://claude.ai/admin-settings/directory/submissions/plugins/new)159Перед открытием портала проверьте локально и убедитесь, какие из ваших компонентов загружаются вне Claude Code:

157* **Console**: [platform.claude.com/plugins/submit](https://platform.claude.com/plugins/submit)

158 160

159Форма claude.ai требует организацию Team или Enterprise и разрешение Directory, которое по умолчанию имеют владельцы. Отдельные авторы, которые не являются частью организации Team или Enterprise, могут вместо этого использовать форму Console.161* **Запустите `claude plugin validate ./your-plugin --strict` в вашей оболочке**: замените `./your-plugin` на путь к каталогу вашего плагина. Команда перехватывает ошибки манифеста локально; [plugin validate](/docs/ru/plugins/cli-reference#plugin-validate) перечисляет, какие файлы читает каждый запуск. Портал применяет дополнительные правила справочника, которые CLI не проверяет, поэтому чистый локальный запуск не гарантирует чистую валидацию портала.

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

160 163

161В вашей оболочке запустите `claude plugin validate ./your-plugin` локально перед отправкой, заменив `./your-plugin` на путь к каталогу вашего плагина. Когда валидация пройдена успешно, Claude Code выводит `✔ Validation passed`, или `✔ Validation passed with warnings`, если есть предупреждения. Предупреждения не приводят к сбою валидации; добавьте `--strict`, чтобы рассматривать их как ошибки.164Официальный marketplace Anthropic, `claude-plugins-official`, не принимает отправки через портал справочника. Если вы работаете с контактом партнёра Anthropic, попросите у них информацию об объявлении в официальном marketplace.

162 165

163Перечисленные плагины появляются в каталоге [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community), в подавляющем большинстве случаев закреплённые на определённом коммите SHA.166<h3 id="how-a-listed-plugin-reaches-claude-code-users">

~~164~~ 167 Как перечисленный плагин достигает пользователей Claude Code

165Может быть задержка между отправкой и появлением вашего плагина в `marketplace.json`. Чтобы проверить, доступен ли ваш плагин для установки, найдите его имя в [каталоге сообщества](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/marketplace.json).168</h3>

166 169

167Официальный marketplace, `claude-plugins-official`, не принимает отправки через эти формы. Если вы работаете с контактом партнёра Anthropic, попросите у них информацию о размещении в официальном marketplace.170Человек, который устанавливает ваш плагин из справочника на claude.ai, имеет его на своём аккаунте, и Claude Code загружает его как `<name>@synced`. [Плагины, синхронизированные с claude.ai](/docs/ru/plugins/loading#synced-plugins) охватывает то, что они видят и как они его отключают.

168 171

169<h2 id="ship-updates-renames-and-removals">172<h2 id="ship-updates-renames-and-removals">

170 Отправка обновлений, переименований и удалений173 Отправка обновлений, переименований и удалений

174 Выпустите новую версию177 Выпустите новую версию

175</h3>178</h3>

176 179

177Если вы публикуете через собственный маркетплейс и ваш `plugin.json` устанавливает `version`, увеличьте его и отправьте. Пользователи, которые запускают `claude plugin update` или имеют включенное автоматическое обновление, получают новую версию, как описано в [Отправка обновлений пользователям](#ship-updates-to-users).180Если вы публикуете через собственный маркетплейс и ваш `plugin.json` устанавливает `version`, увеличьте его и отправьте. Пользователи, которые запускают `claude plugin update` или имеют включенное автоматическое обновление, получают новую версию, как описано в разделе [Отправка обновлений пользователям](#ship-updates-to-users). Для справки по каталогу см. [Обновление опубликованного плагина](https://claude.com/docs/plugins/submit#update-a-published-plugin).

178 181

179<h3 id="tag-a-release">182<h3 id="tag-a-release">

180 Отметьте выпуск183 Отметьте выпуск

plugins/security.md +1 −1

Details

118 118

119В вашей shell выполните [`claude plugin uninstall <plugin>`](/docs/ru/plugins/cli-reference#plugin-uninstall) с `--scope`, в котором вы его установили. Затем проверьте, что удалила деинсталляция и что она оставила:119В вашей shell выполните [`claude plugin uninstall <plugin>`](/docs/ru/plugins/cli-reference#plugin-uninstall) с `--scope`, в котором вы его установили. Затем проверьте, что удалила деинсталляция и что она оставила:

120 120

121* **Постоянные данные**: когда это был последний scope, в котором был установлен плагин, деинсталляция также удаляет директорию постоянных данных плагина, если вы не передадите `--keep-data`.121* **Постоянные данные**: по умолчанию, когда это был последний scope, в котором был установлен плагин, деинсталляция также удаляет директорию постоянных данных плагина. Для `--keep-data` и других случаев, когда она остаётся, см. [plugin uninstall](/docs/ru/plugins/cli-reference#plugin-uninstall).

122* **Кэшированные файлы**: файлы плагина остаются на диске под `~/.claude/plugins/cache/` в течение 14 дней, прежде чем [фоновая очистка их удалит](/docs/ru/plugins/loading#cleanup-of-previous-versions). После деинсталляции последнего плагина orphaned директории остаются, пока вы не установите другой. Чтобы удалить файлы сейчас, удалите директорию плагина под `~/.claude/plugins/cache/<marketplace>/<plugin>/` самостоятельно.122* **Кэшированные файлы**: файлы плагина остаются на диске под `~/.claude/plugins/cache/` в течение 14 дней, прежде чем [фоновая очистка их удалит](/docs/ru/plugins/loading#cleanup-of-previous-versions). После деинсталляции последнего плагина orphaned директории остаются, пока вы не установите другой. Чтобы удалить файлы сейчас, удалите директорию плагина под `~/.claude/plugins/cache/<marketplace>/<plugin>/` самостоятельно.

123* **Marketplace**: если вы также не доверяете владельцу marketplace, [удалите marketplace](/docs/ru/plugins/install#manage-marketplaces) тоже, что деинсталлирует каждый плагин, который вы установили из него.123* **Marketplace**: если вы также не доверяете владельцу marketplace, [удалите marketplace](/docs/ru/plugins/install#manage-marketplaces) тоже, что деинсталлирует каждый плагин, который вы установили из него.

124 124

plugins/troubleshooting.md +11 −1

Details

676 `Failed to load hooks from <path>` и hooks, которые не срабатывают676 `Failed to load hooks from <path>` и hooks, которые не срабатывают

677</h3>677</h3>

678 678

679Hooks плагина не запускаются. Либо вкладка **Errors** показывает ошибку загрузки для них, hooks загружаются и вы видите уведомления `<Event> hook error` в стенограмме, либо hook загружается без ошибки и никогда не срабатывает.679Hooks плагина не запускаются, или один блокирует действие. Либо вкладка **Errors** показывает ошибку загрузки для них, hooks загружаются и вы видите уведомления `<Event> hook error` или блокирующую ошибку в стенограмме, либо hook загружается без ошибки и никогда не срабатывает.

680 680

681<h4 id="hooks-fail-to-load">681<h4 id="hooks-fail-to-load">

682 Hooks не загружаются682 Hooks не загружаются

693 693

694Уведомление формы `... hook error: Failed with non-blocking status code: <stderr>` означает, что hook запустился и его команда не удалась. Например, `Stop hook error: Failed with non-blocking status code: /bin/sh: node: command not found` означает, что оболочка, которую Claude Code создал, не смогла найти `node`. Установите его или убедитесь, что он находится в `PATH` терминала, из которого вы запускаете `claude`.694Уведомление формы `... hook error: Failed with non-blocking status code: <stderr>` означает, что hook запустился и его команда не удалась. Например, `Stop hook error: Failed with non-blocking status code: /bin/sh: node: command not found` означает, что оболочка, которую Claude Code создал, не смогла найти `node`. Установите его или убедитесь, что он находится в `PATH` терминала, из которого вы запускаете `claude`.

695 695

696Если stderr показывает путь плагина, обрезанный в пробеле, команда hook в форме shell использует `${CLAUDE_PLUGIN_ROOT}` вне кавычек и путь установки содержит пробел. Оберните переменную в двойные кавычки или используйте [форму exec](/docs/ru/hooks#exec-form-and-shell-form). Чтобы найти неквотированную переменную, запустите `claude plugin validate` в каталоге плагина и ищите его [предупреждение о кавычках](/docs/ru/plugins/manifest-reference#quoting-and-path-separators).

697

696Для любой другой ошибки запустите команду hook самостоятельно из каталога плагина, чтобы увидеть полный вывод, или захватите полный stderr с помощью [отладочного логирования](/docs/ru/hooks#debug-hooks).698Для любой другой ошибки запустите команду hook самостоятельно из каталога плагина, чтобы увидеть полный вывод, или захватите полный stderr с помощью [отладочного логирования](/docs/ru/hooks#debug-hooks).

697 699

700<h4 id="a-plugin-hook-blocks-a-tool-call-or-prompt">

701 Hook плагина блокирует вызов инструмента или подсказку

702</h4>

703

704Hook, который выходит с кодом 2, [блокирует действие, для которого он запустился](/docs/ru/hooks#exit-code-2). Когда hook плагина блокирует таким образом и его stderr является блокирующим сообщением, ошибка заканчивается с `This hook comes from the <plugin> plugin.` чтобы вы знали, какой плагин отключить или исправить. До v2.1.281 ошибка не называла плагин.

705

706Если это сообщение показывает путь плагина, обрезанный в пробеле, примените [исправление неквотированного `${CLAUDE_PLUGIN_ROOT}`](#hook-error-notices-in-the-transcript).

707

698<h4 id="hook-loads-but-never-fires">708<h4 id="hook-loads-but-never-fires">

699 Hook загружается, но никогда не срабатывает709 Hook загружается, но никогда не срабатывает

700</h4>710</h4>

prompt-caching.md +31 −19

Details

37Два параметра не отображаются в таблице слоёв, но всё ещё влияют на то, что остаётся в кэше:37Два параметра не отображаются в таблице слоёв, но всё ещё влияют на то, что остаётся в кэше:

38 38

39* **Model**: каждая модель имеет свой кэш. Переключение моделей пересчитывает весь запрос даже когда содержимое идентично. Подробнее см. в разделе [Переключение моделей](#switching-models) ниже.39* **Model**: каждая модель имеет свой кэш. Переключение моделей пересчитывает весь запрос даже когда содержимое идентично. Подробнее см. в разделе [Переключение моделей](#switching-models) ниже.

40* **Effort level**: на большинстве моделей каждый уровень усилий имеет свой кэш, поэтому изменение усилий во время сеанса пересчитывает весь запрос. На Opus 5.5 и Fable 5.1 с API ключом или подпиской Claude кэш по умолчанию остаётся нетронутым. Подробнее см. в разделе [Изменение уровня усилий](#changing-effort-level) ниже.40* **Effort level**: на большинстве моделей каждый уровень усилий имеет свой кэш, поэтому изменение усилий во время сеанса пересчитывает весь запрос. На Opus 5.5, Sonnet 5.5 и Fable 5.1 с API ключом или подпиской Claude кэш по умолчанию остаётся нетронутым. Подробнее см. в разделе [Изменение уровня усилий](#changing-effort-level) ниже.

41 41

42<Tip>42<Tip>

43 Выберите вашу модель и уровень усилий в начале сеанса, затем сохраните `/compact` для естественных перерывов между задачами. Чем меньше изменений вы делаете во время задачи, тем выше ваш процент попаданий в кэш.43 Выберите вашу модель и уровень усилий в начале сеанса, затем сохраните `/compact` для естественных перерывов между задачами. Чем меньше изменений вы делаете во время задачи, тем выше ваш процент попаданий в кэш.

75* [Переключение моделей](#switching-models)75* [Переключение моделей](#switching-models)

76* [Изменение уровня усилий](#changing-effort-level)76* [Изменение уровня усилий](#changing-effort-level)

77* [Включение быстрого режима](#turning-on-fast-mode)77* [Включение быстрого режима](#turning-on-fast-mode)

~~78* [Подключение или отключение MCP сервера](#connecting-or-disconnecting-an-mcp-server)~~78* [Подключение или удаление MCP сервера](#connecting-or-removing-an-mcp-server)

79* [Включение или отключение плагина](#enabling-or-disabling-a-plugin)79* [Включение или отключение плагина](#enabling-or-disabling-a-plugin)

80* [Отказ от всего инструмента](#denying-an-entire-tool)80* [Отказ от всего инструмента](#denying-an-entire-tool)

81* [Сжатие разговора](#compacting-the-conversation)81* [Сжатие разговора](#compacting-the-conversation)

96 96

97Параметр модели [`opusplan`](/docs/ru/model-config#opusplan-model-setting) разрешается в Opus во время режима плана и Sonnet во время выполнения, поэтому каждое переключение режима плана является переключением модели и запускает свежий кэш.97Параметр модели [`opusplan`](/docs/ru/model-config#opusplan-model-setting) разрешается в Opus во время режима плана и Sonnet во время выполнения, поэтому каждое переключение режима плана является переключением модели и запускает свежий кэш.

98 98

99[Automatic model fallback](/docs/ru/model-config#automatic-model-fallback) на моделях Fable, Opus 5.5 и Opus 5 также является переключением модели. Когда классификатор безопасности помечает запрос в категории, которая имеет резервную модель, Claude Code повторно запускает запрос на этой модели и сеанс продолжается там.99[Automatic model fallback](/docs/ru/model-config#automatic-model-fallback) на моделях Fable, Opus 5.5, Sonnet 5.5 и Opus 5 также является переключением модели. Когда классификатор безопасности помечает запрос в категории, которая имеет резервную модель, Claude Code повторно запускает запрос на этой модели и сеанс продолжается там.

100 100

101Когда frontmatter навыка или команды указывает [`model`](/docs/ru/skills#frontmatter-reference), отличный от текущей модели сеанса, этот ход также является переключением модели: следующий запрос читает всю историю разговора без попаданий в кэш. Модель сеанса возобновляется при вашем следующем запросе. Навык `context: fork` устанавливает [модель разветвленного подагента](/docs/ru/skills#run-skills-in-a-subagent) вместо этого.101Когда frontmatter навыка или команды указывает [`model`](/docs/ru/skills#frontmatter-reference), отличный от текущей модели сеанса, этот ход также является переключением модели: следующий запрос читает всю историю разговора без попаданий в кэш. Модель сеанса возобновляется при вашем следующем запросе. Навык `context: fork` устанавливает [модель разветвленного подагента](/docs/ru/skills#run-skills-in-a-subagent) вместо этого.

102 102

106 106

107На большинстве моделей изменение [уровня усилий](/docs/ru/model-config#adjust-effort-level) в середине сеанса означает, что следующий запрос читает всю историю разговора без попаданий в кэш. Пока кэш еще теплый, Claude Code просит вас сначала подтвердить изменение.107На большинстве моделей изменение [уровня усилий](/docs/ru/model-config#adjust-effort-level) в середине сеанса означает, что следующий запрос читает всю историю разговора без попаданий в кэш. Пока кэш еще теплый, Claude Code просит вас сначала подтвердить изменение.

108 108

109На Opus 5.5 и Fable 5.1 с ключом API или подпиской Claude изменение усилий сохраняет кэш, и Claude Code применяет новый уровень без запроса. Это не применяется на Amazon Bedrock, платформе Google Cloud Agent Platform или [Claude apps gateway](/docs/ru/claude-apps-gateway), или когда вы установили [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) или ваша организация имеет конфигурацию HIPAA.109На Opus 5.5, Sonnet 5.5 и Fable 5.1 с ключом API или подпиской Claude изменение усилий сохраняет кэш, и Claude Code применяет новый уровень без запроса. Это не применяется на Amazon Bedrock, платформе Google Cloud Agent Platform или [Claude apps gateway](/docs/ru/claude-apps-gateway), или когда вы установили [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) или ваша организация имеет конфигурацию HIPAA.

110 110

111До версии v2.1.260 изменение усилий на Fable 5.1 с ключом API или подпиской Claude также инвалидировало кэш.111До версии v2.1.260 изменение усилий на Fable 5.1 с ключом API или подпиской Claude также инвалидировало кэш.

112 112

116 116

117Включение [fast mode](/docs/ru/fast-mode) добавляет заголовок запроса, который является частью ключа кэша, поэтому первый запрос, который Claude Code отправляет с включенным fast mode, читает всю историю разговора без попаданий в кэш. Claude Code устанавливает этот заголовок один раз при запуске хода и сохраняет его для всего хода, поэтому когда вы включаете fast mode во время работы Claude, пропуск кэша из заголовка происходит при первом запросе вашего следующего хода. Эти некэшированные входные токены выставляются по [fast mode rates](/docs/ru/fast-mode#understand-the-cost-tradeoff), поэтому включение его в начале сеанса стоит меньше, чем включение его глубоко в длинный сеанс. Если ваша текущая модель не поддерживает fast mode, включение fast mode также [переключает вашу модель](#switching-models), и это переключение запускает свежий кэш самостоятельно с следующего запроса в текущем ходе.117Включение [fast mode](/docs/ru/fast-mode) добавляет заголовок запроса, который является частью ключа кэша, поэтому первый запрос, который Claude Code отправляет с включенным fast mode, читает всю историю разговора без попаданий в кэш. Claude Code устанавливает этот заголовок один раз при запуске хода и сохраняет его для всего хода, поэтому когда вы включаете fast mode во время работы Claude, пропуск кэша из заголовка происходит при первом запросе вашего следующего хода. Эти некэшированные входные токены выставляются по [fast mode rates](/docs/ru/fast-mode#understand-the-cost-tradeoff), поэтому включение его в начале сеанса стоит меньше, чем включение его глубоко в длинный сеанс. Если ваша текущая модель не поддерживает fast mode, включение fast mode также [переключает вашу модель](#switching-models), и это переключение запускает свежий кэш самостоятельно с следующего запроса в текущем ходе.

118 118

119Стоимость применяется один раз за разговор. После первого хода fast mode Claude Code продолжает отправлять заголовок и варьирует только параметр скорости запроса, который не является частью ключа кэша. Отключение fast mode, [автоматический откат к стандартной скорости](/docs/ru/fast-mode#handle-rate-limits) после ограничения скорости и повторное включение позже все сохраняют кэш. Если вы [исчерпаете кредиты использования](/docs/ru/fast-mode#handle-rate-limits) в середине сеанса, Claude Code повторяет каждый отклоненный запрос fast mode на стандартной скорости таким же образом, поэтому этот откат также сохраняет кэш. `/clear` и `/compact` сбрасывают это, так как они все равно перестраивают кэш в этих точках.119Стоимость применяется один раз за разговор. После первого хода fast mode Claude Code продолжает отправлять заголовок и варьирует только параметр скорости запроса, который не является частью ключа кэша. Отключение fast mode, [автоматический откат к стандартной скорости](/docs/ru/fast-mode#handle-rate-limits) после ограничения скорости и повторное включение позже все сохраняют кэш. Если вы [исчерпаете кредиты использования](/docs/ru/fast-mode#handle-rate-limits) в середине сеанса, Claude Code повторяет каждый отклоненный запрос fast mode на стандартной скорости таким же образом, поэтому этот откат также сохраняет кэш. `/clear` и `/compact` сбрасывают это, так как они все равно перестраивают кэш в этих точках anyway.

120 120

121<h3 id="connecting-or-disconnecting-an-mcp-server">121<h3 id="connecting-or-removing-an-mcp-server">

122 Подключение или отключение MCP сервера122 Подключение или удаление MCP сервера

123</h3>123</h3>

124 124

125Определения инструментов находятся в слое системной подсказки, поэтому кэш инвалидируется, когда набор определений инструментов в запросе изменяется между ходами. Переключение [advisor tool](/docs/ru/advisor) является исключением: его определение находится после точки разрыва кэша, поэтому включение или отключение `/advisor` сохраняет кэшированный префикс нетронутым. Зависит ли изменение [MCP server](/docs/ru/mcp) от этого от того, отложены ли его инструменты [tool search](/docs/ru/mcp#scale-with-mcp-tool-search) или загружены в префикс:125Определения инструментов находятся в слое системной подсказки, поэтому кэш инвалидируется, когда набор определений инструментов в запросе изменяется между ходами. Переключение [advisor tool](/docs/ru/advisor) является исключением: его определение находится после точки разрыва кэша, поэтому включение или отключение `/advisor` сохраняет кэшированный префикс нетронутым. Зависит ли изменение [MCP server](/docs/ru/mcp) от этого от того, отложены ли инструменты сеанса [tool search](/docs/ru/mcp#scale-with-mcp-tool-search), что является стандартным на поддерживаемых моделях:

126 126

127* **Deferred tools**, по умолчанию на поддерживаемых моделях: подключение, отключение сервера или изменение его списка инструментов только добавляет новое содержимое и не нарушает ничего уже кэшированного.127* **Tools deferred**: Claude Code сохраняет список инструментов из первого запроса разговора для всего разговора, поэтому подключение или отключение сервера в середине сеанса не нарушает ничего уже кэшированного. Сервер, который завершает подключение после первого запроса, предоставляет свои инструменты как отложенные определения, которые Claude загружает по требованию.

128* **Tools loaded into the prefix**: любое изменение их инвалидирует кэш. Это происходит, когда [tool search недоступен или отключен](/docs/ru/mcp#configure-tool-search), например на моделях Google Cloud Agent Platform более ранних, чем поколение Claude 4.5, с пользовательским шлюзом `ANTHROPIC_BASE_URL` или на развертывании Microsoft Foundry [размещенном на Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) после того, как Claude Code обнаружит, что развертывание отклоняет tool search. Это также происходит для сервера или инструмента, отмеченного [`alwaysLoad`](/docs/ru/mcp#exempt-a-server-from-deferral), и для определений, сохраняемых впереди [threshold-based loading](/docs/ru/mcp#configure-tool-search).128* **Tools loaded upfront**: добавление определения инвалидирует кэш, и то же самое происходит при удалении одного намеренно. Это применяется, когда tool search [ниже его `auto` порога, отключен или недоступен](/docs/ru/mcp#configure-tool-search), например на моделях Google Cloud Agent Platform более ранних, чем поколение Claude 4.5, с пользовательским шлюзом `ANTHROPIC_BASE_URL`, или на развертывании Microsoft Foundry [размещенном на Azure](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) после того, как Claude Code обнаружит, что развертывание отклоняет tool search.

129 129

130Когда инструменты загружаются в префикс, наиболее частой причиной инвалидации является подключение или отключение сервера в середине сеанса, что может произойти без каких-либо действий с вашей стороны: процесс stdio сервера завершается, сеанс HTTP истекает или сервер [автоматически переподключается после временного сбоя](/docs/ru/mcp#automatic-reconnection). Подключенный сервер также может отправить [dynamic tool update](/docs/ru/mcp#dynamic-tool-updates), который изменяет его список инструментов.130Без tool search, зависит ли изменение сервера в середине сеанса инвалидирует кэш от того, что изменилось. Для каждого изменения эта таблица показывает, сохраняется ли кэш и что происходит с определениями инструментов в следующем запросе.

131

132| Изменение в середине сеанса | Кэш | Определения инструментов в следующем запросе |

133| - | - | - |

134| Сервер подключается, или [dynamic tool update](/docs/ru/mcp#dynamic-tool-updates) добавляет инструменты | Инвалидирован | Новые определения добавляются |

135| Сервер отключается без каких-либо действий с вашей стороны, например процесс stdio сервера завершается | Сохранен | Определения сервера остаются неизменными. Вызов одного из его инструментов возвращает ошибку вместо выполнения |

136| Удаленный сервер [автоматически переподключается](/docs/ru/mcp#automatic-reconnection) после разрыва соединения | Сохранен, если только запрос, отправленный во время переподключения сервера, не добавляет инструмент `WaitForMcpServers`, который инвалидирует кэш один раз | Определения сервера остаются неизменными. Запрос, отправленный во время переподключения сервера, может добавить `WaitForMcpServers`, когда разговор еще не указал его, и инструмент затем остается указанным для остальной части разговора |

137| Вы удаляете инструмент намеренно, например с помощью [deny rule](#denying-an-entire-tool) или отключив его сервер в `/mcp` | Инвалидирован | Определение удаляется |

138

139Когда вы возобновляете разговор, чьи инструменты загружаются в префикс, один из его MCP серверов все еще может подключаться при отправке первого запроса. Если стенограмма записала определения инструментов этого сервера, этот запрос включает их как записанные, поэтому он не изменяется, когда сервер завершает подключение с теми же инструментами.

131 140

132Редактирование конфигурации MCP само по себе не изменяет кэш. Новая конфигурация вступает в силу только после перезагрузки, когда сервер подключается или отключается.141Редактирование конфигурации MCP само по себе не изменяет кэш. Новая конфигурация вступает в силу только после перезагрузки, когда сервер подключается или отключается.

133 142

147 Плагины, которые предоставляют MCP серверы156 Плагины, которые предоставляют MCP серверы

148</h4>157</h4>

149 158

150Когда вы включаете или отключаете плагин, который предоставляет [MCP servers](/docs/ru/plugins/components#mcp-servers), Claude Code следует тем же правилам, что и при [подключении или отключении MCP server](#connecting-or-disconnecting-an-mcp-server):159Когда вы включаете или отключаете плагин, который предоставляет [MCP servers](/docs/ru/plugins/components#mcp-servers), Claude Code следует тем же правилам, что и при [подключении или удалении MCP server](#connecting-or-removing-an-mcp-server).

~~151~~

152* Если Claude Code откладывает инструменты сервера, он сохраняет кэш.

153* Если Claude Code загружает их в префикс, следующий запрос повторно читает весь разговор.

154 160

155<h4 id="code-intelligence-plugins">161<h4 id="code-intelligence-plugins">

156 Плагины анализа кода162 Плагины анализа кода

244 Редактирование файлов в вашем репозитории250 Редактирование файлов в вашем репозитории

245</h3>251</h3>

246 252

247Содержимое файлов попадает в контекст только когда Claude их читает, а чтения добавляются в разговор. Редактирование файла, который Claude ранее прочитал, не изменяет ретроактивно более раннее чтение в истории. Вместо этого Claude Code добавляет `<system-reminder>`, отмечая, что файл изменился, и Claude перечитывает его при необходимости.253Содержимое файлов попадает в контекст только когда Claude их читает, а чтения добавляются в разговор. Редактирование файла, который Claude ранее прочитал, не изменяет ретроактивно более раннее чтение в истории. Вместо этого Claude Code добавляет [`<system-reminder>`](/docs/ru/glossary#system-reminder), отмечая, что файл изменился, и Claude перечитывает его при необходимости.

248 254

249<h3 id="editing-claude-md-mid-session">255<h3 id="editing-claude-md-mid-session">

250 Редактирование CLAUDE.md во время сессии256 Редактирование CLAUDE.md во время сессии

354 Область действия кэша360 Область действия кэша

355</h2>361</h2>

356 362

357В Claude Code кэш фактически ограничен одной машиной и директорией. Каждый разговор содержит рабочую директорию, платформу, оболочку и версию ОС, а системный запрос называет пути вашей автоматической памяти, поэтому две сессии в разных директориях создают разные префиксы и не попадают в кэш друг друга. Это включает worktrees одного и того же репозитория, поскольку каждый worktree имеет свою собственную рабочую директорию.363В Claude Code кэш фактически ограничен одной машиной и директорией. Системный запрос встраивает пути вашей автоматической памяти, и разговор открывается объявлением рабочей директории, платформы, оболочки и версии ОС. Две сессии в разных директориях поэтому создают разные префиксы и не попадают в кэш друг друга.

358 364

359Сессии, которые вы запускаете параллельно в одной директории, создают совпадающие префиксы и читают кэш друг друга. Последовательные сессии совместно используют префикс только когда снимок состояния git, сделанный при запуске, совпадает, поскольку каждый разговор также содержит ветку и недавние коммиты из этого снимка.365Сессии, которые вы запускаете параллельно в одной директории, создают совпадающие префиксы и читают кэш друг друга. Последовательные сессии совместно используют префикс только когда снимок состояния git, сделанный при запуске, совпадает, поскольку каждый разговор также содержит ветку и недавние коммиты из этого снимка.

360 366

361Базовый кэш API шире. Кэши изолированы между организациями и на некоторых поставщиках, [между рабочими пространствами в организации](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#cache-storage-and-sharing). В этих границах любые два запроса с одной и той же моделью и префиксом читают один и тот же кэш. Для вызывающих Agent SDK, запускающих флоты автоматизированных процессов, см. [улучшение кэширования запросов для нескольких пользователей и машин](/docs/ru/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines), чтобы подавить разделы системного запроса для каждой машины и совместно использовать кэш на разных машинах.367Базовый кэш API шире. Кэши изолированы между организациями и на некоторых поставщиках, [между рабочими пространствами в организации](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#cache-storage-and-sharing). В этих границах любые два запроса с одной и той же моделью и префиксом читают один и тот же кэш. Для вызывающих Agent SDK, запускающих флоты автоматизированных процессов, см. [улучшение кэширования запросов для нескольких пользователей и машин](/docs/ru/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines), чтобы переместить расположение автоматической памяти из системного запроса и совместно использовать запись кэша системного запроса на разных пользователях и машинах.

362 368

363<h2 id="check-cache-performance">369<h2 id="check-cache-performance">

364 Проверка производительности кэша370 Проверка производительности кэша

405| Переменная | Эффект |411| Переменная | Эффект |

406| - | - |412| - | - |

412 418

419`DISABLE_PROMPT_CACHING_HAIKU` применяется к модели Haiku по умолчанию, модели, на которую разрешается псевдоним `haiku`. Он отключает кеширование везде, где работает эта модель, включая основной диалог, когда это ваша основная модель. Охват основного диалога требует Claude Code версии 2.1.283 или более поздней.

420

421Переменная также охватывает фоновую модель, которую вы установили с помощью устаревшей переменной `ANTHROPIC_SMALL_FAST_MODEL`, когда эта модель отличается от вашей основной модели.

422

423Другая версия Haiku, которую вы закрепляете как вашу основную модель, сохраняет кеширование; установите `DISABLE_PROMPT_CACHING` для отключения кеширования для неё.

424

413Чтобы установить политику кеширования в масштабах организации, поместите любую из этих переменных или [переменные TTL](#cache-lifetime) в блок `env` [управляемых параметров](/docs/ru/managed-settings). Для обычного использования оставьте кеширование включенным.425Чтобы установить политику кеширования в масштабах организации, поместите любую из этих переменных или [переменные TTL](#cache-lifetime) в блок `env` [управляемых параметров](/docs/ru/managed-settings). Для обычного использования оставьте кеширование включенным.

414 426

415<h2 id="related-resources">427<h2 id="related-resources">

quickstart.md +8 −6

Details

27 Шаг 1: Установите Claude Code27 Шаг 1: Установите Claude Code

28</h2>28</h2>

29 29

~~30Для установки Claude Code используйте один из следующих методов:~~30Для установки Claude Code откройте терминал и выполните команду для вашей системы. Если вы раньше не использовали терминал, [руководство по терминалу](/docs/ru/terminal-guide) показывает, как его открыть и вставить команду.

31 31

32<Tabs>32<Tabs>

33 <Tab title="Встроенная установка (рекомендуется)">33 <Tab title="Встроенная установка (рекомендуется)">

49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50 ```50 ```

51 51

52 Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](/docs/ru/troubleshoot-install#command-not-found-claude-after-installation).

52 Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell. Ваша подсказка показывает `PS C:\` когда вы находитесь в PowerShell и `C:\` без `PS` когда вы находитесь в CMD.54 Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell. Ваша подсказка показывает `PS C:\` когда вы находитесь в PowerShell и `C:\` без `PS` когда вы находитесь в CMD.

53 55

54 Если команда установки завершается с ошибкой `syntax error near unexpected token '<'`, `403` или другой ошибкой curl, см. [Устранение неполадок при установке](/docs/ru/troubleshoot-install#find-your-error) чтобы сопоставить ошибку с исправлением и для альтернативных методов установки.56 Если команда установки завершается с ошибкой `syntax error near unexpected token '<'`, `403` или другой ошибкой curl, см. [Устранение неполадок при установке](/docs/ru/troubleshoot-install#find-your-error) чтобы сопоставить ошибку с исправлением и для альтернативных методов установки.

176</Note>178</Note>

177 179

178<h2 id="step-5-make-your-first-code-change">180<h2 id="step-5-make-your-first-code-change">

179 Шаг 5: Сделайте своё первое изменение кода181 Шаг 5: Внесите первое изменение в код

180</h2>182</h2>

181 183

182Теперь давайте заставим Claude Code выполнить некоторое реальное кодирование. Попробуйте простую задачу:184Теперь давайте заставим Claude Code выполнить реальное кодирование. Попробуйте простую задачу:

183 185

184```text wrap theme={null}186```text wrap theme={null}

185add a hello world function to the main file187add a hello world function to the main file

186```188```

187 189

188Claude Code находит подходящий файл и показывает вам изменение. Если он просит разрешение перед внесением изменения, выберите **Да** для одобрения.190Claude Code находит подходящий файл и показывает вам изменение. Если он просит разрешение перед внесением изменения, выберите **Yes** для одобрения.

189 191

190Auto mode — это [встроенный начальный режим разрешений](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) для интерактивных сеансов терминала на планах Pro, Max и Team: классификатор проверяет действия вместо вас, и Claude редактирует большинство файлов и выполняет большинство команд без запроса. На других планах Manual mode — это встроенный начальный режим разрешений. Для сеанса, который вы запускаете сразу после установки, см. [Первый сеанс после установки или обновления](/docs/ru/env-vars#first-session-after-an-install-or-upgrade).192В Claude Code v2.1.283 и более поздних версиях автоматический режим является [встроенным режимом разрешений по умолчанию](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) для интерактивных сеансов терминала: классификатор проверяет действия вместо вас, и Claude редактирует большинство файлов и выполняет большинство команд без запроса. В более ранних версиях автоматический режим является встроенным режимом разрешений по умолчанию только для планов Pro, Max и Team. Для сеанса, который вы запустите сразу после установки, см. [First session after an install or upgrade](/docs/ru/env-vars#first-session-after-an-install-or-upgrade).

191 193

192<Note>194<Note>

193 Ваши параметры или ваша организация могут установить другой начальный режим разрешений. [Какой режим разрешений начинается в сеансе](/docs/ru/permission-modes#which-mode-a-session-starts-in) перечисляет, что это делает. Нажмите `Shift+Tab` в любой момент, чтобы переключить режим разрешений сеанса, в котором вы находитесь.195 Ваши параметры или ваша организация могут установить другой режим разрешений по умолчанию. [В каком режиме разрешений начинается сеанс](/docs/ru/permission-modes#which-mode-a-session-starts-in) указывает, что это определяет. Нажмите `Shift+Tab` в любой момент, чтобы переключить режим разрешений сеанса, в котором вы находитесь.

194</Note>196</Note>

195 197

196<h2 id="step-6-use-git-with-claude-code">198<h2 id="step-6-use-git-with-claude-code">

remote-control.md +158 −165

Details

6 6

7> Продолжайте локальный сеанс Claude Code со своего телефона, планшета или любого браузера, используя Remote Control. Работает с claude.ai/code и мобильным приложением Claude.7> Продолжайте локальный сеанс Claude Code со своего телефона, планшета или любого браузера, используя Remote Control. Работает с claude.ai/code и мобильным приложением Claude.

8 8

~~9<Note>~~

10 Remote Control доступен на всех планах. На планах Team и Enterprise он отключен по умолчанию до тех пор, пока владелец не включит переключатель Remote Control в [параметрах администратора Claude Code](https://claude.ai/admin-settings/claude-code).

~~11</Note>~~

13Remote Control подключает [claude.ai/code](https://claude.ai/code) или приложение Claude для [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) и [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) к сеансу Claude Code, работающему на вашем компьютере. Начните задачу за столом, а затем продолжите её со своего телефона на диване или в браузере на другом компьютере.9Remote Control подключает [claude.ai/code](https://claude.ai/code) или приложение Claude для [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) и [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) к сеансу Claude Code, работающему на вашем компьютере. Начните задачу за столом, а затем продолжите её со своего телефона на диване или в браузере на другом компьютере.

14 10

15Когда вы запускаете сеанс Remote Control на своем компьютере, Claude продолжает работать локально всё время, поэтому выполнение кода и доступ к файловой системе остаются на вашем компьютере. С помощью Remote Control вы можете:11Когда вы запускаете сеанс Remote Control на своем компьютере, Claude продолжает работать локально всё время, поэтому выполнение кода и доступ к файловой системе остаются на вашем компьютере. С помощью Remote Control вы можете:

17* **Использовать полную локальную среду удалённо**: ваша файловая система, [MCP servers](/docs/ru/mcp), инструменты и конфигурация проекта остаются доступными, и ввод `@` автоматически дополняет пути файлов из вашего локального проекта.13* **Использовать полную локальную среду удалённо**: ваша файловая система, [MCP servers](/docs/ru/mcp), инструменты и конфигурация проекта остаются доступными, и ввод `@` автоматически дополняет пути файлов из вашего локального проекта.

18* **Работать с обеих поверхностей одновременно**: беседа и прогресс [subagents](/docs/ru/sub-agents) и [dynamic workflows](/docs/ru/workflows) остаются синхронизированными на всех подключённых устройствах, поэтому вы можете отправлять сообщения из терминала, браузера и телефона взаимозаменяемо.14* **Работать с обеих поверхностей одновременно**: беседа и прогресс [subagents](/docs/ru/sub-agents) и [dynamic workflows](/docs/ru/workflows) остаются синхронизированными на всех подключённых устройствах, поэтому вы можете отправлять сообщения из терминала, браузера и телефона взаимозаменяемо.

19* **Отправлять изображения и файлы со своего телефона или браузера**: прикрепляйте фотографию или файл в приложение Claude или на claude.ai/code с подписью или без неё. Claude видит прикреплённые фотографии непосредственно как часть вашего сообщения. Claude Code загружает другие файлы на ваш компьютер и передаёт их Claude как ссылки на файлы `@`.15* **Отправлять изображения и файлы со своего телефона или браузера**: прикрепляйте фотографию или файл в приложение Claude или на claude.ai/code с подписью или без неё. Claude видит прикреплённые фотографии непосредственно как часть вашего сообщения. Claude Code загружает другие файлы на ваш компьютер и передаёт их Claude как ссылки на файлы `@`.

20* **Пережить перебои**: если ваш ноутбук перейдёт в режим сна или сетевое соединение разорвётся, Claude Code автоматически переподключится, когда ваш компьютер вернётся в сеть. Во время восстановления соединения Claude Code ставит в очередь сообщения, запросы разрешений и обновления статуса от subagents и workflows, и доставляет их после восстановления соединения.16* **Пережить перебои**: если ваш ноутбук перейдёт в режим сна или сетевое соединение разорвётся, Claude Code автоматически переподключится, когда ваш компьютер вернётся в сеть.

22В отличие от [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web), которая работает на облачной инфраструктуре, сеансы Remote Control работают непосредственно на вашем компьютере и взаимодействуют с вашей локальной файловой системой. Веб- и мобильные интерфейсы — это просто окно в этот локальный сеанс.

23 17

24На этой странице рассматриваются настройка, способы запуска и подключения к сеансам, а также сравнение Remote Control с Claude Code в веб-версии.18В отличие от [cloud sessions](/docs/ru/claude-code-on-the-web), которые работают на облачной инфраструктуре, сеансы Remote Control работают непосредственно на вашем компьютере и взаимодействуют с вашей локальной файловой системой. Веб- и мобильные интерфейсы — это просто окно в этот локальный сеанс, поэтому ваш компьютер должен оставаться включённым и процесс `claude` должен продолжать работать.

25 19

26<h2 id="requirements">20<h2 id="requirements">

27 Требования21 Требования

33* **Аутентификация**: запустите `claude` и используйте `/login` для входа через claude.ai, если вы ещё этого не сделали. Без подходящей учётной записи `claude remote-control` завершится с ошибкой, в то время как `claude --remote-control` всё ещё запустит интерактивный сеанс и покажет уведомление об ошибке Remote Control вскоре после запуска.27* **Аутентификация**: запустите `claude` и используйте `/login` для входа через claude.ai, если вы ещё этого не сделали. Без подходящей учётной записи `claude remote-control` завершится с ошибкой, в то время как `claude --remote-control` всё ещё запустит интерактивный сеанс и покажет уведомление об ошибке Remote Control вскоре после запуска.

34* **Конечная точка API**: недоступна в любой из этих конфигураций:28* **Конечная точка API**: недоступна в любой из этих конфигураций:

35 * Вы используете Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.29 * Вы используете Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.

36 * Вы указываете [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) на хост, отличный от `api.anthropic.com`, например на [LLM gateway](/docs/ru/llm-gateway) или прокси. Отключите переменную, чтобы использовать Remote Control. До версии 2.1.196 Claude Code позволял использовать Remote Control с пользовательским `ANTHROPIC_BASE_URL`.30 * Вы указываете [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) на хост, отличный от `api.anthropic.com`, например на [LLM gateway](/docs/ru/llm-gateway) или прокси. Отключите переменную, чтобы использовать Remote Control.

37 * Вы входите через корпоративный [Claude apps gateway](/docs/ru/claude-apps-gateway).31 * Вы входите через корпоративный [Claude apps gateway](/docs/ru/claude-apps-gateway).

38* **Оценка флага функции**: [`DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` и `DISABLE_GROWTHBOOK`](/docs/ru/env-vars) каждая отключает оценку флага функции, от которой зависит доступность Remote Control. Отключите переменную везде, где она установлена, в переменных окружения вашей оболочки или в блоке `env` файла [`settings.json`](/docs/ru/settings-reference#all-settings), чтобы использовать Remote Control.32* **Оценка флага функции**: если вы установили [переменную окружения, которая отключает оценку флага функции](/docs/ru/env-vars#features-that-need-feature-flag-fetching), доступность Remote Control зависит от того, какую именно:

39* **Доверие рабочей области**: запустите `claude` в каталоге вашего проекта хотя бы один раз, чтобы принять диалог доверия рабочей области. Диалог доверия при запуске никогда не сохраняет доверие для вашего домашнего каталога, поэтому запустите Remote Control из каталога проекта.33 * Если вы установили `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` или `DISABLE_GROWTHBOOK`, Remote Control недоступен. Отключите переменную везде, где она установлена, в переменных окружения вашей оболочки или в блоке `env` файла [`settings.json`](/docs/ru/settings-reference#all-settings), чтобы использовать Remote Control.

34 * Если вы установили только `DISABLE_TELEMETRY` или `DO_NOT_TRACK`, Remote Control остаётся доступным, если только ваша организация не требует [Trusted Devices](#trusted-devices). Если требует, отключите переменную, чтобы использовать Remote Control. Использование Remote Control с любой из этих переменных требует Claude Code версии 2.1.283 или позже.

35* **Доверие рабочей области**: в каталоге, который вы ещё не доверили, `claude remote-control` выводит информацию о том, что включает доверие, и спрашивает `Trust <directory>? [y/N]` перед запуском. Ответ `y` сохраняет выбор, за исключением вашего домашнего каталога, где доверие никогда не сохраняется и вопрос повторяется при каждом запуске. Когда стандартный ввод или вывод команды не является терминалом, команда не может спросить и завершается с ошибкой [`Workspace not trusted`](/docs/ru/errors#workspace-not-trusted-when-starting-remote-control).

40 36

41<h2 id="start-a-remote-control-session">37<h2 id="start-a-remote-control-session">

42 Запуск сеанса Remote Control38 Запуск сеанса Remote Control

43</h2>39</h2>

44 40

45Вы можете запустить сеанс Remote Control из CLI или расширения VS Code. CLI предлагает три режима вызова; VS Code использует команду `/remote-control`.41Вы можете запустить сеанс Remote Control из CLI, [приложения Claude Desktop](/docs/ru/desktop) или расширения VS Code. CLI предлагает три режима вызова; приложение Desktop и VS Code используют команду `/remote-control`.

46 42

47<Tabs>43<Tabs>

48 <Tab title="Режим сервера">44 <Tab title="Режим сервера">

52 claude remote-control48 claude remote-control

53 ```49 ```

54 50

55 До тех пор, пока вы не примете одноразовое подтверждение Remote Control, `claude remote-control` объясняет, что он делает, и спрашивает `Enable Remote Control? (y/n)` перед запуском сервера. Ответьте `y`, чтобы принять и запустить сервер. Если вы отклоните, Claude Code выходит без запуска сервера и спросит снова в следующий раз, когда вы запустите команду.51 До тех пор, пока вы не примете одноразовое подтверждение Remote Control, `claude remote-control` объясняет, что он делает, и спрашивает `Enable Remote Control? (y/n)` перед запуском сервера. Ответьте `y`, чтобы принять и запустить сервер. Если вы откажетесь, Claude Code завершит работу без запуска сервера и снова спросит при следующем запуске команды.

56 52

57 Процесс продолжает работать в вашем терминале в режиме сервера, ожидая удалённых подключений. Он отображает URL сеанса, который вы можете использовать для [подключения с другого устройства](#connect-from-another-device), и вы можете нажать пробел, чтобы показать QR-код для быстрого доступа со своего телефона. Пока активен удалённый сеанс, терминал показывает статус подключения и активность инструментов.53 Процесс продолжает работать в вашем терминале в режиме сервера, ожидая удаленных подключений. Он отображает URL сеанса, который вы можете использовать для [подключения с другого устройства](#connect-from-another-device), и вы можете нажать пробел, чтобы показать QR-код для быстрого доступа с телефона. Пока активен удаленный сеанс, терминал показывает статус подключения и активность инструментов.

58 54

59 Доступные флаги:55 Доступные флаги:

60 56

61 | Флаг | Описание |57 | Флаг | Описание |

62 | - | - |58 | - | - |

63 | `--name "My Project"` | Установите пользовательское название сеанса, видимое в списке сеансов на claude.ai/code. |59 | `--name "My Project"` | Установите пользовательское название сеанса, видимое в списке сеансов на claude.ai/code. |

64 | `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически сгенерированных названий сеансов, когда явное имя не установлено. По умолчанию используется имя хоста вашего компьютера, создавая названия вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта. |60 | `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически генерируемых названий сеансов, когда явное имя не установлено. По умолчанию используется имя хоста вашей машины, создавая названия вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта. |

65 | `-c`, `--continue` | Возобновите сеанс, который последний сервер в этом каталоге запустил, вместо создания нового. См. [Возобновление сеансов после остановки сервера](#resume-sessions-after-stopping-the-server). Не может быть объединено с `--session-id`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требует Claude Code версии 2.1.200 или позже; более ранние версии отклоняют флаг как неизвестный аргумент. |61 | `-c`, `--continue` | Восстановите сеанс, который последний сервер в этом каталоге запустил, вместо создания нового. См. [Возобновление сеансов после остановки сервера](#resume-sessions-after-stopping-the-server). Не может быть объединено с `--session-id`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требуется Claude Code v2.1.200 или позже. |

66 | `--session-id <id>` | Возобновите один сеанс по его ID. См. [Возобновление сеансов после остановки сервера](#resume-sessions-after-stopping-the-server). Не может быть объединено с `--continue`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требует Claude Code версии 2.1.200 или позже; более ранние версии отклоняют флаг как неизвестный аргумент. |62 | `--session-id <id>` | Восстановите один сеанс по его ID. См. [Возобновление сеансов после остановки сервера](#resume-sessions-after-stopping-the-server). Не может быть объединено с `--continue`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требуется Claude Code v2.1.200 или позже. |

67 | `--spawn <mode>` | Как сервер создаёт сеансы.<br />• `same-dir` (по умолчанию): все сеансы используют текущий рабочий каталог, поэтому они могут конфликтовать при редактировании одних и тех же файлов.<br />• `worktree`: каждый сеанс по требованию получает свой собственный [git worktree](/docs/ru/worktrees). Требует репозитория git.<br />• `session`: режим одного сеанса. Обслуживает ровно один сеанс и отклоняет дополнительные подключения. Устанавливается только при запуске.<br />Нажмите `w` во время выполнения, чтобы переключиться между `same-dir` и `worktree`. |63 | `--spawn <mode>` | Как сервер создает сеансы.<br />• `same-dir` (по умолчанию): все сеансы используют текущий рабочий каталог, поэтому они могут конфликтовать при редактировании одних и тех же файлов.<br />• `worktree`: каждый сеанс по требованию получает свой собственный [git worktree](/docs/ru/worktrees). Требуется git репозиторий.<br />• `session`: режим одного сеанса. Обслуживает ровно один сеанс и отклоняет дополнительные подключения. Устанавливается только при запуске.<br />Нажмите `w` во время выполнения, чтобы переключаться между `same-dir` и `worktree`. |

68 | `--capacity <N>` | Максимальное количество одновременных сеансов. По умолчанию 32. Не может использоваться с `--spawn=session`. |64 | `--capacity <N>` | Максимальное количество одновременных сеансов. По умолчанию 32. Не может использоваться с `--spawn=session`. |

69 | `--[no-]create-session-in-dir` | Предварительно создайте один сеанс в текущем каталоге при запуске сервера, чтобы у вас было место для ввода текста сразу же. В режиме `worktree` этот сеанс остаётся в текущем каталоге, а сеансы по требованию получают изолированные worktrees. Включено по умолчанию. Если вы передадите `--no-create-session-in-dir` для запуска без них, Claude Code архивирует сеансы сервера при его остановке, поэтому нечего [возобновлять](#resume-sessions-after-stopping-the-server). |65 | `--[no-]create-session-in-dir` | Предварительно создайте один сеанс в текущем каталоге при запуске сервера, чтобы у вас было место для ввода сразу. В режиме `worktree` этот сеанс остается в текущем каталоге, а сеансы по требованию получают изолированные worktrees. Включено по умолчанию. Если вы передадите `--no-create-session-in-dir` для запуска без него, Claude Code архивирует сеансы сервера при его остановке, поэтому нечего [возобновлять](#resume-sessions-after-stopping-the-server). |

70 | `--permission-mode <mode>` | Установите начальный [режим разрешений](/docs/ru/permission-modes) для сеансов сервера, например `acceptEdits`. Принимает `manual` как псевдоним для `default`; неизвестный режим останавливает сервер при запуске и выводит список допустимых режимов. |66 | `--permission-mode <mode>` | Установите начальный [режим разрешений](/docs/ru/permission-modes) для сеансов сервера, например `acceptEdits`. Принимает `manual` как псевдоним для `default`; неузнанный режим останавливает сервер при запуске и выводит список допустимых режимов. |

~~71 | `--debug-file <path>` | Записывайте журналы отладки в указанный файл. |~~67 | `--chrome` / `--no-chrome` | Включите или отключите [интеграцию Chrome](/docs/ru/chrome) в сеансах, которые создает сервер, чтобы Claude мог использовать Chrome на вашей машине, пока вы работаете с другого устройства. Без любого из флагов сеанс, который сервер предварительно создает, и любой сеанс, который вы запускаете сами с claude.ai/code или приложения Claude, начинаются с отключенным Chrome, даже если вы [включили Chrome по умолчанию](/docs/ru/chrome#enable-chrome-by-default). Сеанс, который сервер запускает для одного из ваших потоков [проекта](/docs/ru/claude-projects), следует этому параметру вместо этого, за исключением режима `bypassPermissions`. Требуется Claude Code v2.1.273 или позже. |

~~72 | `--verbose` | Показать подробные журналы подключения и сеанса. |~~68 | `-d`, `--debug[=<filter>]` | Включите отладочное логирование для сервера, опционально отфильтрованное по категориям. Передайте фильтр только в форме `=`, например `--debug=api,hooks`. Требуется Claude Code v2.1.282 или позже. |

70 | `--verbose` | Показывайте подробные логи подключения и сеанса. |

71 | `--sandbox` / `--no-sandbox` | Включите или отключите [изоляцию](/docs/ru/sandboxing) для изоляции файловой системы и сети. По умолчанию отключено. |

74 72

75 Передавайте эти флаги после `remote-control`.73 Передавайте эти флаги после `remote-control`.

76 74

77 Если вы передадите глобальный флаг `claude` перед `remote-control`, или скрипт-обёртка добавит его, Claude Code не переносит флаг в сеансы, которые создаёт сервер. Claude Code пропускает флаг только когда известно, что его удаление не изменит то, что могут делать эти сеансы, например `--verbose` или `--model`. Для любого другого флага, например `--settings`, Claude Code [отказывает в запуске](/docs/ru/errors#not-carried-over-to-the-sessions-remote-control-starts) и называет флаг для удаления. До версии 2.1.248 любой параметр перед `remote-control` заставлял Claude Code отклонять флаги после него с ошибкой `unknown option`.75 Если вы передадите глобальный флаг `claude` перед `remote-control`, или скрипт-обертка добавит его, Claude Code не переносит флаг в сеансы, которые создает сервер. Claude Code пропускает флаг только когда известно, что его удаление не изменит то, что могут делать эти сеансы, например `--verbose` или `--model`. Для любого другого флага, например `--settings`, Claude Code [отказывается запускаться](/docs/ru/errors#not-carried-over-to-the-sessions-remote-control-starts) и называет флаг для удаления.

78 76

79 Claude Code проверяет право на использование Remote Control перед выводом справки, поэтому `claude remote-control --help` возвращает ошибку вместо этого списка флагов, когда вы не вошли с подходящей учётной записью.77 Claude Code проверяет право на использование Remote Control перед выводом справки, поэтому `claude remote-control --help` возвращает ошибку вместо этого списка флагов, когда вы не вошли с подходящей учетной записью.

80 </Tab>78 </Tab>

81 79

82 <Tab title="Интерактивный сеанс">80 <Tab title="Интерактивный сеанс">

83 Чтобы запустить обычный интерактивный сеанс Claude Code с включённым Remote Control, используйте флаг `--remote-control` (или `--rc`):81 Чтобы запустить обычный интерактивный сеанс Claude Code с включенным Remote Control, используйте флаг `--remote-control` (или `--rc`):

84 82

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

86 claude --remote-control84 claude --remote-control

92 claude --remote-control "My Project"90 claude --remote-control "My Project"

93 ```91 ```

94 92

95 Это даёт вам полный интерактивный сеанс в вашем терминале, который вы также можете контролировать из claude.ai или приложения Claude. В отличие от `claude remote-control` (режим сервера), вы можете вводить сообщения локально, пока сеанс также доступен удалённо.93 Это дает вам полный интерактивный сеанс в вашем терминале, который вы также можете контролировать с claude.ai или приложения Claude. В отличие от `claude remote-control` (режим сервера), вы можете вводить сообщения локально, пока сеанс также доступен удаленно.

96 </Tab>94 </Tab>

97 95

98 <Tab title="Из существующего сеанса">96 <Tab title="Из существующего сеанса">

99 Если вы уже находитесь в сеансе Claude Code и хотите продолжить его удалённо, используйте команду `/remote-control` (или `/rc`):97 Если вы уже находитесь в сеансе Claude Code и хотите продолжить его удаленно, используйте команду `/remote-control` (или `/rc`):

100 98

101 ```text theme={null}99 ```text theme={null}

102 /remote-control100 /remote-control

108 /remote-control My Project106 /remote-control My Project

109 ```107 ```

110 108

111 Это запускает сеанс Remote Control, который переносит историю вашей текущей беседы.109 Это запускает сеанс Remote Control, который переносит историю вашего текущего разговора.

112 110

113 До тех пор, пока вы не примете одноразовое подтверждение Remote Control, диалоговое окно появляется перед подключением `/remote-control`. Выберите **Enable Remote Control**, чтобы принять и подключиться. Если вы выберете **Never mind** или нажмёте Esc, Claude Code не подключается и спросит снова в следующий раз, когда вы запустите `/remote-control`.111 До тех пор, пока вы не примете одноразовое подтверждение Remote Control, диалог появляется перед подключением `/remote-control`. Выберите **Enable Remote Control**, чтобы принять и подключиться. Если вы выберете **Never mind** или нажмете Esc, Claude Code не подключится и снова спросит при следующем запуске `/remote-control`.

114 112

115 Флаги `--verbose`, `--sandbox` и `--no-sandbox` недоступны с этой командой.113 Флаги `--verbose`, `--sandbox` и `--no-sandbox` недоступны с этой командой.

116 </Tab>114 </Tab>

122 /remote-control120 /remote-control

123 ```121 ```

124 122

125 Пока Remote Control включён, Claude Code показывает индикатор **Remote Control** в нижнем колонтитуле поля подсказки. После подключения сеанса нажмите индикатор, чтобы перейти непосредственно к сеансу, или найдите его в списке сеансов на [claude.ai/code](https://claude.ai/code). Claude Code также размещает URL сеанса в беседе. Чтобы отключиться, запустите `/remote-control` снова.123 Пока Remote Control включен, Claude Code показывает индикатор **Remote Control** в нижней части поля подсказки. После подключения сеанса нажмите на индикатор, чтобы перейти непосредственно к сеансу, или найдите его в списке сеансов на [claude.ai/code](https://claude.ai/code). Claude Code также публикует URL сеанса в разговоре. Чтобы отключиться, запустите `/remote-control` снова.

126 124

127 В отличие от CLI, команда VS Code не принимает аргумент имени и не отображает QR-код. Название сеанса выводится из истории вашей беседы или первой подсказки.125 В отличие от CLI, команда VS Code не принимает аргумент имени и не отображает QR-код. Название сеанса выводится из истории вашего разговора или первой подсказки.

128 </Tab>126 </Tab>

129</Tabs>

130 127

131<h3 id="check-connection-status">128 <Tab title="Приложение Desktop">

132 Проверка статуса подключения129 В локальном сеансе на вкладке Code [приложения Claude Desktop](/docs/ru/desktop) введите `/remote-control` или `/rc` в поле подсказки.

133</h3>

134 130

135В интерактивном сеансе, пока Remote Control подключён, терминал показывает индикатор `/rc active`, который ссылается на сеанс на claude.ai. Индикатор скрывается, когда терминал слишком узкий, чтобы его вместить. Чтобы увидеть URL сеанса и QR-код для [подключения с другого устройства](#connect-from-another-device), запустите `/remote-control` снова, чтобы открыть панель статуса. Панель также позволяет вам отключить Remote Control, пока ваш локальный сеанс продолжает работу.131 ```text theme={null}

132 /remote-control

133 ```

136 134

137<span id="session-ended-elsewhere" />Если подключение не удаётся в интерактивном сеансе, индикатор изменяется, чтобы показать сбой, и Claude Code показывает причину в уведомлении и добавляет её в беседу. Запустите `/remote-control` для переподключения, если только причина не говорит, что сеанс был перехвачен или завершён в другом месте:135 После подключения сеанса найдите его в списке сеансов на [claude.ai/code](https://claude.ai/code). Чтобы отключиться, запустите `/remote-control` снова.

138 136

139* **Another connection took over this session**: другое устройство или сеанс Claude Code теперь имеет его. Запустите `/remote-control` только если вы хотите вернуть его.137 Чтобы вместо этого включить Remote Control для каждого сеанса по умолчанию, см. [Включение Remote Control для всех сеансов](#enable-remote-control-for-all-sessions).

140* **This session was ended or archived from another device or app**: запустите `/remote-control` только если вы хотите его вернуть. Claude Code повторно открывает архивированный сеанс.138 </Tab>

141* **The server no longer reports this session**: он мог быть удалён с другого устройства или приложения.139</Tabs>

142 140

143<h3 id="session-url-reminders">141<h3 id="check-connection-status">

144 Напоминания об URL сеанса142 Проверка статуса подключения

145</h3>143</h3>

146 144

147Пока Remote Control подключён, Claude Code напоминает вам об URL сеанса при переключении на ваш телефон или браузер, что помогает больше всего, поэтому вам не нужно искать ссылку в `/remote-control`. Напоминание появляется над полем подсказки в одном из этих моментов:145В интерактивном сеансе, пока Remote Control подключен, терминал показывает индикатор `/rc active`, который ссылается на сеанс на claude.ai. Индикатор скрывается, когда терминал слишком узкий, чтобы его вместить. Чтобы увидеть URL сеанса и QR-код для [подключения с другого устройства](#connect-from-another-device), запустите `/remote-control` снова, чтобы открыть панель статуса. Панель также позволяет вам отключить Remote Control, пока ваш локальный сеанс продолжает работать.

148 146

149* **Длительный ход**: когда ход выполняется дольше, чем настроенный на сервере порог, Claude Code показывает уведомление **Still working** со ссылкой **Check in from your phone**, чтобы вы могли следить за ходом со своего телефона или браузера вместо ожидания в терминале. Claude Code удаляет его, когда ход завершается.147<span id="session-ended-elsewhere" />Если подключение не удается в интерактивном сеансе, индикатор изменяется, чтобы показать сбой, и Claude Code показывает причину в уведомлении и добавляет ее в разговор. Запустите `/remote-control` для переподключения, если только причина не говорит, что сеанс изменился где-то еще:

150* **Повторяющиеся подсказки разрешений**: после того как вы ответите на несколько [подсказок разрешений](/docs/ru/permissions) в сеансе, появляется уведомление **Approve tool calls from your phone** с URL сеанса. Claude Code удаляет его, когда начинается ваш следующий ход.

151 148

152Напоминания могут появляться в любом подключённом сеансе, включая те, где Remote Control [подключается автоматически](#enable-remote-control-for-all-sessions). Они не появляются каждый раз, когда возникают эти условия, и каждое появляется только несколько раз в целом по сеансам. Вы не можете их настраивать или отключать; каждое очищается самостоятельно.149* **Another connection took over this session**: другое устройство или сеанс Claude Code теперь его имеет. Запустите `/remote-control` только если вы хотите его вернуть.

150* **This session was ended or archived from another device or app**: запустите `/remote-control` только если вы хотите сеанс вернуть. Claude Code повторно открывает архивированный сеанс.

151* **The server no longer reports this session**: он может быть удален с другого устройства или приложения.

153 152

154<h3 id="connect-from-another-device">153<h3 id="connect-from-another-device">

155 Подключение с другого устройства154 Подключение с другого устройства

158После активации сеанса Remote Control у вас есть несколько способов подключиться с другого устройства:157После активации сеанса Remote Control у вас есть несколько способов подключиться с другого устройства:

159 158

160* **Откройте URL сеанса** в любом браузере, чтобы перейти непосредственно к сеансу на [claude.ai/code](https://claude.ai/code).159* **Откройте URL сеанса** в любом браузере, чтобы перейти непосредственно к сеансу на [claude.ai/code](https://claude.ai/code).

161* **Отсканируйте QR-код**, показанный рядом с URL сеанса, чтобы открыть его непосредственно в приложении Claude. С помощью `claude remote-control` нажмите пробел, чтобы переключить отображение QR-кода.160* **Отсканируйте QR-код**, показанный рядом с URL сеанса, чтобы открыть его непосредственно в приложении Claude. С `claude remote-control` нажмите пробел, чтобы переключить отображение QR-кода.

162* **Откройте [claude.ai/code](https://claude.ai/code) или приложение Claude** и найдите сеанс по имени в списке сеансов. В мобильном приложении Claude нажмите **Code** в навигации, чтобы перейти к списку сеансов. Сеансы Remote Control показывают значок компьютера с зелёной точкой статуса при подключении.161* **Откройте [claude.ai/code](https://claude.ai/code) или приложение Claude** и найдите сеанс по имени в списке сеансов. В мобильном приложении Claude нажмите **Code** в навигации, чтобы достичь списка сеансов. Сеансы Remote Control показывают значок компьютера с зеленой точкой статуса при подключении.

163 162

164Когда вы подключаетесь, устройство показывает любых подагентов и рабочие процессы, которые сеанс уже имеет, работающие в фоновом режиме. Остановите один из них с устройства, и Claude Code остановит эту задачу на вашем компьютере.163Когда вы подключаетесь, устройство показывает любых подагентов и рабочие процессы, которые сеанс уже запустил в фоновом режиме. Остановите один из них с устройства, и Claude Code остановит эту задачу на вашей машине.

165 164

166Название удалённого сеанса выбирается в следующем порядке:165Название удаленного сеанса выбирается в этом порядке:

167 166

1681. Имя, которое вы передали в `--name`, `--remote-control` или `/remote-control`1671. Имя, которое вы передали в `--name`, `--remote-control` или `/remote-control`

1692. Название, которое вы установили с помощью `/rename`1682. Название, которое вы установили с помощью `/rename`

1703. Последнее значимое сообщение в существующей истории беседы1693. Последнее значимое сообщение в существующей истории разговора

1714. Автоматически сгенерированное имя вроде `myhost-graceful-unicorn`, где `myhost` — это имя хоста вашего компьютера или префикс, который вы установили с помощью `--remote-control-session-name-prefix`1704. Автоматически сгенерированное имя вроде `myhost-graceful-unicorn`, где `myhost` — это имя хоста вашей машины или префикс, который вы установили с помощью `--remote-control-session-name-prefix`

~~172~~

173Если вы не установили явное имя, Claude Code обновляет название, чтобы отразить вашу подсказку после её отправки. Claude Code сопоставляет автоматически сгенерированные названия с языком вашей беседы, или с параметром [`language`](/docs/ru/settings-reference#language), если он настроен.

174 171

175Когда вы переименовываете сеанс из claude.ai или приложения Claude, Claude Code также обновляет локальное название, показанное в `claude --resume`. Claude Code применяет то же переименование к названию сеанса, показанному на панели подсказки, и в списке `claude agents`, когда сеанс [работает в фоновом режиме](/docs/ru/agent-view). До версии 2.1.221 переименование из списка сеансов на claude.ai или в приложении Claude обновляло только название, а CLI сохранял своё предыдущее имя сеанса; `/rename`, который работает в самом CLI, устанавливает имя на любой версии.172Если вы не установили явное имя, Claude Code обновляет название, чтобы отразить вашу подсказку после того, как вы отправите одну. Когда вы переименовываете сеанс с claude.ai или приложения Claude, Claude Code также обновляет локальное название, показанное в `claude --resume`.

176 173

177Если у вас ещё нет приложения Claude, используйте команду `/mobile` внутри Claude Code, чтобы показать QR-код для [claude.ai/mobile](https://claude.ai/mobile), который открывает правильный магазин приложений для вашего телефона.174Если у вас еще нет приложения Claude, запустите `/mobile` внутри Claude Code, чтобы показать QR-код для [claude.ai/mobile](https://claude.ai/mobile), который открывает правильный магазин приложений для вашего телефона.

178 175

179<h3 id="what-connected-devices-see">176<h3 id="what-connected-devices-see">

180 Что видят подключённые устройства177 Что видят подключенные устройства

181</h3>178</h3>

182 179

183Подключённое устройство показывает беседу в вашем терминале по мере её развития. Эти случаи выходят за рамки обычных сообщений:180Подключенное устройство показывает разговор в вашем терминале по мере его происхождения. Эти случаи выходят за рамки обычных сообщений:

184 181

185* **Компактирование и `/clear`**: пока Claude Code [компактирует беседу](/docs/ru/context-window#what-survives-compaction), подключённые устройства показывают прогресс, а затем где была компактирована беседа. Когда вы запускаете `/clear`, беседа сбрасывается и на подключённых устройствах тоже.182* **Компактирование и `/clear`**: пока Claude Code [компактирует разговор](/docs/ru/context-window#what-survives-compaction), подключенные устройства показывают прогресс, а затем где был компактирован разговор. Когда вы запускаете `/clear`, разговор также сбрасывается на подключенных устройствах.

186* **Переключение бесед с помощью `/resume`**: подключённое устройство не получает название переключённой беседы или её более раннюю историю, но новые сообщения в обе стороны идут в ту беседу, которая открыта в вашем терминале, и из неё. Чтобы снова работать с исходной беседой с устройства, запустите `/resume` в вашем терминале и переключитесь обратно на неё.183* **Переключение разговоров с помощью `/resume`**: подключенное устройство не получает название переключенного разговора или более раннюю историю, но новые сообщения в обе стороны идут к и от того разговора, который открыт в вашем терминале. Чтобы снова работать с исходным разговором с устройства, запустите `/resume` в вашем терминале и переключитесь обратно на него.

187* **Извлечение сеанса с помощью `/teleport`**: когда вы извлекаете [сеанс Claude Code в веб-версии](/docs/ru/claude-code-on-the-web#from-cloud-to-terminal) в свой терминал с помощью `/teleport`, подключённое устройство не получает более раннюю историю извлечённой беседы. Новые сообщения в обе стороны идут в извлечённую беседу, которая теперь открыта в вашем терминале.184* **Извлечение сеанса с помощью `/teleport`**: когда вы извлекаете [облачный сеанс](/docs/ru/claude-code-on-the-web#from-cloud-to-terminal) в ваш терминал с помощью `/teleport`, подключенное устройство не получает более раннюю историю извлеченного разговора. Новые сообщения в обе стороны идут к и от извлеченного разговора, который теперь открыт в вашем терминале.

188* **Сообщения из ваших других сеансов**: с [кросс-сеансовой передачей сообщений](/docs/ru/cross-session-messaging) одно и то же соединение переносит сообщения между вашими собственными сеансами на разных машинах и из ваших [сеансов Claude Code в веб-версии](/docs/ru/claude-code-on-the-web), через серверы Anthropic, как и остальной трафик Remote Control. [Отправка сообщений в сеансы на других машинах](/docs/ru/cross-session-messaging#message-sessions-on-other-machines) охватывает правила доставки, а [Управление входящими сообщениями](/docs/ru/cross-session-messaging#control-inbound-messages) охватывает управление входящими. Требует Claude Code версии 2.1.224 или позже.185* **Сообщения из ваших других сеансов**: с [кросс-сеансовой передачей сообщений](/docs/ru/cross-session-messaging) одно и то же подключение переносит сообщения между вашими собственными сеансами на разных машинах и из ваших [облачных сеансов](/docs/ru/claude-code-on-the-web).

189* **Подсказки, которые вы отправляете в середине хода**: когда вы отправляете подсказку с подключённого устройства до завершения текущего хода, Claude Code ставит её в очередь и сохраняет её в стенограмме устройства после завершения этого хода.186* **Diff ваших изменений**: когда каталог сеанса находится в git репозитории, панель diff подключенного устройства показывает ваши изменения. На ветке, которая имеет коммиты впереди ветки по умолчанию репозитория, панель показывает изменения с момента разделения ветки, включая ваши незафиксированные правки. На самой ветке по умолчанию или на ветке, которая не впереди, панель показывает только ваши незафиксированные изменения.

190* **Diff ваших изменений**: когда каталог сеанса находится в репозитории git, панель diff подключённого устройства показывает ваши изменения. Устройство запрашивает diff по соединению, и Claude Code вычисляет его на вашем компьютере. На ветке, которая имеет коммиты впереди ветви по умолчанию репозитория, панель показывает изменения с момента расхождения ветви, включая ваши незафиксированные правки. На самой ветви по умолчанию или на ветви, которая не впереди неё, панель показывает только ваши незафиксированные изменения. До версии 2.1.247 Claude Code сообщал diff подключённым устройствам только в сеансах, обслуживаемых `claude remote-control`.187* **Модель**: когда вы выбираете [модель](/docs/ru/model-config) с подключенного устройства, Claude Code запускает сеанс на этой модели. Требуется Claude Code v2.1.238 или позже. Модель, которую вы выбираете с элемента управления моделью устройства, применяется только к текущему сеансу. Когда вы отправляете `/model <name>` с устройства в интерактивный сеанс, Claude Code также устанавливает ваше значение по умолчанию для новых сеансов.

191* **Модель**: когда вы выбираете [модель](/docs/ru/model-config) с подключённого устройства, Claude Code запускает сеанс на этой модели. Средство выбора `/model` терминала, `/status` и `/config` показывают эту модель. Требует Claude Code версии 2.1.238 или позже.188* **Уровень усилий**: когда вы устанавливаете [уровень усилий](/docs/ru/model-config#adjust-effort-level) с подключенного устройства, с помощью `/effort` или элемента управления усилиями устройства, Claude Code применяет его к сеансу на вашей машине. Если вы закрепили уровень с помощью `CLAUDE_CODE_EFFORT_LEVEL`, сеанс сохраняет этот уровень, и Claude Code отказывает в другом выборе из элемента управления усилиями. Выбор уровня из элемента управления усилиями требует Claude Code v2.1.234 или позже на вашей машине.

192 * Модель, которую вы выбираете из управления моделью устройства, применяется только к текущему сеансу. Когда вы отправляете `/model <name>` с устройства в интерактивный сеанс, Claude Code также устанавливает вашу стандартную модель для новых сеансов.189* **Переподключение после сбоя подключения**: запустите `/remote-control` для переподключения. Если компактирование переписало разговор или вы переключили разговоры с помощью `/resume` в то же время, Claude Code архивирует сеанс сервера, который он использовал, вместо того чтобы оставить его в списке сеансов. Вы все еще можете найти его, [фильтруя архивированные сеансы](/docs/ru/claude-code-on-the-web#archive-sessions). Переключение разговоров, пока устройство все еще подключено, не архивирует сеанс.

193 * Если вы отправляете имя, которое Claude Code не распознаёт, например отображаемое имя, где ожидается ID модели, Claude Code [отказывает в выборе](/docs/ru/errors#model-is-not-a-recognized-model-id) и сеанс сохраняет свою текущую модель. До версии 2.1.260 Claude Code сохранял нераспознанный выбор из управления моделью устройства, и ваше следующее сообщение не удавалось.

194* **Уровень усилий**: когда вы устанавливаете [уровень усилий](/docs/ru/model-config#adjust-effort-level) с подключённого устройства, с помощью `/effort` или управления усилиями устройства, Claude Code применяет его к сеансу на вашем компьютере, и claude.ai/code показывает уровень, который использует сеанс. Если вы закрепили уровень с помощью `CLAUDE_CODE_EFFORT_LEVEL`, сеанс сохраняет этот уровень, и Claude Code отказывает в другом выборе из управления усилиями. Выбор уровня из управления усилиями требует Claude Code версии 2.1.234 или позже на вашем компьютере.

195* **Переподключение после сбоя подключения**: запустите `/remote-control` для переподключения. Если компактирование переписало беседу или вы переключили беседы с помощью `/resume` в то же время, Claude Code архивирует сеанс сервера, который он использовал, вместо того чтобы оставлять его в списке сеансов. Вы всё ещё можете найти его, [фильтруя архивированные сеансы](/docs/ru/claude-code-on-the-web#archive-sessions). Переключение бесед, пока устройство всё ещё подключено, не архивирует сеанс.

196 190

197<h3 id="enable-remote-control-for-all-sessions">191<h3 id="enable-remote-control-for-all-sessions">

198 Включение Remote Control для всех сеансов192 Включение Remote Control для всех сеансов

199</h3>193</h3>

200 194

201Remote Control активируется только при явном запуске `claude remote-control`, `claude --remote-control` или `/remote-control`, если не включена автоподключение. Чтобы включить автоподключение для каждого интерактивного сеанса, запустите `/config` внутри Claude Code и установите **Enable Remote Control for all sessions**. Переключатель принимает три значения:195Remote Control активируется только при явном запуске `claude remote-control`, `claude --remote-control` или `/remote-control`, если не включено автоподключение. Чтобы включить автоподключение для каждого интерактивного сеанса, запустите `/config` внутри Claude Code и установите **Enable Remote Control for all sessions**. Переключатель принимает три значения:

202 196

203* **`true`**: подключаться автоматически при запуске интерактивного сеанса.197* **`true`**: автоматически подключаться при запуске интерактивного сеанса.

204* **`false`**: отключить автоподключение, хотя `true` из [управляемых параметров](/docs/ru/managed-settings) имеет приоритет, потому что Claude Code сохраняет выбор в ваши пользовательские параметры. `false` в параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`) отключает автоподключение даже над управляемым `true`.198* **`false`**: отключить автоподключение, хотя `true` из [управляемых параметров](/docs/ru/managed-settings) имеет приоритет, потому что Claude Code сохраняет выбор в ваши пользовательские параметры. `false` в параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`) отключает автоподключение даже над управляемым `true`.

205* **`default`**: очистить ваш выбор и следовать стандартному значению администратора вашей организации, если оно установлено, иначе текущему стандартному значению Claude Code.199* **`default`**: очистить ваш выбор и следовать администраторскому значению по умолчанию вашей организации, если оно установлено, иначе текущему значению по умолчанию Claude Code.

206 200

207Тот же переключатель появляется вне CLI:201Тот же переключатель появляется вне CLI:

208 202

209* **Приложение Desktop**: **Settings > Claude Code > Enable remote control by default**.203* **Приложение Desktop**: **Settings > Claude Code > Enable remote control by default**.

210* **Расширение VS Code**: **Enable Remote Control for all sessions** в разделе Settings [меню команд](/docs/ru/vs-code#use-the-prompt-box). Требует Claude Code версии 2.1.203 или позже.204* **Расширение VS Code**: **Enable Remote Control for all sessions** в разделе Settings [меню команд](/docs/ru/vs-code#use-the-prompt-box).

211 205

212Чтобы включить автоподключение из файла параметров вместо этого, установите [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup) на `true` в вашем пользовательском файле `~/.claude/settings.json` или в [управляемых параметрах](/docs/ru/managed-settings). В параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`) Claude Code соблюдает `false` и отключает автоподключение для этого репозитория, но игнорирует `true`, поэтому зафиксированный файл не может включить Remote Control для всех, кто открывает репозиторий.206Чтобы вместо этого включить автоподключение из файла параметров, установите [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup) на `true` в ваш пользовательский файл `~/.claude/settings.json` или в [управляемые параметры](/docs/ru/managed-settings). В параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), Claude Code соблюдает `false` и отключает автоподключение для этого репозитория, но игнорирует `true`, поэтому проверенный файл не может включить Remote Control для всех, кто открывает репозиторий.

213 207

214Автоподключение входит с вашей собственной учётной записью claude.ai, поэтому сеанс, который оно запускает, появляется только в приложениях Claude вашей собственной учётной записи и не предоставляет доступ никому другому.208Автоподключение входит с вашей собственной учетной записью claude.ai, поэтому сеанс, который оно запускает, появляется только в приложениях Claude вашей собственной учетной записи и не предоставляет доступ никому другому.

215 209

216С этой настройкой каждый интерактивный процесс Claude Code регистрирует один удалённый сеанс. Если вы запустите несколько экземпляров, каждый получит свой собственный удалённый сеанс. Чтобы запустить несколько одновременных сеансов из одного процесса, используйте [режим сервера](#start-a-remote-control-session) вместо этого.210С этим параметром включенным, каждый интерактивный процесс Claude Code регистрирует один удаленный сеанс. Если вы запускаете несколько экземпляров, каждый получает свой собственный удаленный сеанс. Чтобы запустить несколько одновременных сеансов из одного процесса, используйте вместо этого [режим сервера](#start-a-remote-control-session).

217 211

218<h3 id="resume-sessions-after-stopping-the-server">212<h3 id="resume-sessions-after-stopping-the-server">

219 Возобновление сеансов после остановки сервера213 Возобновление сеансов после остановки сервера

220</h3>214</h3>

221 215

222Когда вы останавливаете `claude remote-control` с помощью Ctrl+C, сеансы, которые он обслуживал, перестают отвечать с вашего телефона или браузера. Пока вы не запускали другой `claude remote-control` в том же каталоге и не запустили этот с `--no-create-session-in-dir`, Claude Code их не архивирует. Чтобы вернуть их, запустите одну из этих команд в том же каталоге:216Когда вы останавливаете `claude remote-control` с помощью Ctrl+C, сеансы, которые он обслуживал, перестают отвечать с вашего телефона или браузера. Пока вы не запускали другой `claude remote-control` в том же каталоге и не запустили этот с `--no-create-session-in-dir`, Claude Code их не архивирует. Чтобы их вернуть, запустите одну из этих команд в том же каталоге:

223 217

224* **`claude remote-control`**: возвращает каждый сеанс, который обслуживал сервер.218* **`claude remote-control`**: возвращает каждый сеанс, который обслуживал сервер.

225* **`claude remote-control --continue`**: возвращает только сеанс, который сервер запустил, и выходит, когда этот сеанс завершается. Если в этом каталоге нет записи, Claude Code использует самый новый из других git worktrees этого репозитория.219* **`claude remote-control --continue`**: возвращает только сеанс, с которого сервер начал, и выходит, когда этот сеанс заканчивается. Если в этом каталоге нет записи, Claude Code использует самый новый из других git worktrees этого репозитория.

226* **`claude remote-control --session-id <id>`**: возвращает только сеанс, чей ID вы передали, и выходит, когда этот сеанс завершается. ID — это часть URL сеанса на claude.ai/code между `/code/` и любым `?`.220* **`claude remote-control --session-id <id>`**: возвращает только сеанс, чей ID вы передали, и выходит, когда этот сеанс заканчивается. ID — это часть URL сеанса на claude.ai/code между `/code/` и любым `?`.

227 221

228Эти команды работают примерно четыре часа после остановки сервера. После этого запустите `claude remote-control` для запуска нового сеанса. Если вы архивировали сеанс в то же время, `--continue` и `--session-id` разархивируют его на Claude Code версии 2.1.228 или позже.222Эти команды работают примерно четыре часа после остановки сервера. После этого запустите `claude remote-control` для запуска нового сеанса. Если вы архивировали сеанс в то же время, `--continue` и `--session-id` разархивируют его на Claude Code v2.1.228 или позже.

229 223

230Чтобы вернуть сеанс, который вы запустили с помощью `claude --remote-control` или `/remote-control`, возобновите беседу с помощью `claude --continue` или `claude --resume`. Переподключится ли Claude Code и к какому сеансу, зависит от [записи переподключения](#resume-outcomes) беседы.224Чтобы вернуть сеанс, который вы запустили с помощью `claude --remote-control` или `/remote-control`, возобновите разговор с помощью `claude --continue` или `claude --resume`. Если Remote Control не переподключится, см. [Не удалось переподключиться к вашему сеансу Remote Control](#couldnt-reconnect-to-your-remote-control-session).

231 225

232Если вы возобновляете беседу во втором терминале, пока первый всё ещё имеет Remote Control включённым, Claude Code выводит уведомление во втором терминале и оставляет Remote Control отключённым там вместо того чтобы забирать сеанс с первого. Пока Remote Control остаётся отключённым там, Claude в этом терминале не видит [ваши сеансы на других машинах](/docs/ru/cross-session-messaging#see-which-sessions-claude-can-reach), и они не могут его достичь. Запустите `/remote-control` во втором терминале, чтобы переместить Remote Control туда.226Если вы возобновляете разговор во втором терминале, пока первый все еще имеет Remote Control включенным, Claude Code выводит уведомление `Remote Control not started here` во втором терминале и оставляет Remote Control отключенным там вместо того, чтобы забирать сеанс у первого. Запустите `/remote-control` во втором терминале, чтобы переместить Remote Control на него.

233 227

234Когда вы возобновляете беседу в Claude Desktop или расширении IDE, которое имело Remote Control включённым, Claude Code переподключает его к существующему сеансу claude.ai вместо добавления нового в список сеансов.228Когда вы возобновляете разговор в Claude Desktop или расширении IDE, которое имело Remote Control включенным, Claude Code переподключает его к существующему сеансу claude.ai вместо добавления нового в список сеансов.

235 229

236<h2 id="connection-and-security">230<h2 id="connection-and-security">

237 Подключение и безопасность231 Подключение и безопасность

239 233

240Ваш локальный сеанс Claude Code выполняет только исходящие HTTPS запросы и никогда не открывает входящие порты на вашем компьютере. Когда вы запускаете Remote Control, он регистрируется в API Anthropic и опрашивает работу. Когда вы подключаетесь с другого устройства, сервер маршрутизирует сообщения между веб-клиентом или мобильным клиентом и вашим локальным сеансом через потоковое соединение.234Ваш локальный сеанс Claude Code выполняет только исходящие HTTPS запросы и никогда не открывает входящие порты на вашем компьютере. Когда вы запускаете Remote Control, он регистрируется в API Anthropic и опрашивает работу. Когда вы подключаетесь с другого устройства, сервер маршрутизирует сообщения между веб-клиентом или мобильным клиентом и вашим локальным сеансом через потоковое соединение.

241 235

242Весь трафик проходит через API Anthropic через TLS, тот же транспортный протокол безопасности, что и любой сеанс Claude Code. Соединение использует несколько краткосрочных учётных данных, каждое из которых ограничено одной целью и истекает независимо. Когда учётные данные регистрации сервера `claude remote-control` истекают, сервер снова регистрируется в API Anthropic и продолжает обслуживать свои сеансы.236Весь трафик проходит через API Anthropic через TLS, тот же транспортный протокол безопасности, что и любой сеанс Claude Code. Соединение использует несколько краткосрочных учётных данных, каждое из которых ограничено одной целью и истекает независимо.

243 237

244Пока Remote Control подключен, стенограмма сеанса, включая ваши сообщения, ответы Claude и активность инструментов, хранится на серверах Anthropic. Сохраненная стенограмма синхронизирует беседу на всех ваших устройствах и позволяет сеансу переподключиться после разрыва сети. Выполнение и доступ к файловой системе остаются на вашем компьютере, а сохраненные стенограммы хранятся в соответствии с политикой [Использование данных](/docs/ru/data-usage).238Пока Remote Control подключен, стенограмма сеанса, включая ваши сообщения, ответы Claude и активность инструментов, хранится на серверах Anthropic. Сохраненная стенограмма синхронизирует беседу на всех ваших устройствах и позволяет сеансу переподключиться после разрыва сети. Выполнение и доступ к файловой системе остаются на вашем компьютере, а сохраненные стенограммы хранятся в соответствии с политикой [Использование данных](/docs/ru/data-usage).

245 239

309Для потерянного или украденного устройства член удаляет его с этой страницы. Если член не может войти, администратор может использовать **Sign out everywhere** в консоли администратора, чтобы отозвать каждый сеанс и зарегистрированное устройство для этого члена, после чего член повторно регистрирует устройства, которые он всё ещё держит.303Для потерянного или украденного устройства член удаляет его с этой страницы. Если член не может войти, администратор может использовать **Sign out everywhere** в консоли администратора, чтобы отозвать каждый сеанс и зарегистрированное устройство для этого члена, после чего член повторно регистрирует устройства, которые он всё ещё держит.

310 304

311<h2 id="remote-control-vs-cloud-sessions">305<h2 id="remote-control-vs-cloud-sessions">

312 Remote Control в сравнении с облачными сеансами306 Remote Control и облачные сеансы

313</h2>307</h2>

314 308

315Remote Control и [облачные сеансы](/docs/ru/claude-code-on-the-web) оба используют интерфейс claude.ai/code. Ключевое различие заключается в том, где работает сеанс: Remote Control выполняется на вашем компьютере, поэтому ваши локальные MCP servers, инструменты и конфигурация проекта остаются доступными. Облачный сеанс выполняется в облачной инфраструктуре, управляемой Anthropic по умолчанию.309Remote Control и [облачные сеансы](/docs/ru/claude-code-on-the-web) используют интерфейс claude.ai/code. Ключевое различие заключается в том, где выполняется сеанс: Remote Control выполняется на вашем компьютере, поэтому ваши локальные MCP серверы, инструменты и конфигурация проекта остаются доступными. Облачный сеанс выполняется на облачной инфраструктуре, управляемой Anthropic по умолчанию.

316 310

317Используйте Remote Control, когда вы находитесь в процессе локальной работы и хотите продолжить с другого устройства. Используйте облачный сеанс, когда вы хотите начать задачу без какой-либо локальной настройки, работать с репозиторием, который у вас не клонирован, или запустить несколько задач параллельно.311Используйте Remote Control, когда вы находитесь в процессе локальной работы и хотите продолжить с другого устройства. Используйте облачный сеанс, когда вы хотите начать задачу без какой-либо локальной настройки, работать с репозиторием, который у вас не клонирован, или запускать несколько задач параллельно. [Проект](/docs/ru/claude-projects) объединяет оба подхода: его потоки выполняются в облаке, и он использует Remote Control для [запуска потока на вашем компьютере](/docs/ru/claude-projects#run-a-thread-on-your-own-computer), когда вы просите это там.

312

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

314

316| :- | :- | :- | :- | :- |

318| [Remote Control](/docs/ru/remote-control) | Управляйте запущенной сессией из [claude.ai/code](https://claude.ai/code) или мобильного приложения Claude | Ваша машина (CLI, Desktop или VS Code) | Запустите [`claude remote-control` или `/remote-control`](/docs/ru/remote-control#start-a-remote-control-session) | Управление текущей работой с другого устройства |

319| [Channels](/docs/ru/channels) | Отправляйте события из приложения чата, такого как Telegram или Discord, или с вашего собственного сервера | Ваша машина (CLI) | [Установите плагин канала](/docs/ru/channels#quickstart) или [создайте свой](/docs/ru/channels-reference) | Реагирование на внешние события, такие как сбои CI или сообщения в чате |

320| [Slack](/docs/ru/slack) | Упомяните `@Claude` в канале команды | Облако Anthropic | [Установите приложение Slack](/docs/ru/slack#setting-up-claude-code-in-slack) с включенным [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) | PR и рецензии из чата команды |

321| [Self-hosted environments](/docs/ru/self-hosted-environments) | Запустите [облачную сессию](/docs/ru/claude-code-on-the-web) и выберите окружение вашей организации | Инфраструктура вашей организации | [Разверните runners](/docs/ru/self-hosted-environments-quickstart), в планах Team и Enterprise | Облачные сессии, которые должны работать внутри вашей сети |

318 323

319<h2 id="mobile-push-notifications">324<h2 id="mobile-push-notifications">

320 Мобильные push-уведомления325 Мобильные push-уведомления

322 327

323Когда Remote Control активен, Claude может отправлять push-уведомления на ваш телефон.328Когда Remote Control активен, Claude может отправлять push-уведомления на ваш телефон.

324 329

325Claude решает, когда отправить уведомление. Обычно он отправляет одно, когда завершается долгоживущая задача или когда ему нужно решение от вас для продолжения. Вы также можете запросить push в своей подсказке, например `notify me when the tests finish`. Помимо двух переключателей включения/отключения ниже, нет конфигурации для каждого события.330Claude решает, когда отправить уведомление. Обычно он отправляет его, когда завершается долгоживущая задача или когда ему нужно ваше решение для продолжения. Вы также можете запросить push-уведомление в своем запросе, например `notify me when the tests finish`. Помимо двух переключателей включения/выключения ниже, нет конфигурации для отдельных событий.

326 331

327Чтобы настроить мобильные push-уведомления:332Чтобы настроить мобильные push-уведомления:

328 333

331 Загрузите приложение Claude для [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) или [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude).336 Загрузите приложение Claude для [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) или [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude).

332 </Step>337 </Step>

333 338

334 <Step title="Войдите с помощью своей учётной записи Claude Code">339 <Step title="Войдите с помощью своей учетной записи Claude Code">

335 Используйте ту же учётную запись и организацию, которые вы используете для Claude Code в терминале.340 Используйте ту же учетную запись и организацию, которые вы используете для Claude Code в терминале.

336 </Step>341 </Step>

337 342

338 <Step title="Разрешите уведомления">343 <Step title="Разрешите уведомления">

340 </Step>345 </Step>

341 346

342 <Step title="Включите push в Claude Code">347 <Step title="Включите push в Claude Code">

343 В вашем терминале запустите `/config` и включите **Push when Claude decides** для проактивных уведомлений, **Push when actions required** для запросов разрешений и вопросов или оба варианта.348 В вашем терминале запустите `/config` и включите **Push when Claude decides** для проактивных уведомлений, **Push when actions required** для запросов разрешений и вопросов, или оба варианта.

344 </Step>349 </Step>

345</Steps>350</Steps>

346 351

347Если уведомления не приходят:352Если уведомления не приходят:

348 353

349* Если `/config` показывает **No mobile registered**, откройте приложение Claude на своем телефоне, чтобы оно могло обновить свой токен push. Предупреждение исчезает при следующем подключении Remote Control.354* Если `/config` показывает **No mobile registered**, откройте приложение Claude на вашем телефоне, чтобы оно могло обновить свой push-токен. Предупреждение исчезает при следующем подключении Remote Control.

350* На iOS режимы Focus и сводки уведомлений могут подавлять или задерживать push-уведомления. Проверьте Settings → Notifications → Claude.355* На iOS режимы Focus и сводки уведомлений могут подавлять или задерживать push-уведомления. Проверьте Settings → Notifications → Claude.

351* На Android агрессивная оптимизация батареи может задержать доставку. Исключите приложение Claude из оптимизации батареи в системных параметрах.356* На Android агрессивная оптимизация батареи может задержать доставку. Исключите приложение Claude из оптимизации батареи в системных параметрах.

352 357

353Claude Code пропускает мобильные push-уведомления, пока вы печатаете или сосредоточены на подключённом терминале. Начиная с версии v2.1.181, вы можете установить [`CLAUDE_CLIENT_PRESENCE_FILE`](/docs/ru/env-vars) на путь файла-маркера, чтобы расширить это на любое время, когда вы находитесь у машины, даже в другом окне: уведомления пропускаются, пока файл существует. Настройте прослушиватель блокировки экрана или аналогичный инструмент для создания файла при разблокировке экрана и удаления его при блокировке экрана.358Claude Code пропускает мобильные push-уведомления, пока вы печатаете или сосредоточены на подключенном терминале. Чтобы расширить это на любое время, когда вы находитесь у машины, даже в другом окне, установите [`CLAUDE_CLIENT_PRESENCE_FILE`](/docs/ru/env-vars) на путь файла-маркера: уведомления пропускаются, пока файл существует. Настройте прослушиватель блокировки экрана или аналогичный инструмент для создания файла при разблокировке экрана и удаления его при блокировке экрана.

354 359

355<h2 id="limitations">360<h2 id="limitations">

356 Ограничения361 Ограничения

357</h2>362</h2>

358 363

359* **Один удалённый сеанс на интерактивный процесс**: вне режима сервера каждый экземпляр Claude Code поддерживает один удалённый сеанс одновременно. Используйте [режим сервера](#start-a-remote-control-session) для запуска нескольких одновременных сеансов из одного процесса.364* **Один удалённый сеанс на интерактивный процесс**: вне режима сервера каждый экземпляр Claude Code поддерживает один удалённый сеанс одновременно. Используйте [режим сервера](#start-a-remote-control-session) для запуска нескольких одновременных сеансов из одного процесса.

360* **Локальный процесс должен продолжать работать**: Remote Control работает как локальный процесс. Если вы закроете терминал, выйдете из VS Code или иным образом остановите процесс `claude`, сеанс перейдёт в автономный режим до тех пор, пока вы не [восстановите его](#resume-sessions-after-stopping-the-server). Если Claude не находится в процессе выполнения задачи, claude.ai и приложение Claude показывают сеанс как автономный в течение нескольких секунд после завершения процесса. Чтобы сеанс продолжал работать на удалённой машине после отключения от SSH, запустите его внутри `tmux` или `screen`.365* **Локальный процесс должен продолжать работу**: Remote Control работает как локальный процесс. Если вы закроете терминал, выйдете из Desktop-приложения или VS Code или иным образом остановите процесс `claude`, сеанс перейдёт в автономный режим до тех пор, пока вы не [восстановите его](#resume-sessions-after-stopping-the-server). Чтобы сеанс продолжал работать на удалённой машине после отключения от SSH, запустите его внутри `tmux` или `screen`.

361* **Сбойные сеансы в режиме сервера**: если сеанс, обслуживаемый `claude remote-control`, дает сбой, отправьте ему сообщение с подключённого устройства. Claude Code обслужит его снова. Вам не нужно перезапускать сервер. Требуется Claude Code v2.1.238 или позже.366* **Сбойные сеансы в режиме сервера**: если сеанс, обслуживаемый `claude remote-control`, дает сбой, отправьте ему сообщение с подключённого устройства. Claude Code обслуживает его снова. Вам не нужно перезапускать сервер. Требуется Claude Code v2.1.238 или позже.

362* **HTTP 403 отказы в подключённом сеансе**: после подключения интерактивного сеанса Claude Code продолжает повторные попытки в течение трёх минут, когда что-то между вашей машиной и серверами Anthropic отвечает с HTTP 403, что может произойти после изменения VPN или сети. Если отказы продолжаются дольше, Claude Code отключается, и причина указывает, что отказало: сетевой край или прокси, VPN или брандмауэр в вашей собственной сети.367* **HTTP 403 отказы в подключённом сеансе**: после подключения интерактивного сеанса Claude Code продолжает повторять попытки в течение трёх минут, когда что-то между вашей машиной и серверами Anthropic отвечает с HTTP 403, что может произойти после изменения VPN или сети. Если отказы продолжаются дольше, Claude Code отключается, и причина указывает, что отказало: сетевой край или прокси, VPN или брандмауэр в вашей собственной сети.

363* **Продолжительный сбой сети**: если ваша машина включена, но не может достичь сеть, то, что вы делаете дальше, зависит от режима:368* **Продолжительный сбой сети**: если ваша машина включена, но не может подключиться к сети, то, что вы делаете дальше, зависит от режима:

364 * **Режим сервера**: Claude Code сдаётся примерно через 10 минут и процесс `claude remote-control` завершается. Запустите `claude remote-control` снова, чтобы начать новый сеанс.369 * **Режим сервера**: Claude Code сдаётся примерно через 10 минут и процесс `claude remote-control` завершается. Запустите `claude remote-control` снова, чтобы начать новый сеанс.

365 * **Интерактивный сеанс**: продолжайте работать локально. Claude Code повторяет попытки столько, сколько длится сбой, и переподключается автоматически, когда сеть восстанавливается.370 * **Интерактивный сеанс**: продолжайте работать локально. Claude Code повторяет попытки столько, сколько длится сбой, и автоматически переподключается, когда сеть восстанавливается.

366* **Сбой импульсов присутствия**: если интерактивный сеанс отключается с сообщением `could not reach the Remote Control server for about 30 minutes`, запустите `/remote-control` для переподключения. Claude Code показывает это сообщение только когда импульсы присутствия сеанса не работают, а остальная часть соединения остаётся активной; он повторно регистрирует сеанс примерно на 30 минут перед отключением.371* **Сбой пульса присутствия**: если интерактивный сеанс отключается с сообщением `could not reach the Remote Control server for about 30 minutes`, запустите `/remote-control` для переподключения.

367* **Переданные диалоги истекают**: Claude Code держит подсказки разрешений и вопросы `AskUserQuestion` открытыми до тех пор, пока вы на них не ответите. Когда Claude Code передаёт другой вид диалога удалённому сеансу, например подсказку выбора модели, показываемую после отказа по соображениям безопасности, он ждёт пять минут по умолчанию, затем закрывает диалог и продолжает с действием по умолчанию диалога при отсутствии действия. Установите [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry) для настройки или отключения крайнего срока. Требуется Claude Code v2.1.224 или позже.372* **Переадресованные диалоги истекают**: Claude Code держит подсказки разрешений и вопросы `AskUserQuestion` открытыми до тех пор, пока вы на них не ответите. Когда Claude Code переадресует другой вид диалога на удалённый сеанс, например подсказку выбора модели, показываемую после отказа по соображениям безопасности, он ждёт пять минут по умолчанию, затем закрывает диалог и продолжает с действием по умолчанию диалога без действия. Установите [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry) для настройки или отключения крайнего срока. Требуется Claude Code v2.1.224 или позже.

368* **Подсказка согласия на использование кредитов Fable не передаётся**: Claude Code показывает подсказку согласия на использование кредитов [Fable](/docs/ru/model-config#fable-and-usage-credits) в середине сеанса только там, где работает сеанс, а не на вашем устройстве. Когда сеанс работает в терминале и никто там не отвечает до того, как Claude Code закроет подсказку, ход завершается без отправки запроса; см. [Подсказка подтверждения осталась без ответа](/docs/ru/errors#the-prompt-to-confirm-went-unanswered).373* **Подсказка согласия на использование кредитов Fable не переадресуется**: Claude Code показывает подсказку согласия на использование кредитов Fable в середине сеанса [Fable usage-credits consent prompt](/docs/ru/model-config#fable-and-usage-credits) только там, где работает сеанс, а не на вашем устройстве. Когда сеанс работает в терминале и никто там не отвечает до того, как Claude Code закроет подсказку, ход завершается без отправки запроса; см. [The prompt to confirm went unanswered](/docs/ru/errors#the-prompt-to-confirm-went-unanswered).

369* **Некоторые команды работают только локально**: команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, работают только из локального CLI, независимо от того, передаёте ли вы аргумент или нет. Следующие команды работают с мобильных устройств и веб-браузеров:374* **Некоторые команды только локальные**: команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, работают только из локального CLI, независимо от того, передаёте ли вы аргумент или нет. Следующие работают с мобильных и веб-приложений:

370 * Команды с текстовым выводом: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap` и `/reload-plugins`. `/usage-credits` выводит URL биллинга вместо открытия браузера. `/reload-plugins` работает только когда сеанс работает в интерактивном терминале; сеанс без него отклоняет его.375 * Команды с текстовым выводом: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap` и `/reload-plugins`. `/usage-credits` выводит URL биллинга вместо открытия браузера. `/reload-plugins` работает только когда сеанс работает в интерактивном терминале; сеанс без него отклоняет его.

371 * `/model`, `/effort`, `/fast`, `/color` и `/rename`: передайте значение как аргумент, например `/model sonnet` или `/effort high`. С мобильных устройств и веб-браузеров `/model` и `/effort` принимают аргумент вместо выбора в терминале или ползунка.376 * `/model`, `/effort`, `/fast`, `/color` и `/rename`: передайте значение как аргумент, например `/model sonnet` или `/effort high`. С мобильных и веб-приложений `/model` и `/effort` принимают аргумент вместо средства выбора терминала или ползунка.

372 * `/mcp`: с мобильного приложения возвращает текстовое резюме статуса сервера вместо открытия выбора. В веб-версии `/mcp` без аргументов открывает каталог [соединителей claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) вместо возврата резюме. [Подкоманды](/docs/ru/commands#all-commands) `reconnect`, `enable` и `disable` работают в обоих случаях. В отличие от локального CLI, `/mcp reconnect` без имени сервера переподключает каждый сервер, который не работает или требует аутентификации.377 * `/mcp`: из мобильного приложения возвращает текстовое резюме статуса сервера вместо открытия средства выбора. В веб-приложении `/mcp` само по себе открывает каталог [claude.ai connectors](/docs/ru/mcp#use-mcp-servers-from-claude-ai) вместо возврата резюме. [Подкоманды](/docs/ru/commands#all-commands) `reconnect`, `enable` и `disable` работают с обоих. В отличие от локального CLI, `/mcp reconnect` без имени сервера переподключает каждый сервер, который дал сбой или требует аутентификации.

373 * `/config`: с мобильного приложения передайте `key=value` для установки параметра или запустите её без аргументов, чтобы вывести список ключей, которые вы можете установить. В веб-версии `/config` открывает раздел Claude Code ваших параметров и игнорирует текст после команды.378 * `/config`: из мобильного приложения передайте `key=value` для установки параметра или запустите его без аргумента, чтобы вывести список ключей, которые вы можете установить. В веб-приложении `/config` вместо этого открывает раздел Claude Code ваших параметров и игнорирует текст после команды.

374 * На Team и Enterprise `/usage-credits` с мобильного устройства или веб-браузера не отправляет [запрос на использование кредитов вашему администратору](/docs/ru/costs#add-usage-credits-to-your-subscription). Отправка требует подтверждения, которое появляется только в интерактивном CLI, поэтому команда говорит вам запустить её там. До версии 2.1.211 текстовая форма отправляла запрос без подтверждения.379 * На Team и Enterprise `/usage-credits` с мобильных или веб-приложений не отправляет [usage-credits request to your admin](/docs/ru/costs#add-usage-credits-to-your-subscription). Отправка требует подтверждения, которое появляется только в интерактивном CLI, поэтому команда говорит вам запустить его там.

375 * `/autocompact`, начиная с версии 2.1.221: передайте размер окна как аргумент, например `/autocompact 500k`. Без аргумента он выводит текущий размер окна как текст вместо открытия диалога, который команда показывает в сеансе терминала.380 * `/autocompact`, начиная с v2.1.221: передайте размер окна как аргумент, например `/autocompact 500k`. Без аргумента он выводит текущий размер окна как текст вместо открытия диалога, который команда показывает в сеансе терминала.

376 * `/advisor`, начиная с версии 2.1.260: передайте модель как аргумент, например `/advisor opus`, или передайте `off` для отключения советника. Обе формы применяются только к текущему сеансу и оставляют ваше сохранённое значение по умолчанию без изменений. Без аргумента он выводит текущего советника как текст вместо открытия выбора.381 * `/advisor`, начиная с v2.1.260: передайте модель как аргумент, например `/advisor opus`, или передайте `off` для отключения советника. Обе формы применяются только к текущему сеансу и оставляют ваше сохранённое значение по умолчанию без изменений. Без аргумента он выводит текущего советника как текст вместо открытия средства выбора.

377 * `/output-style`, начиная с версии 2.1.269: передайте имя стиля как аргумент, например `/output-style concise`, или запустите её без аргумента, чтобы вывести список стилей. С мобильных устройств и веб-браузеров вы можете выводить и выбирать только [встроенные стили](/docs/ru/output-styles#built-in-output-styles). Чтобы использовать [пользовательский стиль](/docs/ru/output-styles#create-a-custom-output-style), выберите его в самом сеансе.382 * `/output-style`, начиная с v2.1.269: передайте имя стиля как аргумент, например `/output-style concise`, или запустите его без аргумента, чтобы вывести список стилей. С мобильных и веб-приложений вы можете выводить и выбирать только [встроенные стили](/docs/ru/output-styles#built-in-output-styles). Чтобы использовать [пользовательский стиль](/docs/ru/output-styles#create-a-custom-output-style), выберите его в самом сеансе.

383 * `/focus`, начиная с v2.1.281: передайте `on` или `off` как аргумент, например `/focus on`, или запустите его без аргумента для переключения [focus view](/docs/ru/commands#all-commands). Обе формы применяются только к текущему сеансу и оставляют вашу сохранённую выборку без изменений.

378 384

379<h2 id="troubleshooting">385<h2 id="troubleshooting">

380 Troubleshooting386 Troubleshooting

388 394

389* Вышли из системы, из `/remote-control` или `--remote-control`: `Remote Control requires a claude.ai subscription.` или `/remote-control requires a claude.ai subscription.`395* Вышли из системы, из `/remote-control` или `--remote-control`: `Remote Control requires a claude.ai subscription.` или `/remote-control requires a claude.ai subscription.`

390* Вышли из системы, из `claude remote-control`: `You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.`396* Вышли из системы, из `claude remote-control`: `You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.`

391* Вошли в систему, но используется ключ API или токен: `Remote Control requires claude.ai subscription auth.` с последующим указанием используемых учётных данных, таких как `ANTHROPIC_API_KEY is set, so this session is using API-key auth`. Параметр `apiKeyHelper` и `ANTHROPIC_AUTH_TOKEN` называются одинаково.397* Вошли в систему, но используется API ключ или токен: `Remote Control requires claude.ai subscription auth.` с последующим указанием используемых учётных данных, таких как `ANTHROPIC_API_KEY is set, so this session is using API-key auth`. Параметр `apiKeyHelper` и `ANTHROPIC_AUTH_TOKEN` называются одинаково.

392 398

393Запустите `claude auth login` и выберите опцию claude.ai. Если сообщение указывает на `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN`, удалите его везде, где он установлен: в переменных окружения вашей оболочки или в блоке `env` [файла параметров](/docs/ru/settings-reference#env). Если оно указывает на `apiKeyHelper`, удалите этот параметр.399Запустите `claude auth login` и выберите опцию claude.ai. Если сообщение указывает на `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN`, удалите его везде, где он установлен: в переменных окружения вашей оболочки или в блоке `env` [файла параметров](/docs/ru/settings-reference#env). Если оно указывает на `apiKeyHelper`, удалите этот параметр.

394 400

395До версии 2.1.206 запуск `/remote-control` при выходе из системы сообщал `Unknown command: /remote-control` вместо этого сообщения.

~~396~~

397<h3 id="remote-control-requires-a-full-scope-login-token">401<h3 id="remote-control-requires-a-full-scope-login-token">

398 "Remote Control requires a full-scope login token"402 "Remote Control requires a full-scope login token"

399</h3>403</h3>

400 404

401Вы аутентифицированы с помощью долгоживущего токена из `claude setup-token` или переменной окружения `CLAUDE_CODE_OAUTH_TOKEN`. Эти токены могут только делать запросы к модели, поэтому они не могут устанавливать сеансы Remote Control. Запустите `claude auth login` для аутентификации с помощью токена сеанса полного объёма вместо этого.405Вы аутентифицированы с помощью долгоживущего токена из `claude setup-token` или переменной окружения `CLAUDE_CODE_OAUTH_TOKEN`. Эти токены могут только делать запросы к модели, поэтому они не могут установить сеансы Remote Control. Запустите `claude auth login` для аутентификации с помощью токена сеанса полного объёма вместо этого.

402 406

403<h3 id="unable-to-determine-your-organization-for-remote-control-eligibility">407<h3 id="unable-to-determine-your-organization-for-remote-control-eligibility">

404 "Unable to determine your organization for Remote Control eligibility"408 "Unable to determine your organization for Remote Control eligibility"

414 418

415Запустите `claude doctor` для просмотра того, какая отдельная проверка прав доступа не прошла. Конфликты переменных окружения, недостижимые проверки и параметр Remote Control вашей организации каждый производят своё собственное сообщение, поэтому эта ошибка означает, что сама проверка на уровне учётной записи не прошла.419Запустите `claude doctor` для просмотра того, какая отдельная проверка прав доступа не прошла. Конфликты переменных окружения, недостижимые проверки и параметр Remote Control вашей организации каждый производят своё собственное сообщение, поэтому эта ошибка означает, что сама проверка на уровне учётной записи не прошла.

416 420

417До версии 2.1.239 это сообщение гласило "Remote Control is not yet enabled for your account". До версии 2.1.154 переменная, которая отключает оценку флага функции, такая как `DISABLE_TELEMETRY` или `DO_NOT_TRACK`, также производила это сообщение; запись "Remote Control requires feature-flag evaluation" ниже охватывает эту конфигурацию.421До версии 2.1.239 это сообщение читалось как "Remote Control is not yet enabled for your account".

418 422

419<h3 id="couldn’t-verify-remote-control-eligibility">423<h3 id="couldn’t-verify-remote-control-eligibility">

420 "Couldn't verify Remote Control eligibility"424 "Couldn't verify Remote Control eligibility"

421</h3>425</h3>

422 426

423Claude Code не смог достичь сервиса флагов функций для проверки того, включён ли Remote Control для вашей учётной записи, обычно потому, что вы находитесь в автономном режиме или прокси блокирует запрос. Повторите попытку, когда у вас будет доступ в сеть, или запустите `claude doctor` для получения подробностей. Связанное сообщение "Couldn't verify your organization's Remote Control policy" означает, что Claude Code не смог прочитать эту политику, и имеет то же исправление. Оба сообщения были добавлены в версии 2.1.178.427Claude Code не смог связаться со службой флагов функций для проверки того, включён ли Remote Control для вашей учётной записи, обычно потому, что вы находитесь в автономном режиме или прокси блокирует запрос. Повторите попытку, когда у вас будет доступ в сеть, или запустите `claude doctor` для получения подробной информации. Связанное сообщение "Couldn't verify your organization's Remote Control policy" означает, что Claude Code столкнулся с ошибкой при чтении этой политики и имеет то же решение.

424 428

425<h3 id="remote-control-requires-feature-flag-evaluation">429<h3 id="remote-control-requires-feature-flag-evaluation">

426 "Remote Control requires feature-flag evaluation"430 "Remote Control requires feature-flag evaluation"

427</h3>431</h3>

428 432

429Одна из этих переменных установлена: [`DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` или `DISABLE_GROWTHBOOK`](/docs/ru/env-vars). Каждая из них отключает оценку флага функции, от которой зависит доступность Remote Control, и полное сообщение называет переменную, которую нашёл Claude Code. Отмените установку этой переменной везде, где она установлена, в переменных окружения вашей оболочки или в блоке `env` [файла `settings.json`](/docs/ru/settings-reference#all-settings). В версиях до 2.1.154 та же конфигурация производит "Remote Control is not yet enabled for your account" вместо этого.433[Переменная окружения](/docs/ru/env-vars#features-that-need-feature-flag-fetching), которая отключает оценку флагов функций, установлена, и полное сообщение указывает переменную, которую нашёл Claude Code. На версиях до 2.1.154 та же конфигурация производит "Remote Control is not yet enabled for your account" вместо этого. Что делать, зависит от переменной, которую указывает сообщение:

434

435* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` или `DISABLE_GROWTHBOOK`**: отключите переменную везде, где она установлена, в переменных окружения вашей оболочки или в блоке `env` файла [`settings.json`](/docs/ru/settings-reference#all-settings).

436* **`DISABLE_TELEMETRY` или `DO_NOT_TRACK`**: на плане Pro, Max, Team или Enterprise с отключённым `DISABLE_GROWTHBOOK`, эти переменные оставляют Remote Control доступным, если только ваша организация не требует [Trusted Devices](#trusted-devices). Если требует, отключите переменную везде, где она установлена, для использования Remote Control. С версии 2.1.154 по версию 2.1.282 любая переменная производила это сообщение, поэтому обновите Claude Code до версии 2.1.283 или позже.

430 437

431<h3 id="remote-control-is-only-available-when-using-claude-via-api-anthropic-com">438<h3 id="remote-control-is-only-available-when-using-claude-via-api-anthropic-com">

432 "Remote Control is only available when using Claude via api.anthropic.com"439 "Remote Control is only available when using Claude via api.anthropic.com"

433</h3>440</h3>

434 441

435Сеанс не разговаривает с API Anthropic напрямую, поэтому нет бэкенда claude.ai для сопряжения. Это происходит на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Это также происходит, когда [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, такой как [LLM gateway](/docs/ru/llm-gateway) или прокси, даже если вы входите с помощью claude.ai. До версии 2.1.196 Claude Code не показывал это сообщение для пользовательского `ANTHROPIC_BASE_URL`. Смотрите [справочник ошибок](/docs/ru/errors#remote-control-requires-the-anthropic-api) для полного списка причин.442Сеанс не разговаривает с API Anthropic напрямую, что требует Remote Control. Это происходит на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Это также происходит, когда [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, такой как [LLM gateway](/docs/ru/llm-gateway) или прокси, даже если вы входите с claude.ai. Смотрите [справочник ошибок](/docs/ru/errors#remote-control-requires-the-anthropic-api) для полного списка причин.

436 443

437Сообщение называет то, что направило сеанс в сторону от API Anthropic, такое как `CLAUDE_CODE_USE_BEDROCK` или пользовательский `ANTHROPIC_BASE_URL`. Если у вас есть подходящий вход claude.ai, отмените установку названной переменной, удалите её из ключа `env` в [параметрах](/docs/ru/settings), если вы установили её там, и перезагрузите сеанс. До версии 2.1.219 сообщение было только предложением в заголовке этого раздела, поэтому в более старых версиях проверьте вашу среду самостоятельно на наличие переменных поставщика, таких как `CLAUDE_CODE_USE_BEDROCK` и `CLAUDE_CODE_USE_VERTEX`, и для `ANTHROPIC_BASE_URL`.444Сообщение указывает, что направило сеанс в сторону от API Anthropic, такое как `CLAUDE_CODE_USE_BEDROCK` или пользовательский `ANTHROPIC_BASE_URL`. Если у вас есть подходящий вход claude.ai, отключите названную переменную, удалите её из ключа `env` в [параметрах](/docs/ru/settings), если вы установили её там, и перезагрузите сеанс.

438 445

439<h3 id="remote-control-is-disabled-by-your-organization’s-policy">446<h3 id="remote-control-is-disabled-by-your-organization’s-policy">

440 "Remote Control is disabled by your organization's policy"447 "Remote Control is disabled by your organization's policy"

441</h3>448</h3>

442 449

443Политика блокирует Remote Control, или Claude Code не смог загрузить политику вашей организации на этой машине и временно держит Remote Control отключённым. Проверьте эти причины по порядку:450Политика блокирует Remote Control. Проверьте эти причины по порядку:

451

452* **Ошибка упоминает `disableRemoteControl`**: ваш администратор IT отключил Remote Control на этом устройстве через [управляемые параметры](/docs/ru/managed-settings), независимо от переключателя на уровне организации и от того, как вы вошли.

453* **Ваш план claude.ai — Pro или Max**: Claude Code всё ещё вошёл в организацию Team или Enterprise с более раннего входа, поэтому он проверяет политику Remote Control этой организации. Запустите `/status` для просмотра того, какой план и организацию использует ваш вход. Запустите `claude auth logout`, а затем `claude auth login` для повторного входа под вашим текущим планом.

454* **Сообщение не говорит обратиться к администратору вашей организации**: ваша организация имеет конфигурацию HIPAA, которая несовместима с Remote Control, и `/status` указывает `HIPAA` в строке `Compliance`. В этом состоянии переключатель Remote Control в панели администратора неактивен, поэтому Owner не может изменить его там. Обратитесь в службу поддержки Anthropic для обсуждения вариантов. До версии 2.1.267 этот случай показывал "Remote Control isn't available for your organization due to its compliance policy" вместо этого.

455* **В противном случае Owner не включил его для вашей организации**: Remote Control отключён по умолчанию на планах Team и Enterprise. Owner может включить его на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code), включив переключатель **Remote Control**. Этот переключатель является параметром организации на стороне сервера.

456

457До версии 2.1.281 это сообщение также появлялось, когда Claude Code не загрузил политику вашей организации на этой машине, например после запуска в автономном режиме. Более поздние версии сообщают об этом состоянии как [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) вместо этого.

458

459<h3 id="couldnt-verify-your-organizations-policy-for-remote-control">

460 "Couldn't verify your organization's policy for remote control"

461</h3>

462

463Claude Code не смог получить политику вашей организации и не имеет сохранённой копии на этой машине для использования вместо этого, поэтому он держит Remote Control отключённым, пока не сможет подтвердить, что ваша организация это позволяет. Это обычно происходит, когда вы запускаете Claude Code в автономном режиме или до подключения VPN, или когда прокси мешает запросу. На медленном соединении это также может появиться, пока первый запрос всё ещё в пути.

464

465Сообщение принимает одну из этих форм:

444 466

445* **Ошибка упоминает `disableRemoteControl`**: ваш администратор IT отключил Remote Control на этом устройстве через [управляемые параметры](/docs/ru/managed-settings), независимо от переключателя на уровне организации и от того, как вы вошли в систему.467* Из `/remote-control`, `claude remote-control` или `claude --remote-control`: `Couldn't verify your organization's policy for remote control. Check your network connection and try again.`

446* **Ваш план claude.ai — Pro или Max**: Claude Code по-прежнему вошёл в систему под организацией Team или Enterprise из более раннего входа, поэтому он проверяет политику Remote Control этой организации. Запустите `/status` для просмотра того, какой план и организацию использует ваш вход. Запустите `claude auth logout`, а затем `claude auth login` для повторного входа под вашим текущим планом.468* Из [автоподключения](#enable-remote-control-for-all-sessions) при запуске сеанса: `couldn't verify your organization's policy — check your network connection and try again`, с префиксом `Remote Control failed` в уведомлении и `Remote Control disconnected` в разговоре. Сеанс затем оставляет Remote Control отключённым.

447* **Политика организации не загрузилась на этой машине**: запустите `claude doctor` и прочитайте строку `Organization policy`. Если строка показывает, что политика не загружена, это то, что держит Remote Control отключённым. До версии 2.1.261 `claude doctor` не печатал эту строку.469

448* **Сообщение не говорит обратиться к администратору вашей организации**: ваша организация имеет конфигурацию HIPAA, которая несовместима с Remote Control, и `/status` указывает `HIPAA` в своей строке `Compliance`. В этом состоянии переключатель Remote Control в панели администратора неактивен, поэтому Owner не может изменить его там. Обратитесь в службу поддержки Anthropic для обсуждения вариантов. До версии 2.1.267 этот случай показывал "Remote Control isn't available for your organization due to its compliance policy" вместо этого.470Восстановите подключение к сети, затем запустите `/remote-control` или запустите команду снова. Каждая попытка снова проверяет политику, поэтому вам не нужно перезагружать Claude Code. Если сообщение продолжает появляться, запустите `claude doctor` и прочитайте его строку `Organization policy`, которая говорит, почему политика не загрузилась.

449* **В противном случае Owner не включил его для вашей организации**: Remote Control отключён по умолчанию в планах Team и Enterprise. Owner может включить его на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code), включив переключатель **Remote Control**. Этот переключатель является параметром организации на стороне сервера.471

472До версии 2.1.281 это состояние показывало `Remote Control is disabled by your organization's policy` вместо этого.

450 473

451<h3 id="remote-credentials-fetch-failed">474<h3 id="remote-credentials-fetch-failed">

452 "Remote credentials fetch failed"475 "Remote credentials fetch failed"

453</h3>476</h3>

454 477

455Claude Code не смог получить краткосрочные учётные данные из API Anthropic для установления соединения. Повторно запустите с `--verbose` для просмотра полной ошибки:478Claude Code не смог получить краткосрочные учётные данные из API Anthropic для установления соединения. Запустите снова с `--verbose` для просмотра полной ошибки:

456 479

457```bash theme={null}480```bash theme={null}

458claude remote-control --verbose481claude remote-control --verbose

460 483

461Распространённые причины:484Распространённые причины:

462 485

463* Не вошли в систему: запустите `claude` и используйте `/login` для аутентификации с помощью вашей учётной записи claude.ai. Аутентификация с помощью ключа API не поддерживается для Remote Control.486* Не вошли в систему: запустите `claude` и используйте `/login` для аутентификации с помощью вашей учётной записи claude.ai. Аутентификация по API ключу не поддерживается для Remote Control.

464* Проблема с сетью или прокси: брандмауэр или прокси может блокировать исходящий запрос HTTPS. Remote Control требует доступа к API Anthropic на порту 443.487* Проблема с сетью или прокси: брандмауэр или прокси может блокировать исходящий HTTPS запрос. Remote Control требует доступа к API Anthropic на порту 443.

465* Ошибка создания сеанса: если вы также видите `Session creation failed — see debug log`, ошибка произошла ранее в процессе настройки. Проверьте, что ваша подписка активна.488* Ошибка создания сеанса: если вы также видите `Session creation failed — see debug log`, ошибка произошла ранее в процессе установки. Проверьте, что ваша подписка активна.

~~466~~

467Устаревший токен входа не вызывает эту ошибку. Когда API Anthropic отклоняет сохранённый токен, например потому что другой процесс Claude Code уже обновил его, Claude Code обновляет токен и повторяет попытку самостоятельно. До версии 2.1.224 устаревший токен вызывал сбой запуска Remote Control с этим сообщением, поэтому сеансы, установленные на [автоматическое подключение](#enable-remote-control-for-all-sessions), могли периодически не запускаться при запуске.

468 489

469<h3 id="couldn’t-reconnect-to-your-remote-control-session">490<h3 id="couldnt-reconnect-to-your-remote-control-session">

470 "Couldn't reconnect to your Remote Control session"491 "Couldn't reconnect to your Remote Control session"

471</h3>492</h3>

472 493

473Когда вы возобновляете разговор с `claude --resume` или `claude --continue`, Claude Code переподключается к сеансу Remote Control, записанному в этом разговоре. Это сообщение означает, что переподключение не удалось по причине, которая может быть временной, такой как сетевой сбой или ошибка сервера, поэтому Claude Code не может подтвердить, существует ли удалённый сеанс.494Когда вы возобновляете разговор с `claude --resume` или `claude --continue`, Claude Code переподключается к сеансу Remote Control, записанному в этом разговоре. Это сообщение означает, что переподключение не удалось по причине, которая может быть временной, такой как сетевой сбой или ошибка сервера, поэтому Claude Code не может подтвердить, существует ли удалённый сеанс.

474 495

475Запустите `/remote-control` для повторной попытки подключения, или начните новый сеанс с `claude --remote-control` для создания нового сеанса Remote Control. Ваш локальный сеанс продолжает работать без Remote Control в то же время.496Запустите `/remote-control` для повторной попытки подключения, или запустите новый сеанс с `claude --remote-control` для создания нового сеанса Remote Control. Ваш локальный сеанс продолжает работать без Remote Control в то же время.

~~476~~

477<span id="resume-outcomes" />Когда вы возобновляете, вы также можете получить один из этих результатов вместо этого сообщения:

~~478~~

479* **Сервер сообщает, что записанный сеанс исчез, или запись переподключения называет другую учётную запись**: Claude Code руководствуется тем, что говорит запись переподключения разговора:

480 * **Запись называет вашу вошедшую в систему учётную запись**: Claude Code запускает сеанс замены с автоматически сгенерированным именем и оставляет более ранние сообщения разговора вне его. Вы получаете это после удаления сеанса из claude.ai или приложения Claude, например.

481 * **Запись называет другую учётную запись**: Claude Code запускает новый сеанс без более ранних сообщений разговора и без отображения сообщения, существует ли записанный сеанс или нет.

482 * **Запись не говорит, какой учётной записи принадлежал сеанс, или Claude Code не может прочитать ваш сохранённый вход**: Claude Code показывает [`Previous session is unavailable — run /remote-control to start a new one`](#previous-session-is-unavailable) вместо этого сообщения, ничего не запускает и удаляет запись из разговора.

483* **Вы отключили Remote Control перед возобновлением**: если приложение, в котором размещается Claude Code, не сообщило ему, что приложение владеет сеансом claude.ai, Claude Code удалил запись переподключения, когда вы отключили Remote Control из панели [status](#check-connection-status) CLI, расширения VS Code или хоста, построенного на [Agent SDK](/docs/ru/agent-sdk/overview), поэтому он не переподключается. Когда владеющее приложение отключило его, Claude Code сохранил запись и переподключается.

484* **Другой Claude Code на этой машине по-прежнему имеет сеанс**: вы видите уведомление, которое начинается с `Remote Control not started here`, и Claude Code [оставляет Remote Control отключённым в возобновлённом сеансе](#resume-sessions-after-stopping-the-server). Запустите `/remote-control` там для его перемещения.

~~485~~

486<span id="reconnect-history" />До версии 2.1.232 Claude Code отвечал по-другому, когда сервер сообщал, что записанный сеанс исчез. С версии 2.1.227 по версию 2.1.231 Claude Code отказывался запускать замену даже когда запись совпадала с вашей учётной записью. До версии 2.1.226 Claude Code запускал замену независимо от того, совпадала ли запись с вашей учётной записью, и в версиях 2.1.224–2.1.226 создавал её под учётной записью, вошедшей на эту машину, никогда под другой учётной записью, без загрузки более ранних сообщений разговора в неё. До версии 2.1.200 Claude Code создавал новый сеанс после любого сбоя переподключения.

487 497

488<h3 id="previous-session-is-unavailable">498<h3 id="previous-session-is-unavailable">

489 "Previous session is unavailable — run /remote-control to start a new one"499 "Previous session is unavailable — run /remote-control to start a new one"

490</h3>500</h3>

491 501

492Claude Code не смог восстановить предыдущий сеанс Remote Control и остановился вместо того, чтобы запустить новый самостоятельно. Вы можете увидеть это сообщение после возобновления разговора с `claude --resume` или `claude --continue`, или после того как Claude Code [переподключается самостоятельно после отключения](/docs/ru/errors#remote-control-couldnt-refresh-your-login).502Claude Code не смог восстановить предыдущий сеанс Remote Control и остановился вместо того, чтобы запустить новый самостоятельно. Вы можете увидеть это сообщение после возобновления разговора с `claude --resume` или `claude --continue`, или после того, как Claude Code [переподключится самостоятельно после отключения](/docs/ru/errors#remote-control-couldnt-refresh-your-login).

493 503

494Запустите `/remote-control` для запуска нового сеанса Remote Control под текущим входом; ваш локальный сеанс продолжает работать без Remote Control в то же время. Связанное сообщение `Remote Control could not verify the signed-in account — run /remote-control to reconnect` имеет то же исправление; Claude Code показывает его, когда вошедшая в систему учётная запись изменилась или не могла быть прочитана между её проверкой и переподключением. Если вы запустите `/remote-control` после `Previous session is unavailable` без перезагрузки Claude Code в первую очередь, Claude Code оставляет более ранние сообщения разговора вне нового сеанса.504Запустите `/remote-control` для запуска нового сеанса Remote Control под текущим входом; ваш локальный сеанс продолжает работать без Remote Control в то же время. Связанное сообщение `Remote Control could not verify the signed-in account — run /remote-control to reconnect` имеет то же решение. Если вы запустите `/remote-control` после `Previous session is unavailable` без перезагрузки Claude Code в первую очередь, Claude Code оставляет более ранние сообщения разговора вне нового сеанса.

~~495~~

496При возобновлении Claude Code [запускает новый сеанс на его месте](#resume-outcomes) только если запись переподключения разговора называет учётную запись, которой принадлежал сеанс, потому что сервер сообщает о сеансе, который вы удалили, и сеансе, принадлежащем другой учётной записи, одинаково. Claude Code до версии 2.1.227 не записывал эту учётную запись, и Claude Code не может проверить запись, когда не может прочитать ваш сохранённый вход. Claude Code до версии 2.1.232 показывал `Remote Control could not resume the previous session under the current login — run /remote-control to start fresh` вместо этого, в [другом наборе случаев](#reconnect-history).

497 505

498<h3 id="remote-control-got-an-unexpected-server-response">506<h3 id="remote-control-got-an-unexpected-server-response">

499 "Remote Control got an unexpected server response"507 "Remote Control got an unexpected server response"

500</h3>508</h3>

501 509

502Сервер Remote Control принял запрос, но ответил в форме, которую эта версия Claude Code не смогла прочитать, при создании удалённого сеанса или получении его учётных данных. Повторная попытка на той же версии не удаётся таким же образом. Запустите `claude update`, а затем запустите `/remote-control` для переподключения. Это сообщение было добавлено в версии 2.1.225.510Сервер Remote Control принял запрос, но ответил в форме, которую эта версия Claude Code не смогла прочитать, при создании удалённого сеанса или получении его учётных данных. Повторная попытка на той же версии не удаётся таким же образом. Запустите `claude update`, затем запустите `/remote-control` для переподключения.

503 511

504<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">512<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">

505 "Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"513 "Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"

506</h3>514</h3>

507 515

508Ваша организация имеет включённые [Trusted Devices](#trusted-devices) и эта машина ещё не зарегистрирована. Запустите `/login` в Claude Code. Регистрация происходит как часть входа, и нет отдельной команды регистрации.516Ваша организация имеет включённый [Trusted Devices](#trusted-devices) и эта машина ещё не зарегистрирована. Запустите `/login` в Claude Code. Регистрация происходит как часть входа, и нет отдельной команды регистрации.

509 517

510<h3 id="session-expired-for-trusted-device-check">518<h3 id="session-expired-for-trusted-device-check">

511 "session expired for trusted-device check"519 "session expired for trusted-device check"

513 521

514Ваш вход старше 18 часов. Запустите `/login` в Claude Code, или подтвердите с помощью Face ID, Touch ID, Windows Hello или passkey, когда claude.ai или мобильное приложение вас попросит. Смотрите [Trusted Devices](#trusted-devices).522Ваш вход старше 18 часов. Запустите `/login` в Claude Code, или подтвердите с помощью Face ID, Touch ID, Windows Hello или passkey, когда claude.ai или мобильное приложение вас попросит. Смотрите [Trusted Devices](#trusted-devices).

515 523

516<h2 id="choose-the-right-approach">

517 Выберите правильный подход

518</h2>

~~519~~

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

~~521~~

523| :- | :- | :- | :- | :- |

525| [Remote Control](/docs/ru/remote-control) | Управляйте запущенной сессией из [claude.ai/code](https://claude.ai/code) или мобильного приложения Claude | Ваша машина (CLI или VS Code) | Запустите `claude remote-control` | Управление текущей работой с другого устройства |

526| [Channels](/docs/ru/channels) | Отправляйте события из приложения чата, такого как Telegram или Discord, или с вашего собственного сервера | Ваша машина (CLI) | [Установите плагин канала](/docs/ru/channels#quickstart) или [создайте свой](/docs/ru/channels-reference) | Реагирование на внешние события, такие как сбои CI или сообщения в чате |

527| [Slack](/docs/ru/slack) | Упомяните `@Claude` в канале команды | Облако Anthropic | [Установите приложение Slack](/docs/ru/slack#setting-up-claude-code-in-slack) с включенным [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) | PR и рецензии из чата команды |

528| [Self-hosted environments](/docs/ru/self-hosted-environments) | Запустите [облачную сессию](/docs/ru/claude-code-on-the-web) и выберите окружение вашей организации | Инфраструктура вашей организации | [Разверните runners](/docs/ru/self-hosted-environments-quickstart), в планах Team и Enterprise | Облачные сессии, которые должны работать внутри вашей сети |

~~530~~

531<h2 id="related-resources">524<h2 id="related-resources">

532 Связанные ресурсы525 Связанные ресурсы

533</h2>526</h2>

routines.md +3 −2

Details

59Когда расписание рутины или **Run now** запускает запуск, Claude переиздает существующий artifact без запроса только когда все это верно:59Когда расписание рутины или **Run now** запускает запуск, Claude переиздает существующий artifact без запроса только когда все это верно:

60 60

61* Вы можете редактировать artifact и он принадлежит вашей собственной организации61* Вы можете редактировать artifact и он принадлежит вашей собственной организации

62* Artifact не является общедоступным и не совместно используется с конкретными людьми или вашей организацией с последней версией, выбранной как версия, которую видят зрители62* Artifact не является общедоступным

63* Если artifact совместно используется с конкретными людьми или вашей организацией, его зрители не видят автоматически каждую новую версию

63* Переиздание содержит только страницу, без вспомогательных файлов или чего-либо еще добавленного, и не заставляет перезаписать более новую версию64* Переиздание содержит только страницу, без вспомогательных файлов или чего-либо еще добавленного, и не заставляет перезаписать более новую версию

64* Страница не содержит разрешение, которое выходит за пределы страницы, такое как [вызовы коннектора](/docs/ru/artifacts#pull-live-data-with-mcp-connectors)65* Страница не содержит разрешение, которое выходит за пределы страницы, такое как [вызовы коннектора](/docs/ru/artifacts#pull-live-data-with-mcp-connectors)

65 66

151 152

152Триггер расписания запускает рутину по повторяющемуся расписанию или один раз в определенное будущее время. Выберите предустановленную частоту в разделе **Select a trigger**: ежечасно, ежедневно, по рабочим дням или еженедельно. Времена вводятся в вашем локальном часовом поясе и преобразуются автоматически, поэтому рутина запускается в это время независимо от того, где находится облачная инфраструктура.153Триггер расписания запускает рутину по повторяющемуся расписанию или один раз в определенное будущее время. Выберите предустановленную частоту в разделе **Select a trigger**: ежечасно, ежедневно, по рабочим дням или еженедельно. Времена вводятся в вашем локальном часовом поясе и преобразуются автоматически, поэтому рутина запускается в это время независимо от того, где находится облачная инфраструктура.

153 154

154Запуски могут начаться на несколько минут позже запланированного времени из-за разброса. Смещение согласовано для каждой рутины.155Если вы запланируете запуск ровно в час, например в 9:00, он может начаться на несколько минут позже. Чтобы начать близко к запланированному времени, выберите несколько минут после часа, например 9:07.

155 156

156Для пользовательского интервала, такого как каждые два часа или первое число каждого месяца, выберите ближайшую предустановку в форме, затем запустите `/schedule update` в CLI, чтобы установить конкретное выражение cron. Минимальный интервал — один час; выражения, которые запускаются чаще, отклоняются.157Для пользовательского интервала, такого как каждые два часа или первое число каждого месяца, выберите ближайшую предустановку в форме, затем запустите `/schedule update` в CLI, чтобы установить конкретное выражение cron. Минимальный интервал — один час; выражения, которые запускаются чаще, отклоняются.

157 158

sandbox-environments.md +1 −1

Details

117На Linux и WSL2 среда выполнения применяет разрешения на запись только к путям, которые уже существуют. В свежей среде создайте пути конфигурации Claude Code перед первым запуском:117На Linux и WSL2 среда выполнения применяет разрешения на запись только к путям, которые уже существуют. В свежей среде создайте пути конфигурации Claude Code перед первым запуском:

118 118

119```bash theme={null}119```bash theme={null}

120mkdir -p ~/.claude && echo '{}' > ~/.claude.json120mkdir -p ~/.claude && { [ -f ~/.claude.json ] || echo '{}' > ~/.claude.json; }

121```121```

122 122

123После того как файл параметров находится на месте, запустите Claude Code с `npx` и передайте `claude` как команду для обертывания:123После того как файл параметров находится на месте, запустите Claude Code с `npx` и передайте `claude` как команду для обертывания:

sandboxing.md +30 −29

Details

38 </Step>38 </Step>

39 39

40 <Step title="Выберите режим">40 <Step title="Выберите режим">

41 На вкладке Mode выберите автоматическое разрешение или обычные разрешения. Автоматическое разрешение выполняет изолированные команды без запроса, а обычные разрешения сохраняют обычные запросы разрешений даже когда команды изолированы. См. [Sandbox modes](#sandbox-modes) для информации о том, какие команды всё ещё требуют запроса в режиме автоматического разрешения.41 На вкладке Mode выберите автоматическое разрешение или обычные разрешения. Автоматическое разрешение выполняет изолированные команды без запроса, а обычные разрешения сохраняют обычные запросы разрешений даже когда команды изолированы. См. [Режимы sandbox](#sandbox-modes) для информации о том, какие команды всё ещё требуют запроса в режиме автоматического разрешения.

42 </Step>42 </Step>

43 43

44 <Step title="Выполните команду Bash">44 <Step title="Выполните команду Bash">

45 Попросите Claude выполнить команду, например сборку или набор тестов. По умолчанию команды внутри sandbox могут писать в рабочий каталог, каталог временных файлов сеанса и любые [каталоги, которые вы добавили](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) с помощью `--add-dir`, `/add-dir` или `permissions.additionalDirectories`.45 Попросите Claude выполнить команду, например сборку или набор тестов. По умолчанию команды внутри sandbox могут писать в рабочий каталог, [каталог временных файлов сеанса](/docs/ru/env-vars) и любые [каталоги, которые вы добавили](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) с помощью `--add-dir`, `/add-dir` или `permissions.additionalDirectories`.

46 46

47 Первый раз, когда команде требуется новый сетевой домен, Claude Code запрашивает одобрение; в [режиме auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) Claude вместо этого называет хосты, которые требует команда, [в самой команде](#per-command-allowed-domains-in-auto-mode) для проверки классификатором вместе с ней.47 Первый раз, когда команде требуется новый сетевой домен, Claude Code запрашивает одобрение; в [режиме auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) Claude вместо этого называет хосты, которые требует команда, [в самой команде](#per-command-allowed-domains-in-auto-mode) для проверки классификатором вместе с ней.

48 48

189 189

190Настройте поведение песочницы через файл `settings.json`. Полную справку по конфигурации см. в разделе [Settings](/docs/ru/settings-reference#sandbox-settings).190Настройте поведение песочницы через файл `settings.json`. Полную справку по конфигурации см. в разделе [Settings](/docs/ru/settings-reference#sandbox-settings).

191 191

192По умолчанию команды в песочнице могут писать в текущий рабочий каталог, временный каталог сеанса и любые [каталоги, которые вы добавили](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) с помощью `--add-dir`, `/add-dir` или `permissions.additionalDirectories`. Если подпроцессы, такие как `kubectl`, `terraform` или `npm`, должны писать вне этих каталогов, используйте `sandbox.filesystem.allowWrite` для предоставления доступа к определённым путям:192По умолчанию команды в песочнице могут писать в текущий рабочий каталог, временный каталог для каждого пользователя и любые [каталоги, которые вы добавили](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) с помощью `--add-dir`, `/add-dir` или `permissions.additionalDirectories`. Если подпроцессы, такие как `kubectl`, `terraform` или `npm`, должны писать вне этих каталогов, используйте `sandbox.filesystem.allowWrite` для предоставления доступа к определённым путям:

193 193

194```json theme={null}194```json theme={null}

195{195{

244 244

245Если бы вы поместили ту же конфигурацию в `~/.claude/settings.json`, `.` разрешился бы в `~/.claude` вместо этого, и файлы проекта остались бы заблокированными правилом `denyRead`.245Если бы вы поместили ту же конфигурацию в `~/.claude/settings.json`, `.` разрешился бы в `~/.claude` вместо этого, и файлы проекта остались бы заблокированными правилом `denyRead`.

246 246

247Чтобы запретить командам в песочнице доступ на чтение к домашним каталогам и смонтированным томам, сохраняя при этом доступность рабочих каталогов, установите [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) вместо написания правил путей.247Чтобы запретить командам в песочнице доступ на чтение к домашним каталогам и смонтированным томам, сохраняя доступность рабочих каталогов для чтения, установите [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) вместо написания правил путей.

248 248

249<h3 id="disable-filesystem-isolation">249<h3 id="disable-filesystem-isolation">

250 Отключение изоляции файловой системы250 Отключение изоляции файловой системы

251</h3>251</h3>

252 252

253Установите `sandbox.filesystem.disabled` в `true`, чтобы пропустить изоляцию файловой системы, сохраняя при этом изоляцию сети. Пример ниже отключает изоляцию файловой системы, сохраняя список разрешённых доменов сети:253Установите `sandbox.filesystem.disabled` в `true`, чтобы пропустить изоляцию файловой системы, сохраняя изоляцию сети. Пример ниже отключает изоляцию файловой системы, сохраняя список разрешённых доменов сети:

254 254

255```json theme={null}255```json theme={null}

256{256{

266}266}

267```267```

268 268

269Песочница имеет два независимых слоя: [изоляция файловой системы](#filesystem-isolation) контролирует, какие пути могут читать и писать команды в песочнице, а [изоляция сети](#network-isolation) контролирует, какие домены они могут достичь. С отключённым слоем файловой системы команды в песочнице получают неограниченный доступ на чтение и запись к файловой системе хоста, в то время как их исходящий трафик сети остаётся ограниченным вашими разрешёнными доменами. Отключите слой, когда вы используете песочницу для контроля того, где команды подключаются, а не того, что они пишут.269Песочница имеет два независимых слоя: [изоляция файловой системы](#filesystem-isolation) контролирует, какие пути команды в песочнице могут читать и писать, а [изоляция сети](#network-isolation) контролирует, какие домены они могут достичь. С отключённым слоем файловой системы команды в песочнице получают неограниченный доступ на чтение и запись к файловой системе хоста, в то время как их исходящий трафик сети остаётся ограниченным вашими разрешёнными доменами. Отключите слой, когда вы используете песочницу для контроля того, где команды подключаются, а не того, что они пишут.

270 270

271Параметр отключён по умолчанию и применяется на платформах, где работает песочница: macOS, Linux и WSL2. Требуется Claude Code v2.1.216 или позже.271Параметр отключён по умолчанию и применяется на платформах, где работает песочница: macOS, Linux и WSL2. Требуется Claude Code v2.1.216 или позже.

272 272

273<Warning>273<Warning>

274 С отключённой изоляцией файловой системы и автоматически разрешёнными командами команда в песочнице может писать файлы, которые позже выполняют или читают другие команды, такие как файлы запуска оболочки, исполняемые файлы на `$PATH` или `~/.claude/settings.json`, и использовать их для расширения собственного доступа при следующем запуске. Установите `filesystem.disabled` в `true` только для рабочих нагрузок, которым вы доверяете не расширять собственный доступ. Блокировка доменов сети с помощью [`allowManagedDomainsOnly`](#keep-developers-from-widening-the-policy) сужает риск, но не устраняет его, поскольку эта блокировка применяется только к командам, работающим внутри песочницы.274 С отключённой изоляцией файловой системы и автоматически разрешёнными командами команда в песочнице может писать файлы, которые позже выполняют или читают другие команды, такие как файлы инициализации оболочки, исполняемые файлы на `$PATH` или `~/.claude/settings.json`, и использовать их для расширения собственного доступа при следующем запуске. Установите `filesystem.disabled` в `true` только для рабочих нагрузок, которым вы доверяете не расширять собственный доступ. Блокировка доменов сети с помощью [`allowManagedDomainsOnly`](#keep-developers-from-widening-the-policy) сужает риск, но не устраняет его, поскольку эта блокировка применяется только к командам, работающим внутри песочницы.

275</Warning>275</Warning>

276 276

277<h4 id="which-settings-can-disable-it">277<h4 id="which-settings-can-disable-it">

284* Когда управляемые параметры конфигурируют `sandbox.filesystem` вообще или перечисляют любую запись `sandbox.credentials.files` с `"mode": "deny"`, только управляемые параметры могут установить ключ. Это сохраняет ограничения файловой системы, развёрнутые администратором; чтобы ослабить такое развёртывание, установите `"disabled": true` в управляемых параметрах.284* Когда управляемые параметры конфигурируют `sandbox.filesystem` вообще или перечисляют любую запись `sandbox.credentials.files` с `"mode": "deny"`, только управляемые параметры могут установить ключ. Это сохраняет ограничения файловой системы, развёрнутые администратором; чтобы ослабить такое развёртывание, установите `"disabled": true` в управляемых параметрах.

285* Когда установлена [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/ru/env-vars), Claude Code игнорирует `filesystem.disabled` из каждого источника, включая управляемые параметры, и сохраняет изоляцию файловой системы включённой.285* Когда установлена [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/ru/env-vars), Claude Code игнорирует `filesystem.disabled` из каждого источника, включая управляемые параметры, и сохраняет изоляцию файловой системы включённой.

286 286

287Закреплена ли управляемая запись `credentials.files` на `filesystem.disabled`, блокируя ключ для управляемых параметров, чтобы разработчики не могли отключить изоляцию файловой системы, зависит от режима записи и того, что происходит с записью при запуске песочницы:287Закрепляет ли управляемая запись `credentials.files` `filesystem.disabled`, блокируя ключ для управляемых параметров, чтобы разработчики не могли отключить изоляцию файловой системы, зависит от режима записи и того, что происходит с записью при запуске песочницы:

288 288

290| - | - | - |290| - | - | - |

291| `"mode": "deny"` | Да | Ничего: блок чтения является частью слоя файловой системы |291| `"mode": "deny"` | Да | Ничего: блок чтения является частью слоя файловой системы |

292| `"mode": "mask"`, применённый как маска | Нет | Сама маскировка: [копия-дозорный и прокси](#mask-credential-files) на Linux и WSL2, собственные правила чтения песочницы на macOS |292| `"mode": "mask"`, применённый как маска | Нет | Сама маскировка: [копия-дозорный и прокси](#mask-credential-files) на Linux и WSL2, собственные правила чтения песочницы на macOS |

293| `"mode": "mask"`, [вернулся к `deny`](#mask-credential-files) при настройке | Нет | Ничего, как `deny`. Перечислите путь, который не может быть замаскирован, такой как каталог, как явную запись `deny`, которая закрепляет ключ |293| `"mode": "mask"`, [вернулся к `deny`](#mask-credential-files) при настройке | Нет | Ничего, как `deny`. Перечислите путь, который не может быть замаскирован, такой как каталог, как явную запись `deny`, которая закрепляет ключ |

295 295

296Возврат происходит при запуске песочницы, после того как Claude Code уже прочитал параметры, на которых выполняется проверка закрепления, поэтому вернувшаяся запись никогда не закрепляется. Валидация переписывает недействительную запись на `deny` при загрузке параметров, поэтому деградированная запись закрепляется как та, которую вы написали как `deny`.296Возврат происходит при запуске песочницы, после того как Claude Code уже прочитал параметры, на которых выполняется проверка закрепления, поэтому вернувшаяся запись никогда не закрепляет. Валидация переписывает недействительную запись в `deny` при загрузке параметров, поэтому деградированная запись закрепляет как та, которую вы написали как `deny`.

297 297

298<h4 id="what-changes-when-filesystem-isolation-is-off">298<h4 id="what-changes-when-filesystem-isolation-is-off">

299 Что изменяется при отключённой изоляции файловой системы299 Что изменяется при отключённой изоляции файловой системы

301 301

302Установка `filesystem.disabled` снимает защиту, которую сам слой файловой системы применяет. Защиты, которые применяют другие слои, продолжают применяться:302Установка `filesystem.disabled` снимает защиту, которую сам слой файловой системы применяет. Защиты, которые применяют другие слои, продолжают применяться:

303 303

304| Защита | С отключённой изоляцией файловой системы |304| Защита | При отключённой изоляции файловой системы |

305| - | - |305| - | - |

306| `filesystem.denyRead` и [`credentials.files`](#protect-credentials) блоки чтения `deny` | Не применяется. Слой файловой системы применяет оба |306| `filesystem.denyRead` и [`credentials.files`](#protect-credentials) блоки чтения `deny` | Не применяется. Слой файловой системы применяет оба |

307| `credentials.envVars` записи `deny` и `mask` | Применяется. Очистка переменных окружения независима от слоя файловой системы |307| `credentials.envVars` записи `deny` и `mask` | Применяется. Очистка переменных окружения независима от слоя файловой системы |

309 309

310Два других вещи изменяются:310Два других вещи изменяются:

311 311

312* Команды в песочнице наследуют `$TMPDIR` вашей оболочки вместо временного каталога сеанса, потому что каждый временный каталог доступен для записи и Claude Code больше не перенаправляет команды в сеансовый.312* Команды в песочнице наследуют `$TMPDIR` вашей оболочки вместо временного каталога для каждого пользователя, потому что каждый временный каталог доступен для записи и Claude Code больше не перенаправляет команды в каталог для каждого пользователя.

313 313

314 На Linux переменная часто не установлена в родительской оболочке. Руководство инструмента Bash сообщает Claude создавать временные каталоги с помощью `mktemp -d` вместо полагания на `$TMPDIR`.314 На Linux переменная часто не установлена в родительской оболочке. Руководство инструмента Bash указывает Claude создавать временные каталоги с помощью `mktemp -d` вместо полагания на `$TMPDIR`.

315* [`autoAllowBashIfSandboxed`](/docs/ru/settings-reference#sandbox-autoallowbashifsandboxed) по-прежнему по умолчанию `true`, поэтому команды в песочнице продолжают работать без подсказок. Установите его в `false`, чтобы получать подсказки для команд в песочнице.315* [`autoAllowBashIfSandboxed`](/docs/ru/settings-reference#sandbox-autoallowbashifsandboxed) по-прежнему по умолчанию `true`, поэтому команды в песочнице продолжают работать без подсказок. Установите его в `false`, чтобы получать подсказки для команд в песочнице.

316 316

317<h3 id="protect-credentials">317<h3 id="protect-credentials">

351Когда вы [исключаете источник параметров](#configure-sandboxing):351Когда вы [исключаете источник параметров](#configure-sandboxing):

352 352

353* **Параметры проекта или локальные**: Claude Code не применяет ни одну из их записей `credentials`. Требуется Claude Code v2.1.246 или позже.353* **Параметры проекта или локальные**: Claude Code не применяет ни одну из их записей `credentials`. Требуется Claude Code v2.1.246 или позже.

354* **Параметры пользователя**: Claude Code по-прежнему применяет записи `deny` в `~/.claude/settings.json` и сохраняет свои [записи `mask` файла](#mask-credential-files) как ограничения, но отбрасывает свои [записи `mask` переменной окружения](#mask-environment-variables).354* **Параметры пользователя**: Claude Code по-прежнему применяет записи `deny` в `~/.claude/settings.json` и сохраняет свои [записи файла `mask`](#mask-credential-files) как ограничения, но отбрасывает свои [записи переменной окружения `mask`](#mask-environment-variables).

355 355

356Встроенного списка отказа учётных данных нет, поэтому ограничены только файлы и переменные, которые вы перечислили.356Встроенного списка отказа учётных данных нет, поэтому ограничены только файлы и переменные, которые вы перечислили.

357 357

367 Маскировка переменных окружения367 Маскировка переменных окружения

368</h4>368</h4>

369 369

370`"mode": "mask"` защищает учётные данные, сохраняя при этом работающими инструменты, которые аутентифицируются с ними. `deny` полностью удаляет переменную, что также нарушает инструменты, которые её нужны, такие как `gh` или `npm`. Требуется Claude Code v2.1.199 или позже.370`"mode": "mask"` защищает учётные данные, сохраняя работающие инструменты, которые аутентифицируются с ними. `deny` полностью удаляет переменную, что также нарушает инструменты, которые её нужны, такие как `gh` или `npm`. Требуется Claude Code v2.1.199 или позже.

371 371

372С `mask` команда в песочнице видит значение дозорного для каждого сеанса вместо реального. Каждая запись `mask` может перечислять `injectHosts`, хосты, которым разрешено достичь реальное значение. Когда запрос покидает песочницу для одного из них, [прокси песочницы](#network-isolation) заменяет дозорный на реальное значение. Команда и всё, что она регистрирует, никогда не содержат реальные учётные данные, но её запросы по-прежнему аутентифицируются.372С `mask` команда в песочнице видит значение дозорного для каждого сеанса вместо реального. Каждая запись `mask` может перечислять `injectHosts`, хосты, которым разрешено достичь реальное значение. Когда запрос покидает песочницу для одного из них, [прокси песочницы](#network-isolation) заменяет дозорный на реальное значение. Команда и всё, что она регистрирует, никогда не содержат реальные учётные данные, но её запросы по-прежнему аутентифицируются.

373 373

374Прокси подставляет учётные данные внутри содержимого запроса, поэтому он должен их видеть. Установите [`network.tlsTerminate`](/docs/ru/settings-reference#sandbox-network-tlsterminate), чтобы прокси сам завершал TLS.374Прокси подставляет учётные данные внутри содержимого запроса, поэтому он должен их видеть. Установите [`network.tlsTerminate`](/docs/ru/settings-reference#sandbox-network-tlsterminate), чтобы прокси сам завершал TLS.

375 375

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

377 377

378Подстановка охватывает заголовки и тела запросов. Запросы, которые аутентифицируются с подписью, полученной из учётных данных, а не самих учётных данных, нуждаются в повторном подписании на прокси; [Повторное подписание запросов AWS](#re-sign-aws-requests) охватывает, как это работает для AWS.378Подстановка охватывает заголовки и тела запросов. Запросы, которые аутентифицируются с подписью, полученной из учётных данных, а не самих учётных данных, нуждаются в повторном подписании на прокси; [Повторное подписание запросов AWS](#re-sign-aws-requests) охватывает, как это работает для AWS.

379 379

406 406

407`claude doctor` помечает записи `injectHosts`, которые никогда не могут совпадать, предупреждением `Sandbox credential injectHosts entries can never match their destination`. Эта проверка требует Claude Code v2.1.229 или позже.407`claude doctor` помечает записи `injectHosts`, которые никогда не могут совпадать, предупреждением `Sandbox credential injectHosts entries can never match their destination`. Эта проверка требует Claude Code v2.1.229 или позже.

408 408

409В отличие от `deny`, маскировка уполномочивает прокси отправлять ваши реальные учётные данные на перечисленные хосты, поэтому Claude Code соблюдает её только из параметров, которые вы или ваш администратор контролируете: параметры пользователя, управляемые параметры и флаг CLI `--settings`. Claude Code игнорирует записи `mask` в `.claude/settings.json` или `.claude/settings.local.json` репозитория. В этих файлах он также игнорирует `network.tlsTerminate` и [`credentials.allowPlaintextInject`](/docs/ru/settings-reference#sandbox-credentials-allowplaintextinject), параметр, который позволяет прокси вводить учётные данные в незашифрованные запросы. Если вы [исключите параметры пользователя](#configure-sandboxing), Claude Code отбрасывает записи `mask` переменной окружения в `~/.claude/settings.json` тоже.409В отличие от `deny`, маскировка уполномочивает прокси отправлять ваши реальные учётные данные на перечисленные хосты, поэтому Claude Code соблюдает её только из параметров, которые вы или ваш администратор контролируете: параметры пользователя, управляемые параметры и флаг CLI `--settings`. Claude Code игнорирует записи `mask` в `.claude/settings.json` или `.claude/settings.local.json` репозитория. В этих файлах он также игнорирует `network.tlsTerminate` и [`credentials.allowPlaintextInject`](/docs/ru/settings-reference#sandbox-credentials-allowplaintextinject), параметр, который позволяет прокси вводить учётные данные в незашифрованные запросы. Если вы [исключаете параметры пользователя](#configure-sandboxing), Claude Code отбрасывает записи переменной окружения `mask` в `~/.claude/settings.json` тоже.

410 410

411Когда ваш администратор доставляет записи `mask`, `network.tlsTerminate` или `credentials.allowPlaintextInject` через управляемые параметры сервера, они считаются [параметрами, которые нуждаются в одобрении](/docs/ru/server-managed-settings#security-approval-dialogs).411Когда ваш администратор доставляет записи `mask`, `network.tlsTerminate` или `credentials.allowPlaintextInject` через управляемые параметры сервера, они считаются [параметрами, которые нуждаются в одобрении](/docs/ru/server-managed-settings#security-approval-dialogs).

412 412

427 Повторное подписание запросов AWS427 Повторное подписание запросов AWS

428</h4>428</h4>

429 429

430Запросы AWS содержат подписи SigV4 по содержимому запроса, поэтому маскируйте `AWS_ACCESS_KEY_ID` и `AWS_SECRET_ACCESS_KEY` вместе. Прокси обнаруживает запрос SigV4 по дозорному ключа доступа и повторно подписывает его после подстановки реальных значений. Маскировка только секрета оставляет запросы подписанными с заполнителем, который прокси не может обнаружить, поэтому они не удаются в AWS; Claude Code предупреждает об этом случае при запуске, но не когда маскирован только ID ключа доступа. Обнаруженный запрос, который прокси не может повторно подписать, такой как запрос без заголовка `x-amz-date`, не удаётся с ошибкой прокси вместо достижения сервера с нарушенной подписью.430Запросы AWS содержат подписи SigV4 по содержимому запроса, поэтому маскируйте `AWS_ACCESS_KEY_ID` и `AWS_SECRET_ACCESS_KEY` вместе. Прокси обнаруживает запрос SigV4 по дозорному ключа доступа и повторно подписывает его после подстановки реальных значений. Маскировка только секрета оставляет запросы подписанными заполнителем, который прокси не может обнаружить, поэтому они не срабатывают в AWS; Claude Code предупреждает об этом случае при запуске, но не когда маскирован только ID ключа доступа. Обнаруженный запрос, который прокси не может повторно подписать, такой как запрос без заголовка `x-amz-date`, не срабатывает с ошибкой прокси вместо достижения сервера с нарушенной подписью.

431 431

432Claude Code связывает обычные переменные `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` и `AWS_SESSION_TOKEN` в одно учётное данные автоматически, когда вы маскируете их целые значения. Если ваши учётные данные AWS находятся в переменных с другими именами, сгруппируйте их сами с помощью [`credentials.awsPairs`](/docs/ru/settings-reference#sandbox-credentials-awspairs), что требует Claude Code v2.1.224 или позже. Этот пример добавляет спаривание к конфигурации, которая уже маскирует `MY_KEY_ID`, `MY_SECRET_KEY` и `MY_SESSION_TOKEN` целое значение, как в [конфигурации маскировки выше](#mask-environment-variables):432Claude Code связывает обычные переменные `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` и `AWS_SESSION_TOKEN` в одно учётное данные автоматически, когда вы маскируете их целые значения. Если ваши учётные данные AWS находятся в переменных с другими именами, сгруппируйте их сами с помощью [`credentials.awsPairs`](/docs/ru/settings-reference#sandbox-credentials-awspairs), что требует Claude Code v2.1.224 или позже. Этот пример добавляет спаривание к конфигурации, которая уже маскирует `MY_KEY_ID`, `MY_SECRET_KEY` и `MY_SESSION_TOKEN` целое значение, как в [конфигурации маскировки выше](#mask-environment-variables):

433 433

456 456

457Как записи `mask`, `awsPairs` соблюдается только из параметров пользователя, управляемых параметров и флага CLI `--settings`.457Как записи `mask`, `awsPairs` соблюдается только из параметров пользователя, управляемых параметров и флага CLI `--settings`.

458 458

459Три формы запросов AWS содержат подписи, которые прокси не может пересчитать. Когда такой запрос подписан с заполнителем маскированной пары, прокси не удаётся вместо пересылки нарушенной подписи; запросы, подписанные немаскированными учётными данными, никогда не затрагиваются. Параметр [`credentials.sigv4`](/docs/ru/settings-reference#sandbox-credentials-sigv4), который требует Claude Code v2.1.224 или позже, ослабляет это для каждой формы: установка ключа формы на `passthrough` пересылает запрос с его подписью, полученной из заполнителя, поэтому вызывающий инструмент получает собственный ответ отказа AWS вместо ошибки прокси. Как `awsPairs`, `sigv4` соблюдается только из параметров пользователя, управляемых параметров и флага CLI `--settings`.459Три формы запросов AWS содержат подписи, которые прокси не может пересчитать. Когда такой запрос подписан дозорным маскированной пары, прокси не срабатывает вместо пересылки нарушенной подписи; запросы, подписанные немаскированными учётными данными, никогда не затрагиваются. Параметр [`credentials.sigv4`](/docs/ru/settings-reference#sandbox-credentials-sigv4), который требует Claude Code v2.1.224 или позже, ослабляет это для каждой формы: установка ключа формы в `passthrough` пересылает запрос с его подписью, полученной из дозорного, поэтому вызывающий инструмент получает собственный ответ отказа AWS вместо ошибки прокси. Как `awsPairs`, `sigv4` соблюдается только из параметров пользователя, управляемых параметров и флага CLI `--settings`.

460 460

462| :- | :- | :- |462| :- | :- | :- |

470 470

471Записи файлов также принимают `"mode": "mask"`, что требует Claude Code v2.1.221 или позже. То, что видит команда в песочнице, зависит от платформы:471Записи файлов также принимают `"mode": "mask"`, что требует Claude Code v2.1.221 или позже. То, что видит команда в песочнице, зависит от платформы:

472 472

473* **Linux и WSL2**: команды в песочнице читают копию дозорного файла, заменитель, чей секрет заменён значением заполнителя, и [прокси песочницы](#network-isolation) подставляет реальное значение на исходящем трафике.473* **Linux и WSL2**: команды в песочнице читают копию-дозорный файла, заменитель, чей секрет заменён значением заполнителя, и [прокси песочницы](#network-isolation) подставляет реальное значение на исходящем трафике.

474* **macOS**: команды в песочнице не могут читать перечисленный файл вообще. Claude Code не строит копию дозорного и ничего не подставляет на исходящем трафике, поэтому инструменты, которые аутентифицируются с файлом, не работают внутри песочницы, тот же эффект, что и `deny`. В отличие от записи `deny`, блок чтения сохраняется даже когда вы [отключите изоляцию файловой системы](#disable-filesystem-isolation).474* **macOS**: команды в песочнице не могут читать перечисленный файл вообще. Claude Code не строит копию-дозорный и не подставляет ничего на исходящем трафике, поэтому инструменты, которые аутентифицируются с файлом, не работают внутри песочницы, тот же эффект, что и `deny`. В отличие от записи `deny`, блок чтения держится даже когда вы [отключаете изоляцию файловой системы](#disable-filesystem-isolation).

475 475

476На каждой платформе Claude Code применяет требование [`network.tlsTerminate`](/docs/ru/settings-reference#sandbox-network-tlsterminate) и `injectHosts` так же, как для [маскированных переменных окружения](#mask-environment-variables), и игнорирует параметры репозитория так же. Если вы [исключите параметры пользователя](#configure-sandboxing), Claude Code сохраняет записи `mask` файла в `~/.claude/settings.json` как ограничения, но записи больше не уполномочивают прокси подставлять реальное значение.476На каждой платформе Claude Code применяет требование [`network.tlsTerminate`](/docs/ru/settings-reference#sandbox-network-tlsterminate) и `injectHosts` так же, как для [маскированных переменных окружения](#mask-environment-variables), и игнорирует параметры репозитория так же. Если вы [исключаете параметры пользователя](#configure-sandboxing), Claude Code сохраняет записи файла `mask` в `~/.claude/settings.json` как ограничения, но записи больше не уполномочивают прокси подставлять реальное значение.

477 477

478Пример ниже маскирует токен GitHub, хранящийся в `~/.config/gh/hosts.yml`; шаблон `extract`, описанный ниже, сообщает Claude Code, какая часть файла является секретом. На Linux и WSL2 команды в песочнице, которые читают файл, получают дозорный вместо токена, и прокси подставляет реальный токен на запросах к `api.github.com`:478Пример ниже маскирует токен GitHub, хранящийся в `~/.config/gh/hosts.yml`; шаблон `extract`, описанный ниже, говорит Claude Code, какая часть файла является секретом. На Linux и WSL2 команды в песочнице, которые читают файл, получают дозорный вместо токена, и прокси подставляет реальный токен на запросах к `api.github.com`:

479 479

480```json theme={null}480```json theme={null}

481{481{

499}499}

500```500```

501 501

502Чтобы подтвердить, что маска активна, попросите Claude запустить `cat ~/.config/gh/hosts.yml` в команде в песочнице: на Linux и WSL2 вывод показывает значение дозорного вместо токена, а на macOS чтение не удаётся вместо этого.502Чтобы подтвердить, что маска активна, попросите Claude запустить `cat ~/.config/gh/hosts.yml` в команде в песочнице: на Linux и WSL2 вывод показывает значение дозорного вместо токена, а на macOS чтение не срабатывает вместо этого.

503 503

504На Linux и WSL2 шаблон `extract` — это то, что сохраняет остальную часть `hosts.yml` читаемой. Claude Code применяет регулярное выражение по всему файлу и заменяет только текст, захваченный группой 1 каждого совпадения, поэтому `gh` по-прежнему анализирует свою конфигурацию и только токен является заполнителем. Используйте `extract` для любого структурированного файла, который инструменты анализируют, такого как `.netrc`, JSON или YAML; шаблон должен содержать по крайней мере одну захватывающую группу. Без `extract` Claude Code заменяет всё содержимое файла одним значением дозорного, что подходит для файла, который содержит один голый секрет и ничего больше.504На Linux и WSL2 шаблон `extract` — это то, что сохраняет остальную часть `hosts.yml` читаемой. Claude Code применяет регулярное выражение по всему файлу и заменяет только текст, захваченный группой 1 каждого совпадения, поэтому `gh` по-прежнему анализирует свою конфигурацию и только токен является заполнителем. Используйте `extract` для любого структурированного файла, который инструменты анализируют, такого как `.netrc`, JSON или YAML; шаблон должен содержать по крайней мере одну захватывающую группу. Без `extract` Claude Code заменяет всё содержимое файла одним значением дозорного, что подходит для файла, который содержит один голый секрет и ничего больше.

505 505

506Для файла, который содержит JSON Web Token (JWT), установите `decode: "jwt"` вместо или вместе с `extract`. `decode` требует Claude Code v2.1.224 или позже. Claude Code находит кандидатов JWT с встроенным шаблоном или с вашим шаблоном `extract`, когда установлен, проверяет каждого кандидата как JWT и заменяет его структурно действительным поддельным токеном, поэтому код, который декодирует токен внутри песочницы, продолжает работать. Добавьте `maskClaims` для маскировки только названных утверждений полезной нагрузки верхнего уровня внутри каждого проверенного токена и оставьте другие утверждения читаемыми. Когда ни один кандидат не проверяется или ни одно названное утверждение не совпадает, поле `onExtractNoMatch` ниже управляет результатом, как оно делает для шаблона, который ничего не совпадает.506Для файла, который содержит JSON Web Token (JWT), установите `decode: "jwt"` вместо или вместе с `extract`. `decode` требует Claude Code v2.1.224 или позже. Claude Code находит кандидатов JWT с встроенным шаблоном или с вашим шаблоном `extract`, когда установлен, проверяет каждого кандидата как JWT и заменяет его структурно действительным поддельным токеном, поэтому код, который декодирует токен внутри песочницы, продолжает работать. Добавьте `maskClaims` для маскировки только названных утверждений полезной нагрузки верхнего уровня внутри каждого проверенного токена и оставьте другие утверждения читаемыми. Когда ни один кандидат не проверяется или ни одно названное утверждение не совпадает, поле `onExtractNoMatch` ниже управляет результатом, как оно делает для шаблона, который ничего не совпадает.

507 507

508Два дополнительных поля уточняют, как ведёт себя сопоставление. Оба применяются только когда `mode` — это `mask` и `extract` или `decode` установлены. На macOS Claude Code применяет записи `mask` как `deny` перед запуском шаблона всякий раз, когда изоляция файловой системы включена, поэтому эти поля и результаты отсутствия совпадения ниже вступают в силу там только когда [изоляция файловой системы отключена](#disable-filesystem-isolation):508Два дополнительных поля уточняют, как ведёт себя сопоставление. Оба применяются только когда `mode` — это `mask` и `extract` или `decode` установлены. На macOS Claude Code применяет записи `mask` как `deny` перед запуском шаблона, когда изоляция файловой системы включена, поэтому эти поля и результаты отсутствия совпадения ниже вступают в силу там только когда [изоляция файловой системы отключена](#disable-filesystem-isolation):

509 509

510* `onExtractNoMatch` контролирует, что происходит, когда сопоставление не находит ничего для маскировки в файле:510* `onExtractNoMatch` контролирует, что происходит, когда сопоставление находит ничего для маскировки в файле:

511 511

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

513 * `deny` делает файл нечитаемым вместо этого513 * `deny` делает файл нечитаемым вместо этого

514 * `error` останавливает настройку песочницы, пока вы не исправите конфигурацию514 * `error` останавливает настройку песочницы, пока вы не исправите конфигурацию

515 515

516 Claude Code обрабатывает `deny` как `error` всякий раз, когда блок чтения не будет применяться: когда вы [отключите изоляцию файловой системы](#disable-filesystem-isolation), и когда запись `filesystem.allowRead` из любого источника параметров повторно открывает путь файла.516 Claude Code обрабатывает `deny` как `error` всякий раз, когда блок чтения не будет применён: когда вы [отключаете изоляцию файловой системы](#disable-filesystem-isolation), и когда запись `filesystem.allowRead` из любого источника параметров повторно открывает путь файла.

517* `maskDuplicates` также заменяет дословные копии каждого маскированного значения учётных данных, захват `extract` или проверенный токен `decode`, найденные вне совпадённых диапазонов, для секрета, повторённого где сопоставление не достигает. Он совпадает с сырыми подстроками, поэтому короткое или обычное значение было бы заменено везде, где оно появляется; зарезервируйте его для длинных, высокоэнтропийных секретов. По умолчанию: false.517* `maskDuplicates` также заменяет дословные копии каждого маскированного значения учётных данных, захвата `extract` или проверенного токена `decode`, найденные вне совпадённых диапазонов, для секрета, повторённого где сопоставление не достигает. Он совпадает с сырыми подстроками, поэтому короткое или обычное значение было бы заменено везде, где оно появляется; зарезервируйте его для длинных, высокоэнтропийных секретов. По умолчанию: false.

518 518

519`mask` применяется к одному файлу, поэтому перечислите каждый файл учётных данных отдельно. Claude Code возвращается к `deny` для записи `mask`, которую он не может безопасно маскировать: путь каталога, шаблон glob, файл больше 8 МиБ или файл, который не является текстом UTF-8. Напишите каталоги как явные записи `deny` вместо этого; таблица в разделе [Какие параметры могут отключить её](#which-settings-can-disable-it) охватывает, закрепляет ли каждая форма `filesystem.disabled` и как она ведёт себя с отключённой изоляцией файловой системы.519`mask` применяется к одному файлу, поэтому перечислите каждый файл учётных данных отдельно. Claude Code возвращается к `deny` для записи `mask`, которую он не может безопасно маскировать: путь каталога, шаблон glob, файл больше 8 МиБ или файл, который не является текстом UTF-8. Напишите каталоги как явные записи `deny` вместо этого; таблица в разделе [Какие параметры могут отключить её](#which-settings-can-disable-it) охватывает, закрепляет ли каждая форма `filesystem.disabled` и как она ведёт себя с отключённой изоляцией файловой системы.

520 520

530 530

531* **Поведение записи по умолчанию**: доступ на чтение и запись к текущему рабочему каталогу и его подкаталогам, любым каталогам, которые вы добавили с помощью `--add-dir`, `/add-dir` или [`permissions.additionalDirectories`](/docs/ru/settings-reference#permissions-additionaldirectories), плюс временный каталог сеанса, на который указывает `$TMPDIR`531* **Поведение записи по умолчанию**: доступ на чтение и запись к текущему рабочему каталогу и его подкаталогам, любым каталогам, которые вы добавили с помощью `--add-dir`, `/add-dir` или [`permissions.additionalDirectories`](/docs/ru/settings-reference#permissions-additionaldirectories), плюс временный каталог сеанса, на который указывает `$TMPDIR`

532* **Поведение чтения по умолчанию**: доступ на чтение ко всему компьютеру, кроме определённых запрещённых каталогов. Обратите внимание, что эта политика по умолчанию всё ещё разрешает чтение файлов учётных данных, таких как `~/.aws/credentials` и `~/.ssh/`. Используйте [`sandbox.credentials`](#protect-credentials) для блокировки чтения этих файлов и отмены установки переменных окружения с секретами, или добавьте пути в `denyRead`.532* **Поведение чтения по умолчанию**: доступ на чтение ко всему компьютеру, кроме определённых запрещённых каталогов. Обратите внимание, что эта политика по умолчанию всё ещё разрешает чтение файлов учётных данных, таких как `~/.aws/credentials` и `~/.ssh/`. Используйте [`sandbox.credentials`](#protect-credentials) для блокировки чтения этих файлов и отмены установки переменных окружения с секретами, или добавьте пути в `denyRead`.

533* **Блокировка чтения**: с включённым [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) изолированные команды также теряют доступ на чтение к вашему домашнему каталогу и другим каталогам, которые содержат файлы пользователя, кроме путей, которые [Sandboxed commands under the block](/docs/ru/settings-reference#sandboxed-commands-under-the-block) перечисляет. Этот раздел также указывает, когда эта часть блокировки не применяется.

533* **Заблокированный доступ**: невозможно изменять файлы вне текущего рабочего каталога, добавленных каталогов и временного каталога сеанса без явного разрешения, включая файлы конфигурации оболочки, такие как `~/.bashrc`, и системные двоичные файлы в `/bin/`534* **Заблокированный доступ**: невозможно изменять файлы вне текущего рабочего каталога, добавленных каталогов и временного каталога сеанса без явного разрешения, включая файлы конфигурации оболочки, такие как `~/.bashrc`, и системные двоичные файлы в `/bin/`

534* **Git worktrees**: когда рабочий каталог является [связанным git worktree](/docs/ru/worktrees), sandbox также разрешает запись в общий каталог `.git` основного репозитория, чтобы команды, такие как `git commit`, могли обновлять ссылки и индекс. Запись в `hooks/` и `config` внутри этого каталога остаётся запрещённой.535* **Git worktrees**: когда рабочий каталог является [связанным git worktree](/docs/ru/worktrees), sandbox также разрешает запись в общий каталог `.git` основного репозитория, чтобы команды, такие как `git commit`, могли обновлять ссылки и индекс. Запись в `hooks/` и `config` внутри этого каталога остаётся запрещённой.

535* **Настраиваемо**: определите пользовательские разрешённые и запрещённые пути через параметры536* **Настраиваемо**: определите пользовательские разрешённые и запрещённые пути через параметры

security.md +2 −1

Details

128 128

129* **Изолированные виртуальные машины**: Каждый облачный сеанс работает в изолированной ВМ, управляемой Anthropic129* **Изолированные виртуальные машины**: Каждый облачный сеанс работает в изолированной ВМ, управляемой Anthropic

130* **Элементы управления доступом в сети**: Доступ в сеть ограничен по умолчанию и может быть настроен на отключение или разрешение только определенных доменов130* **Элементы управления доступом в сети**: Доступ в сеть ограничен по умолчанию и может быть настроен на отключение или разрешение только определенных доменов

131* **Защита учетных данных**: Аутентификация обрабатывается через безопасный прокси, который использует учетные данные с ограниченной областью действия внутри sandbox, которые затем переводятся в ваш фактический токен аутентификации GitHub131* **Защита учетных данных**: Учетные данные GitHub хранятся в зашифрованном виде на серверах Anthropic и никогда не попадают в ВМ сеанса. ВМ содержит краткосрочное учетное данное, ограниченное этим сеансом, и трафик GitHub проходит через [прокси Anthropic](/docs/ru/cloud-environments#github-proxy), который прикрепляет учетное данное GitHub на стороне сервера. См. [Параметры аутентификации GitHub](/docs/ru/claude-code-on-the-web#github-authentication-options) для получения информации о том, как вы предоставляете доступ

132* **Ограничения ветвей**: Операции Git push ограничены текущей рабочей ветвью132* **Ограничения ветвей**: Операции Git push ограничены текущей рабочей ветвью

133* **Логирование аудита**: Все операции в облачных сеансах регистрируются в целях соответствия и аудита133* **Логирование аудита**: Все операции в облачных сеансах регистрируются в целях соответствия и аудита

134* **Автоматическая очистка**: Облачные ВМ сеансов высвобождаются после периода неактивности134* **Автоматическая очистка**: Облачные ВМ сеансов высвобождаются после периода неактивности

135* **Удаление**: Вы можете [удалить сеанс](/docs/ru/claude-code-on-the-web#delete-sessions) в любое время. См. [Поток данных облачного выполнения](/docs/ru/data-usage#cloud-execution-data-flow-and-dependencies) для получения информации о том, что Anthropic хранит для облачного сеанса

135 136

136Для получения дополнительной информации о облачном выполнении см. [Использование Claude Code в облаке](/docs/ru/claude-code-on-the-web); для настройки сетевого доступа к облачным сеансам см. [Настройка облачных сред](/docs/ru/cloud-environments#network-access).137Для получения дополнительной информации о облачном выполнении см. [Использование Claude Code в облаке](/docs/ru/claude-code-on-the-web); для настройки сетевого доступа к облачным сеансам см. [Настройка облачных сред](/docs/ru/cloud-environments#network-access).

137 138

self-hosted-environments-configuration.md +31 −3

Details

222| Переменная | Описание |222| Переменная | Описание |

223| :- | :- |223| :- | :- |

224| `CLAUDE_RUNNER_WORK_ORDER_FILE` | Путь к временному файлу, содержащему подписанный JWT наряда на работу, с которым регистрируется новое средство выполнения. Удалено после выхода хука. Не логируйте содержимое файла. |224| `CLAUDE_RUNNER_WORK_ORDER_FILE` | Путь к временному файлу, содержащему подписанный JWT наряда на работу, с которым регистрируется новое средство выполнения. Удалено после выхода хука. Не логируйте содержимое файла. |

225| `CLAUDE_RUNNER_ORDER_ID` | Непрозрачный ключ идемпотентности, уникальный для каждого запроса на порождение и безопасный для имен ресурсов Kubernetes. Используйте его как ключ дедупликации вашего провизионера. |225| `CLAUDE_RUNNER_ORDER_ID` | Непрозрачный ключ идемпотентности, уникальный для каждого запроса на порождение и безопасный для имен ресурсов Kubernetes. Используйте только ID заказа как ключ дедупликации вашего провизионера. |

226| `CLAUDE_RUNNER_SESSION_ID` | Сеанс, для которого предназначен этот запрос. Пусто для запросов предварительного прогрева, которые загружают резервное средство выполнения перед любым конкретным сеансом, когда установлен [`--min-idle`](/docs/ru/self-hosted-environments-reference#orchestrator-cli-flags), поэтому не предполагайте, что переменная установлена. |226| `CLAUDE_RUNNER_SESSION_ID` | Сеанс, для которого предназначен этот запрос. Он повторяется при каждом повторном запросе для сеанса, поэтому используйте его для логирования и маршрутизации, а не как ключ дедупликации. Пусто для запросов предварительного прогрева, которые загружают резервное средство выполнения перед любым конкретным сеансом, когда установлен [`--min-idle`](/docs/ru/self-hosted-environments-reference#orchestrator-cli-flags), поэтому не предполагайте, что переменная установлена. |

227| `CLAUDE_RUNNER_SESSION_UUID` | Тот же ID сеанса в канонической форме UUID. Пусто для запросов предварительного прогрева. |227| `CLAUDE_RUNNER_SESSION_UUID` | Тот же ID сеанса в канонической форме UUID. Пусто для запросов предварительного прогрева. |

228| `CLAUDE_RUNNER_ATTEMPT` | Сколько запросов на порождение было у этого сеанса. `0` для запросов предварительного прогрева. |228| `CLAUDE_RUNNER_ATTEMPT` | Сколько запросов на порождение было у этого сеанса. `0` для запросов предварительного прогрева. |

229| `CLAUDE_RUNNER_ORDER_SERVER_TIME` | Время сервера из заголовка HTTP `Date` ответа опроса. Когда хук проверяет `exp` JWT наряда на работу, сравнивайте с этим значением вместо локальных часов, чтобы допустить перекос. Пусто, когда шлюз опустил заголовок. |229| `CLAUDE_RUNNER_ORDER_SERVER_TIME` | Время сервера из заголовка HTTP `Date` ответа опроса. Когда хук проверяет `exp` JWT наряда на работу, сравнивайте с этим значением вместо локальных часов, чтобы допустить перекос. Пусто, когда шлюз опустил заголовок. |

245 245

246Контракт имеет четыре правила, независимые от провизионера:246Контракт имеет четыре правила, независимые от провизионера:

247 247

2481. **Будьте идемпотентны на `CLAUDE_RUNNER_ORDER_ID`.** Переделивка одного и того же запроса должна порождать не более одного средства выполнения. Выведите детерминированное имя ресурса из ID и позвольте вашей платформе отклонить дубликат.2481. **Будьте идемпотентны на `CLAUDE_RUNNER_ORDER_ID`.** Переделивка одного и того же запроса должна порождать не более одного средства выполнения. Выведите детерминированное имя ресурса из ID заказа и позвольте вашей платформе отклонить дубликат. Не ключируйте на `CLAUDE_RUNNER_SESSION_ID` вместо этого. Каждый повторный запрос для сеанса несет тот же ID сеанса с новым ID заказа, поэтому рабочая нагрузка, названная или дедуплицированная по ID сеанса, создается один раз и никогда снова для этого сеанса.

2492. **Не повторяйте рабочую нагрузку.** Один ID заказа означает не более одной созданной рабочей нагрузки. Если средство выполнения никогда не регистрируется, Anthropic повторно запрашивает с новым ID заказа после `--expected-spawn-seconds`.2492. **Не повторяйте рабочую нагрузку.** Один ID заказа означает не более одной созданной рабочей нагрузки. Если средство выполнения никогда не регистрируется, Anthropic повторно запрашивает с новым ID заказа после `--expected-spawn-seconds`.

2503. **Используйте контракт кода выхода.** Выход 0 означает отправлено. Выход 1 означает повторяемый отказ; сеанс отступает и переоффертируется. Выход 2 или выше означает неповторяемый; сеанс блокируется от порождения снова до тех пор, пока [владелец](/docs/ru/cloud-environments#organization-shared-environments) не выберет **Retry** на нем на вкладке **Activity** окружения. При ненулевом выходе хвост stderr хука появляется там как причина отказа, поэтому напишите действенную ошибку в stderr и никогда не секреты. Для запроса предварительного прогрева нет сеанса для отказа: оркестратор логирует ненулевой выход локально только, и сервер повторно запрашивает порождение после аренды.2503. **Используйте контракт кода выхода.** Выход 0 означает отправлено. Выход 1 означает повторяемый отказ; сеанс отступает и переоффертируется. Выход 2 или выше означает неповторяемый; сеанс блокируется от порождения снова до тех пор, пока [владелец](/docs/ru/cloud-environments#organization-shared-environments) не выберет **Retry** на нем на вкладке **Activity** окружения. При ненулевом выходе хвост stderr хука появляется там как причина отказа, поэтому напишите действенную ошибку в stderr и никогда не секреты. Для запроса предварительного прогрева нет сеанса для отказа: оркестратор логирует ненулевой выход локально только, и сервер повторно запрашивает порождение после аренды.

2514. **Установите `--expected-spawn-seconds` на по крайней мере ваше время загрузки p99.** Это аренда на стороне сервера. Все реплики оркестратора должны использовать одно и то же значение.2514. **Установите `--expected-spawn-seconds` на по крайней мере ваше время загрузки p99.** Это аренда на стороне сервера. Все реплики оркестратора должны использовать одно и то же значение.

252 252

253Все, что хук пишет в stdout или stderr, появляется в логе оркестратора с автоматически удаленными учетными данными. Если сеансы остаются в очереди, проверьте тело `/healthz` оркестратора на предмет количества в очереди, затем откройте вкладку **Activity** вашего окружения на [странице администратора **Cloud environments**](https://claude.ai/admin-settings/cloud-environments): разверните неудачный сеанс там для его ошибки порождения и выберите **Retry** для повторного запроса.253Все, что хук пишет в stdout или stderr, появляется в логе оркестратора с автоматически удаленными учетными данными. Если сеансы остаются в очереди, проверьте тело `/healthz` оркестратора на предмет количества в очереди, затем откройте вкладку **Activity** вашего окружения на [странице администратора **Cloud environments**](https://claude.ai/admin-settings/cloud-environments): разверните неудачный сеанс там для его ошибки порождения и выберите **Retry** для повторного запроса.

254 254

255Сеанс, который остается в очереди без ошибки порождения на вкладке **Activity**, может означать, что хук ключируется по ID сеанса. Чтобы подтвердить, проверьте, есть ли на вашей платформе рабочая нагрузка для первого запроса порождения этого сеанса и нет ни одной для повторных запросов. Если это так, ключируйте рабочую нагрузку на `CLAUDE_RUNNER_ORDER_ID` вместо этого.

256

255<h2 id="mcp-servers">257<h2 id="mcp-servers">

256 MCP серверы258 MCP серверы

257</h2>259</h2>

277 279

278Сеансы наследуют окружение средства выполнения, поэтому установите [`ENABLE_TOOL_SEARCH`](/docs/ru/mcp#scale-with-mcp-tool-search) там для управления поиском инструментов MCP для каждого сеанса, который порождает средство выполнения; страница MCP охватывает значения.280Сеансы наследуют окружение средства выполнения, поэтому установите [`ENABLE_TOOL_SEARCH`](/docs/ru/mcp#scale-with-mcp-tool-search) там для управления поиском инструментов MCP для каждого сеанса, который порождает средство выполнения; страница MCP охватывает значения.

279 281

282<h3 id="turn-off-built-in-session-tools">

283 Отключение встроенных инструментов сеанса

284</h3>

285

286Плоскость управления Anthropic присоединяет свой собственный MCP сервер, названный Claude Code Remote, к облачным сеансам. Claude использует инструменты сервера для планирования [routines](/docs/ru/routines), запуска и управления другими облачными сеансами, присоединения дополнительных репозиториев и отслеживания активности запросов на слияние.

287

288Чтобы отключить весь сервер, добавьте [server-level deny rule](/docs/ru/permissions#mcp) в ваши настройки. Плоскость управления регистрирует сервер под одним из трех имен в зависимости от того, как был создан сеанс. Claude Code точно совпадает с именем в правиле, включая регистр, поэтому напишите правило один раз для каждого имени, как показано:

289

290```json theme={null}

291{

292 "permissions": {

293 "deny": [

294 "mcp__Claude_Code_Remote",

295 "mcp__claude-code-remote",

296 "mcp__bf7c680d-5fdc-5ef4-b4a0-abadb619bf0a"

297 ]

298 }

299}

300```

301

302Правило, которое называет весь сервер, охватывает инструменты, которые сервер получает позже. Чтобы отключить один инструмент и сохранить остальные, добавьте два дополнительных подчеркивания и имя инструмента к каждому правилу, как в `mcp__Claude_Code_Remote__add_repo`. Чтобы заблокировать подключение сервера вообще, а не удалять его инструменты, добавьте три имена без префикса `mcp__` как записи `serverName` под [`deniedMcpServers`](/docs/ru/managed-mcp#policy-based-control-with-allowlists-and-denylists) вместо этого.

303

304Поместите правила в [server-managed settings](/docs/ru/server-managed-settings) для достижения каждого сеанса без изменения средства выполнения, или в `~/.claude/settings.json` на средстве выполнения. [Permissions and tool approval](#permissions-and-tool-approval) объясняет, как настройки на средстве выполнения достигают сеансов.

305

306Чтобы подтвердить, что правила вступили в силу, запустите сеанс в окружении и попросите Claude перечислить его инструменты MCP. Claude Code удаляет запрещенный инструмент из контекста Claude, поэтому запрещенные инструменты отсутствуют в его ответе.

307

280<h2 id="prompt-sessions-to-push-their-work">308<h2 id="prompt-sessions-to-push-their-work">

281 Подсказка сеансов для отправки их работы309 Подсказка сеансов для отправки их работы

282</h2>310</h2>

self-hosted-environments-deploy.md +6 −2

Details

220ENTRYPOINT ["claude"]220ENTRYPOINT ["claude"]

221```221```

222 222

223Замените `linux-x64` на `linux-arm64`, если ваши узлы ARM, или на `linux-x64-musl` или `linux-arm64-musl` на образе на основе musl, таком как Alpine; см. [Alpine Linux setup](/docs/ru/setup#alpine-linux-and-musl-based-distributions) для дополнительных пакетов, которые нужны образам musl. URL является стандартным местоположением выпуска Claude Code, поэтому вы можете проверить загруженный бинарный файл против подписанного манифеста выпуска, как описано в [Binary integrity and code signing](/docs/ru/setup#binary-integrity-and-code-signing). Постройте образ с версией Claude Code 2.1.224 или позже, затем отправьте его в ваш реестр и ссылайтесь на него в рецептах ниже:223Замените `linux-x64` на `linux-arm64`, если ваши узлы ARM, или на `linux-x64-musl` или `linux-arm64-musl` на образе на основе musl, таком как Alpine; см. [Alpine Linux setup](/docs/ru/setup#alpine-linux-and-musl-based-distributions) для дополнительных пакетов, которые нужны образам musl. URL является стандартным местоположением выпуска Claude Code, поэтому вы можете проверить загруженный бинарный файл против подписанного манифеста выпуска, как описано в [Binary integrity and code signing](/docs/ru/setup#binary-integrity-and-code-signing). Runner требует версию Claude Code 2.1.224 или позже. Постройте образ, затем отправьте его в ваш реестр и ссылайтесь на него в рецептах ниже:

224 224

225```bash theme={null}225```bash theme={null}

226docker build --build-arg CLAUDE_CODE_VERSION=2.1.267 -t <your-registry>/claude-runner:latest .226docker build \

227 --build-arg CLAUDE_CODE_VERSION="$(curl -fsSL https://downloads.claude.ai/claude-code-releases/stable)" \

228 -t <your-registry>/claude-runner:latest .

227```229```

228 230

231Подстановка команды ищет текущий номер выпуска `stable` и передает его как аргумент сборки, поэтому запуск той же команды после нового стабильного выпуска перестраивает слой загрузки с более новым бинарным файлом. Чтобы закрепить конкретный выпуск для воспроизводимых сборок, передайте номер версии непосредственно как `CLAUDE_CODE_VERSION`. Замените `stable` на `latest` в URL поиска, когда вам нужен выпуск новее, чем стабильный канал, например, тот, который [требует недавно запущенная модель](/docs/ru/model-config).

232

229<h2 id="size-cpu-and-memory-for-sessions">233<h2 id="size-cpu-and-memory-for-sessions">

230 Размер CPU и памяти для сеансов234 Размер CPU и памяти для сеансов

231</h2>235</h2>

server-managed-settings.md +11 −2

Details

220 220

221Доставка, управляемая сервером, добавляет эти поведения:221Доставка, управляемая сервером, добавляет эти поведения:

222 222

223* Кэш в `~/.claude/remote-settings.json` хранит спасенную полезную нагрузку с удаленными недействительными записями, за исключением недействительных значений `cleanupPeriodDays` и `desktopSessionCleanupPeriodDays`, которые остаются в кэшированной копии и никогда не применяются.223* Запуск, который работает на кэше в `~/.claude/remote-settings.json`, обрабатывает недействительные записи так же, как выборка, которая написала кэш:

224* Когда ни одно поле в полезной нагрузке не может быть спасено и полезная нагрузка не содержит только эти ключи хранения, Claude Code отклоняет полезную нагрузку, сохраняет последние принятые кэшированные параметры и записывает `Remote settings: Settings validation failed - no fields could be salvaged` в журнал отладки. Если установлен `forceRemoteSettingsRefresh`, CLI вместо этого выходит.224 * Записи, которые не прошли валидацию, остаются отброшенными.

225 * [Ключи, которые отказывают закрыто](/docs/ru/managed-settings#keys-that-fail-closed), сохраняют свои более строгие значения.

226 * Недействительное значение `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays` остается в кэшированной копии и никогда не применяется.

227* Claude Code не применяет ничего из полезной нагрузки и оставляет кэш без изменений, когда все три из этих условий верны:

228

229 * Каждый параметр в полезной нагрузке не проходит валидацию.

230 * Ни один из них не возвращается к более строгому значению.

231 * Полезная нагрузка содержит ключ, отличный от этих двух ключей хранения.

232

233 Уведомление при запуске, `/status` и `claude doctor` затем сообщают о [неудачной загрузке](/docs/ru/errors#remote-managed-settings-failed-to-load) с причиной `no setting in the server response could be applied as written`, и эта запись указывает, на какой политике работает сеанс. Клиенты, которые [применяют принудительный отказ при запуске](#enforce-fail-closed-startup), вместо этого выходят при запуске.

225* [Диалог одобрения безопасности](#security-approval-dialogs) оценивает спасенную полезную нагрузку, поэтому удаленная недействительная запись никогда не представляется для одобрения и никогда не выполняется.234* [Диалог одобрения безопасности](#security-approval-dialogs) оценивает спасенную полезную нагрузку, поэтому удаленная недействительная запись никогда не представляется для одобрения и никогда не выполняется.

226 235

227Для отладки проблем доставки запустите `claude --debug-file <path>` и найдите в журнале `Remote settings`. Проверьте изменение полезной нагрузки с помощью `claude doctor` на тестовой машине перед развертыванием в организации.236Для отладки проблем доставки запустите `claude --debug-file <path>` и найдите в журнале `Remote settings`. Проверьте изменение полезной нагрузки с помощью `claude doctor` на тестовой машине перед развертыванием в организации.

sessions.md +5 −4

Details

8 8

9Сеанс — это сохранённый диалог, привязанный к каталогу проекта. Claude Code сохраняет его локально по мере работы, поэтому вы можете возобновить работу с того же места, создать ветвь для попытки другого подхода или переключаться между задачами.9Сеанс — это сохранённый диалог, привязанный к каталогу проекта. Claude Code сохраняет его локально по мере работы, поэтому вы можете возобновить работу с того же места, создать ветвь для попытки другого подхода или переключаться между задачами.

10 10

11[Настольное приложение](/docs/ru/desktop#work-in-parallel-with-sessions), [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) и [расширение VS Code](/docs/ru/vs-code#resume-past-conversations) каждое ведёт собственную историю сеансов. На этой странице рассматривается CLI.11[Настольное приложение](/docs/ru/desktop#work-in-parallel-with-sessions), [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) и [расширение VS Code](/docs/ru/vs-code#resume-past-conversations) каждое ведёт собственную историю сеансов, а настольное приложение также может [возобновить сеанс CLI](/docs/ru/desktop#coming-from-the-cli). На этой странице рассматривается CLI.

12 12

13<h2 id="resume-a-session">13<h2 id="resume-a-session">

14 Возобновление сеанса14 Возобновление сеанса

43* Режим разрешений: если вы возобновляете из терминала с помощью `claude --continue`, `claude --resume <session-id>` или `claude --resume <name>`, когда имя соответствует одному сеансу, без `-p`, Claude Code восстанавливает режим разрешений, в котором находился сеанс, за исключением случаев в [режим разрешений при возобновлении](#permission-mode-on-resume), который также охватывает средство выбора сеансов, `/resume` и возобновление с помощью `claude -p`. Передайте `--permission-mode` или `--dangerously-skip-permissions`, чтобы переопределить восстановленный режим.43* Режим разрешений: если вы возобновляете из терминала с помощью `claude --continue`, `claude --resume <session-id>` или `claude --resume <name>`, когда имя соответствует одному сеансу, без `-p`, Claude Code восстанавливает режим разрешений, в котором находился сеанс, за исключением случаев в [режим разрешений при возобновлении](#permission-mode-on-resume), который также охватывает средство выбора сеансов, `/resume` и возобновление с помощью `claude -p`. Передайте `--permission-mode` или `--dangerously-skip-permissions`, чтобы переопределить восстановленный режим.

44* Активная цель: [цель](/docs/ru/goal#resume-with-an-active-goal), которая была активна при завершении сеанса, переносится; её счётчик ходов, таймер и базовая линия расходов токенов сбрасываются.44* Активная цель: [цель](/docs/ru/goal#resume-with-an-active-goal), которая была активна при завершении сеанса, переносится; её счётчик ходов, таймер и базовая линия расходов токенов сбрасываются.

45* Запланированные задачи: [задачи, которые не истекли](/docs/ru/scheduled-tasks#limitations), восстанавливаются. Фоновые задачи Bash и задачи мониторинга не восстанавливаются.45* Запланированные задачи: [задачи, которые не истекли](/docs/ru/scheduled-tasks#limitations), восстанавливаются. Фоновые задачи Bash и задачи мониторинга не восстанавливаются.

46* Фоновая работа: [фоновый subagent](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), фоновая команда Bash или [workflow](/docs/ru/workflows), который завершился с предыдущим процессом, отображается в возобновлённой стенограмме как примечание о том, что он не завершился. Claude Code не запускает ход из этих примечаний; Claude читает их с вашим следующим приглашением.

46 47

47Не каждый флаг конфигурации из исходного запуска восстанавливается. Если сеанс зависел от `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model` или каталогов, добавленных с помощью `--add-dir`, передайте их снова при возобновлении; каталоги, добавленные во время сеанса с помощью `/add-dir`, также не восстанавливаются, хотя средство выбора сеансов всё ещё использует их для поиска сеанса. Стандартные файлы параметров, такие как `settings.json` и `settings.local.json`, перечитываются при запуске, поэтому конфигурация, которая находится в них, не должна передаваться снова. Для `--system-prompt` и `--append-system-prompt` см. [Флаги системного приглашения в возобновлённых диалогах](/docs/ru/cli-reference#system-prompt-flags-in-resumed-conversations).48Не каждый флаг конфигурации из исходного запуска восстанавливается. Если сеанс зависел от `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model` или каталогов, добавленных с помощью `--add-dir`, передайте их снова при возобновлении; каталоги, добавленные во время сеанса с помощью `/add-dir`, также не восстанавливаются, хотя средство выбора сеансов всё ещё использует их для поиска сеанса. Стандартные файлы параметров, такие как `settings.json` и `settings.local.json`, перечитываются при запуске, поэтому конфигурация, которая находится в них, не должна передаваться снова. Для `--system-prompt` и `--append-system-prompt` см. [Флаги системного приглашения в возобновлённых диалогах](/docs/ru/cli-reference#system-prompt-flags-in-resumed-conversations).

48 49

74 Возобновление в режиме Plan Mode с `-p`75 Возобновление в режиме Plan Mode с `-p`

75</h5>76</h5>

76 77

77Запуск `claude -p --resume` или `claude -p --continue` возобновляется в режиме Plan Mode только когда выполняются все четыре условия:78Запуск `claude -p --resume` или `claude -p --continue` возобновляется в режиме Plan Mode только когда выполняются все эти условия:

78 79

~~79* Вы передаёте [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags), чтобы Claude Code мог представить план для утверждения~~80* Вы передаёте [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) и не передаёте [`--permission-prompts none`](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs), чтобы Claude Code мог представить план для утверждения

80* Вы не передаёте `--permission-mode` или `--dangerously-skip-permissions`81* Вы не передаёте `--permission-mode` или `--dangerously-skip-permissions`

81* Вы не передаёте `--fork-session`82* Вы не передаёте `--fork-session`

82* Запуск не запущен через [каналы](/docs/ru/channels)83* Запуск не запущен через [каналы](/docs/ru/channels)

134| Из claude.ai или приложения Claude | Переименуйте [сессию удаленного управления](/docs/ru/remote-control#connect-from-another-device); Claude Code применяет то же имя в CLI. Требуется Claude Code v2.1.221 или позже |135| Из claude.ai или приложения Claude | Переименуйте [сессию удаленного управления](/docs/ru/remote-control#connect-from-another-device); Claude Code применяет то же имя в CLI. Требуется Claude Code v2.1.221 или позже |

135| Из приложения для рабочего стола | Переименуйте сессию в [приложении для рабочего стола](/docs/ru/desktop#work-in-parallel-with-sessions) |136| Из приложения для рабочего стола | Переименуйте сессию в [приложении для рабочего стола](/docs/ru/desktop#work-in-parallel-with-sessions) |

136 137

137После того как вы назовете сессию через маршрут CLI или из claude.ai, вернитесь к ней с помощью `claude --resume <name>` или `/resume <name>`; сессия приложения для рабочего стола возобновляется в приложении, которое ведет свою собственную историю сессий. Смотрите [Возобновить сессию](#resume-a-session), чтобы узнать, как разрешение имен работает в worktrees.138После того как вы назовете сессию через маршрут CLI или из claude.ai, вернитесь к ней с помощью `claude --resume <name>` или `/resume <name>`; сессия приложения для рабочего стола возобновляется в [приложении для рабочего стола](/docs/ru/desktop#work-in-parallel-with-sessions). Смотрите [Возобновить сессию](#resume-a-session), чтобы узнать, как разрешение имен работает в worktrees.

138 139

139Когда вы запускаете или возобновляете интерактивную сессию с именем, которое уже использует другая активная сессия на этой машине, или переименовываете сессию в такое имя, Claude Code оставляет имя с сессией, которая его уже имеет, переименовывает вашу в вариант с двусловным суффиксом, например `auth-refactor-graceful-unicorn`, и сообщает вам об этом. Запустите `/rename` с новым именем, если вы предпочитаете выбрать его сами. До версии v2.1.232 обе сессии сохраняли имя.140Когда вы запускаете или возобновляете интерактивную сессию с именем, которое уже использует другая активная сессия на этой машине, или переименовываете сессию в такое имя, Claude Code оставляет имя с сессией, которая его уже имеет, переименовывает вашу в вариант с двусловным суффиксом, например `auth-refactor-graceful-unicorn`, и сообщает вам об этом. Запустите `/rename` с новым именем, если вы предпочитаете выбрать его сами. До версии v2.1.232 обе сессии сохраняли имя.

140 141

settings.md +1 −1

Details

809 809

810* **Общие параметры проекта** (`.claude/settings.json`): читаются в сеансе с одним репозиторием, потому что файл является частью клона и сеанс начинается внутри него. Зафиксируйте параметр там, чтобы применить его в этих сеансах. Сеанс с несколькими репозиториями начинается выше клонов и читает только ключи `enabledPlugins` и `extraKnownMarketplaces` из файла `.claude/settings.json` каждого репозитория, но не правила разрешений, hooks, `env` или другие ключи. Маркетплейсы и плагины, которые эти два ключа объявляют, по-прежнему [не загружаются в облачном сеансе](/docs/ru/cloud-environments#what-carries-over-from-your-setup).810* **Общие параметры проекта** (`.claude/settings.json`): читаются в сеансе с одним репозиторием, потому что файл является частью клона и сеанс начинается внутри него. Зафиксируйте параметр там, чтобы применить его в этих сеансах. Сеанс с несколькими репозиториями начинается выше клонов и читает только ключи `enabledPlugins` и `extraKnownMarketplaces` из файла `.claude/settings.json` каждого репозитория, но не правила разрешений, hooks, `env` или другие ключи. Маркетплейсы и плагины, которые эти два ключа объявляют, по-прежнему [не загружаются в облачном сеансе](/docs/ru/cloud-environments#what-carries-over-from-your-setup).

811* **Параметры пользователя и локальные параметры проекта** (`~/.claude/settings.json` и `.claude/settings.local.json`): не читаются. Оба остаются на вашей машине, и локальный файл не находится в клоне.811* **Параметры пользователя и локальные параметры проекта** (`~/.claude/settings.json` и `.claude/settings.local.json`): не читаются. Оба остаются на вашей машине, и локальный файл не находится в клоне.

812* **Managed settings**: только [параметры, управляемые сервером](/docs/ru/server-managed-settings) достигают облачного сеанса; файл `managed-settings.json` или профиль MDM на вашем устройстве не достигают. [Самостоятельно размещенная среда](/docs/ru/self-hosted-environments) также читает файл управляемых параметров в образе своего runner. [Как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) говорит, когда этот файл применяется.812* **Managed settings**: файл `managed-settings.json` или профиль MDM на вашем устройстве не достигают облачного сеанса. [Параметры, управляемые сервером](/docs/ru/server-managed-settings) вашей организации достигают; [покрытие поверхности](/docs/ru/model-config#surface-coverage) перечисляет, какие облачные сеансы их получают. [Самостоятельно размещенная среда](/docs/ru/self-hosted-environments) также читает файл управляемых параметров в образе своего runner. [Как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) говорит, когда этот файл применяется.

813* **`/config`**: в вашем браузере на claude.ai/code открывает раздел Claude Code ваших параметров claude.ai вместо изменения значения. Чтобы изменить параметр для облачного сеанса, установите [переменную окружения](/docs/ru/cloud-environments#set-environment-variables) в среде или в сеансе с одним репозиторием зафиксируйте ключ в файле `.claude/settings.json` этого репозитория.813* **`/config`**: в вашем браузере на claude.ai/code открывает раздел Claude Code ваших параметров claude.ai вместо изменения значения. Чтобы изменить параметр для облачного сеанса, установите [переменную окружения](/docs/ru/cloud-environments#set-environment-variables) в среде или в сеансе с одним репозиторием зафиксируйте ключ в файле `.claude/settings.json` этого репозитория.

814 814

815[Что переносится из вашей установки](/docs/ru/cloud-environments#what-carries-over-from-your-setup) перечисляет остальное: `CLAUDE.md`, skills, MCP servers, plugins и учетные данные.815[Что переносится из вашей установки](/docs/ru/cloud-environments#what-carries-over-from-your-setup) перечисляет остальное: `CLAUDE.md`, skills, MCP servers, plugins и учетные данные.

settings-reference.md +379 −170

Details

577 Индекс параметров577 Индекс параметров

578</h2>578</h2>

579 579

580Каждый ключ ниже ссылается на его запись. Область действия указывает на [файлы](/docs/ru/settings#settings-files-and-who-they-affect), в которых он может находиться: `User` — это `~/.claude/settings.json`, `Project` — это `.claude/settings.json`, `Local` — это `.claude/settings.local.json`, а `Managed` — это [то, что развёртывает ваша организация](/docs/ru/managed-settings). `Any file` означает все четыре, а `Global config` означает [`~/.claude.json`](#global-config-settings).580Каждый ключ ниже ссылается на его запись. Область применения указывает [файлы](/docs/ru/settings#settings-files-and-who-they-affect), в которых он может находиться: `User` — это `~/.claude/settings.json`, `Project` — это `.claude/settings.json`, `Local` — это `.claude/settings.local.json`, а `Managed` — это [то, что развёртывает ваша организация](/docs/ru/managed-settings). `Any file` означает все четыре, а `Global config` означает [`~/.claude.json`](#global-config-settings).

581 581

582<ReferenceFilter582<ReferenceFilter

583 noun="settings"583 noun="settings"

597| [`allowAllClaudeAiMcps`](#allowallclaudeaimcps) | Загружайте [разъёмы claude.ai](/docs/ru/mcp), которые Claude Code получает сам, наряду с развёрнутым [`managed-mcp.json`](/docs/ru/managed-mcp#exclusive-control-with-managed-mcp-json) | MCP | Managed |597| [`allowAllClaudeAiMcps`](#allowallclaudeaimcps) | Загружайте [разъёмы claude.ai](/docs/ru/mcp), которые Claude Code получает сам, наряду с развёрнутым [`managed-mcp.json`](/docs/ru/managed-mcp#exclusive-control-with-managed-mcp-json) | MCP | Managed |

598| [`allowedChannelPlugins`](#allowedchannelplugins) | Замените список разрешений по умолчанию для [плагинов канала](/docs/ru/channels#restrict-which-channel-plugins-can-run), которые могут отправлять сообщения | Plugins and skills | Managed |598| [`allowedChannelPlugins`](#allowedchannelplugins) | Замените список разрешений по умолчанию для [плагинов канала](/docs/ru/channels#restrict-which-channel-plugins-can-run), которые могут отправлять сообщения | Plugins and skills | Managed |

603| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Сделайте [управляемые параметры](/docs/ru/managed-settings) единственным источником параметров для [правил разрешений](/docs/ru/permissions#managed-settings) | Permission settings | Managed |603| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Сделайте [управляемые параметры](/docs/ru/managed-settings) единственным источником параметров для [правил разрешений](/docs/ru/permissions#managed-settings) | Permission settings | Managed |

606| [`askUserQuestionTimeout`](#askuserquestiontimeout) | Позвольте неотвеченному вопросу [автоматически продолжиться](/docs/ru/tools-reference#question-auto-continue-timeout) после времени простоя | Interface and terminal | User or managed |606| [`askUserQuestionTimeout`](#askuserquestiontimeout) | Позвольте неотвеченному вопросу [автоматически продолжиться](/docs/ru/tools-reference#question-auto-continue-timeout) после времени простоя | Interface and terminal | User or managed |

610| [`attribution.sessionUrl`](#attribution-sessionurl) | Опустите ссылку на сеанс claude.ai из коммитов [облака](/docs/ru/claude-code-on-the-web) и [Remote Control](/docs/ru/remote-control) | Git and attribution | Any file |610| [`attribution.sessionUrl`](#attribution-sessionurl) | Опустите ссылку на сеанс claude.ai из [облачных](/docs/ru/claude-code-on-the-web) и [Remote Control](/docs/ru/remote-control) коммитов | Git and attribution | Any file |

613| [`autoConnectIde`](#autoconnectide) | Автоматически подключайтесь к работающей IDE [VS Code](/docs/ru/vs-code) или [JetBrains](/docs/ru/jetbrains#from-external-terminals) из внешнего терминала | Global config settings | Global config |613| [`autoConnectIde`](#autoconnectide) | Автоматически подключайтесь к работающей [VS Code](/docs/ru/vs-code) или [JetBrains](/docs/ru/jetbrains#from-external-terminals) IDE из внешнего терминала | Global config settings | Global config |

614| [`autoContinueAtUsageLimit`](#autocontinueatusagelimit) | Ждите в открытом сеансе и [продолжайте задачу автоматически](/docs/ru/interactive-mode#wait-for-a-usage-limit-to-reset) после сброса лимита использования claude.ai | Interface and terminal | User or managed |614| [`autoContinueAtUsageLimit`](#autocontinueatusagelimit) | Ждите в открытом сеансе и [автоматически продолжайте задачу](/docs/ru/interactive-mode#wait-for-a-usage-limit-to-reset) после сброса лимита использования claude.ai | Interface and terminal | User or managed |

615| [`autoInstallIdeExtension`](#autoinstallideextension) | Отключите автоматическую установку [расширения IDE](/docs/ru/vs-code#install-the-extension) из терминала VS Code | Global config settings | Global config |615| [`autoInstallIdeExtension`](#autoinstallideextension) | Отключите автоматическую установку [расширения IDE](/docs/ru/vs-code#install-the-extension) из терминала VS Code | Global config settings | Global config |

618| [`autoMode`](#automode) | Добавьте свои собственные правила разрешения и запрета к классификатору [автоматического режима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) | Permission settings | User or managed |618| [`autoMode`](#automode) | Добавьте свои собственные правила разрешения и запрета к классификатору [режима авто](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) | Permission settings | User or managed |

619| [`autoMode.classifyAllShell`](#automode-classifyallshell) | Отправляйте каждую команду shell через [классификатор автоматического режима](/docs/ru/permission-modes#what-the-classifier-blocks-by-default), даже те, которые соответствуют узкому правилу разрешения | Permission settings | User or managed |619| [`autoMode.classifyAllShell`](#automode-classifyallshell) | Отправляйте каждую команду shell через [классификатор режима авто](/docs/ru/permission-modes#what-the-classifier-blocks-by-default), даже те, которые соответствуют узкому правилу разрешения | Permission settings | User or managed |

623| [`awaySummaryEnabled`](#awaysummaryenabled) | Отключите [краткое описание сеанса](/docs/ru/interactive-mode#session-recap), показываемое при возврате в терминал | Remote, desktop, and notifications | Any file |623| [`availableModelsMatch`](#availablemodelsmatch) | Сделайте каждую запись ID модели `availableModels` [разрешающей только версию, которую она называет](/docs/ru/model-config#block-specific-models-or-versions) | Model and responses | Managed |

624| [`awaySummaryEnabled`](#awaysummaryenabled) | Отключите [краткое описание сеанса](/docs/ru/interactive-mode#session-recap), показываемое при возврате к терминалу | Remote, desktop, and notifications | Any file |

624| [`awsAuthRefresh`](#awsauthrefresh) | Обновляйте истёкшие [учётные данные Bedrock](/docs/ru/amazon-bedrock#advanced-credential-configuration) в `.aws` с помощью вашей собственной команды | Authentication and providers | Any file |625| [`awsAuthRefresh`](#awsauthrefresh) | Обновляйте истёкшие [учётные данные Bedrock](/docs/ru/amazon-bedrock#advanced-credential-configuration) в `.aws` с помощью вашей собственной команды | Authentication and providers | Any file |

625| [`awsCredentialExport`](#awscredentialexport) | Предоставляйте [учётные данные Bedrock](/docs/ru/amazon-bedrock#advanced-credential-configuration) как JSON из вашей собственной команды | Authentication and providers | Any file |626| [`awsCredentialExport`](#awscredentialexport) | Предоставляйте [учётные данные Bedrock](/docs/ru/amazon-bedrock#advanced-credential-configuration) как JSON из вашей собственной команды | Authentication and providers | Any file |

636| [`copyOnSelect`](#copyonselect) | Отключите автоматическое копирование текста, который вы выбираете мышью при [полноэкранном отображении](/docs/ru/fullscreen#use-the-mouse) и в представлении агента | Global config settings | Global config |638| [`copyFullResponse`](#copyfullresponse) | Сделайте [`/copy`](/docs/ru/commands) копирующей полный ответ без отображения средства выбора блока кода | Global config settings | Global config |

637| [`crossSessionInbound`](#crosssessioninbound) | Выберите, доставляет ли Claude Code [сообщения из ваших других сеансов](/docs/ru/cross-session-messaging#control-inbound-messages), показывает уведомление без доставки или отказывает в них | Agents, sessions, and worktrees | Any file |639| [`copyOnSelect`](#copyonselect) | Отключите автоматическое копирование текста, который вы выбираете мышью в [полноэкранном отображении](/docs/ru/fullscreen#use-the-mouse) и представлении агента | Global config settings | Global config |

640| [`crossSessionInbound`](#crosssessioninbound) | Выберите, доставляет ли Claude Code [сообщения из ваших других сеансов](/docs/ru/cross-session-messaging#control-inbound-messages), показывает уведомление без их доставки или отказывает в них | Agents, sessions, and worktrees | Any file |

638| [`defaultShell`](#defaultshell) | Выберите, запускается ли Bash или PowerShell для команд shell, которые вы вводите с префиксом [`!`](/docs/ru/interactive-mode#shell-mode-with-prefix) | Interface and terminal | Any file |641| [`defaultShell`](#defaultshell) | Выберите, запускается ли Bash или PowerShell для команд shell, которые вы вводите с префиксом [`!`](/docs/ru/interactive-mode#shell-mode-with-prefix) | Interface and terminal | Any file |

640| [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | Установите ограничение по возрасту в днях для [стенограмм Claude Desktop и Cowork](/docs/ru/claude-directory#cleaned-up-automatically) | Privacy and telemetry | User or managed |644| [`deniedModels`](#deniedmodels) | [Блокируйте определённые модели](/docs/ru/model-config#block-specific-models-or-versions), даже те, которые разрешает `availableModels` | Model and responses | Managed |

641| [`dialogExpiry`](#dialogexpiry) | Установите, как долго Claude Code ждёт ответа [Remote Control](/docs/ru/remote-control) или хоста SDK на переданный диалог перед отменой диалога | Interface and terminal | User or managed |645| [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | Установите возрастной лимит в днях для [стенограмм Claude Desktop и Cowork](/docs/ru/claude-directory#cleaned-up-automatically) | Privacy and telemetry | User or managed |

642| [`diffTool`](#difftool) | Выберите, открываются ли предложенные Claude изменения файлов в средстве просмотра diff [VS Code](/docs/ru/vs-code) или [JetBrains](/docs/ru/jetbrains#features) или остаются в терминале | Global config settings | Global config |646| [`dialogExpiry`](#dialogexpiry) | Установите, как долго Claude Code ждёт, пока [Remote Control](/docs/ru/remote-control) или хост SDK ответит на переданный диалог, прежде чем отменить диалог | Interface and terminal | User or managed |

643| [`disableAgentView`](#disableagentview) | Отключите фоновых агентов и [представление агента](/docs/ru/agent-view) | Agents, sessions, and worktrees | Any file |647| [`diffTool`](#difftool) | Выберите, открываются ли предложенные Claude изменения файлов в [VS Code](/docs/ru/vs-code) или [JetBrains](/docs/ru/jetbrains#features) средстве просмотра различий или остаются в терминале | Global config settings | Global config |

644| [`disableAllHooks`](#disableallhooks) | Отключите [hooks](/docs/ru/hooks), пользовательскую [строку состояния](/docs/ru/statusline) и пользовательскую команду [`@` предложения файла](/docs/ru/interactive-mode#quick-commands) одновременно | Hooks and automation | Any file |649| [`disableAllHooks`](#disableallhooks) | Отключите [hooks](/docs/ru/hooks), пользовательскую [строку состояния](/docs/ru/statusline) и пользовательскую команду [`@` предложения файла](/docs/ru/interactive-mode#quick-commands) одновременно | Hooks and automation | Any file |

650| [`disableCommandPluginSources`](#disablecommandpluginsources) | Блокируйте [плагины](/docs/ru/plugins/overview), которые устанавливаются путём запуска команды, объявленной маркетплейсом | Plugins and skills | Managed |655| [`disableCommandPluginSources`](#disablecommandpluginsources) | Блокируйте [плагины](/docs/ru/plugins/overview), которые устанавливаются путём выполнения команды, объявленной маркетплейсом | Plugins and skills | Managed |

652| [`disableDesktopLocalSessions`](#disabledesktoplocalsessions) | Отключите [сеансы Desktop Code](/docs/ru/desktop#local-sessions-on-managed-devices), которые работают на устройстве, оставляя SSH для других хостов и облака | Remote, desktop, and notifications | Managed |657| [`disableDesktopLocalSessions`](#disabledesktoplocalsessions) | Отключите [сеансы Desktop Code](/docs/ru/desktop#local-sessions-on-managed-devices), которые работают на устройстве, оставляя SSH для других хостов и облака | Remote, desktop, and notifications | Managed |

656| [`disableSideloadFlags`](#disablesideloadflags) | Отклоняйте флаги CLI, которые загружают [плагины](/docs/ru/plugins/overview), [подагентов](/docs/ru/sub-agents) и [MCP серверы](/docs/ru/mcp) | Enterprise and managed settings | Managed |661| [`disableSideloadFlags`](#disablesideloadflags) | Отклоняйте флаги CLI, которые загружают [плагины](/docs/ru/plugins/overview), [подагенты](/docs/ru/sub-agents) и [MCP серверы](/docs/ru/mcp) | Enterprise and managed settings | Managed |

663| [`enableArtifact`](#enableartifact) | Отключите [инструмент Artifact](/docs/ru/artifacts) с помощью `false` в любом файле; ни один файл не может его включить обратно | Remote, desktop, and notifications | Any file |668| [`enableArtifact`](#enableartifact) | Отключите [инструмент Artifact](/docs/ru/artifacts) с помощью `false` в любом файле; ни один файл не может его включить обратно | Remote, desktop, and notifications | Any file |

667| [`enforceAvailableModels`](#enforceavailablemodels) | Держите [выбор Default](/docs/ru/model-config#enforce-the-allowlist-for-the-default-model) `/model` внутри вашего списка разрешений `availableModels` | Model and responses | Any file |672| [`enforceAvailableModels`](#enforceavailablemodels) | Держите [выбор по умолчанию `/model`](/docs/ru/model-config#enforce-the-allowlist-for-the-default-model) внутри вашего списка разрешений `availableModels` | Model and responses | Any file |

669| [`externalEditorContext`](#externaleditorcontext) | Показывайте последний ответ Claude как комментарии при нажатии [Ctrl+G](/docs/ru/interactive-mode#general-controls) для редактирования | Global config settings | Global config |674| [`externalEditorContext`](#externaleditorcontext) | Показывайте последний ответ Claude как комментарии при нажатии [Ctrl+G](/docs/ru/interactive-mode#general-controls) для редактирования | Global config settings | Global config |

674| [`feedbackDrafts`](#feedbackdrafts) | Контролируйте, ставит ли Claude в очередь [черновики обратной связи](/docs/ru/tools-reference#sendfeedback-tool-behavior) для вашего рассмотрения | Privacy and telemetry | User or managed |679| [`feedbackDrafts`](#feedbackdrafts) | Контролируйте, ставит ли Claude в очередь [черновики обратной связи](/docs/ru/tools-reference#sendfeedback-tool-behavior) для вашего рассмотрения | Privacy and telemetry | User or managed |

680| [`forceLoginMethod`](#forceloginmethod) | [Ограничьте вход](/docs/ru/authentication#restrict-login-to-your-organization) на claude.ai, Claude Console или [облачный шлюз](/docs/ru/claude-apps-gateway) | Authentication and providers | Any file |685| [`forceLoginMethod`](#forceloginmethod) | [Ограничьте вход](/docs/ru/authentication#restrict-login-to-your-organization) на claude.ai, Claude Console или [облачный шлюз](/docs/ru/claude-apps-gateway) | Authentication and providers | Any file |

681| [`forceLoginOrgUUID`](#forceloginorguuid) | [Привяжите входы claude.ai к вашей организации](/docs/ru/authentication#restrict-login-to-your-organization); только управляемый источник это обеспечивает | Authentication and providers | Any file |686| [`forceLoginOrgUUID`](#forceloginorguuid) | [Привяжите входы claude.ai к вашей организации](/docs/ru/authentication#restrict-login-to-your-organization); только управляемый источник это обеспечивает | Authentication and providers | Any file |

682| [`forceRemoteSettingsRefresh`](#forceremotesettingsrefresh) | Блокируйте запуск до [свежей загрузки параметров, управляемых сервером](/docs/ru/server-managed-settings) | Enterprise and managed settings | Managed |687| [`forceRemoteSettingsRefresh`](#forceremotesettingsrefresh) | Блокируйте запуск до тех пор, пока [параметры, управляемые сервером](/docs/ru/server-managed-settings) не будут свежо получены | Enterprise and managed settings | Managed |

683| [`gatewayInternalNetworks`](#gatewayinternalnetworks) | Позвольте `/login` достичь [облачного шлюза](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) на общедоступном пространстве IPv4, которое ваша организация использует внутри | Authentication and providers | Managed |688| [`gatewayInternalNetworks`](#gatewayinternalnetworks) | Позвольте `/login` достичь [облачного шлюза](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) на общедоступном пространстве IPv4, которое ваша организация использует внутри | Authentication and providers | Managed |

684| [`gcpAuthRefresh`](#gcpauthrefresh) | Обновляйте [учётные данные Google Cloud](/docs/ru/google-vertex-ai#advanced-credential-configuration) с помощью вашей собственной команды | Authentication and providers | Any file |689| [`gcpAuthRefresh`](#gcpauthrefresh) | Обновляйте [учётные данные Google Cloud](/docs/ru/google-vertex-ai#advanced-credential-configuration) с помощью вашей собственной команды | Authentication and providers | Any file |

690| [`isolatePeerMachines`](#isolatepeermachines) | Спросите вас перед тем, как Claude [отправит сообщение одному из ваших сеансов на другой машине](/docs/ru/cross-session-messaging#require-approval-for-cross-machine-messages) | Agents, sessions, and worktrees | Any file |695| [`isolatePeerMachines`](#isolatepeermachines) | Спросите вас перед тем, как Claude [отправит сообщение одному из ваших сеансов на другой машине](/docs/ru/cross-session-messaging#require-approval-for-cross-machine-messages) | Agents, sessions, and worktrees | Any file |

691| [`keybindingFlavor`](#keybindingflavor) | Устарело и не имеет эффекта; сочетания клавиш для редактирования слов всегда [следуют соглашениям readline](/docs/ru/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | Interface and terminal | Any file |696| [`keybindingFlavor`](#keybindingflavor) | Устарело и не имеет эффекта; сочетания клавиш для редактирования слов всегда [следуют соглашениям readline](/docs/ru/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | Interface and terminal | Any file |

698| [`leftArrowOpensAgents`](#leftarrowopensagents) | Отключите сочетание клавиш `←`, которое [переводит сеанс в фон и открывает представление агента](/docs/ru/agent-view#switch-sessions-without-leaving-the-terminal) | Global config settings | Global config |

693| [`managedMcpServers`](#managedmcpservers) | Предоставляйте удалённые [MCP серверы](/docs/ru/managed-mcp#provide-servers-through-managed-settings) каждому пользователю наряду с теми, которые они добавляют | MCP | Managed |699| [`managedMcpServers`](#managedmcpservers) | Предоставляйте удалённые [MCP серверы](/docs/ru/managed-mcp#provide-servers-through-managed-settings) каждому пользователю наряду с теми, которые они добавляют | MCP | Managed |

694| [`managedSourcesBehavior`](#managedsourcesbehavior) | Составляйте каждый [управляемый источник](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), который вы развёртываете, вместо использования только одного с наивысшим приоритетом | Enterprise and managed settings | Managed |700| [`managedSourcesBehavior`](#managedsourcesbehavior) | Объедините каждый [управляемый источник](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), который вы развёртываете, вместо использования только одного с наивысшим приоритетом | Enterprise and managed settings | Managed |

699| [`modelPicker`](#modelpicker) | Выберите, какие модели [средство выбора `/model`](/docs/ru/model-config#available-models) перечисляет, в вашем собственном порядке и с вашими собственными метками | Model and responses | User or managed |706| [`modelPicker`](#modelpicker) | Выберите, какие модели [средство выбора `/model`](/docs/ru/model-config#available-models) перечисляет, в вашем собственном порядке и с вашими собственными метками | Model and responses | User or managed |

702| [`otelHeadersHelper`](#otelheadershelper) | Создавайте ротирующие заголовки [OpenTelemetry](/docs/ru/monitoring-usage#dynamic-headers) с помощью вашей собственной команды | Authentication and providers | Any file |709| [`otelHeadersHelper`](#otelheadershelper) | Создавайте ротирующие заголовки [OpenTelemetry](/docs/ru/monitoring-usage#dynamic-headers) с помощью вашей собственной команды | Authentication and providers | Any file |

704| [`parentSettingsBehavior`](#parentsettingsbehavior) | Применяйте или отбрасывайте ограничения, которые [хост SDK или IDE](/docs/ru/managed-settings#let-an-embedding-host-add-policy) передаёт при развёртывании [управляемых параметров](/docs/ru/managed-settings) | Enterprise and managed settings | Managed |711| [`parentSettingsBehavior`](#parentsettingsbehavior) | Применяйте или отбрасывайте ограничения, которые [хост SDK или IDE](/docs/ru/managed-settings#let-an-embedding-host-add-policy) передаёт при развёртывании [управляемых параметров](/docs/ru/managed-settings) | Enterprise and managed settings | Managed |

710| [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | Заставьте инструменты файлов отказывать в чтении вне [рабочих каталогов](/docs/ru/permissions#working-directories) в каждом режиме разрешений | Permission settings | Any file |717| [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | Сделайте инструменты файлов отказывающимися от чтения вне [рабочих каталогов](/docs/ru/permissions#working-directories) в каждом режиме разрешений | Permission settings | Any file |

711| [`permissions.defaultMode`](#permissions-defaultmode) | Установите [режим разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in), в котором начинаются новые сеансы | Permission settings | Any file |718| [`permissions.defaultMode`](#permissions-defaultmode) | Установите [режим разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in), в котором начинаются новые сеансы | Permission settings | Any file |

712| [`permissions.deny`](#permissions-deny) | Блокируйте перечисленные [использования инструментов](/docs/ru/permissions#permission-rule-syntax), включая чтение файлов, содержащих секреты | Permission settings | Any file |719| [`permissions.deny`](#permissions-deny) | Блокируйте перечисленные [использования инструментов](/docs/ru/permissions#permission-rule-syntax), включая чтение файлов, содержащих секреты | Permission settings | Any file |

713| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Предотвратите вход кого-либо в [режим bypassPermissions](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) | Permission settings | Any file |720| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Предотвратите вход кого-либо в [режим bypassPermissions](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) | Permission settings | Any file |

718| [`policyHelper`](#policyhelper) | Запустите исполняемый файл, который вычисляет [управляемые параметры](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) при запуске | Enterprise and managed settings | Managed |725| [`policyHelper`](#policyhelper) | Запустите исполняемый файл, который вычисляет [управляемые параметры](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) при запуске | Enterprise and managed settings | Managed |

719| [`policyHelper.path`](#policyhelper-path) | Назовите [вспомогательный исполняемый файл](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program), который запускает Claude Code | Enterprise and managed settings | Managed |726| [`policyHelper.path`](#policyhelper-path) | Назовите [вспомогательный исполняемый файл](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program), который запускает Claude Code | Enterprise and managed settings | Managed |

720| [`policyHelper.refreshIntervalMs`](#policyhelper-refreshintervalms) | Повторно запустите [помощника](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) в фоновом режиме по расписанию | Enterprise and managed settings | Managed |727| [`policyHelper.refreshIntervalMs`](#policyhelper-refreshintervalms) | Повторно запустите [помощника](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) в фоне по расписанию | Enterprise and managed settings | Managed |

721| [`policyHelper.timeoutMs`](#policyhelper-timeoutms) | Установите, как долго Claude Code ждёт [помощника](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) | Enterprise and managed settings | Managed |728| [`policyHelper.timeoutMs`](#policyhelper-timeoutms) | Установите, как долго Claude Code ждёт [помощника](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) | Enterprise and managed settings | Managed |

722| [`preferredNotifChannel`](#preferrednotifchannel) | Выберите [звонок терминала или уведомление рабочего стола](/docs/ru/terminal-config#get-a-terminal-bell-or-notification) для завершения задачи | Remote, desktop, and notifications | Any file |729| [`preferredNotifChannel`](#preferrednotifchannel) | Выберите [звонок терминала или уведомление рабочего стола](/docs/ru/terminal-config#get-a-terminal-bell-or-notification) для завершения задачи | Remote, desktop, and notifications | Any file |

724| [`processWrapper`](#processwrapper) | Запускайте фоновые процессы Claude Code через [корпоративный запускатель](/docs/ru/corporate-launcher) на macOS и Linux | Agents, sessions, and worktrees | User or managed |731| [`processWrapper`](#processwrapper) | Запускайте фоновые процессы Claude Code через [корпоративный запускатель](/docs/ru/corporate-launcher) на macOS и Linux | Agents, sessions, and worktrees | User or managed |

734| [`prStatusFooterEnabled`](#prstatusfooterenabled) | Отключите [значок статуса PR](/docs/ru/interactive-mode#pr-review-status) в нижнем колонтитуле приглашения и проверку pull request'а позади него | Global config settings | Global config |

728| [`remote.defaultEnvironmentId`](#remote-defaultenvironmentid) | Выберите [облачную среду](/docs/ru/cloud-environments) по умолчанию для `claude --cloud`; самостоятельно размещённый ID `ccpool_` доступен только для чтения из параметров пользователя и управляемых параметров и `--settings` | Remote, desktop, and notifications | Any file |736| [`remote.defaultEnvironmentId`](#remote-defaultenvironmentid) | Выберите [облачную среду](/docs/ru/cloud-environments) по умолчанию для `claude --cloud`; самостоятельно размещённый ID `ccpool_` доступен только для чтения из пользовательских и управляемых параметров и `--settings` | Remote, desktop, and notifications | Any file |

729| [`remoteControlAtStartup`](#remotecontrolatstartup) | Подключайте [Remote Control](/docs/ru/remote-control#enable-remote-control-for-all-sessions) автоматически при запуске сеанса | Remote, desktop, and notifications | Any file |737| [`remoteControlAtStartup`](#remotecontrolatstartup) | Подключайте [Remote Control](/docs/ru/remote-control#enable-remote-control-for-all-sessions) автоматически при запуске сеанса | Remote, desktop, and notifications | Any file |

736| [`sandbox.allowUnsandboxedCommands`](#sandbox-allowunsandboxedcommands) | Позвольте Claude повторить заблокированную команду вне [песочницы](/docs/ru/sandboxing#the-unsandboxed-retry-escape-hatch) или запретить это | Sandbox settings | Any file |744| [`sandbox.allowUnsandboxedCommands`](#sandbox-allowunsandboxedcommands) | Позвольте Claude повторить заблокированную команду вне [песочницы](/docs/ru/sandboxing#the-unsandboxed-retry-escape-hatch) или запретить это | Sandbox settings | Any file |

740| [`sandbox.credentials.allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) | Позвольте [замаскированным учётным данным](/docs/ru/sandboxing#mask-credentials) достичь простых HTTP-сервисов в доверенных тестовых сетях | Sandbox settings | User or managed |748| [`sandbox.credentials.allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) | Позвольте [замаскированным учётным данным](/docs/ru/sandboxing#mask-credentials) достичь простых HTTP-сервисов на доверенных тестовых сетях | Sandbox settings | User or managed |

741| [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs) | Свяжите переменные пользовательского имени ключа AWS в одно учётное данные для [повторного подписания](/docs/ru/sandboxing#re-sign-aws-requests) | Sandbox settings | User or managed |749| [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs) | Свяжите переменные пользовательского имени AWS ключа в одно учётное данные для [повторного подписания](/docs/ru/sandboxing#re-sign-aws-requests) | Sandbox settings | User or managed |

742| [`sandbox.credentials.envVars`](#sandbox-credentials-envvars) | Отмените установку или замаскируйте переменную окружения внутри [песочницы](/docs/ru/sandboxing#mask-environment-variables) | Sandbox settings | Any file |750| [`sandbox.credentials.envVars`](#sandbox-credentials-envvars) | Отмените установку или замаскируйте переменную окружения внутри [песочницы](/docs/ru/sandboxing#mask-environment-variables) | Sandbox settings | Any file |

743| [`sandbox.credentials.files`](#sandbox-credentials-files) | Блокируйте или замаскируйте чтение файла учётных данных внутри [песочницы](/docs/ru/sandboxing#mask-credential-files) | Sandbox settings | Any file |751| [`sandbox.credentials.files`](#sandbox-credentials-files) | Блокируйте или замаскируйте чтение файла учётных данных внутри [песочницы](/docs/ru/sandboxing#mask-credential-files) | Sandbox settings | Any file |

744| [`sandbox.credentials.sigv4`](#sandbox-credentials-sigv4) | Выберите, будут ли потоковые, предписанные или [запросы AWS SigV4A](/docs/ru/sandboxing#re-sign-aws-requests) отклонены или пройдут | Sandbox settings | User or managed |752| [`sandbox.credentials.sigv4`](#sandbox-credentials-sigv4) | Выберите, будут ли потоковые, предписанные или [запросы AWS SigV4A](/docs/ru/sandboxing#re-sign-aws-requests) отказаны или пройдут | Sandbox settings | User or managed |

747| [`sandbox.enableWeakerNetworkIsolation`](#sandbox-enableweakernetworkisolation) | Позвольте `gh`, `gcloud` и `terraform` проверять TLS за MITM-прокси внутри [песочницы](/docs/ru/sandboxing#troubleshooting) на macOS | Sandbox settings | Any file |755| [`sandbox.enableWeakerNetworkIsolation`](#sandbox-enableweakernetworkisolation) | Позвольте `gh`, `gcloud` и `terraform` проверять TLS за MITM прокси внутри [песочницы](/docs/ru/sandboxing#troubleshooting) на macOS | Sandbox settings | Any file |

751| [`sandbox.filesystem.allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) | Остановите разработчиков от повторного открытия [путей чтения, которые ваша организация заблокировала](/docs/ru/sandboxing#keep-developers-from-widening-the-policy) | Sandbox settings | Managed |759| [`sandbox.filesystem.allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) | Остановите разработчиков от повторного открытия [путей чтения, которые ваша организация заблокировала](/docs/ru/sandboxing#keep-developers-from-widening-the-policy) | Sandbox settings | Managed |

756| [`sandbox.filesystem.disabled`](#sandbox-filesystem-disabled) | [Отключите изоляцию файловой системы](/docs/ru/sandboxing#disable-filesystem-isolation) при сохранении изоляции сети | Sandbox settings | User or managed |764| [`sandbox.filesystem.disabled`](#sandbox-filesystem-disabled) | [Отключите изоляцию файловой системы](/docs/ru/sandboxing#disable-filesystem-isolation) при сохранении изоляции сети | Sandbox settings | User or managed |

762| [`sandbox.network.allowMachLookup`](#sandbox-network-allowmachlookup) | Позвольте инструментам macOS [изолированным](/docs/ru/sandboxing), таким как iOS Simulator или Playwright, достичь их XPC-сервисов | Sandbox settings | Any file |770| [`sandbox.network.allowMachLookup`](#sandbox-network-allowmachlookup) | Позвольте инструментам macOS [изолированным](/docs/ru/sandboxing), таким как iOS Simulator или Playwright, достичь их XPC сервисов | Sandbox settings | Any file |

763| [`sandbox.network.allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) | Заблокируйте список разрешений сети на [управляемые параметры](/docs/ru/sandboxing#keep-developers-from-widening-the-policy) | Sandbox settings | Managed |771| [`sandbox.network.allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) | Заблокируйте список разрешений сети на [управляемые параметры](/docs/ru/sandboxing#keep-developers-from-widening-the-policy) | Sandbox settings | Managed |

764| [`sandbox.network.allowUnixSockets`](#sandbox-network-allowunixsockets) | Перечислите пути Unix-сокетов, которые [изолированные](/docs/ru/sandboxing) команды могут использовать на macOS | Sandbox settings | Any file |772| [`sandbox.network.allowUnixSockets`](#sandbox-network-allowunixsockets) | Перечислите пути Unix сокетов, которые [изолированные](/docs/ru/sandboxing) команды могут использовать на macOS | Sandbox settings | Any file |

765| [`sandbox.network.deniedDomains`](#sandbox-network-denieddomains) | Блокируйте домены для [изолированных](/docs/ru/sandboxing) команд, даже внутри разрешённого подстановочного знака | Sandbox settings | Any file |773| [`sandbox.network.deniedDomains`](#sandbox-network-denieddomains) | Блокируйте домены для [изолированных](/docs/ru/sandboxing) команд, даже внутри разрешённого подстановочного знака | Sandbox settings | Any file |

766| [`sandbox.network.httpProxyPort`](#sandbox-network-httpproxyport) | Маршрутизируйте [песочницу](/docs/ru/sandboxing#custom-proxy-configuration) HTTP-трафик через ваш собственный прокси | Sandbox settings | Any file |774| [`sandbox.network.httpProxyPort`](#sandbox-network-httpproxyport) | Маршрутизируйте [песочницу](/docs/ru/sandboxing#custom-proxy-configuration) HTTP трафик через ваш собственный прокси | Sandbox settings | Any file |

767| [`sandbox.network.socksProxyPort`](#sandbox-network-socksproxyport) | Маршрутизируйте [песочницу](/docs/ru/sandboxing#custom-proxy-configuration) SOCKS-трафик через ваш собственный прокси | Sandbox settings | Any file |775| [`sandbox.network.socksProxyPort`](#sandbox-network-socksproxyport) | Маршрутизируйте [песочницу](/docs/ru/sandboxing#custom-proxy-configuration) SOCKS трафик через ваш собственный прокси | Sandbox settings | Any file |

769| [`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) | Пусть [песочница](/docs/ru/sandboxing#network-isolation) прокси завершает TLS, чтобы она могла читать HTTPS-запросы | Sandbox settings | User or managed |777| [`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) | Пусть [песочница](/docs/ru/sandboxing#network-isolation) прокси завершает TLS, чтобы она могла читать HTTPS запросы | Sandbox settings | User or managed |

772| [`showClearContextOnPlanAccept`](#showclearcontextonplanaccept) | Показывайте опцию "очистить контекст" на [экране принятия плана](/docs/ru/permission-modes#review-and-approve-a-plan) | Interface and terminal | Any file |780| [`showClearContextOnPlanAccept`](#showclearcontextonplanaccept) | Показывайте опцию "очистить контекст" на [экране принятия плана](/docs/ru/permission-modes#review-and-approve-a-plan) | Interface and terminal | Any file |

775| [`skillListingBudgetFraction`](#skilllistingbudgetfraction) | Зарезервируйте больше или меньше контекста для [списка навыков](/docs/ru/skills#skill-descriptions-are-cut-short) | Memory and context | Any file |783| [`skillListingBudgetFraction`](#skilllistingbudgetfraction) | Зарезервируйте больше или меньше контекста для [списка навыков](/docs/ru/skills#skill-descriptions-are-cut-short) | Memory and context | Any file |

778| [`skipAutoPermissionPrompt`](#skipautopermissionprompt) | Пропустите одноразовое уведомление Claude Code, которое показывается при первом входе в [автоматический режим](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) самостоятельно, а не через встроенное значение по умолчанию | Permission settings | User or managed |786| [`skipAutoPermissionPrompt`](#skipautopermissionprompt) | Пропустите одноразовое уведомление, которое Claude Code показывает при первом входе в [режим авто](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) самостоятельно, а не через встроенное значение по умолчанию | Permission settings | User or managed |

779| [`skipDangerousModePermissionPrompt`](#skipdangerousmodepermissionprompt) | Пропустите диалог подтверждения перед [режимом bypassPermissions](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) | Permission settings | User, local, or managed |787| [`skipDangerousModePermissionPrompt`](#skipdangerousmodepermissionprompt) | Пропустите диалог подтверждения перед [режимом bypassPermissions](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) | Permission settings | User, local, or managed |

781| [`spellcheck`](#spellcheck) | Подчеркивайте неправильно написанные слова в приглашении ввода с помощью [проверки орфографии](/docs/ru/interactive-mode#check-spelling-as-you-type), которую вы устанавливаете | Interface and terminal | User or managed |789| [`spellcheck`](#spellcheck) | Подчеркивайте неправильно написанные слова в приглашении ввода с помощью [проверки орфографии](/docs/ru/interactive-mode#check-spelling-as-you-type), которую вы устанавливаете | Interface and terminal | User or managed |

785| [`sshConfigs`](#sshconfigs) | Добавьте [SSH-соединения](/docs/ru/desktop#pre-configure-ssh-connections-for-your-team) в раскрывающееся меню среды Desktop | Remote, desktop, and notifications | User or managed |793| [`sshConfigs`](#sshconfigs) | Добавьте [SSH подключения](/docs/ru/desktop#pre-configure-ssh-connections-for-your-team) в раскрывающееся меню среды Desktop | Remote, desktop, and notifications | User or managed |

786| [`sshHostAllowlist`](#sshhostallowlist) | Ограничьте, какие хосты [сеансы Desktop SSH](/docs/ru/desktop#restrict-which-ssh-hosts-users-can-connect-to) могут достичь | Remote, desktop, and notifications | Managed |794| [`sshHostAllowlist`](#sshhostallowlist) | Ограничьте, какие хосты [сеансы Desktop SSH](/docs/ru/desktop#restrict-which-ssh-hosts-users-can-connect-to) могут достичь | Remote, desktop, and notifications | Managed |

788| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Список разрешений для источников [маркетплейса](/docs/ru/plugins/overview) для пользователей, которые могут добавлять и устанавливать | Plugins and skills | Managed |796| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Создайте список разрешений для источников [маркетплейса](/docs/ru/plugins/overview), которые пользователи могут добавлять и устанавливать | Plugins and skills | Managed |

789| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Блокируйте [навыки](/docs/ru/skills), [агентов](/docs/ru/sub-agents), [hooks](/docs/ru/hooks) и [MCP серверы](/docs/ru/mcp) из источников пользователя и проекта | Plugins and skills | Managed |797| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Блокируйте [навыки](/docs/ru/skills), [агенты](/docs/ru/sub-agents), [hooks](/docs/ru/hooks) и [MCP серверы](/docs/ru/mcp) из пользовательских и проектных источников | Plugins and skills | Managed |

794| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Выберите [время жизни кэша подсказки](/docs/ru/prompt-caching#cache-lifetime) для подагентов и других запросов вне основного разговора | Model and responses | Any file |802| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Выберите [время жизни кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) для подагентов и других запросов вне основного разговора | Model and responses | Any file |

796| [`switchModelsOnFlag`](#switchmodelsonflag) | Автоматически переключайте модели или приостанавливайте, когда [классификатор безопасности](/docs/ru/model-config#ask-before-switching) помечает запрос | Model and responses | Any file |804| [`switchModelsOnFlag`](#switchmodelsonflag) | Переключайте модели автоматически или приостанавливайте, когда [классификатор безопасности](/docs/ru/model-config#ask-before-switching) помечает запрос | Model and responses | Any file |

797| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | Остановите загрузку [плагинов, включённых в вашу учётную запись claude.ai](/docs/ru/plugins/loading#synced-plugins) и скройте уже синхронизированные | Plugins and skills | User, local, or managed |805| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | Остановите загрузку [плагинов, включённых в вашей учётной записи claude.ai](/docs/ru/plugins/loading#synced-plugins) и остановите загрузку новых | Plugins and skills | User, local, or managed |

798| [`syncClaudeAiSkills`](#syncclaudeaiskills) | Остановите загрузку [навыков, включённых в вашу учётную запись claude.ai](/docs/ru/skills#how-synced-skills-behave) и скройте уже синхронизированные | Plugins and skills | User, local, or managed |806| [`syncClaudeAiSkills`](#syncclaudeaiskills) | Остановите загрузку [навыков, включённых в вашей учётной записи claude.ai](/docs/ru/skills#how-synced-skills-behave) и остановите загрузку новых | Plugins and skills | User, local, or managed |

801| [`teammateDefaultModel`](#teammatedefaultmodel) | Удалено в v2.1.234; см. [Укажите товарищей по команде и модели](/docs/ru/agent-teams#specify-teammates-and-models) для того, как Claude Code выбирает модель товарища по команде | Global config settings | Global config |809| [`teammateDefaultModel`](#teammatedefaultmodel) | Удалено в v2.1.234; см. [Укажите товарищей по команде и модели](/docs/ru/agent-teams#specify-teammates-and-models) для того, как Claude Code выбирает модель товарища по команде | Global config settings | Global config |

810| [`useAutoModeDuringPlan`](#useautomodeduringplan) | Позвольте классификатору [автоматического режима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) проверять команды shell в [режиме плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode); установите `false` для получения подсказок вместо этого | Permission settings | User, local, or managed |818| [`useAutoModeDuringPlan`](#useautomodeduringplan) | Позвольте классификатору [режима авто](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) проверять команды shell в [режиме плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode); установите `false` для получения подсказок вместо этого | Permission settings | User, local, or managed |

811| [`verbose`](#verbose) | Показывайте [полный вывод инструмента](/docs/ru/cli-reference#cli-flags) вместо усечённых резюме; `viewMode` имеет приоритет, когда оба установлены | Interface and terminal | Any file |819| [`verbose`](#verbose) | Показывайте [полный вывод инструмента](/docs/ru/cli-reference#cli-flags) вместо усечённых резюме; `viewMode` имеет приоритет, когда оба установлены | Interface and terminal | Any file |

813| [`vimInsertModeRemaps`](#viminsertmoderemaps) | Сопоставьте двухклавишную [последовательность режима INSERT](/docs/ru/interactive-mode#remap-insert-mode-key-sequences), такую как `jj`, с Escape | Interface and terminal | User or managed |821| [`vimInsertModeRemaps`](#viminsertmoderemaps) | Сопоставьте двухклавишную [последовательность режима INSERT](/docs/ru/interactive-mode#remap-insert-mode-key-sequences), такую как `jj`, с Escape | Interface and terminal | User or managed |

816| [`wheelScrollAccelerationEnabled`](#wheelscrollaccelerationenabled) | Отключите [ускорение прокрутки колеса мыши](/docs/ru/fullscreen#mouse-wheel-scrolling) при полноэкранном отображении | Interface and terminal | Any file |824| [`wheelScrollAccelerationEnabled`](#wheelscrollaccelerationenabled) | Отключите [ускорение прокрутки мышью](/docs/ru/fullscreen#mouse-wheel-scrolling) при полноэкранном отображении | Interface and terminal | Any file |

817| [`workflowKeywordTriggerEnabled`](#workflowkeywordtriggerenabled) | Позвольте слову `ultracode` в подсказке запустить [рабочий процесс](/docs/ru/workflows); установите `false` для ввода без запуска | Hooks and automation | Any file |825| [`workflowKeywordTriggerEnabled`](#workflowkeywordtriggerenabled) | Позвольте слову `ultracode` в подсказке запустить [рабочий процесс](/docs/ru/workflows); установите `false` для ввода без запуска | Hooks and automation | Any file |

827 Модель и ответы835 Модель и ответы

828</h2>836</h2>

829 837

830Выберите, какие модели использует Claude Code и как он отвечает. Информацию о том, как эти параметры взаимодействуют с командой `/model` и переменными окружения, см. в разделе [Конфигурация модели](/docs/ru/model-config).838Выберите, какие модели использует Claude Code и как он отвечает. Чтобы узнать, как эти параметры взаимодействуют с командой `/model` и переменными окружения, см. [Конфигурация модели](/docs/ru/model-config).

831 839

832<h3 id="advisormodel">840<h3 id="advisormodel">

833 `advisorModel`841 `advisorModel`

834</h3>842</h3>

835 843

836Выберите, какая модель отвечает, когда Claude вызывает серверный [инструмент advisor](/docs/ru/advisor). Удалите этот параметр, чтобы отключить advisor. Advisor должен быть по крайней мере столь же способным, как ваша основная модель. См. [Выберите модель advisor](/docs/ru/advisor#choose-an-advisor-model) для принятых пар и того, что происходит, когда вы выбираете ту, которая не принята.844Выберите, какая модель отвечает, когда Claude вызывает серверный [инструмент advisor](/docs/ru/advisor). Оставьте его неустановленным, чтобы отключить advisor. Advisor должен быть по крайней мере столь же способным, как ваша основная модель. См. [Выберите модель advisor](/docs/ru/advisor#choose-an-advisor-model) для принятых пар и того, что происходит, когда вы выбираете неподдерживаемую.

837 845

838Обычно вы не редактируете этот ключ вручную. Запустите `/advisor`, чтобы открыть средство выбора, которое показывает текущий выбор, модели, которые могут давать советы, и **Без advisor**. Claude Code сохраняет ваш выбор в этот ключ в `~/.claude/settings.json`. Если вы выбираете из клиента [Remote Control](/docs/ru/remote-control) или в сеансе, подключённом к удалённому рабочему процессу, выбор применяется только к этому сеансу и не изменяет этот ключ.846Обычно вы не редактируете этот ключ вручную. Запустите `/advisor`, чтобы открыть средство выбора, которое показывает текущий выбор, модели, которые могут давать советы, и **No advisor**. Claude Code сохраняет ваш выбор в этот ключ в `~/.claude/settings.json`. Если вы выбираете из клиента [Remote Control](/docs/ru/remote-control) или в сеансе, подключённом к удалённому рабочему процессу, выбор применяется только к этому сеансу и не изменяет этот ключ.

839 847

840Если ваша учётная запись требует [согласия на использование кредитов](/docs/ru/advisor#fable-advisor-and-usage-credits), сначала примите его, запустив `/model fable`. До этого выбор Fable в `/advisor` ничего не сохраняет, и Claude Code говорит вам запустить `/model fable` сначала.848Если ваша учётная запись требует [согласия на использование кредитов](/docs/ru/advisor#fable-advisor-and-usage-credits), сначала примите его, запустив `/model fable`. До этого выбор Fable в `/advisor` ничего не сохраняет, и Claude Code говорит вам сначала запустить `/model fable`.

841 849

842* **Область действия**: [`Any file`](#scopes)850* **Область действия**: [`Any file`](#scopes)

843* **Тип**: строка, один из псевдонимов `"fable"`, `"opus"` или `"sonnet"`, которые разрешаются в текущую версию Claude Code этого семейства моделей по умолчанию, или полный ID модели, такой как `"claude-opus-5-5"`851* **Тип**: строка, один из псевдонимов `"fable"`, `"opus"` или `"sonnet"`, которые разрешаются в текущую версию Claude Code этого семейства моделей по умолчанию, или полный ID модели, такой как `"claude-opus-5-5"`

850}858}

851```859```

852 860

853Ключ не влияет на поставщиков, где advisor [недоступен](/docs/ru/advisor#requirements), таких как Amazon Bedrock и Claude Platform на AWS. `"fable"` требует [доступа к Fable](/docs/ru/advisor#choose-an-advisor-model).861Ключ не влияет на поставщиков, где advisor [недоступен](/docs/ru/advisor#requirements), такие как Amazon Bedrock и Claude Platform на AWS. `"fable"` требует [доступа к Fable](/docs/ru/advisor#choose-an-advisor-model).

854 862

855<h3 id="alwaysthinkingenabled">863<h3 id="alwaysthinkingenabled">

856 `alwaysThinkingEnabled`864 `alwaysThinkingEnabled`

858 866

859Отключите [расширенное мышление](/docs/ru/model-config#extended-thinking) для каждого сеанса, установив это значение на `false`. Мышление включено по умолчанию, поэтому `true` ничего не меняет. Большинство людей устанавливают это через `/config` вместо редактирования файла.867Отключите [расширенное мышление](/docs/ru/model-config#extended-thinking) для каждого сеанса, установив это значение на `false`. Мышление включено по умолчанию, поэтому `true` ничего не меняет. Большинство людей устанавливают это через `/config` вместо редактирования файла.

860 868

861На моделях, которые всегда думают, таких как Opus 5.5 и модели Fable, `false` не имеет эффекта. На [сторонних поставщиках](/docs/ru/third-party-integrations) Claude Code опускает параметр `thinking` вместо отключения мышления, поэтому модели адаптивного рассуждения могут всё ещё думать. При отключении мышления на Anthropic API Claude Code отправляет усилие `high` вместо более высокого уровня моделям, которые, как известно, [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), таким как Opus 5.869На моделях, которые всегда думают, таких как Opus 5.5, Sonnet 5.5 и модели Fable, `false` не имеет эффекта. На [сторонних поставщиках](/docs/ru/third-party-integrations) Claude Code опускает параметр `thinking` вместо отключения мышления, поэтому адаптивные модели рассуждений могут всё ещё думать. При отключении мышления на Anthropic API Claude Code отправляет effort `high` вместо более высокого уровня моделям, которые, как известно, [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5.

862 870

863* **Область действия**: [`Any file`](#scopes)871* **Область действия**: [`Any file`](#scopes)

864* **Тип**: Boolean872* **Тип**: Boolean

865 * `true`: нет эффекта; мышление уже включено873 * `true`: нет эффекта; мышление уже включено

866 * `false`: Claude Code отключает расширенное мышление для каждого сеанса874 * `false`: Claude Code отключает расширенное мышление для каждого сеанса

867* **По умолчанию**: не установлено, поэтому мышление включено для моделей, которые его поддерживают875* **По умолчанию**: не установлено, поэтому мышление включено для моделей, которые его поддерживают

868* **Переопределения для каждого сеанса**: [`MAX_THINKING_TOKENS`](/docs/ru/env-vars) имеет приоритет над этим ключом для одного сеанса: `0` отключает мышление в соответствии с теми же ограничениями модели и поставщика, что и `false`, а положительное значение включает мышление даже когда этот ключ имеет значение `false`. На моделях адаптивного рассуждения само число игнорируется876* **Переопределения для каждого сеанса**: [`MAX_THINKING_TOKENS`](/docs/ru/env-vars) имеет приоритет над этим ключом для одного сеанса: `0` отключает мышление в соответствии с теми же ограничениями модели и поставщика, что и `false`, а положительное значение включает мышление даже когда этот ключ `false`. На адаптивных моделях рассуждений само число игнорируется

869 877

870```json settings.json theme={null}878```json settings.json theme={null}

871{879{

877 `availableModels`885 `availableModels`

878</h3>886</h3>

879 887

880Ограничьте, какие модели люди могут выбирать для основного сеанса, [подагентов](/docs/ru/sub-agents), [skills](/docs/ru/skills) и [advisor](/docs/ru/advisor). Управляемый список ограничивает `/model`, `--model` и ключ `model` в собственных файлах разработчика; модель вне списка не может быть выбрана. Сам по себе это не влияет на опцию Default; объедините его с [`enforceAvailableModels`](#enforceavailablemodels) для этого.888Ограничьте, какие модели люди могут выбрать для основного сеанса, [подагентов](/docs/ru/sub-agents), [skills](/docs/ru/skills) и [advisor](/docs/ru/advisor). Управляемый список ограничивает `/model`, `--model` и ключ `model` в собственных файлах разработчика; модель вне списка не может быть выбрана. С сопоставлением префиксов по умолчанию это не трогает опцию Default саму по себе; объедините её с [`enforceAvailableModels`](#enforceavailablemodels) для этого.

881 889

882* **Область действия**: [`Any file`](#scopes). Разверните его в управляемых параметрах, чтобы применить его для организации.890* **Область действия**: [`Any file`](#scopes). Разверните его в управляемых параметрах, чтобы применить его для организации.

883* **Тип**: массив псевдонимов моделей или ID891* **Тип**: массив псевдонимов моделей или ID

891}899}

892```900```

893 901

894См. [Ограничьте выбор модели](/docs/ru/model-config#restrict-model-selection).902Запись ID модели, такая как `"claude-opus-5"`, также разрешает более поздние версии, которые её расширяют, такие как Opus 5.5. Чтобы заблокировать одну из этих версий, используйте [`deniedModels`](#deniedmodels). Чтобы каждая запись ID модели разрешала только названную ею версию, используйте [`availableModelsMatch`](#availablemodelsmatch). См. [Ограничить выбор модели](/docs/ru/model-config#restrict-model-selection).

903

904<h3 id="availablemodelsmatch">

905 `availableModelsMatch`

906</h3>

907

908Выберите, как записи [`availableModels`](#availablemodels) соответствуют ID моделей. По умолчанию запись ID модели также разрешает более поздние версии, которые её расширяют, поэтому `"claude-opus-5"` разрешает Opus 5.5. С `"exact"` каждая запись ID модели разрешает только названную ею версию, поэтому более новая версия этой модели остаётся заблокированной, пока вы её не перечислите. Требует Claude Code v2.1.283 или позже.

909

910* **Область действия**: [`Managed`](#scopes). Claude Code игнорирует ключ в пользовательских, проектных и локальных параметрах и в `--settings` с предупреждением

911* **Тип**: строка, один из:

912 * `"prefix"`: запись ID модели разрешает её версию и любой ID модели, который её расширяет другим сегментом

913 * `"exact"`: запись ID модели разрешает только названную ею версию, включая датированные ID этой версии, поэтому `"claude-opus-5"` разрешает Opus 5, но не `claude-opus-5-5`. Псевдоним семейства, такой как `"opus"`, всё ещё разрешает всё семейство, и записи `best`, `opusplan` и `default` игнорируются

914* **По умолчанию**: `"prefix"`

915

916Этот пример разрешает Opus 5 и Sonnet 5 и не позволяет более позднему выпуску любого из них:

917

918```json managed-settings.json theme={null}

919{

920 "availableModels": ["claude-opus-5", "claude-sonnet-5"],

921 "availableModelsMatch": "exact"

922}

923```

924

925С `"exact"` опция Default также ограничена перечисленными моделями, когда список называет по крайней мере одну модель или семейство. См. [Заблокировать определённые модели или версии](/docs/ru/model-config#block-specific-models-or-versions).

926

927<h3 id="deniedmodels">

928 `deniedModels`

929</h3>

930

931Заблокируйте определённые модели, с или без списка разрешений [`availableModels`](#availablemodels) и даже когда этот список их разрешает. Claude Code скрывает заблокированную модель из средства выбора `/model`, и модель не может быть выбрана нигде, где применяется `availableModels`. Сеанс на опции Default также не запускает заблокированную модель, как описано в [Заблокировать определённые модели или версии](/docs/ru/model-config#block-specific-models-or-versions). Требует Claude Code v2.1.283 или позже.

932

933* **Область действия**: [`Managed`](#scopes). Claude Code игнорирует ключ в пользовательских, проектных и локальных параметрах и в `--settings` с предупреждением

934* **Тип**: массив псевдонимов моделей или ID

935 * Псевдоним семейства, такой как `"opus"`, блокирует каждую модель в этом семействе

936 * ID модели, такой как `"claude-opus-5-5"`, блокирует эту версию в каждом написании, включая датированные и специфичные для поставщика ID

937 * ID модели без младшей версии, такой как `"claude-opus-5"`, также блокирует более поздние младшие версии, такие как Opus 5.5. Напишите `"claude-opus-5-0"`, чтобы заблокировать только Opus 5

938 * Записи `best`, `opusplan` и `default` игнорируются

939* **По умолчанию**: не установлено, поэтому ни одна модель не заблокирована

940

941Этот пример разрешает модели Opus и Sonnet и блокирует Opus 5.5:

942

943```json managed-settings.json theme={null}

944{

945 "availableModels": ["opus", "sonnet"],

946 "deniedModels": ["claude-opus-5-5"]

947}

948```

949

950См. [Заблокировать определённые модели или версии](/docs/ru/model-config#block-specific-models-or-versions).

895 951

896<h3 id="effortlevel">952<h3 id="effortlevel">

897 `effortLevel`953 `effortLevel`

898</h3>954</h3>

899 955

900Установите уровень [усилия](/docs/ru/model-config#adjust-effort-level) по умолчанию для моделей, для которых вы не сохранили уровень. Более низкие уровни быстрее и дешевле для простых задач, а более высокие уровни рассуждают глубже для сложных проблем.956Установите уровень [effort](/docs/ru/model-config#adjust-effort-level) по умолчанию для моделей, для которых вы не сохранили уровень. Более низкие уровни быстрее и дешевле на простых задачах, а более высокие уровни рассуждают глубже на сложных проблемах.

901 957

902Когда вы запускаете `/effort low`, `medium`, `high` или `xhigh` в интерактивном сеансе на вашей машине, Claude Code сохраняет уровень для активной модели под [`modelSettings`](#modelsettings) вместо записи этого ключа. До версии 2.1.251 `/effort` записывал этот ключ.958Когда вы запускаете `/effort low`, `medium`, `high` или `xhigh` в интерактивном сеансе на вашей машине, Claude Code сохраняет уровень для активной модели под [`modelSettings`](#modelsettings) вместо записи этого ключа. До v2.1.251 `/effort` записывал этот ключ.

903 959

904В одном файле параметров Claude Code использует сохранённый уровень модели вместо этого ключа. [`modelSettings`](#modelsettings) указывает приоритет между файлами.960В одном файле параметров Claude Code использует сохранённый уровень модели вместо этого ключа. [`modelSettings`](#modelsettings) указывает приоритет между файлами.

905 961

906В сеансе, подключённом к удалённому рабочему процессу, в запуске `-p` и в Agent SDK `/effort` применяется только к этому сеансу. [Отрегулируйте уровень усилия](/docs/ru/model-config#adjust-effort-level) перечисляет интерактивные выборы, которые также применяются только к этому сеансу. Сообщение, которое печатает `/effort`, говорит, что произошло.962В сеансе, подключённом к удалённому рабочему процессу, в запуске `-p` и в Agent SDK `/effort` применяется только к этому сеансу. [Отрегулировать уровень effort](/docs/ru/model-config#adjust-effort-level) перечисляет интерактивные выборы, которые также применяются только к этому сеансу. Сообщение, которое печатает `/effort`, говорит, что произошло.

907 963

908* **Область действия**: [`Any file`](#scopes)964* **Область действия**: [`Any file`](#scopes)

909* **Тип**: строка, один из:965* **Тип**: строка, один из:

910 * `"low"`: минимальное рассуждение для коротких, ограниченных, чувствительных к задержкам задач, которые не требуют интеллекта966 * `"low"`: наименьшее рассуждение для коротких, ограниченных, чувствительных к задержкам задач, которые не требуют высокого интеллекта

911 * `"medium"`: снижает использование токенов для работы, чувствительной к затратам, которая может пожертвовать некоторым интеллектом967 * `"medium"`: снижает использование токенов для работы, чувствительной к затратам, которая может пожертвовать некоторым интеллектом

912 * `"high"`: балансирует использование токенов и интеллект968 * `"high"`: балансирует использование токенов и интеллект

913 * `"xhigh"`: более глубокое рассуждение при более высоких затратах токенов969 * `"xhigh"`: более глубокое рассуждение при более высоких затратах токенов

920}976}

921```977```

922 978

923В вашем файле параметров пользователя, `~/.claude/settings.json`, этот ключ — это более старая форма, которую `/effort` записывал до того, как он сохранял уровни для каждой модели, и он продолжает применяться там, где он применялся раньше, на Opus 5, Fable 5.1 и более ранних моделях. Opus 5.5 и модели, выпущенные после него, игнорируют его и начинают со своего собственного значения по умолчанию, пока вы не сохраните уровень для них, который `/effort` записывает под [`modelSettings`](#modelsettings). В параметрах проекта, локальных и управляемых, а также с `--settings`, этот ключ применяется к каждой модели.979В файле пользовательских параметров `~/.claude/settings.json` этот ключ является более старой формой, которую `/effort` записывал до того, как он сохранял уровни для каждой модели, и он продолжает применяться там, где применялся раньше, на Opus 5, Fable 5.1 и более ранних моделях. Opus 5.5 и модели, выпущенные после него, игнорируют его и начинают со своего собственного значения по умолчанию, пока вы не сохраните уровень для них, который `/effort` записывает под [`modelSettings`](#modelsettings). В проектных, локальных и управляемых параметрах и с `--settings` этот ключ применяется к каждой модели.

924 980

925<h3 id="enforceavailablemodels">981<h3 id="enforceavailablemodels">

926 `enforceAvailableModels`982 `enforceAvailableModels`

927</h3>983</h3>

928 984

929Средство выбора `/model` имеет опцию **Default**, которая разрешается в [модель по умолчанию вашей организации](/docs/ru/model-config#organization-default-model), когда она применяется, и в противном случае в модель по умолчанию вашего типа учётной записи. Список [`availableModels`](#availablemodels) ограничивает модели, которые вы можете назвать, но сам по себе оставляет **Default** в покое, поэтому **Default** всё ещё может разрешиться в модель вне списка. Этот ключ закрывает этот пробел. Требует Claude Code версии 2.1.175 или позже.985Средство выбора `/model` имеет опцию **Default**, и [`default` параметр модели](/docs/ru/model-config#default-model-setting) описывает модель, на которую она разрешается. Список разрешений [`availableModels`](#availablemodels) ограничивает модели, которые вы можете назвать, но с [сопоставлением префиксов](#availablemodelsmatch) по умолчанию он не переопределяет модель по умолчанию вашего типа учётной записи, поэтому **Default** всё ещё может разрешиться в модель вне списка. Этот ключ закрывает этот пробел. Требует Claude Code v2.1.175 или позже.

930 986

931Когда ваша организация развёртывает какие-либо управляемые параметры, Claude Code читает этот ключ только из управляемого источника и игнорирует его в ваших других файлах.987Когда ваша организация развёртывает какие-либо управляемые параметры, Claude Code читает этот ключ только из управляемого источника и игнорирует его в ваших других файлах.

932 988

933* **Область действия**: [`Any file`](#scopes)989* **Область действия**: [`Any file`](#scopes)

934* **Тип**: Boolean990* **Тип**: Boolean

935 * `true`: когда **Default** разрешится в модель вне `availableModels`, Claude Code разрешает её в первую доступную модель в списке991 * `true`: когда **Default** разрешился бы в модель вне `availableModels`, Claude Code разрешает его в первую доступную модель в списке

936 * `false`: **Default** разрешается как обычно, даже в модель вне `availableModels`992 * `false`: этот ключ не меняет, как разрешается **Default**

937* **По умолчанию**: `false`993* **По умолчанию**: `false`

938 994

939Этот пример ограничивает именованные выборы моделями Sonnet и Haiku и делает **Default** разрешённым в первую из них, которая доступна:995Этот пример ограничивает именованные выборы моделями Sonnet и Haiku и делает **Default** разрешаемым в первую из них, которая доступна:

940 996

941```json settings.json theme={null}997```json settings.json theme={null}

942{998{

945}1001}

946```1002```

947 1003

948Этот ключ не имеет эффекта, когда `availableModels` не установлен или пуст. См. [Применить список разрешений для модели Default](/docs/ru/model-config#enforce-the-allowlist-for-the-default-model). Требует Claude Code версии 2.1.175 или позже.1004Этот ключ не имеет эффекта, когда `availableModels` не установлен или пуст. См. [Применить список разрешений для модели Default](/docs/ru/model-config#enforce-the-allowlist-for-the-default-model). Требует Claude Code v2.1.175 или позже.

949 1005

950<h3 id="fallbackmodel">1006<h3 id="fallbackmodel">

951 `fallbackModel`1007 `fallbackModel`

952</h3>1008</h3>

953 1009

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

955 1011

956Переключение означает один ход с холодным [кэшем подсказок](/docs/ru/prompt-caching#switching-models) на резервной модели; ваше следующее сообщение сначала пытается основную модель снова.1012Переключение означает один ход с холодным [кэшем подсказок](/docs/ru/prompt-caching#switching-models) на резервной модели; ваше следующее сообщение сначала снова пытается использовать основную модель.

957 1013

958* **Область действия**: [`Any file`](#scopes)1014* **Область действия**: [`Any file`](#scopes)

959* **Тип**: массив псевдонимов моделей или ID; `"default"` расширяется в модель по умолчанию1015* **Тип**: массив псевдонимов моделей или ID; `"default"` расширяется в модель по умолчанию

974 `fastMode`1030 `fastMode`

975</h3>1031</h3>

976 1032

977Включите [быстрый режим](/docs/ru/fast-mode) для сеансов, где он доступен, для интерактивной работы, такой как быстрая итерация или живая отладка, где вы хотите скорость при более высокой стоимости за токен. Обычно вы не редактируете этот ключ вручную: запуск `/fast` записывает `fastMode: true` в `~/.claude/settings.json`, и запуск его снова, чтобы отключить быстрый режим, удаляет ключ. Быстрый режим работает только на Opus 5.5, Opus 5 и Opus 4.8: включение его с другой модели переключает вас на Opus, а переключение на неподдерживаемую модель отключает его. См. [Переключайте модели, пока быстрый режим включён](/docs/ru/fast-mode#switch-models-while-fast-mode-is-on).1033Включите [быстрый режим](/docs/ru/fast-mode) для сеансов, где он доступен, для интерактивной работы, такой как быстрая итерация или живая отладка, где вы хотите скорость при более высокой стоимости за токен. Обычно вы не редактируете этот ключ вручную: запуск `/fast` записывает `fastMode: true` в `~/.claude/settings.json`, и запуск его снова, чтобы отключить быстрый режим, удаляет ключ. Быстрый режим работает только на Opus 5.5, Opus 5 и Opus 4.8: включение его с другой модели переключает вас на Opus, а переключение на неподдерживаемую модель отключает его. См. [Переключить модели, пока быстрый режим включён](/docs/ru/fast-mode#switch-models-while-fast-mode-is-on).

978 1034

979* **Область действия**: [`Any file`](#scopes)1035* **Область действия**: [`Any file`](#scopes)

980* **Тип**: Boolean1036* **Тип**: Boolean

993 `fastModePerSessionOptIn`1049 `fastModePerSessionOptIn`

994</h3>1050</h3>

995 1051

996Обычно запуск `/fast` сохраняет [`fastMode`](#fastmode) в параметры пользователя человека, поэтому быстрый режим включён в начале каждого последующего сеанса. Установите этот ключ на `true`, чтобы остановить это: сохранённый `fastMode: true` больше не включает быстрый режим в начале сеанса, и каждый человек должен запустить `/fast` в каждом сеансе, в котором они его хотят. Claude Code оставляет ключ `fastMode` в их файле, поэтому отключение этого ключа восстанавливает старое поведение.1052Обычно запуск `/fast` сохраняет [`fastMode`](#fastmode) в пользовательские параметры человека, поэтому быстрый режим включён в начале каждого последующего сеанса. Установите этот ключ на `true`, чтобы остановить это: сохранённый `fastMode: true` больше не включает быстрый режим при запуске сеанса, и каждый человек должен запустить `/fast` в каждом сеансе, в котором он его хочет. Claude Code оставляет ключ `fastMode` в их файле, поэтому отключение этого ключа восстанавливает старое поведение.

997 1053

998Владельцы планов Team или Enterprise могут развернуть его организационно через [параметры, управляемые сервером](/docs/ru/server-managed-settings). Когда управляемые параметры устанавливают ключ, `/fast on` отклоняется вне интерактивных сеансов терминала и сообщает, что ваша организация отключила быстрый режим. Это охватывает [неинтерактивный режим](/docs/ru/headless), [расширение VS Code](/docs/ru/vs-code) и [облачные сеансы](/docs/ru/claude-code-on-the-web).1054Владельцы на планах Team или Enterprise могут развернуть его организационно через [управляемые параметры сервера](/docs/ru/server-managed-settings). Когда управляемые параметры устанавливают ключ, `/fast on` отклоняется вне интерактивных сеансов терминала и сообщает, что ваша организация отключила быстрый режим. Это охватывает [неинтерактивный режим](/docs/ru/headless), [расширение VS Code](/docs/ru/vs-code) и [облачные сеансы](/docs/ru/claude-code-on-the-web).

999 1055

1000* **Область действия**: [`Any file`](#scopes)1056* **Область действия**: [`Any file`](#scopes)

1001* **Тип**: Boolean1057* **Тип**: Boolean

1002 * `true`: сохранённый `fastMode: true` больше не включает быстрый режим в начале сеанса, поэтому каждый человек запускает `/fast` в каждом сеансе, в котором они его хотят; `fastMode: true`, переданный с `--settings`, всё ещё считается для этого сеанса, если только управляемые параметры не устанавливают этот ключ1058 * `true`: сохранённый `fastMode: true` больше не включает быстрый режим при запуске сеанса, поэтому каждый человек запускает `/fast` в каждом сеансе, в котором он его хочет; `fastMode: true`, переданный с `--settings`, всё ещё считается для этого сеанса, если только управляемые параметры не устанавливают этот ключ

1003 * `false`: сохранённый `fastMode: true` включает быстрый режим в начале каждого последующего сеанса1059 * `false`: сохранённый `fastMode: true` включает быстрый режим в начале каждого последующего сеанса

1004* **По умолчанию**: `false`1060* **По умолчанию**: `false`

1005 1061

1015 `language`1071 `language`

1016</h3>1072</h3>

1017 1073

1018Попросите Claude отвечать на языке, отличном от английского, по умолчанию. Нет фиксированного списка для ответов: Claude Code добавляет значение дословно в системную подсказку как инструкцию всегда отвечать на этом языке, поэтому любое имя языка, которое Claude может прочитать, работает. Claude Code не проверяет значение, поэтому неправильно написанное имя достигает Claude в том виде, в котором оно написано, а не производит ошибку. То же значение устанавливает язык для [голосовой диктовки](/docs/ru/voice-dictation#change-the-dictation-language), которая имеет фиксированный список [поддерживаемых языков диктовки](/docs/ru/voice-dictation#change-the-dictation-language), и для автоматически созданных названий сеансов.1074Попросите Claude отвечать на языке, отличном от английского, по умолчанию. Нет фиксированного списка для ответов: Claude Code передаёт значение дословно Claude как инструкцию всегда отвечать на этом языке, поэтому любое имя языка, которое Claude может прочитать, работает. Claude Code не проверяет значение, поэтому неправильно написанное имя достигает Claude в написанном виде, а не производит ошибку. То же значение устанавливает язык для [голосовой диктовки](/docs/ru/voice-dictation#change-the-dictation-language), которая имеет фиксированный список [поддерживаемых языков диктовки](/docs/ru/voice-dictation#change-the-dictation-language), и для автоматически генерируемых названий сеансов.

1019 1075

1020* **Область действия**: [`Any file`](#scopes)1076* **Область действия**: [`Any file`](#scopes)

1021* **Тип**: строка, любое имя языка, такое как `"japanese"`, `"spanish"` или `"french"`; Claude Code не проверяет его1077* **Тип**: строка, любое имя языка, такое как `"japanese"`, `"spanish"` или `"french"`; Claude Code не проверяет его

1031 `maxEffortLevel`1087 `maxEffortLevel`

1032</h3>1088</h3>

1033 1089

1034Ограничьте [уровень усилия](/docs/ru/model-config#adjust-effort-level), который может использовать сеанс, оставляя доступными более низкие уровни. Любой более высокий уровень вместо этого работает на пределе, включая один из `/effort`, средства выбора `/model`, `--effort`, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars), фронтматтера `effort` skill или subagent, или собственного значения по умолчанию модели. Claude Code применяет предел сам перед каждым запросом, поэтому он действует на каждом поставщике, включая Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Требует Claude Code версии 2.1.267 или позже.1090Ограничьте уровень [effort](/docs/ru/model-config#adjust-effort-level), который может использовать сеанс, оставляя доступными более низкие уровни. Любой более высокий уровень вместо этого работает на уровне ограничения, включая один из `/effort`, средства выбора `/model`, `--effort`, [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars), frontmatter `effort` skill или subagent, или собственное значение по умолчанию модели. Claude Code применяет ограничение сам перед каждым запросом, поэтому оно действует на каждом поставщике, включая Amazon Bedrock, Agent Platform Google Cloud и Microsoft Foundry. Требует Claude Code v2.1.267 или позже.

1035 1091

1036* **Область действия**: [`Any file`](#scopes). Разверните его в управляемых параметрах, чтобы применить его для организации. Когда несколько областей устанавливают предел, применяется самый низкий, поэтому предел, установленный в одной области, не может быть повышен из другой1092* **Область действия**: [`Any file`](#scopes). Разверните его в управляемых параметрах, чтобы применить его для организации. Когда несколько областей устанавливают ограничение, применяется самое низкое, поэтому ограничение, установленное в одной области, не может быть повышено из другой

1037* **Тип**: строка, один из `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Значение `"max"` не устанавливает предел1093* **Тип**: строка, один из `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Значение `"max"` не устанавливает ограничение

1038* **По умолчанию**: не установлено, поэтому предел не применяется1094* **По умолчанию**: не установлено, поэтому ограничение не применяется

1039* **Эффект на ultracode**: предел ниже `xhigh` делает [ultracode](#ultracode) недоступным на моделях, к которым применяется предел1095* **Ограничения для каждой модели**: добавьте `maxEffortLevel` в запись [`modelSettings`](#modelsettings) модели. Эта запись заменяет этот ключ только для модели в источнике параметров, который устанавливает оба, такие как ваши пользовательские параметры или один [управляемый источник](/docs/ru/managed-settings#how-claude-code-combines-managed-sources). Установите `"max"` там, чтобы освободить модель от ограничения этого источника; Claude Code всё ещё применяет ограничения из других источников

1040* **Пределы для каждой модели**: добавьте `maxEffortLevel` в запись [`modelSettings`](#modelsettings) модели. Эта запись заменяет этот ключ только для модели в источнике параметров, который устанавливает оба, такой как ваши параметры пользователя или один [управляемый источник](/docs/ru/managed-settings#how-claude-code-combines-managed-sources). Установите `"max"` там, чтобы освободить модель от предела этого источника; Claude Code всё ещё применяет пределы из других источников

1041 1096

1042Этот пример ограничивает каждую модель на `medium` и освобождает Sonnet 4.6:1097Этот пример ограничивает каждую модель на `medium` и освобождает Sonnet 4.6:

1043 1098

1052}1107}

1053```1108```

1054 1109

1055Когда ваша организация также устанавливает [ограничение усилия](/docs/ru/model-config#organization-effort-limits) для модели, применяется более низкий из двух пределов.1110Когда ваша организация также устанавливает [лимит effort](/docs/ru/model-config#organization-effort-limits) для модели, применяется более низкое из двух ограничений.

1056 1111

1057<h3 id="model">1112<h3 id="model">

1058 `model`1113 `model`

1059</h3>1114</h3>

1060 1115

1061Установите модель, которую использует каждый новый сеанс, чтобы вам не пришлось выбирать её с помощью `/model` каждый раз. Установка её здесь не помешает вам переключаться в середине сеанса. Если ваш администратор установил [модель по умолчанию организации](/docs/ru/model-config#organization-default-model) для переопределения выбора пользователя, вы получаете эту модель даже когда вы устанавливаете этот ключ в параметры пользователя, проекта или локальные.1116Установите модель, которую каждый новый сеанс использует, чтобы вам не пришлось выбирать её с помощью `/model` каждый раз. Установка её здесь не мешает вам переключаться в середине сеанса. Если ваш администратор установил [организационную модель по умолчанию](/docs/ru/model-config#organization-default-model) для переопределения выбора пользователя, вы получаете эту модель даже когда устанавливаете этот ключ в пользовательских, проектных или локальных параметрах.

1062 1117

1063* **Область действия**: [`Any file`](#scopes)1118* **Область действия**: [`Any file`](#scopes)

1064* **Тип**: строка, псевдоним модели или полный ID модели1119* **Тип**: строка, псевдоним модели или полный ID модели

1071}1126}

1072```1127```

1073 1128

1074Значение здесь превосходит [`ANTHROPIC_DEFAULT_MODEL`](/docs/ru/model-config#set-a-default-model-for-new-sessions), которое Claude Code использует только когда ничто другое не выбирает модель.1129Значение здесь превосходит [`ANTHROPIC_DEFAULT_MODEL`](/docs/ru/model-config#set-a-default-model-for-new-sessions), который Claude Code использует только когда ничто другое не выбирает модель.

1075 1130

1076<h3 id="modeloverrides">1131<h3 id="modeloverrides">

1077 `modelOverrides`1132 `modelOverrides`

1078</h3>1133</h3>

1079 1134

1080Сопоставьте ID моделей Anthropic с ID моделей, специфичными для поставщика, такими как ARN профилей вывода Amazon Bedrock. Каждая запись средства выбора модели затем использует своё сопоставленное значение при вызове API поставщика. Администраторы используют это на [Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry](/docs/ru/model-config#override-model-ids-per-version) для маршрутизации каждой версии модели к определённому профилю вывода, имени версии или развёртыванию для управления, распределения затрат или региональной маршрутизации.1135Сопоставьте ID моделей Anthropic с ID моделей, специфичными для поставщика, такими как ARN профилей вывода Amazon Bedrock. Каждая запись средства выбора модели затем использует своё сопоставленное значение при вызове API поставщика. Администраторы используют это на [Amazon Bedrock, Agent Platform Google Cloud и Microsoft Foundry](/docs/ru/model-config#override-model-ids-per-version) для маршрутизации каждой версии модели на определённый профиль вывода, имя версии или развёртывание для управления, распределения затрат или региональной маршрутизации.

1081 1136

1082* **Область действия**: [`Any file`](#scopes)1137* **Область действия**: [`Any file`](#scopes)

1083* **Тип**: объект, сопоставляющий ID модели с ID модели поставщика1138* **Тип**: объект, сопоставляющий ID модели с ID модели поставщика

1084* **По умолчанию**: не установлено1139* **По умолчанию**: не установлено

1085 1140

1086Этот пример маршрутизирует каждый вызов для Opus 4.6 к названному профилю вывода Bedrock:1141Этот пример маршрутизирует каждый вызов для Opus 4.6 на названный профиль вывода Bedrock:

1087 1142

1088```json settings.json theme={null}1143```json settings.json theme={null}

1089{1144{

1093}1148}

1094```1149```

1095 1150

1096См. [Переопределите ID моделей для каждой версии](/docs/ru/model-config#override-model-ids-per-version).1151См. [Переопределить ID моделей для каждой версии](/docs/ru/model-config#override-model-ids-per-version).

1097 1152

1098<h3 id="modelpicker">1153<h3 id="modelpicker">

1099 `modelPicker`1154 `modelPicker`

1100</h3>1155</h3>

1101 1156

1102Перечислите модели, которые предлагает средство выбора `/model`, в порядке, в котором вы их пишете, и под метками, которые вы выбираете, чтобы средство выбора перечисляло модели, которые использует ваша организация, после встроенного набора или вместо него. `model` каждой строки берётся дословно, поэтому он принимает всё, что принимает `--model`: псевдоним, такой как `opus`, ID модели Anthropic или ID в формате поставщика для Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или шлюза LLM. Требует Claude Code версии 2.1.242 или позже.1157Перечислите модели, которые предлагает средство выбора `/model`, в порядке, в котором вы их пишете, и под выбранными вами метками, чтобы средство выбора перечисляло модели, которые использует ваша организация, после встроенного набора или вместо него. `model` каждой строки берётся дословно, поэтому он принимает всё, что принимает `--model`: псевдоним, такой как `opus`, ID модели Anthropic или ID формата поставщика для Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry или шлюза LLM. Требует Claude Code v2.1.242 или позже.

1103 1158

1104* **Область действия**: [`User or managed`](#scopes). Claude Code читает ключ из управляемых параметров, `--settings` и параметров пользователя, и игнорирует его в параметрах проекта и локальных, поэтому репозиторий, который вы клонируете, не может переименовать средство выбора. Самый высокий из этих трёх, который устанавливает ключ, поставляет весь набор, и Claude Code никогда не объединяет наборы из двух источников.1159* **Область действия**: [`User or managed`](#scopes). Claude Code читает ключ из управляемых параметров, `--settings` и пользовательских параметров и игнорирует его в проектных и локальных параметрах, поэтому репозиторий, который вы клонируете, не может переименовать средство выбора. Самый высокий из этих трёх, который устанавливает ключ, поставляет весь набор, и Claude Code никогда не объединяет наборы из двух источников.

1105* **Тип**: объект с массивом `options` строк и необязательным Boolean `replaceBuiltInOptions`1160* **Тип**: объект с массивом `options` строк и необязательным Boolean `replaceBuiltInOptions`

1106* **По умолчанию**: не установлено, поэтому средство выбора показывает встроенный набор1161* **По умолчанию**: не установлено, поэтому средство выбора показывает встроенный набор

1107 1162

1108Этот пример добавляет два развёртывания Bedrock после встроенного набора под именами, которые ваша команда узнаёт:1163Этот пример добавляет два развёртывания Bedrock после встроенного набора, под именами, которые ваша команда узнаёт:

1109 1164

1110```json managed-settings.json theme={null}1165```json managed-settings.json theme={null}

1111{1166{

1134 1189

1135| Поле | Тип | Что оно делает |1190| Поле | Тип | Что оно делает |

1136| :- | :- | :- |1191| :- | :- | :- |

1137| `options` | массив строк, каждая с обязательным `model` и необязательными `label` и `description` | Строки, которые показывает средство выбора, в этом порядке, за исключением того, что затемнённая строка перемещается в конец. Без `label` Claude Code озаглавливает строку встроенным именем для модели, которую он знает, или ID модели в противном случае, и без `description` он пишет общую вторую строку |1192| `options` | массив строк, каждая с обязательным `model` и необязательными `label`, `description` и `behavesAs` | Строки, которые показывает средство выбора, в этом порядке, за исключением того, что затемнённая строка перемещается в конец. Без `label` Claude Code озаглавливает строку встроенным именем для модели, которую он знает, или ID модели в противном случае, и без `description` он пишет общую вторую строку |

1138| `replaceBuiltInOptions` | Boolean, по умолчанию `false` | Установите на `true`, чтобы показать только эти строки, **Default** и строку для модели, которую сеанс уже использует. Оставьте не установленным, чтобы добавить эти строки после встроенного набора |1193| `replaceBuiltInOptions` | Boolean, по умолчанию `false` | Установите на `true`, чтобы показать только эти строки, **Default** и строку для модели, которую сеанс уже использует. Оставьте неустановленным, чтобы добавить эти строки после встроенного набора |

1194

1195Запись в `options` также может нести необязательную строку `behavesAs` рядом с её `model`, что требует v2.1.257 или позже. Установите её на ID модели, которую ваша версия Claude Code уже знает, такой как `claude-opus-4-8`, на запись, чей `model` новее, чем ваша версия. Claude Code затем применяет возможности этой известной модели и значения по умолчанию effort к записи вместо обработки её модели как неизвестной. Метка записи и ID модели, которые Claude Code отправляет в запросах, не меняются.

1139 1196

1140С включённым `replaceBuiltInOptions` Claude Code скрывает каждую другую строку: встроенный набор, строки, которые он добавляет для записей [`availableModels`](#availablemodels), модели, которые нашла [обнаружение шлюза](/docs/ru/llm-gateway-protocol#model-discovery), и [`ANTHROPIC_CUSTOM_MODEL_OPTION`](/docs/ru/model-config#add-a-custom-model-option). С ним выключенным Claude Code пропускает перечисленную модель, которую встроенный набор уже охватывает. Метка изменяет то, что показывает средство выбора, а не то, какую модель запускает Claude Code.1197С `replaceBuiltInOptions` включённым Claude Code скрывает каждую другую строку: встроенный набор, строки, которые он добавляет для записей [`availableModels`](#availablemodels), модели, которые нашла [обнаружение шлюза](/docs/ru/llm-gateway-protocol#model-discovery), и [`ANTHROPIC_CUSTOM_MODEL_OPTION`](/docs/ru/model-config#add-a-custom-model-option). С ним выключённым Claude Code пропускает перечисленную модель, которую встроенный набор уже охватывает. Метка меняет то, что показывает средство выбора, а не какую модель запускает Claude Code.

1141 1198

1142Список [`availableModels`](#availablemodels) всё ещё применяется к этим строкам. Прежде чем добавить перечисленную модель в список разрешений, прочитайте [Поведение объединения](/docs/ru/model-config#merge-behavior): конкретный ID модели сужает запись подстановочного знака своего семейства. Claude Code также проверяет каждую строку против сеанса перед тем, как показать средство выбора:1199Список разрешений [`availableModels`](#availablemodels) всё ещё применяется к этим строкам. Прежде чем добавить перечисленную модель в список разрешений, прочитайте [Поведение объединения](/docs/ru/model-config#merge-behavior): определённый ID модели сужает запись подстановочного знака своего семейства. Claude Code также проверяет каждую строку против сеанса перед тем, как показать средство выбора:

1143 1200

1144* **Удалено**: строка, которую Claude Code не может обслуживать, такая как снятая с производства модель или модель, к которой ваша организация не имеет доступа1201* **Удалено**: строка, которую Claude Code не может обслуживать, такая как снятая с производства модель или модель, к которой ваша организация не имеет доступа

1145* **Затемнено**: строка, которую вы не можете выбрать ещё, показанная с причиной1202* **Затемнено**: строка, которую вы не можете выбрать ещё, показанная с причиной

1146* **Ни одна строка не выживает**: Claude Code сохраняет встроенный набор, отфильтрованный списком разрешений как обычно1203* **Ни одна строка не выживает**: Claude Code сохраняет встроенный набор, отфильтрованный списком разрешений как обычно

1147 1204

1148Claude Code удаляет строку, которую он не может разобрать, и сохраняет остальные. См. [Исправьте сломанный файл параметров](/docs/ru/settings#fix-a-broken-settings-file).1205Claude Code удаляет строку, которую он не может разобрать, и сохраняет остальные. См. [Исправить сломанный файл параметров](/docs/ru/settings#fix-a-broken-settings-file).

1149 1206

1150<h3 id="modelpricing">1207<h3 id="modelpricing">

1151 `modelPricing`1208 `modelPricing`

1152</h3>1209</h3>

1153 1210

1154Сообщайте о расходах по ставкам, которые платит ваша организация, вместо цены списка. Установите это, когда ваша организация имеет согласованные ставки, поэтому цифры в долларах, которые видят разработчики, соответствуют вашему счёту. Claude Code применяет ставки в `/usage`, [строке состояния](/docs/ru/statusline), `total_cost_usd` Agent SDK, пределе [`--max-budget-usd`](/docs/ru/cli-reference) и [OpenTelemetry](/docs/ru/monitoring-usage) метрике затрат и событиях. Вы поставляете ставки: Claude Code не читает их из вашего контракта или Claude Console. Требует Claude Code версии 2.1.242 или позже.1211Сообщайте о расходах по ставкам, которые платит ваша организация, вместо цены списка. Установите это, когда ваша организация имеет согласованные ставки, поэтому цифры в долларах, которые видят разработчики, соответствуют вашему счёту. Claude Code применяет ставки в `/usage`, [строке состояния](/docs/ru/statusline), `total_cost_usd` Agent SDK, лимите [`--max-budget-usd`](/docs/ru/cli-reference) и [OpenTelemetry](/docs/ru/monitoring-usage) метрике затрат и событиях. Вы поставляете ставки: Claude Code не читает их из вашего контракта или Claude Console. Требует Claude Code v2.1.242 или позже.

1155 1212

1156* **Область действия**: [`Managed`](#scopes). Разверните ключ через параметры, управляемые сервером, политику MDM, файл `managed-settings.json` или [помощник политики](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program). Claude Code игнорирует его в параметрах пользователя, проекта и локальных, в `--settings` и на Windows в пользовательском реестре [HKCU](/docs/ru/managed-settings#where-each-mechanism-stores-the-policy). С параметрами, управляемыми сервером, каждый сеанс сообщает затраты по цене списка до тех пор, пока [выборка параметров](/docs/ru/server-managed-settings#fetch-and-caching-behavior) этого сеанса не подтвердит параметр. Приложение-хост, которое встраивает Claude Code и устанавливает [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), может поставить таблицу своего собственного через опцию SDK [`managedSettings`](/docs/ru/agent-sdk/typescript#options), которую Claude Code использует только когда ни один управляемый источник не устанавливает ключ и только в Claude Code версии 2.1.246 или позже.1213* **Область действия**: [`Managed`](#scopes). Разверните ключ через управляемые параметры сервера, политику MDM, файл `managed-settings.json` или [помощник политики](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program). Claude Code игнорирует его в пользовательских, проектных и локальных параметрах, в `--settings` и на Windows в пользовательском реестре [HKCU](/docs/ru/managed-settings#where-each-mechanism-stores-the-policy). С управляемыми параметрами сервера каждый сеанс сообщает затраты по цене списка, пока [выборка параметров](/docs/ru/server-managed-settings#fetch-and-caching-behavior) этого сеанса не подтвердит параметр. Приложение-хост, которое встраивает Claude Code и устанавливает [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), может поставить таблицу своего собственного через опцию SDK [`managedSettings`](/docs/ru/agent-sdk/typescript#options), которую Claude Code использует только когда ни один управляемый источник не устанавливает ключ и только в Claude Code v2.1.246 или позже.

1157* **Тип**: объект с необязательным `multiplier` и необязательной картой `overrides`1214* **Тип**: объект с необязательным `multiplier` и необязательной картой `overrides`

1158* **По умолчанию**: не установлено, поэтому Claude Code сообщает цену списка, если приложение-хост не поставляет таблицу1215* **По умолчанию**: не установлено, поэтому Claude Code сообщает цену списка, если приложение-хост не поставляет таблицу

1159 1216

1177}1234}

1178```1235```

1179 1236

1180Установите `multiplier` выше 1, до 10, чтобы отметить каждую цифру. Надбавка требует Claude Code версии 2.1.271 или позже. Более ранние версии игнорируют `multiplier` выше 1 с предупреждением и сохраняют остальную часть параметра.1237Установите `multiplier` выше 1, до 10, чтобы отметить каждую цифру. Надбавка требует Claude Code v2.1.271 или позже. Более ранние версии игнорируют `multiplier` выше 1 с предупреждением и сохраняют остальную часть параметра.

1181 1238

1182Для шагов, включая как подтвердить, что ставки действуют, см. [Сообщайте о расходах по вашим согласованным ставкам](/docs/ru/costs#report-spend-at-your-contracted-rates).1239Для шагов, включая как подтвердить, что ставки действуют, см. [Сообщить о расходах по вашим согласованным ставкам](/docs/ru/costs#report-spend-at-your-contracted-rates).

1183 1240

1184<span id="modelpricing-multiplier" />1241<span id="modelpricing-multiplier" />

1185 1242

1192| Поле | Тип | Что оно делает |1249| Поле | Тип | Что оно делает |

1193| :- | :- | :- |1250| :- | :- | :- |

1194| `multiplier` | число больше 0 и не более 10 | Масштабирует каждую стоимость, которую вычисляет Claude Code, независимо от того, охватывает ли её строка `overrides`. Ниже 1 — скидка, выше 1 — надбавка |1251| `multiplier` | число больше 0 и не более 10 | Масштабирует каждую стоимость, которую вычисляет Claude Code, независимо от того, охватывает ли её строка `overrides`. Ниже 1 — скидка, выше 1 — надбавка |

1195| `overrides` | карта ID модели к объекту ставки с `input`, `output`, `cacheRead` и `cacheWrite`, каждый от 0 до 10000 | Ставки USD за миллион токенов для этой модели, все четыре обязательны. `cacheWrite` охватывает как пятиминутные, так и одночасовые записи кэша. См. [Какие модели применяет строка modelPricing](#which-models-a-modelpricing-row-applies-to) |1252| `overrides` | карта ID модели на объект ставки с `input`, `output`, `cacheRead` и `cacheWrite`, каждый от 0 до 10000 | Ставки USD за миллион токенов для этой модели, все четыре обязательны. `cacheWrite` охватывает как пятиминутные, так и одночасовые записи кэша. См. [Какие модели применяет строка modelPricing](#which-models-a-modelpricing-row-applies-to) |

1196 1253

1197Claude Code использует ставки строки ровно так, как вы их написали, без добавления надбавки быстрого режима или [ставки только для США](https://platform.claude.com/docs/en/about-claude/pricing). Если вы также установите `multiplier`, Claude Code применяет его поверх ставок строки. Claude Code удаляет строку со ставкой, которую он не может разобрать, или `multiplier`, который он не может разобрать, и сохраняет остальные; см. [Исправьте сломанный файл параметров](/docs/ru/settings#fix-a-broken-settings-file).1254Claude Code использует ставки строки ровно так, как вы их написали, без добавления надбавки быстрого режима или [ставки только для США](https://platform.claude.com/docs/en/about-claude/pricing). Если вы также установите `multiplier`, Claude Code применяет его поверх ставок строки. Claude Code удаляет строку со ставкой, которую он не может разобрать, или `multiplier`, который он не может разобрать, и сохраняет остальные; см. [Исправить сломанный файл параметров](/docs/ru/settings#fix-a-broken-settings-file).

1198 1255

1199<h4 id="which-models-a-modelpricing-row-applies-to">1256<h4 id="which-models-a-modelpricing-row-applies-to">

1200 Какие модели применяет строка `modelPricing`1257 Какие модели применяет строка `modelPricing`

1202 1259

1203Claude Code решает, какие модели применяет строка, из ключа строки:1260Claude Code решает, какие модели применяет строка, из ключа строки:

1204 1261

1205* **ID встроенной модели**: ключ, который Claude Code сам использует для встроенной модели, независимо от того, является ли этот ключ собственным ID модели, таким как `claude-sonnet-4-6`, или её ID Bedrock, Agent Platform или Foundry. Claude Code применяет строку к каждому ID снимка с датой и ID, специфичному для поставщика.1262* **ID встроенной модели**: ключ, который сам Claude Code использует для встроенной модели, независимо от того, является ли этот ключ собственным ID модели, таким как `claude-sonnet-4-6`, или её ID Bedrock, Agent Platform или Foundry. Claude Code применяет строку к каждому датированному ID снимка и ID, специфичному для поставщика, этой модели.

1206* **Любой другой ключ**: ключ, который не является ID встроенной модели, такой как псевдоним модели шлюза. Claude Code применяет строку только к этому одному ID. Когда ID модели точно совпадает с одним из ваших ключей и также попадает под строку, ключ которой является ID встроенной модели, Claude Code использует точное совпадение.1263* **Любой другой ключ**: ключ, который не является ID встроенной модели, такой как псевдоним модели шлюза. Claude Code применяет строку только к этому одному ID. Когда ID модели точно совпадает с одним из ваших ключей и также попадает под строку, ключ которой является ID встроенной модели, Claude Code использует точное совпадение.

1207* **Профиль вывода приложения Bedrock**: после того как Claude Code разрешил профиль в модель, к которой он маршрутизирует, через вашу карту [`modelOverrides`](#modeloverrides) или поиск [`bedrock:GetInferenceProfile`](/docs/ru/amazon-bedrock#iam-configuration), Claude Code применяет строку этой модели к профилю.1264* **Профиль вывода приложения Bedrock**: как только Claude Code разрешил профиль в модель, на которую он маршрутизирует, через вашу карту [`modelOverrides`](#modeloverrides) или поиск [`bedrock:GetInferenceProfile`](/docs/ru/amazon-bedrock#iam-configuration), Claude Code применяет строку этой модели к профилю.

1208 1265

1209<h3 id="modelsettings">1266<h3 id="modelsettings">

1210 `modelSettings`1267 `modelSettings`

1211</h3>1268</h3>

1212 1269

1213Сохраните [уровень усилия](/docs/ru/model-config#adjust-effort-level) для каждой модели, которую вы используете. Требует Claude Code версии 2.1.251 или позже.1270Сохраните уровень [effort](/docs/ru/model-config#adjust-effort-level) для каждой модели, которую вы используете. Требует Claude Code v2.1.251 или позже.

1214 1271

1215В интерактивном сеансе на вашей машине, когда вы сохраняете `low`, `medium`, `high` или `xhigh` как свой уровень по умолчанию с помощью `/effort` или ползунка усилия средства выбора `/model`, Claude Code записывает этот уровень здесь под моделью, которую вы используете, поэтому вы редко редактируете этот ключ самостоятельно. Когда вы выбираете один из этих уровней в [средстве выбора модели расширения VS Code](/docs/ru/vs-code#use-the-prompt-box), Claude Code сохраняет его здесь таким же образом. Запись [`effortLevel`](#effortlevel) перечисляет сеансы, где `/effort` применяется только к этому сеансу.1272В интерактивном сеансе на вашей машине, когда вы сохраняете `low`, `medium`, `high` или `xhigh` как свой стандарт с помощью `/effort` или ползунка effort средства выбора `/model`, Claude Code записывает этот уровень здесь под моделью, которую вы используете, поэтому вы редко редактируете этот ключ сами. Когда вы выбираете один из этих уровней в [средстве выбора модели расширения VS Code](/docs/ru/vs-code#use-the-prompt-box), Claude Code сохраняет его здесь так же. Запись [`effortLevel`](#effortlevel) перечисляет сеансы, где `/effort` применяется только к этому сеансу.

1216 1273

1217Отредактируйте ключ вручную, чтобы изменить или удалить уровень, который вы сохранили.1274Отредактируйте ключ вручную, чтобы изменить или удалить уровень, который вы сохранили.

1218 1275

1219`effortLevel` модели здесь имеет приоритет над верхним уровнем [`effortLevel`](#effortlevel) в том же файле параметров. Между файлами Claude Code разрешает каждую модель отдельно: файл [параметров](/docs/ru/settings#settings-precedence) с наивысшим приоритетом, который устанавливает либо `effortLevel` для этой модели, либо верхний уровень `effortLevel`, который [применяется к этой модели](#effortlevel), решает, поэтому `effortLevel` в управляемых параметрах превосходит уровень, который вы сохранили в параметрах пользователя. [Отрегулируйте уровень усилия](/docs/ru/model-config#adjust-effort-level) перечисляет, что ещё может переопределить сохранённый уровень, такой как `--effort` при запуске.1276`effortLevel` модели здесь имеет приоритет над верхним уровнем [`effortLevel`](#effortlevel) в том же файле параметров. Между файлами Claude Code разрешает каждую модель отдельно: файл параметров с наивысшим приоритетом, который устанавливает либо `effortLevel` для этой модели, либо верхний уровень `effortLevel`, который [применяется к этой модели](#effortlevel), решает, поэтому `effortLevel` в управляемых параметрах превосходит уровень, который вы сохранили в пользовательских параметрах. [Отрегулировать уровень effort](/docs/ru/model-config#adjust-effort-level) перечисляет, что ещё может переопределить сохранённый уровень, такой как `--effort` при запуске.

1220 1277

1221Чтобы ограничить усилие одной модели вместо установки её уровня, добавьте поле [`maxEffortLevel`](#maxeffortlevel) в запись этой модели. Поле требует Claude Code версии 2.1.267 или позже.1278Чтобы ограничить effort одной модели вместо установки её уровня, добавьте поле [`maxEffortLevel`](#maxeffortlevel) в запись [`modelSettings`](#modelsettings) этой модели. Поле требует Claude Code v2.1.267 или позже.

1222 1279

1223* **Область действия**: [`Any file`](#scopes)1280* **Область действия**: [`Any file`](#scopes)

1224* **Тип**: объект, сопоставляющий имя модели с объектом с полем `effortLevel`, один из `"low"`, `"medium"`, `"high"` или `"xhigh"`, полем [`maxEffortLevel`](#maxeffortlevel) или обоими1281* **Тип**: объект, сопоставляющий имя модели с объектом с полем `effortLevel`, один из `"low"`, `"medium"`, `"high"` или `"xhigh"`, полем [`maxEffortLevel`](#maxeffortlevel) или обоими

1225* **По умолчанию**: не установлено1282* **По умолчанию**: не установлено

1226 1283

1227Claude Code записывает каждую запись под каноническим именем модели, таким как `claude-opus-5-5`, и сопоставляет псевдоним этой модели, с датой, `[1m]` и признанные ID, специфичные для поставщика, с той же записью.1284Claude Code записывает каждую запись под каноническим именем модели, таким как `claude-opus-5-5`, и сопоставляет псевдоним этой модели, датированный, `[1m]` и признанные ID, специфичные для поставщика, с той же записью.

1228 1285

1229Этот пример сохраняет Opus 5.5 на `high`, пока другие модели используют свои собственные сохранённые или уровни по умолчанию:1286Этот пример сохраняет Opus 5.5 на `high`, пока другие модели используют свои собственные сохранённые или стандартные уровни:

1230 1287

1231```json settings.json theme={null}1288```json settings.json theme={null}

1232{1289{

1244 `outputStyle`1301 `outputStyle`

1245</h3>1302</h3>

1246 1303

1247Выберите [стиль вывода](/docs/ru/output-styles) по имени. Стиль вывода — это сохранённый набор инструкций, который изменяет роль Claude, тон и формат вывода, такой как встроенные стили Explanatory и Learning или один, который вы написали сами.1304Выберите [стиль вывода](/docs/ru/output-styles) по имени. Стиль вывода — это сохранённый набор инструкций, который меняет роль Claude, тон и формат вывода, такой как встроенные стили Explanatory и Learning или один, который вы написали сами.

1248 1305

1249Если вы измените этот ключ во время сеанса, Claude использует новый стиль, начиная со следующего сообщения. Для того, что это сообщение стоит в кэшировании подсказок, см. [Изменение стиля вывода](/docs/ru/prompt-caching#changing-output-style). До версии 2.1.251 редактирование применялось только после запуска `/clear` или начала нового сеанса.1306Если вы измените этот ключ во время сеанса, Claude использует новый стиль, начиная со следующего сообщения. Для того, что это сообщение стоит в кэшировании подсказок, см. [Изменение стиля вывода](/docs/ru/prompt-caching#changing-output-style). До v2.1.251 редактирование применялось только после запуска `/clear` или запуска нового сеанса.

1250 1307

1251* **Область действия**: [`Any file`](#scopes)1308* **Область действия**: [`Any file`](#scopes)

1252* **Тип**: строка, имя [встроенного](/docs/ru/output-styles#built-in-output-styles) или [пользовательского](/docs/ru/output-styles#create-a-custom-output-style) стиля вывода1309* **Тип**: строка, имя [встроенного](/docs/ru/output-styles#built-in-output-styles) или [пользовательского](/docs/ru/output-styles#create-a-custom-output-style) стиля вывода

1264 `promptCacheTtl`1321 `promptCacheTtl`

1265</h3>1322</h3>

1266 1323

1267Выберите, как долго [кэш подсказок](/docs/ru/prompt-caching) держит основной разговор. Этот ключ применяется к вашим интерактивным, `-p` и Agent SDK ходам, вместе с помощниками, которые Claude Code запускает встроенными с ними. Одночасовой срок жизни сохраняет кэш в тепле на более длительные перерывы, и API [выставляет счёт за каждую запись кэша по более высокой ставке](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing), чем при пятиминутном сроке жизни. Требует Claude Code версии 2.1.242 или позже.1324Выберите, как долго [кэш подсказок](/docs/ru/prompt-caching) держит основной разговор. Этот ключ применяется к вашим интерактивным, `-p` и Agent SDK ходам, вместе с помощниками, которые Claude Code запускает встроенно с ними. Одночасовой срок жизни сохраняет кэш в тепле на более длительные перерывы, и API [выставляет счёт за каждую запись кэша по более высокой ставке](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing), чем при пятиминутном сроке жизни. Требует Claude Code v2.1.242 или позже.

1268 1325

1269* **Область действия**: [`Any file`](#scopes)1326* **Область действия**: [`Any file`](#scopes)

1270* **Тип**: строка, один из:1327* **Тип**: строка, один из:

1271 * `"5m"`: кэш держится пять минут1328 * `"5m"`: кэш держится пять минут

1272 * `"1h"`: кэш держится час1329 * `"1h"`: кэш держится час

1273* **По умолчанию**: не установлено, поэтому каждый запрос основного разговора получает [его срок жизни по умолчанию](/docs/ru/prompt-caching#which-ttl-each-request-gets)1330* **По умолчанию**: не установлено, поэтому каждый запрос основного разговора получает [его стандартный срок жизни](/docs/ru/prompt-caching#which-ttl-each-request-gets)

1274* **Переопределения для каждого сеанса**: [`FORCE_PROMPT_CACHING_5M`](/docs/ru/env-vars) имеет приоритет над всем остальным, затем [`CLAUDE_CODE_PROMPT_CACHE_TTL`](/docs/ru/env-vars), затем этот ключ, и последний [`ENABLE_PROMPT_CACHING_1H`](/docs/ru/env-vars)1331* **Переопределения для каждого сеанса**: [`FORCE_PROMPT_CACHING_5M`](/docs/ru/env-vars) имеет приоритет над всем остальным, затем [`CLAUDE_CODE_PROMPT_CACHE_TTL`](/docs/ru/env-vars), затем этот ключ, и последний [`ENABLE_PROMPT_CACHING_1H`](/docs/ru/env-vars)

1275 1332

1276Этот пример сохраняет основной разговор на одночасовом сроке жизни и оставляет подагентов на пять минут:1333Этот пример сохраняет основной разговор на одночасовом сроке жизни и оставляет подагентов на пять минут:

1302}1359}

1303```1360```

1304 1361

1305Редактирование изменяет только то, что вы видите, а не то, что генерирует модель. Чтобы снизить расходы на мышление, [снизьте бюджет или отключите мышление](/docs/ru/model-config#extended-thinking) вместо этого.1362Редактирование меняет только то, что вы видите, а не то, что генерирует модель. Чтобы снизить расходы на мышление, [снизьте бюджет или отключите мышление](/docs/ru/model-config#extended-thinking) вместо этого.

1306 1363

1307<h3 id="subagentpromptcachettl">1364<h3 id="subagentpromptcachettl">

1308 `subagentPromptCacheTtl`1365 `subagentPromptCacheTtl`

1309</h3>1366</h3>

1310 1367

1311Выберите, как долго [кэш подсказок](/docs/ru/prompt-caching) держит запросы, которые Claude Code делает вне основного разговора. Этот ключ применяется к [подагентам](/docs/ru/sub-agents), [workflows](/docs/ru/workflows) и собственным фоновым и вспомогательным запросам Claude Code, таким как компактирование и названия сеансов. Одночасовой срок жизни сохраняет кэш в тепле на более длительные перерывы, и API [выставляет счёт за каждую запись кэша по более высокой ставке](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing), чем при пятиминутном сроке жизни. Требует Claude Code версии 2.1.242 или позже.1368Выберите, как долго [кэш подсказок](/docs/ru/prompt-caching) держит запросы, которые Claude Code делает вне основного разговора. Этот ключ применяется к [подагентам](/docs/ru/sub-agents), [workflows](/docs/ru/workflows) и собственным фоновым и вспомогательным запросам Claude Code, таким как компактирование и названия сеансов. Одночасовой срок жизни сохраняет кэш в тепле на более длительные перерывы, и API [выставляет счёт за каждую запись кэша по более высокой ставке](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing), чем при пятиминутном сроке жизни. Требует Claude Code v2.1.242 или позже.

1312 1369

1313* **Область действия**: [`Any file`](#scopes)1370* **Область действия**: [`Any file`](#scopes)

1314* **Тип**: строка, один из:1371* **Тип**: строка, один из:

1315 * `"5m"`: кэш держится пять минут1372 * `"5m"`: кэш держится пять минут

1316 * `"1h"`: кэш держится час1373 * `"1h"`: кэш держится час

1317* **По умолчанию**: не установлено, поэтому каждый из этих запросов получает [его срок жизни по умолчанию](/docs/ru/prompt-caching#which-ttl-each-request-gets)1374* **По умолчанию**: не установлено, поэтому каждый из этих запросов получает [его стандартный срок жизни](/docs/ru/prompt-caching#which-ttl-each-request-gets)

1318* **Переопределения для каждого сеанса**: [`FORCE_PROMPT_CACHING_5M`](/docs/ru/env-vars) имеет приоритет над всем остальным, затем [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](/docs/ru/env-vars), затем этот ключ, затем [`ENABLE_PROMPT_CACHING_1H`](/docs/ru/env-vars), который просит одночасовой срок жизни на каждом запросе. Для того, где значение фронтматтера подагента занимает место, см. [Выберите TTL самостоятельно](/docs/ru/prompt-caching#choose-the-ttl-yourself)1375* **Переопределения для каждого сеанса**: [`FORCE_PROMPT_CACHING_5M`](/docs/ru/env-vars) имеет приоритет над всем остальным, затем [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](/docs/ru/env-vars), затем этот ключ, затем [`ENABLE_PROMPT_CACHING_1H`](/docs/ru/env-vars), который просит одночасовой срок жизни на каждом запросе. Для того, где значение frontmatter подагента занимает место, см. [Выберите TTL сами](/docs/ru/prompt-caching#choose-the-ttl-yourself)

1319 1376

1320Этот пример даёт подагентам и другим запросам вне основного разговора одночасовой срок жизни:1377Этот пример даёт подагентам и другим запросам вне основного разговора одночасовой срок жизни:

1321 1378

1345}1402}

1346```1403```

1347 1404

1348См. [Спросите перед переключением](/docs/ru/model-config#ask-before-switching).1405См. [Спросить перед переключением](/docs/ru/model-config#ask-before-switching).

1349 1406

1350<h3 id="ultracode">1407<h3 id="ultracode">

1351 `ultracode`1408 `ultracode`

1352</h3>1409</h3>

1353 1410

1354Начните сеансы с [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode) включённым. С ним включённым Claude планирует workflow для каждой существенной задачи вместо ожидания, пока вы попросите. Claude планирует workflows только когда [динамические workflows](/docs/ru/workflows) включены для вас, ваша модель поддерживает `xhigh` усилие, и нет [предела усилия](/docs/ru/model-config#organization-effort-limits) ниже `xhigh`. В любом случае `ultracode: true` запускает сеанс на `xhigh` усилии, или на пределе, когда предел усилия ниже. Claude Code читает этот ключ, но никогда не пишет его: `/effort ultracode` включает ultracode только для текущего сеанса.1411Начните сеансы с [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode) включённым. С ним включённым Claude планирует workflow для каждой существенной задачи вместо ожидания, пока вы попросите. Claude планирует workflows только когда [динамические workflows](/docs/ru/workflows) включены для вас и ваша модель поддерживает `xhigh` effort. Ключ не меняет уровень effort сеанса: ultracode работает на любом уровне, который использует сеанс. Claude Code читает этот ключ, но никогда его не записывает: `/effort ultracode` включает ultracode только для текущего сеанса.

1355 1412

1356* **Область действия**: [`Any file`](#scopes)1413* **Область действия**: [`Any file`](#scopes)

1357* **Тип**: Boolean1414* **Тип**: Boolean

1358 * `true`: сеансы начинаются на `xhigh` усилии, с ultracode включённым, когда динамические workflows включены для вас, ваша модель поддерживает `xhigh`, и нет предела усилия ниже `xhigh`1415 * `true`: сеансы начинаются с ultracode включённым, когда динамические workflows включены для вас и ваша модель поддерживает `xhigh`

1359 * `false`: сеансы начинаются с ultracode выключенным1416 * `false`: сеансы начинаются с ultracode отключённым

1360* **По умолчанию**: не установлено, поэтому ultracode выключен1417* **По умолчанию**: не установлено, поэтому ultracode отключён

1361* **Переопределения для каждого сеанса**: `/effort ultracode` включает ultracode для одного сеанса без этого ключа. Флаг `--effort ultracode` также включает его для одного сеанса и требует Claude Code версии 2.1.203 или позже1418* **Переопределения для каждого сеанса**: `/effort ultracode` включает ultracode для одного сеанса без этого ключа, и `/effort ultracode off` отключает его для одного сеанса, когда этот ключ `true`. Флаг `--effort ultracode` также включает его для одного сеанса, на `xhigh` effort, и требует Claude Code v2.1.203 или позже

1362 1419

1363```json settings.json theme={null}1420```json settings.json theme={null}

1364{1421{

1366}1423}

1367```1424```

1368 1425

1369Ultracode запускает сеанс на `xhigh` усилии и имеет приоритет над `effortLevel` и записями [`modelSettings`](#modelsettings). Если [предел усилия](/docs/ru/model-config#organization-effort-limits) ниже `xhigh` применяется к модели, такой как параметр [`maxEffortLevel`](#maxeffortlevel), сеанс вместо этого запускается на пределе и ultracode остаётся выключенным. Claude затем не планирует workflows самостоятельно, и `/effort` не предлагает `ultracode`. Запрос управления `apply_flag_settings` Agent SDK также принимает ключ.1426Уровень effort сеанса поступает из [`effortLevel`](#effortlevel), [`modelSettings`](#modelsettings) и других [источников effort](/docs/ru/model-config#adjust-effort-level), и [ограничение effort](/docs/ru/model-config#organization-effort-limits), такое как [`maxEffortLevel`](#maxeffortlevel), снижает этот уровень без отключения ultracode. Это и форма `/effort ultracode off` требуют Claude Code v2.1.284 или позже. До v2.1.284 `ultracode: true` запускал сеанс на `xhigh` effort, и ограничение effort ниже `xhigh` держало ultracode отключённым. Запрос управления `apply_flag_settings` Agent SDK также принимает ключ.

1370 1427

1371<h2 id="permission-settings">1428<h2 id="permission-settings">

1372 Параметры разрешений1429 Параметры разрешений

1489 `useAutoModeDuringPlan`1546 `useAutoModeDuringPlan`

1490</h3>1547</h3>

1491 1548

1492Выберите, использует ли Claude Code классификатор автоматического режима для проверки команд оболочки в режиме плана. По умолчанию `true` классификатор проверяет каждую команду во время планирования, когда доступен автоматический режим и вы не видите подсказку. Установите `false`, чтобы получить подсказку разрешения для каждой команды вне встроенного набора только для чтения. Появляется в `/config` как **Use auto mode during plan**.1549Выберите, использует ли Claude Code классификатор автоматического режима для проверки команд оболочки в режиме плана. По умолчанию `true` классификатор проверяет каждую команду во время планирования, когда доступен автоматический режим и вы не видите подсказку, кроме [критических путей удаления](/docs/ru/permission-modes#critical-paths). Установите `false`, чтобы получить подсказку разрешения для каждой команды вне встроенного набора только для чтения. Появляется в `/config` как **Use auto mode during plan**.

1493 1550

1494* **Область**: [`User, local, or managed`](#scopes). Репозиторий не может отключить его для вас.1551* **Область**: [`User, local, or managed`](#scopes). Репозиторий не может отключить его для вас.

1495* **Тип**: Boolean1552* **Тип**: Boolean

1496 * `true`: то же самое, что не установлено; когда доступен автоматический режим, классификатор проверяет каждую команду оболочки во время планирования вместо того, чтобы запрашивать вас. `false` в любом из этих файлов по-прежнему отключает его1553 * `true`: то же самое, что не установлено; когда доступен автоматический режим, классификатор проверяет каждую команду оболочки во время планирования вместо того, чтобы запрашивать вас, кроме [критических путей удаления](/docs/ru/permission-modes#critical-paths). `false` в любом из этих файлов по-прежнему отключает его

1497 * `false`: вы получаете подсказку разрешения для каждой команды вне встроенного набора только для чтения1554 * `false`: вы получаете подсказку разрешения для каждой команды вне встроенного набора только для чтения

1498* **По умолчанию**: `true`1555* **По умолчанию**: `true`

1499 1556

1619 `permissions.blockReadsOutsideWorkingDirectories`1676 `permissions.blockReadsOutsideWorkingDirectories`

1620</h3>1677</h3>

1621 1678

1622Остановите Claude от чтения путей вне [рабочих каталогов](/docs/ru/permissions#working-directories) сеанса с помощью инструментов Read, Grep, Glob и LSP, в каждом режиме разрешений, включая `bypassPermissions`. Команда Bash, которая читает соответствующий путь через команду файла, которую Claude Code распознаёт, такую как `cat`, запрашивает вас даже в автоматическом режиме и режиме `bypassPermissions`. Требует Claude Code v2.1.257 или позже.1679Заставьте инструменты файлов Claude отказывать в чтении вне [рабочих каталогов](/docs/ru/permissions#working-directories) в каждом режиме разрешений, включая `bypassPermissions`. Claude Code отрицает вызовы `Read`, `Grep`, `Glob` и `LSP` на этих путях и говорит Claude попросить вас добавить каталог с помощью `/add-dir`. Файлы, которые нужны самому Claude Code, остаются читаемыми, такие как ваши skills, plugins, правила, agents, команды и файл памяти `CLAUDE.md` под `~/.claude/`. Требует Claude Code v2.1.257 или позже.

1680

1681Claude Code не отказывает команды оболочки таким же образом:

1682

1683* [Действия, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves) охватывает, когда команда оболочки, которая читает такой путь, запрашивает вас

1684* [Команды в песочнице под блокировкой](#sandboxed-commands-under-the-block) охватывает, что команда в песочнице может читать

1623 1685

1624Команда Bash, которую парсер оболочки не может отследить, такая как та, которая меняет каталог более одного раза или запускает подоболочку, запрашивает вас даже в автоматическом режиме и режиме `bypassPermissions`. Подсказка появляется даже когда команда не называет путь вне рабочих каталогов. Эта подсказка не применяется, когда команда запускается в [песочнице](/docs/ru/sandboxing) и песочница применяет блокировку.1686Команда Bash, которую парсер оболочки не может отследить, такая как та, которая меняет каталог более одного раза или запускает подоболочку, запрашивает вас даже в автоматическом режиме и режиме `bypassPermissions`. Подсказка появляется даже когда команда не называет путь вне рабочих каталогов. Эта подсказка не применяется, когда команда запускается в [песочнице](/docs/ru/sandboxing) и песочница применяет блокировку.

1625 1687

1626Claude Code также пишет `true` здесь, когда вы выбираете блокировку таких чтений на [подсказке автоматического режима перед первым чтением вне рабочих каталогов](/docs/ru/permission-modes#first-read-outside-the-working-directories).1688Claude Code также пишет `true` здесь, когда вы выбираете блокировку таких чтений на [подсказке автоматического режима перед первым чтением вне рабочих каталогов](/docs/ru/permission-modes#first-read-outside-the-working-directories).

1627 1689

1628* **Область**: [`Any file`](#scopes). Если любой источник параметров устанавливает `true`, блокировка применяется, поэтому проверенный файл репозитория может включить блокировку для проекта, но не может снять блокировку, которую вы установили.1690* **Область**: [`Any file`](#scopes). `true` в любом файле применяется, поэтому репозиторий может включить блокировку для себя, но не может снять блокировку, которую вы установили.

1629* **Тип**: Boolean1691* **Тип**: Boolean

1630 * `true`: чтение файлов вне рабочих каталогов заблокировано1692 * `true`: инструменты файлов Claude отказывают в чтении вне рабочих каталогов

1631 * `false`: то же самое, что не установлено; `true` в любом другом файле параметров по-прежнему блокирует1693 * `false`: то же самое, что не установлено; блокировка по-прежнему применяется, если другой файл устанавливает `true`

1632* **По умолчанию**: не установлено, поэтому чтение файлов вне рабочих каталогов следует вашему режиму разрешений и правилам1694* **По умолчанию**: не установлено, поэтому чтение вне рабочих каталогов следует вашему [режиму разрешений](/docs/ru/permission-modes)

1633 1695

1634```json settings.json theme={null}1696```json settings.json theme={null}

1635{1697{

1639}1701}

1640```1702```

1641 1703

1642Если только файл параметров репозитория добавляет каталог, блокировка по-прежнему применяется к чтению там. Когда [`autoMemoryDirectory`](#automemorydirectory) поступает из `.claude/settings.json` проекта или из `.claude/settings.local.json` [рассматриваемого как предоставленный репозиторием](/docs/ru/permissions#when-your-local-settings-file-needs-trust), Claude Code не загружает [автоматическую память](/docs/ru/memory#storage-location) из этого каталога и не сохраняет её в него. Файлы, которые нужны самому Claude Code, остаются читаемыми, такие как ваши skills, plugins, правила, agents, команды и файл памяти `CLAUDE.md` под `~/.claude/`.1704Каталоги, которые вы добавляете с помощью `--add-dir`, `/add-dir` или `additionalDirectories` в ваши пользовательские или управляемые параметры, считаются рабочими каталогами для блокировки. Каталоги, добавленные только в параметры репозитория, не считаются: те, что в `.claude/settings.json`, и те, что в `.claude/settings.local.json`, если git не отслеживает этот файл. В каталоге, который не является репозиторием git, или когда git отслеживает файл, Claude Code рассматривает `.claude/settings.local.json` как параметры, предоставленные репозиторием, поэтому поместите каталоги, которые вы хотите сохранить читаемыми, в ваши пользовательские параметры вместо этого.

1643 1705

1644Когда [песочница](/docs/ru/sandboxing) включена, блокировка также отрицает доступ к чтению для команд в песочнице к домашним каталогам и корням смонтированных томов вне рабочих каталогов. Повторная попытка, которая требует одобрения для [запуска вне песочницы](/docs/ru/sandboxing#the-unsandboxed-retry-escape-hatch), запрашивает вас даже в режиме `bypassPermissions`. Файлы, которые инструмент читает из вашего домашнего каталога, такие как `~/.gitconfig`, отрицаются вместе с остальным; повторно откройте конкретный путь с помощью [`sandbox.filesystem.allowRead`](#sandbox-filesystem-allowread), когда инструменту это нужно.1706Когда [`autoMemoryDirectory`](#automemorydirectory) поступает из `.claude/settings.json` проекта или из `.claude/settings.local.json` [рассматриваемого как предоставленный репозиторием](/docs/ru/permissions#when-your-local-settings-file-needs-trust), Claude Code не загружает [автоматическую память](/docs/ru/memory#storage-location) из этого каталога и не сохраняет её в него.

1707

1708Чтобы снять блокировку, удалите ключ из каждого файла параметров, который его устанавливает, затем запустите новый сеанс.

1709

1710<h4 id="sandboxed-commands-under-the-block">

1711 Команды в песочнице под блокировкой

1712</h4>

1713

1714Когда [песочница](/docs/ru/sandboxing) включена, блокировка также охватывает команды в песочнице. Claude Code отрицает им доступ на чтение к вашему домашнему каталогу и к другим корням, которые содержат файлы пользователя: `/Users`, `/home`, `/root`, `/Volumes`, `/mnt`, `/media`, `/run/media` и `/srv`. Затем он повторно открывает рабочие каталоги, [worktrees](/docs/ru/worktrees), которые Claude Code создаёт в сеансе, временный каталог сеанса и части `~/.claude`, которые нужны командам, такие как skills и plugins. Пока блокировка действует, записи `allowRead` и `allowWrite` из параметров репозитория не считаются.

1645 1715

1646Когда рабочий каталог сеанса является связанным [git worktree](/docs/ru/worktrees), включая тот, в который Claude Code вошёл в середине сеанса, общий каталог `.git` репозитория остаётся читаемым и записываемым для команд в песочнице, чтобы git продолжал работать там.1716Когда рабочий каталог сеанса является связанным [git worktree](/docs/ru/worktrees), включая тот, в который Claude Code вошёл в середине сеанса, общий каталог `.git` репозитория остаётся читаемым и записываемым для команд в песочнице, чтобы git продолжал работать там.

1647 1717

1718В этих случаях блокировка не достигает команд в песочнице, пока инструменты файлов Claude продолжают её применять:

1719

1720* Изоляция файловой системы отключена через [`sandbox.filesystem.disabled`](#sandbox-filesystem-disabled)

1721* [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) установлено

1722* Путь каталога, в котором вы запустили Claude Code, содержит символ glob, такой как `*`, `?` или `[`

1723

1724Под блокировкой Claude Code повторно открывает ваши глобальные файлы конфигурации git для команд в песочнице, чтобы `git` сохранял вашу идентичность и параметры:

1725

1726* `~/.gitconfig`

1727* Файлы `config`, `ignore` и `attributes` под `$XDG_CONFIG_HOME/git`, который по умолчанию равен `~/.config/git`

1728* Файлы, которые ваша глобальная конфигурация git называет через `[include]`, `[includeIf]`, `core.excludesFile` или `core.attributesFile`

1729

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

1731

1732На Linux и WSL2 файл конфигурации, который является символической ссылкой, может остаться нечитаемым по его собственному пути, и `git` затем запускается без него. `~/.git-credentials` и `$XDG_CONFIG_HOME/git/credentials` остаются заблокированными.

1733

1734Если повторно открытый файл содержит секрет, такой как токен `http.extraHeader`, добавьте его путь в [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread). Запись `denyRead`, которая охватывает файл, всегда имеет приоритет над этим повторным открытием.

1735

1648<h3 id="permissions-defaultmode">1736<h3 id="permissions-defaultmode">

1649 `permissions.defaultMode`1737 `permissions.defaultMode`

1650</h3>1738</h3>

1651 1739

1652Установите [режим разрешений](/docs/ru/permission-modes), в котором начинаются новые сеансы. Когда вы оставляете его не установленным, сеансы начинаются в [встроенном по умолчанию](/docs/ru/permission-modes#which-mode-a-session-starts-in) для вашего плана и поверхности.1740Установите [режим разрешений](/docs/ru/permission-modes), в котором начинаются новые сеансы. Когда вы оставляете его не установленным, сеансы начинаются в [встроенном по умолчанию](/docs/ru/permission-modes#which-mode-a-session-starts-in) для вашей поверхности.

1653 1741

1654* **Область**: [`Any file`](#scopes). `auto` и `bypassPermissions` не вступают в силу из параметров проекта или локальных, поэтому установите их в `~/.claude/settings.json` вместо этого. До версии 2.1.257 `bypassPermissions` вступал в силу из любого файла. Для разговоров, которые запускает расширение VS Code, Claude Code читает только значения пользователя, управляемые и `--settings`.1742* **Область**: [`Any file`](#scopes). `auto` и `bypassPermissions` не вступают в силу из параметров проекта или локальных, поэтому установите их в `~/.claude/settings.json` вместо этого. До версии 2.1.257 `bypassPermissions` вступал в силу из любого файла. Для разговоров, которые запускает расширение VS Code, Claude Code читает только значения пользователя, управляемые и `--settings`.

1655* **Тип**: строка, одна из:1743* **Тип**: строка, одна из:

1970}2058}

1971```2059```

1972 2060

1973Claude Code объединяет записи во всех областях параметров, которые загружает сеанс: пути пользователя, проекта, локальные и управляемые объединяются, а не заменяют друг друга, и Claude Code добавляет пути из ваших правил разрешения `Edit(...)` allow. Запись `allowWrite` не может снять [protected path](/docs/ru/sandboxing#protected-paths).2061Claude Code объединяет записи `allowWrite` и пути из ваших правил разрешения `Edit(...)` allow во всех областях параметров, которые загружает сеанс, исключая те из параметров репозитория, пока [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) включен. Запись `allowWrite` не может снять [protected path](/docs/ru/sandboxing#protected-paths).

1974 2062

1975<h3 id="sandbox-filesystem-denywrite">2063<h3 id="sandbox-filesystem-denywrite">

1976 `sandbox.filesystem.denyWrite`2064 `sandbox.filesystem.denyWrite`

2041}2129}

2042```2130```

2043 2131

2044Claude Code разрешает запись `.` в корень проекта в параметрах проекта и в `~/.claude` в параметрах пользователя. Claude Code объединяет записи во всех файлах параметров, которые загружает сеанс, если не установлен [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly).2132Claude Code разрешает запись `.` в корень проекта в параметрах проекта и в `~/.claude` в параметрах пользователя. Claude Code объединяет записи во всех файлах параметров, которые загружает сеанс, если не установлен [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly), и исключает записи из параметров репозитория, пока [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) включен.

2045 2133

2046<h3 id="sandbox-filesystem-allowmanagedreadpathsonly">2134<h3 id="sandbox-filesystem-allowmanagedreadpathsonly">

2047 `sandbox.filesystem.allowManagedReadPathsOnly`2135 `sandbox.filesystem.allowManagedReadPathsOnly`

3017* [`CLAUDE_CODE_MESSAGING_SOCKET` и `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/ru/env-vars#variables), которые Claude Code экспортирует сам, игнорируются из каждого файла. Игнорирование переменной сокета требует Claude Code v2.1.224 или позже, а игнорирование токена требует v2.1.228 или позже.3105* [`CLAUDE_CODE_MESSAGING_SOCKET` и `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/ru/env-vars#variables), которые Claude Code экспортирует сам, игнорируются из каждого файла. Игнорирование переменной сокета требует Claude Code v2.1.224 или позже, а игнорирование токена требует v2.1.228 или позже.

3018* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ru/sessions#name-the-project-directory-yourself), которую Claude Code читает только из среды запуска, игнорируется из каждого файла; требует v2.1.234 или позже.3106* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ru/sessions#name-the-project-directory-yourself), которую Claude Code читает только из среды запуска, игнорируется из каждого файла; требует v2.1.234 или позже.

3019* [`CLAUDE_CODE_RESTRICTED`](/docs/ru/env-vars#variables), которую Claude Code читает только из среды запуска, игнорируется из каждого файла.3107* [`CLAUDE_CODE_RESTRICTED`](/docs/ru/env-vars#variables), которую Claude Code читает только из среды запуска, игнорируется из каждого файла.

3108* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/ru/env-vars#variables), которую Claude Code читает только из среды запуска, игнорируется из каждого файла. Переменная требует Claude Code v2.1.283 или позже.

3109* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` и `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`](/docs/ru/env-vars#variables), которые Claude Code читает только из среды запуска, игнорируются из каждого файла.

3020 3110

3021<h3 id="filecheckpointingenabled">3111<h3 id="filecheckpointingenabled">

3022 `fileCheckpointingEnabled`3112 `fileCheckpointingEnabled`

3416* **Тип**: строка, `"classic"` или `"readline"`3506* **Тип**: строка, `"classic"` или `"readline"`

3417* **По умолчанию**: не установлено3507* **По умолчанию**: не установлено

3418 3508

3509<h3 id="maxprosewidth">

3510 `maxProseWidth`

3511</h3>

3512

3513Ограничьте ширину прозы в ответах Claude, чтобы строки оставались читаемыми в широком терминале. Абзацы, заголовки, списки и блокировки цитат переносятся в пределах этого количества столбцов, в то время как таблицы и блоки кода сохраняют полную ширину терминала. Требуется Claude Code v2.1.282 или позже.

3514

3515* **Область действия**: [`Любой файл`](#scopes)

3516* **Тип**: количество столбцов терминала, целое число, минимум `40`. Claude Code игнорирует любое другое значение

3517* **По умолчанию**: не установлено, поэтому проза переносится на край терминала

3518

3519```json settings.json theme={null}

3520{

3521 "maxProseWidth": 80

3522}

3523```

3524

3419<h3 id="prefersreducedmotion">3525<h3 id="prefersreducedmotion">

3420 `prefersReducedMotion`3526 `prefersReducedMotion`

3421</h3>3527</h3>

4090 4196

4091* **Область действия**: [`Any file`](#scopes)4197* **Область действия**: [`Any file`](#scopes)

4092* **Тип**: строка4198* **Тип**: строка

4093* **По умолчанию**: не установлено, поэтому Claude Code добавляет `Co-Authored-By: <name> <noreply@anthropic.com>`. Имя — это активная модель сеанса, такая как `Claude Sonnet 5`.4199* **По умолчанию**: не установлено, поэтому Claude Code добавляет `Co-Authored-By: <name> <noreply@anthropic.com>`. Имя — это модель в использовании при создании коммита, такая как `Claude Sonnet 5`. Когда [subagent](/docs/ru/sub-agents) создает коммит, trailer указывает модель subagent'а.

4094 * Когда Claude Code распознает модель как модель Claude, но не может подтвердить её точную версию, он пишет только `Claude`.4200 * Когда Claude Code распознает модель как модель Claude, но не может подтвердить её точную версию, он пишет только `Claude`.

4095 * Когда он не может сопоставить ID модели с какой-либо моделью Claude, такой как модель третьей стороны, обслуживаемая через пользовательский [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars), он пишет `Claude Code`.4201 * Когда он не может сопоставить ID модели с какой-либо моделью Claude, такой как модель третьей стороны, обслуживаемая через пользовательский [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars), он пишет `Claude Code`.

4096 4202

5690* **Type**: Boolean5796* **Type**: Boolean

5691 * `true`: Claude Code подключает Удалённое управление автоматически, когда начинается каждый интерактивный сеанс5797 * `true`: Claude Code подключает Удалённое управление автоматически, когда начинается каждый интерактивный сеанс

5692 * `false`: Claude Code ждёт `/remote-control`5798 * `false`: Claude Code ждёт `/remote-control`

5693* **Default**: не установлено, поэтому автоподключение следует стандартному значению администратора вашей организации, когда оно установлено, и в противном случае текущему стандартному значению Claude Code5799* **Default**: не установлено, поэтому применяется [автоподключение по умолчанию](/docs/ru/remote-control#enable-remote-control-for-all-sessions)

5694* **Per-session overrides**: `--remote-control` включает Удалённое управление для одного сеанса даже когда этот ключ `false`, и ни один флаг не отключает его для одного сеанса5800* **Per-session overrides**: `--remote-control` включает Удалённое управление для одного сеанса даже когда этот ключ `false`, и ни один флаг не отключает его для одного сеанса

5695 5801

5696```json settings.json theme={null}5802```json settings.json theme={null}

5842 5948

5843Установите URL шлюза, к которому подключается экран `/login` облачного шлюза, чтобы люди достигли вашего [облачного шлюза](/docs/ru/claude-apps-gateway) без ввода его адреса. На экране нет поля URL: с установленным этим ключом он показывает URL вашего шлюза и подключается, когда человек нажимает Enter; без него он говорит им связаться с администратором IT.5949Установите URL шлюза, к которому подключается экран `/login` облачного шлюза, чтобы люди достигли вашего [облачного шлюза](/docs/ru/claude-apps-gateway) без ввода его адреса. На экране нет поля URL: с установленным этим ключом он показывает URL вашего шлюза и подключается, когда человек нажимает Enter; без него он говорит им связаться с администратором IT.

5844 5950

5845Либо этот ключ, либо `forceLoginMethod: "gateway"` делает машину только шлюзом, поэтому `/login` открывается на экране облачного шлюза без средства выбора метода входа. См. [Политика администратора требует вход через облачный шлюз](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in) для того, что происходит с оставшимся входом первой стороны или API ключом. Установите оба ключа, чтобы экран подключился вместо показа ошибки.5951Либо этот ключ, либо `forceLoginMethod: "gateway"` делает машину только шлюзом, за исключением сеансов, которые выбирают облачного поставщика с помощью `CLAUDE_CODE_USE_*`. `/login` затем открывается на экране облачного шлюза без средства выбора метода входа. См. [Политика администратора требует вход через облачный шлюз](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in) для того, что происходит с оставшимся входом первой стороны или API ключом. Установите оба ключа, чтобы экран подключился вместо показа ошибки.

5846 5952

5847* **Scope**: [`Managed`](#scopes). Read only from a source on the machine: `managed-settings.json`, the macOS plist or Windows HKLM registry, or a policy helper. Claude Code ignores it in HKCU and server-managed settings.5953* **Scope**: [`Managed`](#scopes). Read only from a source on the machine: `managed-settings.json`, the macOS plist or Windows HKLM registry, or a policy helper. Claude Code ignores it in HKCU and server-managed settings.

5848* **Type**: string, a full URL including the scheme5954* **Type**: string, a full URL including the scheme

5934}6040}

5935```6041```

5936 6042

5937Установите интервал обновления с помощью [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/docs/ru/env-vars). См. [Динамические заголовки](/docs/ru/monitoring-usage#dynamic-headers) для требований скрипта и где Claude Code сообщает о неудачном помощнике.6043Установите интервал обновления с помощью [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/docs/ru/env-vars). См. [Динамические заголовки](/docs/ru/monitoring-usage#dynamic-headers) для требований скрипта и что происходит, когда помощник не работает.

5938 6044

5939<h2 id="updates-and-versioning">6045<h2 id="updates-and-versioning">

5940 Обновления и версионирование6046 Обновления и версионирование

6095 `cleanupPeriodDays`6201 `cleanupPeriodDays`

6096</h3>6202</h3>

6097 6203

6098Установите, сколько дней Claude Code хранит [стенограммы сеансов и другие данные приложения](/docs/ru/claude-directory#cleaned-up-automatically) перед их удалением. Claude Code выполняет удаление как фоновую очистку после запуска сеанса, при условии, что он может безопасно определить период хранения.6204Установите, сколько дней Claude Code хранит [стенограммы сеансов и другие данные приложения](/docs/ru/claude-directory#cleaned-up-automatically) перед их удалением. Claude Code выполняет удаление как фоновую очистку после запуска сеанса, при условии, что он может безопасно определить период хранения. Очистка удаляет стенограммы без отображения сообщения, поэтому сеанс, который вы не использовали дольше, чем период хранения, больше не появляется в средстве выбора [`/resume`](/docs/ru/sessions#resume-a-session).

6099 6205

6100* **Область**: [`Any file`](#scopes)6206* **Область**: [`Any file`](#scopes)

6101* **Тип**: количество дней, целое число, минимум `1`6207* **Тип**: количество дней, целое число, минимум `1`

6439 `wslInheritsWindowsSettings`6545 `wslInheritsWindowsSettings`

6440</h3>6546</h3>

6441 6547

6442Заставьте Claude Code на WSL читать управляемые параметры из цепи политики Windows, с HKLM и файлом управляемых параметров Windows, имеющими приоритет над `/etc/claude-code` и HKCU ниже. Пока цепь включена, Claude Code читает `/etc/claude-code` только когда ни один файл управляемых параметров или drop-in под `C:\Program Files\ClaudeCode\` не доставляет [ключ политики](/docs/ru/managed-settings#how-claude-code-combines-managed-sources). Установите это, чтобы расширить политику, которую вы уже развертываете в Windows, на сеансы WSL на той же машине, чтобы они следовали тем же правилам, что и сеансы хоста. Claude Code соблюдает это только когда установлено в ключе реестра HKLM или в файле управляемых параметров или drop-in под `C:\Program Files\ClaudeCode\`, оба из которых требуют администратора Windows для записи.6548Заставьте Claude Code на WSL читать управляемые параметры из цепи политики Windows, с HKLM и файлом управляемых параметров Windows, имеющими приоритет над `/etc/claude-code` и HKCU ниже. Пока цепь включена, Claude Code читает `/etc/claude-code` только когда [нет документа администратора Windows](/docs/ru/managed-settings#present-admin-documents) в значении реестра HKLM или папке `C:\Program Files\ClaudeCode\`. Установите это, чтобы расширить политику, которую вы уже развертываете в Windows, на сеансы WSL на той же машине, чтобы они следовали тем же правилам, что и сеансы хоста. Claude Code соблюдает это только когда установлено в ключе реестра HKLM или в файле управляемых параметров или drop-in под `C:\Program Files\ClaudeCode\`, оба из которых требуют администратора Windows для записи.

6443 6549

6444* **Область**: [`Managed`](#scopes). В источнике Windows, управляемом администратором.6550* **Область**: [`Managed`](#scopes). В источнике Windows, управляемом администратором.

6445* **Тип**: Boolean6551* **Тип**: Boolean

6446 * `true`: Claude Code на WSL читает управляемые параметры из цепи политики Windows, и читает `/etc/claude-code` только когда ни один файл управляемых параметров или drop-in под `C:\Program Files\ClaudeCode\` не доставляет [ключ политики](/docs/ru/managed-settings#how-claude-code-combines-managed-sources)6552 * `true`: Claude Code на WSL читает управляемые параметры из цепи политики Windows, и читает `/etc/claude-code` только когда нет документа администратора Windows

6447 * `false`: WSL читает только `/etc/claude-code`6553 * `false`: WSL читает только `/etc/claude-code`

6448* **По умолчанию**: `false`, поэтому WSL читает только `/etc/claude-code`6554* **По умолчанию**: `false`, поэтому WSL читает только `/etc/claude-code`

6449 6555

6453}6559}

6454```6560```

6455 6561

6456Как только источник администратора включает цепь, политика HKCU присоединяется к ней на WSL только когда HKCU также устанавливает ключ на `true`. Эта копия не включает цепь сама по себе. Источник Windows, который содержит только этот ключ, не считается источником политики, поэтому источник с более низким приоритетом все еще поставляет политику. Этот ключ не имеет эффекта на нативный Windows.6562Как только источник администратора включает цепь, политика HKCU присоединяется к ней на WSL только когда HKCU также устанавливает ключ на `true`. Эта копия не включает цепь сама по себе. Источник Windows, который содержит только этот ключ, установленный на `true` или `false`, не считается источником политики, поэтому источник с более низким приоритетом все еще поставляет политику. Этот ключ не имеет эффекта на нативный Windows.

6563

6564Claude Code читает `true` и `false` с кавычками или без них и читает `null` как удаление ключа. Источник Windows, управляемый администратором, который содержит любое другое значение, считается [присутствующим документом администратора](/docs/ru/managed-settings#present-admin-documents) с включенной цепью: ни `/etc/claude-code`, ни HKCU не применяются, и предупреждение при запуске называет ключ. Значение HKLM или файл папки Windows, который существует, но не может быть прочитан, также препятствует применению `/etc/claude-code` независимо от того, включена ли цепь. Требуется Claude Code v2.1.282 или позже.

6457 6565

6458<h2 id="global-config-settings">6566<h2 id="global-config-settings">

6459 Глобальные параметры конфигурации6567 Глобальные параметры конфигурации

6503 6611

6504Claude Code игнорирует этот ключ в `settings.json`.6612Claude Code игнорирует этот ключ в `settings.json`.

6505 6613

6614<h3 id="claudeinchromedefaultenabled">

6615 `claudeInChromeDefaultEnabled`

6616</h3>

6617

6618Запускайте каждый интерактивный сеанс CLI с включенной [интеграцией Chrome](/docs/ru/chrome), без необходимости передавать `--chrome` каждый раз. Если вы запустите [`claude remote-control`](/docs/ru/remote-control), сеанс, который он запускает для одного из ваших потоков [проекта](/docs/ru/claude-projects), также следует этому ключу, за исключением режима `bypassPermissions`. Запуск `/chrome` и выбор **Enabled by default** устанавливает этот ключ за вас, как описано в [Enable Chrome by default](/docs/ru/chrome#enable-chrome-by-default). Отображается в `/config` как **Claude in Chrome enabled by default**.

6619

6620* **Scope**: [`Global config`](#scopes)

6621* **Type**: Boolean

6622 * `true`: Claude Code включает интеграцию Chrome при запуске интерактивного сеанса CLI, как это происходит при передаче `--chrome`

6623 * `false`: интерактивные сеансы CLI запускаются с отключенной интеграцией Chrome, и Claude Code прекращает [предлагать ее настройку](/docs/ru/chrome#install-the-extension-when-claude-asks). Передайте `--chrome`, чтобы включить его для одного интерактивного сеанса

6624* **Default**: unset, поэтому интеграция Chrome отключена и Claude Code все еще может предложить ее настройку

6625* **Per-session overrides**: `--chrome` и [`--no-chrome`](/docs/ru/cli-reference) имеют приоритет над этим ключом для одного интерактивного сеанса

6626

6627```json ~/.claude.json theme={null}

6628{

6629 "claudeInChromeDefaultEnabled": true

6630}

6631```

6632

6633Claude Code игнорирует этот ключ в `settings.json`.

6634

6635<h3 id="copyfullresponse">

6636 `copyFullResponse`

6637</h3>

6638

6639Делайте так, чтобы [`/copy`](/docs/ru/commands) копировала полный ответ каждый раз, без средства выбора, которое оно иначе показывает, когда ответ содержит блоки кода. Выбор **Always copy full response** в этом средстве выбора устанавливает этот ключ на `true`. Отображается в `/config` как **Skip the /copy picker**.

6640

6641* **Scope**: [`Global config`](#scopes)

6642* **Type**: Boolean

6643 * `true`: `/copy` копирует полный ответ без показа средства выбора

6644 * `false`: когда ответ содержит блоки кода, `/copy` показывает средство выбора, где вы выбираете один блок кода или полный ответ

6645* **Default**: `false`

6646

6647```json ~/.claude.json theme={null}

6648{

6649 "copyFullResponse": true

6650}

6651```

6652

6653Claude Code игнорирует этот ключ в `settings.json`.

6654

6506<h3 id="copyonselect">6655<h3 id="copyonselect">

6507 `copyOnSelect`6656 `copyOnSelect`

6508</h3>6657</h3>

6523 6672

6524Claude Code игнорирует этот ключ в `settings.json`.6673Claude Code игнорирует этот ключ в `settings.json`.

6525 6674

6675<h3 id="defaulttoagentsview">

6676 `defaultToAgentsView`

6677</h3>

6678

6679Открывайте [представление агента](/docs/ru/agent-view) вместо нового разговора при запуске `claude` без аргументов. Отображается в `/config` как **Open agents view by default**, если представление агента не [отключено](#disableagentview).

6680

6681* **Scope**: [`Global config`](#scopes)

6682* **Type**: Boolean

6683 * `true`: `claude` без аргументов открывает представление агента, если представление агента не [отключено](#disableagentview)

6684 * `false`: `claude` без аргументов запускает новый разговор

6685* **Default**: `false`

6686

6687```json ~/.claude.json theme={null}

6688{

6689 "defaultToAgentsView": true

6690}

6691```

6692

6693Claude Code игнорирует этот ключ в `settings.json`.

6694

6526<h3 id="difftool">6695<h3 id="difftool">

6527 `diffTool`6696 `diffTool`

6528</h3>6697</h3>

6577 6746

6578Claude Code игнорирует этот ключ в `settings.json`.6747Claude Code игнорирует этот ключ в `settings.json`.

6579 6748

6749<h3 id="leftarrowopensagents">

6750 `leftArrowOpensAgents`

6751</h3>

6752

6753Нажимайте `←` на пустой подсказке, чтобы [отправить сеанс в фоновый режим и открыть представление агента](/docs/ru/agent-view#switch-sessions-without-leaving-the-terminal). Установите этот ключ на `false`, чтобы отключить сочетание клавиш. Отображается в `/config` как **← opens agents**, когда представление агента доступно.

6754

6755* **Scope**: [`Global config`](#scopes)

6756* **Type**: Boolean

6757 * `true`: нажатие `←` на пустой подсказке в сеансе, который вы запустили в терминале, отправляет его в фоновый режим и открывает представление агента

6758 * `false`: Claude Code отключает сочетание клавиш; в сеансе, который вы [присоединили из представления агента](/docs/ru/agent-view#attach-to-a-session), `←` на пустой подсказке все еще отсоединяет

6759* **Default**: `true`

6760

6761```json ~/.claude.json theme={null}

6762{

6763 "leftArrowOpensAgents": false

6764}

6765```

6766

6767Claude Code игнорирует этот ключ в `settings.json`.

6768

6580<h3 id="permissionexplainerenabled">6769<h3 id="permissionexplainerenabled">

6581 `permissionExplainerEnabled`6770 `permissionExplainerEnabled`

6582</h3>6771</h3>

6591* **Type**: Boolean6780* **Type**: Boolean

6592* **Default**: `true`6781* **Default**: `true`

6593 6782

6783<h3 id="prstatusfooterenabled">

6784 `prStatusFooterEnabled`

6785</h3>

6786

6787Показывайте значок в нижнем колонтитуле подсказки для открытого запроса на слияние или запроса на объединение текущей ветви с цветной подчеркиванием, которое показывает его [статус](/docs/ru/interactive-mode#pr-review-status). Отображается в `/config` как **Show PR status footer**.

6788

6789* **Scope**: [`Global config`](#scopes)

6790* **Type**: Boolean

6791 * `true`: нижний колонтитул показывает значок при условиях в [PR review status](/docs/ru/interactive-mode#pr-review-status)

6792 * `false`: Claude Code пропускает проверку запроса на слияние и запроса на объединение нижнего колонтитула и не показывает этот значок. Сеанс, который вы [присоединили из представления агента](/docs/ru/agent-view#attach-to-a-session), все еще может показать простую ссылку на запрос на слияние [связанный с ним](/docs/ru/agent-view#pull-request-status)

6793* **Default**: `true`

6794

6795```json ~/.claude.json theme={null}

6796{

6797 "prStatusFooterEnabled": false

6798}

6799```

6800

6801Claude Code игнорирует этот ключ в `settings.json`.

6802

6594<h3 id="teammatedefaultmodel">6803<h3 id="teammatedefaultmodel">

6595 `teammateDefaultModel`6804 `teammateDefaultModel`

6596</h3>6805</h3>

setup.md +3 −3

Details

37 37

38<Tip>38<Tip>

39 Предпочитаете графический интерфейс? [Приложение Desktop](/docs/ru/desktop-quickstart) позволяет использовать Claude Code без терминала. Загрузите его для [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) или [Linux](/docs/ru/desktop-linux).39 Предпочитаете графический интерфейс? [Приложение Desktop](/docs/ru/desktop-quickstart) позволяет использовать Claude Code без терминала. Загрузите его для [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) или [Linux](/docs/ru/desktop-linux).

~~41 Новичок в терминале? См. [руководство по терминалу](/docs/ru/terminal-guide) для пошаговых инструкций.~~

42</Tip>40</Tip>

43 41

~~44Для установки Claude Code используйте один из следующих методов:~~42Для установки Claude Code откройте терминал и выполните команду для вашей системы. Если вы раньше не использовали терминал, [руководство по терминалу](/docs/ru/terminal-guide) показывает, как его открыть и вставить команду.

45 43

46<Tabs>44<Tabs>

47 <Tab title="Встроенная установка (рекомендуется)">45 <Tab title="Встроенная установка (рекомендуется)">

63 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd61 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

64 ```62 ```

65 63

64 Когда установщик завершит работу, откройте новое окно терминала и выполните `claude --version`. Работающая установка выводит номер версии. Если ваша оболочка говорит, что `claude` не найден или не распознан, каталог установки еще не находится в вашем PATH: см. [Исправьте ваш PATH](/docs/ru/troubleshoot-install#command-not-found-claude-after-installation).

66 Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell. Ваша подсказка показывает `PS C:\` когда вы находитесь в PowerShell и `C:\` без `PS` когда вы находитесь в CMD.66 Если вы видите `The token '&&' is not a valid statement separator`, вы находитесь в PowerShell, а не в CMD. Если вы видите `'irm' is not recognized as an internal or external command`, вы находитесь в CMD, а не в PowerShell. Ваша подсказка показывает `PS C:\` когда вы находитесь в PowerShell и `C:\` без `PS` когда вы находитесь в CMD.

67 67

68 Если команда установки завершается с ошибкой `syntax error near unexpected token '<'`, `403` или другой ошибкой curl, см. [Устранение неполадок при установке](/docs/ru/troubleshoot-install#find-your-error) чтобы сопоставить ошибку с исправлением и для альтернативных методов установки.68 Если команда установки завершается с ошибкой `syntax error near unexpected token '<'`, `403` или другой ошибкой curl, см. [Устранение неполадок при установке](/docs/ru/troubleshoot-install#find-your-error) чтобы сопоставить ошибку с исправлением и для альтернативных методов установки.

skills.md +55 −36

Details

126| :- | :- | :- |126| :- | :- | :- |

127| Enterprise | `.claude/skills/<skill-name>/SKILL.md` в [каталоге управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms) | Все пользователи на машинах, где ваша организация его развертывает |127| Enterprise | `.claude/skills/<skill-name>/SKILL.md` в [каталоге управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms) | Все пользователи на машинах, где ваша организация его развертывает |

128| Personal | `~/.claude/skills/<skill-name>/SKILL.md` | Все ваши проекты на этой машине, но не в [сеансах Cowork или облачных сеансах](#skills-in-cowork-and-cloud-sessions) |128| Personal | `~/.claude/skills/<skill-name>/SKILL.md` | Все ваши проекты на этой машине, но не [сеансы Cowork или облачные сеансы](#skills-in-cowork-and-cloud-sessions) |

130| Nested | `<subdir>/.claude/skills/<skill-name>/SKILL.md` | Сеансы, запущенные в `<subdir>` или ниже. Сеанс, запущенный выше, загружает skill один раз, когда Claude работает с файлами там. См. [монорепозитории и подкаталоги](#discovery-from-parent-and-nested-directories) |130| Nested | `<subdir>/.claude/skills/<skill-name>/SKILL.md` | Сеансы, запущенные в `<subdir>` или ниже. Сеанс, запущенный выше, загружает skill один раз, когда Claude работает с файлами там. См. [монорепозитории и подкаталоги](#discovery-from-parent-and-nested-directories) |

131| Additional directory | `.claude/skills/<skill-name>/SKILL.md` в каталоге, который вы передаете с `--add-dir` | Этот сеанс. См. [каталоги вне проекта](#skills-from-additional-directories) |131| Additional directory | `.claude/skills/<skill-name>/SKILL.md` в каталоге, который вы передаете с `--add-dir` | Этот сеанс. См. [каталоги вне проекта](#skills-from-additional-directories) |

133| claude.ai account | Skills, включенные для вашей учетной записи claude.ai | Сеансы Cowork, облачные сеансы и сеансы терминала, в которых вы входите с этой учетной записью. См. [Skills, синхронизированные с claude.ai](#how-synced-skills-behave) |133| claude.ai account | Skills, включенные для вашей учетной записи claude.ai | Сеансы Cowork, облачные сеансы и сеансы терминала, где вы входите с этой учетной записью. См. [Skills, синхронизированные с claude.ai](#how-synced-skills-behave) |

134 134

135Папки skill также следуют этим правилам:135Папки skill также следуют этим правилам:

136 136

137* **Символические ссылки на папки**: запись `<skill-name>` в расположении enterprise, personal или project может быть символической ссылкой на каталог в другом месте на диске. Claude Code читает `SKILL.md` из целевого объекта и загружает skill один раз, даже если несколько расположений указывают на один и тот же целевой объект. Plugin skills [обрабатывают символические ссылки по-другому](/docs/ru/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks).137* **Символические ссылки на папки**: запись `<skill-name>` в расположении enterprise, personal или project может быть символической ссылкой на каталог в другом месте на диске. Claude Code читает `SKILL.md` из целевого объекта и загружает skill один раз, даже если несколько расположений указывают на один и тот же целевой объект. Plugin skills [обрабатывают символические ссылки по-другому](/docs/ru/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks).

138* **Зарезервированное имя**: не называйте папку skill `synced` в любом регистре. Claude Code использует `~/.claude/skills/synced/` для [skills, загруженных с claude.ai](#where-synced-skills-load), и пропускает skill, который вы создали с этим именем в расположениях enterprise, personal и project.138* **Зарезервированное имя `synced`**: не называйте папку skill `synced` в любом регистре. Claude Code использует `~/.claude/skills/synced/` для [skills, загруженных с claude.ai](#where-synced-skills-load), и пропускает skill, который вы создали с этим именем в расположениях enterprise, personal и project.

139* **Файлы команд**: файл Markdown в `.claude/commands/` — это более старый формат, который все еще работает. Он поддерживает то же [frontmatter](#frontmatter-reference), кроме `name` и `paths`. Чтобы найти имя, которое вы вводите для его вызова, см. [Как skill получает имя команды](#how-a-skill-gets-its-command-name). Предпочитайте skill для новой работы, так как skills также поддерживают [вспомогательные файлы](#add-supporting-files).139* **Зарезервированное имя `anthropic-skills`**: вне plugin папка skill или файл команды, имя которого `anthropic-skills` или начинается с `anthropic-skills:`, не загружается. См. [Имена, зарезервированные для синхронизированных skills](#names-reserved-for-synced-skills).

140* **Папка skill как plugin**: добавьте `.claude-plugin/plugin.json` в папку skill, и она загружается как [plugin](/docs/ru/plugins/loading#plugins-shared-through-a-repository) с именем `<name>@skills-dir`, поэтому она может объединять agents, hooks и MCP servers. В `.claude/skills/` проекта это требует предварительного принятия диалога доверия рабочей области.140* **Файлы команд**: файл Markdown в `.claude/commands/` — это более старый формат, который все еще работает. Он поддерживает тот же [frontmatter](#frontmatter-reference), кроме `name` и `paths`. Чтобы найти имя, которое вы вводите для его вызова, см. [Как skill получает имя команды](#how-a-skill-gets-its-command-name). Предпочитайте skill для новой работы, так как skills также поддерживают [вспомогательные файлы](#add-supporting-files).

141* **Папка skill как plugin**: добавьте `.claude-plugin/plugin.json` в папку skill, и она загружается как [plugin](/docs/ru/plugins/loading#plugins-shared-through-a-repository) с именем `<name>@skills-dir`, поэтому она может объединять agents, hooks и MCP servers. В `.claude/skills/` проекта это требует сначала принять диалог доверия рабочей области.

141 142

142<h3 id="discovery-from-parent-and-nested-directories">143<h3 id="discovery-from-parent-and-nested-directories">

143 Загружайте skills в монорепозиториях и подкаталогах144 Загружайте skills в монорепозитории и подкаталоги

144</h3>145</h3>

145 146

146Claude Code загружает project skills из `.claude/skills/` в каталоге, где вы его запускаете, и в каждом родительском каталоге вплоть до корня репозитория, поэтому запуск в `packages/frontend/` все еще подхватывает skills, определенные в корне. Когда вы [перемещаете сеанс с `/cd`](/docs/ru/permissions#move-the-session-to-another-directory) на v2.1.246 или позже, Claude Code добавляет project skills нового каталога.147Claude Code загружает project skills из `.claude/skills/` в каталоге, где вы его запустили, и в каждом родительском каталоге вплоть до корня репозитория, поэтому запуск в `packages/frontend/` все еще подхватывает skills, определенные в корне. Когда вы [перемещаете сеанс с `/cd`](/docs/ru/permissions#move-the-session-to-another-directory) на v2.1.246 или позже, Claude Code добавляет project skills нового каталога.

147 148

148В сеансе, работающем в связанном [git worktree](/docs/ru/worktrees), Claude Code ищет родительские каталоги только до корня worktree. На Claude Code v2.1.277 или позже, когда checkout worktree не имеет каталога `.claude/skills` в его корне, Claude Code вместо этого загружает project skills основного checkout. См. [Что worktrees совместно используют с основным checkout](/docs/ru/worktrees#what-worktrees-share-with-the-main-checkout).149В сеансе, работающем в связанном [git worktree](/docs/ru/worktrees), Claude Code ищет родительские каталоги только до корня worktree. На Claude Code v2.1.277 или позже, когда checkout worktree не имеет каталога `.claude/skills` в его корне, Claude Code вместо этого загружает project skills основного checkout. См. [Что worktrees делят с основным checkout](/docs/ru/worktrees#what-worktrees-share-with-the-main-checkout).

149 150

150Skills в каталоге `.claude/skills/` ниже того места, где вы запустили, не загружаются при запуске. Они загружаются в первый раз, когда Claude читает или редактирует файл в этом подкаталоге, и остаются доступными для остальной части сеанса. До этого они не появляются в меню `/` и вы не можете вызвать их по имени. Чтобы загрузить их раньше, запустите `/add-dir` с путем подкаталога, что требует Claude Code v2.1.257 или позже.151Skills в каталоге `.claude/skills/` ниже того места, где вы запустили, не загружаются при запуске. Они загружаются в первый раз, когда Claude читает или редактирует файл в этом подкаталоге, и остаются доступными для остальной части сеанса. До этого они не появляются в меню `/` и вы не можете вызвать их по имени. Чтобы загрузить их раньше, запустите `/add-dir` с путем подкаталога, что требует Claude Code v2.1.257 или позже.

151 152

152Когда вложенный skill имеет то же имя, что и другой skill, оба остаются доступными. С skill `deploy` в корне репозитория и другим в `apps/web/.claude/skills/`:153Когда имя каталога вложенного skill совпадает с именем другого skill, оба остаются доступными. С skill `deploy` в корне репозитория и другим в `apps/web/.claude/skills/`:

153 154

154* `/deploy` запускает skill корня. Claude Code также перечисляет варианты с квалификацией каталога для Claude с инструкцией вызвать тот, чей каталог содержит файлы, над которыми он работает, поэтому вложенный skill все еще применяется к работе в `apps/web/`.155* `/deploy` запускает skill корня. Claude Code также перечисляет варианты с квалификацией по каталогу для Claude с инструкцией вызвать тот, чей каталог содержит файлы, над которыми он работает, поэтому вложенный skill все еще применяется к работе в `apps/web/`.

155* `/apps/web:deploy` запускает вложенный skill самостоятельно. Его описание называет каталог, к которому он применяется.156* `/apps/web:deploy` запускает вложенный skill самостоятельно. Его описание называет каталог, к которому он применяется.

156 157

157<h3 id="skills-from-additional-directories">158<h3 id="skills-from-additional-directories">

158 Загружайте skills из каталога вне проекта159 Загружайте skills из каталога вне проекта

159</h3>160</h3>

160 161

161Когда вы добавляете каталог с `--add-dir` или `/add-dir`, Claude Code загружает skills в `.claude/skills/` этого каталога, вместе с его `.claude/commands/` и `.claude/agents/`. Каталоги, которые Agent SDK добавляет через [`additionalDirectories`](/docs/ru/agent-sdk/typescript#options) в TypeScript или [`add_dirs`](/docs/ru/agent-sdk/python#claudeagentoptions) в Python, загружаются так же, потому что SDK передает их как `--add-dir`. Параметр `permissions.additionalDirectories` в `settings.json` предоставляет доступ только к файлам и не загружает ничего из этого.162Когда вы добавляете каталог с `--add-dir` или `/add-dir`, Claude Code загружает skills в `.claude/skills/` этого каталога, вместе с его `.claude/commands/` и `.claude/agents/`. Каталоги, которые Agent SDK добавляет через [`additionalDirectories`](/docs/ru/agent-sdk/typescript#options) в TypeScript или [`add_dirs`](/docs/ru/agent-sdk/python#claudeagentoptions) в Python, загружаются так же, потому что SDK передает их как `--add-dir`. Параметр `permissions.additionalDirectories` в `settings.json` предоставляет только доступ к файлам и не загружает ничего из этого.

162 163

163Claude Code отслеживает `.claude/skills/` в каталоге, который вы передаете с `--add-dir` при запуске, как описано в [Редактируйте skill во время сеанса](#live-change-detection). Он не отслеживает `.claude/commands/` или `.claude/agents/` добавленного каталога, поэтому перезапустите сеанс после изменения файла там.164Claude Code отслеживает `.claude/skills/` в каталоге, который вы передаете с `--add-dir` при запуске, как описано в [Редактируйте skill во время сеанса](#live-change-detection). Он не отслеживает `.claude/commands/` или `.claude/agents/` добавленного каталога, поэтому перезапустите сеанс после изменения файла там.

164 165

165Эти загрузки зависят от источника параметра `project` [setting source](/docs/ru/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources), который включен по умолчанию. Политика [`strictPluginOnlyCustomization`](/docs/ru/settings-reference#strictpluginonlycustomization), [bare mode](/docs/ru/headless#start-faster-with-bare-mode) и [`--safe-mode`](/docs/ru/cli-reference#cli-flags) каждая ограничивает их дальше, как описано на этих страницах. См. [Дополнительные каталоги предоставляют доступ к файлам, а не конфигурацию](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) для полной таблицы того, что загружает добавленный каталог, включая `CLAUDE.md` и параметры plugin.166Эти загрузки зависят от источника параметра `project` [setting source](/docs/ru/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources), который включен по умолчанию. Политика [`strictPluginOnlyCustomization`](/docs/ru/settings-reference#strictpluginonlycustomization), [bare mode](/docs/ru/headless#start-faster-with-bare-mode) и [`--safe-mode`](/docs/ru/cli-reference#cli-flags) каждая ограничивает их дальше, как описано на этих страницах. См. [Дополнительные каталоги предоставляют доступ к файлам, а не конфигурацию](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) для полной таблицы того, что загружает добавленный каталог, включая `CLAUDE.md` и параметры plugin.

166 167

167<h3 id="resolve-skills-that-share-a-name">168<h3 id="resolve-skills-that-share-a-name">

168 Разрешайте skills, которые имеют одно имя169 Разрешайте skills, которые делят имя

169</h3>170</h3>

170 171

171Когда два skills имеют одно имя, откуда каждый из них пришел, определяет, какой из них запускает `/name`. Таблица охватывает расположения enterprise, personal, project, nested, plugin и claude.ai, встроенные skills и файлы команд:172Когда два skills делят имя каталога или файла, откуда каждый пришел, решает, какой из них запускает `/name`. Для имени, установленного полем frontmatter `name`, см. [Как skill получает имя команды](#how-a-skill-gets-its-command-name). Таблица охватывает расположения enterprise, personal, project, nested, plugin и claude.ai, встроенные skills и файлы команд:

172 173

173| Одно имя в | Какой из них запускается |174| Одно имя в | Какой запускается |

174| :- | :- |175| :- | :- |

175| Два из enterprise, personal и project | Enterprise над personal, и personal над project. С `deploy` в обоих `~/.claude/skills/` и `.claude/skills/` проекта, `/deploy` запускает personal |176| Два из enterprise, personal и project | Enterprise над personal, и personal над project. С `deploy` в обоих `~/.claude/skills/` и `.claude/skills/` проекта, `/deploy` запускает personal |

176| Любое из этих расположений и [встроенный skill](#bundled-skills) | Ваш skill заменяет встроенную команду, но не ее aliases. Project skill `code-review` заменяет `/code-review`, и встроенный alias `/review` никогда не запускает ваш skill |177| Любое из этих расположений и [встроенный skill](#bundled-skills) | Ваш skill заменяет встроенную команду, но не ее aliases. Project skill `code-review` заменяет `/code-review`, и встроенный alias `/review` никогда не запускает ваш skill |

178| Project-root skill и вложенный skill | Оба загружаются. См. [монорепозитории и подкаталоги](#discovery-from-parent-and-nested-directories) |179| Project-root skill и вложенный skill | Оба загружаются. См. [монорепозитории и подкаталоги](#discovery-from-parent-and-nested-directories) |

179| Plugin skill и skill в любом из расположений выше | Оба загружаются, потому что plugin skills имеют пространство имен как `/plugin-name:skill-name` |180| Plugin skill и skill в любом из расположений выше | Оба загружаются, потому что plugin skills имеют пространство имен как `/plugin-name:skill-name` |

180| Любое из вышеперечисленного и skill [синхронизированный с вашей учетной записью claude.ai](#how-synced-skills-behave) | Другой skill или команда. Синхронизированный skill все еще запускается как `/anthropic-skills:<name>`. См. [Когда имя синхронизированного skill совпадает с другой командой](#when-a-synced-skill-name-matches-another-command) |181| Любое из вышеперечисленного и короткое имя skill [синхронизированного с вашей учетной записью claude.ai](#how-synced-skills-behave) | Другой skill или команда. Синхронизированный skill затем перечисляется и запускается только под его полным именем. См. [Когда имя синхронизированного skill совпадает с другой командой](#when-a-synced-skill-name-matches-another-command) |

181 182

182<h3 id="skills-in-cowork-and-cloud-sessions">183<h3 id="skills-in-cowork-and-cloud-sessions">

183 Используйте skills в сеансах Cowork и облачных сеансах184 Используйте skills в сеансах Cowork и облачных сеансах

206 207

207В сеансе Cowork или облачном сеансе Claude Code загружает skills, включенные для вашей учетной записи claude.ai, и [Skills в сеансах Cowork и облачных сеансах](#skills-in-cowork-and-cloud-sessions) говорит, как выбрать, какие skills получают эти сеансы.208В сеансе Cowork или облачном сеансе Claude Code загружает skills, включенные для вашей учетной записи claude.ai, и [Skills в сеансах Cowork и облачных сеансах](#skills-in-cowork-and-cloud-sessions) говорит, как выбрать, какие skills получают эти сеансы.

208 209

209В вашем терминале Claude Code синхронизирует эти skills в сеансах, в которых вы входите с вашей учетной записью claude.ai. Когда сеанс запускается, Claude Code загружает skills вашей учетной записи в `~/.claude/skills/synced/` в фоновом режиме, затем проверяет claude.ai на предмет изменений примерно каждые 10 минут во время работы сеанса. Когда проверка обнаруживает, что skill был добавлен, отредактирован или отключен на claude.ai, Claude Code добавляет, обновляет или удаляет его в работающем сеансе без перезагрузки. Синхронизация в сеансах терминала требует Claude Code v2.1.273 или позже.210В вашем терминале Claude Code синхронизирует эти skills в сеансах, где вы входите с вашей учетной записью claude.ai. Когда сеанс запускается, Claude Code загружает skills вашей учетной записи в `~/.claude/skills/synced/` в фоновом режиме, затем проверяет claude.ai на предмет изменений примерно каждые 10 минут во время работы сеанса. Когда проверка обнаруживает, что skill был добавлен, отредактирован или отключен на claude.ai, Claude Code добавляет, обновляет или удаляет его в работающем сеансе без перезагрузки. Синхронизация в сеансах терминала требует Claude Code v2.1.273 или позже.

210 211

211Синхронизация никогда не задерживает запуск, потому что Claude ждет загрузки skill только при его вызове. Короткий [неинтерактивный](/docs/ru/headless) запуск может поэтому завершиться до загрузки вновь добавленного skill, в этом случае более поздний сеанс его загружает. Чтобы неинтерактивный запуск загрузил ваши skills и дождался списка перед ответом на подсказку, установите [`CLAUDE_CODE_SYNC_SKILLS`](/docs/ru/env-vars#variables) на `1`.212Синхронизация никогда не задерживает запуск, потому что Claude ждет загрузки skill только при его вызове. Короткий [неинтерактивный](/docs/ru/headless) запуск может поэтому завершиться до загрузки вновь добавленного skill, в этом случае более поздний сеанс его загружает. Чтобы неинтерактивный запуск загрузил ваши skills и дождался списка перед ответом на подсказку, установите [`CLAUDE_CODE_SYNC_SKILLS`](/docs/ru/env-vars#variables) на `1`.

212 213

213Claude Code синхронизирует только в сеансе, который входит с вашей учетной записью claude.ai и [получает флаги функций от Anthropic](/docs/ru/env-vars#features-that-need-feature-flag-fetching). Он не синхронизирует в этих сеансах:214Claude Code синхронизирует только в сеансе, который входит с вашей учетной записью claude.ai и [получает флаги функций от Anthropic](/docs/ru/env-vars#features-that-need-feature-flag-fetching). Он не синхронизирует в этих сеансах:

214 215

215* Сеанс, который не использует вход, сохраненный `/login`, например тот, который аутентифицируется с помощью API key, или тот, где `ANTHROPIC_AUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN` или скрипт `apiKeyHelper` предоставляет учетные данные216* Сеанс, который не использует вход, сохраненный `/login`, такой как сеанс, который аутентифицируется с помощью API key, или сеанс, где `ANTHROPIC_AUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN` или скрипт `apiKeyHelper` предоставляет учетные данные

216* Сеанс, который не получает флаги функций, например тот, что на Amazon Bedrock, или тот, где вы установили `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`217* Сеанс, который не получает флаги функций, такой как сеанс на Amazon Bedrock или сеанс, где вы установили `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

217* Сеанс в [bare mode](/docs/ru/headless#start-faster-with-bare-mode) или тот, который вы запускаете с `--safe-mode`218* Сеанс в [bare mode](/docs/ru/headless#start-faster-with-bare-mode) или сеанс, который вы запустили с `--safe-mode`

218* Сеанс, где управляемые параметры вашей организации [блокируют skills для источников plugin](/docs/ru/settings-reference#strictpluginonlycustomization-skills), или тот, который вы запускаете со списком [`--setting-sources`](/docs/ru/cli-reference#cli-flags), который исключает `user`219* Сеанс, где управляемые параметры вашей организации [блокируют skills для источников plugin](/docs/ru/settings-reference#strictpluginonlycustomization-skills), или сеанс, который вы запустили со списком [`--setting-sources`](/docs/ru/cli-reference#cli-flags), который исключает `user`

219 220

220Если вы входите с `/login` во время сеанса, перезапустите Claude Code, чтобы начать синхронизацию.221Если вы входите с `/login` во время сеанса, перезапустите Claude Code, чтобы начать синхронизацию.

221 222

229 230

230Чтобы остановить синхронизацию на машине, установите [`syncClaudeAiSkills`](/docs/ru/settings-reference#syncclaudeaiskills) на `false` в ваших пользовательских параметрах. Claude Code прекращает загрузку, и при следующем запуске он перемещает skills, которые он уже синхронизировал, в `~/.claude/skills/.trash/` и больше их не загружает. Ваша организация может отключить синхронизацию для всех, отключив Skills на claude.ai. Чтобы остановить синхронизацию, оставляя Skills включенными, она может установить тот же ключ в [управляемые параметры](/docs/ru/managed-settings).231Чтобы остановить синхронизацию на машине, установите [`syncClaudeAiSkills`](/docs/ru/settings-reference#syncclaudeaiskills) на `false` в ваших пользовательских параметрах. Claude Code прекращает загрузку, и при следующем запуске он перемещает skills, которые он уже синхронизировал, в `~/.claude/skills/.trash/` и больше их не загружает. Ваша организация может отключить синхронизацию для всех, отключив Skills на claude.ai. Чтобы остановить синхронизацию, оставляя Skills включенными, она может установить тот же ключ в [управляемые параметры](/docs/ru/managed-settings).

231 232

232Если ваша организация отключит Skills на claude.ai, Claude Code удалит загруженные skills и они перестанут загружаться. Удаленные skills перемещаются в `~/.claude/skills/.trash/`, где вы можете восстановить файлы до того, как [sweep удержания](/docs/ru/claude-directory#cleaned-up-automatically) их удалит. Как только ваша организация снова включит Skills, Claude Code загружает skills, которые вы включили при следующей синхронизации.233Если ваша организация отключит Skills на claude.ai, Claude Code удалит загруженные skills и они перестанут загружаться. Удаленные skills перемещаются в `~/.claude/skills/.trash/`, где вы можете восстановить файлы до того, как [retention sweep](/docs/ru/claude-directory#cleaned-up-automatically) их удалит. Как только ваша организация снова включит Skills, Claude Code загружает skills, которые вы включили при следующей синхронизации.

233 234

234<h4 id="when-a-synced-skill-name-matches-another-command">235<h4 id="when-a-synced-skill-name-matches-another-command">

235 Когда имя синхронизированного skill совпадает с другой командой236 Когда имя синхронизированного skill совпадает с другой командой

236</h4>237</h4>

237 238

238Вы можете вызвать синхронизированный skill по его полному имени, `/anthropic-skills:<name>`, или по его короткому имени, `/<name>`. Когда другая команда использует это короткое имя, `/<name>` запускает другую команду, и синхронизированный skill запускается только как `/anthropic-skills:<name>`. С локальным skill `deploy` и синхронизированным `deploy`, `/deploy` запускает локальный skill и `/anthropic-skills:deploy` запускает синхронизированный. До v2.1.269 синхронизированный skill имел только свое короткое имя.239Вы можете вызвать синхронизированный skill по его короткому имени, `/<name>`, или по его полному имени, `/anthropic-skills:<name>`. Когда другая команда использует короткое имя, `/<name>` запускает другую команду, и синхронизированный skill запускается только как `/anthropic-skills:<name>`. С локальным skill `deploy` и синхронизированным `deploy`, `/deploy` запускает локальный skill и `/anthropic-skills:deploy` запускает синхронизированный. До v2.1.269 синхронизированный skill имел только его короткое имя.

239 240

240Другая команда может быть любой из этих:241В меню `/`, `/skills` и `/context` синхронизированный skill появляется под его коротким именем, или под его полным именем, пока другая команда использует короткое имя. Запустите `/skills` в вашем сеансе. Примечание под списком объясняет каждый синхронизированный skill, который потерял его короткое имя. Если один из ваших personal skills или файлов команд в `~/.claude/` использует имя, примечание также говорит, что переименовать или удалить, чтобы освободить его.

242

243От v2.1.269 до v2.1.280 эти списки показывали каждый синхронизированный skill под его полным именем, и `/skills` не имел такого примечания; оба изменились в v2.1.281.

244

245Команда, которая использует короткое имя, может быть любой из этих:

241 246

242* Встроенная команда или [встроенный skill](#bundled-skills), включая тот, который недоступен в вашем сеансе, например после отключения встроенных skills247* Встроенная команда или [встроенный skill](#bundled-skills), включая тот, который недоступен в вашем сеансе, например после отключения встроенных skills

243* Skill на любом [локальном уровне](#where-skills-live) или файл в `.claude/commands/`248* Skill на любом [локальном уровне](#where-skills-live) или файл в `.claude/commands/`

244* Plugin skill249* Plugin skill

245* [MCP prompt](/docs/ru/mcp#use-mcp-prompts-as-commands)250* [MCP prompt](/docs/ru/mcp#use-mcp-prompts-as-commands)

246 251

247Claude Code помечает синхронизированные skills, чтобы вы могли сказать, откуда они пришли. Меню `/skills` и `/context` группируют синхронизированные skills под `claude.ai sync`, и меню команды `/` помечает их как поступающие с claude.ai.252Claude Code помечает синхронизированные skills, чтобы вы могли сказать, откуда они пришли. Меню `/skills` и `/context` группируют синхронизированные skills под `claude.ai sync`, и меню команды `/` помечают их как поступающие с claude.ai.

248 253

249При сравнении имен Claude Code игнорирует регистр, пробелы и невидимые символы и рассматривает формы совместимости, такие как полноширинные буквы и варианты тире, как их простые эквиваленты. Например, синхронизированный skill с именем `Commit` и локальный skill с именем `commit` считаются одним и тем же именем, поэтому `/commit` продолжает запускать ваш локальный skill.254При сравнении имен Claude Code игнорирует регистр, пробелы и невидимые символы и рассматривает формы совместимости, такие как полноширинные буквы и варианты тире, как их простые эквиваленты. Например, синхронизированный skill с именем `Commit` и локальный skill с именем `commit` считаются одним и тем же именем, поэтому `/commit` продолжает запускать ваш локальный skill.

250 255

251Имя, которое отличается только похожей буквой из другого алфавита, считается другим именем, и метка `claude.ai sync` — это то, как вы различаете эти два. Эти проверки и метки требуют Claude Code v2.1.228 или позже.256Имя, которое отличается только похожей буквой из другого алфавита, считается другим именем, и метка `claude.ai sync` — это то, как вы различаете эти два. Эти проверки и метки требуют Claude Code v2.1.228 или позже.

252 257

258<h4 id="names-reserved-for-synced-skills">

259 Имена, зарезервированные для синхронизированных skills

260</h4>

261

262Claude Code резервирует имя `anthropic-skills` и каждое имя внутри этого пространства имен, такое как `anthropic-skills:pdf`, для skills, синхронизированных с claude.ai, поэтому полное имя синхронизированного skill никогда не запускает что-либо еще. Имя зарезервировано в каждом сеансе, независимо от того, входите ли вы с учетной записью claude.ai.

263

264* **Папка skill, frontmatter `name`, файл или подпапка в `.claude/commands/` или [сохраненный workflow](/docs/ru/workflows#save-the-workflow-for-reuse)**: он не загружается. [Уведомление при запуске](/docs/ru/errors#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) называет первый элемент для переименования или редактирования.

265* **Plugin с именем `anthropic-skills`**: он загружается. Когда один из его skills и синхронизированный skill оба названы `<name>`, `/anthropic-skills:<name>` запускает синхронизированный skill.

266* **MCP server с именем `anthropic-skills`**: он подключается и его tools работают, но [его prompts не появляются как команды](/docs/ru/mcp#use-mcp-prompts-as-commands). Переименуйте server в вашей MCP конфигурации, чтобы их перечислить.

267

253<h4 id="how-claude-code-handles-the-frontmatter-of-a-synced-skill">268<h4 id="how-claude-code-handles-the-frontmatter-of-a-synced-skill">

254 Как Claude Code обрабатывает frontmatter синхронизированного skill269 Как Claude Code обрабатывает frontmatter синхронизированного skill

255</h4>270</h4>

256 271

257Claude Code применяет два правила к frontmatter синхронизированного skill:272Claude Code применяет два правила к frontmatter синхронизированного skill:

258 273

259* Claude Code соблюдает frontmatter в каждом виде сеанса, поэтому грант `allowed-tools` проходит через нормальный [поток разрешений](/docs/ru/permissions).274* Claude Code соблюдает frontmatter в каждом виде сеанса, поэтому грант `allowed-tools` проходит через нормальный [permission flow](/docs/ru/permissions).

260* Claude Code санитизирует отображаемый текст, который предоставляет skill, такой как его описание. Он удаляет управляющие символы, и в тексте, который достигает Claude, такой как описание, он также экранирует угловые скобки, чтобы текст не мог имитировать внутреннее форматирование Claude Code. Эта санитизация требует Claude Code v2.1.228 или позже.275* Claude Code санитизирует текст отображения, который предоставляет skill, такой как его описание. Он удаляет управляющие символы, и в тексте, который достигает Claude, такой как описание, он также экранирует угловые скобки, чтобы текст не мог имитировать внутреннее форматирование Claude Code. Эта санитизация требует Claude Code v2.1.228 или позже.

261 276

262<h4 id="how-claude-code-handles-the-body-of-a-synced-skill">277<h4 id="how-claude-code-handles-the-body-of-a-synced-skill">

263 Как Claude Code обрабатывает тело синхронизированного skill278 Как Claude Code обрабатывает тело синхронизированного skill

266То, что Claude Code делает с телом синхронизированного skill, зависит от того, где работает сеанс:281То, что Claude Code делает с телом синхронизированного skill, зависит от того, где работает сеанс:

267 282

268* В облачном сеансе тело сохраняет поведение, которое имеет локальный skill, потому что сеанс работает в изолированном контейнере.283* В облачном сеансе тело сохраняет поведение, которое имеет локальный skill, потому что сеанс работает в изолированном контейнере.

269* В сеансе Cowork на вашем рабочем столе тело сохраняет поведение локального skill, за исключением того, что Claude Code заменяет каждую строку команды `!` на заполнитель [`disableSkillShellExecution`](#inject-dynamic-context), как это делается для каждого skill, который вы предоставляете там.284* В сеансе Cowork на вашем рабочем столе тело сохраняет поведение локального skill, за исключением того, что Claude Code заменяет каждую строку команды `!` на заполнитель [`disableSkillShellExecution`](#inject-dynamic-context), как он делает для каждого skill, который вы предоставляете там.

270* В любом другом сеансе на вашей машине Claude Code не запускает команды [`!`](#inject-dynamic-context), не прикрепляет файлы, которые ссылки `@` называют так же, как для локального skill, и не подставляет заполнители `${CLAUDE_PROJECT_DIR}` и `${CLAUDE_SESSION_ID}`, поэтому ссылки `@` и оба заполнителя достигают Claude как буквальный текст. Строка команды `!` также достигает Claude как буквальный текст, или как этот заполнитель, когда `disableSkillShellExecution` включен. Эта обработка требует Claude Code v2.1.228 или позже.285* В любом другом сеансе на вашей машине Claude Code не запускает команды [`!`](#inject-dynamic-context), не прикрепляет файлы, которые ссылки `@` называют так, как это делает для локального skill, и не подставляет заполнители `${CLAUDE_PROJECT_DIR}` и `${CLAUDE_SESSION_ID}`, поэтому ссылки `@` и оба заполнителя достигают Claude как буквальный текст. Строка команды `!` также достигает Claude как буквальный текст, или как этот заполнитель, когда `disableSkillShellExecution` включен. Эта обработка требует Claude Code v2.1.228 или позже.

271 286

272<h3 id="live-change-detection">287<h3 id="live-change-detection">

273 Редактируйте skill во время сеанса288 Редактируйте skill во время сеанса

274</h3>289</h3>

275 290

276Claude Code отслеживает каталоги skills на предмет изменений файлов, кроме [bare mode](/docs/ru/headless#start-faster-with-bare-mode). Когда вы добавляете, редактируете или удаляете skill в `~/.claude/skills/`, project `.claude/skills/` или `.claude/skills/` внутри каталога `--add-dir`, Claude Code подхватывает изменение в текущем сеансе без перезагрузки. Если вы создаете каталог skills верхнего уровня, который не существовал при запуске сеанса, перезапустите Claude Code, чтобы он мог отслеживать новый каталог.291Claude Code отслеживает каталоги skills на предмет изменений файлов, кроме [bare mode](/docs/ru/headless#start-faster-with-bare-mode). Когда вы добавляете, редактируете или удаляете skill в `~/.claude/skills/`, project `.claude/skills/` или `.claude/skills/` внутри каталога `--add-dir`, Claude Code подхватывает изменение в текущем сеансе без перезагрузки.

292

293Если вы создаете каталог skills верхнего уровня, который не существовал при запуске сеанса, запустите [`/reload-skills`](/docs/ru/commands#all-commands), чтобы подхватить skills, которые вы туда поместили. Claude Code еще не отслеживает этот каталог, поэтому запустите `/reload-skills` снова после каждого более позднего изменения там.

277 294

278Обнаружение изменений в реальном времени охватывает только текст `SKILL.md`. Для папки skill, которая также является [plugin](/docs/ru/plugins/loading#plugins-shared-through-a-repository), изменения в `hooks/`, `.mcp.json`, `agents/` и `output-styles/` требуют `/reload-plugins` для вступления в силу.295Обнаружение изменений в реальном времени охватывает только текст `SKILL.md`. Для папки skill, которая также является [plugin](/docs/ru/plugins/loading#plugins-shared-through-a-repository), изменения в `hooks/`, `.mcp.json`, `agents/` и `output-styles/` требуют `/reload-plugins` для вступления в силу.

279 296

283 300

284Способ удаления skill зависит от того, откуда он пришел:301Способ удаления skill зависит от того, откуда он пришел:

285 302

286* **Personal или project skill**: удалите каталог skill, `~/.claude/skills/<skill-name>/` или `.claude/skills/<skill-name>/`. Claude Code [удаляет его из `/skills` в текущем сеансе](#live-change-detection); содержимое, которое Claude Code уже загрузил из него, следует [жизненному циклу содержимого skill](#skill-content-lifecycle).303* **Personal или project skill**: удалите каталог skill, `~/.claude/skills/<skill-name>/` или `.claude/skills/<skill-name>/`. Claude Code [удаляет его из `/skills` в текущем сеансе](#live-change-detection); содержимое, которое Claude Code уже загрузил из него, следует [lifecycle содержимого skill](#skill-content-lifecycle).

287* **Enterprise skill**: администратор удаляет каталог skill из `.claude/skills/` внутри [каталога управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms), например `/etc/claude-code/.claude/skills/<skill-name>/` на Linux.304* **Enterprise skill**: администратор удаляет каталог skill из `.claude/skills/` внутри [каталога управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms), например `/etc/claude-code/.claude/skills/<skill-name>/` на Linux.

288* **Plugin skill**: отключите или удалите plugin, который его предоставляет, из меню `/plugin` или с помощью `/plugin uninstall <plugin-name>@<marketplace-name>`. Claude Code выгружает skills plugin, когда [изменение применяется](/docs/ru/plugins/cli-reference#reload-plugins) или когда вы перезагружаетесь.305* **Plugin skill**: отключите или удалите plugin, который его предоставляет, из меню `/plugin` или с `/plugin uninstall <plugin-name>@<marketplace-name>`. Claude Code выгружает skills plugin, когда [изменение применяется](/docs/ru/plugins/cli-reference#reload-plugins) или когда вы перезагружаетесь.

289* **Skill, синхронизированный с claude.ai**: отключите skill для вашей учетной записи claude.ai в том же месте, где вы его [включили](#skills-in-cowork-and-cloud-sessions). Claude Code удаляет его из `~/.claude/skills/synced/` при следующей [синхронизации ваших skills](#where-synced-skills-load). Если вы вместо этого удалите каталог вручную, следующая синхронизация загружает его снова, пока skill остается включенным на claude.ai.306* **Skill, синхронизированный с claude.ai**: отключите skill для вашей учетной записи claude.ai в том же месте, где вы его [включили](#skills-in-cowork-and-cloud-sessions). Claude Code удаляет его из `~/.claude/skills/synced/` при следующей [синхронизации ваших skills](#where-synced-skills-load). Если вы вместо этого удалите каталог вручную, следующая синхронизация загружает его снова, пока skill остается включенным на claude.ai.

290* **Встроенный skill**: установите [`disableBundledSkills`](#bundled-skills) на `true`, чтобы отключить встроенные skills, или установите один skill на `"off"` в [`skillOverrides`](#override-skill-visibility-from-settings), чтобы скрыть его.307* **Встроенный skill**: установите [`disableBundledSkills`](#bundled-skills) на `true`, чтобы отключить встроенные skills, или установите один skill на `"off"` в [`skillOverrides`](#override-skill-visibility-from-settings), чтобы скрыть его.

291 308

360 377

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

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

364| `description` | Рекомендуется | Что делает skill и когда его использовать. Claude использует это, чтобы решить, когда применить skill. Если опущено, использует первую непустую строку содержимого markdown. Поместите основной вариант использования в первую очередь: объединенный текст `description` и `when_to_use` усекается на 1536 символов в списке skills для снижения использования контекста. |381| `description` | Рекомендуется | Что делает skill и когда его использовать. Claude использует это, чтобы решить, когда применить skill. Если опущено, использует первую непустую строку содержимого markdown. Поместите основной вариант использования в первую очередь: объединенный текст `description` и `when_to_use` усекается на 1536 символов в списке skills для снижения использования контекста. |

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

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

406 Как skill получает имя команды423 Как skill получает имя команды

407</h4>424</h4>

408 425

409Команда, которую вы вводите для вызова skill, зависит от того, где находится файл skill и, для plugin skills, также от поля frontmatter `name`. В личном или проектном skill `name` устанавливает только отображаемый ярлык, показываемый в списках skills, а команда все еще поступает из имени каталога. В plugin skill `name` устанавливает последний сегмент команды, а префикс plugin остается на месте.426Команда, которую вы вводите для вызова skill, зависит от того, где находится файл skill и, для plugin skills, также от поля frontmatter `name`. В личном или проектном каталоге skill `name` устанавливает команду, которую показывает меню `/` и которую вы вводите, если только другая команда еще не использует это имя. Имя каталога также вызывает skill. В plugin skill `name` устанавливает последний сегмент команды, и префикс plugin остается на месте.

410 427

411Таблица ниже показывает, откуда берется имя команды для каждого макета:428Таблица ниже показывает, откуда берется имя команды для каждого макета:

412 429

414| :- | :- | :- |431| :- | :- | :- |

415| Каталог Skill под `~/.claude/skills/` или `.claude/skills/` | Имя каталога | `.claude/skills/deploy-staging/SKILL.md` → `/deploy-staging` |432| Каталог Skill под `~/.claude/skills/` или `.claude/skills/` | Frontmatter `name` или имя каталога | `.claude/skills/deploy-staging/SKILL.md` → `/deploy-staging`, или `/deploy` с `name: deploy` |

416| [Вложенный](#where-skills-live) каталог `.claude/skills/`, когда имя конфликтует с другим skill | Путь подкаталога относительно рабочего каталога, затем имя каталога skill | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |433| [Вложенный](#where-skills-live) каталог `.claude/skills/`, когда имя конфликтует с другим skill | Путь подкаталога относительно рабочего каталога, затем имя каталога skill | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |

418| Файл в подкаталоге `.claude/commands/` | Путь подкаталога относительно `commands/` с каждым `/` заменен на `:`, затем имя файла без расширения | `.claude/commands/frontend/component.md` → `/frontend:component` |435| Файл в подкаталоге `.claude/commands/` | Путь подкаталога относительно `commands/` с каждым `/` заменен на `:`, затем имя файла без расширения | `.claude/commands/frontend/component.md` → `/frontend:component` |

439| `$N` | Сокращение для `$ARGUMENTS[N]`, такое как `$0` для первого аргумента или `$1` для второго. |456| `$N` | Сокращение для `$ARGUMENTS[N]`, такое как `$0` для первого аргумента или `$1` для второго. |

440| `$name` | Именованный аргумент, объявленный в списке frontmatter [`arguments`](#frontmatter-reference). Имена соответствуют позициям по порядку, поэтому с `arguments: [issue, branch]` заполнитель `$issue` расширяется до первого аргумента, а `$branch` — до второго. |457| `$name` | Именованный аргумент, объявленный в списке frontmatter [`arguments`](#frontmatter-reference). Имена соответствуют позициям по порядку, поэтому с `arguments: [issue, branch]` заполнитель `$issue` расширяется до первого аргумента, а `$branch` — до второго. |

441| `${CLAUDE_SESSION_ID}` | Текущий ID сеанса. Полезно для логирования, создания файлов, специфичных для сеанса, или корреляции выходных данных skill с сеансами. |458| `${CLAUDE_SESSION_ID}` | Текущий ID сеанса. Полезно для логирования, создания файлов, специфичных для сеанса, или корреляции выходных данных skill с сеансами. |

442| `${CLAUDE_EFFORT}` | Текущий уровень усилий: `low`, `medium`, `high`, `xhigh` или `max`. Ultracode не является отдельным уровнем и сообщается как `xhigh`. Используйте это, чтобы адаптировать инструкции skill к активной настройке усилий. |459| `${CLAUDE_EFFORT}` | Текущий уровень усилий: `low`, `medium`, `high`, `xhigh` или `max`. Используйте это, чтобы адаптировать инструкции skill к активной настройке усилий. |

443| `${CLAUDE_SKILL_DIR}` | Каталог, содержащий файл `SKILL.md` skill. Для plugin skills это подкаталог skill в plugin, а не корень plugin. Используйте это в bash-командах внедрения для ссылки на скрипты или файлы, поставляемые с skill, независимо от текущего рабочего каталога. |460| `${CLAUDE_SKILL_DIR}` | Каталог, содержащий файл `SKILL.md` skill. Для plugin skills это подкаталог skill в plugin, а не корень plugin. Используйте это в bash-командах внедрения для ссылки на скрипты или файлы, поставляемые с skill, независимо от текущего рабочего каталога. |

444| `${CLAUDE_PROJECT_DIR}` | Корневой каталог проекта. Это тот же путь, который [hooks](/docs/ru/hooks#reference-scripts-by-path) и MCP-серверы получают как `CLAUDE_PROJECT_DIR`. Используйте это для ссылки на скрипты или файлы, специфичные для проекта, такие как `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, независимо от того, где установлен skill. |461| `${CLAUDE_PROJECT_DIR}` | Корневой каталог проекта. Это тот же путь, который [hooks](/docs/ru/hooks#reference-scripts-by-path) и MCP-серверы получают как `CLAUDE_PROJECT_DIR`. Используйте это для ссылки на скрипты или файлы, специфичные для проекта, такие как `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, независимо от того, где установлен skill. |

445| `${CLAUDE_PLUGIN_ROOT}` | Каталог установки plugin. Подставляется только в plugin skills. Используйте это для ссылки на скрипты или файлы, поставляемые в любом месте plugin, включая ресурсы, общие для skills plugin. См. [переменные окружения plugin](/docs/ru/plugins/manifest-reference#environment-variables). |462| `${CLAUDE_PLUGIN_ROOT}` | Каталог установки plugin. Подставляется только в plugin skills. Используйте это для ссылки на скрипты или файлы, поставляемые в любом месте plugin, включая ресурсы, общие для skills plugin. См. [переменные окружения plugin](/docs/ru/plugins/manifest-reference#environment-variables). |

826Skill(deploy *)843Skill(deploy *)

827```844```

828 845

829Синтаксис разрешений: `Skill(name)` для точного совпадения, `Skill(name *)` для совпадения префикса с любыми аргументами.846Синтаксис разрешений: `Skill(name)` для точного совпадения, `Skill(name *)` для совпадения префикса с любыми аргументами. В правиле `allow` префикс вне [пространства имен, зарезервированного для синхронизированных навыков](#names-reserved-for-synced-skills), не совпадает с именами внутри него: `Skill(anthropic *)` не охватывает `anthropic-skills:pdf`.

830 847

831Если ваше правило `deny` называет псевдоним или неквалифицированное имя, а не собственное имя навыка, Claude Code все равно блокирует навык: с `Skill(review)` он блокирует встроенный `/code-review` через его псевдоним `/review`, и с `Skill(deploy)` он блокирует [вложенный навык](#where-skills-live), указанный как `apps/web:deploy` через его неквалифицированное имя. До v2.1.260 Claude Code не блокировал вложенный навык, указанный под его квалифицированным именем, когда правило deny называло только неквалифицированное имя.848Если ваше правило `deny` называет псевдоним или неквалифицированное имя, а не собственное имя навыка, Claude Code все равно блокирует навык: с `Skill(review)` он блокирует встроенный `/code-review` через его псевдоним `/review`, и с `Skill(deploy)` он блокирует [вложенный навык](#where-skills-live), указанный как `apps/web:deploy` через его неквалифицированное имя. До v2.1.260 Claude Code не блокировал вложенный навык, указанный под его квалифицированным именем, когда правило deny называло только неквалифицированное имя.

832 849

833Claude Code совпадает с правилом `allow` только с собственным именем навыка и именем в вызове Claude.850Claude Code совпадает с правилом `allow` только с собственным именем навыка и именем в вызове Claude.

834 851

852Чтобы одобрить [синхронизированный навык](#how-synced-skills-behave) без подсказки, назовите его внутри его [зарезервированного пространства имен](#names-reserved-for-synced-skills): `Skill(anthropic-skills:pdf)` одобряет синхронизированный навык `pdf`, и `Skill(anthropic-skills *)` одобряет каждый синхронизированный навык.

853

835**Скрыть отдельные навыки** добавив `disable-model-invocation: true` в их frontmatter. Это полностью удаляет навык из контекста Claude.854**Скрыть отдельные навыки** добавив `disable-model-invocation: true` в их frontmatter. Это полностью удаляет навык из контекста Claude.

836 855

837<Note>856<Note>

statusline.md +3 −3

Details

175 175

176Claude Code захватывает вывод вашего скрипта вместо прямого подключения к терминалу, поэтому `tput cols` и определение ширины на уровне языка не могут прочитать размер терминала изнутри скрипта. Вместо этого читайте переменные окружения `COLUMNS` и `LINES`. Claude Code устанавливает эти значения в соответствии с текущими размерами терминала перед запуском вашего скрипта.176Claude Code захватывает вывод вашего скрипта вместо прямого подключения к терминалу, поэтому `tput cols` и определение ширины на уровне языка не могут прочитать размер терминала изнутри скрипта. Вместо этого читайте переменные окружения `COLUMNS` и `LINES`. Claude Code устанавливает эти значения в соответствии с текущими размерами терминала перед запуском вашего скрипта.

177 177

178<Note>Строка состояния работает локально и не потребляет токены API. Она временно скрывается во время определённых взаимодействий с пользовательским интерфейсом, включая предложения автодополнения, меню справки и запросы разрешений.</Note>178<Note>Строка состояния работает локально и не потребляет токены API. Она временно скрывается во время определённых взаимодействий с пользовательским интерфейсом, включая меню справки и запросы разрешений.</Note>

179 179

180<h2 id="available-data">180<h2 id="available-data">

181 Доступные данные181 Доступные данные

202| `context_window.current_usage` | Подсчёты токенов из последнего вызова API, описанные в [полях контекстного окна](#context-window-fields) |202| `context_window.current_usage` | Подсчёты токенов из последнего вызова API, описанные в [полях контекстного окна](#context-window-fields) |

203| `exceeds_200k_tokens` | Превышает ли общее количество токенов (входные, кэшированные и выходные токены в сумме) из последнего ответа API 200k. Это фиксированный порог независимо от фактического размера контекстного окна. |203| `exceeds_200k_tokens` | Превышает ли общее количество токенов (входные, кэшированные и выходные токены в сумме) из последнего ответа API 200k. Это фиксированный порог независимо от фактического размера контекстного окна. |

205| `effort.level` | Текущий уровень рассуждений (`low`, `medium`, `high`, `xhigh` или `max`). Отражает текущее значение сеанса, включая изменения `/effort` во время сеанса. Ultracode не является отдельным уровнем и сообщается как `xhigh`. Отсутствует, когда текущая модель не поддерживает параметр effort |205| `effort.level` | Текущий уровень рассуждений (`low`, `medium`, `high`, `xhigh` или `max`). Отражает текущее значение сеанса, включая изменения `/effort` во время сеанса. Отсутствует, когда текущая модель не поддерживает параметр effort |

207| `rate_limits.five_hour.used_percentage`, `rate_limits.seven_day.used_percentage` | Процент лимита скорости за 5 часов или 7 дней, потреблённый от 0 до 100 |207| `rate_limits.five_hour.used_percentage`, `rate_limits.seven_day.used_percentage` | Процент лимита скорости за 5 часов или 7 дней, потреблённый от 0 до 100 |

208| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | Секунды эпохи Unix, когда окно лимита скорости за 5 часов или 7 дней сбрасывается |208| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | Секунды эпохи Unix, когда окно лимита скорости за 5 часов или 7 дней сбрасывается |

1166* В Windows с установленным Git Bash обратные слэши в пути `command` вероятно будут использованы как символы экранирования перед запуском скрипта. Используйте прямые слэши в пути. См. [Конфигурация Windows](#windows-configuration).1166* В Windows с установленным Git Bash обратные слэши в пути `command` вероятно будут использованы как символы экранирования перед запуском скрипта. Используйте прямые слэши в пути. См. [Конфигурация Windows](#windows-configuration).

1167* Если `disableAllHooks` установлен на `true` вне управляемых настроек после применения [приоритета настроек](/docs/ru/hooks#disable-or-remove-hooks), Claude Code запускает только `statusLine` из управляемых настроек, и без управляемого `statusLine` строка состояния отключена. Удалите эту настройку или установите её на `false` в файле, который её устанавливает, чтобы повторно включить. См. [`disableAllHooks`](/docs/ru/settings-reference#disableallhooks).1167* Если `disableAllHooks` установлен на `true` вне управляемых настроек после применения [приоритета настроек](/docs/ru/hooks#disable-or-remove-hooks), Claude Code запускает только `statusLine` из управляемых настроек, и без управляемого `statusLine` строка состояния отключена. Удалите эту настройку или установите её на `false` в файле, который её устанавливает, чтобы повторно включить. См. [`disableAllHooks`](/docs/ru/settings-reference#disableallhooks).

1168* Если ваша организация устанавливает `allowManagedHooksOnly` в управляемых настройках, ваша пользовательская строка состояния исчезает без предупреждения: вы можете получить строку состояния только из значения `statusLine` в этих управляемых настройках. См. [что запускается под `allowManagedHooksOnly`](/docs/ru/settings-reference#what-runs-under-allowmanagedhooksonly) для полного поведения и спросите у вашего администратора, применяется ли эта настройка к вам.1168* Если ваша организация устанавливает `allowManagedHooksOnly` в управляемых настройках, ваша пользовательская строка состояния исчезает без предупреждения: вы можете получить строку состояния только из значения `statusLine` в этих управляемых настройках. См. [что запускается под `allowManagedHooksOnly`](/docs/ru/settings-reference#what-runs-under-allowmanagedhooksonly) для полного поведения и спросите у вашего администратора, применяется ли эта настройка к вам.

1169* Запустите `claude --debug`, чтобы записать код выхода и stderr из первого вызова строки состояния в сеансе1169* Запустите `claude --debug`, чтобы записать stderr вашего скрипта при каждом вызове строки состояния и его код выхода при первом вызове в сеансе

1170* Попросите Claude прочитать ваш файл настроек и выполнить команду `statusLine` напрямую, чтобы выявить ошибки1170* Попросите Claude прочитать ваш файл настроек и выполнить команду `statusLine` напрямую, чтобы выявить ошибки

1171 1171

1172**Строка состояния показывает `--` или пустые значения**1172**Строка состояния показывает `--` или пустые значения**

sub-agents.md +144 −140

Details

8 8

9Subagents — это специализированные AI-помощники, которые обрабатывают определённые типы задач. Используйте один, когда побочная задача заполнит основной разговор результатами поиска, логами или содержимым файлов, на которые вы больше не будете ссылаться: subagent выполняет эту работу в собственном контексте и возвращает только резюме. Определите пользовательский subagent, когда вы постоянно порождаете одного и того же рабочего с одинаковыми инструкциями.9Subagents — это специализированные AI-помощники, которые обрабатывают определённые типы задач. Используйте один, когда побочная задача заполнит основной разговор результатами поиска, логами или содержимым файлов, на которые вы больше не будете ссылаться: subagent выполняет эту работу в собственном контексте и возвращает только резюме. Определите пользовательский subagent, когда вы постоянно порождаете одного и того же рабочего с одинаковыми инструкциями.

10 10

11Каждый subagent работает в собственном контекстном окне с пользовательским системным приглашением, специфическим доступом к инструментам и независимыми разрешениями. Когда Claude встречает задачу, соответствующую описанию subagent, он делегирует её этому subagent, который работает независимо и возвращает результаты. Чтобы увидеть экономию контекста на практике, [визуализация контекстного окна](/docs/ru/context-window) проходит через сессию, где subagent обрабатывает исследование в собственном отдельном окне.11Каждый subagent работает в собственном контекстном окне с пользовательским системным приглашением, специфическим доступом к инструментам и независимыми разрешениями. Он также отправляет свои собственные запросы, которые учитываются в тех же [лимитах использования](/docs/ru/costs#plan-usage-breakdown), что и ваш основной разговор. Когда Claude встречает задачу, соответствующую описанию subagent, он делегирует её этому subagent, который работает независимо и возвращает результаты. Чтобы увидеть экономию контекста на практике, [визуализация контекстного окна](/docs/ru/context-window) проходит через сессию, где subagent обрабатывает исследование в собственном отдельном окне.

12 12

13<Note>13<Note>

14 Subagents работают в рамках одной сессии. Чтобы запустить множество независимых сессий параллельно и отслеживать их из одного места, см. [background agents](/docs/ru/agent-view). Для отдельных сессий, которые передают сообщения друг другу, см. [cross-session messaging](/docs/ru/cross-session-messaging). Для скоординированной команды сессий, которые Claude порождает и контролирует, см. [agent teams](/docs/ru/agent-teams).14 Subagents работают в рамках одной сессии. Чтобы запустить множество независимых сессий параллельно и отслеживать их из одного места, см. [background agents](/docs/ru/agent-view). Для отдельных сессий, которые передают сообщения друг другу, см. [cross-session messaging](/docs/ru/cross-session-messaging). Для скоординированной команды сессий, которые Claude порождает и контролирует, см. [agent teams](/docs/ru/agent-teams).

230 </Tab>230 </Tab>

231</Tabs>231</Tabs>

232 232

233Флаг `--agents` принимает JSON с полем `prompt` плюс эти поля [frontmatter](#supported-frontmatter-fields): `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd` и `isolation`. Используйте `prompt` для системного приглашения, эквивалентного телу markdown в файловых subagents. `color` и `experimental` не принимаются здесь и игнорируются, а не отклоняются.233В [non-interactive mode](/docs/ru/headless) `--agents` также принимает путь к файлу JSON, содержащему тот же объект, для определений, слишком больших для передачи в командной строке. Например, `claude -p --agents ./agents.json "Review my changes"` читает определения из этого файла. В интерактивной сессии Claude Code отказывает в пути к файлу. Форма файла требует Claude Code v2.1.281 или позже.

234 234

235Каждый ключ верхнего уровня в JSON — это имя агента. Не начинайте имя с `-`.235Каждый ключ верхнего уровня в JSON — это имя агента, и его значение — это определение этого агента. Не начинайте имя с `-`. Определение принимает эти поля:

236

237* **`prompt`**: системное приглашение агента, эквивалентное телу markdown в файловых subagents. `prompt` может быть пустым. Если вы выбираете агента с пустым `prompt` и без поля `memory` в качестве агента сессии с помощью `--agent`, системное приглашение сессии остаётся неизменным. Пустой `prompt` требует Claude Code v2.1.281 или позже.

238* **[Поля Frontmatter](#supported-frontmatter-fields)**: `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd` и `isolation`.

239* **Игнорируемые поля**: `color` и `experimental` не принимаются здесь и игнорируются, а не отклоняются.

236 240

237Для того, что Claude Code делает со значением, которое он не может загрузить, и флагов и переменной окружения, которые пропускают эту проверку, см. [`Invalid --agents configuration`](/docs/ru/errors#invalid-agents-configuration).241Для того, что Claude Code делает со значением, которое он не может загрузить, и флагов и переменной окружения, которые пропускают эту проверку, см. [`Invalid --agents configuration`](/docs/ru/errors#invalid-agents-configuration).

238 242

239**Managed subagents** развёртываются администраторами организации. Поместите файлы markdown в `.claude/agents/` внутри [директории managed settings](/docs/ru/managed-settings#delivery-mechanisms), используя тот же формат frontmatter, что и project и user subagents. Managed определения имеют приоритет над project и user subagents с тем же именем.243**Managed subagents** развёртываются администраторами организации. Поместите файлы markdown в `.claude/agents/` внутри [директории managed settings](/docs/ru/managed-settings#delivery-mechanisms), используя тот же формат frontmatter, что и project и user subagents. Managed определения имеют приоритет над project и user subagents с тем же именем.

240 244

241**Plugin subagents** поступают из [plugins](/docs/ru/plugins/overview), которые вы установили. Они загружаются вместе с вашими пользовательскими subagents и появляются в typeahead @-упоминания под их scoped name. См. [справку по компонентам plugin](/docs/ru/plugins/components#agents) для деталей создания plugin subagents.245**Plugin subagents** поступают из [plugins](/docs/ru/plugins/overview), которые вы установили. Они загружаются автоматически вместе с вашими пользовательскими subagents и появляются в typeahead @-упоминания под их scoped name. См. [справку по компонентам plugin](/docs/ru/plugins/components#agents) для деталей создания plugin subagents.

242 246

243<Note>247<Note>

244 По соображениям безопасности plugin subagents не поддерживают поля frontmatter `hooks`, `mcpServers` или `permissionMode`. Эти поля игнорируются при загрузке агентов из plugin. Если они вам нужны, скопируйте файл агента в `.claude/agents/` или `~/.claude/agents/`. Вы также можете добавить правила в [`permissions.allow`](/docs/ru/settings-reference#permissions-allow) в `settings.json` или `settings.local.json`, но эти правила применяются ко всей сессии, а не только к plugin subagent.248 По соображениям безопасности plugin subagents не поддерживают поля frontmatter `hooks`, `mcpServers` или `permissionMode`. Эти поля игнорируются при загрузке агентов из plugin. Если они вам нужны, скопируйте файл агента в `.claude/agents/` или `~/.claude/agents/`. Вы также можете добавить правила в [`permissions.allow`](/docs/ru/settings-reference#permissions-allow) в `settings.json` или `settings.local.json`, но эти правила применяются ко всей сессии, а не только к plugin subagent.

587 Режимы разрешений591 Режимы разрешений

588</h4>592</h4>

589 593

590Установите `permissionMode` для выбора режима разрешений, в котором работает subagent. Используйте значения конфигурации режимов, поэтому режим Manual — это `default`. Если вы оставите его неустановленным, subagent наследует режим основного разговора, который начинается как [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) на планах Pro, Max и Team, если ваши настройки или ваша организация не изменяют его.594Установите `permissionMode` для выбора режима разрешений, в котором работает subagent. Используйте значения конфигурации режимов, поэтому режим Manual — это `default`. Если вы оставите его неустановленным, subagent наследует режим основного разговора [permission mode](/docs/ru/permission-modes).

591 595

592Режим разрешений основного разговора решает, использует ли Claude Code значение, которое вы установили:596Режим разрешений основного разговора решает, использует ли Claude Code значение, которое вы установили:

593 597

851См. [Hooks](/docs/ru/hooks) для полного формата конфигурации hook.855См. [Hooks](/docs/ru/hooks) для полного формата конфигурации hook.

852 856

853<h2 id="work-with-subagents">857<h2 id="work-with-subagents">

854 Работа с subagents858 Работа с подагентами

855</h2>859</h2>

856 860

857<h3 id="understand-automatic-delegation">861<h3 id="understand-automatic-delegation">

858 Поймите автоматическое делегирование862 Понимание автоматического делегирования

859</h3>863</h3>

860 864

861Claude автоматически делегирует задачи на основе описания задачи в вашем запросе, поля `description` в конфигурациях subagent и текущего контекста. Чтобы поощрить активное делегирование, включите фразы вроде "use proactively" в поле description вашего subagent.865Claude автоматически делегирует задачи на основе описания задачи в вашем запросе, поля `description` в конфигурациях подагентов и текущего контекста. Чтобы поощрить проактивное делегирование, включите фразы вроде "use proactively" в поле описания вашего подагента.

862 866

863Держите описания краткими: Claude Code показывает предупреждение при запуске, когда объединённые описания ваших subagents превышают [лимит в 15 000 токенов](/docs/ru/errors#agent-descriptions-are-over-the-15000-token-limit), и всё ещё загружает каждый subagent.867Держите описания краткими: Claude Code показывает предупреждение при запуске, когда объединённые описания ваших подагентов превышают [лимит в 15 000 токенов](/docs/ru/errors#agent-descriptions-are-over-the-15000-token-limit), и всё равно загружает каждого подагента.

864 868

865Если subagent поставляется в [plugin](/docs/ru/plugins/overview), вы можете измерить, насколько надёжно Claude делегирует ему задачи на реалистичных приглашениях вместо проверки по одному: [`claude plugin eval`](/docs/ru/plugin-evals) запускает каждое приглашение с плагином и без него и оценивает результаты.869Если подагент поставляется в [плагине](/docs/ru/plugins/overview), вы можете измерить, насколько надёжно Claude делегирует ему работу на реалистичных подсказках вместо проверки по одной: [`claude plugin eval`](/docs/ru/plugin-evals) запускает каждую подсказку с плагином и без него и оценивает результаты.

866 870

867<h3 id="invoke-subagents-explicitly">871<h3 id="invoke-subagents-explicitly">

868 Явно вызывайте subagents872 Явное вызывание подагентов

869</h3>873</h3>

870 874

871Когда автоматического делегирования недостаточно, вы можете запросить subagent самостоятельно. Три паттерна переходят от одноразового предложения к сессионному по умолчанию:875Когда автоматического делегирования недостаточно, вы можете запросить подагента самостоятельно. Три паттерна переходят от одноразового предложения к стандарту для всей сессии:

872 876

873* **Естественный язык**: назовите subagent в вашем приглашении; Claude решает, делегировать ли877* **Естественный язык**: назовите подагента в вашей подсказке; Claude решает, делегировать ли

874* **@-упоминание**: гарантирует, что subagent запустится для одной задачи878* **@-упоминание**: гарантирует, что подагент запустится для одной задачи

875* **Сессионный уровень**: вся сессия использует системное приглашение, ограничения инструментов и модель этого subagent через флаг `--agent` или параметр `agent`879* **На уровне сессии**: вся сессия использует системный prompt подагента, ограничения инструментов и модель через флаг `--agent` или параметр `agent`

876 880

877Для естественного языка нет специального синтаксиса. Назовите subagent и Claude обычно делегирует:881Для естественного языка нет специального синтаксиса. Назовите подагента и Claude обычно делегирует:

878 882

879```text wrap theme={null}883```text wrap theme={null}

880Use the test-runner subagent to fix failing tests884Use the test-runner subagent to fix failing tests

881Have the code-reviewer subagent look at my recent changes885Have the code-reviewer subagent look at my recent changes

882```886```

883 887

884**@-упомяните subagent.** Введите `@` и выберите subagent из автодополнения, так же как вы упоминаете файлы. Это гарантирует, что запустится конкретный subagent, а не оставляет выбор Claude:888**@-упомяните подагента.** Введите `@` и выберите подагента из выпадающего списка, так же как вы упоминаете файлы. Это гарантирует, что запустится конкретный подагент, а не оставляет выбор Claude:

885 889

886```text wrap theme={null}890```text wrap theme={null}

887@"code-reviewer (agent)" look at the auth changes891@"code-reviewer (agent)" look at the auth changes

888```892```

889 893

890Ваше полное сообщение по-прежнему идёт Claude, который пишет приглашение задачи subagent на основе того, что вы попросили. @-упоминание контролирует, какой subagent Claude вызывает, а не какое приглашение он получает.894Ваше полное сообщение всё равно идёт к Claude, который пишет prompt задачи подагента на основе того, что вы попросили. @-упоминание контролирует, какой подагент Claude вызывает, а не какой prompt он получает.

891 895

892Subagents, предоставленные включённым [plugin](/docs/ru/plugins/overview), появляются в автодополнении под их именем с областью видимости, например `my-plugin:code-reviewer` или `my-plugin:review:security`, когда plugin [организует агентов в подпапки](#choose-the-subagent-scope). Именованные фоновые subagents, в настоящее время работающие в сессии, также появляются в автодополнении, показывая их статус рядом с именем.896Подагенты, предоставляемые включённым [плагином](/docs/ru/plugins/overview), появляются в выпадающем списке под их scoped именем, например `my-plugin:code-reviewer` или `my-plugin:review:security` когда плагин [организует агентов в подпапки](#choose-the-subagent-scope). Именованные фоновые подагенты, в настоящий момент работающие в сессии, также появляются в выпадающем списке, показывая их статус рядом с именем.

893 897

894Вы также можете ввести упоминание вручную без использования средства выбора: `@agent-<name>` для локальных subagents или `@agent-` с последующим именем с областью видимости для plugin subagents, например `@agent-my-plugin:code-reviewer`. Пока вы вводите эту форму, автодополнение показывает совпадения файлов, а не агентов. Упоминание агента всё ещё разрешается при отправке.898Вы также можете ввести упоминание вручную без использования выбирателя: `@agent-<name>` для локальных подагентов или `@agent-` с последующим scoped именем для подагентов плагина, например `@agent-my-plugin:code-reviewer`. Пока вы вводите эту форму, выпадающий список показывает совпадения файлов, а не агентов. Упоминание агента всё равно разрешится при отправке.

895 899

896**Запустите всю сессию как subagent.** Передайте [`--agent <name>`](/docs/ru/cli-reference) для запуска сессии, где основной поток сам принимает системное приглашение, ограничения инструментов и модель этого subagent:900**Запустите всю сессию как подагента.** Передайте [`--agent <name>`](/docs/ru/cli-reference) чтобы запустить сессию, где основной поток сам принимает системный prompt подагента, ограничения инструментов и модель:

897 901

898```bash theme={null}902```bash theme={null}

899claude --agent code-reviewer903claude --agent code-reviewer

900```904```

901 905

902Системное приглашение subagent полностью заменяет системное приглашение Claude Code по умолчанию, так же как [`--system-prompt`](/docs/ru/cli-reference) это делает. Файлы `CLAUDE.md` и память проекта по-прежнему загружаются через обычный поток сообщений, даже когда определение агента устанавливает [`omitClaudeMd`](#supported-frontmatter-fields).906Если agent's [prompt не пуст](#choose-the-subagent-scope), системный prompt подагента полностью заменяет стандартный системный prompt Claude Code, так же как [`--system-prompt`](/docs/ru/cli-reference) это делает. Файлы `CLAUDE.md` и память проекта всё равно загружаются через обычный поток сообщений, даже когда определение агента устанавливает [`omitClaudeMd`](#supported-frontmatter-fields).

903 907

904Имя агента появляется как `@<name>` в заголовке запуска, чтобы вы могли подтвердить, что он активен.908Имя агента появляется как `@<name>` в заголовке при запуске, чтобы вы могли подтвердить, что он активен.

905 909

906Это работает с встроенными и пользовательскими subagents, и выбор сохраняется при возобновлении сессии: Claude Code восстанавливает ограничения инструментов и модель агента вместе с разговором. Если агент больше не существует при возобновлении, сессия продолжается с инструментами по умолчанию и показывает [предупреждение с названием агента](/docs/ru/errors#session-agent-no-longer-available). Для системного приглашения в любом случае см. [System prompt flags in resumed conversations](/docs/ru/cli-reference#system-prompt-flags-in-resumed-conversations).910Это работает с встроенными и пользовательскими подагентами, и выбор сохраняется при возобновлении сессии: Claude Code восстанавливает ограничения инструментов и модель агента вместе с разговором. Если агент больше не существует при возобновлении, сессия продолжается со стандартными инструментами и показывает [предупреждение с именем агента](/docs/ru/errors#session-agent-no-longer-available). Для системного prompt в обоих случаях см. [Флаги системного prompt в возобновлённых разговорах](/docs/ru/cli-reference#system-prompt-flags-in-resumed-conversations).

907 911

908Для plugin-предоставленного subagent вы можете передать просто имя агента и Claude Code найдёт его:912Для подагента, предоставляемого плагином, вы можете передать только имя агента и Claude Code найдёт его:

909 913

910```bash theme={null}914```bash theme={null}

911claude --agent security-reviewer915claude --agent security-reviewer

912```916```

913 917

914Если несколько plugins предоставляют агентов с одинаковым именем, передайте имя с областью видимости для уточнения:918Если несколько плагинов предоставляют агентов с одинаковым именем, передайте scoped имя для уточнения:

915 919

916```bash theme={null}920```bash theme={null}

917claude --agent my-plugin:security-reviewer921claude --agent my-plugin:security-reviewer

918```922```

919 923

920Если plugin размещает агента в подпапке своей директории `agents/`, включите подпапку в имя с областью видимости, например `claude --agent my-plugin:review:security`.924Если плагин размещает агента в подпапке своей директории `agents/`, включите подпапку в scoped имя, например `claude --agent my-plugin:review:security`.

921 925

922Чтобы сделать это по умолчанию для каждой сессии в проекте, установите `agent` в `.claude/settings.json`:926Чтобы сделать это стандартом для каждой сессии в проекте, установите `agent` в `.claude/settings.json`:

923 927

924```json theme={null}928```json theme={null}

925{929{

930Флаг CLI переопределяет параметр, если оба присутствуют.934Флаг CLI переопределяет параметр, если оба присутствуют.

931 935

932<h3 id="run-subagents-in-foreground-or-background">936<h3 id="run-subagents-in-foreground-or-background">

933 Запустите subagents в переднем плане или фоне937 Запуск подагентов на переднем плане или в фоне

934</h3>938</h3>

935 939

936Subagents могут работать в переднем плане или фоне:940Подагенты могут работать на переднем плане или в фоне:

937 941

938* **Foreground subagents** блокируют основной разговор до завершения. Запросы разрешений передаются вам по мере их возникновения.942* **Подагенты на переднем плане** блокируют основной разговор до завершения. Подсказки разрешений передаются вам по мере их появления.

939* **Background subagents** работают параллельно, пока вы продолжаете работать. Когда фоновый subagent достигает вызова инструмента, требующего разрешения, Claude Code выводит приглашение в вашу основную сессию и называет subagent, который спрашивает. Одобрите, чтобы позволить subagent продолжить, или нажмите Esc, чтобы отклонить этот вызов инструмента без остановки subagent.943* **Фоновые подагенты** работают одновременно, пока вы продолжаете работать. Когда фоновый подагент достигает вызова инструмента, требующего разрешения, Claude Code выводит подсказку в вашу основную сессию и называет подагента, который спрашивает. Одобрите, чтобы позволить подагенту продолжить, или нажмите Esc, чтобы отклонить этот вызов инструмента без остановки подагента.

940 944

941Для каждого subagent, который Claude порождает с помощью инструмента Agent, Claude Code выбирает передний план или фон из первого из этих случаев, который применяется:945Для каждого подагента, который Claude порождает с помощью инструмента Agent, Claude Code выбирает передний план или фон из первого из этих случаев, который применяется:

942 946

943* Если товарищ [agent team](/docs/ru/agent-teams#limitations) в процессе порождает subagent, Claude Code запускает его в переднем плане. Claude Code отказывает с ошибкой при попытке порождения subagent товарища, чьё определение устанавливает [`background: true`](#supported-frontmatter-fields). Где [fork mode](#turn-fork-mode-on-or-off) отключен и вы не [отключили фоновые задачи](/docs/ru/env-vars), Claude Code также отказывает с ошибкой, когда товарищ устанавливает `run_in_background: true`.947* Если товарищ по команде [команды агентов](/docs/ru/agent-teams#limitations) в процессе породил подагента, Claude Code запускает его на переднем плане. Claude Code отказывает с ошибкой при попытке породить подагента товарища, чьё определение устанавливает [`background: true`](#supported-frontmatter-fields). Где [режим fork](#turn-fork-mode-on-or-off) отключён и вы не [отключили фоновые задачи](/docs/ru/env-vars), Claude Code также отказывает с ошибкой, когда товарищ устанавливает `run_in_background: true`.

944* Если вы установили [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/ru/env-vars) на `1`, Claude Code запускает subagent в переднем плане в каждом виде сессии и независимо от того, включен ли fork mode.948* Если вы установили [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/ru/env-vars) на `1`, Claude Code запускает подагента на переднем плане в каждом виде сессии и независимо от того, включён ли режим fork.

945* Где [fork mode](#turn-fork-mode-on-or-off) включен, как это по умолчанию в интерактивной сессии, Claude Code запускает subagent в фоне, как fork, так и non-fork subagents, и Claude не может просить передний план.949* Где [режим fork](#turn-fork-mode-on-or-off) включён, как это по умолчанию в интерактивной сессии, Claude Code запускает подагента в фоне, как fork, так и non-fork подагентов, и Claude не может просить передний план.

946* Где fork mode отключен, Claude запускает subagent в фоне по умолчанию и в переднем плане, когда ему нужен результат перед продолжением. Fork mode отключен в [non-interactive mode](/docs/ru/headless) с `-p` и в Agent SDK, если вы его не включите. Чтобы держать конкретный subagent в фоне даже когда Claude хочет результат, установите его frontmatter поле [`background`](#supported-frontmatter-fields) на `true`.950* Где режим fork отключён, Claude запускает подагента в фоне по умолчанию и на переднем плане, когда ему нужен результат перед продолжением. Режим fork отключён в [неинтерактивном режиме](/docs/ru/headless) с `-p` и в Agent SDK, если вы его не включите. Чтобы держать конкретный подагента в фоне даже когда Claude хочет результат, установите его frontmatter поле [`background`](#supported-frontmatter-fields) на `true`.

947 951

948Для навыка с `context: fork`, Claude Code следует правилам в [Run skills in a subagent](/docs/ru/skills#run-skills-in-a-subagent) вместо этого, независимо от того, включен ли fork mode.952Для skill с `context: fork`, Claude Code следует правилам в [Запуск skills в подагенте](/docs/ru/skills#run-skills-in-a-subagent) вместо этого, включён ли режим fork или нет.

949 953

950Фоновые subagents работают с [меньшим встроенным набором инструментов](#available-tools), чем foreground subagents, за исключением conversation forks и [возобновленных](#resume-subagents) foreground subagents.954Фоновые подагенты работают с [меньшим встроенным набором инструментов](#available-tools), чем подагенты на переднем плане, за исключением conversation forks и [возобновлённых](#resume-subagents) подагентов на переднем плане.

951 955

952Фоновые subagents выводят каждый запрос разрешения в вашу основную сессию. Когда вы ответите на один из этих запросов выбором, который длится дольше этого одного вызова инструмента, например грантом, который длится для остальной сессии, Claude Code применяет ваш ответ ко всей сессии, включая ваш основной разговор.956Фоновые подагенты выводят каждую подсказку разрешения в вашу основную сессию. Когда вы отвечаете на одну из этих подсказок выбором, который длится дольше этого одного вызова инструмента, например разрешением, которое длится всю сессию, Claude Code применяет ваш ответ ко всей сессии, включая ваш основной разговор.

953 957

954Фоновый subagent может оставить фоновую [Bash или PowerShell команду](/docs/ru/tools-reference#background-commands) [работающей после конца его хода](/docs/ru/interactive-mode#how-backgrounding-works). Когда эта команда заканчивается, Claude Code отправляет subagent уведомление.958Фоновый подагент может оставить фоновую [команду Bash или PowerShell](/docs/ru/tools-reference#background-commands) [работающей после конца его хода](/docs/ru/interactive-mode#how-backgrounding-works). Когда эта команда завершится, Claude Code отправляет подагенту уведомление.

955 959

956Результаты фонового subagent достигают Claude как уведомление о завершении в более позднем ходе. Claude ждёт этого уведомления перед тем, как сообщить результаты subagent, и если вы сначала спросите о прогрессе, он сообщает, что subagent всё ещё работает. До v2.1.211 Claude иногда сообщал результаты для фонового subagent, который не закончил.960Результаты фонового подагента достигают Claude как уведомление о завершении в более позднем ходе. Claude ждёт этого уведомления перед тем, как сообщить результаты подагента, и если вы сначала спросите о прогрессе, он сообщит, что подагент всё ещё работает. До v2.1.211 Claude иногда сообщал результаты для фонового подагента, который не закончил.

957 961

958Вы также можете управлять этим самостоятельно:962Вы также можете управлять этим самостоятельно:

959 963

960* Где fork mode отключен, попросите Claude запустить задачу в фоне или в переднем плане964* Где режим fork отключён, попросите Claude запустить задачу в фоне или на переднем плане

961* Нажмите **Ctrl+B** для фонового выполнения работающей задачи965* Нажмите **Ctrl+B** чтобы отправить работающую задачу в фон

962 966

963Claude Code очищает строку фонового subagent из панели subagent ниже ввода приглашения одним из двух способов, в зависимости от того, как закончился subagent:967Claude Code очищает строку фонового подагента из панели подагентов ниже ввода prompt одним из двух способов, в зависимости от того, как закончился подагент:

964 968

965* Когда subagent завершается успешно, Claude Code удаляет его строку немедленно и, кроме как в [screen reader mode](/docs/ru/accessibility), показывает `/tasks to see subagents` в нижнем колонтитуле в течение 30 секунд. В течение этих 30 секунд запустите [`/tasks`](/docs/ru/commands) и нажмите `Enter` на subagent, чтобы открыть его транскрипт. До v2.1.232 Claude Code держал строку в течение 30 секунд после завершения subagent, так же как неудачный, и не показывал подсказку нижнего колонтитула.969* Когда подагент завершается успешно, Claude Code удаляет его строку немедленно и, кроме как в [режиме чтения с экрана](/docs/ru/accessibility), показывает `/tasks to see subagents` в нижней части на 30 секунд. В течение этих 30 секунд запустите [`/tasks`](/docs/ru/commands) и нажмите `Enter` на подагенте, чтобы открыть его транскрипт. До v2.1.232 Claude Code держал строку 30 секунд после завершения подагента, так же как неудачный, и не показывал подсказку в нижней части.

966* Когда subagent не удаётся или вы его остановили, Claude Code держит его строку в течение 30 секунд. Чтобы очистить строку раньше, выберите её и нажмите `x`.970* Когда подагент не удаётся или вы его останавливаете, Claude Code держит его строку 30 секунд. Чтобы очистить строку раньше, выберите её и нажмите `x`.

967 971

968Фоновый subagent, который завершается, остаётся в списке [`/tasks`](/docs/ru/commands), отмечен как выполненный и отсортирован ниже работающих задач, в течение тех же 30 секунд, что и подсказка нижнего колонтитула. Его представление деталей остаётся открытым, когда subagent завершается. Subagents, которые не удаются или которые вы остановили, покидают список. До v2.1.208 завершённый subagent покидал список в момент завершения и его представление деталей закрывалось.972Фоновый подагент, который завершается, остаётся в списке [`/tasks`](/docs/ru/commands), отмечен как выполненный и отсортирован ниже работающих задач, на те же 30 секунд, что и подсказка в нижней части. Его представление деталей остаётся открытым, когда подагент завершается. Подагенты, которые не удаются или которых вы останавливаете, покидают список. До v2.1.208 завершённый подагент покидал список в момент завершения и его представление деталей закрывалось.

969 973

970<h3 id="subagent-names">974<h3 id="subagent-names">

971 Имена Subagent975 Имена подагентов

972</h3>976</h3>

973 977

974Claude может дать subagent имя, передав параметр `name` при вызове инструмента Agent, и может сделать это самостоятельно, без предварительного спроса. Имя делает subagent адресуемым: Claude может [отправить сообщение или возобновить его по имени](#resume-subagents) после завершения.978Claude может дать подагенту имя, передав параметр `name` при вызове инструмента Agent, и может сделать это самостоятельно, без предварительного спроса у вас. Имя делает подагента адресуемым: Claude может [отправить ему сообщение или возобновить его по имени](#resume-subagents) после завершения.

975 979

976В интерактивной сессии с включенными [agent teams](/docs/ru/agent-teams), subagent, который Claude порождает из основного разговора с `name`, запускается как товарищ вместо этого, если только вызов не является [fork](#fork-the-current-conversation) или не передаёт `isolation` при самом вызове. Значение `isolation` в frontmatter subagent не предотвращает это, и товарищ затем работает в рабочей директории основной сессии. См. [How Claude starts agent teams](/docs/ru/agent-teams#how-claude-starts-agent-teams).980В интерактивной сессии с включёнными [командами агентов](/docs/ru/agent-teams), подагент, который Claude порождает из основного разговора с `name`, запускается как товарищ вместо этого, если только вызов не является [fork](#fork-the-current-conversation) или не передаёт `isolation` при самом вызове. Значение `isolation` в frontmatter подагента не предотвращает это, и товарищ затем работает в рабочей директории основной сессии. См. [Как Claude запускает команды агентов](/docs/ru/agent-teams#how-claude-starts-agent-teams).

977 981

978<h3 id="api-errors-in-subagents">982<h3 id="api-errors-in-subagents">

979 Ошибки API в subagents983 Ошибки API в подагентах

980</h3>984</h3>

981 985

982Когда что-то [прерывает ответ subagent в середине потока](/docs/ru/errors#the-response-above-may-be-incomplete), и частичный ответ содержит текст, но не вызовы инструментов, Claude Code приглашает subagent продолжить, а не заканчивать запуск. Это происходит и в интерактивных сессиях. Запуск заканчивается на ошибке только после того, как эти продолжения исчерпаны.986Когда что-то [прерывает ответ подагента в середине потока](/docs/ru/errors#the-response-above-may-be-incomplete), и частичный ответ содержит текст, но не вызовы инструментов, Claude Code подсказывает подагенту продолжить, а не заканчивать запуск. Это происходит и в интерактивных сессиях. Запуск заканчивается на ошибке только после того, как эти продолжения исчерпаны.

983 987

984Начиная с v2.1.199, subagent, чей запуск заканчивается ошибкой API, такой как лимит использования или повторяющаяся ошибка сервера, сообщает об этом отказе Claude вместо возврата текста ошибки, как если бы это были результаты subagent. То, что получает Claude, зависит от того, где работал subagent:988Начиная с v2.1.199, подагент, чей запуск заканчивается на ошибке API, такой как лимит использования или повторяющаяся ошибка сервера, сообщает об этом отказе обратно Claude вместо возврата текста ошибки, как если бы это были выводы подагента. То, что получает Claude, зависит от того, где работал подагент:

985 989

986* **Foreground**: если лимит скорости, перегрузка или ошибка сервера прерывает subagent, который уже произвёл текстовый выход, инструмент Agent возвращает этот частичный выход с примечанием, что subagent был прерван и не завершил свою задачу. Subagent, который не произвёл ничего, или чьим единственным выходом были вызовы инструментов, завершается с ошибкой [`Agent terminated early due to an API error`](/docs/ru/errors#agent-terminated-early-due-to-an-api-error), за которой следует деталь ошибки. В v2.1.199 лимит скорости, перегрузка или ошибка сервера, которые прервали форму, содержащую только вызовы инструментов, возвращали пустой частичный результат, содержащий только примечание об отключении вместо этого.990* **Передний план**: если лимит скорости, перегрузка или ошибка сервера прерывает подагента, который уже произвёл текстовый вывод, инструмент Agent возвращает этот частичный вывод с примечанием, что подагент был прерван и не завершил свою задачу. Подагент, который ничего не произвёл или чей единственный вывод был вызовами инструментов, не удаётся с [`Agent terminated early due to an API error`](/docs/ru/errors#agent-terminated-early-due-to-an-api-error), за которым следует деталь ошибки. В v2.1.199 лимит скорости, перегрузка или ошибка сервера, которые прерывали форму только вызовов инструментов, возвращали пустой частичный результат, содержащий только примечание о прерывании вместо этого.

987* **Background**: subagent помечается как неудачный, и сообщение, которое Claude получает при завершении, называет ошибку API и включает последний выход subagent, поэтому частичная работа не теряется.991* **Фон**: подагент отмечен как неудачный, и сообщение, которое Claude получает при завершении, называет ошибку API и включает последний вывод подагента, поэтому частичная работа не теряется.

988 992

989Когда вы конфигурируете [fallback model chain](/docs/ru/model-config#fallback-model-chains) и subagent встречает отказ, который цепь покрывает, такой как недоступность его модели, Claude Code переключает subagent на первую модель в цепи, которая принимает запрос. Subagent продолжает работать вместо завершения на ошибке.993Когда вы настраиваете [цепочку резервных моделей](/docs/ru/model-config#fallback-model-chains) и подагент встречает отказ, который цепочка охватывает, например его модель недоступна, Claude Code переключает подагента на первую модель в цепочке, которая принимает запрос. Подагент продолжает работать вместо того, чтобы заканчиваться на ошибке.

990 994

991После того как основная ошибка API исчезнет, попросите Claude повторить задачу или [возобновить subagent](#resume-subagents).995Как только основная ошибка API очищается, попросите Claude повторить задачу или [возобновить подагента](#resume-subagents).

992 996

993<h3 id="subagent-output-scanning">997<h3 id="subagent-output-scanning">

994 Сканирование выхода Subagent998 Сканирование выходных данных подагента

995</h3>999</h3>

996 1000

997Claude Code сканирует финальный отчёт каждого subagent перед тем, как Claude его прочитает. Subagent может прочитать файлы, веб-страницы или выход команды, которые вы никогда не проверяли, и текст из этих источников может содержать инструкции, направленные на основной разговор. Сканирование никогда не удаляет и не переформулирует ничего; оно делает два вида изменений, которые вы можете заметить в отчёте:1001Claude Code сканирует финальный отчёт каждого подагента перед тем, как Claude его прочитает. Подагент мог прочитать файлы, веб-страницы или вывод команд, которые вы никогда не проверяли, и текст из этих источников может содержать инструкции, направленные на основной разговор. Сканирование никогда не удаляет и не переформулирует ничего; оно делает два вида изменений, которые вы можете заметить в отчёте:

998 1002

999* **Вставка обратной косой черты**: сканирование вставляет обратную косую черту в текст, который имитирует собственный выход Claude Code, такой как тег `<system-reminder>` или строка, начинающаяся с `Human:` или `Assistant:`, так что имитация читается как обычный текст вместо того, чтобы быть ошибочно принятой за часть разговора.1003* **Вставка обратной косой черты**: сканирование вставляет обратную косую черту в текст, который имитирует собственный вывод Claude Code, такой как тег `<system-reminder>` или строка, начинающаяся с `Human:` или `Assistant:`, чтобы имитация читалась как обычный текст вместо того, чтобы быть ошибочно принятой за часть разговора.

1000* **Строка маркера**: сканирование добавляет строку, начинающуюся с `[harness: subagent output matched instruction-shaped pattern(s):`, когда отчёт имитирует тег вроде `<system-reminder>` или упоминает параметры разрешения такие как `bypassPermissions` или `--dangerously-skip-permissions`. Упоминания параметров разрешения получают строку маркера, но сам текст остаётся как написано.1004* **Строка маркера**: сканирование добавляет строку, начинающуюся с `[harness: subagent output matched instruction-shaped pattern(s):` когда отчёт имитирует тег вроде `<system-reminder>` или упоминает параметры разрешения такие как `bypassPermissions` или `--dangerously-skip-permissions`. Упоминания параметров разрешения получают строку маркера, но сам текст остаётся как написано.

1001 1005

1002Сканирование не судит, является ли содержание вредоносным, и оно не изменяет то, что инструкция в отчёте может сделать: вызов инструмента, который отчёт приводит Claude к выполнению, всё ещё проходит через [проверки разрешений](/docs/ru/permissions) сессии и [sandboxing](/docs/ru/sandboxing). Это не замена для [ограничения того, что может достичь subagent](#control-subagent-capabilities).1006Сканирование не судит, является ли содержимое вредоносным, и оно не меняет то, что инструкция в отчёте может сделать: вызов инструмента, который отчёт приводит Claude к выполнению, всё равно проходит через [проверки разрешений](/docs/ru/permissions) сессии и [sandboxing](/docs/ru/sandboxing). Это не замена [ограничению того, что подагент может достичь](#control-subagent-capabilities).

1003 1007

1004Отчёт, который возвращается Claude как результат subagent, также прибывает под заголовком, отмечающим его как выход subagent. Заголовок указывает, что инструкции или утверждения об одобрении внутри отчёта — это слова subagent и не несут никакого авторитета от вас.1008Отчёт, который возвращается к Claude как результат подагента, также прибывает под заголовком, отмечающим его как выходные данные подагента. Заголовок указывает, что инструкции или утверждения одобрения внутри отчёта — это слова подагента и не несут никакого авторитета от вас.

1005 1009

1006Отчёт [фонового subagent](#run-subagents-in-foreground-or-background) прибывает внутри уведомления о завершении, которое отмечается как автоматизированное событие, а не сообщение от вас.1010[Отчёт фонового подагента](#run-subagents-in-foreground-or-background) прибывает внутри уведомления о завершении, которое отмечено как автоматизированное событие, а не сообщение от вас.

1007 1011

1008<Note>1012<Note>

1009 Сканирование выхода Subagent требует Claude Code v2.1.210 или позже.1013 Сканирование выходных данных подагента требует Claude Code v2.1.210 или позже.

1010</Note>1014</Note>

1011 1015

1012<h3 id="common-patterns">1016<h3 id="common-patterns">

1013 Распространённые паттерны1017 Общие паттерны

1014</h3>1018</h3>

1015 1019

1016<h4 id="isolate-high-volume-operations">1020<h4 id="isolate-high-volume-operations">

1017 Изолируйте высокообъёмные операции1021 Изолируйте высокообъёмные операции

1018</h4>1022</h4>

1019 1023

1020Одно из наиболее эффективных применений subagents — изоляция операций, которые производят большой объём выходных данных. Запуск тестов, получение документации или обработка файлов журналов может потребить значительный контекст. Делегируя эти операции subagent, подробный выход остаётся в контексте subagent, пока только релевантное резюме возвращается в основной разговор.1024Одно из наиболее эффективных применений подагентов — изоляция операций, которые производят большие объёмы вывода. Запуск тестов, получение документации или обработка файлов логов может потребить значительный контекст. Делегируя это подагентам, многословный вывод остаётся в контексте подагента, пока только релевантное резюме возвращается в ваш основной разговор.

1021 1025

1022```text wrap theme={null}1026```text wrap theme={null}

1023Use a subagent to run the test suite and report only the failing tests with their error messages1027Use a subagent to run the test suite and report only the failing tests with their error messages

1027 Запустите параллельное исследование1031 Запустите параллельное исследование

1028</h4>1032</h4>

1029 1033

1030Для независимых исследований порождайте несколько subagents для одновременной работы:1034Для независимых расследований порождайте несколько подагентов для одновременной работы:

1031 1035

1032```text wrap theme={null}1036```text wrap theme={null}

1033Research the authentication, database, and API modules in parallel using separate subagents1037Research the authentication, database, and API modules in parallel using separate subagents

1034```1038```

1035 1039

1036Каждый subagent исследует свою область независимо, затем Claude синтезирует результаты. Это работает лучше всего, когда пути исследования не зависят друг от друга.1040Каждый подагент исследует свою область независимо, затем Claude синтезирует выводы. Это работает лучше всего, когда пути исследования не зависят друг от друга.

1037 1041

1038<Warning>1042<Warning>

1039 Когда subagents завершаются, их результаты возвращаются в основной разговор. Запуск многих subagents, каждый из которых возвращает подробные результаты, может потребить значительный контекст.1043 Когда подагенты завершаются, их результаты возвращаются в ваш основной разговор. Запуск многих подагентов, которые каждый возвращает подробные результаты, может потребить значительный контекст, и каждый подагент тратит свои токены, пока работает.

1040</Warning>1044</Warning>

1041 1045

1042Для работы, которая должна продолжать работать параллельно или не поместится в одно контекстное окно, запустите её в [отдельных сессиях](/docs/ru/agents) и позвольте Claude [передавать результаты между ними](/docs/ru/cross-session-messaging).1046Для работы, которая должна продолжать работать параллельно или не поместится в одно окно контекста, запустите её в [отдельных сессиях](/docs/ru/agents) и позвольте Claude [передавать выводы между ними](/docs/ru/cross-session-messaging).

1043 1047

1044<h4 id="chain-subagents">1048<h4 id="chain-subagents">

1045 Цепочка subagents1049 Цепочка подагентов

1046</h4>1050</h4>

1047 1051

1048Для многошаговых рабочих процессов попросите Claude использовать subagents последовательно. Каждый subagent завершает свою задачу и возвращает результаты Claude, который затем передаёт релевантный контекст следующему subagent.1052Для многошаговых рабочих процессов попросите Claude использовать подагентов последовательно. Каждый подагент завершает свою задачу и возвращает результаты Claude, который затем передаёт релевантный контекст следующему подагенту.

1049 1053

1050```text wrap theme={null}1054```text wrap theme={null}

1051Use the code-reviewer subagent to find performance issues, then use the optimizer subagent to fix them1055Use the code-reviewer subagent to find performance issues, then use the optimizer subagent to fix them

1052```1056```

1053 1057

1054<h3 id="choose-between-subagents-and-main-conversation">1058<h3 id="choose-between-subagents-and-main-conversation">

1055 Выберите между subagents и основным разговором1059 Выбор между подагентами и основным разговором

1056</h3>1060</h3>

1057 1061

1058Используйте **основной разговор** когда:1062Используйте **основной разговор** когда:

1059 1063

1060* Задача требует частого взаимодействия или итеративного уточнения1064* Задача требует частого взаимодействия или итеративного уточнения

1061* Несколько фаз имеют значительный общий контекст, такие как планирование, реализация и тестирование1065* Несколько фаз делят значительный контекст, такой как планирование, реализация и тестирование

1062* Вы вносите быстрое, целевое изменение1066* Вы делаете быстрое, целевое изменение

1063* Задержка имеет значение. Subagent, который не является [fork](#fork-the-current-conversation), начинает с нуля и может потребовать время для сбора контекста1067* Задержка имеет значение. Подагент, который не является [fork](#fork-the-current-conversation), начинает с нуля и может потребовать время для сбора контекста

1064 1068

1065Используйте **subagents** когда:1069Используйте **подагентов** когда:

1066 1070

1067* Задача производит подробный выход, который вам не нужен в основном контексте1071* Задача производит многословный вывод, который вам не нужен в вашем основном контексте

1068* Вы хотите применить конкретные ограничения инструментов или разрешений1072* Вы хотите применить конкретные ограничения инструментов или разрешения

1069* Работа самодостаточна и может вернуть резюме1073* Работа самодостаточна и может вернуть резюме

1070 1074

1071Рассмотрите [Skills](/docs/ru/skills) вместо этого, когда вы хотите переиспользуемые приглашения или рабочие процессы, которые работают в контексте основного разговора, а не в изолированном контексте subagent.1075Рассмотрите [Skills](/docs/ru/skills) вместо этого, когда вы хотите переиспользуемые prompts или рабочие процессы, которые работают в контексте основного разговора, а не в изолированном контексте подагента.

1072 1076

1073Для быстрого вопроса о чём-то уже в вашем разговоре используйте [`/btw`](/docs/ru/interactive-mode#side-questions-with-%2Fbtw) вместо subagent. Он видит ваш полный контекст, но не имеет доступа к инструментам, и ответ не добавляется в историю.1077Для вопроса о чём-то уже в вашем разговоре используйте [`/btw`](/docs/ru/interactive-mode#side-questions-with-%2Fbtw) вместо подагента. Он видит ваш полный контекст, но не имеет доступа к инструментам, и ответ не добавляется в историю.

1074 1078

1075<h3 id="let-subagents-spawn-their-own-subagents">1079<h3 id="let-subagents-spawn-their-own-subagents">

1076 Позвольте subagents порождать собственные subagents1080 Позвольте подагентам порождать своих собственных подагентов

1077</h3>1081</h3>

1078 1082

1079По умолчанию subagent может порождать subagents собственные, вплоть до трёх слоёв ниже основного разговора. На лимите глубины Claude Code удерживает инструмент `Agent` от каждого subagent, кроме [fork](#fork-the-current-conversation), поэтому subagent на лимите выполняет свою делегированную работу сам и возвращает одно резюме. Fork на лимите сохраняет `Agent` в своём унаследованном списке инструментов, но инструмент возвращает ошибку вместо порождения.1083По умолчанию подагент может порождать подагентов своих собственных, вплоть до трёх слоёв ниже основного разговора. На пределе глубины, Claude Code удерживает инструмент `Agent` от каждого подагента, кроме [fork](#fork-the-current-conversation), поэтому подагент на пределе выполняет свою делегированную работу сам и возвращает одно резюме. Fork на пределе держит `Agent` в своём унаследованном списке инструментов, но инструмент возвращает ошибку вместо порождения.

1080 1084

1081Вложенные subagents подходят для делегированной задачи, которая сама разбивается на параллельные подзадачи, такие как subagent-рецензент, который отправляет верификатор для каждого обнаружения. В интерактивной сессии только резюме subagent верхнего уровня возвращается вам и промежуточный выход остаётся вне вашего основного разговора: subagent, который запускает фоновые subagents, ждёт их результатов перед завершением. В [non-interactive mode](/docs/ru/headless) и Agent SDK запускающий subagent не ждёт, поэтому вложенный фоновый subagent, который завершается после того, как его запускатель закончился, сообщает вашему основному разговору вместо этого.1085Вложенные подагенты подходят для делегированной задачи, которая сама разбивается на параллельные подзадачи, такие как подагент рецензента, который отправляет верификатора на каждый вывод. В интерактивной сессии только резюме подагента верхнего уровня возвращается вам и промежуточный вывод остаётся вне вашего основного разговора: подагент, который запускает фоновые подагенты, ждёт их результатов перед завершением. В [неинтерактивном режиме](/docs/ru/headless) и Agent SDK, запускающий подагент не ждёт, поэтому вложенный фоновый подагент, который завершается после того, как его запускатель закончился, сообщает в ваш основной разговор вместо этого.

1082 1086

1083Чтобы изменить лимит, установите [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/ru/env-vars) на количество слоёв subagent, которые вы хотите ниже основного разговора. Например, эта запись в [`settings.json`](/docs/ru/settings) ограничивает вложение двумя слоями:1087Чтобы изменить лимит, установите [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/ru/env-vars) на количество слоёв подагентов, которые вы хотите ниже вашего основного разговора. Например, эта запись в [`settings.json`](/docs/ru/settings) ограничивает вложение двумя слоями:

1084 1088

1085```json theme={null}1089```json theme={null}

1086{1090{

1090}1094}

1091```1095```

1092 1096

1093С этим значением ваши subagents могут делегировать второму слою своих собственных, и этот второй слой не может делегировать дальше. Установите `1` для отключения вложения.1097С этим значением ваши подагенты могут делегировать второму слою своих собственных, и этот второй слой не может делегировать дальше. Установите `1` чтобы отключить вложение.

1094 1098

1095Вложенный subagent конфигурируется так же, как subagent верхнего уровня и разрешается из тех же [областей видимости](#choose-the-subagent-scope). Чтобы предотвратить порождение одного subagent, пока вложение включено, такой как рецензент, который должен оставаться только для чтения, опустите `Agent` из его списка [`tools`](#available-tools) или добавьте его в `disallowedTools`.1099Вложенный подагент настраивается так же, как подагент верхнего уровня и разрешается из тех же [scopes](#choose-the-subagent-scope). Чтобы держать один подагента от порождения, пока вложение включено, такой как рецензент, который должен остаться только для чтения, опустите `Agent` из его списка [`tools`](#available-tools) или добавьте его в `disallowedTools`.

1096 1100

1097Claude Code показывает вложенные subagents как дерево в панели subagent ниже ввода приглашения и отмечает каждую строку, которая всё ещё имеет потомков в панели с подсчётом `(+N)` их. Откройте строку, чтобы увидеть братьев и сестёр этого subagent и прямых потомков с путём обратно к `main`.1101В терминале Claude Code показывает вложенные подагенты как дерево в панели подагентов ниже ввода prompt и отмечает каждую строку, которая всё ещё имеет потомков в панели с подсчётом `(+N)` их. Откройте строку, чтобы увидеть товарищей этого подагента и прямых потомков с путём обратно к `main`.

1098 1102

1099<Note>1103<Note>

1100 Более ранние версии использовали разные значения по умолчанию:1104 Более ранние версии использовали разные стандарты:

1101 1105

1102 * **v2.1.172 через v2.1.216**: subagents могли вкладываться по умолчанию, вплоть до пяти слоёв глубины, и лимит не мог быть изменён.1106 * **v2.1.172 через v2.1.216**: подагенты могли вкладываться по умолчанию, вплоть до пяти слоёв глубины, и лимит не мог быть изменён.

1103 * **v2.1.217 через v2.1.218**: лимит по умолчанию был один, поэтому subagent не мог порождать свои собственные, если вы не повысили его; v2.1.219 повысил значение по умолчанию до трёх.1107 * **v2.1.217 через v2.1.218**: лимит по умолчанию был один, поэтому подагент не мог порождать своих собственных, если вы не повысили его; v2.1.219 повысил стандарт до трёх.

1104</Note>1108</Note>

1105 1109

1106<h3 id="concurrent-subagent-limit">1110<h3 id="concurrent-subagent-limit">

1107 Лимит одновременных subagents1111 Лимит одновременных подагентов

1108</h3>1112</h3>

1109 1113

1110Два лимита контролируют использование subagent, каждый со своей собственной переменной: этот останавливает Claude от порождения большего количества subagents, пока слишком много работают, и [лимит глубины](#let-subagents-spawn-their-own-subagents) ограничивает, насколько глубоко вкладываются subagents. Нет лимита на общее количество subagents, которые Claude может порождать в течение сессии.1114Два лимита контролируют использование подагентов, каждый со своей переменной: этот останавливает Claude от порождения большего количества подагентов, пока слишком много работает, и [лимит глубины](#let-subagents-spawn-their-own-subagents) ограничивает, насколько глубоко вкладываются подагенты. Нет лимита на общее количество подагентов, которых Claude может породить за сессию.

1111 1115

1112По умолчанию, когда 20 subagents работают в сессии, порождение другого с инструментом Agent завершается с ошибкой `Concurrent subagent limit reached`, и ошибка говорит Claude не повторять попытку. Порождение снова успешно, когда работающий счётчик падает ниже лимита. Чтобы изменить лимит, установите [`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`](/docs/ru/env-vars) на любое положительное целое число. Сессии с активным [ultracode](/docs/ru/model-config#adjust-effort-level) исключены: лимит не применяется там. Требует Claude Code v2.1.217 или позже.1116По умолчанию, когда 20 подагентов работают в сессии, попытка породить другого с инструментом Agent не удаётся с `Concurrent subagent limit reached`, и ошибка говорит Claude не повторять попытку. Порождение успешно снова, когда работающий счёт падает ниже лимита. Чтобы изменить лимит, установите [`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`](/docs/ru/env-vars) на любое положительное целое число. Сессии с активным [ultracode](/docs/ru/model-config#adjust-effort-level) исключены: лимит не применяется там. Требует Claude Code v2.1.217 или позже.

1113 1117

1114Лимит блокирует только subagents, которые Claude порождает с инструментом Agent, но другие запуски занимают те же слоты:1118Лимит блокирует только подагентов, которых Claude порождает с инструментом Agent, но другие запуски занимают те же слоты:

1115 1119

1116* In-session fork, который вы запускаете с [`/subtask`](#fork-the-current-conversation), занимает слот во время работы и никогда не блокируется лимитом.1120* Внутри сессии fork, который вы запускаете с [`/subtask`](#fork-the-current-conversation), занимает слот, пока работает, и никогда не блокируется лимитом.

1117* [Возобновление subagent](#resume-subagents), который уже завершился, занимает свежий слот без проверки лимита, поэтому возобновления могут толкнуть работающий счётчик выше лимита.1121* [Возобновление подагента](#resume-subagents), который уже завершился, занимает свежий слот без проверки лимита, поэтому возобновления могут толкнуть работающий счёт выше него.

1118 1122

1119Агенты, которых запускают другие функции, такие как [workflow](/docs/ru/workflows) агенты и [agent team](/docs/ru/agent-teams) товарищи, следуют своим собственным лимитам вместо этого.1123Агенты, которых запускают другие функции, такие как [workflow](/docs/ru/workflows) агенты и [команда агентов](/docs/ru/agent-teams) товарищи, следуют своим собственным лимитам вместо этого.

1120 1124

1121<h3 id="manage-subagent-context">1125<h3 id="manage-subagent-context">

1122 Управляйте контекстом subagent1126 Управление контекстом подагента

1123</h3>1127</h3>

1124 1128

1125<h4 id="what-loads-at-startup">1129<h4 id="what-loads-at-startup">

1126 Что загружается при запуске1130 Что загружается при запуске

1127</h4>1131</h4>

1128 1132

1129Каждый subagent начинает со свежего, изолированного контекстного окна. Он не видит историю вашего разговора, навыки, которые вы уже вызвали, или файлы, которые Claude уже прочитал. Claude составляет сообщение делегирования, которое резюмирует задачу, и subagent работает на основе этого. Исключением является [fork](#fork-the-current-conversation), который наследует родительский разговор вместо начала с нуля.1133Каждый подагент начинает с свежего, изолированного окна контекста. Он не видит историю вашего разговора, skills, которые вы уже вызвали, или файлы, которые Claude уже прочитал. Claude составляет сообщение делегирования, которое резюмирует задачу, и подагент работает оттуда. Исключение — это [fork](#fork-the-current-conversation), который наследует родительский разговор вместо начала с нуля.

1130 1134

1131Начальный контекст non-fork subagent содержит:1135Начальный контекст non-fork подагента содержит:

1132 1136

1133* **System prompt**: собственное приглашение агента плюс детали окружения, которые добавляет Claude Code, а не системное приглашение Claude Code. Пользовательские subagents определяют свои в [markdown body](#write-subagent-files) или поле `prompt`. Встроенные агенты имеют предопределённые приглашения.1137* **System prompt**: собственный prompt агента плюс детали окружения, которые Claude Code добавляет, не системный prompt Claude Code. Пользовательские подагенты определяют свои в [теле markdown](#write-subagent-files) или поле `prompt`. Встроенные агенты имеют предопределённые prompts.

1134* **Task message**: приглашение делегирования, которое Claude пишет при передаче работы.1138* **Сообщение задачи**: prompt делегирования, который Claude пишет, когда передаёт работу.

1135* **CLAUDE.md files**: каждый уровень [иерархии CLAUDE.md](/docs/ru/memory#how-claude-md-files-load), который загружает основной разговор, включая `~/.claude/CLAUDE.md`, правила проекта, `CLAUDE.local.md`, управляемые файлы политики и любые [`AGENTS.md` файлы](/docs/ru/memory#agents-md), загруженные как инструкции проекта. Встроенные агенты Explore и Plan пропускают это. Subagent, чьё определение устанавливает [`omitClaudeMd`](#supported-frontmatter-fields), загружает только управляемые файлы политики, или ничего вообще, когда определение поступает из [managed settings](#choose-the-subagent-scope).1139* **Файлы CLAUDE.md**: каждый уровень [иерархии CLAUDE.md](/docs/ru/memory#how-claude-md-files-load), который загружает основной разговор, включая `~/.claude/CLAUDE.md`, правила проекта, `CLAUDE.local.md`, файлы управляемой политики и любые [`AGENTS.md` файлы](/docs/ru/memory#agents-md), загруженные как инструкции проекта. Встроенные агенты Explore и Plan пропускают это. Подагент, чьё определение устанавливает [`omitClaudeMd`](#supported-frontmatter-fields), загружает только файлы управляемой политики или ничего вообще, когда определение приходит из [управляемых параметров](#choose-the-subagent-scope).

1136* **Git status**: снимок, который Claude Code читает из вашего репозитория при запуске subagent. Отсутствует вне Git репозитория или когда снимок отключен; см. [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions). Explore и Plan пропускают это независимо.1140* **Статус Git**: снимок, который Claude Code читает из вашего репозитория, когда подагент запускается. Отсутствует вне Git репозитория или когда снимок отключён; см. [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions). Explore и Plan пропускают его независимо.

1137* **Preloaded skills**: полное содержание любого навыка, названного в поле [`skills`](#preload-skills-into-subagents) агента. Встроенные агенты не предзагружают навыки.1141* **Предзагруженные skills**: полное содержимое любого skill, названного в поле [`skills`](#preload-skills-into-subagents) агента. Встроенные агенты не предзагружают skills.

1138* **Sibling roster**: системное напоминание, в котором перечислены `main` и каждый другой именованный агент в сессии, каждый является допустимым значением `to` для [`SendMessage`](#resume-subagents). Требует Claude Code v2.1.206 или позже. Реестр появляется только когда инструменты subagent включают `SendMessage` и по крайней мере один другой агент имеет имя, независимо от того, назвал ли его Claude при порождении или он работает как товарищ [agent team](/docs/ru/agent-teams). Это снимок, сделанный при запуске subagent, поэтому агенты, названные позже, не появляются.1142* **Список товарищей**: [системное напоминание](/docs/ru/glossary#system-reminder), перечисляющее `main` и каждого другого именованного агента в сессии, каждый действительное значение `to` для [`SendMessage`](#resume-subagents). Требует Claude Code v2.1.206 или позже. Список появляется только когда инструменты подагента включают `SendMessage` и по крайней мере один другой агент имеет имя, будь то Claude назвал его при порождении или он работает как товарищ [команды агентов](/docs/ru/agent-teams). Это снимок, сделанный при запуске подагента, поэтому агенты, названные позже, не появляются.

1139 1143

1140Чтобы запустить один из ваших собственных subagents без файлов пользователя, проекта и локального CLAUDE.md, установите [`omitClaudeMd: true`](#supported-frontmatter-fields) в его frontmatter или `--agents` JSON.1144Чтобы запустить один из ваших собственных подагентов без пользователя, проекта и локальных файлов CLAUDE.md, установите [`omitClaudeMd: true`](#supported-frontmatter-fields) в его frontmatter или `--agents` JSON.

1141 1145

1142Основной разговор по-прежнему имеет ваш полный CLAUDE.md, когда он читает результаты этих subagents, поэтому большинству правил не нужно достигать самого subagent. Если правило должно, такое как "ignore the `vendor/` directory," переформулируйте его в приглашении, которое вы даёте Claude при делегировании.1146Основной разговор всё равно имеет ваш полный CLAUDE.md, когда он читает результаты этих подагентов, поэтому большинство правил не нужно достигать самого подагента. Если правило должно, такое как "ignore the `vendor/` directory," переформулируйте его в prompt, который вы даёте Claude при делегировании.

1143 1147

1144Вы не можете изменить, какие subagents получают статус git. Только Explore и Plan пропускают его.1148Вы не можете изменить, какие подагенты получают статус git. Только Explore и Plan пропускают его.

1145 1149

1146Некоторое состояние основного разговора никогда не достигает non-fork subagent:1150Некоторое состояние основного разговора никогда не достигает non-fork подагента:

1147 1151

1148* **Output style**: subagent запускает собственное системное приглашение, поэтому ваш [output style](/docs/ru/output-styles) не формирует его ответы, кроме как в [fork](#fork-the-current-conversation).1152* **Стиль вывода**: подагент запускает свой собственный system prompt, поэтому ваш [стиль вывода](/docs/ru/output-styles) не формирует его ответы, кроме как в [fork](#fork-the-current-conversation).

1149* **Auto memory**: [auto memory](/docs/ru/memory#auto-memory) основного разговора не загружается. Чтобы дать subagent собственную постоянную память, используйте поле [`memory`](#enable-persistent-memory).1153* **Автоматическая память**: [автоматическая память](/docs/ru/memory#auto-memory) основного разговора не загружается. Чтобы дать подагенту постоянную память своей собственной, используйте поле [`memory`](#enable-persistent-memory).

1150* **Context window size**: контекстное окно subagent определяется его собственной моделью, а не родительской. Делегирование модели с меньшим окном даёт этому subagent меньшее окно.1154* **Размер окна контекста**: окно контекста подагента определяется размером его собственной модели, не родительской. Делегирование модели с меньшим окном даёт этому подагенту меньшее окно.

1151 1155

1152<h4 id="resume-subagents">1156<h4 id="resume-subagents">

1153 Возобновите subagents1157 Возобновление подагентов

1154</h4>1158</h4>

1155 1159

1156Каждый вызов subagent создаёт новый экземпляр, а не продолжает более ранний. Чтобы продолжить работу существующего subagent вместо начала с нуля, попросите Claude возобновить его.1160Каждый вызов подагента создаёт новый экземпляр, а не продолжает более ранний. Чтобы продолжить работу существующего подагента вместо начала с нуля, попросите Claude возобновить его.

1157 1161

1158Возобновлённые subagents сохраняют полную историю разговора, включая все предыдущие вызовы инструментов, результаты и рассуждения. Если subagent порождал [фоновые subagents собственные](#let-subagents-spawn-their-own-subagents), эта история включает результаты, которые они доставили, пока он работал. Subagent продолжает ровно там, где он остановился, а не начинает с нуля.1162Возобновлённые подагенты сохраняют полную историю разговора, включая все предыдущие вызовы инструментов, результаты и рассуждения. Если подагент породил [фоновые подагенты своих собственных](#let-subagents-spawn-their-own-subagents), эта история включает результаты, которые они доставили, пока он работал. Подагент продолжает точно с того места, где он остановился, а не начинает с нуля.

1159 1163

1160* Когда subagent завершается, Claude получает его agent ID.1164* Когда подагент завершается, Claude получает его agent ID.

1161* Встроенные агенты Explore и Plan — это одноразовые и не возвращают agent ID, поэтому Claude не может их возобновить. Используйте `general-purpose` или пользовательский subagent, когда вам нужно продолжить работу.1165* Встроенные агенты Explore и Plan — это one-shot и не возвращают agent ID, поэтому Claude не может их возобновить. Используйте `general-purpose` или пользовательский подагент, когда вам нужно продолжить работу.

1162* Когда subagent останавливается на его лимите [`maxTurns`](#supported-frontmatter-fields), Claude Code отмечает возвращённый выход как частичный. Для subagents, которые возвращают agent ID, Claude Code также отмечает в результате, что Claude может отправить сообщение subagent, чтобы продолжить с того места, где он остановился.1166* Когда подагент останавливается на его пределе [`maxTurns`](#supported-frontmatter-fields), Claude Code отмечает возвращённый вывод как частичный. Для подагентов, которые возвращают agent ID, Claude Code также отмечает в результате, что Claude может отправить сообщение подагенту, чтобы продолжить с того места, где он остановился.

1163 1167

1164Claude использует инструмент `SendMessage` с ID агента или именем агента в качестве поля `to` для возобновления его. `SendMessage` не требует включения [agent teams](/docs/ru/agent-teams); только структурированные сообщения протокола команды, такие как `shutdown_request` и `plan_approval_response`, это требуют. Помимо subagents и товарищей, в сессиях, где включена cross-session messaging, Claude может использовать тот же инструмент для отправки сообщений [вашим другим сессиям Claude Code](/docs/ru/cross-session-messaging), на этой машине или [за её пределами](/docs/ru/cross-session-messaging#message-sessions-on-other-machines).1168Claude использует инструмент `SendMessage` с ID или именем агента как поле `to` для возобновления его. `SendMessage` не требует [команды агентов](/docs/ru/agent-teams) для включения; только структурированные сообщения протокола команды, такие как `shutdown_request` и `plan_approval_response`, это требуют. Помимо подагентов и товарищей, в сессиях, где включена cross-session messaging, Claude может использовать тот же инструмент для отправки сообщений [вашим другим сессиям Claude Code](/docs/ru/cross-session-messaging), на этой машине или [за её пределами](/docs/ru/cross-session-messaging#message-sessions-on-other-machines).

1165 1169

1166Чтобы возобновить subagent, попросите Claude продолжить предыдущую работу:1170Чтобы возобновить подагента, попросите Claude продолжить предыдущую работу:

1167 1171

1168```text wrap theme={null}1172```text wrap theme={null}

1169Use the code-reviewer subagent to review the authentication module1173Use the code-reviewer subagent to review the authentication module

1173[Claude resumes the subagent with full context from previous conversation]1177[Claude resumes the subagent with full context from previous conversation]

1174```1178```

1175 1179

1176Когда Claude отправляет завершённому subagent сообщение с инструментом `SendMessage`, subagent возобновляется в фоне без новой инвокации `Agent`. То же самое применяется к subagent, который Claude остановил с помощью инструмента `TaskStop`, после того как его остановленный запуск вышел. Возобновленный запуск сохраняет [набор инструментов с того места, где subagent впервые запустился](#run-subagents-in-foreground-or-background) и может продолжить чтение [prompt cache, который исходный запуск разогрел](/docs/ru/prompt-caching#subagents-and-the-cache).1180Когда Claude отправляет завершённому подагенту сообщение с инструментом `SendMessage`, подагент возобновляется в фоне без нового вызова `Agent`. То же самое применяется к подагенту, которого Claude остановил с инструментом `TaskStop`, как только его остановленный запуск вышел. Возобновлённый запуск держит [набор инструментов с того места, где подагент впервые запустился](#run-subagents-in-foreground-or-background) и может продолжить чтение [кэша prompt, который исходный запуск разогрел](/docs/ru/prompt-caching#subagents-and-the-cache).

1177 1181

1178Subagent, который имеет инструмент `SendMessage`, может отправить это сообщение тоже. В интерактивной сессии возобновленный агент затем сообщает обратно subagent, который его возобновил, а не вашему основному разговору. Этот subagent ждёт результата перед завершением своей собственной работы. Когда subagent отправляет сообщение агенту, которому он сообщает, такому как его собственный запускатель, Claude Code возобновляет этого агента без перенаправления его результатов.1182Подагент, у которого есть инструмент `SendMessage`, может отправить это сообщение тоже. В интерактивной сессии возобновлённый агент затем сообщает обратно подагенту, который его возобновил, а не в ваш основной разговор. Этот подагент ждёт результата перед завершением своей собственной работы. Когда подагент отправляет сообщение агенту, которому он сообщает, такому как его собственный запускатель, Claude Code возобновляет этого агента без перенаправления его результатов.

1179 1183

1180Subagent, который вы остановили сами, с `x` в `/tasks` или запросом SDK `stop_task`, не автоматически возобновляется. Если Claude отправит ему сообщение, сообщение отказывается и Claude сообщается, что агент был отменён.1184Подагент, которого вы остановили сами, с `x` в `/tasks` или запросом SDK `stop_task`, не auto-resume. Если Claude отправляет ему сообщение, сообщение отказывается и Claude сообщается, что агент был отменён.

1181 1185

1182Пока [строка этого subagent всё ещё находится в панели subagent](#run-subagents-in-foreground-or-background), введите в его транскрипт, чтобы возобновить его самостоятельно. После этого сообщение от Claude может автоматически возобновить его снова.1186Пока [строка этого подагента всё ещё в панели подагентов](#run-subagents-in-foreground-or-background), введите в его транскрипт, чтобы возобновить его самостоятельно. После этого сообщение от Claude может auto-resume его снова.

1183 1187

1184Возобновление начинает новый запуск агента под тем же ID, поэтому subagent, который уже завершился или был неудачным, показывается как работающий снова в списке задач и в событиях задач Agent SDK. До v2.1.205 он продолжал показывать свой более ранний статус неудачи или завершения, пока возобновленный запуск работал.1188Возобновление запускает новый запуск агента под тем же ID, поэтому подагент, который уже не удался или завершился, показывает как работающий снова в списке задач и в событиях задач Agent SDK. До v2.1.205 он продолжал показывать свой более ранний неудачный или завершённый статус, пока возобновлённый запуск работал.

1185 1189

1186Начиная с v2.1.199, `SendMessage` проверяет, что имя по-прежнему ссылается на того же агента, которого оно достигло ранее в разговоре. Если более новый агент взял имя, например повторно порождённый фоновый агент, который его переиспользовал, Claude Code отказывает в отправке, а не доставляет его неправильному агенту, и ошибка сообщает, какого агента имя теперь достигает, чтобы Claude мог перенаправить. Чтобы достичь более раннего агента, пока он всё ещё работает, Claude обращается к нему по ID агента, который он получил при порождении этого агента. Проверка ограничена текущим разговором и сбрасывается на `/clear`.1190Начиная с v2.1.199, `SendMessage` проверяет, что имя всё ещё относится к тому же агенту, которого оно достигло ранее в разговоре. Если более новый агент взял имя, такой как re-spawned фоновый агент, который переиспользовал его, Claude Code отказывает отправку, а не доставляет его неправильному агенту, и ошибка сообщает, какой агент имя теперь достигает, чтобы Claude мог перенаправить. Чтобы достичь более раннего агента, пока он всё ещё работает, Claude обращается к нему по agent ID, который он получил, когда породил этого агента. Проверка ограничена текущим разговором и сбрасывается на `/clear`.

1187 1191

1188Начиная с v2.1.198, subagent рассматривает сообщения от агента, который его запустил, как нормальное направление задачи, включая коррекции курса во время выполнения, и действует в соответствии с ними в рамках своих собственных параметров разрешения. Два лимита по-прежнему действуют независимо от того, кто отправил сообщение: ни одно сообщение от любого агента не считается вашим одобрением для ожидающего запроса разрешения, и ни один агент не может изменить параметры разрешения subagent, `CLAUDE.md` или конфигурацию. Только система разрешений или ваши собственные сообщения могут предоставить одобрение.1192Начиная с v2.1.198, подагент рассматривает сообщения от агента, который его запустил, как нормальное направление задачи, включая коррекции курса в середине задачи, и действует на них в рамках своих собственных параметров разрешения. Два лимита всё равно держат независимо от того, кто отправил сообщение: ни одно сообщение от любого агента не считается вашим одобрением для ожидающей подсказки разрешения, и ни одно сообщение агента не может изменить параметры разрешения подагента, `CLAUDE.md` или конфигурацию. Только система разрешений или ваши собственные сообщения могут предоставить одобрение.

1189 1193

1190Вы также можете попросить Claude ID агента, если хотите ссылаться на него явно, или найти ID в файлах транскрипта в `~/.claude/projects/{project}/{sessionId}/subagents/`. Каждый транскрипт сохраняется как `agent-{agentId}.jsonl`.1194Вы также можете попросить Claude для agent ID, если вы хотите ссылаться на него явно, или найти IDs в файлах транскрипта в `~/.claude/projects/{project}/{sessionId}/subagents/`. Каждый транскрипт хранится как `agent-{agentId}.jsonl`.

1191 1195

1192Транскрипты subagent сохраняются независимо от основного разговора:1196Транскрипты подагентов сохраняются независимо от основного разговора:

1193 1197

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

1195* **Сохранение сессии**: транскрипты subagent сохраняются в пределах их сессии. Вы можете [возобновить subagent](#resume-subagents) после перезагрузки Claude Code, возобновив ту же сессию.1199* **Сохранение сессии**: транскрипты подагентов сохраняются в их сессии. Вы можете [возобновить подагента](#resume-subagents) после перезагрузки Claude Code, возобновив ту же сессию.

1196* **Автоматическая очистка**: Claude Code удаляет транскрипты subagent после периода удержания `cleanupPeriodDays`, 30 дней по умолчанию, следуя [правилам очистки](/docs/ru/claude-directory#cleaned-up-automatically).1200* **Автоматическая очистка**: Claude Code удаляет транскрипты подагентов после периода сохранения `cleanupPeriodDays`, 30 дней по умолчанию, следуя [правилам развёртки очистки](/docs/ru/claude-directory#cleaned-up-automatically).

1197 1201

1198<h4 id="auto-compaction">1202<h4 id="auto-compaction">

1199 Auto-compaction1203 Автоматическое компактирование

1200</h4>1204</h4>

1201 1205

1202Subagents поддерживают автоматическое компактирование, используя ту же логику, что и основной разговор. Компактирование срабатывает при тех же условиях, и `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` применяется к subagents также. См. [environment variables](/docs/ru/env-vars) для того, когда переопределение вступает в силу.1206Подагенты поддерживают автоматическое компактирование, используя ту же логику, что и основной разговор. Компактирование срабатывает при тех же условиях, и `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` применяется к подагентам также. См. [переменные окружения](/docs/ru/env-vars) для того, когда переопределение вступает в силу.

1203 1207

1204События компактирования регистрируются в файлах транскрипта subagent:1208События компактирования регистрируются в файлах транскрипта подагентов:

1205 1209

1206```json theme={null}1210```json theme={null}

1207{1211{

1214}1218}

1215```1219```

1216 1220

1217Значение `preTokens` показывает, сколько токенов было использовано перед компактированием.1221Значение `preTokens` показывает, сколько токенов было использовано перед тем, как произошло компактирование.

1218 1222

1219<h2 id="fork-the-current-conversation">1223<h2 id="fork-the-current-conversation">

1220 Разветвление текущего разговора1224 Разветвление текущего разговора

terminal-config.md +6 −0

Details

339 ```339 ```

340</CodeGroup>340</CodeGroup>

341 341

342<h2 id="cap-response-width-in-wide-terminals">

343 Ограничить ширину ответа в широких терминалах

344</h2>

345

346В широком терминале каждая строка текста в ответах Claude занимает всю ширину окна. Чтобы вместо этого переносить текст на установленное количество столбцов, установите [`maxProseWidth`](/docs/ru/settings-reference#maxprosewidth) в ваших настройках.

347

342<h2 id="paste-large-content">348<h2 id="paste-large-content">

343 Вставка большого содержимого349 Вставка большого содержимого

344</h2>350</h2>

tools-reference.md +3 −3

Details

13Чтобы добавить пользовательские инструменты, подключите [MCP сервер](/docs/ru/mcp). Чтобы расширить Claude переиспользуемыми рабочими процессами на основе подсказок, напишите [skill](/docs/ru/skills), который работает через существующий инструмент `Skill` вместо добавления новой записи инструмента.13Чтобы добавить пользовательские инструменты, подключите [MCP сервер](/docs/ru/mcp). Чтобы расширить Claude переиспользуемыми рабочими процессами на основе подсказок, напишите [skill](/docs/ru/skills), который работает через существующий инструмент `Skill` вместо добавления новой записи инструмента.

14 14

15<Info>15<Info>

16 В планах Pro, Max и Team Claude Code запускает сеансы в [режиме auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), где классификатор решает большинство этих подсказок вместо вас. Столбец `Permission required` показывает, запрашивает ли инструмент разрешение в [режиме Manual](/docs/ru/permission-modes) для путей внутри рабочего каталога. Инструменты доступа к файлам, отмеченные как No, включая `Read`, `Grep` и `Glob`, по-прежнему запрашивают разрешение для путей вне [рабочего каталога и дополнительных каталогов](/docs/ru/permissions#working-directories). `Bash` отмечен как Yes, но запускает встроенный набор [команд только для чтения](/docs/ru/permissions#read-only-commands) без запроса разрешения.16 В [режиме auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатор решает большинство подсказок разрешений вместо вас. Столбец `Permission required` показывает, запрашивает ли инструмент разрешение в [режиме Manual](/docs/ru/permission-modes) для путей внутри рабочего каталога. Инструменты доступа к файлам, отмеченные как No, включая `Read`, `Grep` и `Glob`, по-прежнему запрашивают разрешение для путей вне [рабочего каталога и дополнительных каталогов](/docs/ru/permissions#working-directories). `Bash` отмечен как Yes, но запускает встроенный набор [команд только для чтения](/docs/ru/permissions#read-only-commands) без запроса разрешения.

17</Info>17</Info>

18 18

34| `Glob` | Находит файлы на основе сопоставления шаблонов. Отсутствует по умолчанию на macOS, Linux и WSL. См. [Поведение инструмента Glob](#glob-tool-behavior) | No |34| `Glob` | Находит файлы на основе сопоставления шаблонов. Отсутствует по умолчанию на macOS, Linux и WSL. См. [Поведение инструмента Glob](#glob-tool-behavior) | No |

35| `Grep` | Ищет шаблоны в содержимом файлов. Отсутствует по умолчанию на macOS, Linux и WSL. См. [Поведение инструмента Grep](#grep-tool-behavior) | No |35| `Grep` | Ищет шаблоны в содержимом файлов. Отсутствует по умолчанию на macOS, Linux и WSL. См. [Поведение инструмента Grep](#grep-tool-behavior) | No |

36| `ListAgents` | Выводит список агентов, с которыми Claude может общаться через `SendMessage`: подагентов в сеансе, товарищей по команде [команды агентов](/docs/ru/agent-teams), ваши другие локальные сеансы Claude Code и, пока этот сеанс подключен к [Remote Control](/docs/ru/remote-control), ваши сеансы [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) и ваши сеансы Remote Control на других машинах. Поддерживает команду `/list-agents`. См. [обмен сообщениями между сеансами](/docs/ru/cross-session-messaging). Требует Claude Code v2.1.224 или позже и появляется только в сеансах, где [обмен сообщениями между сеансами включен](/docs/ru/cross-session-messaging#availability). Строки товарищей по команде и первая строка, показывающая имя этого сеанса, требуют v2.1.239 или позже | No |36| `ListAgents` | Выводит список агентов, с которыми Claude может общаться через `SendMessage`: подагентов в сеансе, товарищей по команде [команды агентов](/docs/ru/agent-teams), ваши другие локальные сеансы Claude Code и, пока этот сеанс подключен к [Remote Control](/docs/ru/remote-control), ваши сеансы [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) и ваши сеансы Remote Control на других машинах. Поддерживает команду `/list-agents`. См. [обмен сообщениями между сеансами](/docs/ru/cross-session-messaging). Требует Claude Code v2.1.224 или позже и появляется только в сеансах, где [обмен сообщениями между сеансами включен](/docs/ru/cross-session-messaging#availability). Строки товарищей по команде и первая строка, показывающая имя этого сеанса, требуют v2.1.239 или позже | No |

~~37| `ListMcpResourcesTool` | Выводит список ресурсов, предоставляемых подключенными [MCP серверами](/docs/ru/mcp) | No |~~37| `ListMcpResourcesTool` | Выводит список ресурсов, предоставляемых подключенными [MCP серверами](/docs/ru/mcp), исключая [ресурсы MCP Apps UI](/docs/ru/mcp#reference-mcp-resources), которые являются страницами для отображения хост-приложением | No |

38| `LSP` | Интеллект кода через языковые серверы: переход к определениям, поиск ссылок, отчеты об ошибках типов и предупреждениях. См. [Поведение инструмента LSP](#lsp-tool-behavior) | No |38| `LSP` | Интеллект кода через языковые серверы: переход к определениям, поиск ссылок, отчеты об ошибках типов и предупреждениях. См. [Поведение инструмента LSP](#lsp-tool-behavior) | No |

39| `Monitor` | Запускает команду в фоновом режиме и передает каждую строку вывода обратно Claude, чтобы он мог реагировать на записи журнала, изменения файлов или опрашиваемый статус в середине разговора. Может также открыть WebSocket и рассматривать каждое входящее сообщение как событие. См. [Инструмент Monitor](#monitor-tool) | Yes |39| `Monitor` | Запускает команду в фоновом режиме и передает каждую строку вывода обратно Claude, чтобы он мог реагировать на записи журнала, изменения файлов или опрашиваемый статус в середине разговора. Может также открыть WebSocket и рассматривать каждое входящее сообщение как событие. См. [Инструмент Monitor](#monitor-tool) | Yes |

40| `NotebookEdit` | Изменяет ячейки Jupyter notebook. См. [Поведение инструмента NotebookEdit](#notebookedit-tool-behavior) | Yes |40| `NotebookEdit` | Изменяет ячейки Jupyter notebook. См. [Поведение инструмента NotebookEdit](#notebookedit-tool-behavior) | Yes |

506Read обрабатывает несколько типов файлов помимо простого текста:506Read обрабатывает несколько типов файлов помимо простого текста:

507 507

508* **Изображения**: PNG, JPG и другие форматы изображений возвращаются как визуальное содержимое, которое Claude может видеть, а не как необработанные байты. Claude Code изменяет размер и переупаковывает большие изображения, чтобы они соответствовали ограничениям размера изображения модели перед отправкой, поэтому Claude может видеть уменьшенную версию большого снимка экрана. Начиная с версии 2.1.196, изображение, которое все еще больше 500 КБ после этого изменения размера, переупаковывается как JPEG с пониженным качеством с неизменными размерами пикселей. Если Claude пропустит мелкие детали на уровне пикселей в большом изображении, попросите его сначала обрезать интересующий регион, например с помощью ImageMagick через Bash.508* **Изображения**: PNG, JPG и другие форматы изображений возвращаются как визуальное содержимое, которое Claude может видеть, а не как необработанные байты. Claude Code изменяет размер и переупаковывает большие изображения, чтобы они соответствовали ограничениям размера изображения модели перед отправкой, поэтому Claude может видеть уменьшенную версию большого снимка экрана. Начиная с версии 2.1.196, изображение, которое все еще больше 500 КБ после этого изменения размера, переупаковывается как JPEG с пониженным качеством с неизменными размерами пикселей. Если Claude пропустит мелкие детали на уровне пикселей в большом изображении, попросите его сначала обрезать интересующий регион, например с помощью ImageMagick через Bash.

509* **PDF-файлы**: Claude читает короткие файлы `.pdf` целиком. Для PDF-файлов длиннее 10 страниц он читает диапазоны с параметром `pages`, таким как `"1-5"`, до 20 страниц за раз.509* **PDF-файлы**: Claude читает короткие файлы `.pdf` целиком. Для PDF-файлов длиннее 10 страниц он читает диапазоны с параметром `pages`, таким как `"1-5"`, до 20 страниц за раз. Чтение диапазонов страниц отображает страницы с помощью `pdftoppm` из poppler-utils, поэтому установите его с помощью `brew install poppler` на macOS или `apt-get install poppler-utils` на Debian и Ubuntu. На Windows и других платформах установите сборку poppler, которая помещает `pdftoppm` в ваш `PATH`. Без этого чтение диапазона страниц завершается ошибкой `pdftoppm is not installed`.

510* **Jupyter notebooks**: файлы `.ipynb` возвращают все ячейки с их выводом, включая код, markdown и визуализации. Claude Code отказывается читать файл notebook размером более 100 МБ; ошибка сообщает Claude, как прочитать часть notebook вместо этого, например срез ячеек, с помощью команды shell.510* **Jupyter notebooks**: файлы `.ipynb` возвращают все ячейки с их выводом, включая код, markdown и визуализации. Claude Code отказывается читать файл notebook размером более 100 МБ; ошибка сообщает Claude, как прочитать часть notebook вместо этого, например срез ячеек, с помощью команды shell.

511 511

512Read читает только файлы, а не директории. Claude выводит содержимое директории с помощью команды shell, такой как `ls`.512Read читает только файлы, а не директории. Claude выводит содержимое директории с помощью команды shell, такой как `ls`.

troubleshoot-install.md +43 −1

Details

41| `running scripts is disabled on this system` или `PSSecurityException` | [Разрешите npm shims запускаться](#running-scripts-is-disabled-on-this-system) |41| `running scripts is disabled on this system` или `PSSecurityException` | [Разрешите npm shims запускаться](#running-scripts-is-disabled-on-this-system) |

42| `Error: claude native binary not installed` | [Завершите установку npm](#native-binary-not-found-after-npm-install) |42| `Error: claude native binary not installed` | [Завершите установку npm](#native-binary-not-found-after-npm-install) |

43| `npm error code ENOTEMPTY` во время обновления или переустановки | [Удалите оставшийся каталог пакета](#npm-enotempty-during-update-or-reinstall) |43| `npm error code ENOTEMPTY` во время обновления или переустановки | [Удалите оставшийся каталог пакета](#npm-enotempty-during-update-or-reinstall) |

44| `'claude' is not recognized` сразу после обновления на Windows | [Восстановите `claude.exe` из его резервной копии](#claude-exe-missing-after-an-update-on-windows) |

44| На Windows команда установки выводит текст скрипта и ничего не устанавливается | [Запустите полную команду установки](#wrong-install-command-on-windows) |45| На Windows команда установки выводит текст скрипта и ничего не устанавливается | [Запустите полную команду установки](#wrong-install-command-on-windows) |

45| `App unavailable in region` | Claude Code недоступен в вашей стране. См. [поддерживаемые страны](https://www.anthropic.com/supported-countries). |46| `App unavailable in region` | Claude Code недоступен в вашей стране. См. [поддерживаемые страны](https://www.anthropic.com/supported-countries). |

46| `unable to get local issuer certificate` | [Настройте корпоративные сертификаты CA](#tls-or-ssl-connection-errors) |47| `unable to get local issuer certificate` | [Настройте корпоративные сертификаты CA](#tls-or-ssl-connection-errors) |

47| `OAuth error` или `403 Forbidden` | [Исправьте аутентификацию](#login-and-authentication) |48| `OAuth error` или `403 Forbidden` | [Исправьте аутентификацию](#login-and-authentication) |

49| `Claude Code access has not been granted for this account` | [Получите роль, которая включает Claude Code](#claude-code-access-has-not-been-granted-for-this-account) |

48| `Unable to connect to Anthropic services` во время установки | См. [Unable to connect to Anthropic services](/docs/ru/errors#unable-to-connect-to-anthropic-services) в справочнике ошибок |50| `Unable to connect to Anthropic services` во время установки | См. [Unable to connect to Anthropic services](/docs/ru/errors#unable-to-connect-to-anthropic-services) в справочнике ошибок |

49| `Could not load the default credentials` или `Could not load credentials from any providers` | [Учетные данные Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |51| `Could not load the default credentials` или `Could not load credentials from any providers` | [Учетные данные Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

50| `ChainedTokenCredential authentication failed` или `CredentialUnavailableError` | [Учетные данные Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |52| `ChainedTokenCredential authentication failed` или `CredentialUnavailableError` | [Учетные данные Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

142 source ~/.zshrc144 source ~/.zshrc

143 ```145 ```

144 146

145 Для Bash, по умолчанию на большинстве дистрибутивов Linux:147 Для Bash на Linux, где это по умолчанию на большинстве дистрибутивов:

146 148

147 ```bash theme={null}149 ```bash theme={null}

148 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc150 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

149 source ~/.bashrc151 source ~/.bashrc

150 ```152 ```

151 153

154 Для Bash на macOS добавьте строку в `~/.bash_profile` вместо этого. Terminal на macOS запускает Bash как оболочку входа, которая игнорирует `~/.bashrc` и читает только первый из `~/.bash_profile`, `~/.bash_login` или `~/.profile`, который существует. Если у вас уже есть `~/.bash_login` или `~/.profile` и нет `~/.bash_profile`, поместите строку в этот файл, а не создавайте `~/.bash_profile`:

155

156 ```bash theme={null}

157 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bash_profile

158 source ~/.bash_profile

159 ```

160

152 Или закройте и снова откройте ваш терминал.161 Или закройте и снова откройте ваш терминал.

153 162

154 Для других оболочек, таких как fish или Nushell, добавьте `~/.local/bin` в ваш PATH, используя синтаксис конфигурации вашей оболочки, а затем перезагрузите ваш терминал.163 Для других оболочек, таких как fish или Nushell, добавьте `~/.local/bin` в ваш PATH, используя синтаксис конфигурации вашей оболочки, а затем перезагрузите ваш терминал.

593irm https://claude.ai/install.ps1 | iex602irm https://claude.ai/install.ps1 | iex

594```603```

595 604

605<h3 id="claude-exe-missing-after-an-update-on-windows">

606 `claude.exe` missing after an update on Windows

607</h3>

608

609Если ваш терминал сообщает `'claude' is not recognized` сразу после обновления Claude Code на Windows, проверьте, содержит ли `%USERPROFILE%\.local\bin` всё ещё `claude.exe`. Если эта директория вообще не находится в вашем PATH, см. [Исправление вашего PATH](#command-not-found-claude-after-installation) вместо этого. Для обновления на Windows Claude Code переименовывает существующий `claude.exe` в резервную копию и перемещает новую версию на его место. Если перемещение новой версии на место не удаётся и Claude Code не может переименовать резервную копию обратно, директория сохраняет резервную копию, но не имеет `claude.exe`.

610

611Резервная копия — это файл в той же директории, имя которого начинается с `claude.exe.old.` с последующей числовой меткой времени. Запустите следующее в PowerShell, чтобы переименовать самую новую резервную копию обратно в `claude.exe`:

612

613```powershell theme={null}

614Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

615```

616

617Затем запустите `claude --version` для подтверждения исправления. Восстановленный `claude.exe` выводит номер версии.

618

619Если нет файла `claude.exe.old.*`, или `claude` всё ещё не удаётся после переименования, переустановите вместо этого:

620

621```powershell theme={null}

622irm https://claude.ai/install.ps1 | iex

623```

624

625До v2.1.281 Claude Code мог удалить резервную копию, пока `claude.exe` всё ещё отсутствовал.

626

596<h3 id="install-killed-on-low-memory-linux-servers">627<h3 id="install-killed-on-low-memory-linux-servers">

597 Install killed on low-memory Linux servers628 Install killed on low-memory Linux servers

598</h3>629</h3>

992* **Пользователи Anthropic Console**: подтвердите, что ваша учётная запись имеет роль "Claude Code" или "Developer". Администраторы назначают это в Anthropic Console под Settings → Members.1023* **Пользователи Anthropic Console**: подтвердите, что ваша учётная запись имеет роль "Claude Code" или "Developer". Администраторы назначают это в Anthropic Console под Settings → Members.

993* **За прокси**: корпоративные прокси могут помешать запросам API. См. [network configuration](/docs/ru/network-config) для настройки прокси.1024* **За прокси**: корпоративные прокси могут помешать запросам API. См. [network configuration](/docs/ru/network-config) для настройки прокси.

994 1025

1026<h3 id="claude-code-access-has-not-been-granted-for-this-account">

1027 Claude Code access has not been granted for this account

1028</h3>

1029

1030Если страница входа показывает `Authorization failed` с сообщением `Claude Code access has not been granted for this account. Contact your administrator.` после того как вы вошли из Claude Code, ваша организация Claude Enterprise установила вашу роль на Custom и ни одна из [custom roles](https://support.claude.com/en/articles/13930452) назначенных вашим группам не предоставляет Claude Code. На роли Custom вы получаете доступ только из этих пользовательских ролей, поэтому ничего, что вы измените в Claude Code, не разрешит эту ошибку.

1031

1032Чтобы получить доступ:

1033

10341. Попросите владельца вашей организации Claude назначить пользовательскую роль, которая предоставляет доступ Claude Code одной из ваших групп, или изменить вашу роль с Custom на стандартную роль, такую как User. Владельцы управляют ролями в [role settings](https://claude.ai/admin-settings/roles) организации.

10352. После того как владелец внесёт изменение, запустите `claude` и войдите снова.

1036

995<h3 id="this-organization-has-been-disabled-with-an-active-subscription">1037<h3 id="this-organization-has-been-disabled-with-an-active-subscription">

996 This organization has been disabled with an active subscription1038 This organization has been disabled with an active subscription

997</h3>1039</h3>

troubleshooting.md +1 −0

Details

17| Сеанс запущен в режиме auto, или Claude редактирует файлы и выполняет команды без запроса | [Which mode a session starts in](/docs/ru/permission-modes#which-mode-a-session-starts-in) |17| Сеанс запущен в режиме auto, или Claude редактирует файлы и выполняет команды без запроса | [Which mode a session starts in](/docs/ru/permission-modes#which-mode-a-session-starts-in) |

18| `API Error: 5xx`, `529 Overloaded`, `429`, ошибки валидации запроса | [Error reference](/docs/ru/errors) |18| `API Error: 5xx`, `529 Overloaded`, `429`, ошибки валидации запроса | [Error reference](/docs/ru/errors) |

19| `model not found` или `you may not have access to it` | [Error reference](/docs/ru/errors#theres-an-issue-with-the-selected-model) |19| `model not found` или `you may not have access to it` | [Error reference](/docs/ru/errors#theres-an-issue-with-the-selected-model) |

20| Команда, которую выполняет Claude, не удаётся с `Your disk quota is full`, `is full (ENOSPC)` или `Command output was lost` | [Error reference](/docs/ru/errors#disk-quota-or-temp-filesystem-is-full) |

20| Расширение VS Code не подключается или не обнаруживает Claude | [VS Code integration](/docs/ru/vs-code#fix-common-issues) |21| Расширение VS Code не подключается или не обнаруживает Claude | [VS Code integration](/docs/ru/vs-code#fix-common-issues) |

21| `Claude Code process exited with code 1` в VS Code или приложении SDK | [Error reference](/docs/ru/errors#claude-code-process-exited-with-code-n) |22| `Claude Code process exited with code 1` в VS Code или приложении SDK | [Error reference](/docs/ru/errors#claude-code-process-exited-with-code-n) |

22| Плагин JetBrains или IDE не обнаружена | [JetBrains integration](/docs/ru/jetbrains#troubleshooting) |23| Плагин JetBrains или IDE не обнаружена | [JetBrains integration](/docs/ru/jetbrains#troubleshooting) |

voice-dictation.md +1 −1

Details

190* **`Voice mode requires SoX for audio recording` на Linux**: собственный модуль аудио не может загрузиться и резервный вариант не установлен. Установите SoX с помощью команды, показанной в сообщении об ошибке, например `sudo apt-get install sox`.190* **`Voice mode requires SoX for audio recording` на Linux**: собственный модуль аудио не может загрузиться и резервный вариант не установлен. Установите SoX с помощью команды, показанной в сообщении об ошибке, например `sudo apt-get install sox`.

191* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX установлен, но хост не имеет устройства захвата аудио, например безголовый сервер или контейнер. Запустите Claude Code на машине с микрофоном. Начиная с версии 2.1.195, Claude Code на Linux выводит это сообщение в такой ситуации; более ранние версии просили вас установить SoX даже когда он уже был установлен.191* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX установлен, но хост не имеет устройства захвата аудио, например безголовый сервер или контейнер. Запустите Claude Code на машине с микрофоном. Начиная с версии 2.1.195, Claude Code на Linux выводит это сообщение в такой ситуации; более ранние версии просили вас установить SoX даже когда он уже был установлен.

192* **`Voice mode could not find a working audio recorder in WSL`**: WSLg маршрутизирует аудио через PulseAudio вместо устройства ALSA, поэтому SoX требует явной установки его бэкенда PulseAudio. Запустите `sudo apt install sox libsox-fmt-pulse`. Установка только `sox` подтягивает бэкенд ALSA, который не может записывать на WSL, потому что нет устройства `/dev/snd`.192* **`Voice mode could not find a working audio recorder in WSL`**: WSLg маршрутизирует аудио через PulseAudio вместо устройства ALSA, поэтому SoX требует явной установки его бэкенда PulseAudio. Запустите `sudo apt install sox libsox-fmt-pulse`. Установка только `sox` подтягивает бэкенд ALSA, который не может записывать на WSL, потому что нет устройства `/dev/snd`.

193* **`Voice input is failing repeatedly and has been paused`**: голосовой ввод столкнулся с тремя сбоями при захвате в течение 10 секунд. Claude Code приостанавливает диктовку до тех пор, пока не пройдет 10 секунд с момента первого из этих сбоев. Сбой считается независимо от того, не удается ли микрофону запуститься или рекордер запускается, а затем останавливается без создания какого-либо аудио. Это обычно означает, что микрофон или звуковой стек на этом хосте не может захватить аудио, например безголовый сервер, удаленная оболочка без передачи аудио или запрещенное разрешение микрофона. Подтвердите работающее устройство ввода, исправьте основную причину из записей выше, затем снова активируйте голосовой ввод. До версии 2.1.202 только сбои при запуске учитывались при паузе.193* **`Voice input is failing repeatedly and has been paused`**: голосовой ввод столкнулся с тремя сбоями в течение 10 секунд. Claude Code приостанавливает диктовку до тех пор, пока не пройдет 10 секунд с момента первого из этих сбоев. Это обычно означает, что микрофон или звуковой стек на этом хосте не может захватить аудио, например безголовый сервер, удаленная оболочка без передачи аудио или запрещенное разрешение микрофона. Подтвердите работающее устройство ввода, исправьте основную причину из записей выше, затем снова активируйте голосовой ввод. До версии 2.1.202 только сбои при запуске учитывались при паузе.

194* **Ничего не происходит при удержании `Space` в режиме удержания**: смотрите на поле ввода запроса, пока вы удерживаете. Если пробелы продолжают накапливаться, голосовой ввод, вероятно, отключен; запустите `/voice hold` для включения. Если появляется только один или два пробела, а затем ничего, голосовой ввод включен, но обнаружение удержания не срабатывает. Обнаружение удержания требует, чтобы ваш терминал отправлял события повтора клавиш, поэтому он не может обнаружить удерживаемую клавишу, если повтор клавиш отключен на уровне ОС. Переключитесь на режим нажатия с помощью `/voice tap`, чтобы избежать требования повтора клавиш.194* **Ничего не происходит при удержании `Space` в режиме удержания**: смотрите на поле ввода запроса, пока вы удерживаете. Если пробелы продолжают накапливаться, голосовой ввод, вероятно, отключен; запустите `/voice hold` для включения. Если появляется только один или два пробела, а затем ничего, голосовой ввод включен, но обнаружение удержания не срабатывает. Обнаружение удержания требует, чтобы ваш терминал отправлял события повтора клавиш, поэтому он не может обнаружить удерживаемую клавишу, если повтор клавиш отключен на уровне ОС. Переключитесь на режим нажатия с помощью `/voice tap`, чтобы избежать требования повтора клавиш.

195* **Нажатие `Space` печатает пробел вместо записи в режиме нажатия**: первое нажатие начинает запись только при пустом поле ввода запроса. Сначала очистите ввод или проверьте, что вы находитесь в режиме нажатия, запустив `/voice tap`.195* **Нажатие `Space` печатает пробел вместо записи в режиме нажатия**: первое нажатие начинает запись только при пустом поле ввода запроса. Сначала очистите ввод или проверьте, что вы находитесь в режиме нажатия, запустив `/voice tap`.

196* **`No audio detected from microphone`**: запись началась, но захватила молчание. Подтвердите, что правильное устройство ввода установлено по умолчанию в системе и что его уровень ввода не отключен и не близок к нулю. На Windows откройте Settings → System → Sound → Input и выберите ваш микрофон. На macOS откройте System Settings → Sound → Input.196* **`No audio detected from microphone`**: запись началась, но захватила молчание. Подтвердите, что правильное устройство ввода установлено по умолчанию в системе и что его уровень ввода не отключен и не близок к нулю. На Windows откройте Settings → System → Sound → Input и выберите ваш микрофон. На macOS откройте System Settings → Sound → Input.

vs-code.md +42 −19

Details

109 109

110Поле ввода подсказки поддерживает несколько функций:110Поле ввода подсказки поддерживает несколько функций:

111 111

112* **Режимы разрешений**: нажмите на индикатор режима в нижней части поля ввода подсказки, чтобы переключать режимы разрешений. В планах Pro, Max и Team режим Auto является встроенным начальным режимом разрешений. Смотрите [как расширение выбирает начальный режим разрешений](/docs/ru/permission-modes#switch-permission-modes), чтобы узнать, что это меняет, и все режимы разрешений, которые предлагает индикатор.112* **Режимы разрешений**: нажмите на индикатор режима в нижней части поля ввода подсказки, чтобы переключать режимы разрешений. С Claude Code v2.1.283 или позже режим Auto является встроенным начальным режимом разрешений, а в более ранних версиях только в планах Pro, Max и Team. Смотрите [как расширение выбирает начальный режим разрешений](/docs/ru/permission-modes#switch-permission-modes), чтобы узнать, что это меняет, и все режимы разрешений, которые предлагает индикатор.

113 * **Auto**: классификатор проверяет большинство действий вместо того, чтобы просить вас. Смотрите [режим auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), чтобы узнать, что он проверяет и блокирует.113 * **Auto**: классификатор проверяет большинство действий вместо того, чтобы просить вас. Смотрите [режим auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), чтобы узнать, что он проверяет и блокирует.

114 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и большинством команд оболочки.114 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и большинством команд оболочки.

115 * **Plan**: Claude описывает, что он будет делать, и ждет одобрения перед внесением изменений. VS Code автоматически открывает план как полный документ Markdown, где вы можете добавлять встроенные комментарии, чтобы дать обратную связь перед началом работы Claude.115 * **Plan**: Claude описывает, что он будет делать, и ждет одобрения перед внесением изменений. VS Code автоматически открывает план как полный документ Markdown, где вы можете добавлять встроенные комментарии, чтобы дать обратную связь перед началом работы Claude.

123* **Model**: выберите **Switch model…** из меню команд, чтобы изменить модель во время сеанса. Вы также можете нажать на имя модели в нижней части поля ввода подсказки, чтобы открыть тот же выбор.123* **Model**: выберите **Switch model…** из меню команд, чтобы изменить модель во время сеанса. Вы также можете нажать на имя модели в нижней части поля ввода подсказки, чтобы открыть тот же выбор.

124 124

125 Когда текущая модель поддерживает [уровни усилий](/docs/ru/model-config#adjust-effort-level), выбор также показывает строку **Effort** и кнопка имени модели показывает выбранный уровень. Когда вы выбираете уровень, отличный от `max`, Claude Code сохраняет его для текущей модели как ваше значение по умолчанию в разделе [`modelSettings`](/docs/ru/settings-reference#modelsettings) в ваших пользовательских параметрах; `max` применяется только к текущему сеансу. Кнопка имени модели и строка **Effort** требуют Claude Code v2.1.257 или позже.125 Когда текущая модель поддерживает [уровни усилий](/docs/ru/model-config#adjust-effort-level), выбор также показывает строку **Effort** и кнопка имени модели показывает выбранный уровень. Когда вы выбираете уровень, отличный от `max`, Claude Code сохраняет его для текущей модели как ваше значение по умолчанию в разделе [`modelSettings`](/docs/ru/settings-reference#modelsettings) в ваших пользовательских параметрах; `max` применяется только к текущему сеансу. Кнопка имени модели и строка **Effort** требуют Claude Code v2.1.257 или позже.

126

127 Когда [dynamic workflows](/docs/ru/workflows) включены и текущая модель их поддерживает, под строкой **Effort** появляется переключатель **Ultracode**. Включите его, чтобы Claude планировал [workflow](/docs/ru/workflows#let-claude-decide-with-ultracode) для каждой существенной задачи в этом сеансе на выбранном уровне усилий. Пока он включен, кнопка имени модели показывает `· Ultracode` после уровня. Переключатель требует Claude Code v2.1.284 или позже.

126* **Command menu**: нажмите `/` или введите `/`, чтобы открыть меню команд. Опции включают присоединение файлов, переключение моделей и переключение расширенного мышления.128* **Command menu**: нажмите `/` или введите `/`, чтобы открыть меню команд. Опции включают присоединение файлов, переключение моделей и переключение расширенного мышления.

127 129

128 Раздел Customize предоставляет доступ к серверам MCP, commands, стилям вывода, hooks, памяти, инструкциям, разрешениям и плагинам. Элементы со значком терминала открываются в интегрированном терминале.130 Раздел Customize предоставляет доступ к серверам MCP, commands, стилям вывода, hooks, памяти, инструкциям, разрешениям и плагинам. Элементы со значком терминала открываются в интегрированном терминале.

148 Когда вы включаете или выключаете переключатель в окне VS Code, изменение применяется к сеансам, уже открытым в этом окне VS Code, а не только к сеансам, которые вы запускаете позже. Если вы его выключите, открытые сеансы отключатся. С Claude Code v2.1.261 или позже изменение также достигает сеансов, открытых в ваших других окнах VS Code.150 Когда вы включаете или выключаете переключатель в окне VS Code, изменение применяется к сеансам, уже открытым в этом окне VS Code, а не только к сеансам, которые вы запускаете позже. Если вы его выключите, открытые сеансы отключатся. С Claude Code v2.1.261 или позже изменение также достигает сеансов, открытых в ваших других окнах VS Code.

149 * Раздел Settings также включает **Focus view**, который скрывает вызовы инструментов, результаты инструментов и мышление за расширяемыми строками, оставляя ваши подсказки и ответы Claude. Переключайте его там, с `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), или из Command Palette с **Claude Code: Toggle Focus view**. Изменение применяется к каждому открытому сеансу и сохраняется между сеансами. Требует Claude Code v2.1.221 или позже.151 * Раздел Settings также включает **Focus view**, который скрывает вызовы инструментов, результаты инструментов и мышление за расширяемыми строками, оставляя ваши подсказки и ответы Claude. Переключайте его там, с `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), или из Command Palette с **Claude Code: Toggle Focus view**. Изменение применяется к каждому открытому сеансу и сохраняется между сеансами. Требует Claude Code v2.1.221 или позже.

150 152

151 Последний список дел Claude остается видимым, как и текст, о котором задает вопрос ожидающий вопрос от Claude; это требует Claude Code v2.1.225 или позже. Пока Claude запускает [подагентов](/docs/ru/sub-agents), строки прямого прогресса с их последней активностью появляются под группой вызовов инструментов, которая их запустила. Это требует Claude Code v2.1.269 или позже.153 Последний список дел Claude остается видимым, как и текст, о котором задает вопрос ожидающий вопрос от Claude; это требует Claude Code v2.1.225 или позже. Пока Claude запускает [subagents](/docs/ru/sub-agents), строки прямого прогресса с их последней активностью появляются под группой вызовов инструментов, которая их запустила. Это требует Claude Code v2.1.269 или позже.

152 * Чтобы выйти из своей учетной записи Anthropic, выберите **Sign out** в разделе Settings, или введите `/logout`. На [поставщике третьей стороны](#use-third-party-providers) меню не предлагает ни того, ни другого. Требует Claude Code v2.1.277 или позже.154 * Чтобы выйти из своей учетной записи Anthropic, выберите **Sign out** в разделе Settings, или введите `/logout`. На [поставщике третьей стороны](#use-third-party-providers) меню не предлагает ни того, ни другого. Требует Claude Code v2.1.277 или позже.

153 * Чтобы сообщить об ошибке, нажмите **Report a problem** в нижней части меню, или введите `/bug` или `/feedback` с необязательным описанием, которое предварительно заполняет отчет. Когда вы отправляете отчет и вы вошли в Anthropic на подключении первой стороны, Claude Code отправляет его в Anthropic. У поставщика третьей стороны или без учетных данных Anthropic диалог все еще открывается, но отправка показывает ошибку и ничего не отправляет: в отличие от `/bug` CLI, расширение не записывает локальный архив. Требует Claude Code v2.1.229 или позже.155 * Чтобы сообщить об ошибке, нажмите **Report a problem** в нижней части меню, или введите `/bug` или `/feedback` с необязательным описанием, которое предварительно заполняет отчет. Когда вы отправляете отчет и вы вошли в Anthropic на подключении первой стороны, Claude Code отправляет его в Anthropic. Требует Claude Code v2.1.229 или позже.

156

157 На поставщике третьей стороны или без учетных данных Anthropic ничего не отправляется. Диалог говорит об этом перед тем, как вы пишете. Отправка сохраняет отчет как [локальный архив в `~/.claude/feedback-bundles/`](/docs/ru/data-usage#telemetry-services) с известными шаблонами ключей API и токенов удаленными. Отправьте этот файл своему представителю учетной записи Anthropic или прикрепите его к запросу поддержки. Подтверждение называет файл и включает кнопку **Show folder**. Сохранение отчета на вашем компьютере требует Claude Code v2.1.284 или позже.

154 158

155 Если политика вашей организации отключает отзывы о продукте, **Report a problem** не появляется в меню, и `/bug` и `/feedback` показывают уведомление `Feedback is turned off by your organization's policy or this environment's settings.` вместо открытия отчета.159 Если политика вашей организации отключает отзывы о продукте, **Report a problem** не появляется в меню, и `/bug` и `/feedback` показывают уведомление `Feedback is turned off by your organization's policy or this environment's settings.` вместо открытия отчета. С Claude Code v2.1.284 или позже, если вы установите переменную окружения `DISABLE_FEEDBACK_COMMAND` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, отзывы также отключены и открытие отчета показывает это уведомление вместо этого.

156* **Side questions**: введите `/btw` с последующим вопросом, чтобы задать вопрос о вашем сеансе [без добавления в разговор](/docs/ru/interactive-mode#side-questions-with-%2Fbtw). Ответ открывается в панели рядом с чатом, где вы можете задавать дополнительные вопросы. Поток сохраняется при перезагрузке окна. Claude Code сохраняет новейшие 20 обменов и истекает сохраненные потоки по расписанию [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), пока Claude Code может [безопасно определить период хранения](/docs/ru/claude-directory#cleaned-up-automatically). Чтобы очистить поток, нажмите на значок корзины в панели. Требует Claude Code v2.1.227 или позже.160* **Side questions**: введите `/btw` с последующим вопросом, чтобы задать вопрос о вашем сеансе [без добавления в разговор](/docs/ru/interactive-mode#side-questions-with-%2Fbtw). Ответ открывается в панели рядом с чатом, где вы можете задавать дополнительные вопросы. Поток сохраняется при перезагрузке окна. Claude Code сохраняет новейшие 20 обменов и истекает сохраненные потоки по расписанию [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), пока Claude Code может [безопасно определить период хранения](/docs/ru/claude-directory#cleaned-up-automatically). Чтобы очистить поток, нажмите на значок корзины в панели. Требует Claude Code v2.1.227 или позже.

157* **Copy a response**: наведите курсор на ответ и нажмите **Copy response**, чтобы скопировать его в буфер обмена, или введите `/copy`, чтобы скопировать последний ответ. `/copy 2` копирует второй с конца. Требует Claude Code v2.1.277 или позже.161* **Copy a response**: наведите курсор на ответ и нажмите **Copy response**, чтобы скопировать его в буфер обмена, или введите `/copy`, чтобы скопировать последний ответ. `/copy 2` копирует второй с конца. Требует Claude Code v2.1.277 или позже.

158* **Context indicator**: поле ввода подсказки показывает, сколько контекстного окна Claude вы используете. Claude автоматически компактирует при необходимости, или вы можете запустить `/compact` вручную.162* **Context indicator**: поле ввода подсказки показывает, сколько контекстного окна Claude вы используете. Claude автоматически компактирует при необходимости, или вы можете запустить `/compact` вручную.

160 * До истечения обратного отсчета значок показывает оставшиеся минуты, такие как **12m**.164 * До истечения обратного отсчета значок показывает оставшиеся минуты, такие как **12m**.

161 * Когда обратный отсчет заканчивается, минуты исчезают и значок становится красным, или цветом ошибки вашей темы, до следующего ответа. Кэш, вероятно, истек, поэтому ожидайте более медленный и дорогостоящий ответ на ваше следующее сообщение, пока кэш перестраивается. Если время жизни в пять минут продолжает истекать между вашими сообщениями, смотрите [Choose the TTL yourself](/docs/ru/prompt-caching#choose-the-ttl-yourself).165 * Когда обратный отсчет заканчивается, минуты исчезают и значок становится красным, или цветом ошибки вашей темы, до следующего ответа. Кэш, вероятно, истек, поэтому ожидайте более медленный и дорогостоящий ответ на ваше следующее сообщение, пока кэш перестраивается. Если время жизни в пять минут продолжает истекать между вашими сообщениями, смотрите [Choose the TTL yourself](/docs/ru/prompt-caching#choose-the-ttl-yourself).

162 * Сразу после [компактирования](/docs/ru/prompt-caching#compacting-the-conversation) разговора значок также становится красным без минут до следующего ответа, потому что кэш еще не охватывает компактированный разговор.166 * Сразу после [компактирования](/docs/ru/prompt-caching#compacting-the-conversation) разговора значок также становится красным без минут до следующего ответа, потому что кэш еще не охватывает компактированный разговор.

163* **Agent map**: когда разговор включает [подагентов](/docs/ru/sub-agents), счетчик агентов, такой как **2 agents**, появляется в нижней части поля ввода подсказки. Его точка показывает, работает ли какой-либо подагент или ожидает вашего разрешения.167* **Agent map**: когда разговор включает [subagents](/docs/ru/sub-agents), счетчик агентов, такой как **2 agents**, появляется в нижней части поля ввода подсказки. Его точка показывает, работает ли какой-либо подагент или ожидает вашего разрешения.

164 168

165 Нажмите на счетчик агентов, чтобы открыть карту агентов, которая рисует подагентов разговора как дерево под главным агентом, каждый с его статусом, прошедшим временем и счетчиком токенов. Нажмите на подагента, чтобы увидеть его подсказку и вызовы инструментов, открыть его транскрипт только для чтения или остановить его во время работы. Требует Claude Code v2.1.269 или позже.169 Нажмите на счетчик агентов, чтобы открыть карту агентов, которая рисует подагентов разговора как дерево под главным агентом, каждый с его статусом, прошедшим временем и счетчиком токенов. Нажмите на подагента, чтобы увидеть его подсказку и вызовы инструментов, открыть его транскрипт только для чтения или остановить его во время работы. Требует Claude Code v2.1.269 или позже.

166 170

167 Карта также отображает другие [фоновые задачи](/docs/ru/tools-reference#background-commands) сеанса, такие как фоновые команды оболочки и [мониторы](/docs/ru/tools-reference#monitor-tool), ниже агентов. Нажмите на строку, чтобы открыть карточку задачи и остановить ее там.171 Карта также отображает другие [background tasks](/docs/ru/tools-reference#background-commands) сеанса, такие как фоновые команды оболочки и [monitors](/docs/ru/tools-reference#monitor-tool), ниже агентов. Нажмите на строку, чтобы открыть карточку задачи и остановить ее там.

168 172

169 Чтобы открыть карту, когда счетчик агентов не отображается, например когда Claude запустил фоновую команду оболочки, но нет подагентов, введите `/tasks` в поле ввода подсказки. Фоновые задачи на карте и введенная `/tasks` требуют Claude Code v2.1.277 или позже.173 Чтобы открыть карту, когда счетчик агентов не отображается, например когда Claude запустил фоновую команду оболочки, но нет подагентов, введите `/tasks` в поле ввода подсказки. Фоновые задачи на карте и введенная `/tasks` требуют Claude Code v2.1.277 или позже.

170* **Extended thinking**: позволяет Claude потратить больше времени на рассуждение о сложных проблемах. Переключайте его через меню команд (`/`). Рассуждение Claude появляется в разговоре как свернутые блоки: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть каждый блок мышления в сеансе. Смотрите [Extended thinking](/docs/ru/model-config#extended-thinking) для деталей.174* **Extended thinking**: позволяет Claude потратить больше времени на рассуждение о сложных проблемах. Переключайте его через меню команд (`/`). Рассуждение Claude появляется в разговоре как свернутые блоки: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть каждый блок мышления в сеансе. Смотрите [Extended thinking](/docs/ru/model-config#extended-thinking) для деталей.

181What's in @src/components/ (include a trailing slash for folders)185What's in @src/components/ (include a trailing slash for folders)

182```186```

183 187

184Для больших PDF-файлов вы можете попросить Claude прочитать определенные страницы вместо всего файла: одну страницу, диапазон, например страницы 1-10, или открытый диапазон, например страница 3 и далее.188Для больших PDF-файлов вы можете попросить Claude прочитать определенные страницы вместо всего файла: одну страницу, диапазон, например страницы 1-10, или открытый диапазон, например страница 3 и далее. Чтение определенных страниц требует [poppler-utils](/docs/ru/tools-reference#read-tool-behavior) на машине, где работает Claude Code.

185 189

186Когда вы выбираете текст в редакторе, Claude может видеть ваш выделенный код автоматически. Нижняя часть поля ввода подсказки показывает, сколько строк выбрано. Нажмите `Option+K` (Mac) / `Alt+K` (Windows/Linux), чтобы вставить @-упоминание с путем файла и номерами строк (например, `@app.ts#5-10`). Нажмите **X** на индикаторе выделения, чтобы удалить его, чтобы Claude не получал выделение. Индикатор появляется снова, когда вы выбираете другой текст.190Когда вы выбираете текст в редакторе, Claude может видеть ваш выделенный код автоматически. Нижняя часть поля ввода подсказки показывает, сколько строк выбрано. Нажмите `Option+K` (Mac) / `Alt+K` (Windows/Linux), чтобы вставить @-упоминание с путем файла и номерами строк (например, `@app.ts#5-10`). Нажмите **X** на индикаторе выделения, чтобы удалить его, чтобы Claude не получал выделение. Индикатор появляется снова, когда вы выбираете другой текст.

187 191

247</Steps>251</Steps>

248 252

249<Note>253<Note>

250 Только облачные сеансы, начатые с репозитория GitHub, появляются на вкладке Web. Возобновление загружает историю разговора локально; изменения не синхронизируются обратно в claude.ai.254 Когда папка, которую вы открыли, является репозиторием GitHub, вкладка Web показывает только сеансы из этого репозитория.

255

256 Когда вы возобновляете облачный сеанс, расширение загружает копию истории разговора; изменения не синхронизируются обратно в claude.ai.

251</Note>257</Note>

252 258

259Вкладка Web также отображает ваши сеансы [Remote Control](/docs/ru/remote-control). Если вы нажмете на один, который работал в папке, которую вы открыли, расширение открывает этот локальный разговор вместо загрузки копии и фокусирует вкладку, которая уже его показывает, если она есть. Если расширение не может исключить, что другой процесс Claude имеет разговор открытым, вы получите загруженную копию вместо этого.

260

261Если какая-либо часть разговора не загружается, появляется ошибка и копия не сохраняется. Выберите сеанс снова, чтобы повторить попытку. Если вы выберете сеанс, который еще не имеет разговора для загрузки, ошибка скажет вам, где его продолжить вместо этого.

262

253<h3 id="check-account-and-usage">263<h3 id="check-account-and-usage">

254 Проверка учетной записи и использования264 Проверка учетной записи и использования

255</h3>265</h3>

269 Настройте свой рабочий процесс279 Настройте свой рабочий процесс

270</h2>280</h2>

271 281

272Вы можете переместить панель Claude, запустить несколько разговоров, организовать список сеансов в группы или переключиться в режим терминала.282Вы можете переместить панель Claude, запустить несколько разговоров, сгруппировать или отфильтровать список сеансов или переключиться в режим терминала.

273 283

274<h3 id="choose-where-claude-lives">284<h3 id="choose-where-claude-lives">

275 Выберите, где находится Claude285 Выберите, где находится Claude

283 293

284Когда Claude открывает вкладку в новой группе редактора, расширение блокирует эту группу, поэтому файлы, которые вы открываете, пока вкладка Claude сфокусирована, переходят в другую группу вместо того, чтобы находиться рядом с ней.294Когда Claude открывает вкладку в новой группе редактора, расширение блокирует эту группу, поэтому файлы, которые вы открываете, пока вкладка Claude сфокусирована, переходят в другую группу вместо того, чтобы находиться рядом с ней.

285 295

286Чтобы остановить блокировку групп расширением, отключите [параметр Lock Editor Groups](vscode://settings/claudeCode.lockEditorGroups). Группы, которые уже заблокированы, остаются заблокированными, пока вы их не разблокируете. Этот параметр требует Claude Code v2.1.274 или позже.296Чтобы остановить расширение от блокировки групп, отключите [параметр Lock Editor Groups](vscode://settings/claudeCode.lockEditorGroups). Группы, которые уже заблокированы, остаются заблокированными, пока вы их не разблокируете. Этот параметр требует Claude Code v2.1.274 или более поздней версии.

287 297

288<Tip>298<Tip>

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

290</Tip>300</Tip>

291 301

292После запуска **Developer: Reload Window** или перезагрузки VS Code, возвращение чата с его разговором зависит от того, где он был открыт:302После запуска **Developer: Reload Window** или перезагрузки VS Code, вернётся ли разговор со своей историей разговора, зависит от того, где он был открыт:

293 303

294* **Вкладка редактора**: разговор возвращается с его вкладкой.304* **Вкладка редактора**: разговор возвращается со своей вкладкой.

295* **Боковая панель**: разговор возвращается, если вы отправили сообщение или Claude ответил в нём в течение последних 10 минут. Если он не возвращается, возобновите разговор из [истории сеансов](#resume-past-conversations).305* **Боковая панель**: разговор возвращается, если вы отправили сообщение или Claude ответил в нём в течение последних 10 минут. Если он не вернётся, возобновите разговор из [истории сеансов](#resume-past-conversations).

296 306

297Если перезагрузка прервала Claude в середине шага, Claude продолжит этот шаг, когда разговор вернётся, и уведомление в чате отметит продолжение. Требуется Claude Code v2.1.274 или позже. Если шаг был прерван более часа назад или сеанс открыт в другом месте, разговор вернётся в неактивном состоянии.307Если перезагрузка прервала Claude в середине шага, Claude продолжит этот шаг, когда разговор вернётся, и уведомление в чате отметит продолжение. Требует Claude Code v2.1.274 или более поздней версии. Если шаг был прерван более часа назад или сеанс открыт в другом месте, разговор вернётся в режиме ожидания.

298 308

299Чтобы отключить продолжение, откройте [параметр Continue After Reload](vscode://settings/claudeCode.continueAfterReload) и снимите флажок.309Чтобы отключить продолжение, откройте [параметр Continue After Reload](vscode://settings/claudeCode.continueAfterReload) и снимите флажок.

300 310

310 Организуйте сеансы в группы320 Организуйте сеансы в группы

311</h3>321</h3>

312 322

313В списке сеансов на панели действий вы можете собрать связанные сеансы в именованные, сворачиваемые группы. Требуется Claude Code v2.1.229 или позже.323В списке сеансов на панели действий вы можете собрать связанные сеансы в именованные, сворачиваемые группы. Требует Claude Code v2.1.229 или более поздней версии.

314 324

315* **Сгруппировать или разгруппировать сеанс**: щёлкните правой кнопкой мыши на сеансе, чтобы создать группу из него, переместить его в существующую группу или удалить его из его группы. Каждый сеанс принадлежит одной группе одновременно, поэтому перемещение его в другую группу удаляет его из первой.325* **Сгруппировать или разгруппировать сеанс**: щёлкните правой кнопкой мыши на сеансе, чтобы создать группу из него, переместить его в существующую группу или удалить его из его группы. Каждый сеанс принадлежит одной группе одновременно, поэтому перемещение его в другую группу удаляет его из первой.

316* **Переместить несколько сеансов одновременно**: `Cmd`-щелчок (Mac) / `Ctrl`-щелчок (Windows/Linux) на каждом сеансе или `Shift`-щелчок для выбора диапазона, затем щёлкните правой кнопкой мыши на выборе.326* **Переместить несколько сеансов одновременно**: `Cmd`-щелчок (Mac) / `Ctrl`-щелчок (Windows/Linux) на каждом сеансе или `Shift`-щелчок для выбора диапазона, затем щёлкните правой кнопкой мыши на выборе.

317* **Сгруппировать сеанс из его вкладки**: запустите **Claude Code: Add Session Tab to Group** из палитры команд, затем выберите или создайте группу. Требуется Claude Code v2.1.257 или позже.327* **Сгруппировать сеанс из его вкладки**: запустите **Claude Code: Add Session Tab to Group** из палитры команд, затем выберите или создайте группу. Требует Claude Code v2.1.257 или более поздней версии.

318* **Переименовать или удалить группу**: щёлкните правой кнопкой мыши на заголовке группы. Удаление группы удаляет только группу, и её сеансы возвращаются в список без группировки.328* **Переименовать или удалить группу**: щёлкните правой кнопкой мыши на заголовке группы. Удаление группы удаляет только группу, и её сеансы возвращаются в список несгруппированных.

319 329

320Расширение сохраняет группы для каждой папки рабочего пространства, поэтому они сохраняются при перезагрузке окна и появляются в каждом окне, где вы открываете одну и ту же папку. Когда вы ищете в списке, расширение показывает совпадения в одном плоском списке во всех группах.330Расширение сохраняет группы для каждой папки рабочего пространства, поэтому они сохраняются при перезагрузке окна и появляются в каждом окне, где вы открываете одну и ту же папку. Когда вы ищете в списке, расширение показывает совпадения в одном плоском списке во всех группах.

321 331

332<h3 id="filter-the-sessions-list">

333 Отфильтруйте список сеансов

334</h3>

335

336Чтобы сузить длинный список сеансов на панели действий, используйте два элемента управления фильтром в верхней части списка. Требует Claude Code v2.1.271 или более поздней версии. Архивированные сеансы не отображаются, пока включен какой-либо фильтр.

337

338* **Active**: включите этот переключатель, чтобы показать только сеансы, которые требуют вашего ввода, работают или не прочитаны, плюс сеанс на вкладке Claude, на которой вы в последний раз сфокусировались.

339* **Filter by status**: щёлкните на значке воронки, затем установите флажок **Needs input**, **Working** или **Completed**, чтобы показать сеансы в любом из этих состояний. Установите флажок **Open** или **Closed**, чтобы сузить по тому, открыт ли сеанс. Сеанс считается открытым, когда он имеет вкладку в этом окне или работает в другом процессе Claude Code на этой машине, например в терминале.

340

341Когда **Active** включен и вы устанавливаете флажок на статус, **Open** или **Closed**, список также показывает каждый сеанс, который соответствует вашим проверкам. Фильтры, которые вы установили, сохраняются при перезагрузке окна.

342

322<h3 id="switch-to-terminal-mode">343<h3 id="switch-to-terminal-mode">

323 Переключитесь в режим терминала344 Переключитесь в режим терминала

324</h3>345</h3>

506Расширение имеет два типа параметров:527Расширение имеет два типа параметров:

507 528

508* **Параметры расширения** в VS Code: управляют поведением расширения в VS Code. Откройте с помощью `Cmd+,` (Mac) или `Ctrl+,` (Windows/Linux), затем перейдите в Extensions → Claude Code. Вы также можете ввести `/` и выбрать **General config…** для открытия параметров.529* **Параметры расширения** в VS Code: управляют поведением расширения в VS Code. Откройте с помощью `Cmd+,` (Mac) или `Ctrl+,` (Windows/Linux), затем перейдите в Extensions → Claude Code. Вы также можете ввести `/` и выбрать **General config…** для открытия параметров.

509* **Параметры Claude Code** в `~/.claude/settings.json`: общие для расширения и CLI. Используйте для разрешённых команд, переменных окружения, hooks и MCP серверов. На планах Pro, Max и Team это также один из входных параметров режима разрешений, с которого начинаются беседы. [Switch permission modes](/docs/ru/permission-modes#switch-permission-modes) указывает порядок. Подробнее см. [Settings](/docs/ru/settings).530* **Параметры Claude Code** в `~/.claude/settings.json`: общие для расширения и CLI. Используйте для разрешённых команд, переменных окружения, hooks и MCP серверов. С Claude Code v2.1.283 или позже это также один из входных параметров режима разрешений, с которого начинаются беседы, а в более ранних версиях только на планах Pro, Max и Team. [Switch permission modes](/docs/ru/permission-modes#switch-permission-modes) указывает порядок. Подробнее см. [Settings](/docs/ru/settings).

510 531

511<Tip>532<Tip>

512 Добавьте `"$schema": "https://json.schemastore.org/claude-code-settings.json"` в ваш `settings.json`, чтобы получить автодополнение и встроенную проверку для всех доступных параметров прямо в VS Code.533 Добавьте `"$schema": "https://json.schemastore.org/claude-code-settings.json"` в ваш `settings.json`, чтобы получить автодополнение и встроенную проверку для всех доступных параметров прямо в VS Code.

722 743

723**Выделение и контекст открытого файла.** Во время подключения CLI включает ваш текущий выбор в редакторе и путь активного файла в качестве контекста для каждого отправляемого вами запроса. Стенограмма показывает строку `⧉ Selected N lines from <file>` когда это происходит.744**Выделение и контекст открытого файла.** Во время подключения CLI включает ваш текущий выбор в редакторе и путь активного файла в качестве контекста для каждого отправляемого вами запроса. Стенограмма показывает строку `⧉ Selected N lines from <file>` когда это происходит.

724 745

746Если вы [поставите сообщение в очередь, пока Claude работает](/docs/ru/interactive-mode#queue-messages-while-claude-works), он сохранит выделение, которое у вас было, когда вы нажали `Enter`, независимо от того, что вы выберете после этого.

747

725Чтобы исключить конфиденциальный файл, такой как `.env`, добавьте [правило отказа `Read`](/docs/ru/permissions#read-and-edit) для его пути. Соответствующее правило отказа предотвращает как выбранный текст, так и уведомление об открытом файле для этого файла от достижения Claude.748Чтобы исключить конфиденциальный файл, такой как `.env`, добавьте [правило отказа `Read`](/docs/ru/permissions#read-and-edit) для его пути. Соответствующее правило отказа предотвращает как выбранный текст, так и уведомление об открытом файле для этого файла от достижения Claude.

726 749

727Если вы отключите [параметр Attach Open File](#extension-settings), CLI получит путь активного файла только при наличии выделенного текста в нём.750Если вы отключите [параметр Attach Open File](#extension-settings), CLI получит путь активного файла только при наличии выделенного текста в нём.

web-quickstart.md +3 −3

Details

231 231

232Облачные сеансы требуют подключенной учетной записи GitHub. Подключитесь через поток браузера выше или запустите `/web-setup` из терминала, если вы используете GitHub CLI. Если вы предпочитаете вообще не подключать GitHub, смотрите [Remote Control](/docs/ru/remote-control) для запуска Claude Code на вашей машине и мониторинга его из браузера или телефона.232Облачные сеансы требуют подключенной учетной записи GitHub. Подключитесь через поток браузера выше или запустите `/web-setup` из терминала, если вы используете GitHub CLI. Если вы предпочитаете вообще не подключать GitHub, смотрите [Remote Control](/docs/ru/remote-control) для запуска Claude Code на вашей машине и мониторинга его из браузера или телефона.

233 233

234<h3 id="not-available-for-the-selected-organization">234<h3 id="claude-code-isn’t-available-on-your-account">

235 "Not available for the selected organization"235 "Claude Code isn't available on your account"

236</h3>236</h3>

237 237

238Организациям Enterprise может потребоваться владелец для включения облачных сеансов. Свяжитесь с вашей командой учетных записей Anthropic.238Ваше место в выбранной организации не включает Claude Code. Если вы принадлежите другой организации, нажмите **Switch organization** на этой странице. В противном случае попросите владельца организации назначить вам [место, которое включает Claude Code](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan).

239 239

240<h3 id="/web-setup-says-not-signed-in-to-claude">240<h3 id="/web-setup-says-not-signed-in-to-claude">

241 `/web-setup` говорит "Not signed in to Claude"241 `/web-setup` говорит "Not signed in to Claude"

whats-new/2026-w22.md +14 −14

Details

17 <span className="digest-feature-pill">новая модель</span>17 <span className="digest-feature-pill">новая модель</span>

18 </div>18 </div>

19 19

20 <p className="digest-feature-lede">Opus 4.8 теперь используется по умолчанию на Max, Team Premium, Enterprise pay-as-you-go и Anthropic API. По умолчанию установлен высокий уровень усилий; используйте <code>/effort xhigh</code> для более сложных задач. Требуется v2.1.154 или более поздняя версия.</p>20 <p className="digest-feature-lede">Opus 4.8 теперь используется по умолчанию на Max, Team Premium, Enterprise pay-as-you-go и в Anthropic API. По умолчанию установлен высокий уровень усилий; используйте <code>/effort xhigh</code> для более сложных задач. Требуется v2.1.154 или более поздняя версия.</p>

21 21

22 <Frame>22 <Frame>

23 <video autoPlay muted loop playsInline className="w-full" src="https://mintcdn.com/claude-code/QsIrGXGFg6xd7joy/images/whats-new/opus-4-8.mp4?fit=max&auto=format&n=QsIrGXGFg6xd7joy&q=85&s=6ebcf5fe136467da2b254de1fe749ea7" data-path="images/whats-new/opus-4-8.mp4" />23 <video autoPlay muted loop playsInline className="w-full" src="https://mintcdn.com/claude-code/QsIrGXGFg6xd7joy/images/whats-new/opus-4-8.mp4?fit=max&auto=format&n=QsIrGXGFg6xd7joy&q=85&s=6ebcf5fe136467da2b254de1fe749ea7" data-path="images/whats-new/opus-4-8.mp4" />

38 <span className="digest-feature-pill">исследовательский предпросмотр</span>38 <span className="digest-feature-pill">исследовательский предпросмотр</span>

39 </div>39 </div>

40 40

41 <p className="digest-feature-lede">Workflow — это скрипт оркестрации, который Claude пишет для вашей задачи и запускает на множестве подагентов в фоновом режиме. Используйте его, когда задача слишком велика для одного разговора, чтобы координировать: аудит всей кодовой базы, крупная миграция, исследовательский вопрос, требующий перекрестной проверки. Управляйте запусками с помощью <code>/workflows</code>.</p>41 <p className="digest-feature-lede">Workflow — это скрипт оркестрации, который Claude пишет для вашей задачи и запускает на множестве подагентов в фоновом режиме. Используйте его, когда задача слишком велика для одного разговора, чтобы её координировать: аудит всей кодовой базы, крупная миграция, исследовательский вопрос, требующий перекрёстной проверки. Управляйте запусками с помощью <code>/workflows</code>.</p>

42 42

43 <Frame>43 <Frame>

44 <img className="w-full" src="https://mintcdn.com/claude-code/QsIrGXGFg6xd7joy/images/whats-new/dynamic-workflows.png?fit=max&auto=format&n=QsIrGXGFg6xd7joy&q=85&s=26671fa8607cec3453ed9753f821bd4f" alt="Claude Code на Opus 4.8, показывающий индикатор запрошенного Dynamic workflow для подсказки, которая просит workflow для миграции каждого внутреннего вызова fetch()" width="3840" height="2160" data-path="images/whats-new/dynamic-workflows.png" />44 <img className="w-full" src="https://mintcdn.com/claude-code/QsIrGXGFg6xd7joy/images/whats-new/dynamic-workflows.png?fit=max&auto=format&n=QsIrGXGFg6xd7joy&q=85&s=26671fa8607cec3453ed9753f821bd4f" alt="Claude Code на Opus 4.8, показывающий индикатор Dynamic workflow для запроса, который просит создать workflow для миграции каждого внутреннего вызова fetch()" width="3840" height="2160" data-path="images/whats-new/dynamic-workflows.png" />

45 </Frame>45 </Frame>

46 46

47 <p className="digest-feature-try">Опишите задачу и попросите workflow:</p>47 <p className="digest-feature-try">Опишите задачу и попросите workflow:</p>

59 <span className="digest-feature-pill">плагин</span>59 <span className="digest-feature-pill">плагин</span>

60 </div>60 </div>

61 61

62 <p className="digest-feature-lede">Плагин security-guidance проверяет изменения кода Claude на наличие уязвимостей и исправляет их в том же сеансе. Он выполняет быструю проверку шаблонов при каждом редактировании, проверку модели в конце каждого хода и более глубокую проверку агента при коммите или push. Добавьте правила проекта в <code>.claude/claude-security-guidance.md</code>.</p>62 <p className="digest-feature-lede">Плагин security-guidance проверяет изменения кода Claude на наличие уязвимостей и исправляет их в том же сеансе. Он выполняет быструю проверку по шаблонам при каждом редактировании, проверку моделью в конце каждого хода и более глубокую проверку агентом при коммите или push. Добавьте правила проекта в <code>.claude/claude-security-guidance.md</code>.</p>

63 63

64 <Frame>64 <Frame>

65 <video autoPlay muted loop playsInline className="w-full" src="https://mintcdn.com/claude-code/QsIrGXGFg6xd7joy/images/whats-new/security-guidance.mp4?fit=max&auto=format&n=QsIrGXGFg6xd7joy&q=85&s=c91d865936411586f42b24c558bcdd1d" data-path="images/whats-new/security-guidance.mp4" />65 <video autoPlay muted loop playsInline className="w-full" src="https://mintcdn.com/claude-code/QsIrGXGFg6xd7joy/images/whats-new/security-guidance.mp4?fit=max&auto=format&n=QsIrGXGFg6xd7joy&q=85&s=c91d865936411586f42b24c558bcdd1d" data-path="images/whats-new/security-guidance.mp4" />

66 </Frame>66 </Frame>

67 67

~~68 <p className="digest-feature-try">Установите его из официального marketplace Anthropic:</p>~~68 <p className="digest-feature-try">Установите его из официального маркетплейса Anthropic:</p>

69 69

70 ```text title="Claude Code" wrap theme={null}70 ```text title="Claude Code" wrap theme={null}

71 /plugin install security-guidance@claude-plugins-official71 /plugin install security-guidance@claude-plugins-official

86 <span className="digest-feature-pill">исследовательский предпросмотр</span>86 <span className="digest-feature-pill">исследовательский предпросмотр</span>

87 </div>87 </div>

88 88

89 <p className="digest-feature-lede">Fast mode теперь по умолчанию использует Opus 4.8 по цене \$10/\$50 за MTok: в 2 раза выше стандартной ставки для примерно в 2,5 раза большей скорости. Opus 4.7 и 4.6 остаются на \$30/\$150. Fast mode Opus 4.6 устарел.</p>89 <p className="digest-feature-lede">Fast mode теперь по умолчанию использует Opus 4.8 по цене \$10/\$50 за MTok: в 2 раза выше стандартной ставки для примерно в 2,5 раза большей скорости. Opus 4.7 и 4.6 остаются по цене \$30/\$150. Fast mode для Opus 4.6 устарел.</p>

90 90

91 <p className="digest-feature-try">Переключите fast mode, теперь на Opus 4.8:</p>91 <p className="digest-feature-try">Переключите fast mode, теперь на Opus 4.8:</p>

92 92

101 <p className="digest-wins-title">Другие улучшения</p>101 <p className="digest-wins-title">Другие улучшения</p>

102 102

103 <div className="digest-wins-grid">103 <div className="digest-wins-grid">

104 <div>В <code>claude agents</code> добавьте префикс команды оболочки с помощью <code>!</code>, чтобы запустить её как фоновое задание, к которому вы можете подключаться и отключаться; также доступно как <code>claude --bg --exec 'pytest -x'</code></div>104 <div>В <code>claude agents</code> добавьте префикс <code>!</code> к команде shell, чтобы запустить её как фоновое задание, к которому вы можете подключаться и отключаться; также доступно как `claude --bg --exec 'pytest -x'`</div>

105 <div>Плагины в директориях <code>.claude/skills</code> теперь загружаются автоматически, без необходимости в marketplace, и <code>claude plugin init \<name></code> создаёт каркас нового плагина</div>105 <div>Плагины в директориях <code>.claude/skills</code> теперь загружаются автоматически, маркетплейс не требуется, и <code>claude plugin init \<name></code> создаёт каркас нового плагина</div>

106 <div>Новая команда <code>/reload-skills</code> повторно сканирует директории skills без перезагрузки, и hooks <code>SessionStart</code> могут возвращать <code>reloadSkills: true</code>, чтобы сделать skills, которые они устанавливают, доступными в том же сеансе</div>106 <div>Новая команда <code>/reload-skills</code> повторно сканирует директории skills без перезагрузки, и hooks <code>SessionStart</code> могут возвращать <code>reloadSkills: true</code>, чтобы сделать установленные ими skills доступными в том же сеансе</div>

107 <div>Skills и команды могут устанавливать <code>disallowed-tools</code> в frontmatter, чтобы удалить инструменты из модели, пока skill активен</div>107 <div>Skills и команды могут устанавливать <code>disallowed-tools</code> в frontmatter, чтобы удалить инструменты из модели, пока skill активен</div>

108 <div>Новое событие hook <code>MessageDisplay</code> позволяет hooks преобразовывать или скрывать текст сообщения помощника при его отображении</div>108 <div>Новое событие hook <code>MessageDisplay</code> позволяет hooks преобразовывать или скрывать текст сообщения ассистента при его отображении</div>

109 <div>Claude Code теперь переключается на ваш настроенный <code>--fallback-model</code> для остальной части сеанса, когда основная модель не найдена, вместо того чтобы не выполнять каждый запрос</div>109 <div>Claude Code теперь переключается на ваш настроенный `--fallback-model` для остальной части сеанса, когда основная модель не найдена, вместо того чтобы не выполнять каждый запрос</div>

110 <div>Плагины могут объявлять <code>defaultEnabled: false</code> в <code>plugin.json</code> или записи marketplace, поэтому они устанавливаются без включения, пока вы их не включите</div>110 <div>Плагины могут объявлять <code>defaultEnabled: false</code> в <code>plugin.json</code> или записи маркетплейса, поэтому они устанавливаются без включения, пока вы их не включите</div>

111 <div>Режим Vim: <code>/</code> в режиме NORMAL открывает поиск истории в обратном направлении, соответствуя Bash и Zsh vi-mode</div>111 <div>Режим Vim: <code>/</code> в режиме NORMAL открывает поиск по истории в обратном направлении, соответствуя Bash и Zsh vi-mode</div>

112 <div>Потоковое выполнение инструментов теперь всегда включено, включая с отключённой телеметрией и на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry</div>112 <div>Потоковое выполнение инструментов теперь всегда включено, включая с отключённой телеметрией и на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry</div>

113 <div><code>←←</code> для открытия представления agents теперь работает на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и с отключённой телеметрией</div>113 <div><code>←←</code> для открытия представления agents теперь работает на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и с отключённой телеметрией</div>

114 <div>Claude в Chrome: выберите, какой подключённый браузер использовать через <code>/chrome</code> → "Select browser…", или в чате, когда действие браузера выполняется с несколькими подключёнными</div>114 <div>Claude в Chrome: выберите, какой подключённый браузер использовать, через <code>/chrome</code> → "Select browser…", или в чате, когда действие браузера запускается с несколькими подключёнными</div>

115 <div><code>claude mcp list</code> и <code>claude mcp get</code> теперь показывают неодобренные серверы <code>.mcp.json</code> как ожидающие одобрения вместо автоматического одобрения и подключения, когда вывод передаётся по конвейеру</div>115 <div><code>claude mcp list</code> и <code>claude mcp get</code> теперь показывают неодобренные серверы <code>.mcp.json</code> как ожидающие одобрения вместо автоматического одобрения и подключения, когда вывод передаётся по конвейеру</div>

116 </div>116 </div>

117</div>117</div>

whats-new/2026-w24.md +1 −1

Details

42 > /agents42 > /agents

43 ```43 ```

44 44

~~45 <a className="digest-feature-link" href="/docs/ru/sub-agents#spawn-nested-subagents">Создание вложенных подагентов</a>~~45 <a className="digest-feature-link" href="/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents">Создание вложенных подагентов</a>

46</div>46</div>

47 47

48<div className="digest-feature">48<div className="digest-feature">

workflows.md +14 −6

Details

161 Позволить Claude решить с ultracode161 Позволить Claude решить с ultracode

162</h3>162</h3>

163 163

164Ultracode — это параметр Claude Code, который объединяет `xhigh` [усилие рассуждения](/docs/ru/model-config#adjust-effort-level) с автоматической оркестрацией workflow. С ним включённым, Claude планирует workflow для каждой существенной задачи вместо того, чтобы ждать, пока вы попросите.164Ultracode — это параметр Claude Code, который включает автоматическую оркестрацию workflow для сессии на любом [уровне усилий](/docs/ru/model-config#adjust-effort-level), на котором работает сессия. С ним включённым, Claude планирует workflow для каждой существенной задачи вместо того, чтобы ждать, пока вы попросите. Включите его в подсказку Claude Code:

165 165

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

167/effort ultracode167/effort ultracode

168```168```

169 169

170Чтобы начать сессию с уже включённым ultracode, запустите с `claude --effort ultracode`. Требуется Claude Code версии 2.1.203 или позже.170Чтобы начать сессию с уже включённым ultracode, запустите с `claude --effort ultracode`, что также устанавливает уровень усилий на `xhigh`. Требуется Claude Code версии 2.1.203 или позже.

171 171

172Чтобы включить его, пока вы выбираете модель, переместите ползунок усилий средства выбора `/model` на `ultracode` с помощью клавиш со стрелками. [Adjust effort level](/docs/ru/model-config#adjust-effort-level) перечисляет маршруты, которые включают ultracode.172Чтобы включить его с помощью ползунка `/effort`, нажмите `Tab` для переключения переключателя **Ultracode**, затем `Enter` для применения. [Adjust effort level](/docs/ru/model-config#adjust-effort-level) перечисляет маршруты, которые включают ultracode.

173 173

174С ultracode включённым, Claude решает, когда задача требует workflow. Один запрос может превратиться в несколько workflows подряд: один для понимания кода, один для внесения изменения и один для его проверки. Это применяется к каждой задаче в сессии, поэтому каждый запрос использует больше токенов и занимает больше времени, чем на более низких уровнях усилий.174С ultracode включённым, Claude решает, когда задача требует workflow. Один запрос может превратиться в несколько workflows подряд: один для понимания кода, один для внесения изменения и один для его проверки. Это применяется к каждой задаче в сессии, поэтому каждый запрос использует больше токенов и занимает больше времени, чем на более низких уровнях усилий. На плане подписки эти токены расходуют ваши лимиты использования, поэтому сессия с включённым ultracode достигает лимита сессии или недельного лимита раньше, чем та же работа с ним отключённым.

175 175

176`/effort ultracode` длится для текущей сессии; чтобы каждая сессия начиналась с ним, установите параметр [`ultracode`](/docs/ru/settings-reference#ultracode). Вернитесь с `/effort high`, когда вы вернётесь к рутинной работе. Меню `/effort` предлагает это только [когда ultracode доступен](/docs/ru/model-config#when-ultracode-is-available).176Включение ultracode уже предполагает согласие на большие запуски, поэтому эти проверки не применяются, пока он включён:

177

178* Предупреждение [`Large workflow`](#cost) не появляется при запуске workflow

179* [concurrent subagent limit](/docs/ru/sub-agents#concurrent-subagent-limit) сессии не применяется для подагентов, которых Claude создаёт с помощью инструмента Agent

180* В режиме автоматического разрешения вас не просят [одобрить первый запуск workflow](#approve-the-plan-before-it-runs)

181

182`/effort ultracode` длится для текущей сессии; чтобы каждая сессия начиналась с ним, установите параметр [`ultracode`](/docs/ru/settings-reference#ultracode). Отключите его с помощью `/effort ultracode off`, когда вы вернётесь к рутинной работе. Ползунок `/effort` предлагает переключатель только [когда ultracode доступен](/docs/ru/model-config#when-ultracode-is-available).

177 183

178<h3 id="approve-the-plan-before-it-runs">184<h3 id="approve-the-plan-before-it-runs">

179 Одобрить план перед его запуском185 Одобрить план перед его запуском

516 522

517Чтобы отключить workflows для всей вашей организации, установите `"disableWorkflows": true` в [управляемые параметры](/docs/ru/server-managed-settings), или используйте переключатель на странице [параметров администратора Claude Code](https://claude.ai/admin-settings/claude-code).523Чтобы отключить workflows для всей вашей организации, установите `"disableWorkflows": true` в [управляемые параметры](/docs/ru/server-managed-settings), или используйте переключатель на странице [параметров администратора Claude Code](https://claude.ai/admin-settings/claude-code).

518 524

519Когда workflows отключены, встроенные команды workflow и skill `/workflow-authoring` недоступны, ключевое слово `ultracode` больше не запускает запуск, и `ultracode` удаляется из меню `/effort`.525Когда workflows отключены, встроенные команды workflow и skill `/workflow-authoring` недоступны, ключевое слово `ultracode` больше не запускает запуск, и **Ultracode** переключатель удаляется из `/effort`. Запуск, который уже выполняется, продолжает работу.

526

527Отключение workflows также делает [ultracode](#let-claude-decide-with-ultracode) недоступным. Ни один параметр управления не исключает ultracode отдельно: везде, где он [доступен](/docs/ru/model-config#when-ultracode-is-available), пользователи могут включить его с помощью `/effort ultracode`. [Ограничение усилий](/docs/ru/model-config#organization-effort-limits) снижает уровень усилий, на котором работает сессия с включённым ultracode, но не отключает ultracode.

520 528

521<h2 id="related-resources">529<h2 id="related-resources">

522 Связанные ресурсы530 Связанные ресурсы

worktrees.md +4 −4

Details

59 Очистка worktrees59 Очистка worktrees

60</h2>60</h2>

61 61

62Когда вы выходите из интерактивного сеанса worktree, Claude проверяет worktree на наличие работы, которая будет удалена при удалении: изменённые или неотслеживаемые файлы, незафиксированная работа внутри проверенных подмодулей и новые коммиты.62Когда вы выходите из интерактивного сеанса worktree, Claude проверяет worktree на наличие работы, которая будет удалена при удалении: изменённые или неотслеживаемые файлы, незафиксированная работа внутри проверенных подмодулей и новые коммиты. Эти правила применяются к worktrees, которые Claude создал с помощью git. Для worktree, который создал ваш [WorktreeCreate hook](/docs/ru/hooks#worktreecreate), см. вместо этого [WorktreeRemove](/docs/ru/hooks#worktreeremove).

63 63

64* **Worktree чист**: для безымянного сеанса Claude автоматически удаляет worktree и его ветку. [Именованный](/docs/ru/sessions#name-your-sessions) сеанс сначала предлагает вам, чтобы вы могли сохранить worktree на потом64* **Worktree чист**: для безымянного сеанса Claude автоматически удаляет worktree и его ветку. [Именованный](/docs/ru/sessions#name-your-sessions) сеанс сначала предлагает вам, чтобы вы могли сохранить worktree на потом

65* **Worktree содержит работу**: Claude предлагает вам сохранить или удалить worktree. Сохранение сохраняет каталог и ветку, чтобы вы могли вернуться позже. Удаление удаляет каталог worktree и его ветку, вместе со всей работой в них65* **Worktree содержит работу**: Claude предлагает вам сохранить или удалить worktree. Сохранение сохраняет каталог и ветку. Чтобы вернуться позже, запустите команду `claude --worktree <name> --resume`, которую Claude Code выведет при выходе. Удаление удаляет каталог worktree и его ветку, вместе со всей работой в них

66* **Состояние worktree не может быть проверено**: когда Claude Code не может подсчитать изменения worktree или не может проверить проверки его подмодулей, он предлагает вам вместо автоматического удаления worktree. Подсказка указывает, что он не смог проверить66* **Состояние worktree не может быть проверено**: когда Claude Code не может подсчитать изменения worktree или не может проверить проверки его подмодулей, он предлагает вам вместо автоматического удаления worktree. Подсказка указывает, что он не смог проверить

67 67

68Неинтерактивные запуски с `-p` не имеют подсказки выхода, поэтому Claude не очищает их worktrees, и Claude Code оставляет блокировку, которую он взял на каждый при создании, на месте до тех пор, пока более поздний сеанс [очистка устаревших блокировок](#clean-up-subagent-and-background-session-worktrees) не освободит её. Чтобы удалить один, запустите `git worktree remove`; если git отказывает, потому что worktree заблокирован, сначала запустите `git worktree unlock` на нём.68Неинтерактивные запуски с `-p` не имеют подсказки выхода, поэтому Claude не очищает их worktrees, и Claude Code оставляет блокировку, которую он взял на каждый при создании, на месте до тех пор, пока более поздний сеанс [очистка устаревших блокировок](#clean-up-subagent-and-background-session-worktrees) не освободит её. Чтобы удалить один, запустите `git worktree remove`; если git отказывает, потому что worktree заблокирован, сначала запустите `git worktree unlock` на нём.

73 Возобновите сеанс worktree73 Возобновите сеанс worktree

74</h2>74</h2>

75 75

76Когда вы возобновляете сеанс, который был внутри worktree, Claude Code возвращает сеанс в этот worktree. Это применяется к интерактивным возобновлениям, к `--continue` и `--resume` в [неинтерактивном режиме](/docs/ru/headless) с `-p` и к Agent SDK. Вернувшись в worktree, Claude может по-прежнему выйти из него с помощью инструмента [`ExitWorktree`](/docs/ru/tools-reference).76Когда вы возобновляете сеанс, который закончился внутри worktree без [выхода из него](#clean-up-worktrees), Claude Code возвращает сеанс в этот worktree. Это применяется к интерактивным возобновлениям, к `--continue` и `--resume` в [неинтерактивном режиме](/docs/ru/headless) с `-p` и к Agent SDK. `--continue` выбирает самый последний сеанс, записанный в каталоге, из которого вы запускаете. Вернувшись в worktree, Claude может по-прежнему выйти из него с помощью инструмента [`ExitWorktree`](/docs/ru/tools-reference).

77 77

78Перед возвращением сеанса в его worktree Claude Code проверяет, что worktree по-прежнему является отдельной копией от основной, и отказывается повторно входить в worktree, который не проходит проверку. Для git worktree проверка читает его метаданные git. Worktree без метаданных git, такой как тот, который создал hook [`WorktreeCreate`](#non-git-version-control), может пройти проверку; случаи, которые Claude Code по-прежнему отказывается использовать, перечислены с их восстановлением в разделе [Claude Code отказывается использовать worktree](#claude-code-refuses-to-use-a-worktree). Для сообщений и способов восстановления от каждого см. [Сеанс возобновляется вне его worktree](#the-session-resumes-outside-its-worktree).78Перед возвращением сеанса в его worktree Claude Code проверяет, что worktree по-прежнему является отдельной копией от основной, и отказывается повторно входить в worktree, который не проходит проверку. Для git worktree проверка читает его метаданные git. Worktree без метаданных git, такой как тот, который создал hook [`WorktreeCreate`](#non-git-version-control), может пройти проверку; случаи, которые Claude Code по-прежнему отказывается использовать, перечислены с их восстановлением в разделе [Claude Code отказывается использовать worktree](#claude-code-refuses-to-use-a-worktree). Для сообщений и способов восстановления от каждого см. [Сеанс возобновляется вне его worktree](#the-session-resumes-outside-its-worktree).

79 79

80Где вы запускаете и как вы возобновляете, изменяет то, что Claude Code повторно входит:80Где вы запускаете и как вы возобновляете, изменяет то, что Claude Code повторно входит:

81 81

82* **Каталог запуска**: возобновите из основной копии или другого каталога репозитория. Claude Code повторно входит в worktree, который он создал с git в `.claude/worktrees/`, даже когда вы запускаете из него. Когда вы запускаете из любого другого worktree, Claude Code повторно входит в него только если может поручиться за него оттуда: worktree, который является его собственным репозиторием, один без метаданных git, или запуск из подкаталога worktree, который вы создали с `git worktree add`, отказывает, поэтому запускайте их из основной копии.82* **Каталог запуска**: возобновите с помощью `--resume` из основной копии или другого каталога репозитория. Claude Code повторно входит в worktree, который он создал с git в `.claude/worktrees/`, даже когда вы запускаете из него. Когда вы запускаете из любого другого worktree, Claude Code повторно входит в него только если может поручиться за него оттуда: worktree, который является его собственным репозиторием, один без метаданных git, или запуск из подкаталога worktree, который вы создали с `git worktree add`, отказывает, поэтому запускайте их из основной копии.

83* **`--fork-session`**: разветвлённый сеанс начинается в каталоге, из которого вы запустили Claude, и Claude Code оставляет worktree исходного сеанса нетронутым.83* **`--fork-session`**: разветвлённый сеанс начинается в каталоге, из которого вы запустили Claude, и Claude Code оставляет worktree исходного сеанса нетронутым.

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

85 85

Documentation 2026-09-28 22:59 UTC to 2026-09-29 21:02 UTC