Claude Code в VS Code: как подключить и использовать

Запросы «vs code claude», «как использовать claude в vs code» и «как подключить claude к vs code» заметно выросли: разработчикам надоело переносить контекст между терминалом, редактором и браузером. Ответ простой — Claude Code отлично работает внутри VS Code: либо через официальное расширение, которое встраивает агента прямо в редактор, либо через CLI в встроенном терминале.

В этой статье — пошаговая инструкция: установка, подключение API-ключа через LiteAI (30 ₽ за 1M токенов, оплата в рублях, без VPN), запуск в VS Code, проверка diff-изменений, выбор модели и типовые проблемы.

Почему VS Code — удобная среда для Claude Code

Claude Code — официальный агентный CLI от Anthropic. Он не зависит от редактора, но в VS Code доступны вещи, которых нет в «голом» терминале:

• Встроенный терминал (Ctrl+`) — Claude Code работает там же, где открыт проект.
• Diff-просмотр правок — в режиме расширения изменения видны как привычный red/green diff прямо в редакторе; принять или откатить можно в один клик.
• Контекст из редактора — агент знает, какие файлы открыты, и их можно явно добавить в контекст.
• Git-интеграция — после серии правок их удобно сразу просмотреть в Source Control и закоммитить.

Коротко: терминал — «мышцы», VS Code — «руки и глаза». Дальше — установка.

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

Требования: Node.js 18+, git, доступ в интернет.

Вариант A: CLI через npm (универсальный)

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

Если версия вывелась — CLI готов. Проверить, что бинд в PATH: which claude (Linux/macOS) или where claude (Windows).

Вариант B: Официальное расширение для VS Code

1. Откройте VS Code → панель Extensions (Ctrl+Shift+X).
2. Найдите Claude Code (издатель — Anthropic) → Install.
3. В сайдбаре появится иконка Claude Code — по ней открывается панель агента: чат, текущая задача, список изменённых файлов.

По факту расширение ставит тот же CLI, но обвязывает интерфейсом редактора: diff-режим, кнопки принятия изменений, запуск из папки проекта. Для тех, кто хочет жить в VS Code без танцев с терминалом, — кратчайший путь.

Специфика Windows (PowerShell, ExecutionPolicy, PATH) отдельно расписана в статье Claude Code на Windows — скачать и установить за 5 минут.

Программа есть. Осталось дать ей «мозги» — API-ключ.

Шаг 2. Получите ключ LiteAI

По умолчанию Claude Code ждёт ключ Anthropic вида sk-ant-…, который выпускается в аккаунте Anthropic и оплачивается в долларах. Для разработчика из РФ это боль: аккаунт без иностранной карты, пополнение не проходит по российскому BIN, плюс VPN.

LiteAI убирает все три камня сразу:

1. Перейдите на страницу тарифов и выберите пакет: от 1M токенов за 30 ₽ — с запасом на десятки рабочих сессий — до крупных объёмов для команды.
2. Оплатите удобным способом — ключ sk-bf-… придёт на почту и появится в Telegram-боте @liteaitech_bot.
3. Ключ универсальный: открывает и Anthropic-эндпоинт (для Claude Code), и OpenAI-совместимый (для Cursor, Zed, opencode).

Там же через LiteAI доступен весь каталог Claude-моделей — Sonnet 5, Opus 5, Haiku 4.5, fable-5. Полная схема подключения ключа, включая оба варианта (быстрый и постоянный) — в статье Claude Code с API ключом Anthropic — подключение за 2 минуты.

Шаг 3. Подключите ключ

Два рабочих варианта: постоянный конфиг (рекомендуется) и env-переменные на сессию.

Постоянный: ~/.claude/settings.json

Создайте или дополните файл ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.liteai.tech/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-bf-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

Перезапустите VS Code (или откройте новый терминал) — дальше claude из любой папки подхватит настройки.

На сессию: export в терминале

Если глобальный конфиг трогать не хочется:

export ANTHROPIC_BASE_URL="https://api.liteai.tech/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-bf-..."
claude

Закроете терминал — переменные исчезнут. Для разового запуска — ок, для повседневки — settings.json.

Какой эндпоинт использовать

Инструмент	URL	Авторизация
Claude Code, официальный Anthropic SDK	https://api.liteai.tech/anthropic	x-api-key / ANTHROPIC_AUTH_TOKEN
Cursor, Zed, opencode, Cline, OpenAI SDK	https://api.liteai.tech/v1	Authorization: Bearer sk-bf-…

Для связки «VS Code + Claude Code» берётся первый — он отвечает по протоколу Anthropic Messages API, на котором говорит CLI, и отдаёт те же SSE-события и tool use.

Шаг 4. Запустите в VS Code

Проверяем:

1. Откройте нужную папку в VS Code (File → Open Folder).
2. Terminal → New Terminal (или Ctrl+`).
3. Введите claude и Enter.
4. При первом запуске CLI предложит выбрать тему и принять условия — можно просто прокликать дальше.
5. Напишите задачу, например: «Продумай и добавь логирование в обработчики из src/api, тесты не трогай».

Агент сам прочитает нужные файлы, внесёт правки и отчитается, что изменилось. Главное теперь — проверить изменения глазами.

Как читать изменения кода в редакторе

В режиме официального расширения Claude Code показывает каждую правку до применения в виде diff: красным — убираемое, зелёным — добавляемое. Затронутые файлы видно списком; по каждому можно открыть сравнение и принять либо вернуть его отдельно.

В CLI-режиме без UI правки сразу применяются к файлам, а VS Code сам подсветит изменившиеся файлы (если параллельно вы их не редактировали вручную). Рабочий ритуал:

1. Дать задачу → агент правит файлы.
2. Открыть Source Control (Ctrl+Shift+G) → посмотреть полный список изменений.
3. Для каждого файла открыть diff-режим (значок возле пути в Source Control).
4. Всё хорошо — коммит. Не всё — git checkout -- <файл> (или соответствующая кнопка в Source Control) и поправить вручную.

Так «слепой» фрагмент, нагенерированный агентом, не уедет в продакшен.

Выбор модели

Один и тот же ключ sk-bf-… открывает весь каталог LiteAI. Для Claude Code актуальны следующие модели:

Модель	Когда брать	Примечание
claude-sonnet-5	Повседневная разработка: баги, рефакторинг, code review	Дефолт, лучшее соотношение цена/качество
claude-opus-5	Глубокие задачи: архитектура, крупные рефакторинги, сложный ревью	Медленнее и дороже на тех же токенах — включать точечно
claude-haiku-4-5	Бытовые операции: переименования, форматирование, шаблоны	Самый быстрый, экономит бюджет на «мелочах»

Переключение на ходу:

• Внутри сессии: /model claude-opus-5.
• В настройках: изменить ANTHROPIC_MODEL в settings.json.
• Для конкретного запуска: claude --model claude-haiku-4-5.

Рабочая схема: начинаете с Sonnet 5, и когда задача «вдаётся» в глубину (архитектура, многофайловый рефакторинг) — включаете Opus 5 только под неё. Экономия относительно «всегда топ-модели» — в 2–3 раза по токенам. Полная матрица выбора по типам задач — в статье Какую модель Claude выбрать в 2026.

MCP-серверы в связке

Отдельно от редактора Claude Code умеет говорить по MCP (Model Context Protocol) — стандарту подключения внешних инструментов: база данных, GitHub, Slack, поиск. В связке с VS Code это выглядит так: агент сам читает схему БД, правит миграцию и открывает PR.

Начните с одного — например, GitHub MCP, чтобы агент умел создавать PR и читать комментарии. Подробный разбор с конфигурациями — в статье Claude Code MCP servers — полный гайд 2026.

Частые проблемы

401 Invalid API Key — в девяти случаях из десяти: лишний пробел или перенос строки при копировании. Проверьте, что sk-bf-… стоит одной строкой, без кавычек. Быстрая проверка без Claude Code:

curl https://api.liteai.tech/anthropic/v1/messages \
  -H "x-api-key: sk-bf-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":64,"messages":[{"role":"user","content":"hi"}]}'

Если пришёл JSON — ключ жив.

claude: command not found — npm-бинд не попал в PATH. На Windows чаще всего вопрос в PowerShell и ExecutionPolicy — пошаговое решение в статье про установку на Windows. На Linux/macOS: проверьте, куда npm положил глобальные бинды, и добавьте её в PATH.

Ошибка региона / «VPN required» — устаревшая версия Claude Code. Обновитесь: npm i -g @anthropic-ai/claude-code@latest, затем закройте и откройте терминал. Ключ LiteAI не привязан к IP, так что после обновления ошибка уходит.

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

Claude Code «думает» слишком долго — не всегда зависание: агент читает файлы и строит план. Индикатор — мигающий курсор в терминале или спиннер в панели расширения. Если на простой задаче «думает» больше двух минут — проверьте, что не включили Opus на мелочь, и что сеть не проседает.

Правка «залипла» в буфере — если во время правки агентом вы правили файл руками, буфер может показывать старую версию. Сохраните всё (Save All) и перезагрузите файл из диска (Revert File), чтобы увидеть актуальный результат.

Claude Code «не видит» только что созданный файл — агент видит состояние проекта на момент старта контекста. Если вы создали файл руками во время работы — явно скажите об этом в следующей команде, например: «Я создал src/new.ts, учти его», и агент подхватит.

Агент «зависает» на этапе ожидания ввода — иногда агент ждёт вашего ответа на уточняющий вопрос и вроде как «завис». Посмотрите в терминал — скорее всего там вопрос. Ответьте (или Esc, чтобы прервать) — и он продолжит. Если вопросы бесконечные — дайте более полную команду сразу, чтобы уточнений было меньше.

Агент «думает», что закончил, а патч не применился — редкий кейс: агент отчитался «готово», а файл не изменился. Проверьте фактическое состояние: если патч действительно ушёл в пустоту — пересоберите контекст (например, через /compact) и задайте ту же команду, добавив: «проверь по факту, что изменение действительно сохранилось». Если не помогло — примените вручную.

Патч «завис» в панели расширения — если правки не применяются и лежат в списке, возможно, агент был прерван на середине. Примените или отмените застрявшие вручную (соответствующие кнопки), затем продолжите задачу: уточните, какие правки уже применены и какие ещё остаются. Если очередь «заполняется» систематически — давайте задачи с пометкой «применяй по одному файлу».

Модель «не помнит» ваши правила из CLAUDE.md — нет, он их не «забывает»: этот файл подхватывается в начале каждой сессии. Если кажется, что правило не учли, чаще всего дело в формулировке: правило слишком развёрнутое или тонет под массой текста. Решения: сделайте правило коротким и конкретным (один пункт — одна строка); важные правила поднимите наверх; для «сложных» правил добавьте пример — так модель точно поймёт, что от неё хотят.

Claude Code «повторяет» уже сделанное — признак того, что контекст «загадился»: агент не понимает, что часть работы уже выполнена. Решения: используйте /compact, чтобы сократить историю до сути; либо /clear и задайте заново с пометкой: «Уже сделано X, Y — продолжай с Z». Для повторяющихся задач фиксируйте «текущее состояние» в CLAUDE.md, чтобы оно не терялось при сбросе сессии.

«Пробовал всё, а не работает» — если базовые шаги (ключ, env, версия) выполнены, а Claude Code всё равно ругается, соберите данные: точный текст ошибки, вывод claude --version, ОС и редактор. Иногда помогает самый банальный приём: полностью закрыть VS Code и открыть заново (а не только терминал). Последний ход перед «всё сломалось» — пересоздать settings.json с нуля, скопировав туда только блок env из этой статьи.

Claude Code работает, но «зависает» на долгих задачах — для больших задач (архитектура, многофайловый рефакторинг) агент честно думает минуту и больше. Это не «залип»: просто сложная задача. Признаки жизни: курсор мигает, спиннер крутится, время от времени появляются промежуточные шаги. Если на простой задаче «думает» 3+ минуты — это уже повод проверить модель и сеть; на сложной — просто подождите.

Агент «залип» и не понимает, что от него хотят — классика: дали размытую команду, и агент начинает «плыть» (делать не то или переспрашивать по кругу). Выход: остановить (Esc) и переформулировать задачу конкретно — что изменить, в каких файлах, какой результат ожидается. Чем конкретнее исходная команда, тем меньше «залипаний» по ходу. Для регулярных задач — такие конкретные формулировки закладывайте в CLAUDE.md.

«Патч наполовину» — три разных случая — одно название, но причины разные, и отсюда и лечение:

• Отчитался, а в файле мусор — агент думает, что закончил, а на деле оставляет «хвосты»: незакрытые скобки, временные комментарии. Откройте diff и оцените правку целиком — мусор обычно бросается в глаза; затем остановите агента и задайте уточняющую команду: «убери временные конструкции и проверь синтаксис».
• Отчитался, а файл не тот — правки коснулись не того файла, не той функции, либо вообще не применились. Чаще всего агент потерял ниточку контекста (сессия стала длинной). /compact и повторная команда с конкретикой (файл, функция, ожидаемое изменение); либо переформулировать с примером «было/стало».
• Серия правок прервалась на середине — часть файлов изменена, часть нет, состояние «висящее». Серия не была атомарной: агент «забыл» про часть файлов из плана, или конфликт/ошибка на одном из файлов оборвала цепочку. Определите точку «залипания» (какие файлы уже тронуты), напомните список файлов из исходной задачи и попросите свериться; разрешите конфликт и продолжите. Для мультифайловых правок просите агента назвать план (список файлов) до начала, проверяйте прогресс после каждого файла и используйте git, чтобы иметь возможность откатить «половинку» и начать заново.

Claude Code «залипает» на /compact — редко, но бывает: если история сессии огромна, сжатие может занять 10–30 секунд вместо мгновенного. Это нормальный процесс обработки, а не зависание — просто подождите завершения. Если пауза затянулась больше минуты, пересоберите сессию вручную (Esc → /clear) и продолжайте уже с компактным контекстом. Профилактика — давать агенту задачи послоями, чтобы история не раздувалась до пределов.

Агент «залип» и перестал отвечать — иногда Claude Code будто «замирает»: курсор мигает, а реакции нет. Чаще всего это не баг, а одна из трёх причин:

• Модель «думает» сложную задачу (особенно Opus 5) — подождите 10–30 секунд.
• Завис network-запрос (проверьте связь с api.liteai.tech).
• Сессия перегружена контекстом (много файлов, длинная история) — нажмите Esc для прерывания, затем /compact или /clear.

Если «залипание» повторяется на простых командах — перезапустите сессию (/clear) и проверьте модель: попробуйте claude --model claude-haiku-4-5 для скорости.

«Думает», но не додумывает — агент начал рассуждать (линия за линией), но внезапно обрывает поток и выдаёт неполный ответ или вовсе молчит. Вероятные причины:

• Достигнут лимит max_tokens на выход — увеличьте его в команде или настройках сессии.
• Модель упирается в «петлю» рассуждений (особенно на нечётких задачах) — уточните вводные.
• Контекст «захламлён» — выполните /compact, чтобы освободить место для финальной части вывода.

Предотвращение: для длинных выводов заранее поднимайте лимит выходных токенов и подавайте задачи максимально структурированно.

Claude Code «залипает» на чтении больших файлов — при работе с крупными файлами (тысячи строк) агент может долго «копать» в них, из-за чего сессия визуально «звенит». Это штатное поведение: модель режет файл на куски и анализирует их. Сократить время помогают:

• Узкая постановка задачи (нужен не обзор всего файла, а конкретная функция/блок).
• Модель с большим контекстом и быстрой обработкой (Haiku 4.5 для сканирования, Sonnet 5/Opus 5 для анализа найденного).
• Предварительная фильтрация: перед запуском агента найдите нужные строки через поиск (Grep) и укажите их номера в задаче.

Если файл «огромный» (сотни КБ), лучше разбить работу: дать агенту диапазон строк, обработать, затем следующий.

Агент «залипает» на ожидании инструмента (MCP) — если в Claude Code подключены MCP-серверы (база данных, GitHub, Playwright и т.д.), сессия может «звенеть» на шаге, когда агент ждёт ответа инструмента: запрос ушёл в внешний сервис, а тот обрабатывает. Это не зависание самого Claude Code, а внешний фактор. Диагностика и решение:

• Посмотрите лог/вывод агента: на каком именно MCP-инструменте он «висит».
• Проверьте доступность и здоровье того внешнего сервиса (жив ли, не перегружен ли).
• Если сервис здоров, но медленно — добавьте таймаут на вызов инструмента, чтобы агент не ждал бесконечно, а перешёл к плану Б (например, сделал вручную или попросил у вас).
• Для повторяющихся случаев — оптимизируйте запросы к инструменту (меньше данных за один вызов, батчинг) или поднимите лимит ожидания.

Простая профилактика: задайте MCP-инструментам разумные таймауты и логгируйте длительность их вызовов — тогда «залипания» видно заранее и их легко локализовать.

Claude Code «залипает» на первом запуске — при первой установке/запуске расширение или CLI может показаться «звенящим»: идёт загрузка зависимостей, инициализация, скачивание компонентов. Это нормальный разовый процесс. Если первая загрузка «залипла» на несколько минут: проверьте сеть, попробуйте перезапустить VS Code; при повторении — очистите кэш расширения/CLI. В дальнейшем запуск должен быть быстрым.

Агент «залипает» на ожидании вашего решения — Claude Code может остановиться и ждать, пока вы не примете решение (например, выбрать вариант, подтвердить действие). Вы можете подумать, что он «залип», но на самом деле он ждёт вас. Как понять, что он ждёт вас, а не завис:

• Посмотрите последнее сообщение/вопрос агента: если там вопрос к вам — он ждёт.
• В интерфейсе может быть выделено место для вашего ответа.

Что делать: ответьте на его вопрос / примите предложенное решение. Чтобы таких остановок было меньше: давайте более полные команды изначально (с указанием предпочтений) и используйте дефолты там, где выбор не критичен.

Claude Code «залипает» на ожидании ответа API — если сессия «звенит» на шаге, где агент ждёт ответ от LLM API (в нашем случае LiteAI), это значит, что запрос ушёл в модель, та обрабатывает. Для простых ответов это секунды; для сложных рассуждений (Opus 5) — десятки секунд и больше. Диагностика и решение:

• Определите, «звенит» ли на простых или сложных задачах. Если на простых задержки большие — проверьте модель (возможно, включили тяжёлую) и сеть.
• Проверьте доступность и задержки api.liteai.tech (пинг/таймауты).
• Для повторяющихся случаев — используйте подходящую модель под тип задачи (Haiku для быстрых, Sonnet для баланса, Opus для сложности) и следите за загрузкой API.

Простая профилактиция: подбирайте модель под задачу (не «всегда максимум») и отслеживайте типичные задержки ваших запросов, чтобы отличать нормальную обработку от реального сбоя.