SpyBara
Go Premium

env-vars.md 2026-10-03 23:57 UTC to 2026-10-04 19:59 UTC

This page contains 360 additions and 321 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Sun 4 21:01

Переменные окружения

Справочник по переменным окружения, которые управляют поведением Claude Code.

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

На этой странице рассматривается, как:

Установка переменных окружения

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

В вашей оболочке

Установите переменную перед запуском claude:

export API_TIMEOUT_MS="1200000"
claude

Чтобы установить её для каждого сеанса, добавьте строку export в ~/.bashrc, ~/.zshrc или файл профиля вашей оболочки.

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

echo $API_TIMEOUT_MS

В файлах параметров

Добавьте переменные под ключом env в файл settings.json, создав файл, если его ещё нет. Claude Code читает их непосредственно из файла, поэтому они вступают в силу независимо от того, как был запущен claude. Работающий сеанс применяет новые и изменённые значения к своему окружению при сохранении файла, но функция, которая читает свои переменные один раз при запуске, такая как мониторинг OpenTelemetry, сохраняет свои значения при запуске до перезапуска. Удаление переменной из файла не отменяет её в работающем сеансе; удаление вступает в силу при следующем запуске claude.

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

Выбранный вами файл определяет, к кому применяются переменные:

Файл Применяется к
~/.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.

Переменная Назначение
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 минуты). Значение по умолчанию больше 30 минут также становится лимитом времени для фоновых команд по умолчанию в сессиях без участия пользователя. Лимит времени для фоновых команд требует 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-эндпоинт для подробной бета-трассировки: при 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.198 и v2.1.199 автопродолжение было включено по умолчанию с таймаутом 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 Таймаут зависания субагентов в миллисекундах. По умолчанию 600000 (10 минут); если вы увеличите CLAUDE_STREAM_IDLE_TIMEOUT_MS при включённом сторожевом таймере потока, значение по умолчанию увеличится вместе с ней, как описано в разделе Обработка медленных или зависших ответов API. Таймер сбрасывается при каждом событии прогресса потоковой передачи; если в течение этого окна прогресс не поступает, Claude Code прерывает субагента и сообщает о зависании родительскому агенту
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, чтобы оставить видимым нативный курсор терминала и отключить индикатор курсора в виде инвертированного текста. Позволяет экранным лупам, таким как Zoom в macOS, отслеживать положение курсора
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 включает это автоматически для фоновых сессий и представления агентов в 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. Применяется везде, где Claude Code подписывает запросы с помощью цепочки по умолчанию: 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, чтобы неинтерактивная сессия сообщала своему хосту о статусе простоя в конце каждого хода, даже пока фоновая работа ещё выполняется. По умолчанию сессия продолжает сообщать статус выполнения после окончания хода, пока фоновая работа, например фоновый агент или запуск workflow, ещё активна. Это не позволяет хосту, который отслеживает статус, например списку удалённых сессий, объявить посреди работы, что 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. Если задана, варианты моделей с 1M недоступны в меню выбора модели, а Claude Code ограничивает сессии на моделях с нативным окном 1M, таких как Sonnet 5.5 и модели Fable, окном 200K; о том, как обеспечивается это ограничение, см. Расширенный контекст. Полезно для корпоративных сред с требованиями соответствия нормативам. О её роли в корректировке окна для нераспознанного ID модели [1m] см. Корректировка окна для ID модели шлюза или пользовательской модели
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING Задайте 1, чтобы отключить адаптивные рассуждения в Opus 4.6 и Sonnet 4.6 и вернуться к фиксированному бюджету мышления, задаваемому MAX_THINKING_TOKENS. Не влияет на модели Fable, Sonnet 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, чтобы отключить фоновых агентов и представление агентов: claude agents, --bg, /background и супервизор, запускаемый по требованию. Эквивалентна настройке disableAgentView
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN Задайте 1, чтобы отключить полноэкранную отрисовку и использовать классическую отрисовку в основном экране. Диалог остаётся в нативной истории прокрутки терминала, поэтому Cmd+f и режим копирования tmux работают как обычно. Имеет приоритет над CLAUDE_CODE_NO_FLICKER и настройкой tui. Переключиться также можно командой /tui default. Не применяется к фоновым сессиям, открытым из представления агентов, которые всегда используют полноэкранную отрисовку
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-команды, динамические workflow и, начиная с v2.1.198, фоновые субагенты останавливались, а не передавались следующему процессу сессии. Влияет только на эту передачу: перевод сессии в фон с помощью ← или /background по-прежнему переносит выполняющуюся работу, а CLAUDE_DISABLE_ADOPT отключает и то и другое. Требуется Claude Code v2.1.196 или новее
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP Задайте 1, чтобы Claude Code не завершал фоновые bash-команды при нехватке памяти. По умолчанию в macOS и Linux Claude Code завершает фоновые оболочки, когда операционная система сообщает о критической нехватке памяти, а сессия простаивает 30 минут без выполняющегося хода или субагента. В Windows нет сигнала нехватки памяти, поэтому там эта переменная ни на что не влияет. Требуется Claude Code v2.1.193 или новее
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS Задайте 1, чтобы отключить скиллы и workflow, входящие в комплект Claude Code: встроенные скиллы и workflow удаляются полностью, а встроенные команды, такие как /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 отправляет их в callback 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 или моделях 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, чтобы в Windows запускать команды инструмента PowerShell напрямую, а не через средство запуска cmd.exe. По умолчанию средство запуска позволяет команде PowerShell, выполняющейся в фоне, перейти к следующему процессу сессии, например когда вы переводите сессию в фон. Если задать эту переменную, команда PowerShell, переведённая в фон, останавливается при завершении процесса сессии. Команды Bash не затрагиваются. Требуется Claude Code v2.1.269 или новее
CLAUDE_CODE_DISABLE_WORKFLOWS Задайте 1, чтобы отключить workflow. Эквивалентна настройке disableWorkflows
CLAUDE_CODE_EFFORT_LEVEL Задаёт уровень effort для поддерживаемых моделей. Значения: low, medium, high, xhigh, max или auto, чтобы использовать значение модели по умолчанию. Доступные уровни зависят от модели. Имеет приоритет над --effort, /effort и настройками modelSettings и effortLevel. Ограничение maxEffortLevel по-прежнему применяется. См. Настройка уровня effort
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_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 2026), когда ваш терминал его поддерживает, но не определяется автоматически. Полезно для эмуляторов, таких как Emacs eat, которые реализуют BSU/ESU, но не отвечают на проверку возможностей. Не действует под tmux. В отличие от CLAUDE_CODE_NO_FLICKER, которая переключает на полноэкранный рендеринг, эта переменная не меняет рендерер
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_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, чтобы показывать собственный курсор терминала в позиции ввода вместо нарисованного блока. Курсор учитывает настройки мигания, формы и фокуса терминала
CLAUDE_CODE_NEW_INIT Установите 1, чтобы /init запускал интерактивный процесс настройки. Он спрашивает, какие файлы создать, включая CLAUDE.md, скиллы и хуки, прежде чем исследовать кодовую базу и записать их. Без этой переменной /init создаёт CLAUDE.md автоматически, ничего не спрашивая
CLAUDE_CODE_NONBLOCKING_STDOUT Установите 1, чтобы записывать вывод в терминал через второй неблокирующий файловый дескриптор, чтобы терминал, который перестал читать, например приостановленная панель tmux в режиме управления или зависшее SSH-соединение, не мог заморозить Claude Code посреди сессии. Применяется в macOS, Linux и WSL, когда stdout является терминалом. Требуется Claude Code v2.1.261 или новее
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES Ограничивает, сколько раз Claude Code повторно отправляет непотоковый запрос, превысивший таймаут. При 0 запрос завершается ошибкой при первом же таймауте. По умолчанию не задана, поэтому эти повторные отправки ограничивает CLAUDE_CODE_MAX_RETRIES. О таймауте см. Настройка поведения повторных попыток. Требуется Claude Code v2.1.285 или новее
CLAUDE_CODE_NO_FLICKER Установите 1, чтобы включить полноэкранный рендеринг — research preview, который уменьшает мерцание и сохраняет постоянный объём используемой памяти в длинных диалогах. Переопределяет настройку tui; переключиться также можно с помощью /tui fullscreen
CLAUDE_CODE_OAUTH_REFRESH_TOKEN OAuth refresh-токен для аутентификации Claude.ai. Если задан, claude auth login напрямую обменивает этот токен вместо открытия браузера. Требует CLAUDE_CODE_OAUTH_SCOPES. Полезно для предоставления аутентификации в автоматизированных средах
CLAUDE_CODE_OAUTH_SCOPES Разделённые пробелами OAuth scope, с которыми был выдан refresh-токен, например "user:profile user:inference user:sessions:claude_code". Обязательна, если задана CLAUDE_CODE_OAUTH_REFRESH_TOKEN
CLAUDE_CODE_OAUTH_TOKEN OAuth access-токен для аутентификации 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_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_GIT_TIMEOUT_MS Таймаут в миллисекундах для клонирования или обновления маркетплейса плагинов (по умолчанию: 120000). Увеличьте это значение для больших репозиториев или медленных сетевых подключений. См. Таймаут git clone
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 пользовательских или управляемых настроек, а не через export в оболочке, чтобы отсоединённая фоновая служба её унаследовала; настройки проекта и локальные настройки не могут её задать. Эквивалентна настройке 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_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 Установите 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 по-прежнему учитывает ответ «отключено вашей организацией»
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 ждёт загрузки скилла, когда вызывает этот скилл. Требуется аутентификация claude.ai. Терминальные сессии, в которых вы входите с аккаунтом claude.ai, загружают эти скиллы в ~/.claude/skills/synced/ и повторно синхронизируют их примерно каждые 10 минут без этой переменной, поэтому задавайте её, только когда запуску -p нужны ваши актуальные скиллы уже в первом запросе. До v2.1.273 терминальные сессии загружали их только в запуске -p с заданной этой переменной. Имя папки synced зарезервировано для этой загрузки. До v2.1.227 скиллы загружались непосредственно в ~/.claude/skills/. Claude Code применяет дополнительные правила к загруженным скиллам, например не выполняет их команды ! на вашей машине
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, а в v2.1.246 или новее — и команды инструмента Monitor. Записывайте размер цифрами: без суффикса — в байтах, либо с суффиксом 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_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 Сколько агентов одновременно выполняет один запуск workflow, от 1 до 256. По умолчанию запуск выполняет до 16 агентов одновременно, меньше, если Claude Code доступно меньше процессоров; вызовы agent() в очереди ждут свободного слота. Транскрипт каждого работающего агента хранится в памяти Claude Code, поэтому более высокие значения увеличивают потребление оперативной памяти. Принимаются только цифры; значения вне диапазона и другие записи оставляют значение по умолчанию. Требуется Claude Code v2.1.269 или новее
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS Верхний предел в миллисекундах для времени, в течение которого агент workflow ждёт начала первого ответа соседнего агента с тем же префиксом, прежде чем отправить собственный первый запрос. Когда при распараллеливании запускается несколько агентов с общим префиксом кэша промптов, 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, чтобы включить подробную бета-трассировку, которая добавляет атрибуты span с содержимым и span claude_code.hook. Для интерактивных сессий CLI также требуется, чтобы ваша организация была включена в список допущенных к бета-версии. Обе переменные игнорируются в настройках проекта и локальных настройках
ENABLE_CLAUDEAI_MCP_SERVERS Задайте false, чтобы Claude Code не получал MCP-серверы claude.ai. По умолчанию включено для пользователей, выполнивших вход. Чтобы отключить для отдельного проекта или организации, задайте вместо этого в настройках disableClaudeAiConnectors
ENABLE_PROMPT_CACHING_1H Задайте 1, чтобы запрашивать часовой TTL кэша промптов вместо 5 минут по умолчанию. Предназначено для пользователей API-ключей, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform on AWS. Пользователи подписки в рамках включённого использования автоматически получают часовой TTL для основного диалога. Пользователи подписки, расходующие кредиты использования, могут задать эту переменную, чтобы сохранить часовой TTL. Запись в кэш с часовым TTL тарифицируется по более высокой ставке. Чтобы выбирать 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, чтобы принудительно использовать 5-минутный TTL кэша промптов, даже если в ином случае применялся бы часовой TTL. Переопределяет 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. Claude Code показывает предупреждение, если вывод превышает 10 000 токенов. Инструменты, объявляющие anthropic/maxResultSizeChars, используют для текстового содержимого этот лимит символов, но изображения от таких инструментов по-прежнему подчиняются этой переменной (по умолчанию: 25000)
MAX_STRUCTURED_OUTPUT_RETRIES Число попыток, которое Claude Code допускает, когда ответ модели не проходит проверку по --json-schema в неинтерактивном режиме с флагом -p; после такого числа неудачных попыток без корректного вывода запуск завершается ошибкой. Тот же предел действует, когда структурированный вывод субагента workflow не проходит проверку. По умолчанию 5: первая попытка плюс четыре повторные попытки
MAX_THINKING_TOKENS Фиксированный бюджет токенов для расширенного мышления. Claude Code ограничивает его значением на один токен меньше максимального числа выходных токенов запроса и никогда не ниже 1 024. О том, как задаётся этот предел, см. CLAUDE_CODE_MAX_OUTPUT_TOKENS. Если переменная не задана и мышление включено, модели с адаптивными рассуждениями сами выбирают глубину мышления, а другие модели используют предел. Задайте 0, чтобы отключить мышление в Anthropic API, кроме Opus 5.5, Sonnet 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 проверяет издателя, которого OAuth-сервер MCP возвращает в ответе авторизации, и при несовпадении завершает вход ошибкой, начинающейся с 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, чтобы включать содержимое инструментов в событие span OpenTelemetry tool.output. Атрибуты span передают содержимое инструментов согласно собственным условиям. Требуется трассировка. По умолчанию отключено для защиты конфиденциальных данных. Задавайте в оболочке, пользовательских или управляемых настройках. Игнорируется в настройках проекта и локальных настройках, за исключением значений отключения, описанных в том разделе. См. Мониторинг
OTEL_LOG_TOOL_DETAILS Задайте 1, чтобы включать входные аргументы инструментов; имена MCP-серверов; имена workflow, созданных пользователями; исходные строки ошибок при сбоях инструментов; category отказа в событиях api_refusal; реальные имена агентов, скиллов, плагинов и MCP-серверов в метриках стоимости и токенов; и другие сведения об инструментах в метриках, трассировках и логах OpenTelemetry. По умолчанию отключено для защиты персональных данных. Задавайте в оболочке, пользовательских или управляемых настройках. Игнорируется в настройках проекта и локальных настройках, за исключением значений отключения, описанных в том разделе. См. Мониторинг
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

Также поддерживаются стандартные переменные экспортёра 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 Удаляет её. Требуется Claude Code v2.1.251 или новее
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 не могут видеть процессы хоста или отправлять им сигналы.

Функции, которым нужна загрузка флагов функций

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

Когда загрузка отключена, вы не можете:

Первая сессия после установки или обновления

В вашей первой сессии после установки 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 нет учётных данных для загрузки флагов

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

См. также