> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Параметры Claude Code
> Настройте Claude Code с помощью глобальных и проектных параметров, а также переменных окружения.
Claude Code предлагает множество параметров для настройки его поведения в соответствии с вашими потребностями. Вы можете настроить Claude Code, выполнив команду `/config`, которая открывает интерфейс параметров с вкладками, где вы можете просмотреть информацию о состоянии и изменить параметры конфигурации. {/* min-version: 2.1.181 */}Начиная с версии 2.1.181, вы можете изменить один параметр без открытия интерфейса, передав `key=value` в `/config`, например `/config verbose=true`.
Области конфигурации
Claude Code использует систему областей для определения того, где применяются конфигурации и с кем они совместно используются. Понимание областей помогает вам решить, как настроить Claude Code для личного использования, командного сотрудничества или развертывания на уровне предприятия.
Доступные области
| Область | Местоположение | На кого это влияет | Совместно используется с командой? |
| :---------- | :-------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |
| **Managed** | Параметры, управляемые сервером, plist / реестр или системный уровень `managed-settings.json` | Все члены организации для доставки, управляемой сервером; все пользователи на машине для plist, реестра HKLM и доставки файлов; текущий пользователь для доставки реестра HKCU | Да (развернуто IT) |
| **User** | Каталог `~/.claude/` | Вы, во всех проектах | Нет |
| **Project** | `.claude/` в репозитории | Все сотрудники этого репозитория | Да (зафиксировано в git) |
| **Local** | `.claude/settings.local.json` | Вы, только в этом репозитории | Нет (игнорируется gitignore, когда Claude Code его создает) |
Когда использовать каждую область
**Область Managed** предназначена для:
* Политик безопасности, которые должны быть применены на уровне организации
* Требований соответствия, которые нельзя переопределить
* Стандартизированных конфигураций, развернутых IT/DevOps
**Область User** лучше всего подходит для:
* Личных предпочтений, которые вы хотите везде (темы, параметры редактора)
* Инструментов и plugins, которые вы используете во всех проектах
* Ключей API и аутентификации (хранятся безопасно)
**Область Project** лучше всего подходит для:
* Параметров, совместно используемых командой (разрешения, hooks, MCP servers)
* Plugins, которые должна иметь вся команда
* Стандартизации инструментов между сотрудниками
**Область Local** лучше всего подходит для:
* Личных переопределений для конкретного проекта
* Тестирования конфигураций перед совместным использованием с командой
* Параметров, специфичных для машины, которые не будут работать для других
Как области взаимодействуют
Когда один и тот же параметр появляется в нескольких областях, Claude Code применяет их в порядке приоритета:
1. **Managed** (наивысший): не может быть переопределена ничем
2. **Аргументы командной строки**: временные переопределения сеанса
3. **Local**: переопределяет параметры проекта и пользователя
4. **Project**: переопределяет параметры пользователя
5. **User** (наименьший): применяется, когда ничто другое не указывает параметр
Например, если параметры пользователя устанавливают `spinnerTipsEnabled` в `true`, а параметры проекта устанавливают его в `false`, применяется значение проекта. Правила разрешений ведут себя иначе, потому что они объединяются в областях, а не переопределяют друг друга. См. [Приоритет параметров](#settings-precedence).
Что использует области
Области применяются ко многим функциям Claude Code:
| Функция | Местоположение пользователя | Местоположение проекта | Местоположение Local |
| :-------------- | :-------------------------- | :---------------------------------- | :------------------------------------- |
| **Settings** | `~/.claude/settings.json` | `.claude/settings.json` | `.claude/settings.local.json` |
| **Subagents** | `~/.claude/agents/` | `.claude/agents/` | Нет |
| **MCP servers** | `~/.claude.json` | `.mcp.json` | `~/.claude.json` (для каждого проекта) |
| **Plugins** | `~/.claude/settings.json` | `.claude/settings.json` | `.claude/settings.local.json` |
| **CLAUDE.md** | `~/.claude/CLAUDE.md` | `CLAUDE.md` или `.claude/CLAUDE.md` | `CLAUDE.local.md` |
На Windows пути, отображаемые как `~/.claude`, разрешаются в `%USERPROFILE%\.claude`.
***
Файлы параметров
Файл `settings.json` является официальным механизмом для настройки Claude Code через иерархические параметры:
* **Параметры пользователя** определяются в `~/.claude/settings.json` и применяются ко всем проектам.
* **Параметры проекта** сохраняются в каталоге вашего проекта:
* `.claude/settings.json` для параметров, которые проверяются в системе управления версиями и совместно используются с вашей командой
* `.claude/settings.local.json` для параметров, которые не проверяются, полезны для личных предпочтений и экспериментов. Когда Claude Code создает `.claude/settings.local.json`, он настраивает git на игнорирование файла. Если вы создаете файл самостоятельно, добавьте его в gitignore вручную.
* **Управляемые параметры**: Для организаций, которым требуется централизованное управление, Claude Code поддерживает несколько механизмов доставки управляемых параметров. Все используют один и тот же формат JSON и не могут быть переопределены параметрами пользователя или проекта:
* **Параметры, управляемые сервером**: доставляются удаленно при входе либо с серверов Anthropic через консоль администратора claude.ai, либо с самостоятельно размещенного [Claude apps gateway](/ru/claude-apps-gateway). См. [параметры, управляемые сервером](/ru/server-managed-settings).
* **Политики MDM/OS-уровня**: доставляются через встроенное управление устройствами на macOS и Windows:
* macOS: домен управляемых предпочтений `com.anthropic.claudecode`. Ключи верхнего уровня plist отражают `managed-settings.json`, с вложенными параметрами как словари и массивы как plist массивы. Развертывание через профили конфигурации в Jamf, Iru (Kandji) или аналогичных инструментах MDM.
* Windows: ключ реестра `HKLM\SOFTWARE\Policies\ClaudeCode` со значением `Settings` (REG\_SZ или REG\_EXPAND\_SZ), содержащим JSON (развернуто через групповую политику или Intune)
* Windows (уровень пользователя): `HKCU\SOFTWARE\Policies\ClaudeCode` (наименьший приоритет политики, используется только при отсутствии источника на уровне администратора)
* **На основе файлов**: `managed-settings.json` и `managed-mcp.json`, развернутые в системные каталоги:
* macOS: `/Library/Application Support/ClaudeCode/`
* Linux и WSL: `/etc/claude-code/`
* Windows: `C:\Program Files\ClaudeCode\`
Устаревший путь Windows `C:\ProgramData\ClaudeCode\managed-settings.json` больше не поддерживается с версии v2.1.75. Администраторы, которые развернули параметры в этом местоположении, должны перенести файлы в `C:\Program Files\ClaudeCode\managed-settings.json`.
Управляемые параметры на основе файлов также поддерживают каталог drop-in в `managed-settings.d/` в том же системном каталоге рядом с `managed-settings.json`. Это позволяет отдельным командам развертывать независимые фрагменты политики без координации редактирования одного файла.
Следуя соглашению systemd, `managed-settings.json` объединяется первым как база, затем все файлы `*.json` в каталоге drop-in сортируются в алфавитном порядке и объединяются сверху. Более поздние файлы переопределяют более ранние для скалярных значений; массивы объединяются и дедублицируются; объекты глубоко объединяются. Скрытые файлы, начинающиеся с `.`, игнорируются.
Используйте числовые префиксы для управления порядком объединения, например `10-telemetry.json` и `20-security.json`.
См. [управляемые параметры](/ru/permissions#managed-only-settings) и [Управляемая конфигурация MCP](/ru/managed-mcp) для получения подробной информации.
Этот [репозиторий](https://github.com/anthropics/claude-code/tree/main/examples/mdm) включает начальные шаблоны развертывания для Jamf, Iru (Kandji), Intune и Group Policy. Используйте их как отправные точки и адаптируйте их в соответствии с вашими потребностями.
Управляемые развертывания также могут ограничивать **добавления на marketplace plugins** с помощью `strictKnownMarketplaces`. Для получения дополнительной информации см. [Управляемые ограничения marketplace](/ru/plugin-marketplaces#managed-marketplace-restrictions).
* **Другая конфигурация** хранится в `~/.claude.json`. Этот файл содержит ваш сеанс OAuth, конфигурации [MCP server](/ru/mcp) для областей пользователя и локальной области, состояние для каждого проекта (разрешенные инструменты, параметры доверия) и различные кэши. MCP servers с областью проекта хранятся отдельно в `.mcp.json`.
Claude Code автоматически создает резервные копии файлов конфигурации с временными метками и сохраняет пять самых последних резервных копий для предотвращения потери данных.
```JSON Пример settings.json theme={null}
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"permissions": {
"allow": [
"Bash(npm run lint)",
"Bash(npm run test *)",
"Read(~/.zshrc)"
],
"deny": [
"Bash(curl *)",
"Read(./.env)",
"Read(./.env.*)",
"Read(./secrets/**)"
]
},
"env": {
"CLAUDE_CODE_ENABLE_TELEMETRY": "1",
"OTEL_METRICS_EXPORTER": "otlp"
},
"companyAnnouncements": [
"Welcome to Acme Corp! Review our code guidelines at docs.acme.com",
"Reminder: Code reviews required for all PRs",
"New security policy in effect"
]
}
```
Строка `$schema` в примере выше указывает на [официальную JSON-схему](https://json.schemastore.org/claude-code-settings.json) для параметров Claude Code. Добавление ее в ваш `settings.json` включает автодополнение и встроенную валидацию в VS Code, Cursor и любом другом редакторе, поддерживающем валидацию JSON-схемы.
Опубликованная схема обновляется периодически и может не включать параметры, добавленные в самых последних выпусках CLI, поэтому предупреждение валидации о недавно задокументированном поле не обязательно означает, что ваша конфигурация недействительна.
Когда изменения вступают в силу
Claude Code отслеживает ваши файлы параметров и перезагружает их при изменении, поэтому изменения большинства ключей применяются к текущему сеансу без перезагрузки. Это включает `permissions`, `hooks` и помощники учетных данных, такие как `apiKeyHelper`. Перезагрузка охватывает параметры пользователя, проекта, локальные и управляемые параметры, и [hook `ConfigChange`](/ru/hooks#configchange) срабатывает для каждого обнаруженного изменения.
Несколько ключей читаются один раз при запуске сеанса и применяются при следующей перезагрузке:
* `model`: используйте [`/model`](/ru/model-config#setting-your-model) для переключения в середине сеанса
* [`outputStyle`](/ru/output-styles): часть системного запроса, который перестраивается на `/clear` или перезагрузке
Недействительные записи в управляемых параметрах
Управляемые параметры анализируются с допуском. Когда управляемая конфигурация содержит запись, которая не проходит валидацию схемы, Claude Code удаляет эту запись, записывает предупреждение и применяет каждую оставшуюся действительную политику. Одна опечатка не может отключить остальную политику вашей организации.
Это поведение согласуется во всех трех механизмах доставки: [параметры, управляемые сервером](/ru/server-managed-settings), политики plist и реестра, развернутые через MDM, и файлы `managed-settings.json`. Требует Claude Code v2.1.169 или позже.
Поля применения безопасности обрабатываются для каждого поля вместо полного удаления при наличии, но недействительности:
| Поле | Поведение при наличии, но недействительности |
| :--------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `allowedMcpServers` | Применяется как пустой список разрешений, поэтому MCP servers не допускаются до исправления значения. Отдельная недействительная запись удаляется и применяется действительное подмножество. |
| `allowManagedMcpServersOnly` | Обрабатывается как `true`. |
| `availableModels` | {/* min-version: 2.1.175 */}Применяется как пустой список разрешений, поэтому доступна только модель Default до исправления значения. Отдельная запись, не являющаяся строкой, удаляется и применяется действительное подмножество. Применяется в v2.1.175 и позже. |
| `enforceAvailableModels` | {/* min-version: 2.1.175 */}Обрабатывается как `true`. Применяется в v2.1.175 и позже. |
| `forceLoginOrgUUID` | Ни одна организация не может войти до исправления значения. |
| `deniedMcpServers` | Отдельная недействительная запись удаляется и применяется действительное подмножество. Полностью недействительное значение отбрасывается с предупреждением, так как отрицание каждого server заблокировало бы servers, которые политика никогда не называла. |
| `sandbox.credentials` | {/* min-version: 2.1.191 */}Отдельная недействительная запись в `files` или `envVars` удаляется с предупреждением и применяется действительное подмножество. Полностью недействительное значение `credentials` отбрасывается с предупреждением, пока остальная часть `sandbox` по-прежнему применяется. Применяется в v2.1.191 и позже. |
`requiredMinimumVersion` и `requiredMaximumVersion` открываются по дизайну: недействительное значение удаляется, а не применяется, поэтому плохая политика не может предотвратить запуск Claude Code.
Ошибки валидации появляются в трех местах:
* Интерактивные сеансы показывают диалог при запуске, перечисляющий недействительные записи.
* Headless запуски с `-p` выводят сводку в stderr.
* [`claude doctor`](/ru/debug-your-config) перечисляет каждую недействительную запись с ее источником и полем.
Проверьте изменения политики, запустив `claude doctor` на тестовой машине перед развертыванием их по всему парку.
Этот допуск применяется только к управляемым параметрам. Файлы параметров пользователя, проекта и локальные остаются строгими: файл, который не проходит валидацию, отклоняется целиком и сообщается.
Доступные параметры
`settings.json` поддерживает ряд опций:
| Ключ | Описание | Пример |
| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ |
| `advisorModel` | {/* min-version: 2.1.98 */}Модель для серверного [инструмента advisor](/ru/advisor). Принимает псевдоним модели, такой как `"opus"`, `"sonnet"` или `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+), или полный ID модели. Записывается автоматически при запуске `/advisor`. Отключите, чтобы отключить advisor. Требует Claude Code v2.1.98 или позже | `"opus"` |
| `agent` | Запустить основной поток как именованный subagent и установить агента по умолчанию для сеансов, отправленных из `claude agents`. Применяет системный запрос, ограничения инструментов и модель этого subagent. См. [Явно вызывать subagents](/ru/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |
| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `false`. Когда [Remote Control](/ru/remote-control) подключен, разрешить Claude отправлять проактивные push-уведомления на ваш телефон, например когда длительная задача завершается. Появляется в `/config` как **Push when Claude decides**. См. [Mobile push notifications](/ru/remote-control#mobile-push-notifications). Требует Claude Code v2.1.119 или позже | `true` |
| `allowAllClaudeAiMcps` | (Только управляемые параметры) Загружать разъемы claude.ai наряду с развернутым `managed-mcp.json`, который в противном случае берет исключительный контроль и подавляет их. См. [Управляемая конфигурация MCP](/ru/managed-mcp) | `true` |
| `allowedChannelPlugins` | (Только управляемые параметры) Список разрешений channel plugins, которые могут отправлять сообщения. Заменяет список разрешений Anthropic по умолчанию при установке. Не определено = вернуться к значению по умолчанию, пустой массив = блокировать все channel plugins. Требует `channelsEnabled: true`. См. [Ограничить, какие channel plugins могут запускаться](/ru/channels#restrict-which-channel-plugins-can-run) | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |
| `allowedHttpHookUrls` | Список разрешенных URL-шаблонов, на которые могут быть направлены HTTP hooks. Поддерживает `*` как подстановочный знак. При установке hooks с несовпадающими URL-адресами блокируются. Не определено = без ограничений, пустой массив = блокировать все HTTP hooks. Массивы объединяются в разных источниках параметров. См. [Конфигурация Hook](#hook-configuration) | `["https://hooks.example.com/*"]` |
| `allowedMcpServers` | При установке в managed-settings.json, список разрешений MCP servers, которые пользователи могут настроить. Не определено = без ограничений, пустой массив = блокировка. Применяется ко всем областям. Список запретов имеет приоритет. См. [Управляемая конфигурация MCP](/ru/managed-mcp) | `[{ "serverName": "github" }]` |
| `allowManagedHooksOnly` | (Только управляемые параметры) Загружаются только управляемые hooks, SDK hooks и hooks из plugins, принудительно включенных в управляемых параметрах `enabledPlugins`. Пользовательские, проектные и все остальные plugin hooks блокируются. См. [Конфигурация Hook](#hook-configuration) | `true` |
| `allowManagedMcpServersOnly` | (Только управляемые параметры) Только `allowedMcpServers` из управляемых параметров учитываются. `deniedMcpServers` по-прежнему объединяется из всех источников. Пользователи по-прежнему могут добавлять MCP servers, но применяется только определенный администратором список разрешений. См. [Управляемая конфигурация MCP](/ru/managed-mcp) | `true` |
| `allowManagedPermissionRulesOnly` | (Только управляемые параметры) Предотвратить определение правил разрешений `allow`, `ask` или `deny` в параметрах пользователя и проекта. Применяются только правила в управляемых параметрах. См. [Параметры только для управляемых](/ru/permissions#managed-only-settings) | `true` |
| `alwaysThinkingEnabled` | Включить [расширенное мышление](/ru/model-config#extended-thinking) по умолчанию для всех сеансов. Обычно настраивается через команду `/config` вместо прямого редактирования. Чтобы принудительно отключить мышление независимо от этого параметра, установите [`MAX_THINKING_TOKENS=0`](/ru/env-vars) в `env`, что отключает мышление на Anthropic API, кроме Fable 5, которая не может отключить мышление. На [поставщиках третьих сторон](/ru/third-party-integrations) это опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения все еще могут думать | `true` |
| `apiKeyHelper` | Пользовательский скрипт, который будет выполнен в системной оболочке (`/bin/sh` на macOS и Linux, `cmd` на Windows), для создания значения аутентификации. Это значение будет отправлено как заголовки `X-Api-Key` и `Authorization: Bearer` для запросов модели. Установите интервал обновления с помощью [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/ru/env-vars) | `/bin/generate_temp_api_key.sh` |
| `attribution` | Настройте атрибуцию для коммитов git и pull requests. См. [Параметры атрибуции](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |
| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `true`. Автоматически компактировать разговор, когда контекст приближается к лимиту. Появляется в `/config` как **Auto-compact**. Чтобы отключить через переменную окружения, установите [`DISABLE_AUTO_COMPACT`](/ru/env-vars) в `env` | `false` |
| `autoMemoryDirectory` | Пользовательский каталог для хранения [автоматической памяти](/ru/memory#storage-location). Принимает абсолютный путь или путь с префиксом `~/`. Из параметров проекта или локальных параметров это учитывается только после того, как вы примете диалог доверия рабочей области, так как клонированный репозиторий может предоставить этот файл | `"~/my-memory-dir"` |
| `autoMemoryEnabled` | **По умолчанию**: `true`. Включить [автоматическую память](/ru/memory#enable-or-disable-auto-memory). Когда `false`, Claude не читает и не записывает в каталог автоматической памяти. Вы также можете переключить это с помощью `/memory` во время сеанса. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/ru/env-vars) в `env` | `false` |
| `autoMode` | Настройте, что классификатор [автоматического режима](/ru/permission-modes#eliminate-prompts-with-auto-mode) блокирует и разрешает. Содержит массивы `environment`, `allow`, `soft_deny` и `hard_deny` правил в виде текста. Включите буквальную строку `"$defaults"` в массив для наследования встроенных правил в этой позиции. См. [Настройте автоматический режим](/ru/auto-mode-config). Не читается из общих параметров проекта | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |
| `autoMode.classifyAllShell` | {/* min-version: 2.1.193 */}**По умолчанию**: `false`. Когда `true`, приостанавливает каждое правило разрешения Bash и PowerShell, пока активен автоматический режим, поэтому все команды shell маршрутизируются через классификатор, а не только правила, которые соответствуют шаблонам произвольного выполнения кода. См. [Маршрутизировать все команды shell через классификатор](/ru/auto-mode-config#route-all-shell-commands-through-the-classifier). Требует Claude Code v2.1.193 или позже | `true` |
| `autoScrollEnabled` | **По умолчанию**: `true`. В [fullscreen rendering](/ru/fullscreen), следить за новым выводом в конец разговора. Появляется в `/config` как **Auto-scroll**. Запросы разрешений по-прежнему прокручиваются в поле зрения, когда это отключено | `false` |
| `autoUpdatesChannel` | **По умолчанию**: `"latest"`. Канал выпуска для отслеживания обновлений. Используйте `"stable"` для версии, которая обычно примерно на неделю старше и пропускает версии с серьезными регрессиями, или `"latest"` для самого последнего выпуска. Чтобы полностью отключить автоматические обновления, установите [`DISABLE_AUTOUPDATER`](/ru/setup#disable-auto-updates) в `env` | `"stable"` |
| `availableModels` | Ограничить, какие модели пользователи могут выбрать для основного сеанса, [subagents](/ru/sub-agents), [skills](/ru/skills) и [advisor](/ru/advisor). Не влияет на опцию Default, если также не установлен `enforceAvailableModels`. См. [Ограничить выбор модели](/ru/model-config#restrict-model-selection) | `["sonnet", "haiku"]` |
| `awaySummaryEnabled` | Показать одностроковое резюме сеанса при возврате в терминал после нескольких минут отсутствия. Установите на `false` или отключите Session recap в `/config` для отключения. То же самое, что [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/ru/env-vars) | `true` |
| `awsAuthRefresh` | Пользовательский скрипт, который изменяет каталог `.aws` (см. [расширенная конфигурация учетных данных](/ru/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |
| `awsCredentialExport` | Пользовательский скрипт, который выводит JSON с учетными данными AWS (см. [расширенная конфигурация учетных данных](/ru/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |
| `axScreenReader` | {/* min-version: 2.1.181 */}Отображать вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Режим программы чтения с экрана всегда использует классический рендерер, поэтому параметр `tui` не имеет эффекта, пока он активен. Переменная окружения [`CLAUDE_AX_SCREEN_READER`](/ru/env-vars) и флаг [`--ax-screen-reader`](/ru/cli-reference#cli-flags) имеют приоритет. Требует Claude Code v2.1.181 или позже | `true` |
| `blockedMarketplaces` | (Только управляемые параметры) Список запретов источников marketplace. Применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, поэтому marketplace, добавленный до установки политики, не может быть использован для получения plugins. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [Управляемые ограничения marketplace](/ru/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |
| `channelsEnabled` | (Только управляемые параметры) Разрешить [channels](/ru/channels) для организации. На планах Claude.ai Team и Enterprise, channels блокируются, когда это не установлено или `false`. Для учетных записей [Anthropic Console](/ru/authentication#claude-console-authentication), использующих аутентификацию по ключу API, channels разрешены по умолчанию, если только ваша организация не развернула управляемые параметры, в этом случае этот ключ должен быть установлен на `true` | `true` |
| `claudeMd` | (Только управляемые параметры) Инструкции в стиле CLAUDE.md, внедренные как организационная управляемая память. Учитываются только при установке в управляемых или политических параметрах и игнорируются в параметрах пользователя, проекта и локальных параметрах. См. [организационная CLAUDE.md](/ru/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |
| `claudeMdExcludes` | Glob шаблоны или абсолютные пути файлов `CLAUDE.md` для пропуска при загрузке [памяти](/ru/memory). Шаблоны соответствуют абсолютным путям файлов. Применяется только к памяти пользователя, проекта и локальной памяти; файлы управляемой политики не могут быть исключены | `["**/vendor/**/CLAUDE.md"]` |
| `cleanupPeriodDays` | **По умолчанию**: `30` дней, минимум `1`. Сеансы, неактивные дольше этого периода, удаляются при запуске. Установка на `0` отклоняется с ошибкой валидации. Также контролирует возрастной порог для автоматического удаления [orphaned subagent worktrees](/ru/worktrees#clean-up-worktrees) при запуске. Чтобы полностью отключить запись стенограмм, установите переменную окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ru/env-vars), или в неинтерактивном режиме (`-p`) используйте флаг `--no-session-persistence` или опцию SDK `persistSession: false`. | `20` |
| `companyAnnouncements` | Объявление для отображения пользователям при запуске. Если предоставлено несколько объявлений, они будут циклически отображаться случайным образом. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |
| `defaultShell` | **По умолчанию**: `"bash"`, или `"powershell"` на Windows, когда Bash недоступен. Оболочка по умолчанию для команд `!` в поле ввода. Принимает `"bash"` или `"powershell"`. Установка `"powershell"` направляет интерактивные команды `!` через PowerShell на Windows. Требует `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. См. [Инструмент PowerShell](/ru/tools-reference#powershell-tool) | `"powershell"` |
| `deniedMcpServers` | При установке в managed-settings.json, список запретов MCP servers, которые явно заблокированы. Применяется ко всем областям, включая управляемые servers. Список запретов имеет приоритет над списком разрешений. См. [Управляемая конфигурация MCP](/ru/managed-mcp) | `[{ "serverName": "filesystem" }]` |
| `disableAgentView` | Установите на `true`, чтобы отключить [фоновые агенты и представление агента](/ru/agent-view): `claude agents`, `--bg`, `/background` и супервизор по требованию. Обычно устанавливается в [управляемых параметрах](/ru/permissions#managed-settings). Эквивалентно установке `CLAUDE_CODE_DISABLE_AGENT_VIEW` на `1` | `true` |
| `disableAllHooks` | Отключить все [hooks](/ru/hooks) и любую пользовательскую [строку состояния](/ru/statusline) | `true` |
| `disableArtifact` | Установите на `true`, чтобы отключить инструмент [Artifact](/ru/artifacts), который публикует вывод сеанса как приватную веб-страницу на claude.ai. Эквивалентно установке `CLAUDE_CODE_DISABLE_ARTIFACT` на `1` | `true` |
| `disableAutoMode` | Установите на `"disable"`, чтобы предотвратить активацию [автоматического режима](/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет `auto` из цикла `Shift+Tab` и отклоняет `--permission-mode auto` при запуске. Наиболее полезно в [управляемых параметрах](/ru/permissions#managed-settings), где пользователи не могут его переопределить | `"disable"` |
| `disableBundledSkills` | Установите на `true`, чтобы отключить [skills](/ru/skills) и workflows, которые поставляются с Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные slash commands, такие как `/init`, остаются доступными для ввода, но скрыты от модели. Skills из plugins, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалентно установке `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` на `1` | `true` |
| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}Отключить [claude.ai MCP connectors](/ru/mcp#use-mcp-servers-from-claude-ai), чтобы они не загружались автоматически и не подключались. Установите в любой области параметров. `true` в любом источнике имеет приоритет, поэтому проверенный в проекте `.claude/settings.json` может отключить репозиторий от облачных разъемов, но уровень проекта `false` не может переопределить уровень пользователя или политики `true`. Servers, переданные явно через `--mcp-config`, не затронуты. Чтобы запретить отдельные разъемы вместо всех, используйте [`deniedMcpServers`](/ru/managed-mcp). Требует Claude Code v2.1.182 или позже | `true` |
| `disableDeepLinkRegistration` | Установите на `"disable"`, чтобы предотвратить регистрацию Claude Code обработчика протокола `claude-cli://` с операционной системой при запуске. Deep links позволяют внешним инструментам открыть сеанс Claude Code с предварительно заполненным запросом. Полезно в окружениях, где регистрация обработчика протокола ограничена или управляется отдельно | `"disable"` |
| `disabledMcpjsonServers` | Список конкретных MCP servers из файлов `.mcp.json` для отклонения | `["filesystem"]` |
| `disableRemoteControl` | {/* min-version: 2.1.128 */}Отключить [Remote Control](/ru/remote-control): блокирует `claude remote-control`, флаг `--remote-control`, автозапуск и переключение в сеансе. Обычно размещается в [управляемых параметрах](/ru/permissions#managed-settings) для применения MDM на каждом устройстве, но работает из любой области. Требует Claude Code v2.1.128 или позже | `true` |
| `disableSideloadFlags` | {/* min-version: 2.1.193 */}(Только управляемые параметры) Отклонить флаги CLI `--plugin-dir`, `--plugin-url`, `--agents` и `--mcp-config` при запуске, которые пользователи могли бы в противном случае передать для обхода [`strictKnownMarketplaces`](#strictknownmarketplaces) для одного запуска. Также отклоняет эти флаги из любой поверхности, которая порождает CLI с ними внутри, в настоящее время [Cowork](/ru/desktop) локальные сеансы в приложении desktop. `--mcp-config`, чьи servers все являются in-process записями `type: "sdk"`, по-прежнему принимается, поэтому Agent SDK и расширение VS Code продолжают работать. Не блокирует `claude mcp add`, `.mcp.json` или SDK `setMcpServers()`; объедините с [`allowedMcpServers`](/ru/managed-mcp) для управления MCP для каждого server. Требует Claude Code v2.1.193 или позже | `true` |
| `disableSkillShellExecution` | Отключить встроенное выполнение shell для `` !`...` `` и ` ```! ` блоков в [skills](/ru/skills) и пользовательских команд из источников пользователя, проекта, plugin или дополнительного каталога. Команды заменяются на `[shell command execution disabled by policy]` вместо выполнения. Встроенные и управляемые skills не затронуты. Наиболее полезно в [управляемых параметрах](/ru/permissions#managed-settings), где пользователи не могут его переопределить | `true` |
| `disableWorkflows` | **По умолчанию**: `false`. Отключить [динамические workflows](/ru/workflows#turn-workflows-off) и встроенные команды workflow. Эквивалентно установке `CLAUDE_CODE_DISABLE_WORKFLOWS` на `1` | `true` |
| `editorMode` | **По умолчанию**: `"normal"`. Режим сочетания клавиш для входного приглашения: `"normal"` или `"vim"`. Появляется в `/config` как **Editor mode** | `"vim"` |
| `effortLevel` | Сохранить [уровень усилий](/ru/model-config#adjust-effort-level) между сеансами. Принимает `"low"`, `"medium"`, `"high"` или `"xhigh"`. Записывается автоматически при запуске `/effort` с одним из этих значений. `--effort` и [`CLAUDE_CODE_EFFORT_LEVEL`](/ru/env-vars) переопределяют это на один сеанс. См. [Отрегулировать уровень усилий](/ru/model-config#adjust-effort-level) для поддерживаемых моделей | `"xhigh"` |
| `enableAllProjectMcpServers` | Автоматически одобрить все MCP servers, определенные в файлах проекта `.mcp.json`. {/* min-version: 2.1.196 */}Начиная с v2.1.196, `claude mcp list` и `claude mcp get` учитывают этот ключ в ненадежной папке только из [файлов параметров, которые не проверяются в репозитории](/ru/mcp#managing-your-servers) | `true` |
| `enableArtifact` | {/* min-version: 2.1.196 */}Включить или отключить инструмент [Artifact](/ru/artifacts) для этого пользователя. Когда не установлено, значение по умолчанию следует [доступности](/ru/artifacts#availability) функции для вашей учетной записи. Строка **Artifacts** в `/config` записывает этот ключ. Управляемый `disableArtifact` и [параметр администратора](/ru/artifacts#manage-artifacts-for-your-organization) вашей организации имеют приоритет, и ключ игнорируется в параметрах проекта и локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), которые репозиторий мог бы в противном случае зафиксировать. Требует Claude Code v2.1.196 или позже | `true` |
| `enabledMcpjsonServers` | Список конкретных MCP servers из файлов `.mcp.json` для одобрения. {/* min-version: 2.1.196 */}Начиная с v2.1.196, `claude mcp list` и `claude mcp get` учитывают этот ключ в ненадежной папке только из [файлов параметров, которые не проверяются в репозитории](/ru/mcp#managing-your-servers) | `["memory", "github"]` |
| `enforceAvailableModels` | {/* min-version: 2.1.175 */}Расширить список разрешений `availableModels` на модель Default. Когда `true` в управляемых параметрах и `availableModels` - это непустой массив, опция Default возвращается к первой разрешенной записи, которая доступна, но только когда модель по умолчанию для типа учетной записи пользователя не находится в списке разрешений; разрешенное значение по умолчанию сохраняется как есть. Не имеет эффекта, когда `availableModels` не установлен или пуст. См. [Ограничить выбор модели](/ru/model-config#restrict-model-selection) | `true` |
| `env` | Переменные окружения, применяемые к каждому сеансу и к подпроцессам, которые Claude Code порождает из него. {/* min-version: 2.1.143 */}Начиная с v2.1.143, `NO_COLOR` и `FORCE_COLOR`, установленные здесь, передаются подпроцессам, но не изменяют цвета собственного интерфейса Claude Code. Установите их в вашей оболочке перед запуском `claude`, чтобы изменить цвета интерфейса. {/* min-version: 2.1.195 */}Начиная с v2.1.195, переменные идентификации, которые устанавливают окружения хостинга Claude Code, например `CLAUDE_CODE_REMOTE` и `CLAUDE_CODE_ACCOUNT_UUID`, игнорируются при установке здесь | `{"FOO": "bar"}` |
| `fallbackModel` | Резервная модель(и) для попытки по порядку, когда основная модель перегружена или недоступна. Claude Code переключается на следующую доступную модель в цепи для остальной части хода и показывает уведомление. `"default"` расширяется до модели по умолчанию. Цепи ограничены тремя моделями; дополнительные записи игнорируются. В отличие от большинства параметров массива, этот ключ не объединяется в разных файлах параметров: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь. Флаг [`--fallback-model`](/ru/cli-reference#cli-flags) переопределяет это на один сеанс. См. [Цепи резервных моделей](/ru/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |
| `fastModePerSessionOptIn` | Когда `true`, быстрый режим не сохраняется между сеансами. Каждый сеанс начинается с отключенным быстрым режимом, требуя от пользователей включить его с помощью `/fast`. Предпочтение быстрого режима пользователя по-прежнему сохраняется. См. [Требовать согласие для каждого сеанса](/ru/fast-mode#require-per-session-opt-in) | `true` |
| `feedbackSurveyRate` | Вероятность (0–1) того, что [опрос качества сеанса](/ru/data-usage#session-quality-surveys) появится при наличии условий. Установите на `0`, чтобы полностью подавить, или установите [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/ru/env-vars) в `env`. Полезно при использовании Bedrock, Vertex или Foundry, где частота выборки по умолчанию не применяется | `0.05` |
| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `true`. Снимок файлов перед каждым редактированием, чтобы [`/rewind`](/ru/checkpointing) мог их восстановить. Появляется в `/config` как **Rewind code (checkpoints)**. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/ru/env-vars) в `env` | `false` |
| `fileSuggestion` | Настройте пользовательский скрипт для автодополнения файлов `@`. См. [Параметры предложения файлов](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |
| `footerLinksRegexes` | {/* min-version: 2.1.176 */}Отображать дополнительные кликабельные значки в нижнем колонтитуле, когда регулярное выражение совпадает с выводом хода. Каждая запись имеет `pattern`, шаблон `url` с заполняемыми `{name}` плейсхолдерами из именованных групп захвата и необязательный `label`. Читается из параметров пользователя, флага `--settings` и управляемых параметров только. См. [Значки ссылок нижнего колонтитула](#footer-link-badges) для ограничений URL, списка разрешений схемы и лимитов. Требует Claude Code v2.1.176 или позже | `[{"type": "regex", "pattern": "\\b(?PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |
| `forceLoginMethod` | Используйте `claudeai` для ограничения входа учетными записями Claude.ai, `console` для ограничения входа учетными записями Claude Console, или `gateway` для ограничения входа на облачный шлюз; см. [Claude apps gateway](/ru/claude-apps-gateway). Когда установлено в управляемых параметрах, сеансы, аутентифицированные по `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске, так как ни одно значение не может быть удовлетворено без первоначальной OAuth. Сеансы поставщиков третьих сторон, такие как Bedrock, Vertex и Foundry, не блокируются: они аутентифицируются против вашего облачного провайдера, а не Anthropic | `claudeai` |
| `forceLoginGatewayUrl` | Предварительно заполняет и блокирует URL шлюза на экране `/login` Cloud gateway. Либо этот ключ, либо `forceLoginMethod: "gateway"` отображает этот экран; установите оба, чтобы URL был заполнен. Учитывается только на управляемом уровне политики; игнорируется в параметрах пользователя и проекта. См. [Claude apps gateway](/ru/claude-apps-gateway#set-the-gateway-url) | `"https://claude-gateway.example.com"` |
| `forceLoginOrgUUID` | Требовать, чтобы вход принадлежал определенной организации Anthropic. Принимает одну строку UUID, которая также предварительно выбирает эту организацию во время входа, или массив UUID, где любая указанная организация принимается без предварительного выбора. При установке в управляемых параметрах вход не удается, если аутентифицированная учетная запись не принадлежит указанной организации, и сеансы, аутентифицированные по `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске, так как членство в организации не может быть проверено для них. Сеансы поставщиков третьих сторон, такие как Bedrock, Vertex и Foundry, не блокируются: используйте IAM вашего облачного провайдера для ограничения того, какие облачные учетные записи могут быть использованы. Пустой массив не удается закрыто и блокирует вход с сообщением о неправильной конфигурации | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` или `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |
| `forceRemoteSettingsRefresh` | (Только управляемые параметры) Блокировать запуск CLI до тех пор, пока удаленные управляемые параметры не будут свежо получены с сервера. Если получение не удается, CLI выходит вместо продолжения с кэшированными или отсутствующими параметрами. Когда не установлено, запуск продолжается без ожидания удаленных параметров. См. [fail-closed enforcement](/ru/server-managed-settings#enforce-fail-closed-startup) | `true` |
| `gcpAuthRefresh` | Пользовательский скрипт, который обновляет GCP Application Default Credentials при их истечении или невозможности загрузки. См. [расширенная конфигурация учетных данных](/ru/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |
| `hooks` | Настройте пользовательские команды для запуска при событиях жизненного цикла. См. [документацию hooks](/ru/hooks) для формата | См. [hooks](/ru/hooks) |
| `httpHookAllowedEnvVars` | Список разрешенных имен переменных окружения, которые HTTP hooks могут интерполировать в заголовки. При установке эффективный `allowedEnvVars` каждого hook является пересечением с этим списком. Не определено = без ограничений. Массивы объединяются в разных источниках параметров. См. [Конфигурация Hook](#hook-configuration) | `["MY_TOKEN", "HOOK_SECRET"]` |
| `includeGitInstructions` | **По умолчанию**: `true`. Включить встроенные инструкции рабочего процесса коммита и PR и снимок статуса git в системный запрос Claude. Установите на `false`, чтобы удалить оба, например при использовании собственных skills рабочего процесса git. Переменная окружения `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` имеет приоритет над этим параметром при установке | `false` |
| `inputNeededNotifEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `false`. Когда [Remote Control](/ru/remote-control) подключен, отправить push-уведомление на ваш телефон, когда запрос разрешения или вопрос ожидает вашего ввода. Появляется в `/config` как **Push when actions required**. См. [Mobile push notifications](/ru/remote-control#mobile-push-notifications). Требует Claude Code v2.1.119 или позже | `true` |
| `language` | Настройте предпочитаемый язык ответов Claude (например, `"japanese"`, `"spanish"`, `"french"`). Claude будет отвечать на этом языке по умолчанию. Также устанавливает язык [голосового диктанта](/ru/voice-dictation#change-the-dictation-language) и автоматически созданных названий сеансов. {/* min-version: 2.1.176 */}Начиная с v2.1.176, когда не установлено, названия сеансов соответствуют языку вашего разговора | `"japanese"` |
| `minimumVersion` | Предотвратить понижение версии автоматического обновления ниже определенной версии. Переключение с канала `"latest"` на `"stable"` через `/config` предлагает вам остаться на текущей версии или разрешить понижение. Выбор остаться устанавливает это значение. Также полезно в [управляемых параметрах](/ru/permissions#managed-settings) для закрепления организационного минимума. Для жесткого предела, который блокирует запуск целиком, см. `requiredMinimumVersion` | `"2.1.100"` |
| `model` | Переопределить модель по умолчанию для использования в Claude Code. `--model` и [`ANTHROPIC_MODEL`](/ru/model-config#environment-variables) переопределяют это на один сеанс | `"claude-sonnet-5"` |
| `modelOverrides` | Сопоставить ID моделей Anthropic с ID моделей, специфичными для поставщика, такими как ARN профилей вывода Bedrock. Каждая запись средства выбора модели использует свое сопоставленное значение при вызове API поставщика. См. [Переопределить ID моделей для каждой версии](/ru/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |
| `otelHeadersHelper` | Скрипт для создания динамических заголовков OpenTelemetry. Запускается при запуске и периодически. Установите интервал обновления с помощью [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/ru/env-vars). См. [Динамические заголовки](/ru/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |
| `outputStyle` | Настройте стиль вывода для корректировки системного запроса. См. [документацию стилей вывода](/ru/output-styles) | `"Explanatory"` |
| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Только управляемые параметры) **По умолчанию**: `"first-wins"`. Контролирует, применяются ли управляемые параметры, предоставленные программно процессом хоста встраивания, таким как Agent SDK или расширение IDE, когда также присутствует развернутый администратором управляемый уровень. `"first-wins"`: параметры, предоставленные родителем, отбрасываются и применяется только уровень администратора. `"merge"`: параметры, предоставленные родителем, применяются под уровнем администратора, отфильтрованные так, чтобы они могли ужесточить политику, но не ослабить ее. Не имеет эффекта, когда развернут администратором уровень. Требует Claude Code v2.1.133 или позже | `"merge"` |
| `permissions` | См. таблицу ниже для структуры разрешений. | |
| `plansDirectory` | **По умолчанию**: `~/.claude/plans`. Настройте, где хранятся файлы плана. Путь относительно корня проекта. | `"./plans"` |
| `pluginSuggestionMarketplaces` | (Только управляемые параметры) Имена marketplace, чьи plugins могут появляться как контекстные предложения установки. Ни одно предложение, объявленное marketplace, не появляется без этого списка разрешений; встроенный совет по дизайну первой стороны не затронут. Предложения поступают из объявления `relevance` каждого plugin в его записи marketplace. Имя вступает в силу только когда marketplace зарегистрирован на машине и его зарегистрированный источник также объявлен в управляемых параметрах, либо как запись `extraKnownMarketplaces` для этого имени, либо как запись `strictKnownMarketplaces`. Marketplace, зарегистрированный из другого источника под разрешенным именем, игнорируется. Официальный marketplace освобожден от требования источника: разрешение его имени одного достаточно, так как это имя может регистрироваться только из официального источника Anthropic. | `["acme-corp-plugins"]` |
| `pluginTrustMessage` | (Только управляемые параметры) Пользовательское сообщение, добавленное к предупреждению о доверии plugin, показываемому перед установкой. Используйте это для добавления контекста, специфичного для организации, например для подтверждения того, что plugins из вашего внутреннего marketplace проверены. | `"All plugins from our marketplace are approved by IT"` |
| `policyHelper` | {/* min-version: 2.1.136 */}Развернутый администратором исполняемый файл, который вычисляет управляемые параметры динамически при запуске. Учитывается только из MDM или системного файла `managed-settings.json`. См. [Вычислить управляемые параметры с помощью помощника политики](#compute-managed-settings-with-a-policy-helper). Требует Claude Code v2.1.136 или позже | `{"path": "/usr/local/bin/claude-policy"}` |
| `preferredNotifChannel` | **По умолчанию**: `"auto"`. Метод для уведомлений о завершении задачи и запросов разрешения: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"` или `"notifications_disabled"`. `"auto"` отправляет уведомление рабочего стола в iTerm2, Ghostty и Kitty и ничего не делает в других терминалах. Установите `"terminal_bell"` для звонка в любом терминале. Появляется в `/config` как **Notifications**. См. [Получить звонок терминала или уведомление](/ru/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |
| `prefersReducedMotion` | Уменьшить или отключить анимацию пользовательского интерфейса (спиннеры, shimmer, эффекты вспышки) для доступности | `true` |
| `prUrlTemplate` | Шаблон URL для значка PR, показываемого в нижнем колонтитуле и в сводках результатов инструмента. Заменяет `{host}`, `{owner}`, `{repo}`, `{number}` и `{url}` из URL PR, сообщаемого `gh`. Используйте для указания ссылок PR на внутренний инструмент проверки кода вместо `github.com`. Не влияет на автоссылки `#123` в прозе Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |
| `remoteControlAtStartup` | {/* min-version: 2.1.119 */}Подключить [Remote Control](/ru/remote-control) автоматически при запуске каждого интерактивного сеанса, вместо ожидания `/remote-control`. Установите на `true`, чтобы всегда автоподключаться, `false`, чтобы никогда не автоподключаться, или оставьте неустановленным, чтобы следовать значению по умолчанию вашей организации. Появляется в `/config` как **Enable Remote Control for all sessions**. См. [Enable Remote Control for all sessions](/ru/remote-control#enable-remote-control-for-all-sessions) | `false` |
| `requiredMaximumVersion` | Только управляемые параметры. Максимальная версия Claude Code, разрешенная для запуска. Если запущенная версия новее, Claude Code выходит при запуске и инструктирует пользователя установить одобренную версию через одобренный метод организации; `claude install ` также может работать. Фоновые автоматические обновления и `claude update` пропускают версии выше потолка, поэтому установка в диапазоне остается в диапазоне. `claude update`, `claude install` и `claude doctor` продолжают работать выше потолка, чтобы пользователи могли восстановиться. Версии, которые предшествуют этому параметру, игнорируют его | `"2.1.150"` |
| `requiredMinimumVersion` | Только управляемые параметры. Минимальная версия Claude Code, требуемая для запуска. Если запущенная версия старше, Claude Code выходит при запуске и инструктирует пользователя обновить через одобренный метод организации. `claude update`, `claude install` и `claude doctor` продолжают работать ниже пола, чтобы пользователи могли восстановиться. Отличается от `minimumVersion`, который предотвращает понижение, но никогда не блокирует запуск. Версии, которые предшествуют этому параметру, игнорируют его | `"2.1.150"` |
| `respectGitignore` | **По умолчанию**: `true`. Контролировать, соблюдает ли средство выбора файлов `@` шаблоны `.gitignore`. Когда `true`, файлы, соответствующие шаблонам `.gitignore`, исключаются из предложений | `false` |
| `respondToBashCommands` | {/* min-version: 2.1.186 */}**По умолчанию**: `true`. Отвечает ли Claude после запуска команды shell с префиксом `!` в поле ввода. Установите на `false`, чтобы добавить вывод команды в контекст без ответа. См. [Shell mode with `!` prefix](/ru/interactive-mode#shell-mode-with-prefix). Требует Claude Code v2.1.186 или позже | `false` |
| `showClearContextOnPlanAccept` | **По умолчанию**: `false`. Показать опцию "очистить контекст" на экране принятия плана. Установите на `true`, чтобы восстановить опцию | `true` |
| `showThinkingSummaries` | **По умолчанию**: `false`. Показать [расширенное мышление](/ru/model-config#extended-thinking) резюме в интерактивных сеансах. Когда не установлено или `false`, блоки мышления редактируются API и показываются как свернутая заглушка. Редактирование изменяет только то, что вы видите, а не то, что генерирует модель: чтобы снизить расходы на мышление, [снизьте бюджет или отключите мышление](/ru/model-config#extended-thinking) вместо этого. Этот параметр не имеет эффекта в неинтерактивном режиме (`-p`), Agent SDK или расширениях IDE, таких как VS Code | `true` |
| `showTurnDuration` | **По умолчанию**: `true`. Показывать сообщения о продолжительности хода после ответов, например "Cooked for 1m 6s". Появляется в `/config` как **Show turn duration** | `false` |
| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}**По умолчанию**: `0.01` (1%). Доля окна контекста модели, зарезервированная для [списка skills](/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Когда список превышает бюджет, описания для наименее используемых skills сворачиваются до простых имен, чтобы Claude все еще мог их вызывать, но не видел бы, почему. Увеличьте, чтобы сохранить больше описаний видимыми за счет большего контекста за ход. `/doctor` показывает текущее количество усечений и какие skills затронуты. Требует Claude Code v2.1.105 или позже | `0.02` |
| `skillListingMaxDescChars` | {/* min-version: 2.1.105 */}**По умолчанию**: `1536`. Ограничение количества символов для каждого skill на объединенный текст `description` и `when_to_use` в [списке skills](/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Текст длиннее этого усекается. Увеличьте, чтобы сохранить длинные описания в целости за счет большего контекста за ход; уменьшьте, чтобы вместить больше skills в рамках [`skillListingBudgetFraction`](#available-settings). Требует Claude Code v2.1.105 или позже | `2048` |
| `skillOverrides` | {/* min-version: 2.1.129 */}Переопределения видимости для каждого skill, ключ которых - имя skill. Значение - `"on"`, `"name-only"`, `"user-invocable-only"` или `"off"`. Позволяет скрыть или свернуть skill без редактирования его SKILL.md. Не применяется к plugin skills, которые управляются через `/plugin`. Меню `/skills` записывает эти значения в `.claude/settings.local.json`. См. [Переопределить видимость skill из параметров](/ru/skills#override-skill-visibility-from-settings). Требует Claude Code v2.1.129 или позже | `{"legacy-context": "name-only", "deploy": "off"}` |
| `skipWebFetchPreflight` | Пропустить [проверку безопасности домена WebFetch](/ru/data-usage#webfetch-domain-safety-check), которая отправляет каждое запрашиваемое имя хоста на `api.anthropic.com` перед выборкой. Установите на `true` в окружениях, которые блокируют трафик к Anthropic, таких как развертывания Bedrock, Vertex AI или Foundry с ограничивающим исходящим трафиком. При пропуске WebFetch пытается любой URL без консультации со списком блокировок | `true` |
| `spinnerTipsEnabled` | **По умолчанию**: `true`. Показывать советы в спиннере, пока Claude работает. Установите на `false`, чтобы отключить советы | `false` |
| `spinnerTipsOverride` | Переопределить советы спиннера пользовательскими строками. `tips`: массив строк советов. `excludeDefault`: если `true`, показывать только пользовательские советы; если `false` или отсутствует, пользовательские советы объединяются со встроенными советами | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |
| `spinnerVerbs` | Настройте глаголы действия, показываемые в спиннере во время хода. Установите `mode` на `"replace"`, чтобы использовать только ваши глаголы, или `"append"`, чтобы добавить их к значениям по умолчанию | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |
| `sshConfigs` | SSH подключения для отображения в раскрывающемся списке окружения [Desktop](/ru/desktop#pre-configure-ssh-connections-for-your-team). Каждая запись требует `id`, `name` и `sshHost`; `sshPort`, `sshIdentityFile` и `startDirectory` являются необязательными. При установке в управляемых параметрах подключения доступны только для чтения для пользователей. Читается только из управляемых и пользовательских параметров | `[{"id": "dev-vm", "name": "Dev VM", "sshHost": "user@dev.example.com"}]` |
| `statusLine` | Настройте пользовательскую строку состояния для отображения контекста. Поле объекта `padding`, `refreshInterval` и `hideVimModeIndicator` управляют интервалом, периодическими повторными запусками и тем, скрыт ли встроенный индикатор режима vim ниже приглашения. См. [документацию `statusLine`](/ru/statusline#manually-configure-a-status-line) | `{"type": "command", "command": "~/.claude/statusline.sh"}` |
| `strictKnownMarketplaces` | (Только управляемые параметры) Список разрешений источников marketplace plugins. Не определено = без ограничений, пустой массив = блокировка. Применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, поэтому marketplace, добавленный до установки политики, не может быть использован для получения plugins. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [Управляемые ограничения marketplace](/ru/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |
| `strictPluginOnlyCustomization` | (Только управляемые параметры) Блокировать skills, agents, hooks и MCP servers из источников пользователя и проекта, поэтому они могут поступать только из plugins или управляемых параметров. `true` блокирует все четыре поверхности; массив блокирует только названные. См. [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |
| `syntaxHighlightingDisabled` | Отключить подсветку синтаксиса в дифах, блоках кода и предпросмотрах файлов | `true` |
| `teammateMode` | **По умолчанию**: `in-process`. Как отображаются товарищи по [команде агентов](/ru/agent-teams): `in-process`, `auto` (разделенные панели в tmux или iTerm2, в процессе в противном случае), `tmux` (разделенные панели с использованием tmux или iTerm2, обнаруженные из вашего терминала), или {/* min-version: 2.1.186 */}}`iterm2` (iTerm2 native split panes via the `it2` CLI, added in v2.1.186). По умолчанию изменилось с `auto` в v2.1.179. `--teammate-mode` переопределяет это на один сеанс. См. [выбрать режим отображения](/ru/agent-teams#choose-a-display-mode) | `"auto"` |
| `terminalProgressBarEnabled` | **По умолчанию**: `true`. Показывать полосу прогресса терминала в поддерживаемых терминалах: ConEmu, Ghostty 1.2.0+ и iTerm2 3.6.6+. Появляется в `/config` как **Terminal progress bar** | `false` |
| `theme` | {/* min-version: 2.1.119 */}**По умолчанию**: `"dark"`. Цветовая тема для интерфейса: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"` или ссылка на пользовательскую тему, такая как `"custom:"` или `"custom::"`. См. [Создать пользовательскую тему](/ru/terminal-config#create-a-custom-theme). Появляется в `/config` как **Theme** | `"dark"` |
| `tui` | Средство визуализации Terminal UI. Используйте `"fullscreen"` для безмерцающего [alt-screen renderer](/ru/fullscreen) с виртуализированной прокруткой. Используйте `"default"` для классического main-screen renderer. Установите через `/tui`. Вы также можете установить переменную окружения [`CLAUDE_CODE_NO_FLICKER`](/ru/env-vars). Фоновые сеансы, открытые из [представления агента](/ru/agent-view), всегда используют fullscreen renderer независимо от этого параметра | `"fullscreen"` |
| `ultracode` | Включить [ultracode](/ru/workflows#let-claude-decide-with-ultracode) для сеанса. Только для сеанса и не читается из `settings.json`. Установите через `/effort ultracode`, `--settings` или запрос управления Agent SDK | `true` |
| `useAutoModeDuringPlan` | **По умолчанию**: `true`. Использует ли Plan Mode семантику автоматического режима, когда автоматический режим доступен. Не читается из общих параметров проекта. Появляется в `/config` как "Use auto mode during plan" | `false` |
| `verbose` | {/* min-version: 2.1.119 */}**По умолчанию**: `false`. Показать полный вывод инструмента вместо усеченных сводок. Появляется в `/config` как **Verbose output**. Флаг `--verbose` переопределяет это на один сеанс | `true` |
| `viewMode` | Режим просмотра стенограммы по умолчанию при запуске: `"default"`, `"verbose"` или `"focus"`. Переопределяет липкий выбор `/focus` при установке. Флаг `--verbose` переопределяет это на один сеанс | `"verbose"` |
| `voice` | Параметры [голосового диктанта](/ru/voice-dictation): `enabled` включает диктант, `mode` выбирает `"hold"` или `"tap"`, и `autoSubmit` отправляет запрос при отпускании клавиши в режиме hold. Записывается автоматически при запуске `/voice`. Требует учетную запись Claude.ai | `{ "enabled": true, "mode": "tap" }` |
| `voiceEnabled` | Устаревший псевдоним для `voice.enabled`. Предпочитайте объект `voice` | `true` |
| `wheelScrollAccelerationEnabled` | {/* min-version: 2.1.174 */}**По умолчанию**: `true`. В [fullscreen rendering](/ru/fullscreen#mouse-wheel-scrolling), ускорить скорость прокрутки колеса мыши во время быстрой прокрутки. Установите на `false` для постоянной скорости прокрутки за один оборот колеса. Требует Claude Code v2.1.174 или позже | `false` |
| `workflowKeywordTriggerEnabled` | {/* min-version: 2.1.157 */}**По умолчанию**: `true`. Вызывает ли слово `ultracode` в запросе [динамический workflow](/ru/workflows#ask-for-a-workflow-in-your-prompt). Установите на `false`, чтобы вводить слово без срабатывания. Ultracode, `/workflows` и сохраненные команды workflow не затронуты. Появляется в `/config` как **Ultracode keyword trigger**. Добавлено в v2.1.157; до v2.1.160 ключевое слово триггера было `workflow` | `false` |
| `wslInheritsWindowsSettings` | (Только управляемые параметры Windows) Когда `true`, Claude Code на WSL читает управляемые параметры из цепочки политик Windows в дополнение к `/etc/claude-code`, с приоритетом источников Windows. Учитывается только при установке в ключе реестра HKLM или `C:\Program Files\ClaudeCode\managed-settings.json`, оба из которых требуют администратора Windows для записи. Чтобы политика HKCU также применялась на WSL, флаг должен быть дополнительно установлен в самом HKCU. Не влияет на нативный Windows | `true` |
Параметры глобальной конфигурации
Эти параметры хранятся в `~/.claude.json` вместо `settings.json`. Добавление их в `settings.json` вызовет ошибку валидации схемы.
Версии до v2.1.119 также хранят ряд ключей предпочтений `/config` здесь вместо `settings.json`, включая `theme`, `verbose`, `editorMode`, `autoCompactEnabled` и `preferredNotifChannel`.
| Ключ | Описание | Пример |
| :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |
| `autoConnectIde` | **По умолчанию**: `false`. Автоматически подключаться к запущенной IDE при запуске Claude Code из внешнего терминала. Появляется в `/config` как **Auto-connect to IDE (external terminal)** при запуске вне терминала VS Code или JetBrains. Переменная окружения [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/ru/env-vars) переопределяет это при установке | `true` |
| `autoInstallIdeExtension` | **По умолчанию**: `true`. Автоматически устанавливать расширение Claude Code IDE при запуске из терминала VS Code. Появляется в `/config` как **Auto-install IDE extension** при запуске внутри терминала VS Code или JetBrains. Вы также можете установить переменную окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/ru/env-vars) | `false` |
| `externalEditorContext` | **По умолчанию**: `false`. Добавить предыдущий ответ Claude как контекст с комментариями `#` при открытии внешнего редактора с помощью `Ctrl+G`. Появляется в `/config` как **Show last response in external editor** | `true` |
| `teammateDefaultModel` | Модель по умолчанию для товарищей по [команде агентов](/ru/agent-teams) когда запрос порождения не указывает одну. Установите на псевдоним модели, такой как `"sonnet"`, или `null` для наследования текущего выбора `/model` лидера. Появляется в `/config` как **Default teammate model** | `"sonnet"` |
Параметры Worktree
Настройте, как `--worktree` создает и управляет git worktrees.
| Ключ | Описание | Пример |
| :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |
| `worktree.baseRef` | Какой ref новые worktrees ветвятся от. `"fresh"` (по умолчанию) ветвится от `origin/` для чистого дерева, соответствующего удаленному. `"head"` ветвится от вашего текущего локального `HEAD`, поэтому неотправленные коммиты и состояние ветки функции присутствуют в worktree. Применяется к `--worktree`, инструменту `EnterWorktree` и изоляции subagent | `"head"` |
| `worktree.symlinkDirectories` | Каталоги для создания символических ссылок из основного репозитория в каждый worktree, чтобы избежать дублирования больших каталогов на диске. По умолчанию никакие каталоги не создаются символическими ссылками | `["node_modules", ".cache"]` |
| `worktree.sparsePaths` | Каталоги для проверки в каждом worktree через git sparse-checkout. На диск записываются только перечисленные пути, что быстрее в больших монорепозиториях | `["packages/my-app", "shared/utils"]` |
| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Режим изоляции для [фоновых сеансов](/ru/agent-view#how-file-edits-are-isolated). `"worktree"` (по умолчанию) блокирует `Edit`/`Write` в основной проверке до вызова `EnterWorktree`. `"none"` позволяет фоновым заданиям редактировать рабочую копию напрямую. Требует Claude Code v2.1.143 или позже | `"none"` |
Чтобы скопировать файлы, игнорируемые gitignore, такие как `.env`, в новые worktrees, используйте [файл `.worktreeinclude`](/ru/worktrees#copy-gitignored-files-into-worktrees) в корне вашего проекта вместо параметра.
Параметры разрешений
| Ключи | Описание | Пример |
| :---------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |
| `allow` | Массив правил разрешений для разрешения использования инструмента. Глобусы имен инструментов поддерживаются только в позиции инструмента после буквального префикса `mcp____`, такого как `mcp__github__get_*`; сегмент сервера должен быть без глобусов. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже для деталей сопоставления шаблонов | `[ "Bash(git diff *)" ]` |
| `ask` | Массив правил разрешений для запроса подтверждения при использовании инструмента. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже | `[ "Bash(git push *)" ]` |
| `deny` | Массив правил разрешений для запрета использования инструмента. Используйте это для исключения чувствительных файлов из доступа Claude Code. Имена инструментов принимают глобусы: `"*"` запрещает каждый инструмент и `"mcp__*"` запрещает все MCP инструменты. См. [Синтаксис правила разрешения](#permission-rule-syntax) и [Ограничения разрешений Bash](/ru/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |
| `additionalDirectories` | Дополнительные [рабочие каталоги](/ru/permissions#working-directories) для доступа к файлам. Большинство конфигурации `.claude/` [не обнаруживается](/ru/permissions#additional-directories-grant-file-access-not-configuration) из этих каталогов | `[ "../docs/" ]` |
| `defaultMode` | Режим [разрешения](/ru/permission-modes) по умолчанию при открытии Claude Code. Допустимые значения: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`. {/* min-version: 2.1.142 */}Начиная с Claude Code v2.1.142, `auto` игнорируется при установке в параметрах проекта или локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), поэтому репозиторий не может предоставить себе автоматический режим. Установите его в `~/.claude/settings.json` вместо этого. Флаг CLI `--permission-mode` переопределяет этот параметр для одного сеанса | `"acceptEdits"` |
| `disableBypassPermissionsMode` | Установите на `"disable"`, чтобы предотвратить активацию режима `bypassPermissions`. Это отключает флаг командной строки `--dangerously-skip-permissions`. Обычно размещается в [управляемых параметрах](/ru/permissions#managed-settings) для применения организационной политики, но работает из любой области | `"disable"` |
| `skipDangerousModePermissionPrompt` | Пропустить подтверждение, показываемое перед входом в режим обхода разрешений через `--dangerously-skip-permissions` или `defaultMode: "bypassPermissions"`. Игнорируется при установке в параметрах проекта (`.claude/settings.json`) для предотвращения автоматического обхода подтверждения ненадежными репозиториями | `true` |
Синтаксис правила разрешения
Правила разрешения следуют формату `Tool` или `Tool(specifier)`. Правила оцениваются по порядку: сначала правила deny, затем ask, затем allow. Первое совпадающее правило определяет результат независимо от специфичности правила. См. [порядок оценки правила разрешения](/ru/permissions#manage-permissions) для деталей.
Быстрые примеры:
| Правило | Эффект |
| :----------------------------- | :----------------------------------------------- |
| `Bash` | Соответствует всем командам Bash |
| `Bash(npm run *)` | Соответствует командам, начинающимся с `npm run` |
| `Read(./.env)` | Соответствует чтению файла `.env` |
| `WebFetch(domain:example.com)` | Соответствует запросам fetch к example.com |
Для полного справочника синтаксиса правил, включая поведение подстановочных знаков, шаблоны, специфичные для инструментов, для Read, Edit, WebFetch, MCP и Agent правил, а также ограничения безопасности шаблонов Bash, см. [Синтаксис правила разрешения](/ru/permissions#permission-rule-syntax).
Параметры Sandbox
Настройте расширенное поведение sandboxing. Sandboxing изолирует команды bash от вашей файловой системы и сети. См. [Sandboxing](/ru/sandboxing) для деталей.
| Ключи | Описание | Пример |
| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |
| `enabled` | Включить bash sandboxing (macOS, Linux и WSL2). По умолчанию: false | `true` |
| `failIfUnavailable` | Выход с ошибкой при запуске, если `sandbox.enabled` равно true, но sandbox не может запуститься (отсутствуют зависимости или неподдерживаемая платформа). Когда false (по умолчанию), выводится предупреждение и команды выполняются без sandbox. Предназначено для развертываний управляемых параметров, требующих sandboxing как жесткого шлюза | `true` |
| `autoAllowBashIfSandboxed` | Автоматически одобрить команды bash при sandboxing. По умолчанию: true | `true` |
| `excludedCommands` | Команды, которые должны выполняться вне sandbox | `["docker *"]` |
| `allowUnsandboxedCommands` | Разрешить командам выполняться вне sandbox через параметр `dangerouslyDisableSandbox`. Когда установлено на `false`, люк `dangerouslyDisableSandbox` полностью отключен и все команды должны выполняться в sandbox (или быть в `excludedCommands`). Полезно для корпоративных политик, требующих строгого sandboxing. По умолчанию: true | `false` |
| `filesystem.allowWrite` | Дополнительные пути, где команды в sandbox могут писать. Массивы объединяются во всех областях параметров: пути пользователя, проекта и управляемые пути объединяются, не заменяются. Также объединяются с путями из правил разрешения `Edit(...)`. См. [префиксы пути sandbox](#sandbox-path-prefixes) ниже. | `["/tmp/build", "~/.kube"]` |
| `filesystem.denyWrite` | Пути, где команды в sandbox не могут писать. Массивы объединяются во всех областях параметров. Также объединяются с путями из правил разрешения `Edit(...)`. | `["/etc", "/usr/local/bin"]` |
| `filesystem.denyRead` | Пути, где команды в sandbox не могут читать. Массивы объединяются во всех областях параметров. Также объединяются с путями из правил разрешения `Read(...)`. | `["~/.aws/credentials"]` |
| `filesystem.allowRead` | Пути для повторного разрешения чтения в пределах регионов `denyRead`. Имеет приоритет над `denyRead`. Массивы объединяются во всех областях параметров. Используйте это для создания шаблонов доступа для чтения только рабочей области. | `["."]` |
| `filesystem.allowManagedReadPathsOnly` | (Только управляемые параметры) Только пути `allowRead` из управляемых параметров учитываются. `denyRead` по-прежнему объединяется из всех источников. По умолчанию: false | `true` |
| `credentials.files` | Файлы учетных данных или каталоги, которые команды в sandbox не могут читать. Применяет тот же блок чтения, что и `filesystem.denyRead`; отдельный ключ держит пути учетных данных сгруппированными с `credentials.envVars` и отдельно от общих правил файловой системы. Каждая запись - это `{ "path": "...", "mode": "deny" }`. Пути используют те же [префиксы](#sandbox-path-prefixes), что и параметры `filesystem.*`. Массивы объединяются во всех областях параметров. Поддерживается только `deny`. Требует Claude Code v2.1.187 или позже. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |
| `credentials.envVars` | Переменные окружения для отмены перед запуском команд в sandbox. Каждая запись - это `{ "name": "...", "mode": "deny" }`. Массивы объединяются во всех областях параметров. Поддерживается только `deny`. Требует Claude Code v2.1.187 или позже. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |
| `network.allowUnixSockets` | (Только macOS) Пути Unix socket, доступные в sandbox. Игнорируется на Linux и WSL2, где фильтр seccomp не может проверить пути socket; используйте `allowAllUnixSockets` вместо этого. | `["~/.ssh/agent-socket"]` |
| `network.allowAllUnixSockets` | Разрешить все подключения Unix socket в sandbox. На Linux и WSL2 это единственный способ разрешить Unix sockets, так как он пропускает фильтр seccomp, который в противном случае блокирует вызовы `socket(AF_UNIX, ...)`. По умолчанию: false | `true` |
| `network.allowLocalBinding` | Разрешить привязку к портам localhost (только macOS). По умолчанию: false | `true` |
| `network.allowMachLookup` | Дополнительные имена сервисов XPC/Mach, которые sandbox может искать (только macOS). Поддерживает один завершающий `*` для сопоставления префикса. Требуется для инструментов, которые взаимодействуют через XPC, таких как iOS Simulator или Playwright. | `["com.apple.coresimulator.*"]` |
| `network.allowedDomains` | Массив доменов для разрешения исходящего сетевого трафика. Поддерживает подстановочные знаки (например, `*.example.com`). | `["github.com", "*.npmjs.org"]` |
| `network.deniedDomains` | Массив доменов для блокировки исходящего сетевого трафика. Поддерживает тот же синтаксис подстановочных знаков, что и `allowedDomains`. Имеет приоритет над `allowedDomains` при совпадении обоих. Объединяется из всех источников параметров независимо от `allowManagedDomainsOnly`. | `["sensitive.cloud.example.com"]` |
| `network.allowManagedDomainsOnly` | (Только управляемые параметры) Только `allowedDomains` и правила разрешения `WebFetch(domain:...)` из управляемых параметров учитываются. Домены из параметров пользователя, проекта и локальной области игнорируются. Неразрешенные домены автоматически блокируются без запроса пользователя. Запрещенные домены по-прежнему учитываются из всех источников. По умолчанию: false | `true` |
| `network.httpProxyPort` | Порт HTTP прокси, используемый, если вы хотите использовать собственный прокси. Если не указано, Claude запустит собственный прокси. | `8080` |
| `network.socksProxyPort` | Порт SOCKS5 прокси, используемый, если вы хотите использовать собственный прокси. Если не указано, Claude запустит собственный прокси. | `8081` |
| `enableWeakerNestedSandbox` | Включить более слабый sandbox для непривилегированных окружений Docker (только Linux и WSL2). **Снижает безопасность.** По умолчанию: false | `true` |
| `enableWeakerNetworkIsolation` | (Только macOS) Разрешить доступ к системной службе доверия TLS (`com.apple.trustd.agent`) в sandbox. Требуется для инструментов на основе Go, таких как `gh`, `gcloud` и `terraform`, для проверки сертификатов TLS при использовании `httpProxyPort` с MITM прокси и пользовательским CA. **Снижает безопасность** путем открытия потенциального пути утечки данных. По умолчанию: false | `true` |
| `allowAppleEvents` | (Только macOS) Разрешить команды в sandbox отправлять Apple Events. Требуется для `open`, `osascript` и инструментов, которые открывают URL в браузере, которые в противном случае не удаются с ошибкой `-600`. **Удаляет изоляцию выполнения кода.** Команды в sandbox могут запускать другие приложения без sandbox без запроса пользователя; они также могут отправлять команды AppleScript запущенным приложениям, таким как Terminal, в соответствии с запросом согласия на автоматизацию macOS для каждого приложения (TCC). Учитывается только из параметров пользователя, управляемых или CLI, а не из параметров проекта. По умолчанию: false | `true` |
| `bwrapPath` | (Только управляемые параметры, Linux/WSL2) Абсолютный путь к двоичному файлу bubblewrap (`bwrap`). Переопределяет автоматическое обнаружение через `PATH`. Учитывается только из [управляемых параметров](/ru/settings#settings-files), а не из параметров пользователя или проекта. Полезно, когда `bwrap` установлен в нестандартном местоположении в управляемых окружениях. | `/opt/admin/bwrap` |
| `socatPath` | (Только управляемые параметры, Linux/WSL2) Абсолютный путь к двоичному файлу `socat`, используемому для прокси сети sandbox. Переопределяет автоматическое обнаружение через `PATH`. Учитывается только из управляемых параметров. | `/opt/admin/socat` |
Префиксы пути Sandbox
Пути в `filesystem.allowWrite`, `filesystem.denyWrite`, `filesystem.denyRead`, `filesystem.allowRead` и `credentials.files` поддерживают эти префиксы:
| Префикс | Значение | Пример |
| :-------------------- | :----------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------- |
| `/` | Абсолютный путь от корня файловой системы | `/tmp/build` остается `/tmp/build` |
| `~/` | Относительно домашнего каталога | `~/.kube` становится `$HOME/.kube` |
| `./` или без префикса | Относительно корня проекта для параметров проекта, или к `~/.claude` для параметров пользователя | `./output` в `.claude/settings.json` разрешается в `/output` |
Более старый префикс `//path` для абсолютных путей по-прежнему работает. Если вы ранее использовали одиночный слэш `/path`, ожидая разрешения относительно проекта, переключитесь на `./path`. Этот синтаксис отличается от [правил разрешения Read и Edit](/ru/permissions#read-and-edit), которые используют `//path` для абсолютного и `/path` для относительного к проекту. Пути файловой системы sandbox используют стандартные соглашения: `/tmp/build` - это абсолютный путь.
**Пример конфигурации:**
```json theme={null}
{
"sandbox": {
"enabled": true,
"autoAllowBashIfSandboxed": true,
"excludedCommands": ["docker *"],
"filesystem": {
"allowWrite": ["/tmp/build", "~/.kube"],
"denyRead": ["~/.aws/credentials"]
},
"network": {
"allowedDomains": ["github.com", "*.npmjs.org", "registry.yarnpkg.com"],
"deniedDomains": ["uploads.github.com"],
"allowUnixSockets": [
"/var/run/docker.sock"
],
"allowLocalBinding": true
}
}
}
```
**Ограничения файловой системы и сети** можно настроить двумя способами, которые объединяются вместе:
* **Параметры `sandbox.filesystem`** (показаны выше): Контролируют пути на границе sandbox уровня ОС. Эти ограничения применяются ко всем командам подпроцесса (например, `kubectl`, `terraform`, `npm`), а не только к инструментам файлов Claude.
* **Правила разрешений**: Используйте правила разрешения `Edit` allow/deny для управления доступом инструмента файлов Claude, правила `Read` deny для блокировки чтения и правила `WebFetch` allow/deny для управления доменами сети. Пути из этих правил также объединяются в конфигурацию sandbox.
Параметры атрибуции
Claude Code добавляет атрибуцию к коммитам git и pull requests. Они настраиваются отдельно:
* Коммиты используют [git trailers](https://git-scm.com/docs/git-interpret-trailers) (например, `Co-Authored-By`) по умолчанию, которые можно настроить или отключить
* Описания pull request - это простой текст
| Ключи | Описание |
| :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `commit` | Атрибуция для коммитов git, включая любые trailers. Пустая строка скрывает атрибуцию коммита |
| `pr` | Атрибуция для описаний pull request. Пустая строка скрывает атрибуцию pull request |
| `sessionUrl` | Добавлять ли ссылку на сеанс claude.ai как trailer `Claude-Session` на коммитах и ссылку в описаниях pull request при запуске из веб-сеанса или сеанса Remote Control. По умолчанию: `true`. Установите на `false`, чтобы опустить ссылку |
**Атрибуция коммита по умолчанию:**
```text theme={null}
Co-Authored-By: Claude Sonnet 5
```
Имя модели в trailer отражает активную модель для сеанса.
**Атрибуция pull request по умолчанию:**
```text theme={null}
🤖 Generated with [Claude Code](https://claude.com/claude-code)
```
**Пример:**
```json theme={null}
{
"attribution": {
"commit": "Generated with AI\n\nCo-Authored-By: AI ",
"pr": ""
}
}
```
Параметр `attribution` имеет приоритет над устаревшим параметром `includeCoAuthoredBy`. Чтобы скрыть всю атрибуцию, установите `commit` и `pr` на пустые строки и `sessionUrl` на `false`.
Параметры предложения файлов
Настройте пользовательскую команду для автодополнения пути файла `@`. Встроенное предложение файлов использует быстрый обход файловой системы, но большие монорепозитории могут выиграть от индексирования, специфичного для проекта, такого как предварительно построенный индекс файлов или пользовательские инструменты.
```json theme={null}
{
"fileSuggestion": {
"type": "command",
"command": "~/.claude/file-suggestion.sh"
}
}
```
Команда запускается с теми же переменными окружения, что и [hooks](/ru/hooks), включая `CLAUDE_PROJECT_DIR`. Она получает JSON через stdin с полем `query`:
```json theme={null}
{"query": "src/comp"}
```
Выведите пути файлов, разделенные новой строкой, в stdout (в настоящее время ограничено 15):
```text theme={null}
src/components/Button.tsx
src/components/Modal.tsx
src/components/Form.tsx
```
**Пример:**
```bash theme={null}
#!/bin/bash
query=$(cat | jq -r '.query')
# Замените your-repo-file-index на вашу собственную команду поиска файлов
your-repo-file-index --query "$query" | head -20
```
Параметр `footerLinksRegexes` отображает дополнительные кликабельные значки в нижнем колонтитуле ниже поля ввода. Используйте его для преобразования ID, выводимых проектными CLI, такими как инструменты проверки и трекеры проблем, в ссылки сеанса.
Регулярное выражение `pattern` каждой записи сопоставляется с выводом хода: результаты инструментов, включая содержимое файлов и полученные страницы, и собственные ответы Claude. Плейсхолдеры `{name}` в `url` и `label` заполняются из именованных групп захвата в шаблоне.
Следующий пример отображает значок всякий раз, когда ключ проблемы, такой как `PROJ-1234`, появляется в выводе хода. Именованная группа `(?...)` захватывает ключ, и `{key}` подставляет его в URL и метку:
```json ~/.claude/settings.json theme={null}
{
"footerLinksRegexes": [
{
"type": "regex",
"pattern": "\\b(?PROJ-\\d+)\\b",
"url": "https://issues.example.com/browse/{key}",
"label": "{key}"
}
]
}
```
С этой конфигурацией, когда `PROJ-1234` появляется в результате инструмента или в ответе Claude, чип `PROJ-1234` появляется в нижнем колонтитуле, ссылаясь на `https://issues.example.com/browse/PROJ-1234`.
Следующие ограничения применяются к каждой записи:
| Ограничение | Поведение |
| :----------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Источник URL | Захваченные значения кодируются в URL, и построенный URL должен совместно использовать источник шаблона. Захват может заполнить сегмент пути или значение запроса, но не может изменить, на что указывает ссылка |
| Длина URL | Построенные URL длиннее 2048 символов отбрасываются |
| Схема URL | Должна быть `https`, `http` или признанная схема deep-link редактора или рабочей области: `vscode`, `vscode-insiders`, `cursor`, `windsurf`, `zed`, `jetbrains`, `idea`, `slack`, `linear`, `notion`, `figma` |
| Метка | По умолчанию совпадает с текстом и усекается до 28 столбцов отображения |
| Количество значков | Максимум 5 значков отображаются. Самый старый вытесняется новыми совпадениями и `/clear` удаляет их |
| Область параметров | Читается из параметров пользователя, флага `--settings` и управляемых параметров только. Игнорируется в проекте `.claude/settings.json` и локальном `.claude/settings.local.json` |
Когда ход завершается, Claude Code сопоставляет регулярное выражение `pattern` каждой записи с выводом хода на основном потоке, поэтому медленное регулярное выражение блокирует пользовательский интерфейс до завершения. Вложенные квантификаторы, такие как `(a+)+$`, могут занимать экспоненциально долго против определенных входов и замораживать сеанс, поэтому держите каждый `pattern` линейным и избегайте вложения `+` или `*`.
Значки нижнего колонтитула отображаются рядом с [пользовательской строкой состояния](/ru/statusline), когда она настроена; ни один не заменяет другой. Используйте строку состояния для строки, управляемой скриптом, которая вычисляет свой собственный контент из данных сеанса, и значки нижнего колонтитула для преобразования ID из разговора в ссылки без скрипта.
Конфигурация Hook
Эти параметры контролируют, какие hooks разрешены для запуска и к чему могут получить доступ HTTP hooks. Параметр `allowManagedHooksOnly` можно настроить только в [управляемых параметрах](#settings-files). Списки разрешений URL и переменных окружения можно установить на любом уровне параметров и объединяются в разных источниках.
**Поведение, когда `allowManagedHooksOnly` равно `true`:**
* Управляемые hooks и SDK hooks загружаются
* Hooks из plugins, принудительно включенных в управляемых параметрах `enabledPlugins`, загружаются. Это позволяет администраторам распространять проверенные hooks через организационный marketplace, блокируя все остальное. Доверие предоставляется по полному ID `plugin@marketplace`, поэтому plugin с тем же именем из другого marketplace остается заблокированным
* Пользовательские hooks, проектные hooks и все остальные plugin hooks блокируются
**Ограничить URL HTTP hooks:**
Ограничьте, на какие URL могут быть направлены HTTP hooks. Поддерживает `*` как подстановочный знак для сопоставления. Когда массив определен, HTTP hooks, направленные на несовпадающие URL-адреса, молча блокируются. Сопоставление имен хостов не чувствительно к регистру и игнорирует завершающую точку FQDN, соответствуя семантике DNS.
```json theme={null}
{
"allowedHttpHookUrls": ["https://hooks.example.com/*", "http://localhost:*"]
}
```
**Ограничить переменные окружения HTTP hook:**
Ограничьте, какие имена переменных окружения HTTP hooks могут интерполировать в значения заголовков. Эффективный `allowedEnvVars` каждого hook является пересечением его собственного списка и этого параметра.
```json theme={null}
{
"httpHookAllowedEnvVars": ["MY_TOKEN", "HOOK_SECRET"]
}
```
Вычислить управляемые параметры с помощью помощника политики
Параметр `policyHelper` указывает на исполняемый файл, который вычисляет управляемые параметры при запуске, поэтому администраторы могут получить политику из состояния устройства, идентификации или удаленного сервиса вместо статического файла. Настройте его из MDM или системного файла `managed-settings.json`. Claude Code игнорирует `policyHelper`, когда он появляется в любой другой области, включая параметры пользователя, параметры проекта, куст реестра HKCU и [параметры, управляемые сервером](/ru/server-managed-settings).
Параметр принимает эти ключи:
| Ключ | Тип | Описание |
| ------------------- | ------ | -------------------------------------------------------------------------------------------------------------------- |
| `path` | string | Абсолютный путь к исполняемому файлу помощника |
| `timeoutMs` | number | Как долго ждать помощника перед обработкой запуска как неудачного |
| `refreshIntervalMs` | number | Как часто повторно запускать помощника в фоне. Установите на `0`, чтобы отключить обновление, или на минимум `60000` |
Помощник записывает конверт JSON в stdout. Поместите параметры под ключ `managedSettings` вместо верхнего уровня, так как объект параметров верхнего уровня анализируется с `managedSettings` неопределенным и не применяет ничего:
```json theme={null}
{
"managedSettings": {
"permissions": { "deny": ["Read(//etc/secrets/**)"] }
},
"claudeMd": "# Organization context\n...",
"appendSystemPrompt": "Always cite the internal style guide."
}
```
Когда помощник выдает `managedSettings`, этот объект заменяет параметры, управляемые на основе файлов, для запуска. Когда помощник выходит с ненулевым кодом при запуске, Claude Code выводит ошибку и отказывается запуститься, поэтому помощник, которому нужна устойчивость к сбоям, должен обслуживать из собственного кэша и выходить с `0`.
Приоритет параметров
Параметры применяются в порядке приоритета. От наивысшего к наименьшему:
1. **Управляемые параметры** ([управляемые сервером](/ru/server-managed-settings), [политики MDM/OS-уровня](#configuration-scopes) или [управляемые параметры](/ru/settings#settings-files))
* Политики, развернутые IT через доставку сервера, профили конфигурации MDM, политики реестра или файлы управляемых параметров
* Не могут быть переопределены никаким другим уровнем, включая аргументы командной строки
* В пределах управляемого уровня приоритет: [`policyHelper`](#compute-managed-settings-with-a-policy-helper) вывод, который при настройке является единственным используемым управляемым источником > удаленный (параметры, управляемые сервером claude.ai или [Claude apps gateway](/ru/claude-apps-gateway)-доставленные) > политики MDM/OS-уровня > на основе файлов (`managed-settings.d/*.json` + `managed-settings.json`) > реестр HKCU (только Windows). Используется только один управляемый источник; источники не объединяются в разных уровнях, с одним исключением: ключи блокировки sandbox `sandbox.network.allowManagedDomainsOnly` и `sandbox.filesystem.allowManagedReadPathsOnly`, с их связанными списками разрешений, `allowAllClaudeAiMcps` и пути двоичных файлов sandbox `sandbox.bwrapPath` и `sandbox.socatPath` учитываются, когда любой управляемый источник, контролируемый администратором, их устанавливает; уровень HKCU, доступный для записи пользователем, исключен. В пределах уровня на основе файлов, drop-in файлы и базовый файл объединяются вместе.
* Хосты встраивания, такие как Claude Desktop, могут предоставлять политику через опцию SDK `managedSettings`. По умолчанию это игнорируется, когда присутствует любой управляемый источник, развернутый администратором: параметры, управляемые сервером, политика MDM или OS-уровня, или файл управляемых параметров. Резервный реестр HKCU, доступный для записи пользователем, не считается управляемым источником, развернутым администратором. Администраторы могут согласиться, установив [`parentSettingsBehavior`](#available-settings) на `"merge"`. Значения встраивателя отфильтрованы, чтобы они могли ужесточить управляемую политику, но не ослабить ее.
2. **Аргументы командной строки**
* Временные переопределения для конкретного сеанса. JSON, переданный через `--settings `, объединяется с параметрами на основе файлов, используя те же правила, что и другие уровни: ключ, установленный здесь, переопределяет тот же ключ в локальных, проектных или пользовательских параметрах, и пропуск ключа оставляет значение нижнего уровня на месте
3. **Локальные параметры проекта** (`.claude/settings.local.json`)
* Личные параметры, специфичные для проекта
4. **Общие параметры проекта** (`.claude/settings.json`)
* Параметры проекта, совместно используемые командой в системе управления версиями
5. **Параметры пользователя** (`~/.claude/settings.json`)
* Личные глобальные параметры
Эта иерархия гарантирует, что организационные политики всегда применяются, при этом позволяя командам и отдельным лицам настраивать свой опыт. Один и тот же приоритет применяется независимо от того, запускаете ли вы Claude Code из CLI, [расширения VS Code](/ru/vs-code) или [JetBrains IDE](/ru/jetbrains).
Например, если ваши параметры пользователя установили `permissions.defaultMode` на `acceptEdits` и параметры проекта установили его на `default`, применяется значение проекта. Пример ниже охватывает, как вместо этого объединяются параметры со значениями массива, такие как правила разрешений.
**Параметры массива объединяются в разных областях.** Когда один и тот же параметр со значением массива (такой как `sandbox.filesystem.allowWrite` или `permissions.allow`) появляется в нескольких областях, массивы **объединяются и дедублицируются**, не заменяются. Это означает, что области с более низким приоритетом могут добавлять записи без переопределения установленных областями с более высоким приоритетом, и наоборот. Например, если управляемые параметры устанавливают `allowWrite` на `["/opt/company-tools"]` и пользователь добавляет `["~/.kube"]`, оба пути включены в окончательную конфигурацию.
Два параметра массива не объединяются таким образом:
* [`fallbackModel`](#available-settings) - это упорядоченная цепь, где позиция имеет значение: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь.
* [`availableModels`](#available-settings): {/* min-version: 2.1.175 */}когда [источник управляемых параметров с наивысшим приоритетом](/ru/server-managed-settings#settings-precedence) его определяет, этот список применяется как есть и записи пользователя, проекта и локальной области не могут его расширить. В разных неуправляемых областях массивы объединяются как обычно. См. [Поведение объединения](/ru/model-config#merge-behavior).
Проверить активные параметры
Запустите `/status` внутри Claude Code, чтобы увидеть, какие источники параметров активны. Внутри меню вкладка **Status** включает строку `Setting sources`, которая перечисляет каждый уровень Claude Code, заг загруженный для текущего сеанса, такой как `User settings` или `Project local settings`. Когда действуют [управляемые параметры](/ru/admin-setup#decide-how-settings-reach-devices), запись показывает канал доставки в скобках, например `Enterprise managed settings (remote)`, `(plist)`, `(HKLM)`, `(HKCU)` или `(file)`. Уровень появляется в списке только когда этот источник загружается с по крайней мере одним ключом, поэтому пустой список означает, что источники параметров не были найдены.
Строка `Setting sources` подтверждает, какие источники читаются. Она не показывает, какой уровень предоставил каждый отдельный ключ. Вкладка **Config** в том же диалоге - это редактор для фиксированного набора переключателей, таких как тема и подробный вывод, а не представление содержимого вашего `settings.json`.
Если файл параметров содержит ошибки, такие как недействительный JSON или значение, которое не прошло валидацию, `/status` перечисляет затронутые файлы. Запустите `/doctor` для деталей каждой ошибки.
Ключевые моменты о системе конфигурации
* **Файлы памяти (`CLAUDE.md`)**: Содержат инструкции и контекст, которые Claude загружает при запуске
* **Файлы параметров (JSON)**: Настраивают разрешения, переменные окружения и поведение инструмента
* **Skills**: Пользовательские запросы, которые можно вызвать с помощью `/skill-name` или загружены Claude автоматически
* **MCP servers**: Расширяют Claude Code дополнительными инструментами и интеграциями
* **Приоритет**: Конфигурации более высокого уровня (Managed) переопределяют конфигурации более низкого уровня (User/Project)
* **Наследование**: Параметры объединяются в разных областях; скалярные значения из областей с более высоким приоритетом переопределяют, и массивы объединяются, с двумя исключениями, описанными в [примечании об объединении массивов](#settings-precedence)
Системный запрос
Внутренний системный запрос Claude Code не опубликован. Чтобы добавить пользовательские инструкции, используйте файлы `CLAUDE.md` или флаг `--append-system-prompt`.
Исключение чувствительных файлов
Чтобы предотвратить доступ Claude Code к файлам, содержащим чувствительную информацию, такую как ключи API, секреты и файлы окружения, используйте параметр `permissions.deny` в вашем файле `.claude/settings.json`:
```json theme={null}
{
"permissions": {
"deny": [
"Read(./.env)",
"Read(./.env.*)",
"Read(./secrets/**)",
"Read(./config/credentials.json)",
"Read(./build)"
]
}
}
```
Это заменяет устаревшую конфигурацию `ignorePatterns`. Файлы, соответствующие этим шаблонам, исключаются из обнаружения файлов и результатов поиска, и операции чтения этих файлов запрещены.
Конфигурация Subagent
Claude Code поддерживает пользовательские AI subagents, которые можно настроить на уровне пользователя и проекта. Эти subagents хранятся как файлы Markdown с YAML frontmatter:
* **Subagents пользователя**: `~/.claude/agents/`, доступны во всех ваших проектах
* **Subagents проекта**: `.claude/agents/`, специфичны для вашего проекта и могут быть совместно использованы с вашей командой
Файлы Subagent определяют специализированных AI помощников с пользовательскими запросами и разрешениями инструментов. Узнайте больше о создании и использовании subagents в [документации subagents](/ru/sub-agents).
Конфигурация Plugin
Claude Code поддерживает систему plugins, которая позволяет вам расширить функциональность с помощью skills, agents, hooks и MCP servers. Plugins распространяются через marketplaces и могут быть настроены на уровне пользователя и репозитория.
Параметры Plugin
Параметры, связанные с plugins, в `settings.json`:
```json theme={null}
{
"enabledPlugins": {
"formatter@acme-tools": true,
"deployer@acme-tools": true,
"analyzer@security-plugins": false
},
"extraKnownMarketplaces": {
"acme-tools": {
"source": {
"source": "github",
"repo": "acme-corp/claude-plugins"
}
}
}
}
```
`enabledPlugins`
Контролирует, какие plugins включены. Формат: `"plugin-name@marketplace-name": true/false`. Plugin без записи в любой области возвращается к его значению [`defaultEnabled`](/ru/plugins-reference#default-enablement).
**Области**:
* **Параметры пользователя** (`~/.claude/settings.json`): Личные предпочтения plugins
* **Параметры проекта** (`.claude/settings.json`): Plugins, специфичные для проекта, совместно используемые с командой
* **Локальные параметры** (`.claude/settings.local.json`): Переопределения для каждой машины, не зафиксированные, когда Claude Code их создает
* **Управляемые параметры** (`managed-settings.json`): Переопределения организационной политики, которые блокируют установку на всех уровнях и скрывают plugin из marketplace
Параметры проекта имеют приоритет над параметрами пользователя, поэтому установка plugin на `false` в `~/.claude/settings.json` не отключает plugin, который параметры проекта `.claude/settings.json` включают. Чтобы отказаться от plugin, включенного проектом, на вашей машине, установите его на `false` в `.claude/settings.local.json` вместо этого.
Plugins, принудительно включенные управляемыми параметрами, не могут быть отключены таким образом, так как управляемые параметры переопределяют локальные параметры.
Включение plugin из внешнего источника, такого как репозиторий GitHub или пакет npm, в файле `.claude/settings.json` проекта не устанавливает его для других людей. Начиная с Claude Code v2.1.195, каждый путь, который загружает plugins, просит каждого пользователя [установить и доверить plugin](/ru/discover-plugins#configure-team-marketplaces) перед его запуском.
**Пример**:
```json theme={null}
{
"enabledPlugins": {
"code-formatter@team-tools": true,
"deployment-tools@team-tools": true,
"experimental-features@personal": false
}
}
```
Определяет дополнительные marketplaces, которые должны быть доступны для репозитория. Обычно используется в параметрах уровня репозитория для обеспечения доступа членов команды к требуемым источникам plugins.
**Когда репозиторий включает `extraKnownMarketplaces`**:
1. Членам команды предлагается установить marketplace при доверии папке
2. Членам команды затем предлагается установить plugins из этого marketplace
3. Пользователи могут пропустить нежелательные marketplaces или plugins (хранятся в параметрах пользователя)
4. Установка соблюдает границы доверия и требует явного согласия
**Пример**:
```json theme={null}
{
"extraKnownMarketplaces": {
"acme-tools": {
"source": {
"source": "github",
"repo": "acme-corp/claude-plugins"
}
},
"security-plugins": {
"source": {
"source": "git",
"url": "https://git.example.com/security/plugins.git"
}
}
}
}
```
**Типы источников Marketplace**:
* `github`: Репозиторий GitHub (использует `repo`)
* `git`: Любой URL git (использует `url`)
* `directory`: Путь локальной файловой системы (использует `path`, только для разработки)
* `hostPattern`: Шаблон regex для сопоставления хостов marketplace (использует `hostPattern`)
* `settings`: встроенный marketplace, объявленный непосредственно в settings.json без отдельного размещенного репозитория (использует `name` и `plugins`)
Тип источника `git` работает с любым сервисом хостинга git, включая самостоятельно размещенные GitLab и Bitbucket. Claude Code клонирует репозиторий с той же аутентификацией, которую использовал бы `git clone` на этой машине: настроенные помощники учетных данных, ключи SSH или переменная окружения токена, специфичная для хоста. См. [Приватные репозитории](/ru/plugin-marketplaces#private-repositories) для деталей настройки.
Для источников `github` и `git` установите `"skipLfs": true` внутри объекта `source` (рядом с `repo` или `url`) для пропуска загрузок Git LFS, когда Claude Code клонирует или обновляет репозиторий marketplace. Файлы указателей LFS остаются указателями вместо загрузки их содержимого. Используйте это, когда репозиторий содержит большие объекты LFS, не связанные с содержимым plugin. {/* min-version: 2.1.153 */}Требует Claude Code v2.1.153 или позже.
Каждая запись marketplace также принимает опциональное логическое значение `autoUpdate`. Установите `"autoUpdate": true` рядом с `source`, чтобы Claude Code обновлял этот marketplace и обновлял его установленные plugins при запуске. Если опущено, официальные marketplaces Anthropic по умолчанию имеют значение `true`, а все остальные marketplaces по умолчанию имеют значение `false`. См. [Настройка автоматических обновлений](/ru/discover-plugins#configure-auto-updates).
Используйте `source: 'settings'` для объявления небольшого набора plugins встроенным образом без настройки размещенного репозитория marketplace. Plugins, указанные здесь, должны ссылаться на внешние источники, такие как GitHub или npm. Вам по-прежнему нужно включить каждый plugin отдельно в `enabledPlugins`.
```json theme={null}
{
"extraKnownMarketplaces": {
"team-tools": {
"source": {
"source": "settings",
"name": "team-tools",
"plugins": [
{
"name": "code-formatter",
"source": {
"source": "github",
"repo": "acme-corp/code-formatter"
}
}
]
}
}
}
}
```
`strictKnownMarketplaces`
**Только управляемые параметры**: Контролирует, какие marketplaces plugins пользователи могут добавить и установить plugins из них. Этот параметр можно настроить только в [управляемых параметрах](/ru/settings#settings-files) и предоставляет администраторам строгий контроль над источниками marketplace.
**Местоположения файлов управляемых параметров**:
* **macOS**: `/Library/Application Support/ClaudeCode/managed-settings.json`
* **Linux и WSL**: `/etc/claude-code/managed-settings.json`
* **Windows**: `C:\Program Files\ClaudeCode\managed-settings.json`
**Ключевые характеристики**:
* Доступно только в управляемых параметрах (`managed-settings.json`)
* Не может быть переопределено параметрами пользователя или проекта (наивысший приоритет)
* Применяется ДО операций сети/файловой системы (заблокированные источники никогда не выполняются)
* Использует точное сопоставление для спецификаций источников (включая `ref`, `path` для источников git), кроме `hostPattern` и `pathPattern`, которые используют сопоставление regex
**Поведение списка разрешений**:
* `undefined` (по умолчанию): Без ограничений - пользователи могут добавить любой marketplace
* Пустой массив `[]`: Полная блокировка - пользователи не могут добавить новые marketplaces
* Список источников: Пользователи могут добавить только marketplaces, которые точно совпадают
**Все поддерживаемые типы источников**:
Список разрешений поддерживает несколько типов источников marketplace. Большинство источников используют точное сопоставление, в то время как `hostPattern` и `pathPattern` используют сопоставление regex с хостом marketplace и путем файловой системы соответственно.
1. **Репозитории GitHub**:
```json theme={null}
{ "source": "github", "repo": "acme-corp/approved-plugins" }
{ "source": "github", "repo": "acme-corp/security-tools", "ref": "v2.0" }
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }
```
Поля: `repo` (обязательно), `ref` (опционально: ветка или тег), `path` (опционально: подкаталог)
2. **Репозитории Git**:
```json theme={null}
{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }
{ "source": "git", "url": "https://bitbucket.org/acme-corp/plugins.git", "ref": "production" }
{ "source": "git", "url": "ssh://git@git.example.com/plugins.git", "ref": "v3.1", "path": "approved" }
```
Поля: `url` (обязательно), `ref` (опционально: ветка или тег), `path` (опционально: подкаталог)
3. **Marketplaces на основе URL**:
```json theme={null}
{ "source": "url", "url": "https://plugins.example.com/marketplace.json" }
{ "source": "url", "url": "https://cdn.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }
```
Поля: `url` (обязательно), `headers` (опционально: HTTP заголовки для аутентифицированного доступа)
Marketplaces на основе URL загружают только файл `marketplace.json`. Они не загружают файлы plugins с сервера. Plugins в marketplaces на основе URL должны использовать внешние источники (GitHub, npm или URL git) вместо относительных путей. Для plugins с относительными путями используйте marketplace на основе Git. См. [Troubleshooting](/ru/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces) для деталей.
4. **Пакеты NPM**:
```json theme={null}
{ "source": "npm", "package": "@acme-corp/claude-plugins" }
{ "source": "npm", "package": "@acme-corp/approved-marketplace" }
```
Поля: `package` (обязательно, поддерживает scoped пакеты)
5. **Пути файлов**:
```json theme={null}
{ "source": "file", "path": "/usr/local/share/claude/acme-marketplace.json" }
{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }
```
Поля: `path` (обязательно: абсолютный путь к файлу marketplace.json)
6. **Пути каталогов**:
```json theme={null}
{ "source": "directory", "path": "/usr/local/share/claude/acme-plugins" }
{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }
```
Поля: `path` (обязательно: абсолютный путь к каталогу, содержащему `.claude-plugin/marketplace.json`)
7. **Сопоставление шаблона хоста**:
```json theme={null}
{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }
{ "source": "hostPattern", "hostPattern": "^gitlab\\.internal\\.example\\.com$" }
```
Поля: `hostPattern` (обязательно: шаблон regex для сопоставления с хостом marketplace)
Используйте сопоставление шаблона хоста, когда вы хотите разрешить все marketplaces с определенного хоста без перечисления каждого репозитория отдельно. Это полезно для организаций с внутренними серверами GitHub Enterprise или GitLab, где разработчики создают свои собственные marketplaces.
Извлечение хоста по типу источника:
* `github`: всегда сопоставляется с `github.com`
* `git`: извлекает имя хоста из URL (поддерживает форматы HTTPS и SSH)
* `url`: извлекает имя хоста из URL
* `npm`, `file`, `directory`: не поддерживается для сопоставления шаблона хоста
8. **Сопоставление шаблона пути**:
```json theme={null}
{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }
{ "source": "pathPattern", "pathPattern": ".*" }
```
Поля: `pathPattern` (обязательно: шаблон regex, сопоставляемый с полем `path` источников `file` и `directory`)
Используйте сопоставление шаблона пути для разрешения marketplaces на основе файловой системы наряду с ограничениями `hostPattern` для сетевых источников. Установите `".*"` для разрешения всех локальных путей или более узкий шаблон для ограничения определенными каталогами.
**Примеры конфигурации**:
Пример: разрешить только определенные marketplaces:
```json theme={null}
{
"strictKnownMarketplaces": [
{
"source": "github",
"repo": "acme-corp/approved-plugins"
},
{
"source": "github",
"repo": "acme-corp/security-tools",
"ref": "v2.0"
},
{
"source": "url",
"url": "https://plugins.example.com/marketplace.json"
},
{
"source": "npm",
"package": "@acme-corp/compliance-plugins"
}
]
}
```
Пример: отключить все добавления marketplace:
```json theme={null}
{
"strictKnownMarketplaces": []
}
```
Пример: разрешить все marketplaces с внутреннего git сервера:
```json theme={null}
{
"strictKnownMarketplaces": [
{
"source": "hostPattern",
"hostPattern": "^github\\.example\\.com$"
}
]
}
```
**Требования точного сопоставления**:
Источники marketplace должны совпадать точно для разрешения добавления пользователем. Для источников на основе git (`github` и `git`), это включает все опциональные поля:
* `repo` или `url` должны совпадать точно
* Поле `ref` должно совпадать точно (или оба быть не определены)
* Поле `path` должно совпадать точно (или оба быть не определены)
Примеры источников, которые не совпадают:
```json theme={null}
// Это РАЗНЫЕ источники:
{ "source": "github", "repo": "acme-corp/plugins" }
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main" }
// Это также РАЗНЫЕ:
{ "source": "github", "repo": "acme-corp/plugins", "path": "marketplace" }
{ "source": "github", "repo": "acme-corp/plugins" }
```
**Сравнение с `extraKnownMarketplaces`**:
| Аспект | `strictKnownMarketplaces` | `extraKnownMarketplaces` |
| ----------------------------- | ----------------------------------------------------- | ------------------------------------------------------ |
| **Назначение** | Применение организационной политики | Удобство команды |
| **Файл параметров** | Только `managed-settings.json` | Любой файл параметров |
| **Поведение** | Блокирует добавления, не входящие в список разрешений | Автоматически устанавливает отсутствующие marketplaces |
| **Когда применяется** | До операций сети/файловой системы | После запроса доверия пользователя |
| **Может быть переопределено** | Нет (наивысший приоритет) | Да (параметрами с более высоким приоритетом) |
| **Формат источника** | Прямой объект источника | Именованный marketplace с вложенным источником |
| **Случай использования** | Соответствие, ограничения безопасности | Адаптация, стандартизация |
**Различие формата**:
`strictKnownMarketplaces` использует прямые объекты источников:
```json theme={null}
{
"strictKnownMarketplaces": [
{ "source": "github", "repo": "acme-corp/plugins" }
]
}
```
`extraKnownMarketplaces` требует именованные marketplaces:
```json theme={null}
{
"extraKnownMarketplaces": {
"acme-tools": {
"source": { "source": "github", "repo": "acme-corp/plugins" }
}
}
}
```
**Использование обоих вместе**:
`strictKnownMarketplaces` - это политический шлюз: он контролирует, что пользователи могут добавить, но не регистрирует никакие marketplaces. Чтобы одновременно ограничить и предварительно зарегистрировать marketplace для всех пользователей, установите оба в `managed-settings.json`:
```json theme={null}
{
"strictKnownMarketplaces": [
{ "source": "github", "repo": "acme-corp/plugins" }
],
"extraKnownMarketplaces": {
"acme-tools": {
"source": { "source": "github", "repo": "acme-corp/plugins" }
}
}
}
```
Если установлен только `strictKnownMarketplaces`, пользователи по-прежнему могут добавить разрешенный marketplace вручную через `/plugin marketplace add`, но он не доступен автоматически.
**Важные примечания**:
* Ограничения проверяются ДО любых запросов сети или операций файловой системы
* При блокировке пользователи видят четкие сообщения об ошибках, указывающие, что источник заблокирован управляемой политикой
* Ограничение применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin. Marketplace, добавленный до установки политики, не может быть использован для установки или обновления plugins после того, как его источник больше не совпадает со списком разрешений
* Управляемые параметры имеют наивысший приоритет и не могут быть переопределены
См. [Управляемые ограничения marketplace](/ru/plugin-marketplaces#managed-marketplace-restrictions) для документации, ориентированной на пользователя.
`strictPluginOnlyCustomization`
**Только управляемые параметры**: блокирует skills, agents, hooks и MCP servers из источников пользователя и проекта, поэтому они могут поступать только из plugins или управляемых параметров. Объедините это с `strictKnownMarketplaces` для контроля полной цепочки поставок настройки: список разрешений marketplace контролирует, какие plugins пользователи могут установить, и этот параметр блокирует все, что не поступает из plugin или из управляемых параметров.
`strictPluginOnlyCustomization` требует Claude Code v2.1.82 или позже. Более ранние версии игнорируют ключ и продолжают загружать пользовательские и проектные настройки, поэтому блокировка не применяется до обновления клиентов.
Значение либо `true` для блокировки всех четырех поверхностей, либо массив, называющий поверхности для блокировки:
```json theme={null}
{
"strictPluginOnlyCustomization": ["skills", "hooks"]
}
```
Для каждой заблокированной поверхности Claude Code пропускает источники уровня пользователя и проекта и загружает только plugin-предоставленные и управляемые источники:
| Поверхность | Заблокировано при блокировке | Все еще загружает |
| :---------- | :-------------------------------------------------------------- | :----------------------------------------------------------------------- |
| `skills` | `~/.claude/skills/`, `.claude/skills/` | Plugin skills, встроенные skills, skills в каталоге управляемой политики |
| `agents` | `~/.claude/agents/`, `.claude/agents/` | Plugin agents, встроенные agents, agents в каталоге управляемой политики |
| `hooks` | Hooks в пользовательских, проектных и локальных `settings.json` | Plugin hooks, hooks в управляемых параметрах |
| `mcp` | Servers в `~/.claude.json` и `.mcp.json` | Plugin MCP servers, [`managed-mcp.json`](/ru/managed-mcp) servers |
Имена поверхностей, которые версия Claude Code не распознает, игнорируются, а не вызывают ошибку файла параметров, поэтому вы можете добавить новые имена поверхностей до того, как все клиенты обновятся.
Управление Plugins
Используйте команду `/plugin` для интерактивного управления plugins:
* Просмотрите доступные plugins из marketplaces
* Установите/удалите plugins
* Включите/отключите plugins
* Просмотрите детали plugins (skills, agents, hooks, предоставляемые)
* Добавьте/удалите marketplaces
Узнайте больше о системе plugins в [документации plugins](/ru/plugins).
Переменные окружения
Переменные окружения позволяют вам управлять поведением Claude Code без редактирования файлов параметров. Любая переменная также может быть настроена в [`settings.json`](#available-settings) под ключом `env` для применения к каждому сеансу или развертывания для вашей команды.
См. [справочник переменных окружения](/ru/env-vars) для полного списка.
Claude Code имеет доступ к набору инструментов для чтения, редактирования, поиска, запуска команд и организации subagents. Имена инструментов - это точные строки, которые вы используете в правилах разрешений и сопоставителях hooks.
См. [справочник инструментов](/ru/tools-reference) для полного списка и деталей поведения инструмента Bash.
См. также
* [Permissions](/ru/permissions): система разрешений, синтаксис правил, шаблоны, специфичные для инструментов, и управляемые политики
* [Authentication](/ru/authentication): настройка доступа пользователей к Claude Code
* [Debug your configuration](/ru/debug-your-config): диагностика причин, по которым параметр, hook или MCP сервер не вступают в силу
* [Troubleshoot installation and login](/ru/troubleshoot-install): установка, аутентификация и проблемы платформы