---
title: "Cline OpenAI Compatible 설정 방법(GLM, DeepSeek) | BroadRouter"
description: "VS Code 확장 Cline을 OpenAI Compatible 제공자로 BroadNet Inference에 연결합니다. 입력할 필드, 모델 ID, 컨텍스트 크기, 자주 겪는 문제의 해결법을 정리했습니다."
url: https://broadrouter.com/ko/guides/cline-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/cline-openai-compatible/) (2026-11-16 업데이트).

# BroadNet Inference에서 Cline 사용하기(OpenAI Compatible 제공자)

업데이트 2026-11-16

Cline 설정에서 API Provider를 OpenAI Compatible로, Base URL을 https://inference.broadnet.ai/v1로, API Key를 BroadNet 키로, Model을 broadnet/glm-5.3이나 broadnet/deepseek-v4.1-flash 같은 BroadNet ID로 지정하세요. 그다음 Model Configuration에서 컨텍스트 윈도우를 입력해 Cline이 얼마나 보낼 수 있는지 알게 하세요.

Cline은 VS Code 안에서 실행되는 코딩 에이전트입니다. **OpenAI Compatible** 제공자를 통해 OpenAI 호환 API라면 어디든 연결할 수 있고, BroadNet Inference는 `https://inference.broadnet.ai/v1` 주소에서 표준 chat completions 형식을 씁니다. 아래 단계는 [Cline의 제공자 문서](https://docs.cline.bot/provider-config/openai-compatible)를 따릅니다. 터미널 에이전트를 선호한다면 [Aider 가이드](https://broadrouter.com/ko/guides/aider-unlimited-deepseek/)를 참고하세요.

## 설정

1.  **키를 받습니다.** BroadNet 콘솔에서 종량제 키를 만들거나, [무제한 플랜](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)을 구매하고 플랜 키를 쓰세요.
    
2.  **Cline 설정을 엽니다.** Cline 패널의 톱니바퀴 아이콘을 클릭하세요.
    
3.  **제공자를 고릅니다.** **API Provider** 드롭다운에서 **OpenAI Compatible**을 선택하세요.
    
4.  **연결 필드를 채웁니다.**
    
    | 필드 | 값 |
    | --- | --- |
    | Base URL | `https://inference.broadnet.ai/v1` |
    | API Key | BroadNet 키 |
    | Model | `broadnet/glm-5.3` (또는 아래 표의 다른 ID) |
    
5.  **Model Configuration을 설정합니다.** **Model Configuration**을 펼치고 고른 모델의 컨텍스트 윈도우를 입력하세요. **Max Output Tokens**는 추론할 여유가 남도록 충분히 크게 잡으세요. 수천 토큰이면 안전하게 시작할 수 있습니다. 이미지 지원은 이미지를 받는 모델에서만 켜세요. [가격 페이지](https://broadrouter.com/ko/pricing/)의 입력·출력 가격을 넣어 두면 Cline이 표시하는 비용이 실제 청구액에 가까워집니다.
    
6.  **테스트합니다.** “explain this file” 같은 작은 작업을 시작해 보세요. 답이 오면 연결된 것입니다.
    

모델 ID는 `broadnet/` 접두사까지 포함해 정확히 입력하세요.

## 어떤 모델을 고를까

| 모델 | ID | 컨텍스트 | 적합한 용도 |
| --- | --- | --- | --- |
| GLM 5.3 | `broadnet/glm-5.3` | 1,048,576 | 도구 호출에 의존하는 에이전트 작업 |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | 1,048,576 | 무제한 플랜에서 긴 세션, 텍스트와 이미지 |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | 262,144 | 도구와 이미지, 아랍어 텍스트 |
| BroadNet Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` | 32,768 | 무료 크레딧으로 설정 시험해 보기 |

BroadNet 문서는 GLM 5.3과 Qwen3.8 27B에 도구와 구조화된 출력을 표기합니다. DeepSeek V4.1 Flash에는 도구 호출이 표기되어 있지 않으므로, 한 달 플랜을 결정하기 전에 짧은 실제 작업으로 먼저 돌려 보세요. Meteor 1시간은 $1, Full Moon 1개월은 $60 요금이며, 둘 다 [플랜 페이지](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-cline-openai-compatible&utm_content=body)에 나와 있습니다. 자세한 내용은 [DeepSeek V4.1 Flash 모델 페이지](https://broadrouter.com/ko/models/deepseek-v4.1-flash/)를 참고하세요.

## 문제 해결

-   **401 Unauthorized.** 키가 없거나 틀렸거나 만료되었거나, 종량제 계정의 사용 가능 금액이 소진된 경우입니다. 키를 다시 붙여 넣고 잔액을 확인하세요. Cline 문서는 키가 Base URL의 제공업체에 속한 것인지 확인하라고 안내합니다.
-   **모델을 찾을 수 없거나 첫 요청이 실패함.** ID를 확인하세요. BroadNet 모델 ID와 정확히 일치해야 합니다. 유료 모델은 충전이 필요하며, 채팅 모델 중 무료 초기 크레딧($5 상당)으로 작동하는 것은 `broadnet/gemma-4-26b-a4b` 모델뿐입니다.
-   **빈 답변이나 중간에 끊기는 답변.** 추론도 출력 한도에 포함됩니다. **Max Output Tokens**를 늘리세요. [답변이 비어서 오는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.
-   **429 Too Many Requests.** 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. Cline은 요청을 하나씩 순서대로 보내므로, 이 오류는 보통 다른 앱이 같은 키를 쓰고 있다는 뜻입니다. [오류와 재시도](https://broadrouter.com/ko/guides/errors-and-retries/)를 참고하세요.
-   **Cline 창을 여러 개 띄우면 응답이 느림.** 플랜 세션 하나는 한 번에 요청 하나를 처리합니다. 한 세션에서 Cline 작업 두 개를 동시에 돌리면 서로 뒤에서 기다립니다. 병렬 작업마다 세션을 하나씩 구매하거나 [정액제로 코딩 에이전트 병렬 실행하기](https://broadrouter.com/ko/blog/run-parallel-coding-agents-flat-rate/)를 읽어 보세요.
-   **연결 오류.** Base URL이 `/v1`로 끝나는지, 네트워크가 외부 HTTPS 연결을 허용하는지 확인하세요. 키에 [IP 허용 목록](https://broadrouter.com/ko/guides/api-keys-ip-allow-lists/)이 설정되어 있다면 사용하는 컴퓨터의 주소를 추가하세요.

## 이 가이드의 용어

[토큰(token)](https://broadrouter.com/ko/glossary/token/)

토큰은 언어 모델이 읽고 쓰는 텍스트 단위로, 모델의 토크나이저가 만들어 내는 단어, 단어의 일부, 문장 부호 또는 바이트 시퀀스입니다. LLM API는 사용량을 토큰 단위로 집계하고 제한하며, 대개 토큰 단위로 과금합니다.

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

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

[입력 토큰과 출력 토큰(input and output tokens)](https://broadrouter.com/ko/glossary/input-and-output-tokens/)

입력 토큰은 언어 모델이 요청에서 읽는 토큰으로, 시스템 프롬프트, 대화 기록, 도구 정의, 이미지가 포함됩니다. 출력 토큰은 모델이 응답으로 생성하는 토큰으로, 추론도 포함됩니다. LLM API는 보통 둘에 따로 가격을 매기며, 대개 출력이 더 비쌉니다.

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

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

[동시 처리(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 coding agent)](https://broadrouter.com/ko/glossary/coding-agent/)

AI 코딩 에이전트는 언어 모델이 코드베이스를 대상으로 루프를 돌며 일하는 소프트웨어 도구입니다. 파일을 읽고, 수정하고, 테스트 같은 명령을 실행하고, 출력을 읽은 뒤 다음 단계를 정하는 과정을 작업이 끝나거나 한도에 이를 때까지 반복합니다.

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

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

## 자주 묻는 질문

### Cline이 빈 응답을 반환하는 이유는 무엇인가요?

모델이 답변을 쓰기 전에 추론으로 출력 예산을 다 썼기 때문입니다. DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B는 먼저 추론하며, 추론도 max\_tokens에 포함됩니다. Model Configuration에서 Max Output Tokens를 늘리세요.

### 무제한 플랜으로 Cline을 쓸 수 있나요?

네. 무제한 플랜은 모델 ID broadnet/deepseek-v4.1-flash인 DeepSeek V4.1 Flash를 제공합니다. 플랜 키를 API Key에 넣으세요. Cline 작업 하나가 플랜 세션 하나를 씁니다.

### 모델 목록이 자동으로 채워지지 않는 이유는 무엇인가요?

Model 필드에 모델 ID를 직접 입력하세요. BroadNet 문서는 GET /v1/models를 모니터링용 공개 카탈로그 메타데이터라고 설명하므로, 모델 선택 목록을 채우는 용도로 기대하지 마세요.

### 무료 초기 크레딧으로 쓸 수 있는 BroadNet 모델은 무엇인가요?

채팅 모델 중에서는 모델 ID broadnet/gemma-4-26b-a4b인 BroadNet Gemma 4 VL 26B뿐이며, 이 크레딧은 Transcribe 모델 두 개에도 쓸 수 있습니다. 다른 채팅 모델은 충전이 필요합니다. 컨텍스트가 32,768토큰이라 큰 저장소에는 작습니다.

## 관련 가이드

-   [BroadNet Inference에서 Roo Code 사용하기(OpenAI Compatible)](https://broadrouter.com/ko/guides/roo-code-openai-compatible/)
-   [에이전트용 무제한 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/ko/guides/errors-and-retries/)
-   [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-cline-openai-compatible&utm_content=page-cta) ·

**출처**

-   [Cline 문서, OpenAI Compatible 제공자(2026-11-14 확인)](https://docs.cline.bot/provider-config/openai-compatible)
-   [BroadNet Inference API 레퍼런스 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-cline-openai-compatible&utm_content=sources)
-   [BroadNet Inference 무제한 플랜 (영어)](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-cline-openai-compatible&utm_content=sources)
