codex

OpenAI Codex CLI - Lightweight coding agent that runs in your terminal

Introduction

TIP

If you want to use Codex with other models like DeepSeek V4, check out the integration guide.

Codex CLI is a local coding agent by OpenAI (Apache 2.0). It runs directly on your machine, understands your project context, and can generate code, explain logic, debug issues, and even execute shell commands and file operations. Powered by GPT-4o-level models, it's free to use if you have a ChatGPT Plus, Pro, Team, or Enterprise account—no extra payment required.

Quick Start

# Install via x-cmd
x env use codex

# Launch (ChatGPT Plus/Pro users can sign in directly)
cd your-project
codex

# Non-interactive mode: single execution
codex -q "Explain this project's architecture"

# Full-auto mode (for trusted environments)
codex --full-auto "Fix all lint errors"

Runs Locally, Free with Your ChatGPT Subscription

Codex CLI runs entirely on your local machine—no need to upload code to the cloud. If you already have a ChatGPT Plus/Pro/Team/Enterprise subscription, you can reuse it at zero additional cost. You can also use an OpenAI API key for fine-grained control over usage and quotas.

Core Capabilities

• Code Generation & Editing

  Describe requirements in natural language, and Codex generates runnable code. Boilerplate, unfamiliar syntax, quick scripts—one prompt and you're done.

• Code Understanding & Debugging

  Hand off files from legacy or open-source projects, and Codex explains the logic and design intent. Paste error messages and it analyzes root causes with fix suggestions or direct patches.

• Shell Command Execution

  Codex can actually run commands—tests, dependency installs, file operations. It asks for your confirmation by default, or you can configure full-auto mode.

• MCP Protocol Extension

  Compatible with Model Context Protocol—connect custom MCP servers to extend capabilities: query databases, call internal APIs, and more.

• AGENTS.md Project Memory

  Place an AGENTS.md file in your project root, and Codex reads your coding conventions, architecture decisions, and common commands—getting smarter about your project over time.

• Non-Interactive / CI Integration

  Supports non-interactive mode for integration into scripts or CI/CD pipelines—batch refactoring, documentation generation, automatic lint fixes.

• Zero Data Retention (ZDR)

  OpenAI commits to not retaining your code or conversation data for model training, ensuring data privacy.

Multi-Platform Support

Beyond the terminal CLI, Codex also provides:

• IDE Integration: Plugins for VS Code, Cursor, and Windsurf
• Desktop App: Run codex app for a standalone desktop interface

Related Tools

• claude-code - Anthropic's official terminal AI agent with similar capabilities, based on Claude models
• gemini-cli - Google's official terminal AI agent with a larger free tier and 1M token context
• opencode - Open-source AI coding agent, provider-agnostic with multi-model switching

Further Reading

• Codex CLI GitHub - Source code and contribution guide
• Codex Documentation - Installation, configuration, and usage guide

Global Installation：

1. Automatically download the installation package and expand it locally.
2. Automatically create symbolic links for executable files in x-cmd's bin directory.
3. All currently open shells can directly use the command name.

x pkg use codex

https://github.com/openai/codex
License	Apache-2.0
Language	"Rust"
Version	v0.162.1 stable

Package Installation Support Provided for
x64
	Linux
	Darwin
	Windows
ARM64
	Linux
	Darwin

Package Binary Source from

Official Source
• https://npmjs.com/package/@openai/codex

Repackaged from Official Source
• https://npmmirror.com/package/@openai/codex

Related Link

Module

`x pkg` => usage