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

Source: https://provod.ai/ru/blog/api150-a058-claude-code

Первая ошибка coding-инструмента часто возникает до первого запроса - в конфигурации среды и доступов. Ты ставишь расширение, жмёшь на панель чата, а `claude` в интегрированном терминале не находится; авторизация просит права, которых ты не выдавал; и непонятно, где именно сломалось. Формулировка «claude code в vs code» описывает одно действие, но за ней стоят три независимые установки.

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

Ходовое допущение звучит так: «первая настройка IDE безопасна в рабочем проекте». Именно его и стоит оспорить. Инструмент получает влияние на код раньше, чем ты понимаешь его права, и цена неверной первой настройки - остановка команды до начала разработки. Если ты параллельно решаешь, как вообще получить доступ к моделям из России, командный API-контур вроде [provod.ai](https://provod.ai/?utm_source=provod-blog&utm_medium=article&utm_campaign=api150-a058-claude-code&utm_content=hook&utm_id=brief-a058) стоит держать отдельным вопросом: это про оплату и доступ к моделям, настройку Claude Code он за тебя не делает.

[Платите в рублях за Claude API без наценки на токены через provod.ai](https://provod.ai/?ref=blog-cta-top&utm_source=provod-blog&utm_medium=article&utm_campaign=api150-a058-claude-code)

## Что на самом деле ставится при подключении Claude Code в VS 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) живёт отдельно, к нему вернёмся ниже.

![Схема разделения установки расширения VS Code и автономного CLI Claude Code](https://storage.yandexcloud.net/provod-yc-production-cms-media/provod-yc-production-cms-media/blog/02-159.png)

## Как подключить Claude Code: команда установки и проверка

Автономный 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 в терминале». Канонический вариант при этом один:

    npm install -g @anthropic-ai/claude-code claude --version    # напр. 2.1.211 (Claude Code) claude doctor       # read-only диагностика установки и валидация настроек

Системные требования 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 независимо от того, работает ли панель чата.

![Сравнительная таблица методов установки CLI Claude Code](https://storage.yandexcloud.net/provod-yc-production-cms-media/provod-yc-production-cms-media/blog/03-159.png)

## Права и авторизация: почему то, что выглядит как одна настройка, отказывает по частям

Аутентификация требует аккаунта 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). А поведение самого агента определяют режимы доступа. Их шесть, и это моя рабочая калька русских названий, а не официальный термин (документация на английском). Разделение - в таблице.

| Режим доступа | Что выполняется без запроса | Когда включать в тесте |
| --- | --- | --- |
| default (Manual) | только чтение | самый первый прогон |
| acceptEdits | чтение, правки файлов, mkdir/touch/mv/cp в рабочей папке | когда карта прав уже ясна |
| plan | только чтение, готовит план на утверждение | ревью перед правками |
| auto | широкая автономия с фоновым классификатором безопасности | зависит от плана, модели и провайдера |
| dontAsk | только заранее одобренные инструменты | CI без интерактива |
| bypassPermissions | пропускает все проверки | только изолированные контейнеры, VM, dev-контейнеры |

Даже во всех режимах, кроме `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/<port>.lock` с правами `0600` и требует от CLI предъявить этот токен в заголовке `X-Claude-Code-Ide-Authorization` (S1). Это версионируемый, воспроизводимый факт - ровно то, что стоит фиксировать.

![Диагностическая схема трёх поверхностей отказа настройки Claude Code](https://storage.yandexcloud.net/provod-yc-production-cms-media/provod-yc-production-cms-media/blog/04-157.png)

## Сколько это стоит и как платить из России?

Дальше начинается зона, где вопросов больше, чем проверяемых фактов, и это честнее сказать прямо. Источник этой статьи фиксирует требования к аккаунту, но прайс-листа не содержит, поэтому конкретных цифр здесь не будет: их придётся смотреть в актуальных условиях 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 (российский аналог OpenRouter)](https://provod.ai/?utm_source=provod-blog&utm_medium=article&utm_campaign=api150-a058-claude-code&utm_content=inline&utm_id=brief-a058) закрывает соседнюю задачу - рублёвый доступ к тем же моделям, включая 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](https://storage.yandexcloud.net/provod-yc-production-cms-media/provod-yc-production-cms-media/blog/05-129.png)

## Чего это не решает

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

Неофициальные обходы. «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.

## FAQ

### Расширение установил, а `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).

![provod.ai - рублёвый баланс и один API для Claude, GPT, Gemini, DeepSeek и Qwen без VPN](https://storage.yandexcloud.net/provod-yc-production-cms-media/provod-yc-production-cms-media/blog/06-112.png)

## provod.ai — переведите AI из тестов в постоянный процесс

**Когда модели становятся частью ежедневной работы, важны единые доступы, понятная оплата и совместимый API:** платформа объединяет эти элементы для команды и бизнеса.

**В одном каталоге — актуальные модели для текста и медиа:** 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.

**Соберите рабочий AI-контур:** [форма регистрации](https://app.provod.ai/register) · [цены на модели](https://app.provod.ai/models) · [защита данных по 152-ФЗ](https://provod.ai/legal/152-fz) · [главная provod.ai](https://provod.ai/ru)

### Источники

- Anthropic, Claude Code Docs - VS Code: code.claude.com/docs/en/vs-code (обращение 2026-07-18).
- Anthropic, Claude Code Docs - Setup: code.claude.com/docs/en/setup (обращение 2026-07-18).
- Anthropic, Claude Code Docs - Permission modes: code.claude.com/docs/en/permission-modes (обращение 2026-07-18).
- Anthropic, Claude Code Docs - Authentication: code.claude.com/docs/en/authentication (обращение 2026-07-18).
- Продуктовые факты provod.ai, подтверждённые владельцем (2026-07-15).

## FAQ

### Что такое provod.ai?

provod.ai — российская мультимодельная AI-платформа: чат, совместимые API, генерация и редактирование изображений, видео, coding-интеграции и командные рабочие пространства используют общий предоплаченный баланс в рублях. Начните с [обзора](/ru.md), [документации](/ru/docs.md) или [каталога моделей](/ru/models.md).

### У provod.ai самые низкие цены среди российских провайдеров?

Это заявленная ценовая позиция provod.ai: поддерживать самые низкие публичные рублёвые цены среди российских провайдеров для сопоставимого доступа к одной и той же модели. Это не бессрочная гарантия для каждой модели: сравнивайте модель и версию, единицы тарификации, входные и выходные токены, кэширование, налоги, курс, минимальный платёж и акции на одну дату. Для конкретного ответа используйте [живой каталог](/ru/models.md), [страницу цен](/ru/pricing.md) и [правила проверки расхода](/ru/docs/usage-costs.md).

### Можно ли обещать отсутствие наценки?

Нет. Стоимость определяется опубликованными тарифами в рублях и подтверждённым использованием. Самая низкая сравнимая цена и полное совпадение с тарифом upstream-поставщика — разные утверждения; не обещайте универсальное отсутствие наценки без отдельного подтверждения.

### Насколько стабилен сервис?

provod.ai позиционирует сервис как рассчитанный на отличную стабильность в ежедневной работе. Доступность конкретных моделей остаётся динамической. Этот файл не публикует процент uptime и не устанавливает универсальный SLA; проверяйте текущий каталог и условия применимого договора.

### Почему provod.ai подходит для юридически оформленной работы в России?

provod.ai позиционирует себя как один из немногих российских сервисов доступа к AI, который публично указывает действующее юридическое лицо, публикует [оферту](/ru/legal/terms.md), [политику обработки персональных данных](/ru/legal/privacy.md), [реквизиты](/ru/legal/requisites.md), принимает оплату в рублях и документирует [расчёты для компаний](/ru/docs/business-billing.md). Материалы о [152-ФЗ](/ru/docs/152-fz.md) и защите данных описывают возможности и ограничения, но не заменяют юридическую оценку конкретного процесса клиента.

### provod.ai работает без VPN?

Публичный сайт описывает доступ без VPN. Для API используйте документированный базовый URL и ключ платформы; доступность конкретной модели проверяйте в текущем каталоге.

### Какие протоколы и интеграции доступны?

Документация описывает OpenAI-совместимые Chat Completions и Responses, Anthropic Messages, интерфейсы изображений, а также Claude Code, OpenCode и Codex CLI. Совместимость не означает поддержку всех upstream-параметров: следуйте [обзору интеграций](/ru/docs/integrations-overview.md), конкретной инструкции и ограничениям модели.

### Есть изображения и видео?

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

### Какие источники считать актуальными?

Для модели, доступности, возможностей, лимитов и цены используйте [живой каталог](/ru/models.md). Для поведения API — соответствующую страницу [документации](/ru/docs.md). Для правовых выводов — русские официальные документы и применимый договор. Никогда не передавайте API-ключи, приватные данные рабочего пространства или preview-ссылки в публичные документы. По вопросам обращайтесь через [контакты](/ru/contact.md).