Qwen Code CLIのセットアップと使い方：完全初心者ガイド

プログラミング支援 2025/08/04

目次

Qwen Code CLIとは？

Qwen Code CLIは、AI支援のコーディング機能をターミナルに直接もたらす強力なコマンドラインインターフェースです。Alibaba Cloudによって構築されたこのツールは、高度なQwen言語モデルを活用して、開発者がコードの記述、デバッグ、最適化をより効率的に行うのを支援します。

主な機能：

  • ・コード生成と補完
  • ・バグ検出と修正提案
  • ・コードの説明とドキュメント生成
  • ・多言語サポート
  • ・一般的な開発ワークフローとの統合

1. 前提条件

Qwen Code CLIのセットアップに進む前に、システムが必要な要件をすべて満たしていることを確認しましょう。

システム要件

  • オペレーティングシステム： Windows 10以降, macOS 10.14以降, またはLinux (Ubuntu 18.04以降)
  • Node.js： バージョン20以上
  • NPM： バージョン8以上 (通常Node.jsに付属)
  • インターネット接続： API呼び出しに必要

Node.jsのインストール

Node.jsがインストールされていない場合、いくつかのインストール方法があります。

方法1：公式インストーラー (初心者におすすめ)

nodejs.orgにアクセスし、お使いのオペレーティングシステム用のLTSバージョンをダウンロードします。インストーラーがすべてを自動的に処理します。

方法2：パッケージマネージャーを使用

Homebrewを使用するmacOSユーザーの場合：

brew install node

Ubuntu/Debianユーザーの場合：

sudo apt update
sudo apt install nodejs npm

方法3：NPMインストールスクリプトを使用

Unixベースのシステムでは、公式のインストールスクリプトを使用できます：

curl -qL https://www.npmjs.com/install.sh | sh

インストールの確認

インストール後、Node.jsとNPMが正しくインストールされているか確認します：

node -v
npm -v

バージョン番号が表示されるはずです。エラーが発生した場合は、インストールプロセスを再確認してください。

プロのヒント：複数のNode.jsバージョンを管理している場合は、Node Version Manager (NVM) を使用してバージョン管理を改善することを検討してください。

2. インストールプロセス

Qwen Code CLIのインストール

Node.jsが正しくインストールされたので、Qwen Code CLIをシステムにグローバルにインストールします：

npm install --global @qwen-code/qwen-code

このコマンドはQwen Code CLIをグローバルにインストールし、ターミナルのどのディレクトリからでもアクセスできるようにします。

インストールの確認

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

qwen --version

インストールされたバージョン番号が表示され、Qwen Code CLIが使用準備完了であることが確認できます。

⚠️ よくあるインストールの問題：

  • ・権限エラー：Unixシステムではsudoを使用するか、Windowsでは管理者として実行してみてください
  • ・ネットワークの問題：インターネット接続とファイアウォールの設定を確認してください
  • ・古いNPM：npm install -g npm@latestを使用してNPMを更新してください

初期設定

Qwen Code CLIを初めて起動します：

qwen

CLIはテーマ選択を含む初期設定オプションを表示します。Enterキーを押してデフォルトのテーマを受け入れると、ユーザー設定に適用されます。

Qwen Code CLI-Setup Step

3. 認証設定

Qwen Code CLIは、QwenモデルにアクセスするためにAPIキーが必要です。いくつかのプロバイダーが利用可能ですが、このチュートリアルでは無料枠と有料枠の両方を提供するOpenRouterを使用します。

なぜOpenRouterなのか？

  • ・単一のAPIで複数のモデルにアクセス可能
  • ・テスト用の無料枠が利用可能
  • ・本番環境向けの競争力のある価格設定
  • ・優れたドキュメントとサポート

OpenRouterアカウントの設定

  1. ・https://openrouter.ai/にアクセスします
  2. ・「Sign Up」をクリックしてアカウントを作成します
  3. ・メールアドレスを認証します
  4. ・アカウント設定プロセスを完了します

APIキーの取得

・OpenRouterのダッシュボードにログインします

・「Keys」セクションに移動します

OpenRouter-Create Key

・「Create API Key」をクリックします

・わかりやすい名前（例：「Qwen Code CLI」）を付けます

・必要に応じて使用制限を設定します

・「Create」をクリックし、生成されたキーをコピーします

OpenRouter-Create Key

🔒 セキュリティノート： APIキーは安全に保管し、絶対に公開しないでください。パスワードのように扱ってください。

Qwenモデルの選択

OpenRouterのダッシュボードで：

・「Models」タブに移動します

・「Qwen3 Coder」を検索します

・利用可能なオプションを確認します：

無料版 Qwen: Qwen3 Coder (free)： 128kトークンに制限、テストに最適

有料版 Qwen: Qwen3 Coder： 100万入出力トークンあたり$0.302、本番環境向け

ニーズに合ったバージョンを選択します

OpenRouter - Model - Qwen3 Coder

4. 環境設定

次に、OpenRouterのAPIキーを使用し、Qwenモデルに接続するようにCLIを設定します。

API設定の構成

Qwen CLIを実行しているターミナルに戻ります。閉じてしまった場合は、再度起動します：

qwen

Enterキーを押して設定画面に進み、以下の詳細を入力します：


API_KEY > [YOUR_OPENROUTER_API_KEY]
BASE_URL > https://openrouter.ai/api/v1
MODEL > qwen/qwen3-coder:free または qwen/qwen3-coder
Qwen Code CLI-Setup Step

設定の内訳

  • API_KEY： あなたのユニークなOpenRouter APIキー
  • BASE_URL： OpenRouter APIのエンドポイント
  • MODEL： 使用するQwenモデルを指定

設定のテスト

設定詳細を入力した後、Enterキーを押します。CLIは正常に接続し、準備完了のプロンプトを表示するはずです。

5. 基本的な使用例

すべてが設定されたので、Qwen Code CLIの実用的な例をいくつか見ていきましょう。

コード生成

Qwenにコードの生成を依頼します：

フィボナッチ数を計算するPython関数を生成してください

コードの説明

既存のコードの説明を取得します：

このJavaScriptコードを説明してください：
const arr = [1,2,3].map(x => x * 2);

バグ検出

Qwenにコードの潜在的な問題を確認してもらいます：

このコードのバグをレビューしてください：
def divide(a, b):
    return a / b

コードの最適化

パフォーマンスの改善をリクエストします：

このSQLクエリをパフォーマンス向上のために最適化してください：
SELECT * FROM users WHERE age > 18 AND status = 'active'

6. トラブルシューティング

一般的な問題と解決策

APIキー認証エラー

  • ・APIキーが正しく、有効期限が切れていないことを確認してください
  • ・OpenRouterアカウントに十分なクレジットがあるか確認してください
  • ・BASE_URLが正確にhttps://openrouter.ai/api/v1であることを確認してください

接続の問題

  • ・インターネット接続を確認してください
  • ・ファイアウォールの設定が接続をブロックしていないか確認してください
  • ・制限されたネットワーク内にいる場合は、VPNの使用を試してください

モデルが見つからないエラー

  • ・モデル名がqwen/qwen3-coderであることを確認してください
  • ・モデルがOpenRouterアカウントで利用可能か確認してください
  • ・特定のモデルバージョンにアクセスできることを確認してください

インストールの問題

  • ・Node.jsを最新のLTSバージョンに更新してください
  • ・NPMキャッシュをクリア：npm cache clean --force
  • ・CLIを再インストール：npm uninstall -g @qwen-code/qwen-code && npm install -g @qwen-code/qwen-code

ヘルプの入手

ここでカバーされていない問題に遭遇した場合：

  • ・公式のQwenドキュメントを確認してください
  • ・OpenRouterのサポートページにアクセスしてください
  • ・Stack Overflowなどの開発者コミュニティで検索してください
  • ・QwenリポジトリのGitHub issueを確認してください

まとめ

Qwen Code CLIのセットアップと設定が正常に完了しました。この強力なツールは、AI支援開発を通じてコーディングの生産性を向上させる準備が整いました。

達成したこと

  • ✅ Node.jsとNPMをインストールした
  • ✅ Qwen Code CLIをグローバルにセットアップした
  • ✅ OpenRouter APIアクセスを作成・設定した
  • ✅ Qwen 3 Coderモデルに接続した
  • ✅ 基本的な使用パターンを学んだ

次のステップ

Qwen Code CLIが実行できるようになったので、次のことを検討してみてください：

  • ・より良いコード生成のための高度なプロンプト技術
  • ・既存の開発ワークフローとの統合
  • ・OpenRouterを通じて利用可能な他のモデルの探索
  • ・CLIを使用した自動スクリプトの設定

プロのヒント： 簡単なクエリから始めて、徐々により複雑なコーディングタスクに進んでください。プロンプトが具体的であるほど、AIの応答はより良くなります。