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

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

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

advisorModel

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

{
  "advisorModel": "opus"
}

alwaysThinkingEnabled

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

{
  "alwaysThinkingEnabled": false
}

availableModels

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

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

availableModelsMatch

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

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

deniedModels

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

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

effortLevel

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

{
  "effortLevel": "xhigh"
}

enforceAvailableModels

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

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

fallbackModel

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

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

fastMode

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

{
  "fastMode": true
}

fastModePerSessionOptIn

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

{
  "fastModePerSessionOptIn": true
}

language

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

{
  "language": "japanese"
}

maxEffortLevel

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

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

model

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

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

modelOverrides

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

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

modelPicker

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

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

Поля для modelPicker

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

modelPricing

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

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

Поля для modelPricing

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

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

modelSettings

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

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

outputStyle

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

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

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

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

showThinkingSummaries

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

{
  "showThinkingSummaries": true
}

subagentPromptCacheTtl

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

{
  "subagentPromptCacheTtl": "1h"
}

switchModelsOnFlag

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

{
  "switchModelsOnFlag": false
}

ultracode

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

{
  "ultracode": true
}

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

allowManagedPermissionRulesOnly

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

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

{
  "allowManagedPermissionRulesOnly": true
}

autoMode

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

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

autoMode.classifyAllShell

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

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

disableAutoMode

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

{
  "disableAutoMode": "disable"
}

permissions

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

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

useAutoModeDuringPlan

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

{
  "useAutoModeDuringPlan": false
}

permissions.allow

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

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

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

permissions.ask

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

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

permissions.deny

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

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

permissions.additionalDirectories

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

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

permissions.blockReadsOutsideWorkingDirectories

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

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

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

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

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

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

permissions.blockWritesOutsideWorkingDirectories

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

{
  "permissions": {
    "blockWritesOutsideWorkingDirectories": true
  }
}

Что запрещает блокировка записи и что остаётся доступным для записи

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