認証

Qwen Code は 3 つの認証方法をサポートしています。CLI の実行方法に合わせて選択してください：

• Qwen OAuth: ブラウザで qwen.ai アカウントにサインインします。無料（日次クォータあり）。
• Alibaba Cloud Coding Plan: Alibaba Cloud の API キーを使用します。有料サブスクリプションで、多様なモデルオプションと高いクォータを提供します。
• API Key: 独自の API キーを持ち込みます。ニーズに合わせて柔軟に設定可能 — OpenAI、Anthropic、Gemini、およびその他の互換エンドポイントをサポートします。

オプション 1: Qwen OAuth（無料）

最も簡単なセットアップを希望し、Qwen モデルを使用する場合に選択してください。

• 動作原理: 初回起動時に Qwen Code がブラウザのログインページを開きます。認証完了後、認証情報はローカルにキャッシュされるため、通常は再度ログインする必要はありません。
• 要件: qwen.ai アカウント + インターネット接続（初回ログイン時に必要）。
• メリット: API キーの管理が不要で、認証情報が自動的に更新されます。
• コストとクォータ: 無料。クォータは 60 リクエスト/分 および 1,000 リクエスト/日。

CLI を起動し、ブラウザのフローに従ってください：

qwen

または、セッションを開始せずに直接認証することもできます：

qwen auth qwen-oauth

💳 オプション 2: Alibaba Cloud Coding Plan

コストを予測可能にし、多様なモデルオプションと高い利用クォータを希望する場合に選択してください。

• 動作原理: 固定月額料金で Coding Plan にサブスクライブし、Qwen Code が専用エンドポイントとサブスクリプションの API キーを使用するように設定します。
• 要件: アカウントのリージョンに応じて、Alibaba Cloud ModelStudio（北京）  または Alibaba Cloud ModelStudio（国際）  から有効な Coding Plan サブスクリプションを取得します。
• メリット: 多様なモデルオプション、高い利用クォータ、予測可能な月額コスト、幅広いモデル（Qwen、GLM、Kimi、Minimax など）へのアクセス。
• コストとクォータ: Aliyun ModelStudio Coding Plan のドキュメントを参照してください：北京 、国際 。

Alibaba Cloud Coding Plan は 2 つのリージョンで利用可能です：

対話型セットアップ

Coding Plan 認証は以下の 2 つの方法で設定できます：

オプション A: ターミナルから（初回セットアップに推奨）

# Interactive — prompts for region and API key
qwen auth coding-plan
 
# Or non-interactive — pass region and key directly
qwen auth coding-plan --region china --key sk-sp-xxxxxxxxx

オプション B: Qwen Code セッション内

ターミナルで qwen を実行して Qwen Code を起動し、/auth コマンドを実行して Alibaba Cloud Coding Plan を選択します。リージョンを選択し、sk-sp-xxxxxxxxx キーを入力します。

認証完了後、/model コマンドを使用して、Alibaba Cloud Coding Plan がサポートするすべてのモデル（qwen3.5-plus、qwen3-coder-plus、qwen3-coder-next、qwen3-max、glm-4.7、kimi-k2.5 など）を切り替えることができます。

代替方法: settings.json による設定

対話型の /auth フローをスキップしたい場合は、~/.qwen/settings.json に以下を追加してください：

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus (Coding Plan)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "qwen3-coder-plus from Alibaba Cloud Coding Plan",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      }
    ]
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

🚀 オプション 3: API Key（柔軟）

OpenAI、Anthropic、Google、Azure OpenAI、OpenRouter、ModelScope、またはセルフホスト型エンドポイントなどのサードパーティプロバイダーに接続する場合に選択してください。複数のプロトコルとプロバイダーをサポートします。

推奨: settings.json による単一ファイルセットアップ

API Key 認証を始める最も簡単な方法は、すべての設定を単一の ~/.qwen/settings.json ファイルに記述することです。以下は、すぐに使用できる完全な例です：

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "description": "Qwen3-Coder via Dashscope",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-xxxxxxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

各フィールドの役割：

ファイルを保存したら、qwen を実行するだけです。対話型の /auth セットアップは不要です。

重要な概念は Model Providers（modelProviders）です。Qwen Code は OpenAI だけでなく複数の API プロトコルをサポートしています。~/.qwen/settings.json を編集して利用可能なプロバイダーとモデルを設定し、実行時に /model コマンドで切り替えます。

サポートされているプロトコル

ステップ 1: ~/.qwen/settings.json でモデルとプロバイダーを設定する

各プロトコルで利用可能なモデルを定義します。各モデルエントリには、最低限 id と envKey（API キーを格納する環境変数名）が必要です。

~/.qwen/settings.json を編集します（存在しない場合は作成してください）。単一ファイル内で複数のプロトコルを混在させることができます。以下は modelProviders セクションのみを示すマルチプロバイダーの例です：

{
  "modelProviders": {
    "openai": [
      {
        "id": "gpt-4o",
        "name": "GPT-4o",
        "envKey": "OPENAI_API_KEY",
        "baseUrl": "https://api.openai.com/v1"
      }
    ],
    "anthropic": [
      {
        "id": "claude-sonnet-4-20250514",
        "name": "Claude Sonnet 4",
        "envKey": "ANTHROPIC_API_KEY"
      }
    ],
    "gemini": [
      {
        "id": "gemini-2.5-pro",
        "name": "Gemini 2.5 Pro",
        "envKey": "GEMINI_API_KEY"
      }
    ]
  }
}

ModelConfig フィールド（modelProviders 内の各エントリ）：

完全な modelProviders スキーマや generationConfig、customHeaders、extra_body などの高度なオプションについては、Model Providers リファレンスを参照してください。

ステップ 2: 環境変数を設定する

Qwen Code は環境変数（モデル設定の envKey で指定）から API キーを読み取ります。提供方法は複数あり、以下に優先度が高い順に示します：

1. シェル環境 / export（最優先）

シェルのプロファイル（~/.zshrc、~/.bashrc など）に直接設定するか、起動前にインラインで指定します：

 
# Alibaba Dashscope
export DASHSCOPE_API_KEY="sk-..."
 
# OpenAI / OpenAI-compatible
export OPENAI_API_KEY="sk-..."
 
# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
 
# Google GenAI
export GEMINI_API_KEY="AIza..."

2. .env ファイル

Qwen Code は最初に見つかった .env ファイルを自動で読み込みます（複数のファイル間で変数はマージされません）。process.env にまだ存在しない変数のみが読み込まれます。

検索順序（カレントディレクトリから / に向かって上位へ）：

1. .qwen/.env（推奨 — Qwen Code の変数を他のツールから分離）
2. .env

見つからない場合は、ホームディレクトリにフォールバックします：

3. ~/.qwen/.env
4. ~/.env

3. settings.json → env フィールド（最下位優先度）

API キーを ~/.qwen/settings.json の env キーに直接定義することもできます。これらは最下位優先度のフォールバックとして読み込まれ、システム環境や .env ファイルで変数が既に設定されていない場合にのみ適用されます。

{
  "env": {
    "DASHSCOPE_API_KEY": "sk-...",
    "OPENAI_API_KEY": "sk-...",
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

これは上記の単一ファイルセットアップ例で使用されているアプローチです。すべてを 1 か所にまとめて管理できるため便利ですが、settings.json が共有または同期される可能性がある点に注意してください。機密性の高いシークレットには .env ファイルを優先してください。

優先度のまとめ：

ステップ 3: /model でモデルを切り替える

Qwen Code 起動後、/model コマンドを使用して設定済みのすべてのモデルを切り替えます。モデルはプロトコルごとにグループ化されます：

/model

ピッカーには modelProviders 設定のすべてのモデルがプロトコル（例：openai、anthropic、gemini）ごとにグループ化されて表示されます。選択内容はセッションをまたいで保持されます。

コマンドライン引数で直接モデルを切り替えることもでき、複数のターミナルで作業する際に便利です。

# In one terminal
 
qwen --model "qwen3-coder-plus"
 
# In another terminal
 
qwen --model "qwen3.5-plus"

qwen auth CLI コマンド

セッション内の /auth スラッシュコマンドに加えて、Qwen Code は対話型セッションを起動せずにターミナルから直接認証を管理できるスタンドアロンの qwen auth CLI コマンドを提供します。

対話型モード

引数なしで qwen auth を実行すると、対話型メニューが表示されます：

qwen auth

You’ll see a selector with arrow-key navigation:

Select authentication method:

> Qwen OAuth - Free · Up to 1,000 requests/day · Qwen latest models
  Alibaba Cloud Coding Plan - Paid · Up to 6,000 requests/5 hrs · All Alibaba Cloud Coding Plan Models

(Use ↑ ↓ arrows to navigate, Enter to select, Ctrl+C to exit)

サブコマンド

例：

# Authenticate with Qwen OAuth directly
qwen auth qwen-oauth
 
# Set up Coding Plan interactively (prompts for region and key)
qwen auth coding-plan
 
# Set up Coding Plan non-interactively (useful for CI/scripting)
qwen auth coding-plan --region china --key sk-sp-xxxxxxxxx
 
# Check your current auth configuration
qwen auth status

セキュリティに関する注意事項

• API キーをバージョン管理システムにコミットしないでください。
• プロジェクトローカルのシークレットには .qwen/.env を優先して使用し（git 管理から除外してください）。
• 認証情報の確認のためにターミナル出力に資格情報が表示される場合は、機密情報として扱ってください。