OpenCode Go 订阅与配置实战教程：15 分钟上手使用开源模型

📚 分类: AI 编程工具配置 ⏱️ 预计耗时: 15 分钟 🎯 难度: 入门 🔧 环境要求: 已安装 OpenCode TUI 或已注册 OpenCode Zen 账号

---

你将学到什么

完成本教程后，你将能够：

• [ ] 理解 OpenCode Go 是什么，以及它为什么比直接使用其他 API 更方便。
• [ ] 订阅 OpenCode Go 服务，并获取你的专属 API 密钥。
• [ ] 配置 OpenCode TUI，使其使用你订阅的 Go 模型。
• [ ] 查看可用模型列表，并开始使用。
• [ ] 管理你的使用配额，避免意外超额。

最终效果

你将成功在 OpenCode TUI 中连接到 OpenCode Go 服务，并能够像使用其他提供商（如 OpenAI、Anthropic）一样，选择并使用像 DeepSeek V4 Flash 这样的开源模型进行编程。

---

前置准备

在开始前，请确认你的环境满足以下条件：

检查项	要求	说明
OpenCode 账户	已注册	你需要一个 OpenCode 账户来订阅服务。
OpenCode TUI	已安装	这是你主要使用的命令行工具。
支付方式	国际信用卡/PayPal	用于支付首月 5 美元的订阅费。

1. 安装 OpenCode TUI（如果尚未安装）

首先，你需要安装 OpenCode 的命令行界面工具。

# 使用你喜欢的包管理器安装
$ brew install opencode   // macOS 用户
$ winget install opencode // Windows 用户
$ npm install -g @opencode/cli // 通用方式

# 验证安装
$ opencode --version

✅ 验证：如果看到类似 v0.x.x 的版本号，说明安装成功。

---

第 1 步：订阅 OpenCode Go 服务并获取 API 密钥

🎯 目标：完成支付订阅，拿到像 sk-opencode-go-... 这样的 API 密钥。

📝 操作：

1. 打开你的浏览器，访问 OpenCode Zen 并登录。
2. 在左侧导航栏或控制台面板中，找到并点击 Go 或 订阅 相关的选项。
3. 你会看到一个订阅计划介绍：首月 5 美元，之后每月 10 美元。点击 立即订阅 或类似按钮。
4. 按照页面提示完成支付流程。
5. 支付成功后，页面会跳转到一个 API 密钥管理 页面。你会看到一个新生成的密钥，格式类似 sk-opencode-go-xxxxx。

🤔 为什么要这样做？ OpenCode Go 是一个付费订阅服务。订阅后，你才能获得专用的 API 密钥。这个密钥是你的“通行证”，OpenCode TUI 需要它来验证你的身份并调用模型。

✅ 验证： 在 API 密钥管理页面，你应该能看到一个状态为“活跃”的密钥。请立即复制并安全保存这个密钥，关闭页面后你将无法再次查看完整密钥。

⚠️ 常见错误：

• 支付失败：确保你的支付方式支持国际支付，并且有足够的余额。
• 找不到订阅入口：在 OpenCode Zen 界面中，寻找“订阅”、“计划”、“Go”或“设置”等菜单。

---

第 2 步：在 OpenCode TUI 中连接 Go 服务

🎯 目标：将你刚刚获取的 API 密钥配置到 OpenCode TUI 中，建立连接。

上一步我们完成了服务订阅并拿到了 API 密钥，现在需要将这个密钥配置到 TUI 中，这样它才能使用 Go 服务。

📝 操作：

1. 打开你的终端，启动 OpenCode TUI：

   $ opencode

2. 在 TUI 界面中，按下 : 键进入命令模式（Vim 风格）。输入以下命令并回车：

   /connect

3. TUI 会显示一个提供商列表。使用键盘上下键选择 OpenCode Go，然后按回车。
4. 系统会提示你输入 API 密钥。粘贴你之前复制的密钥（sk-opencode-go-...），然后按回车。
5. 连接成功后，你会看到一条确认消息，例如 Connected to OpenCode Go。

✅ 验证： 在 TUI 界面中，状态栏（通常在底部）应该会显示已连接的提供商信息，例如 [Go] 或 Connected: Go。

💡 提示：

• 每个工作空间（Workspace）只能有一名成员订阅 OpenCode Go。如果你的团队已经有人订阅了，你需要联系他获取共享的 API 密钥，或者自己单独订阅。
• 如果粘贴密钥时遇到问题，可以尝试使用快捷键 Ctrl+Shift+V (Windows/Linux) 或 Cmd+V (macOS)。

---

第 3 步：查看可用模型并开始使用

🎯 目标：浏览 Go 服务提供的模型列表，并选择一个模型开始你的第一次对话。

现在你已经成功连接到 Go 服务，让我们看看它提供了哪些模型，并开始使用。

📝 操作：

1. 在 TUI 中，再次进入命令模式，输入：

   /models

2. TUI 会显示所有可用的模型列表，包括模型名称、ID 和提供商。例如，你会看到：
   • opencode-go/deepseek-v4-flash (DeepSeek V4 Flash)
   • opencode-go/glm-5 (GLM-5)
   • opencode-go/kimi-k2.5 (Kimi K2.5)
   • ...以及其他模型。
3. 要选择一个模型，你可以：
   • 方法 A（推荐）：在 /models 列表中，使用键盘上下键高亮你想要的模型，然后按回车。这会将模型设置为当前会话的默认模型。
   • 方法 B：在命令模式下，直接输入 /model opencode-go/deepseek-v4-flash 来切换模型。
4. 现在，你就可以像往常一样开始提问了。例如，输入 写一个 Python 的斐波那契数列函数。

🤔 为什么要这样做？/models 命令让你能随时查看当前提供商（Go）下有哪些模型可用。/model 命令则让你在不同的模型之间切换，以找到最适合当前任务的模型。模型 ID 前的 opencode-go/ 前缀表明该模型是通过 Go 服务提供的。

✅ 验证： 在输入你的问题后，TUI 应该会正常调用模型并开始生成回答。你会看到模型名称显示在对话中，例如 [opencode-go/deepseek-v4-flash]。

⚠️ 常见错误：

• 模型列表为空：如果执行 /models 后列表为空，说明连接可能有问题。请回到第 2 步，确认 API 密钥配置正确。
• 调用模型时出错：如果出现 Error: 401 Unauthorized，说明你的 API 密钥无效或已过期。请回到第 1 步，重新生成密钥。

---

进阶技巧（可选）

1. 跟踪你的使用配额

Go 服务有使用限制（5小时/周/月）。你可以在 OpenCode Zen 的控制台中查看实时用量。

📝 操作：

1. 访问 OpenCode Zen 控制台。
2. 在仪表盘或“使用情况”页面，你会看到以美元计价的已使用额度。

2. 超出限制后使用余额

如果你在 Zen 账户中还有积分（积分），可以在控制台中启用“使用余额”（Use balance）选项。这样，当你达到 Go 的月度限制后，系统会自动使用你的积分来继续服务，而不是直接中断。

3. 通过 API 端点调用 Go 模型（高级）

如果你不只是用 TUI，还想在自定义脚本或应用中使用 Go 模型，可以通过 OpenAI 兼容的 API 端点来调用。

示例（使用 curl）：

# 调用 DeepSeek V4 Flash 模型
$ curl https://opencode.ai/zen/go/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_GO_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

---

常见问题 (FAQ)

Q1: 订阅后，我可以在多个设备上使用同一个 API 密钥吗？A: 可以。API 密钥与你的账户绑定，你可以在所有安装了 OpenCode TUI 的设备上使用同一个密钥。

Q2: 我达到了使用限制，接下来怎么办？A: 你可以选择：

1. 等待：限制会在下一个周期（5小时/周/月）重置。
2. 使用免费模型：OpenCode 也提供一些免费的模型，你可以在 TUI 中切换到它们。
3. 使用余额：如果你在 Zen 账户中有积分，可以启用“使用余额”选项（详见进阶技巧）。

Q3: 如何取消订阅？A: 登录 OpenCode Zen，在订阅管理页面找到取消订阅的选项。取消后，你将在当前计费周期结束后失去对 Go 模型的访问权限。

Q4: 模型列表会更新吗？A: 会的。OpenCode 团队会持续测试和添加新的开源模型。你可以定期在 TUI 中执行 /models 命令来查看最新列表。

Q5: 为什么我的请求数比文档预估的少？A: 文档中的请求数是基于“典型使用模式”的预估值。实际请求数取决于你的输入长度、输出长度和缓存命中率。如果你使用较长或较复杂的提示词，消耗的配额会更多。

---

总结

恭喜你完成了本教程！🎉

回顾一下我们今天学到的核心内容：

1. 订阅与密钥获取：通过 OpenCode Zen 订阅服务，获取 API 密钥是第一步。
2. TUI 配置：使用 /connect 命令将密钥配置到 TUI 中，建立连接。
3. 模型选择：使用 /models 和 /model 命令查看和切换可用的开源模型。
4. 配额管理：理解 Go 服务的使用限制，并知道如何查看和应对超出限制的情况。

你现在已经可以低成本、稳定地使用各种强大的开源编程模型了！

---