Roo Code에서 Claude API 사용하기 — 제공업체 설정 및 모드별 모델

Roo Code는 VS Code용 오픈 소스 자율 코딩 에이전트입니다. Cline 제품군의 포크이며, 모드 시스템과 모드별 모델 라우팅이 특징입니다. 자체 모델은 제공하지 않으므로 API 키가 필요합니다. 이 가이드는 하나의 sk-kn- 키로 Roo Code에서 Claude를 실행하는 정확한 설정, 주요 모델에서 Anthropic 정가보다 약 30% 저렴하게 사용하는 방법, 강력한 모델에는 필요한 만큼만 비용을 쓰도록 구성 프로필을 사용하는 방법, 세션 비용, Anthropic을 직접 호출하는 경우와의 현실적인 절충점을 설명합니다.

Roo Code에 API 키가 필요한 이유

Roo Code가 수행하는 모든 단계 — 파일 읽기, diff 작성, 명령 실행, 결과 읽기 — 는 토큰별로 청구되는 모델 호출입니다. claude.ai Pro 또는 Max 구독으로는 이를 이용할 수 없습니다. 채팅 요금제와 API 액세스는 별도의 제품이며, Roo Code는 API와 통신합니다. 에이전트 루프는 단계마다 계속 증가하는 작업 컨텍스트를 다시 전송하므로, 토큰당 요금이 세션 비용을 좌우하는 가장 큰 요소입니다 — 이것이 게이트웨이의 장점입니다. $10 충전부터 종량제로 사용할 수 있고, GPT에도 연결되는 하나의 키와 만료되지 않는 잔액을 제공합니다.

설정 — 세 가지 필드

Settings → Providers를 열고 API provider를 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 키 문서에서 키 교체와 지출 한도를 다룹니다. Roo Code가 컨텍스트 창이나 출력 한도와 같은 모델 메타데이터를 요구하면 모델 페이지의 값을 사용하세요. 컨텍스트 창을 실제보다 작게 설정하면 필요 이상으로 일찍 잘립니다.

코드를 수정하게 하기 전에 작은 작업으로 테스트하세요. 여기서 401은 거의 항상 키 문제이고, 404는 거의 항상 기본 URL 또는 존재하지 않는 모델 슬러그 문제입니다 — Kunavo는 슬러그를 정확히 일치시키며 날짜가 붙은 이름에 별칭을 제공하지 않으므로 claude-sonnet-4-5-20250929는 404를 반환하고 claude-sonnet-4-6는 정상적으로 확인됩니다.

모드와 구성 프로필 — 비용 조정 수단

Roo Code에는 Code, Architect, Ask, Debug 등 여러 기본 모드와 직접 정의하는 사용자 지정 모드가 있습니다. 비용 측면에서 중요한 점은 Roo Code가 이름이 지정된 API 구성 프로필을 저장하고 각 모드에서 마지막으로 사용한 프로필을 기억한다는 것입니다. 따라서 모델은 기억해서 변경해야 하는 대상이 아니라 모드의 속성이 됩니다:

# One API configuration profile per job, all on the same sk-kn- key.
# Roo Code remembers the profile you last used in each mode.

Profile "strong"         model claude-opus-5        -> bind to Architect and Debug
Profile "code-default"   model claude-sonnet-5      -> bind to Code mode
Profile "ask-cheap"      model claude-haiku-4-5     -> bind to Ask mode

이 방식이 작동하는 이유는 모드마다 토큰 사용 패턴이 매우 다르기 때문입니다. Architect는 추론 중심의 몇 차례 대화로, 다음 20단계의 생산성을 모델 품질이 결정합니다. 전체 토큰에서 차지하는 비중이 작으므로 강력한 모델을 사용해도 절대 비용은 적습니다. Code는 컨텍스트를 매번 다시 전송하는 기계적인 단계가 많아 토큰당 요금이 누적되는 영역입니다. Ask는 보통 한 번의 요청으로 끝나므로 최상위 모델이 전혀 필요하지 않습니다.

아래에 계산 예시가 있습니다. Opus 5에서 Architect 3단계와 Sonnet 5에서 Code 17단계를 실행하면 전체를 Sonnet으로 실행하는 경우의 $0.87에 비해 약 $1.06가 됩니다 — 계획 품질은 크게 향상되면서 비용은 약 23% 더 들고, 모든 작업을 Opus에서 실행하는 것보다는 훨씬 저렴합니다.

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

Roo Code는 사용자 지정 기본 URL 필드를 제공하는 기본 Anthropic provider도 지원합니다. https://api.kunavo.com — origin만 입력하고 /v1는 제외하세요. 해당 클라이언트가 자체적으로 /v1/messages를 추가합니다 — 를 지정하면 기본 Messages API를 통해 라우팅됩니다. 여기에 /v1 형식을 붙여 넣으면 누락된 모델처럼 보이는 404가 발생합니다.

이 경로의 장점은 프롬프트 캐싱입니다. cache_control는 변환되지 않은 상태로 전달되고 캐시된 입력에는 입력 요금의 10%가 청구됩니다(작동 방식). 매 단계마다 안정적인 접두사를 다시 전송하는 루프에서는 이것이 사용 가능한 가장 큰 절감 효과이며, 어떤 모델 교체보다도 큽니다. 어느 경로든 사용할 수 있습니다. 시작할 때는 OpenAI Compatible이 더 간단하고, 두 경로 간 이동은 설정 변경으로 끝납니다.

모드별 Claude 모델 연결 방법

모든 경우에 같은 키와 같은 엔드포인트를 사용하고 모델 슬러그만 다르므로, 프로필 변경은 한 단어만 바꾸면 됩니다. Anthropic 공식 정가와 비교한 모델별 전체 요금은 Anthropic Claude API 가격 목록에 있으며, 실시간 카탈로그는 가격 페이지에서 확인할 수 있습니다.

Kunavo에서 Roo Code를 사용하는 경우와 Anthropic을 직접 호출하는 경우

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

용량 행이 실제 절충점입니다. 보장된 할당량, 계약상 SLA 또는 모델 공급업체와의 조달 관계가 필요하다면 직접 사용하세요 — 가격 차이가 바로 그것을 의미합니다. Roo Code를 사용하는 개인 개발자나 소규모 팀이라면 대체로 반대쪽이 더 유리합니다.

Roo Code 세션의 실제 비용

에이전트 도구는 의도적으로 토큰을 많이 사용합니다. 각 단계에서 시스템 프롬프트, 작업 기록, 새 파일 컨텍스트를 다시 전송하기 때문입니다. 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 Code-mode step: Roo 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 on the Code-mode default:
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# Architect mode on Opus 5 for 3 steps, Code mode on Sonnet 5 for 17:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

청구액 줄이기

1. 작업을 영원히 확장하지 말고 새 작업을 시작하세요. Roo Code는 매 단계마다 전체 대화를 다시 전송하므로, 하나의 장기 작업은 비용이 제곱에 가깝게 증가합니다. 새 작업은 작고 새로운 컨텍스트로 시작하는 것이므로, 여기서 가장 효과가 큰 습관입니다.
2. 모드별로 프로필을 연결하세요. 앞서 설명했듯이 모델 라우팅을 작업 중 기억해야 하는 일이 아니라 구성으로 바꿔 줍니다.
3. 캐싱에는 기본 Anthropic 경로를 사용하세요. 입력 요금의 10%만 청구되는 캐시 입력은 안정적인 접두사를 다시 전송하는 루프에서 가장 큰 구조적 절감 효과입니다.
4. 편집기 전용 지출 제한 키를 만드세요. 대시보드에서 별도의 키를 생성하고 실제로 일주일 사용한 후 사용량을 확인하세요 — 이것이 실제 비용을 정직하게 추정하는 유일한 방법입니다.

자주 묻는 질문