Qwen Code のセットアップ：インストール、プロバイダー、ドイツ語 UI、API

Qwen Codeは、AlibabaのQwenチームによるオープンソースのAIコーディングエージェント（Apache-2.0）です。セットアップは、インストール、プロジェクトでqwenを起動、/authでプロバイダーを選択、タスクを依頼するという4ステップです。先に重要な点：無料のQwen OAuth利用枠は2026年4月15日に終了しました—古い手順に従っても、もう無料では先に進めません。このページでは、最新の/authメニューに沿って、ドイツ語への切り替え、ClaudeまたはGPT用の独自エンドポイントの設定、主要コマンドを説明します。最新バージョンはv0.24.7で、2026年9月29日にnpmで公開されました。リリースは少なくとも週1回行われるため、qwen --versionでバージョンを確認してください。

インストール

コマンドは公式READMEから引用しています。スタンドアロンインストーラーを使う場合、Node.jsを自分で用意する必要はありません。Node.js 22以降が必須なのはnpmの場合だけです。

# macOS / Linux (offizieller Standalone-Installer)
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

# Windows (PowerShell)
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

# npm (benötigt Node.js 22 oder neuer)
npm install -g @qwen-code/qwen-code@latest

# Homebrew (macOS / Linux)
brew install qwen-code

その後、環境変数が反映されるようターミナルを再度開いてください。Qwen CodeはもともとGoogle Gemini CLI v0.8.2を基にしていましたが、v0.1以降は独立して開発され、オリジナルとは同期されていません。Gemini CLIの設定や利用枠はここでは適用されません。

初回起動とドイツ語インターフェース

cd /pfad/zu/ihrem-projekt
qwen

# in der Sitzung:
/language ui de-DE        # Oberfläche auf Deutsch
/language output German   # Antworten des Modells auf Deutsch
/auth                     # Anbieter und API-Key einrichten

/language ui de-DEの後、Qwen Codeには「認証方法を選択」や「ツール承認モード」など独自のドイツ語表記が表示されます。このページでも同じ用語を使用しています。回答言語は別に設定され、/language output Germanで指定します。

ターミナル以外にも、デスクトップアプリ、ブラウザー上のWebインターフェース（qwen serve --open、実験的）、VS Code、Zed、JetBrains向けの統合、スクリプトやCI用のヘッドレスモード（qwen -p "..."）があります。すべて同じ無料のリポジトリに含まれていますが、推論料金は別途支払います。

/authでプロバイダーを選択する

/auth（別名/login）を実行すると、最上位に3つの選択肢がある「認証方法を選択」が開きます。まだQwen OAuthを選択しようとすると、「提供終了—Coding PlanまたはAPI Keyに切り替えてください」と表示されます。

3つのModelStudio方式は、同じ請求に対する3種類の支払い方法ではありません。ドキュメントではそれぞれに独自のエンドポイントとキーが割り当てられており、キーの種類とbaseUrlを一致させる必要があります。2026年10月1日時点でCoding Planは「提供数に限りあり、先着順、毎日0時（UTC+8）に補充」と表示されていました。そのため、ある日には申し込めない可能性があります。Coding Planでは、1つのタスクで複数のモデル呼び出しを消費します。Alibabaによると、通常、単純なタスクでは5～10回、複雑なタスクでは10～30回、またはそれ以上です。料金比較については、英語ページのQwen Code pricingで詳しく説明しています。

ClaudeまたはGPTを利用する：settings.jsonのCustom Provider

認証ドキュメントでは、OpenAI、Anthropic、Google、OpenRouterなどのサードパーティーや独自エンドポイントに対して、modelProvidersブロックを~/.qwen/settings.jsonに設定することを推奨しています。Kunavoでは次のようになります：

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI-kompatibel",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

# Den Key nicht in settings.json schreiben, sondern in .qwen/.env oder die Umgebung
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

トラブルシューティングの手間を減らす4つのポイント：

• baseUrlは/v1で終わります。Model Providersのリファレンスには、/v1—/v1/chat/completionsではなく、APIのルートを指定するよう明記されています。パスはSDK自体が追加します。パスを含めると認証エラーではなく404になります。
• キーの保存場所。Qwen CodeはenvKeyが指定する環境変数からキーを読み取ります。優先順位は、シェルのexport、次に.envファイル（推奨は.qwen/.env。最初に見つかったファイルだけが対象）、最後にenvのsettings.jsonです。そこではキーが平文で保存されます。
• ファイルがCLIオプションに優先します。順序は、/authの値→選択したmodelProvidersエントリ→CLI引数→環境変数→settings.jsonです。そのため、--openai-base-urlが効かないことがあります。古い手順にあるsecurity.auth.apiKeyとsecurity.auth.baseUrlは非推奨です。
• Chat Completionsから始めます。wireApiがなければChat Completionsが使用されます。"responses"を指定しても、エンドポイントの検出も自動フォールバックも行われません。modelProvidersの変更は実行中のセッションにも反映されます（/modelを再度開いてください）。

KunavoのカタログにはQwenテキストモデルがありません。つまり、Qwenを安く利用する方法ではなく、プリペイド残高を使ってQwen CodeからClaudeまたはGPTを利用する方法です。KunavoはQwen Codeを自社のエンドポイントに対して実行していません。英語版のQwen Codeセットアップページと同様、設定は公式ドキュメントに基づいています。試す間は、動作するルートを1つ残しておいてください。

最初のタスクと重要なコマンド

READMEでは、最初の依頼として概ね次を提案しています：「このリポジトリを説明して、どこから始めればよいか教えてください。」これにより、ファイルアクセスとツール呼び出しを同時に確認できます。単なる「こんにちは」では接続問題を検出できません。

yoloやその他の自動モードについて、ドキュメント自体が、信頼できる隔離環境または使い捨て環境でのみ使用するよう警告しています。/stats modelに表示される推定コストはQwen Code自身が計算します。実際の金額はプロバイダーの利用記録に記載されます。

知っておくべき制限

• 組み込みWeb検索はホストに依存します。DashScopeのサーバー側検索を使用します。ModelStudio Standard API KeyとToken Planでは有効で、検出されたDashScopeホストのエントリでも有効です。Coding Planでは無効（そこでの動作は未検証）で、他のホスト上のサードパーティーや独自エンドポイントでも無効です（web_searchのドキュメント）。代替手段としてMCP検索サーバーがあります。
• Kunavo経由ではチャットのみ利用できます。Kunavoは埋め込み、音声合成、音声認識モデルを提供していません。Qwen CodeのLive VoiceはそもそもDashScopeエンドポイントを要求し、チャットモデルの接続先に関係なく独自のキーを使用します。

Kunavoを試す際の支払い

Kunavoはサブスクリプションなしのプリペイド残高で動作し、トークン単位で課金します。最低チャージ額は$10です。Stripeのチェックアウトではカード（Visa、Mastercard、American Express）、Apple Pay、Google Pay、Linkを利用でき、オーストリアではEPSも利用できます。SEPA口座振替は現在提供されていません。Pay by Bankは英国、アイルランド、フィンランドの購入者にのみStripeが提供しています。ドイツでは現在、限定プレビューとしてのみ利用できます（Stripeドキュメント、2026年10月3日現在）。詳細は請求・支払いをご覧ください。アカウントを作成するとキーを作れます。最初のタスク後、使用状況ログに実際の金額が表示されます。

よくある質問

2026年10月1日に確認：Qwen CodeのREADME、認証、Model Providers、コマンド、web_searchに関するドキュメント（mainブランチ）、ドイツ語UIテキスト（packages/cli/src/i18n/locales/de.js）、npm上の@qwen-code/qwen-code 0.24.7、Alibaba CloudのCoding PlanおよびToken Planのページ。KunavoはQwen Codeを自社のエンドポイントに対して実行していません。