Codex Manual
Choose a Surface
Codex has multiple entry points. Choose the one that matches your workflow.
| Surface | Best for | Users |
|---|---|---|
| CLI | Local terminal work | Developers comfortable with shells |
| App | Desktop UI, project threads, visual workflow | General users and developers |
| IDE Extension | Editor-side help | VS Code, Cursor, Windsurf users |
| Web / Cloud | Hosted tasks and PRs; also viewable and continuable from ChatGPT web and mobile | Teams 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
codexUseful 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 appUse 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.