# @openai/codex

> Codex CLI is a coding agent from OpenAI that runs locally on your computer.

Latest version **0.155.1** (published 2026-09-18) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @openai/codex
pnpm add @openai/codex
yarn add @openai/codex
bun add @openai/codex
```

Provides the command `codex`.

## Health

**Score 75/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; popular repo; extremely popular.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.155.1 |
| Published | 2026-09-18 |
| First published | 2025-04-16 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | ESM |
| Node | >=16 |
| Dependencies | 0 |
| Unpacked size | 12.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 123817 |
| Maintainers | openai-publisher, tino-openai, dylan-hurd-openai, moustafa-openai, tylersmith-openai, mdangelo-openai, victor-openai, jbeckwith-oai, wadih-openai, atty-openai, tibo-openai, dkundel-openai, mbolin-openai, fouad-openai, easong-openai, aibrahim-openai, apcha-oai, seratch-openai |

## Links

- npm: https://www.npmjs.com/package/@openai/codex
- Repository: https://github.com/openai/codex
- Homepage: https://github.com/openai/codex#readme
- Issues: https://github.com/openai/codex/issues
- npm.io page: https://npm.io/package/@openai/codex

## Recent versions

- 0.155.1 (latest) — 2026-09-18
- 0.156.0-alpha.17-win32-x64 (alpha-win32-x64) — 2026-09-21
- 0.156.0-alpha.17-darwin-arm64 (alpha-darwin-arm64) — 2026-09-21
- 0.156.0-alpha.17-linux-arm64 (alpha-linux-arm64) — 2026-09-21
- 0.156.0-alpha.17-win32-arm64 (alpha-win32-arm64) — 2026-09-21
- 0.156.0-alpha.17-darwin-x64 (alpha-darwin-x64) — 2026-09-21
- 0.156.0-alpha.17 (alpha) — 2026-09-21
- 0.156.0-alpha.17-linux-x64 (alpha-linux-x64) — 2026-09-21
- 0.155.1-win32-x64 (win32-x64) — 2026-09-18
- 0.155.1-win32-arm64 (win32-arm64) — 2026-09-18
- 0.155.1-darwin-x64 (darwin-x64) — 2026-09-18
- 0.155.1-darwin-arm64 (darwin-arm64) — 2026-09-18
- 0.155.1-linux-arm64 (linux-arm64) — 2026-09-18
- 0.155.1-linux-x64 (linux-x64) — 2026-09-18
- 0.1.2505291658 (native) — 2025-05-30
- … 4679 more at https://npm.io/package/@openai/codex/versions

## README

<p align="center"><strong>Codex CLI</strong> is a coding agent from OpenAI that runs locally on your computer.
<p align="center">
  <img src="https://github.com/openai/codex/blob/main/.github/codex-cli-splash.png" alt="Codex CLI splash" width="80%" />
</p>
</br>
If you want Codex in your code editor (VS Code, Cursor, Windsurf), <a href="https://developers.openai.com/codex/ide">install in your IDE.</a>
</br>If you want the desktop app experience, run <code>codex app</code> or visit <a href="https://chatgpt.com/codex?app-landing-page=true">the Codex App page</a>.
</br>If you are looking for the <em>cloud-based agent</em> from OpenAI, <strong>Codex Web</strong>, go to <a href="https://chatgpt.com/codex">chatgpt.com/codex</a>.</p>

---

## Quickstart

### Installing and running Codex CLI

Run the following on Mac or Linux to install Codex CLI:

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

Run the following on Windows to install Codex CLI:

```shell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```

The standalone installers download from `https://releases.openai.com/codex` by default and fall back to GitHub Releases if a metadata or asset download is unavailable. To force GitHub Releases, set `CODEX_INSTALLER_USE_RELEASES_OPENAI_COM` to `false` (`0` and `no` are also accepted):

```shell
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
```

```powershell
$env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; irm https://chatgpt.com/codex/install.ps1 | iex
```

Codex CLI can also be installed via the following package managers:

```shell
# Install using npm
npm install -g @openai/codex
```

```shell
# Install using Homebrew
brew install --cask codex
```

Then simply run `codex` to get started.

<details>
<summary>You can also go to the <a href="https://github.com/openai/codex/releases/latest">latest GitHub Release</a> and download the appropriate binary for your platform.</summary>

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.

</details>

### 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, Business, Edu, or Enterprise plan. [Learn more about what's included in your ChatGPT plan](https://help.openai.com/en/articles/11369540-codex-in-chatgpt).

You can also use Codex with an API key, but this requires [additional setup](https://developers.openai.com/codex/auth#sign-in-with-an-api-key).

## Docs

- [**Codex Documentation**](https://developers.openai.com/codex)
- [**Contributing**](./docs/contributing.md)
- [**Installing & building**](./docs/install.md)
- [**Open source fund**](./docs/open-source-fund.md)

This repository is licensed under the [Apache-2.0 License](LICENSE).

---
_Source: https://npm.io/package/@openai/codex · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._