Claude Code
Инструкция по настройке Claude Code для работы через ZvenoAI API. Используйте Claude Code из России без VPN с оплатой в рублях.
Claude Code -- терминальный AI-ассистент от Anthropic для работы с кодом. Подключите его через ZvenoAI и используйте из России без VPN с оплатой в рублях.
Claude Code в России
Для команды: цена дня разработчика, модели и оплата по счёту
Счёт для юрлица
Оплата по счёту с актом, договор подписывать не нужно
Что такое Claude Code
Claude Code -- официальный CLI-инструмент от Anthropic. Он работает прямо в терминале: читает и редактирует файлы, выполняет команды, работает с git, и понимает контекст всего проекта. В отличие от IDE-плагинов, Claude Code работает в любом терминале и не привязан к конкретному редактору.
- Работа в терминале -- запускается командой
claude, работает в вашем привычном терминале, без IDE. - Полный доступ к проекту -- читает файлы, редактирует код, запускает тесты и сборку с вашего разрешения.
- Контроль действий -- каждое действие требует подтверждения. Вы всегда видите, что делает агент.
Зачем подключать через ZvenoAI
ZvenoAI работает как прослойка между Claude Code и Anthropic API, решая ключевые проблемы доступа и конфиденциальности.
Поставщики моделей по своим условиям не обучают модели на данных API; запросы могут временно храниться у поставщика для защиты от злоупотреблений.
- Доступ без VPN -- ZvenoAI API доступен из России напрямую. Никаких прокси, VPN или обходных решений.
- Оплата в рублях -- пополняйте баланс картой, СБП или по счёту для юрлиц. Никаких иностранных карт и конвертаций.
- Failover между провайдерами -- если один провайдер Anthropic недоступен, ZvenoAI автоматически переключится на другой. Рабочий процесс не прерывается.
- Контроль расходов -- отслеживайте использование и расходы в реальном времени в дашборде ZvenoAI. Устанавливайте лимиты для команды.
Как это выглядит
Claude Code работает прямо в терминале -- вот пример сессии через ZvenoAI:
Welcome back!
Sonnet 4.6 • via ZvenoAI
/users/dev/my-project
Recent activity
... /resume for more
What's new
/agents to create subagents
ctrl+b to background bashes
... /help for more
Быстрый старт
Настройка занимает 5 минут. Следуйте шагам по порядку.
1. Получите API ключ
Зарегистрируйтесь на zveno.ai и создайте API ключ в личном кабинете.
2. Установите Claude Code
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bashnpm install -g @anthropic-ai/claude-code3. Подключите Claude Code к ZvenoAI
Вместо прямого подключения к Anthropic, направьте Claude Code через ZvenoAI. Для этого нужно задать переменные окружения.
# Откройте профиль оболочки
nano ~/.zshrc # или ~/.bashrc для Bash
# Добавьте эти строки:
export ZVENOAI_API_KEY="<ваш-api-ключ-zvenoai>"
export ANTHROPIC_BASE_URL="https://api.zveno.ai"
export ANTHROPIC_AUTH_TOKEN="$ZVENOAI_API_KEY"
export ANTHROPIC_API_KEY="" # Важно: должен быть пустым
# Перезапустите терминал для применения изменений{
"env": {
"ANTHROPIC_BASE_URL": "https://api.zveno.ai",
"ANTHROPIC_AUTH_TOKEN": "<ваш-api-ключ-zvenoai>",
"ANTHROPIC_API_KEY": ""
}
}ANTHROPIC_API_KEY должен быть пустой строкой (""). Если он не задан (null), Claude Code может попытаться авторизоваться напрямую на серверах Anthropic.
Если вы ранее авторизовались в Claude Code через Anthropic, выполните команду /logout в сессии Claude Code перед настройкой.
4. Закрепите модель
Укажите slug выбранной модели во всех переменных модели Claude Code. Без них Claude Code отправляет служебные вызовы и субагентов в свою модель Anthropic по умолчанию, и они оплачиваются по цене этой модели.
{
"env": {
"ANTHROPIC_MODEL": "deepseek/deepseek-v4.1-flash",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek/deepseek-v4.1-flash",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek/deepseek-v4.1-flash",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek/deepseek-v4.1-flash",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek/deepseek-v4.1-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek/deepseek-v4.1-flash"
}
}Если подключение задано в этом же файле, добавьте ключи в тот же объект env. Идентификаторы других моделей — в каталоге.
5. Запустите сессию
Перейдите в директорию проекта и запустите Claude Code:
cd /path/to/your/project
claude6. Проверьте подключение
Выполните команду /status внутри Claude Code, чтобы убедиться в подключении:
Как это работает
ZvenoAI поддерживает нативный протокол Anthropic Messages API. Claude Code общается с ZvenoAI на своём родном протоколе -- никаких прокси-серверов и конвертеров не нужно.
- Прямое подключение -- Claude Code отправляет запросы на
api.zveno.ai/v1/messagesв формате Anthropic Messages API. Локальный прокси не нужен. - Anthropic-совместимый API -- ZvenoAI принимает запросы в формате Anthropic API, включая Thinking-блоки, нативные инструменты и streaming (SSE).
- Маршрутизация и failover -- ZvenoAI маршрутизирует запрос к провайдеру Anthropic. При недоступности одного провайдера автоматически переключается на другой.
- Биллинг в рублях -- использование (включая reasoning-токены) списывается с вашего рублёвого баланса ZvenoAI. Расходы видны в дашборде.
Поддерживаемые возможности
| Возможность | Статус | Примечание |
|---|---|---|
| Streaming (SSE) | Поддерживается | Полная поддержка |
| Thinking / Extended Thinking | Поддерживается | Полная поддержка |
| Tool Use (нативный) | Поддерживается | Полная поддержка |
| Claude Opus 4.6 | Поддерживается | Через провайдера |
| Claude Sonnet 4.6 | Поддерживается | Через провайдера |
| Claude Haiku 4.5 | Поддерживается | Через провайдера |
| Авторизация по API-ключу | Поддерживается | x-api-key header |
GitHub Action
ZvenoAI работает с официальным Claude Code GitHub Action. Добавьте ваш API-ключ ZvenoAI как GitHub Secret и укажите base URL:
- name: Run Claude Code
uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ZVENOAI_API_KEY }}
env:
ANTHROPIC_BASE_URL: https://api.zveno.aiСохраните API-ключ ZvenoAI в секрете репозитория с именем ZVENOAI_API_KEY.
Anthropic Agent SDK
Anthropic Agent SDK позволяет программно создавать AI-агентов на Python и TypeScript. Поскольку Agent SDK использует Claude Code как рантайм, его можно подключить к ZvenoAI через те же переменные окружения, что описаны выше.
Решение проблем
- Ошибка авторизации (401) -- убедитесь, что
ANTHROPIC_API_KEYустановлен в пустую строку (""). Если он не задан (null), Claude Code может пытаться авторизоваться на серверах Anthropic. - Claude Code пытается войти через Anthropic -- выполните
/logoutв сессии Claude Code, затем перезапустите терминал. Убедитесь, что переменные окружения применились (echo $ANTHROPIC_BASE_URL). - В расходах модели Anthropic, которые вы не выбирали -- закрепите модель, как в шаге 4.
- Ошибка превышения контекста -- разбейте задачу на более мелкие части или начните новую сессию. Claude Code создаёт отдельную сессию при каждом запуске.
- Медленные ответы -- скорость зависит от провайдера Anthropic. ZvenoAI не добавляет значительной задержки -- запросы проксируются напрямую.
Get User Activity GET
Возвращает активность пользователя, сгруппированную по дате и модели, за последние 30 завершённых UTC-дней. Поддерживает фильтрацию по конкретной дате.
Cursor
Настройка Cursor для работы с ZvenoAI API: требования к тарифу, свой API-ключ, Base URL и ошибка Named models unavailable.