Кейсы
Claude Code + ZvenoAI
Claude Code — терминальный AI-ассистент от Anthropic для работы с кодом. Подключите его через ZvenoAI и используйте из России без VPN с оплатой в рублях.
Что такое Claude Code
Claude Code — официальный CLI-инструмент от Anthropic. Он работает прямо в терминале: читает и редактирует файлы, выполняет команды, работает с git, и понимает контекст всего проекта. В отличие от IDE-плагинов, Claude Code работает в любом терминале и не привязан к конкретному редактору.
Запускается командой claude — работает в вашем привычном терминале, без IDE.
Читает файлы, редактирует код, запускает тесты и сборку — с вашего разрешения.
Каждое действие требует подтверждения. Вы всегда видите, что делает агент.
Зачем подключать через ZvenoAI
ZvenoAI работает как прослойка между Claude Code и Anthropic API, решая ключевые проблемы доступа и конфиденциальности.
ZvenoAI гарантирует, что ваш код и промпты не будут использованы для обучения моделей. Критично для организаций, которые защищают интеллектуальную собственность и коммерческую тайну. Ваши данные обрабатываются только для выполнения запроса и не сохраняются после ответа.
ZvenoAI API доступен из России напрямую. Никаких прокси, VPN или обходных решений — просто работает.
Пополняйте баланс картой, СБП или по счёту для юрлиц. Никаких иностранных карт и конвертаций.
Если один провайдер 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 минут. Следуйте шагам по порядку.
Получите API ключ
Войдите в систему или зарегистрируйтесь для создания API ключа.
Установите Claude Code
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bashПодключите 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="" # Важно: должен быть пустым # Перезапустите терминал для применения измененийANTHROPIC_API_KEY должен быть пустой строкой (
""). Если он не задан (null), Claude Code может попытаться авторизоваться напрямую на серверах Anthropic.Если вы ранее авторизовались в Claude Code через Anthropic, выполните команду
/logoutв сессии Claude Code перед настройкой.Запустите сессию
Перейдите в директорию проекта и запустите Claude Code:
cd /path/to/your/project claudeПроверьте подключение
Выполните команду
/statusвнутри Claude Code, чтобы убедиться в подключении:>/statusAuth token:ANTHROPIC_AUTH_TOKENAnthropic base URL:https://api.zveno.aiModel:claude-sonnet-4-6
Как это работает
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. Расходы видны в дашборде.
Поддерживаемые возможности
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).
Ошибка превышения контекста
Разбейте задачу на более мелкие части или начните новую сессию. Claude Code создаёт отдельную сессию при каждом запуске.
Медленные ответы
Скорость зависит от провайдера Anthropic. ZvenoAI не добавляет значительной задержки — запросы проксируются напрямую.