Разделы документации

Claude Code через Heli

Обновлено:

Claude Code — CLI-агент для программирования в терминале. Heli отвечает на POST /v1/messages в формате Anthropic, поэтому Claude Code подключается без прокси и плагинов.

Коротко

Задайте ANTHROPIC_BASE_URL=https://getheli.ru (без /v1), ключ Heli в ANTHROPIC_AUTH_TOKEN и слаг модели в ANTHROPIC_MODEL, затем запустите claude.

1. Получите ключ Heli

Зарегистрируйтесь на getheli.ru и скопируйте ключ sk-heli-… во вкладке «Ключи» кабинета.

2. Задайте переменные и запустите

bash
export ANTHROPIC_BASE_URL="https://getheli.ru"
export ANTHROPIC_AUTH_TOKEN="sk-heli-ВАШ_КЛЮЧ"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek/deepseek-v4-flash"
claude

Ключ можно передать и через ANTHROPIC_API_KEY — Heli принимает его в заголовке x-api-key. Модель — слаг из каталога.

Проверка через curl

curl
curl https://getheli.ru/v1/messages \
  -H "x-api-key: sk-heli-ВАШ_КЛЮЧ" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "max_tokens": 256,
    "messages": [{ "role": "user", "content": "Объясни, что делает git rebase." }]
  }'

Частые вопросы

Почему адрес без /v1?
Claude Code сам добавляет /v1/messages к ANTHROPIC_BASE_URL. С адресом https://getheli.ru запросы идут на https://getheli.ru/v1/messages. Если вы уже указали адрес с /v1, он тоже работает.
Какие модели можно выбрать?
Любую модель чата из каталога Heli: укажите её слаг в ANTHROPIC_MODEL. Вторая переменная, ANTHROPIC_DEFAULT_HAIKU_MODEL, задаёт модель для коротких служебных запросов Claude Code — удобно взять быструю и недорогую.
Что поддерживается из Anthropic Messages API?
Стрим, вызовы инструментов (чтение и правка файлов, команды), картинки во входе, кэш промпта (cache_control), stop_sequences и count_tokens. Ошибки приходят в формате Anthropic, поэтому Claude Code сам повторяет запрос при перегрузке.
Нужен ли VPN или аккаунт Anthropic?
Нет. Запросы идут на getheli.ru, оплата — с рублёвого баланса Heli.

Подробный разбор с выбором модели — в статье блога. Другие инструменты — Codex CLI, Cursor и n8n.