CLI

The Codex CLI is the primary local interface to the coding agent. It reads the current repository, edits files, runs commands, and reports its work interactively or through machine-readable output.

Install

Copynpm install -g @openai/codex
brew install --cask codex

Or use the official installer:

Copycurl -fsSL https://chatgpt.com/codex/install.sh | sh

Run codex and sign in with ChatGPT, or configure API-key authentication in the OpenAI developer documentation.

Run in a repository

Copycd /path/to/repository
codex

Codex uses the current directory by default. It is designed to work with a Git repository so changes can be reviewed and reverted normally.

MCP commands

Codex can consume external MCP servers configured in ~/.codex/config.toml:

Copycodex mcp add github -- npx -y @modelcontextprotocol/server-github
codex mcp list
codex mcp get github
codex mcp remove github

For servers that support OAuth, use codex mcp login <server-name>. See MCP server configuration.

Automation and upgrades

For programmatic integration, use the TypeScript SDK. To upgrade the CLI:

Copynpm update -g @openai/codex

Check the GitHub releases for release notes and standalone binaries.