故障排除

OpenCode 在日志和本地存储中保存诊断信息。

日志

日志文件保存在：

• macOS/Linux：~/.local/share/opencode/log/
• Windows：%USERPROFILE%\.local\share\opencode\log\

日志文件以时间戳命名（例如 2025-01-09T123456.log）。保留最近的 10 个文件。

增加详细程度：

opencode --log-level DEBUG

存储

应用数据位置：

• macOS/Linux：~/.local/share/opencode/
• Windows：%USERPROFILE%\.local\share\opencode

获取帮助

1. GitHub Issues：github.com/anomalyco/opencode/issues
2. Discord 社区：opencode.ai/discord

常见问题

OpenCode 无法启动

• 查看日志文件中的错误消息
• 使用 --print-logs 参数运行
• 更新到最新版本：opencode upgrade

认证问题

• 使用 /connect 重新认证
• 验证 API 密钥有效性
• 确认网络访问

模型不可用

• 确认 Provider 认证
• 检查格式：<providerId>/<modelId>
• 运行 opencode models 列出模型

ProviderInitError

1. 查看 Provider 文档
2. 清除配置：rm -rf ~/.local/share/opencode
3. 通过 /connect 重新认证

Provider 包问题

清除缓存：

rm -rf ~/.cache/opencode

Linux 下复制/粘贴不工作

安装剪贴板工具：

# X11
apt install -y xclip
 
# Wayland
apt install -y wl-clipboard