Qwen Codeの「quota exceeded」原因と対処法
AIエージェントナビ編集部
Qwen Codeを使用していて突然「quota exceeded」という表示が出て、コード生成が止まってしまったことはありませんか。これは単なる一時的なサーバーの混雑や、個人の「使いすぎ」による制限ではありません。
2026年に入り、Qwen Codeの提供形態は大きな転換点を迎えました。これまで多くのユーザーに親しまれてきた無料枠が完全に廃止されたことに伴う仕様変更が、このエラーの正体です。本記事ではこのエラーの技術的な詳細、発生の経緯、そして当日のうちに作業を再開するための具体的な解決策を徹底解説します。
Qwen Codeのquotaとは？
表示されるメッセージ
以前ログインしたままの認証情報が残っている状態でプロンプトを送ると、処理が始まらずに次のメッセージが返ります。日本語環境でも、この部分だけは英語のまま表示されます。
Qwen OAuth free tier has been discontinued as of 2026-04-15.
To continue using Qwen Code, try one of these alternatives:
- OpenRouter: https://openrouter.ai/docs/quickstart
- Fireworks AI: https://docs.fireworks.ai/api-reference/introduction
- ModelStudio: https://help.aliyun.com/zh/model-studio/coding-plan
After setting up your API key, run /auth to configure your provider.出典：公式リポジトリの現行コード（retry.ts）（2026年8月6日時点）。この文面はプログラムに直接書き込まれており、無料枠のエラーだと判定された時点で再試行せずにその場で返されます。何度か試せば通るという種類のエラーではありません。
認証方法を選ぶ /auth の画面まわりでは、日本語環境（LANGなどの言語設定が日本語）であれば次の案内が日本語で表示されます。
Qwen OAuth 無料枠は 2026-04-15 に終了しました。Coding Plan または API Key を選択してください。出典：Qwen Code公式の認証ガイドおよび公式リポジトリの日本語表示ファイル（2026年8月6日時点）。
ログをさかのぼって原因を特定したい場合は、APIが返す生の応答を見ます。HTTPステータスコード 429、エラーコード insufficient_quota、メッセージ内の free allocated quota exceeded の3点がそろったときだけ、Qwen Codeはこれを「無料枠のエラー」と判定し、一時的な混雑による429と区別する作りになっています。
無料枠の完全終了
このエラーにおける最大の誤解は、「しばらく待てばまた無料で使えるようになる」という期待です。しかし、事実は異なります。2026年4月15日をもって、Qwen OAuthを利用した従来の無料枠（Free Tier）は完全に廃止されました。
かつては1日あたり1,000リクエストの無料枠があり、上限に達しても待てばまた使えましたが、現在は枠そのものが存在しません。そのため、どれだけ時間を置いても、設定を変更しない限りこのエラーが解消されることはありません。
エラーが発生する原因
2026年4月15日の無料枠終了
Qwen Codeの無料枠廃止は、突発的な決定ではなく段階的に進められてきました。公式リポジトリで方針変更として告知され、大きな議論を呼びました。
その経緯を遡ると、まず1日あたりのリクエスト上限が「1,000件/日」から「100件/日」へと大幅に削減されるフェーズがありました。この変更の詳細は、公式リポジトリのIssue #3203で活発に議論されており、多くの開発者がフィードバックを寄せていた事実があります。その後、予定通り2026年4月15日に完全な終了を迎えました。
Qwen Code公式の認証ガイドにも、「The Qwen OAuth free tier was discontinued on 2026-04-15.」とはっきりと記されています。
症状が分かれる理由
利用しているQwen Codeのバージョンによって、ユーザーが遭遇する症状は2パターンに分かれます。
- 古いバージョンを使用している場合：
OAuthによるログイン自体は成功したように見えますが、実際にコード生成のプロンプトを送信した瞬間に、前述の「429 insufficient_quota」エラーが返され、処理が中断されます。 - 新しいバージョンを使用している場合：
認証設定を行う/authコマンドを実行した際、選択肢の中に「Qwen OAuth」という項目自体が表示されなくなっています。これは、もはや選択不可能なレガシーな認証方式としてシステムから除外されたためです。
有料プランのエラーとの違い
有料プラン（Coding Plan等）を契約しているにもかかわらず「quota exceeded」が出る場合は、意味合いが異なります。
Qwen Codeは、短時間に送りすぎたときの一時的なスロットリング（数秒から数分で戻るもの）と、割り当てを使い切った枯渇（リセット時刻が示され、その時刻までは戻らないもの）を、内部で区別する作りになっています。有料プランで出るのは主にこの2種類で、いずれも無料枠の廃止とは原因が別です。また、安価に提供されていた「Liteプラン（Coding Plan Lite）」については、2026年3月20日に新規受付が終了し、2026年4月13日には更新受付も終了しています。もしLiteプランの更新タイミングと重なっている場合は、プランのアップグレードが必要になります。
今すぐできる対処法
接続先の再設定
最も確実な解決策は、現在利用可能な正規の接続先を設定し直すことです。ターミナルで /auth コマンドを実行し、以下の3つのカテゴリーから選択してください。
- Alibaba ModelStudio： 純正環境で、Coding Plan・Token Plan・Standard API Keyのいずれかで接続します。
- Third-party Providers： OpenRouter、DeepSeek、MiniMax、Z.AI、Idealab、ModelScope、Requestyなど、外部のAPIプロバイダーを経由してQwenモデルを利用します。
- Custom Provider： OpenAI、Anthropic、Geminiなどの互換APIキーをお持ちの場合、それらを直接指定してQwen Codeのインターフェースから利用することが可能です。
ModelStudioの無料枠
どうしてもコストを抑えて利用を続けたい場合、Alibaba Cloud Model Studioの新規ユーザー向け無料枠を活用する方法があります。
有効期間は30〜90日で、新規に有効化したアカウントは90日です。対象はシンガポールリージョンかつInternational配信のモデルに限られ、無料枠が使えるのはリアルタイム推論のみです（バッチ処理・ファインチューニング・モデルのデプロイは対象外）。無料枠はアカウントとRAMユーザーで共有される点にも注意してください（出典：Alibaba Cloud公式の新規ユーザー無料枠の説明・2026年8月6日時点）。まずはこれで使用感を確かめ、本格導入を検討するのが現実的です。
Coding Planの契約
日々の業務でQwen Codeをメインツールとして活用しているなら、Alibaba Cloudの「Coding Plan」への加入が推奨されます。
特に上位のProプラン（月額約50ドル）では、5時間ごとに6,000リクエスト、あるいは週45,000リクエストといった、プロの開発業務に耐えうる潤沢なクォータが提供されます。前述の通り、旧来のLiteプランは2026年3月20日に新規受付を、2026年4月13日に更新受付を終了しているため、現在は標準のCoding Planが主な選択肢となります（出典：Alibaba Cloud公式のCoding Plan案内・2026年8月6日時点）。
他社プロバイダ・ローカル
特定のプラットフォームに依存したくない場合は、OpenRouter等のアグリゲーター系サービスを利用するか、自社サーバー・ローカル環境でQwenモデルを動かし、/auth の「Custom Provider」から接続する方法があります。これにより、Alibaba Cloud側の仕様変更に左右されずにツールを使い続けることが可能です。
関連記事：Qwen Codeの導入と設定手順
解決しない場合
古い認証情報の削除
設定を切り替えてもエラーが解消されない場合、OS内に古いOAuthのトークン情報がキャッシュとして残っている可能性があります。このキャッシュが優先的に参照されると、新しい設定が反映されません。
以下のパスにある設定ファイルを直接削除することで、クリーンな状態で再認証が行えます。
- Windowsの場合：
C:\Users\ユーザー名\.qwen\oauth_creds.json - macOS/Linuxの場合：
~/.qwen/oauth_creds.json
特に oauth_creds.json というファイルが旧無料枠の認証情報を保持しているため、このファイルを削除してから再度 /auth を実行してください。
バージョンの更新
Qwen Codeのクライアント自体が古いと、最新の認証フローを正しく処理できないことがあります。2026年8月時点では v0.21.6 以降のバージョンが推奨されています。
お使いの環境に合わせて、npm install -g @qwen-code/qwen-code@latest（Node.js 22以降が必要）を実行して最新の状態にしてください。
継続利用の判断基準
無料枠が廃止された今、あえて有料でQwen Codeを使い続けるべきか、検討が必要です。
| 判断軸 | 判断の目安 |
|---|---|
| 月間リクエスト量 | 月間9万リクエスト近く消費するならCoding Plan Proがお得 |
| データ機密性 | セキュリティ要件が厳しいならCustom Provider経由の専用API |
| コスト妥当性 | 月額50ドルのコストが、コーディング効率化の恩恵を上回るか |
使い続けた方がよい場合
Qwen Codeは、特にCLI環境での自律的なファイル操作や、複雑なリポジトリ解析において独自の強みを持っています。すでにQwenのプロンプト特性に慣れており、Alibaba Cloudの他のサービス（OSSやACKなど）と連携させている場合は、Coding Planに移行してでも使い続ける価値があります。
他ツールへ移るべき場合
「無料で使えること」が最大の魅力だったユーザーや、より汎用的なUI、複数の主要モデルをシームレスに切り替えて使いたいユーザーは、他ツールの検討時期かもしれません。
まとめ
- 「quota exceeded」の主な原因は、2026年4月15日の無料OAuth枠の完全終了です。
- APIレベルでは status: 429 / code: insufficient_quota が返されます。
- 無料枠廃止の背景には、リクエスト数の段階的制限（1,000→100）があり、詳細は 公式Issue #3203 で確認できます。
- Liteプランも2026年3月20日に新規受付、4月13日に更新が終了しています。
- 解決には
/authコマンドで「Alibaba ModelStudio」や「Third-party Providers」へ設定を切り替える必要があります。 - Windowsユーザーは
C:\Users\ユーザー名\.qwen\oauth_creds.jsonのキャッシュ削除を試してください。
まずは今すぐ /auth コマンドを実行し、ご自身の開発スタイルと予算に最適な接続先を再設定しましょう。
