开源的终端 AI 编程代理，针对 Qwen3-Coder 模型优化，支持 MCP 协议与多 IDE 集成，提供每日免费额度与 Agentic 工作流。
项目概述#
Qwen Code 是由 QwenLM 团队推出的命令行 AI 代理工具，基于 TypeScript 构建，专为 Qwen3-Coder 模型优化。该工具能够理解大型代码库、执行 Shell 命令、操作文件系统，并通过 MCP（Model Context Protocol）连接外部数据源。
核心定位：终端优先的 AI 编程代理，针对 Qwen3-Coder 模型进行 Prompt 适配与解析优化。
核心能力#
代码开发辅助#
- 代码生成与编辑：从自然语言描述生成代码片段、函数或完整文件
- 代码库导航：通过语义分析回答项目结构、模块依赖等问题
- 调试与修复：解析错误栈，自动定位问题并提出修复建议
- 测试生成：自动为指定模块生成单元测试
- 文档维护：辅助生成 README 或代码注释
Agent 与自动化#
- Agentic Workflow：支持定义 Skills 与 SubAgents，处理多步骤复杂任务
- Shell 交互：在权限控制下执行终端命令（需用户确认）
- 自动化脚本：批量处理 lint 修复、代码格式化等重复任务
连接与扩展#
- MCP 协议：作为客户端连接 Google Drive、Figma、Slack 等外部工具
- 多模型支持：兼容 OpenAI、Anthropic、Gemini API 格式
- SDK 支持：提供 TypeScript SDK 与 Java SDK
主要特性#
- 多协议支持 + 免费额度：支持 OpenAI / Anthropic / Gemini 兼容 API；Qwen OAuth 每天提供 1,000 次免费请求
- 开源协同进化：框架与 Qwen3-Coder 模型均为开源，同步迭代
- 终端优先 + IDE 友好：为命令行用户构建，可选 VS Code、Zed、JetBrains IDE 集成
- 多语言 UI：zh-CN、en-US、ru-RU、de-DE 等
典型用例#
- 从自然语言描述构建功能
- 调试并修复问题（描述 bug 或粘贴错误信息）
- 导航与理解任意代码库
- 自动化重复任务（修复 lint、解决合并冲突、编写 release notes）
- Git 交互式操作（查看变更、提交、创建分支、解决合并冲突）
- 代码重构与测试生成
安装方式#
前置条件：Node.js ≥ 20
# NPM（推荐）
npm install -g @qwen-code/qwen-code@latest
# Homebrew（macOS, Linux）
brew install qwen-code
# 快速安装脚本（Linux / macOS）
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh | bash
快速开始#
# 启动交互式会话
qwen
# 会话内命令
/help # 查看帮助
/auth # 配置认证（推荐 Qwen OAuth，每日免费 1000 次）
/model # 切换模型
/mcp # 管理 MCP 服务器
/tools # 显示可用工具
架构设计#
采用 Frontend (CLI) + Backend (Core) 分离架构：
- packages/cli：输入处理、历史管理、显示渲染、主题/UI 定制、配置管理
- packages/core：API 客户端、Prompt 构建、工具注册与执行、状态管理
- packages/sdk-typescript：TypeScript SDK 编程式访问
- packages/sdk-java：Java SDK
- packages/vscode-ide-companion：VS Code 扩展
- packages/zed-extension：Zed 编辑器扩展
性能基准#
Terminal-Bench 测试结果：
- Qwen Code + Qwen3-Coder-480A35: 37.5%
- Qwen Code + Qwen3-Coder-30BA3B: 31.3%