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

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

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

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

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

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

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

macOS, Linux, WSL
Windows PowerShell
Windows CMD

export API_TIMEOUT_MS="1200000"
claude

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

$env:API_TIMEOUT_MS = "1200000"
claude

Чтобы установить её для каждого сеанса, запустите [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User") и откройте новый терминал.

set API_TIMEOUT_MS=1200000
claude

Чтобы установить её для каждого сеанса, запустите setx API_TIMEOUT_MS "1200000" и откройте новый терминал.

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

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

~/.claude/settings.json

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

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

Файл	Применяется к
`~/.claude/settings.json`	Вам, в каждом проекте
`.claude/settings.json`	Всем, кто работает в проекте, проверено в системе управления версиями
`.claude/settings.local.json`	Вам, только в этом проекте (добавьте его в ваш gitignore, если вы создадите его вручную)
Управляемые параметры	Всем в вашей организации, развёрнуто администратором

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

Приоритет

Когда одно и то же поведение имеет как переменную окружения, так и поле параметров, переменная окружения имеет приоритет. Например, ANTHROPIC_MODEL переопределяет параметр model, а CLAUDE_CODE_AUTO_CONNECT_IDE переопределяет autoConnectIde. Поле параметров применяется, когда переменная окружения не установлена. Когда одна и та же переменная установлена как в вашей оболочке, так и в файле параметров в блоке env, применяется значение из файла параметров. Claude Code записывает каждую запись env в переменные окружения процесса при запуске, заменяя значение, унаследованное из оболочки. Несколько переменных обрабатываются специально; параметр env содержит список исключений. Между файлами параметров значения env следуют приоритету параметров, поэтому управляемая запись параметров переопределяет ту же переменную в пользовательских или проектных параметрах. То, как переменная окружения взаимодействует с флагами CLI и командами в сессии, варьируется в зависимости от функции: --model и /model переопределяют ANTHROPIC_MODEL, а CLAUDE_CODE_EFFORT_LEVEL переопределяет /effort. Когда переменная взаимодействует с другим источником конфигурации, её строка в списке Переменные указывает приоритет или ссылается на страницу, которая это документирует. Claude Code читает переменные окружения при запуске, поэтому изменения вступают в силу при следующем запуске claude.