Claude Code

Claude Code говорит на протоколе Anthropic Messages — отдельный прокси не ставится. Агент заточен под модели Anthropic (инструменты, thinking, форматирование). Другие модели из каталога можно подставить, но агентные задачи на них часто ломаются.

Зачем через VTOP Ai

• Из России без VPN. Запросы идут на api.daaj.ru.
• Оплата в рублях, бюджет на ключе, расход в панели.
• Запасные модели и провайдер. Если Anthropic не ответил — fallback и выбор провайдера.
• Нативный POST /v1/messages: thinking-блоки и tool use проходят как есть.

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

1. Установка

   macOS, Linux, WSLWindows PowerShellnpm

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

   Для npm нужен Node.js 18+.

2. Подключение к VTOP Ai

   Не логиньтесь в аккаунт Anthropic. Нужны три переменные:

   1. ANTHROPIC_BASE_URL=https://api.daaj.ru — без /v1: Claude Code сам дописывает /v1/messages
   2. ANTHROPIC_AUTH_TOKEN — ключ VTOP Ai
   3. ANTHROPIC_API_KEY="" — явно пустая строка, не «переменная не задана»

3. Сбросить кэш входа Anthropic

   Если раньше входили аккаунтом Anthropic — /logout и перезапуск claude. Иначе кэш конфликтует с токеном шлюза.

4. Запуск и проверка

   cd в проект, claude, внутри /status. В токене должно быть ANTHROPIC_AUTH_TOKEN, base URL — https://api.daaj.ru.

Профиль оболочки

nano ~/.zshrc  # или ~/.bashrc

export vtop_api_key="sk-VTOP Ai-xxx"
export ANTHROPIC_BASE_URL="https://api.daaj.ru"
export ANTHROPIC_AUTH_TOKEN="$vtop_api_key"
export ANTHROPIC_API_KEY=""
# по желанию: список моделей шлюза в /model
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

source ~/.zshrc

Добавьте строки в ~/.zshrc, ~/.bashrc или ~/.config/fish/config.fish, затем source или новый терминал.

Не кладите ключ в dotfiles-репозиторий. На macOS можно читать из связки ключей: export vtop_api_key="$(security find-generic-password -s VTOP Ai -w)". Утёкший ключ отзовите в панели ключей.

Файл проекта

.claude/settings.local.json в корне проекта:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.daaj.ru",
    "ANTHROPIC_AUTH_TOKEN": "sk-VTOP Ai-xxx",
    "ANTHROPIC_API_KEY": "",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Кэш входа Anthropic

> /logout

Если в Anthropic не логинились — шаг можно пропустить. На macOS сессия лежит в Keychain как Claude Code-credentials. Если после /logout конфликт остался:

security find-generic-password -s "Claude Code-credentials"
security delete-generic-password -s "Claude Code-credentials"

Запуск

cd /path/to/your/project
claude

Проверка:

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://api.daaj.ru

Если в токене ANTHROPIC_API_KEY или метод входа — аккаунт Claude, переменные не дошли: source профиля и новый claude. Запросы видны в панели.

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

1. Прямое подключение. ANTHROPIC_BASE_URL указывает на VTOP Ai, Claude Code говорит своим протоколом. Локальный прокси не нужен.
2. Messages API. POST https://api.daaj.ru/v1/messages ведёт себя как Anthropic: маппинг имён, thinking, tool use.
3. Списание. Токены и reasoning — в рублях, usage.cost_rub в ответе. История ключа — статистика.

Модели

Claude Code держит слоты Fable / Opus / Sonnet / Haiku. VTOP Ai подставляет каталожные Claude, если слот не переопределён. Можно указать любую модель из каталога:

export ANTHROPIC_DEFAULT_FABLE_MODEL="claude-fable-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4.8"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4.5"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-opus-4.8"

Имена — как в каталоге: claude-opus-4.8, не anthropic/claude-opus-4.8. Слаг со слешем уходит в OpenRouter.

Fast mode

У Opus есть ускоренный тариф: в каталоге это claude-opus-4.8-fast, claude-opus-5-fast и соседние -fast. Claude Code шлёт speed: "fast" командой /fast.

export CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4.8"

Нужен Claude Code v2.1.96+. CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1 снимает проверку «организации Anthropic».

Другой путь — сразу ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4.8-fast". У Fable отдельного fast-слота нет: /fast на Fable переключает сессию на Opus. Подробнее — уровни обслуживания.

Agent SDK

Anthropic Agent SDK крутит тот же runtime Claude Code. Те же ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, пустой ANTHROPIC_API_KEY.

GitHub Action

Официальный Claude Code GitHub Action. Два изменения:

1. Ключ VTOP Ai в секрете vtop_api_key, его же в anthropic_api_key
2. В env шага — ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN

- name: Run Claude Code
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.vtop_api_key }}
  env:
    ANTHROPIC_BASE_URL: https://api.daaj.ru
    ANTHROPIC_AUTH_TOKEN: ${{ secrets.vtop_api_key }}

Экшен требует input anthropic_api_key, сам ANTHROPIC_AUTH_TOKEN не читает. Input запускает процесс, заголовок Authorization берётся из env. Здесь ANTHROPIC_API_KEY не пустой — экшен заполняет его из input; это нормально: прогон неинтерактивный, ANTHROPIC_BASE_URL всё равно гонит запросы в VTOP Ai.

Statusline с расходом

Внизу сессии можно показать модель, расход в рублях, баланс и заполнение контекста:

VTOP Ai · Sonnet · 12,40 ₽ · баланс 4987 ₽ · контекст 42%

Скачайте оба файла в одну папку, chmod +x statusline.sh, пропишите путь в ~/.claude/settings.json:

• statusline.sh
• statusline.ts

{
  "statusLine": {
    "type": "command",
    "command": "/path/to/statusline.sh"
  }
}

Откуда цифры

Расход — это падение баланса за сессию. Скрипт опрашивает GET /v1/VTOP Ai/balance не чаще раза в 10 секунд и складывает разницы. Сумма точная, в рублях, но помните про две вещи:

• всё, что тратит этот же ключ, попадёт в счётчик — другая сессия, скрипт, бот;
• пополнения игнорируются: платёж посреди сессии не отмотает сумму назад.

Модель и процент контекста скрипт берёт из JSON, который Claude Code передаёт statusline на stdin. Ключ — из ANTHROPIC_AUTH_TOKEN (или ANTHROPIC_API_KEY).

Мелочи

• settings.json держит один statusLine. Если уже стоит ccusage или другой — этот его заменит.
• Нужны Node.js и сеть на первый запуск: statusline.sh вызывает npx tsx statusline.ts (первый npx может подтормозить).
• Состояние сессии: /tmp/claude-VTOP Ai-cost-<session-id>.json. Файл маленький, после ребута обычно пропадает. /clear начинает новую сессию — счётчик стартует с нуля.

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

• «Model not found» на старте. Конфликт кэша Anthropic и токена шлюза. /logout, выйти, снова claude. Если в профиле всё ещё живой ANTHROPIC_API_KEY от консоли Anthropic — /logout не поможет: поставьте ANTHROPIC_API_KEY="", source профиля.
• Ошибки авторизации. Ключ в ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY="", base URL без /v1. После правки профиля — новый шелл.
• Tool use не работает. Модель без function calling. Вернитесь на Claude из каталога.
• Контекст. Режьте задачу или новая сессия. Для больших репозиториев берите модели с окном ≥ 128k.
• Приватность. VTOP Ai не логирует исходный код промптов.

Смотрите также

• Документация Claude Code
• Claude Desktop
• Codex CLI
• OpenCode
• Qwen Code
• API-ключи
• Список моделей
• Вызов инструментов
• Токены рассуждений
• Уровни обслуживания