OpenCode 配置
OpenCode（终端编程智能体）支持通过 opencode.json 配置自定义的
OpenAI 兼容 provider。
配置
保存为项目根目录的 opencode.json（全局生效则放
~/.config/opencode/opencode.json）：
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"mafdet": {
"npm": "@ai-sdk/openai-compatible",
"name": "Mafdet AI",
"options": {
"baseURL": "https://api.mafdet.ai/v1",
"apiKey": "{env:MAFDET_API_KEY}"
},
"models": {
"deepseek-v4-pro": { "name": "Mafdet AI DeepSeek V4 Pro" }
}
}
}
}
然后导出 Key，并在 OpenCode 里选择模型 mafdet/deepseek-v4-pro：
export MAFDET_API_KEY="sk-mafdet-xxxxxxxxxxxxxxxx"
{env:MAFDET_API_KEY}由 OpenCode 运行时解析 —— 文件里不存任何密钥- 每个想用的 Mafdet AI 模型 ID 在
models下加一条（见 模型总览）
也可以在 控制台 → API Keys → 开发者工具 里按所选模型直接生成这个文件。
常见错误
| 现象 | 含义 | 处理 |
|---|---|---|
| 401 | 未设置 MAFDET_API_KEY | 启动 OpenCode 前先导出 |
| 429 | 触发限流（RPM/TPM） | 编程智能体需要高 TPM 限额的 Key |
| 模型没出现在列表 | models 里没加 | 在 models 下补上该模型 ID |