Quickstart: от нуля до первого коммита за ~15 минут

Цель — до пятницы пройти этот путь один раз, чтобы старт не съел час. Если застряли — пишите в общий канал.

0. Что нужно (проверка)

Ноутбук.
VPN
Доступ к git.i-free.com.
Редактор: VS Code (рекомендуем), Cursor или Claude Code Desktop.
Аккаунт Claude для входа (будет)

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

Сейчас рекомендуется нативный установщик — Node.js не нужен.

macOS / Linux / WSL:

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

Windows (PowerShell):

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

Не хотите терминал — поставьте Claude Code Desktop или расширение Claude Code для VS Code.

Проверка:

claude --version

Должна показаться версия. (Альтернатива через npm: npm install -g @anthropic-ai/claude-code, нужен Node.js 18+.)

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

Запустите claude в терминале (или откройте приложение) и пройдите вход — одноразовый OAuth через ваш аккаунт Claude.

3. Завести проект

mkdir my-case && cd my-case
git init
claude

Внутри сразу положите .gitignore (туда .env, ключи, данные) и заготовку README.md — шаблоны у нас уже есть.

4. Первый промпт агенту

Не бросайте «сделай всё». Дайте контекст и задачу поменьше. Например:

«Это проект для хакатона. Стек — Python. Заведи структуру: src/, data/, README.md и .gitignore. В README добавь разделы: кейс, боль, что делает агент, как запустить, метрики.»

Просите план до кода и проверяйте, что предлагает агент, прежде чем соглашаться.

5. Первый коммит и push

git add .
git commit -m "init: структура проекта и README"

# подключаем ваш репозиторий на git.i-free.ru
git remote add origin <ссылка-на-ваш-репозиторий>
git push -u origin main

Дальше пушьте регулярно — это ваш бэкап.

Если совсем новичок в вайбкодинге

Любое видео по запросу «vscode claude code основы».
code.claude.com/docs/en/vs-code
thecode.media/claude-code-gajd

Три частые грабли

Агент выдумывает пути/API — просите подтверждать по реальным файлам, не верьте на слово.
Тянет лишнее — держите задачи мелкими, ревьюйте дифф перед коммитом.
Норовит закоммитить секреты — .gitignore с самого начала, .env в чат и в git не отправляем.