Интеграции
ИНТЕГРАЦИИ

Claude Code

Подключение официального CLI-агента Claude Code к Hubris через эндпоинт /v1/messages — поддержка Sonnet, Opus, Haiku, кэширования, vision, статусной строки.

Claude Code — официальный CLI-агент Anthropic. Запускается в терминале, понимает контекст проекта, умеет редактировать файлы, исполнять команды, читать скриншоты, держит долгую сессию с кэшированием промптов. Поддерживает любой Anthropic-совместимый бэкенд через переменные окружения. Hubris подходит из коробки.

Что вы получите

  • Доступ ко всему семейству Claude (Sonnet 4.5/4.6, Opus 4.5/4.6/4.7, Haiku 4.5) с оплатой в рублях и без VPN.
  • Нативное prompt caching для длинных сессий — экономит до десятков рублей на каждом турне.
  • Чтение скриншотов и других изображений (vision).
  • Использование инструментов (tool use) для редактирования файлов и запуска команд.
  • Опциональная statusline в TUI с балансом, расходом сессии и текущей моделью.

Требования

  • macOS / Linux / WSL / современный терминал на Windows.
  • Аккаунт на hubris.pw и API-ключ формата sk-gw-… (создать на /keys).
  • Положительный баланс — пополнить можно здесь.

Установка Claude Code

Подробная инструкция — в официальной документации. Самый быстрый путь:

npm install -g @anthropic-ai/claude-code

Альтернатива — однострочный установщик:

curl -fsSL https://claude.ai/install.sh | bash

Убедитесь, что Claude Code запускается:

claude --version

Подключение к Hubris

Достаточно двух переменных окружения. Поставьте их перед запуском Claude Code:

export ANTHROPIC_BASE_URL="https://api.hubris.pw"
export ANTHROPIC_AUTH_TOKEN="sk-gw-..."
# опционально — пустая ANTHROPIC_API_KEY гарантирует, что SDK не подставит
# случайно настоящий ключ Anthropic, если он есть в среде:
unset ANTHROPIC_API_KEY

Чтобы не вводить руками каждый раз — добавьте в ~/.bashrc / ~/.zshrc / ~/.config/fish/config.fish. Под Windows — Set-HUBRIS_API_KEY в профиле PowerShell.

Запустите агента из папки проекта:

cd ~/projects/my-project
claude

В первом турне Claude Code сходит к Hubris вместо api.anthropic.com, выберет указанную модель и спишет стоимость с вашего баланса в рублях.

Выбор модели

В рабочей сессии переключайте модель командой /model. Hubris принимает и короткие Anthropic-имена (claude-sonnet-4-5, claude-haiku-4-5), и каноничные (anthropic/claude-sonnet-4.6). Полный список — в каталоге.

Чтобы зафиксировать модель по умолчанию, передайте её при запуске:

claude --model claude-sonnet-4-5

Или укажите в ~/.claude/settings.json:

{
  "defaultModel": "claude-sonnet-4-5"
}

Какая модель когда подходит

МодельКогда брать
claude-haiku-4-5быстрые ответы, поиск по коду, простые правки, дёшево.
claude-sonnet-4-5 / claude-sonnet-4-6основной рабочий вариант: качественные правки, рефакторинги, длинные сессии.
claude-opus-4-7сложные архитектурные задачи, миграции, разбор багов в больших кодовых базах.

Statusline с балансом

В нижней строке TUI Claude Code можно выводить текущий баланс Hubris, расход сессии и активную модель. Скрипт обновляется на каждом турне и не блокирует ответ модели.

Установка (Linux / macOS / WSL)

curl -fsSL https://hubris.pw/scripts/claude-statusline.sh \
  -o ~/.claude/hubris-statusline.sh
chmod +x ~/.claude/hubris-statusline.sh

Добавьте в ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/hubris-statusline.sh"
  }
}

Установка (Windows / кросс-платформа на Node.js)

Invoke-WebRequest -Uri https://hubris.pw/scripts/claude-statusline.mjs `
  -OutFile $env:USERPROFILE\.claude\hubris-statusline.mjs

В ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "node ~/.claude/hubris-statusline.mjs"
  }
}

Скрипт читает ANTHROPIC_AUTH_TOKEN из среды (тот же ключ, что использует CC) и обращается к /v1/usage за расходом и балансом. Запросы на статус — бесплатны (не списываются с баланса).

Пример вывода:

 hubris │ Sonnet 4.5 │ session 0,42 ₽ · today 12,18 ₽ · balance 1 287 ₽

Прочая конфигурация

Переменная окруженияЧто делает
ANTHROPIC_BASE_URLURL шлюза. Для Hubris — https://api.hubris.pw.
ANTHROPIC_AUTH_TOKENAPI-ключ sk-gw-…. Используется как Authorization: Bearer.
ANTHROPIC_MODELмодель по умолчанию (если не задана в settings.json).
ANTHROPIC_SMALL_FAST_MODELмодель для лёгких подзадач (резюмирования, выбор имени). По умолчанию Haiku — оставляйте claude-haiku-4-5.

Дневные лимиты

Если на ключе включён дневной лимит трат (можно поставить на /keys), Hubris вернёт 429 rate_limit_error. Claude Code отобразит ошибку в TUI и предложит остановить сессию. Лимит обнуляется ежедневно в 00:00 UTC.

Кэширование промптов

Claude Code сам управляет cache_control для длинных системных промптов и расшаренного контекста. Hubris передаёт это поле в Anthropic без изменений и списывает по фактической стоимости с учётом cache hit (0,1× от обычной цены) или cache write (1,25×). Подробности — в API-референсе /v1/messages.

Часто задаваемые вопросы

Можно ли использовать через настоящий ключ Anthropic параллельно? Да: переменные ANTHROPIC_* локальные. Достаточно открыть второй терминал без них — Claude Code пойдёт напрямую.

Где увидеть детальный расход? Все запросы появляются на странице Использование с разбивкой по моделям и времени. Через API — GET /v1/usage.

Поддерживается ли Privacy Mode для маскирования PII? В первой версии — нет. Если нужно маскирование, делайте запросы через /v1/chat/completions с заголовком X-Hubris-Privacy-Mask. Поддержка на /v1/messages появится позже.

Что делать, если CC просит модель, которой нет в каталоге? Hubris вернёт 404 not_found_error с именем недоступной модели. Сверьтесь со списком активных моделей и переключитесь командой /model на одну из них.

Что дальше

Обновлено:

Claude Code · Hubris