常见问题
FAQ 索引
这里汇总了 OpenCode 使用过程中最常见的问题及解决方案。
🔍 快速搜索
使用页面搜索功能（Ctrl+F 或 Cmd+F）快速找到答案。
📋 问题分类
💻 安装问题
| 问题 | 快速链接 |
|---|---|
| macOS 如何安装？ | 安装指南 → |
| Windows 如何安装？ | 安装指南 → |
| Linux 如何安装？ | 安装指南 → |
| 权限问题怎么办？ | 安装指南 → |
| 网络问题怎么办？ | 安装指南 → |
⚙️ 使用问题
| 问题 | 快速链接 |
|---|---|
| 如何启动交互模式？ | 使用指南 → |
| 技能未找到怎么办？ | 使用指南 → |
| 模型响应质量差？ | 使用指南 → |
| 文件读取失败？ | 使用指南 → |
| 如何保存会话历史？ | 使用指南 → |
💰 费用与计费
| 问题 | 快速链接 |
|---|---|
| OpenCode 是否免费？ | 使用指南 → |
| API 费用如何计算？ | 使用指南 → |
| 如何控制 API 费用？ | 使用指南 → |
🔧 性能与优化
| 问题 | 快速链接 |
|---|---|
| 如何提升响应速度？ | 使用指南 → |
| 如何处理大文件？ | 使用指南 → |
🌐 网络与连接
| 问题 | 快速链接 |
|---|---|
| 如何设置代理？ | 使用指南 → |
| 防火墙如何配置？ | 使用指南 → |
🔒 安全与隐私
| 问题 | 快速链接 |
|---|---|
| API 密钥如何保护？ | 使用指南 → |
| 数据隐私如何保障？ | 使用指南 → |
🛠️ 故障排除工具
如果以上内容无法解决问题，可以使用以下工具：
健康检查
bash
opencode doctor日志分析
bash
opencode logs --tail 100网络诊断
bash
opencode network test --all❓ 没有找到答案？
- 搜索文档：使用页面搜索功能
- 查看文档：完整文档
- 社区求助：Discord 社区
- 提交 Issue：GitHub Issues