Claude Code vscode — это расширение с отдельной панелью в редакторе: вы выделяете код в редакторе, пишете задачу, а правки приходят в виде diff рядом с исходным файлом, где каждое изменение можно принять или отклонить. Подход выручает, когда задача привязана к конкретному фрагменту кода, и вы хотите видеть результат в привычном окне, без переключения в терминал. Для задач на весь репозиторий с длинной серией команд терминальный режим остаётся удобнее.
Контекст из редактора
Расширение само видит выделенный текст и открытый файл, а клавиша Option+K на Mac или Alt+K на Windows и Linux вставляет в запрос ссылку на файл и диапазон строк. Для установки нужен VS Code версии 1.94.0 или новее и платная подписка либо учётная запись консоли.
Документация расширения описывает три источника контекста. Первый: выделенный фрагмент, число строк которого показывает нижняя строка панели. Второй: открытый файл, имя которого отображается в запросе, даже без выделения. Третий: ссылки через символ @ на файлы и папки, включая диапазон вида @файл#5-10. Чем точнее вы очертили границы, тем меньше агент читает лишнего и тем короче получается ответ.
Отдельная деталь касается исключений. Если файл лежит в рабочей папке и подпадает под настройки files.exclude или search.exclude, расширение передаёт агенту в лучшем случае путь, а сам выделенный текст удерживает. Для файлов с секретами это полезно: фрагмент с ключами из исключённого файла останется вне запроса. Но единственной защитой это считать нельзя: секреты лучше хранить вне репозитория.
- Хотите ограничить контекст одной функцией — выделите её и добавьте ссылку клавишей
Option+K. - Нужно сослаться на соседний модуль — наберите
@и начните вводить имя файла. - Открытый файл мешает — отключите настройку «Attach Open File», и останется только выделенное.
Диапазон в запросе
Условный пример: в проекте есть функция выгрузки отчёта в CSV, и разделитель нужно сделать настраиваемым. Выделяете функцию, добавляете ссылку на строки и пишете: «Добавь параметр разделителя со значением по умолчанию точка с запятой. Остальные вызовы функции оставь рабочими, формат заголовков сохрани». Запрос содержит предмет, границу изменений и критерий сохранения поведения. Всё остальное агент выяснит чтением кода.
Постановка в расширении отличается от терминальной одним: контекст уже в окне, поэтому формулировка может быть короче. Зато растёт соблазн писать расплывчато: «исправь тут». Замена конкретных слов на «тут» и «это» возвращает агенту работу по угадыванию, а ревьюеру работу по расшифровке. Пишите так, чтобы коллега, получивший текст без выделения, понял задачу.
Вернёмся к примеру с разделителем. Хороший результат выглядит так: изменена одна функция, добавлен параметр со значением по умолчанию, вызовы в других модулях остались рабочими, а тест на формат заголовков прошёл без правок. Плохой результат тоже выглядит аккуратно: агент решил заодно переименовать столбцы и добавил обработку кодировки, которая в задаче отсутствовала. Именно поэтому границу изменений прописывают в запросе, вместо того чтобы оставлять на усмотрение модели, и именно по ней ревьюер проверяет итог.
Для крупных изменений сначала переключите панель в режим планирования командой /plan. Агент составит план, который можно прочитать и поправить до первой правки файлов. Команда /plan open открывает файл плана в редакторе. Правка плана обычно дешевле, чем разбор уже внесённых изменений, особенно когда задача затрагивает несколько модулей.
Приёмка diff
В режиме ручного подтверждения расширение показывает рядом исходный и предлагаемый вариант файла и спрашивает разрешение: принять, отклонить или написать агенту, что сделать иначе. Если вы поправили предложенный текст прямо в окне сравнения, агент получает сведения об этой правке. Под каждым изменением есть кнопки принятия и отклонения, поэтому крупный diff удобно разбирать кусками.
| Что видите | Как читать | Решение |
|---|---|---|
| Изменена только выделенная функция | Совпадает с границей из запроса | Принять после проверки вызовов |
| Затронуты соседние функции | Нужна ли правка для задачи или это попутный рефакторинг | Принять нужное, остальное отклонить |
| Добавлены новые файлы | Есть ли их упоминание в запросе | Отклонить, если появились без причины |
| Тесты исправлены вместе с кодом | Подгонка под ответ или реальное уточнение | Сверить с описанием задачи |
Читая diff, обращайте внимание на порядок: сначала смотрите, какие файлы затронуты, затем читайте изменения от самых рискованных. Рискованным считается код, влияющий на сохранение данных, права пользователей и обращения к внешним сервисам. Остальное читается быстрее. Такой порядок сокращает время ревью без потери внимания там, где ошибка обходится дорого, и приучает команду делить правки на дешёвые и дорогие ещё до открытия окна сравнения.
Режим автоматического принятия правок экономит клики, но убирает точку остановки. Включайте его на задачах, где ошибка дёшево исправляется возвратом через git, и оставляйте ручной режим на задачах с чувствительным кодом: оплата, права доступа, миграции. Решение принимает человек, а расширение лишь облегчает чтение. Сходный поток для агента OpenAI разобран в статье про Codex в редакторе VS Code; различия двух инструментов описаны отдельно, в сравнении Codex и Claude Code.
Какие правки вы принимали бы только вручную?
Тесты в терминале
Принятый diff заканчивает только первую половину работы. Вторая: тесты. Расширение содержит собственную копию Claude Code для панели чата, но чтобы запускать claude во встроенном терминале редактора, нужна отдельная установка консольной версии. Если в терминале команда отсутствует, причина именно в этом: панель работает, а терминал остаётся без неё. Установку описывает статья про установку Claude Code и первую задачу.
Тесты запускайте своими руками, отдельной командой проекта в терминале, вместо доклада агента в панели. Сравните вывод с тем, что агент сообщил о результате. При расхождении вернитесь в панель и сообщите агенту точный вывод: он умеет читать ошибку и вносить следующую правку. Каждый такой круг проходит под вашим контролем, а завершением считается ваш прогон.
Полезная привычка для параллельной работы: расширение позволяет открыть несколько разговоров в отдельных вкладках или окнах, и каждый хранит свою историю. Для двух независимых задач заведите два разговора и держите их раздельно: смешение приводит к тому, что агент тянет контекст первой задачи во вторую. Список прошлых разговоров открывается кнопкой истории сессий в верхней части панели.
Порядок приёмки
Соберите приёмку в один маршрут, одинаковый для всех сотрудников. Он короткий, и главное его достоинство в повторяемости: человек, вернувшийся из отпуска, проходит ту же последовательность, что и новичок.
- Прочитайте запрос глазами ревьюера: понятна ли задача без выделения.
- Просмотрите diff по кускам и отклоните всё, что выходит за границу задачи.
- Запустите тесты в терминале сами и сохраните вывод.
- Проверьте
git diffцеликом: появились ли файлы, пропущенные в панели. - Закоммитьте принятое отдельным коммитом с понятным сообщением, чтобы возврат остался дешёвым.
Общие правила для команды удобно хранить в файле CLAUDE.md репозитория: стиль, команды запуска тестов, запретные каталоги. Пример единого контура разобран в статье про Claude Code для команды. Эти правила читает и расширение, поэтому постановка задач в нём меньше зависит от личных привычек. Новому сотруднику достаточно открыть файл, прочитать команды запуска тестов и список запретных каталогов, и первая задача пойдёт по тому же маршруту, что у остальной команды. Если правила устарели, исправляйте файл сразу после обнаружения расхождения, иначе расширение продолжит следовать прежней версии.
Откройте тестовую ветку, выделите одну небольшую функцию и поставьте агенту задачу с границей и критерием. Разберите diff по кускам и запустите тесты сами. Если хотите настроить единый порядок работы с расширением в команде, обсудите с нами внедрение ИИ в разработку.