# Qwen CodeのAPIキー：発行場所、接続方法、使用量の計算

> Qwen Code の API キーとは何か、サブスクリプションとの違い、発行場所、settings.json の設定方法、トークン使用量を決める要因について説明します。

Source: https://ailoot.ai/blog/ja/qwen-code-api-key/
Canonical: https://ailoot.ai/blog/ja/qwen-code-api-key/
Language: ja
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-141
Revision: sha256-956684025ec5ca3077dabaae4e2a5720f0885b3b8ad396d7612fc300cb89206b


Qwen Codeをインストールし、ターミナルで起動すると、最初のリクエストでキーを求められます。そこで検索が始まり、「qwen code用のapiキーを買う」と入力した人は、サブスクリプションか、誰かが用意したアクセス権を販売するページにたどり着きます。キーとは何か、どこで入手できるのか、費用はいくらかを順を追って説明します。

先に要点を述べます。APIキーは、単独の箱入り商品として販売されているものではありません。モデルプロバイダーのアカウントで自分で発行するアクセス用の文字列で、発行は無料です。お金が必要になるのは、後で残高をチャージするときです。その段階ではプロバイダーの条件が適用されます。以下では、キーの入手場所、Qwen Codeへの接続方法、利用料金について説明します。

<div class="aside" data-semantic="callout" role="note" aria-label="注意">

注意

この記事は情報提供を目的としており、公開されている規則を説明します。制限を迂回して支払いを「代行」すると申し出る仲介サービスの名称や、制限を迂回する方法は説明しません。価格は2026年9月初旬時点のプロバイダーのページから取得したものです。価格は変わるため、最新の価格はプロバイダーのサイトで確認してください。

</div>

<div class="aside" data-semantic="editorial-reference" role="note" aria-label="Ailootドキュメント">

[Ailootドキュメント](https://ailoot.ai/docs/) — サービスの利用に関する参考資料。

</div>

## Qwen CodeのAPIキーとは何ですか？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要なポイント">

重要なポイント

Qwen CodeのAPIキーは、サービスプロバイダーがモデルへのリクエストを識別し、その使用量を計算するための、個人用のパスワードのような文字列です。Qwen Code自体は無料のオープンソースエージェントで、独自のモデルは内蔵していません。外部プロバイダーから応答を受け取り、そこであなたのキーを提示します。つまり、「キーを取得する」とは、プロバイダーに登録し、そのアカウントでアクセス用の文字列を発行することです。秘密の値は起動時の環境変数で渡し、Qwen Codeの設定ではその変数名を参照します。設定の保存だけでなく、実際のモデルリクエストの成功がアクセスを確認するもので、利用料金が発生する場合があります。

</div>

Qwen Codeはターミナルで動作し、タスクのコードを書くオープンソースのAIエージェントです。無料で、npmを通じてインストールでき、内部に独自のニューラルネットワークはありません。知的な処理はすべてモデルが行い、そのモデルはプロバイダーのサーバー上で動作します。

Qwen Codeがモデルにアクセスするには、通行証が必要です。それがAPIキーです。プロバイダーが個人ごとに発行する、パスワードのような長い文字列です。エージェントがリクエストを送信するときにキーを添付し、プロバイダーは誰からのリクエストかを識別して応答し、使用量をあなたの残高から差し引きます。

ここで、混乱の半分を解消する単純なポイントがあります。キーはマーケットプレイスの商品として購入するのではありません。プロバイダーのアカウントを作成して「キーを作成」をクリックすれば、文字列を無料で取得できます。「apiキーを買う」という検索が実際に意味しているのは、「どこでアカウントを作成し、その後どうやって使用料を払えばよいか」です。この2つの疑問に以下で答えます。

## APIキーはサブスクリプションや以前の無料ログインとどう違いますか？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要なポイント">

重要なポイント

Qwen Codeには複数の認証・課金経路があります。旧無料Qwen OAuthは2026年4月15日に終了しました。Alibaba Coding Planは専用エンドポイントを使うサブスクリプションで、標準のModel Studio APIキーは従量課金です。現在のクライアントには、ほかのプラットフォームやプランの選択肢もあります。このガイドは標準Model Studio APIキーの経路を扱います。リージョン、エンドポイント、モデル、課金プランを同じ接続にそろえてください。

</div>

Qwen Codeのセッション内で`/auth`を実行すると、インストールしたバージョンが対応する認証方法が表示されます。キーを発行したプラットフォームと課金プランに合う項目を選んでください。以下では、旧無料ログイン、Coding Plan、この記事で使う標準APIキーを区別します。現在のメニューをすべて列挙したものではありません。

最初の選択肢は、Qwenアカウントによる無料ログイン（Qwen OAuth）です。以前はキーなしでモデルを利用できましたが、この方法は終了しました。

<figure>
<blockquote>
<p>無料のQwen OAuthプランは2026年4月15日をもって終了しました。以前に保存したトークンはしばらく機能する可能性がありますが、新しいリクエストは拒否されます。</p>
</blockquote>
<figcaption>— Qwen Code ドキュメント、認証、公式ドキュメント</figcaption>
</figure>

2つ目はAlibaba ModelStudioのCoding Planサブスクリプションです。月額固定料金で、週間リクエストクォータと専用の接続アドレスが提供されます。

3つ目はモデルプロバイダーのAPIキーです。固定料金はなく、残高に入金し、作業に応じてトークン単位で使用します。この方法は柔軟で、エージェントを不定期に使う場合に適しています。この記事の残りでは、この方法を取り上げます。

## Qwen CodeのAPIキーはどこで発行できますか？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要なポイント">

重要なポイント

Qwen Codeは複数のプロバイダーとプロトコルに接続できます。Alibaba Model Studioへ直接接続する場合は、キーを作る前にコンソールでリージョンを選びます。キー、APIのBase URL、ワークスペース、利用可能なモデルは、そのリージョンに一致している必要があります。国際版のコンソールURLや英語の画面だけでは、APIのリージョンは決まりません。

</div>

Qwen Codeはさまざまなプロトコルに対応しているため、キーを発行するプロバイダーは1つに限られません。公式ドキュメントには、接続可能なサービスが明記されています。

<figure>
<blockquote>
<p>OpenAI、Anthropic、Gemini、Qwenの各プロトコルに対応。任意のサードパーティプロバイダーやローカルモデルを利用できます。その場で切り替え可能です。</p>
</blockquote>
<figcaption>— Qwen Code ドキュメント、認証、公式ドキュメント</figcaption>
</figure>

以下は、直接接続する方法です。

直接接続する場合は、[Alibaba Model Studioコンソール](https://modelstudio.console.alibabacloud.com/)で目的のリージョンを選び、APIキー管理ページからキーを作成します。設定にはリージョンとワークスペース名を残し、共有メモにキー自体を貼り付けないでください。

| キーを作成するリージョン | 標準OpenAI互換Base URL | 確認すること |
|----|----|----|
| 中国（北京） | `DASHSCOPE_BASE_URL` | 北京のキーと、そのリージョンで使えるモデル |
| シンガポール | `DASHSCOPE_BASE_URL` | シンガポールのキーと、そのリージョンで使えるモデル |
| 米国（バージニア）、GlobalまたはUSのデプロイ範囲を含む | 選択した米国ワークスペースからAPI Hostをコピーし、公式に説明されたOpenAI互換Base URLを使う | 米国ワークスペースのキー、デプロイ範囲、モデル一覧。北京やシンガポールのURLを使い回さない |

[リージョンガイド](https://www.alibabacloud.com/help/en/model-studio/regions)は、本番ではワークスペース専用ドメインを推奨しています。Workspace Managementから実在するAPI Hostをコピーし、[Base URLガイド](https://www.alibabacloud.com/help/en/model-studio/base-url)に従ってください。ワークスペースIDを作り上げてはいけません。従来の共有DashScopeエンドポイントとワークスペース専用エンドポイントは、別の接続方法です。Coding PlanとToken Planにも独自のエンドポイントとキーがあります。選択したリージョンのワークスペース管理画面から、完全なOpenAI互換Base URLを `DASHSCOPE_BASE_URL` にコピーします。JSONでは `baseUrl` を省略し、起動前に `OPENAI_BASE_URL` で指定します。ワークスペースIDの仮の文字列ではなく、管理画面の実際の値を使ってください。

キーを必要としない無料の方法もあります。Ollamaを通じてQwenモデルを自分のコンピューター上で実行し、自分のサーバーとしてQwen Codeに接続します。高性能なマシンと個別のセットアップが必要です。エージェントをローカルで動かす方法は、[ターミナルでQwen Codeを起動する](https://ailoot.ai/blog/ja/qwen-code-terminal-auto-edit/)の手順で紹介しています。



## Qwen Codeにキーを追加して動作させるには？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要なポイント">

重要なポイント

`~/.qwen/settings.json`には、プロトコル、リージョンに合うBase URL、モデルIDと、キーを供給する環境変数の名前である`envKey`を設定します。秘密の値をJSONに入れないでください。環境変数を設定した同じターミナルからQwen Codeを起動し、接続先を確認して短いプロンプトを1つ送ってから、使える状態か判断します。`/model`は設定済みの候補を表示しますが、それだけではプロバイダーへのアクセスを証明できません。

</div>

既存の設定をバックアップし、下の接続を`~/.qwen/settings.json`へ統合してください。無関係なプロバイダーや個人設定を上書きしないでください。この例は[Qwen Codeの公式認証例](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/)に基づき、ワークスペースのURLを`OPENAI_BASE_URL`で渡し、APIキーを`envKey`で指定した環境変数から読み取り、平文の`env`ブロックを省いています。`qwen3-coder-plus`は公式例のモデルです。まず選んだリージョンとアカウントで使えるか確認し、必要ならそのリージョンのコンソールにある実在のモデルIDを2か所とも指定します。

選択したリージョンのワークスペース管理画面から、完全なOpenAI互換Base URLを `DASHSCOPE_BASE_URL` にコピーします。JSONでは `baseUrl` を省略し、起動前に `OPENAI_BASE_URL` で指定します。ワークスペースIDの仮の文字列ではなく、管理画面の実際の値を使ってください。

```json
{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "qwen3-coder-plus" }
}
```

`openai`は互換プロトコルを選びます。`envKey`はQwen Codeが読む環境変数の名前で、キーの値ではありません。`model.name`は設定した`id`に一致させます。各フィールドは[モデルプロバイダーのリファレンス](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/model-providers/)に説明されています。

macOSまたはLinuxではBashターミナルを開き、非表示の入力欄でキーを入力してから、同じターミナルでQwen Codeを起動します：

```bash
read -r -p 'Workspace OpenAI-compatible Base URL (copy from regional console): ' DASHSCOPE_BASE_URL
if [[ -z "$DASHSCOPE_BASE_URL" || ! "$DASHSCOPE_BASE_URL" =~ ^https:[/][/] || "$DASHSCOPE_BASE_URL" == *'{'* || "$DASHSCOPE_BASE_URL" == *'}'* ]]; then
  printf '%s\n' 'STOP: supply the real regional workspace Base URL.' >&2
else
  read -r -s -p 'DashScope API key: ' DASHSCOPE_API_KEY
  printf '\n'
  if [[ -n "$DASHSCOPE_API_KEY" ]]; then
    export DASHSCOPE_API_KEY
    export OPENAI_BASE_URL="$DASHSCOPE_BASE_URL"
    qwen
  else
    printf '%s\n' 'STOP: API key is empty.' >&2
  fi
fi
```

WindowsではPowerShellを使います：

```powershell
$env:DASHSCOPE_BASE_URL = Read-Host 'Workspace OpenAI-compatible Base URL (copy from regional console)'
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_BASE_URL) -or $env:DASHSCOPE_BASE_URL -notmatch '^https:[/][/]' -or $env:DASHSCOPE_BASE_URL -match '[{}]') {
  throw 'Supply the real regional workspace Base URL.'
}
$qwenKey = Read-Host 'DashScope API key' -AsSecureString
$env:DASHSCOPE_API_KEY = [System.Net.NetworkCredential]::new('', $qwenKey).Password
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_API_KEY)) {
  throw 'API key is empty.'
}
$env:OPENAI_BASE_URL = $env:DASHSCOPE_BASE_URL
qwen
```

この方法では、秘密の文字列をJSONやシェルのコマンド履歴に残しません。ただし、実行中のプロセスは環境変数で受け取ります。表示、コミット、プロンプトへの貼り付けはしないでください。この方法に切り替える際は、設定にあるキー入りの古い`env`項目を除去します。新しいターミナルでは、変数をもう一度設定する必要があります。

Qwen Code内で`/doctor`を使って認証を調べ、`/model`で選択した設定を確認します。無害な空のテストフォルダーで「connectedという単語だけ返信してください。ファイルの読み書きやコマンド実行はしないでください」と送ってください。返信があれば、モデルへの1回の要求を確認できます。利用料金が発生する場合があります。`/model`にモデルが出るだけなら、ローカル設定の確認にとどまります。

失敗した場合は、秘密を伏せたエラーと、提供されていればリクエストIDを記録します。認証と、モデルの利用可否・課金を分けて調べ、同じプロバイダーコンソールでキーの発行元、リージョン／ワークスペース、標準かプラン専用かというエンドポイントの区別、選択モデルID、残高・クォータを確認します。401はキーとエンドポイントや課金プランの不一致でも起きるため、プロバイダーの故障の証拠ではありません。失敗した確認の後は停止し、公式情報に基づく不一致を直してから再試行してください。この記事はドキュメントに基づく例であり、記事のために有料リクエストを実行したものではありません。

## APIキーでの利用料金はいくらで、請求額が増える要因は何ですか？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要なポイント">

重要なポイント

APIキーでは従量課金となり、入力トークンと出力トークンそれぞれ1,000トークンごとの料金が発生します。月額固定料金はありません。Qwen3-Coder-Flashなどの軽量モデルは、数倍安くなります。作業量が増えるほど請求額も増えます。ファイルが長く、エージェントが読み書きする量が多いほど、使用量は増えます。正確な価格は必ずプロバイダーのページで確認してください。価格は変動します。

</div>

APIキーはサブスクリプションと異なり、月額固定料金はありません。モデルが読み書きする量をトークン単位で測り、その分を支払います。トークンとは、数文字程度の長さのテキスト片です。各モデルには、入力トークン100万件あたりと出力トークン100万件あたりの料金があり、ほとんどの場合、出力の方が入力より高額です。

100万トークンは膨大に聞こえますが、大規模なプロジェクトでは予想以上に早く消費されます。エージェントはリクエストのたびにファイルをすべて読み込むためです。

実際に押さえておきたいのは、請求額がエージェントの処理するテキスト量で決まるということです。長いファイル、長いセッション、コードの繰り返しの読み込みで、残高が最も早く減ります。タスクの数はそれほど重要ではありません。[APIトークン使用量の計算方法](https://ailoot.ai/blog/ja/api-token-usage-calculation/)と、気づかないうちに使用量がなくなる理由については、別の記事で順を追って説明しています。

## 支払いが拒否されるのはなぜですか？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要なポイント">

重要なポイント

キーで利用を始めるには、残高をチャージする必要があります。カードを発行した銀行が原因で決済システムに拒否された場合、メールアドレス、言語、プロフィール設定を変えても、そのカードの条件は変わりません。

</div>

よくある間違いが起きるのはここです。

障害が起こるのはその次の段階です。キーは発行したものの、残高がなければ何も使えず、プロバイダーから残高不足のエラーが返されます。

カードを発行した銀行が原因で拒否された場合、メールアドレス、インターフェースの言語、プロフィール設定を変えても、支払い条件は変わりません。この仕組みは、[Claudeで海外発行のカードを使う場合](https://ailoot.ai/blog/ja/claude-card-payment-requirements/)を例に説明しています。

また、最終判断を下すのは決済ゲートウェイであることを覚えておいてください。独自の理由で支払いを拒否する場合があり、決済が通る保証はありません。

## どこから始めればよいですか？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要なポイント">

重要なポイント

旧無料OAuth、Coding Plan、標準Model Studio APIの違いを確認します。これは全認証メニューの一覧ではありません。標準APIを使うなら、同じリージョンとワークスペースでキー、エンドポイント、モデル、課金をそろえます。キー発行と利用資金の用意は別です。秘密の値は設定JSONへ入れず、起動するターミナルから渡して短い返信で検証してください。

</div>

手順を簡潔にまとめます。

1.  旧無料OAuth、Coding Plan、標準Model Studio APIを区別します。旧無料OAuthは2026年4月に終了しました。このガイドは標準APIの従量課金経路を扱い、現在の認証選択肢をすべて列挙するものではありません。
2.  プロバイダーのアカウントを作成します。簡単な選択肢は、Alibabaを直接利用する方法です。
3.  プロバイダーのアカウントで、アクセスキーのセクションからキーを発行します。発行は無料で、そのためにカードは必要ありません。
4.  秘密の値を入れずに、リージョンに合う接続を`~/.qwen/settings.json`へ統合します。起動するターミナルで`DASHSCOPE_API_KEY`を渡し、上記の手順で選択モデルと短い返信を確認します。
5.  利用料金を支払うには、プロバイダーの決済ゲートウェイが受け付ける、あなた名義のカードが必要です。チャージ条件は決済ゲートウェイが定めます。キーの発行と利用料金の支払いは別の手順です。

どのモデルが必要かも検討しましょう。負荷の高いタスクには上位モデルのQwen3-Coder-Plus、費用を抑えるには同じ使用量で数倍安い軽量モデルのFlashを選びます。[Claude Codeの代替としてのQwen Code](https://ailoot.ai/blog/ja/qwen-code-token-plan-setup/)の手順では、Qwen Codeとほかのターミナルエージェントの違いを紹介しています。

<div class="section" role="doc-bibliography" aria-label="出典">

### 出典

- [Qwen Code - GitHubリポジトリ](https://github.com/QwenLM/qwen-code) - オープンソースのエージェントコード、インストール方法、複数プロトコル対応、サードパーティプロバイダーへの接続
- [Qwen Code - 認証ドキュメント](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) - 認証経路、旧無料OAuthの終了、Model Studioとプラン専用接続の区別
- [Alibaba Cloud ModelStudio - コンソール](https://bailian.console.alibabacloud.com) - Qwenモデル用のキーを発行する国際アカウント

</div>



詳しい資料は[Ailoot](https://ailoot.ai/)でご覧いただけます。

## Qwen CodeのAPIキー：発行場所、接続方法、使用量の計算：よくある質問

### APIキーを発行すれば、モデル利用も購入済みですか？

いいえ。アクセス用の文字列の発行と利用資金の用意は別です。プロバイダーはキーで要求を識別して計測しますが、発行済みのキーだけでは、利用可能な残高や枠があることを証明できません。

### Qwen Codeのプロバイダー設定では何を一致させますか？

プロトコル、Base URL、キーを保管する環境変数、モデル識別子を同じ接続にそろえます。例ではmodel.nameがmodelProvidersの項目のidと一致します。共有する設定のコピーに本物のキーを含めないでください。


## Ailoot · 企業とそのプロジェクト群

Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。

企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。

Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。