# GitHub с нуля: что это такое и как подключить его к ИИ-агенту

> Для тех, кто работает с Codex или Claude Code и ни разу не открывал GitHub: восемь понятий, регистрация и один запрос (после него агент сам сделает приватную копию вашей папки). Для тех, у кого есть подрядчик или команда, — правила доступа

Автор: Роман Шарафутдинов. Рубрика: Рабочие схемы. Опубликовано: 2026-11-03, обновлено: 2026-11-04. Основание: проверил сам.
Адрес: https://sharafutdinov.ai/m/github-s-nulya/

## Что внутри

Что такое Git и GitHub и чем они отличаются. Зачем GitHub тому, кто не пишет код. Восемь понятий, без которых его не понять. Цена, лимиты и доступ из России на ноябрь 2026. Регистрация и двухфакторная защита. Запрос, после которого агент сам подключит GitHub и сделает приватную копию папки. Что нельзя класть даже в приватный репозиторий. Как сохраняться и откатываться каждый день. Ветки и pull request на схеме. Личный аккаунт или организация, роли для людей и отдельные доступы для агентов и серверов.

## Коротко

- Git ведёт историю изменений папки на компьютере, GitHub хранит копию этой истории в облаке и даёт доступ другим людям и агентам. Для работы с агентом это три вещи сразу: кнопка «сохранить», кнопка «отменить» и копия вне компьютера.
- Бесплатного тарифа хватает: приватных репозиториев сколько угодно. Файлы больше 100 МБ GitHub не принимает, большие видео и выгрузки держат отдельно.
- Регистрируетесь вы сами, а подключение, установку программ и первую копию папки агент делает по одному запросу. Ваша часть — войти на сайте и ввести одноразовый код.
- Ключи, пароли и данные клиентов не кладут даже в приватный репозиторий. Доступ «только чтение» людям можно дать лишь в организации; агентам и серверам нужен отдельный доступ к нужным репозиториям.

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

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

У меня в GitHub лежат рабочие папки: сайт, контентная система, проекты курса. 2 ноября 2026 года упал хостинг Бегет, и на следующий день я за один вечер поднял свой сайт на другом сервере — именно потому, что код был в GitHub. Подробно эту историю я разобрал в статье [про бэкапы по правилу 3-2-1-1-0](https://sharafutdinov.ai/m/bekapy-3-2-1-1-0/). Здесь — GitHub с нуля, руками.

Кому эта статьяТем, кто работает с агентом — Codex или Claude Code — в папке на своём компьютере. Агент — это ИИ, который сам выполняет команды, а не только отвечает в чате; как его поставить, я разобрал в статье про Claude Code. Если у вас сайт сделал подрядчик и агентом вы не пользуетесь, вам нужны два места: раздел «Личный аккаунт или организация» и статья про бэкапы. GitHub хранит код, а не базу сайта, заявки и оплаты.

АктуальностьТарифы, лимиты и команды сверены с документацией GitHub на 3 ноября 2026 года. Названия кнопок на сайте GitHub меняются: если пункт называется иначе, спросите агента, где он сейчас.

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

GitHub — сервис в облаке, где хранится копия истории вашей папки. Саму историю ведёт программа Git на вашем компьютере.

Это два разных инструмента, и их постоянно путают:

GitПрограмма на вашем компьютереВедёт историю изменений папкиРаботает без интернетаБесплатная, открытаяGitHubСайт и облачный сервисХранит копию этой историиДаёт доступ людям, агентам и серверамПринадлежит Microsoft, есть бесплатный тариф

Вся работа с GitHub держится на трёх глаголах — commit, push и pull:

На компьютере · программа Git
Рабочая папкафайлы, которые правите вы и агент
commit — сохранить точку с подписью: что изменилось и зачем
История на компьютеревсе точки сохранения, к любой можно вернуться
push — отправить новые точки в облако
В облаке · GitHub
Репозиторий с меткой Privateкопия всей истории, видят только те, кому вы дали доступ
pull — забрать изменения к себе
Второй компьютер или облачный агентпродолжают с того же места

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

## Зачем GitHub тому, кто не пишет код

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

Отмена любой правкиАгент переписал не тот файл, удалил раздел, «улучшил» инструкцию. Каждое изменение видно построчно, и к любой точке можно вернуться.
Копия вне компьютераПотеряли ноутбук, упал хостинг, сломался диск — проект целиком лежит в облаке со всей историей.
Переезд к другому агентуСегодня Claude Code, завтра Codex в облаке или второй компьютер. Все берут одну и ту же папку из одного места.
Совместная работаПомощник, подрядчик или клиент видят проект и предлагают правки, не ломая вашу рабочую версию.

## Восемь понятий, без которых GitHub не понять

РепозиторийрепоПапка проекта со всей историей изменений. Один проект — один репозиторий.
КоммитcommitСохранённая точка в истории с подписью: что изменилось и зачем. К любой можно вернуться.
Push и pullотправить и забратьPush отправляет ваши коммиты на GitHub, pull забирает чужие оттуда к вам.
ВеткаbranchПараллельная версия проекта для эксперимента. Основная обычно называется main.
Pull requestPRПредложение влить ветку в main. Его смотрят, обсуждают, принимают или отклоняют.
Private и PublicвидимостьПриватный репозиторий видят только те, кому вы дали доступ. Публичный — весь интернет.
КоллабораторсоавторЧеловек, которому вы дали доступ к конкретному репозиторию.
ОрганизацияorganizationОбщий кабинет для проектов: репозитории принадлежат ему, а не человеку. В нём есть роли и команды.

## Сколько стоит GitHub и работает ли он из России

Для личной работы хватает бесплатного тарифа Free: приватных репозиториев в нём сколько угодно. Ограничения касаются больших файлов.

| Что | Лимит на ноябрь 2026 |
|---|---|
| Приватные репозитории | Без ограничения числа, на тарифе Free |
| Файл больше 50 МБ | Git предупредит, но отправит |
| Файл больше 100 МБ | GitHub не примет |
| Загрузка через браузер | До 25 МБ на файл |
| Размер репозитория | В идеале меньше 1 ГБ; больше 5 ГБ GitHub не рекомендует |

Отсюда простое правило: видео, архивы, выгрузки и прочие тяжёлые файлы в GitHub не кладём. Для них — диск и облако, как в схеме из [статьи про бэкапы](https://sharafutdinov.ai/m/bekapy-3-2-1-1-0/).

Из России GitHub работает, официально он не заблокирован. В мае 2026 года были сбои: часть подключений не проходила, Роскомнадзор блокировку отрицал. Если сайт не открывается или регистрация пишет «доступ временно ограничен», обычно помогает сменить сеть или сервер VPN.

## Регистрация: пять минут и двухфакторная защита

Регистрацию делаете вы сами, на сайте GitHub. Агенту для неё ничего не нужно, и пароль ему не давайте.

Откройте github.com/signup и заполните форму. Почта — та, к которой у вас точно останется доступ. Пароль — от 15 символов (или хотя бы от 8, но тогда с цифрой и строчной буквой), сразу в менеджер паролей: Apple «Пароли», Bitwarden или подобный. Логин — латиница, цифры и одиночные дефисы, он будет в адресе ваших проектов.Подтвердите почту. GitHub пришлёт код. Нет письма — проверьте «Спам». Без подтверждённой почты проект не создать.Останьтесь на Free. Анкету и предложения платного тарифа пропускайте.Включите двухфакторную защиту: аватар → Settings → Password and authentication → Two-factor authentication. Подойдёт приложение-аутентификатор на телефоне, например Яндекс Ключ или Google Authenticator. Коды восстановления сохраните туда же, где пароль.

Форма регистрации на github.com/signup. Можно зарегистрироваться и через Google или Apple. Снимок ноября 2026.

## Подключение к агенту: один запрос

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

Что понадобится:

ЗаранееАккаунт на GitHub, Codex или Claude Code, открытый в папке проекта, браузер для входа и 20–30 минут.
На MacМожет всплыть окно «Установить инструменты разработчика» и попросить пароль от Mac. Это нормально: пароль вводите сами в системное окно, установка займёт несколько минут.
На WindowsПосле установки программ агент может их «не видеть». Закройте Codex или Claude Code целиком и откройте заново.
РежимС разрешениями: в Codex он называется «Запрашивать разрешение», в Claude Code — Manual. Агент спрашивает перед каждой командой, а вы читаете, что он собирается сделать.

Вставьте запрос целиком:

```text
Подключи эту папку к GitHub и сделай её приватную копию. Объясняй каждый шаг простыми словами.

1. Проверь, установлены ли git и gh (GitHub CLI). Если нет — скажи, какой командой поставишь их для моей системы, и дождись «да». Если папка уже подключена к git — скажи, куда.
2. Для входа запусти:
   gh auth login --hostname github.com --git-protocol https --web
   Покажи мне одноразовый код и адрес, потом дождись, пока я войду. После входа выполни gh auth setup-git и проверь gh auth status. Мой пароль и коды у меня не спрашивай.
3. До первого коммита создай .gitignore: .env и .env.* (кроме .env.example), ключи, выгрузки клиентов, большие видео, папки окружения (node_modules, .venv). Потом покажи список папок и файлов, которые уйдут в коммит, и отдельно отметь всё, что похоже на данные клиентов, ключи или большие файлы.
4. Проверь git config user.name и user.email. Если пусто — спроси моё имя и предложи no-reply адрес GitHub вместо почты.
5. Предложи имя репозитория и дождись моего «да». Репозиторий создай только приватный.
6. Сделай первый коммит, отправь его на GitHub и дай мне ссылку. Проверь, что последний коммит на GitHub совпадает с локальным.
```

Что будет происходить:

делает агентСтавит программы. Git ведёт историю, а gh — официальная программа GitHub, через которую агент входит в ваш аккаунт. На Mac обычно через Homebrew: brew install gh; Git на Mac часто уже стоит. Если Homebrew нет, агент предложит его поставить. На Windows — winget install --id Git.Git и winget install --id GitHub.cli --source winget.делает агентПоказывает код. В ответе будут строка с одноразовым кодом вида XXXX-XXXX и адрес github.com/login/device. Пока вы входите, агент ждёт — это нормально.делаете выПодтверждаете аккаунт. Откройте адрес в браузере, проверьте, что вошли под своим логином, нажмите Continue.делаете выВводите код из ответа агента и нажимаете Continue. На следующем экране GitHub покажет, что подключается GitHub CLI, — нажмите зелёную кнопку Authorize github. Код, который прислал кто-то другой, не вводите никогда.делает агентСоздаёт репозиторий после вашего «да» на предложенное имя, делает первый коммит и отправляет его.

Шаг 3: GitHub показывает, под каким логином вы вошли. Если логин не ваш — Use a different account.

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

Готово, когда репозиторий открывается по ссылке, рядом с названием стоит метка Private, а внутри — ваши файлы.

## Что нельзя класть даже в приватный репозиторий

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

КладёмКод сайта, бота, скриптовИнструкции агента: AGENTS.md, CLAUDE.md, навыкиЗнания проекта, тексты, шаблоныФайл-образец настроек с пустыми значениями, например .env.exampleНе кладёмКлючи API, пароли, токены, файлы .envВыгрузки клиентов и персональные данныеСканы документов, банковские материалыБольшие видео и архивы

Защищает от этого файл .gitignore — список того, что Git не трогает. Его создают до первого коммита: если ключ уже попал в историю, удаление файла следующим коммитом его не вычищает.

Встроенная защита GitHubGitHub умеет находить ключи в коммитах и останавливать их отправку. Но бесплатно эта проверка работает для публичных репозиториев. Для приватных репозиториев на тарифе Free документация её не обещает, так что опора — на .gitignore и проверку перед коммитом. Просите агента делать эту проверку явно, как в запросе выше.

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

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

Каждый день GitHub сводится к одной фразе агенту в конце работы. Остальные запросы — по ситуации.

```text
# В конце рабочего дня
Сохрани изменения и отправь на GitHub. Перед коммитом покажи, какие файлы уходят, и проверь, что среди них нет ключей и паролей. Сообщение коммита — по-русски, что изменилось и зачем.

# Если агент что-то сломал
Покажи последние 10 коммитов: дата, что изменилось. Верни файл  к состоянию до коммита . Остальное не трогай, покажи разницу до того, как сохранять.

# На другом компьютере
Забери последние изменения с GitHub и покажи, что пришло.
```

Коммит — это недорого. Сохраняйтесь чаще, чем кажется нужным: откатиться к точке, которой нет, нельзя.

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

## Ветки и pull request: когда они нужны

Ветка — параллельная версия проекта для эксперимента. Pull request — предложение влить её обратно в основную версию после проверки. Одному человеку с одной папкой ветки необязательны.

mainрабочая версия проекта
агент ответвляется
Ветка агентаего коммиты, main при этом не меняется
агент открывает pull request
Pull requestвы смотрите разницу построчно и решаете
ваше решение

Принятьизменения вливаются в main
Отклонитьветку удаляют, main не пострадал

Когда ветки полезны:

| Ситуация | Как помогает ветка |
|---|---|
| Агент переделывает половину сайта | Работает в своей ветке. Не понравилось — ветку удалили, main не пострадал |
| Два агента правят одну папку одновременно | Каждому своя ветка, потом по очереди вливаете |
| Подрядчик присылает правки | Через pull request: вы видите разницу построчно и решаете, принимать ли |

Попросить просто: «Сделай это в отдельной ветке и открой pull request, я посмотрю». Как разбирать pull request по шагам и какие команды Git стоят за каждым действием, подробно расписал Сергей Пименов в своём [справочнике по GitHub для новичков](https://pimenov.ai/knowledge/github-dlya-novichkov-rukovodstvo/).

## Личный аккаунт или организация

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

Личный аккаунтgithub.com/ваш-логинСвои черновики и проекты, где вы одинСоавтору можно дать только право записи — он может менять всё«Только чтение» дать нельзяОрганизацияgithub.com/имя-проектаБесплатный тариф, приватных репозиториев сколько угодноРоли от «только чтение» до «администратор»Человек ушёл — убрали из организации, доступы закрылись

Создаётся организация так: аватар → Your organizations → New organization → Free. Перенести туда готовый репозиторий: Settings репозитория → внизу Danger Zone → Transfer ownership. История переезжает целиком. Сразу добавьте второго владельца для страховки: если единственный владелец потеряет доступ к аккаунту, проекты повиснут.

| Роль | Что может | Кому давать |
|---|---|---|
| Read | Смотреть и скачивать, обсуждать | Клиенту «посмотреть», ученику, консультанту |
| Triage | Плюс разбирать задачи, без права менять код | Менеджеру проекта, тестировщику |
| Write | Отправлять изменения | Подрядчику, помощнику |
| Maintain | Плюс настройки репозитория без опасных действий | Ведущему разработчику |
| Admin | Всё, включая удаление | Только владельцу и его страховке |

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

Если сайт делает подрядчик, спросите его: в чьём аккаунте лежит код? Правильный ответ — в организации на вас: вы Owner, у подрядчика роль Write. Если код в его личном аккаунте, при расставании проект уйдёт вместе с ним — попросите перенести репозиторий в вашу организацию через Transfer ownership.

## Доступы для агентов и серверов

Агенту, серверу и сервису нужен свой доступ и только к нужным репозиториям. Тогда при проблеме вы закрываете одну дверь, а не меняете все замки.

Агент на компьютереВходит через gh auth login и получает широкий доступ ко всем вашим репозиториям. Поэтому нужен режим с разрешениями, а вам остаётся читать, что он собирается сделать.
Облачный агентОблачный Codex и Claude Code для GitHub ставят своё приложение на ваш аккаунт. При установке выбирайте Only select repositories, а не все.
Сервер сайтаDeploy key: ключ создаётся на сервере, на GitHub кладётся его открытая часть. Один ключ — один репозиторий, по умолчанию только чтение.
Сторонний сервисFine-grained token: конкретные репозитории, минимальные права, срок действия. Классический токен на весь аккаунт не давайте.

Раз в месяц полезно устроить ревизию. Запрос:

```text
Проверь мои доступы на GitHub через gh. Только чтение, ничего не меняй.
1. Список моих репозиториев и репозиториев организации : имя, Private или Public, дата последнего изменения.
2. По каждому репозиторию: кто имеет доступ и с какой ролью.
3. Отдельно отметь публичные репозитории, людей с ролью Admin и тех, с кем работы уже нет.

Покажи таблицей и предложи, что закрыть. Без моего «да» ничего не меняй.
```

Подключённые приложения видно так: аватар → Settings → Applications. Всё, что не узнаёте, — отключайте.

## Если что-то пошло не так

| Что видите | Что делать |
|---|---|
| «Доступ временно ограничен» при регистрации | Смените сеть или сервер VPN, подождите и попробуйте снова. Обновлять страницу подряд не нужно |
| Агент пишет, что gh не найден | «Поставь gh для моей системы и повтори вход». На Windows после установки перезапустите Codex или Claude Code |
| На Mac всплыло окно «Установить инструменты разработчика» | Нажмите «Установить» и введите пароль от Mac в системном окне. Агент подождёт |
| Код не принимается или истёк | Коды живут недолго. Попросите агента запустить вход заново |
| Агент долго молчит после показа кода | Он ждёт вашего входа на сайте |
| Repository not found или Permission denied | «Проверь gh auth status и выполни gh auth setup-git» |
| Файл не отправляется: больше 100 МБ | Попросите агента убрать файл из истории неотправленных коммитов — простого удаления следующим коммитом мало. Потом добавьте файл в .gitignore и храните отдельно |
| Агент не даёт сохранить: найден ключ | Проверка сработала. Перенесите ключ в менеджер паролей и уберите его из файлов и коммита |
| Человек не видит репозиторий | Он не принял приглашение: оно на почте и в уведомлениях GitHub |

GitHub — это история и копия кода и текстов, но не полный бэкап проекта. Базы сайта, заявок, загруженных файлов и ключей в нём нет. Как сохранить всё остальное, я разобрал в статье [про бэкапы по правилу 3-2-1-1-0](https://sharafutdinov.ai/m/bekapy-3-2-1-1-0/).

## Взять с собой: Запрос агенту: подключи GitHub и сделай приватную копию папки

Когда пользоваться: Откройте папку проекта в Codex или Claude Code в режиме с разрешениями и вставьте запрос целиком. GitHub-аккаунт заведите заранее

Подключи эту папку к GitHub и сделай её приватную копию. Объясняй каждый шаг простыми словами.

1. Проверь, установлены ли git и gh (GitHub CLI). Если нет — скажи, какой командой поставишь их для моей системы, и дождись «да». Если папка уже подключена к git — скажи, куда.
2. Для входа запусти:
   gh auth login --hostname github.com --git-protocol https --web
   Покажи мне одноразовый код и адрес, потом дождись, пока я войду. После входа выполни gh auth setup-git и проверь gh auth status. Мой пароль и коды у меня не спрашивай.
3. До первого коммита создай .gitignore: .env и .env.* (кроме .env.example), ключи, выгрузки клиентов, большие видео, папки окружения (node_modules, .venv). Потом покажи список папок и файлов, которые уйдут в коммит, и отдельно отметь всё, что похоже на данные клиентов, ключи или большие файлы.
4. Проверь git config user.name и user.email. Если пусто — спроси моё имя и предложи no-reply адрес GitHub вместо почты.
5. Предложи имя репозитория и дождись моего «да». Репозиторий создай только приватный.
6. Сделай первый коммит, отправь его на GitHub и дай мне ссылку. Проверь, что последний коммит на GitHub совпадает с локальным.

## Источники

- Мой опыт: проекты и рабочие папки в приватных репозиториях GitHub, переезд сайта с упавшего хостинга 3 ноября 2026
- Инструкции курса Нейрологика 8.0 по GitHub: регистрация, подключение к Codex, организация и доступы (1–3 ноября 2026)
- GitHub Docs: тарифы GitHub — https://docs.github.com/en/get-started/learning-about-github/githubs-plans
- GitHub Docs: большие файлы — предупреждение от 50 MiB, блокировка от 100 MiB, через браузер до 25 MiB — https://docs.github.com/en/repositories/working-with-files/managing-large-files/about-large-files-on-github
- GitHub CLI: установка на macOS — https://github.com/cli/cli/blob/trunk/docs/install_macos.md
- GitHub CLI: установка на Windows — https://github.com/cli/cli/blob/trunk/docs/install_windows.md
- GitHub CLI: gh auth login — https://cli.github.com/manual/gh_auth_login
- GitHub Docs: права соавтора в репозитории личного аккаунта — https://docs.github.com/en/account-and-profile/reference/permission-levels-for-a-personal-account-repository
- GitHub Docs: роли в репозиториях организации — https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization
- GitHub Docs: secret scanning — где доступен — https://docs.github.com/en/code-security/secret-scanning/introduction/about-secret-scanning
- GitHub Docs: что делать, если секрет попал в репозиторий — https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/removing-sensitive-data-from-a-repository
- Claude Code: подключение к GitHub через /install-github-app — https://code.claude.com/docs/en/github-actions
- Медуза: GitHub стал плохо открываться в России, 08.05.2026 — https://meduza.io/news/2026/05/08/github-stal-ploho-otkryvatsya-v-rossii-roskomnadzor-utverzhdaet-chto-ne-blokiruet-ego
- Сергей Пименов: GitHub для новичков — справочник по командам Git и pull request — https://pimenov.ai/knowledge/github-dlya-novichkov-rukovodstvo/
