Qwen3.7-Max 无法通过 API Key 在 Qwen Code CLI 中使用,最常见的原因不是 Key 字符串失效,而是认证类型、地域、业务空间、接入域名或模型 ID 不匹配。Qwen Code 展示的模型列表取决于当前认证方案和本地 provider 配置;在百炼新建工作空间并创建 Key,不会自动让所有模型出现在 /model 列表中。
这两种故障需要分开处理。运行 /model 看不到目标模型,说明 Qwen Code 当前加载的模型模板或自定义 provider 中没有该模型。能够选中模型但请求返回 401、403、404 或其他错误,才属于鉴权、权限、模型名称或接口地址问题。
来源帖子中的现象是新建工作空间和 API Key,并授权目标模型后,Qwen Code 仍只显示四个标准模型。这首先指向 CLI 的认证方案与模型列表配置,而不能仅凭现象断定模型 API 不可用。
Qwen Code 的阿里云 ModelStudio 入口包含 Standard API Key、Coding Plan 和 Token Plan。三种方案的密钥、端点和可用模型集合并不相同。Coding Plan 使用专用套餐 Key 和专用接入地址;Standard API Key 则属于具体地域和业务空间,按模型调用量计费。
如果拿 Standard API Key 选择了 Coding Plan 登录流程,或者把套餐 Key 填到标准 DashScope 地址,即使密钥格式看起来正确,也可能无法得到预期模型列表。应重新运行 /auth,选择 Alibaba ModelStudio 下与手中凭据一致的方案。
百炼官方文档明确说明,每个地域有独立的 API Key、接入域名和模型列表,不能跨地域混用。北京地域创建的 Key 应连接北京对应端点,国际或其他地域的 Key 也要使用同地域地址。控制台页面、工作空间和 Key 看起来相似,并不代表它们属于同一地域。
排查时记录以下四项并逐一核对:
/auth 中选择的地域;baseUrl 是否属于同一地域。不要把完整 Key 写入截图或 Issue。只展示密钥类型、地域、空间 ID 的脱敏形式和请求 ID。
一个 API Key 只能归属一个地域内的一个业务空间和一个用户,它能调用的模型受归属业务空间权限约束。默认空间与子空间的权限范围可能不同;自定义权限的 Key 还可能受到模型范围或 IP 白名单限制。
因此,“在另一个空间启用了模型”不能证明当前 Key 有权限。应回到生成该 Key 的同一地域与同一业务空间,检查目标模型是否在可调用范围内。若使用调优或部署后的专属模型,还必须用该部署所在空间的 Key。
界面中的产品名称不一定等于 API 请求所需的模型 ID。版本发布后,稳定别名、快照名称和套餐内模型名可能不同。应从当前地域的官方模型列表复制精确 ID,不要根据宣传名称手写 qwen3.7-max。
Qwen Code 的 Coding Plan 自动模型清单由官方模板维护,其中可能提供带日期的 Max 快照,而不是用户预期的无日期名称。如果目标模型不在当前套餐自动清单中,需确认 Standard API 是否支持它,或在 modelProviders 中按官方 ID 显式配置。
对于 Standard API Key,可以在用户级 settings.json 中定义 OpenAI 兼容 provider。示意结构如下:
{
"modelProviders": {
"openai": [
{
"id": "从当前地域模型列表复制的精确ID",
"name": "自定义显示名称",
"baseUrl": "当前地域的OpenAI兼容根地址",
"envKey": "BAILIAN_API_KEY"
}
]
},
"env": {
"BAILIAN_API_KEY": "通过安全环境注入"
},
"security": {
"auth": {
"selectedType": "openai"
}
}
}
示例中的地址和模型 ID 必须替换为控制台当前地域提供的真实值。团队环境应优先通过环境变量或受保护的 .env 文件注入密钥,避免把明文凭据提交到代码仓库。
Qwen Code 的配置可能同时来自用户目录、项目目录、环境变量和命令行。项目级 modelProviders 可能整体覆盖用户级定义,而不是逐项合并;旧进程也可能仍持有启动时读取的配置。
修改后先退出并重新启动 CLI,再运行 /auth 确认认证类型,随后运行 /model 查看目标条目。若仍未出现,检查 JSON 结构和启动日志。新版 provider 配置使用模型数组;旧预览版的包装结构在已迁移配置中可能被跳过。
在处理 CLI 前,使用百炼官方 OpenAI 兼容示例,以同一个 Key、地域端点和模型 ID 发送最短文本请求。根据结果可以快速分流:
测试时保存状态码、错误码和请求 ID,错误正文比“不能用”的界面提示更有诊断价值。
无法开通或支付按量付费属于账号、地域、支付方式或云产品开通状态问题,不应与 CLI 模型列表混为一个故障。先在百炼控制台确认账号可以直接调用并产生计费,再配置 Qwen Code。CLI 只负责发送 API 请求,不能替代云账号完成服务开通。
修复完成应同时满足三点:直接 API 请求使用目标模型成功;Qwen Code 的 /model 能看到并选中相同模型 ID;发送短消息后能收到完整响应。若直接调用成功但 CLI 仍只显示固定模型,应提交 Qwen Code 版本、脱敏配置和启动日志,而不是重新生成更多 API Key。
所以,正确顺序是先确认认证方案,再对齐地域、业务空间、端点和模型 ID,最后检查 Qwen Code 的 provider 配置。只有这条链路全部一致,API Key 才能在 CLI 中稳定使用目标模型。