For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation

Codex Cloud

Run coding tasks in the cloud

Give Codex coding tasks to work through in the cloud, from investigating bugs to building features. Review changes and continue from the web, mobile, or desktop app.

01

Start with your project

Choose repositories. Codex inspects the project, works through setup, and asks you for missing details or access.

02

Keep work moving

Start tasks from a published environment. Each task has its own workspace and can keep working while your computer is asleep.

03

Review the work

Inspect changed files and check results, request follow-up changes, and commit or open a pull request when you're ready.

Quickstart

Get started with Codex Cloud

Create a cloud environment with the repositories, tools, and access your project needs, or select an existing one. Then start a task.

  1. Open ChatGPT

    Open ChatGPT on the web or in the desktop app, then sign in with your ChatGPT account.

  2. Create or select an environment

    In a new task, choose Work in > Cloud and open Select environment. If this is your first time, select Create environment and continue below. If an environment is already available, select it and begin working.

  3. Let Codex prepare your project

    Choose your GitHub repositories and select Get started. Connect GitHub if prompted. Codex inspects your repositories, installs dependencies and tools, and tests the workflow. Provide any missing access or information when asked.

  4. Review and publish

    For a new environment, review the setup and test results, save changes, and select Publish. Wait for Environment published.

  5. Start a task

    After publishing a new environment, select Start a new task. If you selected an existing environment, you can start right away. Describe your task and send it. Review the changes and test results, request follow-ups, and commit or open a pull request when ready.

See what Codex Cloud can do

Run coding tasks with your project tools and service access, then review the results.

01

Prepare your development workflow

Let Codex inspect your repositories and prepare their dependencies and tools. Review the checks before publishing.

Learn more
02

Reuse your project setup

Reuse your repositories, dependencies, and tools across tasks. Each task has its own workspace. Update the setup as your project changes.

Learn more
03

Connect your tools and services

Give Codex access to the package registries, APIs, and private services your project needs. Configure network access and supply credentials in the environment settings.

Learn more

Use Codex Cloud when…

Work should run remotely

Give Codex a cloud environment with the repositories and tools it needs.

Several tasks need the same setup

Start tasks from a published environment while keeping each task's working state separate.

Your workflow needs service credentials

Use network secrets for allowed HTTPS services and limit the environment's network destinations.

Start cloud work from the CLI

Start a task from your terminal, or list recent cloud chats and check their status.