Claude API를 사용하는 Cline — 기본 URL 설정, Plan/Act 모델 라우팅, 실제 비용

Cline은 VS Code용 오픈 소스 자율 코딩 에이전트이며 모델을 함께 제공하지 않습니다. 일반적으로 자체 API 키를 사용해 모델에 연결해야 합니다. 이 가이드는 하나의 sk-kn- 키를 통해 Cline에서 Claude를 실행하는 정확한 설정을 설명하며, 주요 모델에서 Anthropic 정가보다 약 30% 낮은 가격을 제공합니다. 두 프로바이더 경로, Plan/Act 모드를 활용한 비용 절감, 실제 세션 비용, Anthropic 직접 호출과 비교해 포기하게 되는 부분을 솔직하게 다룹니다.

Cline에 API 키가 필요한 이유

Cline이 수행하는 모든 작업 — 파일 읽기, diff 제안, 터미널 명령 실행, 출력 읽기 및 재시도 — 은 모델 호출입니다. Cline은 Claude Code 프로바이더를 통해 Claude Pro 또는 Max 구독에서 이러한 호출을 실행할 수 있습니다. 이 프로바이더는 Claude CLI를 구동하고 API 청구 대신 구독 한도를 사용합니다. 2026년 9월 기준 Cline 문서에 명시된 절충점으로는 토큰 단위 스트리밍이 되지 않을 수 있고 이 모드에서 이미지 업로드와 프롬프트 캐싱이 제한된다는 점이 있습니다. 이 가이드에서 설정하는 OpenAI Compatible 및 Anthropic 프로바이더를 포함한 다른 모든 경로는 API 키를 통해 토큰별로 청구됩니다. 이러한 경로에서 문제는 토큰별 지불 여부가 아니라 요금 수준이며, 에이전트 루프는 각 단계마다 증가하는 작업 컨텍스트를 다시 보내므로 토큰당 요금이 세션 비용에 가장 큰 영향을 미칩니다. 이것이 여기서 게이트웨이를 사용하는 전체 이유입니다. $10부터 충전해 종량제를 이용하고, GPT에도 연결되는 하나의 키를 사용하며, 잔액은 만료되지 않습니다.

설정 — 세 가지 필드

Cline 패널을 열고 설정 톱니바퀴를 클릭한 다음 API 프로바이더를 OpenAI Compatible로 설정하세요. 세 가지 값은 다음과 같습니다.

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

가입하고 충전한 후 대시보드에서 키를 생성하세요. 키는 한 번만 표시되므로 즉시 저장하세요. 키 관리, 교체 및 지출 한도는 Claude API 키 문서에서 다룹니다. Cline이 컨텍스트 창이나 출력 상한 같은 모델 메타데이터를 요구하면 추측하지 말고 모델 페이지의 숫자를 사용하세요. 컨텍스트 창을 실제보다 작게 설정하면 Cline이 필요 이상으로 일찍 잘라낼 수 있습니다.

편집을 허용하기 전에 작은 작업(“이 파일을 설명해 줘”)을 요청해 연결이 제대로 설정되었는지 확인하세요. 이 시점의 401은 거의 항상 키 문제이고, 404는 거의 항상 기본 URL 또는 존재하지 않는 모델 슬러그 문제입니다. Kunavo는 슬러그를 정확히 일치시키며 날짜가 붙은 이름을 별칭으로 처리하지 않으므로 claude-sonnet-4-5-20250929은 404를 반환하지만 claude-sonnet-4-6은 정상적으로 확인됩니다.

Plan 모드와 Act 모드 — 가장 저렴한 분할

Cline의 핵심 기능은 Plan(코드베이스를 읽고, 질문하고, 접근 방식을 제안)과 Act(편집하고 명령을 실행)를 분리하고, 각각에 다른 모델을 구성할 수 있다는 점입니다. 두 모드의 토큰 사용 패턴이 매우 다르므로 비용 측면에서 거의 완벽하게 대응됩니다.

• Plan은 짧고 추론 중심입니다. 다음 스무 단계가 생산적인지 낭비인지 모델 품질이 결정하는 소수의 턴으로 이루어집니다. 여기에 claude-opus-5을 배치하세요. 전체 토큰 중 차지하는 비중이 작으므로 더 강력한 모델을 사용해도 절대 비용은 낮습니다.
• Act는 길고 기계적입니다. 각 단계에서 컨텍스트를 다시 전송하며 많은 단계를 수행합니다. 여기서는 토큰당 요금이 누적되므로 더 저렴한 Sonnet이 적합합니다 — 현재 Kunavo에서는 claude-sonnet-5입니다.

구체적인 계산은 아래 비용 섹션에 있습니다. Opus 5로 세 단계를 계획하고 Sonnet 5로 열일곱 단계를 실행하면 전체를 Sonnet으로 실행하는 경우의 $0.87에 비해 약 $1.06가 듭니다. 즉, 계획 품질은 크게 향상되면서 약 23% 더 비싸고, 전체 작업을 Opus로 실행하는 것보다는 훨씬 저렴합니다.

기본 Anthropic 경로(및 이를 사용하려는 이유)

Cline은 사용자 지정 기본 URL 필드가 있는 기본 제공 Anthropic 프로바이더도 제공합니다. 이를 Kunavo로 지정하면 OpenAI 호환 엔드포인트 대신 기본 Messages API(/v1/messages)를 사용합니다.

API Provider   Anthropic
Base URL       https://api.kunavo.com   # origin only — the client appends /v1/messages
API Key        sk-kn-...
Model ID       claude-sonnet-5

두 경로의 기본 URL이 서로 다르다는 점에 유의하세요. OpenAI 호환 프로바이더에는 https://api.kunavo.com/v1이 필요하고, Anthropic 프로바이더에는 기본 오리진 https://api.kunavo.com가 필요합니다. 해당 클라이언트가 /v1/messages를 자체적으로 추가하기 때문입니다. /v1 형식을 Anthropic 프로바이더에 붙여넣으면 모델이 없는 것처럼 보이는 404가 발생합니다.

기본 경로가 제공하는 이점은 프롬프트 캐싱입니다. cache_control은 변환 없이 전달되고, 캐시된 입력에는 입력 요금의 10%만 부과됩니다(프롬프트 캐싱 문서 참조). 매 단계마다 안정적인 접두사를 다시 보내는 루프에서는 모델을 바꾸는 것보다 큰 절약 효과가 있습니다. 어느 경로든 작동하지만, 시작할 때는 OpenAI 호환 경로가 더 간단하며 나중에 설정만 변경해 전환할 수 있습니다.

설정할 Claude 모델

모델 필드를 한 단어만 바꾸면 전환됩니다. 키, 프로바이더 설정, 엔드포인트는 동일합니다. Anthropic 공식 목록과 비교한 모델별 전체 요금은 Anthropic Claude API 가격 목록에 있으며, 실시간 카탈로그는 가격 페이지에서 확인할 수 있습니다.

Kunavo에서 Cline 사용 vs Anthropic 직접 호출

직접 사용하는 편이 더 나은 경우까지 포함한 현실적인 비교입니다:

용량 행은 표시된 그대로 해석하세요. 팀에 보장된 할당량, 계약상 SLA 또는 모델 공급업체와의 조달 관계가 필요하다면 직접 이용하세요. 가격 차이는 바로 그런 요구에 대한 비용입니다. 개인 개발자나 소규모 팀이 Cline을 실행하는 경우에는 대개 반대쪽이 더 유리합니다.

Cline 세션의 실제 비용

에이전트 도구는 의도적으로 토큰을 많이 사용합니다. 각 단계에서 시스템 프롬프트, 작업 기록, 새 파일 컨텍스트를 다시 전송하기 때문입니다. 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),
    "claude-opus-5":     (3.50, 17.50),
}

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 Act-mode step: Cline resends the task context plus the files it read.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, read the error, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# The same task planned on Opus 5, executed on Sonnet 5:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

청구액 줄이기

1. 한 작업을 영원히 확장하지 말고 새 작업을 시작하세요. Cline은 매 단계마다 전체 대화를 다시 전송하므로 장시간 실행되는 작업은 비용이 제곱에 가깝게 증가합니다. 새 작업은 작고 새로운 컨텍스트로 시작되므로, 목록에서 가장 효과가 큰 습관입니다.
2. Plan과 Act를 모델 간에 분리하세요. 위에서 설명했듯이 설정 필드의 문제이지 규율의 문제가 아닙니다.
3. 캐싱에는 기본 Anthropic 경로를 사용하세요. 입력 요금의 10%만 청구되는 캐시 입력은 안정적인 접두사를 다시 전송하는 루프에서 가장 큰 구조적 절감 효과입니다.
4. 편집기 전용 지출 제한 키를 제공하세요. 대시보드에서 별도의 키를 만들고 월별 지출 한도를 설정한 다음 사용량을 확인하세요. 실제 에이전트 코딩을 일주일간 실행해 보는 것이 비용을 추정하는 유일하게 정직한 방법입니다. 한도는 각 요청 전에 확인되고 달력 기준 월마다 재설정되며, 키를 독립적으로 폐기할 수 있으므로 모든 설정을 교체하지 않고도 편집기를 한 번의 작업으로 중지할 수 있습니다.
5. 아직 두 도구 중 무엇을 선택할지 고민 중인가요? Cline과 Claude Code 비교에서는 기능 목록보다 과금 구조를 비교합니다. 두 도구 모두 동일한 엔드포인트를 사용하므로 선택을 나중에 되돌릴 수 있습니다.

자주 묻는 질문