Настройка пользовательского API Claude Code

Установите Claude Code CLI, подключите конечную точку, совместимую с TokenHub Anthropic, и проверьте активную модель с помощью /status.

Что такое Клод Код?

Claude Code — это агент командной строки Anthropic для понимания репозиториев, редактирования файлов, запуска команд и выполнения многоэтапных задач разработки.

Это руководство подключает Claude Code к TokenHub через протокол Anthropic Messages, сохраняя при этом обычный рабочий процесс терминала. Он охватывает файл настроек уровня пользователя, учетные данные API, выбор модели, проверку соединения и требования к протоколу, которые отличают агент кодирования от базового клиента чата. Claude Code лучше всего подходит для работы в масштабе репозитория, где модель должна проверять контекст, планировать изменения, использовать инструменты и проверять результаты. Начните с тестового репозитория с запросом только для чтения, убедитесь, что /status показывает предполагаемую конфигурацию, и просмотрите журналы запросов TokenHub, прежде чем предоставлять более широкие права доступа к командам или файлам.

Claude Code может направлять запросы к моделям через совместимый API-шлюз TokenHub Anthropic Claude Messages. Используйте официальный способ установки, затем замените только API key, Base URL и model ID.

Endpoint TokenHub для этого руководства: https://us-api.tokenhub.com/v1/messages.

Когда использовать

Начните с небольшого репозитория или тестового проекта. Сначала попросите инструмент читать файлы, объяснять код или составлять план, затем включайте правки.

Установите или откройте инструмент

Следуйте официальной документации Claude Code для установки или запуска. Если интерфейс изменился, ориентируйтесь на актуальную документацию.

Для CLI-инструментов сначала убедитесь, что исполняемый файл доступен, и только потом добавляйте учетные данные TokenHub:

claude --version

Подготовьте учетные данные TokenHub

Создайте TokenHub API key и выберите подходящую модель в списке моделей TokenHub.

export TOKENHUB_API_KEY="sk-..."

Храните ключ в локальном shell, секретном хранилище IDE или защищенном поле API key инструмента. Не коммитьте ключ в репозиторий.

Настройте провайдера TokenHub

В настройках Models, Providers, API Keys или OpenAI Compatible укажите следующие значения.

Значения provider

ПолеЗначение
ПровайдерAnthropic Claude Messages
Base URLhttps://us-api.tokenhub.com
API KeyЗначение TOKENHUB_API_KEY
Модельclaude-sonnet-4 или другой model ID TokenHub

Расположение настроек

ПолеЗначение
CLI settings~/.claude/settings.json
VS Code extensionUser settings.json, field claudeCode.environmentVariables
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4",
  "env": {
    "ANTHROPIC_BASE_URL": "__API_BASE_URL__",
    "ANTHROPIC_AUTH_TOKEN": "sk-..."
  }
}
{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "__API_BASE_URL__"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-..."
    }
  ]
}

Если инструмент разделяет chat, edit, apply и fast models, для первого теста используйте одну и ту же модель TokenHub. После проверки разделите их по стоимости, задержке и силе рассуждения.

Временные переменные только для диагностики

Используйте временные переменные только для проверки ключа, сети и имени модели. После проверки перенесите те же значения в постоянную конфигурацию выше.

export TOKENHUB_API_KEY="sk-..."
export ANTHROPIC_BASE_URL="__API_BASE_URL__"
export ANTHROPIC_AUTH_TOKEN="$TOKENHUB_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4"

Проверьте подключение

Сначала используйте read-only prompt, чтобы убедиться, что модель читает контекст и не меняет файлы. Потом проверяйте редактирование и agent tasks.

Прочитай README проекта и кратко опиши его в трех предложениях. Не изменяй файлы.

После успешного prompt проверьте в логах TokenHub имя модели, endpoint, расход tokens и billing group.

Устранение неполадок

СимптомЧто сделать
401 или ошибка аутентификацииПроверьте, что TOKENHUB_API_KEY действителен и сохранен в том же terminal, IDE или профиле клиента.
404 или модель не найденаИспользуйте model ID, который есть в рабочей области TokenHub и подходит выбранному протоколу.
Неверный endpointОставьте Base URL точно как указано выше. OpenAI-compatible tools обычно требуют /v1; Claude-compatible tools обычно нет.
Таймаут запросаПроверьте сеть до https://us-api.tokenhub.com, proxy settings и allowlist рабочей области.
Инструмент использует другую модельПроверьте все поля chat, edit, apply, fast и autocomplete.

Как выбрать модель

НагрузкаВыбор моделиПочему подходит
Repository-wide implementationAnthropic Messages model with tool use and a long context windowClaude Code needs the Messages protocol, streaming, and reliable tool execution when it reads and edits across a repository.
Interactive fixes and reviewsBalanced coding model on the same compatible routePrioritize stable tool calls and response latency over a model that only performs well in plain chat.
Subagents and background workLower-cost compatible model, validated firstValidate tool use, streaming, and long-running task behavior before mapping it to background or alias workloads.
Открыть модели TokenHub

Часто задаваемые вопросы по пользовательскому API Claude Code

Чем Claude Code отличается от обычного чата Claude?

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

Как установить Claude Code CLI?

Используйте текущий официальный установщик Anthropic или инструкции поддерживаемого менеджера пакетов. Запустите claude --version и claude Doctor перед добавлением TokenHub, чтобы проблемы установки были отделены от проблем конфигурации API.

Должен ли ANTHROPIC_BASE_URL включать /v1/messages?

Нет. Введите корень API TokenHub, поскольку Claude Code добавляет сам маршрут сообщений. Добавление /v1/messages дважды обычно приводит к ответу 404.

Какие модели TokenHub работают с Claude Code?

Выберите модель, явно проверенную на предмет антропных сообщений, потоковой передачи и использования собственных инструментов, с достаточным контекстом для репозитория. Одной поддержки завершения чата недостаточно.

Как я могу проверить пользовательский API Claude Code?

Запустите новый сеанс терминала, запустите /status, затем запросите объяснение репозитория, доступного только для чтения. Прежде чем разрешить внесение изменений, подтвердите идентификатор модели и запрос /v1/messages в журналах TokenHub.

Источники

Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-04。