OpenCode 接入

OpenCode 可以通过 OpenAI-compatible Base URL 和 Access Key 使用 Lumoswitch 暴露的模型。

设置环境变量

export OPENAI_API_KEY="your-lumoswitch-access-key"
export OPENAI_BASE_URL="https://your-gateway.example.com/v1"

启动

opencode --model "your-public-model-name"

--model 的值必须与配置 API 的对外模型名称完全一致，包括大小写和连字符。

验证

1. 在一个测试目录启动 OpenCode。
2. 发送不修改文件的简单问题。
3. 确认模型可以回复。
4. 再测试读取文件和生成补丁等工具能力。

常见问题

• OpenCode 未读取变量：从设置变量的同一个终端启动，或重新打开终端。
• 模型名称被客户端自动加前缀：显式传入控制台显示的完整对外模型名称。
• 请求格式错误：确认配置 API 使用 OpenAI-compatible 输出。
• 配置更新无效：退出所有 OpenCode 进程后重新启动。