Переменные среды 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"

Пример

// Настроить в settings.json
{
  "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, чтобы оптимизировать затраты:

Пример

# Основной диалог использует Opus для сложных рассуждений, субагенты единообразно используют 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: Режим планирования только для чтения, без операций записи

Пример

# Использовать режим только для чтения в среде CI
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

Пример

# Доступ к Claude API через внутренний корпоративный прокси
export ANTHROPIC_BASE_URL="https://proxy.company.com/anthropic/v1"
export ANTHROPIC_API_KEY="your-api-key"

Сценарий 2: Оптимизация конфигурации затрат

Пример

# Основной диалог использует Sonnet, субагенты единообразно используют Haiku
export ANTHROPIC_MODEL="claude-sonnet-4-5"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-haiku-3-5"

Сценарий 3: Конфигурация безопасности среды CI/CD

Пример

# Использовать режим только для чтения в среде CI
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

Пример

# Включить PowerShell в Windows
$env:CLAUDE_CODE_USE_POWERSHELL_TOOL = "1"
# Задать defaultShell в settings.json

Приоритет и переопределение

Приоритет переменных среды (от высокого к низкому):

  1. Командная строкаexportНастройки
  2. Уровень проекта.claude/settings.json
  3. Уровень пользователя~/.claude/settings.json
  4. Значения по умолчанию 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переменную среды.

Другие расширения