通义千问（Qwen）是阿里巴巴集团的大模型品牌：面向大众的千问 App / 网页提供对话、创作与多模态能力；面向开发者则通过阿里云 百炼（Model Studio） 提供 API，并可用 Qwen Code 在终端完成 Agent 式编程；开源权重则方便研究与私有化部署。本文按「产品地图 → 安装开通 → 日常使用 → 代码编辑 → 跨场景辅助 → 学习路径 → 官方入口」详细说明。
一、通义千问是什么
1. 使用表面
| 入口 | 说明 |
| --- | --- |
| 千问 App / 网页 | 对话、创作、读图读文档（以当前客户端功能为准） |
| 阿里云百炼 API | OpenAI 兼容调用；模型如 qwen-plus、qwen-coder 系列等 |
| Qwen Code | 终端 Agent：规划、改文件、执行命令 |
| 开源权重 | Hugging Face / ModelScope 等渠道部署 |
2. 擅长与边界
擅长：中文理解与生成、办公写作、多模态问答、代码生成与仓库级辅助（经 Qwen Code / IDE）。
边界：云端调用受账号、额度与地域网络影响；开源自建要自己承担显存与运维；医疗、法律、金融等专业结论必须人工审核。
二、安装与开通
1. 消费者端
- 手机应用商店搜索「通义千问」或阿里官方千问客户端，核对开发者后安装
- 或从阿里系产品页进入网页版对话
- 使用支持的账号体系登录（以产品实际支持为准）
2. 开发者：百炼 API
- 注册阿里云并完成实名认证
- 开通百炼 / 相关模型服务，创建 API Key
- 在控制台查看可用模型、免费额度与计费项
OpenAI 兼容调用（国内常见 endpoint）：
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DASHSCOPE_API_KEY"],
base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)
resp = client.chat.completions.create(
model="qwen-plus",
messages=[
{"role": "system", "content": "你是严谨的技术助手，不确定就明确说明。"},
{"role": "user", "content": "用三点总结微服务拆分原则"},
],
)
print(resp.choices[0].message.content)国际站或其它地域可能使用 dashscope-intl 等域名，以控制台文档为准。也可用官方 dashscope SDK。
密钥只放环境变量或密钥管理服务，不要写入前端或 Git。
3. 安装 Qwen Code
官方常见安装方式（脚本地址与参数会更新，执行前请对照百炼帮助文档）：
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)" -s --source bailian在 ~/.qwen/settings.json 中配置百炼 API Key，并选择如 qwen3-coder-plus、qwen3.5-plus 等模型；需要时可开启 thinking。若你购买的是 Coding Plan，必须使用文档给出的专属 Base URL 与 API Key，不要与通用按量 Key 混贴。
启动：
qwen部分版本支持 /auth 可视化登录。VS Code 可搜索 Qwen Code Companion 等配套扩展（名称以扩展市场为准）；CLI 与 IDE 插件通常共用同一份 settings。
三、日常使用
1. 对话技巧
好提示包含：角色、材料、格式、验收标准。处理长文档时先要「结构树 / 目录」，再对某一节要求「带原文依据的说明」。
2. 多模态
上传截图问 UI 问题、上传表格问口径；明确要求模型区分「图中可见的事实」与「基于常识的猜测」。
3. 思考模式与模型选择
复杂推理、方案对比打开深度思考 / thinking；短润色、翻译用更快更便宜的型号，以控制成本与延迟。
四、代码编辑
1. Qwen Code 推荐节奏
- 进入项目根目录执行
qwen - 先问：项目结构、技术栈、如何本地运行测试
- 下达带验收命令的改造任务
- 逐项批准工具调用，审查 diff
- 在本机再跑一遍构建 / 测试
2. 示例提示
为 user 服务增加分页查询：
1) 只改 api 与 test 目录
2) 运行 npm test -- user，失败则修复直至通过
3) 不要升级无关依赖
4) 输出中文变更说明3. 接到其它 IDE / Agent
把百炼兼容 endpoint 配进 Cursor、Cline、Claude Code 等工具。仓库任务优先选 Coder 系列模型。注意工具要的是「Base URL」还是「完整 chat/completions 地址」。
4. 审查清单
- 是否改到范围外文件？
- 是否出现幻觉依赖或不存在的配置项？
- 密钥、内网地址是否被写进代码？
- 地域 endpoint / Coding Plan 是否配错？
五、跨场景辅助
- 办公：会议纪要、周报、邮件润色
- 知识库：企业文档问答（务必检索 grounding，防止胡编）
- 数据：SQL 助手、日志归类、报表口径解释
- 教育：概念讲解、练习生成
- 运营：详情文案、活动说明草稿（广告法与品牌规范人工过）
开源 Qwen 适合内网助手；上线前建议做安全评测、权限隔离与审计日志。
六、推荐两周学习路径
第 1–2 天： App / 网页熟悉对话与多模态
第 3–5 天： 开通百炼，跑通兼容 SDK 示例
第 6–10 天： 安装 Qwen Code，完成可合并的小需求
第 11–14 天： 接一条 CI 摘要或内部 Bot，并固化团队提示词
七、常见问题
Q：DashScope Key 能当 OpenAI 官方 Key 用吗？
A：不能。只是接口协议兼容，账号与计费完全独立。
Q：为什么报模型不存在或鉴权失败？
A：检查地域 endpoint、Key 是否过期，以及 Coding Plan 与按量配置是否贴错。
Q：开源模型和云端 API 怎么选？
A：要最新托管能力与省运维 → 云端；要数据不出域 → 开源自建（评估硬件）。
八、官方入口
- 阿里云控制台搜索「百炼」开通与管 Key
- 阿里云帮助中心：Qwen Code / 兼容模式文档
- 开源：Qwen 系列 GitHub 与 ModelScope
九、小结
- 聊天用千问客户端；集成走百炼；改仓用 Qwen Code。
- 优先 OpenAI 兼容 SDK，少重复造轮子。
- 写代码必须带验收命令，并审查每一个 diff。
- 跨场景给真实材料，禁止编造。
- 地域与 Coding Plan 的 endpoint 配错是最常见故障。