Claude Code VSCode Extension: установка, настройка и маршрутизация к Novita AI

Claude Code VSCode Extension: установка, настройка и маршрутизация к Novita AI

Расширение Claude Code для VS Code устанавливается прямо из маркетплейса и работает нативно в вашем редакторе, так что вам не нужно переключаться между вкладкой браузера и рабочей областью. Оно использует тот же движок Claude Code, который лежит в основе CLI, поэтому всё — от слэш-команд до редактирования файлов и вызовов инструментов MCP — работает одинаково, только на боковой панели редактора. PyCharm и остальные продукты семейства JetBrains получают такую же поддержку через специальный плагин для JetBrains. А поскольку оба интерфейса считывают ANTHROPIC_BASE_URL из окружения, переключение LLM-бэкенда на API Novita AI — с более широким выбором моделей — требует изменения всего одной переменной окружения.

Что на самом деле делает расширение для VS Code

Расширение Claude Code для VS Code — это не просто чат-вкладка, прикреплённая к редактору. Оно предоставляет полноценный агент Claude Code на боковой панели: тот же REPL-подобный интерфейс, тот же набор инструментов, та же непрерывность сессии. Когда вы просите его отрефакторить функцию или написать тесты для открытого файла, он читает и редактирует эти файлы непосредственно в вашей рабочей области — без использования буфера обмена.

Конкретные возможности расширения:

  • Многофайловые правки с встроенными diff. Claude Code предлагает изменения и показывает diff, который можно принять или отклонить, не покидая редактор.
  • Слэш-команды. /compact, /init, /memory, /clear и остальные работают так же, как в CLI.
  • Прикрепление контекста. Префикс # позволяет прикрепить конкретные файлы, папки или символы в качестве контекста для запроса.
  • Поддержка CLAUDE.md. Инструкции по проекту и стандарты кодирования, записанные в CLAUDE.md, автоматически загружаются при старте сессии.
  • Вызовы инструментов MCP. Любые MCP-серверы, зарегистрированные в вашей конфигурации Claude Code, доступны внутри расширения.

Чего оно не делает: не добавляет автодополнение AI в буфере редактора. Для этого существуют такие инструменты, как Copilot или Cline. Claude Code в VS Code — это агент: вы даёте ему задачу, и он выполняет несколько шагов, а не просто встроенное дополнение.

Установка Claude Code в VS Code

Откройте панель расширений в VS Code (Ctrl+Shift+X на Windows/Linux, Cmd+Shift+X на macOS). Найдите Claude Code и выберите расширение, опубликованное Anthropic. Нажмите Install.

Либо выполните эту команду в терминале:

code --install-extension Anthropic.claude-code

После установки значок Claude появится на панели действий VS Code слева. Нажмите на него, чтобы открыть панель Claude Code.

Аутентификация при первом запуске. Расширение предложит вам войти. У вас есть два пути:

  • Учётная запись Anthropic (подписка или оплата через консоль): Пройдите OAuth-авторизацию в браузере.
  • Маршрутизация через API-ключ к Novita AI: Пропустите аутентификацию Anthropic. Установите переменные ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN в вашем окружении перед запуском VS Code, и расширение будет использовать их. Полные инструкции — в следующем разделе.

Автоматические обновления. VS Code обновляет расширение в фоновом режиме при перезапуске редактора. Вам не нужно управлять версиями вручную.

Ежедневное использование Claude Code в VS Code

После открытия панели рабочий процесс прост. Введите запрос, Claude Code читает вашу рабочую область и предлагает действия. Перед редактированием файла он по умолчанию показывает diff и ожидает подтверждения.

Несколько шаблонов, которые делают ежедневное использование эффективным:

Ссылайтесь на файл, который просматриваете. Наберите #, а затем имя файла, чтобы явно прикрепить его как контекст. Для файла, уже открытого в активном редакторе, Claude Code обычно подхватывает его автоматически, но # полезен, когда нужно закрепить конкретный файл в многофайловой задаче.

Выполните /init один раз в новом проекте. Это создаёт CLAUDE.md в корне репозитория, где вы можете хранить инструкции, специфичные для проекта: предпочитаемые библиотеки, архитектурные заметки, соглашения по тестированию. Claude Code читает его при каждом запуске сессии, так что вам не придётся повторяться.

Используйте /compact, когда сессия становится длинной. Как и в CLI, расширение сжимает историю разговора по требованию, чтобы освободить контекст для текущей задачи.

Следите за списком выполняемых инструментов. В нижней части панели VS Code показывает, какой инструмент в данный момент вызывает Claude Code (чтение файлов, bash-команды, веб-поиск). Это полезно для понимания происходящего в длительных автоматизированных задачах.

Отмена — ваш друг. Все изменения файлов проходят через стандартную файловую систему VS Code, поэтому Ctrl+Z отменяет их, как и любые ручные правки. Для изменений Claude Code нет отдельного стека отмены.

Маршрутизация расширения к Novita AI

Расширение VS Code считывает ANTHROPIC_BASE_URL из окружения при запуске — ту же переменную, что и CLI. Установка её на совместимый с Anthropic эндпоинт Novita AI перенаправляет все вызовы API от серверов Anthropic. Вы получаете доступ к актуальным хостируемым Novita моделям для кодирования и использования инструментов, таким как Kimi K2.7 Code, GLM 5.2, DeepSeek V4 Pro и MiniMax M3. Оплата производится через ваш аккаунт Novita AI по тарифам Novita за токены.

Получите API-ключ Novita AI

Зарегистрируйте аккаунт Novita AI, чтобы получить бесплатные пробные кредиты. Перейдите в Управление ключами, создайте новый ключ и скопируйте его. Этот ключ заменит ваш API-ключ Anthropic при маршрутизации через Novita.

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

macOS и Linux — добавьте их в ваш профиль оболочки (.zshrc, .bashrc или аналог), затем перезагрузите его:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Ваш API-ключ Novita>"
export ANTHROPIC_MODEL="moonshotai/kimi-k2.7-code"
export ANTHROPIC_SMALL_FAST_MODEL="minimax/minimax-m3"
source ~/.zshrc   # или ~/.bashrc

Windows (постоянные — сохраняются после перезагрузки) — используйте PowerShell для установки переменных окружения на уровне пользователя:

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.novita.ai/anthropic","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","<Ваш API-ключ Novita>","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL","moonshotai/kimi-k2.7-code","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL","minimax/minimax-m3","User")

Перезапустите VS Code после их установки, чтобы расширение прочитало обновлённое окружение.

Windows (только для сессии):

set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Ваш API-ключ Novita>
set ANTHROPIC_MODEL=moonshotai/kimi-k2.7-code
set ANTHROPIC_SMALL_FAST_MODEL=minimax/minimax-m3

После установки запустите VS Code из той же оболочки. Расширение подхватит переменные при запуске. Вам не нужно входить в Anthropic — Novita обрабатывает аутентификацию через API-ключ.

Выбор модели

ANTHROPIC_MODEL указывает Claude Code, какую модель использовать для основных задач; ANTHROPIC_SMALL_FAST_MODEL управляет фоновыми операциями, такими как сводки файлов. Любая модель, доступная через LLM API Novita AI, может быть здесь указана. Модели, часто используемые с Claude Code на Novita:

  • Kimi K2.7 Code — текущая рекомендация Novita для агентной работы в IDE, с сильными способностями к рассуждению на уровне репозитория, редактированию кода и длительному многошаговому выполнению.
  • GLM 5.2 — хороший выбор, когда нужно более сильное общее рассуждение и большой контекст для анализа кодовой базы, документации и смешанных рабочих процессов кодирования и написания текстов.
  • DeepSeek V4 Pro — сбалансированный вариант для сложных задач реализации, где нужна глубина без перехода на самый дорогой уровень.
  • MiniMax M3 — экономичный партнёр для ANTHROPIC_SMALL_FAST_MODEL, особенно для быстрых сводок, циклов поиска и рабочих процессов с вызовом инструментов.

Для большинства интерактивных задач в VS Code установка ANTHROPIC_MODEL на Kimi K2.7 Code и ANTHROPIC_SMALL_FAST_MODEL на MiniMax M3 даёт практичный баланс качества кодирования, надёжности использования инструментов и контроля затрат.

Чтобы вернуться к стандартной маршрутизации Anthropic, сбросьте переменные окружения:

unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_SMALL_FAST_MODEL

Или запустите VS Code из оболочки, где эти переменные никогда не были установлены.

Интеграция с PyCharm и JetBrains

Claude Code поставляется с официальным плагином для платформы JetBrains, который охватывает PyCharm, IntelliJ IDEA, WebStorm, GoLand, Rider и остальные продукты семейства JetBrains.

Установка плагина

Откройте Settings → Plugins в вашей IDE JetBrains, переключитесь на вкладку Marketplace и найдите Claude Code. Нажмите Install, затем перезапустите IDE по запросу.

Либо загрузите файл плагина с сайта JetBrains Marketplace и установите его через Settings → Plugins → Install Plugin from Disk.

Первый запуск

После установки панель Claude Code появляется на боковой панели IDE или в области окна инструментов в зависимости от вашей компоновки. Первый запуск запрашивает аутентификацию, аналогично VS Code.

Маршрутизация PyCharm к Novita AI

Плагин JetBrains считывает те же переменные окружения, что и расширение VS Code и CLI. Установите ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL и ANTHROPIC_SMALL_FAST_MODEL в вашем профиле оболочки перед запуском IDE, и плагин будет маршрутизировать через Novita.

Если вы запускаете PyCharm из лаунчера рабочего стола, а не из терминала (что часто бывает в macOS и Linux), IDE может не унаследовать ваше окружение оболочки. Надёжное решение — использовать файл .env для каждого проекта или установить переменные на уровне системы, а не в профиле оболочки. В macOS, в частности, переменные, установленные через launchctl setenv, видны приложениям с графическим интерфейсом.

Расширение IDE vs. CLI: когда что использовать

Расширение и CLI используют один и тот же движок. Практическое различие — в контексте и интеграции.

Расширение VS Code / JetBrains CLI
Навигация по файлам Клик, чтобы открыть; # для прикрепления Читает из текущей рабочей директории; указывайте пути явно
Просмотр diff Встроенный в редактор Вывод в терминал
Несколько проектов Одна панель на окно Отдельные сессии на директорию
CI/CD и автоматизация Не подходит Флаг -p для неинтерактивных пакетных запусков
Конвейеры и скриптинг Не поддерживается Полная поддержка Unix-конвейеров
Маршрутизация к Novita AI Переменная окружения ANTHROPIC_BASE_URL То же самое

Расширение — лучший выбор, когда ваш основной рабочий процесс — интерактивное редактирование кода. CLI — правильный выбор, когда вы автоматизируете задачи, запускаете Claude Code в скриптах, интегрируете с CI или строите что-то поверх Claude Code SDK. Если ваш список кандидатов включает в первую очередь терминальные агенты для кодирования, смотрите OpenAI Codex vs Claude Code для более глубокого сравнения CLI с CLI.

Песочница агентов Novita AI

Когда вы переходите от интерактивной разработки к автоматизированным конвейерам, расширение VS Code перестаёт быть правильным инструментом. Запуск Claude Code без головы — пакетные ревью PR, автоматическая генерация тестов, многорепозиторные рефакторинги, агенты кодирования, интегрированные с CI — требует изолированной среды выполнения, а не локальной сессии IDE.

Песочница агентов Novita AI предоставляет микро-ВМ на базе Firecracker для программного запуска агентов. Каждая песочница запускается чистой, работает в полной изоляции от вашей машины разработки и оплачивается посекундно. Практические сценарии использования:

  • Пакетное ревью PR. Создайте песочницу для каждого PR, запустите Claude Code с запросом на ревью, соберите результат, затем удалите песочницу. Локальное состояние не накапливается между запусками.
  • Автоматическая генерация тестов. Запустите песочницу из CI при появлении новой ветки, пусть Claude Code прочитает diff и сгенерирует тесты, затем закоммитьте результаты обратно через API репозитория.
  • Тестовые стенды для оценки. Запустите одну и ту же задачу кодирования в параллельных песочницах с разными конфигурациями моделей. Каждая песочница использует ту же маршрутизацию ANTHROPIC_BASE_URL, что и локально — меняйте ANTHROPIC_MODEL для каждой песочницы, чтобы сравнить Kimi K2.7 Code, GLM 5.2, DeepSeek V4 Pro и MiniMax M3 друг с другом на реальных задачах.
  • Многоагентные рабочие процессы. Песочницы компонуемы. Каждый под-агент получает своё изолированное окружение; результаты собираются выше по потоку, при этом ни один агент не касается файловой системы другого.

Интерфейс между использованием VS Code и песочницей — это тот же слой переменных окружения. Рабочий процесс, который маршрутизируется через совместимый с Anthropic эндпоинт Novita AI в расширении, будет работать без головы в песочнице без каких-либо изменений кода.

Часто задаваемые вопросы

Нужна ли мне платная подписка Anthropic для использования расширения VS Code?

Нет — если вы направляете расширение к Novita AI через ANTHROPIC_BASE_URL, все платежи проходят через ваш аккаунт Novita AI. Учётная запись Anthropic не требуется и не оплачивается.

Как установить расширение Claude Code для VS Code?

Откройте панель расширений в VS Code (Ctrl+Shift+X), найдите Claude Code (издатель: Anthropic) и нажмите «Install». Или выполните code --install-extension Anthropic.claude-code из терминала.

Работает ли расширение Claude Code в Cursor?

Cursor — это форк VS Code, и он поддерживает большинство расширений VS Code. Расширение Claude Code может установиться, но в Cursor уже есть собственная встроенная интеграция с Claude. Запуск обоих одновременно может привести к дублирующимся предложениям и конфликтующим потокам аутентификации. Большинство разработчиков используют что-то одно.

Существует ли браузерное расширение Claude?

Официального браузерного расширения Claude от Anthropic нет. Claude Code работает как расширение VS Code, плагин JetBrains, CLI, десктопное приложение и через веб-интерфейс на claude.ai/code — но не как браузерное расширение, подключающееся к произвольным веб-страницам.

Как переключить модель без перезапуска VS Code?

Измените ANTHROPIC_MODEL в вашем профиле оболочки, затем откройте VS Code из нового сеанса терминала. Внутри работающего сеанса VS Code нет переключателя моделей на панели — переменная окружения считывается при запуске.

Можно ли использовать разные модели для разных проектов?

Да. Установите ANTHROPIC_MODEL в файле .env на уровне проекта или в инструкции CLAUDE.md, либо используйте direnv для ограничения переменных окружения конкретными директориями. Claude Code учитывает значения окружения на уровне сессии, поэтому маршрутизация для каждого проекта достижима с помощью стандартных инструментов для dotfile.

Чем интеграция Claude с VS Code отличается от использования Cline?

Cline — это расширение, которое превращает VS Code в среду агентного кодирования с использованием любого бэкенда, совместимого с OpenAI. Claude Code — это собственный агент Anthropic, доступный как расширение VS Code, со своим набором инструментов и циклом рассуждений. Главное практическое различие: Cline даёт больше контроля над тем, какой провайдер и модель управляют циклом, в то время как Claude Code по умолчанию тесно интегрирован с семейством моделей Claude — хотя ANTHROPIC_BASE_URL позволяет перенаправить его на совместимый эндпоинт Novita AI.

Рекомендуемые статьи