Qwen Code 是这批智能体里最容易接自定义模型的之一:支持 OpenAI、Anthropic、Gemini 三种协议,而且可以同时配置多家服务,用 /model 随时切换。
最快的方式:/auth
在会话里运行 /auth,按提示选择服务商、填 Key 即可,适合大多数人。下面介绍手动配置,方便你理解和批量管理。
用环境变量配置
以 OpenAI 兼容协议为例:
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 的环境变量名:
{ "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。本地模型需要支持工具调用,智能体才能正常读写文件。