От нуля
до коммита.

§ 00TL;DR — что должно быть в конце

• Аккаунт на GitHub + Git настроен локально (имя, email, SSH-ключ)
• Установлен Cursor
• Установлено расширение Claude Code внутри Cursor и залогинены
• Команда работает в одном репозитории на GitHub
• Каждый участник клонировал репо, умеет делать pull / commit / push
• Договорились о ветках: main защищена, каждый работает в своей feature-ветке, мерж через Pull Request
• Проект задеплоен на Vercel (или Railway) — есть публичный URL для демо

Все галочки стоят — можно кодить.

§ 01Что куда устанавливается

§ 02GitHub + Git — база

1.1 Создать аккаунт GitHub

1. Открой github.com/signup
2. Используй рабочую/постоянную почту — потом к ней привязываются коммиты
3. Выбери бесплатный план

1.2 Установить Git

git --version
# Если выдаст версию — Git уже стоит.
# Если попросит установить — соглашайся.
# Альтернатива через Homebrew:
brew install git

1.3 Настроить Git (один раз на машине)

В терминале (Mac: Terminal, Windows: Git Bash):

git config --global user.name "Ivan Petrov"
git config --global user.email "ivan@example.com"   # та же почта, что в GitHub
git config --global init.defaultBranch main

1.4 SSH-ключ и привязка к GitHub

Чтобы не вводить пароль при каждом push.

ssh-keygen -t ed25519 -C "ivan@example.com"
# Нажимай Enter на все вопросы (без пароля для скорости)

Скопировать публичный ключ:

pbcopy < ~/.ssh/id_ed25519.pub

cat ~/.ssh/id_ed25519.pub | clip

Проверка:

ssh -T git@github.com
# Должно вывести: "Hi <твой логин>! You've successfully authenticated..."

§ 03Установка Cursor

1. Открой cursor.com → Download
2. Установи как обычное приложение
3. При первом запуске: импортируй настройки VS Code, если предложит (если работал в VS Code) — иначе skip
4. Залогинься (можно через GitHub аккаунт)

§ 04Claude Code внутри Cursor

3.1 Установка расширения

После установки слева в сайдбаре появится иконка Claude.

3.2 Логин в Claude Code

1. Кликни на иконку Claude в сайдбаре
2. Расширение проведёт через авторизацию — нужен аккаунт Anthropic
   • Если у команды есть Claude Pro / Max — логинься этим аккаунтом
   • Если нет — потребуется API-ключ или подписка
3. После логина увидишь чат-панель

3.3 Как работают два AI в одном окне

3.4 Если расширение не цепляется к Cursor (Mac)

Известная проблема. Воркэраунд:

cursor --install-extension ~/.claude/local/node_modules/@anthropic-ai/claude-code/vendor/claude-code.vsix

Если /doctor в Claude Code говорит про global installation — выполни /migrate-installer.

§ 05Локальный проект — два сценария

Сценарий А: проект с нуля

Делает капитан команды (один человек).

1. На GitHub: правый верх + → New repository
2. Repository name: team-name-hackathon
3. Visibility: Private
4. Галочка Add a README file
5. Create repository

Клонировать к себе:

# В папке где хочешь хранить проекты (например ~/projects)
cd ~/projects
git clone git@github.com:<твой-логин>/team-name-hackathon.git
cd team-name-hackathon

Открыть в Cursor:

cursor .

Или: Cursor → File → Open Folder → выбрать папку.

Сценарий Б: уже есть локальный код

cd /путь/к/твоему/проекту
git init
git add .
git commit -m "initial commit"

На GitHub создай пустой репо (БЕЗ README — чтобы не было конфликта), потом:

git remote add origin git@github.com:<логин>/<репо>.git
git branch -M main
git push -u origin main

§ 06Командная работа — самое важное

Эта часть — где обычно ломаются хакатоны. Прочитайте все.

5.1 Базовая модель: один репо, разные ветки

5.2 Капитан добавляет команду

GitHub → ваш репо → Settings → Collaborators → Add people → введи логины членов команды. Они получат приглашение на почту, должны принять.

5.3 Каждый клонирует репо

cd ~/projects
git clone git@github.com:<капитан>/team-name-hackathon.git
cd team-name-hackathon
cursor .

5.4 Рабочий цикл — заучить наизусть

Каждый раз перед началом работы

git checkout main           # переключиться на main
git pull origin main        # подтянуть последние изменения
git checkout -b feature/моя-фича   # создать свою ветку

В процессе работы (часто, маленькими порциями)

git add .
git commit -m "добавил форму логина"
git push origin feature/моя-фича

Когда фича готова

После того как чужой PR замержили в main

git checkout main
git pull origin main        # подтянуть мерж к себе

5.5 Конфликты — что делать когда красное

Ты и коллега изменили один и тот же файл. GitHub ругается.

git checkout feature/моя-фича
git pull origin main          # подтянуть свежий main в свою ветку
# Если есть конфликты — Cursor покажет метки в файлах:
# <<<<<<< HEAD
# твой код
# =======
# код из main
# >>>>>>> main

В Cursor можешь нажать Accept Current / Accept Incoming / Accept Both прямо в файле, или попроси Claude Code разрулить:

После разрешения:

git add .
git commit -m "merge main into feature/моя-фича"
git push

5.6 Минимум договорённостей на старте

Сядьте на 5 минут и договоритесь:

1. Кто капитан репозитория (создаёт, мержит PR)
2. Формат коммита — самое простое: git commit -m "что сделано", главное единообразно
3. Имена веток — feature/что-делаю, fix/что-чиню
4. Защита main — Settings → Branches → Add rule → main → ✅ Require a pull request before merging. Спасает от случайного push в main.
5. Куда складывать секреты — никогда в код. В .env + в .gitignore. Случайно запушил — токен сразу ротировать.

5.7 .gitignore — поставь сразу

В корне репо создай файл .gitignore:

node_modules/
.env
.env.local
.DS_Store
*.log
dist/
build/
.venv/
__pycache__/
.cursor/
.claude/

Закоммить:

git add .gitignore
git commit -m "add .gitignore"
git push

§ 07Шпаргалка по Git

§ 08Типовые косяки на хакатоне

§ 09Рабочий поток с Claude Code

Не используй Claude Code как автокомплит — для этого Cursor. Claude Code — для законченных задач.

Хорошие промпты

• «Сделай страницу логина с формой email/password, валидацией и обработкой ошибок. Используй существующий стиль из src/components/.»
• «Запусти тесты, посмотри что упало, почини.»
• «Прочитай README и предложи план MVP на 4 часа.»

§ 10Деплой — показать рабочий проект на домене

Дефолтный выбор для хакатона — Vercel. От пуша до публичного URL вида your-app.vercel.app проходит ~5 минут. Альтернативы — ниже.

9.1 Когда что выбирать

9.2 Деплой на Vercel — 5 минут от пуша до домена

9.3 Что важно после первого деплоя

Автодеплой работает сам

Каждый git push в main → новый продакшен-деплой. Каждый PR → отдельный preview-URL вида your-project-git-feature-x.vercel.app. Это магия — используйте, чтобы показывать работающую фичу до мержа.

Кастомное имя проекта

Project Settings → General → Project Name. URL станет chosen-name.vercel.app. Действует имя в течение пары минут.

Переменные окружения и секреты

Project Settings → Environment Variables. Добавь все ключи (OpenAI API, Anthropic API, Supabase и т.п.) с областью Production / Preview / Development. После добавления передеплой — Deployments → последний деплой → ... → Redeploy.

9.4 Командная работа на Vercel

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

1. Создайте Vercel Team — справа сверху → Create Team. Hobby-тариф для команды бесплатный.
2. Перенесите проект в команду: Project Settings → Advanced → Transfer Project
3. Пригласите участников: Team Settings → Members → Invite

9.5 Деплой backend / нестандартного стека на Railway

Если у вас Python (FastAPI, Flask, Django), Go, Ruby или нужна Postgres:

9.6 Чеклист перед демо

• Открой публичный URL в режиме инкогнито — должно работать
• Все ENV-переменные на проде установлены
• Проверь главный user-flow от начала до конца
• URL запиши в README репозитория — судьи найдут
• На всякий случай — скриншоты ключевых экранов, если упадёт прод во время демо