Claude Code

Claude Code можно подключить к Zenvy через Anthropic-compatible endpoint. Агент отправляет запросы на https://api.zenvy.su/v1/messages, а Zenvy проверит API-ключ, выберет модель, спишет баланс и вернёт ответ в формате Anthropic Messages API.

Zenvy поддерживает обычные ответы, streaming, tool use и endpoint подсчёта токенов POST /v1/messages/count_tokens, поэтому Claude Code может работать как агент в терминале.

Что понадобится

1. API-ключ Zenvy вида sk-zenvy-... из раздела API-ключи.
2. Положительный баланс аккаунта.
3. Установленный Claude Code.

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

Шаг 1. Установите Claude Code

curl -fsSL https://claude.ai/install.sh | bash

Для npm нужен Node.js 18 или новее.

Проверьте установку:

claude --version

Шаг 2. Задайте переменные окружения

Claude Code читает настройки из переменных окружения. Укажите базовый адрес Zenvy, API-ключ и явно очистите ANTHROPIC_API_KEY, чтобы агент не пытался авторизоваться на серверах Anthropic:

export ANTHROPIC_BASE_URL="https://api.zenvy.su"
export ANTHROPIC_AUTH_TOKEN="sk-zenvy-..."
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4.7"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-chat"

ANTHROPIC_BASE_URL указывается без /v1: Claude Code сам добавляет /v1/messages.

Шаг 3. Запустите Claude Code

cd /path/to/your/project
claude

Проверить подключение можно командой /status внутри Claude Code — в выводе должен быть Anthropic base URL: https://api.zenvy.su.

Постоянная настройка

Чтобы не задавать переменные заново в каждом терминале, сохраните их в профиле shell или в переменных окружения Windows.

echo 'export ANTHROPIC_BASE_URL="https://api.zenvy.su"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-zenvy-..."' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY=""' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4.6"' >> ~/.bashrc
echo 'export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4.6"' >> ~/.bashrc
echo 'export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4.7"' >> ~/.bashrc
echo 'export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-chat"' >> ~/.bashrc
source ~/.bashrc

После сохранения откройте новый терминал.

Настройка через файл проекта

Альтернатива переменным окружения — файл .claude/settings.local.json в корне проекта:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.zenvy.su",
    "ANTHROPIC_AUTH_TOKEN": "sk-zenvy-...",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "claude-sonnet-4.6"
  }
}

Проверка подключения

Проверьте Zenvy API до запуска Claude Code:

curl https://api.zenvy.su/v1/messages \
  -H "Authorization: Bearer sk-zenvy-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "max_tokens": 64,
    "messages": [
      { "role": "user", "content": "Ответь одним словом: ok" }
    ]
  }'

Проверка token-count endpoint:

curl https://api.zenvy.su/v1/messages/count_tokens \
  -H "Authorization: Bearer sk-zenvy-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "messages": [
      { "role": "user", "content": "Привет!" }
    ]
  }'

Ожидаемый ответ:

{
  "input_tokens": 8
}

Рекомендуемые модели

Актуальные ID — в каталоге моделей или через GET /v1/models. Zenvy также принимает популярные Claude-алиасы (sonnet, opus, haiku) и сопоставляет их с доступными моделями.

GitHub Actions

Для Claude Code GitHub Action добавьте секрет ZENVY_API_KEY в репозиторий и передайте переменные окружения в workflow:

name: Claude Code

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: anthropics/claude-code-action@v1
        env:
          ANTHROPIC_BASE_URL: https://api.zenvy.su
          ANTHROPIC_AUTH_TOKEN: ${{ secrets.ZENVY_API_KEY }}
          ANTHROPIC_API_KEY: ""
          ANTHROPIC_MODEL: claude-sonnet-4.6
          ANTHROPIC_DEFAULT_SONNET_MODEL: claude-sonnet-4.6
          ANTHROPIC_DEFAULT_OPUS_MODEL: claude-opus-4.7
          ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-chat

Устранение неполадок

Безопасность

• Не коммитьте API-ключ в репозиторий.
• Для GitHub Actions используйте secrets.
• Если ключ утёк, удалите его в кабинете Zenvy и создайте новый.