Codex: Codex インストールとセットアップ

Q: Codex のバージョンを確認するにはどうすればよいですか？

codex --version を実行して現在のバージョンを確認できます。

最終更新：2026-08-31

Codex は複数のインストール方法を提供しています。オペレーティングシステムとワークフローに最適なものを選んでください。

📋 前提条件: 基本的なコマンドラインの知識、Node.js がインストール済み（CLI 方式の場合に必要）

1. インストール方法一覧

方法	ユースケース	おすすめ度
Codex App	デスクトップユーザー、フル機能体験	⭐⭐⭐⭐
Codex CLI	開発者の日常使用、ターミナルワークフロー	⭐⭐⭐⭐⭐
Homebrew	Mac ユーザー	⭐⭐⭐⭐
バイナリパッケージ	Node.js 環境がない場合	⭐⭐⭐
IDE プラグイン	VS Code / Cursor ユーザー	⭐⭐⭐⭐

2. Codex App（デスクトップアプリケーション）

最もシンプルな方法 — デスクトップクライアントを直接ダウンロードします。

https://chatgpt.com/codex にアクセスし、お使いのプラットフォーム用のアプリをダウンロードしてください。

(1) インストール手順

TEXT 📖 参照専用

1. chatgpt.com/codex にアクセス
2. "Download for macOS/Windows" をクリック
3. アプリケーションをインストール
4. ChatGPT アカウントでログイン
5. 使用開始

(2) 初回起動

ログイン後、3ペインのインターフェースが表示されます：左にタスクリスト、中央に会話ウィンドウ、右にマルチ機能エリア。

Codex App はクラシックな3ペインレイアウトを使用しています：タスクリスト + 会話ウィンドウ + マルチ機能エリア。

3. Codex CLI（コマンドライン）

開発者の間で最も人気のある方法です。CLI はローカルで実行され、コードはクラウドにアップロードされません。

(1) インストール

BASH

# npm 経由でインストール
sudo npm install -g @openai/codex

# ミラー加速（中国）
sudo npm install -g @openai/codex --registry=https://registry.npmmirror.com

(2) ログイン

初回起動には認証が必要です。3つのオプションがあります：

オプション1：ChatGPT ログイン（推奨）

BASH

codex
# "Sign in with ChatGPT" を選択
# ブラウザが自動的にログインページを開きます

オプション2：API Key ログイン

BASH

# macOS/Linux 一時的
export OPENAI_API_KEY="sk-your-api-key"

# 永続的（シェル設定に追加）
echo 'export OPENAI_API_KEY="sk-your-api-key"' >> ~/.zshrc
source ~/.zshrc

# Windows PowerShell
$env:OPENAI_API_KEY="sk-your-api-key"

# 特定のモデルで起動
codex --model gpt-5-codex

オプション3：auth.json ファイル

BASH

mkdir -p ~/.codex
cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "sk-your-api-key"
}
EOF

(3) 初回起動

BASH

cd my-project
codex
# 入力：Analyze the current project structure

▶ 例1：Alice の初回体験

BASH

# Alice はテストプロジェクトを作成
mkdir codex-test && cd codex-test

# シンプルなファイルを作成
echo 'print("Hello World")' > test.py

# Codex を起動
codex

# Alice が入力：
# "Add command-line argument support to test.py, support --name parameter"

4. 3つの実行モード

Codex CLI は3つのセキュリティモードを提供しています：

モード	機能	セキュリティレベル
Suggest	変更を提案のみ、手動確認が必要	高（デフォルト）
Auto Edit	ファイルを自動変更、コマンドは確認が必要	中
Full Auto	すべての操作を自動実行	低（注意して使用）

BASH

# デフォルトモード
codex

# Auto Edit モード
codex --auto-edit

# Full Auto モード
codex --full-auto

▶ 例2：モードの選択

PYTHON

def choose_mode(task_risk, task_complexity):
    if task_risk == "high":
        return "Suggest - confirm each action for safety"
    elif task_complexity == "low":
        return "Full Auto - simple tasks done quickly"
    else:
        return "Auto Edit - files auto-edited, commands human-reviewed"

5. Homebrew インストール（Mac 推奨）

BASH

# インストール
brew install --cask codex

# 実行
codex

Node.js をインストールしたくない Mac 開発者に最適です。

6. バイナリパッケージインストール

GitHub Release から直接ダウンロード：

BASH

# ダウンロード URL: https://github.com/openai/codex/releases

# Mac Apple Silicon
tar -xzf codex-aarch64-apple-darwin.tar.gz

# Linux
tar -xzf codex-x86_64-unknown-linux-musl.tar.gz

# PATH に追加
sudo mv codex /usr/local/bin

# 実行
codex

7. IDE プラグインインストール

VS Code、Cursor、Windsurf などの IDE をサポートしています。

(1) インストール手順

TEXT 📖 参照専用

1. IDE の拡張機能マーケットプレイスを開く
2. "Codex" を検索
3. プラグインをインストール
4. ChatGPT アカウントでログイン

(2) IDE 機能

コードの自動修正
関数の自動生成
コードの自動リファクタリング
選択したコードを右クリックで Codex に送信

8. アップデートとアンインストール

BASH

# CLI アップデート
npm update -g @openai/codex

# 最新版を強制再インストール
npm install -g @openai/codex@latest

# アンインストール
npm uninstall -g @openai/codex

# Homebrew アンインストール
brew uninstall --cask codex

9. システムサポート

システム	サポート状況
macOS	完全サポート
Linux	完全サポート
Windows	実験的（WSL 推奨）

10. ネットワークの問題

中国のユーザーは Codex にアクセスする際にネットワークの壁に遭遇する場合があります。以下を検討してください：

ネットワークプロキシの使用
Alibaba Qoder Quest や ByteDance Trae Solo などの類似製品の試用

❓ よくある質問

Q CLI をインストールする前に何が必要ですか？

A Node.js（v18+）が必要です。npm は Node.js に含まれています。Mac ユーザーは Homebrew から Codex をインストールすれば Node.js をスキップできます。

Q Windows で Codex CLI を使用できますか？

A 実験的サポート — WSL（Windows Subsystem for Linux）経由での使用を推奨し、より安定した体験が得られます。

Q API Key と ChatGPT ログインはどちらが良いですか？

A ChatGPT ログインはシンプルでほとんどのユーザーに適しています。API Key はモデルとコストを正確に制御したい開発者に向いています。

Q Full Auto モードは安全ですか？

A リスクがあります。Codex はシェルコマンドを含むすべての操作を自動実行します。信頼できるプロジェクトのみで使用するか、サンドボックスモードを有効にすることをお勧めします。

Q Codex のバージョンを確認するにはどうすればよいですか？

A codex --version を実行して現在のバージョンを確認できます。

📖 まとめ

5つのインストール方法：App / CLI / Homebrew / バイナリ / IDE プラグイン
CLI は開発者の第一選択 — npm install -g @openai/codex で1行で完了
3つのセキュリティモード：Suggest / Auto Edit / Full Auto
初回起動にはログインが必要：ChatGPT ログイン（推奨）/ API Key / auth.json
Windows ユーザーは WSL を使用すべき

📝 練習問題

基本 (⭐)：Codex CLI をインストールし、正常にログインする。初回起動インターフェースのスクリーンショットを撮る。
中級 (⭐⭐)：Suggest と Auto Edit モードで同じタスクを完了し、体験を比較する。
上級 (⭐⭐⭐)：WSL 環境に Codex CLI をインストールし、インストールトラブルシューティングガイドを作成する。

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

私たちについて