Переменные окружения - самый мощный и самый тупой рычаг настройки: они действуют глобально на процесс, а иногда и на его подпроцессы. Поэтому их полезно делить на две категории. Первая - рабочее ядро, которое команды действительно трогают: провайдер, аутентификация, соответствие моделей. Вторая - диагностические, облачные и совместимостные переключатели, которые трогают редко и по конкретному поводу. Этот справочник даёт карту важнейших переменных по группам; полный документированный индекс - на официальной странице env vars.
Провайдер и аутентификация - первая и самая важная группа. ANTHROPIC_API_KEY имеет приоритет аутентификации и может незаметно перевести с подписки на API-биллинг; ANTHROPIC_BASE_URL перенаправляет на gateway; CLAUDE_CODE_USE_BEDROCK и CLAUDE_CODE_USE_VERTEX включают облачных провайдеров, а ANTHROPIC_DEFAULT_*_MODEL сопоставляет алиасы с deployment-ID. Смешивать переменные нескольких провайдеров в одном shell нельзя - /status здесь обязательное доказательство того, куда идёт трафик.
Остальные группы трогают точечно. Поведение и лимиты: MAX_THINKING_TOKENS, CLAUDE_CODE_MAX_OUTPUT_TOKENS. Платформа: CLAUDE_CODE_GIT_BASH_PATH для Windows, USE_BUILTIN_RIPGREP для своего rg, CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE для обновления через менеджер. Телеметрия: CLAUDE_CODE_ENABLE_TELEMETRY и семейство OTEL_*. Механизмы: ENABLE_TOOL_SEARCH для MCP tool search, CLAUDE_CODE_DISABLE_CRON для планировщика. Ниже - карта ключевых переменных по группам.
Главное правило этого справочника: наличие переменной в индексе не означает совет её включить. Многие существуют ради поддержки, миграций, облачных провайдеров или аварийной диагностики, и включённая без понимания переменная - это доступ или поведение, которое вы не заметили, что задали. Особенно осторожны с переключателями, отключающими проверки и телеметрию. Точный набор и поведение зависят от версии и провайдера, поэтому сверяются с официальной страницей, а фактический эффект проверяют через /status и claude doctor.
| Группа | Переменная | Назначение |
|---|---|---|
| Провайдер/auth | ANTHROPIC_API_KEY | Ключ API; приоритет над подпиской (меняет биллинг) |
| ANTHROPIC_BASE_URL | Перенаправление на gateway |
| CLAUDE_CODE_USE_BEDROCK / _USE_VERTEX | Включить AWS Bedrock / Google Vertex |
| ANTHROPIC_DEFAULT_*_MODEL | Сопоставление алиасов с deployment-ID |
| Поведение/лимиты | MAX_THINKING_TOKENS | Бюджет extended thinking |
|---|
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | Макс. выходных токенов запроса |
| Платформа | CLAUDE_CODE_GIT_BASH_PATH | Путь к Git Bash (Windows) |
|---|
| USE_BUILTIN_RIPGREP | 0 - использовать системный rg |
| CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE | Обновление через brew/winget |
| Телеметрия | CLAUDE_CODE_ENABLE_TELEMETRY / OTEL_* | Включение и настройка OpenTelemetry |
|---|
| Механизмы | ENABLE_TOOL_SEARCH | MCP tool search (только при поддержке proxy) |
|---|
| CLAUDE_CODE_DISABLE_CRON | Отключить планировщик |