Ang opencode ay open-source na coding agent para sa terminal. Ang mga provider na wala sa built-in catalog nito ay idinadagdag bilang custom provider sa opencode.jsonc. OpenAI chat-completions format ang gamit ng BroadNet Inference, kaya ang OpenAI-compatible runtime package ng opencode ang ginagamit nito. Sinusundan ng gabay na ito ang kasalukuyang (V2) docs ng opencode.
Setup
- I-export ang key mo sa shell na nagpapatakbo ng opencode:
export BROADNET_API_KEY='your-broadnet-key'
- Gawin ang config. Ilagay ito sa project mo bilang
opencode.jsonc, o sa~/.config/opencode/opencode.jsoncpara magamit kahit saan.
{
"$schema": "https://opencode.ai/config.json",
"model": "broadnet/glm-5.3",
"providers": {
"broadnet": {
"name": "BroadNet Inference",
"env": ["BROADNET_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": {
"baseURL": "https://inference.broadnet.ai/v1"
},
"models": {
"glm-5.3": {
"modelID": "broadnet/glm-5.3",
"name": "GLM 5.3",
"capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
"limit": { "context": 1048576, "output": 16000 }
},
"deepseek-v4.1-flash": {
"modelID": "broadnet/deepseek-v4.1-flash",
"name": "DeepSeek V4.1 Flash",
// BroadNet's docs don't list tool calling for this model: test it first
"capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 1048576, "output": 16000 }
},
"qwen3.8-27b": {
"modelID": "broadnet/qwen3.8-27b",
"name": "Qwen3.8 27B",
"capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 262144, "output": 16000 }
}
}
}
}
}
- Simulan ang opencode at piliin ang model gamit ang
/models. Ang reference aybroadnet/<map key>, halimbawabroadnet/glm-5.3. Ang value ngmodelIDang ipinapadala ng opencode sa BroadNet.
Pinagsasama ang mga config file. Inuuna ng opencode ang global file, saka ang mga project file na nakikita mula sa kasalukuyang directory paakyat (inuuna ang pinakamalayo), saka ang anumang .opencode/ config, kaya puwedeng palitan ng project file ang global na provider. Kung gumagamit ang kumpanya mo ng managed system config, ito ang nangingibabaw sa dalawa. Itago ang key sa environment, hindi sa file, para puwedeng isama ang config sa version control.
Bakit may mga alias
May slash na ang mga BroadNet ID (broadnet/glm-5.3). Ang key ng models map ang ipinapakita at pinipili ng opencode, at ang modelID ang ipinapadala nito. Pinapanatiling madaling basahin ng maiikling key ang mga reference.
Ikaw mismo ang mag-set ng capabilities at limit. Para sa model na wala sa catalog nito, ipinapalagay ng opencode na may JSON tool support, text at image input, 200,000-token na context at 32,000 output token. Tinatawag ito ng docs nito na fallback assumptions, hindi mga value na na-detect. Ang output na 16000 sa itaas ay mungkahi namin, hindi limit ng BroadNet; nag-iiwan ito ng puwang para sa reasoning.
Mas lumang V1 config
Binabasa pa rin ng opencode V2 ang V1 format, kaya patuloy na gagana ang isang umiiral na block na ganito:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"broadnet": {
"npm": "@ai-sdk/openai-compatible",
"name": "BroadNet Inference",
"options": {
"baseURL": "https://inference.broadnet.ai/v1",
"apiKey": "{env:BROADNET_API_KEY}"
},
"models": {
"broadnet/glm-5.3": { "name": "GLM 5.3" }
}
}
}
}
Sa native na V2 form, nagiging providers ang provider, nagiging package ang npm (aisdk:@ai-sdk/openai-compatible kung gusto mong panatilihin ang AI SDK package), at lumilipat ang options.baseURL at options.apiKey sa ilalim ng settings. Inima-map ng V1 migration guide ng opencode ang bawat field.
Aling model ang pipiliin
| Gawain | Model | Mga tala |
|---|---|---|
| Agent coding na may tools | GLM 5.3 | Nakalista ang tools at structured output; 1M context |
| Mga screenshot, Arabic | Qwen3.8 27B | Tools at mga larawan; 262K context |
| Buong-araw na session, flat na presyo | DeepSeek V4.1 Flash | Mga unlimited na plan; walang tools na nakalista sa BroadNet |
Umaasa ang opencode sa mga tool call. Hindi nakalista sa docs ng BroadNet ang tool calling para sa DeepSeek V4.1 Flash, kaya minamarkahan ito ng config bilang assumption na dapat subukan. Magpatakbo ng totoong task sa isang Meteor hour ($1) bago bumili ng isang buwang Full Moon ($60).
Troubleshooting
- 401. Mali, expired, o ubos na ang pay-as-you-go allowance ng key sa
BROADNET_API_KEY. Tiyaking naka-set ang variable sa process na nagpapatakbo ng opencode. - Hindi mahanap o tinanggihan ang model. Piliin ang map key (
broadnet/glm-5.3), at tiyaking eksaktong tugma angmodelIDsa ID ng BroadNet. Case-sensitive ang mga reference. Kailangan ng top-up para sa mga bayad na model; angbroadnet/gemma-4-26b-a4bat ang dalawang Transcribe model lang ang sakop ng $5 na credit. - Walang laman na sagot. Taasan ang
limit.output. Bakit walang laman ang mga sagot. - 429. Ang mga pay-as-you-go key ay may 30 request kada minuto at 4 na sabay-sabay. Kasama rin ang mga retry. Tingnan ang errors and retries.
- Mga subagent sa isang plan. Isang request lang sa isang pagkakataon ang hinahawakan ng bawat plan session, kaya pipila ang mga parallel na subagent maliban kung may kanya-kanya silang session.
