GitHub — это не «для программистов». Это облачный сейф для любых текстовых файлов с историей изменений, в который встроен ИИ-агент. Если вы умеете работать с Google Docs — вы умеете работать с GitHub. Остальное — детали.
Помню свой первый репозиторий. Я создал его в 2014-м, чтобы сохранить конфиги для одного проекта. Тогда мне казалось, что GitHub — это что-то для тех, кто пишет код за деньги. Прошло десять лет, и теперь я храню там вообще всё: заметки, шаблоны документов, конфиги серверов, настройки агентов, черновики статей. GitHub давно перестал быть «Git-хостингом» — это рабочая среда, в которой живут люди и ИИ-агенты.
Этот материал — для тех, кто начинает с нуля. Без «сначала выучите командную строку», без «установите Homebrew и настройте SSH-ключи». Пройдём весь путь: от регистрации до первой задачи, которую за вас выполнит агент.
Что это
GitHub — облачная платформа для хранения файлов с историей изменений. Чаще всего с кодом, но не только: документация, конфиги, заметки, шаблоны — всё это отлично живёт в репозиториях. Сервис принадлежит Microsoft, и к 2026 году это индустриальный стандарт для всего, что связано с разработкой и технической работой.
Главная идея GitHub — репозиторий. Это папка вашего проекта в облаке. Внутри — файлы, история изменений, доступ для коллег и автоматизации. Каждый репозиторий живёт по своему адресу, например https://github.com/<ваш-ник>/<имя-проекта>.
Представьте Google Docs, только:
- версионирование встроено (любую версию файла можно восстановить);
- работает с любыми текстовыми файлами, а не только с документами;
- есть инструменты совместной работы: ветки, ревью, обсуждения;
- прямо внутри живут ИИ-агенты, которые могут писать код, делать ревью и автоматизировать рутину.
*Ключевое правило:* GitHub — это не только для кода. Это инфраструктурный слой для всего, что должно жить долго и иметь историю. README, AGENTS.md, конфиги, документация — всё это живёт в репозиториях.
Зачем нужно
GitHub решает сразу несколько задач, и редко когда нужна только одна из них.
- Хранение с историей. Каждое изменение — отдельная точка. Можно откатиться, посмотреть, кто и что менял, сравнить две версии. Ничего не теряется «как в Google Docs при одновременном редактировании».
- Совместная работа. Несколько человек работают над одним проектом, не мешая друг другу. Механизм pull request — это «предложи изменения, пусть другие посмотрят и одобрят».
- Автоматизация через GitHub Actions. При каждом изменении можно автоматически запускать тесты, проверки, деплой. Это называется CI/CD — Continuous Integration / Continuous Deployment.
- Open source и обучение. Миллионы проектов с открытым кодом: можно изучать, использовать, предлагать улучшения. Это главная «библиотека» разработчика.
- ИИ-агенты как соавторы. Codex и Copilot coding agent работают прямо внутри GitHub: читают код, пишут изменения, открывают pull request. Без GitHub агенту не с чем работать.
- Документация как код. Markdown-файлы в репозитории — это готовые инструкции, базы знаний, README. Тот же AGENTS.md, который читает Codex, живёт в репозитории.
Как устроено
Архитектурно GitHub — это Git плюс социальный слой поверх него. Git — это система контроля версий, которая работает локально у вас на компьютере. GitHub берёт Git-репозитории и добавляет к ним облачное хранение, веб-интерфейс и инструменты совместной работы.
| Элемент | Что это | Зачем нужен |
|---|---|---|
| Репозиторий (repo) | Папка проекта в облаке | Хранит файлы, историю, настройки |
| Коммит (commit) | Снимок изменений с описанием | Контрольная точка, к которой можно вернуться |
| Ветка (branch) | Параллельная версия проекта | Безопасное экспериментирование без поломки основной версии |
| Pull Request (PR) | Запрос на слияние изменений | Механизм ревью: изменения попадают в основную ветку только после одобрения |
| Fork | Копия чужого репозитория к себе | Позволяет взять чужой проект и предложить свои правки |
| README.md | Главный файл описания проекта | Точка входа для людей и агентов |
| AGENTS.md | Инструкция для ИИ-агентов | Стандарт, который читают 30+ агентов в более чем 60 000 репозиториев |
| Issue | Задача, баг или идея | Управление работой: обсуждение, метки, назначение |
| GitHub Actions | Автоматизация в .github/workflows/ | CI/CD: тесты, линтеры, деплой по событию |
GitHub поддерживает публичные и приватные репозитории. Публичные видны всем — это стандарт для open source и портфолио. Приватные — только вам и тем, кого вы пригласили. Это рабочий вариант для коммерческих проектов и личных черновиков.
*Ключевое правило:* на бесплатном тарифе можно держать неограниченное количество публичных и приватных репозиториев. «Приватность» — это не премиум-фича, а базовая возможность. Для старта не нужно платить ни за что.
Когда использовать
| Ситуация | Подходит / не подходит | Почему |
|---|---|---|
| Хранить конфиги серверов, скрипты, dotfiles | Подходит | История изменений, доступ с любой машины, бэкап «по умолчанию» |
| Вести документацию проекта | Подходит | Markdown рендерится прямо в GitHub, удобно для людей и агентов |
| Хранить код коммерческого проекта | Подходит | Приватные репозитории на Free, удобный PR-ревью |
| Делиться open source | Подходит | Это стандарт индустрии: 150+ миллионов разработчиков уже здесь |
| Работать с ИИ-агентом над проектом | Подходит | Codex и Copilot coding agent работают прямо в репозитории |
| Хранить большие бинарные файлы (видео, дампы) | Не подходит | Для этого есть S3, Git LFS или специализированные хранилища |
| Хранить секреты (.env, токены, ключи) | Не подходит | Это утечка даже в приватном репо. Секреты — в Vault, 1Password, GitHub Secrets для CI |
Регистрация и первые шаги
Начать можно вообще без командной строки — через веб-интерфейс. Это не «облегчённая версия» GitHub, а полноценный способ работать.
Шаг 1. Создайте аккаунт
Перейдите на github.com и нажмите Sign up. Понадобится email и пароль. Бесплатный тариф сразу даёт неограниченное количество публичных и приватных репозиториев.
Шаг 2. Создайте первый репозиторий
- Нажмите + в правом верхнем углу → New repository.
- Введите имя (например, my-first-repo).
- Выберите Public или Private.
- Поставьте галочку Add a README file.
- Нажмите Create repository.
Готово — у вас есть репозиторий с одним файлом.
Шаг 3. Отредактируйте README
Откройте файл README.md, нажмите иконку карандаша, отредактируйте текст и нажмите Commit changes. Поздравляю — вы сделали свой первый коммит. Описание коммита пишется в одном поле, и это хороший момент приучить себя писать осмысленные описания: что изменилось и зачем.
Шаг 4. Загрузите файлы
Нажмите Add file → Upload files, перетащите файлы и сделайте коммит. Теперь ваши файлы в облаке с историей.
Работа через веб-интерфейс
Многие думают, что GitHub — это обязательно терминал и git push. Для начала достаточно веб-интерфейса. Вот что он умеет:
- редактирование файлов прямо в браузере с превью Markdown;
- загрузка файлов через drag-and-drop;
- создание веток и pull request через интерфейс;
- просмотр истории изменений в один клик;
- обсуждения, обзоры diff-ов, code review;
- запуск Actions и просмотр их логов.
Командная строка (Git CLI) — следующий шаг, когда вы захотите работать быстрее. Начинать с неё необязательно. Если вы только осваиваете GitHub — пользуйтесь вебом, пока не упрётесь в его ограничения.
Ключевые понятия в одной картинке
Репозиторий
└── main (основная ветка)
├── commit A — "init project"
├── commit B — "add README"
└── commit C — "fix typo"
│
└── feature/login (параллельная ветка)
├── commit D — "add login form"
└── commit E — "add validation"
│
└── Pull Request #1: feature/login → main
├── ревью от коллег и ИИ-агента
├── CI: тесты, линтеры
└── Merge → изменения попадают в mainВсё, что вы видите на этой схеме, можно сделать через веб-интерфейс или через CLI — разница только в скорости и автоматизации.
Тарифы и лимиты
GitHub разделяет два вида тарифов: тарифы на репозитории (Free / Pro / Team / Enterprise) и тарифы на Copilot (Free / Pro / Pro+ / Max). Это разные продукты — путать их легко, но важно не путать.
Тарифы на репозитории (GitHub Plans)
| План | Цена | Что включено |
|---|---|---|
| Free | $0 | Неограниченные публичные и приватные репозитории, GitHub Actions (2 000 минут/мес), GitHub Pages, GitHub Codespaces (120 core-hours/мес ≈ 60 часов на 2-ядерной машине), 500 MB GitHub Packages |
| Pro | $4/мес | Всё из Free + расширенные лимиты Actions (3 000 минут/мес), 180 Codespaces core-hours, защита веток, Pages в приватных репо, расширенная аналитика |
| Team | $4/мес за пользователя | Всё из Pro + командное управление, ревью, дополнительные инструменты для организаций |
| Enterprise | $21/мес за пользователя | Всё из Team + 50 000 Actions минут/мес, 50 GB Packages, SAML SSO, аудит, премиум-поддержка, SLA 99.9% |
Для начала хватит Free. Все основные возможности — репозитории, Actions, Pages, Codespaces — доступны бесплатно. Переходить на Pro имеет смысл, когда вам не хватает Codespaces-часов или нужны защищённые ветки в личных проектах.
Тарифы на Copilot
Copilot — отдельный продукт, про который важно знать: в 2026 году GitHub перешёл на usage-based billing (оплата по факту использования AI-кредитов).
| План | Цена | Что включено |
|---|---|---|
| Free | $0 | Лимитированный chat и agent mode |
| Pro | $10/мес + $5 flex | Базовые AI-кредиты + гибкий дополнительный пакет |
| Pro+ | $39/мес + $31 flex | Больше кредитов и пулинг по организации |
| Max | $100/мес + $100 flex | Для sustained high-volume agent workflows |
Copilot Pro — это про ИИ-помощника в IDE и агенты. Если вы работаете с Codex от OpenAI, Copilot вам может быть и не нужен — это два разных стека.
**Важно:** Copilot code review расходует не только AI-кредиты, но и минуты GitHub Actions. Для публичных репозиториев минуты остаются бесплатными, для приватных — расходуются из квоты вашего плана.
Интеграция с Codex
GitHub — не просто хранилище. Когда вы подключаете его к OpenAI Codex, ваш репозиторий превращается в рабочую среду с ИИ-агентом. Codex читает код, пишет изменения, открывает pull request, запускает тесты — и всё это с вашего одобрения.
Что такое Codex
Codex — coding-агент от OpenAI, который работает на нескольких поверхностях и подключается к GitHub через OAuth. Его возможности:
- читает ваш код и документацию в репозитории;
- пишет новый код, тесты, README;
- создаёт ветку и Pull Request с изменениями;
- выполняет задачи параллельно в изолированных песочницах;
- работает по инструкциям из файла AGENTS.md;
- доступен в CLI, Cloud, Desktop App (macOS / Windows), IDE-расширениях и через мобильное управление ChatGPT.
Codex работает с вашим кодом напрямую — клонирует репозиторий, вносит изменения и создаёт PR. Без GitHub Codex не знает, с чем работать. Это и есть главная связка: GitHub — данные, Codex — исполнитель, PR — механизм согласования.
Почему GitHub и Codex хорошо работают вместе
- Каждая задача — это PR. Вы видите все изменения, можете проверить diff и отклонить. Ничего не попадает в основную ветку без вашего одобрения.
- AGENTS.md в корне репозитория — это инструкция для агента. Один и тот же файл читают Codex, Cursor, GitHub Copilot, Jules от Google и другие.
- Параллельная работа. Можно поставить пять задач одновременно. Каждая выполняется в отдельной песочнице, для каждой появится отдельный PR.
- История и прозрачность. Всё, что делает Codex, записывается в GitHub: коммиты, диффы, логи.
**Ключевое правило:** Codex создаёт изменения в отдельной ветке. Пока вы не нажмёте Merge, ничего не попадёт в основную ветку. Безопасно экспериментировать.
Подключение GitHub к Codex
Способ 1: Codex Cloud (самый простой)
- Откройте chatgpt.com/codex.
- Нажмите New Task.
- При первом запуске Codex попросит подключить GitHub — нажмите Connect GitHub.
- Авторизуйте приложение OpenAI в GitHub через OAuth.
- Выберите репозитории, к которым Codex получит доступ.
- Готово — можно ставить задачи.
Способ 2: Codex Desktop App
- Скачайте Codex Desktop со страницы developers.openai.com/codex/app. Приложение есть для macOS и Windows (на Windows работает без WSL, в том числе доступно в Microsoft Store).
- Авторизуйтесь через ChatGPT-аккаунт.
- GitHub подключается автоматически при открытии локального репозитория.
- Если репозиторий имеет remote на GitHub, Codex сможет создавать PR.
Способ 3: Codex CLI
# Установка (любой из вариантов)
brew install --cask codex
# или
npm install -g @openai/codex
# Запуск в папке с git-репозиторием
cd my-project
codex
# при первом запуске выберите «Sign in with ChatGPT»CLI автоматически определяет GitHub remote и работает с ним. Если репозиторий уже связан с GitHub, Codex сможет создавать ветки и PR прямо из терминала.
Первая задача для Codex
- Откройте Codex Cloud.
- Выберите нужный репозиторий.
- Напишите задачу, например: «Добавь файл AGENTS.md с описанием проекта и правилами работы».
- Codex создаст ветку, внесёт изменения и откроет PR.
- Проверьте PR в GitHub и нажмите Merge — или попросите Codex переделать.
Это безопасный цикл: задача → ветка → PR → ревью → merge. На каждом этапе вы можете вмешаться.
AGENTS.md — контракт с агентом
Файл AGENTS.md в корне репозитория — инструкция, которую Codex читает перед каждой задачей. Это открытый стандарт: его курирует Agentic AI Foundation под эгидой Linux Foundation, и один и тот же файл читают более 30 агентов в 60 000+ репозиториев.
Логика простая: README.md пишется для людей (быстрый старт, описание проекта, контрибуция), а AGENTS.md — для агентов (сборка, тесты, конвенции, стоп-линии). Агент читает ближайший AGENTS.md в дереве каталогов, поэтому для монорепо можно класть отдельные AGENTS.md в подпакеты.
Пример AGENTS.md:
# Project: my-project
## Stack
- Astro 6.x
- TypeScript
- Tailwind CSS
## Rules
- Все коммиты на русском языке
- Не трогать папку /content без явной команды
- Перед мёрджем — запустить npm run build
- README.md всегда актуален
## Stop-lines
- Не менять .env файлы
- Не удалять тесты
- Не деплоить без подтвержденияЧем точнее инструкция, тем предсказуемее работает агент. Опишите стек, правила именования, стоп-линии — и Codex будет следовать им.
Встроенный ИИ-агент GitHub: Copilot coding agent
Codex — не единственный вариант. У самого GitHub есть родной агент — GitHub Copilot coding agent, который живёт прямо внутри платформы и не требует подключения OpenAI.
Что он умеет:
- Облачный агент. Назначьте ему issue или поставьте задачу — он исследует репозиторий, составит план, внесёт изменения в отдельной ветке и откроет Pull Request на ваше ревью.
- Вкладка Agents прямо в репозитории — создавать, отслеживать и направлять задачи, не уходя со страницы проекта.
- Copilot CLI — агент в терминале: добавить фичу, починить баг и сразу открыть PR.
- Copilot memory — агент запоминает контекст вашего кода со временем.
- Copilot app — отдельное agent-native десктоп-приложение.
Когда что выбрать:
- Codex удобен, если вы уже в экосистеме OpenAI / ChatGPT и работаете в нескольких средах сразу.
- Copilot coding agent — если хотите агента «из коробки» внутри GitHub, без сторонних подключений.
В 2026 году Copilot перешёл на usage-based billing — все планы оплачиваются по факту потребления AI-кредитов. Если считаете бюджет — закладывайте расход по токенам, а не фиксированную подписку.
Полезные файлы в репозитории
| Файл | Зачем нужен |
|---|---|
| README.md | Описание проекта, точка входа для людей и агентов |
| AGENTS.md | Инструкция для Codex и других ИИ-агентов |
| .gitignore | Список файлов, которые не попадают в репозиторий |
| LICENSE | Лицензия проекта (MIT, Apache и др.) |
| SESSION_NOTES.md | Заметки рабочих сессий с Codex |
| .github/workflows/ | Автоматизации GitHub Actions |
Пример
Простой пример рабочего цикла «задача для Codex через PR». Допустим, в репозитории vorobeoffai/site нужно добавить страницу «О проекте».
- Открываем Codex Cloud, выбираем репозиторий.
- Пишем задачу: «Создай страницу src/pages/about.astro с заголовком, hero-блоком и блоком команды. Используй существующий дизайн-слой. Сделай PR с описанием».
- Codex создаёт ветку feat/about-page, пишет файл, обновляет навигацию, открывает PR.
- CI запускает тесты и линтеры.
- Я открываю PR, смотрю diff, прошу Codex добавить ссылку в футер.
- После правок — нажимаю Merge.
Время: ~5 минут на постановку задачи, ~10 минут на ревью и правки. Без Codex тот же объём — час работы.
Ограничения
Ограничения
Что важно держать в голове при работе с GitHub.
Бесплатные минуты Actions только для публичных репо
для приватных есть квота по плану (2 000 / 3 000 / 50 000 в месяц), сверх квоты — доплата по стандартным тарифам.
Public ≠ «доступно всем на чтение»
публичный репозиторий виден всему миру, включая поисковые системы; приватные на Free тоже бесплатны, если нужна приватность.
GitHub
не хранилище бинарных файлов — большие видео, дампы, модели машинного обучения лучше держать в S3, Git LFS или специализированных сервисах.
Размер репозитория ограничен
GitHub предупреждает при репозиториях больше 1 ГБ и жёстко ограничивает 100 ГБ; для больших проектов есть Git LFS, но и он лимитирован.
Скорость Actions зависит от раннера
стандартные Linux-раннеры бесплатны в публичных репо, но для больших пайплайнов придётся брать GitHub-hosted larger runners или self-hosted.
API имеет лимиты
для массовых автоматизаций нужен GitHub App с повышенными лимитами, а не просто Personal Access Token.
Антипаттерны
Антипаттерны
Типичные ошибки, которые ломают репозиторий или безопасность.
Не делать:
коммитить секреты — .env, токены, ключи API, пароли от баз данных утекают даже в приватном репо — бот найдёт их за минуты. Секреты хранятся в GitHub Secrets или во внешних Vault.
Не делать:
один огромный коммит — атомарные изменения проще ревьюить и откатывать. Один логический шаг = один коммит с осмысленным описанием.
Не делать:
работать напрямую в main — все изменения через ветки и PR. main — это production, его нельзя ломать.
Не делать:
игнорировать .gitignore — без него в репозиторий попадают node_modules, .env, кеши, артефакты сборки. Репозиторий раздувается, история замусоривается.
Не делать:
мешать GitHub с CI в один монолит — крупные проекты держат инфраструктуру как код отдельно (Terraform, Pulumi), а репозиторий — только под приложение.
Не делать:
Force Push на общих ветках — он переписывает историю, и коллеги (и агенты) теряют свои изменения.
Не делать:
оставлять issues без ответов — закрытые, но не решённые задачи копятся, агент видит «открытое» и начинает путаться.
Чеклист
Чеклист
Что должно быть готово, прежде чем репозиторий станет рабочей средой.
Аккаунт создан и email подтверждён
без подтверждения email часть функций (Actions, Pages) заблокирована.
SSH-ключ или PAT добавлен
для работы через CLI нужен хотя бы один способ аутентификации; для агентов — GitHub App с нужными правами.
.gitignore настроен под стек — минимум:
node_modules/, .env, dist/, .DS_Store, артефакты сборки.
README.md заполнен — это первое, что видят люди и агенты.
Опишите, что за проект, как запустить, как контрибутить.
AGENTS.md создан, если работаете с Codex / Copilot
без него агенту придётся каждый раз угадывать ваш стек и стоп-линии.
Ветка по умолчанию защищена — настройте branch protection для main:
обязательное ревью, прохождение CI, запрет force-push.
Секреты вынесены в GitHub Secrets или Vault
ни в коем случае не в коммитах.
Первый Actions workflow запускается
простой hello world job, чтобы проверить, что CI вообще работает.
Ссылки
Ссылки
- GitHub — официальный сайт: github.com
- GitHub Docs — документация: docs.github.com
- GitHub Pricing — тарифы: github.com/pricing
- GitHub Status — статус сервиса: githubstatus.com
- AGENTS.md — стандарт: agents.md
- Codex — главная страница: openai.com/codex
- Codex Cloud: chatgpt.com/codex
- Codex Desktop: developers.openai.com/codex/app
- GitHub Copilot Plans: github.com/features/copilot/plans