设置 Qwen Code：安装、提供商、德语界面与 API

Qwen Code 是阿里巴巴 Qwen 团队推出的开源 AI 编码代理（Apache-2.0）。配置分为四步：安装，在项目中启动 qwen，通过 /auth 选择提供商，然后提出任务。首先要注意：免费的 Qwen OAuth 额度已于 2026 年 4 月 15 日结束——如果按照旧指南操作，就不能再免费使用。 本页面遵循当前的 /auth 菜单，介绍如何切换为德语、如何为 Claude 或 GPT 配置自有端点，以及重要命令。最新版本为 v0.24.7，于 2026 年 9 月 29 日发布到 npm；每周至少发布一次，请使用 qwen --version 检查你的版本。

安装

这些命令来自官方 README。使用独立安装程序时无需自行提供 Node.js；只有 npm 安装方式强制要求 Node.js 22 或更高版本。

# macOS / Linux (offizieller Standalone-Installer)
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

# Windows (PowerShell)
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

# npm (benötigt Node.js 22 oder neuer)
npm install -g @qwen-code/qwen-code@latest

# Homebrew (macOS / Linux)
brew install qwen-code

之后重新打开终端，使环境变量生效。Qwen Code 最初基于 Google Gemini CLI v0.8.2，但自 v0.1 起独立开发，不再与原项目同步。Gemini CLI 的设置和额度在这里不适用。

首次启动与德语界面

cd /pfad/zu/ihrem-projekt
qwen

# in der Sitzung:
/language ui de-DE        # Oberfläche auf Deutsch
/language output German   # Antworten des Modells auf Deutsch
/auth                     # Anbieter und API-Key einrichten

执行 /language ui de-DE 后，Qwen Code 会显示自己的德语名称，例如“Authentifizierungsmethode auswählen”或“Werkzeug-Genehmigungsmodus”；本页面使用相同术语。回答语言与界面语言相互独立，通过 /language output German 设置。

除了终端外，还有桌面应用、浏览器中的 Web 界面（qwen serve --open，实验性）、适用于 VS Code、Zed 和 JetBrains 的集成，以及用于脚本和 CI 的无头模式（qwen -p "..."）。所有内容都位于同一个免费仓库中；推理费用需另行支付。

使用 /auth 选择提供商

/auth（别名 /login）会打开“Authentifizierungsmethode auswählen”，顶层有三个选项。如果仍想选择 Qwen OAuth，会看到：“已停止——请切换到 Coding Plan 或 API Key”。

三个 ModelStudio 途径不是同一账单的三种付款方式：文档为每种方式提供了独立的端点和密钥，密钥类型必须与 baseUrl 匹配。2026 年 10 月 1 日，Coding Plan 标注为“限量提供，先到先得，每日 0:00（UTC+8）补充”，因此它可能在某一天无法购买。Coding Plan 中的一项任务会消耗多次模型调用；Alibaba 通常称简单任务需要 5–10 次，复杂任务需要 10–30 次或更多。英文页面 Qwen Code pricing 对成本比较进行了详细说明。

使用 Claude 或 GPT：在 settings.json 中配置 Custom Provider

认证文档建议，对于 OpenAI、Anthropic、Google、OpenRouter 等第三方或自有端点，在 ~/.qwen/settings.json 中使用 modelProviders 区块。对于 Kunavo，配置如下：

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI-kompatibel",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

# Den Key nicht in settings.json schreiben, sondern in .qwen/.env oder die Umgebung
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

四个可减少故障排查时间的要点：

• baseUrl 以 /v1 结尾。 Model Providers 参考文档明确说明：应设置为 API 的 /v1 根路径，而不是 /v1/chat/completions——路径由 SDK 自动追加。添加路径会返回 404，而不是身份验证错误。
• 密钥存放位置。 Qwen Code 会从 envKey 所指定的环境变量中读取密钥。优先级为：Shell-export，然后是 .env 文件（推荐 .qwen/.env；只使用找到的第一个文件），最后是 settings.json 中的 env——密钥会以明文存储在那里。
• 文件优先于 CLI 选项。 顺序为：从 /auth 获取的值 → 选定的 modelProviders 条目 → CLI 参数 → 环境变量 → settings.json。因此 --openai-base-url 有时不会生效。旧指南中的 security.auth.apiKey 和 security.auth.baseUrl 已过时。
• 从 Chat Completions 开始。 没有 wireApi 时使用 Chat Completions。使用 "responses" 时，既不会进行端点检测，也不会自动回退。对 modelProviders 的修改也会在运行中的会话中生效（重新打开 /model）。

Kunavo 目录中没有 Qwen 文本模型。 因此这不是使用 Qwen 的更便宜方式，而是通过预付余额在 Qwen Code 中使用 Claude 或 GPT 的方式。Kunavo 也没有亲自让 Qwen Code 连接其端点运行；与英文 Qwen Code 设置页面一样，此配置来自官方文档。试用时请保留一条可用路线。

第一个任务与重要命令

README 大意上建议的第一个任务是：“解释此仓库，并告诉我应该从哪里开始。”这会同时检查文件访问和工具调用——仅仅说一句“你好”无法暴露连接问题。

对于 yolo 和其他自动模式，文档本身警告：只能在可信、隔离或一次性环境中使用。/stats model 中的估算成本由 Qwen Code 自行计算；实际金额请查看提供商的使用记录。

需要了解的限制

• 内置 Web 搜索取决于主机。 它使用 DashScope 的服务器端搜索：ModelStudio Standard API Key 和 Token Plan 启用该功能，检测到的 DashScope 主机上的条目也启用；Coding Plan 禁用（此处未验证），其他主机上的第三方提供商和自有端点也禁用（web_search 文档）。替代方案：MCP 搜索服务器。
• Kunavo 仅提供聊天。 Kunavo 不提供嵌入、语音合成或语音识别模型。Qwen Code 的 Live Voice 无论如何都要求 DashScope 端点，并始终使用自己的密钥，与聊天模型指向何处无关。

试用 Kunavo 时的付款方式

Kunavo 使用无订阅的预付余额，并按 Token 计费。最低充值金额为 $10；Stripe 结账页面支持银行卡（Visa、Mastercard、American Express）、Apple Pay、Google Pay 和 Link，在奥地利还支持 EPS——目前不提供 SEPA 直接借记。Stripe 仅向英国、爱尔兰和芬兰的买家提供 Pay by Bank；在德国目前仅以封闭预览形式提供（Stripe 文档，截至 2026 年 10 月 3 日）。详情请参阅账单；使用账户创建密钥。完成第一次任务后，使用记录会显示实际金额。

常见问题

核查于 2026 年 10 月 1 日：Qwen Code 的 README、认证、Model Providers、命令和 web_search 文档（main 分支）、德语 UI 文本（packages/cli/src/i18n/locales/de.js）、npm 上的 @qwen-code/qwen-code 0.24.7，以及 Alibaba Cloud 关于 Coding Plan 和 Token Plan 的页面。Kunavo 未让 Qwen Code 连接其端点运行。