开始之前
用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 会自己选默认模型。OpenCode 配置
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 也会缓存重复的提示词。