Start Codex in your project

getting started

// what it does

Run codex from inside a project directory to open the interactive TUI; the header shows the active model, working directory, and approval mode. Pass a prompt inline to skip straight to a task instead of typing it in the composer. Codex automatically reads any AGENTS.md files for project context on launch.

// shell

$ codex
$ codex "explain this codebase"

// gotcha

On first launch nothing runs until you sign in — Codex prompts you to choose ChatGPT or an API key. Codex is built around git repos; outside one, some features degrade and the workspace-write sandbox anchors to the current directory.

// resources