单元一 准备 · 第 2 课

先搞懂几个词

后面每一课都会用到这几个词。用生活里的东西来理解它们，比背定义容易得多。

本课目标

• 分清“聊天 AI”和“编程智能体”。
• 理解模型、API、API Key、Base URL、Token 分别是什么。
• 明白为什么 API Key 要像钱包一样保管。

聊天 AI 和编程智能体

你可能用过网页版的 ChatGPT、Claude 或豆包。它们是聊天 AI：你问一句，它答一句。它能给建议、写一段文字，但碰不到你电脑里的东西，复制粘贴还得你自己来。

编程智能体（也叫 AI 编程助手、Agent）不一样。它装在你的电脑上，可以：

• 读你指定文件夹里的文件；
• 运行命令，比如统计文件、安装软件；
• 新建、修改、移动文件。

打个比方：聊天 AI 像电话里的顾问，只能动嘴；编程智能体像坐在你旁边的助理，能直接上手操作你的电脑。也正因为它能动手，要给它划定权限：超出权限的事，它会先停下来问你，这就是后面会反复提到的“审批”。哪些事要问、哪些事直接做，由你选的权限模式和规则决定。

这门课会用到三个编程智能体：

它们的用法大同小异。学会一个，另外两个很快就能上手。

模型：AI 的大脑

模型是真正“思考”的那部分，比如 GPT、Claude、Grok 系列里的各个型号。编程智能体是“身体”，负责读文件、跑命令；模型是“大脑”，负责理解你的话、决定下一步做什么。

同一个工具可以换不同的模型：大模型更聪明但更贵、更慢；小模型便宜、快，适合简单任务。

API：程序之间的点餐窗口

模型运行在服务商的机房里，不在你电脑上。你的编程智能体要用它，就得通过网络“下单”。

API 就是这个下单窗口：规定了怎么点餐（发什么格式的请求）、怎么取餐（收什么格式的结果）。你不需要会写 API 请求，编程智能体会替你做。你只要告诉它窗口在哪、用谁的卡付钱。

• Base URL：窗口的地址。本站的地址是 https://api.xairouter.com。
• API Key：付钱用的会员卡，一串以 sk- 开头的长字符。

本站是一个“总机”（Router）：一张卡、一个地址，就能用多家厂商的模型，不用分别去 OpenAI、Anthropic、xAI 开户。

API Key：你的钱包

API Key 有两个作用：证明“这是我”，以及从你的账户里扣费。

所以，谁拿到你的 Key，谁就能花你的钱。务必做到：

• 不截图、不发到群里或论坛；
• 不写进代码、文档，也不要上传到 GitHub；
• 怀疑泄露了，立刻在账户后台更换。

第 6 课会教你把 Key 放进“环境变量”，这是程序员保管密钥的标准做法。

Token：计费单位

模型按 Token 计费。Token 是模型读写文字时切出来的小块，可以粗略理解为“字数”：一个英文单词大约一到两个 Token，一个汉字通常也在一到两个 Token 左右，不同模型切法不同。

计费时，你发过去的内容和它写回来的内容都算 Token。编程智能体会把相关文件内容一起发给模型，所以：

• 对话越长、读的文件越多，花费越多；
• 一件事做完就开新对话，比一直在同一个对话里聊省钱；
• 不要让它读与任务无关的大文件。

小结

自检

• 我能说出聊天 AI 和编程智能体的区别。
• 我知道 Base URL 和 API Key 分别是什么。
• 我知道为什么不能把 Key 发给别人。
• 我知道对话越长花费越多。