Skip to main content
OpenCode 是一个基于终端的编码智能体，支持自定义模型提供商。在 opencode.json 中使用 @ai-sdk/openai-compatible 包将 Tokios 添加为提供商，将 options.baseURL 指向 https://api.tokios.com/v1，并在 models 下列出您的 Tokios 部署名称。随后，OpenCode 会将每个智能体请求通过您的私有连接器隧道路由到本地模型。

​
前置条件

  • 一个已运行并与本地模型配对的 Tokios 连接器——请参阅 连接器安装
  • 一个已注册的模型部署名称——请参阅 注册模型
  • 一个 Tokios API 密钥 (sk-tok-…)——请参阅 API 密钥
  • 已安装 OpenCode

​
配置 OpenCode

在您的 opencode.json 配置文件中添加一个 Tokios 提供商配置块。配置文件的确切位置（项目本地的 opencode.json 与全局配置路径）以及精确的键名（options、npm、models）可能因 OpenCode 版本而异，因此请对照已安装版本的提供商配置架构进行确认。
opencode.json
将 gemma-tunnel 替换为您的公共部署名称，也就是您在 Models 选项卡中注册的名称，而不是您的后端（Ollama、llama.cpp、vLLM 或 LM Studio）使用的本地模型 ID。将 sk-tok-YOUR_KEY 替换为您自己的密钥，并避免将其提交到共享或受版本控制的配置文件中。
options.baseURL 必须包含 /v1。OpenCode 的 OpenAI 兼容提供商会相对于此 URL 发送请求，因此缺少 /v1 的基础 URL 将无法访问 Tokios API 接口。

​
选择支持工具调用的模型

OpenCode 智能体依赖工具调用来读取文件、运行命令和编辑代码。并非每个本地模型都能可靠地处理工具调用——在依赖 OpenCode 智能体进行实际编辑之前，请选择由工具调用能力较强的模型提供支持的部署。请参阅 选择本地模型 了解如何比较候选模型。

​
故障排除

OpenCode 发送的 API 密钥缺失、格式错误或已被撤销。确认 options.apiKey 包含完整的 sk-tok-… 密钥且无多余空白字符，并在 Keys 选项卡上检查其状态。
配置中 models 下的模型键与已注册的部署不匹配。确认它完全匹配 Models 选项卡上的公共名称——而不是您的 Ollama、llama.cpp、vLLM 或 LM Studio 本地模型 ID。
该部署的连接器处于离线状态或已达到并发上限。检查 Connectors 选项卡——连接器需要显示为 Online，且运行它的机器需要仍然处于运行状态并可访问。

​
后续步骤

兼容客户端

查看其他 OpenAI 和 Anthropic 兼容客户端的基础 URL 和密钥设置。

选择本地模型

在智能体工作流中采用某个部署之前，先比较后端和模型。