Claude Code environment variables: настройка переменных в 2026

Claude Code environment variables нужны, когда Claude Code запускается из терминала, автоматизации или через корпоративный шлюз. Для обычной работы сначала используйте официальное приложение Claude Code и вход в аккаунт, а переменные добавляйте только под конкретную задачу: API-ключ, прокси, Bedrock, Vertex AI или особый путь Git Bash.

Когда переменная нужна, а когда нет

Официальная инструкция Anthropic предлагает несколько способов входа: Anthropic Console, тариф Claude App и корпоративные платформы. После установки команда claude doctor помогает проверить тип установки; варианты входа и проверка описаны в руководстве по настройке Claude Code. Если интерактивный вход уже работает, добавлять ANTHROPIC_API_KEY ради «ускорения» не нужно.

Переменная окружения принадлежит процессу Claude Code и влияет только на запуски, которые её получили. Разовая переменная удобна для проверки. Постоянная настройка нужна для повторяемого запуска, но секрет нельзя хранить в репозитории, CLAUDE.md, общем settings.json или снимке терминала.

Правило выбора: сначала определите поставщика и способ входа, затем задавайте только его переменные. Одновременная настройка обычного API, стороннего шлюза и облачной платформы создаёт не резерв, а неоднозначность.

Карта результата и безопасная граница

Исходная ситуация: Claude Code установлен, но ему нужен внешний параметр или авторизация для конкретного окружения. Ожидаемый результат: команда запуска видит только нужные имена переменных, секрет не попадает в вывод и репозиторий, а claude doctor не сообщает об ошибке конфигурации.

• Обязательные шаги: выбрать способ входа, определить область действия, задать переменную, перезапустить процесс и проверить без печати значения.
• Проверка: оболочка подтверждает наличие имени, Claude Code запускается из той же сессии, а тестовая команда возвращает ответ.
• Частые сбои: переменная задана в другом окне, имя написано с ошибкой, старое значение осталось в профиле, одновременно активны несовместимые способы входа.
• Ограничение: переменная не устанавливает Claude Code, не создаёт аккаунт и не выдаёт доступ к модели.
• Способ не подходит для общего компьютера без защищённого хранилища секретов или для проекта, где значение попадёт в версионируемый файл.

Если установка ещё не закончена, сначала пройдите пошаговую установку Claude Code, а уже после отделяйте проблему запуска от проблемы переменных.

Какие переменные встречаются чаще всего

Для прямого доступа к Anthropic API используется ANTHROPIC_API_KEY. Anthropic рекомендует выделенный ключ и защищённое хранилище для программного запуска в документации Claude Code SDK. Не вставляйте реальное значение в пример команды, задачу агенту или сообщение поддержки.

Для LLM-шлюза официальная схема использует ANTHROPIC_AUTH_TOKEN и ANTHROPIC_BASE_URL. Anthropic указывает, что apiKeyHelper имеет более низкий приоритет, чем ANTHROPIC_AUTH_TOKEN или ANTHROPIC_API_KEY, в руководстве по LLM gateway. Практический вывод: при неожиданном маршруте сначала ищите старые переменные авторизации, а не меняйте адрес шлюза наугад.

Для сетевого прокси Claude Code учитывает HTTPS_PROXY, HTTP_PROXY и NO_PROXY: последняя переменная задаёт адреса, которые нужно обходить без прокси. SOCKS-прокси не поддерживаются; для собственного центра сертификации Anthropic рекомендует NODE_EXTRA_CA_CERTS в официальной инструкции по прокси. Значения NO_PROXY можно перечислять через пробел или запятую, а * отключает прокси для всех запросов.

Для Amazon Bedrock и Google Vertex AI используются отдельные переключатели CLAUDE_CODE_USE_BEDROCK и CLAUDE_CODE_USE_VERTEX вместе с учётными данными выбранного облака. Не копируйте их в обычную API-настройку. На Windows специальная переменная CLAUDE_CODE_GIT_BASH_PATH нужна только при нестандартном расположении bash.exe, что также показано в официальной инструкции установки.

Разовая настройка на macOS и Linux

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

export ANTHROPIC_API_KEY='значение_из_защищённого_хранилища'
[ -n "$ANTHROPIC_API_KEY" ] && echo 'переменная задана' || echo 'переменная отсутствует'
claude doctor
claude

Проверочная команда сообщает только наличие, но не печатает ключ. Если запуск успешен, перенесите получение секрета в менеджер секретов или системное хранилище. Строка с реальным ключом в ~/.zshrc или ~/.bashrc остаётся обычным текстом и требует осознанной защиты прав доступа.

Для несекретного параметра, например адреса внутреннего шлюза, постоянную строку можно добавить в профиль оболочки, затем открыть новый терминал. Для секретов безопаснее вызывать команду хранилища при старте сессии или использовать apiKeyHelper, чем оставлять значение в файле.

По теме: Claude overloaded: что значит ошибка и как восстановить работу

Настройка в PowerShell на Windows

В PowerShell переменная текущего процесса задаётся через пространство Env:. Такой тест помогает отделить проблему Claude Code от настроек профиля пользователя.

$env:ANTHROPIC_API_KEY = 'значение_из_защищённого_хранилища'
if ($env:ANTHROPIC_API_KEY) { 'переменная задана' } else { 'переменная отсутствует' }
claude doctor
claude

Не используйте команду, которая выводит $env:ANTHROPIC_API_KEY целиком. Для постоянного значения Windows предлагает пользовательскую область окружения, но секрет и там остаётся доступен программам этого пользователя. На рабочем устройстве следуйте политике компании и предпочитайте утверждённое хранилище.

Где хранить несекретные настройки проекта

Claude Code поддерживает пользовательские, общие проектные, локальные проектные и управляемые настройки. Приоритет идёт от управляемой политики и аргументов командной строки к локальному, общему и пользовательскому уровню; иерархия приведена в официальном разделе Identity and Access Management.

Общий .claude/settings.json подходит только для безопасных значений, которые команда намеренно хранит вместе с проектом. Машинные пути и секреты держите в локальной настройке или вне проекта. Перед публикацией репозитория проверьте git diff и поиск по именам секретов, не по их значениям.

Права на чтение файлов и выполнение команд не заменяются переменной окружения. Их настраивают отдельно. Руководство по Claude permissions помогает не смешивать авторизацию API с разрешениями агента на компьютере.

По теме: Claude Code Router: установка и безопасная настройка в 2026

Диагностика по симптому

1. Claude Code пишет, что ключ отсутствует: проверьте имя без вывода значения и запустите claude из того же окна.
2. Переменная есть, но используется другой аккаунт или шлюз: временно уберите конфликтующие ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN и ANTHROPIC_BASE_URL, затем добавляйте по одной.
3. Ошибка соединения возникает только в корпоративной сети: проверьте HTTPS_PROXY, доверенный сертификат и разрешённые домены по инструкции Anthropic.
4. Настройка работает в терминале, но не в приложении: приложение было запущено раньше и не получило новое окружение. Полностью закройте его и откройте снова либо используйте его собственный вход.
5. На Windows не найден Bash: проверьте существование bash.exe и задавайте CLAUDE_CODE_GIT_BASH_PATH только для реального пути.
6. Проблема остаётся: выполните claude doctor, сохраните текст ошибки без ключей и сравните с проверками статуса Claude.

Чек-лист перед запуском

• Выбран ровно один основной способ авторизации.
• Имя переменной сверено с официальной документацией.
• Реальное значение не находится в файлах проекта и истории сообщений.
• Проверка выводит только статус «задана» или «отсутствует».
• Claude Code перезапущен после изменения окружения.
• Прокси и сертификат добавлены только при подтверждённой сетевой необходимости.
• После теста временные значения удалены из общей машины.

Частые вопросы

Нужно ли задавать ANTHROPIC_API_KEY при входе через Claude App?

Обычно нет. Если вход через подписку работает, API-ключ создаст другой способ оплаты и авторизации. Добавляйте его только для прямого API или автоматизации, где он действительно нужен.

Можно ли положить ключ в .env?

Технически программу можно научить читать такой файл, но Claude Code не требует этого как универсального способа. Файл легко случайно закоммитить, поэтому он должен быть исключён из Git и защищён, а предпочтительнее использовать менеджер секретов.

Почему export не работает в другом окне?

Команда меняет окружение текущей оболочки и запускаемых из неё процессов. Новое окно получает настройки из своего профиля, а уже запущенное приложение не обновляет окружение задним числом.

Как проверить ключ, не показывая его?

Проверяйте только наличие и запускайте безопасную тестовую команду. Не используйте echo или printenv с именем секретной переменной в записи экрана, журнале CI или сообщении поддержки.