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

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.

A published environment lets you reuse the same setup across tasks.

01

Start with or without a repository

If the default environment is available, you can start without choosing a repository. You can also ask Codex to check out any repository available to Codex through your connected GitHub or GitLab account.

02

Keep work moving

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

Choose where to run your first task. If you want the same repositories and tools for future tasks, you can create and publish a reusable environment.

  1. Choose Cloud

    Sign in to ChatGPT. On the web or in the desktop app, start a chat and choose Work in > Cloud. On mobile, open Codex.

  2. Choose an environment

    If you see the default environment, select it to start without choosing a repository. To use a setup someone has already prepared, select a published environment. In Enterprise workspaces, select a published environment you can access.

  3. Send your first task

    Try a task that needs no repository, such as “Write a Python script that finds duplicate files by content. Test it on sample files.” Review the script and test results, then ask for any changes in the same chat.

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.