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 +1 −1

Details

247 ```247 ```

248 </CodeGroup>248 </CodeGroup>

249 249

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

251 251

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

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

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 +36 −4

Details

305 305

306Для типографики Claude может загружать шрифт из Google Fonts, единственного внешнего источника шрифтов, из которого может загружаться страница артефакта. Claude встраивает любой другой шрифт как `@font-face` data URI и предоставляет каждому шрифту резервный стек, поэтому страница все еще отображается, если шрифт не загружается. Чтобы использовать определенный шрифт, назовите его в вашей подсказке или в вашей системе дизайна.306Для типографики Claude может загружать шрифт из Google Fonts, единственного внешнего источника шрифтов, из которого может загружаться страница артефакта. Claude встраивает любой другой шрифт как `@font-face` data URI и предоставляет каждому шрифту резервный стек, поэтому страница все еще отображается, если шрифт не загружается. Чтобы использовать определенный шрифт, назовите его в вашей подсказке или в вашей системе дизайна.

307 307

308<h2 id="draft-a-design-canvas">308<h2 id="start-from-a-slides-design-or-docs-template">

309 Создание макета дизайна309 Начните с шаблона Slides, Design или Docs

310</h2>310</h2>

311 311

312Чтобы создать макет пользовательского интерфейса, потока экранов, целевой страницы или постера вместо создания страницы, запустите `/design` с кратким описанием. Claude создает дизайн в виде артбордов на одном холсте и публикует холст как артефакт Design. В кратком описании указывается, что вы хотите нарисовать:312Вместо создания страницы с нуля 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.

313

314Чтобы начать с шаблона, опишите, что вы хотите, например «превратите заметки о миграции в презентацию для обзора в четверг» или «оформите этот план как документ для команды». Claude выбирает подходящий шаблон, заполняет его на основе вашего запроса и того, что уже есть в сеансе, и дает вам ссылку. Для презентации или дизайна вы также можете запустить `/slides` или `/design` с кратким описанием.

315

316<Note>

317 Шаблоны находятся в бета-версии. Они включены по умолчанию в планах 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).

318</Note>

319

320<h3 id="make-a-slide-deck">

321 Создайте слайд-шоу

322</h3>

323

324Запустите `/slides` с кратким описанием, которое говорит, что охватывает презентация и для кого она предназначена:

325

326```text wrap theme={null}

327/slides a quarterly review of the platform team's reliability work, for the engineering all-hands

328```

329

330Claude создает артефакт Claude Slides и дает вам ссылку. Откройте его в браузере рабочего стола, чтобы редактировать или представить презентацию. Если вы запустите `/slides` без краткого описания, Claude спросит, о чем должна быть презентация, прежде чем что-либо создавать.

331

332<h3 id="draft-a-design-canvas">

333 Создайте макет дизайна

334</h3>

335

336Чтобы создать макет пользовательского интерфейса, потока экранов, целевой страницы или постера вместо создания страницы, запустите `/design` с кратким описанием. Claude создает дизайн в виде артбордов на одном холсте и публикует холст как артефакт Claude Design. В кратком описании указывается, что вы хотите нарисовать:

313 337

314```text wrap theme={null}338```text wrap theme={null}

315/design a settings screen for a mobile banking app339/design a settings screen for a mobile banking app

317 341

318Откройте опубликованный артефакт в браузере рабочего стола для просмотра артбордов. Выберите элемент на артборде и измените его, и ваши правки сохранятся автоматически. Вы можете экспортировать каждый артборд как PNG или PDF.342Откройте опубликованный артефакт в браузере рабочего стола для просмотра артбордов. Выберите элемент на артборде и измените его, и ваши правки сохранятся автоматически. Вы можете экспортировать каждый артборд как PNG или PDF.

319 343

320`/design` требует сеанса, где [артефакты доступны](#availability), и Claude Code версии 2.1.265 или более поздней.344<h3 id="write-a-document-with-claude-docs">

345 Напишите документ с помощью Claude Docs

346</h3>

347

348Claude Docs подключается к Claude Code как [соединитель](/docs/ru/mcp#use-mcp-servers-from-claude-ai) claude.ai, а не как команда. Когда он подключен, `/mcp` отображает его как `claude.ai Claude Docs`. Запрос на документ, предназначенный для других людей, затем переходит в Claude Docs вместо страницы артефакта: спецификация, предложение или описание плана, который вы разработали в сеансе. Claude дает вам ссылку на документ, когда он создан.

349

350Документ, который принадлежит кодовой базе, например README, остается файлом. Чтобы получить файл для чего-то, что Claude иначе поместил бы в Claude Docs, укажите формат, например `.docx` или файл Markdown в репозитории.

351

352Чтобы отключить соединитель, добавьте `claude.ai Claude Docs` в `deniedMcpServers` или используйте переключатель `/mcp`, оба описаны в разделе [Отключение соединителей claude.ai](/docs/ru/mcp#disable-claude-ai-connectors).

321 353

322<h2 id="page-constraints">354<h2 id="page-constraints">

323 Ограничения страницы355 Ограничения страницы

authentication.md +33 −7

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

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

172 180

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` не входят в эти исключения, поэтому держите их в обоих местах.181Развертывайте ключи через инструменты управления устройствами. [Параметры, управляемые сервером](/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 182

183В развертывании [шлюза](/docs/ru/claude-apps-gateway) также держите `forceLoginMethod` и `forceLoginOrgUUID` вне [параметров, которые служит шлюз](/docs/ru/claude-apps-gateway-config#managed).

184

175Ключи также определяют, может ли сеанс, который не использует учетные данные входа, начаться. См. [`forceLoginOrgUUID`](/docs/ru/settings-reference#forceloginorguuid) в справочнике параметров для полного поведения.185Ключи также определяют, может ли сеанс, который не использует учетные данные входа, начаться. См. [`forceLoginOrgUUID`](/docs/ru/settings-reference#forceloginorguuid) в справочнике параметров для полного поведения.

176 186

177* **`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`**: заблокированы при запуске, так как членство в организации не может быть проверено для учетных данных окружения187* **`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**: не заблокированы, потому что они аутентифицируются против вашего облачного провайдера. Ограничьте их через ваши политики облачного IAM188* **Сеансы облачного провайдера, такие как Amazon Bedrock**: заблокированы только пока учетные данные `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, или ключ API, сохраненный более ранним входом Claude Console, все еще присутствуют на машине. Удалите его и сеанс начнется. Эти сеансы аутентифицируются против вашего облачного провайдера, политики доступа которого их регулируют

179* **[Профиль Anthropic или учетные данные федерации](#anthropic-profiles-and-federation-credentials)**: не заблокированы, и ключи не проверяют, какой организации принадлежит профиль189* **[Профиль Anthropic или учетные данные федерации](#anthropic-profiles-and-federation-credentials)**: не заблокированы, если только учетные данные `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, или ключ API, сохраненный более ранним входом Claude Console, также не присутствуют на машине. Удалите его и сеанс начнется. Ключи не проверяют, какой организации принадлежит профиль

180 190

181<h2 id="credential-management">191<h2 id="credential-management">

182 Управление учетными данными192 Управление учетными данными

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 +9 −6

Details

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Изображения, которые вы вставили или прикрепили в сеансах проекта, и [временная память](/docs/ru/scratchpad#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 +16 −3

Details

281 Что доступно в облачных сеансах281 Что доступно в облачных сеансах

282</h2>282</h2>

283 283

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.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, и [ограничения времени](#time-limits) на долгоживущую работу.

285 285

286<Note>286<Note>

287 Сеансы, которые ваша организация маршрутизирует в [самостоятельно размещённую среду](/docs/ru/self-hosted-environments), работают на ваших собственных runners вместо этого, с инструментами, которые предоставляет образ вашего runner.287 Сеансы, которые ваша организация маршрутизирует в [самостоятельно размещённую среду](/docs/ru/self-hosted-environments), работают на ваших собственных runners вместо этого, с инструментами, которые предоставляет образ вашего runner.

421 421

422Виртуальная машина может остановить задачи, которые требуют значительно больше памяти, такие как большие работы сборки или тесты, требующие много памяти. Для рабочих нагрузок, превышающих эти ограничения, используйте [Remote Control](/docs/ru/remote-control), чтобы запустить Claude Code на вашем собственном оборудовании, или запустите облачные сеансы в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments) на вычислениях, которые работает ваша организация.422Виртуальная машина может остановить задачи, которые требуют значительно больше памяти, такие как большие работы сборки или тесты, требующие много памяти. Для рабочих нагрузок, превышающих эти ограничения, используйте [Remote Control](/docs/ru/remote-control), чтобы запустить Claude Code на вашем собственном оборудовании, или запустите облачные сеансы в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments) на вычислениях, которые работает ваша организация.

423 423

424<h3 id="time-limits">

425 Ограничения времени

426</h3>

427

428В среде, размещённой Anthropic, эти ограничения времени применяются к долгоживущей работе в облачном сеансе, такой как сборка, установка или запуск теста. Каждая запись ссылается на раздел, который определяет ограничение.

429

430* **Команды, которые запускает Claude**: облачная среда не устанавливает свой собственный timeout команды, поэтому применяются значения по умолчанию инструмента Bash. Claude ждёт команду 2 минуты по умолчанию и может запросить до 10 минут. Когда команда достигает своего [timeout](/docs/ru/tools-reference#timeout-and-output-limits), Claude Code [перемещает её в фон](/docs/ru/tools-reference#background-commands) вместо того, чтобы остановить её, если только команда не начинается с `sleep`.

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

432* **Setup script**: скрипт, который занимает больше примерно пяти минут, не кэшируется. [Требования скрипта](#script-requirements) охватывает, как оставаться ниже этого.

433* **Idle sessions**: сеанс останавливается после периода неактивности и его VM восстанавливается. [Environment expired](/docs/ru/claude-code-on-the-web#environment-expired) охватывает, что считается неактивным и как повторно открыть сеанс.

434

435Чтобы повысить timeouts команд для сеансов среды, добавьте [`BASH_DEFAULT_TIMEOUT_MS` и `BASH_MAX_TIMEOUT_MS`](/docs/ru/env-vars#variables) в её [переменные среды](#set-environment-variables). Оба принимают миллисекунды. Например, `BASH_DEFAULT_TIMEOUT_MS=600000` делает 10 минут значением по умолчанию.

436

424<h2 id="setup-scripts">437<h2 id="setup-scripts">

425 Скрипты установки438 Скрипты установки

426</h2>439</h2>

445Скрипт установки имеет три ограничения для работы:458Скрипт установки имеет три ограничения для работы:

446 459

447* **Выход с нулём**: если скрипт выходит с ненулевым значением, сеанс не запускается. Добавьте `|| true` к некритичным командам, чтобы перебой установки не блокировал сеанс.460* **Выход с нулём**: если скрипт выходит с ненулевым значением, сеанс не запускается. Добавьте `|| true` к некритичным командам, чтобы перебой установки не блокировал сеанс.

448* **Завершение в течение пяти минут**: держите общее время выполнения скрипта примерно под пять минут, чтобы [кэш среды](#environment-caching) мог построиться. Запускайте независимые установки параллельно с `&` и `wait`, и переместите любую одиночную загрузку, которая не подходит, в [hook SessionStart](#setup-scripts-vs-sessionstart-hooks), который запускает её в фоне.461* **Завершение в течение пяти минут**: держите общее время выполнения скрипта примерно под пять минут, чтобы [кэш среды](#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** сетевым доступом установки не удаются.462* **Сетевой доступ для установок**: установки пакетов должны достичь реестров. Уровень **Trusted** по умолчанию охватывает [общие реестры пакетов](#default-allowed-domains), включая npm, PyPI, RubyGems и crates.io; с **None** сетевым доступом установки не удаются.

450 463

451<h3 id="environment-caching">464<h3 id="environment-caching">

452 Кэширование среды465 Кэширование среды

453</h3>466</h3>

454 467

455Скрипт установки запускается в первый раз, когда вы запускаете сеанс в среде. После его завершения Anthropic создаёт снимок файловой системы и повторно использует этот снимок как начальную точку для более поздних сеансов. Новые сеансы начинаются с ваших зависимостей, инструментов и образов Docker уже на диске и пропускают шаг скрипта установки. Это держит запуск быстрым, даже когда скрипт устанавливает большие цепочки инструментов или получает образы контейнеров.468Скрипт установки запускается в первый раз, когда вы запускаете сеанс в среде. Когда установка завершается в течение [примерно пяти минут](#script-requirements), Anthropic создаёт снимок файловой системы и повторно использует этот снимок как начальную точку для более поздних сеансов. Новые сеансы начинаются с ваших зависимостей, инструментов и образов Docker уже на диске и пропускают шаг скрипта установки. Это держит запуск быстрым, даже когда скрипт устанавливает большие цепочки инструментов или получает образы контейнеров. Если установка занимает больше времени, чем примерно пять минут, среда не кэшируется.

456 469

457Кэш — это снимок файловой системы, поэтому он сохраняет то, что скрипт установки пишет на диск, и теряет всё, что было только работающим. Пакеты, которые вы устанавливаете, образы Docker, которые вы получаете, и файлы, которые вы пишете, все переносятся. База данных, которую запустил скрипт, стек `docker compose up` или любой другой фоновый процесс не переносятся; запускайте их для каждого сеанса, попросив Claude или с помощью [hook SessionStart](#setup-scripts-vs-sessionstart-hooks).470Кэш — это снимок файловой системы, поэтому он сохраняет то, что скрипт установки пишет на диск, и теряет всё, что было только работающим. Пакеты, которые вы устанавливаете, образы Docker, которые вы получаете, и файлы, которые вы пишете, все переносятся. База данных, которую запустил скрипт, стек `docker compose up` или любой другой фоновый процесс не переносятся; запускайте их для каждого сеанса, попросив Claude или с помощью [hook SessionStart](#setup-scripts-vs-sessionstart-hooks).

458 471

code-review.md +2 −2

Details

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 +5 −4

Details

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**Быстрые победы для попытки в первую очередь**

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 +2 −2

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 Локальные сеансы на управляемых устройствах

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 +404 −31

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

77| `Not signed in to the Cloud gateway — run /login.` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |83| `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) |84| `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) |85| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |

86| `Could not refresh your login because another Claude Code process is refreshing it` | [Authentication](#could-not-refresh-your-login) |

87| `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) |88| `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) |89| `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) |90| `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) |129| `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) |

131| `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) |134| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Request errors](#prompt-is-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) |

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

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) |271| `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) |272| `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) |273| `Refusing to write through symlink: <path>` / `Refusing to write into symlinked directory: <path>` | [Tool errors](#refusing-after-a-symlink-changed) |

274| `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) |275| `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) |276| `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) |278| `Command killed: its output file was replaced or could no longer be verified` | [Tool errors](#task-output-swap-refused) |

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

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

281| `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) |282| `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) |284| `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) |307| `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) |308| `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) |

309| `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) |310| `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) |312| `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) |319| `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) |320| `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) |321| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |

322| `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) |323| `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) |324| `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) |326| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |

327| `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) |328| `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) |329| `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) |330| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |

390 420

391Завершающее предложение указывает, где проверить здоровье сервиса и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry указывают на страницу статуса этого поставщика. Пользовательский `ANTHROPIC_BASE_URL` указывает на хост шлюза.421Завершающее предложение указывает, где проверить здоровье сервиса и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry указывают на страницу статуса этого поставщика. Пользовательский `ANTHROPIC_BASE_URL` указывает на хост шлюза.

392 422

393Это указывает на неожиданный сбой внутри API. Это не вызвано вашим приглашением, настройками или учетной записью.4235xx от самого API указывает на неожиданный сбой внутри API. Это не вызвано вашим приглашением, настройками или учетной записью.

424

425Когда прокси, балансировщик нагрузки или шлюз отвечает страницей ошибки HTML, сообщение показывает код состояния и заголовок страницы, такой как `API Error: 502 Bad Gateway`. Для страницы без заголовка сообщение показывает код состояния и его стандартное имя вместо этого. До v2.1.281 код состояния был удален, когда страница имела заголовок, и разметка страницы была напечатана в сыром виде, когда она не имела.

394 426

395**Что делать:**427**Что делать:**

396 428

416 448

417* Проверьте [status.claude.com](https://status.claude.com) или страницу статуса поставщика, указанную в сообщении, на предмет уведомлений о емкости449* Проверьте [status.claude.com](https://status.claude.com) или страницу статуса поставщика, указанную в сообщении, на предмет уведомлений о емкости

418* Повторите попытку через несколько минут450* Повторите попытку через несколько минут

419* Запустите `/model` и переключитесь на другую модель, чтобы продолжить работу, так как емкость отслеживается для каждой модели. Claude Code предлагает вам это сделать, когда одна модель испытывает особенно высокую нагрузку, например `Opus is experiencing high load, please use /model to switch to Sonnet`.451* Запустите `/model` и переключитесь на другую модель, чтобы продолжить работу, так как емкость отслеживается для каждой модели. Claude Code предлагает вам это сделать, когда одна модель испытывает особенно высокую нагрузку, например `Opus is experiencing high load, please use /model to switch to Sonnet`. На моделях Fable сообщение называет Fable.

452

453 В сессии, которую запускает приложение Claude Desktop, такой как вкладка Code или Cowork, сообщение читается как `Opus is experiencing high load. Switch to Sonnet.` и вы переключаете модели с помощью средства выбора модели приложения.

420 454

421<h3 id="request-timed-out">455<h3 id="request-timed-out">

422 Request timed out456 Request timed out

474API Error: Connection lost mid-response. The response above may be incomplete.508API 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.509API 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.510API Error: The response stopped arriving. The response above may be incomplete.

511API Error: Part of the response never arrived. The response above may be incomplete.

512API Error: The response stream was malformed. The response above may be incomplete.

477```513```

478 514

479* `Server error mid-response`: ошибка сервера перегрузки или 5xx в середине потока. Этот вариант требует Claude Code v2.1.199 или позже; до этого этот случай отбросил частичный выход и сообщил весь ход как ошибку.515* `Server error mid-response`: ошибка сервера перегрузки или 5xx в середине потока. Этот вариант требует Claude Code v2.1.199 или позже; до этого этот случай отбросил частичный выход и сообщил весь ход как ошибку.

480* `Connection lost mid-response`: соединение разорвалось.516* `Connection lost mid-response`: соединение разорвалось. Вы также видите этот вариант, когда прокси или шлюз завершает тело ответа чистым образом перед завершением ответа.

481* `Your computer went to sleep mid-response`: Claude Code обнаружил, что ваш компьютер перешел в режим сна во время потоковой передачи ответа. После пробуждения компьютера Claude Code рассматривает соединение как разорванное и прекращает чтение из него.517* `Your computer went to sleep mid-response`: Claude Code обнаружил, что ваш компьютер перешел в режим сна во время потоковой передачи ответа. После пробуждения компьютера Claude Code рассматривает соединение как разорванное и прекращает чтение из него.

518* `Part of the response never arrived`: событие потока было потеряно между API и Claude Code, поэтому более позднее событие ссылалось на содержимое, которое никогда не прибыло. До v2.1.281 этот случай завершал ход с `API Error: Content block not found`.

519* `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).520* `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 521

484До v2.1.227 `Connection lost mid-response` читалось как `Connection closed mid-response` и `The response stopped arriving` читалось как `Response stalled mid-stream`.522До v2.1.227 `Connection lost mid-response` читалось как `Connection closed mid-response` и `The response stopped arriving` читалось как `Response stalled mid-stream`.

485 523

524Когда опущенное, дублированное или поврежденное событие потока прибывает до того, как Claude начал какой-либо текст или вызов инструмента, вы не видите это уведомление:

525

526* Если 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.`

527* Если ничего не завершилось, 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` или ошибкой парсера.

528

486В четырех случаях Claude Code обрабатывает сбой без отображения этого уведомления сразу:529В четырех случаях Claude Code обрабатывает сбой без отображения этого уведомления сразу:

487 530

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

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 context711API 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```712```

670 713

714В сеансе, который запускает Claude Desktop app, подсказка не называет команды: она указывает на страницу параметров использования claude.ai, или на планах Team и Enterprise говорит включить кредиты использования на claude.ai/admin-settings/usage или попросить вашего администратора.

715

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]` и шлюз решает, будет ли запрос успешным.716Это проверка прав доступа, а не исчерпание квоты. Она срабатывает даже когда ваши лимиты сеанса и недели имеют оставшуюся ёмкость. См. [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]` и шлюз решает, будет ли запрос успешным.

672 717

673Когда эта ошибка появляется в середине разговора, потому что контекст вырос более чем на 200K токенов, Claude Code автоматически сжимает разговор обратно под стандартный лимит контекста и сохраняет сеанс на этом лимите впоследствии, поэтому никаких действий не требуется. В версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая `/compact`; запустите `/clear` на этих версиях для восстановления. Приведённые ниже шаги применяются, когда вы явно выбрали модель `[1m]`.718Когда эта ошибка появляется в середине разговора, потому что контекст вырос более чем на 200K токенов, Claude Code автоматически сжимает разговор обратно под стандартный лимит контекста и сохраняет сеанс на этом лимите впоследствии, поэтому никаких действий не требуется. В версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая `/compact`; запустите `/clear` на этих версиях для восстановления. Приведённые ниже шаги применяются, когда вы явно выбрали модель `[1m]`.

733 778

734Завершающее предложение называет, где проверить здоровье сервиса, и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry называют страницу статуса этого поставщика вместо страницы статуса Anthropic. Пользовательский `ANTHROPIC_BASE_URL` называет хост шлюза.779Завершающее предложение называет, где проверить здоровье сервиса, и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry называют страницу статуса этого поставщика вместо страницы статуса Anthropic. Пользовательский `ANTHROPIC_BASE_URL` называет хост шлюза.

735 780

781Когда прокси, балансировщик нагрузки или шлюз между Claude Code и API отвечает своей собственной HTML-страницей 429, текст после `·` — это название этой страницы, если оно есть, например `Too Many Requests`. До версии v2.1.281 вся разметка страницы была напечатана после `·`.

782

736**Что делать:**783**Что делать:**

737 784

738* Запустите `/status` и подтвердите, что активные учётные данные — это те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может маршрутизировать запросы через низкоуровневый ключ вместо вашей подписки.785* Запустите `/status` и подтвердите, что активные учётные данные — это те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может маршрутизировать запросы через низкоуровневый ключ вместо вашей подписки.

839Not logged in · Please run /login886Not logged in · Please run /login

840```887```

841 888

889В сеансе, который запускает приложение Claude Desktop, например вкладка Code или Cowork, сообщение читается `Authentication required · Sign in again to continue`, и вы входите снова из приложения.

890

842**Что делать:**891**Что делать:**

843 892

844* Запустите `/login` для аутентификации с помощью вашей подписки Claude или учетной записи Console893* Запустите `/login` для аутентификации с помощью вашей подписки Claude или учетной записи Console

985Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead1034Your 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 account1035Your 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 account1036Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

1037Your organization has disabled API key authentication · Sign in again with your claude.ai account

988```1038```

989 1039

1040Последняя форма появляется в сеансе, который запускает приложение Claude Desktop, например вкладка Code или Cowork, где вы входите снова из приложения.

1041

990Переменные окружения и `apiKeyHelper` имеют приоритет над `/login`, поэтому запуск только `/login` не помогает, пока один из них все еще предоставляет ключ. См. [Authentication precedence](/docs/ru/authentication#authentication-precedence).1042Переменные окружения и `apiKeyHelper` имеют приоритет над `/login`, поэтому запуск только `/login` не помогает, пока один из них все еще предоставляет ключ. См. [Authentication precedence](/docs/ru/authentication#authentication-precedence).

991 1043

992**Что делать:**1044**Что делать:**

1203* В неинтерактивном режиме запустите `claude` в том же окружении, завершите `/login`, затем перезапустите вашу команду. Для автоматизации, которая не может войти интерактивно, аутентифицируйтесь с помощью `ANTHROPIC_API_KEY` или [generate a long-lived token with `claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token).1255* В неинтерактивном режиме запустите `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)1256* Если вход продолжает не удаваться, см. [Login and authentication](/docs/ru/troubleshoot-install#login-and-authentication)

1205 1257

1258<h3 id="could-not-refresh-your-login">

1259 Could not refresh your login because another Claude Code process is refreshing it

1260</h3>

1261

1262Это сообщение не означает, что ваш вход был отклонен. Ваш сохраненный вход claude.ai истек и нуждался в обновлении. Другой процесс Claude Code на той же машине держал общую блокировку обновления, или вышел и оставил ее позади, и обновление не прогрессировало, пока этот сеанс ждал. Claude Code останавливает запрос перед отправкой:

1263

1264```text theme={null}

1265Could 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

1266```

1267

1268В [non-interactive mode](/docs/ru/headless) (`-p`) и [Agent SDK](/docs/ru/agent-sdk/overview) сообщение читается следующим образом, и код структурированной ошибки — `server_error`:

1269

1270```text theme={null}

1271Failed 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

1272```

1273

1274Сеансы, аутентифицированные с помощью ключа API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars) или поставщика третьей стороны, не используют сохраненный вход и никогда не видят это сообщение.

1275

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

1277

1278* Попробуйте снова через минуту. Если другой процесс завершит обновление первым, этот сеанс использует обновленный вход.

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

1280* Если оно возвращается без другого запущенного процесса Claude Code, запустите `/login`. Повторный вход не ждет блокировку обновления.

1281

1282<h3 id="couldnt-save-your-login">

1283 Couldn't save your login

1284</h3>

1285

1286Вы вошли с claude.ai, но Claude Code не мог сохранить вход в его хранилище учетных данных, поэтому вход не завершился. На macOS это может произойти, когда цепочка входа блокируется, например при спящем режиме или неактивности, после того как Claude Code уже прочитал или сохранил учетные данные в ней во время того же сеанса.

1287

1288```text theme={null}

1289Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.

1290Couldn't save your login. Try logging in again.

1291```

1292

1293Первая форма появляется на macOS, а вторая везде. Временный сбой хранилища учетных данных, такой как время ожидания или нечитаемое хранилище, производит то же сообщение.

1294

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

1296

1297* На macOS разблокируйте цепочку входа, затем запустите `/login` снова

1298* На других платформах запустите `/login` снова

1299* Если вход все еще не сохраняется, см. [Not logged in or token expired](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired) для команды разблокировки цепочки и других шагов восстановления хранилища учетных данных

1300

1206<h3 id="claude-login-not-accepted">1301<h3 id="claude-login-not-accepted">

1207 Claude login not accepted1302 Claude login not accepted

1208</h3>1303</h3>

1677 1772

1678Если `curl` успешен, но Claude Code всё ещё не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:1773Если `curl` успешен, но Claude Code всё ещё не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:

1679 1774

1775* Проверьте, установлена ли переменная `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 в частности может унаследовать неработающий распознаватель от хоста.1776* На Linux и WSL проверьте `/etc/resolv.conf` на наличие недостижимого сервера имён. WSL в частности может унаследовать неработающий распознаватель от хоста.

1681* На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте `ifconfig` на наличие устаревших интерфейсов `utun` и удалите сетевое расширение VPN в System Settings.1777* На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте `ifconfig` на наличие устаревших интерфейсов `utun` и удалите сетевое расширение VPN в System Settings.

1682* Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.1778* Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.

1897* Запустите новый сеанс с помощью `claude --remote-control`, чтобы создать новый сеанс Remote Control1993* Запустите новый сеанс с помощью `claude --remote-control`, чтобы создать новый сеанс Remote Control

1898* Для других сообщений запуска Remote Control см. [Troubleshoot Remote Control](/docs/ru/remote-control#troubleshooting)1994* Для других сообщений запуска Remote Control см. [Troubleshoot Remote Control](/docs/ru/remote-control#troubleshooting)

1899 1995

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).1996Если сервер вместо этого сообщает, что предыдущий сеанс исчез, вы не видите это сообщение. Claude Code запускает новый сеанс на его месте или показывает [`Previous session is unavailable — run /remote-control to start a new one`](/docs/ru/remote-control#previous-session-is-unavailable).

1901 1997

1902<h3 id="sessions-ended-while-this-machine-was-offline">1998<h3 id="sessions-ended-while-this-machine-was-offline">

1903 Sessions ended while this machine was offline1999 Sessions ended while this machine was offline

1931* Запустите `/feedback` для отправки стенограммы с описанием того, что произошло. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде2027* Запустите `/feedback` для отправки стенограммы с описанием того, что произошло. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде

1932* Если другие запросы также не удаются, проверьте ваше сетевое соединение и см. [Unable to connect to API](#unable-to-connect-to-api)2028* Если другие запросы также не удаются, проверьте ваше сетевое соединение и см. [Unable to connect to API](#unable-to-connect-to-api)

1933 2029

2030<h3 id="couldnt-send-feedback">

2031 Couldn't send feedback

2032</h3>

2033

2034Вы отправили отчёт из диалогового окна [`/feedback`, `/bug`, или `/share`](/docs/ru/commands#all-commands) и загрузка в Anthropic не удалась. Диалоговое окно сохраняет ваш текст, чтобы вы могли повторить попытку.

2035

2036```text theme={null}

2037Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.

2038```

2039

2040Текст после префикса указывает, что не удалось:

2041

2042* **`: not signed in. Run /login, then retry.`**: диалоговое окно загружает только когда Claude Code нашёл учётные данные Anthropic при его открытии, и ни один из них не был пригоден к использованию к моменту отправки. Например, вы вышли на этой машине в то же время, или ваш вход больше не может быть обновлён.

2043* **Скобка**: `(server returned <status>)` — это код ответа сервиса; `(request timed out)` и `(couldn't reach the service)` — это сетевые сбои. Когда Claude Code не может назвать причину, скобка отсутствует.

2044

2045В [feedback drafts queue](/docs/ru/tools-reference#sendfeedback-tool-behavior) тот же сбой заканчивается с `The draft is still queued. Try again later.` вместо этого, и черновик остаётся в очереди для другой попытки.

2046

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

2048

2049* Для формулировки не подписано, запустите `/login` и отправьте снова

2050* В противном случае отправьте снова; если другие запросы также не удаются, проверьте ваше сетевое соединение и см. [Unable to connect to API](#unable-to-connect-to-api)

2051* Если это продолжает не удаваться, подайте отчёт на [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues), как говорит сообщение

2052

2053До версии v2.1.281 каждая отправка не удавалась с этим сообщением один раз, когда Remote Control **Stop** или срочное кросс-сеансовое сообщение прибыло, пока диалоговое окно было открыто. На этих версиях закройте диалоговое окно, откройте его снова и отправьте снова.

2054

1934<h2 id="request-errors">2055<h2 id="request-errors">

1935 Ошибки запроса2056 Ошибки запроса

1936</h2>2057</h2>

2070Когда запрос прошёл прямо в Claude API и сам API отклонил его, Claude Code измеряет разговор и формулирует сообщение в зависимости от того, может ли работать восстановление. Через прокси, шлюз или поставщика облачных услуг вы получаете общее сообщение. Измеренные формы:2191Когда запрос прошёл прямо в Claude API и сам API отклонил его, Claude Code измеряет разговор и формулирует сообщение в зависимости от того, может ли работать восстановление. Через прокси, шлюз или поставщика облачных услуг вы получаете общее сообщение. Измеренные формы:

2071 2192

2072* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: изображения или документы превысили лимит запроса. Claude Code повторяет попытку с их удалением.2193* `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) сообщение говорит вам уменьшить входные данные или начать новый сеанс.2194* `Request too large for the API's 32MB request limit`: сами сообщения превышают лимит, поэтому сообщение говорит `compacting cannot make it fit` и Claude Code не повторяет попытку. В [неинтерактивном режиме](/docs/ru/headless) сообщение говорит вам уменьшить входные данные или начать новый сеанс вместо этого.

2074 2195

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 показывал совет о вложениях для каждого отклонения, даже когда компактирование не могло помочь.2196До версии 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 2197

2185* Удалите или [отключите](/docs/ru/mcp#disable-a-server-without-removing-it) MCP сервер, который объявляет недействительную схему. Ошибка называет инструмент только по позиции. На v2.1.216 или позже проверьте журнал каждого сервера для строки, называющей инструмент, чья схема входных данных будет отклонена. Если ни один журнал не называет один, отключайте серверы по одному.2306* Удалите или [отключите](/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).2307* Если вы поддерживаете сервер, исправьте `input_schema` инструмента. Схема должна быть действительной JSON Schema, и имена свойств верхнего уровня должны быть от 1 до 64 символов в длину и использовать только буквы ASCII и цифры, `_`, `.` и `-`. Смотрите [Tools with invalid input schemas](/docs/ru/mcp#tools-with-invalid-input-schemas).

2187 2308

2309<h3 id="tool-use-name-over-200-characters">

2310 tool\_use.name over 200 characters

2311</h3>

2312

2313Вызов инструмента в истории разговора содержит имя, превышающее 200 символов, которые API принимает в запросе:

2314

2315```text theme={null}

2316API Error: 400 ... tool_use.name: String should have at most 200 characters

2317```

2318

2319Claude Code обрезает такое имя до 200 символов, когда ответ прибывает и когда загружает сохранённый разговор, поэтому вызов завершается с обычной ошибкой инструмента `No such tool available` и разговор продолжается без этой ошибки API.

2320

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

2322

2323* Запустите `claude update`, затем возобновите разговор. Обновленная версия восстанавливает переполненное имя при загрузке расшифровки, поэтому разговор, который был застрял, снова работает.

2324

2325До версии 2.1.281 переполненное имя оставалось в истории и API отклонял каждый запрос, который повторно отправлял разговор, включая `/compact` и `--resume`, поэтому эта ошибка повторялась и разговор был застрял.

2326

2188<h3 id="theres-an-issue-with-the-selected-model">2327<h3 id="theres-an-issue-with-the-selected-model">

2189 There's an issue with the selected model2328 There's an issue with the selected model

2190</h3>2329</h3>

2216Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?2355Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

2217```2356```

2218 2357

2219Конечная подсказка называет ближайший соответствующий псевдоним или ID модели. Когда ничего не достаточно близко, она читается `Run /model to see available models.` вместо этого.2358Конечная подсказка называет ближайший соответствующий псевдоним или ID модели. Когда ничего не достаточно близко, она читается `Run /model to see available models.` вместо этого. В сеансе, который [Desktop app](/docs/ru/desktop) запускает для вас, подсказка без совпадения читается `Switch to a different model.`

2220 2359

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).2360Claude 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 2361

2245* Если вы ввели полный ID, проверьте его в каталоге моделей вашего поставщика. Недавно запущенная модель может быть доступна на Anthropic API перед тем, как ваш поставщик или регион её предложит.2384* Если вы ввели полный ID, проверьте его в каталоге моделей вашего поставщика. Недавно запущенная модель может быть доступна на Anthropic API перед тем, как ваш поставщик или регион её предложит.

2246* До версии 2.1.265 `/model` также отклонял написание псевдонима `opusplan[1m]` с этой ошибкой. В этих версиях обновите Claude Code или установите модель в [settings](/docs/ru/model-config#setting-your-model) или с помощью `--model` вместо этого.2385* До версии 2.1.265 `/model` также отклонял написание псевдонима `opusplan[1m]` с этой ошибкой. В этих версиях обновите Claude Code или установите модель в [settings](/docs/ru/model-config#setting-your-model) или с помощью `--model` вместо этого.

2247 2386

2387<h3 id="api-error-model-not-changed">

2388 API error when checking the picked model

2389</h3>

2390

2391Вы выбрали модель с `/model <имя>`, или приложение, подключённое к сеансу, запросило переключение. API отклонил минимальный запрос, который Claude Code отправляет для проверки модели, по причине, которая не имеет собственной записи, такой как ограничение скорости или ошибка сервера. Сеанс сохраняет свою текущую модель, и сообщение заканчивается, говоря об этом:

2392

2393```text theme={null}

2394API error: 429 <объяснение сервера> · model not changed

2395```

2396

2397Середина сообщения — это статус HTTP и собственное объяснение сервера.

2398

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

2400

2401* Действуйте в соответствии с объяснением сервера; для ограничения скорости или статуса 5xx подождите и выберите модель снова

2402* Отказы с собственной формулировкой охватываются окружающими записями, такими как [Model not found](#model-not-found) и [Model is restricted by your organization's settings](#model-is-restricted-by-your-organizations-settings)

2403

2248<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">2404<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">

2249 Claude Opus is not available with the Claude Pro plan2405 Claude Opus is not available with the Claude Pro plan

2250</h3>2406</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.2411Claude 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```2412```

2257 2413

2414В сеансе, который Claude Desktop app запускает, сообщение говорит `sign out and sign in again` вместо названия команд.

2415

2258**Что делать:**2416**Что делать:**

2259 2417

2260* Запустите `/model` и выберите модель, которую включает ваш план2418* Запустите `/model` и выберите модель, которую включает ваш план

2287 Model is restricted by your organization's settings2445 Model is restricted by your organization's settings

2288</h3>2446</h3>

2289 2447

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.2448Администратор вашей организации отключил эту модель в консоли администратора 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 2449

2292```text theme={null}2450```text theme={null}

2293Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.2451Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

2294```2452```

2295 2453

2454Ввод `/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.`

2455

2296Уведомление с префиксом имени агента, навыка или команды означает, что ограничение применилось к [запрошенной модели подагента](/docs/ru/sub-agents#choose-a-model): подагент работает на подставленной модели и модель вашего сеанса не изменяется. До версии 2.1.223 Claude Code показывал уведомление только для подагентов, запущенных с помощью инструмента Agent.2456Уведомление с префиксом имени агента, навыка или команды означает, что ограничение применилось к [запрошенной модели подагента](/docs/ru/sub-agents#choose-a-model): подагент работает на подставленной модели и модель вашего сеанса не изменяется. До версии 2.1.223 Claude Code показывал уведомление только для подагентов, запущенных с помощью инструмента Agent.

2297 2457

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 псевдоним семейства был подставлен или отклонен на основе только его новейшей версии, даже когда была разрешена более старая версия того же семейства.2458Claude 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 2514

2355**Что делать:**2515**Что делать:**

2356 2516

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 или позже2517* Запустите `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 вместо этого2518* Если вы не можете обновиться, запустите `/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 или позже2519* Если вы столкнулись с этим в [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 2520

2361<h3 id="effort-isnt-available-with-thinking-turned-off">2521<h3 id="effort-isnt-available-with-thinking-turned-off">

2362 Effort isn't available with thinking turned off2522 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)2528API 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```2529```

2370 2530

2531Подсказка после `·` варьируется в зависимости от сеанса: в неинтерактивном сеансе она читается `use --effort high (or the effortLevel setting)`, и в сеансе, который Claude Desktop app запускает, она читается `you can lower effort to High`.

2532

2371**Что делать:**2533**Что делать:**

2372 2534

2373* [Понизьте уровень усилий](/docs/ru/model-config#set-the-effort-level) до `high` или ниже.2535* [Понизьте уровень усилий](/docs/ru/model-config#set-the-effort-level) до `high` или ниже.

2385API Error: 400 ... max_tokens must be greater than thinking.budget_tokens2547API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

2386```2548```

2387 2549

2388Claude Code автоматически регулирует эти значения на Anthropic API. Вы обычно видите эту ошибку на Amazon Bedrock или Google Cloud's Agent Platform, когда [`MAX_THINKING_TOKENS`](/docs/ru/env-vars) установлен выше лимита вывода поставщика, или когда режим плана повышает бюджет мышления.2550Claude Code автоматически регулирует эти значения на Anthropic API. Вы обычно видите эту ошибку на Amazon Bedrock или Google Cloud's Agent Platform, когда [`MAX_THINKING_TOKENS`](/docs/ru/env-vars) установлен выше лимита вывода поставщика, или когда Plan Mode повышает бюджет мышления.

2389 2551

2390**Что делать:**2552**Что делать:**

2391 2553

2411**Что делать:**2573**Что делать:**

2412 2574

2413* Если вы используете Opus 4.7 или Opus 4.8, сначала запустите `claude update`. Версии до v2.1.156 могут вызвать эту ошибку во время нормального использования инструмента, и `/rewind` её не очищает.2575* Если вы используете Opus 4.7 или Opus 4.8, сначала запустите `claude update`. Версии до v2.1.156 могут вызвать эту ошибку во время нормального использования инструмента, и `/rewind` её не очищает.

2414* Запустите `/rewind` или нажмите Esc дважды, чтобы вернуться к контрольной точке перед повреждённым ходом и продолжить оттуда. Смотрите [Checkpointing](/docs/ru/checkpointing) для того, как создаются и восстанавливаются контрольные точки.2576* Запустите `/rewind` или нажмите Esc дважды, чтобы вернуться к checkpoint перед повреждённым ходом и продолжить оттуда. Смотрите [Checkpointing](/docs/ru/checkpointing) для того, как создаются и восстанавливаются checkpoints.

2577

2578<h3 id="invalid-data-in-redacted-thinking-block">

2579 Invalid data in redacted\_thinking block

2580</h3>

2581

2582API отклонил запрос с 400, потому что он не смог принять блок `redacted_thinking`, который более ранний ход в истории разговора содержит.

2583

2584```text theme={null}

2585API Error: 400 ... Invalid `data` in `redacted_thinking` block

2586```

2587

2588Claude Code оставляет мышление разговора из более ранних ходов вне запроса и повторяет один раз, поэтому сеанс продолжается без показа ошибки. До версии 2.1.282 Claude Code сохранял отклонённый блок, и каждый более поздний ход завершался с той же ошибкой.

2589

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

2591

2592* Если вы на v2.1.281 или раньше и каждый ход завершается с этой ошибкой, запустите `claude update` и возобновите сеанс

2593* Если ошибка сохраняется, запустите `/clear` для начала разговора, который не содержит блок

2415 2594

2416<h3 id="unsupported-tool-content-removed">2595<h3 id="unsupported-tool-content-removed">

2417 Unsupported tool content removed2596 Unsupported tool content removed

2458API отклонил запрос с 400, потому что история разговора содержит размещённое содержимое веб-поиска, которое он не может расшифровать. Формулировка называет поле, которое он не может прочитать:2637API отклонил запрос с 400, потому что история разговора содержит размещённое содержимое веб-поиска, которое он не может расшифровать. Формулировка называет поле, которое он не может прочитать:

2459 2638

2460```text theme={null}2639```text theme={null}

2461API Error: 400 messages.21.content.0: Invalid `encrypted_content` in `search_result` block2640API Error: 400 ... Invalid `encrypted_content` in `search_result` block

2462API Error: 400 messages.21.content.3.citations.0: Invalid `encrypted_index` in `text` block2641API Error: 400 ... Invalid `encrypted_index` in `text` block

2463API Error: 400 Failed to decrypt web search result content2642API Error: 400 ... Failed to decrypt web search result content

2643API Error: 400 ... Invalid `encrypted_stdout` in `encrypted_code_execution_result` block

2464```2644```

2465 2645

2466Результаты из размещённого [инструмента веб-поиска](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) API содержат зашифрованные поля, которые только API может прочитать. API отклоняет запрос, который воспроизводит содержимое, которое он не может расшифровать, такое как содержимое, созданное для другой организации.2646Результаты из размещённого [инструмента веб-поиска](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) API содержат зашифрованные поля, которые только API может прочитать. Формулировка `encrypted_stdout` называет вывод размещённой программы выполнения кода, которая прочитала такие результаты, которые API также шифрует. API отклоняет запрос, который воспроизводит содержимое, которое он не может расшифровать, такое как содержимое, созданное для другой организации.

2467 2647

2468Собственный [инструмент WebSearch](/docs/ru/tools-reference#websearch-tool-behavior) Claude Code записывает результаты поиска как простой текст, поэтому эти блоки обычно достигают разговора через прокси или [LLM gateway](/docs/ru/llm-gateway), который сам запустил размещённый веб-поиск.2648Собственный [инструмент WebSearch](/docs/ru/tools-reference#websearch-tool-behavior) Claude Code записывает результаты поиска как простой текст, поэтому эти блоки обычно достигают разговора через прокси или [LLM gateway](/docs/ru/llm-gateway), который сам запустил размещённый веб-поиск.

2469 2649

2470Отклонённые блоки остаются в истории разговора, поэтому каждый более поздний ход и `/compact` завершаются с той же ошибкой.2650Для трёх формулировок веб-поиска Claude Code оставляет вызовы поиска, результаты и цитаты вне того, что он отправляет, и повторяет запрос один раз, поэтому сеанс продолжается без показа ошибки. Формулировка `encrypted_stdout` не имеет такого восстановления, поэтому это сообщение всё ещё достигает вас. До версии 2.1.282 Claude Code сохранял отклонённые блоки веб-поиска тоже, и каждый более поздний ход и `/compact` завершались с той же ошибкой.

2471 2651

2472**Что делать:**2652**Что делать:**

2473 2653

2474* Запустите `/clear` или начните новый сеанс; новый разговор не содержит отклонённые блоки2654* Если вы на v2.1.281 или раньше и каждый ход завершается с одной из формулировок веб-поиска, запустите `claude update` и возобновите сеанс

2655* Если ошибка сохраняется, или сообщение называет `encrypted_stdout`, запустите `/rewind` для возврата к checkpoint перед ходом, который добавил содержимое, или запустите `/clear` для начала разговора, который не содержит его

2475* Если вы запускаете Claude Code позади прокси или шлюза, сообщите об ошибке тому, кто его управляет2656* Если вы запускаете Claude Code позади прокси или шлюза, сообщите об ошибке тому, кто его управляет

2476 2657

2477<h3 id="usage-policy-refusal">2658<h3 id="usage-policy-refusal">

2478 Usage Policy refusal2659 Usage Policy refusal

2479</h3>2660</h3>

2480 2661

2481API отклонил ответ, потому что содержимое в разговоре вызвало проверку [Usage Policy](https://www.anthropic.com/legal/aup). Сообщение включает ID запроса, который вы можете привести в поддержку, если вы считаете, что отказ неправильный.2662API отклонил ответ, потому что содержимое в разговоре вызвало проверку [Usage Policy](https://www.anthropic.com/legal/aup).

2663

2664Сообщение включает Request ID и Message ID, которые вы можете привести в поддержку, если вы считаете, что отказ неправильный.

2482 2665

2483```text theme={null}2666```text theme={null}

2484API Error: Opus 4.6 can't help with this. Start a new session to continue.2667API Error: Opus 4.6 can't help with this. Start a new session to continue.

2494 2677

2495**Что делать:**2678**Что делать:**

2496 2679

2497* Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к контрольной точке перед ходом, который вызвал отказ, затем переформулируйте или возьмите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).2680* Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к checkpoint перед ходом, который вызвал отказ, затем переформулируйте или возьмите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).

2498* Если вы не можете определить, какой ход вызвал это, запустите `/clear`, чтобы начать свежий разговор в том же проекте. Ваш предыдущий разговор сохраняется на диске и остаётся доступным в `/resume`.2681* Если вы не можете определить, какой ход вызвал это, запустите `/clear`, чтобы начать свежий разговор в том же проекте. Ваш предыдущий разговор сохраняется на диске и остаётся доступным в `/resume`.

2499* В [неинтерактивном режиме](/docs/ru/headless) (`-p`), где перемотка недоступна, повторите попытку с переформулированным prompt в новом сеансе без `--continue`. Проверки политики варьируются в зависимости от модели, поэтому переключение на другую модель с помощью `--model` также может разрешить отказ в некоторых случаях.2682* В [неинтерактивном режиме](/docs/ru/headless) (`-p`), где перемотка недоступна, повторите попытку с переформулированным prompt в новом сеансе без `--continue`. Проверки политики варьируются в зависимости от модели, поэтому переключение на другую модель с помощью `--model` также может разрешить отказ в некоторых случаях.

2500 2683

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-claude2691API 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```2692```

2510 2693

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) вместо показа этой ошибки.2694Сообщение ссылается на [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 2695

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).2696На [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 2697

2520 2703

2521* Если ваша работа требует этого содержимого, подайте заявку на доступ через [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)2704* Если ваша работа требует этого содержимого, подайте заявку на доступ через [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)

2522* Если ваш запрос не был о теме кибербезопасности, запустите `/feedback`, чтобы сообщить о ложном срабатывании2705* Если ваш запрос не был о теме кибербезопасности, запустите `/feedback`, чтобы сообщить о ложном срабатывании

2523* Чтобы продолжить работу в том же сеансе, нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к контрольной точке перед ходом, который вызвал флаг, затем возьмите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).2706* Чтобы продолжить работу в том же сеансе, нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к checkpoint перед ходом, который вызвал флаг, затем возьмите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).

2524 2707

2525<h2 id="installation-errors">2708<h2 id="installation-errors">

2526 Ошибки установки2709 Ошибки установки

2600 Неверная конфигурация --agents2783 Неверная конфигурация --agents

2601</h3>2784</h3>

2602 2785

2603Значение, которое вы передали в `--agents`, недействительно, поэтому `claude` выходит с кодом 1 вместо запуска сеанса. Когда вы передаёте `--safe-mode`, `--resume` или `--continue`, или устанавливаете [`CLAUDE_CODE_SAFE_MODE`](/docs/ru/env-vars#variables), Claude Code не проверяет значение и запускает сеанс. До версии 2.1.242 Claude Code запускал сеанс в любом случае и пропускал определения, которые не мог загрузить.2786Значение, которое вы передали в `--agents`, недействительно, поэтому `claude` выходит с кодом 1 вместо запуска сеанса. Когда вы передаёте `--safe-mode` или устанавливаете [`CLAUDE_CODE_SAFE_MODE`](/docs/ru/env-vars#variables), Claude Code игнорирует `--agents` полностью. С `--resume` или `--continue`, встроенное значение JSON не проверяется и сеанс запускается; значение, прочитанное из файла, проверяется при каждом запуске. До версии 2.1.242 Claude Code запускал сеанс в любом случае и пропускал определения, которые не мог загрузить.

2604 2787

2605```text theme={null}2788```text theme={null}

2606Error: Invalid --agents configuration:2789Error: Invalid --agents configuration:

2609 2792

2610То, что следует после первой строки, зависит от того, как значение не прошло проверку. Claude Code выполняет эти проверки по порядку и останавливается на первой, которая не пройдена. Если ваше значение имеет два вида проблем, вы видите второе только после исправления первого:2793То, что следует после первой строки, зависит от того, как значение не прошло проверку. Claude Code выполняет эти проверки по порядку и останавливается на первой, которая не пройдена. Если ваше значение имеет два вида проблем, вы видите второе только после исправления первого:

2611 2794

26121. Когда значение не анализируется как JSON, Claude Code выводит одну строку `invalid JSON:` с собственным сообщением парсера JSON27951. Когда значение начинается с `{`, но не анализируется как JSON, или содержимое файла `--agents` не анализируется, Claude Code выводит одну строку `invalid JSON:` с собственным сообщением парсера JSON

26132. Когда оно анализируется, но определение агента не соответствует схеме для [подагентов, определённых в CLI](/docs/ru/sub-agents#choose-the-subagent-scope), Claude Code выводит одну строку на проблему27962. Когда оно анализируется, но определение агента не соответствует схеме для [подагентов, определённых в CLI](/docs/ru/sub-agents#choose-the-subagent-scope), Claude Code выводит одну строку на проблему

26143. Когда имя агента начинается с `-`, Claude Code выводит `<name>: agent names must not start with '-'`27973. Когда имя агента начинается с `-`, Claude Code выводит `<name>: agent names must not start with '-'`

2615 2798

2616Когда строк проблем больше 20, Claude Code выводит первые 20 и заменяет остальные на `…and N more`.2799Когда строк проблем больше 20, Claude Code выводит первые 20 и заменяет остальные на `…and N more`.

2617 2800

2801С `--print`, `--agents` также принимает [путь к файлу JSON](/docs/ru/sub-agents#choose-the-subagent-scope) вместо встроенного объекта. До версии 2.1.281 `--agents` принимал только встроенный JSON и рассматривал путь к файлу как недействительный JSON. Форма файла имеет свои отказы, выводимые вместо этого сообщения, включая эти:

2802

2803* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code прочитал значение как путь к файлу в интерактивном сеансе. Передайте определения как встроенный JSON или добавьте `-p` для чтения их из файла.

2804* **`Error: --agents file not found: <path>`**: файл не существует по этому пути. Значение, которое не начинается с `{` и не является действительным JSON, читается как путь, поэтому встроенный JSON, который ваша оболочка испортила, может не пройти таким образом. Проверьте путь или кавычки и запустите команду снова.

2805

2618**Что делать:**2806**Что делать:**

2619 2807

2620* Исправьте каждую проблему, которую указывает сообщение, затем запустите команду снова. См. [поля, которые принимает подагент, определённый в CLI](/docs/ru/sub-agents#choose-the-subagent-scope).2808* Исправьте каждую проблему, которую указывает сообщение, затем запустите команду снова. См. [поля, которые принимает подагент, определённый в CLI](/docs/ru/sub-agents#choose-the-subagent-scope).

2762 Рабочее пространство не доверено при запуске Remote Control2950 Рабочее пространство не доверено при запуске Remote Control

2763</h3>2951</h3>

2764 2952

2765Вы запустили сервер [Remote Control](/docs/ru/remote-control) в режиме с помощью `claude remote-control` или его псевдонима `claude rc` в каталоге, которому вы не доверяете. Команда не показывает диалог доверия рабочего пространства сама по себе, поэтому она выходит с кодом 1 и указывает исправление:2953Вы запустили сервер [Remote Control](/docs/ru/remote-control) в режиме с помощью `claude remote-control` или его псевдонима `claude rc` в каталоге, которому вы не доверяете, и команда не может спросить вас, доверяете ли вы ему. Это сообщение появляется, когда стандартный ввод или стандартный вывод команды не является терминалом, например потому что один из них перенаправлен или передан по конвейеру. Команда выходит с кодом 1:

2766 2954

2767```text theme={null}2955```text theme={null}

2768Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.2956Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.

2769```2957```

2770 2958

2959Два варианта, которые также начинаются с `Error: Workspace not trusted.`, появляются в терминале, который слишком мал для отображения того, что включает доверие к каталогу, или в терминале, который не сообщил о своём размере. Увеличьте окно или переключитесь на обычное окно терминала, затем запустите `claude rc` снова.

2960

2771В вашем домашнем каталоге сообщение отличается, потому что диалог доверия рабочего пространства никогда не сохраняет доверие для домашнего каталога, поэтому принятие его там не может удовлетворить эту проверку. До версии 2.1.214 домашний каталог показывал сообщение выше, совет которого не может быть успешным там.2961В вашем домашнем каталоге сообщение отличается, потому что диалог доверия рабочего пространства никогда не сохраняет доверие для домашнего каталога, поэтому принятие его там не может удовлетворить эту проверку. До версии 2.1.214 домашний каталог показывал сообщение выше, совет которого не может быть успешным там.

2772 2962

2773```text theme={null}2963```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).2964Error: 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```2965```

2776 2966

2967Если вы ответите `n` или нажмёте Enter на вопрос [`Trust <directory>?`](/docs/ru/remote-control#requirements), команда выводит сообщение `Remote Control did not start`, которое указывает каталог и выходит с кодом 1. Запустите `claude rc` снова, чтобы ответить `y`.

2968

2777**Что делать:**2969**Что делать:**

2778 2970

2779* Запустите `claude` в каталоге, примите [диалог доверия рабочего пространства](/docs/ru/permissions#project-allow-rules-and-workspace-trust), затем запустите `claude remote-control` снова2971* Доверьте каталогу из терминала сначала: запустите `claude rc` там и ответьте `y`, или запустите `claude` там и примите [диалог доверия рабочего пространства](/docs/ru/permissions#project-allow-rules-and-workspace-trust), затем запустите вашу исходную команду снова

2780* В вашем домашнем каталоге перейдите в проектный каталог и запустите Remote Control там2972* В вашем домашнем каталоге перейдите в проектный каталог и запустите Remote Control там

2781 2973

2974До версии 2.1.284 команда никогда не спрашивала, даже в терминале.

2975

2782<h3 id="not-carried-over-to-the-sessions-remote-control-starts">2976<h3 id="not-carried-over-to-the-sessions-remote-control-starts">

2783 Не перенесено в сеансы, которые запускает Remote Control2977 Не перенесено в сеансы, которые запускает Remote Control

2784</h3>2978</h3>

3275* Для интерактивного сеанса откройте [средство выбора сеанса](/docs/ru/sessions#use-the-session-picker) с помощью `claude --resume` и нажмите `Ctrl+A` для расширения на каждый проект на этой машине, затем выберите сеанс3469* Для интерактивного сеанса откройте [средство выбора сеанса](/docs/ru/sessions#use-the-session-picker) с помощью `claude --resume` и нажмите `Ctrl+A` для расширения на каждый проект на этой машине, затем выберите сеанс

3276* Сеансы, созданные с помощью `claude -p` или [Agent SDK](/docs/ru/agent-sdk/overview), не появляются в средстве выбора, поэтому повторно проверьте ID против `session_id`, который выводит ваш исходный запуск3470* Сеансы, созданные с помощью `claude -p` или [Agent SDK](/docs/ru/agent-sdk/overview), не появляются в средстве выбора, поэтому повторно проверьте ID против `session_id`, который выводит ваш исходный запуск

3277 3471

3472<h3 id="windows-reported-an-error-ebadf">

3473 Windows reported an error (EBADF) when Claude Code read this session's transcript file

3474</h3>

3475

3476Вы возобновили сеанс на Windows, его сохранённый [файл стенограммы](/docs/ru/sessions#where-transcripts-are-stored) открылся нормально, и чтение его затем не прошло с системной ошибкой EBADF. Системная ошибка не говорит, почему чтение не прошло, поэтому сообщение предлагает вероятные причины и что попробовать:

3477

3478```text theme={null}

3479Windows 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.

3480```

3481

3482Сообщение следует за собственной строкой отказа команды, такой как `Failed to resume session <session-id>`. Команда `claude --resume` или [`claude -p`](/docs/ru/headless) выходит с кодом 1 после показа её. После `/resume` внутри сеанса ваш текущий сеанс продолжает работать.

3483

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

3485

3486* Исключите папку, которая содержит ваши стенограммы сеанса, из программного обеспечения, которое сканирует или перехватывает чтение файлов, такого как инструменты безопасности, шифрования или управления конечными точками. Стенограммы находятся под `%USERPROFILE%\.claude\projects` по умолчанию, или под каталогом, который [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars) указывает

3487* Если вы не можете добавить исключение, добавьте Claude Code в разрешённые приложения этого программного обеспечения вместо этого

3488* Возобновите сеанс снова

3489

3490До версии 2.1.282 отказ пришёл без объяснения: `claude --resume <session-id>` закончился на `Failed to resume session <session-id>`, и запуск `-p` выводил только текст системной ошибки, такой как `Failed to resume session: EBADF: bad file descriptor, read`.

3491

3278<h3 id="cannot-switch-renderers-in-this-session">3492<h3 id="cannot-switch-renderers-in-this-session">

3279 Не удалось переключить рендеры в этом сеансе3493 Cannot switch renderers in this session

3280</h3>3494</h3>

3281 3495

3282Когда вы переключаете рендеры, Claude Code перезапускает свой процесс. Вы запустили [`/tui`](/docs/ru/fullscreen#enable-fullscreen-rendering) в сеансе, который Claude Code отказывает перезапускать, поэтому он не переключается и ничего не сохраняет. Какое сообщение вы видите, говорит вам причину:3496Когда вы переключаете рендеры, Claude Code перезапускает свой процесс. Вы запустили [`/tui`](/docs/ru/fullscreen#enable-fullscreen-rendering) в сеансе, который Claude Code отказывает перезапускать, поэтому он не переключается и ничего не сохраняет. Какое сообщение вы видите, говорит вам причину:

3458* Переименуйте маркетплейс на имя, которое не соответствует зарезервированному имени, и добавьте его снова3672* Переименуйте маркетплейс на имя, которое не соответствует зарезервированному имени, и добавьте его снова

3459* Для предупреждения об игнорируемой записи запустите команду `claude plugin marketplace remove`, которую оно даёт, или удалите запись из `~/.claude/plugins/known_marketplaces.json`3673* Для предупреждения об игнорируемой записи запустите команду `claude plugin marketplace remove`, которую оно даёт, или удалите запись из `~/.claude/plugins/known_marketplaces.json`

3460 3674

3675<h3 id="claude-code-refuses-the-marketplace-name">

3676 Claude Code refuses the marketplace name

3677</h3>

3678

3679Имя зарегистрированного маркетплейса [выдаёт себя за официальный маркетплейс Anthropic](/docs/ru/plugins/marketplace-reference#reserved-names) в соответствии с правилами, которые перечисляет этот раздел.

3680

3681Если маркетплейс был зарегистрирован под таким именем до того, как проверка его заблокировала, маркетплейс и плагины, установленные из него, перестают загружаться, потому что Claude Code проверяет имя каждый раз при чтении каталога маркетплейса. Когда имя имитирует официальное, `claude plugin list` и вкладка **Errors** в `/plugin` сообщают о каждом затронутом плагине с сообщением, которое начинается с:

3682

3683```text theme={null}

3684Claude Code refuses the marketplace name "anthropic-plugins-v2"

3685```

3686

3687Для имитирующего имени ошибка самого маркетплейса читается как `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`.

3688

3689До версии v2.1.282 `claude plugin list` и `/plugin` сообщали о плагинах имитирующего имени как не загруженных, без указания имени маркетплейса как причины.

3690

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

3692

3693* Запустите `claude plugin marketplace remove <name>`. Это также удаляет плагины, установленные из маркетплейса, и удаляет их сохранённые данные

3694* Чтобы сохранить маркетплейс, дождитесь, пока его разработчик переименует его, затем запустите `claude plugin marketplace update <name>`

3695* Если вы публикуете маркетплейс, переименуйте его в вашем `marketplace.json`; пользователи затем обновят маркетплейс вместо его удаления

3696

3461<h3 id="marketplace-is-already-added-from-a-different-source">3697<h3 id="marketplace-is-already-added-from-a-different-source">

3462 Marketplace is already added from a different source3698 Marketplace is already added from a different source

3463</h3>3699</h3>

3660 3896

3661* Попросите администратора вашей организации claude.ai изменить статус обязательности плагина на claude.ai3897* Попросите администратора вашей организации claude.ai изменить статус обязательности плагина на claude.ai

3662 3898

3899<h3 id="plugin-was-not-uninstalled">

3900 Plugin was not uninstalled

3901</h3>

3902

3903Вы запустили [`claude plugin uninstall`](/docs/ru/plugins/cli-reference#plugin-uninstall), или выбрали **Uninstall** на вкладке `/plugin` **Installed**, и удаление остановилось с сообщением, начинающимся с `"<plugin>" was not uninstalled:`.

3904

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

3906

3907```text theme={null}

3908✘ 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.

3909```

3910

3911Середина сообщения называет файл и причину:

3912

3913* `it is still switched on in <file>, although the settings change reported no error`: запись параметров сообщила об успехе, но запись всё ещё там при чтении файла обратно

3914* `it is still switched on in <file>, and the settings change failed (<error>)`: файл не мог быть сохранён по причине в скобках

3915* `<file> is there and could not be read`: файл существует, но не мог быть прочитан как параметры, например потому что это не действительный JSON, поэтому он может всё ещё включить плагин

3916* `<file> (not read: it is on a network path or is a link to one, or could not be checked)`: Claude Code не прочитала файл параметров проекта или локальных параметров, потому что файл, или папка `.claude`, которая его содержит, это ссылка, которая ведёт на сетевое расположение, или потому что она не могла проверить этот путь

3917

3918`claude plugin uninstall` выходит с кодом 1, и с `--json` результат несёт `failureCode: "settings_still_on"`. `/plugin` показывает то же сообщение.

3919

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

3921

3922* Следуйте последнему предложению сообщения: исправьте или замените файл параметров, который оно называет, или удалите запись плагина из `enabledPlugins` в этом файле самостоятельно, затем запустите удаление снова

3923

3663<h2 id="tool-errors">3924<h2 id="tool-errors">

3664 Ошибки инструментов3925 Ошибки инструментов

3665</h2>3926</h2>

3709* Если Claude должен иметь возможность изменять файл, удалите или сузьте правило отказа `Read` в `/permissions` или в [параметрах](/docs/ru/settings-reference#permission-settings)3970* Если Claude должен иметь возможность изменять файл, удалите или сузьте правило отказа `Read` в `/permissions` или в [параметрах](/docs/ru/settings-reference#permission-settings)

3710* Если файл должен остаться нетронутым, сохраните правило и добавьте правило отказа `Edit` для того же пути, чтобы также заблокировать инструмент NotebookEdit3971* Если файл должен остаться нетронутым, сохраните правило и добавьте правило отказа `Edit` для того же пути, чтобы также заблокировать инструмент NotebookEdit

3711 3972

3973<h3 id="path-cannot-contain-null-bytes">

3974 Path cannot contain null bytes

3975</h3>

3976

3977Аргумент пути или шаблона вызова инструмента файла содержал нулевой байт, который файловые системы и инструменты поиска не могут принять. Read, Write, Edit, NotebookEdit, Glob и Grep проверяют это, и сообщение называет инструмент и аргумент:

3978

3979```text theme={null}

3980Read file_path cannot contain null bytes (\0). Remove the null byte and try again.

3981```

3982

3983Вызов инструмента не удаётся, Claude видит ошибку, и ход продолжается.

3984

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

3986

3987* Ничего с вашей стороны: ошибка возвращается Claude как результат инструмента, и само сообщение говорит Claude удалить нулевой байт и повторить попытку

3988

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

3990

3712<h3 id="subagent-type-is-required">3991<h3 id="subagent-type-is-required">

3713 subagent\_type is required3992 subagent\_type is required

3714</h3>3993</h3>

3889 4168

3890* `its symlink resolution changed after permission was checked`: символическая ссылка вдоль пути или в корне поиска Grep или Glob была заменена между проверкой разрешения и операцией. В отказе чтения фраза в скобках называет, какое сравнение не удалось.4169* `its symlink resolution changed after permission was checked`: символическая ссылка вдоль пути или в корне поиска Grep или Glob была заменена между проверкой разрешения и операцией. В отказе чтения фраза в скобках называет, какое сравнение не удалось.

3891* `its parent-directory symlink resolution changed after permission was checked`: каталог, через который проходит путь записи, больше не разрешается в одобренное место4170* `its parent-directory symlink resolution changed after permission was checked`: каталог, через который проходит путь записи, больше не разрешается в одобренное место

4171* `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 к цели ссылки4172* `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`4173* `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/` проекта, связанный с другим местоположением4174* `Refusing to write into symlinked directory: <path>`: каталог, который содержит файл, сам является символической ссылкой, например каталог `.claude/` проекта, связанный с другим местоположением

3907 4187

3908До версии 2.1.251 Claude Code повторно проверял разрешение пути только для записей файлов, поэтому ссылка, заменённая после проверки разрешения, могла перенаправить чтение или поиск в другое место без сообщения. Из этих отказов только отказ записи родительского каталога, через символическую ссылку и в символически связанный каталог появляются в более ранних версиях.4188До версии 2.1.251 Claude Code повторно проверял разрешение пути только для записей файлов, поэтому ссылка, заменённая после проверки разрешения, могла перенаправить чтение или поиск в другое место без сообщения. Из этих отказов только отказ записи родительского каталога, через символическую ссылку и в символически связанный каталог появляются в более ранних версиях.

3909 4189

4190До версии 2.1.280 отказ `where it leads on disk could not be determined` не появлялся.

4191

3910<h3 id="task-output-swap-refused">4192<h3 id="task-output-swap-refused">

3911 Task output swap refused4193 Task output swap refused

3912</h3>4194</h3>

3932* Или проверьте каталог вашего проекта в временном каталоге Claude Code, `/private/tmp/claude-501/-Users-you-my-project` в примере сообщения. Если этот путь является символической ссылкой или каталогом, который не должен быть там, удалите саму ссылку или каталог, а не цель ссылки, и перезагрузитесь4214* Или проверьте каталог вашего проекта в временном каталоге Claude Code, `/private/tmp/claude-501/-Users-you-my-project` в примере сообщения. Если этот путь является символической ссылкой или каталогом, который не должен быть там, удалите саму ссылку или каталог, а не цель ссылки, и перезагрузитесь

3933* Если отказ повторяется, процесс заменяет, связывает или удаляет записи в временном каталоге Claude Code, пока сеанс работает. Установите [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars) в каталог, который ничто другое не управляет, и перезагрузитесь4215* Если отказ повторяется, процесс заменяет, связывает или удаляет записи в временном каталоге Claude Code, пока сеанс работает. Установите [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars) в каталог, который ничто другое не управляет, и перезагрузитесь

3934 4216

4217<h3 id="disk-quota-or-temp-filesystem-is-full">

4218 Disk quota or temp filesystem is full

4219</h3>

4220

4221Claude Code сохраняет вывод каждой команды Bash и PowerShell в файл в своём временном каталоге. Когда команда завершается с ненулевым кодом и вообще без вывода, Claude Code проверяет, заполнена ли файловая система, содержащая этот файл, или нет места для индексных дескрипторов, или ваша квота диска на ней использована. Если это так, диагностика появляется в результате команды вместо пустого вывода:

4222

4223```text wrap theme={null}

4224Your 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.

4225```

4226

4227Сообщение называет то, что закончилось:

4228

4229* `Your disk quota is full ... (EDQUOT)`: ваша собственная квота на этой файловой системе использована. Квота может быть полной, пока файловая система всё ещё показывает свободное место

4230* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`: файловая система или ваша квота на ней не имеет места

4231* `Command output was lost: the temp filesystem at ... is full` или `... is out of inodes`: файловая система имеет почти нет свободного места или заканчиваются индексные дескрипторы

4232

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

4234

4235* Удалите файлы, которые вам больше не нужны на файловой системе, содержащей временный каталог Claude Code. Для `EDQUOT` удалите файлы, которые учитываются в вашей собственной квоте. Для `out of inodes` удалите много файлов, а не несколько больших, так как каждый файл занимает один индексный дескриптор независимо от его размера

4236* Или перезагрузите Claude Code с [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars), установленным в каталог на файловой системе с местом

4237* Затем попросите Claude запустить команду снова. Вывод, который она напечатала, был потерян, а не усечён

4238

3935<h3 id="the-source-file-is-not-valid-utf-8-text">4239<h3 id="the-source-file-is-not-valid-utf-8-text">

3936 The source file is not valid UTF-8 text4240 The source file is not valid UTF-8 text

3937</h3>4241</h3>

4281 4585

4282На некоторых учётных записях сообщение говорит `daemon` вместо `background service`.4586На некоторых учётных записях сообщение говорит `daemon` вместо `background service`.

4283 4587

4284При установке npm ошибка `EUNKNOWN`, которая появляется, пока `npm install -g @anthropic-ai/claude-code` заменяет двоичный файл, имеет ту же причину, что и [`EACCES` при переустановке](#eacces-when-starting-a-background-session), и очищается, когда вы повторяете попытку после завершения установки.4588При установке npm ошибка `EUNKNOWN`, которая появляется, пока `npm install -g @anthropic-ai/claude-code` заменяет двоичный файл, имеет ту же причину, что и [`EACCES` при переустановке](#eacces-when-starting-a-background-session) и очищается, когда вы повторяете попытку после завершения установки.

4285 4589

4286Claude Code запускает фоновую службу через PowerShell, чтобы служба пережила закрытие терминала, используя PowerShell 7, когда он установлен, и Windows PowerShell 5.1 в противном случае. Когда ни один PowerShell не может работать, Claude Code запускает службу напрямую вместо этого, поэтому политика, которая блокирует только PowerShell, не вызывает эту ошибку. Если вы видите её, пока не запущена установка npm, политика блокирует сам исполняемый файл Claude Code.4590Claude Code запускает фоновую службу через PowerShell, чтобы служба пережила закрытие терминала, используя PowerShell 7, когда он установлен, и Windows PowerShell 5.1 в противном случае. Когда ни один PowerShell не может работать, Claude Code запускает службу напрямую вместо этого, поэтому политика, которая блокирует только PowerShell, не вызывает эту ошибку. Если вы видите её, пока не запущена установка npm, политика блокирует сам исполняемый файл Claude Code.

4287 4591

4347 Рабочий каталог больше не существует при запуске фонового сеанса4651 Рабочий каталог больше не существует при запуске фонового сеанса

4348</h3>4652</h3>

4349 4653

4350Вы попытались запустить [фоновый сеанс](/docs/ru/agent-view) в каталоге, который больше не существует. Это происходит, когда вы отправляете из представления агента или запускаете `/background` после того, как каталог, в котором вы работаете, был удалён или перемещён. Это также происходит, когда вы подключаетесь к или перезапускаете сеанс, чей процесс вышел и чей каталог ушёл, потому что новый процесс запустился бы в том же каталоге. Claude Code не запускает сеанс, и сообщение называет отсутствующий каталог:4654Вы попытались запустить [фоновый сеанс](/docs/ru/agent-view) в каталоге, который больше не существует. Claude Code не запускает сеанс, и сообщение называет отсутствующий каталог:

4351 4655

4352```text theme={null}4656```text theme={null}

4353Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)4657Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)

4359 4663

4360* Пересоздайте каталог, который называет сообщение, или отправьте из каталога, который существует, затем попробуйте снова4664* Пересоздайте каталог, который называет сообщение, или отправьте из каталога, который существует, затем попробуйте снова

4361 4665

4666<h3 id="workspace-not-trusted-when-dispatching-a-background-session">

4667 Рабочее пространство не доверено при отправке фонового сеанса

4668</h3>

4669

4670Вы запустили или перезапустили [фоновый сеанс](/docs/ru/agent-view) в каталоге, которому вы не [доверили](/docs/ru/permissions#project-allow-rules-and-workspace-trust), и диалог доверия рабочего пространства не мог появиться, чтобы спросить вас. Claude Code не запускает сеанс:

4671

4672```text theme={null}

4673Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.

4674```

4675

4676Из терминала в собственном каталоге сеанса та же команда показывает диалог доверия вместо этого и запускает сеанс после того, как вы примете. Это сообщение появляется там, где диалог не может, например в скрипте, или когда вы перезапускаете сеанс из каталога, отличного от его собственного.

4677

4678Два варианта называют другую причину:

4679

4680* **`The home directory is trusted one session at a time`**: каталог сеанса — это ваш домашний каталог. Claude Code никогда не сохраняет доверие для домашнего каталога, поэтому принятие диалога там в более раннем сеансе не считается.

4681* **`<path> could not be resolved on disk`**: Claude Code не мог найти каталог сеанса на диске.

4682

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

4684

4685* Запустите `claude` в каталоге, который называет сообщение, и примите диалог доверия, затем запустите команду снова

4686* Для сообщения о домашнем каталоге запустите команду из терминала в вашем домашнем каталоге, чтобы диалог мог появиться, или запустите сеанс из каталога проекта вместо этого

4687* Для сообщения `could not be resolved on disk` пересоздайте каталог или запустите новый сеанс из каталога, который существует

4688

4362<h2 id="wrapper-and-ide-errors">4689<h2 id="wrapper-and-ide-errors">

4363 Ошибки обёртки и IDE4690 Ошибки обёртки и IDE

4364</h2>4691</h2>

4591* Сократите frontmatter `description` ваших файлов агентов или попросите Claude сократить их для вас.4918* Сократите frontmatter `description` ваших файлов агентов или попросите Claude сократить их для вас.

4592* Удалите файлы агентов, которые вы больше не используете.4919* Удалите файлы агентов, которые вы больше не используете.

4593 4920

4921<h3 id="a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved">

4922 A skill, command, or workflow wasn't loaded because its name is reserved

4923</h3>

4924

4925Папка 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) и не загружает этот элемент.

4926

4927Claude Code показывает это предупреждение как уведомление при запуске в представлении беседы, а не на stderr:

4928

4929```text theme={null}

4930Not 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

4931```

4932

4933Уведомление называет то, что нужно изменить для первого отклонённого элемента: папку или файл для переименования, строку `name:` для редактирования или workflow для переименования. Когда было отклонено более одного элемента, уведомление заканчивается счётом, например `· 2 more`, и [debug log](/docs/ru/debug-your-config) называет каждый.

4934

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

4936

4937* Переименуйте элемент, который называет уведомление, или отредактируйте строку `name:`, на которую оно указывает, затем перезагрузите сеанс.

4938

4939До версии 2.1.282 Claude Code загружал skills и commands с этими именами.

4940

4594<h3 id="workspace-has-not-been-trusted">4941<h3 id="workspace-has-not-been-trusted">

4595 Workspace has not been trusted4942 Workspace has not been trusted

4596</h3>4943</h3>

4637 Remote managed settings failed to load4984 Remote managed settings failed to load

4638</h3>4985</h3>

4639 4986

4640Ваш сеанс имеет право на [server-managed settings](/docs/ru/server-managed-settings), но Claude Code не смог их получить, поэтому он показывает это предупреждение в интерактивных сеансах. Причина в скобках называет то, что не удалось, например `network error`, `request timed out` или `authentication rejected (401)`, а остальная часть строки говорит, какую политику запускает сеанс:4987Ваш сеанс имеет право на [server-managed settings](/docs/ru/server-managed-settings), но Claude Code не смог их получить или не смог применить то, что вернул сервер, поэтому он показывает это предупреждение в интерактивных сеансах.

4988

4989Причина в скобках называет то, что не удалось, например `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`.

4990

4991Остальная часть строки говорит, какую политику запускает сеанс:

4641 4992

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`.4993* **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`.4994* **No cache**: Claude Code запускает сеанс без server-managed settings, и строка читается `no remote policy applied`.

4645**Что делать:**4996**Что делать:**

4646 4997

4647* Действуйте в соответствии с причиной, которую называет сообщение: для сетевой причины проверьте, что эта машина может достичь `api.anthropic.com`; для причины аутентификации проверьте вашу регистрацию с помощью `/status`4998* Действуйте в соответствии с причиной, которую называет сообщение: для сетевой причины проверьте, что эта машина может достичь `api.anthropic.com`; для причины аутентификации проверьте вашу регистрацию с помощью `/status`

4999* Для `no setting in the server response could be applied as written` попросите вашего администратора исправить параметры на сервере

4648* Выполните `/status` или `claude doctor` для полной диагностики5000* Выполните `/status` или `claude doctor` для полной диагностики

4649 5001

4650До версии 2.1.248 Claude Code сообщал о неудачной выборке параметров только в журнале отладки.5002До версии 2.1.248 Claude Code сообщал о неудачной выборке параметров только в журнале отладки.

4664* Запустите Claude Code снова и одобрите диалог, чтобы продолжить в соответствии с параметрами вашей организации. Отклонённый диалог не запоминается, поэтому он появляется снова при следующем запуске.5016* Запустите Claude Code снова и одобрите диалог, чтобы продолжить в соответствии с параметрами вашей организации. Отклонённый диалог не запоминается, поэтому он появляется снова при следующем запуске.

4665* Если вы не уверены в параметре, который перечисляет диалог, спросите того, кто поддерживает управляемые параметры вашей организации, перед одобрением5017* Если вы не уверены в параметре, который перечисляет диалог, спросите того, кто поддерживает управляемые параметры вашей организации, перед одобрением

4666 5018

5019<h3 id="managed-settings-block-the-default-model">

5020 Managed settings block the default model

5021</h3>

5022

5023[managed settings](/docs/ru/managed-settings) вашей организации блокируют модель, на которую разрешается Default option, и каждую модель, на которую она может перейти. Сеанс, который должен был бы запуститься на Default option, выходит при запуске вместо запуска заблокированной модели. Какое сообщение вы видите, зависит от параметра, который её блокирует. Когда список [`deniedModels`](/docs/ru/model-config#block-specific-models-or-versions) блокирует её, сообщение читается:

5024

5025```text theme={null}

5026Claude 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".

5027```

5028

5029Когда список `availableModels` с [`availableModelsMatch`](/docs/ru/settings-reference#availablemodelsmatch) установленным на `"exact"` его опускает, сообщение читается:

5030

5031```text theme={null}

5032Claude 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".

5033```

5034

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

5036

5037* Если вы администрируете параметры, добавьте модель, которую ваши пользователи могут запустить, в `availableModels` или сузьте записи `deniedModels`, которые блокируют каждый fallback. [Block specific models or versions](/docs/ru/model-config#block-specific-models-or-versions) описывает, как Default option переходит

5038* Если вы их не администрируете, отправьте сообщение вашему администратору. Ваши собственные файлы параметров не могут расширить управляемый `availableModels` или `deniedModels` список

5039

4667<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">5040<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">

4668 MCP server is blocked by enterprise managed policy5041 MCP server is blocked by enterprise managed policy

4669</h3>5042</h3>

4933 5306

4934* Настроенный [`--fallback-model`](/docs/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке5307* Настроенный [`--fallback-model`](/docs/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке

4935* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна5308* Проверка запуска 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 переводит сеанс на резервную модель категории с флагом, когда у этой категории она есть, и показывает уведомление в расшифровке5309* [Автоматический переход на резервную модель](/docs/ru/model-config#automatic-model-fallback) на Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 и Opus 5 переводит сеанс на резервную модель категории с флагом, когда у этой категории она есть, и показывает уведомление в расшифровке

4937 5310

4938Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/docs/ru/model-config) объясняет, когда применяется каждый переход на резервную модель.5311Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/docs/ru/model-config) объясняет, когда применяется каждый переход на резервную модель.

4939 5312

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`.255Выполните вход с помощью `/login`, используя учётную запись вашей организации. Если вы аутентифицируетесь с помощью ключа API, облачные сессии завершаются ошибкой раньше с сообщением, просящим вас запустить `/login`.

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 +33 −12

Details

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

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 +121 −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

143 143

144Когда ваша организация доставляет более одного управляемого источника на одну машину, ключ [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) определяет, что Claude Code делает с остальными:144Когда ваша организация доставляет более одного управляемого источника на одну машину, ключ [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) определяет, что Claude Code делает с остальными:

145 145

146* **`"first-wins"`, по умолчанию**: Claude Code использует источник с наивысшим рейтингом, который доставляет хотя бы один ключ политики, и игнорирует остальные, а не объединяет их, за исключением ключей в [Ключи, читаемые из каждого источника администратора](#keys-read-from-every-admin-source). Claude Code не показывает предупреждение для источников, которые он пропускает; `/status` [называет источник, который он использовал, и те, которые он пропустил](#read-the-source-in-/status).146* **`"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 или позже.147* **`"merge"`**: Claude Code применяет каждый источник администратора, который доставляет ключ политики, и объединяет их по типу ключа: для большинства ключей применяется значение источника с более высоким рейтингом, списки объединяются, а блокировки принимают наиболее строгое значение. [Составьте каждый управляемый источник](#compose-every-managed-source) указывает, где установить ключ и как объединяется каждый тип ключа. Требует Claude Code v2.1.242 или позже.

148 148

149Оба параметра ранжируют источники одинаково. Эти термины повторяются в этом разделе:149Оба параметра ранжируют источники одинаково. Эти термины повторяются в этом разделе:

150 150

151* **Ключ политики**: любой ключ параметров, кроме двух управляющих ключей, [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) и [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior). Управляемый файл параметров или политика MDM, которые содержат только эти, не считаются, и Claude Code переходит к следующему источнику.151* **Ключ политики**: любой ключ параметров, кроме двух управляющих ключей, [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) и [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior). Управляемый файл параметров или политика MDM, которые содержат только эти ключи, не учитываются, и Claude Code переходит к следующему источнику.

152* **Источник администратора**: один из первых трёх источников ниже. Реестр HKCU доступен для записи пользователем и не является одним из них.152* **Источник администратора**: один из первых трёх источников ниже. Реестр HKCU доступен для записи пользователем и не является источником администратора.

153 153

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

155 155

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, он начинает со следующего источника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, он начинает со следующего источника

1572. Политики MDM или уровня ОС: plist macOS или ключ реестра HKLM1572. Политики MDM или уровня ОС: plist macOS или ключ реестра HKLM

1583. Управляемые файлы параметров, `managed-settings.d/*.json` и `managed-settings.json` объединены вместе1583. Управляемые файлы параметров, `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) не предоставляет ограничивающий ключ1594. Реестр HKCU на Windows и на WSL после того, как реестр HKLM или файл управляемых параметров Windows включит [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) и значение HKCU также установит его. Claude Code читает его только когда нет документа администратора выше него и нет [параметров родителя, предоставленных хостом](#let-an-embedding-host-add-policy), которые предоставляют ограничивающий ключ

160

161<span id="present-admin-documents" />

162

163Claude Code никогда не применяет доступный для записи пользователем реестр HKCU под документом администратора, который присутствует. Документ присутствует, когда он устанавливает любой ключ политики на значение, отличное от `null`, даже значение, которое Claude Code не может прочитать. Значение HKLM, файл управляемых параметров или каталог `managed-settings.d`, которые существуют, но не могут быть прочитаны, также присутствуют. На WSL `/etc/claude-code` также доступен для записи пользователем, и запись [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) указывает, когда документы Windows находятся выше него.

160 164

161Эта диаграмма показывает ранжирование с примерами кросс-источниковых ключей, которые Claude Code читает из первых трёх источников при любом параметре:165Эта диаграмма показывает ранжирование с примерами кросс-источниковых ключей, которые Claude Code читает из первых трёх источников при любом параметре:

162 166

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" />167<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 168

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" />169<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 170

167<h3 id="keys-read-from-every-admin-source">171<h3 id="keys-read-from-every-admin-source">

168 Ключи, читаемые из каждого источника администратора172 Ключи, читаемые из каждого источника администратора

169</h3>173</h3>

170 174

171При параметре по умолчанию `"first-wins"` Claude Code читает большинство ключей только из [источника, который он выбрал](#how-claude-code-combines-managed-sources), и игнорирует значение в источнике с более низким рейтингом даже когда выбранный источник оставляет этот ключ неустановленным.175При параметре по умолчанию `"first-wins"` Claude Code читает большинство ключей только из [источника, который он выбрал](#how-claude-code-combines-managed-sources), и игнорирует значение в источнике с более низким рейтингом, даже когда выбранный источник оставляет этот ключ неустановленным.

172 176

173Несколько ключей работают иначе. Claude Code читает их из каждого источника администратора, поэтому политика MDM с более низким рейтингом или управляемый файл параметров могут всё ещё установить их, когда выбранный источник этого не делает. Claude Code исключает доступный для записи пользователем реестр HKCU из этого сканирования; когда HKCU является единственным источником и ни один хост не предоставляет параметры родителя, HKCU применяется как любой выбранный источник.177Несколько ключей работают иначе. Claude Code читает их из каждого источника администратора, поэтому политика MDM с более низким рейтингом или файл управляемых параметров могут всё ещё установить их, когда выбранный источник этого не делает. Claude Code исключает доступный для записи пользователем реестр HKCU из этого сканирования; когда HKCU является единственным источником и ни один хост не предоставляет параметры родителя, HKCU применяется как любой выбранный источник.

174 178

175Кросс-источниковые ключи включают:179Кросс-источниковые ключи включают:

176 180

177* `sandbox.network.allowManagedDomainsOnly` и `sandbox.filesystem.allowManagedReadPathsOnly`: `true` в любом источнике администратора включает блокировку. Пока блокировка включена, Claude Code объединяет список разрешений, который она блокирует, `sandbox.network.allowedDomains` вместе с правилами разрешения WebFetch(domain:...), или `sandbox.filesystem.allowRead`, по всем источникам администратора. Без блокировки Claude Code обрабатывает список разрешений как любой другой ключ, поэтому при `"first-wins"` список разрешений невыбранного источника администратора игнорируется181* `sandbox.network.allowManagedDomainsOnly` и `sandbox.filesystem.allowManagedReadPathsOnly`: `true` в любом источнике администратора включает блокировку. Пока блокировка включена, Claude Code объединяет список разрешений, который она блокирует, `sandbox.network.allowedDomains` вместе с правилами разрешения `WebFetch(domain:...)` или `sandbox.filesystem.allowRead` из каждого источника администратора. Без блокировки Claude Code обрабатывает список разрешений как любой другой ключ, поэтому при `"first-wins"` список разрешений невыбранного источника администратора игнорируется

178* `allowAllClaudeAiMcps`182* `allowAllClaudeAiMcps`

179* `allowManagedMcpServersOnly`: `true` в любом источнике администратора включает блокировку списка разрешений MCP. Пока блокировка включена, управляемый список `allowedMcpServers` поступает из источника администратора с наивысшим рейтингом, который его устанавливает. Список, управляемый сервером, заменяет список более низкого источника, а не объединяется с ним.183* `allowManagedMcpServersOnly`: `true` в любом источнике администратора включает блокировку списка разрешений MCP. Пока блокировка включена, управляемый список `allowedMcpServers` поступает из источника администратора с наивысшим рейтингом, который его устанавливает. Список, управляемый сервером, заменяет список нижнего источника, а не объединяется с ним.

180 184

181 Если ни один источник администратора не устанавливает список, каждый сервер, который проходит список отрицания, загружается, если только [параметры родителя](#let-an-embedding-host-add-policy) не предоставляют список.185 Если ни один источник администратора не устанавливает список, каждый сервер, который проходит список запрещённых, загружается, если только [параметры родителя](#let-an-embedding-host-add-policy) не предоставляют список.

182 186

183 Без блокировки Claude Code читает `allowedMcpServers` из управляемого источника, который он применяет, поэтому при `"first-wins"` список невыбранного источника администратора игнорируется. Требует Claude Code v2.1.273 или позже187 Без блокировки Claude Code читает `allowedMcpServers` из управляемого источника, который он применяет, поэтому при `"first-wins"` список невыбранного источника администратора игнорируется. Требует Claude Code v2.1.273 или позже

184* `deniedMcpServers` и [`disableClaudeAiConnectors`](/docs/ru/settings-reference#disableclaudeaiconnectors): запись или `true` в любом источнике администратора применяется. Требует Claude Code v2.1.273 или позже188* `deniedMcpServers` и [`disableClaudeAiConnectors`](/docs/ru/settings-reference#disableclaudeaiconnectors): запись или `true` в любом источнике администратора применяется. Требует Claude Code v2.1.273 или позже

186* Двоичный файл песочницы `ripgrep`, [`sandbox.ripgrep`](/docs/ru/settings-reference#sandbox-ripgrep)190* Двоичный файл песочницы `ripgrep`, [`sandbox.ripgrep`](/docs/ru/settings-reference#sandbox-ripgrep)

187* `sandbox.filesystem.disabled` и `sandbox.network.strictAllowlist`191* `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` в параметрах пользователя или локальных параметрах разработчика также отключает его; каждый ключ может только отрицать192* [`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 или позже193* [`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 или позже194* [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel), где применяется наименьший лимит из любого источника администратора. Если разработчик устанавливает более низкий лимит в своих собственных параметрах или с помощью `--settings`, Claude Code применяет этот; ни один источник не может повысить лимит. Требует Claude Code v2.1.267 или позже

191* Отказ от трейлера коммита в `attribution` или в устаревшем `includeCoAuthoredBy` из любого уровня195* Отказ от трейлера коммита в `attribution` или в устаревшем `includeCoAuthoredBy` из любого уровня

192* [`forceRemoteSettingsRefresh`](/docs/ru/server-managed-settings)196* [`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` выбранного источника только197* `env`, объединённый для каждой переменной из источников администратора: каждая переменная поступает из источника с наивысшим приоритетом, который её определяет, поэтому нижние источники заполняют переменные, которые оставляют неустановленными более высокие. Несколько переменных следуют своим собственным правилам; [Исключения для каждого ключа из управляемых источников](/docs/ru/server-managed-settings#per-key-exceptions-across-managed-sources) называет каждое. Требует Claude Code v2.1.223 или позже. До v2.1.223 Claude Code применял только весь блок `env` выбранного источника

194 198

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

196 200

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

198 202

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

201</h3>205</h3>

202 206

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

204 208

205При `"merge"` Claude Code добавляет записи списка более низкого источника, такие как правила `permissions.allow` и hooks, к политике, поэтому включайте это только когда каждый источник, ранжированный ниже вашего наивысшего, находится под контролем администратора.209При `"merge"` Claude Code добавляет записи списка нижнего источника, такие как правила `permissions.allow` и hooks, к политике, поэтому включайте это только когда каждый источник, ранжированный ниже вашего наивысшего, находится под контролем администратора.

206 210

207Эта таблица показывает, как Claude Code объединяет каждый тип ключа при `"merge"`. Запись [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) называет каждый ключ в трёх из строк: списки ограничений, значения, взятые целиком, и ключи, читаемые только из источника с наивысшим рейтингом.211Эта таблица показывает, как Claude Code объединяет каждый тип ключа при `"merge"`. Запись [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) называет каждый ключ в трёх из строк: списки разрешений ограничений, значения, взятые целиком, и ключи, читаемые только из источника с наивысшим рейтингом.

208 212

210| :- | :- | :- |214| :- | :- | :- |

212| Блокировки | Применяет наиболее строгое значение, которое устанавливает любой источник; более мягкое значение применяется только из источника с наивысшим рейтингом | `allowManagedHooksOnly`, `permissions.disableBypassPermissionsMode`, `crossSessionInbound` |216| Блокировки | Применяет наиболее строгое значение, которое устанавливает любой источник; более мягкое значение применяется только из источника с наивысшим рейтингом | `allowManagedHooksOnly`, `permissions.disableBypassPermissionsMode`, `crossSessionInbound`, `availableModelsMatch` |

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

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

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

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

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

219 223

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

221 225

222<h3 id="compute-the-policy-with-a-helper-program">226<h3 id="compute-the-policy-with-a-helper-program">

223 Вычислите политику с помощью вспомогательной программы227 Вычислите политику с помощью вспомогательной программы

224</h3>228</h3>

225 229

226[`policyHelper`](/docs/ru/settings-reference#policyhelper) — это исполняемый файл, который называет ваша политика MDM или управляемый файл параметров, и Claude Code запускает его для вычисления управляемых параметров при запуске. Когда выбранный источник настраивает один и помощник выдаёт объект `managedSettings`, этот вывод изменяет то, что Claude Code читает:230[`policyHelper`](/docs/ru/settings-reference#policyhelper) — это исполняемый файл, который называет ваша политика MDM или файл управляемых параметров, и Claude Code запускает его для вычисления управляемых параметров при запуске. Когда выбранный источник настраивает один и помощник выдаёт объект `managedSettings`, этот вывод изменяет то, что читает Claude Code:

227 231

228* **Выданный объект `managedSettings` — это единственные управляемые параметры для сеанса**, включая [ключи, которые он иначе читает из каждого источника администратора](#keys-read-from-every-admin-source), кроме [`forceRemoteSettingsRefresh`, который имеет своё собственное правило запуска](/docs/ru/settings-reference#forceremotesettingsrefresh)232* **Выданный объект `managedSettings` — это единственные управляемые параметры для сеанса**, включая [ключи, которые он иначе читает из каждого источника администратора](#keys-read-from-every-admin-source), кроме [`forceRemoteSettingsRefresh`, который имеет своё собственное правило запуска](/docs/ru/settings-reference#forceremotesettingsrefresh)

229 233

230Для того, какие запуски помощника не удаются и что Claude Code делает, когда один не удаётся, см. [Сбои помощника](/docs/ru/settings-reference#helper-failures).234Для того, какие запуски помощника не удаются и что Claude Code делает, когда это происходит, см. [Сбои помощника](/docs/ru/settings-reference#helper-failures).

231 235

232<span id="parent-settings-from-embedding-hosts" />236<span id="parent-settings-from-embedding-hosts" />

233 237

241 245

242Когда другое приложение запускает Claude Code, такое как Claude Desktop, расширение IDE или приложение Agent SDK, этот хост может передать свои собственные управляемые параметры через опцию SDK `managedSettings`. Claude Code называет эти параметры родителя.246Когда другое приложение запускает Claude Code, такое как Claude Desktop, расширение IDE или приложение Agent SDK, этот хост может передать свои собственные управляемые параметры через опцию SDK `managedSettings`. Claude Code называет эти параметры родителя.

243 247

244По умолчанию Claude Code игнорирует параметры родителя всякий раз, когда присутствует источник администратора: параметры, управляемые сервером, политика MDM или уровня ОС, или управляемый файл параметров.248По умолчанию Claude Code игнорирует параметры родителя всякий раз, когда присутствует источник администратора: параметры, управляемые сервером, политика MDM или уровня ОС, или файл управляемых параметров.

245 249

246Чтобы Claude Code объединял параметры родителя наряду с источником администратора, установите [`parentSettingsBehavior`](/docs/ru/settings-reference#parentsettingsbehavior) на `"merge"` в источнике с наивысшим приоритетом; Claude Code читает ключ из этого источника только.250Чтобы Claude Code объединял параметры родителя наряду с источником администратора, установите [`parentSettingsBehavior`](/docs/ru/settings-reference#parentsettingsbehavior) на `"merge"` в источнике с наивысшим приоритетом; Claude Code читает ключ только из этого источника.

247 251

248Claude Code затем сохраняет только значения хоста, которые ограничивают то, что может делать Claude, с одним пробелом, о котором нужно знать: если вы также не установите блокировки `allowManaged*Only`, правила разрешения разрешений хоста и списки разрешений песочницы всё ещё применяются. См. [Ограничьте параметры родителя](/docs/ru/claude-apps-gateway#restrict-parent-settings) для блокировок.252Claude Code затем сохраняет только значения хоста, которые ограничивают то, что может делать Claude, с одним пробелом, о котором нужно знать: если вы также не установите блокировки `allowManaged*Only`, правила разрешения хоста и списки разрешений песочницы всё ещё применяются. См. [Ограничьте параметры родителя](/docs/ru/claude-apps-gateway#restrict-parent-settings) для блокировок.

249 253

250[`policyHelper`](/docs/ru/settings-reference#policyhelper) может отключить слияние родителя независимо от этого ключа; его запись говорит, когда.254[`policyHelper`](/docs/ru/settings-reference#policyhelper) может отключить слияние родителя независимо от этого ключа; его запись говорит, когда.

251 255

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

253 257

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

255* Claude Code применяет значение `forceLoginOrgUUID` или `allowedMcpServers` в управляемых параметрах, которые он применяет, и блокирует предоставленное родителем. Вне блокировки списка разрешений MCP значение в более низком источнике администратора, который Claude Code не применяет, ни применяется, ни блокирует родителя.259* Claude Code применяет значение `forceLoginOrgUUID` или `allowedMcpServers` в управляемых параметрах, которые он применяет, и блокирует предоставленное родителем. Вне блокировки списка разрешений MCP значение в нижнем источнике администратора, который Claude Code не применяет, ни применяется, ни блокирует родителя.

256 260

257 На Claude Code v2.1.273 или позже, пока `allowManagedMcpServersOnly` включена, список `allowedMcpServers` из источника администратора с наивысшим рейтингом, который его устанавливает, применяется и блокирует родителя, как [кросс-источниковый ключ](#keys-read-from-every-admin-source). Список родителя применяется только когда ни один источник администратора не устанавливает один. Запись [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) говорит, какой источник предоставляет каждый ключ при `"merge"`. До v2.1.223 значение в любом источнике администратора блокировало родителя261 На 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 применяет значение в управляемых параметрах, которые он применяет, и блокирует предоставленный родителем список262* Для `availableModels` Claude Code применяет значение в управляемых параметрах, которые он применяет, и блокирует предоставленный родителем список

263 Сохраните доступ к папке Cowork, когда применяются только управляемые правила267 Сохраните доступ к папке Cowork, когда применяются только управляемые правила

264</h4>268</h4>

265 269

266[Cowork](https://claude.com/docs/cowork/overview) в приложении Claude Desktop запускает свои сеансы на Claude Code и предоставляет каждому сеансу доступ к своим рабочим папкам, таким как папка, которую подключает пользователь, через правила разрешения, которые он предоставляет при запуске сеанса. Когда ваша управляемая политика устанавливает [`allowManagedPermissionRulesOnly`](/docs/ru/settings-reference#allowmanagedpermissionrulesonly), Claude Code сохраняет только правила разрешения в управляемой политике: он отбрасывает правила разрешения, которые хост предоставляет как параметры родителя, как `--allowedTools` или в файле параметров, поэтому записи в эти папки теряют предварительное одобрение. В сеансе Cowork, который спрашивает перед редактированием, Cowork не может показать подсказку, и Claude сообщает о каждой записи как заблокированной, потому что путь разрешается в защищённое место или путь вне подключённой папки.270[Cowork](https://claude.com/docs/cowork/overview) в приложении Claude Desktop запускает свои сеансы на Claude Code и предоставляет каждому сеансу доступ к его рабочим папкам, таким как папка, которую подключает пользователь, через правила разрешения, которые он предоставляет при запуске сеанса. Когда ваша управляемая политика устанавливает [`allowManagedPermissionRulesOnly`](/docs/ru/settings-reference#allowmanagedpermissionrulesonly), Claude Code сохраняет только правила разрешения в управляемой политике: он удаляет правила разрешения, которые хост предоставляет как параметры родителя, как `--allowedTools` или в файле параметров, поэтому записи в эти папки теряют предварительное одобрение. В сеансе Cowork, который спрашивает перед редактированием, Cowork не может показать подсказку, и Claude сообщает о каждой записи как заблокированной, потому что путь разрешается в защищённое место или путь вне подключённой папки.

267 271

268Чтобы восстановить записи, добавьте правила разрешения для этих папок в управляемый источник, который Claude Code [выбирает](#precedence-within-the-managed-tier) на этих машинах: на управляемом MDM парке это политика MDM, а не отдельный управляемый файл параметров. Этот пример использует форму файла, и политика MDM принимает те же ключи. Она сохраняет `allowManagedPermissionRulesOnly` установленным и позволяет редактирование в папке `CoworkProjects` в домашнем каталоге каждого пользователя; замените путь на папки, которые подключают ваши пользователи:272Чтобы восстановить записи, добавьте правила разрешения для этих папок в управляемый источник, который Claude Code [выбирает](#precedence-within-the-managed-tier) на этих машинах: на управляемом MDM парке это политика MDM, а не отдельный файл управляемых параметров. Этот пример использует форму файла, и политика MDM принимает те же ключи. Она сохраняет `allowManagedPermissionRulesOnly` установленным и позволяет редактирование в папке `CoworkProjects` в домашнем каталоге каждого пользователя; замените путь на папки, которые подключают ваши пользователи:

269 273

270```json managed-settings.json theme={null}274```json managed-settings.json theme={null}

271{275{

284 Что может изменить разработчик288 Что может изменить разработчик

285</h3>289</h3>

286 290

287Собственные файлы параметров разработчика, значения `--settings` и файлы проекта никогда не переопределяют управляемое значение; [исключения](/docs/ru/settings#exceptions-to-managed-settings-precedence) только позволяют более строгому значению более низкого уровня считаться. Эти случаи находятся вне этого правила:291Собственные файлы параметров разработчика, значения `--settings` и файлы проекта никогда не переопределяют управляемое значение; [исключения](/docs/ru/settings#exceptions-to-managed-settings-precedence) только позволяют учитывать более строгое значение более низкого уровня. Эти случаи находятся вне этого правила:

288 292

289* **Модель для сеанса**: управляемая `model` — это значение по умолчанию, а не блокировка. `--model` и `ANTHROPIC_MODEL` всё ещё выбирают модель для этого сеанса, поэтому развёртывайте [`availableModels`](/docs/ru/settings-reference#availablemodels) для ограничения выбора.293* **Модель для сеанса**: управляемая `model` — это значение по умолчанию, а не блокировка. `--model` и `ANTHROPIC_MODEL` всё ещё выбирают модель для этого сеанса, поэтому развёртывайте [`availableModels`](/docs/ru/settings-reference#availablemodels) для ограничения выбора.

290* **Локальные права администратора**: разработчик, который является администратором на машине, может редактировать сам управляемый источник, поэтому инструменты MDM могут переразвёртывать профиль или файл по расписанию и почему существуют реестр HKLM и домен управляемых предпочтений macOS.294* **Локальные права администратора**: разработчик, который является администратором на машине, может редактировать сам управляемый источник, поэтому инструменты MDM могут переразвёртывать профиль или файл по расписанию и почему существуют реестр HKLM и домен управляемых предпочтений macOS.

291* **Кэш, управляемый сервером**: параметры, управляемые сервером, поступают с серверов Anthropic, и редактирование локального кэша [длится только до следующей успешной выборки](/docs/ru/server-managed-settings#security-considerations).295* **Кэш, управляемый сервером**: параметры, управляемые сервером, поступают с серверов Anthropic, и редактирование локального кэша [длится только до следующей успешной выборки](/docs/ru/server-managed-settings#security-considerations).

292* **Другие инструменты**: управляемые параметры связывают только Claude Code. Разработчик, который вызывает API из другого инструмента, не находится под ними.296* **Другие инструменты**: управляемые параметры привязывают только Claude Code. Разработчик, который вызывает API из другого инструмента, не подчиняется им.

293 297

294<span id="verify-enforcement" />298<span id="verify-enforcement" />

295 299

299 Проверьте, что политика действует303 Проверьте, что политика действует

300</h2>304</h2>

301 305

302Разработчик сообщает, что политика не применяется, или вы хотите подтвердить, что развертывание приземлилось перед отправкой на парк. Две команды на этой машине отвечают на это: `/status` показывает, какой управляемый источник выбрал Claude Code, и `claude doctor` перечисляет то, что он отбросил.306Разработчик сообщает, что политика не применяется, или вы хотите подтвердить, что развертывание прошло успешно перед развертыванием на весь парк. Две команды на этой машине дают ответ: `/status` показывает, какой управляемый источник выбрал Claude Code, а `claude doctor` перечисляет то, что он отбросил.

303 307

304<h3 id="read-the-source-in-/status">308<h3 id="read-the-source-in-/status">

305 Прочитайте источник в /status309 Прочитайте источник в /status

306</h3>310</h3>

307 311

308На машине разработчика запустите `/status` внутри Claude Code и прочитайте строку `Setting sources`. Когда управляемый источник действует, строка перечисляет `Enterprise managed settings` с источником, который выбрал Claude Code, в скобках:312На машине разработчика запустите `/status` внутри Claude Code и прочитайте строку `Setting sources`. Когда управляемый источник действует, строка перечисляет `Enterprise managed settings` с источником, выбранным Claude Code в скобках:

309 313

310* `(remote)`: управляемые параметры сервера из claude.ai или шлюза314* `(remote)`: управляемые сервером параметры из claude.ai или шлюза

311* `(plist)` или `(HKLM)`: политика MDM или ОС315* `(plist)` или `(HKLM)`: политика MDM или ОС

312* `(file)`, `(drop-ins)` или `(file + drop-ins)`: `managed-settings.json`, каталог drop-in или оба316* `(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 или позже317* `(remote + file, merged)` или другой список, заканчивающийся на `, merged`: ваша организация [объединяет каждый управляемый источник](#compose-every-managed-source), и Claude Code объединил перечисленные источники в политику. Нижний источник все еще может предоставлять переменные `env` без появления в списке. Требуется Claude Code v2.1.242 или позже

314* `(HKCU)`: резервный реестр, доступный для записи пользователем318* `(HKCU)`: резервный реестр, доступный для записи пользователем

315* `(parent process)`: [хост встраивания](#let-an-embedding-host-add-policy) предоставил ограничивающие параметры319* `(parent process)`: [хост встраивания](#let-an-embedding-host-add-policy) предоставил ограничивающие параметры

316* `(helper)`: [`policyHelper`](/docs/ru/settings-reference#policyhelper), настроенный выбранным источником MDM или файла320* `(helper)`: [`policyHelper`](/docs/ru/settings-reference#policyhelper), настроенный выбранным источником MDM или файла

317 321

318Когда Claude Code нашел управляемый источник на машине и не выбрал его, вторая строка, `Skipped sources`, называет каждый такой источник. Прочитайте его, чтобы различить политику, которая никогда не достигла машину, от той, которая достигла и которую источник с более высоким приоритетом переопределил. Требует Claude Code v2.1.242 или позже.322Когда Claude Code обнаружил управляемый источник на машине и не выбрал его, вторая строка, `Skipped sources`, называет каждый такой источник. Прочитайте ее, чтобы различить политику, которая никогда не достигла машину, от той, которая достигла ее и которую источник с более высоким приоритетом переопределил. Требуется Claude Code v2.1.242 или позже.

319 323

320Когда политика не применяется, строка `Setting sources` говорит вам, какая из двух проблем у вас есть:324Когда политика не применяется, строка `Setting sources` говорит вам, какая из двух проблем у вас есть:

321 325

322* **Строка отсутствует**: Claude Code не нашел управляемый источник, который доставляет ключ политики.326* **Строка отсутствует**: Claude Code не нашел управляемый источник, который доставляет ключ политики.

323 327

324 Если вы развернули файл управляемых параметров, проверьте, что он находится по пути для ОС и что он содержит [ключ политики](#how-claude-code-combines-managed-sources), а не только ключи управления. Файл, который не является действительным JSON, не производит это состояние; Claude Code [отказывается запускаться](#find-entries-claude-code-dropped) вместо этого.328 Если вы развернули файл управляемых параметров, проверьте, что он находится по пути для ОС и что он содержит [ключ политики](#how-claude-code-combines-managed-sources), а не только ключи управления. Файл, который не является допустимым JSON, не создает это состояние; Claude Code [отказывается запускаться](#find-entries-claude-code-dropped) вместо этого.

325 329

326 Когда вы развернули через управляемые параметры сервера вместо этого, запустите `claude doctor`, который сообщает [результат выборки](/docs/ru/server-managed-settings#verify-settings-delivery).330 Когда вы развернули через управляемые сервером параметры, запустите `claude doctor`, который сообщает [результат выборки](/docs/ru/server-managed-settings#verify-settings-delivery).

327* **Строка называет источник, отличный от того, который вы развернули**: источник с более высоким приоритетом присутствует и Claude Code игнорировал ваш, и `Skipped sources` его перечисляет. [Как Claude Code объединяет управляемые источники](#how-claude-code-combines-managed-sources) дает порядок.331* **Строка называет источник, отличный от того, который вы развернули**: присутствует источник с более высоким приоритетом, и Claude Code проигнорировал ваш, и `Skipped sources` его перечисляет. [Как Claude Code объединяет управляемые источники](#how-claude-code-combines-managed-sources) дает порядок.

328 332

329<span id="invalid-entries-in-managed-settings" />333<span id="invalid-entries-in-managed-settings" />

330 334

332 Найдите записи, которые Claude Code отбросил336 Найдите записи, которые Claude Code отбросил

333</h3>337</h3>

334 338

335Когда файл управляемых параметров, профиль MDM, значение реестра или полезная нагрузка управляемого сервера не проходит проверку схемы, Claude Code сначала пропускает отдельные записи, которые он может исправить, такие как одно неправильное правило разрешения, с предупреждением для каждого, затем отбрасывает любой ключ верхнего уровня, значение которого все еще не проходит, и продолжает применять каждый оставшийся действительный ключ.339Если ваш файл управляемых параметров, профиль MDM, значение реестра или полезная нагрузка, управляемая сервером, не проходит проверку схемы, Claude Code сначала пропускает каждую отдельную запись, которую он может исправить, например одно неправильное правило разрешения, и предупреждает о каждой. Claude Code затем отбрасывает любое значение, которое все еще не проходит, если только значение не принадлежит одному из ключей, которые [не проходят закрыто](#keys-that-fail-closed) вместо этого.

336 340

337Claude Code более строг с `managedSettings`, который выдает [`policyHelper`](/docs/ru/settings-reference#policyhelper): он делает те же исправления записей, но любое нарушение схемы, которое выживает, не удается весь запуск помощника, и при запуске Claude Code отказывается запускаться, то же самое, что для помощника, который выходит с ненулевым кодом.341Claude Code более строг с `managedSettings`, который [`policyHelper`](/docs/ru/settings-reference#policyhelper) выдает: он делает те же исправления записей, но любое нарушение схемы, которое выживает, не проходит весь запуск помощника, и при запуске Claude Code отказывается запускаться, то же самое, что и для помощника, который выходит с ненулевым кодом.

338 342

339Когда файл управляемых параметров, файл drop-in, plist MDM или значение реестра HKLM присутствуют, но не могут быть проанализированы как объект JSON, Claude Code отказывается запускаться и печатает [ошибку, называющую источник](/docs/ru/errors#managed-settings-document-could-not-be-parsed), даже когда другой источник администратора доставляет действительную политику. Каждый источник не удается таким образом, когда:343Когда файл управляемых параметров, файл drop-in, plist MDM или значение реестра HKLM присутствуют, но не могут быть проанализированы как объект JSON, Claude Code отказывается запускаться и выводит [ошибку, называющую источник](/docs/ru/errors#managed-settings-document-could-not-be-parsed), даже когда другой источник администратора доставляет допустимую политику. Каждый источник не проходит таким образом, когда:

340 344

341* **Файл управляемых параметров или файл drop-in**: файл не является действительным JSON или его верхний уровень не является объектом345* **Файл управляемых параметров или файл drop-in**: файл не является допустимым JSON или его верхний уровень не является объектом

342* **Plist MDM**: `plutil` macOS сообщает plist неправильно сформированным или его преобразованное содержимое не является объектом JSON346* **MDM plist**: `plutil` macOS сообщает, что plist неправильно сформирован, или его преобразованное содержимое не является объектом JSON

343* **Значение реестра HKLM**: значение `Settings` не является строкой, пусто или не содержит объект JSON347* **Значение реестра HKLM**: значение `Settings` не является строкой, пусто или не содержит объект JSON

344 348

345Три состояния источника не вызывают этот отказ:349Три состояния источника не вызывают этого отказа:

346 350

347* Отсутствующий файл, профиль или значение реестра не является сбоем; Claude Code работает без этого источника.351* Отсутствующий файл, профиль или значение реестра не является сбоем; Claude Code работает без этого источника.

348* Пустой файл управляемых параметров считается `{}`.352* Пустой файл управляемых параметров считается `{}`.

349* Неправильное значение в доступном для записи пользователем ключе реестра HKCU никогда не блокирует запуск. Claude Code сообщает об этом как уведомление в `/status` и `claude doctor` вместо этого.353* Неправильное значение в доступном для записи ключе реестра HKCU никогда не блокирует запуск. Claude Code сообщает об этом как уведомление в `/status` и `claude doctor` вместо этого.

350 354

351Если файл управляемых параметров, файл drop-in или каталог `managed-settings.d/` не может быть прочитан и никакой источник администратора не предоставляет политику, сеансы, вошедшие с учетными данными claude.ai или Claude Console, выходят при запуске с сообщением о контакте с администратором.355Если файл управляемых параметров, файл drop-in или каталог `managed-settings.d/` не могут быть прочитаны и ни один источник администратора не предоставляет политику, сеансы, вошедшие с учетными данными claude.ai или Claude Console, выходят при запуске с сообщением о необходимости связаться с администратором.

352 356

353Чтобы найти отброшенную запись, посмотрите в одном из трех мест:357Чтобы найти отброшенную запись, посмотрите в одном из трех мест:

354 358

355* Интерактивные сеансы показывают диалог при запуске, перечисляющий неправильные записи.359* Интерактивные сеансы показывают диалоговое окно при запуске, в котором перечислены неправильные записи.

356* Неинтерактивные запуски с `-p` печатают сводку в stderr.360* Неинтерактивные запуски с `-p` выводят сводку в stderr.

357* [`claude doctor`](/docs/ru/debug-your-config) перечисляет каждую неправильную запись с ее источником и полем.361* [`claude doctor`](/docs/ru/debug-your-config) перечисляет каждую неправильную запись с ее источником и полем.

358 362

359<h4 id="keys-that-fail-closed">363<h4 id="keys-that-fail-closed">

360 Ключи, которые не удаются закрыто364 Ключи, которые не проходят закрыто

361</h4>365</h4>

362 366

363Несколько ключей применения не отбрасываются, когда они неправильны. Claude Code применяет более строгое резервное значение, пока значение не будет исправлено; таблица показывает, что оно применяет для каждого ключа:367Когда управляемый источник устанавливает ключ верхнего уровня, который имеет одно ограничивающее значение, такое как `allowManagedPermissionRulesOnly`, `disableAutoMode` или `skipDangerousModePermissionPrompt`, на что-то, что Claude Code не может прочитать, ключ читается как это значение, пока вы его не исправите. Отчет говорит, что ключ `was present but invalid` и называет значение, которое Claude Code рассматривает как. Для ключа внутри `sandbox` см. [Неправильные значения внутри `sandbox`](#invalid-values-inside-sandbox).

368

369Эти случаи не проходят закрыто:

370

371* `null` удаляет ключ.

372* Неправильный `disableAllHooks`, даже логическое значение в кавычках, отбрасывается с предупреждением, потому что применение `true` также выгрузит hooks, которые развертывают ваши собственные управляемые параметры.

373* Для каждого другого логического ключа, который охватывает правило, строка `"true"` или `"false"` читается как это логическое значение, с уведомлением в `/status`, просящим вас удалить кавычки.

374

375Claude Code исправляет блоки `permissions`, `autoMode`, `worktree` и `attribution` по полям вместо того, чтобы отбрасывать их целиком:

376

377* Блокировка внутри одного, такая как `permissions.disableBypassPermissionsMode`, читается как его ограничивающее значение.

378* Неправильный `permissions.defaultMode` читается как `default`.

379* Хотя список `deny` или `ask` в `permissions` не может быть прочитан вообще, Claude Code удерживает `allow` и `additionalDirectories`, поэтому гранты никогда не применяются без ограничений, написанных рядом с ними. Отчет называет каждый удерживаемый грант и список, который не мог быть прочитан.

380* В `autoMode` список `soft_deny` или `hard_deny`, который не может быть прочитан или потерял неправильную запись, удерживает `allow` и `environment` таким же образом.

381

382Правило не проходит закрыто для ключей с одним ограничивающим значением и исправления по полям требуют Claude Code v2.1.282 или позже.

364 383

365| Поле | Поведение, когда присутствует, но неправильно |384Эти ключи имеют свой собственный резервный вариант:

385

386| Поле | Поведение при наличии, но неправильном |

366| :- | :- |387| :- | :- |

367| `allowedMcpServers` | Применяется как пустой список разрешений, пока значение не будет исправлено, поэтому никакие MCP серверы, которые добавляют пользователи, не допускаются. Серверы, которые ваша организация доставляет через [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers), все еще загружаются, и серверы `managed-mcp.json` загружаются в соответствии с [Как сервер оценивается](/docs/ru/managed-mcp#how-a-server-is-evaluated). Отдельная неправильная запись удаляется и применяется действительное подмножество. |388| `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 удаляет эту запись и применяет остальное. |389| `allowedHttpHookUrls` | Claude Code применяет пустой управляемый [список разрешений](/docs/ru/settings-reference#allowedhttphookurls) до исправления значения, поэтому HTTP hook работает только если другой файл параметров перечисляет его URL. Если неправильна только отдельная запись, Claude Code удаляет эту запись и применяет остальное. |

369| `httpHookAllowedEnvVars` | Claude Code применяет пустой [список разрешений](/docs/ru/settings-reference#httphookallowedenvvars), пока вы не исправите значение, поэтому переменная заголовка интерполируется только если другой файл параметров называет ее. Если только отдельная запись неправильна, Claude Code удаляет эту запись и применяет остальное. |390| `httpHookAllowedEnvVars` | Claude Code применяет пустой управляемый [список разрешений](/docs/ru/settings-reference#httphookallowedenvvars) до исправления значения, поэтому переменная заголовка интерполируется только если другой файл параметров ее называет. Если неправильна только отдельная запись, Claude Code удаляет эту запись и применяет остальное. |

370| `allowedChannelPlugins` | Claude Code применяет пустой список разрешений, пока вы не исправите значение, поэтому никакой плагин канала, переданный в `--channels`, не допускается. Если только отдельная запись неправильна, она удаляет эту запись и применяет остальное. |391| `allowedChannelPlugins` | Claude Code применяет пустой список разрешений до исправления значения, поэтому ни один плагин канала, переданный в `--channels`, не допускается. Если неправильна только отдельная запись, он удаляет эту запись и применяет остальное. |

371| `strictKnownMarketplaces` | Применяется как пустой список разрешений, пока значение не будет исправлено, поэтому никакой [источник marketplace](/docs/ru/plugins/org#restrict-what-users-can-install) не допускается. Отдельная запись, которая неправильна или не может быть применена, такая как регулярное выражение `hostPattern`, которое не компилируется, удаляется и применяется действительное подмножество. |392| `strictKnownMarketplaces` | Применяется как пустой список разрешений до исправления значения, поэтому ни один [источник маркетплейса](/docs/ru/plugins/org#restrict-what-users-can-install) не допускается. Отдельная запись, которая неправильна или не может быть применена, такая как регулярное выражение `hostPattern`, которое не компилируется, удаляется и применяется допустимое подмножество. |

372| `allowManagedHooksOnly` | Обрабатывается как `true`, пока не будет исправлено: [ограничения hook](/docs/ru/settings-reference#allowmanagedhooksonly) применяются и, если `disableCommandPluginSources` явно не `false`, плагины, полученные из команд, отключены. |393| `availableModels` | Применяется как пустой список разрешений до исправления, поэтому доступна только модель по умолчанию; запись, которая не является строкой, удаляется и применяется допустимое подмножество. |

374| `disableCommandPluginSources` | Обрабатывается как `true`, поэтому плагины, полученные из команд, остаются отключены, пока значение не будет исправлено. |395| `forceLoginOrgUUID` | Ни одной организации не разрешается входить до исправления значения. |

375| `disableSideloadFlags` | Обрабатывается как `true`, пока значение не будет исправлено, с эффектами, перечисленными для [`disableSideloadFlags`](/docs/ru/settings-reference#disablesideloadflags). |396| `gatewayInternalNetworks` | Когда неправильное значение поступает от наивысшего управляемого источника на машине, `/login` отказывает каждому новому входу [облачного шлюза](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) на этой машине до исправления значения. |

376| `availableModels` | Применяется как пустой список разрешений, пока не будет исправлено, поэтому доступна только модель Default; запись, не являющаяся строкой, удаляется и применяется действительное подмножество. |397| `crossSessionInbound` | Рассматривается как `refuse`, наиболее ограничивающее значение, поэтому входящие [сообщения между сеансами](/docs/ru/cross-session-messaging#control-inbound-messages) отказываются до исправления значения. Разработчик видит [предупреждение](/docs/ru/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |

377| `enforceAvailableModels` | Обрабатывается как `true`. |398| `deniedMcpServers` | Неправильная отдельная запись удаляется и применяется допустимое подмножество. Полностью неправильное значение отбрасывается с предупреждением, так как отрицание каждого сервера заблокирует серверы, которые политика никогда не называла. |

378| `syncClaudeAiPlugins` | Обрабатывается как `false`, поэтому синхронизация [плагинов claude.ai](/docs/ru/settings-reference#syncclaudeaiplugins) отключена, пока значение не будет исправлено. |399| [`deniedModels`](/docs/ru/settings-reference#deniedmodels) | Запись, которая не является строкой, удаляется и остальная часть списка применяется. Полностью неправильное значение отбрасывается с предупреждением и не блокирует никакие модели до исправления. |

379| `forceLoginOrgUUID` | Никакой организации не разрешается входить, пока значение не будет исправлено. |400| `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) на этой машине, пока значение не будет исправлено. |401| `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). |402| `sandbox.credentials` | Восстанавливаемая неправильная запись деградирует до `mode: "deny"` с предупреждением; невосстанавливаемая удаляется; допустимые записи остаются применяемыми. См. [неправильные записи учетных данных](/docs/ru/settings-reference#invalid-credential-entries-in-managed-settings). |

382| `deniedMcpServers` | Отдельная неправильная запись удаляется и применяется действительное подмножество. Полностью неправильное значение отбрасывается с предупреждением, так как отрицание каждого сервера заблокировало бы серверы, которые политика никогда не называла. |403| `strictPluginOnlyCustomization` | Рассматривается как `true`, блокирующее все четыре поверхности, когда значение не является ни логическим, ни массивом. Запись массива, которую эта версия не распознает как поверхность, не блокирует ничего; примечание статуса считает такие записи, чтобы вы могли проверить их на опечатки. |

383| `blockedMarketplaces` | Отдельная неправильная запись удаляется и применяется действительное подмножество. Запись, которая анализируется, но никогда не может совпадать, такая как регулярное выражение `hostPattern`, которое не компилируется, сохраняется с предупреждением. Она ничего не блокирует, пока не будет исправлена, но [ограничения marketplace](/docs/ru/plugins/org#restrict-what-users-can-install) остаются активными. Полностью неправильное значение отбрасывается с предупреждением, так как блокирование каждого marketplace заблокировало бы источники, которые политика никогда не называла. |404| `enabledPlugins` | Неправильная запись отбрасывается с предупреждением и другие записи остаются применяемыми. Значение, которое не является картой ID плагинов или чья каждая запись неправильна, отбрасывается целиком с предупреждением. |

384| `sandbox.credentials` | Восстанавливаемая неправильная запись деградирует до `mode: "deny"` с предупреждением; невосстанавливаемая удаляется; действительные записи остаются применяемыми. См. [неправильные записи учетных данных](/docs/ru/settings-reference#invalid-credential-entries-in-managed-settings) |

385 405

386`allowedHttpHookUrls` и `httpHookAllowedEnvVars` объединяются в файлах параметров, поэтому записи в ваших пользовательских, проектных или локальных параметрах все еще применяются, пока управляемый список пуст.406`allowedHttpHookUrls` и `httpHookAllowedEnvVars` объединяются в файлах параметров, поэтому записи в ваших пользовательских, проектных или локальных параметрах все еще применяются, пока управляемый список пуст.

387 407

388Резервные значения для этих двух ключей и для `allowedChannelPlugins` требуют Claude Code v2.1.267 или позже; более ранние версии отбрасывают весь ключ, когда его значение или любая запись неправильна. Резервные значения для `strictKnownMarketplaces`, `blockedMarketplaces` и `disableSideloadFlags` требуют Claude Code v2.1.277 или позже; более ранние версии отбрасывают весь ключ, когда его значение или любая запись неправильна.408Резервные варианты для этих двух ключей и для `allowedChannelPlugins` требуют Claude Code v2.1.267 или позже; более ранние версии отбрасывают весь ключ, когда его значение или любая запись неправильна. Резервные варианты `strictKnownMarketplaces` и `blockedMarketplaces` требуют Claude Code v2.1.277 или позже; более ранние версии отбрасывают весь ключ, когда его значение или любая запись неправильна. Резервные варианты `strictPluginOnlyCustomization` и `enabledPlugins` требуют Claude Code v2.1.282 или позже.

409

410`requiredMinimumVersion` и `requiredMaximumVersion` не проходят открыто по замыслу: неправильное значение отбрасывается, а не применяется.

411

412Эта толерантность применяется только к управляемым параметрам. Файлы пользовательских, проектных и локальных параметров остаются строгими: файл, чья JSON или форма верхнего уровня не проходит проверку, отклоняется целиком и сообщается, и отдельная запись, которая не проходит, такая как неправильное правило разрешения, пропускается с предупреждением, пока остальная часть файла применяется.

413

414<h4 id="invalid-values-inside-sandbox">

415 Неправильные значения внутри `sandbox`

416</h4>

417

418Когда одно значение в вашем управляемом блоке `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 419

390`requiredMinimumVersion` и `requiredMaximumVersion` не удаются открыто по замыслу: неправильное значение отбрасывается, а не применяется.420Предупреждение, которое вы получаете для неправильного поля, называет поле и говорит вам, что с ним происходит. Что происходит, зависит от того, что контролирует поле:

391 421

392Эта толерантность применяется только к управляемым параметрам. Файлы параметров пользователя, проекта и локального остаются строгими: файл, чья JSON или форма верхнего уровня не проходит проверку, отклоняется целиком и сообщается, и отдельная запись, которая не удается, такая как неправильное правило разрешения, пропускается с предупреждением, пока остальная часть файла применяется.422* Если вы установите логический ключ на кавычки `"true"` или `"false"`, значение считается этим логическим. Вместо предупреждения `/status` показывает уведомление, просящее вас удалить кавычки.

423* Если `failIfUnavailable` неправильно, Claude Code отбрасывает значение, а не рассматривает его как `true`, поэтому нечитаемое значение никогда не останавливает сеансы от запуска на всем вашем парке.

424* Claude Code рассматривает каждое другое неправильное логическое значение как значение, которое держит песочницу самой строгой до исправления. Ключ, который включает песочницу или одно из ее ограничений, такой как `enabled` или `network.allowManagedDomainsOnly`, считается `true`. Ключ, который ослабляет ее, такой как `allowUnsandboxedCommands`, считается `false`.

425* В списке вне `credentials`, такой как `excludedCommands` или `network.allowedDomains`, Claude Code отбрасывает неправильную запись и сохраняет остальную часть списка. Список, который не является массивом или не имеет допустимой записи, вообще не применяется.

426* Пока `network.deniedDomains` или любая запись в нем неправильна, Claude Code также удерживает `network.allowedDomains`, поэтому управляемый список разрешений ничего не предоставляет до исправления списка отрицания.

427* Пока `filesystem.denyRead`, `filesystem.denyWrite` или любая запись в любом из них неправильна, Claude Code также удерживает оба `filesystem.allowRead` и `filesystem.allowWrite` до исправления списка отрицания.

393 428

394<span id="managed-only-settings" />429<span id="managed-only-settings" />

395 430

401 436

402Большинство из них — это блокировки: значение, которое блокировка управляет, такое как правила разрешения или `sandbox.network.allowedDomains`, — это обычный ключ, который может установить любой уровень, и блокировка говорит Claude Code чтить только управляемое значение.437Большинство из них — это блокировки: значение, которое блокировка управляет, такое как правила разрешения или `sandbox.network.allowedDomains`, — это обычный ключ, который может установить любой уровень, и блокировка говорит Claude Code чтить только управляемое значение.

403 438

404Таблица охватывает элементы управления разрешением, плагином и доставкой. Для любого ключа, не указанного здесь, столбец Scope [справочника параметров](/docs/ru/settings-reference#all-settings) говорит, является ли он только управляемым; оставшиеся ключи только управляемые там включают URL входа шлюза, версию, браузер, мобильный симулятор, хост SSH, локальный сеанс Desktop, путь двоичного файла песочницы, ценообразование модели и элементы управления CLAUDE.md.439Таблица охватывает элементы управления разрешением, плагином и доставкой. Для любого ключа, не указанного здесь, столбец Scope [справочника параметров](/docs/ru/settings-reference#all-settings) говорит, является ли он только управляемым; оставшиеся ключи только управляемые там включают URL входа шлюза, версию, браузер, мобильный симулятор, хост SSH, локальный сеанс Desktop, путь двоичного файла песочницы, ценообразование модели, ограничение модели и элементы управления CLAUDE.md.

405 440

406| Параметр | Описание |441| Параметр | Описание |

407| :- | :- |442| :- | :- |

425| [`sandbox.network.allowManagedDomainsOnly`](/docs/ru/settings-reference#sandbox-network-allowmanageddomainsonly) | Чтите только управляемые `allowedDomains` и правила разрешения `WebFetch(domain:...)`; блокируйте другие домены без подсказки |460| [`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) |461| [`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` блокирует все четыре, массив называет, какие |462| [`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); запись дает порядок |463| [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) | Когда установлено в реестре HKLM или файле под `C:\Program Files\ClaudeCode`, имейте WSL читать цепь политики Windows и читайте `/etc/claude-code` только когда [нет документа администратора Windows](#present-admin-documents); запись дает порядок |

429 464

430<Note>465<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). Веб-сеансы не имеют ключа управляемых параметров для каждого устройства.466 На планах 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 484

450Claude Code применяет значение `1` без показа пользователю [диалога одобрения](/docs/ru/server-managed-settings#environment-variables-and-the-approval-dialog).485Claude Code применяет значение `1` без показа пользователю [диалога одобрения](/docs/ru/server-managed-settings#environment-variables-and-the-approval-dialog).

451 486

452Если вы отключите телеметрию, Claude Code прекратит отправку данных об использовании, которые питают [панель аналитики](/docs/ru/analytics) вашей организации для разработчиков, которых достигает политика. Переменная также отключает получение флагов функций, что делает Remote Control, режим автоматического по умолчанию и другие [функции, которые нуждаются в получении флагов функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), недоступными для этих разработчиков.487Если вы отключите телеметрию, 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 488

454[Где и когда политика применяется](#where-and-when-a-policy-applies) говорит, какой механизм доставки достигает каждую поверхность, и [Доступность платформы](/docs/ru/server-managed-settings#platform-availability) говорит, какие сеансы пропускают выборку управляемых параметров сервера.489[Где и когда политика применяется](#where-and-when-a-policy-applies) говорит, какой механизм доставки достигает каждую поверхность, и [Доступность платформы](/docs/ru/server-managed-settings#platform-availability) говорит, какие сеансы пропускают выборку управляемых параметров сервера.

455 490

mcp.md +257 −240

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, в который вы входили ранее, остаётся видимым даже если в настоящий момент требуется повторная аутентификация.

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 +141 −78

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Если вы переключаете модели с помощью `/model`, переключение также достигает [подагентов, которые наследуют модель основного разговора](/docs/ru/sub-agents#choose-a-model), потому что Claude Code разрешает их модель из той, которую использует ваш сеанс, когда Claude их запускает. Переключитесь на Opus перед тем, как Claude делегирует исследование или тестовые запуски одному из них, и эта работа также будет выполняться на Opus. Чтобы сохранить пользовательского подагента на меньшей модели, установите `model` в его определении.

142 142

143Если вы установите модель с `/model` в [неинтерактивном режиме](/docs/ru/headless), с флагом `-p`, ваш выбор применяется только к текущему сеансу и не сохраняется как ваша стандартная; `/model` в этом режиме требует Claude Code версии 2.1.205 или позже. Параметры проекта и управляемые параметры по-прежнему имеют приоритет и переприменяются при следующем запуске. [Стандартная модель организации](#organization-default-model), которую ваш администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.143Если вы установите модель с помощью `/model` в [неинтерактивном режиме](/docs/ru/headless), с флагом `-p`, ваш выбор применяется только к текущему сеансу и не сохраняется как ваша стандартная; `/model` в этом режиме требует Claude Code версии 2.1.205 или позже. Параметры проекта и управляемые параметры по-прежнему имеют приоритет и переприменяются при следующем запуске. [Стандартная модель организации](#organization-default-model), которую ваш администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.

144 144

145В версиях 2.1.144 по 2.1.152 `/model` применялся только к текущему сеансу, а `d` в средстве выбора сохранял стандартную.145В версиях 2.1.144 по 2.1.152 `/model` применялся только к текущему сеансу, а `d` в средстве выбора сохранял стандартную.

146 146

147Флаг `--model` и переменная окружения `ANTHROPIC_MODEL` применяются только к сеансу, который вы запускаете с ними. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждый с его собственным флагом `--model` вместо переключения с `/model`.147Флаг `--model` и переменная окружения `ANTHROPIC_MODEL` применяются только к сеансу, который вы запускаете с ними. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждый с его собственным флагом `--model` вместо переключения с помощью `/model`.

148 148

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

150 150

151Возобновлённые сеансы, запущенные с `claude --resume`, `--continue` или средством выбора `/resume`, сохраняют модель, которую они использовали при сохранении стенограммы, независимо от текущего параметра `model`. Если восстановленная модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сеанс переходит к нормальному порядку приоритета. Это предотвращает изменение модели при возобновлении из-за выбора `/model` другого сеанса. На поставщиках, которые используют ID развёртывания, специфичные для поставщика, а не ID моделей Anthropic, такие как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, модель стенограммы вообще не восстанавливается, и сеанс разрешает свою модель через нормальный порядок приоритета.151Возобновлённые сеансы, начатые с помощью `claude --resume`, `--continue` или средства выбора `/resume`, сохраняют модель, которую они использовали, когда стенограмма была сохранена, независимо от текущего параметра `model`. Если восстановленная модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сеанс переходит к нормальному порядку приоритета. Это предотвращает изменение модели при возобновлении из-за выбора `/model` другого сеанса. На поставщиках, которые используют специфичные для поставщика ID развёртывания вместо ID моделей Anthropic, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, модель стенограммы вообще не восстанавливается, и сеанс разрешает свою модель через нормальный порядок приоритета.

152 152

153Модель, которую вы выбираете для нового запуска с `--model` или `ANTHROPIC_MODEL`, по-прежнему имеет приоритет над восстановленной моделью. Начиная с версии 2.1.195, также переменная семейства [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables). [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) может тоже, при условиях, перечисленных в её разделе.153Модель, которую вы выбираете для нового запуска с помощью `--model` или `ANTHROPIC_MODEL`, по-прежнему имеет приоритет над восстановленной моделью. Начиная с версии 2.1.195, переменная семейства [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables) также имеет приоритет. [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) может тоже, при условиях, перечисленных в её разделе.

154 154

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) говорит, какие ключи и переменные переопределяет хост.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) говорит, какие ключи и переменные переопределяет хост.

156 156

158 158

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) для сообщения и восстановления.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) для сообщения и восстановления.

160 160

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 распознаёт:161Когда вы переключаете модели через метод [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 162

163* псевдоним модели163* псевдоним модели

164* запись из средства выбора `/model`164* запись из средства выбора `/model`

165* любое имя, которое начинается с `claude-`165* любое имя, которое начинается с `claude-`

166* значение, которое вы сами настроили как [пользовательский вариант модели](#add-a-custom-model-option) или в [`modelOverrides`](#override-model-ids-per-version)166* значение, которое вы сами настроили как [пользовательский вариант модели](#add-a-custom-model-option) или в [`modelOverrides`](#override-model-ids-per-version)

167 167

168Claude Code отклоняет неузнанную строку с `Model "<name>" is not a recognized model id.` и сеанс сохраняет свою текущую модель, вместо сохранения строки и отказа при следующем запросе. См. [справку по ошибкам](/docs/ru/errors#model-is-not-a-recognized-model-id) для шагов восстановления.168Claude Code отклоняет нераспознанную строку с `Model "<name>" is not a recognized model id.` и сеанс сохраняет свою текущую модель, вместо сохранения строки и сбоя при следующем запросе. См. [справку по ошибкам](/docs/ru/errors#model-is-not-a-recognized-model-id) для шагов восстановления.

169 169

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) во время запроса на каждом поставщике.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) во время запроса на каждом поставщике.

171 171

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) вместо этого.172Когда запрошенная модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, 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 173

174Например, запустите сеанс на Opus:174Например, запустите сеанс на Opus:

175 175

177claude --model opus177claude --model opus

178```178```

179 179

180Затем переключите модели из сеанса:180Затем переключайте модели из сеанса:

181 181

182```text theme={null}182```text theme={null}

183/model sonnet183/model sonnet

204 204

205* Флаг `--model`205* Флаг `--model`

206* `ANTHROPIC_MODEL`206* `ANTHROPIC_MODEL`

207* Значение `model` в любом файле параметров, включая выбор, который вы сохраняете с `/model`207* Значение `model` в любом файле параметров, включая выбор, который вы сохраняете с помощью `/model`

208* [Стандартная модель организации](#organization-default-model)208* [Стандартная модель организации](#organization-default-model)

209 209

210Выбор, который вы сохраняете с `/model`, имеет приоритет над переменной при последующих запусках тоже. С установленным `ANTHROPIC_MODEL` вместо этого Claude Code возвращается к модели переменной при следующем запуске, независимо от того, что вы сохранили с `/model`.210Выбор, который вы сохраняете с помощью `/model`, имеет приоритет над переменной при последующих запусках. С установленным `ANTHROPIC_MODEL` вместо этого Claude Code возвращается к модели этой переменной при следующем запуске, независимо от того, что вы сохранили с помощью `/model`.

211 211

212Claude Code также разрешает опцию Default на модель переменной, если не применяется стандартная модель организации. Когда опция Default разрешается на модель переменной, строка Default в средстве выбора `/model` показывает метку Set by ANTHROPIC\_DEFAULT\_MODEL.212Claude Code также разрешает опцию Default на модель переменной, если не применяется стандартная модель организации. Когда опция Default разрешается на модель переменной, строка Default в средстве выбора `/model` показывает метку Set by ANTHROPIC\_DEFAULT\_MODEL.

213 213

214Claude Code игнорирует переменную в этих случаях, и опция Default разрешается как если бы вы её не установили:214Claude Code игнорирует переменную в этих случаях, и опция Default разрешается так, как если бы вы её не установили:

215 215

216* Вы установили её на `default`, `inherit`, `opusplan` или `haiku`216* Вы установили её на `default`, `inherit`, `opusplan` или `haiku`

217* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) включена217* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) включена

218* [`availableModels`](#restrict-model-selection) или [ограничения модели организации](#organization-model-restrictions) исключают модель218* [Ограничения модели](#restrict-model-selection) вашей организации исключают модель

219* Модель недоступна для вашей учётной записи219* Модель недоступна для вашей учётной записи

220 220

221Когда новый сеанс запустится на модели переменной, сеанс, который вы возобновляете с `claude --resume`, `--continue` или средством выбора `/resume`, также запустится на ней. Claude Code не восстанавливает модель, сохранённую в стенограмме этого сеанса. В противном случае Claude Code не использует переменную, когда вы [возобновляете сеанс](#setting-your-model).221Когда новый сеанс запустится на модели переменной, сеанс, который вы возобновляете с помощью `claude --resume`, `--continue` или средства выбора `/resume`, также запустится на ней. Claude Code не восстанавливает модель, сохранённую в стенограмме этого сеанса. В противном случае Claude Code не использует переменную, когда вы [возобновляете сеанс](#setting-your-model).

222 222

223<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">223<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">

224 Новый сеанс запускается на другой модели, чем вы выбрали224 Новый сеанс запускается на другой модели, чем вы выбрали

225</h4>225</h4>

226 226

227Когда вы выбираете модель с `/model` и ваш следующий сеанс запускается на чём-то другом, это обычные причины:227Когда вы выбираете модель с помощью `/model` и ваш следующий сеанс запускается на чём-то другом, это обычные причины:

228 228

229* **Вы выбрали её для одного сеанса.** Нажатие `s` в средстве выбора, запуск с `--model` и запуск `/model` в неинтерактивном режиме все применяются к текущему сеансу и оставляют вашу сохранённую стандартную без изменений.229* **Вы выбрали её для одного сеанса.** Нажатие `s` в средстве выбора, запуск с помощью `--model` и запуск `/model` в неинтерактивном режиме применяются только к текущему сеансу и оставляют вашу сохранённую стандартную без изменений.

230* **Что-то с более высоким приоритетом устанавливает модель.** Значение `model` в параметрах проекта или управляемых параметрах, `ANTHROPIC_MODEL` в вашей оболочке или [стандартная модель организации](#organization-default-model), которую ваш администратор установил для переопределения выбора пользователя, применяется снова при каждом запуске. Ваш выбор `/model` по-прежнему сохранён; он лишь уступает по приоритету. Когда параметры проекта или управляемые параметры устанавливают модель, заголовок запуска называет файл.230* **Что-то с более высоким приоритетом устанавливает модель.** Значение `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).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).

232* **Вы возобновили сеанс.** Сеанс, который вы возобновляете с `claude --resume` или `--continue`, обычно [сохраняет модель, которую он использовал](#setting-your-model), вместо вашей текущей стандартной.232* **Вы возобновили сеанс.** Сеанс, который вы возобновляете с помощью `claude --resume` или `--continue`, обычно [сохраняет модель, которую он использовал](#setting-your-model), вместо вашей текущей стандартной.

233 233

234<h2 id="restrict-model-selection">234<h2 id="restrict-model-selection">

235 Ограничение выбора модели235 Ограничение выбора модели

236</h2>236</h2>

237 237

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.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. Чтобы заблокировать модель, которую разрешает список, или чтобы каждая запись идентификатора модели разрешала только версию, которую она называет, см. [Блокировка конкретных моделей или версий](#block-specific-models-or-versions).

239 239

240На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми параметрами модели, в то время как управляемый список разрешений `availableModels` остается в силе, если только хост не предоставляет свой собственный; [Исключения из приоритета управляемых параметров](/docs/ru/settings#exceptions-to-managed-settings-precedence) указывает, какие ключи и переменные переопределяет хост.240На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми параметрами модели, в то время как управляемый список разрешений `availableModels` остается в силе, если только хост не предоставляет свой собственный; [Исключения из приоритета управляемых параметров](/docs/ru/settings#exceptions-to-managed-settings-precedence) указывает, какие ключи и переменные переопределяет хост.

241 241

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

306</h3>306</h3>

307 307

308Сам по себе `availableModels` оставляет параметр Default на [значении по умолчанию runtime](#default-model-setting) системы для учетной записи, пока вы также не установите [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Если это значение по умолчанию — это модель, которую вы намереваетесь ограничить, установите `enforceAvailableModels` также.308С префиксным сопоставлением по умолчанию, `availableModels` сам по себе оставляет параметр Default на [значении по умолчанию runtime](#default-model-setting) системы для учетной записи, пока вы также не установите [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Если это значение по умолчанию — это модель, которую вы намереваетесь ограничить, установите `enforceAvailableModels` также или [заблокируйте эту модель](#block-specific-models-or-versions).

309 309

310Пустой массив `availableModels` никогда не включает применение Default-модели: с `availableModels: []`, именованные выборы моделей блокируются, но модель Default для типа учетной записи остается пригодной для использования независимо от `enforceAvailableModels`.310С `availableModels: []`, именованные выборы моделей блокируются и `enforceAvailableModels` не имеет никакого эффекта.

311 311

312<h3 id="enforce-the-allowlist-for-the-default-model">312<h3 id="enforce-the-allowlist-for-the-default-model">

313 Применение списка разрешений к модели Default313 Применение списка разрешений к модели Default

324 324

325Параметр Default разрешается в значение по умолчанию типа учетной записи или в [модель по умолчанию организации](#organization-default-model), когда администратор установил одну. Когда эта модель не находится в списке разрешений, параметр Default вместо этого разрешается в первую запись `availableModels`, которая называет разрешенную, доступную модель, и строка Default средства выбора `/model` показывает эту модель. Это применяется везде, где достигается значение по умолчанию: запуск сессии, выбор Default в `/model`, ключевое слово `"default"` в [цепочках резервных моделей](#fallback-model-chains) и резервный вариант, используемый при удалении исключенного выбора.325Параметр Default разрешается в значение по умолчанию типа учетной записи или в [модель по умолчанию организации](#organization-default-model), когда администратор установил одну. Когда эта модель не находится в списке разрешений, параметр Default вместо этого разрешается в первую запись `availableModels`, которая называет разрешенную, доступную модель, и строка Default средства выбора `/model` показывает эту модель. Это применяется везде, где достигается значение по умолчанию: запуск сессии, выбор Default в `/model`, ключевое слово `"default"` в [цепочках резервных моделей](#fallback-model-chains) и резервный вариант, используемый при удалении исключенного выбора.

326 326

327`enforceAvailableModels` переназначает параметр Default только когда `availableModels` непуст. С `availableModels: []`, модель Default для типа учетной записи остается пригодной для использования, поэтому параметр не может заблокировать пользователей из каждой модели. Когда `availableModels` непуст, но ни одна запись не разрешается в разрешенную и доступную модель, применение пропускается и Default разрешается в значение по умолчанию типа учетной записи с предупреждением, видимым только под `--debug`. Сохраняйте по крайней мере одну гарантированно доступную запись в списке, чтобы избежать этого.327`enforceAvailableModels` переназначает параметр Default только когда `availableModels` непуст. Когда `availableModels` непуст, но ни одна запись не разрешается в разрешенную и доступную модель, применение пропускается с предупреждением, видимым только под `--debug`. Сохраняйте по крайней мере одну гарантированно доступную запись в списке, чтобы избежать этого.

328 328

329Развертывайте оба ключа вместе в источнике управляемых параметров с наивысшим рейтингом, который вы доставляете. По умолчанию Claude Code читает только этот источник, поэтому пара, размещенная в файле управляемых параметров, игнорируется, когда консоль администратора доставляет какие-либо параметры; при выборе слияния в [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), Claude Code все еще игнорирует карту `modelOverrides` из источника, ранжированного ниже того, который устанавливает `availableModels`.329Развертывайте оба ключа вместе в источнике управляемых параметров с наивысшим рейтингом, который вы доставляете. По умолчанию Claude Code читает только этот источник, поэтому пара, размещенная в файле управляемых параметров, игнорируется, когда консоль администратора доставляет какие-либо параметры; при выборе слияния в [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), Claude Code все еще игнорирует карту `modelOverrides` из источника, ранжированного ниже того, который устанавливает `availableModels`.

330 330

332 Управление моделью, на которой работают пользователи332 Управление моделью, на которой работают пользователи

333</h3>333</h3>

334 334

335Параметр `model` — это начальный выбор, а не применение. Он устанавливает, какая модель активна при запуске сессии, но пользователи все еще могут открыть `/model` и выбрать Default, который разрешается в [значение по умолчанию runtime](#default-model-setting) системы независимо от того, что установлено в `model`, если только [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) не перенаправляет его.335Параметр `model` — это начальный выбор, а не применение. Он устанавливает, какая модель активна при запуске сессии, но пользователи все еще могут открыть `/model` и выбрать Default, который разрешается в [значение по умолчанию runtime](#default-model-setting) системы независимо от того, что установлено в `model`, если только [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) или [ключи, которые блокируют конкретные версии](#block-specific-models-or-versions), не применяются к нему.

336 336

337Чтобы полностью управлять опытом модели, объедините эти параметры:337Чтобы полностью управлять опытом модели, объедините эти параметры:

338 338

339* **`availableModels`**: ограничивает, какие именованные модели пользователи могут переключать339* **`availableModels`**: ограничивает, какие именованные модели пользователи могут переключать

340* **`enforceAvailableModels`**: расширяет список разрешений `availableModels` на параметр Default, поэтому Default не может разрешиться в модель вне списка340* **`enforceAvailableModels`**: расширяет список разрешений `availableModels` на параметр Default, поэтому Default не может разрешиться в модель вне списка

341* **`deniedModels`** и **`availableModelsMatch`**: [блокируют конкретные версии](#block-specific-models-or-versions), которые запись `availableModels` иначе разрешила бы

341* **`model`**: устанавливает начальный выбор модели при запуске сессии342* **`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)343* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`** / **`ANTHROPIC_DEFAULT_FABLE_MODEL`**: управляют тем, на что разрешаются псевдонимы `sonnet`, `opus`, `haiku` и `fable`, и какую версию использует [значение по умолчанию типа учетной записи](#default-model-setting)

343 344

370 371

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).372Когда включена [конечная точка 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 373

374<h3 id="block-specific-models-or-versions">

375 Блокировка конкретных моделей или версий

376</h3>

377

378Запись `availableModels`, такая как `claude-opus-5`, также разрешает более поздние выпуски, которые расширяют ее, такие как Opus 5.5, как только Claude Code их поддерживает. Два управляемых параметра позволяют вам задержать выпуск, и оба требуют Claude Code v2.1.283 или позже:

379

380* [`deniedModels`](/docs/ru/settings-reference#deniedmodels): перечислите модели для блокировки. Перечисленная модель блокируется даже когда `availableModels` ее разрешает, и ключ также работает без списка разрешений вообще. Выпуск, который ни одна запись не блокирует, остается разрешенным

381* [`availableModelsMatch`](/docs/ru/settings-reference#availablemodelsmatch): установите его на `"exact"`, чтобы каждый идентификатор модели в `availableModels` разрешал только версию, которую он называет. Более новая версия перечисленного идентификатора модели затем остается заблокированной, пока вы не добавите ее в список

382

383Более ранние версии игнорируют оба ключа, поэтому также установите [`requiredMinimumVersion`](/docs/ru/settings-reference#requiredminimumversion), чтобы предотвратить запуск этих версий.

384

385Этот пример разрешает модели Opus и Sonnet и блокирует Opus 5.5 в каждом написании, включая датированные и специфичные для поставщика идентификаторы:

386

387```json theme={null}

388{

389 "availableModels": ["opus", "sonnet"],

390 "deniedModels": ["claude-opus-5-5"]

391}

392```

393

394Заблокированная модель, будь то `deniedModels` называет ее или список `"exact"` ее опускает, рассматривается как заблокированный выбор везде, [где применяется список разрешений](#restrict-model-selection). Она скрыта из средства выбора `/model`, и `/model <name>` отклоняет ее. Если вы назовете заблокированный идентификатор модели с помощью `--model`, `ANTHROPIC_MODEL` или параметра `model`, Claude Code удаляет его при запуске и разрешает параметр Default вместо этого. Если [hook](/docs/ru/hooks) или фоновый запрос называет модель, которую `deniedModels` блокирует, такую как поле `model` hook агента, этот запрос запускается на модели сессии вместо этого.

395

396Параметр Default следует обоим ключам также, независимо от того, установили ли вы [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Если вы установите его с непустым `availableModels`, заблокированный default считается моделью вне списка разрешений. В противном случае параметр Default, который разрешился бы в заблокированную модель, понижается в этом порядке:

397

3981. Самая новая разрешенная версия того же семейства

3992. Самая новая разрешенная модель каждого семейства с более низкой стоимостью по очереди: Sonnet, затем Haiku

4003. Первая запись `availableModels`, которая называет разрешенную модель

401

402Если ни один из них не разрешен, сессия, запускаемая на параметре Default, [отказывает запуститься](/docs/ru/errors#managed-settings-block-the-default-model) с ошибкой, которая называет ключ для исправления. Список `"exact"` влияет на параметр Default только когда управляемый список `availableModels` называет по крайней мере одну модель или семейство.

403

404Claude Code читает оба ключа только из управляемых параметров. Если вы установите любой из них в параметрах пользователя, проекта или локальных параметрах или с `--settings`, Claude Code игнорирует его с предупреждением.

405

373<h3 id="organization-model-restrictions">406<h3 id="organization-model-restrictions">

374 Ограничения модели организации407 Ограничения модели организации

375</h3>408</h3>

417 450

418Организационное значение по умолчанию проходит эти проверки ограничений перед его принятием:451Организационное значение по умолчанию проходит эти проверки ограничений перед его принятием:

419 452

420* [`availableModels`](#restrict-model-selection) сам по себе не применяется к организационному значению по умолчанию, поэтому организационное значение по умолчанию вне списка разрешений по-прежнему применяется. Когда также установлен [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model), организационное значение по умолчанию вне списка разрешений переназначается первой записи списка разрешений, как и любое другое Default453* С совпадением префикса по умолчанию [`availableModels`](#restrict-model-selection) сам по себе не применяется к организационному значению по умолчанию, поэтому организационное значение по умолчанию вне списка разрешений по-прежнему применяется. Когда также установлен [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model), организационное значение по умолчанию вне списка разрешений переназначается первой записи списка разрешений, как и любое другое Default

421* организационное значение по умолчанию, которое [ограничения модели организации](#organization-model-restrictions) запрещают для вашего аккаунта, заменяется самой новой разрешенной моделью в его семействе или моделью с более низкой стоимостью, когда каждая версия ее ограничена454* организационное значение по умолчанию, которое [ограничения модели организации](#organization-model-restrictions) запрещают для вашего аккаунта, заменяется самой новой разрешенной моделью в его семействе или моделью с более низкой стоимостью, когда каждая версия ее ограничена

455* для организационного значения по умолчанию, которое `deniedModels` или список `"exact"` блокирует, см. [Блокировка определенных моделей или версий](#block-specific-models-or-versions)

422* организационное значение по умолчанию, которое вообще недоступно для вашего аккаунта, пропускается, и опция Default разрешается так, как это было бы [без организационного значения по умолчанию](#default-model-setting)456* организационное значение по умолчанию, которое вообще недоступно для вашего аккаунта, пропускается, и опция Default разрешается так, как это было бы [без организационного значения по умолчанию](#default-model-setting)

423 457

424Начиная с v2.1.199, когда организационное значение по умолчанию является другим семейством моделей от обычного значения по умолчанию типа вашего аккаунта, средство выбора `/model` сохраняет отдельную строку для этого обычного семейства, чтобы вы все еще могли переключиться на него для сеанса. В версиях v2.1.196 по v2.1.198 эта строка отсутствует в средстве выбора.458Начиная с v2.1.199, когда организационное значение по умолчанию является другим семейством моделей от обычного значения по умолчанию типа вашего аккаунта, средство выбора `/model` сохраняет отдельную строку для этого обычного семейства, чтобы вы все еще могли переключиться на него для сеанса. В версиях v2.1.196 по v2.1.198 эта строка отсутствует в средстве выбора.

513 Автоматический резервный вариант модели547 Автоматический резервный вариант модели

514</h3>548</h3>

515 549

516Этот раздел охватывает резервный вариант на основе содержимого из моделей Fable, Opus 5.5 и Opus 5. Для резервного варианта на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).550Этот раздел охватывает резервный вариант на основе содержимого из моделей Fable, Opus 5.5, Sonnet 5.5 и Opus 5. Для резервного варианта на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).

517 551

518Модели Fable, Opus 5.5 и Opus 5 работают с классификаторами безопасности, которые чаще всего отмечают содержимое кибербезопасности и биологии. Когда классификатор отмечает запрос и отмеченная категория имеет резервную модель, Claude Code повторно запускает запрос на этой модели и показывает уведомление в стенограмме. Для этих двух категорий резервная модель зависит от того, какая модель отказала:552Модели Fable, Opus 5.5, Sonnet 5.5 и Opus 5 работают с классификаторами безопасности, которые чаще всего отмечают содержимое кибербезопасности и биологии. Когда классификатор отмечает запрос и отмеченная категория имеет резервную модель, Claude Code повторно запускает запрос на этой модели и показывает уведомление в стенограмме. Для этих двух категорий резервная модель зависит от того, какая модель отказала:

519 553

520* **Fable 5.1, Fable 5 и Opus 5.5**: запросы, отмеченные биологией, повторно запускаются на Opus 5, а запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8.554* **Fable 5.1, Fable 5 и Opus 5.5**: запросы, отмеченные биологией, повторно запускаются на Opus 5, а запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8.

555* **Sonnet 5.5**: запросы, отмеченные кибербезопасностью, повторно запускаются на Sonnet 5. Запросы, отмеченные биологией, заканчиваются отказом, потому что Sonnet 5.5 не имеет резервной модели биологии.

521* **Opus 5**: запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8. Запросы, отмеченные биологией, заканчиваются отказом, потому что Opus 5 запускает свои собственные классификаторы биологии без резервной модели.556* **Opus 5**: запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8. Запросы, отмеченные биологией, заканчиваются отказом, потому что Opus 5 запускает свои собственные классификаторы биологии без резервной модели.

522 557

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).558На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code разрешает эти цели через идентификаторы моделей вашего развертывания. См. [Включение резервного варианта на Bedrock, Agent Platform и Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).

524 559

525После резервного варианта сеанс продолжается на резервной модели. Чтобы вернуться к исходной модели, запустите [`/model`](#setting-your-model).560После резервного варианта сеанс продолжается на резервной модели. Чтобы вернуться к исходной модели, запустите [`/model`](#setting-your-model).

526 561

544 579

545Некоторые случаи ведут себя иначе:580Некоторые случаи ведут себя иначе:

546 581

547* Когда отмеченная категория не имеет резервной модели, такой как флаг биологии на Opus 5, Claude Code не показывает подсказку и запрос заканчивается отказом.582* Когда отмеченная категория не имеет резервной модели, такой как флаг биологии на Opus 5 или Sonnet 5.5, Claude Code не показывает подсказку и запрос заканчивается отказом.

548* Если обе модели отмечают один и тот же запрос, вы можете отредактировать подсказку и повторить попытку, или начать новый сеанс.583* Если обе модели отмечают один и тот же запрос, вы можете отредактировать подсказку и повторить попытку, или начать новый сеанс.

549* На мобильных сеансах [Claude Code в веб-браузере](/docs/ru/claude-code-on-the-web) редактирование и повторная попытка не поддерживаются. Переключите модели или продолжите сеанс из браузера рабочего стола или приложения рабочего стола.584* На мобильных сеансах [Claude Code в веб-браузере](/docs/ru/claude-code-on-the-web) редактирование и повторная попытка не поддерживаются. Переключите модели или продолжите сеанс из браузера рабочего стола или приложения рабочего стола.

550* В [неинтерактивном режиме](/docs/ru/cli-reference#cli-flags) и интеграциях SDK, которые не могут показать подсказку, отмеченный запрос завершает ход с отказом.585* В [неинтерактивном режиме](/docs/ru/cli-reference#cli-flags) и интеграциях SDK, которые не могут показать подсказку, отмеченный запрос завершает ход с отказом.

554 Включение резервного варианта на Bedrock, Agent Platform и Foundry589 Включение резервного варианта на Bedrock, Agent Platform и Foundry

555</h4>590</h4>

556 591

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 может идентифицировать обе задействованные модели:592На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) идентификаторы моделей специфичны для поставщика, поэтому автоматический резервный вариант работает только когда Claude Code может идентифицировать каждую задействованную модель:

558 593

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

560* Резервная модель должна разрешаться в вашем развертывании. Если вы установите `ANTHROPIC_DEFAULT_OPUS_MODEL`, отмеченные запросы повторно запускаются на этой модели для каждой категории, которая имеет резервный вариант; флаг биологии на Opus 5 по-прежнему заканчивается отказом. Если вы не установите его, запросы, отмеченные кибербезопасностью, повторно запускаются на записи Opus 4.8 в списке моделей поставщика, а запросы, отмеченные биологией, из модели Fable или Opus 5.5 на записи Opus 5.595* Цель Opus должна разрешаться в вашем развертывании, независимо от того, какая модель отказала: установите `ANTHROPIC_DEFAULT_OPUS_MODEL` или сохраните запись Opus 4.8 в списке моделей поставщика. Без одной резервный вариант остается отключенным для каждой исходной модели, включая Sonnet 5.5, и отмеченные запросы заканчиваются отказом.

596* Резервная модель отмеченной категории должна разрешаться в вашем развертывании. Из модели 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 в списке моделей поставщика, если вы не установите его.

561 597

562Если какая-либо модель не может быть идентифицирована, Claude Code не переключается автоматически. Отмеченный запрос заканчивается сообщением об отказе, и вы можете переключить модели с помощью [`/model`](#setting-your-model) и повторить попытку. Установка `ANTHROPIC_DEFAULT_FABLE_MODEL` на идентификатор вашей модели Fable включает распознавание Fable. Установка `ANTHROPIC_DEFAULT_OPUS_MODEL` на идентификатор модели Opus дает отмеченным категориям цель резервного варианта, если только закрепление не называет модель вне семейства Opus или модель, которая отказала; затем Claude Code не переключается и отказ остается в силе.598Если какая-либо модель не может быть идентифицирована, Claude Code не переключается. Отмеченный запрос заканчивается сообщением об отказе, и вы можете переключить модели с помощью [`/model`](#setting-your-model) и повторить попытку. Чтобы сделать обе модели идентифицируемыми, установите закрепления для вашей исходной модели:

599

600* **Модели Fable**: установите `ANTHROPIC_DEFAULT_FABLE_MODEL` на идентификатор вашей модели Fable, чтобы Claude Code распознал ее как источник резервного варианта.

601* **Каждая исходная модель**: установите `ANTHROPIC_DEFAULT_OPUS_MODEL` на идентификатор модели Opus, чтобы включить резервный вариант и дать отмеченным категориям цель. Закрепление, которое называет модель вне семейства Opus или модель, которая отказала, оставляет отказ в силе.

602* **Sonnet 5.5**: в дополнение к закреплению Opus установите `ANTHROPIC_DEFAULT_SONNET_MODEL` или сохраните запись Sonnet 5 в списке моделей поставщика, чтобы предоставить модель, на которой запрос повторно запускается. Закрепление Sonnet, которое называет модель вне семейства Sonnet или Sonnet 5.5 само по себе, оставляет отказ в силе.

563 603

564<h4 id="security-research-and-biology-workloads">604<h4 id="security-research-and-biology-workloads">

565 Исследование безопасности и рабочие нагрузки биологии605 Исследование безопасности и рабочие нагрузки биологии

566</h4>606</h4>

567 607

568Рабочие нагрузки в наступательной безопасности или биологии, включая тестирование на проникновение, упражнения Capture the Flag (CTF) и кодовые базы, смежные с биологией, часто вызывают резервный вариант, часто при первом запросе. Для существенной работы по биологии на Fable 5.1, Fable 5 или Opus 5.5 Claude Code перемещает сеанс на Opus 5 при первом отмеченном запросе, и более поздние запросы, отмеченные биологией, заканчиваются отказами там, потому что Opus 5 не имеет резервного варианта биологии. На Opus 5 вы получаете эти отказы с первого отмеченного запроса.608Рабочие нагрузки в наступательной безопасности или биологии, включая тестирование на проникновение, упражнения Capture the Flag (CTF) и кодовые базы, смежные с биологией, часто вызывают резервный вариант, часто при первом запросе. Для существенной работы по биологии на Fable 5.1, Fable 5 или Opus 5.5 Claude Code перемещает сеанс на Opus 5 при первом отмеченном запросе, и более поздние запросы, отмеченные биологией, заканчиваются отказами там, потому что Opus 5 не имеет резервного варианта биологии. На Opus 5 и Sonnet 5.5 вы получаете эти отказы с первого отмеченного запроса.

569 609

570Это ожидаемая маршрутизация для этих областей, а не флаг учетной записи. Если вашей организации требуется возможность класса Fable для этой работы, обратитесь к команде учетной записи Anthropic о программах доверенного доступа.610Это ожидаемая маршрутизация для этих областей, а не флаг учетной записи. Если вашей организации требуется возможность класса Fable для этой работы, обратитесь к команде учетной записи Anthropic о программах доверенного доступа.

571 611

580| Модель | Уровни |620| Модель | Уровни |

581| :- | :- |621| :- | :- |

585 625

586Если вы установите уровень, который активная модель не поддерживает, Claude Code переходит на наивысший поддерживаемый уровень на или ниже установленного. Например, `xhigh` работает как `high` на Opus 4.6. Ваша организация или ваши собственные параметры также могут ограничивать уровни, которые предлагает модель; см. [Ограничения усилий организации](#organization-effort-limits).626Если вы установите уровень, который активная модель не поддерживает, Claude Code переходит на наивысший поддерживаемый уровень на или ниже установленного. Например, `xhigh` работает как `high` на Opus 4.6. Ваша организация или ваши собственные параметры также могут ограничивать уровни, которые предлагает модель; см. [Ограничения усилий организации](#organization-effort-limits).

589 629

5901. Явный выбор: переменная окружения [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars#variables), запуск с `--effort` или `/effort` в сеансе ([неинтерактивный `/effort` имеет более узкий эффект](#non-interactive-effort))6301. Явный выбор: переменная окружения [`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)6312. Ваши параметры: уровень, который вы сохранили для модели или ключ [`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), этот уровень является стандартным при запуске этой модели6323. Уровень усилий модели по умолчанию: `high` на каждой модели, которая поддерживает усилия, за исключением того, что Opus 5.5 и Sonnet 5.5 по умолчанию имеют `medium`, Opus 4.7 по умолчанию имеет `xhigh` и, когда ваша организация устанавливает уровень усилий по умолчанию для своей [модели по умолчанию организации](#organization-default-model), этот уровень является стандартным при запуске этой модели

593 633

594Opus 5.5 начинает с `medium`, если один из источников выше не устанавливает уровень для него, и верхний уровень `effortLevel` в файле параметров пользователя не считается для Opus 5.5. Этот ключ — это более старая форма, которую `/effort` писал перед тем, как Claude Code сохранял уровни для каждой модели: он продолжает применяться там, где применялся раньше, на Opus 5, Fable 5.1 и более ранних моделях, в то время как Opus 5.5 и модели, выпущенные после него, начинают со своего собственного стандарта, пока вы не выберете уровень для них с помощью `/effort` или средства выбора `/model`. Верхний уровень `effortLevel` в параметрах проекта, локальных или управляемых параметрах, или переданный с `--settings`, применяется к каждой модели.634Opus 5.5 начинает с `medium`, если один из источников выше не устанавливает уровень для него, и верхний уровень `effortLevel` в файле параметров пользователя не считается для Opus 5.5. Этот ключ — это более старая форма, которую `/effort` писал перед тем, как Claude Code сохранял уровни для каждой модели: он продолжает применяться там, где применялся раньше, на Opus 5, Fable 5.1 и более ранних моделях, в то время как Opus 5.5 и модели, выпущенные после него, начинают со своего собственного стандарта, пока вы не выберете уровень для них с помощью `/effort` или средства выбора `/model`. Верхний уровень `effortLevel` в параметрах проекта, локальных или управляемых параметрах, или переданный с `--settings`, применяется к каждой модели.

595 635

610 650

611Когда вы устанавливаете уровень с `/effort` в запуске [`-p`](/docs/ru/headless), Claude Code применяет его только к этому сеансу и не сохраняет его как стандартный.651Когда вы устанавливаете уровень с `/effort` в запуске [`-p`](/docs/ru/headless), Claude Code применяет его только к этому сеансу и не сохраняет его как стандартный.

612 652

613Меню `/effort` также предлагает `ultracode`. Ultracode — это параметр Claude Code, а не уровень усилий модели: он отправляет `xhigh` модели и дополнительно имеет Claude оркестрирует [динамические рабочие процессы](/docs/ru/workflows) для существенных задач. Для того, где это можно установить постоянно, см. параметр [`ultracode`](/docs/ru/settings-reference#ultracode).653Меню `/effort` также предлагает `ultracode`. Ultracode — это параметр Claude Code, а не уровень усилий модели: он отправляет `xhigh` модели и дополнительно имеет Claude оркестрировать [динамические рабочие процессы](/docs/ru/workflows) для существенных задач. Для того, где это можно установить постоянно, см. параметр [`ultracode`](/docs/ru/settings-reference#ultracode).

614 654

615Вы можете включить ultracode через любое из следующего:655Вы можете включить ultracode через любое из следующего:

616 656

641 681

642| Уровень | Когда его использовать |682| Уровень | Когда его использовать |

643| :- | :- |683| :- | :- |

644| `low` | Зарезервируйте для коротких, ограниченных, чувствительных к задержкам задач, которые не требуют интеллекта |684| `low` | Быстрые обмены, где вы проверяете каждый результат, такие как мозговой штурм, первый набросок или небольшое изменение, такое как переименование |

645| `medium` | Снижает использование токенов для работы, чувствительной к затратам, которая может пожертвовать некоторым интеллектом. Стандартный на Opus 5.5 |685| `medium` | Стандартный на Opus 5.5 и Sonnet 5.5, где он подходит для повседневной инженерной работы с четкой областью, такой как реализация новой функции. На других моделях снижает использование токенов для работы, чувствительной к затратам, которая может пожертвовать некоторым интеллектом |

646| `high` | Балансирует использование токенов и интеллект. Стандартный на каждой модели, кроме Opus 5.5 и Opus 4.7 |686| `high` | Работа, где проверка имеет значение или вероятны граничные случаи, такие как исправление ошибки в существующей кодовой базе. Стандартный на каждой модели, кроме Opus 5.5, Sonnet 5.5 и Opus 4.7 |

648| `max` | Может улучшить производительность на сложных задачах, но может показать убывающую отдачу и склонен к чрезмерному размышлению. Протестируйте перед широким внедрением |688| `max` | Сложные проблемы, которые вы хотите, чтобы Claude решил без вас, такие как поиск уязвимостей безопасности. `max` может показать убывающую отдачу и склонен к чрезмерному размышлению, поэтому протестируйте перед широким внедрением |

649| `ultracode` | Параметр Claude Code, который планирует [динамический рабочий процесс](/docs/ru/workflows) для каждой существенной задачи с рассуждением `xhigh` для каждого сообщения |689| `ultracode` | Параметр Claude Code, который планирует [динамический рабочий процесс](/docs/ru/workflows) для каждой существенной задачи с рассуждением `xhigh` для каждого сообщения |

650 690

691В тестах на Opus 5.5 и Fable 5.1 Claude на более высоком уровне протестировал больше граничных случаев и проверил больше своей работы перед ответом. Он также сделал больше выборов самостоятельно. На более низком уровне Claude вернул начальную точку быстрее, что подходит для работы, где вы проверяете каждый результат и направляете следующий шаг. Чтобы увидеть одни и те же задачи, выполняемые на каждом уровне, прочитайте [Using Claude Code: Spending your effort](https://claude.dev/blog/spending-your-effort/) в блоге.

692

651Шкала усилий откалибрована для каждой модели, поэтому одно и то же имя уровня не представляет одно и то же базовое значение между моделями.693Шкала усилий откалибрована для каждой модели, поэтому одно и то же имя уровня не представляет одно и то же базовое значение между моделями.

652 694

695Opus 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.

696

653<h4 id="use-ultrathink-for-one-off-deep-reasoning">697<h4 id="use-ultrathink-for-one-off-deep-reasoning">

654 Использование ultrathink для одноразового глубокого рассуждения698 Использование ultrathink для одноразового глубокого рассуждения

655</h4>699</h4>

682 726

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

684 728

685Модели Fable, Sonnet 5 и Opus 4.7 и позже всегда используют адаптивное рассуждение. Режим фиксированного бюджета размышления и `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` не применяются к ним.729Модели Fable, Sonnet 5 и позже, и Opus 4.7 и позже всегда используют адаптивное рассуждение. Режим фиксированного бюджета размышления и `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` не применяются к ним.

686 730

687На Opus 4.6 и Sonnet 4.6 вы можете установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`, чтобы вернуться к предыдущему фиксированному бюджету размышления, контролируемому `MAX_THINKING_TOKENS`. См. [переменные окружения](/docs/ru/env-vars).731На Opus 4.6 и Sonnet 4.6 вы можете установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`, чтобы вернуться к предыдущему фиксированному бюджету размышления, контролируемому `MAX_THINKING_TOKENS`. См. [переменные окружения](/docs/ru/env-vars).

688 732

696| :- | :- |740| :- | :- |

698| Установка глобального стандартного | Запустите `/config` и переключите режим размышления. Сохранено как `alwaysThinkingEnabled` в `~/.claude/settings.json` |742| Установка глобального стандартного | Запустите `/config` и переключите режим размышления. Сохранено как `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) |743| Отключение через переменную окружения | Установите [`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 744

701Вы не можете отключить размышление на Opus 5.5 или моделях Fable. Переключение сеанса, `alwaysThinkingEnabled` и `MAX_THINKING_TOKENS=0` не имеют эффекта там, и модель решает на каждом шаге, сколько думать на основе уровня усилий.745Вы не можете отключить размышление на Opus 5.5, Sonnet 5.5 или моделях Fable. Переключение сеанса, `alwaysThinkingEnabled` и `MAX_THINKING_TOKENS=0` не имеют эффекта там, и модель решает на каждом шаге, сколько думать на основе уровня усилий.

702 746

703Claude Code сворачивает вывод размышления по умолчанию. Нажмите `Ctrl+O`, чтобы переключить подробный режим и увидеть рассуждение как серый курсивный текст. Интерактивные сеансы на Anthropic API получают отредактированные блоки размышления по умолчанию, поэтому установите `showThinkingSummaries: true` в [параметрах](/docs/ru/settings), если вы хотите, чтобы полные резюме были доступны при расширении. Вам выставляется счет за все сгенерированные токены размышления, даже когда они свернуты или отредактированы.747Claude Code сворачивает вывод размышления по умолчанию. Нажмите `Ctrl+O`, чтобы переключить подробный режим и увидеть рассуждение как серый курсивный текст. Интерактивные сеансы на Anthropic API получают отредактированные блоки размышления по умолчанию, поэтому установите `showThinkingSummaries: true` в [параметрах](/docs/ru/settings), если вы хотите, чтобы полные резюме были доступны при расширении. Вам выставляется счет за все сгенерированные токены размышления, даже когда они свернуты или отредактированы.

704 748

706 Расширенный контекст750 Расширенный контекст

707</h3>751</h3>

708 752

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) для длительных сеансов с большими кодовыми базами.753Fable 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 754

711На Anthropic API Fable 5.1, Fable 5, Sonnet 5 и Opus 4.7 и позже работают с окном 1M по умолчанию на каждом плане, включая Pro. Вы не выбираете вариант `[1m]` или не включаете кредиты использования для окна 1M на этих моделях. Использование Fable само по себе может выставляться в счет кредитов использования на некоторых планах; см. [Fable и кредиты использования](#fable-and-usage-credits).755На Anthropic API Fable 5.1, Fable 5, Sonnet 5 и позже, и Opus 4.7 и позже работают с окном 1M по умолчанию на каждом плане, включая Pro. Вы не выбираете вариант `[1m]` или не включаете кредиты использования для окна 1M на этих моделях. Использование Fable само по себе может выставляться в счет кредитов использования на некоторых планах; см. [Fable и кредиты использования](#fable-and-usage-credits).

712 756

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.757Opus 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 758

742/model claude-opus-4-8[1m]786/model claude-opus-4-8[1m]

743```787```

744 788

745<h4 id="sonnet-5-context-window">789<h4 id="sonnet-5-5-and-sonnet-5-context-window">

746 Окно контекста Sonnet 5790 Окно контекста Sonnet 5.5 и Sonnet 5

747</h4>791</h4>

748 792

749На Anthropic API Sonnet 5 всегда работает с окном контекста 1M. Нет варианта 200K, нет суффикса `[1m]` для выбора и нет требуемых кредитов использования ни на одном плане. Сеансы автоматически компактируются перед заполнением окна, примерно на 967K токенов по умолчанию; установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars), чтобы выбрать другой порог.793На Anthropic API Sonnet 5.5 и Sonnet 5 всегда работают с окном контекста 1M. Нет варианта 200K, нет суффикса `[1m]` для выбора и нет требуемых кредитов использования ни на одном плане. Сеансы автоматически компактируются перед заполнением окна, примерно на 967K токенов по умолчанию; установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars), чтобы выбрать другой порог.

750 794

751Две конфигурации бюджетируют окно на 200K вместо этого:795Две конфигурации бюджетируют окно на 200K вместо этого:

752 796

753* **LLM gateway**: когда `ANTHROPIC_BASE_URL` указывает на [шлюз](/docs/ru/llm-gateway), Claude Code не может проверить поддержку 1M. Чтобы использовать полное окно, выберите Sonnet 5 (1M context) в средстве выбора модели, которое сопоставляется с `sonnet[1m]`.797* **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) для того, как удержание применяется. Полезно для развертываний, которым нужно ограничить контекст.798* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: удерживает сеансы на каждой модели с собственным окном 1M на окне 200K; см. [Расширенный контекст](#extended-context) для того, как удержание применяется. Полезно для развертываний, которым нужно ограничить контекст.

755 799

756<h2 id="context-window-and-auto-compaction">800<h2 id="context-window-and-auto-compaction">

786* [Cloud sessions](/docs/ru/claude-code-on-the-web) выполняют компактирование по мере приближения разговора к пределу модели830* [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 Foundry831* 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, выполняют компактирование на границе 200K832* Когда вы установите [`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)833* Модели, работающие с собственным окном 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)834* Сеансы на 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 835

792<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">836<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">

861| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Модель для использования для `haiku`, или [фоновой функциональности](/docs/ru/costs#background-token-usage) |905| `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) |906| `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 907

908На поставщиках третьих сторон [Настройка отображения и возможностей закрепленной модели](#customize-pinned-model-display-and-capabilities) описывает, что показывает строка закрепленной модели в средстве выбора `/model`.

909

864Примечание: `ANTHROPIC_SMALL_FAST_MODEL` устарел в пользу `ANTHROPIC_DEFAULT_HAIKU_MODEL`.910Примечание: `ANTHROPIC_SMALL_FAST_MODEL` устарел в пользу `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

865 911

866<h3 id="pin-models-for-third-party-deployments">912<h3 id="pin-models-for-third-party-deployments">

995| Переменная окружения | Описание |1041| Переменная окружения | Описание |

996| - | - |1042| - | - |

997| `DISABLE_PROMPT_CACHING` | Установите на `1` для отключения кэширования подсказок для всех моделей. Имеет приоритет над параметрами для каждой модели |1043| `DISABLE_PROMPT_CACHING` | Установите на `1` для отключения кэширования подсказок для всех моделей. Имеет приоритет над параметрами для каждой модели |

998| `DISABLE_PROMPT_CACHING_HAIKU` | Установите на `1` для отключения кэширования подсказок только для моделей Haiku |1044| `DISABLE_PROMPT_CACHING_HAIKU` | Установите на `1` для отключения кэширования подсказок для [модели Haiku по умолчанию](/docs/ru/prompt-caching#disable-prompt-caching) |

1002 1048

1003Чтобы выбрать TTL кэша для основного разговора и для subagents отдельно, см. [выберите TTL самостоятельно](/docs/ru/prompt-caching#choose-the-ttl-yourself). Для того, что вызывает промах кэша, см. [Как Claude Code использует кэширование подсказок](/docs/ru/prompt-caching).1049Чтобы выбрать TTL кэша для основного разговора и для subagents отдельно, см. [выберите TTL самостоятельно](/docs/ru/prompt-caching#choose-the-ttl-yourself). Для того, что вызывает промах кэша, см. [Как Claude Code использует кэширование подсказок](/docs/ru/prompt-caching).

1050

1051<h2 id="version-history">

1052 История версий

1053</h2>

1054

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

1056

1057| Версия | Изменение |

1058| :- | :- |

1059| v2.1.284 | `sonnet` разрешается на Sonnet 5.5 в Anthropic API |

1060| v2.1.280 | `opus` разрешается на Opus 5.5 в Anthropic API, Claude Platform на AWS, Amazon Bedrock и Agent Platform Google Cloud |

1061| v2.1.257 | `fable` разрешается на Fable 5.1, кроме сеансов шлюза приложений Claude |

1062| v2.1.219 | `opus` разрешается на Opus 5 в Anthropic API, Claude Platform на AWS, Amazon Bedrock и Agent Platform |

1063| v2.1.207 | `opus` разрешается на Opus 4.8 в Claude Platform на AWS, Amazon Bedrock и Agent Platform |

1064| v2.1.197 | `sonnet` разрешается на Sonnet 5 в Anthropic API |

1065| v2.1.154 | `opus` разрешается на Opus 4.8 в Anthropic API |

1066| Более ранние | `opus` разрешается на Opus 4.7 в Claude Platform на AWS и на Opus 4.6 в Amazon Bedrock и Agent Platform. `fable` разрешается на Fable 5 у каждого поставщика |

monitoring-usage.md +31 −20

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

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`, и реальные имена агента, skill, plugin и 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-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 запроса и ответа 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` в событии |

294 294

295<span id="tool-output-span-event" />**`tool.output` span event на `claude_code.tool`**295<span id="tool-output-span-event" />**`tool.output` span event на `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

299MCP инструменты, WebFetch и WebSearch также записывают это событие на Claude Code v2.1.283 или позже.

300

299Claude Code записывает это событие из успешного возврата вызова инструмента, поэтому вызов, который вызывает ошибку, не записывает ничего, независимо от инструмента. Среди вызовов, которые действительно возвращаются, он не записывает событие span `tool.output` для:301Claude Code записывает это событие из успешного возврата вызова инструмента, поэтому вызов, который вызывает ошибку, не записывает ничего, независимо от инструмента. Среди вызовов, которые действительно возвращаются, он не записывает событие span `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]` | |

561 564

562Установите `OTEL_METRICS_INCLUDE_REPOSITORY=true`, чтобы пометить метрики и события идентификацией репозитория сеанса, чтобы общий сборщик мог атрибутировать использование по репозиторию. Требуется Claude Code v2.1.269 или позже.565Установите `OTEL_METRICS_INCLUDE_REPOSITORY=true`, чтобы пометить метрики и события идентификацией репозитория сеанса, чтобы общий сборщик мог атрибутировать использование по репозиторию. Требуется Claude Code v2.1.269 или позже.

563 566

564Claude Code получает эти атрибуты один раз за сеанс из удалённого хранилища `origin` репозитория. HTTPS и SSH удалённые хранилища одного репозитория создают идентичные значения:567Claude Code получает эти атрибуты один раз за сеанс из удалённого хранилища `origin` репозитория. Когда HTTPS и SSH удалённые хранилища одного репозитория называют один и тот же хост и один и тот же путь, как они делают на GitHub, GitLab и Bitbucket Cloud, оба создают идентичные значения:

565 568

566| Атрибут | Значение |569| Атрибут | Значение |

567| - | - |570| - | - |

572 575

573Значения приводятся в нижний регистр, и учётные данные, строки запроса и фрагменты из URL удалённого хранилища никогда не отображаются в них. Атрибуты опускаются, когда сеанс не имеет удалённого хранилища `origin`, когда удалённое хранилище не имеет формы URL или когда единственный охватывающий репозиторий — это ваш домашний каталог.576Значения приводятся в нижний регистр, и учётные данные, строки запроса и фрагменты из URL удалённого хранилища никогда не отображаются в них. Атрибуты опускаются, когда сеанс не имеет удалённого хранилища `origin`, когда удалённое хранилище не имеет формы URL или когда единственный охватывающий репозиторий — это ваш домашний каталог.

574 577

578Чтобы получить эти атрибуты из [облачного сеанса](/docs/ru/claude-code-on-the-web), установите переменные телеметрии, включая `OTEL_METRICS_INCLUDE_REPOSITORY`, в его [облачной среде](/docs/ru/cloud-environments#set-environment-variables). Также разрешите домен вашего сборщика в [сетевом доступе](/docs/ru/cloud-environments#network-access) среды.

579

575Ключ `vcs.*`, который вы объявляете в [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support), заменяет полученное значение для этого ключа. Если вы объявляете `vcs.repository.url.full`, Claude Code никогда не читает удалённое хранилище и сообщает только объявленные вами ключи.580Ключ `vcs.*`, который вы объявляете в [`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support), заменяет полученное значение для этого ключа. Если вы объявляете `vcs.repository.url.full`, Claude Code никогда не читает удалённое хранилище и сообщает только объявленные вами ключи.

576 581

582Если HTTPS и SSH клоны одного репозитория сообщают разные значения, например на самостоятельно размещённой установке, чей URL клона HTTPS содержит префикс пути, который отсутствует в URL SSH, объявите `vcs.repository.url.full` в `OTEL_RESOURCE_ATTRIBUTES` вместе с каждым другим ключом `vcs.*`, который вы хотите сообщить. Каждый клон затем сообщает идентификацию, которую вы объявляете.

583

577Атрибуты передаются только вашим собственным экспортёрам; телеметрия Anthropic отбрасывает каждый ключ `vcs.*`.584Атрибуты передаются только вашим собственным экспортёрам; телеметрия Anthropic отбрасывает каждый ключ `vcs.*`.

578 585

579<h3 id="metrics">586<h3 id="metrics">

650 657

651Увеличивается после каждого запроса API.658Увеличивается после каждого запроса API.

652 659

660Атрибуты `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`.

661

653**Атрибуты**:662**Атрибуты**:

654 663

655* Все [стандартные атрибуты](#standard-attributes)664* Все [стандартные атрибуты](#standard-attributes)

657* `query_source`: Категория подсистемы, которая выдала запрос. Один из `"main"`, `"subagent"` или `"auxiliary"`666* `query_source`: Категория подсистемы, которая выдала запрос. Один из `"main"`, `"subagent"` или `"auxiliary"`

658* `speed`: `"fast"`, когда запрос использовал быстрый режим. Отсутствует в противном случае667* `speed`: `"fast"`, когда запрос использовал быстрый режим. Отсутствует в противном случае

659* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия.668* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применённый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия.

660* `agent.name`: Тип подагента, который выдал запрос. Встроенные имена агентов и агенты из официальных плагинов маркетплейса отображаются как есть. Другие определённые пользователем имена агентов заменяются на `"custom"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`. Отсутствует, когда запрос не был выдан именованным типом подагента.669* `agent.name`: Тип подагента, который выдал запрос. Встроенные имена агентов и агенты из официальных плагинов маркетплейса отображаются как есть. Другие определённые пользователем имена агентов заменяются на `"custom"`. Отсутствует, когда запрос не был выдан именованным типом подагента.

661* `skill.name`: Навык, активный для запроса, установленный инструментом Skill, командой `/` или унаследованный порождённым подагентом. Встроенные, связанные, определённые пользователем и имена навыков плагинов официального маркетплейса отображаются как есть. Имена навыков плагинов третьих сторон заменяются на `"third-party"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`. Отсутствует, когда нет активного навыка.670* `skill.name`: Навык, активный для запроса, установленный инструментом Skill, командой `/` или унаследованный порождённым подагентом. Встроенные, связанные, определённые пользователем и имена навыков плагинов официального маркетплейса отображаются как есть. Имена навыков плагинов третьих сторон заменяются на `"third-party"`. Отсутствует, когда нет активного навыка.

662* `plugin.name`: Владеющий плагин, когда активный навык или подагент предоставляется плагином. Имена плагинов официального маркетплейса отображаются как есть. Имена плагинов третьих сторон заменяются на `"third-party"`, если не установлено `OTEL_LOG_TOOL_DETAILS=1`. Отсутствует, когда ни навык, ни подагент не имеют владеющего плагина.671* `plugin.name`: Владеющий плагин, когда активный навык или подагент предоставляется плагином. Имена плагинов официального маркетплейса отображаются как есть. Имена плагинов третьих сторон заменяются на `"third-party"`. Отсутствует, когда ни навык, ни подагент не имеют владеющего плагина.

663* `marketplace.name`: Маркетплейс, из которого был установлен владеющий плагин. Выпускается только для плагинов официального маркетплейса. Отсутствует в противном случае.672* `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, а не только на запросы, которые потребили результат инструмента, поэтому панели управления, которые его агрегируют, показывают снижение после обновления.673* `mcp_server.name`: Сервер MCP, результат инструмента которого этот запрос потребил. Встроенные, проксируемые claude.ai и имена серверов официального реестра отображаются как есть. Имена серверов, настроенные пользователем, заменяются на `"custom"`. Отсутствует, когда запрос не потребил результат инструмента MCP. До v2.1.222 Claude Code устанавливал этот атрибут на каждый запрос после вызова инструмента MCP, а не только на запросы, которые потребили результат инструмента, поэтому панели управления, которые его агрегируют, показывают снижение после обновления.

665* `mcp_tool.name`: Инструмент MCP, результат которого этот запрос потребил, с тем же редактированием и поведением версии, что и `mcp_server.name`. Отсутствует, когда запрос не потребил результат инструмента MCP.674* `mcp_tool.name`: Инструмент MCP, результат которого этот запрос потребил, с тем же редактированием и поведением версии, что и `mcp_server.name`. Отсутствует, когда запрос не потребил результат инструмента MCP.

666 675

667<h4 id="token-counter">676<h4 id="token-counter">

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

734| `request_id` | ID запроса, назначенный сервером, прочитанный из заголовка ответа `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 или позже |

725| `client_request_id` | UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`. Присутствует на `api_request` и `api_error` на подключениях API первой стороны; отсутствует на бэкендах поставщиков третьих сторон и когда запрос был повторён через резервный вариант без потоковой передачи. Связывает запрос с его ответом и остаётся доступным для сбоев, таких как тайм-ауты, которые никогда не создали `request_id` сервера. Совпадает с тем же атрибутом на диапазоне трассировки `llm_request`. Требуется Claude Code v2.1.214 или позже |735| `client_request_id` | UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`. Присутствует на `api_request` и `api_error` на подключениях API первой стороны; отсутствует на бэкендах поставщиков третьих сторон и когда запрос был повторён через резервный вариант без потоковой передачи. Связывает запрос с его ответом и остаётся доступным для сбоев, таких как тайм-ауты, которые никогда не создали `request_id` сервера. Совпадает с тем же атрибутом на диапазоне трассировки `llm_request`. Требуется Claude Code v2.1.214 или позже |

726 736

727Чтобы отследить всю деятельность, вызванную одним запросом, отфильтруйте события по определённому значению `prompt.id`. Это возвращает событие user\_prompt, любые события api\_request и любые события tool\_result, которые произошли при обработке этого запроса.737Чтобы отследить всю деятельность, вызванную одним запросом, отфильтруйте события по определённому значению `prompt.id`. Это возвращает событие user\_prompt, любые события api\_request и любые события tool\_result, которые произошли при обработке этого запроса.

771* `response_length`: Длина текста ответа в символах781* `response_length`: Длина текста ответа в символах

772* `response`: Текст ответа, усечённый на пределе содержания (60 КБ по умолчанию). Редактируется в `<REDACTED>` по умолчанию. Установите `OTEL_LOG_ASSISTANT_RESPONSES=1`, чтобы включить его. Когда `OTEL_LOG_ASSISTANT_RESPONSES` не установлен, `OTEL_LOG_USER_PROMPTS` контролирует его вместо этого, поэтому установите `OTEL_LOG_ASSISTANT_RESPONSES=0`, чтобы сохранить ответы редактируемыми, пока логирование запроса включено782* `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")783* `model`: Идентификатор модели (например, "claude-sonnet-5")

774* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`. Присутствует только, когда API возвращает один784* `request_id`: ID запроса API, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

775* `message.uuid`: UUID последней записи стенограммы ответа. Ответ API сохраняется как одна запись стенограммы на блок содержания; это последний, от которого цепочка `parentUuid` следующего хода. Требуется Claude Code v2.1.214 или позже785* `message.uuid`: UUID последней записи стенограммы ответа. Ответ API сохраняется как одна запись стенограммы на блок содержания; это последний, от которого цепочка `parentUuid` следующего хода. Требуется Claude Code v2.1.214 или позже

776* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента786* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента

777 787

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

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

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

834* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`, например `"req_011..."`. Присутствует только, когда API возвращает один.844* `request_id`: ID запроса API, описанный в [Атрибуты корреляции событий](#event-correlation-attributes).

835* `client_request_id`: UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`; см. таблицу [атрибуты корреляции событий](#event-correlation-attributes) для того, когда он присутствует. Требуется Claude Code v2.1.214 или позже845* `client_request_id`: UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`; см. таблицу [атрибуты корреляции событий](#event-correlation-attributes) для того, когда он присутствует. Требуется Claude Code v2.1.214 или позже

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

837* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента847* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента

857* `status_code`: Код состояния HTTP как число. Отсутствует для ошибок, не связанных с HTTP, таких как сбои соединения.867* `status_code`: Код состояния HTTP как число. Отсутствует для ошибок, не связанных с HTTP, таких как сбои соединения.

858* `duration_ms`: Длительность запроса в миллисекундах868* `duration_ms`: Длительность запроса в миллисекундах

859* `attempt`: Общее количество попыток, включая исходный запрос (`1` означает, что повторных попыток не было)869* `attempt`: Общее количество попыток, включая исходный запрос (`1` означает, что повторных попыток не было)

860* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`, например `"req_011..."`. Присутствует только, когда API возвращает один.870* `request_id`: ID запроса API, описанный в [Атрибуты корреляции событий](#event-correlation-attributes).

861* `client_request_id`: UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`. Доступен даже при сбое, таком как тайм-аут или ошибка соединения, которые никогда не создали `request_id` сервера; см. таблицу [атрибуты корреляции событий](#event-correlation-attributes) для того, когда он присутствует. Требуется Claude Code v2.1.214 или позже871* `client_request_id`: UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`. Доступен даже при сбое, таком как тайм-аут или ошибка соединения, которые никогда не создали `request_id` сервера; см. таблицу [атрибуты корреляции событий](#event-correlation-attributes) для того, когда он присутствует. Требуется Claude Code v2.1.214 или позже

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

863* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента873* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента

879* `event.timestamp`: Временная метка ISO 8601889* `event.timestamp`: Временная метка ISO 8601

880* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)890* `event.sequence`: счётчик на процесс для упорядочивания событий, описанный в [Атрибуты корреляции событий](#event-correlation-attributes)

881* `model`: Идентификатор модели из запроса891* `model`: Идентификатор модели из запроса

882* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`, например `"req_011..."`. Присутствует только, когда API возвращает один.892* `request_id`: ID запроса API, описанный в [Атрибуты корреляции событий](#event-correlation-attributes).

883* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента. См. [`api_request`](#api-request-event) для определений.893* `query_source`: Подсистема, которая выдала запрос, например `"repl_main_thread"`, `"compact"` или имя подагента. См. [`api_request`](#api-request-event) для определений.

884* `speed`: Либо `"fast"`, когда активен [Быстрый режим](/docs/ru/fast-mode), либо `"normal"`894* `speed`: Либо `"fast"`, когда активен [Быстрый режим](/docs/ru/fast-mode), либо `"normal"`

885* `attempt`: Номер попытки повтора. Первая попытка — это `1`.895* `attempt`: Номер попытки повтора. Первая попытка — это `1`.

934* `body_truncated`: `"true"`, когда произошло встроенное усечение. Отсутствует в режиме файла и когда усечение не произошло.944* `body_truncated`: `"true"`, когда произошло встроенное усечение. Отсутствует в режиме файла и когда усечение не произошло.

935* `model`: Идентификатор модели945* `model`: Идентификатор модели

936* `query_source`: Подсистема, которая выдала запрос946* `query_source`: Подсистема, которая выдала запрос

937* `request_id`: ID запроса API Anthropic из заголовка ответа `request-id`, например `"req_011..."`. Присутствует только, когда API возвращает один.947* `request_id`: ID запроса API, описанный в [Атрибуты корреляции событий](#event-correlation-attributes).

938* `request_body_id`: `request_body_id` события [`api_request_body`](#api-request-body-event), на которое этот ответ отвечает. Требуется Claude Code v2.1.274 или позже948* `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 или позже949* `message.id`: ID сообщения, назначенный API ответу, поле `id` тела ответа. Требуется Claude Code v2.1.274 или позже

940* `message.uuid`: UUID последней записи стенограммы ответа. Вместе с `request_body_id` он связывает сообщение стенограммы с телами запроса и ответа позади него. Требуется Claude Code v2.1.274 или позже950* `message.uuid`: UUID последней записи стенограммы ответа. Вместе с `request_body_id` он связывает сообщение стенограммы с телами запроса и ответа позади него. Требуется Claude Code v2.1.274 или позже

1563}1573}

1564```1574```

1565 1575

1566Чтобы подтвердить, что события прибыли, отправьте подсказку в сеансе, работающем под этой конфигурацией, и проверьте ваш SIEM на событие `claude_code.user_prompt`. Если ничего не прибыло, запустите `claude --debug` и проверьте журнал отладки на ошибки экспорта `[3P telemetry]`.1576Чтобы подтвердить, что события прибыли, отправьте подсказку в сеансе, работающем под этой конфигурацией, и проверьте ваш SIEM на событие `claude_code.user_prompt`. Если ничего не прибыло, запустите Claude Code с `claude --debug-file <path>` и проверьте этот журнал на ошибки экспорта `[3P telemetry]`.

1567 1577

1568<h2 id="backend-considerations">1578<h2 id="backend-considerations">

1569 Рассмотрения бэкенда1579 Рассмотрения бэкенда

1633 * События `tool_result` и `tool_decision` включают атрибут `tool_parameters` с командами Bash, именами MCP сервера и инструмента и именами навыков. Поля, такие как `full_command`, выдаются неусеченными1643 * События `tool_result` и `tool_decision` включают атрибут `tool_parameters` с командами Bash, именами MCP сервера и инструмента и именами навыков. Поля, такие как `full_command`, выдаются неусеченными

1634 * События `tool_result` дополнительно включают атрибут `tool_input` с путями к файлам, URL-адресами, шаблонами поиска и другими аргументами. Отдельные значения более 512 символов усекаются, и общее количество ограничено примерно 4 K символами1644 * События `tool_result` дополнительно включают атрибут `tool_input` с путями к файлам, URL-адресами, шаблонами поиска и другими аргументами. Отдельные значения более 512 символов усекаются, и общее количество ограничено примерно 4 K символами

1635 * События `user_prompt` включают буквальное `command_name` для пользовательских, плагин и MCP команд1645 * События `user_prompt` включают буквальное `command_name` для пользовательских, плагин и MCP команд

1646 * [Счётчики стоимости и токенов](#cost-counter) и события `api_request`, `api_error` и `api_refusal` содержат реальные имена агента, навыка, плагина и MCP сервера и инструмента в их атрибутах атрибуции

1636 * Span трассировки включают тот же атрибут `tool_input` и атрибуты, полученные из входных данных, такие как `file_path`, с тем же усечением, что и `tool_input`1647 * 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). Настройте ваш бэкенд телеметрии для фильтрации или редактирования этих атрибутов по мере необходимости1648* Содержимое инструмента не логируется в 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 доставляет тела:1649* Тела запроса и ответа 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 КБ по умолчанию)1650 * С `=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, а не через поток телеметрии.1651 * С `=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 +77 −39

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, раскрывающееся меню показывает режим разрешений, в котором находится локальный сеанс, включая режим, установленный из терминала. Оно обновляется, когда режим разрешений изменяется в приложении или в терминале. Сеанс никогда не сообщает Bypass permissions в claude.ai, поэтому переключение на него из терминала не изменяет то, что показывает раскрывающееся меню.

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

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 Границы, которые вы указываете в разговоре

497 Каждое действие проходит через фиксированный порядок решений. Первый соответствующий шаг побеждает:502 Каждое действие проходит через фиксированный порядок решений. Первый соответствующий шаг побеждает:

498 503

499 1. Действия, соответствующие вашим [правилам разрешения, запроса или отказа](/docs/ru/permissions#manage-permissions), разрешаются немедленно, с этими исключениями:504 1. Действия, соответствующие вашим [правилам разрешения, запроса или отказа](/docs/ru/permissions#manage-permissions), разрешаются немедленно, с этими исключениями:

500 * Записи в [защищенные пути](#protected-paths) маршрутизируются к классификатору, даже когда правило разрешения соответствует, и так же `rm` и `rmdir` удаления, нацеленные на [критический путь](#critical-paths) в Claude Code v2.1.218 и более поздних версиях505 * Записи в [защищенные пути](#protected-paths) маршрутизируются к классификатору, даже когда правило разрешения соответствует

501 * MCP инструменты, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), спрашивают вас напрямую, даже когда правило разрешения соответствует, и так же инструменты connector, которые ваша организация установила на `ask`]\(/ru/mcp#organization-controls-on-connector-tools) в сеансах, где эта параметр достигает Claude Code506 * Нет правила разрешения, которое одобряет удаления `rm` и `rmdir`, нацеленные на [критический путь](#critical-paths)

507 * 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), также маршрутизируется к классификатору, даже когда правило разрешения соответствует, потому что правило одобряет команду, а не ее хосты508 * Команда оболочки, которая несет [разрешенные домены для каждой команды](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode), также маршрутизируется к классификатору, даже когда правило разрешения соответствует, потому что правило одобряет команду, а не ее хосты

503 * Правила запроса, которые соответствуют содержимому команды, такие как `Bash(git push *)`, возвращаются к запросу разрешения509 * Правила запроса, которые соответствуют содержимому команды, такие как `Bash(git push *)`, возвращаются к запросу разрешения

510 * Запись, которую [проверка symlink](/docs/ru/permissions#symlinks) разрешает на защищенный путь, спрашивает вас, когда путь, который запросил Claude, сам не защищен

504 2. Действия только для чтения и редактирование файлов в вашем рабочем каталоге автоматически одобряются, кроме записей в [защищенные пути](#protected-paths) и [первое чтение вне рабочих каталогов](#first-read-outside-the-working-directories), которое вас спрашивает511 2. Действия только для чтения и редактирование файлов в вашем рабочем каталоге автоматически одобряются, кроме записей в [защищенные пути](#protected-paths) и [первое чтение вне рабочих каталогов](#first-read-outside-the-working-directories), которое вас спрашивает

505 * В сеансе с [проверкой классификатора на стороне сервера](#server-side-classifier-review), действия только для чтения и [команды оболочки в песочнице](/docs/ru/sandboxing#sandbox-modes) ждут эту проверку и блокируются, если она их отмечает512 * В сеансе с [проверкой классификатора на стороне сервера](#server-side-classifier-review), действия только для чтения и [команды оболочки в песочнице](/docs/ru/sandboxing#sandbox-modes) ждут эту проверку и блокируются, если она их отмечает

506 3. Все остальное идет к классификатору. Инструменты connector и MCP инструменты `requiresUserInteraction`, которые спрашивают вас напрямую на шаге 1, никогда не достигают классификатора, поэтому ни одобрение, требуемое организацией, ни шаг согласия не автоматически одобряются513 * Запись внутри вашего рабочего каталога, которую [проверка symlink](/docs/ru/permissions#symlinks) разрешает на местоположение вне него, спрашивает вас

514 3. Все остальное идет к классификатору, кроме [удаления критических путей](#critical-paths) при их обработке по умолчанию. Инструменты connector и `requiresUserInteraction` MCP инструменты, которые спрашивают вас напрямую на шаге 1, никогда не достигают классификатора, поэтому ни одобрение, требуемое организацией, ни шаг согласия не автоматически одобряются

507 4. Если классификатор блокирует, Claude получает причину и пытается альтернативу. В большинстве сеансов причина называет правило, которое классификатор совпал, такое как `[Data Exfiltration]`, вместо того чтобы давать письменное объяснение; смотрите [Проверка отказов](/docs/ru/auto-mode-config#review-denials)515 4. Если классификатор блокирует, Claude получает причину и пытается альтернативу. В большинстве сеансов причина называет правило, которое классификатор совпал, такое как `[Data Exfiltration]`, вместо того чтобы давать письменное объяснение; смотрите [Проверка отказов](/docs/ru/auto-mode-config#review-denials)

508 516

509 При входе в автоматический режим широкие правила разрешения, которые предоставляют произвольное выполнение кода, отбрасываются:517 При входе в автоматический режим широкие правила разрешения, которые предоставляют произвольное выполнение кода, отбрасываются:

568 576

569Режим `bypassPermissions` отключает запросы разрешений и проверки безопасности, чтобы вызовы инструментов выполнялись немедленно, включая записи в [защищённые пути](#protected-paths).577Режим `bypassPermissions` отключает запросы разрешений и проверки безопасности, чтобы вызовы инструментов выполнялись немедленно, включая записи в [защищённые пути](#protected-paths).

570 578

571[Действия, которые ни один режим не одобряет](#actions-no-mode-auto-approves) по-прежнему требуют запроса в этом режиме.579[Действия, которые ни один режим не одобряет](#actions-no-mode-auto-approves) по-прежнему требуют запроса в этом режиме. [Удаление Remove-Item в PowerShell](#remove-item-in-powershell) также применяется в этом режиме.

572 580

573Две [гарантии обмена сообщениями между сеансами](/docs/ru/cross-session-messaging) по-прежнему применяются в этом режиме, и в интерактивных сеансах режима plan, где доступны разрешения на обход:581Две [гарантии обмена сообщениями между сеансами](/docs/ru/cross-session-messaging) по-прежнему применяются в этом режиме, и в интерактивных сеансах режима plan, где доступны разрешения на обход:

574 582

625 633

626В сеансе, запущенном с [`--restricted`](/docs/ru/cli-reference#cli-flags), который требует Claude Code v2.1.248 или позже, классификатор не может одобрить записи в защищённые пути.634В сеансе, запущенном с [`--restricted`](/docs/ru/cli-reference#cli-flags), который требует Claude Code v2.1.248 или позже, классификатор не может одобрить записи в защищённые пути.

627 635

628Правила [`permissions.allow`](/docs/ru/permissions#manage-permissions) в файлах параметров не предварительно одобряют записи в защищённые пути. Проверка безопасности выполняется до того, как Claude Code оценивает правила allow из параметров, поэтому запись вроде `Edit(.claude/**)` в `~/.claude/settings.json` или `.claude/settings.json` не изменяет результат для каждого режима в таблице выше. В режимах, которые требуют подтверждения, запрос для записи `.claude/` предлагает **Да, и разрешить Claude редактировать свои собственные параметры для этого сеанса**, что одобряет более поздние записи `.claude/` в этом сеансе без повторного запроса.636В режимах, которые маршрутизируют записи в защищённые пути классификатору, запись, которую [проверка символических ссылок](/docs/ru/permissions#symlinks) разрешает в защищённый путь, требует вашего подтверждения вместо этого, когда путь, который запросил Claude, сам по себе не защищён.

637

638Правила [`permissions.allow`](/docs/ru/permissions#manage-permissions) в файлах параметров не предварительно одобряют записи в защищённые пути. Проверка безопасности выполняется до того, как Claude Code оценивает правила allow из параметров, поэтому запись вроде `Edit(.claude/**)` в `~/.claude/settings.json` или `.claude/settings.json` не изменяет результат для каждого режима в таблице выше. В режимах, которые требуют подтверждения, запрос для записи в папку `.claude/` проекта или в `~/.claude/` может предложить один из этих вариантов, ограниченных сеансом:

639

640* Для папки `.claude/` проекта: **Да, и разрешить Claude редактировать файлы в папке .claude этого проекта для этого сеанса**

641* Для `~/.claude/`: **Да, и разрешить Claude редактировать файлы в своей папке \~/.claude для этого сеанса**

629 642

630Защищённые каталоги:643Защищённые каталоги:

631 644

663| Режим | Что Claude Code делает с удалением критического пути |676| Режим | Что Claude Code делает с удалением критического пути |

664| :- | :- |677| :- | :- |

666| `plan` | Спрашивает вас одобрить его. С [доступным режимом auto во время планирования](#analyze-before-you-edit-with-plan-mode) и без доступных разрешений на обход, отправляет его классификатору вместо этого |679| `plan` | Спрашивает вас одобрить его. Когда [классификатор проверяет команды во время планирования](#analyze-before-you-edit-with-plan-mode) и нет доступных разрешений на обход, обрабатывает это как в режиме `auto` |

683

684Если явное [правило ask](/docs/ru/permissions#manage-permissions) совпадает с командой, Claude Code спрашивает вас вместо этого, даже в режиме `auto` и без ограничения по времени. В режимах, которые спрашивают, hook [`PermissionRequest`](/docs/ru/hooks#permissionrequest) может ответить на запрос.

685

686Обработка `auto` и `bypassPermissions` требует Claude Code v2.1.281 или позже. Чтобы отключить это, установите [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1`](/docs/ru/env-vars#variables) в окружении, которое запускает Claude Code. В режиме `auto` удаления критических путей затем переходят к классификатору, а в режиме `bypassPermissions` запрос не имеет ограничения по времени.

670 687

671Если явное [правило ask](/docs/ru/permissions#manage-permissions) совпадает с командой, Claude Code спрашивает вас даже в режиме `auto`. В режимах, которые спрашивают, hook [`PermissionRequest`](/docs/ru/hooks#permissionrequest) может ответить на запрос так же, как он отвечает на любой другой.688В режимах `auto` и `bypassPermissions` запрос в терминале показывает обратный отсчёт в две минуты:

689

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

691* Нажмите любую клавишу, пока запрос открыт, чтобы остановить обратный отсчёт и оставить запрос в ожидании вашего ответа.

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

693

694В режиме `auto`, везде, где Claude Code не может показать вам запрос в терминале, он немедленно отклоняет команду, например в [неинтерактивных запусках](/docs/ru/headless) с `-p`, в сеансах [Agent SDK](/docs/ru/agent-sdk/permissions) и в панели чата расширения VS Code и приложении Desktop. Отклонение говорит Claude сообщить, что он хотел удалить, и оставить удаление вам.

672 695

673Claude Code рассматривает цель `rm` или `rmdir` как критический путь, когда это любое из следующего:696Claude Code рассматривает цель `rm` или `rmdir` как критический путь, когда это любое из следующего:

674 697

681 704

682Claude Code также рассматривает glob или косую черту непосредственно под переменной оболочки, такую как `rm -rf "$DIR"/*`, как удаление критического пути, потому что команда становится удалением из корня файловой системы, когда переменная пуста.705Claude Code также рассматривает glob или косую черту непосредственно под переменной оболочки, такую как `rm -rf "$DIR"/*`, как удаление критического пути, потому что команда становится удалением из корня файловой системы, когда переменная пуста.

683 706

684Подсказка для этого случая переменной называет помеченную команду `rm` и говорит, как переписать её, чтобы проверка прошла:707Запрос для этого случая переменной называет помеченную команду `rm` и говорит, как переписать её, чтобы проверка прошла:

685 708

686* Для переменной, такой как `$DIR`, защитите каждое расширение так, чтобы оболочка остановилась с ошибкой, когда переменная не установлена или пуста, как в `rm -rf "${DIR:?}"/*`, или используйте буквальный путь709* Для переменной, такой как `$DIR`, защитите каждое расширение так, чтобы оболочка остановилась с ошибкой, когда переменная не установлена или пуста, как в `rm -rf "${DIR:?}"/*`, или используйте буквальный путь

687* Для переменной, которая обычно установлена, такой как `$HOME`, используйте буквальный путь710* Для переменной, которая обычно установлена, такой как `$HOME`, используйте буквальный путь

688 711

689Удаление, чьи расширения защищены таким образом, не является удалением критического пути, поэтому в режиме `bypassPermissions` оно выполняется без подсказки.712Удаление, чьи расширения защищены таким образом, проходит эту проверку, поэтому в режиме `bypassPermissions` оно выполняется без запроса, если другая проверка в этом разделе не помечает его.

713

714Claude Code также рассматривает эти цели как критические пути:

715

716* **Переменная оболочки, за которой следует одно имя каталога верхнего уровня**, такая как `rm -rf "$TMPDIR/mnt"`: когда переменная расширяется пусто, команда удаляет `/mnt`. Это охватывает общие имена верхнего уровня, такие как `mnt`, `tmp`, `usr` и `Users`.

717* **Переменная, которую та же команда присваивает из подстановки, выводящей каталог**, такая как `D=$(pwd); rm -rf "$D"` или присваивание из `$(git rev-parse --show-toplevel)`: значение может называть ваш рабочий каталог или корень репозитория. Защита `"${D:?}"` не очищает эту проверку, потому что переменная не пуста; используйте вместо этого буквальный путь.

718* **Цель только с обратной косой чертой**, такая как `rm -rf "\\"`: Git Bash на Windows читает одну обратную косую черту как корень текущего диска, поэтому проверка применяется на каждой платформе.

719* **Только вывод подстановки команды**, такая как `rm -rf "$(pwd)"`, когда `rm` рекурсивна: Claude Code не может проверить цель перед запуском команды, поэтому запрос говорит Claude запустить подстановку самостоятельно сначала, а затем удалить буквальные пути, которые она выводит. Чтобы отключить эту проверку, установите [`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1`](/docs/ru/env-vars#variables) в окружении, которое запускает Claude Code.

690 720

691Скрытие удаления внутри подстановки с `(...)`, группы в фигурных скобках с `{ ...; }`, подстановки команд с `$(...)` или обратными кавычками, или подстановки процесса с `<(...)`, не пропускает проверку. Claude Code находит удаление критического пути, находится ли оно внутри вложенной формы, как в `(rm -rf ~)` или `echo "$(rm -rf ~)"`, или в другом месте той же команды.721Когда завершающая подстановка команды может расширяться пусто, как в `rm -rf ~/$(cmd)`, Claude Code проверяет путь, который остался бы, ваш домашний каталог в этом примере.

722

723Скрытие удаления внутри подоболочки с `(...)`, группы в фигурных скобках с `{ ...; }`, подстановки команд с `$(...)` или обратными кавычками, или подстановки процесса с `<(...)`, не пропускает проверку. Claude Code находит удаление критического пути, находится ли оно внутри вложенной формы, как в `(rm -rf ~)` или `echo "$(rm -rf ~)"`, или в другом месте той же команды.

692 724

693<h3 id="remove-item-in-powershell">725<h3 id="remove-item-in-powershell">

694 Remove-Item в PowerShell726 Remove-Item в PowerShell

695</h3>727</h3>

696 728

697Когда вы включаете инструмент [PowerShell](/docs/ru/tools-reference#powershell-tool), Claude Code даёт `Remove-Item` свою собственную проверку, отдельную от списка критических путей `rm`. Результат зависит от цели, и первый совпадающий случай применяется:729Когда вы включаете инструмент [PowerShell](/docs/ru/tools-reference#powershell-tool), Claude Code даёт `Remove-Item` и встроенные команды `cmd` `rd`, `rmdir`, `del` и `erase` свои собственные проверки, отдельные от списка критических путей `rm`. Для `Remove-Item` результат зависит от цели, и первый совпадающий случай применяется:

698 730

699* **Системные пути**: корневой каталог файловой системы и его каталоги верхнего уровня, корни дисков и их каталоги верхнего уровня, и ваш домашний каталог. Claude Code отклоняет команду в каждом режиме, без запроса у вас.731* **Системные пути**: корневой каталог файловой системы и его каталоги верхнего уровня, корни дисков и их каталоги верхнего уровня, и ваш домашний каталог. Claude Code отклоняет команду в каждом режиме, без запроса у вас.

700* **Подстановочные знаки**: голый `*` или любая цель, заканчивающаяся на `/*` или `\*`, включая glob под переменной оболочки, такой как `$dir/*`. Claude Code отклоняет команду в каждом режиме, без запроса у вас, перед тем как [классификатор](#eliminate-prompts-with-auto-mode) её видит.732* **Подстановочные знаки**: голый `*` или любая цель, заканчивающаяся на `/*` или `\*`, включая glob под переменной оболочки, такой как `$dir/*`. Claude Code отклоняет команду в каждом режиме, без запроса у вас, перед тем как [классификатор](#eliminate-prompts-with-auto-mode) её видит.

701* **Ваш рабочий каталог или один из его родителей, с `-Recurse`**: Claude Code рассматривает команду как любую другую, которая требует одобрения в вашем режиме разрешений, поэтому он спрашивает вас в режимах, которые спрашивают, отправляет её классификатору в режиме `auto` и отклоняет её в режиме `dontAsk`. Режим `bypassPermissions` пропускает эту проверку.733* **Ваш рабочий каталог или один из его родителей, с `-Recurse`**: Claude Code рассматривает команду как любую другую, которая требует одобрения в вашем режиме разрешений, поэтому он спрашивает вас в режимах, которые спрашивают, отправляет её классификатору в режиме `auto` и отклоняет её в режиме `dontAsk`. Режим `bypassPermissions` пропускает эту проверку.

702 734

735Случай системных путей также применяется к `rd`, `rmdir`, `del` и `erase`, когда Claude запускает их через `cmd`, как в `cmd /c rd /s /q C:\Users`. По умолчанию Claude Code отклоняет такую команду в каждом режиме, без запроса у вас. Эта проверка `cmd` требует Claude Code v2.1.283 или позже.

736

737При оценке цели `cmd` Claude Code рассматривает переменную PowerShell, которая следует за буквальным текстом, как пустую. Это делает `cmd /c rd /s /q "C:\$name"` удалением `C:\`, поэтому она также отклоняется. Завершающий подстановочный знак считается папкой, которую он очищает, поэтому `cmd /c del /q C:\*` отклоняется, а `cmd /c del /q dist\*` в вашем проекте — нет.

738

739Чтобы отключить проверку `cmd`, установите [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY=1`](/docs/ru/env-vars#variables) в окружении, которое запускает Claude Code. Claude Code игнорирует эту переменную в блоке `env` файла параметров. `Remove-Item` на системном пути остаётся отклонённым в любом случае.

740

703<h2 id="see-also">741<h2 id="see-also">

704 См. также742 См. также

705</h2>743</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 +17 −2

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

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>

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/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 +157 −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 | `-d`, `--debug[=<filter>]` | Включите отладочное логирование для сервера, опционально отфильтрованное по категориям. Передайте фильтр только в форме `=`, например `--debug=api,hooks`. Требуется Claude Code v2.1.282 или позже; более ранние версии отклоняют флаг как неизвестный аргумент. |

70 | `--sandbox` / `--no-sandbox` | Включите или отключите [изоляцию](/docs/ru/sandboxing) для изоляции файловой системы и сети. По умолчанию отключено. |

74 71

75 Передавайте эти флаги после `remote-control`.72 Передавайте эти флаги после `remote-control`.

76 73

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`.74 Если вы передадите глобальный флаг `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 75

79 Claude Code проверяет право на использование Remote Control перед выводом справки, поэтому `claude remote-control --help` возвращает ошибку вместо этого списка флагов, когда вы не вошли с подходящей учётной записью.76 Claude Code проверяет право на использование Remote Control перед выводом справки, поэтому `claude remote-control --help` возвращает ошибку вместо этого списка флагов, когда вы не вошли с подходящей учетной записью.

80 </Tab>77 </Tab>

81 78

82 <Tab title="Интерактивный сеанс">79 <Tab title="Интерактивный сеанс">

83 Чтобы запустить обычный интерактивный сеанс Claude Code с включённым Remote Control, используйте флаг `--remote-control` (или `--rc`):80 Чтобы запустить обычный интерактивный сеанс Claude Code с включенным Remote Control, используйте флаг `--remote-control` (или `--rc`):

84 81

85 ```bash theme={null}82 ```bash theme={null}

86 claude --remote-control83 claude --remote-control

92 claude --remote-control "My Project"89 claude --remote-control "My Project"

93 ```90 ```

94 91

95 Это даёт вам полный интерактивный сеанс в вашем терминале, который вы также можете контролировать из claude.ai или приложения Claude. В отличие от `claude remote-control` (режим сервера), вы можете вводить сообщения локально, пока сеанс также доступен удалённо.92 Это дает вам полный интерактивный сеанс в вашем терминале, который вы также можете контролировать с claude.ai или приложения Claude. В отличие от `claude remote-control` (режим сервера), вы можете вводить сообщения локально, пока сеанс также доступен удаленно.

96 </Tab>93 </Tab>

97 94

98 <Tab title="Из существующего сеанса">95 <Tab title="Из существующего сеанса">

99 Если вы уже находитесь в сеансе Claude Code и хотите продолжить его удалённо, используйте команду `/remote-control` (или `/rc`):96 Если вы уже находитесь в сеансе Claude Code и хотите продолжить его удаленно, используйте команду `/remote-control` (или `/rc`):

100 97

101 ```text theme={null}98 ```text theme={null}

102 /remote-control99 /remote-control

108 /remote-control My Project105 /remote-control My Project

109 ```106 ```

110 107

111 Это запускает сеанс Remote Control, который переносит историю вашей текущей беседы.108 Это запускает сеанс Remote Control, который переносит историю вашего текущего разговора.

112 109

113 До тех пор, пока вы не примете одноразовое подтверждение Remote Control, диалоговое окно появляется перед подключением `/remote-control`. Выберите **Enable Remote Control**, чтобы принять и подключиться. Если вы выберете **Never mind** или нажмёте Esc, Claude Code не подключается и спросит снова в следующий раз, когда вы запустите `/remote-control`.110 До тех пор, пока вы не примете одноразовое подтверждение Remote Control, диалог появляется перед подключением `/remote-control`. Выберите **Enable Remote Control**, чтобы принять и подключиться. Если вы выберете **Never mind** или нажмете Esc, Claude Code не подключится и снова спросит при следующем запуске `/remote-control`.

114 111

115 Флаги `--verbose`, `--sandbox` и `--no-sandbox` недоступны с этой командой.112 Флаги `--verbose`, `--sandbox` и `--no-sandbox` недоступны с этой командой.

116 </Tab>113 </Tab>

122 /remote-control119 /remote-control

123 ```120 ```

124 121

125 Пока Remote Control включён, Claude Code показывает индикатор **Remote Control** в нижнем колонтитуле поля подсказки. После подключения сеанса нажмите индикатор, чтобы перейти непосредственно к сеансу, или найдите его в списке сеансов на [claude.ai/code](https://claude.ai/code). Claude Code также размещает URL сеанса в беседе. Чтобы отключиться, запустите `/remote-control` снова.122 Пока Remote Control включен, Claude Code показывает индикатор **Remote Control** в нижней части поля подсказки. После подключения сеанса нажмите на индикатор, чтобы перейти непосредственно к сеансу, или найдите его в списке сеансов на [claude.ai/code](https://claude.ai/code). Claude Code также публикует URL сеанса в разговоре. Чтобы отключиться, запустите `/remote-control` снова.

126 123

127 В отличие от CLI, команда VS Code не принимает аргумент имени и не отображает QR-код. Название сеанса выводится из истории вашей беседы или первой подсказки.124 В отличие от CLI, команда VS Code не принимает аргумент имени и не отображает QR-код. Название сеанса выводится из истории вашего разговора или первой подсказки.

128 </Tab>125 </Tab>

129</Tabs>

130 126

131<h3 id="check-connection-status">127 <Tab title="Приложение Desktop">

132 Проверка статуса подключения128 В локальном сеансе на вкладке Code [приложения Claude Desktop](/docs/ru/desktop) введите `/remote-control` или `/rc` в поле подсказки.

133</h3>

134 129

135В интерактивном сеансе, пока Remote Control подключён, терминал показывает индикатор `/rc active`, который ссылается на сеанс на claude.ai. Индикатор скрывается, когда терминал слишком узкий, чтобы его вместить. Чтобы увидеть URL сеанса и QR-код для [подключения с другого устройства](#connect-from-another-device), запустите `/remote-control` снова, чтобы открыть панель статуса. Панель также позволяет вам отключить Remote Control, пока ваш локальный сеанс продолжает работу.130 ```text theme={null}

131 /remote-control

132 ```

136 133

137<span id="session-ended-elsewhere" />Если подключение не удаётся в интерактивном сеансе, индикатор изменяется, чтобы показать сбой, и Claude Code показывает причину в уведомлении и добавляет её в беседу. Запустите `/remote-control` для переподключения, если только причина не говорит, что сеанс был перехвачен или завершён в другом месте:134 После подключения сеанса найдите его в списке сеансов на [claude.ai/code](https://claude.ai/code). Чтобы отключиться, запустите `/remote-control` снова.

138 135

139* **Another connection took over this session**: другое устройство или сеанс Claude Code теперь имеет его. Запустите `/remote-control` только если вы хотите вернуть его.136 Чтобы вместо этого включить 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 повторно открывает архивированный сеанс.137 </Tab>

141* **The server no longer reports this session**: он мог быть удалён с другого устройства или приложения.138</Tabs>

142 139

143<h3 id="session-url-reminders">140<h3 id="check-connection-status">

144 Напоминания об URL сеанса141 Проверка статуса подключения

145</h3>142</h3>

146 143

147Пока Remote Control подключён, Claude Code напоминает вам об URL сеанса при переключении на ваш телефон или браузер, что помогает больше всего, поэтому вам не нужно искать ссылку в `/remote-control`. Напоминание появляется над полем подсказки в одном из этих моментов:144В интерактивном сеансе, пока Remote Control подключен, терминал показывает индикатор `/rc active`, который ссылается на сеанс на claude.ai. Индикатор скрывается, когда терминал слишком узкий, чтобы его вместить. Чтобы увидеть URL сеанса и QR-код для [подключения с другого устройства](#connect-from-another-device), запустите `/remote-control` снова, чтобы открыть панель статуса. Панель также позволяет вам отключить Remote Control, пока ваш локальный сеанс продолжает работать.

148 145

149* **Длительный ход**: когда ход выполняется дольше, чем настроенный на сервере порог, Claude Code показывает уведомление **Still working** со ссылкой **Check in from your phone**, чтобы вы могли следить за ходом со своего телефона или браузера вместо ожидания в терминале. Claude Code удаляет его, когда ход завершается.146<span id="session-ended-elsewhere" />Если подключение не удается в интерактивном сеансе, индикатор изменяется, чтобы показать сбой, и Claude Code показывает причину в уведомлении и добавляет ее в разговор. Запустите `/remote-control` для переподключения, если только причина не говорит, что сеанс изменился где-то еще:

150* **Повторяющиеся подсказки разрешений**: после того как вы ответите на несколько [подсказок разрешений](/docs/ru/permissions) в сеансе, появляется уведомление **Approve tool calls from your phone** с URL сеанса. Claude Code удаляет его, когда начинается ваш следующий ход.

151 147

152Напоминания могут появляться в любом подключённом сеансе, включая те, где Remote Control [подключается автоматически](#enable-remote-control-for-all-sessions). Они не появляются каждый раз, когда возникают эти условия, и каждое появляется только несколько раз в целом по сеансам. Вы не можете их настраивать или отключать; каждое очищается самостоятельно.148* **Another connection took over this session**: другое устройство или сеанс Claude Code теперь его имеет. Запустите `/remote-control` только если вы хотите его вернуть.

149* **This session was ended or archived from another device or app**: запустите `/remote-control` только если вы хотите сеанс вернуть. Claude Code повторно открывает архивированный сеанс.

150* **The server no longer reports this session**: он может быть удален с другого устройства или приложения.

153 151

154<h3 id="connect-from-another-device">152<h3 id="connect-from-another-device">

155 Подключение с другого устройства153 Подключение с другого устройства

158После активации сеанса Remote Control у вас есть несколько способов подключиться с другого устройства:156После активации сеанса Remote Control у вас есть несколько способов подключиться с другого устройства:

159 157

160* **Откройте URL сеанса** в любом браузере, чтобы перейти непосредственно к сеансу на [claude.ai/code](https://claude.ai/code).158* **Откройте URL сеанса** в любом браузере, чтобы перейти непосредственно к сеансу на [claude.ai/code](https://claude.ai/code).

161* **Отсканируйте QR-код**, показанный рядом с URL сеанса, чтобы открыть его непосредственно в приложении Claude. С помощью `claude remote-control` нажмите пробел, чтобы переключить отображение QR-кода.159* **Отсканируйте QR-код**, показанный рядом с URL сеанса, чтобы открыть его непосредственно в приложении Claude. С `claude remote-control` нажмите пробел, чтобы переключить отображение QR-кода.

162* **Откройте [claude.ai/code](https://claude.ai/code) или приложение Claude** и найдите сеанс по имени в списке сеансов. В мобильном приложении Claude нажмите **Code** в навигации, чтобы перейти к списку сеансов. Сеансы Remote Control показывают значок компьютера с зелёной точкой статуса при подключении.160* **Откройте [claude.ai/code](https://claude.ai/code) или приложение Claude** и найдите сеанс по имени в списке сеансов. В мобильном приложении Claude нажмите **Code** в навигации, чтобы достичь списка сеансов. Сеансы Remote Control показывают значок компьютера с зеленой точкой статуса при подключении.

163 161

164Когда вы подключаетесь, устройство показывает любых подагентов и рабочие процессы, которые сеанс уже имеет, работающие в фоновом режиме. Остановите один из них с устройства, и Claude Code остановит эту задачу на вашем компьютере.162Когда вы подключаетесь, устройство показывает любых подагентов и рабочие процессы, которые сеанс уже запустил в фоновом режиме. Остановите один из них с устройства, и Claude Code остановит эту задачу на вашей машине.

165 163

166Название удалённого сеанса выбирается в следующем порядке:164Название удаленного сеанса выбирается в этом порядке:

167 165

1681. Имя, которое вы передали в `--name`, `--remote-control` или `/remote-control`1661. Имя, которое вы передали в `--name`, `--remote-control` или `/remote-control`

1692. Название, которое вы установили с помощью `/rename`1672. Название, которое вы установили с помощью `/rename`

1703. Последнее значимое сообщение в существующей истории беседы1683. Последнее значимое сообщение в существующей истории разговора

1714. Автоматически сгенерированное имя вроде `myhost-graceful-unicorn`, где `myhost` — это имя хоста вашего компьютера или префикс, который вы установили с помощью `--remote-control-session-name-prefix`1694. Автоматически сгенерированное имя вроде `myhost-graceful-unicorn`, где `myhost` — это имя хоста вашей машины или префикс, который вы установили с помощью `--remote-control-session-name-prefix`

~~172~~

173Если вы не установили явное имя, Claude Code обновляет название, чтобы отразить вашу подсказку после её отправки. Claude Code сопоставляет автоматически сгенерированные названия с языком вашей беседы, или с параметром [`language`](/docs/ru/settings-reference#language), если он настроен.

174 170

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, устанавливает имя на любой версии.171Если вы не установили явное имя, Claude Code обновляет название, чтобы отразить вашу подсказку после того, как вы отправите одну. Когда вы переименовываете сеанс с claude.ai или приложения Claude, Claude Code также обновляет локальное название, показанное в `claude --resume`.

176 172

177Если у вас ещё нет приложения Claude, используйте команду `/mobile` внутри Claude Code, чтобы показать QR-код для [claude.ai/mobile](https://claude.ai/mobile), который открывает правильный магазин приложений для вашего телефона.173Если у вас еще нет приложения Claude, запустите `/mobile` внутри Claude Code, чтобы показать QR-код для [claude.ai/mobile](https://claude.ai/mobile), который открывает правильный магазин приложений для вашего телефона.

178 174

179<h3 id="what-connected-devices-see">175<h3 id="what-connected-devices-see">

180 Что видят подключённые устройства176 Что видят подключенные устройства

181</h3>177</h3>

182 178

183Подключённое устройство показывает беседу в вашем терминале по мере её развития. Эти случаи выходят за рамки обычных сообщений:179Подключенное устройство показывает разговор в вашем терминале по мере его происхождения. Эти случаи выходят за рамки обычных сообщений:

184 180

185* **Компактирование и `/clear`**: пока Claude Code [компактирует беседу](/docs/ru/context-window#what-survives-compaction), подключённые устройства показывают прогресс, а затем где была компактирована беседа. Когда вы запускаете `/clear`, беседа сбрасывается и на подключённых устройствах тоже.181* **Компактирование и `/clear`**: пока Claude Code [компактирует разговор](/docs/ru/context-window#what-survives-compaction), подключенные устройства показывают прогресс, а затем где был компактирован разговор. Когда вы запускаете `/clear`, разговор также сбрасывается на подключенных устройствах.

186* **Переключение бесед с помощью `/resume`**: подключённое устройство не получает название переключённой беседы или её более раннюю историю, но новые сообщения в обе стороны идут в ту беседу, которая открыта в вашем терминале, и из неё. Чтобы снова работать с исходной беседой с устройства, запустите `/resume` в вашем терминале и переключитесь обратно на неё.182* **Переключение разговоров с помощью `/resume`**: подключенное устройство не получает название переключенного разговора или более раннюю историю, но новые сообщения в обе стороны идут к и от того разговора, который открыт в вашем терминале. Чтобы снова работать с исходным разговором с устройства, запустите `/resume` в вашем терминале и переключитесь обратно на него.

187* **Извлечение сеанса с помощью `/teleport`**: когда вы извлекаете [сеанс Claude Code в веб-версии](/docs/ru/claude-code-on-the-web#from-cloud-to-terminal) в свой терминал с помощью `/teleport`, подключённое устройство не получает более раннюю историю извлечённой беседы. Новые сообщения в обе стороны идут в извлечённую беседу, которая теперь открыта в вашем терминале.183* **Извлечение сеанса с помощью `/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 или позже.184* **Сообщения из ваших других сеансов**: с [кросс-сеансовой передачей сообщений](/docs/ru/cross-session-messaging) одно и то же подключение переносит сообщения между вашими собственными сеансами на разных машинах и из ваших [облачных сеансов](/docs/ru/claude-code-on-the-web).

189* **Подсказки, которые вы отправляете в середине хода**: когда вы отправляете подсказку с подключённого устройства до завершения текущего хода, Claude Code ставит её в очередь и сохраняет её в стенограмме устройства после завершения этого хода.185* **Diff ваших изменений**: когда каталог сеанса находится в git репозитории, панель diff подключенного устройства показывает ваши изменения. На ветке, которая имеет коммиты впереди ветки по умолчанию репозитория, панель показывает изменения с момента разделения ветки, включая ваши незафиксированные правки. На самой ветке по умолчанию или на ветке, которая не впереди, панель показывает только ваши незафиксированные изменения.

190* **Diff ваших изменений**: когда каталог сеанса находится в репозитории git, панель diff подключённого устройства показывает ваши изменения. Устройство запрашивает diff по соединению, и Claude Code вычисляет его на вашем компьютере. На ветке, которая имеет коммиты впереди ветви по умолчанию репозитория, панель показывает изменения с момента расхождения ветви, включая ваши незафиксированные правки. На самой ветви по умолчанию или на ветви, которая не впереди неё, панель показывает только ваши незафиксированные изменения. До версии 2.1.247 Claude Code сообщал diff подключённым устройствам только в сеансах, обслуживаемых `claude remote-control`.186* **Модель**: когда вы выбираете [модель](/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 или позже.187* **Уровень усилий**: когда вы устанавливаете [уровень усилий](/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 также устанавливает вашу стандартную модель для новых сеансов.188* **Переподключение после сбоя подключения**: запустите `/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 189

197<h3 id="enable-remote-control-for-all-sessions">190<h3 id="enable-remote-control-for-all-sessions">

198 Включение Remote Control для всех сеансов191 Включение Remote Control для всех сеансов

199</h3>192</h3>

200 193

201Remote Control активируется только при явном запуске `claude remote-control`, `claude --remote-control` или `/remote-control`, если не включена автоподключение. Чтобы включить автоподключение для каждого интерактивного сеанса, запустите `/config` внутри Claude Code и установите **Enable Remote Control for all sessions**. Переключатель принимает три значения:194Remote Control активируется только при явном запуске `claude remote-control`, `claude --remote-control` или `/remote-control`, если не включено автоподключение. Чтобы включить автоподключение для каждого интерактивного сеанса, запустите `/config` внутри Claude Code и установите **Enable Remote Control for all sessions**. Переключатель принимает три значения:

202 195

203* **`true`**: подключаться автоматически при запуске интерактивного сеанса.196* **`true`**: автоматически подключаться при запуске интерактивного сеанса.

204* **`false`**: отключить автоподключение, хотя `true` из [управляемых параметров](/docs/ru/managed-settings) имеет приоритет, потому что Claude Code сохраняет выбор в ваши пользовательские параметры. `false` в параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`) отключает автоподключение даже над управляемым `true`.197* **`false`**: отключить автоподключение, хотя `true` из [управляемых параметров](/docs/ru/managed-settings) имеет приоритет, потому что Claude Code сохраняет выбор в ваши пользовательские параметры. `false` в параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`) отключает автоподключение даже над управляемым `true`.

205* **`default`**: очистить ваш выбор и следовать стандартному значению администратора вашей организации, если оно установлено, иначе текущему стандартному значению Claude Code.198* **`default`**: очистить ваш выбор и следовать администраторскому значению по умолчанию вашей организации, если оно установлено, иначе текущему значению по умолчанию Claude Code.

206 199

207Тот же переключатель появляется вне CLI:200Тот же переключатель появляется вне CLI:

208 201

209* **Приложение Desktop**: **Settings > Claude Code > Enable remote control by default**.202* **Приложение 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 или позже.203* **Расширение VS Code**: **Enable Remote Control for all sessions** в разделе Settings [меню команд](/docs/ru/vs-code#use-the-prompt-box).

211 204

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 для всех, кто открывает репозиторий.205Чтобы вместо этого включить автоподключение из файла параметров, установите [`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 206

214Автоподключение входит с вашей собственной учётной записью claude.ai, поэтому сеанс, который оно запускает, появляется только в приложениях Claude вашей собственной учётной записи и не предоставляет доступ никому другому.207Автоподключение входит с вашей собственной учетной записью claude.ai, поэтому сеанс, который оно запускает, появляется только в приложениях Claude вашей собственной учетной записи и не предоставляет доступ никому другому.

215 208

216С этой настройкой каждый интерактивный процесс Claude Code регистрирует один удалённый сеанс. Если вы запустите несколько экземпляров, каждый получит свой собственный удалённый сеанс. Чтобы запустить несколько одновременных сеансов из одного процесса, используйте [режим сервера](#start-a-remote-control-session) вместо этого.209С этим параметром включенным, каждый интерактивный процесс Claude Code регистрирует один удаленный сеанс. Если вы запускаете несколько экземпляров, каждый получает свой собственный удаленный сеанс. Чтобы запустить несколько одновременных сеансов из одного процесса, используйте вместо этого [режим сервера](#start-a-remote-control-session).

217 210

218<h3 id="resume-sessions-after-stopping-the-server">211<h3 id="resume-sessions-after-stopping-the-server">

219 Возобновление сеансов после остановки сервера212 Возобновление сеансов после остановки сервера

220</h3>213</h3>

221 214

222Когда вы останавливаете `claude remote-control` с помощью Ctrl+C, сеансы, которые он обслуживал, перестают отвечать с вашего телефона или браузера. Пока вы не запускали другой `claude remote-control` в том же каталоге и не запустили этот с `--no-create-session-in-dir`, Claude Code их не архивирует. Чтобы вернуть их, запустите одну из этих команд в том же каталоге:215Когда вы останавливаете `claude remote-control` с помощью Ctrl+C, сеансы, которые он обслуживал, перестают отвечать с вашего телефона или браузера. Пока вы не запускали другой `claude remote-control` в том же каталоге и не запустили этот с `--no-create-session-in-dir`, Claude Code их не архивирует. Чтобы их вернуть, запустите одну из этих команд в том же каталоге:

223 216

224* **`claude remote-control`**: возвращает каждый сеанс, который обслуживал сервер.217* **`claude remote-control`**: возвращает каждый сеанс, который обслуживал сервер.

225* **`claude remote-control --continue`**: возвращает только сеанс, который сервер запустил, и выходит, когда этот сеанс завершается. Если в этом каталоге нет записи, Claude Code использует самый новый из других git worktrees этого репозитория.218* **`claude remote-control --continue`**: возвращает только сеанс, с которого сервер начал, и выходит, когда этот сеанс заканчивается. Если в этом каталоге нет записи, Claude Code использует самый новый из других git worktrees этого репозитория.

226* **`claude remote-control --session-id <id>`**: возвращает только сеанс, чей ID вы передали, и выходит, когда этот сеанс завершается. ID — это часть URL сеанса на claude.ai/code между `/code/` и любым `?`.219* **`claude remote-control --session-id <id>`**: возвращает только сеанс, чей ID вы передали, и выходит, когда этот сеанс заканчивается. ID — это часть URL сеанса на claude.ai/code между `/code/` и любым `?`.

227 220

228Эти команды работают примерно четыре часа после остановки сервера. После этого запустите `claude remote-control` для запуска нового сеанса. Если вы архивировали сеанс в то же время, `--continue` и `--session-id` разархивируют его на Claude Code версии 2.1.228 или позже.221Эти команды работают примерно четыре часа после остановки сервера. После этого запустите `claude remote-control` для запуска нового сеанса. Если вы архивировали сеанс в то же время, `--continue` и `--session-id` разархивируют его на Claude Code v2.1.228 или позже.

229 222

230Чтобы вернуть сеанс, который вы запустили с помощью `claude --remote-control` или `/remote-control`, возобновите беседу с помощью `claude --continue` или `claude --resume`. Переподключится ли Claude Code и к какому сеансу, зависит от [записи переподключения](#resume-outcomes) беседы.223Чтобы вернуть сеанс, который вы запустили с помощью `claude --remote-control` или `/remote-control`, возобновите разговор с помощью `claude --continue` или `claude --resume`. Если Remote Control не переподключится, см. [Не удалось переподключиться к вашему сеансу Remote Control](#couldnt-reconnect-to-your-remote-control-session).

231 224

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 туда.225Если вы возобновляете разговор во втором терминале, пока первый все еще имеет Remote Control включенным, Claude Code выводит уведомление `Remote Control not started here` во втором терминале и оставляет Remote Control отключенным там вместо того, чтобы забирать сеанс у первого. Запустите `/remote-control` во втором терминале, чтобы переместить Remote Control на него.

233 226

234Когда вы возобновляете беседу в Claude Desktop или расширении IDE, которое имело Remote Control включённым, Claude Code переподключает его к существующему сеансу claude.ai вместо добавления нового в список сеансов.227Когда вы возобновляете разговор в Claude Desktop или расширении IDE, которое имело Remote Control включенным, Claude Code переподключает его к существующему сеансу claude.ai вместо добавления нового в список сеансов.

235 228

236<h2 id="connection-and-security">229<h2 id="connection-and-security">

237 Подключение и безопасность230 Подключение и безопасность

239 232

240Ваш локальный сеанс Claude Code выполняет только исходящие HTTPS запросы и никогда не открывает входящие порты на вашем компьютере. Когда вы запускаете Remote Control, он регистрируется в API Anthropic и опрашивает работу. Когда вы подключаетесь с другого устройства, сервер маршрутизирует сообщения между веб-клиентом или мобильным клиентом и вашим локальным сеансом через потоковое соединение.233Ваш локальный сеанс Claude Code выполняет только исходящие HTTPS запросы и никогда не открывает входящие порты на вашем компьютере. Когда вы запускаете Remote Control, он регистрируется в API Anthropic и опрашивает работу. Когда вы подключаетесь с другого устройства, сервер маршрутизирует сообщения между веб-клиентом или мобильным клиентом и вашим локальным сеансом через потоковое соединение.

241 234

242Весь трафик проходит через API Anthropic через TLS, тот же транспортный протокол безопасности, что и любой сеанс Claude Code. Соединение использует несколько краткосрочных учётных данных, каждое из которых ограничено одной целью и истекает независимо. Когда учётные данные регистрации сервера `claude remote-control` истекают, сервер снова регистрируется в API Anthropic и продолжает обслуживать свои сеансы.235Весь трафик проходит через API Anthropic через TLS, тот же транспортный протокол безопасности, что и любой сеанс Claude Code. Соединение использует несколько краткосрочных учётных данных, каждое из которых ограничено одной целью и истекает независимо.

243 236

244Пока Remote Control подключен, стенограмма сеанса, включая ваши сообщения, ответы Claude и активность инструментов, хранится на серверах Anthropic. Сохраненная стенограмма синхронизирует беседу на всех ваших устройствах и позволяет сеансу переподключиться после разрыва сети. Выполнение и доступ к файловой системе остаются на вашем компьютере, а сохраненные стенограммы хранятся в соответствии с политикой [Использование данных](/docs/ru/data-usage).237Пока Remote Control подключен, стенограмма сеанса, включая ваши сообщения, ответы Claude и активность инструментов, хранится на серверах Anthropic. Сохраненная стенограмма синхронизирует беседу на всех ваших устройствах и позволяет сеансу переподключиться после разрыва сети. Выполнение и доступ к файловой системе остаются на вашем компьютере, а сохраненные стенограммы хранятся в соответствии с политикой [Использование данных](/docs/ru/data-usage).

245 238

309Для потерянного или украденного устройства член удаляет его с этой страницы. Если член не может войти, администратор может использовать **Sign out everywhere** в консоли администратора, чтобы отозвать каждый сеанс и зарегистрированное устройство для этого члена, после чего член повторно регистрирует устройства, которые он всё ещё держит.302Для потерянного или украденного устройства член удаляет его с этой страницы. Если член не может войти, администратор может использовать **Sign out everywhere** в консоли администратора, чтобы отозвать каждый сеанс и зарегистрированное устройство для этого члена, после чего член повторно регистрирует устройства, которые он всё ещё держит.

310 303

311<h2 id="remote-control-vs-cloud-sessions">304<h2 id="remote-control-vs-cloud-sessions">

312 Remote Control в сравнении с облачными сеансами305 Remote Control и облачные сеансы

313</h2>306</h2>

314 307

315Remote Control и [облачные сеансы](/docs/ru/claude-code-on-the-web) оба используют интерфейс claude.ai/code. Ключевое различие заключается в том, где работает сеанс: Remote Control выполняется на вашем компьютере, поэтому ваши локальные MCP servers, инструменты и конфигурация проекта остаются доступными. Облачный сеанс выполняется в облачной инфраструктуре, управляемой Anthropic по умолчанию.308Remote Control и [облачные сеансы](/docs/ru/claude-code-on-the-web) используют интерфейс claude.ai/code. Ключевое различие заключается в том, где выполняется сеанс: Remote Control выполняется на вашем компьютере, поэтому ваши локальные MCP серверы, инструменты и конфигурация проекта остаются доступными. Облачный сеанс выполняется на облачной инфраструктуре, управляемой Anthropic по умолчанию.

316 309

317Используйте Remote Control, когда вы находитесь в процессе локальной работы и хотите продолжить с другого устройства. Используйте облачный сеанс, когда вы хотите начать задачу без какой-либо локальной настройки, работать с репозиторием, который у вас не клонирован, или запустить несколько задач параллельно.310Используйте Remote Control, когда вы находитесь в процессе локальной работы и хотите продолжить с другого устройства. Используйте облачный сеанс, когда вы хотите начать задачу без какой-либо локальной настройки, работать с репозиторием, который у вас не клонирован, или запускать несколько задач параллельно. [Проект](/docs/ru/claude-projects) объединяет оба подхода: его потоки выполняются в облаке, и он использует Remote Control для [запуска потока на вашем компьютере](/docs/ru/claude-projects#run-a-thread-on-your-own-computer), когда вы просите это там.

311

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

313

315| :- | :- | :- | :- | :- |

317| [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) | Управление текущей работой с другого устройства |

318| [Channels](/docs/ru/channels) | Отправляйте события из приложения чата, такого как Telegram или Discord, или с вашего собственного сервера | Ваша машина (CLI) | [Установите плагин канала](/docs/ru/channels#quickstart) или [создайте свой](/docs/ru/channels-reference) | Реагирование на внешние события, такие как сбои CI или сообщения в чате |

319| [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 и рецензии из чата команды |

320| [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 322

319<h2 id="mobile-push-notifications">323<h2 id="mobile-push-notifications">

320 Мобильные push-уведомления324 Мобильные push-уведомления

322 326

323Когда Remote Control активен, Claude может отправлять push-уведомления на ваш телефон.327Когда Remote Control активен, Claude может отправлять push-уведомления на ваш телефон.

324 328

325Claude решает, когда отправить уведомление. Обычно он отправляет одно, когда завершается долгоживущая задача или когда ему нужно решение от вас для продолжения. Вы также можете запросить push в своей подсказке, например `notify me when the tests finish`. Помимо двух переключателей включения/отключения ниже, нет конфигурации для каждого события.329Claude решает, когда отправить уведомление. Обычно он отправляет его, когда завершается долгоживущая задача или когда ему нужно ваше решение для продолжения. Вы также можете запросить push-уведомление в своем запросе, например `notify me when the tests finish`. Помимо двух переключателей включения/выключения ниже, нет конфигурации для отдельных событий.

326 330

327Чтобы настроить мобильные push-уведомления:331Чтобы настроить мобильные push-уведомления:

328 332

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).335 Загрузите приложение 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>336 </Step>

333 337

334 <Step title="Войдите с помощью своей учётной записи Claude Code">338 <Step title="Войдите с помощью своей учетной записи Claude Code">

335 Используйте ту же учётную запись и организацию, которые вы используете для Claude Code в терминале.339 Используйте ту же учетную запись и организацию, которые вы используете для Claude Code в терминале.

336 </Step>340 </Step>

337 341

338 <Step title="Разрешите уведомления">342 <Step title="Разрешите уведомления">

340 </Step>344 </Step>

341 345

342 <Step title="Включите push в Claude Code">346 <Step title="Включите push в Claude Code">

343 В вашем терминале запустите `/config` и включите **Push when Claude decides** для проактивных уведомлений, **Push when actions required** для запросов разрешений и вопросов или оба варианта.347 В вашем терминале запустите `/config` и включите **Push when Claude decides** для проактивных уведомлений, **Push when actions required** для запросов разрешений и вопросов, или оба варианта.

344 </Step>348 </Step>

345</Steps>349</Steps>

346 350

347Если уведомления не приходят:351Если уведомления не приходят:

348 352

349* Если `/config` показывает **No mobile registered**, откройте приложение Claude на своем телефоне, чтобы оно могло обновить свой токен push. Предупреждение исчезает при следующем подключении Remote Control.353* Если `/config` показывает **No mobile registered**, откройте приложение Claude на вашем телефоне, чтобы оно могло обновить свой push-токен. Предупреждение исчезает при следующем подключении Remote Control.

350* На iOS режимы Focus и сводки уведомлений могут подавлять или задерживать push-уведомления. Проверьте Settings → Notifications → Claude.354* На iOS режимы Focus и сводки уведомлений могут подавлять или задерживать push-уведомления. Проверьте Settings → Notifications → Claude.

351* На Android агрессивная оптимизация батареи может задержать доставку. Исключите приложение Claude из оптимизации батареи в системных параметрах.355* На Android агрессивная оптимизация батареи может задержать доставку. Исключите приложение Claude из оптимизации батареи в системных параметрах.

352 356

353Claude Code пропускает мобильные push-уведомления, пока вы печатаете или сосредоточены на подключённом терминале. Начиная с версии v2.1.181, вы можете установить [`CLAUDE_CLIENT_PRESENCE_FILE`](/docs/ru/env-vars) на путь файла-маркера, чтобы расширить это на любое время, когда вы находитесь у машины, даже в другом окне: уведомления пропускаются, пока файл существует. Настройте прослушиватель блокировки экрана или аналогичный инструмент для создания файла при разблокировке экрана и удаления его при блокировке экрана.357Claude Code пропускает мобильные push-уведомления, пока вы печатаете или сосредоточены на подключенном терминале. Чтобы расширить это на любое время, когда вы находитесь у машины, даже в другом окне, установите [`CLAUDE_CLIENT_PRESENCE_FILE`](/docs/ru/env-vars) на путь файла-маркера: уведомления пропускаются, пока файл существует. Настройте прослушиватель блокировки экрана или аналогичный инструмент для создания файла при разблокировке экрана и удаления его при блокировке экрана.

354 358

355<h2 id="limitations">359<h2 id="limitations">

356 Ограничения360 Ограничения

357</h2>361</h2>

358 362

359* **Один удалённый сеанс на интерактивный процесс**: вне режима сервера каждый экземпляр Claude Code поддерживает один удалённый сеанс одновременно. Используйте [режим сервера](#start-a-remote-control-session) для запуска нескольких одновременных сеансов из одного процесса.363* **Один удалённый сеанс на интерактивный процесс**: вне режима сервера каждый экземпляр 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`.364* **Локальный процесс должен продолжать работу**: 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 или позже.365* **Сбойные сеансы в режиме сервера**: если сеанс, обслуживаемый `claude remote-control`, дает сбой, отправьте ему сообщение с подключённого устройства. Claude Code обслуживает его снова. Вам не нужно перезапускать сервер. Требуется Claude Code v2.1.238 или позже.

362* **HTTP 403 отказы в подключённом сеансе**: после подключения интерактивного сеанса Claude Code продолжает повторные попытки в течение трёх минут, когда что-то между вашей машиной и серверами Anthropic отвечает с HTTP 403, что может произойти после изменения VPN или сети. Если отказы продолжаются дольше, Claude Code отключается, и причина указывает, что отказало: сетевой край или прокси, VPN или брандмауэр в вашей собственной сети.366* **HTTP 403 отказы в подключённом сеансе**: после подключения интерактивного сеанса Claude Code продолжает повторять попытки в течение трёх минут, когда что-то между вашей машиной и серверами Anthropic отвечает с HTTP 403, что может произойти после изменения VPN или сети. Если отказы продолжаются дольше, Claude Code отключается, и причина указывает, что отказало: сетевой край или прокси, VPN или брандмауэр в вашей собственной сети.

363* **Продолжительный сбой сети**: если ваша машина включена, но не может достичь сеть, то, что вы делаете дальше, зависит от режима:367* **Продолжительный сбой сети**: если ваша машина включена, но не может подключиться к сети, то, что вы делаете дальше, зависит от режима:

364 * **Режим сервера**: Claude Code сдаётся примерно через 10 минут и процесс `claude remote-control` завершается. Запустите `claude remote-control` снова, чтобы начать новый сеанс.368 * **Режим сервера**: Claude Code сдаётся примерно через 10 минут и процесс `claude remote-control` завершается. Запустите `claude remote-control` снова, чтобы начать новый сеанс.

365 * **Интерактивный сеанс**: продолжайте работать локально. Claude Code повторяет попытки столько, сколько длится сбой, и переподключается автоматически, когда сеть восстанавливается.369 * **Интерактивный сеанс**: продолжайте работать локально. Claude Code повторяет попытки столько, сколько длится сбой, и автоматически переподключается, когда сеть восстанавливается.

366* **Сбой импульсов присутствия**: если интерактивный сеанс отключается с сообщением `could not reach the Remote Control server for about 30 minutes`, запустите `/remote-control` для переподключения. Claude Code показывает это сообщение только когда импульсы присутствия сеанса не работают, а остальная часть соединения остаётся активной; он повторно регистрирует сеанс примерно на 30 минут перед отключением.370* **Сбой пульса присутствия**: если интерактивный сеанс отключается с сообщением `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 или позже.371* **Переадресованные диалоги истекают**: 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).372* **Подсказка согласия на использование кредитов 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, независимо от того, передаёте ли вы аргумент или нет. Следующие команды работают с мобильных устройств и веб-браузеров:373* **Некоторые команды только локальные**: команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, работают только из локального CLI, независимо от того, передаёте ли вы аргумент или нет. Следующие работают с мобильных и веб-приложений:

370 * Команды с текстовым выводом: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap` и `/reload-plugins`. `/usage-credits` выводит URL биллинга вместо открытия браузера. `/reload-plugins` работает только когда сеанс работает в интерактивном терминале; сеанс без него отклоняет его.374 * Команды с текстовым выводом: `/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` принимают аргумент вместо выбора в терминале или ползунка.375 * `/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` без имени сервера переподключает каждый сервер, который не работает или требует аутентификации.376 * `/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 ваших параметров и игнорирует текст после команды.377 * `/config`: из мобильного приложения передайте `key=value` для установки параметра или запустите его без аргумента, чтобы вывести список ключей, которые вы можете установить. В веб-приложении `/config` вместо этого открывает раздел Claude Code ваших параметров и игнорирует текст после команды.

374 * На Team и Enterprise `/usage-credits` с мобильного устройства или веб-браузера не отправляет [запрос на использование кредитов вашему администратору](/docs/ru/costs#add-usage-credits-to-your-subscription). Отправка требует подтверждения, которое появляется только в интерактивном CLI, поэтому команда говорит вам запустить её там. До версии 2.1.211 текстовая форма отправляла запрос без подтверждения.378 * На 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`. Без аргумента он выводит текущий размер окна как текст вместо открытия диалога, который команда показывает в сеансе терминала.379 * `/autocompact`, начиная с v2.1.221: передайте размер окна как аргумент, например `/autocompact 500k`. Без аргумента он выводит текущий размер окна как текст вместо открытия диалога, который команда показывает в сеансе терминала.

376 * `/advisor`, начиная с версии 2.1.260: передайте модель как аргумент, например `/advisor opus`, или передайте `off` для отключения советника. Обе формы применяются только к текущему сеансу и оставляют ваше сохранённое значение по умолчанию без изменений. Без аргумента он выводит текущего советника как текст вместо открытия выбора.380 * `/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), выберите его в самом сеансе.381 * `/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), выберите его в самом сеансе.

382 * `/focus`, начиная с v2.1.281: передайте `on` или `off` как аргумент, например `/focus on`, или запустите его без аргумента для переключения [focus view](/docs/ru/commands#all-commands). Обе формы применяются только к текущему сеансу и оставляют вашу сохранённую выборку без изменений.

378 383

379<h2 id="troubleshooting">384<h2 id="troubleshooting">

380 Troubleshooting385 Troubleshooting

388 393

389* Вышли из системы, из `/remote-control` или `--remote-control`: `Remote Control requires a claude.ai subscription.` или `/remote-control requires a claude.ai subscription.`394* Вышли из системы, из `/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.`395* Вышли из системы, из `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` называются одинаково.396* Вошли в систему, но используется 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 397

393Запустите `claude auth login` и выберите опцию claude.ai. Если сообщение указывает на `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN`, удалите его везде, где он установлен: в переменных окружения вашей оболочки или в блоке `env` [файла параметров](/docs/ru/settings-reference#env). Если оно указывает на `apiKeyHelper`, удалите этот параметр.398Запустите `claude auth login` и выберите опцию claude.ai. Если сообщение указывает на `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN`, удалите его везде, где он установлен: в переменных окружения вашей оболочки или в блоке `env` [файла параметров](/docs/ru/settings-reference#env). Если оно указывает на `apiKeyHelper`, удалите этот параметр.

394 399

395До версии 2.1.206 запуск `/remote-control` при выходе из системы сообщал `Unknown command: /remote-control` вместо этого сообщения.

~~396~~

397<h3 id="remote-control-requires-a-full-scope-login-token">400<h3 id="remote-control-requires-a-full-scope-login-token">

398 "Remote Control requires a full-scope login token"401 "Remote Control requires a full-scope login token"

399</h3>402</h3>

400 403

401Вы аутентифицированы с помощью долгоживущего токена из `claude setup-token` или переменной окружения `CLAUDE_CODE_OAUTH_TOKEN`. Эти токены могут только делать запросы к модели, поэтому они не могут устанавливать сеансы Remote Control. Запустите `claude auth login` для аутентификации с помощью токена сеанса полного объёма вместо этого.404Вы аутентифицированы с помощью долгоживущего токена из `claude setup-token` или переменной окружения `CLAUDE_CODE_OAUTH_TOKEN`. Эти токены могут только делать запросы к модели, поэтому они не могут установить сеансы Remote Control. Запустите `claude auth login` для аутентификации с помощью токена сеанса полного объёма вместо этого.

402 405

403<h3 id="unable-to-determine-your-organization-for-remote-control-eligibility">406<h3 id="unable-to-determine-your-organization-for-remote-control-eligibility">

404 "Unable to determine your organization for Remote Control eligibility"407 "Unable to determine your organization for Remote Control eligibility"

414 417

415Запустите `claude doctor` для просмотра того, какая отдельная проверка прав доступа не прошла. Конфликты переменных окружения, недостижимые проверки и параметр Remote Control вашей организации каждый производят своё собственное сообщение, поэтому эта ошибка означает, что сама проверка на уровне учётной записи не прошла.418Запустите `claude doctor` для просмотра того, какая отдельная проверка прав доступа не прошла. Конфликты переменных окружения, недостижимые проверки и параметр Remote Control вашей организации каждый производят своё собственное сообщение, поэтому эта ошибка означает, что сама проверка на уровне учётной записи не прошла.

416 419

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" ниже охватывает эту конфигурацию.420До версии 2.1.239 это сообщение читалось как "Remote Control is not yet enabled for your account".

418 421

419<h3 id="couldn’t-verify-remote-control-eligibility">422<h3 id="couldn’t-verify-remote-control-eligibility">

420 "Couldn't verify Remote Control eligibility"423 "Couldn't verify Remote Control eligibility"

421</h3>424</h3>

422 425

423Claude Code не смог достичь сервиса флагов функций для проверки того, включён ли Remote Control для вашей учётной записи, обычно потому, что вы находитесь в автономном режиме или прокси блокирует запрос. Повторите попытку, когда у вас будет доступ в сеть, или запустите `claude doctor` для получения подробностей. Связанное сообщение "Couldn't verify your organization's Remote Control policy" означает, что Claude Code не смог прочитать эту политику, и имеет то же исправление. Оба сообщения были добавлены в версии 2.1.178.426Claude Code не смог связаться со службой флагов функций для проверки того, включён ли Remote Control для вашей учётной записи, обычно потому, что вы находитесь в автономном режиме или прокси блокирует запрос. Повторите попытку, когда у вас будет доступ в сеть, или запустите `claude doctor` для получения подробной информации. Связанное сообщение "Couldn't verify your organization's Remote Control policy" означает, что Claude Code столкнулся с ошибкой при чтении этой политики и имеет то же решение.

424 427

425<h3 id="remote-control-requires-feature-flag-evaluation">428<h3 id="remote-control-requires-feature-flag-evaluation">

426 "Remote Control requires feature-flag evaluation"429 "Remote Control requires feature-flag evaluation"

427</h3>430</h3>

428 431

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" вместо этого.432[Переменная окружения](/docs/ru/env-vars#features-that-need-feature-flag-fetching), которая отключает оценку флагов функций, установлена, и полное сообщение указывает переменную, которую нашёл Claude Code. На версиях до 2.1.154 та же конфигурация производит "Remote Control is not yet enabled for your account" вместо этого. Что делать, зависит от переменной, которую указывает сообщение:

433

434* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` или `DISABLE_GROWTHBOOK`**: отключите переменную везде, где она установлена, в переменных окружения вашей оболочки или в блоке `env` файла [`settings.json`](/docs/ru/settings-reference#all-settings).

435* **`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 436

431<h3 id="remote-control-is-only-available-when-using-claude-via-api-anthropic-com">437<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"438 "Remote Control is only available when using Claude via api.anthropic.com"

433</h3>439</h3>

434 440

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) для полного списка причин.441Сеанс не разговаривает с 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. Смотрите [справочник ошибок](/docs/ru/errors#remote-control-requires-the-anthropic-api) для полного списка причин.

436 442

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`.443Сообщение указывает, что направило сеанс в сторону от API Anthropic, такое как `CLAUDE_CODE_USE_BEDROCK` или пользовательский `ANTHROPIC_BASE_URL`. Если у вас есть подходящий вход claude.ai, отключите названную переменную, удалите её из ключа `env` в [параметрах](/docs/ru/settings), если вы установили её там, и перезагрузите сеанс.

438 444

439<h3 id="remote-control-is-disabled-by-your-organization’s-policy">445<h3 id="remote-control-is-disabled-by-your-organization’s-policy">

440 "Remote Control is disabled by your organization's policy"446 "Remote Control is disabled by your organization's policy"

441</h3>447</h3>

442 448

443Политика блокирует Remote Control, или Claude Code не смог загрузить политику вашей организации на этой машине и временно держит Remote Control отключённым. Проверьте эти причины по порядку:449Политика блокирует Remote Control. Проверьте эти причины по порядку:

450

451* **Ошибка упоминает `disableRemoteControl`**: ваш администратор IT отключил Remote Control на этом устройстве через [управляемые параметры](/docs/ru/managed-settings), независимо от переключателя на уровне организации и от того, как вы вошли.

452* **Ваш план claude.ai — Pro или Max**: Claude Code всё ещё вошёл в организацию Team или Enterprise с более раннего входа, поэтому он проверяет политику Remote Control этой организации. Запустите `/status` для просмотра того, какой план и организацию использует ваш вход. Запустите `claude auth logout`, а затем `claude auth login` для повторного входа под вашим текущим планом.

453* **Сообщение не говорит обратиться к администратору вашей организации**: ваша организация имеет конфигурацию 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" вместо этого.

454* **В противном случае Owner не включил его для вашей организации**: Remote Control отключён по умолчанию на планах Team и Enterprise. Owner может включить его на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code), включив переключатель **Remote Control**. Этот переключатель является параметром организации на стороне сервера.

455

456До версии 2.1.281 это сообщение также появлялось, когда Claude Code не загрузил политику вашей организации на этой машине, например после запуска в автономном режиме. Более поздние версии сообщают об этом состоянии как [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) вместо этого.

457

458<h3 id="couldnt-verify-your-organizations-policy-for-remote-control">

459 "Couldn't verify your organization's policy for remote control"

460</h3>

461

462Claude Code не смог получить политику вашей организации и не имеет сохранённой копии на этой машине для использования вместо этого, поэтому он держит Remote Control отключённым, пока не сможет подтвердить, что ваша организация это позволяет. Это обычно происходит, когда вы запускаете Claude Code в автономном режиме или до подключения VPN, или когда прокси мешает запросу. На медленном соединении это также может появиться, пока первый запрос всё ещё в пути.

463

464Сообщение принимает одну из этих форм:

444 465

445* **Ошибка упоминает `disableRemoteControl`**: ваш администратор IT отключил Remote Control на этом устройстве через [управляемые параметры](/docs/ru/managed-settings), независимо от переключателя на уровне организации и от того, как вы вошли в систему.466* Из `/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` для повторного входа под вашим текущим планом.467* Из [автоподключения](#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` не печатал эту строку.468

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" вместо этого.469Восстановите подключение к сети, затем запустите `/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**. Этот переключатель является параметром организации на стороне сервера.470

471До версии 2.1.281 это состояние показывало `Remote Control is disabled by your organization's policy` вместо этого.

450 472

451<h3 id="remote-credentials-fetch-failed">473<h3 id="remote-credentials-fetch-failed">

452 "Remote credentials fetch failed"474 "Remote credentials fetch failed"

453</h3>475</h3>

454 476

455Claude Code не смог получить краткосрочные учётные данные из API Anthropic для установления соединения. Повторно запустите с `--verbose` для просмотра полной ошибки:477Claude Code не смог получить краткосрочные учётные данные из API Anthropic для установления соединения. Запустите снова с `--verbose` для просмотра полной ошибки:

456 478

457```bash theme={null}479```bash theme={null}

458claude remote-control --verbose480claude remote-control --verbose

460 482

461Распространённые причины:483Распространённые причины:

462 484

463* Не вошли в систему: запустите `claude` и используйте `/login` для аутентификации с помощью вашей учётной записи claude.ai. Аутентификация с помощью ключа API не поддерживается для Remote Control.485* Не вошли в систему: запустите `claude` и используйте `/login` для аутентификации с помощью вашей учётной записи claude.ai. Аутентификация по API ключу не поддерживается для Remote Control.

464* Проблема с сетью или прокси: брандмауэр или прокси может блокировать исходящий запрос HTTPS. Remote Control требует доступа к API Anthropic на порту 443.486* Проблема с сетью или прокси: брандмауэр или прокси может блокировать исходящий HTTPS запрос. Remote Control требует доступа к API Anthropic на порту 443.

465* Ошибка создания сеанса: если вы также видите `Session creation failed — see debug log`, ошибка произошла ранее в процессе настройки. Проверьте, что ваша подписка активна.487* Ошибка создания сеанса: если вы также видите `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 488

469<h3 id="couldn’t-reconnect-to-your-remote-control-session">489<h3 id="couldnt-reconnect-to-your-remote-control-session">

470 "Couldn't reconnect to your Remote Control session"490 "Couldn't reconnect to your Remote Control session"

471</h3>491</h3>

472 492

473Когда вы возобновляете разговор с `claude --resume` или `claude --continue`, Claude Code переподключается к сеансу Remote Control, записанному в этом разговоре. Это сообщение означает, что переподключение не удалось по причине, которая может быть временной, такой как сетевой сбой или ошибка сервера, поэтому Claude Code не может подтвердить, существует ли удалённый сеанс.493Когда вы возобновляете разговор с `claude --resume` или `claude --continue`, Claude Code переподключается к сеансу Remote Control, записанному в этом разговоре. Это сообщение означает, что переподключение не удалось по причине, которая может быть временной, такой как сетевой сбой или ошибка сервера, поэтому Claude Code не может подтвердить, существует ли удалённый сеанс.

474 494

475Запустите `/remote-control` для повторной попытки подключения, или начните новый сеанс с `claude --remote-control` для создания нового сеанса Remote Control. Ваш локальный сеанс продолжает работать без Remote Control в то же время.495Запустите `/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 496

488<h3 id="previous-session-is-unavailable">497<h3 id="previous-session-is-unavailable">

489 "Previous session is unavailable — run /remote-control to start a new one"498 "Previous session is unavailable — run /remote-control to start a new one"

490</h3>499</h3>

491 500

492Claude Code не смог восстановить предыдущий сеанс Remote Control и остановился вместо того, чтобы запустить новый самостоятельно. Вы можете увидеть это сообщение после возобновления разговора с `claude --resume` или `claude --continue`, или после того как Claude Code [переподключается самостоятельно после отключения](/docs/ru/errors#remote-control-couldnt-refresh-your-login).501Claude Code не смог восстановить предыдущий сеанс Remote Control и остановился вместо того, чтобы запустить новый самостоятельно. Вы можете увидеть это сообщение после возобновления разговора с `claude --resume` или `claude --continue`, или после того, как Claude Code [переподключится самостоятельно после отключения](/docs/ru/errors#remote-control-couldnt-refresh-your-login).

493 502

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 оставляет более ранние сообщения разговора вне нового сеанса.503Запустите `/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 504

498<h3 id="remote-control-got-an-unexpected-server-response">505<h3 id="remote-control-got-an-unexpected-server-response">

499 "Remote Control got an unexpected server response"506 "Remote Control got an unexpected server response"

500</h3>507</h3>

501 508

502Сервер Remote Control принял запрос, но ответил в форме, которую эта версия Claude Code не смогла прочитать, при создании удалённого сеанса или получении его учётных данных. Повторная попытка на той же версии не удаётся таким же образом. Запустите `claude update`, а затем запустите `/remote-control` для переподключения. Это сообщение было добавлено в версии 2.1.225.509Сервер Remote Control принял запрос, но ответил в форме, которую эта версия Claude Code не смогла прочитать, при создании удалённого сеанса или получении его учётных данных. Повторная попытка на той же версии не удаётся таким же образом. Запустите `claude update`, затем запустите `/remote-control` для переподключения.

503 510

504<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">511<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"512 "Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"

506</h3>513</h3>

507 514

508Ваша организация имеет включённые [Trusted Devices](#trusted-devices) и эта машина ещё не зарегистрирована. Запустите `/login` в Claude Code. Регистрация происходит как часть входа, и нет отдельной команды регистрации.515Ваша организация имеет включённый [Trusted Devices](#trusted-devices) и эта машина ещё не зарегистрирована. Запустите `/login` в Claude Code. Регистрация происходит как часть входа, и нет отдельной команды регистрации.

509 516

510<h3 id="session-expired-for-trusted-device-check">517<h3 id="session-expired-for-trusted-device-check">

511 "session expired for trusted-device check"518 "session expired for trusted-device check"

513 520

514Ваш вход старше 18 часов. Запустите `/login` в Claude Code, или подтвердите с помощью Face ID, Touch ID, Windows Hello или passkey, когда claude.ai или мобильное приложение вас попросит. Смотрите [Trusted Devices](#trusted-devices).521Ваш вход старше 18 часов. Запустите `/login` в Claude Code, или подтвердите с помощью Face ID, Touch ID, Windows Hello или passkey, когда claude.ai или мобильное приложение вас попросит. Смотрите [Trusted Devices](#trusted-devices).

515 522

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">523<h2 id="related-resources">

532 Связанные ресурсы524 Связанные ресурсы

533</h2>525</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 +29 −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

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-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 +3 −2

Details

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)

settings-reference.md +339 −161

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

1139 1194

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.1195Запись в `options` также может нести необязательную строку `behavesAs` рядом с её `model`, что требует v2.1.257 или позже. Установите её на ID модели, которую ваша версия Claude Code уже знает, такой как `claude-opus-4-8`, на запись, чей `model` новее, чем ваша версия. Claude Code затем применяет возможности этой известной модели и значения по умолчанию effort к записи вместо обработки её модели как неизвестной. Метка записи и ID модели, которые Claude Code отправляет в запросах, не меняются.

1141 1196

1142Список [`availableModels`](#availablemodels) всё ещё применяется к этим строкам. Прежде чем добавить перечисленную модель в список разрешений, прочитайте [Поведение объединения](/docs/ru/model-config#merge-behavior): конкретный ID модели сужает запись подстановочного знака своего семейства. 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.

1198

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

1649 `permissions.defaultMode`1706 `permissions.defaultMode`

1650</h3>1707</h3>

1651 1708

1652Установите [режим разрешений](/docs/ru/permission-modes), в котором начинаются новые сеансы. Когда вы оставляете его не установленным, сеансы начинаются в [встроенном по умолчанию](/docs/ru/permission-modes#which-mode-a-session-starts-in) для вашего плана и поверхности.1709Установите [режим разрешений](/docs/ru/permission-modes), в котором начинаются новые сеансы. Когда вы оставляете его не установленным, сеансы начинаются в [встроенном по умолчанию](/docs/ru/permission-modes#which-mode-a-session-starts-in) для вашей поверхности.

1653 1710

1654* **Область**: [`Any file`](#scopes). `auto` и `bypassPermissions` не вступают в силу из параметров проекта или локальных, поэтому установите их в `~/.claude/settings.json` вместо этого. До версии 2.1.257 `bypassPermissions` вступал в силу из любого файла. Для разговоров, которые запускает расширение VS Code, Claude Code читает только значения пользователя, управляемые и `--settings`.1711* **Область**: [`Any file`](#scopes). `auto` и `bypassPermissions` не вступают в силу из параметров проекта или локальных, поэтому установите их в `~/.claude/settings.json` вместо этого. До версии 2.1.257 `bypassPermissions` вступал в силу из любого файла. Для разговоров, которые запускает расширение VS Code, Claude Code читает только значения пользователя, управляемые и `--settings`.

1655* **Тип**: строка, одна из:1712* **Тип**: строка, одна из:

3017* [`CLAUDE_CODE_MESSAGING_SOCKET` и `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/ru/env-vars#variables), которые Claude Code экспортирует сам, игнорируются из каждого файла. Игнорирование переменной сокета требует Claude Code v2.1.224 или позже, а игнорирование токена требует v2.1.228 или позже.3074* [`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 или позже.3075* [`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 читает только из среды запуска, игнорируется из каждого файла.3076* [`CLAUDE_CODE_RESTRICTED`](/docs/ru/env-vars#variables), которую Claude Code читает только из среды запуска, игнорируется из каждого файла.

3077* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/ru/env-vars#variables), которую Claude Code читает только из среды запуска, игнорируется из каждого файла. Переменная требует Claude Code v2.1.283 или позже.

3078* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` и `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`](/docs/ru/env-vars#variables), которые Claude Code читает только из среды запуска, игнорируются из каждого файла.

3020 3079

3021<h3 id="filecheckpointingenabled">3080<h3 id="filecheckpointingenabled">

3022 `fileCheckpointingEnabled`3081 `fileCheckpointingEnabled`

3416* **Тип**: строка, `"classic"` или `"readline"`3475* **Тип**: строка, `"classic"` или `"readline"`

3417* **По умолчанию**: не установлено3476* **По умолчанию**: не установлено

3418 3477

3478<h3 id="maxprosewidth">

3479 `maxProseWidth`

3480</h3>

3481

3482Ограничьте ширину прозы в ответах Claude, чтобы строки оставались читаемыми в широком терминале. Абзацы, заголовки, списки и блокировки цитат переносятся в пределах этого количества столбцов, в то время как таблицы и блоки кода сохраняют полную ширину терминала. Требуется Claude Code v2.1.282 или позже.

3483

3484* **Область действия**: [`Любой файл`](#scopes)

3485* **Тип**: количество столбцов терминала, целое число, минимум `40`. Claude Code игнорирует любое другое значение

3486* **По умолчанию**: не установлено, поэтому проза переносится на край терминала

3487

3488```json settings.json theme={null}

3489{

3490 "maxProseWidth": 80

3491}

3492```

3493

3419<h3 id="prefersreducedmotion">3494<h3 id="prefersreducedmotion">

3420 `prefersReducedMotion`3495 `prefersReducedMotion`

3421</h3>3496</h3>

4090 4165

4091* **Область действия**: [`Any file`](#scopes)4166* **Область действия**: [`Any file`](#scopes)

4092* **Тип**: строка4167* **Тип**: строка

4093* **По умолчанию**: не установлено, поэтому Claude Code добавляет `Co-Authored-By: <name> <noreply@anthropic.com>`. Имя — это активная модель сеанса, такая как `Claude Sonnet 5`.4168* **По умолчанию**: не установлено, поэтому Claude Code добавляет `Co-Authored-By: <name> <noreply@anthropic.com>`. Имя — это модель в использовании при создании коммита, такая как `Claude Sonnet 5`. Когда [subagent](/docs/ru/sub-agents) создает коммит, trailer указывает модель subagent'а.

4094 * Когда Claude Code распознает модель как модель Claude, но не может подтвердить её точную версию, он пишет только `Claude`.4169 * Когда Claude Code распознает модель как модель Claude, но не может подтвердить её точную версию, он пишет только `Claude`.

4095 * Когда он не может сопоставить ID модели с какой-либо моделью Claude, такой как модель третьей стороны, обслуживаемая через пользовательский [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars), он пишет `Claude Code`.4170 * Когда он не может сопоставить ID модели с какой-либо моделью Claude, такой как модель третьей стороны, обслуживаемая через пользовательский [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars), он пишет `Claude Code`.

4096 4171

5690* **Type**: Boolean5765* **Type**: Boolean

5691 * `true`: Claude Code подключает Удалённое управление автоматически, когда начинается каждый интерактивный сеанс5766 * `true`: Claude Code подключает Удалённое управление автоматически, когда начинается каждый интерактивный сеанс

5692 * `false`: Claude Code ждёт `/remote-control`5767 * `false`: Claude Code ждёт `/remote-control`

5693* **Default**: не установлено, поэтому автоподключение следует стандартному значению администратора вашей организации, когда оно установлено, и в противном случае текущему стандартному значению Claude Code5768* **Default**: не установлено, поэтому применяется [автоподключение по умолчанию](/docs/ru/remote-control#enable-remote-control-for-all-sessions)

5694* **Per-session overrides**: `--remote-control` включает Удалённое управление для одного сеанса даже когда этот ключ `false`, и ни один флаг не отключает его для одного сеанса5769* **Per-session overrides**: `--remote-control` включает Удалённое управление для одного сеанса даже когда этот ключ `false`, и ни один флаг не отключает его для одного сеанса

5695 5770

5696```json settings.json theme={null}5771```json settings.json theme={null}

5842 5917

5843Установите URL шлюза, к которому подключается экран `/login` облачного шлюза, чтобы люди достигли вашего [облачного шлюза](/docs/ru/claude-apps-gateway) без ввода его адреса. На экране нет поля URL: с установленным этим ключом он показывает URL вашего шлюза и подключается, когда человек нажимает Enter; без него он говорит им связаться с администратором IT.5918Установите URL шлюза, к которому подключается экран `/login` облачного шлюза, чтобы люди достигли вашего [облачного шлюза](/docs/ru/claude-apps-gateway) без ввода его адреса. На экране нет поля URL: с установленным этим ключом он показывает URL вашего шлюза и подключается, когда человек нажимает Enter; без него он говорит им связаться с администратором IT.

5844 5919

5845Либо этот ключ, либо `forceLoginMethod: "gateway"` делает машину только шлюзом, поэтому `/login` открывается на экране облачного шлюза без средства выбора метода входа. См. [Политика администратора требует вход через облачный шлюз](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in) для того, что происходит с оставшимся входом первой стороны или API ключом. Установите оба ключа, чтобы экран подключился вместо показа ошибки.5920Либо этот ключ, либо `forceLoginMethod: "gateway"` делает машину только шлюзом, за исключением сеансов, которые выбирают облачного поставщика с помощью `CLAUDE_CODE_USE_*`. `/login` затем открывается на экране облачного шлюза без средства выбора метода входа. См. [Политика администратора требует вход через облачный шлюз](/docs/ru/errors#administrator-policy-requires-a-cloud-gateway-sign-in) для того, что происходит с оставшимся входом первой стороны или API ключом. Установите оба ключа, чтобы экран подключился вместо показа ошибки.

5846 5921

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.5922* **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 scheme5923* **Type**: string, a full URL including the scheme

5934}6009}

5935```6010```

5936 6011

5937Установите интервал обновления с помощью [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/docs/ru/env-vars). См. [Динамические заголовки](/docs/ru/monitoring-usage#dynamic-headers) для требований скрипта и где Claude Code сообщает о неудачном помощнике.6012Установите интервал обновления с помощью [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/docs/ru/env-vars). См. [Динамические заголовки](/docs/ru/monitoring-usage#dynamic-headers) для требований скрипта и что происходит, когда помощник не работает.

5938 6013

5939<h2 id="updates-and-versioning">6014<h2 id="updates-and-versioning">

5940 Обновления и версионирование6015 Обновления и версионирование

6095 `cleanupPeriodDays`6170 `cleanupPeriodDays`

6096</h3>6171</h3>

6097 6172

6098Установите, сколько дней Claude Code хранит [стенограммы сеансов и другие данные приложения](/docs/ru/claude-directory#cleaned-up-automatically) перед их удалением. Claude Code выполняет удаление как фоновую очистку после запуска сеанса, при условии, что он может безопасно определить период хранения.6173Установите, сколько дней Claude Code хранит [стенограммы сеансов и другие данные приложения](/docs/ru/claude-directory#cleaned-up-automatically) перед их удалением. Claude Code выполняет удаление как фоновую очистку после запуска сеанса, при условии, что он может безопасно определить период хранения. Очистка удаляет стенограммы без отображения сообщения, поэтому сеанс, который вы не использовали дольше, чем период хранения, больше не появляется в средстве выбора [`/resume`](/docs/ru/sessions#resume-a-session).

6099 6174

6100* **Область**: [`Any file`](#scopes)6175* **Область**: [`Any file`](#scopes)

6101* **Тип**: количество дней, целое число, минимум `1`6176* **Тип**: количество дней, целое число, минимум `1`

6439 `wslInheritsWindowsSettings`6514 `wslInheritsWindowsSettings`

6440</h3>6515</h3>

6441 6516

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 для записи.6517Заставьте 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 6518

6444* **Область**: [`Managed`](#scopes). В источнике Windows, управляемом администратором.6519* **Область**: [`Managed`](#scopes). В источнике Windows, управляемом администратором.

6445* **Тип**: Boolean6520* **Тип**: 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)6521 * `true`: Claude Code на WSL читает управляемые параметры из цепи политики Windows, и читает `/etc/claude-code` только когда нет документа администратора Windows

6447 * `false`: WSL читает только `/etc/claude-code`6522 * `false`: WSL читает только `/etc/claude-code`

6448* **По умолчанию**: `false`, поэтому WSL читает только `/etc/claude-code`6523* **По умолчанию**: `false`, поэтому WSL читает только `/etc/claude-code`

6449 6524

6453}6528}

6454```6529```

6455 6530

6456Как только источник администратора включает цепь, политика HKCU присоединяется к ней на WSL только когда HKCU также устанавливает ключ на `true`. Эта копия не включает цепь сама по себе. Источник Windows, который содержит только этот ключ, не считается источником политики, поэтому источник с более низким приоритетом все еще поставляет политику. Этот ключ не имеет эффекта на нативный Windows.6531Как только источник администратора включает цепь, политика HKCU присоединяется к ней на WSL только когда HKCU также устанавливает ключ на `true`. Эта копия не включает цепь сама по себе. Источник Windows, который содержит только этот ключ, установленный на `true` или `false`, не считается источником политики, поэтому источник с более низким приоритетом все еще поставляет политику. Этот ключ не имеет эффекта на нативный Windows.

6532

6533Claude 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 6534

6458<h2 id="global-config-settings">6535<h2 id="global-config-settings">

6459 Глобальные параметры конфигурации6536 Глобальные параметры конфигурации

6503 6580

6504Claude Code игнорирует этот ключ в `settings.json`.6581Claude Code игнорирует этот ключ в `settings.json`.

6505 6582

6583<h3 id="claudeinchromedefaultenabled">

6584 `claudeInChromeDefaultEnabled`

6585</h3>

6586

6587Запускайте каждый интерактивный сеанс 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**.

6588

6589* **Scope**: [`Global config`](#scopes)

6590* **Type**: Boolean

6591 * `true`: Claude Code включает интеграцию Chrome при запуске интерактивного сеанса CLI, как это происходит при передаче `--chrome`

6592 * `false`: интерактивные сеансы CLI запускаются с отключенной интеграцией Chrome, и Claude Code прекращает [предлагать ее настройку](/docs/ru/chrome#install-the-extension-when-claude-asks). Передайте `--chrome`, чтобы включить его для одного интерактивного сеанса

6593* **Default**: unset, поэтому интеграция Chrome отключена и Claude Code все еще может предложить ее настройку

6594* **Per-session overrides**: `--chrome` и [`--no-chrome`](/docs/ru/cli-reference) имеют приоритет над этим ключом для одного интерактивного сеанса

6595

6596```json ~/.claude.json theme={null}

6597{

6598 "claudeInChromeDefaultEnabled": true

6599}

6600```

6601

6602Claude Code игнорирует этот ключ в `settings.json`.

6603

6604<h3 id="copyfullresponse">

6605 `copyFullResponse`

6606</h3>

6607

6608Делайте так, чтобы [`/copy`](/docs/ru/commands) копировала полный ответ каждый раз, без средства выбора, которое оно иначе показывает, когда ответ содержит блоки кода. Выбор **Always copy full response** в этом средстве выбора устанавливает этот ключ на `true`. Отображается в `/config` как **Skip the /copy picker**.

6609

6610* **Scope**: [`Global config`](#scopes)

6611* **Type**: Boolean

6612 * `true`: `/copy` копирует полный ответ без показа средства выбора

6613 * `false`: когда ответ содержит блоки кода, `/copy` показывает средство выбора, где вы выбираете один блок кода или полный ответ

6614* **Default**: `false`

6615

6616```json ~/.claude.json theme={null}

6617{

6618 "copyFullResponse": true

6619}

6620```

6621

6622Claude Code игнорирует этот ключ в `settings.json`.

6623

6506<h3 id="copyonselect">6624<h3 id="copyonselect">

6507 `copyOnSelect`6625 `copyOnSelect`

6508</h3>6626</h3>

6523 6641

6524Claude Code игнорирует этот ключ в `settings.json`.6642Claude Code игнорирует этот ключ в `settings.json`.

6525 6643

6644<h3 id="defaulttoagentsview">

6645 `defaultToAgentsView`

6646</h3>

6647

6648Открывайте [представление агента](/docs/ru/agent-view) вместо нового разговора при запуске `claude` без аргументов. Отображается в `/config` как **Open agents view by default**, если представление агента не [отключено](#disableagentview).

6649

6650* **Scope**: [`Global config`](#scopes)

6651* **Type**: Boolean

6652 * `true`: `claude` без аргументов открывает представление агента, если представление агента не [отключено](#disableagentview)

6653 * `false`: `claude` без аргументов запускает новый разговор

6654* **Default**: `false`

6655

6656```json ~/.claude.json theme={null}

6657{

6658 "defaultToAgentsView": true

6659}

6660```

6661

6662Claude Code игнорирует этот ключ в `settings.json`.

6663

6526<h3 id="difftool">6664<h3 id="difftool">

6527 `diffTool`6665 `diffTool`

6528</h3>6666</h3>

6577 6715

6578Claude Code игнорирует этот ключ в `settings.json`.6716Claude Code игнорирует этот ключ в `settings.json`.

6579 6717

6718<h3 id="leftarrowopensagents">

6719 `leftArrowOpensAgents`

6720</h3>

6721

6722Нажимайте `←` на пустой подсказке, чтобы [отправить сеанс в фоновый режим и открыть представление агента](/docs/ru/agent-view#switch-sessions-without-leaving-the-terminal). Установите этот ключ на `false`, чтобы отключить сочетание клавиш. Отображается в `/config` как **← opens agents**, когда представление агента доступно.

6723

6724* **Scope**: [`Global config`](#scopes)

6725* **Type**: Boolean

6726 * `true`: нажатие `←` на пустой подсказке в сеансе, который вы запустили в терминале, отправляет его в фоновый режим и открывает представление агента

6727 * `false`: Claude Code отключает сочетание клавиш; в сеансе, который вы [присоединили из представления агента](/docs/ru/agent-view#attach-to-a-session), `←` на пустой подсказке все еще отсоединяет

6728* **Default**: `true`

6729

6730```json ~/.claude.json theme={null}

6731{

6732 "leftArrowOpensAgents": false

6733}

6734```

6735

6736Claude Code игнорирует этот ключ в `settings.json`.

6737

6580<h3 id="permissionexplainerenabled">6738<h3 id="permissionexplainerenabled">

6581 `permissionExplainerEnabled`6739 `permissionExplainerEnabled`

6582</h3>6740</h3>

6591* **Type**: Boolean6749* **Type**: Boolean

6592* **Default**: `true`6750* **Default**: `true`

6593 6751

6752<h3 id="prstatusfooterenabled">

6753 `prStatusFooterEnabled`

6754</h3>

6755

6756Показывайте значок в нижнем колонтитуле подсказки для открытого запроса на слияние или запроса на объединение текущей ветви с цветной подчеркиванием, которое показывает его [статус](/docs/ru/interactive-mode#pr-review-status). Отображается в `/config` как **Show PR status footer**.

6757

6758* **Scope**: [`Global config`](#scopes)

6759* **Type**: Boolean

6760 * `true`: нижний колонтитул показывает значок при условиях в [PR review status](/docs/ru/interactive-mode#pr-review-status)

6761 * `false`: Claude Code пропускает проверку запроса на слияние и запроса на объединение нижнего колонтитула и не показывает этот значок. Сеанс, который вы [присоединили из представления агента](/docs/ru/agent-view#attach-to-a-session), все еще может показать простую ссылку на запрос на слияние [связанный с ним](/docs/ru/agent-view#pull-request-status)

6762* **Default**: `true`

6763

6764```json ~/.claude.json theme={null}

6765{

6766 "prStatusFooterEnabled": false

6767}

6768```

6769

6770Claude Code игнорирует этот ключ в `settings.json`.

6771

6594<h3 id="teammatedefaultmodel">6772<h3 id="teammatedefaultmodel">

6595 `teammateDefaultModel`6773 `teammateDefaultModel`

6596</h3>6774</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 +2 −2

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 |

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 +41 −18

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) для деталей.

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 получит путь активного файла только при наличии выделенного текста в нём.

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 +3 −3

Details

62Когда вы выходите из интерактивного сеанса worktree, Claude проверяет worktree на наличие работы, которая будет удалена при удалении: изменённые или неотслеживаемые файлы, незафиксированная работа внутри проверенных подмодулей и новые коммиты.62Когда вы выходите из интерактивного сеанса worktree, Claude проверяет worktree на наличие работы, которая будет удалена при удалении: изменённые или неотслеживаемые файлы, незафиксированная работа внутри проверенных подмодулей и новые коммиты.

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 06:57 UTC