OpenCode 接入 ModelFold

首次会话积分消耗偏高属正常现象

Agent 每次请求都会携带固定的工具定义和系统提示（通常有数万 token）。首次会话这部分内容需要写入缓存，按全量输入计费，所以消耗的积分会比较多；之后的请求命中缓存，这部分按低价缓存计费，消耗会明显下降。这是正常现象，并非多扣费。如有大量使用需求，请联系客服，我们可提供优惠。

全部编程工具 · 更多工具接入 · 不支持与受限工具

OpenCode 1.19.5：使用本页 OpenAI 兼容配置完成最小对话，返回 OK；未验证所有编码工具。 配置入口支持不等于每个模型、每项 Agent 功能都已验证。

安装与准备

通过官方文档中的安装入口安装正式版本；编辑器插件请在对应商店选择官方发布者。到 ModelFold API Keys 创建密钥。配置中出现 MODELFOLD_API_KEY 时，启动工具前设置环境变量：

export MODELFOLD_API_KEY="YOUR_MODELFOLD_API_KEY"

密钥不要提交到项目仓库或贴到截图中。图形界面密钥框通常填写原始 Key，由客户端添加认证头。

配置提供商

配置位置： opencode.json。验证状态： OpenCode 1.19.5：使用本页 OpenAI 兼容配置完成最小对话，返回 OK；未验证所有编码工具。

安装 opencode-ai。下方配置适用于本次安装测试的版本；设置 MODELFOLD_API_KEY 后使用 opencode run -m modelfold/gpt-6-luna。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "modelfold": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ModelFold",
      "options": {
        "baseURL": "https://modelfold.ai/v1",
        "apiKey": "{env:MODELFOLD_API_KEY}"
      },
      "models": {
        "gpt-6-luna": {
          "name": "ModelFold test",
          "limit": {
            "context": 128000,
            "output": 1024
          }
        }
      }
    }
  }
}

Claude 原生配置改为 @ai-sdk/anthropic、baseURL=https://modelfold.ai/anthropic/v1，并登记 Claude 模型。新版文档使用 providers/package/settings；不要把新版字段混进旧版客户端。

接 Claude 优先使用 Anthropic 原生格式，符合条件的重复上下文可使用缓存；命中仍取决于模型、前缀和客户端是否发送缓存标记，不能保证每轮都命中。

官方配置依据。

模型与地址

字段	填写内容
本页示例地址	https://modelfold.ai/v1
API 模型 ID	gpt-6-luna
凭证	ModelFold 控制台创建的 API Key

模型 ID 以全部模型 ID为准。openai/ 等前缀在部分 CLI 中用来选择适配器，不属于服务端模型 ID。不同工具拼接路径的规则不同，严格按本页填写，不重复添加 /v1 或 /messages。

验证

新建会话，明确选中刚配置的提供商与模型，发送：只回复 OK，不要使用工具。 收到回复只证明该模型的基本对话可用。再到 ModelFold 用量记录 核对相应请求；模型出现在列表里不代表连通性验证通过。开始长任务前，可在临时项目中试一次小修改。

常见问题

现象	处理
401	检查是否为 ModelFold Key，而非工具订阅凭证；去掉首尾空格。
404	核对协议、路径后缀与准确模型 ID，避免重复 /v1。
模型列表为空	支持手动输入的工具可复制准确 ID；环境变量修改后重启客户端。
对话通但工具调用失败	选择支持工具调用的模型；基本聊天兼容不保证全部 Agent 功能。
仍然调用内置服务	显式切换到自定义提供商，检查旧设置和环境变量覆盖。

报价以模型价格页为准。一次任务可能产生多次请求；实际扣费以账户记录为准，客户端估算不等于实际扣费。