1# Codex cloud1# Codex Cloud
2 2
3> 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.3> 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.
4 4
5## Run coding tasks in parallel cloud environments5## Run coding tasks in the cloud
6 6
7Run tasks in isolated cloud environments, work in parallel, and start work from the web, GitHub, GitLab, Linear, or Slack.7Give 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.
8 8
9> Illustration: Codex cloud chat composer and chat list with interactive archiving9> Illustration: A published cloud environment beside a new task composer with the same environment selected
10 10
11### Start here11### Start here
12 12
13- [Open Codex cloud](https://chatgpt.com/codex)13- [Get started](#getting-started)
14- [Set up Codex cloud](#getting-started)
15 14
16### Why use Codex cloud15### Why use Codex Cloud
17 16
18- **Run work in parallel:** Give longer tasks dedicated environments and let them continue while you work on something else.17- **Start with your project:** Choose repositories. Codex inspects the project, works through setup, and asks you for missing details or access.
19- **Reproduce the environment:** Configure the dependencies, tools, variables, and setup steps each repository needs.18- **Keep work moving:** Start tasks from a published environment. Each task has its own workspace and can keep working while your computer is asleep.
20- **Review before you merge:** Inspect the summary and diff, request a follow-up, or open a pull request when the result is ready.19- **Review the work:** Inspect changed files and check results, request follow-up changes, and commit or open a pull request when you're ready.
21 20
22## Getting started21## Getting started
23 22
24**Set up Codex cloud.**23**Get started with Codex Cloud.**
25 24
26Connect GitHub or GitLab, create an environment, and start your first cloud chat.25Create a cloud environment with the repositories, tools, and access your project needs, or select an existing one. Then start a task.
27 26
28### 1. Open Codex and sign in27### 1. Open ChatGPT
29 28
30Go to [Codex](https://chatgpt.com/codex) and sign in with your ChatGPT account.29Open ChatGPT on the web or in the [desktop app](https://learn.chatgpt.com/docs/app), then sign in with your ChatGPT account.
31 30
32### 2. Connect GitHub or GitLab31### 2. Create or select an environment
33 32
34Connect GitHub or GitLab (Beta) when prompted. For GitHub, choose the repositories Codex can access; for GitLab, select a project when you create the environment. For GitLab setup, webhook permissions, and merge request reviews, see [Use Codex with GitLab (Beta)](https://learn.chatgpt.com/docs/third-party/gitlab).33In a new task, choose Work in > Cloud and open Select environment. If this is your first time, select [Create environment](https://learn.chatgpt.com/docs/environments/cloud-environments#create-and-publish-an-environment) and continue below. If an environment is already available, select it and begin working.
35 34
36### 3. Create an environment35### 3. Let Codex prepare your project
37 36
38Open [environment settings](https://chatgpt.com/codex/settings/environments) and create an environment for the repository you selected. Configure any dependencies, tools, environment variables, or secrets the task needs.37Choose 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.
39 38
40For configuration details, see [Cloud environments](https://learn.chatgpt.com/docs/environments/cloud-environment).39### 4. Review and publish
41 40
42### 4. Start your first task41For a new environment, review the setup and test results, save changes, and select Publish. Wait for Environment published.
43 42
44Return 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.43### 5. Start a task
45 44
46### 5. Review the result45After 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.
47
48Review the summary and diff. Ask Codex to make follow-up changes, or open a pull request when the work is ready.
49 46
50### Next steps47### Next steps
51 48
52- [Customize the cloud environment](https://learn.chatgpt.com/docs/environments/cloud-environment)49- [Configure cloud environments](https://learn.chatgpt.com/docs/environments/cloud-environments)
53- [Configure agent internet access](https://learn.chatgpt.com/docs/cloud/internet-access)50- [Configure internet access](https://learn.chatgpt.com/docs/environments/cloud-environments#connect-to-services)
54- [Use Codex with GitHub](https://learn.chatgpt.com/docs/third-party/github)51- [Set up environment variables and network secrets](https://learn.chatgpt.com/docs/environments/cloud-environments#configure-environment-variables-and-network-secrets)
55- [Use Codex with GitLab (Beta)](https://learn.chatgpt.com/docs/third-party/gitlab)52- [Understand saved state](https://learn.chatgpt.com/docs/environments/cloud-environments#reuse-and-update-saved-state)
56- [Use Codex in Linear](https://learn.chatgpt.com/docs/third-party/linear)53- [Use ChatGPT in Slack](https://learn.chatgpt.com/docs/third-party/slack)
57- [Use Codex in Slack](https://learn.chatgpt.com/docs/third-party/slack)
58 54
59## See what Codex cloud can do55## See what Codex Cloud can do
60 56
61Give each task the environment it needs, then review the result on your schedule.57Run coding tasks with your project tools and service access, then review the results.
62 58
63- [Delegate several tasks](https://learn.chatgpt.com/docs/environments/cloud-environment): Start work in parallel and return as each task reaches a reviewable result.59- [Prepare your development workflow](https://learn.chatgpt.com/docs/environments/cloud-environments#create-and-publish-an-environment): Let Codex inspect your repositories and prepare their dependencies and tools. Review the checks before publishing.
64- [Build a reproducible environment](https://learn.chatgpt.com/docs/environments/cloud-environment): Configure the dependencies, tools, variables, and setup steps a repository needs.60- [Reuse your project setup](https://learn.chatgpt.com/docs/environments/cloud-environments#reuse-and-update-saved-state): Reuse your repositories, dependencies, and tools across tasks. Each task has its own workspace. Update the setup as your project changes.
65- [Delegate from your integrations](https://learn.chatgpt.com/docs/developers): Start work in Codex cloud from GitHub pull requests, GitLab merge requests and issues, Linear issues, or Slack channels and threads.61- [Connect your tools and services](https://learn.chatgpt.com/docs/environments/cloud-environments#connect-to-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.
66 62
67## Use Codex cloud when…63## Use Codex Cloud when…
68 64
69- [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.65- [Work should run remotely](https://learn.chatgpt.com/docs/environments/cloud-environments): Give Codex a cloud environment with the repositories and tools it needs.
70- [You want to compare several attempts](https://learn.chatgpt.com/docs/environments/cloud-environment): Run tasks in parallel without tying up your local machine.66- [Several tasks need the same setup](https://learn.chatgpt.com/docs/environments/cloud-environments): Start tasks from a published environment while keeping each task's working state separate.
71- [Work starts in GitHub, GitLab, Linear, or Slack](https://learn.chatgpt.com/docs/developers): Use integrations to hand off work without leaving the pull request, merge request, issue, channel, or thread.67- [Your workflow needs service credentials](https://learn.chatgpt.com/docs/environments/cloud-environments#connect-to-services): Use network secrets for allowed HTTPS services and limit the environment's network destinations.
72- [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.68- [Start cloud work from the CLI](https://learn.chatgpt.com/docs/developer-commands?surface=cli#cli-codex-cloud): Start a task from your terminal, or list recent cloud chats and check their status.