Интеграция Claude Code и инструментов Agent

Подключите Claude Code, OpenClaw, Cline, Roo Code и любой клиент с Anthropic-протоколом к TokenHub.

Нативный AnthropicМного-провайдерный резервный режимОдин ключ, оба протокола

1. Как TokenHub говорит на Anthropic

TokenHub одновременно поддерживает два протокола. Один и тот же th- key работает в обоих — биллинг, использование, лимиты расходов и резервное переключение провайдеров унифицированы.

Протокол	Endpoint	Base URL (вставьте это в клиент)	Типичные клиенты
OpenAI-compatible	POST /v1/chat/completions	https://tokenhub.store/api/v1	openai SDK, LiteLLM, LangChain
Нативный Anthropic	POST /v1/messages	https://tokenhub.store/api	Claude Code, OpenClaw, Cline, Roo Code, anthropic SDK

2. Доступные модели Claude

Используйте любой из ID ниже как ANTHROPIC_MODEL или значение поля model. Префикс anthropic/ необязателен — TokenHub принимает оба варианта.

ID модели	Уровень	Вход ($/1M)	Выход ($/1M)
claude-opus-4-7	Самая мощная	$5.00	$25.00
claude-opus-4-6	Основной флагман	$5.00	$25.00
claude-sonnet-4-6	По умолчанию для production	$3.00	$15.00
claude-haiku-4-5	Легкая, высокий QPS	$1.00	$5.00
claude-opus-4-5	Основной флагман	$5.00	$25.00
claude-sonnet-4-5	По умолчанию для production	$3.00	$15.00

3. Быстрый старт за три шага

Во всех поддерживаемых клиентах нужны всего три значения. Остальная часть страницы — лишь о том, куда их вставить.

1
Base URL → https://tokenhub.store/api
2
Заголовок авторизации → ваш TokenHub th- key (НЕ ключ Anthropic)
3
ANTHROPIC_API_KEY=""Явно задайте ANTHROPIC_API_KEY="", чтобы SDK не переключался на api.anthropic.com

4. Настройка для каждого клиента

Установить

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# or via npm
npm install -g @anthropic-ai/claude-code

Вариант A — переменные среды Shell (глобально)

# ~/.zshrc or ~/.bashrc
export ANTHROPIC_BASE_URL="https://tokenhub.store/api"
export ANTHROPIC_AUTH_TOKEN="th-your-tokenhub-key"
export ANTHROPIC_MODEL="claude-opus-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_API_KEY=""    # must be empty, otherwise SDK falls back to api.anthropic.com

# then reopen the terminal and run:
cd /path/to/your/project
claude

Вариант B — конфигурация на уровне проекта

.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://tokenhub.store/api",
    "ANTHROPIC_AUTH_TOKEN": "th-your-tokenhub-key",
    "ANTHROPIC_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_API_KEY": ""
  }
}

Проверьте с помощью /status

> /status
Auth token:        ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://tokenhub.store/api

Если base URL по-прежнему показывает api.anthropic.com — ANTHROPIC_API_KEY не пустой, терминал не был перезапущен или встроенный терминал VSCode унаследовал устаревшие env.

5. curl самопроверка

Без stream

curl -sS https://tokenhub.store/api/v1/messages \
  -H "x-api-key: th-your-tokenhub-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 128,
    "messages": [{"role":"user","content":"say hi"}]
  }'

Потоковый SSE

curl -N -sS https://tokenhub.store/api/v1/messages \
  -H "x-api-key: th-your-tokenhub-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-4-6","stream":true,"max_tokens":128,"messages":[{"role":"user","content":"count 1 to 3"}]}'

Порядок событий: message_start → content_block_start → content_block_delta* → content_block_stop → message_delta → message_stop.

Скрипт smoke-теста репозитория

Выполняет 6 проверок за один запуск (non-stream / Bearer / порядок SSE / ошибки auth / неподдерживаемый model / function calling).

BASE_URL=https://tokenhub.store TOKENHUB_API_KEY=th-xxxx \
  bash scripts/test-messages-api.sh

6. Шпаргалка по устранению неполадок

Симптом	Наиболее вероятная причина	Исправление
401 / authentication_error	x-api-key не передан или был передан официальный ключ Anthropic	Используйте TokenHub th- key
402 / permission_error	Баланс аккаунта равен 0 или исчерпан лимит расходов для ключа	Пополните через Dashboard → Billing или снимите лимит расходов для ключа
400 'model not supported'	Опечатка в Model ID / неверный регистр	См. §2 — принимаются и bare, и префикс anthropic/
503 'No upstream API key'	Вышестоящий ключ для этого model еще не выдан	Свяжитесь со службой поддержки
Stream обрывается на середине	Слишком маленький HTTP idle timeout у клиента	Увеличьте idle timeout до ≥ 120s
/status по-прежнему показывает api.anthropic.com	ANTHROPIC_API_KEY не был unset, либо терминал не был перезапущен	Выполните export ANTHROPIC_API_KEY="" и затем снова откройте терминал
Tool call возвращает обычный текст	Маршрутизация на upstream со слабой поддержкой tool_use	Переключитесь на claude-opus-4-6 / claude-sonnet-4-6 или свяжитесь со службой поддержки

7. FAQ

Ищете что-то ещё?

Если вы вызываете Claude через openai SDK, используйте вместо этого руководство OpenAI-compatible.

Claude API (OpenAI-compatible) →