Qwen CLI：Qwen Codeのインストール方法と使い方（2026）

TL;DR

• Qwen CLI（正式名称は Qwen Code）は Alibaba のオープンソースのターミナル用コーディングエージェントです。Qwen モデル向けに調整された Gemini CLI のフォークです。Node.js 22+ で npm install -g @qwen-code/qwen-code@latest を使ってインストールします。
• 多くのガイドが見落としている大きな変更点: 無料の Qwen OAuth ティアは 2026-04-15 に廃止されました。 以前の「1 日 2,000 件の無料リクエスト」はもう機能しません。現在は API プロバイダーが必要です。
• 3 つの環境変数 OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL で OpenAI 互換エンドポイントを指定すればセットアップできます。設定はこれだけです。
• 1 つのエンドポイントで Qwen *と* 他のモデルを実行できます。OPENAI_BASE_URL を [Velokey](https://api.velokey.ai) に向けると、単一のキーで Qwen Code を qwen3.7-max、GPT、Claude、GLM で動かせます。

Qwen CLI（Qwen Code）とは？

Qwen CLI は Qwen Code の一般的な呼び名で、Alibaba の Qwen チームが構築した、ターミナルで動作するオープンソースの AI コーディングエージェントです。コードベースを読み書きし、コマンドを実行し、タスクに対してエージェント的に動作します。Claude Code や Gemini CLI と同じような形です。実際、これは Gemini CLI のフォーク として始まり、Qwen のモデル向けに調整されたプロンプトとパーサーで適応されています。

インストール前に知っておく価値のある点が 2 つあります。まず、パッケージ名は @qwen-code/qwen-code なので、「qwen cli」「qwen-cli」「qwen code cli」はすべて同じツールを指します。次に、多くの人がここでつまずくのですが、これは Qwen のサーバーに固定されていません。OpenAI 互換プロトコルを扱うため、Qwen の API、OpenRouter、ローカルモデル、ゲートウェイに対して実行できます。無料ルートが変更された現在、この点はこれまで以上に重要です。

Qwen Code CLI をインストールするには？

Node.js 22 以降で、npm を使って Qwen Code をグローバルにインストールします。

npm install -g @qwen-code/qwen-code@latest
qwen --version

macOS を使っている場合は Homebrew も使えます（brew install qwen-code）。Linux と Windows 向けにはスタンドアロンインストーラーもあります。インストール時に実際に重要なのは次の点です。

インストール後に qwen: command not found が表示される場合、グローバル npm bin ディレクトリが PATH に入っていません。npm config get prefix を実行し、その /bin を PATH に追加してください。Linux でグローバルインストール中に権限エラーが出る場合は、通常 sudo が必要であることを意味しますが、より良い方法は nvm 管理の Node を使い、グローバルインストールがシステムディレクトリに触れないようにすることです。

無料ティアがなくなった今、Qwen CLI をどうセットアップする？

Qwen Code は OpenAI 互換 API キーで設定します。なぜなら 無料の Qwen OAuth ティアは [2026-04-15 に廃止された](https://github.com/QwenLM/qwen-code/issues/3203) からです。キャッシュされたトークンはしばらく残る可能性がありますが、新規サインインは拒否されます。その無料ティアは以前、1 日 2,000 リクエスト、1 分あたり 60 リクエストを提供していました。「Qwen Code を無料で使う」系のチュートリアルの多くはいまだにそれを説明していますが、現在は誤りです。

現在のセットアップは 3 つの環境変数です。それらを設定し、qwen を実行して、認証メニューで "OpenAI" を選択します。

export OPENAI_API_KEY="your_api_key"
export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"
qwen

設定ファイルの方がよいですか？Qwen Code は ~/.qwen/settings.json（またはプロジェクトローカルの .qwen/settings.json）を読み込み、そこでモデルプロバイダーを一度定義できます。

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [{
        "id": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      }]
    }
  },
  "security": { "auth": { "selectedType": "openai" } }
}

現在のプロバイダーの選択肢は、Alibaba Cloud の ModelStudio Coding Plan（固定月額サブスクリプション）、DashScope の従量課金 API、OpenRouter、Fireworks、またはその他の OpenAI 互換エンドポイントです。公式の認証ドキュメント には現在の一覧が載っています。まさにここが古くなった部分なので、古いブログではなくそちらを確認してください。

1 つのエンドポイント経由で任意のモデルを使って Qwen CLI を実行するには？

OPENAI_BASE_URL をゲートウェイに向ければ、1 つのキーで Qwen Code を多くのモデルに対して実行できます。プロバイダーごとにアカウントを切り替える必要はありません。Qwen Code が必要とするのは OpenAI 互換エンドポイントだけなので、Velokey はそのまま差し替えで使えます。1 つのキーで、同じベース URL 経由で Qwen、GPT、Claude、GLM に到達できます。

export OPENAI_API_KEY="sk-your-velokey-key"
export OPENAI_BASE_URL="https://api.velokey.ai/v1"
export OPENAI_MODEL="qwen3.7-max"
qwen

実用上の利点は、再認証なしでバックエンドを切り替えられることです。Qwen Code は Qwen モデル向けに調整されているため、[qwen3.7-max](/model/qwen3.7-max) が自然なデフォルトです。ただし、タスクが別のモデルを求める場合は、1 つの変数を変更します。

課金はクレジット経由のトークン単位なので、別個のサブスクリプションや 1 日あたりのリクエスト上限はありません。エージェントが実際に使った分だけ支払います。この計算がどのように成り立つかについては、Claude API 価格ガイド を参照してください。同じトークン単位モデルが Qwen やその他にも適用されます。

Qwen CLI が動作しないのはなぜ？よくあるエラー

Qwen CLI の失敗の多くはバグではなく、環境または認証の問題です。そして原因はいくつかに集中しています。qwen --safe-mode を開始してカスタマイズを無効化してください。問題が消えた場合は、設定を 1 つずつ再有効化して原因を見つけます。

キーが環境変数ではなくブラウザベースのツールに保存されている場合、セッション不足により別種のエラーが発生することがあります。「API key not found in cookies」の修正 に関するガイドを参照してください。API キーをクライアントに接続する一連の手順については、API キーでモデルを呼び出す方法 がセットアップパターンを説明しています。

よくある質問

Qwen CLI をインストールするには？

Node.js 22 以降で npm install -g @qwen-code/qwen-code@latest を実行し、その後 qwen --version で確認します。macOS では brew install qwen-code も使えます。command not found が出る場合は、グローバル npm bin ディレクトリ（npm config get prefix + /bin）を PATH に追加してください。

Qwen CLI は無料で使えますか？

組み込みの経路では、もう無料ではありません。無料の Qwen OAuth ティアは 2026-04-15 に廃止されました。CLI 自体はオープンソースで無料ですが、現在は API プロバイダーが必要です。Alibaba の ModelStudio Coding Plan、DashScope の従量課金、OpenRouter、または自分のキーで設定した任意の OpenAI 互換エンドポイントを使います。

自分の API キーで Qwen CLI を使うには？

3 つの環境変数 OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL を設定し、qwen を実行して認証メニューで "OpenAI" を選択します。~/.qwen/settings.json でプロバイダーを定義することもできます。ベース URL は、使用している OpenAI 互換プロバイダーを指します。

Qwen Code CLI はどのモデルをサポートしていますか？

Qwen Code は Qwen3-Coder のような Qwen モデル向けに調整されていますが、OpenAI 互換プロトコルを扱うため、OpenAI、Anthropic、Gemini、OpenRouter、Ollama や vLLM 経由のローカルモデル、ゲートウェイに対して実行できます。OPENAI_MODEL をプロバイダーが公開しているモデル ID に設定してください。

なぜ Qwen CLI は "command not found" と表示するのですか？

グローバル npm bin ディレクトリが PATH に入っていません。npm config get prefix を実行してインストールプレフィックスを見つけ、その /bin サブフォルダーを PATH に追加してシェルを再起動してください。これはインストール後に最もよくあるエラーで、ツール自体とは関係ありません。

Qwen の API ではなくゲートウェイに対して Qwen CLI を実行できますか？

はい。Qwen Code は任意の OpenAI 互換エンドポイントを受け入れるため、OPENAI_BASE_URL をゲートウェイに向け、1 つのキーで複数のモデルに到達できます。OPENAI_MODEL を使いたいモデルに設定してください。ツール呼び出しの忠実度を最大にするなら Qwen モデル、またはタスクごとに別のモデルを選びます。