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

Как установить Claude Code в VS Code, если вы ни разу не открывали редактор кода, а слово «терминал» вызывает лёгкую панику? Спокойно: основную часть делают мышкой, терминал понадобится только в запасном варианте, а на всё уходит около получаса.

Меня зовут Анастасия Майер, я архитектор контент-заводов и инженер по ИИ. Именно так у меня и у команды настроены рабочие места: VS Code на ноутбуке, внутри Claude Code, доступ к моделям через российский API-сервис. Почти все ошибки из конца статьи мы собрали сами, пока настраивали.

Дальше по порядку: подготовка, редактор, расширение, вход по подписке или ключ сервиса из России, первая задача и разбор ошибок.

Что понадобится до начала

Коротко: компьютер на macOS или Windows, интернет и один из двух доступов к Claude - платная подписка или аккаунт Console у Anthropic либо ключ российского API-сервиса с адресом в формате Anthropic.

Компьютер. macOS, Windows или Linux, по документации от 4 ГБ оперативной памяти.

Доступ к Claude. Есть два варианта, и от выбора зависит один из шагов ниже.

• Подписка или Console. Подходит любая платная подписка Claude (Pro, Max, Team, Enterprise) или аккаунт Console с оплатой за запросы. Бесплатный тариф claude.ai Claude Code не включает. Работает только в странах, которые поддерживает Anthropic, России среди них нет.
• Ключ российского API-сервиса. Для тех, кто живёт в России. Сервис-агрегатор держит доступ к моделям, принимает оплату в рублях и выдаёт свой ключ. До оплаты проверьте в его документации три вещи: модели Claude в каталоге, отдельную инструкцию для Claude Code и адрес в формате Anthropic. Без такого адреса Claude Code к сервису не подключится.

Папка под проект. Заведите на рабочем столе пустую папку, например moy-pervyy-proekt. Положите туда текстовый файл tekst.txt с парой абзацев о своём деле: что продаёте, кому, чем отличаетесь. Он понадобится для первой задачи.

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

Коротко: скачайте редактор с официального сайта code.visualstudio.com, установите как обычную программу и проверьте, что версия свежая.

На macOS. Нажмите на сайте кнопку загрузки для Mac. Скачается архив, после двойного клика по нему появится программа Visual Studio Code. Перетащите её в папку «Программы» и запустите оттуда. При первом запуске система спросит, точно ли открыть программу из интернета, - соглашайтесь.

На Windows. Скачайте установщик для Windows и запустите. На экране дополнительных задач оставьте отмеченным пункт «Add to PATH» и поставьте галочки на «Open with Code» для файлов и папок: потом папку проекта можно будет открывать правой кнопкой мыши.

Проверьте версию. На Windows - Help → About, на macOS - Code → About Visual Studio Code. Если редактор стоит у вас давно, обновите его через Help → Check for Updates (на macOS - Code → Check for Updates): у расширения Claude Code есть минимальная версия редактора, и на старой оно просто не установится.

Интерфейс VS Code на английском. Русский пакет можно поставить, но первое время лучше без него: названия меню совпадут с инструкцией.

Шаг 2. Поставьте расширение Claude Code

Коротко: откройте раздел расширений, найдите Claude Code от издателя Anthropic и нажмите Install. Отдельно ставить сам Claude Code для панели не нужно: расширение несёт свою копию внутри.

Откройте раздел расширений. Сочетание Cmd+Shift+X на macOS или Ctrl+Shift+X на Windows. Или нажмите на значок из четырёх квадратиков в левой полосе.

Найдите расширение. В строке поиска наберите Claude Code. Смотрите на издателя под названием: нужно расширение от Anthropic. Похожие по названию расширения других авторов не подойдут.

Установите. Кнопка Install на карточке расширения. Готово, когда вместо неё появится кнопка Uninstall.

Если после установки ничего не изменилось, перезапустите VS Code или выполните команду Developer: Reload Window. Команды вызываются через палитру: Cmd+Shift+P на macOS или Ctrl+Shift+P на Windows, начните печатать название и выберите его из списка.

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

Шаг 3. Откройте папку проекта и найдите панель Claude

Коротко: откройте свою папку через File → Open Folder, подтвердите доверие к ней и вызовите панель Claude иконкой-искрой, палитрой команд или через меню View.

Откройте папку. File → Open Folder, выберите moy-pervyy-proekt. Claude работает с файлами именно этой папки.

Подтвердите доверие. VS Code спросит, доверяете ли вы авторам файлов в папке. Нажмите «Yes, I trust the authors». В ограниченном режиме расширение Claude Code не работает, и это частая причина, почему панель молчит.

Найдите панель. Способов несколько, достаточно одного:

• Иконка-искра. В правом верхнем углу редактора появляется значок Claude в виде искры. Он виден только когда открыт какой-нибудь файл: щёлкните по tekst.txt в списке слева, и иконка появится.
• Палитра команд. Cmd+Shift+P или Ctrl+Shift+P, наберите Claude Code и выберите Open in New Tab (панель откроется вкладкой рядом с файлами) или Open in Side Bar.
• Меню View. View → Open View, в списке найдите Claude Code.

В свежих версиях VS Code панель Claude часто открывается справа, рядом с чатом Copilot. Значка в левой полосе может и не быть - установка от этого не сломана. Панель можно перетащить мышкой за заголовок куда удобно: вправо, влево или во вкладку.

Шаг 4, если у вас подписка: войдите в аккаунт

Коротко: при первом открытии панели появится экран входа. Нажимаете Sign in, подтверждаете вход в браузере и возвращаетесь в VS Code.

Нажмите Sign in. Откроется браузер со страницей входа в аккаунт Claude. Войдите той же почтой, на которую оформлена подписка или аккаунт Console, и подтвердите доступ.

Вернитесь в редактор. Панель сама подхватит вход, и внизу появится поле для сообщения.

Если позже панель напишет «Not logged in · Please run /login» и экран входа не откроется сам, выполните Developer: Reload Window.

Вариант для тех, кто живёт в стране из списка Anthropic. С российского адреса вход упрётся в регион, а обход через VPN ведёт к блокировке аккаунта. Для России - следующий раздел.

Как установить Claude Code в VS Code из России: адрес и ключ сервиса

Коротко: это шаг 4 для тех, кто в России. В аккаунт Anthropic не входите: отключите в настройках расширения окно входа и пропишите адрес сервиса и ключ в файле настроек Claude Code.

Действие 1. Отключите окно входа. Откройте настройки: Cmd+, на macOS или Ctrl+, на Windows. В поиске наберите Claude Code login и поставьте галочку Disable Login Prompt. По документации она нужна как раз при подключении через сторонних провайдеров.

Действие 2. Откройте файл настроек Claude Code. Он называется settings.json и лежит в скрытой папке .claude в вашей домашней папке. Этот файл общий для панели в VS Code и для Claude Code в терминале.

• macOS: путь /Users/ваше-имя/.claude/settings.json. В VS Code выберите File → Open File, нажмите Cmd+Shift+G и вставьте путь к папке.

~/.claude/

• Windows: путь C:\Users\ваше-имя\.claude\settings.json. Так же через File → Open File, в адресную строку окна вставьте:

%USERPROFILE%\.claude

Папка .claude обычно появляется сама после первого запуска расширения. Если её нет, откройте в VS Code терминал через Terminal → New Terminal и выполните одну команду. На macOS:

mkdir -p ~/.claude

На Windows:

mkdir $HOME\.claude

Если файла settings.json внутри нет, создайте его: File → New File, вставьте текст из следующего действия и сохраните в эту папку под именем settings.json.

Действие 3. Пропишите адрес и ключ. Если файл пустой, его содержимое - одна строка:

{"env": {"ANTHROPIC_BASE_URL": "адрес-сервиса", "ANTHROPIC_AUTH_TOKEN": "ваш-ключ"}}

Слова адрес-сервиса замените адресом из инструкции сервиса для Claude Code, буква в букву, а ваш-ключ - ключом из кабинета. Кавычки оставьте.

Пара уточнений, на которых спотыкаются:

• Какую переменную брать для ключа. ANTHROPIC_AUTH_TOKEN подходит, если сервис пишет про токен или заголовок Authorization. Если в его инструкции сказано про API-ключ или заголовок x-api-key, ставьте ANTHROPIC_API_KEY. У большинства сервисов в инструкции для Claude Code есть готовые строки - берите названия оттуда.
• Названия моделей. Если сервис просит указать названия моделей отдельными строками, добавьте их в тот же блок env, как написано у него.
• Файл уже не пустой. Тогда блок env добавляется внутрь существующих фигурных скобок, а между блоками ставится запятая. Ошибка в запятой - частая причина, почему ничего не работает.

Сохраните файл и выполните Developer: Reload Window. Теперь при открытии панели экрана входа не будет, и можно сразу писать.

Почему файл, а не настройка в терминале. VS Code, запущенный из Dock или меню «Пуск», может не видеть переменные из профиля терминала. Отсюда классическая ситуация: ключ правильный, а панель пишет, что вы не авторизованы. Файл настроек Claude Code читается при любом способе запуска.

Если панель всё равно просит войти. Есть второе место, которое расширение проверяет ещё до запуска, - пользовательские настройки самого VS Code. В палитре выполните Preferences: Open User Settings (JSON) и добавьте внутрь фигурных скобок строку, не забыв запятую после предыдущей:

"claudeCode.environmentVariables": [{"name": "ANTHROPIC_BASE_URL", "value": "адрес-сервиса"}, {"name": "ANTHROPIC_AUTH_TOKEN", "value": "ваш-ключ"}]

Про безопасность ключа. Ключ живёт только у вас на компьютере. Файл .claude/settings.json внутри папки проекта для него не годится: он уходит в репозиторий вместе с кодом. Скриншоты открытого файла настроек и пересылка в чат - туда же. Утёк ключ - отзовите его в кабинете сервиса и создайте новый.

Шаг 5. Дайте первую задачу и проверьте результат

Коротко: напишите задачу обычным русским языком, разрешите Claude создать файл и проверьте результат в папке, а при работе через сервис - ещё и списание в кабинете.

Напишите задачу. В поле внизу панели вставьте, например:

Прочитай файл tekst.txt и собери по нему одностраничный сайт: заголовок, три блока с преимуществами и кнопка «Написать в Telegram». Сохрани как index.html в этой папке.

Разрешите изменения. Claude прочитает файл и предложит создать index.html. Внизу поля ввода есть переключатель режима: в режиме с подтверждением Claude показывает, что собирается изменить, и ждёт разрешения, а в автоматическом правит сам. На старте держите режим с подтверждением - так видно, что происходит с файлами.

Проверьте файл. В списке слева должен появиться index.html. Щёлкните по нему правой кнопкой и выберите Reveal in Finder на macOS или Reveal in File Explorer на Windows, затем откройте файл двойным кликом - он откроется в браузере как обычная страница.

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

Дальше говорите с Claude как с исполнителем: «сделай кнопку крупнее», «добавь блок с отзывами». Выделенный в редакторе кусок файла Claude видит и понимает, о каком месте речь.

Запасной путь: Claude Code в терминале VS Code

Коротко: если панель капризничает, Claude Code можно запустить в терминале прямо внутри VS Code. Встроенная в расширение копия для терминала недоступна, поэтому Claude Code ставится отдельно, один раз.

Откройте терминал. Terminal → New Terminal в верхнем меню: внизу появится командная строка, открытая в папке проекта.

Установите Claude Code. Официальная команда установки для macOS:

curl -fsSL https://claude.ai/install.sh | bash

Для Windows, в PowerShell (он и открывается в терминале VS Code по умолчанию):

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

С российского адреса официальный установщик может ответить отказом по региону. Тогда остаётся второй официальный способ - через npm. Поставьте Node.js с сайта nodejs.org (версию с пометкой LTS), перезапустите VS Code и выполните:

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

На macOS не добавляйте перед командой sudo: документация прямо предупреждает, что это ведёт к проблемам с правами.

Проверьте установку. Команда ниже должна вывести номер версии:

claude --version

Запустите. В терминале, открытом в папке проекта, наберите:

claude

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

Если панель не появилась или Claude молчит

Коротко: найдите свой симптом в списке. Почти всё решается обновлением редактора, перезагрузкой окна или правкой файла настроек.

• Расширение не устанавливается. Обновите VS Code: на старой версии расширение не встанет.
• Нет иконки-искры. Откройте любой файл: без открытого файла иконки нет. Не помогло - Developer: Reload Window, проверьте, что папка открыта в доверенном режиме, и временно выключите другие ИИ-расширения.
• Экран входа при прописанном ключе. Не стоит галочка Disable Login Prompt, ключ прописан только в профиле терминала, или в settings.json ошибка в запятых и кавычках. Проверьте файл и попробуйте второе место - claudeCode.environmentVariables.
• Ошибка 401. Ключ скопирован не целиком, отозван или стоит не в той переменной. Поменяйте ANTHROPIC_AUTH_TOKEN на ANTHROPIC_API_KEY или наоборот, сверившись с инструкцией сервиса.
• Модель не найдена. Сервис не знает модель с таким названием. Пропишите названия моделей так, как указано в его инструкции.
• Отказ по региону при входе. Вы в России и пробуете войти по подписке. Переходите на подключение через ключ сервиса.
• Claude не отвечает. Проверьте интернет и баланс в кабинете сервиса, начните новый разговор. Не помогло - запустите claude в терминале и посмотрите, какую ошибку он покажет.
• На Windows открывается Диспетчер задач. Сочетание Ctrl+Shift+Esc, которое расширение использует для новой вкладки, Windows забирает себе. Открывайте Claude через палитру команд.

Я, Анастасия Майер, начинаю с этой связки любой инструмент для своего завода: сначала рабочее место, потом первая маленькая задача, потом всё остальное. Что собирать на ней дальше - сайт, дашборд, бота, - разбираем в направлении вайбкодинга. Если нужно настроить такие рабочие места на всю команду и не наступить на наши грабли, приходите на консультацию.

Где в команде место человеку, который работает с нейросетями, я разобрала в статье про ИИ-специалиста для контент-завода, а какие задачи в моём стеке достаются Claude - в статье про нейросети для создания контента. Свежие находки по Claude Code выкладываю в Telegram-канале, а свои настройки и ошибки можно принести в клуб Майер - разберём вместе.

Источники

• Claude Code в VS Code - требования, установка расширения, панель, вход, Disable Login Prompt, сторонние провайдеры, частые проблемы и сочетания клавиш.
• Подключение Claude Code к шлюзу - переменные адреса и ключа, блок env в settings.json, claudeCode.environmentVariables, проверка через /status.
• Установка Claude Code - системные требования, команды установки, npm, предупреждение про sudo.
• Официальный сайт VS Code - загрузка редактора для macOS и Windows.
• Собственная практика: настройка рабочих мест команды с подключением Claude Code через российский API-сервис.