Claude API를 사용하는 Kilo Code — OpenAI 호환 base URL 설정 및 모드별 라우팅

Kilo Code는 VS Code에서 가장 널리 사용되는 오픈 소스 AI 코딩 에이전트 중 하나이며, Cline 제품군의 다른 도구와 마찬가지로 자체 OpenAI 호환 API 엔드포인트를 연결할 수 있습니다. 즉, 단일 sk-kn- 키로 편집기 안에서 Claude를 실행할 수 있으며, 주요 모델에서는 Anthropic 목록 가격보다 약 30% 낮은 가격으로 사용할 수 있습니다. 이 가이드는 세 가지 필드 설정, 작업별 Claude 모델 선택, 실제 에이전트 코딩 세션 비용을 설명합니다.

Kilo Code에 API 키가 필요한 이유

Kilo Code에는 모델이 포함되어 있지 않습니다. 파일 읽기, 편집 제안, 명령 실행, 결과 확인 등 모든 작업이 토큰별로 청구되는 API 호출입니다. Claude Pro와 같은 채팅 구독은 이를 포함하지 않으며, 확장 기능에는 직접 API 액세스가 필요합니다. Kunavo가 제공하는 방식이 바로 이것입니다. 10달러 충전부터 시작하는 사용량 기준 결제, Claude와 GPT를 위한 하나의 키, 만료되지 않는 잔액을 제공합니다. 에이전트 루프는 각 단계에서 늘어나는 작업 컨텍스트를 다시 보내므로 토큰당 요율이 세션 비용에 가장 큰 영향을 줍니다. 이것이 claude-sonnet-5에서 약 30% 할인되는 효과가 빠르게 누적되는 이유입니다.

세 가지 필드

Kilo Code는 제공업체를 세 가지 설정 필드로 노출합니다.

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

가입하고 10달러를 충전한 후 대시보드에서 키를 받으세요. 키는 한 번만 표시되므로 즉시 저장하세요. 전체 키 관리는 Claude API 키 문서에서 설명합니다.

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)를 지원합니다. 계획에는 더 강력한 모델(claude-opus-5)을, 실행에는 더 저렴한 모델(claude-sonnet-5)을 연결하기에 적합합니다.

Cline 및 Roo Code

Kilo Code와 Roo Code는 모두 Cline 계열의 포크이므로, 위의 세 필드(공급자 OpenAI Compatible, 기본 URL https://api.kunavo.com/v1, 키, 모델 ID)는 세 도구에서 동일합니다. 다른 점은 각 도구가 모델 라우팅을 위해 제공하는 기능이며, 비용 절감은 바로 여기서 발생합니다. 따라서 각각 별도의 가이드가 있습니다. Claude API를 사용하는 Cline에서는 Plan/Act 분할을, Claude API를 사용하는 Roo Code에서는 이름이 지정된 구성 프로필과 모드별 모델 바인딩을 다룹니다.

세 도구 모두 사용자 지정 기본 URL 옵션이 포함된 기본 Anthropic 공급자도 제공합니다. 이를 https://api.kunavo.com으로 지정하면 대신 기본 Messages API(/v1/messages)를 사용합니다. 이는 cache_control가 번역되지 않은 상태로 전달되고 캐시된 입력이 입력 요금의 10%로 청구되므로 유용합니다(프롬프트 캐싱 문서 참조). 어느 경로든 사용할 수 있지만, 시작하기에는 OpenAI 호환 경로가 가장 간단합니다.

선택할 Claude 모델

여기서는 claude-opus-5가 강력한 추론을 위한 선택입니다. Anthropic의 최신 Opus이며, 이전 세대 claude-opus-4-7($3.50 / $17.50)와 동일한 $3.50 / $17.50 요금으로 청구됩니다. 해당 모델에 고정해 둔 경우에도 이전 세대 모델을 계속 사용할 수 있습니다. 모델 필드는 동일한 엔드포인트의 슬러그일 뿐이므로 전환은 한 단어만 바꾸면 됩니다. 새 키나 새 공급자 구성이 필요하지 않습니다. 모든 모델의 전체 요금은 Claude API 요금 가이드와 요금 페이지에서 확인할 수 있습니다.

세션의 실제 비용

에이전트 도구는 의도적으로 토큰을 많이 사용합니다. 각 단계에서 시스템 프롬프트, 작업 기록, 새 파일 컨텍스트를 다시 전송하기 때문입니다. Kunavo 요금 기준의 현실적인 수치는 다음과 같습니다.

실행 가능한 계산식:

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

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

# One agentic step: the tool resends the task context + file reads.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

청구액 줄이기

1. 한 작업을 영원히 연장하지 말고 새 작업을 시작하세요. 도구는 각 단계마다 전체 대화를 다시 전송하므로, 장기 실행 작업은 이차적으로 비용이 증가합니다. 새 작업 = 새롭고 작은 컨텍스트입니다.
2. 모드별로 라우팅하세요. Kilo Code는 모드별 모델을 지원합니다. Architect에는 claude-opus-5, Code에는 claude-sonnet-5, 빠른 질문에는 claude-haiku-4-5을 사용할 수 있습니다. 계획이 차지하는 토큰 비중은 작으므로, 해당 단계에서 더 강력한 모델을 사용해도 비용이 적게 듭니다.
3. 캐싱을 위해 기본 Anthropic 경로를 사용하세요. 캐시된 입력은 입력 요금의 10%로 청구됩니다. 각 단계에서 안정적인 접두사를 반복 전송하는 루프에서는 이것이 이용 가능한 가장 큰 절감 효과입니다(작동 방식).
4. 키별 지출을 확인하세요. 편집기에 지출 한도가 설정된 전용 키를 대시보드에서 할당하고, 사용량을 확인하여 에이전트 코딩에 실제로 일주일 동안 얼마를 지출하는지 파악하세요.

자주 묻는 질문