opencode는 터미널용 오픈 소스 코딩 에이전트입니다. 기본 카탈로그에 없는 제공자는 opencode.jsonc에 커스텀 제공자로 추가합니다. BroadNet Inference는 OpenAI chat completions 형식을 따르므로 opencode의 OpenAI 호환 런타임 패키지를 씁니다. 이 가이드는 현재(V2) opencode 문서를 따릅니다.
설정
- opencode를 실행할 셸에서 키를 export하세요.
export BROADNET_API_KEY='your-broadnet-key'
- 설정 파일을 만드세요. 프로젝트에
opencode.jsonc로 두거나, 모든 곳에서 쓰려면~/.config/opencode/opencode.jsonc에 두세요.
{
"$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 }
}
}
}
}
}
- opencode를 실행하고
/models로 모델을 고르세요. 참조 형식은broadnet/<맵 키>이며, 예를 들면broadnet/glm-5.3입니다. opencode는modelID값을 BroadNet에 보냅니다.
설정 파일은 병합됩니다. opencode는 전역 파일을 먼저 적용하고, 그다음 현재 디렉터리에서 위쪽으로 찾은 프로젝트 파일(가장 먼 것부터), 마지막으로 .opencode/ 설정을 적용합니다. 따라서 프로젝트 파일이 전역 제공자 설정을 덮어쓸 수 있습니다. 회사에서 관리형 시스템 설정을 쓴다면 그 설정이 둘 다보다 우선합니다. 키는 파일이 아니라 환경 변수에 두세요. 그래야 설정 파일을 버전 관리에 넣을 수 있습니다.
별칭을 쓰는 이유
BroadNet ID에는 이미 슬래시가 들어 있습니다(broadnet/glm-5.3). models 맵의 키는 opencode가 표시하고 선택하는 값이고, modelID는 실제로 전송하는 값입니다. 짧은 키를 쓰면 참조를 읽기 쉽습니다.
capabilities와 limit은 직접 설정하세요. 카탈로그에 없는 모델에 대해 opencode는 JSON 도구 지원, 텍스트와 이미지 입력, 200,000토큰 컨텍스트, 출력 32,000토큰을 가정합니다. opencode 문서는 이를 감지한 값이 아니라 대체(fallback) 가정이라고 설명합니다. 위의 output 값 16000은 BroadNet의 한도가 아니라 저희가 제안하는 값이며, 추론할 여유를 남겨 둡니다.
예전 V1 설정
opencode V2는 V1 형식도 계속 읽으므로, 다음과 같은 기존 블록은 그대로 작동합니다.
{
"$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" }
}
}
}
}
네이티브 V2 형식에서는 provider가 providers로, npm이 package로 바뀌고(AI SDK 패키지를 계속 쓰려면 aisdk:@ai-sdk/openai-compatible), options.baseURL과 options.apiKey는 settings 아래로 옮겨집니다. 필드별 대응은 opencode V1 마이그레이션 가이드에 정리되어 있습니다.
어떤 모델을 고를까
| 작업 | 모델 | 비고 |
|---|---|---|
| 도구를 쓰는 에이전트 코딩 | GLM 5.3 | 도구와 구조화된 출력 표기, 1M 컨텍스트 |
| 스크린샷, 아랍어 | Qwen3.8 27B | 도구와 이미지, 262K 컨텍스트 |
| 종일 쓰는 세션, 정액 요금 | DeepSeek V4.1 Flash | 무제한 플랜, BroadNet이 도구 지원을 표기하지 않음 |
opencode는 도구 호출에 의존합니다. BroadNet 문서에는 DeepSeek V4.1 Flash의 도구 호출 지원이 나오지 않으므로, 위 설정에서는 이를 테스트가 필요한 가정으로 표시했습니다. Full Moon 한 달($60)을 구매하기 전에 Meteor 1시간($1)으로 실제 작업을 돌려 보세요.
문제 해결
- 401.
BROADNET_API_KEY의 키가 틀렸거나, 만료되었거나, 종량제 사용 가능 금액이 소진되었습니다. opencode를 실행하는 프로세스에 이 변수가 설정되어 있는지 확인하세요. - 모델을 찾을 수 없거나 거부됨. 맵 키(
broadnet/glm-5.3)를 선택하고,modelID가 BroadNet의 ID와 정확히 같은지 확인하세요. 참조는 대소문자를 구분합니다. 유료 모델은 충전이 필요하며, 초기 크레딧($5 상당)은broadnet/gemma-4-26b-a4b모델과 Transcribe 모델 두 개에만 쓸 수 있습니다. - 빈 답변.
limit.output을 늘리세요. 답변이 비어서 오는 이유를 참고하세요. - 429. 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. 재시도도 포함됩니다. 오류와 재시도를 참고하세요.
- 플랜에서 서브에이전트를 쓸 때. 플랜 세션은 각각 한 번에 요청 하나를 처리하므로, 서브에이전트마다 세션이 따로 없으면 병렬 서브에이전트는 대기열에 쌓입니다.
