---
title: "Kilo Code 커스텀 OpenAI 호환 제공자 설정 | BroadRouter"
description: "VS Code 대화 상자나 kilo.json으로 Kilo Code를 BroadNet Inference에 OpenAI Compatible 커스텀 제공자로 연결하고, 모델 ID, 한도, 도구 플래그를 설정합니다."
url: https://broadrouter.com/ko/guides/kilo-code-openai-compatible/
lang: ko
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

이 페이지는 영어 원문을 AI의 도움을 받아 번역했습니다. [영어 원문 읽기](https://broadrouter.com/guides/kilo-code-openai-compatible/) (2026-11-16 업데이트).

# Kilo Code에서 BroadNet Inference 쓰기(OpenAI Compatible 제공자)

업데이트 2026-11-16

Kilo Code에서 Settings를 열고 Providers로 가서 Custom provider를 클릭하세요. Provider API는 OpenAI Compatible, Base URL은 https://inference.broadnet.ai/v1로 정하고 BroadNet 키를 붙여 넣은 뒤, broadnet/glm-5.3 같은 모델 ID를 직접 추가합니다. kilo.json에서는 npm에 @ai-sdk/openai-compatible을, options.baseURL을 지정하고 limit.context와 limit.output을 설정하세요.

Kilo Code는 VS Code와 터미널에서 쓰는 오픈 소스 코딩 에이전트입니다. OpenAI Chat Completions API를 갖춘 제공자라면 무엇이든 **커스텀 제공자**로 추가할 수 있습니다. BroadNet Inference는 `https://inference.broadnet.ai/v1` 주소에서 이 형식을 제공합니다. BroadRouter는 BroadNet이 운영하는 사이트이며, 이 가이드는 2026년 11월 15일 기준 [Kilo 제공자 문서](https://kilo.ai/docs/ai-providers/openai-compatible)를 따릅니다.

## VS Code에서 설정

1.  **키를 받습니다.** BroadNet 콘솔에서 종량제 키를 만들거나, [무제한 플랜](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/) 키를 쓰세요.
    
2.  **Settings**(톱니바퀴 아이콘)를 열고 **Providers** 탭으로 가세요.
    
3.  맨 아래로 스크롤해 **Custom provider**를 클릭하세요.
    
4.  대화 상자를 채우세요.
    
    | 필드 | 값 |
    | --- | --- |
    | Provider ID | `broadnet` |
    | Display name | BroadNet Inference |
    | Provider API | **OpenAI Compatible** |
    | Base URL | `https://inference.broadnet.ai/v1` |
    | API key | BroadNet 키 |
    | Models | `broadnet/glm-5.3` 직접 추가(아래 참고) |
    
5.  **Submit**을 클릭하세요. 모델 선택기에 모델이 나타납니다.
    
6.  **테스트합니다.** “explain this file” 같은 작업을 시작해 보세요. 답이 오면 연결이 된 것입니다.
    

Kilo는 엔드포인트의 `/v1/models`에서 모델 목록을 채우려고 합니다. BroadNet 문서는 이 엔드포인트를 모니터링용 카탈로그 메타데이터라고 설명하며, 2026년 11월 15일에 확인했을 때는 전사 모델 두 개만 나열되어 있었습니다. 채팅 모델 ID는 직접 입력하고, 전사 모델은 고르지 마세요.

## kilo.json에서 설정(CLI용, 또는 한도와 도구 플래그 지정용)

Kilo의 대화 상자에서는 토큰 한도나 도구 호출을 설정할 수 없습니다. Kilo 문서는 이를 위해 설정 파일을 쓰라고 안내합니다. 위치는 `~/.config/kilo/kilo.json`이거나, 프로젝트 안의 `./kilo.json`입니다.

```jsonc
{
  "$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 }
        }
      }
    }
  }
}
```

```bash
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](https://broadrouter.com/ko/models/glm-5.3/) | 도구와 구조화된 출력 표기, 100만 컨텍스트 |
| 스크린샷, 아랍어 | [Qwen3.8 27B](https://broadrouter.com/ko/models/qwen3.8-27b/) | 도구와 이미지, 262K 컨텍스트 |
| 긴 세션, 정액 요금 | [DeepSeek V4.1 Flash](https://broadrouter.com/ko/models/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`을 늘리세요. [답변이 비어서 오는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.
-   **429.** 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. [오류와 재시도](https://broadrouter.com/ko/guides/errors-and-retries/)를 참고하세요.
-   **플랜 키에서 병렬 서브에이전트가 대기하거나 실패함.** 플랜 세션은 한 번에 요청 하나만 처리하므로, 병렬 서브에이전트마다 별도의 세션을 쓰세요.
-   **연결 오류.** Base URL은 `/v1`로 끝나야 합니다. 키에 [IP 허용 목록](https://broadrouter.com/ko/guides/api-keys-ip-allow-lists/)이 설정되어 있다면 사용 중인 컴퓨터의 주소를 추가하세요.

## 이 가이드의 용어

[종량제(Pay-as-you-go)](https://broadrouter.com/ko/glossary/pay-as-you-go/)

종량제(pay-as-you-go)는 구독이나 최소 약정 없이 토큰, 요청, 오디오 분 같은 단위로 사용량을 측정해 쓴 만큼만 내는 요금 방식입니다. 대부분의 LLM API가 선불 잔액에서 차감하거나 정기 청구서를 발행하는 식으로 이렇게 과금합니다.

[API 키(API key)](https://broadrouter.com/ko/glossary/api-key/)

API 키는 API를 호출하는 클라이언트를 식별하고 승인하는 비밀 문자열입니다. LLM API는 보통 이 키를 Authorization: Bearer 헤더로 받으며, 키를 가진 사람은 누구나 키 소유 계정으로 과금되는 요청을 보낼 수 있습니다.

[구조화된 출력(Structured output)](https://broadrouter.com/ko/glossary/structured-output/)

구조화된 출력(structured output)은 모델의 응답을 개발자가 지정한 형식, 주로 JSON Schema에 맞추도록 제한해 코드가 안정적으로 파싱할 수 있게 하는 LLM API 기능입니다. 유효한 JSON만 보장하고 특정 구조는 보장하지 않는 JSON 모드보다 더 엄격합니다.

[동시 처리(concurrency)](https://broadrouter.com/ko/glossary/concurrency/)

동시 처리(concurrency)는 클라이언트가 같은 시점에 진행 중인 요청 수입니다. LLM API는 분당 요청 수와 별도로 키나 플랜마다 이를 제한하는 경우가 많습니다. 열려 있는 요청은 응답이 끝날 때까지 GPU 용량을 차지하기 때문입니다.

[속도 제한(rate limit)](https://broadrouter.com/ko/glossary/rate-limit/)

속도 제한(rate limit)은 API가 일정 시간 동안 클라이언트가 사용할 수 있는 양에 두는 상한으로, 분당 요청 수나 분당 토큰 수 같은 기준이 있습니다. 한도를 넘은 요청은 사용량이 다시 한도 아래로 내려갈 때까지 거부되며, 보통 HTTP 429 Too Many Requests가 반환됩니다.

[AI 에이전트(AI agent)](https://broadrouter.com/ko/glossary/agent/)

AI 에이전트는 언어 모델이 목표를 향해 스스로 단계를 정하는 시스템입니다. 어떤 도구를 호출할지 결정하고, 결과를 읽고, 최종 답변을 내거나 한도에 닿을 때까지 이를 반복합니다. 정해진 지점에서 모델을 호출하는 고정된 스크립트는 보통 워크플로라고 부릅니다.

[base URL(베이스 URL)](https://broadrouter.com/ko/glossary/base-url/)

base URL은 https://api.example.com/v1처럼 API의 고정된 루트 주소로, 클라이언트가 /chat/completions 같은 모든 엔드포인트 경로 앞에 붙입니다. OpenAI 호환 SDK에서는 base URL을 API 키, 모델 ID와 함께 바꾸면 같은 코드로 다른 제공업체를 호출할 수 있습니다.

[Chat Completions API](https://broadrouter.com/ko/glossary/chat-completions-api/)

Chat Completions API는 OpenAI의 HTTP 엔드포인트인 POST /v1/chat/completions로, 모델 이름과 역할이 붙은 메시지 목록을 받아 모델의 다음 메시지를 반환합니다. 이 요청과 응답 구조는 OpenAI 호환 제공업체와 SDK가 재사용하는 공통 형식이 되었습니다.

## 자주 묻는 질문

### Base URL을 입력해도 Kilo Code에 BroadNet 채팅 모델이 나오지 않는 이유는 무엇인가요?

Kilo는 엔드포인트의 /v1/models 목록에서 모델을 가져옵니다. 2026년 11월 15일에 확인했을 때 BroadNet의 공개 /v1/models에는 전사 모델 두 개만 있었으므로, 채팅 모델 ID를 직접 추가하세요.

### BroadNet 모델의 limit.context는 얼마로 설정해야 하나요?

GLM 5.3과 DeepSeek V4.1 Flash는 1048576, Qwen3.8 27B는 262144, BroadNet Gemma 4 VL 26B는 32768입니다. Kilo 문서에 따르면 커스텀 모델에서 limit이 없으면 0으로 처리되어 자동 컨텍스트 관리가 꺼집니다.

### BroadNet 무제한 플랜으로 Kilo Code를 쓸 수 있나요?

네. 플랜은 DeepSeek V4.1 Flash(ID broadnet/deepseek-v4.1-flash)를 제공합니다. 플랜 키를 API 키로 쓰세요. BroadNet 문서에는 이 모델의 도구 호출이 표기되어 있지 않으므로, 에이전트 작업을 먼저 테스트해 보세요.

### Provider API는 OpenAI Compatible과 OpenAI Responses 중 무엇을 골라야 하나요?

OpenAI Compatible입니다. BroadNet은 /v1/chat/completions에서 chat completions를 제공하며, Responses API는 표기하지 않습니다.

## 관련 가이드

-   [BroadNet Inference에서 Cline 사용하기(OpenAI Compatible 제공자)](https://broadrouter.com/ko/guides/cline-openai-compatible/)
-   [opencode에 BroadNet Inference를 커스텀 제공자로 추가하기](https://broadrouter.com/ko/guides/opencode-custom-provider/)
-   [에이전트용 무제한 LLM API 플랜은 어떻게 작동하나요?](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)
-   [추론 모델이 빈 답변을 반환하는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference와 함께 쓸 수 있는 모든 도구 (영어)](https://broadrouter.com/integrations/): SDK, 코딩 에이전트, 채팅 UI, 자동화 도구와 각 도구의 정확한 설정

실제 워크로드로 테스트해 보세요. 신규 계정에는 US$5 상당의 초기 크레딧이 제공되며 Gemma 및 음성 전사에 사용할 수 있습니다. DeepSeek, GLM 및 Qwen3.8 모델은 충전이 필요합니다.

[시작하기](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-kilo-code-openai-compatible&utm_content=page-cta) ·

**출처**

-   [Kilo Code 문서, Using OpenAI-Compatible Providers(2026-11-15 확인)](https://kilo.ai/docs/ai-providers/openai-compatible)
-   [Kilo Code 문서, Custom Models(id, tool\_call, limit 필드)(2026-11-15 확인)](https://kilo.ai/docs/code-with-ai/agents/custom-models)
-   [BroadNet Inference API 레퍼런스(2026-11-15 확인) (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-kilo-code-openai-compatible&utm_content=sources)
