【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 開発スタイル はかなり主流になりそうです。
頑張っていきましょう