Понимание приоритета аутентификации в Claude Code
При использовании Claude Code важно понимать, как расставляются приоритеты методов аутентификации, чтобы избежать неожиданных расходов на API и убедиться, что вы используете нужный аккаунт.
Как работает аутентификация
Claude Code отдает приоритет ключам API переменных окружения перед аутентифицированными подписками.
Это намеренное поведение, разработанное для предоставления вам гибкости в выборе метода аутентификации.
Когда ключ API установлен как переменная окружения, вам будут выставлены счета по тарифам API pay-as-you-go с использованием аккаунта API, связанного с этим ключом.
Это происходит даже если вы вошли в Claude Code с подпиской claude.ai или другим аккаунтом Console.
Лучшие практики
Для использования Claude Code с вашей подпиской Claude: Оставьте переменную окружения ANTHROPIC_API_KEY неустановленной.
Это предотвращает неожиданные расходы на API и гарантирует, что вы используете включенное в подписку использование.
Если вам нужно использовать конкретный ключ API время от времени, устанавливайте его временно только при необходимости.
Периодически запускайте /status в Claude Code для проверки вашего текущего метода аутентификации.
Предупреждения о конфликтах аутентификации
Claude Code уведомит вас о конфликте между вашей аутентифицированной подпиской и ключом API переменной окружения:
При первоначальной настройке, если в переменных окружения обнаружен ключ API, Claude Code попросит вас подтвердить, какой метод аутентификации вы хотите использовать.
После успешного входа вы увидите уведомление, если оба учетных данных активны, предупреждающее вас о возможности неожиданных расходов на API.
Проверка вашей текущей конфигурации
Чтобы проверить, установлен ли ключ API как переменная окружения, запустите /status в Claude Code. Это покажет вам, какой метод аутентификации в настоящее время активен.
Чтобы проверить переменную окружения напрямую, запустите одну из этих команд в терминале (вне Claude Code):
macOS/Linux:
echo $ANTHROPIC_API_KEY
Windows CMD:
echo %ANTHROPIC_API_KEY%
Windows PowerShell:
echo $env:ANTHROPIC_API_KEY
Временная установка ключа API
Если вам нужно использовать ключ API только для текущего сеанса терминала:
macOS/Linux:
export ANTHROPIC_API_KEY='your-api-key-here'
Windows CMD:
set ANTHROPIC_API_KEY=your-api-key-here
Windows PowerShell:
$env:ANTHROPIC_API_KEY="your-api-key-here"
Постоянная установка переменной окружения ключа API
macOS/Linux:
Для zsh (по умолчанию на macOS):
bash
# Добавьте в файл конфигурации оболочки
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Примените изменения
source ~/.zshrc
Для bash:
bash
# Добавьте в файл конфигурации оболочки
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bash_profile
# Примените изменения
source ~/.bash_profile
Windows:
Откройте System Properties → Advanced → Environment Variables
В разделе "User variables" нажмите "New"
Имя переменной: ANTHROPIC_API_KEY
Значение переменной: your-api-key-here
Нажмите OK и перезагрузите терминал
Удаление переменной окружения ключа API
macOS/Linux (временно):
unset ANTHROPIC_API_KEY
macOS (постоянно):
# Удалите из файла конфигурации
sed -i '' '/ANTHROPIC_API_KEY/d' ~/.zshrc
source ~/.zshrc
Linux (постоянно)
sed -i '/ANTHROPIC_API_KEY/d' ~/.zshrc
Windows CMD:
set ANTHROPIC_API_KEY=
Windows PowerShell:
Remove-Item Env:ANTHROPIC_API_KEY
Windows (постоянно): Удалите переменную из параметров System Environment Variables.
Распространенные проблемы, которых следует избегать
Установка переменных окружения в файлы конфигурации оболочки и забывание о них.
Неперезагрузка терминала после изменения переменных окружения.
Предположение, что вы используете вашу подписку, когда ключ API настроен в вашем окружении.
Если у вас есть вопросы, пожалуйста, свяжитесь с нашей командой поддержки.