При использовании Claude Code важно понимать, как приоритизируются методы аутентификации, чтобы избежать неожиданных расходов на API и убедиться, что вы используете нужный аккаунт.
Как работает аутентификация
Claude Code отдает приоритет ключам API переменных окружения перед аутентифицированными подписками.
Это намеренное поведение, разработанное для предоставления вам гибкости в выборе метода аутентификации.
Когда ключ API установлен как переменная окружения, вам будут выставлены счета по тарифам API с оплатой по мере использования, используя аккаунт 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:
For zsh (default on macOS):
bash
# Add to shell config file
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Apply changes
source ~/.zshrc
For bash:
bash
# Add to shell config file
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bash_profile
# Apply changes
source ~/.bash_profile
Windows:
Откройте Свойства системы → Дополнительно → Переменные окружения
В разделе «Переменные пользователя» нажмите «Создать»
Имя переменной: ANTHROPIC_API_KEY
Значение переменной: your-api-key-here
Нажмите OK и перезагрузите терминал
Удалите переменную окружения ключа API
macOS/Linux (временно):
unset ANTHROPIC_API_KEY
macOS (постоянно):
# Remove from config file
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 (постоянно): Удалите переменную из параметров переменных окружения системы.
Распространенные проблемы, которых следует избежать
Установка переменных окружения в файлы конфигурации оболочки и забывание о них.
Перезагрузка терминала после изменения переменных окружения.
Предположение, что вы используете вашу подписку, когда ключ API настроен в вашем окружении.
Если у вас есть вопросы, пожалуйста, свяжитесь с нашей командой поддержки.