Kilo Code는 VS Code와 터미널에서 쓰는 오픈 소스 코딩 에이전트입니다. OpenAI Chat Completions API를 갖춘 제공자라면 무엇이든 커스텀 제공자로 추가할 수 있습니다. BroadNet Inference는 https://inference.broadnet.ai/v1 주소에서 이 형식을 제공합니다. BroadRouter는 BroadNet이 운영하는 사이트이며, 이 가이드는 2026년 11월 15일 기준 Kilo 제공자 문서를 따릅니다.
VS Code에서 설정
-
키를 받습니다. BroadNet 콘솔에서 종량제 키를 만들거나, 무제한 플랜 키를 쓰세요.
-
Settings(톱니바퀴 아이콘)를 열고 Providers 탭으로 가세요.
-
맨 아래로 스크롤해 Custom provider를 클릭하세요.
-
대화 상자를 채우세요.
필드 값 Provider ID broadnetDisplay name BroadNet Inference Provider API OpenAI Compatible Base URL https://inference.broadnet.ai/v1API key BroadNet 키 Models broadnet/glm-5.3직접 추가(아래 참고) -
Submit을 클릭하세요. 모델 선택기에 모델이 나타납니다.
-
테스트합니다. “explain this file” 같은 작업을 시작해 보세요. 답이 오면 연결이 된 것입니다.
Kilo는 엔드포인트의 /v1/models에서 모델 목록을 채우려고 합니다. BroadNet 문서는 이 엔드포인트를 모니터링용 카탈로그 메타데이터라고 설명하며, 2026년 11월 15일에 확인했을 때는 전사 모델 두 개만 나열되어 있었습니다. 채팅 모델 ID는 직접 입력하고, 전사 모델은 고르지 마세요.
kilo.json에서 설정(CLI용, 또는 한도와 도구 플래그 지정용)
Kilo의 대화 상자에서는 토큰 한도나 도구 호출을 설정할 수 없습니다. Kilo 문서는 이를 위해 설정 파일을 쓰라고 안내합니다. 위치는 ~/.config/kilo/kilo.json이거나, 프로젝트 안의 ./kilo.json입니다.
{
"$schema": "https://app.kilo.ai/config.json",
"model": "broadnet/glm-5.3",
"provider": {
"broadnet": {
"npm": "@ai-sdk/openai-compatible",
"env": ["BROADNET_API_KEY"],
"options": {
"baseURL": "https://inference.broadnet.ai/v1"
},
"models": {
"glm-5.3": {
"id": "broadnet/glm-5.3",
"name": "GLM 5.3",
"tool_call": true,
"reasoning": true,
"limit": { "context": 1048576, "output": 16000 }
},
"qwen3.8-27b": {
"id": "broadnet/qwen3.8-27b",
"name": "Qwen3.8 27B",
"tool_call": true,
"reasoning": true,
"modalities": { "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 262144, "output": 16000 }
},
"deepseek-v4.1-flash": {
"id": "broadnet/deepseek-v4.1-flash",
"name": "DeepSeek V4.1 Flash",
"reasoning": true,
"limit": { "context": 1048576, "output": 16000 }
}
}
}
}
}
export BROADNET_API_KEY='your-broadnet-key'
- 최상위
model값인broadnet/glm-5.3은 제공자 이름에 맵 키(glm-5.3)를 붙인 것이며, BroadNet ID가 아닙니다.id필드는 Kilo가 BroadNet에 보내는 모델 ID입니다. Kilo 문서에 따르면id의 기본값은 맵 키이므로, 여기처럼 짧은 키를 쓰는 등 키가 BroadNet ID 전체와 다를 때는 언제나id를 지정하세요. limit.context와limit.output은 항상 설정하세요. Kilo 문서에 따르면 카탈로그에 일치하는 항목이 없는 커스텀 모델은 둘 다 0으로 처리되어 자동 컨텍스트 관리가 꺼집니다. 출력값 16,000은 저희가 제안하는 값으로, 추론에 쓸 여유를 남깁니다.- DeepSeek V4.1 Flash에는 일부러
tool_call을 넣지 않았습니다. BroadNet 문서에 이 모델의 도구 호출이 표기되어 있지 않기 때문입니다. 직접 테스트한 뒤에 추가하세요.
어떤 모델을 고를까
| 작업 | 모델 | 참고 |
|---|---|---|
| 도구를 쓰는 에이전트 코딩 | GLM 5.3 | 도구와 구조화된 출력 표기, 100만 컨텍스트 |
| 스크린샷, 아랍어 | Qwen3.8 27B | 도구와 이미지, 262K 컨텍스트 |
| 긴 세션, 정액 요금 | DeepSeek V4.1 Flash | 무제한 플랜, BroadNet 도구 미표기 |
Full Moon 한 달($60)을 사기 전에 Meteor 1시간($1)으로 무제한 플랜을 먼저 써 보세요.
문제 해결
- “Invalid API Key” 또는 401. 키를 다시 붙여 넣으세요. 키에 사용 가능 금액이 남아 있는지, Kilo를 실행하는 프로세스에
BROADNET_API_KEY가 설정되어 있는지 확인하세요. - “Model Not Found”. ID가
broadnet/접두사를 포함해 BroadNet ID와 정확히 일치하는지 확인하세요. 유료 모델은 충전이 필요하며, 초기 크레딧($5 상당)으로는broadnet/gemma-4-26b-a4b모델과 Transcribe 모델 두 개만 쓸 수 있습니다. - 빈 답변 또는 “response may be incomplete”. Kilo는 추론 모델이 출력 전체를 추론에 써 버리면 이 경고를 띄웁니다.
limit.output을 늘리세요. 답변이 비어서 오는 이유를 참고하세요. - 429. 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. 오류와 재시도를 참고하세요.
- 플랜 키에서 병렬 서브에이전트가 대기하거나 실패함. 플랜 세션은 한 번에 요청 하나만 처리하므로, 병렬 서브에이전트마다 별도의 세션을 쓰세요.
- 연결 오류. Base URL은
/v1로 끝나야 합니다. 키에 IP 허용 목록이 설정되어 있다면 사용 중인 컴퓨터의 주소를 추가하세요.
