Что такое Клод Код?
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 URL | https://us-api.tokenhub.com |
| API Key | Значение TOKENHUB_API_KEY |
| Модель | claude-sonnet-4 или другой model ID TokenHub |
Расположение настроек
| Поле | Значение |
|---|---|
| CLI settings | ~/.claude/settings.json |
| VS Code extension | User 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. |
Как выбрать модель
Часто задаваемые вопросы по пользовательскому 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。