Claude Code в VS Code и первая настройка IDE

Дальше я развожу эти три поверхности - CLI, расширение и авторизацию, - собираю из них журнал конфигурации, который стоит вести с первого прогона, и объясняю, почему рабочий проект плохо годится на роль первого полигона. Всё, что помечено здесь как факт, взято из официальной документации Anthropic (code.claude.com/docs, обращение 18 июля 2026 года). Всё, что помечено как метод, - это уже редакционная рамка, а не цитата вендора.

Ходовое допущение звучит так: «первая настройка IDE безопасна в рабочем проекте». Именно его и стоит оспорить. Инструмент получает влияние на код раньше, чем ты понимаешь его права, и цена неверной первой настройки - остановка команды до начала разработки. Если ты параллельно решаешь, как вообще получить доступ к моделям из России, командный API-контур вроде provod.ai стоит держать отдельным вопросом: это про оплату и доступ к моделям, настройку Claude Code он за тебя не делает.

Расширение для VS Code требует VS Code версии 1.98.0 или выше и учётную запись Anthropic - любую платную подписку Claude (Pro, Max, Team или Enterprise) либо аккаунт Claude Console. Для этого пути API-ключ не нужен; сторонние провайдеры (Bedrock, Vertex, Foundry) настраиваются отдельно. Это по документации Anthropic (страница про VS Code, S1). Официальный «claude code plugin» - это и есть расширение из маркетплейса. Отдельной сторонней сборки не существует: то, что называют «claude code setup plugin» или «claude code setup plugin official», указывает на ту же самую страницу.

Тонкий момент, который ломает интуицию: расширение несёт собственную приватную копию CLI, но только для панели чата. Установка расширения не добавляет команду claude в PATH оболочки. Чтобы claude заработал в интегрированном терминале VS Code, нужен отдельный автономный CLI. Документация фиксирует это прямо (S1, S2). Именно здесь «одна настройка» распадается надвое. Панель чата - это «claude code для vs code»; терминальный агент - это «vs code claude code». Ставятся они по-разному и отказывают порознь.

Отсюда практический вывод для тех, кто разбирается, «как использовать claude code в vs code»: сначала пойми, что тебе нужно - панель чата, терминальный агент или оба. Если только панель, хватит расширения и учётки Anthropic. Если ты хочешь запускать claude как агента в терминале, готовься ко второй, независимой установке. Оговорка про охват: «claude code for vs code», он же «claude code vs code», здесь означает строго редактор VS Code. Плагин для JetBrains (IntelliJ IDEA, WebStorm) живёт отдельно, к нему вернёмся ниже.

Автономный CLI ставится несколькими способами, и документация перечисляет их явно (S2): нативный установщик (скрипт curl или PowerShell, обновляется в фоне), Homebrew (brew install --cask claude-code, без автообновления), WinGet и npm. Для npm-пути с версии v2.1.198 требуется Node.js 22 или новее. Документация отдельно предупреждает: не используй sudo npm install -g, потому что это ведёт к проблемам с правами и рискам безопасности.

Внутри команды одну и ту же строчку называют по-разному - «claude code install npm», «claude code npm install», «npm install claude code», «команда для установки claude code в терминале». Канонический вариант при этом один:

Системные требования CLI по документации (S2): macOS 13.0+, Windows 10 1809+/Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine 3.19+; 4 ГБ RAM и больше, x64 или ARM64, обязательное интернет-соединение, запуск из поддерживаемой Anthropic страны. После установки claude --version должен вывести строку версии, например 2.1.211 (Claude Code), а claude doctor проведёт read-only диагностику здоровья установки и валидацию файла настроек, не начиная сессию. Записывай точный вывод claude --version из своего прогона - документация ссылается на версионные гейты (v2.1.198, v2.1.200, v2.1.203, v2.1.208, v2.1.211), и часть поведения меняется между минорными версиями.

Здесь же ответ на «как подключить claude code» и на более узкое «как подключить claude code в vs code»: расширение и CLI подключаются к учётной записи по отдельности. А «как запустить claude code в vs code» решается только после того, как автономный CLI оказался в PATH, - иначе терминал ответит command not found независимо от того, работает ли панель чата.

Аутентификация требует аккаунта Pro, Max, Team, Enterprise или Console - бесплатный план Claude.ai доступ к Claude Code не включает (S2, S4). По умолчанию вход браузерный: команда claude открывает окно браузера, а если оно не открылось (WSL2, SSH, контейнер), нажми c, чтобы скопировать ссылку входа. Если в окружении задан ANTHROPIC_API_KEY, Claude Code один раз спросит, использовать ли этот ключ вместо браузера. Учётные данные хранятся по-разному: macOS - зашифрованный Keychain; Linux - ~/.claude/.credentials.json с правами 0600; Windows - %USERPROFILE%\.claude\.credentials.json с наследуемыми правами профиля (S4).

Здесь же зарыт «незафиксированный» риск прав. В команде через Console пользователю назначается роль: «Claude Code» (может создавать только ключи Claude Code) или «Developer» (может создавать ключи любого типа) - это документированное разделение прав (S4). А поведение самого агента определяют режимы доступа. Их шесть, и это моя рабочая калька русских названий, а не официальный термин (документация на английском). Разделение - в таблице.

Даже во всех режимах, кроме bypassPermissions, запись в «защищённые пути» (.git, .vscode, .idea, .claude, .gitconfig, .bashrc, .npmrc, .mcp.json, .claude.json и другие) никогда не одобряется автоматически - агент всегда спрашивает (S3). Это встроенный предохранитель от порчи конфигурации и репозитория на первой настройке. Режим bypassPermissions включается только явно (--permission-mode bypassPermissions, --dangerously-skip-permissions или флаг настроек), показывает разовое окно с принятием ответственности, а на Linux/macOS отказывается стартовать под root/sudo «по соображениям безопасности», если только это не распознанный sandbox (S3). Вот тебе и «авторизация требует незафиксированных прав»: одно и то же слово «настройка» покрывает роль в Console, режим доступа и запуск под root - три разных вентиля.

И четвёртая деталь для журнала. Расширение поднимает локальный MCP-сервер «ide», к которому CLI подключается сам: он слушает 127.0.0.1 на случайном порту (10000–65535, не настраивается) по незашифрованному ws://, пишет свежий случайный токен в lock-файл ~/.claude/ide/.lock с правами 0600 и требует от CLI предъявить этот токен в заголовке X-Claude-Code-Ide-Authorization (S1). Это версионируемый, воспроизводимый факт - ровно то, что стоит фиксировать.

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

Что проверяемо - так это граница бесплатного. «claude code free api» и «claude code api key free» упираются в один и тот же факт: бесплатный план Claude.ai доступ к Claude Code не включает (F5; S2, S4). Бесплатного ключа в этом смысле просто нет - нужен платный план или аккаунт Console. Отсюда же ответ на «claude code api купить», «claude code api key купить» и «купить токены claude code»: покупается подписка или доступ через Console, отдельной лавки с токенами у Anthropic не существует. На «claude code стоимость токенов» и «стоимость токенов claude code» честный ответ один - ссылка на действующий тариф; выдуманное число здесь хуже, чем его отсутствие. Обычно на этом месте и начинают смотреть в сторону «claude code аналог», чаще всего - «китайский аналог claude code», рассчитывая на DeepSeek или Qwen подешевле.

Отдельная боль - оплата. «как оплатить claude code из россии» и «как оплатить claude code в россии» - это вопрос про платёжный контур, и разводить его с настройкой стоит честно. Подписку Anthropic ты оплачиваешь по правилам Anthropic; provod.ai (совместимый API-контур для агентов, IDE и SDK) закрывает соседнюю задачу - рублёвый доступ к тем же моделям, включая Claude, через один API. Баланс один; платишь российской картой, через СБП или по счёту, без VPN и зарубежных карт; цены моделей идут без наценки provod.ai, для юрлица есть документы. Клиент, который умеет OpenAI-совместимый API, подключается сменой base_url и ключа - переписывать код не нужно. Настройку самого Claude Code это не отменяет.

Здесь документация заканчивается и начинается моя рамка. Тезис такой: изолированный инсталляционный прогон в тестовом проекте даёт подтверждённую карту первой настройки Claude Code в IDE - раньше, чем ты трогаешь рабочий репозиторий. Проверяемость тут простая. Прогон считается успешным, если ты записал точную версию, режим доступа и наблюдаемые ошибки; и проваленным, если версия не подтверждена или авторизация потребовала прав, которых ты заранее не зафиксировал. Это два условия отказа, и оба видны только в изоляции.

Соблазн понятен: в рабочем проекте быстрее. Но расширение, CLI и авторизация отказывают по отдельности, а в боевом репозитории цена такой ошибки - остановка команды. Компромисс честный: изоляция стоит лишнего времени, зато снижает риск для основной кодовой базы. Есть и коварная деталь очистки: удаление расширения не убирает состояние Claude Code полностью - CLI, плагин JetBrains и десктоп-приложение пишут в ~/.claude/, а запуск claude в интегрированном терминале автоматически переустанавливает расширение, если не выставить autoInstallIdeExtension в false (S1, S2). Значит, тестовый проект должен быть пустой директорией без рабочего кода и секретов, а не копией боевого репозитория.

Изолированный прогон и журнал - это карта первой настройки, но не универсальный доступ. Несколько вещей эта статья честно не закрывает.

Неофициальные обходы. «claude code router», «claude code proxy», «настройка прокси для claude code» - это сторонние решения и покупные ключи, которых в проверенном источнике нет. Я их не подтверждаю: документация описывает браузерный вход, ANTHROPIC_API_KEY и корпоративные провайдеры (Bedrock, Google Cloud Agent Platform, Microsoft Foundry) как отдельно настраиваемые пути (S4), а всё остальное - вне зоны фактов.

Путаница инструментов. «claude code codex plugin» и «codex plugin for claude code» - частый пример смешения продуктов: Codex это отдельный инструмент, и в проверенном источнике про Claude Code такого плагина нет. Формулировка выглядит валидной, поэтому час на поиск несуществующей настройки - типичная цена этой путаницы.

Другие среды. Гайд про VS Code. Если смотреть шире и выбирать «ide для claude code», учти: плагин для JetBrains - отдельный продукт, и «claude code intellij idea», «intellij idea claude code», «claude code webstorm» - это про него. Он тоже пишет в ~/.claude/ (F12), но его конфигурация в этот источник не входит. «как подключить claude code к figma» я оставляю без ответа: проверенных фактов под этот сценарий нет, а выдумывать шаги не буду.

И граница по продукту: provod.ai решает оплату и доступ к моделям из России, но не настраивает Claude Code за тебя. Установка CLI, расширения и авторизация остаются твоей работой по документации Anthropic.

Расширение установил, а claude в терминале не находится - это баг? Нет. Расширение несёт приватную копию CLI только для панели чата и не добавляет claude в PATH; терминальный CLI ставится отдельно (S1, S2).

Хватит ли бесплатного плана? Нет: бесплатный план Claude.ai не включает доступ к Claude Code, нужен Pro, Max, Team, Enterprise или Console (F5; S2, S4).

Почему bypassPermissions не стартует? Так и задумано: вне распознанного sandbox под root/sudo он не запускается - разбор выше, в разделе про права (S3).

Что записать в журнал минимум? Вывод claude --version, версию VS Code, режим доступа, права файла учётных данных и порт локального MCP-сервера ide (S1–S4).

Собери пустой тестовый проект, зафиксируй версию, права и режим доступа, и только после подтверждённого прогона переноси конфигурацию в рабочий репозиторий. А оплату и доступ к моделям из России реши отдельно - оформи рублёвый баланс и API без наценки на provod.ai, с общим балансом организации и контролем расходов на команду.

Не разделяйте RAG-пайплайн между несовместимыми кабинетами: эмбеддинги, поиск и генерация ответа подключаются через общий контур, а модель можно менять без новой платёжной интеграции.

В одном каталоге — актуальные модели для текста и медиа: GPT от OpenAI, Claude от Anthropic, Gemini от Google, Grok от xAI, DeepSeek, Qwen, GLM, Kimi и MiniMax; для изображений — Nano Banana 2 Pro и GPT Image; для видео — последние версии Seedance, Kling, Veo и Google Omni. Также доступны модели для reasoning, поиска, документов, эмбеддингов, музыки и аудио.

Единая точка доступа не скрывает экономику компонентов: стоимость каждого вызова соответствует официальному тарифу 1:1, без маржи provod.ai.

Соберите RAG на едином балансе: форма регистрации · цены на модели · защита данных по 152-ФЗ · API и интеграции