Skip to main content
はじめに

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

環境要件

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

インストール

Qoder CLI には複数のインストール方法が用意されています。環境や好みに合わせていずれかを選択してください。

インストールスクリプトの使用(推奨)

インストールスクリプトは、現在のシステムに適合するバージョンを自動的にダウンロードし、実行可能ファイルを設定します。 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 を使用したインストール

Node.js(>= 20.0.0)が既にインストールされている場合は、npm を使用してグローバルにインストールできます。
npm install -g @qoder-ai/qodercli
リリースチャネルの指定:
# 安定版
npm install -g @qoder-ai/qodercli@latest

# Node ネイティブ互換版(ベータ)
npm install -g @qoder-ai/qodercli@beta
beta は Node ネイティブ互換版のプレビューチャネルであり、バージョン番号が安定版より低い場合があります。特別な必要がなければ、安定版のインストールを推奨します。

インストールの確認

インストール完了後、以下のコマンドを実行します。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 install -g @qoder-ai/qodercli@latest

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

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

アンインストール

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