Codex CLI 完全ガイド｜ターミナルでAIコーディング開始【5ステップ】

Codex CLIで何ができるか・何が変わるか

Codex CLIはOpenAIが提供するコマンドラインツールです。ターミナルから直接、自然言語で指示を出すだけで、AIがコードを生成してくれます。ChatGPTと異なり、ブラウザを開かずにターミナル内で完結するため、開発フローが断然速くなります。

Codex CLIを使うことで以下が実現します：

• 関数やスクリプトの自動生成：「Pythonで配列をソートするコード」と書くだけで実装が候補として出る
• デバッグの自動提案：エラーメッセージをAIに投げて原因と対処法をその場で確認
• ドキュメント・コメントの自動作成：複雑な関数の説明をAIに書かせて時間短縮
• 定型コードの自動補完：ボイラープレートコード（初期設定等）を自動生成

従来はGitHub CopilotやClaude Codeのようなエディタ拡張を使う方法が中心でしたが、Codex CLIはターミナル環境に特化しているため、SSHリモート開発やDocker環境での作業との相性が良いです。

前提環境・必要なもの

Codex CLIを導入する前に、以下を確認してください：

動作環境（確認済みバージョン）

• Python 3.7 以上がインストール済み
• ターミナル（MacはTerminal、WindowsはPowerShellまたはWSL2推奨）
• インターネット接続

アカウント・認証

• OpenAIアカウント（無料プランで開始可能）
• OpenAI APIキー（有料プランへのアップグレード後に利用可能）

Codex CLIを使用するには、OpenAIの有料API利用プランへの登録が必須です。無料のChatGPT利用者のみだと利用できません。

ステップ1：OpenAIアカウントを作成・APIキーを取得する

1-1. OpenAIアカウントの作成

ブラウザで以下にアクセスします：

https://platform.openai.com/account/signup

メールアドレスまたはGoogleアカウント、Microsoftアカウントでサインアップします。初回はメール確認が入るため、メールボックスを確認してください。

1-2. 支払情報の登録

OpenAI APIを使用するには課金が必須です。サインアップ後、ダッシュボードにログインして「Billing」セクションから支払情報を登録します：

1. https://platform.openai.com/account/billing/overview にアクセス
2. 「Set up paid account」または「Billing」をクリック
3. クレジットカード情報を入力（Visaなど主要カードに対応）

OpenAIは使用量に応じた従量課金制です。最初は月額数千円程度の予算でテストを始め、実際の利用量に応じて増減させることが多いです。

1-3. APIキーの生成

支払情報登録後、APIキーを生成します：

1. https://platform.openai.com/account/api-keys にアクセス
2. 「Create new secret key」をクリック
3. キー名を入力（例：「Codex CLI Dev」）
4. 生成されたキーをコピーします

**重要：このキーを絶対に他人と共有したり、GitHubなどの公開リポジトリにコミットしないでください。**APIキーが漏洩すると、不正使用で高額請求される危険があります。

ステップ2：Codex CLIをターミナルにインストールする

2-1. パッケージマネージャーでインストール

最も簡単な方法はpip（Pythonのパッケージマネージャー）を使うことです。ターミナルを開いて、以下を実行します：

pip install openai-codex-cli

すでにpipがインストール済みか確認するには：

pip --version

バージョン情報が表示されればOKです。

2-2. インストール確認

インストール完了後、以下を実行してCodex CLIが認識されたか確認します：

codex --version

バージョン番号が表示されれば、インストール成功です。

もし「command not found」エラーが出た場合は、Python環境の設定に問題がある可能性があります。以下を試してください：

python3 -m pip install openai-codex-cli
python3 -m codex --version

ステップ3：APIキーを環境変数に設定する

ターミナルで毎回APIキーを手入力するのは不便で、セキュリティ的にも危険です。環境変数として設定することで、Codex CLIが自動的にキーを読み込みます。

3-1. Macの場合

ターミナルで以下を実行します（キーは実際のAPIキーに置き換え）：

echo 'export OPENAI_API_KEY="sk-xxxxxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

~/.zshrc ではなく ~/.bash_profile を使っている場合は、上記の zshrc を bash_profile に置き換えてください。確認するには：

echo $OPENAI_API_KEY

APIキーが表示されればセット完了です。

3-2. Windowsの場合（PowerShell）

PowerShellを管理者として実行して、以下を実行します：

[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-xxxxxxxxxxxxx", "User")

設定後、PowerShellを再起動して確認します：

echo $env:OPENAI_API_KEY

3-3. WSL2/Linux の場合

echo 'export OPENAI_API_KEY="sk-xxxxxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

ステップ4：Codex CLIの基本コマンドを実行する

環境設定が完了したら、実際にCodex CLIを使ってみましょう。

4-1. 最初の実行例

簡単なPythonコード生成を試します。ターミナルで：

codex "Pythonで1から100までの合計を計算する関数を書いてください"

AIが複数の候補コードを提示します。以下のようなイメージです：

Option 1:
def sum_range():
    return sum(range(1, 101))

Option 2:
def calculate_sum():
    total = 0
    for i in range(1, 101):
        total += i
    return total

どの候補を使うか選択すると、そのコードがクリップボードにコピーされるか、ファイルに保存されます。

4-2. 言語を指定する場合

JavaScriptで書きたい場合は、プロンプトに言語を明記します：

codex "JavaScriptで配列の重複を削除する関数"

4-3. ファイルを直接編集する場合

既存のPythonファイル（script.py）を開いて、Codex CLIが補完候補を出す方法：

codex --file script.py "この関数にドキュメンテーション文字列を追加してください"

ステップ5：よくあるユースケースと応用例

ケース1：デバッグ時のエラー解析

エラーメッセージが出たときは、メッセージをそのままCodex CLIに投げます：

codex "このエラー『TypeError: 'NoneType' object is not subscriptable』の原因と対処法を教えてください"

即座に考えられる原因（変数がNoneで初期化されている、など）と対処方法が提示されます。

ケース2：SQLクエリの自動生成

複雑なSQLを手で書くのは時間がかかります。AIに指示を出しましょう：

codex "SQLで、ユーザーテーブルから2025年以降に登録したユーザーの平均年齢を計算するクエリ"

ケース3：正規表現の作成

正規表現は覚えづらいため、AIに作成させるのが効率的です：

codex "メールアドレスのフォーマットをチェックする正規表現（JavaScript）"

ケース4：テストコードの自動生成

既存の関数があれば、Codex CLIにテストコードを書かせます：

codex "以下のPython関数のユニットテストを書いてください: def factorial(n): return 1 if n <= 1 else n * factorial(n-1)"

つまずきやすいポイントと解決策

問題1：「403 Unauthorized」エラーが出る

原因：APIキーが正しく設定されていない、または無効なキー。

解決方法：

1. 環境変数の設定を確認：echo $OPENAI_API_KEY
2. APIキーが正しくコピーできているか、OpenAIダッシュボードで確認
3. キーの先頭が sk- で始まっているか確認
4. スペースが混在していないか確認

問題2：「You exceeded your current quota」エラー

原因：APIの利用限度額に達した（無料トライアルの場合）。

解決方法：

1. OpenAI ダッシュボード（https://platform.openai.com/account/billing/overview）でクレジット残高を確認
2. 必要に応じて支払方法をアップデートするか、新しい支払情報を追加
3. APIの使用制限（Rate Limit）を確認し、リクエスト頻度を調整

問題3：コードの品質がいまひとつ

原因：プロンプト（指示文）が曖昧、または条件不足。

解決方法：

• プロンプトに背景情報を含める：「Python 3.9環境で、ファイル入出力なしで〜」
• 期待する出力形式を明確に：「返り値はDict型で」
• 言語やフレームワークを指定：「FastAPI を使った」「React Hooks で」

問題4：ターミナルで日本語が文字化けする

原因：ターミナルの文字エンコーディング設定がUTF-8になっていない。

解決方法（Mac）：

export LANG=ja_JP.UTF-8

ターミナルの設定（環境設定 > プロファイル > 詳細）で文字セットを UTF-8 に変更することも有効です。

料金・コスト管理

Codex CLIの使用料金はOpenAI APIの従量課金制です。

料金体系（2026年6月時点の目安）：

• GPT-3.5 Turbo：1000トークン（単語数）あたり約0.15円
• GPT-4：1000トークン入力あたり約0.3円、出力あたり約0.6円

1回のコード生成リクエストは平均100～500トークン消費するため、100回実行で50～250円程度です。

コスト管理のコツ：

• OpenAIダッシュボードで「Usage」を定期チェック
• 月額の使用制限（Hard limit）を設定して、予期しない高額請求を防ぐ
• 開発初期段階では安価なGPT-3.5 Turboを使い、精度が必要な場面でGPT-4に切り替える

Claude Code・GitHub Copilotとの違い

Codex CLI：ターミナル環境に特化。エディタ拡張不要で、SSHやDocker環境での使用が容易。

Claude Code：Anthropic製で、エディタ統合（VS Codeなど）をサポート。UI内での会話型フロー。

GitHub Copilot：GitHubアカウントと連携し、VS Code等で自動補完。無料プランあり。

開発環境と好みに応じて使い分けるのが最適です。

次のステップ

Codex CLIに慣れたら、以下にチャレンジしてみてください：

• 高度なプロンプト設計：複数行の指示、コンテキスト情報を含めた指示方法
• スクリプト化：Codex CLIを他のツールと組み合わせたシェルスクリプト作成
• カスタム設定：設定ファイルでデフォルト動作を変更
• チーム運用：APIキー管理の仕組みを整備して、チーム内での利用を体系化

あわせて読みたい

• Claude Code初心者向けセットアップ【macOS/Windows手順】
• 【2026年版】Claude Codeの始め方｜5ステップで実装できる入門ガイド
• Claude Codeの使い方｜5つの実践テクニック＆よくあるエラー対処法