インストールとアップグレードの問題

本ページでは、Qoder CLI のインストールおよびアップグレード時の一般的な問題と解決方法をまとめています。インストール手順については、インストールとアップグレードを参照してください。

コマンドが見つかりません（command not found）

インストール後に qoder を実行した際にコマンドが見つからないというエラーが表示される場合、通常は実行可能ファイルが存在するディレクトリが PATH に含まれていないことが原因です。

npm でグローバルインストールした場合は、グローバル bin ディレクトリが PATH に追加されていることを確認してください：
```
npm config get prefix   # グローバルインストールプレフィックスを確認
# <prefix>/bin を PATH に追加
```
PATH を変更した後は、その変更を反映させる必要があります。Linux / macOS の場合は、シェル構成ファイル（~/.zshrc や ~/.bashrc など）を変更した後、ターミナルを再起動するか、source を実行してください。Windows の場合は、システム環境変数を変更した後、ターミナルを再起動する必要があります。

インストール場所を確認する：

# Linux / macOS
which qoder

# Windows
where qoder          # コマンドプロンプト
Get-Command qoder    # PowerShell

Windows arm64 デバイスでインストールが失敗する場合、または利用可能なバイナリがない場合：このプラットフォームは現在サポートされていません。インストールとアップグレードを参照してください。

グローバルインストール時に権限エラーが発生した場合は、管理者権限での強制インストールは避けてください。npm のグローバルディレクトリをユーザーが書き込み可能なパスに変更してから、再インストールすることをお勧めします。
バージョンマネージャー（nvm など）を使用してランタイムを管理すると、システムレベルのディレクトリに関する権限の問題を回避できます。

まず、組み込みの更新コマンドを実行します：
```
qoder update
```
アップグレード後も古いバージョンが表示される場合は、現在どのバイナリが呼び出されているかを確認します（Windows の場合は where qoder を使用）：
```
which qoder
qoder --version
```
複数のチャネル（npm と Homebrew の同時使用など）からインストールされている場合、複数の qoder が存在し、PATH の先頭にあるものが優先的に呼び出される可能性があります。不要なチャネルのバージョンをアンインストールし、1つだけにしてください。
クリーンアップ後、元のチャネルで最新バージョンを再インストールします。スクリプトインストールの場合は curl -fsSL https://qoder.com/install | bash -s -- --force で強制再インストールし、npm インストールの場合は npm install -g @qoder-ai/qodercli@latest を使用します。詳細はインストールとアップグレードを参照してください。

一致するすべての実行可能ファイルをリストアップし、複数存在しないか確認します。Linux / macOS の場合は which -a qoder、Windows の場合は where qoder（コマンドプロンプト）または Get-Command qoder -All（PowerShell）を使用します。
1つのインストールチャネルのみを残し、他を削除してバージョンの混同を避けます。

インストール完了後、以下のコマンドを実行して利用可能であることを確認します：

qoder --version
qoder --help

両方とも正常に出力されれば、インストールは成功です。