Как запустить первую задачу Claude Code в VS Code

Расширение Claude Code для VS Code полезно не тем, что переносит чат в редактор. Оно собирает в одном месте задачу, план, diff и решение — принять изменение или отклонить его. Для первого запуска лучше выбрать маленькую правку, которую легко проверить и отменить. Ниже — путь от установки до первого принятого diff без выдуманных тестов и обещаний сэкономить часы.

Claude Code требует VS Code версии 1.94.0 или новее. Текущую версию можно посмотреть через Help → About. Если редактор старее, сначала обновите его: иначе легко потратить время на поиск проблемы в авторизации или сети.

Затем выберите способ доступа. Официальный сценарий использует платную подписку Claude или аккаунт Claude Console. При первом открытии расширения авторизация проходит в браузере, отдельный API Key не нужен.

С пользовательским endpoint схема другая: переменные окружения, Base URL и отключение стандартного окна входа зависят от конкретного провайдера. BetterToken.ai можно рассматривать как один из вариантов подключения: сервис предоставляет API Key и Anthropic-compatible Base URL, а точные переменные и значения следует брать из текущей документации сервиса.

Не смешивайте обе схемы в одной попытке настройки. Сначала добейтесь ответа через выбранный способ, затем добавляйте остальные параметры.

Откройте Extensions сочетанием Cmd+Shift+X на macOS или Ctrl+Shift+X на Windows и Linux. Найдите Claude Code, проверьте, что издатель — Anthropic, и нажмите Install.

После установки откройте любой файл. В правой части панели редактора должен появиться значок Spark. Claude Code также открывается через значок в Activity Bar, строку состояния ✱ Claude Code или Command Palette.

Если расширение установлено, но значка нет, выполните команду «Developer: Reload Window». Затем проверьте версию VS Code и режим доверия к рабочей папке. Один только открытый каталог недостаточен для значка в панели редактора — должен быть открыт файл. При этом вход через строку состояния работает и без открытого файла.

У расширения есть собственная закрытая копия CLI для панели чата. Она не добавляет команду claude в PATH. Поэтому рабочая панель Claude Code и ошибка command not found в интегрированном терминале могут существовать одновременно. Для терминального режима нужна отдельная установка CLI.

В официальном сценарии откройте панель Claude Code, нажмите Sign in и завершите авторизацию в браузере. После возврата в VS Code задайте вопрос без изменения файлов:

«Объясни, за что отвечает входная функция в открытом файле. Ничего не меняй.»

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

Если в shell уже задан ANTHROPIC_API_KEY, а VS Code всё равно показывает окно входа, редактор мог не получить окружение терминала. В официальной документации предложены два варианта: запустить проект из терминала командой «code .» или войти через аккаунт Claude.

Для пользовательского провайдера у расширения есть настройки environmentVariables и disableLoginPrompt. Запишите только параметры, которые требует документация вашего провайдера, полностью перезагрузите окно и снова начните с запроса на чтение. Не копируйте случайный settings.json из старого поста вместе с неизвестными переменными.

Найдите в проекте небольшой файл, для которого уже есть тест. Не начинайте с запросов вроде «оптимизируй проект» или «почини авторизацию». Такой prompt трудно проверить, а большой diff легко принять по инерции.

Замените путь в примере на реальный файл своего проекта:

«Измени только src/utils/formatName.ts: добавь обработку null и undefined. Не трогай места вызова и не рефактори соседние функции. Сначала опиши план и дождись моего подтверждения. После изменения покажи diff и запусти существующий тест этого модуля. Если команда теста неизвестна, остановись и спроси, где её найти.»

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

Переключите permission mode в Manual или Plan. В Manual Claude спрашивает разрешение перед изменением файлов и большинством shell-команд. В Plan он сначала описывает действия и ждёт подтверждения. План открывается как Markdown-документ, в котором можно оставлять замечания до начала работы.

В плане проверьте три вещи: указан ли только нужный файл, сохранится ли текущий интерфейс функции и будет ли запущен существующий тест. Если появились «заодно рефакторить», «обновить все вызовы» или «унифицировать имена», удалите эти пункты.

Цель первой задачи — проверить управляемый процесс. Размер изменения здесь ничего не доказывает.

Когда Claude предлагает изменить файл, расширение показывает исходную и новую версии рядом. После этого оно спрашивает разрешение. Можно принять правку, отклонить её, попросить другой вариант или отредактировать предложенный текст прямо в diff до применения.

Проверьте четыре вопроса:

— Изменён только согласованный файл?

— Сохранена прежняя обработка остальных входных значений?

— Не появилась новая зависимость?

— Поведение вне тестируемого случая осталось прежним?

Если diff слишком велик для спокойной проверки, отклоните его и сузьте prompt. Быстрая прокрутка большого diff не заменяет ревью.

После применения откройте Source Control и проверьте список файлов. Затем запустите существующий unit test, type check или минимальную команду запуска проекта. Универсальной команды для всех репозиториев нет. Проверка считается понятной, когда вы можете объяснить, какое изменение подтверждает каждая команда.

Выделенный в редакторе код автоматически попадает в контекст Claude. Сочетание Option+K на macOS или Alt+K на Windows и Linux добавляет в prompt ссылку на файл и диапазон строк. Это удобный способ ограничить вопрос конкретной функцией.

Command Palette нужен для новой сессии, перемещения панели и запуска walkthrough. История сессий помогает вернуться к разбору ошибки, но перед продолжением старого диалога проверьте, что ветка и состояние файлов не изменились.

Permission mode выбирайте по риску. Для первого изменения подходят Manual и Plan. Автоматическое принятие имеет смысл только при стабильном шаблоне задачи, ясных тестах и простом откате. В незнакомом репозитории оставьте ручное подтверждение.

Расширение подходит для задач, где важен визуальный контроль: выделить код, открыть план, сравнить версии файла и принять diff. CLI полезнее, когда нужны полный набор команд и skills, shortcut ! для bash, Tab completion или полная настройка MCP.

Это не два взаимоисключающих продукта. Расширение и CLI используют общую историю разговоров. Команда «claude --resume» позволяет продолжить сессию расширения в терминале.

Но для запуска «claude» в интегрированном терминале нужен отдельно установленный CLI. Встроенная в расширение копия обслуживает панель чата и не появляется в PATH.

Перед тем как дать Claude Code более крупную задачу, проверьте:

— VS Code соответствует минимальной версии, издатель расширения — Anthropic.

— Вы можете назвать выбранный способ доступа: аккаунт или пользовательский endpoint.

— В prompt ограничены файл, поведение и проверка.

— План прочитан до начала изменения.

— Diff проверен до применения.

— В Source Control нет неожиданных файлов.

— Запущена хотя бы одна существующая проверка проекта, и понятно, что она подтверждает.

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

Claude Code, Use Claude Code in VS Code — https://code.claude.com/docs/en/vs-code

Claude Code, IDE integrations — https://code.claude.com/docs/en/ide-integrations