Qwen Code

2026-10-20 更新（官方仓库 Releases API 逐 tag 核对，一手）：Qwen Code 当前 stable 已推进到 v0.25.3（tag 时间戳 2026-10-19T06:06:37Z，prerelease: false），接替 10-15 的 v0.25.2；同日另有 sdk-typescript-v0.1.21（2026-10-19T07:47:40Z）与 desktop-v0.25.3（2026-10-19T08:06:26Z）两个 tag。上轮记录的 v0.25.3-preview.0（2026-10-16 18:28 UTC）已由预览版转正为 stable，此前「生产请钉 v0.25.2」的建议随之更新为钉 v0.25.3。本站仍未取得 v0.25.3 的官方 Release Notes 正文（Releases API 仅返回 tag 与时间戳），不对本版改动内容作断言，列入待核实。 2026-10-22 复核（官方仓库 Releases API 逐 tag 核对，一手）：stable 仍为 v0.25.3（2026-10-19T06:06:37Z，prerelease: false），连续三日无新 stable。上游三条通道当前位置：stable v0.25.3；preview v0.25.4-preview.1（2026-10-20T22:22:11Z，prerelease: true）；nightly v0.25.3-nightly.20261020.82bd240ad0（2026-10-20T23:20:48Z）。另出现一条新的产品线 tag：cua-driver-rs-v0.26.0（2026-10-21T08:22:02Z，prerelease: true）——从命名看是 CUA（Computer-Using Agent）驱动的 Rust 实现分支，本站未取得其 Release Notes 正文与用途说明，不作任何断言，列入待核实。沿用既有判据：同一版本号同日多 tag 并行是 Qwen Code 的常态，判断 stable 一律读 prerelease 字段，不看 tag 名后缀；生产继续钉 v0.25.3。 2026-10-23 更新（官方仓库 Releases API 逐 tag 一手核对）： 本站 10-22 复核写的「stable 仍为 v0.25.3，连续三日无新 stable」已被推翻——属本站漏检：v0.26.0 已于 2026-10-21T23:20:53Z 发布且 prerelease: false，即在本站 10-22 复核之前就已转正，本站当时未取到该 tag。同一天另有 desktop-v0.26.0（2026-10-21T23:50:15Z）与次日 sdk-typescript-v0.1.22（2026-10-22T00:23:42Z）；nightly 为 v0.26.0-nightly.20261022.bf66a26c97（2026-10-22T22:30:02Z，prerelease: true）。stable 从 0.25.3 直接跳到 0.26.0（minor 升级），生产请改钉 v0.26.0。 本次已取得 v0.26.0 的官方 Release Notes 正文（上轮「未取得正文」的待核实项就此结案）：该版无 breaking changes，条目集中在 managed-agent 部署链路——会话级 Skill / Extension 刷新、本地与 SSH workspace 文件引用、配置模板、只读 --check 预检（输出 PASS / WARN / FAIL / SKIP，失败非零退出）、systemd 单元与单机部署指引、Hosted Turn 恢复改为向 Runtime Broker 取执行证据并把无法证明的结果判为 unknown 而非瞬时故障、附件输入上限 8 MiB，以及 artifacts 记录 agent 创建 / 编辑的文件。上轮列入待核实的 cua-driver-rs-v0.26.0（2026-10-21T08:22:02Z，prerelease: true）仍在且仍为 prerelease，其用途官方未说明，本站继续不作断言。判据修正：本站 10-22 的漏检说明——取 Releases 列表时若 per_page 过小或未按 published_at 排序，会漏掉新转正的 stable；核对时应显式取足够条数并按版本号聚合后读 prerelease 字段。 2026-10-25 更新（官方仓库 Releases API 逐 tag 一手核对 + Release Notes 正文）：v0.26.1 已于 2026-10-24T15:47:58Z 转正为 stable（prerelease: false），当前生产请钉 v0.26.1；同日另有 desktop-v0.26.1（2026-10-24T17:06:46Z）。nightly 为 v0.26.0-nightly.20261023.5a0be33432（2026-10-23T22:33:02Z，prerelease: true）。本次已取得 v0.26.1 的官方 Release Notes 正文（沿用 10-23 结案的读取方式），要点如下。

本版有一条 Breaking Change：官方原文 「fix(qqbot)!: restore per-group session isolation under thread scope」（PR #13882）——QQBot 通道的「按群组隔离会话」在 thread scope 下被恢复。该条目的影响面官方未展开，用了 QQBot 接入的团队升级后应回归一次会话隔离行为，本站不作进一步断言。

其余条目集中在三条线：① daemon 凭据持久化（opt-in）：qwen daemon start --save-token 把 bearer token 存入仅属主可读的文件，qwen daemon token 管理、daemon stop 移除（PR #15023）；② Managed Sessions 的空闲态手动上下文压缩（PR #15104），走公开 API 与 WebShell 的上下文用量弹层，保留审计历史；③ TUI 与 OpenTUI 对齐 Ink（PR #14964 / #15067），输入、编辑、草稿、/statusline 行为统一，新增可配置状态行。另有 Managed Workspace 恢复改为等持久落定再继续、会话列表支持大小写不敏感的标题过滤、MCP server 可不重建会话即改（PR #15119）等。

判据沿用：本站 10-23 已因漏检 v0.26.0 修正过一次——取 Releases 列表必须显式给足 per_page 并按 published_at 排序，再按版本号聚合后读 prerelease。本次按该判据执行，未再出现漏检。生产钉 v0.26.1；nightly 数字更大但不保证稳定。

2026-10-28 更新（v0.26.2，官方仓库 Releases API 逐 tag 一手核对 + Release Notes 原文）：又一次 minor 内的小步推进，但带一条破坏性变更。

• v0.26.2 已于 2026-10-27T15:32:11Z 转正为 stable（prerelease: false），接替 10-24 的 v0.26.1，当前生产请钉 v0.26.2。同日另有 v0.26.2-preview.1（15:24:38Z）与 sdk-typescript-v0.1.24（16:08:25Z）两个 tag；nightly 为 v0.26.1-nightly.20261026.34769f9d41（2026-10-26T22:32:18Z，prerelease: true）。
• 本版有一条 Breaking Change，官方原文：fix(managed-agent)!: simplify Web Shell controls and retire cwd submissions（PR #15616）——Web Shell 控件被简化，cwd 提交（cwd submissions）被废弃。该条目的影响面官方未展开，用脚本或外部集成提交 cwd 的团队升级后应回归一次，本站不作进一步断言。
• 其余条目集中在三条线：① 权限与审批——managed 会话新增会话级权限规则与 Auto approval（PR #15448）；② agent loop——新增实验性共享 agent loop 并可在其上 headless 运行（PR #15369），managed 轮次中的消息改为持久化队列，可投递、编辑、撤回、恢复（PR #15449）；③ OpenTUI 与恢复——会话恢复后保留文本、图片、工具结果与 prompt 身份，rewind 恢复 transcript / request / draft（PR #15384），编辑审批处完整 checkpoint 捕获与安全恢复（PR #15389）。
• 另有四条偏运维：automation.scanner-threads 专用扫描线程池（PR #15442）、/autofix-pr status 列出全部 watch 并可跨会话恢复（PR #15510）、opt-in 的 external-scratch Runtime provider（PR #15261），以及给 QwenCloud / 千问平台请求加 X-DashScope-Source-Config 标识来源，不改变鉴权与重试（PR #15041）。

行动建议：① 生产改钉 v0.26.2；② 在 managed-agent 里用过 Web Shell 的，升级后先回归一次控件与 cwd 提交路径——这是本版唯一明示的破坏性变更；③ 没碰 managed-agent 的个人用户，本版基本无感，可按常规节奏升级。详见 10-28 版本复核资讯。

2026-10-29 更新（v0.26.3 转正，官方仓库 Releases API 逐 tag 一手核对 + Release Notes 原文）：官方 Breaking Changes 一节首次写明「No known breaking changes」。

• v0.26.3 已于 2026-10-28T14:36:14Z 转正为 stable（prerelease: false），接替 10-27 的 v0.26.2，当前生产请钉 v0.26.3。同日另有 sdk-typescript-v0.1.25（16:16:39Z）与 desktop-v0.26.3（16:51:11Z）两个 tag；v0.26.3-preview.0（2026-10-27T19:08:34Z）为 prerelease。
• 官方 Release Notes 的 Breaking Changes 一节原文写着「No known breaking changes」——这是本站连续复核 v0.26.1 / v0.26.2 之后第一次看到该措辞。但措辞是「no known」（未见已知），不是「no」（无），本站仍建议升级后跑一次既有流程回归，不要把这句话当成「可以闭眼升」。
• 六条 Highlights 归到三条线：
  • UI 卡片：生成的 UI 卡片在历史导航、会话切换、分屏变化之间保留输入、控件与运行时状态，初次计算后直接显示实时视图，且只对能渲染 MCP Apps 的客户端出现（PR #15611 / #15787 / #15720 / #15790）。
  • 上下文与工具调用：工具结果在自动压缩前先收缩到剩余可用空间（PR #13599）；qwen-latest-series- 与 qwen4 别名按 1M token 上下文识别（PR #15758 / #15762）；合法 XML 工具调用在参数里引用其他调用标记时可被恢复，畸形块被隔离、被引用的示例不会被派发（PR #13579）。
  • 会话与自动化：持久化会话 Workflow 模式可通过 --workflow-mode on、/workflows mode on、SDK 与 ACP 开启，且模式切换会传递到 CLI 沙箱（PR #15422 / #15743）；ACP 与 daemon 客户端在重试、取消、checkpoint、录制与通知中保持 rewind 身份一致，SDK 帧保留子 agent 身份（PR #15441 / #15657）；/autofix-pr start 在 PR 头部有未推送提交或未提交改动时停止执行（PR #15736），避免 watch 覆盖你看不见的工作。
• 另有 opt-in 的 memory 提取节奏（在无操作运行后触发，PR #13571）、Web Shell 的 composerVariant simple 紧凑输入（PR #15663）等。

行动建议：① 生产改钉 v0.26.3；② 用 /autofix-pr start 的，确认本地分支干净再启动——本版新增的这条停止条件是保护性的，但会改变既有脚本的预期；③ 依赖 UI 卡片跨分屏保持状态的，本版是正收益，值得升级；④ 脚本里按别名选模型的，qwen4 与 qwen-latest-series- 现在按 1M 上下文识别，成本估算要跟着改。详见 10-29 版本复核资讯。 2026-10-30 更新（v0.26.4，官方 Release Notes 原文一手核对）：一次「无已知破坏性变更」的功能版，主线在 web-shell 与 managed worktree。

v0.26.4（2026-10-29T14:29:11Z 发布，prerelease: false）是当前 stable，接替 10-28 的 v0.26.3。 Breaking Changes 官方原文只有一句："No known breaking changes." 按本站纪律，这是**「未见已知破坏性变更」，不等于「没有破坏性变更」**，照抄原措辞，不替官方收紧口径。

值得记的四条： ① generated-ui 跟随宿主主题，并对卡片框架做了本地化与形态调整（#15798、#15803）——自动生成的界面不再自带一套与宿主冲突的配色； ② managed 侧为主会话引入独立 worktree（#15745），配合 web-shell 的「无 workspace 会话与 workspace 并列」（#15319）与「允许嵌入方选择 workspace 目录」（#15296），多会话并行时的目录隔离更清楚； ③ 扩展支持无 scope 的 npm 安装与更新（#15781），CLI 侧提高了 workspace 技能安装上限（#15030）； ④ web-shell 把模型耗时直接显示进 Token Usage（#15774），并把 Generated UI 卡片变成可交互视图（#15831）。

三条并行发布线：同日还有 desktop-v0.26.4（2026-10-29T15:18:19Z）与 sdk-typescript-v0.1.26（2026-10-29T15:29:54Z），与本 CLI 主版本线并行，本站未逐条读取其正文，不作改动断言。 本站未做安装与实测；上版 v0.26.2 的 managed-agent Web Shell 控件简化与 cwd submissions 废弃是否在本版完全收敛，官方未说明。

行动建议：① 生产改钉 v0.26.4；② 用 managed-agent 多会话并行的，本版的独立 worktree 是正收益；③ 写过扩展安装的，无 scope npm 安装是新支持项，值得复查一遍安装脚本。 2026-10-17 更新（官方仓库 Releases API 逐 tag 核对，一手）：Qwen Code 当前 stable 已推进到 v0.25.2（2026-10-15 15:41 UTC 发布），接替 10-11 的 v0.25.1；v0.25.3-preview.0（2026-10-16 18:28 UTC）为预览版，生产请钉 v0.25.2。同日另有两个 tag 并行——v0.25.2-preview.1（2026-10-15 15:40 UTC，比 stable 早 1 分钟）与 v0.25.2-nightly.20261015.c24e99e9cb（2026-10-15 22:09 UTC）。本站未取得 v0.25.2 / v0.25.3-preview.0 的官方 Release Notes 正文（Releases API 仅返回 tag 与时间戳），不对本版改动内容作断言，列入待核实。 选版提醒（与上游同理）：nightly 的数字与 stable 同源但稳定性不保证，生产请钉 v0.25.3 这一档；同一天内多 tag 并行是 Qwen Code 的常态，核对时务必看 tag 名后缀与发布时间戳，而不是版本号大小。参见 Gemini CLI 卡片里「别被版本号大小误导」一节——两者同源（Qwen Code 自 Gemini CLI v0.8.2 fork），通道习惯一致。 本站未取得 v0.25.0 / v0.25.1 的官方 Release Notes 正文（Releases API 只返回 tag 与时间戳）。第三方周报称 v0.25.0（10-05）引入了本地 workspace agent 协作、A2A 共享、内置 Mem0 记忆与托管式工具审批钩子，该项为二手转引，列入待核实，未写入确定结论。

2026-11-02 更新（v0.26.5，官方 Release Notes 原文一手核对）：Breaking Changes 仍写「No known breaking changes」，但有一条默认值迁移和一条判定变更。

v0.26.5 于 tag 时间戳 2026-11-01T03:22:50Z 转正为 stable（prerelease: false），接替 10-29 的 v0.26.4，当前生产请钉 v0.26.5。同日另有 desktop-v0.26.5（2026-11-01T03:59:58Z，prerelease: false）；cua-driver-rs-v0.27.0（2026-10-30T06:32:17Z）仍为 prerelease，用途官方未说明，本站不作断言。 Breaking Changes 官方原文："No known breaking changes." 沿用本站口径：这是**「未见已知破坏性变更」，不等于「没有破坏性变更」**。

两条需要单独拎出来的，都不是新功能： ① Generated UI 默认开启——原文 "Enables Generated UI by default and lets users continue chatting with interactive card values attached as removable context above the composer." 配置不用改，UI 行为照样变；更要紧的是会话里会多出一块**「可移除但会参与后续轮次」**的卡片上下文，做上下文审计（/context、memory）时要把它算进去。 ② /autofix-pr 新增重试预算——原文 "Adds a retry budget to /autofix-pr so a check left failing after three fix pushes is handed to a human and shown in /autofix-pr status." 三次修复推送后仍在失败的检查，交给人。这正是本站反复命中的「改变『什么算完成』的判定」一类：既有自动化流水线会从「可能一直重试」变成「三次后停下并标记」。该预算是否可配置官方未说明，列为待核实。

其余值得记的：/verify-pr 的本地流程只在当前工作树是 PR head 的干净检出时才复用它（脏树会重新准备）；PR watch 在 CI 失败可能由分支落后引起时先合并陈旧 base；/autofix-pr 在被阻塞时会在 PR 上留言说明尝试了什么、卡在哪、需要人做什么；新增 --in-place 模式，可在你的检出里协同驱动、推分支并在 PR 上回复；channel adapters 可向 agent 会话暴露工具并新增 QQ moderation 工具（由 moderationTools 控制）；managed 侧新增实验性的一键 Helm 部署（Hosted Harness + MySQL + 本地执行 + 认证网关）。

行动建议：① 生产改钉 v0.26.5；② 升级后先看 composer 上方的 Generated UI 卡片，确认它是否进入你的上下文统计；③ 用 /autofix-pr 的确认「三次后交给人」的新行为与你的流水线、机器人账号权限匹配；④ 习惯用脏工作树跑 /verify-pr 的会多一次准备步骤。详见 11-02 版本复核资讯。 2026-11-03 更新（v0.26.6，官方 Release Notes 原文一手核对）：Breaking Changes 仍写「No known breaking changes」，但 Bug Fixes 里藏着三条行为变更——本站该判据第四次命中。

v0.26.6（tag 时间戳 2026-11-02T18:22:40Z，prerelease: false）是当前 stable，接替 11-01 的 v0.26.5，生产请改钉 v0.26.6。同日另有 sdk-typescript-v0.1.27（2026-11-02T19:09:07Z，prerelease: false）；cua-driver-rs-v0.27.0（2026-10-30T06:32:17Z）仍为 prerelease，用途官方未说明，本站不作断言。

Breaking Changes 官方原文："No known breaking changes." 沿用本站口径：「未见已知」不等于「没有」。

⭐ 三条写在 Bug Fixes 里、实为行为变更的条目（升级前必读）： ① MCP 工具发现的冲突处理变了——原文 "MCP tool discovery now skips duplicate tool names but keeps all uniquely named tools, preventing one name collision from hiding an entire server's tools." 含义：升级前若两个 MCP server 有同名工具，其中一个 server 的整批工具会被静默吞掉；升级后这些工具会重新出现。这不是「修好了」这么简单——你的 Agent 可用工具集会变大，审批面、权限面与提示词里写死的「可用工具清单」都要复查一遍。 ② LSP 跳转不再静默返回空——原文 "LSP code-navigation queries now fail with an explicit reason when no language server is ready instead of returning empty results." 此前「跳不过去」表现为无结果（容易被当成「这个项目没有该符号」），现在会显式报错。 依赖「返回空就走 fallback」的自动化脚本需要改判据。 ③ OAuth 刷新锁的清理加了归属判断——原文 "OAuth refresh lock cleanup now removes the lock only when the current process owns it, preventing exiting processes from deleting active refresh locks." 含义：并发多进程场景下「退出时把别人的锁删了」这类偶发鉴权抖动会减少；反过来，自己残留的锁也不会被别人的进程顺手清掉——排障时别再指望重启一个实例就能解锁。

⭐ 一条与本站今日另一条更新直接互证的条目："Fixes Kimi K3 generation recognition so supported IDs use the 1,000,000-token context window, while k3-256k keeps its 256K window." —— Qwen Code 侧确认了 K3 系列为 1M 上下文、k3-256k 为 256K，与本站 Kimi K3 模型卡（2026-11-03 取得官方技术博客原文、1M 上下文）口径一致。跨工具的上下文窗口认错会直接导致长代码库任务静默截断，这是最容易不报错的一类故障。

其余值得记的（均为 Web Shell / 托管侧）：新增 Web Shell 侧边栏活动视图（审批 / 输入 / 错误状态、未读完成、运行中工作、批量已读与归档）；会话菜单可 「Add to Split View」；Token Usage 面板新增请求成功率、输出速度、逐模型成功指示与配色，并绘制逐请求输出速度、首 token 延迟与失败详情；composer 上方新增可关闭的 Workflow chip（关闭即退出 Workflow 模式、工具不可用时告警）；开启 experimental.unifiedAgentLoop 后更多 ACP 轮次走共享循环；mods 可在 headless 下为 -p 提示与 stream-json 用户消息运行 prompt.submit 钩子（提交前可检查或重写提示）；桌面端新增 Fedora 44 与 RHEL 10 x64 RPM 安装包。

本站未做安装与实测；v0.26.2 的 managed-agent Web Shell 控件简化与 cwd submissions 废弃是否在本版完全收敛，官方未说明。

2026-11-05 更新（v0.26.7，官方 Release Notes 原文一手核对）：项目钩子进信任边界，:exacto 的上下文窗口被修正

v0.26.7（tag 时间戳 2026-11-04T04:03:01Z，prerelease: false）是当前 stable，接替 11-02 的 v0.26.6，生产请改钉 v0.26.7；npm latest 同为 0.26.7，nightly 停在 0.26.5-nightly.20261102。

Breaking Changes 官方原文："No known breaking changes." —— 这是本站连续第三次在同一仓库命中同一模式：标「无破坏性变更」，然后在 Features / Bug Fixes 里改判据。

⭐ 四条会改行为（升级前必读）： ① 仓库自带的 hooks、权限授予、项目级 language server 需要显式目录信任才执行——原文 "Requires explicit folder trust before repository-supplied hooks, permission grants, and project language servers can run"。从「克隆下来就自动跑」变成「默认拒绝」，这是本版对安全面影响最大的一条。 ② .qwen/settings.json 里的项目钩子在交互会话需目录或工作区信任，被拒绝时会给出警告——与①同源，但覆盖的是配置里的钩子，不只是仓库自带的。 ③ grep -n / grep --line-number 现在被识别为参数而不是文件名——原文 "Shell permission analysis now treats grep -n and grep --line-number as flags, so grep file reads are still checked"。此前权限分析可能把它当成「读一个叫 -n 的文件」，导致 grep 读文件绕过检查。 ④ 带 :exacto 的 OpenRouter 模型 ID 保留基础模型名——qwen/qwen3-coder:exacto 现在拿到 262,144 而不是 200K。上下文预算表要重算。

新能力四条：① model.catalogRefresh 变为 operator 级设置，且 privacy.usageStatisticsEnabled: false 现在会连后台目录刷新一起停掉（本地元数据仍可用）；② /verify-pr 新增本地 Docker 方案——不可信 PR 代码跑在容器里，模型凭据留在宿主机，通过 chat-completion 代理转发；③ qwen serve 新增「允许远程连接」开关（Settings → Connections），可远程访问、用 token、断开会话而无需重启；④ Web Shell 新增 Channel 活动页（可筛选、自动刷新的时间线：Channel 活动、跳过原因、回复、任务状态迁移、轮询结果）。

另修：Claude Opus 5.5 / Sonnet 5.5 / Fable 5.1 / Mythos 5.1 上强制工具选择失败的问题（改为避开不支持的强制选型）；Anthropic 兼容请求现在遵循已配置的 transport 超时与 dispatcher（设了更长 API 超时不再被提前中断）；远程访问错误不再向调用方暴露内部细节。

本站未安装、未实测；「目录信任」的判定粒度（是否按 git 根、是否含子目录、如何在无人值守场景预先信任）官方本条未写明。

行动建议：① 生产改钉 v0.26.7；② CI / 自动化里跑 qwen 的，先确认目录信任怎么预置，否则升级后第一次跑会卡在确认；③ 用 :exacto 模型的重新核对上下文窗口与压缩阈值；④ 依赖 grep 做全库检索的，核对权限提示是否重新出现（此前可能被绕过）；⑤ privacy.usageStatisticsEnabled: false 的组织复核目录刷新是否还需要（现在会被一起停）。详见 11-05 版本复核。 行动建议：① 生产改钉 v0.26.6；② 用了两个以上 MCP server 的，升级后第一件事是核对可用工具清单——本版会让此前被吞掉的工具重新出现（①）；③ 脚本里处理 LSP 空结果的改用错误原因判据；④ 在 Qwen Code 里用 Kimi K3 系列模型的，确认上下文按 1M 计、k3-256k 按 256K 计，长仓任务的成本与截断预期要跟着改。详见 11-03 版本复核资讯。 2026-11-06 更新（v0.26.8，官方 Release Notes + PR + 设计文档一手核对）：免费 OAuth 退场，补上 Qwen 订阅登录；同版把项目钩子收进审批门

• v0.26.8 已于 2026-11-05T16:23:57Z 转正（prerelease: false），接替 11-04 的 v0.26.7，生产请钉 v0.26.8。同日另有 sdk-typescript-v0.1.28（17:33:49Z）与 desktop-v0.26.8（18:48:55Z）两个 tag。
• 本版唯一一条 feat 是商业模式变化："feat: add Qwen subscription support across CLI, VS Code, and Desktop"（PR #16378，合并于 2026-11-05T12:44:21Z）。PR 正文写明动机："After the former free OAuth service ended, users needed a way to connect a Qwen subscription…"——此前那条免费 OAuth 通道已经结束，官方给的正规替代是接 Qwen 订阅。
• 三端共用一套凭据：CLI（Ink / OpenTUI）、Desktop、VS Code 共享设备授权、凭据刷新、会员校验与「看套餐 → 激活」流程；仅 Plus / Pro 可激活（大小写不敏感），Free / Lite 等档位名按服务端返回原样保留但不参与激活。订阅覆盖 chat completions 与内置 web search，原有 API Key provider 继续保留。
• 模型目录来自服务端：GET /compatible-mode/v1/models（无 allowlist）；显式登录默认选 qwen3.8-max，而日常启动与模型刷新保留上次选择，不会因服务端下架某模型就静默替换。订阅侧 qwen3.8-max / qwen3.8-flash 明确支持图像与视频输入，服务端返回的其他 ID 在确认网关能力前按纯文本保守处理。
• 档位价格、额度与速率限制官方均未公开——chat.qwen.ai/pricing 为 SPA，抓取只得到应用壳层，无可读价格正文。→ 本文不做任何「比谁便宜」的比较，列入待核实。
• Breaking Changes 一节仍写 "No known breaking changes."——照抄原措辞，是「未见已知」，不是「没有」。
• 同版另一条线是安全收紧（与订阅无关，但更该先看）：项目级 hooks 改为弹审批对话框才执行（#14748）、headless 下的项目钩子信任必须开目录信任特性（#16264）、钩子审批的环境变量限制在工作区内（#16316）、目录信任记录随容器沙箱带入（#16390）。→ 无人值守流水线升级后要重新配一次信任，否则会停在审批那一步。
• 其他值得记的三条：识别 Hugging Face TGI 的上下文溢出错误以触发响应式压缩（#16245）、目录未列出的 Qwen2-VL / Qwen2.5-VL / QVQ 也接受图片输入（#16247）、会话中的日期只由历史告知模型一次（#16362）。

行动建议：① 生产钉 v0.26.8；② 原先靠免费 OAuth 的，先选定订阅或 API Key 其中一条——那条路官方已写明结束；③ CI 里依赖仓库自带 hooks 自动跑的，升级后先补审批与目录信任配置；④ 团队采购前先问清订阅价格、额度与模型清单——这三项目前都没有公开一手口径，问销售比查文档快。详见 Qwen Code 转订阅制资讯。

2026-11-07 更新（v0.26.9，官方 Release Notes 原文 + tag 时间戳一手核对）：Skills 安装补齐批量与回执，托管 agent 的自动化改默认开启

v0.26.9（tag 时间戳 2026-11-06T16:07:57Z，prerelease: false）是当前 stable，接替 11-05 的 v0.26.8。生产请改钉 v0.26.9；npm latest 与 nightly 通道本轮未复核。同日另有 sdk-typescript-v0.1.28（2026-11-05T17:33:49Z）与 desktop-v0.26.8（2026-11-05T18:48:55Z）。

Breaking Changes 一节仍写 "No known breaking changes." —— 照抄原措辞，是「未见已知」，不是「没有」。这已是本站记录的本句连续第六次出现，而每一轮都从中拎出过会改行为的条目。

本版真正会改行为的一条：托管 agent（managed-agent）的 automation 改为默认开启。 官方 PR 标题即 "managed-agent: enable automation by default"（#16448）。含义：托管会话此前需要显式开自动化，现在开箱即自动跑。 与 11-06 那版把项目 hooks 收进审批门的方向相反 —— 一边收紧钩子执行、一边放开托管会话的自动动作，两条线要分开评估。官方未说明默认开启后改了哪些触发条件、是否可关闭，列入待核实。

🆕 Skills 安装与激活：从「能装」补到「可批量、可回执、可恢复」

为什么这组值得看：它把「装 Skill」从一次性动作变成带 attempt ID、回执与恢复备份的事务。此前装失败是不确定态，现在能查「到底装没装」。

GitHub PR 自动化：/verify 能看到评审意见了

• 沙箱化的 /verify 轮次可读 PR 的评审线程，含已解决与已过期的线程（#16300）。含义：验证阶段第一次拿得到「人提过什么意见」这个上下文，而不是只看代码。
• /autofix-pr 拒绝时在 stderr 给机器可读的 refused code 与下一步（#16238）。含义：脚本可以按 code 分流，不必再解析人话。
• GitHub inbound 读取失败改为重试而非直接停，任务存储在恢复后可读时继续跑（#16402）。

其余值得记的：

• 图像输入补一大批：Llama 3.2 Vision / Llama 4 / LLaVA / Pixtral / Mistral Small 3.1 与 3.2 可接受图片（#16311）；Qwen VL 在其 Ollama 名称下也接受图片（#16309）。
• 终端状态上报：交互式 CLI 用 OSC 7501（app=qwen-code）向终端上报 working / blocked / done / error 四态（#16407）。这给了外部工具一个「它现在到底在干嘛」的信号源。
• daemon 内存上限：命令与 Skill 回放改为 8 MiB / 会话 环形缓冲，可用 --event-ring-max-bytes 调整（#16413）。含义：之前长会话的回放内存会一直涨。
• QQ 主动投递：loop 消息、webhook 任务、后台响应、daemon 发送可作为主动群消息发出（#15635）。
• 性能侧：SSH 注册结算与 Session 工作树准备减少串行化；MCP client 的 Google auth 按需加载；普通会话工具执行减少不必要的加锁。

本站未安装、未实测：managed-agent automation 默认开启后的触发条件与关闭方式、/skills/activation 的传播失败如何处理、OSC 7501 在 tmux / screen 下的表现，均列入待核实。

TL;DR

来源说明：本文基于 GitHub（QwenLM/qwen-code）、npm 官方页、以及 morphllm / a2a-mcp 等资料整理。该项目迭代快、鉴权方式有过重大调整，请以最新官方 README 为准。

核心特性

与 Gemini CLI 的血缘

Qwen Code 基于 Gemini CLI v0.8.2 fork，从 v0.1 起停止与上游同步、独立开发。所以二者共享祖先（终端 UI + agent 循环），但如今各走各路——Qwen Code 的新功能不来自 Gemini CLI，反之亦然。

Agentic 能力

• 代码理解与编辑：查询和编辑超出传统上下文窗口的大型 codebase
• 工作流自动化：处理 PR、复杂 rebase 等运维型任务
• 增强 parser：专为 Qwen-Coder 模型优化的解析器
• 视觉模型支持：自动检测输入里的图片，切换到视觉模型做多模态分析
• SubAgents / Agent Teams：分层 agent——主 agent 把聚焦子任务委派给专门 subagent 再汇总
• 内置 skills：/review、/batch、/loop、/bugfix 等命令
• MCP 支持：连外部工具和数据

上下文与会话管理

针对 token 消耗提供会话级控制（在 ~/.qwen/settings.json 配 sessionTokenLimit）：

• /compress：压缩对话历史，在 token 上限内继续
• /clear：清空历史重新开始
• /stats：查看当前 token 使用和上限

Qwen3-Coder 原生 256K 上下文，可外推到约 1M。

安装与鉴权

安装（需 Node.js 20+，npm 官方写 22+）

# npm 全局安装（最通用）
npm install -g @qwen-code/qwen-code@latest
qwen --version

# Homebrew（macOS / Linux）
brew install qwen-code

# 从源码
git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code && npm install && npm install -g .

鉴权（2026-04-15 后免费 OAuth 已停用）

重要变更：Qwen OAuth 已于 2026 年 4 月 15 日停用。现在必须用以下方式之一：

1. API Key（推荐）：阿里云百炼 Model Studio（北京 / 国际站）申请，或任何 OpenAI / Anthropic / Google GenAI 兼容端点
2. 阿里云 Coding Plan：固定月费，配额更高

国内 / 国际免费额度：

• ModelScope（国内）：每天 2000 次免费 API 调用
• OpenRouter（国际）：每天最多 1000 次免费调用

cd your-project
qwen
# 进入交互界面后：
/auth     # 配置 provider / API Key
/help     # 查看命令

国内使用注意事项

1. 中文友好度高：阿里出品，文档和模型对中文场景优化好，是国内终端 agent 的少数优选
2. 免费额度香：ModelScope 每天 2000 次足够个人日常用，且支付宝/微信付费无门槛
3. 不需要代理：用国内 ModelScope / 百炼端点时全程国内网络可达
4. 替代/搭配：要更强模型可接 OpenRouter 转发；纯开源洁癖可看 Aider

与同类怎么选

选 Qwen Code 如果你：

• 国内开发者、想要免门槛 + 中文友好的终端 agent
• 想用 Qwen3-Coder 或免费额度跑日常编码
• 喜欢 Gemini CLI 那套交互、但要更好的国内可用性
• 要开源、可接任意 OpenAI 兼容端点

别选 Qwen Code 如果你：

• 重度依赖 Claude / GPT 的特定能力（去 Claude Code / Codex）
• 想要最极简、模型完全自选的工具（Aider）
• 介意 token 消耗偏高

避坑清单

• 免费 OAuth 已死：2026-04-15 起 Qwen OAuth 停用。老用户升级后会登录失败，必须 /auth 重新配 API Key（ModelScope / 百炼 / OpenRouter 等）。
• token 消耗偏高：官方明确提示——Qwen Code 每轮可能发多次 API 调用，token 用量和 Claude Code 类似偏高。用 sessionTokenLimit + /compress 控制成本，否则免费额度掉得快。
• Node 版本：GitHub 写 20+，npm 写 22+，遇到诡异报错先升到 Node 22 LTS。
• 认准官方包：官方是 npm 的 @qwen-code/qwen-code（binary qwen）和 GitHub QwenLM/qwen-code。网上有同名第三方仓库/教程（如 pip install qwen-code-cli）并非官方，别装错。
• 和 Gemini CLI 不再同步：别指望 Gemini CLI 的新功能会出现在 Qwen Code 里，二者已分家独立演进。
• 视觉切换弹窗：默认开启图片自动切视觉模型，每次会弹确认框；嫌烦在 settings.json 设 vlmSwitchMode。

适合 / 不适合

适合：

• 国内开发者要免门槛、中文友好的终端 agent
• 想白嫖 ModelScope 每天 2000 次免费额度
• Qwen3-Coder 用户
• 喜欢 Gemini CLI 交互但要更好国内体验

不适合：

• 强依赖 Claude / GPT 特定能力
• 极度在意 token 成本（消耗偏高）
• 想要模型完全自选的极简工具（Aider 更纯）

相关阅读

• 同类对比：Gemini CLI / Claude Code / Aider / Codex
• 模型：Qwen3-Coder
• 概念：AI Agent / MCP / Context Rot
• API 转发：OpenRouter

Long-tail quick picks

长尾检索速查：下面三项对应「Qwen Code 开源版 / 免费版 / 国内可用」等搜索意图，方便直接跳转。

Open-source alternatives

• 是否开源：是
• 想找开源替代？看这几个：Trae · Cline · Aider

Free tier

• 是否有免费档：是
• 价格概要：工具开源免费；模型按 API 计费。国内 ModelScope 每天 2000 次免费 / 国际 OpenRouter 每天 1000 次免费
• 预算敏感用户可先用免费档；进阶需求参考 通义灵码 / CodeGeex（国内免费额度更友好）。

China availability

• 是否国内可用：是
• 中文友好度评分：5 / 5
• 国内直连可用，无需代理；访问稳定。

相关替代品：

• gemini-cli
• claude-code
• aider

来源

• GitHub：https://github.com/QwenLM/qwen-code
• npm：https://www.npmjs.com/package/@qwen-code/qwen-code
• 资料：morphllm.com / a2a-mcp.org

本卡片由 AI 之家 编辑部根据官方公开资料整理。所有事实点均标注来源；如发现安装命令 / 鉴权方式 / 免费额度与最新官方信息不一致，请通过 反馈邮箱 反馈。