OpenCode 中文教程

简体中文

English

简体中文

English

Appearance

连接模型：第一次对话 ​

📝 课程笔记 ​

本课核心知识点整理：

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

这是第一阶段的终点 ​

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

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

学完你能做什么 ​

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

🎒 开始前的准备 ​

确保你已经完成：

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

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

🎯 国内用户首选：智谱 GLM-4.7

为什么推荐智谱？

  • 第一梯队：国产大模型领先者，推理和代码能力达到开源 SOTA
  • 稳定可靠：国内直连，访问速度快、连接稳定
  • 功能强大：Pro 套餐支持读图、联网搜索、网页读取
  • 价格实惠：Coding Plan 20 元/月起步，量大管饱

👉 直接前往 1.4c 连接智谱

如果你有特殊需求，也可以选择其它路线：

路线费用/门槛网络要求适合场景去哪里
智谱 GLM-4.7（推荐）20元/月起国内直连国内首选、日常开发1.4c 连接智谱
OpenCode Zen 免费模型限时免费通常可直连0 成本先跑通流程1.4a 免费模型
DeepSeek极便宜国内直连日常开发1.4b 连接 DeepSeek
MiniMax9.9 元起/按量国内直连尝鲜对比1.4d 连接 MiniMax
Claude（Anthropic 官方）较贵常需代理复杂任务、英文项目1.4e 连接 Claude
第三方中转取决于中转取决于中转有 baseURL + key1.4f 第三方中转
Ollama 本地模型免费离线隐私敏感、离线场景1.4g 连接 Ollama
OpenAI（GPT / Codex）较贵常需代理通用场景1.4h 连接 OpenAI
通义千问（阿里云）中等国内直连阿里生态1.4i 连接通义千问
GitHub Copilot需已有订阅可直连复用 Copilot 订阅1.4j GitHub Copilot

核心概念：什么是 API Key？ ​

在配置之前，先理解一个概念。

API Key 是什么 ​

简单说：API Key 是你访问 AI 服务的"身份凭证"。

更准确地说：

  • AI 公司（DeepSeek、智谱、MiniMax 等）提供 AI 服务
  • 你想用这个服务，需要有个身份标识
  • API Key 就是这个身份标识
  • 它还用于计费（用多少，扣多少钱）

API Key 的注意事项 ​

重要：保护好你的 Key

  • 不要分享给别人：有了 Key 就能用你的账户消费
  • 不要提交到 GitHub：有人专门扫描 GitHub 盗用 Key
  • 不要截图发社交媒体：你懂的

万一泄露了，立刻去官网删掉旧 Key，创建新的。

两种配置方式 ​

OpenCode 提供两种配置模型提供商的方式：

方式场景命令
TUI 内启动 OpenCode 后在界面里配置/connect
终端 CLI启动前在命令行配置opencode auth login

两种方式效果一样，选你顺手的用。

方式一：TUI 内用 /connect ​

在 OpenCode 界面输入：

/connect

会弹出提供商选择界面，按提示操作即可。

方式二：终端用 opencode auth login ​

在启动 OpenCode 之前，在终端运行：

bash
opencode auth login

你会看到提供商列表：

? Select provider
❯ OpenCode (recommended)
  Anthropic (Claude Max or API key)
  GitHub Copilot (ChatGPT Plus/Pro or API key)
  OpenAI (ChatGPT Plus/Pro or API key)
  Google
  ...

选择后按提示输入 API Key 或完成 OAuth。

查看已配置的提供商 ​

bash
opencode auth list
# 或简写
opencode auth ls

你会看到：

Credentials ~/.local/share/opencode/auth.json
√ OpenCode api

Environment
√ OpenCode OPENCODE_API_KEY

认证优先级 ​

OpenCode 按以下顺序查找认证：

  1. 环境变量（如 ANTHROPIC_API_KEY、OPENAI_API_KEY）
  2. auth.json 文件（~/.local/share/opencode/auth.json）
  3. 配置文件中的认证信息

提示

凭证存储位置：~/.local/share/opencode/auth.json（所有平台统一，遵循 XDG 规范）

切换模型 ​

配置完多个模型后，在 TUI 内用 /models 命令随时切换：

/models

用 ↑ ↓ 选择，按 Enter 确认。

设置默认模型

在 opencode.json 中配置 model 字段，可以设置默认使用的模型：

json
{
  "model": "deepseek/deepseek-chat"
}

检查点 ✅ ​

完成任意一个子章节后，你应该能做到：

  • [ ] 输入 /models 能看到已配置的模型
  • [ ] 发送消息后能收到 AI 回复
  • [ ] 没有报错（如 API key invalid 或 connection error）

下一步该学什么？ ​

当你已经成功完成第一次对话，就可以进入第二阶段：

遇到问题？

连接模型时卡住了？加入社群，和 2000+ 同路人一起交流，实时答疑。