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

Полный справочник по каждому ключу settings.json в Claude Code: где находится каждый ключ, его тип и значение по умолчанию, а также готовый к использованию пример и индекс всех ключей.

Back to index

На этой справочной странице перечислены все ключи, которые Claude Code читает из файла параметров, а также небольшая группа ключей, которые он хранит в ~/.claude.json. Чтобы выбрать файл или проверить приоритет, начните с Settings files and precedence.

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

Каждый ключ ниже ссылается на его запись. Область действия указывает файлы, в которых он может находиться: User — это ~/.claude/settings.json, Project — это .claude/settings.json, Local — это .claude/settings.local.json, а Managed — это то, что развёртывает ваша организация. Any file означает все четыре, а Global config означает ~/.claude.json.

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

Выберите, какие модели использует Claude Code и как он отвечает. О том, как эти настройки взаимодействуют с командой /model и переменными окружения, см. Конфигурация модели.

advisorModel

Выберите модель, которая отвечает, когда Claude вызывает серверный инструмент advisor. Удалите значение, чтобы отключить advisor. Advisor должен быть не менее способным, чем ваша основная модель. Допустимые сочетания и то, что происходит при выборе недопустимой модели, описаны в разделе Выбор модели advisor.

Обычно этот ключ не редактируют вручную. Выполните /advisor, чтобы открыть окно выбора, в котором показаны текущий выбор, модели, которые могут выступать в роли advisor, и вариант No advisor. Claude Code сохраняет ваш выбор в этот ключ в ~/.claude/settings.json. Если вы делаете выбор из клиента Remote Control или в сессии, подключённой к удалённому исполнителю, выбор применяется только к этой сессии и не изменяет этот ключ.

Если ваша учётная запись требует согласия на использование кредитов использования, сначала дайте его, выполнив /model fable. Пока вы этого не сделаете, выбор Fable в /advisor ничего не сохраняет, и Claude Code предлагает сначала выполнить /model fable.

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

{
  "advisorModel": "opus"
}

Ключ не действует у провайдеров, где advisor недоступен, например Amazon Bedrock и Claude Platform on AWS. Для "fable" требуется доступ к Fable.

alwaysThinkingEnabled

Отключите расширенное мышление для всех сессий, установив значение false. Мышление включено по умолчанию, поэтому true ничего не меняет. Большинство пользователей задают это через /config, а не редактируя файл.

На моделях, которые всегда используют мышление, таких как Opus 5.5, Sonnet 5.5, Haiku 5.5 и модели Fable, значение false не действует. У сторонних провайдеров Claude Code не передаёт параметр thinking вместо того, чтобы отключать мышление, поэтому модели с адаптивными рассуждениями всё равно могут использовать мышление. Когда мышление отключено в Anthropic API, Claude Code отправляет effort high вместо более высокого уровня моделям, которые, как ему известно, не принимают такое сочетание, например Opus 5.

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

{
  "alwaysThinkingEnabled": false
}

availableModels

Ограничьте, какие модели пользователи могут выбирать для основной сессии, субагентов, скиллов и advisor. Управляемый список ограничивает /model, --model и ключ model в собственных файлах разработчика; модель вне списка выбрать нельзя. При сопоставлении по префиксу, используемом по умолчанию, это само по себе не затрагивает вариант Default; для этого используйте его вместе с enforceAvailableModels.

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

В этом примере пользователи могут выбирать только модели Sonnet и Haiku:

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

Запись с ID модели, например "claude-opus-5", также разрешает более поздние версии, которые его расширяют, например Opus 5.5. Чтобы заблокировать одну из этих версий, используйте deniedModels. Чтобы каждая запись с ID модели разрешала только указанную в ней версию, используйте availableModelsMatch. См. Ограничение выбора модели. Об ID сторонних провайдеров см. Закрепление моделей для сторонних развёртываний.

availableModelsMatch

Выберите, как записи availableModels сопоставляются с ID моделей. По умолчанию запись с ID модели также разрешает более поздние версии, которые его расширяют, поэтому "claude-opus-5" разрешает Opus 5.5. При значении "exact" каждая запись с ID модели разрешает только указанную в ней версию, поэтому более новая версия этой модели остаётся заблокированной, пока вы не добавите её в список. Требуется Claude Code v2.1.283 или новее.

• Область действия: 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"

В этом примере разрешены Opus 5 и Sonnet 5 и никакие более поздние выпуски этих моделей:

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

При значении "exact" вариант Default также ограничивается перечисленными моделями, если в списке указана хотя бы одна модель или семейство. См. Блокировка отдельных моделей или версий.

deniedModels

Блокируйте отдельные модели — со списком разрешённых моделей availableModels или без него, и даже если этот список их разрешает. Claude Code скрывает заблокированную модель в окне выбора /model, и эту модель нельзя выбрать нигде, где применяется availableModels. Сессия с вариантом Default также не запускает заблокированную модель, как описано в разделе Блокировка отдельных моделей или версий. Требуется Claude Code v2.1.283 или новее.

• Область действия: 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 игнорируются
• По умолчанию: не задано, поэтому ни одна модель не заблокирована

В этом примере разрешены модели Opus и Sonnet, а Opus 5.5 заблокирована:

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

См. Блокировка отдельных моделей или версий.

effortLevel

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

Когда вы выполняете /effort low, medium, high или xhigh в интерактивной сессии на своём компьютере, Claude Code сохраняет уровень для активной модели в modelSettings, а не записывает этот ключ. До v2.1.251 команда /effort записывала этот ключ.

В пределах одного файла настроек Claude Code использует сохранённый уровень модели, а не этот ключ. Приоритет между файлами описан в modelSettings.

В сессии, подключённой к удалённому исполнителю, при запуске с -p и в Agent SDK /effort применяется только к этой сессии. В разделе Настройка уровня effort перечислены варианты интерактивного выбора, которые также применяются только к этой сессии. Сообщение, которое выводит /effort, указывает, что именно произошло.

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

{
  "effortLevel": "xhigh"
}

В вашем файле пользовательских настроек, ~/.claude/settings.json, этот ключ — это старая форма, которую /effort записывала до того, как стала сохранять уровни для каждой модели, и он продолжает применяться там, где применялся раньше: к Opus 5, Fable 5.1 и более ранним моделям. Opus 5.5 и модели, выпущенные после неё, игнорируют его и начинают со своего уровня по умолчанию, пока вы не сохраните для них уровень, который /effort записывает в modelSettings. В проектных, локальных и управляемых настройках, а также с --settings этот ключ применяется ко всем моделям.

enforceAvailableModels

В окне выбора /model есть вариант Default, а в разделе настройка модели default описано, в какую модель он разрешается. Список разрешённых моделей availableModels ограничивает модели, которые можно указать по имени, но при сопоставлении по префиксу, используемом по умолчанию, он не переназначает модель по умолчанию для вашего типа учётной записи, поэтому Default всё ещё может разрешиться в модель вне списка. Этот ключ закрывает этот пробел. Требуется Claude Code v2.1.175 или новее.

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

О том, как этот ключ применяется к проверкам модели при запуске, см. Amazon Bedrock и Google Cloud's Agent Platform.

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

В этом примере выбор по имени ограничен моделями Sonnet и Haiku, а Default разрешается в первую из них, которая доступна:

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

Этот ключ не действует, если availableModels не задан или пуст. См. Применение списка разрешённых моделей к модели Default. Требуется Claude Code v2.1.175 или новее.

fallbackModel

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

Переключение означает один ход с холодным кэшем промптов на резервной модели; ваше следующее сообщение снова сначала пробует основную модель.

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

В этом примере при сбое основной модели сначала пробуется Sonnet 5, затем Haiku 4.5:

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

В отличие от большинства настроек-массивов, этот ключ не объединяется между файлами настроек: всю цепочку задаёт файл с наивысшим приоритетом, в котором он определён. Если ваш проектный файл задаёт ["claude-sonnet-5"], а пользовательский — ["claude-haiku-4-5"], цепочка будет только ["claude-sonnet-5"]. Claude Code сохраняет из списка не более трёх различных разрешённых моделей и игнорирует остальные. См. Цепочки резервных моделей.

fastMode

Включите быстрый режим для сессий, где он доступен, — для интерактивной работы, например быстрой итерации или отладки в реальном времени, когда вам нужна скорость при более высокой стоимости за токен. Обычно этот ключ не редактируют вручную: выполнение /fast записывает fastMode: true в ~/.claude/settings.json, а повторное выполнение для отключения быстрого режима удаляет ключ. Быстрый режим работает только на Opus 5.5, Opus 5 и Opus 4.8: его включение на другой модели переключает вас на Opus, а переключение на неподдерживаемую модель отключает его. См. Переключение моделей при включённом быстром режиме.

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

{
  "fastMode": true
}

fastModePerSessionOptIn

Обычно выполнение /fast сохраняет fastMode в пользовательские настройки человека, поэтому быстрый режим включён в начале каждой последующей сессии. Установите этот ключ в true, чтобы это прекратить: сохранённое fastMode: true больше не включает быстрый режим при запуске сессии, и каждому пользователю нужно выполнять /fast в каждой сессии, где он нужен. Claude Code оставляет ключ fastMode в файле пользователя, поэтому отключение этого ключа восстанавливает прежнее поведение.

Владельцы на тарифах Team или Enterprise могут развернуть его на всю организацию через настройки, управляемые сервером. Когда ключ задан в управляемых настройках, /fast on отклоняется вне интерактивных сессий в терминале и сообщает, что ваша организация отключила быстрый режим. Это касается неинтерактивного режима, расширения VS Code и облачных сессий.

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

{
  "fastModePerSessionOptIn": true
}

См. Требование явного включения в каждой сессии.

language

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

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

{
  "language": "japanese"
}

maxEffortLevel

Ограничьте уровень effort, который может использовать сессия, оставив доступными более низкие уровни. Любой более высокий уровень выполняется на уровне ограничения, в том числе уровень из /effort, окна выбора /model, --effort, CLAUDE_CODE_EFFORT_LEVEL, поля effort во frontmatter скилла или субагента либо собственного уровня модели по умолчанию. Claude Code сам применяет ограничение перед каждым запросом, поэтому оно действует у любого провайдера, включая Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Требуется Claude Code v2.1.267 или новее.

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

В этом примере все модели ограничены уровнем medium, а Sonnet 4.6 исключена:

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

Если ваша организация также задаёт для модели ограничение effort, применяется меньшее из двух ограничений.

model

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

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

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

Значение здесь имеет приоритет над ANTHROPIC_DEFAULT_MODEL, который Claude Code использует, только когда модель не выбрана ничем другим.

modelOverrides

Сопоставьте ID моделей Anthropic с ID моделей конкретного провайдера, например ARN профилей инференса Amazon Bedrock. Тогда каждая запись в окне выбора модели при вызове API провайдера использует сопоставленное значение. Администраторы используют это на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, чтобы направлять каждую версию модели на конкретный профиль инференса, имя версии или развёртывание для целей управления, распределения затрат или региональной маршрутизации.

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

В этом примере все вызовы Opus 4.6 направляются на указанный профиль инференса Bedrock:

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

См. Переопределение ID моделей для каждой версии.

modelPicker

Перечислите модели, которые предлагает окно выбора /model, в том порядке, в котором вы их записываете, и под выбранными вами метками, чтобы в окне выбора были модели, которые использует ваша организация, — после встроенного набора или вместо него. Значение model каждой строки берётся дословно, поэтому оно принимает всё, что принимает --model: псевдоним, например opus, ID модели Anthropic или ID в формате провайдера для Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или LLM-шлюза. Требуется Claude Code v2.1.242 или новее.

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

В этом примере после встроенного набора добавляются два развёртывания Bedrock под названиями, знакомыми вашей команде:

{
  "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

Ключ принимает два поля: одно для самих строк и одно, определяющее, заменяют ли они встроенный набор или дополняют его.

Запись в options также может содержать необязательную строку behavesAs рядом со своим model, для чего требуется v2.1.257 или новее. Укажите в ней ID модели, которая уже известна вашей версии Claude Code, например claude-opus-4-8, в записи, чей model новее вашей версии. Тогда Claude Code применяет к записи возможности и значения effort по умолчанию этой известной модели, вместо того чтобы считать её модель неизвестной. Метка записи и ID модели, который Claude Code отправляет в запросах, не меняются.

При включённом replaceBuiltInOptions Claude Code скрывает все остальные строки: встроенный набор, строки, которые он добавляет для записей availableModels, модели, найденные при обнаружении через шлюз, и ANTHROPIC_CUSTOM_MODEL_OPTION. При выключенном Claude Code пропускает указанную модель, которая уже есть во встроенном наборе. Метка меняет то, что показывает окно выбора, а не то, какую модель запускает Claude Code.

Список разрешённых моделей availableModels по-прежнему применяется к этим строкам. Прежде чем добавлять указанную модель в список разрешённых, прочитайте раздел Поведение при объединении: конкретный ID модели сужает шаблонную запись её семейства. Claude Code также проверяет каждую строку на соответствие сессии, прежде чем показать окно выбора:

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

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

modelPricing

Отображайте расходы по тарифам, которые платит ваша организация, а не по прейскуранту. Задайте это, если у вашей организации есть договорные тарифы, чтобы суммы в долларах, которые видят разработчики, совпадали с вашим счётом. Claude Code применяет тарифы в /usage, строке состояния, total_cost_usd в Agent SDK, ограничении --max-budget-usd и в метрике и событиях стоимости OpenTelemetry. Тарифы указываете вы: Claude Code не считывает их из вашего договора или Claude Console. Требуется Claude Code v2.1.242 или новее.

• Область действия: 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 показывает расходы по прейскуранту, если хост-приложение не передаёт таблицу

Задайте только multiplier для фиксированной скидки или наценки, только overrides для тарифов по отдельным моделям или оба.

В этом примере задаются договорные тарифы для Sonnet 4.6, а затем каждая сумма, включая строку Sonnet, уменьшается на 15%:

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

Задайте multiplier больше 1, но не более 10, чтобы увеличить каждую сумму. Для наценки требуется Claude Code v2.1.271 или новее. Более ранние версии игнорируют multiplier больше 1 с предупреждением и сохраняют остальную часть настройки.

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

Поля для modelPricing

Claude Code использует тарифы строки точно в том виде, в каком вы их записали, не добавляя надбавку за быстрый режим или тариф для инференса только в США. Если вы также задали multiplier, Claude Code применяет его поверх тарифов строки. Claude Code удаляет строку с тарифом, который не может разобрать, или multiplier, который не может разобрать, и сохраняет остальное; см. Исправление повреждённого файла настроек.

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

Claude Code определяет, к каким моделям применяется строка, по её ключу:

• 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

Сохраняйте уровень effort для каждой используемой модели. Требуется Claude Code v2.1.251 или новее.

В интерактивной сессии на вашем компьютере, когда вы сохраняете low, medium, high или xhigh как значение по умолчанию с помощью /effort или ползунка effort в окне выбора /model, Claude Code записывает этот уровень сюда для используемой модели, поэтому вам редко приходится редактировать этот ключ самостоятельно. Когда вы выбираете один из этих уровней в окне выбора модели расширения VS Code, Claude Code сохраняет его сюда таким же образом. В записи effortLevel перечислены сессии, в которых /effort применяется только к этой сессии.

Отредактируйте ключ вручную, чтобы изменить или удалить сохранённый уровень.

effortLevel модели здесь имеет приоритет над effortLevel верхнего уровня (effortLevel) в том же файле настроек. Между файлами Claude Code определяет значение для каждой модели отдельно: решает файл настроек с наивысшим приоритетом, в котором задан либо effortLevel для этой модели, либо effortLevel верхнего уровня, который применяется к этой модели, поэтому effortLevel в управляемых настройках имеет приоритет над уровнем, сохранённым в пользовательских настройках. В разделе Настройка уровня effort перечислено, что ещё может переопределить сохранённый уровень, например --effort при запуске.

Чтобы ограничить effort одной модели, а не задать её уровень, добавьте поле maxEffortLevel в запись этой модели. Для этого поля требуется Claude Code v2.1.267 или новее.

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

Claude Code записывает каждую запись под каноническим именем модели, например claude-opus-5-5, и сопоставляет с этой же записью псевдоним модели, ID с суффиксом даты, [1m] и распознанные ID конкретных провайдеров.

В этом примере Opus 5.5 остаётся на уровне high, а другие модели используют собственные сохранённые уровни или уровни по умолчанию:

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

Выполните /effort auto, чтобы очистить сохранённый уровень для используемой модели. Claude Code оставляет другие записи и любой effortLevel верхнего уровня без изменений.

outputStyle

Выберите стиль вывода по имени. Стиль вывода — это сохранённый набор инструкций, который меняет роль, тон и формат вывода Claude, например встроенные стили Explanatory и Learning или стиль, который вы написали сами.

Если изменить этот ключ во время сессии, Claude использует новый стиль начиная с вашего следующего сообщения. О том, во что это сообщение обходится с точки зрения кэширования промптов, см. Изменение стиля вывода. До v2.1.251 изменение применялось только после выполнения /clear или запуска новой сессии.

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

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

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

Выберите, как долго кэш промптов хранит основной диалог. Этот ключ применяется к вашим ходам в интерактивном режиме, с -p и в Agent SDK, а также к вспомогательным запросам, которые Claude Code выполняет вместе с ними. Время жизни в один час сохраняет кэш «тёплым» на протяжении более длинных перерывов, а API тарифицирует каждую запись в кэш по более высокой ставке, чем при времени жизни в пять минут. Требуется Claude Code v2.1.242 или новее.

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

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

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

О стоимости каждого времени жизни см. Время жизни кэша.

showThinkingSummaries

Просматривайте сводки расширенного мышления Claude в интерактивных сессиях. Задайте это, если хотите видеть полные сводки при раскрытии размышлений с помощью Ctrl+O. Если значение не задано или равно false, Anthropic API скрывает блоки размышлений, и Claude Code показывает свёрнутую заглушку.

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

{
  "showThinkingSummaries": true
}

Скрытие меняет только то, что вы видите, а не то, что генерирует модель. Чтобы сократить расходы на мышление, вместо этого уменьшите бюджет или отключите мышление.

subagentPromptCacheTtl

Выберите, как долго кэш промптов хранит запросы, которые Claude Code выполняет вне основного диалога. Этот ключ применяется к субагентам, рабочим процессам и собственным фоновым и вспомогательным запросам Claude Code, например для сжатия контекста и названий сессий. Время жизни в один час сохраняет кэш «тёплым» на протяжении более длинных перерывов, а API тарифицирует каждую запись в кэш по более высокой ставке, чем при времени жизни в пять минут. Требуется Claude Code v2.1.242 или новее.

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

В этом примере субагенты и другие запросы вне основного диалога получают время жизни в один час:

{
  "subagentPromptCacheTtl": "1h"
}

Этот ключ охватывает запросы, которые не охватывает promptCacheTtl, поэтому задайте оба, чтобы выбрать время жизни для каждого запроса, который выполняет Claude Code. О том, чем кэш субагента отличается от кэша основного диалога, см. Субагенты и кэш.

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

Запускайте сессии с включённым ultracode. Когда он включён, Claude планирует рабочий процесс для каждой существенной задачи, не дожидаясь вашей просьбы. Claude планирует рабочие процессы, только если для вас включены динамические рабочие процессы и ваша модель поддерживает effort xhigh. Ключ не меняет уровень effort сессии: ultracode работает на том уровне, который использует сессия. Claude Code читает этот ключ, но никогда его не записывает: /effort ultracode включает ultracode только для текущей сессии.

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

{
  "ultracode": true
}

Уровень effort сессии определяется effortLevel, modelSettings и другими источниками effort, а ограничение effort, например maxEffortLevel, понижает этот уровень, не выключая ultracode. Для этого и для формы /effort ultracode off требуется Claude Code v2.1.284 или новее. До v2.1.284 ultracode: true запускал сессию с effort xhigh, а ограничение effort ниже xhigh оставляло ultracode выключенным. Управляющий запрос apply_flag_settings в Agent SDK также принимает этот ключ.

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

Решите, что Claude может делать без запроса, в каком режиме разрешений начинается сессия и что позволяет классификатор авторежима. Синтаксис правил и модель разрешений см. в разделе Настройка разрешений.

allowManagedPermissionRulesOnly

Сделайте управляемые настройки единственным источником правил разрешений среди настроек. Claude Code затем игнорирует правила allow, ask и deny в пользовательских, проектных, локальных файлах и файлах --settings, игнорирует --allowedTools, скрывает варианты «всегда разрешать» в запросах разрешений и прекращает сохранение новых правил.

Когда применяются родительские настройки от хоста встраивания, Claude Code рассматривает их как часть управляемого уровня. Он отбрасывает их правила allow и additionalDirectories и сохраняет их правила deny и ask, кроме правил Read и Edit, шаблон которых начинается с !. Хост не может исключить пути из управляемых правил с помощью правила !, независимо от того, установлен ли этот ключ.

Правила --disallowedTools и правила deny и ask текущей сессии по-прежнему применяются, в том числе после перезагрузки настроек Claude Code посреди сессии. Они только ограничивают, поэтому не могут расширить то, что разрешают управляемые правила. До версии 2.1.257 Claude Code отбрасывал эти правила командной строки и сессии при первой перезагрузке настроек.

О том, что может исключить шаблон ! в правиле --disallowedTools или в правиле сессии, см. Правила Read и Edit.

Когда вы устанавливаете этот ключ, Claude Code v2.1.282 или новее также игнорирует frontmatter allowed-tools в скиллах и файлах .claude/commands/ из следующих источников:

• Каталог .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 или новее

Скиллы из управляемых настроек и встроенные скиллы сохраняют свои allowed-tools. Плагины @inline вне этих сессий Desktop также сохраняют свои, кроме плагина с именем anthropic-skills. Поле disallowed-tools скилла по-прежнему применяется. О том, что видит разработчик, когда Claude Code игнорирует это поле, см. Когда применяются только управляемые правила разрешений.

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

{
  "allowManagedPermissionRulesOnly": true
}

Этот ключ не фиксирует список разрешённых MCP-серверов; для этого установите allowManagedMcpServersOnly. См. Настройки только для управляемого уровня.

autoMode

Добавьте собственные правила к тому, что блокирует и разрешает классификатор авторежима. Используйте его, чтобы сообщить классификатору, каким репозиториям, бакетам и доменам доверяет ваша организация, чтобы он перестал блокировать рутинные внутренние операции. Классификатор поставляется со встроенными разрешающими и запрещающими правилами. Включите в массив буквальную строку "$defaults", чтобы сохранить встроенные правила в этой позиции и добавить свои вокруг них; опустите её, чтобы заменить встроенные правила своими.

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

Этот пример сохраняет встроенные правила soft_deny через "$defaults" и добавляет ещё одно, которое блокирует terraform apply:

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

Когда один и тот же массив задан в нескольких из этих файлов, Claude Code объединяет записи. О формате правил и о том, как применяется каждый массив, см. Настройка авторежима.

autoMode.classifyAllShell

Отправляйте каждую команду Bash и PowerShell через классификатор авторежима, пока авторежим активен. По умолчанию авторежим приостанавливает только разрешающие правила, которые могут запускать произвольный код: правила на весь инструмент и правила с подстановочными знаками, такие как Bash(*), а также префиксы интерпретаторов или обёрток оболочки, такие как Bash(python *). Команда, которой соответствует любое другое разрешающее правило, например Bash(npm test), минует классификатор, если только у неё нет разрешённых доменов для отдельной команды. Когда команда минует классификатор, деструктивный аргумент, который префикс правила не предусмотрел, может пройти незамеченным. Установка этого ключа приостанавливает все разрешающие правила для оболочки на время сессии, чтобы классификатор видел каждую команду. Требуется Claude Code v2.1.193 или новее.

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

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

См. Направление всех shell-команд через классификатор.

disableAutoMode

Удалите авторежим из цикла Shift+Tab. Любая сессия, которая в противном случае начиналась бы в авторежиме, будь то из-за --permission-mode auto, файла настроек или встроенного значения по умолчанию, вместо этого начинается в default. Администраторы задают этот ключ в управляемых настройках, чтобы запретить разработчикам своей организации использовать авторежим.

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

{
  "disableAutoMode": "disable"
}

permissions

Управляйте тем, какие инструменты Claude может использовать без запроса, какие всегда требуют подтверждения, а какие заблокированы, и задайте режим разрешений, в котором начинается сессия. Все ключи permissions.* ниже вложены в этот объект.

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

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

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

Три массива правил используют один синтаксис; см. Синтаксис правил разрешений в разделе permissions.allow. О том, как объединяются правила разрешений из разных файлов, см. как правила разрешений объединяются между областями действия; о том, как объединяются ключи настроек в целом, см. Приоритет настроек в руководстве по настройкам.

useAutoModeDuringPlan

Выберите, использует ли Claude Code классификатор авторежима для проверки shell-команд в режиме планирования. При значении по умолчанию true классификатор проверяет каждую команду во время планирования, когда авторежим доступен, и вы не видите запроса, за исключением удалений критических путей. Установите false, чтобы получать запрос разрешения для каждой команды вне встроенного набора команд только для чтения. Отображается в /config как Use auto mode during plan.

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

{
  "useAutoModeDuringPlan": false
}

permissions.allow

Перечислите использования инструментов, которые Claude Code одобряет без запроса. В правиле MCP * может встречаться только в имени инструмента после префикса mcp__<server>__, например mcp__github__get_*; в имени сервера он встречаться не может.

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

Этот пример разрешает git diff и позволяет Claude Code читать ваш .zshrc без запроса:

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

Claude Code применяет правила allow из .claude/settings.json проекта только после того, как вы подтвердите диалоговое окно доверия рабочему пространству для этой папки.

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

Правила разрешений имеют формат Tool или Tool(specifier). Claude Code сначала проверяет правила deny, затем ask, затем allow, и решение принимает первое совпадение, независимо от того, насколько конкретно каждое правило; см. порядок проверки правил разрешений.

Каждая строка показывает одну форму правила и то, чему она соответствует.

Полный синтаксис правил, включая поведение подстановочных знаков, шаблоны для конкретных инструментов в правилах Read, Edit, WebFetch, MCP и Agent, а также ограничения безопасности шаблонов Bash, см. в разделе Синтаксис правил разрешений.

permissions.ask

Перечислите использования инструментов, для которых у вас запрашивается подтверждение даже в режиме разрешений, который иначе одобрил бы их, например acceptEdits или bypassPermissions. В режиме dontAsk Claude Code отклоняет соответствующее использование инструмента вместо запроса.

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

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

permissions.deny

Перечислите использования инструментов, которые Claude Code блокирует. Используйте этот ключ для файлов, содержащих API-ключи, секреты или значения окружения: Claude Code исключает соответствующие файлы из обнаружения файлов и результатов поиска, запрещает их чтение и блокирует инструменты Edit и Write для соответствующих путей.

Запрещающие правила Read и Edit применяются к встроенным файловым инструментам Claude, к файловым командам, которые Claude Code распознаёт в Bash, таким как cat, head, tail, sed и tee, и к целям перенаправлений Bash, таких как > file и < file; они не применяются к команде, которая читает файлы, не называя их, например grep -r pattern ., или к произвольным подпроцессам, поэтому для принудительного контроля на уровне ОС включите песочницу.

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

Этот пример запрещает чтение файлов .env, каталога secrets и файла учётных данных, а также блокирует команды curl:

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

Имена инструментов поддерживают glob-шаблоны, поэтому "*" запрещает все инструменты, а "mcp__*" запрещает все MCP-инструменты. Claude Code игнорирует запрещающее правило для инструмента EndConversation, пока Claude доступен хотя бы один другой инструмент. Запрещающее правило Bash сопоставляется с командой в том виде, в каком её пишет Claude, поэтому Bash(curl *) не останавливает /usr/bin/curl или sh -c 'curl …'; см. чему не соответствует правило Bash. Этот ключ заменяет устаревшую конфигурацию ignorePatterns.

permissions.additionalDirectories

Предоставьте Claude доступ к файлам в каталогах за пределами того, в котором вы начали работу, в качестве дополнительных рабочих каталогов. Большая часть конфигурации .claude/ из этих каталогов не обнаруживается.

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

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

Как и правила allow, записи в .claude/settings.json проекта вступают в силу только после того, как вы подтвердите диалоговое окно доверия рабочему пространству для этой папки.

permissions.blockReadsOutsideWorkingDirectories

Заставьте файловые инструменты Claude отказывать в чтении за пределами ваших рабочих каталогов в любом режиме разрешений, включая bypassPermissions. Claude Code отклоняет вызовы Read, Grep, Glob и LSP для таких путей и сообщает Claude, чтобы он попросил вас добавить каталог с помощью /add-dir. Файлы, которые нужны самому Claude Code, остаются доступными для чтения, например ваши скиллы, плагины, правила, агенты, команды и файл памяти CLAUDE.md в ~/.claude/. Требуется Claude Code v2.1.257 или новее.

Shell-команды Claude Code блокирует иначе:

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

Команда Bash, которую парсер оболочки не может отследить, например команда, которая меняет каталог более одного раза или запускает подоболочку, вызывает запрос к вам даже в авторежиме и в режиме bypassPermissions. Запрос появляется, даже если команда не называет ни одного пути за пределами рабочих каталогов. Этот запрос не появляется, когда команда выполняется в песочнице и песочница обеспечивает блокировку.

Claude Code также записывает сюда true, когда вы выбираете блокировку такого чтения в запросе авторежима перед первым чтением за пределами рабочих каталогов.

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

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

Каталоги, которые вы добавляете с помощью --add-dir, /add-dir или additionalDirectories в пользовательских или управляемых настройках, считаются рабочими каталогами для блокировки. Каталоги, добавленные только в настройках репозитория, не считаются: те, что указаны в .claude/settings.json, и те, что указаны в .claude/settings.local.json, если только git не сообщает, что этот файл не отслеживается. В каталоге, который не является git-репозиторием, или когда git отслеживает этот файл, Claude Code рассматривает .claude/settings.local.json как настройки репозитория, поэтому каталоги, которые должны оставаться доступными для чтения, указывайте в пользовательских настройках.

Когда autoMemoryDirectory задан в .claude/settings.json проекта или в .claude/settings.local.json, рассматриваемом как предоставленный репозиторием, Claude Code не загружает автоматическую память из этого каталога и ничего в него не сохраняет.

Чтобы снять блокировку, удалите ключ из всех файлов настроек, которые его устанавливают, затем начните новую сессию.

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

Когда изоляция в песочнице включена, блокировка также распространяется на команды в песочнице. Claude Code запрещает им чтение вашего домашнего каталога и других корневых каталогов, содержащих пользовательские файлы: /Users, /home, /root, /Volumes, /mnt, /media, /run/media и /srv. Затем он снова открывает рабочие каталоги, worktree, которые Claude Code создаёт в сессии, временный каталог сессии и те части ~/.claude, которые нужны командам, например скиллы и плагины. Пока блокировка действует, записи allowRead и allowWrite из настроек репозитория не учитываются.

Когда рабочий каталог сессии является связанным git worktree, в том числе таким, в который Claude Code перешёл посреди сессии, общий каталог .git репозитория остаётся доступным для чтения и записи командам в песочнице, чтобы git продолжал там работать.

В следующих случаях блокировка не распространяется на команды в песочнице, тогда как файловые инструменты Claude продолжают её соблюдать:

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

При действующей блокировке Claude Code снова открывает командам в песочнице ваши глобальные файлы конфигурации git, чтобы git сохранял ваши идентификационные данные и настройки:

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

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

В Linux и WSL2 файл конфигурации, являющийся символической ссылкой, может оставаться недоступным для чтения по собственному пути, и тогда git работает без него. ~/.git-credentials и $XDG_CONFIG_HOME/git/credentials остаются заблокированными.

Если снова открытый файл содержит секрет, например токен http.extraHeader, добавьте его путь в sandbox.filesystem.denyRead. Запись denyRead, охватывающая файл, всегда имеет приоритет над этим повторным открытием.

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

Правила разрешений действуют поверх любого режима: правила deny блокируют в каждом режиме, включая bypassPermissions. См. Режимы разрешений. В облачных сессиях Claude Code учитывает из этого ключа только acceptEdits, plan, default и auto. О диалогах, которые запускает расширение VS Code, см. какую настройку расширение читает для начального режима разрешений.

permissions.disableBypassPermissionsMode

Запретите кому-либо входить в режим bypassPermissions. Claude Code тогда отклоняет флаг --dangerously-skip-permissions и игнорирует permissionMode: bypassPermissions в определении агента, поэтому субагент работает в режиме разрешений родительской сессии.

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

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

До версии 2.1.223 Claude Code применял режим разрешений из frontmatter даже при отключённом обходе.

skipAutoPermissionPrompt

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

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

{
  "skipAutoPermissionPrompt": true
}

skipDangerousModePermissionPrompt

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

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

{
  "skipDangerousModePermissionPrompt": true
}

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

Изолируйте команды, которые выполняет Claude, от вашей файловой системы, сети и учётных данных. Информацию о том, как работает песочница и требования к платформе, см. в разделе Sandboxing.

sandbox

Изолируйте команды Bash, которые выполняет Claude, от вашей файловой системы и сети с помощью sandboxing. Включите песочницу с помощью enabled, затем сузьте или расширьте то, к чему могут обращаться изолированные команды, с помощью подобъектов filesystem, network и credentials. Песочница работает на macOS, Linux и WSL2.

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

Это включает песочницу, пропускает запросы разрешений для изолированных команд, запускает docker вне песочницы, открывает два дополнительных пути записи, скрывает файл учётных данных AWS и предварительно разрешает GitHub и npm:

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

Когда управляемые настройки задают логический ключ, такой как enabled или failIfUnavailable, это значение переопределяет всё, что устанавливает разработчик. Claude Code объединяет ключи-массивы во всех областях действия настроек, которые загружает сессия, поэтому разработчик может добавлять записи; см. Keep developers from widening the policy для блокировок, доступных только в управляемых настройках. Чтобы требовать песочницу для организации, см. Enforce sandboxing with managed settings.

sandbox.enabled

Включите sandboxing для команд Bash. Когда вы выбираете режим на панели /sandbox, Claude Code записывает этот ключ в .claude/settings.local.json для текущего проекта; установите его в ~/.claude/settings.json, чтобы изолировать каждый проект.

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

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

На Linux и WSL2 песочнице требуются bubblewrap и socat; см. Set up Linux and WSL2. Когда песочница не может запуститься, Claude Code выполняет команды без изоляции, если вы также не установите failIfUnavailable.

sandbox.failIfUnavailable

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

На платформе, которую песочница не поддерживает, Claude Code не запускается при включённом ключе. См. Enforce sandboxing with managed settings.

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

Этот пример включает песочницу на управляемых компьютерах и задаёт failIfUnavailable значение true:

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

См. Enforce sandboxing with managed settings.

sandbox.autoAllowBashIfSandboxed

Позвольте Claude Code выполнять изолированные команды Bash без запроса разрешения. Команды, которые не могут выполняться в песочнице, по-прежнему проходят обычный поток разрешений, и правила deny и правила ask с ограничением содержимого, такие как Bash(git push *), по-прежнему применяются; простое правило Bash ask пропускается для изолированных команд. Установите значение false, чтобы изолированные команды тоже проходили через обычный поток разрешений, который вкладка Mode в /sandbox называет режимом обычных разрешений.

• 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
  }
}

См. Auto-allow mode, чтобы узнать, о чём всё ещё запрашивает режим автоматического разрешения и как он ведёт себя в режиме планирования.

sandbox.excludedCommands

Перечислите команды, которые Claude Code выполняет вне песочницы, например инструменты, которые не работают в ней. Каждая запись использует тот же синтаксис, что и содержимое правила разрешений Bash(...): точная команда, префикс, такой как docker *, или шаблон с подстановкой. Шаблон без подстановки означает точное совпадение, поэтому docker совпадает только с docker без аргументов.

Ваши записи выводят вызов Bash из песочницы, только когда они охватывают каждую команду в нём, и некоторые формы вызова остаются изолированными даже тогда. Одна лишь запись docker * не выводит npm ci && docker build . из песочницы.

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

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

Claude Code сохраняет вызов Bash в изоляции, когда он имеет одну из этих форм, среди прочих:

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

Например, cd build && docker compose up остаётся изолированным при записи docker *, и добавление записи cd этого не меняет. При записи git * команда git clone <url> vendor/lib выполняется вне песочницы, но git clone <url> ~/tools остаётся изолированной. Клонирование записывает целое дерево файлов, возможно исполняемых, туда, куда указывает путь назначения.

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

Записи из областей действия настроек, которые загружает сессия, объединяются в один список, если только песочница не является обязательной по требованию администратора. Пока это так, Claude Code игнорирует записи в .claude/settings.json и .claude/settings.local.json, чтобы клонированный репозиторий не мог вывести команды из песочницы. Записи в управляемых настройках, --settings и вашем ~/.claude/settings.json по-прежнему применяются, и никакая блокировка управляемых настроек не распространяется на этот список.

sandbox.allowUnsandboxedCommands

Позвольте Claude повторить попытку выполнения команды вне песочницы с параметром dangerouslyDisableSandbox после того, как песочница её заблокирует. Когда значение равно false, Claude Code игнорирует этот параметр. Тогда, пока песочница работает, команды, которые выполняет Claude, изолируются, если они не совпадают с записью excludedCommands. Вкладка Overrides в /sandbox показывает это состояние как Strict sandbox mode. Значение false в управляемых настройках включает строгий режим песочницы для разработчиков, на которых они распространяются.

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

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

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

Значение false из управляемых настроек или --settings также делает песочницу обязательной по требованию администратора. Значение false в ваших пользовательских настройках имеет приоритет над значением true проекта, но не делает песочницу обязательной по требованию администратора. Приоритет над значением проекта требует Claude Code v2.1.285 или более поздней версии.

Кто подтверждает повторную попытку без изоляции, зависит от вашего режима разрешений и правил разрешения. См. The unsandboxed retry escape hatch.

Чтобы узнать, когда команды, которые вы вводите сами в ! shell-mode prompt, выполняются в изоляции, см. strict sandbox mode.

sandbox.filesystem

Управляйте тем, какие пути могут читать и записывать изолированные команды. По умолчанию они могут писать в рабочий каталог, временный каталог пользователя и каталоги, которые вы добавляете с помощью --add-dir, /add-dir или permissions.additionalDirectories, и могут читать остальную часть файловой системы, включая файлы учётных данных. Расширьте или сузьте это с помощью четырёх списков путей или отключите слой файловой системы с помощью disabled. См. Filesystem isolation для получения информации о границах по умолчанию.

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

Это позволяет изолированным командам писать в каталог сборки и ваш kubeconfig, а также скрывает файл учётных данных AWS:

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

Claude Code применяет эти списки на границе песочницы ОС, поэтому они распространяются на каждый подпроцесс, который запускает изолированная команда, например kubectl, terraform или npm. Claude Code добавляет ваши permission rules в те же списки: правила Edit allow и deny — в allowWrite и denyWrite, правила Read deny — в denyRead, а правила WebFetch(domain:...) allow и deny — в списки доменов network.

Если не действует блокировка, Claude Code объединяет эти списки во всех файлах настроек, которые загружает сессия. allowManagedReadPathsOnly ограничивает allowRead записями из управляемых настроек, а allowManagedDomainsOnly делает то же самое для разрешённых доменов. Блокировки репозитория исключают записи из файлов настроек репозитория.

Configure sandboxing описывает источники, которые вы исключаете с помощью --setting-sources. Когда вы редактируете список во время сессии, Claude Code применяет изменение к работающей сессии.

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

Пути в allowWrite, denyWrite, denyRead, allowRead и credentials.files разрешаются по их префиксу:

Префикс //path для абсолютных путей также работает. Если вы используете одиночный слэш /path, ожидая разрешения относительно проекта, переключитесь на ./path. Этот синтаксис отличается от Read and Edit permission rules, которые используют //path для абсолютного пути и /path для пути относительно проекта: пути файловой системы песочницы используют стандартные соглашения, поэтому /tmp/build — это абсолютный путь.

Claude Code удаляет конечный слэш из пути каталога, поэтому ~/.aws и ~/.aws/ совпадают с одним и тем же каталогом. До v2.1.224 Claude Code передавал конечный слэш в песочницу, и Claude всё ещё мог читать или записывать пути под записью denyRead или denyWrite, написанной с ним.

Где подстановочные знаки работают в путях песочницы

Подстановочные знаки *, ? и ** работают во всех четырёх списках путей sandbox.filesystem в macOS и в меньшем числе мест в Linux и WSL2:

В ~/keys/*.pem подстановочный знак стоит после имени первого каталога, которым при домашнем каталоге /home/alice является home:

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

В Linux и WSL2 вкладка Config панели /sandbox в сессии предупреждает о правилах разрешений Edit, содержащих подстановочный знак, отличный от завершающего /**. Такие подстановочные знаки не работают для команд в песочнице. Добавьте каждый путь, который должно охватывать правило, или содержащий их каталог в allowWrite для разрешающего правила или в denyWrite для запрещающего.

Имена каталогов с квадратными, фигурными или круглыми скобками

Чтобы разрешить или заблокировать каталог, имя которого содержит квадратные скобки, напишите имя как есть, например ./app/[slug]. В этой записи [slug] — это настоящее имя каталога вместе со скобками:

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

Такая запись охватывает всё внутри каталога, поэтому не добавляйте завершающий /**. В macOS, а также в Linux и WSL2 каталог app/[slug] должен существовать в момент запуска команды в песочнице.

• Квадратные скобки, например [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

Добавьте пути, куда изолированные команды могут писать, помимо рабочего каталога, временного каталога пользователя и каталогов, которые вы добавили с помощью --add-dir, /add-dir или permissions.additionalDirectories. Используйте это, когда подпроцессу, такому как kubectl или инструмент сборки, нужно писать вне проекта.

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

Это позволяет сборке писать в /tmp/build и позволяет kubectl обновлять ваш kubeconfig:

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

Claude Code объединяет записи allowWrite и пути из ваших правил разрешений Edit(...) allow во всех областях действия настроек, которые загружает сессия, исключая записи из настроек репозитория, пока включён permissions.blockReadsOutsideWorkingDirectories. Блокировки репозитория тоже могут исключать записи репозитория. Запись allowWrite не может снять защиту с protected path.

sandbox.filesystem.denyWrite

Запретите изолированным командам запись в определённые пути, включая пути внутри каталога, который в остальном доступен для записи.

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

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

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

Claude Code объединяет записи во всех областях действия настроек, которые загружает сессия, и добавляет пути из ваших правил разрешений Edit(...) deny.

sandbox.filesystem.denyRead

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

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

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

Claude Code объединяет записи во всех областях действия настроек, которые загружает сессия, и добавляет пути из ваших правил разрешений Read(...) deny. Когда filesystem.disabled имеет значение true, Claude Code не применяет эти записи.

sandbox.filesystem.allowRead

Повторно откройте чтение для определённых путей внутри области, которую блокирует denyRead, чтобы организовать доступ на чтение только к рабочей области. Точная запись или запись с подстановкой в denyRead остаётся заблокированной внутри более широкого allowRead, как показывает overlap table. Когда запись denyRead с подстановкой, такая как ~/**/.env, совпадает с каталогом, Claude Code блокирует также чтение его содержимого. До v2.1.236 на macOS Claude Code повторно открывал пути, совпавшие с записью denyRead с подстановкой, везде, где их охватывала более широкая запись allowRead, и оставлял содержимое совпавшего каталога доступным для чтения.

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

Это блокирует чтение вашего домашнего каталога, кроме самого проекта:

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

Claude Code разрешает запись . в корень проекта в настройках проекта и в ~/.claude в пользовательских настройках. Claude Code объединяет записи во всех файлах настроек, которые загружает сессия, если не установлен allowManagedReadPathsOnly, и исключает записи из настроек репозитория, пока включён permissions.blockReadsOutsideWorkingDirectories. Блокировки репозитория тоже могут исключать записи репозитория.

sandbox.filesystem.allowManagedReadPathsOnly

Учитывайте только записи allowRead, которые поступают из управляемых настроек, чтобы разработчики не могли повторно открыть доступ на чтение к путям, которые заблокировала ваша организация. Claude Code по-прежнему объединяет записи denyRead из всех областей действия настроек, которые загружает сессия.

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

Это блокирует чтение домашнего каталога, повторно открывает ~/work и не позволяет разработчикам повторно открыть что-либо ещё:

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

См. Keep developers from widening the policy.

sandbox.filesystem.disabled

Пропускает изоляцию файловой системы, сохраняя сетевую изоляцию. Команды в песочнице получают неограниченный доступ на чтение и запись к файловой системе хоста, а их исходящий сетевой трафик остаётся ограниченным network.allowedDomains. Используйте этот параметр, когда песочница нужна вам для контроля того, куда подключаются команды, а не того, что они записывают.

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

Это оставляет файловую систему открытой и ограничивает исходящий сетевой трафик GitHub и npm:

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

Когда этот уровень отключён, Claude Code не применяет denyRead и записи deny в credentials.files, тогда как записи credentials.envVars и применённые записи mask продолжают работать. autoAllowBashIfSandboxed по-прежнему по умолчанию равен true, поэтому задайте для него false, чтобы запросы подтверждения сохранились. Полный список источников, которые могут задать этот параметр, и описание того, что меняется при отключённой изоляции, см. в разделе Отключение изоляции файловой системы.

sandbox.ignoreViolations

Отключите отчёты о нарушениях песочницы для путей, к которым команда, как вы ожидаете, будет обращаться и получать отказ, например для инструмента, который проверяет /etc/hosts при запуске, чтобы эти отказы не отображались как нарушения и не попадали в то, что видит Claude. Песочница по-прежнему блокирует доступ; подавляется только отчёт. Ключи — это подстроки для сопоставления с командой, где * совпадает с любой командой, а значения — это подстроки нарушения, которое нужно игнорировать для этой команды, например путь файловой системы.

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

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

sandbox.enableWeakerNestedSandbox

Запустите песочницу Linux внутри непривилегированного контейнера Docker, где bubblewrap не может смонтировать новый /proc. Вместо этого внутренняя песочница монтирует через bind-mount существующий /proc контейнера, что раскрывает информацию о процессах, которую новое монтирование скрыло бы. Это снижает безопасность; используйте это, только когда внешний контейнер уже обеспечивает необходимую вам изоляцию.

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

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

Только Linux и WSL2. См. Bubblewrap fails to start inside a container.

sandbox.enableWeakerNetworkIsolation

Позвольте изолированным командам на macOS обращаться к системной службе доверия TLS, com.apple.trustd.agent. Инструментам на основе Go, таким как gh, gcloud и terraform, это нужно для проверки сертификатов TLS, когда вы используете network.httpProxyPort с MITM-прокси и пользовательским ЦС. Это снижает безопасность, открывая потенциальный путь утечки данных через службу доверия.

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

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

Если вы не используете MITM-прокси, вместо этого перечислите проблемные инструменты в excludedCommands; см. Go-based CLIs fail TLS verification on macOS.

sandbox.allowAppleEvents

Позвольте изолированным командам на macOS отправлять Apple Events, которые нужны open, osascript и инструментам, открывающим URL-адреса в браузере; без этого они завершаются с ошибкой -600. Это снимает изоляцию выполнения кода: изолированные команды могут запускать другие приложения без изоляции и без запроса пользователю, а также отправлять команды AppleScript работающим приложениям, таким как Terminal, с учётом запроса согласия на автоматизацию macOS для каждого приложения (TCC).

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

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

Чтобы сохранить изоляцию и всё же запускать один такой инструмент, добавьте его вместо этого в excludedCommands. См. Apple Events on macOS.

sandbox.allowNestedUserNamespaces

Позволяет командам в песочнице в Linux и WSL2 создавать пространства имён пользователей, которые нужны собственной песочнице Chromium и Electron, вложенному bubblewrap и unshare. Если вы установите этот ключ в true, вы отключите границу безопасности: код из команды в песочнице может в итоге выполняться вне песочницы. Для rootless Podman или Buildah используйте вместо этого excludedCommands, поскольку песочница останавливает их и другими способами. Требуется Claude Code v2.1.305 или новее.

• Область действия: 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
  }
}

При включённом ключе не полагайтесь ни на какие ограничения песочницы, включая защищённые пути и записи credentials.files, чтобы остановить вредоносную команду. В режиме автоматического разрешения такая команда может выполниться без запроса разрешения. Если в вашей организации есть служба безопасности, проконсультируйтесь с ней, прежде чем включать этот ключ.

Чтобы найти решение для вашего инструмента, см. Chromium или rootless Podman не работают внутри песочницы в Linux.

sandbox.ripgrep

Укажите песочнице собственный двоичный файл ripgrep вместо того, который использует Claude Code, например когда вашей платформе нужен иначе собранный rg.

• 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

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

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

Только Linux и WSL2.

sandbox.socatPath

Укажите сетевому прокси песочницы двоичный файл socat, установленный вне PATH.

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

Только Linux и WSL2.

sandbox.credentials

Объявите файлы учётных данных и переменные окружения, которые нужно защитить от изолированных команд. Каждая запись указывает файл path или переменную name и mode: deny скрывает учётные данные внутри песочницы, а mask показывает изолированным командам заполнитель, в то время как sandbox proxy подставляет реальное значение в исходящих запросах. Claude Code защищает только перечисленные вами записи; встроенного списка запрещённых учётных данных нет.

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

Это скрывает файл учётных данных AWS и удаляет GITHUB_TOKEN из изолированных команд:

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

Защита файла deny является частью слоя файловой системы, поэтому она не действует, когда вы disable filesystem isolation; защита переменных окружения по-прежнему действует.

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

Когда запись sandbox.credentials в управляемых настройках не проходит проверку, Claude Code продолжает защищать учётные данные, где это возможно:

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

Действует в v2.1.191 и более поздних версиях; до v2.1.221 каждая недействительная запись удалялась. Для других управляемых ключей с обработкой на уровне отдельных полей см. Invalid entries in managed settings.

sandbox.credentials.files

Защитите файлы или каталоги учётных данных от изолированных команд. С "mode": "deny" Claude Code блокирует чтение пути внутри песочницы — та же блокировка чтения, что и у sandbox.filesystem.denyRead. С "mode": "mask" изолированные команды на Linux и WSL2 читают копию файла с сигнальным значением, а прокси песочницы подставляет реальное значение в исходящих запросах к injectHosts этой записи; на macOS файл вместо этого недоступен для чтения внутри песочницы. "mode": "mask" требует Claude Code v2.1.221 или более поздней версии.

• 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: не установлено, поэтому никакие файлы учётных данных не защищены

Это скрывает файл учётных данных AWS и маскирует файл хостов gh, подставляя реальное значение только в запросах к api.github.com:

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

Пути используют те же prefixes, что и настройки sandbox.filesystem.*, и Claude Code объединяет массивы из всех областей действия настроек, которые загружает сессия. Protect credentials описывает, что по-прежнему применяется из источников, которые вы исключаете с помощью --setting-sources. Записи mask требуют Claude Code v2.1.221 или более поздней версии.

Подстановка mask работает только через прокси песочницы, поэтому установите sandbox.network.tlsTerminate или allowPlaintextInject для тестовых сетей с обычным HTTP. mask применяется к одному файлу, поэтому перечислите каждый файл учётных данных отдельно. Claude Code принимает, но игнорирует поля mask в записи deny. Mask credentials описывает, какие источники настроек учитываются, а Mask credential files — когда запись откатывается к deny.

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

Запись mask принимает эти необязательные поля. Без extract или decode Claude Code заменяет всё содержимое файла одним сигнальным значением. На macOS с включённой изоляцией файловой системы Claude Code применяет запись mask как deny до запуска extract или decode; см. Mask credential files.

Это маскирует только значение oauth_token в файле хостов gh, заменяет все другие его копии в файле, делает файл недоступным для чтения, если шаблон ничего не находит, и подставляет реальный токен только в запросах к 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

Защитите переменные окружения от изолированных команд. С "mode": "deny" Claude Code удаляет переменную из окружения изолированных команд. С "mode": "mask" изолированные команды видят сигнальное значение, уникальное для сессии, а прокси песочницы подставляет реальное значение в исходящих запросах к injectHosts этой записи, поэтому такие инструменты, как gh и npm, продолжают проходить аутентификацию, никогда не получая реальных учётных данных.

• 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: не установлено, поэтому никакие переменные окружения не защищены

Это удаляет NPM_TOKEN из изолированных команд и маскирует GITHUB_TOKEN, подставляя реальное значение только в запросах к api.github.com:

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

name должно начинаться с буквы или подчёркивания и содержать только буквы, цифры и подчёркивания. Claude Code объединяет массивы из всех областей действия настроек, которые загружает сессия, и применяет deny, когда одна и та же переменная встречается с обоими режимами. Protect credentials описывает, что по-прежнему применяется из источников, которые вы исключаете с помощью --setting-sources.

Подстановка mask работает только через прокси песочницы, поэтому установите sandbox.network.tlsTerminate или allowPlaintextInject для тестовых сетей с обычным HTTP; см. Mask credentials. Claude Code принимает, но игнорирует поля mask в записи deny.

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

Запись mask принимает эти необязательные поля. Без extract или decode Claude Code заменяет всё значение одним сигнальным значением. extract и decode нельзя комбинировать в одной записи.

Это маскирует только пароль внутри DATABASE_URL, удаляет переменную, если шаблон ничего не находит, и маскирует JWT в SERVICE_JWT, оставляя доступными для чтения все утверждения, кроме api_key:

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

sandbox.credentials.allowPlaintextInject

Разрешите подстановку mask в обычных HTTP-запросах, а также в HTTPS с терминированием TLS. При обычном HTTP подлинность вышестоящего сервера не проверяется, а учётные данные передаются в открытом виде, поэтому оставляйте это отключённым за пределами доверенных тестовых сетей.

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

{
  "sandbox": {
    "credentials": {
      "allowPlaintextInject": true
    }
  }
}

sandbox.credentials.awsPairs

Сгруппируйте замаскированные переменные окружения, которые образуют один набор учётных данных AWS, для SigV4 re-signing, когда ваши учётные данные хранятся в переменных с нестандартными именами. Claude Code автоматически связывает стандартную тройку AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY и AWS_SESSION_TOKEN, когда вы маскируете их значения целиком, поэтому этот ключ нужен только для других имён. Требует Claude Code v2.1.224 или более поздней версии.

• Scope: User or managed
• Type: array of objects, each with accessKeyIdVar, secretAccessKeyVar, and optionally sessionTokenVar, naming sandbox.credentials.envVars entries
• Default: не установлено, поэтому связывается только стандартная тройка

Это связывает три переменные с пользовательскими именами в один набор учётных данных AWS для повторного подписания:

{
  "sandbox": {
    "credentials": {
      "awsPairs": [
        {
          "accessKeyIdVar": "MY_KEY_ID",
          "secretAccessKeyVar": "MY_SECRET_KEY",
          "sessionTokenVar": "MY_SESSION_TOKEN"
        }
      ]
    }
  }
}

Каждая указанная переменная должна быть записью mask со значением целиком в sandbox.credentials.envVars, без extract или decode, и может занимать только один слот среди всех пар. Также действуют следующие правила:

• Прокси повторно подписывает запросы к хостам, перечисленным в injectHosts записи идентификатора ключа доступа
• Когда установлен sessionTokenVar, прокси отправляет реальный токен как x-amz-security-token в повторно подписанных запросах
• Указание любой из стандартных переменных в паре заменяет автоматическое связывание

sandbox.credentials.sigv4

Выберите, что прокси песочницы делает с формами запросов AWS, которые он не может повторно подписать: streaming — для потоковых загрузок aws-chunked, presigned — для предварительно подписанных URL-адресов и sigv4a — для асимметричных подписей SigV4A. Это применяется только к запросам, подписанным с помощью заполнителя идентификатора ключа доступа замаскированной пары. Требует Claude Code v2.1.224 или более поздней версии.

• Scope: User or managed
• Type: object с streaming, presigned и sigv4a, каждый из которых имеет одно из значений:
  • "deny": прокси завершает запрос с ошибкой
  • "passthrough": прокси пересылает запрос, подписанный замаскированным заполнителем, поэтому инструмент получает собственный отказ AWS
• Default: не установлено, поэтому каждая форма имеет значение "deny"

Это пересылает потоковые загрузки вместо того, чтобы завершать их с ошибкой на прокси:

{
  "sandbox": {
    "credentials": {
      "sigv4": {
        "streaming": "passthrough"
      }
    }
  }
}

С deny прокси завершает запрос с ошибкой. С passthrough прокси пересылает запрос с подписью, вычисленной из замаскированного заполнителя, поэтому AWS его отклоняет, и вызывающий инструмент получает собственный ответ AWS вместо ошибки прокси.

sandbox.network

Управляйте тем, к каким хостам, портам и сокетам могут обращаться изолированные команды. Песочница направляет исходящий трафик через прокси, который применяет эти списки; см. Network isolation, чтобы узнать, как прокси принимает решения и когда он запрашивает разрешение.

• Scope: Any file. strictAllowlist, allowManagedDomainsOnly и tlsTerminate читаются из меньшего числа источников, как указано в их описаниях.
• Type: object с подключами ниже
• Default: не установлено, поэтому никакие домены не разрешены заранее, и ваш режим разрешений определяет, что происходит с каждым новым хостом

Это заранее разрешает GitHub и npm, блокирует uploads.github.com и позволяет командам привязываться к localhost:

{
  "sandbox": {
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"],
      "deniedDomains": ["uploads.github.com"],
      "allowLocalBinding": true
    }
  }
}

Claude Code объединяет подключи-массивы во всех областях действия настроек, поэтому проект может добавлять домены к вашему пользовательскому списку, если не действует блокировка репозитория. Правила разрешений WebFetch(domain:...) allow и deny пополняют те же списки разрешённых и запрещённых доменов.

sandbox.network.allowUnixSockets

Перечислите пути Unix-сокетов, к которым изолированные команды могут подключаться на macOS. Claude Code игнорирует этот список на Linux и WSL2, где фильтр seccomp не может проверять пути сокетов; там используйте вместо этого allowAllUnixSockets.

• Scope: Any file, с ограничениями для настроек проекта и локальных настроек
• Type: array of strings, each a socket path
• Default: не установлено, поэтому песочница macOS блокирует все Unix-сокеты

{
  "sandbox": {
    "network": {
      "allowUnixSockets": ["~/.ssh/agent-socket"]
    }
  }
}

Путь сокета может предоставлять широкий доступ: например, разрешение /var/run/docker.sock позволяет изолированной команде управлять демоном Docker. См. Security limitations.

sandbox.network.allowAllUnixSockets

Позвольте изолированным командам подключаться к любым Unix-сокетам. На Linux и WSL2 seccomp filter песочницы блокирует вызовы socket(AF_UNIX, ...), поэтому это единственный способ разрешить там Unix-сокеты. Когда фильтр отсутствует, о чём /sandbox сообщает на вкладке Dependencies, песочница не блокирует вызовы Unix-сокетов. См. Set up Linux and WSL2, чтобы узнать, откуда берётся фильтр.

• Scope: Any file, с ограничениями для настроек проекта и локальных настроек
• Тип: логический
  • true: команды в песочнице могут подключаться к любому Unix-сокету. В Linux и WSL2 они также могут подключаться к сокетам виртуальных машин — семейству адресов AF_VSOCK
  • false: песочница блокирует подключения к Unix-сокетам: в macOS — кроме путей из allowUnixSockets, а в Linux и WSL2 — через фильтр seccomp, если он присутствует
• Default: false

{
  "sandbox": {
    "network": {
      "allowAllUnixSockets": true
    }
  }
}

На WSL2 true также снова открывает сокет interop, который запускает двоичные файлы Windows, такие как cmd.exe и powershell.exe.

sandbox.network.allowLocalBinding

Позвольте изолированным командам на macOS прослушивать сетевые порты, например для запуска сервера разработки, и подключаться к любому порту на localhost. Команда, которая прослушивает адрес, отличный от loopback, принимает подключения с других машин. Ключ не действует на Linux и WSL2, где у каждой изолированной команды есть собственный интерфейс loopback. Чтобы обратиться к серверу на хосте из Linux или WSL2, см. A command fails to reach a server on localhost.

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

{
  "sandbox": {
    "network": {
      "allowLocalBinding": true
    }
  }
}

sandbox.network.allowMachLookup

Перечислите дополнительные имена служб XPC и Mach, которые может искать песочница macOS. Инструментам, взаимодействующим через XPC, таким как iOS Simulator или Playwright, нужно, чтобы их службы были перечислены здесь.

• Scope: Any file, с ограничениями для настроек проекта и локальных настроек
• Type: array of strings, each a service name; a single trailing * matches a prefix, and "*" alone matches every service
• Default: не установлено

Эта конфигурация разрешает все службы с префиксом com.apple.CoreSimulator.:

{
  "sandbox": {
    "network": {
      "allowMachLookup": ["com.apple.CoreSimulator.*"]
    }
  }
}

sandbox.network.allowedDomains

Заранее разрешите домены для исходящего трафика изолированных команд, чтобы песочница не запрашивала для них разрешение. Подстановки, такие как *.example.com, совпадают с поддоменами, а необязательный суффикс :port ограничивает запись одним портом; запись без порта совпадает с любым портом.

• Scope: Any file, с ограничениями для настроек проекта и локальных настроек. Только управляемые настройки, когда установлен allowManagedDomainsOnly.
• Type: array of strings, each a domain, wildcard pattern, or IP literal, with an optional :port suffix
• Default: не установлено, поэтому ваш режим разрешений определяет, что происходит с каждым новым хостом

Это заранее разрешает GitHub на любом порту, все поддомены npm и один хост API только на порту 443:

{
  "sandbox": {
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org", "api.example.com:443"]
    }
  }
}

Записывайте IPv6-литералы в скобках, с необязательным портом: "[::1]" разрешает любой порт, а "[::1]:443" — один порт. Форма со скобками требует Claude Code v2.1.229 или более поздней версии. См. IPv6 addresses in domain lists.

sandbox.network.deniedDomains

Заблокируйте домены для исходящего трафика изолированных команд, используя тот же синтаксис подстановок, портов и IPv6, что и allowedDomains. Запрещённый домен остаётся заблокированным, даже когда с ним также совпадает запись allowedDomains.

• Scope: Any file
• Type: array of strings, each a domain, wildcard pattern, or IP literal, with an optional :port suffix
• Default: не установлено

{
  "sandbox": {
    "network": {
      "deniedDomains": ["sensitive.cloud.example.com"]
    }
  }
}

Claude Code объединяет этот список из всех источников настроек, которые загружает сессия, даже когда установлен allowManagedDomainsOnly, поэтому разработчик всегда может ужесточить список запрещённых доменов. Для IPv6-литералов см. IPv6 addresses in domain lists.

Запись с конечной точкой, которая обозначает полностью определённое доменное имя, например example.com., блокирует те же подключения, что и example.com.

sandbox.network.strictAllowlist

Запретите изолированным командам доступ к хостам вне списка разрешённых доменов вместо запроса подтверждения. Список разрешённых доменов — это allowedDomains плюс домены из правил WebFetch(domain:...) allow, или только записи управляемых настроек, когда установлен allowManagedDomainsOnly. Locks that apply without an admin-required sandbox описывает записи репозитория. Требует Claude Code v2.1.219 или более поздней версии.

• Scope: User or managed. Репозиторий не может его включить или отключить.
• Type: Boolean
  • true: Claude Code запрещает изолированным командам доступ к хостам вне списка разрешённых доменов
  • false: если другой доверенный файл настроек не устанавливает true, Claude Code решает судьбу хоста вне списка разрешённых доменов в зависимости от режима разрешений, а не отказывает сразу: в авторежиме он проверяет хост по per-command allowed domains команды, в режиме dontAsk отказывает, в режиме bypassPermissions и в интерактивных терминальных сессиях режима планирования, где доступен обход, разрешает, а в остальных случаях спрашивает вас
• Default: false

{
  "sandbox": {
    "network": {
      "strictAllowlist": true
    }
  }
}

Claude Code применяет это только к изолированным командам; внутрипроцессные инструменты, такие как WebFetch, по-прежнему следуют своим permission rules. Когда любой из учитываемых источников устанавливает значение true, оно остаётся включённым. См. Network isolation. Требует Claude Code v2.1.219 или более поздней версии.

sandbox.network.allowManagedDomainsOnly

Ограничьте сетевой список разрешённых доменов тем, что определяют управляемые настройки. Тогда Claude Code учитывает только allowedDomains и правила WebFetch(domain:...) allow из управляемых настроек, игнорирует домены из пользовательских, проектных, локальных настроек и --settings и автоматически блокирует неразрешённый домен вместо запроса.

• Scope: Managed
• Type: Boolean
  • true: Claude Code учитывает только allowedDomains и правила WebFetch(domain:...) allow из управляемых настроек и блокирует неразрешённый домен вместо запроса
  • false: домены из других файлов настроек могут объединяться в список разрешённых доменов
• Default: false

Это ограничивает список разрешённых доменов GitHub и npm и игнорирует любые домены, которые добавляют разработчики:

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

Пока ключ имеет значение true, песочница является обязательной по требованию администратора, и только управляемые настройки могут задать порт прокси.

Запрещённые домены по-прежнему объединяются из всех источников, которые загружает сессия. См. Keep developers from widening the policy.

sandbox.network.httpProxyPort

Укажите песочнице ваш собственный HTTP-прокси вместо того, который запускает Claude Code. Организации делают это, чтобы проверять HTTPS-трафик, применять собственные правила фильтрации или записывать запросы в лог. Ваш прокси берёт на себя фильтрацию, и Claude Code перестаёт применять свои списки доменов и сетевые запросы разрешений к трафику, отправляемому туда. Если не установлено, Claude Code запускает собственный прокси для HTTP-трафика.

• Scope: Any file, если другие настройки песочницы не ограничивают, какие файлы могут задавать порт
• Type: number, a local TCP port
• Default: не установлено, поэтому Claude Code запускает собственный прокси

{
  "sandbox": {
    "network": {
      "httpProxyPort": 8080
    }
  }
}

Также установите socksProxyPort, если ваш прокси должен обрабатывать и SOCKS-трафик; если установлен только один из двух, Claude Code по-прежнему запускает собственный прокси для другого протокола. См. Custom proxy configuration.

sandbox.network.socksProxyPort

Укажите песочнице ваш собственный SOCKS5-прокси вместо того, который запускает Claude Code. Ваш прокси берёт на себя фильтрацию, и Claude Code перестаёт применять свои списки доменов и сетевые запросы разрешений к трафику, отправляемому туда. Если не установлено, Claude Code запускает собственный прокси для SOCKS-трафика.

• Scope: Any file, если другие настройки песочницы не ограничивают, какие файлы могут задавать порт
• Type: number, a local TCP port
• Default: не установлено, поэтому Claude Code запускает собственный прокси

{
  "sandbox": {
    "network": {
      "socksProxyPort": 8081
    }
  }
}

См. Custom proxy configuration.

sandbox.network.tlsTerminate

Заставьте прокси песочницы терминировать TLS, чтобы он мог читать содержимое HTTPS-запросов. Это экспериментальная функция, и она необходима для credential substitution mask. Установите {}, чтобы создать эфемерный центр сертификации для сессии, или установите caCertPath и caKeyPath, чтобы использовать собственный.

• Scope: User or managed. Репозиторий не может её включить или предоставить центр сертификации.
• Type: object с необязательными строками caCertPath и caKeyPath, каждая из которых — путь к файлу
• Default: не установлено, поэтому прокси не терминирует и не проверяет TLS

{
  "sandbox": {
    "network": {
      "tlsTerminate": {}
    }
  }
}

Когда её устанавливают несколько учитываемых источников, Claude Code использует значение из источника с наивысшим приоритетом: управляемые настройки, затем флаг --settings, затем пользовательские настройки.

Память и контекст

Контролируйте, что Claude Code загружает в контекст, как он выполняет компактизацию и где хранит память и планы. См. Управление контекстом и Память.

autoCompactEnabled

Позвольте Claude Code автоматически компактизировать беседу при приближении контекста к лимиту. Отображается в /config как Auto-compact, и переключение его там записывает этот ключ в ваши пользовательские параметры.

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

{
  "autoCompactEnabled": false
}

Ручная команда /compact продолжает работать, пока автосжатие отключено. Если вы отключите автосжатие, сжатие в режиме простоя тоже отключится.

autoCompactWindow

Установите, насколько полным становится окно контекста перед тем, как Claude Code автоматически выполняет компактизацию.

• Scope: Any file
• Type: количество токенов от 100000 до 1000000. Claude Code ограничивает значение окном контекста вашей модели; обзор моделей перечисляет окно каждой модели
• Default: не установлено, поэтому Claude Code выбирает окно, оптимизированное для вашей модели
• Per-session overrides: --autocompact имеет приоритет над этим ключом на одну сессию, а CLAUDE_CODE_AUTO_COMPACT_WINDOW имеет приоритет над обоими, если только Claude Code не игнорирует значение переменной

{
  "autoCompactWindow": 500000
}

Команда /autocompact сохраняет окно для текущей модели в modelSettings, и это значение имеет приоритет над этим ключом в том же файле для этой модели. Установка окна автосжатия описывает, как взаимодействуют команда, флаг, переменная и настройка.

autoMemoryDirectory

Сохраняйте автоматическую память в выбранном вами каталоге вместо стандартного каталога для каждого проекта.

• Scope: Any file
• Type: строка, абсолютный путь каталога или путь с префиксом ~/
• Default: не установлено, поэтому Claude Code использует ~/.claude/projects/<project>/memory/

{
  "autoMemoryDirectory": "~/my-memory-dir"
}

Из параметров проекта или локальных параметров Claude Code соблюдает этот ключ в соответствии с тем же правилом доверия рабочей области, что и для hooks, поскольку клонированный репозиторий может предоставить эти файлы.

autoMemoryEnabled

Включите или отключите автоматическую память. Когда false, Claude не читает и не записывает в каталог автоматической памяти. Вы также можете переключить её с помощью /memory во время сессии, что записывает этот ключ в ваши пользовательские параметры.

• Scope: Any file
• Type: Boolean
  • true: то же самое, что и не установлено; автоматическая память остаётся включённой, если что-то, имеющее приоритет над этим ключом, не отключит её на сессию, например --bare, безопасный режим или CLAUDE_CODE_DISABLE_AUTO_MEMORY
  • false: Claude не читает и не записывает в каталог автоматической памяти
• Default: true
• Per-session overrides: CLAUDE_CODE_DISABLE_AUTO_MEMORY имеет приоритет над этим ключом на одну сессию в любом направлении

{
  "autoMemoryEnabled": false
}

bashOutputMaxChars

Установите, сколько символов вывода успешной команды Bash или PowerShell Claude получает встроенным образом. Когда вывод превышает лимит, Claude Code сохраняет его в файл, и Claude получает краткий предпросмотр плюс путь к файлу. Увеличьте лимит, когда вывод команды, такой как подробная сборка или полный журнал набора тестов, регулярно превышает значение по умолчанию и вы хотите, чтобы Claude прочитал его без открытия файла. Требуется Claude Code v2.1.261 или позже.

• Scope: Any file
• Type: количество символов, положительное целое число. Claude Code ограничивает значение диапазоном 4000 на 128000
• Default: не установлено, поэтому Claude получает до 30 000 символов встроенным образом

{
  "bashOutputMaxChars": 100000
}

Когда вы устанавливаете этот ключ, Claude Code игнорирует переменную окружения BASH_MAX_OUTPUT_LENGTH.

claudeMd

Внедрите инструкции в стиле CLAUDE.md как управляемую организацией память без развёртывания отдельного файла. Claude Code загружает текст как запись управляемой памяти перед файлами CLAUDE.md пользователя и проекта.

• Scope: Managed
• Type: строка, текст файла CLAUDE.md; напишите его так, как вы бы написали файл, включая Markdown, с разрывами строк как \n
• Default: не установлено

Этот пример развёртывает два правила как короткий список Markdown:

{
  "claudeMd": "# Engineering rules\n\n- Always run make lint before committing.\n- Never push directly to main."
}

См. Развёртывание CLAUDE.md на уровне организации.

claudeMdExcludes

Пропускайте определённые файлы CLAUDE.md при загрузке Claude Code памяти. В большом монорепозитории используйте его для пропуска файлов CLAUDE.md из других команд, которые не относятся к вашей работе; Исключение нерелевантных файлов CLAUDE.md в руководстве по большим кодовым базам проходит через этот случай. Шаблоны совпадают с абсолютными путями файлов.

• Scope: Any file
• Type: массив строк, каждая из которых является шаблоном glob или абсолютным путём
• Default: не установлено, поэтому Claude Code загружает каждый найденный файл CLAUDE.md

{
  "claudeMdExcludes": ["**/vendor/**/CLAUDE.md"]
}

Исключения применяются только к файлам памяти пользователя, проекта и локальной памяти; файлы CLAUDE.md управляемой политики не могут быть исключены.

env

Установите переменные окружения для каждой сессии и для подпроцессов, которые Claude Code запускает из неё. Большинство переменных в справочнике переменных окружения могут быть здесь, что позволяет применить одну к каждой сессии или развернуть её в вашей команде. Параметры проекта и локальные параметры не могут устанавливать некоторые из них.

• Scope: Any file
• Type: объект, отображающий имена переменных на строковые значения
• Default: не установлено

Этот пример отключает автоматическую компактизацию и маршрутизирует запросы API через прокси:

{
  "env": {
    "DISABLE_AUTO_COMPACT": "1",
    "ANTHROPIC_BASE_URL": "https://proxy.example.com"
  }
}

Как значения env взаимодействуют с вашей оболочкой

• Значение здесь перезаписывает ту же переменную, экспортированную в вашей оболочке, и когда более одного файла параметров устанавливает переменную, применяется наиболее приоритетный. Переменные, которые Claude Code игнорирует в env перечисляет исключения для параметров проекта и локальных параметров.
• Когда приложение Claude Desktop или самостоятельно размещённая среда запускает сессию, среда запуска, которую оно создаёт, имеет приоритет вместо этого: Claude Code игнорирует значение env из любого файла параметров для переменной, которую среда запуска уже устанавливает. Журнал отладки называет каждую игнорируемую переменную.
• Чтобы отменить экспорт оболочки, установите переменную на "". Claude Code рассматривает пустое значение как не установленное для выбора поставщика, и подпроцессы наследуют пустое значение.
• NO_COLOR и FORCE_COLOR, установленные здесь, достигают только подпроцессов. Чтобы изменить цвета собственного интерфейса Claude Code, установите их в вашей оболочке перед запуском claude.
• Значения здесь представляют собой простой текст в файле параметров и достигают каждого подпроцесса, который запускает Claude Code. Для токена OTLP, который ротируется, используйте otelHeadersHelper; для учётных данных API используйте apiKeyHelper.

Когда Claude Code применяет значения env

• Из пользовательских параметров, --settings и управляемых параметров: при запуске и снова в работающей сессии, когда сохранённое изменение изменяет объединённый env.
• Из параметров проекта и локальных параметров: после того, как вы доверяете рабочей области, или при запуске в режиме -p, который никогда не показывает диалог доверия, и снова, когда сохранённое изменение изменяет объединённый env.
• Переменные, которые Claude Code классифицирует как безопасные, такие как выбор модели, тайм-ауты и лимиты, и переключатели функций: при запуске из каждого файла параметров, кроме переменных, которые параметры проекта и локальные параметры не могут устанавливать.
• После того, как вы переместите сессию с помощью /cd на v2.1.246 или позже: значения env нового каталога проекта и локальные, поверх предыдущего каталога.

Переменные, которые Claude Code игнорирует в env

• Настройки проекта и локальные настройки не могут задавать переменные, которые не должен контролировать извлечённый репозиторий; задавайте их вместо этого в оболочке, пользовательских настройках или управляемых настройках. Claude Code отбрасывает каждую такую переменную, за исключением нескольких значений, отключающих телеметрию, и записывает в лог предупреждение, которое можно увидеть с помощью claude --debug. К ним относятся:

  • Переменные, определяющие, где Claude Code хранит или записывает собственные файлы: CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR и переменные каталогов операционной системы, такие как HOME, TMPDIR, TMP, TEMP и семейство XDG_*.

  • Переменные Windows, определяющие программы и общесистемную конфигурацию для процессов, которые запускает Claude Code, такие как SystemRoot, ComSpec, ProgramData, LOCALAPPDATA, PATHEXT, PSModulePath и семейство ProgramFiles.

  • Переменные, экспортирующие содержимое сессии: OTEL_LOG_RAW_API_BODIES и пара переменных подробной бета-трассировки ENABLE_BETA_TRACING_DETAILED и BETA_TRACING_ENDPOINT.

  • Переменные экспортера OpenTelemetry, которые включают телеметрию, определяют, куда она отправляется, или определяют, какое содержимое она собирает:

    • CLAUDE_CODE_ENABLE_TELEMETRY, а также пара переменных бета-версии расширенной телеметрии CLAUDE_CODE_ENHANCED_TELEMETRY_BETA и ENABLE_ENHANCED_TELEMETRY_BETA
    • Селекторы экспортеров OTEL_LOGS_EXPORTER, OTEL_METRICS_EXPORTER и OTEL_TRACES_EXPORTER
    • Переменные содержимого OTEL_LOG_USER_PROMPTS, OTEL_LOG_ASSISTANT_RESPONSES, OTEL_LOG_TOOL_CONTENT и OTEL_LOG_TOOL_DETAILS
    • Переменные OTEL_EXPORTER_OTLP_*, имена которых заканчиваются на _ENDPOINT, _HEADERS, _PROTOCOL, _CERTIFICATE, _CLIENT_KEY или _INSECURE, в общей форме и в формах для отдельных сигналов, например OTEL_EXPORTER_OTLP_ENDPOINT и OTEL_EXPORTER_OTLP_METRICS_HEADERS
    • OTEL_EXPORTER_PROMETHEUS_HOST и OTEL_EXPORTER_PROMETHEUS_PORT

    Только эти значения всё ещё применяются из параметров проекта и локальных параметров, потому что они отключают что-то: none для трёх селекторов exporter и значение off, такое как 0 для OTEL_LOG_USER_PROMPTS, OTEL_LOG_TOOL_CONTENT и OTEL_LOG_TOOL_DETAILS. Такое значение переопределяет ту же переменную в ваших пользовательских параметрах, но не ту, которую среда, из которой вы запускаете Claude Code, файл --settings или управляемые параметры устанавливают.

    Когда файл параметров проекта или локальных параметров устанавливает переменную в этой группе, локальная интерактивная сессия показывает уведомление при запуске. Запустите /status или claude doctor, чтобы увидеть, какие из них Claude Code игнорировал и какие отключили телеметрию; оба перечисляют имена, никогда значения. Неинтерактивный запуск с -p или сессия Agent SDK не показывает уведомление, поэтому проверьте, что ваш сборщик всё ещё получает данные после обновления. Если нет, установите переменные в ваши пользовательские параметры, управляемые параметры, среду задания или файл, который вы передаёте с помощью --settings.

    Игнорирование этой группы в настройках проекта и локальных настройках требует Claude Code v2.1.282 или новее.

  • Переменные, которые изменяют способ запуска или синхронизации Claude Code, такие как CLAUDE_CODE_PROCESS_WRAPPER, CLAUDE_CODE_SYNC_SKILLS, CLAUDE_CODE_SYNC_PLUGINS, CLAUDE_CODE_PLUGIN_CACHE_DIR и CLAUDE_CODE_PLUGIN_SEED_DIR.

  • Переменная режима экранного диктора CLAUDE_AX_SCREEN_READER и другие переменные, имена которых начинаются с CLAUDE_AX_, например CLAUDE_AX_STARTUP_QUIET_MS.

  • CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS, которая задаёт таймер для диалогового окна, оставшегося без ответа.

  • CLAUDE_CODE_DISABLE_ATTACHMENTS, которая отключает обработку вложений.

  • CLAUDE_CODE_DISABLE_FILE_MENTIONS, которая не даёт Claude Code раскрывать упоминания файлов и каталогов через @.

  До v2.1.251 параметры проекта и локальные параметры могли также устанавливать переменные в этом списке, которые выбирают, где Claude Code записывает свои файлы или которые экспортируют содержимое сессии, кроме HOME и XDG_CONFIG_HOME. До v2.1.290 они также могли устанавливать переменные таймеров диалоговых окон и CLAUDE_CODE_DISABLE_ATTACHMENTS.

• Переменные идентификации, которыми владеют среды хостинга Claude Code, такие как CLAUDE_CODE_REMOTE и CLAUDE_CODE_ACCOUNT_UUID, игнорируются из каждого файла.

• CLAUDE_CODE_MESSAGING_SOCKET и CLAUDE_CODE_MESSAGING_TOKEN, которые Claude Code экспортирует сам, игнорируются из каждого файла. Игнорирование переменной сокета требует Claude Code v2.1.224 или позже, а игнорирование токена требует v2.1.228 или позже.

• CLAUDE_CODE_PROJECT_DIR_NAME, которую Claude Code читает только из среды запуска, игнорируется из каждого файла; требует v2.1.234 или позже.

• CLAUDE_CODE_RESTRICTED, которую Claude Code читает только из среды запуска, игнорируется из каждого файла.

• CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY, которую Claude Code читает только из среды запуска, игнорируется из каждого файла. Переменная требует Claude Code v2.1.283 или позже.

• CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT, CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT, CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT и CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT, которые Claude Code читает только из среды запуска, игнорируются в любом файле.

• CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS, которую Claude Code читает только из среды запуска, игнорируется в любом файле.

• CLAUDE_CODE_WARN_DISK_FREE_GIB и CLAUDE_CODE_WARN_MEMORY_FREE_GIB, которые Claude Code читает только из среды запуска, игнорируются в любом файле. Эти переменные требуют Claude Code v2.1.304 или новее.

fileCheckpointingEnabled

Позвольте Claude Code создавать снимки файлов перед каждым редактированием, чтобы /rewind мог их восстановить. Отображается в /config как Rewind code (checkpoints), и переключение его там записывает этот ключ в ваши пользовательские параметры.

• Scope: Any file
• Type: Boolean
  • true: Claude Code создаёт снимки файлов перед каждым редактированием, чтобы /rewind мог их восстановить
  • false: Claude Code не создаёт снимки файлов, поэтому /rewind не может их восстановить
• Default: true
• Per-session overrides: CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING отключает checkpointing на одну сессию; какой бы из двух параметров его ни отключил, другой не может его включить обратно

{
  "fileCheckpointingEnabled": false
}

В запуске -p или сессии Agent SDK Claude Code игнорирует этот ключ. SDK включает checkpointing с помощью своей опции enableFileCheckpointing, и простой запуск -p требует CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true. См. File checkpointing в Agent SDK.

idleCompaction

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

• Терминал: строка, начинающаяся с Compacted while idle, before the prompt cache expired
• Панель чата VS Code: уведомление, содержащее a summary written while you were away
• Настольное приложение: то же уведомление внутри строки, метка которой содержит Claude Code notice. Если вы не видите эту строку или её текст, переключитесь в режим просмотра Verbose.

Сжатие в режиме простоя включено по умолчанию для диалогов, которые соответствуют всем следующим условиям:

• Сессия: вы находитесь в интерактивной сессии терминала либо в панели чата расширения VS Code или на вкладке Code настольного приложения с учётной записью, которую выбирает Anthropic
• Автосжатие: autoCompactEnabled включён
• Кэш промптов: диалог использует часовой TTL кэша промптов
• Флаги функций: Claude Code может получать флаги функций от Anthropic
• Размер: контекст диалога достиг порога токенов, который вы можете изменить со значения по умолчанию 200 000
• Время простоя: с момента последнего запроса прошло около 54 минут, и в этот момент ваш компьютер не находится в спящем режиме

Чтобы отключить сжатие в режиме простоя, установите этот ключ в false.

• Scope: Any file
• Type: Boolean
  • true: Claude Code сжимает простаивающие диалоги, которые соответствуют условиям
  • false: Claude Code не выполняет сжатие, пока ваша сессия простаивает
• Default: true
• Per-session overrides: DISABLE_AUTO_COMPACT отключает сжатие в режиме простоя вместе с автосжатием

{
  "idleCompaction": false
}

Чтобы отключить или включить сжатие в режиме простоя прямо в сессии терминала, запустите /config и измените строку Idle compaction. Ваш выбор сохраняется в пользовательских настройках и применяется сразу. Эта строка требует Claude Code v2.1.302 или позже. Если вы используете одну из этих версий, а /config не показывает эту строку, проверьте следующие причины:

• Ключ задан в другом источнике настроек: значение в управляемых настройках, флаге --settings или файле настроек проекта или локальных настроек переопределяет ваши пользовательские настройки. Измените ключ в этом источнике
• Флаги функций недоступны: там, где Claude Code не может получать флаги функций от Anthropic, сжатие в режиме простоя не выполняется, поэтому отключать нечего

Ключ требует Claude Code v2.1.290 или позже. В более ранней версии, которая игнорирует этот ключ, отключите autoCompactEnabled, чтобы остановить сжатие в режиме простоя.

Изменение порога сжатия в режиме простоя

Установите в CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS количество токенов, которого должен достичь контекст диалога, чтобы к нему применялось сжатие в режиме простоя. Используйте положительное целое число. Значения ниже 100000 повышаются до 100000 — минимального порога.

При значении по умолчанию диалог с контекстным окном 200K автоматически сжимается до того, как достигнет 200 000 токенов. Этот пример снижает порог до 150 000, чтобы такие диалоги соответствовали условию:

{
  "env": {
    "CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS": "150000"
  }
}

Сжатие в режиме простоя в VS Code и настольном приложении

Подобное уведомление означает, что Claude Code заменил ваш предыдущий диалог сводкой, с которой теперь работает Claude:

Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json

Вам не нужно ничего делать. Чтобы отключить сжатие в режиме простоя, установите idleCompaction в false в ~/.claude/settings.json или другом файле настроек.

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

plansDirectory

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

• Scope: Any file
• Type: строка, путь относительно корня проекта
• Default: не установлено, поэтому Claude Code использует ~/.claude/plans

{
  "plansDirectory": "./plans"
}

Claude Code хранит планы в ~/.claude/plans вместо заданного вами каталога, например, в следующих случаях:

• Вне корня проекта: путь разрешается за пределами корня проекта, как в случае "../plans".
• Обратная косая черта в macOS, Linux и WSL: разрешённый путь содержит обратную косую черту, как в пути в стиле Windows "docs\\plans". Пишите "docs/plans" — такой путь работает и в Windows.

skillListingBudgetFraction

Каждый ход Claude видит список ваших skills с их описаниями, и Claude Code ограничивает этот список долей окна контекста. Когда список превышает лимит, Claude Code сохраняет имя каждого skill, но отбрасывает описания наименее используемых skills, поэтому Claude всё ещё может вызывать эти skills, но менее вероятно выбрать один самостоятельно. Увеличьте этот ключ, чтобы сохранить больше описаний видимыми за счёт большего контекста за ход.

• Scope: Any file
• Type: число, доля больше 0 и не более 1
• Default: 0.01, что резервирует 1% окна контекста

{
  "skillListingBudgetFraction": 0.02
}

Чтобы увидеть, сколько контекста использует список и какие skills вносят наибольший вклад, запустите /doctor.

skillListingMaxDescChars

Каждый ход Claude видит список ваших skills, который показывает текст description и when_to_use каждого skill. Этот ключ ограничивает, сколько символов этого текста Claude Code показывает для каждого skill; более длинный текст обрезается на лимите.

• Scope: Any file
• Type: количество символов, положительное целое число
• Default: 1536

{
  "skillListingMaxDescChars": 2048
}

Увеличьте его, чтобы сохранить длинные описания нетронутыми за счёт большего контекста за ход; уменьшите его, чтобы вместить больше skills под skillListingBudgetFraction.

taskOutputMaxChars

[!WARNING]

Удалено в v2.1.277 вместе с инструментом TaskOutput, который он определял. Установка этого параметра не влияет на текущие версии. Claude читает файл вывода фонового задания с помощью Read вместо этого.

До v2.1.276 вы устанавливали этот ключ на количество символов вывода фонового задания, которое Claude получал встроенным образом, когда читал задание с помощью инструмента TaskOutput.

Интерфейс и терминал

Изменяйте внешний вид и поведение Claude Code в терминале: тему, режим редактора, строку состояния, спиннер, уведомления внутри сессии и специальные возможности. См. Настройка терминала.

askUserQuestionTimeout

Позволяет диалоговому окну AskUserQuestion, оставшемуся без ответа, автоматически продолжить работу после периода бездействия, отправив те варианты, которые вы уже выбрали. Задайте этот параметр, если вы отходите и хотите, чтобы Claude продолжал без вас. При значении по умолчанию вопросы ждут, пока вы на них не ответите. О том, когда таймер приостанавливается или вообще не запускается, см. Таймаут автопродолжения вопроса.

• Область действия: User or managed
• Тип: строка, одно из значений "60s", "5m", "10m" или "never"
• По умолчанию: "never"

{
  "askUserQuestionTimeout": "5m"
}

Отображается в /config как Question auto-continue timeout и записывает этот ключ в пользовательские настройки; Claude Code скрывает эту строку, когда ключ задан управляемыми настройками или флагом --settings.

autoContinueAtUsageLimit

После того как лимит использования claude.ai останавливает вашу сессию, Claude Code ожидает в открытой сессии и автоматически продолжает задачу после сброса лимита. См. Отключение автоматического продолжения. Требуется Claude Code v2.1.234 или новее.

• Область действия: User or managed. Считывается только из пользовательских настроек, --settings и управляемых настроек. Если ни один из этих источников не задаёт ключ, файл настроек проекта или локальный файл настроек, задающий его, отключает функцию, а не игнорируется.
• Тип: Boolean
  • true: после того как лимит использования claude.ai останавливает вашу сессию, Claude Code ожидает в открытой сессии и автоматически продолжает задачу после сброса лимита
  • false: Claude Code не начинает ожидание самостоятельно. Вы по-прежнему можете запустить ожидание сами из меню вариантов, связанных с лимитом использования
• По умолчанию: true

{
  "autoContinueAtUsageLimit": false
}

Отображается в /config как Continue automatically at usage limit и записывает этот ключ в пользовательские настройки; Claude Code скрывает эту строку, когда ключ задан управляемыми настройками или флагом --settings.

autoScrollEnabled

Следовать за новым выводом к нижней части диалога в полноэкранном режиме отображения. Отключите, чтобы оставаться в том месте, куда вы прокрутили, пока Claude продолжает работать; запросы разрешений по-прежнему прокручиваются в область видимости.

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

{
  "autoScrollEnabled": false
}

Отображается в /config как Auto-scroll, когда включён полноэкранный режим отображения, и записывает этот ключ в пользовательские настройки.

axScreenReader

Выводить текст, удобный для программ экранного доступа: простой текст без декоративных рамок и анимаций. Режим экранного доступа использует классический рендерер, поэтому настройка tui не действует, пока он активен; подключённые фоновые сессии по-прежнему отображаются в полноэкранном режиме.

• Область действия: User or managed. Ключ также можно задать в файле, передаваемом через --settings. Claude Code игнорирует ключ в настройках проекта и локальных настройках, поэтому ни репозиторий, ни ваш собственный .claude/settings.local.json не могут включить или отключить режим экранного доступа.
• Тип: Boolean
  • true: Claude Code выводит простой текст без декоративных рамок и анимаций, используя классический рендерер
  • false: Claude Code отображает интерфейс обычным образом
• По умолчанию: не задано, поэтому режим экранного доступа отключён
• Переопределения для отдельной сессии: --ax-screen-reader имеет приоритет над CLAUDE_AX_SCREEN_READER, и оба имеют приоритет над этим ключом в рамках одной сессии

{
  "axScreenReader": true
}

bashEditDiffEnabled

Определяет, будет ли Claude Code фиксировать, какие файлы в Git-репозитории изменились во время выполнения команды Bash. Когда он их фиксирует, вы видите их diff в терминале после команды, а ваши хуки PostToolUse для Bash получают список изменённых файлов.

Файл в списке не всегда изменён именно этой командой. Там также может оказаться изменение, внесённое другой программой или другим вызовом Bash во время выполнения команды.

Установите ключ в true, чтобы фиксировать их во всех режимах разрешений. Требуется Claude Code v2.1.269 или новее.

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

{
  "bashEditDiffEnabled": true
}

companyAnnouncements

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

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

{
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.example.com"
  ]
}

defaultShell

Определяет, будет ли Bash или PowerShell выполнять shell-команды, которые вы вводите с префиксом ! в поле ввода, — те, которые Claude Code выполняет напрямую и добавляет в сессию.

"powershell" работает, только пока включён инструмент PowerShell. Инструмент включён по умолчанию в Windows без Git Bash, а также в Windows с Git Bash для учётных записей claude.ai и Console. В сессиях Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, а также в macOS, Linux и WSL установите CLAUDE_CODE_USE_POWERSHELL_TOOL=1, чтобы включить инструмент. Установите эту переменную в 0, чтобы отключить инструмент.

• Область действия: Any file
• Тип: строка, одно из значений:
  • "bash": Claude Code выполняет ваши команды ! в Bash
  • "powershell": Claude Code выполняет ваши команды ! в PowerShell
• По умолчанию: "bash" или "powershell" в Windows, когда Bash недоступен

{
  "defaultShell": "powershell"
}

Если указанная оболочка недоступна, Claude Code использует другую: "powershell" переключается на Bash, когда инструмент PowerShell отключён, а "bash" переключается на PowerShell, когда Bash не установлен.

dialogExpiry

Задаёт крайний срок для диалоговых окон, которые Claude Code перенаправляет удалённому клиенту, например хосту Remote Control или SDK, а также для диалогового окна подтверждения задержанного межсессионного сообщения. В Claude Code v2.1.236 или новее тот же крайний срок ограничивает запрос согласия на кредиты использования Fable, появляющийся посреди сессии, в которой у терминала может никого не быть. Если ответ не поступает до истечения срока, Claude Code закрывает диалоговое окно и продолжает с вариантом по умолчанию, не предполагающим действий. Требуется Claude Code v2.1.224 или новее.

• Область действия: User or managed
• Тип: строка, одно из значений "60s", "5m", "10m" или "never", которое отключает крайний срок
• По умолчанию: "5m"
• Переопределения для отдельной сессии: CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS имеет приоритет над этим ключом в рамках одной сессии

{
  "dialogExpiry": "10m"
}

Запросы разрешений и вопросы AskUserQuestion используют собственные механизмы и не подчиняются этому крайнему сроку. Отображается в /config как Dialog expiry и записывает этот ключ в пользовательские настройки; для этой строки требуется Claude Code v2.1.232 или новее, и Claude Code скрывает её, когда ключ задан управляемыми настройками или флагом --settings.

editorMode

Выбор режима сочетаний клавиш для поля ввода промпта.

• Область действия: Any file
• Тип: строка, одно из значений:
  • "normal": стандартные сочетания клавиш в поле ввода промпта
  • "vim": редактирование в стиле vim с режимами NORMAL, INSERT и VISUAL
• По умолчанию: "normal"

{
  "editorMode": "vim"
}

Отображается в /config как Editor mode и записывает этот ключ в пользовательские настройки.

emojiCompletionEnabled

Показывать подсказки эмодзи, когда вы вводите : и короткий код в поле ввода промпта, и заменять завершённый короткий код, например :heart:, на соответствующий эмодзи. Установите false, чтобы отключить и то, и другое.

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

{
  "emojiCompletionEnabled": false
}

См. Короткие коды эмодзи.

fileSuggestion

Запускать собственную команду для автодополнения путей к файлам после @ вместо встроенных подсказок файлов. Встроенные подсказки используют быстрый обход файловой системы; для большого монорепозитория может подойти лучше индексация под конкретный проект, например заранее построенный индекс файлов.

• Область действия: Any file. При действии ограничений для строки состояния и подсказок файлов Claude Code отключает команду или выполняет только управляемое значение и без предупреждения пропускает ваше.
• Тип: объект с полями type, всегда "command", и command — shell-командой для запуска
• По умолчанию: не задано, поэтому Claude Code использует встроенные подсказки файлов

{
  "fileSuggestion": {
    "type": "command",
    "command": "~/.claude/file-suggestion.sh"
  }
}

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

Ввод и вывод команды

Claude Code запускает команду с теми же переменными окружения, что и хуки, включая CLAUDE_PROJECT_DIR, и перестаёт ждать через пять секунд. Команда получает JSON через stdin с полем query, содержащим то, что вы уже ввели:

{"query": "src/comp"}

Выводите в stdout пути к файлам, разделённые переводом строки. Claude Code показывает не более 15:

src/components/Button.tsx
src/components/Modal.tsx
src/components/Form.tsx

Следующий скрипт считывает запрос и передаёт его индексу файлов репозитория:

#!/bin/bash
query=$(cat | jq -r '.query')
# Replace your-repo-file-index with your own file search command
your-repo-file-index --query "$query" | head -20

footerLinksRegexes

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

• Область действия: User or managed
• Тип: массив объектов, в каждом из которых type имеет значение "regex", есть регулярное выражение pattern, шаблон url и необязательное поле label; плейсхолдеры {name} в url и label заполняются из именованных групп захвата в pattern
• По умолчанию: не задано, поэтому значки не отображаются

Этот пример находит ключи задач, такие как PROJ-1234, и строит каждую ссылку из захваченного ключа:

{
  "footerLinksRegexes": [
    {
      "type": "regex",
      "pattern": "\\b(?<key>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, метка и количество значков для каждой записи ограничены следующим образом:

Когда ход завершается, Claude Code сопоставляет регулярное выражение pattern каждой записи с выводом хода в основном потоке, поэтому медленное регулярное выражение блокирует интерфейс, пока не завершится. Вложенные квантификаторы, такие как (a+)+$, на определённых входных данных могут выполняться экспоненциально долго и зависать сессию, поэтому делайте каждый pattern линейным и избегайте вложенных + или *.

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

keybindingFlavor

[!WARNING]

Объявлен устаревшим начиная с v2.1.261 и ни на что не влияет. Клавиши редактирования слов в промпте всегда следуют соглашениям readline, как в Bash. Claude Code по-прежнему принимает keybindingFlavor, поэтому файл настроек, задающий его, остаётся валидным.

В версиях с v2.1.238 по v2.1.260 значение "readline" заставляло Ctrl+W удалять текст до предыдущего пробельного символа, а не только предыдущее слово.

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

maxProseWidth

Ограничивает ширину текста в ответах Claude, чтобы строки оставались удобочитаемыми в широком терминале. Абзацы, заголовки, списки и цитаты переносятся в пределах этого числа столбцов, а таблицы и блоки кода сохраняют полную ширину терминала. Требуется Claude Code v2.1.282 или новее.

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

{
  "maxProseWidth": 80
}

prefersReducedMotion

Уменьшить или отключить анимации интерфейса, такие как спиннер, мерцание и эффекты вспышки. Отображается в /config как Reduce motion.

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

{
  "prefersReducedMotion": true
}

promptSuggestionEnabled

Показывать или скрывать подсказки промптов — серые предсказания, которые появляются в поле ввода промпта. Установите false или отключите Prompt suggestions в /config, чтобы скрыть их.

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

{
  "promptSuggestionEnabled": false
}

Для подсказок промптов нужна учётная запись claude.ai или Console с включённой телеметрией. В Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, а также при отключённой телеметрии, например через DISABLE_TELEMETRY, этот ключ не действует, и включить подсказки может только CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1.

respectGitignore

Определяет, исключает ли средство выбора файлов @ файлы, соответствующие шаблонам .gitignore. Отображается в /config как Respect .gitignore in file picker.

• Область действия: Any file. Если ни один файл настроек не задаёт этот ключ, Claude Code использует respectGitignore из ~/.claude.json, куда его записывает переключатель в /config.
• Тип: Boolean
  • true: средство выбора файлов @ исключает файлы, соответствующие шаблонам .gitignore
  • false: средство выбора файлов @ включает файлы, соответствующие шаблонам .gitignore
• По умолчанию: true

{
  "respectGitignore": false
}

respondToBashCommands

Определяет, отвечает ли Claude после того, как вы выполните shell-команду с префиксом ! в поле ввода. По умолчанию Claude Code добавляет вывод команды в диалог, и Claude на него отвечает. Установите этот ключ в false, чтобы добавлять вывод в контекст без ответа — так вы сможете выполнить несколько команд и спросить о них вместе.

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

{
  "respondToBashCommands": false
}

См. Режим оболочки с префиксом !.

showClearContextOnPlanAccept

Когда Claude завершает план в режиме планирования, он показывает меню подтверждения. Планирование может использовать много контекста, поэтому этот ключ добавляет в это меню первый вариант, Yes, clear context and …, который утверждает план, очищает контекст диалога и начинает реализацию, опираясь только на план. Оставшаяся часть метки называет режим разрешений, в котором продолжится сессия, и показывает, какую часть контекста использовало планирование.

• Область действия: Any file
• Тип: Boolean
  • true: меню подтверждения плана получает первый вариант, Yes, clear context and …, который утверждает план и очищает контекст диалога
  • false: меню подтверждения плана не показывает вариант очистки контекста
• По умолчанию: false

{
  "showClearContextOnPlanAccept": true
}

showTurnDuration

Показывать или скрывать сообщение о длительности хода после каждого ответа, например «Cooked for 1m 6s · done 6:05 PM». Время после «done» показывает, когда ход завершился; timeFormat и timeZone управляют его форматом и часовым поясом. Отображается в /config как Show turn duration.

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

{
  "showTurnDuration": false
}

spellcheck

Подчёркивать слова с ошибками в поле ввода промпта по мере ввода, используя установленную вами программу проверки орфографии. Claude Code проверяет только текст в поле ввода. В разделе Проверка орфографии по мере ввода описаны установка aspell, hunspell или ispell и то, что проверяет программа проверки. Требуется Claude Code v2.1.235 или новее.

• Область действия: User or managed. Блок из уровня с наивысшим приоритетом, который его задаёт, применяется целиком.
• Тип: объект с полями enabled (Boolean), checker ("aspell", "hunspell", "ispell" или "auto"), language (строка, передаётся программе проверки как имя словаря) и color (строка: название цвета терминала, #rrggbb, rgb(r,g,b), ansi256(n) или ansi:<name>)
• По умолчанию: не задано, поэтому проверка орфографии отключена; checker по умолчанию "auto" — первая из трёх программ, найденная в PATH; language по умолчанию — собственный словарь программы проверки; color по умолчанию — цвет ошибок из темы

{
  "spellcheck": { "enabled": true, "language": "en_GB" }
}

spinnerTipsEnabled

Пока Claude работает, строка спиннера поочерёдно показывает короткие советы о возможностях Claude Code, например «Use Plan Mode to prepare for a complex request before making changes. Press Shift+Tab twice to enable.» Установите этот ключ в false, чтобы скрыть их. Отображается в /config как Show tips.

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

{
  "spinnerTipsEnabled": false
}

spinnerTipsOverride

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

Если вы установите spinnerTipsEnabled в false, Claude Code скроет все советы, включая ваши.

• Область действия: Any file. Claude Code учитывает объекты советов, tipsFile, label и excludeDefault из пользовательских настроек, флага --settings и управляемых настроек; из настроек проекта и локальных настроек он считывает только простые строковые советы.
• Тип: объект с полями tips, tipsFile, label и excludeDefault, каждое необязательное
• По умолчанию: не задано, поэтому Claude Code показывает только встроенные советы

Для объектов советов, tipsFile, label и правила из строки «Область действия» о том, что настройки проекта и локальные настройки добавляют только простые строки, требуется Claude Code v2.1.247 или новее.

Каждая запись tips — это простая строка или объект со следующими полями:

Claude Code считывает простую строку как совет с этими значениями по умолчанию и id на основе позиции, поэтому её история показов сбрасывается при изменении порядка списка. Задайте совету id, чтобы сохранять его историю при правках.

Claude Code считывает не более 200 советов из tips и tipsFile в сумме и отбрасывает недопустимую запись с отладочным предупреждением вместо того, чтобы отклонять файл настроек.

Используйте оставшиеся поля, чтобы указать файл советов, задать префикс и скрыть встроенные советы:

• tipsFile: абсолютный путь или путь вида ~/ к локальному JSON-файлу, содержащему массив таких же записей или объект с массивом tips, размером до 256 KB. Claude Code считывает файл один раз за процесс, поэтому ваши правки загружаются при следующем запуске. Его нельзя задать через серверные управляемые настройки; разворачивайте там встроенные tips или разверните путь в файле managed-settings.json на диске.
• label: префикс, который Claude Code показывает перед советами из пользовательских настроек, --settings и управляемых настроек, до 40 символов. По умолчанию — Tip, тот же префикс, что и у встроенных советов; советы из настроек проекта и локальных настроек всегда используют его.
• excludeDefault: установите true, чтобы скрыть встроенные советы и показывать только ваши. Если Claude Code не может загрузить ни одного вашего совета, например потому что tipsFile не существует или все записи недопустимы, он сохраняет встроенную ротацию вместо пустого спиннера.

Если ключ задан в нескольких файлах настроек, Claude Code показывает советы из всех них, а tipsFile, label и excludeDefault берёт из того источника — управляемых настроек, флага --settings или пользовательских настроек, — который имеет наивысший приоритет среди задающих каждое из этих полей.

Этот пример в ваших пользовательских настройках добавляет в ротацию простой строковый совет и совет-объект с префиксом Acme tip:

{
  "spinnerTipsOverride": {
    "label": "Acme tip",
    "tips": [
      "Run /review before opening a PR",
      {
        "id": "gateway-errors",
        "text": "Seeing 5xx errors? Check the gateway status page first",
        "cooldownSessions": 5,
        "priority": 2
      }
    ]
  }
}

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

• label: Claude Code показывает оба совета как Acme tip: ... вместо Tip: ....
• Простая строка: Claude Code присваивает ей значения по умолчанию, поэтому она может появиться снова уже в следующей сессии.
• id: Claude Code привязывает историю показов второго совета к gateway-errors, поэтому его период ожидания сохраняется после добавления или изменения порядка советов.
• cooldownSessions: после того как Claude Code покажет совет gateway-errors, он не покажет его снова в течение пяти сессий.
• priority: когда совет gateway-errors и другой совет не показывались одинаковое число сессий, например когда ни один из них ещё не был показан, Claude Code сначала показывает gateway-errors. Простая строка имеет приоритет по умолчанию, 0.

Пока Claude работает, Claude Code показывает ваши советы в спиннере с вашим префиксом, например Acme tip: Run /review before opening a PR.

spinnerVerbs

Пока ход выполняется, спиннер показывает сменяющийся глагол, например «Accomplishing», «Architecting» или «Baking». Используйте этот ключ, чтобы добавить в эту ротацию собственные глаголы или заменить встроенный список своим.

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

Этот пример добавляет два глагола к встроенному набору:

{
  "spinnerVerbs": {
    "mode": "append",
    "verbs": ["Pondering", "Crafting"]
  }
}

В режиме "replace" с пустым массивом verbs Claude Code сохраняет встроенные глаголы.

statusLine

Запускать собственную команду для отображения строки состояния под промптом с контекстной информацией, такой как модель, стоимость или ветка git. Необязательные поля настраивают отступы, добавляют периодический перезапуск и скрывают встроенный индикатор режима vim, когда ваш скрипт сам отображает vim.mode.

• Область действия: Any file. Когда включён allowManagedHooksOnly или disableAllHooks задан вне управляемых настроек, выполняется только значение из управляемых настроек.
• Тип: объект, где type имеет значение "command" и есть строка command, а также необязательные padding — число символов, refreshInterval — число секунд, минимум 1, и hideVimModeIndicator — Boolean
• По умолчанию: не задано, поэтому строки состояния нет

Этот пример выводит название модели и использование контекста и добавляет два символа горизонтального отступа:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'",
    "padding": 2
  }
}

Для примера требуется установленный jq, и он выполняется в оболочке. Аналоги для PowerShell и Git Bash см. в разделе Настройка в Windows; полную настройку см. в разделе Ручная настройка строки состояния.

subagentStatusLine

Когда Claude запускает субагентов, Claude Code перечисляет их в области задач под промптом — по одной строке на субагента в формате name · description · token count. Этот ключ позволяет запускать собственную команду, чтобы переписывать эти строки, например чтобы показывать использование контекста каждым субагентом в процентах. При каждом обновлении Claude Code отправляет видимые строки в виде одного JSON-объекта через stdin, с массивом tasks, содержащим для каждого субагента id, name, status, model, tokenCount и другие поля, и заменяет строку для каждого id, который вы возвращаете в виде строки {"id", "content"}. Строки, которые вы не возвращаете, сохраняют отображение по умолчанию.

• Область действия: Any file. Когда включён allowManagedHooksOnly или disableAllHooks задан вне управляемых настроек, выполняется только значение из управляемых настроек.
• Тип: объект, где type имеет значение "command" и есть строка command
• По умолчанию: не задано, поэтому Claude Code отображает строки по умолчанию

{
  "subagentStatusLine": {
    "type": "command",
    "command": "jq -c '.tasks[] | {id, content: \"\\(.name): \\(.tokenCount) tokens\"}'"
  }
}

См. Строки состояния субагентов.

syntaxHighlightingDisabled

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

• Область действия: Any file
• Тип: Boolean
  • true: Claude Code отключает подсветку синтаксиса в diff, блоках кода и предпросмотрах файлов
  • false: Claude Code подсвечивает синтаксис
• По умолчанию: false

{
  "syntaxHighlightingDisabled": true
}

terminalProgressBarEnabled

Некоторые терминалы могут показывать индикатор прогресса на вкладке или на панели задач для запущенной в них программы. Пока Claude работает, Claude Code сообщает терминалу состояние «в процессе», поэтому из другой вкладки или окна видно, занята ли ещё сессия. Индикатор остаётся видимым после окончания хода, пока ещё выполняются фоновые субагенты или динамические рабочие процессы, и исчезает, когда сессия простаивает.

Claude Code сообщает это состояние только в терминалах, поддерживающих индикатор: ConEmu, Ghostty 1.2.0 или новее и iTerm2 3.6.6 или новее. Установите этот ключ в false, чтобы Claude Code перестал его сообщать. Отображается в /config как Terminal progress bar.

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

{
  "terminalProgressBarEnabled": false
}

terminalTitleFromRename

Claude Code задаёт заголовок вкладки вашего терминала. По умолчанию он использует заголовок, сгенерированный на основе диалога, а как только вы дадите сессии имя с помощью /rename или --name, вкладка вместо этого показывает это имя. Установите этот ключ в false, чтобы сохранять на вкладке сгенерированный заголовок даже после того, как вы назовёте сессию. Само имя при этом всё равно применяется, поэтому /resume <name> и средство выбора сессий находят её.

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

{
  "terminalTitleFromRename": false
}

Чтобы Claude Code вообще не обновлял заголовок терминала, установите вместо этого CLAUDE_CODE_DISABLE_TERMINAL_TITLE в 1.

theme

Выбор цветовой темы интерфейса. Отображается в /config как Theme.

• Область действия: Any file. Значение в ~/.claude.json из более старой версии применяется, если ни один файл настроек не задаёт этот ключ.
• Тип: строка, одно из значений:
  • "auto": соответствует светлому или тёмному фону вашего терминала
  • "dark": тёмная тема
  • "light": светлая тема
  • "dark-daltonized": тёмная тема с цветами, подходящими для людей с нарушениями цветового зрения
  • "light-daltonized": светлая тема с цветами, подходящими для людей с нарушениями цветового зрения
  • "dark-ansi": тёмная тема, использующая только палитру цветов ANSI вашего терминала
  • "light-ansi": светлая тема, использующая только палитру цветов ANSI вашего терминала
  • "custom:<slug>" или "custom:<plugin-name>:<slug>": пользовательская тема из ~/.claude/themes/ или из плагина
• По умолчанию: "dark"

{
  "theme": "light-daltonized"
}

См. Создание пользовательской темы.

timeFormat

Определяет, как Claude Code записывает время, которое он показывает в интерфейсе, например done 6:05 PM в конце каждого сообщения о длительности хода и метки времени в средстве просмотра транскрипта. Чтобы выбрать готовый вариант, выполните /config и задайте Time format. Требуется Claude Code v2.1.257 или новее.

• Область действия: Any file
• Тип: строка, одно из значений:
  • "auto": то же, что и отсутствие значения; каждое время сохраняет свой встроенный формат, который в сообщении о длительности хода следует вашей локали
  • "12-hour": 12-часовой формат
  • "24-hour": 24-часовой формат
  • "24-hour-utc": 24-часовой формат в UTC с Z после минут, например 18:05Z; для этого варианта Claude Code игнорирует timeZone
  • Шаблон strftime, например "%H:%M": Claude Code записывает каждое время по шаблону. Любое значение, содержащее %, является шаблоном, а любое другое значение вне готовых вариантов считается "auto"
• По умолчанию: "auto"

{
  "timeFormat": "24-hour"
}

/config предлагает только готовые варианты, поэтому чтобы использовать шаблон strftime, добавьте ключ в файл настроек. Этот пример показывает каждое время в двузначном 24-часовом формате:

{
  "timeFormat": "%H:%M"
}

После этого сообщение о длительности хода и средство просмотра транскрипта показывают время, например 18:05. В средстве просмотра транскрипта шаблон задаёт всю метку времени целиком, поэтому добавьте директивы даты, если хотите видеть там дату. Этот пример ставит дату перед временем:

{
  "timeFormat": "%Y-%m-%d %H:%M"
}

После этого в тех же местах показывается время, например 2026-09-01 18:05.

timeZone

Показывать время в интерфейсе в часовом поясе, отличном от системного. Задайте имя часового пояса IANA, например "UTC" или "Europe/Dublin". Время, которым управляет timeFormat, тогда показывается в этом поясе. Если timeFormat имеет значение "24-hour-utc", время остаётся в UTC, и Claude Code игнорирует этот ключ. В /config нет строки для этого ключа, поэтому задайте его в файле настроек. Требуется Claude Code v2.1.257 или новее.

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

{
  "timeZone": "Europe/Dublin"
}

tui

Выбор рендерера пользовательского интерфейса терминала. Используйте "fullscreen" для рендерера альтернативного экрана без мерцания с виртуализированной прокруткой или "default" для классического рендерера основного экрана. Выполнение /tui fullscreen или /tui default записывает этот ключ за вас.

• Область действия: Any file
• Тип: строка, одно из значений:
  • "default": классический рендерер основного экрана
  • "fullscreen": рендерер альтернативного экрана без мерцания с виртуализированной прокруткой
• По умолчанию: не задано, поэтому Claude Code выбирает рендерер за вас
• Переопределения для отдельной сессии: CLAUDE_CODE_NO_FLICKER и CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN имеют приоритет над этим ключом в рамках одной сессии: CLAUDE_CODE_NO_FLICKER=1 включает полноэкранный режим, а CLAUDE_CODE_NO_FLICKER=0 или CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 отключает его; если заданы обе переменные, Claude Code отключает его

{
  "tui": "fullscreen"
}

В tmux -CC или при подключении по SSH к Windows Claude Code сохраняет классический рендерер, если вы не установите CLAUDE_CODE_NO_FLICKER=1. Фоновые сессии, открытые из представления агентов, всегда используют полноэкранный рендерер независимо от этой настройки.

verbose

По умолчанию транскрипт сворачивает каждый вызов инструмента в краткую сводку, например команду, которую выполнил Claude, и количество строк её вывода, а чтобы увидеть подробности, вы нажимаете Ctrl+O и переключаете весь транскрипт в развёрнутый вид. Установите этот ключ в true, чтобы показывать полные входные и выходные данные каждого вызова инструмента прямо по ходу выполнения, что полезно при отладке хука, MCP-сервера или длинной shell-команды. Отображается в /config как Verbose output.

• Область действия: Any file. Значение в ~/.claude.json из более старой версии применяется, если ни один файл настроек не задаёт этот ключ.
• Тип: Boolean
  • true: вы видите полный вывод инструментов
  • false: вы видите сокращённые сводки вывода инструментов
• По умолчанию: false
• Переопределения для отдельной сессии: --verbose имеет приоритет над этим ключом в рамках одной сессии

{
  "verbose": true
}

Значение viewMode или сохранённый выбор /focus переопределяет этот ключ в каждой сессии.

viewMode

Задаёт вид транскрипта, в котором запускается Claude Code: "default", "verbose" или "focus". Если значение задано, оно переопределяет как сохранённый выбор /focus, так и настройку verbose.

• Область действия: Any file
• Тип: строка, одно из значений:
  • "default": обычный транскрипт с сокращённым выводом инструментов
  • "verbose": транскрипт с полным выводом инструментов
  • "focus": только ваш последний промпт, однострочная сводка вызовов инструментов со статистикой изменений и итоговый ответ. Для режима фокуса нужен полноэкранный рендерер
• По умолчанию: не задано, поэтому применяются настройка verbose и ваш последний выбор /focus
• Переопределения для отдельной сессии: --verbose имеет приоритет над этим ключом в рамках одной сессии

{
  "viewMode": "focus"
}

vimInsertModeRemaps

Сопоставляет двухклавишные последовательности режима INSERT с клавишей Escape в режиме редактора vim. Каждый ключ — это ровно два печатаемых символа, набираемых последовательно, и "<Esc>" — единственная поддерживаемая цель; Claude Code игнорирует другие записи.

• Область действия: User or managed. Репозиторий не может переназначать ваши нажатия клавиш.
• Тип: объект, сопоставляющий двухсимвольную последовательность с "<Esc>"
• По умолчанию: не задано

{
  "vimInsertModeRemaps": {
    "jj": "<Esc>"
  }
}

Не действует, если editorMode не равен "vim". См. Переназначение последовательностей клавиш в режиме INSERT.

voice

Включает голосовой ввод и определяет поведение клавиши диктовки. Claude Code записывает этот объект за вас, когда вы выполняете /voice.

• Область действия: Any file
• Тип: объект с полем enabled типа Boolean, autoSubmit типа Boolean, которое применяется только в режиме удержания, и mode, одно из значений:
  • "hold": вы удерживаете клавишу диктовки во время речи и отпускаете её, чтобы остановить
  • "tap": вы нажимаете клавишу один раз, чтобы начать запись, и ещё раз, чтобы отправить
• По умолчанию: не задано, поэтому диктовка отключена; если enabled равно true, а mode не задан, Claude Code использует "hold"

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

{
  "voice": {
    "enabled": true,
    "mode": "tap"
  }
}

autoSubmit отправляет промпт, когда вы отпускаете клавишу в режиме удержания. Для голосового ввода требуется учётная запись claude.ai.

voiceEnabled

[!WARNING]

Объявлен устаревшим начиная с v2.1.92, когда его заменил объект voice. Claude Code по-прежнему считывает его, чтобы старые файлы настроек продолжали работать, но в новых конфигурациях следует задавать voice.enabled.

Включает голосовой ввод с помощью единственного значения Boolean — формы, существовавшей до объекта voice. Если заданы оба, применяется voice.enabled.

• Область действия: Any file
• Тип: Boolean
  • true: голосовой ввод включён, если вы вошли с учётной записью claude.ai и политика вашей организации разрешает голосовой ввод, если только не задано voice.enabled
  • false: голосовой ввод отключён, если только не задано voice.enabled
• По умолчанию: не задано

{
  "voiceEnabled": true
}

wheelScrollAccelerationEnabled

Ускорять прокрутку колёсиком мыши при быстрой прокрутке в полноэкранном режиме отображения. Установите false для постоянной скорости прокрутки на каждый щелчок колёсика.

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

{
  "wheelScrollAccelerationEnabled": false
}

Git и атрибуция

Управляйте атрибуцией, которую Claude Code добавляет к коммитам и pull request'ам, и тем, как она работает с git.

attribution

Настройте атрибуцию, которую Claude Code добавляет к git коммитам и pull request'ам. По умолчанию коммиты получают git trailer такой как Co-Authored-By; описания pull request'ов получают простой текст. Установите каждую часть отдельно с помощью подключей ниже.

• Область действия: Any file
• Тип: объект со строками commit и pr и логическим значением sessionUrl, или false для скрытия всей атрибуции. Значение false требует Claude Code v2.1.281 или позже; более ранние версии его отклоняют и пропускают весь файл пользователя, проекта или локальных параметров, который его содержит
• По умолчанию: не установлено, поэтому Claude Code использует стандартную атрибуцию, показанную под каждым подключом