Codex CLIとは？初心者向けにできることや使い方をわかりやすく解説

生成AI

最終更新日: 2026/09/24

この記事のポイント

Codex CLIは、ターミナルから日本語で指示を出すだけで、AIにコードの解説や修正、テスト実行まで依頼できる強力なツールです。

「興味はあるけれどターミナル操作は難しそう」
「ChatGPTや既存のプラグインと何が違うの？」

と感じる方も多いかもしれません。

この記事では、プログラミング初心者の方でも迷わず使いこなせるよう、次のポイントをわかりやすく解説します。

ChatGPTやIDE拡張機能との違い
Codex CLIだからこそできる活用例
Codex CLIの導入手順と基本コマンド
Codex CLIを安全に使うための注意点

この記事を読めば、Codex CLIを自分の相棒として開発や学習に取り入れるイメージが湧くはずです。
面倒な作業やコード解読のストレスを減らし、開発スピードを大幅にアップさせる新しい開発スタイルの世界に足を踏み入れてみましょう。

Codex CLIの基礎知識

「CLI」と聞くと難しく思えるかもしれませんが、基本を押さえれば使い方はとてもシンプルです。

まずはCodex CLIの概要やChatGPTとの違い、どんな人に向いているのかといった基礎知識から確認していきましょう。

Codex CLIの概要

Codex CLIは、ターミナルからコードやファイルに関する作業をAIに依頼できるツールです。OpenAIが提供しており、2025年4月に公開されました。

ターミナルとは、文字だけでパソコンやプログラムを操作する画面のことです。Codex CLIのような「コマンドラインツール」は、このターミナル上に命令を入力して動かします。

CLIとは「Command Line Interface（コマンドラインインターフェース）」の略で、まさにターミナルのように、キーボードで文字を打って操作するタイプのツールです。

そしてCodex CLIは、「コーディングエージェント」の一種でもあります。コーディングエージェントとは、AIがコードの説明・作成・修正だけでなく、実際のファイルを開いて編集したり、コマンドを実行したりと、自律的にこなしてくれるAIシステムを指します。

つまり、Codex CLIを使えば「このエラーを直して」「この機能を追加して」のように日本語で入力するだけで、AIが実際のプロジェクトのファイルを読んで、必要な変更を加えて、テストまで実行してくれるのです。

本来なら、複雑なコマンドや専門知識を駆使して手動で処理しなければならない工程を、指示ひとつで完結できます。

コードが書けなくても使い始められる点が、初心者にとって大きな魅力です。

ChatGPT・Codex IDE拡張機能との違い

Codex CLIと混同しやすいツールとして、ChatGPTとCodex IDE拡張機能があります。実際、「ChatGPTと何が違うの？」と感じる方も多いでしょう。実は、各ツールで得意なことが違います。

ChatGPTは、ブラウザやアプリ上で使うチャット形式のAIです。コードの書き方を質問したり、コードのレビューを依頼したりする際に便利ですが、実際のプロジェクトのファイルに直接触れられません。あくまでテキストでのやり取りが中心なのです。

Codex IDE拡張機能とは、VSCodeなどのコードエディターの中で動作する拡張機能です。エディター上でコードを書きながらAIが補完や提案をしてくれるイメージで、コーディング中の細かいサポートに向いています。

Codex CLIは、ターミナルから使うツールで、プロジェクト全体を対象にした大きな作業が得意です。
複数のファイルをまとめて修正したり、テストを自動で実行して失敗箇所を直したりといった場面で本領を発揮します。

各ツールの役割の違いを整理できると、目的に応じてスマートに使い分けられるでしょう。

Codex CLIが向いている人

Codex CLIは、プログラミング初心者や繰り返しの作業を減らしたいエンジニア向きのツールです。

誰かが書いたコードを見て「何をやっているか全然わからない……」と途方に暮れたとき、Codex CLIに「このファイルを日本語で解説して」と頼むだけでわかりやすく教えてくれます。

一見暗号のように見えるエラーメッセージが出たときも、そのまま貼り付けて「修正して」と伝えるだけで、原因の特定からコードの修正に至るまで対応してくれるのです。

また、プロジェクトの規模が大きくなり、複数のファイルにまたがる変更が必要になった場合、Codex CLIはプロジェクト全体を把握して作業を進めてくれます。

Codex CLIはコードを読み解くストレスや面倒な定型作業を減らし、本質的なプログラミングや学習に集中したい方にぴったりのツールです。

無料利用とChatGPTプラン別の料金

Codex CLIは、ChatGPTの無料プランを含むすべてのプランで利用できます。ただし、プランによって1か月の利用上限量が違います。

無料プランでも基本的な機能を試すことはできます。しかし、使える回数や扱えるメッセージの量に制限があるため、ある程度使い込みたい場合は、有料プランへのアップグレードが必要になるでしょう。

各プランの料金や上限は変更される場合がありますので、最新情報は公式サイトで確認してください。

APIキー利用時の課金

Codex CLIの利用方法は「ChatGPTアカウントでログインする方法」と「APIキーを使う方法」の2種類があり、課金の仕組みが違います。

ChatGPTアカウントでログインする場合は、加入しているプランの利用上限内で使える形になります。料金的にはシンプルでわかりやすいです。

APIキーを使う場合は、ChatGPTのプランとは別に、処理した量に応じた費用が発生します。APIキーとは、OpenAIのサービスを使うための「通行証」のようなものです。一般的に、トークンと呼ばれる処理した文字や単語の量に応じた従量課金となるため、思った以上に費用がかさんでしまうリスクがあります。

APIキーを設定する際には、OpenAIの管理画面で使用量の上限をあらかじめ設定しておくのをおすすめします。利用頻度や目的に応じて、自分に合ったログイン方法を選びましょう。

Codex CLIでできること

Codex CLIは、単なるコードを書いてくれるだけのツールではありません。コードの説明や修正といった基本的な作業から、コマンド実行を伴うテストや自動化まで、その機能は多岐にわたります。ここでは代表的な活用例を紹介します。

コードの説明・作成・修正

Codex CLIに依頼できる基本的な作業は、次の3つです。

既存コードの解説
新機能の追加
複数ファイルにまたがる修正

例えば、誰かが書いたコードを引き継いで「何をしているのかわからない」と感じたときでも、「このファイルの処理内容を日本語で説明して」と依頼するだけで、コードを読み解いてわかりやすく教えてくれます。

また「ユーザーの入力値を検証する関数を追加して」のように伝えれば、実際にコードを書いてファイルに追記してくれます。

特に便利なのが、複数のファイルをまとめて修正する作業です。「プロジェクト全体でこの関数名を変えたい」「エラー処理の書き方を統一したい」といった場合でも、関係するすべてのファイルを調べてまとめて変更してくれます。

これはブラウザ上のChatGPTでは難しい操作で、Codex CLIならではの強みです。

コマンド実行とテスト・デバッグ

Codex CLIはコードの生成だけでなく、実際にコマンドを実行してテストやビルド、エラーの調査まで一連の作業を自律して行うことができます。

「テストを実行して失敗している箇所を直して」と依頼すると、Codex CLIはテストコマンドを実行し、実行に失敗した箇所を特定してコードを修正、再度テストを実行するという流れを自動でこなしてくれます。

「このエラーメッセージの原因を調べて修正して」と伝えれば、エラーログを解析して修正案を実装してくれます。

従来は手作業で繰り返していた「実行→確認→修正→また実行」という流れを、まるごと任せられるのは大きなメリットです。

コードレビューと作業の自動化

Codex CLIは、コードレビューや面倒なルーティン作業を自動化するツールとしても非常に優秀です。

日本語で指示できるのは上述した通りですが、よく使う作業を一瞬で呼び出せる専用のコマンドも用意されています。簡単にいえば、ショートカットキーのようなイメージです。

例えば、codex reviewコマンドを使うと、変更したコードに対してAIがレビューを行い、潜在的な問題点や改善点を指摘してくれます。自分では気付けないバグの予防や、コードの品質を高める目的で活用できます。

また、codex execコマンドを使えばコードの整形やドキュメント作成といった定型作業をスクリプトとして登録し、自動で実行できます。

さらに開発フローのパイプラインにCodex CLIを組み込んで、コードのチェックを自動化する使い方も可能です。

AGENTS.mdによる指示の共有

Codex CLIは起動するたびに会話の記憶がリセットされます。つまり、毎回「このプロジェクトはPythonを使っています」「テストにはpytestを使います」といった説明を繰り返す必要があります。それを解消するのがAGENTS.mdです。

プロジェクトのルートフォルダにAGENTS.mdというファイルを置いておくと、Codex CLIは起動のたびにそのファイルを読み込みます。

ここにプロジェクトのルールや使用言語、バージョン、コーディング規約などを書いておけば、毎回説明しなくても一貫した作業をしてくれるようになります。

チームで開発している場合は、AGENTS.mdをGitで共有すればチーム全員が同じルールをCodex CLIに伝えられます。

Codex CLIの導入方法と使い方

ここからは、実際にCodex CLIを使い始めるための手順を説明します。ターミナルを触った経験がないという方でも迷わず進められるよう順を追って説明します。

インストール前の準備

Codex CLIをスムーズに使い始める前に、環境を整えておく必要があります。

まずは、利用しているPCのOSを確認してください。
Codex CLIは下記のOSに対応しています。

macOS
Linux
WindowsのWSL（Windows Subsystem for Linux）

Windowsのネイティブ環境でも動かすことは可能ですが、環境次第ではパスの設定エラーや動作制限が発生しやすいため、WindowsユーザーはWSL2（Windows Subsystem for Linux）上の環境で動かすのが推奨されています。

次に、ターミナルが使える状態かどうかを確認してください。macOSであれば「ターミナル」アプリ、Linuxであれば端末エミュレーター、WindowsであればWSLのコンソールが使えればOKです。

また、Node.jsというソフトウェアのバージョン22以上がインストールされている必要があります。
Node.jsとは、簡単にいうとJavaScriptを動かすための実行環境です。Node.jsの公式サイトから無料でダウンロードできます。

ちなみに、作業対象のプロジェクトフォルダはGitで管理しておくのを強くおすすめします。Codex CLIは実際にファイルを書き換えるため、万が一意図しない変更があったときにGitがあれば元に戻せるからです。

Codex CLIのインストールとログイン

準備が整ったら、インストールを進めましょう。ターミナルを開いて、次のコマンドを入力してください。

npm install -g @openai/codex

インストールは数分で完了します。インストールが終わったら、codexと入力して起動します。初回はログインが必要です。

ChatGPTアカウントを使う場合は、ブラウザが自動で起動し認証画面が表示されるので、指示に従ってログインを完了してください。APIキーを使う場合は、OpenAIの管理画面で発行したキーをOPENAI_API_KEYという環境変数に設定してから起動します。

ログインが完了するとチャット画面のようなインターフェースが表示されます。日本語でそのまま指示を入力できるので、初回は試しに「こんにちは」のように入力して動作を確認してみましょう。

基本コマンドと日本語による指示

Codex CLIには、覚えておくと便利なコマンドがあります。基本的なコマンドをいくつか見てみましょう。

/status：現在の設定やモデルの状態を確認できる
/model：使用するAIモデルを確認・変更できる
/review：その時点での変更内容をレビューできる

日本語での指示は、変更内容に加えて「対象ファイル」「条件」「目的」をセットで伝えると精度が上がります。どのファイルに対して、どんな条件で、何をしてほしいかを明確にするのです。

例えば「main.pyのエラー処理について、例外が発生したときにエラーメッセージをログに記録するようにして」のように伝えると、Codex CLIはやるべきことを正確に理解して作業を進められます。あいまいな指示より、具体的に伝えるほど思い通りの結果が得られやすくなります。

VSCodeの統合ターミナルで使う方法

普段からVSCodeでコードを書いている方には、VSCodeの統合ターミナルからCodex CLIを使う方法がおすすめです。エディターでコードを確認しながら、その画面のまま下部のターミナルでAIに指示を送れます。

VSCodeでプロジェクトフォルダを開いたら、メニューから「ターミナル」→「新しいターミナル」を選択します。あとは通常のターミナルと同じようにcodexコマンドを実行するだけです。

AIが変更したファイルはエディター上にリアルタイムで反映されるため、差分を目で確認しながら作業を進められるのが便利です。

安全に利用するための注意点

Codex CLIはファイルの書き換えやコマンドの実行など、実際の環境に影響を与える操作を行います。
強力なツールだからこそ、使い方を誤ると取り返しのつかない変更が起きてしまうリスクもあるのです。安全に使うための基本的な考え方を押さえておきましょう。

権限・サンドボックス・承認設定

Codex CLIはデフォルトで「実行前に人間が承認する」設定になっています。AIが勝手にファイルを変更したりコマンドを実行したりしないよう、最初から安全に設計されているのです。

AIがどの範囲の操作を行えるか、起動時のオプションで次の3つの承認モードを切り替えられるようになっています。

--full-auto：すべての操作を承認なしで自動実行する
コマンド実行のみ承認が必要
すべての操作で承認が必要（デフォルト）

また、Codex CLIはサンドボックスという制限された実行環境で動作するよう設計されており、意図せずシステム全体に影響を与えてしまうリスクは下がっています。ただし、--full-autoモードや書き込み権限を広く与える設定は、意図しないファイルの変更や削除につながる危険性があります。
慣れないうちはデフォルトの設定のまま使い始め、AIが提案する変更をひとつずつ確認してから承認するようにしましょう。

安全に使うための運用ルール

Codex CLIを安全に使うための最も重要なルールがあります。それは、変更前の状態をGitで保存しておくことです。

Codex CLIが加えた変更が意図通りでなかった場合、Gitに保存されていればgit checkoutなどのコマンドで元に戻せます。作業を始める前にgit addとgit commitで現在の状態をコミットしておく習慣をつけましょう。

変更後は変更内容をすぐに採用するのではなく、git diffで差分を確認しましょう。どのファイルのどこが書き換わったかを自分の目で把握し、必要に応じてテストを実行して既存の機能が壊れていないかをチェックしてください。

「AIがやってくれたから大丈夫」と過信せず、最後は人間がしっかり成果物を確認して採用を決めるのが、安全でスマートな運用のコツです。

よくある質問（Q&A）

Q. Codex CLIはWindows単体で使えますか？

Codex CLIはWindows単体のコマンドプロンプトやPowerShellでは正式に対応していません。WindowsでCodex CLIを使うには、WSL（Windows Subsystem for Linux）を有効にしてLinux環境を構築した上で利用する必要があります。WSLはMicrosoftの公式ドキュメントに沿って導入できます。

Q. 指示は英語でないとうまく動きませんか？

日本語での指示にも対応しています。「app.pyのcalculate_tax()関数にコメントを日本語で追加して」のように具体的に書くと精度が高まります。ただし、出力されるコメントや変数名が英語になる場合もあるため、日本語で出力してほしい場合はその旨を明示するとよいでしょう。

Q. AGENTS.mdはどんな内容を書けばいいですか？

プロジェクトのフォルダ構成、使用している言語やフレームワークのバージョン、テストの実行方法、コーディングのルールなどを記載するのが基本です。例えば「Python 3.12、テストはpytest、関数名はsnake_case」のような内容で箇条書きで書くと読み込みやすくなります。最初は数行から始めて、使いながら追記していく方法がおすすめです。

Q. Codex CLIが生成したコードが動かないときはどうすればいいですか？

まずエラーメッセージをそのままCodex CLIに貼り付けて「このエラーを修正して」と依頼してみてください。それでも解決しない場合は、git checkoutで変更前の状態に戻し、指示をより具体的に書き直して再試行するのが有効です。生成されたコードをそのまま使うのではなく、内容を理解してから採用する点も忘れないでください。

Q. 複数のプロジェクトで別々のAGENTS.mdを使えますか？

使えます。AGENTS.mdは各プロジェクトのルートフォルダに置くため、プロジェクトごとに異なる内容を設定できます。Codex CLIを起動するフォルダによって参照されるAGENTS.mdが変わるため、プロジェクトを切り替えるたびに適切なルールが自動で読み込まれます。