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

​

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

​

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

​

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 модели разрешает только названную ею версию, включая датированные ID этой версии, поэтому "claude-opus-5" разрешает Opus 5, но не claude-opus-5-5. Псевдоним семейства, такой как "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 модели без младшей версии, такой как "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 включённым, когда динамические workflows включены для вас и ваша модель поддерживает xhigh
  • false: сеансы начинаются с ultracode отключённым
• По умолчанию: не установлено, поэтому ultracode отключён
• Переопределения для каждого сеанса: /effort ultracode включает ultracode для одного сеанса без этого ключа, и /effort ultracode off отключает его для одного сеанса, когда этот ключ true. Флаг --effort ultracode также включает его для одного сеанса, на xhigh effort, и требует Claude Code v2.1.203 или позже

{
  "ultracode": true
}

​

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

​

allowManagedPermissionRulesOnly

• Каталог .claude/ репозитория
• Ваши каталоги ~/.claude/skills/ и ~/.claude/commands/, включая скиллы, синхронизированные из claude.ai
• Каталог, добавленный через --add-dir
• Плагины, объявленные манифестом .claude-plugin, внутри ~/.claude/skills/ или .claude/skills/ проекта

• Область действия: 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
• Type: object с enabled, failIfUnavailable, autoAllowBashIfSandboxed, excludedCommands, allowUnsandboxedCommands, enableWeakerNestedSandbox, enableWeakerNetworkIsolation, allowAppleEvents, 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 без запроса разрешения, с учётом правил deny и правил ask с ограничением содержимого; 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"]
    }
  }
}

​

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

• allowWrite и denyWrite: на macOS подстановки работают. На Linux и WSL2 песочница монтирует конкретные пути, поэтому Claude Code пропускает запись, содержащую *, ? или [ после удаления конечного /**, и эта запись не имеет эффекта. Claude Code добавляет пути из ваших правил разрешений Edit в эти списки, поэтому то же ограничение действует и для них, а вкладка Config в /sandbox предупреждает о правилах разрешений Edit и Read, содержащих подстановки.
• denyRead и allowRead: подстановки работают на каждой платформе. На Linux и WSL2 Claude Code разворачивает запись чтения в конкретные пути, с которыми она совпадает, чего он не делает для списков записи.

​

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

​

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