環境要件
Qoder CLI をインストールする前に、お使いの環境が以下の要件を満たしていることをご確認ください。
- オペレーティングシステム:macOS、Linux、Windows(Windows Terminal の使用を推奨)。
- CPU アーキテクチャ:arm64、amd64。
- Node.js:npm を使用してインストールする場合は Node.js >= 20.0.0 が必要です。
Windows (arm64) は現在サポートされていません。
インストール
Qoder CLI には複数のインストール方法が用意されています。環境や好みに合わせていずれかを選択してください。
インストールスクリプトの使用(推奨)
インストールスクリプトは、現在のシステムに適合するバージョンを自動的にダウンロードし、実行可能ファイルを設定します。
macOS / Linux
npm を使用したインストール
Node.js(>= 20.0.0)が既にインストールされている場合は、npm を使用してグローバルにインストールできます。
beta は Node ネイティブ互換版のプレビューチャネルであり、バージョン番号が安定版より低い場合があります。特別な必要がなければ、安定版のインストールを推奨します。
インストールの確認
インストール完了後、以下のコマンドを実行します。CLI のバージョン番号が表示されれば、インストールは成功です。
PATH に追加されているか確認してください。トラブルシューティングの手順については、インストールとアップグレードの問題 を参照してください。
初回実行
任意のプロジェクトルートディレクトリで以下のコマンドを実行すると、デフォルトのインタラクティブ(TUI)モードに入ります。
アップグレード
Qoder CLI はデフォルトで自動アップグレードが有効になっています。いつでも手動で最新バージョンにアップグレードすることもできます。
インストールスクリプトを使用したアップグレード
macOS / Linux
組み込み更新コマンドの使用
npm を使用したアップグレード
自動アップグレードの設定
自動アップグレードはデフォルトで有効になっています。自動アップグレードを無効にするには、~/.qoder/settings.json で general.enableAutoUpdate を false に設定します。
アンインストール
アンインストール方法は、インストール方法によって異なります。
- npm 経由でインストールした場合:
npm uninstall -g @qoder-ai/qodercliを実行します。 - インストールスクリプト経由でインストールした場合:インストールスクリプトによって配置された実行可能ファイルを削除し、
PATHから対応するディレクトリを削除します。
~/.qoder)を削除します。削除する前に、保持が必要なセッション、メモリ、設定が含まれていないことを確認してください。
構成ディレクトリの場所は、QODER_CONFIG_DIR環境変数でカスタマイズでき、デフォルトは~/.qoderです。この変数を設定している場合は、対応するディレクトリを削除してください。