连接智谱（Z.AI / GLM）
预计时间：5-10 分钟
智谱（Z.AI）在中文理解、写作/总结方面体验很好；如果你订阅了官方 Coding Plan，也能用固定月费来控制成本。
如果你还没看过“API Key 是什么”，建议先回到 1.4 总览 把概念弄清楚。
学完你能做什么
- 获取智谱（Z.AI）API Key
- 在 OpenCode 里连接智谱提供商
- 选择一个 GLM 模型并完成第一次对话
🎒 开始前的准备
- [ ] 完成了 1.2 安装，能运行
opencode - [ ] 已能访问智谱控制台并拿到 API Key
跟我做
第 1 步：注册并获取 API Key
智谱入口会有调整，以官网最新为准：
- 管理 API Key（常用）：https://z.ai/manage-apikey/apikey-list
- 另一入口（部分旧教程仍在用）：https://bigmodel.cn
拿到 Key 后先保存好（不要发群、不要提交到 GitHub）。
第 2 步：在 OpenCode 中连接智谱
启动 OpenCode：
bash
opencode输入：
/connect在提供商列表里搜索并选择：
Z.AI（按量计费）Z.AI Coding Plan（如果你订阅了官方 Coding Plan）
然后粘贴你的 API Key。
第 3 步：选择 GLM 模型
输入：
/models选择你想用的模型（例如 glm-4.7）。
第 4 步：发送第一句话（验证成功）
你好，请介绍一下你自己能收到回复就说明连接成功。
检查点 ✅
- [ ]
/models里能看到并选择 GLM 模型（例如glm-4.7） - [ ] 发送消息能收到 AI 回复
踩坑提醒
| 现象 | 原因 | 解决 |
|---|---|---|
没有 Z.AI Coding Plan 选项 | OpenCode 版本太旧 | 升级 OpenCode：opencode upgrade |
API key invalid | Key 格式错误 | 确认是完整的 Key（通常类似 xxx.xxx） |
下一步
- 回到 1.4 总览 选择下一条路线，或进入 2.1 界面与基础操作