Codex environments

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

In the ChatGPT desktop app, open the ChatGPT dropdown and select Codex. When starting a Codex chat, choose where it runs:

• Local: work directly in your current project directory.
• Worktree: isolate changes in a Git worktree. Learn more.
• Cloud: run remotely in a configured cloud environment.

Both Local and Worktree chats run on your computer.

For the full glossary and concepts, explore the concepts section.

<CodexScreenshot alt="New chat composer with Local, Worktree, and Cloud environment options" lightSrc="/images/codex/app/modes-light.webp" darkSrc="/images/codex/app/modes-dark.webp" maxHeight="400px" class="my-8" />