Qwen Code 使用方法：安装、账户与模型选择、API 设置

Qwen Code 是 Alibaba Qwen 团队发布的开源（Apache-2.0）AI 编码代理。使用流程分为四步：“安装 → 在项目中运行 qwen → 使用 /auth设置连接目标 → 请求任务”。不过，免费 Qwen OAuth 等级已于 2026 年 4 月 15 日结束，因此按照此前的使用方法登录后将不再免费运行。还有一点是韩语用户需要首先知道的：Qwen Code 没有韩语 UI。本页面将依次介绍当前 /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 output Korean   # 모델 답변을 한국어로 (UI는 한국어 미지원)
/auth                     # 공급자와 API 키 설정

内置 UI 语言只有简体中文、英语、俄语、德语、日语、巴西葡萄牙语、法语和加泰罗尼亚语，仓库的 UI 翻译文件中也没有韩语（2026 年 10 月 1 日确认）。因此菜单会以英语显示，本页面直接引用屏幕上显示的英文文案。模型回答语言与 UI 无关，可以使用 /language output Korean将其固定为韩语。

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

通过 /auth 选择连接目标

打开 /auth（别名 /login）后，会显示“Select authentication method:”界面，顶层选项有三个。尝试选择 Qwen OAuth 时，会出现“Discontinued — switch to Coding Plan or 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

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/chat/completions根路径，而不是‘/v1完整路径’，请求路径由 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_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、UnionPay）、Apple Pay、Google Pay 和 Link。如果 Checkout 以韩元显示，还可以选择 Kakao Pay、Naver Pay、PAYCO、Samsung Pay 以及不支持海外支付的韩国银行卡（韩元换算中包含 Stripe 2–4% 的货币兑换手续费，使用美元支付可以避免）。不支持 Toss Pay。请查看支付说明，创建账户并生成密钥。完成首次请求后，最好在使用记录中确认实际金额。

常见问题

2026 年 10 月 1 日确认：Qwen Code README、身份验证·模型提供商·命令·web_search 文档（main 分支）、仓库中的 UI 翻译文件列表、npm 上的 @qwen-code/qwen-code 0.24.7，以及 Alibaba Cloud 的 Coding Plan 和 Token Plan 页面。Kunavo 尚未在自家端点上运行 Qwen Code。