GitHub для новичков — полное руководство: от регистрации до работы с Codex

Облачная платформа для хранения кода и совместной работы, которая в связке с OpenAI Codex превращается в рабочую среду с ИИ-агентом. Руководство для тех, кто начинает с нуля.

Что такое GitHub

GitHub — облачная платформа для хранения, версионирования и совместной работы с файлами. Чаще всего с кодом, но не только. Представьте Google Docs для любых текстовых файлов: вся история изменений на виду, можно вернуться к любой версии, работать параллельно с другими людьми — и ничего не потеряется.

GitHub принадлежит Microsoft и используется более чем 100 миллионами разработчиков по всему миру. Это стандарт индустрии.

Основные возможности

Ключевые понятия

Репозиторий (repository, repo)

Папка вашего проекта на GitHub. Внутри — файлы, папки, история изменений. У каждого репозитория есть адрес, например:

https://github.com/pimenov/my-project

Коммит (commit)

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

Ветка (branch)

Параллельная версия проекта. Можно создать ветку, внести изменения, проверить их — и только потом объединить с основной версией. Основная ветка обычно называется main.

Pull Request (PR)

Запрос на объединение изменений из одной ветки в другую. Механизм ревью: вы предлагаете изменения, другие люди (или ИИ-агент) их проверяют, и только после одобрения изменения попадают в основную ветку.

Fork

Копия чужого репозитория в ваш аккаунт. Можно взять любой публичный проект, скопировать к себе, изменить и предложить автору свои правки.

README.md

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

Регистрация и первые шаги

Шаг 1. Создайте аккаунт

Перейдите на github.com и нажмите Sign up. Понадобится email и пароль. Бесплатный план даёт неограниченные публичные и приватные репозитории.

Шаг 2. Создайте первый репозиторий

1. Нажмите + → New repository
2. Введите имя (например, my-first-repo)
3. Выберите Public или Private
4. Поставьте галочку Add a README file
5. Нажмите Create repository

Готово — у вас есть репозиторий с одним файлом.

Шаг 3. Отредактируйте README

Откройте файл README.md, нажмите иконку карандаша (✏️), отредактируйте текст и нажмите Commit changes. Вы сделали свой первый коммит.

Шаг 4. Загрузите файлы

Нажмите Add file → Upload files, перетащите файлы и сделайте коммит. Теперь ваши файлы в облаке с историей.

Работа через веб-интерфейс

Многие думают, что GitHub — это обязательно командная строка и git push. Для начала достаточно веб-интерфейса:

• Редактирование файлов прямо в браузере
• Загрузка файлов через drag-and-drop
• Создание веток и PR через интерфейс
• Просмотр истории изменений в один клик

Публичные и приватные репозитории

Для рабочих проектов обычно используют приватные репозитории. Для портфолио и open source — публичные.

Тарифы и лимиты

Интеграция с Codex

GitHub — не просто хранилище. Когда вы подключаете его к OpenAI Codex, ваш репозиторий превращается в рабочую среду с ИИ-агентом.

Что такое Codex

Codex — облачный coding-агент от OpenAI. Его возможности:

• Читает ваш код и документацию
• Пишет новый код, тесты, README
• Создаёт Pull Request с изменениями
• Выполняет задачи параллельно в изолированных песочницах
• Работает по вашим инструкциям из файла AGENTS.md

Codex доступен в трёх режимах: Desktop App (macOS), Cloud (через chatgpt.com/codex) и CLI (терминал). Все три работают с GitHub.

Зачем подключать GitHub к Codex

1. Codex работает с вашим кодом напрямую — клонирует репозиторий, вносит изменения и создаёт PR. Без GitHub Codex не знает, с чем работать.
2. Каждая задача — это PR — вы видите все изменения, можете проверить и отклонить. Ничего не попадает в основную ветку без вашего одобрения.
3. AGENTS.md — инструкция для агента — файл в корне репозитория, по которому Codex следует вашим правилам.
4. Параллельная работа — можно поставить 5 задач одновременно. Каждая выполняется в отдельной песочнице, для каждой появится отдельный PR.
5. История и прозрачность — всё, что делает Codex, записывается в GitHub: коммиты, диффы, логи.

Подключение GitHub к Codex

Способ 1: Codex Cloud (самый простой)

1. Откройте chatgpt.com/codex
2. Нажмите New Task
3. При первом запуске Codex попросит подключить GitHub — нажмите Connect GitHub
4. Авторизуйте приложение OpenAI в GitHub (OAuth)
5. Выберите репозитории, к которым Codex получит доступ
6. Готово — можно ставить задачи

Способ 2: Codex Desktop App

1. Скачайте Codex Desktop с codex.openai.com (macOS)
2. Авторизуйтесь через ChatGPT-аккаунт
3. GitHub подключается автоматически при открытии локального репозитория
4. Если репозиторий имеет remote на GitHub, Codex сможет создавать PR

Способ 3: Codex CLI

# Установка
brew install openai-codex

# Авторизация
codex auth login

# Запуск в папке с git-репозиторием
cd my-project
codex

CLI автоматически определяет GitHub remote и работает с ним.

Первая задача для Codex

1. Откройте Codex Cloud
2. Выберите нужный репозиторий
3. Напишите задачу, например: «Добавь файл AGENTS.md с описанием проекта и правилами работы»
4. Codex создаст ветку, внесёт изменения и откроет PR
5. Проверьте PR в GitHub и нажмите Merge

AGENTS.md — контракт с агентом

Файл AGENTS.md в корне репозитория — инструкция, которую Codex читает перед каждой задачей.

# Project: my-project

## Stack
- Astro 6.x
- TypeScript
- Tailwind CSS

## Rules
- Все коммиты на русском языке
- Не трогать папку /content без явной команды
- Перед мёрджем — запустить npm run build
- README.md всегда актуален

## Stop-lines
- Не менять .env файлы
- Не удалять тесты
- Не деплоить без подтверждения

Полезные файлы в репозитории

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

Нужно ли уметь программировать?

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

GitHub — это бесплатно?

Да. Бесплатный план включает неограниченные публичные и приватные репозитории, GitHub Actions (2 000 минут/месяц), GitHub Pages и Codespaces.

Чем GitHub отличается от Git?

Git — система контроля версий, которая работает локально на компьютере. GitHub — облачный сервис, который хранит ваши Git-репозитории в интернете и добавляет веб-интерфейс, совместную работу, Issues, PR и автоматизации.

Можно ли использовать GitHub без Codex?

Конечно. GitHub работает сам по себе. С Codex он превращается из хранилища в рабочую среду с ИИ-агентом, который делает задачи за вас.

Что будет, если Codex сломает мой код?

Codex создаёт отдельную ветку и PR. Пока вы не нажмёте Merge, изменения не попадут в основную ветку. Можно отклонить PR в любой момент.

Ссылки

По теме

• Статья: Мой первый публичный репозиторий на GitHub — и это Codex-скилл для GPT Pro review
• Блог: Notion Workers: GitHub-звёзды, база Notion и агент, который ими управляет
• База знаний: AGENTS.md / SESSION_NOTES — проектная память для coding-агентов

Если вы начинаете работать с GitHub и Codex и хотите разобраться, как встроить ИИ-агента в свой рабочий процесс, — это хорошая отправная точка.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov