Codex Manual

Choose a Surface

Codex has multiple entry points. Choose the one that matches your workflow.

SurfaceBest forUsers
CLILocal terminal workDevelopers comfortable with shells
AppDesktop UI, project threads, visual workflowGeneral users and developers
IDE ExtensionEditor-side helpVS Code, Cursor, Windsurf users
Web / CloudHosted tasks and PRs; also viewable and continuable from ChatGPT web and mobileTeams and remote workflows

Start with the App if you want a visual experience. Use the CLI if you want direct control over directories, permissions, profiles, and commands.

CLI:

cd your-project
codex

Useful subcommands: codex exec (non-interactive, for scripts and CI), codex resume (continue an earlier chat), codex cloud (browse and submit cloud tasks), and codex mcp (manage MCP servers). Inside a session, /init (create AGENTS.md), /status, /permissions, /model, and /review are the common slash commands.

App:

codex app

Use the IDE extension (VS Code extension ID openai.chatgpt; Cursor and Windsurf are supported) when you want Codex beside your editor. Xcode and JetBrains IDEs pick Codex as an agent from their own AI chat instead of using this extension. Use Web/Cloud when you want hosted work, PR generation, or parallel task execution: start a chat in the desktop app or web and choose Work in > Cloud, or use codex cloud in a terminal. Cloud tasks require signing in with ChatGPT and a connected GitHub or GitLab account for repositories.