← Блог
Claude CodeРуководствоНастройка

Как настроить Claude Code с доступным API-провайдером

· Обновлено (цены в тексте следуют актуальному прайс-листу)

Короткий ответ

Чтобы запустить Claude Code через APIVAI, задайте две переменные окружения: ANTHROPIC_BASE_URL="https://api.apivai.com" и ANTHROPIC_AUTH_TOKEN="<ваш ключ>", затем запускайте claude как обычно. Claude Code принимает любой API-ключ, совместимый с Anthropic, через ANTHROPIC_AUTH_TOKEN. Сам Claude Code не меняется: запросы идут к тем же моделям Claude, а оплата списывается с предоплаченного баланса по ценам APIVAI, например $1.15 / $5.74 за миллион входных / выходных токенов для Claude Sonnet 4.6 (на 2026-10-10), что на 62% ниже официального прайса. Настройка занимает около пяти минут.

Что такое Claude Code?

Claude Code — консольный агент для программирования от Anthropic. Вы запускаете его в папке проекта, описываете задачу обычным языком, а он читает файлы, предлагает и вносит правки, запускает команды вроде тестов или сборки и объясняет, что сделал. Anthropic рекомендует собственный установщик (curl -fsSL https://claude.ai/install.sh | bash на macOS и Linux, irm https://claude.ai/install.ps1 | iex в Windows PowerShell); пакет npm @anthropic-ai/claude-code тоже работает и требует Node.js 22 или новее. Claude Code описан в документации Anthropic по Claude Code.

Каждый шаг Claude Code — это API-запрос к модели Claude, а агент, работающий с настоящей кодовой базой, отправляет с каждым запросом много контекста. Поэтому цена за токен для Claude Code важнее, чем для редкого чата. По умолчанию он оплачивается через API Anthropic по прайсу ($3.00 / $15.00 за миллион токенов для Claude Sonnet 4.6). Подробнее о цифрах — в статье как снизить расходы на Claude Code и GPT API.

Как Claude Code работает со сторонним API-провайдером?

Claude Code берёт настройки подключения из переменных окружения:

  • ANTHROPIC_BASE_URL — куда отправлять запросы. Для APIVAI это https://api.apivai.com, без /v1 и без слэша в конце, потому что Claude Code сам добавляет /v1/messages.
  • ANTHROPIC_AUTH_TOKEN — ключ, который отправляется с каждым запросом.

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

Что понадобится

  • Установленный Claude Code (собственный установщик или npm с Node.js 22+; claude --version должна вывести версию)
  • Аккаунт APIVAI с пополненным балансом
  • API-ключ, созданный в Dashboard APIVAI
  • Терминал: bash или zsh на macOS/Linux, PowerShell или cmd на Windows

Шаг 1. Получите API-ключ для Claude Code

  1. Зарегистрируйтесь по email и коду подтверждения из письма.
  2. Пополните баланс. Минимум — $10 картой или криптовалютой, либо ¥20 через Alipay / WeChat Pay. Подписки и ежемесячного минимума нет.
  3. В Dashboard создайте API-ключ. Дайте ему имя, например «claude-code-laptop», и задайте бюджет. Когда ключ израсходует бюджет, он перестанет работать, так что вышедшая из-под контроля сессия не потратит весь баланс.
  4. Скопируйте ключ и никому его не показывайте. Используйте отдельный ключ для каждой машины или проекта: так расходы видны раздельно, и один ключ можно отозвать, не трогая остальные.

Шаг 2. Настройте терминал

macOS и Linux

Добавьте эти строки в профиль оболочки — ~/.zshrc (по умолчанию на macOS) или ~/.bashrc:

export ANTHROPIC_BASE_URL="https://api.apivai.com"
export ANTHROPIC_AUTH_TOKEN="ваш-ключ-apivai"

Перечитайте профиль и запустите Claude Code:

source ~/.zshrc   # или: source ~/.bashrc
claude

Windows PowerShell

Откройте профиль командой notepad $PROFILE (создайте файл, если PowerShell сообщит, что его нет) и добавьте:

$env:ANTHROPIC_BASE_URL = "https://api.apivai.com"
$env:ANTHROPIC_AUTH_TOKEN = "ваш-ключ-apivai"

Откройте новое окно PowerShell и запустите claude.

Windows cmd

setx сохраняет пользовательские переменные окружения навсегда:

setx ANTHROPIC_BASE_URL "https://api.apivai.com"
setx ANTHROPIC_AUTH_TOKEN "ваш-ключ-apivai"

setx не меняет окно, в котором вы его запустили: изменения действуют для терминалов, открытых после этого. Закройте окно, откройте новое и запустите claude. Переменные, заданные так, видит и PowerShell.

Альтернатива: файл настроек Claude Code

Вместо переменных оболочки их можно прописать в пользовательский файл настроек Claude Code — ~/.claude/settings.json (на Windows %USERPROFILE%\.claude\settings.json) — в объект env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apivai.com",
    "ANTHROPIC_AUTH_TOKEN": "ваш-ключ-apivai"
  }
}

Если файл уже существует, добавьте в него блок env, а не заменяйте файл целиком. Так настройка действует только для Claude Code. Расположение файлов и приоритеты могут меняться от версии к версии, поэтому актуальные детали смотрите в документации Anthropic по настройкам Claude Code.

Шаг 3. Проверьте ключ до запуска Claude Code

Прямой запрос покажет, в порядке ли ключ, адрес и сеть, ещё до участия Claude Code. На macOS/Linux, с загруженными переменными из шага 2:

curl https://api.apivai.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":50,"messages":[{"role":"user","content":"Say hello"}]}'

В PowerShell:

$body = '{"model":"claude-haiku-4-5","max_tokens":50,"messages":[{"role":"user","content":"Say hello"}]}'
Invoke-RestMethod -Uri "https://api.apivai.com/v1/messages" -Method Post -ContentType "application/json" -Headers @{ "x-api-key" = $env:ANTHROPIC_AUTH_TOKEN; "anthropic-version" = "2023-06-01" } -Body $body

JSON-ответ с полем content означает, что всё работает, а запрос через несколько секунд появится в Dashboard. Код ошибки подскажет нужную строку в таблице решения проблем ниже. Обратите внимание: в тестовом адресе есть /v1/messages, а в ANTHROPIC_BASE_URL его быть не должно.

Как выбрать и переключить модель?

Введите /model в Claude Code, чтобы выбрать модель для текущей сессии. Основные варианты на 2026-10-10 (полный список — на странице цен):

МодельЦена APIVAI за 1M (вход / выход)Для чего
Claude Fable 5.1$4.42 / $22.08Самые сложные задачи, долгая автономная работа
Claude Opus 5.5$1.54 / $7.65Сложный код, рефакторинг, анализ
Claude Sonnet 5.5$0.77 / $3.82Повседневное программирование: рекомендуемый выбор
Claude Sonnet 4.6$1.15 / $5.74Широко поддерживается; Sonnet 5.5 новее и дешевле
Claude Haiku 4.5$0.38 / $1.92Быстрые правки и простые вопросы

Практичный подход: начинайте с Sonnet, переключайтесь на Opus через /model, когда задача застряла или требует более глубоких рассуждений, и возвращайтесь обратно, когда она решена.

Как снизить расходы на Claude Code?

  • Используйте Sonnet для рутины. Большинству правок, тестов и объяснений не нужны Opus или Fable, а Sonnet стоит за токен в разы меньше.
  • Сжимайте длинные сессии. В Claude Code есть команда /compact, которая подытоживает разговор, чтобы следующие запросы несли меньше контекста. Используйте её, когда сессия разрослась, или начинайте новую сессию для новой задачи (актуальное поведение команд — в документации Anthropic).
  • Позвольте работать кэшированию промптов. Claude Code автоматически кэширует повторяющийся контекст — системные промпты и файлы. Кэшированный вход оплачивается по цене чтения кэша ($0.12 за 1M для Claude Sonnet 4.6), что намного ниже обычного входа.
  • Задайте бюджет на ключ. Ключ останавливается на своём бюджете, что ограничивает расходы любой машины, проекта или коллеги.
  • Следите за Dashboard. Там видны все запросы с моделью, токенами и стоимостью, так что легко понять, какие сессии дорогие.

Codex CLI с тем же ключом

Тот же ключ APIVAI работает с Codex CLI от OpenAI, который использует формат OpenAI с /v1 в base URL. Для Codex 0.121 и новее поместите это в ~/.codex/config.toml (на Windows %USERPROFILE%\.codex\config.toml):

model = "gpt-5.5"
model_provider = "apivai"

[model_providers.apivai]
name = "APIVAI"
base_url = "https://api.apivai.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Затем задайте ключ и запустите Codex:

export OPENAI_API_KEY="ваш-ключ-apivai"
codex

Так же это работает в Cursor — см. руководство по настройке Cursor.

Решение проблем

СимптомВероятная причинаЧто делать
401 UnauthorizedНеверный или удалённый ключ, либо ключ израсходовал бюджетСкопируйте ключ заново из Dashboard; увеличьте бюджет ключа или пополните баланс
401 даже с верным ключомClaude Code отправляет другие учётные данные: старую ANTHROPIC_API_KEY, apiKeyHelper или вход через /login (какие активны, показывает /status)Уберите лишнее, например: unset ANTHROPIC_API_KEY (bash/zsh), Remove-Item Env:ANTHROPIC_API_KEY (PowerShell), и уберите из профилей и настроек
404 Not FoundВ base URL есть /v1 или опечаткаДля Claude Code используйте ровно https://api.apivai.com; /v1 — только для инструментов формата OpenAI, например Codex
429 Too Many RequestsБольше 60 запросов в минуту на один ключПодождите немного или попросите поддержку поднять лимит
Claude Code использует старый аккаунтПеременные не загружены в этом терминалеОткройте новый терминал; проверьте echo $ANTHROPIC_BASE_URL или echo $env:ANTHROPIC_BASE_URL
Таймауты или ошибки соединенияПрокси, файрвол или TLS-инспекция в вашей сетиРазрешите api.apivai.com или укажите прокси вашей сети в HTTPS_PROXY (о поддержке прокси в Claude Code — в документации Anthropic)

Если проблема не уходит, выполните curl-тест из шага 3: он отделяет проблемы ключа и сети от настроек Claude Code. В документации перечислены все эндпоинты и ошибки.

Все коды ошибок API и способы их исправить собраны в статье Ошибки Claude API.

Сколько стоит Claude Code в месяц?

Если сообщение — около 4 000 входных и 1 500 выходных токенов с Claude Sonnet 4.6, за 30 дней, на 2026-10-10:

Использование в деньОфициальный APIAPIVAI
Лёгкое (10 сообщений/день)$10.35$3.96
Среднее (30 сообщений/день)$31.05$11.89
Интенсивное (100 сообщений/день)$104$39.63

Эти цифры не учитывают кэширование промптов, которое обычно дополнительно снижает реальный счёт. Сессии агента на больших репозиториях могут отправлять гораздо больше контекста на сообщение, поэтому загляните в Dashboard через первые несколько дней. Актуальные цены — на странице цен; сравнение с подписочными инструментами — в статье Claude Code или Cursor: что дешевле.

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

Нужен ли аккаунт Anthropic, чтобы использовать Claude Code так?

API-ключ Anthropic не нужен. Claude Code отправляет запросы на заданный вами base URL и авторизуется ключом APIVAI.

Модель та же, что в официальном API?

Да. Запросы проходят к моделям Claude, которые вы выбираете через /model; меняются только адрес и оплата.

Можно вернуться на свой аккаунт Anthropic?

Да. Удалите или закомментируйте две переменные (или блок env в settings.json) и откройте новый терминал.

Видит ли APIVAI мой код?

APIVAI не хранит и не просматривает содержимое запросов и ответов. Для биллинга сохраняются только метаданные использования (модель, число токенов, стоимость, время).

Что будет, когда закончится баланс или бюджет ключа?

Запросы будут возвращать 401, пока вы не пополните баланс или не увеличите бюджет ключа. Сверх предоплаченного баланса ничего не списывается.

Можно ли использовать один ключ и для Claude Code, и для Codex?

Да. Один ключ работает с форматом Anthropic (https://api.apivai.com) и с форматами OpenAI (https://api.apivai.com/v1).

Готовы начать?

Получите API-ключ за 30 секунд. Оплата по факту использования Claude и GPT.

Начать