在 AI 辅助编程工具层出不穷的今天，Qwen-Code-CLI 以其轻量、高效、开源的特性，成为开发者终端中的得力助手。它将强大的大模型能力封装为简单的命令行工具，让开发者无需离开终端，就能用自然语言完成代码生成、优化、解释等多种任务。

一、简单介绍：终端里的 AI 编程专家

Qwen-Code-CLI 是阿里巴巴通义千问团队开源的命令行 AI 编程工具，基于 Qwen 系列大模型（如 Qwen2.5-Coder）打造，旨在为开发者提供高效、便捷的 AI 辅助编程体验。

作为一款终端原生工具，它无需复杂的 IDE 集成，可直接与开发者的日常工作流无缝衔接。无论是代码生成、bug 修复，还是文档编写、代码解释，都能通过简单的自然语言指令完成。其开源特性（Apache 2.0 协议）确保了代码透明可审计，同时支持商用场景，让企业用户使用更放心。

二、核心功能：全方位提升开发效率

Qwen-Code-CLI 的核心价值在于将 AI 的理解与生成能力与终端环境深度结合，提供了一系列实用功能：

1. 自然语言驱动的代码操作：通过自然语言指令直接生成、修改、优化代码。例如 "用 Python 实现快速排序算法并添加中文注释"、"优化这个 JavaScript 函数的性能" 等。

2. 文件精准操作：支持通过@符号指定文件，实现对特定文件的处理。如 "解释 @main.js 的执行流程"、"给 @utils.py 添加单元测试"。

3. 终端命令集成：可通过!符号让 AI 生成并执行终端命令，实现开发流程自动化。例如 "! 统计当前目录下所有 Java 文件的行数"。

4. 长上下文支持：支持处理大文件和多文件项目，能理解整个代码仓库的结构和逻辑，适合复杂项目的分析与重构。

5. 多语言支持：对主流编程语言（JavaScript、Python、Java、Go 等）均有良好支持，覆盖前后端、移动端等多种开发场景。

6. 兼容性强：兼容 OpenAI API 格式，可灵活切换后端模型，同时支持与 VS Code、JetBrains 等 IDE 通过插件联动使用。

三、安装：npm 一键部署

Qwen-Code-CLI 通过 npm 包管理工具分发，安装和使用过程简单直观：

前置条件

确保本地已安装Node.js 20.0+ 版本，可通过以下命令检查：

node -v  # 需输出v20.0.0及以上版本

若未安装，可从Node.js 官网下载并安装。

安装步骤

使用 npm 全局安装 Qwen-Code-CLI：

npm install -g @qwen-code/qwen-code

安装完成后，可通过以下命令验证是否安装成功：

qwen --version  # 成功会输出当前版本号

四、配置与使用

首次执行 qwen 命令时，会提供选择登录方式，登录后即可使用。

交互式对话

直接输入qwen进入交互模式，可连续输入指令。

单行指令

qwen -p "python写个helloworld程序"

可对文件进行处理

比如我们要对 Download/图片 目录下的图片进行重命名。我们可以使用 @ 符号指定目录。

文件夹下原图片如下：

执行完重命名之后如下，输入命令。

@Downloads/图片/ 修改图片目录下的4个文件，文件名修改格式为 2025-09-25-x.png

执行完之后的结果：

五、仓库地址

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