Codexの使い方完全ガイド｜導入から実践まで総まとめ

公開: 2026年8月3日

Codexは、OpenAIが提供するAIコーディングエージェントです。この記事は、Codexを初めて知った方が「何ができて、どう始めて、どう使いこなせばよいか」を1本で把握できるように構成した総まとめです。概要・料金・インストールという導入部分から、CLIの基本操作、VSCode連携、AGENTS.mdによる精度向上、クラウド・GitHub連携、Claude Codeとの使い分けまでを目次のように順を追って紹介します。各トピックはここで概要だけをつかみ、詳しい手順や設定例は本文中のリンク先にある個別記事で確認してください。ブックマークしておき、必要なセクションだけ読み返す使い方もおすすめです。

Codexとは(概要)

Codexは、目標やタスクを伝えると、AIが自律的にコードベースを読み、変更を加え、実行結果を確認しながら作業を進めてくれるエージェント型のツールです。単にコードを1行補完するだけのツールとは異なり、複数ファイルにまたがる変更やテストの実行、修正の繰り返しといった一連の作業をまとめて任せられる点が特徴です。CLI・IDE拡張・クラウド(ChatGPT連携)・GitHubコードレビュー連携という4つの入口を持ち、目的に応じて使い分けられます。検索結果には2021年に発表された別物の旧Codex(GPT-3系のコード生成モデル)が混ざることもあるため、その違いも含めて「Codexとは?OpenAIのAIエージェントをわかりやすく解説」で詳しく整理しています。

料金と必要なプラン

Codexを使うには、ChatGPTのPlus・Pro・Business・Enterpriseいずれかの有料プランに加入するか、OpenAIのAPIキーで従量課金契約を結ぶ必要があり、無料プランでは基本的に利用できません。まず試すならPlus(月額$20)、コーディング中心で大量に使うならPro(月額$100〜$200)、チーム導入ならBusiness、組織全体で管理したいならEnterpriseが目安です。使用量は直近5時間のローリングウィンドウを基準に管理されており、タスクの重さによって消費ペースが変わります。プラン別の料金比較や使用制限の目安は「Codexの料金まとめ｜ChatGPTプラン別の使用制限も解説」で詳しく解説しています。

インストール

Codex CLIは、npmコマンド1つでWindows・Mac・Linuxのどの環境にも導入できます。すでにNode.js 22以降が入っていればnpm install -g @openai/codexが最もシンプルで、Macであればbrew install --cask codexというHomebrew経由の方法もあります。インストール後は対象のプロジェクトフォルダでcodexを実行し、初回起動時にChatGPTアカウントまたはAPIキーでサインインすれば準備は完了です。パッケージ名の取り違えやPATHが通らないといったつまずきポイントも含めて、具体的な手順は「Codex CLIのインストール手順｜Windows・Mac対応」で解説しています。

CLIの基本操作

Codex CLIは、codexで起動する対話モードと、codex exec "指示"で1回のタスクを完結させる非対話モードを使い分けて使います。ファイルの編集やコマンド実行をどこまで自動で行うかは、読み取り専用・自動編集・フルアクセスの3段階からなる「承認モード」でコントロールでき、/permissionsでその場に切り替えられます。ほかにも、AGENTS.mdのたたき台を生成する/initや、セッション設定を確認する/status、モデルを切り替える/modelなど、よく使うスラッシュコマンドがいくつかあります。起動方法から実践的な依頼例、設定ファイルの扱いまでは「Codex CLIの使い方｜コマンド・操作方法まとめ」にまとめています。

VSCode(IDE)連携

CodexにはVS Code向けの公式IDE拡張機能(拡張ID: openai.chatgpt)が用意されており、Marketplaceからインストールしてサインインするだけで、エディタ内のサイドバーからコードの編集やレビューを依頼できるようになります。開いているファイルや選択範囲を文脈として渡せるほか、変更内容をインプレイスの差分としてレビューでき、時間のかかるタスクはクラウド版に委譲することも可能です。CursorやWindsurfなどVS Code互換のフォークエディタでも同じ拡張が使えます。日常的な編集はIDE拡張、自動化や細かい制御が必要な場面はCLIという使い分けも含めて、「CodexのVSCode拡張の使い方｜IDE連携の設定方法」で詳しく紹介しています。

AGENTS.mdで精度を上げる

AGENTS.mdは、ビルドコマンドやコーディング規約、禁止事項など、AIエージェントに毎回説明し直している前提知識をまとめておくためのオープンな標準フォーマットです。Codexは、ホームディレクトリ(既定~/.codex)のグローバルなAGENTS.mdと、Gitリポジトリのルートから作業ディレクトリまでの各階層のAGENTS.mdを連結して読み込み、作業ディレクトリに近いファイルほど優先されます。Codex CLIの/initコマンドを使えばリポジトリを解析したたたき台を自動生成できるので、そこにチーム独自のルールを書き足していくのが効率的です。書くべき内容の具体例やアンチパターン、Claude CodeのCLAUDE.mdとの対比は「AGENTS.mdの書き方｜Codexへの指示ファイル設定」で解説しています。

クラウドとGitHub連携

Codexクラウドは、ChatGPTのWeb版やモバイルアプリからGitHubリポジトリに対するタスクを委任できる機能です。依頼したタスクはローカルではなくクラウド上のサンドボックス環境で実行されるため、手元の環境を汚さずに複数タスクを並行して進められ、完了後は差分を確認してそのままPRを作成できます。セットアップ方法や並列タスクの活用、CLI・IDE拡張との連携については「Codexクラウドの使い方｜ChatGPTからタスクを委任する」で解説しています。

作成したPRに対しては、Codexによる自動コードレビューも活用できます。リポジトリでCode review設定を有効にしておけば、新しいPRが作成されるたびに自動でレビューが走るほか、コメント欄に@codex reviewと書き込めば手動でも依頼できます。セキュリティ上の懸念やテスト不足などを指摘してくれますが、あくまで人間による最終判断の前段階を補助するシグナルという位置づけです。設定手順や@codex fix itでの修正依頼まで、詳しくは「CodexにPRレビューを任せる方法｜GitHub連携設定」を参照してください。

Claude Codeとの比較・使い分け

CodexとClaude Codeは、いずれも自然言語で指示するだけでコードの実装・修正・テスト・PR作成までを自律的にこなす、2026年時点を代表する2大コーディングエージェントです。どちらも十分に優秀で機能差だけで一方に絞る必要はなく、すでにChatGPT系のサブスクを契約しているならCodex、Claude系のサブスク(Claude Pro/Max)を契約しているならClaude Codeから始めるのが合理的です。CodexはChatGPTエコシステムとの一体運用と複数タスクの並列委任が強みで、Claude CodeはMCP・Skills・Subagentsによる拡張性が強みという住み分けになります。指示ファイルもCodexはAGENTS.md、Claude CodeはCLAUDE.mdと役割の近いものがそれぞれ用意されています。両者の違いをエコシステム・クラウド委任・料金の観点で整理した比較は「CodexとClaude Codeの違いを比較｜どっちを選ぶべき?」を、Claude Code自体の使い方を体系的に知りたい方は「Claude Codeの使い方完全ガイド｜導入から実践まで総まとめ」もあわせてご覧ください。

困ったときは

「codexコマンドが見つからない」「サインインできない」「使用制限に達した」「Windowsで動かない」「サンドボックス・承認でブロックされる」といったトラブルは、Codexが動かないときによく報告される症状です。まずは最新版へのアップデートとアプリ・ターミナルの再起動を試し、それでも解決しなければ症状に近い見出しを確認するのが早道です。ログの確認場所や、解決しない場合のGitHub Issuesの探し方まで、症状別の原因と対処法は「Codexが動かない時の対処法｜エラー原因別まとめ」で詳しく解説しています。

よくある質問

Codexは何から始めればいいですか?

まずはChatGPTの有料プラン(Plus以上)かAPIキーを用意し、OSに合わせてCodex CLIまたはVS Code拡張機能を導入してサインインするところから始めます。次に/initでAGENTS.mdを作成し、基本的なスラッシュコマンドと承認モードの切り替えを一通り試してみると全体像がつかみやすくなります。

プログラミング初心者でも使えますか?

使えます。自然言語で目標やタスクを伝えるだけで動作するため、知識がなくても触れること自体は可能です。ただし生成されたコードの妥当性を判断したり、より的確な指示を出したりするには、基本的なコードの知識があると活用の幅が広がります。まずは承認モードを読み取り専用にして、提案内容を確認しながら慣れていくのがおすすめです。

この記事だけ読めばCodexを使いこなせますか?

概要をつかむには十分ですが、実際に手を動かす際は各トピックのリンク先にある個別記事を参照してください。特にAGENTS.mdの整備と、クラウド・GitHub連携などの実践的な活用方法を押さえると、日常の作業で使いこなせるようになります。

まとめ

Codexは、概要と料金を理解し、CLIまたはVS Code拡張機能を導入してChatGPTアカウントでサインインすれば、すぐに使い始められます。そのうえでAGENTS.mdを整備して指示の精度を高め、クラウドでのタスク委任やGitHubのコードレビュー連携といった実践的な機能を取り入れていくことで、日々の開発作業を大きく効率化できます。すでにClaude Codeを使っている方や、これから他のツールとも比較したい方は、Claude Codeとの違いを整理した比較記事もあわせて参考にしてください。困ったときは、慌てずにトラブルシューティングの記事を確認しましょう。

いきなりすべてを覚える必要はありません。最初の1週間はインストールと基本操作に慣れることに集中し、慣れてきたらAGENTS.mdの整備、クラウドやGitHub連携の活用へと段階的に広げていくのがおすすめです。困ったときに立ち返れるよう、このガイドをリファレンスとして活用してください。