Qwen Code：基于 Gemini CLI 的命令行工具助力代码生成与管理

Qwen Code 是一个开源命令行工具，基于 Google 的 Gemini CLI 开发，专为 Alibaba Cloud 的 Qwen3-Coder 模型优化。它帮助开发者通过命令行完成代码生成、编辑和仓库管理任务。qwen-code 支持 Qwen3-Coder-480B-A35B 模型，具备 4800 亿参数，推理时激活 350 亿参数，采用混合专家架构（MoE）。它原生支持 256K 超长上下文，可通过 YaRN 技术扩展至 1M，适合处理大型代码库。工具提供代码补全、重构、Git 提交分析等功能，开源特性允许社区扩展，开发者可通过 GitHub 参与贡献。

评测：Qwen Code 深度评测：它能替代 Claude 成为新的开发主力吗？

依赖模型：Qwen3-Coder：开源代码生成与智能编程助手

功能列表

• 支持 Qwen3-Coder 模型，提供代码补全、修复和重构功能。
• 查询和编辑大型代码库，突破传统上下文长度限制，支持 256K 至 1M 上下文。
• 自动化 Git 提交分析，按功能或团队成员分组，优化团队协作。
• 支持 40 多种编程语言，如 Python、JavaScript、Haskell 等。
• 提供命令行界面，简化代码开发和项目管理流程。
• 兼容 OpenAI API，可无缝调用 Qwen3-Coder 模型。
• 自动化工作流，如处理拉取请求（PR）和复杂变基操作。
• 生成 JSDoc 注释、单元测试和 API 文档，提升代码质量。

使用帮助

安装流程

qwen-code 支持通过 npm 或源码安装，适用于 Linux、macOS 和 Windows 系统。以下是详细步骤：

通过 npm 安装

1. 确保安装 Node.js（版本 20 或更高）。可通过以下命令安装 Node.js：

   curl -qL https://www.npmjs.com/install.sh | sh
   

2. 全局安装 qwen-code：

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

3. 验证安装：

   qwen --version
   

   如果显示版本号，安装成功。

通过源码安装

1. 克隆 GitHub 仓库：

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

2. 进入项目目录：

   cd qwen-code
   

3. 安装依赖并全局部署：

   npm install
   npm install -g .
   

4. 验证安装：

   qwen --version
   

配置 API 密钥

qwen-code 需要 Qwen3-Coder 的 API 密钥以调用模型功能：

1. 注册 Alibaba Cloud 账户并激活 Model Studio 服务。
2. 在 Alibaba Cloud 控制台生成 API 密钥。
3. 配置环境变量或在项目根目录创建 .env 文件，添加以下内容：

   OPENAI_API_KEY=your_api_key_here
   OPENAI_BASE_URL=https://dashscope-intl.aliyuncs.com/compatible-mode/v1
   OPENAI_MODEL=qwen3-coder-plus
   

4. 如果使用环境变量，运行：

   export OPENAI_API_KEY="your_api_key_here"
   export OPENAI_BASE_URL="https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
   export OPENAI_MODEL="qwen3-coder-plus"
   

使用方法

安装完成后，在终端输入 qwen 即可启动工具。以下是主要功能的详细操作流程：

代码补全

qwen-code 支持基于 Qwen3-Coder 的代码补全功能。例如，补全 Python 快速排序算法：

1. 进入项目目录：

   cd your-project
   

2. 输入 qwen，然后输入代码片段：

   def quicksort(arr): if len(arr) <= 1: return arr pivot = arr[len(arr) // 2]
   

3. qwen-code 会返回补全代码，例如：

   left = [x for x in arr if x < pivot]
   middle = [x for x in arr if x == pivot]
   right = [x for x in arr if x > pivot]
   return quicksort(left) + middle + quicksort(right)
   

代码重构

优化代码可读性和性能：

1. 输入命令：

   qwen > Refactor this function to improve readability and performance
   

2. 粘贴需要重构的代码，qwen-code 会返回优化后的版本。例如，将冗长循环重构为更简洁的列表推导式。

Git 提交分析

分析项目提交记录：

1. 进入项目目录：

   cd your-project
   

2. 输入：

   qwen > Analyze git commits from the last 7 days, grouped by feature and team member
   

3. qwen-code 返回按功能和团队成员分组的提交详情，方便团队审查。

代码库查询

查询项目架构或核心逻辑：

1. 输入：

   qwen > Describe the main pieces of this system's architecture
   

2. qwen-code 会分析代码库，返回系统架构描述。

自动化工作流

处理拉取请求（PR）或复杂变基：

1. 输入：

   qwen > Automate the process of handling pull requests
   

2. qwen-code 会生成 PR 处理脚本或建议操作步骤。

文档与测试

生成 JSDoc 注释或单元测试：

1. 输入：

   qwen > Generate comprehensive JSDoc comments for this function
   

2. 粘贴函数代码，qwen-code 会返回带注释的代码。
3. 类似地，输入 qwen > Write unit tests for this component 可生成测试代码。

图像格式转换

批量转换目录中的图像：

1. 输入：

   qwen > Convert all images in this directory to PNG format
   

2. qwen-code 会执行转换并返回结果。

注意事项

• 确保网络稳定以访问 Qwen3-Coder 的 API。
• Qwen3-Coder-480B-A35B 不支持推理模式（thinking mode），无需设置 enable_thinking=False。
• 如遇安装问题，检查 Node.js 版本或参考 troubleshooting guide（位于 docs/troubleshooting.md）。
• 开源社区可通过 CONTRIBUTING.md 参与开发，提交新功能或修复 bug。

应用场景

1. 快速调试代码
   个人开发者可使用 qwen-code 补全或修复代码。例如，输入部分 Python 代码，qwen-code 会自动完成逻辑，适合快速原型开发。
2. 团队代码审查
   开发团队可通过 Git 提交分析功能，快速了解近期代码变更，按功能或成员分组，提升审查效率。
3. 大型项目管理
   qwen-code 支持 256K 至 1M 上下文，适合处理大型代码库，查询架构或优化模块，满足企业级开发需求。
4. 多语言开发
   支持 40 多种编程语言，开发者可轻松处理 Python、JavaScript、Haskell 等语言的代码任务，降低跨语言开发难度。
5. 文档生成
   qwen-code 可生成 JSDoc 注释、API 文档或单元测试，适合需要快速生成高质量文档的开发场景。

QA

1. qwen-code 是否免费？
   qwen-code 是开源工具，免费使用。但调用 Qwen3-Coder 模型需 Alibaba Cloud API 密钥，可能产生费用，具体价格请访问 https://dashscope.aliyuncs.com。
2. 如何解决安装失败？
   确保 Node.js 版本为 20 或更高，检查网络连接，重新运行 npm install。如仍失败，参考 docs/troubleshooting.md。
3. qwen-code 支持哪些编程语言？
   支持 40 多种语言，包括 Python、JavaScript、Haskell 等，具体性能见 McEval 或 SWE-Bench Verified 基准测试。
4. 是否支持离线使用？
   qwen-code 依赖云端 API，无法完全离线。需部署本地 Qwen3-Coder 模型实现部分离线功能，参考官方文档。
5. 与 Claude Code 相比有何优势？
   qwen-code 开源免费，支持 Qwen3-Coder 的超长上下文和强大 Agent 能力，性能接近 Claude Sonnet 4，且适配国内网络环境。