AI Coding

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

Настройка Claude Code в VS Code: API Key, проверка подключения и diff, ошибки 401, отсутствие ответа и конфиг, который не видит расширение.

BetterToken

Редакция

29 июл. 2026 г.7 мин чтения

Содержание

Claude Code в VS Code можно подключить через официальный вход Anthropic или через совместимый API Endpoint с собственным ключом. Это разные маршруты: сначала выберите способ авторизации, затем отдельно проверьте расширение, конфиг Claude Code, фактический запрос и получившийся diff.

Для BetterToken используется второй маршрут: возьмите актуальные поля из инструкции Claude Code и сохраните их в приватном конфиге или перенных окружения. Не добавляйте Token в Git, пример кода, скриншот или поисковый запрос; если ключ уже стал публичным, отзовите его и создайте новый.

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

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

Слой 1 — CLI. Официальное расширение включает приватную копию Claude Code CLI для своей чат-панели. Установка расширения не добавляет команду claude в PATH: чтобы запускать её во встроенном терминале VS Code, установите самостоятельный CLI по актуальной инструкции Anthropic.

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

Слой 3 — API Endpoint. Claude Code по умолчанию обращается к API Anthropic. Для BetterToken нужно отдельно настроить provider по его текущей инструкции: опции интерфейса расширения не заменяют эту конфигурацию.

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

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

Настройку Endpoint сверяйте с текущей документацией BetterToken.

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

Хотите проверить интеграцию на собственном проекте? Создать аккаунт BetterToken

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

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

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

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

https://bettertoken.ai

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

Шаг 3. Задайте переменные для расширения VS Code

Откройте пользовательский settings.json VS Code и добавьте отдельный массив claudeCode.environmentVariables:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://bettertoken.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your_api_key_here" },
    { "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "value": "1" },
    { "name": "API_TIMEOUT_MS", "value": "3000000" }
  ]
}

Замените your_api_key_here на ключ из шага 1. Если в файле уже есть другие поля, добавьте только показанный массив — остальное не трогайте. Затем выполните Developer: Reload Window или полностью перезапустите VS Code.

Если вы хотите запускать claude именно во встроенном терминале, сначала установите самостоятельный CLI. Для macOS, Linux и WSL текущая команда Anthropic: curl -fsSL https://claude.ai/install.sh | bash; команды для Windows и альтернативные способы установки приведены в официальной инструкции. Для терминального CLI те же два поля сохраняются в секции env файла ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json) по инструкции BetterToken.

Шаг 4. При необходимости отключите экран входа

Если после полной настройки provider расширение всё ещё показывает экран входа, откройте настройки VS Code (Cmd+, на Mac или Ctrl+, на Windows/Linux), перейдите в Extensions → Claude Code и включите Disable Login Prompt. Эта опция меняет только поведение интерфейса: она не выбирает API-provider и не заменяет claudeCode.environmentVariables.

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

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

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

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

Проверьте версию через Help → About. Для текущей версии расширения нужен VS Code 1.94.0 или новее; перед установкой также сверьте требование с актуальной страницей Anthropic.

Шаг 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 и проверьте текущие требования расширения через Help → About и Marketplace.
Выполните 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 — поле в настройках расширения.

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

Сначала сверьте все четыре значения claudeCode.environmentVariables с текущей инструкцией BetterToken и перезапустите VS Code. Если после этого остался только экран входа, включите Disable Login Prompt в Extensions → Claude Code. Опция не заменяет настройку provider.

Расширение не читает изменённый конфиг

Проверьте пользовательский settings.json VS Code и валидность JSON: лишняя запятая или незакрытая скобка не позволит загрузить claudeCode.environmentVariables. Затем выполните Developer: Reload Window. Если значения также заданы в shell или конфиге CLI, убедитесь, что там нет старого Base URL или ключа; при сомнении сверяйте актуальные имена полей с текущей документацией BetterToken, а не со старым фрагментом из Blog.

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

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

Base URL — должен быть https://bettertoken.ai без /v1 в конце; с /v1 Claude Code обращается не к тому протокольному маршруту.
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