3行でいうと
- Claude Code、Codex、Cursor、OpenCode、Cherry Studio から Qwen を使う設定は、QwenCloud の公式ドキュメントに、ツールごとのページがあります。どれも、接続先のURL、キー、モデル名を差し替える形です。ツール自体は、それぞれ別の会社や開発者のものです。
- QwenCloud のAPIから外部のMCPサーバーを呼ぶには、Responses API の
toolsにtype: "mcp"を足します。SSEだけ、1回に最大10サーバーまでです。 - 従量課金のキーと Token Plan のキーは別物で、URLも別です。取り違えると401になります。
- コードや指示は QwenCloud に送られます。ツールの運営会社に何が送られるかは、QwenCloud の資料に書かれていません。
- 外し方(接続の解除)は、ページに明記がないものがほとんどです。記載がないものは「記載が見つからない」と書きます。
この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はQwenを入れていますが、使い心地はこの記事には書いていません。設定例は、「公式の例の写し」か、「公式の記載に合わせて、この記事で組んだ例(動作は確かめていません)」のどちらかを、そのつど書き分けています。公式の例は、取得が要約を通した形なので、記号や改行が崩れている可能性があります。システムへの登録や権限に関わる操作は、公式ページの原文を見て写してください。画面の表記は変わります。手元の画面と照らして読んでください。
先に結論
- 「呼ぶ側」と「呼ばれる側」を先に決める。 Claude Code に Qwen を差し込むときは、Claude Code が呼ぶ側、QwenCloud が呼ばれる側です。
- 接続先のURLと、キーの種類を、最初にそろえる。 従量課金は
{リージョン}.maas.qwencloudapi.com、Token Plan はtoken-plan.maas.qwencloudapi.comです。キーは、それぞれ専用です。 - コードや指示は、QwenCloud に送られる。 ツールの運営会社に何が送られるかは、そのツールの設定と規約で決まります。
- 外し方は、設定を書いた場所を消す、が基本の形。 ただし、公式が「これで外れる」と書いているものは、読んだ範囲ではほとんどありません。
前提:用語をそろえる
- MCP(Model Context Protocol):AIが外部のツールやデータにつながるための決まりです。つなぐ先のプログラムを「MCPサーバー」と呼びます。
- Anthropic互換:Anthropic社のメッセージAPIと同じ書き方で呼べること。Claude Code が使う形です。送り先は QwenCloud です。
- OpenAI互換:OpenAI社のAPIと同じ書き方で呼べること。Codex、Cursor、Cherry Studio などが使う形です。
- Responses API:OpenAI互換の中の、新しい形のAPIです。QwenCloud ではMCPの利用が、これだけで使えます。
- Token Plan:QwenCloud の月額の購読です。専用のURLとキーがあります(04)。
- ベースURL:APIの受付の住所です。
wire_api:Codex の設定で、どのAPIの形で話すかを決める項目です。- SSE:サーバーから少しずつ結果を流す通信の形です。
見取り図:誰が誰を呼ぶか、何が渡るか
| 組み合わせ | 呼ぶ側 → 呼ばれる側 | 渡るデータ(公式の記載の範囲) | 公式のページ |
|---|---|---|---|
| Claude Code × Qwen | Claude Code → QwenCloud | 指示、コードが QwenCloud へ。Claude Code が Anthropic に送るものは、QwenCloud の資料に書かれていない | QwenCloud の Claude Code のページ |
| Codex × Qwen | Codex → QwenCloud | 同上。Codex が OpenAI に送るものは書かれていない | QwenCloud の Codex のページ |
| Cursor × Qwen | Cursor → QwenCloud | Cursor のサービスを経由するかは書かれていない | QwenCloud の Cursor のページ |
| OpenCode × Qwen | OpenCode → QwenCloud | OpenCode の側の扱いは書かれていない | QwenCloud の OpenCode のページ |
| Cherry Studio × Qwen | Cherry Studio → QwenCloud | 会話の内容が QwenCloud へ。Cherry Studio の側の保存は書かれていない | QwenCloud の Cherry Studio のページ |
| QwenCloud のAPI × 外部のMCPサーバー | QwenCloud → server_url |
リクエストの内容が、指定したサーバーへ。サーバーでの扱いは書かれていない | QwenCloud の MCP のページ |
キーとURLの組み合わせ(共通)
どのツールでも、まず次の表の組み合わせを間違えないことが前提です。QwenCloud の各ページが、これを書いています。
| プラン | キー | OpenAI互換のURL | Anthropic互換のURL |
|---|---|---|---|
| 従量課金(シンガポール) | 従量課金のキー | https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1 |
https://ap-southeast-1.maas.qwencloudapi.com/apps/anthropic |
| Token Plan(個人・チーム) | Token Plan 専用のキー | https://token-plan.maas.qwencloudapi.com/compatible-mode/v1 |
https://token-plan.maas.qwencloudapi.com/apps/anthropic |
- 従量課金は、ほかのリージョンのときは
ap-southeast-1を差し替え、そのリージョンで作ったキーを使います。 - Token Plan のURLには、リージョンIDがありません。対応リージョンの記載は、読んだページに見つかりませんでした(Regions のページは、北京では Token Plan が使えない、と書いています)。
- Claude Code、Codex、Cursor のページは、401 などの原因として、キーの種類・プランとURLの食い違いを挙げています。
1. Claude Code から Qwen を使う(Anthropic互換)
QwenCloud の「Claude Code」のページの手順です。Claude Code は Anthropic のツールで、このページはその設定を QwenCloud 側が書いたものです。
手順
- Node.js のバージョン 18.0 以上を用意します。Windows は、WSL か Git for Windows を入れ、WSL か Git Bash で実行します。
- Claude Code を入れます。
npm install -g @anthropic-ai/claude-code
claude --version
- QwenCloud のページは、Anthropic のログインを省く(skip Anthropic login)ために、
~/.claude.json(Windows はC:\Users\<username>\.claude.json)のhasCompletedOnboardingをtrueにする、と書いています。ファイルを作るか編集します。
{
"hasCompletedOnboarding": true
}
~/.claude/settings.json(Windows はC:\Users\<username>\.claude\settings.json)に、プランに合うほうを書きます。従量課金(シンガポール)の例(公式の例の写し):
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://ap-southeast-1.maas.qwencloudapi.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.7-max",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
"CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max"
}
}
- Token Plan のときは、
ANTHROPIC_BASE_URLをhttps://token-plan.maas.qwencloudapi.com/apps/anthropicにし、Token Plan 専用のキーを入れ、モデルの割り当ても別の値になります(ANTHROPIC_MODELはauto、など)。全文は公式ページの原文を見てください。 - すべてのターミナルを閉じ、新しく開いて
claudeを実行します。設定の変更は、起動中のセッションには反映されません。 - セッションの中で
/statusを実行し、ANTHROPIC_BASE_URLとANTHROPIC_AUTH_TOKENが QwenCloud を指していることを確かめます。短い質問を送ります。
割り当ての意味(公式)
ANTHROPIC_MODELが主のモデル、ANTHROPIC_DEFAULT_HAIKU_MODEL、..._SONNET_MODEL、..._OPUS_MODELが、Claude Code の Haiku、Sonnet、Opus という役割の名前がどのモデルに当たるか、CLAUDE_CODE_SUBAGENT_MODELがサブエージェントのモデルです。- 文脈は、Claude Code の既定が200Kで、1Mにするには
CLAUDE_CODE_MAX_CONTEXT_TOKENSを入れるか、モデル名の末尾に[1m]を付ける、とあります(そのモデルが対応している場合)。 - 権限:1回のセッションだけ変えるなら
claude --permission-mode planかacceptEdits。permissionsのdefaultModeで、常時の既定にできます。
渡るデータ
- 指示とコードは、設定した QwenCloud のURLに送られます。
- Claude Code 側が Anthropic に送るもの(利用状況など)は、QwenCloud のページに書かれていません。Claude Code の側の設定と規約を見る必要があります。
- 注意:ページは、Claude Desktop については、CC Switch という community の desktop tool の local gateway を経由して使う、と書いています。同ページは、Claude Desktop に QwenCloud のキーを入れないように、とも書いています。CC Switch は第三者のツールで、QwenCloud のページはその設定に触れていますが、この記事では手順を書きません。
外し方
- ページに、外す手順の記載は見つかりませんでした。
- 接続先を決めているのは、
~/.claude/settings.jsonのenvの項目です。ここを書き換えるか消すことが、手がかりになります(これは僕らの見立てで、公式が確認した手順ではありません)。 hasCompletedOnboardingを戻す手順の記載は、見つかりませんでした。- サービス側は、QwenCloud の API Keys のページで、キーを無効化か削除できます(05)。
うまくいかないとき
| 症状 | 公式の記載 |
|---|---|
401 invalid_api_key |
キーの種類とURLの食い違い。従量課金は sk- のキーと ap-southeast-1 のURL、Token Plan は Token Plan のキーと token-plan のURL |
| 「Unable to connect to Anthropic services」 | 設定が反映されていない、または hasCompletedOnboarding がない。/status を確認、新しいターミナルを開く、npm install -g @anthropic-ai/claude-code@latest |
403 AccessDenied |
非推奨になる予定のモデル。現行のモデルに変える |
- 公式は、このエンドポイントに
/v1/modelsがないことも書いています。 - 公式のページは、QwenCloud で使えない Claude Code の機能の一覧を載せていません。
2. Codex から Qwen を使う(OpenAI互換)
QwenCloud の「Codex」のページの手順です。Codex は OpenAI のツールです。
手順
- Node.js 18.0 以上を用意し、Codex を入れます。
npm install -g @openai/codex
codex --version
- 環境変数
OPENAI_API_KEYに、プラン別のキーを入れます。macOS(zsh)は次の形です。
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc
bash は ~/.bash_profile、Windows の CMD は setx OPENAI_API_KEY "YOUR_API_KEY"、PowerShell は [Environment]::SetEnvironmentVariable(...)(05と同じ形)です。
~/.codex/config.tomlに書きます。従量課金(シンガポール)、Responses API の例(公式の例の写し):
model_provider = "Model_Studio"
model = "qwen3.7-max"
[model_providers.Model_Studio]
name = "Model_Studio"
base_url = "https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
- Token Plan のときは、
base_urlがhttps://token-plan.maas.qwencloudapi.com/compatible-mode/v1、model = "auto"で、個人はModel_Studio_Token_Plan_Personal、チームはModel_Studio_Token_Planの名前を使います。 - モデルを切り替えるには、
~/.codex/model-catalog.local.jsonを作り、model_catalog_json = "~/.codex/model-catalog.local.json"をconfig.tomlに足します。カタログの中身は長いため、公式は、原文からコピーするように書いています。この記事には写しません。 -
新しいターミナルで
codexを実行します。チャットの画面が始まれば、設定は効いている、とあります。モデルはcodex -m <model>か、画面の中の/modelで切り替えます。 -
古い Chat/Completions 形式(
wire_api = "chat")は、新しい Codex では使えず、Codex 0.80.0 を入れる必要がある、と書かれています。
渡るデータ、外し方
- 指示とコードは、
base_urlの QwenCloud に送られます。Codex が OpenAI に送るものは、ページに書かれていません。 - 外す手順は、記載が見つかりませんでした。接続先を決めているのは
~/.codex/config.tomlのmodel_providerと[model_providers.…]です(これは僕らの見立て)。
うまくいかないとき(公式の記載)
| 症状 | 確認すること |
|---|---|
wire_api = "chat" is no longer supported |
wire_api を "responses" にし、base_url を確かめる |
unknown configuration field wire_api |
提供元の節の wire_api の行を消す |
| 401 | 別のプランのキー、期限切れ、コピーの誤りを疑う。キーを再取得か、管理画面でリセット |
| 404 | base_url か wire_api が、プランの設定と合っていない |
stream disconnected before completion |
会話が長い、通信が不安定、サーバーの混雑が原因として挙がる。新しいスレッドで再試行 |
3. Cursor から Qwen を使う
QwenCloud の「Cursor」のページの手順です。Cursor は第三者のエディタです。
手順
- Cursor の有料プラン(Pro 以上)が要ります。無料プランは Auto モードだけで、独自のモデルは使えない、とあります。
- Cursor の設定のアイコンから、Cursor Settings の Models を開きます。
- OpenAI API Key と Override OpenAI Base URL をオンにします。
- キーとベースURLを入れます。従量課金(シンガポール)は、
https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1、Token Plan はhttps://token-plan.maas.qwencloudapi.com/compatible-mode/v1です。 - モデルを足します。名前のドットは、ハイフンに直す、と書かれています(例:
kimi-k2.6はkimi-k2-6、glm-5.3はglm-5-3)。glm-5.1はglm-5-1、glm-5はglm-5-0とし、この2つはチーム版と従量課金の場合、と書かれています。 - チャットのパネルで Auto をオフにし、モデルのドロップダウンから選びます。
渡るデータ、外し方、うまくいかないとき
- Cursor のサービスを経由するかどうかは、ページに書かれていません。
- 外す手順の記載は、見つかりませんでした。
- 公式の記載:「The model xxx does not work with your current plan or api key.」は無料プラン。追加したモデルが見えないときは Auto をオフにする。接続の失敗(「Unauthorized User API key」など)は、キー、ベースURL、モデル名がプランと合っているか、名前の書き換え後の形か、を確かめる。
4. OpenCode から Qwen を使う
QwenCloud の「OpenCode」のページの手順です。
手順
- Node.js 18.0 以上を用意し、入れます。
npm install -g opencode-ai
opencode -v
- 設定ファイル
opencode.jsonを、macOS/Linux なら~/.config/opencode/opencode.json、Windows ならC:\Users\<Your-Username>\.config\opencode\opencode.jsonに作ります。キーは、ページの例では、ファイルのapiKeyに直接書く形です。 - 従量課金(シンガポール)の例(公式の例を、モデルを1つに減らして写したもの。ほかのモデルの項目は原文を見てください):
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"qwencloud": {
"npm": "@ai-sdk/openai-compatible",
"name": "QwenCloud",
"options": {
"baseURL": "https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1",
"apiKey": "YOUR_API_KEY"
},
"models": {
"qwen3.7-max": {
"name": "Qwen3.7 Max"
}
}
}
}
}
- Token Plan は、
@ai-sdk/anthropicを使い、baseURLはhttps://token-plan.maas.qwencloudapi.com/apps/anthropic/v1です。末尾に/v1が付く点が、Claude Code の設定(/apps/anthropic)と違います。Claude Code のページの CC Switch の節は、URL が/apps/anthropicで終わり、余分な/v1を付けないことを確かめる、と書いています。どちらも公式の記載で、この違いの説明は、読んだページにありませんでした。 - OpenCode を再起動し、
/modelsを入力して、QwenCloudで検索して選びます。
渡るデータ、外し方
apiKeyが、ファイルに平文で入ります。ファイルの扱いに注意が要ります(これは僕らの見立て)。- 外す手順の記載は、見つかりませんでした。
5. Cherry Studio から Qwen を使う(画面で設定するアプリ)
QwenCloud の「Cherry Studio」のページの手順です。コマンドを使わず、画面で設定するアプリです。
手順
- Cherry Studio のダウンロードのページ(cherry-ai.com/download)から、自分のOS向けを入れます。
- アプリの右上の設定ボタンを押し、Model Service の Add を押します。名前を付け、提供元の種類を OpenAI にします。
- 「API key」にキー、「API address」に、従量課金(シンガポール)なら
https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1、Token Plan ならhttps://token-plan.maas.qwencloudapi.com/compatible-mode/v1を入れます。 - Model ID にモデル名(例:
qwen3.7-max)を入れ、Add を押します。 - チャットに戻り、質問を送って、返事が来るかを見ます。
うまくいかないとき(公式の記載)
- 「
enable_thinkingは True に限られる」という趣旨のエラー:思考専用のモデルがあり、クライアントで思考モードを有効にする。 - 無料枠があるのに課金される:API のURLがシンガポールか確かめる。無料枠はモデルごとに別々に計算され、共有されない。コンソールの無料枠の表示は1時間ごとに更新されるので、表示より先に使い切っている場合がある。
渡るデータ、外し方
- 会話の内容が QwenCloud に送られます。Cherry Studio の側の保存場所は、ページに書かれていません。
- 外す手順の記載は、見つかりませんでした。
6. QwenCloud の API から外部のMCPサーバーを呼ぶ
QwenCloud の「Connect to MCP servers」のページの手順です。コマンドや画面ではなく、APIのリクエストに書く連携です。
設定する場所と書く内容
Responses API のリクエストの tools に、次の項目を足します。
| 項目 | 必須 | 内容 |
|---|---|---|
type |
必須 | "mcp" |
server_protocol |
必須 | いまは "sse" だけ |
server_label |
必須 | サーバーを区別する名前 |
server_description |
任意 | サーバーの説明。公式は、呼び出しの精度を上げるために書くよう案内している |
server_url |
必須 | MCPサーバーのエンドポイント |
headers |
任意 | サーバーに送るヘッダー(Authorization など) |
公式の例の写し(curl、シンガポール):
curl -X POST https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1/responses \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.8-max",
"input": "https://news.aibase.com/news, what is the AI news today?",
"tools": [
{
"type": "mcp",
"server_protocol": "sse",
"server_label": "fetch",
"server_description": "Fetch MCP Server that provides web scraping capabilities. It can scrape the content of a specified URL and return it as text.",
"server_url": "https://mcp.api-inference.modelscope.net/xxx/sse"
}
]
}'
server_urlのxxxは置き換える部分です。公式の例は、ModelScope などのプラットフォームで取得した SSE のエンドポイントを入れる、と書いています。- 認証が要るときは、そのプラットフォームのトークンを
headersに入れます。 - 起きること:公式のPythonの例は、
response.output_text(答え)とresponse.usage(トークンの使用量)を表示します。ストリーミングの扱いもあります。
制限、費用、データ
- Responses API だけで使えます(Chat Completions では使えません)。SSE だけで、1回のリクエストで最大10サーバーです。
- 対応モデルは、Qwen3.8-Max、Qwen3.7-Max の系列、Plus と Flash の各系列、Qwen3.8、Qwen3.6(
qwen3.6-27bを除く)、Qwen3.5 のオープンソースの系列、などです。 - 費用は、モデルのトークン分と、MCPサーバーの提供者が決める分の2つです。
- 送ったリクエストの内容が、
server_urlのサーバーに届きます。そこでの扱いは、ページに書かれていません。 - エラーの扱いと、エラーコードの一覧は、ページに記載がありませんでした。
外し方
- リクエストから、
type: "mcp"の項目を外せば、そのリクエストでは呼ばれなくなります。これは、リクエストごとに指定する形だ、というページの構成から読めることで、「外す」の説明が公式にあるわけではありません。 - サーバー側のトークンの取り消しは、そのサーバーの提供者の側の操作です。
7. このほか、公式が接続ページを持つもの(読んでいないもの)
QwenCloud のドキュメントの索引には、次のページがあります。この記事では、中身を読んでいないため、手順を書きません。
- OpenClaw、Hermes Agent、DeepSeek Harness、WorkBuddy、QwenPaw、Chatbox、Cline、Qoder、Qoder CN(旧 Lingma)、Kilo CLI、Postman、Dify、More tools。
- Qwen Code のドキュメントには、Telegram、WeChat、DingTalk、Feishu などの「Channels」(
qwen channel)、GitHub Actions、qwen serve(実験的な常駐の形)、拡張、SDK のページがあります。READMEは、qwen serveを experimental としています。 - Qwen Code のプライバシーのページには、Chrome の拡張(Browser Use)の記載があります。ブラウザの道具は、開いているタブのタイトルとURL、ページの文章、スクリーンショット、コンソールやネットワーク、クッキーなどのデバッグの情報に触れられる、と書かれ、命令と結果は同じコンピューターの Qwen Code に渡り、Qwen Code が設定した提供元に送ることがある、とあります。設定の手順は、読んでいません。
外し方のまとめ
| 連携 | 公式に明記がある外し方 | 記載が見つからないもの |
|---|---|---|
| Qwen Code の接続先 | /auth で接続先を選び直す(認証のページの記載) |
/auth で入れたキーの保存先とログアウトの操作 |
| Qwen Code の MCP | qwen mcp remove <name> |
OAuth のトークンのファイルの削除、サーバー側の取り消し |
| Claude Code、Codex、Cursor、OpenCode、Cherry Studio | なし(接続の手順だけ) | すべて |
| QwenCloud のキー | API Keys のページで、無効化(戻せる)か削除(戻せない)。Token Plan はリセット | 各ツールからの削除操作 |
| API の MCP | なし | 「外す」の説明 |
気をつけること
- 運営者は Qwen を入れていますが、使い心地はこの記事には書いていません。 この記事の手順は、公式の手順を順に並べたものです。動作を確かめた記録ではありません。
- 公式のドキュメントにあることと、運営していることは別。 Claude Code、Codex、Cursor、OpenCode、Cherry Studio は、それぞれ別の会社や開発者のものです。QwenCloud の資料は、接続の設定を書いていますが、各ツールがデータをどう扱うかは書いていません。
- コードや業務の資料を渡す前に、行き先を確かめる。 コーディングのツールは、プロジェクトのファイルがモデルに送られる前提で動きます。どのリージョンに送るか(05)、ツールの運営会社の規約、の両方を見ます。
- キーを平文のファイルに書く連携がある。 OpenCode の
apiKey、Claude Code のenvは、設定ファイルに書く形です。ファイルをバージョン管理に入れないことは、公式も書いています。 - 取得の限界。 設定例は、取得結果から写したものです。Codex のモデルカタログ、Token Plan の設定の全文、OpenCode の全モデルの項目は、この記事に写していません。システムに作用する設定は、原文を見て写してください。
- ページ同士の違い。 OpenCode と Claude Code の Anthropic 互換のURLの末尾は、ページごとに違います。どちらかに決めつけず、最新の公式ページで確かめてください。
- 読めなかった所。 第7節に挙げたページ、Codex のカタログの全文は、読んでいません。QwenCloud の Token Plan のFAQと、エラーコードのページも読んでいません。
- Qwen Code との組み合わせ。 Qwen Code の接続先、MCP、エディタの設定は、その1(07)にあります。
出典
- Claude Code(QwenCloud Docs、確認日 2026-10-25)
- Codex(QwenCloud Docs、確認日 2026-10-25)
- Cursor(QwenCloud Docs、確認日 2026-10-25)
- OpenCode(QwenCloud Docs、確認日 2026-10-25)
- Cherry Studio(QwenCloud Docs、確認日 2026-10-25)
- Connect to MCP servers(QwenCloud Docs、確認日 2026-10-25)
- Regions and endpoints(QwenCloud Docs、確認日 2026-10-25)
- API keys(QwenCloud Docs、確認日 2026-10-25)
- QwenCloud Docs 索引 llms.txt(QwenCloud、確認日 2026-10-25)