Qwen Code

Qwen Code: 适用于开发人员的 AI 驱动的命令行工作流程工具

Qwen Code 是一款 AI 驱动的编码助手，旨在提高开发人员的生产力。 此工具专为 Qwen3-Coder 模型优化，通过高级代码理解、自动化任务和智能辅助来增强您的开发体验。 什么是 Qwen Code？ 它是一款旨在加速和简化您的编码项目的工具。

特性

• 代码理解与编辑：快速查询和编辑超出传统上下文窗口的大型代码库。
• 工作流程自动化：自动化操作任务，高效管理拉取请求，轻松处理复杂的 rebase。
• 增强型解析器： 适配于与 Qwen-Coder 模型无缝协作。
• 视觉模型支持：自动识别输入中的图像，并切换到支持视觉的模型进行多模态分析。

如何使用 Qwen Code

安装

请确保您已安装 Node.js 20 或更高版本。您可以使用 npm 安装 Qwen Code：

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

或者，从源代码安装：

git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code
npm install
npm install -g .

对于 macOS/Linux 用户，Homebrew 也是一个选择：

brew install qwen-code

快速开始

在您的终端中运行 qwen 以启动该工具。 示例命令：

> 解释一下这个代码库的结构
> 帮我重构这个函数
> 为这个模块生成单元测试

免费选项

开始免费使用 Qwen Code：

• Qwen OAuth（推荐）：
  • 每天 2,000 个请求，没有 token 限制
  • 每分钟 60 个请求的速率限制
  • 自动凭据管理
• 区域免费层级：
  • ModelScope（中国大陆）：每天 2,000 个免费 API 调用
  • OpenRouter（国际）：每天最多 1,000 个免费 API 调用

授权

您还可以通过 Qwen OAuth 授权 Qwen Code：

qwen

或者，您可以通过设置以下环境变量来使用与 OpenAI 兼容的 API：

export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="your_api_endpoint"
export OPENAI_MODEL="your_model_choice"

对于中国大陆的用户，请使用阿里云百炼或 ModelScope。 国际用户可以使用阿里云 ModelStudio 或 OpenRouter。

会话管理

通过在 .qwen/settings.json 中配置会话限制来管理 token 使用量：

{
  "sessionTokenLimit": 32000
}

使用会话命令（如 /compress）减少历史记录或使用 /clear 启动新会话。 您还可以使用 /stats 检查 token 使用情况。

视觉模型配置

当 Qwen Code 检测到您的输入中包含图像时，它可以自动切换到具有视觉功能的模型。 在 .qwen/settings.json 中配置该行为：

{
  "experimental": {
    "vlmSwitchMode": "once"
  }
}

可用模式包括 once、session 和 persist。 您还可以通过命令行设置该行为：

qwen --vlm-switch-mode once

通过设置以下内容完全禁用视觉模型：

{
  "experimental": {
    "visionModelPreview": false
  }
}

您可以使用 Qwen Code 做什么：

• 探索代码库： 了解系统的结构和依赖关系。
• 代码开发： 重构代码、生成单元测试并创建 API 端点。
• 自动化工作流程： 自动化 git 任务、文件操作等。
• 调试与分析： 识别代码中的性能瓶颈和安全漏洞。

Qwen Code 适合哪些人？

• 希望提高编码效率的软件开发人员。
• 希望自动化其工作流程的团队。
• 任何使用大型代码库的人。

热门任务

• 理解新的代码库：
  • 识别核心业务逻辑组件。
  • 了解安全机制。
• 代码重构与优化：
  • 重构类以获得更好的 SOLID 原则。
  • 为昂贵的操作实施缓存。
• 文档与测试：
  • 为 API 生成 JSDoc 注释。
  • 编写单元测试。
• 开发加速：
  • 设置新的 Express 服务器。
  • 实施速率限制器中间件。

命令和快捷键

• /help: 显示可用命令。
• /clear: 清除对话历史记录。
• /compress: 压缩历史记录以节省 token。
• /stats: 显示当前会话信息。
• /exit 或 /quit: 退出 Qwen Code。