認証

Qwen Code の初回実行時 /auth メニューには、3つのトップレベルオプションがあります。CLI の実行方法に合わせて選択してください。

• Alibaba ModelStudio: 公式推奨のセットアップです。サブメニューから Coding Plan（個人開発者向け・週間クォータ込み）、Token Plan（チーム・企業向け・専用エンドポイントでの従量課金）、または Standard API Key（既存の ModelStudio API キーと接続）を選択できます。
• Third-party Providers: 内蔵プロバイダーを選択し、API キーで接続します（DeepSeek、MiniMax、Z.AI、Idealab、ModelScope、OpenRouter、Requesty）。
• Custom Provider: ローカルサーバー、プロキシ、未サポートのプロバイダーに手動で接続します。OpenAI、Anthropic、Gemini およびその他の互換エンドポイントをサポートします。

オプション 1: Qwen OAuth（廃止済み）

• 仕組み: 初回起動時に、Qwen Code がブラウザのログインページを開きます。認証が完了すると、認証情報がローカルにキャッシュされ、通常は再度ログインする必要はありません。
• 必要条件: qwen.ai アカウント + インターネットアクセス（少なくとも初回ログイン時）。
• 利点: API キーの管理が不要、自動的に認証情報がリフレッシュされる。
• 費用とクォータ: 無料ティアは 2026-04-15 をもって廃止されました。

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

qwen

Qwen OAuth は /auth ダイアログで選択可能なエントリとしては提供されなくなりました。/auth を実行し、現在のオプション（Alibaba ModelStudio、Third-party Providers、または Custom Provider）のいずれかを選択してください。

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

多様なモデルオプションとより高い利用クォータを予測可能なコストで利用したい場合に使用します。

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

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

インタラクティブセットアップ

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

認証後、/model コマンドを使用して、Alibaba Cloud Coding Plan でサポートされているすべてのモデル（qwen3.5-plus、qwen3.6-plus、qwen3.7-plus、qwen3-coder-plus、qwen3-coder-next、qwen3-max-2026-01-23、glm-5、glm-4.7、kimi-k2.5、MiniMax-M2.5 を含む）を切り替えることができます。

ヘッドレスまたはスクリプトでのセットアップ

CI、コンテナ、スクリプトの場合は、削除された qwen auth coding-plan コマンドの代わりに、環境変数または settings.json で Coding Plan を設定します。

export BAILIAN_CODING_PLAN_API_KEY="sk-sp-xxxxxxxxx"
export OPENAI_BASE_URL="https://coding.dashscope.aliyuncs.com/v1"
export OPENAI_MODEL="qwen3-coder-plus"

中国（北京）エンドポイントには https://coding.dashscope.aliyuncs.com/v1 を、国際エンドポイントには https://coding-intl.dashscope.aliyuncs.com/v1 を使用してください。

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

インタラクティブな /auth フローをスキップしたい場合は、~/.qwen/settings.json に以下を追加します:

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "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、Requesty、ModelScope、またはセルフホストエンドポイントなどのサードパーティプロバイダーに接続したい場合に使用します。複数のプロトコルとプロバイダーをサポートします。

推奨: settings.json による一元ファイル設定

API Key 認証を始める最も簡単な方法は、すべてを単一の ~/.qwen/settings.json ファイルにまとめることです。以下に、すぐに使える完全な例を示します:

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "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 セットアップは必要ありません。

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

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

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

各プロトコルで利用可能なモデルを定義します。各モデルエントリには最低限 id が必要です。envKey（API キーを保持する環境変数名）はオプションですが推奨されます。省略すると、認証タイプのデフォルト環境変数キー（例: openai の場合は OPENAI_API_KEY）にフォールバックします。

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

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

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

完全な modelProviders スキーマと generationConfig、customHeaders、extra_body などの高度なオプションについては、モデルプロバイダーリファレンス を参照してください。

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

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

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

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

# Alibaba Dashscope
export DASHSCOPE_API_KEY="sk-..."
 
# OpenAI / OpenAI 互換
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 フィールド（最下位優先度）

~/.qwen/settings.json の env キーの下に直接 API キーを定義することもできます。これらは最下位優先度のフォールバックとして読み込まれ、システム環境または .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）ごとにグループ化されて表示されます。選択内容はセッション間で保持されます。

コマンドライン引数を使用してモデルを直接切り替えることもできます。これは複数のターミナルで作業する場合に便利です。

# 1つのターミナルで
qwen --model "qwen3-coder-plus"
 
# 別のターミナルで
qwen --model "qwen3.5-plus"

削除された qwen auth CLI コマンド

スタンドアロンの qwen auth CLI コマンドは削除されました。代わりに以下の方法を使用してください:

qwen auth status などのレガシー呼び出しは、移行パスを示す削除通知を表示するようになりました。

セキュリティノート

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