Codex cloud
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending
.mdto 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, GitLab, Linear, or Slack.
Illustration: Codex cloud chat composer and chat list with interactive archiving
Start here
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 or GitLab, create an environment, and start your first cloud chat.
1. Open Codex and sign in
Go to Codex and sign in with your ChatGPT account.
2. 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).
3. 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.
4. 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.
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
- Configure agent internet access
- Use Codex with GitHub
- Use Codex with GitLab (Beta)
- Use Codex in Linear
- Use Codex in Slack
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.
- Build a reproducible environment: Configure the dependencies, tools, variables, and setup steps a repository needs.
- Delegate from your integrations: Start work in Codex cloud from GitHub pull requests, GitLab merge requests and issues, Linear issues, or Slack channels and threads.
Use 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.