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

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

Что такое GitHub

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

GitHub принадлежит Microsoft и используется более чем 150 миллионами разработчиков по всему миру (по разным оценкам — до 180 млн на 2026 год), а число репозиториев превысило 1 миллиард. Это стандарт индустрии.

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

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

Репозиторий (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, который работает и локально (CLI, десктоп, IDE), и в облаке. Его возможности:

• Читает ваш код и документацию
• Пишет новый код, тесты, README
• Создаёт Pull Request с изменениями
• Выполняет задачи параллельно в изолированных песочницах
• Работает по вашим инструкциям из файла AGENTS.md
• Новое в 2026: Computer Use (управляет десктоп-приложениями), Chrome-расширение, Memories, Remote SSH и мобильное управление; под капотом — модель GPT-5.2-Codex

Codex доступен на пяти поверхностях: CLI (терминал), Cloud/Web (через chatgpt.com/codex), Desktop App (macOS и Windows), IDE-расширение (VS Code, Cursor, Windsurf) и мобильное управление (iOS/Android через ChatGPT). Все они работают с 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 со страницы developers.openai.com/codex/app — приложение есть для macOS и Windows (на Windows работает без WSL, в том числе доступно в Microsoft Store)
2. Авторизуйтесь через ChatGPT-аккаунт
3. GitHub подключается автоматически при открытии локального репозитория
4. Если репозиторий имеет 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 и работает с ним.

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

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

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

Файл AGENTS.md в корне репозитория — инструкция, которую Codex читает перед каждой задачей. Это открытый стандарт: его курирует Agentic AI Foundation под эгидой Linux Foundation, и один и тот же файл читают 30+ агентов в более чем 60 000 репозиториев — не только Codex, но и Cursor, GitHub Copilot, Jules и другие.

# Project: my-project

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

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

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

Встроенный ИИ-агент GitHub: Copilot coding agent

Codex — не единственный вариант. У самого GitHub есть родной агент — GitHub Copilot coding agent, который не требует OpenAI Codex и живёт прямо внутри платформы.

Что он умеет:

• Облачный агент. Назначьте ему issue или поставьте задачу — он исследует репозиторий, составит план, внесёт изменения в отдельной ветке и откроет Pull Request на ваше ревью.
• Вкладка Agents прямо в репозитории — создавать, отслеживать и направлять задачи, не уходя со страницы проекта.
• Copilot CLI — агент в терминале: добавить фичу, починить баг и сразу открыть PR.
• Copilot memory — агент запоминает контекст вашего кода со временем.
• Copilot app — отдельное agent-native десктоп-приложение, представленное на Microsoft Build 2026.

Когда что выбрать: Codex удобен, если вы уже в экосистеме OpenAI/ChatGPT и работаете в нескольких средах сразу; Copilot coding agent — если хотите агента «из коробки» внутри GitHub, без сторонних подключений.

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

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

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

Нет. 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