故障排除 (Troubleshooting)

在使用 Opencode 过程中遇到问题？这里有解决方案。

常见错误

Opencode Bad Request

• 原因: 通常是 API Key 失效或额度耗尽。
• 解决: 运行 /connect 重新绑定 Key，或检查你的 LLM 提供商后台。

退出 Plan Mode (Opencode Exit Plan Mode)

• 问题: 卡在 Plan 模式无法生成代码。
• 解决: 按 Tab 键切换回 Build 模式，或者输入 /reset 重置会话。

导出会话 (Opencode Export Session)

• 需求: 想把刚才的对话保存下来分享给同事。
• 命令: 输入 /share 会生成一个 URL，或者使用 /export 导出为 Markdown 文件。

安装与环境

终端兼容性 (Best Terminal for Opencode)

虽然 Opencode 支持所有终端，但以下终端体验最佳：

1. Ghostty / Kitty: GPU 加速，渲染流畅。
2. iTerm2 / WezTerm: 经典稳定。
3. Windows Terminal: Windows 用户的最佳选择。

路径与配置

• Where is Opencode Config File: ~/.opencode/config.json
• Where Opencode JSON: 同上，用于存储会话状态和偏好。
• Opencode Environment Variable: 如果遇到 PATH 问题，请检查你的 .zshrc 或 .bashrc 是否正确导出了 Opencode 的 bin 目录。

寻求帮助

如果以上未解决你的问题，请访问 Opencode Docs 或加入 Opencode Discord 社区提问。