在 OpenCode 中使用 ZhiFlo

OpenCode 可以把凭据保存在本地认证存储中，把服务地址和模型保存在用户级配置。完成后，/models 会显示 ZhiFlo 模型，你可以在当前会话中选用它。

开始前

• 已按照 OpenCode 官方文档安装客户端；opencode --version 能显示版本信息。
• 已创建一枚当前设备专用的 Token。
• 已复制账户当前可用的完整 模型 ID。

保存 Token

1. 在终端运行 opencode。
2. 在 OpenCode 中输入 /connect。
3. 选择 Other。
4. 输入 Provider ID：zhiflo。
5. 在凭据提示中粘贴 ZhiFlo Token。

Provider ID 必须与下一节配置中的 zhiflo 完全一致。Token 会进入 OpenCode 的本地凭据存储，不要把它再写入 JSON。

添加 ZhiFlo provider

打开全局配置文件：

~/.config/opencode/opencode.json

Windows 中 ~ 表示当前用户主目录。如果文件已有其他设置，把下面的 provider.zhiflo 合并进去，不要覆盖整份文件。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "zhiflo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ZhiFlo",
      "options": {
        "baseURL": "https://api.zhiflo.com/v1"
      },
      "models": {
        "<MODEL_FROM_ZHIFLO>": {
          "name": "<MODEL_FROM_ZHIFLO>"
        }
      }
    }
  }
}

把两处 <MODEL_FROM_ZHIFLO> 都替换为同一个完整模型 ID。外层键是服务端识别值，name 是本地显示名称；初次配置时保持一致最不容易混淆。

保存文件后退出 OpenCode，再重新运行 opencode，让它读取全局配置。

选择模型并发送第一条消息

1. 输入 /models。

2. 找到 zhiflo 下刚添加的模型并选择。

3. 在空目录或不含重要文件的项目中发送：

   不要修改任何文件，只回答 OK。

模型出现在 /models 只说明配置已加载；收到 OK 才说明 Token、地址、模型和请求共同可用。

没有看到模型或回复

• /models 中没有 zhiflo：检查文件路径、JSON 逗号和括号，并确认 /connect 中的 Provider ID 也是 zhiflo。
• 能看到模型但返回 401：重新运行 /connect → Other → zhiflo，更新本地 Token。
• 返回 404：确认 baseURL 是 https://api.zhiflo.com/v1，且没有再手工添加 /chat/completions。
• 模型不存在：让配置键与账户返回的完整 ID 完全一致，然后重开 OpenCode。

不要用管理员或 sudo 权限启动 OpenCode 来处理普通配置问题；这会创建错误所有者的配置文件并扩大工具权限。

下一步：查看 统一故障排查。