GetCheapAI

Использование API-посредника в Claude Code

Как указать Claude Code свой адрес API через переменные окружения или settings.json.

2 мин чтения

Claude Code умеет отправлять запросы на указанный вами адрес API — достаточно задать соответствующие переменные окружения или записать их в файл конфигурации. В этой статье описано, как направить Claude Code на API-посредник, совместимый с интерфейсом Anthropic.

Что нужно подготовить

Перед началом получите у платформы API, которой вы пользуетесь, следующие данные:

  • Адрес API (Base URL): корневой адрес интерфейса, который предоставляет платформа
  • Ключ API (Key): токен для аутентификации
  • Название модели: идентификатор модели, которую платформа поддерживает и которую вы собираетесь использовать

Способ 1: переменные окружения

Задайте в терминале следующие переменные окружения (их можно записать в ~/.zshrc или ~/.bashrc, чтобы они действовали постоянно):

export ANTHROPIC_BASE_URL="https://example.com"   # замените на адрес API, который предоставляет платформа
export ANTHROPIC_AUTH_TOKEN="your-key"            # замените на свой ключ API
export ANTHROPIC_MODEL="your-model-name"          # замените на название модели, которую поддерживает платформа

После этого откройте терминал заново и запустите claude — настройки вступят в силу.

Способ 2: settings.json

Те же значения можно записать в файл конфигурации Claude Code ~/.claude/settings.json (глобальный) или в .claude/settings.json внутри проекта:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://example.com",
    "ANTHROPIC_AUTH_TOKEN": "your-key",
    "ANTHROPIC_MODEL": "your-model-name"
  }
}

Если в конфигурации есть ключ API, лучше использовать .claude/settings.local.json, который не попадает в систему контроля версий.

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

  • Появляется 404: некоторые сервисы чувствительны к завершающему слешу — попробуйте добавить или убрать / в конце адреса API.
  • Название модели не совпадает: Claude Code не преобразует названия моделей автоматически — укажите то название, которое распознает платформа.
  • В графическом приложении настройки не работают: приложения с графическим интерфейсом, запущенные из дока или через ярлык, не читают переменные окружения, заданные в терминале.
  • Конфликт с подпиской: если вы одновременно вошли в аккаунт с подпиской Claude, указанный вами адрес API переопределит подписку; чтобы вернуться к официальному сервису, достаточно удалить приведенные выше настройки.

Узнать больше