OpenCode请求被上游拦截的解决方案与原因分析

常见原因

OpenCode 提示“请求被上游拦截”通常源于其默认架构设计：运行 opencode serve 后，Web UI 的所有请求会被代理到 https://app.opencode.ai，而非本地处理。若该远程地址被防火墙、公司网络策略或本地代理规则拦截，便会触发此错误。此外，本地环境变量 OPENCODE_PORT 配置不当导致端口冲突、代理设置错误（如未正确配置 HTTP 代理）、或网络连通性差（如模型 API 请求被本地安全软件拦截）也是常见诱因。

故障排除步骤

1. 检查网络与代理：确保终端或系统能正常访问 app.opencode.ai 及所需的 AI 模型 API 端点。若使用代理，需在 OpenCode 配置中正确设置代理地址，或临时关闭代理测试。
2. 调整环境变量：若设置了 OPENCODE_PORT，尝试取消该变量或将其改为空闲端口后重启 OpenCode 桌面应用。
3. 清除缓存与插件：完全退出 OpenCode Desktop，删除缓存目录（macOS 路径：Finder → Cmd+Shift+G → 输入缓存路径），然后重启应用，以排除损坏插件或缓存导致的请求异常。
4. 检查本地安全软件：确认防火墙、杀毒软件未拦截 OpenCode 进程（如 opencode serve）的网络请求，必要时添加白名单。
5. 使用本地模式：如无远程协作需求，可考虑配置 OpenCode 使用纯本地模型（如通过 Ollama），避免依赖远程代理服务。

隐私与安全注意事项

部分用户发现 OpenCode 默认将请求转发至远程服务器（app.opencode.ai），且缺乏关闭选项，这可能导致代码被上传。若此行为被企业网络或严格安全策略视为风险，则会主动拦截请求。建议在敏感环境中仔细审查 OpenCode 的隐私设置，或使用完全离线的 AI 编程工具替代方案。