Claude API를 사용하는 Kilo Code — base URL, 모델 및 비용(Cline 및 Roo Code 포함)

Kilo Code, Cline 및 Roo Code는 VS Code에서 가장 널리 사용되는 오픈 소스 코드 에이전트이며, 세 도구 모두 사용자 지정 OpenAI 호환 엔드포인트를 허용합니다. 즉 하나의 sk-kn- key로 편집기 안에서 Claude를 실행할 수 있으며, 주요 모델은 Anthropic 공식 가격표보다 약 30% 저렴합니다. 이 가이드에서는 각 도구의 세 필드 설정, 작업 유형별로 선택할 Claude 모델, agentic 코딩 세션의 실제 비용, 그리고 브라질에서 국제 카드 없이 Pix로 결제하는 방법을 설명합니다.

이 도구들이 API key를 요구하는 이유

Kilo Code, Cline 및 Roo Code에는 모델이 내장되어 있지 않습니다. 각 작업(파일 읽기, 변경 제안, 명령 실행, 결과 확인)은 토큰별로 요금이 부과되는 API 호출입니다. Claude Pro와 같은 채팅 구독으로는 이를 이용할 수 없으며 API에 직접 액세스해야 합니다. Kunavo는 바로 이를 위한 서비스입니다. $10부터 종량제 충전이 가능하고, Claude와 GPT에 하나의 key를 사용하며, 잔액은 만료되지 않고, 브라질에서는 Pix 또는 카드로 결제할 수 있습니다(지연 시간, LGPD 및 세금계산서에 관한 전체 내용은 브라질의 Claude API 가이드에 있습니다). Agentic 루프는 각 단계마다 컨텍스트를 다시 전송하므로 토큰 요금이 세션 비용을 결정하는 첫 번째 요소입니다.

세 도구에 공통인 세 필드

세 확장 프로그램은 동일한 provider 모델을 공유합니다. Kilo Code와 Roo Code는 Cline 계열의 fork이므로 설정이 동일합니다.

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...          # criada em kunavo.com/app/keys
Model ID       claude-sonnet-5        # ou claude-opus-5 / claude-haiku-4-5

가입하고 $10를 충전한 후 대시보드에서 키를 생성하세요. 키는 한 번만 표시되므로 즉시 저장하세요.

Kilo Code 설정

1. VS Code 마켓플레이스에서 Kilo Code를 설치하고 사이드바에서 패널을 여세요.
2. 확장 프로그램 설정(톱니바퀴 아이콘)을 열고 Providers 섹션으로 이동하세요.
3. API Provider를 OpenAI Compatible로 설정하세요.
4. Base URL: https://api.kunavo.com/v1 · API key: 본인의 sk-kn-… · model: claude-sonnet-5.
5. 저장한 뒤 도구가 코드를 편집하도록 하기 전에 ‘이 파일을 설명해 줘’와 같은 간단한 요청으로 테스트하세요.

Kilo Code는 모드별로 다른 모델을 사용할 수 있습니다(Architect / Code / Debug). 계획은 더 강력한 모델에, 실행은 더 저렴한 모델에 맡길 때 유용합니다.

Cline 설정

1. Cline을 설치하고 패널을 여세요.
2. 설정 톱니바퀴를 클릭하고 API Provider에서 OpenAI Compatible을 선택하세요.
3. 동일한 세 값을 입력하세요. base URL https://api.kunavo.com/v1, 본인의 key 및 model ID claude-sonnet-5입니다.
4. Cline이 모델 메타데이터(컨텍스트 창, 출력 한도)를 요청하면 모델 페이지의 수치를 사용하세요.

Roo Code 설정

다른 두 도구와 동일합니다. Settings → Providers → API Provider → OpenAI Compatible로 이동한 다음 base URL https://api.kunavo.com/v1, key 및 model ID를 입력하세요. Roo Code의 모드 시스템(Code / Architect / Ask / Debug)도 모드별 모델을 지원합니다.

세 도구 모두 사용자 지정 base URL 옵션이 있는 네이티브 Anthropic provider도 제공합니다. https://api.kunavo.com를 가리키면 네이티브 Messages API(/v1/messages)를 사용합니다. 이 방식은 cache_control가 그대로 전달되고 캐시된 input에 input 요금의 10%만 부과되므로 유용합니다(prompt caching 문서 참조). 두 경로 모두 작동하지만, 시작할 때는 OpenAI 호환 경로가 더 간단합니다.

브라질에서 결제하기 — 국제 카드 없이 Pix 사용

브라질 개발자 대부분을 막는 지점은 설정이 아니라 결제입니다. Anthropic API에 직접 결제하려면 해외 결제가 활성화된 국제 신용카드가 필요합니다. Kunavo에서는 결제가 Stripe를 통해 처리되고, 브라질에서 결제하는 사용자에게 Pix가 결제 수단으로 표시됩니다. 금액은 헤알화로 표시되고 즉시 반영되므로 국제 카드가 필요하지 않습니다. 국제 카드(Visa, Mastercard, American Express), Apple Pay, Google Pay 및 Link도 정상적으로 사용할 수 있습니다.

토큰 요금은 USD로 책정됩니다. Pix 결제 시(또는 결제 페이지에 헤알화가 표시되는 경우 카드 결제 시) Stripe에서 확인 전에 헤알화 환산 금액을 표시하며, 이 환율에는 구매자가 부담하는 2~4%의 환전 비용이 포함됩니다. 카드로 달러 결제를 선택하면 이 비용이 사라지고 카드 발급사의 환율이 적용됩니다(은행 앱에서 IOF 및 국제 거래 수수료를 확인하세요). Pix 충전 절차는 Pix로 API를 결제하는 방법 안내에 나와 있습니다. 이는 선불 지갑입니다. 최소 충전 금액은 $10이고 월별 요금이 없으며 잔액은 절대 만료되지 않습니다. 따라서 한 달 동안 코딩하지 않아도 구독과 달리 비용이 발생하지 않습니다.

어떤 Claude 모델을 선택해야 하나요?

모델 필드는 동일한 엔드포인트의 slug일 뿐입니다. 모델을 바꾸는 것은 단어 하나를 바꾸는 일이며, 새 key나 새 provider가 필요하지 않습니다. 전체 요금은 Claude API 가격 가이드와 가격 페이지에서 확인할 수 있습니다.

세션의 실제 비용

Agentic 도구는 설계상 많은 토큰을 사용합니다. 각 단계마다 system prompt, 작업 기록 및 파일 컨텍스트를 다시 전송하기 때문입니다. Kunavo 요금 기준의 현실적인 수치는 다음과 같습니다.

즉, Pix로 $10을 충전하면 Sonnet 5에서 약 11개의 20단계 agentic 작업을 수행할 수 있습니다. 직접 계산하려면 다음과 같습니다.

# Tarifas Claude na Kunavo (USD por 1M de tokens): (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
}

def custo_passo(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# Um passo do agente: a ferramenta reenvia o contexto + os arquivos lidos.
print(custo_passo("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# Uma tarefa realista de 20 passos (editar, rodar, corrigir, repetir):
print(20 * custo_passo("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

동일한 내용을 포르투갈어로 작성하면 영어보다 약 10–20% 더 많은 토큰을 사용합니다. 프롬프트와 코드 주석이 포르투갈어일 때 고려할 만한 사항입니다.

청구액을 낮게 유지하는 방법

1. 같은 작업을 늘이지 말고 새 작업을 시작하세요. 도구는 각 단계마다 전체 대화를 다시 전송하므로, 끝없이 이어지는 작업은 비용이 제곱으로 증가합니다. 새 작업 = 짧은 컨텍스트입니다.
2. 모드별로 라우팅하세요. Kilo Code와 Roo Code는 모드별 모델을 지원합니다. Architect에는 claude-opus-5, Code에는 claude-sonnet-5, 빠른 질문에는 claude-haiku-4-5를 사용하세요.
3. 캐싱에는 네이티브 Anthropic 경로를 사용하세요. 캐시된 input에는 요금의 10%만 부과됩니다. 각 단계마다 안정적인 접두사를 다시 전송하는 루프에서는 가장 큰 비용 절감 효과를 얻을 수 있습니다(작동 방식).
4. key별 지출을 추적하세요. dashboard에서 지출 한도가 있는 전용 key를 편집기에 제공하고, 사용량 패널에서 agentic 코딩 일주일의 실제 비용을 확인하세요.

자주 묻는 질문