你将学会
- 用 curl 与 Python、Node.js 调通 qwen3.8-max
- 配好 API Key 与业务空间 ID 并看懂 401 报错
- 按 usage 与官方单价估算调用费用
- 用 enable_thinking 与 thinking_budget 控制思考
- 用 JSON Schema 与工具调用写出可运行的 Agent 循环
- 让 Claude Code 和 Qwen Code 接入百炼
适合谁
- 想用千问搭建应用或智能体的开发者
- 想给 Claude Code 换上国产模型的工程师
- 从旧版 DashScope 教程迁移的团队
课前准备
- 会用终端与基本命令行
- 本机 Python 3.9+，第 3 课需 Node.js 18+
- 已实名认证的阿里云账号
课程目录
3 课时 · 67 分钟- 01开通百炼跑通 qwen3.8-max：curl、Python、Node.js、报错与计费开通百炼、创建 API Key 并拿到业务空间 ID，用 curl、Python、Node.js 各调一次 qwen3.8-max，用假 Key 复现 401 报错，并按 usage 和官方单价算出一次调用的费用。图文20 分钟开始本课
- 02思考模式、thinking_budget、JSON Schema 与多轮工具调用流式分开打印 reasoning_content 和回答，用 enable_thinking 与 thinking_budget 控制思考，用 JSON Object 和 JSON Schema 拿结构化结果，再写一个完整的多轮工具调用循环。图文25 分钟开始本课
- 03让 Claude Code 与 Qwen Code 接入百炼，再用上下文缓存省钱先用 curl 验证 Anthropic 兼容端点，再用 settings.json 把 Claude Code 和 Qwen Code 接到百炼按量计费，最后用脚本观察显式缓存的创建与命中，并在缓存和 Batch 之间做选择。图文22 分钟开始本课
课程说明
千问是阿里云的大模型系列，开发者通过阿里云百炼（Model Studio）按量调用它的 API。百炼同时提供 OpenAI 兼容和 Anthropic 兼容两种接口，所以现有的 OpenAI SDK 代码、Claude Code 和 Qwen Code 改一下 Base URL 就能接上。2026 年 10 月，百炼的旗舰文本模型是 qwen3.8-max，qwen3.8-flash 是低价款，两者都默认开启思考，单次请求最多可以输入 1M Token。要注意，北京等地域的 Base URL 现在必须带上业务空间 ID（WorkspaceId），不少旧教程还在用不带它的地址和旧模型名。
本课完全按阿里云百炼官方文档整理，代码与官方示例保持一致，只是把业务空间 ID 改成从环境变量读取。2026-10-24 用假 Key 实测了每段可运行的代码，确认端点可达，都会返回 401 invalid_api_key；需要余额的成功输出，则使用官方文档给出的示例响应作对照。共 3 课时：
| 课时 | 你会做完的事 | 需要什么 |
|---|---|---|
| 1 | 开通百炼、创建 API Key、拿到业务空间 ID，用 curl、Python、Node.js 跑通 qwen3.8-max，看懂 401 报错并按 usage 算费用 | 阿里云账号（已实名） |
| 2 | 流式分开打印思考与回答，用 thinking_budget 限制思考长度，用 JSON Object / JSON Schema 拿结构化结果，写一个完整的工具调用循环 | 同上，外加 Python 3.9+ |
| 3 | 让 Claude Code 和 Qwen Code 走百炼按量计费，用脚本观察显式缓存从创建到命中，并在缓存和 Batch 之间做选择 | 同上，外加 Node.js 18+ |
适合：想用千问搭应用或智能体的开发者、想给 Claude Code 换上国产模型的工程师，以及手里还是旧版 DashScope 教程、需要迁移的团队。
先修：会用终端；本机有 Python 3.9+；第 1 课的 Node.js 部分和第 3 课需要 Node.js 18+。
官方来源：
- 首次调用千问 API：https://help.aliyun.com/zh/model-studio/first-api-call-to-qwen
- 获取与配置 API Key：https://help.aliyun.com/zh/model-studio/get-api-key
- 模型列表：https://help.aliyun.com/zh/model-studio/models
- 模型调用价格：https://help.aliyun.com/zh/model-studio/model-pricing
- 错误码：https://help.aliyun.com/zh/model-studio/error-code
- 深度思考：https://help.aliyun.com/zh/model-studio/deep-thinking
- 结构化输出：https://help.aliyun.com/zh/model-studio/qwen-structured-output
- Function Calling：https://help.aliyun.com/zh/model-studio/qwen-function-calling
- Anthropic 兼容 Messages：https://help.aliyun.com/zh/model-studio/anthropic-api-messages
- Claude Code：https://help.aliyun.com/zh/model-studio/claude-code
- Qwen Code：https://help.aliyun.com/zh/model-studio/qwen-code
- 上下文缓存：https://help.aliyun.com/zh/model-studio/context-cache
绑定工具： 千问（/tools/qwen/）· 百炼控制台 https://bailian.console.aliyun.com/