Skip to main content
はじめに

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

環境要件

Qoder CLI をインストールする前に、お使いの環境が以下の要件を満たしていることをご確認ください。
  • オペレーティングシステム：macOS、Linux、Windows（Windows Terminal の使用を推奨）。
  • CPU アーキテクチャ：arm64、amd64。
  • Node.js：従来の npm インストール方法を使用する場合にのみ Node.js >= 20.0.0 が必要です。
Windows (arm64) は現在サポートされていません。

インストール

新規インストールにはインストールスクリプトを使用してください。ネイティブのスタンドアロン実行ファイルがインストールされ、特に Windows で起動時と実行時のパフォーマンスが向上します。

インストールスクリプトの使用（推奨）

インストールスクリプトは、オペレーティングシステムと CPU アーキテクチャに適合するネイティブビルドを自動的に選択してダウンロードし、実行可能ファイルを設定します。 macOS / Linux 
curl -fsSL https://qoder.com/install | bash
Windows PowerShell 
irm https://qoder.com/install.ps1 | iex
Windows CMD 
curl -fsSL https://qoder.com/install.cmd -o install.cmd && install.cmd

npm を使用したインストール（新規インストールには非推奨）

npm パッケージはネイティブのスタンドアロンランタイムではなく、Node.js で JavaScript bundle を実行するため、特に Windows では起動時と実行時のパフォーマンスが低下する場合があります。この方法は既存環境との互換性のためにのみ維持されています。新規インストールにはインストールスクリプトを使用してください。 npm 互換方式が引き続き必要な場合は、Node.js >= 20.0.0 をインストールしてから次を実行します。 
npm install -g @qoder-ai/qodercli

インストールの確認

インストール完了後、以下のコマンドを実行します。CLI のバージョン番号が表示されれば、インストールは成功です。 
qoder --version
コマンドが見つからないというエラーが表示される場合は、インストールディレクトリがシステムの PATH に追加されているか確認してください。トラブルシューティングの手順については、インストールとアップグレードの問題 を参照してください。

初回実行

任意のプロジェクトルートディレクトリで以下のコマンドを実行すると、デフォルトのインタラクティブ（TUI）モードに入ります。 
qoder
初回実行時、Qoder CLI はサインイン手続きを案内します。サインイン方法の詳細については、サインインと認証 を参照してください。

アップグレード

Qoder CLI はデフォルトで自動アップグレードが有効になっています。いつでも手動で最新バージョンにアップグレードすることもできます。

インストールスクリプトを使用したアップグレード

macOS / Linux 
curl -fsSL https://qoder.com/install | bash -s -- --force
Windows PowerShell 
irm https://qoder.com/install.ps1 | iex
Windows CMD 
curl -fsSL https://qoder.com/install.cmd -o install.cmd && install.cmd

組み込み更新コマンドの使用

qoder update

既存の npm インストールのアップグレード

既存の npm インストールでは、推奨のインストールスクリプトへ移行するまで、次のコマンドでアップグレードできます。 
npm install -g @qoder-ai/qodercli@latest

自動アップグレードの設定

自動アップグレードはデフォルトで有効になっています。自動アップグレードを無効にするには、~/.qoder/settings.json で general.enableAutoUpdate を false に設定します。 
{
  "general": {
    "enableAutoUpdate": false
  }
}
構成ファイルのスコープと適用順序については、構成ファイルと適用順序 を参照してください。

アンインストール

アンインストール方法は、インストール方法によって異なります。
  • npm 経由でインストールした場合：npm uninstall -g @qoder-ai/qodercli を実行します。
  • インストールスクリプト経由でインストールした場合：インストールスクリプトによって配置された実行可能ファイルを削除し、PATH から対応するディレクトリを削除します。
構成とローカルデータも同時にクリーンアップしたい場合は、構成ディレクトリ（デフォルトは ~/.qoder）を削除します。削除する前に、保持が必要なセッション、メモリ、設定が含まれていないことを確認してください。
構成ディレクトリの場所は、QODER_CONFIG_DIR 環境変数でカスタマイズでき、デフォルトは ~/.qoder です。この変数を設定している場合は、対応するディレクトリを削除してください。
はじめに
コアコンセプト
Qoder CLI を使用する
Qoder CLI の拡張
リモートと統合
設定とセキュリティ
リファレンス
トラブルシューティング