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_URL | URL шлюза. Для Hubris — https://api.hubris.pw. |
ANTHROPIC_AUTH_TOKEN | API-ключ 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 на одну из них.
Что дальше
- POST /v1/messages — полный API-референс по эндпоинту.
- Каталог моделей — активные Claude-модели и цены в рублях.
- Использование — детальный расход по запросам.
- Биллинг — пополнение баланса через СБП.
Обновлено: