Документация API Hop
Интеграция Claude Code
Используйте совместимый с Claude Messages эндпоинт RequestBeam в Claude Code.
Claude Code вызывает модели по протоколу Anthropic Messages. Установите ANTHROPIC_BASE_URL в совместимый с Anthropic базовый URL, указанный на этой странице.
Claude Sonnet 4.6 (claude-sonnet-4-6) поддерживается вышестоящим поставщиком, но сейчас не опубликован на RequestBeam. Это не действующая модель интеграции по умолчанию. Перед вызовом любой модели подтвердите доступ своим ответом GET https://api.apihop.ai/v1/models.
ANTHROPIC_BASE_URL=https://api.apihop.ai/anthropicПредварительные условия
Сначала подготовьте действующий ключ API RequestBeam. Он будет записан в локальное окружение оболочки. Не добавляйте его в репозитории, журналы или снимки экрана.
Установка Claude Code
В macOS / Linux используйте нативный установщик Claude Code:
curl -fsSL https://claude.ai/install.sh | bashЕсли установщик сообщает ~/.local/bin/claude, но claude не найден, откройте новый терминал или добавьте ~/.local/bin в PATH.
Для прежних рабочих процессов пакет npm по-прежнему доступен:
npm install -g @anthropic-ai/claude-codeНе используйте sudo npm install -g @anthropic-ai/claude-code: это может вызвать проблемы с правами при последующих обновлениях.
Проверьте CLI после установки:
claude --version
claude doctorВ Windows для Claude Code рекомендуется Git Bash или WSL. PowerShell тоже позволяет задавать переменные окружения, но способ сохранения зависит от терминала.
Настройка переменных окружения
Временные настройки действуют только в текущем сеансе терминала:
export ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"
export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
export ANTHROPIC_MODEL="claude-sonnet-5-5"macOS по умолчанию использует zsh. Для постоянной настройки запишите переменные в ~/.zshrc, затем выполните source ~/.zshrc, чтобы текущий терминал сразу прочитал их:
printf '%s\n' \
'export ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"' \
'export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"' \
'export ANTHROPIC_MODEL="claude-sonnet-5-5"' \
>> ~/.zshrc
source ~/.zshrcВ Linux с bash запишите те же переменные в ~/.bashrc и выполните source ~/.bashrc.
Временные настройки Windows PowerShell:
$env:ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
$env:ANTHROPIC_MODEL="claude-sonnet-5-5"Постоянные настройки PowerShell на уровне пользователя:
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_REQUESTBEAM_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.apihop.ai/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5-5", "User")Перед запуском claude откройте новый сеанс PowerShell.
Файл настроек
Вместо настройки оболочки можно создать или отредактировать ~/.claude/settings.json. Если файл уже существует, объедините env и model с существующим JSON, не заменяя другие настройки:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_REQUESTBEAM_API_KEY",
"ANTHROPIC_BASE_URL": "https://api.apihop.ai/anthropic",
"ANTHROPIC_MODEL": "claude-sonnet-5-5"
},
"model": "claude-sonnet-5-5"
}Доступные модели:
claude-fable-5claude-fable-5-1claude-opus-4-6claude-opus-4-7claude-opus-4-8claude-opus-5claude-opus-5-5claude-sonnet-5claude-sonnet-5-5
Используйте GET https://api.apihop.ai/v1/models для просмотра моделей, доступных сейчас вашему ключу API.
Запуск и проверка
После настройки переменных окружения перезапустите Claude Code и отправьте обычный запрос:
claude "Reply exactly OK."Также можно запустить интерактивный режим:
claudeПри первом запуске Claude Code может запросить тему, подтверждение безопасности, настройку терминала или доверие текущему каталогу. Следуйте подсказкам терминала.
Выбор модели
Задайте модель по умолчанию переменной окружения или выберите модель для одной команды через --model:
claude --model claude-sonnet-5-5 "Review this PR"Поведение эндпоинта
Claude Code аутентифицируется с настроенным ключом API RequestBeam. Сервис принимает любую из двух форм аутентификации:
x-api-key: YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01Authorization: Bearer YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01Ответы сохраняют нативный формат JSON или событий SSE Anthropic Messages. Они не преобразуются в формат OpenAI.
Устранение неполадок
ANTHROPIC_BASE_URLдолжен быть базовым URL публичного API на этой странице с добавлением/anthropic.- Не включайте пути эндпоинтов в
ANTHROPIC_BASE_URL; нужен только совместимый с Anthropic базовый URL. - После изменения
~/.zshrcв macOS выполнитеsource ~/.zshrcили откройте новый терминал перед запуском Claude Code. - Если
claudeсообщает, что команда не найдена, проверьте наличие каталога установки вPATH; частое расположение —~/.local/bin/claude. - Если
claude doctorсообщает об отсутствующих переменных окружения, выполнитеecho $ANTHROPIC_BASE_URLиecho $ANTHROPIC_MODELв том же терминале, чтобы проверить загрузку. - При
401проверьте действительность ключа API. - Если модель недоступна, проверьте, что её имя входит в приведённый выше список доступных моделей.
- После изменения переменных окружения перезапустите процесс Claude Code.
Связанный эндпоинт
POST https://api.apihop.ai/anthropic/v1/messages: эндпоинт, совместимый с Anthropic Messages.