Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 3 additions & 35 deletions docs/reference/clients/codex-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,39 +8,7 @@ ease_of_use_for_non_technical: 3
github: https://github.com/openai/codex
---

Codex CLI is OpenAI's official command-line tool that brings the power of their latest reasoning models directly to your terminal. It's built for developers who already live in the terminal and want ChatGPT-level reasoning plus the power to actually run code, manipulate files, and iterate - all under version control.
Codex CLI brings OpenAI's reasoning models to the command line. It can create or edit files,
run commands in a sandbox, and track work under version control. Non-technical curators
can prompt tasks and review results directly from the terminal.

## Key Features

- **Multimodal inputs** – Pass text, screenshots, or diagrams and let the agent generate or edit code accordingly
- **Code execution** – Scaffolds files, runs them inside a sandbox, installs missing dependencies, and shows live results
- **Sandbox safety** – Runs model-generated commands in a sandbox with approval workflow
- **Version control integration** – All work happens under version control for easy tracking and rollback

## Installation

Install globally with npm:
```bash
npm install -g @openai/codex
```

Or using Homebrew:
```bash
brew install codex
```

## Alternative Options

Several community forks and alternatives are available:

- **[open-codex](https://github.com/ymichael/open-codex)** - Fork with expanded model support including OpenAI, Gemini, OpenRouter, and Ollama
- **[open-codex by codingmoh](https://github.com/codingmoh/open-codex)** - Fully open-source version supporting local language models
- **[ZSH Codex Plugin](https://github.com/tom-doerr/zsh_codex)** - ZSH plugin for AI-powered code completion

## Use Cases

- Code generation and editing
- File manipulation and scaffolding
- Dependency management
- Interactive development workflows
- AI-assisted debugging and refactoring