Claude Code можно запустить прямо в VS Code через официальное расширение Anthropic. Для API-запросов через BetterToken из России не нужен постоянный VPN или иностранная карта: укажите Base URL https://www.bettertoken.ai и свой API Key в ~/.claude/settings.json. Расширение подхватит общий конфиг Claude Code и будет обращаться к BetterToken вместо Anthropic напрямую.

Из каких слоёв состоит интеграция Claude Code с VS Code

Интеграция работает через три независимых слоя. Ошибка в любом из них может выглядеть одинаково — Claude Code «не отвечает», — но причина и решение разные.

Слой 1 — CLI. claude устанавливается на уровне системы. Расширение VS Code использует собственную копию CLI для чат-панели, но для запуска команды claude в интегрированном терминале нужна отдельная установка CLI.

Слой 2 — Расширение VS Code. Официальное расширение Claude Code от Anthropic предоставляет графический интерфейс: side-by-side diff, @-упоминания файлов, историю сессий. Требует VS Code 1.94.0 или выше.

Слой 3 — API Endpoint. Claude Code по умолчанию обращается к API Anthropic. Для работы через BetterToken достаточно задать ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN в конфиге — расширение передаёт их в Claude Code автоматически.

Такое разделение помогает при диагностике: успешная запись в Dashboard подтверждает, что BetterToken принял запрос. Состояние интеграции с IDE нужно отдельно проверить по контексту текущего файла и diff.

При подключении к API Endpoint BetterToken из России не требуется VPN, а также не нужна иностранная виртуальная карта. Используйте свой аккаунт BetterToken, создайте API Key в личном кабинете и возьмите Base URL из документации.

Создать свой API Key и настроить Claude Code по документации BetterToken: docs.bettertoken.ai/ai-tools/claude-code

Как создать API Key BetterToken и подключить Endpoint

Шаг 1. Создайте аккаунт и API Key

Откройте bettertoken.ai, зарегистрируйтесь и перейдите в раздел управления ключами. Создайте новый API Key и скопируйте его — он понадобится в следующем шаге.

Шаг 2. Запомните Base URL

Для Claude Code используйте Anthropic-совместимый Base URL:

https://www.bettertoken.ai

Не добавляйте /v1 в конце — Claude Code дописывает путь к методам API автоматически. Адрес с /v1 нужен только для OpenAI-совместимых инструментов вроде Codex CLI.

Шаг 3. Отредактируйте `~/.claude/settings.json`

На macOS и Linux конфиг лежит в ~/.claude/settings.json. На Windows — в %USERPROFILE%\.claude\settings.json.

Добавьте блок env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "your_api_key_here"
  }
}

Замените your_api_key_here на ключ из шага 1. Если в файле уже есть другие поля, добавьте только секцию "env" — остальное не трогайте.

Этот файл читают и расширение VS Code, и CLI — настройки общие.

Шаг 4. Отключите экран входа в настройках расширения

Откройте настройки VS Code (Cmd+, на Mac или Ctrl+, на Windows/Linux), перейдите в Extensions → Claude Code и включите опцию Disable Login Prompt. Для стороннего API-провайдера эта настройка убирает экран входа Anthropic; конфигурацию env она не заменяет.

Как запустить Claude Code из VS Code

Шаг 5. Установите расширение

Нажмите Cmd+Shift+X (Mac) или Ctrl+Shift+X (Windows/Linux), найдите «Claude Code» от Anthropic и нажмите Install.

Если иконка расширения не появилась после установки — выполните в Command Palette команду Developer: Reload Window.

Минимальная версия VS Code: 1.94.0. Проверьте через Help → About.

Шаг 6. Откройте файл и запустите панель

Откройте любой файл в редакторе. Иконка Spark (✱) появляется в правом верхнем углу Editor Toolbar только при открытом файле. Нажмите на неё, чтобы открыть чат-панель.

Другие способы открыть панель:

Activity Bar — иконка Spark в левой боковой панели (видна всегда).
Command Palette (Cmd+Shift+P / Ctrl+Shift+P) → «Claude Code: Open in New Tab».
Status Bar → кнопка ✱ Claude Code в правом нижнем углу (работает без открытого файла).

Шаг 7. Проверьте, что Claude видит текущий файл

Выделите несколько строк кода. В нижней части поля ввода Claude Code отобразится количество выделенных строк — это подтверждает, что расширение читает текущий контекст. Нажмите Option+K (Mac) или Alt+K (Windows/Linux), чтобы вставить в запрос @-ссылку вида @file.ts#5-10.

Как проверить контекст, diff и запрос в Dashboard

Шаг 8. Отправьте тестовый запрос с низким риском

Откройте небольшой файл — скрипт или конфиг — и попросите Claude внести простое, обратимое изменение:

Добавь однострочный комментарий перед первой функцией, кратко описывающий, что она делает.

Или:

Переименуй переменную `tmp` в `result` в этом файле.

Цель — получить конкретное предложение об изменении, которое можно проверить визуально.

Шаг 9. Проверьте side-by-side diff

Когда Claude предложит правку, расширение покажет сравнение «до» и «после» с запросом разрешения. Проверьте предложенные изменения. Нажмите Accept или Reject.

Появление осмысленного diff подтверждает, что расширение получило ответ модели и связало правку с текущим файлом. Маршрут через BetterToken проверяется отдельно в Dashboard.

Шаг 10. Проверьте запрос в Dashboard BetterToken

Откройте bettertoken.ai и перейдите в Dashboard или историю запросов. Найдите запись с временем, совпадающим с тестовым запросом. Там можно сверить время, модель, статус, входящие, исходящие и кеш-токены, а также соответствующий расход.

Если в VS Code появился корректный diff, а в Dashboard — успешная запись с тем же временем, интеграция работает на всех трёх уровнях: расширение передало контекст, BetterToken обработал запрос, ответ вернулся в IDE.

Если результата нет, сопоставьте признаки:

нет ответа и записи в Dashboard — проверьте запуск расширения, env, Base URL и сетевое соединение;
в Dashboard есть запрос со статусом ошибки — откройте его и проверьте ключ, модель и текст ошибки;
в VS Code есть ответ или diff, но подходящей записи нет — перепроверьте Endpoint, время запроса и фильтры Dashboard; считать маршрут через BetterToken подтверждённым пока нельзя.

Что проверить, если интеграция не определяется

Иконка Spark не появляется

Иконка Spark в Editor Toolbar показывается только при открытом файле. Если файл открыт, а иконки нет:

Проверьте версию VS Code: нужна 1.94.0 или выше (Help → About).
Выполните Developer: Reload Window из Command Palette.
Временно отключите другие AI-расширения (Cline, Continue, GitHub Copilot) — они иногда конфликтуют с иконками в Editor Toolbar.

Альтернатива: используйте ✱ Claude Code в Status Bar — эта кнопка работает без открытого файла.

VS Code не наследует переменные окружения из терминала

Если ANTHROPIC_BASE_URL задан в shell, но расширение всё равно предлагает войти через аккаунт — VS Code, запущенный через Spotlight или меню приложений, не унаследовал переменные из shell.

Запустите VS Code из терминала:

code .

Это передаёт текущее окружение в VS Code. Если такой способ запуска неудобен, продублируйте переменные в VS Code через Extensions → Claude Code → environmentVariables — поле в настройках расширения.

Расширение снова просит войти в аккаунт

Проверьте, что Disable Login Prompt включён в Extensions → Claude Code. Для стороннего провайдера эта опция отключает экран входа Anthropic, но переменные подключения по-прежнему должны быть заданы отдельно.

Ошибка аутентификации: 401 или нет ответа

Проверьте по порядку:

Base URL — должен быть https://www.bettertoken.ai без /v1 в конце. Лишний суффикс /v1 вызывает 404 на некоторых методах.
API Key — убедитесь, что в значении нет пробелов, переносов строки или лишних кавычек.
Конфликт переменных — если в shell уже задан ANTHROPIC_AUTH_TOKEN или ANTHROPIC_BASE_URL с другим значением, он может переопределить ожидаемую конфигурацию. Удалите конфликтующие переменные из профиля shell или запустите VS Code через code ., чтобы видеть именно окружение текущей сессии.

Разграничить проблемы помогает Dashboard: отсутствие записи указывает, что сначала нужно проверить отправку запроса, Endpoint и сеть; ошибка 401 в записи указывает на ключ или его формат.

Полная документация по настройке Claude Code через BetterToken: docs.bettertoken.ai/ai-tools/claude-code

Claude Code в VS Code: как подключить и проверить интеграцию