Claude Code в VS Code, Cursor и JetBrains: расширение и API-ключ

Коротко: как подключить Claude Code к VS Code

У Claude Code есть официальное расширение для VS Code от Anthropic — оно называется «Claude Code» и ставится из стандартного магазина расширений (идентификатор anthropic.claude-code). То же расширение устанавливается в Cursor и другие форки VS Code. Для IntelliJ IDEA, PyCharm, WebStorm и остальных IDE от JetBrains есть отдельный плагин в JetBrains Marketplace.

Чтобы расширение работало не через вход в аккаунт Anthropic, а по API-ключу через сторонний шлюз, нужно передать процессу Claude Code две переменные: ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN. Надёжнее всего прописать их в блоке env файла ~/.claude/settings.json — этот файл общий для расширения и терминальной версии, поэтому настройка сработает везде, как бы вы ни запускали IDE.

Ниже — пошагово для каждой среды, плюс разбор ситуаций, когда расширение «не видит» ключ.

• VS Code: расширение «Claude Code», нужна версия VS Code 1.94.0 или новее.
• Cursor: то же расширение или команда claude во встроенном терминале.
• JetBrains: плагин Claude Code [Beta] плюс установленный CLI.
• Ключ и адрес: блок env в ~/.claude/settings.json — работает для всех трёх.

Расширение для VS Code: установка и возможности

Откройте панель расширений (Ctrl+Shift+X на Windows и Linux, Cmd+Shift+X на macOS), найдите «Claude Code» и нажмите Install. Если после установки значок не появился, выполните в палитре команд «Developer: Reload Window». Официальная документация требует VS Code версии 1.94.0 или новее.

Claude Code в интерфейсе VS Code обозначается значком-искрой (Spark). Быстрее всего открыть панель кликом по нему в правом верхнем углу редактора — значок виден, только когда открыт какой-нибудь файл. Ещё варианты: значок в боковой панели Activity Bar со списком сессий или палитра команд с запросом «Claude Code».

Что даёт расширение по сравнению с голым терминалом: предложенные правки показываются как дифф прямо в редакторе, план работы можно прочитать и поправить до запуска, выделенный фрагмент кода автоматически попадает в контекст, а сочетание Alt+K (Option+K на Mac) вставляет @-упоминание файла с номерами строк. Есть история разговоров, несколько сессий во вкладках и контрольные точки — к любому сообщению можно откатить код или начать от него новую ветку разговора.

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

Подробнее: Как установить CLI Claude Code

Где в VS Code указать API-ключ Claude Code

По умолчанию при первом открытии панели расширение предлагает войти в аккаунт Anthropic. Если вы работаете по API-ключу через шлюз, вход не нужен — нужно, чтобы процесс Claude Code получил базовый URL и токен.

Способ первый и основной — файл настроек Claude Code ~/.claude/settings.json (на Windows это папка .claude в каталоге пользователя). В нём есть блок env: всё, что там указано, Claude Code выставляет как переменные окружения для своего процесса. Документация Anthropic прямо рекомендует хранить провайдерские настройки именно здесь, чтобы расширение и CLI работали одинаково.

• Строка $schema необязательна, но даёт автодополнение и проверку ключей прямо в VS Code.
• После правки файла перезапустите сессию в панели или выполните «Developer: Reload Window».
• Если окно входа всё равно появляется, включите в настройках расширения Disable Login Prompt (claudeCode.disableLoginPrompt) — эта опция предназначена для работы через сторонних провайдеров.
• Не кладите токен в .claude/settings.json внутри репозитория: этот файл обычно коммитится. Для личных значений есть пользовательский ~/.claude/settings.json или локальный .claude/settings.local.json.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://claude-gateway.ru/api",
    "ANTHROPIC_AUTH_TOKEN": "ваш_токен_из_кабинета"
  }
}

Другие способы передать ключ: environmentVariables и профиль оболочки

У самого расширения тоже есть настройка claudeCode.environmentVariables — переменные окружения для процесса Claude, заданные в settings.json редактора. Она работает только в VS Code и его форках, поэтому документация советует для общей конфигурации всё же использовать файл Claude Code. Мы бы применяли её, если нужно, чтобы в одном редакторе ключ был один, а в терминале — другой.

Третий вариант — переменные в профиле оболочки (~/.bashrc, ~/.zshrc) или системные переменные Windows. Так делают те, кто в основном работает в терминале. Подвох в том, что редактор получает эти переменные, только если он запущен из этой же оболочки.

# macOS / Linux — в ~/.zshrc или ~/.bashrc
export ANTHROPIC_BASE_URL="https://claude-gateway.ru/api"
export ANTHROPIC_AUTH_TOKEN="ваш_токен_из_кабинета"

# Windows PowerShell — постоянные переменные пользователя
setx ANTHROPIC_BASE_URL "https://claude-gateway.ru/api"
setx ANTHROPIC_AUTH_TOKEN "ваш_токен_из_кабинета"

Подробнее: Подробно про API-ключ, прокси и базовый URL · Настройка Claude Code через шлюз

Почему расширение не видит переменные окружения

Самая частая жалоба: в терминале claude работает, а панель в VS Code снова просит войти. Документация Anthropic описывает эту ситуацию прямо: VS Code мог не унаследовать окружение вашей оболочки.

На macOS приложения, запущенные из Dock, Launchpad или Spotlight, не читают ~/.zshrc — переменные, объявленные там, видны только процессам, запущенным из терминала. На Windows команда setx записывает значения для новых процессов: уже открытый редактор и его встроенный терминал их не увидят, пока вы полностью не закроете и не откроете VS Code заново. На Linux всё зависит от того, как оболочка рабочего стола запускает приложения.

Решений три. Перенести переменные в блок env файла ~/.claude/settings.json — тогда способ запуска редактора вообще не важен. Запускать редактор из терминала командой code . (или cursor . для Cursor) — так он унаследует окружение. Либо, в крайнем случае, продублировать значения в claudeCode.environmentVariables.

• Панель просит логин при заданном ключе — редактор запущен не из оболочки.
• После setx ничего не изменилось — закройте все окна редактора и откройте заново.
• Значок Claude Code не виден — откройте любой файл, проверьте версию VS Code и что рабочая папка не в Restricted Mode.
• Конфликт с другими ИИ-расширениями — временно отключите их и перезагрузите окно.
• Ответов нет совсем — запустите claude в терминале: CLI показывает текст ошибки подробнее, чем панель.

Подробнее: Разбор ошибок Claude Code и их причин

Claude Code в Cursor

Cursor — форк VS Code, поэтому официальное расширение Claude Code ставится в него так же: через панель расширений по запросу «Claude Code». В документации Anthropic есть отдельная ссылка на установку для Cursor, а для остальных форков расширение опубликовано в реестре Open VSX. Если редактор по какой-то причине не может поставить расширение, остаётся универсальный путь — установить CLI и запускать claude во встроенном терминале.

Настройка ключа в Cursor ничем не отличается: блок env в ~/.claude/settings.json подхватывается и здесь. Если держите переменные в профиле оболочки, запускайте редактор командой cursor . из терминала.

Важно не путать две вещи. У Cursor есть собственный чат и агент, в которых можно выбрать модели разных компаний, в том числе Claude. Это продукт Cursor: запросы идут через его серверы и тарифицируются по плану Cursor, а обвязка — промпты, инструменты, правила — своя. Claude Code в Cursor — это агент Anthropic, который просто живёт в панели или терминале этого редактора: у него свои команды, скиллы, хуки, MCP-серверы и свой способ оплаты. Ключ, указанный для Claude Code, на встроенный чат Cursor не влияет, и наоборот.

Подробнее: Claude Code, Codex или Cursor — сравнение

Плагин для JetBrains: IntelliJ IDEA, PyCharm, WebStorm

Для JetBrains Anthropic выпускает плагин Claude Code [Beta] в JetBrains Marketplace. Он работает в большинстве IDE этой компании: IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand. В отличие от расширения для VS Code, плагин не содержит своего CLI — он запускает команду claude во встроенном терминале IDE и подключается к ней. Поэтому сначала ставится CLI, затем плагин, затем IDE перезапускается.

Что даёт интеграция: запуск Claude Code сочетанием Ctrl+Esc (Cmd+Esc на Mac), просмотр изменений во встроенном диффе IDE вместо терминала, автоматическая передача выделенного фрагмента и открытой вкладки, вставка ссылки на файл сочетанием Alt+Ctrl+K (Cmd+Option+K на Mac), а также доступ модели к диагностике IDE — ошибкам линтера и синтаксиса.

Ключ для шлюза в PyCharm и других IDE задаётся так же — через блок env в ~/.claude/settings.json. Раз плагин запускает обычный claude, он читает тот же файл настроек. Если IDE не находит команду claude, откройте Settings → Tools → Claude Code [Beta] и укажите полный путь в поле Claude command.

• Remote Development: плагин ставится на удалённый хост (Settings → Plugin (Host)), а не на локальную машину.
• WSL: в поле Claude command укажите вида wsl -d Ubuntu -- bash -lic "claude", подставив имя своего дистрибутива.
• Esc не прерывает Claude: в Settings → Tools → Terminal снимите «Move focus to the editor with Escape».
• «No available IDEs detected» в WSL2 — обычно NAT или брандмауэр Windows; помогает правило брандмауэра или режим сети mirrored.

Команда /ide: подключение из внешнего терминала

Если запустить claude во встроенном терминале VS Code, Cursor или JetBrains, интеграция включается сама. Если же вы работаете во внешнем терминале — Windows Terminal, iTerm, Alacritty, — наберите внутри сессии /ide. Claude Code найдёт запущенную IDE и подключится к ней: диффы будут открываться в редакторе, а выделение кода попадёт в контекст. Для JetBrains при успехе появится сообщение вроде «Connected to IntelliJ IDEA», а если плагина нет, /ide предложит его установить.

Запускайте claude из корня того же проекта, что открыт в IDE, иначе у агента и редактора будут разные рабочие папки. Для VS Code-расширения внешний терминал с /ide — ещё и способ пользоваться функциями, которых в панели нет, например быстрым bash через восклицательный знак.

cd ~/projects/my-app
claude
# внутри сессии:
/ide
/config   # пункт Diff tool: auto — диффы в IDE, terminal — в терминале

Плагины Claude Code и работа через прокси

Под запросом «плагины для Claude Code» часто ищут две разные вещи. Первое — плагины для IDE, о которых шла речь выше. Второе — плагины самого Claude Code: пакеты со скиллами, командами, агентами, хуками и MCP-серверами, которые ставятся из маркетплейсов. В расширении VS Code для них есть графический интерфейс: введите /plugins в поле ввода, выберите плагин и область установки — для себя, для проекта или только локально. Плагины и маркетплейсы общие для расширения и CLI.

Теперь про «Claude Code в VS Code через прокси». Здесь не нужен HTTP-прокси в настройках редактора: достаточно указать ANTHROPIC_BASE_URL на совместимый с API Anthropic шлюз. Например, у нашего сервиса это https://claude-gateway.ru/api, а токен из личного кабинета идёт в ANTHROPIC_AUTH_TOKEN. Идентификаторы моделей те же, что у Anthropic, так что /model и настройки model работают без изменений. Оплата в рублях, есть пробный доступ на один день, тарифы от 150 ₽. Мы — независимый сервис и не связаны с Anthropic.

Учтите ограничения: при работе через стороннего провайдера расширение не показывает функции, завязанные на аккаунт claude.ai, — полосы лимитов подписки, голосовой ввод и вкладку облачных сессий. Вместо лимитов плана в разделе использования видны стоимость и токены текущей сессии.

Подробнее: Скиллы, субагенты и MCP в Claude Code · Какую модель выбрать в Claude Code