Переменные окружения
Справочник по переменным окружения, которые управляют поведением Claude Code.
Переменные окружения могут управлять поведением Claude Code, такие как выбор модели, аутентификация, маршрутизация запросов и переключатели функций. Многие из этих же поведений также можно настроить через поле файла параметров, флаг CLI или команду в сеансе, такую как /model.
На этой странице рассматривается, как:
- Установить переменные окружения в вашей оболочке или в файле параметров
- Проверить, какое значение применяется, когда поведение можно установить несколькими способами
- Найти переменные, которые читает Claude Code
- Посмотреть, какие функции перестают работать, когда переменная отключает получение флагов функций
Установка переменных окружения
Переменная, установленная в вашей оболочке, действует только в течение этой сессии терминала, а переменная в файле настроек применяется каждый раз при запуске claude.
Установка переменных в вашей оболочке
Установите переменную перед запуском claude:
export API_TIMEOUT_MS="1200000"
claude
Чтобы установить её для каждой сессии, добавьте строку export в ~/.bashrc, ~/.zshrc или файл профиля вашей оболочки.
$env:API_TIMEOUT_MS = "1200000"
claude
Чтобы установить её для каждой сессии, выполните [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User") и откройте новый терминал.
set API_TIMEOUT_MS=1200000
claude
Чтобы установить её для каждой сессии, выполните setx API_TIMEOUT_MS "1200000" и откройте новый терминал.
Строка присваивания ничего не выводит при успехе. Чтобы подтвердить, что переменная установлена, выведите её в той же оболочке:
echo $API_TIMEOUT_MS
echo $env:API_TIMEOUT_MS
echo %API_TIMEOUT_MS%
Установка переменных в файлах настроек
Добавьте переменные под ключом env в файл settings.json, создав файл, если его ещё нет. Claude Code читает их непосредственно из файла, поэтому они вступают в силу независимо от того, как был запущен claude. Работающая сессия применяет новые и изменённые значения к своему окружению при сохранении файла, но функция, которая читает свои переменные один раз при запуске, такая как мониторинг OpenTelemetry, сохраняет свои значения при запуске до перезапуска. Удаление переменной из файла не отменяет её в работающей сессии; удаление вступает в силу при следующем запуске claude.
{
"env": {
"API_TIMEOUT_MS": "1200000",
"BASH_DEFAULT_TIMEOUT_MS": "300000"
}
}
Claude Code копирует эти значения в своё окружение как есть. Никакая оболочка их не обрабатывает, поэтому сокращения, такие как ~ или $HOME, остаются в том виде, в каком они введены. Для переменной, принимающей путь, например CLAUDE_CONFIG_DIR, укажите абсолютный путь: "CLAUDE_CONFIG_DIR": "/home/you/.claude-work".
Выбранный вами файл определяет, к кому применяются переменные:
| Файл | Применяется к |
|---|---|
~/.claude/settings.json |
Вам, в каждом проекте |
.claude/settings.json |
Всем, кто работает в проекте, добавлен в систему управления версиями |
.claude/settings.local.json |
Вам, только в этом проекте, игнорируется git, когда Claude Code сохраняет в него настройку; добавьте его в gitignore, если создадите вручную |
| Управляемые настройки | Всем в вашей организации, развёрнуто администратором |
См. Файлы настроек для информации о том, где находится каждый файл, и Приоритет настроек для информации о том, как они объединяются, когда более одного устанавливает одну и ту же переменную.
Приоритет
Некоторые поведения имеют как переменную окружения, так и выделенный ключ параметров, и то, какой из них Claude Code читает первым, отличается для каждого ключа. Для ANTHROPIC_MODEL и CLAUDE_CODE_AUTO_CONNECT_IDE Claude Code сначала читает переменную и использует параметр model или autoConnectIde только когда переменная не установлена. Для пары, которую вы устанавливаете, проверьте строку переменной ниже и запись ключа в справочнике параметров.
Когда одна и та же переменная установлена как в вашей оболочке, так и в блоке env файла параметров, применяется значение из файла параметров в большинстве сеансов. Claude Code записывает каждую запись env в переменные окружения процесса, заменяя значение, унаследованное из оболочки. Как значения env взаимодействуют с вашей оболочкой охватывает сеансы, которые сохраняют унаследованное значение вместо этого, и параметр env указывает, когда он их применяет. Несколько переменных имеют специальную обработку; параметр env перечисляет исключения.
В файле параметров вы можете установить переменную, но не можете удалить её. Чтобы переопределить переменную, которую вы не можете отменить, например устаревшую CLAUDE_CODE_USE_VERTEX, экспортированную профилем оболочки, который вы не контролируете, установите её на пустую строку в блоке env: "CLAUDE_CODE_USE_VERTEX": "". Claude Code рассматривает пустое значение как неустановленное для выбора поставщика. Подпроцессы по-прежнему наследуют пустое значение.
Между файлами параметров значения env следуют приоритету параметров, поэтому управляемая запись параметров переопределяет ту же переменную в пользовательских или проектных параметрах. Проектные и локальные параметры не могут устанавливать некоторые переменные, такие как CLAUDE_CONFIG_DIR и переменные экспортера OpenTelemetry. Переменные, которые Claude Code игнорирует в env перечисляет их, а также значения отключения OpenTelemetry, которые по-прежнему применяются.
То, как переменная окружения взаимодействует с флагами CLI и командами в сеансе, варьируется в зависимости от функции: --model и /model переопределяют ANTHROPIC_MODEL, в то время как CLAUDE_CODE_EFFORT_LEVEL переопределяет --effort и /effort. Когда переменная взаимодействует с другим источником конфигурации, её строка в списке Переменные указывает приоритет или ссылается на страницу, которая это документирует.
Claude Code читает переменные окружения оболочки при запуске, поэтому изменения в них вступают в силу при следующем запуске claude. Переменные, установленные под ключом env в файлах настроек, повторно применяются к работающей сессии при изменении файла, за исключением переменных, читаемых только при запуске, как описано в разделе Установка переменных в файлах настроек.
Переменные
Числовые переменные, такие как таймауты, бюджеты токенов и количество повторных попыток, помимо обычных цифр принимают экспоненциальную запись и запись с разделителями разрядов, кроме случаев, когда в строке переменной указано, что она принимает только обычные цифры. Например, Claude Code читает 2e3 как 2000, а 64_000 как 64000. До v2.1.211 такая запись могла незаметно установить гораздо меньшее значение, например 1e6 устанавливало таймаут равным 1.
Для переменных, которые включают или отключают поведение, установите 1, true, yes или on, чтобы включить его, и 0, false, no или off, чтобы отключить, в любом регистре.
Некоторые переменные проверяют только то, заданы ли они вообще, поэтому любое непустое значение, включая 0, включает поведение, а отключить его можно, удалив переменную или установив пустое значение. Так работают следующие переменные:
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICDISABLE_TELEMETRYDISABLE_ERROR_REPORTINGCLAUDE_CODE_TMUX_TRUECOLORFALLBACK_FOR_ALL_PRIMARY_MODELSIS_DEMO
Ещё одна переменная подчиняется собственному правилу: FORCE_HYPERLINK читает число, поэтому отключает её только 0. В строке каждой переменной также указано её собственное правило.
| Переменная | Назначение |
|---|---|
ANTHROPIC_API_KEY |
API-ключ, отправляемый в заголовке X-Api-Key. Если он задан, этот ключ используется вместо вашей подписки Claude Pro, Max, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (-p) ключ всегда используется, если он присутствует. В интерактивном режиме вам один раз будет предложено подтвердить ключ, прежде чем он переопределит вашу подписку. Чтобы вместо этого использовать подписку, выполните unset ANTHROPIC_API_KEY |
ANTHROPIC_AUTH_TOKEN |
Пользовательское значение для заголовка Authorization (к заданному здесь значению будет добавлен префикс Bearer ) |
ANTHROPIC_AWS_API_KEY |
API-ключ рабочего пространства для Claude Platform on AWS, созданный в AWS Console. Отправляется как x-api-key и имеет приоритет над AWS SigV4 |
ANTHROPIC_AWS_BASE_URL |
Переопределяет URL эндпоинта Claude Platform on AWS. Используйте для пользовательских регионов или при маршрутизации через LLM-шлюз. По умолчанию https://aws-external-anthropic.{region}.api.aws. Claude Code определяет регион с тем же приоритетом, что и в Amazon Bedrock |
ANTHROPIC_AWS_WORKSPACE_ID |
Обязательна для Claude Platform on AWS. Отправляется в каждом запросе в заголовке anthropic-workspace-id |
ANTHROPIC_BASE_URL |
Переопределяет эндпоинт API для маршрутизации запросов через прокси или шлюз. Если задан хост, не принадлежащий Anthropic, MCP tool search по умолчанию отключается. Установите ENABLE_TOOL_SEARCH=true, если ваш прокси пересылает блоки tool_reference. Начиная с v2.1.196, Remote Control отключается, когда эта переменная указывает на хост, отличный от api.anthropic.com, что соответствует его поведению в Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry |
ANTHROPIC_BEDROCK_BASE_URL |
Переопределяет URL эндпоинта Amazon Bedrock. Используйте для пользовательских эндпоинтов Amazon Bedrock или при маршрутизации через LLM-шлюз. См. Amazon Bedrock |
ANTHROPIC_BEDROCK_MANTLE_BASE_URL |
Переопределяет URL эндпоинта Amazon Bedrock Mantle. См. эндпоинт Mantle |
ANTHROPIC_BEDROCK_REGION_PREFIX |
Префикс профиля межрегионального инференса (us, eu, apac, jp, au или global), который Claude Code пробует первым вместо префикса, выведенного из региона AWS. Игнорируется в регионах AWS GovCloud. Требуется Claude Code v2.1.224 или новее. См. Amazon Bedrock |
ANTHROPIC_BEDROCK_SERVICE_TIER |
Уровень обслуживания Amazon Bedrock (default, flex или priority). Отправляется в заголовке X-Amzn-Bedrock-Service-Tier. См. Amazon Bedrock |
ANTHROPIC_BETAS |
Список дополнительных значений заголовка anthropic-beta через запятую для включения в запросы API. Claude Code уже отправляет нужные ему бета-заголовки; используйте эту переменную, чтобы подключить бета-функцию Anthropic API до того, как Claude Code добавит её встроенную поддержку. В отличие от флага --betas, который требует аутентификации по API-ключу, эта переменная работает со всеми методами аутентификации, включая подписку Claude.ai |
ANTHROPIC_CUSTOM_HEADERS |
Пользовательские заголовки для добавления к запросам (формат Name: Value, для нескольких заголовков — через перевод строки). Если имя или значение содержит символ, который не может передаваться в HTTP-заголовке, например фигурную кавычку или пробел нулевой ширины, запрос завершается ошибкой, указывающей позицию пары. Требуется Claude Code v2.1.227 или новее. В разделе Invalid request header value перечислен точный набор символов и указано, где выполняется проверка. Значение, задающее заголовок учётных данных, организации или тенанта, маршрутизации или поведения API, например Authorization или Host, считается настройкой, требующей подтверждения, когда его доставляют настройки, управляемые сервером. Из настроек проекта или локальных настроек такое значение подчиняется правилам применения значений env |
ANTHROPIC_CUSTOM_MODEL_OPTION |
ID модели, добавляемой как пользовательский пункт в селектор /model. Используйте, чтобы сделать нестандартную модель или модель конкретного шлюза доступной для выбора без замены встроенных псевдонимов. См. Конфигурация модели |
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION |
Отображаемое описание пользовательского пункта модели в селекторе /model. Если не задано, по умолчанию Custom model (<model-id>) |
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME |
Отображаемое имя пользовательского пункта модели в селекторе /model. Если не задано, пункт показывает название модели, если Claude Code распознаёт ID, а в противном случае — ID модели |
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES |
Список возможностей, поддерживаемых пользовательской моделью, через запятую, например effort,thinking. См. Конфигурация модели |
ANTHROPIC_DEFAULT_FABLE_MODEL |
ID модели, в который разрешается псевдоним fable, а также ID, который Claude Code распознаёт как модель Fable для автоматического переключения на резервную модель у сторонних провайдеров. См. Конфигурация модели |
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION |
Отображаемое описание закреплённой модели Fable в селекторе /model. Если не задано, в строке отображается описание по умолчанию, начинающееся с Custom Fable model. См. Конфигурация модели |
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME |
Отображаемое имя закреплённой модели Fable в селекторе /model. Если не задано, в строке отображается название модели, если Claude Code распознаёт закреплённый ID, а в противном случае — закреплённый ID. См. Конфигурация модели |
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES |
Список возможностей, поддерживаемых закреплённой моделью Fable, через запятую, например effort,thinking. См. Конфигурация модели |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
ID модели, в который разрешается псевдоним haiku; также используется для фоновых функций. См. Конфигурация модели |
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION |
Отображаемое описание закреплённой модели Haiku в селекторе /model. Если не задано, в строке отображается описание по умолчанию, начинающееся с Custom Haiku model. См. Конфигурация модели |
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME |
Отображаемое имя закреплённой модели Haiku в селекторе /model. Если не задано, в строке отображается название модели, если Claude Code распознаёт закреплённый ID, а в противном случае — закреплённый ID. См. Конфигурация модели |
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES |
Список возможностей, поддерживаемых закреплённой моделью Haiku, через запятую, например effort,thinking. См. Конфигурация модели |
ANTHROPIC_DEFAULT_MODEL |
Модель, с которой по умолчанию начинаются новые сессии. Требуется Claude Code v2.1.236 или новее. См. Задание модели по умолчанию для новых сессий |
ANTHROPIC_DEFAULT_OPUS_MODEL |
ID модели, в который разрешается псевдоним opus и который opusplan использует, пока активен режим планирования. См. Конфигурация модели |
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION |
Отображаемое описание закреплённой модели Opus в селекторе /model. Если не задано, в строке отображается описание по умолчанию, начинающееся с Custom Opus model. См. Конфигурация модели |
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME |
Отображаемое имя закреплённой модели Opus в селекторе /model. Если не задано, в строке отображается название модели, если Claude Code распознаёт закреплённый ID, а в противном случае — закреплённый ID. См. Конфигурация модели |
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES |
Список возможностей, поддерживаемых закреплённой моделью Opus, через запятую, например effort,thinking. См. Конфигурация модели |
ANTHROPIC_DEFAULT_SONNET_MODEL |
ID модели, в который разрешается псевдоним sonnet и который opusplan использует, когда режим планирования не активен. См. Конфигурация модели |
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION |
Отображаемое описание закреплённой модели Sonnet в селекторе /model. Если не задано, в строке отображается описание по умолчанию, начинающееся с Custom Sonnet model. См. Конфигурация модели |
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME |
Отображаемое имя закреплённой модели Sonnet в селекторе /model. Если не задано, в строке отображается название модели, если Claude Code распознаёт закреплённый ID, а в противном случае — закреплённый ID. См. Конфигурация модели |
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES |
Список возможностей, поддерживаемых закреплённой моделью Sonnet, через запятую, например effort,thinking. См. Конфигурация модели |
ANTHROPIC_FEDERATION_RULE_ID |
ID правила федерации для Workload Identity Federation. Если задать её вместе с ANTHROPIC_ORGANIZATION_ID, Claude Code выбирает федеративные учётные данные, которые имеют приоритет над учётными данными /login. См. приоритет аутентификации |
ANTHROPIC_FOUNDRY_API_KEY |
API-ключ для аутентификации в Microsoft Foundry (см. Microsoft Foundry) |
ANTHROPIC_FOUNDRY_AUTH_TOKEN |
Bearer-токен для аутентификации в Microsoft Foundry, например токен доступа Microsoft Entra. Claude Code отправляет его в заголовке Authorization: Bearer. Имеет приоритет над ANTHROPIC_FOUNDRY_API_KEY и над цепочкой учётных данных Azure по умолчанию. См. Microsoft Foundry. Требуется Claude Code v2.1.203 или новее |
ANTHROPIC_FOUNDRY_BASE_URL |
Полный базовый URL ресурса Microsoft Foundry (например, https://my-resource.services.ai.azure.com/anthropic). Альтернатива ANTHROPIC_FOUNDRY_RESOURCE (см. Microsoft Foundry) |
ANTHROPIC_FOUNDRY_RESOURCE |
Имя ресурса Microsoft Foundry (например, my-resource). Claude Code отклоняет URL или имя хоста. Обязательна, если не задана ANTHROPIC_FOUNDRY_BASE_URL (см. Microsoft Foundry) |
ANTHROPIC_MODEL |
Имя используемой настройки модели (см. Конфигурация модели) |
ANTHROPIC_ORGANIZATION_ID |
ID организации для Workload Identity Federation. Задавайте вместе с ANTHROPIC_FEDERATION_RULE_ID. См. приоритет аутентификации |
ANTHROPIC_PROFILE |
Имя профиля Anthropic для аутентификации, например созданного командой ant auth login или при входе в аккаунт Console без API-ключа. См. приоритет аутентификации |
ANTHROPIC_SMALL_FAST_MODEL |
[УСТАРЕЛА] Имя модели класса Haiku для фоновых задач |
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION |
Переопределяет регион AWS для модели класса Haiku при использовании Amazon Bedrock или Amazon Bedrock Mantle. В Amazon Bedrock действует только тогда, когда также задана ANTHROPIC_DEFAULT_HAIKU_MODEL или устаревшая ANTHROPIC_SMALL_FAST_MODEL, поскольку в остальных случаях Amazon Bedrock выполняет фоновые задачи на модели Sonnet по умолчанию или основной модели в регионе сессии |
ANTHROPIC_VERTEX_BASE_URL |
Переопределяет URL эндпоинта Google Cloud's Agent Platform. Используйте для пользовательских эндпоинтов Google Cloud's Agent Platform или при маршрутизации через LLM-шлюз. См. Google Cloud's Agent Platform |
ANTHROPIC_VERTEX_PROJECT_ID |
ID проекта GCP, которому адресуются запросы Google Cloud's Agent Platform. См. Настройка учётных данных GCP |
ANTHROPIC_WORKSPACE_ID |
ID рабочего пространства для workload identity federation. Задайте её, если ваше правило федерации охватывает более одного рабочего пространства, чтобы при обмене токенов было известно, какое рабочее пространство использовать |
API_FORCE_IDLE_TIMEOUT |
Переопределяет 5-минутный таймаут простоя тела ответа, который прерывает потоковый ответ модели, если байты не поступают. Установите 0, чтобы отключить таймаут, например когда медленный шлюз или локальная модель делает паузы между фрагментами дольше 5 минут, или 1, чтобы оставить его включённым для всех провайдеров. Если не задана, таймаут активен у провайдеров, кроме прямого Anthropic API, Claude Platform on AWS и Amazon Bedrock с установленной CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1. Сторожевые механизмы потока работают независимо от него и прерывают длительную паузу без данных, даже если здесь установлено 0 |
API_TIMEOUT_MS |
Таймаут запросов API в миллисекундах (по умолчанию: 600000, или 10 минут; максимум: 2147483647). Увеличьте его, если запросы завершаются по таймауту в медленных сетях или при маршрутизации через прокси. Значения выше максимума переполняют базовый таймер и приводят к немедленному сбою запросов |
AWS_BEARER_TOKEN_BEDROCK |
API-ключ Amazon Bedrock для аутентификации (см. API-ключи Amazon Bedrock) |
BASH_DEFAULT_TIMEOUT_MS |
Таймаут по умолчанию для команды инструмента Bash или PowerShell на переднем плане, в миллисекундах (по умолчанию: 120000, или 2 минуты). Значение выше ограничения времени по умолчанию для фоновых команд заменяет это значение по умолчанию в автономных сессиях. Ограничение времени для фоновых команд требует Claude Code v2.1.285 или новее |
BASH_MAX_OUTPUT_LENGTH |
Максимальное количество символов вывода bash, которые Claude Code считывает в результат команды (по умолчанию: 30000; максимум: 150000). Если задана настройка bashOutputMaxChars, Claude Code игнорирует эту переменную. См. Ограничения вывода |
BASH_MAX_TIMEOUT_MS |
Максимальный таймаут, который модель может задать для команды инструмента Bash или PowerShell на переднем плане, в миллисекундах (по умолчанию: 600000, или 10 минут). Фактический предел — большее из этого значения и BASH_DEFAULT_TIMEOUT_MS. Фактический предел длиннее 2 часов также становится максимальным ограничением времени для фоновых команд в автономных сессиях. Ограничение времени для фоновых команд требует Claude Code v2.1.285 или новее |
BETA_TRACING_ENDPOINT |
Эндпоинт OTLP/HTTP для детальной бета-трассировки: при ENABLE_BETA_TRACING_DETAILED=1 логи и трассировки отправляются туда, а не в настроенные экспортеры. Задайте её в оболочке, пользовательских настройках или управляемых настройках. Игнорируется в настройках проекта и локальных настройках |
CCR_FORCE_BUNDLE |
Установите 1, чтобы claude --cloud принудительно упаковывал и загружал ваш локальный репозиторий вместо клонирования из удалённого |
CLAUDECODE |
Устанавливается в 1 в подпроцессах, которые запускает Claude Code (инструменты Bash и PowerShell, сессии tmux, команды хуков, команды строки состояния, подпроцессы stdio MCP-серверов). Расширения IDE также задают её в своих встроенных терминалах. Используйте, чтобы определить, что скрипт выполняется внутри подпроцесса, запущенного Claude Code. Чтобы проверить, был ли текущий процесс запущен непосредственно вызовом инструмента или хуком, а не внутри stdio MCP-сервера, запущенного Claude Code, используйте вместо этого CLAUDE_CODE_CHILD_SESSION |
CLAUDE_AFK_COUNTDOWN_MS |
За сколько миллисекунд до автоматического продолжения на экране появляется обратный отсчёт в диалоговом окне AskUserQuestion, оставшемся без ответа. По умолчанию 20000 (20 секунд), ограничено таймаутом автоматического продолжения. Не действует, если автоматическое продолжение не включено; см. настройку askUserQuestionTimeout и CLAUDE_AFK_TIMEOUT_MS. Игнорируется в настройках проекта и локальных настройках. Требуется Claude Code v2.1.198 или новее |
CLAUDE_AFK_TIMEOUT_MS |
Сколько миллисекунд простоя должно пройти, прежде чем диалоговое окно AskUserQuestion, оставшееся без ответа, автоматически продолжит работу без вас. Автоматическое продолжение по умолчанию отключено; включите его настройкой askUserQuestionTimeout. Эта переменная — переопределение для демонстраций и автоматических тестов: если она задана, она имеет приоритет над этой настройкой и включает автоматическое продолжение, даже когда настройка не задана или равна never. Значение 0 не отключает таймаут, а сразу закрывает диалоговое окно. Игнорируется в настройках проекта и локальных настройках. До v2.1.200 автоматическое продолжение было включено по умолчанию с таймаутом 60000 (60 секунд). Требуется Claude Code v2.1.198 или новее |
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS |
Установите 1, чтобы отключить все встроенные типы субагентов, такие как Explore и Plan. Действует только в неинтерактивном режиме (флаг -p). Полезно для пользователей SDK, которым нужен чистый лист. Также удаляется general-purpose — субагент, которого Claude Code запускает, когда в вызове инструмента Agent не указан subagent_type. Такой вызов тогда завершается ошибкой subagent_type is required |
CLAUDE_AGENT_SDK_MCP_NO_PREFIX |
Установите 1, чтобы не добавлять префикс mcp__<server>__ к именам инструментов MCP-серверов, созданных через SDK. Инструменты используют свои исходные имена. Только для использования SDK |
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS |
Таймаут зависания субагентов в миллисекундах. Также распространяется на агентов рабочих процессов в Claude Code v2.1.286 или новее. По умолчанию 600000 (10 минут); если вы увеличите CLAUDE_STREAM_IDLE_TIMEOUT_MS при включённом сторожевом механизме потока, значение по умолчанию увеличится вместе с ней, как описано в разделе Обработка медленных или зависших ответов API |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE |
Задаёт процент (1-100) окна автосжатия, при котором срабатывает автосжатие. Используйте меньшие значения, например 50, чтобы сжимать раньше; переменная не может повысить порог, поэтому значения выше процента по умолчанию игнорируются. Действует только в сессиях, которые сжимаются до достижения лимита контекста модели. Применяется как к основным диалогам, так и к субагентам |
CLAUDE_AUTO_BACKGROUND_TASKS |
Установите 1, чтобы принудительно включить автоматический перевод в фон длительных задач агентов. Если включено, субагенты переводятся в фон примерно через две минуты работы. Также включает автоматический перевод в фон длительных вызовов инструментов MCP в неинтерактивном режиме в Claude Code v2.1.212 или новее |
CLAUDE_AX_PREPARK_MS |
В режиме экранного диктора — сколько миллисекунд Claude Code ждёт, прежде чем вывести новую или изменённую строку. По умолчанию 0, то есть Claude Code не ждёт. До v2.1.287 значение по умолчанию было 50. Claude Code ограничивает ожидание значением 5000. Требуется Claude Code v2.1.233 или новее |
CLAUDE_AX_SCREEN_READER |
Установите 1, чтобы выводить удобный для экранного диктора текст: простой текст без декоративных рамок и анимаций. Установите 0, чтобы принудительно отключить режим экранного диктора, даже если axScreenReader равен true. Флаг --ax-screen-reader имеет приоритет. Требуется Claude Code v2.1.181 или новее |
CLAUDE_AX_STARTUP_QUIET_MS |
В режиме экранного диктора — сколько миллисекунд Claude Code задерживает первую отрисовку интерфейса после строки подтверждения запуска, чтобы экранный диктор успел полностью зачитать эту строку, прежде чем новый вывод её прервёт. По умолчанию 3000. Установите 0, чтобы отрисовывать сразу. Claude Code ограничивает задержку значением 600000 (10 минут). Первое нажатие клавиши досрочно завершает задержку. Требуется Claude Code v2.1.217 или новее |
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR |
Возвращаться в исходный рабочий каталог после каждой команды Bash или PowerShell в основной сессии |
CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS |
Таймаут в миллисекундах для байтового сторожевого механизма простоя потоковой передачи; если задана, имеет приоритет над CLAUDE_STREAM_IDLE_TIMEOUT_MS для этого механизма и не изменяет сторожевой механизм уровня событий. Claude Code ограничивает значение этой переменной диапазоном от 10 секунд до 30 минут. Требуется Claude Code v2.1.210 или новее |
CLAUDE_CLIENT_PRESENCE_FILE |
Путь к файлу, который внешний инструмент, например обработчик блокировки экрана, создаёт при разблокировке экрана и удаляет при блокировке. Пока файл существует, Claude Code пропускает мобильные push-уведомления Remote Control, чтобы вы не получали их, пока активно пользуетесь компьютером. Если файл отсутствует или недоступен для чтения, уведомления отправляются как обычно. Claude Code проверяет файл один раз при каждом событии, вызывающем push-уведомление, а не опрашивает его постоянно. Требуется Claude Code v2.1.181 или новее |
CLAUDE_CODE_ACCESSIBILITY |
Установите 1, чтобы оставить видимым нативный курсор терминала и отключить индикатор курсора с инвертированным текстом. Позволяет экранным лупам, например macOS Zoom, отслеживать положение курсора |
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD |
Установите 1, чтобы загружать файлы памяти из каталогов, указанных с помощью --add-dir. Загружаются CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md и CLAUDE.local.md. По умолчанию дополнительные каталоги не загружают файлы памяти |
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT |
Установите 1, чтобы в полноэкранной отрисовке перерисовывать весь экран в каждом кадре вместо отправки инкрементных обновлений. Используйте, если в полноэкранном режиме отображаются устаревшие или смещённые фрагменты текста. Claude Code включает это автоматически для фоновых сессий и agent view в Windows |
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT |
Установите 1, чтобы отправлять параметр effort в каждом запросе, даже если Claude Code не распознаёт ID модели как поддерживающий effort. Используйте при маршрутизации через LLM-шлюз или стороннего провайдера, который обслуживает модели под пользовательскими идентификаторами. Модели, отклоняющие параметр effort на уровне API, включая модели Claude 3, Sonnet 4.0 и 4.5, Opus 4.0 и 4.1, а также Haiku 4.5, по-прежнему исключаются, чтобы запросы не завершались сбоем |
CLAUDE_CODE_API_KEY_HELPER_TTL_MS |
Интервал в миллисекундах, с которым следует обновлять учётные данные (при использовании apiKeyHelper) |
CLAUDE_CODE_ARTIFACT_AUTO_OPEN |
Установите 0, чтобы Claude Code не открывал браузер автоматически при публикации нового артефакта |
CLAUDE_CODE_ARTIFACT_COMMENTS |
Установите 0, чтобы Claude не читал комментарии к артефакту и не отвечал на них. Не действует, если CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC отключила артефакты. Требуется Claude Code v2.1.221 или новее |
CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT |
Установите 0, чтобы Claude не отвечал самостоятельно на адресованные ему комментарии. Требуется Claude Code v2.1.228 или новее |
CLAUDE_CODE_ATTRIBUTION_HEADER |
Установите 0, чтобы не включать в начало системного промпта блок атрибуции, содержащий версию клиента и отпечаток промпта. На кэширование при прямом подключении к Anthropic API это в любом случае не влияет. В некоторых конфигурациях с прямым подключением Claude Code сохраняет блок в запросах классификатора авторежима, даже если вы установили 0. В разделе Блок атрибуции системного промпта проверьте, каких подключений и учётных данных это касается. До v2.1.181 блок включал токен для каждого запроса при пользовательских базовых URL и подключениях Microsoft Foundry, поэтому в этих версиях устанавливайте 0, если ваш LLM-шлюз кэширует по телу запроса или пересылает запросы стороннему провайдеру, либо если вы подключаетесь к Microsoft Foundry напрямую |
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS |
Удалена в v2.1.283. Используйте вместо неё CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE |
CLAUDE_CODE_AUTO_COMPACT_WINDOW |
Задаёт окно автосжатия в токенах, от 100000 до 1000000. Принимает только обычное целое число, например 500000: значение вроде 500k читается как 500 и ограничивается минимумом в 100K. Фактическое окно также ограничено контекстным окном модели. Имеет приоритет над командой /autocompact, флагом --autocompact и настройкой autoCompactWindow. Значение used_percentage в строке состояния всегда рассчитывается относительно полного контекстного окна модели, поэтому, когда эта переменная задана, этот процент больше не показывает, когда произойдёт сжатие контекста |
CLAUDE_CODE_AUTO_CONNECT_IDE |
Переопределяет автоматическое подключение к IDE. По умолчанию Claude Code подключается автоматически при запуске во встроенном терминале поддерживаемой IDE. Установите false, чтобы предотвратить это. Установите true, чтобы принудительно попытаться подключиться, когда автоопределение не срабатывает, например когда tmux скрывает родительский терминал. Имеет приоритет над глобальной настройкой конфигурации autoConnectIde |
CLAUDE_CODE_AUTO_MODE_SERVER |
Определяет, просит ли Claude Code сервер проверять действия авторежима. Установите 0, чтобы вместо этого использовать собственные запросы классификатора Claude Code. При прямом подключении к Anthropic API требуется v2.1.281 или новее. В связанном разделе перечислено, какие сессии обращаются к серверу, когда переменная не задана, и начиная с какой версии. Требуется Claude Code v2.1.271 или новее |
CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS |
Время в миллисекундах, в течение которого Claude Code ждёт, пока цепочка поставщиков учётных данных AWS по умолчанию предоставит учётные данные, прежде чем запрос завершится ошибкой AWS default-chain credential resolve timed out (по умолчанию: 60000). Увеличьте его, если какому-либо шагу вашей цепочки действительно нужно больше времени, например при входе через SSO в браузере с MFA через обёртку вроде aws-vault. Применяется в Amazon Bedrock, Claude Platform on AWS и эндпоинте Mantle. См. кэширование учётных данных и таймаут их получения. Требуется Claude Code v2.1.207 или новее |
CLAUDE_CODE_BASH_EDIT_DIFF |
Установите 0, чтобы отключить diff файлов, изменившихся во время выполнения команды Bash, или 1, чтобы записывать его в любом режиме разрешений. Имеет приоритет над настройкой bashEditDiffEnabled. Требуется Claude Code v2.1.269 или новее |
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING |
Установите 0, чтобы неинтерактивная сессия сообщала своему хосту статус простоя в конце каждого хода, даже если фоновая работа ещё выполняется. По умолчанию сессия продолжает сообщать статус выполнения после окончания хода, пока активна фоновая работа, например фоновый агент или запуск рабочего процесса. Благодаря этому хост, отслеживающий статус, например список удалённых сессий, не объявляет посреди работы, что Claude ожидает вашего ввода. Фоновые shell-команды, например dev-сервер, не удерживают статус выполнения. Статус выполнения по умолчанию и отказ от него через 0 требуют Claude Code v2.1.269 или новее; в более ранних версиях установите 1, чтобы удерживать статус выполнения |
CLAUDE_CODE_BRIDGE_SESSION_ID |
Задаётся автоматически в подпроцессах инструмента Bash и команд хуков, пока у сессии есть активное подключение Remote Control, и удаляется по завершении подключения. Значение — ID сессии в формате session_, тот же идентификатор, что отображается в URL сессии claude.ai/code, поэтому скрипт может сослаться на сессию, которая его запустила. Требуется Claude Code v2.1.199 или новее. В облачных сессиях вместо этого читайте CLAUDE_CODE_REMOTE_SESSION_ID |
CLAUDE_CODE_BS_AS_CTRL_BACKSPACE |
Установите 0, чтобы Claude Code читал байт 0x08, также записываемый как ^H, как обычный Backspace, или 1, чтобы читать его как Ctrl+Backspace. Любое из значений заменяет поведение платформы по умолчанию. По умолчанию Claude Code читает его как Ctrl+Backspace в Windows, кроме случаев, когда TERM_PROGRAM равна mintty или TERM равна cygwin, и как обычный Backspace в macOS и Linux. Установите 0 в терминале Windows, где Backspace удаляет целое слово |
CLAUDE_CODE_CERT_STORE |
Список источников сертификатов CA для TLS-подключений через запятую. bundled — набор CA от Mozilla, поставляемый с Claude Code. system — хранилище доверенных сертификатов операционной системы, читается только в средах выполнения с tls.getCACertificates: в нативном бинарном файле или в Node 22.15 и новее для установок через npm. См. Хранилище сертификатов CA. По умолчанию bundled,system |
CLAUDE_CODE_CHILD_SESSION |
Устанавливается в 1 в подпроцессах, которые Claude Code запускает через инструменты Bash, PowerShell и Monitor, команды хуков и команды строки состояния. Не задаётся для подпроцессов stdio MCP-серверов, которые работают долго и переживают сессию, запустившую их. В отличие от CLAUDECODE, её задаёт только сам Claude Code при запуске подпроцесса, а не расширения IDE, поэтому она надёжно отличает вложенную сессию от claude верхнего уровня, запущенного во встроенном терминале IDE. Вложенный интерактивный TUI claude, запущенный таким образом, автоматически исключается из --resume, --continue, истории по стрелке вверх и списка claude agents. Неинтерактивные сессии claude -p по-прежнему сохраняются. Установите CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1, чтобы отменить это исключение. Требуется Claude Code v2.1.172 или новее |
CLAUDE_CODE_CLIENT_CERT |
Путь к файлу клиентского сертификата для аутентификации mTLS |
CLAUDE_CODE_CLIENT_KEY |
Путь к файлу закрытого ключа клиента для аутентификации mTLS |
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE |
Парольная фраза для зашифрованного CLAUDE_CODE_CLIENT_KEY (необязательно) |
CLAUDE_CODE_CONNECT_TIMEOUT_MS |
Удалена в v2.1.186 и теперь ни на что не влияет. Ранее задавала отдельный таймаут для фазы подключения, TLS и заголовков ответа потокового запроса API. Для таймаута отдельного запроса используйте API_TIMEOUT_MS. Для фазы заголовков ответа потокового запроса см. CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS |
CLAUDE_CODE_DEBUG_LOGS_DIR |
Переопределяет путь к файлу отладочного лога. Несмотря на название, это путь к файлу, а не к каталогу. Требует отдельного включения режима отладки через --debug, /debug или переменную окружения DEBUG: сама по себе эта переменная логирование не включает. Флаг --debug-file делает и то, и другое сразу. По умолчанию ~/.claude/debug/<session-id>.txt |
CLAUDE_CODE_DEBUG_LOG_LEVEL |
Минимальный уровень логирования, записываемый в файл отладочного лога. Значения: verbose, debug (по умолчанию), info, warn, error. Установите verbose, чтобы включить объёмную диагностику, например полный вывод команды строки состояния, или повысьте до error, чтобы уменьшить шум |
CLAUDE_CODE_DISABLE_1M_CONTEXT |
Установите 1, чтобы отключить поддержку контекстного окна 1M. Claude Code удаляет варианты моделей [1m] из селектора моделей и ограничивает модели, которые по умолчанию работают с окном 1M, окном 200K. См. Отключение контекста 1M. Полезно в корпоративных средах с требованиями соответствия. О её роли в корректировке окна для нераспознанного ID модели [1m] см. Корректировка окна для ID модели шлюза или пользовательской модели |
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING |
Установите 1, чтобы отключить адаптивные рассуждения в Opus 4.6 и Sonnet 4.6 и использовать фиксированный бюджет мышления, управляемый MAX_THINKING_TOKENS. Не влияет на модели Fable, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее, которые всегда используют адаптивные рассуждения |
CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION |
Установите 1, чтобы Claude Code не объединял блоки env управляемых настроек по ключам из разных административных источников, и применялся только весь блок env источника с наивысшим приоритетом, как до v2.1.223. Задайте её в окружении, из которого запускается Claude Code, поскольку Claude Code игнорирует копию, доставленную через блок env настроек. Требуется Claude Code v2.1.223 или новее |
CLAUDE_CODE_DISABLE_ADVISOR_TOOL |
Установите 1, чтобы отключить инструмент advisor. Команда /advisor становится недоступной, любая настроенная advisorModel игнорируется, а флаг --advisor принимается, но ни на что не влияет, поэтому существующие скрипты, которые его передают, продолжают работать без ошибок |
CLAUDE_CODE_DISABLE_AGENT_VIEW |
Установите 1, чтобы отключить фоновых агентов и agent view: claude agents, --bg, /background и супервизор, запускаемый по требованию. Эквивалентно настройке disableAgentView |
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN |
Установите 1, чтобы отключить полноэкранную отрисовку и использовать классический рендерер основного экрана. Диалог остаётся в нативной истории прокрутки терминала, поэтому Cmd+f и режим копирования tmux работают как обычно. Имеет приоритет над CLAUDE_CODE_NO_FLICKER и настройкой tui. Также можно переключиться командой /tui default. Не применяется к фоновым сессиям, открытым из agent view, которые всегда используют полноэкранную отрисовку |
CLAUDE_CODE_DISABLE_ARTIFACT |
Установите 1, чтобы отключить инструмент Artifact, который публикует результаты сессии как приватную веб-страницу на claude.ai. После её установки никакой файл настроек не может снова включить инструмент. Чтобы вместо этого отключить инструмент из файла настроек, установите enableArtifact в false; устаревший ключ disableArtifact также его отключает |
CLAUDE_CODE_DISABLE_ATTACHMENTS |
Установите 1, чтобы отключить обработку вложений. Упоминания файлов с синтаксисом @ отправляются как обычный текст, а не разворачиваются в содержимое файла. Игнорируется в настройках проекта и локальных настройках |
CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK |
Установите 1, чтобы процесс Claude Code сам выполнял свою команду gcpAuthRefresh или awsAuthRefresh, а не ждал, пока её выполнит другой процесс. Требуется Claude Code v2.1.286 или новее |
CLAUDE_CODE_DISABLE_AUTO_MEMORY |
Установите 1, чтобы отключить автоматическую память. Установите 0, чтобы принудительно включить автоматическую память, даже если режим --bare или autoMemoryEnabled: false иначе отключили бы её. Когда она отключена, Claude не создаёт и не загружает файлы автоматической памяти |
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS |
Установите 1, чтобы отключить всю функциональность фоновых задач, включая параметр run_in_background инструментов Bash и субагентов, автоматический перевод в фон и сочетание клавиш Ctrl+B |
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT |
Установите 1, чтобы Claude Code не считал потоковый ответ Amazon Bedrock с отсутствующим или пустым заголовком Content-Type бинарным потоком событий Amazon Bedrock. По умолчанию Claude Code предполагает, что шлюз удалил заголовок из в остальном неизменённого ответа, поэтому декодирует тело, и потоковая передача продолжает работать. Устанавливайте эту переменную только для шлюза, который также переотправляет поток как server-sent events; тогда Claude Code читает тело без заголовка как server-sent events. Требуется Claude Code v2.1.239 или новее |
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD |
Установите 1, чтобы пропустить проверку того, что потоковый ответ Amazon Bedrock имеет content-type application/vnd.amazon.eventstream. Без этой переменной, если ответ имеет другой content-type, Claude Code завершает запрос ошибкой с указанием этого типа, что означает, что шлюз или прокси преобразует ответ. Вместо установки этой переменной настройте шлюз так, чтобы он пересылал заголовок Content-Type и тело без изменений. Требуется Claude Code v2.1.208 или новее |
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF |
Установите 1, чтобы останавливать выполняющиеся фоновые shell-команды, динамические рабочие процессы и, начиная с v2.1.198, фоновых субагентов фоновой сессии, когда супервизор останавливает, перезапускает или обновляет процесс этой сессии, вместо передачи их следующему процессу сессии. Влияет только на эту передачу: перевод сессии в фон с помощью ← или /background по-прежнему переносит выполняющуюся работу, а CLAUDE_DISABLE_ADOPT отключает и то, и другое. Требуется Claude Code v2.1.196 или новее |
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP |
Установите 1, чтобы Claude Code не завершал фоновые shell-команды при нехватке памяти. По умолчанию в macOS и Linux Claude Code завершает фоновые оболочки, когда операционная система сообщает о критической нехватке памяти, а сессия простаивает 30 минут без выполняющегося хода или субагента. В Windows нет сигнала о нехватке памяти, поэтому там эта переменная ни на что не влияет. Требуется Claude Code v2.1.193 или новее |
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS |
Установите 1, чтобы отключить скиллы и рабочие процессы, входящие в состав Claude Code: встроенные скиллы и рабочие процессы полностью удаляются, а встроенные команды, такие как /init, по-прежнему можно ввести, но они скрыты от модели. /doctor по-прежнему можно ввести, как и встроенные команды; чтобы скрыть её, используйте DISABLE_DOCTOR_COMMAND. Скиллы из плагинов, .claude/skills/ и .claude/commands/ не затрагиваются. Эквивалентно настройке disableBundledSkills |
CLAUDE_CODE_DISABLE_CFC_PROMPT |
Установите 1, чтобы оставить доступными браузерные инструменты Claude in Chrome, но исключить раздел Chrome из системного промпта и встроенный скилл /claude-in-chrome. Для хостов, которые встраивают Claude Code и предоставляют собственные инструкции для браузера. Требуется Claude Code v2.1.257 или новее |
CLAUDE_CODE_DISABLE_CLAUDE_MDS |
Установите 1, чтобы не загружать в контекст никакие файлы памяти CLAUDE.md, включая пользовательские, проектные файлы и файлы автоматической памяти |
CLAUDE_CODE_DISABLE_CRON |
Установите 1, чтобы отключить запланированные задачи. Скилл /loop и инструменты cron становятся недоступными, а все уже запланированные задачи перестают срабатывать, включая задачи, которые уже выполняются посреди сессии |
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT |
Установите 1, чтобы отключить ограничение времени для запросов подтверждения удаления критических путей. Тогда в режиме auto Claude Code отправляет такие удаления классификатору, а в режиме bypassPermissions запрос ждёт вашего ответа. Задайте её в окружении, из которого запускается Claude Code, поскольку Claude Code игнорирует копию, доставленную через блок env настроек. Требуется Claude Code v2.1.281 или новее |
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS |
Установите 1, чтобы удалять из запросов API предварительные заголовки запроса anthropic-beta, связанные с ними поля тела и бета-поля схемы инструментов, такие как defer_loading и eager_input_streaming. Используйте, когда прокси-шлюз отклоняет запросы с ошибкой Unexpected value(s) для заголовка anthropic-beta или с ошибкой Extra inputs are not permitted. В разделе Отключение предварительных возможностей перечислено, что удаляет переменная, включая MCP tool search, и что Claude Code продолжает отправлять |
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS |
Установите 1, чтобы отключить встроенных субагентов Explore и Plan. Вместо них Claude исследует код с помощью своих инструментов поиска или субагента общего назначения, а режим планирования читает файлы напрямую, не запуская агентов Explore и Plan. Пользовательские субагенты с именами Explore или Plan не затрагиваются. Чтобы удалить все встроенные типы субагентов в Agent SDK или неинтерактивном режиме, используйте вместо этого CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS. Требуется Claude Code v2.1.198 или новее |
CLAUDE_CODE_DISABLE_FAST_MODE |
Установите 1, чтобы отключить быстрый режим |
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY |
Установите 1, чтобы отключить опросы о качестве сессии «How is Claude doing?». Опросы также отключаются, если задана DISABLE_TELEMETRY, DO_NOT_TRACK или CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, если только CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL не включает их снова. Чтобы задать частоту выборки вместо полного отключения, используйте настройку feedbackSurveyRate. См. Опросы о качестве сессии |
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING |
Установите 1, чтобы отключить чекпоинты файлов. Команда /rewind не сможет восстанавливать изменения кода. Переопределяет настройку fileCheckpointingEnabled |
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS |
Установите 1, чтобы удалить из контекста Claude встроенные инструкции по рабочему процессу коммитов и PR, а также снимок статуса git. Полезно, если вы используете собственные скиллы для рабочего процесса git. Если задана, имеет приоритет над настройкой includeGitInstructions |
CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT |
Установите 1, чтобы Claude Code не анализировал скрипты, передаваемые оболочке через -c, например bash -c 'rm -rf ~', на предмет удаления критических путей. Claude Code по-прежнему проверяет цели в виде переменных оболочки и позиционных параметров в таких скриптах, а остальные проверки критических путей продолжают работать. Задайте её в окружении, из которого запускается Claude Code, поскольку Claude Code игнорирует копию, доставленную через блок env настроек. Требуется Claude Code v2.1.288 или новее |
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP |
Установите 1, чтобы предотвратить автоматическое переназначение Opus 4.0 и 4.1 на текущую версию Opus в Anthropic API. Используйте, если вы намеренно хотите закрепить более старую модель. Переназначение не выполняется в Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry |
CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK |
Установите 1, чтобы Claude Code в Amazon Bedrock и Google Cloud's Agent Platform не переключался на более старую модель, когда ваш аккаунт теряет доступ к модели сессии посреди сессии; вместо этого отклонённый запрос сразу завершается сбоем. Настроенная вами цепочка резервных моделей по-прежнему переключается при таком отказе, а проверки модели при запуске по-прежнему переключаются на резервный вариант при запуске. Требуется Claude Code v2.1.285 или новее |
CLAUDE_CODE_DISABLE_MOUSE |
Установите 1, чтобы отключить отслеживание мыши в полноэкранной отрисовке. Прокрутка с клавиатуры с помощью PgUp и PgDn по-прежнему работает. Используйте, чтобы сохранить нативное копирование при выделении в терминале |
CLAUDE_CODE_DISABLE_MOUSE_CLICKS |
Установите 1, чтобы отключить обработку щелчков, перетаскивания и наведения в полноэкранной отрисовке, сохранив прокрутку колёсиком мыши. Используйте, если хотите, чтобы прокрутка колёсиком работала в Claude Code, но не хотите, чтобы щелчки перемещали курсор, разворачивали вывод инструментов или открывали ссылки. Если заданы обе переменные, приоритет имеет CLAUDE_CODE_DISABLE_MOUSE. Требуется Claude Code v2.1.195 или новее |
CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION |
Установите 1, чтобы Claude Code не перечитывал клиентский сертификат и ключ mTLS, когда запрос API завершается ошибкой уровня подключения, например сбросом подключения или ошибкой TLS-рукопожатия. При отключённой перезагрузке Claude Code загружает обновлённые файлы только при следующем применении настроек или при следующем запуске. Требуется Claude Code v2.1.232 или новее |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC |
Установите любое непустое значение, например 1, чтобы отключить несущественный сетевой трафик: автообновления, телеметрию, отчёты об ошибках, команду /feedback, отзывы, составленные Claude, заметки о выпуске, проверки значка статуса PR и MR и проверки доступности, такие как проверка быстрого режима. Также останавливает фоновые запуски источников command плагинов, которые являются локальными командами, а не сетевым трафиком, поскольку они могут запускать установку зависимостей. Значение 0 или false по-прежнему отключает этот трафик, в отличие от большинства переменных включения и отключения; чтобы снова разрешить его, удалите переменную. Также отключает получение флагов функций, из-за чего Remote Control и другие функции, которым требуется получение флагов функций, становятся недоступными. Автоматическая установка официального маркетплейса плагинов не затрагивается; отключите её с помощью CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL. Не влияет на обнаружение моделей шлюза, которое включается отдельно |
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK |
Установите 1, чтобы отключить резервный непотоковый вариант, когда потоковый запрос завершается сбоем посреди потока. Вместо этого ошибки потоковой передачи передаются на уровень повторных попыток. Полезно, когда из-за прокси или шлюза резервный вариант приводит к повторному выполнению инструментов |
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK |
Установите 1, чтобы инструмент PushNotification отправлял уведомление на рабочий стол, даже когда вы печатаете в терминале или он находится в фокусе. По умолчанию инструмент пропускает и уведомление на рабочий стол, и мобильное push-уведомление, если обнаруживает недавнюю активность клавиатуры или фокус на терминале. Эта переменная отключает только эту локальную проверку, поэтому сервер всё равно может подавить мобильное push-уведомление, если обнаружит, что вы активны. Требуется Claude Code v2.1.193 или новее |
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL |
Установите 1, чтобы отключить автоматическую регистрацию официального маркетплейса плагинов. Claude Code читает переменную непосредственно перед регистрацией маркетплейса, обычно при первом интерактивном запуске на компьютере. Если в этот момент переменная задана, Claude Code навсегда пропускает регистрацию. Последующее удаление переменной не отменяет пропуск. Выполните claude plugin marketplace add anthropics/claude-plugins-official, чтобы зарегистрировать маркетплейс в любое время |
CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS |
Установите 1, чтобы Claude Code не запускал ваши хуки Notification для запросов разрешения, оставшихся без ответа, в сессиях, где Claude Code отправляет их в обратный вызов canUseTool в Agent SDK, — именно так Claude Desktop и расширение VS Code размещают Claude Code. Не действует в терминальных сессиях. Требуется Claude Code v2.1.233 или новее |
CLAUDE_CODE_DISABLE_POLICY_SKILLS |
Установите 1, чтобы не загружать скиллы из общесистемного каталога управляемых скиллов. Полезно для сессий в контейнерах или CI, которые не должны загружать скиллы, предоставленные оператором |
CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY |
Установите 1, чтобы отключить проверку инструмента PowerShell, которая запрещает встроенные команды cmd rd, rmdir, del и erase для системного пути, например корня диска или вашего домашнего каталога. Claude Code игнорирует эту переменную в блоке env файла настроек. Требуется Claude Code v2.1.283 или новее |
CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK |
Установите 1, чтобы отключить автоматическое переключение модели, когда классификатор безопасности помечает запрос, — поведение, которым управляет настройка switchModelsOnFlag |
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS |
Установите 1, чтобы Claude Code не отправлял поле структурированного вывода output_config.format и связанное с ним значение anthropic-beta, для LLM-шлюза, вышестоящий сервер которого их отклоняет. При этом остаются включёнными другие предварительные возможности, которые отключает CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS. Требуется Claude Code v2.1.288 или новее |
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT |
Установите 1, чтобы отключить проверку критических путей для рекурсивного rm, цель которого целиком является результатом подстановки команды, например rm -rf "$(pwd)". Остальные проверки критических путей продолжают работать. Задайте её в окружении, из которого запускается Claude Code, поскольку Claude Code игнорирует копию, доставленную через блок env настроек. Требуется Claude Code v2.1.281 или новее |
CLAUDE_CODE_DISABLE_TERMINAL_TITLE |
Установите 1, чтобы отключить автоматическое обновление заголовка терминала на основе контекста диалога. Также пропускается фоновый запрос к небольшой быстрой модели, который генерирует название сессии |
CLAUDE_CODE_DISABLE_THINKING |
Установите 1, чтобы полностью исключить параметр thinking из запросов API. Это опция совместимости для прокси и шлюзов, которые отклоняют этот параметр. В моделях, которые размышляют по умолчанию, отсутствие параметра означает, что модель всё равно может размышлять. Чтобы явно отключить расширенное мышление в Anthropic API, используйте вместо этого MAX_THINKING_TOKENS=0. Ни одна из переменных не отключает мышление в Opus 5.5, Sonnet 5.5, Haiku 5.5 или моделях Fable, в которых мышление нельзя отключить. У сторонних провайдеров MAX_THINKING_TOKENS=0 также исключает параметр, поэтому там обе переменные ведут себя одинаково |
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT |
Установите 1, чтобы пропускать упреждающее автосжатие, когда Claude Code не распознаёт ID модели, например псевдоним LLM-шлюза. Без этой переменной Claude Code выполняет сжатие контекста по контекстному окну, которое он предполагает для этого ID. Вместо этого предполагаемое окно можно скорректировать с помощью CLAUDE_CODE_MAX_CONTEXT_TOKENS; о том, когда применяется каждая переменная, см. Корректировка окна для ID модели шлюза или пользовательской модели. Требуется Claude Code v2.1.223 или новее |
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL |
Установите 1, чтобы отключить виртуальную прокрутку в полноэкранной отрисовке и отрисовывать каждое сообщение транскрипта. Используйте, если при прокрутке в полноэкранном режиме на месте сообщений отображаются пустые области |
CLAUDE_CODE_DISABLE_WEB_FETCH |
Установите 1, чтобы отключить инструмент WebFetch. Инструмент WebSearch остаётся доступным. Требуется Claude Code v2.1.285 или новее |
CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER |
Установите 1, чтобы запускать команды инструмента PowerShell в Windows напрямую, а не через загрузчик cmd.exe. По умолчанию загрузчик позволяет команде PowerShell, выполняющейся в фоне, переходить в следующий процесс сессии, например когда вы переводите сессию в фон. Если задать переменную, фоновая команда PowerShell останавливается при завершении процесса сессии. Команды Bash не затрагиваются. Требуется Claude Code v2.1.269 или новее |
CLAUDE_CODE_DISABLE_WORKFLOWS |
Установите 1, чтобы отключить рабочие процессы. Эквивалентно настройке disableWorkflows |
CLAUDE_CODE_EFFORT_LEVEL |
Задаёт уровень effort для поддерживаемых моделей. Значения: low, medium, high, xhigh, max или auto для использования значения модели по умолчанию. Доступные уровни зависят от модели. Имеет приоритет над --effort, /effort и настройками modelSettings и effortLevel. Ограничение maxEffortLevel по-прежнему применяется. См. Настройка уровня effort |
CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS |
Установите 1, чтобы добавлять в поток сообщений сообщения session_state_changed, содержащие состояние сессии. Требуется либо Agent SDK, либо --print, --output-format stream-json и --verbose |
CLAUDE_CODE_ENABLE_AUTO_MODE |
Принимается для совместимости со старыми версиями и ни на что не влияет. Авторежим доступен по умолчанию у всех провайдеров, включая Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сессии Claude apps gateway с выполненным входом. В версиях с v2.1.158 по v2.1.206 установка значения 1 требовалась, чтобы сделать авторежим доступным у этих провайдеров |
CLAUDE_CODE_ENABLE_AWAY_SUMMARY |
Переопределяет доступность сводки сессии. Установите 0, чтобы принудительно отключить сводки независимо от переключателя в /config. Установите 1, чтобы принудительно включить сводки, когда awaySummaryEnabled имеет значение false. Имеет приоритет над настройкой и переключателем в /config |
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH |
Установите 1, чтобы обновлять состояние плагинов на границах ходов в неинтерактивном режиме после завершения фоновой установки. По умолчанию отключено, поскольку обновление изменяет системный промпт посреди сессии, что делает недействительным кэширование промптов для этого хода |
CLAUDE_CODE_ENABLE_CFC |
Установите 1, чтобы запускать сессию CLI с включённой интеграцией с Chrome, или 0, чтобы запускать с отключённой. Имеет приоритет над настройкой claudeInChromeDefaultEnabled. Флаги --chrome и --no-chrome имеют приоритет над обоими. Claude Code игнорирует 1 в настройках проекта и локальных настройках |
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL |
Установите 1, чтобы направлять опрос о качестве сессии "How is Claude doing?" в ваш собственный коллектор OpenTelemetry, когда второстепенный трафик к Anthropic заблокирован. Оценки опроса отправляются только как события OTEL в настроенный вами коллектор. В этом режиме никакие данные опроса не отправляются в Anthropic. Применяется, когда задана CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY или DO_NOT_TRACK, и в остальных случаях ни на что не влияет. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY и политика организации в отношении отзывов о продукте имеют приоритет |
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING |
Управляет тем, передаются ли входные данные вызовов инструментов потоком из API по мере их генерации Claude. Если это отключено, большие входные данные инструмента, например длинная запись в файл, поступают только после того, как Claude закончит их генерировать, из-за чего может казаться, что процесс завис. По умолчанию включено в Anthropic API. В Amazon Bedrock и Google Cloud's Agent Platform включается для каждой модели отдельно, если развёрнутый контейнер это поддерживает. Установите 0, чтобы отказаться. Установите 1, чтобы принудительно включить при маршрутизации через прокси с помощью ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL или ANTHROPIC_BEDROCK_BASE_URL. По умолчанию отключено в Microsoft Foundry и при подключениях через шлюз |
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY |
Установите 1, чтобы заполнять список выбора /model из эндпоинта /v1/models вашего шлюза, когда ANTHROPIC_BASE_URL указывает на Anthropic-совместимый шлюз, такой как LiteLLM, Kong или внутренний прокси. По умолчанию отключено, поскольку иначе шлюзы, использующие общий API-ключ, показывали бы каждому пользователю все модели, к которым у ключа есть доступ. Обнаруженные модели по-прежнему фильтруются списком разрешённых моделей availableModels, который получает сессия; доставляйте этот список через MDM или файл управляемых настроек, поскольку доставка с сервера недоступна в конфигурациях со шлюзом |
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE |
Удалена в v2.1.142, когда быстрый режим по умолчанию перешёл с Opus 4.6 на Opus 4.7 |
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION |
Установите false, чтобы отключить предложения промптов — серые прогнозы, которые появляются в поле ввода промпта. Имеет приоритет над настройкой promptSuggestionEnabled, которую записывает переключатель Prompt suggestions в /config. Claude Code также приостанавливает предложения, когда ваша учётная запись близка к лимиту использования или достигла его. Установите true, чтобы они оставались включёнными до достижения лимита. Требуется Claude Code v2.1.238 или новее. См. Предложения промптов |
CLAUDE_CODE_ENABLE_TASKS |
Определяет, какие инструменты отслеживания задач Claude Code предоставляет в сессиях, где они доступны. По умолчанию Claude Code предоставляет инструменты Task TaskCreate, TaskUpdate, TaskGet и TaskList. Установите 0, чтобы вместо них получить устаревший инструмент TodoWrite. См. Список задач |
CLAUDE_CODE_ENABLE_TELEMETRY |
Установите 1, чтобы включить сбор данных OpenTelemetry для метрик и логирования. Требуется перед настройкой экспортёров OTel. Задайте её в оболочке, пользовательских настройках или управляемых настройках. Игнорируется в настройках проекта и локальных настройках. См. Мониторинг |
CLAUDE_CODE_ENABLE_TODO_TOOLS |
Установите 1, чтобы получить инструменты отслеживания задач на любой модели. Без неё Claude Code по умолчанию предоставляет их только на моделях, перечисленных в разделе Доступность инструмента Task. CLAUDE_CODE_ENABLE_TASKS по-прежнему выбирает между инструментами Task и TodoWrite. Требуется Claude Code v2.1.233 или новее |
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY |
Время ожидания в миллисекундах после перехода цикла запросов в состояние простоя перед автоматическим завершением. Полезно для автоматизированных рабочих процессов и скриптов, использующих режим SDK |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS |
Установите 1, чтобы включить команды агентов. Команды агентов являются экспериментальными и по умолчанию отключены |
CLAUDE_CODE_EXTRA_BODY |
JSON-объект, объединяемый с верхним уровнем тела каждого запроса к API. Полезно для передачи специфичных для провайдера параметров, которые Claude Code не предоставляет напрямую. Значение, экспортированное в вашей оболочке, также применяется к фоновым сессиям, которые вы запускаете с помощью claude agents или --bg. До v2.1.206 фоновые сессии игнорировали значение, экспортированное в оболочке, и использовали ту копию, которую унаследовал фоновый процесс-супервизор |
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS |
Переопределяет лимит токенов по умолчанию для чтения файлов. Полезно, когда нужно прочитать файлы большего размера целиком |
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE |
Установите 1, чтобы принудительно включить сохранение транскриптов, истории промптов и регистрацию в claude agents, даже если этот claude был запущен изнутри другой сессии Claude Code. Используйте, когда унаследованное значение CLAUDE_CODE_CHILD_SESSION, например из сессии screen или фонового загрузчика, впервые запущенного инструментом Bash в Claude Code, приводит к тому, что настоящая сессия верхнего уровня ошибочно классифицируется как вложенная. Начиная с v2.1.178 Claude Code автоматически распознаёт случай с tmux и игнорирует унаследованный маркер, поэтому для tmux эта переменная больше не нужна. Также учитывается в v2.1.169 и более ранних версиях; не действует в v2.1.170 и v2.1.171, где было удалено обнаружение вложенных сессий, которое она переопределяет |
CLAUDE_CODE_FORCE_STRIKETHROUGH |
Установите 1, чтобы принудительно отображать ~~text~~ в ответах Claude зачёркнутым, когда ваш терминал это поддерживает, но не определяется автоматически, например при работе по SSH без пересылки TERM_PROGRAM. Без этого неопределённые терминалы показывают буквальные маркеры ~~ вместо зачёркнутого текста. Требуется Claude Code v2.1.186 или новее |
CLAUDE_CODE_FORCE_SYNC_OUTPUT |
Установите 1, чтобы принудительно включить синхронизированный вывод DEC private mode 2026, когда ваш терминал его поддерживает, но не определяется автоматически. Полезно для эмуляторов, таких как Emacs eat, которые реализуют BSU/ESU, но не отвечают на проверку возможностей. Не действует под tmux. В отличие от CLAUDE_CODE_NO_FLICKER, которая переключает на полноэкранный рендеринг, эта переменная не меняет рендерер |
CLAUDE_CODE_FORCE_TERMINAL_IMAGES |
Установите 1, чтобы отображать элементы Image модов как изображения, когда ваш терминал отображает изображения протокола kitty graphics с заполнителями Unicode, но не определяется автоматически. См. какие терминалы определяет Claude Code и почему это не помогает внутри tmux или screen |
CLAUDE_CODE_FORK_SUBAGENT |
Управляет режимом ответвления, который позволяет Claude самостоятельно запускать ответвлённых субагентов и по умолчанию включён только в интерактивных сессиях. Установите 1, чтобы включить его также в claude -p и Agent SDK, или 0, чтобы отключить во всех видах сессий. Вы можете запускать /subtask независимо от того, включён ли режим ответвления. Значение по умолчанию для интерактивных сессий требует Claude Code v2.1.232 или новее; в более ранних версиях установите переменную в 1, чтобы включить режим ответвления |
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT |
Установите 1, чтобы выводить текст и блоки размышлений субагентов в выводе claude -p --output-format stream-json — то же поведение, что и у флага --forward-subagent-text. Используйте переменную, когда claude вызывается обвязкой, которая не может сама передать флаг. В отличие от флага, который завершается с ошибкой вне неинтерактивного режима с выводом stream-json, переменная в таких случаях игнорируется, чтобы вложенные вызовы продолжали работать, когда она задана для всего процесса. Требуется Claude Code v2.1.211 или новее |
CLAUDE_CODE_GATEWAY_HINT_HEADERS |
Установите 1, чтобы отправлять заголовки-подсказки для шлюза, такие как x-claude-code-request-class и x-claude-code-compaction, через пользовательский прокси или стороннего провайдера, такого как Amazon Bedrock или Claude Platform on AWS. Установите 0, чтобы прекратить их отправку при любом подключении, включая прямое подключение к Anthropic API, где Claude Code отправляет их по умолчанию. Требуется Claude Code v2.1.273 или новее |
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS |
Таймаут в миллисекундах для запроса обнаружения моделей шлюза, который включает CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY (по умолчанию: 3000). Увеличьте его, если вашему шлюзу требуется больше трёх секунд, чтобы ответить на /v1/models при запуске. Принимаются только цифры; 0, отрицательные значения и другие варианты записи оставляют значение по умолчанию. Требуется Claude Code v2.1.269 или новее |
CLAUDE_CODE_GIT_BASH_PATH |
Только для Windows: путь к исполняемому файлу Git Bash (bash.exe). Используйте, когда Git Bash установлен, но отсутствует в PATH. Если путь не существует или файл называется не bash.exe, sh.exe, bash или sh, Claude Code игнорирует переменную и автоматически определяет Git Bash так, как если бы она не была задана, записывая в лог предупреждение, видимое с --debug. До v2.1.219 Claude Code завершался при запуске, если путь не существовал, и использовал любой существующий файл в качестве оболочки, не проверяя, что это bash или sh. См. Настройка в Windows |
CLAUDE_CODE_GLOB_HIDDEN |
Установите false, чтобы исключать dot-файлы из результатов, когда Claude вызывает инструмент Glob. По умолчанию они включаются. Не влияет на автодополнение файлов через @, ls, Grep или Read |
CLAUDE_CODE_GLOB_NO_IGNORE |
Установите false, чтобы инструмент Glob учитывал шаблоны .gitignore. По умолчанию Glob возвращает все подходящие файлы, включая игнорируемые git. Не влияет на автодополнение файлов через @, у которого есть собственная настройка respectGitignore |
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS |
Таймаут в секундах для обнаружения файлов инструментом Glob. По умолчанию 20 секунд на большинстве платформ и 60 секунд в WSL |
CLAUDE_CODE_GOAL_CHECKIN_MINUTES |
Сколько минут фоновая работа может удерживать активную цель в ожидании, прежде чем Claude Code попросит Claude проверить её. По умолчанию 30. Установите 0, чтобы отключить проверки. Укажите целое число минут цифрами, не более 10080, то есть одной недели. Любое другое значение Claude Code считает незаданным и использует значение по умолчанию. Требуется Claude Code v2.1.234 или новее |
CLAUDE_CODE_GZIP_REQUEST_BODIES |
Установите 0, чтобы отключить gzip-сжатие тел запросов Claude API, телеметрии и публикации артефактов, отправляемых на api.anthropic.com. По умолчанию Claude Code сжимает большие тела запросов при прямых подключениях и пропускает сжатие, когда вы отправляете запросы через прокси, настраиваете клиентский сертификат или задаёте NODE_EXTRA_CA_CERTS. Используйте 0, если прокси с инспекцией TLS, который Claude Code не может обнаружить, неправильно обрабатывает сжатые запросы |
CLAUDE_CODE_HIDE_CWD |
Установите 1, чтобы скрыть рабочий каталог в логотипе при запуске. Полезно при демонстрации экрана или записях, где путь раскрывает ваше имя пользователя ОС |
CLAUDE_CODE_IDE_HOST_OVERRIDE |
Переопределяет адрес хоста, используемый для подключения к расширению IDE. По умолчанию Claude Code автоматически определяет правильный адрес, включая маршрутизацию из WSL в Windows |
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL |
Установите 1, чтобы пропустить автоматическую установку расширений IDE. Эквивалентно присвоению autoInstallIdeExtension значения false |
CLAUDE_CODE_IDE_SKIP_VALID_CHECK |
Установите 1, чтобы пропустить проверку записей lock-файла IDE при подключении. Используйте, когда автоподключение не находит вашу IDE, хотя она запущена |
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS |
Сколько субагентов может выполняться в одной сессии, прежде чем инструмент Agent откажется запускать ещё одного (по умолчанию: 20). Принимает положительное целое число, записанное цифрами; всё остальное игнорируется, поэтому переменная может изменить ограничение, но не отключить его. Требуется Claude Code v2.1.217 или новее |
CLAUDE_CODE_MAX_CONTEXT_TOKENS |
Переопределяет размер контекстного окна, который Claude Code предполагает для активной модели. Начиная с v2.1.193 то, как оно применяется, зависит от того, как Claude Code определяет ID модели; см. Исправление окна для шлюза или пользовательского ID модели. Используйте это при маршрутизации через ANTHROPIC_BASE_URL к модели, контекстное окно которой не совпадает со встроенным размером для её имени |
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH |
Максимальная длина в символах каждого описания инструмента MCP и инструкций каждого MCP-сервера, которые Claude Code отправляет модели (по умолчанию: 2048). Claude Code обрезает более длинный текст. Принимает положительное целое число, записанное цифрами. Всё остальное игнорируется, и применяется значение по умолчанию. Требуется Claude Code v2.1.280 или новее |
CLAUDE_CODE_MAX_OUTPUT_TOKENS |
Задаёт максимальное количество выходных токенов для большинства запросов. Значения по умолчанию и верхние пределы зависят от модели; см. максимальное количество выходных токенов. Claude Code снижает значение, превышающее предел модели, до этого предела. Для ID модели, который Claude Code не может сопоставить с известной ему моделью, значение по умолчанию — 32000, а предел — 128000. Увеличение этого значения уменьшает эффективное контекстное окно, доступное до срабатывания автосжатия |
CLAUDE_CODE_MAX_RETRIES |
Переопределяет количество повторных попыток для неудачных запросов к API (по умолчанию: 10). Начиная с v2.1.186 ограничено значением 15; начиная с v2.1.199 CLAUDE_CODE_RETRY_WATCHDOG повышает значение по умолчанию и снимает ограничение. Для автономных сессий, которым нужно пережидать более длительные сбои, вместо этого задайте CLAUDE_CODE_RETRY_WATCHDOG |
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION |
Удалена в v2.1.224 и теперь ни на что не влияет. Ранее ограничивала общее количество субагентов, которых Claude мог запустить с помощью инструмента Agent за одну сессию (по умолчанию: 200); запуск сверх ограничения завершался ошибкой Subagent spawn limit reached. Ограничение на количество одновременных субагентов и ограничение глубины по-прежнему действуют |
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH |
Количество уровней субагентов, разрешённых ниже основного диалога (по умолчанию: 3). При значении по умолчанию субагенты могут запускать собственных субагентов, а субагент на третьем уровне уже не может запускать дальше; установите 1, чтобы отключить вложенность. В версиях с v2.1.217 по v2.1.218 значение по умолчанию было 1, поэтому субагент не мог запускать собственных, если вы не повышали ограничение; в v2.1.219 значение по умолчанию повышено до 3. Принимает положительное целое число, записанное цифрами; всё остальное игнорируется, поэтому ограничение можно изменить, но не снять. Требуется Claude Code v2.1.217 или новее |
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY |
Максимальное количество инструментов только для чтения и субагентов, которые могут выполняться параллельно (по умолчанию: 10). Более высокие значения увеличивают параллелизм, но потребляют больше ресурсов |
CLAUDE_CODE_MAX_TURNS |
Ограничивает количество агентных ходов, когда явное ограничение не передано. Эквивалентно передаче --max-turns, который имеет приоритет, если заданы оба. Значение, не являющееся положительным целым числом, отклоняется при запуске с ошибкой, а не трактуется как отсутствие ограничения |
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION |
Ограничение на количество вызовов WebSearch (по умолчанию: 200). Когда Claude достигает ограничения, последующие вызовы WebSearch возвращают уведомление, предлагающее продолжить с уже собранной информацией. Принимает положительное целое число без верхней границы. Всё остальное игнорируется, и применяется значение по умолчанию, поэтому ограничение можно повысить, но не отключить. Требуется Claude Code v2.1.212 или новее |
CLAUDE_CODE_MCP_ALLOWLIST_ENV |
Установите 1, чтобы запускать stdio MCP-серверы только с безопасным базовым окружением и настроенным для сервера env, вместо наследования окружения вашей оболочки |
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS |
Время в миллисекундах, по истечении которого всё ещё выполняющийся вызов инструмента MCP переводится в фоновую задачу (по умолчанию: 120000, или 2 минуты). Установите 0, чтобы отключить автоматический перевод в фон. Требуется Claude Code v2.1.212 или новее |
CLAUDE_CODE_MCP_STARTUP_WAIT_MS |
Сколько миллисекунд первый ход неинтерактивной сессии ожидает MCP-серверы, которые ещё подключаются, вместо ожидания на первом ходе по умолчанию. Если переменная задана, ожидание охватывает все ожидающие серверы; в самостоятельно размещённом окружении она меняет только продолжительность ожидания. Установите 0, чтобы пропустить ожидание. Сервер --permission-prompt-tool сохраняет собственное ожидание MCP_TIMEOUT независимо от значения. Требуется Claude Code v2.1.274 или новее |
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT |
Таймаут простоя в миллисекундах для вызовов инструментов MCP. Когда MCP-сервер stdio, HTTP, SSE, WebSocket или коннектор claude.ai в течение этого времени не отправляет ни ответа, ни уведомления о прогрессе, вызов инструмента прерывается с ошибкой вместо ожидания общего MCP_TOOL_TIMEOUT. Переопределяет значения по умолчанию для каждого транспорта: 300000 (5 минут) для сетевых серверов и 1800000 (30 минут) для серверов stdio. Установите 0, чтобы отключить проверку простоя. Значения меньше 1000 повышаются до одной секунды, а значение ограничивается действующим MCP_TOOL_TIMEOUT. Заданный для сервера timeout в .mcp.json не менее 1000 повышает окно простоя этого сервера как минимум до значения timeout. Не применяется к серверам IDE и внутрипроцессным серверам SDK. Требуется Claude Code v2.1.187 или новее. До v2.1.203 на серверы stdio таймаут простоя не распространялся |
CLAUDE_CODE_MESSAGING_SOCKET |
Задаётся Claude Code, а не вами: в сессиях, которые привязывают сокет входящих сообщений, Claude Code экспортирует путь этого сокета в хуки и команды Bash при привязке сокета. В сессии, которая запускается с включённым обменом сообщениями, Claude Code привязывает сокет до запуска любого хука. Другие сессии на компьютере доставляют сообщения по этому пути. Каждая сессия экспортирует собственный сокет, а не унаследованный от родительской, и поступающие на него сообщения проходят через средства контроля входящих сообщений сессии. Блоки env в настройках не могут её задать. Требуется Claude Code v2.1.224 или новее |
CLAUDE_CODE_MESSAGING_TOKEN |
Задаётся Claude Code, а не вами: в сессиях, которые привязывают сокет входящих сообщений, Claude Code экспортирует этот токен сессии в хуки и команды Bash вместе с CLAUDE_CODE_MESSAGING_SOCKET. Скрипт, отправляющий данные в сокет, может передать {"type":"auth","token":"<token>"} первой строкой, чтобы подтвердить, что он принадлежит сессии. В нативной Windows Claude Code требует эту строку и закрывает любое соединение, которое не начинается с действительной строки. Правила для собственных дочерних процессов определяют, когда Claude Code проверяет токен. Каждая сессия экспортирует собственный токен, никогда не унаследованный от родительской сессии. Блоки env в настройках не могут его задать. Требуется Claude Code v2.1.228 или новее |
CLAUDE_CODE_NATIVE_CURSOR |
Установите 1, чтобы показывать собственный курсор терминала в позиции ввода вместо нарисованного блока. Курсор учитывает настройки мигания, формы и фокуса терминала. Значение 0 воспринимается так же, как незаданная переменная, поэтому оно не возвращает нарисованный блок в сессии, где собственный курсор терминала уже включён |
CLAUDE_CODE_NEW_INIT |
Установите 1, чтобы /init запускал интерактивный процесс настройки. Он спрашивает, какие файлы создать, включая CLAUDE.md, скиллы и хуки, прежде чем исследовать кодовую базу и записать их. Без этой переменной /init создаёт CLAUDE.md автоматически, ни о чём не спрашивая |
CLAUDE_CODE_NONBLOCKING_STDOUT |
Установите 1, чтобы записывать вывод в терминал через второй неблокирующий файловый дескриптор, чтобы терминал, который перестал читать, например приостановленная панель tmux в режиме control mode или зависшее SSH-соединение, не мог заморозить Claude Code посреди сессии. Применяется в macOS, Linux и WSL, когда stdout является терминалом. Требуется Claude Code v2.1.261 или новее |
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES |
Ограничивает, сколько раз Claude Code повторно отправляет непотоковый запрос, превысивший таймаут. При 0 запрос завершается ошибкой при первом же таймауте. Сведения о таймауте см. в разделе Настройка поведения повторных попыток. Требуется Claude Code v2.1.285 или новее |
CLAUDE_CODE_NO_FLICKER |
Установите 1, чтобы включить полноэкранный рендеринг — research preview, который уменьшает мерцание и сохраняет стабильное потребление памяти в длинных диалогах. Переопределяет настройку tui; переключиться также можно с помощью /tui fullscreen |
CLAUDE_CODE_OAUTH_REFRESH_TOKEN |
Токен обновления OAuth для аутентификации Claude.ai. Если задан, claude auth login обменивает этот токен напрямую вместо открытия браузера. Требует CLAUDE_CODE_OAUTH_SCOPES. Полезно для подготовки аутентификации в автоматизированных средах |
CLAUDE_CODE_OAUTH_SCOPES |
Разделённые пробелами scope OAuth, с которыми был выдан токен обновления, например "user:profile user:inference user:sessions:claude_code". Обязательна, если задана CLAUDE_CODE_OAUTH_REFRESH_TOKEN |
CLAUDE_CODE_OAUTH_TOKEN |
Токен доступа OAuth для аутентификации claude.ai. Альтернатива /login для SDK и автоматизированных сред. Имеет приоритет над учётными данными, хранящимися в связке ключей. Создайте его с помощью claude setup-token. Если вы не выполните /login, Claude Code использует заданный вами токен на протяжении всей сессии. Чтобы заменить истёкший токен, создайте новый и перезапустите Claude Code |
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE |
Удалена в v2.1.160 и теперь ни на что не влияет. Ранее закрепляла быстрый режим за Claude Opus 4.6 вместо текущей модели по умолчанию. Opus 4.6 больше не поддерживает быстрый режим |
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH |
Максимальная длина атрибутов OpenTelemetry, содержащих контент (ответы модели, содержимое инструментов, системные промпты, необработанные тела API), включая маркер обрезки, в кодовых единицах UTF-16 (по умолчанию: 61440, т. е. 60 КБ). Увеличивайте её, только если ваш бэкенд телеметрии принимает значения атрибутов больше 64 КБ, или уменьшайте, чтобы сократить объём телеметрии. Требуется Claude Code v2.1.214 или новее. См. Мониторинг |
CLAUDE_CODE_OTEL_DIAG_STDERR |
Установите 1, чтобы записывать диагностические ошибки экспортёра OpenTelemetry в stderr. По умолчанию эти ошибки появляются только с --debug, поэтому неправильно настроенный экспортёр, например при конфликте портов Prometheus, иначе даёт сбой незаметно. Требуется Claude Code v2.1.179 или новее. См. Мониторинг |
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS |
Таймаут в миллисекундах для сброса ожидающих спанов OpenTelemetry (по умолчанию: 5000). См. Мониторинг |
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS |
Интервал обновления динамических заголовков OpenTelemetry в миллисекундах (по умолчанию: 1740000 / 29 минут). См. Динамические заголовки |
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS |
Таймаут в миллисекундах для завершения работы экспортёра OpenTelemetry при выключении (по умолчанию: 2000). Увеличьте, если метрики теряются при выходе. См. Мониторинг |
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS |
Начальная задержка в миллисекундах (вместо 500 по умолчанию) экспоненциальной задержки между автоматическими повторными попытками запроса, который API отклоняет с ошибкой перегрузки 529. Увеличьте её, чтобы распределить повторные попытки на более длительный период, когда API работает на пределе мощности. Укажите целое число миллисекунд от 500 до 32000 цифрами; любое другое значение Claude Code считает незаданным. Не действует, если CLAUDE_CODE_RETRY_WATCHDOG установлена в 1 или если отклонённый запрос был отправлен в быстром режиме. Требуется Claude Code v2.1.292 или новее |
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE |
Установите 1, чтобы Claude Code запускал команду обновления вашего менеджера пакетов в фоне, когда доступна новая версия. Применяется к установкам через Homebrew и WinGet. Другие менеджеры пакетов по-прежнему показывают команду обновления, не запуская её. См. Автоматические обновления |
CLAUDE_CODE_PERFORCE_MODE |
Установите 1, чтобы включить защиту от записи с учётом Perforce. Если задано, Edit, Write и NotebookEdit завершаются с ошибкой и подсказкой p4 edit <file>, если у целевого файла отсутствует бит записи для владельца, который Perforce снимает у синхронизированных файлов, пока p4 edit не откроет их. Это не позволяет Claude Code обходить отслеживание изменений Perforce |
CLAUDE_CODE_PLUGIN_CACHE_DIR |
Переопределяет корневой каталог плагинов. Несмотря на название, задаёт родительский каталог, а не сам кэш: маркетплейсы и кэш плагинов находятся в подкаталогах по этому пути. По умолчанию ~/.claude/plugins |
CLAUDE_CODE_PLUGIN_DIRS |
Каталоги плагинов для загрузки в сессии; каждый загружается так же, как его загружает флаг --plugin-dir. Разделяйте несколько путей символом : в Unix или ; в Windows. Указывайте каждый путь как абсолютный или начинайте его с ~, поскольку Claude Code пропускает относительные пути. Требуется Claude Code v2.1.280 или новее. См. Загрузка плагина для одной сессии |
CLAUDE_CODE_PLUGIN_DIR_WATCH |
Управляет тем, перезагружает ли Claude Code мод при изменении его файлов. Перезагрузка применяется к моду, который вы загружаете из каталога с помощью --plugin-dir, и по умолчанию включена в интерактивных сессиях. Установите 1, чтобы включить её также в неинтерактивных сессиях, или 0, чтобы отключить во всех сессиях. Требуется Claude Code v2.1.287 или новее. См. настройки и переменные окружения модов |
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS |
Таймаут в миллисекундах для клонирования или обновления маркетплейса плагинов (по умолчанию: 120000). Увеличьте это значение для больших репозиториев или медленных сетевых подключений. См. Git clone timed out |
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE |
Установите 1, чтобы пропустить попытку повторного клонирования и продолжить использовать существующую копию маркетплейса, когда при его обновлении не удаётся связаться с удалённым репозиторием или пройти аутентификацию. Полезно в офлайн- или изолированных средах, где повторное клонирование завершилось бы тем же сбоем. См. Обновления маркетплейса не выполняются в офлайн-средах |
CLAUDE_CODE_PLUGIN_PREFER_HTTPS |
Установите 1, чтобы клонировать источники в сокращённой форме GitHub owner/repo по HTTPS вместо SSH. Применяется к установке и обновлению плагинов, а также к /plugin marketplace add и update. Полезно в CI-раннерах, контейнерах и любых средах без настроенного SSH-ключа для github.com |
CLAUDE_CODE_PLUGIN_SEED_DIR |
Путь к одному или нескольким каталогам начальных плагинов только для чтения, разделённым : в Unix или ; в Windows. Используйте, чтобы включить заранее заполненный каталог плагинов в образ контейнера. Claude Code регистрирует маркетплейсы из этих каталогов при запуске и использует предварительно кэшированные плагины без повторного клонирования. См. Предварительное заполнение плагинов для контейнеров |
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY |
Установите 1, чтобы Claude Code не передавал -ExecutionPolicy Bypass при запуске PowerShell для вызовов инструментов, хуков и команд строки состояния, а вместо этого учитывал действующую политику выполнения компьютера. По умолчанию Claude Code обходит политику выполнения на уровне процесса, чтобы скрипты .ps1 и импорт модулей работали в установках Windows с политикой Restricted по умолчанию. Обход на уровне процесса никогда не переопределяет групповую политику MachinePolicy или UserPolicy, независимо от этой настройки |
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS |
Верхний предел в миллисекундах для ожидания в простое фоновой работы, например субагентов и рабочих процессов, после последнего хода в неинтерактивном режиме с флагом -p. Ожидание в простое начинается заново каждый раз, когда Claude выполняет ход для обработки фонового результата. По умолчанию: 600000, или 10 минут. Когда ожидание в простое достигает предела, Claude Code перестаёт ждать оставшиеся фоновые задачи. Выполняющаяся фоновая команда, запущенная основным диалогом, удерживает выполнение и после этого предела. Установите 0, чтобы ждать бесконечно. Требуется Claude Code v2.1.182 или новее |
CLAUDE_CODE_PROCESS_WRAPPER |
Запускает процессы, которые Claude Code запускает из собственного бинарного файла, например фоновую службу, в которой работают сессии agent view, через корпоративный загрузчик, заданный как префикс argv, например /opt/corp/launcher. Задайте её в блоке env пользовательских или управляемых настроек, а не как экспорт в оболочке, чтобы её унаследовала отсоединённая фоновая служба; настройки проекта и локальные настройки не могут её задать. Эквивалентна настройке processWrapper, для которой требуется Claude Code v2.1.210 или новее; эта переменная имеет приоритет, если заданы обе. Расширение VS Code настраивает собственный загрузчик отдельно через свою настройку claudeProcessWrapper. Игнорируется в Windows. См. Запуск Claude Code через корпоративный загрузчик, где описаны формат значения, то, что охватывает загрузчик, и требования, которым он должен соответствовать. Требуется Claude Code v2.1.208 или новее |
CLAUDE_CODE_PROJECT_DIR_NAME |
Задайте вместе с CLAUDE_CONFIG_DIR, чтобы выбрать имя каталога в projects/, в котором Claude Code хранит транскрипты и автоматическую память этой сессии, вместо имени, производного от пути рабочего каталога. Например, при запуске Claude Code с CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude они хранятся в /srv/tenant-a/projects/work/. Claude Code игнорирует эту переменную, если CLAUDE_CONFIG_DIR не задана, и считывает её только из окружения, в котором вы запускаете claude, но никогда из блока env файла настроек. См. Самостоятельное именование каталога проекта. Требуется Claude Code v2.1.234 или новее |
CLAUDE_CODE_PROMPT_CACHE_TTL |
Установите 5m или 1h — единственные значения, которые принимает Claude Code, — чтобы выбрать TTL кэша промптов для основного диалога: ваших интерактивных ходов, ходов -p и SDK, а также вспомогательных процессов, выполняющихся вместе с ними. Имеет приоритет над настройкой promptCacheTtl и над ENABLE_PROMPT_CACHING_1H, а FORCE_PROMPT_CACHING_5M переопределяет её. API тарифицирует запись в кэш на 1 час по более высокой ставке. Требуется Claude Code v2.1.242 или новее |
CLAUDE_CODE_PROPAGATE_TRACEPARENT |
Установите 1, чтобы передавать контекст трассировки W3C, когда ANTHROPIC_BASE_URL указывает на пользовательский прокси. Передача охватывает заголовок traceparent в запросах к модели и HTTP MCP, а также переменную окружения TRACEPARENT для подпроцессов Bash, PowerShell и хуков. По умолчанию передача включена только при прямом подключении к Anthropic API. Добавлено в v2.1.152. См. Трассировки (бета) |
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST |
Задаётся хост-платформами, которые встраивают Claude Code и управляют маршрутизацией к провайдеру моделей от его имени. Если задана, Claude Code игнорирует переменные выбора провайдера, эндпоинта и аутентификации, такие как CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY, в файлах настроек, поэтому пользовательские настройки не могут переопределить маршрутизацию хоста. Claude Code также игнорирует ключи выбора модели, такие как model, fallbackModel и modelOverrides, в управляемых настройках, независимо от того, какой управляемый источник их доставляет, поэтому конфигурация моделей хоста имеет приоритет над устаревшим закреплением модели в управляемых настройках. Claude Code также игнорирует переменные выбора модели, такие как ANTHROPIC_MODEL и семейство ANTHROPIC_DEFAULT_*_MODEL, в управляемом блоке env; список разрешённых моделей availableModels в управляемых настройках по-прежнему применяется, если хост не предоставляет собственный. Claude Code также пропускает автоматический отказ от телеметрии, который иначе применяется у сторонних провайдеров, таких как Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform и Microsoft Foundry, поэтому телеметрия подчиняется стандартному отказу через DISABLE_TELEMETRY. См. Поведение по умолчанию в зависимости от провайдера API |
CLAUDE_CODE_PROXY_RESOLVES_HOSTS |
Установите 1, чтобы разрешить прокси выполнять DNS-разрешение вместо вызывающей стороны. Включается по желанию для сред, где разрешение имён хостов должен выполнять прокси |
CLAUDE_CODE_REMOTE |
Автоматически устанавливается в true, когда Claude Code работает как облачная сессия. Считывайте её из хука или скрипта настройки, чтобы определить, находитесь ли вы в облачной сессии |
CLAUDE_CODE_REMOTE_SESSION_ID |
В облачных сессиях автоматически устанавливается в ID текущей сессии. Считывайте её, чтобы сформировать ссылку на транскрипт сессии. См. Ссылка из вывода на сессию |
CLAUDE_CODE_RESTRICTED |
Установите 1, чтобы запустить сессию в ограниченном режиме, — то же, что передать --restricted. Claude Code игнорирует эту переменную в блоке env файла настроек. Требуется Claude Code v2.1.248 или новее |
CLAUDE_CODE_RESUME_INTERRUPTED_TURN |
Установите 1, чтобы автоматически возобновлять работу, если предыдущая сессия завершилась посреди хода. Используется в режиме SDK, чтобы модель продолжала работу без повторной отправки промпта из SDK. Чтобы отключить это, удалите переменную или установите 0. Для панели чата VS Code см. Продолжение диалогов после перезагрузки |
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS |
Максимальный возраст в миллисекундах последнего сообщения транскрипта, при котором сессия, завершившаяся посреди хода, автоматически продолжается при возобновлении. Если последнее сообщение старше этого предела, Claude Code пропускает автоматическое возобновление CLAUDE_CODE_RESUME_INTERRUPTED_TURN и его сообщение продолжения CLAUDE_CODE_RESUME_PROMPT, и сессия запускается в режиме ожидания, чтобы вы продолжили явно. Незаданное значение или 0 означает отсутствие предела, за исключением того, что ход, последний запрос которого завершился ошибкой API, возобновляется, только пока этой ошибке меньше шести часов. Положительное значение ограничивает каждый ход, включая такие; отрицательное или нечисловое значение задаёт предел в один час. Скрипты запуска для долго работающих агентов могут задавать эту переменную, чтобы перезапуск со старым транскриптом не выполнял повторно устаревший промпт. Claude Code сам устанавливает предел в один час, когда перезапускает аварийно завершившуюся сессию agent view, унаследовавшую диалог от интерактивной сессии. Требуется Claude Code v2.1.211 или новее |
CLAUDE_CODE_RESUME_PROMPT |
Переопределяет сообщение продолжения, которое Claude Code отправляет Claude, когда CLAUDE_CODE_RESUME_INTERRUPTED_TURN продолжает прерванный ход вместо повторной отправки его промпта, или когда вы возобновляете отложенный вызов инструмента с -p. По умолчанию Continue from where you left off.. При пустой строке используется значение по умолчанию |
CLAUDE_CODE_RETRY_WATCHDOG |
Установите 1 для автономных сессий, таких как обвязки для оценки, задания CI или удалённые обработчики. Бесконечно повторяет попытки при ошибках нехватки мощности 429 и 529 вместо сбоя после CLAUDE_CODE_MAX_RETRIES попыток. Claude Code сразу завершается с ошибкой, когда запрос со стандартной скоростью получает 429, сообщающий о лимите расходов или исчерпании кредитов использования, даже если это ограничение расходов шлюза, которое сбрасывается по расписанию. До v2.1.239 watchdog бесконечно повторял такие запросы. Для запросов в быстром режиме см. Обработка ограничений частоты запросов. Watchdog увеличивает паузу между попытками до 5 минут или до сброса лимита, если ответ содержит время сброса ограничения частоты запросов, поэтому сессия, достигшая лимита использования, пережидает оставшееся окно. В v2.1.199 и новее он также повышает количество повторных попыток по умолчанию для других временных ошибок, таких как ошибки сервера, таймауты и разрывы соединения, до 300, что соответствует примерно трём часам ожидания, и снимает ограничение в 15 для CLAUDE_CODE_MAX_RETRIES, если вы задали эту переменную явно. Требуется Claude Code v2.1.186 или новее |
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS |
Максимальное время в миллисекундах, которое каждый запрос к API тратит на пережидание ошибок 429 и 529, когда задана CLAUDE_CODE_RETRY_WATCHDOG. По истечении этого времени следующая такая ошибка завершает запрос. Укажите положительное целое число цифрами, например 1800000 для 30 минут. Если переменная не задана, ожидание не ограничено. Требуется Claude Code v2.1.295 или новее |
CLAUDE_CODE_SAFE_MODE |
Установите 1, чтобы запуститься в безопасном режиме: CLAUDE.md, скиллы, плагины, хуки, MCP-серверы, пользовательские команды и агенты, стили вывода, рабочие процессы, пользовательские темы, пользовательские сочетания клавиш, команды строки состояния и подсказок файлов, LSP-серверы и автоматическая память не загружаются — для устранения неполадок в сломанной конфигурации. Политика управляемых настроек по-прежнему применяется, включая хуки, строку состояния и команды подсказок файлов, настроенные политикой; управляемые плагины, управляемые скиллы, управляемый CLAUDE.md и MCP-серверы, настроенные политикой, — нет. Эквивалентно передаче --safe-mode. Непосредственно запущенные дочерние процессы наследуют эту переменную |
CLAUDE_CODE_SCRIPT_CAPS |
JSON-объект, ограничивающий, сколько раз определённые скрипты могут вызываться за сессию, когда задана CLAUDE_CODE_SUBPROCESS_ENV_SCRUB. Ключи — подстроки, сопоставляемые с текстом команды; значения — целочисленные лимиты вызовов. Например, {"deploy.sh": 2} позволяет вызвать deploy.sh не более двух раз. Сопоставление основано на подстроках, поэтому уловки с раскрытием в оболочке, такие как ./scripts/deploy.sh $(evil), всё равно учитываются в лимите. Размножение вызовов во время выполнения через xargs или find -exec не обнаруживается; это дополнительный уровень эшелонированной защиты |
CLAUDE_CODE_SCROLL_SPEED |
Задаёт множитель прокрутки колесом мыши в полноэкранном рендеринге. Принимает любое положительное значение до 20, включая дробные значения меньше 1, например 0.5, чтобы замедлить ускоренную прокрутку трекпадом и колесом в терминалах, которые уже усиливают события колеса. Установите 3, чтобы соответствовать vim, если ваш терминал отправляет одно событие колеса на щелчок без усиления. Игнорируется в терминале JetBrains IDE, где Claude Code использует собственную обработку прокрутки |
CLAUDE_CODE_SEND_FEEDBACK |
Установите 0, чтобы отключить отзывы, составляемые Claude, для сессии. Установите 1, чтобы включить их там, где у вашей учётной записи уже есть доступ; сама переменная не может предоставить доступ, а другие переключатели, отключающие отзывы, такие как DISABLE_FEEDBACK_COMMAND и значение off настройки feedbackDrafts, по-прежнему действуют |
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS |
Переопределяет бюджет времени в миллисекундах для хуков SessionEnd. Значение также служит таймаутом для каждого хука, который не задаёт собственный timeout. Применяется при выходе из сессии, /clear и переключении сессий через интерактивный /resume. По умолчанию бюджет составляет 1,5 секунды и автоматически повышается до наибольшего timeout хука, настроенного в файлах настроек, вплоть до 60 секунд. Таймауты хуков, предоставленных плагинами, не повышают бюджет |
CLAUDE_CODE_SESSION_ID |
Автоматически устанавливается в ID текущей сессии в подпроцессах инструментов Bash и PowerShell, подпроцессах команд хуков и подпроцессах stdio MCP-серверов. Для Bash, PowerShell и хуков совпадает с полем session_id во входных данных JSON хука и обновляется при /clear. Подпроцесс MCP-сервера сохраняет ID, с которым был запущен. При --resume <session-id> он получает ID возобновлённой сессии, совпадающий с хуками и Bash. При --continue или --resume без явного ID он может вместо этого получить исходный ID запуска. Используйте для сопоставления скриптов и внешних инструментов с сессией Claude Code, которая их запустила |
CLAUDE_CODE_SHELL |
Задаёт оболочку, которую Claude Code использует для выполнения команд инструмента Bash. Принимает путь к исполняемому файлу bash или zsh, например /opt/homebrew/bin/bash. Другие оболочки, такие как fish, не поддерживаются. Если значение не является работающим путём к bash или zsh, Claude Code игнорирует его и переходит к автоматическому определению. При автоматическом определении используется ваш $SHELL, если он указывает на bash или zsh; в противном случае выбирается первый работающий zsh, а затем bash, найденный в PATH и стандартных местах установки |
CLAUDE_CODE_SHELL_PREFIX |
Префикс команды, оборачивающий shell-команды, которые запускает Claude Code: вызовы инструмента Bash, команды хуков, команды строки состояния и команды запуска stdio MCP-серверов. Хуки PowerShell и хуки в exec-форме выполняются без префикса. Полезно для логирования или аудита. Если задать путь к исполняемому файлу без аргументов, например /path/to/logger.sh, каждая команда выполняется как /path/to/logger.sh '<command>'. Обёртка получает командную строку как один аргумент в кавычках оболочки в $1, поэтому обёртка должна повторно вычислить $1 с помощью оболочки, например exec bash -c "$1". Если обрабатывать $1 как путь к исполняемому файлу, перестают работать stdio MCP-серверы, которые передают аргументы, например npx -y <package>. Для вызовов инструмента Bash $1 содержит полный вызов оболочки, который собирает Claude Code, включая настройку окружения, а не только команду, которую выполнил Claude |
CLAUDE_CODE_SIMPLE |
Установите 1, чтобы работать с минимальным системным промптом и только инструментами Bash, чтения файлов и редактирования файлов. Инструменты MCP из --mcp-config по-прежнему доступны. Отключает автоматическое обнаружение хуков, скиллов, пользовательских команд, субагентов, установленных плагинов, MCP-серверов, автоматической памяти и CLAUDE.md. Скиллы в каталоге, переданном через --add-dir, по-прежнему загружаются. Токены OAuth и учётные данные из связки ключей не считываются, поэтому аутентификация Anthropic должна обеспечиваться через ANTHROPIC_API_KEY или apiKeyHelper в --settings. Эквивалентно передаче --bare |
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT |
Выбор между полным системным промптом Claude Code и более коротким с сокращёнными описаниями инструментов. Если переменная не задана, Haiku 4.5, Sonnet 5, Opus 4.7 и более ранние модели этих семейств по умолчанию используют полный промпт, а более новые модели — короткий. Установите 1, чтобы использовать короткий промпт на любой модели. Установите 0, false, no или off, чтобы использовать полный промпт на любой модели, даже если эксперимент или конфигурация сервера иначе выбрали бы короткий. С любым промптом сохраняются полный набор инструментов, хуки, MCP-серверы и обнаружение CLAUDE.md |
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH |
Пропускает аутентификацию на стороне клиента для Claude Platform on AWS — для шлюзов, которые сами подписывают запросы |
CLAUDE_CODE_SKIP_AWS_CRED_CACHE |
Установите 1, чтобы отключить внутрипроцессный кэш учётных данных, полученных из цепочки поставщиков учётных данных AWS по умолчанию, чтобы Claude Code проходил по цепочке при каждом запросе к API. При отключённом кэше профиль на основе SSO запрашивает учётные данные у IAM Identity Center при каждом запросе. См. кэширование учётных данных и таймаут их получения. Требуется Claude Code v2.1.207 или новее |
CLAUDE_CODE_SKIP_BEDROCK_AUTH |
Пропускает аутентификацию AWS для Amazon Bedrock (например, при использовании LLM-шлюза) |
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS |
Установите 1, чтобы считать неудавшуюся проверку доступности быстрого режима успешной — для сетей, которые блокируют прямой запрос проверки к api.anthropic.com. Claude Code по-прежнему учитывает ответ «disabled by your organization» |
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK |
Установите 1, чтобы пропустить проверку доступности быстрого режима на стороне клиента — для прокси, которые перехватывают запрос проверки, а не отклоняют его. API по-прежнему отклоняет запросы в быстром режиме, если в вашей организации быстрый режим отключён |
CLAUDE_CODE_SKIP_FOUNDRY_AUTH |
Пропускает аутентификацию Azure для Microsoft Foundry — для прокси или шлюза, который добавляет собственный заголовок Authorization. Claude Code отправляет запросы без учётных данных Azure и сохраняет заголовок Authorization, который вы передаёте, например через ANTHROPIC_CUSTOM_HEADERS. Игнорируется, если задана ANTHROPIC_FOUNDRY_API_KEY или ANTHROPIC_FOUNDRY_AUTH_TOKEN. До v2.1.203 эта переменная приводила к тому, что клиент Microsoft Foundry не мог отправлять запросы, если не был также задан API-ключ |
CLAUDE_CODE_SKIP_MANTLE_AUTH |
Пропускает аутентификацию AWS для Amazon Bedrock Mantle (например, при использовании LLM-шлюза) |
CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY |
Проверки моделей при запуске в Amazon Bedrock и Google Cloud's Agent Platform запоминают на этом компьютере, какие модели ваша учётная запись не может вызывать, на срок до одного дня. Установите 1, чтобы отключить это запоминание. Требуется Claude Code v2.1.285 или новее |
CLAUDE_CODE_SKIP_PROMPT_HISTORY |
Установите 1, чтобы не записывать историю промптов и транскрипты сессий на диск. Сессии, запущенные с этой переменной, не отображаются в --resume, --continue и истории по стрелке вверх. Полезно для временных сессий, выполняемых скриптами |
CLAUDE_CODE_SKIP_VERTEX_AUTH |
Пропускает аутентификацию Google для Google Cloud's Agent Platform (например, при использовании LLM-шлюза) |
CLAUDE_CODE_STARTUP_FAILURE_RESULTS |
Установите 1, чтобы сессия, запущенная с --output-format stream-json, записывала сообщение с результатом, указывающее, почему Claude Code отказался запускаться, при сбоях запуска, которые иначе завершаются только выводом в stderr. Требуется Claude Code v2.1.274 или новее |
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP |
Максимальное количество последовательных раз, когда хук Stop или SubagentStop может блокировать завершение хода, прежде чем Claude Code переопределит его и всё равно завершит ход (по умолчанию: 8). Установите 0, чтобы отключить ограничение. Увеличьте значение, если вашему хуку обоснованно требуется больше итераций для завершения |
CLAUDE_CODE_SUBAGENT_MODEL |
Модель по умолчанию для субагентов, участников команды агентов и агентов рабочих процессов, которым модель не назначена другим способом. Принимает псевдоним, например haiku, или полное имя модели. Два источника имеют приоритет над ней: модель, которую Claude передаёт при запуске агента, и поле model в определении агента, включая inherit. Чтобы изменить это, задайте CLAUDE_CODE_SUBAGENT_MODEL_FORCE. Полный порядок см. в разделе Выбор модели. Значение inherit равнозначно незаданной переменной. До v2.1.251 эта переменная переопределяла как модель, переданную при вызове, так и поле model в определении |
CLAUDE_CODE_SUBAGENT_MODEL_FORCE |
Установите 1, чтобы принудительно назначить одну модель субагентам, участникам команды и агентам рабочих процессов. Какая это модель, описано в разделе Запуск всех субагентов на одной модели. Требуется Claude Code v2.1.257 или новее |
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL |
Установите 5m или 1h — единственные значения, которые принимает Claude Code, — чтобы выбрать TTL кэша промптов для запросов вне основного диалога, таких как субагенты, рабочие процессы и фоновая работа. Имеет приоритет над настройкой subagentPromptCacheTtl и над ENABLE_PROMPT_CACHING_1H, а FORCE_PROMPT_CACHING_5M переопределяет её. API тарифицирует запись в кэш на 1 час по более высокой ставке. Требуется Claude Code v2.1.242 или новее |
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB |
Установите 1, чтобы удалять учётные данные из окружения подпроцессов, которые запускает Claude Code, таких как команды Bash, хуки и stdio MCP-серверы. Очистка распознаёт учётные данные по имени переменной или по её значению и оставляет токены GitHub и настройки прокси. См. Что удаляет очистка окружения подпроцессов. claude-code-action задаёт эту переменную автоматически, когда настроен allowed_non_write_users |
CLAUDE_CODE_SYNC_PLUGIN_INSTALL |
Установите 1 в неинтерактивном режиме (флаг -p), чтобы дождаться завершения установки плагинов перед первым запросом. Без этого плагины устанавливаются в фоне и могут быть недоступны на первом ходу. Используйте вместе с CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS, чтобы ограничить ожидание |
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS |
Таймаут в миллисекундах для синхронной установки плагинов. При превышении Claude Code продолжает работу без плагинов и записывает ошибку в лог. Значения по умолчанию нет: без этой переменной синхронная установка ждёт до завершения |
CLAUDE_CODE_SYNC_SKILLS |
Установите 1 в неинтерактивном режиме с флагом -p, чтобы Claude Code загрузил скиллы, включённые для вашей учётной записи claude.ai, в этом запуске и дождался их списка, вплоть до CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS, прежде чем выполнить первый запрос. Требуется аутентификация claude.ai. Сессии в терминале, в которых вы входите с учётной записью claude.ai, синхронизируют эти скиллы без этой переменной, поэтому задавайте её, только когда запуску -p нужны ваши актуальные скиллы уже при первом запросе |
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS |
Таймаут в миллисекундах для повторной синхронизации скиллов, которая выполняется посреди сессии, когда приложение на основе Agent SDK перезагружает скиллы (по умолчанию: 30000). При превышении перезагрузка продолжается с теми скиллами, которые уже поступили, а остальные загрузки завершаются в фоне |
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS |
Таймаут в миллисекундах, в течение которого первый запрос ожидает исходный список скиллов, когда задана CLAUDE_CODE_SYNC_SKILLS (по умолчанию: 5000). При превышении первый запрос выполняется с теми скиллами, которые уже поступили. В любом случае загрузки завершаются в фоне, а Claude дожидается загрузки скилла, когда вызывает этот скилл |
CLAUDE_CODE_SYNTAX_HIGHLIGHT |
Установите false, чтобы отключить подсветку синтаксиса в выводе diff. Полезно, когда цвета мешают настройке вашего терминала. Чтобы также отключить подсветку в блоках кода и предпросмотре файлов, используйте настройку syntaxHighlightingDisabled |
CLAUDE_CODE_TASK_LIST_ID |
Общий список задач для нескольких сессий. Задайте один и тот же ID в нескольких экземплярах Claude Code, чтобы координировать работу над общим списком задач в сессиях, где есть инструменты Task. См. Список задач |
CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS |
Переопределяет в миллисекундах, сколько неинтерактивная сессия ждёт при выходе, пока её команда агентов завершит остановку. Принимает значения от 1000 до 60000; значение вне диапазона игнорируется, и применяется значение по умолчанию 10000. Требуется Claude Code v2.1.206 или новее |
CLAUDE_CODE_TMPDIR |
Переопределяет временный каталог, используемый для внутренних временных файлов. Claude Code добавляет к этому пути /claude-{uid}/ в Unix или /claude/ в Windows. По умолчанию: /tmp в macOS, os.tmpdir() в Linux и Windows. В macOS и Linux изолированные в песочнице подпроцессы Bash получают короткий резервный $TMPDIR в системном каталоге по умолчанию, если ваше переопределение — длинный путь, поскольку некоторые инструменты дают сбой при слишком длинных путях к временным файлам. Команды Bash вне песочницы наследуют $TMPDIR вашей оболочки, если он задан. В нативной Windows, когда ваша оболочка не задаёт $TMPDIR, команда Bash, ссылающаяся на $TMPDIR, получает ваше переопределение или %TEMP%, если вы его не задали. Собственные временные файлы Claude Code всегда используют ваше переопределение. Задайте её в оболочке, пользовательских настройках или управляемых настройках. Игнорируется в настройках проекта и локальных настройках |
CLAUDE_CODE_TMUX_TRUECOLOR |
Задайте любое непустое значение, например 1, чтобы разрешить 24-битный вывод truecolor внутри tmux. Значение 0 или false всё равно разрешает truecolor, в отличие от большинства переменных включения/отключения; удалите переменную, чтобы восстановить ограничение в 256 цветов. По умолчанию Claude Code ограничивается 256 цветами, когда задан $TMUX, поскольку tmux не пропускает escape-последовательности truecolor, если не настроен соответствующим образом. Задайте эту переменную после добавления set -ga terminal-overrides ',*:Tc' в ваш ~/.tmux.conf. Другие настройки tmux см. в разделе Настройка терминала |
CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE |
В Linux и WSL задайте разделённый запятыми список видов процессов, которые Claude Code исключает из ограничения памяти инструментов, например mcp или lsp. Задайте none, чтобы ограничивать все виды, или all-new, чтобы ограничивать только команды инструментов Bash, PowerShell и Monitor. Claude Code оставляет команды инструментов Bash, PowerShell и Monitor под ограничением, что бы вы ни перечислили. Требуется Claude Code v2.1.246 или новее |
CLAUDE_CODE_TOOL_MEMORY_LIMIT |
В Linux и WSL задайте размер, например 4G, чтобы ограничить память, которую могут использовать команды инструментов Bash и PowerShell, а также команды инструмента Monitor в v2.1.246 и новее. Записывайте размер цифрами: без суффикса — в байтах, или с суффиксом K, M, G или T. Задайте 0 или off, чтобы отключить ограничение. После того как первый процесс, запущенный Claude Code, включил или отключил ограничение, изменённое значение вступает в силу при следующем запуске claude. Требуется Claude Code v2.1.233 или новее |
CLAUDE_CODE_TRANSCRIPT_LOCAL_GC |
Установите 1, чтобы ограничить рост файла транскрипта длительной сессии -p или Agent SDK. После каждого сжатия контекста, если файл больше 5 МБ, Claude Code удаляет историю, предшествующую этому сжатию. Возобновление сессии восстанавливает тот же диалог независимо от того, был ли файл обрезан. Задайте её в окружении, из которого вы запускаете Claude Code, поскольку блок env в настройках не может её включить. Требуется Claude Code v2.1.287 или новее |
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS |
Крайний срок в миллисекундах, по истечении которого Claude Code отменяет диалоговое окно, пересылаемое удалённому клиенту, например Remote Control или хосту SDK, либо диалоговое окно подтверждения для задержанного межсессионного сообщения; запросы разрешений и вопросы AskUserQuestion используют собственные механизмы и этой переменной не регулируются. В Claude Code v2.1.236 или новее она также ограничивает запрос согласия на кредиты использования Fable, появляющийся посреди сессии, которая может выполняться без присмотра. Полные правила истечения срока задержанных сообщений, включая случаи, когда крайний срок не применяется, описаны в разделах Управление входящими сообщениями и Неинтерактивные сессии. Переопределяет настройку dialogExpiry. 0 или отрицательное значение отключает крайний срок. Игнорируется в настройках проекта и локальных настройках |
CLAUDE_CODE_USE_ANTHROPIC_AWS |
Использовать Claude Platform on AWS |
CLAUDE_CODE_USE_BEDROCK |
Использовать Amazon Bedrock |
CLAUDE_CODE_USE_FOUNDRY |
Использовать Microsoft Foundry |
CLAUDE_CODE_USE_MANTLE |
Использовать эндпоинт Mantle Amazon Bedrock |
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH |
Установите значение 1, чтобы обнаруживать пользовательские команды, субагентов и стили вывода с помощью файловых API Node.js вместо ripgrep. Используйте, если встроенный бинарный файл ripgrep недоступен или заблокирован в вашей среде. Не влияет на инструменты Grep и поиска файлов |
CLAUDE_CODE_USE_POWERSHELL_TOOL |
Управляет инструментом PowerShell. В Windows без Git Bash инструмент включается автоматически; установите 0, чтобы отключить его. В Windows с установленным Git Bash инструмент по умолчанию включён для учётных записей claude.ai и Console; установите 1, чтобы включить его в сессиях Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, или 0, чтобы отключить. В Linux, macOS и WSL установите 1, чтобы включить его; для этого требуется pwsh в PATH. Когда инструмент включён в Windows, Claude может выполнять команды PowerShell напрямую, а не через Git Bash. См. Инструмент PowerShell |
CLAUDE_CODE_USE_VERTEX |
Использовать Google Cloud's Agent Platform |
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS |
Задаёт количество миллисекунд, в течение которых WebFetch хранит в кэше ответ для каждого загруженного URL. По умолчанию 900000, то есть 15 минут. Принимаются только цифры; 0, десятичная дробь или любая другая запись оставляет значение по умолчанию. Claude Code считывает значение один раз при запуске, поэтому изменение в блоке env настроек вступает в силу при следующем запуске claude. Требуется Claude Code v2.1.233 или новее |
CLAUDE_CODE_WEBFETCH_DEADLINE_MS |
Верхний предел в миллисекундах для времени ожидания WebFetch при загрузке страницы, включая все перенаправления, по которым он переходит. Загрузка, не завершившаяся к этому моменту, завершается ошибкой крайнего срока. По умолчанию 300000, то есть пять минут. Установите 0, чтобы снять ограничение. Принимаются только цифры; десятичная дробь или любая другая запись оставляет значение по умолчанию. Требуется Claude Code v2.1.268 или новее |
CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR |
Скорость пополнения лимита WebSearch сессии в вызовах в час. По умолчанию 100 в интерактивной сессии терминала. В неинтерактивной сессии значение по умолчанию — 0, что отключает пополнение. Принимаются только цифры; любая другая запись считается незаданной. Требуется Claude Code v2.1.290 или новее |
CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE |
Когда CLAUDE_AUTO_BACKGROUND_TASKS установлена в 1, задаёт, сколько Claude Code ждёт перед каждым напоминанием Claude проверить фоновых субагентов, которые всё ещё выполняются. Принимает одно или несколько разделённых запятыми значений ожидания в целых секундах от 1 до 86400, например 600 или 600,1800,3600. Каждое значение — это время ожидания перед следующим напоминанием, а последнее значение повторяется. Принимаются только цифры; любое другое значение или запись считается незаданной. Если не задана, напоминаний нет. Требуется Claude Code v2.1.283 или новее |
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS |
Сколько агентов одновременно выполняет один запуск рабочего процесса, от 1 до 256. По умолчанию запуск выполняет до 16 агентов одновременно, меньше, если Claude Code доступно меньше процессоров; вызовы agent() в очереди ждут освобождения слота. Транскрипт каждого выполняющегося агента хранится в памяти Claude Code, поэтому более высокие значения увеличивают потребление оперативной памяти. Принимаются только цифры; значения вне диапазона и другие записи оставляют значение по умолчанию. Требуется Claude Code v2.1.269 или новее |
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS |
Верхний предел в миллисекундах для времени, в течение которого агент рабочего процесса ждёт начала первого ответа родственного агента с тем же префиксом, прежде чем отправить собственный первый запрос. Когда разветвление запускает несколько агентов с общим префиксом кэша промптов, Claude Code задерживает всех агентов, кроме первого, не дольше этого времени, чтобы остальные считывали кэшированный префикс, а не обрабатывали его каждый без кэша. По умолчанию 5000. Установите 0, чтобы отключить ожидание. Когда задана DISABLE_PROMPT_CACHING, агенты никогда не ждут. Требуется Claude Code v2.1.229 или новее |
CLAUDE_CONFIG_DIR |
Переопределить каталог конфигурации (по умолчанию: ~/.claude). Все настройки, история сессий и плагины хранятся по этому пути. Об учётных данных см. где Claude Code хранит учётные данные. Полезно для параллельной работы с несколькими учётными записями: например, alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'. Задайте её в оболочке, пользовательских настройках или управляемых настройках. В файле настроек укажите абсолютный путь. Игнорируется в настройках проекта и локальных настройках |
CLAUDE_DISABLE_ADOPT |
Установите значение 1, чтобы останавливать выполняющуюся фоновую работу вместо её переноса, когда вы переводите сессию в фон нажатием ← или командой /background. Claude Code просит подтвердить перевод в фон, а затем останавливает задачи, которые иначе были бы перенесены. Требуется Claude Code v2.1.195 или новее |
CLAUDE_EFFORT |
Автоматически устанавливается в подпроцессах инструмента Bash и командах хуков в значение уровня effort, действующего на момент запуска подпроцесса: low, medium, high, xhigh или max. Совпадает с полем effort.level, передаваемым хукам. Устанавливается, только если текущая модель поддерживает параметр effort |
CLAUDE_ENABLE_BYTE_WATCHDOG |
Установите значение 1, чтобы принудительно включить сторожевой таймер простоя потоковой передачи на уровне байтов, или 0, чтобы принудительно отключить его. 0 также отключает крайний срок первого байта на соединениях, где этот крайний срок действует. Если переменная не задана, сторожевой таймер по умолчанию включён для прямых соединений с Anthropic API и Claude Platform on AWS, а также для потоковых ответов на соединениях через шлюз, достигаемый через ANTHROPIC_BASE_URL или ANTHROPIC_AWS_BASE_URL; до v2.1.222 он не работал на этих соединениях через шлюз, поэтому сторожевой таймер уровня событий мог сообщать о зависании даже при поступлении keep-alive пингов. О таймаутах и взаимодействии таймеров см. Сторожевые таймеры простоя потоковой передачи |
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK |
Установите значение 1, чтобы включить сторожевой таймер простоя потоковой передачи на уровне байтов для ответов Amazon Bedrock vnd.amazon.eventstream; это также включает крайний срок первого байта для потоковых запросов Bedrock. По умолчанию отключено. Таймаут настраивается с помощью CLAUDE_STREAM_IDLE_TIMEOUT_MS |
CLAUDE_ENABLE_STREAM_WATCHDOG |
Установите значение 0, чтобы принудительно отключить сторожевой таймер простоя потоковой передачи на уровне событий, или 1, чтобы принудительно включить его. Если переменная не задана, сторожевой таймер по умолчанию включён для всех провайдеров. До v2.1.196 значение по умолчанию управлялось сервером для прямого Anthropic API и было отключено для других провайдеров. Таймаут настраивается с помощью CLAUDE_STREAM_IDLE_TIMEOUT_MS; о других таймерах зависания, работающих параллельно с этим, см. Сторожевые таймеры простоя потоковой передачи |
CLAUDE_ENV_FILE |
Путь к shell-скрипту, содержимое которого Claude Code выполняет перед каждой командой Bash в том же процессе оболочки, чтобы экспорты из файла были видны команде. Используйте для сохранения активации virtualenv или conda между командами. Также заполняется динамически хуками SessionStart, Setup, CwdChanged и FileChanged |
CLAUDE_JOB_DIR |
Устанавливается Claude Code в каждой фоновой сессии в каталог ~/.claude/jobs/<id> этой сессии. Её наследуют shell-команды, которые выполняет сессия. Записывайте временные файлы в $CLAUDE_JOB_DIR/tmp. Вызовы Write и Edit от Claude в этом каталоге не запрашивают разрешения, а каталог удаляется при удалении сессии |
CLAUDE_PID |
Claude Code устанавливает эту переменную в идентификатор собственного процесса в порождаемых им подпроцессах: командах инструментов Bash и PowerShell и командах хуков. В Linux интеграция с оболочкой инструмента Bash использует её, чтобы отклонять шаблон pkill, который совпал бы с самим процессом Claude Code; см. справочник по ошибкам. Считывайте её в собственных скриптах, чтобы намеренно идентифицировать родительский процесс Claude Code или отправлять ему сигналы. Требуется Claude Code v2.1.214 или новее |
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX |
Префикс для автоматически генерируемых имён сессий Remote Control, когда явное имя не указано. По умолчанию — имя хоста вашего компьютера, что даёт имена вида myhost-graceful-unicorn. Флаг CLI --remote-control-session-name-prefix задаёт то же значение для одного запуска |
CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS |
Крайний срок в миллисекундах для первого байта ответа на потоковый запрос на соединениях, где действует крайний срок первого байта. О том, как Claude Code ограничивает это значение, какое дополнительное время добавляет для больших тел запросов и как выбирает крайний срок, если переменная не задана, см. No response from API. Требуется Claude Code v2.1.242 или новее |
CLAUDE_STREAM_IDLE_TIMEOUT_MS |
Таймаут в миллисекундах, по истечении которого сторожевые таймеры простоя потоковой передачи на уровне событий и байтов закрывают зависшее соединение. Если вы задаёте эту переменную явно, минимум составляет 300000 (5 минут); более низкие значения без предупреждения повышаются до минимума, чтобы учесть длительные паузы расширенного мышления и буферизацию прокси, а сторожевой таймер уровня байтов ограничивает значение 30 минутами. Для сторожевого таймера уровня байтов CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS имеет приоритет над этой переменной. Значения по умолчанию для каждого сторожевого таймера см. в разделе Сторожевые таймеры простоя потоковой передачи |
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS |
Удалена в v2.1.260 и теперь ни на что не влияет. Ранее ограничивала в миллисекундах время выполнения фоновой shell-команды, запущенной субагентом, со значением по умолчанию 60 минут. См. правила времени жизни фоновых команд |
DEBUG |
Установите значение 1, чтобы включить режим отладки, что эквивалентно запуску с --debug. Логи отладки записываются в ~/.claude/debug/<session-id>.txt или по пути, заданному CLAUDE_CODE_DEBUG_LOGS_DIR. Режим отладки включают только истинные значения 1, true, yes и on, поэтому шаблоны пространств имён вроде DEBUG=express:*, заданные для других инструментов, его не активируют |
DISABLE_AUTOUPDATER |
Установите значение 1, чтобы отключить автоматические фоновые обновления. Ручная команда claude update продолжает работать. Используйте DISABLE_UPDATES, чтобы заблокировать и то, и другое |
DISABLE_AUTO_COMPACT |
Установите значение 1, чтобы отключить автоматическое сжатие контекста при приближении к лимиту контекста. Ручная команда /compact остаётся доступной. Используйте, когда хотите явно контролировать момент сжатия. Переопределяет настройку autoCompactEnabled |
DISABLE_COMPACT |
Установите значение 1, чтобы отключить любое сжатие контекста: и автоматическое, и ручную команду /compact |
DISABLE_COST_WARNINGS |
Установите значение 1, чтобы отключить предупреждения о стоимости |
DISABLE_DOCTOR_COMMAND |
Установите значение 1, чтобы скрыть скилл проверки установки /doctor и его псевдоним /checkup. Полезно для управляемых развёртываний, где пользователи не должны запускать диагностику установки из сессии. Не влияет на команду терминала claude doctor. До v2.1.205 эта переменная скрывала команду экрана диагностики /doctor |
DISABLE_ERROR_REPORTING |
Установите любое непустое значение, например 1, чтобы отказаться от отправки отчётов об ошибках. Значение 0 или false также означает отказ, в отличие от большинства переменных включения/выключения; удалите переменную, чтобы снова включить отчёты об ошибках |
DISABLE_EXTRA_USAGE_COMMAND |
Установите значение 1, чтобы скрыть команду /usage-credits, которая позволяет пользователям приобретать дополнительное использование сверх ограничений частоты запросов |
DISABLE_FEEDBACK_COMMAND |
Установите значение 1, чтобы отключить команду /feedback и отзывы, составленные Claude. Также отключает /bug и /share, которые отправляют отчёты тем же путём; до v2.1.212 они были псевдонимами /feedback, поэтому команда отключалась под любым именем. Также принимается старое имя DISABLE_BUG_COMMAND |
DISABLE_GROWTHBOOK |
Установите значение 1 или true, чтобы отключить получение флагов функций GrowthBook и использовать значения по умолчанию из кода для всех флагов. Это делает недоступными Remote Control и другие функции, которым требуется получение флагов функций. Значение 0 или false оставляет получение включённым. Логирование событий телеметрии остаётся включённым, если не задана также DISABLE_TELEMETRY |
DISABLE_INSTALLATION_CHECKS |
Установите значение 1, чтобы отключить предупреждения об установке. Используйте только при ручном управлении расположением установки, так как это может скрыть проблемы стандартных установок |
DISABLE_INSTALL_GITHUB_APP_COMMAND |
Установите значение 1, чтобы скрыть команду /install-github-app. Уже скрыта при использовании сторонних провайдеров (Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry) |
DISABLE_INTERLEAVED_THINKING |
Установите значение 1, чтобы не отправлять бета-заголовок interleaved-thinking. Полезно, когда ваш LLM-шлюз или провайдер не поддерживает чередующееся мышление |
DISABLE_LOGIN_COMMAND |
Установите значение 1, чтобы скрыть команду /login. Полезно, когда аутентификация выполняется внешне через API-ключи или apiKeyHelper |
DISABLE_LOGOUT_COMMAND |
Установите значение 1, чтобы скрыть команду /logout |
DISABLE_PROMPT_CACHING |
Установите значение 1, чтобы отключить кэширование промптов для всех моделей (имеет приоритет над настройками для отдельных моделей) |
DISABLE_PROMPT_CACHING_FABLE |
Установите значение 1, чтобы отключить кэширование промптов для моделей Fable |
DISABLE_PROMPT_CACHING_HAIKU |
Установите значение 1, чтобы отключить кэширование промптов для модели Haiku по умолчанию, где бы она ни работала |
DISABLE_PROMPT_CACHING_OPUS |
Установите значение 1, чтобы отключить кэширование промптов для модели Opus по умолчанию |
DISABLE_PROMPT_CACHING_SONNET |
Установите значение 1, чтобы отключить кэширование промптов для модели Sonnet по умолчанию |
DISABLE_TELEMETRY |
Установите любое непустое значение, например 1, чтобы отказаться от телеметрии. Значение 0 или false также означает отказ, в отличие от большинства переменных включения/выключения; удалите переменную, чтобы снова включить телеметрию. События телеметрии не содержат пользовательских данных, таких как код, пути к файлам или команды Bash. Также отключает получение флагов функций. См. Отключение телеметрии для вашей организации |
DISABLE_UPDATES |
Установите значение 1, чтобы заблокировать все обновления, включая ручные claude update и claude install. Строже, чем DISABLE_AUTOUPDATER. Используйте, когда распространяете Claude Code через собственные каналы и пользователи не должны обновляться самостоятельно |
DISABLE_UPGRADE_COMMAND |
Установите значение 1, чтобы скрыть команду /upgrade |
DO_NOT_TRACK |
Установите значение 1, чтобы отказаться от телеметрии, с тем же эффектом, что и DISABLE_TELEMETRY, включая влияние на получение флагов функций. Claude Code считывает эту переменную как стандартное логическое значение, поэтому 0 оставляет телеметрию включённой, и учитывает её как общепринятое соглашение, распознаваемое многими CLI для разработчиков |
ENABLE_BETA_TRACING_DETAILED |
Установите значение 1 и задайте в BETA_TRACING_ENDPOINT эндпоинт вашего коллектора OTLP/HTTP, чтобы включить детальную бета-трассировку, которая добавляет атрибуты спанов с содержимым и спан claude_code.hook. Для интерактивных сессий CLI также требуется, чтобы ваша организация была в списке разрешённых для бета-версии. Обе переменные игнорируются в настройках проекта и локальных настройках |
ENABLE_CLAUDEAI_MCP_SERVERS |
Установите значение false, чтобы Claude Code не получал MCP-серверы claude.ai. По умолчанию включено для вошедших пользователей. Чтобы отключить для отдельного проекта или организации, используйте вместо этого настройку disableClaudeAiConnectors |
ENABLE_PROMPT_CACHING_1H |
Установите значение 1, чтобы запрашивать TTL кэша промптов в 1 час вместо стандартных 5 минут. Предназначено для пользователей API-ключей, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform on AWS. Пользователи подписки в пределах включённого использования получают TTL в 1 час автоматически в основном диалоге. Пользователи подписки, расходующие кредиты использования, могут задать её, чтобы сохранить TTL в 1 час. Запись в кэш с TTL в 1 час тарифицируется по более высокой ставке. Чтобы выбирать TTL для каждой группы запросов, используйте CLAUDE_CODE_PROMPT_CACHE_TTL и CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, которые имеют приоритет над этой переменной |
ENABLE_PROMPT_CACHING_1H_BEDROCK |
Устаревшая. Используйте вместо неё ENABLE_PROMPT_CACHING_1H |
ENABLE_TOOL_SEARCH |
Управляет поиском инструментов MCP. Если переменная не задана, Claude Code по умолчанию откладывает загрузку всех инструментов MCP. Однако он по-прежнему загружает их сразу на моделях Google Cloud's Agent Platform, предшествующих поколению Claude 4.5, в развёртывании Microsoft Foundry, размещённом в Azure, и когда ANTHROPIC_BASE_URL указывает на хост, не принадлежащий Anthropic. true всегда откладывает загрузку и отправляет бета-заголовок, кроме тех же моделей Agent Platform и развёртываний Microsoft Foundry; запросы завершаются ошибкой на прокси, которые не поддерживают tool_reference. auto загружает сразу, если определения инструментов занимают не более 10% контекста. auto:N задаёт собственный порог, например auto:5 для 5%. false загружает все инструменты сразу. Заданное вами значение игнорируется, если установлена CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS. До v2.1.221 Claude Code отключал поиск инструментов для всех моделей в Google Cloud's Agent Platform, если вы не задавали этой переменной значение true |
FALLBACK_FOR_ALL_PRIMARY_MODELS |
Установите любое непустое значение, например 1, чтобы Claude Code прекращал повторные попытки при повторяющихся ошибках перегрузки для любой модели, если резервная модель не настроена. Значение 0 или false также включает это поведение, в отличие от большинства переменных включения/выключения; удалите переменную, чтобы восстановить поведение повторных попыток по умолчанию. Без неё Claude Code прекращает повторные попытки таким образом для моделей, которые он распознаёт как модели Opus, Fable или Mythos, когда вы проходите аутентификацию с API-ключом или через стороннего провайдера, а не с подпиской Claude. В Claude Code v2.1.160 или новее Claude Code при повторяющихся ошибках перегрузки для любой основной модели переключается на настроенную вами цепочку резервных моделей, поэтому эта переменная не влияет на переключение на резервную модель |
FORCE_AUTOUPDATE_PLUGINS |
Установите значение 1, чтобы принудительно автоматически обновлять плагины, даже если основной механизм автообновления отключён через DISABLE_AUTOUPDATER |
FORCE_HYPERLINK |
Установите значение 1, чтобы включить кликабельные гиперссылки OSC 8, когда ваш терминал их поддерживает, но это не определяется автоматически, или 0, чтобы отключить их. Если переменная не задана, Claude Code включает гиперссылки, только когда обнаруживает поддержку терминалом. Claude Code разбирает это значение как число, а не логическое значение, поэтому значения вроде false, no или off включают гиперссылки, а не отключают их. Значок PR или merge request в нижней строке отображается как гиперссылка, даже когда Claude Code не может обнаружить поддержку терминалом, например через SSH. Установите 0, чтобы отображать значок как обычный текст |
FORCE_PROMPT_CACHING_5M |
Установите значение 1, чтобы принудительно использовать TTL кэша промптов в 5 минут, даже если иначе применялся бы TTL в 1 час. Переопределяет CLAUDE_CODE_PROMPT_CACHE_TTL, CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, ENABLE_PROMPT_CACHING_1H, а также настройки promptCacheTtl и subagentPromptCacheTtl |
HTTP_PROXY |
Указать HTTP-прокси-сервер для сетевых соединений |
HTTPS_PROXY |
Указать HTTPS-прокси-сервер для сетевых соединений |
IS_DEMO |
Установите любое непустое значение, например 1, чтобы включить демонстрационный режим: скрывает ваш адрес электронной почты и название организации в заголовке и выводе /status, а также пропускает онбординг. Значение 0 или false также включает демонстрационный режим, в отличие от большинства переменных включения/выключения; удалите переменную, чтобы отключить его. Полезно при трансляции или записи сессии |
MAX_MCP_OUTPUT_TOKENS |
Максимальное количество токенов, разрешённое в ответах инструментов MCP (по умолчанию: 25000). Claude Code показывает предупреждение, когда вывод превышает 10 000 токенов. Инструменты, объявляющие anthropic/maxResultSizeChars, используют вместо этого указанный лимит символов для текстового содержимого, но на изображения от этих инструментов по-прежнему распространяется эта переменная. Успешный текстовый результат длиннее 50 000 символов от инструмента без этой аннотации сохраняется в файл независимо от этой переменной |
MAX_STRUCTURED_OUTPUT_RETRIES |
Количество попыток, которое Claude Code допускает, когда ответ модели не проходит валидацию по --json-schema в неинтерактивном режиме с флагом -p; после стольких неудачных попыток без корректного вывода запуск завершается ошибкой. То же ограничение применяется, когда структурированный вывод субагента рабочего процесса не проходит валидацию. По умолчанию 5: первая попытка плюс четыре повторные |
MAX_THINKING_TOKENS |
Фиксированный бюджет токенов для расширенного мышления. Claude Code ограничивает его значением на один токен меньше максимального количества выходных токенов запроса и не менее 1 024. О том, как задаётся этот лимит, см. CLAUDE_CODE_MAX_OUTPUT_TOKENS. Если переменная не задана и мышление включено, модели с адаптивным рассуждением сами выбирают глубину мышления, а другие модели используют ограничение. Установите 0, чтобы отключить мышление в Anthropic API, кроме Opus 5.5, Sonnet 5.5, Haiku 5.5 и моделей Fable, у которых мышление отключить нельзя. У сторонних провайдеров 0 вместо этого опускает параметр thinking. При отключённом мышлении в Anthropic API Claude Code отправляет effort high вместо более высокого уровня моделям, которые, как ему известно, не принимают такое сочетание, например Opus 5. При положительном значении Claude Code игнорирует само число на моделях с адаптивным рассуждением, кроме случая, когда CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING отключает адаптивное рассуждение |
MCP_CLIENT_SECRET |
Секрет клиента OAuth для MCP-серверов, которым требуются предварительно настроенные учётные данные. Позволяет избежать интерактивного запроса при добавлении сервера с --client-secret |
MCP_CONNECTION_NONBLOCKING |
Определяет, ждёт ли запуск подключения MCP-серверов перед первым запросом. По умолчанию запуск MCP неблокирующий: серверы подключаются в фоне, а их инструменты становятся доступны по мере завершения подключения. Установите 0, чтобы Claude Code ждал подключения серверов перед первым запросом. Серверы, настроенные с alwaysLoad: true, всё равно заставляют запуск ждать, кроме случаев, когда они обслуживаются из кэша обнаружения, поскольку их инструменты должны присутствовать при формировании первого промпта. В неинтерактивном режиме (-p) без --input-format stream-json Claude Code также ждёт ещё не подключившиеся серверы перед первым ходом независимо от этой переменной. Если вы явно передаёте --mcp-config, у ожидания более длительный крайний срок; об исключении для кэшированных серверов см. описание этого флага |
MCP_CONNECT_TIMEOUT_MS |
Сколько миллисекунд блокирующий запуск MCP ждёт пакет подключений, прежде чем зафиксировать список инструментов (по умолчанию: 5000). Применяется при MCP_CONNECTION_NONBLOCKING=0 или для серверов, помеченных alwaysLoad: true. Серверы, ещё не подключившиеся к крайнему сроку, продолжают подключаться в фоне. Отличается от MCP_TIMEOUT, который ограничивает отдельную попытку подключения сервера |
MCP_DISCOVERY_CACHE |
Включает или отключает кэш обнаружения MCP. При включённом кэше удалённый HTTP- или SSE-сервер, который вы использовали ранее, может отображать статус cached, и Claude Code подключает его при первом вызове инструмента, а не при запуске. Кэш по умолчанию отключён, если только постепенное развёртывание не включило его для вашей учётной записи. Установите 1, чтобы включить его, или 0, чтобы оставить отключённым, даже если развёртывание его включило. До v2.1.238 кэш был включён по умолчанию. Для статуса cached требуется Claude Code v2.1.221 или новее |
MCP_DISCOVERY_CACHE_MAX_STALE_S |
Максимальный возраст записи кэша обнаружения в секундах (по умолчанию: 14400, или 4 часа). При запуске, когда запись старше этого значения, Claude Code отбрасывает её и подключает сервер при запуске, как при отключённом кэше. Claude Code ограничивает значение 7 днями. До v2.1.238 значение по умолчанию было 86400, или 24 часа, и Claude Code не ограничивал значение |
MCP_DISCOVERY_CACHE_STRIKES |
При запуске, когда запись кэша обнаружения старше MCP_DISCOVERY_CACHE_TTL_S, Claude Code обновляет её в фоне. Эта переменная задаёт, сколько обновлений подряд могут завершиться неудачей, прежде чем Claude Code отбросит запись и вместо этого подключит сервер при следующем запуске (по умолчанию: 1). Увеличьте значение, если ваше сетевое соединение иногда обрывается, чтобы одно неудачное обновление не приводило к удалению записи. Требуется Claude Code v2.1.238 или новее |
MCP_DISCOVERY_CACHE_TTL_S |
Количество секунд, в течение которых Claude Code использует запись кэша обнаружения без обновления (по умолчанию: 900). При запуске, когда запись старше этого значения, Claude Code всё ещё использует её, но обновляет в фоне. Когда запись становится старше MCP_DISCOVERY_CACHE_MAX_STALE_S, Claude Code вместо этого отбрасывает её. Claude Code ограничивает значение величиной MCP_DISCOVERY_CACHE_MAX_STALE_S, которая по умолчанию составляет 4 часа. До v2.1.238 Claude Code не ограничивал значение |
MCP_OAUTH_CALLBACK_PORT |
Фиксированный порт для обратного вызова перенаправления OAuth, как альтернатива --callback-port при добавлении MCP-сервера с предварительно настроенными учётными данными |
MCP_PROTOCOL_NEGOTIATION |
Только в среде выполнения клиента MCP v2: определяет, проверяет ли Claude Code поддержку серверами ревизии протокола MCP 2026-07-28. Установите auto, чтобы проверять HTTP-серверы, коннекторы claude.ai и stdio-серверы, или legacy, чтобы не проверять ни один. Если переменная не задана, Claude Code проверяет серверы, описанные в разделе Среды выполнения клиента MCP. Любое другое значение игнорируется с предупреждением в логе отладки. Требуется Claude Code v2.1.221 или новее |
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE |
Максимальное количество удалённых MCP-серверов (HTTP/SSE), подключаемых параллельно при запуске (по умолчанию: 20) |
MCP_SDK_GENERATION |
Закрепить среду выполнения клиента MCP, с помощью которой этот процесс подключается к MCP-серверам: v1, построенную на MCP TypeScript SDK 1.x, или v2, построенную на MCP TypeScript SDK 2.0. Без этой переменной Claude Code использует v2, начиная с версий, перечисленных в том разделе. В Claude Code v2.1.221 или новее среда выполнения v2 проверяет издателя, которого сервер MCP OAuth возвращает в ответе авторизации, и при несовпадении завершает вход с ошибкой, начинающейся с Issuer mismatch in authorization response. Среда выполнения v1 эту проверку не выполняет. Если вы зададите нераспознанное значение, Claude Code проигнорирует его и запишет предупреждение в лог отладки. Claude Code считывает значение один раз за процесс. Требуется Claude Code v2.1.218 или новее |
MCP_SERVER_CONNECTION_BATCH_SIZE |
Максимальное количество локальных MCP-серверов (stdio), подключаемых параллельно при запуске (по умолчанию: 3) |
MCP_TIMEOUT |
Таймаут в миллисекундах для запуска MCP-сервера (по умолчанию: 30000, или 30 секунд) |
MCP_TOOL_TIMEOUT |
Таймаут в миллисекундах для выполнения инструмента MCP (по умолчанию: 100000000, около 28 часов). Для HTTP-, SSE-сервера или коннектора claude.ai каждый запрос также по умолчанию завершается по таймауту через 60 секунд; задайте этой переменной или параметру timeout отдельного сервера значение больше 60000, чтобы увеличить этот лимит на запрос. Меньшее значение по-прежнему сокращает общий таймаут выполнения инструмента, но оставляет лимит на запрос равным 60 секундам. У stdio- и WebSocket-серверов нет таймера на запрос. Поле timeout отдельного сервера в .mcp.json переопределяет это значение для данного сервера. Значение timeout отдельного сервера не менее 1000 также задаёт минимальное окно простоя для вызовов инструментов этого сервера, поэтому CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT никогда не прерывает их раньше; для этого нижнего порога требуется Claude Code v2.1.203 или новее. Для переменной окружения значения ниже 1000 повышаются до одной секунды; для поля отдельного сервера значения ниже 1000 игнорируются |
NO_PROXY |
Список доменов и IP-адресов, запросы к которым отправляются напрямую, в обход прокси |
OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT |
Стандартное ограничение OpenTelemetry SDK на длину значения атрибута. Claude Code ограничивает атрибуты телеметрии с содержимым меньшим из этого значения и CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH, чтобы маркер усечения оставался в пределах ограничения SDK. Claude Code так же считывает варианты OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT и OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT, и наименьшее заданное значение применяется ко всем сигналам. Требуется Claude Code v2.1.214 или новее. См. Мониторинг |
OTEL_LOG_ASSISTANT_RESPONSES |
Установите значение 1, чтобы включать текст ответа модели в события лога OpenTelemetry assistant_response. Если переменная не задана, Claude Code использует вместо неё значение OTEL_LOG_USER_PROMPTS. Установите 0, чтобы ответы оставались скрытыми, даже если задана OTEL_LOG_USER_PROMPTS. Задайте её в оболочке, пользовательских настройках или управляемых настройках. Игнорируется в настройках проекта и локальных настройках. Требуется Claude Code v2.1.193 или новее. См. Мониторинг |
OTEL_LOG_MANAGED_SETTINGS |
Установите значение 1, чтобы добавлять в события лога OpenTelemetry managed_settings_resolved управляемые настройки со скрытыми данными и дайджест SHA-256 настроек до скрытия. По умолчанию отключено. Задайте её в оболочке, пользовательских настройках или управляемых настройках; значение в настройках проекта или локальных настройках её не включает. Требуется Claude Code v2.1.274 или новее. См. Мониторинг |
OTEL_LOG_RAW_API_BODIES |
Отправлять JSON запросов и ответов Anthropic Messages API в виде событий лога api_request_body / api_response_body. Установите 1 для встроенных тел, усечённых по лимиту содержимого, или file:<dir>, чтобы записывать неусечённые тела на диск и отправлять вместо них путь body_ref. Лимит содержимого настраивается через CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH, по умолчанию 60 КБ. По умолчанию отключено; тела включают всю историю диалога. Задайте её в оболочке, пользовательских настройках или управляемых настройках. Игнорируется в настройках проекта и локальных настройках. См. Мониторинг |
OTEL_LOG_TOOL_CONTENT |
Установите значение 1, чтобы включать содержимое инструментов в событие спана OpenTelemetry tool.output. Атрибуты спанов передают содержимое инструментов с учётом собственных ограничений. Требуется трассировка. По умолчанию отключено для защиты конфиденциальных данных. Задайте её в оболочке, пользовательских настройках или управляемых настройках. Игнорируется в настройках проекта и локальных настройках, за исключением значений отключения, описанных в том разделе. См. Мониторинг |
OTEL_LOG_TOOL_DETAILS |
Установите значение 1, чтобы включать в метрики, трассировки и логи OpenTelemetry аргументы ввода инструментов; имена MCP-серверов; имена рабочих процессов, созданных пользователями; необработанные строки ошибок при сбоях инструментов; category отказа в событиях api_refusal; реальные имена агентов, скиллов, плагинов и MCP-серверов в метриках стоимости и токенов; и другие сведения об инструментах. По умолчанию отключено для защиты персональных данных. Задайте её в оболочке, пользовательских настройках или управляемых настройках. Игнорируется в настройках проекта и локальных настройках, за исключением значений отключения, описанных в том разделе. См. Мониторинг |
OTEL_LOG_USER_PROMPTS |
Установите значение 1, чтобы включать текст пользовательских промптов в трассировки и логи OpenTelemetry. По умолчанию отключено (промпты скрываются). Задайте её в оболочке, пользовательских настройках или управляемых настройках. Игнорируется в настройках проекта и локальных настройках, за исключением значений отключения, описанных в том разделе. См. Мониторинг |
OTEL_METRICS_INCLUDE_ACCOUNT_UUID |
Установите значение false, чтобы исключить UUID учётной записи из атрибутов метрик (по умолчанию: включён). См. Мониторинг |
OTEL_METRICS_INCLUDE_ENTRYPOINT |
Установите значение true, чтобы включить точку входа сессии в атрибуты метрик (по умолчанию: исключена). Добавлено в v2.1.152. См. Мониторинг |
OTEL_METRICS_INCLUDE_REPOSITORY |
Установите значение true, чтобы помечать метрики и события OpenTelemetry атрибутами vcs.*, идентифицирующими репозиторий сессии (по умолчанию: исключены). Требуется Claude Code v2.1.269 или новее. См. Атрибуты репозитория |
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES |
Начиная с v2.1.161, Claude Code добавляет ключи OTEL_RESOURCE_ATTRIBUTES к меткам точек данных метрик. Установите значение false, чтобы исключить их (по умолчанию: включены). См. Мониторинг |
OTEL_METRICS_INCLUDE_SESSION_ID |
Установите значение false, чтобы исключить идентификатор сессии из атрибутов метрик (по умолчанию: включён). См. Мониторинг |
OTEL_METRICS_INCLUDE_VERSION |
Установите значение true, чтобы включить версию Claude Code в атрибуты метрик (по умолчанию: исключена). См. Мониторинг |
SLASH_COMMAND_TOOL_CHAR_BUDGET |
Переопределить бюджет символов для метаданных скиллов, показываемых инструменту Skill. Бюджет динамически масштабируется как 1% контекстного окна, с резервным значением 8 000 символов. Устаревшее имя сохранено для обратной совместимости |
TASK_MAX_OUTPUT_LENGTH |
Удалена в v2.1.277 вместе с инструментом TaskOutput, размер вывода которого она задавала, и теперь ни на что не влияет. Ранее задавала максимальное количество символов вывода фоновой задачи, которое сохранял инструмент TaskOutput. Теперь Claude читает файл вывода фоновой задачи с помощью Read |
USE_BUILTIN_RIPGREP |
Установите значение 0, чтобы использовать установленный в системе rg вместо rg, входящего в состав Claude Code |
VERTEX_REGION_CLAUDE_3_5_HAIKU |
Переопределить регион для Claude 3.5 Haiku при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_3_5_SONNET |
Переопределить регион для Claude 3.5 Sonnet при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_3_7_SONNET |
Переопределить регион для Claude 3.7 Sonnet при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_0_OPUS |
Переопределить регион для Claude 4.0 Opus при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_0_SONNET |
Переопределить регион для Claude 4.0 Sonnet при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_1_OPUS |
Переопределить регион для Claude 4.1 Opus при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_5_OPUS |
Переопределить регион для Claude Opus 4.5 при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_5_SONNET |
Переопределить регион для Claude Sonnet 4.5 при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_6_OPUS |
Переопределить регион для Claude Opus 4.6 при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_6_SONNET |
Переопределить регион для Claude Sonnet 4.6 при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_7_OPUS |
Переопределить регион для Claude Opus 4.7 при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_8_OPUS |
Переопределить регион для Claude Opus 4.8 при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_5_5_OPUS |
Переопределить регион для Claude Opus 5.5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.280 |
VERTEX_REGION_CLAUDE_5_5_SONNET |
Переопределить регион для Claude Sonnet 5.5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.284 |
VERTEX_REGION_CLAUDE_5_OPUS |
Переопределить регион для Claude Opus 5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.219 |
VERTEX_REGION_CLAUDE_5_SONNET |
Переопределить регион для Claude Sonnet 5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.197 |
VERTEX_REGION_CLAUDE_FABLE_5 |
Переопределить регион для Claude Fable 5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.170 |
VERTEX_REGION_CLAUDE_FABLE_5_1 |
Переопределить регион для Claude Fable 5.1 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.257 |
VERTEX_REGION_CLAUDE_HAIKU_4_5 |
Переопределить регион для Claude Haiku 4.5 при использовании Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_HAIKU_5_5 |
Переопределить регион для Claude Haiku 5.5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.293 |
Также поддерживаются стандартные переменные экспортёра OpenTelemetry (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES и варианты для отдельных сигналов). Подробности конфигурации см. в разделе Мониторинг.
Задавайте CLAUDE_CODE_ENABLE_TELEMETRY и переменные OpenTelemetry, которые включают экспорт, выбирают его место назначения или захватывают содержимое, в оболочке, пользовательских настройках или управляемых настройках. Claude Code игнорирует их в настройках проекта и локальных настройках, за исключением значений отключения, описанных в том разделе. OTEL_RESOURCE_ATTRIBUTES и переменные интервала экспорта, таймаута и сжатия, такие как OTEL_METRIC_EXPORT_INTERVAL, по-прежнему применяются из настроек проекта и локальных настроек.
Что удаляет очистка окружения подпроцессов
Если вы задаёте для CLAUDE_CODE_SUBPROCESS_ENV_SCRUB значение 1, Claude Code удаляет учётные данные из окружений запускаемых им подпроцессов, таких как команды Bash, хуки и stdio MCP-серверы. Это сокращает объём данных, которые может прочитать атака с промпт-инъекцией. Процесс Claude Code сохраняет учётные данные для собственных вызовов API.
Очистка распознаёт учётные данные по имени переменной или по виду её значения, поэтому используйте её как один из уровней защиты наряду с узкими правилами разрешений, а не как единственный механизм контроля.
В таблице показано, что очистка делает с примерами переменных:
| Пример переменной | Что делает очистка |
|---|---|
ANTHROPIC_API_KEY, AWS_SECRET_ACCESS_KEY |
Удаляет её |
NPM_TOKEN, DB_PASSWORD |
Удаляет её, потому что имя похоже на учётные данные |
DATABASE_URL, содержащая пароль |
Удаляет её, потому что значение похоже на учётные данные |
PIP_INDEX_URL или NPM_CONFIG_REGISTRY, содержащая пароль |
Сохраняет URL, но вырезает из него имя пользователя и пароль |
CLAUDE_CONFIG_DIR |
Удаляет её |
GITHUB_TOKEN, GH_TOKEN, GH_ENTERPRISE_TOKEN, GITHUB_ENTERPRISE_TOKEN |
Оставляет её на месте, чтобы gh и скрипты, обращающиеся к API GitHub, продолжали работать |
HTTP_PROXY, HTTPS_PROXY |
Оставляет её на месте, включая имя пользователя и пароль в URL. Песочница может сама задавать эти переменные для команд, выполняемых в песочнице |
GIT_CONFIG_COUNT, GIT_CONFIG_KEY_<n>, GIT_CONFIG_VALUE_<n> |
Оставляет её на месте, независимо от содержимого |
| Секрет, имя переменной и значение которого не похожи на учётные данные | Оставляет его на месте |
Поскольку очистка оставляет GITHUB_TOKEN на месте, предоставляйте заданию GitHub Actions минимально необходимые permissions. Чтобы удалить токен GitHub из команд Bash, выполняемых в песочнице, добавьте запись deny в sandbox.credentials.
Не задавайте очистку, если подпроцессу нужна одна из удаляемых переменных.
В Linux очистка также запускает подпроцессы Bash в изолированном пространстве имён PID, чтобы они не могли читать окружения процессов хоста через /proc. В качестве побочного эффекта ps, pgrep и kill не могут видеть процессы хоста или отправлять им сигналы.
До версии v2.1.251 очистка удаляла ANTHROPIC_API_KEY и AWS_SECRET_ACCESS_KEY и оставляла остальные примеры переменных из таблицы без изменений.
Функции, которым нужна загрузка флагов функций
Claude Code включает некоторые функции с помощью флагов функций, которые он загружает от Anthropic. Claude Code пропускает эту загрузку в следующих сессиях:
- Сессия, в которой вы задали
DISABLE_GROWTHBOOK,DISABLE_TELEMETRY,DO_NOT_TRACKилиCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC; в строке каждой переменной в таблице переменных указано, какие значения отключают загрузку - Сессия у стороннего провайдера, например Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform или Microsoft Foundry, если только хост-платформа, встраивающая Claude Code, не задаёт
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST - Сессия через шлюз приложений Claude
Когда загрузка отключена, вы не можете:
- Запустить
/auto-mode-setup, чтобы подготовить записиautoMode.environment - Использовать Remote Control, если задана
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICилиDISABLE_GROWTHBOOK. ДляDISABLE_TELEMETRYиDO_NOT_TRACKсм. требования Remote Control - Отправлять сообщения в сессии за пределами этой машины, когда Remote Control недоступен. Обмен сообщениями между сессиями на этой машине работает и при отключённой загрузке
- Запустить
claude importили команду/import - Запустить
/skill-doctorили открыть его отчёт на вкладке Stats в/plugin - Синхронизировать скиллы и плагины, включённые для вашей учётной записи claude.ai, с вашими сессиями в терминале
- Использовать инструмент-советник
- Читать комментарии к артефакту или отвечать на них
- Поручать Claude читать публичный артефакт другой организации
- Получать инструмент PowerShell по умолчанию для учётных записей claude.ai и Console в Windows с установленным Git Bash; Claude Code направляет shell-команды через Git Bash, если вы не задали
CLAUDE_CODE_USE_POWERSHELL_TOOL=1. В Windows без Git Bash инструмент остаётся включённым - Получать отзывы, составленные Claude, которые Claude Code включает через загружаемый флаг
- Добиться того, чтобы Claude воспринимал большие вставки как вставленный, а не набранный текст; содержимое за заполнителем
[Pasted text #N]поступает к Claude без пометки - Добиться того, чтобы Claude Code исключал MCP-инструменты, схему входных данных которых API отклонил бы; он всё равно отправляет схему, и запрос, который её содержит, завершается ошибкой 400, указывающей инструмент по его позиции
Первая сессия после установки или обновления
В вашей первой сессии после установки Claude Code или обновления до версии, в которой добавлена функция, функция, зависящая от флага, может отсутствовать. Эта сессия также может начаться в другом режиме разрешений, чем ваши последующие сессии. Когда Claude Code загружает флаги во время этой сессии, он сохраняет их на машине, поэтому в вашей следующей сессии на этой машине функция будет доступна, а сессия начнётся в обычном режиме разрешений.
После новой установки в неинтерактивной сессии, например claude -p, Agent SDK или расширении VS Code, Claude Code может получить флаги до того, как выберет начальный режим разрешений, но он не всегда их дожидается.
В таких конфигурациях, как описанные ниже, сессии после первой тоже начинаются без только что загруженных флагов:
- Чистое окружение при каждом запуске: если каждый запуск начинается в CI-контейнере или любом другом окружении без флагов, сохранённых предыдущей сессией, каждый запуск является первой сессией
- Токен шлюза без API-ключа: если вы аутентифицируетесь с помощью
ANTHROPIC_AUTH_TOKENбез API-ключа, аANTHROPIC_BASE_URLуказывает на хост, отличный от хоста Anthropic, например на LLM-шлюз, у Claude Code нет учётных данных для загрузки флагов
Чтобы выбрать режим разрешений, в котором начинаются сессии в таких конфигурациях, см. Запуск в другом режиме разрешений.
См. также
- Параметры: все конфигурация
settings.json, включая ключenv - Справочник CLI: флаги времени запуска
- Конфигурация сети: настройка прокси и TLS
- Мониторинг: конфигурация OpenTelemetry