Codex CLI 入門ガイド：インストールから最初のAIコーディングタスクまで
初心者15 分で読める

Codex CLI 入門ガイド：インストールから最初のAIコーディングタスクまで

CATAITO Team2026-08-06
お使いのOS:

このチュートリアルで学べること

Codex CLI は、OpenAI が提供するターミナル上で動作するコーディングエージェントです。プロジェクトの確認、ファイルの編集、コマンドの実行、反復作業の自動化を、すべてコマンドライン上で行えます。このチュートリアルを終えると、Windows・macOS・Linux に Codex CLI をインストールし、ログインし、最初の AI 支援コーディングタスクを実行できるようになります。

所要時間： 15〜20分

難易度： 初心者向け

始める前に必要なもの

項目要件
OSWindows 10 以降、macOS、または Linux
アカウントChatGPT アカウント（サブスクリプション）または OpenAI API キー（従量課金）
Node.jsnpm インストール方式でのみ必要（バージョン18以上）
ターミナルPowerShell（Windows）、ターミナル（macOS）、または Linux ターミナル
費用ChatGPT サブスクリプション、または API 利用量に応じた課金

ターミナルとは？ ターミナル（コマンドラインとも呼びます）は、ボタンをクリックする代わりにコマンドを入力するウィンドウです。Windows では PowerShell、macOS では ターミナル と呼ばれます。このチュートリアルの codex コマンドは、このウィンドウに入力して Enter を押して実行します。

Node.js とは？ Node.js は、npm コマンドでツールをインストールできるようにする無料プログラムです。下の npm インストール方式を選ぶ場合にのみ必要です。まだない場合は nodejs.org からインストールしてください（LTS版を選択）。

API キーとは？ API キーは、従量課金時にアカウントを識別するための秘密のコードです。platform.openai.com の API keys ページで一度だけ生成します。パスワードと同じように扱い、他人に共有しないでください。

ターミナルの開き方（ステップバイステップ）

ターミナルの開き方がわからない場合は、以下から自分のOSの手順に従ってください。このチュートリアルのすべてのコマンドはこのウィンドウで実行します。

Windows — PowerShell を開く

  1. 1画面左下のスタートボタン（Windows ロゴ）をクリックします。
  2. 2PowerShell と入力します——何もクリックする必要はなく、そのまま入力するだけです。
  3. 3一覧に表示されたら、Windows PowerShell または ターミナル をクリックします。
  • Windows 11 ではターミナル、Windows 10 では Windows PowerShell と表示されます。どちらでも動作します。
  1. 1青いユーザーアカウント制御のウィンドウが表示されたら、はいをクリックします。

コマンドの貼り付け方： PowerShell ウィンドウ内の任意の場所を右クリックで貼り付け（または Ctrl + V）。

ダウンロードとインストール

バージョンの選択

バージョン対象説明
安定版（公式インストーラー）ほとんどのユーザー完全にテスト済み、推奨
npm パッケージNode.js を導入済みのユーザー更新が簡単
Homebrew（macOS）Homebrew を使う macOS ユーザー他のアプリと一元管理

Homebrew とは？ Homebrew は macOS の無料パッケージマネージャーです。brew install と入力してアプリをインストールします。コマンドライン版のアプリストアのようなものです。すでに Homebrew を使っている場合のみ選んでください。

OS別のインストール

下のパネルでOSを選択してください。各タブにそのOSの完全な手順が含まれています。

Windows のインストール

  1. 1PowerShell を開きます：スタートボタン（Windows ロゴ）をクリックし、PowerShell と入力して、Windows PowerShell または ターミナル をクリックします。
  2. 2下のコマンドをコピーし、PowerShell ウィンドウに貼り付けて Enter を押します：
powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
  1. 1インストールが終わるまで待ちます。再度入力できるようになったら、下のコマンドをコピーして実行し、インストールを確認します：
powershell
codex --version

バージョン番号（例：v1.x.x）が表示されれば成功です。

Codex のアップデート（最新版にしたいときに、このコマンドをコピーして実行）：

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

初回ログイン

  1. 1ターミナルを開き、プロジェクトフォルダに移動します（path/to/your/project を自分のパスに置き換え）：
bash
cd path/to/your/project
  1. 1Codex を起動します：
bash
codex
  1. 1初回はログイン方法を選択します：
  • ChatGPT でログイン — ChatGPT アカウント（サブスクリプション）を使用。ブラウザで認証画面が開き、ログイン後、認証情報が自動的に Codex に渡されます。
  • API キーを使用 — プロンプトに従って platform.openai.com で生成したキーを貼り付けます。
  1. 1ログインが完了すると、Codex の入力プロンプトが表示され、最初のタスクの準備ができています。

インストール時のトラブルシューティング

エラー原因解決策
codex: command not foundインストール先が PATH に含まれていない下のOS別の詳細な修正手順を参照
npm: command not foundNode.js がインストールされていないnodejs.org からインストール（LTS版）、ターミナルを閉じて開き直し、npm インストールを再試行
ログインページが開かないネットワーク制限またはプロキシネットワークを確認し、chatgpt.com にアクセスできるようにして再試行。VPN やプロキシを使っている場合はオフにするかサーバーを変更
codex: Permission denied（macOS/Linux）スクリプトがインストール先に書き込めないターミナルで一度 chmod +x ~/.local/bin/codex を実行してから、インストールコマンドを再実行

"codex: command not found" の修正 — Windows：

  1. 1Windows キーを押し、環境変数 と入力してシステム環境変数の編集をクリック。
  2. 2環境変数(N)... ボタンをクリック。
  3. 3下のリスト（システム変数）で Path を選択し、編集(I)... をクリック。
  4. 4新規をクリックし、Codex のインストール先（既定：C:\Users\<ユーザー名>\.local\bin）を追加し、すべてのウィンドウで OK をクリック。
  5. 5PowerShell を完全に閉じて開き直し、codex --version を実行。

"codex: command not found" の修正 — macOS/Linux：

  1. 1ターミナルを開き、このコマンドをコピーして実行：
bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
  1. 1設定を再読み込み：
bash
source ~/.zshrc
  1. 1Zsh ではなく Bash を使っている場合は、上の2つのコマンドの ~/.zshrc を ~/.bashrc に置き換えます。
  2. 2codex --version で確認。

最初のタスク

ステップ1：プロジェクトを開く

Codex に作業させるプロジェクトフォルダに移動します（パスを自分のものに置き換え）：

bash
cd path/to/your/project

ステップ2：Codex を起動

bash
codex

ステップ3：最初の質問をする

下のリクエストを入力して Enter を押します：

text
Tell me about this project

Codex がプロジェクトのファイルを読み、内容を説明します。次のようなタスクも試してください：

  • Explain the main function in this file — このファイルのメイン関数を説明
  • Find the bug in this code — このコードのバグを探す
  • Add a comment header to every file — 全ファイルにコメントヘッダーを追加

ステップ4：Codex の操作を承認する

Codex がファイルを編集したりコマンドを実行したりするときは、まず許可を求めます。これは正常です。y を入力して Enter で承認、n で拒否します。変更を一つずつ確認し、自分のマシンで起こることを常に把握してください。

ステップ5：Codex を終了

終了したら /exit を入力して Enter、または Ctrl + C を2回押します。

便利なコマンド

コマンド機能
codex対話型セッションを開始
codex exec "タスクの説明"非対話モードでタスクを実行（スクリプトやCI向け）
codex resume最近のセッションを再開
codex --image <ファイル>プロンプトにスクリーンショットや図を添付
codex --search現在のタスクでウェブ検索を有効化
codex mcpMCP サーバー経由で外部ツールに接続
codex completionターミナルのコマンド補完を生成
/permissionsセッション内で Codex の自動実行範囲を変更
/exitCodex を終了

よくある質問

有料プランは必要ですか？

ChatGPT サブスクリプションまたは OpenAI API キーのいずれかが必要です。無料プランの ChatGPT には Codex CLI のアクセスが含まれません。現在のオプションは公式価格ページで確認してください。

git リポジトリの外でも動作しますか？

Codex は git プロジェクト内で最も効果的に動作します。ゼロから始める場合は、先にリポジトリを作成します：

bash
git init

Codex は私のコードを実行できますか？

できますが、あなたの許可が必要です。Codex はマシン上でコマンドやテストを実行でき、実行前に必ず内容を表示します。権限設定で、確認なしに実行できる範囲を制御できます。

私のコードは OpenAI に送信されますか？

OpenAI モデルを使用する場合、プロンプトとファイルの内容は、アカウントの種類（サブスクリプションまたは API 組織の設定）のデータコントロールに従って OpenAI によって処理されます。詳細は公式のデータコントロールドキュメントを確認してください。

次のステップ

  • プロジェクトガイダンスの追加： リポジトリに AGENTS.md ファイルを作成し、Codex にプロジェクトの永続的な指示を与えます。
  • スクリプトでの自動化： CI パイプラインや反復ワークフローで codex exec を使用します。
  • MCP でのツール接続： codex mcp を使用して、外部データやサービスにアクセスさせます。
  • Codex cloud を試す： 長時間のタスクをクラウドに任せ、後でターミナルに戻って結果を取得します。
#Codex#AI Coding#Terminal#OpenAI
チュートリアル一覧に戻る