---
title: "Roo Code 종료 이후: OpenAI Compatible 설정 | BroadRouter"
description: "Roo Code는 2026년 5월에 서비스가 종료되었습니다. 기존 설치와 포크용 설정, 그리고 BroadNet Inference와 함께 옮겨 갈 곳(Cline 또는 Zoo Code 포크)을 정리했습니다."
url: https://broadrouter.com/ko/guides/roo-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/roo-code-openai-compatible/) (2026-11-16 업데이트).

# BroadNet Inference에서 Roo Code 사용하기(OpenAI Compatible)

업데이트 2026-11-16

Roo Code는 2026년 5월 15일에 서비스가 종료되었으므로, 새로 설정한다면 Cline이나 커뮤니티 포크인 Zoo Code를 쓰세요. 기존 설치에서는 API Provider를 OpenAI Compatible로, Base URL을 https://inference.broadnet.ai/v1로, API Key를 BroadNet 키로, Model을 broadnet/glm-5.3으로 지정하세요. Roo Code는 네이티브 도구 호출이 필요하므로 도구를 지원하는 모델을 고르세요.

> **Roo Code는 2026년 5월 15일에 서비스가 종료되었습니다.** [저장소](https://github.com/RooCodeInc/Roo-Code)는 보관 처리되어 읽기 전용입니다. 유지 관리되는 에이전트가 필요하다면 [BroadNet Inference와 Cline](https://broadrouter.com/ko/guides/cline-openai-compatible/)을 쓰거나, Roo Code 코드베이스를 이어 가는 커뮤니티 포크 [Zoo Code](https://github.com/Zoo-Code-Org/Zoo-Code)를 쓰세요. 아래 단계는 기존 Roo Code 설치에 그대로 적용됩니다. [Cline vs Roo Code vs Aider](https://broadrouter.com/ko/blog/cline-vs-roo-code-vs-aider/) 비교도 참고하세요.

Roo Code는 VS Code용 코딩 에이전트입니다. **OpenAI Compatible** 제공자는 OpenAI chat completions 형식을 쓰는 모든 엔드포인트와 작동하며, `https://inference.broadnet.ai/v1` 주소의 BroadNet Inference도 마찬가지입니다. 설정을 좌우하는 규칙이 하나 있습니다. [Roo Code 문서](https://roocodeinc.github.io/Roo-Code/providers/openai-compatible)에 따르면 Roo Code는 XML 대체 방식 없이 **네이티브 도구 호출만** 사용합니다. 따라서 고르는 모델이 OpenAI 방식의 도구 호출을 지원해야 합니다.

## 설정

1.  **BroadNet 키를 받습니다.** 종량제 키는 모든 채팅 모델에 쓸 수 있습니다. [API 키와 IP 허용 목록](https://broadrouter.com/ko/guides/api-keys-ip-allow-lists/)을 참고하세요.
    
2.  **Roo Code 설정을 엽니다.** Roo Code 패널의 설정 아이콘을 클릭하세요.
    
3.  **API Provider를 설정합니다.** **OpenAI Compatible**을 선택하세요.
    
4.  **연결 정보를 입력합니다.**
    
    | 필드 | 값 |
    | --- | --- |
    | Base URL | `https://inference.broadnet.ai/v1` |
    | API Key | BroadNet 키 |
    | Model | `broadnet/glm-5.3` |
    
5.  **Model Configuration을 조정합니다.** **Context Window**에는 아래 표에 있는 모델의 컨텍스트를 입력하세요. **Max Output Tokens**는 추론할 여유를 두어 설정하되, 수천 토큰으로 시작하면 됩니다. **Image Support**는 Qwen3.8 27B나 DeepSeek V4.1 Flash에서만 켜세요. Roo의 비용 추정치를 실제 청구액과 맞추고 싶다면 [가격 페이지](https://broadrouter.com/ko/pricing/)의 값을 **Input Price**와 **Output Price**에 입력하세요.
    
6.  **테스트 작업을 실행합니다.** 예를 들어 “list the files in this folder and summarize the README”를 시켜 보세요. Roo Code가 파일 도구를 호출합니다. 이 호출이 작동하면 도구 호출도 작동하는 것입니다.
    

## 어떤 모델을 고를까

| 모델 | ID | 컨텍스트 | BroadNet의 도구 표기 |
| --- | --- | --- | --- |
| GLM 5.3 | `broadnet/glm-5.3` | 1,048,576 | 예 |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | 262,144 | 예, 이미지 입력도 지원 |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | 1,048,576 | 표기 없음, 이미지 입력 가능 |

[GLM 5.3](https://broadrouter.com/ko/models/glm-5.3/)부터 시작하세요. 컨텍스트가 100만 토큰이고, BroadNet이 도구와 구조화된 출력을 표기한 모델입니다. 스크린샷을 붙여 넣거나 아랍어로 작업하려면 [Qwen3.8 27B](https://broadrouter.com/ko/models/qwen3.8-27b/)를 쓰세요.

DeepSeek V4.1 Flash는 무제한 플랜에서 제공하는 모델입니다. Roo Code는 네이티브 도구 호출이 필요한데 BroadNet 문서에는 이 모델의 도구 지원이 표기되어 있지 않으므로, 실제로 의존하기 전에 테스트하세요. Meteor 1시간은 $1 요금으로, 실제 작업 하나를 해 보기에 충분합니다. BroadNet Gemma 4 VL 26B도 도구가 표기되어 있지 않아 Roo Code에는 잘 맞지 않습니다.

## 문제 해결

-   **401.** 키가 없거나 잘못되었거나 만료되었거나, 종량제 사용 가능 금액이 소진된 경우입니다. 키를 다시 입력하고 잔액을 확인하세요.
-   **첫 요청이 모델 오류로 실패함.** **Model** 값은 `broadnet/` 접두사까지 포함해 BroadNet ID와 정확히 일치해야 합니다. GLM 5.3, Qwen3.8 27B, DeepSeek V4.1 Flash는 충전이 필요하며, 초기 크레딧($5 상당)은 Gemma 4 VL 26B와 Transcribe 모델 두 개에 쓸 수 있습니다.
-   **도구 호출 오류.** 도구가 표기된 모델로 바꾸세요. Roo 문서는 제공자 쪽의 불완전한 도구 지원이 이런 오류를 일으킨다고 설명합니다.
-   **빈 답변.** 추론도 출력 한도에 포함됩니다. **Max Output Tokens**를 늘리세요. [답변이 비어서 오는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.
-   **429.** 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. Roo의 하위 작업(subtask)과 두 번째 VS Code 창도 이 한도를 함께 씁니다. [오류와 재시도](https://broadrouter.com/ko/guides/errors-and-retries/)를 참고하세요.
-   **플랜에서 병렬 작업.** [플랜 세션](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/) 하나는 한 번에 요청 하나를 처리합니다. 오케스트레이터와 하위 작업을 병렬로 돌리면 각각 세션이 따로 필요하며, 그렇지 않으면 대기열에서 기다립니다.

## 이 가이드의 용어

[토큰(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는 보통 둘에 따로 가격을 매기며, 대개 출력이 더 비쌉니다.

[컨텍스트 윈도우(context window)](https://broadrouter.com/ko/glossary/context-window/)

컨텍스트 윈도우는 언어 모델이 요청 한 번에 다룰 수 있는 최대 토큰 수입니다. 프롬프트, 대화 기록, 도구 정의, 이미지, 그리고 추론 토큰을 포함한 생성 출력이 모두 여기에 들어갑니다. 들어가지 않는 내용은 잘라 내거나 요약하거나 여러 요청으로 나눠야 합니다.

[동시 처리(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가 반환됩니다.

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

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

[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와 함께 바꾸면 같은 코드로 다른 제공업체를 호출할 수 있습니다.

## 자주 묻는 질문

### Roo Code는 아직 유지 관리되나요?

아닙니다. GitHub 저장소는 2026년 5월 15일에 보관 처리(archived)되었고, README에는 확장 프로그램 서비스가 종료되었다고 적혀 있습니다. 공지는 커뮤니티 포크인 Zoo Code(공지에는 ZooCode로 표기)와 Cline을 안내합니다. 기존 설치는 아래 설정으로 계속 작동하지만 수정 사항은 더 이상 나오지 않습니다.

### Roo Code에서 도구 호출 오류가 나는 이유는 무엇인가요?

Roo Code는 XML 대체 방식 없이 네이티브 도구 호출만 사용합니다. broadnet/glm-5.3이나 broadnet/qwen3.8-27b처럼 BroadNet이 도구를 표기한 모델을 쓰세요.

### Roo Code가 빈 응답을 받는 이유는 무엇인가요?

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

### DeepSeek 무제한 플랜을 Roo Code에서 쓸 수 있나요?

무제한 플랜은 DeepSeek V4.1 Flash를 제공합니다. BroadNet 문서는 이 모델에 도구 호출을 표기하지 않고 Roo Code는 도구 호출이 필수이므로, 한 달 플랜을 사기 전에 Meteor 1시간으로 먼저 테스트하세요.

## 관련 가이드

-   [BroadNet Inference에서 Cline 사용하기(OpenAI Compatible 제공자)](https://broadrouter.com/ko/guides/cline-openai-compatible/)
-   [추론 모델이 빈 답변을 반환하는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)
-   [에이전트용 무제한 LLM API 플랜은 어떻게 작동하나요?](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)
-   [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-roo-code-openai-compatible&utm_content=page-cta) ·

**출처**

-   [Roo Code GitHub 저장소(2026년 5월 15일 보관 처리, 서비스 종료 공지, 2026-11-14 확인)](https://github.com/RooCodeInc/Roo-Code)
-   [Zoo Code GitHub 저장소, Roo Code를 이어 가는 커뮤니티 포크(2026-11-16 확인)](https://github.com/Zoo-Code-Org/Zoo-Code)
-   [Roo Code 문서, OpenAI Compatible 제공자(2026-11-14 확인)](https://roocodeinc.github.io/Roo-Code/providers/openai-compatible)
-   [BroadNet Inference API 레퍼런스 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-roo-code-openai-compatible&utm_content=sources)
