Переменные среды Claude Code
Переменные среды — важный способ управления поведением Claude Code, позволяющий гибко настраивать различные параметры без редактирования файлов конфигурации. В этой главе подробно описаны все переменные среды, поддерживаемые Claude Code, их назначение, способы настройки и типичные сценарии использования.
Обзор переменных среды
Claude Code использует переменные среды для управления поведением. Эти переменные можно задать следующими способами:
- Непосредственно в оболочке
export - В
~/.claude/settings.jsonизenvНастроить в поле - На уровне проекта
.claude/settings.jsonНастроить в - Настроить через интерфейс настроек плагина IDE
Приоритет переменных среды от высшего к низшему: командная строка > settings.json уровня проекта > settings.json уровня пользователя > переменные среды оболочки. Переменные, настроенные в settings.json, автоматически передаются процессу Claude.
Переменные, связанные с аутентификацией
| Имя переменной | Описание | Значение |
|---|---|---|
ANTHROPIC_API_KEY |
Ключ API Claude (полученный на claude.ai) | Строка ключа API |
ANTHROPIC_BASE_URL |
Целевой адрес для запросов API (используется для прокси или пользовательских эндпоинтов) | URL-адрес |
ANTHROPIC_AUTH_TOKEN |
Токен аутентификации (используется для таких сценариев, как плагин VS Code) | Строка токена |
Примеры конфигурации
Пример
export ANTHROPIC_API_KEY="sk-ant-xxxxx"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"
Пример
{
"env": {
"ANTHROPIC_API_KEY": "sk-ant-xxxxx",
"ANTHROPIC_BASE_URL": "https://custom-proxy.com/v1"
}
}
Переменные конфигурации модели
| Имя переменной | Описание | Значение |
|---|---|---|
ANTHROPIC_MODEL |
Модель, используемая по умолчанию | claude-opus-4-5、claude-sonnet-4-5、claude-haiku-3-5ожидание |
ANTHROPIC_SMALL_FAST_MODEL |
Модель, используемая в режиме быстрого ответа (для простых задач) | Название модели |
CLAUDE_CODE_SUBAGENT_MODEL |
Единообразно задаёт модель, используемую всеми субагентами | Название модели |
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS |
Отключить экспериментальные функции при использовании формата Anthropic Messages с Bedrock или Vertex | 1 |
Сценарии использования
Субагенты по умолчанию наследуют модель основного диалога. С помощьюCLAUDE_CODE_SUBAGENT_MODELвы можете единообразно настроить их, поручая простые задачи Haiku, а сложный анализ — Sonnet, чтобы оптимизировать затраты:
Пример
export ANTHROPIC_MODEL="claude-opus-4-5"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-5"
Переменные инструментов и команд
| Имя переменной | Описание | Значение |
|---|---|---|
CLAUDE_CODE_DISABLE_SLASH_COMMANDS |
Отключить все слэш-команды | 1 |
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS |
Отключить встроенные системные промпты, связанные с Git (приоритет выше, чем у параметра в settings.jsonincludeGitInstructions) |
1 |
CLAUDE_CODE_USE_POWERSHELL_TOOL |
Включить инструменты PowerShell в Windows (требуетсяdefaultShell: "powershell"настройку) |
1 |
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL |
Пропустить автоматическую установку расширения IDE (альтернативаautoInstallIdeExtensionнастройку) |
1 |
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS |
Отключить функциональность фоновых задач | 1 |
Переменные разрешений и безопасности
| Имя переменной | Описание | Значение |
|---|---|---|
CLAUDE_CODE_PERMISSION_MODE |
Установить режим разрешений по умолчанию (см. раздел о субагентах для подробностей) | default、acceptEdits、dontAsk、bypassPermissions、plan |
CLAUDE_CODE_ALLOWED_TOOLS |
Белый список инструментов, разрешённых для использования Claude (через запятую) | Список инструментов |
CLAUDE_CODE_DISALLOWED_TOOLS |
Чёрный список инструментов, запрещённых к использованию Claude | Список инструментов |
Объяснение режимов разрешений
default: Обычный запрос разрешения, спрашивать перед каждой операциейacceptEdits: Автоматически принимать правки файлов без разрешенияdontAsk: Автоматически отклонять несанкционированные операции, не прерывая выполнениеbypassPermissions: Пропускать все проверки разрешений (только для полностью доверенных сред)plan: Режим планирования только для чтения, без операций записи
Пример
export CLAUDE_CODE_PERMISSION_MODE="plan"
export CLAUDE_CODE_ALLOWED_TOOLS="Read,Grep,Glob,Bash(gh *)"
Переменные логирования и отладки
| Имя переменной | Описание | Значение |
|---|---|---|
CLAUDE_CODE_DEBUG |
Включить отладочный вывод | 1 |
CLAUDE_CODE_ENABLE_TELEMETRY |
Включить сбор данных телеметрии | 1 |
OTEL_METRICS_EXPORTER |
Экспортер метрик OpenTelemetry | otlpожидание |
Переменные сессии и истории
| Имя переменной | Описание | Значение |
|---|---|---|
CLAUDE_CODE_DISABLE_HISTORY |
Отключить сохранение истории диалога | 1 |
CLAUDE_CODE_SESSION_TIMEOUT |
Тайм-аут сессии (секунды) | Number |
CLAUDE_CODE_MAX_SESSIONS |
Максимальное количество сохранённых сессий | Number |
Переменные, связанные с MCP
Когда Claude Code выполняет инструменты MCP, устанавливаются следующие переменные среды:
| Имя переменной | Описание | Значение |
|---|---|---|
CLAUDE_CODE_MCP_SERVER_NAME |
Имя MCP-сервера | String |
CLAUDE_CODE_MCP_TOOL_NAME |
Имя вызываемого MCP-инструмента | String |
CLAUDE_CODE_MCP_TOOL_ARGS |
Параметры, переданные MCP-инструменту | Строка JSON |
Переменные, связанные с рабочим процессом
| Имя переменной | Описание | Значение |
|---|---|---|
CLAUDE_CODE_WORKTREE_CLEANUP_PERIOD_DAYS |
Цикл автоочистки осиротевших рабочих деревьев | Дни |
CLAUDE_CODE_DISABLE_WORKTREE_AUTO_CLEANUP |
Отключить автоочистку рабочих деревьев | 1 |
Переменные, специфичные для GitHub Actions
| Имя переменной | Описание | Значение |
|---|---|---|
ANTHROPIC_VERTEX_PROJECT_ID |
ID проекта Vertex AI (задаётся на шаге аутентификации при использовании Vertex) | ID проекта GCP |
CLOUD_ML_REGION |
Регион Vertex AI | Код региона (например,us-east5) |
Метод конфигурации settings.json
Все переменные среды можно настроить вsettings.json, который является более декларативным и переносимым:
Пример
"env": {
"ANTHROPIC_MODEL": "claude-sonnet-4-5",
"CLAUDE_CODE_SUBAGENT_MODEL": "claude-haiku-3-5",
"CLAUDE_CODE_PERMISSION_MODE": "plan",
"CLAUDE_CODE_ALLOWED_TOOLS": "Read,Grep,Glob,Bash",
"CLAUDE_CODE_ENABLE_TELEMETRY": "1",
"OTEL_METRICS_EXPORTER": "otlp"
}
}
Конфигурация плагина VS Code
При использовании плагина Claude Code в VS Code вы можете настроитьenvironmentVariablesпараметры:
Пример
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://custom-proxy.com/api"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "your-token-here"
},
{
"name": "ANTHROPIC_MODEL",
"value": "claude-sonnet-4-5"
}
]
}
Типичные сценарии использования
Сценарий 1: Использование прокси или пользовательской конечной точки API
Пример
export ANTHROPIC_BASE_URL="https://proxy.company.com/anthropic/v1"
export ANTHROPIC_API_KEY="your-api-key"
Сценарий 2: Оптимизация конфигурации затрат
Пример
export ANTHROPIC_MODEL="claude-sonnet-4-5"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-haiku-3-5"
Сценарий 3: Конфигурация безопасности среды CI/CD
Пример
export CLAUDE_CODE_PERMISSION_MODE="plan"
export CLAUDE_CODE_DISABLE_HISTORY="1"
export CLAUDE_CODE_ALLOWED_TOOLS="Read,Grep,Glob,Bash(gh *)"
Сценарий 4: Среда Windows PowerShell
Пример
$env:CLAUDE_CODE_USE_POWERSHELL_TOOL = "1"
# Задать defaultShell в settings.json
Приоритет и переопределение
Приоритет переменных среды (от высокого к низкому):
- Командная строка
exportНастройки - Уровень проекта
.claude/settings.json - Уровень пользователя
~/.claude/settings.json - Значения по умолчанию Claude Code
В
settings.jsonПеременные, настроенные в , переопределяют переменные среды оболочки с тем же именем. Это потому, что settings.json явно читается при запуске процесса Claude Code, что дает ему более высокий приоритет.
Просмотр текущей конфигурации
Используйте/configКоманда может просмотреть текущую полную конфигурацию:
/config
Это отобразит все текущие действующие настройки, включая переменные среды и конфигурации в settings.json.
Лучшие практики
1. Обработка конфиденциальной информации
- Конфиденциальную информацию, такую как ключи API, не следует жестко кодировать в settings.json
- Используйте переменные среды или файлы конфигурации оболочки (
~/.bashrc、~/.zshrc) - Убедитесь, что файлы, содержащие конфиденциальную информацию, не находятся под контролем версий git
2. Настройка по средам
- Локальная разработка: используйте более разрешительный режим разрешений
- CI/CD: используйте режим только для чтения
plan - Отладка в production: включить
CLAUDE_CODE_DEBUG
3. Централизованное управление
- Общая конфигурация находится в
~/.claude/settings.json - Конфигурация для конкретного проекта находится в каталоге проекта
.claude/settings.json - Конфиденциальная конфигурация передаётся через переменные среды оболочки или CI Secrets
ЧАВО
Вопрос: Что имеет приоритет — переменные среды или settings.json?
Переменные, настроенные в settings.json, имеют более высокий приоритет и переопределяют переменные среды оболочки с тем же именем.
Вопрос: Как заставить Claude Code использовать другую конечную точку API?
SetANTHROPIC_BASE_URLпеременную среды, указывающую на ваш прокси или пользовательскую конечную точку.
Вопрос: Как субагенты контролируют, какую модель они используют?
Вы можетеCLAUDE_CODE_SUBAGENT_MODELзадать модель для всех субагентов единообразно или указать её отдельно во frontmatter каждого субагента.
Вопрос: Как включить PowerShell в Windows?
Задайте переменную средыCLAUDE_CODE_USE_POWERSHELL_TOOL=1, а также задайте её в settings.jsondefaultShell: "powershell"。
Вопрос: Как отключить все слэш-команды?
SetCLAUDE_CODE_DISABLE_SLASH_COMMANDS=1переменную среды.