Инструкция к воркшопу

Установка Claude Code

Пошаговое руководство для участников. Установка занимает 15–25 минут. Если хотите просто смотреть демонстрацию — ставить ничего не нужно.

Если вы из России — нужен VPN

Anthropic (компания, которая делает Claude) не обслуживает пользователей из России. Подключите надёжный VPN к Европе, США или Азии (кроме Китая) до регистрации и проверьте, что страна сменилась — мы покажем как.

Что такое Claude Code

Это инструмент от Anthropic, который позволяет общаться с ИИ-ассистентом так, чтобы он видел ваши файлы на компьютере, создавал новые и запускал команды. В отличие от чата на сайте, он работает прямо в вашей рабочей среде.

Использовать можно тремя способами на выбор — все три используют один аккаунт и одну подписку:

Способ A · Claude Desktop приложение — самый простой. Скачали, открыли вкладку Code, работаете. Рекомендую новичкам.
Способ B · Visual Studio Code — если уже работаете в редакторе кода.
Способ C · Терминал (CLI) — путь для продвинутых пользователей. Требует установки Node.js. На воркшопе я могу показать этот вариант — решу по ходу.

Что нужно перед началом

1. Подписка Claude

План	Цена	Что входит
Pro	$20 / мес	Достаточно для воркшопа. ~225 сообщений Sonnet за 5 часов
Max 5×	$100 / мес	В 5 раз больше лимитов
Max 20×	$200 / мес	В 20 раз больше лимитов

Купить: claude.ai/upgrade. Подписка работает и в чате на сайте, и в Claude Code.

2. VPN — если вы из России

Подойдёт любой надёжный VPN с подключением к Европе, США или Азии (кроме Китая). После подключения — обязательно проверьте страну (раздел ниже).

3. Голосовой ввод (опционально, но удобно)

На воркшопе я буду пользоваться голосом — это сильно ускоряет общение с Claude, когда нужно описать задачу подробно. Если хотите делать так же:

🎙 Wispr Flow — работает на Mac и Windows, 14 дней бесплатно (по моей реферальной ссылке). Удобный, запоминает стиль речи.
🎙 Spokenly — только для Mac, нативное приложение в стиле Apple.

🎙 Wispr Flow — работает на Windows и Mac, 14 дней бесплатно (по моей реферальной ссылке). Нажимаете горячую клавишу, говорите — текст вставляется в любое окно.

Альтернатива Spokenly работает только на macOS, поэтому для Windows не подходит.

Проверка вашей страны

Сделайте это до установки и перед каждым запуском Claude Code. Если VPN отключится — Claude перестанет отвечать.

Способ 1 · В браузере

Откройте whoer.net. Найдите строку «Страна». Если там Россия — включите VPN и обновите страницу. Должно отображаться, например, Нидерланды, Германия, США.

Способ 2 · В Terminal

Откройте Terminal: ⌘ + Пробел → наберите Terminal → Enter.
Вставьте команду и нажмите Enter:

curl ipinfo.io/country

В ответ должна прийти двухбуквенная страна: NL, DE, US, FR и т.п. Если пришло RU — включите VPN и попробуйте снова.

Способ 2 · В PowerShell

Откройте PowerShell: Win + X → Terminal (Windows 11) или Windows PowerShell (Windows 10).
Вставьте команду и нажмите Enter:

curl.exe ipinfo.io/country

Почему curl.exe, а не curl?

В PowerShell слово curl — это сокращение для другой команды (Invoke-WebRequest), которая ведёт себя иначе. Настоящий curl называется curl.exe и встроен в Windows 10/11.

Способ A Рекомендую

Claude Desktop приложение

Самый простой путь. Не требует Node.js, npm, командной строки и расширений — никаких технических зависимостей, кроме одной программы Git for Windows (см. шаг 3 ниже).

Скачать

Откройте claude.com/download и скачайте версию для macOS. Это .dmg файл.

Установить

Откройте скачанный .dmg.
Перетащите иконку Claude в папку Программы.
Запустите Claude из Launchpad.
Если macOS предупредит, что приложение скачано из интернета — нажмите Открыть.

Войти в аккаунт

В окне приложения войдите в свой Claude-аккаунт (тот, на котором подписка Pro / Max).

Открыть вкладку Code

В верхней части окна слева вы увидите три вкладки: Chat, Cowork, Code. Нажмите Code. Затем — New session в боковой панели.

Готово. Это и есть Claude Code в графическом виде.

Скачать Claude Desktop

Откройте claude.com/download и скачайте версию для Windows. Это .exe файл.

Если у вас Windows на ARM-процессоре (например, ноутбуки на Snapdragon) — на странице скачивания выберите версию ARM64.

Установить Claude Desktop

Запустите скачанный .exe.
Пройдите установщик с настройками по умолчанию.
Запустите Claude через меню Пуск.
Если Windows Defender SmartScreen предупредит — нажмите Подробнее → Выполнить в любом случае.

Установить Git for Windows (один раз)

При первом открытии вкладки Code Claude может запросить Git for Windows — это отдельная программа для отслеживания версий файлов, Claude Code использует её внутри.

Откройте git-scm.com/downloads/win.
Скачайте .exe (Standalone Installer 64-bit).
Запустите. Жмите Next на каждом шаге — настройки по умолчанию подходят.
Перезапустите Claude Desktop.

Это не Node.js — Git это совсем другая программа. Ставится один раз и забывается.

Войти в аккаунт

В окне приложения войдите в свой Claude-аккаунт (тот, на котором подписка Pro / Max).

Открыть вкладку Code

Готово. Это и есть Claude Code в графическом виде.

Способ B

Установка через Visual Studio Code

Если уже работаете в редакторе кода или хотите попробовать.

Установить VS Code

Откройте code.visualstudio.com.
Нажмите Download Mac Universal. Откройте .zip, перетащите иконку в папку Программы.
Нажмите Download for Windows. Запустите .exe, пройдите установщик с настройками по умолчанию.
Запустите Visual Studio Code.

Установить расширение Claude Code

В VS Code слева есть боковая панель. Найдите иконку Extensions (четыре квадратика).
В поиске введите Claude Code.
У расширения от Anthropic нажмите Install.

Войти в аккаунт

Cmd + Shift + P → введите Claude Code: Sign In → Enter. В браузере войдите в Claude.

Ctrl + Shift + P → введите Claude Code: Sign In → Enter. В браузере войдите в Claude.

Открыть рабочую папку

File → Open Folder → создайте папку workshop на рабочем столе, откройте её. Затем Cmd + Shift + P → Claude Code: Open Chat.

File → Open Folder → создайте папку workshop на рабочем столе, откройте её. Затем Ctrl + Shift + P → Claude Code: Open Chat.

Способ C

Установка через Terminal (для продвинутых)

Установка через PowerShell (для продвинутых)

Путь, по которому идут опытные разработчики. Требует знакомства с командной строкой. На воркшопе я могу его показать — но если для вас это новое, начинайте со способа A или B.

Терминология

Terminal — приложение на Mac, в которое вы вводите команды текстом, без мыши.
Node.js — программа, нужная, чтобы Claude Code мог запускаться через терминал.
npm — установщик программ, идёт вместе с Node.js.
Homebrew — необязательный инструмент. «Магазин» программ для Mac, который ставит их через одну команду. Если у вас его нет — не страшно, обойдёмся без него.

PowerShell — программа на Windows, в которую вы вводите команды текстом.
Windows Terminal — более современная версия (на Windows 11). Если установлена — лучше пользоваться ей.
Node.js — программа, нужная, чтобы Claude Code мог запускаться через PowerShell.
npm — установщик программ, идёт вместе с Node.js.

Открыть Terminal

⌘ + Пробел → Terminal → Enter.

Проверить Node.js

node --version

Если в ответ v18.x.x, v20.x.x или больше — переходите к шагу 4.
Если ошибка или command not found — шаг 3.

Установить Node.js

Откройте nodejs.org/ru.
Нажмите большую зелёную кнопку LTS.
Запустите .pkg, пройдите установщик.
Закройте Terminal и откройте заново.

Установить Claude Code

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

Если выдало ошибку про права (EACCES):

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

Запросит пароль от компьютера — это нормально.

Первый запуск

mkdir ~/workshop
cd ~/workshop
claude

В браузере — авторизация в Claude. Готово.

Открыть PowerShell

Win + X → Terminal (Windows 11) или Windows PowerShell (Windows 10).

Проверить Node.js

node --version

Если v18.x.x и выше — шаг 4.
Если ошибка «не является внутренней или внешней командой» — шаг 3.

Установить Node.js

Откройте nodejs.org/ru.
Нажмите LTS.
Запустите .msi, пройдите установщик с настройками по умолчанию.
Закройте PowerShell и откройте заново.

Разрешить запуск скриптов (один раз)

Без этого npm может выдать ошибку про execution policy.

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Спросит подтверждение — введите Y и Enter.

Установить Claude Code

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

Первый запуск

mkdir workshop
cd workshop
claude

В браузере — авторизация. Готово.

Команды, которые будем использовать

Внутри Claude Code (в любом из трёх способов).

Просто общение

Пишете задачу текстом → Enter. Или нажимаете горячую клавишу Wispr Flow / SpokenlyWispr Flow и диктуете.

Слэш-команды

Команда	Что делает
`/help`	Полный список команд
`/clear`	Очистить разговор, начать новый
`/exit`	Выйти из Claude Code (только в CLI)
`/permissions`	Настроить, что можно без вопроса
`/memory`	Долгосрочная память «как со мной работать»
`/init`	Создать `CLAUDE.md` — памятку для проекта
`/skills`	Список доступных скиллов

Полезные клавиши (в CLI)

Клавиша	Что делает
`Enter`	Отправить
`Shift + Enter`	Перенос строки
`Ctrl + C`	Прервать ответ
`↑` / `↓`	История

Что важно знать на старте

Claude часто спрашивает разрешение перед действиями с файлами — это нормально, жмите Yes. Когда устанете — настройте /permissions.

Чем подробнее задача — тем лучше результат. Контекст: что хотите, зачем, какие ограничения.

Установка плагина для воркшопа

На воркшопе мы будем использовать официальный плагин Feature Dev от Anthropic. Это «упакованный регламент», который ведёт Claude по семи фазам: уточняющие вопросы, архитектура, реализация, само-проверка кода. Без него повторить демонстрацию не получится.

Способ установки зависит от того, как вы запускаете Claude Code

В Claude Desktop приложении (Способ A) команда /plugin не работает — там плагины ставятся через UI приложения. В VS Code и терминале (Способы B и C) — через команды.

Способ A · В Claude Desktop приложении

Откройте plugin browser

В окне сессии Code нажмите кнопку + слева от поля ввода сообщения.
В появившемся меню выберите Plugins.
В подменю выберите Add plugin — откроется список доступных плагинов из официального маркетплейса.

Установите feature-dev

В списке плагинов найдите feature-dev, выберите его и нажмите установить. Подойдёт User scope — плагин будет работать во всех проектах.

Проверьте, что плагин появился

Снова нажмите + → Plugins — в списке установленных должен быть feature-dev. Также можно набрать в поле ввода /feature-dev — должна появиться подсказка с командой.

Способ B и C · В VS Code или TerminalPowerShell

Установите плагин

Откройте Claude Code и введите команду:

/plugin install feature-dev@claude-plugins-official

Альтернативно — наберите просто /plugin, откроется интерактивный браузер. В разделе Discover найдите feature-dev и установите.

Перезагрузите плагины

После установки выполните в том же окне:

/reload-plugins

Либо просто закройте и откройте Claude заново.

Проверьте, что плагин активен

/skills

В списке должен появиться feature-dev:feature-dev.

Что делает плагин

Запускается командой /feature-dev (или, если несколько одноимённых, /feature-dev:feature-dev). После запуска Claude переходит в режим ведения задачи:

Сам задаёт уточняющие вопросы по вашей идее
Предлагает архитектуру до того, как начать писать код
Делает само-проверку готового кода через специализированных под-агентов
Подводит итог сделанного

На воркшопе вы увидите всё это в действии.

Если что-то пошло не так

Проблема	Решение
Claude молчит / ошибка сети	Проверьте VPN: `curl ipinfo.io/country` не должно быть `RU`	Проверьте VPN: `curl.exe ipinfo.io/country` не должно быть `RU`
Приложение не запускается	Системные настройки → Конфиденциальность → разрешить запуск
`command not found: claude`	Закройте Terminal и откройте заново
`command not found: node`	Не установлен Node.js — шаг 3 способа C
`EACCES: permission denied`	`sudo npm install -g @anthropic-ai/claude-code`
Windows Defender блокирует Claude Desktop	Подробнее → Выполнить в любом случае
`claude` не является командой	Закройте PowerShell и откройте заново
`node` не является командой	Не установлен Node.js — шаг 3 способа C
Ошибка про execution policy	Команда из шага 4 способа C
Браузер не открылся на авторизации	Скопируйте ссылку из терминала вручную
«Лимит исчерпан»	Подождите час или обновите подписку
В VS Code нет Claude Code	Перезагрузите VS Code, расширение должно быть от Anthropic

Чек-лист готовности

К моменту воркшопа

VPN включен, страна не Россия (проверено) Подписка Claude Pro или Max активна Установлен один из способов: A (приложение), B (VS Code) или C (TerminalPowerShell) Хотя бы раз вошли в Claude и открыли вкладку Code или запустили claude Плагин feature-dev установлен (проверено через /skills) Опционально: установлен Wispr Flow или Spokenly для голосового ввода

Прогресс сохраняется в вашем браузере — отметки останутся при следующем визите.