Codex CLIをインストールした直後、ターミナルで codex と打つと 「codex: command not found」（コマンドが見つかりません）と出る——これは初心者が最初にぶつかる定番のエラーです。
でも安心してください。ほとんどの場合、数分で解決 します。この記事で原因と対処法を順に見ていきましょう。
⚠️ 本記事は OpenAI 公式とは無関係の解説記事です。
このエラーの意味
command not found は、「codex という名前のコマンドが見つからない」という意味です。原因は主に次の3つ：
- PATHが通っていない（最も多い）
- インストールが完了していない
- ターミナルが古い状態のまま
「PATHが通っていない」とは、インストールはされているが、ターミナルがその場所を知らない 状態のことです。
解決法①：ターミナルを再起動する（最頻解決）
一番多い原因と解決法がこれです。
- ターミナル（またはPowerShell / Windows Terminal）を 完全に閉じる
- もう一度開く
codex --versionを試す
インストール直後はPATHがまだ反映されていないだけのことが多く、再起動で直るケースが大半 です。
解決法②：インストールされているか確認
# どこにインストールされたか確認
which codex # Mac / Linux
where codex # Windows
何も表示されなければ、インストール自体が失敗しています。→ インストール失敗の対処 へ。
npmで入れた場合は、グローバルパスを確認：
npm list -g --depth=0 | grep codex
npm config get prefix
解決法③：PATHを手動で通す（Mac / Linux）
which codex で何も出ないがインストールはされている場合、PATHを追加します。
# npmのグローバルパスを確認
npm config get prefix
# 例: /Users/あなた/.npm-global と表示されたら
# シェルの設定ファイルに追加（zshの場合）
echo 'export PATH="$PATH:'$(npm config get prefix)'/bin"' >> ~/.zshrc
source ~/.zshrc
bashを使っている場合は ~/.zshrc を ~/.bashrc に置き換えてください。
その後、再度 codex --version を確認。
解決法④：PATHを通す（Windows）
- スタートメニューで「環境変数」を検索 →「環境変数を編集」
- ユーザー環境変数の Path を選択 →「編集」
- npmのパス（
npm config get prefixの結果）＋\binを「新規」で追加 - PowerShellを再起動
codex --versionを確認
Homebrewや公式インストーラを使った場合は、通常PATHは自動設定されます。
解決法⑤：再インストール（最終手段）
上記で直らなければ、入れ直すのが早いです。
# npm の場合
npm uninstall -g @openai/codex
npm install -g @openai/codex
# Homebrew（Mac）の場合
brew reinstall openai-codex
詳しいインストール手順は CLIインストール手順 を参照。
OS別のワンポイント
Mac
zshが標準なので設定ファイルは~/.zshrc- Homebrewで入れると
brew doctorで診断できる
Windows
- PowerShell または Windows Terminal を使う
- 環境変数編集後は必ず再起動
Linux
sudoで入れた場合とnvmで入れた場合でパスが異なるnvm利用時はnvm useでバージョンを有効化
それでも解決しないとき
- 別の入り口を使う：CLIが難しければ VS Code拡張 や Web版で回避できます
- Node.jsを確認：
node -vでNode.jsが入っているか（npmインストールの場合） - 総合ガイド：他の症状は トラブルシューティング総合ガイド へ
よくある質問（FAQ）
Q. 再起動しても直りません
A. PATHが通っていない可能性が高いです。解決法③④の手順でPATHを手動追加してください。
Q. `which codex` で表示されるのに動きません
A. 表示されるパスが実際の実行ファイルと違う、または壊れている可能性。再インストールが確実です。
Q. インストールは成功したと表示されたのに見つかりません
A. npmのグローバルパスにPATHが通っていないだけです。解決法③④で対処できます。
Q. Macで「zsh: command not found」と出ます
A. 同じ問題です。~/.zshrc にPATHを追加してください（解決法③）。
Q. CLIを諦めてもいいですか？
A. もちろん。VS Code拡張やWeb版でもCodexは十分使えます。
まとめ
「codex: command not found」は、ほとんどがPATHの問題で、ターミナル再起動で直ることが大半です。それでもダメなら、PATHを手動で通すか、再インストール。
それでも解決しなければ、VS Code拡張など別の入り口で回避できます。他のトラブルは トラブルシューティング総合ガイド も参照してください。
