Windows の PowerShell で codex と入力したら、いきなりこう出ました。
codex : 用語 'codex' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。
最初は「Codex 側の不具合かな？」と思ったのですが、結論から言うと、これは Codex が壊れているのではなく、PowerShell が codex コマンドを見つけられていないだけ です。
つまり、原因はだいたい次のどれかです。
- Codex CLI をまだインストールしていない
- インストールはしたが、npm のグローバル実行パスが通っていない
- そもそも Node.js / npm が入っていない
何が起きているのか
今回のエラーは、PowerShell が codex.exe や codex.cmd のような実行可能ファイルを PATH 上で見つけられなかったときに出る典型的なものです。
つまり、codex が「壊れている」のではなく、PowerShell から見える場所に存在していない、または 見つけられない 状態です。
まず確認すること
最初に確認したいのは、Node.js と npm が入っているかどうかです。
node -v
npm -v
ここでバージョンが返ってこなければ、まだ Node.js 環境が入っていません。その場合は、先に Node.js を入れる必要があります。Codex CLI は npm 経由で配布されているため、Node.js / npm がないと始まりません。
Codex CLI の導入手順
Node.js と npm が使える状態なら、次はこれです。
npm i -g @openai/codex
その後、次を実行します。
codex
これで起動すれば、問題なく使える状態です。
それでも動かないとき
npm i -g @openai/codex を実行したのに codex が見つからない場合は、かなり高い確率で PATH の問題 です。
確認には次を使います。
npm prefix -g
npm bin -g
npm bin -g で表示されたディレクトリに Codex の実行ファイルが配置されます。そのディレクトリが Windows の環境変数 PATH に含まれていないと、PowerShell から codex と打っても見つかりません。
つまり、codex が「ない」のではなく、PowerShell から見える場所にいない だけです。
よくある勘違い
PowerShell で codex が動かないと、「Windows では使えないのでは？」と思いがちです。
でも実際には、今回のようなケースの多くは、単純に次のいずれかです。
- Node.js が未導入
- Codex CLI が未インストール
- PATH が通っていない
なので、まずは環境を順番に確認するのが近道です。
まとめ
今回の「codex と入力しても動かない件」は、要するに次のどれかです。
- Node.js / npm が未導入
@openai/codexが未インストール- npm グローバル実行パスが PATH に通っていない
PowerShell で codex が動かないからといって、すぐに「Codex は使えない」と考えなくて大丈夫です。多くの場合は、コマンドが見つからないだけ です。
まずは次の順番で確認するとスムーズです。
node -v
npm -v
npm i -g @openai/codex
codex
それでもだめなら、PATH を確認しましょう。
npm bin -g
コメント