Codex CLIの使い方｜初心者が最初の30分でやること

「Codex CLIの使い方を、初心者にもわかる順番で知りたい！」
「ターミナルで動くAIって、そもそも何をしてくれるの？」

Codex CLIはOpenAIが出しているコーディングエージェントで、ターミナルの中に住みつくタイプのAIです。
チャット欄にコードを貼って質問する使い方とは違い、ファイルを読んで、書き換えて、コマンドまで動かしてくれます。

この記事では、Codex CLIの使い方を導入から実践まで、つまずきやすい箇所の回り道も添えて並べました。

Codex CLIとは？初心者がまず押さえたい全体像

Codex CLIは、ターミナルから起動して日本語で指示を出せるコーディングエージェントです。

ここでは、Codex CLIが何をしてくれるのか、そして似たツールとどう違うのかを整理していきましょう。

Codex CLIはターミナルで動く「手を動かす側」のAI

ChatGPTに質問すると、答えは返ってきますが、実際にファイルを直すのは自分です。
Codex CLIはここが根本的に違います。
プロジェクトのフォルダに入って codex と打つと、そのフォルダ全体を読める状態でAIが待ってくれているんですね。

「このエラーの原因を調べて直して」と日本語で頼めば、関係しそうなファイルを自分で探し、書き換え、テストを走らせるところまで一気に進みます。

私が最初に驚いたのは、指示を細かく分解しなくてよかった点でした。
ファイル名も行番号も伝えていないのに、プロジェクトの構造を読んで当たりをつけてきます。

OpenAIはCodex CLIをオープンソースとして公開していて、中身はRustで書かれています。
起動が速く、動作が軽いのはこのあたりが理由でしょう。

もちろん万能ではありません。
画面のデザインを整えるような視覚的な調整は、ターミナルの中だけでは判断材料が足りず、指示がどんどん長くなりました。

得意なのは、条件がテキストで書ける作業です。
「テストが落ちている原因を探す」「同じ処理が散らばっているのでまとめる」といった依頼とは、相性がとてもいいですよ。

Web版CodexやChatGPTとの違い

ややこしいのですが、OpenAIの「Codex」には入口が複数あります。

ターミナル版がCodex CLI、ブラウザで動かすクラウド版がCodex Web、そこにデスクトップアプリとIDE拡張が加わる形ですね。

どこから触り始めるかで、できることも料金の効き方も変わります。選び分けの基準はCodexの使い方は4つの入口から選ぶ｜CLIとクラウドの違いにまとめました。

中身のモデルは共通なので、どれを使っても回答の質そのものは大きく変わりません。
違うのは、どこのファイルを触れるかと、作業中にPCを占有するかどうかでした。

使い分けの基準はシンプルで、自分のPCのファイルを直接触ってほしいならCLI、時間のかかる作業をクラウドに投げたいならWeb版になります。

Web版は自分のマシンを占有しないので、大きなリファクタリングを回している間も手元の作業を続けられました。
逆に、まだGitHubに上げていないローカルの実験コードを触らせたいときは、CLIしか選択肢がありません。

初心者が最初に触るなら、動きが目に見えるCLIをおすすめします。
何をどう変えたのかがターミナルに流れるので、AIの動きを理解しながら進められるからです。

Claude CodeやCursorとの立ち位置の違い

同じターミナル型のエージェントとしてよく比べられるのが、AnthropicのClaude Codeです。
どちらもやれることは近いのですが、料金の入口が違います。
Codex CLIはChatGPTの有料プランに含まれ、Claude CodeはClaudeの有料プランに含まれる形になっています。

すでにChatGPTに課金しているなら、追加費用ゼロで始められるのがCodex CLIの強みでしょう。
一方のCursorは、エディタそのものがAI化されたツールです。
コードを書きながら補完を受ける体験に強く、ターミナルで丸ごと任せる使い方とは役割が分かれます。

実務では、設計や大きめの実装をClaude Codeに任せ、細かい修正やレビューをCodexに回す、といった併用も普通に成立しました。
ツールの違いはClaude CodeとCursorの違い比較でも整理しています。

Codex CLIを使う前に必要なもの｜動作環境と料金プラン

Codex CLIを動かすには、対応OSとChatGPTアカウントの2つが必要です。

ここでは、インストール前に確認しておきたい要件と、費用がいくらかかるのかを見ていきます。

対応OSとシステム要件を確認する

公式リポジトリには、動作環境がはっきり書かれています。

注意したいのはWindowsです。公式にはWSL2経由での動作が前提とされていて、PowerShellだけで完結させようとすると挙動が安定しません。

Windowsユーザーは、先にWSL2とUbuntuを入れてしまうほうが結果的に早く済みます。

Gitは必須ではありませんが、入れておく価値があります。
AIが書き換えた内容を差分で確認したり、気に入らなければ丸ごと戻したりできるからです。

メモリの推奨が8GBというのは、Codex CLI単体の話ではありません。
エディタとブラウザとターミナルを同時に開いた状態が前提なので、4GBのマシンだと編集中に固まることがありました。
古いMacを使っている方は、macOS 11以前だとインストーラーが途中で止まるので、OSのバージョンを先に確認しておいてください。

利用できるChatGPTのプランと料金

Codex CLIそのものは無料で配布されていて、費用がかかるのは動かすためのアカウント側になります。
公式リポジトリでは、ChatGPTのPlus・Pro・Business・Edu・Enterpriseの各プランで利用枠が含まれると案内されていました。

個人で使うなら、月20ドルのPlusから始めるのが現実的な選択でしょう。
この価格でChatGPT本体もCodexも使えるので、AIコーディングの入口としては安いほうだと思います。
利用枠は一定時間ごとにリセットされる仕組みなので、重い作業を連投すると上限に当たることがありました。

最新の金額と枠はOpenAI公式の料金ページで確認してください。
セッション中に /status を打てば、いまの設定と利用状況も見られます。
ツール全体の相場感はAIコーディングの費用相場にまとめました。

APIキー課金を初心者にすすめない理由

Codex CLIは、ChatGPTアカウントの代わりにAPIキーでも動かせます。
ただし初心者の最初の一歩としては、私はおすすめしていません。
理由は単純で、APIキーは使った分だけ青天井で請求されるからです。

エージェント型のツールは、こちらが「ちょっと直して」と頼んだだけでも、裏でファイルを何十個も読みます。
そのすべてがトークンとして課金対象になるため、感覚と請求額がずれやすいんですね。

月額プランなら、上限に当たったときに止まるだけで済みます。
いくら使ったか気にせず練習できる状態は、学習初期にはかなり大きいメリットです。

Codex CLIのインストール手順｜MacとWindowsの初期設定

準備が整ったら、いよいよインストールです。作業は5分ほどで終わります。

ここでは、インストールからサインイン、最初の起動確認までを順番に進めましょう。

【ステップ1】公式インストーラーでCodex CLIを入れる

いちばん確実なのは、Codex公式ドキュメントで案内されているインストーラーを使う方法です。

MacとLinuxなら、ターミナルに次の1行を貼り付けてください。

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

Windowsの場合は、PowerShellで以下を実行します。

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

すでにNode.jsやHomebrewを使っている方は、パッケージマネージャー経由でも構いません。

npm install -g @openai/codex
brew install --cask codex

npmを選ぶ場合はNode.jsの22以降が必要です。
古いバージョンのままだと、インストール自体は通るのに起動で落ちる、という厄介な状態になりました。
入ったかどうかは、バージョン表示で確認できます。

codex --version

数字が表示されれば成功です。
エラーが出たときは、インストール自体を疑う前にターミナルを開き直してもう一度試してみてください。
3つの入れ方で迷ったら、Node.jsもHomebrewも要らない公式インストーラーを選んでおけば間違いありません。

【ステップ2】ChatGPTアカウントでサインインする

インストールが済んだら、ターミナルで codex と入力してください。

初回起動では認証方法の選択肢が出てくるので、「Sign in with ChatGPT」を選びましょう。
するとブラウザが自動で開き、いつものChatGPTのログイン画面が表示されます。
そこで許可すればターミナルに戻り、認証済みの状態でセッションが始まりました。

（出典：OpenAI「Codex CLI」公式ドキュメント／2026年8月11日時点）

ブラウザが開かない環境では、ターミナルに表示されたURLを手動でコピーして開けば同じことができます。
リモートサーバーやWSL2で作業しているときは、こちらの手順になることが多いでしょう。

認証情報はホームディレクトリの設定フォルダに保存されるため、2回目以降はこの作業が要りません。
会社と個人でアカウントを使い分けている方は、どちらでログインしたか意識しておいてください。
あとから「利用枠が減らない」と悩んだとき、原因が別アカウントだったというのはよくある話でした。

【ステップ3】作業フォルダで起動して動作を確かめる

Codex CLIは、起動したフォルダを作業範囲として認識します。
だからホームディレクトリで起動するのではなく、必ずプロジェクトのフォルダに移動してから立ち上げてください。

cd ~/projects/my-app
codex

プロンプトが出たら、まずは軽い質問を投げてみましょう。

このプロジェクトの構成を、初めて見る人向けに説明してください

フォルダを読み込みながら要約が返ってくれば、セットアップは成功です。
終了したいときは /quit または /exit と入力します。
反応がなくなった場合は、Ctrl+Cを2回押せば強制的に抜けられました。

初回だけは、反応がないように見えても少し待ってあげてください。
読み込みが終わればプロンプトが返ってきます。

ターミナル操作そのものに不安がある方は、ターミナルの使い方を先に眺めておくと気が楽になりますよ。
フォルダの移動とファイル一覧の表示さえできれば、Codex CLIを動かすには十分です。

Codex CLIの使い方｜初心者が最初の30分でやる3つのこと

ここからが本題です。何を最初に試すかで、Codex CLIへの信頼感が大きく変わります。

私がおすすめしているのは、いきなり作らせるのではなく、読ませる・小さく直させる・戻す、という順番でした。

【ステップ1】いまのコードを説明してもらう

最初にやるべきは、修正ではなく質問です。
AIがそのプロジェクトをどこまで正しく読めているか、先に確かめておくと安心して任せられます。

src配下のファイルがそれぞれ何をしているか、一覧で教えてください
このプロジェクトで一番複雑な処理はどこですか。理由も添えてください

返ってきた説明が的外れなら、その時点で修正を頼むのは危険です。
読み込ませたいファイルを絞るか、フォルダを移動してから起動し直しましょう。

逆に、自分の理解と一致した説明が返ってきたなら合格でした。
ここまで来ればコードを触らせても、大きく外れることはほとんどありません。

おもしろいのは、この工程が自分の勉強にもなる点でしょう。
他人が書いた古いコードを引き継いだとき、まずCodexに説明させてから読むと、理解までの時間が半分以下になりました。

【ステップ2】小さな修正をひとつだけ頼む

次は、影響範囲が小さくて結果が目に見える作業を選びます。
おすすめは、エラーメッセージの日本語化、変数名の統一、コメントの追加あたりでしょうか。

login.jsのエラーメッセージを日本語に書き換えてください。処理の中身は変えないでください

ポイントは、「何をしないか」まで指示に含めることでした。
範囲を明示しないと、ついでに関数を整理されたりして差分が膨らみます。

実行すると、変更しようとしているファイルと内容が画面に表示され、進めてよいか聞かれました。
この確認をよく読む習慣をつけておくと、あとで慌てずに済みます。

1回の指示は1つの目的まで。
欲張って3つ並べた指示を投げた日は、たいてい途中で意図がずれていきました。

結果に納得できなかったときは、指示を書き直すより「なぜそう直したのか」を聞くほうが早いです。
意図のずれがどこで生まれたのかがわかり、次の依頼文が的確になりました。

【ステップ3】差分を確認して、いつでも戻せる状態にする

修正が終わったら、必ず差分を見てください。
Codexにも /review という変更点をレビューさせるコマンドがありますが、初心者のうちはGitの標準コマンドで見るほうが確実です。

git diff

意図しない箇所まで書き換わっていたら、遠慮なく元に戻しましょう。

git checkout -- .

この「戻せる」という感覚を最初に持てるかどうかが、いちばん大きな分かれ目だと思っています。

作業を始める前にコミットしておけば、どれだけ荒らされても1コマンドで戻れます。
逆にGit管理していないフォルダでエージェントを走らせるのは、正直こわいですね。

差分を読む力そのものも、ここで一緒に育ちました。
AIが書いたコードを毎回眺めていると、自分では思いつかなかった書き方に出会えるので、学習効率という意味でもおいしい工程です。

Codex CLIの承認モードとサンドボックスで暴走を防ぐ

Codex CLIには、AIがどこまで勝手に動いてよいかを決める仕組みが用意されています。

ここでは、承認モードの種類と、作業中に権限を切り替える方法を見ていきましょう。

3つの承認モードの違いを理解する

Codexの権限設定は、大きく3段階に分かれています。

初期状態のAutoは、よく考えられた落としどころです。作業フォルダの中は自由、外に出るときは確認という線引きなので、初心者はここから動かす必要がありません。

Full Accessは、正直なところ初心者が触るモードではないと思っています。
ネットワーク越しの操作まで許可することになるため、使うなら壊れても困らない検証環境に限定してください。

逆に、Read Onlyはもっと使われていい設定でしょう。
「今日は調べるだけ」と決めた時間帯にこれを選んでおくと、意図しない書き換えが物理的に起きなくなります。

/permissionsで作業中に権限を切り替える

権限は、セッションの途中でも変えられます。
プロンプトに /permissions と入力すると、現在のモードと選択肢が表示されました。

/permissions

私がよくやるのは、読ませる工程だけRead Onlyに落とすやり方です。
調査を頼んでいるときにファイルを触られる心配がなくなるので、気が散りません。

逆に、テストを何度も回すような作業ではAutoのまま進めます。
1回1回の確認が入ると、かえって流れが止まってしまうからですね。

作業の性質にあわせて権限を上げ下げする。この感覚が身につくと、エージェント型のツール全般が扱いやすくなります。

権限とあわせて意識したいのが、起動する場所でした。
作業フォルダの中しか触れないという制約は、そもそもどこで起動したかで決まります。
ホームディレクトリで起動してしまうと、その制約がほとんど意味をなさないので気をつけてください。

覚えておくと役立つスラッシュコマンド

Codex CLIの操作は、ほとんどが日本語の指示で完結します。
そのうえで、いくつかのコマンドを知っておくと作業が速くなりました。

とくに /model は覚えておく価値があります。
軽い作業に重いモデルを使うと利用枠を無駄に消費するので、調査や整形は軽いモデル、設計や難しいバグ調査は重いモデル、と切り替えると1日の作業量が変わりました。

コマンドを全部覚える必要はありません。
プロンプトで / を打てば候補が一覧で出るので、そこから選べば済みます。

Codex CLIをAGENTS.mdで自分専用に育てる方法

同じ指示を毎回書くのが面倒になってきたら、AGENTS.mdの出番です。

ここでは、プロジェクトのルールをファイルに書いて覚えさせる方法を紹介します。

AGENTS.mdはCodexへの「作業指示書」

AGENTS.mdは、エージェント向けのREADMEとして提案されている共通フォーマットです。
プロジェクトのルートに置いておくと、Codexが作業を始める前に必ず読んでくれます。

人間向けのREADMEには書きにくい、テストの走らせ方やコミットメッセージの書式といった細かい約束事を、ここにまとめておくイメージですね。
作り方は簡単で、Codexのプロンプトで /init と打てば下書きを生成してくれました。
そのあと、自分のプロジェクト固有のルールを追記していけば十分です。

Claude Codeを使っている方なら、CLAUDE.mdとほぼ同じ役割だと思ってください。
書き方のコツはCLAUDE.mdの書き方にまとめてあり、そのまま流用できます。
ファイル名が共通仕様として決まっているので、ツールを乗り換えても同じファイルを読ませられるのがありがたいところでした。

最初に書いておきたい5つの項目

白紙から書き始めると迷うので、埋める枠を決めてしまうのが早いです。

効果が大きいのは、3つ目と4つ目でした。
パッケージマネージャーを書いていなかったせいで、yarnで管理しているプロジェクトにnpmでインストールされ、ロックファイルが二重になったことがあります。
1行書いてあれば防げた事故でした。

禁止事項も同じで、「migrationsディレクトリは編集しない」と書いておくだけで、余計な差分がぐっと減ります。

最初から完璧を目指さないでください。
同じ注意を2回書いたなと感じた瞬間に1行足す、という育て方がいちばん続きました。

置き場所と読み込みの優先順位

AGENTS.mdは、1つのプロジェクトに複数置けます。
大きなリポジトリでは、ルートに全体の方針を書き、サブプロジェクトごとに個別のAGENTS.mdを置くのが定番でしょう。

このとき効いてくるのが優先順位で、編集対象のファイルにいちばん近いAGENTS.mdが優先されます。

フロントエンドとバックエンドでコード規約が違うようなリポジトリでも、それぞれのフォルダにファイルを置けばきれいに切り替わりました。

個人の好みはホームディレクトリ側の設定に書いておくと、どのプロジェクトでも効きました。
チーム共有のルールはリポジトリに、自分だけの癖はホームに、と分けておくと管理が楽です。

指示は長くなるほど守られにくくなります。
フォルダ単位に散らすほうが、結果的にきちんと効いてくれました。

Codex CLIで初心者がつまずく5つの落とし穴と対処法

ここからは、私や周囲が実際にハマった箇所をまとめます。

先に読んでおけば、詰まったときの復帰が早くなるはずです。

【落とし穴1】codex: command not foundが出る

インストールが終わったのに、codex と打っても「command not found」と返ってくる。
最初にぶつかる壁は、たいていこれですね。

原因のほとんどは、実行ファイルの置き場所がPATHに登録されていないことにあります。
いちばん手軽な対処は、ターミナルをいったん閉じて開き直すことでした。
インストーラーが設定ファイルを書き換えていても、いま開いているターミナルには反映されていないためです。

それでもだめなら、シェルの設定ファイルにパスを追記します。

export PATH="$HOME/.local/bin:$PATH"

zshなら ~/.zshrc、bashなら ~/.bashrc に書いて、source で読み直せば通ります。
どこに入ったかわからなくなったときは、which codex で場所を探してしまうのが早いですよ。

【落とし穴2】npmで入れたのに起動できない

npm経由でインストールした場合、Node.jsのバージョンが古いままだと起動時に落ちます。
まずは手元のバージョンを確認しましょう。

node -v

22より小さい数字が出たら、これが原因です。
nvmを使っているなら、切り替えは一瞬で終わりました。

nvm install 22
nvm use 22

そもそもNode.jsを使う予定がないなら、npmを避けて公式インストーラーで入れ直すほうが早いです。
Codex CLI本体はRust製で、Node.jsに依存していません。

【落とし穴3】WindowsでWSL2を使わずに動かそうとする

Windowsで動かない、という相談のかなりの割合がここに集中していました。
公式が案内している動作環境はWindows 11のWSL2経由です。
PowerShell用のインストーラーは用意されていますが、開発作業まで含めて安定させたいならWSL2を入れてしまうほうが確実でしょう。

WSL2の導入は、管理者権限のPowerShellで1行実行するだけです。

wsl --install

作業フォルダの置き場所にも注意してください。
WindowsのCドライブ側ではなく、WSL側のホームディレクトリにプロジェクトを置いたほうが、ファイル操作が体感で数倍速くなりました。

WSL2に慣れていない方でも、必要な操作はフォルダ移動とコマンド実行くらいです。
Ubuntuを1つのアプリだと思って触り始めれば、身構えるほどのことはありません。

【落とし穴4】いきなり大きな指示を投げる

これは技術的なエラーではなく、使い方の問題です。
「このアプリに認証機能を追加して」のような大きすぎる依頼は、初回から投げないほうがいいでしょう。

理由は、途中で意図がずれても気づけないからでした。
10ファイルが同時に書き換わった状態でレビューしようとしても、どこから見ればいいのかわからなくなります。

大きな機能を任せたいなら、設計を相談する、1ファイルだけ作らせる、テストを書かせる、と工程を割ってください。
そのうえで、各工程の終わりにコミットしておく。
この進め方に変えてから、やり直しの回数が目に見えて減りました。

【落とし穴5】利用枠を使い切って作業が止まる

エージェント型のツールは、思っている以上にトークンを消費します。
大きなリポジトリで調査を頼むと、こちらが1行しか書いていなくても、裏では何十ファイルも読み込まれているからです。

枠が切れたときの対処はいくつかあります。

それでも足りなければ、上位プランへの変更を検討する段階でしょう。
ただ、多くの場合は使い方を整えるだけで枠に収まりました。

Codex CLIの使い方に関するよくある質問

Q：Codex CLIは無料で使えますか？

A：ツール自体はオープンソースで無料配布されていますが、動かすにはChatGPTのアカウントが必要です。公式リポジトリではPlus・Pro・Business・Edu・Enterpriseの各プランで利用枠が含まれると案内されています。
個人で始めるなら月20ドルのPlusが入口になります。

Q：プログラミング未経験でもCodex CLIを使えますか？

A：使えますが、ターミナルの基本操作だけは先に慣れておいてください。フォルダの移動とファイル一覧の表示ができれば十分です。コードが読めなくても、説明させながら進められるので、学習の相棒としてはむしろ相性がいいと感じています。

Q：Codex CLIに勝手にファイルを消される心配はありませんか？

A：既定のAutoモードでは、作業フォルダの外に出る操作に確認が入ります。そのうえでGit管理下のフォルダで使えば、消されても git checkout で元に戻せました。作業前にコミットする習慣をつけておけば、実害はほぼ防げます。

Q：Claude Codeとどちらを選べばいいですか？

A：すでに課金しているサービスで決めるのがいちばん無駄がありません。ChatGPTに課金しているならCodex CLI、Claudeに課金しているならClaude Codeです。両方使うと得意分野の違いが見えてきますが、最初は片方に絞ったほうが習得は早く済みます。

まとめ

Codex CLIの使い方は、インストール・サインイン・権限設定の3つで大枠が決まります。
あとは日本語で頼むだけなので、初心者にとっての壁は思ったより低いです。

大事なのは、いきなり作らせないことでした。
読ませて、小さく直させて、差分を見て戻す。
この一周を体験しておくと、任せる範囲を自分で決められるようになります。

使い込むほど効いてくるのがAGENTS.mdです。
同じ説明を繰り返している自分に気づいたら、それはファイルに書き出すサインだと思ってください。

エディタ側のAI活用もあわせて試したい方は、CursorでPythonを学ぶ方法もどうぞ。
いま抱えているプロジェクトで、最初に何を説明させてみたいでしょうか。

独学で進めてみて、教わったほうが早いと感じたときのために、選択肢だけ知っておくと迷いが減ります。AIが学べるプログラミングスクール比較11選｜目的別の選び方を参考にしてみてください。