Codex CLI is an open‑source local coding agent that runs in your terminal, letting you write, edit, and understand code without leaving the command line.
Codex CLI is an open-source local coding agent designed to help developers write, edit, and understand code directly from their terminal. It serves as a lightweight tool for streamlining coding workflows without requiring additional interfaces or platforms.
Key Features:
Runs locally on your machine, enabling seamless integration with existing development environments.
Supports the Model Context Protocol (MCP), allowing it to connect with MCP-compatible servers for enhanced functionality.
Configurable preferences stored in ~/.codex/config.toml, offering flexibility in customizing settings.
Compatible with ChatGPT plans, providing access to advanced AI-driven coding capabilities.
Audience & Benefit:
Ideal for developers seeking a powerful yet lightweight tool to enhance their coding efficiency. Codex CLI empowers users to maintain focus within the terminal while leveraging AI-driven insights and code assistance.
Install Codex CLI via winget for easy setup and start enhancing your development workflow today.
README
OpenAI Codex CLI
npm i -g @openai/codexor brew install codex
Codex CLI is a coding agent from OpenAI that runs locally on your computer.If you are looking for the cloud-based agent from OpenAI, Codex Web, see chatgpt.com/codex.
Quickstart
Installing and running Codex CLI
Install globally with your preferred package manager. If you use npm:
npm install -g @openai/codex
Alternatively, if you use Homebrew:
brew install codex
Then simply run codex to get started:
codex
You can also go to the latest GitHub Release and download the appropriate binary for your platform.
Each GitHub Release contains many executables, but in practice, you likely want one of these:
macOS
Apple Silicon/arm64: codex-aarch64-apple-darwin.tar.gz
x86_64 (older Mac hardware): codex-x86_64-apple-darwin.tar.gz
Linux
x86_64: codex-x86_64-unknown-linux-musl.tar.gz
arm64: codex-aarch64-unknown-linux-musl.tar.gz
Each archive contains a single entry with the platform baked into the name (e.g., codex-x86_64-unknown-linux-musl), so you likely want to rename it to codex after extracting it.
Using Codex with your ChatGPT plan
Run codex and select Sign in with ChatGPT. We recommend signing into your ChatGPT account to use Codex as part of your Plus, Pro, Team, Edu, or Enterprise plan. Learn more about what's included in your ChatGPT plan.
You can also use Codex with an API key, but this requires additional setup. If you previously used an API key for usage-based billing, see the . If you're having trouble with login, please comment on .
Codex CLI supports MCP servers. Enable by adding an mcp_servers section to your ~/.codex/config.toml.
Configuration
Codex CLI supports a rich set of configuration options, with preferences stored in ~/.codex/config.toml. For full configuration options, see Configuration.
