ВойтиПолучить доступ

Настройки Claude Code10 минобновлено

Codex Cloud: как настроить окружение и запустить первую задачу

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

Здесь речь об облачном режиме OpenAI Codex, а не об одноимённых сервисах хранения текстов. Порядок и названия кнопок сверены с документацией OpenAI 20.10.2026. Это инструкция по документации: личный запуск в аккаунте не проводился.

Как подготовиться к первой задаче Codex Cloud?

Выбери учебный GitHub-репозиторий - хранилище файлов проекта, которое тебе разрешено передавать в облако. Для первой попытки подойдёт небольшой проект с README и понятными командами проверок. Не подключай рабочую базу клиентов или продакшен-секреты ради знакомства с инструментом.

Нужен аккаунт ChatGPT с доступом к облачным задачам. В рабочем пространстве организации доступ также контролирует администратор. Если кнопок Cloud нет, сначала проверь аккаунт, пространство и разрешения. Покупка API-кредитов не является шагом этой инструкции: различия способов доступа разобраны в статье Codex и API.

Разделяй две вещи:

  • Окружение хранит общую подготовку: репозитории, зависимости, инструменты и доступы.
  • Задача получает собственные рабочие файлы из опубликованного окружения. Правки одной задачи не становятся автоматически правками другой.

Облачная среда также отличается от локального worktree. Установка CLI на твоём компьютере не готовит зависимости на машине OpenAI.

Как создать и опубликовать окружение?

Коротко: Сначала проверь подготовку проекта, затем нажми Publish и дождись Environment published. Кнопка Save сохраняет конфигурацию, но не заменяет публикацию подготовленной среды.

  1. Открой новую задачу в веб-интерфейсе или настольном приложении. Войди в нужный аккаунт ChatGPT.
  2. Выбери Work in > Cloud > Select environment > Create environment. Другой вход - Settings > Codex Cloud > Environments > Create environment.
  3. Выбери GitHub-репозиторий. Если появится запрос, подключи GitHub. Убедись, что выбран именно учебный проект, а не соседний рабочий репозиторий.
  4. Нажми Get started. Codex изучит файлы, начнёт готовить зависимости и инструменты, проверит рабочий процесс. Если запросит недостающие сведения, укажи версии или команды из документации своего проекта.
  5. Проверь отчёт подготовки, конфигурацию и файлы. Если команда не выполнилась, выясни причину до публикации. Сохрани изменения и нажми Publish.
  6. Дождись Environment published. Только после этого нажми Start a new task.

Слово Publish здесь означает публикацию окружения для задач. Это не выкат сайта и не отправка кода в основную ветку.

При подготовке не обязательно писать установочный скрипт самостоятельно. После Get started, пока окружение ещё не опубликовано, дай агенту конкретное поручение. В запросе manifest означает файл со списком зависимостей проекта, а lockfile - файл с закреплёнными версиями пакетов:

Подготовь этот репозиторий для облачных задач.
Сначала прочитай README и файлы зависимостей. Определи нужные версии
инструментов и существующие команды проверок. Не придумывай команды.
Покажи, что установлено и какие проверки реально запущены.
Если чего-то не хватает, укажи точный шаг и спроси недостающие сведения.
Не меняй исходники, manifest и lockfile. Не печатай значения секретов.

В конфигурации есть два разных поля. Install script содержит команды установки зависимостей и подготовки ресурсов проекта. Start skill описывает запуск сервисов и проверку их готовности. Сверь оба с задачей: установленный пакет ещё не означает, что нужный сервис запущен.

Если для исправления подготовки надо менять исходники, файл зависимостей или lockfile, документация рекомендует сделать это в задаче программирования, затем вернуться к подготовке среды. Не принимай бесконечное повторение упавшей команды за исправление.

Как настроить сеть и не раскрыть секреты?

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

В конфигурации включи Allow Codex to access internet, если проекту нужна сеть. В Allow domains выбери подходящий набор: Package managers для менеджеров пакетов либо Custom domains only для своего списка. Дополнительные адреса укажи в Additional allowed domains. Не начинай с All (unrestricted) только ради устранения любой сетевой ошибки.

В разделе настроек значений нажми Manage рядом с нужным типом:

Что нужно программе Куда добавить Что важно проверить
Непосредственно прочитать значение, например режим development Environment variables Значение передаётся программе напрямую. Задача может его видеть
Передать учётные данные определённому HTTPS-сервису Network secrets Программа получает значение-заглушку. При отправке запроса прокси подставляет настоящий секрет только для разрешённого адресата

У сетевого секрета укажи Key, Value и Allowed domains. Не используй тот же Key одновременно для прямой переменной. В новом Codex Cloud подстановка работает при подготовке и выполнении задач для HTTPS на порту 443.

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

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

Для общей среды личные значения хранятся в Settings > Codex Cloud > Personal vault. Проверь совпадение Key и область Applies to. Перед передачей среды коллегам отдельно просмотри подготовленные файлы, общие учётные данные и подключения: личное хранилище и секреты самого окружения имеют разные условия доступа.

Как запустить первую задачу и проверить результат?

Начни с чтения проекта без изменения файлов. Затем поручай одну небольшую правку с заранее заданным критерием. Не ставь первой задачей полную переделку приложения.

После Start a new task проверь выбранное окружение и отправь запрос. В нём commit означает сохранение изменений в истории Git, push - отправку на GitHub, pull request - запрос на включение правки в проект:

Пока не меняй файлы и не устанавливай новые пакеты.
Назови репозиторий и ветку, которые ты видишь.
Прочитай README и конфигурацию проекта. Найди существующие команды
проверок и объясни, какую из них можно безопасно выполнить сейчас.
Если проверка может менять данные, обращаться к платному сервису
или требует секрета, остановись и объясни условие.
Безопасную проверку выполни и покажи команду, результат и ограничения.
Если подходящей проверки нет, так и напиши, не добавляй её сам.
Не делай commit, push или pull request. Не показывай значения секретов.

Это учебный запрос, а не лог уже выполненного опыта. Ожидаемый отчёт должен содержать правильный репозиторий, выбранную команду и её фактический результат. Формулировка агента «всё готово» не заменяет эти сведения.

Когда исходное состояние понятно, продолжи ту же задачу. Diff в запросе ниже - сравнение файла до и после правки:

Измени только README.md: добавь раздел «Проверка проекта».
Укажи только подтверждённую команду из предыдущего ответа
и коротко объясни, что она проверяет.
Если безопасной команды не найдено, ничего не меняй и объясни почему.
Не меняй код, зависимости, lockfile и другие файлы.
Не делай commit, push или pull request.
После правки покажи diff и полный список изменённых файлов.

Принимай работу по наблюдаемому результату:

  • В списке изменений только README.md. Любое другое изменение требует объяснения до переноса работы.
  • В новом разделе настоящая команда этого проекта. Она совпадает с прочитанной конфигурацией.
  • Diff показывает только добавленный раздел, без случайно удалённого текста.
  • Отчёт различает выполненные, пропущенные и упавшие проверки. Пропуск из-за отсутствия доступа не считается успехом.
  • Коммит, push и PR не созданы по этому поручению.

Если задача отклонилась от условий, продолжи её уточнением. Изменения и результаты тестов нужно просмотреть до коммита или открытия pull request - запроса на включение правки в проект. Общий порядок работы агента разобран отдельно: как устроен агент Codex.

Для следующих задач задай постоянные правила проекта: какие файлы можно менять, как проверять результат, когда останавливаться. Посмотри в программе ClaudeBase урок о правилах проекта и разрешениях и шаблон AGENTS.md в составе базы. Программа открыта без оплаты; уроки и материалы базы доступны по подписке. Подписки Anthropic и OpenAI оплачиваются отдельно.

Что проверить, если задача не запускается?

Сначала найди этап сбоя. Ошибка подготовки, отсутствие прав на GitHub и недоступный адрес пакета требуют разных действий.

Что видишь Что проверь Что сделать дальше
У среды стоит Unpublished Завершены ли подготовка и публикация Устрани незавершённые пункты, выбери Publish и дождись подтверждения
GitHub подключён, но проект недоступен Выбран ли репозиторий и есть ли права у твоего GitHub-аккаунта Исправь подключение или права. Доступ к общей среде их не заменяет
Установка падает на конкретной команде Точный текст ошибки и наличие нужного инструмента Исправь причину, повтори команду; при сбое начальной подготовки можно выбрать Try again
Пакет или API не отвечает Имя конечного хоста, список доменов и авторизацию по отдельности Добавь недостающий разрешённый адресат либо исправь учётные данные. Не открывай всю сеть автоматически
Сетевой секрет не подставляется Allowed domains, точный хост, HTTPS и порт 443 Исправь соответствие; проверь запрос без вывода токена
После обновления среды задача видит старые инструменты Выполнен ли Republish и начата ли новая задача Переопубликуй подготовку и начни новую задачу. Старую это не обновит

В Enterprise также действуют правила Agent Security организации. Настройки доменов окружения не отменяют их. Если ошибка остаётся, передай администратору этап и текст ошибки без секретов.

Как вернуться к работе и обновить окружение?

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

Чтобы изменить общую подготовку, открой Settings > Codex Cloud > Environments, меню с тремя точками и выбери Edit. Опиши изменение, дождись подготовки и проверки, сохрани его и нажми Republish. Для использования новой подготовки начни новую задачу.

По справке OpenAI на 20.10.2026 состояние виртуальной машины по умолчанию восстанавливается до 7 дней с начала последнего хода или возобновления задачи. Это не срок хранения переписки и не резервная копия Git. Важную работу фиксируй в системе контроля версий, нужные результаты сохраняй отдельно.

Локальные личные скиллы с компьютера в облачное окружение автоматически не синхронизируются. Документация указывает доступность скиллов, сохранённых в репозитории. Для выбора дополнительных инструкций есть каталог скиллов ClaudeBase, но сначала закончи базовую проверку окружения.

Какие ограничения тебе нужно учесть?

Эта инструкция относится к новому Codex Cloud. Codex Cloud (Legacy) отдельно обслуживает прежние сценарии ревью и интеграций во время перехода. Не смешивай поля старого окружения с Install script и Start skill нового.

По документации на 20.10.2026 в новых облачных окружениях не поддерживаются computer/browser use, GitLab и self-hosted GitHub Enterprise Server. Не поручай первой задаче управлять браузером как условием успешной настройки.

Обычного GitHub-проекта достаточно для описанного сценария. Для внутренних HTTP/HTTPS-сервисов существует отдельная настройка VPN с Tailscale: нужны разрешения и в сети VPN, и в окружении. OIDC для краткосрочных доступов к облачным ресурсам доступен по запросу для Enterprise. Для первого учебного запуска эти подключения не обязательны.

Если позже будешь делиться средой в Enterprise, Privacy > Who can use управляет доступом к подготовке. Это не доступ к чужой задаче и не автоматическое право редактировать окружение. Проверь общие файлы и подключения до включения доступа коллегам.

Источники

Спрашивают

Пять вопросов по теме

Почему в аккаунте не видно кнопок Codex Cloud?

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

Почему GitHub подключён, но репозиторий недоступен?

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

Можно ли создать окружение Codex Cloud с телефона?

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

Почему новая настройка не появилась в старой задаче?

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

Сколько хранится состояние облачной машины?

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

Источники