Все параметры

​

Индекс настроек

​

Модель и ответы

​

advisorModel

• Область действия: Any file
• Тип: строка, один из псевдонимов "fable", "opus" или "sonnet", которые разрешаются в текущую версию по умолчанию соответствующего семейства моделей в Claude Code, либо полный ID модели, например "claude-opus-5-5"
• По умолчанию: не задано, поэтому advisor отключён
• Переопределения для сессии: --advisor имеет приоритет над этим ключом для одной сессии. CLAUDE_CODE_DISABLE_ADVISOR_TOOL отключает advisor, и этот ключ не может снова его включить

{
  "advisorModel": "opus"
}

​

alwaysThinkingEnabled

• Область действия: Any file
• Тип: Boolean
  • true: не действует; мышление уже включено
  • false: Claude Code отключает расширенное мышление для всех сессий
• По умолчанию: не задано, поэтому мышление включено для моделей, которые его поддерживают
• Переопределения для сессии: MAX_THINKING_TOKENS имеет приоритет над этим ключом для одной сессии: 0 отключает мышление с теми же ограничениями модели и провайдера, что и false, а положительное значение включает мышление, даже если этот ключ равен false. На моделях с адаптивными рассуждениями само число игнорируется

{
  "alwaysThinkingEnabled": false
}

​

availableModels

• Область действия: Any file. Разверните его в управляемых настройках, чтобы применить принудительно для организации.
• Тип: массив псевдонимов или ID моделей
• По умолчанию: не задано, поэтому доступны все модели

{
  "availableModels": ["sonnet", "haiku"]
}

​

availableModelsMatch

• Область действия: Managed. Claude Code игнорирует ключ в пользовательских, проектных и локальных настройках, а также в --settings, с предупреждением
• Тип: строка, одно из значений:
  • "prefix": запись с ID модели разрешает свою версию и любой ID модели, который расширяет его ещё одним сегментом
  • "exact": запись с ID модели разрешает только указанную в ней версию, поэтому "claude-opus-5" разрешает Opus 5, но не claude-opus-5-5. Запись вроде "claude-opus-4-5" также разрешает свой ID модели Anthropic с датой claude-opus-4-5-20251101. Псевдоним семейства, например "opus", по-прежнему разрешает всё семейство, а записи best, opusplan и default игнорируются
• По умолчанию: "prefix"

{
  "availableModels": ["claude-opus-5", "claude-sonnet-5"],
  "availableModelsMatch": "exact"
}

​

deniedModels

• Область действия: Managed. Claude Code игнорирует ключ в пользовательских, проектных и локальных настройках, а также в --settings, с предупреждением
• Тип: массив псевдонимов или ID моделей
  • Псевдоним семейства, например "opus", блокирует все модели этого семейства
  • ID модели, например "claude-opus-5-5", блокирует эту версию в любом написании, включая ID с датами и ID конкретных провайдеров
  • ID модели без минорной версии, например "claude-opus-5", также блокирует более поздние минорные версии, например Opus 5.5. Укажите "claude-opus-5-0", чтобы заблокировать только Opus 5
  • Записи best, opusplan и default игнорируются
• По умолчанию: не задано, поэтому ни одна модель не заблокирована

{
  "availableModels": ["opus", "sonnet"],
  "deniedModels": ["claude-opus-5-5"]
}

​

effortLevel

• Область действия: Any file
• Тип: строка, одно из значений:
  • "low": минимум рассуждений, для коротких, чётко ограниченных задач, чувствительных к задержке и не чувствительных к уровню интеллекта модели
  • "medium": сокращает расход токенов для работы, чувствительной к стоимости, где допустимо пожертвовать частью интеллекта
  • "high": баланс между расходом токенов и интеллектом
  • "xhigh": более глубокие рассуждения при большем расходе токенов
• По умолчанию: не задано
• Переопределения для сессии: --effort имеет приоритет над этим ключом для одной сессии, а CLAUDE_CODE_EFFORT_LEVEL имеет приоритет над обоими

{
  "effortLevel": "xhigh"
}

​

enforceAvailableModels

• Область действия: Any file
• Тип: Boolean
  • true: когда Default разрешился бы в модель вне availableModels, Claude Code разрешает его в первую доступную модель из списка
  • false: этот ключ не меняет то, как разрешается Default
• По умолчанию: false

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

​

fallbackModel

• Область действия: Any file
• Тип: массив псевдонимов или ID моделей; "default" раскрывается в модель по умолчанию
• По умолчанию: не задано, поэтому неудавшийся запрос не повторяется на другой модели
• Переопределения для сессии: --fallback-model имеет приоритет над этим ключом для одной сессии

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

​

fastMode

• Область действия: Any file
• Тип: Boolean
  • true: Claude Code включает быстрый режим для сессий, где он доступен
  • false: быстрый режим остаётся выключенным
• По умолчанию: не задано, поэтому быстрый режим выключен
• Переопределения для сессии: CLAUDE_CODE_DISABLE_FAST_MODE отключает быстрый режим для одной сессии, и этот ключ не может снова его включить

{
  "fastMode": true
}

​

fastModePerSessionOptIn

• Область действия: Any file
• Тип: Boolean
  • true: сохранённое fastMode: true больше не включает быстрый режим при запуске сессии, поэтому каждый пользователь выполняет /fast в каждой сессии, где он нужен; fastMode: true, переданное через --settings, по-прежнему учитывается для этой сессии, если этот ключ не задан в управляемых настройках
  • false: сохранённое fastMode: true включает быстрый режим в начале каждой последующей сессии
• По умолчанию: false

{
  "fastModePerSessionOptIn": true
}

​

language

• Область действия: Any file
• Тип: строка, любое название языка, например "japanese", "spanish" или "french"; Claude Code его не проверяет
• По умолчанию: не задано; названия сессий в этом случае соответствуют языку вашего диалога

{
  "language": "japanese"
}

​

maxEffortLevel

• Область действия: Any file. Разверните его в управляемых настройках, чтобы применить принудительно для организации. Если ограничение задано в нескольких областях действия, применяется самое низкое, поэтому ограничение, заданное в одной области действия, нельзя повысить из другой
• Тип: строка, одно из значений "low", "medium", "high", "xhigh" или "max". Значение "max" не задаёт ограничения
• По умолчанию: не задано, поэтому ограничение не применяется
• Ограничения для отдельных моделей: добавьте maxEffortLevel в запись модели в modelSettings. Эта запись заменяет этот ключ для данной модели только в пределах источника настроек, который задаёт оба, например ваших пользовательских настроек или одного управляемого источника. Укажите там "max", чтобы исключить модель из ограничения этого источника; Claude Code по-прежнему применяет ограничения из других источников

{
  "maxEffortLevel": "medium",
  "modelSettings": {
    "claude-sonnet-4-6": {
      "maxEffortLevel": "max"
    }
  }
}

​

model

• Область действия: Any file
• Тип: строка, псевдоним модели или полный ID модели
• По умолчанию: не задано, поэтому Claude Code использует модель по умолчанию для вашей учётной записи
• Переопределения для сессии: --model имеет приоритет над ANTHROPIC_MODEL, и оба имеют приоритет над этим ключом для одной сессии, в том числе над управляемым model; список availableModels по-прежнему применяется к выбору

{
  "model": "claude-sonnet-5"
}

​

modelOverrides

• Область действия: Any file
• Тип: объект, сопоставляющий ID модели с ID модели провайдера
• По умолчанию: не задано

{
  "modelOverrides": {
    "claude-opus-4-6": "arn:aws:bedrock:us-east-1:123456789012:inference-profile/example"
  }
}

​

modelPicker

• Область действия: User or managed. Claude Code читает ключ из управляемых настроек, --settings и пользовательских настроек и игнорирует его в проектных и локальных настройках, чтобы клонированный вами репозиторий не мог переименовать пункты окна выбора. Весь набор задаёт тот из этих трёх источников с наивысшим приоритетом, в котором задан ключ, и Claude Code никогда не объединяет наборы из двух источников.
• Тип: объект с массивом строк options и необязательным Boolean replaceBuiltInOptions
• По умолчанию: не задано, поэтому окно выбора показывает встроенный набор

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

​

Поля для modelPicker

• Удалена: строка, которую Claude Code не может обслужить, например выведенная из эксплуатации модель или модель, к которой у вашей организации нет доступа
• Неактивна: строка, которую вы пока не можете выбрать, показывается с указанием причины
• Не осталось ни одной строки: Claude Code сохраняет встроенный набор, отфильтрованный по списку разрешённых моделей как обычно

​

modelPricing

• Область действия: Managed. Разверните ключ через настройки, управляемые сервером, политику MDM, файл managed-settings.json или вспомогательную программу политики. Claude Code игнорирует его в пользовательских, проектных и локальных настройках, в --settings и в Windows в доступном пользователю для записи реестре HKCU. При использовании настроек, управляемых сервером, каждая сессия показывает расходы по прейскуранту, пока получение настроек этой сессии не подтвердит настройку. Хост-приложение, которое встраивает Claude Code и задаёт CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, может передать собственную таблицу через параметр SDK managedSettings, которую Claude Code использует, только если ни один управляемый источник не задаёт ключ, и только в Claude Code v2.1.246 или новее.
• Тип: объект с необязательным multiplier и необязательной картой overrides
• По умолчанию: не задано, поэтому Claude Code показывает расходы по прейскуранту, если хост-приложение не передаёт таблицу

{
  "modelPricing": {
    "multiplier": 0.85,
    "overrides": {
      "claude-sonnet-4-6": {
        "input": 2.4,
        "output": 12,
        "cacheRead": 0.24,
        "cacheWrite": 3
      }
    }
  }
}

​

Поля для modelPricing

​

К каким моделям применяется строка modelPricing

• ID встроенной модели: ключ, который сам Claude Code использует для встроенной модели, будь то собственный ID модели, например claude-sonnet-4-6, или её ID в Bedrock, Agent Platform или Foundry. Claude Code применяет строку ко всем ID снимков с датами и ID конкретных провайдеров этой модели.
• Любой другой ключ: ключ, который не является ID встроенной модели, например псевдоним модели в шлюзе. Claude Code применяет строку только к этому одному ID. Когда ID модели точно совпадает с одним из ваших ключей и также подпадает под строку с ключом ID встроенной модели, Claude Code использует точное совпадение.
• Профиль инференса приложения Bedrock: как только Claude Code определил модель, на которую направляет профиль, через вашу карту modelOverrides или поиск bedrock:GetInferenceProfile, Claude Code применяет к профилю строку этой модели.

​

modelSettings

• Область действия: Any file
• Тип: объект, сопоставляющий имя модели с объектом, содержащим любые из этих полей:
  • effortLevel: одно из значений "low", "medium", "high" или "xhigh"
  • maxEffortLevel: наивысший уровень effort, на котором может работать модель
  • autoCompactWindow: число токенов от 100000 до 1000000 или "auto" для окна, настроенного для модели. /autocompact сохраняет значение сюда. Для этой модели значение имеет приоритет над autoCompactWindow верхнего уровня в том же файле настроек. Требуется Claude Code v2.1.288 или новее
• По умолчанию: не задано

{
  "modelSettings": {
    "claude-opus-5-5": {
      "effortLevel": "high"
    }
  }
}

​

outputStyle

• Область действия: Any file
• Тип: строка, имя встроенного или пользовательского стиля вывода
• По умолчанию: не задано, поэтому Claude Code использует стиль по умолчанию

{
  "outputStyle": "Explanatory"
}

​

promptCacheTtl

• Область действия: Any file
• Тип: строка, одно из значений:
  • "5m": кэш хранится пять минут
  • "1h": кэш хранится один час
• По умолчанию: не задано, поэтому каждый запрос основного диалога получает своё время жизни по умолчанию
• Переопределения для сессии: FORCE_PROMPT_CACHING_5M имеет приоритет над всем остальным, затем CLAUDE_CODE_PROMPT_CACHE_TTL, затем этот ключ и в последнюю очередь ENABLE_PROMPT_CACHING_1H

{
  "promptCacheTtl": "1h",
  "subagentPromptCacheTtl": "5m"
}

​

showThinkingSummaries

• Область действия: Any file
• Тип: Boolean
  • true: вы видите полные сводки размышлений при их раскрытии с помощью Ctrl+O
  • false: Anthropic API скрывает блоки размышлений, и Claude Code показывает свёрнутую заглушку
• По умолчанию: false

{
  "showThinkingSummaries": true
}

​

subagentPromptCacheTtl

• Область действия: Any file
• Тип: строка, одно из значений:
  • "5m": кэш хранится пять минут
  • "1h": кэш хранится один час
• По умолчанию: не задано, поэтому каждый из этих запросов получает своё время жизни по умолчанию
• Переопределения для сессии: FORCE_PROMPT_CACHING_5M имеет приоритет над всем остальным, затем CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, затем этот ключ, затем ENABLE_PROMPT_CACHING_1H, который запрашивает время жизни в один час для каждого запроса. О том, какое место занимает значение из собственного frontmatter субагента, см. Самостоятельный выбор TTL

{
  "subagentPromptCacheTtl": "1h"
}

​

switchModelsOnFlag

• Область действия: Any file. В /config отображается как Switch models when a message is flagged с вариантами Switch automatically и Ask each time.
• Тип: Boolean
  • true: Claude Code переключается на резервную модель и продолжает
  • false: в интерактивной сессии Claude Code приостанавливается, чтобы вы могли выбрать между переключением и редактированием промпта; там, где диалоговое окно показать нельзя, например при запуске с -p, помеченный запрос завершается ошибкой
• По умолчанию: не задано. Claude Code переключается автоматически, хотя в интерактивной сессии может сначала спросить

{
  "switchModelsOnFlag": false
}

​

ultracode

• Область действия: Any file
• Тип: Boolean
  • true: сессии запускаются с включённым ultracode, если для вас включены динамические рабочие процессы и ваша модель поддерживает xhigh
  • false: сессии запускаются с выключенным ultracode
• По умолчанию: не задано, поэтому ultracode выключен
• Переопределения для сессии: /effort ultracode включает ultracode для одной сессии без этого ключа, а /effort ultracode off выключает его для одной сессии, когда этот ключ равен true. Флаг --effort ultracode также включает его для одной сессии с effort xhigh

{
  "ultracode": true
}

​

Настройки разрешений

​

allowManagedPermissionRulesOnly

• Каталог .claude/ репозитория
• Ваши каталоги ~/.claude/skills/ и ~/.claude/commands/, включая скиллы, синхронизированные из claude.ai
• Каталог, добавленный через --add-dir
• Плагины, объявленные манифестом .claude-plugin, внутри ~/.claude/skills/ или .claude/skills/ проекта
• Плагины, загруженные только для одной сессии, идентификаторы которых оканчиваются на @inline, когда выполняются все следующие условия:
  • Сессия является сессией Code или сессией Cowork, кроме облачной сессии, для которой само приложение Claude Desktop запускает Claude Code
  • Ключ задан в ваших управляемых настройках, а не только в родительских настройках хоста встраивания
  • Сессия работает на Claude Code v2.1.305 или новее

• Область действия: Managed
• Тип: Boolean
  • true: управляемые настройки становятся единственным источником правил разрешений среди настроек
  • false: Claude Code применяет правила разрешений из пользовательских, проектных, локальных файлов и файлов --settings в дополнение к управляемым
• По умолчанию: не установлено, поэтому Claude Code применяет правила разрешений из пользовательских, проектных и локальных настроек, а также из --settings, в дополнение к управляемым

{
  "allowManagedPermissionRulesOnly": true
}

​

autoMode

• Область действия: User or managed
• Тип: объект с массивами правил в свободной форме environment, allow, soft_deny и hard_deny, а также Boolean classifyAllShell
• По умолчанию: не установлено, поэтому классификатор использует только свои встроенные правила

{
  "autoMode": {
    "soft_deny": ["$defaults", "Never run terraform apply"]
  }
}

​

autoMode.classifyAllShell

• Область действия: User or managed. Читается везде, где читается autoMode.
• Тип: Boolean
  • true: пока авторежим активен, Claude Code отправляет каждую команду Bash и PowerShell через классификатор и приостанавливает ваши разрешающие правила для оболочки; вне авторежима правила по-прежнему применяются
  • false: авторежим приостанавливает только разрешающие правила, которые могут запускать произвольный код, такие как Bash(*) и Bash(python *); команда, которой соответствует любое другое разрешающее правило, минует классификатор, если только у неё нет разрешённых доменов для отдельной команды, а все остальные shell-команды проходят через него
• По умолчанию: false

{
  "autoMode": {
    "classifyAllShell": true
  }
}

​

disableAutoMode

• Область действия: Any file. Наиболее полезен в управляемых настройках, где пользователи не могут его переопределить. Также принимается внутри permissions как permissions.disableAutoMode.
• Тип: строка "disable"
• По умолчанию: не установлено

{
  "disableAutoMode": "disable"
}

​

permissions

• Область действия: Any file
• Тип: объект с allow, ask, deny, additionalDirectories, blockReadsOutsideWorkingDirectories, defaultMode, disableBypassPermissionsMode и disableAutoMode
• По умолчанию: не установлено

{
  "permissions": {
    "allow": ["Bash(npm run *)"],
    "ask": ["Bash(git push *)"],
    "deny": ["Read(./.env)"],
    "defaultMode": "acceptEdits"
  }
}

​

useAutoModeDuringPlan

• Область действия: User, local, or managed. Репозиторий не может отключить его за вас.
• Тип: Boolean
  • true: то же, что и отсутствие значения; когда авторежим доступен, классификатор проверяет каждую shell-команду во время планирования вместо запроса к вам, за исключением удалений критических путей. Значение false в любом из этих файлов всё равно отключает его
  • false: вы получаете запрос разрешения для каждой команды вне встроенного набора команд только для чтения
• По умолчанию: true

{
  "useAutoModeDuringPlan": false
}

​

permissions.allow

• Область действия: Any file
• Тип: массив строк правил разрешений
• По умолчанию: не установлено
• Переопределения для отдельной сессии: --allowedTools добавляет разрешающие правила на одну сессию, а запрещающее правило из любого файла настроек по-прежнему блокирует указанный в нём инструмент

{
  "permissions": {
    "allow": ["Bash(git diff *)", "Read(~/.zshrc)"]
  }
}

​

Синтаксис правил разрешений

​

permissions.ask

• Область действия: Any file
• Тип: массив строк правил разрешений
• По умолчанию: не установлено

{
  "permissions": {
    "ask": ["Bash(git push *)"]
  }
}

​

permissions.deny

• Область действия: Any file
• Тип: массив строк правил разрешений
• По умолчанию: не установлено
• Переопределения для отдельной сессии: --disallowedTools добавляет запрещающие правила на одну сессию наряду с этим ключом

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Bash(curl *)"
    ]
  }
}

​

permissions.additionalDirectories

• Область действия: Any file, с ограничениями на доступ на запись в песочнице, который дают записи из проектных и локальных настроек
• Тип: массив путей к каталогам
• По умолчанию: не установлено
• Переопределения для отдельной сессии: --add-dir и /add-dir добавляют каталоги на одну сессию наряду с этим ключом

{
  "permissions": {
    "additionalDirectories": ["../docs/"]
  }
}

​

permissions.blockReadsOutsideWorkingDirectories

• В разделе Действия, которые не одобряет автоматически ни один режим описано, когда shell-команда, читающая такой путь, вызывает запрос к вам
• В разделе Команды в песочнице при действующей блокировке описано, что может читать команда в песочнице

• Область действия: Any file. Значение true в любом файле применяется, поэтому репозиторий может включить блокировку для себя, но не может снять вашу.
• Тип: Boolean
  • true: файловые инструменты Claude отказывают в чтении за пределами рабочих каталогов
  • false: то же, что и отсутствие значения; блокировка всё равно применяется, если другой файл устанавливает true
• По умолчанию: не установлено, поэтому чтение за пределами рабочих каталогов подчиняется вашему режиму разрешений

{
  "permissions": {
    "blockReadsOutsideWorkingDirectories": true
  }
}

​

Команды в песочнице при действующей блокировке

• Изоляция файловой системы отключена через sandbox.filesystem.disabled
• Установлен allowManagedReadPathsOnly
• Путь к каталогу, в котором вы запустили Claude Code, содержит glob-символ, например *, ? или [

• ~/.gitconfig
• Файлы config, ignore и attributes в $XDG_CONFIG_HOME/git, который по умолчанию равен ~/.config/git
• Файлы, на которые ваша глобальная конфигурация git ссылается через [include], [includeIf], core.excludesFile или core.attributesFile

​

permissions.defaultMode

• Область действия: Any file. auto и bypassPermissions не вступают в силу из проектных или локальных настроек, поэтому задавайте их в ~/.claude/settings.json. До версии 2.1.257 bypassPermissions вступал в силу из любого файла. Для диалогов, которые запускает расширение VS Code, Claude Code читает только пользовательские, управляемые значения и значения --settings.
• Тип: строка, одно из значений:
  • "default": Claude Code без запроса выполняет только чтение
  • "acceptEdits": Claude Code также без запроса выполняет редактирование файлов и распространённые команды файловой системы, такие как mkdir и mv
  • "plan": Claude Code читает и планирует, но блокирует редактирование, пока вы не утвердите план
  • "auto": Claude Code работает без рутинных запросов; перед выполнением таких действий, как shell-команды и сетевые запросы, фоновый классификатор проверяет, что они соответствуют вашей задаче
  • "dontAsk": Claude Code автоматически отклоняет каждый вызов, который иначе потребовал бы запроса, хотя установленный вами мод по-прежнему может одобрить некоторые из этих вызовов. Чтение файлов внутри ваших рабочих каталогов, другие действия, не требующие подтверждения, и заранее разрешённые инструменты по-прежнему выполняются, за исключением чтения по сетевым путям
  • "bypassPermissions": Claude Code выполняет всё без запроса
  • "manual": псевдоним для "default"
• По умолчанию: не установлено
• Переопределения для отдельной сессии: --permission-mode и его эквивалент --dangerously-skip-permissions для bypassPermissions имеют приоритет над этим ключом на одну сессию

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

​

permissions.disableBypassPermissionsMode

• Область действия: Any file. Обычно задаётся в управляемых настройках для соблюдения политики организации.
• Тип: строка "disable"
• По умолчанию: не установлено
• Переопределения для отдельной сессии: этот ключ имеет приоритет над --dangerously-skip-permissions, который Claude Code отклоняет, пока ключ установлен

{
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  }
}

​

skipAutoPermissionPrompt

• Область действия: User or managed. Репозиторий не может установить его за вас.
• Тип: Boolean
  • true: Claude Code пропускает уведомление
  • false: то же, что и отсутствие значения; уведомление появляется один раз, если только другой из этих файлов не устанавливает true
• По умолчанию: не установлено, поэтому уведомление появляется один раз

{
  "skipAutoPermissionPrompt": true
}

​

skipDangerousModePermissionPrompt

• Область действия: User, local, or managed. Недоверенный репозиторий не может пропустить диалоговое окно за вас.
• Тип: Boolean
  • true: Claude Code пропускает диалоговое окно подтверждения перед входом сессии в режим bypassPermissions
  • false: то же, что и отсутствие значения; диалоговое окно появляется, если только другой из этих файлов не устанавливает true
• По умолчанию: не установлено, поэтому диалоговое окно появляется

{
  "skipDangerousModePermissionPrompt": true
}

​

Настройки песочницы

​

sandbox

• Scope: Any file
• Тип: объект с ключами enabled, failIfUnavailable, autoAllowBashIfSandboxed, excludedCommands, allowUnsandboxedCommands, enableWeakerNestedSandbox, enableWeakerNetworkIsolation, allowAppleEvents, allowNestedUserNamespaces, bwrapPath, socatPath, ignoreViolations и ripgrep, а также объектами filesystem, network и credentials
• Default: не установлено, поэтому Claude Code выполняет команды без песочницы

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker *"],
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

​

sandbox.enabled

• Scope: Any file, с ограничениями для настроек проекта и локальных настроек
• Type: Boolean
  • true: Claude Code изолирует команды Bash
  • false: команды Bash выполняются без изоляции
• Default: false

{
  "sandbox": {
    "enabled": true
  }
}

​

sandbox.failIfUnavailable

• Scope: Any file, с ограничениями для настроек проекта и локальных настроек
• Type: Boolean
  • true: Claude Code завершается с ошибкой при запуске, когда sandbox.enabled имеет значение true, но песочница не может запуститься
  • false: Claude Code выполняет команды без изоляции, когда песочница не может запуститься
• Default: false

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true
  }
}

​

sandbox.autoAllowBashIfSandboxed

• Scope: Any file
• Type: Boolean
  • true: Claude Code выполняет изолированные команды Bash без запроса разрешения, за исключением случаев, описанных в разделе Auto-allow mode; CLAUDE_CODE_SUBPROCESS_ENV_SCRUB отключает автоматическое разрешение
  • false: изолированные команды проходят обычный поток разрешений, поэтому решают ваши правила разрешений и режим разрешений. Вкладка Mode в /sandbox называет это режимом обычных разрешений
• Default: true

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": false
  }
}

​

sandbox.excludedCommands

• Scope: Any file, с ограничениями для настроек проекта и локальных настроек
• Type: array of command patterns
• Default: не установлено, поэтому ни одна команда не исключена

{
  "sandbox": {
    "excludedCommands": ["docker *"]
  }
}

• Команда, начинающаяся с sudo, eval или xargs
• cd, pushd или popd, где бы они ни появлялись в вызове
• Подстановка команды, подоболочка или блок управления потоком, такой как if или for
• Перенаправление, такое как docker build . > build.log, кроме того, которое только дублирует дескриптор файла, как 2>&1
• Имя команды, которое поступает из переменной
• git clone, git init, git worktree add, git worktree move или git bundle create с аргументом пути, который является абсолютным, начинается с ~ или содержит сегмент ..

​

sandbox.allowUnsandboxedCommands

• Scope: Any file, с ограничением для настроек проекта и локальных настроек
• Type: Boolean
  • true: Claude может повторить попытку выполнения команды вне песочницы с параметром dangerouslyDisableSandbox после того, как песочница её заблокирует
  • false: Claude Code игнорирует этот параметр, поэтому, пока песочница работает, команды, которые выполняет Claude, изолируются, если они не совпадают с записью excludedCommands
• Default: true

{
  "sandbox": {
    "enabled": true,
    "allowUnsandboxedCommands": false
  }
}

​

sandbox.filesystem

• Scope: Any file
• Type: object с массивами allowWrite, denyWrite, denyRead и allowRead, плюс логические значения allowManagedReadPathsOnly и disabled
• Default: не установлено, поэтому применяются границы чтения и записи по умолчанию

{
  "sandbox": {
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    }
  }
}

​

Префиксы путей песочницы

~/keys/*.pem              the entry
/home/alice/keys/*.pem    its full path
 ^^^^                     the first directory name, home

app/
└── [slug]/
    └── page.tsx

• Квадратные скобки, например [slug]: во всех списках в macOS, а также в denyRead и allowRead в Linux и WSL2 скобки в ./app/[slug] также являются шаблоном. Тогда запись также соответствует любому пути внутри app, имя которого состоит из одного символа из slug, например app/s или app/g. Если эта запись находится в allowRead или в allowWrite в macOS, команды в песочнице также получают доступ к этим путям. Переименуйте те, к которым у них не должно быть доступа.
• Квадратные скобки, например [user-id] или [post-id], где символ слева от дефиса при сортировке идёт после символа справа: ./app/[user-id] охватывает только каталог с точно таким именем во всех списках на всех платформах. До v2.1.304 команды в песочнице в Linux и WSL2 не запускались, пока denyRead или allowRead содержали такую запись.
• Фигурные и круглые скобки: это обычные символы, поэтому ~/data/{keys,tokens} охватывает один каталог с именем {keys,tokens}, а не два варианта. Чтобы охватить ~/data/keys и ~/data/tokens, добавьте каждый отдельной записью.

​

sandbox.filesystem.allowWrite

• Scope: Any file, с ограничениями для настроек проекта и локальных настроек
• Type: array of path strings, using the sandbox path prefixes
• Default: не установлено, поэтому изолированные команды могут писать в рабочий каталог, временный каталог пользователя, каталоги, которые вы добавили с помощью --add-dir или /add-dir, и каталоги в permissions.additionalDirectories

{
  "sandbox": {
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"]
    }
  }
}

​

sandbox.filesystem.denyWrite

• Scope: Any file
• Type: array of path strings, using the sandbox path prefixes
• Default: не установлено

{
  "sandbox": {
    "filesystem": {
      "denyWrite": ["/etc", "/usr/local/bin"]
    }
  }
}

​

sandbox.filesystem.denyRead

• Scope: Any file
• Type: array of path strings, using the sandbox path prefixes
• Default: не установлено, поэтому изолированные команды сохраняют default read access, который включает файлы учётных данных, такие как ~/.aws/credentials

{
  "sandbox": {
    "filesystem": {
      "denyRead": ["~/.aws/credentials"]
    }
  }
}

​

sandbox.filesystem.allowRead

• Scope: Any file, с ограничениями для настроек проекта и локальных настроек
• Type: array of path strings, using the sandbox path prefixes
• Default: не установлено

{
  "sandbox": {
    "filesystem": {
      "denyRead": ["~/"],
      "allowRead": ["."]
    }
  }
}

​

sandbox.filesystem.allowManagedReadPathsOnly

• Scope: Managed
• Type: Boolean
  • true: Claude Code учитывает только записи allowRead из управляемых настроек
  • false: записи allowRead из других файлов настроек могут объединяться
• Default: false

{
  "sandbox": {
    "filesystem": {
      "denyRead": ["~/"],
      "allowRead": ["~/work"],
      "allowManagedReadPathsOnly": true
    }
  }
}

​

sandbox.filesystem.disabled

• Scope: User or managed. Когда управляемые настройки вообще настраивают sandbox.filesystem или содержат запись sandbox.credentials.files с "mode": "deny", установить её могут только управляемые настройки.
• Type: Boolean
  • true: Claude Code пропускает изоляцию файловой системы и сохраняет изоляцию сети
  • false: изоляция файловой системы остаётся включённой
• Default: false, поэтому изоляция файловой системы остаётся включённой

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "disabled": true
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

​

sandbox.ignoreViolations

• Scope: Any file, с ограничениями для настроек проекта и локальных настроек
• Type: object mapping a command substring to an array of violation substrings, usually paths
• Default: не установлено, поэтому сообщается о каждом нарушении

{
  "sandbox": {
    "ignoreViolations": {
      "*": ["/etc/hosts"]
    }
  }
}

​

sandbox.enableWeakerNestedSandbox

• Scope: Any file, с ограничениями для настроек проекта и локальных настроек
• Type: Boolean
  • true: внутренняя песочница монтирует через bind-mount существующий /proc контейнера вместо монтирования нового
  • false: песочница монтирует новый /proc, что не работает в непривилегированном контейнере Docker
• Default: false

{
  "sandbox": {
    "enabled": true,
    "enableWeakerNestedSandbox": true
  }
}

​

sandbox.enableWeakerNetworkIsolation

• Scope: Any file, с ограничениями для настроек проекта и локальных настроек
• Type: Boolean
  • true: изолированные команды на macOS могут обращаться к com.apple.trustd.agent
  • false: изолированные команды на macOS не могут обращаться к системной службе доверия TLS
• Default: false

{
  "sandbox": {
    "enabled": true,
    "enableWeakerNetworkIsolation": true
  }
}

​

sandbox.allowAppleEvents

• Scope: User or managed
• Type: Boolean
  • true: изолированные команды на macOS могут отправлять Apple Events
  • false: изолированные команды на macOS не могут отправлять Apple Events, поэтому open и osascript завершаются с ошибкой -600
• Default: false

{
  "sandbox": {
    "enabled": true,
    "allowAppleEvents": true
  }
}

​

sandbox.allowNestedUserNamespaces

• Область действия: User or managed. Значение true учитывается из ~/.claude/settings.json, JSON, переданного с помощью --settings, или управляемых настроек. Claude Code игнорирует true в .claude/settings.json или .claude/settings.local.json проекта. В сессии, где CLAUDE_CODE_SUBPROCESS_ENV_SCRUB установлено в 1, Claude Code игнорирует true из любого источника. Значение false учитывается из любого файла согласно приоритету настроек.
• Тип: логический
  • true: команды в песочнице могут создавать пространства имён пользователей
  • false: этот ключ ничего дополнительно не разрешает, и действует поведение песочницы по умолчанию
• По умолчанию: false

{
  "sandbox": {
    "enabled": true,
    "allowNestedUserNamespaces": true
  }
}

​

sandbox.ripgrep

• Scope: User or managed
• Type: object с command — путём к двоичному файлу ripgrep, и необязательным args — массивом аргументов, добавляемых в начало
• Default: не установлено, поэтому песочница использует тот же двоичный файл ripgrep, что и Claude Code. Это встроенный двоичный файл, если вы не установите USE_BUILTIN_RIPGREP в 0

{
  "sandbox": {
    "ripgrep": {
      "command": "/usr/local/bin/rg"
    }
  }
}

​

sandbox.bwrapPath

• Scope: Managed. Claude Code читает его только из управляемых настроек, чтобы пользовательский, проектный или локальный файл не мог указать песочнице другой двоичный файл.
• Type: string, an absolute path; Claude Code drops a relative path and falls back to PATH lookup
• Default: не установлено, поэтому Claude Code находит bwrap в PATH

{
  "sandbox": {
    "enabled": true,
    "bwrapPath": "/opt/admin/bwrap"
  }
}

​

sandbox.socatPath

• Scope: Managed
• Type: string, an absolute path; Claude Code drops a relative path and falls back to PATH lookup
• Default: не установлено, поэтому Claude Code находит socat в PATH

{
  "sandbox": {
    "enabled": true,
    "socatPath": "/opt/admin/socat"
  }
}

​

sandbox.credentials

• Scope: Any file. Claude Code учитывает записи mask, allowPlaintextInject, awsPairs и sigv4 только из пользовательских настроек, управляемых настроек и флага --settings.
• Type: object с files, envVars, allowPlaintextInject, awsPairs и sigv4
• Default: не установлено, поэтому никакие учётные данные не защищены

{
  "sandbox": {
    "credentials": {
      "files": [{ "path": "~/.aws/credentials", "mode": "deny" }],
      "envVars": [{ "name": "GITHUB_TOKEN", "mode": "deny" }]
    }
  }
}

​

Недействительные записи учётных данных в управляемых настройках

• Запись в files или envVars, у которой по-прежнему действительный path или name и mode со значением mask или deny, например запись, шаблон extract которой не содержит группы захвата, понижается до mode: "deny" с предупреждением, поэтому учётные данные остаются заблокированными, а не замаскированными, пока вы не исправите запись. Пониженная запись files закрепляет filesystem.disabled так же, как явная запись deny, а предупреждение отмечает, что её блокировка чтения не применяется, если управляемые настройки отключают изоляцию файловой системы.
• Запись с неизвестным mode или недействительным path или name удаляется.
• В каждом случае выводится предупреждение; независимо от того, понижена запись или удалена, остальные действительные записи по-прежнему применяются.

​

sandbox.credentials.files

• Scope: Any file. Claude Code отбрасывает записи mask из проектного .claude/settings.json и локального .claude/settings.local.json.
• Type: array of objects, each with path and a mode of "deny" or "mask", plus the optional mask fields for files
• Default: не установлено, поэтому никакие файлы учётных данных не защищены

{
  "sandbox": {
    "credentials": {
      "files": [
        { "path": "~/.aws/credentials", "mode": "deny" },
        { "path": "~/.config/gh/hosts.yml", "mode": "mask", "injectHosts": ["api.github.com"] }
      ]
    }
  }
}

​

Поля маски для файлов

{
  "sandbox": {
    "credentials": {
      "files": [
        {
          "path": "~/.config/gh/hosts.yml",
          "mode": "mask",
          "extract": "oauth_token:\\s*(\\S+)",
          "maskDuplicates": true,
          "onExtractNoMatch": "deny",
          "injectHosts": ["api.github.com"]
        }
      ]
    }
  }
}

​

sandbox.credentials.envVars

• Scope: Any file. Claude Code отбрасывает записи mask из проектного .claude/settings.json и локального .claude/settings.local.json.
• Type: array of objects, each with name and a mode of "deny" or "mask", plus the optional mask fields for environment variables
• Default: не установлено, поэтому никакие переменные окружения не защищены

{
  "sandbox": {
    "credentials": {
      "envVars": [
        { "name": "NPM_TOKEN", "mode": "deny" },
        { "name": "GITHUB_TOKEN", "mode": "mask", "injectHosts": ["api.github.com"] }
      ]
    }
  }
}

​

Поля маски для переменных окружения

{
  "sandbox": {
    "credentials": {
      "envVars": [
        {
          "name": "DATABASE_URL",
          "mode": "mask",
          "extract": "://[^:]+:([^@]+)@",
          "onExtractNoMatch": "deny"
        },
        {
          "name": "SERVICE_JWT",
          "mode": "mask",
          "decode": "jwt",
          "maskClaims": ["api_key"]
        }
      ]
    }
  }
}

​

sandbox.credentials.allowPlaintextInject

• Scope: User or managed
• Type: Boolean
  • true: Claude Code разрешает подстановку mask в обычных HTTP-запросах, а также в HTTPS с терминированием TLS
  • false: Claude Code разрешает подстановку mask только в HTTPS с терминированием TLS
• Default: false