Codex 入門：OpenAIのコーディングエージェントを初心者向けに解説

Tech
2026.03.17

Codex 入門：OpenAIのコーディングエージェントを初心者向けに解説

はじめに

プログラミングをしていると、「この機能どうやって実装するんだっけ？」「このエラーの原因は何？」「リファクタリングしたいけど時間がかかりそう…」といった悩みに直面することはありませんか？

そんな悩みを解決してくれるのが、OpenAIが提供するCodex（コーデックス）です。Codexは、あなたの隣に座ってペアプログラミングしてくれる熟練エンジニアのように、コードを書いたり、読んだり、修正したり、テストしたりしてくれるAIコーディングエージェントです。

本記事では、Codexとは何かから始まり、インストール方法、基本的な使い方、他のツールとの比較まで、初心者の方にもわかりやすく解説します。

—

Codexとは何か

概要

Codexは、OpenAIが開発したAIコーディングエージェントです。単なるコード補完ツールではなく、あなたの指示を理解し、コードを読み、編集し、コマンドを実行し、テストを行うことができる「エンジニアのパートナー」として設計されています。

2025年にOpenAIが公開したこのツールは、GitHubのリポジトリを探索し、既存のコード規約に合わせてコードを生成し、バグを修正し、リファクタリングを行うなど、ソフトウェア開発の幅広いタスクをこなすことができます。

主な特徴

Codexには以下のような特徴があります：

1. ローカル環境で動作
Codex CLIはあなたのコンピュータ上で動作します。クラウドに依存せず、ローカルのファイルに直接アクセスして編集や実行が可能です。

2. 複数の実行環境

  • Codex CLI: ターミナル上で動作するコマンドラインツール
  • Codex IDE拡張: VS Code、Cursor、Windsurfなどのエディタで使用可能
  • Codex App: MacOSとWindows用のデスクトップアプリ
  • Codex Web: クラウド上でタスクを委任するWebインターフェース

3. オープンソース
Codex CLIはRustで書かれており、GitHub上でオープンソースとして公開されています。誰でもコードを確認し、貢献することができます。

4. ChatGPTプランに含まれる
CodexはChatGPT Plus、Pro、Business、Edu、Enterpriseプランに含まれており、追加料金なしで利用できます。

できること

Codexは以下のようなタスクをこなすことができます：

  • コードを書く: 実現したい機能を説明すれば、既存のプロジェクト構造や規約に合わせてコードを生成
  • コードを理解する: 複雑なコードベースやレガシーコードを読み解き、説明
  • コードレビュー: バグや論理エラー、エッジケースの見落としを特定
  • デバッグ: エラーの原因を追跡し、根本原因を診断して修正案を提示
  • タスクの自動化: リファクタリング、テスト作成、マイグレーション、セットアップなどの反復作業を自動化

—

インストール方法

Codex CLIのインストールは非常に簡単です。以下のいずれかの方法でインストールできます。

npmを使用する場合（推奨）

Node.jsがインストールされている環境であれば、npmを使ってインストールするのが最も簡単です：

“`bash
npm install -g @openai/codex
“`

このコマンドで、Codex CLIがグローバルにインストールされます。

Homebrewを使用する場合（macOS）

macOSユーザーであれば、Homebrewを使ってインストールすることもできます：

“`bash
brew install –cask codex
“`

GitHub Releaseから直接ダウンロード

バイナリを直接ダウンロードすることもできます。GitHubのリリースページから、お使いのプラットフォームに合わせた実行ファイルをダウンロードしてください。

macOS:

  • Apple Silicon (M1/M2/M3): `codex-aarch64-apple-darwin.tar.gz`
  • Intel Mac: `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`

ダウンロード後、アーカイブを展開し、実行ファイルを`codex`にリネームしてPATHの通った場所に配置してください。

アップグレード方法

Codex CLIは定期的にアップデートされています。npmでインストールした場合、以下のコマンドでアップグレードできます：

“`bash
npm i -g @openai/codex@latest
“`

—

基本的な使い方

初回起動と認証

インストールが完了したら、ターミナルで`codex`コマンドを実行してください：

“`bash
codex
“`

初回起動時には、認証を求められます。以下の2つの方法から選択できます：

1. ChatGPTアカウントでサインイン（推奨）

  • ChatGPT Plus、Pro、Business、Edu、Enterpriseプランをお持ちの場合
  • サインインするとブラウザが開き、ChatGPTアカウントでログインします
  • プランに含まれる利用枠を使用できます

2. APIキーでサインイン

  • OpenAI APIキーをお持ちの場合
  • APIキーの使用量に応じた従量課金となります
  • クラウド機能（GitHub連携など）は使用できません

インタラクティブモード

`codex`コマンドを実行すると、インタラクティブなターミナルUI（TUI）が起動します。ここで自然言語で指示を入力するだけで、Codexがタスクを実行します。

例：

“`
> このプロジェクトの構造を説明して
“`

“`
> ユーザー認証機能を追加して
“`

“`
> このバグを修正して
“`

主なコマンド

Codexには以下のような便利なコマンドがあります：

| コマンド | 説明 |
|———–|——|
| `/model` | 使用するモデルを切り替え（GPT-5.4、GPT-5.3-Codexなど） |
| `/status` | 現在の使用状況と残り枠を確認 |
| `/help` | ヘルプを表示 |
| `/review` | ローカルコードレビューを実行 |
| `/cloud` | Codex Cloudタスクを起動 |

承認モード

Codexは、ファイルを編集したりコマンドを実行したりする前に、ユーザーの承認を求めることができます。以下のモードから選択できます：

  • Suggest: 変更を提案のみ（何も実行しない）
  • Auto-edit: ファイル編集は自動で行う
  • Full-auto: すべての操作を自動で行う

初心者の方は、最初は「Suggest」モードで提案を確認しながら使うことをお勧めします。

画像入力

Codexは画像入力にも対応しています。スクリーンショットやデザイン仕様書を添付して、「この画面のようなUIを作って」と指示することができます。

Web検索

CodexはWeb検索機能も備えています。最新の情報が必要な場合、インターネットで検索して回答を生成します。

—

できること・向いている用途

向いている用途

1. 新機能の実装
「ユーザー登録機能を追加して」「APIエンドポイントを作成して」のような指示で、新機能を一から実装できます。既存のコード規約やアーキテクチャに合わせてコードを生成します。

2. バグ修正
エラーメッセージや問題の症状を伝えるだけで、原因を特定し、修正案を提示してくれます。

3. コードレビュー
プルリクエストを提出する前に、Codexにレビューを依頼できます。バグや潜在的な問題を早期に発見できます。

4. リファクタリング
「この関数をリファクタリングして」「重複コードを整理して」のような指示で、コードの品質を向上させることができます。

5. テスト作成
既存のコードに対するテストケースを自動生成できます。

6. ドキュメント作成
コードの説明やREADMEの作成、コメントの追加などを依頼できます。

7. 新しいコードベースの理解
新しいプロジェクトに参加した際、Codexにコードベースの概要を説明してもらうことで、短期間で理解を深められます。

向いていない用途

1. 100%正確性が求められるタスク
AIは間違いを犯す可能性があります。重要なシステムでは、必ず人間がレビューしてください。

2. 高度なドメイン知識が必要なタスク
特定の専門分野（医療、金融、法務など）では、専門知識が必要な判断を正しく行えない場合があります。

3. 大規模なアーキテクチャ設計
システム全体の設計のような、広範な判断が必要なタスクでは、人間の判断が依然として重要です。

—

注意点・制限事項

セキュリティ上の注意

1. 認証情報の管理
Codexは認証情報を`~/.codex/auth.json`に保存します。このファイルはパスワードと同様に扱い、コミットしたり共有したりしないでください。

2. MFAの有効化
Codex Cloudを使用する場合、多要素認証（MFA）を有効にすることが強く推奨されています。

3. 信頼できない環境での使用
APIキー認証は、CI/CDパイプラインのような信頼できる環境での使用を推奨します。公開環境や信頼できない環境では使用しないでください。

利用制限

Codexの使用量はプランによって制限されています：

| プラン | ローカルメッセージ/5時間 | クラウドタスク/5時間 |
|——–|———————–|——————-|
| Plus | 33-168 | なし |
| Pro | 223-1120 | なし |
| Business | 33-168 | なし |
| Enterprise/Edu | クレジットベース | クレジットベース |
| API Key | 従量課金 | なし |

使用量は、タスクの複雑さやコードベースのサイズによって変動します。小さなスクリプトは使用量をあまり消費しませんが、大規模なタスクはより多くの枠を使用します。

プラットフォーム対応

  • macOS: 完全対応
  • Linux: 完全対応
  • Windows: 実験的サポート（WSLの使用を推奨）

モデルの制約

Codexで使用できるモデルは、サインイン方法によって異なります：

  • ChatGPTサインイン: GPT-5.4、GPT-5.3-Codex、GPT-5.1-Codex-Miniなど最新モデルにアクセス可能
  • APIキーサインイン: 新しいモデルへのアクセスが遅れる場合がある

—

料金体系

ChatGPTプランに含まれるCodex

Codexは以下のChatGPTプランに含まれています：

ChatGPT Plus（月額$20）

  • 週に数回の集中的なコーディングセッションに適した使用枠
  • CLI、IDE拡張、iOSアプリで利用可能
  • GPT-5.4、GPT-5.3-Codexなどの最新モデルにアクセス可能
  • GPT-5.1-Codex-Miniで最大4倍の使用枠を確保可能

ChatGPT Pro（月額$200）

  • 毎日の本格的な開発に適した使用枠
  • Plusの全機能に加え：
  • 優先リクエスト処理
  • GPT-5.3-Codex-Spark（高速モデル）へのアクセス
  • ローカルおよびクラウドタスクで6倍の使用枠
  • 10倍のクラウドコードレビュー

ChatGPT Business

  • スタートアップや成長中の企業向け
  • Plusの全機能に加え：
  • より大きな仮想マシンでクラウドタスクを高速実行
  • セキュリティで保護された専用ワークスペース
  • SAML SSO、MFA
  • デフォルトでビジネスデータをトレーニングに使用しない

ChatGPT Enterprise/Edu

  • 組織全体での展開に対応
  • Businessの全機能に加え：
  • 優先リクエスト処理
  • エンタープライズレベルのセキュリティとコントロール
  • SCIM、EKM、ユーザー分析、RBAC
  • 監査ログと使用状況監視
  • データ保持とデータ常駐の制御

APIキーでの使用

APIキーを使用する場合、従量課金制となります。使用したトークン数に基づいて課金され、標準APIレートが適用されます。

APIキーを使用する場合の注意点：

  • クラウド機能（GitHub連携、Slack統合など）は使用できません
  • 新しいモデルへのアクセスが遅れる場合があります

クレジットシステム

使用枠を使い切った後も、クレディットを購入することで継続利用できます：

| タスク種別 | 平均クレジット消費 |
|————|——————|
| ローカルタスク（1メッセージ） | 約7クレジット |
| クラウドタスク（1メッセージ） | 約34クレジット |
| コードレビュー（1PR） | 約34クレジット |

使用枠を長持ちさせるコツ

使用枠を有効に活用するためのヒント：

1. プロンプトを簡潔に: 必要な情報だけを含め、不要なコンテキストを削除
2. AGENTS.mdを最適化: プロジェクトのコンテキスト注入を制御
3. MCPサーバーを必要な時だけ有効化: 各MCPサーバーはコンテキストを増加させます
4. GPT-5.1-Codex-Miniを使用: 定型的なタスクでは、使用枠を約4倍長持ちさせることができます

—

他ツール（Claude Code, Cline等）との違い

Codexは、他のAIコーディングツールとどのように違うのでしょうか？ 主な競合ツールと比較してみましょう。

Claude Code

概要
Anthropicが開発したClaudeベースのコーディングエージェントです。ターミナル上で動作し、コードの読み書きや編集を行います。

Codexとの違い

| 項目 | Codex | Claude Code |
|——–|———|————|
| 開発元 | OpenAI | Anthropic |
| モデル | GPT-5.4, GPT-5.3-Codex | Claude 4, Claude 3.5 |
| 料金 | ChatGPTプランに含まれる | 別途サブスクリプション |
| クラウド機能 | GitHub連携、Slack統合 | 限定的 |
| 理解の深さ | 高い | 高い |

使い分けのポイント

  • ChatGPTを既に契約している場合、Codexは追加費用なしで利用できます
  • Claude Codeは、Claudeモデルの特徴である丁寧な説明が好みの場合に適しています

Cline

概要
VS Code拡張機能として動作するオープンソースのAIコーディングエージェントです。複数のLLMプロバイダーに対応しています。

Codexとの違い

| 項目 | Codex | Cline |
|——–|———|——–|
| 形態 | CLI, IDE, App, Web | VS Code拡張機能 |
| モデル | OpenAIモデルのみ | 複数プロバイダー対応 |
| 料金 | ChatGPTプランに含まれる | 使用するモデルによる |
| オープンソース | CLIはオープンソース | 完全オープンソース |

使い分けのポイント

  • 特定のLLMプロバイダーを使いたい場合、Clineが適しています
  • シームレスなエディタ統合を重視する場合もClineが良い選択肢です

GitHub Copilot

概要
GitHubとOpenAIが共同開発した、コード補完に特化したAIツールです。

Codexとの違い

| 項目 | Codex | GitHub Copilot |
|——–|———|—————|
| 形態 | コーディングエージェント | コード補完ツール |
| 機能 | コード生成、編集、レビュー、実行 | 主にコード補完 |
| 自律性 | タスクを自律的に実行可能 | 行単位の補完が中心 |
| 料金 | ChatGPTプランに含まれる | 別途サブスクリプション |

使い分けのポイント

  • 行単位のコード補完を求める場合はCopilotが適しています
  • タスク単位でコーディングを依頼したい場合はCodexが適しています

Cursor

概要
AI機能を統合したコードエディタです。VS Codeベースで、AIアシスタント機能が組み込まれています。

Codexとの違い

| 項目 | Codex | Cursor |
|——–|———|——–|
| 形態 | CLI, IDE拡張, App | 独立したエディタ |
| 統合方法 | 既存ツールに追加 | エディタ自体を変更 |
| モデル | OpenAIモデル | 複数モデル対応 |

使い分けのポイント

  • 既存のVS Code環境を維持したい場合はCodex IDE拡張が適しています
  • AI機能を最初から統合した環境を使いたい場合はCursorが適しています

まとめ：どのツールを選ぶべきか

| ニーズ | 推奨ツール |
|———|————|
| ChatGPTを既に契約している | Codex |
| コストを抑えたい | Codex（既存プランに含まれる） |
| 特定のLLMを使いたい | Cline, Cursor |
| エディタを変更したくない | Codex IDE拡張, Cline |
| コード補完メイン | GitHub Copilot |
| タスク単位の依頼 | Codex, Claude Code |

—

GLMでより多くのコーディングツールを活用

Codex、Claude Code、Clineなど、それぞれのツールに特徴がありますが、「複数のツールを使い分けたい」「コストを抑えたい」というニーズにお応えするサービスがあります。

GLM（Generative Language Model）は、20以上の主要コーディングツールに対応する統合プラットフォームです。

GLMの特徴

  • 20以上の主要コーディングツール対応: Claude Code、Cline、Cursor、Windsurfなど
  • 月額$10から: 複数のツールを個別に契約するよりコストを抑えられます
  • 期間限定オファーあり: お得なキャンペーンを実施中

詳細はこちら

🔗 GLM紹介URL

Claude Code、Cline、20以上の主要コーディングツール対応。月額$10から。期間限定オファーあり。

—

まとめ

Codexは、OpenAIが提供する強力なAIコーディングエージェントです。主なポイントをまとめます：

Codexのメリット

1. ChatGPTプランに含まれる: Plus、Pro、Business、Enterpriseプランで追加費用なしで利用可能
2. 複数の実行環境: CLI、IDE拡張、デスクトップアプリ、Webから選択可能
3. 幅広いタスクに対応: コード生成、レビュー、デバッグ、リファクタリングなど
4. オープンソース: CLIはRustで書かれ、GitHubで公開されている
5. 継続的な改善: 定期的なアップデートで機能が拡張されている

はじめ方

1. `npm install -g @openai/codex` でインストール
2. `codex` コマンドで起動
3. ChatGPTアカウントでサインイン
4. 自然言語で指示を入力

次のステップ

Codexを使い始めたら、以下のリソースも活用してみてください：

AIコーディングエージェントは、開発者の生産性を大幅に向上させるツールです。Codexを活用して、より効率的で楽しいコーディングライフを送りましょう！

—

参考リンク

—

*本記事は2026年3月時点の情報に基づいています。最新情報は公式ドキュメントをご確認ください。*

📚 この記事を読んだ人におすすめの書籍

関連記事

コメント

タイトルとURLをコピーしました