在 Hermes Agent 中使用 OpenCode Go 订阅非常简单，主要有三种配置方式。OpenCode Go 是 opencode.ai 推出的 **$10/月**（首月 $5）的模型聚合订阅服务，用一个 API Key 即可访问 Kimi、DeepSeek、Qwen、GLM、MiniMax 等多款模型。

一、获取 OpenCode Go API Key

1. 打开浏览器，访问（使用此链接订阅可获赠$5的使用额度）：OpenCode Go | Low cost coding models for everyone
2. 订阅 Go 计划（支持支付宝付款）
3. 进入 API Keys 页面，点击 Create Key
4. 复制以 sk- 开头的 API Key（只显示一次，请妥善保存）

---

二、配置方式（任选一种）

方式 1：交互式配置（推荐新手）

hermes model

在交互向导中选择 OpenCode Go，粘贴你的 sk- API Key，然后选择默认模型（如 deepseek-v4-pro 或 kimi-k2.6）。

方式 2：环境变量配置

在 ~/.hermes/.env 文件中添加：

OPENCODE_GO_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

然后设置默认模型：

hermes config set model.default deepseek-v4-pro
hermes config set model.provider opencode-go

方式 3：手动编辑 config.yaml

编辑 ~/.hermes/config.yaml：

model:
  default: deepseek-v4-pro      # 或 kimi-k2.6、qwen3.6-plus 等
  provider: opencode-go
  base_url: https://opencode.ai/zen/go/v1
  api_mode: chat_completions

同时在 ~/.hermes/.env 中：

OPENCODE_GO_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

---

三、验证配置

# 查看当前配置
hermes config get model

# 测试对话
hermes chat -m deepseek-v4-pro "你好"

# 查看可用模型列表
hermes models

---

四、可用模型清单

OpenCode Go 当前支持的模型包括（随时可能更新）：

模型 ID	说明
deepseek-v4-pro	1M 上下文，最强代码能力
deepseek-v4-flash	快速版 DeepSeek
kimi-k2.6 / kimi-k2.7-code / kimi-k3	Moonshot 系列
qwen3.6-plus / qwen3.7-plus / qwen3.7-max / qwen3.8-max	通义千问系列
minimax-m3 / minimax-m2.7	512K 上下文
glm-5.1 / glm-5.2 / glm-5.3	智谱 GLM 系列
grok-4.5	xAI Grok
mimo-v2.5 / mimo-v2.5-pro	MiMo 系列

---

五、重要注意事项

1. 模型名不要加前缀：使用 deepseek-v4-pro，不要写成 opencode-go/deepseek-v4-pro，否则会报 warning。
2. 修改配置后需重置会话：Hermes 在会话启动时读取配置，修改后执行 /reset 或重启进程才能生效。
3. 配置 Fallback（推荐）：防止单模型限流或故障：

# config.yaml
fallback_providers:
  - provider: opencode-go
    model: qwen3.6-plus
  - provider: opencode-go
    model: minimax-m3

1. 区分 OpenCode Zen 和 OpenCode Go：
   • Zen：按需付费，Key 为 OPENCODE_ZEN_API_KEY
   • Go：$10/月订阅，Key 为 OPENCODE_GO_API_KEY，provider 为 opencode-go
2. 常见问题排查：
   • 401 错误：检查 Key 是否以 sk- 开头，有无多余空格或换行
   • 404 模型不存在：确认使用精确模型 ID，不要猜测或简写
   • 429 限流：各模型有独立上游限流，可等待几秒或切换模型

---

六、快速启动命令

# 一次性对话
hermes chat -m deepseek-v4-pro --provider opencode-go "帮我写一个 Python 爬虫"

# 启动交互式会话
hermes -m deepseek-v4-pro

# 切换模型（会话中）
/model kimi-k2.6

配置完成后，你就可以在 Hermes Agent 中自由切换 OpenCode Go 提供的各种模型进行编程和 Agent 任务了。