【Windows】Codex CLIのインストール方法まとめ（npm / proxy環境対応）

OpenAIの Codex CLI を導入しようとしたときに、

npm install が失敗する
registry に接続できない
proxy 設定で詰まる

というケースが結構あります。

特に 会社ネットワーク / VPN / 社内プロキシ環境 では
npm の設定が原因でインストールできないことが多いです。

この記事では

Codex CLI を確実に導入する手順

をまとめます。

確認
↓
設定リセット
↓
registry設定
↓
proxy設定（必要な場合）
↓
Codex CLI install

この順で進めればほぼ確実に導入できます。

想定環境

Windows
PowerShell
Node.js
npm
社内ネットワークの可能性あり

Codex CLIとは

Codex CLI は OpenAI の AIコーディングツールをCLIから使えるツールです。

例えば

codex

を実行すると

コード生成
リファクタリング
コマンド生成

などを ターミナルから直接実行できます。

導入手順

1 Node.js / npm バージョン確認

まず Node.js と npm が使えるか確認します。

node -v
npm -v

例

v20.x.x
10.x.x

もし表示されない場合は Node.js をインストールしてください。

⸻

2 npm 設定確認

npm がどこを参照しているか確認します。

npm config get registry
npm config get proxy
npm config get https-proxy
npm config list

さらに環境変数 proxy が残っていないかも確認します。

Get-ChildItem Env: | Where-Object { $_.Name -match 'proxy' }

⸻

3 npm proxy設定をリセット

古い設定が残っていると npm install が失敗します。

一度クリアします。

npm config delete proxy
npm config delete https-proxy

$env:HTTP_PROXY=""
$env:HTTPS_PROXY=""
$env:http_proxy=""
$env:https_proxy=""

⸻

4 npm registry 再設定

npm の参照先を公式レジストリに戻します。

npm config set registry https://registry.npmjs.org/

⸻

5 DNS 名前解決確認

npm registry が解決できるか確認します。

nslookup registry.npmjs.org

成功すると

Address: xxx.xxx.xxx.xxx

が表示されます。

⸻

6 社内プロキシ設定（必要な場合）

会社ネットワークでは proxy 設定が必要な場合があります。

npm config set proxy http://<user>:<password>@<proxy>:<port>
npm config set https-proxy http://<user>:<password>@<proxy>:<port>

例

注意
• 認証情報は .npmrc に保存される
• パスワードに @ や : がある場合 URLエンコード必要

⸻

7 Codex CLI インストール

準備ができたらインストールします。

npm install -g @openai/codex

⸻

8 インストール確認

codex --version

パス確認

where.exe codex

起動

codex

⸻

9 セキュリティ対応（proxy削除）

proxy に認証情報が入っているため
不要なら削除しておきます。

npm config delete proxy
npm config delete https-proxy

.npmrc も確認

notepad $HOME\.npmrc

⸻

よくあるエラー

npm install がタイムアウトする

原因
• proxy 設定ミス
• firewall
• DNS問題

確認

npm config list

⸻

registry.npmjs.org に接続できない

DNS確認

nslookup registry.npmjs.org

⸻

図で理解する npm 通信

PC
↓
npm
↓
registry.npmjs.org
↓
パッケージ取得

社内ネットワークの場合

PC
↓
proxy
↓
internet
↓
registry.npmjs.org

⸻

まとめ

Codex CLI 導入で詰まりやすいのはこの3つです。
• npm registry 設定
• proxy 設定
• 社内ネットワーク制限

対策は

設定確認
↓
proxy削除
↓
registry再設定
↓
install

これでほぼ解決します。

⸻

参考

npm registry
https://registry.npmjs.org/

Codex CLI
https://www.npmjs.com/package/@openai/codex

⸻

おまけ

Codex CLI を使うと
• CLIからAIコーディング
• bashコマンド生成
• リファクタリング
• 自動コード生成

などが可能になります。

今後 AI × CLI 開発スタイルはかなり主流になりそうです。
頑張っていきましょう