Qwen Codeの使い方：インストール、アカウント・モデル選択、API設定

Qwen CodeはAlibaba Qwenチームが公開したオープンソース（Apache-2.0）のAIコーディングエージェントです。使い方は「インストール → プロジェクトでqwenを実行 → /authで接続先を設定 → 作業を依頼」の4段階です。ただし、2026年4月15日に無料Qwen OAuth枠が終了したため、それ以前の手順どおりにログインしても、無料では動作しません。また、韓国語ユーザーがまず知っておくべき点として、Qwen Codeには韓国語UIがありません。 このページでは、現在の/authメニューを基準に、始め方、韓国語回答の設定、Claude・GPTを使うカスタム設定、よく使うコマンドを順に説明します。最新バージョンは2026年9月29日にnpmへ公開されたv0.24.7で、リリースは毎週以上の頻度で行われるため、インストール済みのバージョンはqwen --versionで確認してください。

インストール

公式READMEのコマンドです。スタンドアロンインストールスクリプトを使えば、Node.jsを自分で用意する必要はありません。npmでインストールする場合のみNode.js 22以上が必要です。

# macOS / Linux (공식 단독 설치 스크립트)
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 (Node.js 22 이상 필요)
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 /path/to/your-project
qwen

# 세션 안에서:
/language output Korean   # 모델 답변을 한국어로 (UI는 한국어 미지원)
/auth                     # 공급자와 API 키 설정

組み込みUI言語は、中国語（簡体字）、英語、ロシア語、ドイツ語、日本語、ブラジルポルトガル語、フランス語、カタルーニャ語のみで、リポジトリのUI翻訳ファイルにも韓国語はありません（2026年10月1日確認）。そのためメニューは英語で表示され、このページでは画面に表示される英語文言をそのまま引用します。モデルの回答言語はUIとは別に、/language output Koreanで韓国語に固定できます。

ターミナル以外にも、デスクトップアプリ、ブラウザーで開くWeb UI（qwen serve --open、実験機能）、VS Code・Zed・JetBrains連携、スクリプトやCI向けのヘッドレス実行（qwen -p "..."）があります。すべて同じ無料リポジトリに含まれますが、推論費用は別途発生します。

/authで接続先を選択

/auth（別名/login）を開くと「Select authentication method:」画面が表示され、最上位の選択肢は3つあります。Qwen OAuthを選択しようとすると、「Discontinued — switch to Coding Plan or API Key」という案内が表示されます。

ModelStudioの3種類は、同じ請求書の支払いをする3つの方法ではありません。ドキュメントではそれぞれに別のエンドポイントと別のキーを使用し、キーの種類とbaseUrlが一致しないと動作しません。Coding Planは2026年10月1日時点で「数量限定・先着順、毎日0時（UTC+8）に補充」と表示されているため、日によっては登録できない場合があります。Coding Planでは1つのタスクが複数回のモデル呼び出しとして計算され、Alibabaは単純なタスクで通常5～10回、複雑なタスクで10～30回以上と説明しています。料金比較については英語ページQwen Code pricingで詳しく説明しています。

ClaudeやGPTを使う：settings.jsonのCustom Provider

Qwen Codeの認証ドキュメントは、OpenAI、Anthropic、Google、OpenRouter、独自エンドポイントなどのサードパーティ接続に~/.qwen/settings.jsonのmodelProvidersを推奨しています。Kunavoの場合は次のとおりです。

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

# 키는 settings.json에 직접 쓰지 말고 .qwen/.env 나 환경 변수로
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

デバッグ時間を節約する4つのポイント：

• baseUrlは/v1まで。 モデルプロバイダーのリファレンスドキュメントには、「/v1/chat/completionsの完全なパスではなく、APIの/v1ルートを指定し、リクエストパスはSDKが追加する」と明記されています。パスまで記述すると、認証エラーではなく404になります。
• キーを置く場所。 Qwen Codeは、envKeyに記述した名前の環境変数からキーを読み取ります。優先順位は、シェルのexport、.envファイル（.qwen/.env推奨、最初に見つかった1ファイルのみ）、settings.jsonのenvの順で、最後の方法は平文保存になるため推奨しません。
• 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を1つの前払い残高で使う方法です。また、KunavoはQwen Codeを自社エンドポイントで実際に動かした検証を行っていません。設定は英語のQwen Code設定ページと同様に、公式ドキュメントを参照して作成しています。現在使用している経路を残したまま試してください。

最初のタスクとよく使うコマンド

READMEが例として挙げる最初のリクエストは、「このリポジトリを説明し、どこから見始めればよいか教えて」のようなものです。ファイルの読み取りとツール呼び出しを一度に確認できるためです。挨拶だけでは接続問題を見つけられません。

yoloのような自動承認モードについて、ドキュメント自体が「信頼できる環境、サンドボックス環境、または破棄してもよい環境でのみ使用するように」と警告しています。/stats modelの推定コストはQwen Codeによる計算であり、請求額ではありません。実際の金額は、接続したプロバイダーの使用履歴で確認してください。

知っておくべき制限

• 組み込みのweb_searchは接続先に応じて有効または無効になります。 DashScopeのサーバー側検索を使用するため、ModelStudio Standard API KeyとToken Plan、および認識されるDashScopeホストを指す項目では有効になり、Coding Planでは無効になります（そのエンドポイントでは未検証）。サードパーティや別ホストのカスタムエンドポイントでも無効です（web_searchドキュメント）。必要に応じてMCP検索サーバーを接続してください。
• Kunavo経由はチャットのみ。 Kunavoには埋め込み、音声合成、音声認識モデルがありません。Qwen CodeのLive VoiceにはDashScopeエンドポイントが必須のため、チャットモデルをどこに向けても別のキーをそのまま使用します。

Kunavoで試す際の支払い

Kunavoは月額料金のない前払いチャージ方式で、トークン単位で残高から差し引きます。最低チャージ額は$10です。Stripe checkoutではカード（Visa、Mastercard、American Express、JCB、UnionPay）、Apple Pay、Google Pay、Linkを利用できます。checkoutがウォン表示の場合、カカオペイ、ネイバーペイ、PAYCO、Samsung Pay、および海外決済に対応していない国内カードも選択できます（ウォン換算にはStripeの為替手数料2–4%がかかり、ドル決済なら回避できます）。Toss Payには対応していません。支払いガイドを確認し、アカウントを作成してキーを発行してください。最初のrequest後は、使用履歴で実際の金額を確認するのが最も確実です。

よくある質問

2026年10月1日確認：Qwen Code README、認証・モデルプロバイダー・コマンド・web_searchドキュメント（mainブランチ）、リポジトリのUI翻訳ファイル一覧、npmの@qwen-code/qwen-code 0.24.7、Alibaba CloudのCoding PlanおよびToken Planページ。KunavoはQwen Codeを自社エンドポイントで実行していません。