OpenCode 中文教程

Appearance

连接模型：第一次对话 ​

📝 课程笔记 ​

本课核心知识点整理：

连接模型：第一次对话学霸笔记

这是第一阶段的终点 ​

学完这一课，你就能和 AI 对话了。

前面三课是准备工作。这一课是见证成果的时刻。

学完你能做什么 ​

  • 理解什么是 API Key（不只是"知道"，是真的理解）
  • 成功配置至少一个模型提供商
  • 发送第一句话，看到 AI 回复
  • 知道怎么选适合自己的模型路线

🎒 开始前的准备 ​

确保你已经完成：

  • [ ] 完成了 1.2 安装，opencode --version 能看到版本号
  • [ ] 如果你要用国际模型或境外中转，完成了 1.3 网络配置

先帮你做个决策：选哪条路线？ ​

你只需要完成下面任意一个子章节，就能完成“第一次对话”。

路线费用/门槛网络要求适合你去哪里
OpenCode Zen 免费模型限时免费通常可直连想 0 成本先跑通流程1.4a 免费模型
DeepSeek极便宜国内直连国内用户首选、日常开发1.4b 连接 DeepSeek
智谱 Z.AI / GLM套餐/按量国内直连中文强、Coding Plan1.4c 连接智谱
MiniMax9.9 元起/按量国内直连想尝鲜对比、多模型1.4d 连接 MiniMax
Claude（Anthropic 官方）较贵常需代理复杂任务、英文项目1.4e 连接 Claude
第三方中转（Claude Code 兼容）取决于中转取决于中转有 baseURL + key，想走中转1.4f 第三方中转
Ollama 本地模型免费离线隐私敏感、离线场景1.4g 连接 Ollama
通义千问（阿里云）中等国内直连全能通用、阿里生态1.4h 连接通义千问

一句话推荐

  • 国内用户：先用 DeepSeek（便宜、好用、少踩坑）
  • 只想先体验：先用 OpenCode Zen 免费模型跑通流程

国产模型对比 ​

配置完模型后，你可能会想：哪个模型更适合我？

模型特点价格适合场景
DeepSeek性价比之王、代码能力强极低日常开发、写作
智谱 GLM长上下文、稳定中等长文档分析、中文写作
MiniMax多模态、创意强中等创意写作、对话
通义千问阿里系、全能中等通用任务、企业场景

切换模型 ​

配置完多个模型后，用 /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+ 同路人一起交流，实时答疑。