qwen-code

说句话，代码自动写出来；想换哪个模型随便切。

开源的 AI 编程智能体，直接驻留在你的终端中，随时待命，帮你完成代码编写、重构与调试，让编程效率大幅提升。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 28068

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队QwenLM

所属国家

官网地址https://qwenlm.github.io/qwen-code-docs/en/users/overview

GitHubhttps://github.com/QwenLM/qwen-code

定价模式free

价格说明开源项目，基于Apache-2.0许可证，可免费使用和部署，无付费版本。

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型agentic,ai,ai-agent,ai-coding,cli,coding-agent,developer-tools,llm,mcp,qwen,terminal,typescript

GitHub 星标★ 28068

30天Star增速

HF 下载量

上线时间2025-06-26 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数9

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Linux / macOS / Windows 终端环境
选择 NPM 安装方式时需要 Node.js 22+
一个可用的模型 API Key（Qwen / OpenAI / Anthropic / Gemini 等）
可访问外网以下载安装脚本或 npm 包

安装与启动步骤

1安装（Linux/macOS）

执行官方安装脚本，自动下载并安装独立的 qwen 命令行工具，无需预装 Node.js。
```
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
```
2安装（Windows）

在 PowerShell 中执行官方安装脚本，同样为独立安装包，不依赖 Node.js。
```
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex
```
3备选安装方式

不想用脚本时可用 NPM（需 Node.js 22+）或 Homebrew（macOS/Linux）安装。
```
npm install -g @qwen-code/qwen-code@latest
```
4重启终端

安装完成后必须重启终端，让环境变量生效，否则可能找不到 qwen 命令。
5进入项目目录

切换到你要让 AI 协助的代码仓库根目录，Qwen Code 会以此为工作目录。
```
cd /path/to/your-project
```
6启动 Qwen Code

在项目目录执行 qwen，进入交互式终端会话界面。
```
qwen
```
7配置认证

在会话内运行 /auth，按提示选择模型提供方并填入 API Key，之后即可对话。
```
/auth
```

关键配置

配置项	必填	说明	示例
`provider`	是	在 /auth 中选择的模型提供方，支持 OpenAI、Anthropic、Gemini、Qwen。	`openai`
`api_key`	是	在 /auth 中填写的模型服务密钥，也可接本地 Ollama / vLLM。	`sk-xxxxxxxx`

如何确认成功

终端成功进入 Qwen Code 交互式会话，用 /auth 配置好密钥后提问能正常返回结果即表示可用。

常见问题

Q：安装后提示找不到 qwen 命令怎么办？

A：先重启终端让环境变量生效；若仍不行，确认安装脚本是否执行成功，或改用 npm install -g @qwen-code/qwen-code@latest 安装。

Q：NPM 安装报错或失败是什么原因？

A：NPM 方式要求 Node.js 22 及以上版本，请先升级 Node.js；也可改用官方安装脚本或 Homebrew。

Q：怎么配置模型和 API Key？

A：在 Qwen Code 会话内运行 /auth，按提示选择提供方并填入 API Key，参考官方 Authentication Guide。

Q：除了终端还能怎么用？

A：可下载桌面版、运行 qwen serve --open 打开 Web UI、装 VS Code/Zed/JetBrains 插件，或接入 Telegram 等聊天渠道。

注意事项

安装完成后务必重启终端，否则环境变量可能不生效。
除终端外还支持桌面应用、Web UI、编辑器插件和聊天工具集成。
支持 OpenAI、Anthropic、Gemini、Qwen 等多种协议，也可接 Ollama / vLLM 本地模型。
无界面自动化场景可用 qwen -p "..." 在脚本或 CI/CD 中调用。

核心亮点

基于Qwen模型，提供终端内的AI编程代理，支持代码生成、解释、重构等任务，交互流畅
深度集成MCP（模型上下文协议），可扩展外部工具和API，增强自动化能力
TypeScript编写，CLI设计简洁，安装使用门槛低，适合开发者日常快速调用

不足之处

文档/社区待观察
依赖Qwen模型，对非阿里云API或本地模型支持有限，可能限制自定义场景

适用场景

终端内快速代码补全与错误修复，提升开发效率
自动化代码审查与重构，适合CI/CD流程集成
结合MCP扩展工具链，实现复杂任务编排（如数据抓取、API调用）

替代项目

OpenAI Codex CLI、GitHub Copilot CLI、Aider

项目介绍

qwen-code 是编程开发领域的开源项目，由 QwenLM 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（28,068）位列前 2%，在编程开发分类的 490 个项目里位列前 6%。

近 44 天，它的 GitHub 星标从 26,878 增加到 28,068，净增 1,190。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。基于Apache-2.0许可证，可免费使用和部署，无付费版本。

它主要面向的使用场景是：终端内快速代码补全与错误修复，提升开发效率。同类可对比的替代方案包括 OpenAI Codex CLI、GitHub Copilot CLI、Aider。

上一篇：DeepSeek-Reasonix

下一篇：oh-my-pi