OpenCode 接入

本指南帮助你在 OpenCode 中配置 MoaCode 作为 AI 模型供应商，通过统一网关调用 Claude、GPT 等多种主流模型。配置完成后，可在 OpenCode 中直接选用 MoaCode 支持的任意模型，享受自动故障切换与统一计费。

前提条件

• 已安装并正常运行 OpenCode
• 已注册 MoaCode 账号，并获取有效 API Key（cr_ 开头）
• 明确计划使用的模型 ID（如 claude-opus-4-8、gpt-5.5），完整列表见模型目录与价格或站内 Model catalog

配置步骤

1. 准备配置文件

OpenCode 的自定义供应商配置文件位于 ~/.opencode/agent/models.json。若目录或文件不存在，手动创建：

mkdir -p ~/.opencode/agent
touch ~/.opencode/agent/models.json

2. 选择配置方案

MoaCode 支持两种协议接入方式，一般建议直接使用方案 A。

方案 A：OpenAI 兼容协议（推荐）

编辑 ~/.opencode/agent/models.json，写入：

{
  "$schema": "https://moacode.org/v1",
  "model": "openai"
}

该方案依赖第 3 步的环境变量提供 Key 与端点。

方案 B：Anthropic SDK

若确需使用 Anthropic 协议（Claude 模型），可参考以下配置：

{
  "provider": {
    "moacode": {
      "npm": "@ai-sdk/anthropic",
      "name": "Moacode",
      "options": {
        "baseURL": "https://moacode.org/v1",
        "apiKey": "你的APIKey"
      },
      "models": {
        "claude-opus-4-8": {
          "name": "Claude Opus 4.8"
        }
      }
    }
  },
  "model": "moacode/claude-opus-4-8"
}

3. 设置环境变量（方案 A 需要，方案 B 不需要）

在终端执行：

export OPENAI_API_KEY='你的APIKey'
export OPENAI_BASE_URL='https://moacode.org/v1'

使用单引号

API Key 可能包含 $、!、& 等特殊字符，单引号可防止 Shell 进行变量替换。想长期生效请写入 ~/.zshrc / ~/.bashrc。

4. 验证配置格式

cat ~/.opencode/agent/models.json | python3 -m json.tool

无报错即格式正确。常见错误是多余逗号、缺少引号，按提示修正即可。

5. 重启 OpenCode

完全退出 OpenCode 并重新启动，使配置生效。

6. 切换模型并测试

在聊天输入框输入 /model，从下拉列表选择以 moacode/ 开头的模型（如 moacode/gpt-5.5 或 moacode/claude-opus-4-8）。

使用 GPT 模型时，可选 MoaCode 提供的：gpt-5.5、gpt-5.6-sol、gpt-5.6-terra、gpt-5.4、gpt-5.4-mini、Codex-Auto-Review。

发送一条测试消息（如 "Hello"），正常响应即配置成功。

故障排除

问题现象	可能原因	解决方案
模型列表未出现 Moacode	配置文件路径错误或 JSON 格式有误	检查文件是否存在及格式正确，重启 OpenCode
请求返回 401 / 403	API Key 无效或未加载	确认环境变量已正确设置、密钥有效；专用 Key 检查授权范围
请求返回 404	模型 ID 不支持	对照模型目录更正模型标识符
连接超时	baseURL 错误或网络不通	核对 API 入口地址，检查网络 / 代理
响应异常	协议类型错误	确认使用 openai-responses（方案 A）

仍未解决可查看 OpenCode 日志，或通过工单与 QQ 群联系我们。

相关页面

• 模型目录与价格
• OpenClaw 接入 — 同类开源客户端
• 常见报错与排查