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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

リージョンガイドは、本番ではワークスペース専用ドメインを推奨しています。Workspace Managementから実在するAPI Hostをコピーし、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を起動するの手順で紹介しています。

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

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

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

{
  "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に一致させます。各フィールドはモデルプロバイダーのリファレンスに説明されています。

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

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を使います：

$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キーでの利用料金はいくらで、請求額が増える要因は何ですか？#

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

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

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

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

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

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

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

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

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

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

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の手順では、Qwen Codeとほかのターミナルエージェントの違いを紹介しています。

詳しい資料はAilootでご覧いただけます。