安装与配置
先检查版本、实际配置文件和协议。
正在打开页面…
正在加载内容，请稍候。
先选一个要完成的任务
定位常见故障
从与当前症状相同的一篇开始。
复跑样例
对照真实命令、请求轨迹或离线结果。
开始前，先分清这几件事
- 第一次使用从哪开始？
- 先用固定提示验证 OpenCode 命令、模型和 JSON 结束事件，再执行原文的文件改动。
- 怎样判断是真实 API 调用？
- 查看执行范围。样例服务的请求用来复现客户端行为；公网回执另标来源与 HTTP 结果。
全部任务与实测材料
每个任务有独立输入、真实响应与本地验收。先在小样中复核，再替换成自己的材料。
OpenCode 列表有模型却选不中？核对 provider/model 完整 ID从 opencode models 拿到准确完整 ID，先复现找不到模型，再对照本机实际请求。
OpenCode 全局配置改了没生效？用 debug config 查项目覆盖同一套全局 provider、两个不同默认模型，直接查看 OpenCode 合并后的配置。
开始改代码前先核对 OpenCode 的结束事件先用固定提示验证 OpenCode 命令、模型和 JSON 结束事件，再执行原文的文件改动。
LSP 没诊断时，先验证是否被配置关闭放入明确的 TypeScript 类型错误，查看 LSP 被关闭时诊断会呈现什么状态。
先读有效压缩配置，再验收 /compact 后的任务约束保存当前项目生效的 compaction 选项，避免把配置未读到误判为 /compact 自身故障。
操作时留意
- 错误模型名未触发模型请求。真实环境里，如果模型 ID 正确但出现 401 或 429，继续查认证或通道。
- 调试命令展示有效配置，不发模型请求。只有配置与目标一致后才应做最小调用。
带着示例继续练习
给 OpenCode 做一次最小复验
先按对应教程核对配置。需要真实模型结果时，使用自己的 apizt Key。
apizt 提供按量使用的多模型 API。具体模型、分组、价格与工具能力以当前配置和实际请求为准；软件会员权益与 API 用量分别核对。
常见问题
怎样复跑教程里的操作？
打开对应文章的样例包，按标记版本安装客户端，然后运行本地测试脚本。
一定要注册才能看结果吗？
不用。截图、结果和本机样例可以直接查看。真实网关调用需要有效 Key。