客户端接入
OpenCode 接入
OpenCode 需要显式定义自定义提供方。创建 OpenAI-compatible 输出的配置 API，然后设置环境变量：
export LUMOSWITCH_API_KEY="your-lumoswitch-access-key"在用户级 ~/.config/opencode/opencode.json 或项目级 opencode.json 中加入：
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"lumoswitch": {
"npm": "@ai-sdk/openai-compatible",
"name": "Lumoswitch",
"options": {
"baseURL": "https://api.lumoswitch.com/v1",
"apiKey": "{env:LUMOSWITCH_API_KEY}"
},
"models": {
"your-client-facing-model-name": {
"name": "Lumoswitch model"
}
}
}
},
"model": "lumoswitch/your-client-facing-model-name"
}启动 opencode，先验证普通回复，再验证读取文件和工具调用。
常见问题
- 模型选择必须使用
lumoswitch/对外模型名称。 - 若配置 API 使用 Responses 输出，可将 SDK 包改为
@ai-sdk/openai；默认 Chat Completions 场景使用@ai-sdk/openai-compatible。 - 工具调用失败时，确认模型具备工具能力，并在最小测试中排除渠道专有参数。