К содержимому
Блог

VS Code Claude: подключение расширения и терминала

VS Code Claude: подключение расширения и терминала

VS Code Claude подключается двумя способами: через официальное расширение Claude Code или через CLI во встроенном терминале редактора. Оба варианта позволяют работать с проектом, но настройку окружения нужно проверить отдельно. Для Relay укажите корневой адрес https://relay-llm.ru, ключ Relay и модель из каталога. Ниже есть пример для терминала и пользовательских настроек расширения, а также порядок проверки, если вместо ответа появляется экран входа или ошибка модели.

Коротко

  • Начните с официального расширения или CLI, выбрав один способ запуска.

  • Адрес Anthropic Messages задаётся без /v1.

  • Проверьте короткий запрос и запись в журнале до работы с репозиторием.

VS Code Claude: расширение или терминал

Расширение добавляет панель Claude Code в VS Code. Терминальный вариант запускает команду claude в оболочке внутри того же редактора. Visual Studio и Visual Studio Code относятся к разным редакторам; инструкция ниже описывает VS Code. Случайное расширение со словом Claude в названии может использовать другой способ авторизации.

Выберите вариант по рабочему процессу. Для обсуждения выделенного фрагмента удобна панель; для привычного CLI можно остаться во встроенном терминале. Наличие редактора не меняет протокол API. Права на запись файлов и команды задаёт Claude Code, а Relay обслуживает вызовы модели.

Установку клиента сверяйте с официальным руководством VS Code. Названия команд и расположение настроек могут отличаться в вашей версии. Инструкция подключения Claude Code к Relay содержит настройки моделей и варианты для разных оболочек.

Как запустить Claude Code в терминале VS Code

Откройте новый терминал в тестовой папке. Если CLI уже установлен, команда проверки версии должна завершаться без ошибки. Пример рассчитан на Bash или Zsh в macOS/Linux; команды export не подходят для PowerShell.

bash
claude --version
export ANTHROPIC_BASE_URL="https://relay-llm.ru"
export ANTHROPIC_AUTH_TOKEN="sk-demo-not-a-real-key"
export ANTHROPIC_MODEL="claude-opus-4-6"

В примере вымышленный ключ: для настоящего запроса задайте секрет локально. Создайте его в кабинете Relay, сохраните вне репозитория и назначьте отдельные лимиты для редактора. Не копируйте настоящий токен в общую инструкцию команды.

Запустите CLI самостоятельно после настройки окружения. Перед работой проверьте источник авторизации и адрес в статусе клиента. В интерактивной версии Claude Code это команда /status. Если он использует прежний вход или старый адрес, сначала разберите конфигурацию, а не начинайте редактирование проекта.

Где задать переменные расширению

Редактор, запущенный из меню приложений, может не получить переменные вашей оболочки. Экспорт из уже открытого терминала не меняет окружение запущенного процесса VS Code. Для расширения настройте переменные в пользовательских настройках редактора по его руководству.

В Relay приведён вариант с claudeCode.environmentVariables. Ниже минимальный блок для основного сеанса. Добавьте его в существующий JSON настроек пользователя, не заменяя остальные параметры и не сохраняя секрет в проектном .vscode/settings.json.

json
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://relay-llm.ru" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-demo-not-a-real-key" },
    { "name": "ANTHROPIC_MODEL", "value": "claude-opus-4-6" }
  ]
}

Этот блок задаёт основную модель. Фоновые задачи, псевдонимы моделей и субагенты могут выбирать другие идентификаторы. Для них возьмите полный блок из интеграции Relay и сверяйте поддерживаемые переменные с руководством установленного клиента. Не переносите незнакомые параметры из чужой версии.

Каталог моделей

Как проверить подключение без изменения файлов

Создайте учебный файл с короткой функцией, откройте его и попросите объяснить результат вызова без правок и команд. Убедитесь, что появился новый ответ. Затем найдите запись в журнале запросов по времени и ключу: она покажет модель, статус и стоимость обращения.

Если API отвечает, но файл не меняется, это ещё не ошибка Relay. Проверьте режим клиента, разрешения на запись и выбранный рабочий каталог. Для проверки самой связи достаточно ответа модели; право изменять проект проверяется следующим отдельным действием.

Для первой правки попросите изменить только учебный файл. Просмотрите diff и запустите его проверку. В рабочем проекте используйте ветку или отдельную копию; не давайте тестовой сессии доступ к production-секретам.

Почему Claude Code в VS Code не отвечает

СимптомЧто проверитьКак исправить
Экран входа вместо API-сеансаДошёл ли токен до процессаПроверьте настройки выбранного способа запуска
401 invalid_api_keyКлюч и его статусПроверьте ключ отдельно, при необходимости перевыпустите
404 not_foundБазовый адресУберите добавленный вручную /v1 для Messages-клиента
404 model_not_foundОсновную и фоновые моделиСкопируйте доступные ID из каталога
402 или 429Код отказа и ограниченияСверьтесь с документацией расходов и лимитов

Если терминал работает, а расширение нет, сравните адрес, ключ и модель именно этих двух запусков. Переустановка SDK не исправит токен, который остался в другом профиле. Не меняйте все параметры сразу: исправляйте одно проверенное расхождение.

Для разбора сохраняйте HTTP-статус и x-request-id, а не секрет и приватные файлы. Подробные причины ответов собраны в справочнике ошибок; частота запросов описана в документации лимитов.

VS Code Claude можно использовать без расширения?

Да. Установленный CLI Claude Code можно запускать во встроенном терминале. Настройки окружения относятся к процессу CLI, а не автоматически ко всему редактору.

Почему Claude Code VSCode не видит ключ из терминала?

У терминала и расширения могут быть разные окружения. Проверьте пользовательские настройки расширения и источник авторизации нового сеанса.

Достаточно указать модель только в ANTHROPIC_MODEL?

Для основного сеанса это задаёт модель, но фоновые задачи и субагенты могут иметь собственный выбор. Проверьте полный блок интеграции для вашей версии клиента.

Подключить Claude Code к Relay

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.