魔法なしで Codex CLI を使う方法

Codex CLI をオフラインで導入し、プラットフォーム選択から設定、安定した API key の接続まで進めるための初心者向けガイドです。

魔法なしで Codex CLI を快適に使う方法

これは初心者向けの Codex CLI オフライン導入ガイドです。主に次の 3 つを解決します。魔法なしでどう入れるか、どのプラットフォームを選ぶべきか、設定後にどうすぐ使い始めるかです。

このガイドが向いている人

Vibe Coding を試したいが、安定したネットワーク環境がまだない人

Codex CLI を初めて触り、インストールでつまずきたくない人

同僚や友人にオフラインで使えるインストール一式を配りたい人

始める前の準備

対象の PC にはあらかじめ次のものが必要です。

Node.js

npm

ターミナルで次のコマンドを実行して確認できます。

node -v
npm -v

正常にバージョンが表示されれば、前提環境は整っています。

ディレクトリ構成

ルート配下には次の 3 つのプラットフォーム別ディレクトリがあります。

windows-x64/npm-offline

macos-arm64/npm-offline

macos-x64/npm-offline

ダウンロード先: https://pan.quark.cn/s/ba9ebd0bb18f

各ディレクトリには通常、次のものがまとめられています。

共通メインパッケージ codex-npm-0.121.0-alpha.6.tgz

対応プラットフォーム用のオフラインパッケージ

インストールスクリプト

設定スクリプト

簡単なプラットフォーム説明

まず自分のプラットフォームを確認する

Windows

通常の Windows PC なら基本的に windows-x64/npm-offline を使えば大丈夫です。

macOS

Mac は 2 種類に分かれます。

Apple Silicon: M1 / M2 / M3 / M4 は macos-arm64

Intel Mac: 旧型 Intel Mac は macos-x64

分からない場合は Mac のターミナルで次を実行します。

uname -m

結果の見方は次のとおりです。

arm64 なら macos-arm64

x86_64 なら macos-x64

Windows x64 のインストール手順

Windows では、まずスクリプトでのインストールをおすすめします。手動で進めたい場合は手動コマンドでも構いません。

ステップ 1: オフラインインストールディレクトリへ移動する

cd "あなたのパス\codex-npm-offline\windows-x64\npm-offline"

ステップ 2: インストールスクリプトを実行する

.\install-codex-windows-x64.cmd

ステップ 3: 必要なら手動インストールする

npm install -g .\codex-npm-0.121.0-alpha.6.tgz @openai/codex-win32-x64@file:.\codex-npm-win32-x64-0.121.0-alpha.6.tgz

ステップ 4: インストール成功を確認する

codex --version

バージョンが表示されればインストール完了です。

設定スクリプトを実行する

インストール後は次のスクリプトを実行します。

.\run-codex-setup.cmd

スクリプトでは以下の 2 つを入力します。

base URL

API key

設定内容は自動で次のファイルに書き込まれます。

~/.codex/config.toml

~/.codex/auth.json

既存ファイルがある場合は、上書き前にバックアップが作成されます。

設定後は次で起動します。

codex

より自由な実行モードにすぐ入りたい場合は次でも構いません。

codex --yolo

macOS Apple Silicon のインストール手順

M1 / M2 / M3 / M4 向けです。

cd "/あなたのパス/codex-npm-offline/macos-arm64/npm-offline"
bash ./install-codex-macos-arm64.sh

手動インストールの場合:

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-arm64@file:./codex-npm-darwin-arm64-0.121.0-alpha.6.tgz

その後、次で確認します。

codex --version

続けて設定スクリプトを実行します。

bash ./setup-codex-macos.sh

最後に起動します。

codex

macOS Intel のインストール手順

cd "/あなたのパス/codex-npm-offline/macos-x64/npm-offline"
bash ./install-codex-macos-x64.sh

手動インストールの場合:

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-x64@file:./codex-npm-darwin-x64-0.121.0-alpha.6.tgz

確認コマンド:

codex --version

続けて設定スクリプトを実行します。