Qwen Code 教程：阿里开源的免费 Claude Code 平替（2026）
发布于 2026年6月5日
想要 Claude Code 那种终端 AI 编程体验，又希望用国产模型、低成本上手？Qwen Code 是阿里通义开源的命令行编码工具，对标 Claude Code / Gemini CLI，配合 Qwen3-Coder 模型使用。本文带你从安装到跑通。
Qwen Code 是什么
阿里通义开源的终端 agentic 编码 CLI，用法与 Claude Code 接近：自然语言描述目标，它读代码库、规划、跨文件改、执行命令。走 OpenAI 兼容协议接入模型，国内可用阿里百炼。
为什么选 Qwen Code
- 开源，社区迭代快
- 国内可直连阿里百炼，无需翻墙
- 走 OpenAI 兼容协议，配置灵活
- 用法对齐 Claude Code，迁移成本低
安装与配置
先确认 Node.js 版本不低于 20，再全局安装。然后配置三个环境变量，把模型指向阿里百炼的兼容接口。
bash
# 需要 Node.js >= 20
npm install -g @qwen-code/qwen-code@latest
# 配置环境变量（国内走阿里百炼兼容接口）
export OPENAI_API_KEY="你的百炼 API Key"
export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"
# 在项目目录启动
qwen- 1确认 Node.js >= 20
- 2全局安装 qwen-code
- 3在阿里百炼开通并拿到 API Key
- 4配置三个环境变量（Key / Base URL / Model）
- 5进入项目目录运行 qwen 开始使用
Qwen Code 和 Claude Code 怎么选
| 维度 | Qwen Code | Claude Code |
|---|---|---|
| 开源 | 是 | 否 |
| 国内访问 | 直连百炼，稳定 | 受限 |
| 模型 | Qwen3-Coder 等 | Claude（Opus 等） |
| 综合能力 | 日常任务足够 | 复杂大型重构更强 |
实用建议
国内日常开发用 Qwen Code 省成本、连得稳；遇到特别复杂的大型重构再上 Claude Code。两者用法接近，切换成本低。
常见问题
想系统学会用这些 AI 编程工具，从入门到做出真实产品，可以看 IMAI 的系统课程。
想系统学会用 AI 编程,从入门到做出真实产品?
查看系统课程