Codex CLI — コーディングエージェント

Codex CLIとは

リポジトリを読み、変更を提案し、コマンドを実行するという動き自体は他のターミナル型と同じですが、境界の引き方が特徴的です。macOSとLinuxではOSのサンドボックス機構を使い、触れるファイルと実行できるコマンドを制限します。制限がモデルの善意に依存しない、という点が違います。サインインはChatGPTのプランかOpenAIのAPIキーを経由します。コードはApache-2.0でも、背後のモデルは開かれた部分ではない、というのが取引条件です。

Codex CLIで何ができますか？

手元のチェックアウトでそのまま作業する — ターミナルからローカルのリポジトリに対して動きます。コードを読み、ファイルを編集し、その場でコマンドを実行するため、アップロード操作も、同期を保つべき別作業領域もありません。
必要になる前に境界を決める — permissionsコマンドで、確認なしに編集・実行してよい範囲を設定します。macOSとLinuxではその設定をOSのサンドボックスが裏打ちしており、エージェント自身の自制に頼りません。
プロジェクトの決まりごとを一度だけ書く — initコマンドがAGENTS.mdを作ります。ビルドコマンド、規約、触ってはいけない場所など、毎回のセッションに適用したい指示を、都度プロンプトに書き直さずに済みます。
既に動かしているツールを繋ぐ — mcpサブコマンドでローカルまたはリモートのMCPサーバーに接続します。エージェントに届かせたい社内サービスを、専用の繋ぎ込みではなく設定で扱えます。
同じ作業を別の場所へ移す — cloudコマンドで処理をリモート実行へ渡せます。VS Code・Cursor・Windsurf向けのIDE拡張やデスクトップアプリもあり、CLIは同じ製品への入口の1つという位置づけです。

Codex CLIを選ぶ前に

認証はChatGPTのプランかOpenAIのAPIキーを通ります。同じ分類の複数プロバイダ対応エージェントと違い、背後のモデルを自由に差し替える前提ではありません。
OSサンドボックスはmacOSとLinuxについて説明されています。Windowsでは同じ保証が明示されていないため、承認設定の比重が相対的に大きくなります。

スター推移

8月21日〜8月28日 · +8.4k

111k120k

よくある質問

Codex CLIは商用利用できますか?

Codex CLIはApache-2.0ライセンスで公開されています。OSI承認のオープンソースライセンスで、商用利用が認められています。

Codex CLIはどの形で使えますか?

Codex CLIはローカル実行の形で利用できます。

ドキュメント

openai/codex のREADMEより転載（Apache-2.0）。原文を読む ↗

Quickstart

Installing and running Codex CLI

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

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

Run the following on Windows to install Codex CLI:

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):

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

$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:

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

# Install using Homebrew
brew install --cask codex

Then simply run codex to get started.

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, Business, 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.

Docs

This repository is licensed under the Apache-2.0 License.