客户端接入检查清单：终端能用，为什么应用里不能用？

先确认协议#

Chat Completions、Responses、Anthropic Messages、Gemini 风格接口的字段和事件不同。客户端只写着“自定义供应商”，不代表它支持所有协议。

完整请求路径应与 地址说明 对照。不要将三个接口的请求体互相混用。

配置要写在真正运行程序的位置#

Windows 桌面应用、WSL、Docker、远程 SSH 扩展可能读取不同的环境变量和配置文件。改了本机文件，但程序运行在远端，设置不会自动过去。

保存后检查客户端显示的供应商和模型。必要时按客户端文档重开进程，让它重新读取环境变量。不要把重装应用当成第一步。

再比较最小请求与完整会话#

先建一个不带历史、不带工具、不带图片的新会话。如果短文本成功，旧会话失败，逐项加入历史、工具和附件，找出触发差异的部分。上下文过长、附件格式不支持和函数参数不兼容，都可能只在完整会话出现。

流式出问题时，检查 SSE 与缓冲；工具失败时，保留脱敏的工具定义和响应片段，不能用“普通聊天能回复”证明工具协议完整兼容。

使用对应的站内教程#

• 聊天客户端与编辑器
• CC Switch
• Claude Code
• Codex

这些链接指向 HiKaRi 的接入说明。客户端版本和渠道能力会变化，应在实际使用的版本上验证；博客不承诺所有历史版本都兼容。

需要协助时，在 联系页 提交客户端版本、运行环境、实际路径、模型和错误码。请删除 Header 中的 Key、Cookie 与会话令牌。