> ## Content Index
> Fetch the complete content index at: https://matveev.tech/llms.txt
> Use this file to discover other available public pages before exploring further.

# Переменные окружения Claude Code — полный справочник
- URL: https://matveev.tech/claude-code-environment-variables/
- Published: 2026-02-12T09:12:39.000Z
- Updated: 2026-02-12T09:12:39.000Z
- Description: 50+ переменных окружения Claude Code с описанием и примерами. Группировка по задачам: модели, безопасность, прокси, мониторинг, MCP.
- Author: Pavel Matveev
- Tags: Claude Code, Claude, Dev Tools, Гайд

> **TL;DR:** Claude Code поддерживает 50+ переменных окружения для настройки: модели, провайдеры (Bedrock, Vertex, Foundry), прокси, sandbox, MCP, мониторинг. Их можно задавать в терминале, через `settings.json` или в CI/CD-пайплайнах.

У Claude Code длинный список переменных окружения, и часть из них реально полезна, а часть — для специфических enterprise-сценариев. Я прошёл по документации и разгруппировал их по задачам, чтобы было проще искать нужное.

Все переменные можно также прописать в `settings.json` в секции `env` — тогда не нужно выставлять их в терминале каждый раз.

## Аутентификация и API

| Переменная                 | Зачем                                                                                         |
| -------------------------- | --------------------------------------------------------------------------------------------- |
| ANTHROPIC\_API\_KEY        | API-ключ Anthropic. Для интерактивного использования лучше /login                             |
| ANTHROPIC\_AUTH\_TOKEN     | Кастомный токен для заголовка Authorization (автоматически добавляет Bearer)                  |
| ANTHROPIC\_CUSTOM\_HEADERS | Дополнительные HTTP-заголовки для запросов. Формат: Name: Value, разделитель — перенос строки |

`ANTHROPIC_API_KEY` — основной способ аутентификации для скриптов и CI/CD. Для ежедневной работы проще залогиниться через `/login` — ключ сохранится в `~/.claude.json`.

## Выбор модели

| Переменная                        | Зачем                                                             |
| --------------------------------- | ----------------------------------------------------------------- |
| ANTHROPIC\_MODEL                  | Основная модель. Перебивает дефолт                                |
| CLAUDE\_CODE\_SUBAGENT\_MODEL     | Модель для субагентов (Task-инструмент)                           |
| ANTHROPIC\_DEFAULT\_OPUS\_MODEL   | Кастомное имя для Opus (например, кастомная модель через Bedrock) |
| ANTHROPIC\_DEFAULT\_SONNET\_MODEL | Кастомное имя для Sonnet                                          |
| ANTHROPIC\_DEFAULT\_HAIKU\_MODEL  | Кастомное имя для Haiku                                           |

`ANTHROPIC_MODEL` полезен, когда нужно зафиксировать конкретную версию модели для воспроизводимости. Если не задавать — Claude Code использует последнюю доступную.

## Облачные провайдеры

### Amazon Bedrock

| Переменная                                 | Зачем                                           |
| ------------------------------------------ | ----------------------------------------------- |
| CLAUDE\_CODE\_USE\_BEDROCK                 | Включить Bedrock как провайдер                  |
| CLAUDE\_CODE\_SKIP\_BEDROCK\_AUTH          | Пропустить аутентификацию AWS (для LLM-gateway) |
| AWS\_BEARER\_TOKEN\_BEDROCK                | API-ключ Bedrock                                |
| ANTHROPIC\_SMALL\_FAST\_MODEL\_AWS\_REGION | Регион AWS для Haiku-модели                     |

### Google Vertex AI

| Переменная                           | Зачем                            |
| ------------------------------------ | -------------------------------- |
| CLAUDE\_CODE\_USE\_VERTEX            | Включить Vertex AI как провайдер |
| CLAUDE\_CODE\_SKIP\_VERTEX\_AUTH     | Пропустить аутентификацию Google |
| VERTEX\_REGION\_CLAUDE\_4\_0\_OPUS   | Регион для Opus на Vertex        |
| VERTEX\_REGION\_CLAUDE\_4\_0\_SONNET | Регион для Sonnet на Vertex      |

### Microsoft Azure Foundry

| Переменная                        | Зачем                                |
| --------------------------------- | ------------------------------------ |
| CLAUDE\_CODE\_USE\_FOUNDRY        | Включить Foundry как провайдер       |
| ANTHROPIC\_FOUNDRY\_API\_KEY      | API-ключ Foundry                     |
| ANTHROPIC\_FOUNDRY\_BASE\_URL     | URL ресурса Foundry                  |
| ANTHROPIC\_FOUNDRY\_RESOURCE      | Имя ресурса (альтернатива BASE\_URL) |
| CLAUDE\_CODE\_SKIP\_FOUNDRY\_AUTH | Пропустить аутентификацию Azure      |

Если ты используешь Claude Code через корпоративный облачный провайдер — тебе нужна одна из этих групп. Для прямого подключения к Anthropic API ничего из этого не нужно.

## Поведение bash

| Переменная                                    | Зачем                                                               |
| --------------------------------------------- | ------------------------------------------------------------------- |
| BASH\_DEFAULT\_TIMEOUT\_MS                    | Таймаут по умолчанию для bash-команд                                |
| BASH\_MAX\_TIMEOUT\_MS                        | Максимальный таймаут, который может выставить модель                |
| BASH\_MAX\_OUTPUT\_LENGTH                     | Максимальная длина вывода команды (после этого обрезается)          |
| CLAUDE\_CODE\_SHELL                           | Принудительно задать шелл (если login shell отличается от рабочего) |
| CLAUDE\_CODE\_SHELL\_PREFIX                   | Команда-обёртка для всех bash-команд (логирование, аудит)           |
| CLAUDE\_BASH\_MAINTAIN\_PROJECT\_WORKING\_DIR | Возвращаться в корень проекта после каждой команды                  |

`BASH_DEFAULT_TIMEOUT_MS` — полезный. По умолчанию Claude Code убивает долгие команды. Если у тебя медленные тесты или сборка, увеличь таймаут.

`CLAUDE_CODE_SHELL` пригодится, если login shell у тебя bash, а работаешь ты в zsh. Claude Code определяет шелл автоматически, но иногда ошибается.

## Контекст и токены

| Переменная                                    | Зачем                                              |
| --------------------------------------------- | -------------------------------------------------- |
| CLAUDE\_CODE\_MAX\_OUTPUT\_TOKENS             | Максимум токенов на ответ (дефолт: 32K, макс: 64K) |
| CLAUDE\_CODE\_FILE\_READ\_MAX\_OUTPUT\_TOKENS | Лимит токенов при чтении файлов                    |
| CLAUDE\_AUTOCOMPACT\_PCT\_OVERRIDE            | Порог авто-компактизации контекста (дефолт: \~95%) |
| MAX\_THINKING\_TOKENS                         | Бюджет токенов на «размышления». 0 — отключить     |
| CLAUDE\_CODE\_EFFORT\_LEVEL                   | Уровень усилий: low, medium, high                  |

`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` — если поставить 50, контекст будет компактизироваться раньше. Полезно для долгих сессий, когда не хочешь терять контекст.

`CLAUDE_CODE_EFFORT_LEVEL` работает только с Opus 4.6\. `low` — быстрые ответы для простых задач, `high` — глубокий анализ. По умолчанию `high`.

## MCP

| Переменная               | Зачем                                        |
| ------------------------ | -------------------------------------------- |
| MCP\_TIMEOUT             | Таймаут старта MCP-сервера (мс)              |
| MCP\_TOOL\_TIMEOUT       | Таймаут выполнения MCP-инструмента (мс)      |
| MAX\_MCP\_OUTPUT\_TOKENS | Максимум токенов в ответе MCP (дефолт: 25K)  |
| ENABLE\_TOOL\_SEARCH     | Поиск по MCP-инструментам: auto, true, false |

Если у тебя MCP-сервер медленно стартует, увеличь `MCP_TIMEOUT`. По умолчанию он довольно жёсткий.

## Сеть и прокси

| Переменная                           | Зачем                                     |
| ------------------------------------ | ----------------------------------------- |
| HTTP\_PROXY                          | HTTP-прокси                               |
| HTTPS\_PROXY                         | HTTPS-прокси                              |
| NO\_PROXY                            | Домены, которые идут в обход прокси       |
| CLAUDE\_CODE\_PROXY\_RESOLVES\_HOSTS | Прокси делает DNS-резолв (вместо клиента) |
| CLAUDE\_CODE\_CLIENT\_CERT           | Клиентский сертификат для mTLS            |
| CLAUDE\_CODE\_CLIENT\_KEY            | Приватный ключ для mTLS                   |

Для корпоративных сетей с прокси — эти переменные обязательны. Без них Claude Code не сможет подключиться к API.

## Отключение фич

| Переменная                                   | Зачем                                            |
| -------------------------------------------- | ------------------------------------------------ |
| DISABLE\_TELEMETRY                           | Отключить телеметрию Statsig                     |
| DISABLE\_ERROR\_REPORTING                    | Отключить отправку ошибок в Sentry               |
| DISABLE\_AUTOUPDATER                         | Отключить автообновления                         |
| DISABLE\_COST\_WARNINGS                      | Отключить предупреждения о стоимости             |
| CLAUDE\_CODE\_DISABLE\_NONESSENTIAL\_TRAFFIC | Отключить всё вышеперечисленное одной переменной |
| CLAUDE\_CODE\_DISABLE\_AUTO\_MEMORY          | Отключить автоматическое запоминание             |

`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` — мой фаворит для закрытых окружений. Одна переменная вместо четырёх.

## Часто задаваемые вопросы

**Где лучше задавать переменные — в терминале или settings.json?** Для постоянных настроек — в `settings.json` (секция `env`). Для временных или одноразовых — в терминале перед запуском. Для CI/CD — через системные переменные окружения.

**Переменные окружения сохраняются между bash-командами Claude?** Нет. Каждая bash-команда запускается в чистом шелле. Если нужна персистентность — используй `CLAUDE_ENV_FILE` через SessionStart hook.

**Что приоритетнее — переменная в терминале или в settings.json?** Переменная окружения, заданная в терминале перед запуском Claude Code, перекрывает значение из settings.json.

## Что ещё почитать

- [Настройка Claude Code — полный гайд по settings.json](https://matveev.tech/claude-code-settings-json/) — общий обзор настроек
- [Разрешения в Claude Code — allow, deny и sandbox](https://matveev.tech/claude-code-permissions-sandbox/) — настройка безопасности
- [MCP серверы для Claude — что это и как настроить](https://matveev.tech/claude-mcp-nastrojka/) — расширение через MCP
- [Claude Code Hooks — автоматизация](https://matveev.tech/claude-code-hooks-avtomatizatsiya/) — персистентное окружение через hooks