Codex cloud
Run coding tasks in parallel cloud environments
Run tasks in isolated cloud environments, work in parallel, and start work from the web, GitHub, GitLab, Linear, or Slack.
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.
Quickstart
Set up Codex cloud
Connect GitHub or GitLab, create an environment, and start your first cloud chat.
-
Open Codex and sign in
Go to Codex and sign in with your ChatGPT account.
-
Connect GitHub or GitLab
Connect 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).
-
Create an environment
Open environment settings and create an environment for the repository you selected. Configure any dependencies, tools, environment variables, or secrets the task needs.
For configuration details, see Cloud environments.
-
Start your first task
Return to Codex, choose your environment, and describe the result you want. You can watch the task logs or let the task run in the background.
-
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.
See what Codex cloud can do
Give each task the environment it needs, then review the result on your schedule.
Delegate several tasks
Start work in parallel and return as each task reaches a reviewable result.
Delegate several tasksBuild a reproducible environment
Configure the dependencies, tools, variables, and setup steps a repository needs.
Build a reproducible environmentDelegate from your integrations
Start work in Codex cloud from GitHub pull requests, GitLab merge requests and issues, Linear issues, or Slack channels and threads.
Delegate from your integrationsUse Codex cloud when…
- Work needs to run in the background
- Delegate a longer task and return when it is ready.
- You want to compare several attempts
- Run tasks in parallel without tying up your local machine.
- Work starts in GitHub, GitLab, Linear, or Slack
- Use integrations to hand off work without leaving the pull request, merge request, issue, channel, or thread.
- You are away from your development machine
- Start and review work from the web or Codex CLI.