跳到正文
funcoding.ai
← Qwen Code

Qwen Code · 自定义模型

Qwen Code 配置自定义模型:阿里云百炼、DeepSeek、本地模型都能接

通过环境变量或 ~/.qwen/settings.json 的 modelProviders 配置多家模型服务,包括百炼 Coding Plan 的地址和多协议示例。

1 分钟读完

Qwen Code 是这批智能体里最容易接自定义模型的之一:支持 OpenAI、Anthropic、Gemini 三种协议,而且可以同时配置多家服务,用 /model 随时切换。

最快的方式:/auth

在会话里运行 /auth,按提示选择服务商、填 Key 即可,适合大多数人。下面介绍手动配置,方便你理解和批量管理。

用环境变量配置

以 OpenAI 兼容协议为例:

Terminal window
export OPENAI_API_KEY="sk-..."
export OPENAI_BASE_URL="https://你的服务地址/v1"
export OPENAI_MODEL="模型名"
qwen

支持的环境变量:

协议 变量
OpenAI 兼容 OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL(也可写成 QWEN_MODEL)
Anthropic ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL
Gemini GEMINI_API_KEY、GEMINI_MODEL
阿里云百炼 DASHSCOPE_API_KEY、BAILIAN_CODING_PLAN_API_KEY、BAILIAN_TOKEN_PLAN_API_KEY

用 settings.json 配置多个模型

配置文件在 ~/.qwen/settings.json。在 modelProviders 下按协议分组列出模型,envKey 指向存放 Key 的环境变量名:

~/.qwen/settings.json
{
"modelProviders": {
"openai": [
{
"id": "qwen3-coder-plus",
"name": "qwen3-coder-plus",
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"description": "Qwen3-Coder via Dashscope",
"envKey": "DASHSCOPE_API_KEY"
}
]
},
"env": {
"DASHSCOPE_API_KEY": "sk-xxxxxxxxxxxxx"
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "qwen3-coder-plus"
}
}

字段说明:

字段 必填 说明
id 是 发给接口的模型名
name 否 在选择器里显示的名字
baseUrl 否 自定义接口地址
envKey 否 存放 API Key 的环境变量名

想同时配置多家,就在 openai、anthropic、gemini 数组里继续添加,启动后用 /model 切换。

阿里云百炼的地址

方案 地址
Coding Plan(中国站) https://coding.dashscope.aliyuncs.com/v1
Coding Plan(国际站) https://coding-intl.dashscope.aliyuncs.com/v1
Token Plan(北京) https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
Token Plan(新加坡) https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
普通 API Key https://dashscope.aliyuncs.com/compatible-mode/v1

接本地模型

Ollama、vLLM 都提供 OpenAI 兼容接口,把 baseUrl 指向本地地址即可,例如 Ollama 的 http://localhost:11434/v1。本地模型需要支持工具调用,智能体才能正常读写文件。