# Qwen Code 概述
> 推荐的安装程序会优先使用适合你平台的独立归档文件。如果回退到 npm，则 PATH 上必须提供 Node.js 22 或更高版本及 npm。
- 网址：https://funcoding.ai/agents/qwen-code/users/overview/
- 来源：Qwen Code 官方文档原文（中文），Apache-2.0 许可，同步于 2026-10-11
- 官方原文：https://qwenlm.github.io/qwen-code-docs/zh/users/overview
---
[](https://npm-compare.com/@qwen-code/qwen-code)
[](https://www.npmjs.com/package/@qwen-code/qwen-code)
> 了解 Qwen Code，它是 Qwen 的智能编码工具，运行在你的终端中，帮助你比以往更快地将想法转化为代码。
## 30 秒快速上手
### 安装 Qwen Code：
推荐的安装程序会优先使用适合你平台的独立归档文件。如果回退到 npm，则 PATH 上必须提供 Node.js 22 或更高版本及 npm。
**Linux / macOS**
```sh
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
```
**Windows**
```powershell
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex
```
如果安装后 `qwen` 未立即在 PATH 中可用，建议重启终端。如果安装失败，请参考快速入门指南中的[手动安装](https://funcoding.ai/agents/qwen-code/users/quickstart/#manual-installation)。对于离线安装，请下载发布归档文件并使用 `--archive PATH` 运行安装程序；将 `SHA256SUMS` 文件放在归档文件旁边。
### 开始使用 Qwen Code：
```bash
cd your-project
qwen
```
首次启动时，系统会提示你连接一个模型提供商。菜单提供 **Alibaba ModelStudio**（官方推荐的设置方式）、**第三方提供商**（内置提供商，如 DeepSeek、MiniMax、Z.AI、Kimi 和 OpenRouter，通过 API key 连接）以及 **自定义提供商**（本地服务器、代理或不支持的提供商）。对于[阿里云 Token 计划](https://bailian.console.aliyun.com/cn-beijing?tab=doc#/doc/?type=model&url=3028856)（[国际版](https://modelstudio.console.alibabacloud.com/ap-southeast-1?tab=doc#/doc/?type=model)），选择 **Alibaba ModelStudio → Token Plan**；要使用 ModelStudio API key，选择 **Alibaba ModelStudio → Standard API Key** 并按照 API 设置指南（[北京](https://bailian.console.aliyun.com/cn-beijing/?tab=doc#/doc/?type=model&url=3023091) / [国际版](https://modelstudio.console.alibabacloud.com/ap-southeast-1?tab=doc#/doc/?type=model&url=2974721)）操作。然后让我们开始了解你的代码库。试试以下命令之一：
```
what does this project do?
```
首次使用时系统会提示你登录。就这么简单！[继续快速入门（5 分钟）→](https://funcoding.ai/agents/qwen-code/users/quickstart/)
如果遇到问题，请参阅[故障排除](https://funcoding.ai/agents/qwen-code/users/support/troubleshooting/)。
**新的 VS Code 扩展（Beta）**：更喜欢图形界面？我们全新的 **VS Code 扩展** 提供了易于使用的原生 IDE 体验，无需熟悉终端。只需从市场安装，即可直接在侧边栏中使用 Qwen Code 进行编码。立即下载并安装 [Qwen Code Companion](https://marketplace.visualstudio.com/items?itemName=qwenlm.qwen-code-vscode-ide-companion)。
## Qwen Code 能为你做什么
- **根据描述构建功能**：用自然语言告诉 Qwen Code 你想构建什么。它会制定计划、编写代码并确保其正常工作。
- **调试并修复问题**：描述一个 bug 或粘贴错误信息。Qwen Code 会分析你的代码库，找出问题并实施修复。
- **导航任何代码库**：询问关于团队代码库的任何问题，获得深思熟虑的回答。Qwen Code 能够感知整个项目结构，可以从网络获取最新信息，并通过 [MCP](https://funcoding.ai/agents/qwen-code/users/features/mcp/) 从外部数据源（如 Google Drive、Figma 和 Slack）拉取数据。
- **自动化繁琐任务**：修复棘手的 lint 问题、解决合并冲突、编写发布说明。在你的开发机器上通过一条命令完成所有这些操作，或在 CI 中自动执行。
- **[后续建议](https://funcoding.ai/agents/qwen-code/users/features/followup-suggestions/)**：Qwen Code 会预测你接下来要输入的内容，并以幽灵文本形式显示。按 Tab 接受，或继续输入以取消。
## 为什么开发者喜爱 Qwen Code
- **在你的终端中工作**：不是另一个聊天窗口，也不是另一个 IDE。Qwen Code 在你已经工作的环境中运行，使用你已经喜爱的工具。
- **采取行动**：Qwen Code 可以直接编辑文件、运行命令和创建提交。还需要更多？通过 [MCP](https://funcoding.ai/agents/qwen-code/users/features/mcp/)，Qwen Code 可以读取你在 Google Drive 中的设计文档、更新你在 Jira 中的工单，或使用 _你_ 的自定义开发工具。
- **Unix 哲学**：Qwen Code 是可组合和可脚本化的。`tail -f app.log | qwen -p "Slack me if you see any anomalies appear in this log stream"` _确实有效_。你的 CI 可以运行 `qwen -p "If there are new text strings, translate them into French and raise a PR for @lang-fr-team to review"`。