Qwen Code 入门:装好终端编程智能体,接百炼或本地模型跑无头模式

千问开源终端编程智能体,从安装到无头自动化

入门3 课时65 分钟图文实操

免费学习无需登录

Qwen Code 入门:装好终端编程智能体,接百炼或本地模型跑无头模式 课程封面

你将学会

  • 一键脚本或 npm 装好 Qwen Code
  • 看懂 /auth 五种认证方式
  • 用 settings.json 接阿里云百炼
  • 接本机 Ollama 当 Custom Provider
  • 无头模式提问、管道输入、JSON 输出
  • 关掉自动记忆加速一次性调用
  • 写项目级 QWEN.md
  • 分清五种审批模式
  • 用 qwen mcp 管理 MCP 服务

适合谁

  • 想在终端里用千问模型写代码的开发者
  • 比较 Claude Code、Codex、Qwen Code 的工程师
  • 要把编程智能体接进脚本或 CI 的团队

课前准备

  • 会用 Linux 或 macOS 终端
  • 第 2 课需要 Ollama 和 jq
  • 用云端模型需千问或百炼 API Key

课程目录

3 课时 · 65 分钟
  1. 01安装 Qwen Code,选好认证方式用官方一键脚本或 npm 装好 Qwen Code 0.27.3,先看没配认证时的报错;再看懂 /auth 的五种认证方式,用 settings.json 写好阿里云百炼的 API Key 配置,脚本和 CI 也能直接用。图文20 分钟开始本课
  2. 02不花钱跑通:接本地 Ollama,学会无头模式把本机 Ollama 的 qwen3:1.7b 配成 Custom Provider;用无头模式直接提问、管道喂文件、输出 JSON 给 jq 解析;关掉自动记忆让一次性调用从 1 分 43 秒降到 14 秒,并看清小模型改不了代码的原因。图文25 分钟开始本课
  3. 03给项目立规矩:QWEN.md、审批模式与 MCP写项目级 QWEN.md 并验证约定生效;分清 plan、default、auto-edit、auto、yolo 五种审批模式和三种切换方式;用 qwen mcp add 挂官方文件系统 MCP 服务,看到 Connected 后再干净移除。图文20 分钟开始本课

课程说明

Qwen Code 是阿里通义千问团队(QwenLM)开源的终端编程智能体,Apache-2.0 许可。它在终端里读代码、改文件、跑命令,也有桌面端、网页、IDE 插件和 SDK。它支持 OpenAI、Anthropic、Gemini 和千问四种接口协议,既能接千问账号订阅、千问 AI 平台、阿里云百炼,也能接 DeepSeek、Kimi 等第三方厂家,或者本机的 Ollama、vLLM。

本课按 Qwen Code 官方 GitHub 仓库的 Quickstart、Authentication、Model Providers、Headless、Approval Mode、Memory 和 MCP 文档整理,全部在 2026-11-14 用 Qwen Code 0.27.3 实跑。测试机是一台 8 核、无显卡的 Debian 13 云主机。第 2、3 课用本机 Ollama 跑 qwen3:1.7b,不需要任何付费 Key;对照结果都是这台机器的真实输出,模型每次措辞会有出入。没有实测的部分会在正文里写明:千问账号登录、云端模型改代码,以及 macOS 和 Windows。

你会学到

  • 用官方一键脚本或 npm 装好 Qwen Code,看懂 /auth 的五种认证方式
  • 用 ~/.qwen/settings.json 接阿里云百炼,或者接本机 Ollama 当 Custom Provider
  • 用无头模式直接提问、管道喂文件、输出 JSON 给 jq 解析
  • 知道小模型的工具调用边界,以及自动记忆拖慢一次性调用的原因和关法
  • 写项目级 QWEN.md,分清 plan、default、auto-edit、auto、yolo 五种审批模式
  • 用 qwen mcp add、list、remove 管理 MCP 服务

适合

  • 想在终端里用千问模型写代码的中文开发者
  • 正在比较 Claude Code、Codex CLI、Qwen Code 的工程师
  • 需要把编程智能体接进脚本或 CI 的团队

先修

  • 会用 Linux 或 macOS 终端,会 cd、cat、git init
  • 第 2 课需要本机装好 Ollama 和 jq,空闲内存 4 GB 以上
  • 想用云端模型时,准备好千问 AI 平台或阿里云百炼的 API Key