🧠 Codex（WSL / Windows 共存）トラブルシュートまとめ

5月 7, 2026

📌 背景

• 環境：
  • Windows 10
  • WSL2（Ubuntu）
  • Node.js（nvm管理）
• 目的：
  • Windows と WSL の両方で Codex を共存させる

---

❗ 発生していた問題

WSLで codex 実行時にエラー：

Error: Missing optional dependency @openai/codex-linux-x64

---

🔍 原因

which codex
→ /mnt/c/Users/.../npm/codex  （Windows側）

which node
→ /home/.../.nvm/.../node     （WSL側）

👉 Windows版codex + Linux版node の不整合

---

🧠 何が起きていたか

WSL（Linux環境）
  ↓
Windowsのcodexを実行
  ↓
Linux用依存（codex-linux-x64）を探す
  ↓
見つからずエラー

---

⚠️ なぜこうなったか

WSLの仕様：

WindowsのPATHを自動で引き継ぐ

そのため：

Linuxにcodexが無い
→ PATH後方のWindowsを拾う

---

🛠 実施した対処

① WSL側にCodexをインストール

npm install -g @openai/codex@latest

---

② PATHの状態確認

type -a codex

結果：

codex is /home/.../.nvm/.../bin/codex   ← WSL側
codex is /mnt/c/.../npm/codex           ← Windows側

---

③ フルパスで動作確認

/home/.../.nvm/.../bin/codex

👉 正常起動を確認

---

④ PATH優先順位の改善

結果的に：

type -a codex

1. /home/.../.nvm/.../bin/codex   ← 優先される
2. /mnt/c/.../npm/codex

👉 フルパス不要で起動可能に

---

✅ 最終状態

WSL側
  node → Linux版
  codex → Linux版

Windows側
  node → Windows版
  codex → Windows版

👉 完全分離・共存成功

---

⚠️ 注意点

1. PATH順序が重要

先に見つかったコマンドが実行される

---

2. 再発リスク

以下で順序が変わる可能性あり：

• Node再インストール
• .bashrc変更
• VSCode設定変更

---

🔒 安定化設定（推奨）

.bashrc

# nvm優先
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

---

（任意）Windows npmを除外

export PATH=$(echo $PATH | tr ':' '\n' | grep -v '/mnt/c/Users/{username}/AppData/Roaming/npm' | paste -sd ':' -)

---

💡 補足

Claude / Gemini が動く理由

・単体バイナリ or API型
・OS依存が弱い

Codex が壊れる理由

・npm依存（OS別バイナリ）
・環境不一致に弱い

---

🧩 今回の本質

NG：
WSL → Windows codex

OK：
WSL → Linux codex
Windows → Windows codex

---

🎯 結論

👉 「PATH優先順位を制御すれば共存可能」

---

🚀 今後の推奨構成

Windows
  ・Claude
  ・Gemini
  ・GUI系

WSL
  ・Codex
  ・OpenClaw
  ・開発実行環境