# Qwen Code CLIのインストール方法：ターミナルAIコーディングエージェントのステップバイステップチュートリアル

ターミナル向けのオープンソースAIコーディングエージェント「Qwen Code CLI」のインストール方法を学びましょう。npm、クイックインストールスクリプト、Homebrewを使用した手順と、Windows、macOS、Linuxでのトラブルシューティングをステップバイステップで解説します。

Canonical URL: https://a2a-mcp.org/blog/qwen-cli-install-ja

Language: ja

Published: 2026-04-07

Updated: 2026-04-07

## 前提条件

**Qwen Code CLI** (Qwenモデルを基盤とした公式ターミナルベースAIコーディングエージェント)をインストールする前に、以下の要件を満たしていることを確認してください：

- **Node.js** バージョン20以上（推奨：最新のLTS）。 [nodejs.org](https://nodejs.org)からダウンロードしてください。
- Windowsでは管理者権限を持つターミナルまたはコマンドプロンプト。
- パッケージとモデルをダウンロードするためのインターネット接続。
- オプションだが推奨：Git（手動ソースインストール用）およびmacOS/Linux用のHomebrew。

**Node.jsのインストールを確認**：

```bash
node --version
npm --version
```

期待される出力は `v20.x.x` またはそれ以上のバージョンを示します。

## ステップ1：インストール方法を選択する

Qwen Code CLIは複数のインストール方法を提供します。 **クイックインストールスクリプト** は依存関係を自動的に処理するため、ほとんどのユーザーに推奨されます。

### クイックインストール（推奨）

**Linux / macOS**：

```bash
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"
```

**Windows (管理者としてコマンドプロンプトを実行)**：

```cmd
curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat
```

実行後、ターミナルを再起動してPATHを更新してください。

## ステップ2：npmによる手動インストール

手動制御を希望する場合：

```bash
npm install -g @qwen-code/qwen-code@latest
```

これにより `qwen` コマンドがグローバルにインストールされます。

**sudoを使用するmacOS/Linux**（パーミッションの問題が発生した場合）：

```bash
sudo npm install -g @qwen-code/qwen-code@latest
```

## ステップ3：Homebrewによるインストール（macOS & Linux）

```bash
brew install qwen-code
```

## ステップ4：インストールの確認

以下のコマンドを実行して、インストールが成功したことを確認します：

```bash
qwen --version
```

以下のような出力が表示されるはずです：

```
Qwen Code CLI v0.x.x
```

## ステップ5：初回起動と認証

対話型CLIを起動します：

```bash
qwen
```

初回実行時、CLIはQwenアカウントでの認証を促します（ワンクリックログインのためブラウザが開きます）。ログイン後、デフォルト設定が適用され、対話型ターミナルUIに入ります。

最良の結果を得るには、まずプロジェクトディレクトリに移動してください：

```bash
cd /path/to/your/project
qwen
```

セッション内では、 `/help`、 `/model` を使用してモデルを切り替えたり、 `@filename` でファイルを参照したりできます。

## ステップ6：ソースからの手動インストール（上級者向け）

最新の未リリース変更を希望する開発者向け：

```bash
git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code
npm install
npm install -g .
```

その後、 `qwen --version` で確認してください。

## よくある問題とトラブルシューティング

- **コマンド 'qwen' が見つからない**: ターミナルを再起動するか、`hash -r` (Linux/macOS) を実行してください。Windows では、コマンドプロンプトを閉じて再度開きます。Node.js のグローバル bin ディレクトリが PATH に含まれていることを確認してください。

- **npm install 中の権限エラー**: Linux/macOS では `sudo` を使用するか、Windows では管理者としてコマンドプロンプトを実行してください。

- **Node.js のバージョンが古すぎる**: `nvm` または公式インストーラーを使用して Node 20+ にアップグレードしてください。

- **Aliyun アセットでのネットワーク問題**: フォールバックとして npm の方法をお試しください。

- **Termux または特定の Linux ディストリビューションでのインストール失敗**: `--ignore-scripts` フラグを使用します: `npm install -g @qwen-code/qwen-code@latest --ignore-scripts`

- **認証が機能しない**: ブラウザがポップアップを許可していること、および有効な Qwen アカウントをお持ちであることを確認してください。

解決しない問題がある場合は、公式 GitHub リポジトリを確認してください: https://github.com/QwenLM/qwen-code

## 次のステップ

- インタラクティブ UI を探索: 利用可能なスラッシュコマンドは `/help` と入力して確認してください。
- エージェント型コーディングを試す: CLI に自然言語を使用してコードのリファクタリング、ファイルの説明、またはタスクの自動化を依頼してみてください。
- モデルを設定: `/model` を使用して Qwen3-Coder またはその他のサポートされているバックエンド（ローカルの Ollama を含む）を選択できます。
- VS Code と統合: シームレスなエディター統合のために Qwen Code Companion 拡張機能をインストールしてください。
- 設定をカスタマイズ: `~/.qwen/settings.json` を編集してテーマ、デフォルトモデル、および高度なオプションを設定できます。

これで、ターミナル内で強力な AI ペアプログラマーとして Qwen Code CLI を使用する準備が整いました。プロジェクトフォルダ内で「このコードベースを説明して」や「この関数のパフォーマンスを向上させるためにリファクタリングして」などの簡単なプロンプトから始めてみましょう。

コーディングを楽しんでください！