Codex Remote
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending
.mdto the page URL.
Start, guide, and review coding tasks from your phone
Follow progress, approve actions, and send instructions from your phone. Codex runs each task on your connected computer.
Use the ChatGPT mobile app with a connected Mac or Windows PC. Availability depends on rollout and your workspace settings.
Illustration: Interactive Codex Remote mobile app showing connected computers, tasks, conversations, approvals, and changed files
Start here
Codex Remote advantages
- Start tasks from your phone: Choose a connected computer and project, describe the task, and let Codex get to work.
- Guide work as it happens: Open a task, follow its progress, and send new instructions without returning to your desk.
- Approve requested actions: Review requested commands and actions before Codex continues on your connected computer.
- Review the result: Inspect responses, changed files, diffs, and test results, then decide what happens next.
Get started with Remote
Connect your computer, approve access, and start your first task.
- Start setup on your computer. Open the ChatGPT desktop app on your Mac or Windows PC. Go to Settings > Connections > Control this Mac or PC and select Set up or Add. Approve remote access and complete any requested verification.
- Scan the QR code. Scan the code with your phone, sign in to the same ChatGPT account and workspace, and approve the connection. Only connect devices you own and trust.
- Start working from your phone. Open Remote in the ChatGPT mobile app, choose your connected computer, and start a new task or continue an existing one. Keep your computer awake and online.
Keep work moving from anywhere
Start, approve, and review tasks from your phone. Your connected computer runs the work under your organization’s security policies.
1. See tasks running on your computer
Follow active tasks across connected computers, pick up existing conversations, and see when your input is needed.
Illustration: Codex Remote task list showing active tasks on a connected computer
2. Approve requests
Review commands and requested actions before Codex continues working on your connected computer.
Illustration: Codex Remote approval request for a terminal command
3. Review changed code
Inspect changed files and diffs from your phone before deciding what happens next.
Illustration: Codex Remote changed-files review with code differences
4. Start new tasks
Choose a connected computer and project, describe the task, and let Codex get to work.
Illustration: Codex Remote new-task composer for a connected computer
Explore setup and security
Learn about computer requirements, device management, permissions, and troubleshooting.