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

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

Документация сверена 3 октября 2026 года. Пример страницы и файлового сервера проверен локально. Codespace не создавался; облачные порты, политики аккаунта и биллинг запуском не проверялись.

Чем среда отличается от браузерного редактора

github.dev редактирует файлы в браузере. У него нет машины для выполнения команд. Codespaces предоставляет такую машину: можно открыть терминал, установить предусмотренные проектом зависимости и запустить приложение.

Codespace — конкретная рабочая среда. Она связана с репозиторием и веткой, но имеет собственные файлы и состояние. Контейнер разработки задаёт инструменты и настройки, которые нужны проекту. Его конфигурация часто находится в .devcontainer/devcontainer.json; при её отсутствии используется стандартная среда. Введение в контейнеры разработки.

Перед созданием среды для чужого проекта прочитайте README, настройки контейнера, Dockerfile и команды подготовки. Часть действий может выполняться автоматически при создании. Если для задачи достаточно исправить текст, запуск Codespaces может вообще не понадобиться.

Доступ, вычисления и хранение

До создания проверьте, кто оплачивает среду, какую конфигурацию разрешает аккаунт или организация и сколько включённого использования осталось. Codespaces учитывает вычисления и хранение; более мощная машина расходует вычислительную квоту быстрее.

Остановка прекращает вычислительную работу, но сохранённая среда продолжает занимать хранилище. Закрытие вкладки не равнозначно остановке. Точные условия смотрите в GitHub Codespaces billing и настройках своего аккаунта.

Для первого примера достаточно минимальной доступной машины. Если организация запрещает Codespaces или квота исчерпана, это нужно решить отдельно; ошибка не является основанием включать дополнительную оплату автоматически.

Создайте среду для нужной ветки

Откройте разрешённый репозиторий, нажмите Code → Codespaces. Для выбора параметров используйте меню New with options: проверьте репозиторий, ветку и тип машины, затем подтвердите создание.

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

В рабочем проекте следуйте его действующей инструкции. Для знакомства без сборки можно использовать одну HTML-страницу в своём отдельном репозитории. Сохраните в корне index.html:

<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Портфолио студии</title>
</head>
<body>
  <main>
    <h1>Портфолио студии</h1>
    <p>Проекты, которые показывают подход к работе.</p>
    <ul>
      <li>Личный сайт</li>
      <li>Библиотека инструкций</li>
    </ul>
  </main>
</body>
</html>

Это самостоятельный пример без внешних зависимостей. Он нужен для понимания preview; новую среду для него создавайте только после проверки условий своего аккаунта.

Запустите страницу и откройте порт

В терминале папки с index.html выполните:

python3 --version
python3 -m http.server 8000 --bind 0.0.0.0

Вторая команда запускает сервер файлов текущей папки и остаётся работающей. Для preview используйте папку только с предназначенными для просмотра файлами: сервер может отдать и другие файлы этой папки по их адресам. Если Python отсутствует, проверьте конфигурацию окружения: не заменяйте предусмотренный запуск случайной установочной командой.

Сервер слушает порт 8000 в Codespace. Чтобы браузер на вашем компьютере получил доступ, этот порт нужно пробросить: Codespaces создаёт адрес для подключения к облачному процессу.

В панели Ports найдите 8000; если его нет, выберите Forward a Port и добавьте номер. Проверьте видимость Private, затем откройте Open in Browser. В приватном режиме доступ требует соответствующей авторизации. Проброс и видимость портов.

Ожидается страница «Портфолио студии» с двумя пунктами. Адрес localhost внутри среды относится к облачной машине. Полученный preview — временный доступ к процессу, а не постоянная публикация сайта.

Если открылся список файлов, проверьте, из какой папки запущен сервер и где лежит index.html. Если страница недоступна — состояние процесса, номер порта, проброс и авторизацию.

Измените файл и отправьте результат

В редакторе поменяйте название студии в title и h1, сохраните файл и обновите preview. Проверьте заголовок вкладки и текст страницы.

Откройте Source Control, прочитайте diff — разницу между версиями. Выберите только нужные файлы, создайте коммит с понятным сообщением и отправьте его через Push или доступную синхронизацию. Проверьте направление синхронизации, особенно если в удалённой ветке появились новые изменения.

Затем откройте GitHub.com, выберите ту же ветку и прочитайте сохранённый файл и последний коммит. Файл в Codespace и даже локальный коммит ещё не гарантируют, что работа отправлена на GitHub. Для включения правки в основную ветку используйте процедуру проекта и PR.

Остановите среду, когда работа закончена

Остановите файловый сервер через Ctrl+C в его терминале. На странице Codespaces найдите конкретную среду и выберите Stop codespace в её меню. Перечитайте состояние. Остановка и возобновление среды.

Для продолжения ту же среду можно запустить снова. Если она больше не нужна, сначала проверьте на GitHub отправленные коммиты и отдельно сохраните нужные файлы вне репозитория. Затем удалите именно эту среду через Delete, подтвердив её имя.

Удаление уничтожает оставшиеся в ней данные и освобождает её хранилище. Уже возникшие расходы не отменяются. Одного коммита без отправки недостаточно для сохранности работы вне удаляемой среды.

Полезные сценарии

Посмотреть небольшой сайт без локальной установки. Вход — разрешённый проект с понятным запуском. Создайте среду, запустите сервер, откройте приватный порт и проверьте страницу. Получите preview и сохранённую правку. Для постоянного сайта нужен отдельный хостинг и публикационный процесс.

Поработать с командным окружением. В проекте есть проверенная конфигурация контейнера. Создайте Codespace для нужной ветки и следуйте README, затем сопоставьте результаты штатных проверок с коммитом. Среда уменьшает ручную настройку, но не гарантирует исправность проекта или отсутствие затрат.

Вернуться к работе с другого компьютера. Откройте свою сохранённую среду под нужным аккаунтом, проверьте ветку и незавершённые изменения, продолжите работу. Результат остаётся в том же Codespace до отправки. Автоматическое удаление старых сред и ограничения хранения нужно учитывать отдельно.

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

Следующий шаг

Когда временного preview недостаточно, выберите процесс постоянной публикации: GitHub Pages — бесплатный хостинг статических сайтов прямо из GitHub.

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

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