跳转到主要内容

开始之前

用 npm i -g opencode-ai 安装 OpenCode CLI,在 API Key 页面创建 key,并在 模型 页面选好模型。以下步骤已在 OpenCode 1.19.0 上验证。
1

设置 API key

在运行 OpenCode 的 shell 里把 key 设为环境变量:
2

配置 LithosAI

把以下配置合并到 ~/.config/opencode/opencode.json,保留已有的 provider;文件不存在时直接新建。示例包含 DeepSeek-V4.1-Flash 及其 fast 和 ultra 速度档位。请保留顶层的 model 一行;没有它,OpenCode 会自己选默认模型。
~/.config/opencode/opencode.json
要使用其他模型或速度档位,复制 provider.lithosai.models 下的一个条目,按照模型目录修改它的键名和 name。再按该模型调整 token 上限和支持的推理强度,然后重新打开 OpenCode。
3

开始对话

运行 opencode 开始对话。

模型与推理强度

  • 模型与速度档位:在当前对话中用 /models 切换。
  • 推理强度:用 /variants 选择 low、high 或 max,默认为 high。使用 opencode run 时,在 --variant 后传入 low、high 或 max;其他取值会被忽略,按 high 处理。

问题排查

  • 如果 opencode run 输出 UnknownError 和 Unexpected server error,可以先检查选中的模型是否和配置里的键名一致。用 -m 指定模型时要带上 provider 前缀,例如 lithosai/deepseek-ai/DeepSeek-V4.1-Flash。模型 ID 区分大小写。加上 --print-logs 重新运行,可以看到具体错误。
  • 不要在 provider 的 options 中设置 setCacheKey。设置后 OpenCode 会发送 promptCacheKey,LithosAI 会以 400 unknown_parameter 拒绝。不设置它,LithosAI 也会缓存重复的提示词。
所有 Agent 通用的问题和 LithosAI 返回的报错,见常见问题。

参考资料