Гайд: подключаем GitHub к твоему агенту

Зачем этот гайд. GitHub — это «облачный сейф» для твоего кода. Чтобы агент туда попал, GitHub нужно один раз подключить. Займёт ~10 минут.

---

Что вообще происходит (на пальцах)

• GitHub — сайт, где хранится твой код в интернете (бэкап + история версий + доступ с любого устройства).
• SSH-ключ — как персональный электронный пропуск: твой компьютер один раз «представляется» GitHub, и дальше агент заходит без пароля. Ключ состоит из двух половинок: приватная (секретная, остаётся у тебя) и публичная (её отдаём GitHub).

Ты сделаешь три вещи: (1) заведёшь аккаунт GitHub, (2) агент создаст ключ, (3) ты вставишь публичную половину ключа в настройки GitHub. Всё.

---

Шаг 1 — Заведи аккаунт на GitHub (3 мин)

1. Открой https://github.com → Sign up.
2. Введи почту, пароль, придумай имя пользователя (username) — оно будет в адресе твоих проектов.
3. Подтверди почту.

Уже есть аккаунт — переходи к Шагу 2.

Результат: у тебя есть аккаунт GitHub, ты в него вошёл.

---

Шаг 2 — Агент создаёт SSH-ключ (2 мин)

Открой в VS Code свой AI-агент (Claude Code или Codex) и введи:

Настрой мне доступ к GitHub по SSH:
1) Проверь, есть ли у меня уже SSH-ключ для GitHub (~/.ssh/id_ed25519.pub). Если нет — создай новый ключ командой ssh-keygen (тип ed25519, без пароля, чтобы не спрашивал каждый раз).
2) Покажи мне ПУБЛИЧНУЮ часть ключа (содержимое файла ~/.ssh/id_ed25519.pub) — я скопирую её и вставлю в GitHub.
3) Приватную часть никуда не отправляй и не показывай — она секретная.

Агент покажет строку вида ssh-ed25519 AAAA... твоя-почта. Скопируй её целиком — она понадобится в Шаге 3.

Результат: ключ создан, публичная часть у тебя в буфере обмена.

---

Шаг 3 — Вставь публичный ключ в GitHub (2 мин)

1. Открой https://github.com/settings/keys (или: аватар справа вверху → Settings → слева SSH and GPG keys).
2. Нажми New SSH key.
3. Title — любое понятное имя, напр. «Мой ноутбук».
4. Key — вставь скопированную строку из Шага 2.
5. Add SSH key.

Результат: GitHub знает твой ключ — пропуск оформлен.

---

Шаг 4 — Проверь, что связь работает (1 мин)

Введи агенту:

Проверь SSH-подключение к GitHub: выполни `ssh -T -o StrictHostKeyChecking=accept-new git@github.com` (флаг сам примет отпечаток сервера при первом входе — без лишнего вопроса) и покажи ответ. Если увидишь «Hi <моё-имя>!» — всё подключено, скажи мне.

Если агент написал «Hi твоё-имя! You've successfully authenticated, but GitHub does not provide shell access» — готово 🎉 (концовка про «does not provide shell access» — это нормально, так и должно быть).

Результат: агент связан с твоим GitHub по SSH. На воркшопе он сможет сам сохранять проект в облако.

---

Если что-то не сработало

• Permission denied (publickey) — публичный ключ не добавился в GitHub или добавился не тот. Повтори Шаг 2 (покажи ключ ещё раз) и Шаг 3 (вставь заново).
• Агент не может выполнить команды в терминале — попроси его дать тебе команды, и вставь их в терминал VS Code сам (Terminal → New Terminal).
• Совсем застрял — не трать время, приходи на воркшоп как есть: куратор поможет за пару минут.

---

На воркшоп ты приходишь с уже подключённым GitHub — дальше агент всё делает сам. Увидимся! 🚀