Claude Code

Claude Code -- терминальный AI-ассистент от Anthropic для работы с кодом. Подключите его через ZvenoAI и используйте из России без VPN с оплатой в рублях.

Что такое Claude Code

Claude Code -- официальный CLI-инструмент от Anthropic. Он работает прямо в терминале: читает и редактирует файлы, выполняет команды, работает с git, и понимает контекст всего проекта. В отличие от IDE-плагинов, Claude Code работает в любом терминале и не привязан к конкретному редактору.

• Работа в терминале -- запускается командой claude, работает в вашем привычном терминале, без IDE.
• Полный доступ к проекту -- читает файлы, редактирует код, запускает тесты и сборку с вашего разрешения.
• Контроль действий -- каждое действие требует подтверждения. Вы всегда видите, что делает агент.

Зачем подключать через ZvenoAI

ZvenoAI работает как прослойка между Claude Code и Anthropic API, решая ключевые проблемы доступа и конфиденциальности.

• Доступ без VPN -- ZvenoAI API доступен из России напрямую. Никаких прокси, VPN или обходных решений.
• Оплата в рублях -- пополняйте баланс картой, СБП или по счёту для юрлиц. Никаких иностранных карт и конвертаций.
• Failover между провайдерами -- если один провайдер Anthropic недоступен, ZvenoAI автоматически переключится на другой. Рабочий процесс не прерывается.
• Контроль расходов -- отслеживайте использование и расходы в реальном времени в дашборде ZvenoAI. Устанавливайте лимиты для команды.

Как это выглядит

Claude Code работает прямо в терминале -- вот пример сессии через ZvenoAI:

Быстрый старт

Настройка занимает 5 минут. Следуйте шагам по порядку.

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

Зарегистрируйтесь на zveno.ai и создайте API ключ в личном кабинете.

2. Установите Claude Code

macOS, Linux, WSL:

3. Подключите 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": ""
  }
}

4. Запустите сессию

Перейдите в директорию проекта и запустите Claude Code:

cd /path/to/your/project
claude

5. Проверьте подключение

Выполните команду /status внутри Claude Code, чтобы убедиться в подключении:

Как это работает

ZvenoAI поддерживает нативный протокол Anthropic Messages API. Claude Code общается с ZvenoAI на своём родном протоколе -- никаких прокси-серверов и конвертеров не нужно.

1. Прямое подключение -- Claude Code отправляет запросы на api.zveno.ai/v1/messages в формате Anthropic Messages API. Локальный прокси не нужен.
2. Anthropic-совместимый API -- ZvenoAI принимает запросы в формате Anthropic API, включая Thinking-блоки, нативные инструменты и streaming (SSE).
3. Маршрутизация и failover -- ZvenoAI маршрутизирует запрос к провайдеру Anthropic. При недоступности одного провайдера автоматически переключается на другой.
4. Биллинг в рублях -- использование (включая 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 не добавляет значительной задержки -- запросы проксируются напрямую.