Как настроить Claude Code с apmix за две минуты

Claude Code — терминальный агент Anthropic для программирования: он читает ваш репозиторий, редактирует файлы, запускает команды и пишет тесты. Он работает с API Anthropic, а apmix предоставляет тот же самый API. Поэтому Claude Code можно запускать на ключе apmix — с моделями Claude из вашего тарифа и одной месячной квотой вместо отдельного счёта от Anthropic.

Настройка займёт около двух минут. Нужны аккаунт apmix с API-ключом (создайте его в панели управления) и Node.js 18 или новее.

1. Установите Claude Code#

Пропустите этот шаг, если claude у вас уже запускается.

npm install -g @anthropic-ai/claude-code

2. Направьте его на apmix#

Claude Code читает три переменные окружения. Поскольку он работает по протоколу Anthropic, Base URL — это https://api.apmix.ai без /v1; путь Claude Code добавит сам.

В macOS или Linux:

export ANTHROPIC_BASE_URL="https://api.apmix.ai"
export ANTHROPIC_AUTH_TOKEN="apx_live_YOUR_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"

В Windows, в PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.apmix.ai"
$env:ANTHROPIC_AUTH_TOKEN = "apx_live_YOUR_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"

Эти значения действуют только в текущем терминале. Для первой пробы этого достаточно; следующий шаг сохранит их навсегда.

3. Сохраните настройки#

Claude Code также читает настройки из ~/.claude/settings.json. Добавьте те же значения в блок env, и каждый новый терминал будет готов к работе:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apmix.ai",
    "ANTHROPIC_AUTH_TOKEN": "apx_live_YOUR_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

В документации есть однострочники для PowerShell и bash, которые запишут этот файл за вас и сохранят резервную копию старого.

4. Запустите#

Откройте проект и запустите Claude Code:

cd your-project
claude

Готово: теперь каждый запрос идёт через apmix и списывается с квоты вашего тарифа.

Смена модели командой /model#

Внутри Claude Code введите /model, чтобы сменить модель для текущей сессии. Подойдёт любой идентификатор Claude из каталога:

У каждой модели свой множитель взвешенных токенов — он указан на странице цен. Если для рутины брать модель полегче, та же квота продержится гораздо дольше; подробнее — в статье взвешенные токены: объясняем.

Проверьте, работает ли ключ#

Если что-то не так, запросите список моделей, доступных вашему ключу. Если в ответ пришёл список в JSON, ключ и URL указаны верно:

curl https://api.apmix.ai/v1/models -H "Authorization: Bearer apx_live_YOUR_KEY"

Самые частые ответы и что с ними делать:

• 401 invalid_api_key: ключ неверный или удалён. Скопируйте его заново в разделе «Панель управления → API-ключи».
• 403 model_not_in_plan: модель выше вашего тарифа. GET /v1/models показывает только то, что доступно вашему тарифу; выберите модель из списка или перейдите на старший тариф.
• 429 rate_limit_exceeded: больше 60 запросов в минуту на один ключ (120 на Max). Подождите столько секунд, сколько указано в retry-after.

Все ошибки описаны в справочнике ошибок, а в каждом ответе есть заголовок x-apmix-request-id — укажите его, если пишете в поддержку.

Следите за расходом#

Агенты прожорливы: длинная сессия Claude Code может отправить миллионы токенов. Помогут три вещи:

1. Смотрите Панель управления → Логи: там в реальном времени видно каждый запрос с моделью, токенами и стоимостью.
2. Задайте в настройках необязательные дневные или недельные лимиты, чтобы вышедшая из-под контроля сессия не съела весь месяц.
3. Включите письма-уведомления при 50, 70, 80 или 90% квоты.

С такими настройками Claude Code на apmix ощущается точно так же, как обычный Claude Code, — а всё остальное, чем вы пользуетесь, живёт на одном ключе и одном счёте.