Windows トラブルシューティングガイド¶

このガイドは、Windows ユーザーが CodexSpec のインストールと実行時に発生する一般的な問題を解決するのに役立ちます。

問題: CMD で "spawn codexspec access denied" (OSError 5) が発生¶

症状¶

CMD で codexspec --version または codexspec init を実行すると "Access denied" または "spawn codexspec access denied (OSError 5)" で失敗する
同じコマンドが PowerShell では正常に動作する

原因¶

これは Windows CMD と PowerShell がユーザー環境変数を処理する方法の違いによって発生します:

PATH 環境変数の更新: uv が codexspec をインストールすると、%USERPROFILE%\.local\bin をユーザー PATH に追加します。PowerShell は通常これを即座に認識しますが、CMD は端末を再起動するまで環境変数を更新しない場合があります。
プロセス作成の違い: CMD は Windows CreateProcess API を使用しますが、PowerShell はパス解決の問題に対してより寛容な異なるメカニズムを使用します。

解決策¶

解決策 1: PowerShell を使用する (推奨)¶

最も簡単な解決策は、CMD の代わりに PowerShell を使用することです:

# PowerShell で codexspec をインストールして実行
uv tool install codexspec
codexspec --version

解決策 2: CMD を再起動する¶

すべての CMD ウィンドウを閉じて、新しいものを開きます。これにより、CMD は環境変数を強制的に再読み込みします。

解決策 3: CMD で PATH を手動で更新する¶

# 現在のセッションの PATH に uv の bin ディレクトリを追加
set PATH=%PATH%;%USERPROFILE%\.local\bin

# 確認
codexspec --version

解決策 4: フルパスを使用する¶

# フルパスを使用して codexspec を実行
%USERPROFILE%\.local\bin\codexspec.exe --version

解決策 5: システム PATH に永続的に追加する¶

システムのプロパティ → 環境変数 を開く
ユーザー環境変数 または システム環境変数 で Path を見つける
追加: %USERPROFILE%\.local\bin
OK をクリックして、すべての端末を再起動する

解決策 6: uv tool の代わりに pipx を使用する¶

uv で問題が続く場合は、pipx を代替として使用します:

# pipx をインストール
pip install pipx
pipx ensurepath

# CMD を再起動してから、codexspec をインストール
pipx install codexspec

# 確認
codexspec --version

確認手順¶

問題を診断するには、CMD で以下のコマンドを実行します:

# uv の bin ディレクトリが PATH にあるか確認
echo %PATH% | findstr ".local\bin"

# codexspec 実行ファイルが存在するか確認
dir %USERPROFILE%\.local\bin\codexspec.*

# フルパスで実行してみる
%USERPROFILE%\.local\bin\codexspec.exe --version

一般的な問題¶

問題: "uv is not recognized"¶

原因: uv がインストールされていないか、PATH にない。

解決策:

# PowerShell を使用して uv をインストール
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 端末を再起動して確認
uv --version

問題: "python is not recognized"¶

原因: Python がインストールされていないか、PATH にない。