Codex Mobile App: How to Use OpenAI Codex From Your Phone

By CodeAgentSwarm · Updated October 31, 2026

OpenAI does not ship a standalone Codex app for phones. Codex on mobile lives inside the ChatGPT app for iOS and Android, and it connects to Codex Cloud or to a Mac or Windows PC running the ChatGPT desktop app. That covers a lot of people. It does not cover the Codex CLI you run in a terminal: OpenAI's docs say mobile setup cannot be started from the CLI or the IDE extension. This guide explains the official option first, then how the CodeAgentSwarm phone app reaches Codex sessions that run on your own computer, on top of the Codex CLI you already installed.

What OpenAI offers: Codex in the ChatGPT app

According to OpenAI's Codex on mobile page, you use the ChatGPT mobile app to start tasks, follow progress, send new instructions, approve or deny commands, and review changed files, diffs and test results. The tasks run in Codex Cloud or on a connected computer.

How to set it up

  • On your Mac or PC, open the ChatGPT desktop app and go to Settings > Connections > Control this Mac or PC.
  • Scan the QR code with your phone, sign in to the same ChatGPT account and workspace, and approve the connection.
  • In the ChatGPT app, open Codex, choose your computer and start or continue a task.

Requirements and limits

  • Codex access in your ChatGPT account and workspace, and the latest ChatGPT mobile app.
  • The computer must run the ChatGPT desktop app on macOS or Windows and stay awake, online and signed in to the same account.
  • If you use Codex through a workspace, your admin may need to enable Remote Control access. Availability depends on rollout and workspace settings.
  • OpenAI's Remote connections page says you cannot set this up from the Codex CLI or the IDE extension, and it does not list Linux as a host.

If you run Codex CLI in a terminal

Plenty of developers use Codex as a CLI, often next to Claude Code, and sometimes on Linux. For that setup the official mobile option does not apply, because it pairs the phone with the ChatGPT desktop app, not with the codex command.

CodeAgentSwarm fills that gap. It is a desktop app for macOS, Windows and Linux where you run Codex, Claude Code and other agents side by side (see Codex GUI). In its Chat view, Codex runs through the Codex CLI installed on your computer, with your own login. The phone app pairs with CodeAgentSwarm, so those Codex Chat sessions show up on the phone. A session you switch to the raw Terminal (CLI) view is not reachable from the phone until you switch it back to Chat.

Use Codex from the CodeAgentSwarm phone app

CodeAgentSwarm for iPhone and Apple Watch on the App Store
CodeAgentSwarm for iPhone and Apple Watch. Android is in beta and there is a web app.

Setup

  • Install the phone app: App Store for iPhone, the Android beta (request it in the #mobile-relay-beta Discord channel) or the web app at web.codeagentswarm.com.
  • In CodeAgentSwarm on your computer, sign in, open the account menu and choose Connect a device.
  • Scan the QR code (or type the one-time code in the web app), check that the verification code matches on both devices and accept the phone on the computer.

What you can do

  • See every Codex Chat session with its status, next to your Claude Code and other agent sessions.
  • Reply, answer questions and approvals, and start a new Codex session in one of your projects.
  • Attach photos and files, or dictate a voice note that becomes editable text.
  • Get a notification on iPhone or Android when a session needs you.

Codex keeps running on your computer with the login it already has. The phone and the computer talk through an end-to-end encrypted relay, so the relay cannot read your conversations.

Side by side

Codex in the ChatGPT appCodeAgentSwarm phone app
Desktop sideChatGPT desktop app (macOS, Windows) or Codex CloudCodeAgentSwarm (macOS, Windows, Linux)
Uses the Codex CLI on your computerNot a supported setupYes, for sessions in Chat view
Other agentsCodexCodex, Claude Code, OpenCode and the other agents in CodeAgentSwarm
Work with the computer offYes, with Codex CloudNo, the computer must be on

If you live in the ChatGPT desktop app, OpenAI's own option is the natural choice. If your Codex is a CLI, or you run it with other agents, the CodeAgentSwarm app is the one that reaches it. Running Claude Code too? See how to control Claude Code from your phone.

FAQ

Is there a Codex mobile app?

Not a separate one. Codex on mobile is part of the ChatGPT app for iOS and Android. It connects to Codex Cloud or to a Mac or Windows PC running the ChatGPT desktop app.

Can I use the Codex CLI from my phone?

OpenAI's docs say the mobile connection cannot be set up from the Codex CLI or the IDE extension. To reach Codex on your computer from your phone, run it in CodeAgentSwarm Chat (it uses your installed Codex CLI) and pair the CodeAgentSwarm phone app. Sessions in the raw Terminal (CLI) view are not reachable from the phone.

Does Codex on mobile work with Linux?

OpenAI's Remote connections page lists the ChatGPT desktop app on macOS and Windows as hosts, plus SSH hosts added from that app. CodeAgentSwarm runs on Linux, so its phone app can reach Codex sessions on a Linux computer.

Does my computer need to stay on?

For any session that runs on your computer, yes. Only Codex Cloud tasks keep going with the computer off.