连接模型：第一次对话
📝 课程笔记
本课核心知识点整理：
这是第一阶段的终点
学完这一课，你就能和 AI 对话了。
前面三课是准备工作。这一课是见证成果的时刻。
学完你能做什么
- 理解什么是 API Key（不只是"知道"，是真的理解）
- 成功配置至少一个模型提供商
- 发送第一句话，看到 AI 回复
- 知道怎么选适合自己的模型路线
🎒 开始前的准备
确保你已经完成：
先帮你做个决策：选哪条路线？
🎯 国内用户首选：智谱 GLM-4.7
为什么推荐智谱？
- 第一梯队：国产大模型领先者，推理和代码能力达到开源 SOTA
- 稳定可靠：国内直连，访问速度快、连接稳定
- 功能强大：Pro 套餐支持读图、联网搜索、网页读取
- 价格实惠：Coding Plan 20 元/月起步，量大管饱
👉 直接前往 1.4c 连接智谱
- 只想先体验：OpenCode Zen 免费模型 0 成本跑通流程
如果你有特殊需求，也可以选择其它路线：
| 路线 | 费用/门槛 | 网络要求 | 适合场景 | 去哪里 |
|---|---|---|---|---|
| 智谱 GLM-4.7（推荐） | 20元/月起 | 国内直连 | 国内首选、日常开发 | 1.4c 连接智谱 |
| OpenCode Zen 免费模型 | 限时免费 | 通常可直连 | 0 成本先跑通流程 | 1.4a 免费模型 |
| DeepSeek | 极便宜 | 国内直连 | 日常开发 | 1.4b 连接 DeepSeek |
| MiniMax | 9.9 元起/按量 | 国内直连 | 尝鲜对比 | 1.4d 连接 MiniMax |
| Claude（Anthropic 官方） | 较贵 | 常需代理 | 复杂任务、英文项目 | 1.4e 连接 Claude |
| 第三方中转 | 取决于中转 | 取决于中转 | 有 baseURL + key | 1.4f 第三方中转 |
| Ollama 本地模型 | 免费 | 离线 | 隐私敏感、离线场景 | 1.4g 连接 Ollama |
| 通义千问（阿里云） | 中等 | 国内直连 | 阿里生态 | 1.4h 连接通义千问 |
切换模型
配置完多个模型后，用 /models 命令随时切换：
/models用 ↑ ↓ 选择，按 Enter 确认。
设置默认模型
在 opencode.json 中配置 model 字段，可以设置默认使用的模型：
json
{
"model": "deepseek/deepseek-chat"
}核心概念：什么是 API Key？
在配置之前，先理解一个概念。
API Key 是什么
简单说：API Key 是你访问 AI 服务的"身份凭证"。
更准确地说：
- AI 公司（DeepSeek、智谱、MiniMax 等）提供 AI 服务
- 你想用这个服务，需要有个身份标识
- API Key 就是这个身份标识
- 它还用于计费（用多少，扣多少钱）
API Key 的注意事项
重要：保护好你的 Key
- 不要分享给别人：有了 Key 就能用你的账户消费
- 不要提交到 GitHub：有人专门扫描 GitHub 盗用 Key
- 不要截图发社交媒体：你懂的
万一泄露了，立刻去官网删掉旧 Key，创建新的。
在 OpenCode 里你会用到的两个命令
/connect：添加/切换提供商并录入 API Key/models：选择具体模型（不同提供商会提供不同模型）
提示：凭证通常会被安全保存到本地（例如
~/.local/share/opencode/auth.json）。
检查点 ✅
完成任意一个子章节后，你应该能做到：
- [ ] 输入
/models能看到已配置的模型 - [ ] 发送消息后能收到 AI 回复
- [ ] 没有报错（如
API key invalid或connection error）
下一步该学什么？
当你已经成功完成第一次对话，就可以进入第二阶段：
遇到问题？
连接模型时卡住了？加入社群，和 500+ 同路人一起交流，实时答疑。