Setup guide - Documented by Qwen
Use Qwen in Cursor
Model Studio's Cursor guide uses Cursor's OpenAI API Key plus Override OpenAI Base URL settings to point Cursor at the Model Studio OpenAI-compatible endpoint, then adds Qwen model names. Custom models need Cursor Pro or higher.
Last verified 6 steps3 official sources
Steps
- Step 1.
Download and install Cursor from the Cursor website.
- Step 2.
In Cursor, click the settings icon and go to Cursor Settings > Models. Enable OpenAI API Key and Override OpenAI Base URL, then enter the API Key, Base URL, and model name for your plan.
- Step 3.
Pay-as-you-go values: API Key = your Model Studio API key; Base URL by region (replace {WorkspaceId}).
SnippetChina (Beijing): https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 Singapore: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 US (Virginia): https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1 - Step 4.
Coding Plan values: API Key = Coding Plan dedicated key; Base URL below; models from the Coding Plan list (kimi-k2.5 written as kimi-k2-5, glm-5 as glm-5-0).
Snippethttps://coding-intl.dashscope.aliyuncs.com/v1 - Step 5.
Token Plan (Personal or Team) values: Base URL below with the Token Plan dedicated key.
Snippethttps://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - Step 6.
In the chat panel, turn off Auto mode, then pick the added model from the model dropdown.
Caveats
- The free version of Cursor only supports Auto mode; errors "The model xxx does not work with your current plan or api key." or "Named models unavailable Free plans can only use Auto." mean you need Cursor Pro or a higher plan.
- Some model names clash with Cursor's built-in names and need aliases: kimi-k2.6 -> kimi-k2-6, kimi-k2.5 -> kimi-k2-5, glm-5.3 -> glm-5-3, glm-5.2 -> glm-5-2, glm-5.1 -> glm-5-1, glm-5 -> glm-5-0.
- "We're having trouble connecting to the model provider." or "Unauthorized User API key" usually means the key, base URL and model name come from different plans.
- The Cursor page links to the OpenAI-compatible supported-models list rather than naming Qwen ids; the ids listed here come from the Model Studio Coding Plan, Codex and Kilo pages for the same OpenAI-compatible endpoints.
More setup guides
Same tool, other providers
Related reading
- Run Qwen3.8-Flash-Next on a Gaming PC With StrataRun Qwen3.8-Flash-Next locally with Strata on a 12 GB GPU: hardware needs, speeds by quant, the license catch, and when the hosted API is the better call.
- Terminal-Universe Turns Agent Traces Into Training EnvironmentsTerminal-Universe, Qwen's paper on rebuilding terminal-agent trajectories into reusable environments, and why agent teams should keep replayable workspaces.
- Qwen3.8-27B vs Opus 4.6 Max: Local Agentic Coding BenchmarksQwen3.8-27B is a 27B dense Apache-2.0 model that beats Opus 4.6 Max on SWE-bench Pro (61.7 vs 53.4). Benchmarks, hardware, cost and when to run it.
- Qwen 3.8 Max Ships: 2.4T MoE, 1M Context, $2/$6 per MTok, Open Weights Next WeekQwen 3.8 Max is a 2.4T-parameter MoE with 95B active, a 1M context window and $2/$6 per million tokens on QwenCloud, with open weights promised next week.
- Qwen-UI-Agent Points at the Next GUI Agent RuntimeQwen-UI-Agent, Alibaba's GUI agent report, reads best as a product spec: mobile, desktop, browser, CLI and DeepSearch combined in one stateful agent runtime.
- $500 RL Fine-Tune of a 9B Open Model Beat GPT-5.6 Sol and Claude Opus 4.8 on Catalog ReviewA $500 GRPO fine-tune of Qwen 3.5 9B beat GPT-5.6 Sol and Opus 4.8 on catalog review, hitting 97% accuracy at a fraction of the cost per listing.
FAQ
How do I use Qwen in Cursor?
Model Studio's Cursor guide uses Cursor's OpenAI API Key plus Override OpenAI Base URL settings to point Cursor at the Model Studio OpenAI-compatible endpoint, then adds Qwen model names. Custom models need Cursor Pro or higher.
Which Qwen model ids work in Cursor?
The official docs read for this guide list qwen3.7-plus, qwen3.6-plus, qwen3.7-max and qwen3.8-max. Requests go to https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1.
Is this an official Qwen and Cursor setup?
Qwen documents this setup in its own docs. It was last checked against 3 official pages on October 17, 2026.
Sources
Last verified against 3 official pages.
- alibabacloud.comhttps://www.alibabacloud.com/help/en/model-studio/cursor
- alibabacloud.comhttps://www.alibabacloud.com/help/en/model-studio/coding-plan
- alibabacloud.comhttps://www.alibabacloud.com/help/en/model-studio/codex
Newsletter
New models, set up the day they ship
One email per week. New model releases, the coding tools that support them and how to wire them up.