楽天セール開催中!ポイント最大11倍!セール会場へ

Codex CLIのインストールと初期設定|Windows・Mac・Linuxの入れ方4通り

OpenAIのCodex CLIは、ターミナルからコードの確認や編集を指示できるツールです。

インストール方法は4通りあり、どれを選ぶべきか迷いやすい点があります。

結論として、公式インストーラを使う方法が最も手順が少なく、更新も同じコマンドで実行できます。

この記事では、OS別のインストール手順、初回ログイン、設定ファイルの配置場所を解説します。

目次

4つの入れ方と選び方

方法対象向いている人
公式インストーラmacOS / Linux / Windows迷ったらこれ
npmNode.js がある環境すでにnpmで道具を管理している人
HomebrewmacOSbrewでまとめたい人
ソースからビルド開発者向け中身を触りたい人

ソースコードからのビルドにはRustの環境が必要です。

通常の利用であれば選ぶ必要はありません。

macOS・Linux に入れる

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

更新も同じコマンドです。

専用の更新コマンドを覚える必要がなく、管理の手間を省けます。

Homebrew を使う場合

brew install --cask codex

更新は brew upgrade --cask codex です。

--cask を付け忘れると別のパッケージを探してしまうため注意してください。

Windows に入れる

PowerShellを開き、次のコマンドを実行します。

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

こちらも更新は同じコマンドです。

ExecutionPolicy が入っている理由

Windowsは既定の設定で、インターネットなどから取得したスクリプトの実行を制限します。

コマンドの先頭にある -ExecutionPolicy ByPass は、この1回の実行だけその制限を解除する指定です。

システム全体の設定を変更するわけではないため、事後の設定戻しは不要です。

このオプションを省略すると、環境によってはスクリプトの実行がブロックされます。

npm で入れる

npm install -g @openai/codex

更新時も同じコマンドで最新版に上書きされます。

すでにNode.jsを導入している環境であれば、最も手軽に導入できます。

ログインして最初のタスクを投げる

作業対象のディレクトリに移動し、codex と入力します。

cd path/to/project
codex

初回起動時に認証方法を選択するプロンプトが表示されるため、ChatGPTアカウントでのサインインを選択するのが確実です。

APIキーによる認証も可能ですが、一部利用できない機能があります。

対話モードに入ったら、実行したい指示を直接入力します。

このプロジェクトについて教えて

日本語のプロンプトをそのまま送信して問題ありません。

作業の前後でGitのコミットを作っておくと、いつでも戻せます。

安全に作業を進めるための推奨手順です。

設定ファイルの場所

設定は TOML 形式のファイルに記述します。

場所効く範囲
~/.codex/config.toml自分の既定値
.codex/config.tomlそのプロジェクトだけ
~/.codex/名前.config.tomlプロファイル。--profile 名前 で選ぶ
/etc/codex/config.tomlシステム全体(Unix系)

プロジェクト直下に配置した設定ファイルは、ユーザー既定の設定より優先して適用されます。

ただしプロジェクトの設定は、そのプロジェクトを信頼するまで読み込まれません。

新規に取得したリポジトリで設定が反映されない場合は、まず信頼設定の状態を確認してください。

最初に書いておくとよい設定

# ~/.codex/config.toml
approval_policy = "on-request"
sandbox_mode    = "workspace-write"

作業ディレクトリ内の変更は許可し、ディレクトリ外へのアクセス時のみ確認を求める設定例です。

この2つの設定項目の詳細はCodexのサンドボックスと承認設定で詳しく解説しています。

覚えておくと早いコマンド

コマンドできること
codex resume前回の続きから再開する
codex exec対話せずに1回だけ動かす。スクリプトやCI向け
codex --searchその回だけWeb検索を許す
codex --imageエラー画面などの画像を渡す
codex mcp外部ツールの接続(MCP)を足す
/statusいまの作業対象フォルダを確認する
/permissions編集・実行をどこまで任せるかを変える

デスクトップアプリのインストール手順は、以下の記事で解説しています。

環境構築や設定に関する関連記事もあわせてご参照ください。

まとめ

  • 迷ったら公式インストーラ。macOS・Linuxは curl、Windowsは PowerShell
  • 更新はインストールと同じコマンド(Homebrewだけ upgrade)
  • Windowsの -ExecutionPolicy ByPass はその1回だけの指定。消さない
  • 設定は ~/.codex/config.toml。プロジェクト側は信頼するまで読まれない
  • 作業の前後でコミットを作っておくと戻せる

この記事は2026年9月9日時点の公式ドキュメントにもとづいています。

コマンド仕様や設定項目の最新情報は、公式ドキュメントもあわせてご確認ください。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

次に学ぶ・作業環境を選ぶ

学習を続けたい方や、作業環境を整えたい方は、目的に合うガイドをご覧ください。

生成AIのおすすめ書籍

周辺機器の優先度

目次