Skip to main content

​
Храните API Key безопасно

Используйте переменные окружения и не хардкодьте ключ. Если записать API Key прямо в код или конфигурационный файл, его легко случайно отправить в систему контроля версий. Рекомендуемый вариант:
Для Claude Code лучше хранить секреты в поле env файла settings.json, а не раскрывать их в shell-конфигурации:
Периодически ротируйте API Key. Если подозреваете утечку, сразу удалите ключ в панели управления и создайте новый.

​
Задайте большой timeout

Ответы AI-моделей могут занимать время, особенно при сложных задачах reasoning. Укажите достаточно большой timeout, чтобы соединение не обрывалось раньше времени:
3000000 мс = 50 минут. Это подходит для глубокого reasoning и длинных agentic-задач.

​
Очистите конфликтующие переменные окружения

Если вы раньше использовали официальные API Anthropic или OpenAI либо другой прокси-сервис, старые переменные окружения могут переопределить настройки BetterToken и незаметно отправить запросы не на тот endpoint. Перед настройкой BetterToken проверьте и очистите:

​
Claude Code: сначала проверьте провайдер

С провайдером Claude не задавайте ANTHROPIC_MODEL, ANTHROPIC_SMALL_FAST_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и другие переменные конкретных моделей. С провайдером GPT добавьте сопоставления через ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_OPUS_MODEL. Не смешивайте эти два режима, иначе запросы могут попасть не в ту модель. Отключите необязательный трафик. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 уменьшает фоновые запросы Claude Code и оставляет квоту для реальных задач разработки. Не добавляйте /v1 в Claude Code. ANTHROPIC_BASE_URL должен быть https://bettertoken.ai.

​
Используйте один API Key в нескольких инструментах

Один и тот же API Key работает в Claude Code, Codex и внешних инструментах. Квота общая, поэтому управлять доступом проще. Но endpoint должен соответствовать протоколу:
  • Claude Code / ANTHROPIC_BASE_URL: https://bettertoken.ai
  • Codex / OPENAI_BASE_URL / внешние инструменты: https://bettertoken.ai/v1
Если нужно отдельно отслеживать расход по проектам или командам, создайте несколько API Key в панели управления и назначьте отдельный ключ каждому инструменту или проекту. Для внешних инструментов копируйте ID модели у провайдера GPT в model plaza.

​
Чеклист диагностики

  1. Проверьте API Key — сверитесь с панелью управления и вставьте ключ без лишних пробелов
  2. Проверьте endpoint по протоколу — Claude Code использует https://bettertoken.ai, Codex / внешние инструменты используют https://bettertoken.ai/v1
  3. Проверьте конфликтующие env vars — выполните echo $ANTHROPIC_AUTH_TOKEN, echo $OPENAI_BASE_URL и похожие команды
  4. Проверьте официальные требования инструмента — для внешних инструментов сначала проверьте Base URL, API Key, ID модели и версию клиента; добавляйте headers только если это требует документация инструмента или ваш upstream gateway
  5. Проверьте баланс — запросы отклоняются, когда баланс исчерпан
  6. Обратитесь в поддержку — если предыдущие шаги не помогли