Qwen Code 新手入门指南

Qwen Code 是一款专为中文开发者和成本敏感场景设计的 AI 编程助手。它基于开源的 Google Gemini CLI 深度改造，并针对阿里巴巴的 Qwen3-Coder 系列模型进行了优化。Qwen Code 不仅在代码生成和理解方面表现卓越，还支持本地部署和多种第三方模型平台，让你在享受 AI 编程便利的同时，完全掌控成本和数据安全。无论你是想要降低 AI 使用成本，还是需要在受限网络环境中工作，Qwen Code 都是你的理想选择。

Qwen Code 的安装过程简单直接，只需要几分钟就能完成。

确保你的系统满足以下要求：

• Node.js：版本 20 或更高

检查 Node.js 版本：

如果版本过低或未安装，请访问 nodejs.org 下载最新的 LTS 版本。

打开终端，运行以下命令：

安装完成后，验证是否成功：

如果看到详细的帮助信息，恭喜你！Qwen Code 已经准备就绪。

Qwen Code 提供了多种认证方式，你可以根据自己的需求和使用场景选择最合适的。

这是最简单的入门方式，提供慷慨的免费额度：

1. 在终端运行：
2. 首次运行时，Qwen Code 会：
   • 自动打开你的默认浏览器
   • 跳转到 qwen.ai 登录页面
   • 使用你的账户完成授权
3. 登录成功后，你将获得：
   • 每日约 2000 次请求的免费额度
   • 每分钟约 60 次请求的速率限制
   • 无需任何配置，即开即用

如果你需要更多控制或想要使用付费服务：

使用阿里云 Dashscope：

1. 访问 阿里云模型服务灵骏 获取 API 密钥
2. 设置环境变量：

使用 OpenRouter 等第三方平台：

这是 Qwen Code 的独特优势 – 支持完全本地部署：

1. 安装 Ollama：
   • 访问 ollama.ai 下载并安装
   • 或使用包管理器：（macOS）
2. 下载 Qwen3-Coder 模型：
3. 启动本地服务：
4. 配置 Qwen Code 使用本地模型：

现在让我们开始体验 Qwen Code 的强大功能！

在终端运行：

你会看到一个友好的中文界面，现在可以开始与 AI 对话了。

代码生成：

代码解释：

单元测试生成：

代码重构：

对于快速任务，你可以使用：

Qwen Code 使用 文件来理解你的项目背景和编码规范。

在你的项目根目录创建 文件：

在交互模式中使用以下命令：

• – 查看当前加载的项目上下文
• – 动态添加项目规则

由于 Qwen Code 是从 Gemini CLI 分支而来，它能识别名为 的上下文文件。在旧版本中， 或其他命令可能仍会生成一个名为 的文件。为了确保最佳兼容性和避免混淆，建议你手动将项目中的 重命名为 。

创建 文件来自定义你的体验：

通过配置 ，你可以扩展 Qwen Code 的功能。例如，上面的 配置可以连接到 Zilliz Cloud 这样的向量数据库，实现对整个代码库的语义搜索，这对于理解大型复杂项目非常有帮助。

为了更好地控制使用成本：

1. 设置会话限制：
2. 使用本地模型：
   • 完全免费，无网络依赖
   • 数据不会离开你的设备
   • 适合敏感项目
3. 选择合适的模型：
   • ：专门优化的编程模型
   • ：速度快，成本低
   • ：平衡性能和成本

在交互模式中，这些命令会提高你的效率：

• – 显示所有可用命令
• – 查看 Token 使用统计
• – 清空当前对话
• – 恢复到之前的检查点（如果支持）
• – 查看项目上下文
• – 添加新的项目规则

1. 使用中文描述需求：千问 Qwen 教程
2. 结合英文技术术语：
3. 具体化你的要求：

你可以在同一个项目中使用多个模型：

Qwen Code 提供了业界最慷慨的免费额度：

Qwen API 的定价非常有竞争力：

1. 合理选择模型：简单任务用 Flash，复杂任务用 Coder
2. 控制会话长度：定期使用 清理上下文
3. 批处理任务：将多个相关问题合并在一次对话中

Q: Qwen Code 与其他 AI 编程工具有什么区别？ A: Qwen Code 专门为中文开发者优化，支持本地部署，成本更低，且在中文编程任务上表现更好。

Q: 本地模型的性能如何？ A: 对于大部分编程任务，本地的 Qwen3-Coder 7B 模型已经足够强大，而且完全免费。

Q: 我的代码会被发送到服务器吗？ A: 使用在线模型时会发送到服务器，但使用本地模型时代码完全不会离开你的设备。

Q: 如何在公司网络环境中使用？ A: 推荐使用本地模型部署，这样可以完全避免网络限制和数据安全问题。

Q: OAuth 登录失败怎么办？ A: 确保网络可以访问 qwen.ai，或者改用 API 密钥方式。

Q: 如何监控使用量？ A: 在交互模式中使用 命令查看当前会话的 Token 使用情况。

现在你已经掌握了 Qwen Code 的基础使用，可以尝试：

1. 本地模型优化：尝试不同大小的 Qwen3-Coder 模型，找到性能和资源的最佳平衡
2. 团队协作：与团队成员分享 QWEN.md 配置，统一开发规范
3. 自动化集成：将 Qwen Code 集成到你的开发工作流中
4. 多语言支持：探索 Qwen Code 在不同编程语言中的表现

• Qwen3-Coder 技术博客
• 阿里云模型服务文档
• Ollama 官方文档