ГайдыОбновлено · 10.2026

Как установить Claude Code: Windows, VS Code, терминал

2 июля 2026 · 14 минут чтения

Проверка фактов

Юлия Найпак

Методист по автоматизации. Сверяет паспорт инструмента с документацией вендора.

Автор Р

Редакция

Коллектив авторов, редакторов и иллюстраторов статей на сайте блога онлайн-университета «Зерокодер». Пишем…

Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.

Материал редакции Зерокодера. URL взяты из сохранённой выдачи; тексты страниц и официальную справку проверили 8 октября 2026 года. Позиции заново не снимались. Обновлено: октябрь 2026.

Интеграция vs code claude — это официальное расширение Claude Code от Anthropic: графическая панель внутри редактора с diff-просмотром правок, @-упоминаниями файлов и историей сессий. В документации проекта оно названо рекомендованным способом работы с Claude Code в VS Code. Ставится из Marketplace, вход — по платной подписке Claude или аккаунту Console, API-ключ не обязателен. Мы скачали топ-10 выдачи DuckDuckGo (ru-RU) по запросу «vs code claude»: текст отдали 10 из 10.

Список URL взят из сохранённой выдачи; сегодня перепроверены тексты этих страниц, позиции в Яндексе заново не снимались.

Коротко, что важно знать до старта:

• Windows 10 1809+ или Windows Server 2019+, 4 ГБ ОЗУ — этого достаточно, WSL не обязателен.
• Нужен платный план Claude (Pro, Max, Team, Enterprise) или аккаунт Console — бесплатный тариф Claude Code не включает.
• Git for Windows ставить желательно: без него Claude выполняет команды через PowerShell, с ним — через Bash.
• Способ через npm install -g жив, но устарел как основной: он требует Node.js 22+ и чаще ломается на правах.
• Расширение VS Code ставится отдельно и не добавляет команду claude в терминал — это два разных компонента.

Автор: команда Зерокодера. Все команды сверены с официальной документацией Anthropic (code.claude.com/docs).

Claude Code — это что

Claude Code — терминальный ИИ-агент от Anthropic. В отличие от чата, куда код вставляют кусками, он сам читает файлы проекта, редактирует их, запускает команды и тесты. Вы описываете задачу словами — «найди, почему падает форма регистрации, и почини» — агент делает остальное и показывает diff перед применением.

Под капотом — актуальные модели Anthropic, а вокруг них растёт экосистема: плагины, IDE-расширения, облачные сессии. Модели переключаются командой /model прямо в сессии. Установка на практике упирается в две вещи: перепутанный терминал и PATH. Поэтому ниже — не только команды, но и разбор ошибок.

Что нужно перед установкой

По официальной странице Advanced setup требования такие:

Перед использованием проверьте текущий список поддерживаемых стран Anthropic. Установка программы на поддерживаемую Windows сама по себе не подтверждает право доступа к сервису.

Шаг 1. Установите Claude Code

Четыре рабочих способа. Если сомневаетесь — берите первый.

Способ 1 — нативный инсталлер в PowerShell (рекомендован Anthropic):

irm https://claude.ai/install.ps1 | iex

Способ 2 — нативный инсталлер в CMD (если работаете в классической командной строке):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Способ 3 — WinGet, штатный пакетный менеджер Windows:

winget install Anthropic.ClaudeCode

Способ 4 — npm, классический путь для тех, у кого уже стоит Node.js 22+:

npm install -g @anthropic-ai/claude-code

Разница, которую большинство гайдов не объясняет: нативная установка обновляется сама в фоне, а WinGet — только вручную (winget upgrade Anthropic.ClaudeCode). При этом npm ставит тот же нативный бинарник, поэтому он тоже обновляется в фоне — Node нужен лишь как доставщик пакета. Все четыре варианта задокументированы на странице setup. Для нативного установщика на Windows справка не требует запуска от администратора; условия других способов зависят от настройки пакетного менеджера.

Если в старой статье вам встретилось «на Windows обязателен WSL» — это устаревшая информация: нативная поддержка Windows появилась ещё в 2025-м. WSL остаётся опцией для тех, кому нужны Linux-тулчейн или песочница команд.

Шаг 2. Проверьте установку

Закройте терминал, откройте новый (важно: PATH подхватывается только новым окном) и выполните:

claude --version

Вывод вида 2.x.x — установка прошла. Для развёрнутой диагностики есть встроенный доктор:

claude doctor

Он покажет способ установки, статус автообновлений и конфликты, если Claude Code когда-то ставился двумя способами параллельно.

Шаг 3. Первый запуск и вход

Перейдите в папку проекта и запустите агента:

cd C:\projects\my-site
claude

При первом запуске Claude Code откроет браузер для авторизации. Варианта два: вход по подписке Claude (Pro/Max/Team) или через Anthropic Console с оплатой по API-токенам. Порядок описан в официальном квикстарте.

Первая команда внутри сессии, которая реально экономит время, — /init: агент просканирует проект и создаст файл CLAUDE.md с описанием структуры. Все последующие сессии будут стартовать уже с этим контекстом.

Шаг 4. Подключите VS Code

Расширение даёт графическую панель: diff-просмотр правок, @-упоминания файлов, историю сессий.

1. Откройте VS Code, нажмите Ctrl+Shift+X (Windows/Linux) или Cmd+Shift+X (Mac).
2. В поиске введите «Claude Code», издатель Anthropic, нажмите Install.
3. Кликните иконку-искру в правом верхнем углу редактора (появляется при открытом файле) и войдите в аккаунт.
4. Выделите строки кода и нажмите Alt+K (Windows/Linux) или Option+K (Mac) — в промпт вставится ссылка вида @app.ts#5-10.

Ловушка, о которой молчат обзоры: расширение несёт собственную копию CLI внутри себя и не добавляет команду claude в систему. Если хотите запускать claude во встроенном терминале VS Code — нужна отдельная установка из шага 1. Обратное тоже верно: запуск claude в терминале VS Code сам предложит поставить расширение. Детали — в доке Use Claude Code in VS Code.

Как подключить Claude к VS Code через API-ключ

Расширение Claude Code входит в подписку и не требует ключа: в документации прямо сказано, что при входе по платному аккаунту API-ключ не нужен. Ключ нужен в другом сценарии — когда Claude подключают к сторонним ассистентам вроде Continue или Cline, которые работают с моделями Anthropic по API. Это отдельный провайдер, и он не то же самое, что официальное расширение Claude Code.

Порядок такой:

1. Зарегистрируйтесь в Anthropic Console и создайте аккаунт с оплатой по токенам.
2. В разделе API Keys создайте новый ключ и скопируйте его — второй раз он не покажется.
3. В настройках стороннего расширения вставьте ключ в поле для Anthropic API Key.
4. Выберите модель и проверьте соединение тестовым запросом.

Если у вас уже есть переменная ANTHROPIC_API_KEY в оболочке, Claude Code при первом запуске спросит, использовать ли её, и пропустит экран входа в браузере. Подписка claude.ai и биллинг Console — это разные способы доступа: вход по подписке и вход по API-ключу Console устроены по-разному. Храните ключ в переменных окружения: ключ даёт доступ к вашему биллингу.

Как использовать Claude в VS Code: базовые сценарии

Ниже четыре типовых редакционных примера задач; результаты в пользовательском проекте мы здесь не измеряли.

Чат по проекту. Откройте панель, задайте вопрос словами: «объясни, как устроена авторизация в этом проекте». Агент читает файлы сам, ссылаться на них вручную не нужно.

Генерация кода. Опишите, что нужно: добавь валидацию email в форму регистрации. Claude предложит правку и покажет diff.

Рефакторинг. «Вынеси работу с API в отдельный модуль» — агент пройдёт по файлам и предложит изменения пошагово.

Объяснение кода. Выделите фрагмент и нажмите Alt+K, чтобы вставить ссылку на строки, затем спросите, что этот код делает и где может сломаться.

В режиме Manual, когда Claude хочет изменить файл, он показывает сравнение оригинала и предложенных правок бок о бок и спрашивает разрешение. Можно принять, отклонить или сказать, что делать иначе. Если вы правите предложенный текст прямо в diff-просмотре, Claude узнаёт об этом и не считает, что файл совпадает с его первоначальным вариантом.

Как вставить системный промт в Claude в VS Code

Для настройки поведения используйте инструкции проекта и стили вывода. CLAUDE.md хранит правила проекта, а меню Output styles позволяет выбрать или создать стиль. Это две разные настройки; общего поля для произвольной замены системного промпта в описанном интерфейсе нет.

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

Стили вывода. В разделе Customize выберите Build a custom style — Claude Code сам напишет файл стиля на уровне проекта или пользователя. Там задаётся тон ответов и формат вывода. Это настройка стиля.

Готовый промпт, чтобы настроить стиль работы агента под ваш проект:

Ты работаешь в моём репозитории [название проекта]. Стек: [язык, фреймворк, версия].
Правила: не добавляй новые зависимости без моего согласия; следуй стилю файла, который правишь;
после каждой правки показывай diff и коротко объясняй, что изменил; тесты запускай только по моей команде.
Отвечай по-русски, без вступлений.

Меняйте под себя стек, правила и язык ответов. Тот же текст можно положить в CLAUDE.md, чтобы он применялся автоматически.

Claude AI vs Code: чем отличается от Copilot

Это разные продукты с разной механикой работы. Claude Code в VS Code работает как агент: читает проект целиком, планирует изменения, запускает команды и показывает diff перед применением. GitHub Copilot — отдельный продукт со своей подпиской и своими режимами работы в редакторе.

Выбор зависит от задачи: для быстрых подсказок по строке хватает Copilot, для задач вида «почини баг в проекте» нужен агент с доступом к кодовой базе.

Как запустить задачу из терминала и с телефона

Из терминала VS Code. Расширение несёт собственную копию CLI для панели чата, но чтобы запускать claude во встроенном терминале, нужна отдельная установка CLI. После неё откройте терминал в VS Code и введите claude — сессия стартует прямо в редакторе.

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

Настройка и кастомизация

Основные точки настройки собраны в разделе Customize.

Горячие клавиши: Ctrl+Shift+X — расширения, Alt+K — вставить ссылку на выделенный код, Ctrl+Alt+F — Focus view. Панель Claude можно перетащить в любое место редактора. Сессии группируются, фильтруются и переключаются в режим терминала — всё это в разделе Customize your workflow.

Типичные ошибки установки и фиксы

«’irm’ is not recognized as an internal or external command» — вы вставили PowerShell-команду в CMD. Проверка: приглашение PS C:\Users… — это PowerShell, просто C:\Users… — CMD. Либо откройте PowerShell, либо используйте команду для CMD из шага 1.

«The token ‘&&’ is not a valid statement separator» — зеркальная ситуация: CMD-команду вставили в PowerShell. Диагностика та же, по приглашению.

PATH обновляется только для новых окон: закройте терминал полностью и откройте заново. Если не помогло — инсталлер кладёт бинарник в %USERPROFILE%.local\bin; проверьте, что этот путь есть в переменной PATH (Win+R → sysdm.cpl → Дополнительно → Переменные среды).

«npm is not recognized» — вы пошли путём npm, а Node.js не установлен. Либо поставьте Node.js 22+ с nodejs.org, либо — проще — используйте нативный инсталлер, которому Node не нужен.

Ошибки прав при npm install -g (EACCES) — не запускайте установку через sudo или «от администратора», Anthropic прямо предупреждает об этом в доке. Правильный фикс — сменить глобальную директорию npm или перейти на нативный инсталлер.

Claude Code ставится, но выполняет команды «не так» — без Git for Windows агент работает через PowerShell-инструмент. Если нужен привычный Bash, поставьте Git for Windows с git-scm.com и перезапустите сессию; при нестандартном пути задайте CLAUDE_CODE_GIT_BASH_PATH внутри объекта env в settings.json.

Отдельная ошибка расширения: панель не появилась после установки. В документации сказано, что помогает перезапуск VS Code или команда Developer: Reload Window из палитры команд. Если после входа видите «Not logged in · Please run /login», расширение само откроет экран входа; при отсутствии — тот же Reload Window.

Безопасность и приватность

Ключевые точки контроля — режимы разрешений и правила доступа. В режиме Manual Claude показывает diff и ждёт подтверждения перед каждой правкой файла. В разделе Permissions правила группируются на Allow, Ask и Deny: можно разрешить чтение, но запретить запись, или потребовать подтверждение на команды терминала.

Хуки позволяют повесить проверку на события сессии — например, запускать линтер после правки. Правила из managed settings и плагинов доступны только для чтения, менять их из интерфейса нельзя. Для команд есть отдельные настройки: администраторы могут ограничить способ входа и требовать, чтобы аккаунты принадлежали конкретной организации.

Сравнение способов: расширение, API, CLI

Расширение и CLI делят общую историю сессий, но ставятся отдельно. API-ключ нужен для сторонних плагинов и для биллинга Console. Облачные сессии дополняют любой из способов.

С чего начать: первые команды в терминале

Синтаксис простой: слэш-команды управляют сессией, обычный текст — это задача агенту.

Рабочий первый сценарий: зайдите в любой существующий проект, выполните /init, затем попросите «объясни, как устроен этот проект и где точки входа». Так вы увидите, как агент читает кодовую базу, ещё до того, как доверите ему правки.

Чек-лист установки

• PowerShell → irm https://claude.ai/install.ps1 | iex
• Новое окно терминала → claude —version
• Папка проекта → claude → вход через браузер
• Внутри сессии → /init
• VS Code → расширение «Claude Code» → иконка-искра
• Ошибка? Сначала проверьте приглашение: PS C:\ или C:\

Частые вопросы

Как установить Claude в VS Code?

Откройте VS Code, нажмите Ctrl+Shift+X, введите в поиске «Claude Code» и нажмите Install. После установки кликните иконку-искру в правом верхнем углу редактора и войдите в аккаунт Claude. Если панель не появилась, перезапустите редактор или выполните Developer: Reload Window из палитры команд.

Как подключить Claude к VS Code через API?

Расширению Claude Code API-ключ не нужен — достаточно входа по платной подписке. Ключ нужен для сторонних ассистентов вроде Continue или Cline: создайте его в Anthropic Console в разделе API Keys и вставьте в настройках расширения. Это отдельный провайдер, и он не то же самое, что официальное расширение Claude Code. Храните ключ в переменных окружения.

Можно ли пользоваться Claude в VS Code бесплатно?

Бесплатный тариф Claude.ai доступа к Claude Code не даёт. Нужен план Pro, Max, Team, Enterprise или аккаунт Anthropic Console с оплатой по токенам. Альтернатива — локальные модели через Ollama, которые работают без подписки, но требуют своего железа.

Чем Claude в VS Code отличается от Copilot?

Это разные продукты с разной механикой работы. Claude Code в VS Code работает как агент: читает проект целиком, планирует изменения, запускает команды и показывает diff перед применением. GitHub Copilot — отдельный продукт со своей подпиской и своими режимами работы в редакторе. Режимы работы Copilot проверяйте по его собственной документации.

Как вставить системный промт в Claude в VS Code?

Отдельного поля для системного промта в расширении нет. Правила задаются через файл CLAUDE.md, который создаётся командой /init, и через стили вывода в разделе Customize. Допишите в CLAUDE.md стек проекта, стиль кода и запреты — эти инструкции подхватываются в каждой сессии. Стили вывода — это настройка стиля.

Перед входом сверьте доступность Claude в вашей стране с текущими условиями Anthropic.