문서

문서

Roo Code

Roo Code의 OpenAI Compatible 제공업체는 세 개의 필드와 모델 기능 설정 블록으로 구성됩니다. 이 기능 설정 블록은 선택 사항인 장식이 아닙니다. Roo Code가 컨텍스트 사용량을 계산할 때 기준으로 삼습니다.

OpenAI Compatible 제공자를 선택하고 기본 URL과 키를 붙여넣은 뒤 모델의 컨텍스트 창과 최대 출력을 설정하면 Roo Code 자체의 비용 계산이 정확해집니다

Roo Code 설정 패널
API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model          claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
Roo Code는 대체 경로 없이 네이티브 도구 호출을 사용하므로, 선택하는 모델은 OpenAI 호환 도구 호출을 반드시 지원해야 합니다. 아래 표의 모든 id가 이를 지원합니다. 여기서 텍스트 전용 모델이나 미디어 모델을 설정하면 설정 단계가 아니라 에이전트가 처음 도구를 사용하려 할 때 실패합니다.
기본값을 그대로 두지 말고 Context Window와 Max Output Tokens을 입력하세요. Roo Code는 이 수치로 대화를 언제 요약할지 결정합니다. 따라서 컨텍스트 윈도우를 너무 낮게 설정하면 잘라낼 필요가 없는 대화 기록까지 잘라내고, 너무 높게 설정하면 정상적으로 요약되지 않고 업스트림 400 오류가 발생합니다.
아직 키가 없나요? Kunavo 계정을 만들고, 키를 생성한 다음(키는 sk-kn-로 시작합니다) $10부터 크레딧을 추가하세요. 호출 비용은 해당 잔액에서 차감되며 실패한 호출에는 요금이 부과되지 않습니다. 그러면 대시보드가 Roo Code 설정 화면에서 열립니다.

단계별 안내

  1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
  2. Roo Code 설정 패널을 열고 API Provider를 OpenAI Compatible로 설정하세요.
  3. Base URL https://api.kunavo.com/v1과 키를 입력하세요. /v1 접미사는 기본 URL에 포함해야 합니다. Roo Code는 경로만 덧붙입니다.
  4. 모델 id를 선택하거나 입력한 다음 Model Configuration을 열고 컨텍스트 윈도우, 최대 출력 토큰, 이미지 지원, 아래 표의 입력 및 출력 가격을 설정하세요.
  5. Code 모드에서 메시지를 보내세요. 여기에 입력한 가격은 Roo Code 자체 작업별 비용 표시에 사용되므로 정확하게 입력해야 합니다.

Roo Code의 OpenAI Compatible 제공업체 페이지에서 확인했습니다(2026년 9월 6일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

이것이 요약본입니다. 전체 안내—모델 선택, 실제 세션 비용, 실패 유형—는 Roo Code + Claude 안내에 있습니다.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Roo Code에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

모델 IDKunavo 입력/출력Roo Code에서의 위치
claude-sonnet-5$1.40 / $7.00Code 모드 — 기본 모드이며 비용 표시도 이 모드 기준으로 조정되어 있습니다
claude-opus-5$3.50 / $17.50Architect 모드 — 잘못된 계획이 토큰보다 더 큰 비용을 초래하는 모드
claude-haiku-4-5$0.70 / $3.50Ask 모드와 반복적인 파일 읽기
gpt-5-6-terra$0.70 / $4.20대규모 저장소를 긴 컨텍스트로 여러 차례 처리
월정액 없이 선불 잔액에서 토큰별로 청구됩니다. billing을 참고하세요. 반복되는 컨텍스트(에디터나 채팅 클라이언트가 보내는 데이터의 대부분)에서는 모델 선택보다 프롬프트 캐싱이 청구액에 더 큰 영향을 줍니다.

자주 묻는 질문

Roo Code가 사용자 지정 OpenAI 호환 엔드포인트를 사용하도록 설정하려면 어떻게 하나요?

Roo Code 설정 패널에서 API Provider를 "OpenAI Compatible"로 설정한 다음 해당 엔드포인트의 Base URL과 API Key를 입력하고 모델을 선택하세요. Roo Code는 경로만 덧붙이므로 기본 URL은 서비스의 /v1 루트여야 합니다. Roo Code 자체 문서에서는 Base URL 필드가 중요하다고 설명합니다. 모든 요청이 어디로 전송되는지를 결정하는 필드이기 때문입니다.

사용자 지정 엔드포인트를 통해 Roo Code에서 사용할 수 있는 모델은 무엇인가요?

엔드포인트가 제공하며 OpenAI 호환 네이티브 도구 호출을 지원하는 모든 모델입니다. Roo Code는 네이티브 도구 호출만 사용하고 대체 모드가 없으므로, 도구를 지원하지 않는 모델은 연결된 후 에이전트가 파일을 읽거나 쓰려고 하는 즉시 실패합니다. Claude 및 GPT 텍스트 모델은 모두 지원되지만 이미지, 비디오, 오디오 모델은 지원되지 않습니다.

Roo Code의 Context Window와 Max Output Tokens에는 어떤 값을 입력해야 하나요?

기본값이 아니라 선택한 모델의 실제 한도를 입력하세요. Roo Code는 이 두 수치로 대화를 언제 요약할지 결정합니다. 모델의 실제 컨텍스트보다 낮게 설정하면 불필요하게 대화 기록을 버리고, 실제 한도보다 높게 설정하면 정상적으로 요약되지 않고 업스트림 400 오류가 발생합니다. 모델별 수치는 엔드포인트의 모델 카탈로그에서 확인할 수 있습니다.

Roo Code가 작업 비용을 잘못 표시하는 이유는 무엇인가요?

Model Configuration의 Input Price와 Output Price를 직접 입력해야 하는데, 기본값은 0이거나 다른 제공업체의 요금으로 설정되어 있기 때문입니다. Roo Code는 이 두 필드만으로 작업별 비용을 계산하며 엔드포인트에서 가격을 가져오지 않습니다. 따라서 표시되는 비용의 정확도는 입력한 값에 달려 있습니다. 제공업체의 자체 카탈로그에서 요금을 확인해 입력하세요.