第一步:设置 API Key 环境变量
Qwen Code 要求 API Key 通过环境变量传入,不能直接写在配置文件里。
编辑 ~/.zprofile 添加如下配置,其中 ailink_API_KEY 作为自定义环境变量名(你也可以改成其他名称,只要和第二步的 envKey 保持一致即可),会作用到第二步的 envKey 参数:
# Qwen Code API Key
export ailink_API_KEY="你的API_KEY"
保存后执行:
source ~/.zprofile
第二步:配置 modelProviders
创建或编辑 ~/.qwen/settings.json,写入以下内容:
Base URL 和模型需替换为实际在NL系统申请的真实API Key数据。
Base URL 末尾必须附带 /v1,否则报错。
envKey参数为第一步环境配置变量名称,非API key值。
| 字段 | 说明 |
|---|---|
id |
模型唯一标识(Model ID),用于 API 请求中指定模型。 |
name |
模型显示名称,在模型列表(/v1/models)中展示。 |
envKey |
环境变量名称,运行时从对应的环境变量中读取 API Key。 |
baseUrl |
API Base URL(接口基础地址),通常填写 https://ailink.nativex.com/v1,即在域名后追加 /v1。 |
| ## 第三步:启动 Qwen Code | |
| 首次运行 qwen 时,默认会进入 Qwen OAuth 认证页面,可用以下命令来告诉它使用 OpenAI 兼容模式。 |
qwen --auth-type openai
{
"modelProviders": {
"openai": [
{
"id": "claude-opus-4.5",
"name": "Claude Opus 4.5",
"envKey": "ailink_API_KEY",
"baseUrl": "https://ailink.nativex.com/v1"
},
{
"id": "gemini-2.5-flash",
"name": "Gemini 2.5 Flash",
"envKey": "ailink_API_KEY",
"baseUrl": "https://ailink.nativex.com/v1"
},
{
"id": "gpt-5.3-chat",
"name": "gpt-5.3-chat",
"envKey": "ailink_API_KEY",
"baseUrl": "https://ailink.nativex.com/v1"
}
]
}
}
字段说明
进入交互界面后,使用 /model 命令即可看到并切换你配置的所有模型。
后续启动直接输入qwen即可打开工具页面。