Qwen Code 使用教程
从入门到精通的完整指南
Qwen Code 简介
Qwen Code是阿里通义千问团队打造的开源终端AI编程智能体，基于Gemini CLI深度优化适配Qwen-Coder系列模型。支持OpenAI、Anthropic、Gemini等多种API协议及Ollama本地模型，提供交互式终端、无头脚本、IDE集成、SDK调用和守护进程五种使用模式，适合偏好终端工作流的开发者。
详细功能介绍
【工具简介】
Qwen Code是阿里巴巴通义千问团队开发的开源终端AI编程智能体，专为Qwen系列大语言模型深度优化。
【核心功能】
①多协议支持：兼容OpenAI、Anthropic、Gemini等多种API协议，支持阿里云、OpenRouter、Fireworks AI等OpenAI兼容接口，也可通过Ollama或vLLM接入本地模型。
②五种使用模式：交互式终端UI、无头脚本模式（-p参数）、IDE集成（VS Code/Zed/JetBrains）、SDK调用（TypeScript/Python/Java）、实验性守护进程模式（qwen serve）。
③智能体工作流：内置Skills和SubAgents工具系统，提供类Claude Code的终端智能体体验。
④灵活配置：支持全局配置（~/.qwen/settings.json）和项目级配置（.qwen/settings.json）分层管理。
⑤本地模型支持：可完全离线运行，通过Ollama等接入本地部署的模型，无需云端依赖。
【适用场景】
①代码理解与重构：快速理解大型代码库结构，执行跨文件重构任务。
②自动化开发：通过无头模式和SDK集成到CI/CD流水线中，实现自动化代码生成和测试。
③本地化开发：在数据不出境的要求下，使用本地模型进行AI辅助编程。
【快速入门】
①通过curl脚本、npm（npm install -g @qwen-code/qwen-code）或Homebrew安装，需要Node.js 22+环境。
②在项目目录中运行 qwen 命令启动交互式终端。
③使用 /auth 命令配置API密钥或阿里云Coding Plan认证。
④输入自然语言描述，Qwen Code将自主执行编码任务。
【优缺点分析】
优点：
①完全开源，支持多种提供商和本地模型，无供应商锁定。
②五种使用模式覆盖从交互式到自动化的全场景需求。
③针对Qwen-Coder模型深度优化，在中文代码场景下表现优异。
缺点：
①以Qwen模型为主要优化目标，其他模型虽可支持但非重点。
②Qwen OAuth免费层已于2026年4月停止，需付费API或本地模型。
③项目相对较新，文档和社区生态仍在完善中。
【适合人群】
①终端工作流爱好者：习惯在命令行中完成开发任务的极客和开发者。
②阿里云/通义千问用户：已在使用阿里云生态或Qwen模型的团队和个人。
③本地化部署需求者：因合规或隐私要求需要完全离线AI编程能力的企业用户。
1Qwen Code终端AI编程智能体入门教程
入门10分钟
Qwen Code是阿里通义千问团队打造的开源终端AI编程智能体，基于Gemini CLI深度优化，支持多种API协议和Ollama本地模型，提供五种使用模式，适合偏好终端工作流的开发者。
快速开始
1. 确保已安装Node.js 18+，运行npm install -g @anthropic-ai/qwen-code全局安装
2. 也可从GitHub仓库github.com/anthropics/qwen-code下载源码本地构建
3. 运行qwen-code命令，首次使用按提示配置API密钥
4. 配置完成后进入交互式终端界面，输入问题即可开始编程对话
核心功能演示
功能一：交互式终端对话
在终端中直接输入编程问题，如用Python写一个HTTP服务器，Qwen Code会生成完整代码并解释关键逻辑。支持多轮对话，可以继续要求添加静态文件服务功能进行迭代。
功能二：无头脚本模式
使用qwen-code --headless 解释这段代码 --file main.go命令，可以在脚本中调用Qwen Code处理代码，输出结果可被其他程序解析，非常适合集成到CI/CD流程中自动化代码审查。
功能三：IDE集成使用
在VS Code或JetBrains中安装Qwen Code插件后，选中代码片段右键选择Ask Qwen Code，可以直接在IDE内获得代码解释、重构建议或单元测试生成，无需切换窗口。
实际使用案例
场景一：代码审查自动化
团队在CI流程中集成Qwen Code的无头模式，每次PR提交时自动运行代码审查脚本，Qwen Code分析代码变更并生成审查意见，开发者在PR评论中直接查看AI的建议。
场景二：快速原型开发
开发者接到新需求后，在终端中与Qwen Code对话，描述功能需求后快速获得代码框架，通过多轮对话逐步完善功能细节，将数小时的编码工作压缩到几十分钟。
常见问题
Q：Qwen Code和Cursor、GitHub Copilot有什么区别？
A：Qwen Code专注于终端工作流，不需要IDE依赖，适合服务器环境和终端爱好者。同时支持更多模型选择，包括本地Ollama模型，隐私性更好。
Q：支持哪些AI模型？
A：支持OpenAI、Anthropic、Google Gemini等云端API，以及Ollama、LM Studio等本地模型，可以灵活切换。推荐使用Qwen-Coder系列模型以获得最佳效果。
Q：是否完全免费？
A：Qwen Code本身开源免费，但使用云端API需要自行承担API调用费用。使用Ollama等本地模型则完全免费，仅消耗本地计算资源。
小贴士
1. 配置Ollama本地模型可以在无网络环境下使用，也避免了API费用，推荐开发机配置qwen2.5-coder模型
2. 使用qwen-code --model命令可以快速切换模型，不同任务选择不同模型能获得更好效果
3. 善用项目根目录下的.qwen-code配置文件，可以设置项目级别的提示词模板和默认参数，提升团队协作效率