Codex CLI をインストールして安全な初回実行を行う
Codex CLI のインストール、認証または custom provider の選択、検証、安全な初回タスクをまとめた現行ガイドです。
目次
任意の provider automation には、現在の scripts https://www.bettertoken.ai/install-codex-provider.sh と https://www.bettertoken.ai/install-codex-provider.ps1 を使用します。現在の instructions で必要な場合にだけ一時的な values を TEMP に保持してください。
続行するには、自分の BetterToken アカウントと API Key を使用してください。 BetterTokenアカウントを作成する
Codex CLI は、ターミナルで動く OpenAI のコーディングエージェントです。公式クライアント codex を一度だけインストールし、その後に ChatGPT ログイン、OpenAI API Key、または対応する custom provider のいずれか一つを選びます。provider ごとに別の Codex アプリを入れる必要はありません。
安全な初回実行は、インストール、codex --version の確認、認証または provider 設定を一つ完了、テスト用リポジトリで読み取り専用タスクを実行、という順です。これを終えるまで本番コードは開かないでください。
本ガイドは 2026 年 8 月 21 日時点の OpenAI Codex リポジトリと BetterToken の Codex ドキュメントを基に確認しました。インストールコマンドや設定フィールドは変わり得るため、実際の設定ではリンク先の一次資料を優先してください。
従量課金の custom provider を選ぶ場合は、BetterToken の Codex 設定ガイドを開き、自分の API Key を作成してから、本番リポジトリを開く前に最初のリクエストを検証します。BetterToken は公式 Codex CLI に custom provider を設定する方法を提供しており、別の Codex クライアントや ChatGPT サブスクリプションではありません。
インストール方法を選ぶ
| 方法 | 向いている環境 | 前提条件 |
|---|---|---|
| スタンドアロンインストーラー | macOS、Linux、Windows へ直接導入 | curl または PowerShell。Node.js は不要 |
| Homebrew cask | Homebrew で管理している macOS | Homebrew |
| npm | Node.js を使う環境 | 動作する Node.js と npm |
| GitHub Releases のバイナリ | 手動または管理された導入 | アーカイブと PATH の管理 |
保守されている Codex CLI は Rust で実装されています。Node.js が必要なのは npm による導入、または Node.js を明示的に必要とする別の provider 設定スクリプトだけです。
前提条件を確認する
OpenAI の導入ドキュメントでは、macOS 12 以降、Ubuntu 20.04+/Debian 10+、または WSL2 経由の Windows 11 が対応基準です。リポジトリ作業には Git が推奨されます。ネイティブ Windows の対応範囲と sandbox の詳細は別途ドキュメント化され、変更されることがあります。
導入前に次を確認します。
- OpenAI の公式認証か custom provider かを決める。
- 対象のターミナルが
PATHを更新できることを確認する。 - 本番の working tree ではなくテスト用リポジトリから始める。
- API Key をコマンド引数、ソース、スクリーンショット、シェル履歴に入れない。
Codex CLI をインストールする
macOS / Linux：スタンドアロンインストーラー
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --versionインストーラーが PATH を変更した場合は、新しいターミナルを開きます。
macOS：Homebrew
brew install --cask codex
codex --versionnpm：macOS / Linux / Windows
npm install -g @openai/codex
codex --versioncodex が見つからないときは、実際の npm グローバルプレフィックスを確認します。
npm config get prefixその場所と PATH を比較し、通常の Node.js またはシェル設定を修正して新しいターミナルを開いてください。実際の配置を確認せず、推測で /bin を追加しないでください。
Windows と GitHub Releases
公式の PowerShell インストーラーです。
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex --versionWindows で Linux 向けに開発する場合は WSL2 内に Linux CLI を導入し、可能ならプロジェクトを /mnt/ ではなく WSL のファイルシステムに置きます。Codex Releases には OS と CPU アーキテクチャ別のアーカイブもあります。対応するバイナリを PATH で管理済みのディレクトリに展開し、バージョンを確認します。
アクセス方法は一つだけ選ぶ
原因を切り分けている間、OpenAI の公式ログイン状態と custom provider 設定を混ぜないでください。まず一つの経路を確認します。
ChatGPT でログインする
codex login
codex login statusブラウザでフローを完了します。GUI のないマシンでは、ブラウザトークンを他のマシンからコピーせず、OpenAI が現在案内している device code または API Key の方法を使ってください。
OpenAI API Key を使う
Key は secret manager または環境変数に保存し、見えるコマンド引数には渡しません。対応するログイン方法と credential storage は、現行のOpenAI 認証ガイドに従ってください。保存済みの公式認証情報は codex logout で削除します。
custom provider を設定する
custom provider でも同じ公式 CLI を使います。設定では Base URL、API プロトコル、モデル、Key を渡す環境変数を選択します。BetterToken は OpenAI Responses API による Codex 向けの手順を公開しています。現在の Base URL は https://www.bettertoken.ai/v1 です。Model ID と Key group は動的なため、現在の画面またはドキュメントからコピーしてください。
テスト前に、想定した provider 設定を上書きしうる古い OpenAI 環境変数を消します。
unset OPENAI_API_KEY
unset OPENAI_BASE_URL続けて現在の BetterToken Codex ガイドに従います。そこに最新の config.toml フィールド、wire_api = "responses"、Key 変数、モデル選択、起動コマンドがあります。変更後は Codex を完全に再起動します。
安全な初回実行を行う
重要でないリポジトリで始めます。
git clone https://github.com/openai/codex codex-test
cd codex-test
codex --sandbox read-only "Explain the entry point of this project"意図したアクセス経路で Codex が起動し、関連ファイルを適切に特定し、ファイルを変更せず、予期しない書き込み・実行権限を要求しなければ初回実行は成功です。BetterToken を使う場合は、正常なモデル応答と、Dashboard に表示される対応リクエストのモデル、ステータス、token usage も API 経路の確認になります。
層ごとにトラブルシュートする
codex: command not found
新しいターミナルを開き、導入が完了したかと実際のインストール場所を確認します。npm なら npm config get prefix、Release バイナリならそのディレクトリが PATH に含まれるかを確認します。
ブラウザが開かない
使用可能なブラウザと callback 通信を確認します。headless 環境では、文書化された device code または API Key の経路を使います。他のマシンから認証ファイルをコピーしないでください。
custom provider が 401、403、404、HTML を返す
Key 変数、アカウント、provider、Base URL、古い環境変数による上書きを確認し、Key は出力しません。404 や HTML なら現在の Codex Docs と Base URL を比較し、Claude Code 用の Base URL を流用していないか確認します。
model not found、または設定が反映されない
古い記事やスクリーンショットではなく、provider の現在のモデル一覧から Model ID をコピーします。Codex プロセスをすべて停止して新しいターミナルを開き、アクティブな profile または設定ファイルを確認して、小さな読み取り専用リクエスト一つで再テストします。認証、モデル、Base URL、sandbox を同時に変更しないでください。
最終チェックリスト
codex --versionがバージョンを返す。- テストでは認証または provider の経路が一つだけ有効になっている。
- secret がソースとシェル履歴の外にある。
- Base URL、プロトコル、モデル、Key 変数が現行の provider ドキュメントと一致する。
- テスト用リポジトリで読み取り専用タスクがファイル変更なしに成功する。
- 利用状況が想定した provider の Dashboard またはアカウント履歴に表示される。
この確認後、必要最小限の権限で実際のリポジトリを開けます。自律性を上げる前に、提案されたコマンドと diff を確認してください。
