Qwen Code 使用方法：安装、/auth、日语化与 API 设置

Qwen Code 是由 Alibaba 的 Qwen 团队发布的开源（Apache-2.0）AI 编程代理。使用流程分为 4 个阶段：“安装 → 在项目中启动 qwen → 使用 /auth 设置连接目标 → 请求任务”。不过，由于免费 Qwen OAuth 额度已于 2026 年 4 月 15 日结束，即使按照此前的说明登录，也无法免费运行。本页将按照当前的 /auth 菜单，依次说明入门方式、切换为日语显示、用于使用 Claude 或 GPT 的自定义设置，以及常用命令。最新版是于 2026 年 9 月 29 日发布到 npm 的 v0.24.7，发布频率每周至少一次，因此请使用 qwen --version 确认你本地的版本。

安装

这是官方 README 中的步骤。使用独立安装程序时，无需自行准备 Node.js。只有使用 npm 时才需要 Node.js 22 或更高版本。

# macOS / Linux（公式のスタンドアロン インストーラー）
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（Node.js 22 以上が必要）
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 /path/to/your-project
qwen

# セッション内で：
/language ui ja-JP          # 画面表示を日本語に
/language output Japanese   # モデルの回答を日本語に
/auth                       # 接続先と API キーを設定

/language ui ja-JP 会将界面切换为日语，之后的界面会显示“認証方法を選択”（选择认证方法）、“ツール承認モード”（工具批准模式）等 Qwen Code 自有的日语文本。本页面也使用相同的表述。回答语言与 UI 语言分开，可通过 /language output Japanese 指定。

除终端外，还提供桌面应用、在浏览器中打开的 Web UI（qwen serve --open，实验性功能）、面向 VS Code、Zed 和 JetBrains 的集成，以及用于脚本和 CI 的无头执行（qwen -p "..."）。这些都包含在同一个免费仓库中，推理费用另计。

使用 /auth 选择连接目标

打开 /auth（别名 /login）后会进入“选择认证方法”界面，顶层选项有三个。尝试选择 Qwen OAuth 时，会显示“退出 — 请切换到 Coding Plan 或 API Key”。

ModelStudio 的三种方式并不是同一种账单支付方式的不同变体。文档为每种方式分配了不同的端点和不同的密钥；如果密钥类型与 baseUrl 不匹配，就无法运行。截至 2026 年 10 月 1 日，Coding Plan 显示“数量有限、先到先得，每日 0 时（UTC+8）补充”，因此有些日子可以申请，有些日子不能申请。Coding Plan 的一次请求在内部会变成多次模型调用；据 Alibaba 称，简单任务消耗 5～10 次，复杂任务消耗 10～30 次以上。费用比较方式在英文版 Qwen Code pricing 中有详细说明。

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

Qwen Code 的认证文档建议使用 ~/.qwen/settings.json 的 modelProviders，以连接 OpenAI、Anthropic、Google、OpenRouter 以及自有端点等第三方服务。对于 Kunavo，设置如下。

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

# キーは settings.json に直接書かず、.qwen/.env か環境変数に
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

有四点需要牢记。

• baseUrl 只能到 /v1。模型提供商参考明确写道：“指定 API 的 /v1 路径，而不是 /v1/chat/completions。请求路径会由 SDK 添加。”如果连路径一起写入，结果会是 404，而不是认证错误。
• 密钥的存放位置。Qwen Code 会从环境中读取由 envKey 指定的变量名。优先级依次为 shell 的 export、.env（推荐使用 .qwen/.env，且只读取最先找到的 1 个文件）、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_search 由连接目标决定。它使用 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 Checkout 中使用银行卡（Visa、Mastercard、American Express、JCB）、Apple Pay、Google Pay 和 Link。请查看账单说明，然后创建账户并生成密钥。完成首次请求后，最好在使用记录中确认实际扣款金额。

常见问题

2026 年 10 月 1 日确认：Qwen Code 的 README、认证、模型提供商、命令和 web_search 文档（main 分支）、日语 UI 字符串（packages/cli/src/i18n/locales/ja.js）、npm 中的 @qwen-code/qwen-code 0.24.7，以及 Alibaba Cloud 的 Coding Plan 和 Token Plan 页面。Kunavo 尚未针对其自有端点运行 Qwen Code。