認証

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(Beijing)  または Alibaba Cloud ModelStudio(intl)  から有効な Coding Plan サブスクリプションを取得します。
• メリット: 多様なモデルオプション、高い利用クォータ、予測可能な月額コスト、幅広いモデル（Qwen、GLM、Kimi、Minimax など）へのアクセス。
• コストとクォータ: Aliyun ModelStudio Coding Plan のドキュメントBeijing intl を参照してください。

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 キー（柔軟）

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

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

API キー認証を開始する最も簡単な方法は、すべてを単一の ~/.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 設定は必要ありません。

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

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

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

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

~/.qwen/settings.json を編集します（存在しない場合は作成します）。1 つのファイルで複数のプロトコルを混在させることができます。以下は 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 などの高度なオプションについては、Model Providers Reference を参照してください。

ステップ 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 ファイルセットアップ例 で使用されているアプローチです。すべてを 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 コマンド

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

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

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

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