Qwen Code：终端中的开源AI编程代理

概述

Qwen Code 是一款开源的AI代理，专为终端环境设计，针对Qwen系列模型进行了深度优化。它能够帮助开发者理解大型代码库、自动化繁琐任务并加速交付流程。该项目基于Google Gemini CLI构建，核心贡献在于解析器层面的适配，以更好地支持Qwen-Coder模型。

核心特性

多协议、灵活的提供商支持：支持OpenAI、Anthropic、Gemini兼容API，可接入阿里云百炼平台、OpenRouter、Fireworks AI，或使用用户自有的API密钥。

开源、协同进化：框架与Qwen3-Coder模型均为开源，两者同步发布与迭代。

代理工作流、功能丰富：内置丰富的工具（技能、子代理），提供完整的代理工作流体验，类似Claude Code的交互体验。

终端优先、IDE友好：专为命令行开发者打造，同时可选集成VS Code、Zed和JetBrains IDE。

安装方式

快速安装（推荐）：Linux/macOS用户可通过curl脚本一键安装；Windows用户（以管理员身份运行）可通过PowerShell执行安装脚本。

手动安装：需Node.js 22或更高版本。可通过npm全局安装（npm install -g @qwen-code/qwen-code@latest），或通过Homebrew安装（brew install qwen-code）。

使用模式

交互模式：在项目目录中运行qwen命令，启动交互式终端UI，可使用@引用本地文件。

无头模式：使用-p参数运行，无需交互界面，适用于脚本、自动化和CI/CD场景。

IDE集成：支持VS Code、Zed和JetBrains IDE，可在编辑器内直接使用。

守护进程模式（实验性）：通过qwen serve将Qwen Code作为本地HTTP守护进程运行，使IDE插件、Web UI、CI脚本和自定义CLI共享同一个代理会话，通过HTTP+SSE通信。

SDK支持：提供TypeScript、Python和Java SDK，方便开发者在其基础上构建应用。

认证方式

API密钥（推荐）：支持阿里云百炼平台、OpenAI、Anthropic、Google GenAI等兼容端点。推荐通过编辑~/.qwen/settings.json文件配置模型和提供商。

编程计划：订阅阿里云百炼编程计划，按月付费获取更高配额。

本地模型：支持通过Ollama或vLLM运行本地模型，无需API密钥或云账户。

配置管理

Qwen Code可通过settings.json、环境变量和CLI标志进行配置。用户级配置~/.qwen/settings.json适用于所有会话，项目级配置.qwen/settings.json仅适用于当前项目并覆盖用户设置。

常用配置字段包括：modelProviders（定义可用模型）、env（环境变量回退）、security.auth.selectedType（启动时使用的协议）、model.name（默认模型）。

命令与快捷键

会话命令：/help显示帮助、/clear清除对话历史、/compress压缩历史节省token、/stats查看会话信息、/bug提交错误报告、/exit或/quit退出。

键盘快捷键：Ctrl+C取消当前操作、Ctrl+D退出（空行时）、上下方向键导航命令历史。

基准测试

在Terminal-Bench性能测试中，Qwen Code搭配Qwen3-Coder-480A35模型准确率达37.5%，搭配Qwen3-Coder-30BA3B模型准确率达31.3%。

生态系统

对于需要图形界面的用户，社区提供了AionUi（命令行AI工具的现代GUI）和Gemini CLI Desktop（跨平台桌面/Web/移动端UI）等选择。

技术架构

Qwen Code基于Node.js构建，采用TypeScript为主要开发语言（占比91.2%），同时包含JavaScript、Java、Python等组件。项目托管于GitHub，采用Apache-2.0开源许可证，拥有超过24,000颗星标和400+贡献者。

总结

Qwen Code作为一款开源终端AI编程代理，凭借其灵活的认证方式、多模式使用体验、丰富的IDE集成和强大的模型支持，为开发者提供了高效、便捷的编程辅助工具。无论是日常开发、代码审查还是自动化任务，Qwen Code都能显著提升开发效率。