共计 5639 个字符,预计需要花费 15 分钟才能阅读完成。
安装、版本号和未登录时的报错以我在 Linux 测试机上的输出为准;登录和选模型按官方 1.x 文档转述,没有用账号完成登录。
Qwen Code 是一个开源的终端编程 Agent,仓库在 QwenLM/qwen-code。2026 年 11 月 11 日,它放出了 1.0 Preview:官方说,这次把 Qoder 和 Qwen Code 的 Agent 运行框架合在一起,并单独开了一条预览分支。
同一天,X 上也有人在聊这件事。我只把它当成发现线索的入口。版本、安装地址和限制,还是以官方仓库和 1.x 文档为准。
我在 11 月 13 日下午去装的时候,发现一件很容易踩空的事:稳定版文档、npm 和 1.0 Preview,走的不是同一扇门。稳定版当天刚发到 0.27.3;npm 上的 preview 标签,指的还是 0.27.2-preview.0。按肌肉记忆去敲 npm,装到的不是 1.0。本文核验时稳定版是 0.27.3(截至 2026 年 11 月 19 日最新稳定版为 0.28.0;当时 npm 的 preview 标签是 0.27.2-preview.0,现为 0.28.1-preview.0)。
下面按我在 Linux 测试机上实际跑过的命令写。登录之后怎么提问、怎么改代码,官方步骤我会注明,自己没做的部分不强行补画面。

▲ 示意图:两套安装入口不要走混。Notion 线稿示意,不代表真实安装界面。
· · ·
PART 01
先分清 1.0 Preview 和稳定版 0.27.3
按 1.0 Preview 分支的中文 README,Qwen Code 是终端里的编程 Agent,可以用自然语言让它理解代码、实现功能、排查问题和运行测试。1.0 Preview 融合了 Qoder 与 Qwen Code 的 Agent 运行框架能力。
它现在仍是 Preview。同一份 README 写明:版本稳定前,部分接口、配置和行为可能调整;为集中推进迭代,现阶段暂不接受社区 Pull Request,预计 2026 年 12 月之后再开放。许可证是 Apache 2.0。
官方把预览文档单独放在了 qwen-code-docs 的 1.x 路径。稳定版的中文概览顶部也有一条提示,并链到这份 1.x 文档。我在 2026-11-13 15:10(北京时间)打开稳定版概览时,页面上的 npm 徽章显示的是 v0.27.3,Linux 安装命令指向的是另一套地址:
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
▲ 稳定版文档《Qwen Code 概述》,拍摄于 2026-11-13 15:10(北京时间)。顶部提示 1.0 Preview 要去对应版本文档;页面上的 npm 徽章是 v0.27.3,安装脚本域名是 qwen-code-assets.oss-cn-hangzhou.aliyuncs.com。截图来源:qwenlm.github.io。
同一时间,我在测试机上查询 npm 包 @qwen-code/qwen-code,结果是:
npm view @qwen-code/qwen-code version
0.27.3
npm view @qwen-code/qwen-code dist-tags.preview
0.27.2-preview.0
npm view @qwen-code/qwen-code dist-tags.latest
0.27.3
▲ 2026-11-13 15:09(北京时间)在测试机上执行 npm view 的输出。latest 是 0.27.3,preview 标签是 0.27.2-preview.0,都不是 1.0 Preview。
也就是说,npm 的 preview 标签和仓库里的 1.0 Preview,名字接近,并不是同一趟车。我在 npm 的发布时间记录里,也没有查到 1.0.0、1.0.0-preview 或 1.0.0-preview.1。想试 1.0,要走官方 1.x 文档里的原生安装包。
GitHub 上的预览发布说明也分成了两条。v1.0.0-preview 是 2026-11-11 11:55:44(北京时间)发布的,标记为 Pre-release,写明提供 macOS、Linux 和 Windows 的原生包,不必另外安装 Node.js。第二天 22:25:49,又发了 v1.0.0-preview.1,用来修复订阅账号登录后无法使用订阅模型等问题。我这次装到的,就是后面这一版。

▲ GitHub Release「Release v1.0.0-preview.1」,拍摄于 2026-11-13 15:10(北京时间)。页面标明 Pre-release。发布时间按 GitHub 记录是 2026-11-12 22:25:49(北京时间)。截图来源:github.com/QwenLM/qwen-code。
稳定版并没有停。v0.27.3 的 GitHub Release 时间是 2026-11-13 08:24:34(北京时间),和 1.0 Preview 并行更新。如果你现在要用的是已经熟悉的 npm 流程,那仍是稳定版这条线,而不是 1.0 Preview。
· · ·
PART 02
Linux 上我怎么装到 1.0.0-preview.1
打开 1.x 安装文档 → 下载对应系统的官方包并核对校验值 → 安装后执行 qwen --version
1.x《安装与更新》 给的 Linux / macOS 命令是:
curl -fsSL 'https://qwen-code.oss-accelerate.aliyuncs.com/install.sh' | bash注意域名是 qwen-code.oss-accelerate.aliyuncs.com,和稳定版文档里的 qwen-code-assets.oss-cn-hangzhou.aliyuncs.com 不是同一处。官方文档还要求安装后先执行:
qwen --version
qwen --help并写明:使用文档前先核对版本;旧版本的配置、认证流程和命令可能不同。

▲ 官方 1.x 文档《安装与更新》,拍摄于 2026-11-13 15:10(北京时间)。Linux 命令指向 qwen-code.oss-accelerate.aliyuncs.com/install.sh,并要求先运行 qwen --version。截图来源:qwenlm.github.io。
官方写的步骤是把安装脚本直接交给 bash。我先把脚本和发行清单下载下来看过,确认它会按系统下载对应归档、用 SHA-256 校验,并且只解出 ./qwen 这一个程序。接着我从 GitHub Release 下载了 1.0.0-preview.1 的 qwen-linux-x64.tar.gz,大小是 68170863 字节,校验值与官方清单一致:
2e23d74508f14846fff9a4350349cc04dd891804db179c3bcb726665bdacde6d解出二进制后,先看到了版本号,再执行官方安装器提供的安装命令,并加了 --skip-path,没有改当前环境的 PATH:
./qwen --version
qwen install --version 1.0.0-preview.1 --skip-path安装程序输出:Qwen Code 1.0.0-preview.1 installed. 可执行文件被放到当前用户目录下的 .local/bin/qwen。随后我用这份安装好的程序核对了两次:
qwen --version
1.0.0-preview.1
qwen update --check
Checking for updates...
Qwen Code is up to date (1.0.0-preview.1).这几条命令是 2026-11-13 15:08 到 15:10(北京时间)在 Linux x86_64 测试机上跑完的。update --check 只检查更新,不安装,这点和 1.x 文档一致。

▲ 2026-11-13 15:10(北京时间)本机命令输出。校验值与官方发行清单一致;安装后 qwen --version 和 qwen update --check 都指向 1.0.0-preview.1。

▲ 示意图:先核对包,再看版本。Notion 线稿示意,不是真实终端。
🍎 还没执行 qwen install、只是临时运行解出来的二进制时,qwen update --check 会提示:原生更新需要一次原生安装。这是我实际看到的。完成 qwen install 之后,这条提示就没有再出现。
官方文档还写了 qwen update 和 qwen rollback 只管理原生安装;如果是用 npm 或 Homebrew 装的,要回到对应的包管理器去更新。我这次走的是原生安装,没有再用 npm 装一份,免得两套 qwen 抢命令。
· · ·
PART 03
启动后先看到什么,登录官方怎么走
装好以后,官方《快速开始》写的第一步是进入项目目录,运行 qwen。也可以写成 qwen --cwd /path/to/project。
如果出现工作区信任提示,官方要求先确认这是自己的项目,或来自可信来源。原因写得很直白:一旦信任,Qwen Code 就可以在这个目录里读文件、改文件、执行命令,并加载本地配置。
我在一个只有 README 的测试目录里启动过一次,确实先看到了「是否信任这个文件夹」的确认,选项是 Trust folder,或 Don’t trust and exit。我没有选择信任,也没有继续往下登录。
官方写的下一步是用 /auth 连接模型服务。/connect 和 /login 是同一命令的别名。 1.x《登录与认证》 把入口列成六项:
| 入口 | 官方写的连接方法 |
|---|---|
| Qoder | 按提示完成 Qoder 账号登录 |
| Qwen Account | 按提示完成 Qwen 账号订阅登录;当前对话框要求有效的 Plus 或 Pro 套餐 |
| QwenCloud | 选择提供的 Token Plan 或标准 API Key 连接 |
| Alibaba Cloud Model Studio | 选择提供的 Coding Plan、Token Plan 或标准 API Key 连接 |
| Other Providers | 选择可用预设,并填写对应服务商的凭据 |
| Custom Provider | 配置兼容端点、协议、凭据和模型 |
官方同时写明:账号登录和 API Key 是不同的连接方式;拥有账号订阅,不等于自动获得另一个 API 端点的调用权限。可用范围、价格、额度和活动权益由服务商决定,文档不承诺这些权益。
我在启动画面里看到的连接列表,和上面这张表是对得上的。Qoder 那一项下面还有一句英文说明:Sign in to claim free Qwen model access during a limited-time promotion. 这是界面当时显示的文案。我没有登录,也没有向官方核对活动规则,所以不知道现在能不能领、能领多久。正文只记下看到了这句宣传,不把它写成已经兑现的福利。

▲ 示意图:六个官方连接入口。Notion 线稿示意,不是登录界面,也不代表活动规则。

▲ 官方 1.x 文档《登录与认证》,拍摄于 2026-11-13 15:10(北京时间)。表格列出六个入口,并写明文档不承诺活动权益。截图来源:qwenlm.github.io。
连接完成后,官方步骤是打开 /model,选择当前连接可用的模型,先发一个简短请求验证连接,再开始较长任务。这些我都没有做。
没登录时,命令行的反应很直接。同一天下午 15:09,我在测试目录里跑了两条:
qwen --list-models
Warning: no models available.
qwen -p "介绍一下这个项目,不要修改文件。"
Main model "auto" of provider "qoder" not found in its catalog. Run /auth to sign in again, or /model to choose another model.
▲ 2026-11-13 15:09(北京时间)未登录时的本机输出。--list-models 没有可用模型;-p 提示需要 /auth 或 /model。
没模型时它直接停住,倒也清楚。
🍎 官方还提醒:在自动化脚本里使用 -p 之前,要先配置好认证和权限,不要假定运行期间还能弹出交互式授权框。密钥应放在环境变量里,不要写进项目配置,更不要提交到仓库。
· · ·
PART 04
装完以后可以先做什么,以及谁适合现在就试
如果你已经完成 /auth 和 /model,官方建议先做范围明确的小任务。1.x《快速开始》给的例子是:先让它解释项目如何启动、测试在哪里定义,并要求它先读相关文件、在说明里给出路径;然后再提一处具体修改,例如为空的项目名称补校验,并运行相关测试。
批准工具操作前,官方要求先看清权限提示。完成后可以用 /diff 查看改动,用 /help 查看可用命令。退出之后,回到同一项目目录,可以用 qwen --continue 继续最近的会话,或用 qwen --resume 选择历史会话。官方也写了:会话历史不能替代 Git 或备份。
这些步骤我都没有在登录后实际走完。当前能确定的,只是安装和版本核对已经完成;没有模型时,它不会进入改文件的流程。
谁适合现在就试 1.0 Preview:
- 想在 Linux、macOS 或 Windows 上先拿到官方原生包,并接受 Preview 期间界面和配置还可能调整的人。
- 已经有 Qoder、Qwen Plus / Pro,或准备使用 QwenCloud、阿里云模型服务或兼容端点的人。
- 愿意先在自己的小目录里看信任提示和
/auth列表,再决定把哪些项目交给它的人。
如果现在只想继续用 npm 里那条已经熟悉的稳定版线,不必为了「1.0」这三个字符改过去。稳定版当天还在发 0.27.3,官方也把两条线分开维护。等你准备试 Preview 时,记得先看 qwen --version,确认它真的是 1.0.0-preview.1 这一串,而不是 npm 上的稳定版或 preview 标签(当时是 0.27.2-preview.0,截至 2026 年 11 月 19 日 preview 标签为 0.28.1-preview.0)。




