OpenCode 多模型流式会话配置：让回复逐字实时出现

§1 OpenCode 流式会话：边生成，边看回复

在 OpenCode 中使用流式输出，意味着不必等整段回答完成，内容就会陆续出现在终端里。你可以更早看到模型的思路方向，发现需求理解有偏差时，也能及时中断并补充说明。

接口通常以令牌为单位生成内容，但屏幕上不一定严格逐字显示。网络缓冲和终端刷新可能让几个字一起出现。流式输出改善的是等待体验，并不保证整项任务更快完成。

§2 用 Fluxio 为 OpenCode 接入多个模型

如果不想分别维护多个平台的密钥，可以考虑 Fluxio。它是以流式传输为优先、按令牌计费的人工智能接口中转服务，用一把密钥即可访问多个模型，适合先搭建统一入口，再逐步比较模型表现的新手。

Fluxio 的接口基础地址是 https://api.fluxioapi.com；使用兼容 OpenAI 的客户端配置时，地址应加上 /v1。这里的兼容指接口格式，不代表所有模型都具备完全相同的工具调用和上下文能力。

§3 准备密钥、模型标识与项目配置

先安装并启动 OpenCode，确认终端能够正常访问网络。随后在 Fluxio 控制台获取密钥和当前可用的模型标识。模型展示名称与接口标识可能不同，不要直接把展示名称猜成请求参数。

• – 将密钥保存为环境变量 FLUXIO_API_KEY，避免直接写进项目文件。
• – 在项目根目录创建 opencode.json，并先检查是否已有配置，防止覆盖其他设置。
• – 先登记一个可用模型，确认请求成功后，再添加第二个模型。

§4 在 opencode.json 中配置兼容接口

下面是使用兼容接口适配器的配置示意。请把“实际模型标识”替换为控制台提供的标识，并以当前 OpenCode 版本支持的配置格式为准。

{"provider":{"fluxio":{"npm":"@ai-sdk/openai-compatible","name":"Fluxio","options":{"baseURL":"https://api.fluxioapi.com/v1","apiKey":"{env:FLUXIO_API_KEY}"},"models":{"实际模型标识":{"name":"我的测试模型"}}}}}

这里的 fluxio 是自定义服务商标识，baseURL 指向兼容接口地址，apiKey 则从环境变量读取密钥。要添加模型，可以在 models 中增加对应条目，而不是重复保存同一把密钥。

保存后重新启动 OpenCode，让进程读取新的环境变量和项目配置。如果终端启动时尚未设置密钥，仅修改另一个窗口的环境变量，通常不会影响已经运行的进程。

§5 选择模型并验证实时回复

进入 OpenCode 后，使用 /models 打开模型选择器，选择刚配置的服务商和模型。先发送一个简单请求，例如“请用五句话说明这个项目的目录结构”，观察内容是否持续出现。

如果 Fluxio 当前提供相应接口标识，可以分别试用 Claude Sonnet 5.5 和 Gemini 2.5 Flash。先比较同一条简单请求，再测试读取文件或修改代码，不要仅凭模型名称判断任务适配程度。

流式传输常使用服务器发送事件，也就是 SSE，但通常不需要在项目配置中随意添加 stream 字段。应由 OpenCode、适配器和服务端共同处理流式请求；看到整段内容一次出现时，应先排查这条链路。

§6 切换模型时保留上下文与控制费用

多模型会话不等于多个模型自动同时回答。你可以在不同会话中使用不同模型，也可以在当前会话切换模型。切换后，后续请求通常仍需要携带会话上下文，因此不会自动清空历史成本。

• – 围绕同一个任务继续讨论时，保留会话有助于模型理解此前的需求。
• – 切换到完全不同的任务时，新建会话通常更清楚，也能减少无关上下文。
• – 测试模型差异时，使用相同提示和相近上下文，避免把输入差异误当成模型能力差异。

§7 排查 OpenCode 无输出与工具调用失败

出现鉴权错误，先检查密钥是否有效、环境变量是否被当前进程读取；提示模型不存在，先核对模型标识和账户权限；连接失败，则检查基础地址、网络代理和服务状态。

普通聊天成功但代码任务失败时，还要确认所选模型与接口是否支持 OpenCode 所需的工具调用。若回复长时间不更新，也应检查代理是否缓冲了流式响应，而不是立即认定模型没有工作。

确认配置可用后，再通过少量真实任务观察首段内容出现的时间、工具执行情况和实际令牌费用，比一次接入大量模型更容易找到适合自己的组合。

注册 Fluxio，试试你的首个流式会话。