SDK 开发

SDK 让应用以程序方式驱动 Qwen Code，但三种语言的传输能力和生命周期契约不同。先决定应用自己启动 CLI，还是连接已有 daemon，再选择接口。

选择入口

入口	运行要求	主要能力与边界
TypeScript query	Node.js 22+，默认使用 SDK 随包 CLI	子进程查询、多轮输入、自定义审批、外部和进程内 MCP
TypeScript DaemonClient	已运行的兼容 qwen serve	HTTP/SSE、注册工作区、共享或新建会话
TypeScript PeerEndpoint	同用户同机 Node 程序，UNIX socket	加入跨会话消息系统；当前不支持 Windows
Python v1	Python 3.10+，外部 qwen	stream-json 进程协议，异步和同步查询；不含 ACP 或 SDK 内嵌 MCP
Java daemon API	Java 11+，与 SDK 匹配的 qwen serve	推荐路径，独立 thread 会话与有界事件观察
Java legacy stdio	外部 qwen-code 0.5.0+	保留的子进程兼容 API

这些 SDK 文档均标注实验或 alpha 范围，不应从一种语言的示例推断其他语言支持同一选项。

查询与控制

• TypeScript 查询和权限、超时与中断。
• TypeScript MCP：把已有服务或应用内工具接入查询。
• DaemonClient：连接工作区、订阅事件、处理调用身份。
• PeerEndpoint：与已运行会话通信。

模型认证仍由实际 CLI 或 daemon 配置处理，SDK 包安装不等于已登录模型服务。示例中的安装命令供使用者在自己的项目执行，凭据通过环境或秘密存储提供。

Python 与 Java

• Python 查询及会话、权限与控制。
• Java 入门、daemon 结果契约与legacy stdio。

共享 UI

• Transcript 状态：事件、排序与重同步。
• 渲染与预览：工具、嵌套与诊断。
• 渐进迁移：兼容与语义测试。