Claude API를 사용하는 Kilo Code — base URL 설정(Cline 및 Roo Code도 해당)

Kilo Code, Cline 및 Roo Code는 VS Code에서 가장 널리 사용되는 오픈 소스 AI 코딩 에이전트이며, 세 제품 모두 사용자 지정 OpenAI 호환 엔드포인트를 지원합니다. 따라서 하나의 키 sk-kn-로 편집기에서 Claude를 사용할 수 있으며, 주요 모델에서 Anthropic 공식 요금보다 약 30% 낮은 가격으로 이용할 수 있습니다. 이 가이드는 각 도구의 세 필드 설정, 작업별로 선택할 Claude 모델, 실제 에이전트 코딩 세션 비용을 설명합니다.

이 도구들은 왜 API 키를 요구하나요?

Kilo Code, Cline 및 Roo Code에는 모델이 내장되어 있지 않습니다. 파일 읽기, 수정 제안, 명령 실행, 결과 확인 등 각 작업이 토큰별로 청구되는 API 호출입니다. Claude Pro 같은 채팅 구독은 이를 포함하지 않으므로 직접 API 액세스가 필요합니다. 이것이 바로 Kunavo가 제공하는 것입니다. $10부터 종량제로 사용할 수 있고, Claude와 GPT에 하나의 키를 사용하며, 잔액은 만료되지 않고, 프랑스에서 신용카드로 결제할 수 있습니다(부가가치세 및 GDPR 세부 사항은 프랑스 Claude API 가이드에 있습니다). 에이전트 루프는 각 단계마다 컨텍스트를 다시 전송하므로 토큰당 요금이 세션 비용의 첫 번째 핵심 요소입니다.

세 필드(모든 도구 공통)

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

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...          # à créer sur kunavo.com/app/keys
Model ID       claude-sonnet-5        # ou claude-opus-4-7 / claude-haiku-4-5

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

Kilo Code 설정

1. VS Code marketplace에서 Kilo Code를 설치하고 사이드바에서 여세요.
2. 확장 프로그램 설정(톱니바퀴 아이콘)을 열고 Providers 섹션으로 이동하세요.
3. API Provider를 OpenAI Compatible로 설정하세요.
4. Base URL: https://api.kunavo.com/v1 · API 키: 본인의 sk-kn-… · 모델: 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, 본인의 키, model ID claude-sonnet-5입니다.
4. Cline에서 모델 메타데이터(컨텍스트 윈도우, 출력 상한)를 요청하면 모델 페이지의 수치를 사용하세요.

Roo Code 설정

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

세 도구 모두 사용자 지정 기본 URL 옵션이 있는 네이티브 Anthropic 프로바이더도 제공합니다. 이를 https://api.kunavo.com로 지정하면 네이티브 Messages API(/v1/messages)를 사용하게 됩니다. 이 방식은 cache_control가 그대로 전달되고 캐시된 입력이 입력 요금의 10%로 청구된다는 점에서 유용합니다(프롬프트 캐싱 문서 참조). 두 경로 모두 작동하지만, 시작하기에는 OpenAI 호환 경로가 가장 간단합니다.

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

모델 필드는 동일한 엔드포인트에서 사용하는 슬러그일 뿐입니다. 모델 변경은 한 단어만 바꾸면 되며, 새 키나 새 provider가 필요하지 않습니다. 모든 요금은 Claude API 가격 가이드와 가격 페이지에서 확인할 수 있습니다.

실제 세션 비용

에이전트 도구는 설계상 많은 토큰을 사용합니다. 각 단계마다 시스템 프롬프트, 작업 기록 및 파일 컨텍스트가 다시 전송됩니다. Kunavo 요금 기준 현실적인 수치는 다음과 같습니다:

실행 가능한 계산식:

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

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

# Une étape agentique : l'outil renvoie le contexte + les fichiers lus.
print(cout_etape("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# Une tâche réaliste de 20 étapes (éditer, lancer, corriger, répéter) :
print(20 * cout_etape("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

청구액 낮추기

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

자주 묻는 질문