Настройка расширения Claude Code для VS Code: бэкенд, модели и песочница

Claude Code в VS Code — это полноценный агент для программирования на боковой панели. Не инструмент автодополнения, а многошаговый решатель задач, который читает ваш проект, редактирует файлы и выполняет команды. Расширение для VS Code использует тот же движок, что и CLI, поэтому слеш-команды, осведомлённость о CLAUDE.md и вызовы инструментов MCP работают так же, как в терминале. Что делает настройку особенно интересной — это уровень бэкенда: каждый вызов inferencing проходит через управляемую вами конечную точку, а перенаправление этой точки на Novita AI открывает доступ к моделям Claude, а также к более широкому каталогу открытых альтернатив для задач программирования — по ценам, которые делают интенсивную работу агента практичной.

Что делает Claude Code в VS Code

Расширение Claude Code для VS Code — это панель на боковой панели, а не встроенный движок автодополнения. Откройте её, опишите задачу, и Claude Code выполнит многошаговую работу: чтение файлов, запись изменений, запуск shell-команд, ожидание вашего одобрения изменений перед их применением. Это различие важно, потому что разработчики часто ищут “claude code vs code”, ожидая опыта, подобного Copilot — однострочных подсказок, которые дополняют код по мере ввода. Это не тот случай. Для автодополнений существуют другие инструменты. Claude Code в VS Code предназначен для задач: написать тесты для этого модуля, рефакторить обработчик аутентификации, объяснить, почему этот запрос медленный, создать pull request с сегодняшними изменениями.

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

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

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

Как добавить Claude Code в VS Code

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

Если предпочитаете командную строку:

code --install-extension Anthropic.claude-code

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

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

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

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

Как работает бэкенд LLM API

Понимание трёхуровневой архитектуры проясняет каждое решение по настройке:

1. Уровень UI: Расширение VS Code (или CLI, или настольное приложение — это взаимозаменяемые интерфейсы).
2. Уровень логики агента: Движок Claude Code — определения инструментов, управление сессиями, чтение файлов, выполнение команд.
3. Уровень LLM API: Конечная точка inferencing, обрабатывающая все вызовы языковых моделей.

По умолчанию уровень LLM API указывает на api.anthropic.com. Claude Code отправляет запросы в формате Anthropic Messages API. Ключевая деталь: ANTHROPIC_BASE_URL перенаправляет все эти запросы на любую совместимую с Anthropic конечную точку. Novita AI предоставляет тот же формат Messages API по адресу https://api.novita.ai/anthropic, поэтому переключение прозрачно для уровня логики агента — Claude Code не знает и не заботится, пришёл ли ответ с серверов Anthropic или от Novita.

Ещё три переменные окружения завершают настройку:

• ANTHROPIC_AUTH_TOKEN — ваш API-ключ для выбранного провайдера.
• ANTHROPIC_MODEL — идентификатор модели для основных задач.
• ANTHROPIC_SMALL_FAST_MODEL — идентификатор модели для быстрых фоновых задач, таких как суммаризация и сжатие контекста.

Установите их перед запуском VS Code, и расширение унаследует их из окружения оболочки.

Подключение Claude Code к Novita AI

Шаг 1: Получите API-ключ Novita AI

Зарегистрируйтесь на novita.ai и перейдите на страницу Управление ключами. Сгенерируйте новый ключ и сразу его скопируйте — он больше не будет показан.

Шаг 2: Установите переменные окружения

В macOS или Linux экспортируйте переменные в терминале перед запуском VS Code:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<ваш-api-ключ-novita>"
export ANTHROPIC_MODEL="zai-org/glm-4.6"
export ANTHROPIC_SMALL_FAST_MODEL="zai-org/glm-4.6"

В Windows (командная строка):

set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<ваш-api-ключ-novita>
set ANTHROPIC_MODEL=zai-org/glm-4.6
set ANTHROPIC_SMALL_FAST_MODEL=zai-org/glm-4.6

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

code .

Шаг 3: Проверьте подключение

Откройте панель Claude Code и отправьте короткое тестовое сообщение. Если расширение отвечает, маршрутизация работает. Списание средств теперь происходит через Novita AI — ваш аккаунт Anthropic не тарифицируется.

Чтобы сделать конфигурацию постоянной, добавьте экспорт в профиль оболочки (~/.zshrc, ~/.bashrc и т.д.) или используйте .env-файл уровня проекта с direnv для переключения моделей между проектами.

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

После перенаправления через Novita AI вы не ограничены моделями Claude. Каталог LLM Novita включает модели с открытым исходным кодом, которые напрямую конкурируют с закрытыми аналогами по бенчмаркам, важным для агентных задач.

GLM-4.6 от Zhiyu AI — практичный пример. Она имеет окно контекста в 200 тыс. токенов и достигает 48,6% побед против Claude Sonnet 4 в реальных оценках кодинга. Для агентных рабочих процессов, где важен длинный контекст (отладка больших кодовых баз, чтение полных наборов тестов), такое окно контекста — практическое преимущество, а не просто цифра в спецификации. Идентификатор модели Novita — zai-org/glm-4.6.

Другие модели на платформе Novita, которые стоит оценить для задач программирования, включают DeepSeek R1 и Qwen 3 Coder — обе показали конкурентоспособные результаты на бенчмарках генерации кода и следования инструкциям. Та же переменная окружения ANTHROPIC_MODEL переключает между ними — никаких переустановок или новых интеграций.

Аргумент стоимости в пользу открытого кода: команды, использующие Claude Code в масштабе — большое количество запусков агента в CI-пайплайнах, многопользовательские установки с общими API-ключами Novita или длительные агентские сессии, потребляющие много токенов — обнаруживают, что модели с открытым кодом по ценам Novita создают существенную экономию в бюджете инфраструктуры. Модель, работающая на 90% от уровня Claude Sonnet 4 при 40% стоимости, меняет экономику непрерывной работы агентов.

Novita Agent Sandbox как среда выполнения

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

Novita Agent Sandbox предоставляет облачные среды выполнения, предназначенные именно для этого случая. Песочница — это микроВЭм, который стартует за милисекунды, выполняет код в изоляции от хостевой системы и читсо завершется, когд задача выпольнена. Нкаких остаточных сстоянний, нкакого влияния на локальную среду, нкакого ождания восствано вления ЦП вашего компьютетра.

Для пользователей Claude Code практический работый процесс: направляйте inferencing к конечной точке LLM Novita AI для вызовов языковых мделей, а для тяжёлых задач выполнения — сборок, запусков тестов, оценки кода — запускайте экземпляр Agent Sandbox через API Novita Agent Sandbox. Обе службы используют одну аутентификацию (тот же API-ключ Novita), поэтому отдельное управление учетными данными не требуется.

Команды, создающие автоматизированные пайплайны ревью кода или агенты Claude Code, интегрированные с CI, находят эту комбинацию особенно полезной: стоимость LLM остаётся предсказуемой благодаря по-токеновой тарификации Novita, а стоимость вычислений — предсказуемой благодаря посекундной оплате Agent Sandbox.

Ежедневные советы по работе в VS Code

Несколько приёмов, которые делают расширение практичным, а не просто диковинкой:

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

Прикрепляйте контекст с помощью #. Вместо описания, какой файл нужно посмотреть, введите #имяфайла, чтобы прикрепить его напрямую. Для рефакторинга #src/components/Button.tsx обнови обработчик onClick, чтобы использовать новый тип события быстрее, чем “посмотри компонент Button и…”

Используйте /compact проактивно. В длительной сессии Claude Code накапливает контекст. /compact суммирует разговор и уменьшает накладные расходы на токены. Запускайте его после завершения крупной задачи, перед началом следующей.

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

Разделяйте инструкции по проекту и инструкции сесии. CLAUDE.md предназначен для постоянного контекста проекта (команды сборки, архитектура, стиль кода). Временные инструкции для текущей задачи помещайте в промпт сессии. Не засоряйте CLAUDE.md одноразовыми указаниями.

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

Где находится документация расширения Claude Code для VS Code?

Официальная документация расширения поддерживается Anthropic по адресу claude.ai/code. Примечания к выпускам и журнал изменений видны в панели расширений VS Code в списке Claude Code.

Бесплатно ли расширение Claude Code для VS Code?

Само расширение бесплатно для установки. Стоимость использования зависит от конфигурации вашего бэкенда. С аккаунтом Anthropic вы платите за токен или используете кредиты подписки. С маршрутизацией через Novita AI вы платите по тарифу Novita за токен, и платежи Anthropic не взимаются. Новые аккаунты Novita получают бесплатные пробные кредиты при регистрации.

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

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

В чем разница между Claude Code и Cline в VS Code?

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

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

Да. Используйте direnv с файлами .env уровня проекта, чтобы ограничить ANTHROPIC_MODEL конкретным каталогом. Когда вы открываете этот проект в VS Code из терминала с активным direnv, расширение наследует настройку модели для проекта.

Novita AI — это облачная AI-платформа, которая предоставляет разработчикам простой способ развёртывания AI-моделей через наш простой API, а также доступные и надёжные GPU-облака для сборки и масштабирования.

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

• Claude Code в VS Code: установка расширения, настройка IDE и переключение на Novita AI
• Документация CLI Claude Code: установка, слеш-команды и интеграция LLM API
• Как интегрировать Novita AI LLM API с Cline в VS Code