Настраиваем Claude Code в VS Code и используем его не только для автодополнения

Установить — ещё не значит встроить в работу

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

Четыре способа работать с Claude в VS Code

"Claude в VS Code" может означать несколько вещей:

• Claude Code в терминале — собственный CLI от Anthropic. Он видит всю кодовую базу, читает и пишет файлы, запускает команды и работает сразу со многими файлами. Самый мощный из четырёх вариантов.
• GitHub Copilot с моделью Claude: подписчик Copilot может переключить модель на Claude Sonnet и остаться в привычном интерфейсе.
• Claude.ai во вкладке браузера рядом с редактором: просто и недооценённо. Вставили код, получили предложения, вставили обратно. Медленнее, зато работает где угодно и ничего не стоит сверху.
• Сторонние расширения с чатом Claude в боковой панели: качество разное, некоторые не обновлялись месяцами.

Дальше речь пойдёт о Claude Code, потому что именно он меняет то, на что способен ИИ. Браузерный чат и Copilot удобны, но ограничены. Claude Code видит весь проект, понимает связи между файлами, запускает тесты и дорабатывает результат — это инструмент другого класса.

Настройка в три шага

Если вы уже это делали, уйдёт около 10 минут, в первый раз — минут 20.

Установка

Claude Code — инструмент командной строки, ставится через npm:

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

Нужен Node.js 18 или новее, так что сначала обновитесь, если у вас версия старше. После установки запустите его:

claude

Он попросит войти в аккаунт Anthropic. Для начала хватит бесплатного, но на реальном проекте вы быстро упрётесь в лимиты. После авторизации всё готово.

Запуск из терминала VS Code

Описанный здесь способ обходится без расширения VS Code. Claude Code работает во встроенном терминале, так что порядок такой:

1. Откройте проект в VS Code.
2. Откройте встроенный терминал сочетанием Ctrl+ (Cmd+ на Mac).
3. Перейдите через cd в корень проекта.
4. Введите claude.

С этого момента у него есть контекст проекта. Он может читать файлы, разбираться в структуре, запускать ваши тесты и менять несколько файлов за один проход. И с редактором он уживается отлично: пусть Claude правит код в панели терминала, а вы смотрите, как изменения появляются в редакторе в реальном времени. К разделённому экрану нужно немного привыкнуть, а потом это кажется очень естественным.

Пишем CLAUDE.md

Большинство туториалов пропускают этот шаг, а отдача от него самая большая. CLAUDE.md — файл в корне проекта, где вы рассказываете Claude о своих соглашениях, предпочтениях и правилах. Без него Claude строит разумные догадки по тому, что видит. С ним он ведёт себя так, будто работает в команде уже несколько месяцев. Минимальная версия:

# Project conventions

## Tech stack
- Node.js 20, TypeScript, Express
- PostgreSQL via Prisma
- Jest for testing

## Code style
- Use async/await, never callbacks
- Prefer explicit error handling over try/catch everywhere
- All new functions need JSDoc comments

## Testing
- Every new endpoint needs at least 3 tests: happy path,
  validation error, and auth failure
- Use factories, not fixtures

## What NOT to do
- Don't use any (TypeScript). Use unknown and narrow it.
- Don't add console.log for debugging. Use the logger.
- Don't install new dependencies without asking first.

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

Привычки, ради которых им стоит пользоваться

Настройка закончена, теперь сложная часть — пользоваться им так, чтобы это было лучше обычного окна чата.

Давайте ему задачи покрупнее

Поначалу многие используют Claude Code как продвинутое автодополнение: просят по одной функции, одному исправлению синтаксиса или одному новому параметру. Это работает, но сила инструмента не в этом. Лучше всего он справляется с крупными задачами. Например: добавь пагинацию во все list-эндпоинты этого API, вот как сейчас это сделано в эндпоинте users, примени тот же подход везде. Вручную это час работы, а Claude справится минут за пять.

Контекстное окно достаточно большое, чтобы вместить заметную часть реальной кодовой базы, так что пользуйтесь этим. Дайте ему несколько файлов, опишите картину целиком и пусть работает по всем сразу.

Просите его расследовать

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

В параллельном сравнении с Cursor и Copilot на реальном баге только Claude Code остановился и задал уточняющий вопрос перед началом работы — и этот вопрос оказался ровно в суть бага.

Сначала тест

Звучит задом наперёд, но для всего, где требования понятны, работает отлично. Напишите тест, описывающий нужное поведение, отдайте его и скажите: сделай так, чтобы он проходил, ничего больше не сломав. Отсюда три плюса. Реализация соответствует вашим настоящим требованиям, потому что вы задали их в коде. Неясности всплывают рано, ведь написание теста заставляет продумать граничные случаи. И в конце у вас есть тест, которого могло бы и не быть, если сначала просить фичу, а тесты потом. Особенно это оправдано для платежей, аутентификации и внешних API, где ошибки настолько дороги, что правильное поведение хочется зафиксировать до появления кода.

Поручайте ему рефакторинг

Рефакторинг легко описать и муторно делать аккуратно. Функция разрослась, модуль взял на себя слишком много, или один и тот же фрагмент скопировали пять раз вместо того, чтобы вынести в абстракцию. Скажите Claude, за что должен отвечать модуль, попросите вынести остальное в новый и обновить все места импорта. Он проведёт это по всей кодовой базе, исправит каждую ссылку и прогонит тесты, чтобы убедиться, что ничего не сломалось. То, что заняло бы целое аккуратное утро, может быть готово за двадцать минут.

Где он не дотягивает

• Он уверенно ошибается. Иногда Claude Code реализует что-то неправильно и никак не показывает сомнений, так что читайте результат, а не просто запускайте его, особенно если дело касается данных или денег.
• Архитектуру за вас он не придумает. Воплощать готовый замысел он умеет хорошо, а решать, что строить, как устроить систему и на какие компромиссы идти, — нет. Эти решения остаются за вами.
• Ограничения контекста реальны. В очень большой кодовой базе он видит не всё, поэтому указывайте ему нужные файлы, а не надейтесь, что он сам знает, куда смотреть.
• Он не запустит то, что не запускается в вашем окружении. Если тестам нужно конкретное подключение к базе, работающий сервер или переменные окружения, всё это должно быть настроено. Он работает в вашем реальном окружении, это не магия.

Прежде чем доверять ему что-то критичное для продакшена, стоит точно понять, где он ошибся на реалистичной задаче.

Три промпта, которые стоит сохранить

Они появились после множества проб и ошибок.

Сначала контекст. Прямо опишите текущее и желаемое поведение, чтобы Claude не понял неправильно то, что уже есть:

I'm working in [filename]. Here's the current behavior:
[describe it]

Here's what I want it to do instead:
[describe it]

Constraints: [any important limits]

Make the change and update any affected tests.

Вытащите допущения наружу. Используйте этот промпт всякий раз, когда требования хоть немного неоднозначны. Он стоит полминуты и спасает от тонко неправильной реализации:

Before you start coding, list the assumptions you're making
about how this should work. I'll confirm or correct them.

Ревью по чек-листу. Код-ревью полезнее всего, когда вы говорите, что искать. Иначе модель склонна цепляться к стилю и пропускать важное. Запускайте это перед слиянием всего значимого:

Review this code for: performance issues, security concerns,
missing error handling, and anything that would cause problems
at scale. Be specific. If something is fine, say it's fine
and move on.

Claude Code или Copilot?

Они сильны в разных задачах, поэтому те, кто пробует оба, обычно оставляют оба. Copilot выигрывает во встроенном автодополнении: подсказки появляются прямо по ходу набора, без переключения мыслей, автодополнение по Tab у него до сих пор плавнее, и в интерфейс VS Code он встроен чуть лучше. Claude Code сильнее в задачах на много файлов, расследованиях, рефакторинге и во всём, что можно описать обычным языком и оставить ИИ разбираться по всей кодовой базе. В агентных возможностях он явно впереди.

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

Что изменило всё

После месяцев ежедневного использования главный прирост дала не настройка. Его дала смена того, что вы просите. Те, кто выжимает из Claude Code максимум, не пишут с ним функции быстрее. Они дают ему задачи покрупнее, позапутаннее и пожизненнее: отложенный рефакторинг, фичу на шесть файлов, расследование, которое съело бы полдня чтения логов.

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