SpyBara
Go Premium

Documentation 2026-11-11 22:59 UTC to 2026-11-12 22:01 UTC

6 files changed +375 −252. View all changes and history on the product overview
2026
Thu 12 23:02 Wed 11 22:59 Tue 10 21:57 Mon 9 23:02 Sun 8 22:58 Sat 7 23:58 Fri 6 23:01 Thu 5 23:03 Wed 4 23:59 Tue 3 23:58 Mon 2 23:57 Sun 1 23:57
Details

298 298 

299### Зеркальные записи выполняются по принципу best-effort299### Зеркальные записи выполняются по принципу best-effort

300 300 

301Если `append()` отклоняет вызов, SDK повторяет попытку для пакета ещё до двух раз с короткой задержкой, всего не более трёх попыток. Вызов, превысивший время ожидания, не повторяется, поскольку исходный вызов всё ещё может завершиться успешно. Если пакет по-прежнему не удаётся записать, SDK записывает ошибку в лог, выдаёт сообщение `{ type: "system", subtype: "mirror_error" }` в итератор, отбрасывает пакет и продолжает запрос. Поскольку повторно отправленный пакет может повторно доставить уже записанные записи, выполняйте дедупликацию по `entry.uuid` в вашей реализации `append()`.301Если `append()` отклоняет вызов, SDK повторяет попытку для пакета ещё до двух раз с короткой задержкой, всего не более трёх попыток. Вызов, превысивший время ожидания, не повторяется, поскольку исходный вызов всё ещё может завершиться успешно. Поскольку повторно отправленный пакет может повторно доставить уже записанные записи, выполняйте дедупликацию по `entry.uuid` в вашей реализации `append()` и сохраняйте каждую запись, у которой нет `uuid`.

302 302 

303Сбой хранилища не прерывает агента, поскольку подпроцесс сначала записывает данные локально. Отслеживайте `mirror_error`, если вам нужно обнаруживать потерю данных хранилища. При выполнении, [возобновлённом из хранилища](#resume-from-the-store), у отброшенного пакета не остаётся сохранившейся копии после завершения выполнения.303Если пакет по-прежнему не удаётся записать, SDK записывает ошибку в лог, выдаёт сообщение `{ type: "system", subtype: "mirror_error" }` в итератор, отбрасывает пакет и продолжает запрос. Сбой хранилища не прерывает агента, поскольку подпроцесс сначала записывает данные локально. Отслеживайте `mirror_error`, чтобы обнаруживать потерю данных хранилища. При выполнении, [возобновлённом из хранилища](#resume-from-the-store), у отброшенного пакета не остаётся сохранившейся копии после завершения выполнения.

304 304 

305### `getSessionMessages` возвращает цепочку после сжатия305### `getSessionMessages` возвращает цепочку после сжатия

306 306 

desktop.md +26 −5

Details

148 148 

149#### Отключите скрипты в предпросмотрах SSH и WSL для вашей организации149#### Отключите скрипты в предпросмотрах SSH и WSL для вашей организации

150 150 

151Чтобы [предпросмотры HTML в сессиях SSH и WSL](#preview-html-files-in-ssh-and-wsl-sessions) не выполняли скрипты, установите [управляемую настройку `disableBrowserExternalNavigation`](#managed-settings) в `true`. С этой настройкой пользователи также не могут [просматривать внешние сайты](#restrict-external-browsing-for-your-organization) в панели Browser.151Чтобы [предпросмотры HTML в сессиях SSH и WSL](#preview-html-files-in-ssh-and-wsl-sessions) не выполняли скрипты, установите [управляемую настройку `disableRemotePreviewScripts`](#managed-settings) в `true`. Пользователи по-прежнему могут просматривать внешние сайты. Требуется Claude Desktop v5.1231.0 или новее.

152 152 

153Задайте её в [управляемых настройках на стороне сервера](https://code.claude.com/docs/ru/server-managed-settings.md) или в [политике MDM либо файле управляемых настроек Claude Code](https://code.claude.com/docs/ru/managed-settings.md#where-each-mechanism-stores-the-policy) на компьютере, на котором работает Desktop. Desktop не читает её с удалённой машины или из дистрибутива WSL. При использовании [стороннего провайдера](https://code.claude.com/docs/ru/third-party-integrations.md) используйте политику MDM или файл.153> [!NOTE]

154>

155> Более ранние версии игнорируют `disableRemotePreviewScripts`. Чтобы остановить скрипты в них, обновите Desktop или также установите `disableBrowserExternalNavigation` в `true`. Тогда пользователи [не смогут просматривать внешние сайты](#restrict-external-browsing-for-your-organization) на любом компьютере, который получает `disableBrowserExternalNavigation`.

156 

157Задайте каждый ключ в [управляемых настройках на стороне сервера](https://code.claude.com/docs/ru/server-managed-settings.md) или в [политике MDM либо файле управляемых настроек Claude Code](https://code.claude.com/docs/ru/managed-settings.md#where-each-mechanism-stores-the-policy) на компьютере, на котором работает Desktop. Desktop не читает эти ключи с удалённой машины, из дистрибутива WSL, из [`policyHelper`](https://code.claude.com/docs/ru/settings-reference#policyhelper) или из [собственных политик Desktop](#device-management-policies). При использовании [стороннего провайдера](https://code.claude.com/docs/ru/third-party-integrations.md) используйте политику MDM или файл.

154 158 

155> [!WARNING]159> [!WARNING]

156>160>


160 164 

161Затем попросите пользователей перезапустить Desktop, чтобы убедиться, что настройка применяется, и сообщите им, чего ожидать:165Затем попросите пользователей перезапустить Desktop, чтобы убедиться, что настройка применяется, и сообщите им, чего ожидать:

162 166 

163* **Открываемые файлы**: предпросмотр не выполняет скрипты, поэтому диаграммы и таблицы, которые рисуют скрипты, остаются пустыми167* **Открываемые файлы**: предпросмотр не выполняет скрипты, поэтому диаграммы и таблицы, которые рисуют скрипты, остаются пустыми. Его уведомление начинается с `This preview doesn't run scripts`.

164* **Предпросмотры, в которых выполняются скрипты**: если Desktop применит настройку до перезапуска, они закроются. Пользователи увидят `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`168* **Предпросмотры, в которых выполняются скрипты**: если Desktop применит настройку до перезапуска, они закроются. Пользователи увидят `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`

165* **Экспортируемые файлы**: если пользователь [экспортирует файл](#preview-html-files-in-ssh-and-wsl-sessions) и откроет его в браузере, его скрипты выполнятся там независимо от этой настройки169* **Экспортируемые файлы**: если пользователь [экспортирует файл](#preview-html-files-in-ssh-and-wsl-sessions) и откроет его в браузере, его скрипты выполнятся там независимо от этой настройки

166 170 

171##### Проверьте, выполняются ли ещё скрипты на компьютере

172 

173После перезапуска откройте HTML-файл из сессии SSH или WSL на этом компьютере. Если уведомление над предпросмотром начинается с `This preview doesn't load anything from the web`, скрипты там всё ещё выполняются. Проверьте [версию Desktop](#check-your-version), куда вы поместили ключ, а также что его значение — JSON Boolean `true`.

174 

167### Просмотр внешних сайтов175### Просмотр внешних сайтов

168 176 

169Панель Browser — это браузер с вкладками, поэтому вы можете открывать документацию, трекеры задач или любой другой сайт рядом с вашим запущенным приложением. Чтобы открыть Browser, нажмите **Cmd+Shift+B** на macOS или **Ctrl+Shift+B** на Windows либо нажмите **Browser** в строке заголовка сессии. Вы можете войти на сайты в панели, включая всплывающие окна входа, такие как Google OAuth.177Панель Browser — это браузер с вкладками, поэтому вы можете открывать документацию, трекеры задач или любой другой сайт рядом с вашим запущенным приложением. Чтобы открыть Browser, нажмите **Cmd+Shift+B** на macOS или **Ctrl+Shift+B** на Windows либо нажмите **Browser** в строке заголовка сессии. Вы можете войти на сайты в панели, включая всплывающие окна входа, такие как Google OAuth.


2037| `browserExternalPageTools` | установите значение `"disabled"`, чтобы запретить Claude использовать инструменты для чтения внешних страниц и действий на них в [панели браузера](#browse-external-sites). Пользователи по-прежнему могут сами переходить на внешние сайты, а предпросмотр локального сервера разработки не затрагивается. |2045| `browserExternalPageTools` | установите значение `"disabled"`, чтобы запретить Claude использовать инструменты для чтения внешних страниц и действий на них в [панели браузера](#browse-external-sites). Пользователи по-прежнему могут сами переходить на внешние сайты, а предпросмотр локального сервера разработки не затрагивается. |

2038| `disableMobileSimulatorTools` | установите значение `true`, чтобы заблокировать инструменты Claude для управления устройствами и их захвата в [панели iOS Simulator](https://code.claude.com/docs/ru/desktop-ios-simulator.md#turn-off-simulator-access). Панель остаётся доступной для собственных касаний пользователя; убирается только доступ Claude. Значение должно быть логическим значением JSON `true`; строка `"true"` игнорируется. |2046| `disableMobileSimulatorTools` | установите значение `true`, чтобы заблокировать инструменты Claude для управления устройствами и их захвата в [панели iOS Simulator](https://code.claude.com/docs/ru/desktop-ios-simulator.md#turn-off-simulator-access). Панель остаётся доступной для собственных касаний пользователя; убирается только доступ Claude. Значение должно быть логическим значением JSON `true`; строка `"true"` игнорируется. |

2039| `disableBrowserExternalNavigation` | установите значение `true`, чтобы полностью отключить просмотр внешних сайтов в [панели браузера](#browse-external-sites). Ни пользователи, ни Claude не могут переходить на внешние сайты, а предпросмотр сервера разработки на localhost не затрагивается. HTML-предпросмотры в SSH- и WSL-сессиях [не выполняют скрипты](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). Значение должно быть логическим значением JSON `true`; строка `"true"` игнорируется. |2047| `disableBrowserExternalNavigation` | установите значение `true`, чтобы полностью отключить просмотр внешних сайтов в [панели браузера](#browse-external-sites). Ни пользователи, ни Claude не могут переходить на внешние сайты, а предпросмотр сервера разработки на localhost не затрагивается. HTML-предпросмотры в SSH- и WSL-сессиях [не выполняют скрипты](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). Значение должно быть логическим значением JSON `true`; строка `"true"` игнорируется. |

2048| `disableRemotePreviewScripts` | установите значение `true`, чтобы [отключить только скрипты в HTML-предпросмотрах](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) в SSH- и WSL-сессиях. Desktop не читает этот ключ с удалённой машины или из дистрибутива WSL. Значение должно быть логическим значением JSON `true`; строка `"true"` игнорируется. Требуется Claude Desktop v5.1231.0 или новее. |

2040| `sshConfigs` | предварительно настройте [SSH-подключения](#pre-configure-ssh-connections-for-your-team), которые отображаются в селекторе окружений. Пользователи не могут удалять управляемые подключения или изменять в них что-либо, кроме собственного поля **Worktree folder**. |2049| `sshConfigs` | предварительно настройте [SSH-подключения](#pre-configure-ssh-connections-for-your-team), которые отображаются в селекторе окружений. Пользователи не могут удалять управляемые подключения или изменять в них что-либо, кроме собственного поля **Worktree folder**. |

2041| `sshHostCommands` | предоставьте пользователям [SSH-подключения, хост которых берётся из команды](#distribute-commands-to-your-team), наряду с их собственными. Desktop читает этот ключ из файла управляемых настроек или политики MDM на компьютере и игнорирует его в [настройках, управляемых сервером](https://code.claude.com/docs/ru/server-managed-settings.md). Требуется Claude Desktop v3.6556.0 или новее на macOS или Linux либо v4.16336.0 или новее на Windows с входом через учётную запись Claude. В Windows Desktop также должен [подключаться через клиент OpenSSH](#use-your-ssh-configuration). |2050| `sshHostCommands` | предоставьте пользователям [SSH-подключения, хост которых берётся из команды](#distribute-commands-to-your-team), наряду с их собственными. Desktop читает этот ключ из файла управляемых настроек или политики MDM на компьютере и игнорирует его в [настройках, управляемых сервером](https://code.claude.com/docs/ru/server-managed-settings.md). Требуется Claude Desktop v3.6556.0 или новее на macOS или Linux либо v4.16336.0 или новее на Windows с входом через учётную запись Claude. В Windows Desktop также должен [подключаться через клиент OpenSSH](#use-your-ssh-configuration). |

2042| `sshHostAllowlist` | ограничьте [SSH-сессии](#restrict-which-ssh-hosts-users-can-connect-to) хостами, разрешённое имя которых совпадает с одним из этих шаблонов. Читается только из управляемых настроек. |2051| `sshHostAllowlist` | ограничьте [SSH-сессии](#restrict-which-ssh-hosts-users-can-connect-to) хостами, разрешённое имя которых совпадает с одним из этих шаблонов. Читается только из управляемых настроек. |


2044| `disableSshSavedPasswords` | установите значение `true`, чтобы Desktop перестал предлагать запоминать пароли SSH, а также использовать или показывать ранее сохранённые пароли. Включение этого параметра не удаляет их. Читается только из управляемых настроек. Требуется Claude Desktop v1.49585.0 или новее. |2053| `disableSshSavedPasswords` | установите значение `true`, чтобы Desktop перестал предлагать запоминать пароли SSH, а также использовать или показывать ранее сохранённые пароли. Включение этого параметра не удаляет их. Читается только из управляемых настроек. Требуется Claude Desktop v1.49585.0 или новее. |

2045| `managedMcpServers` | отправьте конфигурации MCP-серверов всем пользователям. Доступно только в сторонних (3P) развёртываниях Desktop. В каждой записи укажите транспорт `"http"`, `"sse"` или `"stdio"`, параметры подключения и, при необходимости, карту `toolPolicy`, ограничивающую, какие инструменты этого сервера пользователи могут вызывать. Доставляйте её через файл управляемых настроек, MDM или [блок `desktop`](https://code.claude.com/docs/ru/claude-apps-gateway-config#claude-desktop-overlay) политики шлюза приложений Claude, поскольку развёртывания 3P не получают настройки консоли администратора. Для доставки через шлюз на сервере шлюза нужен Claude Code v2.1.232 или новее. Это собственный ключ приложения desktop; Claude Code читает собственную [одноимённую управляемую настройку](https://code.claude.com/docs/ru/managed-mcp.md#provide-servers-through-managed-settings) с другой структурой записи. |2054| `managedMcpServers` | отправьте конфигурации MCP-серверов всем пользователям. Доступно только в сторонних (3P) развёртываниях Desktop. В каждой записи укажите транспорт `"http"`, `"sse"` или `"stdio"`, параметры подключения и, при необходимости, карту `toolPolicy`, ограничивающую, какие инструменты этого сервера пользователи могут вызывать. Доставляйте её через файл управляемых настроек, MDM или [блок `desktop`](https://code.claude.com/docs/ru/claude-apps-gateway-config#claude-desktop-overlay) политики шлюза приложений Claude, поскольку развёртывания 3P не получают настройки консоли администратора. Для доставки через шлюз на сервере шлюза нужен Claude Code v2.1.232 или новее. Это собственный ключ приложения desktop; Claude Code читает собственную [одноимённую управляемую настройку](https://code.claude.com/docs/ru/managed-mcp.md#provide-servers-through-managed-settings) с другой структурой записи. |

2046 2055 

2047Если вы отключаете функцию с помощью `browserExternalPageTools`, `disableMobileSimulatorTools` или `disableBrowserExternalNavigation` в [политике MDM или файле управляемых настроек с наивысшим приоритетом](https://code.claude.com/docs/ru/managed-settings.md#how-claude-code-combines-managed-sources) на компьютере, функция остаётся отключённой на этом компьютере. Она остаётся отключённой, даже если ваши [настройки, управляемые сервером](https://code.claude.com/docs/ru/server-managed-settings.md), не задают этот ключ или разрешают эту функцию. Не используйте для этого значение реестра `HKCU` на уровне пользователя. Чтобы снова включить функцию, удалите значение везде, где вы его задали. Требуется Claude Desktop v4.4212.0 или новее.2056Если вы отключаете функцию с помощью одного из этих четырёх ключей в [политике MDM или файле управляемых настроек с наивысшим приоритетом](https://code.claude.com/docs/ru/managed-settings.md#how-claude-code-combines-managed-sources) на компьютере, функция остаётся отключённой на этом компьютере:

2057 

2058* **`browserExternalPageTools`, `disableMobileSimulatorTools`, `disableBrowserExternalNavigation`**: требуется Claude Desktop v4.4212.0 или новее

2059* **`disableRemotePreviewScripts`**: требуется Claude Desktop v5.1231.0 или новее

2060 

2061Она остаётся отключённой, даже если ваши [настройки, управляемые сервером](https://code.claude.com/docs/ru/server-managed-settings.md), не задают этот ключ или разрешают эту функцию. Не используйте для этого значение реестра `HKCU` на уровне пользователя. Чтобы снова включить функцию, удалите значение везде, где вы его задали.

2048 2062 

2049Какие управляемые настройки доходят до сессии Desktop, зависит от того, где эта сессия выполняется. Ограничения моделей, такие как [`availableModels`](https://code.claude.com/docs/ru/model-config#restrict-model-selection), применяются в сессиях Claude Code в Desktop так же, как в CLI в терминале; см. [охват интерфейсов](https://code.claude.com/docs/ru/model-config.md#surface-coverage).2063Какие управляемые настройки доходят до сессии Desktop, зависит от того, где эта сессия выполняется. Ограничения моделей, такие как [`availableModels`](https://code.claude.com/docs/ru/model-config#restrict-model-selection), применяются в сессиях Claude Code в Desktop так же, как в CLI в терминале; см. [охват интерфейсов](https://code.claude.com/docs/ru/model-config.md#surface-coverage).

2050 2064 


2109>2123>

2110> Проверьте значение `forceLoginOrgUUID` перед развёртыванием. Если этот идентификатор не принадлежит вашей организации, люди из вашей организации не смогут использовать Claude Desktop, если только они не состоят также в организации с этим идентификатором. Чтобы исправить ситуацию, разверните правильный идентификатор и попросите их перезапустить Claude Desktop.2124> Проверьте значение `forceLoginOrgUUID` перед развёртыванием. Если этот идентификатор не принадлежит вашей организации, люди из вашей организации не смогут использовать Claude Desktop, если только они не состоят также в организации с этим идентификатором. Чтобы исправить ситуацию, разверните правильный идентификатор и попросите их перезапустить Claude Desktop.

2111 2125 

2112Если вы задаёте `forceLoginMethod` и `forceLoginOrgUUID` в [управляемых настройках](https://code.claude.com/docs/ru/managed-settings.md) Claude Code, экран входа Claude Desktop от этого не меняется.2126Если вы задаёте `forceLoginMethod` и `forceLoginOrgUUID` в [управляемых настройках](https://code.claude.com/docs/ru/managed-settings.md) Claude Code, экран входа Claude Desktop от этого не меняется. Пользователь по-прежнему может использовать Claude Desktop со своим собственным API-ключом Claude или [учётной записью Claude Console](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in) и таким образом запускать сессии вкладки Code.

2127 

2128Чтобы это предотвратить, также разверните `forceLoginOrgUUID` в политике Claude Desktop (в `HKLM` на Windows) с идентификатором вашей организации claude.ai. Если только сама политика не [выбирает Claude API](https://claude.com/docs/third-party/claude-desktop/claude-api#choose-an-authentication-approach), Claude Desktop перестаёт использовать собственный API-ключ или учётную запись Console пользователя при следующем запуске приложения.

2129 

2130Перед развёртыванием проверьте два случая:

2131 

2132* **Организации Claude Console**: не развёртывайте `forceLoginOrgUUID` отдельно с идентификатором организации Claude Console, иначе ваши пользователи потеряют доступ к Claude Desktop. Вместо этого см. [Which devices offer the Claude API account sign-in](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in).

2133* **Enterprise Admin Console**: если она доставляет конфигурацию Claude Desktop на ваши компьютеры, сначала обновите их до Claude Desktop v2.37337.0 или новее, поскольку более ранние версии игнорируют её, как только задан этот ключ. См. [Keep a device on its managed profile](https://claude.com/docs/third-party/claude-desktop/admin-console#keep-a-device-on-its-managed-profile).

2113 2134 

2114### Требования к доступу к сети2135### Требования к доступу к сети

2115 2136 

errors.md +4 −3

Details

5466This conversation is already open in another running Claude session — use that one, or close it and try again5466This conversation is already open in another running Claude session — use that one, or close it and try again

5467```5467```

5468 5468 

5469* **`running in another terminal`**: диалог удерживает терминал, например тот, в котором вы возобновили его с помощью `claude --resume` или `/resume`. В строке также показывается `Open in a terminal`.5469* **`running in another terminal`**: диалог удерживает процесс, не являющийся фоновой сессией, например запуск `claude -p` или терминал, в котором вы возобновили его с помощью `claude --resume` или `/resume`. В строке также показывается `Open in a terminal`.

5470* **`already open in another running Claude session`**: его удерживает другой неинтерактивный процесс Claude Code, например процесс [фоновой сессии](https://code.claude.com/docs/ru/agent-view.md#the-supervisor-process) для того же диалога, который ещё не завершился.5470* **`already open in another running Claude session`**: его удерживает другая [фоновая сессия](https://code.claude.com/docs/ru/agent-view.md#the-supervisor-process).

5471 5471 

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

5473 5473 

5474* Продолжите диалог в процессе, в котором он открыт, или завершите этот процесс и снова откройте строку5474* Для `running in another terminal`: продолжите работу в том терминале или завершите тот процесс либо дождитесь его завершения, затем повторите попытку

5475* Для `already open in another running Claude session`: используйте ту сессию или остановите её, затем повторите попытку

5475 5476 

5476До версии 2.1.248 существовал только отказ `already open in another running Claude session`: диалог, возобновлённый в терминале, не считался открытым, и при открытии строки запускался второй процесс Claude Code, записывающий в тот же диалог.5477До версии 2.1.248 существовал только отказ `already open in another running Claude session`: диалог, возобновлённый в терминале, не считался открытым, и при открытии строки запускался второй процесс Claude Code, записывающий в тот же диалог.

5477 5478 

Details

218 218 

219## Моды, встроенные в Claude Code219## Моды, встроенные в Claude Code

220 220 

221Некоторые собственные функции Claude Code — это моды. Чтобы увидеть те, которые есть в вашей сессии, запустите `/plugin` в промпте Claude Code и перейдите на вкладку **Installed**, где они перечислены в разделе **Built-in**. Вы не можете обновлять или удалять встроенный мод, а в последнем столбце таблицы указано, как отключить каждый из них. Строка [`mods active`](#see-which-mods-a-session-loaded) не включает встроенные моды.221Некоторые собственные функции Claude Code — это моды. Чтобы увидеть те, которые есть в вашей сессии, запустите `/plugin` в промпте Claude Code и перейдите на вкладку **Installed**, где они перечислены в разделе **Built-in**. Вы не можете обновлять или удалять встроенный мод. Строка [`mods active`](#see-which-mods-a-session-loaded) не включает встроенные моды.

222 222 

223В этой таблице каждая запись указана по имени, которое показывает `/plugin`:223В этой таблице перечислены некоторые записи **Built-in** по имени, которое показывает `/plugin`:

224 224 

225| Имя в `/plugin` | Что он делает | Где он включен | Как его отключить |225| Имя в `/plugin` | Что он делает | Где он включен | Как его отключить |

226| :- | :- | :- | :- |226| :- | :- | :- | :- |


231| `cc-plugin-telemetry` | Отправляет записи аналитики, которые записывают в лог Claude Code и его встроенные моды | Везде, где включена собственная аналитика Claude Code | Отключите его в `/plugin` или отключите аналитику, например с помощью [`DISABLE_TELEMETRY`](https://code.claude.com/docs/ru/env-vars) |231| `cc-plugin-telemetry` | Отправляет записи аналитики, которые записывают в лог Claude Code и его встроенные моды | Везде, где включена собственная аналитика Claude Code | Отключите его в `/plugin` или отключите аналитику, например с помощью [`DISABLE_TELEMETRY`](https://code.claude.com/docs/ru/env-vars) |

232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/ru/interactive-mode.md#you-should-know-suggestions): вспомогательный агент показывает заметку над промптом, когда находит что-то, что вы могли упустить | Отключено, пока вы [не включите его](https://code.claude.com/docs/ru/interactive-mode.md#you-should-know-suggestions) | Отключите его в `/plugin` |232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/ru/interactive-mode.md#you-should-know-suggestions): вспомогательный агент показывает заметку над промптом, когда находит что-то, что вы могли упустить | Отключено, пока вы [не включите его](https://code.claude.com/docs/ru/interactive-mode.md#you-should-know-suggestions) | Отключите его в `/plugin` |

233 233 

234Для плагина **Built-in**, которого нет в таблице, [откройте его сведения в `/plugin`](https://code.claude.com/docs/ru/plugins/install#manage-installed-plugins), чтобы прочитать, что он делает, или отключить его.

235 

234Настройки и флаги, которые останавливают установленные моды, такие как `disableAllHooks`, `--bare` и `--safe-mode`, не останавливают встроенные моды.236Настройки и флаги, которые останавливают установленные моды, такие как `disableAllHooks`, `--bare` и `--safe-mode`, не останавливают встроенные моды.

235 237 

236### Прочитайте исходный код встроенных модов238### Прочитайте исходный код встроенных модов

Details

194| `session.receive` | `($, e) => ({ text: e.text })`. Вызывайте его с помощью `$.session.receive({ origin: { kind: 'peer-send-message' }, text })`. |194| `session.receive` | `($, e) => ({ text: e.text })`. Вызывайте его с помощью `$.session.receive({ origin: { kind: 'peer-send-message' }, text })`. |

195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |

196 196 

197`expect` имеет утверждения `toBe`, `toEqual`, `toMatch`, `toMatchObject`, `toContain`, `toBeDefined`, `toBeUndefined` и `toThrow`, и `.not` перед любым из них.197### Проверьте результат с помощью `expect`

198 

199В наборе есть следующие утверждения, и выбранное вами ставится после проверяемого значения, как в `expect(answer.text).toBe('ok')`:

200 

201* **Равенство**: `toBe` для того же значения или объекта, `toEqual` для структуры, `toStrictEqual` для структуры вместе с полями `undefined` и прототипом, и `toMatchObject` для указанных вами полей

202* **Текст**: `toMatch`, который принимает регулярное выражение или подстроку, `toStartWith` и `toEndWith`

203* **Числа**: `toBeGreaterThan`, `toBeGreaterThanOrEqual`, `toBeLessThan`, `toBeLessThanOrEqual`

204* **Содержимое**: `toContain` для подстроки или элемента, `toContainEqual` для элемента, сравниваемого по структуре, `toHaveLength` и `toHaveProperty`

205* **Наличие и тип**: `toBeDefined`, `toBeUndefined`, `toBeNull`, `toBeTruthy`, `toBeFalsy`, `toBeNaN`, `toBeInstanceOf`

206* **Выброс исключений**: `toThrow` — для функции, которую вызывает `expect`, или для промиса, который вы проверяете с помощью `.rejects`

207 

208Поставьте `.not` перед утверждением, чтобы проверить обратное, а `.resolves` или `.rejects` — чтобы проверить, с чем завершается промис.

198 209 

199Когда `expect` не выполняется внутри stub или хука, который вы передали в `on` как обычную функцию, а не как асинхронный генератор, тест не проходит. Движок пропускает этот хук, а вывод ошибки называет его, например `in the test's store.set hook`.210Когда `expect` не выполняется внутри stub или хука, который вы передали в `on` как обычную функцию, а не как асинхронный генератор, тест не проходит. Движок пропускает этот хук, а вывод ошибки называет его, например `in the test's store.set hook`.

200 211 

settings-reference.md +327 −239

Details

86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | Отклоняйте определённые серверы из [`.mcp.json`](https://code.claude.com/docs/ru/mcp#project-scope) проекта | MCP | Any file |86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | Отклоняйте определённые серверы из [`.mcp.json`](https://code.claude.com/docs/ru/mcp#project-scope) проекта | MCP | Any file |

87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | Блокируйте инструменты Claude в [настольной](https://code.claude.com/docs/ru/desktop.md) панели iOS Simulator | Tools | Managed |87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | Блокируйте инструменты Claude в [настольной](https://code.claude.com/docs/ru/desktop.md) панели iOS Simulator | Tools | Managed |

88| [`disableRemoteControl`](#disableremotecontrol) | Отключите [Remote Control](https://code.claude.com/docs/ru/remote-control.md) везде, где он может запуститься | Remote, desktop, and notifications | Any file |88| [`disableRemoteControl`](#disableremotecontrol) | Отключите [Remote Control](https://code.claude.com/docs/ru/remote-control.md) везде, где он может запуститься | Remote, desktop, and notifications | Any file |

89| [`disableRemotePreviewScripts`](#disableremotepreviewscripts) | Отключите скрипты в HTML-предпросмотрах [настольного](https://code.claude.com/docs/ru/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) приложения в сессиях SSH и WSL | Remote, desktop, and notifications | Managed |

89| [`disableSideloadFlags`](#disablesideloadflags) | Отклоняйте флаги CLI, которые загружают [плагины](https://code.claude.com/docs/ru/plugins/overview.md), [субагенты](https://code.claude.com/docs/ru/sub-agents.md) и [MCP-серверы](https://code.claude.com/docs/ru/mcp.md) в обход установки | Enterprise and managed settings | Managed |90| [`disableSideloadFlags`](#disablesideloadflags) | Отклоняйте флаги CLI, которые загружают [плагины](https://code.claude.com/docs/ru/plugins/overview.md), [субагенты](https://code.claude.com/docs/ru/sub-agents.md) и [MCP-серверы](https://code.claude.com/docs/ru/mcp.md) в обход установки | Enterprise and managed settings | Managed |

90| [`disableSkillShellExecution`](#disableskillshellexecution) | Запретите [скиллам](https://code.claude.com/docs/ru/skills.md) и пользовательским командам встроенное выполнение shell-команд | Plugins and skills | Any file |91| [`disableSkillShellExecution`](#disableskillshellexecution) | Запретите [скиллам](https://code.claude.com/docs/ru/skills.md) и пользовательским командам встроенное выполнение shell-команд | Plugins and skills | Any file |

91| [`disableWorkflows`](#disableworkflows) | Отключите [динамические рабочие процессы](https://code.claude.com/docs/ru/workflows.md) для всех; используйте `enableWorkflows` для себя | Hooks and automation | Any file |92| [`disableWorkflows`](#disableworkflows) | Отключите [динамические рабочие процессы](https://code.claude.com/docs/ru/workflows.md) для всех; используйте `enableWorkflows` для себя | Hooks and automation | Any file |


147| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | Заставьте инструменты `Write`, `Edit` и `NotebookEdit` отказываться от путей вне [рабочих каталогов](https://code.claude.com/docs/ru/permissions.md#working-directories) в каждом режиме разрешений, за исключением [некоторых собственных файлов Claude Code](#what-the-write-block-refuses-and-what-stays-writable) | Permission settings | Any file |148| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | Заставьте инструменты `Write`, `Edit` и `NotebookEdit` отказываться от путей вне [рабочих каталогов](https://code.claude.com/docs/ru/permissions.md#working-directories) в каждом режиме разрешений, за исключением [некоторых собственных файлов Claude Code](#what-the-write-block-refuses-and-what-stays-writable) | Permission settings | Any file |

148| [`permissions.defaultMode`](#permissions-defaultmode) | Устанавливает [режим разрешений](https://code.claude.com/docs/ru/permission-modes.md#which-mode-a-session-starts-in) по умолчанию для новых сессий | Permission settings | Any file |149| [`permissions.defaultMode`](#permissions-defaultmode) | Устанавливает [режим разрешений](https://code.claude.com/docs/ru/permission-modes.md#which-mode-a-session-starts-in) по умолчанию для новых сессий | Permission settings | Any file |

149| [`permissions.deny`](#permissions-deny) | Блокируйте перечисленные [использования инструментов](https://code.claude.com/docs/ru/permissions.md#permission-rule-syntax), включая чтение файлов, содержащих секреты | Permission settings | Any file |150| [`permissions.deny`](#permissions-deny) | Блокируйте перечисленные [использования инструментов](https://code.claude.com/docs/ru/permissions.md#permission-rule-syntax), включая чтение файлов, содержащих секреты | Permission settings | Any file |

151| [`permissions.denyInsteadOfPrompting`](#permissions-denyinsteadofprompting) | Отклоняйте вызовы инструментов, которые ожидали бы [запроса разрешения](https://code.claude.com/docs/ru/permissions.md#permission-system), чтобы сессия, за которой никто не следит, продолжала работать | Permission settings | User or managed |

150| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Запретите кому-либо входить в [режим bypassPermissions](https://code.claude.com/docs/ru/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | Permission settings | Any file |152| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Запретите кому-либо входить в [режим bypassPermissions](https://code.claude.com/docs/ru/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | Permission settings | Any file |

151| [`plansDirectory`](#plansdirectory) | Выберите, где [режим планирования](https://code.claude.com/docs/ru/permission-modes.md#analyze-before-you-edit-with-plan-mode) записывает файлы плана | Memory and context | Any file |153| [`plansDirectory`](#plansdirectory) | Выберите, где [режим планирования](https://code.claude.com/docs/ru/permission-modes.md#analyze-before-you-edit-with-plan-mode) записывает файлы плана | Memory and context | Any file |

152| [`pluginConfigs`](#pluginconfigs) | Сохраняйте ответы, которые вы дали в диалоговом окне конфигурации [плагина](https://code.claude.com/docs/ru/plugins/overview.md) | Plugins and skills | User or managed |154| [`pluginConfigs`](#pluginconfigs) | Сохраняйте ответы, которые вы дали в диалоговом окне конфигурации [плагина](https://code.claude.com/docs/ru/plugins/overview.md) | Plugins and skills | User or managed |


228| [`statusLine`](#statusline) | Запустите свою собственную команду для отображения [строки состояния](https://code.claude.com/docs/ru/statusline.md) под промптом | Interface and terminal | Any file |230| [`statusLine`](#statusline) | Запустите свою собственную команду для отображения [строки состояния](https://code.claude.com/docs/ru/statusline.md) под промптом | Interface and terminal | Any file |

229| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Создайте список разрешённых источников [маркетплейсов](https://code.claude.com/docs/ru/plugins/overview.md), которые пользователи могут добавлять и из которых могут устанавливать | Plugins and skills | Managed |231| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Создайте список разрешённых источников [маркетплейсов](https://code.claude.com/docs/ru/plugins/overview.md), которые пользователи могут добавлять и из которых могут устанавливать | Plugins and skills | Managed |

230| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Блокируйте [скиллы](https://code.claude.com/docs/ru/skills.md), [агенты](https://code.claude.com/docs/ru/sub-agents.md), [хуки](https://code.claude.com/docs/ru/hooks.md) и [MCP-серверы](https://code.claude.com/docs/ru/mcp.md) из пользовательских и проектных источников | Plugins and skills | Managed |232| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Блокируйте [скиллы](https://code.claude.com/docs/ru/skills.md), [агенты](https://code.claude.com/docs/ru/sub-agents.md), [хуки](https://code.claude.com/docs/ru/hooks.md) и [MCP-серверы](https://code.claude.com/docs/ru/mcp.md) из пользовательских и проектных источников | Plugins and skills | Managed |

231| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | Ограничьте [агенты](https://code.claude.com/docs/ru/sub-agents.md) источниками из плагинов и управляемыми источниками | Plugins and skills | Managed |233| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | Блокируйте [агенты](https://code.claude.com/docs/ru/sub-agents.md) из пользовательских и проектных источников | Plugins and skills | Managed |

232| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | Ограничьте [хуки](https://code.claude.com/docs/ru/hooks.md) источниками из плагинов и управляемыми источниками | Plugins and skills | Managed |234| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | Блокируйте [хуки](https://code.claude.com/docs/ru/hooks.md) из пользовательских и проектных источников | Plugins and skills | Managed |

233| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | Ограничьте [MCP-серверы](https://code.claude.com/docs/ru/mcp.md) источниками из плагинов и управляемыми источниками | Plugins and skills | Managed |235| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | Блокируйте [MCP-серверы](https://code.claude.com/docs/ru/mcp.md) из пользовательских и проектных источников | Plugins and skills | Managed |

234| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | Ограничьте [скиллы](https://code.claude.com/docs/ru/skills.md) источниками из плагинов и управляемыми источниками | Plugins and skills | Managed |236| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | Блокируйте [скиллы](https://code.claude.com/docs/ru/skills.md) из пользовательских и проектных источников | Plugins and skills | Managed |

235| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Выберите [время жизни кэша промптов](https://code.claude.com/docs/ru/prompt-caching.md#cache-lifetime) для субагентов и других запросов вне основного диалога | Model and responses | Any file |237| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Выберите [время жизни кэша промптов](https://code.claude.com/docs/ru/prompt-caching.md#cache-lifetime) для субагентов и других запросов вне основного диалога | Model and responses | Any file |

236| [`subagentStatusLine`](#subagentstatusline) | Переписывайте строки в отображении задач [субагента](https://code.claude.com/docs/ru/sub-agents.md) с помощью вашей собственной команды | Interface and terminal | Any file |238| [`subagentStatusLine`](#subagentstatusline) | Переписывайте строки в отображении задач [субагента](https://code.claude.com/docs/ru/sub-agents.md) с помощью вашей собственной команды | Interface and terminal | Any file |

237| [`switchModelsOnFlag`](#switchmodelsonflag) | Переключайте модели автоматически или приостанавливайте работу, когда [классификатор безопасности](https://code.claude.com/docs/ru/model-config.md#ask-before-switching) помечает запрос | Model and responses | Any file |239| [`switchModelsOnFlag`](#switchmodelsonflag) | Переключайте модели автоматически или приостанавливайте работу, когда [классификатор безопасности](https://code.claude.com/docs/ru/model-config.md#ask-before-switching) помечает запрос | Model and responses | Any file |


288}290}

289```291```

290 292 

291Ключ не действует у провайдеров, где advisor [недоступен](https://code.claude.com/docs/ru/advisor.md#requirements), например Amazon Bedrock и Claude Platform on AWS. Для `"fable"` требуется [доступ к Fable](https://code.claude.com/docs/ru/advisor.md#choose-an-advisor-model).293Ключ не действует у провайдеров, где advisor [недоступен](https://code.claude.com/docs/ru/advisor.md#requirements), например Amazon Bedrock. На Claude Platform on AWS для ключа требуется Claude Code v2.1.300 или новее. Для `"fable"` требуется [доступ к Fable](https://code.claude.com/docs/ru/advisor.md#choose-an-advisor-model).

292 294 

293### `alwaysThinkingEnabled`295### `alwaysThinkingEnabled`

294 296 


448 450 

449Включите [быстрый режим](https://code.claude.com/docs/ru/fast-mode.md) для сессий, где он доступен, — для интерактивной работы, например быстрой итерации или отладки в реальном времени, когда вам нужна скорость при более высокой стоимости за токен. Обычно этот ключ не редактируют вручную. Выполнение `/fast` записывает `fastMode: true` в `~/.claude/settings.json`, а повторное выполнение для отключения быстрого режима удаляет ключ.451Включите [быстрый режим](https://code.claude.com/docs/ru/fast-mode.md) для сессий, где он доступен, — для интерактивной работы, например быстрой итерации или отладки в реальном времени, когда вам нужна скорость при более высокой стоимости за токен. Обычно этот ключ не редактируют вручную. Выполнение `/fast` записывает `fastMode: true` в `~/.claude/settings.json`, а повторное выполнение для отключения быстрого режима удаляет ключ.

450 452 

451Быстрый режим поддерживают только Fable 5.2, Opus 5.5, Opus 5 и Opus 4.8. Выполнение `/fast` на другой модели переключает вас на Opus, а переключение на неподдерживаемую модель отключает быстрый режим. См. [Переключение моделей при включённом быстром режиме](https://code.claude.com/docs/ru/fast-mode.md#switch-models-while-fast-mode-is-on).453В Anthropic API быстрый режим поддерживают только Fable 5.2, Opus 5.5, Opus 5 и Opus 4.8. Выполнение `/fast` на другой модели переключает вас на Opus, а переключение на неподдерживаемую модель отключает быстрый режим. См. [Переключение моделей при включённом быстром режиме](https://code.claude.com/docs/ru/fast-mode.md#switch-models-while-fast-mode-is-on). В Google Cloud's Agent Platform [`/fast` вместо этого переключает вас на Fable 5.2](https://code.claude.com/docs/ru/fast-mode#use-fast-mode-on-agent-platform) и не записывает этот ключ, а Claude Code игнорирует сохранённое значение `true`.

452 454 

453* **Область действия**: [`Any file`](#scopes)455* **Область действия**: [`Any file`](#scopes)

454* **Тип**: Boolean456* **Тип**: Boolean


904Управляйте тем, какие инструменты Claude может использовать без запроса, какие вызывают запрос подтверждения, а какие заблокированы. Также задайте [режим разрешений](https://code.claude.com/docs/ru/permission-modes.md) по умолчанию для новых сессий. Все ключи `permissions.*` ниже вложены в этот объект.906Управляйте тем, какие инструменты Claude может использовать без запроса, какие вызывают запрос подтверждения, а какие заблокированы. Также задайте [режим разрешений](https://code.claude.com/docs/ru/permission-modes.md) по умолчанию для новых сессий. Все ключи `permissions.*` ниже вложены в этот объект.

905 907 

906* **Область действия**: [`Any file`](#scopes)908* **Область действия**: [`Any file`](#scopes)

907* **Тип**: объект с `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `disableBypassPermissionsMode` и `disableAutoMode`909* **Тип**: объект с `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `denyInsteadOfPrompting`, `disableBypassPermissionsMode` и `disableAutoMode`

908* **По умолчанию**: не установлено910* **По умолчанию**: не установлено

909 911 

910Этот пример разрешает команды `npm run` без запроса, запрашивает подтверждение перед `git push`, блокирует чтение `.env` и запускает сессии в `acceptEdits`:912Этот пример разрешает команды `npm run` без запроса, запрашивает подтверждение перед `git push`, блокирует чтение `.env` и запускает сессии в `acceptEdits`:


1163 1165 

1164Правила разрешений действуют поверх любого режима: правила `deny` блокируют в каждом режиме, включая `bypassPermissions`. См. [Режимы разрешений](https://code.claude.com/docs/ru/permission-modes.md). В облачных сессиях Claude Code учитывает из этого ключа только `acceptEdits`, `plan`, `default` и `auto`. О диалогах, которые запускает расширение VS Code, см. [какую настройку расширение читает для начального режима разрешений](https://code.claude.com/docs/ru/permission-modes.md#switch-permission-modes).1166Правила разрешений действуют поверх любого режима: правила `deny` блокируют в каждом режиме, включая `bypassPermissions`. См. [Режимы разрешений](https://code.claude.com/docs/ru/permission-modes.md). В облачных сессиях Claude Code учитывает из этого ключа только `acceptEdits`, `plan`, `default` и `auto`. О диалогах, которые запускает расширение VS Code, см. [какую настройку расширение читает для начального режима разрешений](https://code.claude.com/docs/ru/permission-modes.md#switch-permission-modes).

1165 1167 

1168### `permissions.denyInsteadOfPrompting`

1169 

1170Установите значение `true`, чтобы сессия продолжала работать, когда некому ответить на запрос разрешения. Claude Code отклоняет вызов инструмента, который иначе ожидал бы ответа на запрос, и ход продолжается. Требуется Claude Code v2.1.319 или новее.

1171 

1172Вызов выполняется, если его одобряет разрешающее правило, ваш [режим разрешений](https://code.claude.com/docs/ru/permission-modes.md) или классификатор авторежима. Чтобы разрешить большинство вызовов, которые иначе потребовали бы запроса, отвечайте из [хука `PermissionRequest`](https://code.claude.com/docs/ru/hooks#permissionrequest).

1173 

1174* **Область действия**: [`User or managed`](#scopes), а также `--settings`. Репозиторий не может установить его за вас.

1175* **Тип**: Boolean

1176 * `true`: Claude Code отклоняет вызовы, которые иначе потребовали бы запроса

1177 * `false`: то же, что и отсутствие значения; вызовы всё равно отклоняются, если другой из этих источников устанавливает `true`

1178* **По умолчанию**: не установлено, поэтому вызов, требующий подтверждения, вызывает запрос к вам

1179 

1180Этот пример в `~/.claude/settings.json` запускает сессии в авторежиме и отклоняет всё, что всё равно привело бы к запросу:

1181 

1182```json settings.json theme={null}

1183{

1184 "permissions": {

1185 "defaultMode": "auto",

1186 "denyInsteadOfPrompting": true

1187 }

1188}

1189```

1190 

1191Ключ действует в запусках с `-p`, интерактивных сессиях в терминале, [расширении VS Code](https://code.claude.com/docs/ru/vs-code.md), локальных сессиях в [приложении Desktop](https://code.claude.com/docs/ru/desktop.md), [субагентах](https://code.claude.com/docs/ru/sub-agents.md) и [командах агентов](https://code.claude.com/docs/ru/agent-teams.md). Чтобы вместо этого отклонять то, что вызвало бы запрос, только в одном [неинтерактивном](https://code.claude.com/docs/ru/headless.md) запуске, передайте [`--permission-prompts none`](https://code.claude.com/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs) вместе с `-p`.

1192 

1193#### Что ещё останавливает `denyInsteadOfPrompting`

1194 

1195Когда настройка включена, Claude Code также прекращает следующие запросы ответа:

1196 

1197* **Инструменты вопросов и планов**: Claude Code исключает [`AskUserQuestion`](https://code.claude.com/docs/ru/tools-reference#askuserquestion-tool-behavior), `EnterPlanMode` и `ExitPlanMode`, поэтому сессия в режиме планирования не может выйти из него самостоятельно. Участник команды агентов сохраняет `EnterPlanMode` и `ExitPlanMode`

1198* **MCP elicitation**: Claude Code отменяет [запрос elicitation](https://code.claude.com/docs/ru/mcp.md#respond-to-mcp-elicitation-requests), если только на него не отвечает [хук `Elicitation`](https://code.claude.com/docs/ru/hooks#elicitation)

1199* **Хосты разрешений**: Claude Code не обращается к вашему [callback `canUseTool`](https://code.claude.com/docs/ru/agent-sdk/user-input) или [`--permission-prompt-tool`](https://code.claude.com/docs/ru/cli-reference#cli-flags). Чтобы одобрять вызовы из кода, отвечайте из хука `PermissionRequest`. Некоторые вызовы отклоняются ещё до обращения к какому-либо хуку, например [удаление критического пути](https://code.claude.com/docs/ru/permission-modes.md#critical-path-removals-in-each-permission-mode) в режиме `auto`, на которое не распространяется ни одно правило `ask`.

1200* **Уведомление о биллинге классификатора**: там, где [уведомление о тарифицируемых запросах классификатора](https://code.claude.com/docs/ru/auto-mode-classifier-billing.md) открыло бы диалоговое окно, Claude Code не показывает его и отклоняет действия, которым нужны эти запросы

1201 

1202Сессия по-прежнему может ожидать ответа в [диалоговом окне доверия рабочему пространству](https://code.claude.com/docs/ru/permissions.md#project-allow-rules-and-workspace-trust) и [подтверждения MCP-серверов проекта](https://code.claude.com/docs/ru/mcp.md#project-server-approvals-and-workspace-trust). Ответьте на оба, прежде чем оставлять сессию работать.

1203 

1204#### Сообщения от `denyInsteadOfPrompting`

1205 

1206Эти сообщения информируют об отклонённых вызовах. Это не запросы, поэтому ничто не ожидает вашего ответа.

1207 

1208Отказ, который читает Claude, может начинаться с этого текста:

1209 

1210```text theme={null}

1211Permission for this tool use was denied. It requires approval, and this session has no approval surface

1212```

1213 

1214В выводе `stream-json` [запуски, которые выдают сообщение `permission_denied`](https://code.claude.com/docs/ru/agent-sdk/typescript#sdkpermissiondeniedmessage), сообщают такое значение `decision_reason`:

1215 

1216```text theme={null}

1217no approval surface in this session; permission request denied automatically

1218```

1219 

1220В авторежиме при включённой настройке ход завершается после 20 вызовов подряд, которые заблокировал классификатор или отклонила [проверка безопасности](https://code.claude.com/docs/ru/errors.md#auto-mode-cannot-determine-the-safety-of-an-action), и вы видите это сообщение:

1221 

1222```text theme={null}

122320 actions were refused and no work went ahead in between, so Claude stopped.

1224```

1225 

1226Запуск с `-p` сообщает об этом ходе как об `error_during_execution`.

1227 

1166### `permissions.disableBypassPermissionsMode`1228### `permissions.disableBypassPermissionsMode`

1167 1229 

1168Запретите кому-либо входить в режим `bypassPermissions`. Claude Code тогда отклоняет флаг `--dangerously-skip-permissions` и игнорирует `permissionMode: bypassPermissions` в [определении агента](https://code.claude.com/docs/ru/sub-agents.md#permission-modes), поэтому субагент работает в режиме разрешений родительской сессии.1230Запретите кому-либо входить в режим `bypassPermissions`. Claude Code тогда отклоняет флаг `--dangerously-skip-permissions` и игнорирует `permissionMode: bypassPermissions` в [определении агента](https://code.claude.com/docs/ru/sub-agents.md#permission-modes), поэтому субагент работает в режиме разрешений родительской сессии.


1202 1264 

1203Пропустите диалоговое окно подтверждения, которое Claude Code показывает перед входом сессии в режим `bypassPermissions`, будь то из-за `--dangerously-skip-permissions` или `defaultMode: "bypassPermissions"`. Claude Code записывает сюда `true` в ваших пользовательских настройках, когда вы один раз подтверждаете это диалоговое окно.1265Пропустите диалоговое окно подтверждения, которое Claude Code показывает перед входом сессии в режим `bypassPermissions`, будь то из-за `--dangerously-skip-permissions` или `defaultMode: "bypassPermissions"`. Claude Code записывает сюда `true` в ваших пользовательских настройках, когда вы один раз подтверждаете это диалоговое окно.

1204 1266 

1205* **Область действия**: [`User, local, or managed`](#scopes). Недоверенный репозиторий не может пропустить диалоговое окно за вас.1267* **Область действия**: [`User, local, or managed`](#scopes), а также файлы, переданные с помощью `--settings`. [Фоновые сессии](https://code.claude.com/docs/ru/permission-modes.md#bypass-permissions-ignored-in-a-background-session) учитывают только пользовательские и управляемые настройки. Недоверенный репозиторий не может пропустить диалоговое окно за вас.

1206* **Тип**: Boolean1268* **Тип**: Boolean

1207 * `true`: Claude Code пропускает диалоговое окно подтверждения перед входом сессии в режим `bypassPermissions`1269 * `true`: Claude Code пропускает диалоговое окно подтверждения перед входом сессии в режим `bypassPermissions`

1208 * `false`: то же, что и отсутствие значения; диалоговое окно появляется, если только другой из этих файлов не устанавливает `true`1270 * `false`: то же, что и отсутствие значения; диалоговое окно появляется, если только другой из этих файлов не устанавливает `true`


3132 3194 

3133### `syntaxHighlightingDisabled`3195### `syntaxHighlightingDisabled`

3134 3196 

3135Claude Code раскрашивает код в соответствии с языком в diff, блоках кода и предпросмотрах файлов, которые он показывает в терминале, с помощью встроенного средства подсветки; плагины и языковые серверы при этом не используются. Установите этот ключ в `true`, чтобы показывать их как простой текст, например если цвета конфликтуют с темой вашего терминала или замедляют программу экранного доступа.3197Claude Code раскрашивает код в соответствии с языком в diff, блоках кода и предпросмотрах файлов, которые он показывает в терминале, с помощью встроенного средства подсветки. Установите этот ключ в `true`, чтобы показывать их как простой текст, например если цвета конфликтуют с темой вашего терминала или замедляют программу экранного доступа.

3136 3198 

3137* **Область действия**: [`Any file`](#scopes)3199* **Область действия**: [`Any file`](#scopes)

3138* **Тип**: Boolean3200* **Тип**: Boolean


3751}3813}

3752```3814```

3753 3815 

3754## Plugins and skills3816## Плагины и скиллы

3755 3817 

3756Включайте плагины, регистрируйте маркетплейсы, ограничивайте источники плагинов, которые разрешены в вашей организации, и контролируйте, какие skills загружаются. Для установки и создания плагинов см. [Plugins](https://code.claude.com/docs/ru/plugins/overview.md).3818Включайте плагины, регистрируйте маркетплейсы, ограничивайте источники плагинов, разрешённые в организации, и управляйте тем, какие скиллы загружаются. Об установке и создании плагинов см. [Плагины](https://code.claude.com/docs/ru/plugins/overview.md).

3757 3819 

3758### `disableBundledSkills`3820### `disableBundledSkills`

3759 3821 

3760Отключите [skills](https://code.claude.com/docs/ru/skills.md) и рабочие процессы, включённые в Claude Code. Claude Code полностью удаляет встроенные skills и рабочие процессы, в то время как встроенные команды, такие как `/init`, остаются доступными для ввода, но скрыты от модели.3822Отключает [скиллы](https://code.claude.com/docs/ru/skills.md) и рабочие процессы, входящие в состав Claude Code. Claude Code полностью удаляет встроенные скиллы и рабочие процессы, а встроенные команды, такие как `/init`, по-прежнему можно ввести, но они скрыты от модели.

3761 3823 

3762* **Scope**: [`Any file`](#scopes)3824* **Область действия**: [`Any file`](#scopes)

3763* **Type**: Boolean3825* **Тип**: Boolean

3764 * `true`: Claude Code удаляет встроенные skills и рабочие процессы и скрывает встроенные команды, такие как `/init`, от модели3826 * `true`: Claude Code удаляет встроенные скиллы и рабочие процессы и скрывает от модели встроенные команды, такие как `/init`

3765 * `false`: встроенные skills загружаются3827 * `false`: встроенные скиллы загружаются

3766* **Default**: не установлено, поэтому встроенные skills загружаются3828* **По умолчанию**: не задано, поэтому встроенные скиллы загружаются

3767* **Per-session overrides**: [`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`](https://code.claude.com/docs/ru/env-vars) установлено на `1` отключает встроенные skills на одну сессию; какой бы из двух способов их ни отключил, другой не сможет их включить обратно3829* **Переопределения для отдельной сессии**: [`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`](https://code.claude.com/docs/ru/env-vars) со значением `1` отключает встроенные скиллы для одной сессии; какой бы из двух способов их ни отключил, другой не может включить их обратно

3768 3830 

3769```json settings.json theme={null}3831```json settings.json theme={null}

3770{3832{


3772}3834}

3773```3835```

3774 3836 

3775Skills из плагинов, `.claude/skills/` и `.claude/commands/` не затрагиваются. `/doctor` остаётся доступным для ввода, как встроенные команды; чтобы скрыть его, установите [`DISABLE_DOCTOR_COMMAND`](https://code.claude.com/docs/ru/env-vars) вместо этого.3837Скиллы из плагинов, `.claude/skills/` и `.claude/commands/` не затрагиваются. `/doctor` по-прежнему можно ввести, как и встроенные команды; чтобы скрыть её, задайте вместо этого [`DISABLE_DOCTOR_COMMAND`](https://code.claude.com/docs/ru/env-vars).

3776 3838 

3777### `disableSkillShellExecution`3839### `disableSkillShellExecution`

3778 3840 

3779Отключите встроенное выполнение shell для `` !`...` `` и ` ```! ` блоков в [skills](https://code.claude.com/docs/ru/skills.md) и пользовательских команд из источников пользователя, проекта, плагина или дополнительного каталога. Claude Code заменяет каждую команду на `[shell command execution disabled by policy]` вместо её выполнения.3841Отключает встроенное выполнение команд оболочки для блоков `` !`...` `` и ` ```! ` в [скиллах](https://code.claude.com/docs/ru/skills.md) и пользовательских командах из источников пользователя, проекта, плагина или дополнительного каталога. Claude Code заменяет каждую команду на `[shell command execution disabled by policy]` вместо её выполнения.

3780 3842 

3781* **Scope**: [`Any file`](#scopes). `true` в управляемых параметрах не может быть переопределён на `false` в другом месте.3843* **Область действия**: [`Any file`](#scopes). Значение `true` в управляемых настройках нельзя переопределить значением `false` в другом месте.

3782* **Type**: Boolean3844* **Тип**: Boolean

3783 * `true`: Claude Code заменяет каждую встроенную shell команду на `[shell command execution disabled by policy]` вместо её выполнения3845 * `true`: Claude Code заменяет каждую встроенную shell-команду на `[shell command execution disabled by policy]` вместо её выполнения

3784 * `false`: встроенный shell выполняется3846 * `false`: встроенные shell-команды выполняются

3785* **Default**: не установлено, поэтому встроенный shell выполняется3847* **По умолчанию**: не задано, поэтому встроенные shell-команды выполняются

3786 3848 

3787```json settings.json theme={null}3849```json settings.json theme={null}

3788{3850{


3790}3852}

3791```3853```

3792 3854 

3793Встроенные skills и skills, развёрнутые через управляемые параметры, не затрагиваются.3855Встроенные скиллы и скиллы, развёрнутые через управляемые настройки, не затрагиваются.

3794 3856 

3795### `skillOverrides`3857### `skillOverrides`

3796 3858 

3797Скройте или свёрните [skill](https://code.claude.com/docs/ru/skills.md#override-skill-visibility-from-settings) без редактирования его `SKILL.md`. Claude Code применяет значение под именем каждого skill к списку skills, который видит Claude, и к вашему автодополнению `/`.3859Скрывает или сворачивает [скилл](https://code.claude.com/docs/ru/skills.md#override-skill-visibility-from-settings) без редактирования его `SKILL.md`. Claude Code применяет значение, указанное под именем каждого скилла, к списку скиллов, который видит Claude, и к вашему автодополнению `/`.

3798 3860 

3799* **Scope**: [`Any file`](#scopes). Меню `/skills` записывает в `.claude/settings.local.json`.3861* **Область действия**: [`Any file`](#scopes). Меню `/skills` записывает в `.claude/settings.local.json`.

3800* **Type**: объект, отображающий имя skill на одно из:3862* **Тип**: объект, сопоставляющий имя скилла с одним из значений:

3801 * `"on"`: Claude видит skill и вы можете ввести `/name`3863 * `"on"`: Claude видит скилл, и вы можете ввести `/name`

3802 * `"name-only"`: Claude видит skill по имени без его описания3864 * `"name-only"`: Claude видит скилл по имени без его описания

3803 * `"user-invocable-only"`: Claude не видит skill, но вы всё ещё можете ввести `/name`3865 * `"user-invocable-only"`: Claude не видит скилл, но вы по-прежнему можете ввести `/name`

3804 * `"off"`: Claude не видит skill и `/name` скрыт из автодополнения3866 * `"off"`: Claude не видит скилл, и `/name` скрыт из автодополнения

3805* **Default**: не установлено, поэтому каждый skill имеет значение `"on"`3867* **По умолчанию**: не задано, поэтому каждый скилл имеет значение `"on"`

3806 3868 

3807Этот пример перечисляет `legacy-context` для Claude только по имени и скрывает `deploy` от Claude и из автодополнения `/`:3869В этом примере `legacy-context` показывается Claude только по имени, а `deploy` скрывается от Claude и из автодополнения `/`:

3808 3870 

3809```json settings.json theme={null}3871```json settings.json theme={null}

3810{3872{


3815}3877}

3816```3878```

3817 3879 

3818Переопределения не применяются к skills плагинов, которыми вы управляете через `/plugin`.3880Переопределения не применяются к скиллам плагинов, которыми вы управляете через `/plugin`.

3819 3881 

3820В управляемых параметрах и файлах, переданных с `--settings`, ключ на псевдониме встроенного skill, такой как `checkup` для `/doctor`, также применяется к skill; см. [как ключи псевдонимов объединяются с ключами на собственном имени skill](https://code.claude.com/docs/ru/skills.md#override-skill-visibility-from-settings).3882В управляемых настройках и файлах, переданных с `--settings`, ключ для псевдонима встроенного скилла, например `checkup` для `/doctor`, также применяется к скиллу; см. [как ключи псевдонимов сочетаются с ключами для собственного имени скилла](https://code.claude.com/docs/ru/skills.md#override-skill-visibility-from-settings).

3821 3883 

3822### `syncClaudeAiSkills`3884### `syncClaudeAiSkills`

3823 3885 

3824Отключите загрузку [skills, включённых для вашей учётной записи claude.ai](https://code.claude.com/docs/ru/skills.md#how-synced-skills-behave). Claude Code загружает их в `~/.claude/skills/synced/` в [сеансах терминала, где вы входите с вашей учётной записью claude.ai](https://code.claude.com/docs/ru/skills.md#where-synced-skills-load), интерактивных или неинтерактивных, а также в сеансах Cowork и облачных сеансах. Установите `false`, чтобы остановить эту загрузку и остановить загрузку skills, которые она уже синхронизировала. Claude Code учитывает только `false`: `true` то же самое, что и не установлено, и не включает синхронизацию там, где она иначе отключена.3886Отключает загрузку [скиллов, включённых для вашей учётной записи claude.ai](https://code.claude.com/docs/ru/skills.md#how-synced-skills-behave). Claude Code загружает их в `~/.claude/skills/synced/` в [сессиях терминала, где вы входите с учётной записью claude.ai](https://code.claude.com/docs/ru/skills.md#where-synced-skills-load), интерактивных или неинтерактивных, а также в сессиях Cowork и облачных сессиях. Задайте `false`, чтобы остановить эту загрузку и прекратить загрузку уже синхронизированных скиллов. Claude Code учитывает только `false`: `true` равнозначно отсутствию значения и не включает синхронизацию там, где она иначе отключена.

3825 3887 

3826* **Scope**: [`User, local, or managed`](#scopes), и файлы, переданные с `--settings`. Репозиторий не может отключить её для вас.3888* **Область действия**: [`User, local, or managed`](#scopes), а также файлы, переданные с `--settings`. Репозиторий не может отключить её за вас.

3827* **Type**: Boolean3889* **Тип**: Boolean

3828 * `false`: Claude Code прекращает загрузку синхронизированных skills и прекращает загрузку тех, которые уже находятся в `~/.claude/skills/synced/`. В пользовательских или управляемых параметрах он также перемещает их в `~/.claude/skills/.trash/`3890 * `false`: Claude Code прекращает загружать синхронизированные скиллы и прекращает загружать те, что уже находятся в `~/.claude/skills/synced/`. В пользовательских или управляемых настройках он также перемещает их в `~/.claude/skills/.trash/`

3829 * `true`: то же самое, что и не установлено3891 * `true`: то же, что и отсутствие значения

3830* **Default**: не установлено, поэтому сеансы, в которых вы входите с вашей учётной записью claude.ai, синхронизируют ваши skills3892* **По умолчанию**: не задано, поэтому сессии, в которых выполнен вход с учётной записью claude.ai, синхронизируют ваши скиллы

3831 3893 

3832Этот пример предотвращает загрузку skills учётной записи машиной в любом сеансе:3894В этом примере компьютеру запрещается загружать скиллы учётной записи в любой сессии:

3833 3895 

3834```json settings.json theme={null}3896```json settings.json theme={null}

3835{3897{


3839 3901 

3840### `syncClaudeAiPlugins`3902### `syncClaudeAiPlugins`

3841 3903 

3842Отключите загрузку [плагинов, включённых для вашей учётной записи claude.ai](https://code.claude.com/docs/ru/plugins/loading.md#synced-plugins). Claude Code загружает их в `~/.claude/plugins/synced/` в начале сеансов терминала, где вы входите с вашей учётной записью claude.ai, и в сеансах Cowork, и загружает каждый как `<name>@synced`. Установите `false`, чтобы остановить эту загрузку и остановить загрузку плагинов, которые она уже синхронизировала. Claude Code учитывает только `false`: `true` то же самое, что и не установлено, и не включает синхронизацию там, где она иначе отключена. Требуется Claude Code v2.1.273 или позже.3904Отключает загрузку [плагинов, включённых для вашей учётной записи claude.ai](https://code.claude.com/docs/ru/plugins/loading.md#synced-plugins). Claude Code загружает их в `~/.claude/plugins/synced/` в начале сессий терминала, где вы входите с учётной записью claude.ai, и в сессиях Cowork, и загружает каждый как `<name>@synced`. Задайте `false`, чтобы остановить эту загрузку и прекратить загрузку уже синхронизированных плагинов. Claude Code учитывает только `false`: `true` равнозначно отсутствию значения и не включает синхронизацию там, где она иначе отключена. Требуется Claude Code v2.1.273 или новее.

3843 3905 

3844* **Scope**: [`User, local, or managed`](#scopes), и файлы, переданные с `--settings`. Репозиторий не может отключить её для вас.3906* **Область действия**: [`User, local, or managed`](#scopes), а также файлы, переданные с `--settings`. Репозиторий не может отключить её за вас.

3845* **Type**: Boolean3907* **Тип**: Boolean

3846 * `false`: Claude Code прекращает загрузку синхронизированных плагинов и прекращает загрузку тех, которые уже находятся в `~/.claude/plugins/synced/`. В пользовательских или управляемых параметрах он также перемещает их в `~/.claude/plugins/.trash/`3908 * `false`: Claude Code прекращает загружать синхронизированные плагины и прекращает загружать те, что уже находятся в `~/.claude/plugins/synced/`. В пользовательских или управляемых настройках он также перемещает их в `~/.claude/plugins/.trash/`

3847 * `true`: то же самое, что и не установлено3909 * `true`: то же, что и отсутствие значения

3848* **Default**: не установлено, поэтому сеансы, в которых вы входите с вашей учётной записью claude.ai, синхронизируют ваши плагины3910* **По умолчанию**: не задано, поэтому сессии, в которых выполнен вход с учётной записью claude.ai, синхронизируют ваши плагины

3849 3911 

3850Чтобы отключить один синхронизированный плагин вместо всех, установите `"<name>@synced": false` в [`enabledPlugins`](#enabledplugins).3912Чтобы отключить один синхронизированный плагин, а не все, задайте `"<name>@synced": false` в [`enabledPlugins`](#enabledplugins).

3851 3913 

3852Этот пример предотвращает загрузку плагинов учётной записи машиной в любом сеансе:3914В этом примере компьютеру запрещается загружать плагины учётной записи в любой сессии:

3853 3915 

3854```json settings.json theme={null}3916```json settings.json theme={null}

3855{3917{


3859 3921 

3860### `allowedChannelPlugins`3922### `allowedChannelPlugins`

3861 3923 

3862Выберите, какие [channel](https://code.claude.com/docs/ru/channels.md) плагины могут отправлять сообщения в сеансы в вашей организации. Когда вы это установите, Claude Code использует ваш список вместо списка разрешений Anthropic по умолчанию; каждая запись называет плагин и маркетплейс, из которого он поступает.3924Выбирает, какие плагины [каналов](https://code.claude.com/docs/ru/channels.md) могут отправлять сообщения в сессии вашей организации. Если ключ задан, Claude Code использует ваш список вместо стандартного списка разрешённых плагинов Anthropic; каждая запись указывает плагин и маркетплейс, из которого он получен.

3863 3925 

3864* **Scope**: [`Managed`](#scopes)3926* **Область действия**: [`Managed`](#scopes)

3865* **Type**: массив объектов, каждый с строками `marketplace` и `plugin`. Запись может быть вместо этого строкой `"plugin@marketplace"`, такой как `"telegram@claude-plugins-official"`, которую Claude Code рассматривает как эквивалентный объект. Форма строки требует Claude Code v2.1.267 или позже; более ранние версии отклоняют всё значение `allowedChannelPlugins`, когда оно содержит одну3927* **Тип**: массив объектов, каждый со строками `marketplace` и `plugin`. Вместо объекта запись может быть строкой `"plugin@marketplace"`, например `"telegram@claude-plugins-official"`, которую Claude Code рассматривает как эквивалентный объект. Строковая форма требует Claude Code v2.1.267 или новее; более ранние версии отклоняют всё значение `allowedChannelPlugins`, если оно её содержит

3866* **Default**: не установлено, поэтому Claude Code использует список разрешений Anthropic по умолчанию3928* **По умолчанию**: не задано, поэтому Claude Code использует стандартный список разрешённых плагинов Anthropic

3867 3929 

3868Этот пример включает channels и разрешает только плагин Telegram из официального маркетплейса Anthropic:3930В этом примере каналы включаются и разрешается только плагин Telegram из официального маркетплейса Anthropic:

3869 3931 

3870```json managed-settings.json theme={null}3932```json managed-settings.json theme={null}

3871{3933{


3876}3938}

3877```3939```

3878 3940 

3879Пустой массив блокирует каждый channel плагин.3941Пустой массив блокирует все плагины каналов.

3880 3942 

3881Этот ключ вступает в силу после того, как channels пройдут ворота [`channelsEnabled`](#channelsenabled) для учётной записи: на планах Team и Enterprise, а также на учётных записях Console с управляемыми параметрами, это означает `channelsEnabled: true`. См. [Ограничьте, какие channel плагины могут работать](https://code.claude.com/docs/ru/channels.md#restrict-which-channel-plugins-can-run).3943Этот ключ вступает в силу, когда каналы проходят проверку [`channelsEnabled`](#channelsenabled) для учётной записи: в планах Team и Enterprise, а также для учётных записей Console с управляемыми настройками это означает `channelsEnabled: true`. См. [Ограничение плагинов каналов, которые могут запускаться](https://code.claude.com/docs/ru/channels.md#restrict-which-channel-plugins-can-run).

3882 3944 

3883### `blockedMarketplaces`3945### `blockedMarketplaces`

3884 3946 

3885Заблокируйте источники маркетплейсов плагинов для вашей организации. Claude Code проверяет список блокировки при добавлении маркетплейса и при установке, обновлении, обновлении и автоматическом обновлении плагина, поэтому маркетплейс, который кто-то добавил до того, как вы установили политику, не может быть использован для получения плагинов. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы.3947Блокирует источники маркетплейсов плагинов для вашей организации. Claude Code проверяет список блокировки при добавлении маркетплейса, а также при установке, обновлении, повторной загрузке и автообновлении плагинов, поэтому маркетплейс, добавленный кем-либо до того, как вы задали политику, тоже нельзя использовать для получения плагинов. Заблокированные источники проверяются до загрузки, поэтому они никогда не попадают в файловую систему.

3886 3948 

3887Если вы установите этот ключ в [консоли администратора claude.ai](https://code.claude.com/docs/ru/server-managed-settings.md), claude.ai также применит его, когда кто-либо в вашей организации добавит маркетплейс из репозитория git на claude.ai, как описано в [Как работают ограничения](https://code.claude.com/docs/ru/plugins/org.md#restrict-what-users-can-install).3949Если вы задаёте этот ключ в [консоли администратора claude.ai](https://code.claude.com/docs/ru/server-managed-settings.md), claude.ai также применяет его, когда кто-либо в вашей организации добавляет маркетплейс из git-репозитория на claude.ai, как описано в разделе [Как работают ограничения](https://code.claude.com/docs/ru/plugins/org.md#restrict-what-users-can-install).

3888 3950 

3889* **Scope**: [`Managed`](#scopes)3951* **Область действия**: [`Managed`](#scopes)

3890* **Type**: массив объектов источника маркетплейса в тех же формах, что и [`strictKnownMarketplaces`](#allowed-source-types)3952* **Тип**: массив объектов источников маркетплейсов в тех же формах, что и для [`strictKnownMarketplaces`](#allowed-source-types)

3891* **Default**: не установлено, поэтому ни один маркетплейс не заблокирован3953* **По умолчанию**: не задано, поэтому ни один маркетплейс не заблокирован

3892 3954 

3893Этот пример блокирует один репозиторий GitHub как источник маркетплейса:3955В этом примере блокируется один репозиторий GitHub как источник маркетплейса:

3894 3956 

3895```json managed-settings.json theme={null}3957```json managed-settings.json theme={null}

3896{3958{


3900}3962}

3901```3963```

3902 3964 

3903Запись `github` может использовать [форму с подстановочным знаком владельца](#owner-wildcards) `"owner/*"` для блокировки каждого репозитория под этим владельцем GitHub, что требует Claude Code v2.1.223 или позже. Добавьте `{ "source": "skills-dir" }`, чтобы остановить загрузку Claude Code [`@skills-dir` плагинов](https://code.claude.com/docs/ru/plugins/loading#plugins-shared-through-a-repository) как из `~/.claude/skills/`, так и из `.claude/skills/` проекта без ограничения какого-либо маркетплейса. См. [Управляемые ограничения маркетплейса](https://code.claude.com/docs/ru/plugins/org.md#restrict-what-users-can-install).3965Запись `github` может использовать [форму с подстановочным знаком владельца](#owner-wildcards) `"owner/*"`, чтобы заблокировать все репозитории этого владельца GitHub; для этого требуется Claude Code v2.1.223 или новее. Добавьте `{ "source": "skills-dir" }`, чтобы Claude Code перестал загружать [плагины `@skills-dir`](https://code.claude.com/docs/ru/plugins/loading#plugins-shared-through-a-repository) как из `~/.claude/skills/`, так и из `.claude/skills/` проекта, не ограничивая ни один маркетплейс. См. [Ограничения управляемых маркетплейсов](https://code.claude.com/docs/ru/plugins/org.md#restrict-what-users-can-install).

3904 3966 

3905### `channelsEnabled`3967### `channelsEnabled`

3906 3968 

3907Разрешите [channels](https://code.claude.com/docs/ru/channels.md) для вашей организации. На планах claude.ai Team и Enterprise Claude Code блокирует channels до тех пор, пока вы не установите это на `true`. Для учётных записей [Anthropic Console](https://code.claude.com/docs/ru/authentication.md#claude-console-authentication), которые аутентифицируются с помощью ключа API, channels разрешены по умолчанию. Если ваша организация развёртывает управляемые параметры, Claude Code блокирует channels на этих учётных записях до тех пор, пока вы не установите этот ключ на `true`.3969Разрешает [каналы](https://code.claude.com/docs/ru/channels.md) для вашей организации. В планах claude.ai Team и Enterprise Claude Code блокирует каналы, пока вы не зададите значение `true`. Для учётных записей [Anthropic Console](https://code.claude.com/docs/ru/authentication.md#claude-console-authentication), которые проходят аутентификацию с помощью API-ключа, каналы разрешены по умолчанию. Если ваша организация развёртывает управляемые настройки, Claude Code блокирует каналы и для таких учётных записей, пока вы не зададите этому ключу значение `true`.

3908 3970 

3909* **Scope**: [`Managed`](#scopes)3971* **Область действия**: [`Managed`](#scopes)

3910* **Type**: Boolean3972* **Тип**: Boolean

3911 * `true`: Claude Code разрешает channels для вашей организации3973 * `true`: Claude Code разрешает каналы для вашей организации

3912 * `false`: то же самое, что и не установлено; блокируются ли channels, зависит от вашего плана, как указано в Default3974 * `false`: то же, что и отсутствие значения; блокируются ли каналы, зависит от вашего плана, как указано в пункте «По умолчанию»

3913* **Default**: не установлено; каналы блокируются на планах Team и Enterprise и на учётных записях Console с управляемыми настройками, и разрешены на планах Pro, Max и Ultra и на учётных записях Console без управляемых настроек3975* **По умолчанию**: не задано; каналы блокируются в планах Team и Enterprise и для учётных записей Console с управляемыми настройками и разрешены в планах Pro, Max и Ultra и для учётных записей Console без управляемых настройок

3914 3976 

3915```json managed-settings.json theme={null}3977```json managed-settings.json theme={null}

3916{3978{


3918}3980}

3919```3981```

3920 3982 

3921Чтобы ограничить, какие плагины могут регистрироваться как channels после их включения, установите [`allowedChannelPlugins`](#allowedchannelplugins). См. [Элементы управления Enterprise](https://code.claude.com/docs/ru/channels.md#enterprise-controls).3983Чтобы ограничить, какие плагины могут регистрироваться как каналы после их включения, задайте [`allowedChannelPlugins`](#allowedchannelplugins). См. [Корпоративные средства управления](https://code.claude.com/docs/ru/channels.md#enterprise-controls).

3922 3984 

3923### `disableCommandPluginSources`3985### `disableCommandPluginSources`

3924 3986 

3925Заблокируйте [источник плагина `command`](https://code.claude.com/docs/ru/plugins/marketplace-reference#command-plugin-source), который устанавливает плагин, запуская объявленную маркетплейсом команду на машине пользователя. Когда вы установите это на `true`, Claude Code никогда не запускает команду, не устанавливает и не обновляет плагины, полученные из command, и прекращает загрузку уже установленных. Установите на `false`, чтобы явно разрешить их. Всякий раз, когда он блокирует command источники, независимо от того, установили ли вы это на `true` или оставили не установленным под [`allowManagedHooksOnly`](#allowmanagedhooksonly), он также блокирует маркетплейс [`headersHelper` команды](https://code.claude.com/docs/ru/plugins/host-marketplace#authenticate-archive-downloads), за исключением маркетплейса, который сами управляемые параметры объявляют. Требуется Claude Code v2.1.229 или позже, и блокировка `headersHelper` требует v2.1.238 или позже.3987Блокирует [источник плагинов `command`](https://code.claude.com/docs/ru/plugins/marketplace-reference#command-plugin-source), который устанавливает плагин, запуская объявленную маркетплейсом команду на компьютере пользователя. Если вы задаёте значение `true`, Claude Code никогда не запускает эту команду, не устанавливает и не обновляет плагины из источника command и прекращает загружать уже установленные. Задайте `false`, чтобы явно разрешить их. Всякий раз, когда ключ блокирует источники command, независимо от того, задали ли вы `true` или оставили значение незаданным при [`allowManagedHooksOnly`](#allowmanagedhooksonly), он также блокирует [команды `headersHelper`](https://code.claude.com/docs/ru/plugins/host-marketplace#authenticate-archive-downloads) маркетплейсов, за исключением маркетплейса, который объявлен в самих управляемых настройках. Требуется Claude Code v2.1.229 или новее, а блокировка `headersHelper` требует v2.1.238 или новее.

3926 3988 

3927* **Scope**: [`Managed`](#scopes)3989* **Область действия**: [`Managed`](#scopes)

3928* **Type**: Boolean3990* **Тип**: Boolean

3929 * `true`: Claude Code никогда не запускает объявленную маркетплейсом команду, не устанавливает и не обновляет плагины, полученные из command, и прекращает загрузку уже установленных3991 * `true`: Claude Code никогда не запускает объявленную маркетплейсом команду, не устанавливает и не обновляет плагины из источника command и прекращает загружать уже установленные

3930 * `false`: Claude Code явно разрешает плагины, полученные из command3992 * `false`: Claude Code явно разрешает плагины из источника command

3931* **Default**: не установлено, поэтому Claude Code следует [`allowManagedHooksOnly`](#allowmanagedhooksonly): у организации, которая ограничивает выполнение хуков только управляемыми настройками, источники command тоже отключены. Приложение, которое передаёт [`disableAllHooks: true`](#disableallhooks) в параметре `managedSettings` Agent SDK, само по себе не отключает источники command.3993* **По умолчанию**: не задано, поэтому Claude Code следует [`allowManagedHooksOnly`](#allowmanagedhooksonly): у организации, которая ограничивает выполнение хуков управляемыми настройками, источники command тоже отключены. Приложение, передающее [`disableAllHooks: true`](#disableallhooks) в параметре `managedSettings` Agent SDK, само по себе не отключает источники command.

3932 3994 

3933```json managed-settings.json theme={null}3995```json managed-settings.json theme={null}

3934{3996{


3936}3998}

3937```3999```

3938 4000 

3939Требуется Claude Code v2.1.229 или позже.4001Требуется Claude Code v2.1.229 или новее.

3940 4002 

3941### `pluginSuggestionMarketplaces`4003### `pluginSuggestionMarketplaces`

3942 4004 

3943Назовите маркетплейсы, чьи плагины могут появляться как контекстные предложения по установке, в советах спиннера и закреплённые в верхней части вкладки `/plugin` **Discover**. Встроенное предложение первой стороны по дизайну фронтенда не затрагивается. Предложения поступают из объявления `relevance` каждого плагина в его записи маркетплейса.4005Указывает маркетплейсы, плагины которых могут появляться как контекстные предложения установки — в подсказках индикатора загрузки и закреплёнными вверху вкладки **Discover** в `/plugin`. Встроенная собственная подсказка frontend-design не затрагивается. Предложения формируются на основе объявления `relevance` каждого плагина в его записи маркетплейса.

3944 4006 

3945* **Scope**: [`Managed`](#scopes)4007* **Область действия**: [`Managed`](#scopes)

3946* **Type**: массив имён маркетплейсов4008* **Тип**: массив имён маркетплейсов

3947* **Default**: не установлено, поэтому никакие объявленные маркетплейсом предложения не появляются4009* **По умолчанию**: не задано, поэтому предложения, объявленные маркетплейсами, не показываются

3948 4010 

3949```json managed-settings.json theme={null}4011```json managed-settings.json theme={null}

3950{4012{


3952}4014}

3953```4015```

3954 4016 

3955Имя вступает в силу только когда маркетплейс зарегистрирован на машине и его зарегистрированный источник также объявлен в тех же управляемых параметрах, либо как запись [`extraKnownMarketplaces`](#extraknownmarketplaces) для этого имени, либо как запись [`strictKnownMarketplaces`](#strictknownmarketplaces). Claude Code игнорирует маркетплейс, зарегистрированный из другого источника под разрешённым именем. Официальный маркетплейс освобождён от требования источника: разрешение только его имени достаточно, так как это имя может регистрироваться только из официального источника Anthropic. См. [Предложите плагины по контексту](https://code.claude.com/docs/ru/plugins/relevance.md).4017Имя вступает в силу, только если маркетплейс зарегистрирован на компьютере и его зарегистрированный источник также объявлен в тех же управляемых настройках — либо как запись [`extraKnownMarketplaces`](#extraknownmarketplaces) для этого имени, либо как запись [`strictKnownMarketplaces`](#strictknownmarketplaces). Claude Code игнорирует маркетплейс, зарегистрированный из другого источника под именем из списка разрешённых. Официальный маркетплейс освобождён от требования к источнику: достаточно добавить в список разрешённых только его имя, поскольку это имя может быть зарегистрировано только из официального источника Anthropic. См. [Предложение плагинов по контексту](https://code.claude.com/docs/ru/plugins/relevance.md).

3956 4018 

3957### `pluginTrustMessage`4019### `pluginTrustMessage`

3958 4020 

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

3960 4022 

3961* **Scope**: [`Managed`](#scopes)4023* **Область действия**: [`Managed`](#scopes)

3962* **Type**: string4024* **Тип**: строка

3963* **Default**: не установлено, поэтому Claude Code показывает только стандартное предупреждение4025* **По умолчанию**: не задано, поэтому Claude Code показывает только стандартное предупреждение

3964 4026 

3965```json managed-settings.json theme={null}4027```json managed-settings.json theme={null}

3966{4028{


3970 4032 

3971### `strictKnownMarketplaces`4033### `strictKnownMarketplaces`

3972 4034 

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

3974 4036 

3975Если вы установите этот ключ в [консоли администратора claude.ai](https://code.claude.com/docs/ru/server-managed-settings.md), claude.ai также применит его, когда кто-либо в вашей организации добавит маркетплейс из репозитория git на claude.ai, как описано в [Как работают ограничения](https://code.claude.com/docs/ru/plugins/org.md#restrict-what-users-can-install).4037Если вы задаёте этот ключ в [консоли администратора claude.ai](https://code.claude.com/docs/ru/server-managed-settings.md), claude.ai также применяет его, когда кто-либо в вашей организации добавляет маркетплейс из git-репозитория на claude.ai, как описано в разделе [Как работают ограничения](https://code.claude.com/docs/ru/plugins/org.md#restrict-what-users-can-install).

3976 4038 

3977* **Scope**: [`Managed`](#scopes)4039* **Область действия**: [`Managed`](#scopes)

3978* **Type**: массив объектов источника маркетплейса; см. [Разрешённые типы источников](#allowed-source-types)4040* **Тип**: массив объектов источников маркетплейсов; см. [Разрешённые типы источников](#allowed-source-types)

3979* **Default**: не установлено, поэтому пользователи могут добавлять любой маркетплейс. Пустой массив — это полная блокировка, которая блокирует каждый источник маркетплейса, включая официальный маркетплейс Anthropic4041* **По умолчанию**: не задано, поэтому пользователи могут добавлять любой маркетплейс. Пустой массив означает полную блокировку всех источников маркетплейсов, включая официальный маркетплейс Anthropic

3980 4042 

3981Этот пример разрешает два репозитория GitHub, один закреплённый на ref `v2.0`, и один размещённый URL маркетплейса `marketplace.json`:4043В этом примере разрешаются два репозитория GitHub, один из которых закреплён за ref `v2.0`, и один размещённый URL `marketplace.json`:

3982 4044 

3983```json managed-settings.json theme={null}4045```json managed-settings.json theme={null}

3984{4046{


3990}4052}

3991```4053```

3992 4054 

3993Вы также можете написать этот ключ как `allowedMarketplaces`; [Псевдонимы ключей маркетплейса](#marketplace-key-aliases) описывает, как Claude Code рассматривает псевдоним и какая версия его принимает. Этот ключ — это ворота политики: он контролирует, что пользователи могут добавлять, но ничего не регистрирует. Чтобы ограничить и предварительно зарегистрировать в одном файле, см. [Объедините с `extraKnownMarketplaces`](#combine-with-extraknownmarketplaces). Для представления, обращённого к пользователю, см. [Управляемые ограничения маркетплейса](https://code.claude.com/docs/ru/plugins/org.md#restrict-what-users-can-install).4055Этот ключ также можно записать как `allowedMarketplaces`; в разделе [Псевдонимы ключей маркетплейсов](#marketplace-key-aliases) описано, как Claude Code обрабатывает псевдоним и какая версия его принимает. Этот ключ является политикой-ограничителем: он определяет, что пользователи могут добавлять, но ничего не регистрирует. Чтобы ограничить и предварительно зарегистрировать маркетплейсы в одном файле, см. [Сочетание с `extraKnownMarketplaces`](#combine-with-extraknownmarketplaces). Описание с точки зрения пользователя см. в разделе [Ограничения управляемых маркетплейсов](https://code.claude.com/docs/ru/plugins/org.md#restrict-what-users-can-install).

3994 4056 

3995#### Allowed source types4057#### Разрешённые типы источников

3996 4058 

3997Каждая запись ниже показывает одну запись списка разрешений на тип источника и поля, которые она принимает. Большинство типов совпадают точно; `hostPattern` и `pathPattern` совпадают по регулярному выражению, и записи `github` могут использовать [подстановочный знак владельца](#owner-wildcards).4059Ниже для каждого типа источника показана одна запись списка разрешённых и принимаемые ею поля. Большинство типов сопоставляются точно; `hostPattern` и `pathPattern` сопоставляются по регулярному выражению, а записи `github` могут использовать [подстановочный знак владельца](#owner-wildcards).

3998 4060 

3999| Source | Example entry | Fields |4061| Источник | Пример записи | Поля |

4000| :- | :- | :- |4062| :- | :- | :- |

4001| `github` | `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }` | `repo` обязателен; `ref` — это ветка или тег; `path` — это подкаталог |4063| `github` | `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }` | `repo` обязательно; `ref` — ветка или тег; `path` — подкаталог |

4002| `git` | `{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git", "ref": "production" }` | `url` обязателен; `ref` и `path` как для `github` |4064| `git` | `{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git", "ref": "production" }` | `url` обязательно; `ref` и `path` — как для `github` |

4003| `url` | `{ "source": "url", "url": "https://plugins.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }` | `url` обязателен; `headers` добавляет HTTP заголовки для аутентифицированного доступа |4065| `url` | `{ "source": "url", "url": "https://plugins.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }` | `url` обязательно; `headers` добавляет HTTP-заголовки для доступа с аутентификацией |

4004| `file` | `{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }` | `path` обязателен, абсолютный путь к файлу `marketplace.json` |4066| `file` | `{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }` | `path` обязательно — абсолютный путь к файлу `marketplace.json` |

4005| `directory` | `{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }` | `path` обязателен, абсолютный путь к каталогу, содержащему `.claude-plugin/marketplace.json` |4067| `directory` | `{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }` | `path` обязательно — абсолютный путь к каталогу, содержащему `.claude-plugin/marketplace.json` |

4006| `hostPattern` | `{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }` | `hostPattern` обязателен, регулярное выражение, совпадающее в любом месте хоста маркетплейса; закрепите его с помощью `^` и `$`, чтобы совпадать со всем хостом |4068| `hostPattern` | `{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }` | `hostPattern` обязательно — регулярное выражение, сопоставляемое с любой частью хоста маркетплейса; привяжите его с помощью `^` и `$`, чтобы сопоставлять весь хост |

4007| `pathPattern` | `{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }` | `pathPattern` обязателен, регулярное выражение, совпадающее в любом месте `path` источников `file` и `directory`; начните его с `^`, чтобы закрепить префикс |4069| `pathPattern` | `{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }` | `pathPattern` обязательно — регулярное выражение, сопоставляемое с любой частью `path` источников `file` и `directory`; начните его с `^`, чтобы закрепить префикс |

4008| `skills-dir` | `{ "source": "skills-dir" }` | Нет полей |4070| `skills-dir` | `{ "source": "skills-dir" }` | Нет полей |

4009 4071 

4010Некоторые типы источников имеют правила, выходящие за рамки таблицы:4072Для некоторых типов источников действуют правила, выходящие за рамки таблицы:

4011 4073 

4012* **`url`**: маркетплейс URL загружает только файл `marketplace.json`, и Claude Code не получает файлы плагинов по относительному пути с этого сервера, поэтому его плагины должны использовать [источник плагина](https://code.claude.com/docs/ru/plugins/marketplace-reference.md#plugin-sources), отличный от относительного пути, такой как URL архива, который может быть на том же хосте. Для плагинов с относительными путями используйте маркетплейс на основе Git. См. [Плагины с относительными путями не работают в маркетплейсах на основе URL](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugins-with-relative-paths-fail-in-url-based-marketplaces).4074* **`url`**: маркетплейс по URL загружает только файл `marketplace.json`, и Claude Code не получает файлы плагинов с этого сервера по относительному пути, поэтому его плагины должны использовать [источник плагина](https://code.claude.com/docs/ru/plugins/marketplace-reference.md#plugin-sources), отличный от относительного пути, например URL архива, который может находиться на том же хосте. Для плагинов с относительными путями используйте вместо этого маркетплейс на основе Git. См. [Плагины с относительными путями не работают в маркетплейсах на основе URL](https://code.claude.com/docs/ru/plugins/troubleshooting.md#plugins-with-relative-paths-fail-in-url-based-marketplaces).

4013* **`hostPattern`**: используйте его, чтобы разрешить каждый маркетплейс на внутреннем GitHub Enterprise или GitLab сервере без перечисления каждого репозитория. Claude Code совпадает с источниками `github` против `github.com`, берёт имя хоста из источников `url` и берёт его из источников `git` в зависимости от формы [git URL](https://git-scm.com/docs/git-clone#_git_urls):4075* **`hostPattern`**: используйте его, чтобы разрешить все маркетплейсы на внутреннем сервере GitHub Enterprise или GitLab, не перечисляя каждый репозиторий. Claude Code сопоставляет источники `github` с `github.com`, берёт имя хоста из источников `url`, а из источников `git` — в зависимости от формы [git URL](https://git-scm.com/docs/git-clone#_git_urls):

4014 4076 

4015 * URL со схемой, такой как `https://` или `ssh://`: имя хоста в URL.4077 * URL со схемой, например `https://` или `ssh://`: имя хоста в URL.

4016 * SSH адрес без схемы, в форме `user@host:path` git, такой как `git@git.example.com:tools/plugins.git`: хост между `@` и `:`, который является хостом, к которому подключается git.4078 * SSH-адрес без схемы в форме git `user@host:path`, например `git@git.example.com:tools/plugins.git`: хост между `@` и `:`, то есть хост, к которому подключается git.

4017 * Любая другая форма без схемы: нет хоста, поэтому ни одна запись `strictKnownMarketplaces` `hostPattern` не совпадает с ней. Для `blockedMarketplaces` `hostPattern`, Claude Code берёт хост из более широкого набора форм, поэтому запись списка блокировки всё ещё может совпадать с такой формой. До v2.1.234, `strictKnownMarketplaces` `hostPattern` также совпадала с некоторыми формами, которые git не рассматривает как SSH адреса.4079 * Любая другая форма без схемы: хоста нет, поэтому ни одна запись `hostPattern` в `strictKnownMarketplaces` с ней не совпадает. Для `hostPattern` в `blockedMarketplaces` Claude Code извлекает хост из более широкого набора форм, поэтому запись списка блокировки всё же может совпасть с такой формой. До v2.1.234 `hostPattern` в `strictKnownMarketplaces` также совпадал с некоторыми формами, которые git не считает SSH-адресами.

4018 4080 

4019 Источники `file` и `directory` не имеют хоста и никогда не совпадают с записью `hostPattern`.4081 У источников `file` и `directory` нет хоста, и они никогда не совпадают с записью `hostPattern`.

4020* **`pathPattern`**: используйте его, чтобы разрешить маркетплейсы файловой системы наряду с записями `hostPattern` для сетевых источников. `".*"` разрешает каждый локальный путь; более узкий паттерн, такой как `"^/opt/approved/"`, ограничивает каталогом.4082* **`pathPattern`**: используйте его, чтобы разрешить маркетплейсы в файловой системе наряду с записями `hostPattern` для сетевых источников. `".*"` разрешает любой локальный путь; более узкий шаблон, например `"^/opt/approved/"`, ограничивает разрешение одним каталогом.

4021* **`skills-dir`**: любой список разрешённых источников, даже пустой, останавливает загрузку Claude Code [плагинов `@skills-dir`](https://code.claude.com/docs/ru/plugins/loading#plugins-shared-through-a-repository) как из `~/.claude/skills/`, так и из `.claude/skills/` проекта. Чтобы продолжить их загрузку, добавьте запись `{ "source": "skills-dir" }` и оставьте [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) не установленным. Вне этого ключа и `blockedMarketplaces` эта запись не имеет значения.4083* **`skills-dir`**: любой список разрешённых, даже пустой, заставляет Claude Code прекратить загрузку [плагинов `@skills-dir`](https://code.claude.com/docs/ru/plugins/loading#plugins-shared-through-a-repository) как из `~/.claude/skills/`, так и из `.claude/skills/` проекта. Чтобы продолжить их загрузку, добавьте запись `{ "source": "skills-dir" }` и оставьте [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) незаданным. Эта запись не имеет смысла за пределами этого ключа и `blockedMarketplaces`.

4022 4084 

4023#### Owner wildcards4085#### Подстановочные знаки владельца

4024 4086 

4025Запись `github`, чьё значение `repo` — это `"<owner>/*"`, совпадает с каждым репозиторием под этим владельцем GitHub. Подстановочные знаки владельца требуют Claude Code v2.1.223 или позже и работают только в `strictKnownMarketplaces` и `blockedMarketplaces`. Везде, где источник `github` появляется, такой как `extraKnownMarketplaces` или `/plugin marketplace add`, значение `repo` должно называть один репозиторий. До v2.1.223, Claude Code сравнивал запись буквально, поэтому запись списка разрешений не совпадала ни с одним репозиторием и запись списка блокировки ничего не блокировала; записи с одним репозиторием применяются на каждой версии.4087Запись `github`, у которой значение `repo` равно `"<owner>/*"`, совпадает со всеми репозиториями этого владельца GitHub. Подстановочные знаки владельца требуют Claude Code v2.1.223 или новее и работают только в `strictKnownMarketplaces` и `blockedMarketplaces`. Везде, где ещё встречается источник `github`, например в `extraKnownMarketplaces` или `/plugin marketplace add`, значение `repo` должно указывать один репозиторий. До v2.1.223 Claude Code сравнивал запись буквально, поэтому запись списка разрешённых не совпадала ни с одним репозиторием, а запись списка блокировки ничего не блокировала; записи с одним репозиторием применяются во всех версиях.

4026 4088 

4027Эта запись разрешает любой маркетплейс репозитория в организации `acme-corp`:4089Эта запись разрешает любой репозиторий маркетплейса в организации `acme-corp`:

4028 4090 

4029```json managed-settings.json theme={null}4091```json managed-settings.json theme={null}

4030{4092{


4034}4096}

4035```4097```

4036 4098 

4037Только вся позиция имени репозитория может быть подстановочным знаком. Claude Code игнорирует записи, такие как `*`, `*/plugins` или `acme-corp/tools-*`, как недействительные, поэтому они не совпадают ни с одним репозиторием.4099Подстановочным знаком может быть только вся позиция имени репозитория целиком. Claude Code игнорирует такие записи, как `*`, `*/plugins` или `acme-corp/tools-*`, как недопустимые, поэтому они не совпадают ни с одним репозиторием.

4038 4100 

4039Правила сопоставления различаются между двумя параметрами:4101Правила сопоставления в двух настройках различаются:

4040 4102 

4041| Rule | `strictKnownMarketplaces` | `blockedMarketplaces` |4103| Правило | `strictKnownMarketplaces` | `blockedMarketplaces` |

4042| - | - | - |4104| - | - | - |

4043| Matching source spellings | Только форма `owner/repo`. Git URL, который клонирует тот же репозиторий, не совпадает | Любое написание, включая git URL, которые разрешаются в тот же репозиторий github.com |4105| Совпадающие варианты записи источника | Только форма `owner/repo`. Git URL, клонирующий тот же репозиторий, не совпадает | Любой вариант записи, включая git URL, которые указывают на тот же репозиторий github.com |

4044| Owner case | С учётом регистра | Без учёта регистра |4106| Регистр владельца | С учётом регистра | Без учёта регистра |

4045| `ref` | Следует правилам точного сопоставления: запись с `ref` совпадает только с источниками с этим точным ref, и запись без одного совпадает только с источниками, которые не указывают ref | Запись без `ref` блокирует все ref репозиториев, которые она совпадает |4107| `ref` | Следует правилам точных записей: запись с `ref` совпадает только с источниками с точно таким же ref, а запись без него совпадает только с источниками, в которых ref не указан | Запись без `ref` блокирует все ref совпадающих с ней репозиториев |

4046| `path` | Более свободно, чем правила точного сопоставления: запись с `path` требует это точное значение, в то время как запись без одного совпадает с любым путём внутри репозитория | Запись без `path` блокирует все пути репозиториев, которые она совпадает |4108| `path` | Менее строго, чем правила точных записей: запись с `path` требует точно такого же значения, а запись без него совпадает с любым путём внутри репозитория | Запись без `path` блокирует все пути совпадающих с ней репозиториев |

4047 4109 

4048#### Exact matching4110#### Точное сопоставление

4049 4111 

4050Для каждого типа источника, кроме записей `github` с подстановочным знаком владельца и записей `hostPattern` и `pathPattern`, совпадающих по регулярному выражению, Claude Code разрешает добавление пользователя только когда источник маркетплейса точно совпадает с записью. Для источников на основе git `github` и `git`, точное сопоставление включает необязательные поля:4112Для всех типов источников, кроме записей `github` с подстановочным знаком владельца и сопоставляемых по регулярному выражению записей `hostPattern` и `pathPattern`, Claude Code разрешает добавление пользователем, только если источник маркетплейса точно совпадает с записью. Для источников на основе git — `github` и `git` — точное сопоставление включает необязательные поля:

4051 4113 

4052* `repo` или `url` должны совпадать точно4114* `repo` или `url` должны совпадать точно

4053* Поле `ref` должно совпадать точно, или оба должны быть не определены4115* Поле `ref` должно совпадать точно, либо оба значения должны быть не определены

4054* Поле `path` должно совпадать точно, или оба должны быть не определены4116* Поле `path` должно совпадать точно, либо оба значения должны быть не определены

4055 4117 

4056Например, Claude Code рассматривает каждую пару ниже как два разных источника:4118Например, Claude Code рассматривает каждую пару ниже как два разных источника:

4057 4119 

4058* `{ "source": "github", "repo": "acme-corp/plugins" }` и `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main" }`4120* `{ "source": "github", "repo": "acme-corp/plugins" }` и `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main" }`

4059* `{ "source": "github", "repo": "acme-corp/plugins", "path": "marketplace" }` и `{ "source": "github", "repo": "acme-corp/plugins" }`4121* `{ "source": "github", "repo": "acme-corp/plugins", "path": "marketplace" }` и `{ "source": "github", "repo": "acme-corp/plugins" }`

4060 4122 

4061#### Allow only the official marketplace4123#### Разрешение только официального маркетплейса

4062 4124 

4063Чтобы разрешить только официальный маркетплейс Anthropic, перечислите его репозиторий:4125Чтобы разрешить официальный маркетплейс Anthropic и ничего больше, укажите его репозиторий:

4064 4126 

4065```json managed-settings.json theme={null}4127```json managed-settings.json theme={null}

4066{4128{


4070}4132}

4071```4133```

4072 4134 

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

4074 4136 

4075* Неинтерактивные среды, которые работают до первого интерактивного сеанса терминала машины.4137* Неинтерактивные среды, которые запускаются до первой интерактивной сессии терминала на компьютере.

4076* Машины, где Claude Code работал только через расширение VS Code.4138* Компьютеры, на которых Claude Code запускался только через расширение VS Code.

4077* Машины, где Claude Code уже запустил интерактивный сеанс терминала под политикой, которая блокировала маркетплейс, такой как блокировка пустого массива. Claude Code записывает заблокированную попытку и не повторяет попытку после изменения политики.4139* Компьютеры, на которых Claude Code уже запускал интерактивную сессию терминала при политике, блокировавшей маркетплейс, например при полной блокировке пустым массивом. Claude Code записывает заблокированную попытку и не повторяет попытку после изменения политики.

4078 4140 

4079На этих машинах добавьте маркетплейс в [`extraKnownMarketplaces`](#extraknownmarketplaces) в том же `managed-settings.json`, чтобы Claude Code зарегистрировал его автоматически, или запустите `claude plugin marketplace add anthropics/claude-plugins-official`.4141На таких компьютерах добавьте маркетплейс в [`extraKnownMarketplaces`](#extraknownmarketplaces) в том же `managed-settings.json`, чтобы Claude Code зарегистрировал его автоматически, или выполните `claude plugin marketplace add anthropics/claude-plugins-official`.

4080 4142 

4081#### Combine with `extraKnownMarketplaces`4143#### Сочетание с `extraKnownMarketplaces`

4082 4144 

4083Два ключа выполняют разные работы. Эта таблица их сравнивает:4145Эти два ключа выполняют разные задачи. В этой таблице они сравниваются:

4084 4146 

4085| Aspect | `strictKnownMarketplaces` | `extraKnownMarketplaces` |4147| Аспект | `strictKnownMarketplaces` | `extraKnownMarketplaces` |

4086| - | - | - |4148| - | - | - |

4087| Purpose | Применение организационной политики | Удобство команды |4149| Назначение | Применение политики организации | Удобство для команды |

4088| Settings file | Только управляемые параметры | Любой файл параметров |4150| Файл настроек | Только управляемые настройки | Любой файл настроек |

4089| Behavior | Блокирует добавления, не входящие в список разрешений | Регистрирует отсутствующие маркетплейсы |4151| Поведение | Блокирует добавления, не входящие в список разрешённых | Регистрирует отсутствующие маркетплейсы |

4090| When enforced | Перед сетевыми и файловыми операциями | Сразу из пользовательских или управляемых параметров; после диалога доверия рабочей области для файлов репозитория |4152| Когда применяется | До сетевых операций и операций с файловой системой | Сразу — из пользовательских или управляемых настроек; после диалога доверия рабочему пространству — для файлов репозитория |

4091| Can be overridden | Нет, наивысший приоритет | Да, параметрами с более высоким приоритетом |4153| Можно ли переопределить | Нет, наивысший приоритет | Да, настройками с более высоким приоритетом |

4092| Source format | Прямой объект источника | Именованный маркетплейс с вложенным объектом `source` |4154| Формат источника | Непосредственно объект источника | Именованный маркетплейс с вложенным объектом `source` |

4093 4155 

4094Чтобы ограничить и предварительно зарегистрировать маркетплейс для всех пользователей, установите оба в `managed-settings.json`:4156Чтобы и ограничить, и предварительно зарегистрировать маркетплейс для всех пользователей, задайте оба ключа в `managed-settings.json`:

4095 4157 

4096```json managed-settings.json theme={null}4158```json managed-settings.json theme={null}

4097{4159{


4106}4168}

4107```4169```

4108 4170 

4109Только с установленным `strictKnownMarketplaces`, пользователи всё ещё могут добавить разрешённый маркетплейс сами с помощью `/plugin marketplace add`. Официальный маркетплейс Anthropic — единственный, который Claude Code регистрирует автоматически, и только когда список разрешений его разрешает. [Разрешите только официальный маркетплейс](#allow-only-the-official-marketplace) перечисляет машины, которые он пропускает.4171Если задан только `strictKnownMarketplaces`, пользователи по-прежнему могут сами добавить разрешённый маркетплейс с помощью `/plugin marketplace add`. Официальный маркетплейс Anthropic — единственный, который Claude Code регистрирует автоматически, и только если список разрешённых это допускает. В разделе [Разрешение только официального маркетплейса](#allow-only-the-official-marketplace) перечислены компьютеры, на которых регистрация не срабатывает.

4110 4172 

4111### `strictPluginOnlyCustomization`4173### `strictPluginOnlyCustomization`

4112 4174 

4113Заблокируйте skills, agents, hooks и MCP серверы из источников пользователя и проекта, чтобы они могли поступать только из плагинов или управляемых параметров. Объедините его с [`strictKnownMarketplaces`](#strictknownmarketplaces), чтобы контролировать полную цепочку поставок настройки: список разрешений маркетплейса контролирует, какие плагины пользователи могут устанавливать.4175Блокирует скиллы, агентов, хуки и MCP-серверы из пользовательских и проектных источников. Сочетайте его с [`strictKnownMarketplaces`](#strictknownmarketplaces), чтобы выбрать, из каких маркетплейсов пользователи могут устанавливать плагины. Добавьте [`disableSideloadFlags`](#disablesideloadflags), чтобы отклонять флаги CLI, которые подгружают плагины, агентов и MCP-серверы для одного запуска.

4114 4176 

4115* **Scope**: [`Managed`](#scopes)4177* **Область действия**: [`Managed`](#scopes)

4116* **Type**: `true` для блокировки всех четырёх видов настройки, или массив, называющий виды для блокировки, из `"skills"`, `"agents"`, `"hooks"` и `"mcp"`4178* **Тип**: `true`, чтобы заблокировать их все, или массив с названиями блокируемых из `"skills"`, `"agents"`, `"hooks"` и `"mcp"`

4117* **Default**: не установлено, поэтому ничего не заблокировано4179* **По умолчанию**: не задано, поэтому ничего не заблокировано

4118 4180 

4119Этот пример блокирует skills и hooks и оставляет agents и MCP серверы разблокированными:4181В этом примере блокируются скиллы и хуки, а агенты и MCP-серверы остаются незаблокированными:

4120 4182 

4121```json managed-settings.json theme={null}4183```json managed-settings.json theme={null}

4122{4184{


4124}4186}

4125```4187```

4126 4188 

4127Если вы блокируете любой интерфейс, Claude Code также прекращает загрузку [плагинов из каталога skills](https://code.claude.com/docs/ru/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings) — папок плагинов, которые пользователи хранят в `~/.claude/skills/` или `.claude/skills/`. Пользователи размещают эти папки сами, а не устанавливают их из маркетплейса, поэтому при этой настройке Claude Code рассматривает их как пользовательские настройки.4189Если вы блокируете любой интерфейс, Claude Code также прекращает загружать [плагины из каталога скиллов](https://code.claude.com/docs/ru/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings) — папки плагинов, которые пользователи хранят в `~/.claude/skills/` или `.claude/skills/`. Пользователи размещают эти папки сами, а не устанавливают из маркетплейса, поэтому при этой настройке Claude Code рассматривает их как пользовательскую настройку.

4128 4190 

4129Четыре записи подключей ниже перечисляют, что ещё блокирует каждый интерфейс и что по-прежнему загружается. Claude Code игнорирует имена интерфейсов, которые он не распознаёт, вместо того чтобы отклонять файл настроек, поэтому вы можете добавлять новые имена интерфейсов до того, как обновится каждый клиент.4191В четырёх записях подключей ниже перечислено, что ещё блокирует каждый интерфейс и что по-прежнему загружается. Claude Code игнорирует нераспознанные названия интерфейсов, а не считает файл настроек ошибочным, поэтому вы можете добавлять новые названия интерфейсов до того, как обновятся все клиенты.

4130 4192 

4131### `strictPluginOnlyCustomization.skills`4193### `strictPluginOnlyCustomization.skills`

4132 4194 

4133Заблокируйте интерфейс `skills`. Claude Code прекращает загрузку skills из `~/.claude/skills/` и `.claude/skills/`, пользовательских команд из `~/.claude/commands/` и `.claude/commands/`, skills и команд в каталогах `--add-dir` и skills, синхронизированных из вашей учётной записи claude.ai. Он продолжает загружать встроенные skills, skills в каталоге управляемой политики и skills из плагинов, кроме [плагинов из каталога skills](https://code.claude.com/docs/ru/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings).4195Блокирует интерфейс `skills`. Claude Code прекращает загружать скиллы из `~/.claude/skills/` и `.claude/skills/`, пользовательские команды из `~/.claude/commands/` и `.claude/commands/`, скиллы и команды из каталогов `--add-dir`, а также скиллы, синхронизированные из вашей учётной записи claude.ai. Он продолжает загружать встроенные скиллы, скиллы в каталоге управляемой политики и скиллы из плагинов, кроме [плагинов из каталога скиллов](https://code.claude.com/docs/ru/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings).

4134 4196 

4135* **Scope**: [`Managed`](#scopes)4197* **Область действия**: [`Managed`](#scopes)

4136* **Type**: строка `"skills"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)4198* **Тип**: строка `"skills"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)

4137* **Default**: не заблокировано4199* **По умолчанию**: не заблокировано

4138 4200 

4139```json managed-settings.json theme={null}4201```json managed-settings.json theme={null}

4140{4202{


4144 4206 

4145### `strictPluginOnlyCustomization.agents`4207### `strictPluginOnlyCustomization.agents`

4146 4208 

4147Заблокируйте интерфейс `agents`. Claude Code прекращает загрузку агентов из `~/.claude/agents/`, `.claude/agents/` и каталогов `--add-dir`. Он продолжает загружать встроенных агентов, агентов в каталоге управляемой политики и агентов из плагинов, кроме [плагинов из каталога skills](https://code.claude.com/docs/ru/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings).4209Блокирует интерфейс `agents`. Claude Code прекращает загружать агентов из `~/.claude/agents/`, `.claude/agents/` и каталогов `--add-dir`. Он продолжает загружать встроенных агентов, агентов в каталоге управляемой политики и агентов из плагинов, кроме [плагинов из каталога скиллов](https://code.claude.com/docs/ru/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings).

4148 4210 

4149* **Scope**: [`Managed`](#scopes)4211* **Область действия**: [`Managed`](#scopes)

4150* **Type**: строка `"agents"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)4212* **Тип**: строка `"agents"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)

4151* **Default**: не заблокировано4213* **По умолчанию**: не заблокировано

4152 4214 

4153```json managed-settings.json theme={null}4215```json managed-settings.json theme={null}

4154{4216{


4158 4220 

4159### `strictPluginOnlyCustomization.hooks`4221### `strictPluginOnlyCustomization.hooks`

4160 4222 

4161Заблокируйте интерфейс `hooks`:4223Блокирует интерфейс `hooks`:

4162 4224 

4163* **Перестают запускаться**:4225* **Перестают выполняться**:

4164 * Хуки из пользовательского, проектного и локального `settings.json`4226 * Хуки из пользовательского, проектного и локального `settings.json`

4165 * Хуки во frontmatter skills, пользовательских команд и агентов из тех источников, которые заблокировала бы блокировка [`skills`](#strictpluginonlycustomization-skills) или [`agents`](#strictpluginonlycustomization-agents)4227 * Хуки во frontmatter скиллов, пользовательских команд и агентов из тех источников, которые заблокировала бы блокировка [`skills`](#strictpluginonlycustomization-skills) или [`agents`](#strictpluginonlycustomization-agents)

4166* **Продолжают запускаться**: хуки в управляемых настройках и хуки из плагинов, кроме [плагинов из каталога skills](https://code.claude.com/docs/ru/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings)4228* **Продолжают выполняться**: хуки в управляемых настройках и хуки из плагинов, кроме [плагинов из каталога скиллов](https://code.claude.com/docs/ru/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings)

4167 4229 

4168Skills, пользовательские команды и агенты, хуки во frontmatter которых перестают запускаться, по-прежнему загружаются, пока их собственный интерфейс не заблокирован.4230Скиллы, пользовательские команды и агенты, хуки во frontmatter которых перестают выполняться, по-прежнему загружаются, пока их собственный интерфейс не заблокирован.

4169 4231 

4170Личный или проектный [skill](https://code.claude.com/docs/ru/skills.md#where-skills-live), который объявляет `hooks` в своём frontmatter, также теряет предварительное одобрение [`allowed-tools`](https://code.claude.com/docs/ru/skills#pre-approve-tools-for-a-skill), поэтому ваши пользователи будут получать запросы разрешения для инструментов, перечисленных в этом поле. Когда такой skill запускается в субагенте через [`context: fork`](https://code.claude.com/docs/ru/skills#run-skills-in-a-subagent), он сохраняет предварительное одобрение. Skill, который не объявляет `hooks`, также сохраняет своё предварительное одобрение.4232Личный или проектный [скилл](https://code.claude.com/docs/ru/skills.md#where-skills-live), объявляющий `hooks` в своём frontmatter, также теряет предварительное одобрение [`allowed-tools`](https://code.claude.com/docs/ru/skills#pre-approve-tools-for-a-skill), поэтому ваши пользователи получают запросы разрешения для инструментов, перечисленных в этом поле. Когда такой скилл выполняется в субагенте через [`context: fork`](https://code.claude.com/docs/ru/skills#run-skills-in-a-subagent), он сохраняет предварительное одобрение. Скилл, не объявляющий `hooks`, тоже сохраняет предварительное одобрение.

4171 4233 

4172* **Scope**: [`Managed`](#scopes)4234* **Область действия**: [`Managed`](#scopes)

4173* **Type**: строка `"hooks"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)4235* **Тип**: строка `"hooks"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)

4174* **Default**: не заблокировано4236* **По умолчанию**: не заблокировано

4175 4237 

4176```json managed-settings.json theme={null}4238```json managed-settings.json theme={null}

4177{4239{


4181 4243 

4182### `strictPluginOnlyCustomization.mcp`4244### `strictPluginOnlyCustomization.mcp`

4183 4245 

4184Заблокируйте интерфейс `mcp`. Claude Code прекращает загрузку MCP-серверов из `~/.claude.json` и `.mcp.json`. Он продолжает загружать серверы [`managed-mcp.json`](https://code.claude.com/docs/ru/managed-mcp), серверы из [`managedMcpServers`](#managedmcpservers) и MCP-серверы из плагинов, кроме [плагинов из каталога skills](https://code.claude.com/docs/ru/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings).4246Блокирует интерфейс `mcp`. Claude Code прекращает загружать MCP-серверы из `~/.claude.json` и `.mcp.json`. Он продолжает загружать серверы из [`managed-mcp.json`](https://code.claude.com/docs/ru/managed-mcp), серверы из [`managedMcpServers`](#managedmcpservers) и MCP-серверы из плагинов, кроме [плагинов из каталога скиллов](https://code.claude.com/docs/ru/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings).

4185 4247 

4186* **Scope**: [`Managed`](#scopes)4248* **Область действия**: [`Managed`](#scopes)

4187* **Type**: строка `"mcp"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)4249* **Тип**: строка `"mcp"` в массиве [`strictPluginOnlyCustomization`](#strictpluginonlycustomization)

4188* **Default**: не заблокировано4250* **По умолчанию**: не заблокировано

4189 4251 

4190```json managed-settings.json theme={null}4252```json managed-settings.json theme={null}

4191{4253{


4195 4257 

4196### `enabledPlugins`4258### `enabledPlugins`

4197 4259 

4198Включайте или отключайте отдельные [plugins](https://code.claude.com/docs/ru/plugins/overview.md), обозначенные как `plugin-name@marketplace-name`. Плагин без записи в любой области возвращается к его значению [`defaultEnabled`](https://code.claude.com/docs/ru/plugins/manifest-reference#fields). Когда вы включаете или отключаете плагин с помощью `/plugin` или `claude plugin enable`, Claude Code записывает этот ключ для вас.4260Включает или отключает отдельные [плагины](https://code.claude.com/docs/ru/plugins/overview.md) по ключу `plugin-name@marketplace-name`. Плагин, для которого нет записи ни на одном уровне, использует своё значение [`defaultEnabled`](https://code.claude.com/docs/ru/plugins/manifest-reference#fields). Когда вы включаете или отключаете плагин с помощью `/plugin` или `claude plugin enable`, Claude Code записывает этот ключ за вас.

4199 4261 

4200* **Scope**: [`Any file`](#scopes)4262* **Область действия**: [`Any file`](#scopes)

4201* **Type**: объект, отображающий `plugin-name@marketplace-name` на Boolean4263* **Тип**: объект, сопоставляющий `plugin-name@marketplace-name` со значением Boolean

4202* **Default**: не установлено, поэтому каждый плагин следует его значению `defaultEnabled`4264* **По умолчанию**: не задано, поэтому каждый плагин следует своему значению `defaultEnabled`

4203 4265 

4204Этот пример включает два плагина из маркетплейса `team-tools` и отключает один из `personal`:4266В этом примере включаются два плагина из маркетплейса `team-tools` и отключается один из `personal`:

4205 4267 

4206```json settings.json theme={null}4268```json settings.json theme={null}

4207{4269{


4213}4275}

4214```4276```

4215 4277 

4216Каждая область служит разной цели:4278Каждый уровень служит своей цели:

4217 

4218* **User settings**: ваши личные предпочтения плагинов

4219* **Project settings**: плагины, общие со всеми в репозитории

4220* **Local settings**: переопределения для каждой машины, игнорируемые, когда Claude Code сохраняет параметр там

4221* **Managed settings**: организационная политика. Плагин, установленный на `false` здесь, заблокирован от установки в каждой области и скрыт из маркетплейса

4222 4279 

4223Параметры проекта имеют приоритет над параметрами пользователя, поэтому установка плагина на `false` в `~/.claude/settings.json` не отключает плагин, который `.claude/settings.json` проекта включает. Чтобы отказаться от плагина, включённого проектом, на вашей машине, установите его на `false` в `.claude/settings.local.json` вместо этого. Плагины, принудительно включённые управляемыми параметрами, не могут быть отключены таким образом, так как управляемые параметры переопределяют локальные параметры.4280* **Пользовательские настройки**: ваши личные предпочтения по плагинам

4281* **Настройки проекта**: плагины, включённые для всех в репозитории. Это не устанавливает их, поэтому каждый пользователь [устанавливает их сам](https://code.claude.com/docs/ru/plugins/org.md#require-plugins-per-repository).

4282* **Локальные настройки**: переопределения для отдельного компьютера, которые исключаются из Git через gitignore, когда Claude Code сохраняет туда настройку

4283* **Управляемые настройки**: политика на уровне всей организации. Плагин со значением `false` здесь блокируется от установки на любом уровне и скрывается из маркетплейса

4224 4284 

4225Включение плагина из внешнего источника, такого как репозиторий GitHub или пакет npm, в `.claude/settings.json` проекта не устанавливает его для других людей. На каждом пути, который загружает плагины, Claude Code сообщает о плагине как не установленном до тех пор, пока каждый пользователь [не установит его сам](https://code.claude.com/docs/ru/plugins/org.md#require-plugins-per-repository).4285Настройки проекта имеют приоритет над пользовательскими настройками, поэтому значение `false` для плагина в `~/.claude/settings.json` не отключает плагин, который включён в `.claude/settings.json` проекта. Чтобы отказаться от плагина, включённого проектом, на своём компьютере, задайте ему значение `false` в `.claude/settings.local.json`. Плагины, принудительно включённые управляемыми настройками, нельзя отключить таким способом, поскольку управляемые настройки переопределяют локальные.

4226 4286 

4227### `extraKnownMarketplaces`4287### `extraKnownMarketplaces`

4228 4288 

4229Регистрируйте дополнительные маркетплейсы плагинов по имени, чтобы люди, которые открывают репозиторий, или все, кого достигают ваши управляемые параметры, получали маркетплейс без добавления его самостоятельно. Claude Code регистрирует каждый маркетплейс, который он ещё не знает. Устанавливается ли плагин, который [`enabledPlugins`](#enabledplugins) называет из него, зависит от источника плагина и какой файл его включает; эта запись имеет правила.4289Регистрирует дополнительные маркетплейсы плагинов по имени, чтобы пользователи, открывающие репозиторий, или все, на кого распространяются ваши управляемые настройки, получали маркетплейс без самостоятельного добавления. Claude Code регистрирует каждый маркетплейс, который ему ещё не известен. Установится ли плагин из него, указанный в [`enabledPlugins`](#enabledplugins), зависит от источника плагина и от того, какой файл его включает; правила приведены в разделе [Включён в настройках проекта, но не установлен](https://code.claude.com/docs/ru/plugins/loading.md#enabled-in-project-settings-but-not-installed).

4230 4290 

4231* **Scope**: [`Any file`](#scopes). Claude Code учитывает записи в `.claude/settings.json` или `.claude/settings.local.json` репозитория только после того, как вы примете диалог доверия рабочей области для этой папки; в папке, которую вы не доверяете, включая запуск `-p` там, он игнорирует их без сообщения.4291* **Область действия**: [`Any file`](#scopes). Claude Code учитывает записи в `.claude/settings.json` или `.claude/settings.local.json` репозитория только после того, как вы примете диалог доверия рабочему пространству для этой папки; в папке, которой вы не доверяете, включая запуск `-p` в ней, он игнорирует их без сообщения.

4232* **Type**: объект, отображающий имя маркетплейса на объект с объектом `source` и необязательным Boolean `autoUpdate`4292* **Тип**: объект, сопоставляющий имя маркетплейса с объектом, содержащим объект `source` и необязательное значение Boolean `autoUpdate`

4233* **Default**: не установлено4293* **По умолчанию**: не задано

4234 4294 

4235Этот пример регистрирует маркетплейс GitHub и маркетплейс из самостоятельно размещённого git URL:4295В этом примере регистрируются маркетплейс GitHub и маркетплейс из git URL на собственном сервере:

4236 4296 

4237```json settings.json theme={null}4297```json settings.json theme={null}

4238{4298{


4253}4313}

4254```4314```

4255 4315 

4256[Что работает перед тем, как вы доверяете папке](https://code.claude.com/docs/ru/permissions.md#what-runs-before-you-trust-a-folder), сравнивает ворота доверия с другим содержимым, которое репозиторий может предоставить. Вы также можете написать этот ключ как `additionalMarketplaces`; см. [Псевдонимы ключей маркетплейса](#marketplace-key-aliases).4316В разделе [Что выполняется до того, как вы доверитесь папке](https://code.claude.com/docs/ru/permissions.md#what-runs-before-you-trust-a-folder) проверка доверия сравнивается с другим содержимым, которое может предоставить репозиторий. Этот ключ также можно записать как `additionalMarketplaces`; см. [Псевдонимы ключей маркетплейсов](#marketplace-key-aliases).

4257 4317 

4258Установите `"autoUpdate": true` рядом с `source`, чтобы Claude Code обновлял этот маркетплейс и обновлял его установленные плагины в фоне после запуска. Если опущено, `claude-plugins-official` и большинство других официальных маркетплейсов Anthropic по умолчанию имеют `true`, а маркетплейсы третьих сторон по умолчанию имеют `false`. См. [Настройте автоматические обновления](https://code.claude.com/docs/ru/plugins/install.md#keep-plugins-updated).4318Задайте `"autoUpdate": true` рядом с `source`, чтобы Claude Code обновлял этот маркетплейс и его установленные плагины в фоновом режиме после запуска. Если значение не указано, для `claude-plugins-official` и большинства других официальных маркетплейсов Anthropic по умолчанию используется `true`, а для сторонних маркетплейсов — `false`. См. [Настройка автообновлений](https://code.claude.com/docs/ru/plugins/install.md#keep-plugins-updated).

4259 4319 

4260Когда более одного файла параметров определяет запись маркетплейса под одним и тем же именем, Claude Code использует запись из [файла с наивысшим приоритетом](https://code.claude.com/docs/ru/settings.md#settings-precedence) целиком. Эта запись заменяет запись с более низким приоритетом и не наследует ни одно из её полей, поэтому переопределение не может объединить `source.headers` учётные данные одного файла с URL, который контролирует другой файл. До v2.1.228, Claude Code объединял записи с одним и тем же именем поле за полем, поэтому запись в файле с более высоким приоритетом могла наследовать поля, которые она не установила, включая `headers` другого файла.4320Если несколько файлов настроек определяют запись маркетплейса под одним и тем же именем, Claude Code целиком использует запись из [файла с наивысшим приоритетом](https://code.claude.com/docs/ru/settings.md#settings-precedence). Эта запись заменяет запись с более низким приоритетом и не наследует ни одного из её полей, поэтому переопределение не может объединить учётные данные `source.headers` из одного файла с URL, контролируемым другим файлом. До v2.1.228 Claude Code объединял одноимённые записи поле за полем, поэтому запись в файле с более высоким приоритетом могла наследовать поля, которые она не задавала, включая `headers` другого файла.

4261 4321 

4262#### Marketplace source types4322#### Типы источников маркетплейсов

4263 4323 

4264Объект `source` принимает одну из этих форм:4324Объект `source` принимает одну из следующих форм:

4265 4325 

4266* **`github`**: репозиторий GitHub, с `repo`4326* **`github`**: репозиторий GitHub, с `repo`

4267* **`git`**: любой git URL, с `url`4327* **`git`**: любой git URL, с `url`

4268* **`url`**: прямой URL к файлу `marketplace.json`, с `url` и необязательными `headers` и `headersHelper` для аутентифицированного доступа. `headersHelper` называет команду, которая печатает заголовки, чьи значения слишком недолговечны для перечисления в `headers`, и требует Claude Code v2.1.238 или позже4328* **`url`**: прямой URL к файлу `marketplace.json`, с `url` и необязательными `headers` и `headersHelper` для доступа с аутентификацией. `headersHelper` указывает команду, которая выводит заголовки, значения которых слишком недолговечны, чтобы перечислить их в `headers`, и требует Claude Code v2.1.238 или новее

4269* **`file`**: локальный путь к файлу `marketplace.json`, с `path`4329* **`file`**: локальный путь к файлу `marketplace.json`, с `path`

4270* **`directory`**: локальный путь файловой системы, с `path`. Используйте его для разработки или для маркетплейса, который ваша организация [развёртывает на каждой машине](https://code.claude.com/docs/ru/plugins/mods/admin.md#install-your-organizations-mods).4330* **`directory`**: локальный путь в файловой системе, с `path`. Используйте его для разработки или для маркетплейса, который ваша организация [развёртывает на каждом компьютере](https://code.claude.com/docs/ru/plugins/mods/admin.md#install-your-organizations-mods).

4271* **`settings`**: встроенный маркетплейс, объявленный непосредственно в файле параметров без размещённого репозитория, с `name` и `plugins`4331* **`settings`**: встроенный маркетплейс, объявленный непосредственно в файле настроек без размещённого репозитория, с `name` и `plugins`

4272 4332 

4273Тип источника `git` работает с любым сервисом размещения git, включая самостоятельно размещённые GitLab и Bitbucket. Claude Code клонирует репозиторий с той же аутентификацией, которую использовал бы `git clone` на этой машине: настроенные помощники учётных данных или ключи SSH. Токен поставщика, такой как `GITHUB_TOKEN`, вступает в силу через помощника учётных данных, который его читает. См. [Приватные репозитории](https://code.claude.com/docs/ru/plugins/host-marketplace.md#grant-access-to-a-private-marketplace) для деталей настройки.4333Тип источника `git` работает с любым сервисом хостинга git, включая GitLab и Bitbucket на собственных серверах. Claude Code клонирует репозиторий с той же аутентификацией, которую использовал бы `git clone` на этом компьютере: с настроенными помощниками учётных данных или SSH-ключами. Токен провайдера, например `GITHUB_TOKEN`, вступает в силу через помощник учётных данных, который его считывает. Подробности настройки см. в разделе [Частные репозитории](https://code.claude.com/docs/ru/plugins/host-marketplace.md#grant-access-to-a-private-marketplace).

4274 4334 

4275Для источников `github` и `git`, Claude Code никогда не загружает содержимое [Git LFS](https://git-lfs.com) при клонировании репозитория маркетплейса для добавления или обновления. Файлы, отслеживаемые LFS, проверяются как файлы указателей, и вывод добавления или обновления сообщает, сколько их.4335Для источников `github` и `git` Claude Code никогда не загружает содержимое [Git LFS](https://git-lfs.com) при клонировании репозитория маркетплейса для его добавления или обновления. Файлы, отслеживаемые LFS, извлекаются как файлы-указатели, а вывод добавления или обновления сообщает, сколько их.

4276 4336 

4277Поле `skipLfs` внутри объекта `source` принимается и не имеет эффекта. До v2.1.274, Claude Code загружал содержимое LFS, если вы не установили `"skipLfs": true`.4337Поле `skipLfs` внутри объекта `source` принимается, но не действует. До v2.1.274 Claude Code загружал содержимое LFS, если только вы не задавали `"skipLfs": true`.

4278 4338 

4279Для источника `url`, установите `headersHelper` внутри объекта `source`, когда учётные данные в `headers` истекают и команда должна произвести свежие. Требуется Claude Code v2.1.238 или позже. Для того, что команда должна печатать и где Claude Code её запускает, см. [Напишите команду headersHelper](https://code.claude.com/docs/ru/plugins/host-marketplace.md#write-the-headershelper-command), и для случаев, когда Claude Code её не запускает, см. [Когда Claude Code пропускает команду headersHelper](https://code.claude.com/docs/ru/plugins/host-marketplace.md#when-claude-code-skips-a-headershelper-command-or-drops-its-output). Как только вы установите `headersHelper` на URL маркетплейса `https://`, Claude Code запускает команду в двух точках, повторно используя вывод одного запуска в течение до 60 секунд:4339Для источника `url` задайте `headersHelper` внутри объекта `source`, когда учётные данные в `headers` истекают и новые должна выдавать команда. Требуется Claude Code v2.1.238 или новее. О том, что должна выводить команда и где Claude Code её запускает, см. [Написание команды headersHelper](https://code.claude.com/docs/ru/plugins/host-marketplace.md#write-the-headershelper-command), а о случаях, когда Claude Code её не запускает, — [Когда Claude Code пропускает команду headersHelper](https://code.claude.com/docs/ru/plugins/host-marketplace.md#when-claude-code-skips-a-headershelper-command-or-drops-its-output). Когда вы задаёте `headersHelper` для URL маркетплейса `https://`, Claude Code запускает команду в двух случаях, повторно используя вывод одного запуска в течение до 60 секунд:

4280 4340 

4281* Перед каждой выборкой `marketplace.json` этого маркетплейса, включая более позднее обновление. Claude Code отправляет напечатанные заголовки с этой выборкой.4341* Перед каждым получением `marketplace.json` этого маркетплейса, включая последующее обновление. Claude Code отправляет выведенные заголовки вместе с этим получением.

4282* Перед каждой загрузкой архива плагина на происхождение URL маркетплейса, означая ту же схему, хост и порт. Claude Code отправляет вывод с этой загрузкой, и никакая другая загрузка не получает заголовки.4342* Перед каждой загрузкой архива плагина с источника (origin) URL маркетплейса, то есть с той же схемой, хостом и портом. Claude Code отправляет вывод вместе с этой загрузкой, и никакая другая загрузка заголовков не получает.

4283 4343 

4284Claude Code игнорирует любой `headersHelper`, установленный в `.claude/settings.json` или `.claude/settings.local.json` каталога, который вы добавляете с [`--add-dir`](https://code.claude.com/docs/ru/permissions#what-runs-before-you-trust-a-folder), на источнике `url` и на встроенной записи плагина, и отправляет только фиксированные `headers`, установленные в этом файле. [Как пользователи принимают команду headersHelper](https://code.claude.com/docs/ru/plugins/host-marketplace.md#how-users-accept-a-headershelper-command) охватывает другие файлы параметров.4344Claude Code игнорирует любой `headersHelper`, заданный в `.claude/settings.json` или `.claude/settings.local.json` каталога, добавленного вами с помощью [`--add-dir`](https://code.claude.com/docs/ru/permissions#what-runs-before-you-trust-a-folder), — как для источника `url`, так и для встроенной записи плагина — и отправляет только фиксированные `headers`, заданные в этом файле. Другие файлы настроек описаны в разделе [Как пользователи принимают команду headersHelper](https://code.claude.com/docs/ru/plugins/host-marketplace.md#how-users-accept-a-headershelper-command).

4285 4345 

4286Плагины, перечисленные в источнике `settings`, должны ссылаться на внешние источники, такие как GitHub или npm, и `name` должен совпадать с ключом маркетплейса. Вы всё ещё включаете каждый плагин отдельно в `enabledPlugins`. Этот пример объявляет один плагин встроенным:4346Плагины, перечисленные в источнике `settings`, должны ссылаться на внешние источники, такие как GitHub или npm, а `name` должно совпадать с ключом маркетплейса. Каждый плагин по-прежнему нужно отдельно включить в `enabledPlugins`. В этом примере один плагин объявляется встроенно:

4287 4347 

4288```json settings.json theme={null}4348```json settings.json theme={null}

4289{4349{


4307}4367}

4308```4368```

4309 4369 

4310Запись плагина под `source: 'settings'`, чей собственный `source` — это [`archive`](https://code.claude.com/docs/ru/plugins/marketplace-reference#archive-plugin-source), может установить `headers` для загрузки архива. Если значение, которое вы поместили бы в `headers`, недолговечно, такое как токен, который ваш реестр чеканит по запросу, установите вместо этого команду `headersHelper`. Запись может установить оба. Оба поля требуют Claude Code v2.1.238 или позже.4370Запись плагина в `source: 'settings'`, собственный `source` которой — [`archive`](https://code.claude.com/docs/ru/plugins/marketplace-reference#archive-plugin-source), может задавать `headers` для загрузки архива. Если значение, которое вы поместили бы в `headers`, недолговечно, например токен, который ваш реестр выпускает по запросу, задайте вместо этого команду `headersHelper`. Запись может задавать оба поля. Оба поля требуют Claude Code v2.1.238 или новее.

4311 4371 

4312Claude Code отправляет `headers` записи и всё, что печатает команда, с загрузкой архива этого плагина и ни с какой другой загрузкой. Claude Code запускает команду только когда пользователь [устанавливает или обновляет только этот один плагин](https://code.claude.com/docs/ru/plugins/host-marketplace.md#how-users-accept-a-headershelper-command). Три дополнительных правила зависят от того, какой файл содержит запись:4372Claude Code отправляет `headers` записи и всё, что выводит команда, вместе с загрузкой архива этого плагина и ни с какой другой загрузкой. Claude Code запускает команду, только когда пользователь [устанавливает или обновляет этот плагин отдельно](https://code.claude.com/docs/ru/plugins/host-marketplace.md#how-users-accept-a-headershelper-command). Ещё три правила зависят от того, в каком файле находится запись:

4313 4373 

4314* **`strict`**: в отличие от записи в `marketplace.json` маркетплейса, запись в параметрах не нуждается в `"strict": false`, потому что файл параметров не содержит полей манифеста для встраивания. См. [Strict mode](https://code.claude.com/docs/ru/plugins/marketplace-reference.md#strict-mode).4374* **`strict`**: в отличие от записи в `marketplace.json` маркетплейса, записи в настройках не нужен `"strict": false`, поскольку файл настроек не содержит полей манифеста для встраивания. См. [Строгий режим](https://code.claude.com/docs/ru/plugins/marketplace-reference.md#strict-mode).

4315* **Folder trust**: для записи в `.claude/settings.json` или `.claude/settings.local.json` проекта, Claude Code запускает команду только после того, как пользователь также [доверил эту папку](https://code.claude.com/docs/ru/permissions.md#what-runs-before-you-trust-a-folder).4375* **Доверие к папке**: для записи в `.claude/settings.json` или `.claude/settings.local.json` проекта Claude Code запускает команду только после того, как пользователь также [доверился этой папке](https://code.claude.com/docs/ru/permissions.md#what-runs-before-you-trust-a-folder).

4316* **Header filter**: Claude Code удаляет [имена заголовков маршрутизации запросов и идентификации клиента](https://code.claude.com/docs/ru/plugins/host-marketplace.md#when-claude-code-skips-a-headershelper-command-or-drops-its-output) из записи в `.claude/settings.json` или `.claude/settings.local.json` проекта, потому что репозиторий может предоставить эти файлы. Claude Code применяет тот же фильтр к записи каталога и к записи в каталоге `--add-dir`, и никакой фильтр к записи в ваши пользовательские параметры, файл `--settings` или управляемые параметры.4376* **Фильтр заголовков**: Claude Code удаляет [имена заголовков маршрутизации запросов и идентификации клиента](https://code.claude.com/docs/ru/plugins/host-marketplace.md#when-claude-code-skips-a-headershelper-command-or-drops-its-output) из записи в `.claude/settings.json` или `.claude/settings.local.json` проекта, поскольку эти файлы может предоставить репозиторий. Claude Code применяет тот же фильтр к записи каталога и к записи в настройках каталога `--add-dir` и не применяет никакого фильтра к записи в ваших пользовательских настройках, файле `--settings` или управляемых настройках.

4317 4377 

4318#### Marketplace key aliases4378#### Псевдонимы ключей маркетплейсов

4319 4379 

4320На Claude Code v2.1.232 или позже, вы можете написать `extraKnownMarketplaces` как `additionalMarketplaces` и `strictKnownMarketplaces` как `allowedMarketplaces`. Claude Code рассматривает каждый псевдоним следующим образом:4380В Claude Code v2.1.232 или новее можно записывать `extraKnownMarketplaces` как `additionalMarketplaces`, а `strictKnownMarketplaces` как `allowedMarketplaces`. Claude Code обрабатывает каждый псевдоним следующим образом:

4321 4381 

4322* Более ранние версии игнорируют псевдоним, поэтому сохраняйте каноническое написание в файле, который также читают более старые версии, такой как файл управляемых параметров для флота со смешанными версиями Claude Code.4382* Более ранние версии игнорируют псевдоним, поэтому сохраняйте каноническое написание в файле, который читают и более старые версии, например в файле управляемых настроек для парка компьютеров со смешанными версиями Claude Code.

4323* В любом файле параметров, который принимает канонический ключ, Claude Code читает псевдоним точно так же, как читает канонический ключ.4383* В любом файле настроек, принимающем канонический ключ, Claude Code читает псевдоним точно так же, как канонический ключ.

4324* Claude Code может переписать `additionalMarketplaces` на `extraKnownMarketplaces` при обновлении файла.4384* Claude Code может переписать `additionalMarketplaces` на `extraKnownMarketplaces` при обновлении файла.

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

4326 4386 

4327### `pluginConfigs`4387### `pluginConfigs`

4328 4388 

4329Сохраняйте нечувствительные ответы, которые вы даёте диалогу конфигурации [`userConfig`](https://code.claude.com/docs/ru/plugins/manifest-reference#user-configuration) плагина, обозначенные по ID плагина. Claude Code записывает этот ключ в ваши пользовательские параметры при заполнении диалога, поэтому вам не нужно редактировать его вручную. Claude Code сохраняет чувствительные параметры в macOS Keychain вместо этого, возвращаясь к `~/.claude/.credentials.json`, когда Keychain отклоняет запись; на платформах без поддерживаемого keychain, он сохраняет их в `~/.claude/.credentials.json`.4389Хранит нечувствительные ответы, которые вы даёте в диалоге конфигурации [`userConfig`](https://code.claude.com/docs/ru/plugins/manifest-reference#user-configuration) плагина, по ключу ID плагина. Claude Code записывает этот ключ в ваши пользовательские настройки, когда вы заполняете диалог, поэтому редактировать его вручную не нужно. Чувствительные параметры Claude Code вместо этого хранит в macOS Keychain, а если Keychain отклоняет запись, использует `~/.claude/.credentials.json`; на платформах без поддерживаемого хранилища ключей он хранит их в `~/.claude/.credentials.json`.

4330 4390 

4331* **Scope**: [`User or managed`](#scopes)4391* **Область действия**: [`User or managed`](#scopes)

4332* **Type**: объект, отображающий ID плагина на объект с полем `options`, отображающим каждое имя параметра на строку, число, Boolean или массив строк, и необязательное поле `mcpServers`, содержащее значения конфигурации пользователя для каждого сервера в той же форме4392* **Тип**: объект, сопоставляющий ID плагина с объектом, содержащим поле `options`, которое сопоставляет имя каждого параметра со строкой, числом, значением Boolean или массивом строк, и необязательное поле `mcpServers` со значениями пользовательской конфигурации для каждого сервера в той же форме

4333* **Default**: не установлено4393* **По умолчанию**: не задано

4334 4394 

4335Этот пример сохраняет параметр `api_endpoint` для плагина `deployer` из `acme-tools`:4395В этом примере хранится параметр `api_endpoint` для плагина `deployer` из `acme-tools`:

4336 4396 

4337```json settings.json theme={null}4397```json settings.json theme={null}

4338{4398{


4346}4406}

4347```4407```

4348 4408 

4349Встроенные плагины хранят свои параметры в том же ключе с суффиксом `@builtin`. Например, настройка [**Project instructions**](https://code.claude.com/docs/ru/memory.md#choose-which-instruction-files-load), которая определяет, читает ли Claude Code файлы `AGENTS.md`, — это `pluginConfigs["cc-plugin-agents-md@builtin"].options.instructionFiles`. До v2.1.285 ID этого плагина был `agents-md@builtin`. Более поздние версии читают запись под любым из этих ID.4409Встроенные плагины хранят свои параметры под тем же ключом с суффиксом `@builtin`. Например, настройка [**Project instructions**](https://code.claude.com/docs/ru/memory.md#choose-which-instruction-files-load), определяющая, читает ли Claude Code файлы `AGENTS.md`, — это `pluginConfigs["cc-plugin-agents-md@builtin"].options.instructionFiles`. До v2.1.285 ID плагина был `agents-md@builtin`. Более поздние версии читают запись под любым из этих ID.

4350 4410 

4351Claude Code игнорирует записи проекта и локальные записи, потому что подставляет эти значения в конфигурации хуков, MCP и LSP плагина, а клонированный репозиторий не должен иметь возможности их предоставить.4411Claude Code игнорирует проектные и локальные записи, поскольку подставляет эти значения в конфигурации хуков, MCP и LSP плагинов, а клонированный репозиторий не должен иметь возможности их предоставлять.

4352 4412 

4353### `prependPlugins`4413### `prependPlugins`

4354 4414 

4355Перечислите управляемые плагины, чьи [mods](https://code.claude.com/docs/ru/plugins/mods/overview.md) запускаются перед каждым mod, который устанавливает пользователь, в указанном порядке. Когда вы установите этот ключ в управляемых параметрах, назовите `sec-default@builtin` в списке, чтобы сохранить встроенную защиту. В управляемых параметрах Claude Code пропускает id, чей плагин не считается плагином вашей организации. См. [Установка модов вашей организации и установка порядка](https://code.claude.com/docs/ru/plugins/mods/admin.md#install-your-organizations-mods) для этих условий и для того, как два ключа упорядочения работают вместе.4415Перечисляет управляемые плагины, [моды](https://code.claude.com/docs/ru/plugins/mods/overview.md) которых выполняются перед каждым модом, установленным пользователем, в указанном порядке. Задавая этот ключ в управляемых настройках, укажите в списке `sec-default@builtin`, чтобы сохранить встроенный страж. В управляемых настройках Claude Code пропускает ID, плагин которого не считается плагином вашей организации. Об этих условиях и о том, как два ключа порядка работают вместе, см. [Установка модов вашей организации и задание порядка](https://code.claude.com/docs/ru/plugins/mods/admin.md#install-your-organizations-mods).

4356 4416 

4357* **Scope**: [`User or managed`](#scopes). Claude Code читает ключ из управляемых настроек. Из пользовательских настроек он читает ключ только на машине без управляемых настроек и в сессии, учётные данные которой получены не через `/login` с планом Team или Enterprise. Он игнорирует ключ в настройках проекта, локальных настройках и в файле `--settings`.4417* **Область действия**: [`User or managed`](#scopes). Claude Code читает ключ из управляемых настроек. Из пользовательских настроек он читает ключ только на компьютере без управляемых настроек и без файла `managed-mcp.json`, в сессии, учётные данные которой не являются `/login` Team или Enterprise. Он игнорирует ключ в проектных и локальных настройках, а также в файле `--settings`.

4358* **Type**: массив строк `plugin-name@marketplace-name`4418* **Тип**: массив строк `plugin-name@marketplace-name`

4359* **Default**: не установлено4419* **По умолчанию**: не задано

4360 4420 

4361```json managed-settings.json theme={null}4421```json managed-settings.json theme={null}

4362{4422{


4372 4432 

4373### `appendPlugins`4433### `appendPlugins`

4374 4434 

4375Перечислите управляемые плагины, чьи [mods](https://code.claude.com/docs/ru/plugins/mods/overview.md) запускаются после каждого mod, который устанавливает пользователь, в указанном порядке. Id, перечисленный в обоих `prependPlugins` и `appendPlugins`, добавляется в начало. В управляемых параметрах Claude Code пропускает id, чей плагин не [считается плагином вашей организации](https://code.claude.com/docs/ru/plugins/mods/admin.md#install-your-organizations-mods).4435Перечисляет управляемые плагины, [моды](https://code.claude.com/docs/ru/plugins/mods/overview.md) которых выполняются после каждого мода, установленного пользователем, в указанном порядке. ID, указанный и в `prependPlugins`, и в `appendPlugins`, добавляется в начало. В управляемых настройках Claude Code пропускает ID, плагин которого не [считается плагином вашей организации](https://code.claude.com/docs/ru/plugins/mods/admin.md#install-your-organizations-mods).

4376 4436 

4377* **Scope**: [`User or managed`](#scopes). Claude Code читает ключ из управляемых настроек. Из пользовательских настроек он читает ключ только на машине без управляемых настроек и в сессии, учётные данные которой получены не через `/login` с планом Team или Enterprise. Он игнорирует ключ в настройках проекта, локальных настройках и в файле `--settings`.4437* **Область действия**: [`User or managed`](#scopes). Claude Code читает ключ из управляемых настроек. Из пользовательских настроек он читает ключ только на компьютере без управляемых настроек и без файла `managed-mcp.json`, в сессии, учётные данные которой не являются `/login` Team или Enterprise. Он игнорирует ключ в проектных и локальных настройках, а также в файле `--settings`.

4378* **Type**: массив строк `plugin-name@marketplace-name`4438* **Тип**: массив строк `plugin-name@marketplace-name`

4379* **Default**: не установлено4439* **По умолчанию**: не задано

4380 4440 

4381```json managed-settings.json theme={null}4441```json managed-settings.json theme={null}

4382{4442{


4612 4672 

4613### `crossSessionInbound`4673### `crossSessionInbound`

4614 4674 

4615Выберите, что эта сессия делает с [сообщениями, поступающими из ваших других сессий Claude Code](https://code.claude.com/docs/ru/cross-session-messaging.md#control-inbound-messages). Когда ни одно значение не применяется, Claude Code решает для каждого сообщения на основе классов режима разрешений двух сессий. Требуется Claude Code v2.1.224 или позже.4675Выберите, что эта сессия делает с [сообщениями, поступающими из ваших других сессий Claude Code](https://code.claude.com/docs/ru/cross-session-messaging.md#control-inbound-messages). Когда ни одно значение не применяется, Claude Code решает для каждого сообщения на основе классов режима разрешений двух сессий.

4616 4676 

4617* **Scope**: [`Any file`](#scopes). Значение проекта или локальное значение применяется только в том случае, если оно строже, чем значение управляемых настроек, флага `--settings` или пользовательских настроек.4677* **Scope**: [`Any file`](#scopes). Значение проекта или локальное значение применяется только в том случае, если оно строже, чем значение управляемых настроек, флага `--settings` или пользовательских настроек.

4618* **Type**: string, один из:4678* **Type**: string, один из:


4946}5006}

4947```5007```

4948 5008 

5009### `disableRemotePreviewScripts`

5010 

5011Запретить выполнение скриптов, когда пользователи [просматривают HTML-файл](https://code.claude.com/docs/ru/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) из сессии SSH или WSL в настольном приложении. Внешний просмотр веб-страниц на панели Browser не затрагивается.

5012 

5013Настольное приложение читает этот ключ; терминальный CLI его игнорирует. Требуется Claude Desktop v5.1231.0 или новее. Более ранние версии игнорируют ключ: чтобы остановить скрипты в них, также установите [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation), который заодно отключает и внешний просмотр веб-страниц.

5014 

5015* **Scope**: [`Managed`](#scopes). Настольное приложение не читает ключ с удалённой машины или из дистрибутива WSL.

5016* **Type**: Boolean; действует только JSON Boolean `true`

5017 * `true`: предпросмотр HTML в сессиях SSH и WSL не выполняет скрипты

5018 * `false`: ключ не отключает скрипты

5019* **Default**: не установлено, поэтому ключ ни на что не влияет

5020 

5021Если компьютер, на котором работает настольное приложение, не получает никаких других управляемых настроек Claude Code, также установите [`parentSettingsBehavior`](#parentsettingsbehavior) в `"merge"` в создаваемых вами управляемых настройках. На Windows, если вы создаёте файл управляемых настроек, пользователи также теряют сессии WSL, пока вы [не разрешите их](https://code.claude.com/docs/ru/admin-setup.md#wsl-sessions-in-claude-code-desktop). [Turn off scripts in SSH and WSL previews for your organization](https://code.claude.com/docs/ru/desktop.md#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) объясняет оба момента и указывает, где задать ключ.

5022 

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

5024 

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

5026{

5027 "disableRemotePreviewScripts": true

5028}

5029```

5030 

5031Настольное приложение игнорирует любое другое значение, а значение, которое не является Boolean, например строка `"true"` или `1`, также приводит к записи предупреждения в лог.

5032 

4949### `enableArtifact`5033### `enableArtifact`

4950 5034 

4951Отключить инструмент [Artifact](https://code.claude.com/docs/ru/artifacts.md), который публикует выходные данные сессии как приватную веб-страницу на claude.ai. Когда вы отключаете строку **Artifacts** в `/config`, Claude Code записывает этот ключ в ваши пользовательские настройки, поэтому вы обычно не редактируете его вручную.5035Отключить инструмент [Artifact](https://code.claude.com/docs/ru/artifacts.md), который публикует выходные данные сессии как приватную веб-страницу на claude.ai. Когда вы отключаете строку **Artifacts** в `/config`, Claude Code записывает этот ключ в ваши пользовательские настройки, поэтому вы обычно не редактируете его вручную.


5219 5303 

5220### `forceLoginMethod`5304### `forceLoginMethod`

5221 5305 

5222Ограничьте, с каким типом учётной записи люди могут входить. Установите `"claudeai"`, чтобы разрешить только учётные записи claude.ai, `"console"`, чтобы разрешить только учётные записи Claude Console, или `"gateway"`, чтобы направлять людей на [облачный шлюз](https://code.claude.com/docs/ru/claude-apps-gateway) вместо входа первой стороны. Администраторы устанавливают это в управляемых настройках и сочетают с [`forceLoginOrgUUID`](#forceloginorguuid), чтобы входы разработчиков в claude.ai оставались внутри одной организации.5306Ограничьте, с каким типом учётной записи люди могут входить: `"claudeai"` для входа через claude.ai или `"console"` для входа через Claude Console. Установите `"gateway"`, чтобы направлять людей на [облачный шлюз](https://code.claude.com/docs/ru/claude-apps-gateway) вместо входа первой стороны. Администраторы устанавливают это в управляемых настройках и сочетают с [`forceLoginOrgUUID`](#forceloginorguuid), чтобы входы разработчиков в claude.ai оставались внутри одной организации.

5223 5307 

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

5225 5309 

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

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

5228 * `"claudeai"`: входить могут только учётные записи claude.ai5312 * `"claudeai"`: вход через claude.ai

5229 * `"console"`: входить могут только учётные записи Claude Console5313 * `"console"`: вход через Claude Console

5230 * `"gateway"`: Claude Code направляет людей на облачный шлюз вместо входа первой стороны5314 * `"gateway"`: Claude Code направляет людей на облачный шлюз вместо входа первой стороны

5231* **Default**: не установлено, поэтому люди выбирают метод входа сами5315* **Default**: не установлено, поэтому люди выбирают метод входа сами

5232 5316 


5471 5555 

5472Установите, сколько дней Claude Code хранит [стенограммы сеансов и другие данные приложения](https://code.claude.com/docs/ru/claude-directory.md#cleaned-up-automatically) перед их удалением. Claude Code выполняет удаление как фоновую очистку после запуска сеанса, при условии, что он может безопасно определить период хранения. Очистка удаляет стенограммы без отображения сообщения, поэтому сеанс, который вы не использовали дольше, чем период хранения, больше не появляется в средстве выбора [`/resume`](https://code.claude.com/docs/ru/sessions#resume-a-session).5556Установите, сколько дней Claude Code хранит [стенограммы сеансов и другие данные приложения](https://code.claude.com/docs/ru/claude-directory.md#cleaned-up-automatically) перед их удалением. Claude Code выполняет удаление как фоновую очистку после запуска сеанса, при условии, что он может безопасно определить период хранения. Очистка удаляет стенограммы без отображения сообщения, поэтому сеанс, который вы не использовали дольше, чем период хранения, больше не появляется в средстве выбора [`/resume`](https://code.claude.com/docs/ru/sessions#resume-a-session).

5473 5557 

5558По умолчанию Claude Code хранит транскрипты сессий, которые вы запустили или последними продолжили в Claude Desktop или Cowork, дольше этого периода, даже если вы сами задали этот ключ. Этот период [всё же применяется к ним в некоторых случаях](https://code.claude.com/docs/ru/claude-directory.md#cleaned-up-automatically), например в конфигурации HIPAA. До v2.1.248 Claude Code удалял их по истечении этого периода.

5559 

5474* **Область**: [`Any file`](#scopes)5560* **Область**: [`Any file`](#scopes)

5475* **Тип**: количество дней, целое число, минимум `1`5561* **Тип**: количество дней, целое число, минимум `1`

5476* **По умолчанию**: `30`5562* **По умолчанию**: `30`


5485 5571 

5486### `desktopSessionCleanupPeriodDays`5572### `desktopSessionCleanupPeriodDays`

5487 5573 

5488Установите ограничение по возрасту в днях для транскриптов сессий, которые вы запустили или последними продолжили в Claude Desktop или Cowork. Без этого ключа Claude Code [хранит эти транскрипты независимо от возраста](https://code.claude.com/docs/ru/claude-directory.md#cleaned-up-automatically). Claude Code удаляет каждый из них, как только он становится старше как этого ограничения, так и [`cleanupPeriodDays`](#cleanupperioddays), поэтому при `cleanupPeriodDays` со значением по умолчанию 30 значение `7` все равно сохраняет их 30 дней. В разделе [Автоматическая очистка](https://code.claude.com/docs/ru/claude-directory.md#cleaned-up-automatically) перечислены случаи, когда вместо этого применяется `cleanupPeriodDays`, а Claude Code игнорирует этот ключ. Требуется Claude Code v2.1.248 или более поздней версии.5574Установите ограничение по возрасту в днях для транскриптов сессий, которые вы запустили или последними продолжили в Claude Desktop или Cowork. Без этого ключа Claude Code [хранит эти транскрипты независимо от возраста](https://code.claude.com/docs/ru/claude-directory.md#cleaned-up-automatically), за исключением таких случаев, как сессия, которую вы удалили в Claude Desktop. Требуется Claude Code v2.1.248 или более поздней версии.

5575 

5576Claude Code удаляет каждый транскрипт, как только он становится старше как этого ограничения, так и [`cleanupPeriodDays`](#cleanupperioddays), поэтому при `cleanupPeriodDays` со значением по умолчанию 30 значение `7` все равно сохраняет их 30 дней. В разделе [Автоматическая очистка](https://code.claude.com/docs/ru/claude-directory.md#cleaned-up-automatically) перечислены случаи, когда вместо этого применяется `cleanupPeriodDays`, а Claude Code игнорирует этот ключ.

5489 5577 

5490* **Область**: [`User or managed`](#scopes). Claude Code также читает ключ из файла, который вы передаете с `--settings`, и игнорирует его в параметрах проекта и локальных параметрах.5578* **Область**: [`User or managed`](#scopes). Claude Code также читает ключ из файла, который вы передаете с `--settings`, и игнорирует его в параметрах проекта и локальных параметрах.

5491* **Тип**: количество дней, целое число, минимум `0`5579* **Тип**: количество дней, целое число, минимум `0`