Доступно

Claude Code через Messages API Токенмоста

Настройка Claude Code с Anthropic-совместимым Messages API: адрес, ключ, модель, тестовый запуск, инструменты и ошибки.

API Токенмоста работает

Базовый адрес — https://tokenmost.ru/v1. Создайте ключ в личном кабинете, выберите модель в каталоге и отправьте первый запрос. Методы, которые ещё не доступны, отмечены отдельно.

Как это устроено

Claude Code умеет направлять запросы к Anthropic-совместимому шлюзу. У Токенмоста открыт POST https://tokenmost.ru/v1/messages; для клиента базовый адрес — https://tokenmost.ru. Передавайте ключ через ANTHROPIC_API_KEY и выбирайте точный ID текстовой модели. Работу агента с tools проверьте отдельно на небольшом тестовом проекте.

Что потребуется

  • Установленный Claude Code и новый терминал без конфликтующих старых переменных провайдера.
  • Аккаунт Токенмоста с положительным балансом и отдельным API-ключом с небольшим бюджетом.
  • Точный ID модели с доступным Messages API; для агентных действий нужна поддержка tool_use/tool_result.

Порядок работы

  1. Создайте отдельный ключ для Claude Code с ограничением бюджета и RPM.
  2. Задайте ANTHROPIC_BASE_URL=https://tokenmost.ru, ANTHROPIC_API_KEY и ANTHROPIC_MODEL в окружении текущего терминала.
  3. Запустите claude в пустом тестовом каталоге. Проверьте выбранную модель и запросите короткий ответ без изменения файлов.
  4. На тестовом проекте разрешите только чтение одного файла и проверьте tool_use/tool_result до задач на запись или запуск команд.
  5. Сверьте историю запросов и списания в кабинете. Если клиент повторяет запросы, остановите задачу и проверьте ошибку и лимиты.

Готовая конфигурация

macOS и Linux

export ANTHROPIC_BASE_URL="https://tokenmost.ru"
export ANTHROPIC_API_KEY="sk-tm-..."
export ANTHROPIC_MODEL="MODEL_ID_FROM_CATALOG"
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://tokenmost.ru"
$env:ANTHROPIC_API_KEY = "sk-tm-..."
$env:ANTHROPIC_MODEL = "MODEL_ID_FROM_CATALOG"
claude

Проверка Messages API до запуска агента

curl "https://tokenmost.ru/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: claude-check-0001" \
  -d '{"model":"MODEL_ID_FROM_CATALOG","max_tokens":32,"messages":[{"role":"user","content":"Ответь одним словом: работает"}]}'

Что учесть

Это конфигурация Anthropic-совместимого маршрута. Конкретный клиент и модель требуют теста на короткой задаче; агент может выполнить несколько платных вызовов за один пользовательский шаг.

Проверка результата

Проверочный HTTP-запрос возвращает content-блок с текстом. После запуска Claude Code ожидается короткий ответ. Отдельно проверьте чтение файла: один успешный текстовый ответ не подтверждает поддержку tool_use выбранной моделью.

Адрес и ключ

Claude Code добавляет путь /v1/messages сам. Укажите https://tokenmost.ru без /v1/messages. ANTHROPIC_API_KEY отправляется как x-api-key; ANTHROPIC_AUTH_TOKEN отправляет Bearer и нужен только при соответствующей схеме шлюза.

Ограничение расходов

Claude Code может делать последовательные и повторные вызовы. Начните с отдельного ключа с низким бюджетом и RPM, короткой задачи и проверки истории. Не запускайте повтор после неизвестного сетевого исхода без сверки операции.

Совместимость клиента

Некоторые функции Claude Code требуют расширений Anthropic API или распознавания модели. Совместимый Messages API не обещает работу всех возможностей клиента и каждой модели; проверяйте tools, streaming и лимиты на своей версии.

Ошибки и диагностика

HTTP 401

Проверьте ANTHROPIC_API_KEY в процессе Claude Code и не смешивайте его с ANTHROPIC_AUTH_TOKEN.

HTTP 404 или путь /v1/messages/v1/messages

Уберите путь метода из ANTHROPIC_BASE_URL: нужен только https://tokenmost.ru.

Модель не найдена

Скопируйте точный ID из каталога и проверьте доступность Messages API для него.

HTTP 400 на max_tokens или tools

Используйте положительный лимит в пределах модели; для agent tools проверьте поддержку tool_use/tool_result.

HTTP 402 или 429

Проверьте доступный баланс, бюджет ключа, RPM и Retry-After; сократите задачу.

Клиент не принимает модель

Проверьте версию Claude Code, выбранный ID и ограничения стороннего шлюза; сначала подтвердите прямой POST /v1/messages.

Источники и связанные инструкции

Читайте дальше

← Все инструкции