Установка и настройка

Модуль: 2 — Быстрый старт | Время: ~20 мин теории + 30 мин практики

Суть урока

Мастерская мастера должна быть правильно оборудована до начала работы. Этот урок — оборудование твоей мастерской: редактор кода, подключение агента, правильная подписка. Один раз настроил — дальше работаешь.

Ключевые концепции

VS Code (Вэ-эС Код — популярный редактор кода от Microsoft) — почему именно этот редактор и как он устроен
Claude Code как расширение внутри VS Code
Выбор подписки: что входит в Pro и когда нужен Max
Структура рабочего пространства: папка = проект

Теория

VS Code: бесплатная IDE (ай-ди-и, Integrated Development Environment — среда разработки) мирового уровня

🎨 Образ: VS Code — как верстак у столяра. Это не сам инструмент, это рабочее место где лежат все инструменты под рукой: пилы (терминал — программа для работы с командной строкой), линейки (поиск), хранилище чертежей (файловый проводник). Claude Code — это умный помощник которого ты поставил рядом с верстаком.

Visual Studio Code — редактор кода от Microsoft. Бесплатный. Работает на Mac, Windows, Linux. Один из самых популярных редакторов кода в мире.

Почему VS Code, а не Cursor, Devin Desktop (так с июня 2026 называется бывший Windsurf) или другие AI-редакторы?

Бесплатный: нет дополнительных подписок за сам редактор
Стандарт: все примеры и туториалы написаны под VS Code
Расширяемый: Claude Code встраивается как расширение без потери функций
Стабильный: годами проверенный инструмент, не стартап который может закрыться

Скачать: code.visualstudio.com → кнопка Download для твоей ОС.

💡 Редактор не обязателен. На октябрь 2026 Claude Code работает не только в VS Code: есть терминал, расширения для VS Code, Cursor и JetBrains, приложение Claude для компьютера (вкладка Code, без терминала), браузер на claude.ai/code и телефон. Этот урок идёт через VS Code, потому что он наглядный для новичка. Про приложение без терминала — в уроке Claude Code Desktop.

Структура интерфейса VS Code

После установки ты увидишь несколько ключевых зон:

Боковая панель (слева):

Иконка листа бумаги — файловый проводник. Показывает все файлы открытой папки
Иконка поиска — поиск по всем файлам
Иконка пазла — расширения (здесь установишь Claude Code)
Иконка Git (гит — система контроля версий кода) — управление версиями (пригодится позже)

Главная область (центр): Редактор кода и файлов. Когда откроешь любой файл — он появится здесь.

Панель (снизу): Терминал — командная строка прямо внутри VS Code. Очень удобно: не нужно открывать отдельный терминал.

Панель Claude Code (справа): После установки расширения появится чат с агентом (агент — автономная программа-исполнитель). Здесь ты будешь давать задания Claude Code.

Установка Claude Code

Открой VS Code
Нажми иконку пазла на левой панели (Extensions) — или нажми Ctrl+Shift+X (Win) / Cmd+Shift+X (Mac)
В строке поиска введи: Claude Code
Найди расширение от Anthropic — иконка с лого Anthropic (нужен VS Code версии 1.94 или новее)
Нажми Install
После установки в левой панели появится новая иконка — кнопка Claude Code

Аутентификация: подключение к Claude

После первого открытия Claude Code попросит войти в аккаунт Anthropic.

Нажми Sign In
Откроется браузер с сайтом claude.ai
Войди в свой аккаунт (или создай новый)
Подтверди разрешение — Claude Code подключится к твоему аккаунту
Вернись в VS Code — агент готов к работе

Для входа нужен платный тариф Claude (Pro, Max, Team или Enterprise) либо аккаунт в Anthropic Console с оплатой по токенам. На бесплатном тарифе Claude Code недоступен. Напоминание: Россия и Беларусь отсутствуют в официальном списке стран, где работают сервисы Anthropic (подробности в уроке Твои первые 30 минут с AI).

Подписка: Pro vs Max — что выбрать

🎨 Образ: Pro vs Max — как выбирать между скутером и мотоциклом для работы курьером. На скутере можно доехать, но если ездишь с утра до вечера — мотоцикл удобнее. Если ты работаешь с агентом по несколько часов в день, лимиты Pro могут резать тебя в самый неподходящий момент.

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

План	Цена (на октябрь 2026)	Claude Code	Модели	Для кого
Free	$0	Нет	В чате на claude.ai	Попробовать обычный чат
Pro	$20/мес ($17 при оплате за год)	Да	Opus 5.5 по умолчанию, по выбору Sonnet 5.5 и Haiku 4.5	Обучение, эксперименты
Max 5x	от $100/мес	Да	Те же, лимиты в 5 раз больше, чем у Pro	Активная работа, первые проекты
Max 20x	$200/мес	Да	Те же, лимиты в 20 раз больше, чем у Pro	Несколько проектов каждый день
Team, Enterprise	см. страницу тарифов	Да	Те же	Команды и компании
Ключ Anthropic Console	оплата по токенам	Да	Любые из линейки	Разработчикам, без приложения для компьютера, облачных сессий, рутин и artifacts

Модель Fable 5.1 для самых сложных задач включается вручную командой /model fable; на подписках она может списываться из usage credits (Claude Code спросит согласия). Актуальный список моделей и цен: Актуальное сейчас и claude.com/pricing.

Рекомендация для этого курса:

Для прохождения уроков начни с Pro. Max имеет смысл, когда ты регулярно упираешься в лимиты и это мешает работе.

Честная оговорка: подписка — это расходы, а не гарантия возврата. Прежде чем платить больше, посмотри в /usage, сколько ты реально используешь.

Открытие проекта: папка = проект

🎨 Образ: Папка проекта для агента — как комната для работника. Он видит всё что в комнате, может работать со всем что там есть. За дверь не выходит (это безопасность). Не смешивай проекты в одной папке — это как поселить двух разных клиентов в одну комнату: хаос.

В Claude Code (и в VS Code в целом) одна папка = один проект. Агент работает в контексте (контекст — содержание разговора видимое AI) той папки, которую ты открыл.

Как открыть папку:

File → Open Folder (или Cmd+O на Mac)
Выбери папку где будет твой проект
VS Code откроет её как рабочее пространство

Почему это важно:

Агент видит все файлы в этой папке
Агент понимает структуру проекта
Агент не видит файлы за пределами папки (это хорошо — безопасность)
файл CLAUDE.md (узнаем в уроке CLAUDE.md: системный промпт проекта) лежит в корне этой папки

Совет по организации: Создай папку ~/Projects/ (или ~/Проекты/) и внутри неё делай отдельную папку на каждый проект. Не смешивай разные проекты в одной папке.

Пример структуры:

Код

~/Projects/
  ├── newsletter-automation/    ← один проект
  ├── lead-qualifier/           ← другой проект
  └── client-reporting/         ← ещё один

🎨 Образ: Первый разговор с агентом — как первый день нового сотрудника в офисе. Дай ему осмотреться: «посмотри что тут есть». Потом дай первое маленькое задание. Потом сложнее. Не бросай сразу с задачей «разберись с базой данных клиентов».

Первый разговор с агентом

После настройки открой панель Claude Code (иконка в левой панели или кнопка в нижней строке).

Ты увидишь поле ввода. Напиши что-нибудь простое:

Напиши в чат

Привет. Я только что открыл эту папку. Что ты видишь в ней?

Агент просмотрит содержимое папки и расскажет что там есть. Если папка пустая — скажет это.

Попробуй другой запрос:

Напиши в чат

Создай файл README.md с описанием того что это тестовый проект для обучения.

Агент создаст файл. Ты увидишь его в файловом проводнике слева.

Это твоё первое взаимодействие с агентом как с реальным инструментом.

Важные горячие клавиши (запомни с первого дня)

Действие	Mac	Windows
Открыть папку	Cmd+O	Ctrl+O
Открыть терминал	Ctrl+`	Ctrl+`
Найти файл	Cmd+P	Ctrl+P
Поиск по всем файлам	Cmd+Shift+F	Ctrl+Shift+F
Открыть Claude Code	Cmd+Shift+P → "Claude"	Ctrl+Shift+P → "Claude"

Практика

Задание: Установить VS Code + Claude Code и провести первый тест.

Шаг 1 — Установка (10 мин):

Скачай VS Code с code.visualstudio.com
Установи (стандартная установка, ничего не менять)
Установи расширение Claude Code из магазина расширений

Шаг 2 — Настройка аккаунта (5 мин):

Войди в Claude Code через свой аккаунт Anthropic
Убедись что агент отвечает (напиши «Привет»)

Шаг 3 — Первый проект (15 мин):

Создай папку my-first-agent в удобном месте
Открой её в VS Code через File → Open Folder
Дай агенту три задания по очереди:
- «Создай файл hello.md с заголовком «Мой первый агентный проект» и тремя пунктами о том чему я хочу научиться»
- «Создай папку docs и перемести hello.md туда»
- «Что сейчас находится в этой папке?»
Посмотри в файловый проводник — убедись что всё сделано правильно

Частые ошибки

❌ Ошибка: Открывать домашнюю папку целиком (~/) как проект в VS Code. ✅ Правильно: Одна папка = один проект. Создай отдельную папку для каждого проекта. Агент видит все файлы в открытой папке — если открыть корень, он потеряется в тысячах файлов.

❌ Ошибка: Брать самый дорогой тариф «на вырост», не проверив, хватает ли Pro. ✅ Правильно: Начни с Pro. Если регулярно упираешься в лимиты при работе по нескольку часов в день — тогда смотри Max. Лимиты зависят от модели и нагрузки, их удобно сверять командой /usage.

❌ Ошибка: Не использовать терминал внутри VS Code (открывать отдельный терминал). ✅ Правильно: Встроенный терминал (Ctrl+`) работает в контексте открытой папки. Claude Code тоже работает в этом контексте. Всё в одном окне = меньше путаницы.

Альтернативный способ установки: через терминал (CLI — интерфейс командной строки)

Claude Code также можно установить как CLI-инструмент прямо в терминале, без VS Code. На октябрь 2026 основной способ — нативный установщик, Node.js для него не нужен:

bash

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

powershell

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

После установки зайди в папку проекта и запусти команду claude. Есть и другие способы: Homebrew (brew install --cask claude-code), WinGet (winget install Anthropic.ClaudeCode), а также npm (npm install -g @anthropic-ai/claude-code, нужен Node.js 22+). Нативный установщик обновляется сам, Homebrew и WinGet нужно обновлять вручную. Требования к компьютеру: macOS 13+, Windows 10 версии 1809+, 4 ГБ памяти.

Подробная инструкция: code.claude.com/docs/en/setup

Этот способ подходит для тех кто предпочитает работать в терминале. Для новичков рекомендуется VS Code или приложение для компьютера — они визуальнее.

Инструменты и ресурсы

VS Code — официальный сайт для скачивания
Claude.ai — создание аккаунта Anthropic (нужен до аутентификации в расширении)
VS Code Marketplace — маркетплейс расширений (поиск: Claude Code)
Anthropic Pricing — сравнение планов подписки
Claude Code — установка — официальный гайд по установке
Claude Code — Getting Started — быстрый старт
Claude Code GitHub — issues (сообщения об ошибках), список изменений (CHANGELOG), плагины и примеры; исходного кода самого CLI в этом репозитории нет
Node.js — нужен только для установки через npm (версия 22+)

→ См. урок Основы промптинга — как правильно давать задания агенту → См. урок CLAUDE.md: системный промпт проекта — первый файл который стоит создать → См. урок Тарифы и уровни доступа — подробная карта тарифов

Ключевые выводы

VS Code — бесплатная, стабильная IDE. Одна папка = один проект. Агент работает в контексте открытой папки.

Начни с Pro. Max нужен, когда ты регулярно упираешься в лимиты, а не «на всякий случай».

Первый разговор с агентом не требует кода — просто объясни что хочешь на русском языке.

Следующий урок

→ Claude Code Desktop — работа без терминала (или сразу → Основы промптинга: как давать задания агенту чтобы получать качественный результат)