SpyBara
Go Premium

Documentation 2026-09-29 23:58 UTC to 2026-09-30 06:58 UTC

49 files changed +519 −188. View all changes and history on the product overview
2026
Wed 30 06:58 Tue 29 23:58 Mon 28 22:59 Fri 25 23:58 Thu 24 22:57 Wed 23 23:57 Tue 22 23:59 Mon 21 22:59 Sun 20 23:59 Sat 19 23:57 Fri 18 23:58 Tue 15 23:58 Mon 14 22:58 Sun 13 21:00 Sat 12 03:02 Thu 10 23:00 Wed 9 22:58 Tue 8 20:00 Tue 1 21:02

agent-view.md +28 −2

Details

64 </Step>64 </Step>

65</Steps>65</Steps>

66 66 

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

68 

69Внутри обычного сеанса `claude` подсказка в нижнем колонтитуле `←` показывает количество фоновых агентов, которые ждут вас, например `← 2 agents`, и возвращается к `← for agents`, когда никто не требует ввода. Количество выше 99 отображается как `99+`. Количество обновляется примерно каждые десять секунд, пока терминал в фокусе, и немедленно, когда фокус возвращается. Оно кратко меняет цвет при изменении и при завершении агента, и когда фоновый сеанс завершается, пока никто не требует вашего ввода, оно кратко показывает количество завершённых, например `← 2 done`. Обе вспышки отключены, когда параметр [`prefersReducedMotion`](/docs/ru/settings-reference#prefersreducedmotion) включен, и подсказка скрыта в [режиме чтения с экрана](/docs/ru/accessibility).67Внутри обычного сеанса `claude` подсказка в нижнем колонтитуле `←` показывает количество фоновых агентов, которые ждут вас, например `← 2 agents`, и возвращается к `← for agents`, когда никто не требует ввода. Количество выше 99 отображается как `99+`. Количество обновляется примерно каждые десять секунд, пока терминал в фокусе, и немедленно, когда фокус возвращается. Оно кратко меняет цвет при изменении и при завершении агента, и когда фоновый сеанс завершается, пока никто не требует вашего ввода, оно кратко показывает количество завершённых, например `← 2 done`. Обе вспышки отключены, когда параметр [`prefersReducedMotion`](/docs/ru/settings-reference#prefersreducedmotion) включен, и подсказка скрыта в [режиме чтения с экрана](/docs/ru/accessibility).

70 68 

69<h3 id="open-agent-view-by-default">

70 Открыть agent view по умолчанию

71</h3>

72 

73Чтобы `claude` без аргументов открывал agent view вместо новой беседы, включите параметр `/config`.

74 

75<Steps>

76 <Step title="Включить параметр">

77 В обычном сеансе `claude` запустите `/config` и включите **Open agents view by default**. Чтобы пропустить меню, установите ключ [`defaultToAgentsView`](/docs/ru/settings-reference#defaulttoagentsview) напрямую:

78 

79 ```text theme={null}

80 /config defaultToAgentsView=true

81 ```

82 </Step>

83 

84 <Step title="Запустить Claude Code">

85 Выйдите из сеанса, затем запустите `claude` без аргументов:

86 

87 ```bash theme={null}

88 claude

89 ```

90 

91 Agent view открывается вместо новой беседы.

92 </Step>

93</Steps>

94 

95Чтобы запустить обычный сеанс, пока параметр включен, передайте подсказку: `claude "fix the login test"`. Чтобы отключить параметр, запустите `/config defaultToAgentsView=false` в обычном сеансе или в сеансе, к которому вы подключаетесь из agent view.

96 

71<h2 id="monitor-sessions-with-agent-view">97<h2 id="monitor-sessions-with-agent-view">

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

73</h2>99</h2>

Details

482 482 

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

484 484 

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

486 486 

487<h2 id="service-tiers">487<h2 id="service-tiers">

488 Уровни обслуживания488 Уровни обслуживания

artifacts.md +11 −11

Details

100Кого вы можете добавить в общий доступ, зависит от вашего плана:100Кого вы можете добавить в общий доступ, зависит от вашего плана:

101 101 

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

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

104 104 

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

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


122 Собирайте комментарии к артефакту122 Собирайте комментарии к артефакту

123</h2>123</h2>

124 124 

125Когда вы делитесь артефактом в пределах вашей организации, люди, с которыми вы им делитесь, могут оставлять комментарии на странице, и вы можете попросить Claude прочитать эти комментарии и ответить на них. Вам нужна Claude Code версии 2.1.221 или более поздней и план Team или Enterprise, потому что только артефакт, который вы [делите в пределах вашей организации](#share-an-artifact), получает комментарии. Claude читает комментарии в двух случаях:125Когда вы делитесь артефактом в пределах вашей организации, люди, с которыми вы им делитесь, могут оставлять комментарии на странице, и вы можете попросить Claude прочитать эти комментарии и ответить на них. Вам нужна Claude Code версии 2.1.221 или более поздней. Claude читает комментарии в двух случаях:

126 126 

127* **Вы просите Claude прочитать их**: дайте Claude URL артефакта и попросите комментарии. Claude перечисляет каждый тред и отмечает комментарии, которые отправил ему кто-то, кто может редактировать артефакт.127* **Вы просите Claude прочитать их**: дайте Claude URL артефакта и попросите комментарии. Claude перечисляет каждый тред и отмечает комментарии, которые отправил ему кто-то, кто может редактировать артефакт.

128* **Кто-то, кто может редактировать артефакт, отправляет комментарий Claude**: в треде на странице они отправляют комментарий с помощью **Send to Claude**, или упоминают `@claude` в нём. В любом случае они активируют тред.128* **Кто-то, кто может редактировать артефакт, отправляет комментарий Claude**: в треде на странице они отправляют комментарий с помощью **Send to Claude**, или упоминают `@claude` в нём. В любом случае они активируют тред.

129 129 

130Claude может ответить или разрешить только активированный тред. Другие треды остаются открытыми до тех пор, пока человек не разрешит их на странице. Зрители видят каждый ответ, приписываемый Claude, через вас.130Claude может ответить или разрешить только активированный тред. Другие треды остаются открытыми до тех пор, пока человек не разрешит их на странице. Зрители видят каждый ответ, приписываемый Claude, через вас.

131 131 

132Если вы делитесь артефактом публично, зрители не могут комментировать его: на странице написано `Comments aren't available while this Artifact is shared publicly.` Чтобы переключить артефакт, который уже имеет треды комментариев, на публичную ссылку, сначала удалите треды.132Если вы делитесь артефактом публично, люди, чей единственный доступ — это публичная ссылка, не видят его комментарии и не могут добавлять их. Существующие треды комментариев остаются на артефакте, и вы и его редакторы по-прежнему можете читать и отвечать на них.

133 133 

134Чтобы попросить комментарии самостоятельно, дайте Claude URL:134Чтобы попросить комментарии самостоятельно, дайте Claude URL:

135 135 


195 195 

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

197 197 

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

199 199 

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

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

202</h3>202</h3>

203 203 

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

205 205 

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

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


375 375 

376| Requirement | Available when |376| Requirement | Available when |

377| :- | :- |377| :- | :- |

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

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

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

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


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

409</h2>409</h2>

410 410 

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

412 412 

413<h3 id="enable-or-disable-artifacts">413<h3 id="enable-or-disable-artifacts">

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

415</h3>415</h3>

416 416 

417Чтобы включить или отключить артефакты для всей организации, перейдите в [**Параметры > Claude Code > Возможности**](https://claude.ai/admin-settings/claude-code) и используйте переключатель **Артефакты**. На планах Enterprise с управлением доступом на основе ролей вы можете дополнительно ограничить артефакты определёнными ролями: перейдите в [**Параметры > Роли**](https://claude.ai/admin-settings/roles), отредактируйте роль и установите разрешение **Артефакты** в группе **Claude Code**.417Чтобы включить или отключить артефакты для всей организации, перейдите в [**Organization settings > Artifacts**](https://claude.ai/admin-settings/artifacts) и используйте переключатель **Artifacts**. На планах Enterprise с управлением доступом на основе ролей вы можете дополнительно ограничить артефакты определёнными ролями: перейдите в [**Organization settings > Roles**](https://claude.ai/admin-settings/roles), отредактируйте роль и установите разрешение **Artifacts**.

418 418 

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

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

421</h3>421</h3>

422 422 

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

424 424 

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

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

427</h3>427</h3>

428 428 

429Публичное совместное использование отключено по умолчанию на планах Team и Enterprise, поэтому члены могут совместно использовать артефакты только внутри организации, пока владелец его не включит. Чтобы позволить членам публиковать артефакты на публичные ссылки, которые может просматривать любой без входа, перейдите в **Параметры > Claude Code > Возможности** и включите **Внешнее совместное использование** под переключателем **Артефакты**. Отключение его обратно блокирует доступ через существующие публичные ссылки без изменения аудитории каждого артефакта; доступ возобновляется, если вы его снова включите.429Публичное совместное использование отключено по умолчанию на планах Team и Enterprise. Чтобы позволить членам публиковать артефакты на публичные ссылки, которые может просматривать любой без входа, перейдите в [**Organization settings > Artifacts**](https://claude.ai/admin-settings/artifacts) и включите **External sharing** под переключателем **Artifacts**. Отключение его обратно блокирует доступ через существующие публичные ссылки без изменения аудитории каждого артефакта; доступ возобновляется, если вы его снова включите.

430 430 

431<h3 id="set-a-retention-policy">431<h3 id="set-a-retention-policy">

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

433</h3>433</h3>

434 434 

435Чтобы установить, как долго артефакты хранятся перед автоматическим удалением, перейдите в [**Параметры > Элементы управления данными и конфиденциальностью**](https://claude.ai/admin-settings/data-privacy-controls). Вы можете установить отдельные периоды хранения для артефактов, которые остаются приватными для их автора, и артефактов, которые были общими.435Чтобы установить, как долго артефакты хранятся перед автоматическим удалением, перейдите в [**Organization settings > Data and privacy**](https://claude.ai/admin-settings/data-privacy-controls). Вы можете установить отдельные периоды хранения для артефактов, которые остаются приватными для их автора, и артефактов, которые были совместно использованы.

436 436 

437<h3 id="review-the-audit-log">437<h3 id="review-the-audit-log">

438 Проверка журнала аудита438 Проверка журнала аудита

Details

163 Полезная нагрузка поступает в контекст Claude как тег `<channel>`:163 Полезная нагрузка поступает в контекст Claude как тег `<channel>`:

164 164 

165 ```text theme={null}165 ```text theme={null}

166 <channel source="webhook" path="/" method="POST">build failed on main: https://ci.example.com/run/1234</channel>166 <channel source="webhook" path="/" method="POST">

167 build failed on main: https://ci.example.com/run/1234

168 </channel>

167 ```169 ```

168 170 

169 Ваш терминал отображает событие как однострочное резюме, `← webhook: build failed on main: https://ci.example.com/run/1234`, а не как необработанный тег. Затем вы увидите, как Claude начинает отвечать: читая файлы, выполняя команды или что-то ещё, что требует сообщение. Это односторонний канал, поэтому Claude действует в вашей сессии, но ничего не отправляет обратно через webhook. Чтобы добавить ответы, см. [Expose a reply tool](#expose-a-reply-tool).171 Ваш терминал отображает событие как однострочное резюме, `← webhook: build failed on main: https://ci.example.com/run/1234`, а не как необработанный тег. Затем вы увидите, как Claude начинает отвечать: читая файлы, выполняя команды или что-то ещё, что требует сообщение. Это односторонний канал, поэтому Claude действует в вашей сессии, но ничего не отправляет обратно через webhook. Чтобы добавить ответы, см. [Expose a reply tool](#expose-a-reply-tool).

Details

362 362 

363Машины, которые только запускают Claude Desktop, нуждаются в нём. Claude Desktop применяет список моделей и список отключённых инструментов к встроенным сеансам сам, но список разрешённых исходящих соединений достигает их только как родительские параметры, в форме правил доменов `WebFetch` и правил сетевой изоляции. Без согласия эти сеансы работают без ограничения исходящих соединений, и ничто вас не предупредит. Шлюз по-прежнему отклоняет запросы вывода для моделей, которые политика не предоставляет.363Машины, которые только запускают Claude Desktop, нуждаются в нём. Claude Desktop применяет список моделей и список отключённых инструментов к встроенным сеансам сам, но список разрешённых исходящих соединений достигает их только как родительские параметры, в форме правил доменов `WebFetch` и правил сетевой изоляции. Без согласия эти сеансы работают без ограничения исходящих соединений, и ничто вас не предупредит. Шлюз по-прежнему отклоняет запросы вывода для моделей, которые политика не предоставляет.

364 364 

365Список разрешённых маркетплейсов плагинов также достигает встроенных сеансов только как родительские параметры. Когда вы отключаете пользовательские маркетплейсы плагинов в управляемой конфигурации Claude Desktop, Claude Desktop 2.16120.0 или позже скрывает маркетплейсы, которые ваша организация не предоставила, и отказывает в установках из них. Чтобы остановить встроенные сеансы от загрузки плагинов, уже установленных из этих маркетплейсов, он отправляет им список `strictKnownMarketplaces` как родительские параметры. Без согласия Claude Code игнорирует этот список, и эти плагины продолжают загружаться.

366 

365Машины, где разработчики входят через `/login`, не нуждаются в нём; каждый сеанс Claude Code получает свою политику из шлюза.367Машины, где разработчики входят через `/login`, не нуждаются в нём; каждый сеанс Claude Code получает свою политику из шлюза.

366 368 

367Флоты, чьи [`policyHelper`](/docs/ru/settings-reference#policyhelper) предоставляют управляемые параметры, не могут использовать это: Claude Code никогда не объединяет родительские параметры на этих флотах, потому что он читает управляемые параметры только из выходных данных помощника.369Флоты, чьи [`policyHelper`](/docs/ru/settings-reference#policyhelper) предоставляют управляемые параметры, не могут использовать это: Claude Code никогда не объединяет родительские параметры на этих флотах, потому что он читает управляемые параметры только из выходных данных помощника.


457* **`forceLoginOrgUUID`**: Claude Code соблюдает значение, предоставленное родителем, когда источник администратора с наивысшим приоритетом не устанавливает UUID организации. Вход в шлюз не проверяет этот ключ. UUID организации в источнике администратора с наивысшим приоритетом блокирует значение родителя и является тем, который Claude Code применяет.459* **`forceLoginOrgUUID`**: Claude Code соблюдает значение, предоставленное родителем, когда источник администратора с наивысшим приоритетом не устанавливает UUID организации. Вход в шлюз не проверяет этот ключ. UUID организации в источнике администратора с наивысшим приоритетом блокирует значение родителя и является тем, который Claude Code применяет.

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

459* **`availableModels`**: Claude Code соблюдает список моделей, предоставленный родителем, когда выигрывающий управляемый источник не устанавливает один. Если ваш флот ограничивает модели, установите `availableModels` в выигрывающем источнике.461* **`availableModels`**: Claude Code соблюдает список моделей, предоставленный родителем, когда выигрывающий управляемый источник не устанавливает один. Если ваш флот ограничивает модели, установите `availableModels` в выигрывающем источнике.

460* **`strictKnownMarketplaces`**: Claude Code соблюдает список разрешённых маркетплейсов плагинов, предоставленный родителем, когда выигрывающий управляемый источник не устанавливает один. Если ваш флот ограничивает маркетплейсы, установите `strictKnownMarketplaces` в выигрывающем источнике. Требует Claude Code v2.1.282 или позже.462* **`strictKnownMarketplaces`**: Claude Code соблюдает список разрешённых маркетплейсов плагинов, предоставленный родителем, когда выигрывающий управляемый источник не устанавливает один. Claude Desktop 2.16120.0 или позже отправляет один, когда его управляемая конфигурация отключает пользовательские маркетплейсы плагинов. Если ваш флот ограничивает маркетплейсы, установите `strictKnownMarketplaces` в выигрывающем источнике. Требует Claude Code v2.1.282 или позже.

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

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

463 465 

Details

303| - | - | - |303| - | - | - |

304| Inference (prompts, completions) | CLI → шлюз → ваш upstream | Только если API Anthropic — это настроенный upstream |304| Inference (prompts, completions) | CLI → шлюз → ваш upstream | Только если API Anthropic — это настроенный upstream |

305| Телеметрия (метрики OTLP, плюс [опциональные логи и трассировки](/docs/ru/claude-apps-gateway-config#telemetry)) | CLI → шлюз → ваш сборщик | Никогда |305| Телеметрия (метрики OTLP, плюс [опциональные логи и трассировки](/docs/ru/claude-apps-gateway-config#telemetry)) | CLI → шлюз → ваш сборщик | Никогда |

306| Идентификация (email, groups, sub) | IdP → шлюз → JWT → CLI; CLI штампует это на экспортах OTLP. Если вы включите [`forward_user_identity`](/docs/ru/claude-apps-gateway-config#per-user-identity-headers-for-a-proxy-you-run), шлюз также отправляет email разработчика и subject IdP в качестве заголовков вашему прокси | Никогда |306| Идентификация (email, groups, sub) | IdP → шлюз → CLI; CLI штампует это на экспортах OTLP. Если вы включите [`forward_user_identity`](/docs/ru/claude-apps-gateway-config#per-user-identity-headers-for-a-proxy-you-run), шлюз также отправляет email разработчика и subject IdP в качестве заголовков вашему прокси | Никогда |

307| Управляемые параметры | Ваш YAML шлюза → CLI | Никогда |307| Управляемые параметры | Ваш YAML шлюза → CLI | Никогда |

308| Журнал аудита | Stderr шлюза → ваш агрегатор | Никогда |308| Журнал аудита | Stderr шлюза → ваш агрегатор | Никогда |

309 309 

Details

514 Телеметрия514 Телеметрия

515</h2>515</h2>

516 516 

517Gateway даёт вам метрики использования на разработчика без какой-либо конфигурации OTEL на машину. Claude Code выдаёт метрики OpenTelemetry (OTLP), журналы и дополнительные трассировки; [Мониторинг использования](/docs/ru/monitoring-usage) охватывает всё, что сообщает CLI. На сессиях gateway CLI штампует каждый экспорт с аутентифицированными атрибутами идентификации IdP `user.id`, `user.email` и `user.groups`, поэтому использование накапливается на разработчика без сантехники `OTEL_RESOURCE_ATTRIBUTES`.517Gateway даёт вам метрики использования на разработчика без какой-либо конфигурации OTEL на машину. Claude Code выдаёт метрики OpenTelemetry (OTLP), журналы и дополнительные трассировки; [Мониторинг использования](/docs/ru/monitoring-usage) охватывает всё, что сообщает CLI. В сессиях, вошедших через `/login`, CLI штампует каждый экспорт с аутентифицированными атрибутами идентификации IdP `user.id`, `user.email` и `user.groups`, поэтому использование накапливается на разработчика.

518 518 

519Gateway сам является аутентифицированным реле OTLP. Установите [`telemetry.forward_to`](/docs/ru/claude-apps-gateway-config#telemetry) вместе с `listen.public_url`, и он отправляет параметры экспортера OTEL каждому подключённому клиенту и перенаправляет их трафик OTLP дословно каждому пункту назначения, который вы указываете. Каждый пункт назначения независимо выбирает метрики, журналы и трассировки, и значение по умолчанию — только метрики; см. [справочник `telemetry`](/docs/ru/claude-apps-gateway-config#telemetry) для полей на сигнал и их компромиссы чувствительности. Gateway не буферизирует, не агрегирует и не хранит телеметрию, поэтому то, где данные приземляются, полностью конфигурация экспортера сборщика.519Gateway сам является аутентифицированным реле OTLP. Установите [`telemetry.forward_to`](/docs/ru/claude-apps-gateway-config#telemetry) вместе с `listen.public_url`, и он отправляет параметры экспортера OTEL каждому подключённому клиенту и перенаправляет их трафик OTLP дословно каждому пункту назначения, который вы указываете. Каждый пункт назначения независимо выбирает метрики, журналы и трассировки, и значение по умолчанию — только метрики; см. [справочник `telemetry`](/docs/ru/claude-apps-gateway-config#telemetry) для полей на сигнал и их компромиссы чувствительности. Gateway не буферизирует, не агрегирует и не хранит телеметрию, поэтому то, где данные приземляются, полностью конфигурация экспортера сборщика.

520 520 

Details

1569| `feedback/drafts/` | Очередь [составленного Claude отзыва](/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| `plugins/installed_plugins.set-aside.<date>.<hash>.json`, `plugins/installed_plugins.unreadable.<date>.<hash>.kept` | Датированные копии, которые Claude Code создаёт перед перезаписью [`installed_plugins.json`](/docs/ru/plugins/loading#find-plugins-on-disk): записи об установке, которые он удалил, и содержимое файла, который он не смог прочитать. |

1572| `todos/`, `statsig/`, `logs/` | Устаревшие каталоги из более старых версий. Больше не записываются. Очистка удаляет их содержимое, а затем пустой каталог. |1573| `todos/`, `statsig/`, `logs/` | Устаревшие каталоги из более старых версий. Больше не записываются. Очистка удаляет их содержимое, а затем пустой каталог. |

1573 1574 

1574Файлы сеанса в `sessions/`, автоматическая память, а также транскрипты Claude Desktop и Cowork следуют своим собственным правилам хранения:1575Файлы сеанса в `sessions/`, автоматическая память, а также транскрипты Claude Desktop и Cowork следуют своим собственным правилам хранения:


1715| `~/.claude/policy-limits.json` | Ничего. Обновляется автоматически. |1716| `~/.claude/policy-limits.json` | Ничего. Обновляется автоматически. |

1716| `~/.claude/tasks/` | Списки задач, которые возобновлённый сеанс подхватит |1717| `~/.claude/tasks/` | Списки задач, которые возобновлённый сеанс подхватит |

1717| `~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/` | Возможность восстановления [синхронизированных skills](/docs/ru/skills#how-synced-skills-behave) и [синхронизированных plugins](/docs/ru/plugins/loading#synced-plugins), которые Claude Code удалил |1718| `~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/` | Возможность восстановления [синхронизированных skills](/docs/ru/skills#how-synced-skills-behave) и [синхронизированных plugins](/docs/ru/plugins/loading#synced-plugins), которые Claude Code удалил |

1719| `~/.claude/plugins/installed_plugins.set-aside.<date>.<hash>.json`, `~/.claude/plugins/installed_plugins.unreadable.<date>.<hash>.kept` | Копии записей об установке плагинов, которые Claude Code удалил, или содержимое файла, который он не смог прочитать. Ничто их не читает обратно |

1718| `~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/` | Ничего видимого пользователю |1720| `~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/` | Ничего видимого пользователю |

1719| `~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/`, `~/.claude/image-cache/` | Ничего. Устаревшие каталоги, не записываемые текущими версиями. |1721| `~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/`, `~/.claude/image-cache/` | Ничего. Устаревшие каталоги, не записываемые текущими версиями. |

1720 1722 

Details

6 6 

7> Установите Claude Security plugin для сканирования вашей кодовой базы на уязвимости в сеансе Claude Code и преобразуйте результаты в патчи, которые вы проверяете и применяете.7> Установите Claude Security plugin для сканирования вашей кодовой базы на уязвимости в сеансе Claude Code и преобразуйте результаты в патчи, которые вы проверяете и применяете.

8 8 

9Claude Security plugin запускает многоагентное сканирование уязвимостей вашей кодовой базы внутри сеанса Claude Code. Команда агентов Claude составляет карту вашей архитектуры, создает модель угроз, ищет уязвимости и независимо проверяет каждый результат перед написанием отчета. Используйте plugin для сканирования всего репозитория или [только набора изменений](#scan-only-your-changes), таких как diff ветки, diff pull request или отдельный коммит, затем преобразуйте выбранные результаты в патчи, которые вы проверяете и применяете самостоятельно.9Claude Security plugin запускает многоагентное сканирование уязвимостей вашей кодовой базы внутри сеанса Claude Code. Команда агентов Claude отображает вашу архитектуру, создает модель угроз, ищет уязвимости и независимо проверяет каждый результат перед написанием отчета. Используйте plugin для сканирования всего репозитория или [только набора изменений](#scan-only-your-changes), таких как diff ветки, diff pull request или одного коммита, затем преобразуйте результаты, которые вы выбрали, в патчи, которые вы проверяете и применяете самостоятельно.

10 10 

11Plugin работает локально в вашем сеансе, использует любые модели, к которым у вас есть доступ в Claude Code, и каждое сканирование учитывается в пределах использования вашего плана. Если вам нужен управляемый сервис, который отслеживает ваши репозитории, или вы хотите запускать сканирования на [Claude Mythos 5](https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5), см. продукт [Claude Security](https://claude.com/product/claude-security), доступный в плане Enterprise. Plugin достигает кода, который не может достичь управляемый продукт, такие как репозитории, размещенные на GitLab или Bitbucket, или в сетях, которые не допускают входящих соединений.11Plugin работает локально в вашем сеансе, использует [любые модели, к которым у вас есть доступ в Claude Code](#models-and-providers), и каждое сканирование учитывается в вашем [использовании](/docs/ru/costs). Если вам нужна управляемая служба, которая отслеживает ваши репозитории, или вы хотите запускать сканирования на [Claude Mythos](https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5), см. продукт [Claude Security](https://claude.com/product/claude-security), доступный в плане Enterprise. Plugin достигает кода, который не может достичь управляемый продукт, такие как репозитории, размещенные на GitLab или Bitbucket, или в сетях, которые не допускают входящих соединений.

12 12 

13Plugin также отличается от инструментов проверки, уже имеющихся в Claude Code: [security guidance plugin](/docs/ru/security-guidance) проверяет код по мере его написания Claude, [`/security-review`](/docs/ru/commands#all-commands) запускает одиночный проход по вашей ветке, и [Code Review](/docs/ru/code-review) проверяет pull request. Для понимания того, как слои складываются, см. [Как plugin вписывается в другие инструменты безопасности](#how-the-plugin-fits-with-other-security-tools).13Plugin также отличается от инструментов проверки, уже имеющихся в Claude Code: [security guidance plugin](/docs/ru/security-guidance) проверяет код по мере его написания Claude, [`/security-review`](/docs/ru/commands#all-commands) запускает один проход по вашей ветке, и [Code Review](/docs/ru/code-review) проверяет pull request. Чтобы узнать, как слои складываются, см. [Как plugin вписывается в другие инструменты безопасности](#how-the-plugin-fits-with-other-security-tools).

14 14 

15<h2 id="prerequisites">15<h2 id="prerequisites">

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


18 18 

19Для запуска плагина вам необходимо:19Для запуска плагина вам необходимо:

20 20 

21* Платный план для [динамических рабочих процессов](/docs/ru/workflows), которые сканирование использует для организации своих агентов. На Pro включите их из строки Dynamic workflows в `/config`.21* Платный план, доступ к API Anthropic или [сторонний поставщик](#models-and-providers) для [динамических рабочих процессов](/docs/ru/workflows), которые сканирование использует для организации своих агентов. На Pro включите их из строки Dynamic workflows в `/config`.

22* Python 3.9 или более поздняя версия, доступная в вашем `PATH` как `python3`. Проверьте с помощью `python3 --version`. Инструментарий плагина использует только стандартную библиотеку Python, поэтому ничего не устанавливается.22* Python 3.9 или более поздняя версия, доступная в вашем `PATH` как `python3`. Проверьте с помощью `python3 --version`. Инструментарий плагина использует только стандартную библиотеку Python, поэтому ничего не устанавливается.

23* Linux, macOS или Windows.23* Linux, macOS или Windows.

24* Git для сканирования изменений и преобразования результатов в патчи; эти задачи не поддерживают другие системы контроля версий. Полное сканирование работает в любом каталоге с системой контроля версий или без нее.24* Git для сканирования изменений и преобразования результатов в патчи; эти задачи не поддерживают другие системы контроля версий. Полное сканирование работает в любом каталоге с системой контроля версий или без неё.

25 

26<h2 id="models-and-providers">

27 Models and providers

28</h2>

29 

30A scan runs inside your Claude Code session. The plugin makes no model calls of its own, so there's no separate API key or provider setting to configure.

31 

32* **Model**: the agents that hunt for vulnerabilities, verify findings, and write and review patches run on [вашей модели сеанса](/docs/ru/sub-agents#choose-a-model). To change it, run [`/model`](/docs/ru/model-config#setting-your-model) в вашем сеансе перед началом сканирования. A few supporting steps, such as mapping the repository, use the [`sonnet` alias](/docs/ru/model-config#model-aliases) вместо этого.

33* **Provider**: scans run on a paid plan, with Anthropic API access, or on a [third-party provider](/docs/ru/third-party-integrations) such as [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), or [Microsoft Foundry](/docs/ru/microsoft-foundry).

34 

35On a third-party provider, the `sonnet` alias can resolve to a different version than it does on the Anthropic API. If your account can't use that version, [pin your model versions](/docs/ru/model-config#pin-models-for-third-party-deployments), including `ANTHROPIC_DEFAULT_SONNET_MODEL`.

36 

37[Automatic model fallback](/docs/ru/model-config#automatic-model-fallback) re-runs a request that a model's safeguards flag. On Amazon Bedrock, Google Cloud's Agent Platform, and Microsoft Foundry, the request can end with a refusal message instead, depending on [how your deployment is set up](/docs/ru/model-config#enable-fallback-on-bedrock-agent-platform-and-foundry).

25 38 

26<h2 id="install-the-plugin">39<h2 id="install-the-plugin">

27 Установите плагин40 Установите плагин


156 169 

157**Меню `/claude-security` открывается с предупреждением Python.** Плагину требуется `python3` 3.9 или более поздняя версия в вашем `PATH`. Когда он вообще не может найти `python3`, меню предупреждает, что Claude Security не будет работать, пока он не будет установлен; когда первый `python3` в вашем `PATH` старше, предупреждение называет найденную версию. Установите Python 3 или поместите более новый `python3` первым в вашем `PATH`, затем начните новый сеанс.170**Меню `/claude-security` открывается с предупреждением Python.** Плагину требуется `python3` 3.9 или более поздняя версия в вашем `PATH`. Когда он вообще не может найти `python3`, меню предупреждает, что Claude Security не будет работать, пока он не будет установлен; когда первый `python3` в вашем `PATH` старше, предупреждение называет найденную версию. Установите Python 3 или поместите более новый `python3` первым в вашем `PATH`, затем начните новый сеанс.

158 171 

159**Вы можете увидеть уведомление "safeguards flagged this message" при сканировании на модели Fable.** Сообщение называет модель, например "Fable 5.1's safeguards flagged this message". Классификаторы безопасности кибербезопасности Fable помечают определенные запросы, и Claude Code повторно запускает помеченный запрос на модели Opus через [автоматический откат модели](/docs/ru/model-config#automatic-model-fallback). Это ожидается, и сканирование все равно должно завершиться успешно.172**Вы можете увидеть уведомление "safeguards flagged this message" при сканировании на модели Fable.** Сообщение называет модель, которую вы запускаете. Классификаторы безопасности кибербезопасности Fable помечают определенные запросы, и Claude Code повторно запускает помеченный запрос на модели Opus через [автоматический откат модели](/docs/ru/model-config#automatic-model-fallback). Это ожидается. Когда запрос повторно запускается, сканирование все равно должно завершиться успешно.

160 173 

161<h2 id="related-resources">174<h2 id="related-resources">

162 Связанные ресурсы175 Связанные ресурсы

Details

566 * platform.claude.com566 * platform.claude.com

567 * code.claude.com567 * code.claude.com

568 * claude.ai568 * claude.ai

569 * claude.com

570 * support.claude.com

571 * anthropic.com

572 * [www.anthropic.com](http://www.anthropic.com)

569 </Accordion>573 </Accordion>

570 574 

571 <Accordion title="Контроль версий">575 <Accordion title="Контроль версий">


596 * hub.docker.com600 * hub.docker.com

597 * [www.docker.com](http://www.docker.com)601 * [www.docker.com](http://www.docker.com)

598 * production.cloudflare.docker.com602 * production.cloudflare.docker.com

603 * production.cloudfront.docker.com

599 * download.docker.com604 * download.docker.com

600 * gcr.io605 * gcr.io

601 * \*.gcr.io606 * \*.gcr.io

commands.md +4 −1

Details

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 v2.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| `/artifact-capabilities` | **[Skill](/docs/ru/skills#bundled-skills).** Загрузить справку по возможностям среды выполнения, которые опубликованный [артефакт](/docs/ru/artifacts) может использовать, такие как [вызов ваших connectors](/docs/ru/artifacts#pull-live-data-with-mcp-connectors) или [предложение загрузки файла](/docs/ru/artifacts#offer-a-file-download), включая те, которые есть у вашей учётной записи. Claude обычно загружает её самостоятельно перед созданием страницы, которая использует одну. Доступно где [артефакты](/docs/ru/artifacts#availability) есть |

60| `/artifact-diagramming` | **[Skill](/docs/ru/skills#bundled-skills).** Загрузить рекомендации по диаграммированию для Claude, которые следует соблюдать в [артефактах](/docs/ru/artifacts): когда диаграмма помогает, что рисовать и как писать встроенный SVG, который остаётся разборчивым в светлых и тёмных темах. Требует Claude Code v2.1.221 или позже |

59| `/artifacts` | Список [артефактов](/docs/ru/artifacts#find-an-artifact-again), которыми вы владеете или которые с вами поделены, затем прикрепить один к сессии, открыть его в браузере или скопировать его ссылку. Доступно где [артефакты](/docs/ru/artifacts#availability) есть. Требует Claude Code v2.1.208 или позже; прикрепление с `Enter` требует v2.1.216 |61| `/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 v2.1.228 или позже. На нативном Windows требует v2.1.233 или позже |62| `/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 v2.1.221 или позже |63| `/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 или позже |


68| `/cd <path>` | Переместить эту сессию в новый рабочий каталог, сохраняя разговор. Введите частичный путь, чтобы увидеть предложения соответствующих каталогов; нажмите `Tab` для принятия. Предложения требуют Claude Code v2.1.206 или позже. Для того, что Claude Code применяет из нового каталога сразу же при перемещении, и как `/cd` отличается от `/add-dir`, см. [Переместить сессию в другой каталог](/docs/ru/permissions#move-the-session-to-another-directory) |70| `/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) |71| `/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 v2.1.221 или позже, `upgrade` требует v2.1.236 или позже, `cost-optimize` требует v2.1.247 или позже, а `build-eval` и `hillclimb` требуют v2.1.259 или позже |72| `/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 или позже |

73| `/claude-in-chrome [task]` | **[Skill](/docs/ru/skills#bundled-skills).** Попросить Claude выполнить задачу в вашем браузере, такую как тестирование страницы, заполнение формы или чтение логов консоли, через [Claude в Chrome](/docs/ru/chrome). Доступно, когда интеграция Chrome включена для сессии, например с `claude --chrome`, или когда Claude Code может предложить [установить расширение](/docs/ru/chrome#install-the-extension-when-claude-asks) |

71| `/clear [name]` | Начать новый разговор с пустым контекстом. Передайте имя для обозначения предыдущего разговора в средстве выбора `/resume`. Чтобы освободить контекст, продолжая тот же разговор, используйте `/compact` вместо этого. Возобновите предыдущий разговор с помощью `/resume`, или, в том же процессе Claude Code, восстановите его из [записи предыдущей сессии меню перемотки](/docs/ru/checkpointing#rewind-past-a-cleared-conversation). Псевдонимы: `/reset`, `/new` |74| `/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 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` |75| `/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 v2.1.205 или позже |76| `/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 или позже |


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 или позже |94| `/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` всегда диалог открывается напрямую |95| `/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` для уменьшения подсказок разрешений |96| `/fewer-permission-prompts` | **[Skill](/docs/ru/skills#bundled-skills).** Сканировать ваши стенограммы на предмет распространённых вызовов инструментов Bash и MCP только для чтения, затем добавить приоритизированный список разрешений в проект `.claude/settings.json` для уменьшения подсказок разрешений |

94| `/focus` | Переключить представление фокуса, которое показывает только вашу последнюю подсказку, однострочное резюме вызова инструмента с diffstats редактирования и финальный ответ. Резюме вызова инструмента также подсчитывает подагентов, запущенных в ходу, и сворачивает завершённые уведомления фоновых задач в один счёт. Выбор сохраняется между сессиями; установите [`viewMode`](/docs/ru/settings-reference#viewmode) в настройках для переопределения. Доступно только в [полноэкранном рендеринге](/docs/ru/fullscreen). [Расширение VS Code](/docs/ru/vs-code#use-the-prompt-box) предлагает свой собственный вид Focus как переключатель меню команд, сохранённый как параметр расширения, независимый от `viewMode` |97| `/focus` | Переключить представление фокуса, которое показывает только вашу последнюю подсказку, однострочное резюме вызова инструмента с diffstats редактирования и финальный ответ. Резюме вызова инструмента также подсчитывает подагентов, запущенных в ходу, и сворачивает завершённые уведомления фоновых задач в один счёт. Выбор сохраняется между сессиями; установите [`viewMode`](/docs/ru/settings-reference#viewmode) в настройках для переопределения. Доступно только в [полноэкранном рендеринге](/docs/ru/fullscreen). Из [Remote Control](/docs/ru/remote-control) клиента запустите `/focus [on\|off]` для включения или отключения представления фокуса для текущей сессии только, без изменения вашего сохранённого выбора; это требует Claude Code v2.1.281 или позже. [Расширение 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 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) вместо этого |98| `/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` удаляет активную цель рано |99| `/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) |100| `/heapdump` | Записать снимок кучи JavaScript и разбор памяти в `~/Desktop` или ваш домашний каталог на Linux без папки Desktop для диагностики высокого использования памяти. Прикрепляйте только файл `-diagnostics.json` при сообщении о проблеме с памятью; `.heapsnapshot` содержит ваш полный разговор и учётные данные, поэтому не делитесь им. [Скрыто из меню команд](#how-the-command-menu-matches-what-you-type); введите его полностью. См. [что делать с выводом](/docs/ru/troubleshooting#high-cpu-or-memory-usage) |

costs.md +2 −0

Details

96 96 

97Запустите [`/insights`](/docs/ru/commands#all-commands) для отчёта о том, как вы работаете, а не о том, сколько токенов вы использовали. Он анализирует ваши недавние сессии на этом устройстве и пишет отчёт HTML, охватывающий то, над чем вы работаете, точки трения, такие как неправильно понятые запросы или ошибочный код, и предложения по более эффективному использованию Claude Code. Один запуск анализирует до 200 сессий, которые он ещё не видел, и пропускает очень короткие. Когда сессии исключены, заголовок отчёта показывает проанализированное количество с общим количеством в скобках, например `200 sessions (412 total)`.97Запустите [`/insights`](/docs/ru/commands#all-commands) для отчёта о том, как вы работаете, а не о том, сколько токенов вы использовали. Он анализирует ваши недавние сессии на этом устройстве и пишет отчёт HTML, охватывающий то, над чем вы работаете, точки трения, такие как неправильно понятые запросы или ошибочный код, и предложения по более эффективному использованию Claude Code. Один запуск анализирует до 200 сессий, которые он ещё не видел, и пропускает очень короткие. Когда сессии исключены, заголовок отчёта показывает проанализированное количество с общим количеством в скобках, например `200 sessions (412 total)`.

98 98 

99Когда [автоматический режим](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) доступен для сессии и ваши недавние сессии в основном выполнялись без него, отчёт также может включать оценку того, сколько подсказок разрешений автоматический режим мог бы обработать в этих сессиях.

100 

99Claude Code пишет последний отчёт в `~/.claude/usage-data/report.html` и сохраняет копию с временной меткой каждого запуска в том же каталоге, поэтому более ранние отчёты не перезаписываются. Claude Code удаляет отчёты по тому же расписанию, что и остальные данные вашей сессии: при запуске он удаляет файлы старше [`cleanupPeriodDays`](/docs/ru/claude-directory#cleaned-up-automatically), 30 дней по умолчанию.101Claude Code пишет последний отчёт в `~/.claude/usage-data/report.html` и сохраняет копию с временной меткой каждого запуска в том же каталоге, поэтому более ранние отчёты не перезаписываются. Claude Code удаляет отчёты по тому же расписанию, что и остальные данные вашей сессии: при запуске он удаляет файлы старше [`cleanupPeriodDays`](/docs/ru/claude-directory#cleaned-up-automatically), 30 дней по умолчанию.

100 102 

101Вы можете запустить `/insights` на любом плане и с любым поставщиком. Анализ выполняется через того же поставщика и аккаунт, что и ваши обычные сессии, и токены учитываются в вашем плане или использовании API. Сессии с других устройств и claude.ai не включены.103Вы можете запустить `/insights` на любом плане и с любым поставщиком. Анализ выполняется через того же поставщика и аккаунт, что и ваши обычные сессии, и токены учитываются в вашем плане или использовании API. Сессии с других устройств и claude.ai не включены.

desktop.md +6 −0

Details

834* **Remote Control**: включите или отключите [Remote Control](/docs/ru/remote-control) для вашей организации834* **Remote Control**: включите или отключите [Remote Control](/docs/ru/remote-control) для вашей организации

835* **Disable Bypass permissions mode**: предотвратите пользователей в вашей организации от включения режима обхода разрешений835* **Disable Bypass permissions mode**: предотвратите пользователей в вашей организации от включения режима обхода разрешений

836 836 

837<Note>

838 Форма OpenTelemetry для Cowork в разделе **Monitoring** в [параметрах конфиденциальности и данных](https://claude.ai/admin-settings/data-privacy-controls) консоли администратора применяется только к сеансам Cowork. В сеансе Cowork на этой машине приложение desktop передаёт этот сборщик в Claude Code как переменные окружения `OTEL_*`, поэтому форма вступает в силу, даже если Claude Code в этом сеансе [никогда не получает параметры консоли администратора](#managed-settings).

839 

840 Чтобы экспортировать телеметрию из сеансов вкладки Code, установите `CLAUDE_CODE_ENABLE_TELEMETRY` и переменные `OTEL_*` в блоке `env` ваших управляемых параметров Claude Code, как показано в [конфигурации администратора для мониторинга](/docs/ru/monitoring-usage#administrator-configuration). Локальные, облачные и SSH-сеансы каждый читают [управляемые параметры из разных источников](#managed-settings). Для хостов, которые может достичь облачный сеанс, см. [доступ в сеть](/docs/ru/cloud-environments#network-access). Для `service.name`, который сообщают сеансы вкладки Code, см. [информация о сервисе](/docs/ru/monitoring-usage#service-information).

841</Note>

842 

837<h3 id="managed-settings">843<h3 id="managed-settings">

838 Управляемые параметры844 Управляемые параметры

839</h3>845</h3>

errors.md +42 −10

Details

152| `There's an issue with the selected model` | [Request errors](#theres-an-issue-with-the-selected-model) |152| `There's an issue with the selected model` | [Request errors](#theres-an-issue-with-the-selected-model) |

153| `Model ... is not a recognized model id` | [Request errors](#model-is-not-a-recognized-model-id) |153| `Model ... is not a recognized model id` | [Request errors](#model-is-not-a-recognized-model-id) |

154| `Model ... not found` | [Request errors](#model-not-found) |154| `Model ... not found` | [Request errors](#model-not-found) |

155| `Couldn't confirm model ... with the API` | [Request errors](#couldnt-confirm-model-with-the-api) |

155| `API error: ... · model not changed` | [Request errors](#api-error-model-not-changed) |156| `API error: ... · model not changed` | [Request errors](#api-error-model-not-changed) |

156| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |157| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |

157| `Claude Code ... does not support this model; version ... or newer is required` | [Request errors](#claude-code-does-not-support-this-model) |158| `Claude Code ... does not support this model; version ... or newer is required` | [Request errors](#claude-code-does-not-support-this-model) |


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 "<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: 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) |255| `"<plugin>" was not uninstalled: <file> is there and could not be read` | [Plugin errors](#plugin-was-not-uninstalled) |

256| `Plugin "<plugin>" was not uninstalled: installed_plugins.json` | [Plugin troubleshooting](/docs/ru/plugins/troubleshooting#installed-plugins-json-holds-a-record-this-version-cannot-read) |

255| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |257| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |

256| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |258| `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) |259| `cannot contain null bytes (\0)` | [Tool errors](#path-cannot-contain-null-bytes) |


2346 Model is not a recognized model id2348 Model is not a recognized model id

2347</h3>2349</h3>

2348 2350 

2349Строка модели, которую вы передали переключателю модели, не является псевдонимом модели, ID модели, который эта версия Claude Code знает, или ID, который начинается с `claude-`. Обычные причины — опечатка в ID, отображаемое имя, такое как `Sonnet 5`, где ожидается ID `claude-sonnet-5`, или псевдоним, который распознают только более новые версии Claude Code. Claude Code отклоняет переключение немедленно. До версии 2.1.200 Claude Code сохранял строку и завершался с ошибкой на следующем запросе с [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).2351Строка, которую вы передали переключателю модели, не является одним Claude Code может использовать как модель, поэтому он отклонил переключение без отправки запроса и сеанс сохраняет свою текущую модель. Вы можете получить эту ошибку, когда модель установлена через метод [Agent SDK](/docs/ru/agent-sdk/typescript) `setModel()`, приложением, которое запускает Claude Code CLI для вас, такое как [Desktop app](/docs/ru/desktop), или когда вы выбираете модель с устройства, подключённого через [Remote Control](/docs/ru/remote-control). До версии 2.1.200 Claude Code сохранял строку и завершался с ошибкой на следующем запросе с [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).

2350 2352 

2351```text theme={null}2353```text theme={null}

2352Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?2354Model "Sonnet5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

2353```2355```

2354 2356 

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

2356 2358 

2357Claude Code производит эту ошибку локально в момент запроса переключения, перед любым запросом API. Она применяется, когда модель установлена через метод [Agent SDK](/docs/ru/agent-sdk/typescript) `setModel()`, приложением, таким как [Desktop app](/docs/ru/desktop), которое запускает Claude Code CLI для вас, или когда вы выбираете модель с устройства, подключённого через [Remote Control](/docs/ru/remote-control). До версии 2.1.260 проверка не охватывала выборы Remote Control, поэтому Claude Code применял выбор и следующий запрос завершался с [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).2359Когда вы переключаетесь через Agent SDK или приложение на Anthropic API, только строка, которая не может быть ID модели, получает эту ошибку, такая как отображаемое имя или пустая строка.

2360 

2361Когда вы выбираете модель с устройства Remote Control, Claude Code проверяет строку локально. Любая строка, которая не является псевдонимом модели, моделью, которую Claude Code перечисляет или вы настроили, или ID, который начинается с `claude-`, получает эту ошибку, неправильно введённый ID, такой как `claud-sonnet-5`, включённый. До версии 2.1.260 эта проверка не охватывала выборы Remote Control, поэтому неузнанная строка была применена и завершилась с ошибкой на следующем запросе.

2358 2362 

2359**Что делать:**2363**Что делать:**

2360 2364 

2361* Запустите `/model` без аргумента, чтобы открыть выбор и выбрать из моделей, доступных вашей учётной записи, затем передайте показанный там псевдоним или ID2365* Запустите `/model` без аргумента, чтобы открыть выбор и выбрать из моделей, доступных вашей учётной записи, затем передайте показанный там псевдоним или ID

2362* Если вы использовали псевдоним, который поддерживает более новая версия Claude Code, запустите `claude update`. Полный ID, который начинается с `claude-`, проходит эту локальную проверку даже когда модель новее вашей версии Claude Code. Сервер всё ещё может требовать минимальную версию для этой модели; смотрите [Claude Code does not support this model](#claude-code-does-not-support-this-model).2366* Если вы использовали псевдоним, который поддерживает только более новая версия Claude Code, запустите `claude update`, или передайте полный ID модели вместо этого. Сервер всё ещё может требовать минимальную версию Claude Code для этой модели; смотрите [Claude Code does not support this model](#claude-code-does-not-support-this-model).

2363* Модель, сохранённая до версии 2.1.200, не восстанавливается этой проверкой. Если устаревшее значение продолжает возвращаться, удалите его из мест, перечисленных в [Setting your model](/docs/ru/model-config#setting-your-model).2367* Модель, сохранённая до версии 2.1.200, не восстанавливается этой проверкой. Если устаревшее значение продолжает возвращаться, удалите его из мест, перечисленных в [Setting your model](/docs/ru/model-config#setting-your-model).

2364* Проверка выполняется только на Anthropic API. На любом другом поставщике или шлюзе, включая пользовательский `ANTHROPIC_BASE_URL`, поставщик определяет имена моделей, поэтому Claude Code принимает любую строку и передаёт её. Claude Code всё ещё может написать [неузнанную диагностическую строку ID модели](#unrecognized-model-id-on-a-request) во время запроса на каждом поставщике.2368* На любом поставщике, отличном от Anthropic API, или позади шлюза или пользовательского `ANTHROPIC_BASE_URL`, только пустая строка получает эту ошибку. Claude Code всё ещё может написать [неузнанную диагностическую строку ID модели](#unrecognized-model-id-on-a-request) во время запроса на каждом поставщике.

2365 2369 

2366<h3 id="model-not-found">2370<h3 id="model-not-found">

2367 Model not found2371 Model not found

2368</h3>2372</h3>

2369 2373 

2370Вы выбрали модель с `/model <имя>` и Claude Code не смог подтвердить, что модель с этим именем существует. Когда имя не является [псевдонимом модели](/docs/ru/model-config#model-aliases) или другим написанием, которое Claude Code принимает локально, `/model` проверяет его с минимальным запросом API, и эта ошибка обычно является ответом вашей конечной точки API. Имя, которое не может быть ID модели вообще, такое как содержащее пробелы, получает то же сообщение.2374Вы выбрали модель по имени и Claude Code не смог подтвердить, что модель с этим именем существует. Когда имя не является [псевдонимом модели](/docs/ru/model-config#model-aliases) или другим написанием Claude Code принимает локально, Claude Code проверяет его с минимальным запросом API, и эта ошибка обычно является ответом вашей конечной точки API. С `/model <имя>`, имя, которое не может быть ID модели вообще, такое как содержащее пробелы, получает то же сообщение.

2371 2375 

2372```text theme={null}2376```text theme={null}

2373Model 'claude-opus-9' not found2377Model 'claude-opus-9' not found


2379 2383 

2380* Запустите `/model` без аргумента и выберите из моделей, доступных вашей учётной записи, или используйте [псевдоним модели](/docs/ru/model-config#model-aliases), такой как `sonnet`, который разрешается в поддерживаемое значение по умолчанию2384* Запустите `/model` без аргумента и выберите из моделей, доступных вашей учётной записи, или используйте [псевдоним модели](/docs/ru/model-config#model-aliases), такой как `sonnet`, который разрешается в поддерживаемое значение по умолчанию

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

2386* В Agent SDK `setModel()` завершается с этим сообщением и сеанс продолжает работать на своей предыдущей модели. В TypeScript SDK вызовите [`supportedModels()`](/docs/ru/agent-sdk/typescript#query-object) для перечисления моделей, на которые вы можете переключиться.

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

2383 2388 

2389<h3 id="couldnt-confirm-model-with-the-api">

2390 Couldn't confirm model with the API

2391</h3>

2392 

2393Вы выбрали модель через метод [Agent SDK](/docs/ru/agent-sdk/typescript) `setModel()` или приложение, которое запускает Claude Code CLI для вас, такое как [Desktop app](/docs/ru/desktop), и запрос, который подтверждает ID модели с вашей конечной точкой API, не получил ответ в течение пяти секунд. Сеанс сохраняет свою текущую модель.

2394 

2395```text theme={null}

2396Couldn't confirm model "claude-sonnet-5" with the API. Try again, or run /model to see available models.

2397```

2398 

2399В сеансе, который [Desktop app](/docs/ru/desktop) запускает для вас, сообщение заканчивается на `Try again.`

2400 

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

2402 

2403* Переключитесь на модель снова

2404* Если переключение продолжает завершаться с ошибкой, проверьте, что Claude Code может достичь вашу конечную точку API; смотрите [Network and connection errors](#network-and-connection-errors)

2405 

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

2385 API error when checking the picked model2407 API error when checking the picked model

2386</h3>2408</h3>


2432API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.2454API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.

2433```2455```

2434 2456 

2457Версия, которую API проверяет, — это версия, сообщённая бинарным файлом Claude Code, который сделал запрос.

2458 

2435**Что делать:**2459**Что делать:**

2436 2460 

2437* Запустите `claude update` или обновите Claude desktop app, затем начните новый сеанс2461Обновите этот бинарный файл, затем начните новый сеанс. Откуда пришёл бинарный файл, решает как, кроме [self-hosted environment](/docs/ru/self-hosted-environments-deploy#pin-the-version):

2438* Для формулировки для каждой модели вы можете продолжить работу в текущем сеансе, переключившись на другую модель с помощью `/model`2462 

2463| Бинарный файл, который сделал запрос | Как его обновить |

2464| :- | :- |

2465| Claude Code, который вы установили | Запустите `claude update` |

2466| Claude desktop app | Обновите приложение |

2467| Бинарный файл, который [VS Code extension](/docs/ru/vs-code) объединяет | Обновите расширение |

2468| Бинарный файл, который пакет Agent SDK объединяет | [Обновите пакет SDK](/docs/ru/agent-sdk/hosting#runtime-dependencies), затем перезагрузите ваше приложение. В [скомпилированном однофайловом исполняемом файле](/docs/ru/agent-sdk/typescript#compile-to-a-single-executable), пересоберите его |

2469 

2470* Для формулировки для каждой модели вы можете продолжить работу в текущем сеансе, переключившись на другую модель: запустите `/model` в CLI, вызовите [`setModel()`](/docs/ru/agent-sdk/typescript#query-object) на объекте `Query` TypeScript SDK в режиме потокового входа, или вызовите [`set_model()`](/docs/ru/agent-sdk/python#claudesdkclient) на `ClaudeSDKClient` Python SDK

2439* Для формулировки политики организации обновитесь перед продолжением2471* Для формулировки политики организации обновитесь перед продолжением

2440 2472 

2441<h3 id="model-is-restricted-by-your-organizations-settings">2473<h3 id="model-is-restricted-by-your-organizations-settings">


3888 Plugin was not uninstalled3920 Plugin was not uninstalled

3889</h3>3921</h3>

3890 3922 

3891Вы запустили [`claude plugin uninstall`](/docs/ru/plugins/cli-reference#plugin-uninstall), или выбрали **Uninstall** на вкладке `/plugin` **Installed**, и удаление остановилось с сообщением, начинающимся с `"<plugin>" was not uninstalled:`.3923Вы запустили [`claude plugin uninstall`](/docs/ru/plugins/cli-reference#plugin-uninstall), или выбрали **Uninstall** на вкладке `/plugin` **Installed**, и удаление остановилось с сообщением, начинающимся с `"<plugin>" was not uninstalled:`. Если текст после этого двоеточия начинается с `installed_plugins.json` вместо названия файла параметров, причина заключается в содержимом `installed_plugins.json`, которое эта версия Claude Code не может прочитать. Для этой формы см. [`installed_plugins.json` holds a record this version can't read](/docs/ru/plugins/troubleshooting#installed-plugins-json-holds-a-record-this-version-cannot-read).

3892 3924 

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

3894 3926 

fast-mode.md +2 −0

Details

72 72 

73Введите `/fast on` в сеансе, чтобы включить быстрый режим. Он остается включенным только для этого сеанса и не сохраняется как ваше значение по умолчанию. [Требования](#requirements) применяются и в облачных сеансах.73Введите `/fast on` в сеансе, чтобы включить быстрый режим. Он остается включенным только для этого сеанса и не сохраняется как ваше значение по умолчанию. [Требования](#requirements) применяются и в облачных сеансах.

74 74 

75В браузере на [claude.ai/code](https://claude.ai/code) вы также можете включать и отключать быстрый режим из меню модели в поле сообщения. Меню показывает переключатель, когда ваш план включает быстрый режим и выбранная модель его поддерживает.

76 

75<h2 id="understand-the-cost-tradeoff">77<h2 id="understand-the-cost-tradeoff">

76 Понимание компромисса стоимости78 Понимание компромисса стоимости

77</h2>79</h2>

Details

312| [Computer use](/docs/ru/computer-use) | ✓ | ✓ | ✗ | ✗ |312| [Computer use](/docs/ru/computer-use) | ✓ | ✓ | ✗ | ✗ |

313| Dispatch ([Desktop](/docs/ru/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |313| Dispatch ([Desktop](/docs/ru/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |

314| [Code Review](/docs/ru/code-review) | ✗ | ✗ | ✓ | ✓ |314| [Code Review](/docs/ru/code-review) | ✗ | ✗ | ✓ | ✓ |

315| [Artifacts](/docs/ru/artifacts) | ✓ | ✓ | ✓ | Admin-enabled |315| [Artifacts](/docs/ru/artifacts) | ✓ | ✓ | ✓ | ✓ |

316| [Analytics dashboard and contribution metrics](/docs/ru/analytics) | ✗ | ✗ | ✓ | ✓ |316| [Analytics dashboard and contribution metrics](/docs/ru/analytics) | ✗ | ✗ | ✓ | ✓ |

317| [Enterprise Analytics API](/docs/ru/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |317| [Enterprise Analytics API](/docs/ru/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |

318| [Server-managed settings](/docs/ru/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |318| [Server-managed settings](/docs/ru/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |

Details

43 43 

44Claude Code затем отправляет ветку с выбранными файлами рабочего процесса, уже настроенными на использование этого секрета, и открывает GitHub в вашем браузере с готовым к созданию pull request. Создайте и объедините этот pull request, и `@claude` будет работать в репозитории.44Claude Code затем отправляет ветку с выбранными файлами рабочего процесса, уже настроенными на использование этого секрета, и открывает GitHub в вашем браузере с готовым к созданию pull request. Создайте и объедините этот pull request, и `@claude` будет работать в репозитории.

45 45 

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

47 

46Если вы выберете рабочий процесс проверки, Claude размещает каждую проверку на самом pull request как встроенный комментарий к каждой найденной проблеме или как один сводный комментарий, когда он не находит ничего. Claude пропускает некоторые pull requests, такие как черновики. Пример [рабочего процесса проверки](#run-a-skill) использует тот же skill и перечисляет их. До версии 2.1.229 Claude писал свою проверку только в журнал выполнения рабочего процесса.48Если вы выберете рабочий процесс проверки, Claude размещает каждую проверку на самом pull request как встроенный комментарий к каждой найденной проблеме или как один сводный комментарий, когда он не находит ничего. Claude пропускает некоторые pull requests, такие как черновики. Пример [рабочего процесса проверки](#run-a-skill) использует тот же skill и перечисляет их. До версии 2.1.229 Claude писал свою проверку только в журнал выполнения рабочего процесса.

47 49 

48Чтобы обновить рабочий процесс проверки, созданный более ранней версией, выполните одно из следующих действий:50Чтобы обновить рабочий процесс проверки, созданный более ранней версией, выполните одно из следующих действий:

Details

95 Требования к сети95 Требования к сети

96</h3>96</h3>

97 97 

98Для сессий, размещённых на Anthropic, ваш экземпляр GHES должен быть доступен из инфраструктуры Anthropic, чтобы Claude мог клонировать репозитории и публиковать комментарии проверки. Если ваш экземпляр GHES находится за брандмауэром, добавьте в список разрешений [IP-адреса исходящего трафика Anthropic](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses). Сессии в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments-deploy#configure-git) клонируют изнутри вашей сети, если только запускающий не согласится на [прокси Git Anthropic](/docs/ru/self-hosted-environments-deploy#use-the-anthropic-git-proxy), который получает данные со стороны Anthropic и требует той же доступности; [коннектор SCM](/docs/ru/self-hosted-environments-reference#scm-connector-flags) охватывает размещённые потоки перед сессией, такие как средство выбора репозитория, для хоста GHES, который маршрутизируется только внутри.98Для сессий, размещённых на Anthropic, ваш экземпляр GHES должен быть доступен из инфраструктуры Anthropic, чтобы Claude мог клонировать репозитории и публиковать комментарии проверки. Если ваш экземпляр GHES находится за брандмауэром, добавьте в список разрешений [IP-адреса исходящего трафика Anthropic](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses). Сессии в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments-deploy#configure-git) клонируют изнутри вашей сети, если только запускающий не согласится на [прокси Git Anthropic](/docs/ru/self-hosted-environments-deploy#use-the-anthropic-git-proxy), который получает данные со стороны Anthropic и требует той же доступности. Размещённые потоки перед сессией, такие как средство выбора репозитория, выполняются на стороне Anthropic перед началом сессии. Им требуется, чтобы ваш экземпляр GHES был доступен из инфраструктуры Anthropic даже когда сессия выполняется в самостоятельно размещённой среде. [Коннектор SCM](/docs/ru/self-hosted-environments-reference#scm-connector-flags) недоступен, поэтому эти потоки не могут достичь хоста GHES, который маршрутизируется только внутри.

99 99 

100<h2 id="developer-workflow">100<h2 id="developer-workflow">

101 Рабочий процесс разработчика101 Рабочий процесс разработчика


246 Экземпляр GHES недоступен246 Экземпляр GHES недоступен

247</h3>247</h3>

248 248 

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

250 250 

251<h3 id="session-start-fails-with-unable-to-get-organization-uuid">251<h3 id="session-start-fails-with-unable-to-get-organization-uuid">

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

glossary.md +6 −6

Details

24 Agent teams24 Agent teams

25</h3>25</h3>

26 26 

27Несколько независимых сеансов Claude Code, координируемых лидером команды, с общим списком задач и обменом сообщениями между участниками. В отличие от [subagents](#subagent), которые работают в одном сеансе и отчитываются только перед родительским агентом, члены команды имеют собственное окно контекста, и вы можете взаимодействовать с любым из них напрямую. Agent teams являются экспериментальной функцией и отключены по умолчанию; см. [Enable agent teams](/docs/ru/agent-teams#enable-agent-teams).27Несколько независимых сеансов Claude Code, координируемых лидером команды, с общим списком задач и обменом сообщениями между участниками. В отличие от [subagents](#subagent), которые работают в одном сеансе и отчитываются только перед родительским агентом, члены команды имеют собственное окно контекста, и вы можете взаимодействовать с любым из них напрямую. Agent teams находятся на экспериментальном этапе и отключены по умолчанию; см. [Enable agent teams](/docs/ru/agent-teams#enable-agent-teams).

28 28 

29Подробнее: [Run agent teams](/docs/ru/agent-teams)29Подробнее: [Run agent teams](/docs/ru/agent-teams)

30 30 


32 Agentic coding32 Agentic coding

33</h3>33</h3>

34 34 

35Рабочий процесс, при котором AI может автономно читать файлы, выполнять команды и вносить изменения, пока вы наблюдаете, перенаправляете или отходите в сторону, в отличие от чат-ассистентов на основе текста, которые только отвечают текстом, который вы должны применить самостоятельно. Claude Code является агентским, потому что он имеет [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 


40 Agentic harness40 Agentic harness

41</h3>41</h3>

42 42 

43Инструменты, управление контекстом и среда выполнения, которые превращают языковую модель в способного агента кодирования. Claude Code — это harness; Claude — это модель внутри него. Harness предоставляет доступ к файлам, выполнение shell-команд, управление разрешениями, загрузку памяти и цикл, который связывает действия вместе.43Инструменты, управление контекстом и среда выполнения, которые превращают языковую модель в способного агента кодирования. Claude Code — это harness; Claude — это модель внутри него. Harness обеспечивает доступ к файлам, выполнение shell-команд, управление разрешениями, загрузку памяти и цикл, который связывает действия вместе.

44 44 

45Подробнее: [How Claude Code works](/docs/ru/how-claude-code-works)45Подробнее: [How Claude Code works](/docs/ru/how-claude-code-works)

46 46 


48 Agentic loop48 Agentic loop

49</h3>49</h3>

50 50 

51Цикл, через который Claude проходит для каждой задачи: собрать контекст, предпринять действие, проверить результаты и повторять до завершения. Каждое использование инструмента возвращает информацию, которая информирует следующий шаг. Вы можете прервать цикл в любой момент для перенаправления. Большинство точек расширения, включая [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. Параметры общего доступа зависят от вашего плана: см. [Share an artifact](/docs/ru/artifacts#share-an-artifact).

60 60 

61Подробнее: [Share session output as artifacts](/docs/ru/artifacts)61Подробнее: [Share session output as artifacts](/docs/ru/artifacts)

62 62 


72 Auto mode72 Auto mode

73</h3>73</h3>

74 74 

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

Details

315 315 

316Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [контекстное окно с 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) на платформе Agent Platform Google Cloud. Sonnet 5 всегда работает с окном 1M, без варианта `[1m]` для выбора. Для других моделей Claude Code автоматически включает расширенное контекстное окно при выборе варианта модели с 1M.316Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [контекстное окно с 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) на платформе Agent Platform Google Cloud. Sonnet 5 всегда работает с окном 1M, без варианта `[1m]` для выбора. Для других моделей Claude Code автоматически включает расширенное контекстное окно при выборе варианта модели с 1M.

317 317 

318[Мастер установки](#sign-in-with-agent-platform) предлагает опцию контекстного окна с 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели, добавьте `[1m]` к ID модели. Подробности см. в разделе [Закрепите модели для развертываний третьих сторон](/docs/ru/model-config#pin-models-for-third-party-deployments).318[Мастер установки](#sign-in-with-agent-platform) предлагает опцию контекстного окна с 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели, добавьте `[1m]` к ID модели. Подробности см. в разделе [Закрепите модели для развертываний третьих сторон](/docs/ru/model-config#pin-models-for-third-party-deployments), включая способы использования окна 1M без изменения закрепления.

319 319 

320<h2 id="troubleshooting">320<h2 id="troubleshooting">

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

hooks-guide.md +1 −1

Details

196| `elicitation_url_dialog` | Сервер MCP просит вас открыть URL браузера и вы не печатали около шести секунд |196| `elicitation_url_dialog` | Сервер MCP просит вас открыть URL браузера и вы не печатали около шести секунд |

197| `elicitation_complete` | Сервер MCP сообщает, что [выяснение в режиме URL](/docs/ru/hooks#elicitation-input) завершено |197| `elicitation_complete` | Сервер MCP сообщает, что [выяснение в режиме URL](/docs/ru/hooks#elicitation-input) завершено |

198| `elicitation_response` | Ответ выяснения MCP отправлен обратно на сервер |198| `elicitation_response` | Ответ выяснения MCP отправлен обратно на сервер |

199| `agent_needs_input` | Фоновый сеанс начинает ожидание вашего ввода, пока открыто [представление агента](/docs/ru/agent-view), или текущий сеанс задаёт вам вопрос о настройке терминала [товарища команды агента](/docs/ru/agent-teams#choose-a-display-mode) и вы не печатали около шести секунд |199| `agent_needs_input` | Фоновый сеанс начинает ожидание вашего ввода, пока открыто [представление агента](/docs/ru/agent-view). Также срабатывает, когда сеанс терминала показывает вам вопрос о настройке терминала [товарища команды агента](/docs/ru/agent-teams#choose-a-display-mode) или уведомление автоматического режима о [расходах на запросы классификатора](/docs/ru/auto-mode-classifier-billing) и вы не печатали около шести секунд |

200| `agent_completed` | Фоновый сеанс завершается или завершается с ошибкой. Срабатывает только при открытом [представлении агента](/docs/ru/agent-view) |200| `agent_completed` | Фоновый сеанс завершается или завершается с ошибкой. Срабатывает только при открытом [представлении агента](/docs/ru/agent-view) |

201| `quota_auto_resume_fired` | Claude Code продолжает вашу задачу после того, как лимит использования claude.ai приостановил её: при сбросе или раньше, когда что-то, что вы делаете в Claude Code во время ожидания, например добавление кредитов использования, обновление плана или переключение моделей, делает использование доступным снова, с [исключением параметра модели](/docs/ru/interactive-mode#wait-for-a-usage-limit-to-reset) |201| `quota_auto_resume_fired` | Claude Code продолжает вашу задачу после того, как лимит использования claude.ai приостановил её: при сбросе или раньше, когда что-то, что вы делаете в Claude Code во время ожидания, например добавление кредитов использования, обновление плана или переключение моделей, делает использование доступным снова, с [исключением параметра модели](/docs/ru/interactive-mode#wait-for-a-usage-limit-to-reset) |

202| `quota_auto_resume_stale` | Лимит использования claude.ai сбросился, пока ваш компьютер спал более чем около 30 минут. Claude Code ждёт, пока вы нажмёте `Enter` вместо продолжения. После более короткого сна он продолжает и срабатывает `quota_auto_resume_fired` вместо этого |202| `quota_auto_resume_stale` | Лимит использования claude.ai сбросился, пока ваш компьютер спал более чем около 30 минут. Claude Code ждёт, пока вы нажмёте `Enter` вместо продолжения. После более короткого сна он продолжает и срабатывает `quota_auto_resume_fired` вместо этого |

keybindings.md +5 −2

Details

301| `footer:down` | Down | Навигация вниз в нижнем колонтитуле |301| `footer:down` | Down | Навигация вниз в нижнем колонтитуле |

302| `footer:openSelected` | Enter | Открыть выбранный элемент нижнего колонтитула |302| `footer:openSelected` | Enter | Открыть выбранный элемент нижнего колонтитула |

303| `footer:clearSelection` | Escape | Очистить выбор нижнего колонтитула |303| `footer:clearSelection` | Escape | Очистить выбор нижнего колонтитула |

304| `footer:dismiss` | (не привязано) | Удалено в v2.1.281. `keybindings.json`, который по-прежнему называет действие, остаётся действительным, и привязка ничего не делает. До v2.1.281 Backspace и Delete удаляли выбранную ссылку артефакта из нижнего колонтитула |304| `footer:dismiss` | (не привязано) | Привязка клавиши к этому действию не имеет эффекта, и `keybindings.json`, который называет его, остаётся действительным. До v2.1.281 Backspace и Delete были привязаны к нему и удаляли выбранную ссылку артефакта из нижнего колонтитула. |

305 305 

306Пока элемент нижнего колонтитула выбран, например строка в панели агента ниже подсказки, `Enter` открывает его даже если вы переназначили `Enter` в контексте `Chat` на `chat:queueSubmit` или `chat:newline`.306Пока элемент нижнего колонтитула выбран, например строка в панели агента ниже подсказки, `Enter` открывает его даже если вы переназначили `Enter` в контексте `Chat` на `chat:queueSubmit` или `chat:newline`.

307 307 


417| `select:accept` | Enter | Принять выбор |417| `select:accept` | Enter | Принять выбор |

418| `select:cancel` | Escape | Отменить выбор |418| `select:cancel` | Escape | Отменить выбор |

419 419 

420В панелях списков, таких как `/skills` и `/mcp`, Claude Code применяет ваши привязки `select:pageUp`, `select:pageDown`, `select:first` и `select:last`. В большинстве других списков, таких как выбор модели `/model`, ваши привязки `select:first` и `select:last` применяются. PageUp и PageDown разбивают на страницы параметры в этих списках независимо от ваших привязок.420В панелях списков, таких как `/skills`, `/mcp` и `/tasks`, Claude Code применяет ваши привязки `select:pageUp`, `select:pageDown`, `select:first` и `select:last`. В большинстве других списков, таких как выбор модели `/model`, ваши привязки `select:first` и `select:last` применяются. PageUp и PageDown разбивают на страницы параметры в этих списках независимо от ваших привязок.

421 421 

422До v2.1.280 эти другие списки игнорировали Home, End и ваши привязки `select:first` и `select:last`.422До v2.1.280 эти другие списки игнорировали Home, End и ваши привязки `select:first` и `select:last`.

423 423 

424До v2.1.283 список инструментов `/mcp` разбивал на страницы с фиксированными клавишами PageUp и PageDown независимо от ваших привязок.

425 

424<h3 id="plugin-actions">426<h3 id="plugin-actions">

425 Действия plugin427 Действия plugin

426</h3>428</h3>


692Claude Code проверяет ваши сочетания клавиш и записывает предупреждение в журнал отладки для:694Claude Code проверяет ваши сочетания клавиш и записывает предупреждение в журнал отладки для:

693 695 

694* Ошибок разбора (неверный JSON или структура)696* Ошибок разбора (неверный JSON или структура)

697* Неправильно написанных модификаторов, таких как `ctl+k`. Claude Code удаляет часть, которую он не распознаёт, и применяет привязку к оставшемуся нажатию клавиши, `k` в этом примере.

695* Неверных имён контекстов698* Неверных имён контекстов

696* Неверных значений действий, таких как действие, которое не является строкой или `null`699* Неверных значений действий, таких как действие, которое не является строкой или `null`

697* Неизвестных имён действий, таких как опечатка зарегистрированного действия. Claude Code пропускает привязку и сохраняет любую привязку по умолчанию для этого ключа в силе. До версии 2.1.246 привязка с неизвестным именем действия молча отключала этот ключ700* Неизвестных имён действий, таких как опечатка зарегистрированного действия. Claude Code пропускает привязку и сохраняет любую привязку по умолчанию для этого ключа в силе. До версии 2.1.246 привязка с неизвестным именем действия молча отключала этот ключ

Details

79 79 

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

81 81 

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).82Пересылайте также keep-alive пинги, потому что Claude Code прерывает потоковый ответ, как только в течение [пяти минут по умолчанию](/docs/ru/network-config#streaming-idle-watchdogs) на него не поступают байты. Во время длительной паузы размышления, SSE события `ping` вышестоящего сервера могут быть единственными байтами на потоке. Если ваш шлюз удаляет или буферизирует их, Claude Code прерывает ответ посередине паузы. Когда вы переводите с вышестоящего сервера, который вообще не отправляет пинги, такого как двоичный event-stream Amazon Bedrock, выдавайте свои собственные события `ping` во время молчаливых пауз.

83 83 

84<h3 id="format-mismatch-with-the-upstream">84<h3 id="format-mismatch-with-the-upstream">

85 Несоответствие формата с вышестоящим сервером85 Несоответствие формата с вышестоящим сервером

managed-mcp.md +23 −6

Details

31 31 

32| Шаблон | Что он делает | Настройка |32| Шаблон | Что он делает | Настройка |

33| :- | :- | :- |33| :- | :- | :- |

34| **Отключить MCP** | Серверы не загружаются, кроме [встроенных серверов, которые регистрирует приложение, запустившее сеанс](#exclusive-control-with-managed-mcp-json), и любых, которые вы [предоставляете через `managedMcpServers`](#provide-servers-through-managed-settings) | `managed-mcp.json` с пустой картой серверов |34| **Отключить MCP** | Серверы не загружаются, кроме нескольких, которые [загружаются под исключительным контролем](#exclusive-control-with-managed-mcp-json) | `managed-mcp.json` с пустой картой серверов |

35| **Фиксированное развертывание** | Каждый пользователь получает одни и те же серверы и не может добавлять другие | `managed-mcp.json` с нужными вам серверами |35| **Фиксированное развертывание** | Каждый пользователь получает одни и те же серверы и не может добавлять другие | `managed-mcp.json` с нужными вам серверами |

36| **Предоставленные серверы** | Каждый пользователь получает удаленные серверы из вашего списка и сохраняет свои собственные | `managedMcpServers` в управляемых параметрах |36| **Предоставленные серверы** | Каждый пользователь получает удаленные серверы из вашего списка и сохраняет свои собственные | `managedMcpServers` в управляемых параметрах |

37| **Утвержденный каталог** | Опубликуйте список утвержденных серверов; пользователи добавляют нужные им, все остальное блокируется | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |37| **Утвержденный каталог** | Опубликуйте список утвержденных серверов; пользователи добавляют нужные им, все остальное блокируется | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |


53* Серверы, которые определяет файл53* Серверы, которые определяет файл

54* Серверы, которые вы [предоставляете через `managedMcpServers`](#provide-servers-through-managed-settings)54* Серверы, которые вы [предоставляете через `managedMcpServers`](#provide-servers-through-managed-settings)

55* Встроенные серверы, которые регистрирует приложение, запустившее сеанс, такие как собственный сервер расширения VS Code или [коннекторы, которые поставляет настольное приложение](/docs/ru/mcp#how-connectors-reach-claude-code)55* Встроенные серверы, которые регистрирует приложение, запустившее сеанс, такие как собственный сервер расширения VS Code или [коннекторы, которые поставляет настольное приложение](/docs/ru/mcp#how-connectors-reach-claude-code)

56* Встроенный сервер [Claude in Chrome](/docs/ru/chrome), если вы [разрешите его наряду с управляемым набором](#allow-claude-in-chrome-alongside-the-managed-set)

56 57 

57Пользователи не могут добавлять, изменять или использовать какие-либо другие MCP серверы, включая серверы, предоставляемые плагинами, и серверы, переданные с помощью [флага CLI `--mcp-config`](/docs/ru/cli-reference#cli-flags). Файл также подавляет коннекторы claude.ai, которые Claude Code загружает сам по себе, если вы не [разрешите их наряду с управляемым набором](#allow-claude-ai-connectors-alongside-the-managed-set).58Пользователи не могут добавлять, изменять или использовать какие-либо другие MCP серверы, включая серверы, предоставляемые плагинами, и серверы, переданные с помощью [флага CLI `--mcp-config`](/docs/ru/cli-reference#cli-flags). Файл также подавляет коннекторы claude.ai, которые Claude Code загружает сам по себе, если вы не [разрешите их наряду с управляемым набором](#allow-claude-ai-connectors-alongside-the-managed-set).

58 59 


144 Отключение MCP полностью145 Отключение MCP полностью

145</h3>146</h3>

146 147 

147Разверните `managed-mcp.json`, содержащий пустую карту серверов, чтобы заблокировать каждый MCP сервер, кроме [встроенных серверов, которые регистрирует приложение, запустившее сеанс](#exclusive-control-with-managed-mcp-json):148Разверните `managed-mcp.json`, содержащий пустую карту серверов, чтобы заблокировать каждый MCP сервер, кроме тех, которые [загружаются под исключительным контролем](#exclusive-control-with-managed-mcp-json):

148 149 

149```json theme={null}150```json theme={null}

150{151{


152}153}

153```154```

154 155 

155`claude mcp add` завершается с ошибкой политики предприятия, указанной выше. Серверы, которые пользователи ранее настроили, перестают загружаться при следующем запуске сеанса, без предупреждения о том, что причина в политике. Серверы, которые вы предоставляете через `managedMcpServers`, по-прежнему загружаются при пустой карте, поэтому оставьте этот ключ также неустановленным, чтобы полностью отключить MCP.156`claude mcp add` завершается с ошибкой политики предприятия, указанной выше. Серверы, которые пользователи ранее настроили, перестают загружаться при следующем запуске сеанса, без предупреждения о том, что причина в политике. Серверы, которые вы предоставляете через `managedMcpServers`, и всё остальное, что вы разрешаете наряду с управляемым набором, по-прежнему загружаются при пустой карте, поэтому оставьте эти ключи неустановленными, чтобы полностью отключить MCP.

156 157 

157<h3 id="allow-claude-ai-connectors-alongside-the-managed-set">158<h3 id="allow-claude-ai-connectors-alongside-the-managed-set">

158 Разрешение коннекторов claude.ai наряду с управляемым набором159 Разрешение коннекторов claude.ai наряду с управляемым набором


166 167 

167Claude Code читает `allowAllClaudeAiMcps` только из контролируемых администратором уровней политики: параметры, управляемые сервером, развёрнутый MDM plist или ключ реестра HKLM, или системный файл `managed-settings.json`. Размещение его в параметрах пользователя или проекта не имеет эффекта, поэтому пользователи не могут повторно включить коннекторы, которые исключительный контроль подавил.168Claude Code читает `allowAllClaudeAiMcps` только из контролируемых администратором уровней политики: параметры, управляемые сервером, развёрнутый MDM plist или ключ реестра HKLM, или системный файл `managed-settings.json`. Размещение его в параметрах пользователя или проекта не имеет эффекта, поэтому пользователи не могут повторно включить коннекторы, которые исключительный контроль подавил.

168 169 

170<h3 id="allow-claude-in-chrome-alongside-the-managed-set">

171 Разрешение Claude in Chrome наряду с управляемым набором

172</h3>

173 

174По умолчанию при развёртывании `managed-mcp.json` Claude Code блокирует встроенный сервер [Claude in Chrome](/docs/ru/chrome) в сеансах терминала. Пользователи не получают [подсказку об установке расширения](/docs/ru/chrome#install-the-extension-when-claude-asks), и сеанс, в котором пользователь [включил Chrome по умолчанию](/docs/ru/chrome#enable-chrome-by-default), запускается без Chrome и не выводит никакого предупреждения. Когда пользователь, который в противном случае мог бы запустить Claude in Chrome, запускает его с помощью `claude --chrome` или `CLAUDE_CODE_ENABLE_CFC=1`, Claude Code завершает работу при запуске с ошибкой, которая называет параметр `allowClaudeInChromeWithManagedMcp`.

175 

176Чтобы позволить пользователям запускать Claude in Chrome наряду с серверами в `managed-mcp.json`, установите `"allowClaudeInChromeWithManagedMcp": true` в управляемых параметрах самого устройства. Поместите его в развёрнутый MDM plist или ключ реестра HKLM, или системный файл `managed-settings.json`, в зависимости от того, что Claude Code [выбирает](/docs/ru/managed-settings#precedence-within-the-managed-tier) на этом устройстве. Требуется Claude Code версии 2.1.282 или позже. До версии 2.1.282 Claude Code игнорирует параметр, и ошибка при запуске читается как `You cannot dynamically configure MCP servers when an enterprise MCP config is present`.

177 

178Claude Code читает параметр из этих источников устройства даже когда [параметры, управляемые сервером](/docs/ru/server-managed-settings), доставляют остальную часть вашей политики. Он игнорирует параметр в самих параметрах, управляемых сервером, в реестре HKCU, доступном для записи пользователем, и в параметрах пользователя или проекта. Запись [`deniedMcpServers`](#policy-based-control-with-allowlists-and-denylists) для `claude-in-chrome` по-прежнему блокирует сервер с параметром.

179 

169<h2 id="provide-servers-through-managed-settings">180<h2 id="provide-servers-through-managed-settings">

170 Предоставление серверов через управляемые параметры181 Предоставление серверов через управляемые параметры

171</h2>182</h2>


303 314 

304| Параметр | Не установлен (по умолчанию) | Пустой массив `[]` | Заполненный |315| Параметр | Не установлен (по умолчанию) | Пустой массив `[]` | Заполненный |

305| :- | :- | :- | :- |316| :- | :- | :- | :- |

306| `allowedMcpServers` | Все серверы разрешены | Серверы не разрешены, кроме [собственных серверов организации](#how-a-server-is-evaluated) | Разрешены только совпадающие серверы, кроме [собственных серверов организации](#how-a-server-is-evaluated) |317| `allowedMcpServers` | Все серверы разрешены | Серверы не разрешены, кроме [тех, которые пропускают проверку списка разрешений](#how-a-server-is-evaluated) | Разрешены только совпадающие серверы, кроме [тех, которые пропускают проверку списка разрешений](#how-a-server-is-evaluated) |

307| `deniedMcpServers` | Серверы не блокируются | Серверы не блокируются | Совпадающие серверы блокируются |318| `deniedMcpServers` | Серверы не блокируются | Серверы не блокируются | Совпадающие серверы блокируются |

308 319 

309Информацию о том, что происходит, когда запись не проходит проверку схемы, см. в разделе [Недействительные записи в управляемых параметрах](/docs/ru/managed-settings#invalid-entries-in-managed-settings).320Информацию о том, что происходит, когда запись не проходит проверку схемы, см. в разделе [Недействительные записи в управляемых параметрах](/docs/ru/managed-settings#invalid-entries-in-managed-settings).


3292. **Проверьте список запретов.** Сервер, который совпадает с любой записью списка запретов по URL, команде или имени, блокируется. Ничто не переопределяет совпадение списка запретов.3402. **Проверьте список запретов.** Сервер, который совпадает с любой записью списка запретов по URL, команде или имени, блокируется. Ничто не переопределяет совпадение списка запретов.

3303. **Проверьте список разрешений.** Если `allowedMcpServers` не установлен нигде, каждый сервер, прошедший список запретов, загружается. Если он установлен, то, с чем должен совпадать сервер, зависит от его типа, показанного в таблице ниже.3413. **Проверьте список разрешений.** Если `allowedMcpServers` не установлен нигде, каждый сервер, прошедший список запретов, загружается. Если он установлен, то, с чем должен совпадать сервер, зависит от его типа, показанного в таблице ниже.

331 342 

332 Собственные серверы организации пропускают эту проверку: каждая запись `managedMcpServers` и любая запись `managed-mcp.json`, значения которой не используют расширение `${VAR}`. Встроенные серверы также пропускают ее, такие как Claude в Chrome, сервер `ide`, к которому Claude Code подключается в работающей IDE VS Code или JetBrains, и серверы, которые сам CLI настраивает.343 Три группы серверов пропускают эту проверку:

344 

345 * Собственные серверы организации: каждая запись `managedMcpServers` и любая запись `managed-mcp.json`, значения которой не используют расширение `${VAR}`.

346 * Встроенные серверы, такие как Claude в Chrome, сервер `ide`, к которому Claude Code подключается в работающей IDE VS Code или JetBrains, и серверы, которые сам CLI настраивает.

347 * Инструменты Slack сеанса [Claude Tag](/docs/ru/claude-tag): серверы, которые он использует для чтения потока и публикации своих ответов, загружаются без записи в список разрешений.

333 348 

334 Сервер `managed-mcp.json`, который использует расширение `${VAR}` в своей команде, аргументах, `env`, URL или заголовках, все еще проверяется, как и каждый сервер, добавленный пользователем, плагином, `--mcp-config` или claude.ai.349 Сервер `managed-mcp.json`, который использует расширение `${VAR}` в своей команде, аргументах, `env`, URL или заголовках, все еще проверяется. Так же как и каждый сервер, добавленный пользователем, плагином, claude.ai, и каждый сервер, переданный пользователем с `--mcp-config`.

335 350 

336| Тип сервера | Разрешено, когда совпадает |351| Тип сервера | Разрешено, когда совпадает |

337| :- | :- |352| :- | :- |


514| Ограничение | Что видит пользователь |529| Ограничение | Что видит пользователь |

515| :- | :- |530| :- | :- |

516| `managed-mcp.json` присутствует и пользователь запускает `claude mcp add` | `Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers` |531| `managed-mcp.json` присутствует и пользователь запускает `claude mcp add` | `Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers` |

532| `managed-mcp.json` присутствует и пользователь, который в противном случае мог бы запустить Claude в Chrome, запускает `claude --chrome` | Claude Code завершает работу при запуске с `Claude in Chrome is blocked by your organization's managed MCP configuration (managed-mcp.json). An administrator can allow it with allowClaudeInChromeWithManagedMcp in device policy.` |

517| Сервер находится в списке запретов и пользователь запускает `claude mcp add` | `Cannot add MCP server "<name>": server is explicitly blocked by enterprise policy` |533| Сервер находится в списке запретов и пользователь запускает `claude mcp add` | `Cannot add MCP server "<name>": server is explicitly blocked by enterprise policy` |

518| Сервер не находится в списке разрешений и пользователь запускает `claude mcp add` | `Cannot add MCP server "<name>": not allowed by enterprise policy` |534| Сервер не находится в списке разрешений и пользователь запускает `claude mcp add` | `Cannot add MCP server "<name>": not allowed by enterprise policy` |

519| Пользователь запускает `claude mcp remove` на сервере из `managedMcpServers` | `MCP server "<name>" is provided by your organization (managed settings) and cannot be removed locally.` |535| Пользователь запускает `claude mcp remove` на сервере из `managedMcpServers` | `MCP server "<name>" is provided by your organization (managed settings) and cannot be removed locally.` |


541| `allowedMcpServers` | Список разрешений разрешенных серверов | Любой [файл настроек](/docs/ru/settings#where-settings-live); [Как сервер оценивается](#how-a-server-is-evaluated) говорит о том, как списки из нескольких областей и управляемых источников объединяются | Для применения, [источник управляемых настроек](/docs/ru/admin-setup#decide-how-settings-reach-devices): server-managed settings, `managed-settings.json`, профиль MDM или реестр |557| `allowedMcpServers` | Список разрешений разрешенных серверов | Любой [файл настроек](/docs/ru/settings#where-settings-live); [Как сервер оценивается](#how-a-server-is-evaluated) говорит о том, как списки из нескольких областей и управляемых источников объединяются | Для применения, [источник управляемых настроек](/docs/ru/admin-setup#decide-how-settings-reach-devices): server-managed settings, `managed-settings.json`, профиль MDM или реестр |

542| `deniedMcpServers` | Список запретов заблокированных серверов | Любой файл настроек; [Как сервер оценивается](#how-a-server-is-evaluated) говорит о том, как списки из нескольких областей и управляемых источников объединяются | То же, что `allowedMcpServers` |558| `deniedMcpServers` | Список запретов заблокированных серверов | Любой файл настроек; [Как сервер оценивается](#how-a-server-is-evaluated) говорит о том, как списки из нескольких областей и управляемых источников объединяются | То же, что `allowedMcpServers` |

543| `allowManagedMcpServersOnly` | Блокирует список разрешений только управляемыми источниками | Только источники управляемых настроек; [Ключи, читаемые из каждого источника администратора](/docs/ru/managed-settings#keys-read-from-every-admin-source) говорит о том, какие управляемые источники могут его включить. Параметр не имеет эффекта в других областях | То же, что `allowedMcpServers` |559| `allowManagedMcpServersOnly` | Блокирует список разрешений только управляемыми источниками | Только источники управляемых настроек; [Ключи, читаемые из каждого источника администратора](/docs/ru/managed-settings#keys-read-from-every-admin-source) говорит о том, какие управляемые источники могут его включить. Параметр не имеет эффекта в других областях | То же, что `allowedMcpServers` |

560| `allowClaudeInChromeWithManagedMcp` | Позволяет встроенному серверу Claude в Chrome работать наряду с `managed-mcp.json` | Управляемые настройки на устройстве только: профиль MDM, реестр HKLM или `managed-settings.json`. Server-managed settings и источники, доступные для записи пользователем, не имеют эффекта | MDM, GPO, управление флотом или любой процесс с правами администратора |

544| `allowAllClaudeAiMcps` | Загружает соединители claude.ai, которые Claude Code получает сам, наряду с `managed-mcp.json`. [Файл `managed-mcp.json` на хосте, на котором запущена облачная сессия, по-прежнему подавляет соединители этой сессии](#allow-claude-ai-connectors-alongside-the-managed-set) | Только источники управляемых настроек; параметр не имеет эффекта в других местах | То же, что `allowedMcpServers` |561| `allowAllClaudeAiMcps` | Загружает соединители claude.ai, которые Claude Code получает сам, наряду с `managed-mcp.json`. [Файл `managed-mcp.json` на хосте, на котором запущена облачная сессия, по-прежнему подавляет соединители этой сессии](#allow-claude-ai-connectors-alongside-the-managed-set) | Только источники управляемых настроек; параметр не имеет эффекта в других местах | То же, что `allowedMcpServers` |

545 562 

546<h2 id="related-resources">563<h2 id="related-resources">

Details

449| [`blockedMarketplaces`](/docs/ru/settings-reference#blockedmarketplaces) | Список блокировки источников маркетплейса. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [управляемые ограничения маркетплейса](/docs/ru/plugins/org#restrict-what-users-can-install) |449| [`blockedMarketplaces`](/docs/ru/settings-reference#blockedmarketplaces) | Список блокировки источников маркетплейса. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [управляемые ограничения маркетплейса](/docs/ru/plugins/org#restrict-what-users-can-install) |

450| [`channelsEnabled`](/docs/ru/settings-reference#channelsenabled) | Разрешить [каналы](/docs/ru/channels) для организации. См. [элементы управления предприятием](/docs/ru/channels#enterprise-controls) для значения по умолчанию на каждом плане |450| [`channelsEnabled`](/docs/ru/settings-reference#channelsenabled) | Разрешить [каналы](/docs/ru/channels) для организации. См. [элементы управления предприятием](/docs/ru/channels#enterprise-controls) для значения по умолчанию на каждом плане |

451| [`disableCommandPluginSources`](/docs/ru/settings-reference#disablecommandpluginsources) | Когда `true`, полностью блокирует [`command` источники плагинов](/docs/ru/plugins/marketplace-reference#command-plugin-source), поэтому объявленная маркетплейсом команда никогда не работает. Также блокирует команды [`headersHelper`](/docs/ru/plugins/host-marketplace#authenticate-archive-downloads) маркетплейса, кроме маркетплейса, который сами управляемые параметры объявляют. Когда не установлено, следует `allowManagedHooksOnly`. Требует Claude Code v2.1.229 или позже, и блок `headersHelper` требует v2.1.238 или позже |451| [`disableCommandPluginSources`](/docs/ru/settings-reference#disablecommandpluginsources) | Когда `true`, полностью блокирует [`command` источники плагинов](/docs/ru/plugins/marketplace-reference#command-plugin-source), поэтому объявленная маркетплейсом команда никогда не работает. Также блокирует команды [`headersHelper`](/docs/ru/plugins/host-marketplace#authenticate-archive-downloads) маркетплейса, кроме маркетплейса, который сами управляемые параметры объявляют. Когда не установлено, следует `allowManagedHooksOnly`. Требует Claude Code v2.1.229 или позже, и блок `headersHelper` требует v2.1.238 или позже |

452| [`disableSideloadFlags`](/docs/ru/settings-reference#disablesideloadflags) | Отклоните флаги `--plugin-dir`, `--plugin-url`, `--agents` и `--mcp-config` при запуске. В облачных сеансах Claude Code отбрасывает MCP серверы, которые сервер доставил через `--mcp-config`, кроме записей `type: "sdk"` в процессе, и запускает сеанс. Требует Claude Code v2.1.193 или позже |452| [`disableSideloadFlags`](/docs/ru/settings-reference#disablesideloadflags) | Отклоните флаги `--plugin-dir`, `--plugin-url`, `--agents` и `--mcp-config` при запуске. В облачных сеансах Claude Code вместо этого запускает сеанс и отбрасывает серверы `--mcp-config`, доставленные сервером, кроме исключений, которые перечисляет его [справочная запись](/docs/ru/settings-reference#disablesideloadflags). Требует Claude Code v2.1.193 или позже |

453| [`forceRemoteSettingsRefresh`](/docs/ru/settings-reference#forceremotesettingsrefresh) | Когда `true`, блокирует запуск CLI, пока управляемые параметры удаленного сервера не будут свежо получены, и выходит, если выборка не удается. См. [применение fail-closed](/docs/ru/server-managed-settings#enforce-fail-closed-startup) |453| [`forceRemoteSettingsRefresh`](/docs/ru/settings-reference#forceremotesettingsrefresh) | Когда `true`, блокирует запуск CLI, пока управляемые параметры удаленного сервера не будут свежо получены, и выходит, если выборка не удается. См. [применение fail-closed](/docs/ru/server-managed-settings#enforce-fail-closed-startup) |

454| [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers) | Удаленные MCP серверы, предоставленные каждому пользователю вместе с их собственными. Он предоставляет серверы, а не блокирует что-либо. См. [Предоставьте серверы через управляемые параметры](/docs/ru/managed-mcp#provide-servers-through-managed-settings). Требует Claude Code v2.1.259 или позже |454| [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers) | Удаленные MCP серверы, предоставленные каждому пользователю вместе с их собственными. Он предоставляет серверы, а не блокирует что-либо. См. [Предоставьте серверы через управляемые параметры](/docs/ru/managed-mcp#provide-servers-through-managed-settings). Требует Claude Code v2.1.259 или позже |

455| [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) | Применяет ли Claude Code только управляемый источник с наивысшим приоритетом или [составляет каждый из них](#compose-every-managed-source) |455| [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) | Применяет ли Claude Code только управляемый источник с наивысшим приоритетом или [составляет каждый из них](#compose-every-managed-source) |

memory.md +6 −0

Details

115 115 

116Допускаются как относительные, так и абсолютные пути. Относительные пути разрешаются относительно файла, содержащего импорт, а не рабочего каталога. Импортированные файлы могут рекурсивно импортировать другие файлы с максимальной глубиной четыре перехода.116Допускаются как относительные, так и абсолютные пути. Относительные пути разрешаются относительно файла, содержащего импорт, а не рабочего каталога. Импортированные файлы могут рекурсивно импортировать другие файлы с максимальной глубиной четыре перехода.

117 117 

118Чтобы импортировать файл, путь которого содержит пробелы, поставьте обратную косую черту перед каждым пробелом. Без обратных косых черт путь заканчивается в первом пробеле, даже если импорт находится на отдельной строке. Путь, заключённый в кавычки, вообще не импортируется, с обратными косыми чертами или без них. Этот импорт загружает файл из папки с именем `Design Docs`:

119 

120```text theme={null}

121- API conventions @Design\ Docs/api-conventions.md

122```

123 

118Анализ импорта пропускает диапазоны кода Markdown и блоки кода с ограждением. Чтобы упомянуть путь в вашем CLAUDE.md без импорта, оберните его в обратные кавычки: написание `` `@README` `` сохраняет текст буквальным, в то время как `@README` вне обратных кавычек импортирует файл.124Анализ импорта пропускает диапазоны кода Markdown и блоки кода с ограждением. Чтобы упомянуть путь в вашем CLAUDE.md без импорта, оберните его в обратные кавычки: написание `` `@README` `` сохраняет текст буквальным, в то время как `@README` вне обратных кавычек импортирует файл.

119 125 

120Чтобы включить README, package.json и руководство по рабочему процессу, ссылайтесь на них с синтаксисом `@` в любом месте вашего CLAUDE.md:126Чтобы включить README, package.json и руководство по рабочему процессу, ссылайтесь на них с синтаксисом `@` в любом месте вашего CLAUDE.md:

model-config.md +16 −16

Details

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 Sonnet 5.5 требует Claude Code версии 2.1.284 или позже, а Opus 5.5 требует версии 2.1.280 или позже. Запустите `claude update` для обновления.68 Sonnet 5.5 требует Claude Code версии 2.1.284 или позже, а Opus 5.5 требует версии 2.1.280 или позже. Если запрос для одной из них из более старой версии не удаётся, см. [Claude Code does not support this model](/docs/ru/errors#claude-code-does-not-support-this-model). Запустите `claude update` для обновления.

69</Note>69</Note>

70 70 

71<h3 id="work-with-fable">71<h3 id="work-with-fable">


164 164 

165Когда Claude Code не может определить, какие PreModelSwitch hooks доставляют [управляемые плагины](/docs/ru/settings-reference#enabledplugins) вашей организации, например потому что управляемый плагин не загрузился, он отказывает в переключении вместо его применения, и он проверяет снова при каждой новой попытке. См. [Model switch was blocked by a PreModelSwitch hook](/docs/ru/errors#model-switch-was-blocked-by-a-premodelswitch-hook) для сообщения и восстановления.165Когда Claude Code не может определить, какие PreModelSwitch hooks доставляют [управляемые плагины](/docs/ru/settings-reference#enabledplugins) вашей организации, например потому что управляемый плагин не загрузился, он отказывает в переключении вместо его применения, и он проверяет снова при каждой новой попытке. См. [Model switch was blocked by a PreModelSwitch hook](/docs/ru/errors#model-switch-was-blocked-by-a-premodelswitch-hook) для сообщения и восстановления.

166 166 

167Когда вы переключаете модели через метод [Agent SDK](/docs/ru/agent-sdk/overview) `setModel()` или с устройства, подключённого через [Remote Control](/docs/ru/remote-control), или приложение, такое как [Desktop app](/docs/ru/desktop), которое запускает CLI Claude Code для вас, Claude Code проверяет, что строка — это та, которую он распознаёт, перед её сохранением. Эта проверка требует Claude Code версии 2.1.200 или позже. Проверка выбора Remote Control требует Claude Code версии 2.1.260 или позже на вашей машине. В Anthropic API Claude Code распознаёт:167Когда вы переключаете модели через метод [Agent SDK](/docs/ru/agent-sdk/overview) `setModel()`, через приложение, такое как [Desktop app](/docs/ru/desktop), или с устройства, подключённого через [Remote Control](/docs/ru/remote-control), Claude Code проверяет значение при переключении:

168 168 

169* псевдоним модели169* **Agent SDK или приложение**: с Claude Code версии 2.1.268 или позже, если Claude Code не принимает ID модели локально, как это происходит для вашего [пользовательского варианта модели](#add-a-custom-model-option), он подтверждает ID у вашего поставщика при первом переключении сеанса на него. Подтверждение выполняется на каждом поставщике, и ID, который ваш поставщик не предлагает, отклоняется при переключении вместо сбоя при следующем запросе.

170* запись из средства выбора `/model`170* **Remote Control**: в Anthropic API Claude Code проверяет значение локально и не отправляет запрос.

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

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

173 171 

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

175 173 

176Проверка запускается только в Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и за [шлюзом LLM](/docs/ru/llm-gateway) или пользовательским `ANTHROPIC_BASE_URL`, ваш поставщик или шлюз определяет имена моделей, поэтому Claude Code пропускает любую строку без проверки. Проверка также не охватывает флаг `--model`, переменную окружения `ANTHROPIC_MODEL` или параметр `model`; неправильно введённое значение там производит [There's an issue with the selected model](/docs/ru/errors#theres-an-issue-with-the-selected-model) при первом запросе вместо этого. Claude Code по-прежнему может написать [строку диагностики нераспознанной модели](/docs/ru/errors#unrecognized-model-id-on-a-request) во время запроса на каждом поставщике.174Если вы установите модель с флагом `--model`, переменной окружения `ANTHROPIC_MODEL` или параметром `model`, Claude Code не проверяет её заранее, и неправильно введённое значение производит [There's an issue with the selected model](/docs/ru/errors#theres-an-issue-with-the-selected-model) при первом запросе.

177 175 

178Когда запрошенная модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, Claude Code показывает предупреждение, которое называет запрошенную модель. Интерактивные сеансы показывают его как уведомление при запуске. Начиная с версии 2.1.182, то же предупреждение записывается в stderr в [неинтерактивном режиме](/docs/ru/headless) при использовании формата вывода текста по умолчанию. Проверка также охватывает `model`, установленный в [фронтматтере подагента](/docs/ru/sub-agents). Предупреждение stderr подавляется для `--output-format json` и `stream-json`; прочитайте фактическую модель из поля `modelUsage` [результирующего сообщения](/docs/ru/headless#get-structured-output) вместо этого.176Когда запрошенная модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, 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) вместо этого.

179 177 


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

242</h2>240</h2>

243 241 

244Администраторы предприятия могут использовать `availableModels` в [управляемых или политических параметрах](/docs/ru/managed-settings) для ограничения того, какие модели могут выбирать пользователи. Записи соответствуют семейству моделей, такому как `sonnet`, префиксу версии, такому как `claude-sonnet-4-5`, или полному идентификатору модели, такому как `claude-sonnet-4-5-20250929`. Префикс версии также соответствует более поздним идентификаторам моделей, которые расширяют его еще одним сегментом, поэтому `claude-fable-5` разрешает как Fable 5, так и Fable 5.1, а `claude-fable-5-1` разрешает только Fable 5.1. Чтобы заблокировать модель, которую разрешает список, или чтобы каждая запись идентификатора модели разрешала только версию, которую она называет, см. [Блокировка конкретных моделей или версий](#block-specific-models-or-versions).242Администраторы могут использовать `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).

245 243 

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

247 245 


249 247 

250* **Модель основной сессии**: `/model`, флаг `--model`, переменная окружения `ANTHROPIC_MODEL`, параметр `model`, [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) и модель, восстановленная при [возобновлении сессии](#setting-your-model)248* **Модель основной сессии**: `/model`, флаг `--model`, переменная окружения `ANTHROPIC_MODEL`, параметр `model`, [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) и модель, восстановленная при [возобновлении сессии](#setting-your-model)

251* **Разрешение псевдонимов**: переменные окружения `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` и `ANTHROPIC_DEFAULT_FABLE_MODEL` не могут перенаправить разрешенный псевдоним на модель вне списка249* **Разрешение псевдонимов**: переменные окружения `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` и `ANTHROPIC_DEFAULT_FABLE_MODEL` не могут перенаправить разрешенный псевдоним на модель вне списка

252* **Быстрый режим**: команда `/fast` отказывает переключаться, когда это неявно переключилось бы на модель Opus вне списка, с сообщением "is not in your organization's allowed models"250* **Fast mode**: команда `/fast` отказывает переключаться, когда это неявно переключилось бы на модель Opus вне списка, с сообщением "is not in your organization's allowed models"

253* **Модели подагента и товарища**: поле `model` в [подагенте](/docs/ru/sub-agents#choose-a-model) frontmatter, параметр `model` инструмента Agent, модели товарищей [команды агентов](/docs/ru/agent-teams#specify-teammates-and-models), `CLAUDE_CODE_SUBAGENT_MODEL` и, в v2.1.197 и более ранних версиях, средство выбора модели в мастере `/agents`&#x20;251* **Модели подагента и товарища**: поле `model` в [подагенте](/docs/ru/sub-agents#choose-a-model) frontmatter, параметр `model` инструмента Agent, модели товарищей [команды агентов](/docs/ru/agent-teams#specify-teammates-and-models), `CLAUDE_CODE_SUBAGENT_MODEL` и, в v2.1.197 и более ранних версиях, средство выбора модели в мастере `/agents`&#x20;

254* **Модели навыков и команд**: frontmatter `model` в [навыках и командах](/docs/ru/skills)252* **Модели skills и команд**: frontmatter `model` в [skills и командах](/docs/ru/skills)

255* **Модель советника**: настроенный параметр [`advisorModel`](/docs/ru/advisor) и флаг `--advisor`253* **Модель советника**: настроенный параметр [`advisorModel`](/docs/ru/advisor) и флаг `--advisor`

256* **Модель фонового агента**: модель, выбранная в [средстве выбора диспетчеризации](/docs/ru/agent-view)254* **Модель фонового агента**: модель, выбранная в [средстве выбора диспетчеризации](/docs/ru/agent-view)

257 255 


269 В интерактивных сессиях Claude Code предупреждает вас, когда он подставляет модель подагента, либо этой резервной копией, либо подстановкой самой новой разрешенной версии выше, называя запрошенную и подставленную модели; он не сообщает о резервной копии товарища.267 В интерактивных сессиях Claude Code предупреждает вас, когда он подставляет модель подагента, либо этой резервной копией, либо подстановкой самой новой разрешенной версии выше, называя запрошенную и подставленную модели; он не сообщает о резервной копии товарища.

270 268 

271 Где работает подстановка самой новой разрешенной версии выше, заблокированный псевдоним семейства следует ей вместо этого. До v2.1.222 псевдоним отступал как любое другое заблокированное значение на каждом поставщике269 Где работает подстановка самой новой разрешенной версии выше, заблокированный псевдоним семейства следует ей вместо этого. До v2.1.222 псевдоним отступал как любое другое заблокированное значение на каждом поставщике

272* **Переопределение навыка или команды**: Claude Code игнорирует переопределение, включая заблокированный псевдоним семейства, и навык или команда запускаются на модели сессии. Навык или команда, которая [запускается в подагенте](/docs/ru/skills#run-skills-in-a-subagent), следует поведению подагента выше вместо этого270* **Переопределение skill или команды**: Claude Code игнорирует переопределение, включая заблокированный псевдоним семейства, и skill или команда запускаются на модели сессии. Skill или команда, которая [запускается в подагенте](/docs/ru/skills#run-skills-in-a-subagent), следует поведению подагента выше вместо этого

273* **Параметр `advisorModel`**: советник отключен для сессии271* **Параметр `advisorModel`**: советник отключен для сессии

274* **Флаг `--advisor`**: Claude Code выходит с ошибкой при запуске. В [фоновой сессии](/docs/ru/agent-view) он запускает сессию без советника вместо выхода272* **Флаг `--advisor`**: Claude Code выходит с ошибкой при запуске. В [фоновой сессии](/docs/ru/agent-view) он запускает сессию без советника вместо выхода

275 273 


278Изменения модели, которые Claude Code делает от вашего имени, проверяются таким же образом:276Изменения модели, которые Claude Code делает от вашего имени, проверяются таким же образом:

279 277 

280* **[Цепочки резервных моделей](#fallback-model-chains)**: записи вне списка разрешений удаляются278* **[Цепочки резервных моделей](#fallback-model-chains)**: записи вне списка разрешений удаляются

281* **Обновления режима Plan**: на Anthropic API и Claude Platform on AWS обновление, такое как [`opusplan`](#opusplan-model-setting) на исключенную модель, использует самую новую разрешенную версию семейства обновления. На поставщиках с идентификаторами моделей, специфичными для поставщика, и когда никакая версия не разрешена, обновление пропускается и планирование продолжается на модели сессии279* **Обновления Plan Mode**: на Anthropic API и Claude Platform on AWS обновление, такое как [`opusplan`](#opusplan-model-setting) на исключенную модель, использует самую новую разрешенную версию семейства обновления. На поставщиках с идентификаторами моделей, специфичными для поставщика, и когда никакая версия не разрешена, обновление пропускается и планирование продолжается на модели сессии

282* **[Автоматический резервный вариант модели](#automatic-model-fallback)**: резервный вариант, целевой объект которого исключен, не запускается, поэтому помеченный запрос заканчивается отказом вместо этого280* **[Автоматический резервный вариант модели](#automatic-model-fallback)**: резервный вариант, целевой объект которого исключен, не запускается, поэтому помеченный запрос заканчивается отказом вместо этого

283* **[Классификатор режима Auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode)**: значение по умолчанию Claude Sonnet 5 классификатора применяется только когда список разрешений разрешает Sonnet 5. Когда он исключен, классификатор запускается на модели сессии, которую список разрешений уже управляет, или на модели Opus, когда сессия запускается на [модели Fable](#work-with-fable). На поставщиках, отличных от Anthropic API, этот резервный вариант Opus запускается на модели Opus поставщика по умолчанию без консультации со списком разрешений. Требуется Claude Code v2.1.210 или позже281* **[Классификатор режима Auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode)**: значение по умолчанию Claude Sonnet 5 классификатора применяется только когда список разрешений разрешает Sonnet 5. Когда он исключен, классификатор запускается на модели сессии, которую список разрешений уже управляет, или на модели Opus, когда сессия запускается на [модели Fable](#work-with-fable). На поставщиках, отличных от Anthropic API, этот резервный вариант Opus запускается на модели Opus поставщика по умолчанию без консультации со списком разрешений. Требуется Claude Code v2.1.210 или позже

284* **[Быстрый режим](/docs/ru/fast-mode)**: включение быстрого режима отказывается, когда модель, на которой сессия будет запускаться впоследствии, находится вне списка разрешений282* **[Fast mode](/docs/ru/fast-mode)**: включение fast mode отказывается, когда модель, на которой сессия будет запускаться впоследствии, находится вне списка разрешений

285 283 

286```json theme={null}284```json theme={null}

287{285{


751| Установка глобального стандартного | Запустите `/config` и переключите Thinking Mode. Сохранено как `alwaysThinkingEnabled` в `~/.claude/settings.json` |749| Установка глобального стандартного | Запустите `/config` и переключите Thinking Mode. Сохранено как `alwaysThinkingEnabled` в `~/.claude/settings.json` |

752| Отключение через переменную окружения | Установите [`MAX_THINKING_TOKENS=0`](/docs/ru/env-vars), что отключает размышление на Anthropic API, кроме Opus 5.5, Sonnet 5.5 и моделей Fable. На [сторонних поставщиках](/docs/ru/third-party-integrations) Claude Code опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения все еще могут думать. Другие значения применяются только с [фиксированным бюджетом размышления](#adaptive-reasoning-and-fixed-thinking-budgets) |750| Отключение через переменную окружения | Установите [`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) |

753 751 

754Вы не можете отключить размышление на Opus 5.5, Sonnet 5.5 или моделях Fable. Переключение сеанса, `alwaysThinkingEnabled` и `MAX_THINKING_TOKENS=0` не имеют эффекта там, и модель решает на каждом шаге, сколько думать на основе уровня усилий.752Вы не можете отключить размышление на Opus 5.5, Sonnet 5.5 или моделях Fable. Переключение сеанса и `/config` строка показывают `Thinking can't be turned off` для этих моделей вместо предложения переключателя, и сохраненный `alwaysThinkingEnabled: false` или `MAX_THINKING_TOKENS=0` не имеет эффекта там. На этих моделях модель решает на каждом шаге, сколько думать на основе уровня усилий. Сохраненный параметр применяется снова, когда вы переключаетесь на модель, которая его принимает.

755 753 

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

757 755 


784 782 

785Окно контекста 1M использует стандартное ценообразование модели без премии за токены сверх 200K. Для планов, где расширенный контекст включен в вашу подписку, использование остается покрытым вашей подпиской. Для планов, которые получают доступ к расширенному контексту через кредиты использования, токены выставляются в счет кредитов использования.783Окно контекста 1M использует стандартное ценообразование модели без премии за токены сверх 200K. Для планов, где расширенный контекст включен в вашу подписку, использование остается покрытым вашей подпиской. Для планов, которые получают доступ к расширенному контексту через кредиты использования, токены выставляются в счет кредитов использования.

786 784 

787Если ваша учетная запись поддерживает контекст 1M, параметр появляется в средстве выбора `/model` в последних версиях Claude Code. Если вы его не видите, попробуйте перезагрузить сеанс.785Если ваша учетная запись поддерживает контекст 1M, параметр появляется в средстве выбора `/model` в последних версиях Claude Code. Если вы его не видите, перезагрузите сеанс, и на сторонних поставщиках проверьте, [закрепила ли ваша развертывание модель](#pin-models-for-third-party-deployments) с переменной `ANTHROPIC_DEFAULT_*_MODEL`.

788 786 

789Вы также можете использовать суффикс `[1m]` с псевдонимами моделей или полными именами моделей:787Вы также можете использовать суффикс `[1m]` с псевдонимами моделей или полными именами моделей:

790 788 


956* Добавляйте `[1m]` только когда базовая модель [поддерживает контекст 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model).954* Добавляйте `[1m]` только когда базовая модель [поддерживает контекст 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model).

957* Суффикс читается для каждой переменной, а не для каждой модели. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификатор модели без `[1m]` в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом. Sonnet 5 всегда работает с окном 1M на этих поставщиках и никогда не требует суффикса.955* Суффикс читается для каждой переменной, а не для каждой модели. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификатор модели без `[1m]` в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом. Sonnet 5 всегда работает с окном 1M на этих поставщиках и никогда не требует суффикса.

958 956 

957Когда вы устанавливаете переменную `ANTHROPIC_DEFAULT_*_MODEL`, средство выбора `/model` показывает одну строку для этой модели вместо встроенных строк семейства, включая любые строки контекста 1M. Чтобы достичь окна 1M без добавления суффикса к этой переменной, ваши пользователи запускают `/model opus[1m]`, и Claude Code применяет суффикс к модели, которую называет переменная. `/model sonnet[1m]` работает так же.

958 

959<Note>959<Note>

960 Список разрешений `availableModels`, доставленный через [MDM или управляемый файл параметров](/docs/ru/managed-settings#delivery-mechanisms), все еще применяется при использовании поставщиков третьих сторон; [параметры, управляемые сервером, не доставляются туда](/docs/ru/server-managed-settings#platform-availability).960 Список разрешений `availableModels`, доставленный через [MDM или управляемый файл параметров](/docs/ru/managed-settings#delivery-mechanisms), все еще применяется при использовании поставщиков третьих сторон; [параметры, управляемые сервером, не доставляются туда](/docs/ru/server-managed-settings#platform-availability).

961 961 

Details

64}64}

65```65```

66 66 

67В приложении Claude Desktop сеансы вкладки Code читают эти управляемые параметры из источников, которые [достигают каждого вида сеанса Desktop](/docs/ru/desktop#managed-settings). Форма OpenTelemetry для Cowork в разделе **Monitoring** в [параметрах конфиденциальности и данных](https://claude.ai/admin-settings/data-privacy-controls) консоли администратора применяется только к сеансам Cowork, поэтому ни терминальный CLI, ни вкладка Code не экспортируют на сборщик, который вы там установили.

68 

67Claude Code игнорирует [переменные экспортера OpenTelemetry](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) в файлах `.claude/settings.json` и `.claude/settings.local.json` репозитория, поэтому репозиторий не может использовать их для включения телеметрии, выбора места её отправки или захвата содержимого. Установите их в управляемых параметрах или попросите каждого разработчика установить их в своей оболочке или в `~/.claude/settings.json`. Репозиторий все ещё может отключить сигнал, установив его селектор экспортера, например `OTEL_LOGS_EXPORTER`, на `none`, если только управляемые параметры, файл `--settings` или окружение, из которого вы запускаете Claude Code, не устанавливают эту переменную.69Claude Code игнорирует [переменные экспортера OpenTelemetry](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) в файлах `.claude/settings.json` и `.claude/settings.local.json` репозитория, поэтому репозиторий не может использовать их для включения телеметрии, выбора места её отправки или захвата содержимого. Установите их в управляемых параметрах или попросите каждого разработчика установить их в своей оболочке или в `~/.claude/settings.json`. Репозиторий все ещё может отключить сигнал, установив его селектор экспортера, например `OTEL_LOGS_EXPORTER`, на `none`, если только управляемые параметры, файл `--settings` или окружение, из которого вы запускаете Claude Code, не устанавливают эту переменную.

68 70 

69Claude Code не передает переменные окружения `OTEL_*` подпроцессам, которые он порождает, включая инструмент Bash, hooks, MCP серверы и языковые серверы. Приложение, инструментированное OpenTelemetry, которое вы запускаете через инструмент Bash, не наследует endpoint экспортера Claude Code или заголовки, поэтому установите эти переменные непосредственно в команде, если это приложение должно экспортировать свою собственную телеметрию.71Claude Code не передает переменные окружения `OTEL_*` подпроцессам, которые он порождает, включая инструмент Bash, hooks, MCP серверы и языковые серверы. Приложение, инструментированное OpenTelemetry, которое вы запускаете через инструмент Bash, не наследует endpoint экспортера Claude Code или заголовки, поэтому установите эти переменные непосредственно в команде, если это приложение должно экспортировать свою собственную телеметрию.

Details

210| First-byte deadline | Заголовки ответа не поступают после отправки запроса Claude Code | Прямой API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), включая через HTTPS-прокси, но не когда `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL` маршрутизируют их через [gateway](/docs/ru/gateways). Opt-in на Amazon Bedrock с `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; не работает на Google Cloud's Agent Platform или Microsoft Foundry | 180 секунд на прямом API Anthropic, 300 секунд в других местах, плюс одна секунда на 32 КБ тела запроса |210| First-byte deadline | Заголовки ответа не поступают после отправки запроса Claude Code | Прямой API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), включая через HTTPS-прокси, но не когда `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL` маршрутизируют их через [gateway](/docs/ru/gateways). Opt-in на Amazon Bedrock с `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; не работает на Google Cloud's Agent Platform или Microsoft Foundry | 180 секунд на прямом API Anthropic, 300 секунд в других местах, плюс одна секунда на 32 КБ тела запроса |

211| Event-level watchdog | События ответа не анализируются. На соединениях, где работает byte-level watchdog, поступающие байты, включая keep-alive пинги, также сбрасывают этот watchdog, примерно на пять минут без анализируемого события | Каждый провайдер | 300 секунд |211| Event-level watchdog | События ответа не анализируются. На соединениях, где работает byte-level watchdog, поступающие байты, включая keep-alive пинги, также сбрасывают этот watchdog, примерно на пять минут без анализируемого события | Каждый провайдер | 300 секунд |

212| Byte-level watchdog | На проводе не поступают байты, включая SSE keep-alive пинги | Прямой API Anthropic, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и [gateway](/docs/ru/gateways) соединения, включая пользовательский `ANTHROPIC_BASE_URL`. Opt-in на Amazon Bedrock `vnd.amazon.eventstream` ответы с `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; не работает на Google Cloud's Agent Platform или Microsoft Foundry | 180 секунд на прямом API Anthropic, 300 секунд в других местах |212| Byte-level watchdog | На проводе не поступают байты, включая SSE keep-alive пинги | Прямой API Anthropic, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и [gateway](/docs/ru/gateways) соединения, включая пользовательский `ANTHROPIC_BASE_URL`. Opt-in на Amazon Bedrock `vnd.amazon.eventstream` ответы с `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; не работает на Google Cloud's Agent Platform или Microsoft Foundry | 180 секунд на прямом API Anthropic, 300 секунд в других местах |

213| Body idle timeout | Байты не поступают в течение 5 минут | Провайдеры, отличные от прямого API Anthropic и Claude Platform on AWS, если только [`API_FORCE_IDLE_TIMEOUT`](/docs/ru/env-vars) это не изменит | 5 минут |213| Body idle timeout | Байты не поступают в течение 5 минут | Провайдеры, отличные от прямого API Anthropic, Claude Platform on AWS и Amazon Bedrock с установленным `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`, если только [`API_FORCE_IDLE_TIMEOUT`](/docs/ru/env-vars) это не изменит | 5 минут |

214 

215Если вы установите `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`, byte-level watchdog заменит body idle timeout на Bedrock вместо того, чтобы работать рядом с ним. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` затем также определяет, как долго поток Bedrock может оставаться молчаливым, прежде чем Claude Code будет рассматривать соединение как мёртвое, в пределах указанных ниже лимитов. Поступающие байты по-прежнему не сбрасывают event-level watchdog на Bedrock. При включённом debug logging каждый поток Bedrock затем регистрирует отладочное сообщение, которое начинается с `wire-heartbeat: _chunkTimes absent`.

214 216 

215Настройте таймеры с помощью этих переменных, каждая из которых подробно описана в [справочнике переменных окружения](/docs/ru/env-vars):217Настройте таймеры с помощью этих переменных, каждая из которых подробно описана в [справочнике переменных окружения](/docs/ru/env-vars):

216 218 


277 279 

278Если ваша организация GitHub Enterprise Cloud ограничивает доступ по IP-адресу, включите [IP allow list inheritance for installed GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps) и также [add an allow list entry](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) для [исходящих IP-адресов](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) Anthropic. Наследование охватывает только запросы, которые делает Claude GitHub App как установка, а не запросы, которые она делает от имени ваших пользователей. Для других брандмауэров см. [Anthropic API IP addresses](https://platform.claude.com/docs/en/api/ip-addresses).280Если ваша организация GitHub Enterprise Cloud ограничивает доступ по IP-адресу, включите [IP allow list inheritance for installed GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps) и также [add an allow list entry](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) для [исходящих IP-адресов](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) Anthropic. Наследование охватывает только запросы, которые делает Claude GitHub App как установка, а не запросы, которые она делает от имени ваших пользователей. Для других брандмауэров см. [Anthropic API IP addresses](https://platform.claude.com/docs/en/api/ip-addresses).

279 281 

280Для размещенных на собственном сервере экземпляров [GitHub Enterprise Server](/docs/ru/github-enterprise-server) за брандмауэром добавьте в белый список [исходящие IP-адреса](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) Anthropic, чтобы инфраструктура Anthropic могла достичь вашего хоста GHES для клонирования репозиториев и публикации комментариев рецензии. Сеансы в [self-hosted environment](/docs/ru/self-hosted-environments-deploy#configure-git) достигают вашего хоста GHES изнутри вашей сети вместо этого, поэтому это воздействие применяется только к сеансам, размещенным на Anthropic, к размещенным предварительным потокам сеанса, таким как средство выбора репозитория, и к размещенным на собственном сервере runners, которые согласятся на [Anthropic git proxy](/docs/ru/self-hosted-environments-deploy#use-the-anthropic-git-proxy), который получает со стороны Anthropic. Для хоста GHES, который маршрутизируется только внутри вашей сети, [SCM connector](/docs/ru/self-hosted-environments-reference#scm-connector-flags) переносит размещенные предварительные потоки сеанса через исходящее соединение вместо этого, поэтому белый список не требуется для них.282Для размещенных на собственном сервере экземпляров [GitHub Enterprise Server](/docs/ru/github-enterprise-server) за брандмауэром добавьте в белый список [исходящие IP-адреса](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) Anthropic, чтобы инфраструктура Anthropic могла достичь вашего хоста GHES для клонирования репозиториев и публикации комментариев рецензии. Сеансы в [self-hosted environment](/docs/ru/self-hosted-environments-deploy#configure-git) достигают вашего хоста GHES изнутри вашей сети вместо этого, поэтому это воздействие применяется только к сеансам, размещенным на Anthropic, к размещенным предварительным потокам сеанса, таким как средство выбора репозитория, и к размещенным на собственном сервере runners, которые согласятся на [Anthropic git proxy](/docs/ru/self-hosted-environments-deploy#use-the-anthropic-git-proxy), который получает со стороны Anthropic. [SCM connector](/docs/ru/self-hosted-environments-reference#scm-connector-flags) недоступен, поэтому размещенные предварительные потоки сеанса не могут достичь хост GHES, который маршрутизируется только внутри вашей сети.

281 283 

282<h3 id="desktop-and-claude-ai">284<h3 id="desktop-and-claude-ai">

283 Desktop и claude.ai285 Desktop и claude.ai

Details

526 * В сеансе с [проверкой классификатора на стороне сервера](#server-side-classifier-review), действия только для чтения и [команды оболочки в песочнице](/docs/ru/sandboxing#sandbox-modes) ждут эту проверку и блокируются, если она их отмечает526 * В сеансе с [проверкой классификатора на стороне сервера](#server-side-classifier-review), действия только для чтения и [команды оболочки в песочнице](/docs/ru/sandboxing#sandbox-modes) ждут эту проверку и блокируются, если она их отмечает

527 * Запись внутри вашего рабочего каталога, которую [проверка symlink](/docs/ru/permissions#symlinks) разрешает на местоположение вне него, спрашивает вас527 * Запись внутри вашего рабочего каталога, которую [проверка symlink](/docs/ru/permissions#symlinks) разрешает на местоположение вне него, спрашивает вас

528 3. Все остальное идет к классификатору, кроме [удаления критических путей](#critical-paths) при их обработке по умолчанию. Инструменты connector и `requiresUserInteraction` MCP инструменты, которые спрашивают вас напрямую на шаге 1, никогда не достигают классификатора, поэтому ни одобрение, требуемое организацией, ни шаг согласия не автоматически одобряются528 3. Все остальное идет к классификатору, кроме [удаления критических путей](#critical-paths) при их обработке по умолчанию. Инструменты connector и `requiresUserInteraction` MCP инструменты, которые спрашивают вас напрямую на шаге 1, никогда не достигают классификатора, поэтому ни одобрение, требуемое организацией, ни шаг согласия не автоматически одобряются

529 4. Если классификатор блокирует, Claude получает причину и пытается альтернативу. В большинстве сеансов причина называет правило, которое классификатор совпал, такое как `[Data Exfiltration]`, вместо того чтобы давать письменное объяснение; смотрите [Проверка отказов](/docs/ru/auto-mode-config#review-denials)529 4. Если классификатор блокирует, Claude получает причину. В большинстве сеансов причина называет правило, которое классификатор совпал, такое как `[Data Exfiltration]`, вместо того чтобы давать письменное объяснение; смотрите [Проверка отказов](/docs/ru/auto-mode-config#review-denials)

530 530 

531 При входе в автоматический режим широкие правила разрешения, которые предоставляют произвольное выполнение кода, отбрасываются:531 При входе в автоматический режим широкие правила разрешения, которые предоставляют произвольное выполнение кода, отбрасываются:

532 532 

Details

267 267 

268Если вы опустите `--scope`, команда обновляет плагин в наиболее специфичной области действия, в которой он установлен для вашего текущего проекта, проверяя local, project, user, затем managed.268Если вы опустите `--scope`, команда обновляет плагин в наиболее специфичной области действия, в которой он установлен для вашего текущего проекта, проверяя local, project, user, затем managed.

269 269 

270До v2.1.281 команда использовала `user`, когда вы опускали `--scope`, поэтому обновление плагина, установленного только в области действия project или local, не выполнялось с `Plugin "<name>" is not installed at scope user`. На этих версиях передайте `--scope`.270До v2.1.281 команда использовала `user`, когда вы опускали `--scope`, поэтому обновление плагина, установленного только в области действия project или local, не выполняется с `Plugin "<name>" is not installed at scope user`. На этих версиях передайте `--scope`.

271 271 

272`managed` — это единственная область действия, которую вы можете обновить, но не установить. Для плагинов, установленных администратором, см. [Управление плагинами для вашей организации](/docs/ru/plugins/org).272`managed` — это единственная область действия, которую вы можете обновить, но не установить. Для плагинов, установленных администратором, см. [Управление плагинами для вашей организации](/docs/ru/plugins/org).

273 273 


707Удалите объявление маркетплейса из ваших параметров. `rm` — это псевдоним для `remove`.707Удалите объявление маркетплейса из ваших параметров. `rm` — это псевдоним для `remove`.

708 708 

709<Warning>709<Warning>

710 Когда вы удаляете маркетплейс из последней области действия, которая его объявляет, Claude Code также удаляет его кэш и удаляет каждый плагин, который вы установили из него. Без `--scope` команда удаляет объявление из каждой области действия. Чтобы обновить маркетплейс без потери его плагинов, запустите `plugin marketplace update` вместо этого.710 Когда вы удаляете маркетплейс из последней области действия, которая его объявляет, Claude Code также удаляет его кэш и удаляет каждый плагин, который вы установили из него. Он также удаляет их сохранённые [параметры и секреты](/docs/ru/plugins/manifest-reference#user-configuration) и [данные](/docs/ru/plugins/components#path-variables-and-persistent-data), где это возможно.

711 

712 Чтобы обновить маркетплейс без потери его плагинов, запустите `plugin marketplace update` вместо этого.

711</Warning>713</Warning>

712 714 

713```bash theme={null}715```bash theme={null}


726claude plugin marketplace remove your-marketplace728claude plugin marketplace remove your-marketplace

727```729```

728 730 

729Claude Code выводит `Successfully removed marketplace: your-marketplace`, добавляя `(from project settings)`, когда вы его ограничили. Если вы ограничиваете файл параметров, который не объявляет маркетплейс, команда не выполняется с `Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.`731Claude Code выводит `Successfully removed marketplace: your-marketplace`. Когда команда удаляет плагины, выходные данные выводят их под строкой, такой как `Also uninstalled 2 plugins from this marketplace:`. Чтобы использовать один из них снова, добавьте маркетплейс обратно и переустановите плагин.

732 

733Если вы ограничиваете файл параметров, который не объявляет маркетплейс, команда не выполняется с `Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.`

730 734 

731<h3 id="plugin-marketplace-update">735<h3 id="plugin-marketplace-update">

732 plugin marketplace update736 plugin marketplace update

Details

126 126 

127Каждый плагин, который вы распространяете, — это один объект в массиве `plugins` файла `marketplace.json`. Чтобы добавить второй плагин, добавьте второй объект. Эти поля охватывают большинство записей:127Каждый плагин, который вы распространяете, — это один объект в массиве `plugins` файла `marketplace.json`. Чтобы добавить второй плагин, добавьте второй объект. Эти поля охватывают большинство записей:

128 128 

129* `name`: идентификатор, который люди вводят перед `@` при установке. Он не может содержать пробелы.129* `name`: идентификатор, который люди вводят перед `@` при установке. [Записи плагинов](/docs/ru/plugins/marketplace-reference#plugin-entries) указывает символы, которые может использовать имя.

130* `source`: откуда Claude Code загружает плагин. Напишите строку относительного пути для плагина внутри каталога marketplace, как в [пошаговом руководстве](#create-a-marketplace), или объект source для плагина вне его. См. [Выбор источника плагина](#choose-a-plugin-source).130* `source`: откуда Claude Code загружает плагин. Напишите строку относительного пути для плагина внутри каталога marketplace, как в [пошаговом руководстве](#create-a-marketplace), или объект source для плагина вне его. См. [Выбор источника плагина](#choose-a-plugin-source).

131* `description`: строка, которую люди видят рядом с плагином при просмотре вашего marketplace в `/plugin`.131* `description`: строка, которую люди видят рядом с плагином при просмотре вашего marketplace в `/plugin`.

132 132 


199 199 

200* Ошибки синтаксиса JSON, как `json: Invalid JSON syntax: <reason>`200* Ошибки синтаксиса JSON, как `json: Invalid JSON syntax: <reason>`

201* Отсутствующие требуемые поля, такие как `owner: Invalid input`201* Отсутствующие требуемые поля, такие как `owner: Invalid input`

202* Имя marketplace с пробелами, символами, отличными от ASCII, или форму, которая имитирует официальный marketplace Anthropic, такой как `claude-official`202* Имя marketplace или плагина, которое нарушает правила именования в [справочнике marketplace](/docs/ru/plugins/marketplace-reference#top-level-fields)

203* Относительный `source`, содержащий `..`203* Относительный `source`, содержащий `..`

204* Неизвестные поля на верхнем уровне или в записи плагина, как предупреждения204* Неизвестные поля на верхнем уровне или в записи плагина, как предупреждения

205* Проблемы в `plugin.json` каждого плагина с относительным путем, как `plugins[N] plugin.json → <field>: <message>`205* Проблемы в `plugin.json` каждого плагина с относительным путем, как `plugins[N] plugin.json → <field>: <message>`

plugins/loading.md +33 −25

Details

47Включённый плагин, который ни один путь не загрузил и у которого нет пригодного для использования каталога кэша, показывает `Plugin "<name>" not cached at <path>` на вкладке `/plugin` **Errors**, и `claude plugin list` добавляет `— run /plugin to refresh` на ту же строку. Для исправления см. [`Plugin "<name>" not cached at <path>`](/docs/ru/plugins/troubleshooting#plugin-not-cached-at).47Включённый плагин, который ни один путь не загрузил и у которого нет пригодного для использования каталога кэша, показывает `Plugin "<name>" not cached at <path>` на вкладке `/plugin` **Errors**, и `claude plugin list` добавляет `— run /plugin to refresh` на ту же строку. Для исправления см. [`Plugin "<name>" not cached at <path>`](/docs/ru/plugins/troubleshooting#plugin-not-cached-at).

48 48 

49<h2 id="find-where-a-plugin-came-from">49<h2 id="find-where-a-plugin-came-from">

50 Найдите, откуда пришёл плагин50 Узнайте, откуда взялся плагин

51</h2>51</h2>

52 52 

53Каждый плагин имеет идентификатор вида `<name>@<origin>`, который вы видите в файлах параметров и в `claude plugin list --json`. Часть после `@` говорит вам, где Claude Code нашёл плагин:53Каждый плагин имеет идентификатор вида `<name>@<origin>`, который вы видите в файлах настроек и в выводе `claude plugin list --json`. Часть после `@` указывает, где Claude Code нашел плагин:

54 54 

55| ID заканчивается на | Как плагин туда попал | Как вы его включаете или отключаете |55| ID заканчивается на | Как плагин попал сюда | Как его включить или отключить |

56| :- | :- | :- |56| :- | :- | :- |

57| `@<marketplace>` | Вы установили его из маркетплейса, который добавили | `"<name>@<marketplace>": true` или `false` под `enabledPlugins` в файле параметров |57| `@<marketplace>` | Вы установили его из маркетплейса, который добавили | `"<name>@<marketplace>": true` или `false` под `enabledPlugins` в файле настроек |

58| `@inline` | Вы запустили Claude Code с `--plugin-dir` или `--plugin-url`, установили [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ru/env-vars#variables), или приложение Agent SDK передало опцию `plugins`. Он загружается только для этого сеанса | Включен для сеанса, если только манифест не устанавливает `defaultEnabled: false` или файл параметров не устанавливает `"<name>@inline": false` |58| `@inline` | Вы запустили Claude Code с `--plugin-dir` или `--plugin-url`, установили [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ru/env-vars#variables), или приложение Agent SDK передало опцию `plugins`. Он загружается только для этого сеанса | Включен для сеанса, если только манифест не устанавливает `defaultEnabled: false` или файл настроек не устанавливает `"<name>@inline": false` |

59| `@skills-dir` | Вы сохранили каталог плагина, который имеет `.claude-plugin/plugin.json` в `~/.claude/skills/` или в `.claude/skills/` проекта | `defaultEnabled` манифеста, если только файл параметров не устанавливает `"<name>@skills-dir"` в `true` или `false` |59| `@skills-dir` | Вы сохранили директорию плагина с `.claude-plugin/plugin.json` под `~/.claude/skills/` или `.claude/skills/` проекта | `defaultEnabled` из манифеста, если только файл настроек не устанавливает `"<name>@skills-dir"` в `true` или `false` |

60| `@synced` | Вы или ваша организация включили его для вашей учётной записи claude.ai, и Claude Code [загрузил его](#synced-plugins) | Включен, если только манифест не устанавливает `defaultEnabled: false` или файл параметров не устанавливает `"<name>@synced": false`. Плагин, который ваша организация отмечает как обязательный, загружается в любом случае |60| `@synced` | Вы или ваша организация включили его для вашего аккаунта claude.ai, и Claude Code [загрузил его](#synced-plugins) | Включен, если только манифест не устанавливает `defaultEnabled: false` или файл настроек не устанавливает `"<name>@synced": false`. Плагин, который ваша организация отмечает как обязательный, загружается в любом случае |

61 61 

62Для плагина маркетплейса `<name>` — это имя записи в `marketplace.json`; для `@inline` и `@skills-dir` это `name` в манифесте плагина.62Для плагина маркетплейса `<name>` — это имя записи в `marketplace.json`; для `@inline` и `@skills-dir` это `name` в манифесте плагина.

63 63 


69 69 

70Плагин маркетплейса имеет два имени, и они могут отличаться:70Плагин маркетплейса имеет два имени, и они могут отличаться:

71 71 

72* **Имя записи в `marketplace.json`**: ключ установки и включения. Это то, что вы пишете в `enabledPlugins`, по чему назван каталог кэша, и что показывает `claude plugin list`72* **Имя записи в `marketplace.json`**: ключ установки и включения. Это то, что вы пишете в `enabledPlugins`, по чему названа директория кэша, и что показывает `claude plugin list`

73* **`name` в манифесте**: то, под чем пространства имён компонентов плагина, и что сравнивают [конфликты имён](#name-conflicts)73* **`name` в манифесте**: пространство имен, под которым находятся компоненты плагина, и что сравнивается при [конфликтах имен](#name-conflicts)

74 74 

75<h3 id="plugins-shared-through-a-repository">75<h3 id="plugins-shared-through-a-repository">

76 Плагины, общие через репозиторий76 Плагины, общие через репозиторий

77</h3>77</h3>

78 78 

79Чтобы поделиться плагином через репозиторий, перечислите его под `enabledPlugins` в `.claude/settings.json` или поместите его в `.claude/skills/`. Claude Code не сканирует каталог `.claude/plugins/` проекта.79Чтобы поделиться плагином через репозиторий, перечислите его под `enabledPlugins` в `.claude/settings.json` или поместите его под `.claude/skills/`. Claude Code не сканирует директорию `.claude/plugins/` проекта.

80 80 

81Облачный сеанс не добавляет маркетплейсы, которые репозиторий перечисляет под [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces), потому что это требует диалога доверия рабочей области, который облачный сеанс никогда не показывает.81Облачный сеанс не добавляет маркетплейсы, которые репозиторий перечисляет под [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces), потому что это требует диалога доверия рабочей области, который облачный сеанс никогда не показывает.

82 82 

83Плагин каталога навыков с областью проекта загружается только из `.claude/skills/` [основного рабочего каталога](/docs/ru/permissions#working-directories) сеанса и только после того, как вы примете [диалог доверия рабочей области](/docs/ru/permissions#what-runs-before-you-trust-a-folder) для этого каталога. Он не [ищет родительские каталоги вверх до корня репозитория](/docs/ru/skills#discovery-from-parent-and-nested-directories) так, как это делают обычные навыки и команды. Если вы запустите из подкаталога, плагин в корне репозитория не загрузится. Запустите из корня репозитория вместо этого, или [переместите сеанс туда с помощью `/cd`](/docs/ru/permissions#move-the-session-to-another-directory) на v2.1.246 или позже.83Плагин skills-directory с областью действия проекта загружается только из `.claude/skills/` [основной рабочей директории](/docs/ru/permissions#working-directories) сеанса и только после того, как вы примете [диалог доверия рабочей области](/docs/ru/permissions#what-runs-before-you-trust-a-folder) для этой папки. Он не [ищет родительские директории вверх до корня репозитория](/docs/ru/skills#discovery-from-parent-and-nested-directories) так, как это делают обычные skills и команды. Если вы запустите из поддиректории, плагин в корне репозитория не загрузится. Вместо этого запустите из корня репозитория или [переместите сеанс туда с помощью `/cd`](/docs/ru/permissions#move-the-session-to-another-directory) на v2.1.246 или позже.

84 84 

85Плагин с областью проекта проверяется в репозиторий и достигает каждого сотрудника, который его клонирует. Поскольку это содержимое поступает из репозитория, а не от вас, оно загружается только после той же проверки доверия, которая применяется к правилам разрешения проекта в `.claude/settings.json`. Доверие к родительской папке или запуск с `-p` недостаточно. Компоненты, которые выполняют код, имеют дополнительные ограничения:85Плагин с областью действия проекта проверяется в репозиторий и доступен каждому сотруднику, который его клонирует. Поскольку это содержимое поступает из репозитория, а не от вас, оно загружается только после той же проверки доверия, которая применяется к правилам разрешения проекта в `.claude/settings.json`. Доверия к родительской папке или запуска с `-p` недостаточно. Компоненты, которые выполняют код, имеют дополнительные ограничения:

86 86 

87* MCP серверы, которые он объявляет, проходят через [то же одобрение для каждого сервера](/docs/ru/mcp), что и проект `.mcp.json`87* MCP серверы, которые он объявляет, проходят через [то же одобрение для каждого сервера](/docs/ru/mcp), что и проект `.mcp.json`

88* MCP серверы, которые он объявляет как [MCP пакет](/docs/ru/plugins/manifest-reference#mcpservers), файл `.mcpb` или `.dxt`, или из файла вне каталога плагина, пропускаются. Объявляйте их встроенными или в `.mcp.json` внутри каталога плагина88* MCP серверы, которые он объявляет как [MCP bundle](/docs/ru/plugins/manifest-reference#mcpservers), файл `.mcpb` или `.dxt`, или из файла вне директории плагина пропускаются. Объявляйте их встроенными или в `.mcp.json` внутри директории плагина

89* [Фоновые мониторы](/docs/ru/plugins/components#monitors) не загружаются89* [Фоновые мониторы](/docs/ru/plugins/components#monitors) не загружаются

90 90 

91Плагины с областью пользователя не имеют этих ограничений.91Плагины с личной областью действия не имеют этих ограничений.

92 92 

93О том, как писать плагины `--plugin-dir` и каталога навыков, см. [Создание плагинов](/docs/ru/plugins/create).93О том, как писать плагины `--plugin-dir` и skills-directory, см. [Создание плагинов](/docs/ru/plugins/create).

94 94 

95<h3 id="synced-plugins">95<h3 id="synced-plugins">

96 Плагины, синхронизированные с claude.ai96 Плагины, синхронизированные с claude.ai

97</h3>97</h3>

98 98 

99Плагин, который вы включаете для своей учётной записи claude.ai, также загружается в Claude Code рядом с плагинами, которые вы устанавливаете из маркетплейсов. Это включает плагины, которые ваша организация включает для своих членов. Каждый из этих плагинов загружается как `<name>@synced`, без маркетплейса и без [записи об установке](#check-which-stage-a-plugin-reached).99Плагин, который вы включаете для своего аккаунта claude.ai, также загружается в Claude Code вместе с плагинами, которые вы устанавливаете из маркетплейсов. Это включает плагины, которые ваша организация включает для своих членов. Каждый из этих плагинов загружается как `<name>@synced`, без маркетплейса и без [записи об установке](#check-which-stage-a-plugin-reached).

100 100 

101В сеансах терминала навыки, агенты, hooks, MCP серверы и LSP серверы синхронизированного плагина все загружаются с тем же доверием, что и плагин маркетплейса, который вы установили.101В сеансах терминала все skills, агенты, hooks, MCP серверы и LSP серверы синхронизированного плагина загружаются с тем же доверием, что и плагин маркетплейса, который вы установили.

102 102 

103О компонентах, которые загружает Cowork, см. [таблицу поддержки компонентов](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app) на 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 

107* **[Cowork](https://claude.com/product/cowork)**: Claude Code загружает их в собственную среду сеанса при запуске сеанса107* **[Cowork](https://claude.com/product/cowork)**: Claude Code загружает их в собственную среду сеанса при запуске сеанса

108* **Сеансы терминала**: каждый раз, когда вы запускаете Claude Code, он синхронизируется один раз в фоновом режиме, загружая новые и обновлённые плагины и удаляя те, которые вы или ваша организация отключили. Синхронизация в сеансах терминала требует Claude Code v2.1.273 или позже108* **Сеансы терминала**: каждый раз, когда вы запускаете Claude Code, он синхронизируется один раз в фоне, загружая новые и обновленные плагины и удаляя те, которые вы или ваша организация отключили. Синхронизация в сеансах терминала требует Claude Code v2.1.273 или позже

109 109 

110<h4 id="sync-timing-in-terminal-sessions">110<h4 id="sync-timing-in-terminal-sessions">

111 Время синхронизации в сеансах терминала111 Время синхронизации в сеансах терминала

112</h4>112</h4>

113 113 

114Поскольку синхронизация терминала выполняется в фоновом режиме, она может завершиться после запуска вашего сеанса. Когда она добавляет, обновляет или удаляет синхронизированный плагин в интерактивном сеансе, вы видите `Plugins changed. Run /reload-plugins to activate.` Запустите `/reload-plugins`, чтобы загрузить изменение в этом сеансе, или оставьте его на следующий раз, когда вы запустите Claude Code.114Поскольку синхронизация терминала выполняется в фоне, она может завершиться после запуска вашего сеанса. Когда она добавляет, обновляет или удаляет синхронизированный плагин в интерактивном сеансе, вы видите `Plugins changed. Run /reload-plugins to activate.` Запустите `/reload-plugins`, чтобы загрузить изменение в этом сеансе, или оставьте его на следующий раз, когда вы запустите Claude Code.

115 115 

116Если вы включите плагин на claude.ai во время работы сеанса, плагин загрузится в следующий раз, когда вы запустите Claude Code.116Если вы включите плагин на claude.ai во время работы сеанса, плагин загрузится в следующий раз, когда вы запустите Claude Code.

117 117 

118<h4 id="sign-in-requirements-for-terminal-sync">118<h4 id="sign-in-requirements-for-terminal-sync">

119 Требования входа для синхронизации терминала119 Требования к входу для синхронизации терминала

120</h4>120</h4>

121 121 

122В вашем терминале плагины синхронизируются только в сеансах, где вы входите с помощью своей учётной записи claude.ai.122В вашем терминале плагины синхронизируются только в сеансах, где вы входите со своим аккаунтом claude.ai.

123 123 

124Если вы вошли в более ранней версии Claude Code, этот вход не охватывает плагины до тех пор, пока Claude Code не обновит его в фоновом режиме. Чтобы получить доступ раньше, запустите `/login` снова. Синхронизация плагинов затем начнётся в следующий раз, когда вы запустите Claude Code.124Claude Code ни загружает, ни загружает синхронизированные плагины в этих сеансах терминала, даже после того, как вы входите с помощью `/login`:

125 

126* Сеанс, где `ANTHROPIC_AUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN` или скрипт `apiKeyHelper` предоставляет учетные данные вместо этого входа

127* Сеанс, который не [получает флаги функций от Anthropic](/docs/ru/env-vars#features-that-need-feature-flag-fetching), например тот, где вы установили `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

128* Сеанс в [bare mode](/docs/ru/headless#start-faster-with-bare-mode) или тот, который вы запустили с `--safe-mode`

129* Сеанс, который вы запустили со списком [`--setting-sources`](/docs/ru/cli-reference#cli-flags), который исключает `user`

130 

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

125 132 

126<h4 id="control-which-synced-plugins-load">133<h4 id="control-which-synced-plugins-load">

127 Контролируйте, какие синхронизированные плагины загружаются134 Контролируйте, какие синхронизированные плагины загружаются


129 136 

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

131 138 

132* **Один плагин**: `claude plugin disable <name>@synced` в вашей оболочке и вкладка `/plugin` **Installed** в сеансе оба сохраняют `"<name>@synced": false` в вашем пользовательском уровне [`enabledPlugins`](/docs/ru/settings-reference#enabledplugins). Чтобы держать плагин вне проекта в каждой среде, установите тот же ключ в коммитированный `.claude/settings.json` проекта139* **Один плагин**: `claude plugin disable <name>@synced` в вашей оболочке и вкладка **Installed** в `/plugin` в сеансе оба сохраняют `"<name>@synced": false` в вашем пользовательском уровне [`enabledPlugins`](/docs/ru/settings-reference#enabledplugins). Чтобы исключить плагин из проекта в каждой среде, установите тот же ключ в коммитированный `.claude/settings.json` проекта

133* **Все синхронизированные плагины на машине**: установите [`syncClaudeAiPlugins`](/docs/ru/settings-reference#syncclaudeaiplugins) в `false` в ваших пользовательских параметрах, или ваша организация устанавливает это в [управляемых параметрах](/docs/ru/managed-settings). Claude Code прекращает загрузку, и в следующий раз, когда вы его запустите, он перемещает плагины, которые он уже синхронизировал, в `~/.claude/plugins/.trash/` и больше их не загружает. Если ваша организация отключит Skills на claude.ai, плагины также перестанут синхронизироваться140* **Все синхронизированные плагины на машине**: установите [`syncClaudeAiPlugins`](/docs/ru/settings-reference#syncclaudeaiplugins) в `false` в ваших пользовательских настройках, или ваша организация устанавливает это в [управляемых настройках](/docs/ru/managed-settings). Claude Code прекращает загрузку, и в следующий раз, когда вы его запустите, он перемещает плагины, которые он уже синхронизировал, в `~/.claude/plugins/.trash/` и больше их не загружает. Если ваша организация отключит Skills на claude.ai, плагины также перестанут синхронизироваться

134* **Плагин, который требует ваша организация**: плагин, который ваша организация отмечает как обязательный на claude.ai, загружается даже если вы его отключили ранее. `claude plugin disable` отказывает ему с `Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.`, и `claude plugin list` отмечает его `required by your org`141* **Плагин, который требует ваша организация**: плагин, который ваша организация отмечает как обязательный на claude.ai, загружается даже если вы его отключили ранее. `claude plugin disable` отказывает ему с `Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.`, и `claude plugin list` отмечает его `required by your org`

135 142 

136О удалении плагина на claude.ai см. [Управление установленными плагинами](/docs/ru/plugins/install#manage-installed-plugins).143О удалении плагина на claude.ai см. [Управление установленными плагинами](/docs/ru/plugins/install#manage-installed-plugins).


190| `.trash/` | Плагины, которые синхронизация claude.ai удалила, например, после того как вы отключили один на claude.ai или прекратили синхронизацию |197| `.trash/` | Плагины, которые синхронизация claude.ai удалила, например, после того как вы отключили один на claude.ai или прекратили синхронизацию |

191| `installed_plugins.json` и `known_marketplaces.json` | Записи о том, что Claude Code установил и какие маркетплейсы он загрузил, описанные в разделе [Проверьте, на каком этапе находится плагин](#check-which-stage-a-plugin-reached). [Маркетплейс, размещённый на claude.ai](/docs/ru/plugins/install#add-from-claude-ai), записывается в `known_marketplaces_claudeai.json` вместо этого |198| `installed_plugins.json` и `known_marketplaces.json` | Записи о том, что Claude Code установил и какие маркетплейсы он загрузил, описанные в разделе [Проверьте, на каком этапе находится плагин](#check-which-stage-a-plugin-reached). [Маркетплейс, размещённый на claude.ai](/docs/ru/plugins/install#add-from-claude-ai), записывается в `known_marketplaces_claudeai.json` вместо этого |

192| `flagged-plugins.json` | Плагины, которые Claude Code удалил, потому что их маркетплейс их исключил. Они появляются в разделе **Flagged** в `/plugin`; см. [Размещение маркетплейса](/docs/ru/plugins/host-marketplace) |199| `flagged-plugins.json` | Плагины, которые Claude Code удалил, потому что их маркетплейс их исключил. Они появляются в разделе **Flagged** в `/plugin`; см. [Размещение маркетплейса](/docs/ru/plugins/host-marketplace) |

200| `installed_plugins.set-aside.<date>.<hash>.json` и `installed_plugins.unreadable.<date>.<hash>.kept` | Датированные копии, которые Claude Code сохраняет перед тем, как удалить записи установки, которые ни одна версия Claude Code не может использовать, или перестроить нечитаемый `installed_plugins.json`. См. [примечания по восстановлению](/docs/ru/plugins/troubleshooting#installed-plugins-json-could-not-be-read-and-was-rebuilt). Они устаревают по расписанию [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays) |

193 201 

194Поскольку `${CLAUDE_PLUGIN_ROOT}` указывает на каталог версии, путь корня плагина изменяется с каждой версией. Сохраняйте постоянные файлы плагина в `${CLAUDE_PLUGIN_DATA}` вместо этого.202Поскольку `${CLAUDE_PLUGIN_ROOT}` указывает на каталог версии, путь корня плагина изменяется с каждой версией. Сохраняйте постоянные файлы плагина в `${CLAUDE_PLUGIN_DATA}` вместо этого.

195 203 

Details

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


63 63 

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

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

66| `name` | string | Идентификатор Marketplace. Без пробелов, управляющих символов или символов двунаправленного форматирования, без `/` или `\`, без `..` и не `.`. См. [Зарезервированные имена](#reserved-names). Пользователи вводят его после `@` при установке плагина |66| `name` | string | Идентификатор Marketplace: буквы, цифры, `.`, `_` и `-`, начинающиеся с буквы или цифры, и без `..`. Он образует часть после `@` каждого [идентификатора плагина](/docs/ru/plugins/loading#find-where-a-plugin-came-from), установленного из marketplace, поэтому `claude plugin validate` отклоняет другие имена. См. [Зарезервированные имена](#reserved-names) |

67| `owner` | object | Информация о разработчике. `name` обязателен; `email` и `url` опциональны |67| `owner` | object | Информация о разработчике. `name` обязателен; `email` и `url` опциональны |

68| `plugins` | array | [Записи плагинов](#plugin-entries). Каждая запись проверяется отдельно, поэтому одна неверная запись не приводит к отказу marketplace |68| `plugins` | array | [Записи плагинов](#plugin-entries). Каждая запись проверяется отдельно, поэтому одна неверная запись не приводит к отказу marketplace |

69| `$schema` | string | URL JSON Schema для автодополнения редактора. Игнорируется при загрузке |69| `$schema` | string | URL JSON Schema для автодополнения редактора. Игнорируется при загрузке |


87 87 

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

89| :- | :- | :- |89| :- | :- | :- |

90| `name` | string | Идентификатор плагина без пробелов, управляющих символов или символов двунаправленного форматирования. Пользователи вводят его перед `@` при установке, даже когда собственный `plugin.json` плагина устанавливает другой `name` |90| `name` | string | Идентификатор плагина: буквы, цифры, `.`, `_` и `-`, начинающиеся с буквы или цифры. `claude plugin validate` не проходит другие имена, которые Claude Code не может установить. Пользователи вводят его перед `@` при установке, даже когда собственный `plugin.json` плагина устанавливает другой `name` |

91| `source` | string or object | Откуда загружать плагин. См. [Источники плагинов](#plugin-sources) |91| `source` | string or object | Откуда загружать плагин. См. [Источники плагинов](#plugin-sources) |

92| `description` | string | Показывается в списках и деталях [`/plugin`](/docs/ru/plugins/install) |92| `description` | string | Показывается в списках и деталях [`/plugin`](/docs/ru/plugins/install) |

93| `version` | string | Строка версии для плагина. Когда `plugin.json` также устанавливает `version`, `plugin.json` имеет приоритет и `claude plugin validate` предупреждает. См. [Справочник загрузки плагинов](/docs/ru/plugins/loading) |93| `version` | string | Строка версии для плагина. Когда `plugin.json` также устанавливает `version`, `plugin.json` имеет приоритет и `claude plugin validate` предупреждает. См. [Справочник загрузки плагинов](/docs/ru/plugins/loading) |


469 469 

470Сообщение с префиксом индекса записи и `plugin.json →`, такое как `plugins[2] plugin.json →`, касается собственных файлов этого плагина. [`claude plugin validate` сообщает об ошибках](/docs/ru/plugins/troubleshooting#claude-plugin-validate-reports-errors) перечисляет эти сообщения с их исправлениями.470Сообщение с префиксом индекса записи и `plugin.json →`, такое как `plugins[2] plugin.json →`, касается собственных файлов этого плагина. [`claude plugin validate` сообщает об ошибках](/docs/ru/plugins/troubleshooting#claude-plugin-validate-reports-errors) перечисляет эти сообщения с их исправлениями.

471 471 

472Предупреждения, которые упоминают имена флагов Claude Desktop, флаги, которые Claude Code принимает, но Claude Desktop отклоняет, потому что правила имён Claude Desktop более строгие.472Предупреждения, которые упоминают имена флагов Claude Desktop, которые Claude Desktop отклоняет.

473 473 

474Таблица сопоставляет сообщения уровня marketplace с полем, которое каждое касается.474Таблица сопоставляет сообщения уровня marketplace с полем, которое каждое касается.

475 475 


484| `Author name cannot be empty` | Ошибка | `owner.name` |484| `Author name cannot be empty` | Ошибка | `owner.name` |

485| `Plugin name cannot contain spaces. Use kebab-case (e.g., "my-plugin")` | Ошибка | `plugins[i].name` |485| `Plugin name cannot contain spaces. Use kebab-case (e.g., "my-plugin")` | Ошибка | `plugins[i].name` |

486| `Plugin name cannot contain control or bidirectional-formatting characters` | Ошибка | `plugins[i].name` |486| `Plugin name cannot contain control or bidirectional-formatting characters` | Ошибка | `plugins[i].name` |

487| `Claude Code cannot install plugins from marketplace "x". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change the marketplace's "name".` | Ошибка | `name` |

488| `Claude Code cannot install plugin "x". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change this entry's "name".` | Ошибка | `plugins[i].name` |

487| `Duplicate plugin name "x" found in marketplace` | Ошибка | Две записи совместно используют `name` |489| `Duplicate plugin name "x" found in marketplace` | Ошибка | Две записи совместно используют `name` |

488| `plugins.i.source: Invalid input` | Ошибка | `source` записи не совпадает с типом. См. [Неверный ввод на источнике](#invalid-input-on-a-source) |490| `plugins.i.source: Invalid input` | Ошибка | `source` записи не совпадает с типом. См. [Неверный ввод на источнике](#invalid-input-on-a-source) |

489| `plugins[i].source: Path contains "..": <path>` | Ошибка | Относительный `source`, который выходит за пределы корня marketplace |491| `plugins[i].source: Path contains "..": <path>` | Ошибка | Относительный `source`, который выходит за пределы корня marketplace |

Details

646 646 

647Затем запустите `/reload-plugins` в вашем сеансе. Запись на вкладке **Errors** исчезает и плагин вернулся в **Installed**.647Затем запустите `/reload-plugins` в вашем сеансе. Запись на вкладке **Errors** исчезает и плагин вернулся в **Installed**.

648 648 

649<h3 id="installed-plugins-json-holds-a-record-this-version-cannot-read">

650 `installed_plugins.json holds a record under "<id>" that this version of Claude Code cannot read`

651</h3>

652 

653Сообщение появляется в этих формах:

654 

655* **`claude plugin list`**: выводит его как `Note:`

656* **`claude plugin install`, `uninstall` и `update`**: отказывают с `Plugin "<name>" was not installed:`, `Plugin "<name>" was not uninstalled:` или `Plugin "<name>" was not updated:`, за которыми следует тот же текст

657* **`--json` на любой из этих трёх команд**: строка результата содержит то же `message` и `failureCode: "install_records_unreadable"`

658* **Несколько таких записей**: сообщение читается как `holds records under`

659* **Весь файл объявляет формат, который эта версия не знает**: сообщение читается как `installed_plugins.json is in a format (version <N>) that this version of Claude Code does not know` вместо этого

660 

661Названная запись в `installed_plugins.json` является действительным JSON под действительным идентификатором плагина, но его поля не анализируются для этой версии. Скорее всего, другая версия Claude Code написала это, возможно, более новая.

662 

663Пока запись там, эта версия не переписывает файл, поэтому запись не теряется.

664 

665Возьмите варианты сообщения по порядку:

666 

6671. Обновите Claude Code с помощью `claude update`.

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

6693. Если ничего не помогает, удалите запись из `installed_plugins.json` вручную, затем перезагрузите Claude Code или запустите `/reload-plugins`.

670 

671<h3 id="installed-plugins-json-could-not-be-read-and-was-rebuilt">

672 `installed_plugins.json could not be read and was rebuilt`

673</h3>

674 

675`claude plugin list` выводит эту заметку с путём сохранённого файла с именем `installed_plugins.unreadable.<date>.<hash>.kept`, пока этот файл находится рядом с `installed_plugins.json`.

676 

677`installed_plugins.json`, который не является действительным JSON или не является списком плагинов, не может сказать, что вы установили.

678 

679Откройте файл `.kept`, чтобы увидеть, что записал старый файл, и переустановите плагины, которые вам не хватает. Claude Code никогда не читает файл обратно, и файл стареет по расписанию [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays).

680 

681<h3 id="install-records-under-names-that-no-version-can-use">

682 `install records under names that no version of Claude Code can use were removed from installed_plugins.json`

683</h3>

684 

685`claude plugin list` выводит эту заметку с путём копии с именем `installed_plugins.set-aside.<date>.<hash>.json`, пока эта копия находится рядом с `installed_plugins.json`. Заметка заканчивается `Nothing needs doing about these copies.`

686 

687Запись в `installed_plugins.json` находилась под ключом, который не является действительным идентификатором плагина, поэтому ни одна версия Claude Code не может его использовать. Остальная часть файла загружается нормально.

688 

689Claude Code копирует непригодные записи в файл `.set-aside` и удаляет их из списка. Claude Code никогда не читает копии обратно, и копии стареют по расписанию [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays).

690 

649<h3 id="a-plugin-you-disabled-still-loads">691<h3 id="a-plugin-you-disabled-still-loads">

650 `Disabled in ~/.claude/settings.json but still loads`692 `Disabled in ~/.claude/settings.json but still loads`

651</h3>693</h3>


981| `Path contains "..": <path>` в `plugins[N].source` | Ошибка | Используйте пути относительно корня маркетплейса без сегментов `..`. |1023| `Path contains "..": <path>` в `plugins[N].source` | Ошибка | Используйте пути относительно корня маркетплейса без сегментов `..`. |

982| `Marketplace name cannot contain control or bidirectional-formatting characters` | Ошибка | Удалите символ из имени, такой как escape или новая строка. |1024| `Marketplace name cannot contain control or bidirectional-formatting characters` | Ошибка | Удалите символ из имени, такой как escape или новая строка. |

983| `Plugin name cannot contain control or bidirectional-formatting characters` | Ошибка | Удалите символ из имени плагина `name`. |1025| `Plugin name cannot contain control or bidirectional-formatting characters` | Ошибка | Удалите символ из имени плагина `name`. |

1026| `Claude Code cannot install plugins from marketplace "<name>". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change the marketplace's "name".` | Ошибка | Переименуйте маркетплейс в соответствии с правилом, указанным в сообщении. |

1027| `Claude Code cannot install plugin "<name>". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change this entry's "name".` | Ошибка | Переименуйте запись в соответствии с правилом, указанным в сообщении. |

984| `Marketplace has no plugins defined` | Предупреждение | Добавьте по крайней мере одну запись в `plugins`. |1028| `Marketplace has no plugins defined` | Предупреждение | Добавьте по крайней мере одну запись в `plugins`. |

985| `No marketplace description provided` | Предупреждение | Добавьте описание на уровне верхнего уровня `description`. |1029| `No marketplace description provided` | Предупреждение | Добавьте описание на уровне верхнего уровня `description`. |

986| `Plugin name "<name>" is not kebab-case` в `plugins[N] plugin.json → name` | Предупреждение | Переименуйте в строчные буквы, цифры и дефисы. Claude Code принимает другие формы, но синхронизация маркетплейса claude.ai их отклоняет. |1030| `Plugin name "<name>" is not kebab-case` в `plugins[N] plugin.json → name` | Предупреждение | Переименуйте в строчные буквы, цифры и дефисы; синхронизация маркетплейса claude.ai требует эту форму. |

987| `Entry declares version "<a>" but <path>/plugin.json says "<b>"` | Предупреждение | Обновите запись, чтобы совпадать с `plugin.json`, который является авторитетным во время установки. |1031| `Entry declares version "<a>" but <path>/plugin.json says "<b>"` | Предупреждение | Обновите запись, чтобы совпадать с `plugin.json`, который является авторитетным во время установки. |

988| `Marketplace name "<name>" is reserved in Claude Desktop` | Предупреждение | Переименуйте маркетплейс. Синхронизация управляемого маркетплейса Claude Desktop отклоняет `org`, `org-provisioned` и `unknown` в любом регистре. |1032| `Marketplace name "<name>" is reserved in Claude Desktop` | Предупреждение | Переименуйте маркетплейс. Синхронизация управляемого маркетплейса Claude Desktop отклоняет `org`, `org-provisioned` и `unknown` в любом регистре. |

989| `Marketplace name "<name>" is not accepted by Claude Desktop` или `Plugin name "<name>" is not accepted by Claude Desktop` | Предупреждение | Переименуйте максимум на 128 символов букв, цифр, `.`, `_` и `-`, начиная с буквы или цифры. |1033| `Marketplace name "<name>" is not accepted by Claude Desktop` или `Plugin name "<name>" is not accepted by Claude Desktop` | Предупреждение | Переименуйте максимум на 128 символов букв, цифр, `.`, `_` и `-`, начиная с буквы или цифры. |

Details

200 200 

201Тот же переключатель появляется вне CLI:201Тот же переключатель появляется вне CLI:

202 202 

203* **Приложение Desktop**: **Settings > Claude Code > Enable remote control by default**.203* **Приложение Desktop**: **Settings > Claude Code > Connect new sessions to Remote Control**.

204* **Расширение VS Code**: **Enable Remote Control for all sessions** в разделе Settings [меню команд](/docs/ru/vs-code#use-the-prompt-box).204* **Расширение VS Code**: **Enable Remote Control for all sessions** в разделе Settings [меню команд](/docs/ru/vs-code#use-the-prompt-box).

205 205 

206Чтобы вместо этого включить автоподключение из файла параметров, установите [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup) на `true` в ваш пользовательский файл `~/.claude/settings.json` или в [управляемые параметры](/docs/ru/managed-settings). В параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), Claude Code соблюдает `false` и отключает автоподключение для этого репозитория, но игнорирует `true`, поэтому проверенный файл не может включить Remote Control для всех, кто открывает репозиторий.206Чтобы вместо этого включить автоподключение из файла параметров, установите [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup) на `true` в ваш пользовательский файл `~/.claude/settings.json` или в [управляемые параметры](/docs/ru/managed-settings). В параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), Claude Code соблюдает `false` и отключает автоподключение для этого репозитория, но игнорирует `true`, поэтому проверенный файл не может включить Remote Control для всех, кто открывает репозиторий.

routines.md +69 −59

Details

66 66 

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

68 68 

69Рутины принадлежат вашему индивидуальному аккаунту claude.ai. Они не совместно используются с товарищами по команде и учитываются в дневном лимите запусков вашего аккаунта. Все, что рутина делает через вашу подключенную идентификацию GitHub или коннекторы, отображается как вы: коммиты и pull request несут вашего пользователя GitHub, а сообщения Slack, задачи Linear или другие действия коннектора используют ваши связанные аккаунты для этих сервисов.69Рутины принадлежат вашему индивидуальному аккаунту claude.ai. Они не совместно используются с товарищами по команде и их запуски учитываются в [использовании и лимитах](#usage-and-limits) вашего аккаунта. Все, что рутина делает через вашу подключенную идентификацию GitHub или коннекторы, отображается как вы: коммиты и pull request несут вашего пользователя GitHub, а сообщения Slack, задачи Linear или другие действия коннектора используют ваши связанные аккаунты для этих сервисов.

70 70 

71<h3 id="create-from-the-web">71<h3 id="create-from-the-web">

72 Создание из веб-версии72 Создание из веб-версии


144 Настройка триггеров144 Настройка триггеров

145</h2>145</h2>

146 146 

147Рутина запускается, когда один из ее триггеров совпадает. Вы можете присоединить любую комбинацию триггеров расписания, API и GitHub к одной рутине и добавлять или удалять их в любое время из раздела **Select a trigger** формы редактирования рутины.147Рутина запускается, когда срабатывает один из её триггеров. Вы можете прикрепить любую комбинацию триггеров расписания, API и GitHub к одной и той же рутине и добавлять или удалять их в любое время из раздела **Select a trigger** формы редактирования рутины.

148 148 

149<h3 id="add-a-schedule-trigger">149<h3 id="add-a-schedule-trigger">

150 Добавление триггера расписания150 Добавить триггер расписания

151</h3>151</h3>

152 152 

153Триггер расписания запускает рутину по повторяющемуся расписанию или один раз в определенное будущее время. Выберите предустановленную частоту в разделе **Select a trigger**: ежечасно, ежедневно, по рабочим дням или еженедельно. Времена вводятся в вашем локальном часовом поясе и преобразуются автоматически, поэтому рутина запускается в это время независимо от того, где находится облачная инфраструктура.153Триггер расписания запускает рутину по повторяющемуся графику или один раз в определённое будущее время. Выберите предустановленную частоту в разделе **Select a trigger**: ежечасно, ежедневно, по будням или еженедельно. Время вводится в вашем локальном часовом поясе и автоматически преобразуется, поэтому рутина запускается в это время независимо от того, где находится облачная инфраструктура.

154 154 

155Если вы запланируете запуск ровно в час, например в 9:00, он может начаться на несколько минут позже. Чтобы начать близко к запланированному времени, выберите несколько минут после часа, например 9:07.155Если вы запланируете запуск ровно в час, например в 9:00, он может начаться с опозданием на несколько минут. Чтобы начать близко к запланированному времени, выберите несколько минут после часа, например 9:07.

156 156 

157Для пользовательского интервала, такого как каждые два часа или первое число каждого месяца, выберите ближайшую предустановку в форме, затем запустите `/schedule update` в CLI, чтобы установить конкретное выражение cron. Минимальный интервал — один час; выражения, которые запускаются чаще, отклоняются.157Для пользовательского интервала, такого как каждые два часа или первое число каждого месяца, выберите ближайший предустановленный вариант в форме, затем запустите `/schedule update` в CLI, чтобы установить конкретное выражение cron. Минимальный интервал — один час; выражения, которые выполняются чаще, отклоняются.

158 158 

159<h4 id="schedule-a-one-off-run">159<h4 id="schedule-a-one-off-run">

160 Планирование одноразового запуска160 Запланировать одноразовый запуск

161</h4>161</h4>

162 162 

163Одноразовое расписание запускает рутину один раз в определенный момент времени. Используйте его, чтобы напомнить себе позже на неделе, открыть PR очистки после завершения развертывания или запустить последующую задачу, когда приходит изменение вышестоящего уровня. После запуска рутины она автоматически отключается, и веб-интерфейс отмечает ее как **Ran**. Чтобы запустить ее снова, отредактируйте рутину и установите новое одноразовое время.163Одноразовое расписание запускает рутину один раз в определённый момент времени. Используйте его, чтобы напомнить себе позже на неделе, открыть PR очистки после завершения развёртывания или запустить последующую задачу после поступления изменения из вышестоящего источника. После запуска рутины она автоматически отключается, а веб-интерфейс отмечает её как **Ran**. Чтобы запустить её снова, отредактируйте рутину и установите новое одноразовое время.

164 164 

165Создайте одноразовый запуск из CLI, описав время на естественном языке. Claude разрешает фразу относительно текущего времени и подтверждает абсолютный момент времени перед сохранением.165Создайте одноразовый запуск из CLI, описав время на естественном языке. Claude разрешает фразу относительно текущего времени и подтверждает абсолютную временную метку перед сохранением.

166 166 

167```text theme={null}167```text theme={null}

168/schedule tomorrow at 9am, summarize yesterday's merged PRs168/schedule tomorrow at 9am, summarize yesterday's merged PRs


172/schedule in 2 weeks, open a cleanup PR that removes the feature flag172/schedule in 2 weeks, open a cleanup PR that removes the feature flag

173```173```

174 174 

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

176 176 

177Одноразовые запуски не учитываются в дневном лимите запусков рутины. Смотрите [Usage and limits](#usage-and-limits) для подробностей.177Одноразовые запуски учитываются в том же почасовом лимите, что и другие запланированные запуски. Подробности см. в разделе [Usage and limits](#usage-and-limits).

178 178 

179<h3 id="add-an-api-trigger">179<h3 id="add-an-api-trigger">

180 Добавление триггера API180 Добавить триггер API

181</h3>181</h3>

182 182 

183Триггер API дает рутине выделенную конечную точку HTTP. POST на конечную точку с токеном-носителем рутины запускает новый сеанс и возвращает URL сеанса. Используйте это для подключения Claude Code к системам оповещений, конвейерам развертывания, внутренним инструментам или везде, где вы можете сделать аутентифицированный HTTP запрос.183Триггер API предоставляет рутине выделенную конечную точку HTTP. Отправка POST-запроса на конечную точку с токеном-носителем рутины запускает новый сеанс и возвращает URL сеанса. Используйте это для интеграции Claude Code в системы оповещений, конвейеры развёртывания, внутренние инструменты или в любое место, где вы можете сделать аутентифицированный HTTP-запрос.

184 184 

185Триггеры API добавляются к существующей рутине из веб-версии. CLI в настоящее время не может создавать или отзывать токены.185Триггеры API добавляются к существующей рутине из веб-интерфейса. CLI в настоящее время не может создавать или отзывать токены.

186 186 

187<Steps>187<Steps>

188 <Step title="Откройте рутину для редактирования">188 <Step title="Open the routine for editing">

189 Перейдите на [claude.ai/code/routines](https://claude.ai/code/routines), нажмите рутину, которую вы хотите запустить через API, затем откройте меню рядом с названием рутины и выберите **Edit**.189 Перейдите на [claude.ai/code/routines](https://claude.ai/code/routines), нажмите на рутину, которую вы хотите запустить через API, затем откройте меню рядом с названием рутины и выберите **Edit**.

190 </Step>190 </Step>

191 191 

192 <Step title="Добавьте триггер API">192 <Step title="Add an API trigger">

193 Прокрутите до раздела **Select a trigger** ниже подсказки, нажмите **Add another trigger** и выберите **API**.193 Прокрутите до раздела **Select a trigger** ниже поля **Instructions**, нажмите **Add another trigger** и выберите **API**.

194 </Step>194 </Step>

195 195 

196 <Step title="Скопируйте URL и сгенерируйте токен">196 <Step title="Copy the URL and generate a token">

197 Модальное окно показывает URL для этой рутины вместе с примером команды curl. Скопируйте URL, затем нажмите **Generate token** и сразу же скопируйте токен. Токен показывается один раз и не может быть получен позже, поэтому сохраните его в безопасном месте, таком как хранилище секретов вашего инструмента оповещений.197 Модальное окно показывает URL для этой рутины вместе с примером команды curl. Скопируйте URL, затем нажмите **Generate token** и сразу же скопируйте токен. Токен показывается один раз и не может быть получен позже, поэтому сохраните его в безопасном месте, например в хранилище секретов вашего инструмента оповещений.

198 </Step>198 </Step>

199 199 

200 <Step title="Вызовите конечную точку">200 <Step title="Call the endpoint">

201 Отправьте токен в заголовке `Authorization: Bearer` при POST на URL. Раздел [Trigger a routine](#trigger-a-routine) ниже показывает полный пример.201 Отправьте токен в заголовке `Authorization: Bearer` при отправке POST-запроса на URL. Раздел [Trigger a routine](#trigger-a-routine) ниже показывает полный пример.

202 </Step>202 </Step>

203</Steps>203</Steps>

204 204 

205Каждая рутина имеет свой токен, ограниченный только запуском этой рутины. Чтобы повернуть или отозвать его, вернитесь в то же модальное окно и нажмите **Regenerate** или **Revoke**.205Каждая рутина имеет свой токен, ограниченный только запуском этой рутины. Чтобы ротировать или отозвать его, вернитесь в то же модальное окно и нажмите **Regenerate** или **Revoke**.

206 206 

207<h4 id="trigger-a-routine">207<h4 id="trigger-a-routine">

208 Запуск рутины208 Запустить рутину

209</h4>209</h4>

210 210 

211Отправьте POST запрос на конечную точку `/fire` с токеном-носителем в заголовке `Authorization`. Тело запроса принимает дополнительное поле `text` для контекста, специфичного для запуска, такого как тело оповещения или неудачный журнал, переданное рутине вместе с ее сохраненной подсказкой. Значение — это свободный текст и не анализируется: если вы отправляете JSON или другую структурированную полезную нагрузку, рутина получает ее как буквальную строку.211Отправьте POST-запрос на конечную точку `/fire` с токеном-носителем в заголовке `Authorization`. Тело запроса принимает необязательное поле `text` для контекста, специфичного для запуска, такого как тело оповещения или неудачный журнал, передаваемое рутине вместе с её сохранённым приглашением. Значение — это свободный текст и не анализируется: если вы отправите JSON или другую структурированную полезную нагрузку, рутина получит её как буквальную строку.

212 212 

213Значение `text` не достигает рутину как простое сообщение. Оно приходит завернутым в блок `<routine-fire-payload>`, который помечает его как ненадежные данные и говорит Claude не следовать инструкциям внутри него, если только собственная подсказка рутины не говорит об этом. То же самое обертывание применяется к тексту, предоставленному с помощью **Run now** в веб-интерфейсе.213Значение `text` не достигает рутину как простое сообщение. Оно приходит завёрнутым в блок `<routine-fire-payload>`, который помечает его как недоверенные данные и говорит Claude не следовать инструкциям внутри него, если собственное приглашение рутины не говорит об этом. То же самое завёртывание применяется к тексту, предоставленному с помощью **Run now** в веб-интерфейсе.

214 214 

215Это означает, что сохраненная подсказка рутины должна явно согласиться действовать на текст fire: напишите подсказку, чтобы явно ссылаться на полезную нагрузку, например "Investigate the alert described in the routine-fire-payload block", или рутина будет рассматривать текст как инертный контекст. Любой, кто держит токен-носитель, может отправить `text`, поэтому обертка делает текст fire из утекшего токена помеченным как ненадежные данные, а не как прямые инструкции вашей рутине.215Это означает, что сохранённое приглашение рутины должно явно согласиться на действие с текстом fire: напишите приглашение для ссылки на полезную нагрузку явно, например «Investigate the alert described in the routine-fire-payload block», или рутина будет рассматривать текст как инертный контекст. Любой, кто держит токен-носитель, может отправить `text`, поэтому обёртка делает текст fire из утёкшего токена помеченным как недоверенные данные, а не как прямые инструкции для вашей рутины.

216 216 

217Пример ниже запускает рутину из shell. ID рутины и токен, показанные здесь, являются заполнителями: замените их на URL и токен, которые вы скопировали при [добавлении триггера API](#add-an-api-trigger), или запрос завершится с ошибкой аутентификации `401`:217Пример ниже запускает рутину из оболочки. ID рутины и показанный токен — это заполнители: замените их на URL и токен, которые вы скопировали при [добавлении триггера API](#add-an-api-trigger), или запрос завершится с ошибкой аутентификации `401`:

218 218 

219```bash theme={null}219```bash theme={null}

220curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \220curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \


235}235}

236```236```

237 237 

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

239 239 

240<Warning>240<Warning>

241 Конечная точка `/fire` поставляется под заголовком бета-версии `experimental-cc-routine-2026-04-01`. Формы запроса и ответа, ограничения скорости и семантика токенов могут измениться, пока функция находится в исследовательском предпросмотре. Критические изменения поставляются за новыми версиями заголовка бета-версии с датой, и две самые последние предыдущие версии заголовка продолжают работать, чтобы у вызывающих было время для миграции.241 Конечная точка `/fire` поставляется под заголовком бета-версии `experimental-cc-routine-2026-04-01`. Формы запроса и ответа, ограничения скорости и семантика токенов могут измениться, пока функция находится в исследовательском предпросмотре. Критические изменения поставляются за новыми версиями заголовка бета-версии с датой, и две самые последние предыдущие версии заголовка продолжают работать, чтобы у вызывающих было время для миграции.


245 Справочник API245 Справочник API

246</h4>246</h4>

247 247 

248Для полного справочника API, включая все ответы об ошибках, правила валидации и ограничения полей, смотрите [Trigger a routine via API](https://platform.claude.com/docs/en/api/claude-code/routines-fire) в документации Claude Platform.248Для полного справочника API, включая все ответы об ошибках, правила валидации и ограничения полей, см. [Trigger a routine via API](https://platform.claude.com/docs/en/api/claude-code/routines-fire) в документации Claude Platform.

249 249 

250Конечная точка `/fire` доступна только пользователям claude.ai и не является частью поверхности Claude Platform API.250Конечная точка `/fire` доступна только пользователям claude.ai и не является частью поверхности Claude Platform API.

251 251 

252<h3 id="add-a-github-trigger">252<h3 id="add-a-github-trigger">

253 Добавление триггера GitHub253 Добавить триггер GitHub

254</h3>254</h3>

255 255 

256Триггер GitHub запускает новый сеанс автоматически, когда совпадающее событие происходит в подключенном репозитории. Claude Code не переиспользует сеансы между событиями, поэтому два обновления PR создают два независимых сеанса.256Триггер GitHub запускает новый сеанс автоматически, когда на подключённом репозитории происходит соответствующее событие. Claude Code не переиспользует сеансы между событиями, поэтому два обновления PR создают два независимых сеанса.

257 257 

258<Note>258<Note>

259 Во время исследовательского предпросмотра события вебхука GitHub подлежат ограничениям в час для каждой рутины и для каждого аккаунта. События сверх лимита отбрасываются до сброса окна. Смотрите ваши текущие ограничения на [claude.ai/code/routines](https://claude.ai/code/routines).259 События вебхука GitHub подлежат почасовым ограничениям для каждой рутины и для каждого аккаунта. События сверх лимита отбрасываются до сброса окна.

260</Note>260</Note>

261 261 

262Приложение Claude GitHub должно быть установлено в репозитории, на который вы хотите подписаться, независимо от того, какую поверхность вы используете для настройки триггера.262Приложение Claude GitHub должно быть установлено на репозитории, на который вы хотите подписаться, независимо от того, с какой поверхности вы настраиваете триггер.

263 263 

264* Настраивайте триггеры GitHub из веб-интерфейса, который предложит вам установить приложение, если оно отсутствует. Следуйте шагам ниже, чтобы настроить его из веб-версии.264* Настраивайте триггеры GitHub из веб-интерфейса, который предложит вам установить приложение, если оно отсутствует. Следуйте приведённым ниже шагам для настройки одного из веб-интерфейса.

265* Из CLI сначала установите приложение со [страницы GitHub App](https://github.com/apps/claude), затем попросите Claude присоединить триггер GitHub к существующей рутине, например `/schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp`. Путь CLI требует Claude Code v2.1.225 или позже. Когда Claude добавляет триггер, он отвечает ссылкой на рутину, которую запускает триггер.265* Из CLI установите приложение со [страницы GitHub App](https://github.com/apps/claude) сначала, затем попросите Claude прикрепить триггер GitHub к существующей рутине, например `/schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp`. Путь CLI требует Claude Code v2.1.225 или позже. Когда Claude добавляет триггер, он отвечает ссылкой на рутину, которую запускает триггер.

266 266 

267<Steps>267<Steps>

268 <Step title="Откройте рутину для редактирования">268 <Step title="Open the routine for editing">

269 Перейдите на [claude.ai/code/routines](https://claude.ai/code/routines), нажмите рутину, затем откройте меню рядом с названием рутины и выберите **Edit**.269 Перейдите на [claude.ai/code/routines](https://claude.ai/code/routines), нажмите на рутину, затем откройте меню рядом с названием рутины и выберите **Edit**.

270 </Step>270 </Step>

271 271 

272 <Step title="Добавьте триггер события GitHub">272 <Step title="Add a GitHub event trigger">

273 Прокрутите до раздела **Select a trigger**, нажмите **Add another trigger** и выберите **GitHub event**.273 Прокрутите до раздела **Select a trigger**, нажмите **Add another trigger** и выберите **GitHub event**.

274 274 

275 <Note>275 <Note>


277 </Note>277 </Note>

278 </Step>278 </Step>

279 279 

280 <Step title="Настройте триггер">280 <Step title="Configure the trigger">

281 Выберите репозиторий, выберите событие из списка [supported events](#supported-events) и дополнительно добавьте фильтры. Сохраните триггер.281 Выберите репозиторий, выберите событие из списка [supported events](#supported-events) и при необходимости добавьте фильтры. Сохраните триггер.

282 </Step>282 </Step>

283</Steps>283</Steps>

284 284 


288 288 

289Триггеры GitHub могут подписаться на одну из следующих категорий событий. В каждой категории вы можете выбрать конкретное действие, такое как `pull_request.opened`, или реагировать на все действия в категории.289Триггеры GitHub могут подписаться на одну из следующих категорий событий. В каждой категории вы можете выбрать конкретное действие, такое как `pull_request.opened`, или реагировать на все действия в категории.

290 290 

291| Событие | Срабатывает когда |291| Event | Triggers when |

292| :- | :- |292| :- | :- |

293| Pull request | PR открыт, закрыт, назначен, помечен, синхронизирован или иным образом обновлен |293| Pull request | PR открывается, закрывается, назначается, помечается меткой, синхронизируется или иным образом обновляется |

294| Release | Релиз создан, опубликован, отредактирован или удален |294| Release | Выпуск создаётся, публикуется, редактируется или удаляется |

295 295 

296<h4 id="filter-pull-requests">296<h4 id="filter-pull-requests">

297 Фильтрация pull request297 Фильтровать pull requests

298</h4>298</h4>

299 299 

300Используйте фильтры, чтобы сузить, какие pull request запускают новый сеанс. Все условия фильтра должны совпадать, чтобы рутина сработала. Доступные поля фильтра:300Используйте фильтры, чтобы сузить, какие pull requests запускают новый сеанс. Все условия фильтра должны совпадать, чтобы рутина сработала. Доступные поля фильтра:

301 301 

302| Фильтр | Совпадает |302| Filter | Matches |

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

304| Author | Имя пользователя GitHub автора PR |304| Author | Имя пользователя GitHub автора PR |

305| Title | Текст заголовка PR |305| Title | Текст заголовка PR |

306| Body | Текст описания PR |306| Body | Текст описания PR |

307| Base branch | Ветвь, на которую нацелен PR |307| Base branch | Ветка, на которую нацелен PR |

308| Head branch | Ветвь, из которой исходит PR |308| Head branch | Ветка, из которой поступает PR |

309| Labels | Метки, применяемые к PR |309| Labels | Метки, применённые к PR |

310| Is draft | Находится ли PR в черновом состоянии |310| Is draft | Находится ли PR в состоянии черновика |

311| Is merged | Был ли PR объединен |311| Is merged | Был ли PR объединён |

312 312 

313Каждый фильтр сочетает поле с оператором: equals, contains, starts with, is one of, is not one of или matches regex.313Каждый фильтр связывает поле с оператором: equals, contains, starts with, is one of, is not one of или matches regex.

314 314 

315Оператор `matches regex` проверяет все значение поля, а не подстроку в нем. Чтобы совпадать с любым заголовком, содержащим `hotfix`, напишите `.*hotfix.*`. Без окружающих `.*`, фильтр совпадает только с заголовком, который точно `hotfix` без ничего до или после. Для буквального совпадения подстроки без синтаксиса regex используйте оператор `contains` вместо этого.315Оператор `matches regex` проверяет всё значение поля, а не подстроку внутри него. Чтобы совпадать с любым заголовком, содержащим `hotfix`, напишите `.*hotfix.*`. Без окружающего `.*` фильтр совпадает только с заголовком, который точно `hotfix` без чего-либо до или после. Для буквального совпадения подстроки без синтаксиса regex используйте оператор `contains`.

316 316 

317Несколько примеров комбинаций фильтров:317Несколько примеров комбинаций фильтров:

318 318 

319* **Auth module review**: base branch `main`, head branch contains `auth-provider`. Отправляет любой PR, который касается аутентификации, сосредоточенному рецензенту.319* **Auth module review**: base branch `main`, head branch contains `auth-provider`. Отправляет любой PR, который касается аутентификации, сосредоточенному рецензенту.

320* **Ready-for-review only**: is draft is `false`. Пропускает черновики, поэтому рутина запускается только, когда PR готов к проверке.320* **Ready-for-review only**: is draft is `false`. Пропускает черновики, поэтому рутина запускается только, когда PR готов к рецензированию.

321* **Label-gated backport**: labels include `needs-backport`. Запускает рутину портирования в другую ветвь только, когда мейнтейнер помечает PR.321* **Label-gated backport**: labels include `needs-backport`. Запускает рутину port-to-another-branch только, когда мейнтейнер помечает PR.

322 322 

323<h2 id="manage-routines">323<h2 id="manage-routines">

324 Управление рутинами324 Управление рутинами


421 Использование и ограничения421 Использование и ограничения

422</h2>422</h2>

423 423 

424Рутины снижают использование подписки так же, как интерактивные сеансы. В дополнение к стандартным ограничениям подписки, рутины имеют дневной лимит на количество запусков, которые могут начаться на аккаунт. Смотрите ваше текущее потребление и оставшиеся дневные запуски рутин на [claude.ai/code/routines](https://claude.ai/code/routines) или [claude.ai/settings/usage](https://claude.ai/settings/usage).424Рутины снижают использование подписки так же, как интерактивные сеансы. Смотрите ваше текущее потребление на [claude.ai/settings/usage](https://claude.ai/settings/usage).

425 

426Отдельно от использования подписки, каждый способ запуска имеет почасовой лимит:

427 

428| Действие | Лимит | Учитывается для | Превышение лимита |

429| :- | :- | :- | :- |

430| Запланированные запуски, включая одноразовые запуски | 100 в час | Ваш аккаунт | Запуск ждет до сброса лимита |

431| **Run now**, срабатывания API и установка одноразовой рутины на повторный запуск | 30 в час | Каждая рутина, один счетчик, общий для всех трех | Действие не выполняется до сброса лимита |

432| **Run now** и установка одноразовой рутины на повторный запуск | 100 в час | Ваш аккаунт | То же самое |

433| Срабатывания API | 100 в час | Ваш аккаунт, учитывается отдельно от **Run now** | То же самое |

434| События GitHub | Смотрите [Add a GitHub trigger](#add-a-github-trigger) | | |

425 435 

426Когда рутина достигает дневного лимита или лимита использования вашей подписки, организации с включенными кредитами использования могут продолжать запускать рутины на измеренный перерасход. Без кредитов использования дополнительные запуски отклоняются до сброса окна. Включите кредиты использования на [claude.ai/settings/usage](https://claude.ai/settings/usage). На планах Team и Enterprise администратор включает их для организации на [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage).436Ни один из этих почасовых лимитов не имеет перерасхода.

427 437 

428Разовые запуски не учитываются в дневном лимите рутин. Они снижают ваше обычное использование подписки как любой другой сеанс.438Когда рутина достигает лимита использования вашей подписки, организации с включенными кредитами использования могут продолжать запускать рутины на измеренный перерасход. Без кредитов использования дополнительные запуски отклоняются до сброса окна использования. Включите кредиты использования на [claude.ai/settings/usage](https://claude.ai/settings/usage). На планах Team и Enterprise администратор включает их для организации на [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage).

429 439 

430Пока ваша подписка приостановлена, ваши рутины ставятся на паузу и не запускаются. Как только ваша подписка снова активна, включите их обратно.440Пока ваша подписка приостановлена, ваши рутины ставятся на паузу и не запускаются. Как только ваша подписка снова активна, включите их обратно.

431 441 

Details

48* **Zero Data Retention**: недоступно для организаций с включенным [Zero Data Retention](/docs/ru/zero-data-retention).48* **Zero Data Retention**: недоступно для организаций с включенным [Zero Data Retention](/docs/ru/zero-data-retention).

49* **Model inference**: сеансы используют Anthropic API, и вывод не может быть маршрутизирован через [Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry](/docs/ru/third-party-integrations) или [LLM gateway](/docs/ru/llm-gateway).49* **Model inference**: сеансы используют Anthropic API, и вывод не может быть маршрутизирован через [Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry](/docs/ru/third-party-integrations) или [LLM gateway](/docs/ru/llm-gateway).

50* **Surfaces**: сеансы, запущенные из [claude.ai/code](https://claude.ai/code), мобильных и настольных приложений, [запланированных процедур](/docs/ru/routines) и терминала с [`claude --cloud`](/docs/ru/claude-code-on-the-web#from-terminal-to-cloud) или [`--environment` dispatch](/docs/ru/self-hosted-environments-testing#run-the-test-loop), могут работать в самостоятельно размещаемых окружениях. Сеансы [Claude Tag](https://claude.com/docs/claude-tag/overview) могут работать в них тоже, но Claude не может использовать [Access bundles](https://claude.com/docs/claude-tag/concepts/glossary#access-bundle) в этих сеансах еще. Сеансы [Claude Security](/docs/ru/claude-security) и [Code Review](/docs/ru/code-review) еще не маршрутизируются на них. Поддержка этих двух поверхностей следует отдельно.50* **Surfaces**: сеансы, запущенные из [claude.ai/code](https://claude.ai/code), мобильных и настольных приложений, [запланированных процедур](/docs/ru/routines) и терминала с [`claude --cloud`](/docs/ru/claude-code-on-the-web#from-terminal-to-cloud) или [`--environment` dispatch](/docs/ru/self-hosted-environments-testing#run-the-test-loop), могут работать в самостоятельно размещаемых окружениях. Сеансы [Claude Tag](https://claude.com/docs/claude-tag/overview) могут работать в них тоже, но Claude не может использовать [Access bundles](https://claude.com/docs/claude-tag/concepts/glossary#access-bundle) в этих сеансах еще. Сеансы [Claude Security](/docs/ru/claude-security) и [Code Review](/docs/ru/code-review) еще не маршрутизируются на них. Поддержка этих двух поверхностей следует отдельно.

51* **Repositories**: сеансы проверяют репозитории из GitHub; смотрите [Варианты аутентификации GitHub](/docs/ru/claude-code-on-the-web#github-authentication-options).51* **Repositories**: сеансы проверяют репозитории из GitHub; смотрите [Варианты аутентификации GitHub](/docs/ru/claude-code-on-the-web#github-authentication-options). Для хоста GitHub Enterprise Server смотрите его [требования к сети](/docs/ru/github-enterprise-server#network-requirements).

52* **Billing**: сеансы в самостоятельно размещаемом окружении потребляют использование Claude Code вашей организации так же, как сеансы в окружениях, размещаемых Anthropic.52* **Billing**: сеансы в самостоятельно размещаемом окружении потребляют использование Claude Code вашей организации так же, как сеансы в окружениях, размещаемых Anthropic.

53 53 

54<h2 id="why-self-host">54<h2 id="why-self-host">

Details

170 170 

171Если ваш git-хост отклоняет учетные данные или вы не конфигурировали их, runner повторяет попытку несколько раз, а затем не подготавливает репозиторий, когда репозиторий является тем, в который сеанс отправляет результаты. Для репозитория, из которого сеанс только читает, [Troubleshooting](#troubleshooting) охватывает, когда runner пропускает его вместо этого. Runner не передает эти параметры в окружение сеанса.171Если ваш git-хост отклоняет учетные данные или вы не конфигурировали их, runner повторяет попытку несколько раз, а затем не подготавливает репозиторий, когда репозиторий является тем, в который сеанс отправляет результаты. Для репозитория, из которого сеанс только читает, [Troubleshooting](#troubleshooting) охватывает, когда runner пропускает его вместо этого. Runner не передает эти параметры в окружение сеанса.

172 172 

173Держите любую программу, которую вы называете в `GIT_SSH_COMMAND` или `GIT_ASKPASS`, там, где сеансы не могут писать в нее, так, как [контрольный список усиления безопасности](#harden-your-deployment) просит для каталога hooks и скрипта-обертки. То же самое относится к любому ключу или файлу в командной строке этой программы. Собственный git runner запускает эту программу, когда он клонирует или получает.

174 

173Если каталоги checkout принадлежат другому uid, чем процесс runner, git отказывается работать с ними; добавьте `safe.directory`:175Если каталоги checkout принадлежат другому uid, чем процесс runner, git отказывается работать с ними; добавьте `safe.directory`:

174 176 

175```dockerfile theme={null}177```dockerfile theme={null}


184 186 

185Прокси требует `--capacity 1`, потому что URL прокси зависит от сеанса, и git 2.32 или новее, потому что более старый git игнорирует механизм конфигурации, который прокси использует для изоляции сеансов друг от друга. Runner отказывается запускаться, если какое-либо требование не выполнено. Поскольку прокси получает со стороны Anthropic, ваш git-хост должен быть доступен из инфраструктуры Anthropic, то же требование, что и для сеансов, размещаемых Anthropic; для git-хоста, который маршрутизируется только внутри вашей сети, используйте вместо этого [`checkout` lifecycle hook](/docs/ru/self-hosted-environments-configuration#checkout). Каждый процесс runner обрабатывает один сеанс за раз, поэтому запускайте больше реплик для параллелизма. Когда прокси включен, `--git-host-rewrite` и `--git-ssh-rewrite` не имеют эффекта: URL прокси указывает на `api.anthropic.com`, а не на ваш git-хост.187Прокси требует `--capacity 1`, потому что URL прокси зависит от сеанса, и git 2.32 или новее, потому что более старый git игнорирует механизм конфигурации, который прокси использует для изоляции сеансов друг от друга. Runner отказывается запускаться, если какое-либо требование не выполнено. Поскольку прокси получает со стороны Anthropic, ваш git-хост должен быть доступен из инфраструктуры Anthropic, то же требование, что и для сеансов, размещаемых Anthropic; для git-хоста, который маршрутизируется только внутри вашей сети, используйте вместо этого [`checkout` lifecycle hook](/docs/ru/self-hosted-environments-configuration#checkout). Каждый процесс runner обрабатывает один сеанс за раз, поэтому запускайте больше реплик для параллелизма. Когда прокси включен, `--git-host-rewrite` и `--git-ssh-rewrite` не имеют эффекта: URL прокси указывает на `api.anthropic.com`, а не на ваш git-хост.

186 188 

189<Warning>

190 Рецепты [Kubernetes](#kubernetes) и [Docker Compose](#docker-compose) на этой странице используют `--capacity 4`. Если вы добавите `--use-anthropic-git-proxy` или `CLAUDE_RUNNER_USE_GIT_PROXY=1` к одному из них без изменения capacity на `1`, runner выходит при запуске каждый раз, когда ваш оркестратор его перезапускает. Установите `--capacity 1` и запускайте больше реплик для параллелизма. [When the runner exits](#when-the-runner-exits) показывает строку, которую печатает runner.

191</Warning>

192 

187Runner также сообщает согласие Anthropic при регистрации, печатая `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` при запуске. Сообщение о согласии требует Claude Code v2.1.267 или позже, и более ранние версии принимают флаг без сообщения об этом или печати этой строки. Каждый сеанс на согласившемся runner затем использует либо управляемый Anthropic git, либо URL прокси для каждого сеанса. Когда сеанс использует URL прокси для каждого сеанса, runner регистрирует одну строку `[runner:warn]`, говорящую об этом.193Runner также сообщает согласие Anthropic при регистрации, печатая `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` при запуске. Сообщение о согласии требует Claude Code v2.1.267 или позже, и более ранние версии принимают флаг без сообщения об этом или печати этой строки. Каждый сеанс на согласившемся runner затем использует либо управляемый Anthropic git, либо URL прокси для каждого сеанса. Когда сеанс использует URL прокси для каждого сеанса, runner регистрирует одну строку `[runner:warn]`, говорящую об этом.

188 194 

195<h4 id="trust-a-private-certificate-authority-with-anthropic-managed-git">

196 Доверьте приватному центру сертификации с управляемым git Anthropic

197</h4>

198 

199Этот раздел применяется, если вы установили `GIT_SSL_CAINFO` или `GIT_SSL_NO_VERIFY` в окружении runner, чьи сеансы используют управляемый git Anthropic. Обработка, которую он описывает, требует, чтобы runner запускал Claude Code v2.1.283 или позже.

200 

201Когда git на runner должен доверять приватному центру сертификации (CA), такому как тот, который подписывает TLS-инспектирующий прокси, обычные подходы работают следующим образом:

202 

203* **Хранилище системных сертификатов**: установите ваш CA в хранилище системных сертификатов хоста runner, и git доверяет ему без обеих переменных.

204* **`GIT_SSL_CAINFO`**: установите его на PEM-файл ваших CA, например `GIT_SSL_CAINFO=/etc/ssl/corp-ca.pem`.

205* **`GIT_SSL_NO_VERIFY`**: не помогает за переподписывающим прокси. Собственный clone runner через управляемый git Anthropic проверяет сертификаты даже когда переменная установлена, поэтому этот clone не удается, пока git не доверяет вашему CA через один из других двух подходов.

206 

207Для git-соединений, которые несут токен сеанса к управляемому git Anthropic, runner применяет две переменные следующим образом. [`command` hook](/docs/ru/self-hosted-environments-configuration#command) начинается с окружения сеанса, поэтому он получает то, что получает git внутри сеанса:

208 

209* **`GIT_SSL_CAINFO`**: то, что git проверяет управляемый git Anthropic против, зависит от того, где запускается git:

210 * **Собственный clone и fetches runner**: запускаются без переменной и проверяют управляемый git Anthropic против файла сертификата для каждого сеанса, который пишет runner. Этот файл содержит системный CA bundle хоста runner плюс сертификаты из вашего файла.

211 * **Git внутри сеанса**: получает конфигурацию `http.sslCAInfo`, называющую ваш файл вместо переменной, плюс записи `http.<url>.sslCAInfo`, которые проверяют управляемый git Anthropic против файла для каждого сеанса.

212 * **`checkout` и `post-session` hooks**: наследуют переменную без изменений.

213* **`GIT_SSL_NO_VERIFY`**: какие проверки сертификатов остаются отключенными, зависит от того, где запускается git:

214 * **Собственный clone и fetches runner**: запускаются без переменной и проверяют сертификат, который им представлен.

215 * **Git внутри сеанса**: получает конфигурацию `http.sslVerify=false` вместо переменной, поэтому проверки остаются отключенными для других хостов. Он также получает записи `http.<url>.sslVerify=true`, которые держат проверки включенными для управляемого git Anthropic.

216 * **`checkout` и `post-session` hooks**: когда сеанс имеет репозиторий на управляемом git Anthropic, получают конфигурацию `http.sslVerify=false` вместо переменной. Они также получают записи `http.<url>.sslVerify=true`, которые держат проверки включенными для управляемого git Anthropic.

217 

218Файл сертификата для каждого сеанса нуждается в системном CA bundle в `/etc/ssl/certs/ca-certificates.crt` или `/etc/pki/tls/certs/ca-bundle.crt` на хосте runner. Ему также нужен файл `GIT_SSL_CAINFO`, который может читать пользователь runner, который содержит блоки PEM `CERTIFICATE`, и который составляет максимум 1 MiB. Когда runner не может построить файл для каждого сеанса, он регистрирует строку `[runner:warn]`, содержащую `did not build the certificate file` и причину. Git затем использует ваш файл как есть для управляемого git Anthropic. Исправьте то, что называет строка.

219 

220Для каждого сеанса, который использует управляемый git Anthropic, runner также регистрирует строку `[runner:warn]`, которая начинается с `governed git: GIT_SSL_CAINFO is set` или `governed git: GIT_SSL_NO_VERIFY is set`. Строка говорит, что runner сделал с этой переменной для своего собственного git, для git внутри сеанса и для ваших lifecycle hooks. Она заканчивается тем, нужно ли вам что-то менять.

221 

189<h3 id="rewrite-git-urls-for-private-networks">222<h3 id="rewrite-git-urls-for-private-networks">

190 Переписывайте URL git для приватных сетей223 Переписывайте URL git для приватных сетей

191</h3>224</h3>


203 236 

204Anthropic не публикует предварительно построенный образ runner. Постройте свой собственный вокруг бинарного файла `claude`, наслаивая любой набор инструментов, который нужен вашим репозиториям: языковые среды выполнения, компиляторы, менеджеры пакетов и [MCP](/docs/ru/mcp) sidecars.237Anthropic не публикует предварительно построенный образ runner. Постройте свой собственный вокруг бинарного файла `claude`, наслаивая любой набор инструментов, который нужен вашим репозиториям: языковые среды выполнения, компиляторы, менеджеры пакетов и [MCP](/docs/ru/mcp) sidecars.

205 238 

206Рецепты ниже используют `--capacity 4`, поэтому один контейнер обслуживает до четырех одновременных сеансов от одного заблокированного владельца. Это не обеспечивает изоляцию контейнера для каждого сеанса в [разделе усиления безопасности](#harden-your-deployment): перед подключением окружения к production-системам либо запустите рецепты на `--capacity 1` с одним контейнером на сеанс, либо используйте [on-demand runners](/docs/ru/self-hosted-environments-configuration#on-demand-runners), которые также держат секрет окружения вне хостов, запускающих сеансы.239Рецепты ниже используют `--capacity 4`, поэтому один контейнер обслуживает до четырех одновременных сеансов от одного заблокированного владельца. Это не обеспечивает изоляцию контейнера для каждого сеанса в [разделе усиления безопасности](#harden-your-deployment): перед подключением окружения к production-системам либо запустите рецепты на `--capacity 1` с одним контейнером на сеанс, либо используйте [on-demand runners](/docs/ru/self-hosted-environments-configuration#on-demand-runners), которые также держат секрет окружения вне хостов, запускающих сеансы. Если вы добавите [Anthropic git proxy](#use-the-anthropic-git-proxy) к одному из этих рецептов, также измените `--capacity` на `1`.

207 240 

208Этот Dockerfile является минимальной отправной точкой:241Этот Dockerfile является минимальной отправной точкой:

209 242 


338 371 

339Сервис Compose ниже перезапускает runner всякий раз, когда он выходит, что охватывает как сбои, так и нормальный выход после осушения. Политика перезагрузки Docker перезапускает тот же контейнер с его записываемым слоем нетронутым, поэтому runner возвращается на переиспользованной файловой системе, а не на свежей, которую рекомендует [позиция усиления безопасности](#harden-your-deployment); используйте этот рецепт для оценки, и для production либо пересоздайте контейнер за запуск, либо используйте оркестратор, который это делает.372Сервис Compose ниже перезапускает runner всякий раз, когда он выходит, что охватывает как сбои, так и нормальный выход после осушения. Политика перезагрузки Docker перезапускает тот же контейнер с его записываемым слоем нетронутым, поэтому runner возвращается на переиспользованной файловой системе, а не на свежей, которую рекомендует [позиция усиления безопасности](#harden-your-deployment); используйте этот рецепт для оценки, и для production либо пересоздайте контейнер за запуск, либо используйте оркестратор, который это делает.

340 373 

374Docker ждёт дольше перед каждым перезапуском контейнера, который продолжает выходить, вплоть до потолка, поэтому runner, который не может запуститься, не продолжает перезапускаться в плотном цикле под этим рецептом. [Когда runner выходит](#when-the-runner-exits) описывает, что проверить, когда это происходит.

375 

341```yaml theme={null}376```yaml theme={null}

342services:377services:

343 claude-runner:378 claude-runner:


451 486 

452Процесс дочернего Claude Code каждого сеанса запускает собственный бинарный файл runner, и runner отключает auto-update внутри сеансов, которые он порождает, поэтому каждый сеанс запускает версию, которую вы установили на хосте или встроили в образ. Обновление на уровне хоста вступает в силу в следующий раз, когда runner запускается.487Процесс дочернего Claude Code каждого сеанса запускает собственный бинарный файл runner, и runner отключает auto-update внутри сеансов, которые он порождает, поэтому каждый сеанс запускает версию, которую вы установили на хосте или встроили в образ. Обновление на уровне хоста вступает в силу в следующий раз, когда runner запускается.

453 488 

489Модель, которую используют ваши сеансы, может требовать более новую версию Claude Code, чем та, которую они запускают. Сервер затем отклоняет запросы для этой модели с [Claude Code does not support this model](/docs/ru/errors#claude-code-does-not-support-this-model). Перед тем как закрепить версию, проверьте [версии Claude Code, которые требуют модели](/docs/ru/model-config#available-models) для каждой модели, которую используют ваши сеансы.

490 

454* **Чтобы держать флот на одной версии**: постройте образ с закрепленной версией или на голом хосте установите конкретную версию и [отключите auto-updates](/docs/ru/setup#disable-auto-updates)491* **Чтобы держать флот на одной версии**: постройте образ с закрепленной версией или на голом хосте установите конкретную версию и [отключите auto-updates](/docs/ru/setup#disable-auto-updates)

455* **Чтобы обновить**: установите более новую версию или пересоздайте образ, затем перезагрузите runners492* **Чтобы обновить**: установите более новую версию или пересоздайте образ, затем перезагрузите runners

456* **Плагины**: рынки плагинов тоже не auto-update; установите `FORCE_AUTOUPDATE_PLUGINS=1` в окружении runner, чтобы позволить плагинам auto-update, пока бинарный файл остается закрепленным493* **Плагины**: рынки плагинов тоже не auto-update; установите `FORCE_AUTOUPDATE_PLUGINS=1` в окружении runner, чтобы позволить плагинам auto-update, пока бинарный файл остается закрепленным


554 591 

555Каждый процесс дочернего сеанса пишет отдельный отладочный лог. При отказе runner выводит хвост логов рядом с сеансом в claude.ai/code. Если вы не запустили runner с [`--remove-session-state`](/docs/ru/self-hosted-environments-reference#runner-cli-flags), он также сохраняет лог неудачного сеанса на диске и печатает его путь в логе runner.592Каждый процесс дочернего сеанса пишет отдельный отладочный лог. При отказе runner выводит хвост логов рядом с сеансом в claude.ai/code. Если вы не запустили runner с [`--remove-session-state`](/docs/ru/self-hosted-environments-reference#runner-cli-flags), он также сохраняет лог неудачного сеанса на диске и печатает его путь в логе runner.

556 593 

594<h3 id="when-the-runner-exits">

595 Когда runner выходит

596</h3>

597 

598Не перезапускайте [on-demand runner](/docs/ru/self-hosted-environments-configuration#on-demand-runners), потому что его рабочий заказ одноразовый. Runner, который выходит сразу после запуска, требует другой обработки, чем тот, который выходит по любой другой причине.

599 

600* **Нормальный выход**: runner завершил свои сеансы и осушился, достиг времени выхода на пенсию или ему было приказано остановиться. Перезапустите его, чтобы окружение снова имело емкость. [Runner lifecycle](/docs/ru/self-hosted-environments#runner-lifecycle) описывает эти выходы.

601* **Неудачный старт**: runner не может запуститься с конфигурацией или хостом, который ему был дан, поэтому он выходит через несколько секунд после запуска, и он выходит одинаково каждый раз, когда вы его перезапускаете. Перезапуск его быстрее не помогает. Кто-то должен прочитать его вывод и исправить причину.

602 

603Конфигурируйте ваш supervisor, чтобы перезапустить runner всякий раз, когда он выходит, чтобы ждать дольше между перезапусками, когда runner продолжает выходить сразу после запуска, и чтобы сообщить кому-то, когда это продолжает происходить.

604 

605<h4 id="recognize-a-failed-start">

606 Распознайте неудачный старт

607</h4>

608 

609Когда runner не может запуститься, он печатает строку, которая говорит почему, а затем выходит. Для большинства причин строка содержит `[runner:fatal]`. Для некоторых причин строка начинается с `error:` вместо этого, включая когда runner не может разобрать свои флаги, не может прочитать секрет окружения или не может создать или писать в базовый каталог. Следующая строка затем указывает на `--help`.

610 

611Большинство строк логов начинаются с временной метки и `[self-hosted-runner]`, которые образец ниже опускает. Например, runner, запущенный с прокси Anthropic git и емкостью выше одного, печатает строку, подобную этой:

612 

613```text theme={null}

614[runner:fatal] --use-anthropic-git-proxy requires --capacity 1 (the proxy URL is per-session and linked worktrees share origin). Omit --use-anthropic-git-proxy or set --capacity 1.

615```

616 

617Ищите строку в стандартном выводе и стандартной ошибке runner, в логах контейнера вашей платформы или в файле, который вы установили с помощью [`--log-file`](/docs/ru/self-hosted-environments-reference#runner-cli-flags). Runner печатает строку `error:` перед открытием файла логов, поэтому ищите его в терминале или логах контейнера, как отмечает [Troubleshooting](#troubleshooting).

618 

619Это также помогает, когда вы читаете неудачный старт:

620 

621* **Нет строки вообще**: runner, который хост убивает, не печатает ни одну. Если вывод заканчивается без строки `[runner:fatal]` и без строки `error:`, проверьте, остановил ли хост или ваш оркестратор процесс, например, за превышение лимита памяти.

622* **Код выхода**: runner не откладывает код выхода для ошибок, которые повторяются при каждом запуске. Он выходит с тем же кодом для ошибки конфигурации, такой как неподдерживаемая комбинация флагов, и для отказа, который может очиститься сам по себе, такой как API, остающийся недостижимым через собственные повторы runner. Основывайте решение ждать дольше на том, как скоро runner выходит, и прочитайте вывод runner, чтобы узнать почему.

623* **Окружение, которое выглядит здоровым**: некоторые шаги запуска запускаются после того, как runner регистрируется в вашем окружении, такие как [`--configure-git`](#let-the-runner-configure-git) и настройка учетных данных прокси Anthropic git. Если один из этих шагов не удается, окружение может продолжать перечислять этот runner в течение нескольких минут после выхода процесса, и страница **Cloud environments** может читать **Healthy**, пока ни один runner не подхватывает работу. Если сеансы остаются поставленными в очередь в окружении, которое выглядит здоровым, проверьте, перезапускает ли ваш supervisor runner.

624 

625<h4 id="restart-with-a-wait-that-grows">

626 Перезапуск с растущим ожиданием

627</h4>

628 

629Как вы получаете растущее ожидание, зависит от вашего supervisor.

630 

631* **Kubernetes**: [Deployment](#kubernetes) на этой странице не требует изменений. После выхода контейнера kubelet по умолчанию ждет перед перезапуском контейнера, и ожидание растет при каждом перезапуске до потолка. Ожидание начинается заново, как только контейнер работает некоторое время без выхода.

632 

633 Kubelet применяет то же ожидание после нормального выхода, когда контейнер работал только недолго. Runner, который часто осушается, поэтому может также показать статус `CrashLoopBackOff`, поэтому прочитайте вывод перед тем, как вы заключите, что runner не может запуститься. Команда ниже читает вывод последнего запуска из одного pod Deployment:

634 

635 ```bash theme={null}

636 kubectl logs --previous -n claude-runners deploy/claude-runner

637 ```

638 

639 Когда последний запуск был неудачным стартом, строка `[runner:fatal]` или `error:` находится среди последних строк вывода. Чтобы прочитать последний запуск другого pod, назовите этот pod вместо `deploy/claude-runner`.

640* **Docker и Docker Compose**: [Compose recipe](#docker-compose) на этой странице не требует изменений. С `restart: always`, Docker ждет дольше перед каждым перезапуском контейнера, который продолжает выходить, до потолка. Замените `<container>` на имя контейнера в команде ниже, которая читает, сколько раз Docker перезапустил контейнер:

641 

642 ```bash theme={null}

643 docker inspect --format '{{.RestartCount}}' <container>

644 ```

645 

646 Команда печатает число. Число, которое продолжает расти, означает, что Docker продолжает перезапускать runner.

647* **Модуль systemd**: по умолчанию systemd ждет одинаковый `RestartSec` перед каждым перезапуском и не удлиняет его, поэтому модуль с `Restart=always` перезапускает runner, который не может запуститься в этом же интервале каждый раз. Когда старты приходят достаточно быстро, чтобы достичь лимита скорости запуска модуля, пять стартов в 10 секунд по умолчанию, systemd прекращает перезапуск модуля. Модуль остается остановленным, пока кто-то его снова не запустит, что systemd позволяет, как только интервал лимита скорости прошел или после `systemctl reset-failed`. Потому что `RestartSec` применяется к каждому перезапуску, большее значение также задерживает перезапуск после нормального выхода. Выберите значение, которое балансирует два, и предупредите о счетчике перезапусков модуля.

648* **Цикл shell или ваш собственный supervisor**: применяйте то же правило самостоятельно. Начните с ожидания в пять секунд. После каждого запуска, который закончился в течение минуты, удвойте ожидание для следующего перезапуска, до пяти минут. После запуска, который длился минуту или более, вернитесь к пяти секундам.

649 

650<h4 id="check-why-the-runner-keeps-exiting">

651 Проверьте, почему runner продолжает выходить

652</h4>

653 

654Когда runner выходит сразу после запуска несколько раз подряд, остановитесь и проверьте это перед перезапуском снова.

655 

656* **Последняя строка `[runner:fatal]` или `error:`**: она говорит почему runner остановился. [Troubleshooting](#troubleshooting) перечисляет распространенные причины.

657* **Комбинация флагов**: [Anthropic git proxy](#use-the-anthropic-git-proxy) требует `--capacity 1`. Рецепты на этой странице используют более высокую емкость, поэтому понизьте ее, когда вы добавляете прокси к одному из них.

658* **Что может достичь окружение сервиса**: если runner запускается вручную и не удается под вашим supervisor, сравните пользователя, домашний каталог, `PATH` и лимит памяти. `--configure-git` и прокси Anthropic git нужны git на `PATH` и записываемый `~/.gitconfig`.

659* **Секрет окружения**: если вы отозвали секрет или неправильно его напечатали, runner печатает строку, которая содержит `RegisterRunner auth failed`.

660* **Вкладка Activity окружения**: откройте окружение и выберите **Activity**. Если новые runners продолжают появляться там и ни один не подхватывает работу, ваш supervisor перезапускает runner.

661 

662Для управляемой диагностики на хосте runner запустите [подкоманду doctor](#troubleshooting).

663 

557<h2 id="what’s-next">664<h2 id="what’s-next">

558 Что дальше665 Что дальше

559</h2>666</h2>

Details

105 </Step>105 </Step>

106</Steps>106</Steps>

107 107 

108Runner выходит по дизайну после завершения его активных сеансов; см. [Runner lifecycle](/docs/ru/self-hosted-environments#runner-lifecycle). Для production развёртывайте его под оркестратором, который перезапускает его при выходе. См. [Развёртывание в production](/docs/ru/self-hosted-environments-deploy).108Runner выходит по дизайну после завершения его активных сеансов; см. [Runner lifecycle](/docs/ru/self-hosted-environments#runner-lifecycle). Для production развёртывайте его под оркестратором, который перезапускает его при выходе и ждёт дольше между перезапусками, когда runner продолжает выходить сразу после запуска. См. [Deploy to production](/docs/ru/self-hosted-environments-deploy) и [When the runner exits](/docs/ru/self-hosted-environments-deploy#when-the-runner-exits).

109 109 

110<h2 id="send-a-follow-up-message-to-a-running-session">110<h2 id="send-a-follow-up-message-to-a-running-session">

111 Отправьте follow-up сообщение работающему сеансу111 Отправьте follow-up сообщение работающему сеансу

Details

80 Флаги SCM connector80 Флаги SCM connector

81</h3>81</h3>

82 82 

83Orchestrator может держать постоянное подключение WebSocket к плоскости управления Anthropic, чтобы размещенные предсеансовые потоки, такие как средство выбора репозитория и средство разрешения ветви или ссылки, могли достичь хоста GitHub Enterprise Server, который маршрутизируется только изнутри вашей сети. Соединитель остается отключенным, если вы не установите `--scm-connector-host`.83Соединитель SCM недоступен, поэтому оставьте флаги в этом разделе неустановленными. Если вы установите `--scm-connector-host`, соединение не открывается, и orchestrator продолжает его переподключать. Runners по-прежнему запускаются по мере поступления сеансов в очередь.

84 

85Соединитель — это постоянное подключение WebSocket от orchestrator к плоскости управления Anthropic. Он разработан для того, чтобы позволить размещенным предсеансовым потокам, таким как средство выбора репозитория и средство разрешения ветви или ссылки, достичь хоста GitHub Enterprise Server, который маршрутизируется только изнутри вашей сети. См. [Network requirements](/docs/ru/github-enterprise-server#network-requirements) на странице GitHub Enterprise Server для получения информации о том, что требуется этим потокам.

84 86 

85| Флаг | По умолчанию | Описание |87| Флаг | По умолчанию | Описание |

86| :- | :- | :- |88| :- | :- | :- |

87| `--scm-connector-host <host[:port]>` | unset | Имя хоста GitHub Enterprise Server для перенаправления запросов. Порт по умолчанию `443`. Установка этого флага включает соединитель. |89| `--scm-connector-host <host[:port]>` | unset | Имя хоста GitHub Enterprise Server для перенаправления запросов. Порт по умолчанию `443`. |

88| `--scm-connector-id <n>` | required with `--scm-connector-host` | Числовой ID подключения GitHub Enterprise Server вашей организации. Свяжитесь с командой вашего аккаунта Anthropic для значения при включении соединителя. |90| `--scm-connector-id <n>` | required with `--scm-connector-host` | Числовой ID подключения GitHub Enterprise Server вашей организации. |

89| `--scm-connector-provider <slug>` | `ghe` | Сегмент пути, идентифицирующий поставщика, соответствующий `^[a-z0-9-]{1,32}$`. |91| `--scm-connector-provider <slug>` | `ghe` | Сегмент пути, идентифицирующий поставщика, соответствующий `^[a-z0-9-]{1,32}$`. |

90| `--scm-connector-ca-file <path>` | unset | Дополнительный пакет CA в формате PEM для подключений TLS к хосту GitHub Enterprise Server. |92| `--scm-connector-ca-file <path>` | unset | Дополнительный пакет CA в формате PEM для подключений TLS к хосту GitHub Enterprise Server. |

91| `--scm-connector-host-rewrite <from>=<to_host:to_port>` | unset | Только для сквозного тестирования: перенаправляет подключение TCP, сохраняя заголовок Host и TLS SNI как `--scm-connector-host`. |93| `--scm-connector-host-rewrite <from>=<to_host:to_port>` | unset | Только для сквозного тестирования: перенаправляет подключение TCP, сохраняя заголовок Host и TLS SNI как `--scm-connector-host`. |

92 94 

93Соединитель аутентифицируется с существующим секретом среды orchestrator и автоматически переподключается: с экспоненциальной задержкой при разорванном подключении или фиксированной 30-секундной задержкой, когда плоскость управления закрывает подключение, потому что другая реплика orchestrator уже его держит.95При каждой попытке подключения orchestrator отправляет свой существующий секрет окружения, и он автоматически переподключается с экспоненциальной задержкой, ограниченной 30 секундами плюс jitter.

94 96 

95<h2 id="environment-variable-only-settings">97<h2 id="environment-variable-only-settings">

96 Параметры только для переменных окружения98 Параметры только для переменных окружения

Details

595| [`agent`](#agent) | Начните каждый сеанс как именованный [подагент](/docs/ru/sub-agents) с его подсказкой, инструментами и моделью | Agents, sessions, and worktrees | Any file |595| [`agent`](#agent) | Начните каждый сеанс как именованный [подагент](/docs/ru/sub-agents) с его подсказкой, инструментами и моделью | Agents, sessions, and worktrees | Any file |

596| [`agentPushNotifEnabled`](#agentpushnotifenabled) | Позвольте Claude отправить [push-уведомление на ваш телефон](/docs/ru/remote-control#mobile-push-notifications), когда он решит это сделать | Remote, desktop, and notifications | Any file |596| [`agentPushNotifEnabled`](#agentpushnotifenabled) | Позвольте Claude отправить [push-уведомление на ваш телефон](/docs/ru/remote-control#mobile-push-notifications), когда он решит это сделать | Remote, desktop, and notifications | Any file |

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| [`allowClaudeInChromeWithManagedMcp`](#allowclaudeinchromewithmanagedmcp) | Позвольте встроенному [серверу Claude в Chrome](/docs/ru/chrome) работать наряду с развёрнутым [`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 |599| [`allowedChannelPlugins`](#allowedchannelplugins) | Замените список разрешений по умолчанию для [плагинов канала](/docs/ru/channels#restrict-which-channel-plugins-can-run), которые могут отправлять сообщения | Plugins and skills | Managed |

599| [`allowedHttpHookUrls`](#allowedhttphookurls) | Ограничьте, какие URL-адреса могут использовать [HTTP hooks](/docs/ru/hooks) | Hooks and automation | Any file |600| [`allowedHttpHookUrls`](#allowedhttphookurls) | Ограничьте, какие URL-адреса могут использовать [HTTP hooks](/docs/ru/hooks) | Hooks and automation | Any file |

600| [`allowedMcpServers`](#allowedmcpservers) | Создайте список разрешений для [MCP серверов](/docs/ru/mcp), которые могут добавлять пользователи | MCP | Any file |601| [`allowedMcpServers`](#allowedmcpservers) | Создайте список разрешений для [MCP серверов](/docs/ru/mcp), которые могут добавлять пользователи | MCP | Any file |


3064</h4>3065</h4>

3065 3066 

3066* Значение здесь перезаписывает ту же переменную, экспортированную в вашей оболочке, и когда более одного файла параметров устанавливает переменную, применяется [наиболее приоритетный](/docs/ru/settings#settings-precedence). [Переменные, которые Claude Code игнорирует в `env`](#variables-claude-code-ignores-in-env) перечисляет исключения для параметров проекта и локальных параметров.3067* Значение здесь перезаписывает ту же переменную, экспортированную в вашей оболочке, и когда более одного файла параметров устанавливает переменную, применяется [наиболее приоритетный](/docs/ru/settings#settings-precedence). [Переменные, которые Claude Code игнорирует в `env`](#variables-claude-code-ignores-in-env) перечисляет исключения для параметров проекта и локальных параметров.

3068* Когда приложение Claude Desktop или [самостоятельно размещённая среда](/docs/ru/self-hosted-environments) запускает сессию, среда запуска, которую оно создаёт, имеет приоритет вместо этого: Claude Code игнорирует значение `env` из любого файла параметров для переменной, которую среда запуска уже устанавливает. [Журнал отладки](/docs/ru/debug-your-config) называет каждую игнорируемую переменную.

3067* Чтобы отменить экспорт оболочки, установите переменную на `""`. Claude Code рассматривает пустое значение как не установленное для выбора поставщика, и подпроцессы наследуют пустое значение.3069* Чтобы отменить экспорт оболочки, установите переменную на `""`. Claude Code рассматривает пустое значение как не установленное для выбора поставщика, и подпроцессы наследуют пустое значение.

3068* `NO_COLOR` и `FORCE_COLOR`, установленные здесь, достигают только подпроцессов. Чтобы изменить цвета собственного интерфейса Claude Code, установите их в вашей оболочке перед запуском `claude`.3070* `NO_COLOR` и `FORCE_COLOR`, установленные здесь, достигают только подпроцессов. Чтобы изменить цвета собственного интерфейса Claude Code, установите их в вашей оболочке перед запуском `claude`.

3069* Значения здесь представляют собой простой текст в файле параметров и достигают каждого подпроцесса, который запускает Claude Code. Для токена OTLP, который ротируется, используйте [`otelHeadersHelper`](#otelheadershelper); для учётных данных API используйте [`apiKeyHelper`](#apikeyhelper).3071* Значения здесь представляют собой простой текст в файле параметров и достигают каждого подпроцесса, который запускает Claude Code. Для токена OTLP, который ротируется, используйте [`otelHeadersHelper`](#otelheadershelper); для учётных данных API используйте [`apiKeyHelper`](#apikeyhelper).


5157 5159 

5158[`allowedMcpServers`](#allowedmcpservers) и [`deniedMcpServers`](#deniedmcpservers) по-прежнему применяются к соединителям, которые загружает этот ключ. Соединители, доставленные в [облачный сеанс](/docs/ru/claude-code-on-the-web), хост которого содержит `managed-mcp.json`, например самостоятельно размещённый runner, остаются подавленными. См. [Разрешить соединители claude.ai наряду с управляемым набором](/docs/ru/managed-mcp#allow-claude-ai-connectors-alongside-the-managed-set).5160[`allowedMcpServers`](#allowedmcpservers) и [`deniedMcpServers`](#deniedmcpservers) по-прежнему применяются к соединителям, которые загружает этот ключ. Соединители, доставленные в [облачный сеанс](/docs/ru/claude-code-on-the-web), хост которого содержит `managed-mcp.json`, например самостоятельно размещённый runner, остаются подавленными. См. [Разрешить соединители claude.ai наряду с управляемым набором](/docs/ru/managed-mcp#allow-claude-ai-connectors-alongside-the-managed-set).

5159 5161 

5162<h3 id="allowclaudeinchromewithmanagedmcp">

5163 `allowClaudeInChromeWithManagedMcp`

5164</h3>

5165 

5166Позволяйте встроенному серверу [Claude в Chrome](/docs/ru/chrome) работать наряду с развёрнутым `managed-mcp.json`. Без этого ключа развёрнутый `managed-mcp.json` блокирует Claude в Chrome в сеансах терминала. Требует Claude Code версии 2.1.282 или позже.

5167 

5168* **Scope**: [`Managed`](#scopes), только из собственных управляемых параметров устройства: развёрнутого MDM plist или ключа реестра HKLM, или системного файла `managed-settings.json`. Claude Code игнорирует его в управляемых параметрах сервера, в пользовательском реестре HKCU и в пользовательских или проектных параметрах.

5169* **Type**: Boolean

5170 * `true`: встроенный сервер Claude в Chrome может работать наряду с развёрнутым `managed-mcp.json`

5171 * `false`: развёрнутый `managed-mcp.json` блокирует Claude в Chrome в сеансах терминала

5172* **Default**: `false`, поэтому развёрнутый `managed-mcp.json` блокирует Claude в Chrome в сеансах терминала

5173 

5174```json managed-settings.json theme={null}

5175{

5176 "allowClaudeInChromeWithManagedMcp": true

5177}

5178```

5179 

5180Запись [`deniedMcpServers`](#deniedmcpservers) для `claude-in-chrome` по-прежнему блокирует сервер с этим ключом включённым. См. [Разрешить Claude в Chrome наряду с управляемым набором](/docs/ru/managed-mcp#allow-claude-in-chrome-alongside-the-managed-set).

5181 

5160<h3 id="allowedmcpservers">5182<h3 id="allowedmcpservers">

5161 `allowedMcpServers`5183 `allowedMcpServers`

5162</h3>5184</h3>

5163 5185 

5164Создайте список разрешённых серверов MCP, которые люди могут добавлять. Claude Code блокирует любой сервер, который не соответствует записи, где бы он ни был определён, включая серверы плагинов, серверы, переданные с `--mcp-config`, и серверы из claude.ai.5186Создайте список разрешённых серверов MCP, которые люди могут добавлять. Claude Code блокирует любой сервер, который не соответствует записи, где бы он ни был определён, включая серверы плагинов, серверы, переданные с `--mcp-config`, и серверы из claude.ai.

5165 5187 

5166Встроенные серверы, такие как Claude в Chrome, сервер `ide`, к которому Claude Code подключается в работающей IDE [VS Code](/docs/ru/vs-code#the-built-in-ide-mcp-server) или [JetBrains](/docs/ru/jetbrains#the-built-in-ide-mcp-server), и серверы, которые сам CLI настраивает, освобождены от списка разрешений, и список запретов по-прежнему применяется к ним. Внутрипроцессные серверы `type: "sdk"` освобождены от обоих списков; [приложение, которое запустило сеанс](/docs/ru/mcp#how-connectors-reach-claude-code), регистрирует их.5188Встроенные серверы, такие как Claude в Chrome, сервер `ide`, к которому Claude Code подключается в работающей IDE [VS Code](/docs/ru/vs-code#the-built-in-ide-mcp-server) или [JetBrains](/docs/ru/jetbrains#the-built-in-ide-mcp-server), и серверы, которые сам CLI настраивает, освобождены от списка разрешений, и список запретов по-прежнему применяется к ним. На Claude Code версии 2.1.268 или позже, инструменты Slack сеанса [Claude Tag](/docs/ru/claude-tag) также освобождены от списка разрешений, и список запретов по-прежнему применяется к ним. Внутрипроцессные серверы `type: "sdk"` освобождены от обоих списков; [приложение, которое запустило сеанс](/docs/ru/mcp#how-connectors-reach-claude-code), регистрирует их.

5167 5189 

5168Серверы, которые доставляет ваша организация, также освобождены от списка разрешений, и список запретов по-прежнему применяется к ним. Освобождение охватывает каждую запись [`managedMcpServers`](#managedmcpservers) и любую запись [`managed-mcp.json`](/docs/ru/managed-mcp#exclusive-control-with-managed-mcp-json), значения которой не используют расширение `${VAR}`. См. [Как оценивается сервер](/docs/ru/managed-mcp#how-a-server-is-evaluated) для полного порядка проверки. До версии 2.1.259 серверы из `managed-mcp.json` также должны были совпадать.5190Серверы, которые доставляет ваша организация, также освобождены от списка разрешений, и список запретов по-прежнему применяется к ним. Освобождение охватывает каждую запись [`managedMcpServers`](#managedmcpservers) и любую запись [`managed-mcp.json`](/docs/ru/managed-mcp#exclusive-control-with-managed-mcp-json), значения которой не используют расширение `${VAR}`. См. [Как оценивается сервер](/docs/ru/managed-mcp#how-a-server-is-evaluated) для полного порядка проверки. До версии 2.1.259 серверы из `managed-mcp.json` также должны были совпадать.

5169 5191 


6304 `disableSideloadFlags`6326 `disableSideloadFlags`

6305</h3>6327</h3>

6306 6328 

6307Отклонять флаги CLI `--plugin-dir`, `--plugin-url`, `--agents` и `--mcp-config` при запуске, которые пользователи могут передать для обхода [`strictKnownMarketplaces`](#strictknownmarketplaces) при одном запуске. Claude Code завершает работу с ошибкой, указывающей на отклоненные флаги, и применяет ту же проверку к поверхностям, которые запускают CLI с этими флагами внутри, в настоящее время [Cowork](/docs/ru/desktop) локальные сеансы в приложении для рабочего стола. В [облачных сеансах](/docs/ru/claude-code-on-the-web) Claude Code удаляет MCP серверы, которые сервер доставил через `--mcp-config`, за исключением встроенных записей `type: "sdk"`, и запускает сеанс. Требуется Claude Code v2.1.193 или позже.6329Отклонять флаги CLI `--plugin-dir`, `--plugin-url`, `--agents` и `--mcp-config` при запуске, которые пользователи могут передать для обхода [`strictKnownMarketplaces`](#strictknownmarketplaces) при одном запуске. Claude Code завершает работу с ошибкой, указывающей на отклоненные флаги, и применяет ту же проверку к поверхностям, которые запускают CLI с этими флагами внутри, в настоящее время [Cowork](/docs/ru/desktop) локальные сеансы в приложении для рабочего стола. В [облачных сеансах](/docs/ru/claude-code-on-the-web) Claude Code вместо этого запускает сеанс и удаляет каждую доставленную сервером запись `--mcp-config`, кроме встроенных записей `type: "sdk"` и инструментов Slack сеанса [Claude Tag](/docs/ru/claude-tag). Требуется Claude Code v2.1.193 или позже.

6308 6330 

6309* **Область**: [`Managed`](#scopes)6331* **Область**: [`Managed`](#scopes)

6310* **Тип**: Boolean6332* **Тип**: Boolean

6311 * `true`: Claude Code отклоняет `--plugin-dir`, `--plugin-url`, `--agents` и `--mcp-config` при запуске и завершает работу с ошибкой, указывающей на них, за исключением облачных сеансов, где он удаляет MCP серверы, которые сервер доставил через `--mcp-config`, за исключением встроенных записей `type: "sdk"`, и запускает сеанс6333 * `true`: Claude Code отклоняет `--plugin-dir`, `--plugin-url`, `--agents` и `--mcp-config` при запуске и завершает работу с ошибкой, указывающей на них. В облачных сеансах вместо этого запускает сеанс и удаляет каждую доставленную сервером запись `--mcp-config`, кроме встроенных записей `type: "sdk"` и инструментов Slack сеанса Claude Tag

6312 * `false`: Claude Code принимает эти флаги6334 * `false`: Claude Code принимает эти флаги

6313* **По умолчанию**: `false`6335* **По умолчанию**: `false`

6314 6336 


6322 6344 

6323Та же проверка охватывает папки плагинов, названные в переменной окружения [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ru/env-vars#variables), что требует Claude Code v2.1.280 или позже. Когда переменная называет папку, Claude Code завершает работу с той же ошибкой, и ошибка говорит отменить установку переменной.6345Та же проверка охватывает папки плагинов, названные в переменной окружения [`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ru/env-vars#variables), что требует Claude Code v2.1.280 или позже. Когда переменная называет папку, Claude Code завершает работу с той же ошибкой, и ошибка говорит отменить установку переменной.

6324 6346 

6325В облачных сеансах Claude Code также игнорирует обновления MCP, доставленные сервером в середине сеанса, путь позади конфигурации облачного сеанса и SDK `setMcpServers()` вызовов, которые достигают этих сеансов. Встроенные записи `type: "sdk"` остаются исключенными там же. До v2.1.239 доставленный сервером `--mcp-config` блокировал запуск облачного сеанса.6347В облачных сеансах Claude Code также игнорирует обновления MCP, доставленные сервером в середине сеанса, путь позади конфигурации облачного сеанса и SDK `setMcpServers()` вызовов, которые достигают этих сеансов. Встроенные записи `type: "sdk"` и инструменты Slack сеанса Claude Tag остаются исключенными там же. До v2.1.268 как это удаление, так и удаление при запуске также удаляли инструменты Slack сеанса Claude Tag. До v2.1.239 доставленный сервером `--mcp-config` блокировал запуск облачного сеанса.

6326 6348 

6327<h3 id="forceremotesettingsrefresh">6349<h3 id="forceremotesettingsrefresh">

6328 `forceRemoteSettingsRefresh`6350 `forceRemoteSettingsRefresh`

statusline.md +1 −1

Details

1178**Процент контекста показывает неожиданные значения**1178**Процент контекста показывает неожиданные значения**

1179 1179 

1180* Используйте `used_percentage` для простейшего точного состояния контекста1180* Используйте `used_percentage` для простейшего точного состояния контекста

1181* Процент контекста может отличаться от вывода `/context` из-за времени расчёта каждого1181* Строка состояния сообщает количества из последнего ответа API, в то время как `/context` добавляет оценку для сообщений, добавленных с момента этого ответа, поэтому `/context` может показывать более высокие значения до следующего ответа

1182 1182 

1183**Ссылки OSC 8 не кликабельны**1183**Ссылки OSC 8 не кликабельны**

1184 1184 

sub-agents.md +1 −1

Details

802 - matcher: "Bash"802 - matcher: "Bash"

803 hooks:803 hooks:

804 - type: command804 - type: command

805 command: "./scripts/validate-command.sh $TOOL_INPUT"805 command: "./scripts/validate-command.sh"

806 PostToolUse:806 PostToolUse:

807 - matcher: "Edit|Write"807 - matcher: "Edit|Write"

808 hooks:808 hooks:

Details

122 122 

123 <tr>123 <tr>

124 <td>Выставление счетов</td>124 <td>Выставление счетов</td>

125 <td><strong>Teams:</strong> \$150/место (Premium) с доступной оплатой по мере использования<br /><strong>Enterprise:</strong> <a href="https://claude.com/contact-sales?utm_source=claude_code&utm_medium=docs&utm_content=third_party_enterprise">Свяжитесь с отделом продаж</a></td>125 <td><strong>Teams:</strong> подписка за место с доступной оплатой по мере использования, см. <a href="https://claude.com/pricing?utm_source=claude_code&utm_medium=docs&utm_content=third_party_pricing#team-&-enterprise">цены</a><br /><strong>Enterprise:</strong> <a href="https://claude.com/contact-sales?utm_source=claude_code&utm_medium=docs&utm_content=third_party_enterprise">Свяжитесь с отделом продаж</a></td>

126 <td>Оплата по мере использования</td>126 <td>Оплата по мере использования</td>

127 <td>Оплата по мере использования через AWS</td>127 <td>Оплата по мере использования через AWS</td>

128 <td>Оплата по мере использования через AWS Marketplace</td>128 <td>Оплата по мере использования через AWS Marketplace</td>

Details

445 TLS or SSL connection errors445 TLS or SSL connection errors

446</h3>446</h3>

447 447 

448Ошибки вроде `curl: (35) TLS connect error`, `schannel: next InitializeSecurityContext failed` или PowerShell's `Could not establish trust relationship for the SSL/TLS secure channel` указывают на сбои TLS handshake.448Ошибки такие как эти означают, что TLS handshake не удался:

449 

450* `curl: (35) TLS connect error`

451* `schannel: next InitializeSecurityContext failed`

452* PowerShell's `Could not create SSL/TLS secure channel`

453* PowerShell's `Could not establish trust relationship for the SSL/TLS secure channel`

449 454 

450**Решения:**455**Решения:**

451 456 

Details

52 Файл `.heapsnapshot` содержит каждую строку в процессе, включая вашу полную беседу и учётные данные. Не прикрепляйте его к публичной проблеме и не делитесь им.52 Файл `.heapsnapshot` содержит каждую строку в процессе, включая вашу полную беседу и учётные данные. Не прикрепляйте его к публичной проблеме и не делитесь им.

53</Warning>53</Warning>

54 54 

55Команда также выводит сводку в разговор, показывая размер резидентного набора, кучу JS, буферы массивов и неучтённую нативную память, плюс любые индикаторы утечек, которые она обнаружила, такие как высокий темп роста памяти или необычно высокое количество открытых дескрипторов. Сводка указывает, находится ли большая часть памяти в куче JS, которую захватывает снимок, или в нативной памяти, которую он не захватывает.55Команда также выводит сводку в разговор, показывая общую память процесса, сколько её находится в куче JS и сколько находится вне кучи. Сводка также перечисляет любые индикаторы утечек, такие как высокий темп роста памяти или необычно высокое количество открытых дескрипторов. Сводка указывает, находится ли большая часть памяти в куче JS, которую захватывает снимок, или в нативной памяти, которую он не захватывает.

56 56 

57Сделайте одно из двух с выводом:57Сделайте одно из двух с выводом:

58 58 

workflows.md +1 −1

Details

91 Смотреть запуск91 Смотреть запуск

92</h3>92</h3>

93 93 

94Workflows работают в фоне, поэтому сессия остаётся отзывчивой, пока агенты работают. Запустите `/workflows` в любое время для списка работающих и завершённых workflows, затем выберите один для открытия его представления прогресса.94Workflows работают в фоне, поэтому сессия остаётся отзывчивой, пока агенты работают. Запустите `/workflows` в любое время для списка работающих и завершённых workflows, затем выберите один для открытия его представления прогресса. Чтобы остановить работающий workflow без его открытия, выберите его в списке и нажмите `x`.

95 95 

96Представление прогресса показывает каждую фазу с количеством агентов, общим количеством токенов и прошедшим временем. Нижний колонтитул перечисляет ключ для каждого действия:96Представление прогресса показывает каждую фазу с количеством агентов, общим количеством токенов и прошедшим временем. Нижний колонтитул перечисляет ключ для каждого действия:

97 97