収録件数：264 件のニュース/100 個のAIツール/374 個のオープンソースプロジェクト/64 件の学習リソース
ホームニュースオープンソースモデルAIツール学習リソース
ホーム / オープンソース / codex

codex

CodexはOpenAIが提供するオープンソースのターミナル用コーディングエージェントです。構成可能なサンドボックス機能と承認制御により、プロジェクト内のコードの読み込み、編集、実行を安全に行えます。

RustApache-2.0Agent
⭐ GitHubhttps://github.com/openai/codex
102,186
スター数
+0
スター増加率
2026年7月29日
最終更新
7
クリック数

1. プロジェクト概要

Codexは、ターミナル上でローカルに動作するOpenAIのオープンソースコーディングエージェントです。開発者がコマンドラインから離れることなく、コードベースの読み込み、ファイルの編集、サンドボックス内でのコマンド実行、変更の反復処理ができるAIとチャットできます。

2. 背景とポジショニング

Codexは、クラウドIDEやチャットウィンドウに制限されるのではなく、OpenAIのエージェント型コーディング機能を開発者のマシン上に直接持ち込むために構築されました。その中核的な使命は、開発者に高速でスクリプト可能、かつプライバシーを尊重する方法を提供し、見知らぬコードの読み込み、パッチのドラフト作成、テストの実行、失敗のデバッグといった実際のエンジニアリング作業を、人間の開発者が使用するのと同じターミナルとファイルシステムで動作するAIエージェントに委譲できるようにすることです。

他のAIコーディングアシスタントと比較して、Codexは以下の3点で差別化されています：

  • ローカルファーストの実行：エージェントはセッションごとにホストされたコンテナを必要とするのではなく、開発者のマシン上で軽量なバイナリとして動作します（当初はTypeScriptで実装されていましたが、パフォーマンスと信頼性の向上のためにRustへ書き換えられました）。
  • 構成可能なサンドボックス化と承認：エージェントが実行しようとするすべてのコマンドは、明示的なサンドボックスと承認ポリシーを経由するため、ユーザーは自律性と監視のバランスを「すべてのアクション前に確認」から「完全な自律」まで自由に調整できます。
  • 複数のエントリーポイント、1つのエージェント：同じCodexエンジンがターミナルCLI、IDE拡張機能（VS Code、Cursor、Windsurf）、デスクトップアプリとして公開されており、チームは単一のワークフローに縛られません。

3. 機能カテゴリ

🖥️ ターミナルエージェント — コアとなるインタラクティブ体験

  • codex — 現在のリポジトリでインタラクティブセッションを開始
  • codex exec "<プロンプト>" — ワンショットの非インタラクティブタスクを実行（スクリプトやCIで有用）
  • 作業ディレクトリの完全なコンテキストを含むマルチターン会話
  • インライン差分とコマンド出力をターミナルに直接ストリーミング
  • 目的：シェルの切り替えなしで開発者が実際のコード変更を主導できるようにする。

🛡️ サンドボックス化と承認 — セーフティコントロール

  • 読み取り専用モード：エージェントはファイルを検出できるが、変更したり任意のコマンドを実行したりできない
  • ワークスペース書き込み／自動モード：エージェントはプロジェクトディレクトリ内に限定してファイルを編集しコマンドを実行できる
  • フルオートモード：エージェントはサンドボックス内でコマンドごとの確認なしにマルチステップ計画を実行する
  • プラットフォームネイティブのサンドボックス化（例：macOS Seatbelt、Linuxコンテナ/ネームスペース）によりファイルシステムとネットワークアクセスを制限
  • 目的：ユーザーがエージェントに付与する自律性を正確に選択できるようにする。

🔌 インテグレーション — Codexをプロジェクトやツールに接続

  • AGENTS.md — エージェントが従うべき規約、コマンド、コンテキストを記述したプロジェクトレベルのファイル
  • MCP（Model Context Protocol）サーバーサポートにより外部ツールでエージェントを拡張
  • 再利用可能でプロジェクト固有のエージェント機能を格納するための .codex/skills
  • VS Code、Cursor、Windsurf用のIDE拡張機能
  • 目的：Codexがプロジェクト固有のルールを認識し、カスタムツールで拡張できるようにする。

☁️ マルチエージェントオーケストレーション — 大規模タスクの調整

  • 複数のCodexインスタンス間でのタスク分解
  • エージェント間通信と共有コンテキスト
  • 複数のエージェントが重複するコードに触れた際の競合解決
  • 目的：エージェントのスケーラビリティを単一ファイルの編集から、大規模で多部門にわたるプロジェクトの調整まで拡大する。

⚙️ エンタープライズ＆自動化 — 人間のターミナル外でのCodex実行

  • エージェントのプロンプトをインターセプト、監査、または強化するためのフックシステム（例：user-prompt hooks）
  • CI／自動化に優しい非インタラクティブモード
  • 共有ポリシーを持つチーム向けの設定プロファイル
  • 目的：組織がパイプラインにCodexを組み込み、ガバナンスを適用できるようにする。

4. 主な特徴

  • Rustベースへの書き換え：CLIの実行エンジン（codex-rs）はRustで実装されており、起動速度、低メモリフットプリント、長時間稼働するエージェントセッションの信頼性を優先しています。
  • 構成可能な自律性：サンドボックスと承認の設定は厳格な読み取り専用から完全な自律まで幅広く対応しており、慎重な初回利用から手放し自動化まで同じツールでカバーできます。
  • 柔軟な認証：既存のChatGPT Plus、Pro、Business、Edu、Enterpriseプランでサインインするか、APIキーで認証できます。ほとんどのユーザーには別アカウントの作成は不要です。
  • AGENTS.mdによるプロジェクト認識コンテキスト：チームはAGENTS.mdに規約を一度記録するだけで、エージェントはセッションを通じて一貫してそれに従います。
  • MCPを通じた拡張性：Model Context Protocolにより、Codexはローカルファイルシステムやシェルを超えて外部ツールやデータソースに接続できます。
  • 複数のインターフェース、1つのエンジン：同一のエージェントがターミナルCLI、IDE拡張機能、デスクトップアプリとして提供されており、チームがすでに使用しているワークフローに適合します。

5. ロール別のユースケース

一般開発者 — ターミナルから直接見知らぬコードベースの探索、バグ修正のドラフト作成、テスト生成、新機能のスケルトン作成を行い、変更がマージされる前に差分を確認しながら進められます。

DevOps / SRE — CIパイプラインやスクリプト内で非インタラクティブ（codex exec）モードでCodexを実行し、承認ポリシーによって制御された状態で、定期的な保守タスク、設定更新、ログ駆動のトライアージを自動化できます。

プロジェクトマネージャー — コードベースの構造や最近の変更の要約を迅速に生成するためにCodexを使用し、生の差分を読むことなく技術的な進捗を理解するハードルを下げられます。

6. はじめに

必要なものを見つける

  • リポジトリとドキュメントを閲覧：github.com/openai/codex
  • 新しいIssueを作成する前に、既存のIssueやDiscussionを検索する

インストール／統合

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

# npm経由
npm install -g @openai/codex

# Homebrew経由
brew install --cask codex

# プロジェクトでセッションを開始
codex

コントリビューション

git clone https://github.com/openai/codex.git
cd codex/codex-rs
cargo build

コーディング基準やプルリクエストの手順については、リポジトリのコントリビューティングガイドをご覧ください。

7. プロジェクト構造

codex/
├── codex-cli/    # CLIラッパーおよびnpmパッケージング
├── codex-rs/     # エージェントエンジンのRust実装
├── sdk/          # 他のツールにCodexを組み込むためのSDK
├── docs/         # ユーザーおよび開発者向けドキュメント
└── tools/        # ユーティリティおよびリリーススクリプト
  • codex-rs/ にはコアエージェントループ、サンドボックス化ロジック、モデル連携コードが含まれており、エンジニアリング関連のコントリビューションの大部分はこのディレクトリで行われます。
  • codex-cli/ はnpm経由で配布されるようコンパイル済みバイナリをパッケージ化します。
  • docs/ には、本ドキュメント全体で参照されている設定、サンドボックス化、使用方法のガイドが格納されています。

8. 関連エコシステム

  • ChatGPTプラン（Plus、Pro、Business、Edu、Enterprise） — 別個のAPIキーなしでCodexの認証と利用権限を提供します。
  • OpenAI API — キーベースの課金を好むユーザー向けの代替認証パス。
  • Model Context Protocol（MCP） — Codexが外部ツールやデータソースに接続するために使用するオープンプロトコル。
  • IDEインテグレーション — 同じエージェントをエディタ内に組み込むVS Code、Cursor、Windsurf用の拡張機能。

9. ライセンス

CodexはApache-2.0ライセンスの下でリリースされています。

  • ✅ 商用目的を含め、自由な使用、改変、配布が可能
  • ✅ プロジェクトからのコントリビューションをカバーする特許付与が含まれる
  • ❌ 保証は一切ありません；利用は自己責任となります
  • ℹ️ 改変版は元のライセンスと著作権表示を保持し、重要な変更内容を明記する必要があります

10. よくある質問（FAQ）

Q: Codexを使用するにはAPIキーが必要ですか？
A: いいえ。既存のChatGPT Plus、Pro、Business、Edu、Enterpriseプランでサインインするか、希望に応じてAPIキーを使用できます。

Q: Codexは許可なく私のファイルを変更できますか？
A: 設定次第です。サンドボックスと承認の設定は読み取り専用からフルオートまで幅広く、エージェントの自律性をあなたが制御します。

Q: 対応プラットフォームはどれですか？
A: macOS、Linux、Windowsに対応しています。プリビルドバイナリ、npm、Homebrew経由でインストール可能です。

Q: スクリプトやCIパイプラインでCodexを実行するにはどうすればよいですか？
A: 非インタラクティブコマンドを使用します。例：codex exec "テストスイートを実行し、失敗を要約する"。

Q: Codexはプロジェクトの規約をどのように学習しますか？
A: リポジトリにAGENTS.mdファイルを追加し、コマンド、スタイル、コンテキストを記述してください。Codexは各セッションでこれを自動的に読み取ります。

11. クイックリンク

12. まとめ

Codexは、OpenAIのコーディングエージェントをあらゆる開発者のターミナル、IDE、CIパイプラインに持ち込み、構成可能なサンドボックス化によりチームがエージェントに付与する自律性を正確に選べるようにします。既存のコマンドラインワークフローから離れずにAI支援コーディングを望む開発者や、明確で監査可能な安全制御の下で日常的なエンジニアリングタスクを自動化する必要があるチームに最適です。