OpenAI Codex

OpenAI coding agent across CLI, app, IDE, and cloud workflows.

Type: CLI / app / IDE / cloud agent

Best for: Terminal coding, local review, cloud tasks

Official docs: https://developers.openai.com/codex/cli

Last verified: 2026-07-12

Status: Confirmed

Quick Start

codex

Installation

macOS

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

Windows

Needs verification before standardizing a single native Windows install command.

Linux

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

WSL

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

Authentication

Start codex and sign in with ChatGPT or the supported auth flow.

Basic Commands

codex
codex --version

Intermediate Commands

  • use official CLI docs for model and permission adjustments

Advanced Commands

  • combine local CLI and cloud task workflows
  • use MCP when current external context is required

Project Configuration

  • AGENTS.md
  • ~/.codex/config.toml

Instruction Files

  • AGENTS.md

Models and Versions

  • confirm current model names in official docs

Permissions and Security

  • review command execution and file access carefully

MCP / Integrations

Official docs confirm MCP support.

Common Workflows

  • repo onboarding
  • implementation planning

Team Best Practices

  • separate local and cloud usage expectations

Troubleshooting

  • verify plan entitlements and auth setup

When to Use

  • terminal-first OpenAI workflows

When Not to Use

  • when the team wants a purely editor-first path

Sources