Qwen Code と Qwen 3.7-max:Token Plan のセットアップ
MarkdownNode.js 22 への Qwen Code のインストール、国際版 Token Plan への接続、401 エラーの原因となる 3 つの落とし穴:API アドレス、キー、シートの割り当て。
記事の全文を読む
Ailoot リファレンスドキュメント:ailoot.ai/docs/。
2026年10月3日更新:公開後、3つの点が変わりました。Alibaba は Coding Plan の新規購入を停止しました。Lite ティアは3月に再開し、Pro は売り切れです。Token Plan は週次クォータから月次クォータに切り替わりました。より新しいモデル、Qwen3.8-max もリリースされました。また、Token Plan キーの説明にあった誤りも修正しました。これはまさにその401エラーに関わるため、以下で説明します。
Qwen Code とは何ですか?単なる模倣ツールではないのはなぜですか?
重要なポイント
Qwen Code は Alibaba のオープンソースのターミナル AI エージェントで、Claude Code のように動作します。VS Code のターミナルで実行し、プロジェクトを読み込み、コードを書き、コマンドを実行します。主な違いは、Qwen 3.7、DeepSeek V4、Kimi K2 など、1つのサブスクリプションで十数種類のモデルにアクセスできることです。
Qwen Code の話を初めて聞いたとき、「2つ目のプロンプトで壊れる、また別の Claude Code クローンだ」と思いました。間違いでした。Alibaba はインターフェースをコピーしたのではなく、OpenAI API と完全互換の独自 CLI エージェントをゼロから構築していました。つまり、Qwen モデルだけでなく、DeepSeek、GLM、Kimi、さらには Anthropic API 経由で Claude も実行できます。
実際にできることは次のとおりです。
- プロジェクト構造を読み、コンテキストを理解する(
CLAUDE.mdを使う Claude Code と同様) - シェルコマンドを実行し、ファイルを編集し、コミットを作成する
- Skills と SubAgents に対応
- 組み込みターミナルまたは拡張機能を通じて VS Code で使える
- 1つの
/modelコマンドでモデルを切り替える
欠点が1つありますが、これは重大です。無料枠は2026年4月15日に終了しました。以前は Qwen OAuth で1日に100件の無料リクエストを利用できましたが、現在は有料オプションのみです。それでも、有料の Qwen Code は Claude Pro サブスクリプションよりかなり安価です。今ツールを選んでいるなら、「2026年に何でコーディングする?AIツール8選」のガイドで全選択肢を紹介しています。
料金はいくらですか?どのプランを選ぶべきですか?
重要なポイント
Alibaba には、トークンごとの従量課金、Coding Plan サブスクリプション、Token Plan サブスクリプションの3つの支払い方法があります。日常的なバイブコーディングには Token Plan が最もお得です。月額固定で10種類以上のモデルを使え、トークン数を数える必要もありません。
Qwen Code のセットアップで最も厄介なのは、プランについての混乱です。Alibaba はコンソールの場所によって異なる名称を使い、VS Code 拡張機能にも間違った選択肢が表示されます。実際の仕組みは次のとおりです(Alibaba Cloud のドキュメントと照合。ドキュメントは2026年9月28日更新)。
| プラン | 内容 | 対象 | 概算費用 |
|---|---|---|---|
| 従量課金 | 100万トークンごとに個別に支払う | たまに使う場合、試してみる場合 | 100万トークンあたり$0.30-1.20 |
| Coding Plan | 個人向けサブスクリプション、月間クォータ付き(週次クォータは2026年9月22日に廃止) | 現在、新規登録者は利用不可。Lite ティアは2026年3月20日に購入停止、Pro は売り切れ | 新規アカウントでは現在利用不可 |
| Token Plan Team Edition、Standard Seat | 1シートあたり月間25,000 Credits、10種類以上のモデル | モデルを切り替えながら毎日バイブコーディングする人 | プロモーション価格は1シート月$20(通常価格:$30) |
筆者が紹介する体験では、Token Plan を選びました。1つのサブスクリプションで Qwen 3.7-max(さらに新しい Qwen3.8-max)、DeepSeek V4 Pro、GLM-5 にアクセスできるためです。すべてのモデルが同じ Credits プールを使います。/model コマンドで切り替えればよく、プロバイダーごとに別のキーを購入する必要はありません。
重要:Coding Plan と Token Plan は、API アドレスが異なる別製品です。Coding Plan キーには sk-sp- というプレフィックスがあります。Token Plan キーにはプレフィックスがありません。公式 Qwen Code ドキュメントではそのように説明されています。製品間でアドレスやキーを取り違えると、401 エラーになります。Coding Plan は新規購入できないため、現在、ほとんどの読者が使える唯一の選択肢は Token Plan です。
Qwen Code をインストールするには?
重要なポイント
インストール方法は2つあります。npm(npm install -g @qwen-code/qwen-code@latest)または Homebrew(brew install qwen-code)です。Node.js 22 以降が必要です。インストール後、ターミナルで qwen を実行します。
インストール前に Node.js のバージョンを確認します。
node --version
22 以降が必要です。古い場合は、nodejs.org または nvm で更新します。
nvm install 22
nvm use 22
次に、1つのコマンドで Qwen Code をインストールします。
npm install -g @qwen-code/qwen-code@latest
macOS では Homebrew も使えます。
brew install qwen-code
確認します。
qwen --version
バージョンが表示されたら準備完了です。ターミナルで qwen コマンドを実行して Qwen Code を起動します。VS Code では、組み込みターミナルを開き(Ctrl+)、qwen` と入力します。
VS Code 拡張機能もあります。マーケットプレイスにある QwenLM の Qwen Code Companion です。GitHub Copilot のようなチャットサイドバーが追加されます。私はこれを使っています。通常のターミナルより便利です。
アカウントを作成して Token Plan を購入するには?
重要なポイント
Alibaba Cloud の国際コンソール(modelstudio.console.alibabacloud.com)で登録し、プロバイダーが受け付けるカードを追加して、Token Plan に申し込みます。全行程にかかる時間は10分です。
手順は次のとおりです。
- modelstudio.console.alibabacloud.com にアクセスします
- 右上の Free Sign Up をクリックします
- メールアドレスを入力し(Gmail も使えます)、受信トレイに届くコードを確認します
- 電話番号を追加します
- プロバイダーが受け付けるカードを追加します。Alibaba は確認のために$1を請求し、1~3日で返金します。
- コンソールで ModelStudio セクションの Token Plan タブを見つけます
- 開始時は最小の Standard ティアを選びます
- 支払いを確定します
購入後、My Subscriptions ページが表示されます。そこには次の項目があります。
- Standard Seat: 0/1 — シートを購入したものの、自分にはまだ割り当てられていないことを意味します
- Assign をクリックし、自分のアカウントを選択して確定します
- 1/1 に変わるはずです
これを行わないと API キーは動作しません。筆者の体験では、この手順に20分かかりました。
API キーと正しいアドレスはどこで取得できますか?
重要なポイント
API キーと API アドレス(Base URL)は Management Platform ページにあります。国際版 Token Plan のアドレスは https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 です。通常の DashScope アドレスと混同しないでください。Token Plan キーはそこで使えません。
My Subscriptions ページで、大きな紫色の Go to Management Platform ボタンをクリックします。別のパネルが開きます。
左側のメニューで Overview を選びます。このページには2つのセクションがあります。
Plan-specific API Key — 個人用キーです。アスタリスクでマスクされています。横にあるコピーアイコンをクリックします(マウスで選択しないでください。アスタリスクがコピーされます)。Token Plan キーにはプレフィックスがありません。これは説明の誤りではありません。公式 Qwen Code ドキュメントでもそのように説明されています。sk-sp- が表示されている場合は、別製品のCoding Planキーをコピーしています。
Plan-specific Base URL — 次の2つの選択肢があります。
- OpenAI 互換ツール(Qwen Code)用:
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - Anthropic 互換ツール用:
https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
Token Plan キーで使えるのはこれらのアドレスだけです。標準の dashscope-intl.aliyuncs.com アドレスは通常のキー(従量課金)用で、coding-intl.dashscope.aliyuncs.com は Coding Plan のアドレスです。Token Plan キーをどちらかと組み合わせると、401 が返されます。
VS Code に接続するには?
重要なポイント
~/.qwen/settings.json ファイルで VS Code 拡張機能を設定します。キー、正しい API アドレス、モデルを入力する必要があります。すぐ使える設定を以下に示します。コピーして、自分のキーに置き換えてください。
マーケットプレイスから Qwen Code Companion 拡張機能をインストールした場合:
- コマンドパレットを開きます(Cmd+Shift+P)
- Qwen Code: Choose Provider と入力します
- 選択肢のメニューが表示されたら、Coding Plan は選ばないでください(別製品です)。Standard API Key を選びます
- Management Platform のキーを貼り付けます。Token Plan キーには固定のプレフィックスがありません
- Region:Singapore
- Model:
qwen3.7-max
この後にエラーが出た場合は、ファイルから手動で設定します。拡張機能が間違ったアドレスを設定することがあります。
~/.qwen/settings.json ファイルを開くか、新しく作成して、以下を貼り付けます。
{
"env": {
"TOKEN_PLAN_API_KEY": "YOUR-KEY-FROM-MANAGEMENT-PLATFORM"
},
"modelProviders": {
"openai": [
{
"id": "qwen3.7-max",
"name": "qwen3.7-max",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": { "enable_thinking": true },
"contextWindowSize": 262144
}
},
{
"id": "qwen3.6-plus",
"name": "qwen3.6-plus",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": { "enable_thinking": true },
"contextWindowSize": 1000000
}
},
{
"id": "deepseek-v4-pro",
"name": "deepseek-v4-pro",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": { "enable_thinking": true },
"contextWindowSize": 1000000
}
}
]
},
"security": {
"auth": { "selectedType": "openai" }
},
"model": { "name": "qwen3.7-max" }
}
YOUR-KEY-FROM-MANAGEMENT-PLATFORM を Management Platform で取得したキーに置き換えます。VS Code を再起動します。これで完了です。
401 エラーが表示されるのはなぜですか?どう修正しますか?
重要なポイント
Qwen Code の設定時に401エラーが出るケースの90%は、API アドレスまたはキーの誤りが原因です。Token Plan、Coding Plan、従量課金ではアドレスが異なり、キーを相互に使うことはできません。
筆者はセットアップ中に遭遇したエラーについて説明しています。401 エラーの原因と確認方法をすべて挙げます。
| 症状 | 原因 | 解決方法 |
|---|---|---|
invalid_api_key | Token Plan キーを DashScope アドレスに送信している(またはその逆) | Base URL を確認します。Token Plan は token-plan.ap-southeast-1...、Coding Plan は coding-intl.dashscope... です |
invalid access token | Standard Seat が割り当てられていない(0/1) | My Subscriptions を開き、Assign をクリックします。1/1 と表示されるはずです |
invalid_api_key | VS Code 拡張機能が Token Plan を使わず、認証フローで独自キーを生成した | ~/.qwen/settings.json を開き、キーが Management Platform の表示と一致するか確認します(sk-sp- プレフィックスの Coding Plan キーと混同しないでください) |
invalid_api_key | キーと一緒にスペースや改行がコピーされた | キーを削除し、コピーアイコンを使ってコピーし直します(マウスで選択しないでください) |
model not found | モデルがプランに含まれていない | サブスクリプションページで Available Models の一覧を確認します |
Insufficient quota | Credits を使い切った | My Subscriptions の Usage を確認します。100%なら、リセットを待つか Boost Pack を購入します |
ターミナルからキーをすばやく確認する方法:
curl -s -o /dev/null -w "%{http_code}" -X POST \
"https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen3.7-max","messages":[{"role":"user","content":"hi"}],"max_tokens":5}'
200 が返ればキーは動作しており、問題は拡張機能の設定にあります。401 が返る場合、キーまたはアドレスが間違っています。
どのモデルが使えますか?どれを選ぶべきですか?
重要なポイント
Token Plan では5つのプロバイダーの10種類以上のモデルが利用できます。新しいフラッグシップ Qwen3.8-max は2026年8月に追加されました。バイブコーディングの主力には、価格と品質のバランスが取れた qwen3.6-plus を使いましょう。複雑なタスクには qwen3.7-max または、より新しい qwen3.8-max を使います。簡単な編集には qwen3.6-flash を使います。
バイブコーディングで実用性の高いモデルを紹介します。
| モデル | 用途 | Credits の使用量 |
|---|---|---|
| qwen3.8-max | Alibaba の新しいフラッグシップ(2026年8月リリース)。複雑なタスクで最高品質 | 高 — 3.7-max より速く Credits を使い切ります |
| qwen3.7-max | 複雑なアーキテクチャ、大規模プロジェクトのリファクタリング、ゼロからの生成 | 高 — 毎日コーディングすると1週間でクォータを使い切ります |
| qwen3.6-plus | 日常の主力:編集、改善、レビュー、説明 | 中 — 1日2~4時間なら1か月分に十分です |
| qwen3.6-flash | 簡単な編集、単純な質問、書式設定 | 低 |
| deepseek-v4-pro | Qwen の代替。アルゴリズム関連のタスクや数学でより優れている場合があります | 中 |
| kimi-k2.6 | 長いコンテキスト:大規模なコードベースの読み込み、ドキュメントの分析 | 中 |
Qwen Code のセッション内で /model コマンドを実行すれば、モデルを切り替えられます。設定の変更や再起動は必要ありません。
まずは qwen3.6-plus から始めるのがおすすめです。1週間後にクォータの減りが速すぎると感じたら、日常的な作業では qwen3.6-flash に切り替え、qwen3.7-max は複雑なタスクだけに使います。
Qwen Code と Claude Code、どちらを使うべきですか?
重要なポイント
Claude Code はより良いコードを生成し、コンテキストの理解にも優れています。Qwen Code はより安価で、1つのサブスクリプションを通じて複数のモデルを利用できます。理想的な組み合わせは、主要な作業に Claude Code、並行タスクや実験に Qwen Code を使うことです。
このレビューでは、筆者が両方のツールを1か月使った体験を紹介しています。その体験に基づく比較は次のとおりです。
| 比較項目 | Claude Code | Qwen Code |
|---|---|---|
| コード品質 | より優れています。Anthropic はその後、新しいモデル(Opus 5.5、2026年9月22日)をリリースしました。差は縮まっていません | 良好ですが、新しいフラッグシップ Qwen3.8-max も独立したテストでは Anthropic の最上位モデルに及びません |
| プロジェクトの理解 | CLAUDE.md とツリーの詳細な読み込みで、人間のように動作します | 仕組みは似ていますが、洗練度は劣ります |
| 価格 | Claude Pro は月$20(大量のコーディング向け Max は月$100-200) | Token Plan Standard は月$20から、10種類以上のモデルを含む |
| モデルの選択 | Claude のみ(Opus/Sonnet/Haiku) | Qwen + DeepSeek + GLM + Kimi + MiniMax |
| オープンソース | いいえ(クローズドソース) | はい(MIT ライセンス) |
| VS Code 拡張機能 | ネイティブで安定 | 利用可能ですが、まだ荒削りで、キーの問題が起きることもあります |
Qwen Code のほうがお得な場合:
- 複数モデル(数学には DeepSeek、長いコンテキストには Kimi)へのアクセスが必要
- 1つのタスクに複数のアプローチを試したい
- 予算が限られているが、毎日コーディングする
- カスタマイズ可能なオープンソースツールがほしい
Claude Code が欠かせない場合:
- コードの品質が収益に直結する重要なプロジェクト
- 大規模なレガシープロジェクトで作業する(Opus はコンテキストをより適切に維持します)。Claude Code の制限を使い切らない方法でも別途解説しています
- 手動設定不要で安定した VS Code 拡張機能が必要
筆者が紹介する体験での組み合わせは、メインプロジェクトに Claude Code、実験や並行タスクに Qwen Code です。安価なモデルでアイデアをすばやく試せます。他のツールとの詳細な比較は、Cursor と Claude Code、Codex と Claude Codeをご覧ください。
誰もが遭遇する3つの落とし穴
重要なポイント
Token Plan と Coding Plan は、アドレスが異なる別製品です。VS Code 拡張機能は間違ったキーを入力します。シートは手動で割り当てる必要があります。この3つの落とし穴で30分から数時間を失うことになります。私は3つすべてを経験し、解決方法を記録しました。
落とし穴1:Token Plan ≠ Coding Plan
Alibaba はコンソール内の場所によって、これらの製品を異なる名称で呼んでいます。VS Code 拡張機能の「Coding Plan」オプションはToken Plan ではありません。2026年3月20日時点で、Coding Plan Lite は新規購入を停止し、Pro は売り切れています。すでに契約していない場合、選べるのは Token Plan だけです。API アドレスも異なります。
- Token Plan:
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - Coding Plan:
https://coding-intl.dashscope.aliyuncs.com/v1
Token Plan を購入したのに、拡張機能を Coding Plan として設定すると401エラーが出ます。その逆も同様です。
落とし穴2:VS Code 拡張機能が独自のキーを生成する
拡張機能の GUI でセットアップするとき(Cmd+Shift+P - Qwen Code: Choose Provider)、拡張機能が Alibaba Auth API を通じて独自のキーを生成することがあります。このキーは形式が異なり、Token Plan サブスクリプションには紐付いていません。
解決方法:GUI で設定した後、~/.qwen/settings.json を開き、env のキーがManagement Platform の表示(Overview - Plan-specific API Key)と一致することを確認します。一致しない場合は、手動で置き換えます。
落とし穴3:Standard Seat が割り当てられていない
Token Plan の購入後、My Subscriptions ページに Standard Seat: 0/1 と表示されます。これはシートを購入したものの、アカウントに紐付けられていないことを意味します。Assign をクリックするまで API キーは動作しません。
筆者の体験では、401エラーの原因を調べていて、この行に気づくまで20分かかりました。
すべて正常に動作することを確認するには?
重要なポイント
手順は2つです。最初にターミナルで curl を使ってキーを確認します(200 が返るはずです)。次に Qwen Code で任意のプロンプトを入力します。curl が動作して拡張機能が動作しない場合、問題は ~/.qwen/settings.json ファイルの設定にあります。
手順1:ターミナルでキーを確認する
curl -X POST \
"https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen3.6-plus","messages":[{"role":"user","content":"Hello"}]}'
応答にモデルの文章が含まれていれば、キーとアドレスは正しく動作しています。
手順2:Qwen Code で確認する
VS Code を開き、組み込みターミナルを選び、qwen と入力します。起動したら、次のように入力します。
このフォルダーのプロジェクトは何ですか?
Qwen Code は構造を読み取り、返答します。返答があればセットアップ完了です。
手順3:Credits の使用量を確認する
最初のリクエストから5分後に、Management Platform - Overview - Usage Consumption に移動します。使用率はゼロ以外になっているはずです。10件以上のリクエスト後も0%なら、間違ったアドレスを使っています(リクエストがサブスクリプション外へ送信され、従量課金に回っているか、どこにも届いていません)。
次にすることは?
重要なポイント
Qwen Code のセットアップが完了し、バイブコーディングを始められます。ただし、ツール自体は始まりにすぎません。「CLI をインストールした」状態と「AI で製品を作っている」状態の違いは、コンテキストを扱う方法にあります。
Qwen Code をインストールし、動作することを確認しました。どのプロジェクトでも開き、AI との対話を通じて構築を始められます。
次の疑問は、なぜ同じプロンプトでも Qwen Code が、あるプロジェクトでは素晴らしい結果を出し、別のプロジェクトではでたらめを出すのか、ということです。鍵はコンテキストにあります。プロジェクトに対象者、製品、目標を含む business/ 構造があれば、AI はパートナーのように動きます。フォルダーが空なら、AI は幻覚を起こします。
出典
- GitHub の Qwen Code — ソースコードとドキュメント。2026年10月3日に確認
- Alibaba Cloud ModelStudio — サブスクリプションとキーを管理するコンソール
- Token Plan の概要 — 現行プランと Coding Plan の状況。Alibaba が2026年9月28日に更新、2026年10月3日に確認
- Qwen Code ドキュメント:認証 — Token Plan と Coding Plan のキー形式。2026年10月3日に確認
Ailoot のガイドを読み進めるには、ailoot.ai をご覧ください。
詳細を見る
Qwen Code と Qwen 3.7-max:Token Plan のセットアップ:よくある質問
Token Planのキーで401が出たら、最初に何を確認しますか?
キーとBase URLがCoding Planや通常のDashScopeではなくToken Planのものか確認します。コンソールのコピーボタンでキーを取得し、購入したStandard Seatが割り当て済みかも確認してください。その後、拡張機能に保存した設定と同じ構成か比較します。
ターミナルのリクエストが成功すれば、VS Code拡張も設定済みですか?
いいえ。そのリクエストで使ったキー、エンドポイント、モデルが動作したことだけを確認できます。Qwen Codeでも別にプロンプトを試し、保存済みBase URLとキーを成功したリクエストと比較してください。意図したサブスクリプションの利用量も確認します。