⌘K

Qwen Code

概述

Qwen Code 支持在 ~/.qwen/settings.json 中配置 OpenAI 兼容 provider. 将 Vtrix 添加为 OpenAI 兼容 provider, 填入 Vtrix Base URL, 并选择 Vtrix 模型即可.

环境要求

  • 使用 npm 安装时需要 Node.js 22 及以上
  • Qwen Code
  • Vtrix API Key, 在 设置 中创建
可选：使用 Vtrix Doctor

也可以先使用 Vtrix Doctor 检查本机 Base URL、API Key 和模型配置。已支持的工具，包括 OpenClaw 和 Hermes，可在确认后一键写入配置。

配置步骤

1

安装 Qwen Code

• 使用安装脚本

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

• 或使用 npm

npm install -g @qwen-code/qwen-code@latest

安装完成后运行：

qwen --version
2

设置 Vtrix API Key

在 ~/.bashrc 或 ~/.zshrc 中加入：

export VTRIX_API_KEY="YOUR_VTRIX_API_KEY"

修改后请重启终端, 或执行：

source ~/.zshrc
3

配置 Vtrix provider

创建 ~/.qwen/settings.json：

mkdir -p ~/.qwen
vim ~/.qwen/settings.json

加入以下配置：

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "id": "qwen3.7-max",
          "name": "Qwen3.7 Max via Vtrix",
          "baseUrl": "https://cloud.vtrix.ai/llm",
          "description": "Qwen3.7 Max routed through the Vtrix OpenAI-compatible endpoint",
          "envKey": "VTRIX_API_KEY"
        }
      ]
    }
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.7-max"
  }
}
Base URL

Vtrix 的 OpenAI 兼容 Base URL 使用 https://cloud.vtrix.ai/llm. Qwen Code 会根据 envKey 从 VTRIX_API_KEY 环境变量读取真实 API Key.

4

启动 Qwen Code

进入项目目录并启动 Qwen Code：

cd /path/to/your/project
qwen

也可以用 headless 模式做一次校验：

qwen -p "请用一句话总结当前项目"

如果 Qwen Code 能正常回复, 说明请求已通过配置的 Base URL 路由到 Vtrix. 也可在 Vtrix 设置 中查看账单或用量.

故障排查

报错：401 Unauthorized

原因： VTRIX_API_KEY 未设置、设置错误, 或当前终端未加载该环境变量.

处理：

echo $VTRIX_API_KEY

如果为空, 请检查 shell 配置并重启终端.

Qwen Code 启动后使用了其他 provider

原因： security.auth.selectedType 不是 openai, 或其他 settings 文件覆盖了用户配置.

处理： 确认 ~/.qwen/settings.json 中包含：

{
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  }
}
报错：model not found

原因： model.name 或模型 id 与 Vtrix 模型 ID 不一致.

处理： 前往 模型页面 复制正确的模型 ID, 然后同步更新 model.name 和对应的 modelProviders.openai.models[].id.

其他配置问题
  • 确认 protocol 是 openai
  • 确认 baseUrl 是 https://cloud.vtrix.ai/llm
  • 确认 envKey 是 VTRIX_API_KEY
  • 修改 ~/.qwen/settings.json 后重新启动 Qwen Code