3行でいうと
- 公式が運営するつなぎ口は、QwenCloud と Model Studio のAPI、QwenCloud の内蔵ツールとMCP、ターミナルのツール「Qwen Code」、オープンウェイトのモデルです。
- QwenCloud のAPIは、OpenAI互換（Chat Completions と Responses）、Anthropic のメッセージAPI、DashScope のネイティブの3つです。OpenAIのSDKなどで、
base_urlとmodelを変えるだけで呼べる、と公式にあります。 - MCPは、Responses API だけで使えます。SSEのみ、1回のリクエストに最大10サーバーまで。外部のMCPサーバーに送った内容の扱いは、公式のページには書かれていません。
- Claude Code、Cursor などは第三者のツールです。QwenCloud のドキュメントがつなぎ方を書いていますが、そのツールに送られるデータは、そのツールの運営会社の規約に従います。
- Token Plan（月額の購読）のキーと、従量課金のキーは、別物で混ぜて使えません。
この記事は、公式の資料を2026年10月23日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はQwenを入れていますが、使い心地はこの記事には書いていません。コマンドや設定の名前は、公式のページの要約から写したもので、誤写の可能性があります。実行する前に、公式のページで確認してください。「データの行き先」は、公式のページに書かれている範囲だけを書き、書かれていない所は「読んだ範囲では見つからなかった」と書きました。
先に結論
- プログラムから呼ぶなら、まず QwenCloud の「OpenAI互換」。 公式の最初の手順がこれです。既存のコードの
base_urlとキー、モデル名を変えるのが基本です。 - Claude Code などから使う道は、公式のドキュメントにある。 ただし、ツールの側は第三者です。ツールが持つ会話の履歴や設定の置き場所は、そのツールの規約で決まります。
- MCPは、いまのところ使える範囲が狭い。 Responses API だけ、SSEだけです。
- データが流れる先は3か所を意識する。 ①QwenCloud（リージョンごと）、②つないだツールの運営会社、③MCPなどで指定した外部のサーバー、です。
- 「無料」で試すときほど、キーの種類を確認する。 従量課金のキーと Token Plan のキーは、エンドポイントも別で、取り違えると401のエラーになります。
前提：用語をそろえる
- OpenAI互換：OpenAI社のAPIと同じ書き方で呼べること。「互換」は、同じ書き方で動くという意味で、OpenAI社のサービスに送られるという意味ではありません。
- Anthropic互換：Anthropic社の「メッセージAPI」と同じ書き方で呼べること。同じく、送り先は QwenCloud です。
- エンドポイント／ベースURL：APIの住所。QwenCloud では、リージョンごとに
{region}.maas.qwencloudapi.comの形です。 - ワークスペース：APIキーや権限をまとめる単位。
- SSE：サーバーから少しずつ結果を流す通信の形。
- ハーネスのツール：Token Plan の中で使える内蔵ツール（ウェブ検索、コードの実行など）を、公式がこう呼んでいます。
見取り図：誰が運営していて、データはどこへ行くか
| つなぎ口 | 運営 | データの行き先（公式の資料） | 確かさ |
|---|---|---|---|
| QwenCloud のAPI | QwenCloud（アリババクラウド国際版のアカウントで入る。運営会社の表示は Intelligent Cloud Computing (Singapore) Private Limited） | 呼び出したリージョンのエンドポイント。保存はそのリージョン | 文書に書かれている |
| Model Studio のAPI | アリババクラウド | リージョンごと。エンドポイントはワークスペースのID入り | 文書に書かれている |
| 内蔵ツール（ウェブ検索など） | QwenCloud | 検索のためにQwenCloud側で処理。料金は別（04） | 文書に書かれている |
| 外部のMCPサーバー | 指定した提供者（第三者） | あなたが指定した server_url |
行き先は書かれている。扱いは書かれていない |
| Qwen Code | アリババ（Qwenチームの公式リポジトリ） | 認証の方法で変わる。API キーなら提供元の規約 | 文書に書かれている |
| Claude Code、Cursor など | 第三者 | そのツールの運営会社と、設定したAPIの先の両方 | ツール側は読んでいない |
| Hugging Face の推論の提供者など | 第三者 | その提供者 | モデルカードに名前のみ |
公式が運営するもの
1. QwenCloud のAPI：3つの形
- OpenAI互換。 ベースURLは、シンガポールなら
https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1です。PythonではOpenAIのSDKに、このURLとキーを渡します。キーは環境変数DASHSCOPE_API_KEYに入れる流れです。Chat Completions と Responses の両方が、APIリファレンスにあります。 - Anthropic のメッセージAPI。
POST https://{region}.maas.qwencloudapi.com/apps/anthropic/v1/messagesです。SDKに渡すベースURLは/apps/anthropicまでで、/v1/は付けません。認証はx-api-keyかAuthorization: Bearer。必須はmodel、max_tokens、messagesです。 - DashScope のネイティブ。 独自のSDKとHTTPのAPIです。Java用のSDKは「First API call」にも出てきます。
- Anthropic 互換の注意点。
/v1/modelsがないので、Claude Code などでモデルを手で追加する、と書かれています。temperatureの範囲は [0, 2) で、Anthropic の [0, 1] と違います。ウェブ検索を直接呼ぶときは、systemに特定の識別子を入れないと動かない、という注意もあります。 - モデルの扱い。 同じAPIで、第三者のモデル（DeepSeek、
kimi-k3、glm-5.3など）も呼べます。Qwen のモデルではないので、規約や料金は別に確認が必要です。
2. 関数呼び出しと内蔵ツール
- 関数呼び出し。 「モデルを外部のツールにつなぐ」と、公式の目次にあります。公式の料金のページは、関数呼び出しとMCPにQwenCloud側のツール料金はなく、ツールの説明は入力のトークンに数えられる、と書いています（MCPサーバーの提供者の料金は別です）。
- 内蔵ツール。 ウェブ検索、ウェブの取得（Web Extractor）、コードの実行（Code Interpreter、Pythonのサンドボックス）、画像検索、PDFの理解が、ドキュメントにあります。料金は04の表です。
- データの行き先。 検索や取得は QwenCloud 側で動きます。検索した先のサイトにあなたの質問がどう渡るかは、読んだ範囲では見つかりませんでした。
3. MCP（外部ツールとの接続）
- どう使うか。 Responses API の
toolsにtype: "mcp"の項目を足します。必須の項目はserver_protocol（"sse"）、server_label、server_urlです。認証が要るときはheadersを使います。 - 制限。 Responses API だけ（Chat Completions は不可）。SSEだけ。1回のリクエストで最大10サーバー。対応モデルは、Qwen3.8-Max、Qwen3.7-Max、Plus と Flash の各系列、オープンソースの Qwen3.5、3.6、3.8 の系列など（一部は除外）と、ページにあります。
- 費用。 モデルのトークンの料金と、MCPサーバーの提供者が決める料金の2つです。
- データの行き先。 リクエストは、あなたが指定した
server_urlに届きます。そこで内容がどう扱われるかは、公式のページには書かれていません。送る前に提供者の規約を読むのは、僕らの見立てです（MCPのページを読み直しても、データの扱いについての注意書きは見当たらず、例にはModelScopeのエンドポイントが使われていました）。 - ベータかどうか。 MCPのページには「ベータ」「実験的」の表示は見当たりませんでした（読み直しても同じ）。
4. Qwen Code（ターミナルのコーディングのエージェント）
- 何か。 公式のGitHubのREADMEは、オープンソース（Apache-2.0）のターミナルのAIコーディングのエージェントと説明しています。MCP、サブエージェント、IDEのプラグイン（VS Code、Zed、JetBrains）、SDKに対応します。READMEには、もともとGoogle の Gemini CLI（v0.8.2）をもとに、v0.1から独立して開発している、とあります。
- 入れ方。 READMEに、Linux/macOS向けのシェルのスクリプト、Windows向けのPowerShellのスクリプト、npm（Node.js 22以上）、Homebrew の4通りが載っています。スクリプトを実行する形の導入は、中身を読んでから実行するのが安全です。
- つなぎ方。 起動して
/authを実行します。公式のプライバシーの文書は、認証の方法を4つ挙げています。①Qwen OAuth（qwen.ai のアカウント）、②Alibaba Cloud Coding Plan、③自分のAPIキー、④Vertex AI（Google Cloud）です。READMEは、OpenAI、Anthropic、Gemini、Qwen のAPI、さらにOllama や vLLM 経由のローカルのモデルにも対応する、と書いています。 - 無料のログイン。 同じ文書は、Qwen OAuth の無料の枠を2026年4月15日に終了した、と書いています。
- データ。 公式の文書は、Qwen Code 自体は、あなたのプロンプト、コード、応答をモデルの学習に使わない、と書いています。利用統計は匿名で任意、設定でオフにできる、とも。ただし、これは Qwen Code の話で、つないだ先のモデルの提供元がどう扱うかは、その提供元の規約です。
- QwenCloud 側の手順。
~/.qwen/settings.jsonを直接書く方法と、/authの案内に沿う方法があります。CLI、VS Code のプラグイン、デスクトップのアプリは、同じ設定のファイルを共有する、と書かれています。
5. Token Plan（月額の購読）をコーディングのツールにつなぐ
- 何か。 「Credits」という共通の単位で、テキスト、画像、動画のモデルを使える、QwenCloud の月額の購読です。Personal と Team があります。
- つなげるツール。 公式の概要は、OpenAI または Anthropic のAPIの形で、ベースURLとキーを変えられるツールとして、Claude Code、Cursor、Qwen Code、Codex、Qoder、Qoder CN、OpenClaw を挙げています。個人向けの規約には、Trae と Lingma も出てきます。
- エンドポイントとキー。
token-plan.maas.qwencloudapi.comと、sk-sp-で始まるキーです。従量課金のキー（sk-やsk-ws-）とは交換できません。 - 使い方の決まり。 個人向けの規約には、使えるのは、プログラミングやエージェントのツールの中での「対話的な利用」で、自動化のスクリプト、独自のバックエンド、対話でない一括の呼び出しは禁止、とあります。購読の共有も禁止です。
- データ。 個人向けのページは「プロンプトと出力は国境を越えるデータ移転を伴う」と書き、利用できるリージョンはシンガポールだけです。学習への利用の扱いは、ページによって書き方が違います（04）。
6. オープンウェイトのモデル
- 公式の説明。 Hugging Face のモデルカードは、Transformers、vLLM、SGLang、Docker Model Runner、TokenSpeed での使い方を載せています。READMEは、サーバーとして動かすと OpenAI互換のAPIが手元に立つ、と書いています。この場合、モデルへの入力はあなたの環境の中に留まります。
- 読み切れていない点。
Qwen3.8-27Bのカードは「QwenCloud でのホスト版は coming soon」と書く一方、QwenCloud のAnthropic互換のページの一覧にはqwen3.8-27bが載っていました。どちらが新しいかは、読み切れていません。
第三者のツール：公式がつなぎ方を書いているもの
QwenCloud のドキュメントの索引には、次のツールの接続ページが並んでいます。どれも、アリババ以外が運営するツールです。
| ツール | 公式（QwenCloud）が書く接続の要点 | ツールの運営 |
|---|---|---|
| Claude Code | ANTHROPIC_BASE_URL に Anthropic互換のURL、ANTHROPIC_AUTH_TOKEN にキー、モデルは ANTHROPIC_MODEL ほか |
Anthropic（第三者） |
| Cursor | 設定の「Models」で「OpenAI API Key」と「Override OpenAI Base URL」を有効にして、キー、URL、モデル名を入れる | Cursor（第三者） |
| Codex | 接続のページがある（中身は読めていない） | OpenAI（第三者） |
| OpenCode、Cline、Kilo CLI、Hermes Agent、OpenClaw | 接続のページがある（中身は読めていない） | それぞれの提供者（第三者） |
| Dify、Cherry Studio、Chatbox、Postman | 接続のページがある（中身は読めていない） | それぞれの提供者（第三者） |
| Qoder、Qoder CN（旧 Lingma） | 接続のページがある。Qoder は別のサイト（qoder.com）にリンク | アリババとの関係は、読んだページには書かれていない |
Claude Code につなぐ場合（公式の手順の要点）。
- Token Plan のベースURLは
https://token-plan.maas.qwencloudapi.com/apps/anthropicです。従量課金はhttps://ap-southeast-1.maas.qwencloudapi.com/apps/anthropic（シンガポール）です。 - 設定は
~/.claude/settings.jsonのenvに書き、Anthropic へのログインを省くために~/.claude.jsonのhasCompletedOnboardingをtrueにする、と書かれています。 - キーとURLの取り違えは401の
invalid_api_key。非推奨になったモデルは403のAccessDenied。 - データの行き先。 この設定では、コードや指示は QwenCloud に送られます。Claude Code 側が、利用状況などを Anthropic に送るかどうかは、Claude Code の側の設定と規約で決まり、QwenCloud の資料には書かれていません。
Cursor につなぐ場合。
- ベースURLは
.../compatible-mode/v1です。モデル名のドット（glm-5.2）をハイフン（glm-5-2）に直す必要がある場合がある、と書かれています。 - Cursor の無料プランは Auto モードだけで、独自のモデルは使えず、Pro 以上が必要、と書かれています。エージェントモードで使えるかどうかは、書かれていません。
- データの行き先。 Cursor のサービスを経由するかどうかは、Cursor 側の仕組みで、QwenCloud の資料には書かれていません。
コミュニティ・第三者のもの
- 量子化版と配布。
Qwen3.8-27Bのカードは、llama.cpp、Ollama、LM Studio 向けの「コミュニティの量子化版」があると書いています。これは公式の配布ではありません。入手元の信頼性は、各自で確認が必要です。 - 推論の提供者。 モデルカードに、Hugging Face の推論の提供者として Novita や Featherless AI、HuggingChat が挙がっています。ここに入力すると、データは、その提供者に渡ります。
- 第三者のまとめ記事や動画。 この記事は、根拠にしていません。
気をつけること
- 「公式のドキュメントに書いてある」は「公式が運営している」ではない。 接続の手順は QwenCloud が書いていても、Claude Code や Cursor の側のデータの扱いは、それぞれの規約です。
- コードや機密のファイルを渡す前に、行き先を確認する。 コーディングのツールでは、プロジェクトのファイルがモデルに送られる前提で使うことになります。どのリージョンに送られるか（01）、Singapore か Global か、を決めてから使ってください。
- キーの管理。 キーは作成時に1回しか表示されません。公式は、環境変数かシークレット管理に置く、フロントエンドには入れない、開発用と本番用でキーを分ける、と書いています。無効にする操作は元に戻せますが、削除は戻せません。
- MCPの外部サーバーは、信頼できる提供者だけに。 費用も、提供者ごとの料金表で別にかかります。
- 「互換」の違い。 Anthropic互換でも、
temperatureの範囲やモデル探索の有無など、本家と違う点が公式に書かれています。つなぐツールが、その違いに対応しているかは、公式の資料では確認できていません。
出典
- Introduction（QwenCloud Docs、確認日 2026-10-23）
- First API call（QwenCloud Docs、確認日 2026-10-23）
- Regions and endpoints（QwenCloud Docs、確認日 2026-10-23）
- QwenCloud Docs 索引 llms.txt（QwenCloud、確認日 2026-10-23）
- Anthropic Messages API（QwenCloud Docs、確認日 2026-10-23）
- Connect to MCP servers（QwenCloud Docs、確認日 2026-10-23）
- Claude Code（QwenCloud Docs、確認日 2026-10-23）
- Cursor（QwenCloud Docs、確認日 2026-10-23）
- Qwen Code（QwenCloud Docs、確認日 2026-10-23）
- Token Plan（QwenCloud Docs、確認日 2026-10-23）
- Token Plan Individual（QwenCloud Docs、確認日 2026-10-23）
- API keys（QwenCloud Docs、確認日 2026-10-23）
- Pricing（QwenCloud Docs、確認日 2026-10-23）
- qwen-code（QwenLM、GitHub、確認日 2026-10-23）
- Qwen Code: Terms of Service and Privacy Notice（Qwen Codeドキュメント、確認日 2026-10-23）
- QwenLM/Qwen3.8 README（QwenLM、GitHub、確認日 2026-10-23）
- Qwen3.8-27B モデルカード（Qwen、Hugging Face、確認日 2026-10-23）
- Qwen3.8-2.4T-A95B モデルカード（Qwen、Hugging Face、確認日 2026-10-23）
- What is Alibaba Cloud Model Studio（Alibaba Cloud、確認日 2026-10-23）