# Codex cloud

> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.

## Run coding tasks in parallel cloud environments

Run tasks in isolated cloud environments, work in parallel, and start work from the web, GitHub, Linear, or Slack.

> Illustration: Codex cloud chat composer and chat list with interactive archiving

### Start here

- [Open Codex cloud](https://chatgpt.com/codex)
- [Set up Codex cloud](#getting-started)

### Why use Codex cloud

- **Run work in parallel:** Give longer tasks dedicated environments and let them continue while you work on something else.
- **Reproduce the environment:** Configure the dependencies, tools, variables, and setup steps each repository needs.
- **Review before you merge:** Inspect the summary and diff, request a follow-up, or open a pull request when the result is ready.

## Getting started

**Set up Codex cloud.**

Connect GitHub, create an environment, and start your first cloud chat.

### 1. Open Codex and sign in

Go to [Codex](https://chatgpt.com/codex) and sign in with your ChatGPT account.

### 2. Connect GitHub

Connect your GitHub account when prompted, then choose the repositories that Codex can access.

### 3. Create an environment

Open [environment settings](https://chatgpt.com/codex/settings/environments) and create an environment for your repository. Configure any dependencies, tools, environment variables, or secrets the task needs.

For configuration details, see [Cloud environments](https://learn.chatgpt.com/docs/environments/cloud-environment).

### 4. Start your first task

Return to [Codex](https://chatgpt.com/codex), choose your environment, and describe the result you want. You can watch the task logs or let the task run in the background.

### 5. Review the result

Review the summary and diff. Ask Codex to make follow-up changes, or open a pull request when the work is ready.

### Next steps

- [Customize the cloud environment](https://learn.chatgpt.com/docs/environments/cloud-environment)
- [Configure agent internet access](https://learn.chatgpt.com/docs/cloud/internet-access)
- [Use Codex with GitHub](https://learn.chatgpt.com/docs/third-party/github)
- [Use Codex in Linear](https://learn.chatgpt.com/docs/third-party/linear)
- [Use Codex in Slack](https://learn.chatgpt.com/docs/third-party/slack)

## See what Codex cloud can do

Give each task the environment it needs, then review the result on your schedule.

- [Delegate several tasks](https://learn.chatgpt.com/docs/environments/cloud-environment): Start work in parallel and return as each task reaches a reviewable result.
- [Build a reproducible environment](https://learn.chatgpt.com/docs/environments/cloud-environment): Configure the dependencies, tools, variables, and setup steps a repository needs.
- [Delegate from your integrations](https://learn.chatgpt.com/docs/developers): Start work in Codex cloud from GitHub pull requests, Linear issues, or Slack channels and threads.

## Use Codex cloud when…

- [Work needs to run in the background](https://learn.chatgpt.com/docs/environments/cloud-environment): Delegate a longer task and return when it is ready.
- [You want to compare several attempts](https://learn.chatgpt.com/docs/environments/cloud-environment): Run tasks in parallel without tying up your local machine.
- [Work starts in GitHub, Linear, or Slack](https://learn.chatgpt.com/docs/developers): Use integrations to hand off work without leaving the pull request, issue, channel, or thread.
- [You are away from your development machine](https://learn.chatgpt.com/docs/environments/cloud-environment): Start and review work from the web or Codex CLI.