OpenCode

通过 OpenCode 的自定义提供方接入 Token Factory，在终端或编辑器中使用国产模型。本文使用 OpenAI Chat Completions 接口。

开始前准备

按OpenCode 官方安装指南安装工具，并确认 opencode --version 可运行。
在控制台创建工具专用 API Key，确认通用余额充足。
从模型文档复制已开放 OpenAI Chat Completions 的模型 ID。编程任务需要模型同时支持工具调用与流式输出。

添加提供方

OpenAI 兼容 Base URL

Base URL 填写 https://api.tokenfactory.cn/v1。客户端追加 /chat/completions 后，最终请求为 https://api.tokenfactory.cn/v1/chat/completions。

1. 保存 API Key

启动 opencode，输入 /connect，选择 Other，将提供方 ID 填为 tokenfactory，再在凭据输入框中粘贴 API Key。此 ID 要与下方配置的 provider.tokenfactory 保持一致。

OpenCode 将凭据保存在本机凭据文件中，不需要把 Key 写进项目配置。已有同名提供方时更新该项即可。

2. 配置模型

编辑用户级配置 ~/.config/opencode/opencode.json，加入以下字段。已有配置时合并 provider 和 model，不要覆盖其他设置。

json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "tokenfactory/<model-id>",
  "provider": {
    "tokenfactory": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Token Factory",
      "options": {
        "baseURL": "https://api.tokenfactory.cn/v1"
      },
      "models": {
        "<model-id>": {
          "name": "<model-id>"
        }
      }
    }
  }
}

将全部 <model-id> 替换成同一个实际模型 ID。顶层 model 使用 提供方 ID/模型 ID，models 内的键使用平台原始模型 ID。

如使用环境变量管理凭据，可以在 options 中添加 "apiKey": "{env:TOKENFACTORY_API_KEY}"，并确保启动 OpenCode 的进程能读取该变量。用户级配置位置与覆盖顺序见官方配置文档。

选择模型并验证

重新打开 OpenCode，输入 /models，选择 Token Factory 下的目标模型。
确认界面显示所选模型，再发送：“只回复‘连接成功’，不读取文件、不执行命令。”
正常回复后，在测试项目中尝试解释一个小文件，验证读取文件、工具调用和回复是否完整。

通用余额按实际请求用量计费。客户端里显示了模型条目，只说明配置已加载；首次对话才能确认当前 Key 与模型可用。

常见问题

现象	检查方法
`/models` 中找不到模型	确认提供方 ID 一致，`models` 已填写，配置文件有效；检查项目级配置是否覆盖了用户配置。
`401` 认证失败	在 `/connect` 中检查 `tokenfactory` 的凭据，或检查环境变量是否对当前进程生效。
`404`	Base URL 必须带 `/v1`，且不能包含 `/chat/completions`。
模型不存在或接口能力不可用	使用模型详情的原始 ID，并确认开放的是 Chat Completions。
普通回复正常，编辑或命令执行失败	检查模型的工具调用能力，以及 OpenCode 当前代理和权限设置。
请求被限流或中途断开	参考错误处理和流式与重试，先检查已完成的文件操作。

OpenCode ​

开始前准备 ​

添加提供方 ​

1. 保存 API Key ​

2. 配置模型 ​

选择模型并验证 ​

常见问题 ​

相关文档 ​