CC GUI 与 OpenCode Go 集成指南：详细配置与解决方案

最近有很多朋友在折腾 CC GUI 和 OpenCode Go 的联动，经常有小伙伴遇到配置不生效或者接入报错的问题。

其实这两者的集成并不复杂，主要是对配置文件的字段理解有偏差，或者网络环境的互通性没解决好。今天就手把手带大家过一遍完整的接入流程，顺便把几个“坑点”都指出来，帮你避开这些问题。

在开始修改配置前，先确认两件事：

假设 OpenCode Go 已经跑起来了，接下来的重点就是 CC GUI 的配置。

1. 找到配置入口 打开 CC GUI 的后台或配置面板，通常在“通道设置”或“服务集成”这类标签页下。找到第三方服务的接入入口，类型选择“OpenCode Go”或者自定义 HTTP API（视具体版本而定）。

2. 填写关键参数 这里是最容易出错的地方，请务必对照填写：

服务地址：填写 OpenCode Go 的完整 URL。注意结尾不要带斜杠，除非程序另有规定，通常填写为 http://你的IP:端口。
认证信息 (Auth Token)：在 OpenCode Go 的配置文件中生成或查看密钥，将其完整复制到 CC GUI 的认证框中。切记不要有多余的空格。
回调地址：如果涉及到异步通知，这里需要填写 CC GUI 接收回调的公网地址。

3. 连通性测试 保存配置后，系统一般会提供一个“测试连接”的按钮。点击后，如果绿色对勾亮起，恭喜你，基本通了！

如果测试失败，也不要慌，按下面这几条排查，90% 的问题都能解决。

问题一：连接超时

现象：点击测试一直转圈，最后提示 Timeout。
分析：大概率是网络不通。
解决：在 CC GUI 服务器上 telnet 一下 OpenCode Go 的端口。如果连不上，去查云服务商的安全组，或者检查 Docker 容器的端口映射是否正确（比如 -p 8080:8080 左右两边是否一致）。

问题二：认证失败 (401/403)

现象：接口返回认证错误。
解决：检查 Token 是否复制完整。很多朋友复制时容易把前后空格也带进去，建议贴到记事本里去一下空格再填。另外确认 OpenCode Go 服务端设置中是否开启了 Token 校验。

问题三：参数解析错误 (500)

现象：连接通了，但是处理请求时服务端崩了。
解决：这通常是因为版本不兼容。CC GUI 和 OpenCode Go 都在快速迭代，旧版 GUI 可能无法适配新版 Go 程序的数据格式。建议查看两者的 GitHub Release 记录，确保大版本号一致。

集成工具最忌讳的就是盲目修改配置。遇到报错先看日志，OpenCode Go 的控制台输出和 CC GUI 的运行日志通常会告诉你具体哪一步卡住了。

如果你按照上面的步骤操作依然搞不定，建议检查一下双方的时间是否同步（SSL 握手有时对时间敏感），或者留言说明具体的错误信息，大家再一起分析。