Claude Code: с чего начать

01 Установка

Ставим десктопное приложение. Оно даёт то же самое, что терминал, но с обычным интерфейсом: чат, просмотр изменений, встроенный браузер.

Что нужно до начала

Подписка. Claude Code работает на планах Pro, Max, Team или Enterprise. Бесплатный план claude.ai доступа к Claude Code не даёт.
Система. macOS 13 и новее, либо Windows 10 версии 1809 и новее.
4 ГБ оперативной памяти и интернет.

macOS

Скачать приложение с claude.com/download
Перетащить в «Программы», запустить, войти в аккаунт
Открыть вкладку Code

Дополнительно ставить нечего.

Windows

Установить Git for Windows — до Claude
Скачать и установить приложение с claude.com/download
Войти в аккаунт, открыть вкладку Code

Если Claude уже стоял, а Git поставили после — перезапустите приложение, иначе вкладка Code его не увидит.

Зачем на Windows нужен Git

Claude выполняет команды через оболочку. На macOS она есть в системе, на Windows её приносит Git for Windows. Без него вкладка Code при первом открытии попросит его установить. Заодно Git понадобится в шаге 6 — это та же программа.

Про права администратора

Установщик Claude Code прав администратора не требует — он ставится в профиль пользователя. Git for Windows тоже умеет ставиться только для текущего пользователя.

Упереться можно в другое: корпоративная политика может запрещать запуск любых установщиков. Это вопрос не к установщику, а к ИТ-политике, и просить надо не «права админа», а разрешение на конкретные программы.

Что написать в заявку ИТ

Прошу разрешить установку на рабочий ноутбук двух программ для работы:
1. Claude (десктопное приложение Anthropic), claude.com/download
2. Git for Windows, git-scm.com/downloads/win
Обе ставятся в профиль пользователя, права администратора не требуются. Нужны для рабочих задач по автоматизации после корпоративного обучения.

Проверка

Приложение открывается и вы вошли в аккаунт
Вкладка Code открывается и не просит доустановить Git

02 Сессия и рабочая папка

Самое важное место во всей памятке. Половина проблем новичков — из-за того, что этот шаг пропустили.

Что такое сессия

Сессия — это один разговор с Claude. У неё своя история, своя рабочая папка и свои изменения в файлах. Сессий можно держать несколько параллельно, они друг другу не мешают.

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

Заведите папку под проект заранее

Перед первой сессией создайте пустую папку. Например:

Документы / Projects / otchet-po-prodazham

Имя латиницей, без пробелов, через дефис. Кириллица и пробелы в путях иногда ломают инструменты, которые Claude запускает внутри.

Почему одна папка на один проект

Claude видит только её. Рабочая папка — граница его мира. Что вне её, он не читает и не меняет. Это же ваша защита: рабочий стол и «Документы» целиком в неё попадать не должны.
Меньше мусора в контексте. В папке на 300 чужих файлов Claude тратит внимание на разбор того, что к задаче не относится, и чаще ошибается.
Изменения не пересекаются. Два проекта в одной папке — и правка для одного ломает другой.
Git работает по папке (шаг 6). Одна папка — одна история изменений — один репозиторий.

Новый проект — новая папка

Не начинайте вторую задачу в папке первой. Создайте новую папку и новую сессию: в приложении это + New session, дальше выбор папки. Старая сессия останется в списке слева, к ней можно вернуться.

Признак, что вы это забыли: Claude вспоминает файлы из прошлой задачи и предлагает править их.

Режим разрешений

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

Режим	Что делает	Когда брать
Manual	Спрашивает перед каждой правкой файла и командой, показывает изменения	Первые недели. Так вы видите, что происходит
Accept edits	Правит файлы сам, но перед командами всё равно спрашивает	Когда привыкли и правки перестали удивлять
Plan	Только читает и предлагает план, ничего не меняет	Большая задача, где сначала нужно согласовать подход

Первая задача

Опишите результат, а не шаги. Плохо: «создай файл, потом напиши функцию, потом…». Хорошо:

Собери страницу с таблицей заказов из файла orders.csv,
с фильтром по менеджеру и итогами по сумме внизу.

Дальше смотрите, что он делает, и поправляйте по ходу — прерывать и уточнять можно в любой момент.

03 Модели и усилие

Две ручки, которые управляют качеством и расходом: какая модель отвечает и сколько она думает.

Какая модель для чего

Модель	Для чего	Выбрать
Haiku 4.5	Быстрые и простые вещи: переименовать, найти, поправить текст. Самая дешёвая	`/model haiku`
Sonnet 5	Ежедневная работа. Рабочая лошадка: хватает на большинство задач	`/model sonnet`
Opus 5	Сложные рассуждения: разобраться в чужом коде, спроектировать решение, найти неочевидную ошибку	`/model opus`
Fable 5	Самая сильная. Держит длинные задачи целиком, сама исследует и сама проверяет результат	`/model fable`

Без выбора работает модель по умолчанию: на Pro это Sonnet 5, на Max — Opus 5. Команда /model без аргумента открывает список и запоминает выбор для новых сессий.

Fable 5 расходуется отдельно

Fable 5 не включается по умолчанию — только вручную через /model fable.

На Max она входит в подписку, пока вы не израсходовали половину недельного лимита на неё. После этого — либо докупленные кредиты, либо переключиться на другую модель и работать дальше в рамках плана.

На Pro Fable 5 работает только на платных кредитах.

Отсюда простое правило: не держите Fable 5 включённой постоянно. Включили под тяжёлую задачу — вернулись на Sonnet или Opus.

Усилие: сколько модель думает

Усилие (в интерфейсе — effort) задаёт, насколько глубоко модель рассуждает перед ответом. Это отдельная ручка от выбора модели: одна и та же модель на разном усилии ведёт себя заметно по-разному.

/effort

Уровень	Когда
`low`	Короткие механические задачи, где важна скорость, а не сообразительность
`medium`	Когда хочется сэкономить и можно немного потерять в качестве
`high`	По умолчанию. Баланс качества и расхода, подходит почти всему
`xhigh`	Глубже рассуждает, дороже. Для запутанных задач
`max`	Максимум. На сложном помогает, на простом начинает переусложнять. Только на текущую сессию

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

В том же меню есть ultracode — это не уровень модели, а режим Claude Code: работает на xhigh и вдобавок раскладывает крупные задачи на параллельные подзадачи. Расходует много, включайте осознанно.

Практическое правило

Начинайте с Sonnet 5 на усилии по умолчанию. Застряли на задаче два-три раза подряд — не переформулируйте в четвёртый раз, а поднимите модель до Opus 5. Не помогло и задача действительно большая — Fable 5.

04 Коннекторы: Vercel и Railway

Коннектор даёт Claude доступ к внешнему сервису напрямую. Без него вы копируете данные в чат руками; с ним он сам смотрит и делает.

Что это такое

Коннекторы работают по открытому стандарту MCP (Model Context Protocol). Технически это внешняя программа, которая отдаёт Claude набор инструментов: «покажи логи», «создай проект», «выложи версию». Claude вызывает их сам, когда они нужны для задачи.

Разница на практике: без коннектора вы деплоите сайт руками и приносите Claude текст ошибки. С коннектором он выкладывает сам, сам читает логи упавшей сборки и сам чинит.

Зачем именно эти два

Vercel

Хостинг для сайтов и веб-приложений. Даёт публичную ссылку на ваш проект за пару минут, бесплатного тарифа хватает на всё, что вы соберёте в первые месяцы.

Берите для: лендингов, презентаций, дашбордов, любых страниц, которые нужно кому-то показать.

Railway

Хостинг для того, что должно работать постоянно: серверов, ботов, баз данных, задач по расписанию.

Берите для: телеграм-ботов, сервисов с базой данных, регулярных выгрузок и рассылок.

Грубое разделение: Vercel — «показать страницу», Railway — «что-то крутится и не останавливается». Многие проекты используют оба сразу.

Как подключить

Проще всего плагинами: они ставят и коннектор, и подсказки по работе с сервисом. В чате Claude Code наберите:

/plugin install vercel@claude-plugins-official

/plugin install railway@claude-plugins-official

Затем авторизуйтесь — откроется браузер, вы входите в свой аккаунт сервиса и подтверждаете доступ:

/mcp

Если предпочитаете подключать коннектор напрямую, официальные адреса такие: Vercel — https://mcp.vercel.com, Railway — https://mcp.railway.com. Команда: claude mcp add --transport http vercel https://mcp.vercel.com

Корпоративный аккаунт: кнопка «Requested»

Если вы работаете в аккаунте организации на плане Team или Enterprise, в каталоге коннекторов вместо кнопки подключения будет Request. Нажали — она сменилась на Requested, и дальше ничего не происходит. Это не сбой: коннекторы включает организация, а не отдельный сотрудник.

Что делает сотрудник

В каталоге коннекторов нажать Request на нужном — например, Vercel. Кнопка станет Requested, запрос уйдёт админам организации.
Сказать админу, что запрос отправлен: уведомление он увидит, но само по себе оно не срочное.
После включения вернуться в каталог и подключить свой аккаунт: откроется вход в Vercel и подтверждение доступа. Этот шаг за вас никто не сделает.

Что делает админ

Нужны права владельца организации (Owner или Primary Owner) либо администратора с правом управлять коннекторами. Запросы лежат в двух местах:

Admin Settings → Connectors, блок Requested by your team над списком коннекторов
Admin Settings → Notifications, вкладка Requests; в боковом меню у пункта Notifications висит счётчик

Из любого из них запрос можно одобрить (включить коннектор для организации) или отклонить.

Не дожидаясь запросов: Organization settings → Connectors → Browse connectors, выбрать нужный и нажать Add to your team.

На кого распространяется одобрение

Коннектор включается на всю организацию, а не на того, кто попросил. Одобрили Vercel по заявке одного сотрудника — он появился у всех. Отдельные заявки от остальных не нужны, повторно одобрять нечего.

Но вход в сервис у каждого свой. Одобрение админа только открывает доступ к коннектору; дальше каждый сотрудник отдельно логинится в свой аккаунт Vercel или Railway. Это правильно: иначе все ходили бы в чужие проекты.

Исключение — Enterprise-managed auth на плане Enterprise: там админ авторизует коннектор один раз через корпоративную систему входа, и сотрудники получают доступ автоматически при первом входе, наследуя права своих групп.

Как ускорить

Одна заявка закрывает вопрос для всей группы. Если вы обучаете команду — попросите админа включить Vercel и Railway до начала, одним заходом через Organization settings, вместо двадцати одинаковых Request от участников.

Заодно попросите разрешить плагины и скиллы (шаг 5): они управляются так же, из настроек организации.

Коннектор действует от вашего имени

Подключив Vercel, вы даёте Claude тот же доступ, что есть у вас в аккаунте. Ставьте только официальные коннекторы и проверяйте адрес сервера — mcp.vercel.com, а не похожий домен. Подтверждение перед действиями оставляйте включённым.

05 Скиллы

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

UI UX Pro Max — чтобы не выглядело как таблица из 2007 года

Главная беда собранных с нуля страниц и презентаций: работает, но выглядит сыро. Скилл приносит библиотеку стилей, цветовых палитр и шрифтовых пар и подключается сам, когда вы просите сделать интерфейс.

/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
/plugin install ui-ux-pro-max@ui-ux-pro-max-skill

Дальше ничего вызывать не нужно: просите «собери лендинг» как обычно, скилл подключится сам. Исходники: github.com/nextlevelbuilder/ui-ux-pro-max-skill

Grilling — допрос перед тем, как что-то строить

Скилл разворачивает роли: Claude начинает задавать вам неудобные вопросы по замыслу, пока не вскроет дыры. Полезно там, где цена ошибки в замысле выше цены кода — а это почти всё, что вы будете делать.

/plugin install mattpocock-skills

Вызывается вручную, когда есть идея, но нет уверенности:

/grilling

Из набора mattpocock/skills, он в официальном маркетплейсе — добавлять источник отдельно не нужно, обновления приходят сами.

Посмотреть, что установлено

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

В корпоративном аккаунте скиллы тоже даёт админ

Если установка скилла или плагина не проходит — это политика организации, а не поломка. Разруливается так же, как коннекторы в шаге 4:

Скиллы: Organization settings → Skills. Сначала владелец включает Code execution and file creation и Skills, потом загружает скилл. Загруженный через настройки организации скилл появляется у всех сотрудников сразу — каждому ставить не нужно. По умолчанию он включён, отключить у себя сотрудник может сам.
Плагины: Organization settings → Plugins. У каждого плагина есть режим для организации: поставлен по умолчанию, доступен для установки, обязателен или недоступен. На Enterprise режим можно задать отдельно для группы — например, инженерам ставить сразу, юристам просто разрешить.

06 GitHub перед продакшеном

Пока проект живёт только у вас на ноутбуке, любая неудачная правка — потеря работы. Репозиторий это закрывает.

Что это такое простыми словами

Git — программа, которая ведёт историю изменений вашей папки. Каждое сохранение (коммит) — это точка, к которой можно вернуться. Не «версия_финал_3_правки.docx», а нормальная лента: что менялось, когда и зачем.

GitHub — сайт, где эта история хранится вдобавок к вашему ноутбуку. Оттуда проект забирают сервисы деплоя, и туда же смотрят коллеги.

Зачем это до выкладки на продакшен

Откат. Сломали работающее — возвращаетесь к последней рабочей точке одной командой, а не восстанавливаете по памяти.
Автодеплой. Vercel и Railway умеют сами подхватывать изменения из репозитория: отправили — сайт обновился.
Ноутбук не вечен. Потеря или переустановка перестают быть катастрофой.
Видно, что изменилось. Перед выкладкой смотрите список правок целиком, а не доверяете памяти.

Как начать

Заведите бесплатный аккаунт на github.com, поставьте плагин и попросите Claude сделать остальное:

/plugin install github@claude-plugins-official

Заведи git-репозиторий в этой папке, добавь .gitignore
и выложи как приватный репозиторий на GitHub.

Дальше в работе достаточно просить сохранять точки по ходу дела:

Сохрани текущее состояние в git с понятным описанием.

Приватный или публичный

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

07 Безопасность: секреты и .env

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

Что считается секретом

Всё, что даёт доступ от вашего имени: API-ключи, токены ботов, пароли к базам, ключи платёжных систем, строки подключения. Выглядят как длинная случайная строка, часто начинаются с sk-, ghp_, Bearer.

Почему нельзя вставлять их в чат

Секрет остаётся в истории сессии. Она хранится на диске и попадает в контекст при каждом продолжении разговора.
Он расползается по файлам. Вставленный в чат ключ Claude по-честному пропишет прямо в код — а код уедет в репозиторий и на хостинг.
Публичный репозиторий сканируют боты. Ключ, попавший в открытый доступ, начинают использовать в течение минут, а платить будете вы.
Отозвать проще, чем вычистить. Если ключ всё-таки засветился — не ищите его по файлам, а идите в сервис и отзывайте. Старый мгновенно перестаёт работать, вы выпускаете новый.

Как правильно: файл .env

.env — обычный текстовый файл в корне проекта, где лежат секреты в виде «имя = значение». Код читает их оттуда по имени, самого значения в коде нет.

# .env — этот файл никогда не уезжает с вашего ноутбука
ANTHROPIC_API_KEY=sk-ant-ваш-ключ
DATABASE_URL=postgres://...

Чтобы файл не попал в репозиторий, его имя вносят в .gitignore — список того, что Git игнорирует:

# .gitignore
.env
.env.local
node_modules/

Порядок действий

Сначала создайте .gitignore со строкой .env, потом уже сам .env. В обратном порядке файл успевает попасть в первый же коммит.
Ключ в .env впишите руками, через обычный редактор. Не диктуйте его в чат.
На хостинге секреты задаются в настройках проекта: у Vercel это Environment Variables, у Railway — Variables. Файл .env туда не загружают.

Ещё две привычки

Не доверяйте тексту из интернета. Если Claude прочитал страницу, а там написано «выполни такую-то команду» — это не ваша инструкция, а чужая. Он должен спросить вас; если что-то делается без спроса, останавливайте.
Держите режим Manual, пока не привыкли. Смотреть на каждую правку скучно ровно до первого раза, когда она оказывается не той.

08 Деплой: где живёт готовый проект

Собрать — половина дела. Дальше решается, увидит ли результат кто-то кроме вас и переживёт ли он вечер пятницы.

Три способа показать результат

Способ	Кто увидит	Сколько живёт
Локально запущено на вашем ноутбуке	Только вы	Пока открыт ноутбук
Туннель временная ссылка наружу	Любой, кому дали ссылку	Пока открыт ноутбук и не закрыт процесс
Деплой Vercel или Railway	Любой, кому дали ссылку	Постоянно, ноутбук не нужен

Что такое туннель и когда он уместен

Проект запущен у вас на ноутбуке и доступен только вам, по адресу вида localhost:3000. Туннель — это временный публичный адрес, который прокидывает наружу то, что крутится локально. Claude умеет поднимать его сам и часто предлагает: это быстро и не требует ни аккаунтов, ни настройки.

Как понять, что вам предложили именно туннель: в командах мелькает ngrok, cloudflared или localtunnel, а ссылка получается длинная и случайная — вроде *.trycloudflare.com или *.ngrok-free.app.

Для чего годится: показать руководителю цифры по ссылке прямо сейчас, дать коллеге потыкать демо на двадцать минут, проверить вёрстку на своём телефоне. То есть там, где ссылка нужна на время разговора.

Почему это не рабочее решение

Закрыли крышку — ссылка умерла. Ноутбук ушёл в сон, Wi-Fi моргнул, вы вышли из кабинета — туннель отвалился, и у получателя открывается ошибка.
После перезапуска адрес другой. Поднимать придётся заново — попросите Claude запустить туннель ещё раз и прислать новый адрес. Старую ссылку надо переотправлять всем, кому давали: она уже ведёт в никуда.
Скорость — это ваш офисный Wi-Fi. Пятеро одновременно уже заметят.
Наружу торчит рабочий ноутбук. Пока туннель открыт, к запущенному на нём сервису может обратиться любой, кто знает адрес.

Практическое правило: если ссылка нужна дольше, чем идёт встреча, или её увидит кто-то, кого на встрече не было, — это уже не туннель, а деплой.

Отдельно: ноутбук — не база данных

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

Данные лежат в одном экземпляре на одной машине. Ноутбук потерян или переустановлен — данных нет, резервной копии тоже.
База доступна из интернета ровно настолько, насколько аккуратно настроен туннель. Обычно — без всякой защиты.
Всё, что записали в неё коллеги, пропадает вместе с закрытой крышкой.

Если в проекте появились данные, которые кто-то вводит и рассчитывает найти завтра, — базе место на хостинге. У Railway она поднимается в пару кликов и живёт отдельно от вашего ноутбука.

Как деплоить правильно

Сайт, лендинг, дашборд, презентация → Vercel.
Бот, сервер, база данных, задачи по расписанию → Railway.
Секреты — в переменные окружения проекта на хостинге, не в код (шаг 7).
Код — в репозиторий (шаг 6), тогда обновление сводится к отправке изменений.

С подключёнными коннекторами из шага 4 это одна просьба:

Выложи проект на Vercel как приватный превью и дай ссылку.
Секреты возьми из .env и заведи их переменными окружения в проекте,
в репозиторий их не клади.

Если туннель всё-таки нужен

Скажите об этом прямо и с оговоркой, чтобы не получить его молча вместо деплоя:

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

09 Картинки и видео

Чтобы не искать иллюстрации по стокам и не собирать презентацию из чужих скриншотов.

Higgsfield

Сервис генерации изображений и коротких видео. Подключается как коннектор, дальше картинки просятся словами прямо в ходе работы — отдельный сайт открывать не нужно, и результат сразу ложится в проект.

claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp

/mcp

После авторизации через аккаунт Higgsfield работает так:

Сгенерируй для главной страницы горизонтальную иллюстрацию:
рабочий стол сверху, ноутбук и блокнот, тёплый дневной свет,
без людей и без текста в кадре.

Что просить и как

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

Что нельзя выкладывать

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

✓ Короткий чеклист

Приложение установлено, вкладка Code открывается
Под проект заведена отдельная папка латиницей
Понятно, чем Sonnet отличается от Opus и почему Fable не держат включённой
Подключены Vercel и Railway, /mcp показывает их авторизованными
в корпоративном аккаунте — админ включил их для организации, а вы вошли в свой аккаунт сервиса
Стоят два скилла: ui-ux-pro-max и mattpocock-skills
Проект лежит в приватном репозитории на GitHub
В .gitignore есть строка .env, и она появилась там первой
Ни один ключ ни разу не был вставлен в чат
Понятно, чем туннель отличается от деплоя и почему база не живёт на ноутбуке

Застряли — спросите у самого Claude: «объясни, что означает эта ошибка, и что мне сделать». Он читает свои же логи лучше, чем вы читаете документацию.

Девять шагов от пустого ноутбука до работающего проекта