Git и GitHub: история изменений проекта, командная работа

Храним код в Git и GitHub

Зачем: Git — это «история изменений» вашего проекта. GitHub — «облачное хранилище» для этой истории. Вместе они позволяют:

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

Три главные команды, которые пригодятся каждый день:

• git commit — сохранить точку в локальной истории проекта (как save в компьютерной игре)
• git push — отправить свои коммиты в облако (в репозиторий на GitHub)
• git pull — забрать свежие коммиты коллег из облака к себе на компьютер

Требуется: установленный Claude Code (macOS | Windows). Git обычно уже установлен на macOS; на Windows его при необходимости поставит сам Claude Code.

---

1. Зарегистрируйтесь на GitHub

Перейдите на github.com и нажмите Sign up в правом верхнем углу. Придумайте username, введите email и пароль — после этого придёт письмо с кодом подтверждения.

Совет: username на GitHub будет виден всем — выбирайте что-то нейтральное. Если потом захотите показать код работодателю или клиенту, username станет частью ссылки на ваш профиль.

---

2. Создайте репозиторий

Репозиторий (repository, или просто «репо») — это ваша папка с проектом, но в облаке. У вас может быть много репозиториев — отдельный под каждый проект.

1. Нажмите кнопку New в разделе Top repositories на главной (или откройте github.com/new)
2. Repository name — название, например my-first-project
3. Description — короткое описание, можно пропустить
4. Choose visibility — обязательно выберите Private
5. Остальные галочки не трогайте
6. Нажмите Create repository

Важно: Если выбрать Public — код увидят все в интернете. Для пет-проекта, клиентских данных и экспериментов всегда начинайте с Private. Публичным репозиторий можно сделать потом одним кликом (и обратно тоже).

---

3. Скопируйте адрес репозитория

После создания откроется страница вашего пустого репозитория. Сверху будет синяя плашка с адресом вида:

git@github.com:username/my-first-project.git

Переключите вкладку на SSH (а не HTTPS) и нажмите иконку копирования рядом с адресом. Эту строку понадобится передать Claude Code.

---

4. Попросите Claude Code подключить проект к репозиторию

Перейдите в терминале в папку с проектом и запустите Claude Code:

claude

Скопируйте промпт (подставьте свой адрес из прошлого шага):

Залей эту папку в мой репозиторий на GitHub: git@github.com:username/my-first-project.git. Настрой всё, что нужно, чтобы я мог дальше делать push и pull из Claude Code.

Claude попробует выполнить первую отправку — и, скорее всего, скажет, что нужно добавить SSH-ключ вашего компьютера на GitHub. Переходите к следующему шагу.

---

5. Сгенерируйте SSH-ключ

SSH-ключ — это цифровой пропуск вашего компьютера на GitHub. Без него GitHub не разрешит отправлять в репозиторий изменения. Ключ генерируется один раз и потом просто лежит на компьютере.

Попросите Claude:

Сгенерируй мне SSH-ключ для моего компьютера и покажи публичную часть, которую нужно добавить на GitHub.

Claude создаст ключ и покажет длинную строку (начинается с ssh-ed25519 или ssh-rsa) — это публичная часть ключа. Её можно безопасно показывать GitHub. Вторая, приватная часть, останется у вас на компьютере — её никому показывать нельзя.

Скопируйте всю строку целиком.

---

6. Добавьте ключ на GitHub

1. Перейдите на github.com/settings/keys
2. Нажмите зелёную кнопку New SSH key
3. Title — название устройства, например MacBook Air или рабочий ноутбук
4. Key type — оставьте Authentication Key
5. Key — вставьте скопированную строку из прошлого шага
6. Нажмите Add SSH key

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

---

7. Отправьте проект в репозиторий

Вернитесь в Claude Code и попросите:

SSH-ключ добавлен на GitHub — попробуй отправить проект в репозиторий ещё раз.

После успешной отправки обновите страницу репозитория на GitHub — там появятся ваши файлы.

---

8. Пригласите коллег

Если хотите работать над проектом с кем-то ещё:

1. На странице репозитория откройте вкладку Settings
2. В левом меню — Collaborators
3. Нажмите Add people
4. Введите username или email человека
5. Нажмите Add ... to this repository

Коллеге придёт приглашение на email. После принятия он сможет делать commit, push и pull наравне с вами.

---

Как пользоваться каждый день

В Git есть три ключевые команды, которые надо запомнить:

• git commit — сохраняет «снимок» ваших изменений в локальной истории проекта. Аналогия — сохранение (save) в компьютерной игре. Коммитов может быть много за день.
• git push — отправляет все сделанные вами коммиты в репозиторий на GitHub. Аналогия — заливка сейвов в облако.
• git pull — забирает коммиты коллег из репозитория к вам на компьютер. Аналогия — скачивание сейвов из облака.

На практике в Claude Code можно не различать commit и push — скажите «закомить и запушь», и Claude сделает оба шага подряд. Но понимать разницу полезно: коммит — ваша личная точка сохранения, push — отправка в общее облако.

---

Команда push — отправить свои изменения в репозиторий

Когда сделали что-то осмысленное (добавили функцию, поправили баг, закончили секцию) — сохраняйте это в репозиторий. Попросите Claude Code:

Закомить и запушь мои изменения

Claude сам соберёт изменения, придумает описание коммита и отправит их на GitHub.

Когда делать push? Минимум — в конце каждого рабочего дня. А лучше — после каждой законченной мини-задачи: так если что-то сломается, откатиться будет проще.

---

Рабочий цикл в команде

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

1. git pull — забрали свежие изменения от коллег
2. Работаете над задачей и коммитите по ходу (несколько точек сохранения за день — это нормально)
3. git push — отправили все свои коммиты в репо

На следующий день — то же самое заново.

Подсказка: Самый частый источник конфликтов — забыть pull перед началом работы. Если видите, что коллега что-то делал утром, а вы садитесь работать днём — начинайте с pull.

---

Команда pull — забрать изменения коллег

Перед тем как сесть работать, если над проектом работает кто-то ещё — сначала заберите его свежие изменения:

Сделай git pull

Claude скачает изменения коллег в вашу локальную папку. Теперь вы работаете на актуальной версии.

Когда делать pull? Каждый раз перед началом работы, если над проектом работает ещё кто-то. Если работаете один — не обязательно.

---

Готово!

Теперь у вас есть репозиторий на GitHub, настроенный SSH-ключ, и вы умеете делать commit, push и pull. Этого достаточно для 95% повседневной работы.

---

Частые вопросы

Я забыл сделать pull, и мы с коллегой наредактировали один файл

Это называется merge conflict — конфликт при слиянии. Git покажет, какие строчки в каких файлах спорные. Попросите Claude:

У меня merge conflict, разреши его.

Claude посмотрит на конфликтующие места и либо решит сам (если изменения не противоречат друг другу), либо спросит у вас, какую версию оставить.

Я случайно запушил в репозиторий секретный ключ или пароль

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

Дополнительно попросите Claude:

В истории git лежит секрет — нужно полностью вычистить его из истории и сделать force push.

Как откатиться на старую версию?

Попросите Claude:

Покажи последние коммиты в репозитории.

Выберите тот, на который хотите откатиться, и попросите:

Откатись на коммит abc1234.

Claude пытается залогиниться по логину/паролю, а не по SSH

Значит, в проекте прописан адрес репозитория в формате https://github.com/..., а не git@github.com:.... Попросите Claude:

Переключи репозиторий на SSH-адрес: git@github.com:username/my-first-project.git

Хочу публичный репозиторий — как переключить?

На странице репозитория: Settings → внизу раздел Danger Zone → Change repository visibility → Change to public. Обратно тоже можно.

Нужно ли устанавливать GitHub Desktop, SourceTree или что-то ещё?

Нет. Claude Code + терминал закрывают все базовые задачи. Визуальные приложения могут пригодиться позже, когда захочется удобно смотреть историю коммитов или разруливать сложные конфликты — но для старта не нужны.