阿里云 Coding Plan
使用套餐专用 Key 和区域端点,区分月费套餐与标准 API。
Coding Plan 面向希望使用固定月费和包含配额的开发者。Qwen Code 官方说明它支持多个模型;具体价格、配额和可用型号应按所订阅区域的 ModelStudio 当前说明确认。
交互设置
- 启动
qwen,输入/auth。 - 选择 Alibaba ModelStudio → Coding Plan。
- 选择账号区域,输入
sk-sp-开头的套餐 Key。 - 用
/model切换已配置的套餐模型。
Coding Plan 使用专用地址,不是标准 DashScope API 地址:
| 区域 | baseUrl |
|---|---|
| 中国(北京) | https://coding.dashscope.aliyuncs.com/v1 |
| 国际 | https://coding-intl.dashscope.aliyuncs.com/v1 |
配置文件方式
下面以官方示例模型为配置形状演示;模型需要在你的套餐中可用。将文件合并到 ~/.qwen/settings.json:
{
"modelProviders": {
"openai": [
{
"id": "qwen3-coder-plus",
"name": "qwen3-coder-plus (Coding Plan)",
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"envKey": "BAILIAN_CODING_PLAN_API_KEY"
}
]
},
"security": {
"auth": { "selectedType": "openai" }
},
"model": { "name": "qwen3-coder-plus" }
}通过运行环境提供凭据:
export BAILIAN_CODING_PLAN_API_KEY="sk-sp-xxxxxxxxx"示例字符串需替换为自己的 Key。配置将 envKey 与该变量关联,并显式选择协议及模型,避免只设置提供商专用变量却没有对应模型条目。
排查连接
先确认 Key 属于 Coding Plan、区域和 baseUrl 一致、model.name 与条目 id 一致,再通过 /doctor 检查。旧 qwen auth coding-plan 已移除,不能继续用它配置。
按量 Token Plan 和 Standard API Key 分别使用自己的端点及认证方式,见认证入口。
自动配置与模板更新
通过 /auth 设置时,模型模板自动加入 /model;Key 默认以 BAILIAN_CODING_PLAN_API_KEY 存在 settings.json 的 env 中,可迁移到独立 .env。Model Providers 页开头“凭据不持久化到 settings”的概括与此专节及示例不一致,应按实际存储字段检查,而不是假定文件不含 Key。
检测到较新模板时会提示更新。接受后替换 Coding Plan 模板配置、保留手工添加的自定义模型,并保持当前选择;如果当前模型已不在新模板中,需要手动用 /model 重新选择。
手工条目无需配置 codingPlan.*,也不自动套用模板更新。但如果手工条目与自动配置共用 envKey 和 baseUrl,更新可能覆盖它;需要独立维护时使用不同 envKey。